@lyse-labs/lyse 0.1.0-alpha.2

package/dist/rules/_function-body-analysis.js

@@ -0,0 +1,379 @@
+// Shared body-analysis primitives for naming-* rules.
+//
+// These helpers replace the per-rule 2000-char body slices + ad-hoc regex
+// matchers that produced both false negatives (long bodies truncated) and
+// false positives (generics confused for JSX, utility `use*` calls confused
+// for hook calls).
+//
+// Pure utility module — no rule-specific imports. Helpers are stateless and
+// deterministic: same input → same output.
+// Why a streaming scan instead of a capped slice: the previous rules sliced
+// the function body to 2000 chars before scanning. Real codebases (e.g.
+// Enobase) have legitimate hooks whose first hook call sits past that
+// cutoff, producing false negatives. We instead match against the full body
+// slice using lastIndex iteration — the regex engine streams the input and
+// stops on the first match, so the cost is bounded by the position of the
+// first hook call, not the length of the body.
+// `use[A-Z]\w*\s*\(` finds candidate hook call sites anywhere in the body.
+// We then filter for true positives (see `bodyCallsHook`).
+const HOOK_CALL_RE = /\buse[A-Z][a-zA-Z0-9]*\s*\(/g;
+// Identifier-like prefix that, when it precedes `use<Upper>`, suggests the
+// call is NOT a top-level hook call — e.g. `obj.useThing(` or `this.useX(`.
+// We deliberately keep this conservative: object-method dispatch on something
+// named like a hook is rare and almost never a real hook.
+function isMemberAccessAt(source, index) {
+    let i = index - 1;
+    while (i >= 0 && /\s/.test(source[i]))
+        i--;
+    return i >= 0 && source[i] === ".";
+}
+// Detects whether the call site sits inside a nested function declaration
+// or method shorthand. A hook called inside an inner `function inner() {}`
+// or `const cb = () => { useX() }` does NOT make the OUTER function a hook.
+//
+// Approach: scan backwards from the candidate index through the body and
+// track brace depth. If we encounter `function` / `=>` whose body wraps the
+// candidate, return true.
+//
+// This is a heuristic — we err on the side of accepting the call as
+// top-level (preserves recall) unless we find clear evidence of nesting.
+function isInsideNestedFunction(body, index) {
+    // Walk backwards counting braces; if we exit the outer body or hit a
+    // `function` / arrow before exiting, the call is nested.
+    let depth = 0;
+    for (let i = index - 1; i >= 0; i--) {
+        const c = body[i];
+        if (c === "}")
+            depth++;
+        else if (c === "{") {
+            if (depth === 0) {
+                // We are at the opening brace of the enclosing block. Inspect what
+                // precedes it: a `function ...(`, `() =>`, or `<id>(...)\s*` arrow
+                // body means this brace opens a nested function.
+                const head = body.slice(Math.max(0, i - 60), i);
+                if (/=>\s*$/.test(head))
+                    return true;
+                if (/\bfunction\b[^{}]*$/.test(head)) {
+                    // Could be the outer function's own opening brace — in that case
+                    // there are no more closing braces between i and the start, which
+                    // we already verified by depth==0. But the outer function's body
+                    // IS what we are scanning, so its opening brace marks the start
+                    // of the body, not a nested function. We assume the caller passes
+                    // a body slice that starts AFTER the outer `{`, so any `function`
+                    // we find here is necessarily nested.
+                    return true;
+                }
+                return false;
+            }
+            depth--;
+        }
+    }
+    return false;
+}
+/**
+ * Returns true if the function body slice contains at least one top-level
+ * call to a function named `use<Upper>…`. Filters out:
+ *   - member-access calls (`obj.useThing(`)
+ *   - calls nested inside an inner function/arrow declaration
+ *
+ * The body slice should start at the OPENING brace of the function body
+ * (or just after) so the nesting heuristic can attribute braces correctly.
+ */
+export function bodyCallsHook(body) {
+    HOOK_CALL_RE.lastIndex = 0;
+    let m;
+    while ((m = HOOK_CALL_RE.exec(body)) !== null) {
+        const idx = m.index;
+        if (isMemberAccessAt(body, idx))
+            continue;
+        if (isInsideNestedFunction(body, idx))
+            continue;
+        return true;
+    }
+    return false;
+}
+// JSX-return detection.
+//
+// Goal: distinguish `return <Tag …` (JSX) from TS type-position generics like
+// `return useMemo<Foo>(…)` / `return Array<X>(…)` / `return dynamic<T>(loader)`.
+//
+// Strategy: find every `return` followed by an expression, then for the first
+// `<` in that expression decide whether it opens a JSX element. JSX is
+// disambiguated by what FOLLOWS the `<`:
+//   - `<` (fragment opener `<>`) → JSX
+//   - `<UpperIdent` → JSX (component) UNLESS the next non-name char is `,`
+//     or the construct is clearly a generic-arg list
+//   - `<lowerIdent` where the identifier matches a known HTML tag → JSX
+//   - `</`  → JSX close (shouldn't appear at return start but cheap to accept)
+//   - anything else → not JSX
+//
+// We avoid full tokenization: a regex sweep over the body is enough because
+// the false-positive cases all share the property that `<` is preceded by a
+// JavaScript identifier or `)` (call/expression position), whereas a JSX `<`
+// at return position is preceded only by `return`, `(`, or whitespace.
+const RETURN_LT_RE = /\breturn\b\s*\(?\s*</g;
+// Common lowercase HTML / SVG tag names. Extending this list is cheap; we
+// only need enough coverage to avoid false negatives on hand-written
+// components. JSX with custom lowercase tags (`<my-component>`) is rare and
+// not idiomatic React.
+const HTML_TAGS = new Set([
+    "a", "abbr", "address", "area", "article", "aside", "audio", "b", "base", "bdi",
+    "bdo", "blockquote", "body", "br", "button", "canvas", "caption", "cite", "code",
+    "col", "colgroup", "data", "datalist", "dd", "del", "details", "dfn", "dialog",
+    "div", "dl", "dt", "em", "embed", "fieldset", "figcaption", "figure", "footer",
+    "form", "h1", "h2", "h3", "h4", "h5", "h6", "head", "header", "hgroup", "hr", "html",
+    "i", "iframe", "img", "input", "ins", "kbd", "label", "legend", "li", "link", "main",
+    "map", "mark", "meta", "meter", "nav", "noscript", "object", "ol", "optgroup",
+    "option", "output", "p", "param", "picture", "pre", "progress", "q", "rp", "rt",
+    "ruby", "s", "samp", "script", "section", "select", "slot", "small", "source",
+    "span", "strong", "style", "sub", "summary", "sup", "table", "tbody", "td",
+    "template", "textarea", "tfoot", "th", "thead", "time", "title", "tr", "track",
+    "u", "ul", "var", "video", "wbr",
+    "svg", "circle", "ellipse", "g", "line", "path", "polygon", "polyline", "rect",
+    "text", "defs", "linearGradient", "radialGradient", "stop", "clipPath", "mask",
+    "use", "symbol", "pattern", "filter", "feGaussianBlur", "feOffset", "feMerge",
+]);
+/**
+ * Returns true if the body slice contains a JSX-returning expression.
+ *
+ * Handles:
+ *   - `return <div>` → true (HTML tag)
+ *   - `return <Suspense/>` → true (Component)
+ *   - `return <>` → true (fragment)
+ *   - `return ( <Foo /> )` → true (parenthesized)
+ *   - `return useMemo<Foo>(...)` → false (generic at return)
+ *   - body containing `Array<X>` or `dynamic<T>(…)` elsewhere → false (no return prefix)
+ */
+export function bodyReturnsJsx(body) {
+    const scan = blankReturnObjectLiterals(body);
+    RETURN_LT_RE.lastIndex = 0;
+    let m;
+    while ((m = RETURN_LT_RE.exec(scan)) !== null) {
+        // Symmetric with bodyCallsHook: a `return <Foo/>` inside a nested
+        // function/arrow does NOT make the OUTER function JSX-returning.
+        if (isInsideNestedFunction(scan, m.index))
+            continue;
+        // The `<` that the regex matched starts at m.index + m[0].length - 1.
+        const ltIndex = m.index + m[0].length - 1;
+        if (looksLikeJsxOpenAt(scan, ltIndex))
+            return true;
+    }
+    return false;
+}
+// Replace every `return { ... }` object literal's contents with spaces so
+// JSX inside object values (factory pattern, e.g. `getMdxComponents`) is not
+// counted as evidence the outer function returns JSX. Whitespace-preserving
+// to keep indices stable for the subsequent regex scans.
+function blankReturnObjectLiterals(body) {
+    const RETURN_OBJ_RE = /\breturn\s*\{/g;
+    let out = body;
+    let m;
+    RETURN_OBJ_RE.lastIndex = 0;
+    while ((m = RETURN_OBJ_RE.exec(out)) !== null) {
+        const openIdx = m.index + m[0].length - 1;
+        let depth = 1;
+        let i = openIdx + 1;
+        for (; i < out.length; i++) {
+            const c = out[i];
+            if (c === "{")
+                depth++;
+            else if (c === "}") {
+                depth--;
+                if (depth === 0)
+                    break;
+            }
+        }
+        const endIdx = i;
+        const blanked = out.slice(openIdx + 1, endIdx).replace(/[^\n]/g, " ");
+        out = out.slice(0, openIdx + 1) + blanked + out.slice(endIdx);
+        RETURN_OBJ_RE.lastIndex = endIdx + 1;
+    }
+    return out;
+}
+function looksLikeJsxOpenAt(body, ltIndex) {
+    // Verify the char before `<` (skipping whitespace and one optional `(`)
+    // is `return` or `(`. RETURN_LT_RE guarantees this; this check is belt-
+    // and-suspenders against pathological matches.
+    const next = body[ltIndex + 1];
+    if (next === undefined)
+        return false;
+    // Fragment `<>` or close `</`
+    if (next === ">" || next === "/")
+        return true;
+    // Component `<UpperIdent`
+    if (/[A-Z]/.test(next)) {
+        // Read the identifier
+        let j = ltIndex + 1;
+        while (j < body.length && /[A-Za-z0-9_]/.test(body[j]))
+            j++;
+        const after = body[j];
+        // Reject `<UpperIdent,` (multi-param generic arrow / type-arg list:
+        // `<T,U>(x, y) => ...`).
+        if (after === ",")
+            return false;
+        // Reject bare generic arrow `<T>(x) => x`: shape is `<UpperIdent>` with
+        // `(` as the next non-whitespace char after `>`. Real JSX `<Foo>` is
+        // followed by children (text, `{`, `<`) or `</`, never by `(`.
+        if (after === ">") {
+            let k = j + 1;
+            while (k < body.length && /\s/.test(body[k]))
+                k++;
+            if (body[k] === "(")
+                return false;
+        }
+        return true;
+    }
+    // Lowercase identifier → HTML tag check
+    if (/[a-z]/.test(next)) {
+        let j = ltIndex + 1;
+        while (j < body.length && /[A-Za-z0-9-]/.test(body[j]))
+            j++;
+        const tag = body.slice(ltIndex + 1, j);
+        return HTML_TAGS.has(tag);
+    }
+    return false;
+}
+/**
+ * Extracts the body of a function declaration starting at `declStart` via
+ * naive brace matching. Returns the slice from just AFTER the opening `{`
+ * up to (but not including) the matching closing `}`.
+ *
+ * Defensive fallbacks:
+ *   - If no `{` is found at/after `declStart`, returns `source.slice(declStart)`
+ *     (matches prior naive behavior for declaration-only forms).
+ *   - If EOF is reached before depth returns to zero, returns everything from
+ *     just after the opening `{` to end-of-source.
+ *
+ * Future improvement: braces inside string/template literals or comments are
+ * NOT tracked. Current heuristic is sufficient for the rule surface that
+ * consumes this helper (component/hook naming detection on real React
+ * sources). Switch to a TS-AST extraction if FP/FN evidence emerges.
+ */
+export function extractFunctionBody(source, declStart) {
+    const open = source.indexOf("{", declStart);
+    if (open < 0)
+        return source.slice(declStart);
+    let depth = 1;
+    for (let i = open + 1; i < source.length; i++) {
+        const c = source[i];
+        if (c === "{")
+            depth++;
+        else if (c === "}") {
+            depth--;
+            if (depth === 0)
+                return source.slice(open + 1, i);
+        }
+    }
+    return source.slice(open + 1);
+}
+/**
+ * Returns true if `source` at `declStart` declares an implicit-return arrow
+ * function whose body is a JSX expression: `export const X = (...) => <JSX>`.
+ *
+ * `declStart` should point at the start of the export declaration (the same
+ * index `EXPORT_FUNC_RE` reports). We walk past `export … = (` and the param
+ * list, expect `=>`, and then check that the first non-whitespace char opens
+ * JSX (via the shared `looksLikeJsxOpenAt` disambiguator).
+ *
+ * Returns false for:
+ *   - block-body arrows (`=> {`) — caller should use `bodyReturnsJsx` instead
+ *   - non-JSX implicit returns (`=> text.toUpperCase()`)
+ *   - implicit returns whose JSX is inside a nested expression
+ *     (`xs => xs.map(x => <li/>)`)
+ */
+export function arrowImplicitReturnsJsx(source, declStart) {
+    const eq = source.indexOf("=", declStart);
+    if (eq < 0)
+        return false;
+    let i = eq + 1;
+    while (i < source.length && /\s/.test(source[i]))
+        i++;
+    if (source.slice(i, i + 5) === "async") {
+        i += 5;
+        while (i < source.length && /\s/.test(source[i]))
+            i++;
+    }
+    if (source[i] !== "(")
+        return false;
+    let depth = 1;
+    i++;
+    for (; i < source.length && depth > 0; i++) {
+        const c = source[i];
+        if (c === "(")
+            depth++;
+        else if (c === ")")
+            depth--;
+    }
+    if (depth !== 0)
+        return false;
+    while (i < source.length && /\s/.test(source[i]))
+        i++;
+    if (source[i] === ":") {
+        // Optional return-type annotation: skip until `=>`.
+        while (i < source.length && !(source[i] === "=" && source[i + 1] === ">"))
+            i++;
+    }
+    if (source[i] !== "=" || source[i + 1] !== ">")
+        return false;
+    i += 2;
+    while (i < source.length && /\s/.test(source[i]))
+        i++;
+    if (source[i] !== "<")
+        return false;
+    return looksLikeJsxOpenAt(source, i);
+}
+/**
+ * Filename / path evidence: a function is more likely to be a hook when it
+ * lives under `**\/hooks\/**` or in a file named `use-*.{ts,tsx,js,jsx}`.
+ */
+export function fileIsInHooksDir(filePath) {
+    // Normalise backslashes for cross-platform determinism.
+    const p = filePath.replace(/\\/g, "/");
+    if (/(^|\/)hooks\//.test(p))
+        return true;
+    const base = p.slice(p.lastIndexOf("/") + 1);
+    if (/^use-[\w.-]+\.(tsx?|jsx?)$/.test(base))
+        return true;
+    return false;
+}
+/**
+ * Filename-as-evidence refinement (issue #166).
+ *
+ * Returns true ONLY when the file is named `use-<kebab>.{ts,tsx,js,jsx}` AND
+ * `funcName` is the camelCase form of `<kebab>` — i.e. the function name
+ * literally matches what the filename advertises as the hook target
+ * (minus the `use` prefix).
+ *
+ * Examples:
+ *   use-toggle.ts          + "toggle"      → true
+ *   use-combine-ref.ts     + "combineRef"  → true
+ *   use-combine-ref.ts     + "composeRefs" → false  (co-located helper)
+ *   use-toggle.ts          + "useToggle"   → false  (already prefixed)
+ *   hooks/index.ts         + anything      → false  (no use-X filename)
+ *   lib/helpers.ts         + anything      → false  (not a use-X file)
+ *
+ * Used by `naming/hook-prefix` to gate path-evidence: a function in a
+ * `hooks/` directory is flagged via path alone only when its name matches
+ * the filename's advertised target. Unrelated co-located utilities are not
+ * flagged via path-evidence and must show body-call evidence to fire.
+ */
+export function filenameMatchesFunction(filePath, funcName) {
+    const p = filePath.replace(/\\/g, "/");
+    const base = p.slice(p.lastIndexOf("/") + 1);
+    const m = base.match(/^use-([\w.-]+)\.(?:tsx?|jsx?)$/);
+    if (!m)
+        return false;
+    const kebab = m[1];
+    // Convert kebab to camelCase: split on `-`, lowercase first segment,
+    // capitalize the rest. `combine-ref` → `combineRef`.
+    const parts = kebab.split("-").filter((s) => s.length > 0);
+    if (parts.length === 0)
+        return false;
+    const camel = parts[0].toLowerCase() +
+        parts
+            .slice(1)
+            .map((s) => s[0].toUpperCase() + s.slice(1).toLowerCase())
+            .join("");
+    return funcName === camel;
+}
+//# sourceMappingURL=_function-body-analysis.js.map

package/dist/rules/_function-body-analysis.js.map

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

package/dist/rules/_rule-module.d.ts

@@ -0,0 +1,31 @@
+import type { RuleModule } from "@typescript-eslint/utils/ts-eslint";
+import type { Rule, RuleContext, ParsedFiles, RuleEvalResult, AxisName, Severity, RuleMeta } from "../types.js";
+export type { RuleModule };
+export interface LyseRuleMeta {
+    axis: AxisName;
+    lyseRuleId: string;
+    defaultSeverity: Severity;
+    shortDescription: string;
+    fullDescription: string;
+    helpUri: string;
+    rationale: string;
+    examples: {
+        good: string;
+        bad: string;
+    }[];
+    allowlist: string[];
+}
+export type LyseEvaluator = (ctx: RuleContext, parsedFiles: ParsedFiles) => Promise<RuleEvalResult>;
+export interface LyseRuleDefinition<Options extends readonly unknown[] = []> {
+    meta: LyseRuleMeta;
+    defaultOptions: Options;
+    create: () => {
+        evaluate: LyseEvaluator;
+    };
+    classifyConfidence?: Rule["classifyConfidence"];
+    applyCodemod?: Rule["applyCodemod"];
+}
+export declare function createLyseRule<Options extends readonly unknown[] = []>(def: LyseRuleDefinition<Options>): Rule;
+export declare function getRegisteredRuleMeta(id: string): LyseRuleMeta | undefined;
+export declare function listRegisteredRuleMetas(): LyseRuleMeta[];
+export declare function toRuleMeta(m: LyseRuleMeta): RuleMeta;

package/dist/rules/_rule-module.js

@@ -0,0 +1,32 @@
+const META_REGISTRY = new Map();
+export function createLyseRule(def) {
+    META_REGISTRY.set(def.meta.lyseRuleId, def.meta);
+    const { evaluate } = def.create();
+    return {
+        id: def.meta.lyseRuleId,
+        axis: def.meta.axis,
+        evaluate,
+        ...(def.classifyConfidence ? { classifyConfidence: def.classifyConfidence } : {}),
+        ...(def.applyCodemod ? { applyCodemod: def.applyCodemod } : {}),
+    };
+}
+export function getRegisteredRuleMeta(id) {
+    return META_REGISTRY.get(id);
+}
+export function listRegisteredRuleMetas() {
+    return Array.from(META_REGISTRY.values());
+}
+export function toRuleMeta(m) {
+    return {
+        id: m.lyseRuleId,
+        axis: m.axis,
+        defaultSeverity: m.defaultSeverity,
+        shortDescription: m.shortDescription,
+        fullDescription: m.fullDescription,
+        helpUri: m.helpUri,
+        rationale: m.rationale,
+        examples: m.examples,
+        allowlist: m.allowlist,
+    };
+}
+//# sourceMappingURL=_rule-module.js.map

package/dist/rules/_rule-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_rule-module.js","sourceRoot":"","sources":["../../src/rules/_rule-module.ts"],"names":[],"mappings":"AAwCA,MAAM,aAAa,GAAG,IAAI,GAAG,EAAwB,CAAC;AAEtD,MAAM,UAAU,cAAc,CAE5B,GAAgC;IAChC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;IAClC,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,UAAU;QACvB,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI;QACnB,QAAQ;QACR,GAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,GAAG,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,EAAU;IAC9C,OAAO,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,CAAe;IACxC,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,UAAU;QAChB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,eAAe,EAAE,CAAC,CAAC,eAAe;QAClC,gBAAgB,EAAE,CAAC,CAAC,gBAAgB;QACpC,eAAe,EAAE,CAAC,CAAC,eAAe;QAClC,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,SAAS,EAAE,CAAC,CAAC,SAAS;KACvB,CAAC;AACJ,CAAC"}

package/dist/rules/_skip-context.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Shared skip-context helpers used by tokens/no-hardcoded-color and
+ * tokens/no-hardcoded-spacing to suppress intentional false positives.
+ *
+ * NOTE: All helpers are SAME-LINE heuristics only. Multi-line <code> / <pre>
+ * blocks, or JSX expressions like sizes={"..."}, would require AST traversal
+ * — that is V1 work.
+ */
+/**
+ * Returns true if the byte offset `index` in `source` falls inside a
+ * `<code>...</code>` or `<pre>...</pre>` block that opens AND closes on the
+ * same line as the match. Useful for skipping display-only CSS examples
+ * rendered by shadcn theme customizers.
+ *
+ * Limitation: multi-line code blocks are NOT detected. V1 needs AST context.
+ */
+export declare function isInsideCodeDisplay(source: string, index: number): boolean;
+/**
+ * Returns true if `index` is inside the quoted value of a JSX attribute we
+ * intentionally skip (sizes, srcSet, media — responsive image markup).
+ */
+export declare function isInsideSkippedJsxAttr(source: string, index: number): boolean;
+/**
+ * Returns true if the byte offset `index` falls on the right-hand side of a
+ * CSS custom-property declaration — i.e. `--<name>:` followed by the value.
+ *
+ * Token *definitions* (`:root { --color: #fff }`, `@theme { --space: 16px }`)
+ * are the source of truth for the design system and must never be flagged
+ * as hardcoded drift. The guard is property-name-based so it works regardless
+ * of the enclosing selector (`:root`, `@theme`, `[data-theme=...]`, etc.).
+ *
+ * Walks back from `index` to the nearest declaration boundary (`;`, `{`, `}`,
+ * or buffer start) skipping whitespace, then checks whether the property name
+ * starts with `--`.
+ */
+export declare function isCssCustomPropertyDeclaration(source: string, index: number): boolean;

package/dist/rules/_skip-context.js

@@ -0,0 +1,128 @@
+/**
+ * Shared skip-context helpers used by tokens/no-hardcoded-color and
+ * tokens/no-hardcoded-spacing to suppress intentional false positives.
+ *
+ * NOTE: All helpers are SAME-LINE heuristics only. Multi-line <code> / <pre>
+ * blocks, or JSX expressions like sizes={"..."}, would require AST traversal
+ * — that is V1 work.
+ */
+/**
+ * Returns true if the byte offset `index` in `source` falls inside a
+ * `<code>...</code>` or `<pre>...</pre>` block that opens AND closes on the
+ * same line as the match. Useful for skipping display-only CSS examples
+ * rendered by shadcn theme customizers.
+ *
+ * Limitation: multi-line code blocks are NOT detected. V1 needs AST context.
+ */
+export function isInsideCodeDisplay(source, index) {
+    const lineStart = source.lastIndexOf("\n", index - 1) + 1;
+    let lineEnd = source.indexOf("\n", index);
+    if (lineEnd === -1)
+        lineEnd = source.length;
+    const line = source.slice(lineStart, lineEnd);
+    const posInLine = index - lineStart;
+    for (const tag of ["code", "pre"]) {
+        const openTag = `<${tag}>`;
+        const closeTag = `</${tag}>`;
+        let openIdx = -1;
+        while ((openIdx = line.indexOf(openTag, openIdx + 1)) !== -1) {
+            const closeIdx = line.indexOf(closeTag, openIdx + openTag.length);
+            if (closeIdx !== -1 && openIdx < posInLine && posInLine < closeIdx) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * JSX attributes whose string values should be excluded from spacing checks.
+ * These carry responsive image / media-query breakpoint values (px, vw, etc.)
+ * that are NOT design tokens.
+ *
+ * NOTE: the `sizes={"..."}` JSX-expression form is NOT handled by this regex.
+ * V1 work — requires AST traversal to detect the expression boundary.
+ */
+const SKIP_JSX_ATTRS = ["sizes", "srcSet", "srcset", "media"];
+/**
+ * Returns true if `index` is inside the quoted value of a JSX attribute we
+ * intentionally skip (sizes, srcSet, media — responsive image markup).
+ */
+export function isInsideSkippedJsxAttr(source, index) {
+    const lineStart = source.lastIndexOf("\n", index - 1) + 1;
+    let lineEnd = source.indexOf("\n", index);
+    if (lineEnd === -1)
+        lineEnd = source.length;
+    const line = source.slice(lineStart, lineEnd);
+    const posInLine = index - lineStart;
+    for (const attr of SKIP_JSX_ATTRS) {
+        // Matches: attr="..." or attr='...'
+        // The sizes={"..."} form requires AST — deferred to V1.
+        const re = new RegExp(`${attr}\\s*=\\s*(?:"([^"]*)"|'([^']*)')`, "g");
+        let am;
+        while ((am = re.exec(line)) !== null) {
+            const value = am[1] ?? am[2] ?? "";
+            const quoteIdx = am.index + am[0].indexOf(value);
+            const valueStart = quoteIdx;
+            const valueEnd = quoteIdx + value.length;
+            if (posInLine >= valueStart && posInLine <= valueEnd)
+                return true;
+        }
+    }
+    return false;
+}
+/**
+ * Returns true if the byte offset `index` falls on the right-hand side of a
+ * CSS custom-property declaration — i.e. `--<name>:` followed by the value.
+ *
+ * Token *definitions* (`:root { --color: #fff }`, `@theme { --space: 16px }`)
+ * are the source of truth for the design system and must never be flagged
+ * as hardcoded drift. The guard is property-name-based so it works regardless
+ * of the enclosing selector (`:root`, `@theme`, `[data-theme=...]`, etc.).
+ *
+ * Walks back from `index` to the nearest declaration boundary (`;`, `{`, `}`,
+ * or buffer start) skipping whitespace, then checks whether the property name
+ * starts with `--`.
+ */
+export function isCssCustomPropertyDeclaration(source, index) {
+    let colonIdx = -1;
+    let depth = 0;
+    for (let i = index - 1; i >= 0; i--) {
+        const c = source[i];
+        if (c === ")") {
+            depth++;
+            continue;
+        }
+        if (c === "(") {
+            if (depth > 0)
+                depth--;
+            continue;
+        }
+        if (depth > 0)
+            continue;
+        if (c === ";" || c === "{" || c === "}")
+            return false;
+        if (c === ":") {
+            colonIdx = i;
+            break;
+        }
+    }
+    if (colonIdx < 0)
+        return false;
+    let end = colonIdx;
+    while (end > 0) {
+        const c = source[end - 1] ?? "";
+        if (!/\s/.test(c))
+            break;
+        end--;
+    }
+    let start = end;
+    while (start > 0) {
+        const c = source[start - 1] ?? "";
+        if (!/[a-zA-Z0-9_-]/.test(c))
+            break;
+        start--;
+    }
+    const propName = source.slice(start, end);
+    return propName.startsWith("--");
+}
+//# sourceMappingURL=_skip-context.js.map

package/dist/rules/_skip-context.js.map

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

package/dist/rules/a11y-essentials.d.ts

@@ -0,0 +1 @@
+export declare const rule: import("../types.js").Rule;