@razorwind/nx 0.0.4 → 0.0.6

package/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 # Changelog for Razorwind - Nx
 
+## [0.0.6](https://github.com/storm-software/razorwind/releases/tag/nx%400.0.6) (07/30/2026)
+
+### Features
+
+- **nx:** Added sync generator to Nx plugin ([b72ebe4](https://github.com/storm-software/razorwind/commit/b72ebe4))
+
+### Updated Dependencies
+
+- Updated **core** to **v0.0.12**
+
+## [0.0.5](https://github.com/storm-software/razorwind/releases/tag/nx%400.0.5) (07/30/2026)
+
+### Features
+
+- **core:** Update generator to read `componentsPath` to populate specification ([77ce658](https://github.com/storm-software/razorwind/commit/77ce658))
+
+### Updated Dependencies
+
+- Updated **core** to **v0.0.11**
+
 ## [0.0.4](https://github.com/storm-software/razorwind/releases/tag/nx%400.0.4) (07/27/2026)
 
 ### Updated Dependencies

package/dist/executors/generate/executor.d.mts

@@ -19,10 +19,10 @@ interface GenerateExecutorSchema {
    */
   mode: string;
   /**
-   * The path to the registry.json file
+   * The path to a directory containing component directories or files
    *
    */
-  registryPath?: string;
+  componentsPath?: string;
   /**
    * The path to the tokens.json file
    *

package/dist/executors/generate/executor.d.ts

@@ -19,10 +19,10 @@ interface GenerateExecutorSchema {
    */
   mode: string;
   /**
-   * The path to the registry.json file
+   * The path to a directory containing component directories or files
    *
    */
-  registryPath?: string;
+  componentsPath?: string;
   /**
    * The path to the tokens.json file
    *

package/dist/executors/generate/executor.js

@@ -6,10 +6,8 @@ async function executorFn(options, context) {
 	if (!context.projectName) throw new Error(`The Razorwind - Generate executor requires \`projectName\` on the context object.`);
 	if (!context.projectName || !context.projectsConfigurations?.projects || !context.projectsConfigurations.projects[context.projectName] || !context.projectsConfigurations.projects[context.projectName]?.root) throw new Error(`The Razorwind - Generate executor requires \`projectsConfigurations\` on the context object.`);
 	await (0, _power_plant_core.execute)(_razorwind_core.generator, {
-		configFile: options.configFile,
-		mode: options.mode,
-		registryPath: options.registryPath,
-		tokensPath: options.tokensPath
+		...options,
+		mode: options.mode
 	});
 	return { success: true };
 }

package/dist/executors/generate/executor.mjs

@@ -6,10 +6,8 @@ async function executorFn(options, context) {
 	if (!context.projectName) throw new Error(`The Razorwind - Generate executor requires \`projectName\` on the context object.`);
 	if (!context.projectName || !context.projectsConfigurations?.projects || !context.projectsConfigurations.projects[context.projectName] || !context.projectsConfigurations.projects[context.projectName]?.root) throw new Error(`The Razorwind - Generate executor requires \`projectsConfigurations\` on the context object.`);
 	await execute(generator, {
-		configFile: options.configFile,
-		mode: options.mode,
-		registryPath: options.registryPath,
-		tokensPath: options.tokensPath
+		...options,
+		mode: options.mode
 	});
 	return { success: true };
 }

package/dist/executors/generate/schema.d.ts

@@ -20,10 +20,10 @@ export interface GenerateExecutorSchema {
  mode: string,
 
  /**
-  * The path to the registry.json file
+  * The path to a directory containing component directories or files
   * 
  */
- registryPath?: string,
+ componentsPath?: string,
 
  /**
   * The path to the tokens.json file

package/dist/executors/generate/schema.json

@@ -21,9 +21,9 @@
         "production"
       ]
     },
-    "registryPath": {
+    "componentsPath": {
       "type": "string",
-      "description": "The path to the registry.json file"
+      "description": "The path to a directory containing component directories or files"
     },
     "tokensPath": {
       "type": "string",

package/dist/generators/sync/generator.d.mts

@@ -0,0 +1,7 @@
+import { Tree } from "@nx/devkit";
+import { SyncGeneratorResult } from "nx/src/utils/sync-generators";
+//#region src/generators/sync/generator.d.ts
+declare function syncGenerator(tree: Tree): Promise<SyncGeneratorResult>;
+//#endregion
+export { syncGenerator as default, syncGenerator };
+//# sourceMappingURL=generator.d.mts.map

package/dist/generators/sync/generator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.mts","names":[],"sources":["../../../src/generators/sync/generator.ts"],"mappings":""}

package/dist/generators/sync/generator.d.ts

@@ -0,0 +1,7 @@
+import { Tree } from "@nx/devkit";
+import { SyncGeneratorResult } from "nx/src/utils/sync-generators";
+//#region src/generators/sync/generator.d.ts
+declare function syncGenerator(tree: Tree): Promise<SyncGeneratorResult>;
+//#endregion
+export { syncGenerator as default, syncGenerator };
+//# sourceMappingURL=generator.d.ts.map

package/dist/generators/sync/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","names":[],"sources":["../../../src/generators/sync/generator.ts"],"mappings":";;;iBA6HsB,cAAc,MAAM,OAAO,QAAQ"}

package/dist/generators/sync/generator.js

@@ -0,0 +1,121 @@
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+let _power_plant_core = require("@power-plant/core");
+let _razorwind_core = require("@razorwind/core");
+let _nx_devkit = require("@nx/devkit");
+let _power_plant_noop_output = require("@power-plant/noop-output");
+_power_plant_noop_output = __toESM(_power_plant_noop_output);
+let node_path = require("node:path");
+
+//#region src/generators/sync/generator.ts
+const GENERATOR_NAME = "@razorwind/nx:sync";
+const GENERATE_EXECUTOR = "@razorwind/nx:generate";
+const CONFIG_FILE_NAMES = [
+	"razorwind.config.ts",
+	"razorwind.config.js",
+	"razorwind.config.mts",
+	"razorwind.config.mjs"
+];
+const DEFAULT_OUT_OF_SYNC_MESSAGE = "Razorwind generated files are out of sync. Run `nx sync` to regenerate.";
+function resolveConfigFileToken(configFile, projectRoot) {
+	return configFile.replaceAll("{projectRoot}", projectRoot);
+}
+function findDefaultConfigFile(tree, projectRoot) {
+	return CONFIG_FILE_NAMES.map((name) => (0, _nx_devkit.joinPathFragments)(projectRoot, name)).find((path) => tree.exists(path));
+}
+function getDocumentContent(document) {
+	return (document.chunks ?? []).map((chunk) => chunk.content ?? "").join("");
+}
+function toWorkspaceRelativePath(tree, filePath) {
+	if ((0, node_path.isAbsolute)(filePath)) return (0, node_path.relative)(tree.root, filePath).split(/[/\\]/).join("/");
+	return filePath;
+}
+function writeDocumentIfChanged(tree, document) {
+	const path = toWorkspaceRelativePath(tree, document.path);
+	const content = getDocumentContent(document);
+	if (tree.exists(path) && tree.read(path, "utf-8") === content) return;
+	tree.write(path, content);
+	return path;
+}
+async function generateForProject(tree, options) {
+	const documents = await (0, _power_plant_core.execute)(_razorwind_core.generator, {
+		configFile: options.configFile,
+		mode: options.mode,
+		componentsPath: options.componentsPath,
+		tokensPath: options.tokensPath,
+		cwd: tree.root,
+		output: _power_plant_noop_output.default
+	});
+	const changed = [];
+	for (const document of Object.values(documents ?? {})) {
+		const path = writeDocumentIfChanged(tree, document);
+		if (path) changed.push(path);
+	}
+	return changed;
+}
+async function syncGenerator(tree) {
+	const generatorOptions = (0, _nx_devkit.readNxJson)(tree)?.sync?.generatorOptions?.[GENERATOR_NAME] ?? {};
+	const defaultMode = generatorOptions.mode ?? "production";
+	const outOfSyncMessage = generatorOptions.outOfSyncMessage ?? DEFAULT_OUT_OF_SYNC_MESSAGE;
+	const projectGraph = await (0, _nx_devkit.createProjectGraphAsync)();
+	const outOfSyncDetails = [];
+	const processedConfigFiles = /* @__PURE__ */ new Set();
+	for (const project of Object.values(projectGraph.nodes)) {
+		const projectRoot = project.data.root;
+		const generateTarget = project.data.targets?.generate;
+		let configFile;
+		let mode = defaultMode;
+		let componentsPath;
+		let tokensPath;
+		if (generateTarget?.executor === GENERATE_EXECUTOR) {
+			mode = generateTarget.configurations?.[generateTarget.defaultConfiguration ?? "production"]?.mode ?? generateTarget.options?.mode ?? defaultMode;
+			componentsPath = generateTarget.options?.componentsPath;
+			tokensPath = generateTarget.options?.tokensPath;
+			const configured = generateTarget.options?.configFile ? resolveConfigFileToken(generateTarget.options.configFile, projectRoot) : void 0;
+			configFile = configured && tree.exists(configured) ? configured : findDefaultConfigFile(tree, projectRoot);
+		} else configFile = findDefaultConfigFile(tree, projectRoot);
+		if (!configFile || processedConfigFiles.has(configFile)) continue;
+		processedConfigFiles.add(configFile);
+		const changed = await generateForProject(tree, {
+			configFile,
+			mode,
+			componentsPath,
+			tokensPath
+		});
+		outOfSyncDetails.push(...changed);
+	}
+	return {
+		outOfSyncMessage,
+		outOfSyncDetails
+	};
+}
+
+//#endregion
+exports.default = syncGenerator;
+exports.syncGenerator = syncGenerator;

package/dist/generators/sync/generator.mjs

@@ -0,0 +1,92 @@
+import { execute } from "@power-plant/core";
+import { generator } from "@razorwind/core";
+import { createProjectGraphAsync, joinPathFragments, readNxJson } from "@nx/devkit";
+import noop from "@power-plant/noop-output";
+import { isAbsolute, relative } from "node:path";
+
+//#region src/generators/sync/generator.ts
+const GENERATOR_NAME = "@razorwind/nx:sync";
+const GENERATE_EXECUTOR = "@razorwind/nx:generate";
+const CONFIG_FILE_NAMES = [
+	"razorwind.config.ts",
+	"razorwind.config.js",
+	"razorwind.config.mts",
+	"razorwind.config.mjs"
+];
+const DEFAULT_OUT_OF_SYNC_MESSAGE = "Razorwind generated files are out of sync. Run `nx sync` to regenerate.";
+function resolveConfigFileToken(configFile, projectRoot) {
+	return configFile.replaceAll("{projectRoot}", projectRoot);
+}
+function findDefaultConfigFile(tree, projectRoot) {
+	return CONFIG_FILE_NAMES.map((name) => joinPathFragments(projectRoot, name)).find((path) => tree.exists(path));
+}
+function getDocumentContent(document) {
+	return (document.chunks ?? []).map((chunk) => chunk.content ?? "").join("");
+}
+function toWorkspaceRelativePath(tree, filePath) {
+	if (isAbsolute(filePath)) return relative(tree.root, filePath).split(/[/\\]/).join("/");
+	return filePath;
+}
+function writeDocumentIfChanged(tree, document) {
+	const path = toWorkspaceRelativePath(tree, document.path);
+	const content = getDocumentContent(document);
+	if (tree.exists(path) && tree.read(path, "utf-8") === content) return;
+	tree.write(path, content);
+	return path;
+}
+async function generateForProject(tree, options) {
+	const documents = await execute(generator, {
+		configFile: options.configFile,
+		mode: options.mode,
+		componentsPath: options.componentsPath,
+		tokensPath: options.tokensPath,
+		cwd: tree.root,
+		output: noop
+	});
+	const changed = [];
+	for (const document of Object.values(documents ?? {})) {
+		const path = writeDocumentIfChanged(tree, document);
+		if (path) changed.push(path);
+	}
+	return changed;
+}
+async function syncGenerator(tree) {
+	const generatorOptions = readNxJson(tree)?.sync?.generatorOptions?.[GENERATOR_NAME] ?? {};
+	const defaultMode = generatorOptions.mode ?? "production";
+	const outOfSyncMessage = generatorOptions.outOfSyncMessage ?? DEFAULT_OUT_OF_SYNC_MESSAGE;
+	const projectGraph = await createProjectGraphAsync();
+	const outOfSyncDetails = [];
+	const processedConfigFiles = /* @__PURE__ */ new Set();
+	for (const project of Object.values(projectGraph.nodes)) {
+		const projectRoot = project.data.root;
+		const generateTarget = project.data.targets?.generate;
+		let configFile;
+		let mode = defaultMode;
+		let componentsPath;
+		let tokensPath;
+		if (generateTarget?.executor === GENERATE_EXECUTOR) {
+			mode = generateTarget.configurations?.[generateTarget.defaultConfiguration ?? "production"]?.mode ?? generateTarget.options?.mode ?? defaultMode;
+			componentsPath = generateTarget.options?.componentsPath;
+			tokensPath = generateTarget.options?.tokensPath;
+			const configured = generateTarget.options?.configFile ? resolveConfigFileToken(generateTarget.options.configFile, projectRoot) : void 0;
+			configFile = configured && tree.exists(configured) ? configured : findDefaultConfigFile(tree, projectRoot);
+		} else configFile = findDefaultConfigFile(tree, projectRoot);
+		if (!configFile || processedConfigFiles.has(configFile)) continue;
+		processedConfigFiles.add(configFile);
+		const changed = await generateForProject(tree, {
+			configFile,
+			mode,
+			componentsPath,
+			tokensPath
+		});
+		outOfSyncDetails.push(...changed);
+	}
+	return {
+		outOfSyncMessage,
+		outOfSyncDetails
+	};
+}
+
+//#endregion
+export { syncGenerator as default, syncGenerator };
+//# sourceMappingURL=generator.mjs.map

package/dist/generators/sync/generator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.mjs","names":[],"sources":[],"mappings":""}

package/dist/generators/sync/schema.d.ts

@@ -0,0 +1,26 @@
+
+// Generated by powerlines
+// Do not edit this file directly
+
+export interface SyncGeneratorSchema {
+ /**
+  * Mode
+  * 
+  * The mode to use when running Razorwind generate
+  * 
+  * @default "production"
+  * 
+  * @enum development,production
+ */
+ mode?: string,
+
+ /**
+  * Out of Sync Message
+  * 
+  * The message to display when Razorwind generated files are out of sync
+  * 
+  * @default "Razorwind generated files are out of sync. Run `nx sync` to regenerate."
+ */
+ outOfSyncMessage?: string,
+}
+

package/dist/generators/sync/schema.json

@@ -0,0 +1,31 @@
+{
+  "id": "#",
+  "title": "Sync Generator",
+  "description": "A type definition for the Razorwind - Sync generator's options",
+  "required": [],
+  "properties": {
+    "mode": {
+      "title": "Mode",
+      "type": "string",
+      "description": "The mode to use when running Razorwind generate",
+      "enum": [
+        "development",
+        "production"
+      ],
+      "id": "#mode",
+      "default": "production"
+    },
+    "outOfSyncMessage": {
+      "title": "Out of Sync Message",
+      "type": "string",
+      "description": "The message to display when Razorwind generated files are out of sync",
+      "id": "#outOfSyncMessage",
+      "default": "Razorwind generated files are out of sync. Run `nx sync` to regenerate."
+    }
+  },
+  "type": "object",
+  "default": {
+    "mode": "production",
+    "outOfSyncMessage": "Razorwind generated files are out of sync. Run `nx sync` to regenerate."
+  }
+}

package/docs/api/generate/schema.md

@@ -20,11 +20,11 @@ The path to the configuration file
 The mode to use
 
 
-## `registryPath`
+## `componentsPath`
 - **Type**: `string`
 
 
-The path to the registry.json file
+The path to a directory containing component directories or files
 
 
 ## `tokensPath`

package/docs/api/sync/schema.md

@@ -0,0 +1,26 @@
+
+<!-- Generated by powerlines -->
+<!-- Do not edit this file directly -->
+
+# Sync Generator
+
+## `mode`
+- **Type**: `string`
+- **Default**: `"production"`
+
+> Mode
+
+
+The mode to use when running Razorwind generate
+
+
+## `outOfSyncMessage`
+- **Type**: `string`
+- **Default**: `"Razorwind generated files are out of sync. Run `nx sync` to regenerate."`
+
+> Out of Sync Message
+
+
+The message to display when Razorwind generated files are out of sync
+
+

package/generators.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "generators": {
+    "sync": {
+      "factory": "./dist/generators/sync/generator",
+      "schema": "./dist/generators/sync/schema.json",
+      "description": "Synchronize Razorwind generated files across the workspace",
+      "alias": ["generate-sync"],
+      "hidden": true
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@razorwind/nx",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "A Nx plugin to support Razorwind development in Nx monorepos.",
   "repository": {
     "type": "github",
@@ -12,7 +12,9 @@
     "./package.json": "./package.json",
     "./docs/*": "./docs/*",
     "./executors.json": "./executors.json",
+    "./generators.json": "./generators.json",
     "./executors/*/schema.json": "./dist/executors/*/schema.json",
+    "./generators/*/schema.json": "./dist/generators/*/schema.json",
     ".": {
       "import": {
         "types": "./dist/index.d.mts",
@@ -57,6 +59,20 @@
         "default": "./dist/executors/*/untyped.js"
       }
     },
+    "./generators/*/untyped": {
+      "import": {
+        "types": "./dist/generators/*/untyped.d.mts",
+        "default": "./dist/generators/*/untyped.mjs"
+      },
+      "require": {
+        "types": "./dist/generators/*/untyped.d.ts",
+        "default": "./dist/generators/*/untyped.js"
+      },
+      "default": {
+        "types": "./dist/generators/*/untyped.d.ts",
+        "default": "./dist/generators/*/untyped.js"
+      }
+    },
     "./executors/*/executor": {
       "import": {
         "types": "./dist/executors/*/executor.d.mts",
@@ -71,16 +87,32 @@
         "default": "./dist/executors/*/executor.js"
       }
     },
+    "./generators/*/generator": {
+      "import": {
+        "types": "./dist/generators/*/generator.d.mts",
+        "default": "./dist/generators/*/generator.mjs"
+      },
+      "require": {
+        "types": "./dist/generators/*/generator.d.ts",
+        "default": "./dist/generators/*/generator.js"
+      },
+      "default": {
+        "types": "./dist/generators/*/generator.d.ts",
+        "default": "./dist/generators/*/generator.js"
+      }
+    },
     "./executors/*/executor.js": "./dist/executors/*/executor.js",
-    "./executors/*/executor.mjs": "./dist/executors/*/executor.mjs"
+    "./executors/*/executor.mjs": "./dist/executors/*/executor.mjs",
+    "./generators/*/generator.js": "./dist/generators/*/generator.js",
+    "./generators/*/generator.mjs": "./dist/generators/*/generator.mjs"
   },
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "typings": "dist/index.d.ts",
   "dependencies": {
     "@nx/devkit": "23.1.0",
-    "@power-plant/core": "^0.0.40",
-    "@razorwind/core": "^0.0.10",
+    "@power-plant/core": "^0.0.52",
+    "@razorwind/core": "^0.0.12",
     "@stryke/hash": "^0.13.52",
     "@stryke/path": "^0.29.25",
     "@stryke/string-format": "^0.17.40",
@@ -90,8 +122,8 @@
     "untyped": "^2.0.0"
   },
   "devDependencies": {
-    "@powerlines/plugin-tsdown": "^0.1.561",
-    "@powerlines/plugin-untyped": "^0.2.575",
+    "@powerlines/plugin-tsdown": "^0.1.571",
+    "@powerlines/plugin-untyped": "^0.2.585",
     "@types/node": "^25.9.5",
     "eslint-flat-config-utils": "^3.2.0",
     "jsonc-eslint-parser": "^3.1.0"
@@ -99,5 +131,6 @@
   "peerDependencies": { "nx": ">=23.0.0" },
   "publishConfig": { "access": "public" },
   "executors": "./executors.json",
-  "gitHead": "35f5d31c337fdedeb003c0d9eca72949d4305437"
+  "generators": "./generators.json",
+  "gitHead": "2c7a147ef95f662154e13be38137f629a71cff62"
 }