@remotion-studio/sdk 0.1.0

package/dist/shared/artifact.d.ts

@@ -0,0 +1,58 @@
+export type MotionGraphicsEditType = "tool_edit" | "full_replacement";
+export type MotionGraphicsPresetReference = {
+    id: string;
+    name: string;
+    source: "builtin" | "custom";
+};
+export declare const MOTION_GRAPHICS_ARTIFACT_VERSION: 1;
+export declare const MOTION_GRAPHICS_RUNTIME: "remotion-dynamic-v1";
+export declare const DEFAULT_MOTION_GRAPHICS_WIDTH = 1920;
+export declare const DEFAULT_MOTION_GRAPHICS_HEIGHT = 1080;
+export declare const DEFAULT_MOTION_GRAPHICS_FPS = 30;
+export declare const DEFAULT_MOTION_GRAPHICS_DURATION_IN_FRAMES = 180;
+export type MotionGraphicsArtifactV1 = {
+    version: typeof MOTION_GRAPHICS_ARTIFACT_VERSION;
+    runtime: typeof MOTION_GRAPHICS_RUNTIME;
+    code: string;
+    composition: {
+        width: number;
+        height: number;
+        fps: number;
+        durationInFrames: number;
+    };
+    metadata: {
+        model: string;
+        skills: string[];
+        editType: MotionGraphicsEditType;
+        summary: string;
+        preset?: MotionGraphicsPresetReference;
+    };
+};
+export type MotionGraphicsArtifact = MotionGraphicsArtifactV1;
+export type MotionGraphicsCompositionProps = {
+    artifact: MotionGraphicsArtifact;
+    componentProps?: Record<string, unknown>;
+};
+type CreateMotionGraphicsArtifactParams = {
+    code: string;
+    summary?: string;
+    model?: string;
+    skills?: string[];
+    editType?: MotionGraphicsEditType;
+    preset?: MotionGraphicsPresetReference;
+    width?: number;
+    height?: number;
+    fps?: number;
+    durationInFrames?: number;
+};
+export declare const createMotionGraphicsArtifact: ({ code, summary, model, skills, editType, preset, width, height, fps, durationInFrames, }: CreateMotionGraphicsArtifactParams) => MotionGraphicsArtifactV1;
+export declare const calculateMotionGraphicsMetadata: ({ props, }: {
+    props: MotionGraphicsCompositionProps;
+}) => {
+    width: number;
+    height: number;
+    fps: number;
+    durationInFrames: number;
+    props: MotionGraphicsCompositionProps;
+};
+export {};

package/dist/shared/artifact.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateMotionGraphicsMetadata = exports.createMotionGraphicsArtifact = exports.DEFAULT_MOTION_GRAPHICS_DURATION_IN_FRAMES = exports.DEFAULT_MOTION_GRAPHICS_FPS = exports.DEFAULT_MOTION_GRAPHICS_HEIGHT = exports.DEFAULT_MOTION_GRAPHICS_WIDTH = exports.MOTION_GRAPHICS_RUNTIME = exports.MOTION_GRAPHICS_ARTIFACT_VERSION = void 0;
+exports.MOTION_GRAPHICS_ARTIFACT_VERSION = 1;
+exports.MOTION_GRAPHICS_RUNTIME = "remotion-dynamic-v1";
+exports.DEFAULT_MOTION_GRAPHICS_WIDTH = 1920;
+exports.DEFAULT_MOTION_GRAPHICS_HEIGHT = 1080;
+exports.DEFAULT_MOTION_GRAPHICS_FPS = 30;
+exports.DEFAULT_MOTION_GRAPHICS_DURATION_IN_FRAMES = 180;
+const createMotionGraphicsArtifact = ({ code, summary = "", model = "unknown", skills = [], editType = "full_replacement", preset, width = exports.DEFAULT_MOTION_GRAPHICS_WIDTH, height = exports.DEFAULT_MOTION_GRAPHICS_HEIGHT, fps = exports.DEFAULT_MOTION_GRAPHICS_FPS, durationInFrames = exports.DEFAULT_MOTION_GRAPHICS_DURATION_IN_FRAMES, }) => {
+    return {
+        version: exports.MOTION_GRAPHICS_ARTIFACT_VERSION,
+        runtime: exports.MOTION_GRAPHICS_RUNTIME,
+        code,
+        composition: {
+            width,
+            height,
+            fps,
+            durationInFrames,
+        },
+        metadata: {
+            model,
+            skills,
+            editType,
+            summary,
+            ...(preset ? { preset } : {}),
+        },
+    };
+};
+exports.createMotionGraphicsArtifact = createMotionGraphicsArtifact;
+const calculateMotionGraphicsMetadata = ({ props, }) => {
+    const { composition } = props.artifact;
+    return {
+        width: composition.width,
+        height: composition.height,
+        fps: composition.fps,
+        durationInFrames: composition.durationInFrames,
+        props,
+    };
+};
+exports.calculateMotionGraphicsMetadata = calculateMotionGraphicsMetadata;

package/dist/shared/sanitize.d.ts

@@ -0,0 +1,3 @@
+export declare function stripMarkdownFences(code: string): string;
+export declare function extractComponentCode(code: string): string;
+export declare function sanitizeGeneratedCode(code: string): string;

package/dist/shared/sanitize.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripMarkdownFences = stripMarkdownFences;
+exports.extractComponentCode = extractComponentCode;
+exports.sanitizeGeneratedCode = sanitizeGeneratedCode;
+function stripMarkdownFences(code) {
+    let result = code;
+    result = result.replace(/^```(?:tsx?|jsx?)?\n?/, "");
+    result = result.replace(/\n?```\s*$/, "");
+    return result.trim();
+}
+function extractComponentCode(code) {
+    const exportMatch = code.match(/export\s+const\s+\w+\s*(?::[\s\S]*?)?=\s*\([\s\S]*?\)\s*=>\s*\{/);
+    if (exportMatch && exportMatch.index !== undefined) {
+        const declarationStart = exportMatch.index;
+        const bodyStart = declarationStart + exportMatch[0].length;
+        let braceCount = 1;
+        let endIndex = bodyStart;
+        for (let i = bodyStart; i < code.length; i++) {
+            const char = code[i];
+            if (char === "{") {
+                braceCount++;
+            }
+            else if (char === "}") {
+                braceCount--;
+                if (braceCount === 0) {
+                    endIndex = i;
+                    break;
+                }
+            }
+        }
+        if (braceCount === 0) {
+            let result = code.slice(0, endIndex + 1);
+            if (!result.trim().endsWith(";")) {
+                result = result.trimEnd() + ";";
+            }
+            return result.trim();
+        }
+    }
+    return code;
+}
+function sanitizeGeneratedCode(code) {
+    const withoutFences = stripMarkdownFences(code);
+    const firstImport = withoutFences.indexOf("import ");
+    const firstExport = withoutFences.indexOf("export const ");
+    const startIndex = firstImport >= 0 ? firstImport : firstExport >= 0 ? firstExport : 0;
+    return extractComponentCode(withoutFences.slice(startIndex).trim());
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@remotion-studio/sdk",
+  "version": "0.1.0",
+  "private": false,
+  "description": "Official Remotion Studio package for generating, editing, playing, and rendering AI-powered Remotion compositions.",
+  "packageManager": "bun@1.3.3",
+  "homepage": "https://remotionstudio.io",
+  "keywords": [
+    "remotion",
+    "video",
+    "animation",
+    "motion-graphics",
+    "api",
+    "mcp",
+    "ai",
+    "sdk",
+    "openai",
+    "react",
+    "creative-tools",
+    "generative-ui"
+  ],
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/sdk/index.d.ts",
+      "import": "./dist/sdk/index.js",
+      "require": "./dist/sdk/index.js",
+      "default": "./dist/sdk/index.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "import": "./dist/runtime/index.js",
+      "require": "./dist/runtime/index.js",
+      "default": "./dist/runtime/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@babel/standalone": "^7.28.5",
+    "@remotion/lottie": "^4.0.429",
+    "@remotion/shapes": "^4.0.429",
+    "@remotion/three": "^4.0.429",
+    "@remotion/transitions": "^4.0.429",
+    "react": "^19.2.1",
+    "remotion": "^4.0.429",
+    "three": "^0.178.0"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "test": "bun test ./test",
+    "deploy": "npm publish"
+  }
+}