@olonjs/core 1.0.85 → 1.0.87

package/dist/index.d.ts

@@ -54,11 +54,9 @@ declare interface AdminSidebarProps {
     onDeleteSection?: (sectionId: string) => void;
     /** When provided, shows an "Add section" button in the inspector header that opens the section library. */
     onAddSection?: () => void;
-    /** Whether there are unsaved changes (disables Bake HTML / Export JSON when false). */
+    /** Whether there are unsaved changes for the current draft. */
     hasChanges?: boolean;
-    /** Trigger Bake HTML (same as ControlBar). */
-    onExportHTML?: () => void;
-    /** Save to file (writes JSON to repo via server). Replaces Export JSON in sidebar when provided. */
+    /** Save to file (writes JSON to repo via server). */
     onSaveToFile?: () => void;
     /** Hot Save callback (typically cloud save2edge). */
     onHotSave?: () => void;
@@ -68,7 +66,7 @@ declare interface AdminSidebarProps {
     hotSaveSuccessFeedback?: boolean;
     /** When true, hot save action is currently running. */
     hotSaveInProgress?: boolean;
-    /** Controls visibility of legacy Save button. */
+    /** Controls visibility of the Save to file button. */
     showLegacySave?: boolean;
     /** Controls visibility of Hot Save button. */
     showHotSave?: boolean;
@@ -84,6 +82,8 @@ declare interface AdminSidebarProps {
     onPageChange?: (slug: string) => void;
 }
 
+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. */
@@ -94,16 +94,6 @@ export declare interface AssetsConfig {
     onAssetUpload?: (file: File) => Promise<string>;
 }
 
-/**
- * 🍞 BAKED STATE (Optimized subset for the static HTML artifact)
- */
-export declare interface BakedState {
-    page: PageConfig;
-    site: Omit<SiteConfig, 'pages'>;
-    menu: MenuConfig;
-    theme: ThemeConfig;
-}
-
 export declare interface BaseSection<K extends keyof SectionDataRegistry> {
     id: string;
     type: K;
@@ -129,6 +119,8 @@ export declare interface BaseWidgetProps<T = unknown> {
     options?: string[];
 }
 
+export declare function buildWebMcpToolName(sectionType: string): string;
+
 export declare function cn(...inputs: ClassValue[]): string;
 
 export declare interface ConfigContextValue {
@@ -147,27 +139,11 @@ export declare const ConfigProvider: default_2.FC<{
     children: default_2.ReactNode;
 }>;
 
-export declare const ControlBar: default_2.FC<ControlBarProps>;
-
-declare interface ControlBarProps {
-    hasChanges: boolean;
-    onExportJSON: () => void;
-    onExportHTML: () => void;
-    /** Optional: opens the Add section library. When provided, an "Add section" icon is shown. */
-    onAddSection?: () => void;
-}
+export declare function createWebMcpToolInputSchema(sectionType: string): Record<string, unknown>;
 
 export declare const DefaultNotFound: default_2.FC;
 
-/**
- * 🍞 BAKE HTML (The Single File Artifact)
- */
-export declare const exportBakedHTML: (state: ProjectState, slug: string, cleanHtml: string) => void;
-
-/**
- * 💾 EXPORT JSON (The Developer Handover)
- */
-export declare const exportProjectJSON: (state: ProjectState, slug: string) => Promise<void>;
+export declare function ensureWebMcpRuntime(): void;
 
 /** Structural shape used when no tenant has augmented the registries. */
 export declare interface FallbackSection {
@@ -224,7 +200,7 @@ export declare interface JsonPagesConfig {
     menuConfig: MenuConfig;
     /** Optional extra JSON documents available to the runtime $ref resolver. */
     refDocuments?: Record<string, unknown>;
-    /** Optional persistence; Core provides defaults if omitted. */
+    /** Optional persistence callbacks for tenant-specific save flows. */
     persistence?: Partial<PersistenceConfig>;
     /** CSS strings for ThemeLoader. */
     themeCss: ThemeCssConfig;
@@ -236,6 +212,8 @@ export declare interface JsonPagesConfig {
     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;
@@ -298,10 +276,10 @@ export declare interface PageRendererProps {
     selectedId?: string | null;
 }
 
-/** Persistence API; defaults provided by Core, overridable by Tenant. */
+export declare function parseWebMcpToolName(toolName: string): string | null;
+
+/** Persistence API exposed by the tenant app to Studio actions. */
 export declare interface PersistenceConfig {
-    exportJSON: (state: ProjectState, slug: string) => Promise<void>;
-    exportHTML: (state: ProjectState, slug: string, cleanHtml: string) => void;
     /**
      * 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.
@@ -312,7 +290,7 @@ export declare interface PersistenceConfig {
      * Core only triggers this callback; tenant decides transport and endpoint.
      */
     hotSave?: (state: ProjectState, slug: string) => Promise<void>;
-    /** Controls legacy Save button visibility in sidebar. Default true. */
+    /** Controls Save to file button visibility in sidebar. Default true. */
     showLegacySave?: boolean;
     /** Controls Hot Save button visibility in sidebar. Default false. */
     showHotSave?: boolean;
@@ -344,6 +322,8 @@ declare type Props = PageRendererProps & {
     onActiveSectionChange?: (sectionId: string | null) => void;
 };
 
+export declare function registerWebMcpTool(tool: WebMcpTool): () => void;
+
 declare type Registry = JsonPagesConfig['registry'];
 
 /**
@@ -359,6 +339,8 @@ export declare function resolveRuntimeConfig(input: RuntimeResolutionInput): Run
 
 export declare function resolveSectionMenuItems(section: Section, fallbackMain: MenuItem[]): MenuItem[] | undefined;
 
+export declare function resolveWebMcpMutationData(currentData: Record<string, unknown>, args: WebMcpMutationArgs): Record<string, unknown>;
+
 declare interface RuntimeResolutionInput {
     pages: Record<string, PageConfig>;
     siteConfig: SiteConfig;
@@ -447,8 +429,6 @@ export declare interface SitePageEntry {
 export declare const STUDIO_EVENTS: {
     readonly UPDATE_DRAFTS: "jsonpages:update-drafts";
     readonly SYNC_SELECTION: "jsonpages:sync-selection";
-    readonly REQUEST_CLEAN_HTML: "jsonpages:request-clean-html";
-    readonly SEND_CLEAN_HTML: "jsonpages:send-clean-html";
     readonly SECTION_SELECT: "jsonpages:section-select";
     readonly INLINE_FIELD_UPDATE: "jsonpages:inline-field-update";
     readonly INLINE_FLUSHED: "jsonpages:inline-flushed";
@@ -456,6 +436,8 @@ export declare const STUDIO_EVENTS: {
     readonly REQUEST_INLINE_FLUSH: "jsonpages:request-inline-flush";
     readonly ACTIVE_SECTION_CHANGED: "jsonpages:active-section-changed";
     readonly STAGE_READY: "jsonpages:stage-ready";
+    readonly WEBMCP_TOOL_CALL: "olonjs:webmcp:tool-call";
+    readonly WEBMCP_TOOL_RESULT: "olonjs:webmcp:tool-result";
 };
 
 declare interface StudioContextType {
@@ -563,6 +545,31 @@ export declare function useConfig(): ConfigContextValue;
 
 export declare const useStudio: () => StudioContextType;
 
+/** Optional WebMCP bridge registration in Studio mode. */
+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;
+}
+
+export declare interface WebMcpMutationArgs {
+    slug?: string;
+    sectionId: string;
+    scope?: 'global' | 'local';
+    data?: Record<string, unknown>;
+    itemPath?: SelectionPath;
+    fieldKey?: string;
+    value?: unknown;
+}
+
+declare type WebMcpTool = {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    execute: (args: unknown) => Promise<unknown> | unknown;
+};
+
 export declare type WidgetType = keyof typeof InputWidgets;
 
 export { }