@olonjs/core 1.0.110 → 1.0.112

package/dist/index.d.ts

@@ -1,19 +1,14 @@
 import { ClassValue } from 'clsx';
+import { Component } from 'react';
 import { default as default_2 } from 'react';
+import { ErrorInfo } from 'react';
 import { JSX } from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 import { z } from 'zod';
 
-/**
- * Optional config for the "Add section" library (tenant-agnostic).
- * Section types are derived from registry/schemas; tenant can customize labels and defaults.
- */
 export declare interface AddSectionConfig {
-    /** Section types that can be added to a page (order preserved). If omitted, derived from schemas excluding header/footer. */
     addableSectionTypes?: string[];
-    /** Display label per section type. If omitted, type id is humanized (e.g. "feature-grid" → "Feature grid"). */
     sectionTypeLabels?: Record<string, string>;
-    /** Default data for a new section of the given type. Required for add-section to produce valid sections. */
     getDefaultSectionData?: (sectionType: string) => Record<string, unknown>;
 }
 
@@ -29,6 +24,21 @@ declare interface AddSectionLibraryProps {
     onSelect: (sectionType: string) => void;
 }
 
+export declare namespace admin {
+    export {
+        AddSectionLibrary,
+        AdminSidebar,
+        LayerItem,
+        FormFactory,
+        InputWidgets,
+        WidgetType,
+        PageSelector,
+        PreviewEntry,
+        buildSelectionPath,
+        StudioStage
+    }
+}
+
 export declare const AdminSidebar: default_2.FC<AdminSidebarProps>;
 
 declare interface AdminSidebarProps {
@@ -60,16 +70,20 @@ declare interface AdminSidebarProps {
     onSaveToFile?: () => void;
     /** Hot Save callback (typically cloud save2edge). */
     onHotSave?: () => void;
+    /** Cold Save callback (typically save2repo / deploy pipeline). */
+    onColdSave?: () => void;
     /** When true, show "Salvato" in the status bar (e.g. for 2s after save-to-file succeeds). */
     saveSuccessFeedback?: boolean;
     /** When true, show "Saved" feedback for hot save (e.g. for 2s after success). */
     hotSaveSuccessFeedback?: boolean;
     /** When true, hot save action is currently running. */
     hotSaveInProgress?: boolean;
-    /** Controls visibility of the Save to file button. */
-    showLegacySave?: boolean;
+    /** Controls visibility of the local Save button. */
+    showLocalSave?: boolean;
     /** Controls visibility of Hot Save button. */
     showHotSave?: boolean;
+    /** Controls visibility of Save2Repo / Cold Save button. */
+    showColdSave?: boolean;
     /** Restore page from file (resets in-memory draft for current slug). Hidden by default; set showResetToFile to display. */
     onResetToFile?: () => void;
     /** When true, shows the "Ripristina da file" button (default false = hidden). */
@@ -84,13 +98,22 @@ declare interface AdminSidebarProps {
 
 export declare function applyValueAtSelectionPath(rootData: Record<string, unknown>, selectionPath: SelectionPath, value: unknown): Record<string, unknown>;
 
-/** Optional config for the Image Picker (gallery from assets, save to assets). */
 export declare interface AssetsConfig {
-    /** Base URL for assets (e.g. "/assets"). Used to resolve library image URLs and display gallery. */
     assetsBaseUrl?: string;
-    /** Library images for the picker "Libreria" tab. Tenant can build from public/assets or provide a static list. */
     assetsManifest?: LibraryImageEntry[];
-    /** Optional: upload file to tenant assets and return the public URL. If omitted, upload tab uses data URL. */
+    /**
+     * Uploads an image and returns the final canonical URL that must be persisted in JSON.
+     *
+     * Valid examples:
+     * - /assets/images/foo.png
+     * - /assets/tenant-a/foo.png
+     * - https://cdn.example.com/foo.png
+     *
+     * Invalid examples:
+     * - public/assets/foo.png
+     * - C:\\foo\\bar.png
+     * - data:image/png;base64,...
+     */
     onAssetUpload?: (file: File) => Promise<string>;
 }
 
@@ -102,7 +125,7 @@ export declare interface BaseSection<K extends keyof SectionDataRegistry> {
 }
 
 /**
- * 🛡️ KERNEL: The Base Contract (MTRP)
+ * KERNEL: The Base Contract (MTRP)
  * Core is self-contained; structural types live here.
  */
 export declare interface BaseSectionSettings {
@@ -119,6 +142,37 @@ export declare interface BaseWidgetProps<T = unknown> {
     options?: string[];
 }
 
+declare function buildLlmsTxt(input: BuildSiteManifestInput): string;
+
+declare function buildPageContract({ slug, pageConfig, schemas, siteConfig, }: BuildPageContractInput): OlonJsPageContract;
+
+export declare function buildPageContractHref(slug: string): string;
+
+declare interface BuildPageContractInput {
+    slug: string;
+    pageConfig: PageConfig;
+    schemas: JsonPagesConfig['schemas'];
+    siteConfig: SiteConfig;
+}
+
+declare function buildPageManifest(input: BuildPageContractInput): OlonJsPageManifest;
+
+export declare function buildPageManifestHref(slug: string): string;
+
+declare function buildSelectionPath(root: HTMLElement, sectionEl: HTMLElement): SelectionPath;
+
+declare function buildSiteManifest({ pages, schemas, siteConfig, }: BuildSiteManifestInput): OlonJsSiteManifestIndex;
+
+declare interface BuildSiteManifestInput {
+    pages: Record<string, PageConfig>;
+    schemas: JsonPagesConfig['schemas'];
+    siteConfig: SiteConfig;
+}
+
+export declare function buildThemeVariableMap(theme: ThemeConfig): Record<string, string>;
+
+export declare function buildWebMcpSaveToolName(): string;
+
 export declare function buildWebMcpToolName(): string;
 
 export declare function cn(...inputs: ClassValue[]): string;
@@ -126,11 +180,8 @@ export declare function cn(...inputs: ClassValue[]): string;
 export declare interface ConfigContextValue {
     registry: Registry;
     schemas: Schemas;
-    /** For asset resolution (e.g. image picker preview). */
     tenantId?: string;
-    /** Optional assets config for Image Picker (gallery, upload). */
     assets?: AssetsConfig;
-    /** Optional list of section types where Studio overlay should be disabled. */
     overlayDisabledSectionTypes?: string[];
 }
 
@@ -139,10 +190,89 @@ export declare const ConfigProvider: default_2.FC<{
     children: default_2.ReactNode;
 }>;
 
+export declare namespace contract {
+    export {
+        shouldRenderSiteGlobalHeader,
+        BaseSectionSettings,
+        SectionDataRegistry,
+        SectionSettingsRegistry,
+        BaseSection,
+        FallbackSection,
+        Section,
+        SectionType,
+        MenuItem,
+        MenuConfig,
+        PageMeta,
+        PageConfig,
+        SiteIdentity,
+        SitePageEntry,
+        SiteConfig,
+        ThemeTokenMap,
+        ThemeColors,
+        ThemeFontFamily,
+        ThemeTypography,
+        ThemeBorderRadius,
+        ThemeTokens,
+        ThemeConfig,
+        ProjectState,
+        PageRendererProps,
+        SelectionPathSegment,
+        SelectionPath,
+        PersistenceConfig,
+        ThemeCssConfig,
+        AddSectionConfig,
+        LibraryImageEntry,
+        AssetsConfig,
+        WebMcpConfig,
+        JsonPagesConfig,
+        resolveHeaderMenuItems,
+        resolveSectionMenuItems,
+        resolveRuntimeConfig,
+        RefDocuments,
+        buildPageContractHref,
+        buildPageManifestHref,
+        buildPageContract,
+        buildPageManifest,
+        buildSiteManifest,
+        buildLlmsTxt,
+        WebMcpToolContract,
+        WebMcpSectionInstance,
+        OlonJsPageContract,
+        OlonJsPageManifest,
+        OlonJsSiteManifestIndex,
+        BuildPageContractInput,
+        BuildSiteManifestInput,
+        BaseWidgetProps
+    }
+}
+
+export declare function createWebMcpSaveToolInputSchema(): Record<string, unknown>;
+
 export declare function createWebMcpToolInputSchema(): Record<string, unknown>;
 
 export declare const DefaultNotFound: default_2.FC;
 
+/**
+ * Engine-level error boundary: prevents black screen on any render error
+ * and surfaces a visible error UI.
+ */
+export declare class EngineErrorBoundary extends Component<{
+    children: ReactNode;
+}, {
+    hasError: boolean;
+    error: Error | null;
+}> {
+    constructor(props: {
+        children: ReactNode;
+    });
+    static getDerivedStateFromError(error: Error): {
+        hasError: boolean;
+        error: Error;
+    };
+    componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
+    render(): string | number | bigint | boolean | Iterable<default_2.ReactNode> | Promise<string | number | bigint | boolean | default_2.ReactPortal | default_2.ReactElement<unknown, string | default_2.JSXElementConstructor<any>> | Iterable<default_2.ReactNode> | null | undefined> | JSX.Element | null | undefined;
+}
+
 export declare function ensureWebMcpRuntime(): void;
 
 /** Structural shape used when no tenant has augmented the registries. */
@@ -182,46 +312,81 @@ export declare const InputWidgets: {
     readonly 'ui:icon-picker': ({ label, value, onChange }: BaseWidgetProps<string>) => JSX.Element;
 };
 
-/** Single entry point configuration for the JsonPages Engine. */
+export declare const isCanonicalAssetUrl: (path: string) => boolean;
+
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+
+export declare const isTransientAssetUrl: (path: string) => boolean;
+
 export declare interface JsonPagesConfig {
-    /** Unique identifier for the tenant (used for asset resolution) */
     tenantId: string;
-    /** Component map: section type -> React component. */
     registry: Record<string, default_2.ComponentType<unknown>>;
-    /** Zod schemas map: section type -> schema. */
     schemas: Record<string, {
         parse: (v: unknown) => unknown;
         shape?: Record<string, unknown>;
     }>;
-    /** Page slug -> page config. */
     pages: Record<string, PageConfig>;
     siteConfig: SiteConfig;
     themeConfig: ThemeConfig;
     menuConfig: MenuConfig;
-    /** Optional extra JSON documents available to the runtime $ref resolver. */
     refDocuments?: Record<string, unknown>;
-    /** Optional persistence callbacks for tenant-specific save flows. */
     persistence?: Partial<PersistenceConfig>;
-    /** CSS strings for ThemeLoader. */
     themeCss: ThemeCssConfig;
-    /** Optional 404 component. */
     NotFoundComponent?: default_2.ComponentType;
-    /** Optional "Add section" library config (labels, addable types, default data). */
     addSection?: AddSectionConfig;
-    /** Optional assets config for Image Picker (gallery, upload target). */
     assets?: AssetsConfig;
-    /** Optional list of section types where Studio overlay should be disabled. */
     overlayDisabledSectionTypes?: string[];
-    /** Optional WebMCP bridge config for Studio-only tool registration. */
     webmcp?: WebMcpConfig;
 }
 
 export declare function JsonPagesEngine({ config }: JsonPagesEngineProps): JSX.Element;
 
-declare interface JsonPagesEngineProps {
+export declare interface JsonPagesEngineProps {
     config: JsonPagesConfig;
 }
 
+export declare namespace kernel {
+    export {
+        resolveHeaderMenuItems,
+        resolveRuntimeConfig,
+        resolveSectionMenuItems,
+        shouldRenderSiteGlobalHeader,
+        BaseSectionSettings,
+        SectionDataRegistry,
+        SectionSettingsRegistry,
+        BaseSection,
+        FallbackSection,
+        Section,
+        SectionType,
+        MenuItem,
+        MenuConfig,
+        PageMeta,
+        PageConfig,
+        SiteIdentity,
+        SitePageEntry,
+        SiteConfig,
+        ThemeTokenMap,
+        ThemeColors,
+        ThemeFontFamily,
+        ThemeTypography,
+        ThemeBorderRadius,
+        ThemeTokens,
+        ThemeConfig,
+        ProjectState,
+        PageRendererProps,
+        SelectionPathSegment,
+        SelectionPath,
+        PersistenceConfig,
+        ThemeCssConfig,
+        AddSectionConfig,
+        LibraryImageEntry,
+        AssetsConfig,
+        WebMcpConfig,
+        JsonPagesConfig,
+        BaseWidgetProps
+    }
+}
+
 export declare interface LayerItem {
     id: string;
     type: string;
@@ -229,7 +394,6 @@ export declare interface LayerItem {
     title?: string;
 }
 
-/** Image entry for the Image Picker Library tab (from tenant assets or manifest). */
 export declare interface LibraryImageEntry {
     id: string;
     url: string;
@@ -250,6 +414,63 @@ export declare interface MenuItem {
     children?: MenuItem[];
 }
 
+export declare function normalizeSlugSegments(value: string): string;
+
+declare interface OlonJsPageContract {
+    version: '1.0.0';
+    kind: 'olonjs-page-contract';
+    slug: string;
+    title: string;
+    description: string;
+    manifestHref: string;
+    systemPrompt: string;
+    sectionTypes: string[];
+    sectionInstances: WebMcpSectionInstance[];
+    sectionSchemas: Record<string, Record<string, unknown>>;
+    tools: WebMcpToolContract[];
+}
+
+declare interface OlonJsPageManifest {
+    version: '1.0.0';
+    kind: 'olonjs-page-mcp-manifest';
+    generatedAt: string;
+    slug: string;
+    title: string;
+    description: string;
+    contractHref: string;
+    transport: {
+        kind: 'window-message';
+        requestType: string;
+        resultType: string;
+        target: 'window';
+    };
+    capabilities: {
+        resources: Array<{
+            uri: string;
+            name: string;
+            mimeType: string;
+            description: string;
+        }>;
+    };
+    sectionTypes: string[];
+    sectionInstances: WebMcpSectionInstance[];
+    tools: Array<Pick<WebMcpToolContract, 'name' | 'description'>>;
+}
+
+declare interface OlonJsSiteManifestIndex {
+    version: '1.0.0';
+    kind: 'olonjs-mcp-manifest-index';
+    generatedAt: string;
+    pages: Array<{
+        slug: string;
+        title: string;
+        description: string;
+        manifestHref: string;
+        contractHref: string;
+        sectionTypes: string[];
+    }>;
+}
+
 /** 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;
 
@@ -276,33 +497,52 @@ export declare interface PageRendererProps {
     selectedId?: string | null;
 }
 
-/** Persistence API exposed by the tenant app to Studio actions. */
+/**
+ * Enterprise-grade page switcher: popover trigger + list, a11y, single source of styling.
+ * Use in Inspector header when multiple pages exist and onPageChange is provided.
+ */
+declare const PageSelector: default_2.FC<PageSelectorProps>;
+
+declare interface PageSelectorProps {
+    /** Available page slugs. */
+    pageSlugs: string[];
+    /** Current page slug. */
+    currentSlug: string;
+    /** Called when user selects another page. */
+    onPageChange: (slug: string) => void;
+    /** Optional: show section count per page (e.g. "9s"). Omit to hide. */
+    sectionCount?: number;
+    /** Optional: when set, shows "New page" and calls this on click. Omit to hide (no dead UI). */
+    onNewPage?: () => void;
+    /** Optional class for the wrapper (e.g. spacing). */
+    className?: string;
+    /** Optional: override label for current page (default: capitalized slug). */
+    currentPageLabel?: string;
+}
+
+export declare function parseWebMcpMutationArgs(rawArgs: unknown): WebMcpMutationArgs;
+
 export declare interface PersistenceConfig {
-    /**
-     * Optional. Save current state to repo files (e.g. POST to /api/save-to-file); server writes
-     * src/data/config/*.json and src/data/pages/<slug>.json. No git push.
-     */
     saveToFile?: (state: ProjectState, slug: string) => Promise<void>;
-    /**
-     * Optional. Hot save path (e.g. POST to /api/v1/save2edge).
-     * Core only triggers this callback; tenant decides transport and endpoint.
-     */
     hotSave?: (state: ProjectState, slug: string) => Promise<void>;
-    /** Controls Save to file button visibility in sidebar. Default true. */
-    showLegacySave?: boolean;
-    /** Controls Hot Save button visibility in sidebar. Default false. */
+    coldSave?: (state: ProjectState, slug: string) => Promise<void>;
+    showLocalSave?: boolean;
     showHotSave?: boolean;
-    /**
-     * Optional. If provided, flushes in-memory /uploaded-assets/ blobs to disk and returns oldUrl -> newUrl map.
-     * Omit when uploads write directly to disk (e.g. public/assets/images) and section data already stores final URLs.
-     */
+    showColdSave?: boolean;
     flushUploadedAssets?: (urls: string[]) => Promise<Record<string, string>>;
 }
 
 export declare const PreviewEntry: default_2.FC;
 
+export declare const PreviewRoute: default_2.FC<PreviewRouteProps>;
+
+export declare interface PreviewRouteProps {
+    tenantCss: string;
+    adminCss: string;
+}
+
 /**
- * 📦 PROJECT STATE (The Universal Data Bundle)
+ * PROJECT STATE (The Universal Data Bundle)
  * Moved to Kernel to serve as SSOT for Engine and Persistence.
  */
 export declare interface ProjectState {
@@ -314,31 +554,72 @@ export declare interface ProjectState {
 
 declare type Props = PageRendererProps & {
     onReorder?: (sectionId: string, newIndex: number) => void;
-    /** When set, scroll this section into view (Studio full-page). */
     scrollToSectionId?: string | null;
-    /** Report which section is most visible in viewport (Intersection Observer). */
     onActiveSectionChange?: (sectionId: string | null) => void;
 };
 
+declare type RefDocuments = NonNullable<JsonPagesConfig['refDocuments']>;
+
 export declare function registerWebMcpTool(tool: WebMcpTool): () => void;
 
 declare type Registry = JsonPagesConfig['registry'];
 
-/**
- * 🛡️ SOVEREIGN ASSET RESOLVER
- * Centralized logic to distinguish between routes and static assets.
- * Moved to Core to allow Standard Blocks to resolve assets consistently.
- */
 export declare const resolveAssetUrl: (path: string, tenantId?: string) => string;
 
 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 resolveRuntimeConfig(input: RuntimeResolutionInput): RuntimeResolutionResult;
 
 export declare function resolveSectionMenuItems(section: Section, fallbackMain: MenuItem[]): MenuItem[] | undefined;
 
+export declare function resolveSlugFromPathname(pathname: string, prefix?: string): string;
+
 export declare function resolveWebMcpMutationData(currentData: Record<string, unknown>, args: WebMcpMutationArgs): Record<string, unknown>;
 
+export declare namespace runtime {
+    export {
+        PageRenderer,
+        SectionRenderer,
+        JsonPagesEngine,
+        JsonPagesEngineProps,
+        StudioProvider,
+        useStudio,
+        ConfigProvider,
+        useConfig,
+        ConfigContextValue,
+        ThemeLoader,
+        ThemeLoaderProps,
+        DefaultNotFound,
+        STUDIO_EVENTS,
+        EngineErrorBoundary,
+        PreviewRoute,
+        PreviewRouteProps,
+        StudioRoute,
+        StudioRouteProps,
+        VisitorRoute,
+        VisitorRouteProps,
+        buildPageContractHref,
+        buildPageManifestHref,
+        syncHeadLink,
+        syncWebMcpJsonLd,
+        isRecord,
+        normalizeSlugSegments,
+        resolveMenuMainFromHeaderData,
+        resolvePageFromRegistry,
+        resolveSlugFromPathname,
+        isCanonicalAssetUrl,
+        isTransientAssetUrl,
+        resolveAssetUrl,
+        useDocumentMeta,
+        buildThemeVariableMap,
+        themeManager
+    }
+}
+
 declare interface RuntimeResolutionInput {
     pages: Record<string, PageConfig>;
     siteConfig: SiteConfig;
@@ -370,13 +651,9 @@ declare interface SectionRendererProps {
     section: Section;
     menu?: MenuItem[];
     selectedId?: string | null;
-    /** When true, show reorder (up/down) in overlay for local sections. */
     reorderable?: boolean;
-    /** Section index in page (for reorder). Required when reorderable. */
     sectionIndex?: number;
-    /** Total number of page sections (for disabling down at last). */
     totalSections?: number;
-    /** Called when user triggers move up/down. newIndex is the target index for the engine. */
     onReorder?: (sectionId: string, newIndex: number) => void;
 }
 
@@ -391,10 +668,8 @@ declare interface SelectedSectionInfo {
     scope: string;
 }
 
-/** v1.3 strict Studio path for field/item focus synchronization. */
 export declare type SelectionPath = SelectionPathSegment[];
 
-/** v1.3 strict Studio path segment (root -> leaf). */
 export declare interface SelectionPathSegment {
     fieldKey: string;
     itemId?: string;
@@ -420,10 +695,15 @@ export declare interface SitePageEntry {
     label: string;
 }
 
-/**
- * 📡 STUDIO EVENT PROTOCOL
- * Single Source of Truth for cross-frame communication.
- */
+export declare namespace studio {
+    export {
+        STUDIO_EVENTS,
+        StudioProvider,
+        useStudio,
+        admin
+    }
+}
+
 export declare const STUDIO_EVENTS: {
     readonly UPDATE_DRAFTS: "jsonpages:update-drafts";
     readonly SYNC_SELECTION: "jsonpages:sync-selection";
@@ -449,6 +729,30 @@ export declare const StudioProvider: default_2.FC<{
     children: ReactNode;
 }>;
 
+export declare const StudioRoute: default_2.FC<StudioRouteProps>;
+
+export declare interface StudioRouteProps {
+    pageRegistry: Record<string, PageConfig>;
+    schemas: JsonPagesConfig['schemas'];
+    siteConfig: SiteConfig;
+    menuConfig: {
+        main: MenuItem[];
+    };
+    themeConfig: JsonPagesConfig['themeConfig'];
+    refDocuments?: JsonPagesConfig['refDocuments'];
+    tenantCss: string;
+    adminCss: string;
+    addSectionConfig: JsonPagesConfig['addSection'];
+    addableSectionTypes: string[];
+    webMcp?: JsonPagesConfig['webmcp'];
+    saveToFile?: (state: ProjectState, slug: string) => Promise<void>;
+    hotSave?: (state: ProjectState, slug: string) => Promise<void>;
+    coldSave?: (state: ProjectState, slug: string) => Promise<void>;
+    showLocalSave?: boolean;
+    showHotSave?: boolean;
+    showColdSave?: boolean;
+}
+
 /**
  * 📺 STUDIO STAGE (Full Preview Mode)
  * Manages the Iframe and the PostMessage protocol.
@@ -467,6 +771,10 @@ declare interface StudioStageProps {
     onScrollRequested?: () => void;
 }
 
+export declare function syncHeadLink(rel: string, href: string): void;
+
+export declare function syncWebMcpJsonLd(title: string, description: string, url: string): void;
+
 export declare interface ThemeBorderRadius {
     sm: string;
     md: string;
@@ -492,7 +800,6 @@ export declare interface ThemeConfig {
     tokens: ThemeTokens;
 }
 
-/** Theme CSS: tenant (required), admin (optional). */
 export declare interface ThemeCssConfig {
     tenant: string;
     admin?: string;
@@ -505,18 +812,11 @@ export declare interface ThemeFontFamily {
     [key: string]: string | undefined;
 }
 
-/**
- * Theme Loader: injects the required CSS into the <head> and removes it on unmount.
- * CSS strings are passed as props so the Engine controls injection; Tenant does not manage Admin CSS.
- */
 export declare const ThemeLoader: default_2.FC<ThemeLoaderProps>;
 
-declare interface ThemeLoaderProps {
-    /** Which mode is active; determines which CSS is injected. */
+export declare interface ThemeLoaderProps {
     mode: 'tenant' | 'admin';
-    /** CSS string for tenant (visitor) mode. */
     tenantCss: string;
-    /** CSS string for admin (studio) mode. Engine provides default if not passed. */
     adminCss: string;
     children: default_2.ReactNode;
 }
@@ -541,13 +841,55 @@ export declare interface ThemeTypography {
 
 export declare function useConfig(): ConfigContextValue;
 
+export declare const useDocumentMeta: (meta: PageMeta) => void;
+
 export declare const useStudio: () => StudioContextType;
 
-/** Optional WebMCP bridge registration in Studio mode. */
+export declare const VisitorRoute: default_2.FC<VisitorRouteProps>;
+
+export declare interface VisitorRouteProps {
+    pageRegistry: Record<string, PageConfig>;
+    siteConfig: SiteConfig;
+    menuConfig: {
+        main: MenuItem[];
+    };
+    themeConfig: JsonPagesConfig['themeConfig'];
+    refDocuments?: JsonPagesConfig['refDocuments'];
+    tenantCss: string;
+    adminCss: string;
+    NotFoundComponent: default_2.ComponentType;
+}
+
+export declare namespace webmcp {
+    export {
+        applyValueAtSelectionPath,
+        buildWebMcpToolName,
+        buildWebMcpSaveToolName,
+        createWebMcpToolInputSchema,
+        createWebMcpSaveToolInputSchema,
+        ensureWebMcpRuntime,
+        parseWebMcpMutationArgs,
+        registerWebMcpTool,
+        resolveWebMcpMutationData,
+        WebMcpMutationArgs,
+        buildLlmsTxt,
+        buildPageContract,
+        buildPageContractHref,
+        buildPageManifest,
+        buildPageManifestHref,
+        buildSiteManifest,
+        BuildPageContractInput,
+        BuildSiteManifestInput,
+        OlonJsPageContract,
+        OlonJsPageManifest,
+        OlonJsSiteManifestIndex,
+        WebMcpSectionInstance,
+        WebMcpToolContract
+    }
+}
+
 export declare interface WebMcpConfig {
-    /** Enables WebMCP tool registration when Studio is active. */
     enabled?: boolean;
-    /** Optional namespace used by testing helpers and debug output. */
     namespace?: string;
 }
 
@@ -562,6 +904,13 @@ export declare interface WebMcpMutationArgs {
     value?: unknown;
 }
 
+declare interface WebMcpSectionInstance {
+    id: string;
+    type: string;
+    scope: 'global' | 'local';
+    label: string;
+}
+
 declare type WebMcpTool = {
     name: string;
     description: string;
@@ -569,6 +918,12 @@ declare type WebMcpTool = {
     execute: (args: unknown) => Promise<unknown> | unknown;
 };
 
+declare interface WebMcpToolContract {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+
 export declare type WidgetType = keyof typeof InputWidgets;
 
 export { }