@webpieces/dev-config 0.2.27 → 0.2.29

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/dev-config",
-  "version": "0.2.27",
+  "version": "0.2.29",
   "description": "Development configuration, scripts, and patterns for WebPieces projects",
   "type": "commonjs",
   "bin": {
@@ -14,7 +14,7 @@
   "executors": "./executors.json",
   "generators": "./generators.json",
   "exports": {
-    ".": "./index.js",
+    ".": "./src/index.js",
     "./package.json": "./package.json",
     "./eslint": "./config/eslint/base.mjs",
     "./eslint-plugin": "./eslint-plugin/index.js",

package/plugin/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Re-export plugin from parent directory for clean imports
+ */
+export * from '../plugin';

package/plugin/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+/**
+ * Re-export plugin from parent directory for clean imports
+ */
+tslib_1.__exportStar(require("../plugin"), exports);
+//# sourceMappingURL=index.js.map

package/plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/tooling/dev-config/plugin/index.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,oDAA0B","sourcesContent":["/**\n * Re-export plugin from parent directory for clean imports\n */\nexport * from '../plugin';\n"]}

package/plugin.js

@@ -0,0 +1,260 @@
+"use strict";
+/**
+ * Unified Nx Inference Plugin for @webpieces/dev-config
+ *
+ * This plugin automatically creates targets for:
+ * 1. Workspace-level architecture validation (generate, visualize, validate-*)
+ * 2. Per-project circular dependency checking
+ *
+ * Install with: nx add @webpieces/dev-config
+ *
+ * Usage:
+ * Add to nx.json plugins array:
+ * {
+ *   "plugins": ["@webpieces/dev-config"]
+ * }
+ *
+ * Then all targets appear automatically without manual project.json configuration.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createNodesV2 = void 0;
+const path_1 = require("path");
+const fs_1 = require("fs");
+const DEFAULT_OPTIONS = {
+    circularDeps: {
+        enabled: true,
+        targetName: 'check-circular-deps',
+        excludePatterns: [],
+    },
+    workspace: {
+        enabled: true,
+        targetPrefix: 'arch:',
+        graphPath: 'architecture/dependencies.json',
+        validations: {
+            noCycles: true,
+            noSkipLevelDeps: true,
+            architectureUnchanged: true,
+        },
+        features: {
+            generate: true,
+            visualize: true,
+        },
+    },
+};
+function normalizeOptions(options) {
+    const circularDeps = {
+        ...DEFAULT_OPTIONS.circularDeps,
+        ...options?.circularDeps,
+    };
+    const workspace = {
+        ...DEFAULT_OPTIONS.workspace,
+        ...options?.workspace,
+        validations: {
+            ...DEFAULT_OPTIONS.workspace.validations,
+            ...options?.workspace?.validations,
+        },
+        features: {
+            ...DEFAULT_OPTIONS.workspace.features,
+            ...options?.workspace?.features,
+        },
+    };
+    return {
+        circularDeps,
+        workspace,
+    };
+}
+/**
+ * Nx V2 Inference Plugin
+ * Matches project.json files and creates architecture + circular-deps targets
+ */
+exports.createNodesV2 = [
+    // Pattern to match: look for project.json files
+    '**/project.json',
+    // Inference function
+    async (projectFiles, options, context) => {
+        const opts = normalizeOptions(options);
+        const results = [];
+        // Phase 1: Add workspace-level architecture targets to root
+        if (opts.workspace.enabled) {
+            const rootProject = projectFiles.find((f) => (0, path_1.dirname)(f) === '.');
+            if (rootProject) {
+                const workspaceTargets = createWorkspaceTargets(opts);
+                if (Object.keys(workspaceTargets).length > 0) {
+                    const result = {
+                        projects: {
+                            '.': {
+                                targets: workspaceTargets,
+                            },
+                        },
+                    };
+                    results.push([rootProject, result]);
+                }
+            }
+        }
+        // Phase 2: Add per-project circular-deps targets
+        if (opts.circularDeps.enabled) {
+            for (const projectFile of projectFiles) {
+                const projectRoot = (0, path_1.dirname)(projectFile);
+                // Skip workspace root (already handled)
+                if (projectRoot === '.')
+                    continue;
+                // Check exclude patterns
+                if (isExcluded(projectRoot, opts.circularDeps.excludePatterns)) {
+                    continue;
+                }
+                // Only create target if project has a src/ directory
+                const srcDir = (0, path_1.join)(context.workspaceRoot, projectRoot, 'src');
+                if ((0, fs_1.existsSync)(srcDir)) {
+                    const targetName = opts.circularDeps.targetName;
+                    const checkCircularDepsTarget = createCircularDepsTarget(projectRoot, targetName);
+                    const result = {
+                        projects: {
+                            [projectRoot]: {
+                                targets: {
+                                    [targetName]: checkCircularDepsTarget,
+                                },
+                            },
+                        },
+                    };
+                    results.push([projectFile, result]);
+                }
+            }
+        }
+        return results;
+    },
+];
+/**
+ * Create workspace-level architecture validation targets
+ */
+function createWorkspaceTargets(opts) {
+    const targets = {};
+    const prefix = opts.workspace.targetPrefix;
+    const graphPath = opts.workspace.graphPath;
+    // Add help target (always available)
+    targets[`${prefix}help`] = createHelpTarget();
+    if (opts.workspace.features.generate) {
+        targets[`${prefix}generate`] = createGenerateTarget(graphPath);
+    }
+    if (opts.workspace.features.visualize) {
+        targets[`${prefix}visualize`] = createVisualizeTarget(prefix, graphPath);
+    }
+    if (opts.workspace.validations.noCycles) {
+        targets[`${prefix}validate-no-cycles`] = createValidateNoCyclesTarget();
+    }
+    if (opts.workspace.validations.architectureUnchanged) {
+        targets[`${prefix}validate-architecture-unchanged`] = createValidateUnchangedTarget(graphPath);
+    }
+    if (opts.workspace.validations.noSkipLevelDeps) {
+        targets[`${prefix}validate-no-skiplevel-deps`] = createValidateNoSkipLevelTarget();
+    }
+    return targets;
+}
+function createGenerateTarget(graphPath) {
+    return {
+        executor: '@webpieces/dev-config:generate',
+        cache: true,
+        inputs: ['default'],
+        outputs: ['{workspaceRoot}/architecture/dependencies.json'],
+        options: { graphPath },
+        metadata: {
+            technologies: ['nx'],
+            description: 'Generate the architecture dependency graph from project.json files',
+        },
+    };
+}
+function createVisualizeTarget(prefix, graphPath) {
+    return {
+        executor: '@webpieces/dev-config:visualize',
+        dependsOn: [`${prefix}generate`],
+        options: { graphPath },
+        metadata: {
+            technologies: ['nx'],
+            description: 'Generate visual representations of the architecture graph',
+        },
+    };
+}
+function createValidateNoCyclesTarget() {
+    return {
+        executor: '@webpieces/dev-config:validate-no-cycles',
+        cache: true,
+        inputs: ['default'],
+        metadata: {
+            technologies: ['nx'],
+            description: 'Validate the architecture has no circular dependencies',
+        },
+    };
+}
+function createValidateUnchangedTarget(graphPath) {
+    return {
+        executor: '@webpieces/dev-config:validate-architecture-unchanged',
+        cache: true,
+        inputs: ['default', '{workspaceRoot}/architecture/dependencies.json'],
+        options: { graphPath },
+        metadata: {
+            technologies: ['nx'],
+            description: 'Validate the architecture matches the saved blessed graph',
+        },
+    };
+}
+function createValidateNoSkipLevelTarget() {
+    return {
+        executor: '@webpieces/dev-config:validate-no-skiplevel-deps',
+        cache: true,
+        inputs: ['default'],
+        metadata: {
+            technologies: ['nx'],
+            description: 'Validate no project has redundant transitive dependencies',
+        },
+    };
+}
+function createHelpTarget() {
+    return {
+        executor: '@webpieces/dev-config:help',
+        cache: true,
+        metadata: {
+            technologies: ['nx'],
+            description: 'Display help for @webpieces/dev-config commands and targets',
+        },
+    };
+}
+/**
+ * Create per-project circular dependency checking target
+ */
+function createCircularDepsTarget(projectRoot, targetName) {
+    return {
+        executor: 'nx:run-commands',
+        cache: true,
+        inputs: ['default'],
+        outputs: [],
+        options: {
+            command: 'npx madge --circular --extensions ts,tsx src',
+            cwd: projectRoot,
+        },
+        metadata: {
+            technologies: ['madge'],
+            description: 'Check for circular dependencies using madge',
+        },
+    };
+}
+/**
+ * Check if a project should be excluded based on patterns
+ */
+function isExcluded(projectRoot, excludePatterns) {
+    if (excludePatterns.length === 0) {
+        return false;
+    }
+    // Simple glob matching (could be enhanced with minimatch if needed)
+    return excludePatterns.some((pattern) => {
+        // Convert glob pattern to regex
+        const regexPattern = pattern
+            .replace(/\*\*/g, '.*') // ** matches any path
+            .replace(/\*/g, '[^/]*'); // * matches any string except /
+        const regex = new RegExp(`^${regexPattern}$`);
+        return regex.test(projectRoot);
+    });
+}
+/**
+ * Export plugin as default for Nx
+ */
+exports.default = { createNodesV2: exports.createNodesV2 };
+//# sourceMappingURL=plugin.js.map

package/src/index.d.ts

@@ -4,6 +4,7 @@
  * Development configuration, scripts, and patterns for WebPieces projects.
  *
  * This package provides:
+ * - Nx inference plugin for architecture validation and circular dependency checking
  * - Executable scripts (via bin commands: wp-start, wp-stop, etc.)
  * - Shareable ESLint configuration
  * - Jest preset
@@ -12,15 +13,6 @@
  *
  * @packageDocumentation
  */
-/**
- * This is primarily a configuration and scripts package.
- * The actual exports are defined in package.json:
- *
- * - bin: Executable scripts (wp-start, wp-stop, etc.)
- * - exports: Configuration files (eslint, jest, tsconfig)
- *
- * See README.md for usage instructions.
- */
 export declare const version = "0.0.0-dev";
 export declare const packageName = "@webpieces/dev-config";
 /**
@@ -31,3 +23,12 @@ export declare function isWebpiecesWorkspace(): boolean;
  * Get project root directory
  */
 export declare function getProjectRoot(): string;
+/**
+ * Default export for Nx plugin system
+ * This is what Nx loads when the package is registered as a plugin in nx.json
+ */
+declare const _default: {
+    name: string;
+    createNodesV2: import("@nx/devkit").CreateNodesV2<import("../plugin").ArchitecturePluginOptions>;
+};
+export default _default;

package/src/index.js

@@ -5,6 +5,7 @@
  * Development configuration, scripts, and patterns for WebPieces projects.
  *
  * This package provides:
+ * - Nx inference plugin for architecture validation and circular dependency checking
  * - Executable scripts (via bin commands: wp-start, wp-stop, etc.)
  * - Shareable ESLint configuration
  * - Jest preset
@@ -17,15 +18,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.packageName = exports.version = void 0;
 exports.isWebpiecesWorkspace = isWebpiecesWorkspace;
 exports.getProjectRoot = getProjectRoot;
-/**
- * This is primarily a configuration and scripts package.
- * The actual exports are defined in package.json:
- *
- * - bin: Executable scripts (wp-start, wp-stop, etc.)
- * - exports: Configuration files (eslint, jest, tsconfig)
- *
- * See README.md for usage instructions.
- */
+const plugin_1 = require("../plugin");
 exports.version = '0.0.0-dev';
 exports.packageName = '@webpieces/dev-config';
 /**
@@ -41,4 +34,12 @@ function getProjectRoot() {
     // This is a simple helper, actual path detection is in bash scripts
     return process.cwd();
 }
+/**
+ * Default export for Nx plugin system
+ * This is what Nx loads when the package is registered as a plugin in nx.json
+ */
+exports.default = {
+    name: '@webpieces/dev-config',
+    createNodesV2: plugin_1.createNodesV2,
+};
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/tooling/dev-config/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAkBH,oDAEC;AAKD,wCAGC;AA1BD;;;;;;;;GAQG;AAEU,QAAA,OAAO,GAAG,WAAW,CAAC;AACtB,QAAA,WAAW,GAAG,uBAAuB,CAAC;AAEnD;;GAEG;AACH,SAAgB,oBAAoB;IAChC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc;IAC1B,oEAAoE;IACpE,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;AACzB,CAAC","sourcesContent":["/**\n * @webpieces/dev-config\n *\n * Development configuration, scripts, and patterns for WebPieces projects.\n *\n * This package provides:\n * - Executable scripts (via bin commands: wp-start, wp-stop, etc.)\n * - Shareable ESLint configuration\n * - Jest preset\n * - Base TypeScript configuration\n * - Claude Code pattern documentation\n *\n * @packageDocumentation\n */\n\n/**\n * This is primarily a configuration and scripts package.\n * The actual exports are defined in package.json:\n *\n * - bin: Executable scripts (wp-start, wp-stop, etc.)\n * - exports: Configuration files (eslint, jest, tsconfig)\n *\n * See README.md for usage instructions.\n */\n\nexport const version = '0.0.0-dev';\nexport const packageName = '@webpieces/dev-config';\n\n/**\n * Check if running in webpieces-ts workspace\n */\nexport function isWebpiecesWorkspace(): boolean {\n    return process.cwd().includes('webpieces-ts');\n}\n\n/**\n * Get project root directory\n */\nexport function getProjectRoot(): string {\n    // This is a simple helper, actual path detection is in bash scripts\n    return process.cwd();\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/tooling/dev-config/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAUH,oDAEC;AAKD,wCAGC;AAlBD,sCAA0C;AAE7B,QAAA,OAAO,GAAG,WAAW,CAAC;AACtB,QAAA,WAAW,GAAG,uBAAuB,CAAC;AAEnD;;GAEG;AACH,SAAgB,oBAAoB;IAChC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc;IAC1B,oEAAoE;IACpE,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,kBAAe;IACX,IAAI,EAAE,uBAAuB;IAC7B,aAAa,EAAb,sBAAa;CAChB,CAAC","sourcesContent":["/**\n * @webpieces/dev-config\n *\n * Development configuration, scripts, and patterns for WebPieces projects.\n *\n * This package provides:\n * - Nx inference plugin for architecture validation and circular dependency checking\n * - Executable scripts (via bin commands: wp-start, wp-stop, etc.)\n * - Shareable ESLint configuration\n * - Jest preset\n * - Base TypeScript configuration\n * - Claude Code pattern documentation\n *\n * @packageDocumentation\n */\n\nimport { createNodesV2 } from '../plugin';\n\nexport const version = '0.0.0-dev';\nexport const packageName = '@webpieces/dev-config';\n\n/**\n * Check if running in webpieces-ts workspace\n */\nexport function isWebpiecesWorkspace(): boolean {\n    return process.cwd().includes('webpieces-ts');\n}\n\n/**\n * Get project root directory\n */\nexport function getProjectRoot(): string {\n    // This is a simple helper, actual path detection is in bash scripts\n    return process.cwd();\n}\n\n/**\n * Default export for Nx plugin system\n * This is what Nx loads when the package is registered as a plugin in nx.json\n */\nexport default {\n    name: '@webpieces/dev-config',\n    createNodesV2,\n};\n"]}