@svelte-vitals/core 0.34.0 → 0.36.0

package/dist/index.d.ts

@@ -1269,6 +1269,24 @@ declare const architectureDirectoryNaming: Rule;
  */
 declare const architectureReservedDirectoryNames: Rule;
 
+/**
+ * architecture/reserved-name-placement — a reserved directory name may appear only in the places
+ * declared for it (design 2026-08-06). L3: inert until a placement is declared.
+ *
+ * The sibling `architecture/reserved-directory-names` says "at this position, only these names"; it
+ * cannot say "this name, only at these positions", which for a name appearing in several kinds of
+ * place is what a convention actually states.
+ *
+ * All three maps match the same directory — the reserved-name directory's parent — and differ only in
+ * what else they require of it: nothing, that it is a capitalised unit, that it is a unit of either
+ * case. A name's permitted positions are the UNION of its entries across the three, because a real
+ * convention permits one name under a unit, under a grouping and under a route directory at once.
+ *
+ * There are no pass results, for the reason the sibling records: `computeScore` seeds every distinct
+ * `route` at 100 and averages, and a directory has no pre-existing score key.
+ */
+declare const architectureReservedNamePlacement: Rule;
+
 declare const architectureRouteComponentImport: Rule;
 
 declare const architectureDocLinkTarget: Rule;
@@ -1462,6 +1480,10 @@ interface ScoreResult {
      */
     rawScore: number;
     scoreModel: ScoreModel;
+    /** Keys this result set touched. */
+    keys: number;
+    /** Keys carrying at least one penalized finding. */
+    affectedKeys: number;
 }
 interface ScoreOptions {
     applyCriticalCap?: boolean;
@@ -1512,6 +1534,8 @@ interface JsonReport {
     categories: Record<string, {
         score: number;
         scoreModel: ScoreModel;
+        keys: number;
+        affectedKeys: number;
     }>;
     summary: Summary;
     rules: Record<string, RuleEvidence>;
@@ -1522,6 +1546,14 @@ interface JsonReport {
         issues: JsonIssue[];
     }>;
     siteIssues: JsonIssue[];
+    /**
+     * Floored severity weight per `"<category>::<scope>"` pair. Reproduces a `routes[].categories` entry
+     * (`100 - 100 * failed / inventories[pair]`): a key is either a route id or a source file path, and
+     * those two key spaces never overlap, so a category's results on one key always draw on a single scope.
+     * It does not reproduce `routes[].score`: a route spanning more than one pair sums their *raw* weights
+     * and floors that sum once, so adding this map's already-floored entries and re-dividing can disagree.
+     */
+    inventories: 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: {
@@ -1622,4 +1654,4 @@ declare function escapeHtml(s: string): string;
  */
 declare function safeHref(url: string): string | null;
 
-export { APP_SCRIPT, APP_STYLE, type AppSnapshot, BAND_COLOR, CATEGORIES, CHILD_NODE_KEYS, type Category, type Classification, type CompiledOverride, type ComponentFacts, type Config, type ConsoleReportOptions, type Detection, type EachBlockFact, type EffectFact, type Fix, type HeadProvider, type HeadTag, type HeadingInfo, type HealthResult, type ImageInfo, type JsonReport, type KitAlias, type KitModuleFacts, type OrphanEffectFact, type Palette, type Presence, type Project, ROBOTS_SOURCE_PATHS, type RawKitAliases, type ResolvedHead, type ResolvedHeadings, type ResolvedImages, type Result, type RouteBadge, type Rule, type RuleContext, type RuleEvidence, type RuleInfo, type RuleOptionInfo, type RuleOptionSpec, type RuleOptions, type RuleOptionsSpec, type RuleOverride, type RuleSetting, type RuleSettingObject, type Runtime, SITEMAP_SOURCE_PATHS, SVELTE_CONFIG_FILES, type Scope, type ScoreModel, type ScoreOptions, type ScoreResult, type Severity, type SourceSpan, type Summary, type SuppressionDirective, type TreatDynamicAs, VITE_CONFIG_FILES, type Value, type ViteKitConfigResult, allRules, applyOverrides, applyRuleSeverities, architectureComponentSize, architectureDirectoryNaming, architectureDocLinkTarget, architecturePrivateScopeImport, architecturePropCount, architectureReservedDirectoryNames, architectureRouteComponentImport, architectureUnitEntryFile, attrText, attrTextOf, attrValue, attrValueOf, buildHtmlDocument, buildJsonReport, classify, collectComponentFacts, collectKitModuleFacts, collectSourceFiles, compileOverrides, computeHealth, computeScore, correctnessBasePathNavigation, correctnessCheckableBindValue, correctnessEachIndexKey, correctnessEachKey, correctnessEffectAsDerived, correctnessEffectAsOnMount, correctnessInstanceBrowserGlobal, correctnessNonreactiveBuiltinState, correctnessOrphanEffect, correctnessOrphanLifecycle, correctnessPropMutation, correctnessServerBrowserGlobal, correctnessStalePropDerivation, correctnessUnmutatedState, defaultConfig, defaultProject, defineConfig, docsUrlFor, effectiveSeverity, emptyComponentFacts, emptyKitModuleFacts, escapeHtml, explainRule, findAttr, findKitAliasesInSvelteConfig, findKitPathsBaseInSvelteConfig, findKitPathsBaseInViteConfig, findMinifyDisabled, formatAgentReport, formatConsoleReport, formatGithubReport, formatHtmlReport, formatJsonReport, formatMarkdownReport, formatSarifReport, hasFailureAtOrAbove, headTagRule, imageRule, intOption, isMentionedAnywhere, isPenalized, lineOf, linkRule, listOption, mapOption, noColorPalette, overrideMatches, parseComponentFacts, parseKitModuleFacts, performanceFontPreloadCrossorigin, performanceHeavyImport, performanceImageDimensions, performanceImageLoadingHint, performanceLcpImage, performanceLoadWaterfall, performanceMinifyDisabled, performanceNamespaceImport, performancePreconnect, performancePreloadMissingAs, performanceRenderBlockingScript, performanceResponsiveImage, performanceSequentialAwaits, performanceStateRaw, renderAppShell, resolveKitAliases, resolveKitPathsBase, resolveRuleOptions, resolveRunesModuleSpecifier, runRules, safeHref, scoreBand, scoreColor, scoresByCategory, securityHandlerStateWrite, securityJavascriptUrl, securityRawHtml, securityServerModuleState, securitySharedStateImport, selectRules, seoCanonicalUrl, seoCharset, seoDescriptionLength, seoDescriptionPresence, seoDuplicateDescription, seoDuplicateTitle, seoHeadingLevelSkip, seoHreflang, seoHtmlLang, seoImageAlt, seoIndexability, seoJsonLd, seoJsonLdDateFormat, seoJsonLdDeprecatedType, seoJsonLdPlaceholder, seoJsonLdRelativeUrl, seoJsonLdRequiredProps, seoJsonLdValidity, seoOgDescription, seoOgImage, seoOgTitle, seoOgUrl, seoRobotsTxt, seoSingleH1, seoSitemapInRobots, seoSitemapXml, seoSsrDisabled, seoTitleLength, seoTitlePresence, seoTwitterCard, seoViewport, settingOptions, settingSeverity, shouldSkipRangeCheck, summarize, textFromNodes, validateRuleOptions, validateRuleSetting, valueFromNodes };
+export { APP_SCRIPT, APP_STYLE, type AppSnapshot, BAND_COLOR, CATEGORIES, CHILD_NODE_KEYS, type Category, type Classification, type CompiledOverride, type ComponentFacts, type Config, type ConsoleReportOptions, type Detection, type EachBlockFact, type EffectFact, type Fix, type HeadProvider, type HeadTag, type HeadingInfo, type HealthResult, type ImageInfo, type JsonReport, type KitAlias, type KitModuleFacts, type OrphanEffectFact, type Palette, type Presence, type Project, ROBOTS_SOURCE_PATHS, type RawKitAliases, type ResolvedHead, type ResolvedHeadings, type ResolvedImages, type Result, type RouteBadge, type Rule, type RuleContext, type RuleEvidence, type RuleInfo, type RuleOptionInfo, type RuleOptionSpec, type RuleOptions, type RuleOptionsSpec, type RuleOverride, type RuleSetting, type RuleSettingObject, type Runtime, SITEMAP_SOURCE_PATHS, SVELTE_CONFIG_FILES, type Scope, type ScoreModel, type ScoreOptions, type ScoreResult, type Severity, type SourceSpan, type Summary, type SuppressionDirective, type TreatDynamicAs, VITE_CONFIG_FILES, type Value, type ViteKitConfigResult, allRules, applyOverrides, applyRuleSeverities, architectureComponentSize, architectureDirectoryNaming, architectureDocLinkTarget, architecturePrivateScopeImport, architecturePropCount, architectureReservedDirectoryNames, architectureReservedNamePlacement, architectureRouteComponentImport, architectureUnitEntryFile, attrText, attrTextOf, attrValue, attrValueOf, buildHtmlDocument, buildJsonReport, classify, collectComponentFacts, collectKitModuleFacts, collectSourceFiles, compileOverrides, computeHealth, computeScore, correctnessBasePathNavigation, correctnessCheckableBindValue, correctnessEachIndexKey, correctnessEachKey, correctnessEffectAsDerived, correctnessEffectAsOnMount, correctnessInstanceBrowserGlobal, correctnessNonreactiveBuiltinState, correctnessOrphanEffect, correctnessOrphanLifecycle, correctnessPropMutation, correctnessServerBrowserGlobal, correctnessStalePropDerivation, correctnessUnmutatedState, defaultConfig, defaultProject, defineConfig, docsUrlFor, effectiveSeverity, emptyComponentFacts, emptyKitModuleFacts, escapeHtml, explainRule, findAttr, findKitAliasesInSvelteConfig, findKitPathsBaseInSvelteConfig, findKitPathsBaseInViteConfig, findMinifyDisabled, formatAgentReport, formatConsoleReport, formatGithubReport, formatHtmlReport, formatJsonReport, formatMarkdownReport, formatSarifReport, hasFailureAtOrAbove, headTagRule, imageRule, intOption, isMentionedAnywhere, isPenalized, lineOf, linkRule, listOption, mapOption, noColorPalette, overrideMatches, parseComponentFacts, parseKitModuleFacts, performanceFontPreloadCrossorigin, performanceHeavyImport, performanceImageDimensions, performanceImageLoadingHint, performanceLcpImage, performanceLoadWaterfall, performanceMinifyDisabled, performanceNamespaceImport, performancePreconnect, performancePreloadMissingAs, performanceRenderBlockingScript, performanceResponsiveImage, performanceSequentialAwaits, performanceStateRaw, renderAppShell, resolveKitAliases, resolveKitPathsBase, resolveRuleOptions, resolveRunesModuleSpecifier, runRules, safeHref, scoreBand, scoreColor, scoresByCategory, securityHandlerStateWrite, securityJavascriptUrl, securityRawHtml, securityServerModuleState, securitySharedStateImport, selectRules, seoCanonicalUrl, seoCharset, seoDescriptionLength, seoDescriptionPresence, seoDuplicateDescription, seoDuplicateTitle, seoHeadingLevelSkip, seoHreflang, seoHtmlLang, seoImageAlt, seoIndexability, seoJsonLd, seoJsonLdDateFormat, seoJsonLdDeprecatedType, seoJsonLdPlaceholder, seoJsonLdRelativeUrl, seoJsonLdRequiredProps, seoJsonLdValidity, seoOgDescription, seoOgImage, seoOgTitle, seoOgUrl, seoRobotsTxt, seoSingleH1, seoSitemapInRobots, seoSitemapXml, seoSsrDisabled, seoTitleLength, seoTitlePresence, seoTwitterCard, seoViewport, settingOptions, settingSeverity, shouldSkipRangeCheck, summarize, textFromNodes, validateRuleOptions, validateRuleSetting, valueFromNodes };

package/dist/index.js

@@ -2499,7 +2499,7 @@ function detect(head, match) {
   return tag ? { presence: tag.presence, value: tag.value } : { presence: "none", value: "absent" };
 }
 function headTagRule(opts) {
-  const docsUrl11 = docsUrlFor(opts.id);
+  const docsUrl12 = docsUrlFor(opts.id);
   return {
     id: opts.id,
     title: opts.title,
@@ -2522,7 +2522,7 @@ function headTagRule(opts) {
           location: head.file,
           message,
           recommendation: opts.recommendation,
-          docsUrl: docsUrl11,
+          docsUrl: docsUrl12,
           // Copy per finding: opts.fix is a rule-level template shared across all
           // results this rule emits; a fresh object keeps findings independent.
           ...opts.fix ? { fix: { ...opts.fix } } : {}
@@ -2715,7 +2715,7 @@ var seoHtmlLang = {
 
 // src/rules/perf/image-rule.ts
 function imageRule(opts) {
-  const docsUrl11 = docsUrlFor(opts.id);
+  const docsUrl12 = docsUrlFor(opts.id);
   const category = opts.category ?? "performance";
   return {
     id: opts.id,
@@ -2739,7 +2739,7 @@ function imageRule(opts) {
             route: route.route,
             message: opts.label,
             recommendation: opts.recommendation,
-            docsUrl: docsUrl11
+            docsUrl: docsUrl12
           });
           continue;
         }
@@ -2754,7 +2754,7 @@ function imageRule(opts) {
             ...img.line > 0 ? { line: img.line } : {},
             message: `Missing ${opts.label}`,
             recommendation: opts.recommendation,
-            docsUrl: docsUrl11,
+            docsUrl: docsUrl12,
             ...opts.fix ? { fix: { ...opts.fix } } : {}
           });
         }
@@ -2814,7 +2814,7 @@ var performanceResponsiveImage = imageRule({
 
 // src/rules/perf/link-rule.ts
 function linkRule(opts) {
-  const docsUrl11 = docsUrlFor(opts.id);
+  const docsUrl12 = docsUrlFor(opts.id);
   return {
     id: opts.id,
     title: opts.title,
@@ -2838,7 +2838,7 @@ function linkRule(opts) {
             route: head.route,
             message: opts.label,
             recommendation: opts.recommendation,
-            docsUrl: docsUrl11
+            docsUrl: docsUrl12
           });
           continue;
         }
@@ -2855,7 +2855,7 @@ function linkRule(opts) {
             location: tag.file ?? head.file,
             message: `Missing ${opts.label}`,
             recommendation: opts.recommendation,
-            docsUrl: docsUrl11,
+            docsUrl: docsUrl12,
             ...opts.fix ? { fix: { ...opts.fix } } : {}
           });
         }
@@ -3287,7 +3287,7 @@ var seoIndexability = {
   rationale: "A noindex directive removes the page from search results; an accidental noindex on a public route silently deindexes it.",
   fix: FIX5,
   async check(ctx) {
-    const docsUrl11 = docsUrlFor("seo/indexability");
+    const docsUrl12 = docsUrlFor("seo/indexability");
     const out = [];
     for (const head of ctx.heads) {
       const noindexed = head.tags.some((t) => t.kind === "meta" && t.name === "robots" && t.noindex === true);
@@ -3302,7 +3302,7 @@ var seoIndexability = {
         location: head.file,
         message: "Route is noindex \u2014 verify this is intentional",
         recommendation: 'If this route should be indexed, remove noindex from its <meta name="robots">.',
-        docsUrl: docsUrl11,
+        docsUrl: docsUrl12,
         fix: { ...FIX5 }
       });
     }
@@ -3553,7 +3553,7 @@ function jsonldTags(head) {
   return head.tags.filter((t) => t.kind === "jsonld" && typeof t.jsonld === "string");
 }
 function jsonldRule(opts) {
-  const docsUrl11 = docsUrlFor(opts.id);
+  const docsUrl12 = docsUrlFor(opts.id);
   return {
     id: opts.id,
     title: opts.title,
@@ -3581,7 +3581,7 @@ function jsonldRule(opts) {
               location: head.file,
               message: problem,
               recommendation: opts.recommendation,
-              docsUrl: docsUrl11,
+              docsUrl: docsUrl12,
               ...opts.fix ? { fix: { ...opts.fix } } : {}
             } : {
               id: opts.id,
@@ -3591,7 +3591,7 @@ function jsonldRule(opts) {
               route: head.route,
               message: opts.label,
               recommendation: opts.recommendation,
-              docsUrl: docsUrl11
+              docsUrl: docsUrl12
             }
           );
         }
@@ -3615,7 +3615,7 @@ var seoJsonLdValidity = {
     lang: "svelte"
   },
   async check(ctx) {
-    const docsUrl11 = docsUrlFor("seo/json-ld-validity");
+    const docsUrl12 = docsUrlFor("seo/json-ld-validity");
     const out = [];
     for (const head of ctx.heads) {
       for (const tag of jsonldTags(head)) {
@@ -3634,7 +3634,7 @@ var seoJsonLdValidity = {
             location: head.file,
             message: problem,
             recommendation: "Make the JSON-LD valid JSON with both @context and @type.",
-            docsUrl: docsUrl11,
+            docsUrl: docsUrl12,
             fix: { ...seoJsonLdValidity.fix }
           } : {
             id: "seo/json-ld-validity",
@@ -3644,7 +3644,7 @@ var seoJsonLdValidity = {
             route: head.route,
             message: "JSON-LD validity",
             recommendation: "Make the JSON-LD valid JSON with both @context and @type.",
-            docsUrl: docsUrl11
+            docsUrl: docsUrl12
           }
         );
       }
@@ -3755,7 +3755,7 @@ function visibleLength(s) {
 
 // src/rules/seo/length-rule.ts
 function lengthRule(opts) {
-  const docsUrl11 = docsUrlFor(opts.id);
+  const docsUrl12 = docsUrlFor(opts.id);
   const spec = {
     min: { kind: "integer", default: opts.min, min: 0 },
     max: { kind: "integer", default: opts.max, min: 1 }
@@ -3778,7 +3778,7 @@ function lengthRule(opts) {
         const o = resolveRuleOptions(opts.id, spec, ctx.config, { route: head.route, file: location }, compiled);
         const min = intOption(o, "min", opts.min);
         const max = intOption(o, "max", opts.max);
-        const recommendation11 = typeof opts.recommendation === "function" ? opts.recommendation(o) : opts.recommendation;
+        const recommendation12 = typeof opts.recommendation === "function" ? opts.recommendation(o) : opts.recommendation;
         const len = visibleLength(tag.text);
         let problem;
         if (len < min) problem = `${opts.noun} is too short (${len} chars; aim for ${min}\u2013${max})`;
@@ -3792,8 +3792,8 @@ function lengthRule(opts) {
             route: head.route,
             location,
             message: problem,
-            recommendation: recommendation11,
-            docsUrl: docsUrl11
+            recommendation: recommendation12,
+            docsUrl: docsUrl12
           } : {
             id: opts.id,
             category: "seo",
@@ -3801,8 +3801,8 @@ function lengthRule(opts) {
             detection: PASS,
             route: head.route,
             message: opts.label,
-            recommendation: recommendation11,
-            docsUrl: docsUrl11
+            recommendation: recommendation12,
+            docsUrl: docsUrl12
           }
         );
       }
@@ -3987,7 +3987,7 @@ var seoSingleH1 = {
 
 // src/rules/seo/uniqueness-rule.ts
 function uniquenessRule(opts) {
-  const docsUrl11 = docsUrlFor(opts.id);
+  const docsUrl12 = docsUrlFor(opts.id);
   return {
     id: opts.id,
     title: opts.title,
@@ -4017,7 +4017,7 @@ function uniquenessRule(opts) {
           location: e.file,
           message: `${opts.noun} is duplicated across ${n} routes`,
           recommendation: opts.recommendation,
-          docsUrl: docsUrl11
+          docsUrl: docsUrl12
         } : {
           id: opts.id,
           category: "seo",
@@ -4026,7 +4026,7 @@ function uniquenessRule(opts) {
           route: e.route,
           message: opts.label,
           recommendation: opts.recommendation,
-          docsUrl: docsUrl11
+          docsUrl: docsUrl12
         };
       });
     }
@@ -4114,7 +4114,7 @@ function isSuppressed(m, ruleId, line) {
   return (m.suppressions ?? []).some((s) => s.line === line && (!s.ruleIds || s.ruleIds.includes(ruleId)));
 }
 function kitModuleRule(opts) {
-  const docsUrl11 = docsUrlFor(opts.id);
+  const docsUrl12 = docsUrlFor(opts.id);
   const severity = opts.severity ?? "warning";
   return {
     id: opts.id,
@@ -4138,7 +4138,7 @@ function kitModuleRule(opts) {
             route: m.file,
             message: opts.label,
             recommendation: opts.recommendation,
-            docsUrl: docsUrl11
+            docsUrl: docsUrl12
           });
           continue;
         }
@@ -4153,7 +4153,7 @@ function kitModuleRule(opts) {
             ...b.line > 0 ? { line: b.line } : {},
             message: b.message,
             recommendation: opts.recommendation,
-            docsUrl: docsUrl11,
+            docsUrl: docsUrl12,
             ...opts.fix ? { fix: { ...opts.fix } } : {}
           });
         }
@@ -4189,7 +4189,7 @@ function isSuppressed2(c, ruleId, line) {
   return (c.suppressions ?? []).some((s) => s.line === line && (!s.ruleIds || s.ruleIds.includes(ruleId)));
 }
 function componentRule(opts) {
-  const docsUrl11 = docsUrlFor(opts.id);
+  const docsUrl12 = docsUrlFor(opts.id);
   const severity = opts.severity ?? "warning";
   return {
     id: opts.id,
@@ -4205,7 +4205,7 @@ function componentRule(opts) {
       const compiled = compileOverrides(ctx.config);
       for (const c of ctx.components ?? []) {
         const o = resolveRuleOptions(opts.id, opts.options, ctx.config, { route: c.file, file: c.file }, compiled);
-        const recommendation11 = typeof opts.recommendation === "function" ? opts.recommendation(o) : opts.recommendation;
+        const recommendation12 = typeof opts.recommendation === "function" ? opts.recommendation(o) : opts.recommendation;
         if (!opts.applies(c, o, ctx)) continue;
         const bad = opts.bad(c, o, ctx).filter((b) => !(b.line > 0 && isSuppressed2(c, opts.id, b.line)));
         if (bad.length === 0) {
@@ -4216,8 +4216,8 @@ function componentRule(opts) {
             detection: PASS3,
             route: c.file,
             message: opts.label,
-            recommendation: recommendation11,
-            docsUrl: docsUrl11
+            recommendation: recommendation12,
+            docsUrl: docsUrl12
           });
           continue;
         }
@@ -4231,8 +4231,8 @@ function componentRule(opts) {
             location: c.file,
             ...b.line > 0 ? { line: b.line } : {},
             message: b.message,
-            recommendation: recommendation11,
-            docsUrl: docsUrl11,
+            recommendation: recommendation12,
+            docsUrl: docsUrl12,
             ...opts.fix ? { fix: { ...opts.fix } } : {}
           });
         }
@@ -5265,9 +5265,11 @@ function stem(file) {
   return dot === -1 ? file : file.slice(0, dot);
 }
 function isUnitDir(dir, filesIn) {
+  const first = baseName(dir).charCodeAt(0);
+  return first >= 65 && first <= 90 && isAnyCaseUnitDir(dir, filesIn);
+}
+function isAnyCaseUnitDir(dir, filesIn) {
   const name = baseName(dir);
-  const first = name.charCodeAt(0);
-  if (!(first >= 65 && first <= 90)) return false;
   const own = filesIn.get(dir);
   return own !== void 0 && own.some((f) => stem(f) === name);
 }
@@ -5415,8 +5417,171 @@ var architectureReservedDirectoryNames = {
   }
 };
 
+// src/rules/architecture/reserved-name-placement.ts
+var ID7 = "architecture/reserved-name-placement";
+var docsUrl11 = docsUrlFor(ID7);
+var recommendation11 = "Move it to one of the places declared for this name, or declare this place for it.";
+var fixDescription = "Move the directory to one of the places declared for its name, rename it, or declare this place for the name.";
+var OPTIONS6 = {
+  placements: { kind: "string-map", default: {} },
+  capitalisedUnitPlacements: { kind: "string-map", default: {} },
+  anyCaseUnitPlacements: { kind: "string-map", default: {} },
+  exclude: { kind: "string-list", default: [] }
+};
+function parentOf(dir) {
+  const cut = dir.lastIndexOf("/");
+  return cut === -1 ? void 0 : dir.slice(0, cut);
+}
+var architectureReservedNamePlacement = {
+  id: ID7,
+  title: "Reserved name placement",
+  category: "architecture",
+  severity: "info",
+  scope: "component",
+  rationale: "A name reserved for one kind of place stops carrying that meaning the moment it appears somewhere else: a reader who has met one exception has to open the directory to learn what it holds.",
+  fix: {
+    description: fixDescription
+  },
+  options: OPTIONS6,
+  async check(ctx) {
+    const files = ctx.sourceFiles;
+    if (files === void 0) return [];
+    if (!isMentionedAnywhere(ctx.config, ID7)) return [];
+    const compiledOverrides = compileOverrides(ctx.config);
+    const dirs = /* @__PURE__ */ new Set();
+    for (const f of files) for (const d of ancestorDirs2(f)) dirs.add(d);
+    const filesIn = childFiles(files);
+    const compile = createKeyCompiler();
+    const parsed = /* @__PURE__ */ new Map();
+    const globsOf = (value) => {
+      let g = parsed.get(value);
+      if (g === void 0) parsed.set(value, g = splitNames(value));
+      return g;
+    };
+    const out = [];
+    const label = (map, name, glob) => `${map}.${name} \u2192 ${glob}`;
+    const globalOptions = resolveRuleOptions(ID7, OPTIONS6, ctx.config);
+    const globalMaps = {
+      placements: mapOption(globalOptions, "placements"),
+      capitalisedUnitPlacements: mapOption(globalOptions, "capitalisedUnitPlacements"),
+      anyCaseUnitPlacements: mapOption(globalOptions, "anyCaseUnitPlacements")
+    };
+    const globalAlternatives = /* @__PURE__ */ new Map();
+    const emptyNames = /* @__PURE__ */ new Map();
+    for (const map of Object.keys(globalMaps)) {
+      for (const [name, value] of Object.entries(globalMaps[map])) {
+        const globs2 = globsOf(value);
+        if (globs2.length === 0) {
+          emptyNames.set(`${map}.${name}`, "names no position at all");
+          continue;
+        }
+        for (const glob of globs2) globalAlternatives.set(label(map, name, glob), { map, glob });
+      }
+    }
+    const usedAlternatives = /* @__PURE__ */ new Set();
+    const excludedDirs = [];
+    const nonUnitParents = {
+      capitalisedUnitPlacements: [],
+      anyCaseUnitPlacements: []
+    };
+    const allDirs = [...dirs].sort();
+    for (const dir of allDirs) {
+      const o = resolveRuleOptions(ID7, OPTIONS6, ctx.config, { route: dir, file: dir }, compiledOverrides);
+      const placements = mapOption(o, "placements");
+      const capUnits = mapOption(o, "capitalisedUnitPlacements");
+      const anyUnits = mapOption(o, "anyCaseUnitPlacements");
+      if (Object.keys(placements).length === 0 && Object.keys(capUnits).length === 0 && Object.keys(anyUnits).length === 0) {
+        continue;
+      }
+      const name = baseName(dir);
+      const inPlacements = Object.hasOwn(placements, name);
+      const inCapUnits = Object.hasOwn(capUnits, name);
+      const inAnyUnits = Object.hasOwn(anyUnits, name);
+      if (!inPlacements && !inCapUnits && !inAnyUnits) continue;
+      const emptyValue = (present3, value) => present3 && globsOf(value ?? "").length === 0;
+      if (emptyValue(inPlacements, placements[name]) || emptyValue(inCapUnits, capUnits[name]) || emptyValue(inAnyUnits, anyUnits[name])) {
+        continue;
+      }
+      const excluded = compile(listOption(o, "exclude"));
+      const parent = parentOf(dir);
+      if (parent === void 0) continue;
+      if (isExcluded(dir, ancestorDirs2(dir), excluded)) {
+        if (isExcluded(parent, ancestorDirs2(parent), excluded)) excludedDirs.push(parent);
+        continue;
+      }
+      const record = (map, value, qualifies) => {
+        if (value === void 0) return false;
+        const { matched } = matchKeys(parent, compile(globsOf(value), true));
+        if (matched.length === 0) return false;
+        if (!qualifies) {
+          if (map !== "placements") nonUnitParents[map].push(parent);
+          return false;
+        }
+        for (const glob of matched) usedAlternatives.add(label(map, name, glob));
+        return true;
+      };
+      const byPlacement = record("placements", placements[name], true);
+      const byCapUnit = record("capitalisedUnitPlacements", capUnits[name], isUnitDir(parent, filesIn));
+      const byAnyUnit = record("anyCaseUnitPlacements", anyUnits[name], isAnyCaseUnitDir(parent, filesIn));
+      if (byPlacement || byCapUnit || byAnyUnit) continue;
+      const at = reportAt(dir, files);
+      if (at === void 0) continue;
+      out.push({
+        id: ID7,
+        category: "architecture",
+        severity: "info",
+        detection: { presence: "none", value: "absent" },
+        route: dir,
+        location: at,
+        message: `${dir} is not one of the places declared for '${name}'.`,
+        recommendation: recommendation11,
+        docsUrl: docsUrl11,
+        fix: {
+          description: fixDescription
+        }
+      });
+    }
+    const notes = new Map(emptyNames);
+    const unusedLabels = [...globalAlternatives.keys()].filter((k) => !usedAlternatives.has(k));
+    const globOf = (key) => globalAlternatives.get(key)?.glob;
+    for (const map of ["capitalisedUnitPlacements", "anyCaseUnitPlacements"]) {
+      const inMap = unusedLabels.filter((k) => globalAlternatives.get(k)?.map === map);
+      const hit = keysMatchingAny(inMap.map(globOf), nonUnitParents[map], compile);
+      for (const k of inMap) {
+        if (hit.has(globOf(k))) notes.set(k, "matched directories but never a unit");
+      }
+    }
+    const stillUnused = unusedLabels.filter((k) => !notes.has(k));
+    const globs = [...new Set(stillUnused.map(globOf))];
+    const reasons = classifyUnusedKeys(globs, excludedDirs, compile);
+    const reachable = keysMatchingAny(globs, allDirs, compile);
+    for (const k of stillUnused) {
+      const glob = globOf(k);
+      if (reasons.get(glob) === "only-excluded") {
+        notes.set(k, "matched only excluded directories");
+      } else if (!reachable.has(glob)) {
+        notes.set(k, "matched no directory");
+      }
+    }
+    const reported = [...notes.keys()].sort();
+    if (reported.length > 0) {
+      const message = reported.length === 1 ? `The declaration '${reported[0]}' does not check what it says: ${notes.get(reported[0])}.` : `These declarations do not check what they say: ${reported.map((k) => `'${k}' (${notes.get(k)})`).join(", ")}.`;
+      out.push({
+        id: ID7,
+        category: "architecture",
+        severity: "info",
+        detection: { presence: "none", value: "absent" },
+        message,
+        recommendation: "Correct the glob or the name, or remove the declaration.",
+        docsUrl: docsUrl11
+      });
+    }
+    return out;
+  }
+};
+
 // src/rules/architecture/route-component-import.ts
-var ID7 = "architecture/route-component-import";
+var ID8 = "architecture/route-component-import";
 var EXEMPT_IMPORTERS = ["**/*.stories.svelte", "**/*.test.svelte", "**/*.spec.svelte"];
 var ROUTES_DIR = "src/routes/";
 var ROUTE_ENTRY = /^\+(page|layout)(@.*)?\.svelte$/;
@@ -5443,7 +5608,7 @@ function cachedRouteEntryImports(c, ctx) {
   return result;
 }
 var architectureRouteComponentImport = componentRule({
-  id: ID7,
+  id: ID8,
   title: "Route component import",
   category: "architecture",
   severity: "info",
@@ -5467,7 +5632,7 @@ var architectureRouteComponentImport = componentRule({
 });
 
 // src/rules/architecture/doc-link-target.ts
-var ID8 = "architecture/doc-link-target";
+var ID9 = "architecture/doc-link-target";
 function stripFragment(url) {
   const i = url.search(/[#?]/);
   return i === -1 ? url : url.slice(0, i);
@@ -5508,7 +5673,7 @@ function references(links, roots) {
   return out;
 }
 var architectureDocLinkTarget = componentRule({
-  id: ID8,
+  id: ID9,
   title: "Documentation link target",
   category: "architecture",
   severity: "info",
@@ -5735,6 +5900,7 @@ var allRules = [
   architectureUnitEntryFile,
   architectureDirectoryNaming,
   architectureReservedDirectoryNames,
+  architectureReservedNamePlacement,
   architectureRouteComponentImport,
   architectureDocLinkTarget,
   performanceHeavyImport,
@@ -5823,6 +5989,7 @@ function ruleScopes(rules) {
 
 // src/scoring/score.ts
 var CRITICAL_CAP = 79;
+var INVENTORY_FLOOR = 25;
 function clamp(n) {
   return Math.max(0, Math.min(100, n));
 }
@@ -5848,14 +6015,16 @@ function computeScore(results, config, options = {}) {
     const prev = perRule.get(r.id) ?? 0;
     if (DEDUCTION[sev] > prev) perRule.set(r.id, DEDUCTION[sev]);
   }
+  let affectedKeys = 0;
   let totalDeficit = 0;
   for (const [key, pairs] of observed) {
     let failed = 0;
     for (const d of ruleMax.get(key)?.values() ?? []) failed += d;
+    if (failed > 0) affectedKeys += 1;
     let inventoryWeight = 0;
     for (const p of pairs) inventoryWeight += inventory.get(p) ?? 0;
-    inventoryWeight = Math.max(inventoryWeight, failed);
-    totalDeficit += inventoryWeight === 0 ? 0 : 100 * failed / inventoryWeight;
+    inventoryWeight = Math.max(inventoryWeight, failed, INVENTORY_FLOOR);
+    totalDeficit += 100 * failed / inventoryWeight;
   }
   const keyCount = observed.size;
   const rawRouteAverage = keyCount === 0 ? 100 : 100 - totalDeficit / keyCount;
@@ -5875,7 +6044,13 @@ function computeScore(results, config, options = {}) {
   const capBinds = applyCap && anyCritical && rawUncapped > CRITICAL_CAP;
   const criticalCap = capBinds ? CRITICAL_CAP : null;
   const rawScore = clamp(capBinds ? CRITICAL_CAP : rawUncapped);
-  return { score: Math.floor(rawScore), rawScore, scoreModel: { routeAverage, sitePenalty, criticalCap } };
+  return {
+    score: Math.floor(rawScore),
+    rawScore,
+    scoreModel: { routeAverage, sitePenalty, criticalCap },
+    keys: keyCount,
+    affectedKeys
+  };
 }
 function scoresByCategory(results, config, options = {}) {
   const byCat = /* @__PURE__ */ new Map();
@@ -6093,7 +6268,10 @@ function buildJsonReport(results, config, meta, ruleIds) {
   const summary = summarize(results, config);
   const rules = ruleEvidence(results, config, ruleIds);
   const categories = Object.fromEntries(
-    Object.entries(byCat).map(([cat, sr]) => [cat, { score: sr.score, scoreModel: sr.scoreModel }])
+    Object.entries(byCat).map(([cat, sr]) => [
+      cat,
+      { score: sr.score, scoreModel: sr.scoreModel, keys: sr.keys, affectedKeys: sr.affectedKeys }
+    ])
   );
   const routeMap = /* @__PURE__ */ new Map();
   for (const r of results) {
@@ -6112,7 +6290,10 @@ function buildJsonReport(results, config, meta, ruleIds) {
     issues: rs.filter((r) => isPenalized(r.detection, config.treatDynamicAs)).map((r) => ({ ...issueOf(r), severity: effectiveSeverity(r, config) }))
   }));
   const siteIssues = results.filter((r) => r.route === void 0 && isPenalized(r.detection, config.treatDynamicAs)).map((r) => ({ ...issueOf(r), severity: effectiveSeverity(r, config) }));
-  return { version: meta.version, score: health, weights, categories, summary, rules, routes, siteIssues };
+  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 };
 }
 function formatJsonReport(results, config, meta, ruleIds) {
   return JSON.stringify(buildJsonReport(results, config, meta, ruleIds), null, 2);
@@ -7053,6 +7234,7 @@ export {
   architecturePrivateScopeImport,
   architecturePropCount,
   architectureReservedDirectoryNames,
+  architectureReservedNamePlacement,
   architectureRouteComponentImport,
   architectureUnitEntryFile,
   attrText,

package/package.json

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