@webpieces/nx-webpieces-rules 0.4.843 → 0.4.845

package/src/configs/tag-truth-configs.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrameworkFolderConfig = exports.FrameworkFolderEntry = exports.ApiLibPathConfig = exports.ApiLibDependenciesConfig = exports.ApiClientPackagesEntry = void 0;
+const rules_sdk_1 = require("@webpieces/rules-sdk");
+const rule_configs_1 = require("./rule-configs");
+/** One `role:api-client` project and the outside packages it may import (its SDK, inversify, …). Data-only. */
+class ApiClientPackagesEntry {
+    /** The nx project name of the `role:api-client` library, e.g. `gmail-client`. */
+    project;
+    /** Package names (globs allowed, e.g. `@google-cloud/*`) it may import beyond `apiLibPackages`. */
+    packages;
+    static SCHEMA = {
+        project: new rules_sdk_1.FieldDef('string'),
+        packages: new rules_sdk_1.FieldDef('string[]'),
+    };
+}
+exports.ApiClientPackagesEntry = ApiClientPackagesEntry;
+/**
+ * `api-lib-dependencies` (D2) — a `role:api-lib` may depend only on other `role:api-lib` projects plus
+ * the outside packages in `apiLibPackages`; a `role:api-client` may ALSO import the packages its own
+ * `apiClients` entry names (its SDK, `inversify`, `@webpieces/core-context`, …).
+ *
+ * - `mode` — OFF | RUN_EVERY_TIME (a graph rule: it reads every project, every run).
+ * - `apiLibPackages` — required; may be empty (an api library then imports nothing from outside), e.g.
+ *   `["@webpieces/core-util", "tslib"]`. A workspace project whose name or package name is listed here
+ *   is allowed too, so a repo whose `core-util` is a workspace project states it the same way.
+ * - `apiClients` — required; one entry per `role:api-client` project. A `role:api-client` with no
+ *   entry is itself a violation: what it may talk to is stated, never inferred.
+ */
+class ApiLibDependenciesConfig extends rules_sdk_1.BaseRuleConfig {
+    apiLibPackages;
+    apiClients;
+    static SCHEMA = {
+        mode: new rules_sdk_1.FieldDef('string', rule_configs_1.STRUCTURAL_MODES),
+        apiLibPackages: new rules_sdk_1.FieldDef('string[]'),
+        apiClients: rules_sdk_1.FieldDef.objects(ApiClientPackagesEntry.SCHEMA),
+        ...rules_sdk_1.BASE_RULE_SCHEMA,
+    };
+}
+exports.ApiLibDependenciesConfig = ApiLibDependenciesConfig;
+/**
+ * `api-lib-path` (D10) — both directions: every `role:api-lib` / `role:api-client` project lives under
+ * one of `paths`, and every project under `paths` carries one of those two roles.
+ *
+ * - `mode` — OFF | RUN_EVERY_TIME.
+ * - `paths` — required, non-empty globs over project ROOTS, e.g. `["libraries/apis/**"]`.
+ */
+class ApiLibPathConfig extends rules_sdk_1.BaseRuleConfig {
+    paths;
+    static SCHEMA = {
+        mode: new rules_sdk_1.FieldDef('string', rule_configs_1.STRUCTURAL_MODES),
+        paths: rules_sdk_1.FieldDef.nonEmptyStrings(),
+        ...rules_sdk_1.BASE_RULE_SCHEMA,
+    };
+}
+exports.ApiLibPathConfig = ApiLibPathConfig;
+/**
+ * One folder of the runtime layout: the project roots it covers, the framework SETS a project there may
+ * carry, and the roles it may have. Data-only.
+ *
+ * A framework set is written as its tags joined by `+`, in any order: `"browser+node+react-native"`.
+ * Listing two sets means EITHER — `["node", "express"]` is a node library or an express one.
+ */
+class FrameworkFolderEntry {
+    /** Globs over project ROOTS, e.g. `["libraries/universal/**"]`. Non-empty. */
+    paths;
+    /** The accepted framework sets, each `+`-joined, e.g. `["browser+node+react-native"]`. Non-empty. */
+    frameworkSets;
+    /** The accepted roles, e.g. `["lib", "designed-lib"]`. Non-empty. */
+    roles;
+    static SCHEMA = {
+        paths: rules_sdk_1.FieldDef.nonEmptyStrings(),
+        frameworkSets: rules_sdk_1.FieldDef.nonEmptyStrings(),
+        roles: rules_sdk_1.FieldDef.nonEmptyStrings(),
+    };
+}
+exports.FrameworkFolderEntry = FrameworkFolderEntry;
+/**
+ * `framework-folder` (D9) — the folder a library lives in and the tags it carries say the same thing,
+ * both directions:
+ *  - a project under an entry's `paths` (the FIRST entry whose glob matches, in `entries` order) must
+ *    carry one of that entry's `frameworkSets`, exactly, and one of its `roles`;
+ *  - a LIBRARY (any role but server/app/client/bundle) carrying a framework set and role that some entry
+ *    lists must live under one of the entries that list them.
+ *
+ * - `mode` — OFF | RUN_EVERY_TIME.
+ * - `entries` — required, non-empty. The recommended layout is in `.claude/rules/framework-tags.md`.
+ */
+class FrameworkFolderConfig extends rules_sdk_1.BaseRuleConfig {
+    entries;
+    static SCHEMA = {
+        mode: new rules_sdk_1.FieldDef('string', rule_configs_1.STRUCTURAL_MODES),
+        entries: rules_sdk_1.FieldDef.nonEmptyObjects(FrameworkFolderEntry.SCHEMA),
+        ...rules_sdk_1.BASE_RULE_SCHEMA,
+    };
+}
+exports.FrameworkFolderConfig = FrameworkFolderConfig;
+//# sourceMappingURL=tag-truth-configs.js.map

package/src/configs/tag-truth-configs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-truth-configs.js","sourceRoot":"","sources":["../../../../../../packages/tooling/nx-webpieces-rules/src/configs/tag-truth-configs.ts"],"names":[],"mappings":";;;AAAA,oDAA+F;AAC/F,iDAAkE;AAClE,+GAA+G;AAC/G,MAAa,sBAAsB;IAC/B,iFAAiF;IACjF,OAAO,CAAU;IACjB,mGAAmG;IACnG,QAAQ,CAAY;IAEpB,MAAM,CAAU,MAAM,GAAwC;QAC1D,OAAO,EAAE,IAAI,oBAAQ,CAAC,QAAQ,CAAC;QAC/B,QAAQ,EAAE,IAAI,oBAAQ,CAAC,UAAU,CAAC;KACrC,CAAC;;AATN,wDAUC;AAED;;;;;;;;;;;GAWG;AACH,MAAa,wBAAyB,SAAQ,0BAAc;IAExD,cAAc,CAAY;IAC1B,UAAU,CAA4B;IAEtC,MAAM,CAAU,MAAM,GAA0C;QAC5D,IAAI,EAAE,IAAI,oBAAQ,CAAC,QAAQ,EAAE,+BAAgB,CAAC;QAC9C,cAAc,EAAE,IAAI,oBAAQ,CAAC,UAAU,CAAC;QACxC,UAAU,EAAE,oBAAQ,CAAC,OAAO,CAAC,sBAAsB,CAAC,MAAM,CAAC;QAC3D,GAAG,4BAAgB;KACtB,CAAC;;AAVN,4DAWC;AAED;;;;;;GAMG;AACH,MAAa,gBAAiB,SAAQ,0BAAc;IAEhD,KAAK,CAAY;IAEjB,MAAM,CAAU,MAAM,GAAkC;QACpD,IAAI,EAAE,IAAI,oBAAQ,CAAC,QAAQ,EAAE,+BAAgB,CAAC;QAC9C,KAAK,EAAE,oBAAQ,CAAC,eAAe,EAAE;QACjC,GAAG,4BAAgB;KACtB,CAAC;;AARN,4CASC;AAED;;;;;;GAMG;AACH,MAAa,oBAAoB;IAC7B,8EAA8E;IAC9E,KAAK,CAAY;IACjB,qGAAqG;IACrG,aAAa,CAAY;IACzB,qEAAqE;IACrE,KAAK,CAAY;IAEjB,MAAM,CAAU,MAAM,GAAsC;QACxD,KAAK,EAAE,oBAAQ,CAAC,eAAe,EAAE;QACjC,aAAa,EAAE,oBAAQ,CAAC,eAAe,EAAE;QACzC,KAAK,EAAE,oBAAQ,CAAC,eAAe,EAAE;KACpC,CAAC;;AAZN,oDAaC;AAED;;;;;;;;;;GAUG;AACH,MAAa,qBAAsB,SAAQ,0BAAc;IAErD,OAAO,CAA0B;IAEjC,MAAM,CAAU,MAAM,GAAuC;QACzD,IAAI,EAAE,IAAI,oBAAQ,CAAC,QAAQ,EAAE,+BAAgB,CAAC;QAC9C,OAAO,EAAE,oBAAQ,CAAC,eAAe,CAAC,oBAAoB,CAAC,MAAM,CAAC;QAC9D,GAAG,4BAAgB;KACtB,CAAC;;AARN,sDASC","sourcesContent":["import { FieldDef, SchemaShape, BaseRuleConfig, BASE_RULE_SCHEMA } from \"@webpieces/rules-sdk\";\nimport { StructuralMode, STRUCTURAL_MODES } from \"./rule-configs\";\n/** One `role:api-client` project and the outside packages it may import (its SDK, inversify, …). Data-only. */\nexport class ApiClientPackagesEntry {\n    /** The nx project name of the `role:api-client` library, e.g. `gmail-client`. */\n    project!: string;\n    /** Package names (globs allowed, e.g. `@google-cloud/*`) it may import beyond `apiLibPackages`. */\n    packages!: string[];\n\n    static readonly SCHEMA: SchemaShape<ApiClientPackagesEntry> = {\n        project: new FieldDef('string'),\n        packages: new FieldDef('string[]'),\n    };\n}\n\n/**\n * `api-lib-dependencies` (D2) — a `role:api-lib` may depend only on other `role:api-lib` projects plus\n * the outside packages in `apiLibPackages`; a `role:api-client` may ALSO import the packages its own\n * `apiClients` entry names (its SDK, `inversify`, `@webpieces/core-context`, …).\n *\n * - `mode` — OFF | RUN_EVERY_TIME (a graph rule: it reads every project, every run).\n * - `apiLibPackages` — required; may be empty (an api library then imports nothing from outside), e.g.\n *   `[\"@webpieces/core-util\", \"tslib\"]`. A workspace project whose name or package name is listed here\n *   is allowed too, so a repo whose `core-util` is a workspace project states it the same way.\n * - `apiClients` — required; one entry per `role:api-client` project. A `role:api-client` with no\n *   entry is itself a violation: what it may talk to is stated, never inferred.\n */\nexport class ApiLibDependenciesConfig extends BaseRuleConfig {\n    declare mode?: StructuralMode;\n    apiLibPackages!: string[];\n    apiClients!: ApiClientPackagesEntry[];\n\n    static readonly SCHEMA: SchemaShape<ApiLibDependenciesConfig> = {\n        mode: new FieldDef('string', STRUCTURAL_MODES),\n        apiLibPackages: new FieldDef('string[]'),\n        apiClients: FieldDef.objects(ApiClientPackagesEntry.SCHEMA),\n        ...BASE_RULE_SCHEMA,\n    };\n}\n\n/**\n * `api-lib-path` (D10) — both directions: every `role:api-lib` / `role:api-client` project lives under\n * one of `paths`, and every project under `paths` carries one of those two roles.\n *\n * - `mode` — OFF | RUN_EVERY_TIME.\n * - `paths` — required, non-empty globs over project ROOTS, e.g. `[\"libraries/apis/**\"]`.\n */\nexport class ApiLibPathConfig extends BaseRuleConfig {\n    declare mode?: StructuralMode;\n    paths!: string[];\n\n    static readonly SCHEMA: SchemaShape<ApiLibPathConfig> = {\n        mode: new FieldDef('string', STRUCTURAL_MODES),\n        paths: FieldDef.nonEmptyStrings(),\n        ...BASE_RULE_SCHEMA,\n    };\n}\n\n/**\n * One folder of the runtime layout: the project roots it covers, the framework SETS a project there may\n * carry, and the roles it may have. Data-only.\n *\n * A framework set is written as its tags joined by `+`, in any order: `\"browser+node+react-native\"`.\n * Listing two sets means EITHER — `[\"node\", \"express\"]` is a node library or an express one.\n */\nexport class FrameworkFolderEntry {\n    /** Globs over project ROOTS, e.g. `[\"libraries/universal/**\"]`. Non-empty. */\n    paths!: string[];\n    /** The accepted framework sets, each `+`-joined, e.g. `[\"browser+node+react-native\"]`. Non-empty. */\n    frameworkSets!: string[];\n    /** The accepted roles, e.g. `[\"lib\", \"designed-lib\"]`. Non-empty. */\n    roles!: string[];\n\n    static readonly SCHEMA: SchemaShape<FrameworkFolderEntry> = {\n        paths: FieldDef.nonEmptyStrings(),\n        frameworkSets: FieldDef.nonEmptyStrings(),\n        roles: FieldDef.nonEmptyStrings(),\n    };\n}\n\n/**\n * `framework-folder` (D9) — the folder a library lives in and the tags it carries say the same thing,\n * both directions:\n *  - a project under an entry's `paths` (the FIRST entry whose glob matches, in `entries` order) must\n *    carry one of that entry's `frameworkSets`, exactly, and one of its `roles`;\n *  - a LIBRARY (any role but server/app/client/bundle) carrying a framework set and role that some entry\n *    lists must live under one of the entries that list them.\n *\n * - `mode` — OFF | RUN_EVERY_TIME.\n * - `entries` — required, non-empty. The recommended layout is in `.claude/rules/framework-tags.md`.\n */\nexport class FrameworkFolderConfig extends BaseRuleConfig {\n    declare mode?: StructuralMode;\n    entries!: FrameworkFolderEntry[];\n\n    static readonly SCHEMA: SchemaShape<FrameworkFolderConfig> = {\n        mode: new FieldDef('string', STRUCTURAL_MODES),\n        entries: FieldDef.nonEmptyObjects(FrameworkFolderEntry.SCHEMA),\n        ...BASE_RULE_SCHEMA,\n    };\n}\n"]}

package/src/executors/validate-catch-error-pattern/executor.d.ts

@@ -1,4 +1,4 @@
 import type { ExecutorContext } from '@nx/devkit';
 import { ExecutorResult } from '../../executor-result';
-import { CatchErrorPatternConfig } from '@webpieces/rules-config';
+import { CatchErrorPatternConfig } from "@webpieces/code-rules";
 export default function runExecutor(options: CatchErrorPatternConfig, context: ExecutorContext): Promise<ExecutorResult>;

package/src/executors/validate-catch-error-pattern/executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-catch-error-pattern/executor.ts"],"names":[],"mappings":";;AAKA,8BAKC;AARD,sDAAkF;AAGnE,KAAK,UAAU,WAAW,CACrC,OAAgC,EAChC,OAAwB;IAExB,OAAO,IAAI,uCAA0B,CAAC,OAAO,EAAE,IAAI,0BAAa,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC1F,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { CatchErrorPatternValidator, GateScanScope } from '@webpieces/code-rules';\nimport { CatchErrorPatternConfig } from '@webpieces/rules-config';\n\nexport default async function runExecutor(\n    options: CatchErrorPatternConfig,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return new CatchErrorPatternValidator(options, new GateScanScope()).run(context.root);\n}\n"]}
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-catch-error-pattern/executor.ts"],"names":[],"mappings":";;AAKA,8BAKC;AARD,sDAAkF;AAGnE,KAAK,UAAU,WAAW,CACrC,OAAgC,EAChC,OAAwB;IAExB,OAAO,IAAI,uCAA0B,CAAC,OAAO,EAAE,IAAI,0BAAa,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC1F,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { CatchErrorPatternValidator, GateScanScope } from '@webpieces/code-rules';\nimport { CatchErrorPatternConfig } from \"@webpieces/code-rules\";\n\nexport default async function runExecutor(\n    options: CatchErrorPatternConfig,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return new CatchErrorPatternValidator(options, new GateScanScope()).run(context.root);\n}\n"]}

package/src/executors/validate-dtos/executor.d.ts

@@ -1,4 +1,4 @@
 import type { ExecutorContext } from '@nx/devkit';
 import { ExecutorResult } from '../../executor-result';
-import { PrismaValidateDtosConfig } from '@webpieces/rules-config';
+import { PrismaValidateDtosConfig } from "@webpieces/code-rules";
 export default function runExecutor(options: PrismaValidateDtosConfig, context: ExecutorContext): Promise<ExecutorResult>;

package/src/executors/validate-dtos/executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-dtos/executor.ts"],"names":[],"mappings":";;AAKA,8BAKC;AARD,sDAAoE;AAGrD,KAAK,UAAU,WAAW,CACrC,OAAiC,EACjC,OAAwB;IAExB,OAAO,IAAI,wCAA2B,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACtE,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { PrismaValidateDtosValidator } from '@webpieces/code-rules';\nimport { PrismaValidateDtosConfig } from '@webpieces/rules-config';\n\nexport default async function runExecutor(\n    options: PrismaValidateDtosConfig,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return new PrismaValidateDtosValidator(options).run(context.root);\n}\n"]}
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-dtos/executor.ts"],"names":[],"mappings":";;AAKA,8BAKC;AARD,sDAAoE;AAGrD,KAAK,UAAU,WAAW,CACrC,OAAiC,EACjC,OAAwB;IAExB,OAAO,IAAI,wCAA2B,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACtE,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { PrismaValidateDtosValidator } from '@webpieces/code-rules';\nimport { PrismaValidateDtosConfig } from \"@webpieces/code-rules\";\n\nexport default async function runExecutor(\n    options: PrismaValidateDtosConfig,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return new PrismaValidateDtosValidator(options).run(context.root);\n}\n"]}

package/src/executors/validate-modified-files/executor.d.ts

@@ -1,4 +1,4 @@
 import type { ExecutorContext } from '@nx/devkit';
 import { ExecutorResult } from '../../executor-result';
-import { MaxFileLinesConfig } from '@webpieces/rules-config';
+import { MaxFileLinesConfig } from "@webpieces/code-rules";
 export default function runExecutor(options: MaxFileLinesConfig, context: ExecutorContext): Promise<ExecutorResult>;

package/src/executors/validate-modified-files/executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-modified-files/executor.ts"],"names":[],"mappings":";;AAKA,8BAKC;AARD,sDAA8D;AAG/C,KAAK,UAAU,WAAW,CACrC,OAA2B,EAC3B,OAAwB;IAExB,OAAO,IAAI,kCAAqB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { MaxFileLinesValidator } from '@webpieces/code-rules';\nimport { MaxFileLinesConfig } from '@webpieces/rules-config';\n\nexport default async function runExecutor(\n    options: MaxFileLinesConfig,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return new MaxFileLinesValidator(options).run(context.root);\n}\n"]}
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-modified-files/executor.ts"],"names":[],"mappings":";;AAKA,8BAKC;AARD,sDAA8D;AAG/C,KAAK,UAAU,WAAW,CACrC,OAA2B,EAC3B,OAAwB;IAExB,OAAO,IAAI,kCAAqB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { MaxFileLinesValidator } from '@webpieces/code-rules';\nimport { MaxFileLinesConfig } from \"@webpieces/code-rules\";\n\nexport default async function runExecutor(\n    options: MaxFileLinesConfig,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return new MaxFileLinesValidator(options).run(context.root);\n}\n"]}

package/src/executors/validate-modified-methods/executor.d.ts

@@ -1,4 +1,4 @@
 import type { ExecutorContext } from '@nx/devkit';
 import { ExecutorResult } from '../../executor-result';
-import { MaxMethodLinesConfig } from '@webpieces/rules-config';
+import { MaxMethodLinesConfig } from "@webpieces/code-rules";
 export default function runExecutor(options: MaxMethodLinesConfig, context: ExecutorContext): Promise<ExecutorResult>;

package/src/executors/validate-modified-methods/executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-modified-methods/executor.ts"],"names":[],"mappings":";;AAKA,8BAKC;AARD,sDAA2D;AAG5C,KAAK,UAAU,WAAW,CACrC,OAA6B,EAC7B,OAAwB;IAExB,OAAO,IAAA,+BAAkB,EAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AACrD,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { runModifiedMethods } from '@webpieces/code-rules';\nimport { MaxMethodLinesConfig } from '@webpieces/rules-config';\n\nexport default async function runExecutor(\n    options: MaxMethodLinesConfig,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return runModifiedMethods(options, context.root);\n}\n"]}
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-modified-methods/executor.ts"],"names":[],"mappings":";;AAKA,8BAKC;AARD,sDAA2D;AAG5C,KAAK,UAAU,WAAW,CACrC,OAA6B,EAC7B,OAAwB;IAExB,OAAO,IAAA,+BAAkB,EAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AACrD,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { runModifiedMethods } from '@webpieces/code-rules';\nimport { MaxMethodLinesConfig } from \"@webpieces/code-rules\";\n\nexport default async function runExecutor(\n    options: MaxMethodLinesConfig,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return runModifiedMethods(options, context.root);\n}\n"]}

package/src/executors/validate-new-methods/executor.d.ts

@@ -1,4 +1,4 @@
 import type { ExecutorContext } from '@nx/devkit';
 import { ExecutorResult } from '../../executor-result';
-import { MaxMethodLinesConfig } from '@webpieces/rules-config';
+import { MaxMethodLinesConfig } from "@webpieces/code-rules";
 export default function runExecutor(options: MaxMethodLinesConfig, context: ExecutorContext): Promise<ExecutorResult>;

package/src/executors/validate-new-methods/executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-new-methods/executor.ts"],"names":[],"mappings":";;AAKA,8BAKC;AARD,sDAAsD;AAGvC,KAAK,UAAU,WAAW,CACrC,OAA6B,EAC7B,OAAwB;IAExB,OAAO,IAAA,0BAAa,EAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AAChD,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { runNewMethods } from '@webpieces/code-rules';\nimport { MaxMethodLinesConfig } from '@webpieces/rules-config';\n\nexport default async function runExecutor(\n    options: MaxMethodLinesConfig,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return runNewMethods(options, context.root);\n}\n"]}
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-new-methods/executor.ts"],"names":[],"mappings":";;AAKA,8BAKC;AARD,sDAAsD;AAGvC,KAAK,UAAU,WAAW,CACrC,OAA6B,EAC7B,OAAwB;IAExB,OAAO,IAAA,0BAAa,EAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AAChD,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { runNewMethods } from '@webpieces/code-rules';\nimport { MaxMethodLinesConfig } from \"@webpieces/code-rules\";\n\nexport default async function runExecutor(\n    options: MaxMethodLinesConfig,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return runNewMethods(options, context.root);\n}\n"]}

package/src/executors/validate-no-any-unknown/executor.d.ts

@@ -1,4 +1,4 @@
 import type { ExecutorContext } from '@nx/devkit';
 import { ExecutorResult } from '../../executor-result';
-import { NoAnyUnknownConfig } from '@webpieces/rules-config';
+import { NoAnyUnknownConfig } from "@webpieces/code-rules";
 export default function runExecutor(options: NoAnyUnknownConfig, context: ExecutorContext): Promise<ExecutorResult>;

package/src/executors/validate-no-any-unknown/executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-no-any-unknown/executor.ts"],"names":[],"mappings":";;AAKA,8BAKC;AARD,sDAA6E;AAG9D,KAAK,UAAU,WAAW,CACrC,OAA2B,EAC3B,OAAwB;IAExB,OAAO,IAAI,kCAAqB,CAAC,OAAO,EAAE,IAAI,0BAAa,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACrF,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { NoAnyUnknownValidator, GateScanScope } from '@webpieces/code-rules';\nimport { NoAnyUnknownConfig } from '@webpieces/rules-config';\n\nexport default async function runExecutor(\n    options: NoAnyUnknownConfig,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return new NoAnyUnknownValidator(options, new GateScanScope()).run(context.root);\n}\n"]}
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-no-any-unknown/executor.ts"],"names":[],"mappings":";;AAKA,8BAKC;AARD,sDAA6E;AAG9D,KAAK,UAAU,WAAW,CACrC,OAA2B,EAC3B,OAAwB;IAExB,OAAO,IAAI,kCAAqB,CAAC,OAAO,EAAE,IAAI,0BAAa,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACrF,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { NoAnyUnknownValidator, GateScanScope } from '@webpieces/code-rules';\nimport { NoAnyUnknownConfig } from \"@webpieces/code-rules\";\n\nexport default async function runExecutor(\n    options: NoAnyUnknownConfig,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return new NoAnyUnknownValidator(options, new GateScanScope()).run(context.root);\n}\n"]}

package/src/executors/validate-no-destructure/executor.d.ts

@@ -1,4 +1,4 @@
 import type { ExecutorContext } from '@nx/devkit';
 import { ExecutorResult } from '../../executor-result';
-import { NoDestructureConfig } from '@webpieces/rules-config';
+import { NoDestructureConfig } from "@webpieces/code-rules";
 export default function runExecutor(options: NoDestructureConfig, context: ExecutorContext): Promise<ExecutorResult>;

package/src/executors/validate-no-destructure/executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-no-destructure/executor.ts"],"names":[],"mappings":";;AAKA,8BAKC;AARD,sDAA8E;AAG/D,KAAK,UAAU,WAAW,CACrC,OAA4B,EAC5B,OAAwB;IAExB,OAAO,IAAI,mCAAsB,CAAC,OAAO,EAAE,IAAI,0BAAa,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACtF,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { NoDestructureValidator, GateScanScope } from '@webpieces/code-rules';\nimport { NoDestructureConfig } from '@webpieces/rules-config';\n\nexport default async function runExecutor(\n    options: NoDestructureConfig,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return new NoDestructureValidator(options, new GateScanScope()).run(context.root);\n}\n"]}
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-no-destructure/executor.ts"],"names":[],"mappings":";;AAKA,8BAKC;AARD,sDAA8E;AAG/D,KAAK,UAAU,WAAW,CACrC,OAA4B,EAC5B,OAAwB;IAExB,OAAO,IAAI,mCAAsB,CAAC,OAAO,EAAE,IAAI,0BAAa,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACtF,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { NoDestructureValidator, GateScanScope } from '@webpieces/code-rules';\nimport { NoDestructureConfig } from \"@webpieces/code-rules\";\n\nexport default async function runExecutor(\n    options: NoDestructureConfig,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return new NoDestructureValidator(options, new GateScanScope()).run(context.root);\n}\n"]}

package/src/executors/validate-no-direct-api-resolver/executor.d.ts

@@ -1,4 +1,4 @@
 import type { ExecutorContext } from '@nx/devkit';
 import { ExecutorResult } from '../../executor-result';
-import { AngularNoDirectApiInResolverConfig } from '@webpieces/rules-config';
+import { AngularNoDirectApiInResolverConfig } from "@webpieces/code-rules";
 export default function runExecutor(options: AngularNoDirectApiInResolverConfig, context: ExecutorContext): Promise<ExecutorResult>;

package/src/executors/validate-no-direct-api-resolver/executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-no-direct-api-resolver/executor.ts"],"names":[],"mappings":";;AAKA,8BAKC;AARD,sDAAqE;AAGtD,KAAK,UAAU,WAAW,CACrC,OAA2C,EAC3C,OAAwB;IAExB,OAAO,IAAI,yCAA4B,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACvE,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { NoDirectApiResolverValidator } from '@webpieces/code-rules';\nimport { AngularNoDirectApiInResolverConfig } from '@webpieces/rules-config';\n\nexport default async function runExecutor(\n    options: AngularNoDirectApiInResolverConfig,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return new NoDirectApiResolverValidator(options).run(context.root);\n}\n"]}
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-no-direct-api-resolver/executor.ts"],"names":[],"mappings":";;AAKA,8BAKC;AARD,sDAAqE;AAGtD,KAAK,UAAU,WAAW,CACrC,OAA2C,EAC3C,OAAwB;IAExB,OAAO,IAAI,yCAA4B,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACvE,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { NoDirectApiResolverValidator } from '@webpieces/code-rules';\nimport { AngularNoDirectApiInResolverConfig } from \"@webpieces/code-rules\";\n\nexport default async function runExecutor(\n    options: AngularNoDirectApiInResolverConfig,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return new NoDirectApiResolverValidator(options).run(context.root);\n}\n"]}

package/src/executors/validate-no-implicit-any/executor.d.ts

@@ -1,4 +1,4 @@
 import type { ExecutorContext } from '@nx/devkit';
 import { ExecutorResult } from '../../executor-result';
-import { NoImplicitAnyConfig } from '@webpieces/rules-config';
+import { NoImplicitAnyConfig } from "@webpieces/code-rules";
 export default function runExecutor(options: NoImplicitAnyConfig, context: ExecutorContext): Promise<ExecutorResult>;

package/src/executors/validate-no-implicit-any/executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-no-implicit-any/executor.ts"],"names":[],"mappings":";;AAKA,8BAKC;AARD,sDAA8E;AAG/D,KAAK,UAAU,WAAW,CACrC,OAA4B,EAC5B,OAAwB;IAExB,OAAO,IAAI,mCAAsB,CAAC,OAAO,EAAE,IAAI,0BAAa,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACtF,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { NoImplicitAnyValidator, GateScanScope } from '@webpieces/code-rules';\nimport { NoImplicitAnyConfig } from '@webpieces/rules-config';\n\nexport default async function runExecutor(\n    options: NoImplicitAnyConfig,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return new NoImplicitAnyValidator(options, new GateScanScope()).run(context.root);\n}\n"]}
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-no-implicit-any/executor.ts"],"names":[],"mappings":";;AAKA,8BAKC;AARD,sDAA8E;AAG/D,KAAK,UAAU,WAAW,CACrC,OAA4B,EAC5B,OAAwB;IAExB,OAAO,IAAI,mCAAsB,CAAC,OAAO,EAAE,IAAI,0BAAa,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACtF,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { NoImplicitAnyValidator, GateScanScope } from '@webpieces/code-rules';\nimport { NoImplicitAnyConfig } from \"@webpieces/code-rules\";\n\nexport default async function runExecutor(\n    options: NoImplicitAnyConfig,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return new NoImplicitAnyValidator(options, new GateScanScope()).run(context.root);\n}\n"]}

package/src/executors/validate-no-inline-types/executor.d.ts

@@ -1,4 +1,4 @@
 import type { ExecutorContext } from '@nx/devkit';
 import { ExecutorResult } from '../../executor-result';
-import { NoInlineTypeLiteralsConfig } from '@webpieces/rules-config';
+import { NoInlineTypeLiteralsConfig } from "@webpieces/code-rules";
 export default function runExecutor(options: NoInlineTypeLiteralsConfig, context: ExecutorContext): Promise<ExecutorResult>;

package/src/executors/validate-no-inline-types/executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-no-inline-types/executor.ts"],"names":[],"mappings":";;AAKA,8BAKC;AARD,sDAAsE;AAGvD,KAAK,UAAU,WAAW,CACrC,OAAmC,EACnC,OAAwB;IAExB,OAAO,IAAI,0CAA6B,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACxE,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { NoInlineTypeLiteralsValidator } from '@webpieces/code-rules';\nimport { NoInlineTypeLiteralsConfig } from '@webpieces/rules-config';\n\nexport default async function runExecutor(\n    options: NoInlineTypeLiteralsConfig,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return new NoInlineTypeLiteralsValidator(options).run(context.root);\n}\n"]}
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-no-inline-types/executor.ts"],"names":[],"mappings":";;AAKA,8BAKC;AARD,sDAAsE;AAGvD,KAAK,UAAU,WAAW,CACrC,OAAmC,EACnC,OAAwB;IAExB,OAAO,IAAI,0CAA6B,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACxE,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { NoInlineTypeLiteralsValidator } from '@webpieces/code-rules';\nimport { NoInlineTypeLiteralsConfig } from \"@webpieces/code-rules\";\n\nexport default async function runExecutor(\n    options: NoInlineTypeLiteralsConfig,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return new NoInlineTypeLiteralsValidator(options).run(context.root);\n}\n"]}

package/src/executors/validate-no-unmanaged-exceptions/executor.d.ts

@@ -1,4 +1,4 @@
 import type { ExecutorContext } from '@nx/devkit';
 import { ExecutorResult } from '../../executor-result';
-import { NoUnmanagedExceptionsConfig } from '@webpieces/rules-config';
+import { NoUnmanagedExceptionsConfig } from "@webpieces/code-rules";
 export default function runExecutor(options: NoUnmanagedExceptionsConfig, context: ExecutorContext): Promise<ExecutorResult>;

package/src/executors/validate-no-unmanaged-exceptions/executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-no-unmanaged-exceptions/executor.ts"],"names":[],"mappings":";;AAKA,8BAKC;AARD,sDAAsF;AAGvE,KAAK,UAAU,WAAW,CACrC,OAAoC,EACpC,OAAwB;IAExB,OAAO,IAAI,2CAA8B,CAAC,OAAO,EAAE,IAAI,0BAAa,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC9F,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { NoUnmanagedExceptionsValidator, GateScanScope } from '@webpieces/code-rules';\nimport { NoUnmanagedExceptionsConfig } from '@webpieces/rules-config';\n\nexport default async function runExecutor(\n    options: NoUnmanagedExceptionsConfig,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return new NoUnmanagedExceptionsValidator(options, new GateScanScope()).run(context.root);\n}\n"]}
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-no-unmanaged-exceptions/executor.ts"],"names":[],"mappings":";;AAKA,8BAKC;AARD,sDAAsF;AAGvE,KAAK,UAAU,WAAW,CACrC,OAAoC,EACpC,OAAwB;IAExB,OAAO,IAAI,2CAA8B,CAAC,OAAO,EAAE,IAAI,0BAAa,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC9F,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { NoUnmanagedExceptionsValidator, GateScanScope } from '@webpieces/code-rules';\nimport { NoUnmanagedExceptionsConfig } from \"@webpieces/code-rules\";\n\nexport default async function runExecutor(\n    options: NoUnmanagedExceptionsConfig,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return new NoUnmanagedExceptionsValidator(options, new GateScanScope()).run(context.root);\n}\n"]}

package/src/executors/validate-prisma-converters/executor.d.ts

@@ -1,4 +1,4 @@
 import type { ExecutorContext } from '@nx/devkit';
 import { ExecutorResult } from '../../executor-result';
-import { PrismaConverterConfig } from '@webpieces/rules-config';
+import { PrismaConverterConfig } from "@webpieces/code-rules";
 export default function runExecutor(options: PrismaConverterConfig, context: ExecutorContext): Promise<ExecutorResult>;

package/src/executors/validate-prisma-converters/executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-prisma-converters/executor.ts"],"names":[],"mappings":";;AAKA,8BAKC;AARD,sDAAiE;AAGlD,KAAK,UAAU,WAAW,CACrC,OAA8B,EAC9B,OAAwB;IAExB,OAAO,IAAI,qCAAwB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACnE,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { PrismaConverterValidator } from '@webpieces/code-rules';\nimport { PrismaConverterConfig } from '@webpieces/rules-config';\n\nexport default async function runExecutor(\n    options: PrismaConverterConfig,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return new PrismaConverterValidator(options).run(context.root);\n}\n"]}
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-prisma-converters/executor.ts"],"names":[],"mappings":";;AAKA,8BAKC;AARD,sDAAiE;AAGlD,KAAK,UAAU,WAAW,CACrC,OAA8B,EAC9B,OAAwB;IAExB,OAAO,IAAI,qCAAwB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACnE,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { PrismaConverterValidator } from '@webpieces/code-rules';\nimport { PrismaConverterConfig } from \"@webpieces/code-rules\";\n\nexport default async function runExecutor(\n    options: PrismaConverterConfig,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return new PrismaConverterValidator(options).run(context.root);\n}\n"]}

package/src/executors/validate-return-types/executor.d.ts

@@ -1,4 +1,4 @@
 import type { ExecutorContext } from '@nx/devkit';
 import { ExecutorResult } from '../../executor-result';
-import { RequireReturnTypeConfig } from '@webpieces/rules-config';
+import { RequireReturnTypeConfig } from "@webpieces/code-rules";
 export default function runExecutor(options: RequireReturnTypeConfig, context: ExecutorContext): Promise<ExecutorResult>;

package/src/executors/validate-return-types/executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-return-types/executor.ts"],"names":[],"mappings":";;AAKA,8BAKC;AARD,sDAAmE;AAGpD,KAAK,UAAU,WAAW,CACrC,OAAgC,EAChC,OAAwB;IAExB,OAAO,IAAI,uCAA0B,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACrE,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { RequireReturnTypeValidator } from '@webpieces/code-rules';\nimport { RequireReturnTypeConfig } from '@webpieces/rules-config';\n\nexport default async function runExecutor(\n    options: RequireReturnTypeConfig,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return new RequireReturnTypeValidator(options).run(context.root);\n}\n"]}
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-return-types/executor.ts"],"names":[],"mappings":";;AAKA,8BAKC;AARD,sDAAmE;AAGpD,KAAK,UAAU,WAAW,CACrC,OAAgC,EAChC,OAAwB;IAExB,OAAO,IAAI,uCAA0B,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACrE,CAAC","sourcesContent":["import type { ExecutorContext } from '@nx/devkit';\nimport { ExecutorResult } from '../../executor-result';\nimport { RequireReturnTypeValidator } from '@webpieces/code-rules';\nimport { RequireReturnTypeConfig } from \"@webpieces/code-rules\";\n\nexport default async function runExecutor(\n    options: RequireReturnTypeConfig,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    return new RequireReturnTypeValidator(options).run(context.root);\n}\n"]}

package/src/index.d.ts

@@ -19,3 +19,9 @@ declare const _default: {
     createNodesV2: import("@nx/devkit").CreateNodesV2<import("./plugin").ArchitecturePluginOptions>;
 };
 export default _default;
+export { STRUCTURAL_MODES, NoFileImportCyclesConfig, RuntimeArchitectureConfig, NxWiringConfig, DiGraphConfig, MissingDesignAnnotationConfig, ValidateArchitectureUnchangedConfig, ValidateNoArchitectureCyclesConfig, ValidatePackageJsonConfig, ValidateVersionsLockedConfig, ValidateEslintSyncConfig } from './configs/rule-configs';
+export type { StructuralMode } from './configs/rule-configs';
+export { NoRootUnionApiTypeConfig } from './configs/no-root-union-config';
+export { API_DOC_MODES, ApiRulesForOpenApiConfig, ApiRulesForMcpConfig } from './configs/api-doc-rules-config';
+export type { ApiDocMode } from './configs/api-doc-rules-config';
+export { ApiClientPackagesEntry, ApiLibDependenciesConfig, ApiLibPathConfig, FrameworkFolderEntry, FrameworkFolderConfig } from './configs/tag-truth-configs';

package/src/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createNodesV2 = void 0;
+exports.FrameworkFolderConfig = exports.FrameworkFolderEntry = exports.ApiLibPathConfig = exports.ApiLibDependenciesConfig = exports.ApiClientPackagesEntry = exports.ApiRulesForMcpConfig = exports.ApiRulesForOpenApiConfig = exports.API_DOC_MODES = exports.NoRootUnionApiTypeConfig = exports.ValidateEslintSyncConfig = exports.ValidateVersionsLockedConfig = exports.ValidatePackageJsonConfig = exports.ValidateNoArchitectureCyclesConfig = exports.ValidateArchitectureUnchangedConfig = exports.MissingDesignAnnotationConfig = exports.DiGraphConfig = exports.NxWiringConfig = exports.RuntimeArchitectureConfig = exports.NoFileImportCyclesConfig = exports.STRUCTURAL_MODES = exports.createNodesV2 = void 0;
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./lib/graph-generator"), exports);
 tslib_1.__exportStar(require("./lib/graph-sorter"), exports);
@@ -19,4 +19,28 @@ tslib_1.__exportStar(require("./lib/di-graph/design-finder"), exports);
 const plugin_1 = require("./plugin");
 Object.defineProperty(exports, "createNodesV2", { enumerable: true, get: function () { return plugin_1.createNodesV2; } });
 exports.default = { name: '@webpieces/nx-webpieces-rules', createNodesV2: plugin_1.createNodesV2 };
+var rule_configs_1 = require("./configs/rule-configs");
+Object.defineProperty(exports, "STRUCTURAL_MODES", { enumerable: true, get: function () { return rule_configs_1.STRUCTURAL_MODES; } });
+Object.defineProperty(exports, "NoFileImportCyclesConfig", { enumerable: true, get: function () { return rule_configs_1.NoFileImportCyclesConfig; } });
+Object.defineProperty(exports, "RuntimeArchitectureConfig", { enumerable: true, get: function () { return rule_configs_1.RuntimeArchitectureConfig; } });
+Object.defineProperty(exports, "NxWiringConfig", { enumerable: true, get: function () { return rule_configs_1.NxWiringConfig; } });
+Object.defineProperty(exports, "DiGraphConfig", { enumerable: true, get: function () { return rule_configs_1.DiGraphConfig; } });
+Object.defineProperty(exports, "MissingDesignAnnotationConfig", { enumerable: true, get: function () { return rule_configs_1.MissingDesignAnnotationConfig; } });
+Object.defineProperty(exports, "ValidateArchitectureUnchangedConfig", { enumerable: true, get: function () { return rule_configs_1.ValidateArchitectureUnchangedConfig; } });
+Object.defineProperty(exports, "ValidateNoArchitectureCyclesConfig", { enumerable: true, get: function () { return rule_configs_1.ValidateNoArchitectureCyclesConfig; } });
+Object.defineProperty(exports, "ValidatePackageJsonConfig", { enumerable: true, get: function () { return rule_configs_1.ValidatePackageJsonConfig; } });
+Object.defineProperty(exports, "ValidateVersionsLockedConfig", { enumerable: true, get: function () { return rule_configs_1.ValidateVersionsLockedConfig; } });
+Object.defineProperty(exports, "ValidateEslintSyncConfig", { enumerable: true, get: function () { return rule_configs_1.ValidateEslintSyncConfig; } });
+var no_root_union_config_1 = require("./configs/no-root-union-config");
+Object.defineProperty(exports, "NoRootUnionApiTypeConfig", { enumerable: true, get: function () { return no_root_union_config_1.NoRootUnionApiTypeConfig; } });
+var api_doc_rules_config_1 = require("./configs/api-doc-rules-config");
+Object.defineProperty(exports, "API_DOC_MODES", { enumerable: true, get: function () { return api_doc_rules_config_1.API_DOC_MODES; } });
+Object.defineProperty(exports, "ApiRulesForOpenApiConfig", { enumerable: true, get: function () { return api_doc_rules_config_1.ApiRulesForOpenApiConfig; } });
+Object.defineProperty(exports, "ApiRulesForMcpConfig", { enumerable: true, get: function () { return api_doc_rules_config_1.ApiRulesForMcpConfig; } });
+var tag_truth_configs_1 = require("./configs/tag-truth-configs");
+Object.defineProperty(exports, "ApiClientPackagesEntry", { enumerable: true, get: function () { return tag_truth_configs_1.ApiClientPackagesEntry; } });
+Object.defineProperty(exports, "ApiLibDependenciesConfig", { enumerable: true, get: function () { return tag_truth_configs_1.ApiLibDependenciesConfig; } });
+Object.defineProperty(exports, "ApiLibPathConfig", { enumerable: true, get: function () { return tag_truth_configs_1.ApiLibPathConfig; } });
+Object.defineProperty(exports, "FrameworkFolderEntry", { enumerable: true, get: function () { return tag_truth_configs_1.FrameworkFolderEntry; } });
+Object.defineProperty(exports, "FrameworkFolderConfig", { enumerable: true, get: function () { return tag_truth_configs_1.FrameworkFolderConfig; } });
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/tooling/nx-webpieces-rules/src/index.ts"],"names":[],"mappings":";;;;AAAA,gEAAsC;AACtC,6DAAmC;AACnC,iEAAuC;AACvC,kEAAwC;AACxC,6DAAmC;AACnC,iEAAuC;AACvC,+DAAqC;AACrC,mEAAyC;AACzC,6EAAmD;AACnD,6DAAmC;AACnC,iEAAuC;AACvC,6DAAmC;AACnC,2EAAiD;AACjD,uEAA6C;AAC7C,qCAAyC;AAChC,8FADA,sBAAa,OACA;AACtB,kBAAe,EAAE,IAAI,EAAE,+BAA+B,EAAE,aAAa,EAAb,sBAAa,EAAE,CAAC","sourcesContent":["export * from './lib/graph-generator';\nexport * from './lib/graph-sorter';\nexport * from './lib/graph-comparator';\nexport * from './lib/package-validator';\nexport * from './lib/graph-loader';\nexport * from './lib/graph-visualizer';\nexport * from './lib/graph-metadata';\nexport * from './lib/framework-resolver';\nexport * from './lib/runtime-participant-resolver';\nexport * from './lib/project-info';\nexport * from './lib/responsibilities';\nexport * from './lib/di-graph/dot';\nexport * from './lib/di-graph/design-visualizer';\nexport * from './lib/di-graph/design-finder';\nimport { createNodesV2 } from './plugin';\nexport { createNodesV2 };\nexport default { name: '@webpieces/nx-webpieces-rules', createNodesV2 };\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/tooling/nx-webpieces-rules/src/index.ts"],"names":[],"mappings":";;;;AAAA,gEAAsC;AACtC,6DAAmC;AACnC,iEAAuC;AACvC,kEAAwC;AACxC,6DAAmC;AACnC,iEAAuC;AACvC,+DAAqC;AACrC,mEAAyC;AACzC,6EAAmD;AACnD,6DAAmC;AACnC,iEAAuC;AACvC,6DAAmC;AACnC,2EAAiD;AACjD,uEAA6C;AAC7C,qCAAyC;AAChC,8FADA,sBAAa,OACA;AACtB,kBAAe,EAAE,IAAI,EAAE,+BAA+B,EAAE,aAAa,EAAb,sBAAa,EAAE,CAAC;AAExE,uDAAyU;AAAhU,gHAAA,gBAAgB,OAAA;AAAE,wHAAA,wBAAwB,OAAA;AAAE,yHAAA,yBAAyB,OAAA;AAAE,8GAAA,cAAc,OAAA;AAAE,6GAAA,aAAa,OAAA;AAAE,6HAAA,6BAA6B,OAAA;AAAE,mIAAA,mCAAmC,OAAA;AAAE,kIAAA,kCAAkC,OAAA;AAAE,yHAAA,yBAAyB,OAAA;AAAE,4HAAA,4BAA4B,OAAA;AAAE,wHAAA,wBAAwB,OAAA;AAExS,uEAA0E;AAAjE,gIAAA,wBAAwB,OAAA;AACjC,uEAA+G;AAAtG,qHAAA,aAAa,OAAA;AAAE,gIAAA,wBAAwB,OAAA;AAAE,4HAAA,oBAAoB,OAAA;AAEtE,iEAA8J;AAArJ,2HAAA,sBAAsB,OAAA;AAAE,6HAAA,wBAAwB,OAAA;AAAE,qHAAA,gBAAgB,OAAA;AAAE,yHAAA,oBAAoB,OAAA;AAAE,0HAAA,qBAAqB,OAAA","sourcesContent":["export * from './lib/graph-generator';\nexport * from './lib/graph-sorter';\nexport * from './lib/graph-comparator';\nexport * from './lib/package-validator';\nexport * from './lib/graph-loader';\nexport * from './lib/graph-visualizer';\nexport * from './lib/graph-metadata';\nexport * from './lib/framework-resolver';\nexport * from './lib/runtime-participant-resolver';\nexport * from './lib/project-info';\nexport * from './lib/responsibilities';\nexport * from './lib/di-graph/dot';\nexport * from './lib/di-graph/design-visualizer';\nexport * from './lib/di-graph/design-finder';\nimport { createNodesV2 } from './plugin';\nexport { createNodesV2 };\nexport default { name: '@webpieces/nx-webpieces-rules', createNodesV2 };\n\nexport { STRUCTURAL_MODES, NoFileImportCyclesConfig, RuntimeArchitectureConfig, NxWiringConfig, DiGraphConfig, MissingDesignAnnotationConfig, ValidateArchitectureUnchangedConfig, ValidateNoArchitectureCyclesConfig, ValidatePackageJsonConfig, ValidateVersionsLockedConfig, ValidateEslintSyncConfig } from './configs/rule-configs';\nexport type { StructuralMode } from './configs/rule-configs';\nexport { NoRootUnionApiTypeConfig } from './configs/no-root-union-config';\nexport { API_DOC_MODES, ApiRulesForOpenApiConfig, ApiRulesForMcpConfig } from './configs/api-doc-rules-config';\nexport type { ApiDocMode } from './configs/api-doc-rules-config';\nexport { ApiClientPackagesEntry, ApiLibDependenciesConfig, ApiLibPathConfig, FrameworkFolderEntry, FrameworkFolderConfig } from './configs/tag-truth-configs';\n"]}

package/src/lib/api-usage/api-doc-rules.d.ts

@@ -6,8 +6,8 @@
  * config is read exactly once per executor run.
  */
 /** As written in a disable comment and as a config key. */
-export declare const OPENAPI_RULE: "api-rules-for-openapi";
-export declare const MCP_RULE: "api-rules-for-mcp";
+export declare const OPENAPI_RULE = "api-rules-for-openapi";
+export declare const MCP_RULE = "api-rules-for-mcp";
 /** The `@ApiType` value that means "a partner reads this document". */
 export declare const EXTERNAL_CUSTOMER_API_TYPE = "external-customer";
 /**

package/src/lib/api-usage/api-doc-rules.js

@@ -13,8 +13,8 @@ const fs = tslib_1.__importStar(require("fs"));
 const rules_config_1 = require("@webpieces/rules-config");
 const rule_gate_1 = require("../rule-gate");
 /** As written in a disable comment and as a config key. */
-exports.OPENAPI_RULE = rules_config_1.RULE_NAMES.API_RULES_FOR_OPENAPI;
-exports.MCP_RULE = rules_config_1.RULE_NAMES.API_RULES_FOR_MCP;
+exports.OPENAPI_RULE = "api-rules-for-openapi";
+exports.MCP_RULE = "api-rules-for-mcp";
 /** The `@ApiType` value that means "a partner reads this document". */
 exports.EXTERNAL_CUSTOMER_API_TYPE = 'external-customer';
 /**

package/src/lib/api-usage/api-doc-rules.js.map

@@ -1 +1 @@
-{"version":3,"file":"api-doc-rules.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/lib/api-usage/api-doc-rules.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The DATA and the SWITCHES of `api-rules-for-openapi` and `api-rules-for-mcp` (#1011).\n *\n * The scan itself is in `api-doc-rules-scan.ts`; this file holds what a caller reads back and the\n * per-rule config, so a unit test can construct either without touching a config file and so the\n * config is read exactly once per executor run.\n */\n\nimport * as fs from 'fs';\nimport {\n    ChangedFilesOptions,\n    DiffScope,\n    loadAndValidate,\n    matchesAnyGlob,\n    RULE_NAMES,\n    WEBPIECES_DISABLE,\n} from '@webpieces/rules-config';\nimport { RuleGate } from '../rule-gate';\n\n/** As written in a disable comment and as a config key. */\nexport const OPENAPI_RULE = RULE_NAMES.API_RULES_FOR_OPENAPI;\nexport const MCP_RULE = RULE_NAMES.API_RULES_FOR_MCP;\n\n/** The `@ApiType` value that means \"a partner reads this document\". */\nexport const EXTERNAL_CUSTOMER_API_TYPE = 'external-customer';\n\n/**\n * `// webpieces-disable <rule>[, <rule2>] -- <reason>`, with the reason CAPTURED so a reasonless\n * disable can be told apart from an absent one. Identical to the spelling `root-union-scan` reads.\n */\nconst DISABLE_RE = new RegExp(\n    `//\\\\s*${WEBPIECES_DISABLE}\\\\s+([\\\\w-]+(?:\\\\s*,\\\\s*[\\\\w-]+)*)(?:\\\\s*--\\\\s*(.*))?$`,\n);\n\n/** How far above a declaration a disable comment may sit before it is somebody else's comment. */\nconst DISABLE_LOOKBACK_LINES = 40;\n\n/**\n * ONE defect on ONE contract.\n *\n * `exposure` is the contract's `@ApiType` list, and it is carried rather than derived because the\n * SAME defect is louder on a contract that reaches `external-customer`: an unshaped field on a\n * partner document costs a partner something, where the same field on a service-to-service contract\n * costs a colleague a question. The refusal sorts and labels on it.\n */\nexport class ApiContractDefect {\n    constructor(\n        /** The `@ApiPath` contract class. */\n        public readonly api: string,\n        /** The `@Endpoint` method, or `''` for a contract-level or DTO-level defect. */\n        public readonly method: string,\n        /** What is wrong, in one line, naming the declaration. */\n        public readonly what: string,\n        /** `path/to/File.ts:LINE`, workspace-relative. */\n        public readonly at: string,\n        /** What to do instead, in one sentence. */\n        public readonly cure: string,\n        /** The contract's `@ApiType` list — `svc-to-svc` when it declares none. */\n        public readonly exposure: readonly string[],\n    ) {}\n\n    /** True when this contract feeds the PARTNER-facing document. */\n    isExternal(): boolean {\n        return this.exposure.includes(EXTERNAL_CUSTOMER_API_TYPE);\n    }\n\n    /** `Api.method` or `Api` — what a reader opens. */\n    where(): string {\n        return this.method === '' ? this.api : `${this.api}.${this.method}`;\n    }\n}\n\n/** What ONE rule found: real defects, and disables of it that gave no reason. */\nexport class ApiRuleFindings {\n    constructor(\n        public readonly violations: readonly ApiContractDefect[],\n        /**\n         * Sites that named this rule in a disable and wrote no reason. A reasonless disable is\n         * itself a violation: the point of the per-site hatch is the ARGUMENT, which is the only\n         * part the next reader can weigh.\n         */\n        public readonly reasonlessDisables: readonly ApiContractDefect[],\n    ) {}\n\n    isEmpty(): boolean {\n        return this.violations.length === 0 && this.reasonlessDisables.length === 0;\n    }\n}\n\n/**\n * ONE endpoint declared PERMANENTLY outside MCP by `@InvalidEndpointForMcp('<reason>')` (#1014).\n *\n * Not a violation and not a suppression — a DECLARATION, which is why it is carried beside the\n * findings rather than in them. `api-rules-for-mcp` restates the whole list, with reasons, on every\n * run: an exclusion announced once at the moment somebody added it is an exclusion nobody will read\n * again, and a build-time warning at add time would be read exactly as little.\n */\nexport class McpExclusion {\n    constructor(\n        public readonly api: string,\n        public readonly method: string,\n        /** The decorator's reason, verbatim. Empty only when the argument could not be folded. */\n        public readonly reason: string,\n        /** `path/to/File.ts:LINE`, workspace-relative. */\n        public readonly at: string,\n    ) {}\n}\n\n/** Both rules' findings from ONE scan — one program build, two verdicts. */\nexport class ApiDocRulesFindings {\n    constructor(\n        public readonly openApi: ApiRuleFindings,\n        public readonly mcp: ApiRuleFindings,\n        /** Every `@InvalidEndpointForMcp` endpoint the MCP rule looked at, in declaration order. */\n        public readonly mcpExclusions: readonly McpExclusion[] = [],\n    ) {}\n\n    // webpieces-disable no-function-outside-class -- static factory of this class\n    static empty(): ApiDocRulesFindings {\n        return new ApiDocRulesFindings(\n            new ApiRuleFindings([], []),\n            new ApiRuleFindings([], []),\n            [],\n        );\n    }\n}\n\n/** The mode value that narrows the scan to the projects the diff touched. */\nexport const AFFECTED_PROJECT_MODE = 'AFFECTED_PROJECT';\n\n/**\n * ONE rule's switches, resolved from webpieces.config.json once per scan.\n *\n * There is NO default (#1017). Both rules are schema'd, so `webpieces.config.json` must carry an\n * entry for each or the config FAILS TO LOAD naming them — a consumer states `OFF`,\n * `AFFECTED_PROJECT` or `RUN_EVERY_TIME` out loud. The `off()` a bare constructor or a unit test\n * gets is not a default; it is what a caller that configured nothing asked for.\n */\nexport class ApiDocRule {\n    constructor(\n        public readonly name: string,\n        public readonly enabled: boolean,\n        /** Project roots this rule does not apply to — `allowedPaths` in the config. */\n        public readonly allowedPaths: readonly string[],\n        /**\n         * Workspace-relative paths the diff touched, under `AFFECTED_PROJECT`; `null` under\n         * `RUN_EVERY_TIME`, which means every project is in scope.\n         *\n         * `null` is also what an UNCOMPUTABLE diff resolves to — no merge-base, a shallow clone, no\n         * repository at all. A diff that could not be read is not evidence that nothing changed, and\n         * the only safe reading of \"I do not know what changed\" is \"look at all of it\".\n         */\n        public readonly changedPaths: readonly string[] | null = null,\n    ) {}\n\n    /** ARMED over every project — what a unit test constructs, and what RUN_EVERY_TIME resolves to. */\n    // webpieces-disable no-function-outside-class -- static factory of this class\n    static armed(name: string): ApiDocRule {\n        return new ApiDocRule(name, true, [], null);\n    }\n\n    /** ARMED over the projects owning one of `changedPaths` — what AFFECTED_PROJECT resolves to. */\n    // webpieces-disable no-function-outside-class -- static factory of this class\n    static affected(name: string, changedPaths: readonly string[]): ApiDocRule {\n        return new ApiDocRule(name, true, [], changedPaths);\n    }\n\n    // webpieces-disable no-function-outside-class -- static factory of this class\n    static off(name: string): ApiDocRule {\n        return new ApiDocRule(name, false, [], null);\n    }\n\n    /**\n     * True when this rule scans the contracts of the project rooted at `root`.\n     *\n     * ONE place answers it, for both rules, so `allowedPaths` and the affected-project narrowing can\n     * never be applied by one caller and skipped by another.\n     */\n    coversProject(root: string): boolean {\n        if (!this.enabled) return false;\n        if (matchesAnyGlob(root, this.allowedPaths)) return false;\n        if (this.changedPaths === null) return true;\n        const prefix = `${root}/`;\n        return this.changedPaths.some((each: string): boolean => each.startsWith(prefix));\n    }\n\n    /** `mode: OFF` and the time-box/branch hatches come from RuleGate, so there is ONE reading. */\n    // webpieces-disable no-function-outside-class -- static factory of this class\n    static fromConfig(workspaceRoot: string, name: string): ApiDocRule {\n        if (new RuleGate().isDisabled(workspaceRoot, name, true)) {\n            return ApiDocRule.off(name);\n        }\n        const rule = loadAndValidate(workspaceRoot).resolved.rules.get(name);\n        const allowed = rule?.options['allowedPaths'];\n        const allowedPaths = Array.isArray(allowed) ? (allowed as string[]) : [];\n        const affected =\n            rule?.options['mode'] === AFFECTED_PROJECT_MODE\n                ? ApiDocRule.changedPathsOf(workspaceRoot)\n                : null;\n        return new ApiDocRule(name, true, allowedPaths, affected);\n    }\n\n    /**\n     * Every path the diff touched, against the base nx itself uses (`NX_BASE`, else the merge-base\n     * with origin/main). NOT ts-only and INCLUDING deletions: a deleted DTO changes what a project's\n     * contracts can express exactly as an added one does, and a `project.json` edit can change which\n     * project owns a contract at all.\n     */\n    // webpieces-disable no-function-outside-class -- private static reader of this class\n    private static changedPathsOf(workspaceRoot: string): readonly string[] | null {\n        const scope = new DiffScope();\n        const range = scope.resolveBase(workspaceRoot);\n        if (range.base === undefined) return null;\n        const opts = new ChangedFilesOptions();\n        opts.tsOnly = false;\n        opts.includeDeletions = true;\n        return scope.getChangedFiles(workspaceRoot, range.base, range.head, opts);\n    }\n}\n\n/** ONE `webpieces-disable` naming a rule, and whether it gave a reason. */\nexport class DisableComment {\n    constructor(public readonly hasReason: boolean) {}\n\n    /**\n     * The disable naming `rule` on the declaration at `line` (1-based) of `file`, or undefined.\n     *\n     * It walks UPWARD over the declaration's own leading trivia — blank lines, `//` comments, a\n     * JSDoc block, and the decorators between them — because that is where an author writes one, and\n     * it stops at the first line that is none of those, so a directive belonging to the PREVIOUS\n     * declaration can never be read as covering this one.\n     *\n     * Only a directive NAMING this rule counts. An existing `// webpieces-disable no-any-unknown`\n     * therefore does not silence these rules, which is the point: that rule answers \"is this\n     * type-safe?\" and these answer \"is this field PUBLISHED with no shape?\" — different questions\n     * with different right answers, so the second one wants its own, separately argued line.\n     *\n     * A file that cannot be read yields \"no disable\": a defect is still a defect, and inventing a\n     * suppression out of an I/O failure is the one wrong answer.\n     */\n    // webpieces-disable no-function-outside-class -- static factory of this class\n    static readAt(file: string, line: number, rule: string): DisableComment | undefined {\n        const lines = DisableComment.linesOf(file);\n        if (lines === undefined) return undefined;\n        const start = Math.max(0, line - 1);\n        const onDeclaration = DisableComment.match(lines[start] ?? '', rule);\n        if (onDeclaration !== undefined) return onDeclaration;\n        for (let i = start - 1; i >= 0 && i >= start - DISABLE_LOOKBACK_LINES; i--) {\n            const text = (lines[i] ?? '').trim();\n            const above = DisableComment.match(text, rule);\n            if (above !== undefined) return above;\n            if (!DisableComment.isTrivia(text)) return undefined;\n        }\n        return undefined;\n    }\n\n    /** Leading trivia a disable comment is allowed to sit above: blanks, comments and decorators. */\n    // webpieces-disable no-function-outside-class -- private static predicate of this class\n    private static isTrivia(text: string): boolean {\n        return (\n            text === '' ||\n            text.startsWith('//') ||\n            text.startsWith('*') ||\n            text.startsWith('/*') ||\n            text.startsWith('@')\n        );\n    }\n\n    // webpieces-disable no-function-outside-class -- private static reader of this class\n    private static match(text: string, rule: string): DisableComment | undefined {\n        const found = text.trim().match(DISABLE_RE);\n        if (found === null) return undefined;\n        const named = found[1].split(',').map((each: string): string => each.trim());\n        if (!named.includes(rule)) return undefined;\n        return new DisableComment((found[2] ?? '').trim() !== '');\n    }\n\n    /** The file's lines, or undefined when it cannot be read. */\n    // webpieces-disable no-function-outside-class -- private static reader of this class\n    private static linesOf(file: string): string[] | undefined {\n        if (!fs.existsSync(file)) return undefined;\n        return fs.readFileSync(file, 'utf8').split('\\n');\n    }\n}\n"]}
+{"version":3,"file":"api-doc-rules.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/lib/api-usage/api-doc-rules.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The DATA and the SWITCHES of `api-rules-for-openapi` and `api-rules-for-mcp` (#1011).\n *\n * The scan itself is in `api-doc-rules-scan.ts`; this file holds what a caller reads back and the\n * per-rule config, so a unit test can construct either without touching a config file and so the\n * config is read exactly once per executor run.\n */\n\nimport * as fs from 'fs';\nimport { ChangedFilesOptions, DiffScope, loadAndValidate, matchesAnyGlob, WEBPIECES_DISABLE } from '@webpieces/rules-config';\nimport { RuleGate } from '../rule-gate';\n\n/** As written in a disable comment and as a config key. */\nexport const OPENAPI_RULE = \"api-rules-for-openapi\";\nexport const MCP_RULE = \"api-rules-for-mcp\";\n\n/** The `@ApiType` value that means \"a partner reads this document\". */\nexport const EXTERNAL_CUSTOMER_API_TYPE = 'external-customer';\n\n/**\n * `// webpieces-disable <rule>[, <rule2>] -- <reason>`, with the reason CAPTURED so a reasonless\n * disable can be told apart from an absent one. Identical to the spelling `root-union-scan` reads.\n */\nconst DISABLE_RE = new RegExp(\n    `//\\\\s*${WEBPIECES_DISABLE}\\\\s+([\\\\w-]+(?:\\\\s*,\\\\s*[\\\\w-]+)*)(?:\\\\s*--\\\\s*(.*))?$`,\n);\n\n/** How far above a declaration a disable comment may sit before it is somebody else's comment. */\nconst DISABLE_LOOKBACK_LINES = 40;\n\n/**\n * ONE defect on ONE contract.\n *\n * `exposure` is the contract's `@ApiType` list, and it is carried rather than derived because the\n * SAME defect is louder on a contract that reaches `external-customer`: an unshaped field on a\n * partner document costs a partner something, where the same field on a service-to-service contract\n * costs a colleague a question. The refusal sorts and labels on it.\n */\nexport class ApiContractDefect {\n    constructor(\n        /** The `@ApiPath` contract class. */\n        public readonly api: string,\n        /** The `@Endpoint` method, or `''` for a contract-level or DTO-level defect. */\n        public readonly method: string,\n        /** What is wrong, in one line, naming the declaration. */\n        public readonly what: string,\n        /** `path/to/File.ts:LINE`, workspace-relative. */\n        public readonly at: string,\n        /** What to do instead, in one sentence. */\n        public readonly cure: string,\n        /** The contract's `@ApiType` list — `svc-to-svc` when it declares none. */\n        public readonly exposure: readonly string[],\n    ) {}\n\n    /** True when this contract feeds the PARTNER-facing document. */\n    isExternal(): boolean {\n        return this.exposure.includes(EXTERNAL_CUSTOMER_API_TYPE);\n    }\n\n    /** `Api.method` or `Api` — what a reader opens. */\n    where(): string {\n        return this.method === '' ? this.api : `${this.api}.${this.method}`;\n    }\n}\n\n/** What ONE rule found: real defects, and disables of it that gave no reason. */\nexport class ApiRuleFindings {\n    constructor(\n        public readonly violations: readonly ApiContractDefect[],\n        /**\n         * Sites that named this rule in a disable and wrote no reason. A reasonless disable is\n         * itself a violation: the point of the per-site hatch is the ARGUMENT, which is the only\n         * part the next reader can weigh.\n         */\n        public readonly reasonlessDisables: readonly ApiContractDefect[],\n    ) {}\n\n    isEmpty(): boolean {\n        return this.violations.length === 0 && this.reasonlessDisables.length === 0;\n    }\n}\n\n/**\n * ONE endpoint declared PERMANENTLY outside MCP by `@InvalidEndpointForMcp('<reason>')` (#1014).\n *\n * Not a violation and not a suppression — a DECLARATION, which is why it is carried beside the\n * findings rather than in them. `api-rules-for-mcp` restates the whole list, with reasons, on every\n * run: an exclusion announced once at the moment somebody added it is an exclusion nobody will read\n * again, and a build-time warning at add time would be read exactly as little.\n */\nexport class McpExclusion {\n    constructor(\n        public readonly api: string,\n        public readonly method: string,\n        /** The decorator's reason, verbatim. Empty only when the argument could not be folded. */\n        public readonly reason: string,\n        /** `path/to/File.ts:LINE`, workspace-relative. */\n        public readonly at: string,\n    ) {}\n}\n\n/** Both rules' findings from ONE scan — one program build, two verdicts. */\nexport class ApiDocRulesFindings {\n    constructor(\n        public readonly openApi: ApiRuleFindings,\n        public readonly mcp: ApiRuleFindings,\n        /** Every `@InvalidEndpointForMcp` endpoint the MCP rule looked at, in declaration order. */\n        public readonly mcpExclusions: readonly McpExclusion[] = [],\n    ) {}\n\n    // webpieces-disable no-function-outside-class -- static factory of this class\n    static empty(): ApiDocRulesFindings {\n        return new ApiDocRulesFindings(\n            new ApiRuleFindings([], []),\n            new ApiRuleFindings([], []),\n            [],\n        );\n    }\n}\n\n/** The mode value that narrows the scan to the projects the diff touched. */\nexport const AFFECTED_PROJECT_MODE = 'AFFECTED_PROJECT';\n\n/**\n * ONE rule's switches, resolved from webpieces.config.json once per scan.\n *\n * There is NO default (#1017). Both rules are schema'd, so `webpieces.config.json` must carry an\n * entry for each or the config FAILS TO LOAD naming them — a consumer states `OFF`,\n * `AFFECTED_PROJECT` or `RUN_EVERY_TIME` out loud. The `off()` a bare constructor or a unit test\n * gets is not a default; it is what a caller that configured nothing asked for.\n */\nexport class ApiDocRule {\n    constructor(\n        public readonly name: string,\n        public readonly enabled: boolean,\n        /** Project roots this rule does not apply to — `allowedPaths` in the config. */\n        public readonly allowedPaths: readonly string[],\n        /**\n         * Workspace-relative paths the diff touched, under `AFFECTED_PROJECT`; `null` under\n         * `RUN_EVERY_TIME`, which means every project is in scope.\n         *\n         * `null` is also what an UNCOMPUTABLE diff resolves to — no merge-base, a shallow clone, no\n         * repository at all. A diff that could not be read is not evidence that nothing changed, and\n         * the only safe reading of \"I do not know what changed\" is \"look at all of it\".\n         */\n        public readonly changedPaths: readonly string[] | null = null,\n    ) {}\n\n    /** ARMED over every project — what a unit test constructs, and what RUN_EVERY_TIME resolves to. */\n    // webpieces-disable no-function-outside-class -- static factory of this class\n    static armed(name: string): ApiDocRule {\n        return new ApiDocRule(name, true, [], null);\n    }\n\n    /** ARMED over the projects owning one of `changedPaths` — what AFFECTED_PROJECT resolves to. */\n    // webpieces-disable no-function-outside-class -- static factory of this class\n    static affected(name: string, changedPaths: readonly string[]): ApiDocRule {\n        return new ApiDocRule(name, true, [], changedPaths);\n    }\n\n    // webpieces-disable no-function-outside-class -- static factory of this class\n    static off(name: string): ApiDocRule {\n        return new ApiDocRule(name, false, [], null);\n    }\n\n    /**\n     * True when this rule scans the contracts of the project rooted at `root`.\n     *\n     * ONE place answers it, for both rules, so `allowedPaths` and the affected-project narrowing can\n     * never be applied by one caller and skipped by another.\n     */\n    coversProject(root: string): boolean {\n        if (!this.enabled) return false;\n        if (matchesAnyGlob(root, this.allowedPaths)) return false;\n        if (this.changedPaths === null) return true;\n        const prefix = `${root}/`;\n        return this.changedPaths.some((each: string): boolean => each.startsWith(prefix));\n    }\n\n    /** `mode: OFF` and the time-box/branch hatches come from RuleGate, so there is ONE reading. */\n    // webpieces-disable no-function-outside-class -- static factory of this class\n    static fromConfig(workspaceRoot: string, name: string): ApiDocRule {\n        if (new RuleGate().isDisabled(workspaceRoot, name, true)) {\n            return ApiDocRule.off(name);\n        }\n        const rule = loadAndValidate(workspaceRoot).resolved.rules.get(name);\n        const allowed = rule?.options['allowedPaths'];\n        const allowedPaths = Array.isArray(allowed) ? (allowed as string[]) : [];\n        const affected =\n            rule?.options['mode'] === AFFECTED_PROJECT_MODE\n                ? ApiDocRule.changedPathsOf(workspaceRoot)\n                : null;\n        return new ApiDocRule(name, true, allowedPaths, affected);\n    }\n\n    /**\n     * Every path the diff touched, against the base nx itself uses (`NX_BASE`, else the merge-base\n     * with origin/main). NOT ts-only and INCLUDING deletions: a deleted DTO changes what a project's\n     * contracts can express exactly as an added one does, and a `project.json` edit can change which\n     * project owns a contract at all.\n     */\n    // webpieces-disable no-function-outside-class -- private static reader of this class\n    private static changedPathsOf(workspaceRoot: string): readonly string[] | null {\n        const scope = new DiffScope();\n        const range = scope.resolveBase(workspaceRoot);\n        if (range.base === undefined) return null;\n        const opts = new ChangedFilesOptions();\n        opts.tsOnly = false;\n        opts.includeDeletions = true;\n        return scope.getChangedFiles(workspaceRoot, range.base, range.head, opts);\n    }\n}\n\n/** ONE `webpieces-disable` naming a rule, and whether it gave a reason. */\nexport class DisableComment {\n    constructor(public readonly hasReason: boolean) {}\n\n    /**\n     * The disable naming `rule` on the declaration at `line` (1-based) of `file`, or undefined.\n     *\n     * It walks UPWARD over the declaration's own leading trivia — blank lines, `//` comments, a\n     * JSDoc block, and the decorators between them — because that is where an author writes one, and\n     * it stops at the first line that is none of those, so a directive belonging to the PREVIOUS\n     * declaration can never be read as covering this one.\n     *\n     * Only a directive NAMING this rule counts. An existing `// webpieces-disable no-any-unknown`\n     * therefore does not silence these rules, which is the point: that rule answers \"is this\n     * type-safe?\" and these answer \"is this field PUBLISHED with no shape?\" — different questions\n     * with different right answers, so the second one wants its own, separately argued line.\n     *\n     * A file that cannot be read yields \"no disable\": a defect is still a defect, and inventing a\n     * suppression out of an I/O failure is the one wrong answer.\n     */\n    // webpieces-disable no-function-outside-class -- static factory of this class\n    static readAt(file: string, line: number, rule: string): DisableComment | undefined {\n        const lines = DisableComment.linesOf(file);\n        if (lines === undefined) return undefined;\n        const start = Math.max(0, line - 1);\n        const onDeclaration = DisableComment.match(lines[start] ?? '', rule);\n        if (onDeclaration !== undefined) return onDeclaration;\n        for (let i = start - 1; i >= 0 && i >= start - DISABLE_LOOKBACK_LINES; i--) {\n            const text = (lines[i] ?? '').trim();\n            const above = DisableComment.match(text, rule);\n            if (above !== undefined) return above;\n            if (!DisableComment.isTrivia(text)) return undefined;\n        }\n        return undefined;\n    }\n\n    /** Leading trivia a disable comment is allowed to sit above: blanks, comments and decorators. */\n    // webpieces-disable no-function-outside-class -- private static predicate of this class\n    private static isTrivia(text: string): boolean {\n        return (\n            text === '' ||\n            text.startsWith('//') ||\n            text.startsWith('*') ||\n            text.startsWith('/*') ||\n            text.startsWith('@')\n        );\n    }\n\n    // webpieces-disable no-function-outside-class -- private static reader of this class\n    private static match(text: string, rule: string): DisableComment | undefined {\n        const found = text.trim().match(DISABLE_RE);\n        if (found === null) return undefined;\n        const named = found[1].split(',').map((each: string): string => each.trim());\n        if (!named.includes(rule)) return undefined;\n        return new DisableComment((found[2] ?? '').trim() !== '');\n    }\n\n    /** The file's lines, or undefined when it cannot be read. */\n    // webpieces-disable no-function-outside-class -- private static reader of this class\n    private static linesOf(file: string): string[] | undefined {\n        if (!fs.existsSync(file)) return undefined;\n        return fs.readFileSync(file, 'utf8').split('\\n');\n    }\n}\n"]}

package/src/lib/api-usage/root-union-scan.d.ts

@@ -32,7 +32,7 @@
  */
 import { ProjectInfo } from '../project-info';
 /** The rule name, as it is written in a disable comment and as a config key. */
-export declare const ROOT_UNION_RULE: "no-root-union-api-type";
+export declare const ROOT_UNION_RULE = "no-root-union-api-type";
 /**
  * The rule's SWITCHES, resolved from webpieces.config.json once per scan.
  *

package/src/lib/api-usage/root-union-scan.js

@@ -41,7 +41,7 @@ const rules_config_1 = require("@webpieces/rules-config");
 const rule_gate_1 = require("../rule-gate");
 const api_ast_1 = require("./api-ast");
 /** The rule name, as it is written in a disable comment and as a config key. */
-exports.ROOT_UNION_RULE = rules_config_1.RULE_NAMES.NO_ROOT_UNION_API_TYPE;
+exports.ROOT_UNION_RULE = "no-root-union-api-type";
 /**
  * `// webpieces-disable no-root-union-api-type -- <reason>`, with the reason CAPTURED so a
  * reasonless one can be told apart from an absent one. A comma list of rules is the shared spelling