code-auditor-mcp 5.0.1 → 5.2.0

package/dist/sqlite/driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../src/sqlite/driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACb,cAAc,EACf,MAAM,YAAY,CAAC;AAMpB;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAEzC,uEAAuE;AACvE,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,SAAS,CAE5D;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAO9C;AAoBD;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,cAAc,CAyClF"}
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../src/sqlite/driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACb,cAAc,EACf,MAAM,YAAY,CAAC;AAMpB;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAEzC,uEAAuE;AACvE,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,SAAS,CAE5D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,SAAS,CAE1D;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,aAAa,CAE9D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAU9C;AAoBD;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,cAAc,CAyClF"}

package/dist/sqlite/driver.js

@@ -27,18 +27,41 @@ export const DB_BUSY_TIMEOUT_MS = 30_000;
 export function getActiveBackend() {
     return activeBackend;
 }
+/**
+ * The `CODE_AUDITOR_SQLITE_BACKEND` override, raw. Single read site: both
+ * `describeSqliteBackend` (report surface) and `openSqlite` (enforcement
+ * surface) consume this, so they can never disagree on *what* the override is —
+ * only on what to do with it (report names the invalid value as invalid;
+ * enforcement throws).
+ */
+export function sqliteBackendOverride() {
+    return process.env.CODE_AUDITOR_SQLITE_BACKEND;
+}
+/** True when `v` is one of the two supported backend names. */
+export function isSqliteBackend(v) {
+    return v === 'node-sqlite' || v === 'better-sqlite3';
+}
 /**
  * Human-readable backend for `--version`. Reports the forced override when set,
  * otherwise the last backend an {@link openSqlite} selected, otherwise a
  * capability probe (which builtin is actually loadable on this Node). "none"
  * when neither backend can load.
  *
- * @returns The active (or likely) backend name, or "none".
+ * An override that is not one of the two supported names is reported *as
+ * invalid*, not silently probed past: `openSqlite` throws on the same value, so
+ * a diagnostic that named a plausible backend would be a wrong answer on the
+ * surface people check first.
+ *
+ * @returns The active (or likely) backend name, "none", or a string naming the
+ *          invalid override and the two accepted values.
  */
 export function describeSqliteBackend() {
-    const override = process.env.CODE_AUDITOR_SQLITE_BACKEND;
-    if (override === 'node-sqlite' || override === 'better-sqlite3')
+    const override = sqliteBackendOverride();
+    if (isSqliteBackend(override))
         return override;
+    if (override !== undefined) {
+        return `invalid (CODE_AUDITOR_SQLITE_BACKEND="${override}" is not a recognised backend; expected "node-sqlite" or "better-sqlite3")`;
+    }
     if (activeBackend !== undefined)
         return activeBackend;
     if (isNodeSqliteAvailable())
@@ -73,8 +96,8 @@ function loudFailure(tried, errors) {
  * @returns An open database, or throws when no backend is usable.
  */
 export function openSqlite(dbPath, opts) {
-    const override = process.env.CODE_AUDITOR_SQLITE_BACKEND;
-    if (override !== undefined && override !== 'node-sqlite' && override !== 'better-sqlite3') {
+    const override = sqliteBackendOverride();
+    if (override !== undefined && !isSqliteBackend(override)) {
         throw new Error(`Invalid CODE_AUDITOR_SQLITE_BACKEND: "${override}" (expected "node-sqlite" or "better-sqlite3")`);
     }
     const construct = (backend) => backend === 'node-sqlite'

package/dist/sqlite/driver.js.map

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

package/dist/styles/cssInJsHarvest.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Parser-based defined-class harvest for TS/JS CSS-in-JS tagged templates
+ * (Spec 45, Piece 3 of the keyframe-pollution fix).
+ *
+ * The TS/JS source path used to scrape class names out of a declaration's
+ * selector `context` with `scanClassNamesFromSelector` — but the CSS-in-JS
+ * declaration extractor hardcodes `context: 'styled'` (no class names) and its
+ * `{` filter drops every declaration whose line carries a nested block, so a
+ * class defined inside a nested CSS-in-JS block never entered the catalog and
+ * using it in markup produced a false `styles/undefined-class` finding. This
+ * module routes each CSS-in-JS template body through the *same* CSS parser the
+ * `.css`/`.scss` and markup paths use (`parseFile` + `extractClassUsageFromCSSAst`),
+ * so the discriminant for "is this a keyframes at-rule" is what the parser
+ * reports: keyframe selectors (`from`/`to`/percentages) are structurally absent
+ * from the `class_name`-under-`class_selector` walk, and there is no
+ * hand-maintained at-rule-name list anywhere in the path.
+ *
+ * The template bodies and their boundaries come from `collectCssInJsBlocks`
+ * (`styleExtractor.ts`), the same single source of truth the declaration
+ * extractor reads, so the two harvests can never disagree on which templates
+ * count as CSS-in-JS or what their CSS body text is.
+ */
+import type { AST } from '../languages/types.js';
+import type { DefinedClassRef } from './definedClasses.js';
+/**
+ * Harvest the defined classes (`.foo` selectors) from one TS/JS file's CSS-in-JS
+ * tagged templates, using the CSS parser rather than a selector pattern.
+ *
+ * @param filePath The source path (becomes the catalog `file_path`).
+ * @param sourceCode The raw TS/JS source.
+ * @param ast The parsed TS/JS AST (locates the template nodes); null/absent
+ *   yields an empty harvest, matching the declaration extractor's `!ast` guard.
+ * @returns One entry per distinct (className, filePath) defined selector.
+ */
+export declare function harvestCssInJsStyleClasses(filePath: string, sourceCode: string, ast?: AST): DefinedClassRef[];
+//# sourceMappingURL=cssInJsHarvest.d.ts.map

package/dist/styles/cssInJsHarvest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cssInJsHarvest.d.ts","sourceRoot":"","sources":["../../src/styles/cssInJsHarvest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAMH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,GAAG,GACR,eAAe,EAAE,CAuCnB"}

package/dist/styles/cssInJsHarvest.js

@@ -0,0 +1,78 @@
+/**
+ * Parser-based defined-class harvest for TS/JS CSS-in-JS tagged templates
+ * (Spec 45, Piece 3 of the keyframe-pollution fix).
+ *
+ * The TS/JS source path used to scrape class names out of a declaration's
+ * selector `context` with `scanClassNamesFromSelector` — but the CSS-in-JS
+ * declaration extractor hardcodes `context: 'styled'` (no class names) and its
+ * `{` filter drops every declaration whose line carries a nested block, so a
+ * class defined inside a nested CSS-in-JS block never entered the catalog and
+ * using it in markup produced a false `styles/undefined-class` finding. This
+ * module routes each CSS-in-JS template body through the *same* CSS parser the
+ * `.css`/`.scss` and markup paths use (`parseFile` + `extractClassUsageFromCSSAst`),
+ * so the discriminant for "is this a keyframes at-rule" is what the parser
+ * reports: keyframe selectors (`from`/`to`/percentages) are structurally absent
+ * from the `class_name`-under-`class_selector` walk, and there is no
+ * hand-maintained at-rule-name list anywhere in the path.
+ *
+ * The template bodies and their boundaries come from `collectCssInJsBlocks`
+ * (`styleExtractor.ts`), the same single source of truth the declaration
+ * extractor reads, so the two harvests can never disagree on which templates
+ * count as CSS-in-JS or what their CSS body text is.
+ */
+import { collectCssInJsBlocks } from './styleExtractor.js';
+import { extractClassUsageFromCSSAst } from './cssAstExtractor.js';
+import { parseFile } from '../languages/adapterBridge.js';
+import { LanguageRegistry } from '../languages/LanguageRegistry.js';
+/**
+ * Harvest the defined classes (`.foo` selectors) from one TS/JS file's CSS-in-JS
+ * tagged templates, using the CSS parser rather than a selector pattern.
+ *
+ * @param filePath The source path (becomes the catalog `file_path`).
+ * @param sourceCode The raw TS/JS source.
+ * @param ast The parsed TS/JS AST (locates the template nodes); null/absent
+ *   yields an empty harvest, matching the declaration extractor's `!ast` guard.
+ * @returns One entry per distinct (className, filePath) defined selector.
+ */
+export function harvestCssInJsStyleClasses(filePath, sourceCode, ast) {
+    if (!ast)
+        return [];
+    const bodies = collectCssInJsBlocks(ast, sourceCode);
+    if (bodies.length === 0)
+        return [];
+    const registry = LanguageRegistry.getInstance();
+    const refs = [];
+    const seen = new Set();
+    for (const body of bodies) {
+        // A synthetic path selects the CSS grammar in `parseFile` and the matching
+        // adapter in `getAdapterForFile`. The real TS/JS path is threaded to
+        // `extractClassUsageFromCSSAst` as `filePath` so the catalog records the
+        // source file, not the synthetic one. CSS-in-JS templates are CSS (not SCSS),
+        // so the dialect is fixed to `css` — unlike markup `<style lang="scss">`.
+        const syntheticPath = 'embedded.css';
+        const adapter = registry.getAdapterForFile(syntheticPath);
+        if (!adapter)
+            continue;
+        const ast2 = parseFile(syntheticPath, body);
+        if (!ast2)
+            continue;
+        try {
+            for (const u of extractClassUsageFromCSSAst(ast2, adapter, filePath, body)) {
+                if (u.unresolvable)
+                    continue; // `&`-references are uses, not definitions.
+                // `filePath` is the single TS/JS path threaded in above, so `className`
+                // alone is a unique key for this file; dedup collapses a class selector
+                // that appears in more than one template.
+                if (seen.has(u.className))
+                    continue;
+                seen.add(u.className);
+                refs.push({ className: u.className, filePath: u.filePath });
+            }
+        }
+        finally {
+            ast2.dispose?.();
+        }
+    }
+    return refs;
+}
+//# sourceMappingURL=cssInJsHarvest.js.map

package/dist/styles/cssInJsHarvest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cssInJsHarvest.js","sourceRoot":"","sources":["../../src/styles/cssInJsHarvest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAIpE;;;;;;;;;GASG;AACH,MAAM,UAAU,0BAA0B,CACxC,QAAgB,EAChB,UAAkB,EAClB,GAAS;IAET,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IAEpB,MAAM,MAAM,GAAG,oBAAoB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACrD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,WAAW,EAAE,CAAC;IAChD,MAAM,IAAI,GAAsB,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,2EAA2E;QAC3E,qEAAqE;QACrE,yEAAyE;QACzE,8EAA8E;QAC9E,0EAA0E;QAC1E,MAAM,aAAa,GAAG,cAAc,CAAC;QACrC,MAAM,OAAO,GAAG,QAAQ,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;QAC1D,IAAI,CAAC,OAAO;YAAE,SAAS;QAEvB,MAAM,IAAI,GAAG,SAAS,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,IAAI,CAAC;YACH,KAAK,MAAM,CAAC,IAAI,2BAA2B,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;gBAC3E,IAAI,CAAC,CAAC,YAAY;oBAAE,SAAS,CAAC,4CAA4C;gBAC1E,wEAAwE;gBACxE,wEAAwE;gBACxE,0CAA0C;gBAC1C,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;oBAAE,SAAS;gBACpC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;gBACtB,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/styles/definedClasses.d.ts

@@ -0,0 +1,95 @@
+/**
+ * The single source of truth for the defined-class catalog (Spec 45) — the set
+ * of `.foo` class selectors a stylesheet *defines*, which `styles/undefined-class`
+ * resolves candidate class usages against.
+ *
+ * Every writer of the catalog used to scrape class names out of a declaration's
+ * selector `context` with the regex `/\.([a-zA-Z0-9_-]+)/g`. That form is wrong
+ * twice: it admits a keyframe percentage like `15.8%` (the `.` before `8` is a
+ * decimal point, not a class selector), and it cannot tell a style-rule selector
+ * from a keyframe selector. The CSS path already harvests class selectors
+ * structurally — `extractClassUsageFromCSSAst` walks `class_name` nodes under
+ * `class_selector`, so keyframes (whose selectors are `from`/`to`/percentages,
+ * per the CSS grammar) never appear. Every live catalog writer now uses the
+ * parser harvest: CSS/SCSS read the parser walk (`classUsage`); markup parses
+ * each embedded `<style>` block body with the CSS parser
+ * (`harvestMarkupStyleClasses`); TS/JS source parses each CSS-in-JS template
+ * body with the same parser (`harvestCssInJsStyleClasses`). No live path scans
+ * the selector `context` anymore. The `@keyframes` at-rule discriminant
+ * (`isKeyframeVariant`) survives only on the migration-backfill path, which
+ * replays legacy `style_declarations` rows whose `variant_context` carried the
+ * at-rule — see that function's doc.
+ */
+export interface DefinedClassRef {
+    className: string;
+    filePath: string;
+}
+/** The minimal declaration shape the harvest reads. The phase `StylesDeclaration`,
+ *  the legacy `NormalizedDeclaration`, and the inline object literals the pipeline
+ *  adapters pass all satisfy it structurally. */
+interface ClassDeclContext {
+    context: string | null;
+    variantContext: string | null;
+    filePath: string;
+}
+/** The minimal class-usage shape the CSS branch reads (parser harvest). */
+interface ClassUsageContext {
+    className: string;
+    filePath: string;
+    unresolvable: boolean;
+}
+/**
+ * Scan a selector string for class names (`.foo`). A class selector's name must
+ * begin with an identifier-start character (a letter, `_`, or `-`) — a decimal
+ * point in a keyframe percentage like `15.8%` is followed by a digit and so
+ * contributes nothing even before the caller's keyframe check. This is the
+ * markup/source fallback; the CSS path uses the parser instead of this scanner.
+ *
+ * @param selector - The CSS selector string to scan (a declaration's `context`).
+ * @returns The `.`-prefixed class names in `selector`, in source order.
+ */
+export declare function scanClassNamesFromSelector(selector: string): string[];
+/**
+ * True when a declaration's variant context names the `@keyframes` at-rule — the
+ * one at-rule whose inner selectors are keyframe selectors rather than style-rule
+ * class selectors. The name may carry a leading `@` and may be the first or a
+ * later at-rule in the stack.
+ *
+ * Live path: none. Every live catalog writer excludes keyframes structurally —
+ * CSS/SCSS via the parser's `class_name`-under-`class_selector` walk, markup via
+ * `harvestMarkupStyleClasses`, and TS/JS source via `harvestCssInJsStyleClasses`
+ * (both of which route a template body through `parseFile` +
+ * `extractClassUsageFromCSSAst`). The only caller that can supply a non-null
+ * `variantContext` — and therefore reach this function — is the v11→v12
+ * backfill migration (`codeIndex/migrations.ts:1164`), which replays legacy
+ * `style_declarations` rows whose `variant_context` came from the CSS AST
+ * extractor's at-rule context (`cssAstExtractor.ts:584` writes `@keyframes
+ * <name>`; `getVariantContext` at `cssAstExtractor.ts:64` writes the enclosing
+ * `@media`/`@supports`/`@layer` stack).
+ */
+export declare function isKeyframeVariant(variantContext: string | null): boolean;
+/**
+ * The canonical defined-class harvest for one styles file.
+ *
+ * `isCss` selects the source. CSS/SCSS files carry a parser-harvested
+ * `classUsage` (each entry a `.foo` selector; keyframes excluded structurally;
+ * SCSS `&`-patterns marked `unresolvable`, which are references rather than
+ * definitions). Markup and TS/JS source definitions are harvested separately by
+ * `harvestMarkupStyleClasses` and `harvestCssInJsStyleClasses` respectively (the
+ * CSS parser over each `<style>` block / CSS-in-JS template body) and are not
+ * passed here. The `isCss === false` branch below — the selector-`context` scan
+ * — is therefore reached only by the migration-backfill path
+ * (`codeIndex/migrations.ts:1164`), which replays legacy rows whose `context`
+ * carried a selector string and whose `variant_context` carried the at-rule
+ * stack; that is the one remaining consumer of the `isKeyframeVariant` skip.
+ *
+ * @param declarations - The file's declaration contexts (selector plus the
+ *   enclosing at-rule stack), the legacy selector-scan source.
+ * @param classUsage - The parser-harvested class selectors (the CSS/SCSS source).
+ * @param isCss - True when the source is a CSS/SCSS file, so the harvest reads
+ *   `classUsage`; false selects the legacy selector scan over `declarations`.
+ * @returns The file's defined-class references (`className` + `filePath`).
+ */
+export declare function harvestDefinedClasses(declarations: readonly ClassDeclContext[], classUsage: readonly ClassUsageContext[], isCss: boolean): DefinedClassRef[];
+export {};
+//# sourceMappingURL=definedClasses.d.ts.map

package/dist/styles/definedClasses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definedClasses.d.ts","sourceRoot":"","sources":["../../src/styles/definedClasses.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;iDAEiD;AACjD,UAAU,gBAAgB;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,2EAA2E;AAC3E,UAAU,iBAAiB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;CACvB;AAwBD;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAWrE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAGxE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,SAAS,gBAAgB,EAAE,EACzC,UAAU,EAAE,SAAS,iBAAiB,EAAE,EACxC,KAAK,EAAE,OAAO,GACb,eAAe,EAAE,CAgBnB"}

package/dist/styles/definedClasses.js

@@ -0,0 +1,129 @@
+/**
+ * The single source of truth for the defined-class catalog (Spec 45) — the set
+ * of `.foo` class selectors a stylesheet *defines*, which `styles/undefined-class`
+ * resolves candidate class usages against.
+ *
+ * Every writer of the catalog used to scrape class names out of a declaration's
+ * selector `context` with the regex `/\.([a-zA-Z0-9_-]+)/g`. That form is wrong
+ * twice: it admits a keyframe percentage like `15.8%` (the `.` before `8` is a
+ * decimal point, not a class selector), and it cannot tell a style-rule selector
+ * from a keyframe selector. The CSS path already harvests class selectors
+ * structurally — `extractClassUsageFromCSSAst` walks `class_name` nodes under
+ * `class_selector`, so keyframes (whose selectors are `from`/`to`/percentages,
+ * per the CSS grammar) never appear. Every live catalog writer now uses the
+ * parser harvest: CSS/SCSS read the parser walk (`classUsage`); markup parses
+ * each embedded `<style>` block body with the CSS parser
+ * (`harvestMarkupStyleClasses`); TS/JS source parses each CSS-in-JS template
+ * body with the same parser (`harvestCssInJsStyleClasses`). No live path scans
+ * the selector `context` anymore. The `@keyframes` at-rule discriminant
+ * (`isKeyframeVariant`) survives only on the migration-backfill path, which
+ * replays legacy `style_declarations` rows whose `variant_context` carried the
+ * at-rule — see that function's doc.
+ */
+function isIdentifierStart(c) {
+    if (!c)
+        return false;
+    const code = c.charCodeAt(0);
+    return ((code >= 97 && code <= 122) || // a-z
+        (code >= 65 && code <= 90) || // A-Z
+        c === '_' ||
+        c === '-');
+}
+function isIdentifierPart(c) {
+    const code = c.charCodeAt(0);
+    return ((code >= 97 && code <= 122) || // a-z
+        (code >= 65 && code <= 90) || // A-Z
+        (code >= 48 && code <= 57) || // 0-9
+        c === '_' ||
+        c === '-');
+}
+/**
+ * Scan a selector string for class names (`.foo`). A class selector's name must
+ * begin with an identifier-start character (a letter, `_`, or `-`) — a decimal
+ * point in a keyframe percentage like `15.8%` is followed by a digit and so
+ * contributes nothing even before the caller's keyframe check. This is the
+ * markup/source fallback; the CSS path uses the parser instead of this scanner.
+ *
+ * @param selector - The CSS selector string to scan (a declaration's `context`).
+ * @returns The `.`-prefixed class names in `selector`, in source order.
+ */
+export function scanClassNamesFromSelector(selector) {
+    const names = [];
+    for (let i = 0; i < selector.length; i++) {
+        if (selector[i] !== '.')
+            continue;
+        if (!isIdentifierStart(selector[i + 1]))
+            continue;
+        let j = i + 2;
+        while (j < selector.length && isIdentifierPart(selector[j]))
+            j++;
+        names.push(selector.slice(i + 1, j));
+        i = j - 1;
+    }
+    return names;
+}
+/**
+ * True when a declaration's variant context names the `@keyframes` at-rule — the
+ * one at-rule whose inner selectors are keyframe selectors rather than style-rule
+ * class selectors. The name may carry a leading `@` and may be the first or a
+ * later at-rule in the stack.
+ *
+ * Live path: none. Every live catalog writer excludes keyframes structurally —
+ * CSS/SCSS via the parser's `class_name`-under-`class_selector` walk, markup via
+ * `harvestMarkupStyleClasses`, and TS/JS source via `harvestCssInJsStyleClasses`
+ * (both of which route a template body through `parseFile` +
+ * `extractClassUsageFromCSSAst`). The only caller that can supply a non-null
+ * `variantContext` — and therefore reach this function — is the v11→v12
+ * backfill migration (`codeIndex/migrations.ts:1164`), which replays legacy
+ * `style_declarations` rows whose `variant_context` came from the CSS AST
+ * extractor's at-rule context (`cssAstExtractor.ts:584` writes `@keyframes
+ * <name>`; `getVariantContext` at `cssAstExtractor.ts:64` writes the enclosing
+ * `@media`/`@supports`/`@layer` stack).
+ */
+export function isKeyframeVariant(variantContext) {
+    if (!variantContext)
+        return false;
+    return /(^|,)\s*@?keyframes\b/i.test(variantContext);
+}
+/**
+ * The canonical defined-class harvest for one styles file.
+ *
+ * `isCss` selects the source. CSS/SCSS files carry a parser-harvested
+ * `classUsage` (each entry a `.foo` selector; keyframes excluded structurally;
+ * SCSS `&`-patterns marked `unresolvable`, which are references rather than
+ * definitions). Markup and TS/JS source definitions are harvested separately by
+ * `harvestMarkupStyleClasses` and `harvestCssInJsStyleClasses` respectively (the
+ * CSS parser over each `<style>` block / CSS-in-JS template body) and are not
+ * passed here. The `isCss === false` branch below — the selector-`context` scan
+ * — is therefore reached only by the migration-backfill path
+ * (`codeIndex/migrations.ts:1164`), which replays legacy rows whose `context`
+ * carried a selector string and whose `variant_context` carried the at-rule
+ * stack; that is the one remaining consumer of the `isKeyframeVariant` skip.
+ *
+ * @param declarations - The file's declaration contexts (selector plus the
+ *   enclosing at-rule stack), the legacy selector-scan source.
+ * @param classUsage - The parser-harvested class selectors (the CSS/SCSS source).
+ * @param isCss - True when the source is a CSS/SCSS file, so the harvest reads
+ *   `classUsage`; false selects the legacy selector scan over `declarations`.
+ * @returns The file's defined-class references (`className` + `filePath`).
+ */
+export function harvestDefinedClasses(declarations, classUsage, isCss) {
+    if (isCss) {
+        return classUsage
+            .filter((u) => !u.unresolvable)
+            .map((u) => ({ className: u.className, filePath: u.filePath }));
+    }
+    const out = [];
+    for (const d of declarations) {
+        const ctx = d.context;
+        if (!ctx)
+            continue;
+        if (isKeyframeVariant(d.variantContext))
+            continue;
+        for (const className of scanClassNamesFromSelector(ctx)) {
+            out.push({ className, filePath: d.filePath });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=definedClasses.js.map

package/dist/styles/definedClasses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definedClasses.js","sourceRoot":"","sources":["../../src/styles/definedClasses.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAuBH,SAAS,iBAAiB,CAAC,CAAqB;IAC9C,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACrB,MAAM,IAAI,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC7B,OAAO,CACL,CAAC,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,GAAG,CAAC,IAAI,MAAM;QACrC,CAAC,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,IAAI,MAAM;QACpC,CAAC,KAAK,GAAG;QACT,CAAC,KAAK,GAAG,CACV,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,CAAS;IACjC,MAAM,IAAI,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC7B,OAAO,CACL,CAAC,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,GAAG,CAAC,IAAI,MAAM;QACrC,CAAC,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,IAAI,MAAM;QACpC,CAAC,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,IAAI,MAAM;QACpC,CAAC,KAAK,GAAG;QACT,CAAC,KAAK,GAAG,CACV,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,0BAA0B,CAAC,QAAgB;IACzD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,GAAG;YAAE,SAAS;QAClC,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,SAAS;QAClD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,IAAI,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAAE,CAAC,EAAE,CAAC;QACjE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACrC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,iBAAiB,CAAC,cAA6B;IAC7D,IAAI,CAAC,cAAc;QAAE,OAAO,KAAK,CAAC;IAClC,OAAO,wBAAwB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,qBAAqB,CACnC,YAAyC,EACzC,UAAwC,EACxC,KAAc;IAEd,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,UAAU;aACd,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;aAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IACpE,CAAC;IACD,MAAM,GAAG,GAAsB,EAAE,CAAC;IAClC,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC;QACtB,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,IAAI,iBAAiB,CAAC,CAAC,CAAC,cAAc,CAAC;YAAE,SAAS;QAClD,KAAK,MAAM,SAAS,IAAI,0BAA0B,CAAC,GAAG,CAAC,EAAE,CAAC;YACxD,GAAG,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/styles/markupStyleHarvest.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Parser-based defined-class harvest for markup `<style>` blocks (Spec 45,
+ * Piece 2 of the keyframe-pollution fix).
+ *
+ * The markup path used to scrape class names out of the regex-scraped selector
+ * `context` with `scanClassNamesFromSelector` — a character-minimum pattern that
+ * cannot tell a style-rule selector from a keyframe selector and admits decimal
+ * points in keyframe percentages as class-selector dots. This module routes each
+ * readable embedded `<style>` block body through the *same* CSS parser the
+ * `.css`/`.scss` path uses (`parseFile` + `extractClassUsageFromCSSAst`), so the
+ * discriminant for "is this a keyframes at-rule" is what the parser reports:
+ * keyframe selectors (`from`/`to`/percentages) are structurally absent from the
+ * `class_name`-under-`class_selector` walk, and there is no hand-maintained
+ * at-rule-name list anywhere in the path.
+ *
+ * The block boundaries and dialect (`css`/`scss`) come from `collectStyleBlocks`,
+ * the same single source of truth the declaration extractor reads, so the two
+ * harvests can never disagree. Unread dialects (`sass`/`less`/`styl`/…) are
+ * dropped by `collectStyleBlocks` before this function runs — exactly the
+ * dialects the regex declaration path also skips, so the catalog never asserts a
+ * class defined only in a dialect the tool cannot parse.
+ */
+import type { DefinedClassRef } from './definedClasses.js';
+/**
+ * Harvest the defined classes (`.foo` selectors) from one markup file's readable
+ * embedded `<style>` blocks, using the CSS parser rather than a selector pattern.
+ *
+ * @param filePath The markup source path (becomes the catalog `file_path`).
+ * @param sourceCode The raw markup source.
+ * @returns One entry per distinct (className, filePath) defined selector.
+ */
+export declare function harvestMarkupStyleClasses(filePath: string, sourceCode: string): DefinedClassRef[];
+//# sourceMappingURL=markupStyleHarvest.d.ts.map

package/dist/styles/markupStyleHarvest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markupStyleHarvest.d.ts","sourceRoot":"","sources":["../../src/styles/markupStyleHarvest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,eAAe,EAAE,CAoCnB"}

package/dist/styles/markupStyleHarvest.js

@@ -0,0 +1,73 @@
+/**
+ * Parser-based defined-class harvest for markup `<style>` blocks (Spec 45,
+ * Piece 2 of the keyframe-pollution fix).
+ *
+ * The markup path used to scrape class names out of the regex-scraped selector
+ * `context` with `scanClassNamesFromSelector` — a character-minimum pattern that
+ * cannot tell a style-rule selector from a keyframe selector and admits decimal
+ * points in keyframe percentages as class-selector dots. This module routes each
+ * readable embedded `<style>` block body through the *same* CSS parser the
+ * `.css`/`.scss` path uses (`parseFile` + `extractClassUsageFromCSSAst`), so the
+ * discriminant for "is this a keyframes at-rule" is what the parser reports:
+ * keyframe selectors (`from`/`to`/percentages) are structurally absent from the
+ * `class_name`-under-`class_selector` walk, and there is no hand-maintained
+ * at-rule-name list anywhere in the path.
+ *
+ * The block boundaries and dialect (`css`/`scss`) come from `collectStyleBlocks`,
+ * the same single source of truth the declaration extractor reads, so the two
+ * harvests can never disagree. Unread dialects (`sass`/`less`/`styl`/…) are
+ * dropped by `collectStyleBlocks` before this function runs — exactly the
+ * dialects the regex declaration path also skips, so the catalog never asserts a
+ * class defined only in a dialect the tool cannot parse.
+ */
+import { collectStyleBlocks } from './styleExtractor.js';
+import { extractClassUsageFromCSSAst } from './cssAstExtractor.js';
+import { parseFile } from '../languages/adapterBridge.js';
+import { LanguageRegistry } from '../languages/LanguageRegistry.js';
+/**
+ * Harvest the defined classes (`.foo` selectors) from one markup file's readable
+ * embedded `<style>` blocks, using the CSS parser rather than a selector pattern.
+ *
+ * @param filePath The markup source path (becomes the catalog `file_path`).
+ * @param sourceCode The raw markup source.
+ * @returns One entry per distinct (className, filePath) defined selector.
+ */
+export function harvestMarkupStyleClasses(filePath, sourceCode) {
+    const blocks = collectStyleBlocks(sourceCode);
+    if (blocks.length === 0)
+        return [];
+    const registry = LanguageRegistry.getInstance();
+    const refs = [];
+    const seen = new Set();
+    for (const block of blocks) {
+        // A synthetic path selects the CSS/SCSS grammar in `parseFile` and the
+        // matching adapter in `getAdapterForFile`. The real markup path is threaded
+        // to `extractClassUsageFromCSSAst` as `filePath` so the catalog records the
+        // source file, not the synthetic one.
+        const syntheticPath = block.lang === 'scss' ? 'embedded.scss' : 'embedded.css';
+        const adapter = registry.getAdapterForFile(syntheticPath);
+        if (!adapter)
+            continue;
+        const ast = parseFile(syntheticPath, block.body);
+        if (!ast)
+            continue;
+        try {
+            for (const u of extractClassUsageFromCSSAst(ast, adapter, filePath, block.body)) {
+                if (u.unresolvable)
+                    continue; // SCSS `&`-references are uses, not definitions.
+                // `filePath` is the single markup path threaded in above, so `className`
+                // alone is a unique key for this file; dedup collapses a class selector
+                // that appears in more than one `<style>` block.
+                if (seen.has(u.className))
+                    continue;
+                seen.add(u.className);
+                refs.push({ className: u.className, filePath: u.filePath });
+            }
+        }
+        finally {
+            ast.dispose?.();
+        }
+    }
+    return refs;
+}
+//# sourceMappingURL=markupStyleHarvest.js.map

package/dist/styles/markupStyleHarvest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markupStyleHarvest.js","sourceRoot":"","sources":["../../src/styles/markupStyleHarvest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGpE;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CACvC,QAAgB,EAChB,UAAkB;IAElB,MAAM,MAAM,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC9C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,WAAW,EAAE,CAAC;IAChD,MAAM,IAAI,GAAsB,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,uEAAuE;QACvE,4EAA4E;QAC5E,4EAA4E;QAC5E,sCAAsC;QACtC,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,cAAc,CAAC;QAC/E,MAAM,OAAO,GAAG,QAAQ,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;QAC1D,IAAI,CAAC,OAAO;YAAE,SAAS;QAEvB,MAAM,GAAG,GAAG,SAAS,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,GAAG;YAAE,SAAS;QAEnB,IAAI,CAAC;YACH,KAAK,MAAM,CAAC,IAAI,2BAA2B,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChF,IAAI,CAAC,CAAC,YAAY;oBAAE,SAAS,CAAC,iDAAiD;gBAC/E,yEAAyE;gBACzE,wEAAwE;gBACxE,iDAAiD;gBACjD,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;oBAAE,SAAS;gBACpC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;gBACtB,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/styles/styleExtractor.d.ts

@@ -63,4 +63,41 @@ export declare function extractDeclarationsFromBlock(block: string, declarations
     variantContext: string | null;
     baseLine: number;
 }): void;
+/**
+ * Collect every CSS-in-JS template body in a TS/JS AST, in source order. Shared
+ * by the defined-class harvest (`harvestCssInJsStyleClasses`), which routes each
+ * body through the CSS parser rather than the line-splitting declaration path.
+ *
+ * @param ast The parsed TS/JS AST to walk for CSS-in-JS templates.
+ * @param sourceCode The raw TS/JS source, used to slice each template body.
+ * @returns Every CSS-in-JS template body in source order.
+ */
+export declare function collectCssInJsBlocks(ast: AST, sourceCode: string): string[];
+/** One embedded `<style>` block whose dialect the extractor can read. */
+export interface StyleBlock {
+    body: string;
+    lang: 'css' | 'scss';
+    /** Index of the first body character in the source (right after the opening
+     *  `>`), used to map body line numbers back to the source file. */
+    bodyStart: number;
+}
+/**
+ * Collect the readable embedded `<style>` blocks from a markup source.
+ *
+ * This is the single source of truth for "which `<style>` blocks exist" — both
+ * the declaration extractor (`extractStyleBlocks`) and the parser-based
+ * defined-class harvest (`harvestMarkupStyleClasses`) consume it, so the two
+ * can never disagree about block boundaries or dialect. The dialect is chosen
+ * from the `lang`/`type` attribute:
+ *   - `css` (or absent) → `css`
+ *   - `scss` → `scss`
+ *   - anything else (`sass`, `less`, `styl`, `postcss`, …) → reported to
+ *     `onUnread` (and excluded), so `undefined-class` never asserts a class
+ *     defined only in an unread dialect.
+ *
+ * @param sourceCode The raw markup source.
+ * @param onUnread Optional callback receiving an unread dialect name.
+ * @returns The readable (`css`/`scss`) style blocks in source order.
+ */
+export declare function collectStyleBlocks(sourceCode: string, onUnread?: (lang: string) => void): StyleBlock[];
 //# sourceMappingURL=styleExtractor.d.ts.map

package/dist/styles/styleExtractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styleExtractor.d.ts","sourceRoot":"","sources":["../../src/styles/styleExtractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,eAAe,EAAW,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGvG,OAAO,EAA2C,KAAK,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAO9G;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,eAAe,EACxB,UAAU,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,GAAG,EACT,cAAc,CAAC,EAAE,mBAAmB,EACpC,aAAa,CAAC,EAAE,iBAAiB,EAAE,GAClC,qBAAqB,EAAE,CAuCzB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,UAAU,EAAE,CAwBd;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,mBAAmB,GAC7B,mBAAmB,CAGrB;AAyND;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,qBAAqB,EAAE,EACrC,GAAG,EAAE;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,cAAc,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;CAClB,GACA,IAAI,CAwFN"}
+{"version":3,"file":"styleExtractor.d.ts","sourceRoot":"","sources":["../../src/styles/styleExtractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,eAAe,EAAW,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGvG,OAAO,EAA2C,KAAK,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAO9G;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,eAAe,EACxB,UAAU,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,GAAG,EACT,cAAc,CAAC,EAAE,mBAAmB,EACpC,aAAa,CAAC,EAAE,iBAAiB,EAAE,GAClC,qBAAqB,EAAE,CAuCzB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,UAAU,EAAE,CAwBd;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,mBAAmB,GAC7B,mBAAmB,CAGrB;AAyND;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,qBAAqB,EAAE,EACrC,GAAG,EAAE;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,cAAc,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;CAClB,GACA,IAAI,CAwFN;AAyQD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAO3E;AAyFD,yEAAyE;AACzE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IACrB;uEACmE;IACnE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAChC,UAAU,EAAE,CAwBd"}