@nanoforge-dev/schematics 2.3.1 → 3.0.0

package/dist/libs/plugin/theme-files/build.mjs

@@ -0,0 +1,29 @@
+/**
+ * The theme has no code: its build copies the manifest and the icons into dist/, the folder the
+ * editor loads. With --watch, it copies them again on every change (the editor then reloads it).
+ */
+import { cpSync, existsSync, mkdirSync, rmSync, watch } from "node:fs";
+
+const build = () => {
+  rmSync("dist", { recursive: true, force: true });
+  mkdirSync("dist");
+  cpSync("nanoforge.manifest.json", "dist/nanoforge.manifest.json");
+  if (existsSync("icons")) cpSync("icons", "dist/icons", { recursive: true });
+  console.log("Built dist/");
+};
+
+// An editor saving mid-rename makes cpSync throw ENOENT: log it and wait for the next change
+// rather than killing the watcher.
+const rebuild = () => {
+  try {
+    build();
+  } catch (error) {
+    console.error(`Build failed: ${error.message}`);
+  }
+};
+
+build();
+if (process.argv.includes("--watch")) {
+  for (const target of ["nanoforge.manifest.json", "icons"])
+    if (existsSync(target)) watch(target, { recursive: true }, rebuild);
+}

package/dist/libs/plugin/theme-files/icons/leaf.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="black" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M5 21c0-9 6-15 16-16-1 10-7 16-16 16Z"/><path d="M5 21 14 12"/></svg>

package/dist/libs/plugin/theme-files/nanoforge.manifest.json.template

@@ -0,0 +1,30 @@
+{
+  "type": "plugin",
+  "name": "<%= name %>",
+  "version": "0.1.0",
+  "displayName": "<%= title %>",
+  "description": "A color theme for the NanoForge editor.",
+  "keywords": ["theme"],
+  "engines": {
+    "editor": ">=0.1.0"
+  },
+  "contributes": {
+    "themes": [
+      {
+        "id": "<%= short %>",
+        "label": "<%= title %>",
+        "extends": "nanoforge-dark",
+        "colors": {
+          "accent": "#2f7d6d",
+          "accent-hover": "#286a5d",
+          "accent-text": "#7fd6c2"
+        },
+        "syntax": {
+          "keyword": "#7fd6c2",
+          "string": "#e6c07b"
+        }
+      }
+    ],
+    "icons": [{ "id": "<%= short %>-leaf", "path": "icons/leaf.svg" }]
+  }
+}

package/dist/libs/plugin/theme-files/package.json.template

@@ -0,0 +1,11 @@
+{
+  "name": "<%= short %>-editor-theme",
+  "version": "0.1.0",
+  "private": true,
+  "description": "<%= title %>: a NanoForge editor theme",
+  "type": "module",
+  "scripts": {
+    "build": "node build.mjs",
+    "dev": "node build.mjs --watch"
+  }
+}

package/dist/libs/project/files/js/AGENTS.md.template

@@ -0,0 +1,126 @@
+<% var nf = { npm: "npm exec --no -- nf", pnpm: "pnpm exec nf", yarn: "yarn nf", bun: "bun run nf" }[packageManager]; var add = { npm: "npm install", pnpm: "pnpm add", yarn: "yarn add", bun: "bun add" }[packageManager]; var networked = part === "server" || hasServer; %># <%= packageName %>
+
+Notes for AI coding agents. This is a NanoForge <%= part %> app, written in JavaScript: ES
+modules, with types in JSDoc comments. NanoForge is a game engine built on an entity component
+system (ECS).
+<% if (part === "client") { %>The game runs in the browser.<% } else { %>This app runs in Bun: it has no graphics, input or DOM.<% } %>
+<% if (workspace) { %>
+This app is part of a workspace: read `../../AGENTS.md` first.
+<% } %>
+## Files
+
+- `nanoforge.config.js`: the app config that `nf` reads (`type: "<%= part %>"`). Keep its
+  `entryFile`, `editor.entryFile` and `language: "js"`: the defaults are for TypeScript. Fields
+  and defaults: https://docs.nanoforge.eu/docs/cli/configuration/configuration-file
+- `src/main.js`: the entry file. The loader calls its exported `main(options)` from the bundled
+  `main.js`, so keep the file name and the export.
+- `src/components/`, `src/systems/`: one component or system per file,
+  `<kebab-name>.component.js` and `<kebab-name>.system.js`.
+- `assets/`: copied to the root of `dist/` on each build, so `assets/hero.png` is served as
+  `/hero.png`. Read it with `ctx.assets.getAsset("/hero.png")`, an `NfFile` whose `path` is its URL.
+- `dist/` is the build output, emptied on every build. `.nanoforge/` belongs to the NanoForge
+  tools: don't edit it.
+
+## Commands
+
+`nf` comes from the `@nanoforge-dev/cli` dev dependency: run it as `<%= nf %> <command>`.
+<% if (workspace) { %>
+Run `nf dev` and `nf start` from the workspace root: they run this app with the other one, and
+they read the `.env` of their `-d` folder (the current folder by default). To build this app
+alone, run `<%= nf %> build -d apps/<%= part %>` at the root.
+<% } else { %>
+- `nf dev`: runs `nf build --watch` and `nf start --watch` together.<% if (part === "client") { %> The game is on
+  http://localhost:3000 (`port` in the config).<% } %>
+- `nf build`: bundles `src/main.js` with Bun into `dist/`. It does not check the JSDoc types.
+- `nf start`: <% if (part === "client") { %>serves<% } else { %>runs<% } %> the last build.
+<% } %>
+<% if (workspace && packageManager === "npm") { %>Add a package with `npm install <package> -w apps/<%= part %>` at the workspace root.<% } else { %>Add a package with `<%= add %> <package>` in this folder.<% } %>
+
+The `@nanoforge-dev/*` packages are on `^2`. The online docs follow the engine's development
+branch and can describe APIs that the installed release lacks: the installed types
+(`@nanoforge-dev/<package>/dist` in `node_modules`) are the reference.
+
+## Game code
+
+- `main` creates the app with `NanoforgeFactory.<%= part === "client" ? "createClient" : "createServer" %>`, registers each library with
+  `app.use(...)`, then calls `await app.init(options)`. `app.use` throws after `init`, and
+  `ecs.registry` throws before it. `await app.run()` starts the tick loop and returns.
+- Components are plain classes. The registry keys them by their `name` field: give each class a
+  `name` equal to its class name (the generated ones use `this.constructor.name`), and never store
+  game data in `name`. Names must be unique in the app, and `entity` and `id` are reserved. An
+  entity has one component per class: adding a second one replaces the first.
+- Systems are `(registry, ctx) => void` functions. They run once per tick, in the order of the
+  `registry.addSystem` calls. Their result is ignored, so an async system is not awaited.
+- `registry.getZipper([A, B])` returns one object per entity that has both, keyed by component
+  name: `({ A, B }) => …`. The values are the live components: change them in place.
+  `getIndexedZipper` adds the entity `id`, and `registry.entityFromIndex(id)` turns it back into an
+  entity for `killEntity` or `removeComponent`.
+- `ctx.app.delta` is the time since the last tick, in milliseconds. `tickRate` in `main` is the
+  number of ticks per second. `ctx.app.requestStop()` stops the game.<% if (part === "client") { %>
+- Graphics use Konva: `@nanoforge-dev/graphics-2d` re-exports its shapes (`Circle`, `Rect`,
+  `Layer`…), and `ctx.graphics.baseLayer` is a layer already on the stage. Coordinates are in a
+  1920×1080 design space scaled to the window (the `viewport` option of `createClient`).
+- Keys: `ctx.input.isKeyPressed(InputEnum.KeyW)`, with `InputEnum` from `@nanoforge-dev/input`. Its
+  values are `KeyboardEvent.code` names.<% } %>
+<% if (networked) { %>
+## Network
+
+- The client and the server connect over TCP, a WebSocket, and over UDP, a WebRTC data channel
+  set up through a WebSocket. Their address and ports are `NANOFORGE_*` variables, which `nf start`
+  reads from the `.env` of <%= workspace ? "the workspace root" : "its `-d` folder" %>. It gives
+  `NANOFORGE_CLIENT_X` to the client and `NANOFORGE_SERVER_X` to the server, as `X` in
+  `options.env`. Everything the client gets reaches the browser: never put a secret there.
+  https://docs.nanoforge.eu/docs/cli/configuration/environment-variables
+- The generated systems use `ctx.network.tcp` and encode JSON with `TextEncoder`. Check the
+  installed `@nanoforge-dev/network` types before using another network API.
+<% } %>
+## Example
+
+A component and a system, as the rules above want them:
+
+```js
+// src/components/velocity-2d.component.js
+/** Speed of an entity, in pixels per second. */
+export class Velocity2D {
+  name = "Velocity2D";
+
+  /**
+   * @param {number} [x]
+   * @param {number} [y]
+   */
+  constructor(x = 0, y = 0) {
+    this.x = x;
+    this.y = y;
+  }
+}
+
+// src/systems/apply-velocity-2d.system.js
+import { Position2D } from "../components/position-2d.component";
+import { Velocity2D } from "../components/velocity-2d.component";
+
+/**
+ * @typedef {import("@nanoforge-dev/common").Context} Context
+ * @typedef {import("@nanoforge-dev/ecs").Registry} Registry
+ */
+
+/**
+ * Moves every entity that has a position and a velocity.
+ * @param {Registry} registry
+ * @param {Context} ctx
+ */
+export const applyVelocity2D = (registry, ctx) => {
+  const seconds = ctx.app.delta / 1000;
+
+  registry.getZipper([Position2D, Velocity2D]).forEach(({ Position2D, Velocity2D }) => {
+    Position2D.x += Velocity2D.x * seconds;
+    Position2D.y += Velocity2D.y * seconds;
+  });
+};
+```
+
+Register it in `main` with `registry.addSystem(applyVelocity2D)`.
+
+## Docs
+
+- `nf` commands: https://docs.nanoforge.eu/docs/cli/commands/overview
+- Everything else: https://docs.nanoforge.eu

package/dist/libs/project/files/js/CLAUDE.md.template

@@ -0,0 +1 @@
+@AGENTS.md

package/dist/libs/project/files/js/__dot__gitignore

@@ -82,6 +82,10 @@ build/Release
 
 # Dependency directories
 node_modules/
+
+# NanoForge registry packages (nf install restores them from nanoforge.packages.lock.json)
+nf_modules/
+
 jspm_packages/
 
 # Snowpack dependency directory (https://snowpack.dev/)

package/dist/libs/project/files/ts/AGENTS.md.template

@@ -0,0 +1,114 @@
+<% var nf = { npm: "npm exec --no -- nf", pnpm: "pnpm exec nf", yarn: "yarn nf", bun: "bun run nf" }[packageManager]; var add = { npm: "npm install", pnpm: "pnpm add", yarn: "yarn add", bun: "bun add" }[packageManager]; var networked = part === "server" || hasServer; %># <%= packageName %>
+
+Notes for AI coding agents. This is a NanoForge <%= part %> app, written in TypeScript.
+NanoForge is a game engine built on an entity component system (ECS).
+<% if (part === "client") { %>The game runs in the browser.<% } else { %>This app runs in Bun: it has no graphics, input or DOM.<% } %>
+<% if (workspace) { %>
+This app is part of a workspace: read `../../AGENTS.md` first.
+<% } %>
+## Files
+
+- `nanoforge.config.ts`: the app config that `nf` reads (`type: "<%= part %>"`). Fields and defaults:
+  https://docs.nanoforge.eu/docs/cli/configuration/configuration-file
+- `src/main.ts`: the entry file. The loader calls its exported `main(options)` from the bundled
+  `main.js`, so keep the file name and the export.
+- `src/components/`, `src/systems/`: one component or system per file,
+  `<kebab-name>.component.ts` and `<kebab-name>.system.ts`.
+- `assets/`: copied to the root of `dist/` on each build, so `assets/hero.png` is served as
+  `/hero.png`. Read it with `ctx.assets.getAsset("/hero.png")`, an `NfFile` whose `path` is its URL.
+- `dist/` is the build output, emptied on every build. `.nanoforge/` belongs to the NanoForge
+  tools: don't edit it.
+
+## Commands
+
+`nf` comes from the `@nanoforge-dev/cli` dev dependency: run it as `<%= nf %> <command>`.
+<% if (workspace) { %>
+Run `nf dev` and `nf start` from the workspace root: they run this app with the other one, and
+they read the `.env` of their `-d` folder (the current folder by default). To build this app
+alone, run `<%= nf %> build -d apps/<%= part %>` at the root.
+<% } else { %>
+- `nf dev`: runs `nf build --watch` and `nf start --watch` together.<% if (part === "client") { %> The game is on
+  http://localhost:3000 (`port` in the config).<% } %>
+- `nf build`: bundles `src/main.ts` with Bun into `dist/`. It does not type-check.
+- `nf start`: <% if (part === "client") { %>serves<% } else { %>runs<% } %> the last build.
+<% } %>
+<% if (workspace && packageManager === "npm") { %>Add a package with `npm install <package> -w apps/<%= part %>` at the workspace root.<% } else { %>Add a package with `<%= add %> <package>` in this folder.<% } %>
+
+The `@nanoforge-dev/*` packages are on `^2`. The online docs follow the engine's development
+branch and can describe APIs that the installed release lacks: the installed types
+(`@nanoforge-dev/<package>/dist` in `node_modules`) are the reference.
+
+## Game code
+
+- `main` creates the app with `NanoforgeFactory.<%= part === "client" ? "createClient" : "createServer" %>`, registers each library with
+  `app.use(...)`, then calls `await app.init(options)`. `app.use` throws after `init`, and
+  `ecs.registry` throws before it. `await app.run()` starts the tick loop and returns.
+- Components are plain classes. The registry keys them by their `name` field: give each class a
+  `name` equal to its class name (the generated ones use `this.constructor.name`), and never store
+  game data in `name`. Names must be unique in the app, and `entity` and `id` are reserved. An
+  entity has one component per class: adding a second one replaces the first.
+- Systems are `(registry, ctx) => void` functions. They run once per tick, in the order of the
+  `registry.addSystem` calls. Their result is ignored, so an async system is not awaited.
+- `registry.getZipper([A, B])` returns one object per entity that has both, keyed by component
+  name: `({ A, B }) => …`. The values are the live components: change them in place.
+  `getIndexedZipper` adds the entity `id`, and `registry.entityFromIndex(id)` turns it back into an
+  entity for `killEntity` or `removeComponent`.
+- `ctx.app.delta` is the time since the last tick, in milliseconds. `tickRate` in `main` is the
+  number of ticks per second. `ctx.app.requestStop()` stops the game.<% if (part === "client") { %>
+- Graphics use Konva: `@nanoforge-dev/graphics-2d` re-exports its shapes (`Circle`, `Rect`,
+  `Layer`…), and `ctx.graphics.baseLayer` is a layer already on the stage. Coordinates are in a
+  1920×1080 design space scaled to the window (the `viewport` option of `createClient`).
+- Keys: `ctx.input.isKeyPressed(InputEnum.KeyW)`, with `InputEnum` from `@nanoforge-dev/input`. Its
+  values are `KeyboardEvent.code` names.<% } %>
+<% if (networked) { %>
+## Network
+
+- The client and the server connect over TCP, a WebSocket, and over UDP, a WebRTC data channel
+  set up through a WebSocket. Their address and ports are `NANOFORGE_*` variables, which `nf start`
+  reads from the `.env` of <%= workspace ? "the workspace root" : "its `-d` folder" %>. It gives
+  `NANOFORGE_CLIENT_X` to the client and `NANOFORGE_SERVER_X` to the server, as `X` in
+  `options.env`. Everything the client gets reaches the browser: never put a secret there.
+  https://docs.nanoforge.eu/docs/cli/configuration/environment-variables
+- The generated systems use `ctx.network.tcp` and encode JSON with `TextEncoder`. Check the
+  installed `@nanoforge-dev/network` types before using another network API.
+<% } %>
+## Example
+
+A component and a system, as the rules above want them:
+
+```ts
+// src/components/velocity-2d.component.ts
+/** Speed of an entity, in pixels per second. */
+export class Velocity2D {
+  name = "Velocity2D";
+
+  constructor(
+    public x = 0,
+    public y = 0,
+  ) {}
+}
+
+// src/systems/apply-velocity-2d.system.ts
+import { type Context } from "@nanoforge-dev/common";
+import { type Registry } from "@nanoforge-dev/ecs";
+
+import { Position2D } from "../components/position-2d.component";
+import { Velocity2D } from "../components/velocity-2d.component";
+
+/** Moves every entity that has a position and a velocity. */
+export const applyVelocity2D = (registry: Registry, ctx: Context): void => {
+  const seconds = ctx.app.delta / 1000;
+
+  registry.getZipper([Position2D, Velocity2D]).forEach(({ Position2D, Velocity2D }) => {
+    Position2D.x += Velocity2D.x * seconds;
+    Position2D.y += Velocity2D.y * seconds;
+  });
+};
+```
+
+Register it in `main` with `registry.addSystem(applyVelocity2D)`.
+
+## Docs
+
+- `nf` commands: https://docs.nanoforge.eu/docs/cli/commands/overview
+- Everything else: https://docs.nanoforge.eu

package/dist/libs/project/files/ts/CLAUDE.md.template

@@ -0,0 +1 @@
+@AGENTS.md

package/dist/libs/project/files/ts/__dot__gitignore

@@ -82,6 +82,10 @@ build/Release
 
 # Dependency directories
 node_modules/
+
+# NanoForge registry packages (nf install restores them from nanoforge.packages.lock.json)
+nf_modules/
+
 jspm_packages/
 
 # Snowpack dependency directory (https://snowpack.dev/)

package/dist/libs/project/project.factory.d.ts

@@ -1,5 +1,4 @@
 import { Rule } from "@angular-devkit/schematics";
-//#region src/libs/project/project.schema.d.ts
 interface ProjectSchema {
   /**
    * The type of project to generate
@@ -56,9 +55,11 @@ interface ProjectSchema {
    * Add editor dependencies
    */
   editor: boolean;
+  /**
+   * Generate an AGENTS.md file documenting the project for AI coding agents, and a CLAUDE.md that imports it
+   */
+  agents: boolean;
 }
-//#endregion
-//#region src/libs/project/project.factory.d.ts
 export declare const main: (schema: ProjectSchema) => Rule;
-//#endregion
+export {};
 //# sourceMappingURL=project.factory.d.ts.map

package/dist/libs/project/project.factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project.factory.d.ts","names":[],"sources":["../../../src/libs/project/project.schema.d.ts","../../../src/libs/project/project.factory.ts"],"mappings":";;UAAiB;;;;EAIf;;;;;;EAOA;;;;;;;EAQA;;;;;;EAOA;;;;EAKA;;;;EAKA;;;;EAKA;;;;EAKA;;;;;EAMA;;;;;;;EAQA;;;;EAKA;;;;qBCmEW,OAAQ,QAAQ,kBAAgB"}
+{"version":3,"file":"project.factory.d.ts","names":[],"sources":["../../../src/libs/project/project.schema.d.ts","../../../src/libs/project/project.factory.ts"],"mappings":";UAAiB;;;;EAIf;;;;;;EAOA;;;;;;;EAQA;;;;;;EAOA;;;;EAKA;;;;EAKA;;;;EAKA;;;;EAKA;;;;;EAMA;;;;;;;EAQA;;;;EAKA;;;;EAKA;;qBCoEW,OAAQ,QAAQ,kBAAgB"}

package/dist/libs/project/project.factory.js

@@ -1,6 +1,6 @@
 import { join, normalize, strings } from "@angular-devkit/core";
 import { apply, filter, mergeWith, move, renameTemplateFiles, template, url } from "@angular-devkit/schematics";
-//#region src/utils/formatting.ts
+// src/utils/formatting.ts
 const toWords = (str) => {
 	return str.replace(/([a-z])([A-Z])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").replace(/[-_]+/g, " ").trim().split(/\s+/).filter(Boolean);
 };
@@ -9,8 +9,7 @@ const toKebabCase = (str) => {
 };
 /** Fallback used when the registry lookup for `@nanoforge-dev/cli` fails. */
 const DEFAULT_CLI_DEPENDENCY_VERSION = "latest";
-//#endregion
-//#region src/utils/registry.ts
+// src/utils/registry.ts
 const REGISTRY_URL = "https://registry.npmjs.org";
 const DEFAULT_TIMEOUT_MS = 3e3;
 const RELEASE_VERSION_PATTERN = /^\d+\.\d+\.\d+$/;
@@ -48,8 +47,7 @@ const fetchTrustedVersion = async (packageName, fallback, options = {}) => {
 		clearTimeout(timeout);
 	}
 };
-//#endregion
-//#region src/libs/project/project.factory.ts
+// src/libs/project/project.factory.ts
 const resolveDepVersions = async (part) => {
 	const isClient = part === "client";
 	const [engine, cli, ecs, network, graphics2d, input] = await Promise.all([
@@ -92,6 +90,7 @@ const transform = async (schema) => {
 		hasServer: schema.hasServer,
 		docker: schema.docker ?? false,
 		editor: schema.editor ?? false,
+		agents: schema.agents ?? true,
 		allowBuilds: workspace ? [] : ["bun"]
 	};
 };
@@ -104,6 +103,7 @@ const generate = (options, path) => {
 		}),
 		filter((path) => options.docker && !options.workspace || !["Dockerfile", ".dockerignore"].includes(path.split("/").at(-1) ?? "")),
 		filter((path) => options.packageManager === "pnpm" && options.allowBuilds.length > 0 || !(path.split("/").at(-1) ?? "").startsWith("pnpm-workspace.yaml")),
+		filter((path) => options.agents || !["AGENTS.md", "CLAUDE.md"].some((name) => (path.split("/").at(-1) ?? "").startsWith(name))),
 		filter((path) => {
 			const filename = path.split("/").at(-1) ?? "";
 			if (filename.startsWith("drawable-circle-2d.component") || filename.startsWith("draw-2d.system")) return options.part === "client";
@@ -121,7 +121,6 @@ const main = (schema) => {
 		return mergeWith(generate(options, schema.directory));
 	};
 };
-//#endregion
 export { main };
 
 //# sourceMappingURL=project.factory.js.map

package/dist/libs/project/project.factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"project.factory.js","names":[],"sources":["../../../src/utils/formatting.ts","../../../src/defaults.ts","../../../src/utils/registry.ts","../../../src/libs/project/project.factory.ts"],"sourcesContent":["const toWords = (str: string): string[] => {\n  return str\n    .replace(/([a-z])([A-Z])/g, \"$1 $2\")\n    .replace(/([A-Z]+)([A-Z][a-z])/g, \"$1 $2\")\n    .replace(/[-_]+/g, \" \")\n    .trim()\n    .split(/\\s+/)\n    .filter(Boolean);\n};\n\nexport const toKebabCase = (str: string): string => {\n  return toWords(str)\n    .map((word) => word.toLowerCase())\n    .join(\"-\");\n};\n\nexport const toPascalCase = (str: string): string => {\n  return toWords(str)\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\n    .join(\"\");\n};\n\nexport const toCamelCase = (str: string): string => {\n  const words = toWords(str);\n  return words\n    .map((word, i) =>\n      i === 0 ? word.toLowerCase() : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase(),\n    )\n    .join(\"\");\n};\n","export const DEFAULT_APP_NAME = \"nanoforge-app\";\nexport const DEFAULT_LANGUAGE = \"ts\";\nexport const DEFAULT_PACKAGE_MANAGER = \"npm\";\nexport const DEFAULT_NANOFORGE_DEPENDENCY_VERSION = \"^2\";\nexport const DEFAULT_ENGINE_VERSION = \"^2\";\n\n/** Fallback used when the registry lookup for `@nanoforge-dev/cli` fails. */\nexport const DEFAULT_CLI_DEPENDENCY_VERSION = \"latest\";\n\n/**\n * Fallback used when the registry lookup for `typescript` fails. A specific\n * version, not a range — non-nanoforge packages are pinned exactly.\n */\nexport const DEFAULT_TYPESCRIPT_VERSION = \"6.0.3\";\n\n/**\n * Mirrors pnpm's own `minimumReleaseAge` supply-chain protection: when\n * resolving a pinned dependency version at generation time, only consider\n * versions published at least this long ago, so a freshly (and potentially\n * maliciously) published release isn't picked up immediately.\n */\nexport const MIN_RELEASE_AGE_HOURS = 48;\n","import { MIN_RELEASE_AGE_HOURS } from \"~/defaults\";\n\nconst REGISTRY_URL = \"https://registry.npmjs.org\";\nconst DEFAULT_TIMEOUT_MS = 3000;\n\nconst RELEASE_VERSION_PATTERN = /^\\d+\\.\\d+\\.\\d+$/;\n\nconst compareVersions = (a: string, b: string): number => {\n  const partsA = a.split(\".\").map(Number);\n  const partsB = b.split(\".\").map(Number);\n  for (let i = 0; i < 3; i++) {\n    const diff = (partsA[i] ?? 0) - (partsB[i] ?? 0);\n    if (diff !== 0) {\n      return diff;\n    }\n  }\n  return 0;\n};\n\nexport interface FetchTrustedVersionOptions {\n  /**\n   * Only consider versions published at least this many hours ago, mirroring\n   * pnpm's `minimumReleaseAge` supply-chain protection for a freshly\n   * published (and potentially compromised) release.\n   * @default MIN_RELEASE_AGE_HOURS\n   */\n  minAgeHours?: number;\n\n  /**\n   * Restrict candidates to this major version (e.g. `6` only considers\n   * `6.x.x`). Useful to avoid silently jumping a generated project onto a\n   * new major release.\n   */\n  major?: number;\n\n  /** Network timeout in milliseconds. @default 3000 */\n  timeoutMs?: number;\n}\n\n/**\n * Resolves the newest published version of an npm package that is at least\n * `minAgeHours` old, so freshly (and potentially maliciously) published\n * versions aren't picked up immediately. Falls back to `fallback` on any\n * network error, timeout, missing package, or when no version satisfies the\n * constraints, so callers never have to handle a rejected promise.\n */\nexport const fetchTrustedVersion = async (\n  packageName: string,\n  fallback: string,\n  options: FetchTrustedVersionOptions = {},\n): Promise<string> => {\n  const { minAgeHours = MIN_RELEASE_AGE_HOURS, major, timeoutMs = DEFAULT_TIMEOUT_MS } = options;\n\n  const controller = new AbortController();\n  const timeout = setTimeout(() => controller.abort(), timeoutMs);\n\n  try {\n    const response = await fetch(`${REGISTRY_URL}/${encodeURIComponent(packageName)}`, {\n      signal: controller.signal,\n    });\n    if (!response.ok) {\n      return fallback;\n    }\n\n    const data = (await response.json()) as { time?: Record<string, string> };\n    const time = data.time;\n    if (!time) {\n      return fallback;\n    }\n\n    const cutoff = Date.now() - minAgeHours * 60 * 60 * 1000;\n    const eligible = Object.entries(time)\n      .filter(([version]) => RELEASE_VERSION_PATTERN.test(version))\n      .filter(([version]) => major === undefined || Number(version.split(\".\")[0]) === major)\n      .filter(([, publishedAt]) => new Date(publishedAt).getTime() <= cutoff)\n      .map(([version]) => version)\n      .sort(compareVersions);\n\n    return eligible.at(-1) ? `^${eligible.at(-1)}` : fallback;\n  } catch {\n    return fallback;\n  } finally {\n    clearTimeout(timeout);\n  }\n};\n\n/**\n * Resolves several packages' trusted versions in parallel. Keys of `specs`\n * are the package name to query the registry for; values are the fallback\n * to use if that lookup fails. Returns a map from the *same* keys to the\n * resolved (or fallback) version — typed so callers don't get `| undefined`\n * back for a key they just passed in.\n */\nexport const fetchTrustedVersions = async <\n  T extends Record<string, { fallback: string; major?: number }>,\n>(\n  specs: T,\n): Promise<{ [K in keyof T]: string }> => {\n  const entries = await Promise.all(\n    Object.entries(specs).map(async ([packageName, { fallback, major }]) => {\n      const version = await fetchTrustedVersion(packageName, fallback, { major });\n      return [packageName, version] as const;\n    }),\n  );\n  return Object.fromEntries(entries) as { [K in keyof T]: string };\n};\n","import { type Path, join, normalize, strings } from \"@angular-devkit/core\";\nimport {\n  type Rule,\n  type Source,\n  apply,\n  filter,\n  mergeWith,\n  move,\n  renameTemplateFiles,\n  template,\n  url,\n} from \"@angular-devkit/schematics\";\n\nimport { toKebabCase } from \"@utils/formatting\";\nimport { fetchTrustedVersion } from \"@utils/registry\";\n\nimport {\n  DEFAULT_APP_NAME,\n  DEFAULT_CLI_DEPENDENCY_VERSION,\n  DEFAULT_ENGINE_VERSION,\n  DEFAULT_LANGUAGE,\n  DEFAULT_NANOFORGE_DEPENDENCY_VERSION,\n  DEFAULT_PACKAGE_MANAGER,\n} from \"~/defaults\";\n\nimport { type ProjectOptions } from \"./project.options\";\nimport { type ProjectSchema } from \"./project.schema\";\n\ninterface DepVersions {\n  ecs: string;\n  graphics2d: string;\n  input: string;\n  network: string;\n  engine: string;\n  cli: string;\n}\n\nconst resolveDepVersions = async (part: ProjectSchema[\"part\"]): Promise<DepVersions> => {\n  const isClient = part === \"client\";\n\n  const [engine, cli, ecs, network, graphics2d, input] = await Promise.all([\n    fetchTrustedVersion(\"@nanoforge-dev/core\", DEFAULT_ENGINE_VERSION),\n    fetchTrustedVersion(\"@nanoforge-dev/cli\", DEFAULT_CLI_DEPENDENCY_VERSION),\n    fetchTrustedVersion(\"@nanoforge-dev/ecs\", DEFAULT_NANOFORGE_DEPENDENCY_VERSION),\n    fetchTrustedVersion(\"@nanoforge-dev/network\", DEFAULT_NANOFORGE_DEPENDENCY_VERSION),\n    isClient\n      ? fetchTrustedVersion(\"@nanoforge-dev/graphics-2d\", DEFAULT_NANOFORGE_DEPENDENCY_VERSION)\n      : DEFAULT_NANOFORGE_DEPENDENCY_VERSION,\n    isClient\n      ? fetchTrustedVersion(\"@nanoforge-dev/input\", DEFAULT_NANOFORGE_DEPENDENCY_VERSION)\n      : DEFAULT_NANOFORGE_DEPENDENCY_VERSION,\n  ]);\n\n  return {\n    ecs,\n    graphics2d,\n    input,\n    network,\n    engine,\n    cli,\n  };\n};\n\nconst transform = async (schema: ProjectSchema): Promise<ProjectOptions> => {\n  const packageManager = schema.packageManager ?? DEFAULT_PACKAGE_MANAGER;\n  const workspace = schema.workspace ?? true;\n  const depVersions = await resolveDepVersions(schema.part);\n\n  const name = schema.name ?? schema.part;\n  const packageName = schema.workspaceName\n    ? `${toKebabCase(schema.workspaceName)}-${toKebabCase(name)}`\n    : toKebabCase(schema.name ?? DEFAULT_APP_NAME);\n\n  return {\n    part: schema.part,\n    appClass: schema.part === \"client\" ? \"NanoforgeClient\" : \"NanoforgeServer\",\n    packageName,\n    language: schema.language ?? DEFAULT_LANGUAGE,\n    strict: schema.strict ?? true,\n    packageManager,\n    workspace,\n    ecsVersion: depVersions.ecs,\n    graphics2dVersion: depVersions.graphics2d,\n    inputVersion: depVersions.input,\n    networkVersion: depVersions.network,\n    engineVersion: depVersions.engine,\n    cliVersion: depVersions.cli,\n    hasServer: schema.hasServer,\n    docker: schema.docker ?? false,\n    editor: schema.editor ?? false,\n    allowBuilds: workspace ? [] : [\"bun\"],\n  };\n};\n\nconst generate = (options: ProjectOptions, path: string): Source => {\n  return apply(url(join(\"./files\" as Path, options.language)), [\n    template({\n      dot: \".\",\n      ...strings,\n      ...options,\n    }),\n    filter(\n      (path) =>\n        (options.docker && !options.workspace) ||\n        ![\"Dockerfile\", \".dockerignore\"].includes(path.split(\"/\").at(-1) ?? \"\"),\n    ),\n    filter(\n      (path) =>\n        (options.packageManager === \"pnpm\" && options.allowBuilds.length > 0) ||\n        !(path.split(\"/\").at(-1) ?? \"\").startsWith(\"pnpm-workspace.yaml\"),\n    ),\n    filter((path) => {\n      const filename = path.split(\"/\").at(-1) ?? \"\";\n      if (\n        filename.startsWith(\"drawable-circle-2d.component\") ||\n        filename.startsWith(\"draw-2d.system\")\n      ) {\n        return options.part === \"client\";\n      }\n      if (filename.startsWith(\"move-2d.system\")) {\n        return options.part === \"server\";\n      }\n      if (filename.startsWith(\"position-sync.system\")) {\n        return options.part === \"client\" && options.hasServer;\n      }\n      return true;\n    }),\n    renameTemplateFiles(),\n    move(normalize(path)),\n  ]);\n};\n\nexport const main = (schema: ProjectSchema): Rule => {\n  return async () => {\n    const options = await transform(schema);\n\n    return mergeWith(generate(options, schema.directory));\n  };\n};\n"],"mappings":"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"}
+{"version":3,"file":"project.factory.js","names":[],"sources":["../../../src/utils/formatting.ts","../../../src/defaults.ts","../../../src/utils/registry.ts","../../../src/libs/project/project.factory.ts"],"sourcesContent":["const toWords = (str: string): string[] => {\n  return str\n    .replace(/([a-z])([A-Z])/g, \"$1 $2\")\n    .replace(/([A-Z]+)([A-Z][a-z])/g, \"$1 $2\")\n    .replace(/[-_]+/g, \" \")\n    .trim()\n    .split(/\\s+/)\n    .filter(Boolean);\n};\n\nexport const toKebabCase = (str: string): string => {\n  return toWords(str)\n    .map((word) => word.toLowerCase())\n    .join(\"-\");\n};\n\nexport const toPascalCase = (str: string): string => {\n  return toWords(str)\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\n    .join(\"\");\n};\n\nexport const toCamelCase = (str: string): string => {\n  const words = toWords(str);\n  return words\n    .map((word, i) =>\n      i === 0 ? word.toLowerCase() : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase(),\n    )\n    .join(\"\");\n};\n","export const DEFAULT_APP_NAME = \"nanoforge-app\";\nexport const DEFAULT_LANGUAGE = \"ts\";\nexport const DEFAULT_PACKAGE_MANAGER = \"npm\";\nexport const DEFAULT_NANOFORGE_DEPENDENCY_VERSION = \"^2\";\nexport const DEFAULT_ENGINE_VERSION = \"^2\";\n\n/** Fallback used when the registry lookup for `@nanoforge-dev/cli` fails. */\nexport const DEFAULT_CLI_DEPENDENCY_VERSION = \"latest\";\n\n/**\n * Fallback used when the registry lookup for `typescript` fails. A specific\n * version, not a range — non-nanoforge packages are pinned exactly.\n */\nexport const DEFAULT_TYPESCRIPT_VERSION = \"6.0.3\";\n\n/**\n * Mirrors pnpm's own `minimumReleaseAge` supply-chain protection: when\n * resolving a pinned dependency version at generation time, only consider\n * versions published at least this long ago, so a freshly (and potentially\n * maliciously) published release isn't picked up immediately.\n */\nexport const MIN_RELEASE_AGE_HOURS = 48;\n\n/** Fallback for the editor packages (`@nanoforge-dev/editor-*`), which share one version line. */\nexport const DEFAULT_EDITOR_VERSION = \"^1.0.0\";\n","import { MIN_RELEASE_AGE_HOURS } from \"~/defaults\";\n\nconst REGISTRY_URL = \"https://registry.npmjs.org\";\nconst DEFAULT_TIMEOUT_MS = 3000;\n\nconst RELEASE_VERSION_PATTERN = /^\\d+\\.\\d+\\.\\d+$/;\n\nconst compareVersions = (a: string, b: string): number => {\n  const partsA = a.split(\".\").map(Number);\n  const partsB = b.split(\".\").map(Number);\n  for (let i = 0; i < 3; i++) {\n    const diff = (partsA[i] ?? 0) - (partsB[i] ?? 0);\n    if (diff !== 0) {\n      return diff;\n    }\n  }\n  return 0;\n};\n\nexport interface FetchTrustedVersionOptions {\n  /**\n   * Only consider versions published at least this many hours ago, mirroring\n   * pnpm's `minimumReleaseAge` supply-chain protection for a freshly\n   * published (and potentially compromised) release.\n   * @default MIN_RELEASE_AGE_HOURS\n   */\n  minAgeHours?: number;\n\n  /**\n   * Restrict candidates to this major version (e.g. `6` only considers\n   * `6.x.x`). Useful to avoid silently jumping a generated project onto a\n   * new major release.\n   */\n  major?: number;\n\n  /** Network timeout in milliseconds. @default 3000 */\n  timeoutMs?: number;\n}\n\n/**\n * Resolves the newest published version of an npm package that is at least\n * `minAgeHours` old, so freshly (and potentially maliciously) published\n * versions aren't picked up immediately. Falls back to `fallback` on any\n * network error, timeout, missing package, or when no version satisfies the\n * constraints, so callers never have to handle a rejected promise.\n */\nexport const fetchTrustedVersion = async (\n  packageName: string,\n  fallback: string,\n  options: FetchTrustedVersionOptions = {},\n): Promise<string> => {\n  const { minAgeHours = MIN_RELEASE_AGE_HOURS, major, timeoutMs = DEFAULT_TIMEOUT_MS } = options;\n\n  const controller = new AbortController();\n  const timeout = setTimeout(() => controller.abort(), timeoutMs);\n\n  try {\n    const response = await fetch(`${REGISTRY_URL}/${encodeURIComponent(packageName)}`, {\n      signal: controller.signal,\n    });\n    if (!response.ok) {\n      return fallback;\n    }\n\n    const data = (await response.json()) as { time?: Record<string, string> };\n    const time = data.time;\n    if (!time) {\n      return fallback;\n    }\n\n    const cutoff = Date.now() - minAgeHours * 60 * 60 * 1000;\n    const eligible = Object.entries(time)\n      .filter(([version]) => RELEASE_VERSION_PATTERN.test(version))\n      .filter(([version]) => major === undefined || Number(version.split(\".\")[0]) === major)\n      .filter(([, publishedAt]) => new Date(publishedAt).getTime() <= cutoff)\n      .map(([version]) => version)\n      .sort(compareVersions);\n\n    return eligible.at(-1) ? `^${eligible.at(-1)}` : fallback;\n  } catch {\n    return fallback;\n  } finally {\n    clearTimeout(timeout);\n  }\n};\n\n/**\n * Resolves several packages' trusted versions in parallel. Keys of `specs`\n * are the package name to query the registry for; values are the fallback\n * to use if that lookup fails. Returns a map from the *same* keys to the\n * resolved (or fallback) version — typed so callers don't get `| undefined`\n * back for a key they just passed in.\n */\nexport const fetchTrustedVersions = async <\n  T extends Record<string, { fallback: string; major?: number }>,\n>(\n  specs: T,\n): Promise<{ [K in keyof T]: string }> => {\n  const entries = await Promise.all(\n    Object.entries(specs).map(async ([packageName, { fallback, major }]) => {\n      const version = await fetchTrustedVersion(packageName, fallback, { major });\n      return [packageName, version] as const;\n    }),\n  );\n  return Object.fromEntries(entries) as { [K in keyof T]: string };\n};\n","import { type Path, join, normalize, strings } from \"@angular-devkit/core\";\nimport {\n  type Rule,\n  type Source,\n  apply,\n  filter,\n  mergeWith,\n  move,\n  renameTemplateFiles,\n  template,\n  url,\n} from \"@angular-devkit/schematics\";\n\nimport { toKebabCase } from \"@utils/formatting\";\nimport { fetchTrustedVersion } from \"@utils/registry\";\n\nimport {\n  DEFAULT_APP_NAME,\n  DEFAULT_CLI_DEPENDENCY_VERSION,\n  DEFAULT_ENGINE_VERSION,\n  DEFAULT_LANGUAGE,\n  DEFAULT_NANOFORGE_DEPENDENCY_VERSION,\n  DEFAULT_PACKAGE_MANAGER,\n} from \"~/defaults\";\n\nimport { type ProjectOptions } from \"./project.options\";\nimport { type ProjectSchema } from \"./project.schema\";\n\ninterface DepVersions {\n  ecs: string;\n  graphics2d: string;\n  input: string;\n  network: string;\n  engine: string;\n  cli: string;\n}\n\nconst resolveDepVersions = async (part: ProjectSchema[\"part\"]): Promise<DepVersions> => {\n  const isClient = part === \"client\";\n\n  const [engine, cli, ecs, network, graphics2d, input] = await Promise.all([\n    fetchTrustedVersion(\"@nanoforge-dev/core\", DEFAULT_ENGINE_VERSION),\n    fetchTrustedVersion(\"@nanoforge-dev/cli\", DEFAULT_CLI_DEPENDENCY_VERSION),\n    fetchTrustedVersion(\"@nanoforge-dev/ecs\", DEFAULT_NANOFORGE_DEPENDENCY_VERSION),\n    fetchTrustedVersion(\"@nanoforge-dev/network\", DEFAULT_NANOFORGE_DEPENDENCY_VERSION),\n    isClient\n      ? fetchTrustedVersion(\"@nanoforge-dev/graphics-2d\", DEFAULT_NANOFORGE_DEPENDENCY_VERSION)\n      : DEFAULT_NANOFORGE_DEPENDENCY_VERSION,\n    isClient\n      ? fetchTrustedVersion(\"@nanoforge-dev/input\", DEFAULT_NANOFORGE_DEPENDENCY_VERSION)\n      : DEFAULT_NANOFORGE_DEPENDENCY_VERSION,\n  ]);\n\n  return {\n    ecs,\n    graphics2d,\n    input,\n    network,\n    engine,\n    cli,\n  };\n};\n\nconst transform = async (schema: ProjectSchema): Promise<ProjectOptions> => {\n  const packageManager = schema.packageManager ?? DEFAULT_PACKAGE_MANAGER;\n  const workspace = schema.workspace ?? true;\n  const depVersions = await resolveDepVersions(schema.part);\n\n  const name = schema.name ?? schema.part;\n  const packageName = schema.workspaceName\n    ? `${toKebabCase(schema.workspaceName)}-${toKebabCase(name)}`\n    : toKebabCase(schema.name ?? DEFAULT_APP_NAME);\n\n  return {\n    part: schema.part,\n    appClass: schema.part === \"client\" ? \"NanoforgeClient\" : \"NanoforgeServer\",\n    packageName,\n    language: schema.language ?? DEFAULT_LANGUAGE,\n    strict: schema.strict ?? true,\n    packageManager,\n    workspace,\n    ecsVersion: depVersions.ecs,\n    graphics2dVersion: depVersions.graphics2d,\n    inputVersion: depVersions.input,\n    networkVersion: depVersions.network,\n    engineVersion: depVersions.engine,\n    cliVersion: depVersions.cli,\n    hasServer: schema.hasServer,\n    docker: schema.docker ?? false,\n    editor: schema.editor ?? false,\n    agents: schema.agents ?? true,\n    allowBuilds: workspace ? [] : [\"bun\"],\n  };\n};\n\nconst generate = (options: ProjectOptions, path: string): Source => {\n  return apply(url(join(\"./files\" as Path, options.language)), [\n    template({\n      dot: \".\",\n      ...strings,\n      ...options,\n    }),\n    filter(\n      (path) =>\n        (options.docker && !options.workspace) ||\n        ![\"Dockerfile\", \".dockerignore\"].includes(path.split(\"/\").at(-1) ?? \"\"),\n    ),\n    filter(\n      (path) =>\n        (options.packageManager === \"pnpm\" && options.allowBuilds.length > 0) ||\n        !(path.split(\"/\").at(-1) ?? \"\").startsWith(\"pnpm-workspace.yaml\"),\n    ),\n    filter(\n      (path) =>\n        options.agents ||\n        ![\"AGENTS.md\", \"CLAUDE.md\"].some((name) => (path.split(\"/\").at(-1) ?? \"\").startsWith(name)),\n    ),\n    filter((path) => {\n      const filename = path.split(\"/\").at(-1) ?? \"\";\n      if (\n        filename.startsWith(\"drawable-circle-2d.component\") ||\n        filename.startsWith(\"draw-2d.system\")\n      ) {\n        return options.part === \"client\";\n      }\n      if (filename.startsWith(\"move-2d.system\")) {\n        return options.part === \"server\";\n      }\n      if (filename.startsWith(\"position-sync.system\")) {\n        return options.part === \"client\" && options.hasServer;\n      }\n      return true;\n    }),\n    renameTemplateFiles(),\n    move(normalize(path)),\n  ]);\n};\n\nexport const main = (schema: ProjectSchema): Rule => {\n  return async () => {\n    const options = await transform(schema);\n\n    return mergeWith(generate(options, schema.directory));\n  };\n};\n"],"mappings":"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"}

package/dist/libs/project/schema.json

@@ -66,6 +66,11 @@
       "description": "Add editor dependencies",
       "default": false
     },
+    "agents": {
+      "type": "boolean",
+      "description": "Generate an AGENTS.md file documenting the project for AI coding agents, and a CLAUDE.md that imports it",
+      "default": true
+    },
     "libs": {
       "type": "array",
       "items": { "type": "string" },

package/dist/libs/system/system.factory.d.ts

@@ -1,5 +1,4 @@
 import { Rule } from "@angular-devkit/schematics";
-//#region src/libs/system/system.schema.d.ts
 interface SystemSchema {
   /**
    * System destination directory
@@ -18,8 +17,6 @@ interface SystemSchema {
    */
   language: "js" | "ts";
 }
-//#endregion
-//#region src/libs/system/system.factory.d.ts
 export declare const main: (schema: SystemSchema) => Rule;
-//#endregion
+export {};
 //# sourceMappingURL=system.factory.d.ts.map

package/dist/libs/system/system.factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system.factory.d.ts","names":[],"sources":["../../../src/libs/system/system.schema.d.ts","../../../src/libs/system/system.factory.ts"],"mappings":";;UAAiB;;;;EAIf;;;;EAKA;;;;EAKA;;;;EAKA;;;;qBCiBW,OAAQ,QAAQ,iBAAe"}
+{"version":3,"file":"system.factory.d.ts","names":[],"sources":["../../../src/libs/system/system.schema.d.ts","../../../src/libs/system/system.factory.ts"],"mappings":";UAAiB;;;;EAIf;;;;EAKA;;;;EAKA;;;;EAKA;;qBCiBW,OAAQ,QAAQ,iBAAe"}

package/dist/libs/system/system.factory.js

@@ -1,6 +1,6 @@
 import { join, normalize, strings } from "@angular-devkit/core";
 import { apply, mergeWith, move, template, url } from "@angular-devkit/schematics";
-//#region src/utils/formatting.ts
+// src/utils/formatting.ts
 const toWords = (str) => {
 	return str.replace(/([a-z])([A-Z])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").replace(/[-_]+/g, " ").trim().split(/\s+/).filter(Boolean);
 };
@@ -10,8 +10,7 @@ const toKebabCase = (str) => {
 const toCamelCase = (str) => {
 	return toWords(str).map((word, i) => i === 0 ? word.toLowerCase() : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join("");
 };
-//#endregion
-//#region src/libs/system/system.factory.ts
+// src/libs/system/system.factory.ts
 const transform = (schema) => {
 	return {
 		part: schema.part,
@@ -30,7 +29,6 @@ const main = (schema) => {
 	const options = transform(schema);
 	return mergeWith(generate(options, schema.directory, schema.language));
 };
-//#endregion
 export { main };
 
 //# sourceMappingURL=system.factory.js.map

package/dist/libs/system/system.factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"system.factory.js","names":[],"sources":["../../../src/utils/formatting.ts","../../../src/libs/system/system.factory.ts"],"sourcesContent":["const toWords = (str: string): string[] => {\n  return str\n    .replace(/([a-z])([A-Z])/g, \"$1 $2\")\n    .replace(/([A-Z]+)([A-Z][a-z])/g, \"$1 $2\")\n    .replace(/[-_]+/g, \" \")\n    .trim()\n    .split(/\\s+/)\n    .filter(Boolean);\n};\n\nexport const toKebabCase = (str: string): string => {\n  return toWords(str)\n    .map((word) => word.toLowerCase())\n    .join(\"-\");\n};\n\nexport const toPascalCase = (str: string): string => {\n  return toWords(str)\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\n    .join(\"\");\n};\n\nexport const toCamelCase = (str: string): string => {\n  const words = toWords(str);\n  return words\n    .map((word, i) =>\n      i === 0 ? word.toLowerCase() : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase(),\n    )\n    .join(\"\");\n};\n","import { type Path, join, normalize, strings } from \"@angular-devkit/core\";\nimport {\n  type Rule,\n  type Source,\n  apply,\n  mergeWith,\n  move,\n  template,\n  url,\n} from \"@angular-devkit/schematics\";\n\nimport { toCamelCase, toKebabCase } from \"@utils/formatting\";\n\nimport { type SystemOptions } from \"./system.options\";\nimport { type SystemSchema } from \"./system.schema\";\n\nconst transform = (schema: SystemSchema): SystemOptions => {\n  return {\n    part: schema.part,\n    functionName: toCamelCase(schema.name),\n    fileName: toKebabCase(schema.name),\n  };\n};\n\nconst generate = (options: SystemOptions, path: string, language: \"ts\" | \"js\"): Source => {\n  const rules = [\n    template({\n      ...strings,\n      ...options,\n    }),\n    move(normalize(path)),\n  ];\n\n  return apply(url(join(\"./files\" as Path, language)), rules);\n};\n\nexport const main = (schema: SystemSchema): Rule => {\n  const options = transform(schema);\n\n  return mergeWith(generate(options, schema.directory, schema.language));\n};\n"],"mappings":";;;AAAA,MAAM,WAAW,QAA0B;CACzC,OAAO,IACJ,QAAQ,mBAAmB,OAAO,CAAC,CACnC,QAAQ,yBAAyB,OAAO,CAAC,CACzC,QAAQ,UAAU,GAAG,CAAC,CACtB,KAAK,CAAC,CACN,MAAM,KAAK,CAAC,CACZ,OAAO,OAAO;AACnB;AAEA,MAAa,eAAe,QAAwB;CAClD,OAAO,QAAQ,GAAG,CAAC,CAChB,KAAK,SAAS,KAAK,YAAY,CAAC,CAAC,CACjC,KAAK,GAAG;AACb;AAQA,MAAa,eAAe,QAAwB;CAElD,OADc,QAAQ,GACf,CAAA,CACJ,KAAK,MAAM,MACV,MAAM,IAAI,KAAK,YAAY,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAC1F,CAAC,CACA,KAAK,EAAE;AACZ;;;ACbA,MAAM,aAAa,WAAwC;CACzD,OAAO;EACL,MAAM,OAAO;EACb,cAAc,YAAY,OAAO,IAAI;EACrC,UAAU,YAAY,OAAO,IAAI;CACnC;AACF;AAEA,MAAM,YAAY,SAAwB,MAAc,aAAkC;CACxF,MAAM,QAAQ,CACZ,SAAS;EACP,GAAG;EACH,GAAG;CACL,CAAC,GACD,KAAK,UAAU,IAAI,CAAC,CACtB;CAEA,OAAO,MAAM,IAAI,KAAK,WAAmB,QAAQ,CAAC,GAAG,KAAK;AAC5D;AAEA,MAAa,QAAQ,WAA+B;CAClD,MAAM,UAAU,UAAU,MAAM;CAEhC,OAAO,UAAU,SAAS,SAAS,OAAO,WAAW,OAAO,QAAQ,CAAC;AACvE"}
+{"version":3,"file":"system.factory.js","names":[],"sources":["../../../src/utils/formatting.ts","../../../src/libs/system/system.factory.ts"],"sourcesContent":["const toWords = (str: string): string[] => {\n  return str\n    .replace(/([a-z])([A-Z])/g, \"$1 $2\")\n    .replace(/([A-Z]+)([A-Z][a-z])/g, \"$1 $2\")\n    .replace(/[-_]+/g, \" \")\n    .trim()\n    .split(/\\s+/)\n    .filter(Boolean);\n};\n\nexport const toKebabCase = (str: string): string => {\n  return toWords(str)\n    .map((word) => word.toLowerCase())\n    .join(\"-\");\n};\n\nexport const toPascalCase = (str: string): string => {\n  return toWords(str)\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\n    .join(\"\");\n};\n\nexport const toCamelCase = (str: string): string => {\n  const words = toWords(str);\n  return words\n    .map((word, i) =>\n      i === 0 ? word.toLowerCase() : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase(),\n    )\n    .join(\"\");\n};\n","import { type Path, join, normalize, strings } from \"@angular-devkit/core\";\nimport {\n  type Rule,\n  type Source,\n  apply,\n  mergeWith,\n  move,\n  template,\n  url,\n} from \"@angular-devkit/schematics\";\n\nimport { toCamelCase, toKebabCase } from \"@utils/formatting\";\n\nimport { type SystemOptions } from \"./system.options\";\nimport { type SystemSchema } from \"./system.schema\";\n\nconst transform = (schema: SystemSchema): SystemOptions => {\n  return {\n    part: schema.part,\n    functionName: toCamelCase(schema.name),\n    fileName: toKebabCase(schema.name),\n  };\n};\n\nconst generate = (options: SystemOptions, path: string, language: \"ts\" | \"js\"): Source => {\n  const rules = [\n    template({\n      ...strings,\n      ...options,\n    }),\n    move(normalize(path)),\n  ];\n\n  return apply(url(join(\"./files\" as Path, language)), rules);\n};\n\nexport const main = (schema: SystemSchema): Rule => {\n  const options = transform(schema);\n\n  return mergeWith(generate(options, schema.directory, schema.language));\n};\n"],"mappings":";;;AAAA,MAAM,WAAW,QAA0B;CACzC,OAAO,IACJ,QAAQ,mBAAmB,OAAO,CAAC,CACnC,QAAQ,yBAAyB,OAAO,CAAC,CACzC,QAAQ,UAAU,GAAG,CAAC,CACtB,KAAK,CAAC,CACN,MAAM,KAAK,CAAC,CACZ,OAAO,OAAO;AACnB;AAEA,MAAa,eAAe,QAAwB;CAClD,OAAO,QAAQ,GAAG,CAAC,CAChB,KAAK,SAAS,KAAK,YAAY,CAAC,CAAC,CACjC,KAAK,GAAG;AACb;AAQA,MAAa,eAAe,QAAwB;CAElD,OADc,QAAQ,GACf,CAAA,CACJ,KAAK,MAAM,MACV,MAAM,IAAI,KAAK,YAAY,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAC1F,CAAC,CACA,KAAK,EAAE;AACZ;;ACbA,MAAM,aAAa,WAAwC;CACzD,OAAO;EACL,MAAM,OAAO;EACb,cAAc,YAAY,OAAO,IAAI;EACrC,UAAU,YAAY,OAAO,IAAI;CACnC;AACF;AAEA,MAAM,YAAY,SAAwB,MAAc,aAAkC;CACxF,MAAM,QAAQ,CACZ,SAAS;EACP,GAAG;EACH,GAAG;CACL,CAAC,GACD,KAAK,UAAU,IAAI,CAAC,CACtB;CAEA,OAAO,MAAM,IAAI,KAAK,WAAmB,QAAQ,CAAC,GAAG,KAAK;AAC5D;AAEA,MAAa,QAAQ,WAA+B;CAClD,MAAM,UAAU,UAAU,MAAM;CAEhC,OAAO,UAAU,SAAS,SAAS,OAAO,WAAW,OAAO,QAAQ,CAAC;AACvE"}

package/dist/libs/workspace/files/js/AGENTS.md.template

@@ -0,0 +1,49 @@
+<% var nf = { npm: "npm exec --no -- nf", pnpm: "pnpm exec nf", yarn: "yarn nf", bun: "bun run nf" }[packageManager]; %># <%= name %>
+
+Notes for AI coding agents. This is a NanoForge game workspace, written in JavaScript (ES
+modules, with types in JSDoc comments): a client app that runs in the browser and a server app
+that runs in Bun. NanoForge is a game engine built on an entity component system (ECS).
+
+## Files
+
+- `nanoforge.config.js`: `type: "workspace"`, with `packages: ["apps/*"]`. Each folder it matches
+  is an app with its own `nanoforge.config.js`.
+- `apps/client/`, `apps/server/`: the two apps. Each has its own `AGENTS.md`: read the one of the
+  app you change.
+- `.env`: the `NANOFORGE_*` variables that connect the client to the server (address, TCP and UDP
+  ports). Change both sides together. Git ignores it.
+- `jsconfig.json`: the options your code editor reads the JSDoc types with, extended by each app.
+- `package.json`<% if (packageManager === "pnpm") { %> and `pnpm-workspace.yaml`<% } %>: the <%= packageManager %> workspace. Install every app with
+  `<%= packageManager %> install` here.
+
+## Commands
+
+`nf` comes from the `@nanoforge-dev/cli` dev dependency. Run it from this folder, as
+`<%= nf %> <command>`.
+
+- `nf dev`: runs `nf build --watch` and `nf start --watch` together. The game is on
+  http://localhost:3000, with the server running.
+- `nf build`: bundles every app with Bun into its `dist/`. It does not check the JSDoc
+  types. `-d apps/client` or `-d apps/server` builds one app.
+- `nf start`: runs the last build of both apps.
+
+`nf dev` and `nf start` read the `.env` of their `-d` folder (the current folder by default), so
+run them here.
+
+## Client and server
+
+- They connect over TCP, a WebSocket, and over UDP, a WebRTC data channel set up through a
+  WebSocket. `nf start` gives `NANOFORGE_CLIENT_X` to the client and `NANOFORGE_SERVER_X` to the
+  server, as `X` in the `options.env` of `main`. A plain `NANOFORGE_X` goes to both. Everything
+  the client gets reaches the browser: never put a secret there.
+  https://docs.nanoforge.eu/docs/cli/configuration/environment-variables
+- In the generated game, the server moves the entity and sends its position to every client
+  (`apps/server/src/systems/move-2d.system.js`), and the client sets the position it receives
+  (`apps/client/src/systems/position-sync.system.js`).
+- The apps share no code: each defines its own `Position2D`.
+
+## Docs
+
+- `nf` commands: https://docs.nanoforge.eu/docs/cli/commands/overview
+- The workspace config: https://docs.nanoforge.eu/docs/cli/configuration/configuration-file
+- Everything else: https://docs.nanoforge.eu

package/dist/libs/workspace/files/js/CLAUDE.md.template

@@ -0,0 +1 @@
+@AGENTS.md

package/dist/libs/workspace/files/js/__dot__gitignore

@@ -82,6 +82,10 @@ build/Release
 
 # Dependency directories
 node_modules/
+
+# NanoForge registry packages (nf install restores them from nanoforge.packages.lock.json)
+nf_modules/
+
 jspm_packages/
 
 # Snowpack dependency directory (https://snowpack.dev/)