@lyse-labs/lyse 0.1.0-alpha.2

package/dist/rules/naming-component-pascalcase.js

@@ -0,0 +1,197 @@
+import { isPathExcluded } from "./_exclude.js";
+import { fixNamingComponentPascalCase } from "../codemods/naming-component-pascalcase.js";
+import { adaptOldCodemodResult } from "./_codemod-adapter.js";
+import { createLyseRule } from "./_rule-module.js";
+import { arrowImplicitReturnsJsx, bodyReturnsJsx, extractFunctionBody, } from "./_function-body-analysis.js";
+// ---------------------------------------------------------------------------
+// PascalCase check
+// ---------------------------------------------------------------------------
+const PASCAL_CASE_RE = /^[A-Z][a-zA-Z0-9]*$/;
+function isPascalCase(name) {
+    return PASCAL_CASE_RE.test(name);
+}
+// Known HOC prefixes to skip
+const HOC_NAME_RE = /^with[A-Z]/;
+// ---------------------------------------------------------------------------
+// Compliance counter
+// ---------------------------------------------------------------------------
+// Counts PascalCase exported components (correct pattern)
+const EXPORTED_PASCAL_COMPONENT_RE = /\bexport\s+(?:default\s+)?(?:function|const|class)\s+([A-Z][a-zA-Z0-9]*)\b/g;
+/**
+ * Counts how many exported PascalCase component names exist in the source.
+ * These are compliant usages (denominator for scoring).
+ */
+export function countCompliantComponents(source) {
+    EXPORTED_PASCAL_COMPONENT_RE.lastIndex = 0;
+    let count = 0;
+    let m;
+    while ((m = EXPORTED_PASCAL_COMPONENT_RE.exec(source)) !== null) {
+        if (m[1] && isPascalCase(m[1]))
+            count++;
+    }
+    return count;
+}
+// ---------------------------------------------------------------------------
+// Exported name extraction — finds exported function/const names that look
+// like React components (return JSX or have displayName)
+// ---------------------------------------------------------------------------
+// Matches: export function myName(...), export const myName = ..., export default function myName(...)
+const EXPORT_FUNC_RE = /\bexport\s+(?:default\s+)?(?:function\s+(\w+)|(?:const|let|var)\s+(\w+)\s*=\s*(?:async\s*)?\()/g;
+function locationFromIndex(source, index) {
+    let line = 1;
+    let column = 1;
+    for (let i = 0; i < index && i < source.length; i++) {
+        if (source.charCodeAt(i) === 10) {
+            line++;
+            column = 1;
+        }
+        else {
+            column++;
+        }
+    }
+    return { line, column };
+}
+/**
+ * Extract candidate component names from a source file that are exported
+ * but NOT PascalCase.
+ *
+ * Detection heuristics:
+ * 1. Find exported named functions or arrow function consts
+ * 2. Check if the body contains JSX return (return <...) as component signal
+ * 3. Skip HOC patterns (withXxx)
+ * 4. Skip hook patterns (useXxx) — handled by naming/hook-prefix rule
+ * 5. Skip test utilities
+ */
+function detectNonPascalComponents(source, path) {
+    const results = [];
+    // Skip test files
+    if (/\.(test|spec)\.(tsx?|jsx?)$/.test(path))
+        return results;
+    EXPORT_FUNC_RE.lastIndex = 0;
+    let m;
+    while ((m = EXPORT_FUNC_RE.exec(source)) !== null) {
+        const name = m[1] ?? m[2];
+        if (!name)
+            continue;
+        // Skip already-PascalCase (correct)
+        if (isPascalCase(name))
+            continue;
+        // Skip HOCs
+        if (HOC_NAME_RE.test(name))
+            continue;
+        // Skip hooks (handled by hook-prefix rule)
+        if (/^use[A-Z]/.test(name))
+            continue;
+        const isConstArrow = m[2] !== undefined;
+        const bodySlice = extractFunctionBody(source, m.index);
+        const hasJsxReturn = bodyReturnsJsx(bodySlice) ||
+            (isConstArrow && arrowImplicitReturnsJsx(source, m.index));
+        const hasDisplayName = new RegExp(`${name}\\.displayName\\s*=`).test(source);
+        if (!hasJsxReturn && !hasDisplayName)
+            continue;
+        results.push({ name, index: m.index });
+    }
+    return results;
+}
+// ---------------------------------------------------------------------------
+// Compliance counter for evaluate
+// ---------------------------------------------------------------------------
+function toPascalCase(name) {
+    // Simple converter: split on _, - or camelCase boundaries
+    // For camelCase: myComponent → MyComponent
+    // For snake_case: my_component → MyComponent
+    // For kebab-case: my-component → MyComponent
+    const parts = name
+        .replace(/[-_]/g, " ")
+        // Insert space before uppercase letters in camelCase
+        .replace(/([A-Z])/g, " $1")
+        .trim()
+        .split(/\s+/);
+    return parts
+        .map((p) => (p.length > 0 ? p[0].toUpperCase() + p.slice(1) : ""))
+        .join("");
+}
+const evaluate = async (ctx, files) => {
+    const findings = [];
+    let opportunities = 0;
+    for (const f of files.ts) {
+        if (isPathExcluded(f.path, ctx.excludePaths))
+            continue;
+        // Only scan JSX/TSX files (component files)
+        if (!/\.(tsx|jsx)$/.test(f.path))
+            continue;
+        // Skip test/spec files
+        if (/\.(test|spec)\.(tsx?|jsx?)$/.test(f.path))
+            continue;
+        opportunities += countCompliantComponents(f.source);
+        const hits = detectNonPascalComponents(f.source, f.path);
+        for (const h of hits) {
+            opportunities++;
+            const loc = locationFromIndex(f.source, h.index);
+            const suggested = toPascalCase(h.name);
+            findings.push({
+                ruleId: "naming/component-pascalcase",
+                axis: "components",
+                severity: "warning",
+                location: { file: f.path, line: loc.line, column: loc.column },
+                message: `Component '${h.name}' is not PascalCase`,
+                suggestion: `Rename to '${suggested}'`,
+            });
+        }
+    }
+    return { findings, opportunities };
+};
+const classifyConfidence = (finding, _ctx) => {
+    const nameMatch = finding.message.match(/Component '(\w+)'/);
+    const name = nameMatch?.[1] ?? "";
+    if (!name)
+        return "low";
+    // Simple renames (camelCase → PascalCase) are high confidence
+    // snake_case or kebab-case in name means more complex rename → medium
+    if (name.includes("_") || name.includes("-"))
+        return "medium";
+    // If it starts with a lowercase letter but is otherwise simple camelCase
+    return "high";
+};
+const applyCodemod = (finding, ctx) => {
+    const ruleCtx = {
+        repoRoot: "",
+        tokens: ctx.tokens,
+        componentsModule: ctx.config.designSystem?.componentsModule ?? null,
+        componentInventory: [],
+        storyIndex: null,
+        excludePaths: [],
+    };
+    const oldResult = fixNamingComponentPascalCase({
+        source: ctx.fileContent,
+        path: finding.location.file,
+        finding,
+        ctx: ruleCtx,
+    });
+    return adaptOldCodemodResult(oldResult);
+};
+export const rule = createLyseRule({
+    meta: {
+        axis: "components",
+        lyseRuleId: "naming/component-pascalcase",
+        defaultSeverity: "warning",
+        shortDescription: "Exported React/Vue/Solid components must be PascalCase",
+        fullDescription: "Exported component functions or const arrow-function components (those returning JSX) that are not named in PascalCase violate React/Vue/Solid component naming conventions. Non-PascalCase names are silently treated as plain elements in JSX, causing components to render as unknown DOM elements and breaking the React component model.",
+        helpUri: "https://github.com/lyse-labs/lyse/blob/main/docs/rules/naming-component-pascalcase.md",
+        rationale: `Why it matters
+
+React, Vue, and Solid distinguish between HTML element types and component types by case: \`<myButton>\` creates an unknown HTML element whereas \`<MyButton>\` invokes the component. A component named \`myButton\` instead of \`MyButton\` is silently broken when used as JSX — it renders nothing useful.
+
+Auto-fix renames the declaration and internal same-file references. Cross-file imports must be updated separately (the suggestion includes a warning when the name is exported).`,
+        examples: [
+            { good: "export function MyButton() { return <button>Click</button>; }", bad: "export function myButton() { return <button>Click</button>; }" },
+            { good: "export const MyCard = () => <div className=\"card\" />;", bad: "export const my_card = () => <div className=\"card\" />;" },
+        ],
+        allowlist: ["HOC patterns (withRouter, withTheme — start with `with` lowercase)", "test utilities in .test.tsx / .spec.tsx files", "hooks starting with `use` (handled by naming/hook-prefix)"],
+    },
+    defaultOptions: [],
+    create: () => ({ evaluate }),
+    classifyConfidence,
+    applyCodemod,
+});
+//# sourceMappingURL=naming-component-pascalcase.js.map

package/dist/rules/naming-component-pascalcase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming-component-pascalcase.js","sourceRoot":"","sources":["../../src/rules/naming-component-pascalcase.ts"],"names":[],"mappings":"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"}

package/dist/rules/naming-hook-prefix.d.ts

@@ -0,0 +1,6 @@
+import type { Rule } from "../types.js";
+/**
+ * Counts exported functions that start with `use` + uppercase letter.
+ */
+export declare function countCompliantHooks(source: string): number;
+export declare const rule: Rule;

package/dist/rules/naming-hook-prefix.js

@@ -0,0 +1,185 @@
+import { isPathExcluded } from "./_exclude.js";
+import { fixNamingHookPrefix } from "../codemods/naming-hook-prefix.js";
+import { adaptOldCodemodResult } from "./_codemod-adapter.js";
+import { createLyseRule } from "./_rule-module.js";
+import { bodyCallsHook, extractFunctionBody, fileIsInHooksDir, filenameMatchesFunction, } from "./_function-body-analysis.js";
+// ---------------------------------------------------------------------------
+// Hook-prefix patterns
+// ---------------------------------------------------------------------------
+// A valid custom hook name: starts with "use" + uppercase letter
+const VALID_HOOK_NAME_RE = /^use[A-Z][a-zA-Z0-9]*$/;
+// ---------------------------------------------------------------------------
+// Compliance counter
+// ---------------------------------------------------------------------------
+// Already correctly named hooks (use + uppercase)
+const VALID_HOOK_EXPORT_RE = /\bexport\s+(?:async\s+)?(?:function\s+use[A-Z]|(?:const|let|var)\s+use[A-Z])/g;
+/**
+ * Counts exported functions that start with `use` + uppercase letter.
+ */
+export function countCompliantHooks(source) {
+    VALID_HOOK_EXPORT_RE.lastIndex = 0;
+    const m = source.match(VALID_HOOK_EXPORT_RE);
+    return m ? m.length : 0;
+}
+// ---------------------------------------------------------------------------
+// Detection helpers
+// ---------------------------------------------------------------------------
+// Matches exported functions: export function name(...) / export const name = ...() / export async function name(...)
+const EXPORTED_FUNC_RE = /\bexport\s+(?:default\s+)?(?:async\s+)?(?:function\s+(\w+)|(?:const|let|var)\s+(\w+)\s*=\s*(?:async\s*)?\()/g;
+function locationFromIndex(source, index) {
+    let line = 1;
+    let column = 1;
+    for (let i = 0; i < index && i < source.length; i++) {
+        if (source.charCodeAt(i) === 10) {
+            line++;
+            column = 1;
+        }
+        else {
+            column++;
+        }
+    }
+    return { line, column };
+}
+/**
+ * Detect exported functions that look like hooks based on evidence and don't
+ * start with the `use` prefix followed by an uppercase letter.
+ *
+ * Evidence is provided by the shared `_function-body-analysis` helper:
+ *   - body-call evidence: function body contains a top-level `use<Upper>(` call
+ *   - path-evidence: file lives under `**\/hooks\/**` AND the function name
+ *     matches the filename's advertised hook target (e.g. `toggle` in
+ *     `use-toggle.ts`). Co-located helpers with unrelated names require
+ *     body-call evidence — see issue #166.
+ *
+ * Without ANY evidence we do not flag — a pure utility named `flattenTree` in
+ * a `.tsx` file should remain a utility.
+ */
+function detectBadlyNamedHooks(source, path) {
+    const results = [];
+    // Skip test files — test utilities that call hooks internally aren't hooks
+    if (/\.(test|spec)\.(tsx?|jsx?)$/.test(path))
+        return results;
+    const hooksDir = fileIsInHooksDir(path);
+    EXPORTED_FUNC_RE.lastIndex = 0;
+    let m;
+    while ((m = EXPORTED_FUNC_RE.exec(source)) !== null) {
+        const name = m[1] ?? m[2];
+        if (!name)
+            continue;
+        // Already correctly named
+        if (VALID_HOOK_NAME_RE.test(name))
+            continue;
+        // Skip PascalCase — those are components, not hooks
+        if (/^[A-Z]/.test(name))
+            continue;
+        // Brace-matched body slice — bounded to the function under inspection,
+        // so sibling functions further down the file don't bleed in.
+        const bodySlice = extractFunctionBody(source, m.index);
+        const callEvidence = bodyCallsHook(bodySlice);
+        // Path-evidence (issue #166): a function in a `hooks/` directory is
+        // flagged via path alone ONLY when its name matches the filename's
+        // advertised target (e.g. `toggle` in `use-toggle.ts`). Unrelated
+        // co-located helpers (e.g. `composeRefs` in `use-combine-ref.ts`)
+        // require body-call evidence.
+        const filenameMatch = filenameMatchesFunction(path, name);
+        if (!callEvidence && !(hooksDir && filenameMatch))
+            continue;
+        results.push({ name, index: m.index });
+    }
+    return results;
+}
+/**
+ * Convert a function name to a valid hook name by prepending "use" + capitalize.
+ * Examples: getMyData → useMyData, fetchUser → useFetchUser
+ */
+function toHookName(name) {
+    // If it already starts with lowercase, just capitalize first letter and prepend "use"
+    const capitalized = name[0] ? name[0].toUpperCase() + name.slice(1) : name;
+    return `use${capitalized}`;
+}
+const evaluate = async (ctx, files) => {
+    const findings = [];
+    let opportunities = 0;
+    for (const f of files.ts) {
+        if (isPathExcluded(f.path, ctx.excludePaths))
+            continue;
+        // Only scan TS/TSX/JS/JSX files
+        if (!/\.(tsx?|jsx?)$/.test(f.path))
+            continue;
+        // Skip test/spec files
+        if (/\.(test|spec)\.(tsx?|jsx?)$/.test(f.path))
+            continue;
+        opportunities += countCompliantHooks(f.source);
+        const hits = detectBadlyNamedHooks(f.source, f.path);
+        for (const h of hits) {
+            opportunities++;
+            const loc = locationFromIndex(f.source, h.index);
+            const suggested = toHookName(h.name);
+            findings.push({
+                ruleId: "naming/hook-prefix",
+                axis: "components",
+                severity: "warning",
+                location: { file: f.path, line: loc.line, column: loc.column },
+                message: `Hook '${h.name}' does not start with 'use' + uppercase letter`,
+                suggestion: `Rename to '${suggested}' (custom hooks must start with \`use\` + capital letter)`,
+            });
+        }
+    }
+    return { findings, opportunities };
+};
+const classifyConfidence = (finding, _ctx) => {
+    const nameMatch = finding.message.match(/Hook '([\w-]+)'/);
+    const name = nameMatch?.[1] ?? "";
+    if (!name)
+        return "low";
+    // Simple rename (getXxx → useXxx) is high confidence
+    // Names with underscores or dashes are more complex → medium
+    if (name.includes("_") || name.includes("-"))
+        return "medium";
+    return "high";
+};
+const applyCodemod = (finding, ctx) => {
+    const ruleCtx = {
+        repoRoot: "",
+        tokens: ctx.tokens,
+        componentsModule: ctx.config.designSystem?.componentsModule ?? null,
+        componentInventory: [],
+        storyIndex: null,
+        excludePaths: [],
+    };
+    const oldResult = fixNamingHookPrefix({
+        source: ctx.fileContent,
+        path: finding.location.file,
+        finding,
+        ctx: ruleCtx,
+    });
+    return adaptOldCodemodResult(oldResult);
+};
+export const rule = createLyseRule({
+    meta: {
+        axis: "components",
+        lyseRuleId: "naming/hook-prefix",
+        defaultSeverity: "warning",
+        shortDescription: "Custom hooks must start with `use` + uppercase letter",
+        fullDescription: "Exported functions that call other React hooks internally (useState, useEffect, useMemo, useCallback, useRef, useContext, useReducer, useLayoutEffect, and custom use* hooks) are custom hooks by definition. React's rules-of-hooks linter and runtime depend on the `use` prefix to detect hooks — a function named `getMyData` that calls `useState` internally breaks lint, ESLint plugin react-hooks, and can cause subtle hook order violations.",
+        helpUri: "https://github.com/lyse-labs/lyse/blob/main/docs/rules/naming-hook-prefix.md",
+        rationale: `Why it matters
+
+React's rules of hooks use the \`use\` prefix to determine if a function is a hook. A misnamed hook (\`getMyData\` calling \`useState\`) bypasses this detection, so:
+1. \`eslint-plugin-react-hooks\` won't apply its rules (silently broken)
+2. Calling the function conditionally becomes valid from ESLint's perspective — but will still crash at runtime
+3. Other developers don't know the function has hook semantics and may call it in non-hook contexts
+
+Auto-fix renames the declaration to \`use<CapitalizedName>\`. Cross-file callers must be updated separately.`,
+        examples: [
+            { good: "export function useMyData() { const [d, setD] = useState(null); return d; }", bad: "export function getMyData() { const [d, setD] = useState(null); return d; }" },
+            { good: "export const useAuth = () => { const ctx = useContext(AuthCtx); return ctx; };", bad: "export const fetchAuth = () => { const ctx = useContext(AuthCtx); return ctx; };" },
+        ],
+        allowlist: ["PascalCase components that happen to call hooks (those are components, not hooks)", "test utilities in .test.ts / .spec.ts files", "non-exported functions (internal helpers)"],
+    },
+    defaultOptions: [],
+    create: () => ({ evaluate }),
+    classifyConfidence,
+    applyCodemod,
+});
+//# sourceMappingURL=naming-hook-prefix.js.map

package/dist/rules/naming-hook-prefix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming-hook-prefix.js","sourceRoot":"","sources":["../../src/rules/naming-hook-prefix.ts"],"names":[],"mappings":"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"}

package/dist/rules/pack-loader.d.ts

@@ -0,0 +1,30 @@
+import type { Rule } from '../types.js';
+export interface RulePack {
+    version: 1;
+    generated_at: string;
+    generated_by: string;
+    generated_from: {
+        lyse_version: string;
+        template_catalog_version: number;
+        deps_hash: string;
+        files_hash: string;
+    };
+    rules: Array<{
+        id: string;
+        template: string;
+        axis: 'tokens' | 'a11y' | 'components' | 'stories';
+        severity: 'error' | 'warning' | 'info' | 'off';
+        config: Record<string, unknown>;
+        metadata?: {
+            description?: string;
+            auto_fixable?: boolean;
+            learn_url?: string | null;
+        };
+    }>;
+}
+export interface LoadResult {
+    rules: Rule[];
+    warnings: string[];
+    pack?: RulePack;
+}
+export declare function loadGeneratedPack(repoRoot: string): LoadResult;

package/dist/rules/pack-loader.js

@@ -0,0 +1,60 @@
+// packages/core/src/rules/pack-loader.ts
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { getTemplate } from './templates/registry.js';
+import { ruleMap } from './registry.js';
+export function loadGeneratedPack(repoRoot) {
+    const packPath = join(repoRoot, '.lyse', 'generated-rules.yaml');
+    if (!existsSync(packPath)) {
+        return { rules: [], warnings: [] };
+    }
+    const raw = readFileSync(packPath, 'utf8');
+    let pack;
+    try {
+        pack = parseYaml(raw);
+    }
+    catch (err) {
+        return { rules: [], warnings: [`Failed to parse .lyse/generated-rules.yaml: ${err.message}`] };
+    }
+    if (pack?.version !== 1) {
+        return { rules: [], warnings: [`Unsupported pack version: ${pack?.version}`] };
+    }
+    const rules = [];
+    const warnings = [];
+    const seenIds = new Set();
+    for (const r of pack.rules ?? []) {
+        if (r.severity === 'off') {
+            // explicit off — skip rule entirely, no findings
+            continue;
+        }
+        if (ruleMap.has(r.id)) {
+            warnings.push(`Generated rule id "${r.id}" collides with a built-in rule — skipped (built-in wins)`);
+            continue;
+        }
+        if (seenIds.has(r.id)) {
+            warnings.push(`Duplicate rule id "${r.id}" skipped`);
+            continue;
+        }
+        seenIds.add(r.id);
+        const template = getTemplate(r.template);
+        if (!template) {
+            warnings.push(`Unknown template "${r.template}" for rule "${r.id}" — skipped`);
+            continue;
+        }
+        try {
+            const rule = template.build({
+                ruleId: r.id,
+                axis: r.axis,
+                severity: r.severity,
+                config: r.config,
+            });
+            rules.push(rule);
+        }
+        catch (err) {
+            warnings.push(`Failed to build rule "${r.id}" from template "${r.template}": ${err.message}`);
+        }
+    }
+    return { rules, warnings, pack };
+}
+//# sourceMappingURL=pack-loader.js.map

package/dist/rules/pack-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-loader.js","sourceRoot":"","sources":["../../src/rules/pack-loader.ts"],"names":[],"mappings":"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"}

package/dist/rules/pack-validator.d.ts

@@ -0,0 +1,8 @@
+import type { RulePack } from './pack-loader.js';
+export interface ValidationResult {
+    ok: boolean;
+    errors: string[];
+    totalFindings: number;
+    durationMs: number;
+}
+export declare function validatePack(pack: RulePack, fixtureRoot: string): Promise<ValidationResult>;

package/dist/rules/pack-validator.js

@@ -0,0 +1,97 @@
+// packages/core/src/rules/pack-validator.ts
+import { z } from 'zod';
+import { walk } from '../walker.js';
+import { parseTs } from '../parsers/ts.js';
+import { parseCss } from '../parsers/css.js';
+import { extractCssInJs } from '../parsers/css-in-js.js';
+import { readFileSync } from 'node:fs';
+import { relative } from 'node:path';
+import { getTemplate } from './templates/registry.js';
+const PackSchema = z.object({
+    version: z.literal(1),
+    generated_at: z.string(),
+    generated_by: z.string(),
+    generated_from: z.object({
+        lyse_version: z.string(),
+        template_catalog_version: z.number(),
+        deps_hash: z.string(),
+        files_hash: z.string(),
+    }),
+    rules: z.array(z.object({
+        id: z.string().min(1),
+        template: z.string().min(1),
+        axis: z.enum(['tokens', 'a11y', 'components', 'stories']),
+        severity: z.enum(['error', 'warning', 'info', 'off']),
+        config: z.record(z.string(), z.unknown()),
+        metadata: z.unknown().optional(),
+    })),
+});
+export async function validatePack(pack, fixtureRoot) {
+    const errors = [];
+    const t0 = Date.now();
+    // 1. Schema
+    const parsed = PackSchema.safeParse(pack);
+    if (!parsed.success) {
+        errors.push(`Schema invalid: ${parsed.error.errors.map((e) => `${e.path.join('.')} ${e.message}`).join('; ')}`);
+        return { ok: false, errors, totalFindings: 0, durationMs: Date.now() - t0 };
+    }
+    // 2. Unique IDs + known templates
+    const seen = new Set();
+    for (const r of parsed.data.rules) {
+        if (seen.has(r.id))
+            errors.push(`Duplicate rule id: ${r.id}`);
+        seen.add(r.id);
+        if (!getTemplate(r.template))
+            errors.push(`Unknown template: ${r.template} (rule ${r.id})`);
+    }
+    if (errors.length > 0) {
+        return { ok: false, errors, totalFindings: 0, durationMs: Date.now() - t0 };
+    }
+    // 3. Smoke test: build rules + run against fixture
+    const files = await walk(fixtureRoot);
+    const parsedFiles = { ts: [], css: [], cssInJs: [] };
+    for (const path of files) {
+        const source = readFileSync(path, 'utf8');
+        const rel = relative(fixtureRoot, path);
+        if (/\.(tsx?|jsx?)$/.test(path)) {
+            parsedFiles.ts.push(await parseTs(rel, source));
+            parsedFiles.cssInJs.push(...extractCssInJs(rel, source));
+        }
+        else if (/\.(s?css)$/.test(path)) {
+            parsedFiles.css.push(await parseCss(rel, source));
+        }
+    }
+    const ctx = {
+        repoRoot: fixtureRoot,
+        tokens: null,
+        componentsModule: null,
+        componentInventory: [],
+        storyIndex: null,
+        excludePaths: [],
+    };
+    let totalFindings = 0;
+    for (const r of parsed.data.rules) {
+        const template = getTemplate(r.template);
+        let rule;
+        try {
+            rule = template.build({ ruleId: r.id, axis: r.axis, severity: r.severity, config: r.config });
+        }
+        catch (err) {
+            errors.push(`Rule "${r.id}" failed to build: ${err.message}`);
+            continue;
+        }
+        try {
+            const result = await rule.evaluate(ctx, parsedFiles);
+            totalFindings += result.findings.length;
+        }
+        catch (err) {
+            errors.push(`Rule "${r.id}" crashed during smoke test: ${err.message}`);
+        }
+    }
+    if (totalFindings === 0) {
+        errors.push(`Pack produced no findings on the validation fixture (likely too permissive or broken)`);
+    }
+    const ok = errors.length === 0;
+    return { ok, errors, totalFindings, durationMs: Date.now() - t0 };
+}
+//# sourceMappingURL=pack-validator.js.map

package/dist/rules/pack-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-validator.js","sourceRoot":"","sources":["../../src/rules/pack-validator.ts"],"names":[],"mappings":"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"}

package/dist/rules/registry.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from "../types.js";
+export declare const ruleObjects: Rule[];
+export declare const ruleMap: Map<string, Rule>;