@olonjs/core 1.1.10 → 1.1.12

package/dist/index.d.ts

@@ -50,6 +50,8 @@ declare interface AdminSidebarProps {
     };
     /** All sections (header + page sections + footer) for resolving modal section data. */
     allSectionsData?: Section[];
+    collections?: JsonPagesConfig['collections'];
+    collectionSource?: string;
     onUpdate: (newData: Record<string, unknown>) => void;
     /** Update a section by id/scope (e.g. from settings modal). When provided with allSectionsData, gear opens modal. */
     onUpdateSection?: OnUpdateSection;
@@ -98,6 +100,11 @@ declare interface AdminSidebarProps {
     onPageChange?: (slug: string) => void;
 }
 
+declare function applyCollectionRefBindingsToDraft(authoredSectionData: unknown, nextData: Record<string, unknown>, collectionsDraft: JsonPagesConfig['collections'] | undefined, collectionContext?: CollectionResolutionContext | null, collectionSchemas?: JsonPagesConfig['collectionSchemas']): {
+    normalizedData: Record<string, unknown>;
+    collectionsDraft: JsonPagesConfig['collections'];
+};
+
 export declare function applyMenuRefBindingsToDraft(authoredSectionData: unknown, nextData: Record<string, unknown>, menuDraft: MenuConfig): {
     normalizedData: Record<string, unknown>;
     menuDraft: MenuConfig;
@@ -137,6 +144,14 @@ export declare const BaseArrayItem: z.ZodObject<{
     id?: string | undefined;
 }>;
 
+export declare const BaseCollectionItem: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+
 export declare interface BaseSection<K extends keyof SectionDataRegistry> {
     id: string;
     type: K;
@@ -231,6 +246,32 @@ export declare function buildWebMcpToolName(): string;
 
 export declare function cn(...inputs: ClassValue[]): string;
 
+export declare type CollectionDocument<TItem = CollectionItem> = Record<string, TItem>;
+
+declare type CollectionDocuments = NonNullable<JsonPagesConfig['collections']>;
+
+export declare interface CollectionItem {
+    id: string;
+}
+
+export declare interface CollectionItemRegistry {
+}
+
+declare interface CollectionRefBinding {
+    fieldKey: string;
+    source: string;
+    itemId?: string;
+}
+
+declare interface CollectionResolutionContext {
+    source: string;
+    paramKey: string;
+    paramValue: string;
+    currentItem: unknown;
+}
+
+export declare type CollectionType = keyof CollectionItemRegistry extends never ? string : keyof CollectionItemRegistry;
+
 export declare interface ConfigContextValue {
     registry: Registry;
     schemas: Schemas;
@@ -251,13 +292,18 @@ export declare namespace contract {
         BaseSectionSettings,
         SectionDataRegistry,
         SectionSettingsRegistry,
+        CollectionItemRegistry,
         BaseSection,
         FallbackSection,
         Section,
         SectionType,
+        CollectionItem,
+        CollectionType,
+        CollectionDocument,
         MenuItem,
         MenuConfig,
         PageMeta,
+        PageCollectionBinding,
         PageConfig,
         SiteIdentity,
         SiteConfig,
@@ -279,14 +325,20 @@ export declare namespace contract {
         AssetsConfig,
         WebMcpConfig,
         JsonPagesConfig,
+        validateCollectionDocuments,
+        resolveCollectionContext,
         getMenuRefBindings,
         applyMenuRefBindingsToDraft,
+        getCollectionRefBindings,
+        applyCollectionRefBindingsToDraft,
         applySiteMenuRefBindingsToDraft,
         resolveHeaderMenuItems,
         resolveSectionMenuItems,
         resolveRuntimeConfig,
         RefDocuments,
+        CollectionResolutionContext,
         MenuRefBinding,
+        CollectionRefBinding,
         buildPageContractHref,
         buildPageManifestHref,
         buildPageContract,
@@ -378,6 +430,8 @@ declare interface FormFactoryProps {
     schema: z.ZodObject<z.ZodRawShape>;
     data: Record<string, unknown>;
     onChange: (newData: Record<string, unknown>) => void;
+    collections?: JsonPagesConfig['collections'];
+    collectionSource?: string;
     /** When set, only render fields whose key is in this array (e.g. Content vs Settings tabs). */
     keys?: string[] | null;
     /** Root-to-leaf path for deep focus (e.g. silos -> blocks). First segment applies to this level. */
@@ -399,6 +453,8 @@ export declare interface FormState {
 
 export declare type FormStatus = 'idle' | 'submitting' | 'success' | 'error';
 
+declare function getCollectionRefBindings(sectionData: unknown, collectionContext?: CollectionResolutionContext | null): CollectionRefBinding[];
+
 export declare function getMenuRefBindings(sectionData: unknown): MenuRefBinding[];
 
 /**
@@ -435,10 +491,7 @@ export declare interface JsonPagesConfig {
     tenantId: string;
     basePath?: string;
     registry: Record<string, default_2.ComponentType<unknown>>;
-    schemas: Record<string, {
-        parse: (v: unknown) => unknown;
-        shape?: Record<string, unknown>;
-    }>;
+    schemas: Record<string, SchemaLike>;
     /**
      * Optional registry of Zod submission schemas for sections that can be filled
      * by external agents (e.g. MCP-connected AI clients).
@@ -460,14 +513,13 @@ export declare interface JsonPagesConfig {
      * See `docs/decisions/ADR-0002-form-submission-schemas.md` for rationale,
      * tenant convention, and the full emission contract.
      */
-    submissionSchemas?: Record<string, {
-        parse: (v: unknown) => unknown;
-        shape?: Record<string, unknown>;
-    }>;
+    submissionSchemas?: Record<string, SchemaLike>;
+    collectionSchemas?: Record<string, SchemaLike>;
     pages: Record<string, PageConfig>;
     siteConfig: SiteConfig;
     themeConfig: ThemeConfig;
     menuConfig: MenuConfig;
+    collections?: Record<string, CollectionDocument<unknown>>;
     refDocuments?: Record<string, unknown>;
     persistence?: Partial<PersistenceConfig>;
     themeCss: ThemeCssConfig;
@@ -497,13 +549,18 @@ export declare namespace kernel {
         BaseSectionSettings,
         SectionDataRegistry,
         SectionSettingsRegistry,
+        CollectionItemRegistry,
         BaseSection,
         FallbackSection,
         Section,
         SectionType,
+        CollectionItem,
+        CollectionType,
+        CollectionDocument,
         MenuItem,
         MenuConfig,
         PageMeta,
+        PageCollectionBinding,
         PageConfig,
         SiteIdentity,
         SiteConfig,
@@ -651,11 +708,17 @@ declare interface OlonJsSiteManifestIndex {
 /** Used by the section-settings modal to update a section without changing Inspector selection. */
 export declare type OnUpdateSection = (sectionId: string, scope: 'global' | 'local', sectionType: string, newData: Record<string, unknown>) => void;
 
+export declare interface PageCollectionBinding {
+    source: CollectionType;
+    paramKey: string;
+}
+
 export declare interface PageConfig {
     id: string;
     slug: string;
     meta: PageMeta;
     sections: Section[];
+    collection?: PageCollectionBinding;
     /** When `false`, Core does not render the global header from `site.json` for this page. Omitted = default (show if configured). */
     'global-header'?: boolean;
 }
@@ -674,6 +737,13 @@ export declare interface PageRendererProps {
     selectedId?: string | null;
 }
 
+export declare interface PageRouteMatch {
+    page: PageConfig;
+    registrySlug: string;
+    requestedSlug: string;
+    params: Record<string, string>;
+}
+
 /**
  * Enterprise-grade page switcher: popover trigger + list, a11y, single source of styling.
  * Use in Inspector header when multiple pages exist and onPageChange is provided.
@@ -727,6 +797,7 @@ export declare interface ProjectState {
     site: SiteConfig;
     menu: MenuConfig;
     theme: ThemeConfig;
+    collections?: Record<string, CollectionDocument<unknown>>;
 }
 
 declare type Props = PageRendererProps & {
@@ -743,12 +814,38 @@ declare type Registry = JsonPagesConfig['registry'];
 
 export declare const resolveAssetUrl: (path: string, tenantId?: string, basePath?: string) => string;
 
+declare function resolveCollectionContext(page: PageConfig, params: Record<string, string | undefined>, collections?: JsonPagesConfig['collections']): CollectionResolutionContext | null;
+
+export declare interface ResolvedPublicPageDocument {
+    page: PageConfig;
+    siteConfig: SiteConfig;
+    themeConfig: JsonPagesConfig['themeConfig'];
+    menuConfig: MenuConfig;
+    pageMatch: PageRouteMatch;
+    collectionContext: CollectionResolutionContext | null;
+}
+
 export declare function resolveHeaderMenuItems(headerData: unknown, fallbackMain: MenuItem[]): MenuItem[];
 
 export declare function resolveMenuMainFromHeaderData(headerData: unknown, fallbackMain: MenuItem[]): MenuItem[];
 
 export declare function resolvePageFromRegistry(pageRegistry: Record<string, PageConfig>, requestedSlug: string): PageConfig | undefined;
 
+export declare function resolvePageMatchFromRegistry(pageRegistry: Record<string, PageConfig>, requestedSlug: string): PageRouteMatch | undefined;
+
+export declare function resolvePublicPageDocument(input: ResolvePublicPageDocumentInput): ResolvedPublicPageDocument | null;
+
+export declare interface ResolvePublicPageDocumentInput {
+    slug: string;
+    pages: Record<string, PageConfig>;
+    siteConfig: SiteConfig;
+    themeConfig: JsonPagesConfig['themeConfig'];
+    menuConfig: MenuConfig;
+    collections?: JsonPagesConfig['collections'];
+    collectionSchemas?: JsonPagesConfig['collectionSchemas'];
+    refDocuments?: JsonPagesConfig['refDocuments'];
+}
+
 export declare function resolveRuntimeConfig(input: RuntimeResolutionInput): RuntimeResolutionResult;
 
 export declare function resolveSectionMenuItems(section: Section, fallbackMain: MenuItem[]): MenuItem[] | undefined;
@@ -787,9 +884,14 @@ export declare namespace runtime {
         syncWebMcpJsonLd,
         isRecord,
         normalizeSlugSegments,
+        resolvePageMatchFromRegistry,
         resolveMenuMainFromHeaderData,
         resolvePageFromRegistry,
         resolveSlugFromPathname,
+        PageRouteMatch,
+        resolvePublicPageDocument,
+        ResolvedPublicPageDocument,
+        ResolvePublicPageDocumentInput,
         isCanonicalAssetUrl,
         isTransientAssetUrl,
         resolveAssetUrl,
@@ -806,6 +908,9 @@ declare interface RuntimeResolutionInput {
     siteConfig: SiteConfig;
     themeConfig: ThemeConfig;
     menuConfig: MenuConfig;
+    collections?: JsonPagesConfig['collections'];
+    collectionSchemas?: JsonPagesConfig['collectionSchemas'];
+    collectionContext?: CollectionResolutionContext | null;
     refDocuments?: JsonPagesConfig['refDocuments'];
 }
 
@@ -814,6 +919,8 @@ declare interface RuntimeResolutionResult {
     siteConfig: SiteConfig;
     themeConfig: ThemeConfig;
     menuConfig: MenuConfig;
+    collections: CollectionDocuments;
+    collectionContext: CollectionResolutionContext | null;
 }
 
 declare interface SaveStreamDoneEvent {
@@ -832,6 +939,11 @@ declare interface SaveStreamStepEvent {
     label?: string;
 }
 
+declare type SchemaLike = {
+    parse: (v: unknown) => unknown;
+    shape?: Record<string, unknown>;
+};
+
 declare type Schemas = JsonPagesConfig['schemas'];
 
 /** Computed union of all registered section types. */
@@ -946,6 +1058,8 @@ export declare interface StudioRouteProps {
     siteConfig: SiteConfig;
     menuConfig: MenuConfig;
     themeConfig: JsonPagesConfig['themeConfig'];
+    collections?: JsonPagesConfig['collections'];
+    collectionSchemas?: JsonPagesConfig['collectionSchemas'];
     refDocuments?: JsonPagesConfig['refDocuments'];
     tenantCss: string;
     adminCss: string;
@@ -1043,6 +1157,8 @@ export declare function useFormState(formId: string): FormState;
 
 export declare const useStudio: () => StudioContextType;
 
+declare function validateCollectionDocuments(collections?: JsonPagesConfig['collections'], collectionSchemas?: JsonPagesConfig['collectionSchemas']): CollectionDocuments;
+
 export declare const VisitorRoute: default_2.FC<VisitorRouteProps>;
 
 export declare interface VisitorRouteProps {
@@ -1050,6 +1166,8 @@ export declare interface VisitorRouteProps {
     siteConfig: SiteConfig;
     menuConfig: MenuConfig;
     themeConfig: JsonPagesConfig['themeConfig'];
+    collections?: JsonPagesConfig['collections'];
+    collectionSchemas?: JsonPagesConfig['collectionSchemas'];
     refDocuments?: JsonPagesConfig['refDocuments'];
     tenantCss: string;
     adminCss: string;