@webpieces/eslint-rules 0.3.285 → 0.3.287

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/eslint-rules",
-  "version": "0.3.285",
+  "version": "0.3.287",
   "description": "ESLint rules for WebPieces code patterns and architecture enforcement",
   "type": "commonjs",
   "main": "./src/index.js",
@@ -22,7 +22,7 @@
     "directory": "packages/tooling/eslint-rules"
   },
   "dependencies": {
-    "@webpieces/rules-config": "0.3.285"
+    "@webpieces/rules-config": "0.3.287"
   },
   "peerDependencies": {
     "eslint": ">=8.0.0"

package/recommended.mjs

@@ -58,7 +58,6 @@ export default [
             '@webpieces/max-file-lines': ['error', { max: 700 }],
             '@webpieces/enforce-architecture': 'error',
             '@webpieces/no-json-property-primitive-type': 'error',
-            '@webpieces/no-process-exit-outside-main': 'error',
             'no-console': 'off',
             'no-debugger': 'warn',
             'no-alert': 'warn',

package/src/index.d.ts

@@ -13,7 +13,6 @@
  * - no-json-property-primitive-type: Ban @JsonProperty({ type: String/Number/Boolean })
  * - require-typed-template: Require [templateClassType] on ng-template with let- variables (Angular)
  * - no-mat-cell-def: Ban *matCellDef/*matHeaderCellDef — use div-grid tables (Angular)
- * - no-process-exit-outside-main: process.exit only in main()/runMain; never import another module's main
  */
 declare const _default: {
     rules: {
@@ -25,7 +24,6 @@ declare const _default: {
         'no-json-property-primitive-type': import("eslint").Rule.RuleModule;
         'require-typed-template': import("eslint").Rule.RuleModule;
         'no-mat-cell-def': import("eslint").Rule.RuleModule;
-        'no-process-exit-outside-main': import("eslint").Rule.RuleModule;
     };
 };
 export = _default;

package/src/index.js

@@ -14,7 +14,6 @@
  * - no-json-property-primitive-type: Ban @JsonProperty({ type: String/Number/Boolean })
  * - require-typed-template: Require [templateClassType] on ng-template with let- variables (Angular)
  * - no-mat-cell-def: Ban *matCellDef/*matHeaderCellDef — use div-grid tables (Angular)
- * - no-process-exit-outside-main: process.exit only in main()/runMain; never import another module's main
  */
 const tslib_1 = require("tslib");
 const catch_error_pattern_1 = tslib_1.__importDefault(require("./rules/catch-error-pattern"));
@@ -25,7 +24,6 @@ const enforce_architecture_1 = tslib_1.__importDefault(require("./rules/enforce-
 const no_json_property_primitive_type_1 = tslib_1.__importDefault(require("./rules/no-json-property-primitive-type"));
 const require_typed_template_1 = tslib_1.__importDefault(require("./rules/require-typed-template"));
 const no_mat_cell_def_1 = tslib_1.__importDefault(require("./rules/no-mat-cell-def"));
-const no_process_exit_outside_main_1 = tslib_1.__importDefault(require("./rules/no-process-exit-outside-main"));
 module.exports = {
     rules: {
         'catch-error-pattern': catch_error_pattern_1.default,
@@ -36,7 +34,6 @@ module.exports = {
         'no-json-property-primitive-type': no_json_property_primitive_type_1.default,
         'require-typed-template': require_typed_template_1.default,
         'no-mat-cell-def': no_mat_cell_def_1.default,
-        'no-process-exit-outside-main': no_process_exit_outside_main_1.default,
     },
 };
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/tooling/eslint-rules/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;AAEH,8FAA4D;AAC5D,sGAAoE;AACpE,wFAAsD;AACtD,oFAAkD;AAClD,gGAA+D;AAC/D,sHAAkF;AAClF,oGAAkE;AAClE,sFAAmD;AACnD,gHAA4E;AAE5E,iBAAS;IACL,KAAK,EAAE;QACH,qBAAqB,EAAE,6BAAiB;QACxC,yBAAyB,EAAE,iCAAqB;QAChD,kBAAkB,EAAE,0BAAc;QAClC,gBAAgB,EAAE,wBAAY;QAC9B,sBAAsB,EAAE,8BAAmB;QAC3C,iCAAiC,EAAE,yCAA2B;QAC9D,wBAAwB,EAAE,gCAAoB;QAC9C,iBAAiB,EAAE,yBAAY;QAC/B,8BAA8B,EAAE,sCAAwB;KAC3D;CACJ,CAAC","sourcesContent":["/**\n * ESLint plugin for WebPieces\n * Provides rules for enforcing WebPieces code patterns\n *\n * This plugin is automatically included in @webpieces/nx-webpieces-rules\n *\n * Available rules:\n * - catch-error-pattern: Enforce toError() usage in catch blocks (HOW to handle)\n * - no-unmanaged-exceptions: Discourage try-catch outside tests (WHERE to handle)\n * - max-method-lines: Enforce maximum method length (default: 70 lines)\n * - max-file-lines: Enforce maximum file length (default: 700 lines)\n * - enforce-architecture: Enforce architecture dependency boundaries\n * - no-json-property-primitive-type: Ban @JsonProperty({ type: String/Number/Boolean })\n * - require-typed-template: Require [templateClassType] on ng-template with let- variables (Angular)\n * - no-mat-cell-def: Ban *matCellDef/*matHeaderCellDef — use div-grid tables (Angular)\n * - no-process-exit-outside-main: process.exit only in main()/runMain; never import another module's main\n */\n\nimport catchErrorPattern from './rules/catch-error-pattern';\nimport noUnmanagedExceptions from './rules/no-unmanaged-exceptions';\nimport maxMethodLines from './rules/max-method-lines';\nimport maxFileLines from './rules/max-file-lines';\nimport enforceArchitecture from './rules/enforce-architecture';\nimport noJsonPropertyPrimitiveType from './rules/no-json-property-primitive-type';\nimport requireTypedTemplate from './rules/require-typed-template';\nimport noMatCellDef from './rules/no-mat-cell-def';\nimport noProcessExitOutsideMain from './rules/no-process-exit-outside-main';\n\nexport = {\n    rules: {\n        'catch-error-pattern': catchErrorPattern,\n        'no-unmanaged-exceptions': noUnmanagedExceptions,\n        'max-method-lines': maxMethodLines,\n        'max-file-lines': maxFileLines,\n        'enforce-architecture': enforceArchitecture,\n        'no-json-property-primitive-type': noJsonPropertyPrimitiveType,\n        'require-typed-template': requireTypedTemplate,\n        'no-mat-cell-def': noMatCellDef,\n        'no-process-exit-outside-main': noProcessExitOutsideMain,\n    },\n};\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/tooling/eslint-rules/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;AAEH,8FAA4D;AAC5D,sGAAoE;AACpE,wFAAsD;AACtD,oFAAkD;AAClD,gGAA+D;AAC/D,sHAAkF;AAClF,oGAAkE;AAClE,sFAAmD;AAEnD,iBAAS;IACL,KAAK,EAAE;QACH,qBAAqB,EAAE,6BAAiB;QACxC,yBAAyB,EAAE,iCAAqB;QAChD,kBAAkB,EAAE,0BAAc;QAClC,gBAAgB,EAAE,wBAAY;QAC9B,sBAAsB,EAAE,8BAAmB;QAC3C,iCAAiC,EAAE,yCAA2B;QAC9D,wBAAwB,EAAE,gCAAoB;QAC9C,iBAAiB,EAAE,yBAAY;KAClC;CACJ,CAAC","sourcesContent":["/**\n * ESLint plugin for WebPieces\n * Provides rules for enforcing WebPieces code patterns\n *\n * This plugin is automatically included in @webpieces/nx-webpieces-rules\n *\n * Available rules:\n * - catch-error-pattern: Enforce toError() usage in catch blocks (HOW to handle)\n * - no-unmanaged-exceptions: Discourage try-catch outside tests (WHERE to handle)\n * - max-method-lines: Enforce maximum method length (default: 70 lines)\n * - max-file-lines: Enforce maximum file length (default: 700 lines)\n * - enforce-architecture: Enforce architecture dependency boundaries\n * - no-json-property-primitive-type: Ban @JsonProperty({ type: String/Number/Boolean })\n * - require-typed-template: Require [templateClassType] on ng-template with let- variables (Angular)\n * - no-mat-cell-def: Ban *matCellDef/*matHeaderCellDef — use div-grid tables (Angular)\n */\n\nimport catchErrorPattern from './rules/catch-error-pattern';\nimport noUnmanagedExceptions from './rules/no-unmanaged-exceptions';\nimport maxMethodLines from './rules/max-method-lines';\nimport maxFileLines from './rules/max-file-lines';\nimport enforceArchitecture from './rules/enforce-architecture';\nimport noJsonPropertyPrimitiveType from './rules/no-json-property-primitive-type';\nimport requireTypedTemplate from './rules/require-typed-template';\nimport noMatCellDef from './rules/no-mat-cell-def';\n\nexport = {\n    rules: {\n        'catch-error-pattern': catchErrorPattern,\n        'no-unmanaged-exceptions': noUnmanagedExceptions,\n        'max-method-lines': maxMethodLines,\n        'max-file-lines': maxFileLines,\n        'enforce-architecture': enforceArchitecture,\n        'no-json-property-primitive-type': noJsonPropertyPrimitiveType,\n        'require-typed-template': requireTypedTemplate,\n        'no-mat-cell-def': noMatCellDef,\n    },\n};\n"]}

package/src/rules/no-process-exit-outside-main.d.ts

@@ -1,24 +0,0 @@
-/**
- * ESLint rule: no-process-exit-outside-main
- *
- * Enforces the codebase invariant: `process.exit` may appear ONLY inside a function named `main`
- * (a bin's terminal boundary) or inside the shared `runMain` wrapper. Everywhere else — especially a
- * library function that another module imports and calls — a `process.exit` silently kills the PARENT
- * process. That is exactly the bug this rule prevents: `git-gatherInfo`'s `main()` called
- * `process.exit(0)` while imported by `merge-start`, so it killed `wp-start-upsert-pr` mid-flow (with
- * a SUCCESS code) and push + build were skipped. Library code must instead `throw CliExitError(code,
- * msg)` and let `main()` / `runMain` translate it into the single sanctioned exit.
- *
- * Two checks:
- *  1. `process.exit(...)` outside a `main`/`runMain` function → error (throw CliExitError instead).
- *  2. `import { main }` / `import { main as X }` from another module → error. `main` is a bin entry
- *     point, not a library export; importing it is what let a library call another module's exiting
- *     `main`. Call a named function; each bin owns its own thin `main()` + `runMain` wrapper.
- *
- * Genuine terminal boundaries that are not named `main` (a server bootstrap, a hook's exit-code
- * protocol) use an inline `// eslint-disable-next-line @webpieces/no-process-exit-outside-main --
- * <reason>` with a justification.
- */
-import type { Rule } from 'eslint';
-declare const rule: Rule.RuleModule;
-export = rule;

package/src/rules/no-process-exit-outside-main.js

@@ -1,99 +0,0 @@
-"use strict";
-/**
- * ESLint rule: no-process-exit-outside-main
- *
- * Enforces the codebase invariant: `process.exit` may appear ONLY inside a function named `main`
- * (a bin's terminal boundary) or inside the shared `runMain` wrapper. Everywhere else — especially a
- * library function that another module imports and calls — a `process.exit` silently kills the PARENT
- * process. That is exactly the bug this rule prevents: `git-gatherInfo`'s `main()` called
- * `process.exit(0)` while imported by `merge-start`, so it killed `wp-start-upsert-pr` mid-flow (with
- * a SUCCESS code) and push + build were skipped. Library code must instead `throw CliExitError(code,
- * msg)` and let `main()` / `runMain` translate it into the single sanctioned exit.
- *
- * Two checks:
- *  1. `process.exit(...)` outside a `main`/`runMain` function → error (throw CliExitError instead).
- *  2. `import { main }` / `import { main as X }` from another module → error. `main` is a bin entry
- *     point, not a library export; importing it is what let a library call another module's exiting
- *     `main`. Call a named function; each bin owns its own thin `main()` + `runMain` wrapper.
- *
- * Genuine terminal boundaries that are not named `main` (a server bootstrap, a hook's exit-code
- * protocol) use an inline `// eslint-disable-next-line @webpieces/no-process-exit-outside-main --
- * <reason>` with a justification.
- */
-const ALLOWED_FUNCTION_NAMES = ['main', 'runMain'];
-const rule = {
-    meta: {
-        type: 'problem',
-        docs: {
-            description: 'process.exit() only inside main()/runMain; never import another module\'s main',
-        },
-        messages: {
-            noProcessExit: 'Do not call process.exit() here. Only a function named `main` (or the shared `runMain` ' +
-                'wrapper) may exit the process — library code that another module calls would otherwise ' +
-                'silently kill the parent process. Throw `CliExitError(code, message)` and let main()/runMain ' +
-                'translate it. Genuine terminal boundary? Add `// eslint-disable-next-line ' +
-                '@webpieces/no-process-exit-outside-main -- <reason>`.',
-            noImportMain: 'Do not import another module\'s `main`. `main` is a bin entry point, not a library export; ' +
-                'importing it is what lets library code call an exiting `main` and kill the parent process. ' +
-                'Export and import a named function instead, and give each bin its own thin main()/runMain wrapper.',
-        },
-        schema: [],
-    },
-    create(context) {
-        // Listener params are typed with our minimal AstNode; ESLint passes ESTree nodes, so the whole
-        // listener object is cast to Rule.RuleListener once at the return (rather than per-node).
-        const listener = {
-            CallExpression(node) {
-                // Match `process.exit(...)` exactly (not computed, not some other object).
-                const callee = node.callee;
-                if (!callee || callee.type !== 'MemberExpression' || callee.computed)
-                    return;
-                const obj = callee.object;
-                const prop = callee.property;
-                const isExit = obj.type === 'Identifier' && obj.name === 'process' && prop.type === 'Identifier' && prop.name === 'exit';
-                if (!isExit)
-                    return;
-                // Allow only when lexically inside a function named `main` or `runMain`.
-                // webpieces-disable no-any-unknown -- bridge our loose AstNode to ESLint's Rule.Node for the ancestor API.
-                const ancestors = context.sourceCode.getAncestors(node);
-                let allowed = false;
-                for (const anc of ancestors) {
-                    if (anc.type !== 'FunctionDeclaration' && anc.type !== 'FunctionExpression' && anc.type !== 'ArrowFunctionExpression') {
-                        continue;
-                    }
-                    // Name: `function main()` (declaration id) or `const main = () => {}` (declarator).
-                    let name = null;
-                    if (anc.id && typeof anc.id.name === 'string') {
-                        name = anc.id.name;
-                    }
-                    else {
-                        const parent = anc.parent;
-                        if (parent && parent.type === 'VariableDeclarator' && parent.id && typeof parent.id.name === 'string') {
-                            name = parent.id.name;
-                        }
-                    }
-                    if (name !== null && ALLOWED_FUNCTION_NAMES.includes(name)) {
-                        allowed = true;
-                        break;
-                    }
-                }
-                if (allowed)
-                    return;
-                // webpieces-disable no-any-unknown -- ESTree AST cast for ESLint report.
-                context.report({ node: node, messageId: 'noProcessExit' });
-            },
-            ImportDeclaration(node) {
-                for (const spec of node.specifiers) {
-                    if (spec.type === 'ImportSpecifier' && spec.imported && spec.imported.name === 'main') {
-                        // webpieces-disable no-any-unknown -- ESTree AST cast for ESLint report.
-                        context.report({ node: spec, messageId: 'noImportMain' });
-                    }
-                }
-            },
-        };
-        // webpieces-disable no-any-unknown -- our AstNode listener params bridge to ESLint's node types.
-        return listener;
-    },
-};
-module.exports = rule;
-//# sourceMappingURL=no-process-exit-outside-main.js.map

package/src/rules/no-process-exit-outside-main.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"no-process-exit-outside-main.js","sourceRoot":"","sources":["../../../../../../packages/tooling/eslint-rules/src/rules/no-process-exit-outside-main.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ESLint rule: no-process-exit-outside-main\n *\n * Enforces the codebase invariant: `process.exit` may appear ONLY inside a function named `main`\n * (a bin's terminal boundary) or inside the shared `runMain` wrapper. Everywhere else — especially a\n * library function that another module imports and calls — a `process.exit` silently kills the PARENT\n * process. That is exactly the bug this rule prevents: `git-gatherInfo`'s `main()` called\n * `process.exit(0)` while imported by `merge-start`, so it killed `wp-start-upsert-pr` mid-flow (with\n * a SUCCESS code) and push + build were skipped. Library code must instead `throw CliExitError(code,\n * msg)` and let `main()` / `runMain` translate it into the single sanctioned exit.\n *\n * Two checks:\n *  1. `process.exit(...)` outside a `main`/`runMain` function → error (throw CliExitError instead).\n *  2. `import { main }` / `import { main as X }` from another module → error. `main` is a bin entry\n *     point, not a library export; importing it is what let a library call another module's exiting\n *     `main`. Call a named function; each bin owns its own thin `main()` + `runMain` wrapper.\n *\n * Genuine terminal boundaries that are not named `main` (a server bootstrap, a hook's exit-code\n * protocol) use an inline `// eslint-disable-next-line @webpieces/no-process-exit-outside-main --\n * <reason>` with a justification.\n */\n\nimport type { Rule } from 'eslint';\n\n// Minimal structural view of the ESTree/ESLint AST nodes this rule inspects — only the fields we\n// read, declared as named properties (no index signature) so access stays type-checked.\ninterface AstNode {\n    type: string;\n    name?: string;\n    computed?: boolean;\n    callee?: AstNode;\n    object?: AstNode;\n    property?: AstNode;\n    id?: AstNode;\n    parent?: AstNode;\n    imported?: AstNode;\n    specifiers?: AstNode[];\n}\n\nconst ALLOWED_FUNCTION_NAMES = ['main', 'runMain'];\n\nconst rule: Rule.RuleModule = {\n    meta: {\n        type: 'problem',\n        docs: {\n            description: 'process.exit() only inside main()/runMain; never import another module\\'s main',\n        },\n        messages: {\n            noProcessExit:\n                'Do not call process.exit() here. Only a function named `main` (or the shared `runMain` ' +\n                'wrapper) may exit the process — library code that another module calls would otherwise ' +\n                'silently kill the parent process. Throw `CliExitError(code, message)` and let main()/runMain ' +\n                'translate it. Genuine terminal boundary? Add `// eslint-disable-next-line ' +\n                '@webpieces/no-process-exit-outside-main -- <reason>`.',\n            noImportMain:\n                'Do not import another module\\'s `main`. `main` is a bin entry point, not a library export; ' +\n                'importing it is what lets library code call an exiting `main` and kill the parent process. ' +\n                'Export and import a named function instead, and give each bin its own thin main()/runMain wrapper.',\n        },\n        schema: [],\n    },\n    create(context: Rule.RuleContext): Rule.RuleListener {\n        // Listener params are typed with our minimal AstNode; ESLint passes ESTree nodes, so the whole\n        // listener object is cast to Rule.RuleListener once at the return (rather than per-node).\n        const listener = {\n            CallExpression(node: AstNode): void {\n                // Match `process.exit(...)` exactly (not computed, not some other object).\n                const callee: AstNode | undefined = node.callee as AstNode | undefined;\n                if (!callee || callee.type !== 'MemberExpression' || callee.computed) return;\n                const obj: AstNode = callee.object as AstNode;\n                const prop: AstNode = callee.property as AstNode;\n                const isExit = obj.type === 'Identifier' && obj.name === 'process' && prop.type === 'Identifier' && prop.name === 'exit';\n                if (!isExit) return;\n\n                // Allow only when lexically inside a function named `main` or `runMain`.\n                // webpieces-disable no-any-unknown -- bridge our loose AstNode to ESLint's Rule.Node for the ancestor API.\n                const ancestors = context.sourceCode.getAncestors(node as unknown as Rule.Node) as unknown as AstNode[];\n                let allowed = false;\n                for (const anc of ancestors) {\n                    if (anc.type !== 'FunctionDeclaration' && anc.type !== 'FunctionExpression' && anc.type !== 'ArrowFunctionExpression') {\n                        continue;\n                    }\n                    // Name: `function main()` (declaration id) or `const main = () => {}` (declarator).\n                    let name: string | null = null;\n                    if (anc.id && typeof anc.id.name === 'string') {\n                        name = anc.id.name;\n                    } else {\n                        const parent: AstNode | undefined = anc.parent as AstNode | undefined;\n                        if (parent && parent.type === 'VariableDeclarator' && parent.id && typeof parent.id.name === 'string') {\n                            name = parent.id.name;\n                        }\n                    }\n                    if (name !== null && ALLOWED_FUNCTION_NAMES.includes(name)) {\n                        allowed = true;\n                        break;\n                    }\n                }\n                if (allowed) return;\n                // webpieces-disable no-any-unknown -- ESTree AST cast for ESLint report.\n                context.report({ node: node as unknown as Rule.Node, messageId: 'noProcessExit' });\n            },\n            ImportDeclaration(node: AstNode): void {\n                for (const spec of node.specifiers as AstNode[]) {\n                    if (spec.type === 'ImportSpecifier' && spec.imported && spec.imported.name === 'main') {\n                        // webpieces-disable no-any-unknown -- ESTree AST cast for ESLint report.\n                        context.report({ node: spec as unknown as Rule.Node, messageId: 'noImportMain' });\n                    }\n                }\n            },\n        };\n        // webpieces-disable no-any-unknown -- our AstNode listener params bridge to ESLint's node types.\n        return listener as unknown as Rule.RuleListener;\n    },\n};\n\nexport = rule;\n"]}