gooseworks 0.5.9-dev.61.827a2d9f → 0.5.9

package/dist/kit/core/assembly-timeline.d.ts

@@ -0,0 +1,184 @@
+export declare const ASSEMBLY_FORMAT: "gooseworks-assembly-timeline/1";
+export declare const SPEECH_MODES: readonly ["native_dialogue", "audio_driven_lipsync", "narration", "singing", "mixed", "none"];
+export declare const SOUNDTRACK_MODES: readonly ["source_ambience", "music", "sfx", "intentional_silence"];
+export type SpeechMode = typeof SPEECH_MODES[number];
+export type SoundtrackMode = typeof SOUNDTRACK_MODES[number];
+export interface AssemblySource {
+    asset_id: string;
+    sha256: string;
+    /** Local transport only; excluded from the portable revision and stripped before upload. */
+    path?: string;
+    in_ms: number;
+    out_ms: number;
+    speed: number;
+    /** Picture sources only: the part of the source shown, in whole source pixels. */
+    crop?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    /** Picture sources only: how the shown part is scaled. Uneven stretch over 2% is refused; zoom is checked against the real source. */
+    scale_x?: number;
+    scale_y?: number;
+}
+/** Picture stretch and zoom limits (fix-forward contract section 7, as amended 15 Oct). */
+export declare const MAX_UNEVEN_STRETCH = 0.02;
+/**
+ * The most a crop may zoom in: the crop's fit-scale over the full source frame's fit-scale.
+ * Plain resolution scaling of the whole frame (H3's 432×768 to 1080×1920) is not zoom.
+ */
+export declare const MAX_ZOOM = 1.5;
+/** Planned pause and freeze limits, the same numbers the final measurements use. */
+export declare const MAX_PLANNED_PAUSE_MS: 1500;
+export declare const MAX_PLANNED_TOTAL_SHARE: 0.1;
+/** How far a crop zooms in when its picture fills a `frame` (cover fit); 1 for the whole source. */
+export declare function cropZoom(crop: {
+    w: number;
+    h: number;
+}, source: {
+    width: number;
+    height: number;
+}, frame: {
+    width: number;
+    height: number;
+}): number;
+/** A segment that deliberately shows an earlier shot again says so with an intent starting with this. */
+export declare const CALLBACK_INTENT = "callback:";
+export interface AssemblySegment {
+    id: string;
+    scene_id: string;
+    start_ms: number;
+    end_ms: number;
+    video: AssemblySource;
+    speech_mode: SpeechMode;
+    depicts_speech: boolean;
+    native_audio: 'preserve' | 'muted';
+    speech_driver?: AssemblySource & {
+        task: 'exact_audio';
+    };
+    intent?: string;
+}
+export interface AssemblyCue {
+    id: string;
+    role: Exclude<SpeechMode, 'mixed' | 'none'> | 'source_ambience' | 'music' | 'sfx';
+    source: AssemblySource;
+    start_ms: number;
+    end_ms: number;
+    gain_db: number;
+    loop: boolean;
+    intent?: string;
+}
+export interface AssemblyTimeline {
+    format: typeof ASSEMBLY_FORMAT;
+    creative_contract_revision: string;
+    duration_ms: number;
+    speech_mode: SpeechMode;
+    soundtrack_modes: SoundtrackMode[];
+    segments: AssemblySegment[];
+    audio_cues: AssemblyCue[];
+    pauses: Array<{
+        start_ms: number;
+        end_ms: number;
+        scope: 'speech' | 'all_audio';
+        reason: string;
+    }>;
+    required_cue_ids: string[];
+    visual_overrides?: Array<{
+        start_ms: number;
+        end_ms: number;
+        kind: 'freeze' | 'transition';
+        reason: string;
+        source?: AssemblySource;
+        scene_id?: string;
+        source_kind?: 'image' | 'video';
+        segment_ids?: string[];
+    }>;
+}
+export interface AssemblyPictureSource {
+    id: string;
+    scene_id: string;
+    source: AssemblySource;
+    source_kind: 'image' | 'video';
+}
+/** Overrides can introduce picture bytes that never appear in ordinary clips. */
+export declare function assemblyPictureSources(timeline: AssemblyTimeline): AssemblyPictureSource[];
+export interface AssemblyCheck {
+    status: 'complete' | 'incomplete' | 'invalid';
+    timeline: AssemblyTimeline | null;
+    revision: string | null;
+    issues: string[];
+    /** Legacy intent is retained for review, never inferred from transcript absence. */
+    legacy?: Record<string, unknown>;
+}
+/** How the reviewer perceived the sound: heard it (a person or an audio-capable model), or relied on the measurements. */
+export type AudioPerception = 'listened' | 'measured';
+/** How the reviewer perceived the moving picture: watched it, or relied on the measurements. */
+export type MotionPerception = 'watched' | 'measured';
+export declare const AUDIO_PERCEPTIONS: readonly AudioPerception[];
+export declare const MOTION_PERCEPTIONS: readonly MotionPerception[];
+/**
+ * `capabilities` (fix-forward contract section 2). The old boolean shape still parses for one release:
+ * `true` reads as listened/watched; `false` is refused.
+ */
+export type ReviewCapabilities = {
+    audio: AudioPerception;
+    motion: MotionPerception;
+} | {
+    audio_perception: boolean;
+    motion_perception: boolean;
+};
+export interface FinalContentReview {
+    output_sha256: string;
+    timeline_revision: string;
+    creative_contract_revision: string;
+    reviewer: string;
+    verdict: 'approved' | 'needs_revision' | 'incomplete';
+    capabilities: ReviewCapabilities;
+    coverage: Array<{
+        start_ms: number;
+        end_ms: number;
+    }>;
+    /** Matched case-insensitively: only P2 lets the upload go on; P0, P1, blocker and anything unknown block. */
+    unresolved_issues: Array<{
+        severity: string;
+        message: string;
+    }>;
+    dimensions: Record<string, {
+        status: 'pass' | 'needs_revision' | 'incomplete' | 'not_applicable';
+        note: string;
+    }>;
+}
+/** What a measured review leans on: the kit's own final measurements of the same bytes. */
+export interface FinalMeasureSummary {
+    output_sha256: string;
+    checks: Array<{
+        id: string;
+        result: 'pass' | 'fail' | 'not_applicable';
+    }>;
+}
+export declare const CONTENT_DIMENSIONS: readonly ["reference_and_concept", "brand_and_product", "scale_and_geometry", "action_and_continuity", "lip_sync", "voice_performance", "pronunciation", "sound_and_silence", "pacing_and_joins", "camera_and_lighting", "overlays"];
+/** The timeline without machine-specific `path` values: what the revision hashes and what goes to the server. */
+export declare function portableTimeline<T>(value: T): T;
+/** Excludes machine-specific transport, while retaining exact assets and source clocks. */
+export declare function assemblyTimelineRevision(value: AssemblyTimeline): string;
+/** Structural and clock checks. A complete result still requires source-byte and content review. */
+export declare function normalizeAssemblyTimeline(raw: unknown, legacy?: Record<string, unknown>): AssemblyCheck;
+export declare const FINAL_ASSEMBLY_DURATION_TOLERANCE_MS = 100;
+export declare function measuredFinalDurationMs(seconds: number | null | undefined): number | null;
+/**
+ * The review's perception, in the new shape. The old booleans are aliases: `true` reads as
+ * listened/watched and `false` is refused, so a review that admits it could not hear or see never passes.
+ */
+export declare function reviewCapabilities(raw: unknown): {
+    audio: AudioPerception | null;
+    motion: MotionPerception | null;
+    problems: string[];
+};
+/**
+ * Omit measurement only for preflight; final acceptance needs the measured duration. A `measured`
+ * perception is accepted only with `finalMeasure` of the same bytes in which every check passed
+ * (or does not apply); the server adds its own frame judge on top.
+ */
+export declare function finalContentReviewProblems(raw: unknown, outputSha: string, assembly: AssemblyCheck, measuredDurationMs?: number | null, finalMeasure?: FinalMeasureSummary | null): string[];
+//# sourceMappingURL=assembly-timeline.d.ts.map

package/dist/kit/core/assembly-timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembly-timeline.d.ts","sourceRoot":"","sources":["../../../src/kit/core/assembly-timeline.ts"],"names":[],"mappings":"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"}