@nanoforge-dev/schematics 2.2.1 → 2.3.1

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

@@ -0,0 +1,127 @@
+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
+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("-");
+};
+/** Fallback used when the registry lookup for `@nanoforge-dev/cli` fails. */
+const DEFAULT_CLI_DEPENDENCY_VERSION = "latest";
+//#endregion
+//#region src/utils/registry.ts
+const REGISTRY_URL = "https://registry.npmjs.org";
+const DEFAULT_TIMEOUT_MS = 3e3;
+const RELEASE_VERSION_PATTERN = /^\d+\.\d+\.\d+$/;
+const compareVersions = (a, b) => {
+	const partsA = a.split(".").map(Number);
+	const partsB = b.split(".").map(Number);
+	for (let i = 0; i < 3; i++) {
+		const diff = (partsA[i] ?? 0) - (partsB[i] ?? 0);
+		if (diff !== 0) return diff;
+	}
+	return 0;
+};
+/**
+* Resolves the newest published version of an npm package that is at least
+* `minAgeHours` old, so freshly (and potentially maliciously) published
+* versions aren't picked up immediately. Falls back to `fallback` on any
+* network error, timeout, missing package, or when no version satisfies the
+* constraints, so callers never have to handle a rejected promise.
+*/
+const fetchTrustedVersion = async (packageName, fallback, options = {}) => {
+	const { minAgeHours = 48, major, timeoutMs = DEFAULT_TIMEOUT_MS } = options;
+	const controller = new AbortController();
+	const timeout = setTimeout(() => controller.abort(), timeoutMs);
+	try {
+		const response = await fetch(`${REGISTRY_URL}/${encodeURIComponent(packageName)}`, { signal: controller.signal });
+		if (!response.ok) return fallback;
+		const time = (await response.json()).time;
+		if (!time) return fallback;
+		const cutoff = Date.now() - minAgeHours * 60 * 60 * 1e3;
+		const eligible = Object.entries(time).filter(([version]) => RELEASE_VERSION_PATTERN.test(version)).filter(([version]) => major === void 0 || Number(version.split(".")[0]) === major).filter(([, publishedAt]) => new Date(publishedAt).getTime() <= cutoff).map(([version]) => version).sort(compareVersions);
+		return eligible.at(-1) ? `^${eligible.at(-1)}` : fallback;
+	} catch {
+		return fallback;
+	} finally {
+		clearTimeout(timeout);
+	}
+};
+//#endregion
+//#region src/libs/project/project.factory.ts
+const resolveDepVersions = async (part) => {
+	const isClient = part === "client";
+	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",
+		isClient ? fetchTrustedVersion("@nanoforge-dev/input", "^2") : "^2"
+	]);
+	return {
+		ecs,
+		graphics2d,
+		input,
+		network,
+		engine,
+		cli
+	};
+};
+const transform = async (schema) => {
+	const packageManager = schema.packageManager ?? "npm";
+	const workspace = schema.workspace ?? true;
+	const depVersions = await resolveDepVersions(schema.part);
+	const name = schema.name ?? schema.part;
+	const packageName = schema.workspaceName ? `${toKebabCase(schema.workspaceName)}-${toKebabCase(name)}` : toKebabCase(schema.name ?? "nanoforge-app");
+	return {
+		part: schema.part,
+		appClass: schema.part === "client" ? "NanoforgeClient" : "NanoforgeServer",
+		packageName,
+		language: schema.language ?? "ts",
+		strict: schema.strict ?? true,
+		packageManager,
+		workspace,
+		ecsVersion: depVersions.ecs,
+		graphics2dVersion: depVersions.graphics2d,
+		inputVersion: depVersions.input,
+		networkVersion: depVersions.network,
+		engineVersion: depVersions.engine,
+		cliVersion: depVersions.cli,
+		hasServer: schema.hasServer,
+		docker: schema.docker ?? false,
+		editor: schema.editor ?? false,
+		allowBuilds: workspace ? [] : ["bun"]
+	};
+};
+const generate = (options, path) => {
+	return apply(url(join("./files", options.language)), [
+		template({
+			dot: ".",
+			...strings,
+			...options
+		}),
+		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) => {
+			const filename = path.split("/").at(-1) ?? "";
+			if (filename.startsWith("drawable-circle-2d.component") || filename.startsWith("draw-2d.system")) return options.part === "client";
+			if (filename.startsWith("move-2d.system")) return options.part === "server";
+			if (filename.startsWith("position-sync.system")) return options.part === "client" && options.hasServer;
+			return true;
+		}),
+		renameTemplateFiles(),
+		move(normalize(path))
+	]);
+};
+const main = (schema) => {
+	return async () => {
+		const options = await transform(schema);
+		return mergeWith(generate(options, schema.directory));
+	};
+};
+//#endregion
+export { main };
+
+//# sourceMappingURL=project.factory.js.map

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

@@ -0,0 +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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"}

package/dist/libs/project/schema.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema",
+  "$id": "SchematicsNanoForgeProject",
+  "title": "NanoForge Project Options Schema",
+  "type": "object",
+  "properties": {
+    "part": {
+      "type": "string",
+      "enum": ["client", "server"],
+      "description": "The type of project to generate"
+    },
+    "workspaceName": {
+      "type": ["string", "null"],
+      "description": "Name of the parent workspace, used to derive the project package name. Optional - when omitted, `name` is used as the whole package name instead of being appended to the workspace name.",
+      "default": null
+    },
+    "name": {
+      "type": ["string", "null"],
+      "description": "Name used to derive the project package name. When `workspaceName` is set, the package name is `${workspaceName}-${name}` (replacing the previous `${workspaceName}-${part}` suffix). When `workspaceName` is absent, `name` becomes the whole package name. Defaults to `part`.",
+      "default": null
+    },
+    "directory": {
+      "type": "string",
+      "description": "Full destination path for this project (e.g. \"apps/client\", \"packages/player-client\"). The caller is responsible for including any part-specific segment - it is not appended automatically.",
+      "default": "apps"
+    },
+    "language": {
+      "type": "string",
+      "enum": ["ts", "js"],
+      "description": "NanoForge project language",
+      "default": "ts"
+    },
+    "strict": {
+      "type": "boolean",
+      "description": "With strict mode",
+      "default": true
+    },
+    "packageManager": {
+      "type": "string",
+      "enum": ["npm", "yarn", "pnpm", "bun"],
+      "description": "The used package manager",
+      "default": "npm"
+    },
+    "workspace": {
+      "type": "boolean",
+      "description": "Whether this project is generated inside an existing NanoForge workspace",
+      "default": true
+    },
+    "docker": {
+      "type": "boolean",
+      "description": "Generate a Dockerfile for the project. Ignored when `workspace` is true - a project inside a workspace is built and run by the workspace's own Dockerfile instead.",
+      "default": false
+    },
+    "initFunctions": {
+      "type": "boolean",
+      "description": "Add init functions to the project",
+      "default": false
+    },
+    "hasServer": {
+      "type": "boolean",
+      "description": "Only meaningful when part is \"client\": whether the client syncs its entity position from a companion server instead of owning it locally. A server project always simulates and broadcasts its own position, regardless of this flag.",
+      "default": false
+    },
+    "editor": {
+      "type": "boolean",
+      "description": "Add editor dependencies",
+      "default": false
+    },
+    "libs": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Relative paths to shared libs this project depends on",
+      "default": []
+    },
+    "allowBuilds": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Package names allowed to run install/build scripts. Only applies to a standalone project (workspace: false); ignored otherwise since the workspace root already handles it.",
+      "default": []
+    }
+  },
+  "required": ["part"]
+}

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 {
   /**
@@ -21,7 +20,6 @@ interface SystemSchema {
 }
 //#endregion
 //#region src/libs/system/system.factory.d.ts
-declare const main: (schema: SystemSchema) => Rule;
+export declare const main: (schema: SystemSchema) => Rule;
 //#endregion
-export { main };
 //# 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":["name","directory","part","language"],"sources":["../../../src/libs/system/system.schema.d.ts","../../../src/libs/system/system.factory.ts"],"mappings":";;;UAAiB,YAAA;;;AAAjB;EAIEA,IAAAA;EAJ2B;;;EAS3BC,SAAAA;EAUQ;AAAA;;EALRC,IAAAA;ECsBF;;;EDjBEC,QAAAA;AAAAA;;;cCiBW,IAAA,GAAQ,MAAA,EAAQ,YAAA,KAAe,IAI3C"}
+{"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

@@ -27,7 +27,8 @@ const generate = (options, path, language) => {
 	return apply(url(join("./files", language)), rules);
 };
 const main = (schema) => {
-	return mergeWith(generate(transform(schema), schema.directory, schema.language));
+	const options = transform(schema);
+	return mergeWith(generate(options, schema.directory, schema.language));
 };
 //#endregion
 export { main };

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;CAGlD,OAAO,UAAU,SAFD,UAAU,MAEA,GAAS,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/.dockerignore

@@ -0,0 +1,5 @@
+**/node_modules/
+**/dist/
+**/.nanoforge/
+**/.env
+.git/

package/dist/libs/workspace/files/js/Dockerfile

@@ -0,0 +1,36 @@
+<% if (packageManager === "bun") { %>FROM oven/bun:1.3 AS base
+<% } else if (packageManager === "pnpm") { %>FROM ghcr.io/pnpm/pnpm:12 AS base
+RUN pnpm runtime set node 26 -g
+<% } else { %>FROM node:26-slim AS base
+<% } %><% if (packageManager === "yarn") { %>
+RUN npm install -g yarn
+<% } %>
+WORKDIR /app
+
+FROM base AS deps
+<% if (packageManager === "pnpm") { %>
+COPY pnpm-lock.yaml ./
+RUN pnpm fetch
+
+FROM deps AS build
+COPY . .
+RUN pnpm install --frozen-lockfile --offline
+<% } else if (packageManager === "npm") { %>
+FROM deps AS build
+COPY . .
+RUN npm ci
+<% } else { %>
+FROM deps AS build
+COPY . .
+RUN <%= packageManager %> install --frozen-lockfile
+<% } %>
+RUN <%= packageManager %> run build
+
+<% if (packageManager === "bun") { %>FROM oven/bun:1.3-slim<% } else { %>FROM base<% } %>
+WORKDIR /app
+
+COPY --from=build /app .
+<% if (packageManager !== "pnpm") { %>
+USER <% if (packageManager === "bun") { %>bun<% } else { %>node<% } %>
+<% } %>EXPOSE 3000
+CMD ["<%= packageManager %>", "run", "start"]

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

@@ -0,0 +1,51 @@
+# <%= name %>
+
+A [NanoForge](https://nanoforge.eu) game workspace.
+
+## Prerequisites
+
+- Node.js and <%= packageManager %>
+- The [NanoForge CLI](https://www.npmjs.com/package/@nanoforge-dev/cli): `npm install -g @nanoforge-dev/cli`
+
+## Install
+
+```bash
+<%= packageManager %> install
+```
+
+## Structure
+
+This is the root of your NanoForge monorepo. `nanoforge.config.js` lists the app packages, and each
+client or server app lives under `apps/<part>` (generated separately with the `project` schematic).
+
+## Development
+
+```bash
+nf dev -r
+```
+
+`-r` runs the command across every app in the workspace. `nf dev` serves the game and watches your
+files, so changes are picked up as you work. Target a single app instead with `-d apps/<part>`.
+
+## Build & start
+
+```bash
+nf build -r
+nf start -r
+```
+
+`nf build` compiles every app for production, and `nf start` serves the build.
+
+## CLI reference
+
+| Command    | Description                          |
+| ---------- | ------------------------------------- |
+| `nf dev`   | Develop with hot reload               |
+| `nf build` | Build for production                  |
+| `nf start` | Run a built app                       |
+| `-r`       | Apply the command to every app        |
+
+## More info
+
+- [Documentation](https://docs.nanoforge.eu) - CLI commands, configuration, and guides
+- [nanoforge.eu](https://nanoforge.eu) - learn more about NanoForge

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

@@ -0,0 +1,137 @@
+### VisualStudioCode template
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+!.vscode/*.code-snippets
+
+# Local History for Visual Studio Code
+.history/
+
+# Built Visual Studio Code Extensions
+*.vsix
+
+### JetBrains template
+
+# User-specific stuff
+.idea/**/workspace.xml
+.idea/**/tasks.xml
+.idea/**/usage.statistics.xml
+.idea/**/dictionaries
+.idea/**/shelf
+
+# Generated files
+.idea/**/contentModel.xml
+
+# Sensitive or high-churn files
+.idea/**/dataSources/
+.idea/**/dataSources.ids
+.idea/**/dataSources.local.xml
+.idea/**/sqlDataSources.xml
+.idea/**/dynamic.xml
+.idea/**/uiDesigner.xml
+.idea/**/dbnavigator.xml
+
+# File-based project format
+*.iws
+
+# Editor-based Rest Client
+.idea/httpRequests
+
+### Node template
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional stylelint cache
+.stylelintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# yarn v2
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
+
+# Turborepo
+.turbo/
+
+### NanoForge template
+# Build/compilation output
+.nanoforge/
+dist/

package/dist/libs/{application → workspace}/files/js/jsconfig.json

@@ -30,6 +30,5 @@
     "target": "ESNext",
     "useDefineForClassFields": true
   },
-  "include": ["client/**/*.js", "server/**/*.js"],
-  "exclude": ["node_modules", ".nanoforge"]
+  "exclude": ["node_modules", ".nanoforge", "dist"]
 }

package/dist/libs/workspace/files/js/nanoforge.config.js

@@ -0,0 +1,6 @@
+import { defineConfig } from "@nanoforge-dev/config";
+
+export default defineConfig({
+  type: "workspace",
+  packages: ["apps/*"],
+});

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

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "name": "<%= name %>",
+  "scripts": {
+    "dev": "nf dev -r",
+    "build": "nf build -r",
+    "start": "nf start -r"
+  },
+  "devDependencies": {
+    "@nanoforge-dev/cli": "<%= cliVersion %>",
+    "@nanoforge-dev/config": "<%= engineVersion %>"
+  },<% if (packageManager !== "pnpm") { %>
+  "workspaces": ["apps/*"],<% } %><% if (packageManager === "npm" && allowBuilds.length > 0) { %>
+  "allowScripts": {<% allowBuilds.forEach(function (pkg, i) { %>
+    "<%= pkg %>": true<% if (i < allowBuilds.length - 1) { %>,<% } %><% }); %>
+  },<% } %><% if (packageManager === "bun" && allowBuilds.length > 0) { %>
+  "trustedDependencies": [<% allowBuilds.forEach(function (pkg, i) { %>"<%= pkg %>"<% if (i < allowBuilds.length - 1) { %>, <% } %><% }); %>],<% } %>
+  "private": true
+}

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

@@ -0,0 +1,6 @@
+packages:
+  - "apps/*"
+<% if (allowBuilds.length > 0) { %>
+allowBuilds:<% allowBuilds.forEach(function (pkg) { %>
+  <%= pkg %>: true<% }); %>
+<% } %>

package/dist/libs/workspace/files/ts/.dockerignore

@@ -0,0 +1,5 @@
+**/node_modules/
+**/dist/
+**/.nanoforge/
+**/.env
+.git/

package/dist/libs/workspace/files/ts/Dockerfile

@@ -0,0 +1,36 @@
+<% if (packageManager === "bun") { %>FROM oven/bun:1.3 AS base
+<% } else if (packageManager === "pnpm") { %>FROM ghcr.io/pnpm/pnpm:12 AS base
+RUN pnpm runtime set node 26 -g
+<% } else { %>FROM node:26-slim AS base
+<% } %><% if (packageManager === "yarn") { %>
+RUN npm install -g yarn
+<% } %>
+WORKDIR /app
+
+FROM base AS deps
+<% if (packageManager === "pnpm") { %>
+COPY pnpm-lock.yaml ./
+RUN pnpm fetch
+
+FROM deps AS build
+COPY . .
+RUN pnpm install --frozen-lockfile --offline
+<% } else if (packageManager === "npm") { %>
+FROM deps AS build
+COPY . .
+RUN npm ci
+<% } else { %>
+FROM deps AS build
+COPY . .
+RUN <%= packageManager %> install --frozen-lockfile
+<% } %>
+RUN <%= packageManager %> run build
+
+<% if (packageManager === "bun") { %>FROM oven/bun:1.3-slim<% } else { %>FROM base<% } %>
+WORKDIR /app
+
+COPY --from=build /app .
+<% if (packageManager !== "pnpm") { %>
+USER <% if (packageManager === "bun") { %>bun<% } else { %>node<% } %>
+<% } %>EXPOSE 3000
+CMD ["<%= packageManager %>", "run", "start"]

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

@@ -0,0 +1,51 @@
+# <%= name %>
+
+A [NanoForge](https://nanoforge.eu) game workspace.
+
+## Prerequisites
+
+- Node.js and <%= packageManager %>
+- The [NanoForge CLI](https://www.npmjs.com/package/@nanoforge-dev/cli): `npm install -g @nanoforge-dev/cli`
+
+## Install
+
+```bash
+<%= packageManager %> install
+```
+
+## Structure
+
+This is the root of your NanoForge monorepo. `nanoforge.config.ts` lists the app packages, and each
+client or server app lives under `apps/<part>` (generated separately with the `project` schematic).
+
+## Development
+
+```bash
+nf dev -r
+```
+
+`-r` runs the command across every app in the workspace. `nf dev` serves the game and watches your
+files, so changes are picked up as you work. Target a single app instead with `-d apps/<part>`.
+
+## Build & start
+
+```bash
+nf build -r
+nf start -r
+```
+
+`nf build` compiles every app for production, and `nf start` serves the build.
+
+## CLI reference
+
+| Command    | Description                          |
+| ---------- | ------------------------------------- |
+| `nf dev`   | Develop with hot reload               |
+| `nf build` | Build for production                  |
+| `nf start` | Run a built app                       |
+| `-r`       | Apply the command to every app        |
+
+## More info
+
+- [Documentation](https://docs.nanoforge.eu) - CLI commands, configuration, and guides
+- [nanoforge.eu](https://nanoforge.eu) - learn more about NanoForge