@stapel/categories-react 0.1.0

package/dist/catalog/sync.js

@@ -0,0 +1,114 @@
+/** An empty snapshot — the state before the first sync. */
+export const EMPTY_SNAPSHOT = {
+    version: 1,
+    cursor: 0,
+    rows: [],
+};
+/** A snapshot with no rows has never synced, whatever its cursor says. */
+export function isEmptySnapshot(snapshot) {
+    return snapshot.rows.length === 0;
+}
+/**
+ * Accept a value read back from persistence, or reject it.
+ *
+ * A repository read can hand back anything: a snapshot written by a previous
+ * version of this pair, a half-written value, `undefined` after a cleared
+ * origin. Every one of those must degrade to "no snapshot" — a cache that
+ * throws on read is worse than no cache.
+ */
+export function parseSnapshot(value) {
+    if (typeof value !== "object" || value === null)
+        return undefined;
+    const candidate = value;
+    if (candidate.version !== 1)
+        return undefined;
+    if (typeof candidate.cursor !== "number" || !Number.isFinite(candidate.cursor)) {
+        return undefined;
+    }
+    if (!Array.isArray(candidate.rows))
+        return undefined;
+    for (const row of candidate.rows) {
+        if (typeof row !== "object" || row === null)
+            return undefined;
+        if (typeof row.id !== "number")
+            return undefined;
+    }
+    return {
+        version: 1,
+        cursor: candidate.cursor,
+        rows: candidate.rows,
+    };
+}
+/**
+ * The request that starts a sync from `snapshot`.
+ *
+ * A cold start asks for everything with `include_deleted: false` — nothing is
+ * cached, so a tombstone has nothing to evict and the payload is smaller. A
+ * warm start asks for the delta with `include_deleted: true`, because there
+ * the tombstones are the point.
+ */
+export function firstPageRequest(snapshot) {
+    if (isEmptySnapshot(snapshot)) {
+        return { includeDeleted: false, page: 1 };
+    }
+    return { minRevision: snapshot.cursor, includeDeleted: true, page: 1 };
+}
+/**
+ * The request for the next page of an in-flight walk, or `undefined` when the
+ * walk is done.
+ *
+ * `maxRevision` pins the window to what the first page reported, so the walk
+ * reads one consistent snapshot of the table instead of a moving one.
+ */
+export function nextPageRequest(previous, page) {
+    if (!page.pagination.has_next)
+        return undefined;
+    return {
+        ...previous,
+        page: page.pagination.page + 1,
+        maxRevision: previous.maxRevision ?? page.revisions.global_max,
+    };
+}
+/**
+ * Fold one page into an accumulator.
+ *
+ * There is one merge rule, and the FULL/DELTA distinction lives in what the
+ * caller starts from, not in a flag here: a delta folds into the stored
+ * snapshot, a full sync folds into {@link EMPTY_SNAPSHOT}. That is the whole
+ * difference — a row the server no longer lists is gone from a full listing
+ * precisely because it was never folded in. Expressing it as a flag on the
+ * merge invites the two silent failures instead: a delta treated as full
+ * empties the catalogue, a full treated as delta resurrects rows deleted while
+ * the client was away.
+ *
+ * The new snapshot is not published until the walk COMPLETES (see
+ * `model/catalogSync.ts`), so a walk that fails halfway leaves the previous
+ * catalogue on screen rather than a truncated one.
+ *
+ * The cursor only ever moves FORWARD, and never past `cursorLimit`:
+ * `global_max` is the table's live maximum, which can already exceed the
+ * window a walk pinned with `max_revision`. Taking it verbatim would record
+ * having read rows the walk never asked for.
+ */
+export function applyCategoryPage(accumulator, page, options = {}) {
+    const byId = new Map();
+    for (const row of accumulator.rows)
+        byId.set(row.id, row);
+    for (const row of page.results) {
+        if (row.deleted === true)
+            byId.delete(row.id);
+        else
+            byId.set(row.id, row);
+    }
+    for (const id of page.revisions.deleted_ids)
+        byId.delete(id);
+    const observed = options.cursorLimit !== undefined
+        ? Math.min(page.revisions.global_max, options.cursorLimit)
+        : page.revisions.global_max;
+    return {
+        version: 1,
+        cursor: Math.max(accumulator.cursor, observed),
+        rows: [...byId.values()],
+    };
+}
+//# sourceMappingURL=sync.js.map

package/dist/catalog/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/catalog/sync.ts"],"names":[],"mappings":"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"}

package/dist/catalog/tree.d.ts

@@ -0,0 +1,119 @@
+/**
+ * The tree the server does not build.
+ *
+ * `stapel-categories` has no tree endpoint. `GET /categories/` returns FLAT
+ * rows ordered by `revision`, each carrying `tn_parent`, `tn_priority` and the
+ * treenode ancestry columns — the client assembles the hierarchy (spec §4.3).
+ * Everything in this file is pure: no React, no fetch, no storage, so the same
+ * functions serve a browser, an SSR render and a test.
+ *
+ * ── Three server facts this module encodes, each a bug if forgotten ────────
+ *
+ * 1. **`deleted` rows are served.** `include_deleted` defaults to `true`, and
+ *    the delta protocol NEEDS it that way. A tree built without filtering
+ *    shows soft-deleted categories in a menu.
+ * 2. **`active: false` rows are served too**, and nothing on the list endpoint
+ *    filters them — only `carousel` does. "Active" is the storefront's
+ *    visibility switch, so the public tree drops them by default and the
+ *    option to keep them is explicit.
+ * 3. **Order is `tn_priority` DESCENDING**, which is what both `children` and
+ *    `carousel` do server-side (`views.py: order_by("-tn_priority")`). Ties
+ *    are broken by `id` so a rebuild is deterministic — priority defaults to
+ *    `0`, so a catalogue that never set it is ALL ties, and an unstable order
+ *    there means the menu reshuffles between renders.
+ */
+import type { Category } from "../api/types.js";
+/** One node of the assembled tree. */
+export interface CategoryNode {
+    readonly category: Category;
+    readonly id: number;
+    readonly depth: number;
+    readonly children: readonly CategoryNode[];
+}
+/**
+ * A built catalogue: the rows, plus the lookups a screen actually asks for.
+ *
+ * Built once per snapshot and shared, because every one of these questions is
+ * asked on every render of every category page.
+ */
+export interface CategoryIndex {
+    /** Roots, in display order. */
+    readonly roots: readonly CategoryNode[];
+    /** Every node by id, including ones filtered out of `roots`' subtrees? No —
+     * only the nodes that survived the filter. What is not in the tree is not
+     * addressable. */
+    readonly byId: ReadonlyMap<number, CategoryNode>;
+    /** Slug → node. See `resolveCategorySlug` for the collision rule. */
+    readonly bySlug: ReadonlyMap<string, CategoryNode>;
+    /** How many rows the source snapshot had before filtering. */
+    readonly totalRows: number;
+}
+export interface BuildCategoryTreeOptions {
+    /** Keep `deleted: true` rows. Default `false`. */
+    readonly includeDeleted?: boolean;
+    /** Keep `active: false` rows. Default `false` — the storefront's answer.
+     * A catalogue admin passes `true`. */
+    readonly includeInactive?: boolean;
+}
+/**
+ * Assemble flat rows into a tree.
+ *
+ * A row whose `tn_parent` is not in the surviving set becomes a ROOT rather
+ * than disappearing. That is not tidiness — it is the only safe answer to the
+ * two ways it legitimately happens: a delta page that brought a child before
+ * its parent, and a parent filtered out by `active: false` while the child was
+ * left active by a catalogue editor. Dropping the subtree would delete a live
+ * branch of the catalogue from the menu and give nobody a reason.
+ */
+export declare function buildCategoryTree(rows: Iterable<Category>, options?: BuildCategoryTreeOptions): CategoryIndex;
+/**
+ * Resolve a URL slug to a category — the lookup the SERVER does not offer.
+ *
+ * `CategoryViewSet` never overrides `lookup_field` and the list endpoint has
+ * no slug filter, so `GET /categories/<slug>/` is a 404 and `?slug=` is
+ * ignored. The storefront's `/c/:slug` therefore resolves against the synced
+ * tree (spec §4.3), which is one more reason the catalogue is cached rather
+ * than fetched per page.
+ *
+ * `Category.slug` is `unique=True` at the model level, so a collision cannot
+ * come from the database. It CAN come from the client's own snapshot — a
+ * delta that renamed a slug from A to B arrives as one row, and a stale row
+ * still holding B has not been evicted yet. First-in-display-order wins,
+ * deterministically, and the loser is reachable by id.
+ */
+export declare function resolveCategorySlug(index: CategoryIndex, slug: string): CategoryNode | undefined;
+/**
+ * The path from the root down to `id`, inclusive — the breadcrumb.
+ *
+ * Walks `tn_parent` through the built index rather than trusting
+ * `tn_ancestors_pks`, because the index is what the screen is showing: if a
+ * filter removed an ancestor, the crumb must not name a category the visitor
+ * cannot open. `categoryAncestorIds` is the other answer — the server's — and
+ * the two are compared in `test/tree.test.ts` precisely so a divergence is a
+ * red test rather than a subtly wrong crumb.
+ *
+ * An unknown id gives `[]`, not a partial path: half a breadcrumb reads as a
+ * top-level category.
+ */
+export declare function categoryBreadcrumbs(index: CategoryIndex, id: number | null | undefined): readonly CategoryNode[];
+/**
+ * The server's own answer to "who are this row's ancestors", root-first, from
+ * `tn_ancestors_pks`.
+ *
+ * Useful without a built index (a single category fetched on its own), and the
+ * cross-check for {@link categoryBreadcrumbs}.
+ */
+export declare function categoryAncestorIds(category: Category): readonly number[];
+/**
+ * The server's own answer to "who are this row's children", from
+ * `tn_children_pks`.
+ *
+ * This is the FULL child set, including soft-deleted and inactive rows — the
+ * column is maintained by treenode, which knows nothing about either flag. Use
+ * it to detect "this category has sub-categories at all"; use the built node's
+ * `children` to render them.
+ */
+export declare function categoryChildIds(category: Category): readonly number[];
+/** Depth-first walk of a subtree (or the whole forest), in display order. */
+export declare function flattenCategoryNodes(nodes: readonly CategoryNode[]): readonly CategoryNode[];
+//# sourceMappingURL=tree.d.ts.map

package/dist/catalog/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../src/catalog/tree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD,sCAAsC;AACtC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;CAC5C;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC;;sBAEkB;IAClB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACjD,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACnD,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,kDAAkD;IAClD,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC;0CACsC;IACtC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC;AAkBD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,EACxB,OAAO,GAAE,wBAA6B,GACrC,aAAa,CAuDf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,MAAM,GACX,YAAY,GAAG,SAAS,CAE1B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,EACpB,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC5B,SAAS,YAAY,EAAE,CAgBzB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,MAAM,EAAE,CAEzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,MAAM,EAAE,CAEtE;AAED,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,YAAY,EAAE,GAC7B,SAAS,YAAY,EAAE,CAUzB"}

package/dist/catalog/tree.js

@@ -0,0 +1,166 @@
+import { parseTreenodePks } from "./pks.js";
+function displayOrder(a, b) {
+    const pa = a.tn_priority ?? 0;
+    const pb = b.tn_priority ?? 0;
+    if (pa !== pb)
+        return pb - pa;
+    return a.id - b.id;
+}
+function keeps(row, options) {
+    if (row.deleted === true && options.includeDeleted !== true)
+        return false;
+    // `active` is optional in the schema and defaults to true on the model, so
+    // the test is "not explicitly false" — an absent field is an active
+    // category, never a hidden one.
+    if (row.active === false && options.includeInactive !== true)
+        return false;
+    return true;
+}
+/**
+ * Assemble flat rows into a tree.
+ *
+ * A row whose `tn_parent` is not in the surviving set becomes a ROOT rather
+ * than disappearing. That is not tidiness — it is the only safe answer to the
+ * two ways it legitimately happens: a delta page that brought a child before
+ * its parent, and a parent filtered out by `active: false` while the child was
+ * left active by a catalogue editor. Dropping the subtree would delete a live
+ * branch of the catalogue from the menu and give nobody a reason.
+ */
+export function buildCategoryTree(rows, options = {}) {
+    const all = [...rows];
+    const kept = all.filter((row) => keeps(row, options)).sort(displayOrder);
+    const childrenOf = new Map();
+    const present = new Set(kept.map((row) => row.id));
+    const roots = [];
+    for (const row of kept) {
+        const parent = row.tn_parent;
+        if (parent === null || parent === undefined || !present.has(parent)) {
+            roots.push(row);
+            continue;
+        }
+        const bucket = childrenOf.get(parent);
+        if (bucket === undefined)
+            childrenOf.set(parent, [row]);
+        else
+            bucket.push(row);
+    }
+    const byId = new Map();
+    const bySlug = new Map();
+    // Iterative build (not recursion): a catalogue is authored data, and a cycle
+    // introduced by a bad `tn_parent` would blow the stack instead of rendering.
+    // `seen` makes a cycle a finite, visible truncation.
+    function build(row, depth, seen) {
+        const kids = childrenOf.get(row.id) ?? [];
+        const nextSeen = new Set(seen).add(row.id);
+        const node = {
+            category: row,
+            id: row.id,
+            depth,
+            children: kids
+                .filter((kid) => !nextSeen.has(kid.id))
+                .map((kid) => build(kid, depth + 1, nextSeen)),
+        };
+        byId.set(row.id, node);
+        if (row.slug !== "" && !bySlug.has(row.slug))
+            bySlug.set(row.slug, node);
+        return node;
+    }
+    const builtRoots = roots.map((row) => build(row, 0, new Set()));
+    // A row that no root can reach is a row inside a PARENT CYCLE (`a.parent =
+    // b, b.parent = a` — authored data, so possible). The recursion above
+    // refuses to follow the cycle, which keeps the stack safe but would drop
+    // those rows entirely: they would vanish from the menu with no error
+    // anywhere. Promote whatever is left to roots instead, so a broken branch
+    // is VISIBLE and fixable rather than absent.
+    for (const row of kept) {
+        if (byId.has(row.id))
+            continue;
+        builtRoots.push(build(row, 0, new Set()));
+    }
+    return { roots: builtRoots, byId, bySlug, totalRows: all.length };
+}
+/**
+ * Resolve a URL slug to a category — the lookup the SERVER does not offer.
+ *
+ * `CategoryViewSet` never overrides `lookup_field` and the list endpoint has
+ * no slug filter, so `GET /categories/<slug>/` is a 404 and `?slug=` is
+ * ignored. The storefront's `/c/:slug` therefore resolves against the synced
+ * tree (spec §4.3), which is one more reason the catalogue is cached rather
+ * than fetched per page.
+ *
+ * `Category.slug` is `unique=True` at the model level, so a collision cannot
+ * come from the database. It CAN come from the client's own snapshot — a
+ * delta that renamed a slug from A to B arrives as one row, and a stale row
+ * still holding B has not been evicted yet. First-in-display-order wins,
+ * deterministically, and the loser is reachable by id.
+ */
+export function resolveCategorySlug(index, slug) {
+    return index.bySlug.get(slug);
+}
+/**
+ * The path from the root down to `id`, inclusive — the breadcrumb.
+ *
+ * Walks `tn_parent` through the built index rather than trusting
+ * `tn_ancestors_pks`, because the index is what the screen is showing: if a
+ * filter removed an ancestor, the crumb must not name a category the visitor
+ * cannot open. `categoryAncestorIds` is the other answer — the server's — and
+ * the two are compared in `test/tree.test.ts` precisely so a divergence is a
+ * red test rather than a subtly wrong crumb.
+ *
+ * An unknown id gives `[]`, not a partial path: half a breadcrumb reads as a
+ * top-level category.
+ */
+export function categoryBreadcrumbs(index, id) {
+    if (id === null || id === undefined)
+        return [];
+    const start = index.byId.get(id);
+    if (start === undefined)
+        return [];
+    const path = [start];
+    const seen = new Set([start.id]);
+    let cursor = start.category.tn_parent;
+    while (cursor !== null && cursor !== undefined && !seen.has(cursor)) {
+        const parent = index.byId.get(cursor);
+        if (parent === undefined)
+            break;
+        path.push(parent);
+        seen.add(parent.id);
+        cursor = parent.category.tn_parent;
+    }
+    return path.reverse();
+}
+/**
+ * The server's own answer to "who are this row's ancestors", root-first, from
+ * `tn_ancestors_pks`.
+ *
+ * Useful without a built index (a single category fetched on its own), and the
+ * cross-check for {@link categoryBreadcrumbs}.
+ */
+export function categoryAncestorIds(category) {
+    return parseTreenodePks(category.tn_ancestors_pks);
+}
+/**
+ * The server's own answer to "who are this row's children", from
+ * `tn_children_pks`.
+ *
+ * This is the FULL child set, including soft-deleted and inactive rows — the
+ * column is maintained by treenode, which knows nothing about either flag. Use
+ * it to detect "this category has sub-categories at all"; use the built node's
+ * `children` to render them.
+ */
+export function categoryChildIds(category) {
+    return parseTreenodePks(category.tn_children_pks);
+}
+/** Depth-first walk of a subtree (or the whole forest), in display order. */
+export function flattenCategoryNodes(nodes) {
+    const out = [];
+    const walk = (list) => {
+        for (const node of list) {
+            out.push(node);
+            walk(node.children);
+        }
+    };
+    walk(nodes);
+    return out;
+}
+//# sourceMappingURL=tree.js.map

package/dist/catalog/tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.js","sourceRoot":"","sources":["../../src/catalog/tree.ts"],"names":[],"mappings":"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"}

package/dist/default/CatalogPage.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `<CatalogPage>` — the catalogue root at `/c`: the carousel over the top-level
+ * tree.
+ *
+ * This is a single-pair screen, which is exactly why it has a nav entry while
+ * `/` does not. The storefront's landing composes THIS pair's carousel with
+ * search's newest-listings feed (spec §5.1), and a composed route belongs to
+ * the container that composes it — see `nav/manifest.ts`.
+ */
+import type { ReactElement } from "react";
+import type { ThemeModeProp } from "./types.js";
+export interface CatalogPageProps extends ThemeModeProp {
+    readonly basePath?: string;
+}
+export declare function CatalogPage(props: CatalogPageProps): ReactElement;
+//# sourceMappingURL=CatalogPage.d.ts.map

package/dist/default/CatalogPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CatalogPage.d.ts","sourceRoot":"","sources":["../../src/default/CatalogPage.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAO1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,YAAY,CAiBjE"}

package/dist/default/CatalogPage.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Flex, Typography } from "antd";
+import { useT } from "@stapel/core";
+import { CATEGORIES_I18N_KEYS } from "../i18n/keys.js";
+import { CategoryCarouselStrip } from "./CategoryCarouselStrip.js";
+import { CategoryTreePane } from "./CategoryTreePane.js";
+import { CategoriesSkinTheme } from "./theme.js";
+export function CatalogPage(props) {
+    const t = useT();
+    const base = props.basePath ?? "/c";
+    return (_jsx(CategoriesSkinTheme, { ...(props.mode !== undefined ? { mode: props.mode } : {}), children: _jsxs(Flex, { vertical: true, gap: 16, "data-testid": "categories-catalog-page", children: [_jsx(Typography.Title, { level: 3, style: { margin: 0 }, children: t(CATEGORIES_I18N_KEYS.catalogTitle) }), _jsx(CategoryCarouselStrip, { basePath: base }), _jsx(CategoryTreePane, { basePath: base })] }) }));
+}
+//# sourceMappingURL=CatalogPage.js.map

package/dist/default/CatalogPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CatalogPage.js","sourceRoot":"","sources":["../../src/default/CatalogPage.tsx"],"names":[],"mappings":";AAUA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAOjD,MAAM,UAAU,WAAW,CAAC,KAAuB;IACjD,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;IACjB,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC;IAEpC,OAAO,CACL,KAAC,mBAAmB,OACd,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,YAE1D,MAAC,IAAI,IAAC,QAAQ,QAAC,GAAG,EAAE,EAAE,iBAAc,yBAAyB,aAC3D,KAAC,UAAU,CAAC,KAAK,IAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,YAC7C,CAAC,CAAC,oBAAoB,CAAC,YAAY,CAAC,GACpB,EACnB,KAAC,qBAAqB,IAAC,QAAQ,EAAE,IAAI,GAAI,EACzC,KAAC,gBAAgB,IAAC,QAAQ,EAAE,IAAI,GAAI,IAC/B,GACa,CACvB,CAAC;AACJ,CAAC"}

package/dist/default/CategoryBreadcrumbsBar.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `<CategoryBreadcrumbsBar>` — root → current, as antd breadcrumbs.
+ *
+ * Every caption goes through `renderCategoryLabel`, which is the one place
+ * this skin decides between "translate this" and "print this": a category's
+ * `name` is a translation KEY unless the row says `translatable: false`
+ * (`catalog/labels.ts`). A skin that called `t()` unconditionally would print
+ * the stored string for an untranslatable category twice-wrapped, and one that
+ * never called it would show `category.electronics` at a visitor.
+ */
+import type { ReactElement } from "react";
+import type { ThemeModeProp } from "./types.js";
+export interface CategoryBreadcrumbsBarProps extends ThemeModeProp {
+    readonly slug?: string;
+    readonly categoryId?: number | null;
+    /** Path prefix for a crumb's link. Default `/c`. */
+    readonly basePath?: string;
+}
+export declare function CategoryBreadcrumbsBar(props: CategoryBreadcrumbsBarProps): ReactElement;
+//# sourceMappingURL=CategoryBreadcrumbsBar.d.ts.map

package/dist/default/CategoryBreadcrumbsBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryBreadcrumbsBar.d.ts","sourceRoot":"","sources":["../../src/default/CategoryBreadcrumbsBar.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAQ1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,2BAA4B,SAAQ,aAAa;IAChE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,2BAA2B,GACjC,YAAY,CA+Dd"}

package/dist/default/CategoryBreadcrumbsBar.js

@@ -0,0 +1,35 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Breadcrumb, Skeleton, Typography } from "antd";
+import { matchLoad, toFlowError, useDescribeFlowError, useT } from "@stapel/core";
+import { renderCategoryLabel } from "../catalog/labels.js";
+import { CategoryBreadcrumbs } from "../headless/CategoryBreadcrumbs.js";
+import { CATEGORIES_I18N_KEYS } from "../i18n/keys.js";
+import { ErrorAlert } from "./ErrorAlert.js";
+import { CategoriesSkinTheme } from "./theme.js";
+export function CategoryBreadcrumbsBar(props) {
+    const t = useT();
+    const describe = useDescribeFlowError();
+    const base = props.basePath ?? "/c";
+    return (_jsx(CategoriesSkinTheme, { ...(props.mode !== undefined ? { mode: props.mode } : {}), children: _jsx(CategoryBreadcrumbs, { ...(props.slug !== undefined ? { slug: props.slug } : {}), ...(props.categoryId !== undefined
+                ? { categoryId: props.categoryId }
+                : {}), children: (bag) => matchLoad(bag.state, {
+                loading: () => (_jsx(Skeleton.Input, { active: true, size: "small", "data-testid": "categories-breadcrumbs-loading" })),
+                failed: (error) => (_jsx(ErrorAlert, { testId: "categories-breadcrumbs-failed", error: {
+                        ...describe(toFlowError(error)),
+                        message: t(CATEGORIES_I18N_KEYS.catalogLoadFailed),
+                    } })),
+                ready: (crumbs) => bag.unknownSlug ? (_jsx(Typography.Text, { type: "secondary", "data-testid": "categories-breadcrumbs-unknown", children: t(CATEGORIES_I18N_KEYS.categoryUnknownSlug) })) : (_jsx(Breadcrumb, { "data-testid": "categories-breadcrumbs", items: [
+                        {
+                            title: t(CATEGORIES_I18N_KEYS.breadcrumbsRoot),
+                            href: base,
+                        },
+                        ...crumbs.map((crumb) => ({
+                            title: renderCategoryLabel(crumb.label, t),
+                            ...(crumb.isCurrent
+                                ? {}
+                                : { href: `${base}/${crumb.node.category.slug}` }),
+                        })),
+                    ] })),
+            }) }) }));
+}
+//# sourceMappingURL=CategoryBreadcrumbsBar.js.map

package/dist/default/CategoryBreadcrumbsBar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryBreadcrumbsBar.js","sourceRoot":"","sources":["../../src/default/CategoryBreadcrumbsBar.tsx"],"names":[],"mappings":";AAWA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,oBAAoB,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAClF,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAUjD,MAAM,UAAU,sBAAsB,CACpC,KAAkC;IAElC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;IACjB,MAAM,QAAQ,GAAG,oBAAoB,EAAE,CAAC;IACxC,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC;IAEpC,OAAO,CACL,KAAC,mBAAmB,OACd,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,YAE1D,KAAC,mBAAmB,OACd,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KACtD,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS;gBACjC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE;gBAClC,CAAC,CAAC,EAAE,CAAC,YAEN,CAAC,GAAG,EAAE,EAAE,CACP,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE;gBACnB,OAAO,EAAE,GAAG,EAAE,CAAC,CACb,KAAC,QAAQ,CAAC,KAAK,IACb,MAAM,QACN,IAAI,EAAC,OAAO,iBACA,gCAAgC,GAC5C,CACH;gBACD,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CACjB,KAAC,UAAU,IACT,MAAM,EAAC,+BAA+B,EACtC,KAAK,EAAE;wBACL,GAAG,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;wBAC/B,OAAO,EAAE,CAAC,CAAC,oBAAoB,CAAC,iBAAiB,CAAC;qBACnD,GACD,CACH;gBACD,KAAK,EAAE,CAAC,MAAM,EAAE,EAAE,CAChB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAChB,KAAC,UAAU,CAAC,IAAI,IACd,IAAI,EAAC,WAAW,iBACJ,gCAAgC,YAE3C,CAAC,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,GAC5B,CACnB,CAAC,CAAC,CAAC,CACF,KAAC,UAAU,mBACG,wBAAwB,EACpC,KAAK,EAAE;wBACL;4BACE,KAAK,EAAE,CAAC,CAAC,oBAAoB,CAAC,eAAe,CAAC;4BAC9C,IAAI,EAAE,IAAI;yBACX;wBACD,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;4BACxB,KAAK,EAAE,mBAAmB,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;4BAC1C,GAAG,CAAC,KAAK,CAAC,SAAS;gCACjB,CAAC,CAAC,EAAE;gCACJ,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;yBACrD,CAAC,CAAC;qBACJ,GACD,CACH;aACJ,CAAC,GAEgB,GACF,CACvB,CAAC;AACJ,CAAC"}

package/dist/default/CategoryCarouselStrip.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `<CategoryCarouselStrip>` — the landing page's row of category tiles.
+ *
+ * The icon references (`carousel_icon` / `catalog_icon`) are OPAQUE STRINGS
+ * that the backend deliberately does not resolve ("Decoupled from stapel-cdn:
+ * an opaque string, resolved by the host if at all"). This skin therefore
+ * renders no `<img>` and builds no URL: it hands the reference to the host
+ * through `renderIcon`, and draws nothing when the host does not supply one. A
+ * guessed CDN path would be a broken image on every deployment that guessed
+ * differently, and a broken image is worse than no image.
+ */
+import type { ReactElement, ReactNode } from "react";
+import type { CarouselEntry } from "../headless/CategoryCarousel.js";
+import type { ThemeModeProp } from "./types.js";
+export interface CategoryCarouselStripProps extends ThemeModeProp {
+    readonly basePath?: string;
+    /** Turn an opaque icon reference into something renderable. Absent means no
+     * icon is drawn — see this file's header. */
+    readonly renderIcon?: (reference: string, entry: CarouselEntry) => ReactNode;
+}
+export declare function CategoryCarouselStrip(props: CategoryCarouselStripProps): ReactElement;
+//# sourceMappingURL=CategoryCarouselStrip.d.ts.map

package/dist/default/CategoryCarouselStrip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryCarouselStrip.d.ts","sourceRoot":"","sources":["../../src/default/CategoryCarouselStrip.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAIrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,0BAA2B,SAAQ,aAAa;IAC/D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;iDAC6C;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,KAAK,SAAS,CAAC;CAC9E;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,0BAA0B,GAChC,YAAY,CAsEd"}

package/dist/default/CategoryCarouselStrip.js

@@ -0,0 +1,24 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Card, Empty, Flex, Skeleton, Typography } from "antd";
+import { matchList, toFlowError, useDescribeFlowError, useT } from "@stapel/core";
+import { renderCategoryLabel } from "../catalog/labels.js";
+import { CategoryCarousel } from "../headless/CategoryCarousel.js";
+import { CATEGORIES_I18N_KEYS } from "../i18n/keys.js";
+import { ErrorAlert } from "./ErrorAlert.js";
+import { CategoriesSkinTheme } from "./theme.js";
+export function CategoryCarouselStrip(props) {
+    const t = useT();
+    const describe = useDescribeFlowError();
+    return (_jsx(CategoriesSkinTheme, { ...(props.mode !== undefined ? { mode: props.mode } : {}), children: _jsx(CategoryCarousel, { ...(props.basePath !== undefined ? { basePath: props.basePath } : {}), children: (bag) => (_jsxs(Flex, { vertical: true, gap: 8, "data-testid": "categories-carousel", children: [_jsx(Typography.Title, { level: 5, style: { margin: 0 }, children: t(CATEGORIES_I18N_KEYS.carouselTitle) }), matchList(bag.state, {
+                        loading: () => (_jsxs(Flex, { gap: 8, children: [_jsx(Skeleton.Button, { active: true, "data-testid": "categories-carousel-loading" }), _jsx(Skeleton.Button, { active: true }), _jsx(Skeleton.Button, { active: true })] })),
+                        failed: (error) => (_jsx(ErrorAlert, { testId: "categories-carousel-failed", error: {
+                                ...describe(toFlowError(error)),
+                                message: t(CATEGORIES_I18N_KEYS.carouselLoadFailed),
+                            } })),
+                        empty: () => (_jsx(Empty, { "data-testid": "categories-carousel-empty", description: t(CATEGORIES_I18N_KEYS.carouselEmpty) })),
+                        ready: (entries) => (_jsx(Flex, { gap: 8, wrap: true, "data-testid": "categories-carousel-list", children: entries.map((entry) => (_jsx(Card, { size: "small", hoverable: true, "data-category-slug": entry.category.slug, children: _jsx(Typography.Link, { href: entry.href, children: _jsxs(Flex, { align: "center", gap: 8, children: [entry.icon !== null && props.renderIcon !== undefined
+                                                ? props.renderIcon(entry.icon, entry)
+                                                : null, _jsx("span", { children: renderCategoryLabel(entry.label, t) })] }) }) }, entry.category.id))) })),
+                    })] })) }) }));
+}
+//# sourceMappingURL=CategoryCarouselStrip.js.map

package/dist/default/CategoryCarouselStrip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryCarouselStrip.js","sourceRoot":"","sources":["../../src/default/CategoryCarouselStrip.tsx"],"names":[],"mappings":"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"}

package/dist/default/CategoryFeatureList.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `<CategoryFeatureList>` — a category's feature SCHEMA, rendered.
+ *
+ * The display integration with `@stapel/attributes-react` in the direction
+ * this pair owns: categories serves the definitions, attributes knows what a
+ * definition MEANS. So the type badge is not a string this file invents —
+ * `featureType` is attributes-react's single reader of `config.type`, and
+ * `BUILTIN_VALUE_EDITOR_TYPES` is its own statement of which types a build can
+ * actually draw. A type outside that set is marked here, on the schema, rather
+ * than discovered when somebody opens the compose form and finds a missing
+ * field.
+ *
+ * The other direction — values, not definitions — belongs to attributes-react
+ * outright: `formatFeatureValue`, `<FeatureBadges>`, `<FeatureValueList>`. A
+ * listing card imports those directly and this pair is not in the path.
+ */
+import type { ReactElement } from "react";
+import type { ThemeModeProp } from "./types.js";
+export interface CategoryFeatureListProps extends ThemeModeProp {
+    readonly categoryId: number | null | undefined;
+}
+export declare function CategoryFeatureList(props: CategoryFeatureListProps): ReactElement;
+//# sourceMappingURL=CategoryFeatureList.d.ts.map

package/dist/default/CategoryFeatureList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryFeatureList.d.ts","sourceRoot":"","sources":["../../src/default/CategoryFeatureList.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAU1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,wBAAyB,SAAQ,aAAa;IAC7D,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CAChD;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,wBAAwB,GAC9B,YAAY,CA0Fd"}