@webpieces/rules-config 0.3.262 → 0.3.271

package/src/controller-naming-config.js

@@ -1,189 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ControllerNamingViolation = void 0;
-exports.isControllerNamingAllowedPath = isControllerNamingAllowedPath;
-exports.toKebabCase = toKebabCase;
-exports.findControllerNamingViolations = findControllerNamingViolations;
-// ---------------------------------------------------------------------------
-// enforce-controller-naming — pure detector shared by BOTH engines (ai-hook-rules edit-time,
-// code-rules build-time), mirroring findMatchRuleViolations in match-rules-config.ts.
-//
-// Every class whose heritage ends in `*Api` (`extends XxxApi` / `implements XxxApi`) must DECLARE
-// ITS INTENT with one of two decorators:
-//   - `@Controller`    → it IS a controller, and must then be named `{Something}Controller`
-//                        AND live in a lower-case kebab file `{something}-controller.ts`.
-//   - `@NotController` → it is deliberately NOT a controller (a simulator/client/test double),
-//                        and is exempt from the naming rules.
-// A class implementing `*Api` with NEITHER decorator is a violation ("declare your intent").
-// Any `@Controller`-decorated class is also naming-checked even without `*Api` heritage.
-//
-// The kebab file name is the real deliverable: a separate controller-discovery tool globs
-// `**/*-controller.ts`, which only works if every controller file follows the convention.
-//
-// `allowedPaths` still exempts whole dirs (e.g. generated code); test files are always exempt.
-// ---------------------------------------------------------------------------
-/** One naming violation. `message` differs per kind (class-name vs file-name) — callers surface it. */
-class ControllerNamingViolation {
-    line;
-    context;
-    message;
-    constructor(line, context, message) {
-        this.line = line;
-        this.context = context;
-        this.message = message;
-    }
-}
-exports.ControllerNamingViolation = ControllerNamingViolation;
-const CONTROLLER_SUFFIX = 'Controller';
-const TEST_PATHS = [/\.test\.ts$/, /\.spec\.ts$/, /__tests__\//];
-// Glob → RegExp, matching the convention used by no-symbol-di-tokens / match-rules (`**` spans path
-// separators, `*` stays within a segment). Kept local so rules-config owns no shared glob util.
-function globToRegex(pattern) {
-    let re = '';
-    let i = 0;
-    while (i < pattern.length) {
-        const ch = pattern[i];
-        if (ch === '*') {
-            if (pattern[i + 1] === '*') {
-                re += '.*';
-                i += 2;
-                if (pattern[i] === '/')
-                    i += 1;
-                continue;
-            }
-            re += '[^/]*';
-            i += 1;
-            continue;
-        }
-        if (ch === '?') {
-            re += '[^/]';
-            i += 1;
-            continue;
-        }
-        if ('.+^$(){}|[]\\'.includes(ch)) {
-            re += '\\' + ch;
-            i += 1;
-            continue;
-        }
-        re += ch;
-        i += 1;
-    }
-    return new RegExp('^' + re + '$');
-}
-/** A file is exempt if it's a test file or matches one of the rule's allowedPaths globs. */
-function isControllerNamingAllowedPath(relativePath, allowedPaths) {
-    if (TEST_PATHS.some((re) => re.test(relativePath)))
-        return true;
-    return allowedPaths.some((pattern) => globToRegex(pattern).test(relativePath));
-}
-/**
- * PascalCase → kebab-case. Inserts a `-` before an uppercase letter that follows a lower-case
- * letter or a digit, then lower-cases everything. `SaveController` → `save-controller`,
- * `Server2Controller` → `server2-controller`, `UserAccountController` → `user-account-controller`.
- */
-function toKebabCase(name) {
-    let out = '';
-    for (let i = 0; i < name.length; i += 1) {
-        const ch = name[i] ?? '';
-        const prev = name[i - 1];
-        if (i > 0 && /[A-Z]/.test(ch) && prev !== undefined && /[a-z0-9]/.test(prev)) {
-            out += '-';
-        }
-        out += ch.toLowerCase();
-    }
-    return out;
-}
-const CLASS_DECL = /(?:^|\s)(?:export\s+)?(?:default\s+)?(?:abstract\s+)?class\s+([A-Za-z_$][\w$]*)/;
-// The heritage segment (everything after the class name, up to the opening `{`) declares a
-// controller contract when it `extends`/`implements` an identifier ending in `Api`.
-function heritageMentionsApi(segment) {
-    return /\b(?:extends|implements)\b/.test(segment) && /\b[A-Za-z_$][\w$]*Api\b/.test(segment);
-}
-/** Which intent decorators sit directly above a class declaration. */
-class ClassDecorators {
-    controller;
-    notController;
-    constructor(controller, notController) {
-        this.controller = controller;
-        this.notController = notController;
-    }
-}
-// Walk UP from the class line over the decorator/blank lines that precede it, collecting the
-// `@Controller` / `@NotController` intent markers. Stops at the first real (non-decorator, non-blank)
-// line. `@NotController` is matched first so `@Controller`'s \b test can't swallow it.
-function scanClassDecorators(strippedLines, classLineIndex) {
-    let controller = false;
-    let notController = false;
-    for (let j = classLineIndex - 1; j >= 0; j -= 1) {
-        const s = (strippedLines[j] ?? '').trim();
-        if (s === '')
-            continue;
-        if (!s.startsWith('@'))
-            break;
-        if (/@NotController\b/.test(s))
-            notController = true;
-        else if (/@Controller\b/.test(s))
-            controller = true;
-    }
-    return new ClassDecorators(controller, notController);
-}
-// Collect the heritage text of the class declared on `strippedLines[classLineIndex]`. Heritage may
-// wrap onto following lines, so we accumulate until the opening `{` (bounded to a few lines).
-function collectHeritage(strippedLines, classLineIndex, afterName) {
-    let combined = afterName;
-    let k = classLineIndex;
-    while (!combined.includes('{') && k - classLineIndex < 6 && k + 1 < strippedLines.length) {
-        k += 1;
-        combined += ' ' + (strippedLines[k] ?? '');
-    }
-    return combined.split('{')[0] ?? combined;
-}
-function baseName(relativePath) {
-    const segments = relativePath.split('/');
-    return segments[segments.length - 1] ?? relativePath;
-}
-/**
- * Pure engine. Scans the (comment/string-stripped) lines for controller classes and returns raw
- * naming violations — NO disable filtering (ai-hook applies isLineDisabled; code-rules applies
- * hasDisable). Returns [] for exempt paths (test files / allowedPaths).
- */
-function findControllerNamingViolations(strippedLines, relativePath, config) {
-    if (isControllerNamingAllowedPath(relativePath, config.allowedPaths ?? []))
-        return [];
-    const violations = [];
-    const base = baseName(relativePath);
-    for (let i = 0; i < strippedLines.length; i += 1) {
-        const line = strippedLines[i] ?? '';
-        const match = CLASS_DECL.exec(line);
-        if (!match)
-            continue;
-        const className = match[1] ?? '';
-        const afterName = line.slice((match.index ?? 0) + match[0].length);
-        const heritage = collectHeritage(strippedLines, i, afterName);
-        const context = line.trim();
-        const decorators = scanClassDecorators(strippedLines, i);
-        const implementsApi = heritageMentionsApi(heritage);
-        // Not a controller and not an *Api implementer → nothing to enforce here.
-        if (!decorators.controller && !implementsApi)
-            continue;
-        // Implements *Api but explicitly opted out of being a controller → exempt.
-        if (!decorators.controller && decorators.notController)
-            continue;
-        if (!decorators.controller) {
-            // Implements *Api but declared no intent (no @Controller / @NotController).
-            violations.push(new ControllerNamingViolation(i + 1, context, `Class "${className}" implements/extends an *Api contract, so it must declare its intent: add @Controller (then name it "{Something}${CONTROLLER_SUFFIX}" in a "{something}-controller.ts" file) OR add @NotController if it is deliberately not a controller.`));
-            continue;
-        }
-        // @Controller-decorated → enforce the naming convention.
-        if (!className.endsWith(CONTROLLER_SUFFIX)) {
-            violations.push(new ControllerNamingViolation(i + 1, context, `Controller class "${className}" must be named "{Something}${CONTROLLER_SUFFIX}" (its name must end in "${CONTROLLER_SUFFIX}").`));
-            continue;
-        }
-        const expected = `${toKebabCase(className)}.ts`;
-        if (base !== expected) {
-            violations.push(new ControllerNamingViolation(i + 1, context, `Controller file for class "${className}" must be named "${expected}" (lower-case kebab), but the file is "${base}". The controller-discovery tool finds controllers by globbing **/*-controller.ts.`));
-        }
-    }
-    return violations;
-}
-//# sourceMappingURL=controller-naming-config.js.map

package/src/controller-naming-config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"controller-naming-config.js","sourceRoot":"","sources":["../../../../../packages/tooling/rules-config/src/controller-naming-config.ts"],"names":[],"mappings":"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","sourcesContent":["import { EnforceControllerNamingConfig } from './rule-configs';\n\n// ---------------------------------------------------------------------------\n// enforce-controller-naming — pure detector shared by BOTH engines (ai-hook-rules edit-time,\n// code-rules build-time), mirroring findMatchRuleViolations in match-rules-config.ts.\n//\n// Every class whose heritage ends in `*Api` (`extends XxxApi` / `implements XxxApi`) must DECLARE\n// ITS INTENT with one of two decorators:\n//   - `@Controller`    → it IS a controller, and must then be named `{Something}Controller`\n//                        AND live in a lower-case kebab file `{something}-controller.ts`.\n//   - `@NotController` → it is deliberately NOT a controller (a simulator/client/test double),\n//                        and is exempt from the naming rules.\n// A class implementing `*Api` with NEITHER decorator is a violation (\"declare your intent\").\n// Any `@Controller`-decorated class is also naming-checked even without `*Api` heritage.\n//\n// The kebab file name is the real deliverable: a separate controller-discovery tool globs\n// `**/*-controller.ts`, which only works if every controller file follows the convention.\n//\n// `allowedPaths` still exempts whole dirs (e.g. generated code); test files are always exempt.\n// ---------------------------------------------------------------------------\n\n/** One naming violation. `message` differs per kind (class-name vs file-name) — callers surface it. */\nexport class ControllerNamingViolation {\n    readonly line: number;\n    readonly context: string;\n    readonly message: string;\n\n    constructor(line: number, context: string, message: string) {\n        this.line = line;\n        this.context = context;\n        this.message = message;\n    }\n}\n\nconst CONTROLLER_SUFFIX = 'Controller';\n\nconst TEST_PATHS: readonly RegExp[] = [/\\.test\\.ts$/, /\\.spec\\.ts$/, /__tests__\\//];\n\n// Glob → RegExp, matching the convention used by no-symbol-di-tokens / match-rules (`**` spans path\n// separators, `*` stays within a segment). Kept local so rules-config owns no shared glob util.\nfunction globToRegex(pattern: string): RegExp {\n    let re = '';\n    let i = 0;\n    while (i < pattern.length) {\n        const ch = pattern[i];\n        if (ch === '*') {\n            if (pattern[i + 1] === '*') {\n                re += '.*';\n                i += 2;\n                if (pattern[i] === '/') i += 1;\n                continue;\n            }\n            re += '[^/]*';\n            i += 1;\n            continue;\n        }\n        if (ch === '?') {\n            re += '[^/]';\n            i += 1;\n            continue;\n        }\n        if ('.+^$(){}|[]\\\\'.includes(ch)) {\n            re += '\\\\' + ch;\n            i += 1;\n            continue;\n        }\n        re += ch;\n        i += 1;\n    }\n    return new RegExp('^' + re + '$');\n}\n\n/** A file is exempt if it's a test file or matches one of the rule's allowedPaths globs. */\nexport function isControllerNamingAllowedPath(relativePath: string, allowedPaths: readonly string[]): boolean {\n    if (TEST_PATHS.some((re: RegExp) => re.test(relativePath))) return true;\n    return allowedPaths.some((pattern: string) => globToRegex(pattern).test(relativePath));\n}\n\n/**\n * PascalCase → kebab-case. Inserts a `-` before an uppercase letter that follows a lower-case\n * letter or a digit, then lower-cases everything. `SaveController` → `save-controller`,\n * `Server2Controller` → `server2-controller`, `UserAccountController` → `user-account-controller`.\n */\nexport function toKebabCase(name: string): string {\n    let out = '';\n    for (let i = 0; i < name.length; i += 1) {\n        const ch = name[i] ?? '';\n        const prev = name[i - 1];\n        if (i > 0 && /[A-Z]/.test(ch) && prev !== undefined && /[a-z0-9]/.test(prev)) {\n            out += '-';\n        }\n        out += ch.toLowerCase();\n    }\n    return out;\n}\n\nconst CLASS_DECL = /(?:^|\\s)(?:export\\s+)?(?:default\\s+)?(?:abstract\\s+)?class\\s+([A-Za-z_$][\\w$]*)/;\n\n// The heritage segment (everything after the class name, up to the opening `{`) declares a\n// controller contract when it `extends`/`implements` an identifier ending in `Api`.\nfunction heritageMentionsApi(segment: string): boolean {\n    return /\\b(?:extends|implements)\\b/.test(segment) && /\\b[A-Za-z_$][\\w$]*Api\\b/.test(segment);\n}\n\n/** Which intent decorators sit directly above a class declaration. */\nclass ClassDecorators {\n    readonly controller: boolean;\n    readonly notController: boolean;\n\n    constructor(controller: boolean, notController: boolean) {\n        this.controller = controller;\n        this.notController = notController;\n    }\n}\n\n// Walk UP from the class line over the decorator/blank lines that precede it, collecting the\n// `@Controller` / `@NotController` intent markers. Stops at the first real (non-decorator, non-blank)\n// line. `@NotController` is matched first so `@Controller`'s \\b test can't swallow it.\nfunction scanClassDecorators(strippedLines: readonly string[], classLineIndex: number): ClassDecorators {\n    let controller = false;\n    let notController = false;\n    for (let j = classLineIndex - 1; j >= 0; j -= 1) {\n        const s = (strippedLines[j] ?? '').trim();\n        if (s === '') continue;\n        if (!s.startsWith('@')) break;\n        if (/@NotController\\b/.test(s)) notController = true;\n        else if (/@Controller\\b/.test(s)) controller = true;\n    }\n    return new ClassDecorators(controller, notController);\n}\n\n// Collect the heritage text of the class declared on `strippedLines[classLineIndex]`. Heritage may\n// wrap onto following lines, so we accumulate until the opening `{` (bounded to a few lines).\nfunction collectHeritage(strippedLines: readonly string[], classLineIndex: number, afterName: string): string {\n    let combined = afterName;\n    let k = classLineIndex;\n    while (!combined.includes('{') && k - classLineIndex < 6 && k + 1 < strippedLines.length) {\n        k += 1;\n        combined += ' ' + (strippedLines[k] ?? '');\n    }\n    return combined.split('{')[0] ?? combined;\n}\n\nfunction baseName(relativePath: string): string {\n    const segments = relativePath.split('/');\n    return segments[segments.length - 1] ?? relativePath;\n}\n\n/**\n * Pure engine. Scans the (comment/string-stripped) lines for controller classes and returns raw\n * naming violations — NO disable filtering (ai-hook applies isLineDisabled; code-rules applies\n * hasDisable). Returns [] for exempt paths (test files / allowedPaths).\n */\nexport function findControllerNamingViolations(\n    strippedLines: readonly string[],\n    relativePath: string,\n    config: EnforceControllerNamingConfig,\n): ControllerNamingViolation[] {\n    if (isControllerNamingAllowedPath(relativePath, config.allowedPaths ?? [])) return [];\n\n    const violations: ControllerNamingViolation[] = [];\n    const base = baseName(relativePath);\n\n    for (let i = 0; i < strippedLines.length; i += 1) {\n        const line = strippedLines[i] ?? '';\n        const match = CLASS_DECL.exec(line);\n        if (!match) continue;\n\n        const className = match[1] ?? '';\n        const afterName = line.slice((match.index ?? 0) + match[0].length);\n        const heritage = collectHeritage(strippedLines, i, afterName);\n        const context = line.trim();\n\n        const decorators = scanClassDecorators(strippedLines, i);\n        const implementsApi = heritageMentionsApi(heritage);\n\n        // Not a controller and not an *Api implementer → nothing to enforce here.\n        if (!decorators.controller && !implementsApi) continue;\n        // Implements *Api but explicitly opted out of being a controller → exempt.\n        if (!decorators.controller && decorators.notController) continue;\n\n        if (!decorators.controller) {\n            // Implements *Api but declared no intent (no @Controller / @NotController).\n            violations.push(new ControllerNamingViolation(\n                i + 1,\n                context,\n                `Class \"${className}\" implements/extends an *Api contract, so it must declare its intent: add @Controller (then name it \"{Something}${CONTROLLER_SUFFIX}\" in a \"{something}-controller.ts\" file) OR add @NotController if it is deliberately not a controller.`,\n            ));\n            continue;\n        }\n\n        // @Controller-decorated → enforce the naming convention.\n        if (!className.endsWith(CONTROLLER_SUFFIX)) {\n            violations.push(new ControllerNamingViolation(\n                i + 1,\n                context,\n                `Controller class \"${className}\" must be named \"{Something}${CONTROLLER_SUFFIX}\" (its name must end in \"${CONTROLLER_SUFFIX}\").`,\n            ));\n            continue;\n        }\n\n        const expected = `${toKebabCase(className)}.ts`;\n        if (base !== expected) {\n            violations.push(new ControllerNamingViolation(\n                i + 1,\n                context,\n                `Controller file for class \"${className}\" must be named \"${expected}\" (lower-case kebab), but the file is \"${base}\". The controller-discovery tool finds controllers by globbing **/*-controller.ts.`,\n            ));\n        }\n    }\n\n    return violations;\n}\n"]}