@cueframe/kernel 0.1.0 → 0.1.2

package/dist/_members/compose/sceneToRenderInput.d.ts

@@ -2,26 +2,16 @@ import type { Scene, GlobalEffects, AudioTrackConfig } from './schema.js';
 import type { SceneComposition } from './schema.js';
 import { type TokenSet } from './tokenResolver.js';
 import { type ResolvedBrandKit } from '../core/render/index.js';
-/**
- * The slice of the resolved brand kit the scene timeline needs to size its
- * bookends — the SAME shape `resolveBookendTimeline` (clips path) reads. The
- * full `ResolvedBrandKit` (with `intro`/`outro`) is a superset.
- */
 export type SceneBookendKit = {
     intro?: ResolvedBrandKit['intro'];
     outro?: ResolvedBrandKit['outro'];
 };
-/** Per-scene frame data for the renderer. */
 export interface SceneFrameData {
     scene: Scene;
-    /** Frame offset where this scene starts in the composition */
     startFrame: number;
-    /** Duration of this scene in frames */
     durationInFrames: number;
-    /** If this scene has a transition, the overlap in frames with the previous scene */
     transitionDurationInFrames: number;
 }
-/** Frame-accurate render input for CompositionRenderer. */
 export interface SceneRenderInput {
     fps: number;
     width: number;
@@ -32,20 +22,4 @@ export interface SceneRenderInput {
     audio?: AudioTrackConfig[];
     tokens: TokenSet;
 }
-/**
- * Convert a SceneComposition to a SceneRenderInput.
- *
- * Calculates total duration accounting for transition overlaps:
- * each scene after the first that has a transition subtracts
- * transition.duration from the total.
- *
- * Brand BOOKENDS: when the resolved `brandKit` carries an `intro`/`outro`
- * bumper, the registered `durationInFrames` extends by intro + outro (the SAME
- * fps-driven `resolveBookendTimeline` math the clips path uses in
- * `compositionToRenderInput`) so the total reflects the bumpers MainComposition
- * places. The PER-SCENE layout (`startFrame`/`durationInFrames`) is left at the
- * body offsets — MainComposition's `withBookends` shifts the body inside one
- * Sequence; folding the intro into scene offsets here would double-count it.
- * SOFT: an absent/odd/srcless bumper reserves 0 frames → total unchanged.
- */
 export declare function sceneToRenderInput(composition: SceneComposition, brandKit?: SceneBookendKit): SceneRenderInput;

package/dist/_members/compose/schema.d.ts

@@ -2,20 +2,13 @@ import type { Scene as _Scene, GlobalEffects as _GlobalEffects } from '../compos
 export type { Scene, ContentSource, EffectConfig, TextConfig, TextEffectConfig, TransitionConfig, LayoutConfig, GlobalEffects, } from '../composition/ops/index.js';
 type Scene = _Scene;
 type GlobalEffects = _GlobalEffects;
-/** Configuration for an audio track in the composition. */
 export interface AudioTrackConfig {
-    /** URL or path to the audio file */
     src: string;
-    /** Volume 0-1 (default 1) */
     volume?: number;
-    /** Fade-in duration in seconds */
     fadeIn?: number;
-    /** Fade-out duration in seconds */
     fadeOut?: number;
-    /** Start offset in seconds from the beginning of the composition */
     startAt?: number;
 }
-/** Overrides for design tokens — colors, fonts, spacing. */
 export interface TokenOverrides {
     accent?: string;
     primary?: string;
@@ -26,20 +19,12 @@ export interface TokenOverrides {
     bodyFont?: string;
     [key: string]: unknown;
 }
-/** A complete scene-based composition ready for rendering. */
 export interface SceneComposition {
-    /** Frames per second */
     fps: number;
-    /** Canvas width in pixels */
     width: number;
-    /** Canvas height in pixels */
     height: number;
-    /** Ordered list of scenes */
     scenes: Scene[];
-    /** Optional background audio tracks */
     audio?: AudioTrackConfig[];
-    /** Optional global effects applied to the entire composition */
     global?: GlobalEffects;
-    /** Optional design token overrides */
     tokens?: TokenOverrides;
 }

package/dist/_members/compose/tokenResolver.d.ts

@@ -1,5 +1,4 @@
 import type { TokenOverrides } from './schema.js';
-/** Resolved design token set. */
 export interface TokenSet {
     primary: string;
     secondary: string;
@@ -15,14 +14,4 @@ export interface TokenSet {
     fontSize: number;
     fontSizeBody: number;
 }
-/**
- * Resolve a complete TokenSet from optional overrides and canvas width.
- *
- * Responsive spacing is calculated as a proportion of width:
- * - spacing: width * 0.03
- * - spacingLg: width * 0.05
- * - spacingSm: width * 0.015
- * - fontSize: width * 0.04
- * - fontSizeBody: width * 0.02
- */
 export declare function resolveTokens(overrides?: TokenOverrides, width?: number): TokenSet;

package/dist/_members/composition/audio/audioMix.d.ts

@@ -1,45 +1,18 @@
-/**
- * AUDIO_MIX — the one SSOT for audio design policy (spec 2026-07-20
- * time-synced-sfx-audio-design §5). Consumed by the director's sfxCompile
- * (placement) AND the evaluation audio floors (grading) so the resolver and the
- * grader can never disagree on what "too dense" means.
- *
- * The content-kind split is the restraint rule: real footage (a transcript with
- * words exists) gets the left column BY CONSTRUCTION — podcasts / talking-head
- * content cannot be opted into generated-tier density except via the explicit
- * `dense` intensity.
- */
-/** How the compose classifies the content for audio policy. */
 export type AudioContentKind = "real-footage" | "generated";
-/** SFX placement intensity (brief `audio.sfx.intensity` / brand `sfxIntensity`). */
 export type SfxIntensity = "off" | "light" | "standard" | "dense";
 export interface SfxDensityPolicy {
-    /** Max SFX hits per rolling 30s window. */
     maxHitsPer30s: number;
-    /** Min seconds between any two hit transients. */
     minSpacingSec: number;
-    /** Whether enumeration/sequence items may tick per element entrance. */
     perElementTicks: boolean;
-    /** Cap on per-element ticks within one graphic (when enabled). */
     maxTicksPerGraphic: number;
-    /** Default hit level (dB, applied as `volumeDb` on the SFX clip). */
     hitDb: number;
 }
-/** Density policy per content kind at each intensity. `off` emits nothing (the
- *  resolver returns [] before consulting this table). `dense` on real footage is
- *  the explicit opt-in that unlocks the generated-tier caps. */
 export declare const SFX_DENSITY: Record<AudioContentKind, Record<Exclude<SfxIntensity, "off">, SfxDensityPolicy>>;
-/** Default intensity per content kind when brief/brand express audio intent but
- *  no explicit sfx intensity. */
 export declare const DEFAULT_SFX_INTENSITY: Record<AudioContentKind, Exclude<SfxIntensity, "off">>;
-/** Speech-collision policy (real footage only — generated content has no speech
- *  unless VO ships): a hit whose transient lands inside a speech word ±150ms is
- *  attenuated a further -6 dB; risers that would UNDERLAP speech are dropped. */
 export declare const SPEECH_COLLISION: {
     readonly windowMs: 150;
     readonly attenuateDb: -6;
 };
-/** Music bed defaults (spec §6): base level, fades, duck. */
 export declare const MUSIC_BED: {
     readonly volumeDb: -21;
     readonly fadeInMs: 500;
@@ -50,18 +23,11 @@ export declare const MUSIC_BED: {
         readonly releaseMs: 400;
     };
 };
-/** Ambience bed defaults (audio-substrate P0). Like a music bed — it LOOPS to
- *  fill the timeline — but the founder ruling is that ambience HOLDS under VO: it
- *  sits at the BOTTOM of the mix (a further −5 dB below the music bed) and is
- *  NEVER duck-stamped (no `duck` key — the absence IS the contract; the render's
- *  duck pass only ever acts on music/vo roles). No beat map, no anchor semantics. */
 export declare const AMBIENCE_BED: {
     readonly volumeDb: -26;
     readonly fadeInMs: 500;
     readonly fadeOutMs: 1200;
 };
-/** Dedicated audio track ids — separate tracks so the no-overlap invariant never
- *  fights bed-vs-hit, and so eval can address each role's track. */
 export declare const SFX_TRACK_ID = "track-audio-sfx";
 export declare const MUSIC_TRACK_ID = "track-audio-music";
 export declare const AMBIENCE_TRACK_ID = "track-audio-ambience";

package/dist/_members/composition/audio/mixStaging.d.ts

@@ -1,41 +1,5 @@
-/**
- * mixStaging — the engine's DEFAULT gain-staging policy + the hierarchy-inversion
- * advisory (audio-substrate P0, Phase 3 — "the engine owns the default mix").
- *
- * The role taxonomy (`audioRole: vo|music|sfx|ambience`) encodes Murch's clarity
- * hierarchy VO > sfx > music > ambience. Before this pass, relative levels were
- * per-clip author folklore (authored `volumeDb`; absent ⇒ unity), which produced
- * a 1.5 dB VO-over-bed mush in the memoir benchmark. This module is the ONE SSOT
- * for two calibrated behaviours:
- *
- *   1. ROLE_DEFAULT_GAIN_DB — the level a role-tagged clip gets WHEN its source
- *      carries NO authored level. An authored `volumeDb`/`volume` ALWAYS wins
- *      (author's word); a clip with NO `audioRole` keeps unity (today's behaviour
- *      — the engine never guesses a role). Applied at render time in exactly one
- *      place (`compositionToRenderInput`) so every render lane inherits it.
- *   2. detectMixHierarchyInversion — an ADVISORY (never blocks) raised when
- *      AUTHORED levels invert the hierarchy (e.g. a music clip effectively louder
- *      than a vo clip). Compares EFFECTIVE (authored-or-default) dB.
- *
- * Mastering (loudnorm −14 LUFS on Modal /master) is orthogonal and UNCHANGED —
- * this shapes the RELATIVE mix the master then normalises as a whole.
- */
 import type { Composition } from "../validators/index.js";
 export type AudioRole = "vo" | "sfx" | "music" | "ambience";
-/**
- * ROLE_DEFAULT_GAIN_DB — engine default level per role (dB relative to source),
- * calibrated to the doctrine's ≥6 dB-VO-over-bed rule:
- *
- *   vo        0 dB  — the clarity reference; the mix anchors on speech.
- *   sfx      −6 dB  — punctuation: audible under VO, never masks it.
- *   music   −16 dB  WHEN VO is present anywhere in the composition — a ≥16 dB bed
- *                   keeps speech intelligible with peak headroom (the 1.5 dB
- *                   memoir mush becomes ≥16 dB of separation).
- *            −8 dB  WHEN no VO clip exists — a music-driven montage must not bury
- *                   its own bed, so it sits forward. (This conditional is the
- *                   load-bearing one.)
- *   ambience −22 dB — bottom of the mix; HOLDS under VO (never ducks).
- */
 export declare const ROLE_DEFAULT_GAIN_DB: {
     readonly vo: 0;
     readonly sfx: -6;
@@ -45,63 +9,18 @@ export declare const ROLE_DEFAULT_GAIN_DB: {
     };
     readonly ambience: -22;
 };
-/** The clarity hierarchy, loudest-first. Lower index = should sit higher in the
- *  mix. Used by the inversion advisory. */
 export declare const ROLE_HIERARCHY: readonly AudioRole[];
-/** Resolve the engine default level (dB) for a role. `music` is conditional on
- *  whether the composition contains any VO. */
 export declare function roleDefaultGainDb(role: AudioRole, voPresent: boolean): number;
-/**
- * True when ANY clip in ANY enabled track declares `audioRole: 'vo'`. VO can be a
- * dedicated audio clip OR a talking-head video clip's own audio, so this scans
- * every track kind (not just audio) — the music-conditional default depends on it.
- */
 export declare function compositionHasVo(composition: Composition): boolean;
-/**
- * Effective level (dB relative to source) of a media clip source under the mix
- * policy: authored `volumeDb` wins; else authored linear `volume` converted to
- * dB (`20·log10`); else the role default. A role-less source has no policy level
- * (returns undefined — it stays at unity, out of the hierarchy comparison).
- */
 export declare function effectiveClipGainDb(source: {
     volumeDb?: number;
     volume?: number;
     audioRole?: AudioRole;
 }, voPresent: boolean): number | undefined;
-/** One authored sfx transient: a clipId + its timeline position in milliseconds. */
 export interface SfxTransient {
     clipId: string;
     startMs: number;
 }
-/**
- * Authored sfx transients (audio-substrate P0, Phase 4 — the AV-sync floor): every
- * clip whose source is a media clip tagged `audioRole: 'sfx'`, as {clipId, startMs}
- * where startMs is the clip's authored timeline position (`startTime`, seconds → ms).
- * Sorted earliest-first. These are the "expected transients" the delivered-mix onset
- * analysis matches against — an sfx hit that lands nowhere near a detected onset has
- * drifted. PURE (no I/O); the render policy (cap, fail/advisory) lives in the director.
- */
 export declare function sfxTransients(composition: Composition): SfxTransient[];
-/**
- * Detect a composition with NO deliberate audio at all — no audio-family
- * track content, no role-tagged media clip, and every video media clip muted
- * (or all silent stills/cards). "Silence is a level" only when someone CHOSE
- * it: a marker of kind "intentional-silence" suppresses the advisory.
- *
- * ADVISORY only — pushed onto the render `warnings[]` channel, never blocks.
- * Craft basis: video-craft-standards cross-cutting rule "audio is decided,
- * never defaulted" (three clean-agent trials shipped silent reels because
- * nothing asked the question — 2026-07-30).
- */
 export declare function detectNoAudioTrack(composition: Composition): string[];
-/**
- * Detect hierarchy inversions across the ROLES PRESENT in the composition and
- * return one advisory string per offending (higher-role, lower-role) pair. An
- * inversion is a lower-priority role's LOUDEST clip sitting above a
- * higher-priority role's QUIETEST clip (e.g. any music clip above any vo clip).
- *
- * ADVISORY only — the caller pushes these onto the render `warnings[]` channel;
- * they NEVER block a render. Because engine defaults are hierarchy-correct by
- * construction, only AUTHORED levels can trip this.
- */
 export declare function detectMixHierarchyInversion(composition: Composition): string[];

package/dist/_members/composition/audio/musicPack.d.ts

@@ -1,47 +1,15 @@
-/**
- * The CueFrame MUSIC-BED pack — a CLOSED, versioned catalog of CC0 music beds
- * (audio-substrate Phase 2). The music-tier twin of the SFX pack (pack.ts): a
- * Map built once from the generated entries; unknown ids fail loud; no runtime
- * search, no network.
- *
- * Bytes live at content-addressed shared R2 keys `packs/music/v1/{bedId}.mp3`
- * (cross-org shared-bytes model, one copy ever); each entry records sha256 +
- * full provenance (source URL, author, license). Entries are written by the
- * curation script (the backend services), which normalizes
- * every bed to −16 LUFS integrated (ffmpeg loudnorm — the music loudness anchor,
- * NOT the sfx −6 dBFS peak rule) — hand-editing musicPack.generated.ts is a bug.
- *
- * LICENSE: CC0 ONLY — a hard constraint, not a preference (same as the SFX
- * pack). Beds embed into customers' videos that they redistribute and monetize
- * at scale through the API (multi-tenant sublicensing by machine); only CC0
- * survives that. The curation script audits each source's license PAGE and fails
- * loud on anything it cannot verify as CC0.
- */
 import { MUSIC_PACK_ENTRIES, MUSIC_PACK_VERSION } from "./musicPack.generated.js";
-/** How the bed's BPM was established. `detected` = a full librosa beat-track on
- *  the source; `stated` = the source page declared it (no onset analysis). The
- *  palette surfaces bpm regardless; a beat-cut author trusts `detected` more. */
 export type MusicBpmMethod = "detected" | "stated";
 export interface MusicPackEntry {
-    /** Stable id, also the R2 basename: `packs/music/v1/{bedId}.mp3`. */
     bedId: string;
-    /** Coarse genre bucket (ambient / electronic / jazz / world / cinematic …). */
     genre: string;
-    /** Editorial mood tags (≥1). The pack spans ≥2 distinct moods overall. */
     mood: string[];
-    /** Tempo (beats per minute). */
     bpm: number;
-    /** How `bpm` was established (see MusicBpmMethod). */
     bpmMethod: MusicBpmMethod;
-    /** Duration of the mastered bed (seconds) — every bed is ≥45s, loopable. */
     durationSec: number;
-    /** One-line human-legible caption (curation metadata IS the caption). */
     description: string;
-    /** Human-legible provenance string (required even for CC0). */
     attribution: string;
-    /** sha256 of the mastered bytes at the R2 key (content audit anchor). */
     sha256: string;
-    /** Structured provenance for the license audit — the recorded source page. */
     source: {
         url: string;
         author: string;
@@ -49,8 +17,5 @@ export interface MusicPackEntry {
     };
 }
 export { MUSIC_PACK_VERSION, MUSIC_PACK_ENTRIES };
-/** R2 key for a music bed's shared bytes. */
 export declare function musicPackR2Key(bedId: string): string;
-/** Look up a bed — FAIL LOUD on an unknown id (closed registry; a typo'd bedId
- *  must never silently place silence). */
 export declare function getMusicPackEntry(bedId: string): MusicPackEntry;

package/dist/_members/composition/audio/musicPack.generated.d.ts

@@ -1,9 +1,3 @@
-/**
- * GENERATED by the backend services — DO NOT EDIT BY HAND.
- * Each bed's bytes are loudness-normalized (−16 LUFS integrated), sha256-hashed,
- * and uploaded to R2 at `packs/music/{version}/{bedId}.mp3` by the same script
- * run that wrote this file, so catalog and bytes can never drift.
- */
 import type { MusicPackEntry } from "./musicPack.js";
 export declare const MUSIC_PACK_VERSION = "v1";
 export declare const MUSIC_PACK_ENTRIES: MusicPackEntry[];

package/dist/_members/composition/audio/pack.d.ts

@@ -1,51 +1,16 @@
-/**
- * The CueFrame SFX pack — a CLOSED, versioned catalog of CC0 sounds (spec
- * 2026-07-20 §3.1). Mirrors the closed primitive-registry pattern
- * (packages/execution/compose/src/primitiveRegistry.ts): a Map built once from
- * the generated entries; unknown ids fail loud; no runtime search, no network.
- *
- * Bytes live at content-addressed shared R2 keys `packs/sfx/v1/{soundId}.wav`
- * (cross-org shared-bytes model, one copy ever); each entry records sha256 +
- * full provenance (source URL, author, license) for audit. Entries are written
- * by the curation script (the backend services) which
- * pre-masters every sound to a fixed -6 dBFS peak so `volumeDb` gain staging is
- * predictable across the pack — hand-editing pack.generated.ts is a bug.
- *
- * LICENSE: CC0 ONLY — a hard constraint, not a preference. Pack sounds embed
- * into customers' videos that they redistribute and monetize at scale through
- * the API (multi-tenant sublicensing by machine); only CC0 survives that.
- */
 import { SFX_PACK_ENTRIES, SFX_PACK_VERSION } from "./pack.generated.js";
-/** The editorial family a sound belongs to — what sfxCompile binds by.
- *  tick/pop/impact/confirm/error are transient one-shots; whoosh/riser are
- *  sweeps. (No ambient family yet — the curated CC0 packs are all transient/
- *  sweep; ambient-bed starters are a future curation run, envelopeClass reserved
- *  below.) */
 export type SfxFamily = "tick" | "pop" | "impact" | "confirm" | "error" | "whoosh" | "riser";
-/** The coarse envelope shape — the agent-legible grouping the catalog/skill
- *  browse by (Remotion's sfx.md move): a transient is a one-shot hit, a sweep
- *  rises/falls across ~0.5–2s, an ambient is an unbounded bed. */
 export type SfxEnvelopeClass = "transient" | "sweep" | "ambient";
-/** Relative loudness tier within a family (all pre-mastered to -6 dBFS peak;
- *  intensity picks character, not level — level is `volumeDb` at placement). */
 export type SfxPackIntensity = "subtle" | "standard" | "strong";
 export interface SfxPackEntry {
-    /** Stable id, also the R2 basename: `packs/sfx/v1/{soundId}.wav`. */
     soundId: string;
     family: SfxFamily;
     intensity: SfxPackIntensity;
-    /** Coarse envelope shape — the browse/catalog grouping. */
     envelopeClass: SfxEnvelopeClass;
-    /** One-line human-legible caption (curation metadata IS the caption — no
-     *  audio-captioning model). What a driving agent reads to pick this sound. */
     description: string;
-    /** Duration of the mastered asset (seconds). */
     durationSec: number;
-    /** sha256 of the mastered bytes at the R2 key (content audit anchor). */
     sha256: string;
-    /** Human-legible provenance string (required even for CC0). */
     attribution: string;
-    /** Structured provenance for the license audit. */
     source: {
         url: string;
         author: string;
@@ -53,15 +18,7 @@ export interface SfxPackEntry {
     };
 }
 export { SFX_PACK_VERSION, SFX_PACK_ENTRIES };
-/** R2 key for a pack sound's shared bytes. */
 export declare function sfxPackR2Key(soundId: string): string;
-/** Look up a pack entry — FAIL LOUD on an unknown id (closed registry; a typo'd
- *  soundId must never silently place silence). */
 export declare function getSfxPackEntry(soundId: string): SfxPackEntry;
-/** All sounds of a family, subtle→strong. Deterministic order (catalog order). */
 export declare function sfxByFamily(family: SfxFamily): SfxPackEntry[];
-/** Deterministic family pick: the first sound of the family at the requested
- *  intensity, falling back to the family's first entry. Returns null when the
- *  family is EMPTY in this pack version — the caller (sfxCompile) skips the
- *  placement rather than guessing across families. */
 export declare function pickSfx(family: SfxFamily, intensity: SfxPackIntensity): SfxPackEntry | null;

package/dist/_members/composition/audio/pack.generated.d.ts

@@ -1,9 +1,3 @@
-/**
- * GENERATED by the backend services — DO NOT EDIT BY HAND.
- * Each entry's bytes are pre-mastered (-6 dBFS peak), sha256-hashed, and
- * uploaded to R2 at `packs/sfx/{version}/{soundId}.wav` by the same script run
- * that wrote this file, so catalog and bytes can never drift.
- */
 import type { SfxPackEntry } from "./pack.js";
 export declare const SFX_PACK_VERSION = "v1";
 export declare const SFX_PACK_ENTRIES: SfxPackEntry[];

package/dist/_members/composition/audio/palette.d.ts

@@ -1,9 +1,6 @@
 import type { SfxEnvelopeClass } from "./pack.js";
 import type { AudioRole } from "./mixStaging.js";
-/** Where a palette entry came from — the provenance discriminant. */
 export type AudioPaletteSource = "pack" | "org" | "generated";
-/** The numeric envelope probe evidence (present-if-probed; the pack SSOT carries
- *  only the class, an org probe fills the numbers). Mirrors mediaItems.envelope. */
 export interface AudioEnvelopeEvidence {
     envelopeClass: SfxEnvelopeClass;
     attackMs?: number;
@@ -11,34 +8,19 @@ export interface AudioEnvelopeEvidence {
     meanVolumeDb?: number;
     maxVolumeDb?: number;
 }
-/** The UNIFORM palette entry — the same shape for pack, org, and generated. */
 export interface AudioPaletteEntry {
-    /** The placement handle: a pack `soundId`/`bedId` (import_resource {kind}),
-     *  or an org media id (place directly as a clip `mediaId`). */
     ref: string;
-    /** DECLARED role for mix policy — what this sound IS. */
     role: AudioRole;
-    /** Coarse envelope shape — the browse grouping. */
     envelopeClass: SfxEnvelopeClass;
     description: string;
     durationSec: number;
-    /** Envelope probe evidence (always carries `envelopeClass`). */
     evidence: AudioEnvelopeEvidence;
     source: AudioPaletteSource;
-    /** License token: "CC0" (pack), "org-owned" (an upload), a real CC token
-     *  (a stock import), or "generated" (a generator produced it). */
     license: string;
-    /** Human-legible provenance: pack attribution, "org-owned", or the generator
-     *  + prompt for a generated sound. */
     provenance: string;
-    /** Tempo (bpm) — present for music-role entries (pack beds carry the catalog
-     *  bpm; generated/org music carries its beatGrid bpm). */
     bpm?: number;
-    /** Editorial mood tags — present for pack music beds. */
     mood?: string[];
 }
-/** A raw org audio row (the structural subset of mediaItems this module needs).
- *  Both the Convex query result and the director's HTTP result map into this. */
 export interface OrgAudioRow {
     mediaId: string;
     name?: string;
@@ -52,31 +34,13 @@ export interface OrgAudioRow {
     beatGrid?: {
         bpm: number;
     };
-    /** Shared/owned R2 key — threaded to the compose capture path so an org sound
-     *  the org-first draw substitutes resolves without a Convex round-trip. */
     filePath?: string;
 }
-/**
- * Assemble the full org sound palette: pack (SFX ∪ music beds) ∪ org-owned ∪
- * generated. Deterministic given the input rows (pack halves are catalog-ordered;
- * org rows keep their input order). Every entry carries source + license +
- * provenance; music entries carry bpm.
- */
 export declare function assembleAudioPalette(orgAudioRows: OrgAudioRow[]): AudioPaletteEntry[];
-/** One org SFX sound the compose org-first draw can substitute for a pack pick. */
 export interface OrgSfxPaletteEntry {
     mediaId: string;
     envelopeClass: SfxEnvelopeClass;
     durationSec: number;
-    /** R2 key of the org sound's bytes — stamped into the capture path's media map. */
     filePath?: string;
 }
-/**
- * The org-owned SFX subset for the compose org-first draw: every org/generated
- * (NOT pack) sound of role "sfx" that carries an envelope class, in a STABLE
- * order (by mediaId) so the draw is deterministic. The director substitutes one
- * of these for a pack pick when the org has a sound of the requested class — the
- * grounding move (an org that uploads its product's real UI sounds hears ITS
- * product), mirroring how a brand kit overrides the default font.
- */
 export declare function orgSfxPalette(orgAudioRows: OrgAudioRow[]): OrgSfxPaletteEntry[];

package/dist/_members/composition/autozoom/index.d.ts

@@ -1,34 +1,11 @@
-/**
- * Auto-zoom segment generator — clean-room.
- *
- * Turns caller-supplied focus points (timed cursor/click positions from an
- * automation tool, OR a pixel-derived activity hotspot track) into a gapless
- * tiling of `ReframeSegment`s: neutral `frame-center` spans where nothing
- * happens, and `point` punch-ins centered on the activity.
- *
- * The caller supplies WHERE/WHEN (the points); this module owns HOW it looks
- * (easing, zoom amount, padding) via `STYLE` presets — the caller never tunes
- * smoothness, only optionally picks a coarse style. CONSUMER-AGNOSTIC: it knows
- * "timed focus points", never "clicks" or any specific product/use-case. The
- * recipe for a given product (what a "click" is, which style, what polish to
- * layer on) lives in a use-case skill, not here.
- *
- * The timing heuristic (group → pad → merge → min-duration → fixed zoom) is a
- * clean-room reimplementation of well-tested screen-recorder behavior, written
- * from described behavior; constants are adopted as parameters.
- */
 import type { ReframeSegment } from "../validators/composition.js";
-/** A caller event — a click or sampled cursor position. `(x,y)` normalized [0,1]. */
 export interface ZoomEvent {
     t: number;
     x: number;
     y: number;
 }
-/** One sampled instant of a pixel-derived activity track. */
 export interface ActivitySample extends ZoomEvent {
-    /** Fraction of the frame that changed (0–1); high = pan/scroll, reject. */
     changePct: number;
-    /** Change-mass concentration near the hotspot (0–1); high = a focused target. */
     concentration: number;
 }
 export type ZoomStyle = "subtle" | "standard" | "punchy";
@@ -39,17 +16,8 @@ interface Tuning {
     minZoom: number;
     mergeGap: number;
 }
-/** CueFrame-owned look presets. The caller picks a name; never the numbers. */
 export declare const STYLE: Record<ZoomStyle, Tuning>;
-/**
- * Timed focus points (e.g. cursor/click positions — every point a
- * high-confidence anchor) → reframe segments. No detection.
- */
 export declare function autoZoom(points: ZoomEvent[], durationSec: number, style?: ZoomStyle): ReframeSegment[];
-/**
- * Pixel-derived activity track → reframe segments. Keeps only focused,
- * low-global-change samples (rejects pan/scroll) before tiling.
- */
 export declare function autoZoomFromActivity(activity: ActivitySample[], durationSec: number, style?: ZoomStyle, thresholds?: {
     minConcentration?: number;
     maxChangePct?: number;

package/dist/_members/composition/brand-kit.d.ts

@@ -32,25 +32,17 @@ export interface BrandKit {
     headingFont: BrandTypography;
     bodyFont: BrandTypography;
     syncCaptions: boolean;
-    /** Full caption style profile (replaces shallow 2-field sync) */
     captionProfile?: Record<string, unknown>;
     logo?: WireBrandKit["logo"];
     intro?: WireBrandKit["intro"];
     outro?: WireBrandKit["outro"];
     watermark?: WireBrandKit["watermark"];
-    /** Primary brand tagline/slogan — prompt context only. */
     tagline?: string;
-    /** Secondary tagline or CTA phrase — prompt context only. */
     secondaryTagline?: string;
-    /** Free-text brand voice, injected into LLM prompts. */
     voiceGuidelines: string;
-    /** Custom fonts (loaded via FontFace API on kit activation) — editor UI only. */
     customFonts: BrandFont[];
-    /** Audio asset — authoring metadata, not a render input. */
     jingle?: BrandAsset;
-    /** Audio asset — authoring metadata, not a render input. */
     bgMusic?: BrandAsset;
-    /** Hero/background image from website — authoring metadata, not a render input. */
     heroImage?: BrandAsset;
     createdAt: number;
     modifiedAt: number;