@plitzi/sdk-server 0.32.3 → 0.32.5

package/dist/src/modules/ssr/prepareRender.d.ts

@@ -2,7 +2,7 @@ import { ComponentProps } from './Component';
 import { TtlCache } from '../../helpers/cache';
 import { RequestMetrics } from '../../helpers/metrics';
 import { PluginManager } from '../../plugins/manager';
-import { Environment, PluginEntry, SSRRequest, SSRServerConfig, SSRTemplateProps } from '@plitzi/sdk-shared';
+import { Environment, OfflineDataRaw, PluginEntry, SSRRequest, SSRServerConfig, SSRTemplateProps } from '@plitzi/sdk-shared';
 export type RenderPrep = {
     componentProps: ComponentProps;
     entries: PluginEntry[];
@@ -10,4 +10,4 @@ export type RenderPrep = {
         offlineData: string;
     };
 };
-export declare const prepareRender: (req: SSRRequest, config: SSRServerConfig, spaceId: number, environment: Environment, revision: number, pluginManager: PluginManager, offlineDataCache?: TtlCache<string>, metrics?: RequestMetrics) => Promise<RenderPrep>;
+export declare const prepareRender: (req: SSRRequest, config: SSRServerConfig, spaceId: number, environment: Environment, revision: number, pluginManager: PluginManager, offlineDataCache?: TtlCache<string>, metrics?: RequestMetrics, offlineDataOverride?: OfflineDataRaw) => Promise<RenderPrep>;

package/dist/src/modules/ssr/preview.d.ts

@@ -0,0 +1,16 @@
+import { PREVIEW_TOKEN_PARAM } from '../mcp/constants';
+import { ServerCaches } from '../../helpers/cache';
+import { PluginManager } from '../../plugins/manager';
+import { PreviewRequestBody, PreviewResult } from '../mcp/types';
+import { DraftStore, OfflineDataRaw, SSRRequest, SSRServerConfig, SSRTemplateFn } from '@plitzi/sdk-shared';
+export { PREVIEW_TOKEN_PARAM };
+/** In-memory one-shot draft store — the default when the consumer injects none. Fine for a single replica;
+ *  a multi-replica deployment must inject a shared store so a preview URL resolves on any replica. */
+export declare const createMemoryDraftStore: () => DraftStore;
+/** Consume the draft override for a render, if the request carries a valid preview token. Returns undefined on
+ *  a normal request (renders persisted state) or when the token is unknown/expired (one-shot / TTL). */
+export declare const takeDraftOverride: (req: SSRRequest, config: SSRServerConfig) => Promise<OfflineDataRaw | undefined>;
+/** Build a preview of a page: apply any unsaved `operations` to a clone (never persisted), render the resulting
+ *  draft to full HTML via the SSR pipeline, and stash the draft under a one-shot token so a browser can fetch
+ *  the exact same render at `?__pt=<token>` (for screenshots). With no operations it previews persisted state. */
+export declare const createPreview: (body: PreviewRequestBody, config: SSRServerConfig, renderFn: SSRTemplateFn, pluginManager: PluginManager, caches: ServerCaches) => Promise<PreviewResult>;

package/dist/src/modules/ssr/streamBody.d.ts

@@ -1,5 +1,5 @@
 import { TtlCache } from '../../helpers/cache';
 import { RequestMetrics } from '../../helpers/metrics';
 import { PluginManager } from '../../plugins/manager';
-import { Environment, SSRRequest, SSRResponseHelpers, SSRServerConfig, SSRTemplateFn } from '@plitzi/sdk-shared';
-export declare const streamBody: (req: SSRRequest, res: SSRResponseHelpers, config: SSRServerConfig, spaceId: number, environment: Environment, revision: number, renderFn: SSRTemplateFn, pluginManager: PluginManager, offlineDataCache?: TtlCache<string>, htmlCache?: TtlCache<string>, cacheKey?: string, metrics?: RequestMetrics) => Promise<void>;
+import { Environment, OfflineDataRaw, SSRRequest, SSRResponseHelpers, SSRServerConfig, SSRTemplateFn } from '@plitzi/sdk-shared';
+export declare const streamBody: (req: SSRRequest, res: SSRResponseHelpers, config: SSRServerConfig, spaceId: number, environment: Environment, revision: number, renderFn: SSRTemplateFn, pluginManager: PluginManager, offlineDataCache?: TtlCache<string>, htmlCache?: TtlCache<string>, cacheKey?: string, metrics?: RequestMetrics, offlineDataOverride?: OfflineDataRaw) => Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plitzi/sdk-server",
-  "version": "0.32.3",
+  "version": "0.32.5",
   "license": "AGPL-3.0",
   "files": [
     "dist"
@@ -23,8 +23,8 @@
   "sideEffects": false,
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@plitzi/plitzi-sdk": "0.32.3",
-    "@plitzi/sdk-shared": "0.32.3",
+    "@plitzi/plitzi-sdk": "0.32.5",
+    "@plitzi/sdk-shared": "0.32.5",
     "ejs": "^6.0.1",
     "esbuild": "^0.28.1",
     "zod": "^4.4.3"
@@ -35,19 +35,19 @@
   },
   "devDependencies": {
     "@types/ejs": "^3.1.5",
-    "@types/node": "^26.0.0",
+    "@types/node": "^26.1.1",
     "@types/react": "^19.2.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",
     "eslint": "^9.39.4",
     "eslint-plugin-import": "^2.32.0",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
-    "tsx": "^4.22.4",
+    "tsx": "^4.23.0",
     "typescript": "^6.0.3",
-    "vite": "^8.0.16",
-    "vite-plugin-dts": "^5.0.2",
-    "vitest": "^4.1.9"
+    "vite": "^8.1.4",
+    "vite-plugin-dts": "^5.0.3",
+    "vitest": "^4.1.10"
   },
   "scripts": {
     "start:dev": "node --import ./src/standalone/register-alias.mjs --watch src/standalone/server.ts",

package/dist/_virtual/_rolldown/runtime.js

@@ -1,13 +0,0 @@
-//#region \0rolldown/runtime.js
-var __defProp = Object.defineProperty;
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
-	return target;
-};
-//#endregion
-export { __exportAll };

package/dist/core/requestHandler.js

@@ -1,126 +0,0 @@
-import { parseRequest, readRawBody } from "./requestParser.js";
-import { serveStatic } from "./staticFiles.js";
-import { buildResponseHelpers } from "../helpers/buildResponseHelpers.js";
-import { runMiddlewares } from "../helpers/runMiddlewares.js";
-import { authMiddleware } from "../middlewares/auth.js";
-import { basicAuthMiddleware } from "../middlewares/basicAuth.js";
-import { spaceDeploymentMiddleware } from "../middlewares/spaceDeployment.js";
-import { handleMcp } from "../modules/mcp/handler.js";
-import { handleRsc } from "../modules/rsc/handler.js";
-import { renderSSR } from "../modules/ssr/handler.js";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-//#region src/core/requestHandler.ts
-var __dirname = path.dirname(fileURLToPath(import.meta.url));
-var BUILTIN_PUBLIC_DIR = path.resolve(__dirname, "../public");
-var safeRedirectTarget = (req) => {
-	const redirectParam = req.query["redirect"];
-	return redirectParam && redirectParam.startsWith("/") && !redirectParam.startsWith("//") ? redirectParam : "/";
-};
-var handleRequest = async (raw, rawRes, config, port, renderFn, caches, pluginManager) => {
-	const req = parseRequest(raw);
-	const res = buildResponseHelpers(rawRes, req.headers["accept-encoding"]);
-	if (req.path === "\0") {
-		res.setStatus(400);
-		res.end();
-		return;
-	}
-	res.setHeader("X-Content-Type-Options", "nosniff");
-	res.setHeader("Referrer-Policy", "strict-origin-when-cross-origin");
-	res.setHeader("X-DNS-Prefetch-Control", "off");
-	const frameOptions = config.frameOptions === void 0 ? "DENY" : config.frameOptions;
-	if (frameOptions) if (Array.isArray(frameOptions)) res.setHeader("Content-Security-Policy", `frame-ancestors ${frameOptions.join(" ")}`);
-	else {
-		res.setHeader("X-Frame-Options", frameOptions);
-		res.setHeader("Content-Security-Policy", `frame-ancestors '${frameOptions === "DENY" ? "none" : "self"}'`);
-	}
-	if ((config.httpVersion ?? 2) >= 3) res.setHeader("Alt-Svc", `h3=":${port}"; ma=86400`);
-	if (serveStatic(req, res, BUILTIN_PUBLIC_DIR)) return;
-	if (config.publicDir && serveStatic(req, res, config.publicDir)) return;
-	if (req.path.startsWith("/.well-known/")) {
-		res.setStatus(404);
-		res.end();
-		return;
-	}
-	if (req.path.startsWith(pluginManager.urlPrefix + "/")) {
-		const relative = req.path.slice(pluginManager.urlPrefix.length);
-		const pluginName = relative.split("/")[1];
-		if (pluginName && pluginManager.hasPlugin(pluginName)) {
-			await pluginManager.prepare(pluginName);
-			if (serveStatic({
-				...req,
-				path: relative
-			}, res, pluginManager.outputDir)) return;
-		}
-		res.setStatus(404);
-		res.send("Not found");
-		return;
-	}
-	const loginPath = config.loginPath === false ? null : config.loginPath ?? "/auth/login";
-	if (loginPath && req.method === "POST" && req.path === loginPath) {
-		req.body = await readRawBody(raw);
-		const isLoggedIn = await config.adapters.onLogin?.(req, res);
-		if (req.headers["sec-fetch-mode"] === "navigate") {
-			res.setStatus(303);
-			res.setHeader("Location", isLoggedIn ? safeRedirectTarget(req) : loginPath);
-			res.end();
-			return;
-		}
-		res.setStatus(isLoggedIn ? 200 : 401);
-		res.end();
-		return;
-	}
-	const logoutPath = config.logoutPath === false ? null : config.logoutPath ?? "/auth/logout";
-	if (logoutPath && req.method === "POST" && req.path === logoutPath) {
-		req.body = await readRawBody(raw);
-		await config.adapters.onLogout?.(req, res);
-		if (req.headers["sec-fetch-mode"] === "navigate") {
-			res.setStatus(303);
-			res.setHeader("Location", safeRedirectTarget(req));
-			res.end();
-			return;
-		}
-		res.setStatus(204);
-		res.end();
-		return;
-	}
-	if (config.static) for (const [prefix, rootDir] of Object.entries(config.static)) {
-		const normalizedPrefix = prefix.endsWith("/") ? prefix : `${prefix}/`;
-		if (req.path === prefix || req.path.startsWith(normalizedPrefix)) {
-			if (serveStatic({
-				...req,
-				path: req.path.slice(prefix.length) || "/"
-			}, res, rootDir)) return;
-		}
-	}
-	const mcpPath = config.mcp?.path ?? "/mcp";
-	if (config.mcp && (config.mcp.enabled ?? true) && req.path.startsWith(mcpPath)) {
-		await handleMcp(raw, rawRes, config.mcp);
-		return;
-	}
-	if (await runMiddlewares([
-		spaceDeploymentMiddleware(config.adapters),
-		basicAuthMiddleware({ cacheTtlMs: config.cacheTtlMs }),
-		authMiddleware(config.adapters),
-		...config.middlewares || []
-	], req, res) || res.status !== 200) return;
-	const rscPath = config.rsc?.path ?? "/_rsc";
-	if ((config.rsc?.enabled ?? !!config.adapters.getRscData) && req.method === "GET" && req.path === rscPath) {
-		await handleRsc(req, res, config, pluginManager, caches.rsc);
-		return;
-	}
-	await renderSSR(req, res, config, renderFn, pluginManager, caches);
-};
-var makeHandler = (config, port, renderFn, caches, pluginManager) => {
-	return (raw, rawRes) => {
-		handleRequest(raw, rawRes, config, port, renderFn, caches, pluginManager).catch((err) => {
-			console.error("[SSR] Unhandled error:", err);
-			try {
-				if (!rawRes.headersSent) rawRes.writeHead(500, { "Content-Type": "text/plain" });
-				rawRes.end("Internal Server Error");
-			} catch {}
-		});
-	};
-};
-//#endregion
-export { makeHandler };

package/dist/modules/mcp/helpers.js

@@ -1,75 +0,0 @@
-import { z } from "zod";
-//#region src/modules/mcp/helpers.ts
-var zodToJsonSchema = (schema) => {
-	if (schema instanceof z.ZodObject) {
-		const properties = {};
-		const required = [];
-		for (const [key, value] of Object.entries(schema.shape)) {
-			properties[key] = zodToJsonSchema(value);
-			if (value instanceof z.ZodString || value instanceof z.ZodNumber || value instanceof z.ZodBoolean) {
-				if (!value.isOptional()) required.push(key);
-			}
-		}
-		return {
-			type: "object",
-			properties,
-			required: required.length > 0 ? required : []
-		};
-	}
-	if (schema instanceof z.ZodString) return { type: "string" };
-	if (schema instanceof z.ZodNumber) return { type: "number" };
-	if (schema instanceof z.ZodBoolean) return { type: "boolean" };
-	if (schema instanceof z.ZodEnum) return {
-		type: "string",
-		enum: schema.options
-	};
-	if (schema instanceof z.ZodOptional) return zodToJsonSchema(schema._def.innerType);
-	if (schema instanceof z.ZodUnion) return { oneOf: schema.options.map((opt) => zodToJsonSchema(opt)) };
-	if (schema instanceof z.ZodArray) return {
-		type: "array",
-		items: zodToJsonSchema(schema.element)
-	};
-	if (schema instanceof z.ZodRecord) return {
-		type: "object",
-		additionalProperties: zodToJsonSchema(schema.valueType)
-	};
-	return {};
-};
-var getAllowedModes = (operationType) => {
-	return operationType === "write" ? ["build"] : ["plan", "build"];
-};
-var toolResponseOk = (data, agentMessage) => {
-	return {
-		content: [{
-			type: "text",
-			text: agentMessage ?? JSON.stringify(data ?? null, null, 2)
-		}],
-		data
-	};
-};
-var toolResponseErr = (error) => ({
-	content: [{
-		type: "text",
-		text: error instanceof Error ? error.message : error
-	}],
-	isError: true
-});
-var isToolActive = (tool, adapters) => Boolean(tool.handler || tool.adapterName && adapters[tool.adapterName]);
-var resolveToolHandler = (tool, adapters) => {
-	if (tool.handler) return tool.handler;
-	if (tool.adapterName) return adapterWrapper(tool.adapterName, adapters[tool.adapterName]);
-};
-var bindTools = (tools, adapters) => tools.filter((tool) => isToolActive(tool, adapters)).map((tool) => ({
-	...tool,
-	handler: resolveToolHandler(tool, adapters)
-}));
-var adapterWrapper = (adapterName, handler) => {
-	return async (args, ctx) => {
-		if (!handler) return toolResponseErr(`Adapter ${adapterName} not found`);
-		const result = await handler(args, ctx);
-		if ("error" in result) return toolResponseErr(result.error);
-		return toolResponseOk(result.data);
-	};
-};
-//#endregion
-export { adapterWrapper, bindTools, getAllowedModes, isToolActive, resolveToolHandler, toolResponseErr, toolResponseOk, zodToJsonSchema };

package/dist/modules/mcp/resources/glossary/binding.js

@@ -1,73 +0,0 @@
-//#region src/modules/mcp/resources/glossary/binding.ts
-var bindingResource = {
-	uri: "plitzi://docs/binding",
-	name: "Plitzi Docs: Binding",
-	description: "Data bindings in Plitzi — connections that dynamically drive element attributes, style, or state from data sources.",
-	mimeType: "text/markdown",
-	content: `# Binding
-
-A **Binding** connects a data source to an element property. At runtime, the bound value replaces the element's static attribute, style, or initial state. Bindings enable dynamic content — data from collections, variables, navigation params, or other elements can drive what is displayed or how it looks.
-
-## TypeScript Shape
-
-\`\`\`typescript
-type BindingCategory = 'attributes' | 'style' | 'initialState';
-
-type ElementBinding = {
-  id: string;
-  source: string;                   // Data source ID / reference
-  fromPath?: string;                // Path within the source data (e.g. 'user.name')
-  transformers?: BindingTransformer[];  // Optional value transforms
-  when?: RuleGroup;                 // Conditional activation rule
-  enabled?: boolean;
-  toPath: string;                   // Target attribute/style/state path to overwrite
-};
-
-type BindingTransformer = {
-  type: 'utility' | 'unknown';
-  action: string;                   // Transform function name
-  params: { valueType: string; value: string };
-};
-\`\`\`
-
-## Binding Categories
-
-Bindings are grouped by what they target inside an element:
-
-| Category | What it overwrites |
-|---|---|
-| \`attributes\` | Fields in \`element.attributes\` (e.g. \`text\`, \`src\`, \`href\`) |
-| \`style\` | Style-related data (e.g. active style variant) |
-| \`initialState\` | Initial runtime state values |
-
-## Key Properties
-
-- **\`source\`** — identifies the data source (a collection ID, a schema variable name, a navigation param key, etc.).
-- **\`fromPath\`** — dot-notation path into the source data to extract the bound value (e.g. \`'record.title'\`).
-- **\`toPath\`** — dot-notation path of the target property to set on the element (e.g. \`'text'\`, \`'src'\`).
-- **\`transformers\`** — optional chain of value transforms applied before writing to \`toPath\`.
-- **\`when\`** — a \`RuleGroup\` condition; the binding only applies when the condition evaluates to true.
-
-## Where Bindings Are Stored
-
-Bindings live inside \`element.definition.bindings\`:
-
-\`\`\`typescript
-element.definition.bindings = {
-  attributes: [
-    { id: '...', source: 'collection-posts', fromPath: 'title', toPath: 'text', ... }
-  ],
-  style: [...],
-  initialState: [...]
-}
-\`\`\`
-
-## Relationships
-
-- Bindings reference **Schema Variables** (source by variable name) or external data sources.
-- Bindings are part of **Element** definitions.
-- **Interactions** complement bindings by handling user-triggered events (click, change).
-`
-};
-//#endregion
-export { bindingResource };

package/dist/modules/mcp/resources/glossary/collection.js

@@ -1,76 +0,0 @@
-//#region src/modules/mcp/resources/glossary/collection.ts
-var collectionResource = {
-	uri: "plitzi://docs/collection",
-	name: "Plitzi Docs: Collection",
-	description: "A CMS-style data store in Plitzi — a typed set of records with configurable fields.",
-	mimeType: "text/markdown",
-	content: `# Collection
-
-A **Collection** is a CMS-style data store inside a Plitzi space. It has a defined field schema and holds typed records. Collections are used to manage dynamic content (blog posts, product listings, team members, etc.) that elements can bind to via data sources.
-
-## TypeScript Shape
-
-\`\`\`typescript
-type Collection = {
-  id: string;
-  name: string;              // Singular name (e.g. 'Post')
-  namePlural: string;        // Plural name (e.g. 'Posts')
-  description: string;
-  privacy: 'public' | 'private';
-  fields: Record<string, CollectionField>;   // Field schema keyed by field ID
-  records: CollectionRecord[];
-};
-
-type CollectionField = {
-  id: string;
-  name: string;              // Human-readable label
-  machineName: string;       // Programmatic key used in record values
-  type:
-    | 'text' | 'richText' | 'image' | 'multiImage'
-    | 'video' | 'link' | 'email' | 'phone'
-    | 'number' | 'date' | 'switch' | 'color'
-    | 'option' | 'file';
-  params: {
-    primary: boolean;        // Whether this is the display/title field
-    required: boolean;
-  };
-};
-
-type CollectionRecord = {
-  id: string;
-  values: Record<string, string | number | boolean>;  // Keyed by field machineName
-  status: 'draft' | 'published' | 'archived';
-  createdAt: number;
-  updatedAt: number;
-  publishedAt?: number;
-};
-\`\`\`
-
-## Key Properties
-
-- **\`fields\`** — the schema of the collection. Each field has a \`machineName\` which is the key used in \`record.values\`.
-- **\`CollectionField.type\`** — determines the data type and editor widget. Use \`richText\` for HTML content, \`image\` for single image uploads.
-- **\`CollectionField.params.primary\`** — marks the main display field (title/name). Used in lists and pickers.
-- **\`CollectionRecord.values\`** — the actual record data, keyed by \`field.machineName\`.
-- **\`CollectionRecord.status\`** — content lifecycle. Only \`published\` records are visible in production.
-
-## Relationships
-
-- Elements can bind to collection data via **Bindings** (data source type \`collection\`).
-- Collections belong to a **Space** and are available across all environments.
-
-## Common Operations
-
-- \`get_collections\` — list all collections in the space.
-- \`get_collection\` — get a collection with its field schema.
-- \`create_collection\` — define a new content type.
-- \`update_collection\` — rename or modify a collection.
-- \`delete_collection\` — remove collection and all records.
-- \`get_collection_records\` — fetch records (optionally filtered by status).
-- \`create_collection_record\` — add a new record.
-- \`update_collection_record\` — edit an existing record.
-- \`delete_collection_record\` — remove a record.
-`
-};
-//#endregion
-export { collectionResource };

package/dist/modules/mcp/resources/glossary/displayMode.js

@@ -1,50 +0,0 @@
-//#region src/modules/mcp/resources/glossary/displayMode.ts
-var displayModeResource = {
-	uri: "plitzi://docs/display-mode",
-	name: "Plitzi Docs: Display Mode",
-	description: "Responsive breakpoints in Plitzi — desktop, tablet, and mobile style layers.",
-	mimeType: "text/markdown",
-	content: `# Display Mode
-
-A **Display Mode** represents a responsive breakpoint in the Plitzi style system. Styles are defined per display mode, allowing different visual rules at each screen size.
-
-## Type
-
-\`\`\`typescript
-type DisplayMode = 'desktop' | 'tablet' | 'mobile';
-\`\`\`
-
-## Structure in Style
-
-The \`Style.platform\` object holds one style layer per display mode:
-
-\`\`\`typescript
-style.platform = {
-  desktop: Record<string, StyleItem>,   // Base styles (widest breakpoint)
-  tablet: Record<string, StyleItem>,    // Overrides for tablet-width screens
-  mobile: Record<string, StyleItem>     // Overrides for mobile-width screens
-};
-\`\`\`
-
-Each mode contains the same set of CSS selectors (keyed by selector string). A selector defined only in \`desktop\` inherits its rules at all sizes unless overridden in \`tablet\` or \`mobile\`.
-
-## Cascade Direction
-
-- **Desktop-first** (default, \`style.mode === 'desktop-first'\`): \`desktop\` is the base. \`tablet\` overrides at medium widths. \`mobile\` overrides at narrow widths.
-- **Mobile-first** (\`style.mode === 'mobile-first'\`): \`mobile\` is the base. \`tablet\` and \`desktop\` add styles as the viewport widens.
-
-## In MCP Operations
-
-MCP style tools that modify selectors accept a \`displayMode\` parameter:
-
-\`\`\`typescript
-createStyleSelector({ displayMode: 'mobile', selector: '.hero', ... })
-updateStyleSelector({ displayMode: 'tablet', selector: '.hero', ... })
-deleteStyleSelector({ displayMode: 'desktop', selector: '.hero' })
-\`\`\`
-
-Omitting \`displayMode\` typically defaults to \`desktop\`.
-`
-};
-//#endregion
-export { displayModeResource };

package/dist/modules/mcp/resources/glossary/element.js

@@ -1,68 +0,0 @@
-//#region src/modules/mcp/resources/glossary/element.ts
-var elementResource = {
-	uri: "plitzi://docs/element",
-	name: "Plitzi Docs: Element",
-	description: "A single UI component instance in a Plitzi page — the building block of every schema.",
-	mimeType: "text/markdown",
-	content: `# Element
-
-An \`Element\` is a single instance of a UI component in a Plitzi page. Every visual item — pages, containers, text blocks, forms, images — is an element. The entire page tree is stored as a flat dictionary of elements keyed by ID.
-
-## TypeScript Shape
-
-\`\`\`typescript
-type Element<TAttributes = Record<string, unknown>> = {
-  id: string;
-  attributes: TAttributes & { subType?: string };  // Component-specific configuration
-  definition: ElementDefinition;
-};
-
-type ElementDefinition = {
-  rootId: string;            // ID of the page/root element this belongs to
-  label: string;             // Human-readable name shown in the builder
-  type: string;              // Element type identifier (e.g. 'container', 'text', 'image')
-  parentId?: string;         // ID of the parent element (undefined = root)
-  items?: string[];          // Ordered array of child element IDs
-  styleSelectors: {
-    base: string;            // Always present — the primary CSS class
-    [key: string]: string;   // Additional sub-selectors (e.g. 'header', 'body', 'icon')
-  };
-  bindings?: Partial<Record<'attributes' | 'style' | 'initialState', ElementBinding[]>>;
-  interactions?: Record<string, ElementInteraction>;
-  initialState?: {
-    styleVariant?: Record<string, Record<string, string | string[]>>;
-    styleSelectors?: ElementDefinition['styleSelectors'];
-    visibility?: boolean;
-    [key: string]: unknown;
-  };
-  runtime?: 'server' | 'client' | 'shared';    // RSC render target
-  loadStrategy?: 'eager' | 'lazy' | 'visible'; // When to load/render
-};
-\`\`\`
-
-## Key Properties
-
-- **\`id\`** — unique identifier, used as the key in \`schema.flat\`.
-- **\`attributes\`** — component-specific data (text content, URLs, settings). Shape varies by plugin type. \`subType\` selects a variant within the same plugin.
-- **\`definition.type\`** — element type identifier that determines which component renders this element. Get valid values from \`get_builder_context\` (\`elementDefaults\` keys) or from the \`type\` field of existing elements in \`get_schema\`. This is NOT the plugin name from \`list_plugins\`.
-- **\`definition.parentId\`** — parent element ID. Elements without \`parentId\` are root elements (pages).
-- **\`definition.items\`** — ordered child IDs. Walk the tree by following \`items\` recursively.
-- **\`definition.styleSelectors\`** — maps named selector slots to actual CSS class strings from the \`Style\`. \`base\` is always present.
-- **\`definition.bindings\`** — data bindings that dynamically overwrite \`attributes\`, \`style\`, or \`initialState\` fields at runtime.
-- **\`definition.interactions\`** — event handlers (onClick, onChange, etc.) mapping to configured actions.
-- **\`definition.rootId\`** — always points to the page element this element belongs to.
-
-## Relationships
-
-- All elements live in \`schema.flat[id]\`.
-- Parent–child links: \`definition.parentId\` (up) and \`definition.items\` (down).
-- Style data for each element is found in \`style.platform[displayMode][styleSelector]\`.
-- **Segment** elements have their own \`schema.flat\` but follow the same structure.
-
-## Page Elements
-
-A page is an element whose type corresponds to a page plugin. Its ID appears in \`schema.pages\`. Pages are the top-level roots; they have no \`parentId\` and their \`rootId\` points to themselves.
-`
-};
-//#endregion
-export { elementResource };

package/dist/modules/mcp/resources/glossary/environment.js

@@ -1,48 +0,0 @@
-//#region src/modules/mcp/resources/glossary/environment.ts
-var environmentResource = {
-	uri: "plitzi://docs/environment",
-	name: "Plitzi Docs: Environment",
-	description: "Deployment environments in Plitzi — main (working copy), development, staging, and production.",
-	mimeType: "text/markdown",
-	content: `# Environment
-
-An **Environment** in Plitzi is a named version of a space's schema, style, and segments. Each environment can be published independently to its own domain.
-
-## Type
-
-\`\`\`typescript
-type Environment = 'production' | 'staging' | 'development' | 'main';
-\`\`\`
-
-## Environments
-
-| Environment | Purpose |
-|---|---|
-| \`main\` | The live editing/working copy. Always present. All builder changes apply here. |
-| \`development\` | Internal preview environment. Used for QA before staging. |
-| \`staging\` | Pre-production review. Shown to stakeholders before going live. |
-| \`production\` | The public-facing live site. Published from \`main\` when changes are ready. |
-
-## Key Behaviors
-
-- **All builder operations target \`main\`** unless explicitly scoped to another environment.
-- Publishing copies the \`main\` schema/style to the target environment (e.g. \`production\`).
-- Each environment can have a different domain and CDN deployment.
-- Segments are also versioned per environment.
-
-## In API and Tools
-
-Most MCP tools accept an \`environment\` parameter (defaults to \`main\`) that scopes the read/write operation:
-
-\`\`\`typescript
-// Example: get schema for the staging environment
-getSchema({ environment: 'staging' })
-\`\`\`
-
-## AI Context
-
-The \`AiContext.environment\` field tells the AI agent which environment the current session is operating in. This affects which schema/style data is read and which changes are applied.
-`
-};
-//#endregion
-export { environmentResource };