@nanoforge-dev/schematics 2.3.0 → 3.0.0

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 All notable changes to this project will be documented in this file.
 
+# [3.0.0](https://github.com/NanoForge-dev/CLI/compare/2.3.1...3.0.0) - (2026-11-08)
+
+## Breaking Changes
+
+- **cli:** Install, publish and unpublish on the shared registry lib (#263) ([9fb3abf](https://github.com/NanoForge-dev/CLI/commit/9fb3abfc4ff9c8630acb7a559be3129da04af221)) by @Exeloo
+  - **BREAKING CHANGE:** nf install drops --server, and installs into nf_modules instead of copying files into client/ or server/. Manifests must use the registry format (@scope/name, version, type package or plugin): publish.paths and the scope/name format are no longer read.
+
+## Features
+
+- New CLI options for AGENTS.md documentation (#245) ([63a1446](https://github.com/NanoForge-dev/CLI/commit/63a144662840e3d7487b18f34feade8230507831)) by @hvrp3r
+- Add theme plugin (#248) ([e62ec83](https://github.com/NanoForge-dev/CLI/commit/e62ec831e5a87d5221401a3382856738985a507a)) by @Exeloo
+- **schematics:** Add support for generating NanoForge editor plugins (#241) ([0440154](https://github.com/NanoForge-dev/CLI/commit/044015451885e5ef2a3ad6475477ae326fc21406)) by @Exeloo
+
+# [2.3.1](https://github.com/NanoForge-dev/CLI/compare/2.3.0...2.3.1) - (2026-09-25)
+
 # [2.3.0](https://github.com/NanoForge-dev/CLI/compare/1.6.2...2.3.0) - (2026-09-24)
 
 > `@nanoforge-dev/schematics` now lives in the CLI monorepo (`libs/schematics`) and is released

package/dist/collection.json

@@ -20,6 +20,11 @@
       "factory": "./libs/system/system.factory#main",
       "description": "Create a NanoForge system.",
       "schema": "./libs/system/schema.json"
+    },
+    "plugin": {
+      "factory": "./libs/plugin/plugin.factory#main",
+      "description": "Create a NanoForge editor plugin (manifest, Svelte panel, command, setting).",
+      "schema": "./libs/plugin/schema.json"
     }
   }
 }

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region src/defaults.ts
+// src/defaults.ts
 const DEFAULT_APP_NAME = "nanoforge-app";
 const DEFAULT_LANGUAGE = "ts";
 const DEFAULT_PACKAGE_MANAGER = "npm";
@@ -19,9 +19,11 @@ const DEFAULT_TYPESCRIPT_VERSION = "6.0.3";
 * maliciously) published release isn't picked up immediately.
 */
 const MIN_RELEASE_AGE_HOURS = 48;
-//#endregion
+/** Fallback for the editor packages (`@nanoforge-dev/editor-*`), which share one version line. */
+const DEFAULT_EDITOR_VERSION = "^1.0.0";
 exports.DEFAULT_APP_NAME = DEFAULT_APP_NAME;
 exports.DEFAULT_CLI_DEPENDENCY_VERSION = DEFAULT_CLI_DEPENDENCY_VERSION;
+exports.DEFAULT_EDITOR_VERSION = DEFAULT_EDITOR_VERSION;
 exports.DEFAULT_ENGINE_VERSION = DEFAULT_ENGINE_VERSION;
 exports.DEFAULT_LANGUAGE = DEFAULT_LANGUAGE;
 exports.DEFAULT_NANOFORGE_DEPENDENCY_VERSION = DEFAULT_NANOFORGE_DEPENDENCY_VERSION;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../src/defaults.ts"],"sourcesContent":["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"],"mappings":";;AAAA,MAAa,mBAAmB;AAChC,MAAa,mBAAmB;AAChC,MAAa,0BAA0B;AACvC,MAAa,uCAAuC;AACpD,MAAa,yBAAyB;;AAGtC,MAAa,iCAAiC;;;;;AAM9C,MAAa,6BAA6B;;;;;;;AAQ1C,MAAa,wBAAwB"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/defaults.ts"],"sourcesContent":["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"],"mappings":";;AAAA,MAAa,mBAAmB;AAChC,MAAa,mBAAmB;AAChC,MAAa,0BAA0B;AACvC,MAAa,uCAAuC;AACpD,MAAa,yBAAyB;;AAGtC,MAAa,iCAAiC;;;;;AAM9C,MAAa,6BAA6B;;;;;;;AAQ1C,MAAa,wBAAwB;;AAGrC,MAAa,yBAAyB"}

package/dist/index.d.cts

@@ -1,4 +1,3 @@
-//#region src/defaults.d.ts
 export declare const DEFAULT_APP_NAME = "nanoforge-app";
 export declare const DEFAULT_LANGUAGE = "ts";
 export declare const DEFAULT_PACKAGE_MANAGER = "npm";
@@ -18,5 +17,6 @@ export declare const DEFAULT_TYPESCRIPT_VERSION = "6.0.3";
  * maliciously) published release isn't picked up immediately.
  */
 export declare const MIN_RELEASE_AGE_HOURS = 48;
-//#endregion
+/** Fallback for the editor packages (`@nanoforge-dev/editor-*`), which share one version line. */
+export declare const DEFAULT_EDITOR_VERSION = "^1.0.0";
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/defaults.ts"],"mappings":";qBAAa;qBACA;qBACA;qBACA;qBACA;;qBAGA;;;;;qBAMA;;;;;;;qBAQA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/defaults.ts"],"mappings":"A,qBAAa;qBACA;qBACA;qBACA;qBACA;;qBAGA;;;;;qBAMA;;;;;;;qBAQA;;qBAGA"}

package/dist/index.d.ts

@@ -1,4 +1,3 @@
-//#region src/defaults.d.ts
 export declare const DEFAULT_APP_NAME = "nanoforge-app";
 export declare const DEFAULT_LANGUAGE = "ts";
 export declare const DEFAULT_PACKAGE_MANAGER = "npm";
@@ -18,5 +17,6 @@ export declare const DEFAULT_TYPESCRIPT_VERSION = "6.0.3";
  * maliciously) published release isn't picked up immediately.
  */
 export declare const MIN_RELEASE_AGE_HOURS = 48;
-//#endregion
+/** Fallback for the editor packages (`@nanoforge-dev/editor-*`), which share one version line. */
+export declare const DEFAULT_EDITOR_VERSION = "^1.0.0";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/defaults.ts"],"mappings":";qBAAa;qBACA;qBACA;qBACA;qBACA;;qBAGA;;;;;qBAMA;;;;;;;qBAQA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/defaults.ts"],"mappings":"A,qBAAa;qBACA;qBACA;qBACA;qBACA;;qBAGA;;;;;qBAMA;;;;;;;qBAQA;;qBAGA"}

package/dist/index.js

@@ -1,4 +1,4 @@
-//#region src/defaults.ts
+// src/defaults.ts
 const DEFAULT_APP_NAME = "nanoforge-app";
 const DEFAULT_LANGUAGE = "ts";
 const DEFAULT_PACKAGE_MANAGER = "npm";
@@ -18,7 +18,8 @@ const DEFAULT_TYPESCRIPT_VERSION = "6.0.3";
 * maliciously) published release isn't picked up immediately.
 */
 const MIN_RELEASE_AGE_HOURS = 48;
-//#endregion
-export { DEFAULT_APP_NAME, DEFAULT_CLI_DEPENDENCY_VERSION, DEFAULT_ENGINE_VERSION, DEFAULT_LANGUAGE, DEFAULT_NANOFORGE_DEPENDENCY_VERSION, DEFAULT_PACKAGE_MANAGER, DEFAULT_TYPESCRIPT_VERSION, MIN_RELEASE_AGE_HOURS };
+/** Fallback for the editor packages (`@nanoforge-dev/editor-*`), which share one version line. */
+const DEFAULT_EDITOR_VERSION = "^1.0.0";
+export { DEFAULT_APP_NAME, DEFAULT_CLI_DEPENDENCY_VERSION, DEFAULT_EDITOR_VERSION, DEFAULT_ENGINE_VERSION, DEFAULT_LANGUAGE, DEFAULT_NANOFORGE_DEPENDENCY_VERSION, DEFAULT_PACKAGE_MANAGER, DEFAULT_TYPESCRIPT_VERSION, MIN_RELEASE_AGE_HOURS };
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/defaults.ts"],"sourcesContent":["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"],"mappings":";AAAA,MAAa,mBAAmB;AAChC,MAAa,mBAAmB;AAChC,MAAa,0BAA0B;AACvC,MAAa,uCAAuC;AACpD,MAAa,yBAAyB;;AAGtC,MAAa,iCAAiC;;;;;AAM9C,MAAa,6BAA6B;;;;;;;AAQ1C,MAAa,wBAAwB"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/defaults.ts"],"sourcesContent":["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"],"mappings":";AAAA,MAAa,mBAAmB;AAChC,MAAa,mBAAmB;AAChC,MAAa,0BAA0B;AACvC,MAAa,uCAAuC;AACpD,MAAa,yBAAyB;;AAGtC,MAAa,iCAAiC;;;;;AAM9C,MAAa,6BAA6B;;;;;;;AAQ1C,MAAa,wBAAwB;;AAGrC,MAAa,yBAAyB"}

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

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

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

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

package/dist/libs/component/component.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 toPascalCase = (str) => {
 	return toWords(str).map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join("");
 };
-//#endregion
-//#region src/libs/component/component.factory.ts
+// src/libs/component/component.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=component.factory.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"component.factory.js","names":[],"sources":["../../../src/utils/formatting.ts","../../../src/libs/component/component.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 { toKebabCase, toPascalCase } from \"@utils/formatting\";\n\nimport { type ComponentOptions } from \"./component.options\";\nimport { type ComponentSchema } from \"./component.schema\";\n\nconst transform = (schema: ComponentSchema): ComponentOptions => {\n  return {\n    part: schema.part,\n    className: toPascalCase(schema.name),\n    fileName: toKebabCase(schema.name),\n  };\n};\n\nconst generate = (options: ComponentOptions, 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: ComponentSchema): 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;AAEA,MAAa,gBAAgB,QAAwB;CACnD,OAAO,QAAQ,GAAG,CAAC,CAChB,KAAK,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CACzE,KAAK,EAAE;AACZ;;;ACJA,MAAM,aAAa,WAA8C;CAC/D,OAAO;EACL,MAAM,OAAO;EACb,WAAW,aAAa,OAAO,IAAI;EACnC,UAAU,YAAY,OAAO,IAAI;CACnC;AACF;AAEA,MAAM,YAAY,SAA2B,MAAc,aAAkC;CAC3F,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,WAAkC;CACrD,MAAM,UAAU,UAAU,MAAM;CAEhC,OAAO,UAAU,SAAS,SAAS,OAAO,WAAW,OAAO,QAAQ,CAAC;AACvE"}
+{"version":3,"file":"component.factory.js","names":[],"sources":["../../../src/utils/formatting.ts","../../../src/libs/component/component.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 { toKebabCase, toPascalCase } from \"@utils/formatting\";\n\nimport { type ComponentOptions } from \"./component.options\";\nimport { type ComponentSchema } from \"./component.schema\";\n\nconst transform = (schema: ComponentSchema): ComponentOptions => {\n  return {\n    part: schema.part,\n    className: toPascalCase(schema.name),\n    fileName: toKebabCase(schema.name),\n  };\n};\n\nconst generate = (options: ComponentOptions, 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: ComponentSchema): 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;AAEA,MAAa,gBAAgB,QAAwB;CACnD,OAAO,QAAQ,GAAG,CAAC,CAChB,KAAK,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CACzE,KAAK,EAAE;AACZ;;ACJA,MAAM,aAAa,WAA8C;CAC/D,OAAO;EACL,MAAM,OAAO;EACb,WAAW,aAAa,OAAO,IAAI;EACnC,UAAU,YAAY,OAAO,IAAI;CACnC;AACF;AAEA,MAAM,YAAY,SAA2B,MAAc,aAAkC;CAC3F,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,WAAkC;CACrD,MAAM,UAAU,UAAU,MAAM;CAEhC,OAAO,UAAU,SAAS,SAAS,OAAO,WAAW,OAAO,QAAQ,CAAC;AACvE"}

package/dist/libs/plugin/files/README.md

@@ -0,0 +1,23 @@
+# <%= title %>
+
+A NanoForge editor plugin (`<%= name %>`).
+
+- `nanoforge.manifest.json`: what the plugin adds to the editor (a panel, a command, a menu entry, a setting).
+- `src/index.ts`: `activate`, run when the panel is first shown or the command first runs.
+- `src/Panel.svelte`: the panel.
+
+## Run it in the editor
+
+```sh
+pnpm install
+pnpm dev                                  # rebuilds dist/ on every change
+DEV_PLUGINS=$(pwd) nf editor <a project>  # in another terminal: the editor reloads the plugin
+```
+
+The <%= title %> panel opens in the bottom right dock. _View › Panels › <%= title %>_ shows it again once closed, and _Edit › Add to the counter_ runs its command.
+
+## Install it without the dev mode
+
+Build it (`pnpm build`), then copy `dist/` to `~/.nanoforge/editor/plugins/<%= name %>` (every project) or to `<project>/.nanoforge/plugins/<%= name %>` (that project).
+
+The plugin authoring guide has the rest: the manifest, the SDK, extension points, settings, history.

package/dist/libs/plugin/files/__dot__gitignore

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

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

@@ -0,0 +1,49 @@
+{
+  "type": "plugin",
+  "name": "<%= name %>",
+  "version": "0.1.0",
+  "displayName": "<%= title %>",
+  "description": "Counts, to show how an editor plugin is made.",
+  "engines": {
+    "editor": ">=0.1.0"
+  },
+  "entry": {
+    "client": "index.js"
+  },
+  "activation": ["onWidget:<%= id %>.panel", "onCommand:<%= id %>.add"],
+  "contributes": {
+    "widgets": [
+      {
+        "id": "<%= id %>.panel",
+        "title": "<%= title %>",
+        "icon": "plus",
+        "defaultSlot": "rightBottom",
+        "order": 900
+      }
+    ],
+    "commands": [
+      {
+        "id": "<%= id %>.add",
+        "title": "Add to the counter",
+        "category": "<%= title %>"
+      }
+    ],
+    "menus": [
+      {
+        "menu": "edit",
+        "command": "<%= id %>.add",
+        "group": "<%= id %>"
+      }
+    ],
+    "settings": [
+      {
+        "key": "step",
+        "type": "number",
+        "default": 1,
+        "title": "Step",
+        "description": "How much each click adds.",
+        "category": "<%= title %>"
+      }
+    ]
+  }
+}

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

@@ -0,0 +1,21 @@
+{
+  "name": "<%= short %>-editor-plugin",
+  "version": "0.1.0",
+  "private": true,
+  "description": "<%= title %>: a NanoForge editor plugin",
+  "type": "module",
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "typecheck": "svelte-check --tsconfig ./tsconfig.json"
+  },
+  "devDependencies": {
+    "@nanoforge-dev/editor-sdk": "<%= editorSdkVersion %>",
+    "@nanoforge-dev/editor-vite-plugin": "<%= editorVitePluginVersion %>",
+    "@sveltejs/vite-plugin-svelte": "^6.0.0 || ^7.0.0",
+    "svelte": "^5.0.0",
+    "svelte-check": "^4.0.0",
+    "typescript": "^6.0.0",
+    "vite": "^7.0.0 || ^8.0.0"
+  }
+}

package/dist/libs/plugin/files/src/Panel.svelte

@@ -0,0 +1,35 @@
+<script lang="ts">
+  import { EditorServices } from '@nanoforge-dev/editor-sdk';
+  import { Button, type WidgetInstance } from '@nanoforge-dev/editor-sdk/ui';
+
+  import { count } from './counter';
+  import { HISTORY } from './index';
+
+  const { instance }: { instance: WidgetInstance } = $props();
+  const add = () => instance.services.get(EditorServices.Commands).execute('<%= id %>.add');
+
+  // While this panel has focus, undo and redo act on the plugin's history.
+  $effect(() => {
+    instance.setHistoryContext(HISTORY);
+    return () => instance.setHistoryContext(undefined);
+  });
+</script>
+
+<section class="<%= short %>" aria-label="<%= title %>">
+  <p class="count" role="status">{$count}</p>
+  <Button variant="primary" onclick={() => void add()}>Add</Button>
+</section>
+
+<style>
+  .<%= short %> {
+    display: grid;
+    gap: var(--nf-space-3);
+    justify-items: center;
+    padding: var(--nf-space-4);
+  }
+  .count {
+    margin: 0;
+    font-size: 2.5rem;
+    font-weight: 600;
+  }
+</style>

package/dist/libs/plugin/files/src/counter.ts

@@ -0,0 +1,4 @@
+import { ObservableValue } from '@nanoforge-dev/editor-sdk';
+
+/** The plugin's state, shared by its command and its panel. */
+export const count = new ObservableValue(0);

package/dist/libs/plugin/files/src/index.ts

@@ -0,0 +1,52 @@
+import type { Component } from 'svelte';
+
+import { HistoryServiceToken, SettingsServiceToken, definePlugin } from '@nanoforge-dev/editor-sdk';
+import { StyleServiceToken, WIDGET_VIEWS, type WidgetInstance } from '@nanoforge-dev/editor-sdk/ui';
+
+import Panel from './Panel.svelte';
+import { count } from './counter';
+
+/** Undo and redo target of the panel (see Panel.svelte). */
+export const HISTORY = '<%= id %>';
+
+export default definePlugin({
+  async activate(context) {
+    const { services } = context;
+
+    // The panel's styles are built into <%= short %>.css: the plugin injects them when it starts.
+    const css = await fetch(context.resolveAsset('<%= short %>.css')).then((response) =>
+      response.ok ? response.text() : '',
+    );
+    context.subscriptions.add(services.get(StyleServiceToken).inject(context.name, css));
+
+    // The view of the widget declared in the manifest.
+    context.subscriptions.add(
+      context.contribute(WIDGET_VIEWS, {
+        id: '<%= id %>.panel',
+        component: Panel as Component<{ instance: WidgetInstance }>,
+      }),
+    );
+
+    // A history of its own: each addition can be undone with Ctrl+Z while the panel has focus.
+    const history = services.get(HistoryServiceToken).registerContext({
+      id: HISTORY,
+      label: '<%= title %>',
+      owner: context.name,
+    });
+    context.subscriptions.add(history);
+
+    // The command declared in the manifest. Settings keys carry the plugin's name.
+    const settings = services.get(SettingsServiceToken);
+    context.subscriptions.add(
+      context.registerCommand('<%= id %>.add', async () => {
+        const step = Number(settings.get('<%= name %>.step')) || 1;
+        await history.stack.push({
+          label: `Add ${step}`,
+          do: () => count.set(count.get() + step),
+          undo: () => count.set(count.get() - step),
+        });
+        context.logger.info(`Counter: ${count.get()}`);
+      }),
+    );
+  },
+});

package/dist/libs/plugin/files/svelte.config.js

@@ -0,0 +1,2 @@
+/** Plugins compile Svelte in runes mode, like the editor. */
+export default { compilerOptions: { runes: true } };

package/dist/libs/plugin/files/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2023",
+    "lib": ["ESNext", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "strict": true,
+    "verbatimModuleSyntax": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "types": ["vite/client"]
+  },
+  "include": ["src/**/*.ts", "src/**/*.svelte"]
+}

package/dist/libs/plugin/files/vite.config.ts

@@ -0,0 +1,12 @@
+import { svelte } from '@sveltejs/vite-plugin-svelte';
+import { defineConfig } from 'vite';
+
+import { nanoforgeEditorPlugin } from '@nanoforge-dev/editor-vite-plugin';
+
+// Builds dist/: index.js, <%= short %>.css and the manifest. The editor loads that folder.
+export default defineConfig({
+  plugins: [svelte(), nanoforgeEditorPlugin()],
+  build: {
+    lib: { entry: { index: 'src/index.ts' }, formats: ['es'], cssFileName: '<%= short %>' },
+  },
+});

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

@@ -0,0 +1,18 @@
+import { Rule } from "@angular-devkit/schematics";
+interface PluginSchema {
+  /**
+   * Plugin name in the registry, as @scope/name
+   */
+  name: string;
+  /**
+   * Plugin destination directory. Defaults to the plugin's short name.
+   */
+  directory?: string | null;
+  /**
+   * What to start from: a panel (default) or a color theme with no code
+   */
+  template?: "panel" | "theme";
+}
+export declare const main: (schema: PluginSchema) => Rule;
+export {};
+//# sourceMappingURL=plugin.factory.d.ts.map

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

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

package/dist/libs/plugin/plugin.factory.js

@@ -0,0 +1,111 @@
+import { normalize, strings } from "@angular-devkit/core";
+import { SchematicsException, apply, mergeWith, move, renameTemplateFiles, template, url } from "@angular-devkit/schematics";
+// 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 toCamelCase = (str) => {
+	return toWords(str).map((word, i) => i === 0 ? word.toLowerCase() : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join("");
+};
+/** Fallback for the editor packages (`@nanoforge-dev/editor-*`), which share one version line. */
+const DEFAULT_EDITOR_VERSION = "^1.0.0";
+// 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);
+	}
+};
+/**
+* Resolves several packages' trusted versions in parallel. Keys of `specs`
+* are the package name to query the registry for; values are the fallback
+* to use if that lookup fails. Returns a map from the *same* keys to the
+* resolved (or fallback) version — typed so callers don't get `| undefined`
+* back for a key they just passed in.
+*/
+const fetchTrustedVersions = async (specs) => {
+	const entries = await Promise.all(Object.entries(specs).map(async ([packageName, { fallback, major }]) => {
+		return [packageName, await fetchTrustedVersion(packageName, fallback, { major })];
+	}));
+	return Object.fromEntries(entries);
+};
+// src/libs/plugin/plugin.factory.ts
+const PLUGIN_NAME_PATTERN = /^@([a-z0-9][a-z0-9-]*)\/([a-z0-9][a-z0-9-]*)$/;
+const transform = async (schema) => {
+	const theme = schema.template === "theme";
+	const name = schema.name.trim();
+	const short = PLUGIN_NAME_PATTERN.exec(name)?.[2];
+	if (!short) throw new SchematicsException(`"${name}" is not a plugin name. Use @scope/name, in lowercase: @acme/counter.`);
+	const versions = theme ? {
+		"@nanoforge-dev/editor-sdk": DEFAULT_EDITOR_VERSION,
+		"@nanoforge-dev/editor-vite-plugin": DEFAULT_EDITOR_VERSION
+	} : await fetchTrustedVersions({
+		"@nanoforge-dev/editor-sdk": {
+			fallback: DEFAULT_EDITOR_VERSION,
+			major: 1
+		},
+		"@nanoforge-dev/editor-vite-plugin": {
+			fallback: DEFAULT_EDITOR_VERSION,
+			major: 1
+		}
+	});
+	return {
+		name,
+		short,
+		title: short.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" "),
+		id: toCamelCase(short),
+		editorSdkVersion: versions["@nanoforge-dev/editor-sdk"],
+		editorVitePluginVersion: versions["@nanoforge-dev/editor-vite-plugin"]
+	};
+};
+const generate = (options, path, theme) => {
+	return apply(url(theme ? "./theme-files" : "./files"), [
+		template({
+			dot: ".",
+			...strings,
+			...options
+		}),
+		renameTemplateFiles(),
+		move(normalize(path))
+	]);
+};
+const main = (schema) => {
+	return async () => {
+		const options = await transform(schema);
+		return mergeWith(generate(options, schema.directory ?? options.short, schema.template === "theme"));
+	};
+};
+export { main };
+
+//# sourceMappingURL=plugin.factory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.factory.js","names":[],"sources":["../../../src/utils/formatting.ts","../../../src/defaults.ts","../../../src/utils/registry.ts","../../../src/libs/plugin/plugin.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 { normalize, strings } from \"@angular-devkit/core\";\nimport {\n  type Rule,\n  SchematicsException,\n  type Source,\n  apply,\n  mergeWith,\n  move,\n  renameTemplateFiles,\n  template,\n  url,\n} from \"@angular-devkit/schematics\";\n\nimport { toCamelCase } from \"@utils/formatting\";\nimport { fetchTrustedVersions } from \"@utils/registry\";\n\nimport { DEFAULT_EDITOR_VERSION } from \"~/defaults\";\n\nimport { type PluginOptions } from \"./plugin.options\";\nimport { type PluginSchema } from \"./plugin.schema\";\n\nconst PLUGIN_NAME_PATTERN = /^@([a-z0-9][a-z0-9-]*)\\/([a-z0-9][a-z0-9-]*)$/;\n\nconst transform = async (schema: PluginSchema): Promise<PluginOptions> => {\n  const theme = schema.template === \"theme\";\n  const name = schema.name.trim();\n  const short = PLUGIN_NAME_PATTERN.exec(name)?.[2];\n  if (!short) {\n    throw new SchematicsException(\n      `\"${name}\" is not a plugin name. Use @scope/name, in lowercase: @acme/counter.`,\n    );\n  }\n\n  // A theme has no code: it needs no editor package.\n  const versions = theme\n    ? {\n        \"@nanoforge-dev/editor-sdk\": DEFAULT_EDITOR_VERSION,\n        \"@nanoforge-dev/editor-vite-plugin\": DEFAULT_EDITOR_VERSION,\n      }\n    : await fetchTrustedVersions({\n        \"@nanoforge-dev/editor-sdk\": { fallback: DEFAULT_EDITOR_VERSION, major: 1 },\n        \"@nanoforge-dev/editor-vite-plugin\": { fallback: DEFAULT_EDITOR_VERSION, major: 1 },\n      });\n\n  return {\n    name,\n    short,\n    title: short\n      .split(\"-\")\n      .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n      .join(\" \"),\n    id: toCamelCase(short),\n    editorSdkVersion: versions[\"@nanoforge-dev/editor-sdk\"],\n    editorVitePluginVersion: versions[\"@nanoforge-dev/editor-vite-plugin\"],\n  };\n};\n\nconst generate = (options: PluginOptions, path: string, theme: boolean): Source => {\n  return apply(url(theme ? \"./theme-files\" : \"./files\"), [\n    template({\n      dot: \".\",\n      ...strings,\n      ...options,\n    }),\n    renameTemplateFiles(),\n    move(normalize(path)),\n  ]);\n};\n\nexport const main = (schema: PluginSchema): Rule => {\n  return async () => {\n    const options = await transform(schema);\n\n    return mergeWith(\n      generate(options, schema.directory ?? options.short, schema.template === \"theme\"),\n    );\n  };\n};\n"],"mappings":"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"}

package/dist/libs/plugin/schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema",
+  "$id": "SchematicsNanoForgePlugin",
+  "title": "NanoForge Editor Plugin Options Schema",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Plugin name in the registry, as @scope/name (lowercase letters, digits and dashes)",
+      "pattern": "^@[a-z0-9][a-z0-9-]*/[a-z0-9][a-z0-9-]*$"
+    },
+    "directory": {
+      "type": ["string", "null"],
+      "description": "Plugin destination directory. Defaults to the plugin's short name (the part after the scope).",
+      "default": null
+    },
+    "template": {
+      "type": "string",
+      "enum": ["panel", "theme"],
+      "description": "What to start from: a panel with a command and a setting (panel), or a color theme with no code (theme).",
+      "default": "panel"
+    }
+  },
+  "required": ["name"]
+}

package/dist/libs/plugin/theme-files/README.md

@@ -0,0 +1,21 @@
+# <%= title %>
+
+A NanoForge editor theme (`<%= name %>`), with no code: everything is in `nanoforge.manifest.json`.
+
+- `contributes.themes`: the theme. It `extends` the editor's dark theme and gives only the colors it changes; give `kind` and every color to start from nothing. `syntax` colors the code, `tokens` changes fonts and corners.
+- `contributes.icons`: icons as SVG files of the plugin, by name. `contributes.iconThemes` replaces the editor's icons and gives file and folder icons.
+
+The editor checks the theme's contrast when it is applied: text that falls under 4.5:1 is named in its Console.
+
+## Run it in the editor
+
+```sh
+pnpm dev                                  # copies the manifest and icons to dist/ on every change
+DEV_PLUGINS=$(pwd) nf editor <a project>  # in another terminal: the editor reloads the theme
+```
+
+Choose it in _Settings › Editor › Appearance_.
+
+## Publish it
+
+`keywords: ["theme"]` lists it under _Get more themes_ in the editor's marketplace. The plugin authoring guide has the list of colors and tokens.