@drskillissue/ganko 0.1.0

package/dist/index.js

@@ -0,0 +1,358 @@
+import {
+  RULES,
+  RULES_BY_CATEGORY,
+  getRule
+} from "./chunk-JBBGDG7M.js";
+import {
+  CSSPlugin,
+  SolidPlugin,
+  analyzeInput,
+  buildCSSGraph,
+  buildLayoutGraph,
+  buildSolidGraph,
+  parseContent,
+  parseContentWithProgram,
+  parseFile,
+  resolveTailwindValidator,
+  runCrossFileRules,
+  runSolidRules,
+  scanDependencyCustomProperties,
+  setActivePolicy
+} from "./chunk-RB7SZIJX.js";
+
+// src/runner.ts
+function createOverrideEmit(target, overrides) {
+  return (d) => {
+    const override = overrides[d.rule];
+    if (override === void 0) {
+      target(d);
+      return;
+    }
+    if (override === "off") return;
+    if (override !== d.severity) {
+      target({ ...d, severity: override });
+      return;
+    }
+    target(d);
+  };
+}
+function createRunner(config) {
+  let overrides = config.rules ?? {};
+  return {
+    run(files) {
+      const diagnostics = [];
+      const raw = (d) => diagnostics.push(d);
+      const hasOverrides = Object.keys(overrides).length > 0;
+      const emit = hasOverrides ? createOverrideEmit(raw, overrides) : raw;
+      for (const plugin of config.plugins) {
+        plugin.analyze(files, emit);
+      }
+      return diagnostics;
+    },
+    setRuleOverrides(next) {
+      overrides = next;
+    }
+  };
+}
+
+// src/cache.ts
+import { canonicalPath, classifyFile, noopLogger } from "@drskillissue/ganko-shared";
+var GraphCache = class {
+  log;
+  solids = /* @__PURE__ */ new Map();
+  crossFileDiagnostics = /* @__PURE__ */ new Map();
+  crossFileResults = null;
+  css = null;
+  solidGeneration = 0;
+  cssGeneration = 0;
+  layout = null;
+  constructor(log) {
+    this.log = log ?? noopLogger;
+  }
+  /**
+   * Check if a SolidGraph is cached and current for a file path.
+   *
+   * Allows callers to skip builder allocation when the cache is warm.
+   *
+   * @param path Absolute file path
+   * @param version Script version string from the TS project service
+   */
+  hasSolidGraph(path, version) {
+    const key = canonicalPath(path);
+    const cached = this.solids.get(key);
+    const hit = cached !== void 0 && cached.version === version;
+    if (this.log.enabled) this.log.debug(`hasSolidGraph: ${key} v=${version} cached=${cached?.version ?? "none"} hit=${hit} (${this.solids.size} total)`);
+    return hit;
+  }
+  /**
+   * Store a pre-built SolidGraph in the cache.
+   *
+   * Used by the CLI lint command which builds graphs during single-file
+   * analysis and pre-populates the cache for cross-file reuse.
+   *
+   * @param path Absolute file path
+   * @param version Script version string from the TS project service
+   * @param graph Pre-built SolidGraph
+   */
+  setSolidGraph(path, version, graph) {
+    const key = canonicalPath(path);
+    this.solids.set(key, { version, graph });
+    this.solidGeneration++;
+    if (this.log.enabled) this.log.debug(`setSolidGraph: ${key} v=${version} (${this.solids.size} total) solidGen=${this.solidGeneration}`);
+  }
+  /**
+   * Get or build a SolidGraph for a file path.
+   *
+   * Returns the cached graph if the version matches.
+   * Otherwise invokes the builder, caches the result, and returns it.
+   *
+   * @param path Absolute file path
+   * @param version Script version string from the TS project service
+   * @param build Builder function invoked on cache miss
+   */
+  getSolidGraph(path, version, build) {
+    const key = canonicalPath(path);
+    const cached = this.solids.get(key);
+    if (cached !== void 0 && cached.version === version) {
+      if (this.log.enabled) this.log.debug(`getSolidGraph HIT: ${key} v=${version}`);
+      return cached.graph;
+    }
+    if (this.log.enabled) this.log.debug(`getSolidGraph MISS: ${key} v=${version} (was ${cached?.version ?? "uncached"})`);
+    const t0 = performance.now();
+    const graph = build();
+    this.solids.set(key, { version, graph });
+    this.solidGeneration++;
+    if (this.log.enabled) this.log.debug(`getSolidGraph BUILT: ${key} v=${version} in ${performance.now() - t0}ms (${this.solids.size} total) solidGen=${this.solidGeneration}`);
+    return graph;
+  }
+  /**
+   * Get the cached CSSGraph, or rebuild it.
+   *
+   * Returns the cached graph if the generation matches the current
+   * CSS generation counter. Otherwise invokes the builder, caches
+   * the result at the current generation, and returns it.
+   *
+   * @param build Builder function invoked on cache miss
+   */
+  getCSSGraph(build) {
+    if (this.css !== null && this.css.generation === this.cssGeneration) {
+      if (this.log.enabled) this.log.debug(`getCSSGraph HIT: gen=${this.cssGeneration}`);
+      return this.css.graph;
+    }
+    if (this.log.enabled) this.log.debug(`getCSSGraph MISS: currentGen=${this.cssGeneration} cachedGen=${this.css?.generation ?? "none"}`);
+    const t0 = performance.now();
+    const graph = build();
+    this.css = { generation: this.cssGeneration, graph };
+    if (this.log.enabled) this.log.debug(`getCSSGraph BUILT: gen=${this.cssGeneration} in ${performance.now() - t0}ms`);
+    return graph;
+  }
+  /**
+   * Get or build a LayoutGraph for current Solid/CSS cache state.
+   *
+   * Returns cached LayoutGraph when both Solid signature (path+version)
+   * and CSS generation match. Otherwise invokes the builder.
+   *
+   * @param build Builder function invoked on cache miss
+   */
+  getLayoutGraph(build) {
+    const solidGen = this.solidGeneration;
+    const cssGen = this.cssGeneration;
+    if (this.layout !== null && this.layout.solidGeneration === solidGen && this.layout.cssGeneration === cssGen) {
+      if (this.log.enabled) this.log.debug(`getLayoutGraph HIT: solidGen=${solidGen} cssGen=${cssGen}`);
+      return this.layout.graph;
+    }
+    if (this.log.enabled) this.log.debug(
+      `getLayoutGraph MISS: solidGen=${solidGen} cssGen=${cssGen} cached=${this.layout !== null}`
+    );
+    const t0 = performance.now();
+    const graph = build();
+    this.layout = {
+      solidGeneration: solidGen,
+      cssGeneration: cssGen,
+      graph
+    };
+    if (this.log.enabled) this.log.debug(`getLayoutGraph BUILT: in ${performance.now() - t0}ms`);
+    return graph;
+  }
+  /**
+   * Invalidate cached graphs affected by a file change.
+   *
+   * Classifies the path and invalidates the appropriate cache:
+   * solid files evict their per-file SolidGraph, CSS files bump
+   * the CSSGraph generation counter.
+   *
+   * @param path Absolute file path that changed
+   */
+  invalidate(path) {
+    const key = canonicalPath(path);
+    const kind = classifyFile(key);
+    if (this.log.enabled) this.log.debug(`invalidate: ${key} kind=${kind} solids=${this.solids.size} hasCrossFileResults=${this.crossFileResults !== null} hasLayout=${this.layout !== null}`);
+    if (kind === "solid") {
+      const had = this.solids.has(key);
+      this.solids.delete(key);
+      this.crossFileDiagnostics.delete(key);
+      this.crossFileResults = null;
+      this.solidGeneration++;
+      this.layout = null;
+      if (this.log.enabled) this.log.debug(`invalidate SOLID: ${key} wasInCache=${had} solids=${this.solids.size} solidGen=${this.solidGeneration}`);
+    }
+    if (kind === "css") {
+      this.crossFileDiagnostics.delete(key);
+      this.crossFileResults = null;
+      this.cssGeneration++;
+      this.css = null;
+      this.layout = null;
+      if (this.log.enabled) this.log.debug(`invalidate CSS: ${key} newCssGen=${this.cssGeneration}`);
+    }
+  }
+  /**
+   * Invalidate all cached graphs.
+   *
+   * Called on workspace-level events like config changes.
+   */
+  invalidateAll() {
+    if (this.log.enabled) this.log.debug(`invalidateAll: solids=${this.solids.size} solidGen=${this.solidGeneration} cssGen=${this.cssGeneration}`);
+    this.solids.clear();
+    this.crossFileDiagnostics.clear();
+    this.crossFileResults = null;
+    this.solidGeneration++;
+    this.cssGeneration++;
+    this.css = null;
+    this.layout = null;
+  }
+  /**
+   * Get all cached SolidGraphs.
+   *
+   * Returns a snapshot array of all currently-cached graphs.
+   * Used by cross-file analysis which needs all SolidGraphs.
+   */
+  getAllSolidGraphs() {
+    if (this.log.enabled) this.log.debug(`getAllSolidGraphs: ${this.solids.size} graphs`);
+    const out = new Array(this.solids.size);
+    let i = 0;
+    for (const entry of this.solids.values()) {
+      out[i++] = entry.graph;
+    }
+    return out;
+  }
+  /**
+   * Get the cached CSSGraph, or null if not cached.
+   */
+  getCachedCSSGraph() {
+    return this.css?.graph ?? null;
+  }
+  /**
+   * Get the cached LayoutGraph, or null if not cached.
+   */
+  getCachedLayoutGraph() {
+    return this.layout?.graph ?? null;
+  }
+  /**
+   * Get cached cross-file diagnostics for a file path.
+   *
+   * Returns the previous cross-file results so single-file-only
+   * re-analysis (during typing) can merge them without re-running
+   * cross-file rules.
+   *
+   * @param path Absolute file path
+   */
+  getCachedCrossFileDiagnostics(path) {
+    return this.crossFileDiagnostics.get(canonicalPath(path)) ?? [];
+  }
+  /**
+   * Store cross-file diagnostics for a file path.
+   *
+   * @param path Absolute file path
+   * @param diagnostics Cross-file diagnostics for this path
+   */
+  setCachedCrossFileDiagnostics(path, diagnostics) {
+    this.crossFileDiagnostics.set(canonicalPath(path), diagnostics);
+  }
+  /**
+   * Get workspace-level cross-file results if the underlying graphs haven't changed.
+   *
+   * Returns the full per-file map when the solid signature and CSS generation
+   * match, meaning no graphs were rebuilt since the last run. Returns null
+   * when results are stale and `runCrossFileRules` must re-execute.
+   */
+  getCachedCrossFileResults() {
+    if (this.crossFileResults === null) {
+      this.log.debug("getCachedCrossFileResults: null (no cached results)");
+      return null;
+    }
+    const solidMatch = this.crossFileResults.solidGeneration === this.solidGeneration;
+    const cssMatch = this.crossFileResults.cssGeneration === this.cssGeneration;
+    if (solidMatch && cssMatch) {
+      if (this.log.enabled) this.log.debug(`getCachedCrossFileResults HIT: ${this.crossFileResults?.byFile.size} files`);
+      return this.crossFileResults.byFile;
+    }
+    if (this.log.enabled) this.log.debug(
+      `getCachedCrossFileResults MISS: solidMatch=${solidMatch} cssMatch=${cssMatch} cachedSolidGen=${this.crossFileResults?.solidGeneration} currentSolidGen=${this.solidGeneration} cachedCssGen=${this.crossFileResults?.cssGeneration} currentCssGen=${this.cssGeneration}`
+    );
+    return null;
+  }
+  /**
+   * Store workspace-level cross-file results bucketed by file.
+   *
+   * Called after `runCrossFileRules` completes. Captures the current
+   * solid signature and CSS generation so subsequent lookups are O(1)
+   * until a graph changes.
+   *
+   * @param allDiagnostics All cross-file diagnostics from the workspace run
+   */
+  setCachedCrossFileResults(allDiagnostics) {
+    const byFile = /* @__PURE__ */ new Map();
+    for (let i = 0, len = allDiagnostics.length; i < len; i++) {
+      const d = allDiagnostics[i];
+      if (!d) continue;
+      let arr = byFile.get(d.file);
+      if (!arr) {
+        arr = [];
+        byFile.set(d.file, arr);
+      }
+      arr.push(d);
+    }
+    this.crossFileResults = {
+      solidGeneration: this.solidGeneration,
+      cssGeneration: this.cssGeneration,
+      byFile
+    };
+    if (this.log.enabled) this.log.debug(
+      `setCachedCrossFileResults: ${allDiagnostics.length} diags across ${byFile.size} files solidGen=${this.solidGeneration} cssGen=${this.cssGeneration}`
+    );
+    for (const [file, diagnostics] of byFile) {
+      this.crossFileDiagnostics.set(file, diagnostics);
+    }
+  }
+  /** Number of cached SolidGraphs. */
+  get solidCount() {
+    return this.solids.size;
+  }
+  /** The logger instance used by this cache. */
+  get logger() {
+    return this.log;
+  }
+};
+export {
+  CSSPlugin,
+  GraphCache,
+  RULES,
+  RULES_BY_CATEGORY,
+  SolidPlugin,
+  analyzeInput,
+  buildCSSGraph,
+  buildLayoutGraph,
+  buildSolidGraph,
+  createOverrideEmit,
+  createRunner,
+  getRule,
+  parseContent,
+  parseContentWithProgram,
+  parseFile,
+  resolveTailwindValidator,
+  runCrossFileRules,
+  runSolidRules,
+  scanDependencyCustomProperties,
+  setActivePolicy
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runner.ts","../src/cache.ts"],"sourcesContent":["/**\n * Runner - Plugin-agnostic runner for ganko\n *\n * The runner takes a configuration with plugins and runs them against files.\n * It never stores typed graphs - plugins handle their own graph building\n * and rule execution internally via the analyze() method.\n *\n * Rule overrides allow callers (LSP, CLI) to disable rules or remap their\n * severity without modifying rule definitions. The runner intercepts the\n * Emit callback to enforce overrides before diagnostics reach the caller.\n */\nimport type { Diagnostic } from \"./diagnostic\"\nimport type { Plugin, Emit } from \"./graph\"\nimport type { RuleOverrides } from \"@drskillissue/ganko-shared\"\n\n/** Runner configuration */\nexport interface RunnerConfig {\n  readonly plugins: readonly Plugin<string>[]\n  readonly rules?: RuleOverrides\n}\n\n/** Runner interface */\nexport interface Runner {\n  run(files: readonly string[]): readonly Diagnostic[]\n  /** Replace rule overrides. Takes effect on the next run() call. */\n  setRuleOverrides(overrides: RuleOverrides): void\n}\n\n/**\n * Build an Emit wrapper that enforces rule overrides.\n *\n * @param target - The underlying emit that collects diagnostics\n * @param overrides - Current rule override map\n * @returns Wrapped emit that suppresses/remaps per overrides\n */\nexport function createOverrideEmit(target: Emit, overrides: RuleOverrides): Emit {\n  return (d) => {\n    const override = overrides[d.rule]\n    if (override === undefined) { target(d); return }\n    if (override === \"off\") return\n    if (override !== d.severity) {\n      target({ ...d, severity: override })\n      return\n    }\n    target(d)\n  }\n}\n\n/**\n * Create a runner from configuration.\n *\n * @example\n * ```ts\n * const runner = createRunner({\n *   plugins: [SolidPlugin, CSSPlugin, CrossFilePlugin],\n *   rules: { \"missing-jsdoc-comments\": \"off\", \"signal-call\": \"warn\" },\n * })\n * const diagnostics = runner.run(projectFiles)\n * ```\n */\nexport function createRunner(config: RunnerConfig): Runner {\n  let overrides: RuleOverrides = config.rules ?? {}\n\n  return {\n    run(files) {\n      const diagnostics: Diagnostic[] = []\n      const raw: Emit = (d) => diagnostics.push(d)\n      const hasOverrides = Object.keys(overrides).length > 0\n      const emit = hasOverrides ? createOverrideEmit(raw, overrides) : raw\n      for (const plugin of config.plugins) {\n        plugin.analyze(files, emit)\n      }\n      return diagnostics\n    },\n\n    setRuleOverrides(next) {\n      overrides = next\n    },\n  }\n}\n","/**\n * GraphCache — Versioned cache for SolidGraph, CSSGraph, and LayoutGraph instances.\n *\n * Eliminates redundant graph construction in the LSP server by caching\n * per-file SolidGraphs (keyed by path + script version), a single\n * CSSGraph invalidated via a monotonic generation counter, and a\n * LayoutGraph invalidated by Solid/CSS signatures.\n *\n * The cache does not perform I/O or parsing — callers supply builder\n * functions that are invoked only on cache miss.\n */\nimport { canonicalPath, classifyFile, noopLogger } from \"@drskillissue/ganko-shared\"\nimport type { Logger } from \"@drskillissue/ganko-shared\"\nimport type { Diagnostic } from \"./diagnostic\"\nimport type { SolidGraph } from \"./solid/impl\"\nimport type { CSSGraph } from \"./css/impl\"\nimport type { LayoutGraph } from \"./cross-file/layout/graph\"\n\ninterface CachedSolid {\n  readonly version: string\n  readonly graph: SolidGraph\n}\n\ninterface CachedCSS {\n  readonly generation: number\n  readonly graph: CSSGraph\n}\n\ninterface CachedLayout {\n  readonly solidGeneration: number\n  readonly cssGeneration: number\n  readonly graph: LayoutGraph\n}\n\ninterface CachedCrossFileResults {\n  readonly solidGeneration: number\n  readonly cssGeneration: number\n  readonly byFile: ReadonlyMap<string, readonly Diagnostic[]>\n}\n\n/**\n * Versioned cache for SolidGraph, CSSGraph, and LayoutGraph instances.\n *\n * SolidGraphs are cached per file path with a version string.\n * The CSSGraph is a single instance covering all CSS files,\n * invalidated via a monotonic generation counter bumped by\n * `invalidate()` or `invalidateAll()`.\n */\nexport class GraphCache {\n  private readonly log: Logger\n  private readonly solids = new Map<string, CachedSolid>()\n  private readonly crossFileDiagnostics = new Map<string, readonly Diagnostic[]>()\n  private crossFileResults: CachedCrossFileResults | null = null\n  private css: CachedCSS | null = null\n  private solidGeneration = 0\n  private cssGeneration = 0\n  private layout: CachedLayout | null = null\n\n  constructor(log?: Logger) {\n    this.log = log ?? noopLogger\n  }\n\n  /**\n   * Check if a SolidGraph is cached and current for a file path.\n   *\n   * Allows callers to skip builder allocation when the cache is warm.\n   *\n   * @param path Absolute file path\n   * @param version Script version string from the TS project service\n   */\n  hasSolidGraph(path: string, version: string): boolean {\n    const key = canonicalPath(path)\n    const cached = this.solids.get(key)\n    const hit = cached !== undefined && cached.version === version\n    if (this.log.enabled) this.log.debug(`hasSolidGraph: ${key} v=${version} cached=${cached?.version ?? \"none\"} hit=${hit} (${this.solids.size} total)`)\n    return hit\n  }\n\n  /**\n   * Store a pre-built SolidGraph in the cache.\n   *\n   * Used by the CLI lint command which builds graphs during single-file\n   * analysis and pre-populates the cache for cross-file reuse.\n   *\n   * @param path Absolute file path\n   * @param version Script version string from the TS project service\n   * @param graph Pre-built SolidGraph\n   */\n  setSolidGraph(path: string, version: string, graph: SolidGraph): void {\n    const key = canonicalPath(path)\n    this.solids.set(key, { version, graph })\n    this.solidGeneration++\n    if (this.log.enabled) this.log.debug(`setSolidGraph: ${key} v=${version} (${this.solids.size} total) solidGen=${this.solidGeneration}`)\n  }\n\n  /**\n   * Get or build a SolidGraph for a file path.\n   *\n   * Returns the cached graph if the version matches.\n   * Otherwise invokes the builder, caches the result, and returns it.\n   *\n   * @param path Absolute file path\n   * @param version Script version string from the TS project service\n   * @param build Builder function invoked on cache miss\n   */\n  getSolidGraph(path: string, version: string, build: () => SolidGraph): SolidGraph {\n    const key = canonicalPath(path)\n    const cached = this.solids.get(key)\n    if (cached !== undefined && cached.version === version) {\n      if (this.log.enabled) this.log.debug(`getSolidGraph HIT: ${key} v=${version}`)\n      return cached.graph\n    }\n\n    if (this.log.enabled) this.log.debug(`getSolidGraph MISS: ${key} v=${version} (was ${cached?.version ?? \"uncached\"})`)\n    const t0 = performance.now()\n    const graph = build()\n    this.solids.set(key, { version, graph })\n    this.solidGeneration++\n    if (this.log.enabled) this.log.debug(`getSolidGraph BUILT: ${key} v=${version} in ${performance.now() - t0}ms (${this.solids.size} total) solidGen=${this.solidGeneration}`)\n    return graph\n  }\n\n  /**\n   * Get the cached CSSGraph, or rebuild it.\n   *\n   * Returns the cached graph if the generation matches the current\n   * CSS generation counter. Otherwise invokes the builder, caches\n   * the result at the current generation, and returns it.\n   *\n   * @param build Builder function invoked on cache miss\n   */\n  getCSSGraph(build: () => CSSGraph): CSSGraph {\n    if (this.css !== null && this.css.generation === this.cssGeneration) {\n      if (this.log.enabled) this.log.debug(`getCSSGraph HIT: gen=${this.cssGeneration}`)\n      return this.css.graph\n    }\n\n    if (this.log.enabled) this.log.debug(`getCSSGraph MISS: currentGen=${this.cssGeneration} cachedGen=${this.css?.generation ?? \"none\"}`)\n    const t0 = performance.now()\n    const graph = build()\n    this.css = { generation: this.cssGeneration, graph }\n    if (this.log.enabled) this.log.debug(`getCSSGraph BUILT: gen=${this.cssGeneration} in ${performance.now() - t0}ms`)\n    return graph\n  }\n\n  /**\n   * Get or build a LayoutGraph for current Solid/CSS cache state.\n   *\n   * Returns cached LayoutGraph when both Solid signature (path+version)\n   * and CSS generation match. Otherwise invokes the builder.\n   *\n   * @param build Builder function invoked on cache miss\n   */\n  getLayoutGraph(build: () => LayoutGraph): LayoutGraph {\n    const solidGen = this.solidGeneration\n    const cssGen = this.cssGeneration\n\n    if (\n      this.layout !== null\n      && this.layout.solidGeneration === solidGen\n      && this.layout.cssGeneration === cssGen\n    ) {\n      if (this.log.enabled) this.log.debug(`getLayoutGraph HIT: solidGen=${solidGen} cssGen=${cssGen}`)\n      return this.layout.graph\n    }\n\n    if (this.log.enabled) this.log.debug(\n      `getLayoutGraph MISS: solidGen=${solidGen} cssGen=${cssGen} `\n      + `cached=${this.layout !== null}`,\n    )\n\n    const t0 = performance.now()\n    const graph = build()\n    this.layout = {\n      solidGeneration: solidGen,\n      cssGeneration: cssGen,\n      graph,\n    }\n    if (this.log.enabled) this.log.debug(`getLayoutGraph BUILT: in ${performance.now() - t0}ms`)\n    return graph\n  }\n\n  /**\n   * Invalidate cached graphs affected by a file change.\n   *\n   * Classifies the path and invalidates the appropriate cache:\n   * solid files evict their per-file SolidGraph, CSS files bump\n   * the CSSGraph generation counter.\n   *\n   * @param path Absolute file path that changed\n   */\n  invalidate(path: string): void {\n    const key = canonicalPath(path)\n    const kind = classifyFile(key)\n    if (this.log.enabled) this.log.debug(`invalidate: ${key} kind=${kind} solids=${this.solids.size} hasCrossFileResults=${this.crossFileResults !== null} hasLayout=${this.layout !== null}`)\n    if (kind === \"solid\") {\n      const had = this.solids.has(key)\n      this.solids.delete(key)\n      this.crossFileDiagnostics.delete(key)\n      this.crossFileResults = null\n      this.solidGeneration++\n      this.layout = null\n      if (this.log.enabled) this.log.debug(`invalidate SOLID: ${key} wasInCache=${had} solids=${this.solids.size} solidGen=${this.solidGeneration}`)\n    }\n    if (kind === \"css\") {\n      this.crossFileDiagnostics.delete(key)\n      this.crossFileResults = null\n      this.cssGeneration++\n      this.css = null\n      this.layout = null\n      if (this.log.enabled) this.log.debug(`invalidate CSS: ${key} newCssGen=${this.cssGeneration}`)\n    }\n  }\n\n  /**\n   * Invalidate all cached graphs.\n   *\n   * Called on workspace-level events like config changes.\n   */\n  invalidateAll(): void {\n    if (this.log.enabled) this.log.debug(`invalidateAll: solids=${this.solids.size} solidGen=${this.solidGeneration} cssGen=${this.cssGeneration}`)\n    this.solids.clear()\n    this.crossFileDiagnostics.clear()\n    this.crossFileResults = null\n    this.solidGeneration++\n    this.cssGeneration++\n    this.css = null\n    this.layout = null\n  }\n\n  /**\n   * Get all cached SolidGraphs.\n   *\n   * Returns a snapshot array of all currently-cached graphs.\n   * Used by cross-file analysis which needs all SolidGraphs.\n   */\n  getAllSolidGraphs(): readonly SolidGraph[] {\n    if (this.log.enabled) this.log.debug(`getAllSolidGraphs: ${this.solids.size} graphs`)\n    const out: SolidGraph[] = new Array(this.solids.size)\n    let i = 0\n    for (const entry of this.solids.values()) {\n      out[i++] = entry.graph\n    }\n    return out\n  }\n\n  /**\n   * Get the cached CSSGraph, or null if not cached.\n   */\n  getCachedCSSGraph(): CSSGraph | null {\n    return this.css?.graph ?? null\n  }\n\n  /**\n   * Get the cached LayoutGraph, or null if not cached.\n   */\n  getCachedLayoutGraph(): LayoutGraph | null {\n    return this.layout?.graph ?? null\n  }\n\n  /**\n   * Get cached cross-file diagnostics for a file path.\n   *\n   * Returns the previous cross-file results so single-file-only\n   * re-analysis (during typing) can merge them without re-running\n   * cross-file rules.\n   *\n   * @param path Absolute file path\n   */\n  getCachedCrossFileDiagnostics(path: string): readonly Diagnostic[] {\n    return this.crossFileDiagnostics.get(canonicalPath(path)) ?? []\n  }\n\n  /**\n   * Store cross-file diagnostics for a file path.\n   *\n   * @param path Absolute file path\n   * @param diagnostics Cross-file diagnostics for this path\n   */\n  setCachedCrossFileDiagnostics(path: string, diagnostics: readonly Diagnostic[]): void {\n    this.crossFileDiagnostics.set(canonicalPath(path), diagnostics)\n  }\n\n  /**\n   * Get workspace-level cross-file results if the underlying graphs haven't changed.\n   *\n   * Returns the full per-file map when the solid signature and CSS generation\n   * match, meaning no graphs were rebuilt since the last run. Returns null\n   * when results are stale and `runCrossFileRules` must re-execute.\n   */\n  getCachedCrossFileResults(): ReadonlyMap<string, readonly Diagnostic[]> | null {\n    if (this.crossFileResults === null) {\n      this.log.debug(\"getCachedCrossFileResults: null (no cached results)\")\n      return null\n    }\n    const solidMatch = this.crossFileResults.solidGeneration === this.solidGeneration\n    const cssMatch = this.crossFileResults.cssGeneration === this.cssGeneration\n    if (solidMatch && cssMatch) {\n      if (this.log.enabled) this.log.debug(`getCachedCrossFileResults HIT: ${this.crossFileResults?.byFile.size} files`)\n      return this.crossFileResults.byFile\n    }\n    if (this.log.enabled) this.log.debug(\n      `getCachedCrossFileResults MISS: solidMatch=${solidMatch} cssMatch=${cssMatch} `\n      + `cachedSolidGen=${this.crossFileResults?.solidGeneration} currentSolidGen=${this.solidGeneration} `\n      + `cachedCssGen=${this.crossFileResults?.cssGeneration} currentCssGen=${this.cssGeneration}`,\n    )\n    return null\n  }\n\n  /**\n   * Store workspace-level cross-file results bucketed by file.\n   *\n   * Called after `runCrossFileRules` completes. Captures the current\n   * solid signature and CSS generation so subsequent lookups are O(1)\n   * until a graph changes.\n   *\n   * @param allDiagnostics All cross-file diagnostics from the workspace run\n   */\n  setCachedCrossFileResults(allDiagnostics: readonly Diagnostic[]): void {\n    const byFile = new Map<string, Diagnostic[]>()\n    for (let i = 0, len = allDiagnostics.length; i < len; i++) {\n      const d = allDiagnostics[i]\n      if (!d) continue\n      let arr = byFile.get(d.file)\n      if (!arr) {\n        arr = []\n        byFile.set(d.file, arr)\n      }\n      arr.push(d)\n    }\n    this.crossFileResults = {\n      solidGeneration: this.solidGeneration,\n      cssGeneration: this.cssGeneration,\n      byFile,\n    }\n    if (this.log.enabled) this.log.debug(\n      `setCachedCrossFileResults: ${allDiagnostics.length} diags across ${byFile.size} files `\n      + `solidGen=${this.solidGeneration} cssGen=${this.cssGeneration}`,\n    )\n    /* Also update the per-file cache used during typing (when cross-file\n       analysis is skipped and previous results are reused). */\n    for (const [file, diagnostics] of byFile) {\n      this.crossFileDiagnostics.set(file, diagnostics)\n    }\n  }\n\n  /** Number of cached SolidGraphs. */\n  get solidCount(): number {\n    return this.solids.size\n  }\n\n  /** The logger instance used by this cache. */\n  get logger(): Logger {\n    return this.log\n  }\n\n\n}\n"],"mappings":"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","names":[]}