motionrender 0.0.0-stage → 0.2.1

package/dist/types/packages/schema/src/variables.d.ts

@@ -0,0 +1,115 @@
+import { z } from 'zod';
+export declare const colorPattern: RegExp;
+export declare const listFieldSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+        color: "color";
+    }>;
+    default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const variableSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+        color: "color";
+        list: "list";
+    }>;
+    default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    description: z.ZodOptional<z.ZodString>;
+    items: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            color: "color";
+        }>;
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const variablesSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    type: z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+        color: "color";
+        list: "list";
+    }>;
+    default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    description: z.ZodOptional<z.ZodString>;
+    items: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            color: "color";
+        }>;
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>>;
+export declare const componentSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            color: "color";
+            list: "list";
+        }>;
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+        description: z.ZodOptional<z.ZodString>;
+        items: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                color: "color";
+            }>;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+    layers: z.ZodArray<z.ZodUnknown>;
+}, z.core.$strip>;
+export declare const componentsSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            color: "color";
+            list: "list";
+        }>;
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+        description: z.ZodOptional<z.ZodString>;
+        items: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                color: "color";
+            }>;
+            default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+    layers: z.ZodArray<z.ZodUnknown>;
+}, z.core.$strip>>;
+export type VariableDeclaration = z.infer<typeof variableSchema>;
+export type ListItem = Record<string, unknown>;
+export type VariableValue = string | number | boolean | ListItem[];
+export declare class VariableError extends Error {
+    readonly problems: string[];
+    constructor(problems: string[]);
+}
+export declare function coerceVariable(label: string, declaration: VariableDeclaration | z.infer<typeof listFieldSchema>, value: unknown): VariableValue;
+export declare function resolveVariables(declarations: Record<string, VariableDeclaration>, supplied?: Record<string, unknown>): Record<string, VariableValue>;
+export declare function substituteVariables(raw: unknown, values: Record<string, VariableValue>, extra?: Record<string, unknown>): unknown;
+export declare const interpolate: (template: string, values: Record<string, VariableValue>) => string;

package/dist/types/packages/storage/src/index.d.ts

@@ -0,0 +1,78 @@
+import { type Revision, type RevisionMeta } from '../../ai/src/index.js';
+export type { Revision, RevisionMeta };
+/** Who is asking. Local use has one fixed principal; a hosted API makes one per signed-in user. */
+export type Principal = {
+    userId: string;
+    tenantId: string;
+};
+export declare const LOCAL_PRINCIPAL: Principal;
+export type StoredAsset = {
+    name: string;
+    path: string;
+    kind: string;
+    bytes: number;
+};
+export interface ProjectStore {
+    /** Folder names under the principal's space; not every one is a valid project. */
+    ids(who: Principal): Promise<string[]>;
+    exists(who: Principal, id: string): Promise<boolean>;
+    /** Makes an empty project folder named after `name` and gives its id (a name that is taken gets -2, -3, ...). */
+    create(who: Principal, name: string): Promise<string>;
+    readRaw(who: Principal, id: string): Promise<any>;
+    /** With `meta`, the change is kept as a numbered revision (and what was there before, the first time). */
+    writeRaw(who: Principal, id: string, raw: unknown, meta?: RevisionMeta): Promise<void>;
+    modified(who: Principal, id: string): Promise<number>;
+    duplicate(who: Principal, id: string, rename: (raw: any) => any): Promise<string>;
+    /** Moves the project aside so it can be brought back by hand. */
+    trash(who: Principal, id: string): Promise<void>;
+    assets(who: Principal, id: string): Promise<StoredAsset[]>;
+    putAsset(who: Principal, id: string, name: string, bytes: Buffer): Promise<StoredAsset[]>;
+    /** The saved thumbnail, only while it is newer than the composition. */
+    thumb(who: Principal, id: string): Promise<Buffer | undefined>;
+    putThumb(who: Principal, id: string, png: Buffer): Promise<void>;
+    revisions(who: Principal, id: string): Promise<Revision[]>;
+    restore(who: Principal, id: string, n: number): Promise<Revision>;
+    /** Bytes this principal's projects take up on disk. */
+    usedBytes(who: Principal): Promise<number>;
+    /** A local folder with the project's files, for work that needs real files. Call commit() when the work wrote something. */
+    workdir(who: Principal, id: string): Promise<{
+        dir: string;
+        commit(): Promise<void>;
+    }>;
+}
+export declare const assetKinds: Record<string, string>;
+export declare const slugify: (text: string) => string;
+/** True when target is a file or folder strictly below root (root itself is not allowed). */
+export declare function within(root: string, target: string): boolean;
+/** Projects as folders under one root. The local principal uses the root itself; any other tenant gets its own folder, `_tenants/<id>`. */
+export declare class FsProjectStore implements ProjectStore {
+    readonly root: string;
+    constructor(root: string);
+    /** The folder this principal's projects live in. */
+    tenantRoot(who: Principal): string;
+    /** A path inside the principal's space: relative values resolve from `base` (default: the space itself), absolute ones must already be inside. */
+    resolve(who: Principal, value: string, label?: string, base?: string): string;
+    /** The path as the studio shows and serves it: forward slashes, relative to the principal's space. */
+    relative(who: Principal, file: string): string;
+    projectDir(who: Principal, id: string): string;
+    private file;
+    ids(who: Principal): Promise<string[]>;
+    exists(who: Principal, id: string): Promise<boolean>;
+    create(who: Principal, name: string): Promise<string>;
+    readRaw(who: Principal, id: string): Promise<any>;
+    writeRaw(who: Principal, id: string, raw: unknown, meta?: RevisionMeta): Promise<void>;
+    modified(who: Principal, id: string): Promise<number>;
+    duplicate(who: Principal, id: string, rename: (raw: any) => any): Promise<string>;
+    trash(who: Principal, id: string): Promise<void>;
+    assets(who: Principal, id: string): Promise<StoredAsset[]>;
+    putAsset(who: Principal, id: string, name: string, bytes: Buffer): Promise<StoredAsset[]>;
+    thumb(who: Principal, id: string): Promise<NonSharedBuffer | undefined>;
+    putThumb(who: Principal, id: string, png: Buffer): Promise<void>;
+    usedBytes(who: Principal): Promise<number>;
+    revisions(who: Principal, id: string): Promise<Revision[]>;
+    restore(who: Principal, id: string, n: number): Promise<Revision>;
+    workdir(who: Principal, id: string): Promise<{
+        dir: string;
+        commit: () => Promise<void>;
+    }>;
+}

package/dist/types/packages/timeline/src/index.d.ts

@@ -0,0 +1,104 @@
+import type { Composition, Layer } from '../../schema/src/index.js';
+export type UnitValues = {
+    x?: number;
+    y?: number;
+    opacity?: number;
+    scale?: number;
+    rotation?: number;
+    blur?: number;
+    color?: string;
+};
+export type EvaluatedLayer = Layer & {
+    evaluated: Record<string, number | string>;
+    localFrame: number;
+    children?: EvaluatedLayer[];
+    units?: UnitValues[];
+    morph?: {
+        from: string;
+        to: string;
+        t: number;
+    };
+};
+type SplitAnimation = {
+    property: string;
+    keyframes: {
+        frame: number;
+        value: number | string;
+        easing?: any;
+    }[];
+};
+export declare function splitPresetAnimations(preset: string, duration: number, fontSize: number): SplitAnimation[];
+export declare function splitCount(layer: any): number;
+export declare const frameToSeconds: (frame: number, fps: number) => number;
+export declare const secondsToFrame: (seconds: number, fps: number) => number;
+type Transition = NonNullable<Composition['scenes'][number]['transitionIn']>;
+export declare function transitionState(effects: {
+    transition: Transition;
+    progress: number;
+}[], width: number, height: number): {
+    x: number;
+    y: number;
+    opacity: number;
+    scale: number;
+    clip: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | undefined;
+    clipPath: string | undefined;
+    blur: number;
+    overlay: {
+        color: string;
+        opacity: number;
+    } | undefined;
+};
+export declare function cameraState(camera: NonNullable<Composition['scenes'][number]['camera']>, frame: number, width: number, height: number): {
+    x: number;
+    y: number;
+    zoom: number;
+    rotation: number;
+};
+export declare function evaluateFrame(composition: Composition, frame: number): EvaluatedLayer[];
+export declare function videoFrameIndex(layer: {
+    trimStart: number;
+    playbackRate: number;
+    loop: boolean;
+}, ownFrame: number, frameCount: number): number;
+export type LayerWindow = {
+    layer: Layer;
+    startFrame: number;
+    endFrame: number;
+};
+export type AudioWindow = LayerWindow;
+export declare function layerWindows(composition: Composition, include: (layer: Layer) => boolean): LayerWindow[];
+export declare const audioWindows: (composition: Composition) => AudioWindow[];
+export type SoundMedia = Record<string, {
+    duration: number;
+    segments: {
+        start: number;
+        end: number;
+    }[];
+}>;
+export type Duck = {
+    amount: number;
+    attackFrames: number;
+    releaseFrames: number;
+    by?: string[];
+};
+export declare function soundIntervals(composition: Composition, media?: SoundMedia): {
+    layer: Layer;
+    intervals: [number, number][];
+}[];
+export declare function volumeEnvelope(options: {
+    layer: any;
+    fps: number;
+    start: number;
+    duration: number;
+    duck?: Duck;
+    others: {
+        layer: Layer;
+        intervals: [number, number][];
+    }[];
+}): [number, number][] | undefined;
+export {};

package/package.json

@@ -1,6 +1,80 @@
 {
   "name": "motionrender",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.1",
+  "description": "JSON-first, frame-deterministic motion graphics video engine: render compositions to MP4, WebM, ProRes, GIF or PNG frames from Node or the command line.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./player": {
+      "types": "./dist/player.d.ts",
+      "import": "./dist/player.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js"
+    },
+    "./builder": {
+      "types": "./dist/builder.d.ts",
+      "import": "./dist/builder.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "motionrender": "dist/cli.js",
+    "mr": "dist/cli.js",
+    "ove": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "blocks",
+    "themes",
+    "studio",
+    "skills",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "bullmq": "^5.81.5",
+    "pg": "^8.0.0",
+    "playwright": "^1.64.1",
+    "zod": "^4.6.7"
+  },
+  "keywords": [
+    "motionrender",
+    "motion-graphics",
+    "video",
+    "render",
+    "remotion-alternative",
+    "ffmpeg",
+    "json",
+    "animation",
+    "canvas",
+    "template"
+  ],
+  "peerDependencies": {
+    "@types/node": ">=22",
+    "react": ">=18",
+    "esbuild": ">=0.20"
+  },
+  "peerDependenciesMeta": {
+    "@types/node": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "esbuild": {
+      "optional": true
+    }
+  }
+}