@webpieces/dev-config 0.2.24 → 0.2.26

package/executors.json

@@ -24,6 +24,16 @@
             "implementation": "./architecture/executors/validate-no-skiplevel-deps/executor",
             "schema": "./architecture/executors/validate-no-skiplevel-deps/schema.json",
             "description": "Validate no project has redundant transitive dependencies"
+        },
+        "help": {
+            "implementation": "./executors/help/executor",
+            "schema": "./executors/help/schema.json",
+            "description": "Display help for @webpieces/dev-config commands and targets"
+        },
+        "validate-eslint-sync": {
+            "implementation": "./executors/validate-eslint-sync/executor",
+            "schema": "./executors/validate-eslint-sync/schema.json",
+            "description": "Validate that workspace and template eslint.webpieces.config.mjs files have identical rules"
         }
     }
 }

package/generators.json

@@ -2,8 +2,8 @@
     "$schema": "http://json-schema.org/schema",
     "generators": {
         "init": {
-            "factory": "./generators/init/generator",
-            "schema": "./generators/init/schema.json",
+            "factory": "./src/generators/init/generator",
+            "schema": "./src/generators/init/schema.json",
             "description": "Initialize @webpieces/dev-config in an Nx workspace"
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/dev-config",
-  "version": "0.2.24",
+  "version": "0.2.26",
   "description": "Development configuration, scripts, and patterns for WebPieces projects",
   "type": "commonjs",
   "bin": {
@@ -34,7 +34,8 @@
     "plugins/**/*",
     "plugin/**/*",
     "plugin.js",
-    "generators/**/*",
+    "templates/**/*",
+    "src/**/*",
     "generators.json",
     "architecture/**/*",
     "executors.json",

package/src/generators/init/generator.d.ts

@@ -0,0 +1,20 @@
+import { Tree } from '@nx/devkit';
+export interface InitGeneratorSchema {
+    skipFormat?: boolean;
+}
+/**
+ * Init generator for @webpieces/dev-config
+ *
+ * Automatically runs when users execute: nx add @webpieces/dev-config
+ *
+ * Responsibilities:
+ * - Registers the plugin in nx.json
+ * - Creates architecture/ directory if needed
+ * - Adds madge as a devDependency (required for circular dep checking)
+ * - Adds convenient npm scripts to package.json
+ * - Always creates eslint.webpieces.config.mjs with @webpieces rules
+ * - Creates eslint.config.mjs (if not exists) that imports eslint.webpieces.config.mjs
+ * - If eslint.config.mjs exists, shows user how to import eslint.webpieces.config.mjs
+ * - Provides helpful output about available targets
+ */
+export default function initGenerator(tree: Tree, options: InitGeneratorSchema): Promise<() => Promise<void>>;

package/src/generators/init/generator.js

@@ -0,0 +1,195 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = initGenerator;
+const devkit_1 = require("@nx/devkit");
+const crypto_1 = require("crypto");
+function calculateHash(content) {
+    return (0, crypto_1.createHash)('sha256').update(content).digest('hex');
+}
+function getPackageVersion(tree) {
+    const content = tree.read('node_modules/@webpieces/dev-config/package.json', 'utf-8');
+    if (!content) {
+        throw new Error('Could not read package.json from node_modules/@webpieces/dev-config');
+    }
+    const pkgJson = JSON.parse(content);
+    return pkgJson.version;
+}
+/**
+ * Init generator for @webpieces/dev-config
+ *
+ * Automatically runs when users execute: nx add @webpieces/dev-config
+ *
+ * Responsibilities:
+ * - Registers the plugin in nx.json
+ * - Creates architecture/ directory if needed
+ * - Adds madge as a devDependency (required for circular dep checking)
+ * - Adds convenient npm scripts to package.json
+ * - Always creates eslint.webpieces.config.mjs with @webpieces rules
+ * - Creates eslint.config.mjs (if not exists) that imports eslint.webpieces.config.mjs
+ * - If eslint.config.mjs exists, shows user how to import eslint.webpieces.config.mjs
+ * - Provides helpful output about available targets
+ */
+async function initGenerator(tree, options) {
+    registerPlugin(tree);
+    const installTask = addMadgeDependency(tree);
+    createArchitectureDirectory(tree);
+    addNpmScripts(tree);
+    createEslintConfig(tree);
+    if (!options.skipFormat) {
+        await (0, devkit_1.formatFiles)(tree);
+    }
+    return createSuccessCallback(installTask);
+}
+function registerPlugin(tree) {
+    const nxJson = (0, devkit_1.readNxJson)(tree);
+    if (!nxJson) {
+        throw new Error('Could not read nx.json. Are you in an Nx workspace?');
+    }
+    if (!nxJson.plugins) {
+        nxJson.plugins = [];
+    }
+    const pluginName = '@webpieces/dev-config';
+    const alreadyRegistered = nxJson.plugins.some((p) => typeof p === 'string' ? p === pluginName : p.plugin === pluginName);
+    if (!alreadyRegistered) {
+        nxJson.plugins.push(pluginName);
+        (0, devkit_1.updateNxJson)(tree, nxJson);
+        console.log(`✅ Registered ${pluginName} plugin in nx.json`);
+    }
+    else {
+        console.log(`ℹ️  ${pluginName} plugin is already registered`);
+    }
+}
+function addMadgeDependency(tree) {
+    return (0, devkit_1.addDependenciesToPackageJson)(tree, {}, { 'madge': '^8.0.0' });
+}
+function createArchitectureDirectory(tree) {
+    if (!tree.exists('architecture')) {
+        tree.write('architecture/.gitkeep', '');
+        console.log('✅ Created architecture/ directory');
+    }
+}
+function addNpmScripts(tree) {
+    (0, devkit_1.updateJson)(tree, 'package.json', (pkgJson) => {
+        pkgJson.scripts = pkgJson.scripts ?? {};
+        // Add architecture validation scripts
+        pkgJson.scripts['arch:generate'] = 'nx run .:arch:generate';
+        pkgJson.scripts['arch:visualize'] = 'nx run .:arch:visualize';
+        pkgJson.scripts['arch:validate'] = 'nx run .:arch:validate-no-cycles && nx run .:arch:validate-no-skiplevel-deps';
+        pkgJson.scripts['arch:validate-all'] = 'nx run .:arch:validate-no-cycles && nx run .:arch:validate-no-skiplevel-deps && nx run .:arch:validate-architecture-unchanged';
+        // Add circular dependency checking scripts
+        pkgJson.scripts['arch:check-circular'] = 'nx run-many --target=check-circular-deps --all';
+        pkgJson.scripts['arch:check-circular-affected'] = 'nx affected --target=check-circular-deps';
+        // Complete validation including circular deps
+        pkgJson.scripts['arch:validate-complete'] = 'npm run arch:validate-all && npm run arch:check-circular';
+        return pkgJson;
+    });
+    console.log('✅ Added npm scripts for architecture validation and circular dependency checking');
+}
+function createEslintConfig(tree) {
+    const webpiecesConfigPath = 'eslint.webpieces.config.mjs';
+    const mainConfigPath = 'eslint.config.mjs';
+    // Always create eslint.webpieces.config.mjs with our rules
+    createWebpiecesEslintConfig(tree, webpiecesConfigPath);
+    // Check if main eslint.config.mjs exists
+    if (tree.exists(mainConfigPath)) {
+        // Existing config - show them how to import
+        console.log('');
+        console.log('📋 Existing eslint.config.mjs detected');
+        console.log('');
+        console.log('To use @webpieces/dev-config ESLint rules, add this import to your eslint.config.mjs:');
+        console.log('');
+        console.log('  import webpiecesConfig from \'./eslint.webpieces.config.mjs\';');
+        console.log('');
+        console.log('Then spread it into your config array:');
+        console.log('');
+        console.log('  export default [');
+        console.log('    ...webpiecesConfig,  // Add this line');
+        console.log('    // ... your existing config');
+        console.log('  ];');
+        console.log('');
+    }
+    else {
+        // No existing config - create one that imports webpieces config
+        const mainConfig = `// ESLint configuration
+// Imports @webpieces/dev-config rules
+
+import webpiecesConfig from './eslint.webpieces.config.mjs';
+
+// Export the webpieces configuration
+// You can add your own rules after spreading webpiecesConfig
+export default [
+    ...webpiecesConfig,
+    // Add your custom ESLint configuration here
+];
+`;
+        tree.write(mainConfigPath, mainConfig);
+        console.log('✅ Created eslint.config.mjs with @webpieces/dev-config rules');
+    }
+}
+function getWebpiecesEslintConfigTemplate(tree) {
+    // Read from canonical template file (single source of truth)
+    const templatePath = 'node_modules/@webpieces/dev-config/templates/eslint.webpieces.config.mjs';
+    const template = tree.read(templatePath, 'utf-8');
+    if (!template) {
+        throw new Error(`Could not read ESLint template from ${templatePath}`);
+    }
+    return template;
+}
+function warnConfigChanges(tree, configPath, newConfig) {
+    const version = getPackageVersion(tree);
+    const versionedFilename = `${configPath}.v${version}`;
+    tree.write(versionedFilename, newConfig);
+    console.log('');
+    console.log(`⚠️  ${configPath} has changes`);
+    console.log('');
+    console.log('   Either you modified the file OR @webpieces/dev-config has updates.');
+    console.log('');
+    console.log(`   Created: ${versionedFilename} with latest version`);
+    console.log('');
+    console.log('   Please review and merge if needed:');
+    console.log(`     - Your current: ${configPath}`);
+    console.log(`     - New version:  ${versionedFilename}`);
+    console.log('');
+}
+function createWebpiecesEslintConfig(tree, configPath) {
+    const webpiecesConfig = getWebpiecesEslintConfigTemplate(tree);
+    if (!tree.exists(configPath)) {
+        tree.write(configPath, webpiecesConfig);
+        console.log(`✅ Created ${configPath}`);
+        return;
+    }
+    const currentContent = tree.read(configPath, 'utf-8');
+    if (!currentContent) {
+        tree.write(configPath, webpiecesConfig);
+        console.log(`✅ Created ${configPath}`);
+        return;
+    }
+    const currentHash = calculateHash(currentContent);
+    const newHash = calculateHash(webpiecesConfig);
+    if (currentHash === newHash) {
+        console.log(`✅ ${configPath} is up to date`);
+        return;
+    }
+    warnConfigChanges(tree, configPath, webpiecesConfig);
+}
+function createSuccessCallback(installTask) {
+    return async () => {
+        await installTask();
+        // ANSI color codes for formatted output
+        const GREEN = '\x1b[32m\x1b[1m';
+        const BOLD = '\x1b[1m';
+        const RESET = '\x1b[0m';
+        console.log('');
+        console.log('✅ Added madge to devDependencies');
+        console.log('');
+        console.log(`${GREEN}✅ @webpieces/dev-config plugin initialized!${RESET}`);
+        console.log('');
+        console.log(`${GREEN}💡 Quick start:${RESET}`);
+        console.log(`   ${BOLD}npm run arch:generate${RESET}           # Generate the dependency graph`);
+        console.log(`   ${BOLD}npm run arch:validate-complete${RESET}  # Run complete validation`);
+        console.log('');
+        console.log(`💡 For full documentation, run: ${BOLD}nx run .:webpieces:help${RESET}`);
+        console.log('');
+    };
+}
+//# sourceMappingURL=generator.js.map

package/src/generators/init/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/dev-config/src/generators/init/generator.ts"],"names":[],"mappings":"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","sourcesContent":["import { formatFiles, readNxJson, Tree, updateNxJson, updateJson, addDependenciesToPackageJson } from '@nx/devkit';\nimport { createHash } from 'crypto';\n\nexport interface InitGeneratorSchema {\n    skipFormat?: boolean;\n}\n\nfunction calculateHash(content: string): string {\n    return createHash('sha256').update(content).digest('hex');\n}\n\nfunction getPackageVersion(tree: Tree): string {\n    const content = tree.read('node_modules/@webpieces/dev-config/package.json', 'utf-8');\n    if (!content) {\n        throw new Error('Could not read package.json from node_modules/@webpieces/dev-config');\n    }\n    const pkgJson = JSON.parse(content);\n    return pkgJson.version;\n}\n\n/**\n * Init generator for @webpieces/dev-config\n *\n * Automatically runs when users execute: nx add @webpieces/dev-config\n *\n * Responsibilities:\n * - Registers the plugin in nx.json\n * - Creates architecture/ directory if needed\n * - Adds madge as a devDependency (required for circular dep checking)\n * - Adds convenient npm scripts to package.json\n * - Always creates eslint.webpieces.config.mjs with @webpieces rules\n * - Creates eslint.config.mjs (if not exists) that imports eslint.webpieces.config.mjs\n * - If eslint.config.mjs exists, shows user how to import eslint.webpieces.config.mjs\n * - Provides helpful output about available targets\n */\nexport default async function initGenerator(tree: Tree, options: InitGeneratorSchema) {\n    registerPlugin(tree);\n    const installTask = addMadgeDependency(tree);\n    createArchitectureDirectory(tree);\n    addNpmScripts(tree);\n    createEslintConfig(tree);\n\n    if (!options.skipFormat) {\n        await formatFiles(tree);\n    }\n\n    return createSuccessCallback(installTask);\n}\n\nfunction registerPlugin(tree: Tree): void {\n    const nxJson = readNxJson(tree);\n    if (!nxJson) {\n        throw new Error('Could not read nx.json. Are you in an Nx workspace?');\n    }\n\n    if (!nxJson.plugins) {\n        nxJson.plugins = [];\n    }\n\n    const pluginName = '@webpieces/dev-config';\n    const alreadyRegistered = nxJson.plugins.some(\n        (p) => typeof p === 'string' ? p === pluginName : p.plugin === pluginName\n    );\n\n    if (!alreadyRegistered) {\n        nxJson.plugins.push(pluginName);\n        updateNxJson(tree, nxJson);\n        console.log(`✅ Registered ${pluginName} plugin in nx.json`);\n    } else {\n        console.log(`ℹ️  ${pluginName} plugin is already registered`);\n    }\n}\n\nfunction addMadgeDependency(tree: Tree) {\n    return addDependenciesToPackageJson(tree, {}, { 'madge': '^8.0.0' });\n}\n\nfunction createArchitectureDirectory(tree: Tree): void {\n    if (!tree.exists('architecture')) {\n        tree.write('architecture/.gitkeep', '');\n        console.log('✅ Created architecture/ directory');\n    }\n}\n\nfunction addNpmScripts(tree: Tree): void {\n    updateJson(tree, 'package.json', (pkgJson) => {\n        pkgJson.scripts = pkgJson.scripts ?? {};\n\n        // Add architecture validation scripts\n        pkgJson.scripts['arch:generate'] = 'nx run .:arch:generate';\n        pkgJson.scripts['arch:visualize'] = 'nx run .:arch:visualize';\n        pkgJson.scripts['arch:validate'] = 'nx run .:arch:validate-no-cycles && nx run .:arch:validate-no-skiplevel-deps';\n        pkgJson.scripts['arch:validate-all'] = 'nx run .:arch:validate-no-cycles && nx run .:arch:validate-no-skiplevel-deps && nx run .:arch:validate-architecture-unchanged';\n\n        // Add circular dependency checking scripts\n        pkgJson.scripts['arch:check-circular'] = 'nx run-many --target=check-circular-deps --all';\n        pkgJson.scripts['arch:check-circular-affected'] = 'nx affected --target=check-circular-deps';\n\n        // Complete validation including circular deps\n        pkgJson.scripts['arch:validate-complete'] = 'npm run arch:validate-all && npm run arch:check-circular';\n\n        return pkgJson;\n    });\n\n    console.log('✅ Added npm scripts for architecture validation and circular dependency checking');\n}\n\nfunction createEslintConfig(tree: Tree): void {\n    const webpiecesConfigPath = 'eslint.webpieces.config.mjs';\n    const mainConfigPath = 'eslint.config.mjs';\n\n    // Always create eslint.webpieces.config.mjs with our rules\n    createWebpiecesEslintConfig(tree, webpiecesConfigPath);\n\n    // Check if main eslint.config.mjs exists\n    if (tree.exists(mainConfigPath)) {\n        // Existing config - show them how to import\n        console.log('');\n        console.log('📋 Existing eslint.config.mjs detected');\n        console.log('');\n        console.log('To use @webpieces/dev-config ESLint rules, add this import to your eslint.config.mjs:');\n        console.log('');\n        console.log('  import webpiecesConfig from \\'./eslint.webpieces.config.mjs\\';');\n        console.log('');\n        console.log('Then spread it into your config array:');\n        console.log('');\n        console.log('  export default [');\n        console.log('    ...webpiecesConfig,  // Add this line');\n        console.log('    // ... your existing config');\n        console.log('  ];');\n        console.log('');\n    } else {\n        // No existing config - create one that imports webpieces config\n        const mainConfig = `// ESLint configuration\n// Imports @webpieces/dev-config rules\n\nimport webpiecesConfig from './eslint.webpieces.config.mjs';\n\n// Export the webpieces configuration\n// You can add your own rules after spreading webpiecesConfig\nexport default [\n    ...webpiecesConfig,\n    // Add your custom ESLint configuration here\n];\n`;\n\n        tree.write(mainConfigPath, mainConfig);\n        console.log('✅ Created eslint.config.mjs with @webpieces/dev-config rules');\n    }\n}\n\nfunction getWebpiecesEslintConfigTemplate(tree: Tree): string {\n    // Read from canonical template file (single source of truth)\n    const templatePath = 'node_modules/@webpieces/dev-config/templates/eslint.webpieces.config.mjs';\n    const template = tree.read(templatePath, 'utf-8');\n\n    if (!template) {\n        throw new Error(`Could not read ESLint template from ${templatePath}`);\n    }\n\n    return template;\n}\n\nfunction warnConfigChanges(tree: Tree, configPath: string, newConfig: string): void {\n    const version = getPackageVersion(tree);\n    const versionedFilename = `${configPath}.v${version}`;\n\n    tree.write(versionedFilename, newConfig);\n\n    console.log('');\n    console.log(`⚠️  ${configPath} has changes`);\n    console.log('');\n    console.log('   Either you modified the file OR @webpieces/dev-config has updates.');\n    console.log('');\n    console.log(`   Created: ${versionedFilename} with latest version`);\n    console.log('');\n    console.log('   Please review and merge if needed:');\n    console.log(`     - Your current: ${configPath}`);\n    console.log(`     - New version:  ${versionedFilename}`);\n    console.log('');\n}\n\nfunction createWebpiecesEslintConfig(tree: Tree, configPath: string): void {\n    const webpiecesConfig = getWebpiecesEslintConfigTemplate(tree);\n\n    if (!tree.exists(configPath)) {\n        tree.write(configPath, webpiecesConfig);\n        console.log(`✅ Created ${configPath}`);\n        return;\n    }\n\n    const currentContent = tree.read(configPath, 'utf-8');\n    if (!currentContent) {\n        tree.write(configPath, webpiecesConfig);\n        console.log(`✅ Created ${configPath}`);\n        return;\n    }\n\n    const currentHash = calculateHash(currentContent);\n    const newHash = calculateHash(webpiecesConfig);\n\n    if (currentHash === newHash) {\n        console.log(`✅ ${configPath} is up to date`);\n        return;\n    }\n\n    warnConfigChanges(tree, configPath, webpiecesConfig);\n}\n\nfunction createSuccessCallback(installTask: ReturnType<typeof addDependenciesToPackageJson>) {\n    return async () => {\n        await installTask();\n\n        // ANSI color codes for formatted output\n        const GREEN = '\\x1b[32m\\x1b[1m';\n        const BOLD = '\\x1b[1m';\n        const RESET = '\\x1b[0m';\n\n        console.log('');\n        console.log('✅ Added madge to devDependencies');\n        console.log('');\n        console.log(`${GREEN}✅ @webpieces/dev-config plugin initialized!${RESET}`);\n        console.log('');\n        console.log(`${GREEN}💡 Quick start:${RESET}`);\n        console.log(`   ${BOLD}npm run arch:generate${RESET}           # Generate the dependency graph`);\n        console.log(`   ${BOLD}npm run arch:validate-complete${RESET}  # Run complete validation`);\n        console.log('');\n        console.log(`💡 For full documentation, run: ${BOLD}nx run .:webpieces:help${RESET}`);\n        console.log('');\n    };\n}\n"]}

package/src/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @webpieces/dev-config
+ *
+ * Development configuration, scripts, and patterns for WebPieces projects.
+ *
+ * This package provides:
+ * - Executable scripts (via bin commands: wp-start, wp-stop, etc.)
+ * - Shareable ESLint configuration
+ * - Jest preset
+ * - Base TypeScript configuration
+ * - Claude Code pattern documentation
+ *
+ * @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";
+/**
+ * Check if running in webpieces-ts workspace
+ */
+export declare function isWebpiecesWorkspace(): boolean;
+/**
+ * Get project root directory
+ */
+export declare function getProjectRoot(): string;

package/src/index.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * @webpieces/dev-config
+ *
+ * Development configuration, scripts, and patterns for WebPieces projects.
+ *
+ * This package provides:
+ * - Executable scripts (via bin commands: wp-start, wp-stop, etc.)
+ * - Shareable ESLint configuration
+ * - Jest preset
+ * - Base TypeScript configuration
+ * - Claude Code pattern documentation
+ *
+ * @packageDocumentation
+ */
+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.
+ */
+exports.version = '0.0.0-dev';
+exports.packageName = '@webpieces/dev-config';
+/**
+ * Check if running in webpieces-ts workspace
+ */
+function isWebpiecesWorkspace() {
+    return process.cwd().includes('webpieces-ts');
+}
+/**
+ * Get project root directory
+ */
+function getProjectRoot() {
+    // This is a simple helper, actual path detection is in bash scripts
+    return process.cwd();
+}
+//# sourceMappingURL=index.js.map

package/src/index.js.map

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

package/templates/eslint.webpieces.config.mjs

@@ -0,0 +1,29 @@
+// @webpieces/dev-config ESLint Configuration
+// This is the canonical template for external clients
+//
+// IMPORTANT: When modifying rules here, also update:
+// - /eslint.webpieces.config.mjs (webpieces workspace version with loadWorkspaceRules)
+//
+// Only includes @webpieces custom rules
+// Configure your own TypeScript and general rules in your main eslint.config.mjs as needed
+
+import webpiecesPlugin from '@webpieces/dev-config/eslint-plugin';
+
+export default [
+    {
+        ignores: ['**/dist', '**/node_modules', '**/coverage', '**/.nx'],
+    },
+    {
+        files: ['**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx'],
+        plugins: {
+            '@webpieces': webpiecesPlugin,
+        },
+        rules: {
+            '@webpieces/catch-error-pattern': 'error',
+            '@webpieces/no-unmanaged-exceptions': 'error',
+            '@webpieces/max-method-lines': ['error', { max: 70 }],
+            '@webpieces/max-file-lines': ['error', { max: 700 }],
+            '@webpieces/enforce-architecture': 'error',
+        },
+    },
+];

package/generators/init/generator.ts

@@ -1,240 +0,0 @@
-import { formatFiles, readNxJson, Tree, updateNxJson, updateJson, addDependenciesToPackageJson } from '@nx/devkit';
-import type { InitGeneratorSchema } from './schema';
-
-/**
- * Init generator for @webpieces/dev-config
- *
- * Automatically runs when users execute: nx add @webpieces/dev-config
- *
- * Responsibilities:
- * - Registers the plugin in nx.json
- * - Creates architecture/ directory if needed
- * - Adds madge as a devDependency (required for circular dep checking)
- * - Adds convenient npm scripts to package.json
- * - Always creates eslint.webpieces.config.mjs with @webpieces rules
- * - Creates eslint.config.mjs (if not exists) that imports eslint.webpieces.config.mjs
- * - If eslint.config.mjs exists, shows user how to import eslint.webpieces.config.mjs
- * - Provides helpful output about available targets
- */
-export default async function initGenerator(tree: Tree, options: InitGeneratorSchema) {
-    registerPlugin(tree);
-    const installTask = addMadgeDependency(tree);
-    createArchitectureDirectory(tree);
-    addNpmScripts(tree);
-    createEslintConfig(tree);
-
-    if (!options.skipFormat) {
-        await formatFiles(tree);
-    }
-
-    return createSuccessCallback(installTask);
-}
-
-function registerPlugin(tree: Tree): void {
-    const nxJson = readNxJson(tree);
-    if (!nxJson) {
-        throw new Error('Could not read nx.json. Are you in an Nx workspace?');
-    }
-
-    if (!nxJson.plugins) {
-        nxJson.plugins = [];
-    }
-
-    const pluginName = '@webpieces/dev-config';
-    const alreadyRegistered = nxJson.plugins.some(
-        (p) => typeof p === 'string' ? p === pluginName : p.plugin === pluginName
-    );
-
-    if (!alreadyRegistered) {
-        nxJson.plugins.push(pluginName);
-        updateNxJson(tree, nxJson);
-        console.log(`✅ Registered ${pluginName} plugin in nx.json`);
-    } else {
-        console.log(`ℹ️  ${pluginName} plugin is already registered`);
-    }
-}
-
-function addMadgeDependency(tree: Tree) {
-    return addDependenciesToPackageJson(tree, {}, { 'madge': '^8.0.0' });
-}
-
-function createArchitectureDirectory(tree: Tree): void {
-    if (!tree.exists('architecture')) {
-        tree.write('architecture/.gitkeep', '');
-        console.log('✅ Created architecture/ directory');
-    }
-}
-
-function addNpmScripts(tree: Tree): void {
-    updateJson(tree, 'package.json', (pkgJson) => {
-        pkgJson.scripts = pkgJson.scripts ?? {};
-
-        // Add architecture validation scripts
-        pkgJson.scripts['arch:generate'] = 'nx run .:arch:generate';
-        pkgJson.scripts['arch:visualize'] = 'nx run .:arch:visualize';
-        pkgJson.scripts['arch:validate'] = 'nx run .:arch:validate-no-cycles && nx run .:arch:validate-no-skiplevel-deps';
-        pkgJson.scripts['arch:validate-all'] = 'nx run .:arch:validate-no-cycles && nx run .:arch:validate-no-skiplevel-deps && nx run .:arch:validate-architecture-unchanged';
-
-        // Add circular dependency checking scripts
-        pkgJson.scripts['arch:check-circular'] = 'nx run-many --target=check-circular-deps --all';
-        pkgJson.scripts['arch:check-circular-affected'] = 'nx affected --target=check-circular-deps';
-
-        // Complete validation including circular deps
-        pkgJson.scripts['arch:validate-complete'] = 'npm run arch:validate-all && npm run arch:check-circular';
-
-        return pkgJson;
-    });
-
-    console.log('✅ Added npm scripts for architecture validation and circular dependency checking');
-}
-
-function createEslintConfig(tree: Tree): void {
-    const webpiecesConfigPath = 'eslint.webpieces.config.mjs';
-    const mainConfigPath = 'eslint.config.mjs';
-
-    // Always create eslint.webpieces.config.mjs with our rules
-    createWebpiecesEslintConfig(tree, webpiecesConfigPath);
-
-    // Check if main eslint.config.mjs exists
-    if (tree.exists(mainConfigPath)) {
-        // Existing config - show them how to import
-        console.log('');
-        console.log('📋 Existing eslint.config.mjs detected');
-        console.log('');
-        console.log('To use @webpieces/dev-config ESLint rules, add this import to your eslint.config.mjs:');
-        console.log('');
-        console.log('  import webpiecesConfig from \'./eslint.webpieces.config.mjs\';');
-        console.log('');
-        console.log('Then spread it into your config array:');
-        console.log('');
-        console.log('  export default [');
-        console.log('    ...webpiecesConfig,  // Add this line');
-        console.log('    // ... your existing config');
-        console.log('  ];');
-        console.log('');
-    } else {
-        // No existing config - create one that imports webpieces config
-        const mainConfig = `// ESLint configuration
-// Imports @webpieces/dev-config rules
-
-import webpiecesConfig from './eslint.webpieces.config.mjs';
-
-// Export the webpieces configuration
-// You can add your own rules after spreading webpiecesConfig
-export default [
-    ...webpiecesConfig,
-    // Add your custom ESLint configuration here
-];
-`;
-
-        tree.write(mainConfigPath, mainConfig);
-        console.log('✅ Created eslint.config.mjs with @webpieces/dev-config rules');
-    }
-}
-
-function createWebpiecesEslintConfig(tree: Tree, configPath: string): void {
-    const webpiecesConfig = `// @webpieces/dev-config ESLint rules
-// This file contains the ESLint configuration provided by @webpieces/dev-config
-// You can modify or remove rules as needed for your project
-
-import webpiecesPlugin from '@webpieces/dev-config/eslint-plugin';
-import tseslint from '@typescript-eslint/eslint-plugin';
-import tsparser from '@typescript-eslint/parser';
-
-export default [
-    {
-        ignores: ['**/dist', '**/node_modules', '**/coverage', '**/.nx'],
-    },
-    {
-        files: ['**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx'],
-        plugins: {
-            '@webpieces': webpiecesPlugin,
-            '@typescript-eslint': tseslint,
-        },
-        languageOptions: {
-            parser: tsparser,
-            ecmaVersion: 2021,
-            sourceType: 'module',
-        },
-        rules: {
-            // WebPieces custom rules
-            '@webpieces/catch-error-pattern': 'error',
-            '@webpieces/no-unmanaged-exceptions': 'error',
-            '@webpieces/max-method-lines': ['error', { max: 70 }],
-            '@webpieces/max-file-lines': ['error', { max: 700 }],
-            '@webpieces/enforce-architecture': 'error',
-
-            // TypeScript rules
-            '@typescript-eslint/no-explicit-any': 'off',
-            '@typescript-eslint/explicit-function-return-type': 'off',
-            '@typescript-eslint/no-unused-vars': 'off',
-            '@typescript-eslint/no-empty-interface': 'off',
-            '@typescript-eslint/no-empty-function': 'off',
-
-            // General code quality
-            'no-console': 'off',
-            'no-debugger': 'off',
-            'no-var': 'error',
-            'prefer-const': 'off',
-        },
-    },
-    {
-        // Test files - relaxed rules
-        files: ['**/*.spec.ts', '**/*.test.ts'],
-        rules: {
-            '@typescript-eslint/no-explicit-any': 'off',
-            '@typescript-eslint/no-non-null-assertion': 'off',
-            '@webpieces/max-method-lines': 'off',
-        },
-    },
-];
-`;
-
-    tree.write(configPath, webpiecesConfig);
-    console.log('✅ Created eslint.webpieces.config.mjs with @webpieces/dev-config rules');
-}
-
-function createSuccessCallback(installTask: ReturnType<typeof addDependenciesToPackageJson>) {
-    return async () => {
-        await installTask();
-        console.log('✅ Added madge to devDependencies');
-        console.log('');
-        console.log('✅ @webpieces/dev-config plugin initialized!');
-        console.log('');
-        printAvailableTargets();
-    };
-}
-
-function printAvailableTargets(): void {
-    console.log('📝 Available npm scripts (convenient shortcuts):');
-    console.log('');
-    console.log('  Architecture graph:');
-    console.log('    npm run arch:generate                  # Generate dependency graph');
-    console.log('    npm run arch:visualize                 # Visualize dependency graph');
-    console.log('');
-    console.log('  Validation:');
-    console.log('    npm run arch:validate                  # Quick validation (no-cycles + no-skiplevel-deps)');
-    console.log('    npm run arch:validate-all              # Full arch validation (+ unchanged check)');
-    console.log('    npm run arch:check-circular            # Check all projects for circular deps');
-    console.log('    npm run arch:check-circular-affected   # Check affected projects only');
-    console.log('    npm run arch:validate-complete         # Complete validation (arch + circular)');
-    console.log('');
-    console.log('📝 Available Nx targets:');
-    console.log('');
-    console.log('  Workspace-level architecture validation:');
-    console.log('    nx run .:arch:generate                         # Generate dependency graph');
-    console.log('    nx run .:arch:visualize                        # Visualize dependency graph');
-    console.log('    nx run .:arch:validate-no-cycles               # Check for circular dependencies');
-    console.log('    nx run .:arch:validate-no-skiplevel-deps       # Check for redundant dependencies');
-    console.log('    nx run .:arch:validate-architecture-unchanged  # Validate against blessed graph');
-    console.log('');
-    console.log('  Per-project circular dependency checking:');
-    console.log('    nx run <project>:check-circular-deps           # Check project for circular deps');
-    console.log('    nx affected --target=check-circular-deps       # Check all affected projects');
-    console.log('    nx run-many --target=check-circular-deps --all # Check all projects');
-    console.log('');
-    console.log('💡 Quick start:');
-    console.log('   npm run arch:generate           # Generate the graph first');
-    console.log('   npm run arch:validate-complete  # Run complete validation');
-    console.log('');
-}