@plitzi/sdk-shared 0.37.9 → 0.38.1

package/dist/types/StyleTypes.d.ts

@@ -13,6 +13,7 @@ export declare enum StyleVariableCategory {
     SHADOW = "shadow",
     CUSTOM = "custom"
 }
+export declare const isStyleVariableCategory: (value: unknown) => value is StyleVariableCategory;
 export type StyleThemeValue = Partial<Record<ColorScheme | 'default', string>>;
 export type StyleVariableValue = string | number | StyleThemeValue;
 export type StyleVariableGroup = Record<string, StyleVariableValue>;
@@ -149,6 +150,6 @@ export type StyleContextValue = {
     styleAddFont?: unknown;
     styleUpdateFont?: unknown;
     styleRemoveFont?: unknown;
-    styleAddTemplate?: unknown;
+    styleAddSnippet?: unknown;
     styleUpdateSettings?: unknown;
 };

package/dist/types/StyleTypes.mjs

@@ -1,6 +1,6 @@
 //#region src/types/StyleTypes.ts
 var e = /* @__PURE__ */ function(e) {
 	return e.COLOR = "color", e.SPACING = "spacing", e.SHADOW = "shadow", e.CUSTOM = "custom", e;
-}({});
+}({}), t = Object.values(e), n = (e) => typeof e == "string" && t.includes(e);
 //#endregion
-export { e as StyleVariableCategory };
+export { e as StyleVariableCategory, n as isStyleVariableCategory };

package/dist/types/index.d.ts

@@ -1,6 +1,6 @@
 export * from './SchemaTypes';
 export * from './StyleTypes';
-export * from './TemplateTypes';
+export * from './SnippetTypes';
 export * from './InteractionTypes';
 export * from './PluginTypes';
 export * from './ElementTypes';

package/dist/types/index.mjs

@@ -1,3 +1,3 @@
 import { WHILE_RUNNING_MODES as e } from "./SchemaTypes.mjs";
-import { StyleVariableCategory as t } from "./StyleTypes.mjs";
-export { t as StyleVariableCategory, e as WHILE_RUNNING_MODES };
+import { StyleVariableCategory as t, isStyleVariableCategory as n } from "./StyleTypes.mjs";
+export { t as StyleVariableCategory, e as WHILE_RUNNING_MODES, n as isStyleVariableCategory };

package/dist/websockets/RTCodec.d.ts

@@ -18,6 +18,7 @@ export declare enum RTEvent {
     COLLABORATOR_DISCONNECTED = 13
 }
 export declare const isRTEvent: (value: unknown) => value is RTEvent;
+export declare const isRTEventCloseCode: (value: unknown) => value is RTEventCloseCode;
 export type RTMessageManagedClient = {
     type: RTEvent.INIT;
     payload: undefined;

package/dist/websockets/RTCodec.mjs

@@ -3,7 +3,7 @@ var e = /* @__PURE__ */ function(e) {
 	return e[e.NORMAL = 1e3] = "NORMAL", e[e.AWAY = 1001] = "AWAY", e[e.ABNORMAL = 1002] = "ABNORMAL", e[e.UNSUPPORTED = 1003] = "UNSUPPORTED", e[e.UNKNOWN = 4e3] = "UNKNOWN", e[e.NOT_AUTHORISED = 4001] = "NOT_AUTHORISED", e[e.INSTANCE_ID_NOT_FOUND = 4002] = "INSTANCE_ID_NOT_FOUND", e[e.USER_TOKEN_NOT_FOUND = 4003] = "USER_TOKEN_NOT_FOUND", e;
 }({}), t = /* @__PURE__ */ function(e) {
 	return e[e.INIT = 0] = "INIT", e[e.KA = 1] = "KA", e[e.MOUSE = 10] = "MOUSE", e[e.ELEMENT = 11] = "ELEMENT", e[e.COLLABORATOR_CONNECTED = 12] = "COLLABORATOR_CONNECTED", e[e.COLLABORATOR_DISCONNECTED = 13] = "COLLABORATOR_DISCONNECTED", e;
-}({}), n = (e) => typeof e == "number" && e in t, r = class {
+}({}), n = (e) => typeof e == "number" && e in t, r = (t) => typeof t == "number" && t in e, i = class {
 	encoder;
 	decoder;
 	constructor() {
@@ -14,22 +14,24 @@ var e = /* @__PURE__ */ function(e) {
 		return o.setUint8(0, e), o.setUint32(1, i.length), i.length > 0 && new Uint8Array(a, 5).set(i), a;
 	}
 	decode(e) {
-		let t = new DataView(e), n = t.getUint8(0), r = t.getUint32(1);
-		if (r === 0) return {
-			type: n,
+		let t = new DataView(e), r = t.getUint8(0);
+		if (!n(r)) throw Error(`RTCodec: unknown event ${String(r)}`);
+		let i = t.getUint32(1);
+		if (i === 0) return {
+			type: r,
 			payload: void 0
 		};
-		let i = new Uint8Array(e, 5, r);
+		let a = new Uint8Array(e, 5, i);
 		return {
-			type: n,
-			payload: JSON.parse(this.decoder.decode(i))
+			type: r,
+			payload: JSON.parse(this.decoder.decode(a))
 		};
 	}
-}, i = void 0, a = (e) => {
-	i = e;
+}, a = void 0, o = (e) => {
+	a = e;
 };
-function o(e = !0) {
-	return e && !i && (i = new r()), i;
+function s(e = !0) {
+	return e && !a && (a = new i()), a;
 }
 //#endregion
-export { t as RTEvent, e as RTEventCloseCode, r as default, o as getInstance, n as isRTEvent, a as setInstance };
+export { t as RTEvent, e as RTEventCloseCode, i as default, s as getInstance, n as isRTEvent, r as isRTEventCloseCode, o as setInstance };

package/dist/websockets/index.mjs

@@ -1,2 +1,2 @@
-import e, { RTEvent as t, RTEventCloseCode as n, getInstance as r, isRTEvent as i, setInstance as a } from "./RTCodec.mjs";
-export { e as RTCodec, t as RTEvent, n as RTEventCloseCode, r as getInstance, i as isRTEvent, a as setInstance };
+import e, { RTEvent as t, RTEventCloseCode as n, getInstance as r, isRTEvent as i, isRTEventCloseCode as a, setInstance as o } from "./RTCodec.mjs";
+export { e as RTCodec, t as RTEvent, n as RTEventCloseCode, r as getInstance, i as isRTEvent, a as isRTEventCloseCode, o as setInstance };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plitzi/sdk-shared",
-  "version": "0.37.9",
+  "version": "0.38.1",
   "license": "AGPL-3.0",
   "files": [
     "dist",
@@ -158,6 +158,10 @@
       "types": "./dist/dataSource/getBindingsDetails.d.ts",
       "import": "./dist/dataSource/getBindingsDetails.mjs"
     },
+    "./dataSource/globalSources": {
+      "types": "./dist/dataSource/globalSources.d.ts",
+      "import": "./dist/dataSource/globalSources.mjs"
+    },
     "./dataSource/helpers": {
       "types": "./dist/dataSource/helpers/index.d.ts",
       "import": "./dist/dataSource/helpers/index.mjs"
@@ -278,6 +282,30 @@
       "types": "./dist/elements/index.d.ts",
       "import": "./dist/elements/index.mjs"
     },
+    "./flags": {
+      "types": "./dist/flags/index.d.ts",
+      "import": "./dist/flags/index.mjs"
+    },
+    "./flags/flagsCookie": {
+      "types": "./dist/flags/flagsCookie.d.ts",
+      "import": "./dist/flags/flagsCookie.mjs"
+    },
+    "./flags/index": {
+      "types": "./dist/flags/index.d.ts",
+      "import": "./dist/flags/index.mjs"
+    },
+    "./flags/resolveFlags": {
+      "types": "./dist/flags/resolveFlags.d.ts",
+      "import": "./dist/flags/resolveFlags.mjs"
+    },
+    "./flags/schemaFlag": {
+      "types": "./dist/flags/schemaFlag.d.ts",
+      "import": "./dist/flags/schemaFlag.mjs"
+    },
+    "./flags/useFlagResolution": {
+      "types": "./dist/flags/useFlagResolution.d.ts",
+      "import": "./dist/flags/useFlagResolution.mjs"
+    },
     "./helpers": {
       "types": "./dist/helpers/index.d.ts",
       "import": "./dist/helpers/index.mjs"
@@ -286,6 +314,10 @@
       "types": "./dist/helpers/cookies.d.ts",
       "import": "./dist/helpers/cookies.mjs"
     },
+    "./helpers/eventTarget": {
+      "types": "./dist/helpers/eventTarget.d.ts",
+      "import": "./dist/helpers/eventTarget.mjs"
+    },
     "./helpers/fetchManifest": {
       "types": "./dist/helpers/fetchManifest.d.ts",
       "import": "./dist/helpers/fetchManifest.mjs"
@@ -298,14 +330,26 @@
       "types": "./dist/helpers/generateFacade.d.ts",
       "import": "./dist/helpers/generateFacade.mjs"
     },
+    "./helpers/images": {
+      "types": "./dist/helpers/images.d.ts",
+      "import": "./dist/helpers/images.mjs"
+    },
     "./helpers/index": {
       "types": "./dist/helpers/index.d.ts",
       "import": "./dist/helpers/index.mjs"
     },
+    "./helpers/interval": {
+      "types": "./dist/helpers/interval.d.ts",
+      "import": "./dist/helpers/interval.mjs"
+    },
     "./helpers/isDate": {
       "types": "./dist/helpers/isDate.d.ts",
       "import": "./dist/helpers/isDate.mjs"
     },
+    "./helpers/isRecord": {
+      "types": "./dist/helpers/isRecord.d.ts",
+      "import": "./dist/helpers/isRecord.mjs"
+    },
     "./helpers/keys": {
       "types": "./dist/helpers/keys.d.ts",
       "import": "./dist/helpers/keys.mjs"
@@ -318,6 +362,10 @@
       "types": "./dist/helpers/ruleEvaluator.d.ts",
       "import": "./dist/helpers/ruleEvaluator.mjs"
     },
+    "./helpers/scroll": {
+      "types": "./dist/helpers/scroll.d.ts",
+      "import": "./dist/helpers/scroll.mjs"
+    },
     "./helpers/security": {
       "types": "./dist/helpers/security.d.ts",
       "import": "./dist/helpers/security.mjs"
@@ -571,9 +619,9 @@
       "types": "./dist/network/graphql/builder/Mutations/Space/SpaceAddPluginMutation.d.ts",
       "import": "./dist/network/graphql/builder/Mutations/Space/SpaceAddPluginMutation.mjs"
     },
-    "./network/graphql/builder/Mutations/Space/SpaceAddTemplateMutation": {
-      "types": "./dist/network/graphql/builder/Mutations/Space/SpaceAddTemplateMutation.d.ts",
-      "import": "./dist/network/graphql/builder/Mutations/Space/SpaceAddTemplateMutation.mjs"
+    "./network/graphql/builder/Mutations/Space/SpaceAddSnippetMutation": {
+      "types": "./dist/network/graphql/builder/Mutations/Space/SpaceAddSnippetMutation.d.ts",
+      "import": "./dist/network/graphql/builder/Mutations/Space/SpaceAddSnippetMutation.mjs"
     },
     "./network/graphql/builder/Mutations/Space/SpaceCloneElementMutation": {
       "types": "./dist/network/graphql/builder/Mutations/Space/SpaceCloneElementMutation.d.ts",
@@ -715,6 +763,18 @@
       "types": "./dist/network/graphql/builder/Mutations/Space/credentials/SpaceUpdateCredentialMutation.d.ts",
       "import": "./dist/network/graphql/builder/Mutations/Space/credentials/SpaceUpdateCredentialMutation.mjs"
     },
+    "./network/graphql/builder/Mutations/Space/flags/SpacePublishFlagsMutation": {
+      "types": "./dist/network/graphql/builder/Mutations/Space/flags/SpacePublishFlagsMutation.d.ts",
+      "import": "./dist/network/graphql/builder/Mutations/Space/flags/SpacePublishFlagsMutation.mjs"
+    },
+    "./network/graphql/builder/Mutations/Space/flags/SpaceRemoveFlagMutation": {
+      "types": "./dist/network/graphql/builder/Mutations/Space/flags/SpaceRemoveFlagMutation.d.ts",
+      "import": "./dist/network/graphql/builder/Mutations/Space/flags/SpaceRemoveFlagMutation.mjs"
+    },
+    "./network/graphql/builder/Mutations/Space/flags/SpaceSetFlagMutation": {
+      "types": "./dist/network/graphql/builder/Mutations/Space/flags/SpaceSetFlagMutation.d.ts",
+      "import": "./dist/network/graphql/builder/Mutations/Space/flags/SpaceSetFlagMutation.mjs"
+    },
     "./network/graphql/builder/Mutations/Space/folders/SpaceAddPageFolderMutation": {
       "types": "./dist/network/graphql/builder/Mutations/Space/folders/SpaceAddPageFolderMutation.d.ts",
       "import": "./dist/network/graphql/builder/Mutations/Space/folders/SpaceAddPageFolderMutation.mjs"
@@ -1063,6 +1123,10 @@
       "types": "./dist/schema/SchemaContext.d.ts",
       "import": "./dist/schema/SchemaContext.mjs"
     },
+    "./schema/anchor": {
+      "types": "./dist/schema/anchor.d.ts",
+      "import": "./dist/schema/anchor.mjs"
+    },
     "./schema/index": {
       "types": "./dist/schema/index.d.ts",
       "import": "./dist/schema/index.mjs"
@@ -1079,6 +1143,14 @@
       "types": "./dist/schema/serverElements.d.ts",
       "import": "./dist/schema/serverElements.mjs"
     },
+    "./schema/snippet": {
+      "types": "./dist/schema/snippet.d.ts",
+      "import": "./dist/schema/snippet.mjs"
+    },
+    "./schema/wire": {
+      "types": "./dist/schema/wire.d.ts",
+      "import": "./dist/schema/wire.mjs"
+    },
     "./server": {
       "types": "./dist/server/index.d.ts",
       "import": "./dist/server/index.mjs"
@@ -1087,6 +1159,10 @@
       "types": "./dist/server/actions/useActionsSync.d.ts",
       "import": "./dist/server/actions/useActionsSync.mjs"
     },
+    "./server/actions/useImagesSync": {
+      "types": "./dist/server/actions/useImagesSync.d.ts",
+      "import": "./dist/server/actions/useImagesSync.mjs"
+    },
     "./server/actions/useRealtimeSync": {
       "types": "./dist/server/actions/useRealtimeSync.d.ts",
       "import": "./dist/server/actions/useRealtimeSync.mjs"
@@ -1203,6 +1279,14 @@
       "types": "./dist/style/index.d.ts",
       "import": "./dist/style/index.mjs"
     },
+    "./style/breakpoints": {
+      "types": "./dist/style/breakpoints.d.ts",
+      "import": "./dist/style/breakpoints.mjs"
+    },
+    "./style/displayModes": {
+      "types": "./dist/style/displayModes.d.ts",
+      "import": "./dist/style/displayModes.mjs"
+    },
     "./style/fontAssets": {
       "types": "./dist/style/fontAssets.d.ts",
       "import": "./dist/style/fontAssets.mjs"
@@ -1223,10 +1307,22 @@
       "types": "./dist/style/index.d.ts",
       "import": "./dist/style/index.mjs"
     },
+    "./style/layoutGrid": {
+      "types": "./dist/style/layoutGrid.d.ts",
+      "import": "./dist/style/layoutGrid.mjs"
+    },
+    "./style/notifications": {
+      "types": "./dist/style/notifications.d.ts",
+      "import": "./dist/style/notifications.mjs"
+    },
     "./style/runtimeStyle": {
       "types": "./dist/style/runtimeStyle.d.ts",
       "import": "./dist/style/runtimeStyle.mjs"
     },
+    "./style/snippetStyle": {
+      "types": "./dist/style/snippetStyle.d.ts",
+      "import": "./dist/style/snippetStyle.mjs"
+    },
     "./style/styleConstants": {
       "types": "./dist/style/styleConstants.d.ts",
       "import": "./dist/style/styleConstants.mjs"
@@ -1334,6 +1430,9 @@
     "./types/ServerTypes": {
       "types": "./dist/types/ServerTypes.d.ts"
     },
+    "./types/SnippetTypes": {
+      "types": "./dist/types/SnippetTypes.d.ts"
+    },
     "./types/SpaceTypes": {
       "types": "./dist/types/SpaceTypes.d.ts"
     },
@@ -1347,9 +1446,6 @@
       "types": "./dist/types/StyleTypes.d.ts",
       "import": "./dist/types/StyleTypes.mjs"
     },
-    "./types/TemplateTypes": {
-      "types": "./dist/types/TemplateTypes.d.ts"
-    },
     "./types/ThemeTypes": {
       "types": "./dist/types/ThemeTypes.d.ts"
     },
@@ -1382,11 +1478,11 @@
     "build:prod": "vite build && node ./scripts/generate-exports.mjs"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.30.1",
+    "@modelcontextprotocol/sdk": "^1.32.0",
     "@plitzi/nexus": "^1.4.0",
-    "@plitzi/plitzi-ui": "^1.6.26",
+    "@plitzi/plitzi-ui": "^1.6.29",
     "date-fns": "^4.4.0",
-    "immer": "^11.1.18",
+    "immer": "^11.1.21",
     "zod": "^4.6.5"
   },
   "peerDependencies": {
@@ -1411,24 +1507,24 @@
     "@types/react": "^19.3.0",
     "@types/react-dom": "^19.3.0",
     "@vitejs/plugin-react": "^6.1.1",
-    "@vitest/coverage-v8": "^5.0.1",
+    "@vitest/coverage-v8": "^5.0.3",
     "babel-minify": "^0.5.2",
     "eslint": "^9.39.5",
     "eslint-config-airbnb": "^19.0.4",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-config-turbo": "^2.11.3",
+    "eslint-config-turbo": "^2.11.7",
     "eslint-import-resolver-alias": "^1.1.2",
     "eslint-plugin-cypress": "^7.0.2",
     "eslint-plugin-flowtype": "8.0.3",
     "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-jsdoc": "^64.5.4",
+    "eslint-plugin-jsdoc": "^65.0.2",
     "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.7",
-    "eslint-plugin-storybook": "^10.6.0",
-    "globals": "^17.12.0",
+    "eslint-plugin-storybook": "^10.6.1",
+    "globals": "^17.13.0",
     "jsdom": "^30.1.1",
     "postcss": "^8.5.28",
     "prettier": "^3.9.9",
@@ -1437,11 +1533,11 @@
     "tailwindcss": "^4.3.3",
     "terser": "^5.51.2",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.70.1",
-    "vite": "^8.3.1",
-    "vite-plugin-dts": "^5.1.1",
+    "typescript-eslint": "^8.71.0",
+    "vite": "^8.3.2",
+    "vite-plugin-dts": "^5.1.2",
     "vite-plugin-react": "^4.0.1",
-    "vitest": "^5.0.1",
+    "vitest": "^5.0.3",
     "vitest-fetch-mock": "^0.4.5"
   },
   "peerDependenciesMeta": {

package/tailwind.config.js

@@ -1,4 +1,3 @@
-import defaultTheme from 'tailwindcss/defaultTheme';
 import plugin from 'tailwindcss/plugin';
 import { colors } from '@plitzi/plitzi-ui/tailwind';
 
@@ -7,11 +6,7 @@ const config = {
     extend: {
       colors
     },
-    groups: ['1', '2', '3', '4', '5'],
-    fontFamily: {
-      ...defaultTheme.fontFamily,
-      rubik: ['Rubik', 'sans-serif']
-    }
+    groups: ['1', '2', '3', '4', '5']
   },
   plugins: [
     plugin(({ addVariant, theme }) => {

package/vite.config.ts

@@ -126,10 +126,22 @@ export default defineConfig(({ mode, command }) => {
         //     '@': resolve(__dirname, './src'),
       },
       extensions: ['.js', '.ts', '.tsx', '.mjs'],
-      // `@plitzi/nexus` lives in its own repo and is linked through a portal, so it carries its own
-      // node_modules/react. Without deduping, its hooks run against a second React copy and every
-      // useContext reads a null dispatcher.
-      dedupe: ['react', 'react-dom']
+      // `@plitzi/nexus` and `@plitzi/plitzi-ui` may be linked through portals, each carrying its own node_modules. React and
+      // CodeMirror check identity (a hook's dispatcher, an extension's `instanceof`), so a second copy breaks them: one each.
+      dedupe: [
+        'react',
+        'react-dom',
+        '@codemirror/autocomplete',
+        '@codemirror/commands',
+        '@codemirror/language',
+        '@codemirror/lint',
+        '@codemirror/search',
+        '@codemirror/state',
+        '@codemirror/view',
+        '@lezer/common',
+        '@lezer/highlight',
+        '@lezer/lr'
+      ]
     },
     build: {
       // outDir: 'dist/src',

package/dist/network/graphql/builder/Mutations/Space/SpaceAddTemplateMutation.d.ts

@@ -1,2 +0,0 @@
-declare const SpaceAddTemplateMutation = "\n  mutation SpaceAddTemplateMutation(\n    $environment: String!\n    $element: Json!\n    $style: Json\n    $dropPosition: String!\n    $to: String!\n    $initialItems: [Json]!\n    $variables: [SpaceVariableInput]\n  ) {\n    SpaceAddTemplate(\n      environment: $environment\n      element: $element\n      style: $style\n      dropPosition: $dropPosition\n      to: $to\n      initialItems: $initialItems\n      variables: $variables\n    ) {\n      id\n      definition {\n        label\n        type\n        initialState\n        styleSelectors\n        bindings\n        interactions\n        parentId\n        rootId\n        items\n      }\n      attributes\n    }\n  }\n";
-export default SpaceAddTemplateMutation;

package/dist/network/graphql/builder/Mutations/Space/SpaceAddTemplateMutation.mjs

@@ -1,4 +0,0 @@
-//#region src/network/graphql/builder/Mutations/Space/SpaceAddTemplateMutation.ts
-var e = "\n  mutation SpaceAddTemplateMutation(\n    $environment: String!\n    $element: Json!\n    $style: Json\n    $dropPosition: String!\n    $to: String!\n    $initialItems: [Json]!\n    $variables: [SpaceVariableInput]\n  ) {\n    SpaceAddTemplate(\n      environment: $environment\n      element: $element\n      style: $style\n      dropPosition: $dropPosition\n      to: $to\n      initialItems: $initialItems\n      variables: $variables\n    ) {\n      id\n      definition {\n        label\n        type\n        initialState\n        styleSelectors\n        bindings\n        interactions\n        parentId\n        rootId\n        items\n      }\n      attributes\n    }\n  }\n";
-//#endregion
-export { e as default };

package/dist/types/TemplateTypes.d.ts

@@ -1,20 +0,0 @@
-import { Element, Schema } from './SchemaTypes';
-import { Style } from './StyleTypes';
-/**
- * A published template: a subtree, the style that dresses it, and the element a builder instantiates.
- *
- * The artefact someone hosts when they are not building a space — fetched by URL, shown in the Resources panel,
- * dragged onto a canvas — which is why it lives beside the schema and the style rather than with the builder's own
- * types: it is a document, produced and consumed by processes that never open a builder.
- */
-export type Template = {
-    id?: string;
-    definition: {
-        name: string;
-        description: string;
-        /** Root of what travels. Its subtree is the whole of `schema.flat`, and it answers to no parent. */
-        baseElementId: Element['id'];
-    };
-    schema: Schema;
-    style: Style;
-};