@plitzi/sdk-shared 0.30.19 → 0.31.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plitzi/sdk-shared",
-  "version": "0.30.19",
+  "version": "0.31.0",
   "license": "AGPL-3.0",
   "files": [
     "dist",
@@ -50,10 +50,6 @@
       "types": "./dist/dataSource/index.d.ts",
       "import": "./dist/dataSource/index.mjs"
     },
-    "./dataSource/DataSourceContext": {
-      "types": "./dist/dataSource/DataSourceContext.d.ts",
-      "import": "./dist/dataSource/DataSourceContext.mjs"
-    },
     "./dataSource/hooks": {
       "types": "./dist/dataSource/hooks/index.d.ts",
       "import": "./dist/dataSource/hooks/index.mjs"
@@ -66,6 +62,10 @@
       "types": "./dist/dataSource/hooks/useDataSource.d.ts",
       "import": "./dist/dataSource/hooks/useDataSource.mjs"
     },
+    "./dataSource/hooks/useRegisterSource": {
+      "types": "./dist/dataSource/hooks/useRegisterSource.d.ts",
+      "import": "./dist/dataSource/hooks/useRegisterSource.mjs"
+    },
     "./dataSource/index": {
       "types": "./dist/dataSource/index.d.ts",
       "import": "./dist/dataSource/index.mjs"
@@ -901,6 +901,9 @@
       "types": "./dist/types/index.d.ts",
       "import": "./dist/types/index.mjs"
     },
+    "./types/AITypes": {
+      "types": "./dist/types/AITypes.d.ts"
+    },
     "./types/AuthTypes": {
       "types": "./dist/types/AuthTypes.d.ts"
     },
@@ -931,8 +934,11 @@
     "./types/InteractionTypes": {
       "types": "./dist/types/InteractionTypes.d.ts"
     },
-    "./types/McpTypes": {
-      "types": "./dist/types/McpTypes.d.ts"
+    "./types/McpTypes/McpAdapters": {
+      "types": "./dist/types/McpTypes/McpAdapters.d.ts"
+    },
+    "./types/McpTypes/index": {
+      "types": "./dist/types/McpTypes/index.d.ts"
     },
     "./types/NavigationTypes": {
       "types": "./dist/types/NavigationTypes.d.ts"
@@ -943,9 +949,6 @@
     "./types/ResourceTypes": {
       "types": "./dist/types/ResourceTypes.d.ts"
     },
-    "./types/SchemaTypes": {
-      "types": "./dist/types/SchemaTypes.d.ts"
-    },
     "./types/SdkTypes": {
       "types": "./dist/types/SdkTypes.d.ts"
     },
@@ -999,65 +1002,67 @@
     "build:prod": "vite build && node ./scripts/generate-exports.mjs"
   },
   "dependencies": {
-    "@plitzi/plitzi-ui": "^1.6.2",
-    "@plitzi/sdk-store": "0.30.19",
-    "date-fns": "^4.1.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@plitzi/plitzi-ui": "^1.6.9",
+    "@plitzi/sdk-store": "0.31.0",
+    "date-fns": "^4.3.0",
     "date-fns-tz": "^3.2.0",
     "graphql-tag": "^2.12.6",
-    "twig": "^3.0.0"
+    "twig": "^3.0.0",
+    "zod": "^4.4.3"
   },
   "peerDependencies": {
     "react": "^19",
     "react-dom": "^19"
   },
   "devDependencies": {
-    "@babel/cli": "^7.28.6",
-    "@babel/core": "^7.29.0",
-    "@babel/eslint-parser": "^7.28.6",
-    "@babel/plugin-syntax-flow": "^7.28.6",
-    "@babel/plugin-transform-react-jsx": "^7.28.6",
-    "@babel/preset-env": "^7.29.2",
+    "@babel/cli": "^7.29.7",
+    "@babel/core": "^7.29.7",
+    "@babel/eslint-parser": "^7.29.7",
+    "@babel/plugin-syntax-flow": "^7.29.7",
+    "@babel/plugin-transform-react-jsx": "^7.29.7",
+    "@babel/preset-env": "^7.29.7",
     "@eslint/js": "^10.0.1",
     "@tailwindcss/forms": "^0.5.11",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
     "@testing-library/react-hooks": "^8.0.1",
     "@testing-library/user-event": "^14.6.1",
-    "@types/react": "^19.2.14",
+    "@types/react": "^19.2.15",
     "@types/react-dom": "^19.2.3",
     "@types/twig": "^1.12.17",
-    "@vitejs/plugin-react": "^6.0.1",
-    "@vitest/coverage-v8": "^4.1.5",
+    "@vitejs/plugin-react": "^6.0.2",
+    "@vitest/coverage-v8": "^4.1.7",
     "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.6",
+    "eslint-config-turbo": "^2.9.14",
     "eslint-import-resolver-alias": "^1.1.2",
-    "eslint-plugin-cypress": "^6.4.0",
+    "eslint-plugin-cypress": "^6.4.1",
     "eslint-plugin-flowtype": "8.0.3",
     "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-jsdoc": "^62.9.0",
+    "eslint-plugin-jsdoc": "^63.0.0",
     "eslint-plugin-jsx-a11y": "^6.10.2",
     "eslint-plugin-prettier": "^5.5.5",
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^7.1.1",
     "eslint-plugin-react-refresh": "^0.5.2",
-    "eslint-plugin-storybook": "^10.3.6",
-    "globals": "^17.5.0",
+    "eslint-plugin-storybook": "^10.4.1",
+    "globals": "^17.6.0",
     "jsdom": "^29.1.1",
-    "postcss": "^8.5.12",
+    "postcss": "^8.5.15",
     "prettier": "^3.8.3",
-    "react": "^19.2.5",
-    "react-dom": "^19.2.5",
-    "tailwindcss": "^4.2.4",
-    "terser": "^5.46.2",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "tailwindcss": "^4.3.0",
+    "terser": "^5.48.0",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.59.1",
-    "vite": "^8.0.10",
-    "vite-plugin-dts": "^5.0.0",
+    "typescript-eslint": "^8.60.0",
+    "vite": "^8.0.14",
+    "vite-plugin-dts": "^5.0.1",
     "vite-plugin-react": "^4.0.1",
-    "vitest": "^4.1.5",
+    "vitest": "^4.1.7",
     "vitest-fetch-mock": "^0.4.5"
   }
 }

package/dist/dataSource/DataSourceContext.d.ts

@@ -1,3 +0,0 @@
-import { DataSourceContextValue } from '../types';
-declare const DataSourceContext: import('react').Context<DataSourceContextValue>;
-export default DataSourceContext;

package/dist/dataSource/DataSourceContext.mjs

@@ -1,5 +0,0 @@
-import { createContext as e } from "react";
-var t = e({});
-t.displayName = "DataSourceContext";
-//#endregion
-export { t as default };

package/dist/dataSource/hooks/useDataSource.d.ts

@@ -1,20 +0,0 @@
-import { SourceMeta } from '../../types';
-import { Context } from 'react';
-export type UseDataSourceMode = 'write' | 'read';
-export type UseDataSourceFilter = 'soft' | 'hard';
-export type UseDataSourceProps<T extends UseDataSourceMode> = {
-    id?: string;
-    fields?: SourceMeta['fields'];
-    mode: T;
-    sourceFilter?: string[];
-    filterMode?: UseDataSourceFilter;
-} & (T extends 'read' ? {
-    name?: string;
-    source?: string;
-} : {
-    name: string;
-    source: string;
-});
-declare function useDataSource<T = unknown>(props: UseDataSourceProps<'read'>): Record<string, T>;
-declare function useDataSource<T = unknown>(props: UseDataSourceProps<'write'>): [Context<T>, string];
-export default useDataSource;

package/dist/dataSource/hooks/useDataSource.mjs

@@ -1,45 +0,0 @@
-import { emptyObject as e, makeId as t } from "../../helpers/utils.mjs";
-import n from "../DataSourceContext.mjs";
-import { use as r, useEffect as i, useMemo as a, useRef as o } from "react";
-//#region src/dataSource/hooks/useDataSource.ts
-function s({ id: s = "", source: c, name: l, fields: u = [], mode: d = "write", sourceFilter: f = [], filterMode: p = "soft" }) {
-	let { addSource: m, getSources: h, updateFields: g, removeSource: _ } = r(n), v = o(!1), y = a(() => `${s}_${t(8)}`, [s]), b = o(void 0), x = o({});
-	if (d === "write" && (!l || !c)) throw Error("Name and Source are required in write mode");
-	if (d === "write" && !v.current && (v.current = !0, b.current = m(y, {
-		id: s,
-		source: c,
-		name: l,
-		fields: u
-	})), i(() => (d === "write" && !v.current && (v.current = !0, b.current = m(y, {
-		id: s,
-		source: c,
-		name: l,
-		fields: u
-	})), () => {
-		v.current = !1, _(y);
-	}), [y]), i(() => {
-		d === "write" && g(y, u);
-	}, [
-		u,
-		y,
-		g,
-		d
-	]), d === "write") return [b.current, y];
-	if (p === "hard" && !f.length) return e;
-	let S = Object.values(h());
-	f.length && (S = S.filter((e) => !f.length || !e.meta.source || f.includes(e.meta.source)));
-	let C = S.filter((e) => e.meta.source).map((e) => ({
-		...e,
-		value: r(e.context)
-	})).reduce((e, t) => ({
-		...e,
-		[t.meta.source]: t.value
-	}), {});
-	return Object.entries(x.current).filter(([e, t]) => t !== C[e]).length > 0 || Object.keys(C).length !== Object.keys(x.current).length ? x.current = C : (Object.keys(x.current).forEach((e) => {
-		delete x.current[e];
-	}), Object.entries(C).forEach(([e, t]) => {
-		x.current[e] = t;
-	})), x.current;
-}
-//#endregion
-export { s as default };

package/dist/types/McpTypes.d.ts

@@ -1,164 +0,0 @@
-import { PageFolder, SchemaVariable, DropPosition } from './SchemaTypes';
-import { DisplayMode, StyleCategory, StyleItem, StyleVariableCategory, StyleVariableValue, TagType } from './StyleTypes';
-export type McpSpace = {
-    id: number;
-    name: string;
-    environments?: string[];
-};
-export type McpElement = {
-    id: string;
-    type: string;
-    label: string;
-    parentId?: string;
-    props?: Record<string, unknown>;
-    styles?: Record<string, unknown>;
-    runtime?: 'server' | 'client' | 'shared';
-    children?: string[];
-};
-export type McpSchema = {
-    spaceId: number;
-    environment: string;
-    revision: number;
-    elements: Record<string, McpElement>;
-};
-export type McpPlugin = {
-    name: string;
-    version?: string;
-    description?: string;
-};
-export type McpPage = {
-    id: string;
-    name: string;
-    isDefault: boolean;
-};
-export type McpStyleVariable = {
-    category: StyleVariableCategory;
-    name: string;
-    value: StyleVariableValue;
-};
-export type McpStyleSelector = {
-    displayMode: DisplayMode;
-    selector: string;
-    type: TagType;
-    path?: StyleCategory;
-    style?: StyleItem['attributes'];
-    params: Record<string, unknown>;
-};
-export type McpSegment = {
-    id?: string;
-    identifier: string;
-    definition: {
-        name: string;
-        description: string;
-        baseElementId: string;
-    };
-};
-export type McpAdapters = {
-    /** Return all spaces the agent may access. */
-    listSpaces: () => Promise<McpSpace[]>;
-    /** Return the full element tree for a space + environment. */
-    getSchema: (spaceId: number, environment: string) => Promise<McpSchema | undefined>;
-    /** Add a new element to the schema. Returns the created element with its generated ID. */
-    createElement: (spaceId: number, environment: string, element: {
-        type: string;
-        label: string;
-        props?: Record<string, unknown>;
-        runtime?: 'server' | 'client' | 'shared';
-    }, parentId?: string, position?: number) => Promise<McpElement>;
-    /** Update an existing element's label, props, styles, or runtime. */
-    updateElement: (spaceId: number, environment: string, elementId: string, updates: {
-        label?: string;
-        props?: Record<string, unknown>;
-        styles?: Record<string, unknown>;
-        runtime?: 'server' | 'client' | 'shared';
-    }) => Promise<McpElement>;
-    /** Remove an element and its descendants from the schema. */
-    deleteElement: (spaceId: number, environment: string, elementId: string) => Promise<void>;
-    /** Move an element to a different parent. */
-    moveElement: (spaceId: number, environment: string, elementId: string, toParentId: string, dropPosition?: DropPosition) => Promise<{
-        success: boolean;
-    }>;
-    /** Publish the current draft as a new revision. Returns the new revision number. */
-    publishSchema: (spaceId: number, environment: string) => Promise<{
-        revision: number;
-    }>;
-    /** Optional: list plugins registered in the system. */
-    listPlugins?: () => Promise<McpPlugin[]>;
-    /** Create a new page. */
-    createPage: (spaceId: number, environment: string, name: string) => Promise<McpPage>;
-    /** Delete a page by ID. */
-    deletePage: (spaceId: number, environment: string, pageId: string) => Promise<void>;
-    /** Create a new page folder. */
-    createPageFolder: (spaceId: number, environment: string, name: string, parentId?: string) => Promise<PageFolder>;
-    /** Update a page folder. */
-    updatePageFolder: (spaceId: number, environment: string, id: string, updates: Partial<Pick<PageFolder, 'name' | 'slug' | 'parentId'>>) => Promise<PageFolder>;
-    /** Delete a page folder. */
-    deletePageFolder: (spaceId: number, environment: string, id: string) => Promise<void>;
-    /** Create a schema variable. */
-    createVariable: (spaceId: number, environment: string, variable: Pick<SchemaVariable, 'name' | 'type' | 'value' | 'category'>) => Promise<SchemaVariable>;
-    /** Update a schema variable. */
-    updateVariable: (spaceId: number, environment: string, variable: Partial<SchemaVariable> & {
-        name: string;
-    }) => Promise<SchemaVariable>;
-    /** Delete a schema variable. */
-    deleteVariable: (spaceId: number, environment: string, name: string) => Promise<void>;
-    /** Create a global style variable. */
-    createStyleVariable: (spaceId: number, environment: string, category: StyleVariableCategory, name: string, value: StyleVariableValue) => Promise<McpStyleVariable>;
-    /** Update a global style variable. */
-    updateStyleVariable: (spaceId: number, environment: string, category: StyleVariableCategory, name: string, value: StyleVariableValue) => Promise<McpStyleVariable>;
-    /** Delete a global style variable. */
-    deleteStyleVariable: (spaceId: number, environment: string, category: StyleVariableCategory, name: string) => Promise<void>;
-    /** Create a global style selector. */
-    createStyleSelector: (spaceId: number, environment: string, displayMode: DisplayMode, selector: string, type: TagType, path?: StyleCategory, style?: StyleItem['attributes'], params?: Record<string, unknown>) => Promise<McpStyleSelector>;
-    /** Update a global style selector. */
-    updateStyleSelector: (spaceId: number, environment: string, displayMode: DisplayMode, selector: string, type: TagType, path?: StyleCategory, style?: StyleItem['attributes'], params?: Record<string, unknown>) => Promise<McpStyleSelector>;
-    /** Delete a global style selector. */
-    deleteStyleSelector: (spaceId: number, environment: string, displayMode: DisplayMode, selector: string) => Promise<void>;
-    /** Create a segment. */
-    createSegment: (spaceId: number, name: string, description: string) => Promise<McpSegment>;
-    /** Update a segment. */
-    updateSegment: (spaceId: number, segmentId: string, updates: {
-        name?: string;
-        description?: string;
-    }) => Promise<McpSegment>;
-    /** Delete a segment. */
-    deleteSegment: (spaceId: number, segmentId: string) => Promise<void>;
-    /** Add an element to a segment. */
-    createSegmentElement: (spaceId: number, segmentId: string, element: {
-        type: string;
-        label: string;
-        props?: Record<string, unknown>;
-    }, parentId: string) => Promise<McpElement>;
-    /** Update an element inside a segment. */
-    updateSegmentElement: (spaceId: number, segmentId: string, elementId: string, updates: {
-        label?: string;
-        props?: Record<string, unknown>;
-    }) => Promise<McpElement>;
-    /** Move an element inside a segment. */
-    moveSegmentElement: (spaceId: number, segmentId: string, elementId: string, toParentId: string, dropPosition?: DropPosition) => Promise<{
-        success: boolean;
-    }>;
-    /** Remove an element from a segment. */
-    deleteSegmentElement: (spaceId: number, segmentId: string, elementId: string) => Promise<void>;
-    /** Create a segment schema variable. */
-    createSegmentVariable: (spaceId: number, segmentId: string, variable: Pick<SchemaVariable, 'name' | 'type' | 'value' | 'category'>) => Promise<SchemaVariable>;
-    /** Update a segment schema variable. */
-    updateSegmentVariable: (spaceId: number, segmentId: string, variable: Partial<SchemaVariable> & {
-        name: string;
-    }) => Promise<SchemaVariable>;
-    /** Delete a segment schema variable. */
-    deleteSegmentVariable: (spaceId: number, segmentId: string, name: string) => Promise<void>;
-    /** Create a segment style variable. */
-    createSegmentStyleVariable: (spaceId: number, segmentId: string, category: StyleVariableCategory, name: string, value: StyleVariableValue) => Promise<McpStyleVariable>;
-    /** Update a segment style variable. */
-    updateSegmentStyleVariable: (spaceId: number, segmentId: string, category: StyleVariableCategory, name: string, value: StyleVariableValue) => Promise<McpStyleVariable>;
-    /** Delete a segment style variable. */
-    deleteSegmentStyleVariable: (spaceId: number, segmentId: string, category: StyleVariableCategory, name: string) => Promise<void>;
-};
-export type McpServerConfig = {
-    /** Whether the MCP endpoint is active. Defaults to true. */
-    enabled?: boolean;
-    /** URL path for the MCP endpoint. Defaults to '/mcp'. */
-    path?: string;
-    adapters: McpAdapters;
-};