@nanoforge-dev/schematics 2.3.0 → 3.0.0

package/dist/libs/plugin/theme-files/__dot__gitignore

@@ -0,0 +1,2 @@
+node_modules
+dist

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/js/nanoforge.config.js

@@ -1,4 +1,4 @@
-import { defineConfig } from "nanoforge/config";
+import { defineConfig } from "@nanoforge-dev/config";
 
 export default defineConfig({
   type: "<%= part %>",

package/dist/libs/project/files/js/package.json.template

@@ -10,11 +10,16 @@
     "@nanoforge-dev/network": "<%= networkVersion %>"
   },<% } %>
   "devDependencies": {
-    "@nanoforge-dev/ecs": "<%= ecsVersion %>",<% if (part === "client") { %>
+    "@nanoforge-dev/asset": "<%= engineVersion %>",
+    "@nanoforge-dev/cli": "<%= cliVersion %>",
+    "@nanoforge-dev/common": "<%= engineVersion %>",
+    "@nanoforge-dev/core": "<%= engineVersion %>",
+    "@nanoforge-dev/config": "<%= engineVersion %>",
+    "@nanoforge-dev/ecs": "<%= ecsVersion %>"<% if (part === "client") { %>,
+    "@nanoforge-dev/env": "<%= engineVersion %>",
     "@nanoforge-dev/graphics-2d": "<%= graphics2dVersion %>",
     "@nanoforge-dev/input": "<%= inputVersion %>",
-    "@nanoforge-dev/network": "<%= networkVersion %>",<% } %>
-    "nanoforge": "<%= nanoforgeVersion %>"
+    "@nanoforge-dev/network": "<%= networkVersion %>"<% } %>
   },<% if (packageManager === "npm" && allowBuilds.length > 0) { %>
   "allowScripts": {<% allowBuilds.forEach(function (pkg, i) { %>
     "<%= pkg %>": true<% if (i < allowBuilds.length - 1) { %>,<% } %><% }); %>

package/dist/libs/project/files/js/src/components/drawable-circle-2d.component.js

@@ -1,7 +1,7 @@
 /**
+ * @typedef {import("@nanoforge-dev/common").NfFile} NfFile
  * @typedef {import("@nanoforge-dev/ecs").EditorComponentManifest} EditorComponentManifest
  * @typedef {import("@nanoforge-dev/graphics-2d").Layer} Layer
- * @typedef {import("nanoforge").NfFile} NfFile
  */
 
 import { Circle } from "@nanoforge-dev/graphics-2d";

package/dist/libs/project/files/js/src/main.js

@@ -1,4 +1,4 @@
-import { NanoforgeFactory } from "nanoforge";
+import { NanoforgeFactory } from "@nanoforge-dev/core";
 import { EcsLibrary } from "@nanoforge-dev/ecs/<%= part %>";<% if (part === "client") { %>
 import { Graphics2DLibrary } from "@nanoforge-dev/graphics-2d";
 import { InputLibrary } from "@nanoforge-dev/input";<% } %>
@@ -11,7 +11,7 @@ import { positionSync } from "./systems/position-sync.system";<% } %><% } else {
 import { move2D } from "./systems/move-2d.system";<% } %>
 
 /**
- * @param {import("nanoforge").<%= part === "client" ? "ClientRunOptions" : "ServerRunOptions" %>} options
+ * @param {import("@nanoforge-dev/common").<%= part === "client" ? "ClientRunOptions" : "ServerRunOptions" %>} options
  * @returns {Promise<void>}
  */
 export const main = async (options) => {

package/dist/libs/project/files/js/src/systems/draw-2d.system.js

@@ -1,7 +1,7 @@
 /**
+ * @typedef {import("@nanoforge-dev/common").Context} Context
  * @typedef {import("@nanoforge-dev/ecs").EditorSystemManifest} EditorSystemManifest
  * @typedef {import("@nanoforge-dev/ecs").Registry} Registry
- * @typedef {import("nanoforge").Context} Context
  */
 
 import { DrawableCircle2D } from "../components/drawable-circle-2d.component";

package/dist/libs/project/files/js/src/systems/move-2d.system.js

@@ -1,7 +1,7 @@
 /**
+ * @typedef {import("@nanoforge-dev/common").Context} Context
  * @typedef {import("@nanoforge-dev/ecs").EditorSystemManifest} EditorSystemManifest
  * @typedef {import("@nanoforge-dev/ecs").Registry} Registry
- * @typedef {import("nanoforge").Context} Context
  */
 
 import { Position2D } from "../components/position-2d.component";

package/dist/libs/project/files/js/src/systems/position-sync.system.js

@@ -1,7 +1,7 @@
 /**
+ * @typedef {import("@nanoforge-dev/common").Context} Context
  * @typedef {import("@nanoforge-dev/ecs").EditorSystemManifest} EditorSystemManifest
  * @typedef {import("@nanoforge-dev/ecs").Registry} Registry
- * @typedef {import("nanoforge").Context} Context
  */
 
 import { Position2D } from "../components/position-2d.component";

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/files/ts/nanoforge.config.ts

@@ -1,4 +1,4 @@
-import { defineConfig } from "nanoforge/config";
+import { defineConfig } from "@nanoforge-dev/config";
 
 export default defineConfig({
   type: "<%= part %>",

package/dist/libs/project/files/ts/package.json.template

@@ -10,11 +10,16 @@
     "@nanoforge-dev/network": "<%= networkVersion %>"
   },<% } %>
   "devDependencies": {
-    "@nanoforge-dev/ecs": "<%= ecsVersion %>",<% if (part === "client") { %>
+    "@nanoforge-dev/asset": "<%= engineVersion %>",
+    "@nanoforge-dev/cli": "<%= cliVersion %>",
+    "@nanoforge-dev/common": "<%= engineVersion %>",
+    "@nanoforge-dev/core": "<%= engineVersion %>",
+    "@nanoforge-dev/config": "<%= engineVersion %>",
+    "@nanoforge-dev/ecs": "<%= ecsVersion %>"<% if (part === "client") { %>,
+    "@nanoforge-dev/env": "<%= engineVersion %>",
     "@nanoforge-dev/graphics-2d": "<%= graphics2dVersion %>",
     "@nanoforge-dev/input": "<%= inputVersion %>",
-    "@nanoforge-dev/network": "<%= networkVersion %>",<% } %>
-    "nanoforge": "<%= nanoforgeVersion %>"
+    "@nanoforge-dev/network": "<%= networkVersion %>"<% } %>
   },<% if (packageManager === "npm" && allowBuilds.length > 0) { %>
   "allowScripts": {<% allowBuilds.forEach(function (pkg, i) { %>
     "<%= pkg %>": true<% if (i < allowBuilds.length - 1) { %>,<% } %><% }); %>

package/dist/libs/project/files/ts/src/components/drawable-circle-2d.component.ts

@@ -1,6 +1,6 @@
+import type { NfFile } from "@nanoforge-dev/common";
 import type { EditorComponentManifest } from "@nanoforge-dev/ecs";
 import { Circle, type Layer } from "@nanoforge-dev/graphics-2d";
-import type { NfFile } from "nanoforge";
 
 export class DrawableCircle2D {
   public readonly name: string = this.constructor.name;

package/dist/libs/project/files/ts/src/main.ts

@@ -1,4 +1,5 @@
-import { NanoforgeFactory, type <%= part === "client" ? "ClientRunOptions" : "ServerRunOptions" %> } from "nanoforge";
+import { type <%= part === "client" ? "ClientRunOptions" : "ServerRunOptions" %> } from "@nanoforge-dev/common";
+import { NanoforgeFactory } from "@nanoforge-dev/core";
 import { EcsLibrary } from "@nanoforge-dev/ecs/<%= part %>";<% if (part === "client") { %>
 import { Graphics2DLibrary } from "@nanoforge-dev/graphics-2d";
 import { InputLibrary } from "@nanoforge-dev/input";<% } %>

package/dist/libs/project/files/ts/src/systems/draw-2d.system.ts

@@ -1,5 +1,5 @@
+import type { Context } from "@nanoforge-dev/common";
 import type { EditorSystemManifest, Registry } from "@nanoforge-dev/ecs";
-import { type Context } from "nanoforge";
 
 import { DrawableCircle2D } from "../components/drawable-circle-2d.component";
 import { Position2D } from "../components/position-2d.component";

package/dist/libs/project/files/ts/src/systems/move-2d.system.ts

@@ -1,5 +1,5 @@
+import type { Context } from "@nanoforge-dev/common";
 import type { EditorSystemManifest, Registry } from "@nanoforge-dev/ecs";
-import { type Context } from "nanoforge";
 
 import { Position2D } from "../components/position-2d.component";
 

package/dist/libs/project/files/ts/src/systems/position-sync.system.ts

@@ -1,5 +1,5 @@
+import type { Context } from "@nanoforge-dev/common";
 import type { EditorSystemManifest, Registry } from "@nanoforge-dev/ecs";
-import { type Context } from "nanoforge";
 
 import { Position2D } from "../components/position-2d.component";
 

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;;;;qBC6DW,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,14 +1,15 @@
 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);
 };
 const toKebabCase = (str) => {
 	return toWords(str).map((word) => word.toLowerCase()).join("-");
 };
-//#endregion
-//#region src/utils/registry.ts
+/** Fallback used when the registry lookup for `@nanoforge-dev/cli` fails. */
+const DEFAULT_CLI_DEPENDENCY_VERSION = "latest";
+// src/utils/registry.ts
 const REGISTRY_URL = "https://registry.npmjs.org";
 const DEFAULT_TIMEOUT_MS = 3e3;
 const RELEASE_VERSION_PATTERN = /^\d+\.\d+\.\d+$/;
@@ -46,12 +47,12 @@ 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 [nanoforge, ecs, network, graphics2d, input] = await Promise.all([
-		fetchTrustedVersion("nanoforge", "^2"),
+	const [engine, cli, ecs, network, graphics2d, input] = await Promise.all([
+		fetchTrustedVersion("@nanoforge-dev/core", "^2"),
+		fetchTrustedVersion("@nanoforge-dev/cli", DEFAULT_CLI_DEPENDENCY_VERSION),
 		fetchTrustedVersion("@nanoforge-dev/ecs", "^2"),
 		fetchTrustedVersion("@nanoforge-dev/network", "^2"),
 		isClient ? fetchTrustedVersion("@nanoforge-dev/graphics-2d", "^2") : "^2",
@@ -62,7 +63,8 @@ const resolveDepVersions = async (part) => {
 		graphics2d,
 		input,
 		network,
-		nanoforge
+		engine,
+		cli
 	};
 };
 const transform = async (schema) => {
@@ -83,10 +85,12 @@ const transform = async (schema) => {
 		graphics2dVersion: depVersions.graphics2d,
 		inputVersion: depVersions.input,
 		networkVersion: depVersions.network,
-		nanoforgeVersion: depVersions.nanoforge,
+		engineVersion: depVersions.engine,
+		cliVersion: depVersions.cli,
 		hasServer: schema.hasServer,
 		docker: schema.docker ?? false,
 		editor: schema.editor ?? false,
+		agents: schema.agents ?? true,
 		allowBuilds: workspace ? [] : ["bun"]
 	};
 };
@@ -99,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";
@@ -116,7 +121,6 @@ const main = (schema) => {
 		return mergeWith(generate(options, schema.directory));
 	};
 };
-//#endregion
 export { main };
 
 //# sourceMappingURL=project.factory.js.map