@aspects-ai/workspace-cli 0.1.7 → 0.1.10

package/README.md

@@ -98,6 +98,47 @@ This command will:
 4. Update `workspace.config.json` with the new version and commit hash
 5. Update dependencies in `package.json` if they changed
 
+### `create-remotion-entry`
+
+Generate a `remotion-entry.tsx` file for server-side rendering of Remotion compositions.
+
+```bash
+workspace-cli create-remotion-entry
+```
+
+Options:
+- `-o, --output <path>` - Output path for remotion-entry.tsx (default: `remotion-entry.tsx`)
+- `-f, --frames-dir <path>` - Path to frames directory (default: `frames`)
+
+This command will:
+1. Scan the frames directory for all frame subdirectories
+2. Validate that each frame has a `main.tsx` file
+3. Generate a `remotion-entry.tsx` file with all frames imported and registered
+4. Display the list of registered frames
+
+Example output:
+```
+[INFO] Scanning frames in: frames
+[SUCCESS] Created remotion entry file: /path/to/remotion-entry.tsx
+
+Registered 3 frame(s):
+  • example
+  • healthee
+  • peregrine
+
+Next steps:
+  Render a frame: ANIMATION_SSR_MODE=true npx remotion render remotion-entry.tsx <frame-id> output.mp4
+```
+
+The generated file can be used with Remotion CLI for server-side rendering:
+```bash
+# Render a specific frame
+ANIMATION_SSR_MODE=true npx remotion render remotion-entry.tsx example output.mp4
+
+# List available compositions
+ANIMATION_SSR_MODE=true npx remotion compositions remotion-entry.tsx
+```
+
 ## Usage Examples
 
 ### Basic Workflow

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command7 } from "commander";
+import { Command as Command8 } from "commander";
 
 // src/commands/init.ts
 import { Command } from "commander";
@@ -436,6 +436,9 @@ import chalk5 from "chalk";
 import { Command as Command5 } from "commander";
 import fs5 from "fs-extra";
 import path5 from "path";
+function generateId() {
+  return Math.floor(Math.random() * Number.MAX_SAFE_INTEGER).toString();
+}
 function parseManifestOption(manifestStr) {
   try {
     return JSON.parse(manifestStr);
@@ -446,7 +449,8 @@ function parseManifestOption(manifestStr) {
 function validateAndFixManifest(manifest, toolName, frameName) {
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const validatedManifest = {
-    id: manifest.id || frameName,
+    id: frameName,
+    // Always match the directory name
     projectId: manifest.projectId || "default-project",
     title: manifest.title || frameName.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" "),
     description: manifest.description || `Frame for ${toolName}`,
@@ -459,17 +463,20 @@ function validateAndFixManifest(manifest, toolName, frameName) {
   }
   return validatedManifest;
 }
-async function getNextFrameName(framesDir, baseName) {
-  if (!await fs5.pathExists(path5.join(framesDir, baseName))) {
-    return baseName;
+async function getNextFrameName(framesDir, customName) {
+  let frameName;
+  if (customName) {
+    const truncatedName = customName.slice(0, 20);
+    const uniqueId = generateId();
+    frameName = `${truncatedName}-${uniqueId}`;
+  } else {
+    frameName = generateId();
   }
-  let counter = 1;
-  let nextName = `${baseName}-${counter}`;
-  while (await fs5.pathExists(path5.join(framesDir, nextName))) {
-    counter++;
-    nextName = `${baseName}-${counter}`;
+  while (await fs5.pathExists(path5.join(framesDir, frameName))) {
+    const uniqueId = generateId();
+    frameName = customName ? `${customName.slice(0, 20)}-${uniqueId}` : uniqueId;
   }
-  return nextName;
+  return frameName;
 }
 async function fetchExampleFrame(toolName, targetPath) {
   const library = await getLibrary(toolName);
@@ -490,8 +497,8 @@ function createCreateFrameCommand() {
       const workspaceRoot = await ensureWorkspaceRoot();
       const framesDir = path5.join(workspaceRoot, "frames");
       await fs5.ensureDir(framesDir);
-      const baseName = options.name || "new-frame";
-      const frameName = await getNextFrameName(framesDir, baseName);
+      const customName = options.name && options.name !== "new-frame" ? options.name : void 0;
+      const frameName = await getNextFrameName(framesDir, customName);
       const frameDir = path5.join(framesDir, frameName);
       logger.info(`Creating frame: ${chalk5.cyan(frameName)} for ${chalk5.cyan(toolName)}`);
       await fetchExampleFrame(toolName, frameDir);
@@ -588,10 +595,105 @@ async function fetchFileFromGit(options) {
   }
 }
 
+// src/commands/create-remotion-entry.ts
+import chalk7 from "chalk";
+import { Command as Command7 } from "commander";
+import fs7 from "fs-extra";
+import path7 from "path";
+async function createRemotionEntry(framesDir, outputPath) {
+  if (!await fs7.pathExists(framesDir)) {
+    throw new Error(`Frames directory not found: ${framesDir}`);
+  }
+  const entries = await fs7.readdir(framesDir, { withFileTypes: true });
+  const frameDirs = entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+  if (frameDirs.length === 0) {
+    throw new Error(`No frame directories found in ${framesDir}`);
+  }
+  const validFrames = [];
+  for (const frameDir of frameDirs) {
+    const mainPath = path7.join(framesDir, frameDir, "main.tsx");
+    if (await fs7.pathExists(mainPath)) {
+      validFrames.push(frameDir);
+    } else {
+      logger.warn(`Skipping ${frameDir}: main.tsx not found`);
+    }
+  }
+  if (validFrames.length === 0) {
+    throw new Error("No valid frames found (frames must contain main.tsx)");
+  }
+  const imports = validFrames.map((frameDir, index) => {
+    const varName = `Frame${index}`;
+    const defName = `frame${index}Def`;
+    return {
+      frameDir,
+      varName,
+      defName,
+      statement: `import ${varName}, { compositionDefinition as ${defName} } from './frames/${frameDir}/main';`
+    };
+  });
+  const framesObject = imports.map(({ frameDir, varName, defName }) => {
+    return `  '${frameDir}': { component: ${varName}, compositionDefinition: ${defName} },`;
+  }).join("\n");
+  const content = `/**
+ * Auto-generated Remotion SSR Entry Point
+ *
+ * Generated by: @aspects-ai/workspace-cli create-remotion-entry
+ * DO NOT EDIT THIS FILE MANUALLY - it will be overwritten
+ *
+ * This file serves as the entry point for server-side rendering with Remotion.
+ * It automatically registers all frames in the ./frames directory.
+ *
+ * Usage:
+ *   ANIMATION_SSR_MODE=true npx remotion render remotion-entry.tsx <frame-id> output.mp4
+ *
+ * To regenerate this file:
+ *   npx @aspects-ai/workspace-cli create-remotion-entry
+ */
+
+import { registerRoot } from 'remotion';
+import { createRemotionRoot } from '@aspects-ai/noodle-animate-core/remotion';
+
+// Frame imports
+${imports.map((i) => i.statement).join("\n")}
+
+// Register all frames with Remotion
+const Root = createRemotionRoot({
+${framesObject}
+});
+
+registerRoot(Root);
+`;
+  await fs7.writeFile(outputPath, content, "utf-8");
+  logger.success(`Created remotion entry file: ${chalk7.green(outputPath)}`);
+  logger.log("");
+  logger.log(chalk7.bold(`Registered ${validFrames.length} frame(s):`));
+  validFrames.forEach((frame) => {
+    logger.log(`  ${chalk7.cyan("\u2022")} ${frame}`);
+  });
+  logger.log("");
+  logger.log(chalk7.bold("Next steps:"));
+  logger.log(`  ${chalk7.gray("Render a frame:")} ANIMATION_SSR_MODE=true npx remotion render remotion-entry.tsx <frame-id> output.mp4`);
+  logger.log("");
+}
+function createCreateRemotionEntryCommand() {
+  return new Command7("create-remotion-entry").description("Create a remotion-entry.tsx file for server-side rendering").option("-o, --output <path>", "Output path for remotion-entry.tsx", "remotion-entry.tsx").option("-f, --frames-dir <path>", "Path to frames directory", "frames").action(async (options) => {
+    try {
+      const workspaceRoot = await ensureWorkspaceRoot();
+      const framesDir = path7.resolve(workspaceRoot, options.framesDir || "frames");
+      const outputPath = path7.resolve(workspaceRoot, options.output || "remotion-entry.tsx");
+      logger.info(`Scanning frames in: ${chalk7.cyan(path7.relative(workspaceRoot, framesDir))}`);
+      await createRemotionEntry(framesDir, outputPath);
+    } catch (error) {
+      logger.error(error.message);
+      process.exit(1);
+    }
+  });
+}
+
 // package.json
 var package_default = {
   name: "@aspects-ai/workspace-cli",
-  version: "0.1.6",
+  version: "0.1.9",
   private: false,
   description: "Lightweight CLI for installing libraries into workspaces",
   type: "module",
@@ -627,7 +729,7 @@ var package_default = {
 };
 
 // src/index.ts
-var program = new Command7();
+var program = new Command8();
 program.name("workspace-cli").description("Lightweight CLI for installing libraries into workspaces").version(package_default.version);
 program.addCommand(createInitCommand());
 program.addCommand(createListCommand());
@@ -635,4 +737,5 @@ program.addCommand(createAddCommand());
 program.addCommand(createUpdateCommand());
 program.addCommand(createCreateFrameCommand());
 program.addCommand(createUpdateTemplateCommand());
+program.addCommand(createCreateRemotionEntryCommand());
 program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aspects-ai/workspace-cli",
-  "version": "0.1.7",
+  "version": "0.1.10",
   "private": false,
   "description": "Lightweight CLI for installing libraries into workspaces",
   "type": "module",
@@ -33,4 +33,4 @@
   "engines": {
     "node": ">=18.0.0"
   }
-}
+}