@plitzi/sdk-shared 0.32.3 → 0.32.5

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @plitzi/sdk-shared
 
+## 0.32.5
+
+### Patch Changes
+
+- v0.32.4
+- Updated dependencies
+  - @plitzi/nexus@0.32.5
+
+## 0.32.4
+
+### Patch Changes
+
+- v0.32.4
+- Updated dependencies
+  - @plitzi/nexus@0.32.4
+
 ## 0.32.3
 
 ### Patch Changes

package/dist/dataSource/utility/index.mjs

@@ -4,19 +4,21 @@ import n from "./dateConverter.mjs";
 import r from "./staticValue.mjs";
 import i from "./stringToArray.mjs";
 import a from "./styleSelector.mjs";
-import o from "./twigTemplate.mjs";
+import o from "./styleVariant.mjs";
+import s from "./twigTemplate.mjs";
 //#region src/dataSource/utility/index.ts
-var s = {
-	twigTemplate: o,
+var c = {
+	twigTemplate: s,
 	dateConverter: n,
 	staticValue: r,
 	capitalize: t,
 	arrayMap: e,
 	stringToArray: i,
-	styleSelector: a
-}, c = Object.values(s).map(({ title: e, action: t }) => ({
+	styleSelector: a,
+	styleVariant: o
+}, l = Object.values(c).map(({ title: e, action: t }) => ({
 	label: e,
 	value: t
 }));
 //#endregion
-export { s as default, c as utilityOptions };
+export { c as default, l as utilityOptions };

package/dist/dataSource/utility/styleSelector.mjs

@@ -20,7 +20,16 @@ var t = {
 			label: "Selector",
 			defaultValue: "",
 			type: "select",
-			options: []
+			options: (e, t, n) => {
+				let r = n?.stylePlatform;
+				return r ? Object.keys(r).map((e) => ({
+					label: e,
+					options: Object.values(r[e]).filter((e) => e.type === "class").map((e) => ({
+						label: e.name,
+						value: e.name
+					}))
+				})) : [];
+			}
 		}
 	},
 	preview: {

package/dist/dataSource/utility/styleVariant.d.ts

@@ -0,0 +1,3 @@
+import { DataSourceUtility } from '../../types';
+declare const styleVariant: DataSourceUtility<string | string[] | Record<string, string | string[]>, Record<string, string | string[]>, string>;
+export default styleVariant;

package/dist/dataSource/utility/styleVariant.mjs

@@ -0,0 +1,76 @@
+import { set as e } from "@plitzi/plitzi-ui/helpers/lodash";
+//#region src/dataSource/utility/styleVariant.ts
+var t = (t, n, r, i = {}) => {
+	let { key: a, variant: o, append: s } = n;
+	if (!a) return i.sourceTo ?? {};
+	let c = a || "base", l = o || t;
+	return typeof l == "object" && !Array.isArray(l) ? l : e(s ? { ...i.sourceTo } : {}, c, l);
+}, n = (e) => {
+	let t = e.reduce((e, { groupLabel: t, option: n }) => (t in e || (e[t] = []), e[t].push(n), e), {});
+	return Object.entries(t).map(([e, t]) => ({
+		label: e,
+		options: t
+	}));
+}, r = {
+	action: "styleVariant",
+	title: "Style Variant",
+	type: "utility",
+	params: {
+		key: {
+			label: "Selector Key",
+			defaultValue: "",
+			type: "select",
+			options: (e, t) => {
+				let r = t?.definition?.styleSelectors;
+				if (!t || !t.definition || !r) return [];
+				let i = t.definition.type;
+				return n(Object.entries(r).flatMap(([e, t]) => (t ? [i, ...t.split(" ")] : [i]).map((t) => ({
+					groupLabel: e,
+					option: {
+						value: `${t}.${e}`,
+						label: `${t} (${e})`
+					}
+				}))));
+			}
+		},
+		variant: {
+			label: "Variant",
+			defaultValue: "",
+			type: "select",
+			options: (e, t, n) => {
+				let r = t?.definition?.styleSelectors, i = e.key || "";
+				if (!t || !t.definition || !r || !n?.stylePlatform || !i.includes(".")) return [];
+				let a = t.definition.type, o = i.split(".").pop() || "", s = r[o];
+				if (!s) return [];
+				let c = [], l = [a, ...s.split(" ").filter(Boolean)];
+				return Object.entries(n.stylePlatform).forEach(([e, t]) => {
+					l.forEach((n) => {
+						let r = t[n];
+						if (!r) return;
+						let i = r.attributes[o];
+						Object.keys(i.variants || {}).forEach((t) => {
+							c.push({
+								value: t,
+								label: `${e}: ${t}`
+							});
+						});
+					});
+				}), c;
+			}
+		},
+		append: {
+			label: "Append to Variant",
+			description: "Merge with existing variant values instead of replacing",
+			defaultValue: !1,
+			type: "checkbox"
+		}
+	},
+	preview: {
+		key: "",
+		variant: "",
+		append: ""
+	},
+	callback: t
+};
+//#endregion
+export { r as default };

package/dist/store/tracing/preview.mjs

@@ -19,7 +19,7 @@ var e = (e) => {
 	if (Object.is(e, t)) return !0;
 	if (e === null || t === null || typeof e != "object" || typeof t != "object" || Array.isArray(e) !== Array.isArray(t)) return !1;
 	let n = Object.keys(e), r = Object.keys(t);
-	return n.length === r.length ? n.every((n) => Object.is(e[n], t[n])) : !1;
+	return n.length === r.length && n.every((n) => Object.is(e[n], t[n]));
 }, r = (e, r) => {
 	if (!e) return [];
 	let i = [], a = /* @__PURE__ */ new Set([...Object.keys(e), ...Object.keys(r)]);

package/dist/types/DataSourceTypes.d.ts

@@ -1,15 +1,22 @@
 import { Element } from './SchemaTypes';
 import { Field, RuleValue } from '@plitzi/plitzi-ui/QueryBuilder';
+export type DataSourceUtilityParamsOption = {
+    label: string;
+    value: string;
+} | {
+    label: string;
+    options: {
+        label: string;
+        value: string;
+    }[];
+};
 export type DataSourceUtilityParams<TParams = string | boolean | number> = Record<string, {
     type?: DataSourceUtilityParamType | ((params: DataSourceUtilityParamsValue<TParams>) => DataSourceUtilityParamType);
     label?: string;
     description?: string;
     defaultValue?: string | boolean | number;
     disabled?: boolean | ((params: DataSourceUtilityParamsValue<TParams>) => boolean);
-    options?: {
-        label: string;
-        value: string;
-    }[];
+    options?: DataSourceUtilityParamsOption[] | Promise<DataSourceUtilityParamsOption[]> | ((params: DataSourceUtilityParamsValue<TParams>, element?: Partial<Element>, data?: Record<string, unknown>) => DataSourceUtilityParamsOption[] | Promise<DataSourceUtilityParamsOption[]>);
 }>;
 export type DataSourceUtilityParamsValue<T = string | boolean | number> = Record<keyof DataSourceUtility<T>['params'], T>;
 export type DataSourceUtilityParamType = 'text' | 'select' | 'textarea' | 'checkbox' | 'codemirror-text';

package/dist/types/McpTypes/index.d.ts

@@ -1,28 +1,6 @@
 import { AiContext, AiMode, PromptRole } from '../AITypes';
-import { StyleVariableCategory, StyleVariableValue } from '../StyleTypes';
-import { McpAdapters } from './McpAdapters';
 import { ToolAnnotations } from '@modelcontextprotocol/sdk/types';
 import { ZodType } from 'zod';
-export * from './McpAdapters';
-export type McpPlugin = {
-    name: string;
-    version?: string;
-    description?: string;
-};
-export type McpStyleVariable = {
-    category: StyleVariableCategory;
-    name: string;
-    value: StyleVariableValue;
-};
-export type McpSegment = {
-    id?: string;
-    identifier: string;
-    definition: {
-        name: string;
-        description: string;
-        baseElementId: string;
-    };
-};
 export type ToolOperationType = 'read' | 'write';
 export type McpPromptHandlerResult = {
     messages: {
@@ -34,27 +12,18 @@ export type McpPromptHandlerResult = {
     }[];
 };
 export type McpPromptHandler = (args: Record<string, any>, ctx: AiContext) => Promise<McpPromptHandlerResult>;
-export type McpPrompt = {
-    name: string;
-    definition: {
-        title: string;
-        description: string;
-        argsSchema?: Record<string, any>;
-    };
-    handler: McpPromptHandler;
+export type McpTextContent = {
+    type: 'text';
+    text: string;
 };
-export type McpResource = {
-    uri: string;
-    name: string;
-    description: string;
+export type McpImageContent = {
+    type: 'image';
+    data: string;
     mimeType: string;
-    content: string;
 };
+export type McpContent = McpTextContent | McpImageContent;
 export type McpToolHandlerResult = {
-    content: {
-        type: 'text';
-        text: string;
-    }[];
+    content: McpContent[];
     data?: unknown;
     structuredContent?: Record<string, unknown>;
     isError?: true;
@@ -83,14 +52,9 @@ export type McpTool = {
     definition: {
         allowedModes: AiMode[];
     };
-    adapterName?: keyof McpAdapters;
     handler?: McpToolHandler;
 };
 export type McpServerConfig = {
     enabled?: boolean;
     path?: string;
-    adapters: Partial<McpAdapters>;
-    tools?: McpTool[];
-    prompts?: McpPrompt[];
-    resources?: McpResource[];
 };

package/dist/types/SchemaTypes.d.ts

@@ -65,6 +65,9 @@ export type ElementDefinition = {
     runtime?: ElementRuntime;
     /** Controls when the element is loaded/rendered. */
     loadStrategy?: ElementLoadStrategy;
+    /** Stable, human-readable reference chosen by an AI agent (mcp-ai). Lets agents address this element
+     *  without knowing its opaque `id`. Optional and ignored by rendering. */
+    aiRef?: string;
 };
 export type Element<TAttributes extends Record<string, unknown> = Record<string, unknown>> = {
     id: string;

package/dist/types/ServerTypes.d.ts

@@ -1,6 +1,8 @@
 import { Environment } from './CommonTypes';
 import { McpServerConfig } from './McpTypes';
+import { Schema } from './SchemaTypes';
 import { OfflineDataRaw } from './SdkTypes';
+import { Style } from './StyleTypes';
 import { IncomingHttpHeaders } from 'node:http';
 import { FC } from 'react';
 export type ServerEnvironment = 'development' | 'production' | 'staging' | 'local';
@@ -123,6 +125,24 @@ export type SSRRscData = {
 export type SSRAdapters = {
     getOfflineData: (spaceId: number, environment: string, revision?: number) => Promise<OfflineDataRaw | undefined>;
     getSpaceDeployment: (req: SSRRequest) => Promise<SSRSpaceDeployment>;
+    /** Persist a space mutated by the mcp-ai `apply` tool. Implementations must recompute derived caches
+     *  (notably `style.cache`) before storing. When omitted, mcp-ai runs read/preview/validate only and
+     *  `apply` reports `persisted: false`. */
+    saveOfflineData?: (spaceId: number, environment: string, data: OfflineDataRaw) => Promise<void>;
+    /** Resolve the spaceId the MCP request operates on, from the verified `Authorization` bearer. The consumer
+     *  owns the JWT secret, so it decodes here; the MCP service stays stateless. Returns undefined when the
+     *  token is missing or invalid. Required for the `mcp` service to serve any request. */
+    getSpaceId?: (req: SSRRequest) => Promise<number | undefined>;
+    /** Read the element schema for the MCP tools. Separate from `getOfflineData` (which is SSR/RSC shaped and
+     *  strips `style.platform`); the MCP style resource needs the full documents, so schema and style split. */
+    getSchema?: (spaceId: number, environment: Environment) => Promise<Schema | undefined>;
+    /** Read the full style document (with `platform`/`mode`, which the MCP definitions resource requires). */
+    getStyle?: (spaceId: number, environment: Environment) => Promise<Style | undefined>;
+    /** Persist the element schema mutated by the MCP `apply` tool. When omitted, `apply` reports `persisted: false`. */
+    saveSchema?: (spaceId: number, environment: Environment, schema: Schema) => Promise<void>;
+    /** Persist the style document mutated by the MCP `apply` tool. Implementations must recompute `style.cache`
+     *  before storing. When omitted, `apply` reports `persisted: false`. */
+    saveStyle?: (spaceId: number, environment: Environment, style: Style) => Promise<void>;
     getUser?: (req: SSRRequest) => Promise<SSRUser | undefined>;
     onLogin?: (req: SSRRequest, res: SSRResponseHelpers) => Promise<boolean>;
     onLogout?: (req: SSRRequest, res: SSRResponseHelpers) => Promise<void>;
@@ -176,10 +196,58 @@ export type SSRServerConfig = {
     rsc?: SSRRscConfig;
     /** MCP (Model Context Protocol) server configuration — exposes schema tools to Claude. */
     mcp?: McpServerConfig;
+    /** AI-native MCP server — replaces the standard MCP with a zero-hallucination batch protocol.
+     *  When enabled, requests to the MCP path serve the AI-native server instead. */
+    mcpAi?: {
+        enabled?: boolean;
+        path?: string;
+    };
     adapters: SSRAdapters;
+    /** Draft-preview endpoint for the MCP visual-preview tools (the RENDERER side). Off unless `enabled`. */
+    preview?: SSRPreviewConfig;
+    /** For an MCP server that runs separately from the renderer (the CLIENT side): where to reach the SSR
+     *  `/preview` endpoint so the visual-preview tools work. The SDK builds an HTTP preview client from this;
+     *  absent → those tools report PREVIEW_UNAVAILABLE. */
+    previewClient?: {
+        url: string;
+        secret?: string;
+    };
+    /** Dedicated headless-browser service for plitzi_screenshot (off unless set). `serviceUrl` is the browser
+     *  service that turns a URL into PNG(s); `renderBaseUrl` is the SSR base the browser navigates to (a page
+     *  path + the one-shot `__pt` token are appended). When absent, plitzi_screenshot is not registered and only
+     *  the HTML plitzi_preview is available; when the service is unreachable at call time the tool degrades to
+     *  returning the HTML preview with a warning. */
+    screenshot?: {
+        serviceUrl: string;
+        renderBaseUrl: string;
+    };
+    /** Backing store for draft-preview tokens. Defaults to an in-memory store (single replica); inject a shared
+     *  store (e.g. Redis) for multi-replica correctness. */
+    draftStore?: DraftStore;
+    /** Which request-handling services this server mounts. Each maps to an internal `create<Name>Server` unit,
+     *  so new services scale without rewriting the dispatcher. Omitted flags fall back to sensible defaults:
+     *  ssr on, rsc when `adapters.getRscData` exists, mcp from `mcpAi.enabled`. `ai` is a reserved slot (not
+     *  wired yet). The per-service presets (createSSRServer / createMCPServer) pin these flags for you. */
+    services?: ServerServices;
+    /** Liveness/readiness endpoint for standalone servers (k8s probes). A stage always answers `path`
+     *  (default /health) with 200. The body is the generic identity payload built from `name`/`version`/`role`
+     *  ({ Server, Version, role }); pass an explicit `payload` to override it entirely. */
+    health?: {
+        path?: string;
+        payload?: Record<string, unknown>;
+        name?: string;
+        version?: string;
+        role?: string;
+    };
     /** Cache-buster appended as ?v=<assetVersion> to all default SDK asset URLs (jsPath, cssPath, react vendor). Compute from file mtime or package version at startup. */
     assetVersion?: string;
 };
+export type ServerServices = {
+    ssr?: boolean;
+    rsc?: boolean;
+    mcp?: boolean;
+    ai?: boolean;
+};
 export type PluginRegistry = {
     register: (name: string, source: PluginSource) => void;
     invalidate: (name?: string, version?: string) => Promise<void>;
@@ -206,3 +274,23 @@ export type SSRServer = {
     readonly cache: CacheManager | null;
     readonly plugins: PluginRegistry;
 };
+/** A short-TTL, one-shot store for unsaved draft offline-data behind a preview token. The SDK ships an
+ *  in-memory default (fine for a single replica); a multi-replica deployment injects a shared (e.g. Redis)
+ *  implementation so a preview URL resolves on whichever replica the browser lands on. `take` consumes the
+ *  token so a preview URL is not replayable. */
+export type DraftStore = {
+    put: (token: string, data: OfflineDataRaw, ttlMs: number) => void | Promise<void>;
+    take: (token: string) => (OfflineDataRaw | undefined) | Promise<OfflineDataRaw | undefined>;
+};
+/** Draft-preview config for the MCP visual-preview tools. When enabled, an internal endpoint at `path`
+ *  (guarded by `secret`) applies unsaved edits to a clone, stashes the resulting offline-data under a
+ *  one-shot token, and the render path serves it back at `?__pt=<token>`. Off by default. */
+export type SSRPreviewConfig = {
+    enabled?: boolean;
+    /** Internal endpoint path that mints a preview token. Default '/__preview'. */
+    path?: string;
+    /** Shared secret required in the `x-preview-secret` header; requests without it are rejected. */
+    secret?: string;
+    /** Token time-to-live in milliseconds. Default 60000. */
+    ttlMs?: number;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plitzi/sdk-shared",
-  "version": "0.32.3",
+  "version": "0.32.5",
   "license": "AGPL-3.0",
   "files": [
     "dist",
@@ -102,6 +102,10 @@
       "types": "./dist/dataSource/utility/styleSelector.d.ts",
       "import": "./dist/dataSource/utility/styleSelector.mjs"
     },
+    "./dataSource/utility/styleVariant": {
+      "types": "./dist/dataSource/utility/styleVariant.d.ts",
+      "import": "./dist/dataSource/utility/styleVariant.mjs"
+    },
     "./dataSource/utility/twigTemplate": {
       "types": "./dist/dataSource/utility/twigTemplate.d.ts",
       "import": "./dist/dataSource/utility/twigTemplate.mjs"
@@ -1006,9 +1010,6 @@
     "./types/InteractionTypes": {
       "types": "./dist/types/InteractionTypes.d.ts"
     },
-    "./types/McpTypes/McpAdapters": {
-      "types": "./dist/types/McpTypes/McpAdapters.d.ts"
-    },
     "./types/McpTypes/index": {
       "types": "./dist/types/McpTypes/index.d.ts"
     },
@@ -1075,12 +1076,12 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@plitzi/nexus": "0.32.3",
+    "@plitzi/nexus": "0.32.5",
     "@plitzi/plitzi-ui": "^1.6.13",
     "date-fns": "^4.4.0",
     "date-fns-tz": "^3.2.0",
     "graphql-tag": "^2.12.7",
-    "immer": "^11.1.8",
+    "immer": "^11.1.11",
     "twig": "^3.0.0",
     "zod": "^4.4.3"
   },
@@ -1089,7 +1090,7 @@
     "react-dom": "^19"
   },
   "devDependencies": {
-    "@babel/cli": "^8.0.1",
+    "@babel/cli": "^8.0.4",
     "@babel/core": "^8.0.1",
     "@babel/eslint-parser": "^8.0.1",
     "@babel/plugin-syntax-flow": "^8.0.1",
@@ -1104,38 +1105,38 @@
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
     "@types/twig": "^1.12.17",
-    "@vitejs/plugin-react": "^6.0.2",
-    "@vitest/coverage-v8": "^4.1.9",
+    "@vitejs/plugin-react": "^6.0.3",
+    "@vitest/coverage-v8": "^4.1.10",
     "babel-minify": "^0.5.2",
     "eslint": "^9.39.4",
     "eslint-config-airbnb": "^19.0.4",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-config-turbo": "^2.9.18",
+    "eslint-config-turbo": "^2.10.4",
     "eslint-import-resolver-alias": "^1.1.2",
-    "eslint-plugin-cypress": "^6.4.1",
+    "eslint-plugin-cypress": "^6.4.2",
     "eslint-plugin-flowtype": "8.0.3",
     "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-jsdoc": "^63.0.7",
+    "eslint-plugin-jsdoc": "^63.0.13",
     "eslint-plugin-jsx-a11y": "^6.10.2",
     "eslint-plugin-prettier": "^5.5.6",
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^7.1.1",
     "eslint-plugin-react-refresh": "^0.5.3",
-    "eslint-plugin-storybook": "^10.4.6",
-    "globals": "^17.6.0",
+    "eslint-plugin-storybook": "^10.5.0",
+    "globals": "^17.7.0",
     "jsdom": "^29.1.1",
-    "postcss": "^8.5.15",
-    "prettier": "^3.8.4",
+    "postcss": "^8.5.17",
+    "prettier": "^3.9.5",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
-    "tailwindcss": "^4.3.1",
-    "terser": "^5.48.0",
+    "tailwindcss": "^4.3.2",
+    "terser": "^5.49.0",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.61.1",
-    "vite": "^8.0.16",
-    "vite-plugin-dts": "^5.0.2",
+    "typescript-eslint": "^8.63.0",
+    "vite": "^8.1.4",
+    "vite-plugin-dts": "^5.0.3",
     "vite-plugin-react": "^4.0.1",
-    "vitest": "^4.1.9",
+    "vitest": "^4.1.10",
     "vitest-fetch-mock": "^0.4.5"
   }
 }

package/dist/types/McpTypes/McpAdapters.d.ts

@@ -1,455 +0,0 @@
-import { AiContext, DisplayMode, Resource, StyleCategory, StyleItem, StyleVariableCategory, StyleVariableValue, TagType } from '../..';
-import { McpPlugin, McpSegment, McpStyleVariable } from '../McpTypes';
-import { DropPosition, Element, PageFolder, Schema, SchemaVariable } from '../SchemaTypes';
-import { Theme } from '../ThemeTypes';
-export type McpAdapter<R = any, T extends Record<string, any> = Record<string, any>> = (args: T, ctx: AiContext) => Promise<{
-    data: R;
-} | {
-    error: Error | string;
-}>;
-export type McpAdaptersSchema = {
-    applyPreview: McpAdapter<{
-        baseElementId: string;
-        targetParentId: string;
-        elementCount: number;
-    }, {
-        schema: {
-            flat: Record<string, Element>;
-        };
-        style?: Record<string, unknown>;
-        baseElementId: string;
-        targetParentId: string;
-        dropPosition?: DropPosition;
-    }>;
-};
-export type PageElementSummary = {
-    id: string;
-    label: string;
-    type: string;
-    parentId: string | null;
-    attributes: Record<string, unknown>;
-};
-export type McpAdaptersPages = {
-    getPage: McpAdapter<{
-        page: Element;
-        elements: PageElementSummary[];
-    } | undefined, {
-        pageId: string;
-    }>;
-    getPages: McpAdapter<Element[]>;
-    getPageBySlug: McpAdapter<Element | undefined, {
-        slug: string;
-    }>;
-    createPage: McpAdapter<Element, {
-        name: string;
-    }>;
-    updatePage: McpAdapter<Element, {
-        pageId: string;
-        updates: {
-            name?: string;
-            slug?: string;
-            default?: boolean;
-            folder?: string;
-        };
-    }>;
-    deletePage: McpAdapter<boolean, {
-        pageId: string;
-    }>;
-};
-export type McpAdaptersPageFolders = {
-    getPageFolder: McpAdapter<PageFolder | undefined, {
-        folderId: string;
-    }>;
-    getPageFolders: McpAdapter<PageFolder[]>;
-    createPageFolder: McpAdapter<PageFolder, {
-        name: string;
-        parentId?: string;
-    }>;
-    updatePageFolder: McpAdapter<PageFolder, {
-        id: string;
-        updates: Partial<Pick<PageFolder, 'name' | 'slug' | 'parentId'>>;
-    }>;
-    deletePageFolder: McpAdapter<boolean, {
-        id: string;
-    }>;
-};
-export type McpAdaptersElements = {
-    createElement: McpAdapter<Element | undefined, {
-        element: Element;
-        parentId?: string;
-        position?: number;
-    }>;
-    getElement: McpAdapter<Element | undefined, {
-        elementId: string;
-    }>;
-    getElements: McpAdapter<Element[], {
-        pageId?: string;
-        type?: string;
-        parentId?: string;
-    }>;
-    listElements: McpAdapter<{
-        id: string;
-        label: string;
-        type: string;
-        parentId?: string;
-        items?: string[];
-    }[], {
-        rootId?: string;
-        parentId?: string;
-        type?: string;
-    }>;
-    updateElement: McpAdapter<Element, Element>;
-    deleteElement: McpAdapter<boolean, {
-        elementId: string;
-    }>;
-    moveElement: McpAdapter<boolean, {
-        elementId: string;
-        toParentId: string;
-        dropPosition?: DropPosition;
-    }>;
-    cloneElement: McpAdapter<{
-        id: string;
-        label: string;
-        type: string;
-        parentId?: string;
-        items?: string[];
-    }[], {
-        elementId: string;
-        to: string;
-        dropPosition: DropPosition;
-    }>;
-};
-export type McpAdaptersSchemaVariables = {
-    getVariable: McpAdapter<SchemaVariable | undefined, {
-        name: string;
-    }>;
-    getVariables: McpAdapter<SchemaVariable[]>;
-    createSchemaVariable: McpAdapter<SchemaVariable, {
-        variable: Pick<SchemaVariable, 'name' | 'type' | 'value' | 'category'>;
-    }>;
-    updateSchemaVariable: McpAdapter<SchemaVariable, {
-        variable: Partial<SchemaVariable> & {
-            name: string;
-        };
-    }>;
-    deleteSchemaVariable: McpAdapter<boolean, {
-        name: string;
-    }>;
-};
-export type McpAdaptersStyles = {
-    getStyleVariables: McpAdapter<Record<string, Record<string, StyleVariableValue>>>;
-    getStyleVariable: McpAdapter<StyleVariableValue | undefined, {
-        category: StyleVariableCategory;
-        name: string;
-    }>;
-    getStyleSelectors: McpAdapter<Record<string, string[]>, {
-        displayMode?: string;
-    }>;
-    updateStyle: McpAdapter;
-    updateStyleSettings: McpAdapter;
-};
-export type McpAdaptersStylesVariables = {
-    createStyleVariable: McpAdapter<{
-        category: StyleVariableCategory;
-        name: string;
-        value: StyleVariableValue;
-    }, McpStyleVariable>;
-    updateStyleVariable: McpAdapter<McpStyleVariable, {
-        category: StyleVariableCategory;
-        name: string;
-        value: StyleVariableValue;
-    }>;
-    deleteStyleVariable: McpAdapter<boolean, {
-        category: StyleVariableCategory;
-        name: string;
-    }>;
-};
-export type McpAdaptersStylesSelectors = {
-    createStyleSelector: McpAdapter<StyleItem, {
-        displayMode: DisplayMode;
-        selector: string;
-        type: TagType;
-        path?: StyleCategory;
-        style?: StyleItem['attributes'];
-        params?: Record<string, unknown>;
-    }>;
-    updateStyleSelector: McpAdapter<StyleItem, {
-        displayMode: DisplayMode;
-        selector: string;
-        type: TagType;
-        path?: StyleCategory;
-        style?: StyleItem['attributes'];
-        params?: Record<string, unknown>;
-    }>;
-    deleteStyleSelector: McpAdapter<boolean, {
-        displayMode: DisplayMode;
-        selector: string;
-    }>;
-};
-export type McpAdaptersSegments = {
-    createSegment: McpAdapter<McpSegment, {
-        name: string;
-        description: string;
-    }>;
-    updateSegment: McpAdapter<McpSegment, {
-        segmentId: string;
-        updates: {
-            name?: string;
-            description?: string;
-        };
-    }>;
-    deleteSegment: McpAdapter<boolean, {
-        segmentId: string;
-    }>;
-    getSegment: McpAdapter<Record<string, unknown> | undefined, {
-        segmentId?: string;
-        identifier?: string;
-    }>;
-    getSegments: McpAdapter<Record<string, unknown>[], {
-        cursor?: string;
-        limit?: number;
-    }>;
-    createSegmentElement: McpAdapter<Element, {
-        segmentId: string;
-        element: {
-            type: string;
-            label: string;
-            props?: Record<string, unknown>;
-        };
-        parentId: string;
-    }>;
-    updateSegmentElement: McpAdapter<Element, {
-        segmentId: string;
-        elementId: string;
-        updates: {
-            label?: string;
-            props?: Record<string, unknown>;
-        };
-    }>;
-    moveSegmentElement: McpAdapter<boolean, {
-        segmentId: string;
-        elementId: string;
-        toParentId: string;
-        dropPosition?: DropPosition;
-    }>;
-    deleteSegmentElement: McpAdapter<boolean, {
-        segmentId: string;
-        elementId: string;
-    }>;
-    cloneSegmentElement: McpAdapter;
-    createSegmentVariable: McpAdapter<SchemaVariable, {
-        segmentId: string;
-        variable: Pick<SchemaVariable, 'name' | 'type' | 'value' | 'category'>;
-    }>;
-    updateSegmentVariable: McpAdapter<SchemaVariable, {
-        segmentId: string;
-        variable: Partial<SchemaVariable> & {
-            name: string;
-        };
-    }>;
-    deleteSegmentVariable: McpAdapter<boolean, {
-        segmentId: string;
-        name: string;
-    }>;
-    createSegmentStyleVariable: McpAdapter<McpStyleVariable, {
-        segmentId: string;
-        category: StyleVariableCategory;
-        name: string;
-        value: StyleVariableValue;
-    }>;
-    updateSegmentStyleVariable: McpAdapter<McpStyleVariable, {
-        segmentId: string;
-        category: StyleVariableCategory;
-        name: string;
-        value: StyleVariableValue;
-    }>;
-    deleteSegmentStyleVariable: McpAdapter<boolean, {
-        segmentId: string;
-        category: StyleVariableCategory;
-        name: string;
-    }>;
-    addSegmentStyleSelector: McpAdapter<StyleItem, {
-        segmentId: string;
-        displayMode: DisplayMode;
-        selector: string;
-        type: TagType;
-        path?: StyleCategory;
-        style?: StyleItem['attributes'];
-        params: Record<string, unknown>;
-    }>;
-    updateSegmentStyleSelector: McpAdapter<StyleItem, {
-        segmentId: string;
-        displayMode: DisplayMode;
-        selector: string;
-        path?: StyleCategory;
-        style?: StyleItem['attributes'];
-        params: Record<string, unknown>;
-    }>;
-    deleteSegmentStyleSelector: McpAdapter<boolean, {
-        segmentId: string;
-        displayMode: DisplayMode;
-        selector: string;
-    }>;
-    addSegmentStyleSelectorVariable: McpAdapter<{
-        displayMode: DisplayMode;
-        selector: string;
-        category: StyleVariableCategory;
-        name: string;
-        value: StyleVariableValue;
-    }, {
-        segmentId: string;
-        displayMode: DisplayMode;
-        selector: string;
-        category: StyleVariableCategory;
-        name: string;
-        value: StyleVariableValue;
-    }>;
-    updateSegmentStyleSelectorVariable: McpAdapter<{
-        displayMode: DisplayMode;
-        selector: string;
-        category: StyleVariableCategory;
-        name: string;
-        value: StyleVariableValue;
-    }, {
-        segmentId: string;
-        displayMode: DisplayMode;
-        selector: string;
-        category: StyleVariableCategory;
-        name: string;
-        value: StyleVariableValue;
-    }>;
-    removeSegmentStyleSelectorVariable: McpAdapter<boolean, {
-        segmentId: string;
-        displayMode: DisplayMode;
-        selector: string;
-        category: StyleVariableCategory;
-        name: string;
-    }>;
-    addSegmentSelectorVariable: McpAdapter<{
-        displayMode: DisplayMode;
-        selector: string;
-        category: StyleVariableCategory;
-        name: string;
-        value: StyleVariableValue;
-    }, {
-        segmentId: string;
-        displayMode: DisplayMode;
-        selector: string;
-        category: StyleVariableCategory;
-        name: string;
-        value: StyleVariableValue;
-    }>;
-    updateSegmentSelectorVariable: McpAdapter<{
-        displayMode: DisplayMode;
-        selector: string;
-        category: StyleVariableCategory;
-        name: string;
-        value: StyleVariableValue;
-    }, {
-        segmentId: string;
-        displayMode: DisplayMode;
-        selector: string;
-        category: StyleVariableCategory;
-        name: string;
-        value: StyleVariableValue;
-    }>;
-    removeSegmentSelectorVariable: McpAdapter<boolean, {
-        segmentId: string;
-        displayMode: DisplayMode;
-        selector: string;
-        category: StyleVariableCategory;
-        name: string;
-    }>;
-};
-export type McpAdaptersPlugins = {
-    listPlugins: McpAdapter<McpPlugin[]>;
-    addPlugin: McpAdapter<{
-        type: string;
-        resource: string;
-        settings: Record<string, unknown>;
-    }, {
-        pluginType: string;
-        resource: string;
-        override?: boolean;
-    }>;
-    updatePlugin: McpAdapter<{
-        type: string;
-        resource: string;
-        settings: Record<string, unknown>;
-    }, {
-        pluginType: string;
-        resource: string;
-    }>;
-    removePlugin: McpAdapter<boolean, {
-        pluginType: string;
-    }>;
-};
-export type McpAdaptersCollections = {
-    getCollections: McpAdapter<Record<string, unknown>[], Record<string, unknown>>;
-    getCollection: McpAdapter<Record<string, unknown> | undefined, {
-        collectionId: string;
-    }>;
-    createCollection: McpAdapter;
-    updateCollection: McpAdapter;
-    deleteCollection: McpAdapter<boolean, any>;
-    getCollectionRecords: McpAdapter;
-    getCollectionRecord: McpAdapter;
-    createCollectionRecord: McpAdapter;
-    updateCollectionRecord: McpAdapter;
-    deleteCollectionRecord: McpAdapter<boolean, {
-        collectionId: string;
-        recordId: string;
-    }>;
-};
-export type McpAdaptersResources = {
-    getResources: McpAdapter;
-    getResource: McpAdapter<Resource | undefined, {
-        identifier: string;
-        cdnIdentifier: string;
-    }>;
-    addResource: McpAdapter<Resource | undefined, {
-        url: string;
-        cdnIdentifier: string;
-        filename?: string;
-        type?: string;
-        prefix?: string;
-        compression?: string;
-    }>;
-    moveResource: McpAdapter<Resource | undefined, {
-        identifier: string;
-        cdnIdentifier: string;
-        prefix: string;
-    }>;
-    removeResource: McpAdapter<{
-        id: string;
-    } | undefined, {
-        identifier: string;
-        cdnIdentifier: string;
-    }>;
-};
-export type McpAdaptersSpace = {
-    getSpaceSettings: McpAdapter<Schema['settings'] | undefined>;
-    updateSpaceSettings: McpAdapter<Schema['settings'], {
-        path?: string;
-        value?: string | number | boolean;
-    }>;
-};
-export type McpAdapters = {
-    getBuilderContext: McpAdapter<{
-        currentPageId?: string;
-        selectedElementId?: string;
-        cssVariables: Record<string, {
-            default: string;
-            light?: string;
-            dark?: string;
-        }> | undefined;
-        elementDefaults: any;
-        elements: {
-            id: string;
-            label: string;
-            type: string;
-            parentId?: string;
-        }[];
-        theme?: Exclude<Theme, 'system'>;
-    } | undefined>;
-} & McpAdaptersSchema & McpAdaptersPages & McpAdaptersPageFolders & McpAdaptersElements & McpAdaptersSchemaVariables & McpAdaptersStyles & McpAdaptersStylesVariables & McpAdaptersStylesSelectors & McpAdaptersSegments & McpAdaptersPlugins & McpAdaptersCollections & McpAdaptersResources & McpAdaptersSpace;