create-shallot 0.5.2 → 0.6.0

package/index.ts

@@ -6,7 +6,7 @@ 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.
+     * scaffold; `"workspace:*"` when `bun run build` regenerates examples/templates/* in-repo.
      */
     shallot?: string;
 }
@@ -15,9 +15,14 @@ export interface TemplateOptions {
  * 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`).
+ *
+ * the project is pure data — a `shallot.json` manifest + plugin modules + `public/`, no vite
+ * boilerplate. the CLI provides every harness over it: `shallot dev` runs it standalone (`bun dev`),
+ * `shallot .` opens it in the editor, `shallot build` ships it (web + native targets).
  */
 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",
@@ -28,9 +33,8 @@ export function template(name: string, opts: TemplateOptions = {}): Record<strin
                     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" },
+                    devDependencies: { typescript: "^5.9.3" },
                 },
                 null,
                 2,
@@ -43,7 +47,7 @@ export function template(name: string, opts: TemplateOptions = {}): Record<strin
                         module: "ESNext",
                         moduleResolution: "bundler",
                         lib: ["ESNext", "DOM", "DOM.Iterable"],
-                        types: ["@webgpu/types", "vite/client"],
+                        types: ["@webgpu/types"],
                         strict: true,
                         noEmit: true,
                         skipLibCheck: true,
@@ -53,32 +57,19 @@ export function template(name: string, opts: TemplateOptions = {}): Record<strin
                 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,
+        "shallot.json": MANIFEST,
+        "src/spin.ts": SPIN,
         "public/scenes/scene.scene": SCENE,
+        "README.md": readme(name),
     };
 }
 
+/**
+ * the committed in-repo template under examples/templates/<dir>. the source of truth for what
+ * `bun run build` regenerates and `bun check` gates for staleness.
+ */
+export const TEMPLATES: { dir: string }[] = [{ dir: "starter" }];
+
 /** 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)) {
@@ -108,58 +99,69 @@ const ICON = `<svg id="Shallot" xmlns="http://www.w3.org/2000/svg" viewBox="0 0
 </svg>
 `;
 
-const VITE = `import { defineConfig } from "vite";
+const readme = (name: string) => `# ${name}
 
-export default defineConfig({
-    base: "./",
-    server: { port: 3000 },
-    build: {
-        target: "esnext",
-        outDir: "dist",
-        emptyOutDir: true,
-    },
-});
+A shallot project.
+
+## Develop
+
+\`\`\`bash
+bun install
+bunx shallot dev
+\`\`\`
+
+\`bun install\` fetches the engine. \`bunx shallot dev\` runs the project with hot
+reload; \`bunx shallot\` opens it in the editor. Edit \`src/spin.ts\` (a plugin) and
+\`shallot.json\` (the manifest: scene + plugin enablement) in your IDE.
+
+## Ship
+
+\`\`\`bash
+bunx shallot build
+\`\`\`
+
+Builds a web bundle to \`dist/\`. For native targets:
+\`bunx shallot build --target windows|mac|linux\` (add \`--release\` for an optimized build).
 `;
 
-const LIB = `import { type Config, Part, quat, type State, type System, Transform } from "@dylanebert/shallot";
+// The project manifest: the editor (\`shallot .\`) and a shipped build both read it. \`scene\`
+// is the scene to open; \`plugins\` is enablement — "Orbit": true turns on the orbit camera the
+// scene uses, and "Spin": "./src/spin" declares our own plugin by its module path. The default
+// plugins (render, lit surface) are on unless you set one false. Toggle these in the editor's
+// plugin menu and it rewrites this file, so the editor and a build always agree on what loads.
+const MANIFEST = `{
+  "$schema": "./node_modules/@dylanebert/shallot/shallot.schema.json",
+  "scene": "scenes/scene.scene",
+  "plugins": {
+    "Orbit": true,
+    "Spin": "./src/spin"
+  }
+}
+`;
 
-// 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 .\`
-// builds in edit mode, where unannotated systems are skipped, so the cube stays put
-// and editable there. Delete it (and the plugin entry below) for a static scene.
-let angle = 0;
+const SPIN = `import { type Plugin, type State, type System, Part, quat, Transform } from "@dylanebert/shallot";
+
+// A plugin is plain data: components + systems the engine runs. This system spins every Part
+// around Y. It runs when the project plays (the editor's preview, or a shipped build) but not
+// while you edit — the editor (\`bunx shallot\`) builds in edit mode, where unannotated systems
+// are skipped, so the cube stays put and editable there. Delete this file (and its
+// \`shallot.json\` entry) for a static scene.
 const SpinSystem: System = {
     group: "simulation",
     update(state: State) {
-        angle = (angle + state.time.deltaTime * 45) % 360;
-        const q = quat(0, angle, 0);
+        // Derive the angle from elapsed time, not a module-level accumulator, so it stays
+        // correct after a hot reload or State rebuild rather than carrying stale rotation.
+        const q = quat(0, (state.time.elapsed * 45) % 360, 0);
         for (const eid of state.query([Part, Transform])) {
             Transform.rot.set(eid, q.x, q.y, q.z, q.w);
         }
     },
 };
 
-// The project definition, shared by the standalone app (src/main.ts) and the shallot
-// editor (\`shallot .\`). The default plugins (render, lit surface, orbit camera) stay
-// on; the spin plugin adds our one system. The scene lives here too, so main.ts stays
-// untouched as the project grows.
-export const config: Config = {
-    plugins: [{ name: "spin", systems: [SpinSystem] }],
-    scene: "scenes/scene.scene",
-};
-`;
-
-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
-// auto-binds to the page's <canvas>.
-const { dispose } = await run(config);
-
-// HMR re-runs this module — dispose the old State + RAF loop or each reload stacks another.
-if (import.meta.hot) {
-    import.meta.hot.dispose(() => dispose());
-}
+// The default export is the plugin — \`shallot.json\` references this file by path and imports
+// its default. The name ("Spin") is how the plugin menu lists it.
+const SpinPlugin: Plugin = { name: "Spin", systems: [SpinSystem] };
+export default SpinPlugin;
 `;
 
 const SCENE = `<scene>
@@ -175,7 +177,8 @@ const SCENE = `<scene>
 `;
 
 if (import.meta.main) {
-    const name = process.argv[2];
+    const args = process.argv.slice(2);
+    const name = args.find((a) => !a.startsWith("--"));
     if (!name) {
         console.error("Usage: bun create shallot <project-name>");
         process.exit(1);
@@ -194,5 +197,5 @@ if (import.meta.main) {
     console.log("Next steps:");
     console.log(`  cd ${name}`);
     console.log("  bun install");
-    console.log("  bun dev");
+    console.log("  bunx shallot dev");
 }

package/package.json

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