create-shallot 0.8.1 → 0.9.1

package/index.ts

@@ -9,8 +9,8 @@ import { dirname, join, resolve } from "path";
  *
  * 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 with hot
- * reload, `shallot build` ships it (web + native targets). the emitted CLAUDE.md / AGENTS.md point an
- * agent at the installed engine's contract.
+ * reload, `shallot build` ships it (web + native targets). the emitted AGENTS.md points an agent at
+ * the installed engine's contract, and CLAUDE.md imports it.
  */
 export function template(name: string): Record<string, string> {
     return {
@@ -23,8 +23,8 @@ export function template(name: string): Record<string, string> {
                     version: "0.0.0",
                     private: true,
                     type: "module",
-                    dependencies: { "@dylanebert/shallot": "latest" },
-                    devDependencies: { typescript: "^7.0.2" },
+                    dependencies: { "@dylanebert/shallot": "latest", typegpu: "~0.11.9" },
+                    devDependencies: { "unplugin-typegpu": "~0.11.6", typescript: "^7.0.2" },
                 },
                 null,
                 2,
@@ -53,10 +53,21 @@ export function template(name: string): Record<string, string> {
         "public/scenes/scene.scene": SCENE,
         "README.md": readme(name),
         "AGENTS.md": agents(name),
-        "CLAUDE.md": agents(name),
+        "CLAUDE.md": CLAUDE_IMPORT,
     };
 }
 
+// one contract, two entrypoints: Codex reads AGENTS.md, Claude Code reads CLAUDE.md and expands the
+// `@`-import. An import, not a symlink — a Windows checkout without developer mode gets a literal
+// text file from a symlink. The trailing sentence is the cost of that choice: the import expands only
+// for a session rooted in this file's own directory, so opened from a parent the line is literal text
+// and the prose pointer is all the reader gets. Kept identical to the copy-out's stanza in
+// `packages/shallot/bin/scaffold.ts`.
+const CLAUDE_IMPORT = `@AGENTS.md
+
+If the import line above is showing as literal text, this file was loaded from a parent directory; read the AGENTS.md next to this file before working here.
+`;
+
 /** 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)) {
@@ -107,8 +118,9 @@ plugin enablement) in your IDE.
 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).
+Builds a web bundle to \`dist/\`. Native targets
+(\`--target windows|mac|linux\`) build from a shallot source checkout, not the
+installed package: the rust crate they need isn't published to npm.
 `;
 
 const agents = (name: string) => `# ${name}
@@ -126,7 +138,7 @@ A WebGPU game built on \`@dylanebert/shallot\`.
 \`\`\`bash
 bunx tsc --noEmit                                # typecheck — run after every change
 bunx shallot dev                                 # run with hot reload while you work
-bunx shallot build [--target windows|mac|linux]  # ship it (web bundle, or a native app)
+bunx shallot build                               # ship it (web bundle to dist/)
 bunx shallot verify                              # prove it: boot headless, check it renders, exit 0/nonzero
 \`\`\`
 
@@ -210,18 +222,19 @@ const SCENE = `<scene>
 </scene>
 `;
 
-if (import.meta.main) {
-    const args = process.argv.slice(2);
-    const name = args.find((a) => !a.startsWith("--"));
+/** `bun create shallot <project-name>` — parse argv, guard the target dir, scaffold, report next steps.
+ *  Returns the process exit code rather than calling `process.exit` itself, so it's callable directly. */
+export function main(argv: string[]): number {
+    const name = argv.find((a) => !a.startsWith("--"));
     if (!name) {
         console.error("Usage: bun create shallot <project-name>");
-        process.exit(1);
+        return 1;
     }
 
     const dir = resolve(name);
     if (existsSync(dir)) {
         console.error(`Directory "${name}" already exists`);
-        process.exit(1);
+        return 1;
     }
 
     scaffold(dir, template(name));
@@ -232,4 +245,9 @@ if (import.meta.main) {
     console.log(`  cd ${name}`);
     console.log("  bun install");
     console.log("  bunx shallot dev");
+    return 0;
+}
+
+if (import.meta.main) {
+    process.exit(main(process.argv.slice(2)));
 }

package/package.json

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