@depths/waves 0.1.0 → 0.3.0

package/dist/chunk-WGQITADJ.mjs

@@ -1,284 +0,0 @@
-import {
-  VideoIRSchema,
-  WavesRenderError,
-  globalRegistry,
-  registerBuiltInComponents,
-  zodSchemaToJsonSchema
-} from "./chunk-TGAL5RQN.mjs";
-
-// src/version.ts
-var __wavesVersion = "0.1.0";
-
-// src/llm/prompt.ts
-var RULES = {
-  timing: [
-    "All timing is in frames (integers).",
-    "Every component has timing: { from, durationInFrames }.",
-    "Scenes must be sequential: scene[0].timing.from = 0 and each next scene starts where the previous ends (no gaps/overlaps).",
-    "Sum of all scene durations must equal video.durationInFrames.",
-    "Child components inside a Scene must fit within the Scene duration."
-  ],
-  assets: [
-    'Asset paths must be either full URLs (http:// or https://) or absolute public paths starting with "/".',
-    'When using absolute public paths ("/assets/..."), the renderer resolves them relative to the --publicDir passed at render time.'
-  ],
-  ids: [
-    "Every component must have a stable string id.",
-    "Ids should be unique within the whole IR."
-  ],
-  output: [
-    "Return only a single JSON object (no markdown fences, no commentary).",
-    "The JSON must validate against the provided JSON Schemas.",
-    'Only use component "type" values that exist in schemas.components.'
-  ]
-};
-function getSystemPrompt(registeredTypes) {
-  const typesLine = registeredTypes.length ? registeredTypes.join(", ") : "(none)";
-  return [
-    "You generate JSON for @depths/waves Video IR (version 1.0).",
-    "",
-    "Goal:",
-    "- Produce a single JSON object that conforms to the provided Video IR JSON Schema and uses only registered component types.",
-    "",
-    "Registered component types:",
-    `- ${typesLine}`,
-    "",
-    "Authoring rules:",
-    ...RULES.output.map((r) => `- ${r}`),
-    ...RULES.timing.map((r) => `- ${r}`),
-    ...RULES.assets.map((r) => `- ${r}`),
-    ...RULES.ids.map((r) => `- ${r}`),
-    "",
-    "If you are unsure about an asset, prefer a solid color Scene background and omit optional props to use defaults.",
-    ""
-  ].join("\n");
-}
-function getPromptPayload(options) {
-  registerBuiltInComponents();
-  const registry = options?.registry ?? globalRegistry;
-  const types = registry.getTypes().sort();
-  return {
-    package: "@depths/waves",
-    version: __wavesVersion,
-    irVersion: "1.0",
-    systemPrompt: getSystemPrompt(types),
-    schemas: {
-      videoIR: zodSchemaToJsonSchema(VideoIRSchema),
-      components: registry.getJSONSchemaForLLM()
-    },
-    rules: {
-      timing: [...RULES.timing],
-      assets: [...RULES.assets],
-      ids: [...RULES.ids],
-      output: [...RULES.output]
-    }
-  };
-}
-
-// src/core/validator.ts
-var IRValidator = class {
-  validateSchema(ir) {
-    const result = VideoIRSchema.safeParse(ir);
-    if (!result.success) {
-      return {
-        success: false,
-        errors: result.error.issues.map((issue) => ({
-          path: issue.path.map((p) => String(p)),
-          message: issue.message,
-          code: issue.code
-        }))
-      };
-    }
-    return { success: true, data: result.data };
-  }
-  validateSemantics(ir) {
-    const errors = [];
-    const totalSceneDuration = ir.scenes.reduce((sum, scene) => sum + scene.timing.durationInFrames, 0);
-    if (totalSceneDuration !== ir.video.durationInFrames) {
-      errors.push({
-        path: ["scenes"],
-        message: `Sum of scene durations (${totalSceneDuration}) does not match video duration (${ir.video.durationInFrames})`,
-        code: "DURATION_MISMATCH"
-      });
-    }
-    let expectedFrame = 0;
-    for (const [i, scene] of ir.scenes.entries()) {
-      if (scene.timing.from !== expectedFrame) {
-        errors.push({
-          path: ["scenes", String(i), "timing", "from"],
-          message: `Scene ${i} starts at frame ${scene.timing.from}, expected ${expectedFrame}`,
-          code: "TIMING_GAP_OR_OVERLAP"
-        });
-      }
-      expectedFrame += scene.timing.durationInFrames;
-    }
-    for (const [i, scene] of ir.scenes.entries()) {
-      if (scene.children && scene.children.length > 0) {
-        this.validateComponentTimingRecursive(
-          scene.children,
-          scene.timing.durationInFrames,
-          ["scenes", String(i)],
-          errors
-        );
-      }
-    }
-    if (errors.length > 0) {
-      return { success: false, errors };
-    }
-    return { success: true };
-  }
-  validate(ir) {
-    const schemaResult = this.validateSchema(ir);
-    if (!schemaResult.success) {
-      return schemaResult;
-    }
-    const semanticsResult = this.validateSemantics(schemaResult.data);
-    if (!semanticsResult.success) {
-      return { success: false, errors: semanticsResult.errors ?? [] };
-    }
-    return schemaResult;
-  }
-  validateComponentTimingRecursive(components, parentDuration, pathPrefix, errors) {
-    for (const [i, component] of components.entries()) {
-      const componentEnd = component.timing.from + component.timing.durationInFrames;
-      if (componentEnd > parentDuration) {
-        errors.push({
-          path: [...pathPrefix, "children", String(i), "timing"],
-          message: `Component extends beyond parent duration (${componentEnd} > ${parentDuration})`,
-          code: "COMPONENT_EXCEEDS_PARENT"
-        });
-      }
-      if (component.type === "Scene" && component.children && component.children.length > 0) {
-        this.validateComponentTimingRecursive(
-          component.children,
-          component.timing.durationInFrames,
-          [...pathPrefix, "children", String(i)],
-          errors
-        );
-      }
-    }
-  }
-};
-
-// src/core/engine.ts
-import { bundle } from "@remotion/bundler";
-import { renderMedia, selectComposition } from "@remotion/renderer";
-import fs from "fs/promises";
-import path from "path";
-var WavesEngine = class {
-  constructor(registry, validator) {
-    this.registry = registry;
-    this.validator = validator;
-  }
-  async render(ir, options) {
-    if (this.registry !== globalRegistry) {
-      throw new WavesRenderError("WavesEngine currently requires using globalRegistry", {
-        hint: "Use `registerBuiltInComponents()` + `globalRegistry` for both validation and rendering."
-      });
-    }
-    const validationResult = this.validator.validate(ir);
-    if (!validationResult.success) {
-      throw new WavesRenderError("IR validation failed", { errors: validationResult.errors });
-    }
-    const validatedIR = validationResult.data;
-    const requiredTypes = collectComponentTypes(validatedIR);
-    for (const type of requiredTypes) {
-      if (!this.registry.has(type)) {
-        throw new WavesRenderError("Unknown component type", { type });
-      }
-    }
-    const rootDir = options.rootDir ?? process.cwd();
-    const tmpDir = await fs.mkdtemp(path.join(rootDir, ".waves-tmp-"));
-    const entryPoint = path.join(tmpDir, "entry.tsx");
-    try {
-      await fs.writeFile(entryPoint, generateEntryPoint(validatedIR, options), "utf-8");
-      await fs.mkdir(path.dirname(options.outputPath), { recursive: true });
-      const bundleLocation = await bundle({
-        entryPoint,
-        rootDir,
-        publicDir: options.publicDir ?? null,
-        onProgress: () => void 0
-      });
-      const compositionId = validatedIR.video.id ?? "main";
-      const composition = await selectComposition({
-        serveUrl: bundleLocation,
-        id: compositionId,
-        inputProps: {}
-      });
-      await renderMedia({
-        composition,
-        serveUrl: bundleLocation,
-        codec: options.codec ?? "h264",
-        outputLocation: options.outputPath,
-        crf: options.crf ?? null,
-        concurrency: options.concurrency ?? null,
-        overwrite: true
-      });
-    } catch (error) {
-      throw new WavesRenderError("Rendering failed", { originalError: error });
-    } finally {
-      await fs.rm(tmpDir, { recursive: true, force: true });
-    }
-  }
-};
-function collectComponentTypes(ir) {
-  const types = /* @__PURE__ */ new Set();
-  for (const scene of ir.scenes) {
-    walkComponent(scene, types);
-  }
-  return types;
-}
-function walkComponent(component, types) {
-  types.add(component.type);
-  const children = component.children;
-  if (children) {
-    for (const child of children) {
-      walkComponent(child, types);
-    }
-  }
-}
-function generateEntryPoint(ir, options) {
-  const compositionId = ir.video.id ?? "main";
-  const width = ir.video.width;
-  const height = ir.video.height;
-  const fps = ir.video.fps ?? 30;
-  const durationInFrames = ir.video.durationInFrames;
-  const registrationImports = (options.registrationModules ?? []).map((m) => `import ${JSON.stringify(m)};`).join("\n");
-  return `import React from 'react';
-import { Composition, registerRoot } from 'remotion';
-import { WavesComposition, globalRegistry, registerBuiltInComponents } from '@depths/waves/remotion';
-${registrationImports}
-
-registerBuiltInComponents();
-
-const ir = ${JSON.stringify(ir, null, 2)};
-const compositionId = ${JSON.stringify(compositionId)};
-
-const Root = () => {
-  return <WavesComposition ir={ir} registry={globalRegistry} />;
-};
-
-export const RemotionRoot = () => {
-  return (
-    <Composition
-      id={compositionId}
-      component={Root}
-      durationInFrames={${durationInFrames}}
-      fps={${fps}}
-      width={${width}}
-      height={${height}}
-    />
-  );
-};
-
-registerRoot(RemotionRoot);
-`;
-}
-
-export {
-  __wavesVersion,
-  getSystemPrompt,
-  getPromptPayload,
-  IRValidator,
-  WavesEngine
-};

package/dist/registry-hVIyqwS6.d.mts

@@ -1,355 +0,0 @@
-import { z } from 'zod';
-import { ComponentType } from 'react';
-
-interface ComponentMetadata {
-    category: 'primitive' | 'composite' | 'template';
-    description: string;
-    llmGuidance?: string;
-    examples?: Array<Record<string, unknown>>;
-}
-interface RegisteredComponent<P = unknown> {
-    type: string;
-    component: ComponentType<P>;
-    propsSchema: z.ZodType<P>;
-    metadata: ComponentMetadata;
-}
-type PropsValidationResult = {
-    success: true;
-    data: unknown;
-} | {
-    success: false;
-    error: z.ZodError;
-};
-declare class ComponentRegistry {
-    private readonly components;
-    register<P>(registration: RegisteredComponent<P>): void;
-    get(type: string): RegisteredComponent | undefined;
-    getTypes(): string[];
-    has(type: string): boolean;
-    getJSONSchemaForLLM(): Record<string, unknown>;
-    validateProps(type: string, props: unknown): PropsValidationResult;
-}
-declare const globalRegistry: ComponentRegistry;
-
-type TimingSpec = {
-    from: number;
-    durationInFrames: number;
-};
-type BackgroundSpec = {
-    type: 'color';
-    value: string;
-} | {
-    type: 'image';
-    value: string;
-} | {
-    type: 'video';
-    value: string;
-};
-type BaseComponentIR = {
-    id: string;
-    type: string;
-    timing: TimingSpec;
-    metadata?: Record<string, unknown> | undefined;
-};
-type TextIR = BaseComponentIR & {
-    type: 'Text';
-    props: {
-        content: string;
-        fontSize?: number;
-        color?: string;
-        position?: 'top' | 'center' | 'bottom' | 'left' | 'right';
-        animation?: 'none' | 'fade' | 'slide' | 'zoom';
-    };
-};
-type AudioIR = BaseComponentIR & {
-    type: 'Audio';
-    props: {
-        src: string;
-        volume?: number;
-        startFrom?: number;
-        fadeIn?: number;
-        fadeOut?: number;
-    };
-};
-type SceneIR = BaseComponentIR & {
-    type: 'Scene';
-    props: {
-        background: BackgroundSpec;
-    };
-    children?: ComponentIR[] | undefined;
-};
-type ComponentIR = SceneIR | TextIR | AudioIR;
-type VideoIR = {
-    version: '1.0';
-    video: {
-        id?: string;
-        width: number;
-        height: number;
-        fps?: number;
-        durationInFrames: number;
-    };
-    audio?: {
-        background?: string | undefined;
-        volume?: number | undefined;
-    } | undefined;
-    scenes: SceneIR[];
-};
-declare const TimingSpecSchema: z.ZodObject<{
-    from: z.ZodNumber;
-    durationInFrames: z.ZodNumber;
-}, z.core.$strip>;
-declare const AssetPathSchema: z.ZodString;
-declare const BackgroundSpecSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    type: z.ZodLiteral<"color">;
-    value: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"image">;
-    value: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"video">;
-    value: z.ZodString;
-}, z.core.$strip>], "type">;
-declare const BaseComponentIRSchema: z.ZodObject<{
-    id: z.ZodString;
-    type: z.ZodString;
-    timing: z.ZodObject<{
-        from: z.ZodNumber;
-        durationInFrames: z.ZodNumber;
-    }, z.core.$strip>;
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$strip>;
-declare const TextComponentIRSchema: z.ZodObject<{
-    id: z.ZodString;
-    timing: z.ZodObject<{
-        from: z.ZodNumber;
-        durationInFrames: z.ZodNumber;
-    }, z.core.$strip>;
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    type: z.ZodLiteral<"Text">;
-    props: z.ZodObject<{
-        content: z.ZodString;
-        fontSize: z.ZodDefault<z.ZodNumber>;
-        color: z.ZodDefault<z.ZodString>;
-        position: z.ZodDefault<z.ZodEnum<{
-            top: "top";
-            center: "center";
-            bottom: "bottom";
-            left: "left";
-            right: "right";
-        }>>;
-        animation: z.ZodDefault<z.ZodEnum<{
-            fade: "fade";
-            none: "none";
-            slide: "slide";
-            zoom: "zoom";
-        }>>;
-    }, z.core.$strip>;
-}, z.core.$strip>;
-declare const AudioComponentIRSchema: z.ZodObject<{
-    id: z.ZodString;
-    timing: z.ZodObject<{
-        from: z.ZodNumber;
-        durationInFrames: z.ZodNumber;
-    }, z.core.$strip>;
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    type: z.ZodLiteral<"Audio">;
-    props: z.ZodObject<{
-        src: z.ZodString;
-        volume: z.ZodDefault<z.ZodNumber>;
-        startFrom: z.ZodDefault<z.ZodNumber>;
-        fadeIn: z.ZodDefault<z.ZodNumber>;
-        fadeOut: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strip>;
-}, z.core.$strip>;
-declare const SceneComponentIRSchema: z.ZodObject<{
-    id: z.ZodString;
-    timing: z.ZodObject<{
-        from: z.ZodNumber;
-        durationInFrames: z.ZodNumber;
-    }, z.core.$strip>;
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    type: z.ZodLiteral<"Scene">;
-    props: z.ZodObject<{
-        background: z.ZodDiscriminatedUnion<[z.ZodObject<{
-            type: z.ZodLiteral<"color">;
-            value: z.ZodString;
-        }, z.core.$strip>, z.ZodObject<{
-            type: z.ZodLiteral<"image">;
-            value: z.ZodString;
-        }, z.core.$strip>, z.ZodObject<{
-            type: z.ZodLiteral<"video">;
-            value: z.ZodString;
-        }, z.core.$strip>], "type">;
-    }, z.core.$strip>;
-    children: z.ZodOptional<z.ZodLazy<z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>>;
-}, z.core.$strip>;
-declare const ComponentIRSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    id: z.ZodString;
-    timing: z.ZodObject<{
-        from: z.ZodNumber;
-        durationInFrames: z.ZodNumber;
-    }, z.core.$strip>;
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    type: z.ZodLiteral<"Scene">;
-    props: z.ZodObject<{
-        background: z.ZodDiscriminatedUnion<[z.ZodObject<{
-            type: z.ZodLiteral<"color">;
-            value: z.ZodString;
-        }, z.core.$strip>, z.ZodObject<{
-            type: z.ZodLiteral<"image">;
-            value: z.ZodString;
-        }, z.core.$strip>, z.ZodObject<{
-            type: z.ZodLiteral<"video">;
-            value: z.ZodString;
-        }, z.core.$strip>], "type">;
-    }, z.core.$strip>;
-    children: z.ZodOptional<z.ZodLazy<z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>>;
-}, z.core.$strip>, z.ZodObject<{
-    id: z.ZodString;
-    timing: z.ZodObject<{
-        from: z.ZodNumber;
-        durationInFrames: z.ZodNumber;
-    }, z.core.$strip>;
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    type: z.ZodLiteral<"Text">;
-    props: z.ZodObject<{
-        content: z.ZodString;
-        fontSize: z.ZodDefault<z.ZodNumber>;
-        color: z.ZodDefault<z.ZodString>;
-        position: z.ZodDefault<z.ZodEnum<{
-            top: "top";
-            center: "center";
-            bottom: "bottom";
-            left: "left";
-            right: "right";
-        }>>;
-        animation: z.ZodDefault<z.ZodEnum<{
-            fade: "fade";
-            none: "none";
-            slide: "slide";
-            zoom: "zoom";
-        }>>;
-    }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-    id: z.ZodString;
-    timing: z.ZodObject<{
-        from: z.ZodNumber;
-        durationInFrames: z.ZodNumber;
-    }, z.core.$strip>;
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    type: z.ZodLiteral<"Audio">;
-    props: z.ZodObject<{
-        src: z.ZodString;
-        volume: z.ZodDefault<z.ZodNumber>;
-        startFrom: z.ZodDefault<z.ZodNumber>;
-        fadeIn: z.ZodDefault<z.ZodNumber>;
-        fadeOut: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strip>;
-}, z.core.$strip>], "type">;
-declare const VideoIRSchema: z.ZodObject<{
-    version: z.ZodLiteral<"1.0">;
-    video: z.ZodObject<{
-        id: z.ZodDefault<z.ZodString>;
-        width: z.ZodNumber;
-        height: z.ZodNumber;
-        fps: z.ZodDefault<z.ZodNumber>;
-        durationInFrames: z.ZodNumber;
-    }, z.core.$strip>;
-    audio: z.ZodOptional<z.ZodObject<{
-        background: z.ZodOptional<z.ZodString>;
-        volume: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strip>>;
-    scenes: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        timing: z.ZodObject<{
-            from: z.ZodNumber;
-            durationInFrames: z.ZodNumber;
-        }, z.core.$strip>;
-        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        type: z.ZodLiteral<"Scene">;
-        props: z.ZodObject<{
-            background: z.ZodDiscriminatedUnion<[z.ZodObject<{
-                type: z.ZodLiteral<"color">;
-                value: z.ZodString;
-            }, z.core.$strip>, z.ZodObject<{
-                type: z.ZodLiteral<"image">;
-                value: z.ZodString;
-            }, z.core.$strip>, z.ZodObject<{
-                type: z.ZodLiteral<"video">;
-                value: z.ZodString;
-            }, z.core.$strip>], "type">;
-        }, z.core.$strip>;
-        children: z.ZodOptional<z.ZodLazy<z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-declare const ComponentSchemas: {
-    readonly Scene: z.ZodObject<{
-        id: z.ZodString;
-        timing: z.ZodObject<{
-            from: z.ZodNumber;
-            durationInFrames: z.ZodNumber;
-        }, z.core.$strip>;
-        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        type: z.ZodLiteral<"Scene">;
-        props: z.ZodObject<{
-            background: z.ZodDiscriminatedUnion<[z.ZodObject<{
-                type: z.ZodLiteral<"color">;
-                value: z.ZodString;
-            }, z.core.$strip>, z.ZodObject<{
-                type: z.ZodLiteral<"image">;
-                value: z.ZodString;
-            }, z.core.$strip>, z.ZodObject<{
-                type: z.ZodLiteral<"video">;
-                value: z.ZodString;
-            }, z.core.$strip>], "type">;
-        }, z.core.$strip>;
-        children: z.ZodOptional<z.ZodLazy<z.ZodArray<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>>;
-    }, z.core.$strip>;
-    readonly Text: z.ZodObject<{
-        id: z.ZodString;
-        timing: z.ZodObject<{
-            from: z.ZodNumber;
-            durationInFrames: z.ZodNumber;
-        }, z.core.$strip>;
-        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        type: z.ZodLiteral<"Text">;
-        props: z.ZodObject<{
-            content: z.ZodString;
-            fontSize: z.ZodDefault<z.ZodNumber>;
-            color: z.ZodDefault<z.ZodString>;
-            position: z.ZodDefault<z.ZodEnum<{
-                top: "top";
-                center: "center";
-                bottom: "bottom";
-                left: "left";
-                right: "right";
-            }>>;
-            animation: z.ZodDefault<z.ZodEnum<{
-                fade: "fade";
-                none: "none";
-                slide: "slide";
-                zoom: "zoom";
-            }>>;
-        }, z.core.$strip>;
-    }, z.core.$strip>;
-    readonly Audio: z.ZodObject<{
-        id: z.ZodString;
-        timing: z.ZodObject<{
-            from: z.ZodNumber;
-            durationInFrames: z.ZodNumber;
-        }, z.core.$strip>;
-        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        type: z.ZodLiteral<"Audio">;
-        props: z.ZodObject<{
-            src: z.ZodString;
-            volume: z.ZodDefault<z.ZodNumber>;
-            startFrom: z.ZodDefault<z.ZodNumber>;
-            fadeIn: z.ZodDefault<z.ZodNumber>;
-            fadeOut: z.ZodDefault<z.ZodNumber>;
-        }, z.core.$strip>;
-    }, z.core.$strip>;
-};
-
-declare function registerBuiltInComponents(): void;
-
-export { AssetPathSchema as A, type BackgroundSpec as B, ComponentRegistry as C, SceneComponentIRSchema as S, TextComponentIRSchema as T, type VideoIR as V, AudioComponentIRSchema as a, type AudioIR as b, BackgroundSpecSchema as c, type BaseComponentIR as d, BaseComponentIRSchema as e, type ComponentIR as f, ComponentIRSchema as g, ComponentSchemas as h, type SceneIR as i, type TextIR as j, type TimingSpec as k, TimingSpecSchema as l, VideoIRSchema as m, globalRegistry as n, registerBuiltInComponents as r };