create-shallot 0.5.0 → 0.5.2

package/index.ts

@@ -1,27 +1,94 @@
 #!/usr/bin/env bun
 
 import { existsSync, mkdirSync, writeFileSync } from "fs";
-import { join, resolve } from "path";
-
-const name = process.argv[2];
-if (!name) {
-    console.error("Usage: bun create shallot <project-name>");
-    process.exit(1);
+import { dirname, join, resolve } from "path";
+
+export interface TemplateOptions {
+    /**
+     * dependency spec for `@dylanebert/shallot`. `"latest"` for the published `bun create shallot`
+     * scaffold; `"workspace:*"` when `bun run build` regenerates examples/templates/starter in-repo.
+     */
+    shallot?: string;
 }
 
-const dir = resolve(name);
-if (existsSync(dir)) {
-    console.error(`Directory "${name}" already exists`);
-    process.exit(1);
+/**
+ * the project files keyed by relative path, with the project name interpolated. single source of
+ * truth for both `bun create shallot <name>` and the in-repo examples/templates/starter example
+ * (regenerated by `bun run build`).
+ */
+export function template(name: string, opts: TemplateOptions = {}): Record<string, string> {
+    const shallot = opts.shallot ?? "latest";
+    return {
+        "public/icon.svg": ICON,
+        ".gitignore": "node_modules/\ndist/\nbuild/\n",
+        "package.json":
+            JSON.stringify(
+                {
+                    name,
+                    version: "0.0.0",
+                    private: true,
+                    type: "module",
+                    scripts: { dev: "vite", build: "vite build", preview: "vite preview" },
+                    dependencies: { "@dylanebert/shallot": shallot },
+                    devDependencies: { typescript: "^5.9.3", vite: "^8.0.0" },
+                },
+                null,
+                2,
+            ) + "\n",
+        "tsconfig.json":
+            JSON.stringify(
+                {
+                    compilerOptions: {
+                        target: "ESNext",
+                        module: "ESNext",
+                        moduleResolution: "bundler",
+                        lib: ["ESNext", "DOM", "DOM.Iterable"],
+                        types: ["@webgpu/types", "vite/client"],
+                        strict: true,
+                        noEmit: true,
+                        skipLibCheck: true,
+                    },
+                    include: ["src"],
+                },
+                null,
+                2,
+            ) + "\n",
+        "index.html": `<!doctype html>
+<html lang="en">
+    <head>
+        <meta charset="UTF-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+        <link rel="icon" type="image/svg+xml" href="./icon.svg" />
+        <title>${name}</title>
+        <style>
+            * { box-sizing: border-box; margin: 0; padding: 0; }
+            body { background: #0c0a09; overflow: hidden; }
+            canvas { display: block; width: 100vw; height: 100vh; }
+        </style>
+    </head>
+    <body>
+        <canvas id="canvas"></canvas>
+        <script type="module" src="./src/main.ts"></script>
+    </body>
+</html>
+`,
+        "vite.config.ts": VITE,
+        "src/lib.ts": LIB,
+        "src/main.ts": MAIN,
+        "public/scenes/scene.scene": SCENE,
+    };
 }
 
-mkdirSync(dir, { recursive: true });
-mkdirSync(join(dir, "src"), { recursive: true });
-mkdirSync(join(dir, "public/scenes"), { recursive: true });
+/** write a template file map under dir, creating parent directories as needed. */
+export function scaffold(dir: string, files: Record<string, string>): void {
+    for (const [rel, content] of Object.entries(files)) {
+        const path = join(dir, rel);
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, content);
+    }
+}
 
-writeFileSync(
-    join(dir, "public/icon.svg"),
-    `<svg id="Shallot" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 80 80">
+const ICON = `<svg id="Shallot" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 80 80">
   <title>shallot icon</title>
   <defs>
     <radialGradient id="baseGradient" cx="35%" cy="30%" r="70%" fx="25%" fy="20%">
@@ -39,85 +106,9 @@ writeFileSync(
     <path d="M40,2 C44,10 66,28 66,46 C66,60 48,70 40,78 C32,70 14,60 14,46 C14,28 36,10 40,2 Z" fill="none" stroke="#6B4230" stroke-width="2"/>
   </g>
 </svg>
-`,
-);
-
-writeFileSync(
-    join(dir, ".gitignore"),
-    `node_modules/
-dist/
-build/
-`,
-);
-
-writeFileSync(
-    join(dir, "package.json"),
-    JSON.stringify(
-        {
-            name,
-            version: "0.0.0",
-            private: true,
-            type: "module",
-            scripts: {
-                dev: "vite",
-                build: "vite build",
-                preview: "vite preview",
-            },
-            dependencies: { "@dylanebert/shallot": "latest" },
-            devDependencies: { typescript: "^5.9.3", vite: "^8.0.0" },
-        },
-        null,
-        2,
-    ) + "\n",
-);
-
-writeFileSync(
-    join(dir, "tsconfig.json"),
-    JSON.stringify(
-        {
-            compilerOptions: {
-                target: "ESNext",
-                module: "ESNext",
-                moduleResolution: "bundler",
-                lib: ["ESNext", "DOM", "DOM.Iterable"],
-                types: ["@webgpu/types", "vite/client"],
-                strict: true,
-                noEmit: true,
-                skipLibCheck: true,
-            },
-            include: ["src"],
-        },
-        null,
-        2,
-    ) + "\n",
-);
-
-writeFileSync(
-    join(dir, "index.html"),
-    `<!doctype html>
-<html lang="en">
-    <head>
-        <meta charset="UTF-8" />
-        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-        <link rel="icon" type="image/svg+xml" href="./icon.svg" />
-        <title>${name}</title>
-        <style>
-            * { box-sizing: border-box; margin: 0; padding: 0; }
-            body { background: #0c0a09; overflow: hidden; }
-            canvas { display: block; width: 100vw; height: 100vh; }
-        </style>
-    </head>
-    <body>
-        <canvas id="canvas"></canvas>
-        <script type="module" src="./src/main.ts"></script>
-    </body>
-</html>
-`,
-);
+`;
 
-writeFileSync(
-    join(dir, "vite.config.ts"),
-    `import { defineConfig } from "vite";
+const VITE = `import { defineConfig } from "vite";
 
 export default defineConfig({
     base: "./",
@@ -128,12 +119,9 @@ export default defineConfig({
         emptyOutDir: true,
     },
 });
-`,
-);
+`;
 
-writeFileSync(
-    join(dir, "src/lib.ts"),
-    `import { type Config, Part, quat, type State, type System, Transform } from "@dylanebert/shallot";
+const LIB = `import { type Config, Part, quat, type State, type System, Transform } from "@dylanebert/shallot";
 
 // A system is plain data: an \`update\` the engine runs each frame. This one spins
 // every Part around Y. It runs in the standalone app but not the editor — \`shallot .\`
@@ -159,12 +147,9 @@ export const config: Config = {
     plugins: [{ name: "spin", systems: [SpinSystem] }],
     scene: "scenes/scene.scene",
 };
-`,
-);
+`;
 
-writeFileSync(
-    join(dir, "src/main.ts"),
-    `import { run } from "@dylanebert/shallot";
+const MAIN = `import { run } from "@dylanebert/shallot";
 import { config } from "./lib";
 
 // One config source (src/lib.ts) drives both this standalone build and the editor. The camera
@@ -175,12 +160,9 @@ const { dispose } = await run(config);
 if (import.meta.hot) {
     import.meta.hot.dispose(() => dispose());
 }
-`,
-);
+`;
 
-writeFileSync(
-    join(dir, "public/scenes/scene.scene"),
-    `<scene>
+const SCENE = `<scene>
     <a ambient-light="color: 0xd0dcec; intensity: 0.5" />
     <a directional-light="direction: -0.4 -1 -0.55; color: 0xfff4e0; intensity: 1.1" />
 
@@ -190,12 +172,27 @@ writeFileSync(
     <!-- a Part is the engine's drop-in renderable: a mesh (default "cube") wearing a surface (default "default", lit) -->
     <a part transform="pos: 0 0 0" color="rgba: 0.85 0.55 0.35 1" />
 </scene>
-`,
-);
-
-console.log(`Created ${name}/`);
-console.log();
-console.log("Next steps:");
-console.log(`  cd ${name}`);
-console.log("  bun install");
-console.log("  bun dev");
+`;
+
+if (import.meta.main) {
+    const name = process.argv[2];
+    if (!name) {
+        console.error("Usage: bun create shallot <project-name>");
+        process.exit(1);
+    }
+
+    const dir = resolve(name);
+    if (existsSync(dir)) {
+        console.error(`Directory "${name}" already exists`);
+        process.exit(1);
+    }
+
+    scaffold(dir, template(name));
+
+    console.log(`Created ${name}/`);
+    console.log();
+    console.log("Next steps:");
+    console.log(`  cd ${name}`);
+    console.log("  bun install");
+    console.log("  bun dev");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "create-shallot",
-    "version": "0.5.0",
+    "version": "0.5.2",
     "type": "module",
     "bin": "./index.ts",
     "files": ["index.ts"],