@effect-motion/cli 0.2.0 → 0.4.0

package/README.md

@@ -1,32 +1,14 @@
 # @effect-motion/cli
 
-Command line for [effect-motion](https://github.com/julia-script/effect-motion): scaffold a project, preview scenes in the browser, render videos — all driven by one `motion.config.ts`.
+Command line for [effect-motion](https://github.com/julia-script/effect-motion): preview scenes in the browser and render videos — all driven by one `motion.config.ts`.
 
 ```sh
-npx @effect-motion/cli init    # scaffold a project
+pnpm create effect-motion      # scaffold a project (npm/yarn/bun create work too)
 motion studio                  # preview scenes with hot reload
 motion render                  # render every target to MP4
 ```
 
-## init
-
-`motion init [directory]` scaffolds a single-project workspace:
-
-```
-my-project/
-├─ src/
-│  ├─ scenes/hello-world.ts   # a scene: a module exporting `scene`
-│  ├─ assets/                 # static files
-│  └─ main.ts                 # the movie — an ordinary scene composing the others
-├─ motion.config.ts           # render targets
-├─ AGENTS.md                  # authoring rules for AI coding agents
-├─ package.json               # EXACT pins of effect-motion + effect
-└─ tsconfig.json
-```
-
-Answering `.` scaffolds into the current directory and names the project after it. The package-manager prompt defaults to whichever manager invoked the CLI; `--pm <pnpm|npm|yarn|bun>` and `--no-install` skip prompts/install.
-
-Dependency versions are pinned **exactly** — the `effect` pin is a determinism invariant (upgrading effect can change seeded random sequences), so upgrade both together, deliberately.
+Scaffolding lives in the [`create-effect-motion`](https://www.npmjs.com/package/create-effect-motion) package — this CLI is installed as a devDependency of the projects it creates.
 
 ## motion.config.ts
 

package/dist/Config.d.ts

@@ -6,20 +6,39 @@ import type * as Runner from "effect-motion/Runner";
  * ConfigLoader.ts.
  */
 /**
- * Per-target render settings: the Runner `Settings` subset an export can
- * honor, plus `dpr`. From the author's perspective dpr is a rendering
- * setting like width/height; the render command maps it to the export
- * package's supersampling option.
+ * Per-target playback settings: the Runner `Settings` subset an export can
+ * honor, plus `dpr` (mapped to the export package's supersampling option).
+ * Resolution and background are NOT here — they are the scene's own
+ * composition config, set in `Scene.make(gen, { width, height, backgroundColor })`.
  */
 export interface TargetSettings {
-    readonly width?: number;
-    readonly height?: number;
     readonly frameRate?: number;
     readonly seed?: Runner.Seed;
     readonly maxFrames?: number;
-    readonly backgroundColor?: Runner.Settings["backgroundColor"];
     readonly dpr?: number;
 }
+/**
+ * Studio preview options for a target's Player — how the scene PLAYS in
+ * `motion studio`, as opposed to `settings`, which is what the scene IS.
+ * `motion render` ignores them. Field meanings match `PlayerProps` in
+ * `@effect-motion/react`.
+ */
+export interface PlayerOptions {
+    readonly autoPlay?: boolean;
+    /**
+     * Preview-only frame rate (the Player's `fps` prop) — wins over
+     * `settings.frameRate` in the studio (e.g. preview a heavy 60fps target
+     * at 30). The scene RUNS at this rate, so previewed frames are not the
+     * export's frames.
+     */
+    readonly fps?: number;
+    /** Initial repeat mode; the studio's repeat button toggles it after. */
+    readonly defaultRepeatMode?: boolean;
+    /** Declare a never-ending scene so the player windows its buffer. */
+    readonly isInfinite?: boolean;
+    readonly prebufferedFrames?: number;
+    readonly bufferCapacity?: number;
+}
 /** v1 ships MP4 only; the field exists so more containers slot in later. */
 export type OutputFormat = "mp4";
 export interface MotionTarget {
@@ -28,6 +47,8 @@ export interface MotionTarget {
     /** Path to a module exporting `scene`, relative to the config file. */
     readonly scene: string;
     readonly settings?: TargetSettings;
+    /** Studio-only: how this target previews (autoplay, repeat, …). */
+    readonly player?: PlayerOptions;
     /** Output DIRECTORY (never a file), relative to the config file. */
     readonly output?: string;
     readonly format?: OutputFormat;
@@ -49,8 +70,6 @@ export declare const DEFAULT_FORMAT: OutputFormat;
 export declare const validateConfig: (value: unknown, configPath: string) => MotionConfig;
 /** Flag values a `motion render` invocation can lay over a target. */
 export interface RenderOverrides {
-    readonly width?: number;
-    readonly height?: number;
     readonly frameRate?: number;
     readonly dpr?: number;
     readonly seed?: Runner.Seed;

package/dist/MotionCliError.d.ts

@@ -4,7 +4,7 @@
  * signature; adding a failure mode is a union-member addition handled
  * exhaustively at exactly one place (the top-level reporter in bin.ts).
  */
-export type MotionCliReason = "ConfigNotFound" | "ConfigInvalid" | "SceneLoadFailed" | "UnknownTarget" | "ScaffoldTargetNotEmpty" | "ScaffoldFailed" | "InstallFailed" | "RenderFailed" | "StudioFailed";
+export type MotionCliReason = "ConfigNotFound" | "ConfigInvalid" | "SceneLoadFailed" | "UnknownTarget" | "RenderFailed" | "StudioFailed";
 declare const MotionCliError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
     readonly _tag: "MotionCliError";
 } & Readonly<A>;

package/dist/cli.d.ts

@@ -2,7 +2,7 @@ import * as Effect from "effect/Effect";
 import { CliError, Command } from "effect/unstable/cli";
 import { type MotionCliError } from "./MotionCliError.js";
 export declare const rootCommand: Command.Command<"motion", {}, {}, MotionCliError, never>;
-export declare const CLI_VERSION: "0.1.0";
+export declare const CLI_VERSION: string;
 /**
  * The single exhaustive failure boundary (design D3a): MotionCliError
  * prints its message (cause chain under --verbose) and sets a non-zero

package/dist/cli.js

@@ -1,18 +1,17 @@
+import { readFileSync } from "node:fs";
 import * as Console from "effect/Console";
 import * as Effect from "effect/Effect";
 import { CliError, Command, Flag, GlobalFlag } from "effect/unstable/cli";
-import { initCommand } from "./commands/init.js";
 import { renderCommand } from "./commands/render.js";
 import { studioCommand } from "./commands/studio.js";
 import { renderForTerminal } from "./MotionCliError.js";
-import { PINS } from "./pins.js";
 // registered globally so `--verbose` parses anywhere on the command line;
 // the reporter reads argv directly because it sits outside handler context
 const verboseFlag = GlobalFlag.setting("verbose")({
     flag: Flag.boolean("verbose").pipe(Flag.withDescription("Print full error cause chains")),
 });
-export const rootCommand = Command.make("motion").pipe(Command.withDescription("effect-motion: scaffold projects, preview scenes, render videos"), Command.withSubcommands([initCommand, studioCommand, renderCommand]), Command.withGlobalFlags([verboseFlag]));
-export const CLI_VERSION = PINS["@effect-motion/cli"];
+export const rootCommand = Command.make("motion").pipe(Command.withDescription("effect-motion: preview scenes and render videos (scaffold new projects with `pnpm create effect-motion`)"), Command.withSubcommands([studioCommand, renderCommand]), Command.withGlobalFlags([verboseFlag]));
+export const CLI_VERSION = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
 /**
  * The single exhaustive failure boundary (design D3a): MotionCliError
  * prints its message (cause chain under --verbose) and sets a non-zero

package/dist/commands/render.d.ts

@@ -5,8 +5,6 @@ import { Command } from "effect/unstable/cli";
 import { MotionCliError } from "../MotionCliError.js";
 export declare const renderCommand: Command.Command<"render", {
     readonly config: Option.Option<string>;
-    readonly width: Option.Option<number>;
-    readonly height: Option.Option<number>;
     readonly fps: Option.Option<number>;
     readonly dpr: Option.Option<number>;
     readonly seed: Option.Option<string>;

package/dist/commands/render.js

@@ -13,8 +13,6 @@ import { makeViteLoader } from "../ViteLoader.js";
 const opt = (o) => Option.getOrUndefined(o);
 const renderFlags = {
     config: Flag.optional(Flag.string("config").pipe(Flag.withDescription("Path to a motion.config.ts (tsc -p style)"))),
-    width: Flag.optional(Flag.integer("width")),
-    height: Flag.optional(Flag.integer("height")),
     fps: Flag.optional(Flag.integer("fps").pipe(Flag.withDescription("Frame rate override"))),
     dpr: Flag.optional(Flag.float("dpr").pipe(Flag.withDescription("Supersampling factor (output pixels = scene × dpr)"))),
     seed: Flag.optional(Flag.string("seed")),
@@ -26,8 +24,6 @@ const renderFlags = {
 };
 const overridesFrom = (input) => {
     const raw = {
-        width: opt(input.width),
-        height: opt(input.height),
         frameRate: opt(input.fps),
         dpr: opt(input.dpr),
         seed: opt(input.seed),

package/dist/commands/studio.js

@@ -61,6 +61,11 @@ const handler = (input) => Effect.gen(function* () {
                 resolve: {
                     dedupe: ["react", "react-dom", "effect", "effect-motion"],
                 },
+                // the studio app's JSX must not depend on the project's
+                // tsconfig — scaffolded projects set no `jsx`, and esbuild's
+                // fallback is the classic transform, which crashes with
+                // "React is not defined" before anything mounts
+                esbuild: { jsx: "automatic" },
                 plugins: [
                     {
                         name: "motion:project-watch",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@effect-motion/cli",
-  "version": "0.2.0",
-  "description": "Command line for effect-motion: scaffold projects (init), preview scenes with hot reload (studio), and render videos from motion.config.ts (render)",
+  "version": "0.4.0",
+  "description": "Command line for effect-motion: preview scenes with hot reload (studio) and render videos from motion.config.ts (render). Scaffold new projects with `pnpm create effect-motion`",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -31,7 +31,6 @@
   },
   "files": [
     "dist",
-    "templates",
     "studio-app"
   ],
   "publishConfig": {
@@ -41,8 +40,8 @@
     "@effect/platform-node": "4.0.0-beta.98",
     "effect": "4.0.0-beta.98",
     "vite": "^7.0.0",
-    "@effect-motion/export": "^0.3.0",
-    "effect-motion": "^0.3.0"
+    "@effect-motion/export": "^0.4.0",
+    "effect-motion": "^0.4.0"
   },
   "devDependencies": {
     "@types/node": "^26.1.1",
@@ -52,7 +51,7 @@
     "react-dom": "^19.2.0",
     "typescript": "^7.0.2",
     "vitest": "^4.1.10",
-    "@effect-motion/react": "^0.3.0"
+    "@effect-motion/react": "^0.4.0"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",

package/studio-app/App.tsx

@@ -9,9 +9,21 @@ type TargetLike = {
 	readonly name?: string;
 	readonly scene?: string;
 	readonly settings?: Record<string, unknown>;
+	readonly player?: Record<string, unknown>;
 };
 type ConfigLike = { readonly targets?: ReadonlyArray<TargetLike> };
 
+/** the PlayerProps subset a config's `player` block may set */
+type PlayerOptions = Pick<
+	PlayerProps,
+	| "autoPlay"
+	| "defaultRepeatMode"
+	| "isInfinite"
+	| "prebufferedFrames"
+	| "bufferCapacity"
+	| "fps"
+>;
+
 type SceneEntry = {
 	/** picker identity: `target:<name>` for config targets, `file:<path>` otherwise */
 	readonly key: string;
@@ -20,6 +32,8 @@ type SceneEntry = {
 	readonly path: string;
 	readonly registered: boolean;
 	readonly settings: PlayerProps["settings"] | undefined;
+	/** studio preview options from the target's `player` block */
+	readonly player: PlayerOptions | undefined;
 	readonly load: () => Promise<unknown>;
 };
 
@@ -59,6 +73,7 @@ const buildEntries = (config: ConfigLike | null): ReadonlyArray<SceneEntry> => {
 			// a registered scene previews with its target settings so the
 			// preview aspect matches the export
 			settings: target.settings as PlayerProps["settings"],
+			player: target.player as PlayerOptions | undefined,
 			load: globLoaders.get(path) ?? loadByAbsolutePath(path),
 		});
 	}
@@ -70,6 +85,7 @@ const buildEntries = (config: ConfigLike | null): ReadonlyArray<SceneEntry> => {
 			path,
 			registered: false,
 			settings: undefined,
+			player: undefined,
 			load,
 		});
 	}
@@ -174,17 +190,28 @@ export const App = () => {
 						<pre>{state.message}</pre>
 					</div>
 				)}
-				{state._tag === "ready" && (
-					<Player
-						key={state.key}
-						scene={state.scene}
-						autoPlay
-						defaultRepeatMode
-						{...(entry?.settings !== undefined
-							? { settings: entry.settings }
-							: {})}
-					/>
-				)}
+				{state._tag === "ready" &&
+					(() => {
+						// player.fps is a preview override of the scene's own rate,
+						// so it lands in settings.frameRate (the Player's one clock,
+						// which wins over its fps prop); everything else is a plain
+						// Player prop and wins over the studio defaults
+						const { fps, ...playerProps } = entry?.player ?? {};
+						const settings =
+							fps !== undefined
+								? { ...entry?.settings, frameRate: fps }
+								: entry?.settings;
+						return (
+							<Player
+								key={state.key}
+								scene={state.scene}
+								autoPlay
+								defaultRepeatMode
+								{...(settings !== undefined ? { settings } : {})}
+								{...playerProps}
+							/>
+						);
+					})()}
 				{(state._tag === "idle" || state._tag === "loading") &&
 					entries.length === 0 && (
 						<p className="studio-empty">

package/dist/commands/init.d.ts

@@ -1,9 +0,0 @@
-import * as Option from "effect/Option";
-import { Command, Prompt } from "effect/unstable/cli";
-import { ChildProcessSpawner } from "effect/unstable/process";
-import { MotionCliError } from "../MotionCliError.js";
-export declare const initCommand: Command.Command<"init", {
-    readonly directory: Option.Option<string>;
-    readonly pm: Option.Option<"bun" | "npm" | "pnpm" | "yarn">;
-    readonly noInstall: boolean;
-}, {}, MotionCliError, ChildProcessSpawner.ChildProcessSpawner | Prompt.Environment>;

package/dist/commands/init.js

@@ -1,94 +0,0 @@
-import * as Console from "effect/Console";
-import * as Effect from "effect/Effect";
-import * as Option from "effect/Option";
-import { Path } from "effect/Path";
-import { Argument, Command, Flag, Prompt } from "effect/unstable/cli";
-import { ChildProcess, ChildProcessSpawner } from "effect/unstable/process";
-import { MotionCliError } from "../MotionCliError.js";
-import { ensureEmptyDir, resolveProjectDir, scaffoldProject, } from "../scaffold.js";
-const PACKAGE_MANAGERS = ["pnpm", "npm", "yarn", "bun"];
-/** The manager that invoked us (`pnpm create …` etc.), if detectable. */
-const detectPackageManager = () => {
-    const agent = process.env.npm_config_user_agent ?? "";
-    return PACKAGE_MANAGERS.find((pm) => agent.startsWith(pm));
-};
-const initFlags = {
-    directory: Argument.string("directory").pipe(Argument.withDescription('Target directory ("." scaffolds into the current directory)'), Argument.optional),
-    pm: Flag.optional(Flag.choice("pm", PACKAGE_MANAGERS).pipe(Flag.withDescription("Package manager (skips the prompt)"))),
-    noInstall: Flag.boolean("no-install").pipe(Flag.withDescription("Skip dependency installation")),
-};
-const promptDirectory = Prompt.text({
-    message: 'Where should the project be created? ("." for the current directory)',
-    default: "my-motion-project",
-});
-const promptPackageManager = Effect.suspend(() => {
-    const detected = detectPackageManager();
-    // detected manager listed first so plain Enter picks it
-    const ordered = [
-        ...(detected ? [detected] : []),
-        ...PACKAGE_MANAGERS.filter((pm) => pm !== detected),
-    ];
-    return Prompt.select({
-        message: "Which package manager?",
-        choices: ordered.map((pm) => ({ title: pm, value: pm })),
-    });
-});
-const runInstall = (pm, dir) => Effect.gen(function* () {
-    const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
-    const command = ChildProcess.make(pm, ["install"], {
-        cwd: dir,
-        stdin: "inherit",
-        stdout: "inherit",
-        stderr: "inherit",
-    });
-    yield* Effect.scoped(Effect.gen(function* () {
-        const handle = yield* spawner.spawn(command);
-        const code = yield* handle.exitCode;
-        if (code !== 0) {
-            return yield* new MotionCliError({
-                reason: "InstallFailed",
-                message: `${pm} install exited with code ${code} in ${dir} — run it manually`,
-                cause: code,
-            });
-        }
-    })).pipe(Effect.catchTag("PlatformError", (cause) => Effect.fail(new MotionCliError({
-        reason: "InstallFailed",
-        message: `could not run "${pm} install" in ${dir} — is ${pm} installed?`,
-        cause,
-    }))));
-});
-const handler = (input) => Effect.gen(function* () {
-    const path = yield* Path;
-    const cwd = process.cwd();
-    const dirInput = Option.getOrUndefined(input.directory) ?? (yield* promptDirectory);
-    const { dir, name } = resolveProjectDir(path, cwd, dirInput);
-    yield* ensureEmptyDir(dir);
-    const pm = Option.getOrUndefined(input.pm) ?? (yield* promptPackageManager);
-    yield* scaffoldProject(dir, name);
-    yield* Console.log(`Scaffolded ${name} in ${dir}`);
-    if (input.noInstall) {
-        yield* Console.log([
-            "",
-            "Next steps:",
-            dir === cwd ? "" : `  cd ${path.relative(cwd, dir)}`,
-            `  ${pm} install`,
-            `  ${pm === "npm" ? "npm run" : pm} studio`,
-        ]
-            .filter((line) => line !== "")
-            .join("\n"));
-        return;
-    }
-    yield* runInstall(pm, dir);
-    yield* Console.log([
-        "",
-        `${name} is ready.`,
-        dir === cwd ? "" : `  cd ${path.relative(cwd, dir)}`,
-        `  ${pm === "npm" ? "npm run" : pm} studio    # preview scenes with hot reload`,
-        `  ${pm === "npm" ? "npm run" : pm} render    # render targets from motion.config.ts`,
-    ]
-        .filter((line) => line !== "")
-        .join("\n"));
-}).pipe(
-// ctrl-c in a prompt is an interruption, not a failure
-Effect.catchTag("QuitError", () => Effect.interrupt));
-export const initCommand = Command.make("init", initFlags, handler).pipe(Command.withDescription("Scaffold a new effect-motion project"));

package/dist/pins.d.ts

@@ -1,23 +0,0 @@
-/**
- * Exact versions a scaffolded project is pinned to — the set this CLI
- * release was built and tested against. The effect pin is a determinism
- * invariant (upgrading effect can change seeded random sequences), so
- * scaffolds never use ranges or `latest`. Updated by the CLI's own release
- * process.
- */
-export declare const PINS: {
-    readonly effect: "4.0.0-beta.98";
-    readonly "effect-motion": "0.2.0";
-    readonly "@effect-motion/react": "0.2.0";
-    readonly "@effect-motion/export": "0.2.0";
-    readonly "@effect-motion/cli": "0.1.0";
-};
-/** Non-determinism-critical companions; ranges are fine here. */
-export declare const COMPANIONS: {
-    readonly react: "^19.2.0";
-    readonly "react-dom": "^19.2.0";
-    readonly typescript: "^7.0.2";
-    readonly "@types/react": "^19.2.0";
-    readonly "@types/react-dom": "^19.2.0";
-    readonly "@types/node": "^26.1.1";
-};

package/dist/pins.js

@@ -1,23 +0,0 @@
-/**
- * Exact versions a scaffolded project is pinned to — the set this CLI
- * release was built and tested against. The effect pin is a determinism
- * invariant (upgrading effect can change seeded random sequences), so
- * scaffolds never use ranges or `latest`. Updated by the CLI's own release
- * process.
- */
-export const PINS = {
-    effect: "4.0.0-beta.98",
-    "effect-motion": "0.2.0",
-    "@effect-motion/react": "0.2.0",
-    "@effect-motion/export": "0.2.0",
-    "@effect-motion/cli": "0.1.0",
-};
-/** Non-determinism-critical companions; ranges are fine here. */
-export const COMPANIONS = {
-    react: "^19.2.0",
-    "react-dom": "^19.2.0",
-    typescript: "^7.0.2",
-    "@types/react": "^19.2.0",
-    "@types/react-dom": "^19.2.0",
-    "@types/node": "^26.1.1",
-};

package/dist/scaffold.d.ts

@@ -1,20 +0,0 @@
-import * as Effect from "effect/Effect";
-import { FileSystem } from "effect/FileSystem";
-import { Path } from "effect/Path";
-import { MotionCliError } from "./MotionCliError.js";
-/**
- * The non-interactive core of `motion init`: everything except the prompts,
- * so tests can drive it directly. Copies templates/default into the target
- * directory and generates package.json from the pinned versions.
- */
-/** Directory of the shipped templates (dist/scaffold.js → ../templates). */
-export declare const templatesDir: (path: Path) => string;
-/** `.` means "here"; the project is named after the resolved directory. */
-export declare const resolveProjectDir: (path: Path, cwd: string, input: string) => {
-    dir: string;
-    name: string;
-};
-/** Non-empty means anything but dotfiles (a fresh `git init` is fine). */
-export declare const ensureEmptyDir: (dir: string) => Effect.Effect<undefined, MotionCliError, FileSystem>;
-/** Copy the template tree + write the generated package.json. */
-export declare const scaffoldProject: (dir: string, name: string) => Effect.Effect<void, MotionCliError, FileSystem | Path>;

package/dist/scaffold.js

@@ -1,86 +0,0 @@
-import * as Effect from "effect/Effect";
-import { FileSystem } from "effect/FileSystem";
-import { Path } from "effect/Path";
-import { MotionCliError } from "./MotionCliError.js";
-import { COMPANIONS, PINS } from "./pins.js";
-/**
- * The non-interactive core of `motion init`: everything except the prompts,
- * so tests can drive it directly. Copies templates/default into the target
- * directory and generates package.json from the pinned versions.
- */
-/** Directory of the shipped templates (dist/scaffold.js → ../templates). */
-export const templatesDir = (path) => path.join(path.dirname(new URL(import.meta.url).pathname), "..", "templates", "default");
-/** `.` means "here"; the project is named after the resolved directory. */
-export const resolveProjectDir = (path, cwd, input) => {
-    const dir = path.resolve(cwd, input);
-    return { dir, name: path.basename(dir) };
-};
-/** Non-empty means anything but dotfiles (a fresh `git init` is fine). */
-export const ensureEmptyDir = (dir) => Effect.gen(function* () {
-    const fs = yield* FileSystem;
-    if (!(yield* fs.exists(dir)))
-        return;
-    const entries = yield* fs.readDirectory(dir);
-    const meaningful = entries.filter((entry) => !entry.startsWith("."));
-    if (meaningful.length > 0) {
-        return yield* new MotionCliError({
-            reason: "ScaffoldTargetNotEmpty",
-            message: `${dir} is not empty (found ${meaningful.slice(0, 3).join(", ")}${meaningful.length > 3 ? ", …" : ""}) — choose an empty or new directory`,
-        });
-    }
-}).pipe(wrapFsError("ScaffoldFailed", `could not inspect ${dir}`));
-const wrapFsError = (reason, message) => (effect) => Effect.mapError(effect, (cause) => cause instanceof MotionCliError
-    ? cause
-    : new MotionCliError({ reason, message, cause }));
-const packageJson = (name) => `${JSON.stringify({
-    name,
-    private: true,
-    version: "0.0.0",
-    type: "module",
-    scripts: {
-        studio: "motion studio",
-        render: "motion render",
-    },
-    dependencies: {
-        "@effect-motion/export": PINS["@effect-motion/export"],
-        "@effect-motion/react": PINS["@effect-motion/react"],
-        effect: PINS.effect,
-        "effect-motion": PINS["effect-motion"],
-        react: COMPANIONS.react,
-        "react-dom": COMPANIONS["react-dom"],
-    },
-    devDependencies: {
-        "@effect-motion/cli": PINS["@effect-motion/cli"],
-        "@types/node": COMPANIONS["@types/node"],
-        "@types/react": COMPANIONS["@types/react"],
-        "@types/react-dom": COMPANIONS["@types/react-dom"],
-        typescript: COMPANIONS.typescript,
-    },
-}, null, "\t")}\n`;
-/** Copy the template tree + write the generated package.json. */
-export const scaffoldProject = (dir, name) => Effect.gen(function* () {
-    const fs = yield* FileSystem;
-    const path = yield* Path;
-    const templates = templatesDir(path);
-    yield* fs.makeDirectory(dir, { recursive: true });
-    yield* copyTree(fs, path, templates, dir);
-    // npm mangles nested .gitignore/package.json files in published
-    // tarballs, so both ship outside the template tree
-    yield* fs.writeFileString(path.join(dir, "package.json"), packageJson(name));
-    yield* fs.rename(path.join(dir, "_gitignore"), path.join(dir, ".gitignore"));
-}).pipe(wrapFsError("ScaffoldFailed", `could not scaffold ${dir}`));
-const copyTree = (fs, path, from, to) => Effect.gen(function* () {
-    const entries = yield* fs.readDirectory(from);
-    for (const entry of entries) {
-        const src = path.join(from, entry);
-        const dst = path.join(to, entry);
-        const info = yield* fs.stat(src);
-        if (info.type === "Directory") {
-            yield* fs.makeDirectory(dst, { recursive: true });
-            yield* copyTree(fs, path, src, dst);
-        }
-        else {
-            yield* fs.copyFile(src, dst);
-        }
-    }
-});

package/templates/default/AGENTS.md

@@ -1,59 +0,0 @@
-# Working in this project
-
-This is an [effect-motion](https://github.com/julia-script/effect-motion) project: motion graphics written as deterministic, frame-exact scenes in TypeScript, rendered to video. Read this before writing or editing scenes.
-
-## Layout and commands
-
-- `src/scenes/*.ts` — one scene per module, each exporting `scene`. Any file here is previewable without registration.
-- `src/main.ts` — the movie: an ordinary scene that sequences the others (`Scene.play` + `handle.finished`). Nothing is special about it.
-- `motion.config.ts` — render targets. Output is always `<output>/<name>.mp4`; never write output paths by hand.
-- `src/assets/` — static files (images, fonts).
-- `motion studio` — browser preview with hot reload (scene picker lists config targets plus unregistered scenes).
-- `motion render [name...]` — render targets; `motion render ./src/scenes/foo.ts` renders one file with defaults. Flags beat config beat library defaults. `--verbose` prints full error cause chains.
-
-Verify a scene change by rendering it (`motion render <target>`) or checking it in the running studio — not by reading code alone.
-
-## Writing scenes
-
-A scene is an Effect generator: instantiate entities, then yield animations.
-
-```ts
-import { Color, Motion, Physics, Scene, Shapes } from "effect-motion";
-
-export const scene = Scene.make(function* () {
-	const dot = yield* Scene.instantiate(Shapes.Circle, {
-		x: 300, y: 540, radius: 80, fill: Color.hex("#7f5af0"),
-	});
-	yield* Motion.tweenTo(dot, { x: 1620 }, "1200 millis", "easeInOutCubic");
-	yield* Physics.springTo(dot, { y: 300 }, Physics.springs.wobbly);
-});
-```
-
-- **Animators come in pairs**: `verb(instance, from, to, …)` (explicit origin) and `verbTo(instance, to, …)` (origin read from the instance). Prefer the `To` form unless you need a fixed origin.
-- **Prefer semantic helpers** (`Motion.moveTo`, `Motion.fadeTo`, `Physics.springTo`) over raw `tweenTo` when one exists — they carry per-entity meaning (moving a Line translates both endpoints; moving a Group carries its subtree). Use `tweenTo` for fields without a trait (`radius`, `width`, custom fields).
-- **Springs have no duration** — length emerges from the simulation (presets in `Physics.springs`). Springy motion on raw fields uses elastic/bounce *easings*, not physics.
-- **Every animator is a dual**: `Motion.tweenTo(dot, …)` or `dot.pipe(Motion.tweenTo(…))` — both are idiomatic.
-- **Composition**: sequence by yielding one animation after another; `Scene.all([...])` runs them together; `Scene.chain`/`Scene.stagger` sequence with schedules; `Scene.fork` starts a branch you can join later; `Scene.play(otherScene)` mounts a whole scene (await `handle.finished`). `Scene.finish` marks a scene's semantic end — anything after it is a tail that keeps playing without being waited on.
-
-## Determinism rules (non-negotiable)
-
-- **Never** use `Math.random()`, `Date.now()`, or any wall-clock/OS state in a scene — every run must be byte-identical. Use the provided seeded random (`Effect.random`, seeded from `settings.seed`).
-- Durations land exactly on target on the final frame; springs snap on settle. Don't add "fudge" frames.
-- Scene coordinates are the `settings.width`/`height` of the target that renders them (this template: 1920×1080). `dpr` scales output pixels, not coordinates.
-- The `effect` dependency is pinned **exactly** — upgrading it can change seeded-random sequences. Never bump it casually; upgrade `effect` and `effect-motion` together, deliberately.
-
-## Config
-
-```ts
-export default defineConfig({
-	targets: [{
-		name: "intro",                    // unique — doubles as the output basename
-		scene: "./src/scenes/intro.ts",
-		settings: { width: 1920, height: 1080, frameRate: 60, dpr: 1 },
-		output: "./output",               // a DIRECTORY; file name is derived
-		// frames: 600                    // REQUIRED if the scene is infinite
-	}],
-});
-```
-
-A scene used by several targets renders once per target (e.g. different resolutions). An infinite scene (one that never finishes) must set `frames`, or rendering would never end.

package/templates/default/_gitignore

@@ -1,3 +0,0 @@
-node_modules/
-output/
-.motion/

package/templates/default/motion.config.ts

@@ -1,20 +0,0 @@
-import { defineConfig } from "@effect-motion/cli";
-
-// Each target is one rendered video: <output>/<name>.mp4
-// `motion render` renders all of them; `motion render <name>` picks one.
-export default defineConfig({
-	targets: [
-		{
-			name: "hello-world",
-			scene: "./src/scenes/hello-world.ts",
-			settings: { width: 1920, height: 1080, frameRate: 60 },
-			output: "./output",
-		},
-		{
-			name: "main",
-			scene: "./src/main.ts",
-			settings: { width: 1920, height: 1080, frameRate: 60 },
-			output: "./output",
-		},
-	],
-});

package/templates/default/src/main.ts

@@ -1,12 +0,0 @@
-import { Scene } from "effect-motion";
-import { scene as helloWorld } from "./scenes/hello-world";
-
-// The movie: an ordinary scene that sequences the scenes in src/scenes.
-// Nothing is special about this file — it is one more target in
-// motion.config.ts. Add scenes and chain them here.
-export const scene = Scene.make(function* () {
-	const hello = yield* Scene.play(helloWorld);
-	yield* hello.finished;
-	// const next = yield* Scene.play(anotherScene);
-	// yield* next.finished;
-});

package/templates/default/src/scenes/hello-world.ts

@@ -1,15 +0,0 @@
-import { Color, Motion, Scene, Shapes } from "effect-motion";
-
-// A scene is a generator: instantiate entities, then yield animations.
-// Preview it with `motion studio`, render it with `motion render`.
-export const scene = Scene.make(function* () {
-	const circle = yield* Scene.instantiate(Shapes.Circle, {
-		x: 300,
-		y: 540,
-		radius: 80,
-		fill: Color.hex("#7f5af0"),
-	});
-
-	yield* Motion.tweenTo(circle, { x: 1620 }, "1200 millis", "easeInOutCubic");
-	yield* Motion.fadeTo(circle, 0, "400 millis");
-});

package/templates/default/tsconfig.json

@@ -1,15 +0,0 @@
-{
-	"compilerOptions": {
-		"target": "ES2022",
-		"module": "ESNext",
-		"moduleResolution": "bundler",
-		"strict": true,
-		"exactOptionalPropertyTypes": true,
-		"noUncheckedIndexedAccess": true,
-		"skipLibCheck": true,
-		"noEmit": true,
-		"lib": ["ES2022"],
-		"types": ["node"]
-	},
-	"include": ["src", "motion.config.ts"]
-}