@effect-motion/cli 0.3.2 → 0.5.0

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/studio-app/project.ts

@@ -1,3 +0,0 @@
-// placeholder for typechecking — `motion studio` overwrites this file with
-// the absolute project root when it copies the app into .motion/studio
-export const projectRoot = "";

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"]
-}