@cueframe/kernel 0.1.0 → 0.1.2

package/dist/{chunk-OLFOPQCA.js → chunk-UQSOS726.js}

@@ -12,15 +12,15 @@ import {
   FLOOR_TEXT,
   resolveContrast
 } from "./chunk-EMGFZ3PR.js";
+import {
+  FitText,
+  resolveFitFontSize
+} from "./chunk-XHGZ2E77.js";
 import {
   resolveEasing,
   staggerRise,
   staggerUp
 } from "./chunk-ZFEXATWN.js";
-import {
-  FitText,
-  resolveFitFontSize
-} from "./chunk-AYVJXDLB.js";
 import {
   ACCENT,
   ACCENT_STRONG,
@@ -462,7 +462,6 @@ var KineticType = ({
       {
         style: {
           opacity: fadeOut,
-          // Idle life: the settled phrase breathes imperceptibly.
           transform: `scale(${1 + Math.sin(2 * Math.PI * 0.06 * frame / fps) * 8e-3})`
         }
       },
@@ -2041,15 +2040,6 @@ var config2 = {
 // ../execution/primitives/src/text/inline-highlight/config.ts
 import { z as z3 } from "zod";
 var paramsSchema3 = z3.object({
-  // `before` was required; relaxed to optional with empty default so a
-  // degenerate "single highlighted word, no preceding context" pick is
-  // valid. The renderer treats empty `before` as no-op text. Agent
-  // picks where the highlighted word is the entire phrase (a common
-  // editorial choice on short hooks) no longer crash the render with
-  // `inline-highlight: invalid params — before: Required`. See Block 2
-  // (editorial intelligence) for the upstream fix: validate agent tool
-  // calls against the registry's paramsSchema before accepting them,
-  // so the agent self-corrects instead of relying on schema relaxation.
   before: z3.string().default("").describe('Text leading up to the highlighted word, including trailing space if any. Empty string is valid for "single word" picks.'),
   highlight: z3.string().min(1).describe("The single word or phrase to emphasize."),
   after: z3.string().default("").describe("Text after the highlight, including leading space if any."),
@@ -2425,7 +2415,6 @@ import { z as z9 } from "zod";
 var paramsSchema9 = z9.object({
   text: z9.string().min(1).describe("Text to split into words and reveal one at a time."),
   staggerDelay: z9.number().min(0.5).max(20).default(3).describe("Frames between each word's entrance. Lower = faster cascade."),
-  // coerce: a $brand:motion.staggerMs MISS (no kit) falls back to the string '90'; coercion keeps it a number.
   staggerMs: z9.coerce.number().nonnegative().optional().describe("Per-word stagger gap in ms (overrides staggerDelay). Bind to $brand:motion.staggerMs."),
   easing: z9.string().optional().describe("Easing keyword for each word's fade/rise (linear/ease/ease-in/ease-out/ease-in-out). Bind to $brand:motion.easing."),
   distance: z9.number().min(0).max(200).default(40).describe("Pixels each word travels upward as it fades in. 30\u201360 is the sweet spot."),
@@ -2746,9 +2735,6 @@ var config13 = {
   subtextParam: null,
   tokens: [
     { propPath: "color", cssVar: "--cf-accent", fallback: SUCCESS, brandKitPath: "colors.accent" }
-    // No fontFamily brand binding: the decode effect requires fixed-width mono
-    // (Space Mono floor). There is no fonts.mono brand path, and binding to
-    // fonts.heading would let a serif/display brand face break the column shuffle.
   ],
   durationInFrames: 120,
   fps: 30,

package/dist/{chunk-GBRNYH7W.js → chunk-V24L35GM.js}

@@ -1,10 +1,7 @@
 // ../execution/render-harness/src/sandboxGlobalSpecs.ts
 var GLOBALS_MODULE = "@@sandbox-globals@@";
 var SANDBOX_GLOBAL_SPECS = {
-  // React — the module's DEFAULT export (classic-JSX `React.createElement` +
-  // bare `React`). ProvidePlugin: `React: 'react'`.
   React: { module: "react", exportName: "default" },
-  // Core Remotion
   AbsoluteFill: { module: "remotion", exportName: "AbsoluteFill" },
   useCurrentFrame: { module: "remotion", exportName: "useCurrentFrame" },
   useVideoConfig: { module: "remotion", exportName: "useVideoConfig" },
@@ -13,13 +10,10 @@ var SANDBOX_GLOBAL_SPECS = {
   Sequence: { module: "remotion", exportName: "Sequence" },
   Img: { module: "remotion", exportName: "Img" },
   Easing: { module: "remotion", exportName: "Easing" },
-  // Fonts (local module)
   FONTS: { module: "./fonts", exportName: "FONTS" },
-  // Procedural animation (@remotion/noise)
   noise2D: { module: "@remotion/noise", exportName: "noise2D" },
   noise3D: { module: "@remotion/noise", exportName: "noise3D" },
   noise4D: { module: "@remotion/noise", exportName: "noise4D" },
-  // Vector shape components (@remotion/shapes)
   Circle: { module: "@remotion/shapes", exportName: "Circle" },
   Ellipse: { module: "@remotion/shapes", exportName: "Ellipse" },
   Heart: { module: "@remotion/shapes", exportName: "Heart" },
@@ -28,7 +22,6 @@ var SANDBOX_GLOBAL_SPECS = {
   Rect: { module: "@remotion/shapes", exportName: "Rect" },
   Star: { module: "@remotion/shapes", exportName: "Star" },
   Triangle: { module: "@remotion/shapes", exportName: "Triangle" },
-  // Shape path generators (@remotion/shapes)
   makeCircle: { module: "@remotion/shapes", exportName: "makeCircle" },
   makeEllipse: { module: "@remotion/shapes", exportName: "makeEllipse" },
   makeHeart: { module: "@remotion/shapes", exportName: "makeHeart" },
@@ -37,7 +30,6 @@ var SANDBOX_GLOBAL_SPECS = {
   makeRect: { module: "@remotion/shapes", exportName: "makeRect" },
   makeStar: { module: "@remotion/shapes", exportName: "makeStar" },
   makeTriangle: { module: "@remotion/shapes", exportName: "makeTriangle" },
-  // SVG path manipulation (@remotion/paths)
   evolvePath: { module: "@remotion/paths", exportName: "evolvePath" },
   interpolatePath: { module: "@remotion/paths", exportName: "interpolatePath" },
   getLength: { module: "@remotion/paths", exportName: "getLength" },
@@ -53,11 +45,8 @@ var SANDBOX_GLOBAL_SPECS = {
   getBoundingBox: { module: "@remotion/paths", exportName: "getBoundingBox" },
   warpPath: { module: "@remotion/paths", exportName: "warpPath" },
   extendViewBox: { module: "@remotion/paths", exportName: "extendViewBox" },
-  // Cinematic effects (@remotion/motion-blur)
   Trail: { module: "@remotion/motion-blur", exportName: "Trail" },
   CameraMotionBlur: { module: "@remotion/motion-blur", exportName: "CameraMotionBlur" },
-  // Safe media wrappers — DEFINED in sandbox-globals.ts (Video/OffthreadVideo
-  // auto-switch + startFrom→trimBefore). Resolved from the globals module.
   SandboxVideo: { module: GLOBALS_MODULE, exportName: "SandboxVideo" },
   SandboxAudio: { module: GLOBALS_MODULE, exportName: "SandboxAudio" }
 };

package/dist/{chunk-COYMZ76S.js → chunk-VFMW3JUY.js}

@@ -1,6 +1,6 @@
 import {
   resolveBookendTimeline
-} from "./chunk-YIOY2XEO.js";
+} from "./chunk-VHF66LCQ.js";
 
 // ../execution/compose/src/tokenResolver.ts
 var DEFAULTS = {

package/dist/{chunk-YIOY2XEO.js → chunk-VHF66LCQ.js}

@@ -20,15 +20,15 @@ import {
   scoreAndRank,
   segmentShots,
   stabilizeSelectionHysteresis
-} from "./chunk-JRQVPFLF.js";
+} from "./chunk-XQ72DZKJ.js";
 import {
   flattenCompoundClips,
   hasCompoundClips
-} from "./chunk-TWQOKKAF.js";
+} from "./chunk-23HFEKV7.js";
 import {
   compositionHasVo,
   roleDefaultGainDb
-} from "./chunk-JMURQODM.js";
+} from "./chunk-VZ7TYX6Z.js";
 import {
   SHOT_SCALE_TARGET,
   shotScaleZoom
@@ -36,7 +36,7 @@ import {
 import {
   CueframeError,
   encodeError
-} from "./chunk-37NJ27UU.js";
+} from "./chunk-LLUW26BS.js";
 
 // ../execution/core/src/render/emphasis.ts
 function buildEmphasisSet(emphasisWords) {
@@ -182,8 +182,6 @@ function projectClipEffects(clip, renderClipId) {
   const effects = clip.effects;
   if (!effects || effects.length === 0) return [];
   return effects.map((e, idx) => ({
-    // Deterministic, unique within the RenderInput: derives from the render-clip
-    // id + the effect's index on the clip (so React keys / clipFrames don't collide).
     id: `${renderClipId}::effect:${idx}`,
     primitiveId: e.primitiveId,
     params: e.params ?? {},
@@ -323,7 +321,7 @@ function playableSpans(trimStart, trimEnd, excluded) {
   if (cursor < trimEnd) out.push({ start: cursor, end: trimEnd });
   return out;
 }
-function projectMediaTrack(track, fps, srcUrls, trajectoryUrls, coViewUrls) {
+function projectMediaTrack(track, fps, srcUrls, trajectoryUrls, coViewUrls, trajectories) {
   const clips = [];
   const audio = [];
   const effects = [];
@@ -397,9 +395,6 @@ function projectMediaTrack(track, fps, srcUrls, trajectoryUrls, coViewUrls) {
         sourceOutFrames: sourceInFrames + subDurationFrames,
         timelineStartFrames: timelineCursorFrames,
         durationInFrames: subDurationFrames,
-        // Clip-relative trajectory origin: every sub-span of this clip shares the
-        // clip's trim.start, so the crop can rebase source-absolute span frames
-        // to the clip-relative (trajectory) frame across the excludedRanges gaps.
         trimStartFrames: frames(trimStart, fps),
         ...c.source.playbackRate !== void 0 ? { playbackRate: c.source.playbackRate } : {},
         ...c.source.volume !== void 0 ? { volume: c.source.volume } : {},
@@ -409,39 +404,14 @@ function projectMediaTrack(track, fps, srcUrls, trajectoryUrls, coViewUrls) {
         ...c.scale !== void 0 ? { scale: c.scale } : {},
         ...c.rotation !== void 0 ? { rotation: c.rotation } : {},
         ...c.animate !== void 0 ? { animate: c.animate } : {},
-        // Output-space placement. A sub-frame `region` makes the clip occupy
-        // only that rect of the output (PiP / split-screen / inset) — lower
-        // tracks show through the uncovered area. Carried per-clip (shared by
-        // every sub-span split from one wire clip). `fit` selects cover/contain.
         ...c.region !== void 0 ? { region: c.region } : {},
         ...c.fit !== void 0 ? { fit: c.fit } : {},
-        // Clip transition-in. Attached only to the FIRST span of a clip
-        // (transitions apply between original clips, not split sub-clips).
-        // The canonical `{type,duration}` maps to the render-input string enum
-        // + a frame count; without this the authored transition was dropped
-        // and rendered as a dead hard cut (mirror of tracksToRenderInput.ts).
         ...s === 0 && c.transitionIn ? {
           transitionIn: mapTransitionType(c.transitionIn.type),
           transitionDurationFrames: Math.max(1, Math.round(c.transitionIn.duration * fps))
         } : {},
-        // Per-frame crop trajectory URL. When present, the renderer
-        // applies the trajectory's per-frame normalized centers as a
-        // CSS transform over the raw video to produce the cropped
-        // output. Keyed by the PARENT wire-clip id `c.id` (NOT the
-        // sub-span `subId`): the trajectory map is per-clip (Phase 2), and
-        // every sub-span split from a clip shares that clip's trajectory.
-        // Resolved at the caller layer (Temporal activity), which looks up
-        // mediaItems.variants[intentHash][aspect].trajectoryR2Key per clip
-        // and presigns it.
         ...trajectoryUrls?.[c.id] !== void 0 ? { cropTrajectoryUrl: trajectoryUrls[c.id] } : {},
-        // Captions-behind CO-VIEW. Content-driven (Phase 6): the matte gate baked
-        // a crop-independent frame-packed co-view (scene over matte, one opaque
-        // H.264) for any clip whose timeline range overlaps a behind-subject
-        // caption window, surfaced here as coViewUrls[mediaId]. MATTE PRESENCE is
-        // the gate — no per-clip enable flag. The renderer splits the packed
-        // decode into the scene background + the subject cut-out foreground, and
-        // the global caption layer's behind tokens render between them (the
-        // output-space z-split in MainComposition).
+        ...trajectories?.[c.id] !== void 0 ? { cropTrajectory: trajectories[c.id] } : {},
         ...coViewUrls?.[c.source.mediaId] !== void 0 ? { packedUrl: coViewUrls[c.source.mediaId] } : {}
       });
     }
@@ -457,6 +427,7 @@ function projectMediaTrack(track, fps, srcUrls, trajectoryUrls, coViewUrls) {
     if (JSON.stringify(prev.region) !== JSON.stringify(cur.region)) continue;
     if ((prev.fit ?? "cover") !== (cur.fit ?? "cover")) continue;
     if (prev.cropTrajectoryUrl !== cur.cropTrajectoryUrl) continue;
+    if (prev.cropTrajectory !== cur.cropTrajectory) continue;
     if ((prev.trimStartFrames ?? 0) !== (cur.trimStartFrames ?? 0)) continue;
     const prevEnd = prev.timelineStartFrames + prev.durationInFrames;
     if (Math.abs(prevEnd - cur.timelineStartFrames) > 1) continue;
@@ -488,26 +459,17 @@ function projectImageTrack(track, fps, srcUrls) {
     clips.push({
       id: c.id,
       src,
-      // Stills have no source timeline — sourceIn/Out are zero. The
-      // renderer keys on mediaType==='image' to skip source-relative
-      // seeking entirely.
       sourceInFrames: 0,
       sourceOutFrames: 0,
       timelineStartFrames,
       durationInFrames,
       mediaType: "image",
       kenBurns: c.source.kenBurns ?? "in",
-      // The agent's authored camera channel for the still. When present it
-      // DRIVES the point-zoom (StillCrop derives the still trajectory from it);
-      // `kenBurns` is the fallback when no reframe was authored. This is how an
-      // image gets an arbitrary point-zoom (zoom into a UI element), not just
-      // the centered kenBurns presets.
       ...c.source.reframe !== void 0 && c.source.reframe.segments.length > 0 ? { reframe: c.source.reframe } : {},
       ...c.opacity !== void 0 ? { opacity: c.opacity } : {},
       ...c.scale !== void 0 ? { scale: c.scale } : {},
       ...c.rotation !== void 0 ? { rotation: c.rotation } : {},
       ...c.animate !== void 0 ? { animate: c.animate } : {},
-      // Output-space placement (PiP / inset still). See projectMediaTrack.
       ...c.region !== void 0 ? { region: c.region } : {},
       ...c.fit !== void 0 ? { fit: c.fit } : {}
     });
@@ -615,9 +577,6 @@ function projectOverlayTrack(track, fps, alphaUrls = {}, jsSourceByClipId = {})
       ...c.source.zPlane !== void 0 ? { zPlane: c.source.zPlane } : {},
       ...c.source.anchor !== void 0 ? { anchor: c.source.anchor } : {},
       ...c.source.parallax !== void 0 ? { parallax: c.source.parallax } : {},
-      // Output-space placement (clip-level, like media/image): the overlay
-      // primitive occupies only this sub-rect of the output (PiP / inset card).
-      // MainComposition wraps it in the same RegionBox; absent = full frame.
       ...c.region !== void 0 ? { region: c.region } : {},
       ...c.fit !== void 0 ? { fit: c.fit } : {},
       ...overlayTransitionFields(c, fps),
@@ -759,7 +718,7 @@ function componentRefsByClipId(composition) {
   }
   return refs;
 }
-function compositionToRenderInput(composition, srcUrls, trajectoryUrls, coViewUrls, alphaUrls, jsSourceByClipId, subCompositions) {
+function compositionToRenderInput(composition, srcUrls, trajectoryUrls, coViewUrls, alphaUrls, jsSourceByClipId, subCompositions, trajectories) {
   const flattened = hasCompoundClips(composition) ? flattenCompoundClips(composition, (id) => subCompositions?.[id]) : composition;
   composition = flattened;
   const { width, height, fps } = compositionFormatDimensions(composition.format);
@@ -770,7 +729,7 @@ function compositionToRenderInput(composition, srcUrls, trajectoryUrls, coViewUr
   for (const track of composition.tracks) {
     if (track.enabled === false) continue;
     if (track.kind === "video" || track.kind === "audio") {
-      const { clips: c, audio, effects: clipEffects } = projectMediaTrack(track, fps, srcUrls, trajectoryUrls, coViewUrls);
+      const { clips: c, audio, effects: clipEffects } = projectMediaTrack(track, fps, srcUrls, trajectoryUrls, coViewUrls, trajectories);
       clips.push(...c);
       audioTracks.push(...audio);
       effects.push(...clipEffects);
@@ -849,14 +808,8 @@ function compositionToRenderInput(composition, srcUrls, trajectoryUrls, coViewUr
     ...cap?.emphasisPlate != null ? { emphasisPlate: cap.emphasisPlate } : {},
     ...cap?.emphasisPlateColor ? { emphasisPlateColor: cap.emphasisPlateColor } : {},
     ...cap?.emphasisPlateTextColor ? { emphasisPlateTextColor: cap.emphasisPlateTextColor } : {},
-    // Brand accent → active/emphasis word color (today's behavior); a
-    // creator-set caption highlightColor is caption-specific identity and
-    // WINS over the generic accent.
     ...brandAccent ? { highlightColor: brandAccent, emphasisColor: brandAccent } : {},
     ...cap?.highlightColor ? { highlightColor: cap.highlightColor } : {},
-    // Brand-motion-derived caption entrance is the generic fallback; a
-    // caption-specific entrance (cap.*) is identity and WINS, so it spreads
-    // AFTER captionMotion.
     ...captionMotion ?? {},
     ...cap?.entrance ? { entrance: cap.entrance } : {},
     ...cap?.entranceMs != null ? { entranceMs: cap.entranceMs } : {},
@@ -870,18 +823,13 @@ function compositionToRenderInput(composition, srcUrls, trajectoryUrls, coViewUr
     height,
     fps,
     durationInFrames,
-    // Target platform (from the wire `Format`) frozen onto the render input so the
-    // composition floor's safe-zone placement clears that surface's UI chrome.
-    // Absent ⇒ the floor's 'unknown' (broadcast) default. Output-determining, so
-    // it's part of the render cache key (RENDER_CACHE_VERSION bumped alongside).
     ...composition.format.platform !== void 0 ? { platform: composition.format.platform } : {},
     ...audioTracks.length > 0 ? { audioTracks } : {},
     ...effects.length > 0 ? { effects } : {},
     ...hasCaptions ? { captionSegments } : {},
+    ...hasCaptions && composition.captions?.zPlane === "behind-subject" ? { captionsBehind: true } : {},
     ...captionStyle ? { captionStyle } : {},
     ...brandKit ? { brandKit } : {}
-    // (fitMode deleted 2026-05-25 — baked variants replace render-time fit
-    // decisions; the chosen variant URL IS the framing.)
   };
 }
 function assembleRenderInput(composition, resolved) {
@@ -930,27 +878,17 @@ var BPP = {
 function bppToCrf(bpp) {
   return Math.max(15, Math.min(36, Math.round(51 - bpp * 120)));
 }
-function computeExportDimensions(sourceWidth, sourceHeight, format, quality) {
-  let w;
-  let h;
-  if (format === "source") {
-    w = sourceWidth;
-    h = sourceHeight;
-  } else {
-    const preset = FORMAT_PRESETS[format];
-    const shortEdge = Math.min(sourceWidth, sourceHeight);
-    const minAspect = Math.min(preset.aspectWidth, preset.aspectHeight);
-    w = Math.round(shortEdge * (preset.aspectWidth / minAspect));
-    h = Math.round(shortEdge * (preset.aspectHeight / minAspect));
-  }
-  w = w % 2 === 0 ? w : w + 1;
-  h = h % 2 === 0 ? h : h + 1;
-  if (quality === "source") {
-    return { width: w, height: h, crf: void 0 };
-  }
+function qualityToCrf(quality) {
+  if (quality === "source") return void 0;
   const bpp = BPP[quality];
-  if (bpp === void 0) return { width: w, height: h, crf: void 0 };
-  return { width: w, height: h, crf: bppToCrf(bpp) };
+  return bpp === void 0 ? void 0 : bppToCrf(bpp);
+}
+function resolutionToOutputSize(width, height, resolution) {
+  if (resolution === "source") return void 0;
+  const preset = RESOLUTION_PRESETS[resolution];
+  const shortEdge = Math.min(width, height);
+  if (!preset || shortEdge <= 0 || shortEdge === preset.height) return void 0;
+  return { outputWidth: ensureEven(Math.round(width * preset.height / shortEdge)) };
 }
 function ensureEven(n) {
   return n % 2 === 0 ? n : n + 1;
@@ -1715,10 +1653,6 @@ function deriveTrajectory(track, segments, aspect, bakeVersion, isGenerated = fa
       subject,
       segCuts,
       fps,
-      // The all-faces cameraPath sizes its deadzone-inclusion crop window from
-      // the output aspect + the segment's authored zoom (default 1.0). Other
-      // modes ignore these. Per-shot zoom calibration (below) is `face`-only, so
-      // the all-faces window matches the emitted `zoom_scale` for every sub-shot.
       aspect,
       zoomScale
     );
@@ -1802,8 +1736,6 @@ function deriveTrajectory(track, segments, aspect, bakeVersion, isGenerated = fa
       const zooms = seg.ease ? buildEasedZooms(subLen, fps, zoom, seg.ease.in, seg.ease.out) : void 0;
       out.push({
         idx: out.length,
-        // Frame-based off the SNAPPED segStart (not the authored seg.startSec) so
-        // the segment times line up with the cut-aligned slice the render reads.
         start_sec: (segStart + a) / fps,
         end_sec: (segStart + b) / fps,
         zoom_scale: zoom,
@@ -1813,11 +1745,6 @@ function deriveTrajectory(track, segments, aspect, bakeVersion, isGenerated = fa
         subjects: subSubjects,
         caption_band_reserve: captionBandReserve(aspect),
         ...zooms ? { zooms } : {},
-        // Emit the DERIVED `overframed` outcome ONLY when true (an all-faces
-        // sub-shot whose group is wider than the aspect). Omitted (undefined) on
-        // a fitting group and every other mode, so the field never appears unless
-        // it is the documented widest-honest-frame case — keeps the trajectory
-        // JSON minimal and the golden diff scoped to real over-wide shots.
         ...overframed ? { overframed: true } : {}
       });
     }
@@ -1911,7 +1838,8 @@ export {
   FORMAT_PRESETS,
   RESOLUTION_PRESETS,
   bppToCrf,
-  computeExportDimensions,
+  qualityToCrf,
+  resolutionToOutputSize,
   ensureEven,
   faceArea,
   resolveSubjectFaces,

package/dist/{chunk-JMURQODM.js → chunk-VZ7TYX6Z.js}

@@ -344,7 +344,6 @@ function packMusicEntries() {
   return MUSIC_PACK_ENTRIES.map((e) => ({
     ref: e.bedId,
     role: "music",
-    // A bed is an unbounded loop — envelope class "ambient" in the browse grouping.
     envelopeClass: "ambient",
     description: e.description,
     durationSec: e.durationSec,