@nanoforge-dev/schematics 2.2.1 → 2.3.1

package/dist/libs/application/files/js/README.md

@@ -1,166 +0,0 @@
-# <%= name %>
-
----
-
-## Prerequisites
-
-- [Node.js](https://nodejs.org/) 18+
-- Package manager: **<%= packageManager %>**
-- [NanoForge CLI](https://www.npmjs.com/package/@nanoforge-dev/cli): `<%= packageManager %> install -g @nanoforge-dev/cli`
-
----
-
-## Installation
-
-```bash
-<%= packageManager %> install
-```
-
----
-
-## Development
-
-Start the game in watch mode with hot reload:
-
-```bash
-nf dev
-```
-
-<% if (editor) { %>Open the visual editor (optional — lets you edit entities, components and systems without touching code):
-```bash
-nf editor
-```
-
-<% } %>---
-
-## Project structure
-
-```
-<%= name %>/
-├── .nanoforge/             # NanoForge internal save files (do not edit manually)
-├── client/                 # Client-side code (runs in the browser)
-│   ├── static/             # Static assets
-│   ├── components/         # ECS components
-│   ├── systems/            # ECS systems<% if (initFunctions) { %>
-│   └── init/               # Lifecycle hooks (before-init, after-run, …)<% } %><% if (server) { %>
-├── server/                 # Server-side code
-│   ├── static/
-│   ├── components/
-│   ├── systems/<% if (initFunctions) { %>
-│   └── init/<% } %><% } %>
-├── package.json
-├── jsconfig.json
-└── nanoforge.config.json   # Game configuration
-```
-
----
-
-## Modifying the game
-
-### Add a component
-
-```bash
-nf generate component <name> --part client
-```
-
-A component is a plain class that holds data for an entity. Edit the generated file in `client/components/`:
-
-```js
-export class MyComponent {
-  constructor(speed) {
-    this.speed = speed;
-  }
-}
-
-export default MyComponent.name;
-```
-
-### Add a system
-
-```bash
-nf generate system <name> --part client
-```
-
-A system is a function that runs every tick and operates on entities that have specific components. Edit the generated file in `client/systems/`:
-
-```js
-import { MyComponent } from "../components/my.component.js";
-
-export const mySystem = (registry, ctx) => {
-  const entities = registry.getZipper([MyComponent]);
-
-  entities.forEach((entity) => {
-    entity.MyComponent.speed += 1;
-  });
-};
-
-export default mySystem.name;
-```
-
-<% if (server) { %>
-### Server-side code
-
-Server components and systems live in `server/` and are imported from `@nanoforge-dev/ecs-server`. They follow the same pattern as the client side.
-
-Configure the server connection in `.env`:
-
-| Variable                              | Default     | Description                     |
-|---------------------------------------|-------------|---------------------------------|
-| `NANOFORGE_CLIENT_SERVER_ADDRESS`     | `127.0.0.1` | Server address (client-side)    |
-| `NANOFORGE_CLIENT_SERVER_TCP_PORT`    | `4444`      | TCP port the client connects to |
-| `NANOFORGE_CLIENT_SERVER_UDP_PORT`    | `4445`      | UDP port the client connects to |
-| `NANOFORGE_SERVER_LISTENING_TCP_PORT` | `4444`      | TCP port the server listens on  |
-| `NANOFORGE_SERVER_LISTENING_UDP_PORT` | `4445`      | UDP port the server listens on  |
-
-<% } %>---
-
-## Build
-
-Compile the game for production:
-
-```bash
-<%= packageManager %> run build
-# or
-nf build
-```
-
-Output is written to the `.nanoforge/` directory.
-
----
-
-## Run
-
-Start the game server and open it in a browser:
-
-```bash
-<%= packageManager %> run start
-# or
-nf start
-```
-
-<% if (lint) { %>---
-
-## Code quality
-
-```bash
-# Check formatting and linting
-<%= packageManager %> run lint
-
-# Auto-fix formatting and linting
-<%= packageManager %> run format
-```
-
-<% } %>---
-
-## CLI reference
-
-| Command                        | Description                               |
-|--------------------------------|-------------------------------------------|
-| `nf dev`                       | Start in development mode with hot reload |
-| `nf build`                     | Build for production                      |
-| `nf start`                     | Run the built game                        |
-| `nf generate component <name>` | Scaffold a new component                  |
-| `nf generate system <name>`    | Scaffold a new system                     |<% if (editor) { %>
-| `nf editor`                    | Open the visual editor                    |<% } %>
-
-Full CLI documentation: <https://docs.nanoforge.eu>

package/dist/libs/application/files/js/eslint.config.js

@@ -1,11 +0,0 @@
-import pluginJs from "@eslint/js";
-import eslintConfigPrettier from "eslint-config-prettier";
-import globals from "globals";
-
-export default [
-  { files: ["{client,server}/**/*.{js}"] },
-  { languageOptions: { globals: globals.node } },
-
-  pluginJs.configs.recommended,
-  eslintConfigPrettier,
-];

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

@@ -1,48 +0,0 @@
-{
-  "name": "<%= name %>",
-  "version": "<%= version %>",
-  "description": "<%= description %>",
-  "author": "<%= author %>",
-  "scripts": {
-    "build": "nf build",
-    "start": "nf start"<% if (lint) { %>,
-    "lint": "prettier --check . && eslint --format=pretty \"{client,server}/**/*.js\"",
-    "format": "prettier --write . && eslint --fix --format=pretty \"{client,server}/**/*.js\""<% } %>
-  },
-  "devDependencies": {<% if (lint) { %>
-    "@eslint/js": "^9.39.0",<% } %>
-    "@nanoforge-dev/asset-manager": "^1",
-    "@nanoforge-dev/cli": "latest",
-    "@nanoforge-dev/common": "^1",
-    "@nanoforge-dev/config": "^1",
-    "@nanoforge-dev/core": "^1",<% if (editor) { %>
-    "@nanoforge-dev/core-editor": "^1",<% } %>
-    "@nanoforge-dev/ecs-client": "^1",<% if (server) { %>
-    "@nanoforge-dev/ecs-server": "^1",<% } %>
-    "@nanoforge-dev/graphics-2d": "^1",<% if (editor) { %>
-    "@nanoforge-dev/graphics-2d-editor": "^1",<% } %>
-    "@nanoforge-dev/input": "^1",
-    "@nanoforge-dev/music": "^1",<% if (server) { %>
-    "@nanoforge-dev/network-client": "^1",
-    "@nanoforge-dev/network-server": "^1",<% } %>
-    "@nanoforge-dev/sound": "^1"<% if (lint) { %>,
-    "eslint": "^9.39.0",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-prettier": "^5.5.4",
-    "globals": "^16.5.0",
-    "lint-staged": "^16.2.6",
-    "prettier": "^3.6.2"<% } %>
-  },<% if (lint) { %>
-  "lint-staged": {
-    "**/*.js": [
-      "prettier --write"
-    ],
-    "{client,server}/**/*.js": [
-      "eslint --fix"
-    ]
-  },<% } %><% if (packageManager === "pnpm") { %>
-  "pnpm": {
-    "neverBuiltDependencies": []
-  },<% } %>
-  "private": true
-}

package/dist/libs/application/files/js/pnpm-workspace.yaml.template

@@ -1,3 +0,0 @@
-allowBuilds:
-  bun: true<% if (server) { %>
-  wrtc: true<% } %>

package/dist/libs/application/files/js/prettier.config.js

@@ -1,6 +0,0 @@
-export default {
-  useTabs: false,
-  singleQuote: false,
-  trailingComma: "all",
-  printWidth: 100,
-};

package/dist/libs/application/files/ts/.prettierignore

@@ -1,8 +0,0 @@
-# Ignore files for PNPM, NPM and YARN
-pnpm-lock.yaml
-package-lock.json
-yarn.lock
-bun.lock
-
-/node_modules
-/.nanoforge

package/dist/libs/application/files/ts/README.md

@@ -1,166 +0,0 @@
-# <%= name %>
-
----
-
-## Prerequisites
-
-- [Node.js](https://nodejs.org/) 18+
-- Package manager: **<%= packageManager %>**
-- [NanoForge CLI](https://www.npmjs.com/package/@nanoforge-dev/cli): `<%= packageManager %> install -g @nanoforge-dev/cli`
-
----
-
-## Installation
-
-```bash
-<%= packageManager %> install
-```
-
----
-
-## Development
-
-Start the game in watch mode with hot reload:
-
-```bash
-nf dev
-```
-
-<% if (editor) { %>Open the visual editor (optional — lets you edit entities, components and systems without touching code):
-```bash
-nf editor
-```
-
-<% } %>---
-
-## Project structure
-
-```
-<%= name %>/
-├── .nanoforge/             # NanoForge internal save files (do not edit manually)
-├── client/                 # Client-side code (runs in the browser)
-│   ├── static/             # Static assets
-│   ├── components/         # ECS components
-│   ├── systems/            # ECS systems<% if (initFunctions) { %>
-│   └── init/               # Lifecycle hooks (before-init, after-run, …)<% } %><% if (server) { %>
-├── server/                 # Server-side code
-│   ├── static/
-│   ├── components/
-│   ├── systems/<% if (initFunctions) { %>
-│   └── init/<% } %><% } %>
-├── package.json
-├── tsconfig.json
-└── nanoforge.config.json   # Game configuration
-```
-
----
-
-## Modifying the game
-
-### Add a component
-
-```bash
-nf generate component <name> --part client
-```
-
-A component is a plain class that holds data for an entity. Edit the generated file in `client/components/`:
-
-```ts
-export class MyComponent {
-  constructor(public speed: number) {}
-}
-
-export default MyComponent.name;
-```
-
-### Add a system
-
-```bash
-nf generate system <name> --part client
-```
-
-A system is a function that runs every tick and operates on entities that have specific components. Edit the generated file in `client/systems/`:
-
-```ts
-import { type Context } from "@nanoforge-dev/common";
-import { type Registry } from "@nanoforge-dev/ecs-client";
-import { MyComponent } from "../components/my.component";
-
-export const mySystem = (registry: Registry, ctx: Context) => {
-  const entities = registry.getZipper([MyComponent]);
-
-  entities.forEach((entity) => {
-    entity.MyComponent.speed += 1;
-  });
-};
-
-export default mySystem.name;
-```
-
-<% if (server) { %>
-### Server-side code
-
-Server components and systems live in `server/` and are imported from `@nanoforge-dev/ecs-server`. They follow the same pattern as the client side.
-
-Configure the server connection in `.env`:
-
-| Variable                              | Default     | Description                     |
-|---------------------------------------|-------------|---------------------------------|
-| `NANOFORGE_CLIENT_SERVER_ADDRESS`     | `127.0.0.1` | Server address (client-side)    |
-| `NANOFORGE_CLIENT_SERVER_TCP_PORT`    | `4444`      | TCP port the client connects to |
-| `NANOFORGE_CLIENT_SERVER_UDP_PORT`    | `4445`      | UDP port the client connects to |
-| `NANOFORGE_SERVER_LISTENING_TCP_PORT` | `4444`      | TCP port the server listens on  |
-| `NANOFORGE_SERVER_LISTENING_UDP_PORT` | `4445`      | UDP port the server listens on  |
-
-<% } %>---
-
-## Build
-
-Compile the game for production:
-
-```bash
-<%= packageManager %> run build
-# or
-nf build
-```
-
-Output is written to the `.nanoforge/` directory.
-
----
-
-## Run
-
-Start the game server and open it in a browser:
-
-```bash
-<%= packageManager %> run start
-# or
-nf start
-```
-
-<% if (lint) { %>---
-
-## Code quality
-
-```bash
-# Check formatting and linting
-<%= packageManager %> run lint
-
-# Auto-fix formatting and linting
-<%= packageManager %> run format
-```
-
-<% } %>---
-
-## CLI reference
-
-| Command                        | Description                               |
-|--------------------------------|-------------------------------------------|
-| `nf dev`                       | Start in development mode with hot reload |
-| `nf build`                     | Build for production                      |
-| `nf start`                     | Run the built game                        |
-| `nf generate component <name>` | Scaffold a new component                  |
-| `nf generate system <name>`    | Scaffold a new system                     |<% if (editor) { %>
-| `nf editor`                    | Open the visual editor                    |<% } %>
-
-Full CLI documentation: <https://docs.nanoforge.eu>

package/dist/libs/application/files/ts/eslint.config.js

@@ -1,15 +0,0 @@
-import pluginJs from "@eslint/js";
-import eslintConfigPrettier from "eslint-config-prettier";
-import globals from "globals";
-import tseslint from "typescript-eslint";
-
-export default [
-  { files: ["{client,server}/**/*.{ts}"] },
-  { languageOptions: { globals: globals.node } },
-
-  pluginJs.configs.recommended,
-  ...tseslint.configs.recommended,
-  ...tseslint.configs.strict,
-  eslintConfigPrettier,
-  { ignores: ["**/*.js", "**/*.d.ts"] },
-];

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

@@ -1,52 +0,0 @@
-{
-  "name": "<%= name %>",
-  "version": "<%= version %>",
-  "description": "<%= description %>",
-  "author": "<%= author %>",
-  "scripts": {
-    "build": "nf build",
-    "start": "nf start"<% if (lint) { %>,
-    "lint": "prettier --check . && eslint --format=pretty \"{client,server}/**/*.ts\"",
-    "format": "prettier --write . && eslint --fix --format=pretty \"{client,server}/**/*.ts\""<% } %>
-  },
-  "devDependencies": {<% if (lint) { %>
-    "@eslint/js": "^9.39.0",<% } %>
-    "@nanoforge-dev/asset-manager": "^1",
-    "@nanoforge-dev/cli": "latest",
-    "@nanoforge-dev/common": "^1",
-    "@nanoforge-dev/config": "^1",
-    "@nanoforge-dev/core": "^1",<% if (editor) { %>
-    "@nanoforge-dev/core-editor": "^1",<% } %>
-    "@nanoforge-dev/ecs-client": "^1",<% if (server) { %>
-    "@nanoforge-dev/ecs-server": "^1",<% } %>
-    "@nanoforge-dev/graphics-2d": "^1",<% if (editor) { %>
-    "@nanoforge-dev/graphics-2d-editor": "^1",<% } %>
-    "@nanoforge-dev/input": "^1",
-    "@nanoforge-dev/music": "^1",<% if (server) { %>
-    "@nanoforge-dev/network-client": "^1",
-    "@nanoforge-dev/network-server": "^1",<% } %>
-    "@nanoforge-dev/sound": "^1",<% if (lint) { %>
-    "@typescript-eslint/eslint-plugin": "^8.46.2",
-    "@typescript-eslint/parser": "^8.46.2",
-    "eslint": "^9.39.0",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-prettier": "^5.5.4",
-    "globals": "^16.5.0",
-    "lint-staged": "^16.2.6",
-    "prettier": "^3.6.2",<% } %>
-    "typescript": "^5.9.3"<% if (lint) { %>,
-    "typescript-eslint": "^8.46.2"<% } %>
-  },<% if (lint) { %>
-  "lint-staged": {
-    "**/*.ts": [
-      "prettier --write"
-    ],
-    "{client,server}/**/*.ts": [
-      "eslint --fix"
-    ]
-  },<% } %><% if (packageManager === "pnpm") { %>
-  "pnpm": {
-    "neverBuiltDependencies": []
-  },<% } %>
-  "private": true
-}

package/dist/libs/application/files/ts/pnpm-workspace.yaml.template

@@ -1,3 +0,0 @@
-allowBuilds:
-  bun: true<% if (server) { %>
-  wrtc: true<% } %>

package/dist/libs/application/files/ts/prettier.config.js

@@ -1,6 +0,0 @@
-export default {
-  useTabs: false,
-  singleQuote: false,
-  trailingComma: "all",
-  printWidth: 100,
-};

package/dist/libs/application/schema.json

@@ -1,70 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema",
-  "$id": "SchematicsNanoForgeBaseApplication",
-  "title": "NanoForge Base Application Options Schema",
-  "type": "object",
-  "properties": {
-    "name": {
-      "type": "string",
-      "description": "The name of the application",
-      "default": "nanoforge-app"
-    },
-    "version": {
-      "type": "string",
-      "description": "NanoForge application version",
-      "default": "0.0.0"
-    },
-    "author": {
-      "type": "string",
-      "description": "NanoForge application author",
-      "default": ""
-    },
-    "description": {
-      "type": "string",
-      "description": "NanoForge application description",
-      "default": ""
-    },
-    "directory": {
-      "type": "string",
-      "description": "NanoForge application destination directory"
-    },
-    "language": {
-      "type": "string",
-      "enum": ["ts", "js"],
-      "description": "NanoForge application language",
-      "default": "ts"
-    },
-    "strict": {
-      "type": "boolean",
-      "description": "With strict mode (TypeScript or JavaScript but only on compatible editor)",
-      "default": true
-    },
-    "lint": {
-      "type": "boolean",
-      "description": "Generate lint files",
-      "default": true
-    },
-    "packageManager": {
-      "type": "string",
-      "enum": ["npm", "yarn", "pnpm", "bun"],
-      "description": "NanoForge application package manager",
-      "default": "npm"
-    },
-    "server": {
-      "type": "boolean",
-      "description": "Configure a server for the application",
-      "default": false
-    },
-    "editor": {
-      "type": "boolean",
-      "description": "Add editor dependencies",
-      "default": false
-    },
-    "initFunctions": {
-      "type": "boolean",
-      "description": "Add init functions to the application",
-      "default": false
-    }
-  },
-  "required": ["name"]
-}

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

@@ -1,31 +0,0 @@
-import { Rule } from "@angular-devkit/schematics";
-
-//#region src/libs/configuration/configuration.schema.d.ts
-interface ConfigurationSchema {
-  /**
-   * The name of the application
-   */
-  name: string;
-  /**
-   * NanoForge application destination directory
-   */
-  directory: string;
-  /**
-   * Configure a server for the application
-   */
-  server: boolean;
-  /**
-   * NanoForge Application language
-   */
-  language: "js" | "ts";
-  /**
-   * Add init functions to the application
-   */
-  initFunctions: boolean;
-}
-//#endregion
-//#region src/libs/configuration/configuration.factory.d.ts
-declare const main: (schema: ConfigurationSchema) => Rule;
-//#endregion
-export { main };
-//# sourceMappingURL=configuration.factory.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"configuration.factory.d.ts","names":["name","directory","server","language","initFunctions"],"sources":["../../../src/libs/configuration/configuration.schema.d.ts","../../../src/libs/configuration/configuration.factory.ts"],"mappings":";;;UAAiB,mBAAA;;;AAAjB;EAIEA,IAAAA;EAJkC;;;EASlCC,SAAAA;EAeAG;;AAAa;EAVbF,MAAAA;;ACqEF;;EDhEEC,QAAAA;ECgE2B;;;ED3D3BC,aAAAA;AAAAA;;;cC2DW,IAAA,GAAQ,MAAA,EAAQ,mBAAA,KAAsB,IAUlD"}