@cueframe/kernel 0.1.1 → 0.1.2

package/dist/{chunk-TOJEXFXL.js → chunk-TFGKUWHY.js}

@@ -3,7 +3,7 @@ import {
   Copy,
   Format,
   GraphicRole
-} from "./chunk-PODIYN2K.js";
+} from "./chunk-WZH57M53.js";
 
 // ../composition/src/validators/composePlan.ts
 import { z } from "zod";
@@ -28,7 +28,6 @@ var PlanFramingSegment = z.object({
   shotScale: z.enum(["close", "standard", "wide"]).optional(),
   zoomScale: z.number().min(0.4).max(1).optional(),
   verticalBias: z.number().min(-0.3).max(0.3).optional(),
-  /** Optional in the plan; the assembler defaults it to 0 on set_crop_intents. */
   lateralBias: z.number().min(-0.3).max(0.3).optional(),
   intent: z.string().optional()
 }).refine((s) => s.action !== "frame" || s.subject !== void 0, {
@@ -51,9 +50,6 @@ var PlanAssetRequest = z.object({
   kind: z.enum(["broll", "audio", "sfx", "music", "ambience", "gif", "image"]),
   source: z.enum(["find", "generate"]),
   intent: z.string().min(1),
-  /** Phase 1: the planner resolves `find` requests against the pool at plan
-   *  time (it has search_library) and records the pick here. Unresolved find
-   *  requests are stripped by the validator (degrade, not error). */
   resolvedMediaId: z.string().optional()
 });
 var PlanGraphicRequest = z.object({
@@ -117,7 +113,6 @@ var Colors = z2.object({
   text: z2.string().min(1),
   textMuted: z2.string().optional(),
   border: z2.string().optional(),
-  // Tier-2 core — author overrides for the derived fills + paired foregrounds.
   surface: z2.string().optional(),
   card: z2.string().optional(),
   gridLine: z2.string().optional(),
@@ -144,8 +139,6 @@ var Sizing = z2.object({
 var Motion = z2.object({
   duration: z2.number().positive().optional(),
   easing: EasingValue.optional(),
-  // Editorial motion identity — surfaces read these via `$brand:motion.*`
-  // (resolved at projection time). Mirrors the primitive `TextMotion` vocabulary.
   entrance: z2.enum(["none", "fade", "word-pop", "stagger-up"]).optional(),
   staggerMs: z2.number().nonnegative().optional(),
   exitMs: z2.number().nonnegative().optional()
@@ -155,8 +148,6 @@ var Logo = z2.object({
   src: z2.string().min(1),
   alt: z2.string().optional(),
   placement: Placement.optional(),
-  // Percentage of the composition width. Must be positive — a non-positive
-  // logo is a footgun, not an intent, so reject at the boundary.
   sizePct: z2.number().positive().optional()
 });
 var IntroOutro = z2.object({
@@ -168,7 +159,6 @@ var IntroOutro = z2.object({
 });
 var Watermark = z2.object({
   src: z2.string().min(1),
-  // Alpha in [0,1]; anything outside is a malformed kit, not a clamp target.
   opacity: z2.number().min(0).max(1).optional(),
   placement: Placement.optional()
 });
@@ -207,11 +197,6 @@ var Motif = z2.object({
     staggerMs: z2.number().int().min(0).max(2e3).optional(),
     confidence: z2.enum(["high", "low"]).optional()
   }).optional(),
-  // Pinned to the closed graphics-plan GraphicRole vocabulary — the steering
-  // matcher (designBrief.ts) is exact-equality against a plan role, so an
-  // off-vocabulary role would synthesize a judge and then silently never steer
-  // (the half-applied-conditioning failure D1-R exists to kill). Storage stays
-  // an open string (matches the motion.preset pattern).
   role: GraphicRole,
   zone: z2.object({ x: z2.number(), y: z2.number(), w: z2.number(), h: z2.number() }).optional(),
   evidence: z2.array(z2.number().int().min(0)).max(24).optional(),
@@ -237,49 +222,26 @@ var BrandKit = z2.object({
   spacing: Spacing.optional(),
   sizing: Sizing.optional(),
   motion: Motion.optional(),
-  // Per-creator caption IDENTITY collected by the dashboard / derived from a
-  // creator's references. Consumed by resolveBrandKit's caption derivation:
-  // emphasisColor → caption.fg, base/highlight color (clamped to the APCA body
-  // floor over the scrim), the backdrop `plate` treatment, per-word `entrance`
-  // motion + timing, and the emphasis treatment (base face + serif/scale/weight/
-  // italic/transform/letter-spacing + emphasis-run plate) → caption identity
-  // that the render binding applies onto the Captions primitive. The kit now
-  // owns the caption LOOK (including plate + entrance). Base GEOMETRY (caption
-  // size, screen position, safe-area, maxWidth) is NOT here — that is calibrated
-  // craft owned by the primitive's default. The kit selects the LOOK; the
-  // primitive owns the legible realization.
   captionProfile: z2.object({
-    // Base caption text color + spoken-word highlight — clamped to the APCA
-    // body floor over the scrim at projection (same guard as emphasisColor→fg).
     color: z2.string().optional(),
     highlightColor: z2.string().optional(),
     emphasisColor: z2.string().optional(),
-    // Caption backdrop plate — the whole-block legibility treatment.
     plate: z2.enum(["glass", "solid", "none"]).optional(),
-    // Per-word entrance motion + timing (the shared TextMotion vocabulary).
     entrance: z2.enum(["none", "fade", "word-pop", "stagger-up"]).optional(),
     entranceMs: z2.number().optional(),
     entranceStaggerMs: z2.number().optional(),
     exitMs: z2.number().optional(),
-    // Base caption face (the carrier-word font). Defaults to fonts.caption.
     fontFamily: z2.string().optional(),
-    // Emphasis-word treatment — the qualitative identity signal.
     emphasisFontFamily: z2.string().optional(),
     emphasisScale: z2.number().positive().optional(),
     emphasisFontWeight: z2.number().optional(),
     emphasisFontStyle: z2.enum(["normal", "italic"]).optional(),
     emphasisTextTransform: z2.enum(["none", "uppercase"]).optional(),
     emphasisLetterSpacing: z2.number().optional(),
-    // Emphasis-run highlighter plate (editorial caption look).
     emphasisPlate: z2.boolean().optional(),
     emphasisPlateColor: z2.string().optional(),
     emphasisPlateTextColor: z2.string().optional()
   }).optional(),
-  // ── Language payload (built FROM INSPIRATION) ─────────────────────────────
-  // Carried untransformed onto the wire kit so the projection (resolveBrandKit)
-  // can surface it as `ResolvedBrandKit.language`. Not a `$brand:` token root —
-  // these are exemplar/motif references the maker + judge condition on, not
-  // bindable design tokens.
   exemplarKeys: z2.array(z2.string().min(1)).max(24).optional(),
   contactSheetKey: z2.string().min(1).optional(),
   motifs: z2.array(Motif).max(24).optional(),
@@ -297,32 +259,15 @@ var BrandKit = z2.object({
   intro: IntroOutro.optional(),
   outro: IntroOutro.optional(),
   watermark: Watermark.optional(),
-  /** Brand audio identity (audio design spec 2026-07-20): default SFX intensity
-   *  + music-bed defaults. Brief `audio` wins when present (caption-identity
-   *  precedence: brand default beats brief absence; brief beats brand).
-   *
-   *  Brand SOUND kit (audio-substrate Phase 5) — identity over TIME. All four
-   *  fields are OPTIONAL; a kit that sets none behaves byte-identically to a kit
-   *  with no audio block. Refs are palette references (P2 AudioPaletteEntry.ref:
-   *  a pack soundId | music-pack bedId | org mediaId — an opaque string handle). */
   audio: z2.object({
     sfxIntensity: z2.enum(["off", "light", "standard", "dense"]).optional(),
     musicEnabled: z2.boolean().optional(),
     musicMood: z2.string().max(300).optional(),
-    /** SONIC LOGO — a brand audio signature bound to the intro/outro bookend at
-     *  compose time (an sfx-role clip at the body edge adjacent to the render
-     *  bookend). `ref` = a palette reference; `placement` = which bookend(s);
-     *  `offsetMs` shifts within. Bound only when the corresponding bumper
-     *  (kit.intro / kit.outro) exists — else a non-blocking advisory. */
     sonicLogo: z2.object({
       ref: AudioPaletteRef,
       placement: z2.enum(["intro", "outro", "both"]),
       offsetMs: z2.number().int().min(0).max(1e4).optional()
     }).optional(),
-    /** UI SOUND SET — per-family palette overrides consumed by the sfxCompile
-     *  org-first draw as the HIGHEST-priority tier (brand > org palette > pack
-     *  default), mirroring how a brand FONT sits above org defaults. Keys are the
-     *  closed SfxFamily vocabulary; values are palette refs. */
     uiSoundSet: z2.object({
       tick: AudioPaletteRef.optional(),
       pop: AudioPaletteRef.optional(),
@@ -332,19 +277,11 @@ var BrandKit = z2.object({
       whoosh: AudioPaletteRef.optional(),
       riser: AudioPaletteRef.optional()
     }).optional(),
-    /** BED STYLE — a preferred pack bed (`bedId`) or a style hint (`genre` /
-     *  `bpmRange`). SURFACED-ONLY today (compose does not auto-select a pack bed
-     *  — it uses a client-pinned bed or generates from mood); the field resolves
-     *  through the kit + surfaces via get_profile / brand-kit reads so driving
-     *  agents honor it when pinning / generating a bed. */
     bedStyle: z2.object({
       bedId: AudioPaletteRef.optional(),
       genre: z2.string().max(120).optional(),
       bpmRange: z2.object({ min: z2.number(), max: z2.number() }).optional()
     }).optional(),
-    /** AMBIENCE PREFERENCE — a preferred ambience bed (`{ref}`) or explicit
-     *  `null` (opt-out). SURFACED-ONLY (compose has no ambience auto-placement);
-     *  resolves + surfaces for driving agents. */
     ambiencePreference: z2.object({ ref: AudioPaletteRef }).nullable().optional()
   }).optional(),
   license: LicenseDeclaration.optional(),
@@ -506,9 +443,6 @@ var RenderJob = z4.object({
   destinations: z4.array(Destination).optional(),
   destinationResults: z4.array(DestinationResult).optional(),
   cancelReason: RenderCancelReason.optional(),
-  // `error` is structured (richer than the doc's plain-string spec) so the worker
-  // can surface a stable code, a human message, and operator-visible details.
-  // See CONVEX_ADAPTATIONS.md for the rationale on richer-than-doc shapes.
   error: z4.object({
     code: z4.string(),
     message: z4.string(),
@@ -574,20 +508,9 @@ import { zid as zid3 } from "convex-helpers/server/zod3";
 var Project = z6.object({
   id: zid3("projects"),
   name: z6.string().min(1),
-  // Default format applied to new Compositions created under this Project.
-  // Each Composition still carries its own Format — this is just the seed.
   defaultFormat: Format.optional(),
-  // PAL-region fps conform default. See data-model.md § MediaItem for the table.
-  // 'palConformDefault: 24' makes 25fps PAL footage conform to 24 instead of 30.
   palConformDefault: z6.union([z6.literal(24), z6.literal(30)]).optional(),
-  // Pointer to the currently-active Composition for this Project. Edits land
-  // on a new CompositionVersion each PUT; this pointer advances to the new
-  // version's id. Nullable when the Project has no active Composition (e.g.,
-  // immediately after creation, or after the active composition was hard-deleted).
   activeCompositionId: zid3("compositions").nullable().optional(),
-  // Stable external `kitId` STRING (the v1 brand-kits API id), not a strict
-  // `zid("brandKits")`. Resolved org-scoped at render by either kitId or the
-  // legacy convex `_id`. Keeps the brand reference consistent end-to-end (#33).
   brandKitId: z6.string().optional(),
   ownerOrgId: z6.string().optional(),
   createdAt: z6.number(),
@@ -628,13 +551,9 @@ var Session = z7.object({
 import { z as z8 } from "zod";
 import { zid as zid5 } from "convex-helpers/server/zod3";
 var SubstrateWebhookEvent = z8.enum([
-  // Render lifecycle — A3 terminal family (plan 2026-07-10-flow-checkpoint):
-  // ONE terminal event per kind, `status` INSIDE the payload.
   "render.completed",
-  // MediaItem lifecycle
   "media.transcribed",
   "media.completed",
-  // Composition lifecycle
   "composition.updated"
 ]);
 var WebhookDeliveryStatus = z8.enum([
@@ -648,13 +567,8 @@ var WebhookDeliveryStatus = z8.enum([
 var Webhook = z8.object({
   id: zid5("webhooks"),
   url: z8.string().url(),
-  // Open string array — substrate event names live in SubstrateWebhookEvent;
-  // domain packages export their own event enums and consumers compose them.
   events: z8.array(z8.string().min(1)).nonempty(),
-  // Standard Webhooks signing key reference; the signing secret itself is
-  // stored server-side and never round-tripped through the API surface.
   signingKeyId: z8.string().optional(),
-  // Optional headers the subscriber wants on every delivery.
   headers: z8.record(z8.string(), z8.string()).optional(),
   enabled: z8.boolean().optional(),
   ownerOrgId: z8.string().optional(),
@@ -664,7 +578,6 @@ var Webhook = z8.object({
 var WebhookDelivery = z8.object({
   id: z8.string().min(1),
   webhookId: zid5("webhooks"),
-  // Open string — could be any substrate or domain event name.
   event: z8.string().min(1),
   payload: z8.record(z8.string(), z8.unknown()),
   status: WebhookDeliveryStatus,

package/dist/{chunk-UHGSZZDI.js → chunk-TPA6PYN2.js}

@@ -2,7 +2,7 @@ import {
   COMPOSE_PLANNER_TOOLS,
   COMPOSE_ROLE_TOOLS,
   dispatchComposeRoleTool
-} from "./chunk-PDYO3DOJ.js";
+} from "./chunk-BZZTVOGG.js";
 
 // ../authoring/src/agent/buildTools.ts
 import { tool } from "ai";
@@ -119,16 +119,6 @@ function buildToolsFromSchemas(params) {
           return JSON.stringify({ error: errMsg });
         }
       },
-      // toModelOutput is the ONLY place a tool result becomes a real vision
-      // block. Returning the {type:'content',[media]} shape from execute makes
-      // the AI SDK JSON-stringify it (base64 -> ~50k TEXT tokens/image ->
-      // instant 200k overflow on capture, and the model can't actually SEE the
-      // image). Here capture_frames becomes proper image blocks (~1.6k vision
-      // tokens, viewable); everything else stays text/json.
-      // v7 hands `input` as `unknown` (it no longer narrows from the schema at
-      // this dynamic registry). Annotating the full parameter keeps this
-      // assignable — a function taking a NARROWER input than the SDK passes is
-      // not, which is what the v6 shape silently was.
       toModelOutput: ({ output }) => {
         const formatted = formatToolResult(name, output);
         return typeof formatted === "string" ? { type: "text", value: formatted } : formatted;

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-MBCXCJOE.js → chunk-VFMW3JUY.js}

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

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

@@ -20,15 +20,15 @@ import {
   scoreAndRank,
   segmentShots,
   stabilizeSelectionHysteresis
-} from "./chunk-HY3RIEZW.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-OCFDUCF4.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 ?? {},
@@ -397,9 +395,6 @@ function projectMediaTrack(track, fps, srcUrls, trajectoryUrls, coViewUrls, traj
         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,44 +404,14 @@ function projectMediaTrack(track, fps, srcUrls, trajectoryUrls, coViewUrls, traj
         ...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] } : {},
-        // The same trajectory IN MEMORY — the editor's path. It derives the
-        // trajectory client-side from the presigned subject track on the media
-        // row, so there is no object to fetch. Keyed by the PARENT wire-clip id
-        // for the same reason the URL map is. See `CompositionClip.cropTrajectory`.
         ...trajectories?.[c.id] !== void 0 ? { cropTrajectory: trajectories[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).
         ...coViewUrls?.[c.source.mediaId] !== void 0 ? { packedUrl: coViewUrls[c.source.mediaId] } : {}
       });
     }
@@ -494,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 } : {}
     });
@@ -621,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),
@@ -855,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 } : {},
@@ -876,22 +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 } : {},
-    // Depth for the caption layer. Only meaningful alongside captions, so it is
-    // emitted with them — a `captionsBehind` on a composition with no caption
-    // words would be a flag describing nothing.
     ...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) {
@@ -940,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;
@@ -1725,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
     );
@@ -1812,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,
@@ -1823,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 } : {}
       });
     }
@@ -1921,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,