svelte-vitals 0.51.0 → 0.52.0

package/dist/{analyze-BaQfhf-Q.js → analyze-njXPaqmd.js}

@@ -1,4 +1,4 @@
-import { c as findUnknownRuleIds, f as isReporterName, i as run, l as knownRuleIds, m as readPackageVersion, p as readCoreVersion } from "./src-BSphfbnn.js";
+import { c as findUnknownRuleIds, h as readPackageVersion, i as run, l as knownRuleIds, m as readCoreVersion, p as isReporterName } from "./src-hgEeAWHb.js";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, resolve } from "node:path";
 import { spawnSync } from "node:child_process";
@@ -636,7 +636,7 @@ const BOOLEAN_FLAGS = [
 const ROOT_ARGS = {
 	"meta-components": {
 		type: "string",
-		description: "Comma-separated component names that emit head metadata"
+		description: "Comma-separated names of head-metadata components the analyzer cannot resolve"
 	},
 	"treat-dynamic-as": {
 		type: "string",
@@ -775,7 +775,7 @@ function neutralizeBareDiffAndBaseline(argv) {
 */
 async function buildHelpText(rootCommand, locale) {
 	if (locale === "ja") {
-		const { JA_ARG_DESCRIPTIONS, rootHelpJa } = await import("./ja-CULhsFnk.js").then((n) => n.n);
+		const { JA_ARG_DESCRIPTIONS, rootHelpJa } = await import("./ja-BDLP3KLG.js").then((n) => n.n);
 		return rootHelpJa(await localizedOptionsSection(rootCommand, "svelte-vitals", locale, JA_ARG_DESCRIPTIONS.root));
 	}
 	return `svelte-vitals — a deterministic SvelteKit code-health scanner (SEO · performance · correctness · security · architecture · accessibility)

package/dist/bin.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { g as realIO, i as resolveLocale, m as consoleIO, n as runAnalyzeCliGunshi } from "./analyze-BaQfhf-Q.js";
+import { g as realIO, i as resolveLocale, m as consoleIO, n as runAnalyzeCliGunshi } from "./analyze-njXPaqmd.js";
 //#region src/cli.ts
 /**
 * CLI dispatch: routes `docs`/`explain`/`install`/`ci` subcommands, otherwise hands off to the
@@ -16,35 +16,35 @@ async function runCli(argv, io = consoleIO, env = process.env) {
 	try {
 		const locale = resolveLocale(env);
 		if (argv[0] === "complete") {
-			const { runCompleteCliGunshi } = await import("./complete-1RY2W-3I.js");
+			const { runCompleteCliGunshi } = await import("./complete-Cy8SdF0S.js");
 			return {
 				code: await runCompleteCliGunshi(argv, io),
 				exit: "natural"
 			};
 		}
 		if (argv[0] === "docs") {
-			const { runDocsCliGunshi } = await import("./docs-53bz9lhZ.js");
+			const { runDocsCliGunshi } = await import("./docs-YEEkUHTO.js");
 			return {
 				code: await runDocsCliGunshi(argv.slice(1), io, locale),
 				exit: "natural"
 			};
 		}
 		if (argv[0] === "explain") {
-			const { runExplainCliGunshi } = await import("./explain-DdgC6CdN.js");
+			const { runExplainCliGunshi } = await import("./explain-B0DWOujg.js");
 			return {
 				code: await runExplainCliGunshi(argv.slice(1), io, locale),
 				exit: "natural"
 			};
 		}
 		if (argv[0] === "install") {
-			const { runInstallCliGunshi } = await import("./install-ckW1HTAL.js").then((n) => n.n);
+			const { runInstallCliGunshi } = await import("./install-CzogylBI.js").then((n) => n.n);
 			return {
 				code: await runInstallCliGunshi(argv.slice(1), io, locale),
 				exit: "immediate"
 			};
 		}
 		if (argv[0] === "ci") {
-			const { runCiCliGunshi } = await import("./ci-CG1mwBD4.js");
+			const { runCiCliGunshi } = await import("./ci-BWM2gYNJ.js");
 			return {
 				code: await runCiCliGunshi(argv.slice(1), {
 					...realIO(),

package/dist/{ci-CG1mwBD4.js → ci-BWM2gYNJ.js}

@@ -1,4 +1,4 @@
-import { a as guardArgs, c as stripUnknownFlags, g as realIO, l as suggestClosest, o as splitAtTerminator, r as localizedOptionsSection, s as stripAutoVersionLine } from "./analyze-BaQfhf-Q.js";
+import { a as guardArgs, c as stripUnknownFlags, g as realIO, l as suggestClosest, o as splitAtTerminator, r as localizedOptionsSection, s as stripAutoVersionLine } from "./analyze-njXPaqmd.js";
 import { a as planWorkflowWrite, i as buildWorkflowYaml, n as ACTION_VERSION, r as WORKFLOW_PATH, t as ACTION_SHA } from "./action-pin.generated-C2XJJ3NW.js";
 import { join } from "node:path";
 import { cli } from "gunshi/bone";
@@ -115,7 +115,7 @@ const KNOWN_SHORT_FLAGS = /* @__PURE__ */ new Set(["h"]);
 * (`docs/superpowers/specs/2026-08-11-cli-ja-help-design.md`).
 */
 async function buildCiHelpText(ciArgsCommand, locale) {
-	const ja = locale === "ja" ? await import("./ja-CULhsFnk.js").then((n) => n.n) : void 0;
+	const ja = locale === "ja" ? await import("./ja-BDLP3KLG.js").then((n) => n.n) : void 0;
 	const optionsSection = stripAutoVersionLine(await localizedOptionsSection(ciArgsCommand, "svelte-vitals ci", locale, ja?.JA_ARG_DESCRIPTIONS.ci ?? {}));
 	if (locale === "ja") return ja.ciHelpJa(optionsSection, WORKFLOW_PATH);
 	return `svelte-vitals ci — scaffold CI integration

package/dist/{complete-1RY2W-3I.js → complete-Cy8SdF0S.js}

@@ -1,9 +1,9 @@
-import { d as REPORTER_NAMES } from "./src-BSphfbnn.js";
-import { d as FAIL_ON_VALUES, f as TREAT_DYNAMIC_AS_VALUES, m as consoleIO, t as ROOT_ARGS, u as CATEGORIES } from "./analyze-BaQfhf-Q.js";
-import { t as INSTALL_ARGS } from "./install-ckW1HTAL.js";
-import { CI_ARGS, CI_UPGRADE_ARGS } from "./ci-CG1mwBD4.js";
-import { DOCS_LIST_ARGS, DOCS_ROOT_ARGS, DOCS_SHOW_ARGS } from "./docs-53bz9lhZ.js";
-import { EXPLAIN_ARGS } from "./explain-DdgC6CdN.js";
+import { f as REPORTER_NAMES } from "./src-hgEeAWHb.js";
+import { d as FAIL_ON_VALUES, f as TREAT_DYNAMIC_AS_VALUES, m as consoleIO, t as ROOT_ARGS, u as CATEGORIES } from "./analyze-njXPaqmd.js";
+import { t as INSTALL_ARGS } from "./install-CzogylBI.js";
+import { CI_ARGS, CI_UPGRADE_ARGS } from "./ci-BWM2gYNJ.js";
+import { DOCS_LIST_ARGS, DOCS_ROOT_ARGS, DOCS_SHOW_ARGS } from "./docs-YEEkUHTO.js";
+import { EXPLAIN_ARGS } from "./explain-B0DWOujg.js";
 import { cli } from "gunshi/bone";
 import { define } from "gunshi/definition";
 import { kebabnize } from "gunshi/utils";

package/dist/{docs-53bz9lhZ.js → docs-YEEkUHTO.js}

@@ -1,5 +1,5 @@
-import { l as knownRuleIds } from "./src-BSphfbnn.js";
-import { a as guardArgs, c as stripUnknownFlags, l as suggestClosest, m as consoleIO, o as splitAtTerminator, r as localizedOptionsSection, s as stripAutoVersionLine } from "./analyze-BaQfhf-Q.js";
+import { l as knownRuleIds } from "./src-hgEeAWHb.js";
+import { a as guardArgs, c as stripUnknownFlags, l as suggestClosest, m as consoleIO, o as splitAtTerminator, r as localizedOptionsSection, s as stripAutoVersionLine } from "./analyze-njXPaqmd.js";
 import { docsUrlFor } from "@svelte-vitals/core/internal";
 import { cli } from "gunshi/bone";
 import { define } from "gunshi/definition";
@@ -16,7 +16,7 @@ const EMBEDDED_DOCS = [
 		name: "config",
 		title: "The config file",
 		description: "Where svelte-vitals.config lives, every top-level option, how to disable or re-grade a rule, and how to scope rules to routes or files.",
-		body: "# The config file\n\n## Where it lives\n\nIn the **analyzed directory only** — no upward search. First match wins:\n\n1. `svelte-vitals.config.js`\n2. `svelte-vitals.config.ts`\n\nNo file means built-in defaults. `svelte-vitals install --client config-file` scaffolds one with\nevery option commented out.\n\n`--config <path>` analyzes under the config file at that path instead of the one in the analyzed\ndirectory — no discovery, no merge. A relative path resolves against the directory you run the\ncommand from, never the analyzed directory: from a repo root,\n`svelte-vitals apps/web --config shared/sv.config.js` reads `./shared/sv.config.js`. It accepts\n`.js` and `.ts` only, and a missing or unreadable file exits `2`. Useful for trying a config out\nbefore committing it, and for sharing one config across the apps in a monorepo. CLI only: the Vite\nplugin resolves its own config from the `cwd` passed to `svelteVitals({ ... })` (else the Vite\nconfig root) — share with it by importing the shared file in `vite.config.ts` and spreading it\ninto the plugin's options.\n\n```js\n// svelte-vitals.config.js\nexport default {\n  treatDynamicAs: 'warn',\n  metaComponents: ['Seo'],\n  rules: { 'seo/json-ld': 'off' },\n  failOn: 'warning',\n  weights: { seo: 2 }\n};\n```\n\nA `.ts` config can `import { defineConfig } from 'svelte-vitals'` for type-checking, but that is a\n**runtime** import: it needs svelte-vitals as a declared dependency. A plain `export default {}`\nin `.js` behaves identically and needs no dependency. Both are ESM — the project must be\n`\"type\": \"module\"` (SvelteKit's default).\n\n## Options\n\n| Option           | Type                                                           | Default            |\n| ---------------- | -------------------------------------------------------------- | ------------------ |\n| `treatDynamicAs` | `'pass' \\| 'warn' \\| 'fail'`                                   | `'pass'`           |\n| `metaComponents` | `string[]`                                                     | `[]`               |\n| `rules`          | `Record<ruleId, 'off' \\| Severity \\| { severity?, options? }>` | `{}`               |\n| `failOn`         | `'critical' \\| 'warning' \\| 'info'`                            | `'critical'`       |\n| `weights`        | `Partial<Record<Category, number>>`                            | every category `1` |\n| `overrides`      | `RuleOverride[]`                                               | (none)             |\n\n`Severity` is `'critical' | 'warning' | 'info'`. `Category` is `'seo' | 'performance' |\n'correctness' | 'security' | 'architecture' | 'a11y'`. A weight of `0` drops a category from the Health\naverage; setting every category to `0` is an error (exit `2`).\n\n## Turning a rule off or down\n\n```js\nexport default {\n  rules: {\n    'seo/json-ld': 'off', // remove its findings entirely\n    'architecture/prop-count': 'info' // keep it, stop it failing the build\n  }\n};\n```\n\nMany rules take options, so check whether the finding is a **threshold disagreement** rather than\na defect first. `svelte-vitals explain <rule-id>` prints each option's name, default, bounds, and\nmerge semantics (`integer` replaces, `string-list` appends, `string-map` is spread over).\n\n```js\nexport default {\n  rules: {\n    'architecture/prop-count': { options: { max: 12 } }\n  }\n};\n```\n\n## Scoping to routes or files (`overrides`)\n\n`rules` applies everywhere; `overrides` applies only where it matches — typically routes that\nare deliberately not public.\n\n```js\nexport default {\n  overrides: [\n    { files: 'src/routes/(app)/**', rules: { seo: 'off' } },\n    { route: '/admin/**', rules: { 'seo/title-presence': 'info' } }\n  ]\n};\n```\n\nEach entry needs `rules` (keys are rule ids **or** category names) plus at least one of:\n\n- **`route`** — glob(s) against the route id as reported (`/blog/[slug]`). SvelteKit `(group)`\n  segments are **not** in the route id, so use `files` to target a group.\n- **`files`** — glob(s) against the source path.\n\nGlobs are deliberately small: `*` within a segment, `**` across segments, a trailing `/**` also\nmatches the bare prefix. Everything else — including `(`, `)`, `[`, `]` — is literal. Later entries win.\n\n## Precedence\n\nPer field: **CLI flag > config file > built-in default**. One exception — `--rules` and `--ignore`\nare selection, not configuration: `--rules` narrows the run to the ids it names and overrides a\nconfig-file `off` for them, but keeps their declared severity and options; `--ignore` adds `off`\nentries for the ids it names, layered on top of whatever `rules` resolved to, and beats `--rules`\nwhen both name the same rule.\n\n`overrides` has no CLI flag; route policy belongs in a committed file.\n\n## Validation\n\nAn unknown rule id or category, a negative weight, a malformed `overrides` entry, or an invalid\nrule setting is a **hard error (exit `2`)** — a typo must not silently un-gate CI. An unrecognized\n`treatDynamicAs`/`failOn` value, or an unknown top-level key, only warns.\n\n## Related\n\n- `svelte-vitals explain --list` — every rule id\n- `svelte-vitals docs show scoping` — accepting an existing backlog instead of disabling rules"
+		body: "# The config file\n\n## Where it lives\n\nIn the **analyzed directory only** — no upward search. First match wins:\n\n1. `svelte-vitals.config.js`\n2. `svelte-vitals.config.ts`\n\nNo file means built-in defaults. `svelte-vitals install --client config-file` scaffolds one with\nevery option commented out.\n\n`--config <path>` analyzes under the config file at that path instead of the one in the analyzed\ndirectory — no discovery, no merge. A relative path resolves against the directory you run the\ncommand from, never the analyzed directory: from a repo root,\n`svelte-vitals apps/web --config shared/sv.config.js` reads `./shared/sv.config.js`. It accepts\n`.js` and `.ts` only, and a missing or unreadable file exits `2`. Useful for trying a config out\nbefore committing it, and for sharing one config across the apps in a monorepo. CLI only: the Vite\nplugin resolves its own config from the `cwd` passed to `svelteVitals({ ... })` (else the Vite\nconfig root) — share with it by importing the shared file in `vite.config.ts` and spreading it\ninto the plugin's options.\n\n```js\n// svelte-vitals.config.js\nexport default {\n  treatDynamicAs: 'warn',\n  metaComponents: ['Seo'],\n  rules: { 'seo/json-ld': 'off' },\n  failOn: 'warning',\n  weights: { seo: 2 }\n};\n```\n\nA `.ts` config can `import { defineConfig } from 'svelte-vitals'` for type-checking, but that is a\n**runtime** import: it needs svelte-vitals as a declared dependency. A plain `export default {}`\nin `.js` behaves identically and needs no dependency. Both are ESM — the project must be\n`\"type\": \"module\"` (SvelteKit's default).\n\n## Options\n\n| Option           | Type                                                           | Default            |\n| ---------------- | -------------------------------------------------------------- | ------------------ |\n| `treatDynamicAs` | `'pass' \\| 'warn' \\| 'fail'`                                   | `'pass'`           |\n| `metaComponents` | `string[]`                                                     | `[]`               |\n| `rules`          | `Record<ruleId, 'off' \\| Severity \\| { severity?, options? }>` | `{}`               |\n| `failOn`         | `'critical' \\| 'warning' \\| 'info'`                            | `'critical'`       |\n| `weights`        | `Partial<Record<Category, number>>`                            | every category `1` |\n| `overrides`      | `RuleOverride[]`                                               | (none)             |\n\n`Severity` is `'critical' | 'warning' | 'info'`. `Category` is `'seo' | 'performance' |\n'correctness' | 'security' | 'architecture' | 'a11y'`. A weight of `0` drops a category from the Health\naverage; setting every category to `0` is an error (exit `2`).\n\n`metaComponents` names head-metadata components the analyzer cannot resolve (e.g. from an npm\npackage without an adapter). Components the analyzer can resolve in your own repo are followed\nautomatically — declaring one of those is a no-op; the declaration only kicks in when\nresolution fails.\n\n## Turning a rule off or down\n\n```js\nexport default {\n  rules: {\n    'seo/json-ld': 'off', // remove its findings entirely\n    'architecture/prop-count': 'info' // keep it, stop it failing the build\n  }\n};\n```\n\nMany rules take options, so check whether the finding is a **threshold disagreement** rather than\na defect first. `svelte-vitals explain <rule-id>` prints each option's name, default, bounds, and\nmerge semantics (`integer` replaces, `string-list` appends, `string-map` is spread over).\n\n```js\nexport default {\n  rules: {\n    'architecture/prop-count': { options: { max: 12 } }\n  }\n};\n```\n\n## Scoping to routes or files (`overrides`)\n\n`rules` applies everywhere; `overrides` applies only where it matches — typically routes that\nare deliberately not public.\n\n```js\nexport default {\n  overrides: [\n    { files: 'src/routes/(app)/**', rules: { seo: 'off' } },\n    { route: '/admin/**', rules: { 'seo/title-presence': 'info' } }\n  ]\n};\n```\n\nEach entry needs `rules` (keys are rule ids **or** category names) plus at least one of:\n\n- **`route`** — glob(s) against the route id as reported (`/blog/[slug]`). SvelteKit `(group)`\n  segments are **not** in the route id, so use `files` to target a group.\n- **`files`** — glob(s) against the source path.\n\nGlobs are deliberately small: `*` within a segment, `**` across segments, a trailing `/**` also\nmatches the bare prefix. Everything else — including `(`, `)`, `[`, `]` — is literal. Later entries win.\n\n## Precedence\n\nPer field: **CLI flag > config file > built-in default**. One exception — `--rules` and `--ignore`\nare selection, not configuration: `--rules` narrows the run to the ids it names and overrides a\nconfig-file `off` for them, but keeps their declared severity and options; `--ignore` adds `off`\nentries for the ids it names, layered on top of whatever `rules` resolved to, and beats `--rules`\nwhen both name the same rule.\n\n`overrides` has no CLI flag; route policy belongs in a committed file.\n\n## Validation\n\nAn unknown rule id or category, a negative weight, a malformed `overrides` entry, or an invalid\nrule setting is a **hard error (exit `2`)** — a typo must not silently un-gate CI. An unrecognized\n`treatDynamicAs`/`failOn` value, or an unknown top-level key, only warns.\n\n## Related\n\n- `svelte-vitals explain --list` — every rule id\n- `svelte-vitals docs show scoping` — accepting an existing backlog instead of disabling rules"
 	},
 	{
 		name: "monorepo",
@@ -117,7 +117,7 @@ const DOCS_SHOW_ARGS = {
 * (`docs/superpowers/specs/2026-08-11-cli-ja-help-design.md`).
 */
 async function buildDocsHelpText(rootCommand, locale) {
-	const ja = locale === "ja" ? await import("./ja-CULhsFnk.js").then((n) => n.n) : void 0;
+	const ja = locale === "ja" ? await import("./ja-BDLP3KLG.js").then((n) => n.n) : void 0;
 	const optionsSection = stripAutoVersionLine(await localizedOptionsSection(rootCommand, "svelte-vitals docs", locale, ja?.JA_ARG_DESCRIPTIONS.docs ?? {}));
 	if (locale === "ja") return ja.docsHelpJa(optionsSection);
 	return `svelte-vitals docs — read the bundled guides without leaving the terminal

package/dist/{explain-DdgC6CdN.js → explain-B0DWOujg.js}

@@ -1,5 +1,5 @@
-import { l as knownRuleIds } from "./src-BSphfbnn.js";
-import { a as guardArgs, c as stripUnknownFlags, l as suggestClosest, m as consoleIO, o as splitAtTerminator, r as localizedOptionsSection, s as stripAutoVersionLine } from "./analyze-BaQfhf-Q.js";
+import { l as knownRuleIds } from "./src-hgEeAWHb.js";
+import { a as guardArgs, c as stripUnknownFlags, l as suggestClosest, m as consoleIO, o as splitAtTerminator, r as localizedOptionsSection, s as stripAutoVersionLine } from "./analyze-njXPaqmd.js";
 import { CATEGORIES } from "@svelte-vitals/core";
 import { allRules, explainRule } from "@svelte-vitals/core/internal";
 import { cli } from "gunshi/bone";
@@ -82,7 +82,7 @@ const EXPLAIN_ARGS = {
 * (`docs/superpowers/specs/2026-08-11-cli-ja-help-design.md`).
 */
 async function buildExplainHelpText(explainCommand, locale) {
-	const ja = locale === "ja" ? await import("./ja-CULhsFnk.js").then((n) => n.n) : void 0;
+	const ja = locale === "ja" ? await import("./ja-BDLP3KLG.js").then((n) => n.n) : void 0;
 	const optionsSection = stripAutoVersionLine(await localizedOptionsSection(explainCommand, "svelte-vitals explain", locale, ja?.JA_ARG_DESCRIPTIONS.explain ?? {}));
 	if (locale === "ja") return ja.explainHelpJa(optionsSection);
 	return `svelte-vitals explain — print a rule's rationale, fix, and configurable options

package/dist/gunshi-registry.js

@@ -1,4 +1,4 @@
-import { t as ROOT_ARGS } from "./analyze-BaQfhf-Q.js";
-import { t as INSTALL_ARGS } from "./install-ckW1HTAL.js";
-import { t as JA_ARG_DESCRIPTIONS } from "./ja-CULhsFnk.js";
+import { t as ROOT_ARGS } from "./analyze-njXPaqmd.js";
+import { t as INSTALL_ARGS } from "./install-CzogylBI.js";
+import { t as JA_ARG_DESCRIPTIONS } from "./ja-BDLP3KLG.js";
 export { INSTALL_ARGS, JA_ARG_DESCRIPTIONS, ROOT_ARGS };

package/dist/index.d.ts

@@ -142,6 +142,14 @@ declare function findUnknownRuleIds(ids: string[]): string[];
 declare function knownRuleIds(): string[];
 /** The options a rule declares, or undefined when it takes none. */
 declare function ruleOptionsSpec(id: string): RuleOptionsSpec | undefined;
+/**
+ * Stamps the rule registry's provenance onto error messages that list known ids.
+ * Two copies of svelte-vitals can coexist in one tree (e.g. the Vite plugin's
+ * resolved copy and a directly installed CLI, issue #583); without the versions,
+ * a rule that exists in one copy but not the other reads as a mystery rather
+ * than a version skew.
+ */
+declare function registryTag(): string;
 //#endregion
 //#region src/index.d.ts
 interface RunOptions {
@@ -362,4 +370,4 @@ declare function applyScope(results: Result[], opts: ApplyScopeOptions): Promise
  */
 declare function run(opts?: RunOptions): Promise<number>;
 //#endregion
-export { AnalyzeOptions, AnalyzeResult, ApplyScopeOptions, CONFIG_FILENAMES, type LoadedConfigFile, type ParseCache, ProjectError, RunOptions, analyzeProject, applyScope, defineConfig, findUnknownRuleIds, knownRuleIds, loadConfigFile, routeMatcher, ruleOptionsSpec, run, spinnerEnabled };
+export { AnalyzeOptions, AnalyzeResult, ApplyScopeOptions, CONFIG_FILENAMES, type LoadedConfigFile, type ParseCache, ProjectError, RunOptions, analyzeProject, applyScope, defineConfig, findUnknownRuleIds, knownRuleIds, loadConfigFile, registryTag, routeMatcher, ruleOptionsSpec, run, spinnerEnabled };

package/dist/index.js

@@ -1,2 +1,2 @@
-import { a as spinnerEnabled, c as findUnknownRuleIds, i as run, l as knownRuleIds, n as applyScope, o as CONFIG_FILENAMES, r as defineConfig, s as loadConfigFile, t as analyzeProject, u as ruleOptionsSpec, v as routeMatcher, y as ProjectError } from "./src-BSphfbnn.js";
-export { CONFIG_FILENAMES, ProjectError, analyzeProject, applyScope, defineConfig, findUnknownRuleIds, knownRuleIds, loadConfigFile, routeMatcher, ruleOptionsSpec, run, spinnerEnabled };
+import { a as spinnerEnabled, b as ProjectError, c as findUnknownRuleIds, d as ruleOptionsSpec, i as run, l as knownRuleIds, n as applyScope, o as CONFIG_FILENAMES, r as defineConfig, s as loadConfigFile, t as analyzeProject, u as registryTag, y as routeMatcher } from "./src-hgEeAWHb.js";
+export { CONFIG_FILENAMES, ProjectError, analyzeProject, applyScope, defineConfig, findUnknownRuleIds, knownRuleIds, loadConfigFile, registryTag, routeMatcher, ruleOptionsSpec, run, spinnerEnabled };

package/dist/install/setup-skill-content.js

@@ -118,6 +118,11 @@ otherwise the app directory. Every \`npx svelte-vitals\` below then runs that in
 of \`node_modules/.bin\`, at the version the lockfile pins rather than whatever the registry serves;
 the package manager's own runner (\`pnpm exec\`, \`yarn\`, \`bun run\`) is equivalent.
 
+If \`@svelte-vitals/vite\` is already installed, keep the two on the same rule registry: install a
+\`svelte-vitals\` version the plugin's \`peerDependencies\` range accepts, or update both together —
+a CLI ahead of the plugin accepts config the plugin's copy rejects, so the scan passes and
+\`vite build\` fails on the same file.
+
 Ask nothing yet. Read:
 
 | Read                          | Where                                                                              | What it decides                                                                            |

package/dist/{install-ckW1HTAL.js → install-CzogylBI.js}

@@ -1,6 +1,6 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { _ as readPkg, g as hasDep, h as discoverApps, m as readPackageVersion, o as CONFIG_FILENAMES } from "./src-BSphfbnn.js";
-import { a as guardArgs, c as stripUnknownFlags, g as realIO, h as clackPrompts, m as consoleIO, o as splitAtTerminator, p as toList, r as localizedOptionsSection, s as stripAutoVersionLine } from "./analyze-BaQfhf-Q.js";
+import { _ as hasDep, g as discoverApps, h as readPackageVersion, o as CONFIG_FILENAMES, v as readPkg } from "./src-hgEeAWHb.js";
+import { a as guardArgs, c as stripUnknownFlags, g as realIO, h as clackPrompts, m as consoleIO, o as splitAtTerminator, p as toList, r as localizedOptionsSection, s as stripAutoVersionLine } from "./analyze-njXPaqmd.js";
 import { a as planWorkflowWrite, i as buildWorkflowYaml, n as ACTION_VERSION, r as WORKFLOW_PATH, t as ACTION_SHA } from "./action-pin.generated-C2XJJ3NW.js";
 import { buildCursorRules, installHeader } from "./install/skill-content.js";
 import { join } from "node:path";
@@ -71,7 +71,7 @@ function isKind(id, kind) {
 function buildConfigFileTemplate(opts = {}) {
 	const header = "// svelte-vitals config file — https://oekazuma.github.io/svelte-vitals/guides/configuration/\n";
 	const options = `  // treatDynamicAs: 'pass', // 'pass' | 'warn' | 'fail' — how {data.title}-style dynamic values are scored
-  // metaComponents: ['Seo'], // component names that resolve SEO tags into <head>
+  // metaComponents: ['Seo'], // head-metadata components the analyzer can't resolve (e.g. from an npm package)
   // rules: {}, // e.g. { 'seo/title-presence': 'off' } to disable a rule
   // failOn: 'critical', // 'critical' | 'warning' | 'info'
   // weights: {} // e.g. { seo: 2 } — per-category weight for the combined Health score`;
@@ -818,7 +818,7 @@ const INSTALL_ARGS = {
 * ja-localized when `locale` is 'ja' (`docs/superpowers/specs/2026-08-11-cli-ja-help-design.md`).
 */
 async function buildInstallHelpText(installCommand, locale) {
-	const ja = locale === "ja" ? await import("./ja-CULhsFnk.js").then((n) => n.n) : void 0;
+	const ja = locale === "ja" ? await import("./ja-BDLP3KLG.js").then((n) => n.n) : void 0;
 	const optionsSection = stripAutoVersionLine(await localizedOptionsSection(installCommand, "svelte-vitals install", locale, ja?.JA_ARG_DESCRIPTIONS.install ?? {}));
 	if (locale === "ja") return ja.installHelpJa(optionsSection);
 	return `svelte-vitals install — set up the svelte-vitals Vite integration, Cursor rules, config file, and CI

package/dist/{ja-CULhsFnk.js → ja-BDLP3KLG.js}

@@ -34,7 +34,7 @@ var ja_exports = /* @__PURE__ */ __exportAll({
 */
 const JA_ARG_DESCRIPTIONS = {
 	root: {
-		"meta-components": "head メタデータを出力するコンポーネント名（カンマ区切り）",
+		"meta-components": "解析が追跡できない head メタデータ出力コンポーネント名（カンマ区切り）",
 		"treat-dynamic-as": "pass | warn | fail（デフォルト: pass）",
 		route: "指定した glob に一致するルートのみ解析",
 		diff: "ref と比較して変更されたファイルの検出結果のみ報告（デフォルト HEAD。例: --diff main）",

package/dist/{src-BSphfbnn.js → src-hgEeAWHb.js}

@@ -1102,10 +1102,6 @@ async function resolveFileTags(rt, cwd, fileRel, parsed, config, depth, visited,
 			broad = broad || result.broad;
 			continue;
 		}
-		if (config.metaComponents.includes(use.name)) {
-			broad = true;
-			continue;
-		}
 		const childRel = info ? resolveComponentPath(info.source, fileRel, aliases) : void 0;
 		if (childRel && depth > 0 && !visited.has(childRel)) {
 			const abs = rt.join(cwd, childRel);
@@ -1120,8 +1116,13 @@ async function resolveFileTags(rt, cwd, fileRel, parsed, config, depth, visited,
 					file: childRel
 				});
 				headings.push(...child.headings);
+				continue;
 			}
 		}
+		if (config.metaComponents.includes(use.name)) {
+			broad = true;
+			continue;
+		}
 	}
 	return {
 		tags,
@@ -1248,7 +1249,7 @@ function offsetPath(path, base) {
 /**
 * One file's contribution to the route: its own occurrences plus, inline at each component
 * usage, that component's contribution carrying the usage's branch address and repeatability.
-* Anything that cannot be followed (package/adapter/meta component, `<svelte:component>`,
+* Anything that cannot be followed (package/adapter import, `<svelte:component>`,
 * a cycle, MAX_DEPTH) contributes nothing and opens the world — existential rules stay sound,
 * `no-missing-id-ref` skips the route.
 */
@@ -1277,7 +1278,7 @@ async function composeA11y(ctx, fileRel, parsed, depth, visited, chain) {
 			});
 			continue;
 		}
-		const info = ctx.config.metaComponents.includes(node.key) ? void 0 : parsed.imports.get(node.key);
+		const info = parsed.imports.get(node.key);
 		const childRel = info ? resolveComponentPath(info.source, fileRel, ctx.aliases) : void 0;
 		if (!childRel || depth <= 0 || visited.has(childRel) || !await rt.exists(rt.join(cwd, childRel))) {
 			state.fullyResolved = false;
@@ -1347,7 +1348,6 @@ async function resolveRoute(rt, cwd, pageRel, config, layouts, cache, aliases, a
 	const a11yCtx = {
 		rt,
 		cwd,
-		config,
 		cache,
 		aliases,
 		state: {
@@ -1947,6 +1947,16 @@ function knownRuleIds() {
 function ruleOptionsSpec(id) {
 	return RULE_BY_ID.get(id)?.options;
 }
+/**
+* Stamps the rule registry's provenance onto error messages that list known ids.
+* Two copies of svelte-vitals can coexist in one tree (e.g. the Vite plugin's
+* resolved copy and a directly installed CLI, issue #583); without the versions,
+* a rule that exists in one copy but not the other reads as a mystery rather
+* than a version skew.
+*/
+function registryTag() {
+	return `svelte-vitals ${readPackageVersion()}, core ${readCoreVersion()}`;
+}
 //#endregion
 //#region src/config-file.ts
 /**
@@ -2035,7 +2045,7 @@ function validateConfigFile(raw, path) {
 		if (!isPlainObject(raw.rules)) throw new Error(`${path}: rules must be an object of rule-id → setting.`);
 		const rules = raw.rules;
 		const unknown = findUnknownRuleIds(Object.keys(rules));
-		if (unknown.length > 0) throw new Error(`${path}: unknown rule id(s) in rules: ${unknown.join(", ")}. Known rule ids: ${knownRuleIds().join(", ")}`);
+		if (unknown.length > 0) throw new Error(`${path}: unknown rule id(s) in rules: ${unknown.join(", ")}. Known rule ids (${registryTag()}): ${knownRuleIds().join(", ")}`);
 		for (const [key, setting] of Object.entries(rules)) validateSetting(path, "rules", key, setting, true);
 		config.rules = rules;
 	}
@@ -2053,7 +2063,7 @@ function validateConfigFile(raw, path) {
 			if (!isPlainObject(entry.rules)) throw new Error(`${path}: overrides[${i}].rules must be an object of rule-id/category → setting.`);
 			if (Object.keys(entry.rules).length === 0) throw new Error(`${path}: overrides[${i}].rules must contain at least one rule id or category.`);
 			const unknown = findUnknownRuleIds(Object.keys(entry.rules).filter((k) => !CATEGORIES.includes(k)));
-			if (unknown.length > 0) throw new Error(`${path}: unknown rule id(s) or categories in overrides[${i}].rules: ${unknown.join(", ")}. Known categories: ${CATEGORIES.join(", ")}. Known rule ids: ${knownRuleIds().join(", ")}`);
+			if (unknown.length > 0) throw new Error(`${path}: unknown rule id(s) or categories in overrides[${i}].rules: ${unknown.join(", ")}. Known categories: ${CATEGORIES.join(", ")}. Known rule ids (${registryTag()}): ${knownRuleIds().join(", ")}`);
 			for (const [key, setting] of Object.entries(entry.rules)) {
 				const isCategory = CATEGORIES.includes(key);
 				const baseline = isCategory ? void 0 : resolveRuleOptions(key, ruleOptionsSpec(key), {
@@ -3143,4 +3153,4 @@ async function run(opts = {}) {
 	}
 }
 //#endregion
-export { readPkg as _, spinnerEnabled as a, findUnknownRuleIds as c, REPORTER_NAMES as d, isReporterName as f, hasDep as g, discoverApps as h, run as i, knownRuleIds as l, readPackageVersion as m, applyScope as n, CONFIG_FILENAMES as o, readCoreVersion as p, defineConfig$1 as r, loadConfigFile as s, analyzeProject as t, ruleOptionsSpec as u, routeMatcher as v, ProjectError as y };
+export { hasDep as _, spinnerEnabled as a, ProjectError as b, findUnknownRuleIds as c, ruleOptionsSpec as d, REPORTER_NAMES as f, discoverApps as g, readPackageVersion as h, run as i, knownRuleIds as l, readCoreVersion as m, applyScope as n, CONFIG_FILENAMES as o, isReporterName as p, defineConfig$1 as r, loadConfigFile as s, analyzeProject as t, registryTag as u, readPkg as v, routeMatcher as y };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svelte-vitals",
-  "version": "0.51.0",
+  "version": "0.52.0",
   "description": "A deterministic SvelteKit code-health scanner (SEO, performance, correctness, security, architecture, accessibility).",
   "type": "module",
   "license": "MIT",
@@ -51,7 +51,7 @@
     "magicast": "^0.5.4",
     "svelte": "^5.56.10",
     "tinyglobby": "^0.2.17",
-    "@svelte-vitals/core": "0.47.2"
+    "@svelte-vitals/core": "0.48.0"
   },
   "devDependencies": {
     "@gunshi/docs": "0.37.1",