@plitzi/sdk-mcp 0.38.1 → 0.38.3

package/CHANGELOG.md

@@ -1,5 +1,154 @@
 # @plitzi/sdk-mcp
 
+## 0.38.3
+
+### Patch Changes
+
+- e047e1d: ## `plitzi upgrade`: a project brought up to its CLI
+
+  A project written by an older CLI had no way up but `plitzi create` in a scratch folder and a file-by-file comparison:
+  `skills update` brought the skills and nothing else, so the `check` and `shot` scripts they teach did not exist.
+  `plitzi upgrade` (also `update`) shows what this CLI writes today for what is the CLI's in the project, and `--write`
+  makes it. One part or several: `plitzi upgrade skills`, `plitzi upgrade files packages`.
+
+  - **`files`:** the CLI's machinery — `author.ts`, `main.ts`, the Playwright, TypeScript and lint configs, AGENTS.md. One
+    nobody changed since the CLI wrote it is replaced, a missing one added; one the project made its own is shown as a
+    diff and left, until `--take <file>` (or `all`). `plitzi create` now records what it wrote, by digest, in
+    `.plitzi/scaffold.json`; a project made before that sees every file that differs as its own.
+  - **`packages`:** `package.json` merged, never replaced — the scripts and dependencies it lacks added, `@plitzi/*`
+    raised to this version, then the install (`--no-install` to leave it). A script of the project's own stays.
+  - **`skills`:** `.claude/skills/plitzi-*` from the packages installed, each replaced whole, and the ones a newer CLI
+    writes added. `plitzi skills update` is `plitzi upgrade skills --write`.
+  - **`renames`:** a name a version renamed with no alias, at its file and line — `canTemplate` → `canSnippet`,
+    `authorTemplate` → `authorSnippet` and its kin (renamed only where imported from `@plitzi/sdk-authoring`) — renamed
+    with `--write`.
+
+  `npm run author` says when the skills or the CLI's files are older than the SDK installed, and `plitzi --version`
+  prints the CLI's.
+
+  ## Page checks that can be the definition of done
+
+  `inspectPage`, `plitzi check` and the scaffold's visual test failed pages that were whole, so an agent learnt to ignore
+  them:
+
+  - **A breakpoint hiding an element on purpose** — the desktop navigation on a phone, a bottom bar only a phone shows —
+    is no longer "not visible": an element whose `display` or `visibility` a breakpoint rule sets is checked at the width
+    it shows at.
+  - **A lazy image out of sight** waits whichever side it is out of: below the fold, as before, or beside the screen in a
+    carousel's track — cut off by any ancestor that clips, as the browser decides when to fetch it.
+  - **A plugin that draws nothing** says so: `drawsNothing: true` in its declaration (a clock that fires a flow), and its
+    handle is `boxless`, so no check waits for it on screen.
+
+  `plitzi check --json` and `PageReport` carry `issues` beside `problems`: each with its `code` (`element-hidden`,
+  `image-not-loaded`, `sideways-scroll`…), the `elementId` it is about and, in `check`, the `width`.
+
+  ## Authoring
+  - **A link's `content` names it.** `control-without-name` read only a link's `label`, so applying the
+    `content-attribute` suggestion as written turned every link into a warning.
+  - **`plitzi fix` writes `content-attribute`** where it has one reading: a button's or link's children that are only
+    `text(…)` and `fontAwesome({ icon })` become its own `content` and `icon` — the words kept as written, an import left
+    unused taken out. A child with an id, options or a class of the space's own stays, and is said. `npm run author`'s
+    `[fix]` line counts these too.
+  - **The recipes, the skill's examples and the catalog template** hold to the suggestions as well as the warnings, and
+    their tests say so: six recipes and the template wrote a link's or a button's words as a child.
+
+  ## Declared motion — in code, in the builder and over MCP
+
+  An element says how it arrives and whether it keeps moving with `motion`, and the SDK's stylesheet plays it — no
+  keyframes to write: `{ enter: 'fade-up', on: 'view' }` arrives as it scrolls into view, `{ enter: 'scale', stagger:
+60 }` brings its children one by one (a grid, a list's rows), `{ loop: 'float' }` keeps it moving. Enters: `fade`,
+  `fade-up`, `fade-down`, `slide-left`, `slide-right`, `scale`; loops: `float`, `pulse`, `spin`, `sway`; `duration`,
+  `delay`, `stagger` in ms. Opacity and the transforms only — an arrival on `translate`/`scale`, so it composes with an
+  element's own `transform` — a loop held until the page is live (`data-hydrated`), and none of it for a visitor who asked
+  for less motion. `view` follows the scroll where the browser has scroll timelines and plays on load where not.
+
+  - **Authoring:** `motion` on any factory; refused where it cannot play (`motion-invalid`, `motion-no-tag`), and carried
+    by `specFromSpace` and `compareSpaces`.
+  - **Builder:** a **Motion** tab in an element's tools: the presets as chips, a stage that plays the one pointed at (a
+    loop shown stronger than the page plays it, and saying so), when and how long, children one by one, and the choices
+    read back as a sentence — laid out side by side once the sidebar is wide enough. The canvas holds motion still while
+    editing; **▶** in the header (or **Play on the canvas** in the tab) plays it from the start, restarting what already
+    played, and an arrival tied to the scroll plays by the clock there, where it is usually in view already.
+  - **MCP:** `motion` on `upsertElement` and `patchElement`, checked the same way; the guide names the presets.
+  - **Schema:** `definition.motion` (`ElementMotion`, `@plitzi/sdk-shared/schema/motion` — the presets, `motionProblems`,
+    `motionAttributes`, `isMotionAnimation`, and each preset's frames, which the stylesheet is tested against), in both
+    init queries. **The platform's GraphQL schema has to declare `SpaceElementMotion`
+    before this version's builder or SDK queries it.**
+
+  ## Dev tools QA: x-ray and motion
+
+  The **QA** tab gains an **X-ray**: every element the document wires something to — bound to data, shown on a condition,
+  running a flow, moving, behind a flag — outlined in its colour and named on the page, read from the space's document by
+  the element's name; its legend counts each kind on the page and picks one to show alone. Beside **Pause**, **Slow**
+  plays every animation at a quarter of its speed and **Replay** plays the declared motion again from the start, without
+  reloading the page.
+
+  ## Plugins that draw
+
+  `useCanvas2d`, `useWebGL`, `useWebGL2` and `useAnimationFrame` (`@plitzi/plitzi-sdk`): a canvas sized to the device (at
+  most 2×), followed as it resizes, animating only while somebody can see it move — a live page, no reduced motion, the
+  tab in front, the canvas on screen — and one still frame otherwise (the builder included). `createShaderProgram`
+  compiles and links, and a shader that fails throws a `ShaderError` with the driver's log, printed as
+  `[plugin <type> "<id>"] fragment shader failed: …` instead of an empty canvas; `error` and `ready` say where it is.
+  `useReducedMotion` for the rest.
+
+  ## A space re-authored without a restart
+
+  A project's `npm run start:dev` restarts for its server code and its plugins only: a save to the space is re-authored
+  in a process of its own and every open page loads again (`server.reloadPages()` over an SSE endpoint, on with
+  `createServer({ devReload: true })` — never by `devMode` alone, since every open page holds a connection for it); an
+  edit authoring refuses is printed and the page keeps the last space that authored. A shutdown also ends WebSockets at
+  once (`1001`, going away) rather than waiting out the grace — the ten seconds a restart used to wait on an open page.
+
+  ## Checks and authoring, from the stripe.com experiment
+  - **A component's instance** is found by its own name: its root carries `data-plitzi-instance`, and the instance's
+    handle selects it — `inspectPage` no longer reports every named instance as missing.
+  - **Hidden at this width on purpose** — the burger on a desktop, the desktop menu on a phone — is listed apart
+    (`hiddenAtWidth`, and a dim line under `plitzi check`'s ✓) rather than as a problem.
+  - **An element whose every child is conditional** — four flyouts in one list, each opening on the state that names
+    it — is conditional too: at rest it shows nothing, and that is it working.
+  - **A carousel that scrolls by itself** (`overflow-x: auto`) is not the page scrolling sideways; the page's own pane
+    still is.
+  - **Templates:** `{{ state.faq ?? -1 }}` — a sign on the right of `??` — reads.
+  - **A plugin attribute named as an element field** (`variant`, `class`, `id`…) is warned about
+    (`plugin-attribute-reserved`): a factory never hands it to the plugin. A `variant` no class or type style declares is
+    `unknown-variant`.
+  - **Lists:** a list with `items` renders as the `<ul>` (or `<ol>`) its `subType` says — it was a `<div>` — with no
+    markers and the same spacing, so a page looks as it did; the builder offers the list type for it too. Its rows are
+    `<li>`s: `list-row-not-li` warns of one that is not — a plain container is made one by `fixSpace`, a link or a button
+    is wrapped — and the recipes, the catalog template and the docs write rows as `listItem`.
+  - **CSS:** `mask-size`, `mask-position`, `mask-repeat`, `mask-composite`, `-webkit-mask-image`,
+    `-webkit-background-clip`, `box-decoration-break` and `-webkit-box-decoration-break`.
+  - **`plitzi shot`:** `--clip <element>`, `--scroll-to <element>` and `--viewport`; `--frames` takes the same framing.
+  - **SVG from files:** `svgFile` and `svgFiles` (`@plitzi/sdk-authoring/node`) read a logo or a folder of them,
+    compacted (`compactSvg`, also on the main entry), instead of strings in the space's source.
+  - The plugin scaffolds say that an inline `style` on `RootElement` outranks the element's classes.
+
+- Updated dependencies [e047e1d]
+  - @plitzi/sdk-authoring@0.38.3
+  - @plitzi/sdk-elements@0.38.3
+  - @plitzi/sdk-interactions@0.38.3
+  - @plitzi/sdk-schema@0.38.3
+  - @plitzi/sdk-shared@0.38.3
+  - @plitzi/sdk-style@0.38.3
+  - @plitzi/plitzi-sdk@0.38.3
+  - @plitzi/sdk-server@0.38.3
+
+## 0.38.2
+
+### Patch Changes
+
+- v0.38.2
+- Updated dependencies
+  - @plitzi/plitzi-sdk@0.38.2
+  - @plitzi/sdk-authoring@0.38.2
+  - @plitzi/sdk-elements@0.38.2
+  - @plitzi/sdk-interactions@0.38.2
+  - @plitzi/sdk-schema@0.38.2
+  - @plitzi/sdk-server@0.38.2
+  - @plitzi/sdk-shared@0.38.2
+  - @plitzi/sdk-style@0.38.2
+
 ## 0.38.1
 
 ### Patch Changes

package/dist/modules/mcp/helpers/guide.js

@@ -616,7 +616,9 @@ reads \`list_<name>.item.values.<field>\`), \`.pageInfo\` (\`page\`, \`pageCount
 instead of \`.records\` — that is what a **detail page** uses. Bind an empty-state block's visibility to \`.isEmpty\`
 and an error block's to \`.hasError\`; they are ordinary bindings, no special mechanism.
 
-**A list page** — provider, then a \`list\` inside it bound to the records, then the row template reading the item:
+**A list page** — provider, then a \`list\` inside it bound to the records, then the row template reading the item
+(a \`list\` is a \`<ul>\`, or \`<ol>\` by \`subType\`; its row a \`listItem\`, an \`<li>\` — any other row is warned
+\`list-row-not-li\`):
 \`\`\`json
 { "operations": [
   { "type": "upsertElement", "pageRef": "blog", "element": {
@@ -922,7 +924,11 @@ Space-level configuration lives in \`plitzi://settings/{env}\` and is edited wit
   \`{ "type": "patchSettings", "customCss": "@keyframes spin { to { transform: rotate(360deg); } }" }\`.
 
 ## Motion — good practices
-Keyframes go in \`customCss\` (\`patchSettings\`), a definition names them (\`animation\`). Only \`opacity\` and
+A preset first: an element's \`motion\` field (\`upsertElement\`/\`patchElement\`) —
+\`{ "enter": "fade-up", "on": "view" }\`, \`"stagger": 60\` for its children one by one, \`"loop": "float"\` — is
+played by the SDK, cheap and stilled for reduced motion. Enters: fade, fade-up, fade-down, slide-left, slide-right,
+scale; loops: float, pulse, spin, sway. Beyond them, keyframes go in \`customCss\` (\`patchSettings\`), a
+definition names them (\`animation\`). Only \`opacity\` and
 \`transform\` (\`translate\`, \`scale\`, \`rotate\`) animate off the main thread: they stay smooth while the page
 hydrates and on a slow phone. Anything else repaints or lays the page out again on every frame, and freezes while the
 page's scripts run.

package/dist/modules/mcp/server.js

@@ -69,7 +69,7 @@ var createMcpServer = async ({ adapters, getGrant, preview, screenshot, logger,
 	const getSpace = () => spacePromise ??= loadSpace();
 	const server = new McpServer({
 		name: "plitzi-mcp",
-		version: "0.38.1"
+		version: "0.38.3"
 	}, { instructions: hasSpace ? serverInstructions : widgetsOnlyInstructions });
 	const { getChanges } = adapters;
 	registerResources(server, getSpace, MCP_ENV, log, hasSpace, getChanges ? (query) => getChanges(requireSpaceId(), MCP_ENV, query) : void 0);

package/dist/modules/mcp/tools/apply/index.d.ts

@@ -56,6 +56,7 @@ export declare const applyShape: {
         }>>;
         flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         anchor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        motion: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"deleteElement">;
         pageRef: z.ZodString;

package/dist/modules/mcp/tools/operations/index.d.ts

@@ -52,6 +52,7 @@ export declare const documentOperation: z.ZodDiscriminatedUnion<readonly [z.ZodO
     }>>;
     flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     anchor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    motion: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"deleteElement">;
     pageRef: z.ZodString;
@@ -836,6 +837,7 @@ export declare const operation: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }>>;
     flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     anchor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    motion: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"deleteElement">;
     pageRef: z.ZodString;
@@ -1892,6 +1894,7 @@ export declare const operations: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject
     }>>;
     flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     anchor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    motion: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"deleteElement">;
     pageRef: z.ZodString;
@@ -2943,6 +2946,7 @@ export declare const documentOperations: z.ZodArray<z.ZodDiscriminatedUnion<read
     }>>;
     flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     anchor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    motion: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"deleteElement">;
     pageRef: z.ZodString;

package/dist/modules/mcp/tools/operations/schema/elements/patchElement.d.ts

@@ -24,6 +24,7 @@ export declare const patchElementOp: z.ZodObject<{
     }>>;
     flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     anchor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    motion: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
 }, z.core.$strip>;
 export type PatchElement = z.infer<typeof patchElementOp>;
 export declare const patchElement: (space: Space, env: Env, op: PatchElement) => OpResult;

package/dist/modules/mcp/tools/operations/schema/elements/patchElement.js

@@ -1,10 +1,11 @@
 import { findRootByRef, invalidateIndex, resolveRef } from "../../../../helpers/space.js";
 import { pageUri } from "../../../../helpers/uris.js";
 import { empty, fail } from "../../../../helpers/opResult.js";
-import { elementAnchor, elementFlag, elementRuntime, initialStateInput, styleRefs } from "../shared.js";
+import { elementAnchor, elementFlag, elementMotion, elementRuntime, initialStateInput, styleRefs } from "../shared.js";
 import { guardNewRef, writeInitialState } from "../write.js";
 import { flagGateOf } from "@plitzi/sdk-authoring";
 import { z } from "zod";
+import { isMotion } from "@plitzi/sdk-shared/schema/motion";
 import { repointIds } from "@plitzi/sdk-schema/helpers/elementId";
 //#region src/modules/mcp/tools/operations/schema/elements/patchElement.ts
 var patchElementOp = z.object({
@@ -19,7 +20,8 @@ var patchElementOp = z.object({
 	initialState: initialStateInput.optional().describe("Merged onto existing initialState: styleVariant overlays per class/selector, visibility overrides"),
 	runtime: elementRuntime.optional(),
 	flag: elementFlag.nullable().optional(),
-	anchor: elementAnchor.nullable().optional().describe("null removes it")
+	anchor: elementAnchor.nullable().optional().describe("null removes it"),
+	motion: elementMotion.nullable().optional().describe("null removes it")
 }).describe("Partially update an EXISTING element: only the fields you pass change (props/style/initialState are merged, not replaced). Never creates — fails if ref does not resolve. Use upsertElement to create or fully replace.");
 var patchElement = (space, env, op) => {
 	const page = findRootByRef(space.schema, op.pageRef);
@@ -55,6 +57,8 @@ var patchElement = (space, env, op) => {
 	else if (op.flag !== void 0) el.definition.flag = flagGateOf(op.flag, `Element "${op.ref}"`);
 	if (op.anchor === null) Reflect.deleteProperty(el.definition, "anchor");
 	else if (op.anchor !== void 0) el.definition.anchor = op.anchor;
+	if (op.motion === null) Reflect.deleteProperty(el.definition, "motion");
+	else if (isMotion(op.motion)) el.definition.motion = op.motion;
 	return {
 		...empty(),
 		updated: 1,

package/dist/modules/mcp/tools/operations/schema/elements/upsertElement.js

@@ -5,6 +5,7 @@ import { elementInput, position } from "../shared.js";
 import { DROP_POSITION, collectInputRefs, createElement, guardNewRef, writeInitialState } from "../write.js";
 import { flagGateOf } from "@plitzi/sdk-authoring";
 import { z } from "zod";
+import { isMotion } from "@plitzi/sdk-shared/schema/motion";
 //#region src/modules/mcp/tools/operations/schema/elements/upsertElement.ts
 var upsertElementOp = z.object({
 	type: z.literal("upsertElement"),
@@ -35,6 +36,7 @@ var upsertElement = (space, env, op) => {
 		if (op.element.runtime !== void 0) existing.definition.runtime = op.element.runtime;
 		if (op.element.flag !== void 0) existing.definition.flag = flagGateOf(op.element.flag, `Element "${op.element.ref}"`);
 		if (op.element.anchor !== void 0) existing.definition.anchor = op.element.anchor;
+		if (isMotion(op.element.motion)) existing.definition.motion = op.element.motion;
 		return {
 			...empty(),
 			updated: 1,

package/dist/modules/mcp/tools/operations/schema/motion.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/modules/mcp/tools/operations/schema/operations.d.ts

@@ -52,6 +52,7 @@ export declare const elementOps: {
         }>>;
         flag: import('zod').ZodOptional<import('zod').ZodNullable<import('zod').ZodString>>;
         anchor: import('zod').ZodOptional<import('zod').ZodNullable<import('zod').ZodString>>;
+        motion: import('zod').ZodOptional<import('zod').ZodNullable<import('zod').ZodRecord<import('zod').ZodString, import('zod').ZodUnknown>>>;
     }, import('zod/v4/core').$strip>;
     deleteElement: import('zod').ZodObject<{
         type: import('zod').ZodLiteral<"deleteElement">;

package/dist/modules/mcp/tools/operations/schema/shared.d.ts

@@ -20,6 +20,8 @@ export interface ElementInput {
     runtime?: ElementRuntime;
     flag?: string;
     anchor?: string;
+    /** Checked by `motionProblems`: what arrives here is one, which `isMotion` narrows it to where it is written. */
+    motion?: Record<string, unknown>;
     children?: ElementInput[];
 }
 export declare const styleRefs: z.ZodObject<{
@@ -39,6 +41,14 @@ export declare const elementRuntime: z.ZodEnum<{
 export declare const elementFlag: z.ZodString;
 /** The element's `id` in the DOM, so `/page#anchor` lands on it — the one pattern every writer holds it to. */
 export declare const elementAnchor: z.ZodString;
+/**
+ * How an element arrives and whether it keeps moving — the presets the SDK's stylesheet plays, and nothing else.
+ *
+ * An open object, checked by `motionProblems`, rather than its fields spelled out: this schema is in every tool that
+ * carries the op union, and spelled out it cost the listing more than its budget had room for. A wrong preset is
+ * refused with the list of right ones, and the guide's Motion section names them all.
+ */
+export declare const elementMotion: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 export declare const initialStateInput: z.ZodObject<{
     styleVariant: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>>;
     visibility: z.ZodOptional<z.ZodBoolean>;
@@ -64,6 +74,7 @@ export declare const elementShape: {
     }>>;
     flag: z.ZodOptional<z.ZodString>;
     anchor: z.ZodOptional<z.ZodString>;
+    motion: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 };
 export declare const elementInput: z.ZodType<ElementInput>;
 export declare const position: z.ZodEnum<{

package/dist/modules/mcp/tools/operations/schema/shared.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { FLAG_GATE_PATTERN } from "@plitzi/sdk-shared/flags";
 import { ANCHOR_PATTERN } from "@plitzi/sdk-shared/schema/anchor";
+import { motionProblems } from "@plitzi/sdk-shared/schema/motion";
 //#region src/modules/mcp/tools/operations/schema/shared.ts
 var combinator = z.enum(["and", "or"]);
 var operator = z.enum([
@@ -70,6 +71,19 @@ var elementRuntime = z.enum([
 var elementFlag = z.string().regex(FLAG_GATE_PATTERN).describe("Feature flag: `name` renders only while on, `!name` only while off");
 /** The element's `id` in the DOM, so `/page#anchor` lands on it — the one pattern every writer holds it to. */
 var elementAnchor = z.string().regex(ANCHOR_PATTERN).describe("Its DOM id, for `/page#anchor` and the `hash` of a link; one per page");
+/**
+* How an element arrives and whether it keeps moving — the presets the SDK's stylesheet plays, and nothing else.
+*
+* An open object, checked by `motionProblems`, rather than its fields spelled out: this schema is in every tool that
+* carries the op union, and spelled out it cost the listing more than its budget had room for. A wrong preset is
+* refused with the list of right ones, and the guide's Motion section names them all.
+*/
+var elementMotion = z.record(z.string(), z.unknown()).superRefine((motion, ctx) => {
+	for (const problem of motionProblems(motion)) ctx.addIssue({
+		code: "custom",
+		message: problem
+	});
+}).describe("{enter,on,duration,delay,stagger,loop} — guide: Motion");
 var initialStateInput = z.object({
 	styleVariant: styleVariantInput.optional().describe("Variant each attached class uses: { className: { base|slot: variantName | [names] } }"),
 	visibility: z.boolean().optional().describe("Initial visibility of the element")
@@ -84,7 +98,8 @@ var elementShape = {
 	initialState: initialStateInput.optional().describe("Applied style variant(s) and initial visibility (see plitzi://guide styling)"),
 	runtime: elementRuntime.optional(),
 	flag: elementFlag.optional(),
-	anchor: elementAnchor.optional()
+	anchor: elementAnchor.optional(),
+	motion: elementMotion.optional()
 };
 var elementInput = z.lazy(() => z.object({
 	...elementShape,
@@ -141,4 +156,4 @@ var interactionNode = z.object({
 	preview: z.record(z.string(), z.unknown()).optional()
 });
 //#endregion
-export { bindingCategory, bindingInput, elementAnchor, elementFlag, elementInput, elementRuntime, elementShape, initialStateInput, interactionNode, interactionNodeType, position, ruleGroup, scalar, styleRefs, styleVariantInput };
+export { bindingCategory, bindingInput, elementAnchor, elementFlag, elementInput, elementMotion, elementRuntime, elementShape, initialStateInput, interactionNode, interactionNodeType, position, ruleGroup, scalar, styleRefs, styleVariantInput };

package/dist/modules/mcp/tools/operations/schema/write.js

@@ -3,6 +3,7 @@ import { folderUri, foldersUri, layoutsUri, pageUri, pagesUri, schemaVarsUri, se
 import { fail } from "../../../helpers/opResult.js";
 import { flagGateOf } from "@plitzi/sdk-authoring";
 import { documentIds } from "@plitzi/sdk-schema/helpers/components";
+import { isMotion } from "@plitzi/sdk-shared/schema/motion";
 import { elementIdConflict, isValidElementId } from "@plitzi/sdk-schema/helpers/elementId";
 import FlatMap from "@plitzi/sdk-schema/helpers/FlatMap";
 //#region src/modules/mcp/tools/operations/schema/write.ts
@@ -67,7 +68,8 @@ var createElement = (space, page, input, anchorId, drop) => {
 			styleSelectors,
 			...input.runtime === void 0 ? {} : { runtime: input.runtime },
 			...input.flag === void 0 ? {} : { flag: flagGateOf(input.flag, `Element "${input.ref}"`) },
-			...input.anchor === void 0 ? {} : { anchor: input.anchor }
+			...input.anchor === void 0 ? {} : { anchor: input.anchor },
+			...isMotion(input.motion) ? { motion: input.motion } : {}
 		}
 	};
 	if (!new FlatMap({ flat: space.schema.flat }).addElement(el, anchorId, drop)) return false;

package/dist/modules/mcp/tools/operations/schemaIds.js

@@ -1,6 +1,6 @@
 import { actionAccess, actionField, actionLimits, actionNode, actionTriggerParams } from "./actions/document.js";
 import { connectorConnection, readEndpoint, writeEndpoint } from "./connectors/manifest.js";
-import { bindingInput, elementAnchor, elementFlag, elementInput, initialStateInput, interactionNode, position, ruleGroup, styleRefs, styleVariantInput } from "./schema/shared.js";
+import { bindingInput, elementAnchor, elementFlag, elementInput, elementMotion, initialStateInput, interactionNode, position, ruleGroup, styleRefs, styleVariantInput } from "./schema/shared.js";
 import { ancestors, ancestorsPatch, cssMap, cssPatchMap, definitionSlot, definitionSlotPatch, displayModeCss, displayModeCssPatch, themeValue } from "./style/shared.js";
 import { z } from "zod";
 //#region src/modules/mcp/tools/operations/schemaIds.ts
@@ -25,6 +25,7 @@ var SHARED_SCHEMAS = [
 	[elementInput, "Element"],
 	[elementFlag, "ElementFlag"],
 	[elementAnchor, "ElementAnchor"],
+	[elementMotion, "ElementMotion"],
 	[ruleGroup, "RuleGroup"],
 	[styleRefs, "StyleRefs"],
 	[initialStateInput, "InitialState"],

package/dist/modules/mcp/tools/preview.d.ts

@@ -52,6 +52,7 @@ export declare const previewShape: {
         }>>;
         flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         anchor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        motion: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"deleteElement">;
         pageRef: z.ZodString;

package/dist/modules/mcp/tools/render.d.ts

@@ -54,6 +54,7 @@ export declare const renderShape: {
         }>>;
         flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         anchor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        motion: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"deleteElement">;
         pageRef: z.ZodString;

package/dist/modules/mcp/tools/screenshot.d.ts

@@ -52,6 +52,7 @@ export declare const screenshotShape: {
         }>>;
         flag: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         anchor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        motion: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"deleteElement">;
         pageRef: z.ZodString;

package/dist/modules/mcp/tools/validate.d.ts

@@ -53,6 +53,7 @@ export declare const validateShape: {
         }>>;
         flag: import('zod').ZodOptional<import('zod').ZodNullable<import('zod').ZodString>>;
         anchor: import('zod').ZodOptional<import('zod').ZodNullable<import('zod').ZodString>>;
+        motion: import('zod').ZodOptional<import('zod').ZodNullable<import('zod').ZodRecord<import('zod').ZodString, import('zod').ZodUnknown>>>;
     }, import('zod/v4/core').$strip>, import('zod').ZodObject<{
         type: import('zod').ZodLiteral<"deleteElement">;
         pageRef: import('zod').ZodString;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plitzi/sdk-mcp",
-  "version": "0.38.1",
+  "version": "0.38.3",
   "license": "AGPL-3.0",
   "files": [
     "dist",
@@ -30,14 +30,14 @@
   "dependencies": {
     "@modelcontextprotocol/ext-apps": "^1.7.5",
     "@modelcontextprotocol/sdk": "^1.32.0",
-    "@plitzi/plitzi-sdk": "0.38.1",
-    "@plitzi/sdk-authoring": "0.38.1",
-    "@plitzi/sdk-elements": "0.38.1",
-    "@plitzi/sdk-interactions": "0.38.1",
-    "@plitzi/sdk-schema": "0.38.1",
-    "@plitzi/sdk-server": "0.38.1",
-    "@plitzi/sdk-shared": "0.38.1",
-    "@plitzi/sdk-style": "0.38.1",
+    "@plitzi/plitzi-sdk": "0.38.3",
+    "@plitzi/sdk-authoring": "0.38.3",
+    "@plitzi/sdk-elements": "0.38.3",
+    "@plitzi/sdk-interactions": "0.38.3",
+    "@plitzi/sdk-schema": "0.38.3",
+    "@plitzi/sdk-server": "0.38.3",
+    "@plitzi/sdk-shared": "0.38.3",
+    "@plitzi/sdk-style": "0.38.3",
     "ejs": "^6.0.1",
     "esbuild": "^0.28.2",
     "zod": "^4.6.5"