@plitzi/sdk-server 0.32.25 → 0.33.1

package/dist/modules/mcp/catalogs/builtinCallbacks.js

@@ -1,204 +0,0 @@
-import { reconcileParams } from "./paramSpec.js";
-//#region src/modules/mcp/catalogs/builtinCallbacks.ts
-var BUILTIN_GLOBAL_CALLBACKS = {
-	addNotification: {
-		source: "space",
-		title: "Add Notification",
-		strictParams: true,
-		params: {
-			content: {
-				type: "textarea",
-				description: "The notification text shown to the user — this is the message body. There is no separate title/message/type param.",
-				default: "Content"
-			},
-			placement: {
-				type: "select",
-				description: "Where the toast appears on screen.",
-				default: "top-right",
-				options: [
-					"top-right",
-					"top-center",
-					"top-left",
-					"bottom-right",
-					"bottom-center",
-					"bottom-left"
-				]
-			},
-			appeareance: {
-				type: "select",
-				description: "Visual style of the notification. NOTE: the key is spelled \"appeareance\".",
-				default: "success",
-				options: [
-					"success",
-					"danger",
-					"warning",
-					"info"
-				]
-			},
-			autoDismiss: {
-				type: "boolean",
-				description: "Whether the notification dismisses itself after a timeout.",
-				default: true
-			},
-			autoDismissTimeout: {
-				type: "number",
-				description: "Milliseconds before auto-dismiss. Only applies when autoDismiss is true.",
-				default: 5e3,
-				when: (params) => params.autoDismiss === true
-			}
-		}
-	},
-	setState: {
-		source: "state",
-		title: "Set State",
-		strictParams: true,
-		params: {
-			key: {
-				type: "text",
-				description: "The state key/path to set.",
-				default: ""
-			},
-			type: {
-				type: "select",
-				description: "The value type.",
-				options: [
-					"boolean",
-					"number",
-					"text"
-				]
-			},
-			value: {
-				type: "scalar",
-				description: "The value to store — its type follows the `type` param (a real boolean/number, or text).",
-				when: (params) => Boolean(params.type)
-			}
-		}
-	},
-	clearState: {
-		source: "state",
-		title: "Clear State",
-		strictParams: true,
-		params: {}
-	},
-	navigate: {
-		source: "navigation",
-		title: "Navigate",
-		strictParams: true,
-		params: {
-			urlType: {
-				type: "select",
-				description: "Target kind: a space page, an internal space path, or an external URL.",
-				options: [
-					"page",
-					"internal",
-					"external"
-				]
-			},
-			url: {
-				type: "text",
-				description: "Destination — a page id when urlType is \"page\", otherwise a URL/path.",
-				when: (params) => Boolean(params.urlType)
-			}
-		}
-	},
-	authLogin: {
-		source: "auth",
-		title: "Auth Login",
-		strictParams: true,
-		params: {}
-	},
-	authLogout: {
-		source: "auth",
-		title: "Auth Logout",
-		strictParams: true,
-		params: {}
-	},
-	authRefreshDetails: {
-		source: "auth",
-		title: "Auth Refresh Details",
-		strictParams: true,
-		params: {}
-	},
-	addCollectionRecord: {
-		source: "collection",
-		title: "Add Collection Record",
-		strictParams: false,
-		params: {
-			collectionId: {
-				type: "select",
-				description: "The collection to add the record to."
-			},
-			recordStatus: {
-				type: "select",
-				description: "Status of the new record.",
-				default: "draft",
-				options: [
-					"published",
-					"draft",
-					"archived",
-					"deleted",
-					"created"
-				]
-			}
-		}
-	},
-	updateCollectionRecord: {
-		source: "collection",
-		title: "Update Collection Record",
-		strictParams: false,
-		params: {
-			collectionId: {
-				type: "select",
-				description: "The collection the record belongs to."
-			},
-			recordId: {
-				type: "select",
-				description: "The record to update."
-			},
-			recordStatus: {
-				type: "select",
-				description: "New status for the record.",
-				default: "draft",
-				options: [
-					"published",
-					"draft",
-					"archived",
-					"deleted",
-					"created"
-				]
-			}
-		}
-	},
-	removeCollectionRecord: {
-		source: "collection",
-		title: "Remove Collection Record",
-		strictParams: false,
-		params: {
-			collectionId: {
-				type: "select",
-				description: "The collection the record belongs to."
-			},
-			recordId: {
-				type: "select",
-				description: "The record to remove."
-			}
-		}
-	}
-};
-/** The built-in globalCallback for an action, or undefined when the action is not a known built-in (a plugin
-*  callback whose source/schema is not knowable here). */
-var getGlobalCallback = (action) => Object.hasOwn(BUILTIN_GLOBAL_CALLBACKS, action) ? BUILTIN_GLOBAL_CALLBACKS[action] : void 0;
-/** Resolve a `globalCallback` action against the built-in catalog: returns the module id it is registered under
-*  (`source`) and the params reconciled to the callback's schema — unknown keys dropped for a closed callback, then
-*  missing defaults filled. An action the catalog does not know (e.g. a plugin callback) yields no source and
-*  unchanged params, so the caller keeps its own behavior for it. */
-var applyBuiltinCallback = (action, params) => {
-	if (!(action in BUILTIN_GLOBAL_CALLBACKS)) return { params };
-	const builtin = BUILTIN_GLOBAL_CALLBACKS[action];
-	return {
-		source: builtin.source,
-		params: reconcileParams(params, builtin.params, builtin.strictParams)
-	};
-};
-//#endregion
-export { BUILTIN_GLOBAL_CALLBACKS, applyBuiltinCallback, getGlobalCallback };

package/dist/modules/mcp/catalogs/builtinComponents.js

@@ -1,170 +0,0 @@
-//#region src/modules/mcp/catalogs/builtinComponents.ts
-var BUILTIN_COMPONENTS = {
-	container: {
-		label: "Container",
-		category: "structure",
-		description: "Generic layout box (a div). The primary building block for structure: groups and positions child elements with flex/grid. Reach for it whenever you need to wrap or arrange other elements."
-	},
-	list: {
-		label: "List",
-		category: "structure",
-		description: "Repeats a template (its listItem/link child) once per entry of a data array — the way to render a dynamic collection. Bind its items to a data source (e.g. an apiContainer/collectionContainer response)."
-	},
-	listItem: {
-		label: "List Item",
-		category: "structure",
-		description: "The repeated template rendered once per row inside a list; its fields bind to each array entry."
-	},
-	dialogContainer: {
-		label: "Dialog Container",
-		category: "structure",
-		description: "A native <dialog> container shown or hidden through interactions (e.g. an onClick open/close)."
-	},
-	modalContainer: {
-		label: "Modal Container",
-		category: "structure",
-		description: "A modal overlay container opened and closed through interactions; use for dialogs over the page."
-	},
-	tabContainer: {
-		label: "Tab Container",
-		category: "structure",
-		description: "A tabbed container that switches between panels; composed of header/body/item parts."
-	},
-	tabContainerHeader: {
-		label: "Tab Container Header",
-		category: "structure",
-		description: "The row of tab triggers inside a tabContainer."
-	},
-	tabContainerBody: {
-		label: "Tab Container Body",
-		category: "structure",
-		description: "The panel area inside a tabContainer that shows the active tab item."
-	},
-	tabContainerItem: {
-		label: "Tab Container Item",
-		category: "structure",
-		description: "One selectable tab (trigger + panel) inside a tabContainer."
-	},
-	apiContainer: {
-		label: "Api Container",
-		category: "provider",
-		description: "Fetches data from a backend HTTP API (its `query`/`method`/`credentials`) and exposes the response as a data source ITS DESCENDANTS bind to (source `apiContainer_<idRef>.data`; only elements inside it can consume it). This is how you get backend data into the frontend. Its `mockData` prop is builder-only sample data — the published runtime fetches the real `query`, so always set a real query for production."
-	},
-	collectionContainer: {
-		label: "Collection Container",
-		category: "provider",
-		description: "Exposes a Plitzi Collection (built-in CMS) as a data source for its descendants to bind to — the CMS-backed counterpart of apiContainer."
-	},
-	text: {
-		label: "Text",
-		category: "basic",
-		description: "Inline plain-text content. Use for short runs of copy; bind its content to data for dynamic text."
-	},
-	paragraph: {
-		label: "Paragraph",
-		category: "basic",
-		description: "A block of body text (a <p>). Use for longer prose passages."
-	},
-	heading: {
-		label: "Heading",
-		category: "basic",
-		description: "A section heading (<h1>–<h6>) for titles and document hierarchy."
-	},
-	button: {
-		label: "Button",
-		category: "basic",
-		description: "A clickable button. On its own it only renders; wire an interaction flow (trigger onClick → callbacks) to make it DO something."
-	},
-	link: {
-		label: "Link",
-		category: "basic",
-		description: "Navigation. Moves the user between pages of the site or to an external URL (its `mode`/`href` decide which). Use this to go page-to-page rather than a button + interaction."
-	},
-	markdown: {
-		label: "Markdown",
-		category: "basic",
-		description: "Renders a Markdown source string as formatted HTML."
-	},
-	dropdown: {
-		label: "Dropdown",
-		category: "basic",
-		description: "A trigger that toggles an attached popup panel (dropdownPopup) — menus, selects, flyouts."
-	},
-	dropdownPopup: {
-		label: "Dropdown Popup",
-		category: "basic",
-		description: "The floating panel revealed by a dropdown."
-	},
-	form: {
-		label: "Form",
-		category: "form",
-		description: "A <form> that groups form controls and handles submission; wire its submit through an interaction flow."
-	},
-	formControl: {
-		label: "Form Control",
-		category: "form",
-		description: "A single labelled input (text/select/checkbox/… per its subType) inside a form; captures one field of user input."
-	},
-	image: {
-		label: "Image",
-		category: "media",
-		description: "Displays an image from a URL."
-	},
-	video: {
-		label: "Video",
-		category: "media",
-		description: "Embeds a video from a URL."
-	},
-	fontAwesome: {
-		label: "Font Awesome",
-		category: "media",
-		description: "Renders a Font Awesome icon by its icon name."
-	},
-	page: {
-		label: "Page",
-		category: "internal",
-		description: "The root of a routable screen. Managed through the page ops (upsertPage/deletePage), not added as a child element."
-	},
-	layoutContainer: {
-		label: "Layout Container",
-		category: "internal",
-		description: "A reusable layout shell (header/footer chrome) shared across pages."
-	},
-	notFound: {
-		label: "Not Found",
-		category: "internal",
-		description: "The 404 screen shown when no route matches."
-	},
-	loading: {
-		label: "Loading",
-		category: "internal",
-		description: "A loading placeholder shown while data or a suspense boundary resolves."
-	},
-	reference: {
-		label: "Reference",
-		category: "advanced",
-		description: "Reuses another element or template by id, rendering it in place."
-	},
-	custom: {
-		label: "Custom",
-		category: "advanced",
-		description: "A custom element slot whose behaviour is supplied by a host/plugin component."
-	},
-	blockHtml: {
-		label: "HTML Block",
-		category: "advanced",
-		description: "Renders an arbitrary raw HTML string as a block. Escape hatch when no structured element fits."
-	},
-	nodeHtml: {
-		label: "Html Node",
-		category: "advanced",
-		description: "A single raw HTML tag with custom attributes."
-	},
-	blockJsx: {
-		label: "Block JSX",
-		category: "advanced",
-		description: "A compiled JSX block for advanced authoring."
-	}
-};
-//#endregion
-export { BUILTIN_COMPONENTS };

package/dist/modules/mcp/catalogs/builtinElementCallbacks.js

@@ -1,50 +0,0 @@
-import { reconcileParams } from "./paramSpec.js";
-//#region src/modules/mcp/catalogs/builtinElementCallbacks.ts
-var BUILTIN_ELEMENT_CALLBACKS = { setState: {
-	title: "Update Element (set attribute / state)",
-	strictParams: true,
-	params: {
-		category: {
-			type: "select",
-			description: "What to change on the element: \"attribute\" sets one of its props (the common case — e.g. content, disabled); \"state\" sets element state (visibility or a style selector). REQUIRED — always set it.",
-			default: "attribute",
-			options: ["attribute", "state"],
-			required: true
-		},
-		key: {
-			type: "text",
-			description: "The field to set. When category=\"attribute\", an attribute/prop key of THIS element (e.g. \"content\", \"disabled\"). When category=\"state\", \"visibility\" or \"styleSelectors.<selector>\". REQUIRED.",
-			required: true
-		},
-		value: {
-			type: "scalar",
-			description: "The value to set — its type follows the target attribute: a real boolean (true/false) for a boolean attribute, a number for a numeric one, otherwise a string (the strings \"true\"/\"false\" also coerce). There is NO separate `type` param (that belongs to the global state setState, not this one). REQUIRED.",
-			when: (params) => Boolean(params.category),
-			required: true
-		},
-		revertOnFinish: {
-			type: "boolean",
-			description: "When true, this change is UNDONE automatically when the whole flow finishes. Use it for a TEMPORARY change (a \"loading…\" label, disabling a button while it works) instead of adding manual restore steps at the end of the flow.",
-			default: false
-		}
-	}
-} };
-/** The built-in element callback for an action, or undefined when the action is not a known built-in (an
-*  element-type-specific/plugin callback whose schema is not knowable here). */
-var getElementCallback = (action) => Object.hasOwn(BUILTIN_ELEMENT_CALLBACKS, action) ? BUILTIN_ELEMENT_CALLBACKS[action] : void 0;
-/** Reconcile a `callback` action against the element-callback catalog: unknown keys dropped for a closed callback,
-*  then missing defaults filled (category:"attribute", revertOnFinish:false). An unknown action yields unchanged
-*  params, so a plugin/element-specific callback keeps whatever the agent passed. */
-var applyElementCallback = (action, params) => {
-	const builtin = getElementCallback(action);
-	if (!builtin) return {
-		known: false,
-		params
-	};
-	return {
-		known: true,
-		params: reconcileParams(params, builtin.params, builtin.strictParams)
-	};
-};
-//#endregion
-export { BUILTIN_ELEMENT_CALLBACKS, applyElementCallback, getElementCallback };

package/dist/modules/mcp/catalogs/builtinTransformers.js

@@ -1,148 +0,0 @@
-//#region src/modules/mcp/catalogs/builtinTransformers.ts
-var boolParam = (description, dflt) => ({
-	type: "select",
-	description,
-	default: dflt,
-	options: ["true", "false"]
-});
-var BUILTIN_TRANSFORMERS = {
-	twigTemplate: {
-		title: "Twig Template",
-		description: "Render a Twig template around the bound value — the way to format/wrap a value (add units, compose a label). The incoming value is the token {{source}} (NOT {{value}}); {{sourceTo}} is the field’s previous value, and other data-source tokens are in scope too.",
-		strictParams: true,
-		params: { template: {
-			type: "textarea",
-			required: true,
-			description: "The Twig template string. Reference the incoming value as {{source}} — e.g. \"{{source}} min de cocción\". There is NO {{value}} token; {{sourceTo}} is the field’s original value."
-		} }
-	},
-	dateConverter: {
-		title: "Date Converter",
-		description: "Format a date/timestamp value. Reads a unix-seconds number (isUnix) or a parseable date string and outputs a formatted date, or a relative \"x ago\" string (asAge).",
-		strictParams: true,
-		params: {
-			format: {
-				type: "text",
-				default: "dd/MM/yyyy",
-				description: "date-fns format pattern, e.g. \"dd/MM/yyyy\" or \"PPpp\". Ignored when asAge is true."
-			},
-			asAge: boolParam("Output a relative \"x ago\" string instead of a formatted date.", "false"),
-			isUnix: boolParam("The source value is a unix timestamp in SECONDS (not milliseconds).", "true"),
-			isUtc: boolParam("Format in UTC instead of local time.", "false"),
-			locale: {
-				type: "select",
-				default: "en",
-				options: [
-					"en",
-					"es",
-					"pt"
-				],
-				description: "Locale for month/day names and relative text."
-			}
-		}
-	},
-	capitalize: {
-		title: "Capitalize",
-		description: "Capitalize the first letter of a string value. Takes no params.",
-		strictParams: true,
-		params: {}
-	},
-	staticValue: {
-		title: "Static Value",
-		description: "Ignore the source and emit a fixed value — use to hard-code a bound field. With valueType \"select\" the value is coerced to a boolean (\"true\"→true).",
-		strictParams: true,
-		params: {
-			valueType: {
-				type: "select",
-				default: "text",
-				options: [
-					"text",
-					"textarea",
-					"select"
-				],
-				description: "How `value` is interpreted: \"text\"/\"textarea\" → string, \"select\" → boolean (\"true\"/\"false\")."
-			},
-			value: {
-				type: "text",
-				description: "The constant value to emit (a string; \"true\"/\"false\" when valueType is select)."
-			}
-		}
-	},
-	arrayMap: {
-		title: "Array Map",
-		description: "Reshape each object of a source array by remapping keys — pick/rename fields for a list. Input must be an array; a non-array passes through unchanged.",
-		strictParams: true,
-		params: { keys: {
-			type: "textarea",
-			required: true,
-			default: "[{\"from\": \"\", \"to\": \"\"}]",
-			description: "A JSON array of { \"from\": <source path>, \"to\": <output key> } mappings, e.g. [{\"from\":\"title\",\"to\":\"label\"},{\"from\":\"id\",\"to\":\"value\"}]."
-		} }
-	},
-	stringToArray: {
-		title: "Text to List",
-		description: "Split a string into an array on a separator (each item trimmed). A non-string passes through unchanged.",
-		strictParams: true,
-		params: { separator: {
-			type: "text",
-			default: ",",
-			description: "The delimiter to split on, e.g. \",\" or \"|\"."
-		} }
-	},
-	styleSelector: {
-		title: "Style Selector",
-		description: "Compute a style-class selector from data — bind a `style` target to switch an element’s class at runtime. Builder-oriented (its `selector` options come from the style schema); prefer style variants for most cases.",
-		strictParams: true,
-		params: {
-			append: boolParam("Append `selector` to the existing selector instead of replacing it.", "false"),
-			originalSelector: boolParam("When appending, keep the element’s original base selector (requires append).", "false"),
-			selector: {
-				type: "text",
-				description: "The class-selector name to apply (a class from the style schema)."
-			}
-		}
-	},
-	styleVariant: {
-		title: "Style Variant",
-		description: "Compute an applied style-variant map from data — bind an `initialState` target to switch a variant at runtime. Builder-oriented (key/variant options come from the element’s style schema); prefer static variants for most cases.",
-		strictParams: true,
-		params: {
-			key: {
-				type: "text",
-				description: "The selector key to target, e.g. \"<type>.base\"."
-			},
-			variant: {
-				type: "text",
-				description: "The variant name to apply under `key`."
-			},
-			append: boolParam("Merge with the existing variant map instead of replacing it.", "false")
-		}
-	}
-};
-/** The built-in transformer for an action, or undefined when the action is not a known built-in transformer. */
-var getTransformer = (action) => Object.hasOwn(BUILTIN_TRANSFORMERS, action) ? BUILTIN_TRANSFORMERS[action] : void 0;
-/** The closest known transformer action to a mistyped one (substring match either way), so a wrong action like
-*  "template" teaches "twigTemplate". Undefined when nothing is close. */
-var suggestTransformer = (action) => {
-	const needle = action.toLowerCase();
-	return Object.keys(BUILTIN_TRANSFORMERS).find((name) => {
-		const known = name.toLowerCase();
-		return known.includes(needle) || needle.includes(known);
-	});
-};
-/** The transformer catalog projected for the data-sources resource / primer, so the agent knows the exact action
-*  names and params up front (the real fix for the "agent can't write transformers" problem). */
-var transformerCatalog = () => Object.entries(BUILTIN_TRANSFORMERS).map(([action, { title, description, params }]) => ({
-	action,
-	title,
-	description,
-	params: Object.entries(params).map(([name, spec]) => ({
-		name,
-		type: spec.type,
-		description: spec.description,
-		...spec.default !== void 0 ? { default: spec.default } : {},
-		...spec.options ? { options: spec.options } : {}
-	}))
-}));
-//#endregion
-export { BUILTIN_TRANSFORMERS, getTransformer, suggestTransformer, transformerCatalog };

package/dist/modules/mcp/catalogs/builtinUtilities.js

@@ -1,90 +0,0 @@
-import { reconcileParams } from "./paramSpec.js";
-//#region src/modules/mcp/catalogs/builtinUtilities.ts
-var BUILTIN_UTILITIES = {
-	delayTime: {
-		title: "Delay Time",
-		strictParams: true,
-		params: { time: {
-			type: "number",
-			description: "Milliseconds to wait before the next step runs. The key is \"time\" (not \"delay\")."
-		} }
-	},
-	twigTemplate: {
-		title: "Twig Template",
-		strictParams: true,
-		params: {
-			returnMode: {
-				type: "select",
-				description: "How the rendered template is returned.",
-				default: "text",
-				options: [
-					"text",
-					"json",
-					"jsonObject"
-				]
-			},
-			template: {
-				type: "textarea",
-				description: "The Twig template string to render against the flow/global params."
-			}
-		}
-	},
-	webHook: {
-		title: "Webhook",
-		strictParams: true,
-		params: {
-			url: {
-				type: "text",
-				description: "The URL to call."
-			},
-			method: {
-				type: "select",
-				description: "HTTP method.",
-				default: "get",
-				options: [
-					"get",
-					"post",
-					"put",
-					"delete",
-					"patch",
-					"head"
-				]
-			},
-			body: {
-				type: "textarea",
-				description: "Request body."
-			},
-			authorizationToken: {
-				type: "text",
-				description: "Value sent as the Authorization header."
-			},
-			credentials: {
-				type: "select",
-				description: "fetch credentials mode.",
-				default: "same-origin",
-				options: [
-					"include",
-					"omit",
-					"same-origin"
-				]
-			}
-		}
-	}
-};
-/** The built-in utility for an action, or undefined when the action is not a known built-in utility. */
-var getUtility = (action) => Object.hasOwn(BUILTIN_UTILITIES, action) ? BUILTIN_UTILITIES[action] : void 0;
-/** Reconcile a `utility` action against the utility catalog: unknown keys dropped for a closed utility, then missing
-*  defaults filled. An unknown action yields unchanged params. */
-var applyUtility = (action, params) => {
-	const utility = getUtility(action);
-	if (!utility) return {
-		known: false,
-		params
-	};
-	return {
-		known: true,
-		params: reconcileParams(params, utility.params, utility.strictParams)
-	};
-};
-//#endregion
-export { BUILTIN_UTILITIES, applyUtility, getUtility };

package/dist/modules/mcp/catalogs/cssCatalog/border.js

@@ -1,30 +0,0 @@
-import { BORDER_STYLES, BORDER_WIDTH_KEYWORDS, LENGTH_RE, SIDES, expandTo4, splitTokens } from "./helpers.js";
-//#region src/modules/mcp/catalogs/cssCatalog/border.ts
-var BORDER_INITIAL = {
-	width: "medium",
-	style: "none",
-	color: "currentcolor"
-};
-var classifyBorderToken = (token) => {
-	if (BORDER_STYLES.has(token)) return "style";
-	if (BORDER_WIDTH_KEYWORDS.has(token) || LENGTH_RE.test(token)) return "width";
-	return "color";
-};
-var classifyBorderTokens = (value) => {
-	const parts = { ...BORDER_INITIAL };
-	for (const token of splitTokens(value)) parts[classifyBorderToken(token)] = token;
-	return parts;
-};
-var expandBorder = (key, value, out) => {
-	const sides = key === "border" ? SIDES : [key.slice(7)];
-	const parts = classifyBorderTokens(value);
-	for (const side of sides) for (const [kind, token] of Object.entries(parts)) out[`border-${side}-${kind}`] = token;
-};
-var expandBorderGroup = (suffix, value, out) => {
-	const values = expandTo4(splitTokens(value));
-	SIDES.forEach((side, index) => {
-		out[`border-${side}-${suffix}`] = values[index];
-	});
-};
-//#endregion
-export { classifyBorderTokens, expandBorder, expandBorderGroup };