@cueframe/kernel 0.2.37 → 0.2.38

package/dist/_members/composition/validators/composition.d.ts

@@ -302,6 +302,20 @@ export declare const Transition: z.ZodObject<{
     duration: z.ZodNumber;
 }, z.core.$strip>;
 export type Transition = z.infer<typeof Transition>;
+/**
+ * Where a clip's CENTRE sits, as a FRACTION of the frame: 0.5,0.5 is the centre,
+ * 0,0 the top-left corner, 1,1 the bottom-right. The renderer turns this straight
+ * into CSS `left`/`top` percentages (`x * 100`), so a value authored in pixels is
+ * not slightly off — it is hundreds of frame-widths off-canvas and the clip draws
+ * NOTHING. CUE-39: a card animated to `position.x: 180` rendered as sixteen black
+ * stills, and the contract had never said what the unit was.
+ *
+ * Overshoot is legitimate — an entrance slides in from just outside the frame —
+ * so the bound is a whole frame either side. Past that it is a unit mistake, and
+ * the refusal says so, the way `fontSize` refuses px.
+ */
+export declare const POSITION_MIN = -1;
+export declare const POSITION_MAX = 2;
 export declare const Region: z.ZodObject<{
     x: z.ZodNumber;
     y: z.ZodNumber;
@@ -359,6 +373,8 @@ export declare const KeyframeChannel: z.ZodArray<z.ZodObject<{
 export type KeyframeChannel = z.infer<typeof KeyframeChannel>;
 export declare const ANIMATABLE_PARAMS: readonly ["opacity", "scale", "rotation", "position.x", "position.y", "volume"];
 export type AnimatableParam = (typeof ANIMATABLE_PARAMS)[number];
+/** The bound each channel's keyframe VALUES carry — one rule shared with the scalar field. */
+export declare const ANIMATABLE_VALUE: Record<AnimatableParam, z.ZodNumber>;
 export declare const TimelineClip: z.ZodObject<{
     id: z.ZodString;
     startTime: z.ZodNumber;

package/dist/authoring/build-tools.js

@@ -4,13 +4,13 @@ import {
   buildPlannerTools,
   buildToolsFromSchemas,
   extractProviderError
-} from "../chunk-6A6AYPWO.js";
-import "../chunk-HLW3P5ZP.js";
+} from "../chunk-S3HHEJMZ.js";
+import "../chunk-MJWRC7G7.js";
 import "../chunk-JOURGVOR.js";
 import "../chunk-7AZLFN26.js";
-import "../chunk-CMC6MLR3.js";
-import "../chunk-EGNTUGAM.js";
-import "../chunk-AYZPTH7L.js";
+import "../chunk-POTCIQTA.js";
+import "../chunk-AG7HKF2U.js";
+import "../chunk-ID5QY7V6.js";
 import "../chunk-WPZKOVYF.js";
 import "../chunk-B7J5UUUV.js";
 import "../chunk-KYRDKK2D.js";

package/dist/authoring/context.js

@@ -1,9 +1,9 @@
 import {
   buildDirectorContext
-} from "../chunk-6VTNIYSR.js";
-import "../chunk-CMC6MLR3.js";
-import "../chunk-EGNTUGAM.js";
-import "../chunk-AYZPTH7L.js";
+} from "../chunk-ZUJCWFS7.js";
+import "../chunk-POTCIQTA.js";
+import "../chunk-AG7HKF2U.js";
+import "../chunk-ID5QY7V6.js";
 import "../chunk-WPZKOVYF.js";
 import "../chunk-B7J5UUUV.js";
 import "../chunk-KYRDKK2D.js";

package/dist/authoring/tools.js

@@ -6,12 +6,12 @@ import {
   COMPOSE_ROLE_TOOLS,
   COMPOSE_ROLE_TOOL_NAMES,
   dispatchComposeRoleTool
-} from "../chunk-HLW3P5ZP.js";
+} from "../chunk-MJWRC7G7.js";
 import "../chunk-JOURGVOR.js";
 import "../chunk-7AZLFN26.js";
-import "../chunk-CMC6MLR3.js";
-import "../chunk-EGNTUGAM.js";
-import "../chunk-AYZPTH7L.js";
+import "../chunk-POTCIQTA.js";
+import "../chunk-AG7HKF2U.js";
+import "../chunk-ID5QY7V6.js";
 import "../chunk-WPZKOVYF.js";
 import "../chunk-B7J5UUUV.js";
 import "../chunk-KYRDKK2D.js";

package/dist/authoring.js

@@ -11,7 +11,7 @@ import {
   buildPlannerTools,
   buildToolsFromSchemas,
   extractProviderError
-} from "./chunk-6A6AYPWO.js";
+} from "./chunk-S3HHEJMZ.js";
 import {
   COMPOSE_MOTION_TOOLS,
   COMPOSE_MOTION_VERIFY_TOOLS,
@@ -20,14 +20,14 @@ import {
   COMPOSE_ROLE_TOOLS,
   COMPOSE_ROLE_TOOL_NAMES,
   dispatchComposeRoleTool
-} from "./chunk-HLW3P5ZP.js";
+} from "./chunk-MJWRC7G7.js";
 import {
   AgentFixableCaptureError,
   getExcludedTools
 } from "./chunk-JOURGVOR.js";
 import {
   buildDirectorContext
-} from "./chunk-6VTNIYSR.js";
+} from "./chunk-ZUJCWFS7.js";
 import {
   buildFastModel,
   buildModel,
@@ -55,9 +55,9 @@ import {
 import "./chunk-ILO4NEZ3.js";
 import "./chunk-7AZLFN26.js";
 import "./chunk-VG2ND6PX.js";
-import "./chunk-CMC6MLR3.js";
-import "./chunk-EGNTUGAM.js";
-import "./chunk-AYZPTH7L.js";
+import "./chunk-POTCIQTA.js";
+import "./chunk-AG7HKF2U.js";
+import "./chunk-ID5QY7V6.js";
 import "./chunk-WPZKOVYF.js";
 import "./chunk-B7J5UUUV.js";
 import "./chunk-KYRDKK2D.js";

package/dist/{chunk-EGNTUGAM.js → chunk-AG7HKF2U.js}

@@ -4,7 +4,7 @@ import {
   Format,
   GraphicRole,
   OpaqueId
-} from "./chunk-AYZPTH7L.js";
+} from "./chunk-ID5QY7V6.js";
 import {
   brandKitCaptionFaceIssues
 } from "./chunk-AVTEPAWI.js";

package/dist/{chunk-LL5GI3IS.js → chunk-BLDL2EKL.js}

@@ -2,7 +2,7 @@ import {
   querySchemaShape,
   serializeQuery,
   waitForJob
-} from "./chunk-ZBQQFAE7.js";
+} from "./chunk-JNOM4FW3.js";
 import {
   CURATED_TOOLS
 } from "./chunk-5YO4LAB7.js";
@@ -23,7 +23,7 @@ import {
   text,
   textWithData,
   withMedia
-} from "./chunk-F2HXB6RG.js";
+} from "./chunk-GA6NRDK3.js";
 
 // ../mcp/src/prompts.ts
 var skillListCache = null;

package/dist/{chunk-F2HXB6RG.js → chunk-GA6NRDK3.js}

@@ -1282,6 +1282,10 @@ var briefCreateRequestSeededGraphicsItemSourceThreeParallaxMax = 0.3;
 var briefCreateRequestSeededGraphicsItemOpacityMin = 0;
 var briefCreateRequestSeededGraphicsItemOpacityMax = 1;
 var briefCreateRequestSeededGraphicsItemScaleExclusiveMin = 0;
+var briefCreateRequestSeededGraphicsItemPositionXMin = -1;
+var briefCreateRequestSeededGraphicsItemPositionXMax = 2;
+var briefCreateRequestSeededGraphicsItemPositionYMin = -1;
+var briefCreateRequestSeededGraphicsItemPositionYMax = 2;
 var briefCreateRequestSeededGraphicsItemRegionXMin = 0;
 var briefCreateRequestSeededGraphicsItemRegionXMax = 1;
 var briefCreateRequestSeededGraphicsItemRegionYMin = 0;
@@ -1429,9 +1433,9 @@ var BriefCreateRequest = zod19.strictObject({
     "scale": zod19.number().gt(briefCreateRequestSeededGraphicsItemScaleExclusiveMin).optional(),
     "rotation": zod19.number().optional(),
     "position": zod19.strictObject({
-      "x": zod19.number(),
-      "y": zod19.number()
-    }).optional(),
+      "x": zod19.number().min(briefCreateRequestSeededGraphicsItemPositionXMin).max(briefCreateRequestSeededGraphicsItemPositionXMax),
+      "y": zod19.number().min(briefCreateRequestSeededGraphicsItemPositionYMin).max(briefCreateRequestSeededGraphicsItemPositionYMax)
+    }).optional().describe("Clip CENTRE as a fraction of the frame: {x:0.5,y:0.5} is dead centre, 0 to 1 is inside the frame, and a little overshoot (down to -1, up to 2) is how an entrance starts off-canvas. NOT pixels: the renderer maps x to `left: x*100%`, so `x: 180` sits 180 frame-widths away and draws nothing."),
     "region": zod19.strictObject({
       "x": zod19.number().min(briefCreateRequestSeededGraphicsItemRegionXMin).max(briefCreateRequestSeededGraphicsItemRegionXMax),
       "y": zod19.number().min(briefCreateRequestSeededGraphicsItemRegionYMin).max(briefCreateRequestSeededGraphicsItemRegionYMax),
@@ -1459,7 +1463,7 @@ var BriefCreateRequest = zod19.strictObject({
           zod19.number()
         ])
       })]).optional()
-    })).min(briefCreateRequestSeededGraphicsItemAnimateMinOne)).optional()
+    })).min(briefCreateRequestSeededGraphicsItemAnimateMinOne)).optional().describe("Keyframe channels, clip-relative seconds. Each channel's values use the SAME unit as the scalar it animates: `opacity` 0 to 1, `scale` a multiplier (>0), `rotation` degrees, `position.x`/`position.y` a FRACTION of the frame like `position` (0.5 = centre; NOT pixels), `volume` 0 to 4.")
   })).max(briefCreateRequestSeededGraphicsMax).optional().describe("Client-authored graphic clips the Director must carry VERBATIM: seeded into the design loop's base composition as LOCKED clips (never re-authored, never discarded)."),
   "exclusions": zod19.array(BriefExclusion).max(briefCreateRequestExclusionsMax).optional(),
   "gates": BriefGates.optional(),
@@ -1536,6 +1540,10 @@ var briefResponseSeededGraphicsItemSourceThreeParallaxMax = 0.3;
 var briefResponseSeededGraphicsItemOpacityMin = 0;
 var briefResponseSeededGraphicsItemOpacityMax = 1;
 var briefResponseSeededGraphicsItemScaleExclusiveMin = 0;
+var briefResponseSeededGraphicsItemPositionXMin = -1;
+var briefResponseSeededGraphicsItemPositionXMax = 2;
+var briefResponseSeededGraphicsItemPositionYMin = -1;
+var briefResponseSeededGraphicsItemPositionYMax = 2;
 var briefResponseSeededGraphicsItemRegionXMin = 0;
 var briefResponseSeededGraphicsItemRegionXMax = 1;
 var briefResponseSeededGraphicsItemRegionYMin = 0;
@@ -1686,9 +1694,9 @@ var BriefResponse = zod21.strictObject({
     "scale": zod21.number().gt(briefResponseSeededGraphicsItemScaleExclusiveMin).optional(),
     "rotation": zod21.number().optional(),
     "position": zod21.strictObject({
-      "x": zod21.number(),
-      "y": zod21.number()
-    }).optional(),
+      "x": zod21.number().min(briefResponseSeededGraphicsItemPositionXMin).max(briefResponseSeededGraphicsItemPositionXMax),
+      "y": zod21.number().min(briefResponseSeededGraphicsItemPositionYMin).max(briefResponseSeededGraphicsItemPositionYMax)
+    }).optional().describe("Clip CENTRE as a fraction of the frame: {x:0.5,y:0.5} is dead centre, 0 to 1 is inside the frame, and a little overshoot (down to -1, up to 2) is how an entrance starts off-canvas. NOT pixels: the renderer maps x to `left: x*100%`, so `x: 180` sits 180 frame-widths away and draws nothing."),
     "region": zod21.strictObject({
       "x": zod21.number().min(briefResponseSeededGraphicsItemRegionXMin).max(briefResponseSeededGraphicsItemRegionXMax),
       "y": zod21.number().min(briefResponseSeededGraphicsItemRegionYMin).max(briefResponseSeededGraphicsItemRegionYMax),
@@ -1716,7 +1724,7 @@ var BriefResponse = zod21.strictObject({
           zod21.number()
         ])
       })]).optional()
-    })).min(briefResponseSeededGraphicsItemAnimateMinOne)).optional()
+    })).min(briefResponseSeededGraphicsItemAnimateMinOne)).optional().describe("Keyframe channels, clip-relative seconds. Each channel's values use the SAME unit as the scalar it animates: `opacity` 0 to 1, `scale` a multiplier (>0), `rotation` degrees, `position.x`/`position.y` a FRACTION of the frame like `position` (0.5 = centre; NOT pixels), `volume` 0 to 4.")
   })).max(briefResponseSeededGraphicsMax).optional().describe("Client-authored graphic clips the Director must carry VERBATIM: seeded into the design loop's base composition as LOCKED clips (never re-authored, never discarded)."),
   "exclusions": zod21.array(BriefExclusion).max(briefResponseExclusionsMax).optional(),
   "gates": BriefGates.optional(),
@@ -1786,6 +1794,10 @@ var briefPatchRequestSeededGraphicsItemSourceThreeParallaxMax = 0.3;
 var briefPatchRequestSeededGraphicsItemOpacityMin = 0;
 var briefPatchRequestSeededGraphicsItemOpacityMax = 1;
 var briefPatchRequestSeededGraphicsItemScaleExclusiveMin = 0;
+var briefPatchRequestSeededGraphicsItemPositionXMin = -1;
+var briefPatchRequestSeededGraphicsItemPositionXMax = 2;
+var briefPatchRequestSeededGraphicsItemPositionYMin = -1;
+var briefPatchRequestSeededGraphicsItemPositionYMax = 2;
 var briefPatchRequestSeededGraphicsItemRegionXMin = 0;
 var briefPatchRequestSeededGraphicsItemRegionXMax = 1;
 var briefPatchRequestSeededGraphicsItemRegionYMin = 0;
@@ -1932,9 +1944,9 @@ var BriefPatchRequest = zod23.strictObject({
     "scale": zod23.number().gt(briefPatchRequestSeededGraphicsItemScaleExclusiveMin).optional(),
     "rotation": zod23.number().optional(),
     "position": zod23.strictObject({
-      "x": zod23.number(),
-      "y": zod23.number()
-    }).optional(),
+      "x": zod23.number().min(briefPatchRequestSeededGraphicsItemPositionXMin).max(briefPatchRequestSeededGraphicsItemPositionXMax),
+      "y": zod23.number().min(briefPatchRequestSeededGraphicsItemPositionYMin).max(briefPatchRequestSeededGraphicsItemPositionYMax)
+    }).optional().describe("Clip CENTRE as a fraction of the frame: {x:0.5,y:0.5} is dead centre, 0 to 1 is inside the frame, and a little overshoot (down to -1, up to 2) is how an entrance starts off-canvas. NOT pixels: the renderer maps x to `left: x*100%`, so `x: 180` sits 180 frame-widths away and draws nothing."),
     "region": zod23.strictObject({
       "x": zod23.number().min(briefPatchRequestSeededGraphicsItemRegionXMin).max(briefPatchRequestSeededGraphicsItemRegionXMax),
       "y": zod23.number().min(briefPatchRequestSeededGraphicsItemRegionYMin).max(briefPatchRequestSeededGraphicsItemRegionYMax),
@@ -1962,7 +1974,7 @@ var BriefPatchRequest = zod23.strictObject({
           zod23.number()
         ])
       })]).optional()
-    })).min(briefPatchRequestSeededGraphicsItemAnimateMinOne)).optional()
+    })).min(briefPatchRequestSeededGraphicsItemAnimateMinOne)).optional().describe("Keyframe channels, clip-relative seconds. Each channel's values use the SAME unit as the scalar it animates: `opacity` 0 to 1, `scale` a multiplier (>0), `rotation` degrees, `position.x`/`position.y` a FRACTION of the frame like `position` (0.5 = centre; NOT pixels), `volume` 0 to 4.")
   })).max(briefPatchRequestSeededGraphicsMax).optional().describe("Client-authored graphic clips the Director must carry VERBATIM: seeded into the design loop's base composition as LOCKED clips (never re-authored, never discarded)."),
   "exclusions": zod23.array(BriefExclusion).max(briefPatchRequestExclusionsMax).optional(),
   "gates": BriefGates.optional(),
@@ -2513,6 +2525,10 @@ var compositionTracksItemContentsItemOneSourceThreeParallaxMax = 0.3;
 var compositionTracksItemContentsItemOneOpacityMin = 0;
 var compositionTracksItemContentsItemOneOpacityMax = 1;
 var compositionTracksItemContentsItemOneScaleExclusiveMin = 0;
+var compositionTracksItemContentsItemOnePositionXMin = -1;
+var compositionTracksItemContentsItemOnePositionXMax = 2;
+var compositionTracksItemContentsItemOnePositionYMin = -1;
+var compositionTracksItemContentsItemOnePositionYMax = 2;
 var compositionTracksItemContentsItemOneRegionXMin = 0;
 var compositionTracksItemContentsItemOneRegionXMax = 1;
 var compositionTracksItemContentsItemOneRegionYMin = 0;
@@ -2678,9 +2694,9 @@ var Composition = zod57.strictObject({
       "scale": zod57.number().gt(compositionTracksItemContentsItemOneScaleExclusiveMin).optional(),
       "rotation": zod57.number().optional(),
       "position": zod57.strictObject({
-        "x": zod57.number(),
-        "y": zod57.number()
-      }).optional(),
+        "x": zod57.number().min(compositionTracksItemContentsItemOnePositionXMin).max(compositionTracksItemContentsItemOnePositionXMax),
+        "y": zod57.number().min(compositionTracksItemContentsItemOnePositionYMin).max(compositionTracksItemContentsItemOnePositionYMax)
+      }).optional().describe("Clip CENTRE as a fraction of the frame: {x:0.5,y:0.5} is dead centre, 0 to 1 is inside the frame, and a little overshoot (down to -1, up to 2) is how an entrance starts off-canvas. NOT pixels: the renderer maps x to `left: x*100%`, so `x: 180` sits 180 frame-widths away and draws nothing."),
       "region": zod57.strictObject({
         "x": zod57.number().min(compositionTracksItemContentsItemOneRegionXMin).max(compositionTracksItemContentsItemOneRegionXMax),
         "y": zod57.number().min(compositionTracksItemContentsItemOneRegionYMin).max(compositionTracksItemContentsItemOneRegionYMax),
@@ -2708,7 +2724,7 @@ var Composition = zod57.strictObject({
             zod57.number()
           ])
         })]).optional()
-      })).min(compositionTracksItemContentsItemOneAnimateMinOne)).optional()
+      })).min(compositionTracksItemContentsItemOneAnimateMinOne)).optional().describe("Keyframe channels, clip-relative seconds. Each channel's values use the SAME unit as the scalar it animates: `opacity` 0 to 1, `scale` a multiplier (>0), `rotation` degrees, `position.x`/`position.y` a FRACTION of the frame like `position` (0.5 = centre; NOT pixels), `volume` 0 to 4.")
     }), zod57.strictObject({
       "id": zod57.string().min(1),
       "startTime": zod57.number().min(compositionTracksItemContentsItemTwoStartTimeMin).describe("Timeline start (seconds)."),
@@ -5881,6 +5897,10 @@ var compositionOpThreeClipSourceThreeParallaxMax = 0.3;
 var compositionOpThreeClipOpacityMin = 0;
 var compositionOpThreeClipOpacityMax = 1;
 var compositionOpThreeClipScaleExclusiveMin = 0;
+var compositionOpThreeClipPositionXMin = -1;
+var compositionOpThreeClipPositionXMax = 2;
+var compositionOpThreeClipPositionYMin = -1;
+var compositionOpThreeClipPositionYMax = 2;
 var compositionOpThreeClipRegionXMin = 0;
 var compositionOpThreeClipRegionXMax = 1;
 var compositionOpThreeClipRegionYMin = 0;
@@ -5929,6 +5949,10 @@ var compositionOpFivePatchSourceThreeParallaxMax = 0.3;
 var compositionOpFivePatchOpacityMin = 0;
 var compositionOpFivePatchOpacityMax = 1;
 var compositionOpFivePatchScaleExclusiveMin = 0;
+var compositionOpFivePatchPositionXMin = -1;
+var compositionOpFivePatchPositionXMax = 2;
+var compositionOpFivePatchPositionYMin = -1;
+var compositionOpFivePatchPositionYMax = 2;
 var compositionOpFivePatchRegionXMin = 0;
 var compositionOpFivePatchRegionXMax = 1;
 var compositionOpFivePatchRegionYMin = 0;
@@ -5977,6 +6001,10 @@ var compositionOpSevenClipsItemSourceThreeParallaxMax = 0.3;
 var compositionOpSevenClipsItemOpacityMin = 0;
 var compositionOpSevenClipsItemOpacityMax = 1;
 var compositionOpSevenClipsItemScaleExclusiveMin = 0;
+var compositionOpSevenClipsItemPositionXMin = -1;
+var compositionOpSevenClipsItemPositionXMax = 2;
+var compositionOpSevenClipsItemPositionYMin = -1;
+var compositionOpSevenClipsItemPositionYMax = 2;
 var compositionOpSevenClipsItemRegionXMin = 0;
 var compositionOpSevenClipsItemRegionXMax = 1;
 var compositionOpSevenClipsItemRegionYMin = 0;
@@ -6165,9 +6193,9 @@ var CompositionOp = zod66.union([zod66.strictObject({
     "scale": zod66.number().gt(compositionOpThreeClipScaleExclusiveMin).optional(),
     "rotation": zod66.number().optional(),
     "position": zod66.strictObject({
-      "x": zod66.number(),
-      "y": zod66.number()
-    }).optional(),
+      "x": zod66.number().min(compositionOpThreeClipPositionXMin).max(compositionOpThreeClipPositionXMax),
+      "y": zod66.number().min(compositionOpThreeClipPositionYMin).max(compositionOpThreeClipPositionYMax)
+    }).optional().describe("Clip CENTRE as a fraction of the frame: {x:0.5,y:0.5} is dead centre, 0 to 1 is inside the frame, and a little overshoot (down to -1, up to 2) is how an entrance starts off-canvas. NOT pixels: the renderer maps x to `left: x*100%`, so `x: 180` sits 180 frame-widths away and draws nothing."),
     "region": zod66.strictObject({
       "x": zod66.number().min(compositionOpThreeClipRegionXMin).max(compositionOpThreeClipRegionXMax),
       "y": zod66.number().min(compositionOpThreeClipRegionYMin).max(compositionOpThreeClipRegionYMax),
@@ -6195,7 +6223,7 @@ var CompositionOp = zod66.union([zod66.strictObject({
           zod66.number()
         ])
       })]).optional()
-    })).min(compositionOpThreeClipAnimateMinOne)).optional()
+    })).min(compositionOpThreeClipAnimateMinOne)).optional().describe("Keyframe channels, clip-relative seconds. Each channel's values use the SAME unit as the scalar it animates: `opacity` 0 to 1, `scale` a multiplier (>0), `rotation` degrees, `position.x`/`position.y` a FRACTION of the frame like `position` (0.5 = centre; NOT pixels), `volume` 0 to 4.")
   }),
   "trackId": zod66.string().optional(),
   "newTrack": zod66.boolean().optional(),
@@ -6314,9 +6342,9 @@ var CompositionOp = zod66.union([zod66.strictObject({
     "scale": zod66.number().gt(compositionOpFivePatchScaleExclusiveMin).optional(),
     "rotation": zod66.number().optional(),
     "position": zod66.strictObject({
-      "x": zod66.number(),
-      "y": zod66.number()
-    }).optional(),
+      "x": zod66.number().min(compositionOpFivePatchPositionXMin).max(compositionOpFivePatchPositionXMax),
+      "y": zod66.number().min(compositionOpFivePatchPositionYMin).max(compositionOpFivePatchPositionYMax)
+    }).optional().describe("Clip CENTRE as a fraction of the frame: {x:0.5,y:0.5} is dead centre, 0 to 1 is inside the frame, and a little overshoot (down to -1, up to 2) is how an entrance starts off-canvas. NOT pixels: the renderer maps x to `left: x*100%`, so `x: 180` sits 180 frame-widths away and draws nothing."),
     "region": zod66.strictObject({
       "x": zod66.number().min(compositionOpFivePatchRegionXMin).max(compositionOpFivePatchRegionXMax),
       "y": zod66.number().min(compositionOpFivePatchRegionYMin).max(compositionOpFivePatchRegionYMax),
@@ -6344,7 +6372,7 @@ var CompositionOp = zod66.union([zod66.strictObject({
           zod66.number()
         ])
       })]).optional()
-    })).min(compositionOpFivePatchAnimateMinOne)).optional()
+    })).min(compositionOpFivePatchAnimateMinOne)).optional().describe("Keyframe channels, clip-relative seconds. Each channel's values use the SAME unit as the scalar it animates: `opacity` 0 to 1, `scale` a multiplier (>0), `rotation` degrees, `position.x`/`position.y` a FRACTION of the frame like `position` (0.5 = centre; NOT pixels), `volume` 0 to 4.")
   })
 }).describe("Patch an existing clip by id (cross-family). The patch is a partial TimelineClip. NOTE: `source` is REPLACED wholesale \u2014 the patch merges at the top level only, so a partial `source` WIPES the source fields you omit. Patch the whole source object when changing it. (To change reframe/excluded ranges, prefer setCropIntents / addExcludedRange, not a source patch.)"), zod66.strictObject({
   "type": zod66.literal("removeClipsByMediaId"),
@@ -6459,9 +6487,9 @@ var CompositionOp = zod66.union([zod66.strictObject({
     "scale": zod66.number().gt(compositionOpSevenClipsItemScaleExclusiveMin).optional(),
     "rotation": zod66.number().optional(),
     "position": zod66.strictObject({
-      "x": zod66.number(),
-      "y": zod66.number()
-    }).optional(),
+      "x": zod66.number().min(compositionOpSevenClipsItemPositionXMin).max(compositionOpSevenClipsItemPositionXMax),
+      "y": zod66.number().min(compositionOpSevenClipsItemPositionYMin).max(compositionOpSevenClipsItemPositionYMax)
+    }).optional().describe("Clip CENTRE as a fraction of the frame: {x:0.5,y:0.5} is dead centre, 0 to 1 is inside the frame, and a little overshoot (down to -1, up to 2) is how an entrance starts off-canvas. NOT pixels: the renderer maps x to `left: x*100%`, so `x: 180` sits 180 frame-widths away and draws nothing."),
     "region": zod66.strictObject({
       "x": zod66.number().min(compositionOpSevenClipsItemRegionXMin).max(compositionOpSevenClipsItemRegionXMax),
       "y": zod66.number().min(compositionOpSevenClipsItemRegionYMin).max(compositionOpSevenClipsItemRegionYMax),
@@ -6489,7 +6517,7 @@ var CompositionOp = zod66.union([zod66.strictObject({
           zod66.number()
         ])
       })]).optional()
-    })).min(compositionOpSevenClipsItemAnimateMinOne)).optional()
+    })).min(compositionOpSevenClipsItemAnimateMinOne)).optional().describe("Keyframe channels, clip-relative seconds. Each channel's values use the SAME unit as the scalar it animates: `opacity` 0 to 1, `scale` a multiplier (>0), `rotation` degrees, `position.x`/`position.y` a FRACTION of the frame like `position` (0.5 = centre; NOT pixels), `volume` 0 to 4.")
   }))
 }).describe("Replace the overlay channel wholesale with the given clips (bulk set, not a merge)."), zod66.strictObject({
   "type": zod66.literal("addMarker"),

package/dist/{chunk-AYZPTH7L.js → chunk-ID5QY7V6.js}

@@ -106,10 +106,13 @@ var Transition = z2.object({
   type: z2.string().min(1),
   duration: z2.number().positive()
 });
-var Position = z2.object({
-  x: z2.number(),
-  y: z2.number()
-});
+var POSITION_MIN = -1;
+var POSITION_MAX = 2;
+var positionUnit = (axis) => `position.${axis} is a FRACTION of the frame (0.5 = centre, 0 to 1 inside it, ${POSITION_MIN} to ${POSITION_MAX} with entrance/exit overshoot) \u2014 px values are not accepted`;
+var PositionAxis = (axis) => z2.number().min(POSITION_MIN, positionUnit(axis)).max(POSITION_MAX, positionUnit(axis));
+var Position = z2.object({ x: PositionAxis("x"), y: PositionAxis("y") }).describe(
+  "Clip CENTRE as a fraction of the frame: {x:0.5,y:0.5} is dead centre, 0 to 1 is inside the frame, and a little overshoot (down to -1, up to 2) is how an entrance starts off-canvas. NOT pixels: the renderer maps x to `left: x*100%`, so `x: 180` sits 180 frame-widths away and draws nothing."
+);
 var Region = z2.object({
   x: z2.number().min(0).max(1),
   y: z2.number().min(0).max(1),
@@ -139,6 +142,14 @@ var ANIMATABLE_PARAMS = [
   "position.y",
   "volume"
 ];
+var ANIMATABLE_VALUE = {
+  opacity: z2.number().min(0, "opacity is 0 to 1").max(1, "opacity is 0 to 1"),
+  scale: z2.number().positive("scale is a multiplier and must be > 0"),
+  rotation: z2.number(),
+  "position.x": PositionAxis("x"),
+  "position.y": PositionAxis("y"),
+  volume: z2.number().min(0, "volume is 0 to 4").max(4, "volume is 0 to 4")
+};
 var TimelineClip = z2.object({
   id: z2.string().min(1),
   startTime: z2.number().nonnegative(),
@@ -155,16 +166,30 @@ var TimelineClip = z2.object({
   transitionIn: Transition.optional(),
   linkGroupId: z2.string().min(1).optional(),
   animate: z2.record(z2.string(), KeyframeChannel).superRefine((channels, ctx) => {
-    for (const key of Object.keys(channels)) {
+    for (const [key, channel] of Object.entries(channels)) {
       if (!ANIMATABLE_PARAMS.includes(key)) {
         ctx.addIssue({
           code: z2.ZodIssueCode.custom,
           path: [key],
           message: `"${key}" is not an animatable param (${ANIMATABLE_PARAMS.join(", ")})`
         });
+        continue;
       }
+      const bound = ANIMATABLE_VALUE[key];
+      channel.forEach((kf, i) => {
+        const res = bound.safeParse(kf.value);
+        if (!res.success) {
+          ctx.addIssue({
+            code: z2.ZodIssueCode.custom,
+            path: [key, i, "value"],
+            message: res.error.issues[0]?.message ?? `invalid ${key} keyframe value`
+          });
+        }
+      });
     }
-  }).optional()
+  }).describe(
+    "Keyframe channels, clip-relative seconds. Each channel's values use the SAME unit as the scalar it animates: `opacity` 0 to 1, `scale` a multiplier (>0), `rotation` degrees, `position.x`/`position.y` a FRACTION of the frame like `position` (0.5 = centre; NOT pixels), `volume` 0 to 4."
+  ).optional()
 }).strict();
 var Gap = z2.object({
   id: z2.string().min(1),
@@ -465,6 +490,8 @@ export {
   CompositionClipSource,
   ClipSource,
   Transition,
+  POSITION_MIN,
+  POSITION_MAX,
   Region,
   ClipFit,
   PerClipEffect,
@@ -472,6 +499,7 @@ export {
   Keyframe,
   KeyframeChannel,
   ANIMATABLE_PARAMS,
+  ANIMATABLE_VALUE,
   TimelineClip,
   Gap,
   TrackContent,

package/dist/{chunk-ZBQQFAE7.js → chunk-JNOM4FW3.js}

@@ -5,7 +5,7 @@ import {
   isOk,
   opById,
   safeParse
-} from "./chunk-F2HXB6RG.js";
+} from "./chunk-GA6NRDK3.js";
 
 // ../mcp/src/wait.ts
 var defaultSleep = (ms) => new Promise((r) => setTimeout(r, ms));

package/dist/{chunk-HLW3P5ZP.js → chunk-MJWRC7G7.js}

@@ -7,13 +7,13 @@ import {
 } from "./chunk-7AZLFN26.js";
 import {
   selectAllOverlays
-} from "./chunk-CMC6MLR3.js";
+} from "./chunk-POTCIQTA.js";
 import {
   ComposePlan
-} from "./chunk-EGNTUGAM.js";
+} from "./chunk-AG7HKF2U.js";
 import {
   OverlayClipSource
-} from "./chunk-AYZPTH7L.js";
+} from "./chunk-ID5QY7V6.js";
 
 // ../authoring/src/tools/toolSets.ts
 var COMPOSE_PLANNER_TOOLS = [
@@ -63,7 +63,7 @@ var COMPOSE_ROLE_TOOLS = Object.freeze({
     schema: z.object({}),
     metadata: { label: "Get Context" },
     handler: async (_args, capabilities) => {
-      const { buildDirectorContext } = await import("./context-43UC63RY.js");
+      const { buildDirectorContext } = await import("./context-KNFL62QR.js");
       return buildDirectorContext(capabilities);
     }
   },

package/dist/{chunk-CMC6MLR3.js → chunk-POTCIQTA.js}

@@ -1,6 +1,6 @@
 import {
   Composition
-} from "./chunk-AYZPTH7L.js";
+} from "./chunk-ID5QY7V6.js";
 import {
   expandToLinkGroup
 } from "./chunk-KYRDKK2D.js";

package/dist/{chunk-6A6AYPWO.js → chunk-S3HHEJMZ.js}

@@ -2,7 +2,7 @@ import {
   COMPOSE_PLANNER_TOOLS,
   COMPOSE_ROLE_TOOLS,
   dispatchComposeRoleTool
-} from "./chunk-HLW3P5ZP.js";
+} from "./chunk-MJWRC7G7.js";
 
 // ../authoring/src/agent/buildTools.ts
 import { tool } from "ai";

package/dist/{chunk-6VTNIYSR.js → chunk-ZUJCWFS7.js}

@@ -2,7 +2,7 @@ import {
   selectAllClips,
   selectAllOverlays,
   selectSceneMarkers
-} from "./chunk-CMC6MLR3.js";
+} from "./chunk-POTCIQTA.js";
 
 // ../authoring/src/context/transcript.ts
 var MAX_TRANSCRIPT_CHARS = 6e4;

package/dist/compose.js

@@ -5,39 +5,39 @@ import {
 } from "./chunk-QDBVYZSF.js";
 import "./chunk-JQMPHKLU.js";
 import "./chunk-ZZRBKGDA.js";
+import {
+  catalog as catalog4
+} from "./chunk-JRJQECCF.js";
+import {
+  catalog as catalog7
+} from "./chunk-TE3PNQG6.js";
+import {
+  catalog
+} from "./chunk-RBWS5XHE.js";
+import "./chunk-DLF4WVSE.js";
+import "./chunk-U4V4FZGE.js";
 import {
   catalog as catalog3
 } from "./chunk-FVDFPJHT.js";
+import "./chunk-QGAWDLYX.js";
 import {
   catalog as catalog6
 } from "./chunk-VLJOIUHL.js";
+import "./chunk-S5H6GH6M.js";
+import "./chunk-QAGGJHAF.js";
+import {
+  catalog as catalog5
+} from "./chunk-RAXHCRVV.js";
 import {
   catalog as catalog2
 } from "./chunk-WAUVKF2F.js";
+import "./chunk-MFHXCHRI.js";
 import {
   catalog as catalog8
 } from "./chunk-RL5SO653.js";
-import {
-  catalog as catalog4
-} from "./chunk-JRJQECCF.js";
-import {
-  catalog as catalog7
-} from "./chunk-TE3PNQG6.js";
-import "./chunk-QGAWDLYX.js";
-import "./chunk-S5H6GH6M.js";
-import "./chunk-QAGGJHAF.js";
-import "./chunk-MFHXCHRI.js";
-import {
-  catalog
-} from "./chunk-RBWS5XHE.js";
-import "./chunk-DLF4WVSE.js";
-import "./chunk-U4V4FZGE.js";
 import "./chunk-LT4PWSR2.js";
 import "./chunk-FWSJLHSV.js";
 import "./chunk-ZFEXATWN.js";
-import {
-  catalog as catalog5
-} from "./chunk-RAXHCRVV.js";
 import "./chunk-XHGZ2E77.js";
 import "./chunk-W2245F6G.js";
 import "./chunk-JBWSK2YD.js";

package/dist/composition/graphics-plan.js

@@ -26,7 +26,7 @@ import {
   PlanRect,
   StyleRole,
   ZPlane
-} from "../chunk-AYZPTH7L.js";
+} from "../chunk-ID5QY7V6.js";
 import "../chunk-WPZKOVYF.js";
 import "../chunk-B7J5UUUV.js";
 import "../chunk-WREYUH2E.js";

package/dist/composition/ops.js

@@ -20,9 +20,9 @@ import {
   selectMediaClipAt,
   selectSceneMarkers,
   selectTracksByKind
-} from "../chunk-CMC6MLR3.js";
-import "../chunk-EGNTUGAM.js";
-import "../chunk-AYZPTH7L.js";
+} from "../chunk-POTCIQTA.js";
+import "../chunk-AG7HKF2U.js";
+import "../chunk-ID5QY7V6.js";
 import "../chunk-WPZKOVYF.js";
 import "../chunk-B7J5UUUV.js";
 import "../chunk-KYRDKK2D.js";

package/dist/composition/validators.js

@@ -48,9 +48,10 @@ import {
   WebhookDeliveryStatus,
   WebhookDestination,
   YoutubeDestination
-} from "../chunk-EGNTUGAM.js";
+} from "../chunk-AG7HKF2U.js";
 import {
   ANIMATABLE_PARAMS,
+  ANIMATABLE_VALUE,
   AlphaLayerClipSource,
   CaptionSegment,
   CaptionStyle,
@@ -74,6 +75,8 @@ import {
   MediaClipSource,
   OpaqueId,
   OverlayClipSource,
+  POSITION_MAX,
+  POSITION_MIN,
   PerClipEffect,
   Region,
   TimelineClip,
@@ -82,7 +85,7 @@ import {
   Transition,
   captionWords,
   captionsAreBehindSubject
-} from "../chunk-AYZPTH7L.js";
+} from "../chunk-ID5QY7V6.js";
 import {
   AUTHORED_GRAPHIC_KINDS
 } from "../chunk-WPZKOVYF.js";
@@ -97,6 +100,7 @@ import "../chunk-AVTEPAWI.js";
 import "../chunk-2ESYSVXG.js";
 export {
   ANIMATABLE_PARAMS,
+  ANIMATABLE_VALUE,
   AUTHORED_GRAPHIC_KINDS,
   AlphaLayerClipSource,
   AudioPaletteRef,
@@ -136,6 +140,8 @@ export {
   MuxDestination,
   OpaqueId,
   OverlayClipSource,
+  POSITION_MAX,
+  POSITION_MIN,
   PerClipEffect,
   PlanAssetRequest,
   PlanCut,

package/dist/composition-ops.js

@@ -11,8 +11,8 @@ import {
   findClipById,
   findMarkerById,
   findTrackContainingClipId
-} from "./chunk-CMC6MLR3.js";
-import "./chunk-EGNTUGAM.js";
+} from "./chunk-POTCIQTA.js";
+import "./chunk-AG7HKF2U.js";
 import {
   CaptionSegment,
   CaptionStyle,
@@ -23,7 +23,7 @@ import {
   TimelineClip,
   Track,
   Transition
-} from "./chunk-AYZPTH7L.js";
+} from "./chunk-ID5QY7V6.js";
 import "./chunk-WPZKOVYF.js";
 import {
   ReframeSegment

package/dist/composition.js

@@ -149,9 +149,10 @@ import {
   WebhookDeliveryStatus,
   WebhookDestination,
   YoutubeDestination
-} from "./chunk-EGNTUGAM.js";
+} from "./chunk-AG7HKF2U.js";
 import {
   ANIMATABLE_PARAMS,
+  ANIMATABLE_VALUE,
   AlphaLayerClipSource,
   CaptionSegment,
   CaptionStyle,
@@ -175,6 +176,8 @@ import {
   MediaClipSource,
   OpaqueId,
   OverlayClipSource,
+  POSITION_MAX,
+  POSITION_MIN,
   PerClipEffect,
   Region,
   TimelineClip,
@@ -183,7 +186,7 @@ import {
   Transition,
   captionWords,
   captionsAreBehindSubject
-} from "./chunk-AYZPTH7L.js";
+} from "./chunk-ID5QY7V6.js";
 import {
   AUTHORED_GRAPHIC_KINDS
 } from "./chunk-WPZKOVYF.js";
@@ -286,6 +289,7 @@ function deriveReframedComposition(source, targetFormat, perceptionByClipId) {
 }
 export {
   ANIMATABLE_PARAMS,
+  ANIMATABLE_VALUE,
   AUTHORED_GRAPHIC_KINDS,
   AlphaLayerClipSource,
   AudioPaletteRef,
@@ -344,6 +348,8 @@ export {
   MuxDestination,
   OpaqueId,
   OverlayClipSource,
+  POSITION_MAX,
+  POSITION_MIN,
   PerClipEffect,
   PlanAssetRequest,
   PlanCut,

package/dist/{context-43UC63RY.js → context-KNFL62QR.js}

@@ -1,9 +1,9 @@
 import {
   buildDirectorContext
-} from "./chunk-6VTNIYSR.js";
-import "./chunk-CMC6MLR3.js";
-import "./chunk-EGNTUGAM.js";
-import "./chunk-AYZPTH7L.js";
+} from "./chunk-ZUJCWFS7.js";
+import "./chunk-POTCIQTA.js";
+import "./chunk-AG7HKF2U.js";
+import "./chunk-ID5QY7V6.js";
 import "./chunk-WPZKOVYF.js";
 import "./chunk-B7J5UUUV.js";
 import "./chunk-KYRDKK2D.js";

package/dist/mcp/adapter.js

@@ -2,7 +2,7 @@ import {
   querySchemaShape,
   serializeQuery,
   waitForJob
-} from "../chunk-ZBQQFAE7.js";
+} from "../chunk-JNOM4FW3.js";
 import {
   CURATED_TOOLS
 } from "../chunk-5YO4LAB7.js";
@@ -16,7 +16,7 @@ import {
   opById,
   safeParse,
   sniffImageMediaType
-} from "../chunk-F2HXB6RG.js";
+} from "../chunk-GA6NRDK3.js";
 import "../chunk-2ESYSVXG.js";
 
 // ../mcp/src/adapter.ts

package/dist/mcp/core.js

@@ -18,7 +18,7 @@ import {
   text,
   textWithData,
   withMedia
-} from "../chunk-F2HXB6RG.js";
+} from "../chunk-GA6NRDK3.js";
 import "../chunk-2ESYSVXG.js";
 export {
   __resetPreviewCache,

package/dist/mcp/server.js

@@ -7,10 +7,10 @@ import {
   registerRawTools,
   registerSkillPrompts,
   titleCase
-} from "../chunk-LL5GI3IS.js";
-import "../chunk-ZBQQFAE7.js";
+} from "../chunk-BLDL2EKL.js";
+import "../chunk-JNOM4FW3.js";
 import "../chunk-5YO4LAB7.js";
-import "../chunk-F2HXB6RG.js";
+import "../chunk-GA6NRDK3.js";
 import "../chunk-2ESYSVXG.js";
 export {
   RAW_EXCLUDED_OPERATION_IDS,

package/dist/mcp.js

@@ -7,10 +7,10 @@ import {
   buildServer,
   registerCuratedTools,
   registerRawTools
-} from "./chunk-LL5GI3IS.js";
-import "./chunk-ZBQQFAE7.js";
+} from "./chunk-BLDL2EKL.js";
+import "./chunk-JNOM4FW3.js";
 import "./chunk-5YO4LAB7.js";
-import "./chunk-F2HXB6RG.js";
+import "./chunk-GA6NRDK3.js";
 import "./chunk-2ESYSVXG.js";
 export {
   API_URLS,

package/dist/primitives.js

@@ -1,36 +1,36 @@
+import {
+  catalog as catalog4
+} from "./chunk-JRJQECCF.js";
+import {
+  catalog as catalog7
+} from "./chunk-TE3PNQG6.js";
+import {
+  catalog
+} from "./chunk-RBWS5XHE.js";
+import "./chunk-DLF4WVSE.js";
+import "./chunk-U4V4FZGE.js";
 import {
   catalog as catalog3
 } from "./chunk-FVDFPJHT.js";
+import "./chunk-QGAWDLYX.js";
 import {
   catalog as catalog6
 } from "./chunk-VLJOIUHL.js";
+import "./chunk-S5H6GH6M.js";
+import "./chunk-QAGGJHAF.js";
+import {
+  catalog as catalog5
+} from "./chunk-RAXHCRVV.js";
 import {
   catalog as catalog2
 } from "./chunk-WAUVKF2F.js";
+import "./chunk-MFHXCHRI.js";
 import {
   catalog as catalog8
 } from "./chunk-RL5SO653.js";
-import {
-  catalog as catalog4
-} from "./chunk-JRJQECCF.js";
-import {
-  catalog as catalog7
-} from "./chunk-TE3PNQG6.js";
-import "./chunk-QGAWDLYX.js";
-import "./chunk-S5H6GH6M.js";
-import "./chunk-QAGGJHAF.js";
-import "./chunk-MFHXCHRI.js";
-import {
-  catalog
-} from "./chunk-RBWS5XHE.js";
-import "./chunk-DLF4WVSE.js";
-import "./chunk-U4V4FZGE.js";
 import "./chunk-LT4PWSR2.js";
 import "./chunk-FWSJLHSV.js";
 import "./chunk-ZFEXATWN.js";
-import {
-  catalog as catalog5
-} from "./chunk-RAXHCRVV.js";
 import "./chunk-XHGZ2E77.js";
 import "./chunk-W2245F6G.js";
 import "./chunk-JBWSK2YD.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cueframe/kernel",
-  "version": "0.2.37",
+  "version": "0.2.38",
   "type": "module",
   "description": "Publish-only aggregate of CueFrame's isomorphic kernel packages — composition, primitives, authoring, MCP, and friends shipped as one npm artifact. Members remain separate workspace packages; this only changes what ships.",
   "files": [
@@ -16,26 +16,26 @@
   "devDependencies": {
     "tsup": "^8.3.5",
     "typescript": "^5.9.3",
-    "@cueframe/account-model": "0.1.0",
     "@cueframe/authoring": "0.1.0",
-    "@cueframe/compose": "0.1.0",
-    "@cueframe/composition-ops": "0.1.0",
     "@cueframe/animate": "0.1.0",
     "@cueframe/brand-derivation": "0.1.0",
-    "@cueframe/composition": "0.1.0",
     "@cueframe/cloud-import": "0.1.0",
-    "@cueframe/core": "0.1.0",
+    "@cueframe/account-model": "0.1.0",
+    "@cueframe/compose": "0.1.0",
+    "@cueframe/composition": "0.1.0",
     "@cueframe/component-runtime": "0.1.0",
+    "@cueframe/core": "0.1.0",
+    "@cueframe/errors": "0.1.0",
+    "@cueframe/composition-ops": "0.1.0",
     "@cueframe/foundation": "0.1.0",
-    "@cueframe/director": "0.1.0",
-    "@cueframe/mcp": "0.1.0",
     "@cueframe/nle-export": "0.1.0",
     "@cueframe/perception": "0.1.0",
+    "@cueframe/render-harness": "0.1.0",
+    "@cueframe/mcp": "0.1.0",
     "@cueframe/plane": "0.1.0",
-    "@cueframe/primitives": "0.1.0",
+    "@cueframe/director": "0.1.0",
     "@cueframe/media-model": "0.1.0",
-    "@cueframe/render-harness": "0.1.0",
-    "@cueframe/errors": "0.1.0"
+    "@cueframe/primitives": "0.1.0"
   },
   "peerDependencies": {
     "gsap": "3.13.0",