simplycms 0.4.0

package/dist/themes/conformance/index.js

@@ -0,0 +1,235 @@
+import { ThemeContext, resolveDefaultThemeSettings } from '../../chunk-EFLUQ3O7.js';
+import { ThemeRegistry } from '../../chunk-QQDFDCU7.js';
+import { validateThemeModule } from '../../chunk-64LMUHDA.js';
+import '../../chunk-PZ5AY32C.js';
+import { HOME_REQUISITES, CATALOG_REQUISITES, PRODUCT_DETAIL_REQUISITES, CART_REQUISITES, REQUISITE_ATTRIBUTE, REQUIRED_REQUISITES } from 'simplycms/contracts/views';
+import { viewModelFixtures } from 'simplycms/contracts/views/fixtures';
+import { jsx } from 'react/jsx-runtime';
+import { act, Suspense, Component } from 'react';
+import { createRoot } from 'react-dom/client';
+import { I18nProvider } from 'simplycms/i18n';
+
+function markerProps(name) {
+  return { [REQUISITE_ATTRIBUTE]: name };
+}
+function requisiteStub(name) {
+  return function RequisiteStub() {
+    return /* @__PURE__ */ jsx("div", { ...markerProps(name) });
+  };
+}
+var homeSlotStubs = {
+  SectionCarousel: requisiteStub(HOME_REQUISITES.SectionCarousel)
+};
+var catalogSlotStubs = {
+  SectionChips: requisiteStub(CATALOG_REQUISITES.SectionChips),
+  Filters: requisiteStub(CATALOG_REQUISITES.Filters),
+  SortSelect: requisiteStub(CATALOG_REQUISITES.SortSelect),
+  ViewModeToggle: requisiteStub(CATALOG_REQUISITES.ViewModeToggle),
+  ActiveFilters: requisiteStub(CATALOG_REQUISITES.ActiveFilters),
+  ProductGrid: requisiteStub(CATALOG_REQUISITES.ProductGrid)
+};
+var productDetailSlotStubs = {
+  PluginBefore: requisiteStub(PRODUCT_DETAIL_REQUISITES.PluginBefore),
+  StockBadge: requisiteStub(PRODUCT_DETAIL_REQUISITES.StockBadge),
+  PluginBadges: requisiteStub(PRODUCT_DETAIL_REQUISITES.PluginBadges),
+  PriceBlock: requisiteStub(PRODUCT_DETAIL_REQUISITES.PriceBlock),
+  ModificationSelector: requisiteStub(
+    PRODUCT_DETAIL_REQUISITES.ModificationSelector
+  ),
+  AddToCart: requisiteStub(PRODUCT_DETAIL_REQUISITES.AddToCart),
+  StockAvailability: requisiteStub(PRODUCT_DETAIL_REQUISITES.StockAvailability),
+  Reviews: requisiteStub(PRODUCT_DETAIL_REQUISITES.Reviews),
+  PluginAfter: requisiteStub(PRODUCT_DETAIL_REQUISITES.PluginAfter)
+};
+var cartSlotStubs = {
+  Items: requisiteStub(CART_REQUISITES.Items),
+  ClearCart: requisiteStub(CART_REQUISITES.ClearCart),
+  Summary: requisiteStub(CART_REQUISITES.Summary),
+  Checkout: requisiteStub(CART_REQUISITES.Checkout)
+};
+var CONFORMANCE_STATES = ["full", "edge"];
+function buildConformanceCases(views) {
+  const cases = [];
+  const Home = views.Home;
+  if (Home) {
+    const fixtures = viewModelFixtures.Home;
+    cases.push({
+      name: "Home",
+      states: {
+        full: /* @__PURE__ */ jsx(Home, { ...fixtures.full, slots: homeSlotStubs }),
+        edge: /* @__PURE__ */ jsx(Home, { ...fixtures.edge, slots: homeSlotStubs })
+      }
+    });
+  }
+  const Catalog = views.Catalog;
+  if (Catalog) {
+    const fixtures = viewModelFixtures.Catalog;
+    cases.push({
+      name: "Catalog",
+      states: {
+        full: /* @__PURE__ */ jsx(Catalog, { ...fixtures.full, slots: catalogSlotStubs }),
+        edge: /* @__PURE__ */ jsx(Catalog, { ...fixtures.edge, slots: catalogSlotStubs })
+      }
+    });
+  }
+  const CatalogSection = views.CatalogSection;
+  if (CatalogSection) {
+    const fixtures = viewModelFixtures.CatalogSection;
+    cases.push({
+      name: "CatalogSection",
+      states: {
+        full: /* @__PURE__ */ jsx(CatalogSection, { ...fixtures.full, slots: catalogSlotStubs }),
+        edge: /* @__PURE__ */ jsx(CatalogSection, { ...fixtures.edge, slots: catalogSlotStubs })
+      }
+    });
+  }
+  const ProductDetail = views.ProductDetail;
+  if (ProductDetail) {
+    const fixtures = viewModelFixtures.ProductDetail;
+    cases.push({
+      name: "ProductDetail",
+      states: {
+        full: /* @__PURE__ */ jsx(ProductDetail, { ...fixtures.full, slots: productDetailSlotStubs }),
+        edge: /* @__PURE__ */ jsx(ProductDetail, { ...fixtures.edge, slots: productDetailSlotStubs })
+      }
+    });
+  }
+  const Cart = views.Cart;
+  if (Cart) {
+    const fixtures = viewModelFixtures.Cart;
+    cases.push({
+      name: "Cart",
+      states: {
+        full: /* @__PURE__ */ jsx(Cart, { ...fixtures.full, slots: cartSlotStubs }),
+        edge: /* @__PURE__ */ jsx(Cart, { ...fixtures.edge, slots: cartSlotStubs })
+      }
+    });
+  }
+  return cases;
+}
+var ConformanceBoundary = class extends Component {
+  constructor() {
+    super(...arguments);
+    this.state = { failed: false };
+  }
+  static getDerivedStateFromError() {
+    return { failed: true };
+  }
+  componentDidCatch(error) {
+    this.props.onError(error);
+  }
+  render() {
+    return this.state.failed ? null : this.props.children;
+  }
+};
+function contextValue(theme) {
+  return {
+    activeTheme: theme,
+    themeName: theme.manifest.name,
+    // Default-и зі схеми теми: view, що читає `useThemeSettings`, тестований
+    // без БД — рівно те, чого вимагає спека §8, п.3.
+    themeSettings: resolveDefaultThemeSettings(theme.settings),
+    isLoading: false,
+    error: null,
+    refreshTheme: () => Promise.resolve()
+  };
+}
+async function renderThemeView(element, theme, locale) {
+  let error = null;
+  const container = document.createElement("div");
+  document.body.appendChild(container);
+  const root = createRoot(container, {
+    // Помилку фіксує межа нижче; дефолтний лог React лише зашумив би вивід
+    // гейта, який і так покаже причину в тексті винятку.
+    onCaughtError: () => {
+    },
+    onUncaughtError: (uncaught) => {
+      error = uncaught;
+    }
+  });
+  const actEnv = globalThis;
+  const previousActEnv = actEnv.IS_REACT_ACT_ENVIRONMENT;
+  actEnv.IS_REACT_ACT_ENVIRONMENT = true;
+  try {
+    await act(async () => {
+      root.render(
+        /* @__PURE__ */ jsx(I18nProvider, { locale, children: /* @__PURE__ */ jsx(ThemeContext.Provider, { value: contextValue(theme), children: /* @__PURE__ */ jsx(
+          ConformanceBoundary,
+          {
+            onError: (caught) => {
+              error = caught;
+            },
+            children: /* @__PURE__ */ jsx(Suspense, { fallback: null, children: element })
+          }
+        ) }) })
+      );
+    });
+    const requisites = Array.from(
+      container.querySelectorAll(`[${REQUISITE_ATTRIBUTE}]`)
+    ).map((node) => node.getAttribute(REQUISITE_ATTRIBUTE)).filter((name) => name !== null);
+    return { error, requisites };
+  } finally {
+    await act(async () => {
+      root.unmount();
+    });
+    actEnv.IS_REACT_ACT_ENVIRONMENT = previousActEnv;
+    container.remove();
+  }
+}
+
+// src/themes/conformance/assertThemeViewsConformance.ts
+function describe(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function ensureRegistered(theme) {
+  const { name } = theme.manifest;
+  if (ThemeRegistry.has(name)) return false;
+  ThemeRegistry.register(name, () => Promise.resolve({ default: theme }));
+  return true;
+}
+async function assertThemeViewsConformance(theme, options = {}) {
+  if (typeof document === "undefined") {
+    throw new Error(
+      "[theme:conformance] \u041F\u043E\u0442\u0440\u0456\u0431\u043D\u0435 DOM-\u0441\u0435\u0440\u0435\u0434\u043E\u0432\u0438\u0449\u0435: \u0434\u043E\u0434\u0430\u0439\u0442\u0435 \u0434\u043E \u0442\u0435\u0441\u0442\u0443 \u0434\u0438\u0440\u0435\u043A\u0442\u0438\u0432\u0443 `// @vitest-environment jsdom`"
+    );
+  }
+  validateThemeModule(theme);
+  const cases = theme.views ? buildConformanceCases(theme.views) : [];
+  if (cases.length === 0) return [];
+  const locale = options.locale ?? "uk";
+  const themeName = theme.manifest.name;
+  const registeredByKit = ensureRegistered(theme);
+  try {
+    for (const item of cases) {
+      for (const state of CONFORMANCE_STATES) {
+        const { error, requisites } = await renderThemeView(
+          item.states[state],
+          theme,
+          locale
+        );
+        if (error !== null) {
+          throw new Error(
+            `[theme:conformance] "${themeName}": views.${item.name} \u0432\u043F\u0430\u0432 \u043D\u0430 \u0441\u0442\u0430\u043D\u0456 "${state}": ${describe(error)}`,
+            { cause: error }
+          );
+        }
+        if (state !== "full") continue;
+        const missing = REQUIRED_REQUISITES[item.name].filter(
+          (requisite) => !requisites.includes(requisite)
+        );
+        if (missing.length > 0) {
+          throw new Error(
+            `[theme:conformance] "${themeName}": views.${item.name} \u043D\u0435 \u0440\u043E\u0437\u0441\u0442\u0430\u0432\u0438\u0432 \u043E\u0431\u043E\u0432\u02BC\u044F\u0437\u043A\u043E\u0432\u0456 \u0440\u0435\u043A\u0432\u0456\u0437\u0438\u0442\u0438: ${missing.join(", ")}`
+          );
+        }
+      }
+    }
+  } finally {
+    if (registeredByKit) ThemeRegistry.unregister(themeName);
+  }
+  return cases.map((item) => item.name);
+}
+
+export { CONFORMANCE_STATES, assertThemeViewsConformance };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/themes/conformance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/themes/conformance/stubs.tsx","../../../src/themes/conformance/cases.tsx","../../../src/themes/conformance/boundary.tsx","../../../src/themes/conformance/render.tsx","../../../src/themes/conformance/assertThemeViewsConformance.ts"],"names":["jsx","REQUISITE_ATTRIBUTE"],"mappings":"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","file":"index.js","sourcesContent":["// Стаби комерційних реквізитів для conformance-рендеру (контракт тем v3).\n//\n// 🔴 Kit НЕ бачить реальних слотів: вони живуть у `simplycms/storefront-routes`\n// (T5), а theme-system — нижчий тір і залежати від route-пакета не має права.\n// Тому слот тут підмінено мінімальним стабом, який малює ЛИШЕ маркер — рівно\n// той контракт, на якому тримається перевірка складу реквізитів. Наслідок,\n// про який варто памʼятати: kit доводить, що тема РОЗСТАВИЛА слот, а не те,\n// що прибінджена ядром логіка всередині нього працює (це доводять юніти\n// самих слотів).\n\nimport type { ReactElement } from 'react';\nimport {\n  CART_REQUISITES,\n  CATALOG_REQUISITES,\n  HOME_REQUISITES,\n  PRODUCT_DETAIL_REQUISITES,\n  REQUISITE_ATTRIBUTE,\n  type CartSlots,\n  type CatalogSlots,\n  type HomeSlots,\n  type ProductDetailSlots,\n} from 'simplycms/contracts/views';\n\n/** Атрибут-маркер береться з контракту, а не дублюється рядком. */\nfunction markerProps(name: string): Record<string, string> {\n  return { [REQUISITE_ATTRIBUTE]: name };\n}\n\nfunction requisiteStub(name: string): () => ReactElement {\n  return function RequisiteStub() {\n    return <div {...markerProps(name)} />;\n  };\n}\n\nexport const homeSlotStubs: HomeSlots = {\n  SectionCarousel: requisiteStub(HOME_REQUISITES.SectionCarousel),\n};\n\nexport const catalogSlotStubs: CatalogSlots = {\n  SectionChips: requisiteStub(CATALOG_REQUISITES.SectionChips),\n  Filters: requisiteStub(CATALOG_REQUISITES.Filters),\n  SortSelect: requisiteStub(CATALOG_REQUISITES.SortSelect),\n  ViewModeToggle: requisiteStub(CATALOG_REQUISITES.ViewModeToggle),\n  ActiveFilters: requisiteStub(CATALOG_REQUISITES.ActiveFilters),\n  ProductGrid: requisiteStub(CATALOG_REQUISITES.ProductGrid),\n};\n\nexport const productDetailSlotStubs: ProductDetailSlots = {\n  PluginBefore: requisiteStub(PRODUCT_DETAIL_REQUISITES.PluginBefore),\n  StockBadge: requisiteStub(PRODUCT_DETAIL_REQUISITES.StockBadge),\n  PluginBadges: requisiteStub(PRODUCT_DETAIL_REQUISITES.PluginBadges),\n  PriceBlock: requisiteStub(PRODUCT_DETAIL_REQUISITES.PriceBlock),\n  ModificationSelector: requisiteStub(\n    PRODUCT_DETAIL_REQUISITES.ModificationSelector,\n  ),\n  AddToCart: requisiteStub(PRODUCT_DETAIL_REQUISITES.AddToCart),\n  StockAvailability: requisiteStub(PRODUCT_DETAIL_REQUISITES.StockAvailability),\n  Reviews: requisiteStub(PRODUCT_DETAIL_REQUISITES.Reviews),\n  PluginAfter: requisiteStub(PRODUCT_DETAIL_REQUISITES.PluginAfter),\n};\n\nexport const cartSlotStubs: CartSlots = {\n  Items: requisiteStub(CART_REQUISITES.Items),\n  ClearCart: requisiteStub(CART_REQUISITES.ClearCart),\n  Summary: requisiteStub(CART_REQUISITES.Summary),\n  Checkout: requisiteStub(CART_REQUISITES.Checkout),\n};\n","// Складання прогонів conformance: заявлений темою view × фікстурні стани.\n//\n// 🔴 Пʼять явних блоків замість циклу по `THEME_VIEW_KEYS` — навмисно.\n// Кожна сторінка має ВЛАСНИЙ тип view-model і власний набір слотів, тож\n// узагальнений цикл вимагав би приведення типів (`as`), яке саме тут і\n// маскувало б розсинхрон контракту. Явні блоки типізуються повністю: новий\n// ключ у `ThemeViews` без блоку тут просто не перевіряється, а зміна форми\n// vm — червоний `pnpm typecheck`.\n\nimport type { ReactElement } from 'react';\nimport type { StorefrontViewName } from 'simplycms/contracts/views';\nimport { viewModelFixtures } from 'simplycms/contracts/views/fixtures';\nimport type { ThemeViews } from '../types';\nimport {\n  cartSlotStubs,\n  catalogSlotStubs,\n  homeSlotStubs,\n  productDetailSlotStubs,\n} from './stubs';\n\n/**\n * Стани, на яких ганяється кожен view: `full` — повні дані (на ньому\n * асертиться склад реквізитів), `edge` — крайній (товар без фото, порожній\n * кошик, порожня секція; тут доводиться лише те, що рендер не падає).\n */\nexport const CONFORMANCE_STATES = ['full', 'edge'] as const;\n\nexport type ConformanceState = (typeof CONFORMANCE_STATES)[number];\n\nexport interface ConformanceCase {\n  name: StorefrontViewName;\n  states: Record<ConformanceState, ReactElement>;\n}\n\nexport function buildConformanceCases(views: ThemeViews): ConformanceCase[] {\n  const cases: ConformanceCase[] = [];\n\n  const Home = views.Home;\n  if (Home) {\n    const fixtures = viewModelFixtures.Home;\n    cases.push({\n      name: 'Home',\n      states: {\n        full: <Home {...fixtures.full} slots={homeSlotStubs} />,\n        edge: <Home {...fixtures.edge} slots={homeSlotStubs} />,\n      },\n    });\n  }\n\n  const Catalog = views.Catalog;\n  if (Catalog) {\n    const fixtures = viewModelFixtures.Catalog;\n    cases.push({\n      name: 'Catalog',\n      states: {\n        full: <Catalog {...fixtures.full} slots={catalogSlotStubs} />,\n        edge: <Catalog {...fixtures.edge} slots={catalogSlotStubs} />,\n      },\n    });\n  }\n\n  const CatalogSection = views.CatalogSection;\n  if (CatalogSection) {\n    const fixtures = viewModelFixtures.CatalogSection;\n    cases.push({\n      name: 'CatalogSection',\n      states: {\n        full: <CatalogSection {...fixtures.full} slots={catalogSlotStubs} />,\n        edge: <CatalogSection {...fixtures.edge} slots={catalogSlotStubs} />,\n      },\n    });\n  }\n\n  const ProductDetail = views.ProductDetail;\n  if (ProductDetail) {\n    const fixtures = viewModelFixtures.ProductDetail;\n    cases.push({\n      name: 'ProductDetail',\n      states: {\n        full: (\n          <ProductDetail {...fixtures.full} slots={productDetailSlotStubs} />\n        ),\n        edge: (\n          <ProductDetail {...fixtures.edge} slots={productDetailSlotStubs} />\n        ),\n      },\n    });\n  }\n\n  const Cart = views.Cart;\n  if (Cart) {\n    const fixtures = viewModelFixtures.Cart;\n    cases.push({\n      name: 'Cart',\n      states: {\n        full: <Cart {...fixtures.full} slots={cartSlotStubs} />,\n        edge: <Cart {...fixtures.edge} slots={cartSlotStubs} />,\n      },\n    });\n  }\n\n  return cases;\n}\n","import { Component, type ReactNode } from 'react';\n\ninterface BoundaryProps {\n  onError: (error: unknown) => void;\n  children: ReactNode;\n}\n\ninterface BoundaryState {\n  failed: boolean;\n}\n\n/**\n * Межа помилки conformance-рендеру.\n *\n * 🔴 Чому саме межа, а не «спробувати спіймати виняток з `root.render`»:\n * React рендерить конкурентно й помилку компонента синхронно з виклику\n * рендеру НЕ кидає — вона доходить до обробника уже після. Межа перетворює\n * падіння view на ДЕТЕРМІНОВАНИЙ факт: `onError` викликається рівно один\n * раз, і kit має що показати автору теми замість «тест просто зелений».\n */\nexport class ConformanceBoundary extends Component<\n  BoundaryProps,\n  BoundaryState\n> {\n  state: BoundaryState = { failed: false };\n\n  static getDerivedStateFromError(): BoundaryState {\n    return { failed: true };\n  }\n\n  componentDidCatch(error: unknown): void {\n    this.props.onError(error);\n  }\n\n  render(): ReactNode {\n    return this.state.failed ? null : this.props.children;\n  }\n}\n","import { Suspense, act, type ReactElement } from 'react';\nimport { createRoot } from 'react-dom/client';\nimport { I18nProvider, type Locale } from 'simplycms/i18n';\nimport { REQUISITE_ATTRIBUTE } from 'simplycms/contracts/views';\nimport { ThemeContext } from '../theme-context';\nimport { resolveDefaultThemeSettings } from '../theme-settings';\nimport type { ThemeContextType, ThemeModule } from '../types';\nimport { ConformanceBoundary } from './boundary';\n\nexport interface ThemeViewRenderResult {\n  /** Помилка рендеру або `null` — view пережив стан. */\n  error: unknown;\n  /** Імена знайдених у DOM маркерів реквізитів (у порядку документа). */\n  requisites: string[];\n}\n\n/** Render-контекст, який kit гарантує кожному view теми (спека §7, п.3). */\nfunction contextValue(theme: ThemeModule): ThemeContextType {\n  return {\n    activeTheme: theme,\n    themeName: theme.manifest.name,\n    // Default-и зі схеми теми: view, що читає `useThemeSettings`, тестований\n    // без БД — рівно те, чого вимагає спека §8, п.3.\n    themeSettings: resolveDefaultThemeSettings(theme.settings),\n    isLoading: false,\n    error: null,\n    refreshTheme: () => Promise.resolve(),\n  };\n}\n\n/**\n * Рендер одного view теми в DOM і зняття маркерів реквізитів.\n *\n * 🔴 Потрібне DOM-середовище (у vitest — `// @vitest-environment jsdom`):\n * conformance доводить саме РОЗМІТКУ, тому рендер справжній, а не\n * серіалізація в рядок. Гард середовища стоїть на публічному вході\n * (`assertThemeViewsConformance`), щоб автор теми отримав зрозумілу причину\n * до першого рендеру. `act` тут не з тест-бібліотеки, а з `react` — kit\n * публікується разом із ядром, і тягнути `@testing-library` у залежності\n * магазину заради двох рядків було б неспівмірно.\n */\nexport async function renderThemeView(\n  element: ReactElement,\n  theme: ThemeModule,\n  locale: Locale,\n): Promise<ThemeViewRenderResult> {\n  let error: unknown = null;\n  const container = document.createElement('div');\n  document.body.appendChild(container);\n\n  const root = createRoot(container, {\n    // Помилку фіксує межа нижче; дефолтний лог React лише зашумив би вивід\n    // гейта, який і так покаже причину в тексті винятку.\n    onCaughtError: () => {},\n    onUncaughtError: (uncaught: unknown) => {\n      error = uncaught;\n    },\n  });\n\n  const actEnv = globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean };\n  const previousActEnv = actEnv.IS_REACT_ACT_ENVIRONMENT;\n  actEnv.IS_REACT_ACT_ENVIRONMENT = true;\n\n  try {\n    await act(async () => {\n      root.render(\n        <I18nProvider locale={locale}>\n          <ThemeContext.Provider value={contextValue(theme)}>\n            <ConformanceBoundary\n              onError={(caught) => {\n                error = caught;\n              }}\n            >\n              {/* Тема може читати каталог через `useThemeT` — той suspend-иться\n                  на промісі реєстру, тож межа Suspense обовʼязкова. */}\n              <Suspense fallback={null}>{element}</Suspense>\n            </ConformanceBoundary>\n          </ThemeContext.Provider>\n        </I18nProvider>,\n      );\n    });\n\n    const requisites = Array.from(\n      container.querySelectorAll(`[${REQUISITE_ATTRIBUTE}]`),\n    )\n      .map((node) => node.getAttribute(REQUISITE_ATTRIBUTE))\n      .filter((name): name is string => name !== null);\n\n    return { error, requisites };\n  } finally {\n    await act(async () => {\n      root.unmount();\n    });\n    actEnv.IS_REACT_ACT_ENVIRONMENT = previousActEnv;\n    container.remove();\n  }\n}\n","import type { Locale } from 'simplycms/i18n';\nimport {\n  REQUIRED_REQUISITES,\n  type StorefrontViewName,\n} from 'simplycms/contracts/views';\nimport { ThemeRegistry } from '../ThemeRegistry';\nimport { validateThemeModule } from '../validateThemeModule';\nimport type { ThemeModule } from '../types';\nimport { buildConformanceCases, CONFORMANCE_STATES } from './cases';\nimport { renderThemeView } from './render';\n\nexport interface ThemeViewsConformanceOptions {\n  /** Локаль рендеру; за замовчуванням `uk` — як і fallback core-каталогу. */\n  locale?: Locale;\n}\n\nfunction describe(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\n/**\n * Реєструє тему в `ThemeRegistry` на час прогону, якщо її там ще немає:\n * `useThemeT` бере каталог саме звідти (`use(ThemeRegistry.load(name))`), і\n * без реєстрації view теми з перекладами впав би на етапі підготовки.\n * Повертає `true`, якщо реєстрацію зробив kit — тоді її ж і знімаємо.\n */\nfunction ensureRegistered(theme: ThemeModule): boolean {\n  const { name } = theme.manifest;\n  if (ThemeRegistry.has(name)) return false;\n\n  ThemeRegistry.register(name, () => Promise.resolve({ default: theme }));\n  return true;\n}\n\n/**\n * Conformance-гейт контракту тем v3: рендерить КОЖЕН заявлений темою view на\n * фікстурних view-model-ах ядра й асертить два твердження —\n *\n * 1. на повному стані присутні всі обовʼязкові реквізити сторінки (маркери\n *    `data-simplycms-requisite`, склад — `REQUIRED_REQUISITES`);\n * 2. рендер не падає на крайніх станах (товар без фото, порожній кошик,\n *    порожня секція, магазин без категорій).\n *\n * 🔴 Склад реквізитів перевіряється ЛИШЕ на стані `full`, і це не послаблення.\n * На крайньому стані сторінка може структурно прибрати весь блок реквізитів\n * разом із даними (порожній кошик показує заглушку, магазин без кореневих\n * категорій не має жодної каруселі) — вимога «маркер присутній завжди»\n * червоніла б там не на дефекті теми. Тому `edge` доводить рівно те, що може\n * довести: рендер живий.\n *\n * 🔴 Рантайм-fallback на канонічний view при провалі НЕ робиться (рішення V3\n * спеки §7): дефект має бути видно на гейті, а не маскуватися в проді.\n *\n * Тема без `views` — чесний pass: перевіряти нема чого.\n *\n * 🔴 Повертає перелік ФАКТИЧНО прогнаних сторінок (порядок — `cases`), а не\n * заявлених темою. Різниця не косметична: заявлений ключ, для якого в\n * `buildConformanceCases` немає блоку, не перевіряється — і звіт, зібраний із\n * `Object.keys(theme.views)`, показав би прогін, якого не було. Тому і CLI\n * (`simplycms theme:conformance`), і тести друкують/асертять саме це\n * значення.\n *\n * Потрібне DOM-середовище (`// @vitest-environment jsdom`). Якщо view теми\n * використовує `Link` із `@tanstack/react-router`, тест магазину має або\n * підняти роутер, або замокати модуль — kit роутера не піднімає навмисно\n * (він перевіряє тему, а не навігацію).\n */\nexport async function assertThemeViewsConformance(\n  theme: ThemeModule,\n  options: ThemeViewsConformanceOptions = {},\n): Promise<StorefrontViewName[]> {\n  if (typeof document === 'undefined') {\n    throw new Error(\n      '[theme:conformance] Потрібне DOM-середовище: додайте до тесту ' +\n        'директиву `// @vitest-environment jsdom`',\n    );\n  }\n\n  validateThemeModule(theme);\n\n  const cases = theme.views ? buildConformanceCases(theme.views) : [];\n  if (cases.length === 0) return [];\n\n  const locale = options.locale ?? 'uk';\n  const themeName = theme.manifest.name;\n  const registeredByKit = ensureRegistered(theme);\n\n  try {\n    for (const item of cases) {\n      for (const state of CONFORMANCE_STATES) {\n        const { error, requisites } = await renderThemeView(\n          item.states[state],\n          theme,\n          locale,\n        );\n\n        if (error !== null) {\n          throw new Error(\n            `[theme:conformance] \"${themeName}\": views.${item.name} впав на ` +\n              `стані \"${state}\": ${describe(error)}`,\n            { cause: error },\n          );\n        }\n\n        if (state !== 'full') continue;\n\n        const missing = REQUIRED_REQUISITES[item.name].filter(\n          (requisite) => !requisites.includes(requisite),\n        );\n        if (missing.length > 0) {\n          throw new Error(\n            `[theme:conformance] \"${themeName}\": views.${item.name} не ` +\n              `розставив обовʼязкові реквізити: ${missing.join(', ')}`,\n          );\n        }\n      }\n    }\n  } finally {\n    if (registeredByKit) ThemeRegistry.unregister(themeName);\n  }\n\n  return cases.map((item) => item.name);\n}\n"]}

package/dist/themes/conformance/render.d.ts

@@ -0,0 +1,21 @@
+import { type ReactElement } from 'react';
+import { type Locale } from 'simplycms/i18n';
+import type { ThemeModule } from '../types';
+export interface ThemeViewRenderResult {
+    /** Помилка рендеру або `null` — view пережив стан. */
+    error: unknown;
+    /** Імена знайдених у DOM маркерів реквізитів (у порядку документа). */
+    requisites: string[];
+}
+/**
+ * Рендер одного view теми в DOM і зняття маркерів реквізитів.
+ *
+ * 🔴 Потрібне DOM-середовище (у vitest — `// @vitest-environment jsdom`):
+ * conformance доводить саме РОЗМІТКУ, тому рендер справжній, а не
+ * серіалізація в рядок. Гард середовища стоїть на публічному вході
+ * (`assertThemeViewsConformance`), щоб автор теми отримав зрозумілу причину
+ * до першого рендеру. `act` тут не з тест-бібліотеки, а з `react` — kit
+ * публікується разом із ядром, і тягнути `@testing-library` у залежності
+ * магазину заради двох рядків було б неспівмірно.
+ */
+export declare function renderThemeView(element: ReactElement, theme: ThemeModule, locale: Locale): Promise<ThemeViewRenderResult>;

package/dist/themes/conformance/stubs.d.ts

@@ -0,0 +1,5 @@
+import { type CartSlots, type CatalogSlots, type HomeSlots, type ProductDetailSlots } from 'simplycms/contracts/views';
+export declare const homeSlotStubs: HomeSlots;
+export declare const catalogSlotStubs: CatalogSlots;
+export declare const productDetailSlotStubs: ProductDetailSlots;
+export declare const cartSlotStubs: CartSlots;

package/dist/themes/index.d.ts

@@ -0,0 +1,7 @@
+export * from './types';
+export { ThemeRegistry, type ThemeLoader } from './ThemeRegistry';
+export { ThemeProvider, useTheme, useThemeSettings } from './ThemeContext';
+export { applyTokens } from './applyTokens';
+export { validateThemeModule, THEME_VIEW_KEYS } from './validateThemeModule';
+export { bootstrapThemes } from './bootstrapThemes';
+export { useThemeT } from './useThemeT';

package/dist/themes/index.js

@@ -0,0 +1,11 @@
+import '../chunk-CTFOP3GR.js';
+export { useThemeT } from '../chunk-QPHGCZ22.js';
+export { ThemeProvider } from '../chunk-4YRIIXCU.js';
+export { applyTokens } from '../chunk-LL6RMSEC.js';
+export { bootstrapThemes } from '../chunk-MCXTDDUI.js';
+export { useTheme, useThemeSettings } from '../chunk-EFLUQ3O7.js';
+export { ThemeRegistry } from '../chunk-QQDFDCU7.js';
+export { THEME_VIEW_KEYS, validateThemeModule } from '../chunk-64LMUHDA.js';
+import '../chunk-PZ5AY32C.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/themes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/themes/safeFontStylesheets.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Відфільтрувати `ThemeModule.fonts` до масиву валідних `https:`-URL
+ * зовнішніх stylesheet-ів (контракт v2.2, Р4).
+ *
+ * Приймає `unknown`, бо `fonts` приходить із зовнішнього пакета теми —
+ * форма не гарантована до валідації. Невалідний запис не валить рендер:
+ * пропускається з попередженням у консоль.
+ *
+ * 🔴 Субшлях-експорт (Р11): цей модуль НЕ реекспортується з barrel-а
+ * `index.ts`. Причина пережила знесення `getActiveThemeSSR` (В2): barrel
+ * тягне `bootstrapThemes` → `simplycms/themes/server`, тобто модуль із
+ * serverFn-ами й серверним auth-контуром за ними. Клієнтський `ThemeFonts`
+ * не має підстав тягнути цей вантаж заради фільтра рядків. Єдиний
+ * дозволений імпорт — `simplycms/themes/safeFontStylesheets`.
+ */
+export declare function safeFontStylesheets(fonts: unknown): string[];

package/dist/themes/safeFontStylesheets.js

@@ -0,0 +1,36 @@
+import '../chunk-PZ5AY32C.js';
+
+// src/themes/safeFontStylesheets.ts
+var UNSAFE_URL = /["'<>\s]/;
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function isSafeHttpsUrl(value) {
+  if (typeof value !== "string" || value.trim() === "") return false;
+  if (UNSAFE_URL.test(value)) return false;
+  try {
+    return new URL(value).protocol === "https:";
+  } catch {
+    return false;
+  }
+}
+function safeFontStylesheets(fonts) {
+  if (!Array.isArray(fonts)) return [];
+  const result = [];
+  for (const entry of fonts) {
+    const stylesheet = isRecord(entry) ? entry.stylesheet : void 0;
+    if (isSafeHttpsUrl(stylesheet)) {
+      result.push(stylesheet);
+    } else {
+      console.warn(
+        "[theme] \u041F\u0440\u043E\u043F\u0443\u0449\u0435\u043D\u043E \u043D\u0435\u0432\u0430\u043B\u0456\u0434\u043D\u0438\u0439 \u0437\u0430\u043F\u0438\u0441 fonts (\u043E\u0447\u0456\u043A\u0443\u0454\u0442\u044C\u0441\u044F https: URL):",
+        entry
+      );
+    }
+  }
+  return result;
+}
+
+export { safeFontStylesheets };
+//# sourceMappingURL=safeFontStylesheets.js.map
+//# sourceMappingURL=safeFontStylesheets.js.map

package/dist/themes/safeFontStylesheets.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/themes/safeFontStylesheets.ts"],"names":[],"mappings":";;;AAOA,IAAM,UAAA,GAAa,UAAA;AAEnB,SAAS,SAAS,KAAA,EAAkD;AAClE,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,IAAY,KAAA,KAAU,IAAA;AAChD;AAGA,SAAS,eAAe,KAAA,EAAiC;AACvD,EAAA,IAAI,OAAO,KAAA,KAAU,QAAA,IAAY,MAAM,IAAA,EAAK,KAAM,IAAI,OAAO,KAAA;AAC7D,EAAA,IAAI,UAAA,CAAW,IAAA,CAAK,KAAK,CAAA,EAAG,OAAO,KAAA;AAEnC,EAAA,IAAI;AACF,IAAA,OAAO,IAAI,GAAA,CAAI,KAAK,CAAA,CAAE,QAAA,KAAa,QAAA;AAAA,EACrC,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,KAAA;AAAA,EACT;AACF;AAiBO,SAAS,oBAAoB,KAAA,EAA0B;AAC5D,EAAA,IAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,SAAU,EAAC;AAEnC,EAAA,MAAM,SAAmB,EAAC;AAE1B,EAAA,KAAA,MAAW,SAAS,KAAA,EAAO;AACzB,IAAA,MAAM,UAAA,GAAa,QAAA,CAAS,KAAK,CAAA,GAC5B,MAAmC,UAAA,GACpC,MAAA;AAEJ,IAAA,IAAI,cAAA,CAAe,UAAU,CAAA,EAAG;AAC9B,MAAA,MAAA,CAAO,KAAK,UAAU,CAAA;AAAA,IACxB,CAAA,MAAO;AACL,MAAA,OAAA,CAAQ,IAAA;AAAA,QACN,6OAAA;AAAA,QACA;AAAA,OACF;AAAA,IACF;AAAA,EACF;AAEA,EAAA,OAAO,MAAA;AACT","file":"safeFontStylesheets.js","sourcesContent":["import type { ThemeFontSource } from './types';\n\n/**\n * Символи, які видають спробу вирватись із значення атрибута `href`\n * (лапки, кутові дужки) чи протягнути пробіл там, де його бути не може.\n * Гігієна проти одруків, не security-межа — теми довірені (Р10 Фази 4).\n */\nconst UNSAFE_URL = /[\"'<>\\s]/;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\n/** Чи є значення валідним абсолютним `https:`-URL без небезпечних символів. */\nfunction isSafeHttpsUrl(value: unknown): value is string {\n  if (typeof value !== 'string' || value.trim() === '') return false;\n  if (UNSAFE_URL.test(value)) return false;\n\n  try {\n    return new URL(value).protocol === 'https:';\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Відфільтрувати `ThemeModule.fonts` до масиву валідних `https:`-URL\n * зовнішніх stylesheet-ів (контракт v2.2, Р4).\n *\n * Приймає `unknown`, бо `fonts` приходить із зовнішнього пакета теми —\n * форма не гарантована до валідації. Невалідний запис не валить рендер:\n * пропускається з попередженням у консоль.\n *\n * 🔴 Субшлях-експорт (Р11): цей модуль НЕ реекспортується з barrel-а\n * `index.ts`. Причина пережила знесення `getActiveThemeSSR` (В2): barrel\n * тягне `bootstrapThemes` → `simplycms/themes/server`, тобто модуль із\n * serverFn-ами й серверним auth-контуром за ними. Клієнтський `ThemeFonts`\n * не має підстав тягнути цей вантаж заради фільтра рядків. Єдиний\n * дозволений імпорт — `simplycms/themes/safeFontStylesheets`.\n */\nexport function safeFontStylesheets(fonts: unknown): string[] {\n  if (!Array.isArray(fonts)) return [];\n\n  const result: string[] = [];\n\n  for (const entry of fonts) {\n    const stylesheet = isRecord(entry)\n      ? (entry as Partial<ThemeFontSource>).stylesheet\n      : undefined;\n\n    if (isSafeHttpsUrl(stylesheet)) {\n      result.push(stylesheet);\n    } else {\n      console.warn(\n        '[theme] Пропущено невалідний запис fonts (очікується https: URL):',\n        entry,\n      );\n    }\n  }\n\n  return result;\n}\n"]}

package/dist/themes/server/index.d.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+/** Імена тем, відомих БД. Публічне читання — грант SELECT має і анонім. */
+export declare const listThemeNames: import("@tanstack/react-start").OptionalFetcher<undefined, undefined, Promise<string[]>>;
+/**
+ * Зареєструвати в БД теми, встановлені пакетами/конфігом.
+ *
+ * 🔴 Право перевіряється ТУТ, із сесії запиту. `is_active` у схемі входу
+ * немає взагалі — його задає сервер: інакше встановлення пакета могло б
+ * мовчки перемкнути вітрину на чужу тему.
+ */
+export declare const registerThemes: import("@tanstack/react-start").RequiredFetcher<undefined, z.ZodObject<{
+    rows: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        display_name: z.ZodString;
+        version: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        author: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, Promise<number>>;

package/dist/themes/server/index.js

@@ -0,0 +1,62 @@
+import '../../chunk-PZ5AY32C.js';
+import { createServerFn } from '@tanstack/react-start';
+import { getRequest } from '@tanstack/react-start/server';
+import { z } from 'zod';
+import { isAdminRequest } from 'simplycms/auth';
+import { asc } from 'drizzle-orm';
+import { themes } from 'simplycms/schema';
+import { withStorefrontDb, withStoreOperatorDb } from 'simplycms/storefront/loaders';
+
+async function selectThemeNames() {
+  const rows = await withStorefrontDb(
+    (db) => db.select({ name: themes.name }).from(themes).orderBy(asc(themes.name))
+  );
+  return rows.map((row) => row.name);
+}
+async function insertMissingThemes(rows, isAdmin) {
+  if (!isAdmin) return -1;
+  if (rows.length === 0) return 0;
+  const known = new Set(await selectThemeNames());
+  const missing = rows.filter((row) => !known.has(row.name));
+  if (missing.length === 0) return 0;
+  await withStoreOperatorDb(
+    (db) => db.insert(themes).values(
+      missing.map((row) => ({
+        name: row.name,
+        displayName: row.display_name,
+        version: row.version,
+        description: row.description,
+        author: row.author,
+        // Активність — рішення адміна в адмінці, а не побічний ефект
+        // встановлення пакета. Крім того, частковий унікальний індекс
+        // `themes_active_idx` не дав би вставити другу активну.
+        isActive: false
+      }))
+    )
+  );
+  return missing.length;
+}
+
+// src/themes/server/index.ts
+var VERSION_MAX = 20;
+var rowSchema = z.object({
+  name: z.string().min(1).max(100),
+  display_name: z.string().min(1).max(100),
+  version: z.string().min(1).max(VERSION_MAX),
+  description: z.string().max(500).nullable(),
+  author: z.string().max(100).nullable()
+});
+var listThemeNames = createServerFn({ method: "GET" }).handler(
+  async () => selectThemeNames()
+);
+var registerThemes = createServerFn({ method: "POST" }).inputValidator(z.object({ rows: z.array(rowSchema).max(50) })).handler(async ({ data: input }) => {
+  const { rows } = input;
+  return insertMissingThemes(
+    rows,
+    await isAdminRequest(getRequest().headers)
+  );
+});
+
+export { listThemeNames, registerThemes };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/themes/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/themes/server/registry-db.ts","../../../src/themes/server/index.ts"],"names":[],"mappings":";;;;;;;;;AAmBA,eAAsB,gBAAA,GAAsC;AAC1D,EAAA,MAAM,OAAO,MAAM,gBAAA;AAAA,IAAiB,CAAC,EAAA,KACnC,EAAA,CAAG,MAAA,CAAO,EAAE,MAAM,MAAA,CAAO,IAAA,EAAM,CAAA,CAAE,KAAK,MAAM,CAAA,CAAE,QAAQ,GAAA,CAAI,MAAA,CAAO,IAAI,CAAC;AAAA,GACxE;AACA,EAAA,OAAO,IAAA,CAAK,GAAA,CAAI,CAAC,GAAA,KAAQ,IAAI,IAAI,CAAA;AACnC;AAcA,eAAsB,mBAAA,CACpB,MACA,OAAA,EACiB;AACjB,EAAA,IAAI,CAAC,SAAS,OAAO,EAAA;AACrB,EAAA,IAAI,IAAA,CAAK,MAAA,KAAW,CAAA,EAAG,OAAO,CAAA;AAE9B,EAAA,MAAM,KAAA,GAAQ,IAAI,GAAA,CAAI,MAAM,kBAAkB,CAAA;AAC9C,EAAA,MAAM,OAAA,GAAU,IAAA,CAAK,MAAA,CAAO,CAAC,GAAA,KAAQ,CAAC,KAAA,CAAM,GAAA,CAAI,GAAA,CAAI,IAAI,CAAC,CAAA;AACzD,EAAA,IAAI,OAAA,CAAQ,MAAA,KAAW,CAAA,EAAG,OAAO,CAAA;AAEjC,EAAA,MAAM,mBAAA;AAAA,IAAoB,CAAC,EAAA,KACzB,EAAA,CAAG,MAAA,CAAO,MAAM,CAAA,CAAE,MAAA;AAAA,MAChB,OAAA,CAAQ,GAAA,CAAI,CAAC,GAAA,MAAS;AAAA,QACpB,MAAM,GAAA,CAAI,IAAA;AAAA,QACV,aAAa,GAAA,CAAI,YAAA;AAAA,QACjB,SAAS,GAAA,CAAI,OAAA;AAAA,QACb,aAAa,GAAA,CAAI,WAAA;AAAA,QACjB,QAAQ,GAAA,CAAI,MAAA;AAAA;AAAA;AAAA;AAAA,QAIZ,QAAA,EAAU;AAAA,OACZ,CAAE;AAAA;AACJ,GACF;AAEA,EAAA,OAAO,OAAA,CAAQ,MAAA;AACjB;;;AClDA,IAAM,WAAA,GAAc,EAAA;AAEpB,IAAM,SAAA,GAAY,EAAE,MAAA,CAAO;AAAA,EACzB,IAAA,EAAM,EAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA,CAAE,IAAI,GAAG,CAAA;AAAA,EAC/B,YAAA,EAAc,EAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA,CAAE,IAAI,GAAG,CAAA;AAAA,EACvC,OAAA,EAAS,EAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA,CAAE,IAAI,WAAW,CAAA;AAAA,EAC1C,aAAa,CAAA,CAAE,MAAA,GAAS,GAAA,CAAI,GAAG,EAAE,QAAA,EAAS;AAAA,EAC1C,QAAQ,CAAA,CAAE,MAAA,GAAS,GAAA,CAAI,GAAG,EAAE,QAAA;AAC9B,CAAC,CAAA;AAGM,IAAM,iBAAiB,cAAA,CAAe,EAAE,MAAA,EAAQ,KAAA,EAAO,CAAA,CAAE,OAAA;AAAA,EAC9D,YAA+B,gBAAA;AACjC;AASO,IAAM,cAAA,GAAiB,cAAA,CAAe,EAAE,MAAA,EAAQ,MAAA,EAAQ,CAAA,CAC5D,cAAA,CAAe,CAAA,CAAE,MAAA,CAAO,EAAE,IAAA,EAAM,CAAA,CAAE,KAAA,CAAM,SAAS,CAAA,CAAE,GAAA,CAAI,EAAE,CAAA,EAAG,CAAC,CAAA,CAC7D,OAAA,CAAQ,OAAO,EAAE,IAAA,EAAM,KAAA,EAAM,KAAuB;AACnD,EAAA,MAAM,EAAE,MAAK,GAAI,KAAA;AACjB,EAAA,OAAO,mBAAA;AAAA,IACL,IAAA;AAAA,IACA,MAAM,cAAA,CAAe,UAAA,EAAW,CAAE,OAAO;AAAA,GAC3C;AACF,CAAC","file":"index.js","sourcesContent":["import { asc } from 'drizzle-orm';\nimport { themes } from 'simplycms/schema';\nimport {\n  withStorefrontDb,\n  withStoreOperatorDb,\n} from 'simplycms/storefront/loaders';\nimport type { ThemeBootstrapRow } from '../types';\n\n/**\n * Доступ до таблиці `themes` для bootstrap-у — ЗВИЧАЙНІ функції (B9/В2).\n *\n * 🔴 Модуль навмисно окремий від `./index`, де живуть serverFn-обгортки.\n * Трансформація TanStack Start вирізає з клієнтського бандла тіла хендлерів\n * разом із їхніми імпортами; живий не-serverFn експорт поруч затягнув би\n * сюди пул Postgres (той самий урок, що дав `storefront-routes/server/is-admin`).\n * Тести теж імпортують саме звідси: контексту `createServerFn` у них немає.\n */\n\n/** Імена тем, уже відомі БД. Читає роль `app_user` — грант SELECT є у всіх. */\nexport async function selectThemeNames(): Promise<string[]> {\n  const rows = await withStorefrontDb((db) =>\n    db.select({ name: themes.name }).from(themes).orderBy(asc(themes.name)),\n  );\n  return rows.map((row) => row.name);\n}\n\n/**\n * Дописати рядки тем, яких у БД ще немає.\n *\n * 🔴 `isAdmin` рахує СЕРВЕР (`isAdminRequest` у обгортці), а не клієнт:\n * прапорець `canWrite` у браузері лише економить зайвий виклик, довіряти\n * йому не можна за побудовою. Грант INSERT на `themes` має тільки\n * `app_admin`, тож без цієї перевірки транзакція впала б «permission denied» —\n * але впала б ПІСЛЯ того, як хендлер уже пустив чужий запит у БД.\n *\n * Повертає кількість вставлених рядків; `-1` — відмова доступу (виклик\n * приходить із bootstrap-у в ефекті, тож кидати назовні тут нічого).\n */\nexport async function insertMissingThemes(\n  rows: readonly ThemeBootstrapRow[],\n  isAdmin: boolean,\n): Promise<number> {\n  if (!isAdmin) return -1;\n  if (rows.length === 0) return 0;\n\n  const known = new Set(await selectThemeNames());\n  const missing = rows.filter((row) => !known.has(row.name));\n  if (missing.length === 0) return 0;\n\n  await withStoreOperatorDb((db) =>\n    db.insert(themes).values(\n      missing.map((row) => ({\n        name: row.name,\n        displayName: row.display_name,\n        version: row.version,\n        description: row.description,\n        author: row.author,\n        // Активність — рішення адміна в адмінці, а не побічний ефект\n        // встановлення пакета. Крім того, частковий унікальний індекс\n        // `themes_active_idx` не дав би вставити другу активну.\n        isActive: false,\n      })),\n    ),\n  );\n\n  return missing.length;\n}\n","import { createServerFn } from '@tanstack/react-start';\nimport { getRequest } from '@tanstack/react-start/server';\nimport { z } from 'zod';\nimport { isAdminRequest } from 'simplycms/auth';\nimport { insertMissingThemes, selectThemeNames } from './registry-db';\n\n/**\n * Серверна поверхня реєстру тем (B9/В2): рівно два `createServerFn` і НІ\n * ОДНОГО звичайного експорту.\n *\n * 🔴 Це не стиль. Модуль імпортує клієнтський `bootstrapThemes`, а Start\n * вирізає з браузерного бандла лише ТІЛА хендлерів; будь-який живий символ\n * поруч тримав би живим `./registry-db`, а з ним — пул Postgres.\n */\n\n/** Ліміт колонки `themes.version` — varchar(20) (`schema/schema.ts`). */\nconst VERSION_MAX = 20;\n\nconst rowSchema = z.object({\n  name: z.string().min(1).max(100),\n  display_name: z.string().min(1).max(100),\n  version: z.string().min(1).max(VERSION_MAX),\n  description: z.string().max(500).nullable(),\n  author: z.string().max(100).nullable(),\n});\n\n/** Імена тем, відомих БД. Публічне читання — грант SELECT має і анонім. */\nexport const listThemeNames = createServerFn({ method: 'GET' }).handler(\n  async (): Promise<string[]> => selectThemeNames(),\n);\n\n/**\n * Зареєструвати в БД теми, встановлені пакетами/конфігом.\n *\n * 🔴 Право перевіряється ТУТ, із сесії запиту. `is_active` у схемі входу\n * немає взагалі — його задає сервер: інакше встановлення пакета могло б\n * мовчки перемкнути вітрину на чужу тему.\n */\nexport const registerThemes = createServerFn({ method: 'POST' })\n  .inputValidator(z.object({ rows: z.array(rowSchema).max(50) }))\n  .handler(async ({ data: input }): Promise<number> => {\n    const { rows } = input as { rows: z.output<typeof rowSchema>[] };\n    return insertMissingThemes(\n      rows,\n      await isAdminRequest(getRequest().headers),\n    );\n  });\n"]}

package/dist/themes/server/registry-db.d.ts

@@ -0,0 +1,25 @@
+import type { ThemeBootstrapRow } from '../types';
+/**
+ * Доступ до таблиці `themes` для bootstrap-у — ЗВИЧАЙНІ функції (B9/В2).
+ *
+ * 🔴 Модуль навмисно окремий від `./index`, де живуть serverFn-обгортки.
+ * Трансформація TanStack Start вирізає з клієнтського бандла тіла хендлерів
+ * разом із їхніми імпортами; живий не-serverFn експорт поруч затягнув би
+ * сюди пул Postgres (той самий урок, що дав `storefront-routes/server/is-admin`).
+ * Тести теж імпортують саме звідси: контексту `createServerFn` у них немає.
+ */
+/** Імена тем, уже відомі БД. Читає роль `app_user` — грант SELECT є у всіх. */
+export declare function selectThemeNames(): Promise<string[]>;
+/**
+ * Дописати рядки тем, яких у БД ще немає.
+ *
+ * 🔴 `isAdmin` рахує СЕРВЕР (`isAdminRequest` у обгортці), а не клієнт:
+ * прапорець `canWrite` у браузері лише економить зайвий виклик, довіряти
+ * йому не можна за побудовою. Грант INSERT на `themes` має тільки
+ * `app_admin`, тож без цієї перевірки транзакція впала б «permission denied» —
+ * але впала б ПІСЛЯ того, як хендлер уже пустив чужий запит у БД.
+ *
+ * Повертає кількість вставлених рядків; `-1` — відмова доступу (виклик
+ * приходить із bootstrap-у в ефекті, тож кидати назовні тут нічого).
+ */
+export declare function insertMissingThemes(rows: readonly ThemeBootstrapRow[], isAdmin: boolean): Promise<number>;

package/dist/themes/theme-context.d.ts

@@ -0,0 +1,13 @@
+import type { ThemeContextType } from './types';
+/**
+ * Обʼєкт React-контексту теми — НАВМИСНО окремим модулем від провайдера.
+ *
+ * `ThemeContext.tsx` тягне supabase-клієнт (провайдер читає активну тему з
+ * БД), а conformance-kit (`simplycms/themes/conformance`) мусить підставити
+ * значення контексту БЕЗ БД — рендер на фікстурах. Спільний модуль
+ * гарантує, що обидва боки бачать ОДИН і той самий обʼєкт контексту: два
+ * `createContext` дали б view теми `null` замість налаштувань.
+ */
+export declare const ThemeContext: import("react").Context<ThemeContextType | null>;
+export declare function useTheme(): ThemeContextType;
+export declare function useThemeSettings<T = unknown>(key: string): T | undefined;

package/dist/themes/theme-settings.d.ts

@@ -0,0 +1,10 @@
+import type { ThemeSettingDefinition } from './types';
+/**
+ * Default-значення налаштувань теми зі СХЕМИ (`ThemeModule.settings`).
+ *
+ * Єдина реалізація на два споживачі: `ThemeProvider` кладе поверх них
+ * збережене в БД (`{ ...default, ...saved }`), conformance-kit рендерить
+ * view теми рівно на цих default-ах — без БД. Дубль цієї петлі означав би
+ * два різні уявлення про «значення за замовчуванням».
+ */
+export declare function resolveDefaultThemeSettings(definitions: Record<string, ThemeSettingDefinition> | undefined): Record<string, unknown>;