vidspotai-shared 1.0.68 → 1.0.69-dev.0

package/lib/schemas/project.schema.d.ts.map

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

package/lib/schemas/project.schema.js

@@ -0,0 +1,256 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectSchema = exports.ProjectBackgroundSchema = exports.TrackSchema = exports.TrackKindSchema = exports.ClipSchema = exports.CaptionClipSchema = exports.TextClipSchema = exports.AudioClipSchema = exports.ImageClipSchema = exports.VideoClipSchema = exports.CaptionWordSchema = exports.TransitionSchema = exports.EffectSchema = exports.ProvenanceSchema = exports.TierSchema = exports.ColorGradeSchema = exports.TransformSchema = exports.TrimSchema = exports.TimeRangeSchema = exports.AspectSchema = exports.SizeSchema = exports.PROJECT_SCHEMA_VERSION = void 0;
+const zod_1 = require("zod");
+/**
+ * Canonical Project JSON schema.
+ *
+ * This is the persistent, agent-facing representation of a video project.
+ * It is the single contract shared by:
+ *   - the editor (loads/edits this; runtime adds scale/scroll/selection on top)
+ *   - the agent tool layer (produces and patches this via compose_scene etc.)
+ *   - the headless renderer (consumes this to produce MP4)
+ *
+ * What this schema deliberately does NOT include:
+ *   - editor runtime state (zoom, scroll, active selection, undo history)
+ *   - browser-only handles (Blob, ReadableStream)
+ *   - rich-effect details that aren't yet renderable end-to-end
+ *
+ * Fields evolve forward only. Add new optional fields; never repurpose existing ones.
+ * Bump PROJECT_SCHEMA_VERSION on any breaking change.
+ */
+exports.PROJECT_SCHEMA_VERSION = 1;
+// ─── primitives ───────────────────────────────────────────────────────────
+exports.SizeSchema = zod_1.z.object({
+    width: zod_1.z.number().int().positive(),
+    height: zod_1.z.number().int().positive(),
+});
+exports.AspectSchema = zod_1.z.enum(["9:16", "1:1", "4:5", "16:9"]);
+exports.TimeRangeSchema = zod_1.z.object({
+    /** Inclusive start, in milliseconds from project t=0. */
+    from: zod_1.z.number().nonnegative(),
+    /** Exclusive end, in milliseconds. Must be > from. */
+    to: zod_1.z.number().positive(),
+});
+exports.TrimSchema = zod_1.z.object({
+    /** Inclusive start within the source asset, in milliseconds. */
+    from: zod_1.z.number().nonnegative(),
+    to: zod_1.z.number().positive(),
+});
+exports.TransformSchema = zod_1.z.object({
+    x: zod_1.z.number().default(0),
+    y: zod_1.z.number().default(0),
+    scaleX: zod_1.z.number().default(1),
+    scaleY: zod_1.z.number().default(1),
+    rotation: zod_1.z.number().default(0),
+    opacity: zod_1.z.number().min(0).max(1).default(1),
+});
+exports.ColorGradeSchema = zod_1.z.object({
+    exposure: zod_1.z.number().min(-100).max(100).default(0),
+    contrast: zod_1.z.number().min(-100).max(100).default(0),
+    saturation: zod_1.z.number().min(-100).max(100).default(0),
+    warmth: zod_1.z.number().min(-100).max(100).default(0),
+});
+// ─── agent provenance ────────────────────────────────────────────────────
+/** Generation tier per the cheap-bulk strategy. */
+exports.TierSchema = zod_1.z.enum(["T0", "T1", "T2", "T3"]);
+/** Provenance attached to every clip whose asset was generated or sourced by the agent. */
+exports.ProvenanceSchema = zod_1.z.object({
+    tier: exports.TierSchema,
+    /** Provider key as registered in aiModels.ts, or "pexels", "user-upload", etc. */
+    source: zod_1.z.string(),
+    modelKey: zod_1.z.string().optional(),
+    prompt: zod_1.z.string().optional(),
+    /** Content-hash of the underlying asset, for cache dedupe. */
+    assetHash: zod_1.z.string().optional(),
+    /** Credits actually spent producing this asset. */
+    creditsSpent: zod_1.z.number().nonnegative().optional(),
+    /** Idempotency key used when calling the provider. */
+    generationId: zod_1.z.string().optional(),
+});
+// ─── effects & transitions ───────────────────────────────────────────────
+exports.EffectSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    /** e.g. "lut", "vignette", "stabilize", "blur", "chroma". */
+    kind: zod_1.z.string(),
+    enabled: zod_1.z.boolean().default(true),
+    /** Free-form effect-specific params; validated per-effect at the renderer. */
+    params: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).default({}),
+});
+exports.TransitionSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    fromClipId: zod_1.z.string(),
+    toClipId: zod_1.z.string(),
+    /** Restricted to renderable kinds. */
+    kind: zod_1.z.enum([
+        "none",
+        "fade",
+        "crossfade",
+        "wipe",
+        "slide",
+        "whipPan",
+        "dipToBlack",
+        "dipToWhite",
+    ]),
+    durationMs: zod_1.z.number().positive(),
+    /**
+     * Direction qualifier for `slide` / `wipe` / `whipPan`. Mirrors Remotion's
+     * widest set (`WipeDirection`); slide and whipPan only honor 4 cardinals
+     * and collapse diagonals to the nearest axis at render time. Ignored by
+     * non-directional kinds.
+     */
+    direction: zod_1.z
+        .enum([
+        "from-left",
+        "from-top-left",
+        "from-top",
+        "from-top-right",
+        "from-right",
+        "from-bottom-right",
+        "from-bottom",
+        "from-bottom-left",
+    ])
+        .optional(),
+});
+// ─── caption sub-shape ───────────────────────────────────────────────────
+exports.CaptionWordSchema = zod_1.z.object({
+    word: zod_1.z.string(),
+    /** ms from clip start. */
+    start: zod_1.z.number().nonnegative(),
+    end: zod_1.z.number().nonnegative(),
+});
+// ─── clips (discriminated union) ─────────────────────────────────────────
+const ClipBase = {
+    id: zod_1.z.string(),
+    trackId: zod_1.z.string(),
+    display: exports.TimeRangeSchema,
+    name: zod_1.z.string().optional(),
+    /** True if this clip carries a generated/sourced asset the agent placed. */
+    provenance: exports.ProvenanceSchema.optional(),
+    effects: zod_1.z.array(exports.EffectSchema).default([]),
+    transform: exports.TransformSchema.default({}),
+    /** Locked clips can't be moved/trimmed by the agent or user. */
+    locked: zod_1.z.boolean().default(false),
+    /** Opaque per-app metadata (UI hints, etc.). Renderer ignores. */
+    metadata: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).default({}),
+};
+exports.VideoClipSchema = zod_1.z.object({
+    ...ClipBase,
+    type: zod_1.z.literal("video"),
+    src: zod_1.z.string().url(),
+    trim: exports.TrimSchema.optional(),
+    volume: zod_1.z.number().min(0).max(2).default(1),
+    playbackRate: zod_1.z.number().positive().default(1),
+    colorGrade: exports.ColorGradeSchema.optional(),
+    /** Optional cropping in source pixels. */
+    crop: zod_1.z
+        .object({
+        x: zod_1.z.number(),
+        y: zod_1.z.number(),
+        width: zod_1.z.number().positive(),
+        height: zod_1.z.number().positive(),
+    })
+        .optional(),
+});
+exports.ImageClipSchema = zod_1.z.object({
+    ...ClipBase,
+    type: zod_1.z.literal("image"),
+    src: zod_1.z.string().url(),
+    /** Ken-Burns / parallax motion hint resolved by renderer for T1 image+motion clips. */
+    motion: zod_1.z
+        .object({
+        kind: zod_1.z.enum(["kenBurnsIn", "kenBurnsOut", "panLeft", "panRight", "parallax"]),
+        intensity: zod_1.z.number().min(0).max(1).default(0.5),
+    })
+        .optional(),
+    colorGrade: exports.ColorGradeSchema.optional(),
+});
+exports.AudioClipSchema = zod_1.z.object({
+    ...ClipBase,
+    type: zod_1.z.literal("audio"),
+    src: zod_1.z.string().url(),
+    trim: exports.TrimSchema.optional(),
+    volume: zod_1.z.number().min(0).max(2).default(1),
+    /** Sidechain-duck this audio against another track id (e.g. music ducked under VO). */
+    duckAgainstTrackId: zod_1.z.string().optional(),
+    fadeInMs: zod_1.z.number().nonnegative().default(0),
+    fadeOutMs: zod_1.z.number().nonnegative().default(0),
+});
+exports.TextClipSchema = zod_1.z.object({
+    ...ClipBase,
+    type: zod_1.z.literal("text"),
+    text: zod_1.z.string(),
+    fontFamily: zod_1.z.string().default("Poppins"),
+    fontSize: zod_1.z.number().positive().default(48),
+    fontWeight: zod_1.z.number().int().min(100).max(900).default(700),
+    color: zod_1.z.string().default("#ffffff"),
+    align: zod_1.z.enum(["left", "center", "right"]).default("center"),
+    backgroundColor: zod_1.z.string().optional(),
+    shadow: zod_1.z.string().optional(),
+});
+exports.CaptionClipSchema = zod_1.z.object({
+    ...ClipBase,
+    type: zod_1.z.literal("caption"),
+    text: zod_1.z.string(),
+    words: zod_1.z.array(exports.CaptionWordSchema).default([]),
+    fontFamily: zod_1.z.string().default("Poppins"),
+    fontSize: zod_1.z.number().positive().default(48),
+    color: zod_1.z.string().default("#ffffff"),
+    highlightColor: zod_1.z.string().optional(),
+    language: zod_1.z.string().default("en"),
+});
+exports.ClipSchema = zod_1.z.discriminatedUnion("type", [
+    exports.VideoClipSchema,
+    exports.ImageClipSchema,
+    exports.AudioClipSchema,
+    exports.TextClipSchema,
+    exports.CaptionClipSchema,
+]);
+// ─── tracks & project ────────────────────────────────────────────────────
+exports.TrackKindSchema = zod_1.z.enum([
+    "video",
+    "audio",
+    "text",
+    "caption",
+    "fx",
+]);
+exports.TrackSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    kind: exports.TrackKindSchema,
+    name: zod_1.z.string().optional(),
+    /** Track stacking order; lower = behind. */
+    index: zod_1.z.number().int().nonnegative(),
+    muted: zod_1.z.boolean().default(false),
+    hidden: zod_1.z.boolean().default(false),
+    locked: zod_1.z.boolean().default(false),
+    /** Track-level gain for audio tracks, in dB. Ignored on visual tracks. */
+    gainDb: zod_1.z.number().default(0),
+});
+exports.ProjectBackgroundSchema = zod_1.z.discriminatedUnion("type", [
+    zod_1.z.object({ type: zod_1.z.literal("color"), value: zod_1.z.string() }),
+    zod_1.z.object({ type: zod_1.z.literal("image"), src: zod_1.z.string().url() }),
+    zod_1.z.object({ type: zod_1.z.literal("transparent") }),
+]);
+exports.ProjectSchema = zod_1.z.object({
+    schemaVersion: zod_1.z.literal(exports.PROJECT_SCHEMA_VERSION),
+    id: zod_1.z.string(),
+    name: zod_1.z.string(),
+    /** Total project duration in ms. Renderer uses this; agent edits keep it in sync. */
+    durationMs: zod_1.z.number().positive(),
+    fps: zod_1.z.number().int().positive().default(30),
+    size: exports.SizeSchema,
+    aspect: exports.AspectSchema,
+    background: exports.ProjectBackgroundSchema.default({
+        type: "color",
+        value: "#000000",
+    }),
+    tracks: zod_1.z.array(exports.TrackSchema),
+    clips: zod_1.z.array(exports.ClipSchema),
+    transitions: zod_1.z.array(exports.TransitionSchema).default([]),
+    /** Top-level provenance: which agent run produced this project, if any. */
+    agentRunId: zod_1.z.string().optional(),
+    /** Free-form per-app metadata. Renderer ignores. */
+    metadata: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).default({}),
+    createdAt: zod_1.z.string().datetime(),
+    updatedAt: zod_1.z.string().datetime(),
+});