@cueframe/kernel 0.1.1 → 0.1.3

package/dist/authoring/context.js

@@ -1,12 +1,12 @@
 import {
   buildDirectorContext
-} from "../chunk-AQBREB5O.js";
-import "../chunk-ZWMV6DD2.js";
+} from "../chunk-DWLNPNC4.js";
+import "../chunk-ICSZF37W.js";
 import "../chunk-KYRDKK2D.js";
-import "../chunk-TOJEXFXL.js";
-import "../chunk-PODIYN2K.js";
-import "../chunk-W35ZMOXB.js";
-import "../chunk-EA6MYCYW.js";
+import "../chunk-TFGKUWHY.js";
+import "../chunk-WZH57M53.js";
+import "../chunk-WPZKOVYF.js";
+import "../chunk-2B5VJZHL.js";
 import "../chunk-WREYUH2E.js";
 import "../chunk-2ESYSVXG.js";
 export {

package/dist/authoring/pipelineTrace.js

@@ -1,6 +1,6 @@
 import {
   PipelineTrace
-} from "../chunk-LD5ZOUFT.js";
+} from "../chunk-GF52TW4I.js";
 import "../chunk-2ESYSVXG.js";
 export {
   PipelineTrace

package/dist/authoring/prompts.js

@@ -2,8 +2,6 @@ import {
   CODE_GEN_FEW_SHOT_EXAMPLES,
   COMPONENT_CONTRACT,
   DESIGN_QUALITY_RULES,
-  DESIGN_REVIEWER_PROMPT,
-  DESIGN_REVIEWER_TOOLS,
   EVALUATOR_PROMPT,
   PLANNING_INSTRUCTIONS,
   TOOLKIT_REFERENCE,
@@ -11,14 +9,12 @@ import {
   buildPlannerUserMessage,
   formatPlanSteps,
   initCodeGenPrompts
-} from "../chunk-UY4SWJVE.js";
+} from "../chunk-HFC3MKXA.js";
 import "../chunk-2ESYSVXG.js";
 export {
   CODE_GEN_FEW_SHOT_EXAMPLES,
   COMPONENT_CONTRACT,
   DESIGN_QUALITY_RULES,
-  DESIGN_REVIEWER_PROMPT,
-  DESIGN_REVIEWER_TOOLS,
   EVALUATOR_PROMPT,
   PLANNING_INSTRUCTIONS,
   TOOLKIT_REFERENCE,

package/dist/authoring/resource-routing.js

@@ -5,7 +5,7 @@ import {
   searchSoundEffectsCandidates,
   searchStockPhotoCandidates,
   searchStockVideos
-} from "../chunk-ZE76SSRT.js";
+} from "../chunk-FMODQD5P.js";
 import "../chunk-2ESYSVXG.js";
 
 // ../authoring/src/resource-routing.ts

package/dist/authoring/resources.js

@@ -14,7 +14,7 @@ import {
   searchStockPhotos,
   searchStockVideos,
   trendingKlipy
-} from "../chunk-ZE76SSRT.js";
+} from "../chunk-FMODQD5P.js";
 import "../chunk-2ESYSVXG.js";
 export {
   popularPixabayPhotos,

package/dist/authoring/tools.js

@@ -6,16 +6,16 @@ import {
   COMPOSE_ROLE_TOOLS,
   COMPOSE_ROLE_TOOL_NAMES,
   dispatchComposeRoleTool
-} from "../chunk-PDYO3DOJ.js";
+} from "../chunk-BZZTVOGG.js";
 import "../chunk-JOURGVOR.js";
-import "../chunk-7FO3ZJ43.js";
-import "../chunk-ZWMV6DD2.js";
+import "../chunk-DCVJWGIA.js";
+import "../chunk-ICSZF37W.js";
 import "../chunk-7PA7FGLD.js";
 import "../chunk-KYRDKK2D.js";
-import "../chunk-TOJEXFXL.js";
-import "../chunk-PODIYN2K.js";
-import "../chunk-W35ZMOXB.js";
-import "../chunk-EA6MYCYW.js";
+import "../chunk-TFGKUWHY.js";
+import "../chunk-WZH57M53.js";
+import "../chunk-WPZKOVYF.js";
+import "../chunk-2B5VJZHL.js";
 import "../chunk-WREYUH2E.js";
 import "../chunk-2ESYSVXG.js";
 export {

package/dist/authoring.js

@@ -1,6 +1,6 @@
 import {
   buildDirectorContext
-} from "./chunk-AQBREB5O.js";
+} from "./chunk-DWLNPNC4.js";
 import {
   buildFastModel,
   buildModel,
@@ -8,13 +8,11 @@ import {
 } from "./chunk-ZT7MHRQU.js";
 import {
   PipelineTrace
-} from "./chunk-LD5ZOUFT.js";
+} from "./chunk-GF52TW4I.js";
 import {
   CODE_GEN_FEW_SHOT_EXAMPLES,
   COMPONENT_CONTRACT,
   DESIGN_QUALITY_RULES,
-  DESIGN_REVIEWER_PROMPT,
-  DESIGN_REVIEWER_TOOLS,
   EVALUATOR_PROMPT,
   PLANNING_INSTRUCTIONS,
   TOOLKIT_REFERENCE,
@@ -22,14 +20,14 @@ import {
   buildPlannerUserMessage,
   formatPlanSteps,
   initCodeGenPrompts
-} from "./chunk-UY4SWJVE.js";
+} from "./chunk-HFC3MKXA.js";
 import {
   ZERO_USAGE,
   buildDirectorTools,
   buildPlannerTools,
   buildToolsFromSchemas,
   extractProviderError
-} from "./chunk-UHGSZZDI.js";
+} from "./chunk-TPA6PYN2.js";
 import {
   COMPOSE_MOTION_TOOLS,
   COMPOSE_MOTION_VERIFY_TOOLS,
@@ -38,27 +36,27 @@ import {
   COMPOSE_ROLE_TOOLS,
   COMPOSE_ROLE_TOOL_NAMES,
   dispatchComposeRoleTool
-} from "./chunk-PDYO3DOJ.js";
+} from "./chunk-BZZTVOGG.js";
 import {
   AgentFixableCaptureError,
   getExcludedTools
 } from "./chunk-JOURGVOR.js";
-import "./chunk-7FO3ZJ43.js";
-import "./chunk-ZWMV6DD2.js";
+import "./chunk-DCVJWGIA.js";
+import "./chunk-ICSZF37W.js";
 import "./chunk-7PA7FGLD.js";
 import "./chunk-KYRDKK2D.js";
-import "./chunk-JJ6XD7NG.js";
+import "./chunk-GIA2SVVB.js";
 import {
   cssLayoutVars
-} from "./chunk-FYZVH3MC.js";
+} from "./chunk-YQ7FFW3G.js";
 import "./chunk-DSMLHYJ4.js";
 import "./chunk-JF4JJAFP.js";
-import "./chunk-TOJEXFXL.js";
-import "./chunk-PODIYN2K.js";
-import "./chunk-W35ZMOXB.js";
-import "./chunk-EA6MYCYW.js";
+import "./chunk-TFGKUWHY.js";
+import "./chunk-WZH57M53.js";
+import "./chunk-WPZKOVYF.js";
+import "./chunk-2B5VJZHL.js";
 import "./chunk-WREYUH2E.js";
-import "./chunk-OCFDUCF4.js";
+import "./chunk-AW57IWNW.js";
 import "./chunk-2ESYSVXG.js";
 
 // ../authoring/src/agent.ts
@@ -102,7 +100,6 @@ function buildPrepareStep(policy) {
       return {
         messages: pruneMessages({
           messages: withStubs,
-          // Effectively "never" — tool calls/results are managed above.
           toolCalls: `before-last-${99999}-messages`,
           reasoning: "before-last-message",
           emptyMessages: "remove"
@@ -115,9 +112,6 @@ function buildPrepareStep(policy) {
     messages: pruneMessages({
       messages,
       toolCalls,
-      // Coupled to tool-call pruning, never 'none': see pruneReasoning above —
-      // older turns lose thinking WHOLESALE (valid) instead of keeping a
-      // signed thinking block on a message whose tool_use was pruned (400).
       reasoning: "before-last-message",
       emptyMessages: "remove"
     })
@@ -208,8 +202,6 @@ Above are ${frames.length} captured frames. Use them to evaluate visual criteria
     schema: CriteriaEvaluationSchema,
     instructions: CRITERIA_EVALUATOR_PROMPT,
     messages: [{ role: "user", content: contentParts }],
-    // One verbose feedback string per criterion; an 8-9 criterion evaluation
-    // runs ~2.5-4k tokens. A tighter cap truncates the JSON mid-string.
     maxOutputTokens: 8e3
   });
   const criterionNames = Object.keys(criteria);
@@ -298,7 +290,6 @@ ${dimensionsText}${criteriaText}
 
 ARTIFACT TO EVALUATE:
 ${artifact}`,
-    // critique + evidence run long; a tighter cap truncates the JSON mid-string.
     maxOutputTokens: 8e3
   });
   return toEvaluationResult(object, rubric);
@@ -328,7 +319,6 @@ Above are ${capturedFrames.length} captured frames. Inspect for visual quality,
     schema: EvaluationSchema,
     instructions: EVALUATOR_PROMPT,
     messages: [{ role: "user", content: contentParts }],
-    // critique + evidence run long; a tighter cap truncates the JSON mid-string.
     maxOutputTokens: 8e3
   });
   return toEvaluationResult(object, rubric);
@@ -365,7 +355,6 @@ var Agent = class {
   messages = [];
   excludedTools;
   log;
-  /** Monotonic step index for onStepMetrics; reset per run(). */
   stepCounter = 0;
   constructor(config) {
     this.config = config;
@@ -382,17 +371,9 @@ var Agent = class {
       }
     };
   }
-  /** Reset conversation history (new session). */
   reset() {
     this.messages = [];
   }
-  /**
-   * Run the agent with a prompt.
-   *
-   * Without criteria/rubric: single generation pass.
-   * With criteria + maxAttempts > 1: generate → evaluate → refine loop (criteria mode).
-   * With rubric + maxAttempts > 1: generate → evaluate → refine loop (rubric mode).
-   */
   async run(prompt, opts = {}) {
     this.stepCounter = 0;
     const { criteria, rubric, maxAttempts = 1 } = opts;
@@ -407,7 +388,6 @@ var Agent = class {
     }
     return this.runWithCriteria(prompt, opts);
   }
-  // ── Quality loop: criteria mode (pass/fail per criterion) ──
   async runWithCriteria(prompt, opts) {
     const { criteria, maxAttempts = 1 } = opts;
     let bestResult;
@@ -459,7 +439,6 @@ var Agent = class {
     }
     return bestResult;
   }
-  // ── Quality loop: rubric mode (weighted numeric scoring) ──
   async runWithRubric(prompt, opts) {
     const { rubric, verificationCriteria = [], maxAttempts = 1 } = opts;
     let bestResult;
@@ -509,7 +488,6 @@ var Agent = class {
     }
     return bestResult;
   }
-  // ── Private: single execution pass ──
   async executeOnce(prompt, opts) {
     this.messages.push({ role: "user", content: prompt });
     const hasTools = !!this.capabilities;
@@ -518,7 +496,6 @@ var Agent = class {
     }
     return this.executeWithTools(prompt, opts);
   }
-  // ── Text-only execution (no capabilities) ──
   async executeText(_prompt, opts) {
     try {
       const cacheBreakpoint = {
@@ -558,7 +535,6 @@ var Agent = class {
       return { success: false, text: errMsg, attempts: 1, usage: ZERO_USAGE };
     }
   }
-  // ── Tool-based execution ──
   async executeWithTools(_prompt, opts) {
     const capabilities = this.capabilities;
     const context = buildDirectorContext(capabilities, { maxChars: 32e3 });
@@ -597,9 +573,6 @@ ${contextJson}
     const agent = new ToolLoopAgent({
       model: this.config.model,
       maxOutputTokens,
-      // Config uses a structural per-provider record (the nominal
-      // ProviderOptions type isn't re-exported by every ai@6 minor); derive
-      // the SDK's own type from the constructor so the cast tracks upgrades.
       ...this.config.providerOptions ? {
         providerOptions: this.config.providerOptions
       } : {},
@@ -611,17 +584,10 @@ ${contextJson}
         }
       },
       tools: wrappedTools,
-      // B6: halt on an infra-sentinel tool-error step (second condition) — the
-      // model cannot fix a dead scratch/session, so further steps are waste.
       stopWhen: [
         isStepCount(maxSteps),
         ({ steps }) => infraErrorFromSteps(steps) !== null
       ],
-      // Observability: log each step's tool calls so the agent's craft
-      // behaviour — which tools it invokes vs SKIPS — is visible in the worker
-      // logs instead of a ~100s black box between phases. Names only (args are
-      // verbose); enough to see the tool sequence (e.g. did it call
-      // set_crop_intents / enable_captions_behind_speaker / capture_frames).
       onStepEnd: (step) => {
         const names = (step.toolCalls ?? []).map((t) => t.toolName);
         this.log.info(`[agent] step tools=[${names.join(", ") || "none"}] finish=${step.finishReason ?? "?"}`);
@@ -646,16 +612,6 @@ ${contextJson}
           });
         }
       },
-      // Context management: evict stale tool content between steps so a long
-      // tool-heavy run (accumulating tool-results + base64 capture images)
-      // stays under the model's window. Off unless the caller sets a policy.
-      // The moving cache breakpoint applies only when eviction is OFF: the
-      // sliding prune window rewrites messages BEFORE the prior step's
-      // breakpoint each step, so stamped tail entries would be written at
-      // 1.25x and never read back — strictly worse than no stamp. (Possible
-      // follow-up: stamp the eviction boundary instead, whose pruned prefix
-      // is stable step-over-step.) See promptCache.ts for why the
-      // system-only breakpoint leaves image tool-results uncached.
       prepareStep: this.config.finalStepTools ? reserveFinalStep(
         this.config.contextManagement ? buildPrepareStep(this.config.contextManagement) : cachePrepareStep,
         maxSteps,
@@ -726,7 +682,6 @@ ${contextJson}
       return { success: false, text: errMsg, attempts: 1, usage: ZERO_USAGE };
     }
   }
-  // ── Hook wiring ──
   wrapToolsWithHooks(tools, beforeHook, afterHook) {
     if (!beforeHook && !afterHook) return tools;
     const wrapped = {};
@@ -768,7 +723,6 @@ ${contextJson}
     }
     return wrapped;
   }
-  // ── Evaluation ──
   async evaluateResult(result, task, criteria, _opts) {
     const evalModel = this.config.evaluationModel ?? this.config.model;
     const capabilities = this.capabilities;
@@ -810,7 +764,6 @@ ${contextJson}
       artifact: result.text
     });
   }
-  // ── Rubric-based evaluation ──
   async evaluateWithRubric(result, task, rubric, verificationCriteria, _opts) {
     const evalModel = this.config.evaluationModel ?? this.config.model;
     const capabilities = this.capabilities;
@@ -830,7 +783,6 @@ ${contextJson}
     }
     return evaluateArtifact(evalModel, result.text ?? "", task, rubric, verificationCriteria);
   }
-  // ── Refinement prompts ──
   buildRefinementPrompt(originalTask, evaluation, criteria) {
     const failedCriteria = evaluation.criteria.filter((c) => !c.passed).map((c) => {
       const desc = criteria[c.name] ?? "";
@@ -1097,21 +1049,11 @@ function generateMotionShell(cardHtml, opts) {
   const sustain = PRESET_SUSTAIN[opts.preset];
   const tokenVars = cssLayoutVars(opts.tokens, void 0);
   const staggerBlock = opts.preset === "stagger-reveal" ? `
-  // Per-child reveal + sustained breathing: values are computed from the
-  // CURRENT frame and emitted as static nth-child rules \u2014 legal under
-  // Remotion's seek-and-freeze (this is per-frame static CSS, not a CSS
-  // animation). Children live inside the verbatim markup's [data-stagger]
-  // container; extra rules no-op. Breathing gives each tile a phase-offset
-  // \xB1${STAGGER_BREATHE.amp}px float for the whole hold, so a revealed mosaic never freezes.
   const staggerF = Math.max(1, Math.round((${staggerMs} / 1000) * fps));
   const staggerRules = Array.from({ length: ${MAX_STAGGER_CHILDREN} }, (_, i) => {
     const s = enterF + i * staggerF;
     const o = interpolate(frame, [s, s + enterF], [0, 1], { extrapolateLeft: 'clamp', extrapolateRight: 'clamp' });
     const breathe = ${STAGGER_BREATHE.amp} * Math.sin((tSec / ${STAGGER_BREATHE.periodS}) * Math.PI * 2 + i * ${STAGGER_BREATHE.phase});
-    // 'translate' (the independent CSS property), NOT 'transform': this rule
-    // out-specifies any author class (0,2,0), so a transform here would
-    // clobber an author rotate/scale on the tile; the independent property
-    // composes with the author transform in Chromium.
     return '[data-stagger] > *:nth-child(' + (i + 1) + ') { opacity: ' + o + '; translate: 0 ' + breathe.toFixed(3) + 'px; }';
   }).join('\\n');` : "";
   const staggerStyleEl = opts.preset === "stagger-reveal" ? `<style>{staggerRules}</style>` : "";
@@ -1128,10 +1070,6 @@ export default function CardMotionShell({ durationInFrames, params }) {
     [Math.max(enterF + 1, durationInFrames - exitF), durationInFrames], [1, 0],
     { easing: Easing.in(Easing.cubic), extrapolateLeft: 'clamp', extrapolateRight: 'clamp' });
   const opacity = Math.min(enter, exit);
-  // SUSTAIN: post-entrance micro-motion for the full remaining clip. 'hold'
-  // runs 0\u21921 linearly from entrance-end to the last frame (linear on purpose \u2014
-  // constant perceived velocity = ambient life); tSec is seconds since the
-  // entrance completed (drives the settle wobble / breathing phases).
   const hold = interpolate(frame, [enterF, durationInFrames], [0, 1],
     { extrapolateLeft: 'clamp', extrapolateRight: 'clamp' });
   const tSec = Math.max(0, frame - enterF) / fps;
@@ -1187,13 +1125,7 @@ function resolveMotionPresetCard(composition, input) {
   }
   return {
     cardHtml: clip.source.html,
-    // The card's token layer rides with the markup — generateMotionShell bakes
-    // it as `--cf-*` vars so the shelled card keeps the values it was authored
-    // against (the custom render lane applies no token vars).
     ...clip.source.tokens !== void 0 ? { tokens: clip.source.tokens } : {},
-    // Depth rides through the shell: a behind-subject card must stay behind
-    // after the source swap, or the preset silently pops it in front of the
-    // subject (2026-08-10 issue — the sink's whole-source replace dropped it).
     ...clip.source.zPlane !== void 0 ? { zPlane: clip.source.zPlane } : {}
   };
 }
@@ -1252,8 +1184,6 @@ export {
   COMPOSE_ROLE_TOOLS,
   COMPOSE_ROLE_TOOL_NAMES,
   DESIGN_QUALITY_RULES,
-  DESIGN_REVIEWER_PROMPT,
-  DESIGN_REVIEWER_TOOLS,
   EVALUATOR_PROMPT,
   MOTION_PRESETS,
   MotionPresetError,

package/dist/{chunk-TWQOKKAF.js → chunk-23HFEKV7.js}

@@ -411,8 +411,6 @@ function projectChild(child, compound, source) {
         duration,
         source: windowedSource(clip, headDelta, duration),
         ...clip.animate ? { animate: windowedAnimate(clip, headDelta, duration) } : {},
-        // A child's link group must not merge with an identically-named one in
-        // the host or a sibling instance — scope it like the ids.
         ...clip.linkGroupId ? { linkGroupId: `${compound.id}:${clip.linkGroupId}` } : {}
       };
       contents.push(projected);
@@ -480,8 +478,6 @@ function planSlip(composition, clipId, deltaSeconds, sourceDuration) {
     clipId,
     trackKind: ctx.trackKind,
     patch: {
-      // startTime and duration are DELIBERATELY absent: that is what makes this
-      // a slip rather than a move.
       source: { ...source, trim: { ...source.trim, start, end } }
     }
   });
@@ -592,7 +588,6 @@ function planSlide(composition, clipId, deltaSeconds, sourceDurations) {
       op: "updateClip",
       clipId,
       trackKind: ctx.trackKind,
-      // Content untouched — only where it sits.
       patch: { startTime: ctx.clip.startTime + deltaSeconds }
     },
     {
@@ -703,7 +698,6 @@ function expandMovesToLinkGroups(composition, moves, clipsById) {
       named.add(partnerId);
       out.push({
         clipId: partnerId,
-        // The partner keeps its own lane — linking couples TIME, not track.
         toTrackId: trackIdOf(composition, partnerId) ?? move.toTrackId,
         startTime: Math.max(0, partner.startTime + delta),
         duration: partner.duration

package/dist/{chunk-EA6MYCYW.js → chunk-2B5VJZHL.js}

@@ -14,20 +14,21 @@ function collectMediaClips(value, nearestId, out) {
   }
   if (value === null || typeof value !== "object") return;
   const obj = value;
+  if (obj.enabled === false && Array.isArray(obj.contents)) return;
   const id = typeof obj.id === "string" ? obj.id : nearestId;
   if (obj.kind === "media" && typeof obj.mediaId === "string") {
     const reframe = obj.reframe;
     const hasReframe = Array.isArray(reframe?.segments) && reframe.segments.length > 0;
     out.push({
       mediaId: obj.mediaId,
-      hasCamera: hasReframe || obj.kenBurns != null,
+      hasCamera: hasReframe || obj.kenBurns != null && obj.kenBurns !== "none",
       ...id !== void 0 ? { clipId: id } : {}
     });
     return;
   }
   for (const v of Object.values(obj)) collectMediaClips(v, id, out);
 }
-function detectAspectCropLoss(composition, dimensionsByMediaId, target) {
+function findAspectCropLosses(composition, dimensionsByMediaId, target) {
   const placed = [];
   collectMediaClips(composition, void 0, placed);
   if (placed.length === 0) return [];
@@ -42,11 +43,19 @@ function detectAspectCropLoss(composition, dimensionsByMediaId, target) {
     const label = clip.clipId ?? clip.mediaId;
     if (seen.has(label)) continue;
     seen.add(label);
-    offenders.push({ label, lostPct: Math.round((1 - visible) * 100) });
+    offenders.push({
+      ...clip.clipId ? { clipId: clip.clipId } : {},
+      mediaId: clip.mediaId,
+      lostPct: Math.round((1 - visible) * 100)
+    });
   }
+  return offenders;
+}
+function detectAspectCropLoss(composition, dimensionsByMediaId, target) {
+  const offenders = findAspectCropLosses(composition, dimensionsByMediaId, target);
   if (offenders.length === 0) return [];
   const worst = offenders.reduce((a, b) => b.lostPct > a.lostPct ? b : a);
-  const shown = offenders.slice(0, MAX_NAMED).map((o) => `${o.label} (\u2212${o.lostPct}%)`).join(", ");
+  const shown = offenders.slice(0, MAX_NAMED).map((o) => `${o.clipId ?? o.mediaId} (\u2212${o.lostPct}%)`).join(", ");
   const elided = offenders.length > MAX_NAMED ? ` (+${offenders.length - MAX_NAMED} more)` : "";
   return [
     `aspect_crop_loss \u2014 ${offenders.length} clip${offenders.length === 1 ? "" : "s"} ${offenders.length === 1 ? "is" : "are"} shaped very differently from the ${target.width}\xD7${target.height} output and author no camera, so each is centre-cropped to fill \u2014 discarding up to ${worst.lostPct}% of the picture with faces and subjects as likely to fall outside the crop as inside it: ${shown}${elided}. Author a \`reframe\` (focus a face, a point, or all-faces) or a \`kenBurns\` move on these clips, or render a format closer to their shape. Note \`fit:"contain"\` does NOT avoid this for stills \u2014 images are cropped by the still trajectory, which centres when it has no focus.`
@@ -73,32 +82,21 @@ var ReframeSegmentFields = z.object({
   endSec: z.number().positive().describe(
     "Segment END in seconds, clip-relative. The span (endSec \u2212 startSec) is this segment's duration \u2014 the window `ease` ramps over."
   ),
-  /** WHO/WHAT the camera tracks — see the `.describe()` for per-mode guidance. */
   focus: Focus.describe(
     "WHO/WHAT the camera tracks this segment (the reframe center), selected by `mode`: `frame-center` = no tracking, hold the geometric center (static/graphic footage, or a pure zoom); `point` = lock to a fixed source-normalized {x,y} (a non-moving on-screen element); `face` = track a detected face by `faceId` (from get_media_context), with optional `shotScale` close|standard|wide for tightness; `all-faces` = frame the bounding box of every detected face (group/ensemble shots); `active-speaker` = follow whoever is speaking (diarized talking-head / podcast). Pick by what the beat is about; pair with `zoom` for how tight."
   ),
-  /** Editorial language for diff/log readability ("speaker-tight",
-   *  "wide-context", "interviewer-reaction"). Not honored by the derive math
-   *  — a relabel must not bust the variant cache, so it is EXCLUDED from
-   *  `hashReframe`. */
   intent: z.string().optional().describe(
     "Optional editorial LABEL for diff/log readability (e.g. 'speaker-tight', 'wide-context'). Cosmetic \u2014 NOT honored by the derive math and excluded from the variant cache key."
   ),
-  /** <1 punches in; 1 = full frame. Omitted when `focus.shotScale` governs — the
-   *  two are MUTUALLY EXCLUSIVE (see the refine below). Absent = 1 (full frame),
-   *  which is how `hashReframe` has always canonicalized it. */
   zoom: z.number().min(0.1).max(1).optional().describe(
     "How TIGHT the framing is \u2014 the fraction of the source the output viewport shows. <1 punches IN (a smaller source fraction, magnified to fill the frame); 1 = the full frame (no crop). ~0.6\u20130.8 is a moderate push-in, ~0.5 a tight close-up, 0.1 the maximum zoom. There is NO zoom-OUT past the full frame (max 1). Omit for the full frame. MUTUALLY EXCLUSIVE with `focus.shotScale`: a face-tracked shot is sized EITHER by the editorial scale (shotScale, calibrated to the detected face) OR by an explicit zoom \u2014 never both."
   ),
-  /** Ease-in / ease-out durations (seconds) for the zoom ramp at this segment's
-   *  edges. Honored at derive time (baked into the per-frame channel). */
   ease: z.object({
     in: z.number().nonnegative().describe("Ease-IN ramp DURATION in seconds at the segment START."),
     out: z.number().nonnegative().describe("Ease-OUT ramp DURATION in seconds at the segment END.")
   }).optional().describe(
     "Zoom/center ramp DURATIONS in SECONDS at this segment's edges \u2014 NOT a unitless 0\u20131 curve. ~0.3\u20130.6s reads as a snappy push; >1s reads sluggish. Keep `in` + `out` \u2264 the segment's duration (endSec \u2212 startSec): the two edges share the span, so to ramp across the WHOLE segment set one edge to the full duration and the other to 0. Omit for an instant cut to this framing."
   ),
-  /** Optional fine framing nudge, source-normalized [-0.3,0.3]. */
   bias: z.object({
     x: z.number().min(-0.3).max(0.3).describe("Horizontal nudge, source-normalized (+ = right)."),
     y: z.number().min(-0.3).max(0.3).describe("Vertical nudge, source-normalized (+ = down).")
@@ -107,16 +105,6 @@ var ReframeSegmentFields = z.object({
   )
 });
 var ReframeSegment = ReframeSegmentFields.refine(
-  // ONE knob sizes the crop. `shotScale` and `zoom` both do, and the bake gives
-  // shotScale precedence (calibrateShotScale takes zoom only as a FALLBACK) — so a
-  // segment carrying both SILENTLY discards the zoom. That is how a stored
-  // composition came to claim `zoom: 1` (full frame) on a segment the renderer
-  // punched in to 0.55: reading the artifact said "no zoom" while the render
-  // plainly zoomed (2026-07-13). The state is incoherent, so make it
-  // unrepresentable — here, at the wire shape, not just at the authoring tools.
-  //
-  // Rows written before compile stopped stamping `zoom: 1` are MIGRATED (convex
-  // migrations: dropZoomUnderShotScale), not tolerated.
   (s) => !(s.focus.mode === "face" && s.focus.shotScale !== void 0 && s.zoom !== void 0),
   {
     message: "a face segment takes EITHER focus.shotScale (editorial scale, calibrated to the detected face) OR an explicit zoom \u2014 never both; shotScale wins at bake time and the zoom would be silently discarded",
@@ -127,6 +115,7 @@ var Reframe = z.object({ segments: z.array(ReframeSegment).min(1) });
 
 export {
   coverVisibleFraction,
+  findAspectCropLosses,
   detectAspectCropLoss,
   Focus,
   ReframeSegmentFields,