@svelte-vitals/core 0.36.1 → 0.37.0

package/dist/index.d.ts

@@ -956,6 +956,14 @@ interface RuleContext {
     sourceFiles?: string[];
     project: Project;
     config: Config;
+    /**
+     * Report per-declaration counts of places this rule examined. The engine supplies it and keys the
+     * result by rule id; a rule that does not call it gets no entry, which is distinct from an entry of
+     * zeros. Absent in contexts a caller builds directly. Silent last-write-wins: calling it more than
+     * once keeps only the most recent map, with no merge and no error — call it once, with the complete
+     * counts, at the end of `check()`.
+     */
+    recordExamined?: (counts: Record<string, number>) => void;
 }
 interface Rule {
     id: string;
@@ -995,7 +1003,10 @@ declare function isPenalized(detection: Detection, treatDynamicAs: TreatDynamicA
  * Rules are independent, so they run concurrently; results are flattened in
  * rule order for stable output.
  */
-declare function runRules(rules: Rule[], ctx: RuleContext): Promise<Result[]>;
+declare function runRules(rules: Rule[], ctx: RuleContext): Promise<{
+    results: Result[];
+    examined: Record<string, Record<string, number>>;
+}>;
 
 /**
  * seo/title-presence — every route should resolve a non-empty <title> (design §11).
@@ -1554,15 +1565,22 @@ interface JsonReport {
      * and floors that sum once, so adding this map's already-floored entries and re-dividing can disagree.
      */
     inventories: Record<string, number>;
+    /**
+     * Per-rule, per-declaration counts of places examined. Unlike `rules`, this describes the analysis
+     * rather than the report: `--diff`, `--baseline` and suppressions do not narrow it. Three states: a
+     * rule that reports no counts has no entry; a rule that counts but whose configuration declares
+     * nothing has an empty entry; a declaration that judged nothing has an entry of `0`.
+     */
+    examined?: Record<string, Record<string, number>>;
 }
 /** Build the structured JSON report object (design §7). The shape the `json` reporter emits (issue #24). */
 declare function buildJsonReport(results: Result[], config: Config, meta: {
     version: string;
-}, ruleIds?: readonly string[]): JsonReport;
+}, ruleIds?: readonly string[], examined?: Record<string, Record<string, number>>): JsonReport;
 /** Render results as the documented JSON report string (design §7). */
 declare function formatJsonReport(results: Result[], config: Config, meta: {
     version: string;
-}, ruleIds?: readonly string[]): string;
+}, ruleIds?: readonly string[], examined?: Record<string, Record<string, number>>): string;
 
 /** Render failing findings as an agent-actionable Markdown remediation document (issue #18). */
 declare function formatAgentReport(results: Result[], config: Config): string;

package/dist/index.js

@@ -2444,8 +2444,11 @@ function isPenalized(detection, treatDynamicAs) {
 
 // src/engine.ts
 async function runRules(rules, ctx) {
-  const perRule = await Promise.all(rules.map((rule) => rule.check(ctx)));
-  return perRule.flat();
+  const examined = {};
+  const perRule = await Promise.all(
+    rules.map((rule) => rule.check({ ...ctx, recordExamined: (counts) => void (examined[rule.id] = counts) }))
+  );
+  return { results: perRule.flat(), examined };
 }
 
 // src/rules/seo/title-presence.ts
@@ -5479,6 +5482,8 @@ var architectureReservedNamePlacement = {
       }
     }
     const usedAlternatives = /* @__PURE__ */ new Set();
+    const examinedCounts = {};
+    for (const key of globalAlternatives.keys()) examinedCounts[key] = 0;
     const allDirs = [...dirs].sort();
     for (const dir of allDirs) {
       const o = resolveRuleOptions(ID7, OPTIONS6, ctx.config, { route: dir, file: dir }, compiledOverrides);
@@ -5503,6 +5508,17 @@ var architectureReservedNamePlacement = {
       if (isExcluded(dir, ancestorDirs2(dir), excluded)) {
         continue;
       }
+      const judged = /* @__PURE__ */ new Set();
+      const resolvedValues = [
+        ["placements", placements[name]],
+        ["capitalisedUnitPlacements", capUnits[name]],
+        ["anyCaseUnitPlacements", anyUnits[name]]
+      ];
+      for (const [map, value] of resolvedValues) {
+        if (value === void 0) continue;
+        for (const glob of globsOf(value)) judged.add(label(map, name, glob));
+      }
+      for (const key of judged) if (globalAlternatives.has(key)) examinedCounts[key] = (examinedCounts[key] ?? 0) + 1;
       const record = (map, value, qualifies) => {
         if (value === void 0) return false;
         const { matched } = matchKeys(parent, compile(globsOf(value), true));
@@ -5571,6 +5587,7 @@ var architectureReservedNamePlacement = {
         docsUrl: docsUrl11
       });
     }
+    ctx.recordExamined?.(examinedCounts);
     return out;
   }
 };
@@ -6258,7 +6275,7 @@ function ruleEvidence(results, config, ruleIds) {
   }
   return out;
 }
-function buildJsonReport(results, config, meta, ruleIds) {
+function buildJsonReport(results, config, meta, ruleIds, examined) {
   const { health, categories: byCat, weights } = computeHealth(results, config);
   const summary = summarize(results, config);
   const rules = ruleEvidence(results, config, ruleIds);
@@ -6288,10 +6305,21 @@ function buildJsonReport(results, config, meta, ruleIds) {
   const inventories = Object.fromEntries(
     [...buildInventory(config)].map(([pair, weight]) => [pair, Math.max(weight, INVENTORY_FLOOR)])
   );
-  return { version: meta.version, score: health, weights, categories, summary, rules, routes, siteIssues, inventories };
+  return {
+    version: meta.version,
+    score: health,
+    weights,
+    categories,
+    summary,
+    rules,
+    routes,
+    siteIssues,
+    inventories,
+    ...examined && Object.keys(examined).length > 0 ? { examined } : {}
+  };
 }
-function formatJsonReport(results, config, meta, ruleIds) {
-  return JSON.stringify(buildJsonReport(results, config, meta, ruleIds), null, 2);
+function formatJsonReport(results, config, meta, ruleIds, examined) {
+  return JSON.stringify(buildJsonReport(results, config, meta, ruleIds, examined), null, 2);
 }
 
 // src/reporter/agent.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@svelte-vitals/core",
-  "version": "0.36.1",
+  "version": "0.37.0",
   "description": "Shared, runtime-agnostic core for svelte-vitals (types, rule engine, scorer, reporter).",
   "type": "module",
   "license": "MIT",