@cueframe/kernel 0.1.1 → 0.1.3

package/dist/{chunk-AQBREB5O.js → chunk-DWLNPNC4.js}

@@ -2,7 +2,7 @@ import {
   selectAllClips,
   selectAllOverlays,
   selectSceneMarkers
-} from "./chunk-ZWMV6DD2.js";
+} from "./chunk-ICSZF37W.js";
 
 // ../authoring/src/context/transcript.ts
 var MAX_TRANSCRIPT_CHARS = 6e4;
@@ -165,9 +165,6 @@ function buildBrandKitData(activeBrandKit) {
     headingFont: { ...activeBrandKit.headingFont },
     bodyFont: { ...activeBrandKit.bodyFont },
     voiceGuidelines: activeBrandKit.voiceGuidelines,
-    // Render-relevant overlay assets carry the wire shape now — surface the
-    // asset reference (src) / authored card text so the agent knows a bumper or
-    // mark is present without re-deriving it.
     ...activeBrandKit.intro && { intro: activeBrandKit.intro.src ?? activeBrandKit.intro.title ?? activeBrandKit.intro.kind },
     ...activeBrandKit.outro && { outro: activeBrandKit.outro.src ?? activeBrandKit.outro.title ?? activeBrandKit.outro.kind },
     ...activeBrandKit.watermark && { watermark: activeBrandKit.watermark.src },

package/dist/{chunk-SW336CJP.js → chunk-DYZE7JZA.js}

@@ -1,10 +1,10 @@
+import {
+  DashboardPopulate
+} from "./chunk-ZSZABOE5.js";
 import {
   frostedGlassWipe,
   spatialPush
 } from "./chunk-QGAWDLYX.js";
-import {
-  DashboardPopulate
-} from "./chunk-ZSZABOE5.js";
 import {
   ACCENT_SOFT,
   BG,
@@ -828,7 +828,6 @@ function PulseLogo({
     AbsoluteFill2,
     {
       style: {
-        // Exposure lift — the scene graded ~1.5 stops under launch-video norm.
         filter: "brightness(1.28) contrast(1.03)",
         background,
         display: "flex",
@@ -932,7 +931,6 @@ function AppShellFlyover({
     AbsoluteFill2,
     {
       style: {
-        // Exposure lift — the scene graded ~1.5 stops under launch-video norm.
         filter: "brightness(1.28) contrast(1.03)",
         background,
         opacity: enter,
@@ -2308,7 +2306,6 @@ var SCENES = {
   maskedSlide: { start: 290, duration: 120 },
   push2: { start: 400, duration: 60 },
   terminal: { start: 460, duration: 180 },
-  // Quiet hold at the very end so the loop never restarts mid-action.
   endHold: 80
 };
 var LANDING_CODE_SHOWCASE_DURATION = SCENES.terminal.start + SCENES.terminal.duration + SCENES.endHold;
@@ -2920,10 +2917,6 @@ var paramsSchema = z.object({
   cardBackground: z.string().optional().describe("Card panel background."),
   accent: z.string().default("#ffb38e").describe('Accent color for label/highlights. Brand-bindable: pass "$brand:colors.accent" to track the project brand kit.'),
   speed: z.number().min(0.25).max(4).default(1).describe("Playback speed multiplier."),
-  // Structured-content slot for the before/after comparison panels. These are
-  // the JSON-serializable replacement for the inexpressible `oldContent`/
-  // `newContent` ReactNode props: supply the literal diff lines and they render
-  // in the panels. Omit them to show the baked sample diff.
   oldLines: z.array(z.string()).optional().describe("BEFORE-panel content: one string per line (e.g. the old code). Rendered as monospace text. Omit to show the baked sample diff."),
   newLines: z.array(z.string()).optional().describe("AFTER-panel content: one string per line (e.g. the new code). Rendered as monospace text. Omit to show the baked sample diff.")
 }).passthrough();
@@ -2952,11 +2945,6 @@ var config = {
   ],
   textParam: "title",
   subtextParam: "label",
-  // label/title/oldLines/newLines ARE params — the diff CONTENT is now
-  // expressible (string[] panels, see oldLines/newLines). What remains baked is
-  // only the panel chrome: the BEFORE/AFTER corner badges and the mid-wipe
-  // footer labels. Omitting oldLines/newLines falls back to a baked sample diff
-  // (its literals are the params' documented defaults, not fixed copy).
   fixedCopy: [
     "BEFORE",
     "AFTER",
@@ -3006,8 +2994,6 @@ var config2 = {
   ],
   textParam: null,
   subtextParam: null,
-  // The typed program + rendered output are BAKED — no param sets the code or
-  // the resulting button label.
   fixedCopy: [
     "Button",
     // editor filename tab
@@ -3062,8 +3048,6 @@ var config3 = {
   ],
   textParam: "productName",
   subtextParam: "versionLabel",
-  // logoLabel/productName/versionLabel ARE params; these are the BAKED strings
-  // (FauxBentoGrid cards + FauxCodeBlock body) no param can change.
   fixedCopy: [
     "Animations",
     "Spring-tuned",
@@ -3211,8 +3195,6 @@ var config5 = {
   ],
   textParam: null,
   subtextParam: null,
-  // focusedTier picks WHICH card to spotlight; all tier copy/prices are BAKED.
-  // The scene that exists to show pricing cannot carry the agent's pricing.
   fixedCopy: [
     "Free",
     "$0",
@@ -3292,9 +3274,6 @@ var config6 = {
   ],
   textParam: null,
   subtextParam: null,
-  // No prop changes the marketing copy or the typed program — fork via
-  // get_component_source to rewrite (index.tsx STEPS / BlurRevealScene /
-  // MaskedSlideScene / TerminalScene).
   fixedCopy: [
     "Build faster.",
     // BlurReveal headline (right preview pane)
@@ -3369,8 +3348,6 @@ var config7 = {
   ],
   textParam: "siteUrl",
   subtextParam: null,
-  // siteUrl is a param (it interpolates into the success line + address bar);
-  // the terminal log lines + browser chrome/hero are BAKED.
   fixedCopy: [
     "$ pnpm deploy",
     "\u2192 Building project...",

package/dist/{chunk-HCCBDJLW.js → chunk-EP2Y6M2J.js}

@@ -27,10 +27,6 @@ async function multipartUpload(opts) {
     headers,
     body: JSON.stringify({
       filename: file.name,
-      // NOT `file.type || "video/mp4"`. That fallback relabelled every untyped
-      // file as video, so an MP3 with no MIME uploaded as `video/mp4` and was
-      // routed down the video transcode path by `mediaKind()` — a wrong
-      // pipeline instead of an honest refusal. See `contentTypeForUpload`.
       type: contentTypeForUpload(file.name, file.type),
       metadata: { uploadToken: token, ...metadata }
     })

package/dist/{chunk-ZE76SSRT.js → chunk-FMODQD5P.js}

@@ -248,12 +248,6 @@ function mapFreesoundCandidate(r, query) {
     query,
     thumbnail: preview ? preview.replace(/\.mp3$/, ".png") : "",
     previewUrl: preview,
-    // Import the PUBLIC preview (preview-hq-mp3), not the API download endpoint
-    // (`/apiv2/sounds/{id}/download/`) — that requires an OAuth2 bearer token,
-    // which no consumer has (the gateway only carries a Freesound API Token, which
-    // the download endpoint rejects with 401). The R2 mirror fetches this URL bare,
-    // exactly like the public CDN URLs the other providers ship (klipy likewise
-    // sets downloadUrl === previewUrl). preview-hq-mp3 is acceptable for stock sfx.
     downloadUrl: preview,
     duration: Number(r.duration ?? 0),
     photographer: String(r.username ?? ""),

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

@@ -1,6 +1,6 @@
 import {
   resolveFitFontSize
-} from "./chunk-AYVJXDLB.js";
+} from "./chunk-XHGZ2E77.js";
 import {
   ACCENT,
   ACCENT_SOFT,

package/dist/{chunk-LD5ZOUFT.js → chunk-GF52TW4I.js}

@@ -14,22 +14,18 @@ var PipelineTrace = class {
   constructor(logger) {
     this.log = logger ?? DEFAULT_LOGGER;
   }
-  /** Begin a named span. */
   start(name) {
     this.openSpans.set(name, performance.now());
   }
-  /** End a named span. No-op if the span was never started. */
   end(name) {
     const startMs = this.openSpans.get(name);
     if (startMs === void 0) return;
     this.openSpans.delete(name);
     this.spans.push({ name, startMs, endMs: performance.now() });
   }
-  /** Record a tool call (increments the counter for the summary). */
   recordToolCall() {
     this.toolCallCount++;
   }
-  /** Log a summary table of all recorded spans. */
   summary() {
     const totalMs = performance.now() - this.t0;
     const accounted = this.spans.reduce((sum, s) => sum + (s.endMs - s.startMs), 0);

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

@@ -2,11 +2,11 @@ import {
   activeFaceKeepOutSeries,
   boundingBox,
   resolveBrandRefsDeep
-} from "./chunk-FYZVH3MC.js";
+} from "./chunk-YQ7FFW3G.js";
 import {
   CueframeError,
   encodeError
-} from "./chunk-OCFDUCF4.js";
+} from "./chunk-AW57IWNW.js";
 
 // ../composition/src/projection/cardTokens.ts
 var CARD_MOTION_VAR_NAMES = [
@@ -217,6 +217,70 @@ async function behindReadinessForTarget(target, mattes) {
   }
   return { state: "subject-present", target };
 }
+function clipOverlapsBehind(clipStartSec, clipDurationSec, windows) {
+  const start = clipStartSec * 1e3;
+  const end = (clipStartSec + clipDurationSec) * 1e3;
+  return windows.some((w) => start < w.endMs && end > w.startMs);
+}
+function matteWindowsByMediaId(composition, behindWindows) {
+  const out = /* @__PURE__ */ new Map();
+  if (behindWindows.length === 0) return out;
+  for (const track of tracksOf(composition)) {
+    const kind = track.kind;
+    if (kind !== "video" && kind !== "audio" && kind !== "image") 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 (!clipOverlapsBehind(clip.startTime, clip.duration, behindWindows)) 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;
+      if (endSec <= startSec) continue;
+      if (!out.has(mediaId)) out.set(mediaId, { startSec, endSec });
+    }
+  }
+  return out;
+}
+function behindWindowsOf(composition) {
+  const out = [];
+  for (const track of tracksOf(composition)) {
+    for (const clip of clipsOf(track)) {
+      const src = clip.source;
+      const kind = src?.kind;
+      if (kind !== "overlay" && kind !== "alpha-layer") continue;
+      if (src?.zPlane !== "behind-subject") continue;
+      if (clip.duration <= 0) continue;
+      out.push({
+        startMs: clip.startTime * 1e3,
+        endMs: (clip.startTime + clip.duration) * 1e3
+      });
+    }
+  }
+  out.push(...captionBehindWindowsOf(composition));
+  return out;
+}
+function captionBehindWindowsOf(composition) {
+  const out = [];
+  const captions = composition?.captions;
+  if (captions?.zPlane === "behind-subject" && Array.isArray(captions.segments)) {
+    for (const seg of captions.segments) {
+      const words = seg?.words;
+      if (!Array.isArray(words) || words.length === 0) continue;
+      let startMs = Infinity;
+      let endMs = -Infinity;
+      for (const w of words) {
+        const s = w.startMs;
+        const e = w.endMs;
+        if (typeof s !== "number" || typeof e !== "number") continue;
+        if (s < startMs) startMs = s;
+        if (e > endMs) endMs = e;
+      }
+      if (Number.isFinite(startMs) && endMs > startMs) out.push({ startMs, endMs });
+    }
+  }
+  return out;
+}
 
 // ../composition/src/projection/reframe-readiness.ts
 async function sourceWindowKey(window) {
@@ -527,6 +591,10 @@ export {
   primaryClipForOverlay,
   behindReadinessForOverlay,
   behindReadinessForTarget,
+  clipOverlapsBehind,
+  matteWindowsByMediaId,
+  behindWindowsOf,
+  captionBehindWindowsOf,
   sourceWindowKey,
   reframeNeedsDetection,
   reframeTargets,

package/dist/{chunk-ABL557OT.js → chunk-GMD33ZD7.js}

@@ -1,6 +1,6 @@
 import {
   FitText
-} from "./chunk-AYVJXDLB.js";
+} from "./chunk-XHGZ2E77.js";
 import {
   ACCENT,
   ACCENT_STRONG,
@@ -49,7 +49,6 @@ var Blur = ({
         width: "100%",
         height: "100%",
         filter: filterValue,
-        // Motion blur simulation: scale slightly in one direction
         ...type === "motion" && currentRadius > 0 ? { transform: `scaleX(${1 + currentRadius * 5e-3})` } : {},
         ...style
       }
@@ -829,9 +828,6 @@ var config = {
   category: "effects",
   kind: "component",
   version: "0.1.0",
-  // Same wrapper contract as color-grade — see that config's note. Caveat the
-  // wrap mount inherits: `animateFrom/To` interpolate over the BODY's frame
-  // span (there is no Sequence around a wrap mount), not the effect window.
   effectPlacement: "wrap",
   intent: "depth-blur",
   description: "Animatable blur wrapper. Wrap any child to apply CSS filter blur, optionally animating the radius across the duration (focus pull, reveal, transition out). Motion blur variant adds a slight scaleX stretch for a horizontal-pan feel.",
@@ -891,9 +887,6 @@ var config2 = {
   category: "effects",
   kind: "component",
   version: "0.1.0",
-  // A filter WRAPPER: CSS `filter` only touches the element's own subtree, so
-  // the render must mount this AROUND the footage (WrapEffects), never as a
-  // stacked layer — stacked, it filters an empty div and grades nothing.
   effectPlacement: "wrap",
   intent: "color-grade",
   description: "CSS-filter-based color grading wrapper. Seven presets cover the common looks (vintage, cinematic, bleach-bypass, sepia, cool, warm, none) and per-channel overrides are available for fine-tuning. Wrap any media \u2014 Img, Video, full Composition.",

package/dist/{chunk-AP6ZIVAV.js → chunk-HBVAZXYO.js}

@@ -1,41 +1,41 @@
 import {
   isContrastCritical
-} from "./chunk-7DHP4ESU.js";
-import {
-  catalog
-} from "./chunk-OLFOPQCA.js";
-import {
-  catalog as catalog3
-} from "./chunk-AWT3P5ZN.js";
+} from "./chunk-YLDMAZZE.js";
 import {
   catalog as catalog6
-} from "./chunk-GA23TRNR.js";
-import {
-  catalog as catalog5
-} from "./chunk-PMY24FUD.js";
+} from "./chunk-BKHGL4MB.js";
 import {
   catalog as catalog2
-} from "./chunk-ABL557OT.js";
+} from "./chunk-GMD33ZD7.js";
 import {
   catalog as catalog8
-} from "./chunk-P727GZVO.js";
+} from "./chunk-SAMQUUO5.js";
 import {
   catalog as catalog4
-} from "./chunk-YX2GSJK7.js";
+} from "./chunk-RP4SXXLJ.js";
 import {
   catalog as catalog7
-} from "./chunk-SW336CJP.js";
+} from "./chunk-DYZE7JZA.js";
+import {
+  catalog
+} from "./chunk-UQSOS726.js";
+import {
+  catalog as catalog3
+} from "./chunk-AWT3P5ZN.js";
+import {
+  catalog as catalog5
+} from "./chunk-G5BFI32U.js";
 import {
   getPrimitiveSubtextParam,
   getPrimitiveTextParam
-} from "./chunk-7FO3ZJ43.js";
+} from "./chunk-DCVJWGIA.js";
 import {
   NEUTRAL_RAMP
 } from "./chunk-JF4JJAFP.js";
 import {
   CueframeError,
   encodeError
-} from "./chunk-OCFDUCF4.js";
+} from "./chunk-AW57IWNW.js";
 
 // ../execution/compose/src/primitiveRegistry.ts
 var allCatalogs = [

package/dist/{chunk-UY4SWJVE.js → chunk-HFC3MKXA.js}

@@ -127,55 +127,6 @@ Call submit_plan with type "plan" if:
 - Prefer moments where the speaker introduces a concept or transitions topics
 - At most 1 intro and 1 outro`;
 
-// ../authoring/src/prompts/designReviewerPrompt.ts
-var DESIGN_REVIEWER_PROMPT = `You are a design quality reviewer for motion graphics in CueFrame.
-
-## Workflow
-
-1. Call \`get_context\` to understand the current project state and brand kit.
-2. Call \`get_composition\` to read the graphics themselves \u2014 a card clip carries its
-   \`html\` and \`tokens\` verbatim; an overlay or component clip carries its params.
-   For a component's animation code, call \`get_component_source\` with its componentId.
-3. Call \`preview_frame\` with EVERY beat you need to see in ONE call \u2014 the rendered
-   pixels, not your reading of the source.
-4. Assess quality against the checklist below. If improvements are needed, send the
-   fixes as ONE \`apply_composition\` batch \u2014 a \`clip.update\` op per graphic carrying
-   only the fields that change \u2014 then re-preview the beats you touched to verify.
-
-## Quality Checklist
-
-- **Visual hierarchy**: Title large/bold, subtext smaller/lighter, decorative elements subtle
-- **Animation choreography**: Elements arrive in sequence with staggered timing, not all at once
-- **Spring physics**: Use \`spring()\` for organic entrances instead of plain linear interpolation
-- **Color usage**: Read ALL colors from params (accentColor, textColor, backgroundColor) \u2014 never hardcode
-- **Entrance + exit**: Choreographed entrance sequence AND fade-out in final 15 frames
-- **Layered composition**: Multiple animated elements (text + accent line + shape + bg glow), not just a single element with opacity
-- **Typography**: Appropriate font from FONTS.*, proper letter-spacing, readable sizing
-- **Atmosphere**: Subtle glows, gradients, or accent color bleeds for depth
-
-## Component Contract
-
-- Signature: \`export default function Name({ durationInFrames, params }) { ... }\`
-- ONLY \`useCurrentFrame()\` and \`useVideoConfig()\` hooks. NO useEffect/useState/useMemo/useCallback/useRef.
-- Inline styles only. No imports, no CSS files, no \`document\` access. Max 10000 chars.
-- All animation driven by frame number.
-
-## Guidelines
-
-- Be specific in feedback: cite which element, which frame range, what to change.
-- Prefer refinement over complete rewrites \u2014 preserve the designer's intent.
-- A still cannot show motion. Judge timing and choreography from the source; judge
-  layout, contrast and legibility from the frame.
-- After fixing, always re-preview to confirm the improvement visually.
-`;
-var DESIGN_REVIEWER_TOOLS = [
-  "get_context",
-  "get_composition",
-  "get_component_source",
-  "preview_frame",
-  "apply_composition"
-];
-
 // ../authoring/src/prompts/graphics.ts
 var CODE_GEN_FEW_SHOT_EXAMPLES = `
 ## Reference Examples (study these patterns, then write your component)
@@ -189,22 +140,18 @@ export default function CinematicTitle({ durationInFrames, params }) {
   const subtext = params.subtext ?? '';
   const accentColor = params.accentColor ?? '#D4AF37';
   const barHeight = height * 0.13;
-  // Bars slide in first (frames 0-20)
   const barSlide = interpolate(frame, [0, 20], [barHeight, 0], {
     extrapolateLeft: 'clamp', extrapolateRight: 'clamp',
   });
-  // Title fades in after bars (frames 18-40), letter-spacing tightens
   const textFade = interpolate(frame, [18, 40], [0, 1], {
     extrapolateLeft: 'clamp', extrapolateRight: 'clamp',
   });
   const textSpacing = interpolate(frame, [18, 45], [20, 6], {
     extrapolateLeft: 'clamp', extrapolateRight: 'clamp',
   });
-  // Subtext arrives last (frames 35-55)
   const subtextFade = interpolate(frame, [35, 55], [0, 1], {
     extrapolateLeft: 'clamp', extrapolateRight: 'clamp',
   });
-  // Exit: fade out in final 20 frames
   const exitOpacity = interpolate(frame, [durationInFrames - 20, durationInFrames], [1, 0], {
     extrapolateLeft: 'clamp', extrapolateRight: 'clamp',
   });
@@ -238,14 +185,10 @@ export default function LowerThird({ durationInFrames, params }) {
   const frame = useCurrentFrame();
   const accent = params.accentColor ?? '#DB6452';
   const pos = params.position ?? 'left';
-  // Floor-assigned safe band (clear of captions + platform UI). NEVER hard-code
-  // bottom/top offsets \u2014 anchor to the region instead.
   const R = params.region ?? { x: 0, y: 0, w: 1, h: 1 };
-  // Responsive fade durations \u2014 Math.min prevents overrun on short overlays
   const fadeIn = Math.min(15, Math.floor(durationInFrames / 3));
   const fadeOut = Math.min(10, Math.floor(durationInFrames / 3));
   const slideIn = interpolate(frame, [0, fadeIn], [-100, 0], { extrapolateRight: 'clamp' });
-  // 4-point opacity: [enter, hold, hold, exit]
   const opacity = interpolate(frame,
     [0, fadeIn, Math.max(fadeIn, durationInFrames - fadeOut), durationInFrames],
     [0, 1, 1, 0],
@@ -281,20 +224,17 @@ export default function WaveText({ durationInFrames, params }) {
   const text = params.text ?? 'WAVE';
   const subtext = params.subtext ?? '';
   const accent = params.accentColor ?? '#F59E0B';
-  // Spring entrance \u2014 whole component fades/scales in
   const enterProgress = spring({ frame, fps, config: { damping: 14, stiffness: 120 } });
   const enterOpacity = interpolate(enterProgress, [0, 1], [0, 1]);
   const exitOpacity = interpolate(frame, [durationInFrames - 15, durationInFrames], [1, 0], {
     extrapolateLeft: 'clamp', extrapolateRight: 'clamp',
   });
   const chars = text.split('');
-  // Staggered subtext spring (delayed 12 frames)
   const subtextProgress = spring({ frame: Math.max(0, frame - 12), fps, config: { damping: 16, stiffness: 100 } });
   return (
     <AbsoluteFill style={{ justifyContent: 'center', alignItems: 'center', opacity: exitOpacity }}>
       <div style={{ display: 'flex', flexDirection: 'row', opacity: enterOpacity }}>
         {chars.map((char, i) => {
-          // Per-character wave: phase offset by index, continuous sine motion
           const wave = Math.sin(frame * 0.12 - i * 0.6) * 18;
           const rotation = Math.sin(frame * 0.1 - i * 0.5) * 8;
           return (
@@ -336,7 +276,6 @@ within this band. Wrap your root in a positioned container sized to the region:
     <div style={{ position: 'absolute', left: \`\${R.x*100}%\`, top: \`\${R.y*100}%\`,
       width: \`\${R.w*100}%\`, height: \`\${R.h*100}%\`,
       display: 'flex', alignItems: 'center', justifyContent: 'center' }}>
-      {/* your graphic */}
     </div>
   );
   \`\`\`
@@ -416,8 +355,6 @@ export {
   buildExecutionTask,
   buildPlannerUserMessage,
   PLANNING_INSTRUCTIONS,
-  DESIGN_REVIEWER_PROMPT,
-  DESIGN_REVIEWER_TOOLS,
   CODE_GEN_FEW_SHOT_EXAMPLES,
   COMPONENT_CONTRACT,
   TOOLKIT_REFERENCE,