@stapel/categories-react 0.1.0

package/dist/default/CategoryFeatureList.js

@@ -0,0 +1,28 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Empty, Flex, List, Spin, Tag, Typography } from "antd";
+import { matchList, toFlowError, useDescribeFlowError, useT } from "@stapel/core";
+import { BUILTIN_VALUE_EDITOR_TYPES } from "@stapel/attributes-react/default";
+import { renderCategoryLabel } from "../catalog/labels.js";
+import { CategoryFeatures } from "../headless/CategoryFeatures.js";
+import { CATEGORIES_I18N_KEYS } from "../i18n/keys.js";
+import { ErrorAlert } from "./ErrorAlert.js";
+import { CategoriesSkinTheme } from "./theme.js";
+export function CategoryFeatureList(props) {
+    const t = useT();
+    const describe = useDescribeFlowError();
+    const drawable = new Set(BUILTIN_VALUE_EDITOR_TYPES);
+    return (_jsx(CategoriesSkinTheme, { ...(props.mode !== undefined ? { mode: props.mode } : {}), children: _jsx(CategoryFeatures, { categoryId: props.categoryId, children: (bag) => (_jsxs(Flex, { vertical: true, gap: 8, "data-testid": "categories-features", children: [_jsx(Typography.Title, { level: 5, style: { margin: 0 }, children: t(CATEGORIES_I18N_KEYS.featuresTitle) }), matchList(bag.state, {
+                        loading: () => (_jsx(Flex, { justify: "center", style: { padding: 16 }, children: _jsx(Spin, { "data-testid": "categories-features-loading" }) })),
+                        failed: (error) => (_jsx(ErrorAlert, { testId: "categories-features-failed", error: {
+                                ...describe(toFlowError(error)),
+                                message: t(CATEGORIES_I18N_KEYS.featuresLoadFailed),
+                            } })),
+                        empty: () => (_jsx(Empty, { "data-testid": "categories-features-empty", description: t(CATEGORIES_I18N_KEYS.featuresEmpty) })),
+                        ready: (entries) => (_jsx(List, { "data-testid": "categories-features-list", size: "small", dataSource: [...entries], renderItem: (entry) => (_jsx(List.Item, { "data-feature-slug": entry.feature.slug, children: _jsxs(Flex, { justify: "space-between", align: "center", gap: 8, style: { width: "100%" }, children: [_jsx(Typography.Text, { children: renderCategoryLabel(entry.label, t) }), _jsxs(Flex, { gap: 4, align: "center", children: [entry.mandatory ? (_jsx(Tag, { color: "red", children: t(CATEGORIES_I18N_KEYS.featuresMandatory) })) : null, entry.type === undefined ? (_jsx(Tag, { color: "warning", "data-feature-untyped": true, children: t(CATEGORIES_I18N_KEYS.featuresUntyped) })) : (_jsx(Tag, { ...(drawable.has(entry.type)
+                                                        ? {}
+                                                        : { color: "warning" }), "data-feature-type": entry.type, children: t(CATEGORIES_I18N_KEYS.featuresType, {
+                                                        type: entry.type,
+                                                    }) }))] })] }) }, entry.feature.slug)) })),
+                    })] })) }) }));
+}
+//# sourceMappingURL=CategoryFeatureList.js.map

package/dist/default/CategoryFeatureList.js.map

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

package/dist/default/CategoryPage.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `<CategoryPage>` — the `/c/:slug` screen: breadcrumbs, sub-categories, and a
+ * SLOT where the listings go.
+ *
+ * The slot is the whole design. Spec §5.1 makes this route "categories +
+ * search": the sub-category menu comes from here, the results with facets come
+ * from `@stapel/search-react`. A pair may not import another L2 pair
+ * (dependency direction is strictly downward), and a screen that rendered only
+ * half of itself would be useless — so the half this pair does not own is a
+ * render prop, handed the resolved category. The container writes one line:
+ *
+ * ```tsx
+ * <CategoryPage
+ *   slug={slug}
+ *   renderListings={(category) => (
+ *     <SearchPage adapter={useRouterSearchParams()} defaultType="listing"
+ *                 fixedCategory={category.id} />
+ *   )}
+ * />
+ * ```
+ *
+ * `slug` resolution happens against the synced tree because the SERVER cannot
+ * do it (`nav/manifest.ts`, `catalog/tree.ts`). Until the catalogue has
+ * loaded, an unknown slug is not yet unknown — the "no category here" line is
+ * shown only once the sync succeeded, so a slow network never renders a 404
+ * for a page that exists.
+ */
+import type { ReactElement, ReactNode } from "react";
+import type { Category } from "../api/types.js";
+import type { ThemeModeProp } from "./types.js";
+export interface CategoryPageProps extends ThemeModeProp {
+    /** The `:slug` segment of `/c/:slug`. */
+    readonly slug: string;
+    readonly basePath?: string;
+    /** The listings half of the screen — supplied by the container, because it
+     * belongs to another pair. */
+    readonly renderListings?: (category: Category) => ReactNode;
+    /** Show the category's feature schema. Off by default: on a storefront the
+     * schema is the facet panel's input, not a visitor-facing table. */
+    readonly showFeatures?: boolean;
+}
+export declare function CategoryPage(props: CategoryPageProps): ReactElement;
+//# sourceMappingURL=CategoryPage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryPage.d.ts","sourceRoot":"","sources":["../../src/default/CategoryPage.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAShD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;kCAC8B;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,SAAS,CAAC;IAC5D;wEACoE;IACpE,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CA4DnE"}

package/dist/default/CategoryPage.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { Empty, Flex, Spin, Typography } from "antd";
+import { toFlowError, useDescribeFlowError, useT } from "@stapel/core";
+import { categoryLabel, renderCategoryLabel } from "../catalog/labels.js";
+import { CategoryTree } from "../headless/CategoryTree.js";
+import { CATEGORIES_I18N_KEYS } from "../i18n/keys.js";
+import { CategoryBreadcrumbsBar } from "./CategoryBreadcrumbsBar.js";
+import { CategoryFeatureList } from "./CategoryFeatureList.js";
+import { CategoryTreePane } from "./CategoryTreePane.js";
+import { ErrorAlert } from "./ErrorAlert.js";
+import { CategoriesSkinTheme } from "./theme.js";
+export function CategoryPage(props) {
+    const t = useT();
+    const describe = useDescribeFlowError();
+    const base = props.basePath ?? "/c";
+    return (_jsx(CategoriesSkinTheme, { ...(props.mode !== undefined ? { mode: props.mode } : {}), children: _jsx(CategoryTree, { slug: props.slug, children: (bag) => (_jsxs(Flex, { vertical: true, gap: 16, "data-testid": "categories-category-page", children: [_jsx(CategoryBreadcrumbsBar, { slug: props.slug, basePath: base }), bag.catalog.status === "loading" ? (_jsx(Flex, { justify: "center", style: { padding: 16 }, children: _jsx(Spin, { "data-testid": "categories-category-loading" }) })) : bag.catalog.status === "failed" ? (_jsx(ErrorAlert, { testId: "categories-category-failed", error: {
+                            ...describe(toFlowError(bag.catalog.error)),
+                            message: t(CATEGORIES_I18N_KEYS.catalogLoadFailed),
+                        } })) : bag.current === null ? (_jsx(Empty, { "data-testid": "categories-category-unknown", description: t(CATEGORIES_I18N_KEYS.categoryUnknownSlug) })) : (_jsxs(_Fragment, { children: [_jsx(Typography.Title, { level: 3, style: { margin: 0 }, children: renderCategoryLabel(categoryLabel(bag.current.category), t) }), bag.current.children.length > 0 ? (_jsx(CategoryTreePane, { slug: props.slug, basePath: base, titleKey: CATEGORIES_I18N_KEYS.categorySubcategories })) : null, props.showFeatures === true ? (_jsx(CategoryFeatureList, { categoryId: bag.current.id })) : null, props.renderListings?.(bag.current.category)] }))] })) }) }));
+}
+//# sourceMappingURL=CategoryPage.js.map

package/dist/default/CategoryPage.js.map

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

package/dist/default/CategoryPickerField.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `<CategoryPickerField>` — the compose form's category chooser.
+ *
+ * Drill down or search; either way the options come out of the tree that is
+ * already in memory, so typing does not issue a request per keystroke and the
+ * whole control works offline once the catalogue has synced.
+ *
+ * The blocked state carries its reason, always. `ActionAvailability`'s rule is
+ * that a disabled control must say why, and this control has two different
+ * whys — nothing chosen yet, versus a chosen category that still has
+ * sub-categories. The second one matters more than it looks: filing a listing
+ * under "Electronics" instead of "Electronics › Phones" inherits a different
+ * feature set, so the form then asks the wrong questions and the server
+ * refuses a field the person never saw.
+ */
+import type { ReactElement } from "react";
+import type { CategoryNode } from "../catalog/tree.js";
+import type { ThemeModeProp } from "./types.js";
+export interface CategoryPickerFieldProps extends ThemeModeProp {
+    readonly value?: number | null;
+    readonly onChange?: (id: number | null, node: CategoryNode | null) => void;
+    /** Only leaf categories are valid. Default `true`. */
+    readonly leavesOnly?: boolean;
+}
+export declare function CategoryPickerField(props: CategoryPickerFieldProps): ReactElement;
+//# sourceMappingURL=CategoryPickerField.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryPickerField.d.ts","sourceRoot":"","sources":["../../src/default/CategoryPickerField.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAI1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAOhD,MAAM,WAAW,wBAAyB,SAAQ,aAAa;IAC7D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,CAAC;IAC3E,sDAAsD;IACtD,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,wBAAwB,GAC9B,YAAY,CAmId"}

package/dist/default/CategoryPickerField.js

@@ -0,0 +1,40 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Alert, Breadcrumb, Button, Empty, Flex, Input, List, Spin } from "antd";
+import { matchList, toFlowError, useDescribeFlowError, useT } from "@stapel/core";
+import { categoryLabel, renderCategoryLabel } from "../catalog/labels.js";
+import { CategoryPicker } from "../headless/CategoryPicker.js";
+import { CATEGORIES_I18N_KEYS } from "../i18n/keys.js";
+import { ErrorAlert } from "./ErrorAlert.js";
+import { CategoriesSkinTheme } from "./theme.js";
+const BLOCKED_KEY = {
+    nothing_selected: CATEGORIES_I18N_KEYS.pickerBlockedNothingSelected,
+    not_a_leaf: CATEGORIES_I18N_KEYS.pickerBlockedNotALeaf,
+};
+export function CategoryPickerField(props) {
+    const t = useT();
+    const describe = useDescribeFlowError();
+    return (_jsx(CategoriesSkinTheme, { ...(props.mode !== undefined ? { mode: props.mode } : {}), children: _jsx(CategoryPicker, { ...(props.value !== undefined ? { value: props.value } : {}), ...(props.onChange !== undefined ? { onChange: props.onChange } : {}), ...(props.leavesOnly !== undefined
+                ? { leavesOnly: props.leavesOnly }
+                : {}), translate: t, children: (bag) => (_jsxs(Flex, { vertical: true, gap: 8, "data-testid": "categories-picker", children: [_jsx(Input, { allowClear: true, value: bag.query, placeholder: t(CATEGORIES_I18N_KEYS.pickerSearch), "aria-label": t(CATEGORIES_I18N_KEYS.pickerSearch), "data-testid": "categories-picker-search", onChange: (event) => {
+                            bag.setQuery(event.target.value);
+                        } }), bag.query === "" && bag.path.length > 0 ? (_jsxs(Flex, { align: "center", gap: 8, children: [_jsx(Button, { size: "small", "data-testid": "categories-picker-up", "data-analytics": "none", "data-analytics-reason": "walking the local tree is a read; nothing leaves the browser", onClick: bag.up, children: t(CATEGORIES_I18N_KEYS.pickerUp) }), _jsx(Breadcrumb, { items: bag.path.map((node) => ({
+                                    title: renderCategoryLabel(categoryLabel(node.category), t),
+                                })) })] })) : null, matchList(bag.state, {
+                        loading: () => (_jsx(Flex, { justify: "center", style: { padding: 16 }, children: _jsx(Spin, { "data-testid": "categories-picker-loading" }) })),
+                        failed: (error) => (_jsx(ErrorAlert, { testId: "categories-picker-failed", error: {
+                                ...describe(toFlowError(error)),
+                                message: t(CATEGORIES_I18N_KEYS.pickerLoadFailed),
+                            } })),
+                        empty: () => (_jsx(Empty, { "data-testid": "categories-picker-empty", description: t(bag.query === ""
+                                ? CATEGORIES_I18N_KEYS.categoryNoSubcategories
+                                : CATEGORIES_I18N_KEYS.pickerNoMatches) })),
+                        ready: (options) => (_jsx(List, { "data-testid": "categories-picker-list", size: "small", dataSource: [...options], renderItem: (option) => (_jsx(List.Item, { "data-category-id": option.node.id, children: _jsx(Button, { type: "link", "data-testid": `categories-picker-option-${String(option.node.id)}`, "data-analytics": "none", "data-analytics-reason": "drilling into the local tree is a read; the host tracks the SUBMIT that consumes the chosen category", onClick: () => {
+                                        bag.open(option.node);
+                                    }, children: renderCategoryLabel(option.label, t) }) }, option.node.id)) })),
+                    }), bag.submitBlockedReason !== null ? (_jsx(Alert, { type: "info", showIcon: true, "data-testid": "categories-picker-blocked", message: t(BLOCKED_KEY[bag.submitBlockedReason]) })) : (_jsx(Alert, { type: "success", showIcon: true, "data-testid": "categories-picker-selected", message: t(CATEGORIES_I18N_KEYS.pickerSelected, {
+                            category: bag.selected === null
+                                ? ""
+                                : renderCategoryLabel(categoryLabel(bag.selected.category), t),
+                        }) }))] })) }) }));
+}
+//# sourceMappingURL=CategoryPickerField.js.map

package/dist/default/CategoryPickerField.js.map

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

package/dist/default/CategoryTreePane.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `<CategoryTreePane>` — one level of the catalogue as a list of links.
+ *
+ * The four arms of `matchList` are the point of this file, not decoration:
+ * "still syncing", "the sync failed", "this category has no sub-categories"
+ * and "here they are" are four different sentences, and the third is the one a
+ * leaf category legitimately gets. Collapsing any two is the incident
+ * `@stapel/core`'s `loadState.ts` was written for.
+ *
+ * A fifth condition rides alongside them: `truncated`. The sync walk hit its
+ * page budget, so what is on screen is a PARTIAL catalogue — which is neither
+ * an empty one nor a failed one, and gets its own line rather than being
+ * silently indistinguishable from a complete tree.
+ */
+import type { ReactElement } from "react";
+import type { ThemeModeProp } from "./types.js";
+export interface CategoryTreePaneProps extends ThemeModeProp {
+    /** Render this category's children. Omitted renders the roots. */
+    readonly parentId?: number | null;
+    /** Render the children of the category at this slug (the `/c/:slug` page). */
+    readonly slug?: string;
+    /** Path prefix for a row's link. Default `/c`. */
+    readonly basePath?: string;
+    /** Heading above the list. Omitted renders no heading. */
+    readonly titleKey?: string;
+}
+export declare function CategoryTreePane(props: CategoryTreePaneProps): ReactElement;
+//# sourceMappingURL=CategoryTreePane.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryTreePane.d.ts","sourceRoot":"","sources":["../../src/default/CategoryTreePane.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAS1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,YAAY,CAiG3E"}

package/dist/default/CategoryTreePane.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Alert, Badge, Empty, Flex, List, Spin, Typography } from "antd";
+import { matchList, toFlowError, useDescribeFlowError, useT } from "@stapel/core";
+import { categoryLabel, renderCategoryLabel } from "../catalog/labels.js";
+import { CategoryTree } from "../headless/CategoryTree.js";
+import { CATEGORIES_I18N_KEYS } from "../i18n/keys.js";
+import { ErrorAlert } from "./ErrorAlert.js";
+import { CategoriesSkinTheme } from "./theme.js";
+export function CategoryTreePane(props) {
+    const t = useT();
+    const describe = useDescribeFlowError();
+    const base = props.basePath ?? "/c";
+    return (_jsx(CategoriesSkinTheme, { ...(props.mode !== undefined ? { mode: props.mode } : {}), children: _jsx(CategoryTree, { ...(props.parentId !== undefined ? { parentId: props.parentId } : {}), ...(props.slug !== undefined ? { slug: props.slug } : {}), children: (bag) => (_jsxs(Flex, { vertical: true, gap: 8, "data-testid": "categories-tree", children: [props.titleKey !== undefined ? (_jsx(Typography.Title, { level: 5, style: { margin: 0 }, children: t(props.titleKey) })) : null, bag.truncated ? (_jsx(Alert, { type: "warning", showIcon: true, "data-testid": "categories-tree-truncated", message: t(CATEGORIES_I18N_KEYS.catalogTruncated) })) : null, matchList(bag.state, {
+                        loading: () => (_jsx(Flex, { justify: "center", style: { padding: 16 }, children: _jsx(Spin, { "data-testid": "categories-tree-loading" }) })),
+                        failed: (error) => (_jsx(ErrorAlert, { testId: "categories-tree-failed", error: {
+                                ...describe(toFlowError(error)),
+                                message: t(CATEGORIES_I18N_KEYS.catalogLoadFailed),
+                            } })),
+                        empty: () => (_jsx(Empty, { "data-testid": "categories-tree-empty", description: t(bag.current === null
+                                ? CATEGORIES_I18N_KEYS.catalogEmpty
+                                : CATEGORIES_I18N_KEYS.categoryNoSubcategories) })),
+                        ready: (nodes) => (_jsx(List, { "data-testid": "categories-tree-list", size: "small", dataSource: [...nodes], renderItem: (node) => (_jsx(List.Item, { "data-category-id": node.id, children: _jsxs(Flex, { justify: "space-between", align: "center", gap: 8, style: { width: "100%" }, children: [_jsx(Typography.Link, { href: `${base}/${node.category.slug}`, "data-category-slug": node.category.slug, children: renderCategoryLabel(categoryLabel(node.category), t) }), node.children.length > 0 ? (_jsx(Badge, { count: node.children.length, color: "blue", title: t(CATEGORIES_I18N_KEYS.categorySubcategories) })) : null] }) }, node.id)) })),
+                    })] })) }) }));
+}
+//# sourceMappingURL=CategoryTreePane.js.map

package/dist/default/CategoryTreePane.js.map

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

package/dist/default/ErrorAlert.d.ts

@@ -0,0 +1,9 @@
+import type { CSSProperties, ReactElement, ReactNode } from "react";
+import type { FlowErrorDisplay } from "@stapel/core";
+export declare function ErrorAlert(props: {
+    error: FlowErrorDisplay | undefined;
+    style?: CSSProperties | undefined;
+    testId?: string | undefined;
+    action?: ReactNode;
+}): ReactElement | null;
+//# sourceMappingURL=ErrorAlert.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorAlert.d.ts","sourceRoot":"","sources":["../../src/default/ErrorAlert.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAChC,KAAK,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACpC,KAAK,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB,GAAG,YAAY,GAAG,IAAI,CAsBtB"}

package/dist/default/ErrorAlert.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * The one error surface this pair's default skin renders, so the split copy
+ * core produces reaches a screen the same way everywhere (mirrors the
+ * docs/notifications/workspaces etalon).
+ *
+ * Core's `describeFlowError` splits a failure into the sentence a person
+ * reads and the technical detail a support agent quotes (owner report
+ * 2026-08-09: the status used to be spliced into the sentence, ending in a
+ * bare `" (500)"`). The split only helps if a skin renders both halves at
+ * their own weights: `message` at normal weight, `detail` muted and small.
+ *
+ * `undefined` in — including a `detail` core left `undefined` because there
+ * was nothing worth quoting — renders nothing rather than an empty line.
+ */
+import { Alert, Typography } from "antd";
+export function ErrorAlert(props) {
+    const { error } = props;
+    if (!error)
+        return null;
+    return (_jsx(Alert, { type: "error", showIcon: true, ...(props.style ? { style: props.style } : {}), ...(props.testId ? { "data-testid": props.testId } : {}), ...(props.action ? { action: props.action } : {}), message: error.message, ...(error.detail
+            ? {
+                description: (_jsx(Typography.Text, { type: "secondary", style: { fontSize: 12 }, children: error.detail })),
+            }
+            : {}) }));
+}
+//# sourceMappingURL=ErrorAlert.js.map

package/dist/default/ErrorAlert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorAlert.js","sourceRoot":"","sources":["../../src/default/ErrorAlert.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAIzC,MAAM,UAAU,UAAU,CAAC,KAK1B;IACC,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IACxB,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,CACL,KAAC,KAAK,IACJ,IAAI,EAAC,OAAO,EACZ,QAAQ,WACJ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAC3C,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KACrD,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAClD,OAAO,EAAE,KAAK,CAAC,OAAO,KAClB,CAAC,KAAK,CAAC,MAAM;YACf,CAAC,CAAC;gBACE,WAAW,EAAE,CACX,KAAC,UAAU,CAAC,IAAI,IAAC,IAAI,EAAC,WAAW,EAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,YACtD,KAAK,CAAC,MAAM,GACG,CACnB;aACF;YACH,CAAC,CAAC,EAAE,CAAC,GACP,CACH,CAAC;AACJ,CAAC"}

package/dist/default/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * `@stapel/categories-react/default` — the antd skin over the headless pair.
+ *
+ * A separate entry point (the convention every pair's `/default` follows) so a
+ * host rendering its own catalogue chrome never pulls `antd` into its bundle.
+ * The main entry has no visual opinion at all and no import path from it
+ * reaches this directory — size-limit and the bundle-purity test are the
+ * teeth on that.
+ *
+ * ```tsx
+ * import { createCategoriesRuntime, CategoriesProvider } from "@stapel/categories-react";
+ * import { CatalogPage, CategoryPage } from "@stapel/categories-react/default";
+ * ```
+ *
+ * `CategoryPage` takes `renderListings` — the half of `/c/:slug` that belongs
+ * to `@stapel/search-react`, handed in by the container rather than imported
+ * across the L2 layer.
+ */
+export { CatalogPage } from "./CatalogPage.js";
+export type { CatalogPageProps } from "./CatalogPage.js";
+export { CategoryPage } from "./CategoryPage.js";
+export type { CategoryPageProps } from "./CategoryPage.js";
+export { CategoryTreePane } from "./CategoryTreePane.js";
+export type { CategoryTreePaneProps } from "./CategoryTreePane.js";
+export { CategoryBreadcrumbsBar } from "./CategoryBreadcrumbsBar.js";
+export type { CategoryBreadcrumbsBarProps } from "./CategoryBreadcrumbsBar.js";
+export { CategoryCarouselStrip } from "./CategoryCarouselStrip.js";
+export type { CategoryCarouselStripProps } from "./CategoryCarouselStrip.js";
+export { CategoryPickerField } from "./CategoryPickerField.js";
+export type { CategoryPickerFieldProps } from "./CategoryPickerField.js";
+export { CategoryFeatureList } from "./CategoryFeatureList.js";
+export type { CategoryFeatureListProps } from "./CategoryFeatureList.js";
+export { CategoriesSkinTheme } from "./theme.js";
+export type { CategoriesSkinThemeProps } from "./theme.js";
+export { ErrorAlert } from "./ErrorAlert.js";
+export type { ThemeModeProp } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/default/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,YAAY,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/default/index.js

@@ -0,0 +1,28 @@
+/**
+ * `@stapel/categories-react/default` — the antd skin over the headless pair.
+ *
+ * A separate entry point (the convention every pair's `/default` follows) so a
+ * host rendering its own catalogue chrome never pulls `antd` into its bundle.
+ * The main entry has no visual opinion at all and no import path from it
+ * reaches this directory — size-limit and the bundle-purity test are the
+ * teeth on that.
+ *
+ * ```tsx
+ * import { createCategoriesRuntime, CategoriesProvider } from "@stapel/categories-react";
+ * import { CatalogPage, CategoryPage } from "@stapel/categories-react/default";
+ * ```
+ *
+ * `CategoryPage` takes `renderListings` — the half of `/c/:slug` that belongs
+ * to `@stapel/search-react`, handed in by the container rather than imported
+ * across the L2 layer.
+ */
+export { CatalogPage } from "./CatalogPage.js";
+export { CategoryPage } from "./CategoryPage.js";
+export { CategoryTreePane } from "./CategoryTreePane.js";
+export { CategoryBreadcrumbsBar } from "./CategoryBreadcrumbsBar.js";
+export { CategoryCarouselStrip } from "./CategoryCarouselStrip.js";
+export { CategoryPickerField } from "./CategoryPickerField.js";
+export { CategoryFeatureList } from "./CategoryFeatureList.js";
+export { CategoriesSkinTheme } from "./theme.js";
+export { ErrorAlert } from "./ErrorAlert.js";
+//# sourceMappingURL=index.js.map

package/dist/default/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/default/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/default/theme.d.ts

@@ -0,0 +1,25 @@
+import type { CSSProperties, ReactElement, ReactNode } from "react";
+import type { ThemeMode } from "@stapel/tokens-antd";
+export interface CategoriesSkinThemeProps {
+    /**
+     * Light or dark. Defaults to the mode the host's document declares
+     * (`resolveThemeMode()`). Pass explicitly to pin a side.
+     */
+    readonly mode?: ThemeMode;
+    /** Extra styles merged onto the themed root element (layout only — colors
+     * come from the mode). */
+    readonly style?: CSSProperties;
+    readonly children: ReactNode;
+}
+/**
+ * `<CategoriesSkinTheme/>` — the self-theming wrapper of
+ * `@stapel/categories-react/default`. Standalone use is supported (wrap any
+ * composition of the skin's parts once); the shipped surfaces
+ * (`CatalogPage`, `CategoryPage`, `CategoryTreePane`, `CategoryCarouselStrip`,
+ * `CategoryPickerField`, `CategoryFeatureList`, `CategoryBreadcrumbsBar`)
+ * each already wrap themselves, and nested antd
+ * `ConfigProvider`s merge, so composing them under one `CategoriesSkinTheme`
+ * stays correct.
+ */
+export declare function CategoriesSkinTheme(props: CategoriesSkinThemeProps): ReactElement;
+//# sourceMappingURL=theme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/default/theme.tsx"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAOpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAC1B;8BAC0B;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,YAAY,CAmBjF"}

package/dist/default/theme.js

@@ -0,0 +1,40 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * The default skin's INTERNAL theme provider — every `/default` surface wraps
+ * itself in this, so the skin is readable no matter what the host supplies
+ * (tracker #26: a skin set with no internal provider once inherited a theme
+ * bridge serving light-mode values inside a dark document — text on
+ * background at 1.00:1). The theme derives from `@stapel/tokens` via
+ * `@stapel/tokens-antd`'s `toAntdThemeConfig(mode)`; `mode` defaults to what
+ * the HOST's document declares (`resolveThemeMode()` — the `data-theme`
+ * attribute `tokens.css` keys its dark block on), never to a hardcoded side.
+ *
+ * This is also what "override styles" means for this pair: a storefront
+ * retheming through the §68 token JSON regenerates its `--stapel-*` custom
+ * properties and the result page follows with zero code — a far better deal
+ * than a prop-per-colour API, and the reason the skin has none.
+ */
+import { useMemo } from "react";
+import { ConfigProvider } from "antd";
+import { resolveThemeMode, toAntdTheme, toAntdThemeConfig, } from "@stapel/tokens-antd";
+/**
+ * `<CategoriesSkinTheme/>` — the self-theming wrapper of
+ * `@stapel/categories-react/default`. Standalone use is supported (wrap any
+ * composition of the skin's parts once); the shipped surfaces
+ * (`CatalogPage`, `CategoryPage`, `CategoryTreePane`, `CategoryCarouselStrip`,
+ * `CategoryPickerField`, `CategoryFeatureList`, `CategoryBreadcrumbsBar`)
+ * each already wrap themselves, and nested antd
+ * `ConfigProvider`s merge, so composing them under one `CategoriesSkinTheme`
+ * stays correct.
+ */
+export function CategoriesSkinTheme(props) {
+    const mode = props.mode ?? resolveThemeMode();
+    const theme = useMemo(() => toAntdThemeConfig(mode), [mode]);
+    const token = useMemo(() => toAntdTheme(mode), [mode]);
+    return (_jsx(ConfigProvider, { theme: theme, children: _jsx("div", { "data-categories-skin-root": true, "data-categories-skin-mode": mode, style: {
+                color: token.colorText,
+                backgroundColor: token.colorBgContainer,
+                ...props.style,
+            }, children: props.children }) }));
+}
+//# sourceMappingURL=theme.js.map

package/dist/default/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/default/theme.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AACtC,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAe7B;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAA+B;IACjE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,gBAAgB,EAAE,CAAC;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACvD,OAAO,CACL,KAAC,cAAc,IAAC,KAAK,EAAE,KAAK,YAC1B,8EAE6B,IAAI,EAC/B,KAAK,EAAE;gBACL,KAAK,EAAE,KAAK,CAAC,SAAS;gBACtB,eAAe,EAAE,KAAK,CAAC,gBAAgB;gBACvC,GAAG,KAAK,CAAC,KAAK;aACf,YAEA,KAAK,CAAC,QAAQ,GACX,GACS,CAClB,CAAC;AACJ,CAAC"}

package/dist/default/types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Small shared types for the `/default` skin — kept in one place so every
+ * surface takes the same `mode` prop and re-exports the same error dialect.
+ */
+export type { FlowError } from "@stapel/core";
+import type { ThemeMode } from "@stapel/tokens-antd";
+/** Every `/default` surface accepts a theme mode; absent means "whatever the
+ * host document declares" (`resolveThemeMode()`), never a hardcoded side. */
+export interface ThemeModeProp {
+    readonly mode?: ThemeMode;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/default/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD;6EAC6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;CAC3B"}

package/dist/default/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/default/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/default/types.ts"],"names":[],"mappings":""}

package/dist/headless/CategoriesProvider.d.ts

@@ -0,0 +1,19 @@
+import type { ReactElement, ReactNode } from "react";
+import type { CategoriesRuntime } from "../model/runtime.js";
+/**
+ * Provides the wired {@link CategoriesRuntime} to every categories hook and
+ * headless component below it. Bring your own visual shell — this component
+ * renders nothing of its own. (Core's `createModuleContext` provider, bound to
+ * this pair — slim wave §21/S2.)
+ *
+ * ```tsx
+ * const runtime = createCategoriesRuntime({ baseUrl: "/categories/api/v1/" });
+ * // give runtime.client to core's <StapelConfigProvider config={{ client }}>
+ * <CategoriesProvider runtime={runtime}>{app}</CategoriesProvider>
+ * ```
+ */
+export declare const CategoriesProvider: (props: {
+    runtime: CategoriesRuntime;
+    children: ReactNode;
+}) => ReactElement;
+//# sourceMappingURL=CategoriesProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CategoriesProvider.d.ts","sourceRoot":"","sources":["../../src/headless/CategoriesProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,EAAE,CAAC,KAAK,EAAE;IACvC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,EAAE,SAAS,CAAC;CACrB,KAAK,YAA6B,CAAC"}

package/dist/headless/CategoriesProvider.js

@@ -0,0 +1,15 @@
+import { ModuleProvider } from "../model/context.js";
+/**
+ * Provides the wired {@link CategoriesRuntime} to every categories hook and
+ * headless component below it. Bring your own visual shell — this component
+ * renders nothing of its own. (Core's `createModuleContext` provider, bound to
+ * this pair — slim wave §21/S2.)
+ *
+ * ```tsx
+ * const runtime = createCategoriesRuntime({ baseUrl: "/categories/api/v1/" });
+ * // give runtime.client to core's <StapelConfigProvider config={{ client }}>
+ * <CategoriesProvider runtime={runtime}>{app}</CategoriesProvider>
+ * ```
+ */
+export const CategoriesProvider = ModuleProvider;
+//# sourceMappingURL=CategoriesProvider.js.map

package/dist/headless/CategoriesProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CategoriesProvider.js","sourceRoot":"","sources":["../../src/headless/CategoriesProvider.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAGV,cAAc,CAAC"}

package/dist/headless/CategoryBreadcrumbs.d.ts

@@ -0,0 +1,40 @@
+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 crumb: the node, and how its caption must be rendered. */
+export interface CategoryCrumb {
+    readonly node: CategoryNode;
+    /** `kind: "key"` → run `value` through the host's `t`. See
+     * `catalog/labels.ts` — names on the wire are translation keys. */
+    readonly label: CategoryLabel;
+    /** `true` for the last crumb — the page you are on. */
+    readonly isCurrent: boolean;
+}
+export interface CategoryBreadcrumbsBag {
+    /**
+     * Root → current, inclusive. `empty` means the selected category IS a root
+     * (there is nothing above it), which is a different thing from a catalogue
+     * that has not loaded and from a slug that does not exist.
+     */
+    readonly state: LoadState<readonly CategoryCrumb[]>;
+    readonly unknownSlug: boolean;
+    refetch(): void;
+}
+export interface CategoryBreadcrumbsProps extends UseCategoryCatalogOptions {
+    slug?: string;
+    categoryId?: number | null;
+    children: (bag: CategoryBreadcrumbsBag) => ReactNode;
+}
+/**
+ * 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 declare function CategoryBreadcrumbs(props: CategoryBreadcrumbsProps): ReactNode;
+//# sourceMappingURL=CategoryBreadcrumbs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryBreadcrumbs.d.ts","sourceRoot":"","sources":["../../src/headless/CategoryBreadcrumbs.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,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAErE,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B;uEACmE;IACnE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,uDAAuD;IACvD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,SAAS,aAAa,EAAE,CAAC,CAAC;IACpD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,wBAAyB,SAAQ,yBAAyB;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,CAAC,GAAG,EAAE,sBAAsB,KAAK,SAAS,CAAC;CACtD;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,wBAAwB,GAC9B,SAAS,CA6BX"}