@stapel/categories-react 0.1.0

package/dist/headless/CategoryBreadcrumbs.js

@@ -0,0 +1,42 @@
+import { loadStateFromQuery, mapLoad } from "@stapel/core";
+import { categoryBreadcrumbs, resolveCategorySlug } from "../catalog/tree.js";
+import { categoryLabel } from "../catalog/labels.js";
+import { useCategoryCatalog } from "../model/queries.js";
+/**
+ * The ancestry of the current category, as data.
+ *
+ * Walks the BUILT index rather than `tn_ancestors_pks`: a crumb must name a
+ * category the visitor can actually open, and the built index is what the
+ * visitor is being shown. The server's own column is exposed separately
+ * (`categoryAncestorIds`) and the two are cross-checked in the suite, so a
+ * divergence is a red test rather than a link to nowhere.
+ */
+export function CategoryBreadcrumbs(props) {
+    const { slug, categoryId, children, ...catalogOptions } = props;
+    const query = useCategoryCatalog(catalogOptions);
+    const catalog = loadStateFromQuery(query);
+    const index = catalog.status === "ready" ? catalog.data.index : null;
+    let current = null;
+    if (index !== null) {
+        if (slug !== undefined)
+            current = resolveCategorySlug(index, slug) ?? null;
+        else if (categoryId !== null && categoryId !== undefined) {
+            current = index.byId.get(categoryId) ?? null;
+        }
+    }
+    return children({
+        state: mapLoad(catalog, (data) => {
+            const path = categoryBreadcrumbs(data.index, current?.id);
+            return path.map((node, i) => ({
+                node,
+                label: categoryLabel(node.category),
+                isCurrent: i === path.length - 1,
+            }));
+        }),
+        unknownSlug: catalog.status === "ready" && slug !== undefined && current === null,
+        refetch: () => {
+            void query.refetch();
+        },
+    });
+}
+//# sourceMappingURL=CategoryBreadcrumbs.js.map

package/dist/headless/CategoryBreadcrumbs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryBreadcrumbs.js","sourceRoot":"","sources":["../../src/headless/CategoryBreadcrumbs.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AA8BzD;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAA+B;IAE/B,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,cAAc,EAAE,GAAG,KAAK,CAAC;IAChE,MAAM,KAAK,GAAG,kBAAkB,CAAC,cAAc,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAErE,IAAI,OAAO,GAAwB,IAAI,CAAC;IACxC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,GAAG,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC;aACtE,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YACzD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;QACd,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAC/B,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;YAC1D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC5B,IAAI;gBACJ,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC;gBACnC,SAAS,EAAE,CAAC,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC;aACjC,CAAC,CAAC,CAAC;QACN,CAAC,CAAC;QACF,WAAW,EACT,OAAO,CAAC,MAAM,KAAK,OAAO,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI;QACtE,OAAO,EAAE,GAAG,EAAE;YACZ,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/headless/CategoryCarousel.d.ts

@@ -0,0 +1,48 @@
+import type { ReactNode } from "react";
+import type { LoadState } from "@stapel/core";
+import type { Category } from "../api/types.js";
+import type { CategoryLabel } from "../catalog/labels.js";
+/** One carousel tile. */
+export interface CarouselEntry {
+    readonly category: Category;
+    readonly label: CategoryLabel;
+    /**
+     * The tile's icon reference — `carousel_icon`, falling back to
+     * `catalog_icon`. Both are OPAQUE STRINGS, deliberately decoupled from
+     * stapel-cdn ("an opaque string, resolved by the host if at all",
+     * `models.py`). This pair does not build a URL out of one: the host knows
+     * its CDN base, this library does not, and a guessed URL is a broken image
+     * on every deployment that guessed differently.
+     */
+    readonly icon: string | null;
+    /** The storefront path for this tile. Slug-based, because that is the
+     * route the spec defines — and the reason the client resolves slugs. */
+    readonly href: string;
+}
+export interface CategoryCarouselBag {
+    /**
+     * The tiles. `empty` means the catalogue has no `carousel_enabled`
+     * categories — a real configuration, and a landing page that says nothing
+     * rather than showing a spinner forever.
+     */
+    readonly state: LoadState<readonly CarouselEntry[]>;
+    readonly isFetching: boolean;
+    refetch(): void;
+}
+export interface CategoryCarouselProps {
+    /** Path prefix for a tile's link. Default `/c` — the spec's `/c/:slug`. */
+    basePath?: string;
+    enabled?: boolean;
+    children: (bag: CategoryCarouselBag) => ReactNode;
+}
+/**
+ * The landing page's category strip.
+ *
+ * `GET /categories/carousel/` is the one endpoint that arrives ready to
+ * render: the server filters `active` AND `carousel_enabled`, orders by
+ * `tn_priority` descending, caches the serialization and sends
+ * `Cache-Control: public, max-age`. So this component does no filtering of its
+ * own — it maps rows to tiles and says which strings still need translating.
+ */
+export declare function CategoryCarousel(props: CategoryCarouselProps): ReactNode;
+//# sourceMappingURL=CategoryCarousel.d.ts.map

package/dist/headless/CategoryCarousel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryCarousel.d.ts","sourceRoot":"","sources":["../../src/headless/CategoryCarousel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1D,yBAAyB;AACzB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B;;;;;;;OAOG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;4EACwE;IACxE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,SAAS,aAAa,EAAE,CAAC,CAAC;IACpD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,CAAC,GAAG,EAAE,mBAAmB,KAAK,SAAS,CAAC;CACnD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,SAAS,CA0BxE"}

package/dist/headless/CategoryCarousel.js

@@ -0,0 +1,34 @@
+import { loadStateFromQuery, mapLoad } from "@stapel/core";
+import { categoryLabel } from "../catalog/labels.js";
+import { useCategoryCarousel } from "../model/queries.js";
+/**
+ * The landing page's category strip.
+ *
+ * `GET /categories/carousel/` is the one endpoint that arrives ready to
+ * render: the server filters `active` AND `carousel_enabled`, orders by
+ * `tn_priority` descending, caches the serialization and sends
+ * `Cache-Control: public, max-age`. So this component does no filtering of its
+ * own — it maps rows to tiles and says which strings still need translating.
+ */
+export function CategoryCarousel(props) {
+    const base = props.basePath ?? "/c";
+    const query = useCategoryCarousel(props.enabled !== undefined ? { enabled: props.enabled } : {});
+    const state = loadStateFromQuery(query);
+    return props.children({
+        state: mapLoad(state, (rows) => rows.map((category) => ({
+            category,
+            label: categoryLabel(category),
+            icon: category.carousel_icon !== undefined && category.carousel_icon !== ""
+                ? category.carousel_icon
+                : category.catalog_icon !== undefined && category.catalog_icon !== ""
+                    ? category.catalog_icon
+                    : null,
+            href: `${base}/${category.slug}`,
+        }))),
+        isFetching: query.isFetching,
+        refetch: () => {
+            void query.refetch();
+        },
+    });
+}
+//# sourceMappingURL=CategoryCarousel.js.map

package/dist/headless/CategoryCarousel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryCarousel.js","sourceRoot":"","sources":["../../src/headless/CategoryCarousel.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAG3D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAsC1D;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAA4B;IAC3D,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC;IACpC,MAAM,KAAK,GAAG,mBAAmB,CAC/B,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAC9D,CAAC;IACF,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAExC,OAAO,KAAK,CAAC,QAAQ,CAAC;QACpB,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAC7B,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACtB,QAAQ;YACR,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC;YAC9B,IAAI,EACF,QAAQ,CAAC,aAAa,KAAK,SAAS,IAAI,QAAQ,CAAC,aAAa,KAAK,EAAE;gBACnE,CAAC,CAAC,QAAQ,CAAC,aAAa;gBACxB,CAAC,CAAC,QAAQ,CAAC,YAAY,KAAK,SAAS,IAAI,QAAQ,CAAC,YAAY,KAAK,EAAE;oBACnE,CAAC,CAAC,QAAQ,CAAC,YAAY;oBACvB,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,GAAG,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE;SACjC,CAAC,CAAC,CACJ;QACD,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO,EAAE,GAAG,EAAE;YACZ,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/headless/CategoryFeatures.d.ts

@@ -0,0 +1,67 @@
+import type { ReactNode } from "react";
+import type { LoadState } from "@stapel/core";
+import type { CategoryFeature } from "../api/types.js";
+import type { CategoryLabel } from "../catalog/labels.js";
+/** One feature of a category, with everything a renderer needs decided. */
+export interface CategoryFeatureEntry {
+    readonly feature: CategoryFeature;
+    /** `kind: "key"` → translate. `translate: "none"` makes it a literal. */
+    readonly label: CategoryLabel;
+    /** `config.type`, or `undefined` when the row carries none. An undefined
+     * type is an UNSUPPORTED type as far as any renderer is concerned —
+     * `@stapel/attributes-react` says so loudly rather than skipping the row. */
+    readonly type: string | undefined;
+    readonly mandatory: boolean;
+    /** Are this feature's option labels translation keys? Only under
+     * `translate: "all"` and while `translatable_options` is not false. */
+    readonly optionsAreKeys: boolean;
+}
+export interface CategoryFeaturesBag {
+    /**
+     * The feature schema. `empty` means the category declares no features and
+     * inherits none — common for a root category, and a compose form that says
+     * "no extra details for this category" rather than spinning.
+     */
+    readonly state: LoadState<readonly CategoryFeatureEntry[]>;
+    /**
+     * The raw `FeatureDef[]`, ready to hand straight to
+     * `@stapel/attributes-react`'s `<FeatureFields>`, `unsupportedTypeGate`,
+     * `mirrorValidate` or `formatFeatureValue`. Kept beside the decorated list
+     * because those functions take the wire shape, and re-deriving it from
+     * `entries` would be a second mapping to keep in step.
+     */
+    readonly features: readonly CategoryFeature[];
+    /** Only the features marked `show_as_badge` — the card's summary line. */
+    readonly badges: readonly CategoryFeature[];
+    /** Only the features marked `show_at_title` — the generated title parts. */
+    readonly titleParts: readonly CategoryFeature[];
+    readonly isFetching: boolean;
+    refetch(): void;
+}
+export interface CategoryFeaturesProps {
+    categoryId: number | null | undefined;
+    enabled?: boolean;
+    children: (bag: CategoryFeaturesBag) => ReactNode;
+}
+/**
+ * A category's feature schema — the bridge to `@stapel/attributes-react`.
+ *
+ * `GET /categories/{id}/features/` resolves inheritance and order server-side
+ * and returns `FeatureCompact` rows whose `config` is the polymorphic
+ * attributes config, VERBATIM: `FeatureCompactSerializer.get_config` returns
+ * `obj.config`, not `get_config_with_defaults()`. So an absent config key
+ * means "the type's default", never "off", and this pair does not restate
+ * those defaults — attributes-react owns them (its §13.2 note 1).
+ *
+ * The two consumers this exists for:
+ *
+ *  - the **compose form** (`listings-react`), which draws the features with
+ *    attributes-react's editor registry and blocks submit on a type this
+ *    build cannot draw; and
+ *  - the **facet panel** (`search-react`), whose `categoryFeatures` slot takes
+ *    exactly `features` below and uses it to caption facet values.
+ *
+ * Neither of them re-fetches: a host mounts this once per category page.
+ */
+export declare function CategoryFeatures(props: CategoryFeaturesProps): ReactNode;
+//# sourceMappingURL=CategoryFeatures.d.ts.map

package/dist/headless/CategoryFeatures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryFeatures.d.ts","sourceRoot":"","sources":["../../src/headless/CategoryFeatures.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1D,2EAA2E;AAC3E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B;;iFAE6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B;2EACuE;IACvE,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,SAAS,oBAAoB,EAAE,CAAC,CAAC;IAC3D;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;IAChD,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,CAAC,GAAG,EAAE,mBAAmB,KAAK,SAAS,CAAC;CACnD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,SAAS,CA0BxE"}

package/dist/headless/CategoryFeatures.js

@@ -0,0 +1,46 @@
+import { loadStateFromQuery, mapLoad } from "@stapel/core";
+import { featureType } from "@stapel/attributes-react";
+import { featureLabel, featureOptionsAreKeys } from "../catalog/labels.js";
+import { useCategoryFeatures } from "../model/queries.js";
+/**
+ * A category's feature schema — the bridge to `@stapel/attributes-react`.
+ *
+ * `GET /categories/{id}/features/` resolves inheritance and order server-side
+ * and returns `FeatureCompact` rows whose `config` is the polymorphic
+ * attributes config, VERBATIM: `FeatureCompactSerializer.get_config` returns
+ * `obj.config`, not `get_config_with_defaults()`. So an absent config key
+ * means "the type's default", never "off", and this pair does not restate
+ * those defaults — attributes-react owns them (its §13.2 note 1).
+ *
+ * The two consumers this exists for:
+ *
+ *  - the **compose form** (`listings-react`), which draws the features with
+ *    attributes-react's editor registry and blocks submit on a type this
+ *    build cannot draw; and
+ *  - the **facet panel** (`search-react`), whose `categoryFeatures` slot takes
+ *    exactly `features` below and uses it to caption facet values.
+ *
+ * Neither of them re-fetches: a host mounts this once per category page.
+ */
+export function CategoryFeatures(props) {
+    const query = useCategoryFeatures(props.categoryId, props.enabled !== undefined ? { enabled: props.enabled } : {});
+    const state = loadStateFromQuery(query);
+    const features = state.status === "ready" ? state.data : [];
+    return props.children({
+        state: mapLoad(state, (rows) => rows.map((feature) => ({
+            feature,
+            label: featureLabel(feature),
+            type: featureType(feature),
+            mandatory: feature.mandatory === true,
+            optionsAreKeys: featureOptionsAreKeys(feature),
+        }))),
+        features,
+        badges: features.filter((f) => f.show_as_badge === true),
+        titleParts: features.filter((f) => f.show_at_title === true),
+        isFetching: query.isFetching,
+        refetch: () => {
+            void query.refetch();
+        },
+    });
+}
+//# sourceMappingURL=CategoryFeatures.js.map

package/dist/headless/CategoryFeatures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryFeatures.js","sourceRoot":"","sources":["../../src/headless/CategoryFeatures.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AA8C1D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAA4B;IAC3D,MAAM,KAAK,GAAG,mBAAmB,CAC/B,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAC9D,CAAC;IACF,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAE5D,OAAO,KAAK,CAAC,QAAQ,CAAC;QACpB,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAC7B,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACrB,OAAO;YACP,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC;YAC5B,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC;YAC1B,SAAS,EAAE,OAAO,CAAC,SAAS,KAAK,IAAI;YACrC,cAAc,EAAE,qBAAqB,CAAC,OAAO,CAAC;SAC/C,CAAC,CAAC,CACJ;QACD,QAAQ;QACR,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,IAAI,CAAC;QACxD,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,IAAI,CAAC;QAC5D,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO,EAAE,GAAG,EAAE;YACZ,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/headless/CategoryPicker.d.ts

@@ -0,0 +1,69 @@
+import type { ReactNode } from "react";
+import type { LoadState } from "@stapel/core";
+import type { CategoryNode } from "../catalog/tree.js";
+import type { CategoryLabel } from "../catalog/labels.js";
+import type { UseCategoryCatalogOptions } from "../model/queries.js";
+/** One selectable option in the picker. */
+export interface CategoryOption {
+    readonly node: CategoryNode;
+    readonly label: CategoryLabel;
+    /** Root → this node, for a skin that shows the full path in the option. */
+    readonly path: readonly CategoryLabel[];
+    /** `true` when this node has no children — usually the only kind a listing
+     * may be filed under. See `leavesOnly`. */
+    readonly isLeaf: boolean;
+}
+export interface CategoryPickerBag {
+    /**
+     * The options at the current drill level, or the search matches while a
+     * query is typed. `empty` is a real answer here — a leaf category has no
+     * children, and a search can match nothing.
+     */
+    readonly state: LoadState<readonly CategoryOption[]>;
+    /** Where the drill-down currently is: root → open node. */
+    readonly path: readonly CategoryNode[];
+    /** The selected node, or `null`. */
+    readonly selected: CategoryNode | null;
+    /** Blocked when nothing is selected, or when the selection is not a leaf
+     * and `leavesOnly` is on. Carries the REASON — a disabled control that does
+     * not say why is the thing `ActionAvailability` exists to prevent. */
+    readonly submitBlockedReason: CategoryPickerBlockedReason | null;
+    readonly query: string;
+    setQuery(value: string): void;
+    /** Descend into a node. A leaf selects instead of descending. */
+    open(node: CategoryNode): void;
+    /** Back up one level. */
+    up(): void;
+    select(node: CategoryNode | null): void;
+    refetch(): void;
+}
+/** Why the picker will not hand a value back yet. */
+export type CategoryPickerBlockedReason = "nothing_selected" | "not_a_leaf";
+export interface CategoryPickerProps extends UseCategoryCatalogOptions {
+    /** Controlled selection. */
+    value?: number | null;
+    onChange?: (id: number | null, node: CategoryNode | null) => void;
+    /**
+     * Only leaf categories are a valid answer. Default `true`: a listing filed
+     * under "Electronics" instead of "Electronics › Phones › Used" inherits the
+     * wrong feature set, and the compose form then asks the wrong questions.
+     */
+    leavesOnly?: boolean;
+    /** Resolve a translation key to a caption, so SEARCH matches what the
+     * person can read. Without it, search matches the key. */
+    translate?: (key: string) => string;
+    children: (bag: CategoryPickerBag) => ReactNode;
+}
+/**
+ * The category chooser of the compose form, headless.
+ *
+ * Two modes over the SAME synced tree: drill-down (roots → children → …) and
+ * a flat search. The search matches the RENDERED caption when a `translate` is
+ * supplied and the raw key otherwise, which is the only honest behaviour for a
+ * catalogue whose names are translation keys (`catalog/labels.ts`): a person
+ * typing "phones" is typing what they see, not `category.phones`.
+ *
+ * Nothing here requests anything — the catalogue is already in memory.
+ */
+export declare function CategoryPicker(props: CategoryPickerProps): ReactNode;
+//# sourceMappingURL=CategoryPicker.d.ts.map

package/dist/headless/CategoryPicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryPicker.d.ts","sourceRoot":"","sources":["../../src/headless/CategoryPicker.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAK9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAErE,2CAA2C;AAC3C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,CAAC;IACxC;+CAC2C;IAC3C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,SAAS,cAAc,EAAE,CAAC,CAAC;IACrD,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,SAAS,YAAY,EAAE,CAAC;IACvC,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IACvC;;0EAEsE;IACtE,QAAQ,CAAC,mBAAmB,EAAE,2BAA2B,GAAG,IAAI,CAAC;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iEAAiE;IACjE,IAAI,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/B,yBAAyB;IACzB,EAAE,IAAI,IAAI,CAAC;IACX,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAAC;IACxC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,qDAAqD;AACrD,MAAM,MAAM,2BAA2B,GAAG,kBAAkB,GAAG,YAAY,CAAC;AAE5E,MAAM,WAAW,mBAAoB,SAAQ,yBAAyB;IACpE,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,CAAC;IAClE;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;8DAC0D;IAC1D,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,QAAQ,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,SAAS,CAAC;CACjD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,SAAS,CA4FpE"}

package/dist/headless/CategoryPicker.js

@@ -0,0 +1,86 @@
+import { useMemo, useState } from "react";
+import { loadStateFromQuery, mapLoad } from "@stapel/core";
+import { categoryBreadcrumbs, flattenCategoryNodes, } from "../catalog/tree.js";
+import { categoryLabel, renderCategoryLabel } from "../catalog/labels.js";
+import { useCategoryCatalog } from "../model/queries.js";
+/**
+ * The category chooser of the compose form, headless.
+ *
+ * Two modes over the SAME synced tree: drill-down (roots → children → …) and
+ * a flat search. The search matches the RENDERED caption when a `translate` is
+ * supplied and the raw key otherwise, which is the only honest behaviour for a
+ * catalogue whose names are translation keys (`catalog/labels.ts`): a person
+ * typing "phones" is typing what they see, not `category.phones`.
+ *
+ * Nothing here requests anything — the catalogue is already in memory.
+ */
+export function CategoryPicker(props) {
+    const { value, onChange, leavesOnly, translate, children, ...catalogOptions } = props;
+    const requireLeaf = leavesOnly ?? true;
+    const query = useCategoryCatalog(catalogOptions);
+    const catalog = loadStateFromQuery(query);
+    const index = catalog.status === "ready" ? catalog.data.index : null;
+    const [openId, setOpenId] = useState(null);
+    const [text, setText] = useState("");
+    const selected = index !== null && value !== null && value !== undefined
+        ? (index.byId.get(value) ?? null)
+        : null;
+    const toOption = useMemo(() => (node) => ({
+        node,
+        label: categoryLabel(node.category),
+        path: (index === null ? [] : categoryBreadcrumbs(index, node.id)).map((crumb) => categoryLabel(crumb.category)),
+        isLeaf: node.children.length === 0,
+    }), [index]);
+    const options = useMemo(() => {
+        if (index === null)
+            return [];
+        const needle = text.trim().toLocaleLowerCase();
+        if (needle !== "") {
+            const caption = (node) => {
+                const label = categoryLabel(node.category);
+                return translate === undefined
+                    ? label.value
+                    : renderCategoryLabel(label, translate);
+            };
+            return flattenCategoryNodes(index.roots)
+                .filter((node) => caption(node).toLocaleLowerCase().includes(needle) ||
+                node.category.slug.toLocaleLowerCase().includes(needle))
+                .filter((node) => !requireLeaf || node.children.length === 0)
+                .map(toOption);
+        }
+        const level = openId === null ? index.roots : (index.byId.get(openId)?.children ?? []);
+        return level.map(toOption);
+    }, [index, text, openId, requireLeaf, translate, toOption]);
+    const blocked = selected === null
+        ? "nothing_selected"
+        : requireLeaf && selected.children.length > 0
+            ? "not_a_leaf"
+            : null;
+    return children({
+        state: mapLoad(catalog, () => options),
+        path: index === null ? [] : categoryBreadcrumbs(index, openId),
+        selected,
+        submitBlockedReason: blocked,
+        query: text,
+        setQuery: setText,
+        open: (node) => {
+            if (node.children.length === 0) {
+                onChange?.(node.id, node);
+                return;
+            }
+            setOpenId(node.id);
+        },
+        up: () => {
+            if (index === null || openId === null)
+                return;
+            setOpenId(index.byId.get(openId)?.category.tn_parent ?? null);
+        },
+        select: (node) => {
+            onChange?.(node?.id ?? null, node);
+        },
+        refetch: () => {
+            void query.refetch();
+        },
+    });
+}
+//# sourceMappingURL=CategoryPicker.js.map

package/dist/headless/CategoryPicker.js.map

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

package/dist/headless/CategoryTree.d.ts

@@ -0,0 +1,55 @@
+import type { ReactNode } from "react";
+import type { LoadState } from "@stapel/core";
+import type { CategoryNode } from "../catalog/tree.js";
+import type { CategoryCatalog, UseCategoryCatalogOptions } from "../model/queries.js";
+/** The bag `<CategoryTree>` hands its render prop. */
+export interface CategoryTreeBag {
+    /**
+     * The nodes to render at this level. `empty` means the catalogue really has
+     * no categories here — reachable only from a sync that succeeded, which is
+     * the whole reason it is a separate arm from `failed`.
+     */
+    readonly state: LoadState<readonly CategoryNode[]>;
+    /** The full built catalogue, for a skin that wants more than one level. */
+    readonly catalog: LoadState<CategoryCatalog>;
+    /** The node `slug`/`categoryId` selected, once the catalogue has loaded. */
+    readonly current: CategoryNode | null;
+    /** Root → current, inclusive. `[]` when nothing is selected. */
+    readonly breadcrumbs: readonly CategoryNode[];
+    /**
+     * A slug that is not in the loaded catalogue. `true` only once the
+     * catalogue is `ready` — before that the honest answer is "we do not know
+     * yet", and a skin that renders "category not found" during a sync is
+     * showing a 404 for a page that exists.
+     */
+    readonly unknownSlug: boolean;
+    /**
+     * The page budget stopped the sync walk: this tree is INCOMPLETE. Distinct
+     * from `empty` in the same way `failed` is — a branch missing here was not
+     * read, not absent.
+     */
+    readonly truncated: boolean;
+    readonly isFetching: boolean;
+    refetch(): void;
+}
+export interface CategoryTreeProps extends UseCategoryCatalogOptions {
+    /** Render the children of this category instead of the roots. */
+    parentId?: number | null;
+    /** Select a category by slug — the `/c/:slug` route's job. Resolved against
+     * the synced tree because the server has no slug lookup. */
+    slug?: string;
+    /** Select a category by id. Ignored when `slug` is given. */
+    categoryId?: number | null;
+    children: (bag: CategoryTreeBag) => ReactNode;
+}
+/**
+ * Headless category navigation over the delta-synced catalogue.
+ *
+ * One hook mounted anywhere in the tree serves every level: the roots on the
+ * catalogue page, one category's children on `/c/:slug`, the breadcrumb above
+ * either. Nothing here issues a request per level — the tree is already in
+ * memory (see `useCategoryCatalog`), which is precisely the property the spec
+ * asked for in §4.3.
+ */
+export declare function CategoryTree(props: CategoryTreeProps): ReactNode;
+//# sourceMappingURL=CategoryTree.d.ts.map

package/dist/headless/CategoryTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryTree.d.ts","sourceRoot":"","sources":["../../src/headless/CategoryTree.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,KAAK,EACV,eAAe,EACf,yBAAyB,EAC1B,MAAM,qBAAqB,CAAC;AAE7B,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC;IACnD,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,eAAe,CAAC,CAAC;IAC7C,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IACtC,gEAAgE;IAChE,QAAQ,CAAC,WAAW,EAAE,SAAS,YAAY,EAAE,CAAC;IAC9C;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,iBAAkB,SAAQ,yBAAyB;IAClE,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;gEAC4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,SAAS,CAAC;CAC/C;AAkBD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,SAAS,CAoChE"}

package/dist/headless/CategoryTree.js

@@ -0,0 +1,51 @@
+import { loadStateFromQuery, mapLoad } from "@stapel/core";
+import { categoryBreadcrumbs, resolveCategorySlug } from "../catalog/tree.js";
+import { useCategoryCatalog } from "../model/queries.js";
+function levelOf(index, parentId, current) {
+    if (parentId !== null && parentId !== undefined) {
+        return index.byId.get(parentId)?.children ?? [];
+    }
+    // With a category selected and no explicit parent, "the level" is that
+    // category's own sub-categories — which is what a category page shows. A
+    // LEAF category has none, and that empty is a true empty: the skin below it
+    // renders listings, not a menu.
+    if (current !== null)
+        return current.children;
+    return index.roots;
+}
+/**
+ * Headless category navigation over the delta-synced catalogue.
+ *
+ * One hook mounted anywhere in the tree serves every level: the roots on the
+ * catalogue page, one category's children on `/c/:slug`, the breadcrumb above
+ * either. Nothing here issues a request per level — the tree is already in
+ * memory (see `useCategoryCatalog`), which is precisely the property the spec
+ * asked for in §4.3.
+ */
+export function CategoryTree(props) {
+    const { parentId, slug, categoryId, children, ...catalogOptions } = props;
+    const query = useCategoryCatalog(catalogOptions);
+    const catalog = loadStateFromQuery(query);
+    const index = catalog.status === "ready" ? catalog.data.index : null;
+    let current = null;
+    if (index !== null) {
+        if (slug !== undefined)
+            current = resolveCategorySlug(index, slug) ?? null;
+        else if (categoryId !== null && categoryId !== undefined) {
+            current = index.byId.get(categoryId) ?? null;
+        }
+    }
+    return children({
+        state: mapLoad(catalog, (data) => levelOf(data.index, parentId, current)),
+        catalog,
+        current,
+        breadcrumbs: index === null ? [] : categoryBreadcrumbs(index, current?.id),
+        unknownSlug: catalog.status === "ready" && slug !== undefined && current === null,
+        truncated: catalog.status === "ready" && catalog.data.truncated,
+        isFetching: query.isFetching,
+        refetch: () => {
+            void query.refetch();
+        },
+    });
+}
+//# sourceMappingURL=CategoryTree.js.map

package/dist/headless/CategoryTree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryTree.js","sourceRoot":"","sources":["../../src/headless/CategoryTree.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAgDzD,SAAS,OAAO,CACd,KAAoB,EACpB,QAAmC,EACnC,OAA4B;IAE5B,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,QAAQ,IAAI,EAAE,CAAC;IAClD,CAAC;IACD,uEAAuE;IACvE,yEAAyE;IACzE,4EAA4E;IAC5E,gCAAgC;IAChC,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,OAAO,CAAC,QAAQ,CAAC;IAC9C,OAAO,KAAK,CAAC,KAAK,CAAC;AACrB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,MAAM,EACJ,QAAQ,EACR,IAAI,EACJ,UAAU,EACV,QAAQ,EACR,GAAG,cAAc,EAClB,GAAG,KAAK,CAAC;IACV,MAAM,KAAK,GAAG,kBAAkB,CAAC,cAAc,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAErE,IAAI,OAAO,GAAwB,IAAI,CAAC;IACxC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,GAAG,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC;aACtE,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YACzD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;QACd,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAC/B,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CACvC;QACD,OAAO;QACP,OAAO;QACP,WAAW,EACT,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC;QAC/D,WAAW,EACT,OAAO,CAAC,MAAM,KAAK,OAAO,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI;QACtE,SAAS,EAAE,OAAO,CAAC,MAAM,KAAK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,SAAS;QAC/D,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO,EAAE,GAAG,EAAE;YACZ,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/i18n/errorsMap.d.ts

@@ -0,0 +1,22 @@
+import type { Remediation } from "./generated/errors.gen.js";
+export { CATEGORIES_ERRORS, CATEGORIES_ERROR_CODES, categoriesErrorBundleEn, } from "./generated/errors.gen.js";
+export type { CategoriesErrorCode, CategoriesErrorSpec, Remediation, } from "./generated/errors.gen.js";
+/**
+ * The optimistic-concurrency refusal of the feature editor, named because it
+ * is the one 409 in the registry and it means something specific: somebody
+ * else changed this category's schema while you were editing it, and
+ * `params.expected` / `params.actual` say which revisions.
+ *
+ * Not raised by anything on this pair's surface (the feature editor is a staff
+ * screen — see `api/categoriesApi.ts`), and exported anyway because the
+ * catalogue admin a host builds on top of this client WILL meet it, and a
+ * constant beats a string retyped at each call site.
+ */
+export declare const CATEGORIES_FEATURE_EDITOR_CONFLICT = "error.409.categories_feature_editor_conflict";
+/**
+ * Resolve a backend error code to its remediation hint, or `undefined` for a
+ * code this module doesn't know (e.g. a cross-cutting `stapel.http.*`
+ * fallback). Zero guessing at runtime — a static lookup over the generated map.
+ */
+export declare function explainCategoriesError(code: string): Remediation | undefined;
+//# sourceMappingURL=errorsMap.d.ts.map

package/dist/i18n/errorsMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorsMap.d.ts","sourceRoot":"","sources":["../../src/i18n/errorsMap.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,GACZ,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kCAAkC,iDACC,CAAC;AAEjD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAI5E"}

package/dist/i18n/errorsMap.js

@@ -0,0 +1,31 @@
+/**
+ * The pair's error map (frontend-standard §4 checklist #7, frontend-core
+ * §2.5): the generated `code → { status, params, remediation, en }` catalog
+ * plus a tiny `explain()` lookup. Backs the manifest `errors` block and gives
+ * hosts a mechanical UX branch beside `t(code, params)`. The map itself is
+ * generated from the backend registry (`pnpm gen:errors`); this file only adds
+ * the lookup helper and re-exports the public surface.
+ */
+import { CATEGORIES_ERRORS } from "./generated/errors.gen.js";
+export { CATEGORIES_ERRORS, CATEGORIES_ERROR_CODES, categoriesErrorBundleEn, } from "./generated/errors.gen.js";
+/**
+ * The optimistic-concurrency refusal of the feature editor, named because it
+ * is the one 409 in the registry and it means something specific: somebody
+ * else changed this category's schema while you were editing it, and
+ * `params.expected` / `params.actual` say which revisions.
+ *
+ * Not raised by anything on this pair's surface (the feature editor is a staff
+ * screen — see `api/categoriesApi.ts`), and exported anyway because the
+ * catalogue admin a host builds on top of this client WILL meet it, and a
+ * constant beats a string retyped at each call site.
+ */
+export const CATEGORIES_FEATURE_EDITOR_CONFLICT = "error.409.categories_feature_editor_conflict";
+/**
+ * Resolve a backend error code to its remediation hint, or `undefined` for a
+ * code this module doesn't know (e.g. a cross-cutting `stapel.http.*`
+ * fallback). Zero guessing at runtime — a static lookup over the generated map.
+ */
+export function explainCategoriesError(code) {
+    return CATEGORIES_ERRORS[code]?.remediation;
+}
+//# sourceMappingURL=errorsMap.js.map

package/dist/i18n/errorsMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorsMap.js","sourceRoot":"","sources":["../../src/i18n/errorsMap.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AAOnC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAC7C,8CAA8C,CAAC;AAEjD;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,OAAQ,iBAAkE,CACxE,IAAI,CACL,EAAE,WAAW,CAAC;AACjB,CAAC"}