@stapel/categories-react 0.1.0

package/dist/i18n/ru.js

@@ -0,0 +1,90 @@
+import { categoriesErrorBundleRu } from "./generated/errors.ru.gen.js";
+export { categoriesErrorBundleRu } from "./generated/errors.ru.gen.js";
+/**
+ * Russian bundle for categories-react — the `@stapel/categories-react/i18n/ru`
+ * subpath (i18n-shipping.md §2) so the locale is opt-in: hosts that do not
+ * register it never carry these strings (the main entry does not import this
+ * module — gated by size-limit + the bundle-purity test).
+ *
+ * This is the storefront's DEFAULT language (darom-storefront verdict F1:
+ * ru-first).
+ *
+ * ── What comes from where ──────────────────────────────────────────────────
+ *
+ * `stapel-categories` ships **no `translations/` directory at all**, so 20 of
+ * the 62 registry codes can never come from an upstream catalogue. They split
+ * by owner, and the split is the whole point:
+ *
+ *  - the 42 cross-cutting `stapel_core` codes are GENERATED, merged in from
+ *    stapel-core's own catalogue by `pnpm gen:errors` (spread first below);
+ *  - the **8 `stapel_categories` codes** are authored here — and when upstream
+ *    ships a catalogue, eight lines are deleted and no key or text moves;
+ *  - the **12 `stapel_attributes` codes** are NOT here. They belong to
+ *    `@stapel/attributes-react`, which already translates them and which is a
+ *    peer of this pair anyway. Two pairs must not give one refusal two
+ *    sentences (§13.2 note 3). A host registers both bundles;
+ *    `test/i18n.test.ts` proves the union covers the registry.
+ *
+ * PROVENANCE, stated rather than implied: the core catalogue ships
+ * `origin=seed:authored` and is UNREVIEWED; the pair-authored strings below
+ * are the same grade. Neither is a claim of review.
+ *
+ * And once more, because it is the fact this pair exists to be honest about:
+ * **no category name is translated here.** Category and feature names arrive
+ * as translation KEYS (`catalog/labels.ts`) and belong in the deployment's own
+ * bundle, not in a library's.
+ */
+export const categoriesI18nBundleRu = {
+    ...categoriesErrorBundleRu,
+    // ── the 8 stapel_categories-owned codes, pair-authored ───────────────────
+    "error.400.categories_config_required": "Требуется объект config.",
+    "error.400.categories_database_error": "Ошибка базы данных при сохранении изменений.",
+    "error.400.categories_duplicate_slug": "Характеристика со слагом «{slug}» уже существует.",
+    "error.400.categories_expected_list": "Ожидался список объектов.",
+    "error.400.categories_feature_editor_invalid": "Некорректный запрос редактора характеристик: {reason}",
+    "error.400.categories_invalid_conversion": "Недопустимое преобразование типа (поддерживается только select ↔ string).",
+    "error.400.categories_not_deleted": "Категория не удалена.",
+    "error.409.categories_feature_editor_conflict": "Категорию изменил другой редактор (ожидалась ревизия {expected}, сейчас {actual}); перезагрузите страницу и повторите.",
+    "categories.error.unknown": "Что-то пошло не так с каталогом.",
+    "categories.catalog.title": "Каталог",
+    "categories.catalog.loading": "Загружаем каталог…",
+    "categories.catalog.load_failed": "Не удалось загрузить каталог.",
+    "categories.catalog.empty": "В каталоге пока нет категорий.",
+    "categories.catalog.retry": "Повторить",
+    "categories.catalog.truncated": "Каталог загружен не полностью. Категории, которой здесь нет, ещё не прочитали — её не удаляли.",
+    "categories.catalog.refreshing": "Проверяем изменения в каталоге…",
+    "categories.catalog.as_of": "Каталог на ревизию {revision}",
+    "categories.category.title": "Категория",
+    "categories.category.unknown_slug": "По этому адресу нет категории.",
+    "categories.category.subcategories": "Подкатегории",
+    "categories.category.no_subcategories": "У этой категории нет подкатегорий.",
+    "categories.category.open": "Открыть",
+    "categories.breadcrumbs.root": "Все категории",
+    "categories.breadcrumbs.label": "Вы здесь",
+    "categories.carousel.title": "Категории",
+    "categories.carousel.loading": "Загружаем категории…",
+    "categories.carousel.load_failed": "Не удалось загрузить категории.",
+    "categories.carousel.empty": "Сейчас ни одна категория не вынесена на витрину.",
+    "categories.picker.title": "Категория",
+    "categories.picker.search": "Поиск по категориям",
+    "categories.picker.loading": "Загружаем категории…",
+    "categories.picker.load_failed": "Не удалось загрузить категории.",
+    "categories.picker.no_matches": "Ни одна категория не подходит.",
+    "categories.picker.up": "На уровень выше",
+    "categories.picker.selected": "Выбрано: {category}",
+    "categories.picker.blocked.nothing_selected": "Сначала выберите категорию.",
+    "categories.picker.blocked.not_a_leaf": "Выберите категорию точнее — у этой есть подкатегории, а от них зависит, какие характеристики спросят.",
+    "categories.features.title": "Характеристики в этой категории",
+    "categories.features.loading": "Загружаем характеристики…",
+    "categories.features.load_failed": "Не удалось загрузить характеристики.",
+    "categories.features.empty": "В этой категории не нужно заполнять дополнительные характеристики.",
+    "categories.features.mandatory": "Обязательно",
+    "categories.features.type": "{type}",
+    "categories.features.untyped": "У этой характеристики нет типа, показать её нельзя.",
+};
+/** Register the `ru` bundle. Call AFTER `registerCategoriesI18n` so it
+ * overrides the English floor. */
+export function registerCategoriesI18nRu(engine, locale = "ru") {
+    engine.registerBundle(locale, categoriesI18nBundleRu);
+}
+//# sourceMappingURL=ru.js.map

package/dist/i18n/ru.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ru.js","sourceRoot":"","sources":["../../src/i18n/ru.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAmB;IACpD,GAAG,uBAAuB;IAE1B,4EAA4E;IAC5E,sCAAsC,EAAE,0BAA0B;IAClE,qCAAqC,EACnC,8CAA8C;IAChD,qCAAqC,EACnC,mDAAmD;IACrD,oCAAoC,EAAE,2BAA2B;IACjE,6CAA6C,EAC3C,uDAAuD;IACzD,yCAAyC,EACvC,2EAA2E;IAC7E,kCAAkC,EAAE,uBAAuB;IAC3D,8CAA8C,EAC5C,wHAAwH;IAE1H,0BAA0B,EAAE,kCAAkC;IAE9D,0BAA0B,EAAE,SAAS;IACrC,4BAA4B,EAAE,oBAAoB;IAClD,gCAAgC,EAAE,+BAA+B;IACjE,0BAA0B,EAAE,gCAAgC;IAC5D,0BAA0B,EAAE,WAAW;IACvC,8BAA8B,EAC5B,gGAAgG;IAClG,+BAA+B,EAAE,iCAAiC;IAClE,0BAA0B,EAAE,+BAA+B;IAE3D,2BAA2B,EAAE,WAAW;IACxC,kCAAkC,EAAE,gCAAgC;IACpE,mCAAmC,EAAE,cAAc;IACnD,sCAAsC,EAAE,oCAAoC;IAC5E,0BAA0B,EAAE,SAAS;IAErC,6BAA6B,EAAE,eAAe;IAC9C,8BAA8B,EAAE,UAAU;IAE1C,2BAA2B,EAAE,WAAW;IACxC,6BAA6B,EAAE,sBAAsB;IACrD,iCAAiC,EAAE,iCAAiC;IACpE,2BAA2B,EAAE,kDAAkD;IAE/E,yBAAyB,EAAE,WAAW;IACtC,0BAA0B,EAAE,qBAAqB;IACjD,2BAA2B,EAAE,sBAAsB;IACnD,+BAA+B,EAAE,iCAAiC;IAClE,8BAA8B,EAAE,gCAAgC;IAChE,sBAAsB,EAAE,iBAAiB;IACzC,4BAA4B,EAAE,qBAAqB;IACnD,4CAA4C,EAAE,6BAA6B;IAC3E,sCAAsC,EACpC,uGAAuG;IAEzG,2BAA2B,EAAE,iCAAiC;IAC9D,6BAA6B,EAAE,2BAA2B;IAC1D,iCAAiC,EAAE,sCAAsC;IACzE,2BAA2B,EACzB,oEAAoE;IACtE,+BAA+B,EAAE,aAAa;IAC9C,0BAA0B,EAAE,QAAQ;IACpC,6BAA6B,EAC3B,qDAAqD;CACxD,CAAC;AAEF;kCACkC;AAClC,MAAM,UAAU,wBAAwB,CAAC,MAAkB,EAAE,MAAM,GAAG,IAAI;IACxE,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;AACxD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,88 @@
+/**
+ * `@stapel/categories-react` — the headless React pair for stapel-categories
+ * (frontend-standard §2). Business + state only, zero visual opinion; the antd
+ * skin lives behind the `./default` subpath, so a host that renders its own
+ * catalogue chrome never carries it.
+ *
+ * ── The one-liner ──────────────────────────────────────────────────────────
+ *
+ * ```tsx
+ * const runtime = createCategoriesRuntime({ baseUrl: "/categories/api/v1/" });
+ * <CategoriesProvider runtime={runtime}>
+ *   <CatalogPage />          // or <CategoryPage slug={slug} renderListings={…} />
+ * </CategoriesProvider>
+ * ```
+ *
+ * No session, no workspace id, no auth client: every endpoint this pair calls
+ * is a SAFE method under `ReadOnlyOrStaff`, so a catalogue renders for a
+ * visitor who will never sign in.
+ *
+ * ── The four properties this pair exists to guarantee ──────────────────────
+ *
+ * 1. **The client builds the tree, because the server has none.**
+ *    `GET /categories/` returns FLAT rows ordered by `revision`, with treenode
+ *    ancestry as COMMA-JOINED pk strings (`"1,7,12"`, `""` for a root).
+ *    `catalog/tree.ts` parses and assembles; `catalog/pks.ts` is the parser,
+ *    and it exists because the spec described those columns as arrays.
+ * 2. **The catalogue is synced by delta, not refetched.** A stored snapshot
+ *    (`createRepository`, `scope: "app"`) plus `?min_revision=` is the module's
+ *    own documented protocol; without it every storefront page pulls the whole
+ *    catalogue. Two things the documentation does not say are implemented
+ *    anyway and explained where they live: `revisions.deleted_ids` is the
+ *    complete tombstone channel (the `deleted: true` rows are paginated and a
+ *    short walk misses them), and a multi-page walk must pin `max_revision` or
+ *    a concurrent write shifts its page boundaries.
+ * 3. **A slug is resolved by the client, because the server cannot.**
+ *    `lookup_field` is never overridden and the list endpoint has no slug
+ *    filter, so `/c/:slug` resolves against the synced tree. That is a second,
+ *    independent reason the tree is cached.
+ * 4. **Names are translation KEYS, and this pair says so.** No serializer runs
+ *    the module's `DISPLAY_TRANSLATOR` seam, so `name` arrives as
+ *    `category.electronics` even on a deployment with a real translator
+ *    configured, and `translatable` / `translate` say per row whether a string
+ *    is a key at all. `catalog/labels.ts` carries the whole answer, and the
+ *    pair ships no catalogue of category names — those belong to the host.
+ *
+ * Layers: api → catalog (pure) → model → headless → i18n. Generated surfaces
+ * (the typed schema, the error map, the manifest, the nav manifest, llms.txt)
+ * are produced by the monorepo `gen:*` drivers from stapel-categories' own
+ * `docs/` artifacts and stand under drift gates.
+ */
+export { categoryListParams, createCategoriesApi } from "./api/categoriesApi.js";
+export type { CategoriesApi } from "./api/categoriesApi.js";
+export type { Category, CategoryFeature, CategoryListParams, CategoryPage as CategoryListPage, CategoryRevisions, FeatureConfig, MaxRevision, Schemas, } from "./api/types.js";
+export { parseTreenodePks } from "./catalog/pks.js";
+export { buildCategoryTree, categoryAncestorIds, categoryBreadcrumbs, categoryChildIds, flattenCategoryNodes, resolveCategorySlug, } from "./catalog/tree.js";
+export type { BuildCategoryTreeOptions, CategoryIndex, CategoryNode, } from "./catalog/tree.js";
+export { EMPTY_SNAPSHOT, applyCategoryPage, firstPageRequest, isEmptySnapshot, nextPageRequest, parseSnapshot, } from "./catalog/sync.js";
+export type { CategorySnapshot } from "./catalog/sync.js";
+export { categoryLabel, featureLabel, featureOptionsAreKeys, renderCategoryLabel, } from "./catalog/labels.js";
+export type { CategoryLabel, CategoryLabelKind } from "./catalog/labels.js";
+export { createCategoriesRuntime } from "./model/runtime.js";
+export type { CategoriesRuntime, CreateCategoriesRuntimeOptions, } from "./model/runtime.js";
+export { CategoriesRuntimeContext, useCategoriesAnalytics, useCategoriesApi, useCategoriesRuntime, } from "./model/context.js";
+export { CATALOG_KEY, CATALOG_NAMESPACE, createCatalogStore, memoryCatalogStore, } from "./model/catalogStore.js";
+export type { CatalogStore, CreateCatalogStoreOptions, } from "./model/catalogStore.js";
+export { MAX_SYNC_PAGES, syncCatalog } from "./model/catalogSync.js";
+export type { SyncCatalogOptions, SyncCatalogResult } from "./model/catalogSync.js";
+export { catalogKeyOptions, categoriesQueryKeys } from "./model/queryKeys.js";
+export type { CatalogKeyOptions } from "./model/queryKeys.js";
+export { useCategoriesRevision, useCategoryCarousel, useCategoryCatalog, useCategoryChildren, useCategoryFeatures, } from "./model/queries.js";
+export type { CategoryCatalog, UseCategoryCatalogOptions, } from "./model/queries.js";
+export { CategoriesProvider } from "./headless/CategoriesProvider.js";
+export { CategoryTree } from "./headless/CategoryTree.js";
+export type { CategoryTreeBag, CategoryTreeProps } from "./headless/CategoryTree.js";
+export { CategoryBreadcrumbs } from "./headless/CategoryBreadcrumbs.js";
+export type { CategoryBreadcrumbsBag, CategoryBreadcrumbsProps, CategoryCrumb, } from "./headless/CategoryBreadcrumbs.js";
+export { CategoryCarousel } from "./headless/CategoryCarousel.js";
+export type { CarouselEntry, CategoryCarouselBag, CategoryCarouselProps, } from "./headless/CategoryCarousel.js";
+export { CategoryPicker } from "./headless/CategoryPicker.js";
+export type { CategoryOption, CategoryPickerBag, CategoryPickerBlockedReason, CategoryPickerProps, } from "./headless/CategoryPicker.js";
+export { CategoryFeatures } from "./headless/CategoryFeatures.js";
+export type { CategoryFeatureEntry, CategoryFeaturesBag, CategoryFeaturesProps, } from "./headless/CategoryFeatures.js";
+export { navEntries } from "./nav/manifest.js";
+export { CATEGORIES_I18N_KEYS, categoriesI18nBundleEn, registerCategoriesI18n, } from "./i18n/keys.js";
+export type { CategoriesI18nKey } from "./i18n/keys.js";
+export { CATEGORIES_ERRORS, CATEGORIES_ERROR_CODES, CATEGORIES_FEATURE_EDITOR_CONFLICT, categoriesErrorBundleEn, explainCategoriesError, } from "./i18n/errorsMap.js";
+export type { CategoriesErrorCode, CategoriesErrorSpec, Remediation, } from "./i18n/errorsMap.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,78 @@
+/**
+ * `@stapel/categories-react` — the headless React pair for stapel-categories
+ * (frontend-standard §2). Business + state only, zero visual opinion; the antd
+ * skin lives behind the `./default` subpath, so a host that renders its own
+ * catalogue chrome never carries it.
+ *
+ * ── The one-liner ──────────────────────────────────────────────────────────
+ *
+ * ```tsx
+ * const runtime = createCategoriesRuntime({ baseUrl: "/categories/api/v1/" });
+ * <CategoriesProvider runtime={runtime}>
+ *   <CatalogPage />          // or <CategoryPage slug={slug} renderListings={…} />
+ * </CategoriesProvider>
+ * ```
+ *
+ * No session, no workspace id, no auth client: every endpoint this pair calls
+ * is a SAFE method under `ReadOnlyOrStaff`, so a catalogue renders for a
+ * visitor who will never sign in.
+ *
+ * ── The four properties this pair exists to guarantee ──────────────────────
+ *
+ * 1. **The client builds the tree, because the server has none.**
+ *    `GET /categories/` returns FLAT rows ordered by `revision`, with treenode
+ *    ancestry as COMMA-JOINED pk strings (`"1,7,12"`, `""` for a root).
+ *    `catalog/tree.ts` parses and assembles; `catalog/pks.ts` is the parser,
+ *    and it exists because the spec described those columns as arrays.
+ * 2. **The catalogue is synced by delta, not refetched.** A stored snapshot
+ *    (`createRepository`, `scope: "app"`) plus `?min_revision=` is the module's
+ *    own documented protocol; without it every storefront page pulls the whole
+ *    catalogue. Two things the documentation does not say are implemented
+ *    anyway and explained where they live: `revisions.deleted_ids` is the
+ *    complete tombstone channel (the `deleted: true` rows are paginated and a
+ *    short walk misses them), and a multi-page walk must pin `max_revision` or
+ *    a concurrent write shifts its page boundaries.
+ * 3. **A slug is resolved by the client, because the server cannot.**
+ *    `lookup_field` is never overridden and the list endpoint has no slug
+ *    filter, so `/c/:slug` resolves against the synced tree. That is a second,
+ *    independent reason the tree is cached.
+ * 4. **Names are translation KEYS, and this pair says so.** No serializer runs
+ *    the module's `DISPLAY_TRANSLATOR` seam, so `name` arrives as
+ *    `category.electronics` even on a deployment with a real translator
+ *    configured, and `translatable` / `translate` say per row whether a string
+ *    is a key at all. `catalog/labels.ts` carries the whole answer, and the
+ *    pair ships no catalogue of category names — those belong to the host.
+ *
+ * Layers: api → catalog (pure) → model → headless → i18n. Generated surfaces
+ * (the typed schema, the error map, the manifest, the nav manifest, llms.txt)
+ * are produced by the monorepo `gen:*` drivers from stapel-categories' own
+ * `docs/` artifacts and stand under drift gates.
+ */
+// ── api ──────────────────────────────────────────────────────────────────────
+export { categoryListParams, createCategoriesApi } from "./api/categoriesApi.js";
+// ── catalog (pure: no React, no fetch, no storage) ───────────────────────────
+export { parseTreenodePks } from "./catalog/pks.js";
+export { buildCategoryTree, categoryAncestorIds, categoryBreadcrumbs, categoryChildIds, flattenCategoryNodes, resolveCategorySlug, } from "./catalog/tree.js";
+export { EMPTY_SNAPSHOT, applyCategoryPage, firstPageRequest, isEmptySnapshot, nextPageRequest, parseSnapshot, } from "./catalog/sync.js";
+export { categoryLabel, featureLabel, featureOptionsAreKeys, renderCategoryLabel, } from "./catalog/labels.js";
+// ── model (runtime wiring, persistence, sync driver, hooks) ──────────────────
+export { createCategoriesRuntime } from "./model/runtime.js";
+export { CategoriesRuntimeContext, useCategoriesAnalytics, useCategoriesApi, useCategoriesRuntime, } from "./model/context.js";
+export { CATALOG_KEY, CATALOG_NAMESPACE, createCatalogStore, memoryCatalogStore, } from "./model/catalogStore.js";
+export { MAX_SYNC_PAGES, syncCatalog } from "./model/catalogSync.js";
+export { catalogKeyOptions, categoriesQueryKeys } from "./model/queryKeys.js";
+export { useCategoriesRevision, useCategoryCarousel, useCategoryCatalog, useCategoryChildren, useCategoryFeatures, } from "./model/queries.js";
+// ── headless (renderless components) ─────────────────────────────────────────
+export { CategoriesProvider } from "./headless/CategoriesProvider.js";
+export { CategoryTree } from "./headless/CategoryTree.js";
+export { CategoryBreadcrumbs } from "./headless/CategoryBreadcrumbs.js";
+export { CategoryCarousel } from "./headless/CategoryCarousel.js";
+export { CategoryPicker } from "./headless/CategoryPicker.js";
+export { CategoryFeatures } from "./headless/CategoryFeatures.js";
+// ── nav manifest (the pair's public surface declaration) ─────────────────────
+export { navEntries } from "./nav/manifest.js";
+// ── i18n ─────────────────────────────────────────────────────────────────────
+export { CATEGORIES_I18N_KEYS, categoriesI18nBundleEn, registerCategoriesI18n, } from "./i18n/keys.js";
+// ── errors map (code → status/params/remediation/en; generated) ──────────────
+export { CATEGORIES_ERRORS, CATEGORIES_ERROR_CODES, CATEGORIES_FEATURE_EDITOR_CONFLICT, categoriesErrorBundleEn, explainCategoriesError, } from "./i18n/errorsMap.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAEH,gFAAgF;AAChF,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAajF,gFAAgF;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAO3B,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,aAAa,GACd,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAG7B,gFAAgF;AAChF,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAK7D,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAKjC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErE,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE9E,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAM5B,gFAAgF;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAMxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAMlE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAO9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAOlE,gFAAgF;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,gFAAgF;AAChF,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAGxB,gFAAgF;AAChF,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,kCAAkC,EAClC,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC"}

package/dist/model/catalogStore.d.ts

@@ -0,0 +1,23 @@
+import type { Repository } from "@stapel/core";
+import type { CategorySnapshot } from "../catalog/sync.js";
+/** The repository namespace. Changing it orphans every stored snapshot, which
+ * is the intended migration for a shape change too large for `version`. */
+export declare const CATALOG_NAMESPACE = "categories.catalog";
+/** The single key inside that namespace. */
+export declare const CATALOG_KEY = "snapshot";
+/** Read / write the catalogue snapshot, with every failure mode absorbed. */
+export interface CatalogStore {
+    load(): Promise<CategorySnapshot>;
+    save(snapshot: CategorySnapshot): Promise<void>;
+    clear(): Promise<void>;
+}
+export interface CreateCatalogStoreOptions {
+    /** Inject a repository (tests, SSR, a host with its own backend). Default:
+     * an app-scoped repository under {@link CATALOG_NAMESPACE}. */
+    readonly repository?: Repository<unknown>;
+}
+/** A store that remembers nothing — the honest fallback when persistence is
+ * unavailable, and what a caller passes to opt out of caching entirely. */
+export declare function memoryCatalogStore(): CatalogStore;
+export declare function createCatalogStore(options?: CreateCatalogStoreOptions): CatalogStore;
+//# sourceMappingURL=catalogStore.d.ts.map

package/dist/model/catalogStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogStore.d.ts","sourceRoot":"","sources":["../../src/model/catalogStore.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;2EAC2E;AAC3E,eAAO,MAAM,iBAAiB,uBAAuB,CAAC;AAEtD,4CAA4C;AAC5C,eAAO,MAAM,WAAW,aAAa,CAAC;AAEtC,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,IAAI,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAClC,IAAI,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACxC;mEAC+D;IAC/D,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;CAC3C;AAED;2EAC2E;AAC3E,wBAAgB,kBAAkB,IAAI,YAAY,CAajD;AAED,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,yBAA8B,GACtC,YAAY,CAmCd"}

package/dist/model/catalogStore.js

@@ -0,0 +1,85 @@
+/**
+ * Where the catalogue lives between page loads.
+ *
+ * `createRepository` is the ONE sanctioned client-side persistence primitive
+ * (`@stapel/core` `repository.ts`; direct `localStorage` outside it is a lint
+ * error, `stapel/no-raw-storage`), and the spec's verdict (§4.3) puts the tree
+ * in it with `scope: "app"`.
+ *
+ * **`scope: "app"` is a correctness choice, not a size one.** A user-scoped
+ * repository is encrypted with the per-session key and wiped on logout, with
+ * no opt-out — both of which are wrong here twice over: the category tree is
+ * a deployment's PUBLIC content, identical for every visitor and for a visitor
+ * with no session at all, and wiping it at logout would re-download the whole
+ * catalogue for somebody who just signed out of a storefront they are still
+ * browsing. App scope also means `createRepository` never asks for a
+ * `SessionManager`, so the store works on a page with no auth wired at all.
+ *
+ * A repository read can fail or return junk (a private window, cleared site
+ * data, a snapshot written by an older shape). Every read here degrades to
+ * "no snapshot" — a cold sync costs one request; a cache that throws costs
+ * the page.
+ */
+import { createRepository } from "@stapel/core";
+import { EMPTY_SNAPSHOT, parseSnapshot } from "../catalog/sync.js";
+/** The repository namespace. Changing it orphans every stored snapshot, which
+ * is the intended migration for a shape change too large for `version`. */
+export const CATALOG_NAMESPACE = "categories.catalog";
+/** The single key inside that namespace. */
+export const CATALOG_KEY = "snapshot";
+/** A store that remembers nothing — the honest fallback when persistence is
+ * unavailable, and what a caller passes to opt out of caching entirely. */
+export function memoryCatalogStore() {
+    let held = EMPTY_SNAPSHOT;
+    return {
+        load: () => Promise.resolve(held),
+        save: (snapshot) => {
+            held = snapshot;
+            return Promise.resolve();
+        },
+        clear: () => {
+            held = EMPTY_SNAPSHOT;
+            return Promise.resolve();
+        },
+    };
+}
+export function createCatalogStore(options = {}) {
+    let repository;
+    try {
+        repository =
+            options.repository ??
+                createRepository(CATALOG_NAMESPACE, { scope: "app" });
+    }
+    catch {
+        // No storage backend at all (an exotic runtime, a locked-down origin).
+        return memoryCatalogStore();
+    }
+    return {
+        async load() {
+            try {
+                return parseSnapshot(await repository.get(CATALOG_KEY)) ?? EMPTY_SNAPSHOT;
+            }
+            catch {
+                return EMPTY_SNAPSHOT;
+            }
+        },
+        async save(snapshot) {
+            try {
+                await repository.set(CATALOG_KEY, snapshot);
+            }
+            catch {
+                // A full quota or a blocked origin must not fail the render that
+                // triggered the sync: the catalogue is already in memory and correct.
+            }
+        },
+        async clear() {
+            try {
+                await repository.del(CATALOG_KEY);
+            }
+            catch {
+                /* nothing to undo */
+            }
+        },
+    };
+}
+//# sourceMappingURL=catalogStore.js.map

package/dist/model/catalogStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogStore.js","sourceRoot":"","sources":["../../src/model/catalogStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnE;2EAC2E;AAC3E,MAAM,CAAC,MAAM,iBAAiB,GAAG,oBAAoB,CAAC;AAEtD,4CAA4C;AAC5C,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;AAetC;2EAC2E;AAC3E,MAAM,UAAU,kBAAkB;IAChC,IAAI,IAAI,GAAqB,cAAc,CAAC;IAC5C,OAAO;QACL,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QACjC,IAAI,EAAE,CAAC,QAAQ,EAAE,EAAE;YACjB,IAAI,GAAG,QAAQ,CAAC;YAChB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QACD,KAAK,EAAE,GAAG,EAAE;YACV,IAAI,GAAG,cAAc,CAAC;YACtB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,UAAqC,EAAE;IAEvC,IAAI,UAA+B,CAAC;IACpC,IAAI,CAAC;QACH,UAAU;YACR,OAAO,CAAC,UAAU;gBAClB,gBAAgB,CAAU,iBAAiB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;QACvE,OAAO,kBAAkB,EAAE,CAAC;IAC9B,CAAC;IAED,OAAO;QACL,KAAK,CAAC,IAAI;YACR,IAAI,CAAC;gBACH,OAAO,aAAa,CAAC,MAAM,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,cAAc,CAAC;YAC5E,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,cAAc,CAAC;YACxB,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,QAAQ;YACjB,IAAI,CAAC;gBACH,MAAM,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YAC9C,CAAC;YAAC,MAAM,CAAC;gBACP,iEAAiE;gBACjE,sEAAsE;YACxE,CAAC;QACH,CAAC;QACD,KAAK,CAAC,KAAK;YACT,IAAI,CAAC;gBACH,MAAM,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YACpC,CAAC;YAAC,MAAM,CAAC;gBACP,qBAAqB;YACvB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/model/catalogSync.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The sync walk: stored snapshot → one request or several → a fresh snapshot.
+ *
+ * Pure of React, so the same routine serves the hook, an SSR prefetch and a
+ * test. The rules it enforces are all in `catalog/sync.ts`; this is the loop
+ * that applies them, plus the two guards a loop over a paginated endpoint
+ * needs:
+ *
+ *  - a **page budget**, because `has_next` is server-reported and a bug there
+ *    (or a catalogue growing faster than the walk reads it) is an infinite
+ *    request loop against someone's production API, not a slow render; and
+ *  - **publish-on-completion**, so a walk that dies on page 3 leaves the
+ *    previous catalogue intact instead of replacing it with two thirds of one.
+ */
+import type { CategoriesApi } from "../api/categoriesApi.js";
+import type { CategorySnapshot } from "../catalog/sync.js";
+/**
+ * Hard ceiling on pages per sync. At the server's max `page_size` of 1000 this
+ * is a million categories — far beyond any real catalogue, and small enough
+ * that a runaway loop stops in seconds instead of hammering a backend.
+ */
+export declare const MAX_SYNC_PAGES = 1000;
+export interface SyncCatalogOptions {
+    readonly signal?: AbortSignal;
+    /** Rows per request. Server default 100, maximum 1000. */
+    readonly pageSize?: number;
+    readonly maxPages?: number;
+}
+export interface SyncCatalogResult {
+    readonly snapshot: CategorySnapshot;
+    /** `true` when the walk started from nothing (a cold catalogue). */
+    readonly wasFullSync: boolean;
+    /** How many requests the walk actually made. `0` is impossible — the
+     * freshness probe is the caller's job, not this function's. */
+    readonly pages: number;
+    /** The page budget stopped the walk before `has_next` did. The snapshot is
+     * a truncated catalogue and the caller must NOT treat it as complete. */
+    readonly truncated: boolean;
+}
+/**
+ * Bring `stored` up to date.
+ *
+ * A cold start walks the whole catalogue into a fresh accumulator; a warm
+ * start folds the delta into the stored rows. Which one happens is decided by
+ * `firstPageRequest` and by what the accumulator starts as — there is no flag
+ * that a caller could set the wrong way (see `catalog/sync.ts`).
+ */
+export declare function syncCatalog(api: CategoriesApi, stored: CategorySnapshot, options?: SyncCatalogOptions): Promise<SyncCatalogResult>;
+//# sourceMappingURL=catalogSync.d.ts.map

package/dist/model/catalogSync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogSync.d.ts","sourceRoot":"","sources":["../../src/model/catalogSync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAS7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;GAIG;AACH,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,oEAAoE;IACpE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B;mEAC+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;6EACyE;IACzE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAmD5B"}

package/dist/model/catalogSync.js

@@ -0,0 +1,64 @@
+import { EMPTY_SNAPSHOT, applyCategoryPage, firstPageRequest, isEmptySnapshot, nextPageRequest, } from "../catalog/sync.js";
+/**
+ * Hard ceiling on pages per sync. At the server's max `page_size` of 1000 this
+ * is a million categories — far beyond any real catalogue, and small enough
+ * that a runaway loop stops in seconds instead of hammering a backend.
+ */
+export const MAX_SYNC_PAGES = 1000;
+/**
+ * Bring `stored` up to date.
+ *
+ * A cold start walks the whole catalogue into a fresh accumulator; a warm
+ * start folds the delta into the stored rows. Which one happens is decided by
+ * `firstPageRequest` and by what the accumulator starts as — there is no flag
+ * that a caller could set the wrong way (see `catalog/sync.ts`).
+ */
+export async function syncCatalog(api, stored, options = {}) {
+    const wasFullSync = isEmptySnapshot(stored);
+    const budget = options.maxPages ?? MAX_SYNC_PAGES;
+    let request = {
+        ...firstPageRequest(stored),
+        ...(options.pageSize !== undefined ? { pageSize: options.pageSize } : {}),
+    };
+    // A full sync must not inherit rows the server is no longer listing, so it
+    // accumulates from empty. A delta folds into what is already known.
+    let accumulator = wasFullSync
+        ? EMPTY_SNAPSHOT
+        : { ...stored };
+    let pages = 0;
+    let truncated = false;
+    while (request !== undefined) {
+        if (pages >= budget) {
+            truncated = true;
+            break;
+        }
+        const current = request;
+        const page = await api.list(current, {
+            ...(options.signal !== undefined ? { signal: options.signal } : {}),
+        });
+        pages += 1;
+        accumulator = applyCategoryPage(accumulator, page, {
+            // The walk pinned its window with `max_revision`; the cursor may not
+            // claim to have read past it.
+            ...(current.maxRevision !== undefined
+                ? { cursorLimit: current.maxRevision }
+                : {}),
+        });
+        request = nextPageRequest(current, page);
+    }
+    if (truncated) {
+        // The rows gathered so far are still worth showing — a partial catalogue
+        // beats a blank menu — but the CURSOR must not advance, or the next sync
+        // asks for a delta on top of a catalogue that was never fully read and the
+        // gap becomes permanent. Rewinding it here means the worst case is one
+        // repeated full walk, not a silently incomplete tree forever.
+        return {
+            snapshot: { ...accumulator, cursor: stored.cursor },
+            wasFullSync,
+            pages,
+            truncated,
+        };
+    }
+    return { snapshot: accumulator, wasFullSync, pages, truncated };
+}
+//# sourceMappingURL=catalogSync.js.map

package/dist/model/catalogSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogSync.js","sourceRoot":"","sources":["../../src/model/catalogSync.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAG5B;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AAqBnC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAkB,EAClB,MAAwB,EACxB,UAA8B,EAAE;IAEhC,MAAM,WAAW,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,IAAI,cAAc,CAAC;IAElD,IAAI,OAAO,GAAmC;QAC5C,GAAG,gBAAgB,CAAC,MAAM,CAAC;QAC3B,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1E,CAAC;IACF,2EAA2E;IAC3E,oEAAoE;IACpE,IAAI,WAAW,GAAqB,WAAW;QAC7C,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC;IAClB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,OAAO,OAAO,KAAK,SAAS,EAAE,CAAC;QAC7B,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;YACpB,SAAS,GAAG,IAAI,CAAC;YACjB,MAAM;QACR,CAAC;QACD,MAAM,OAAO,GAAuB,OAAO,CAAC;QAC5C,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE;YACnC,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpE,CAAC,CAAC;QACH,KAAK,IAAI,CAAC,CAAC;QACX,WAAW,GAAG,iBAAiB,CAAC,WAAW,EAAE,IAAI,EAAE;YACjD,qEAAqE;YACrE,8BAA8B;YAC9B,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS;gBACnC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE;gBACtC,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAC;QACH,OAAO,GAAG,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACd,yEAAyE;QACzE,yEAAyE;QACzE,2EAA2E;QAC3E,uEAAuE;QACvE,8DAA8D;QAC9D,OAAO;YACL,QAAQ,EAAE,EAAE,GAAG,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;YACnD,WAAW;YACX,KAAK;YACL,SAAS;SACV,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAClE,CAAC"}

package/dist/model/context.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from "react";
+import type { Analytics, ModuleContextKit } from "@stapel/core";
+import type { CategoriesApi } from "../api/categoriesApi.js";
+import type { CategoriesRuntime } from "./runtime.js";
+export declare const CategoriesRuntimeContext: Context<CategoriesRuntime | null>;
+export declare const useCategoriesRuntime: () => CategoriesRuntime;
+export declare const useCategoriesApi: () => CategoriesApi;
+export declare const useCategoriesAnalytics: () => Analytics | null;
+/** @internal Re-exported as `<CategoriesProvider>` from `headless/`. */
+export declare const ModuleProvider: ModuleContextKit<CategoriesRuntime>["Provider"];
+//# sourceMappingURL=context.d.ts.map

package/dist/model/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/model/context.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAErC,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAYtD,eAAO,MAAM,wBAAwB,EAAE,OAAO,CAAC,iBAAiB,GAAG,IAAI,CACnD,CAAC;AAErB,eAAO,MAAM,oBAAoB,EAAE,MAAM,iBAAkC,CAAC;AAE5E,eAAO,MAAM,gBAAgB,EAAE,MAAM,aAA0B,CAAC;AAEhE,eAAO,MAAM,sBAAsB,EAAE,MAAM,SAAS,GAAG,IAAuB,CAAC;AAE/E,wEAAwE;AACxE,eAAO,MAAM,cAAc,EAAE,gBAAgB,CAAC,iBAAiB,CAAC,CAAC,UAAU,CAC7D,CAAC"}

package/dist/model/context.js

@@ -0,0 +1,16 @@
+import { createModuleContext } from "@stapel/core";
+/**
+ * The wired CategoriesRuntime shared through React context by
+ * `<CategoriesProvider>`. Hooks in `model/` and `headless/` read the
+ * singletons from here. One reviewed copy of this plumbing lives in
+ * `@stapel/core` (`createModuleContext`, slim wave §21/S2); this module binds
+ * it under the pair's public names.
+ */
+const kit = createModuleContext("Categories");
+export const CategoriesRuntimeContext = kit.RuntimeContext;
+export const useCategoriesRuntime = kit.useRuntime;
+export const useCategoriesApi = kit.useApi;
+export const useCategoriesAnalytics = kit.useAnalytics;
+/** @internal Re-exported as `<CategoriesProvider>` from `headless/`. */
+export const ModuleProvider = kit.Provider;
+//# sourceMappingURL=context.js.map

package/dist/model/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/model/context.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAKnD;;;;;;GAMG;AACH,MAAM,GAAG,GACP,mBAAmB,CAAoB,YAAY,CAAC,CAAC;AAEvD,MAAM,CAAC,MAAM,wBAAwB,GACnC,GAAG,CAAC,cAAc,CAAC;AAErB,MAAM,CAAC,MAAM,oBAAoB,GAA4B,GAAG,CAAC,UAAU,CAAC;AAE5E,MAAM,CAAC,MAAM,gBAAgB,GAAwB,GAAG,CAAC,MAAM,CAAC;AAEhE,MAAM,CAAC,MAAM,sBAAsB,GAA2B,GAAG,CAAC,YAAY,CAAC;AAE/E,wEAAwE;AACxE,MAAM,CAAC,MAAM,cAAc,GACzB,GAAG,CAAC,QAAQ,CAAC"}