@laconius/cms 0.1.0

package/lib/typescript/src/defaults.d.ts

@@ -0,0 +1,64 @@
+import { type MediaContainer } from '@laconius/core';
+import { type StyleProp, type TextStyle, type ViewStyle } from 'react-native';
+import type { CmsLinkTarget, CmsNavigationNode } from './models.js';
+/**
+ * Where a CMS link goes. No Laconius package imports `expo-router` or navigates
+ * ([chapter 01](../../../docs/spec/01-packages.md)), so the app hands the engine one function and
+ * keeps its own routing.
+ */
+export declare function useCmsNavigate(): (target: CmsLinkTarget | undefined) => void;
+/** HTML with no DOM: the configured renderer, or tags stripped to a `<Text>`. */
+export declare function CmsHtml({ html, style }: {
+    html?: string;
+    style?: StyleProp<TextStyle>;
+}): import("react").JSX.Element | null;
+export type BannerProps = {
+    title?: string;
+    subtitle?: string;
+    media?: MediaContainer;
+    onPress?: () => void;
+    style?: StyleProp<ViewStyle>;
+    styles?: {
+        container?: StyleProp<ViewStyle>;
+        title?: StyleProp<TextStyle>;
+    };
+};
+export declare function Banner({ title, subtitle, media, onPress, style, styles }: BannerProps): import("react").JSX.Element;
+export type LinkProps = {
+    label: string;
+    onPress?: () => void;
+    style?: StyleProp<ViewStyle>;
+};
+export declare function Link({ label, onPress, style }: LinkProps): import("react").JSX.Element;
+export type ParagraphProps = {
+    title?: string;
+    /** HTML, as OCC stores it. */
+    content?: string;
+    style?: StyleProp<ViewStyle>;
+};
+export declare function Paragraph({ title, content, style }: ParagraphProps): import("react").JSX.Element;
+export type NavigationListProps = {
+    node?: CmsNavigationNode;
+    onSelect?: (node: CmsNavigationNode) => void;
+    style?: StyleProp<ViewStyle>;
+};
+/**
+ * One level of a navigation tree. Deeper trees are app chrome — a drawer, a tab bar — built from
+ * `useCmsNavigation(uid)`, which is why this default stays a flat list.
+ */
+export declare function NavigationList({ node, onSelect, style }: NavigationListProps): import("react").JSX.Element | null;
+export type CarouselProps<T> = {
+    items: T[];
+    renderItem: (item: T, index: number) => React.ReactElement | null;
+    itemWidth?: number;
+    title?: string;
+    style?: StyleProp<ViewStyle>;
+};
+/** A horizontal `FlatList` with snapping. The first thing to cut if it proves expensive. */
+export declare function Carousel<T>({ items, renderItem, itemWidth, title, style }: CarouselProps<T>): import("react").JSX.Element;
+export declare function CmsBanner(): import("react").JSX.Element;
+export declare function CmsLink(): import("react").JSX.Element;
+export declare function CmsParagraph(): import("react").JSX.Element;
+export declare function CmsNavigation(): import("react").JSX.Element;
+export declare function CmsBannerCarousel(): import("react").JSX.Element | null;
+//# sourceMappingURL=defaults.d.ts.map

package/lib/typescript/src/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../src/defaults.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGxE,OAAO,EAKL,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAIV,aAAa,EAEb,iBAAiB,EAElB,MAAM,aAAU,CAAC;AAYlB;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,KAAK,IAAI,CAc5E;AAED,iFAAiF;AACjF,wBAAgB,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAA;CAAE,sCAMvF;AAID,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAA;KAAE,CAAC;CAC7E,CAAC;AAEF,wBAAgB,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,WAAW,+BAmBrF;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B,CAAC;AAEF,wBAAgB,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,SAAS,+BAaxD;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B,CAAC;AAEF,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,cAAc,+BAQlE;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC7C,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,mBAAmB,sCAe5E;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAC7B,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B,CAAC;AAEF,4FAA4F;AAC5F,wBAAgB,QAAQ,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC,+BA0B3F;AAID,wBAAgB,SAAS,gCAaxB;AAED,wBAAgB,OAAO,gCAWtB;AAED,wBAAgB,YAAY,gCAI3B;AAED,wBAAgB,aAAa,gCAU5B;AAeD,wBAAgB,iBAAiB,uCAYhC"}

package/lib/typescript/src/index.d.ts

@@ -0,0 +1,8 @@
+export { HOME_PAGE_CONTEXT, type CmsBannerData, type CmsCarouselData, type CmsComponent, type CmsLinkData, type CmsLinkTarget, type CmsNavigationData, type CmsNavigationNode, type CmsPageStructure, type CmsParagraphData, type CmsStructure, type ContentSlot, type ContentSlotComponent, type PageContext, type PageType, } from './models.js';
+export { getComponentKey, normalizeCmsPage, resolveLinkTarget, stripHtml, type OccCmsPage, } from './normalizer.js';
+export { MAX_COMPONENTS_PER_REQUEST, defaultCmsAdapter, defaultCmsConverters, loadCmsComponent, type CmsAdapter, } from './adapter.js';
+export { cmsQueries, useCmsComponent, useCmsNavigation, useCmsPage, } from './queries.js';
+export { CmsComponentByUid, CmsComponentOutlet, CmsPage, CmsPageProvider, CmsSlot, useCmsComponentData, useCmsComponentUid, useCmsPageStructure, type CmsPageProps, type CmsPageProviderProps, type CmsSlotProps, } from './page.js';
+export { Banner, Carousel, CmsBanner, CmsBannerCarousel, CmsHtml, CmsLink, CmsNavigation, CmsParagraph, Link, NavigationList, Paragraph, useCmsNavigate, type BannerProps, type CarouselProps, type LinkProps, type NavigationListProps, type ParagraphProps, } from './defaults.js';
+export { defaultCmsComponents, defaultCmsConfig, defaultCmsEndpoints, defaultCmsLayouts, type CmsComponentMapping, } from './config.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,QAAQ,GACd,MAAM,aAAU,CAAC;AAElB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,EACT,KAAK,UAAU,GAChB,MAAM,iBAAc,CAAC;AAEtB,OAAO,EACL,0BAA0B,EAC1B,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,UAAU,GAChB,MAAM,cAAW,CAAC;AAEnB,OAAO,EACL,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,UAAU,GACX,MAAM,cAAW,CAAC;AAEnB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,OAAO,EACP,eAAe,EACf,OAAO,EACP,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,YAAY,GAClB,MAAM,WAAQ,CAAC;AAEhB,OAAO,EACL,MAAM,EACN,QAAQ,EACR,SAAS,EACT,iBAAiB,EACjB,OAAO,EACP,OAAO,EACP,aAAa,EACb,YAAY,EACZ,IAAI,EACJ,cAAc,EACd,SAAS,EACT,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACpB,MAAM,eAAY,CAAC;AAEpB,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,mBAAmB,GACzB,MAAM,aAAU,CAAC"}

package/lib/typescript/src/models.d.ts

@@ -0,0 +1,123 @@
+import type { MediaContainer } from '@laconius/core';
+/**
+ * CMS models, ported from Spartacus `core-libs/core/src/model/cms.model.ts` and
+ * `core-libs/core/src/cms/model/*` (Apache-2.0, see NOTICE). Divergences:
+ * - `enum` becomes a string union, so this module emits nothing at runtime.
+ * - `CmsStructure.components` is a record keyed by `uid`, not an array: Laconius looks components
+ *   up by uid at render time instead of feeding an NgRx entity reducer.
+ * - `robots` and the rest of the SEO emitters are dropped ([chapter 06](../../../docs/spec/06-cms-engine.md)).
+ */
+export type PageType = 'ContentPage' | 'ProductPage' | 'CategoryPage' | 'CatalogPage';
+/** The sentinel the backend answers to for the base site's homepage. */
+export declare const HOME_PAGE_CONTEXT = "__HOMEPAGE__";
+/** What identifies a page to OCC: a content-page label, or a product / category code. */
+export type PageContext = {
+    id: string;
+    type?: PageType;
+};
+/** The component reference a slot carries. `key` is the *computed* registry key. */
+export type ContentSlotComponent = {
+    uid: string;
+    typeCode?: string;
+    /** `flexType` for `CMSFlexComponent`, `uid` for `JspIncludeComponent`, else `typeCode`. */
+    key: string;
+    properties?: Record<string, unknown>;
+};
+export type ContentSlot = {
+    position: string;
+    properties?: Record<string, unknown>;
+    components: ContentSlotComponent[];
+};
+export type CmsPageStructure = {
+    pageId?: string;
+    name?: string;
+    type?: string;
+    label?: string;
+    template?: string;
+    title?: string;
+    description?: string;
+    properties?: Record<string, unknown>;
+    /** Keyed by position. Order here is backend order — the warned fallback, not the contract. */
+    slots: Record<string, ContentSlot>;
+};
+/** What the page endpoint normalizes to: the structure plus whatever component data came inlined. */
+export type CmsStructure = {
+    page: CmsPageStructure;
+    components: Record<string, CmsComponent>;
+};
+/** Every component payload carries these; the rest is per type. */
+export interface CmsComponent {
+    uid?: string;
+    typeCode?: string;
+    name?: string;
+    modifiedTime?: string;
+    container?: string;
+    styleClasses?: string;
+    composition?: {
+        inner?: string[];
+    };
+    [key: string]: unknown;
+}
+export interface CmsLinkData extends CmsComponent {
+    linkName?: string;
+    url?: string;
+    external?: string | boolean;
+    contentPage?: string;
+    contentPageLabelOrId?: string;
+    target?: string | boolean;
+}
+export interface CmsBannerData extends CmsComponent {
+    headline?: string;
+    content?: string;
+    /** A single image, or a group keyed by format code. Absolutised on the way in. */
+    media?: MediaContainer;
+    urlLink?: string;
+    external?: string | boolean;
+    contentPage?: string;
+    product?: string;
+    category?: string;
+}
+export interface CmsParagraphData extends CmsComponent {
+    title?: string;
+    /** HTML. Stripped to plain text unless `cms.htmlRenderer` is configured. */
+    content?: string;
+}
+export interface CmsNavigationNode {
+    uid?: string;
+    title?: string;
+    children?: CmsNavigationNode[];
+    entries?: {
+        itemId?: string;
+        itemSuperType?: string;
+        itemType?: string;
+    }[];
+}
+export interface CmsNavigationData extends CmsComponent {
+    navigationNode?: CmsNavigationNode;
+    styleClass?: string;
+    wrapAfter?: string;
+}
+/** `RotatingImagesComponent`: a space-separated list of banner uids. */
+export interface CmsCarouselData extends CmsComponent {
+    banners?: string;
+    effect?: string;
+}
+/**
+ * Where a CMS link points, resolved from the four mutually exclusive fields OCC uses. Laconius
+ * hands this to `cms.onNavigate`; no Laconius package navigates ([chapter 01](../../../docs/spec/01-packages.md)).
+ */
+export type CmsLinkTarget = {
+    kind: 'url';
+    url: string;
+    external: boolean;
+} | {
+    kind: 'contentPage';
+    label: string;
+} | {
+    kind: 'product';
+    code: string;
+} | {
+    kind: 'category';
+    code: string;
+};
+//# sourceMappingURL=models.d.ts.map

package/lib/typescript/src/models.d.ts.map

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

package/lib/typescript/src/normalizer.d.ts

@@ -0,0 +1,70 @@
+import type { CmsLinkTarget, CmsStructure } from './models.js';
+/**
+ * The registry key, **computed** — not `typeCode`
+ * (`core-libs/core/src/occ/adapters/cms/converters/occ-cms-page-normalizer.ts:151`). Miss this and
+ * every account page renders blank, because those pages are all `CMSFlexComponent`.
+ */
+export declare function getComponentKey(component: {
+    typeCode?: string;
+    flexType?: string;
+    uid?: string;
+}): string;
+type OccComponent = {
+    uid?: string;
+    typeCode?: string;
+    flexType?: string;
+    properties?: Record<string, unknown>;
+    modifiedtime?: string;
+    modifiedTime?: string;
+    [key: string]: unknown;
+};
+type OccSlot = {
+    position?: string;
+    properties?: Record<string, unknown>;
+    components?: {
+        component?: OccComponent | OccComponent[];
+    };
+};
+export type OccCmsPage = {
+    uid?: string;
+    name?: string;
+    typeCode?: string;
+    label?: string;
+    template?: string;
+    title?: string;
+    description?: string;
+    properties?: Record<string, unknown>;
+    contentSlots?: {
+        contentSlot?: OccSlot | OccSlot[];
+    };
+};
+/**
+ * Flattens the OCC page payload into `{ page, components }`.
+ *
+ * Slot *order* here is backend order, which the layout config overrides
+ * ([chapter 06](../../../docs/spec/06-cms-engine.md)). Component `properties` stay on the slot
+ * entry and are stripped from the component payload, as in Spartacus.
+ */
+export declare function normalizeCmsPage(source: OccCmsPage | undefined): CmsStructure;
+/**
+ * The four mutually exclusive link fields OCC uses, in Spartacus' own precedence
+ * (`cms-components/content/banner/banner.component.ts:64`). `external` arrives as the string
+ * `'true'` about as often as a boolean.
+ */
+export declare function resolveLinkTarget(data: {
+    url?: string;
+    urlLink?: string;
+    external?: string | boolean;
+    contentPage?: string;
+    contentPageLabelOrId?: string;
+    product?: string;
+    category?: string;
+}): CmsLinkTarget | undefined;
+/**
+ * The default HTML story: strip tags, decode the five named entities OCC actually emits, collapse
+ * whitespace. Laconius ships no parser — rich text is `cms.htmlRenderer`
+ * ([chapter 06](../../../docs/spec/06-cms-engine.md)).
+ */
+export declare function stripHtml(html: string | undefined): string;
+export {};
+//# sourceMappingURL=normalizer.d.ts.map

package/lib/typescript/src/normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../../../src/normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,aAAa,EACb,YAAY,EAGb,MAAM,aAAU,CAAC;AAKlB;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAIT;AAED,KAAK,YAAY,GAAG;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,KAAK,OAAO,GAAG;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,UAAU,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,YAAY,GAAG,YAAY,EAAE,CAAA;KAAE,CAAC;CAC5D,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,YAAY,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,CAAA;KAAE,CAAC;CACtD,CAAC;AAOF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,YAAY,CA8C7E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,aAAa,GAAG,SAAS,CAU5B;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAc1D"}

package/lib/typescript/src/page.d.ts

@@ -0,0 +1,62 @@
+import { type ReactNode } from 'react';
+import { type StyleProp, type ViewStyle } from 'react-native';
+import type { CmsComponent, CmsStructure, ContentSlotComponent, PageContext } from './models.js';
+type PageValue = {
+    structure: CmsStructure;
+    context: PageContext;
+};
+/**
+ * The whole component contract: typed data through a hook, never props
+ * ([ADR-0007](../../../docs/adr/0007-two-registries-two-contracts.md)). Props would make a
+ * registered replacement depend on what Laconius happens to pass it, and substitutability dies.
+ */
+export declare function useCmsComponentData<T extends CmsComponent>(): T;
+/** The uid of the component being rendered, for components that key their own state on it. */
+export declare function useCmsComponentUid(): string;
+/** The page a `<CmsSlot>` reads from, and the context its components are scoped to. */
+export declare function useCmsPageStructure(): PageValue | undefined;
+export type CmsPageProviderProps = {
+    context: PageContext;
+    children: ReactNode;
+};
+/**
+ * Fetches a page and provides it to the `<CmsSlot>`s inside. Suspends: wrap it in `<Suspense>`
+ * and an error boundary.
+ *
+ * A native screen that only *hosts* CMS slots — a PDP, the cart — mounts this around its own
+ * layout and places slots where it wants them.
+ */
+export declare function CmsPageProvider({ context, children }: CmsPageProviderProps): import("react").JSX.Element;
+export type CmsSlotProps = {
+    position: string;
+    style?: StyleProp<ViewStyle>;
+    /** Rendered when the slot is absent or empty. */
+    fallback?: ReactNode;
+};
+export declare function CmsSlot({ position, style, fallback }: CmsSlotProps): import("react").JSX.Element;
+export type CmsPageProps = {
+    /** A content-page label, e.g. `/about-us`. Passed as a prop: no Laconius package routes. */
+    pageLabel?: string;
+    /** For a page that is not a content page. Takes precedence over `pageLabel`. */
+    context?: PageContext;
+    style?: StyleProp<ViewStyle>;
+    slotStyle?: StyleProp<ViewStyle>;
+};
+/**
+ * A whole page, top to bottom, in the slot order of `cms.layouts[template]`. It renders no scroll
+ * container: the screen owns scrolling, safe areas and refresh control.
+ */
+export declare function CmsPage({ pageLabel, context, style, slotStyle }: CmsPageProps): import("react").JSX.Element;
+/** Renders one slot entry through the registry, loading its data if the page did not inline it. */
+export declare function CmsComponentOutlet({ entry }: {
+    entry: ContentSlotComponent;
+}): import("react").JSX.Element | null;
+/**
+ * Renders a component addressed only by uid — what a carousel does with the banner uids it holds.
+ * The registry key comes from the loaded payload, not from a slot entry.
+ */
+export declare function CmsComponentByUid({ uid }: {
+    uid: string;
+}): import("react").JSX.Element | null;
+export {};
+//# sourceMappingURL=page.d.ts.map

package/lib/typescript/src/page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../../src/page.tsx"],"names":[],"mappings":"AACA,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3E,OAAO,EAA0B,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAEtF,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,WAAW,EACZ,MAAM,aAAU,CAAC;AAYlB,KAAK,SAAS,GAAG;IAAE,SAAS,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC;AAOnE;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,YAAY,KAAK,CAAC,CAQ/D;AAED,8FAA8F;AAC9F,wBAAgB,kBAAkB,IAAI,MAAM,CAQ3C;AAED,uFAAuF;AACvF,wBAAgB,mBAAmB,IAAI,SAAS,GAAG,SAAS,CAE3D;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,SAAS,CAAC;CACrB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,oBAAoB,+BAI1E;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,CAAC;AAEF,wBAAgB,OAAO,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAe,EAAE,EAAE,YAAY,+BAmBzE;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,4FAA4F;IAC5F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAClC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,OAAO,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,YAAY,+BAU7E;AAgCD,mGAAmG;AACnG,wBAAgB,kBAAkB,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,oBAAoB,CAAA;CAAE,sCAoB5E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,GAAG,EAAE,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,sCAOzD"}

package/lib/typescript/src/queries.d.ts

@@ -0,0 +1,193 @@
+import type { CmsComponent, CmsNavigationData, PageContext } from './models.js';
+/**
+ * `queryOptions` factories, so an app can `prefetchQuery` a page without forking Laconius.
+ *
+ * The page key is **per page**, deliberately unlike Spartacus, which collapses every content page
+ * under one `ContentPage` key (`core-libs/core/src/cms/utils/cms-utils.ts:29-31`).
+ */
+export declare const cmsQueries: {
+    page: (context: PageContext) => import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<import("./models.js").CmsStructure, Error, import("./models.js").CmsStructure, unknown[]>, "queryFn"> & {
+        queryFn?: import("@tanstack/react-query").QueryFunction<import("./models.js").CmsStructure, unknown[], never> | undefined;
+    } & import("@tanstack/react-query").QueryKeyWithDataTag<unknown[], import("./models.js").CmsStructure, Error>;
+    component: (uid: string, context?: PageContext) => import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<CmsComponent, Error, CmsComponent, unknown[]>, "queryFn"> & {
+        queryFn?: import("@tanstack/react-query").QueryFunction<CmsComponent, unknown[], never> | undefined;
+    } & import("@tanstack/react-query").QueryKeyWithDataTag<unknown[], CmsComponent, Error>;
+};
+/**
+ * Suspends. There is no blocking guard: Spartacus' `CmsPageGuard` becomes a non-blocking fetch
+ * plus a suspending screen, so the native chrome is on screen while the page loads.
+ */
+export declare function useCmsPage(context: PageContext): import("@tanstack/react-query").UseSuspenseQueryResult<import("./models.js").CmsStructure, Error>;
+/** One component by uid. Requests made in the same frame go out as one batched call. */
+export declare function useCmsComponent<T extends CmsComponent>(uid: string, options?: {
+    context?: PageContext;
+    enabled?: boolean;
+}): import("@tanstack/react-query").UseQueryResult<T, Error>;
+/**
+ * The `navigationNode` tree of a `NavigationComponent` / `FooterNavigationComponent` /
+ * `CategoryNavigationComponent`, for apps rendering their own chrome from CMS navigation.
+ */
+export declare function useCmsNavigation(uid: string): {
+    node: import("./models.js").CmsNavigationNode | undefined;
+    data: CmsNavigationData;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: true;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<CmsNavigationData, Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+} | {
+    node: import("./models.js").CmsNavigationNode | undefined;
+    data: CmsNavigationData;
+    error: null;
+    isError: false;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: false;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<CmsNavigationData, Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+} | {
+    node: import("./models.js").CmsNavigationNode | undefined;
+    data: undefined;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: true;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<CmsNavigationData, Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+} | {
+    node: import("./models.js").CmsNavigationNode | undefined;
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoading: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<CmsNavigationData, Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+} | {
+    node: import("./models.js").CmsNavigationNode | undefined;
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isLoading: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<CmsNavigationData, Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+} | {
+    node: import("./models.js").CmsNavigationNode | undefined;
+    data: CmsNavigationData;
+    isError: false;
+    error: null;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: true;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<CmsNavigationData, Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+};
+//# sourceMappingURL=queries.d.ts.map

package/lib/typescript/src/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../../src/queries.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAU,CAAC;AAE7E;;;;;GAKG;AACH,eAAO,MAAM,UAAU;oBACL,WAAW;;;qBAQV,MAAM,YAAY,WAAW;;;CAK/C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,qGAE9C;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,CAAC,SAAS,YAAY,EACpD,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,WAAW,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,4DAO3D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAG3C"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@laconius/cms",
+  "version": "0.1.0",
+  "description": "Laconius CMS engine: page and component queries, the component registry, <CmsPage> / <CmsSlot>, useCmsComponentData and the content defaults.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "!**/*.test.*"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@laconius/core": "0.1.0",
+    "@laconius/ui": "0.1.0",
+    "@tanstack/react-query": "^5",
+    "react": ">=19.0.0",
+    "react-native": "*"
+  },
+  "devDependencies": {
+    "@laconius/core": "0.1.0",
+    "@laconius/ui": "0.1.0",
+    "@tanstack/react-query": "^5.102.8",
+    "@types/react": "~19.2.2",
+    "react": "19.2.3",
+    "react-native": "0.86.3",
+    "react-native-builder-bob": "^0.43.0",
+    "typescript": "~6.0.3",
+    "vitest": "^3.2.4"
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ],
+    "exclude": "**/*.test.{ts,tsx}"
+  },
+  "scripts": {
+    "build": "bob build",
+    "clean": "rm -rf lib",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}