@rendiv/studio 0.1.4 → 0.1.6

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 export { startStudio, type StudioOptions, type StudioResult } from './start-studio.js';
+export { startStudioWorkspace, type WorkspaceOptions, type WorkspaceResult } from './start-studio-workspace.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACvF,OAAO,EAAE,oBAAoB,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -1,2 +1,3 @@
 export { startStudio } from './start-studio.js';
+export { startStudioWorkspace } from './start-studio-workspace.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAyC,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAyC,MAAM,mBAAmB,CAAC;AACvF,OAAO,EAAE,oBAAoB,EAA+C,MAAM,6BAA6B,CAAC"}

package/dist/scaffold-project.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Scaffold a new Rendiv project in the given workspace directory.
+ * Returns a promise that resolves when the project is fully created and deps installed.
+ * Calls `onProgress` with status messages for the UI.
+ */
+export declare function scaffoldProject(workspaceDir: string, name: string, onProgress?: (message: string) => void): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+//# sourceMappingURL=scaffold-project.d.ts.map

package/dist/scaffold-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-project.d.ts","sourceRoot":"","sources":["../src/scaffold-project.ts"],"names":[],"mappings":"AA6HA;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACrC,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA8D/C"}

package/dist/scaffold-project.js

@@ -0,0 +1,181 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+// --- Inline project template (same as create-rendiv) ---
+const PACKAGE_JSON_TEMPLATE = `{
+  "name": "{{PROJECT_NAME}}",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "preview": "vite dev",
+    "studio": "rendiv studio src/index.tsx",
+    "render": "rendiv render src/index.tsx MyVideo out/my-video.mp4",
+    "still": "rendiv still src/index.tsx MyVideo out/still.png",
+    "compositions": "rendiv compositions src/index.tsx"
+  },
+  "dependencies": {
+    "@rendiv/core": "^0.1.0",
+    "@rendiv/player": "^0.1.0",
+    "@rendiv/cli": "^0.1.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^4.3.0",
+    "vite": "^6.0.0",
+    "typescript": "^5.7.0"
+  }
+}
+`;
+const TSCONFIG_JSON = `{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true
+  },
+  "include": ["src"]
+}
+`;
+const VITE_CONFIG = `import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+
+export default defineConfig({
+  plugins: [react()],
+});
+`;
+const GITIGNORE = `node_modules
+dist
+out
+.studio
+`;
+const INDEX_TSX = `import React from 'react';
+import { setRootComponent, Composition } from '@rendiv/core';
+import { MyVideo } from './MyVideo';
+
+const Root: React.FC = () => (
+  <Composition
+    id="MyVideo"
+    component={MyVideo}
+    durationInFrames={150}
+    fps={30}
+    width={1920}
+    height={1080}
+  />
+);
+
+setRootComponent(Root);
+`;
+const MY_VIDEO_TSX = `import React from 'react';
+import { useFrame, useCompositionConfig, Fill, interpolate, spring } from '@rendiv/core';
+
+export const MyVideo: React.FC = () => {
+  const frame = useFrame();
+  const { fps, durationInFrames } = useCompositionConfig();
+
+  const opacity = interpolate(frame, [0, 30], [0, 1]);
+  const scale = spring({ frame, fps, config: { damping: 12 } });
+  const progress = frame / durationInFrames;
+
+  return (
+    <Fill
+      style={{
+        background: \`linear-gradient(135deg, #0f0f0f \${(1 - progress) * 100}%, #1a1a2e 100%)\`,
+        display: 'flex',
+        alignItems: 'center',
+        justifyContent: 'center',
+      }}
+    >
+      <h1
+        style={{
+          color: 'white',
+          fontSize: 80,
+          fontFamily: 'system-ui, sans-serif',
+          opacity,
+          transform: \`scale(\${scale})\`,
+        }}
+      >
+        Hello, Rendiv!
+      </h1>
+    </Fill>
+  );
+};
+`;
+function detectPackageManager() {
+    const agent = process.env.npm_config_user_agent ?? '';
+    if (agent.startsWith('pnpm'))
+        return 'pnpm';
+    if (agent.startsWith('yarn'))
+        return 'yarn';
+    if (agent.startsWith('bun'))
+        return 'bun';
+    return 'npm';
+}
+/**
+ * Scaffold a new Rendiv project in the given workspace directory.
+ * Returns a promise that resolves when the project is fully created and deps installed.
+ * Calls `onProgress` with status messages for the UI.
+ */
+export async function scaffoldProject(workspaceDir, name, onProgress) {
+    const projectDir = path.join(workspaceDir, name);
+    // Validate name
+    if (!/^[a-zA-Z0-9_-]+$/.test(name)) {
+        return { success: false, error: 'Project name must only contain letters, numbers, hyphens, and underscores.' };
+    }
+    if (fs.existsSync(projectDir)) {
+        return { success: false, error: `Directory "${name}" already exists.` };
+    }
+    try {
+        onProgress?.('Creating project files...');
+        // Create directories
+        fs.mkdirSync(path.join(projectDir, 'src'), { recursive: true });
+        // Write template files
+        const pkgJson = PACKAGE_JSON_TEMPLATE.replace(/\{\{PROJECT_NAME\}\}/g, name);
+        fs.writeFileSync(path.join(projectDir, 'package.json'), pkgJson);
+        fs.writeFileSync(path.join(projectDir, 'tsconfig.json'), TSCONFIG_JSON);
+        fs.writeFileSync(path.join(projectDir, 'vite.config.ts'), VITE_CONFIG);
+        fs.writeFileSync(path.join(projectDir, '.gitignore'), GITIGNORE);
+        fs.writeFileSync(path.join(projectDir, 'src', 'index.tsx'), INDEX_TSX);
+        fs.writeFileSync(path.join(projectDir, 'src', 'MyVideo.tsx'), MY_VIDEO_TSX);
+        onProgress?.('Installing dependencies...');
+        // Install dependencies
+        const pm = detectPackageManager();
+        await new Promise((resolve, reject) => {
+            const child = spawn(pm, ['install'], {
+                cwd: projectDir,
+                stdio: 'pipe',
+                shell: true,
+            });
+            child.stdout?.on('data', (data) => {
+                const line = data.toString().trim();
+                if (line)
+                    onProgress?.(line);
+            });
+            child.stderr?.on('data', (data) => {
+                const line = data.toString().trim();
+                if (line)
+                    onProgress?.(line);
+            });
+            child.on('close', (code) => {
+                if (code === 0)
+                    resolve();
+                else
+                    reject(new Error(`${pm} install exited with code ${code}`));
+            });
+            child.on('error', reject);
+        });
+        onProgress?.('Project created successfully!');
+        return { success: true };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { success: false, error: message };
+    }
+}
+//# sourceMappingURL=scaffold-project.js.map

package/dist/scaffold-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold-project.js","sourceRoot":"","sources":["../src/scaffold-project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,0DAA0D;AAE1D,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;CA0B7B,CAAC;AAEF,MAAM,aAAa,GAAG;;;;;;;;;;;;;CAarB,CAAC;AAEF,MAAM,WAAW,GAAG;;;;;;CAMnB,CAAC;AAEF,MAAM,SAAS,GAAG;;;;CAIjB,CAAC;AAEF,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;CAgBjB,CAAC;AAEF,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCpB,CAAC;AAEF,SAAS,oBAAoB;IAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,EAAE,CAAC;IACtD,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAC5C,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAC5C,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,YAAoB,EACpB,IAAY,EACZ,UAAsC;IAEtC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IAEjD,gBAAgB;IAChB,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,4EAA4E,EAAE,CAAC;IACjH,CAAC;IAED,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,IAAI,mBAAmB,EAAE,CAAC;IAC1E,CAAC;IAED,IAAI,CAAC;QACH,UAAU,EAAE,CAAC,2BAA2B,CAAC,CAAC;QAE1C,qBAAqB;QACrB,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhE,uBAAuB;QACvB,MAAM,OAAO,GAAG,qBAAqB,CAAC,OAAO,CAAC,uBAAuB,EAAE,IAAI,CAAC,CAAC;QAC7E,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC;QACjE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,EAAE,aAAa,CAAC,CAAC;QACxE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,EAAE,WAAW,CAAC,CAAC;QACvE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,SAAS,CAAC,CAAC;QACjE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,WAAW,CAAC,EAAE,SAAS,CAAC,CAAC;QACvE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,aAAa,CAAC,EAAE,YAAY,CAAC,CAAC;QAE5E,UAAU,EAAE,CAAC,4BAA4B,CAAC,CAAC;QAE3C,uBAAuB;QACvB,MAAM,EAAE,GAAG,oBAAoB,EAAE,CAAC;QAClC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE;gBACnC,GAAG,EAAE,UAAU;gBACf,KAAK,EAAE,MAAM;gBACb,KAAK,EAAE,IAAI;aACZ,CAAC,CAAC;YAEH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;gBACxC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;gBACpC,IAAI,IAAI;oBAAE,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;gBACxC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;gBACpC,IAAI,IAAI;oBAAE,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACzB,IAAI,IAAI,KAAK,CAAC;oBAAE,OAAO,EAAE,CAAC;;oBACrB,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,EAAE,6BAA6B,IAAI,EAAE,CAAC,CAAC,CAAC;YACnE,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,UAAU,EAAE,CAAC,+BAA+B,CAAC,CAAC;QAC9C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAC5C,CAAC;AACH,CAAC"}

package/dist/start-studio-workspace.d.ts

@@ -0,0 +1,16 @@
+export interface WorkspaceOptions {
+    workspaceDir: string;
+    port?: number;
+    host?: string;
+}
+export interface WorkspaceResult {
+    url: string;
+    close: () => Promise<void>;
+}
+/**
+ * Start Studio in workspace mode.
+ * Manages the lifecycle of switching between the workspace picker and individual project studios.
+ * All servers run on the same port — only one is active at a time.
+ */
+export declare function startStudioWorkspace(options: WorkspaceOptions): Promise<WorkspaceResult>;
+//# sourceMappingURL=start-studio-workspace.d.ts.map

package/dist/start-studio-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-studio-workspace.d.ts","sourceRoot":"","sources":["../src/start-studio-workspace.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AA4BD;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CA+E9F"}

package/dist/start-studio-workspace.js

@@ -0,0 +1,110 @@
+import path from 'node:path';
+import fs from 'node:fs';
+import { startStudio } from './start-studio.js';
+import { startWorkspacePicker } from './workspace-picker-server.js';
+/**
+ * Find the entry point for a Rendiv project.
+ * Checks src/index.tsx first, then parses package.json scripts.
+ */
+function findEntryPoint(projectDir) {
+    // Check common default
+    if (fs.existsSync(path.join(projectDir, 'src', 'index.tsx'))) {
+        return path.join(projectDir, 'src', 'index.tsx');
+    }
+    // Check package.json scripts for "rendiv studio <entry>"
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(projectDir, 'package.json'), 'utf-8'));
+        const studioScript = pkg.scripts?.studio;
+        if (studioScript) {
+            const match = studioScript.match(/rendiv\s+studio\s+(\S+)/);
+            if (match)
+                return path.join(projectDir, match[1]);
+        }
+    }
+    catch {
+        // ignore
+    }
+    // Fallback
+    return path.join(projectDir, 'src', 'index.tsx');
+}
+/**
+ * Start Studio in workspace mode.
+ * Manages the lifecycle of switching between the workspace picker and individual project studios.
+ * All servers run on the same port — only one is active at a time.
+ */
+export async function startStudioWorkspace(options) {
+    const { workspaceDir, port = 3000, host } = options;
+    let currentClose = null;
+    let switching = false;
+    let firstLaunch = true;
+    async function switchTo(projectPath) {
+        if (switching)
+            return;
+        switching = true;
+        try {
+            // Close the current server
+            if (currentClose) {
+                await currentClose();
+                currentClose = null;
+            }
+            if (projectPath) {
+                // Start project Studio
+                const entryPoint = findEntryPoint(projectPath);
+                const originalCwd = process.cwd();
+                process.chdir(projectPath);
+                try {
+                    const result = await startStudio({
+                        entryPoint,
+                        port,
+                        host,
+                        workspaceDir,
+                        onSwitchProject: (p) => switchTo(p),
+                    });
+                    currentClose = result.close;
+                }
+                catch (err) {
+                    // If project Studio fails, fall back to workspace picker
+                    process.chdir(originalCwd);
+                    const result = await startWorkspacePicker({
+                        workspaceDir,
+                        port,
+                        host,
+                        onSwitchProject: (p) => switchTo(p),
+                        openBrowser: false,
+                    });
+                    currentClose = result.close;
+                }
+            }
+            else {
+                // Start workspace picker
+                // Ensure CWD is the workspace dir
+                process.chdir(workspaceDir);
+                const result = await startWorkspacePicker({
+                    workspaceDir,
+                    port,
+                    host,
+                    onSwitchProject: (p) => switchTo(p),
+                    openBrowser: firstLaunch,
+                });
+                currentClose = result.close;
+            }
+        }
+        finally {
+            switching = false;
+        }
+    }
+    // Start with workspace picker
+    await switchTo(null);
+    firstLaunch = false;
+    const url = `http://localhost:${port}`;
+    return {
+        url,
+        close: async () => {
+            if (currentClose) {
+                await currentClose();
+                currentClose = null;
+            }
+        },
+    };
+}
+//# sourceMappingURL=start-studio-workspace.js.map

package/dist/start-studio-workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-studio-workspace.js","sourceRoot":"","sources":["../src/start-studio-workspace.ts"],"names":[],"mappings":"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"}

package/dist/start-studio.d.ts

@@ -1,7 +1,12 @@
 export interface StudioOptions {
     entryPoint: string;
     port?: number;
+    host?: string;
     publicDir?: string;
+    /** When set, Studio is workspace-aware and shows a "Back to projects" button. */
+    workspaceDir?: string;
+    /** Callback to switch projects. Called with project path or null (back to picker). */
+    onSwitchProject?: (projectPath: string | null) => void;
 }
 export interface StudioResult {
     url: string;

package/dist/start-studio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start-studio.d.ts","sourceRoot":"","sources":["../src/start-studio.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAOD,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAwE/E"}
+{"version":3,"file":"start-studio.d.ts","sourceRoot":"","sources":["../src/start-studio.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,eAAe,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACxD;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAOD,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CA2E/E"}

package/dist/start-studio.js

@@ -3,14 +3,14 @@ import react from '@vitejs/plugin-react';
 import path from 'node:path';
 import fs from 'node:fs';
 import { fileURLToPath } from 'node:url';
-import { generateStudioEntryCode, generateStudioHtml, FAVICON_SVG } from './studio-entry-code.js';
+import { generateStudioEntryCode, generateStudioHtml, generateStudioGlobals, FAVICON_SVG } from './studio-entry-code.js';
 import { rendivStudioPlugin } from './vite-plugin-studio.js';
 const STUDIO_DIR = '.studio';
 const ENTRY_FILE = 'entry.tsx';
 const HTML_FILE = 'studio.html';
 const FAVICON_FILE = 'favicon.svg';
 export async function startStudio(options) {
-    const { entryPoint, port = 3000, publicDir = 'public' } = options;
+    const { entryPoint, port = 3000, host, publicDir = 'public', workspaceDir, onSwitchProject } = options;
     const cwd = process.cwd();
     const absoluteEntry = path.isAbsolute(entryPoint)
         ? entryPoint
@@ -25,7 +25,8 @@ export async function startStudio(options) {
     const studioHtmlFile = `${STUDIO_DIR}/${HTML_FILE}`;
     const studioFaviconFile = `${STUDIO_DIR}/${FAVICON_FILE}`;
     const entryCode = generateStudioEntryCode(absoluteEntry, studioUiDir, entryPoint);
-    const htmlCode = generateStudioHtml(studioEntryFile, studioFaviconFile);
+    const globalsScript = generateStudioGlobals(entryPoint, workspaceDir);
+    const htmlCode = generateStudioHtml(studioEntryFile, studioFaviconFile, globalsScript);
     fs.writeFileSync(path.join(studioDir, ENTRY_FILE), entryCode);
     fs.writeFileSync(path.join(studioDir, HTML_FILE), htmlCode);
     fs.writeFileSync(path.join(studioDir, FAVICON_FILE), FAVICON_SVG);
@@ -38,7 +39,7 @@ export async function startStudio(options) {
         publicDir: path.resolve(cwd, publicDir),
         plugins: [
             react(),
-            rendivStudioPlugin({ studioHtmlFileName: studioHtmlFile, entryPoint: absoluteEntry }),
+            rendivStudioPlugin({ studioHtmlFileName: studioHtmlFile, entryPoint: absoluteEntry, workspaceDir, onSwitchProject }),
         ],
         resolve: {
             // Force Vite to resolve these packages from the user's project root,
@@ -47,7 +48,9 @@ export async function startStudio(options) {
         },
         server: {
             port,
-            open: true,
+            host: host || undefined,
+            // Don't auto-open browser on workspace restarts — the browser is already open
+            open: !onSwitchProject,
         },
         optimizeDeps: {
             entries: [studioEntryFile],

package/dist/start-studio.js.map

@@ -1 +1 @@
-{"version":3,"file":"start-studio.js","sourceRoot":"","sources":["../src/start-studio.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"start-studio.js","sourceRoot":"","sources":["../src/start-studio.ts"],"names":[],"mappings":"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"}

package/dist/studio-entry-code.d.ts

@@ -3,11 +3,16 @@
  * This code imports the user's entry (which calls setRootComponent),
  * then mounts the Studio React UI shell.
  */
-export declare function generateStudioEntryCode(userEntryPoint: string, studioUiDir: string, relativeEntryPoint: string): string;
+export declare function generateStudioEntryCode(userEntryPoint: string, studioUiDir: string, relativeEntryPoint: string, workspaceDir?: string): string;
+/**
+ * Generates a small inline script that sets global config before module scripts load.
+ * This runs synchronously before ES module imports, ensuring globals are available.
+ */
+export declare function generateStudioGlobals(relativeEntryPoint: string, workspaceDir?: string): string;
 /** Favicon SVG content (icon-only version of the Rendiv logo). */
 export declare const FAVICON_SVG = "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 48 48\" fill=\"none\">\n  <rect x=\"6\" y=\"8\" width=\"26\" height=\"20\" rx=\"3\" stroke=\"#58a6ff\" stroke-width=\"2\" opacity=\"0.35\"/>\n  <rect x=\"12\" y=\"14\" width=\"26\" height=\"20\" rx=\"3\" stroke=\"#58a6ff\" stroke-width=\"2\"/>\n  <clipPath id=\"ic\"><rect x=\"12\" y=\"14\" width=\"26\" height=\"20\" rx=\"3\"/></clipPath>\n  <g clip-path=\"url(#ic)\"><polygon points=\"12,34 30,14 38,14 38,34\" fill=\"#58a6ff\" opacity=\"0.25\"/></g>\n  <path d=\"M22 20L30 24L22 28Z\" fill=\"#58a6ff\"/>\n</svg>";
 /**
  * Generates the HTML template for the Studio shell.
  */
-export declare function generateStudioHtml(entryFileName: string, faviconPath: string): string;
+export declare function generateStudioHtml(entryFileName: string, faviconPath: string, globalsScript?: string): string;
 //# sourceMappingURL=studio-entry-code.d.ts.map

package/dist/studio-entry-code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"studio-entry-code.d.ts","sourceRoot":"","sources":["../src/studio-entry-code.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,kBAAkB,EAAE,MAAM,GACzB,MAAM,CAYR;AAED,kEAAkE;AAClE,eAAO,MAAM,WAAW,+jBAMjB,CAAC;AAER;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAkBrF"}
+{"version":3,"file":"studio-entry-code.d.ts","sourceRoot":"","sources":["../src/studio-entry-code.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,kBAAkB,EAAE,MAAM,EAC1B,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAWR;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,kBAAkB,EAAE,MAAM,EAC1B,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAQR;AAED,kEAAkE;AAClE,eAAO,MAAM,WAAW,+jBAMjB,CAAC;AAER;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAsB7G"}

package/dist/studio-entry-code.js

@@ -3,18 +3,30 @@
  * This code imports the user's entry (which calls setRootComponent),
  * then mounts the Studio React UI shell.
  */
-export function generateStudioEntryCode(userEntryPoint, studioUiDir, relativeEntryPoint) {
+export function generateStudioEntryCode(userEntryPoint, studioUiDir, relativeEntryPoint, workspaceDir) {
     // Normalize backslashes to forward slashes for import paths
     const normalizedEntry = userEntryPoint.replace(/\\/g, '/');
     const normalizedUiDir = studioUiDir.replace(/\\/g, '/');
     return `
-window.__RENDIV_STUDIO_ENTRY__ = ${JSON.stringify(relativeEntryPoint)};
 import '${normalizedEntry}';
 import { createStudioApp } from '${normalizedUiDir}/StudioApp.tsx';
 
 createStudioApp(document.getElementById('root'));
 `;
 }
+/**
+ * Generates a small inline script that sets global config before module scripts load.
+ * This runs synchronously before ES module imports, ensuring globals are available.
+ */
+export function generateStudioGlobals(relativeEntryPoint, workspaceDir) {
+    const lines = [
+        `window.__RENDIV_STUDIO_ENTRY__ = ${JSON.stringify(relativeEntryPoint)};`,
+    ];
+    if (workspaceDir) {
+        lines.push(`window.__RENDIV_WORKSPACE_DIR__ = ${JSON.stringify(workspaceDir)};`);
+    }
+    return lines.join('\n');
+}
 /** Favicon SVG content (icon-only version of the Rendiv logo). */
 export const FAVICON_SVG = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 48" fill="none">
   <rect x="6" y="8" width="26" height="20" rx="3" stroke="#58a6ff" stroke-width="2" opacity="0.35"/>
@@ -26,7 +38,10 @@ export const FAVICON_SVG = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0
 /**
  * Generates the HTML template for the Studio shell.
  */
-export function generateStudioHtml(entryFileName, faviconPath) {
+export function generateStudioHtml(entryFileName, faviconPath, globalsScript) {
+    const globalsTag = globalsScript
+        ? `\n  <script>${globalsScript}</script>`
+        : '';
     return `<!DOCTYPE html>
 <html lang="en">
 <head>
@@ -40,7 +55,7 @@ export function generateStudioHtml(entryFileName, faviconPath) {
   </style>
 </head>
 <body>
-  <div id="root"></div>
+  <div id="root"></div>${globalsTag}
   <script type="module" src="/${entryFileName}"></script>
 </body>
 </html>`;

package/dist/studio-entry-code.js.map

@@ -1 +1 @@
-{"version":3,"file":"studio-entry-code.js","sourceRoot":"","sources":["../src/studio-entry-code.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,cAAsB,EACtB,WAAmB,EACnB,kBAA0B;IAE1B,4DAA4D;IAC5D,MAAM,eAAe,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC3D,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAExD,OAAO;mCAC0B,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC;UAC3D,eAAe;mCACU,eAAe;;;CAGjD,CAAC;AACF,CAAC;AAED,kEAAkE;AAClE,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;OAMpB,CAAC;AAER;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,aAAqB,EAAE,WAAmB;IAC3E,OAAO;;;;;iDAKwC,WAAW;;;;;;;;;gCAS5B,aAAa;;QAErC,CAAC;AACT,CAAC"}
+{"version":3,"file":"studio-entry-code.js","sourceRoot":"","sources":["../src/studio-entry-code.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,cAAsB,EACtB,WAAmB,EACnB,kBAA0B,EAC1B,YAAqB;IAErB,4DAA4D;IAC5D,MAAM,eAAe,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC3D,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAExD,OAAO;UACC,eAAe;mCACU,eAAe;;;CAGjD,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,kBAA0B,EAC1B,YAAqB;IAErB,MAAM,KAAK,GAAG;QACZ,oCAAoC,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,GAAG;KAC1E,CAAC;IACF,IAAI,YAAY,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC,qCAAqC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,kEAAkE;AAClE,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;OAMpB,CAAC;AAER;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,aAAqB,EAAE,WAAmB,EAAE,aAAsB;IACnG,MAAM,UAAU,GAAG,aAAa;QAC9B,CAAC,CAAC,eAAe,aAAa,WAAW;QACzC,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;;;;;iDAKwC,WAAW;;;;;;;;yBAQnC,UAAU;gCACH,aAAa;;QAErC,CAAC;AACT,CAAC"}

package/dist/vite-plugin-studio.d.ts

@@ -2,6 +2,10 @@ import type { Plugin } from 'vite';
 export interface StudioPluginOptions {
     studioHtmlFileName: string;
     entryPoint: string;
+    /** When set, Studio is in workspace mode and shows workspace controls. */
+    workspaceDir?: string;
+    /** Callback to switch projects. Pass null to go back to workspace picker. */
+    onSwitchProject?: (projectPath: string | null) => void;
 }
 export declare function rendivStudioPlugin(options: StudioPluginOptions): Plugin;
 //# sourceMappingURL=vite-plugin-studio.d.ts.map

package/dist/vite-plugin-studio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vite-plugin-studio.d.ts","sourceRoot":"","sources":["../src/vite-plugin-studio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAMnC,MAAM,WAAW,mBAAmB;IAClC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAgKD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAyPvE"}
+{"version":3,"file":"vite-plugin-studio.d.ts","sourceRoot":"","sources":["../src/vite-plugin-studio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAKnC,MAAM,WAAW,mBAAmB;IAClC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACxD;AAgKD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAqQvE"}