# -*- coding: utf-8 -*-
"""
Superium — reusable markup components
=====================================
Server-side (build-time) renderers for the pieces that repeat across pages:
product cards, category displays, rails, breadcrumbs.
Cards are rendered as static HTML rather than Alpine templates so the pages
are crawlable and work with JavaScript disabled. The interactive bits — the
quantity stepper, the wishlist heart — are Alpine-bound on top of that static
markup.
"""
from __future__ import annotations
from layout import icon
def fa(value) -> str:
"""1234567 -> ۱,۲۳۴,۵۶۷ (build-time twin of the JS helper)."""
return f"{int(value):,}".translate(str.maketrans("0123456789", "۰۱۲۳۴۵۶۷۸۹"))
# --------------------------------------------------------------------------
# Product card
# --------------------------------------------------------------------------
def product_card(p: dict, *, rail: bool = False, show_stamp: bool = False) -> str:
"""
One product card.
rail wraps in a swiper-slide
show_stamp adds the subsidy stamp seen on staple goods
"""
pid = p["id"]
has_discount = p.get("discountRatio", 0) > 0
flags = []
if has_discount:
flags.append(
f'{fa(p["discountRatio"])}٪'
)
if show_stamp:
flags.append('کالابرگ')
flags_html = f'
' if rail else card
def product_grid(products: list[dict], *, stamp_every: int = 0) -> str:
cards = [
product_card(p, show_stamp=bool(stamp_every) and i % stamp_every == 0)
for i, p in enumerate(products)
]
return f'
{"".join(cards)}
'
# --------------------------------------------------------------------------
# Rails
# --------------------------------------------------------------------------
def rail(
title: str,
products: list[dict],
*,
more_href: str = "market.html",
subtitle: str = "",
promo: bool = False,
) -> str:
"""A horizontal product rail with its own prev/next buttons."""
slides = "".join(product_card(p, rail=True) for p in products)
sub = f'
{subtitle}
' if subtitle else ""
wrap_class = "sp-rail sp-rail--promo" if promo else "sp-rail"
return f"""
"""
# --------------------------------------------------------------------------
# Category displays
# --------------------------------------------------------------------------
# Per-category tint, presentation only — the catalogue itself stays colour-free.
# Each value feeds --sp-cat-tint on the card; unknown slugs fall back to the
# palette's primary, so adding a category never breaks the board.
# The tint is also chip text on hover, so every value clears 4.5:1 on white.
CATEGORY_TINTS = {
"dairy": "#2563d6",
"produce": "#12803c",
"drinks": "#c62c3d",
"snacks": "#8226d6",
"pantry": "#a35f12",
"breakfast": "#9a6106",
"cleaning": "#0e7d8a",
"baby": "#c22b74",
"frozen": "#1b6ea8",
"home": "#6021c4",
}
def _category_subs(products: list[dict], slug: str, limit: int = 3) -> list[str]:
"""
The most common opening word of a category's product titles — «شیر»,
«ماست», «پنیر» … Derived from the catalogue rather than hand-written, so
every sub-link is guaranteed to return rows on the market page.
"""
counts: dict[str, int] = {}
for p in products:
if p["category"] != slug:
continue
head = p["title"].split(" ")[0]
if len(head) > 2:
counts[head] = counts.get(head, 0) + 1
ranked = sorted(counts.items(), key=lambda kv: -kv[1])
return [word for word, _ in ranked[:limit]]
def category_board(categories: list[dict], products: list[dict]) -> str:
"""
Category cards with a tinted photo well, the category's item count and its
top sub-categories as chips — the FRESH homepage's category section.
"""
cards = []
for c in categories:
slug = c["slug"]
tint = CATEGORY_TINTS.get(slug, "var(--sp-primary)")
count = sum(1 for p in products if p["category"] == slug)
tags = "".join(
f'{word}'
for word in _category_subs(products, slug)
)
cards.append(
f"""{c['title']}{fa(count)} کالا{icon("chevron-start", 16)}
{tags}
"""
)
return f'
{"".join(cards)}
'
def category_rail(categories: list[dict]) -> str:
items = "".join(
f''
f''
f'{c["title"]}'
for c in categories
)
return f'
{items}
'
def category_grid(categories: list[dict]) -> str:
items = "".join(
f''
f''
f'{c["title"]}'
for c in categories
)
return f'
{items}
'
def category_index(categories: list[dict], products: list[dict]) -> str:
"""
A numbered directory of the shelves — GRAPHITE's category display.
Rows rather than photo cards: the dark palette then carries ten small light
thumbs instead of ten full-bleed white blocks, and the section reads as an
index next to the price-forward grid below it.
"""
rows = []
for i, c in enumerate(categories, start=1):
slug = c["slug"]
count = sum(1 for p in products if p["category"] == slug)
subs = "، ".join(_category_subs(products, slug, 3))
rows.append(
f"""{fa(i).rjust(2, "۰")}{c['title']}{subs}{fa(count)} کالا{icon("chevron-start", 15)}"""
)
return f'
{"".join(rows)}
'
def category_tiles(categories: list[dict]) -> str:
items = "".join(
f''
f''
f'{c["title"]}'
for c in categories
)
return f'
{items}
'
# --------------------------------------------------------------------------
# Misc
# --------------------------------------------------------------------------
def breadcrumb(trail: list[tuple[str, str]]) -> str:
"""trail: [(href, label), ...] — the last item renders as plain text."""
parts = []
for i, (href, label) in enumerate(trail):
last = i == len(trail) - 1
parts.append(f"{label}" if last else f'{label}')
if not last:
parts.append('/')
return f''
def section_head(title: str, more_href: str = "", subtitle: str = "") -> str:
sub = f'
{art}
"""
def banner_row(banners: list[str], cols: int = 2) -> str:
"""A section of promo cards, sized to sit between two product rails."""
return f"""
{"".join(banners)}
"""
def banner_strip(
href: str,
kicker: str,
title: str,
text: str,
*,
cta: str = "مشاهده",
images: list[str] | None = None,
variant: str = "warm",
) -> str:
"""
A full-width strip banner: copy on one side, a row of category shots on
the other. Reads as a break between rails rather than another card grid.
"""
art = "".join(
f''
for slug in (images or [])
)
return f"""
![{c['title']}](assets/images/categories/{slug}.webp)
{c['title']}
{fa(count)} کالا
'
f'{c["title"]}'
for c in categories
)
return f'
'
if image
else ""
)
return f"""