@cueframe/kernel 0.0.1 → 0.1.1

package/dist/{chunk-OIRUO5P7.js → chunk-JJ6XD7NG.js}

@@ -2,11 +2,11 @@ import {
   activeFaceKeepOutSeries,
   boundingBox,
   resolveBrandRefsDeep
-} from "./chunk-BRKJKB33.js";
+} from "./chunk-FYZVH3MC.js";
 import {
   CueframeError,
   encodeError
-} from "./chunk-37NJ27UU.js";
+} from "./chunk-OCFDUCF4.js";
 
 // ../composition/src/projection/cardTokens.ts
 var CARD_MOTION_VAR_NAMES = [
@@ -134,6 +134,148 @@ function deriveBehindAnchor(g) {
   };
 }
 
+// ../composition/src/projection/behind-readiness.ts
+async function matteIntentKey(intent) {
+  const canonical = {
+    startSec: Math.round(intent.startSec * 1e3) / 1e3,
+    endSec: Math.round(intent.endSec * 1e3) / 1e3,
+    subjectClass: intent.subjectClass
+  };
+  const bytes = new TextEncoder().encode(JSON.stringify(canonical));
+  const digest = await crypto.subtle.digest("SHA-256", bytes);
+  return Array.from(new Uint8Array(digest)).map((b) => b.toString(16).padStart(2, "0")).join("").slice(0, 12);
+}
+function overlapsMs(aStartSec, aDurationSec, bStartSec, bDurationSec) {
+  const aStart = aStartSec * 1e3;
+  const aEnd = (aStartSec + aDurationSec) * 1e3;
+  const bStart = bStartSec * 1e3;
+  const bEnd = (bStartSec + bDurationSec) * 1e3;
+  return aStart < bEnd && aEnd > bStart;
+}
+function tracksOf(composition) {
+  const tracks = composition?.tracks;
+  return Array.isArray(tracks) ? tracks : [];
+}
+function clipsOf(track) {
+  const contents = track.contents;
+  if (!Array.isArray(contents)) return [];
+  const out = [];
+  for (const c of contents) {
+    const id = c.id;
+    const startTime = c.startTime;
+    const duration = c.duration;
+    if (typeof id !== "string" || typeof startTime !== "number" || typeof duration !== "number") {
+      continue;
+    }
+    out.push(c);
+  }
+  return out;
+}
+function findClipById(composition, clipId) {
+  for (const track of tracksOf(composition)) {
+    for (const clip of clipsOf(track)) {
+      if (clip.id === clipId) return clip;
+    }
+  }
+  return null;
+}
+function primaryClipForOverlay(composition, overlayId) {
+  const overlay = findClipById(composition, overlayId);
+  if (!overlay || overlay.duration <= 0) return null;
+  for (const track of tracksOf(composition)) {
+    if (track.kind !== "video") continue;
+    for (const clip of clipsOf(track)) {
+      if (clip.source?.kind !== "media") continue;
+      const mediaId = clip.source.mediaId;
+      if (typeof mediaId !== "string" || !mediaId) continue;
+      if (!overlapsMs(clip.startTime, clip.duration, overlay.startTime, overlay.duration)) {
+        continue;
+      }
+      const trim = clip.source.trim;
+      const startSec = typeof trim?.start === "number" ? trim.start : 0;
+      const endSec = typeof trim?.end === "number" ? trim.end : startSec + clip.duration;
+      return { mediaId, window: { startSec, endSec } };
+    }
+  }
+  return null;
+}
+async function behindReadinessForOverlay(input) {
+  const target = primaryClipForOverlay(input.composition, input.overlayId);
+  return behindReadinessForTarget(
+    target,
+    target ? input.mattesByMediaId[target.mediaId] : void 0
+  );
+}
+async function behindReadinessForTarget(target, mattes) {
+  if (!target) return { state: "no-clip" };
+  const key = await matteIntentKey({ ...target.window, subjectClass: "person" });
+  const entry = mattes?.[key];
+  if (!entry?.geometryR2Key) return { state: "no-matte", target };
+  const presenceFraction = entry.presenceFraction ?? 0;
+  if (presenceFraction < MIN_PRESENCE_FOR_BEHIND) {
+    return { state: "no-subject", target, presenceFraction };
+  }
+  return { state: "subject-present", target };
+}
+
+// ../composition/src/projection/reframe-readiness.ts
+async function sourceWindowKey(window) {
+  const canonical = {
+    startSec: Math.round(window.startSec * 1e3) / 1e3,
+    endSec: Math.round(window.endSec * 1e3) / 1e3
+  };
+  if (window.detector && window.detector !== "face") {
+    canonical.detector = window.detector;
+  }
+  const bytes = new TextEncoder().encode(JSON.stringify(canonical));
+  const digest = await crypto.subtle.digest("SHA-256", bytes);
+  return Array.from(new Uint8Array(digest)).map((b) => b.toString(16).padStart(2, "0")).join("").slice(0, 12);
+}
+var SUBJECT_MODES = /* @__PURE__ */ new Set(["face", "all-faces", "active-speaker"]);
+function reframeNeedsDetection(segments) {
+  return segments.some((s) => {
+    const mode = s?.focus?.mode;
+    return typeof mode === "string" && SUBJECT_MODES.has(mode);
+  });
+}
+function reframeTargets(composition) {
+  const tracks = composition?.tracks;
+  if (!Array.isArray(tracks)) return [];
+  const out = [];
+  for (const track of tracks) {
+    const kind = track.kind;
+    if (kind !== "video" && kind !== "image") continue;
+    const contents = track.contents;
+    if (!Array.isArray(contents)) continue;
+    for (const content of contents) {
+      const src = content?.source;
+      if (!src || src.kind !== "media") continue;
+      const segments = src.reframe?.segments;
+      if (!Array.isArray(segments) || segments.length === 0) continue;
+      const clipId = content.id;
+      const mediaId = src.mediaId;
+      if (typeof clipId !== "string" || !clipId) continue;
+      if (typeof mediaId !== "string" || !mediaId) continue;
+      const duration = content.duration;
+      const startSec = typeof src.trim?.start === "number" ? src.trim.start : 0;
+      const endSec = typeof src.trim?.end === "number" ? src.trim.end : startSec + (typeof duration === "number" ? duration : 0);
+      if (!(endSec > startSec)) continue;
+      out.push({ clipId, mediaId, window: { startSec, endSec }, segments });
+    }
+  }
+  return out;
+}
+async function reframeReadinessForTarget(target, subjectTracks) {
+  if (!reframeNeedsDetection(target.segments)) return { state: "geometric" };
+  const key = await sourceWindowKey(target.window);
+  const entry = subjectTracks?.[key];
+  if (!entry) return { state: "no-track" };
+  if (typeof entry.trackUrl !== "string" || !entry.trackUrl) {
+    return { state: "track-unfetchable", entry };
+  }
+  return { state: "track-ready", entry, trackUrl: entry.trackUrl };
+}
+
 // ../composition/src/projection/occlusion-budget.ts
 var BUDGET = { minBite: 0.15, maxCoverage: 0.65, maxTopHalf: 0.35 };
 var BEHIND_TEXT_EXTENT = { heightFrac: 0.18 };
@@ -381,6 +523,14 @@ export {
   MIN_PRESENCE_FOR_BEHIND,
   BEHIND_BAND,
   deriveBehindAnchor,
+  matteIntentKey,
+  primaryClipForOverlay,
+  behindReadinessForOverlay,
+  behindReadinessForTarget,
+  sourceWindowKey,
+  reframeNeedsDetection,
+  reframeTargets,
+  reframeReadinessForTarget,
   BUDGET,
   BEHIND_TEXT_EXTENT,
   evaluateOcclusionBudget,

package/dist/{_members/primitives/chunk-IDAL6G3Y.js → chunk-JQMPHKLU.js}

@@ -1,13 +1,12 @@
-// src/lib/preview.tsx
+// ../execution/primitives/src/lib/preview.tsx
 import * as React from "react";
 import { AbsoluteFill } from "remotion";
 import { Player } from "@remotion/player";
 import { TransitionSeries, linearTiming } from "@remotion/transitions";
-import { jsx, jsxs } from "react/jsx-runtime";
 var TransitionPanel = ({
   label,
   color
-}) => /* @__PURE__ */ jsx(
+}) => /* @__PURE__ */ React.createElement(
   AbsoluteFill,
   {
     style: {
@@ -19,23 +18,19 @@ var TransitionPanel = ({
       fontFamily: "inherit",
       fontSize: 96,
       fontWeight: 600
-    },
-    children: label
-  }
+    }
+  },
+  label
 );
 var TransitionPreviewComposition = ({ presentation, durationInFrames }) => {
   const half = Math.max(1, Math.floor(durationInFrames / 2));
-  return /* @__PURE__ */ jsxs(TransitionSeries, { children: [
-    /* @__PURE__ */ jsx(TransitionSeries.Sequence, { durationInFrames: half, children: /* @__PURE__ */ jsx(TransitionPanel, { label: "A", color: "#0ea5e9" }) }),
-    /* @__PURE__ */ jsx(
-      TransitionSeries.Transition,
-      {
-        timing: linearTiming({ durationInFrames: half }),
-        presentation
-      }
-    ),
-    /* @__PURE__ */ jsx(TransitionSeries.Sequence, { durationInFrames: half, children: /* @__PURE__ */ jsx(TransitionPanel, { label: "B", color: "#9333ea" }) })
-  ] });
+  return /* @__PURE__ */ React.createElement(TransitionSeries, null, /* @__PURE__ */ React.createElement(TransitionSeries.Sequence, { durationInFrames: half }, /* @__PURE__ */ React.createElement(TransitionPanel, { label: "A", color: "#0ea5e9" })), /* @__PURE__ */ React.createElement(
+    TransitionSeries.Transition,
+    {
+      timing: linearTiming({ durationInFrames: half }),
+      presentation
+    }
+  ), /* @__PURE__ */ React.createElement(TransitionSeries.Sequence, { durationInFrames: half }, /* @__PURE__ */ React.createElement(TransitionPanel, { label: "B", color: "#9333ea" })));
 };
 var PrimitivePreview = ({
   primitive,
@@ -65,7 +60,7 @@ var PrimitivePreview = ({
   const loop = primitive.preview.mode === "loop";
   const shouldAutoPlay = autoPlay ?? loop;
   if (!example) {
-    return /* @__PURE__ */ jsxs(
+    return /* @__PURE__ */ React.createElement(
       "div",
       {
         className,
@@ -80,17 +75,15 @@ var PrimitivePreview = ({
           fontFamily: "monospace",
           fontSize: 12,
           ...style
-        },
-        children: [
-          "no example for ",
-          primitive.id
-        ]
-      }
+        }
+      },
+      "no example for ",
+      primitive.id
     );
   }
   if (primitive.kind === "transition" && primitive.createPresentation) {
     const presentation = primitive.createPresentation(inputProps);
-    return /* @__PURE__ */ jsx(
+    return /* @__PURE__ */ React.createElement(
       Player,
       {
         component: TransitionPreviewComposition,
@@ -110,7 +103,7 @@ var PrimitivePreview = ({
       }
     );
   }
-  return /* @__PURE__ */ jsx(
+  return /* @__PURE__ */ React.createElement(
     Player,
     {
       component: primitive.component,
@@ -131,4 +124,3 @@ var PrimitivePreview = ({
 export {
   PrimitivePreview
 };
-//# sourceMappingURL=chunk-IDAL6G3Y.js.map

package/dist/{chunk-G3PBH53P.js → chunk-MBCXCJOE.js}

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

package/dist/{chunk-UEI3NLNK.js → chunk-MHOQTPOB.js}

@@ -1,8 +1,5 @@
-import {
-  zodToJsonSchema
-} from "./chunk-NDKERSXY.js";
-
 // ../execution/primitives/src/lib/schema.ts
+import { zodToJsonSchema } from "zod-to-json-schema";
 function zodToJsonSchemaFor(schema, name) {
   return zodToJsonSchema(schema, {
     name,

package/dist/{chunk-37NJ27UU.js → chunk-OCFDUCF4.js}

@@ -362,6 +362,9 @@ var CueframeError = class extends Error {
     this.locator = locator;
     this.name = "CueframeError";
   }
+  code;
+  fix;
+  locator;
   toEnvelope() {
     const s = ERROR_CODES[this.code];
     return {

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

@@ -20,10 +20,7 @@ import {
 import {
   FitText,
   resolveFitFontSize
-} from "./chunk-DSNG6WLU.js";
-import {
-  fitTextOnNLines
-} from "./chunk-YA3OR2KK.js";
+} from "./chunk-AYVJXDLB.js";
 import {
   ACCENT,
   ACCENT_STRONG,
@@ -366,6 +363,7 @@ var Karaoke = ({
 // ../execution/primitives/src/text/kinetic-type/index.tsx
 import React4 from "react";
 import { useCurrentFrame as useCurrentFrame5, useVideoConfig as useVideoConfig5, spring as spring3, interpolate as interpolate5, AbsoluteFill as AbsoluteFill3 } from "remotion";
+import { fitTextOnNLines } from "@remotion/layout-utils";
 var PHRASE_TEXT_WIDTH = 1600;
 var KineticType = ({
   text,
@@ -720,6 +718,7 @@ function MarkerHighlight({
 // ../execution/primitives/src/text/shimmer-sweep/index.tsx
 import { useMemo } from "react";
 import { interpolate as interpolate8, useCurrentFrame as useCurrentFrame8, useVideoConfig as useVideoConfig8 } from "remotion";
+import { fitTextOnNLines as fitTextOnNLines2 } from "@remotion/layout-utils";
 function ShimmerSweep({
   text,
   baseColor = "#a1a1aa",
@@ -742,7 +741,7 @@ function ShimmerSweep({
     const t = (text ?? "").trim();
     if (!t) return fontSize;
     try {
-      const { fontSize: fs } = fitTextOnNLines({
+      const { fontSize: fs } = fitTextOnNLines2({
         text: t,
         maxLines: 1,
         maxBoxWidth: 1500,
@@ -995,6 +994,7 @@ function TextFadeReplace({
 // ../execution/primitives/src/text/tracking-in/index.tsx
 import React7 from "react";
 import { interpolate as interpolate10, spring as spring6, useCurrentFrame as useCurrentFrame11, useVideoConfig as useVideoConfig11 } from "remotion";
+import { fitTextOnNLines as fitTextOnNLines3 } from "@remotion/layout-utils";
 var TRACKING_IN_TEXT_WIDTH = 1500;
 var TRACKING_IN_SETTLED_SPACING = "-0.03em";
 function TrackingIn({
@@ -1024,7 +1024,7 @@ function TrackingIn({
   const fittedFontSize = React7.useMemo(() => {
     if (text.trim().length === 0) return fontSize;
     try {
-      const { fontSize: fit } = fitTextOnNLines({
+      const { fontSize: fit } = fitTextOnNLines3({
         text,
         maxLines: 1,
         maxBoxWidth: TRACKING_IN_TEXT_WIDTH,
@@ -1067,6 +1067,7 @@ function TrackingIn({
 // ../execution/primitives/src/text/typewriter/index.tsx
 import React8 from "react";
 import { interpolate as interpolate11, useCurrentFrame as useCurrentFrame12, useVideoConfig as useVideoConfig12 } from "remotion";
+import { fitTextOnNLines as fitTextOnNLines4 } from "@remotion/layout-utils";
 var TYPEWRITER_TEXT_WIDTH = 1500;
 var TYPEWRITER_MAX_LINES = 3;
 var TYPEWRITER_LETTER_SPACING = "-0.03em";
@@ -1096,7 +1097,7 @@ function Typewriter({
   const fittedFontSize = React8.useMemo(() => {
     if (text.trim().length === 0) return fontSize;
     try {
-      const { fontSize: fit } = fitTextOnNLines({
+      const { fontSize: fit } = fitTextOnNLines4({
         text,
         maxLines: TYPEWRITER_MAX_LINES,
         maxBoxWidth: TYPEWRITER_TEXT_WIDTH,
@@ -1689,6 +1690,7 @@ var TokenStream = ({
 // ../execution/primitives/src/text/strikethrough-replace/index.tsx
 import { useMemo as useMemo2 } from "react";
 import { interpolate as interpolate15, useCurrentFrame as useCurrentFrame19, useVideoConfig as useVideoConfig18 } from "remotion";
+import { fitTextOnNLines as fitTextOnNLines5 } from "@remotion/layout-utils";
 function StrikethroughReplace({
   from,
   to,
@@ -1725,7 +1727,7 @@ function StrikethroughReplace({
     const longest = [from, to].map((s) => (s ?? "").trim()).sort((a, b) => b.length - a.length)[0] || "";
     if (!longest) return fontSize;
     try {
-      const { fontSize: fs } = fitTextOnNLines({
+      const { fontSize: fs } = fitTextOnNLines5({
         text: longest,
         maxLines: 1,
         maxBoxWidth: 1400,
@@ -1809,6 +1811,7 @@ function StrikethroughReplace({
 // ../execution/primitives/src/text/masked-slide-reveal/index.tsx
 import { useMemo as useMemo3 } from "react";
 import { spring as spring10, useCurrentFrame as useCurrentFrame20, useVideoConfig as useVideoConfig19 } from "remotion";
+import { fitTextOnNLines as fitTextOnNLines6 } from "@remotion/layout-utils";
 function MaskedSlideReveal({
   text,
   staggerDelay = 3,
@@ -1826,7 +1829,7 @@ function MaskedSlideReveal({
     const t = (text ?? "").trim();
     if (!t) return fontSize;
     try {
-      const { fontSize: fs } = fitTextOnNLines({
+      const { fontSize: fs } = fitTextOnNLines6({
         text: t,
         maxLines: 2,
         maxBoxWidth: 1500,

package/dist/{chunk-P43IE4WB.js → chunk-P727GZVO.js}

@@ -12,13 +12,11 @@ import {
 } from "./chunk-ZFEXATWN.js";
 import {
   resolveFitFontSize
-} from "./chunk-DSNG6WLU.js";
-import {
-  fitTextOnNLines
-} from "./chunk-YA3OR2KK.js";
+} from "./chunk-AYVJXDLB.js";
 
 // ../execution/primitives/src/hero-text/HeroText.tsx
 import { useCurrentFrame, useVideoConfig } from "remotion";
+import { fitTextOnNLines } from "@remotion/layout-utils";
 var REVEAL_WINDOW_MS = 240;
 function HeroText({
   text,

package/dist/{chunk-52AHXNKM.js → chunk-PDYO3DOJ.js}

@@ -4,16 +4,16 @@ import {
 import {
   getPrimitiveSubtextParam,
   getPrimitiveTextParam
-} from "./chunk-5I7VDCAC.js";
+} from "./chunk-7FO3ZJ43.js";
 import {
   selectAllOverlays
-} from "./chunk-NV4I6GJV.js";
+} from "./chunk-ZWMV6DD2.js";
 import {
   ComposePlan
-} from "./chunk-TULRCY6U.js";
+} from "./chunk-TOJEXFXL.js";
 import {
   OverlayClipSource
-} from "./chunk-ATAF24QG.js";
+} from "./chunk-PODIYN2K.js";
 
 // ../authoring/src/tools/toolSets.ts
 var COMPOSE_PLANNER_TOOLS = [
@@ -65,7 +65,7 @@ var COMPOSE_ROLE_TOOLS = Object.freeze({
     // Always reads the LIVE composition. The session-cached context seeds the
     // system prompt only; a tool call must see clips added since the run began.
     handler: async (_args, capabilities) => {
-      const { buildDirectorContext } = await import("./context-CEAKQ5T7.js");
+      const { buildDirectorContext } = await import("./context-YWUZDG5X.js");
       return buildDirectorContext(capabilities);
     }
   },

package/dist/{chunk-S3P5BFFL.js → chunk-PMY24FUD.js}

@@ -1,9 +1,6 @@
 import {
   resolveFitFontSize
-} from "./chunk-DSNG6WLU.js";
-import {
-  fitTextOnNLines
-} from "./chunk-YA3OR2KK.js";
+} from "./chunk-AYVJXDLB.js";
 import {
   ACCENT,
   ACCENT_SOFT,
@@ -1382,6 +1379,7 @@ function VectorField({
 
 // ../execution/primitives/src/backgrounds/volumetric-rays/index.tsx
 import { interpolate as interpolate2, useCurrentFrame as useCurrentFrame11 } from "remotion";
+import { fitTextOnNLines } from "@remotion/layout-utils";
 var FONT_FAMILY3 = "inherit";
 function VolumetricRays({
   text = "REMOCN",

package/dist/{chunk-ATAF24QG.js → chunk-PODIYN2K.js}

@@ -266,7 +266,7 @@ var TimelineClip = z.object({
    * does not select its audio, so every ripple, move and trim silently desyncs
    * sound from picture and the user finds out at playback. Every editor this
    * repo has been measured against carries the same field; ours had none
-   * (`grep linkGroup` returned nothing across `cueframe/src` and
+   * (`grep linkGroup` returned nothing across `apps/studio/src` and
    * `packages/composition/src` on 2026-08-23).
    *
    * Membership is the ONLY thing stored. What a link implies — expand the
@@ -434,20 +434,26 @@ var CaptionStyle = z.object({
 var CaptionSegment = z.object({
   words: z.array(CaptionWord)
 });
+var CaptionDepth = z.enum(["front", "behind-subject"]).optional();
 var CompositionCaptions = z.discriminatedUnion("source", [
   z.object({
     source: z.literal("derived"),
     /** The clip these words are a projection OF. Re-derive from this. */
     from: z.object({ clipId: z.string() }),
     segments: z.array(CaptionSegment),
-    style: CaptionStyle.optional()
+    style: CaptionStyle.optional(),
+    zPlane: CaptionDepth
   }),
   z.object({
     source: z.literal("authored"),
     segments: z.array(CaptionSegment),
-    style: CaptionStyle.optional()
+    style: CaptionStyle.optional(),
+    zPlane: CaptionDepth
   })
 ]);
+function captionsAreBehindSubject(captions) {
+  return captions?.zPlane === "behind-subject";
+}
 function captionWords(c) {
   return c.segments.flatMap((s) => s.words);
 }
@@ -707,6 +713,7 @@ export {
   CaptionStyle,
   CaptionSegment,
   CompositionCaptions,
+  captionsAreBehindSubject,
   captionWords,
   Composition,
   CompositionAuthorKind,