@svelte-vitals/core 0.18.0 → 0.19.0

package/dist/index.d.ts

@@ -224,6 +224,13 @@ interface SourceSpan {
     /** 1-based source line, or 0 if unknown. */
     line: number;
 }
+/** An inline `svelte-vitals-disable-next-line` directive found in the component's source (issue #92). */
+interface SuppressionDirective {
+    /** 1-based line the directive suppresses (the line immediately after the comment). */
+    line: number;
+    /** Rule ids suppressed on that line; undefined = suppress every rule on that line. */
+    ruleIds?: string[];
+}
 /** Reactivity/correctness + security + architecture facts parsed from one `.svelte` component. */
 interface ComponentFacts {
     /** Source file the component came from. */
@@ -250,8 +257,58 @@ interface ComponentFacts {
         name: string;
         line: number;
     }[];
+    /** Inline `svelte-vitals-disable-next-line` directives found in this file's source — component-rule escape hatch (issue #92). Optional: absent is equivalent to no directives, so existing external constructors of `ComponentFacts` are unaffected. */
+    suppressions?: SuppressionDirective[];
 }
 
+/** Parse a component's reactivity/correctness + security + architecture facts (CLI/static + vite build mode). */
+declare function parseComponentFacts(source: string, filename: string): {
+    eachBlocks: EachBlockFact[];
+    effects: EffectFact[];
+    htmlTags: SourceSpan[];
+    javascriptUrls: SourceSpan[];
+    loc: number;
+    propCount: number;
+    imports: string[];
+    namespaceImports: {
+        source: string;
+        line: number;
+    }[];
+    constableStates: {
+        name: string;
+        line: number;
+    }[];
+    suppressions: SuppressionDirective[];
+};
+
+type Node = any;
+/**
+ * All keys that can bear child nodes in a Svelte AST node.
+ * Covers if/each/await blocks (pending/then/catch/fallback) as well as
+ * the standard fragment, nodes, consequent, alternate, and body keys.
+ */
+declare const CHILD_NODE_KEYS: string[];
+/**
+ * Determine a value's kind from a list of child/text nodes (design §4, §11):
+ *   - any ExpressionTag present  → 'dynamic' (e.g. {data.title}); we do NOT
+ *     follow the expression — that would turn this into runtime analysis.
+ *   - non-whitespace Text only   → 'static'
+ *   - empty / whitespace only    → 'absent'
+ */
+declare function valueFromNodes(nodes: Node[]): Value;
+/** The literal text of a node list when fully static (no ExpressionTag), else undefined. */
+declare function textFromNodes(nodes: Node[]): string | undefined;
+/** Static string of an attribute (e.g. name="description"), or undefined if dynamic/absent. */
+declare function attrText(attributes: Node[], name: string): string | undefined;
+/** Value kind of an attribute's content (e.g. the `content` of a <meta>). */
+declare function attrValue(attributes: Node[], name: string): Value;
+declare function lineOf(source: string, offset: unknown): number;
+declare function findAttr(attributes: Node[], name: string): Node | undefined;
+/** Value kind of a single attribute (e.g. a component prop). */
+declare function attrValueOf(attr: Node): Value;
+/** Literal static text of a single attribute node (e.g. a component prop), or undefined if dynamic/absent. */
+declare function attrTextOf(attr: Node): string | undefined;
+
 /**
  * Source-file locations that satisfy the project-scope rules, shared by every
  * mode so the static (CLI) and rendered (plugin) collectors never drift. This
@@ -660,4 +717,4 @@ declare function selectRules(rules: Rule[], config: Config): Rule[];
 /** Apply per-rule severity overrides to results (design §6). */
 declare function applyRuleSeverities(results: Result[], config: Config): Result[];
 
-export { BAND_COLOR, type Category, type Classification, 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 Palette, type Presence, type Project, ROBOTS_SOURCE_PATHS, type ResolvedHead, type ResolvedHeadings, type ResolvedImages, type Result, type Rule, type RuleContext, type RuleInfo, type RuleSetting, type Runtime, SITEMAP_SOURCE_PATHS, type Scope, type ScoreModel, type ScoreOptions, type ScoreResult, type Severity, type SourceSpan, type Summary, type TreatDynamicAs, type Value, allRules, applyRuleSeverities, arch001ComponentSize, arch002PropCount, buildHtmlDocument, buildJsonReport, classify, computeHealth, computeScore, correct001EachKey, correct002EffectDerived, correct003EffectAsOnMount, correct004UnmutatedState, defaultConfig, defaultProject, defineConfig, docsUrlFor, effectiveSeverity, escapeHtml, explainRule, formatAgentReport, formatConsoleReport, formatGithubReport, formatHtmlReport, formatJsonReport, formatSarifReport, hasFailureAtOrAbove, headTagRule, imageRule, isPenalized, linkRule, noColorPalette, perf001ImageDimensions, perf002ImageLoading, perf003PreloadAs, perf004FontPreloadCrossorigin, perf005LcpImage, perf006ResponsiveImage, perf007RenderBlockingScript, perf008Preconnect, perf009HeavyImport, perf010NamespaceImport, runRules, safeHref, scoreBand, scoreColor, scoresByCategory, sec001Html, sec002JavascriptUrl, selectRules, seo001Title, seo002Description, seo003Canonical, seo004OgImage, seo005OgTitle, seo006Robots, seo007Sitemap, seo008JsonLd, seo009HtmlLang, seo010Indexability, seo011TwitterCard, seo012OgDescription, seo013OgUrl, seo014Viewport, seo015SitemapInRobots, seo016JsonLdValidity, seo017DeprecatedType, seo018RelativeUrl, seo019DateFormat, seo020Placeholder, seo021RequiredProps, seo022TitleLength, seo023DescriptionLength, seo024Charset, seo025ImageAlt, seo026Hreflang, seo027Heading, seo028TitleUnique, seo029DescriptionUnique, seo030HeadingOrder, summarize };
+export { BAND_COLOR, CHILD_NODE_KEYS, type Category, type Classification, 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 Palette, type Presence, type Project, ROBOTS_SOURCE_PATHS, type ResolvedHead, type ResolvedHeadings, type ResolvedImages, type Result, type Rule, type RuleContext, type RuleInfo, type RuleSetting, type Runtime, SITEMAP_SOURCE_PATHS, type Scope, type ScoreModel, type ScoreOptions, type ScoreResult, type Severity, type SourceSpan, type Summary, type SuppressionDirective, type TreatDynamicAs, type Value, allRules, applyRuleSeverities, arch001ComponentSize, arch002PropCount, attrText, attrTextOf, attrValue, attrValueOf, buildHtmlDocument, buildJsonReport, classify, computeHealth, computeScore, correct001EachKey, correct002EffectDerived, correct003EffectAsOnMount, correct004UnmutatedState, defaultConfig, defaultProject, defineConfig, docsUrlFor, effectiveSeverity, escapeHtml, explainRule, findAttr, formatAgentReport, formatConsoleReport, formatGithubReport, formatHtmlReport, formatJsonReport, formatSarifReport, hasFailureAtOrAbove, headTagRule, imageRule, isPenalized, lineOf, linkRule, noColorPalette, parseComponentFacts, perf001ImageDimensions, perf002ImageLoading, perf003PreloadAs, perf004FontPreloadCrossorigin, perf005LcpImage, perf006ResponsiveImage, perf007RenderBlockingScript, perf008Preconnect, perf009HeavyImport, perf010NamespaceImport, runRules, safeHref, scoreBand, scoreColor, scoresByCategory, sec001Html, sec002JavascriptUrl, selectRules, seo001Title, seo002Description, seo003Canonical, seo004OgImage, seo005OgTitle, seo006Robots, seo007Sitemap, seo008JsonLd, seo009HtmlLang, seo010Indexability, seo011TwitterCard, seo012OgDescription, seo013OgUrl, seo014Viewport, seo015SitemapInRobots, seo016JsonLdValidity, seo017DeprecatedType, seo018RelativeUrl, seo019DateFormat, seo020Placeholder, seo021RequiredProps, seo022TitleLength, seo023DescriptionLength, seo024Charset, seo025ImageAlt, seo026Hreflang, seo027Heading, seo028TitleUnique, seo029DescriptionUnique, seo030HeadingOrder, summarize, textFromNodes, valueFromNodes };

package/dist/index.js

@@ -14,6 +14,408 @@ function defineConfig(config = {}) {
   return { ...defaultConfig, ...config };
 }
 
+// src/component-parse.ts
+import { parse } from "svelte/compiler";
+
+// src/svelte-ast.ts
+var CHILD_NODE_KEYS = [
+  "fragment",
+  "nodes",
+  "consequent",
+  "alternate",
+  "body",
+  "pending",
+  "then",
+  "catch",
+  "fallback"
+];
+function valueFromNodes(nodes) {
+  if (!Array.isArray(nodes)) return "absent";
+  if (nodes.some((n) => n?.type === "ExpressionTag")) return "dynamic";
+  const text = nodes.filter((n) => n?.type === "Text").map((n) => String(n.data ?? "")).join("");
+  return text.trim().length > 0 ? "static" : "absent";
+}
+function textFromNodes(nodes) {
+  if (!Array.isArray(nodes) || nodes.some((n) => n?.type === "ExpressionTag")) return void 0;
+  const text = nodes.filter((n) => n?.type === "Text").map((n) => String(n.data ?? "")).join("");
+  return text.trim().length > 0 ? text : void 0;
+}
+function attrText(attributes, name) {
+  const attr = findAttr(attributes, name);
+  if (!attr) return void 0;
+  const v = attr.value;
+  if (v === true) return "";
+  if (Array.isArray(v)) {
+    if (v.some((n) => n?.type === "ExpressionTag")) return void 0;
+    return v.filter((n) => n?.type === "Text").map((n) => String(n.data ?? "")).join("");
+  }
+  return void 0;
+}
+function attrValue(attributes, name) {
+  const attr = findAttr(attributes, name);
+  if (!attr) return "absent";
+  const v = attr.value;
+  if (v === true) return "absent";
+  if (Array.isArray(v)) return valueFromNodes(v);
+  if (v && v.type === "ExpressionTag") return "dynamic";
+  return "absent";
+}
+function lineOf(source, offset) {
+  if (typeof offset !== "number" || offset < 0) return 0;
+  let line = 1;
+  const end = Math.min(offset, source.length);
+  for (let i = 0; i < end; i++) if (source[i] === "\n") line++;
+  return line;
+}
+function findAttr(attributes, name) {
+  if (!Array.isArray(attributes)) return void 0;
+  return attributes.find((a) => a?.type === "Attribute" && a.name === name);
+}
+function attrValueOf(attr) {
+  const v = attr?.value;
+  if (v === true) return "absent";
+  if (Array.isArray(v)) return valueFromNodes(v);
+  if (v && v.type === "ExpressionTag") return "dynamic";
+  return "absent";
+}
+function attrTextOf(attr) {
+  const v = attr?.value;
+  if (!Array.isArray(v) || v.some((n) => n?.type === "ExpressionTag")) return void 0;
+  const text = v.filter((n) => n?.type === "Text").map((n) => String(n.data ?? "")).join("");
+  return text.trim().length > 0 ? text : void 0;
+}
+
+// src/component-parse.ts
+function isConstantListEach(node) {
+  const expr = node?.expression;
+  return expr?.type === "ArrayExpression" && Array.isArray(expr.elements) && !expr.elements.some((el) => el?.type === "SpreadElement");
+}
+function collectEachBlocks(node, source, acc) {
+  if (Array.isArray(node)) {
+    for (const child of node) collectEachBlocks(child, source, acc);
+    return;
+  }
+  if (!node || typeof node !== "object") return;
+  if (node.type === "EachBlock" && !isConstantListEach(node)) {
+    acc.push({ hasKey: node.key != null, line: lineOf(source, node.start) });
+  }
+  for (const key of CHILD_NODE_KEYS) {
+    if (key in node) collectEachBlocks(node[key], source, acc);
+  }
+}
+function walkEstree(node, visit) {
+  if (Array.isArray(node)) {
+    for (const child of node) walkEstree(child, visit);
+    return;
+  }
+  if (!node || typeof node !== "object" || typeof node.type !== "string") return;
+  visit(node);
+  for (const key of Object.keys(node)) {
+    if (key === "type" || key === "start" || key === "end" || key === "loc" || key === "range") continue;
+    walkEstree(node[key], visit);
+  }
+}
+function isEffectCall(node) {
+  const c = node?.callee;
+  if (c?.type === "Identifier") return c.name === "$effect";
+  if (c?.type === "MemberExpression" && c.object?.type === "Identifier" && c.object.name === "$effect") {
+    return c.property?.type === "Identifier" && c.property.name === "pre";
+  }
+  return false;
+}
+function isStateDeclaration(node) {
+  const c = node?.callee;
+  if (c?.type === "Identifier") return c.name === "$state";
+  if (c?.type === "MemberExpression" && c.object?.type === "Identifier" && c.object.name === "$state") {
+    return c.property?.type === "Identifier" && (c.property.name === "raw" || c.property.name === "frozen");
+  }
+  return false;
+}
+function bodyOnlyAssignsState(fn, stateNames) {
+  const isStateAssign = (expr) => expr?.type === "AssignmentExpression" && expr.operator === "=" && expr.left?.type === "Identifier" && stateNames.has(expr.left.name);
+  const body = fn?.body;
+  if (!body) return false;
+  if (body.type !== "BlockStatement") return isStateAssign(body);
+  if (body.body.length === 0) return false;
+  return body.body.every((s) => s?.type === "ExpressionStatement" && isStateAssign(s.expression));
+}
+function isDerivedDeclaration(node) {
+  const c = node?.callee;
+  if (c?.type === "Identifier") return c.name === "$derived";
+  if (c?.type === "MemberExpression" && c.object?.type === "Identifier" && c.object.name === "$derived") {
+    return c.property?.type === "Identifier" && c.property.name === "by";
+  }
+  return false;
+}
+function addBoundNames(id, acc) {
+  if (!id) return;
+  switch (id.type) {
+    case "Identifier":
+      acc.add(id.name);
+      break;
+    case "ObjectPattern":
+      for (const p of id.properties ?? []) {
+        if (p?.type === "Property") addBoundNames(p.value, acc);
+        else if (p?.type === "RestElement") addBoundNames(p.argument, acc);
+      }
+      break;
+    case "ArrayPattern":
+      for (const el of id.elements ?? []) addBoundNames(el, acc);
+      break;
+    case "AssignmentPattern":
+      addBoundNames(id.left, acc);
+      break;
+    case "RestElement":
+      addBoundNames(id.argument, acc);
+      break;
+  }
+}
+function rootObjectName(node) {
+  let cur = node;
+  while (cur?.type === "MemberExpression") cur = cur.object;
+  return cur?.type === "Identifier" ? cur.name : void 0;
+}
+function collectStateWrites(root, stateNames, acc) {
+  walkEstree(root, (n) => {
+    if (n?.type === "AssignmentExpression") {
+      if (n.left?.type === "Identifier" && stateNames.has(n.left.name)) acc.add(n.left.name);
+      else if (n.left?.type === "MemberExpression") {
+        const r = rootObjectName(n.left);
+        if (r && stateNames.has(r)) acc.add(r);
+      } else if (n.left?.type === "ObjectPattern" || n.left?.type === "ArrayPattern") {
+        const bound = /* @__PURE__ */ new Set();
+        addBoundNames(n.left, bound);
+        for (const name of bound) if (stateNames.has(name)) acc.add(name);
+      }
+    } else if (n?.type === "UpdateExpression") {
+      const r = rootObjectName(n.argument);
+      if (r && stateNames.has(r)) acc.add(r);
+    } else if (n?.type === "UnaryExpression" && n.operator === "delete") {
+      const r = rootObjectName(n.argument);
+      if (r && stateNames.has(r)) acc.add(r);
+    } else if (n?.type === "CallExpression") {
+      if (n.callee?.type === "MemberExpression") {
+        const r = rootObjectName(n.callee);
+        if (r && stateNames.has(r)) acc.add(r);
+      }
+      for (const a of n.arguments ?? []) {
+        const arg = a?.type === "SpreadElement" ? a.argument : a;
+        const r = rootObjectName(arg);
+        if (r && stateNames.has(r)) acc.add(r);
+      }
+    }
+  });
+}
+var COMPONENT_LIKE_TYPES = /* @__PURE__ */ new Set(["Component", "SvelteComponent", "SvelteSelf"]);
+function collectTemplateEscapes(node, stateNames, acc) {
+  if (Array.isArray(node)) {
+    for (const c of node) collectTemplateEscapes(c, stateNames, acc);
+    return;
+  }
+  if (!node || typeof node !== "object" || typeof node.type !== "string") return;
+  if (Array.isArray(node.attributes)) {
+    for (const attr of node.attributes) {
+      if (attr?.type === "BindDirective") {
+        const r = rootObjectName(attr.expression);
+        if (r && stateNames.has(r)) acc.add(r);
+      } else if (COMPONENT_LIKE_TYPES.has(node.type)) {
+        walkEstree(attr, (m) => {
+          if (m?.type === "Identifier" && stateNames.has(m.name)) acc.add(m.name);
+        });
+      }
+    }
+  }
+  for (const key of CHILD_NODE_KEYS) {
+    if (key in node) collectTemplateEscapes(node[key], stateNames, acc);
+  }
+}
+var RUNE_NAMES = /* @__PURE__ */ new Set(["$state", "$derived", "$effect", "$props", "$bindable", "$inspect", "$host"]);
+function bodyReadsReactive(fn, reactiveNames) {
+  let reads = false;
+  const IGNORED_KEYS = /* @__PURE__ */ new Set(["type", "start", "end", "loc", "range"]);
+  const visit = (n) => {
+    if (reads || !n) return;
+    if (Array.isArray(n)) {
+      for (const c of n) visit(c);
+      return;
+    }
+    if (typeof n !== "object" || typeof n.type !== "string") return;
+    if (n.type === "Identifier") {
+      if (reactiveNames.has(n.name) || n.name.startsWith("$") && !RUNE_NAMES.has(n.name)) reads = true;
+      return;
+    }
+    if (n.type === "CallExpression" && n.callee?.type === "Identifier") {
+      reads = true;
+      return;
+    }
+    if (n.type === "MemberExpression") {
+      visit(n.object);
+      if (n.computed) visit(n.property);
+      return;
+    }
+    if (n.type === "Property") {
+      if (n.computed) visit(n.key);
+      visit(n.value);
+      return;
+    }
+    for (const key of Object.keys(n)) {
+      if (!IGNORED_KEYS.has(key)) visit(n[key]);
+    }
+  };
+  visit(fn.body);
+  return reads;
+}
+function bodyIsEmpty(fn) {
+  const body = fn?.body;
+  if (!body) return true;
+  if (body.type === "BlockStatement") return (body.body ?? []).length === 0;
+  return false;
+}
+var URL_ATTRS = ["href", "src", "action", "formaction"];
+function collectSecurityFacts(node, source, htmlTags, jsUrls) {
+  if (Array.isArray(node)) {
+    for (const child of node) collectSecurityFacts(child, source, htmlTags, jsUrls);
+    return;
+  }
+  if (!node || typeof node !== "object") return;
+  if (node.type === "HtmlTag") htmlTags.push({ line: lineOf(source, node.start) });
+  if ((node.type === "RegularElement" || node.type === "SvelteElement") && Array.isArray(node.attributes)) {
+    for (const name of URL_ATTRS) {
+      const attr = findAttr(node.attributes, name);
+      if (!attr) continue;
+      const value = attrTextOf(attr);
+      if (value !== void 0 && /^\s*javascript:/i.test(value)) {
+        jsUrls.push({ line: lineOf(source, attr.start ?? node.start) });
+      }
+    }
+  }
+  for (const key of CHILD_NODE_KEYS) {
+    if (key in node) collectSecurityFacts(node[key], source, htmlTags, jsUrls);
+  }
+}
+function isPropsCall(node) {
+  return node?.type === "CallExpression" && node.callee?.type === "Identifier" && node.callee.name === "$props";
+}
+function countProps(program) {
+  let count = 0;
+  let seen = 0;
+  let uncountable = false;
+  walkEstree(program, (n) => {
+    if (n.type !== "VariableDeclarator" || !n.init || !isPropsCall(n.init)) return;
+    seen++;
+    const props = n.id?.type === "ObjectPattern" ? n.id.properties : void 0;
+    if (!Array.isArray(props) || props.some((p) => p?.type === "RestElement")) {
+      uncountable = true;
+      return;
+    }
+    count = props.filter((p) => p?.type === "Property").length;
+  });
+  return uncountable || seen > 1 ? 0 : count;
+}
+function countLines(source) {
+  if (source.length === 0) return 0;
+  return source.split("\n").length - (source.endsWith("\n") ? 1 : 0);
+}
+function collectImportSources(program, acc) {
+  walkEstree(program, (n) => {
+    if (n.type === "ImportDeclaration" && typeof n.source?.value === "string") acc.push(n.source.value);
+  });
+}
+function isBareSpecifier(s) {
+  return !/^[./$#]/.test(s);
+}
+function collectNamespaceImports(program, source, acc) {
+  walkEstree(program, (n) => {
+    if (n.type !== "ImportDeclaration" || n.importKind === "type") return;
+    const spec = n.source?.value;
+    if (typeof spec !== "string" || !isBareSpecifier(spec)) return;
+    if (Array.isArray(n.specifiers) && n.specifiers.some((s) => s?.type === "ImportNamespaceSpecifier")) {
+      acc.push({ source: spec, line: lineOf(source, n.start) });
+    }
+  });
+}
+var JS_DIRECTIVE = /^\s*\/\/\s*svelte-vitals-disable-next-line(?:\s+([A-Za-z]+\d+(?:\s*,\s*[A-Za-z]+\d+)*))?\s*$/;
+var HTML_DIRECTIVE = /^\s*<!--\s*svelte-vitals-disable-next-line(?:\s+([A-Za-z]+\d+(?:\s*,\s*[A-Za-z]+\d+)*))?\s*-->\s*$/;
+function collectSuppressions(source) {
+  const out = [];
+  const lines = source.split("\n");
+  lines.forEach((line, i) => {
+    const m = JS_DIRECTIVE.exec(line) ?? HTML_DIRECTIVE.exec(line);
+    if (!m) return;
+    const ruleIds = m[1]?.split(",").map((s) => s.trim().toUpperCase());
+    out.push({ line: i + 2, ruleIds });
+  });
+  return out;
+}
+function parseComponentFacts(source, filename) {
+  const ast = parse(source, { modern: true, filename });
+  const eachBlocks = [];
+  collectEachBlocks(ast.fragment ?? ast, source, eachBlocks);
+  const htmlTags = [];
+  const javascriptUrls = [];
+  collectSecurityFacts(ast.fragment ?? ast, source, htmlTags, javascriptUrls);
+  const loc = countLines(source);
+  const suppressions = collectSuppressions(source);
+  const imports = [];
+  const namespaceImports = [];
+  if (ast.module?.content) {
+    collectImportSources(ast.module.content, imports);
+    collectNamespaceImports(ast.module.content, source, namespaceImports);
+  }
+  const effects = [];
+  const constableStates = [];
+  let propCount = 0;
+  const program = ast.instance?.content;
+  if (program) {
+    collectImportSources(program, imports);
+    collectNamespaceImports(program, source, namespaceImports);
+    propCount = countProps(program);
+    const stateNames = /* @__PURE__ */ new Set();
+    const reactiveNames = /* @__PURE__ */ new Set();
+    const stateDecls = [];
+    walkEstree(program, (n) => {
+      if (n.type !== "VariableDeclarator" || !n.init) return;
+      if (isStateDeclaration(n.init) && n.id?.type === "Identifier") {
+        stateNames.add(n.id.name);
+        stateDecls.push({ name: n.id.name, line: lineOf(source, n.start) });
+      }
+      if (isStateDeclaration(n.init) || isDerivedDeclaration(n.init) || isPropsCall(n.init))
+        addBoundNames(n.id, reactiveNames);
+    });
+    walkEstree(program, (n) => {
+      if (n.type !== "CallExpression" || !isEffectCall(n)) return;
+      const fn = n.arguments?.[0];
+      const isFn = fn?.type === "ArrowFunctionExpression" || fn?.type === "FunctionExpression";
+      effects.push({
+        line: lineOf(source, n.start),
+        assignsOnlyState: isFn ? bodyOnlyAssignsState(fn, stateNames) : false,
+        mountOnly: isFn ? !bodyIsEmpty(fn) && !bodyReadsReactive(fn, reactiveNames) : false
+      });
+    });
+    const writtenOrEscaped = /* @__PURE__ */ new Set();
+    collectStateWrites(program, stateNames, writtenOrEscaped);
+    if (ast.fragment) {
+      collectStateWrites(ast.fragment, stateNames, writtenOrEscaped);
+      collectTemplateEscapes(ast.fragment, stateNames, writtenOrEscaped);
+    }
+    for (const d of stateDecls) {
+      if (!writtenOrEscaped.has(d.name)) constableStates.push(d);
+    }
+  }
+  return {
+    eachBlocks,
+    effects,
+    htmlTags,
+    javascriptUrls,
+    loc,
+    propCount,
+    imports,
+    namespaceImports,
+    constableStates,
+    suppressions
+  };
+}
+
 // src/project-paths.ts
 var ROBOTS_SOURCE_PATHS = [
   "static/robots.txt",
@@ -1438,6 +1840,9 @@ var seo030HeadingOrder = {
 // src/rules/component-rule.ts
 var PENALIZED2 = { presence: "none", value: "absent" };
 var PASS2 = { presence: "own", value: "static" };
+function isSuppressed(c, ruleId, line) {
+  return (c.suppressions ?? []).some((s) => s.line === line && (!s.ruleIds || s.ruleIds.includes(ruleId)));
+}
 function componentRule(opts) {
   const docsUrl7 = docsUrlFor(opts.id);
   const severity = opts.severity ?? "warning";
@@ -1452,7 +1857,7 @@ function componentRule(opts) {
       const out = [];
       for (const c of ctx.components ?? []) {
         if (!opts.applies(c)) continue;
-        const bad = opts.bad(c);
+        const bad = opts.bad(c).filter((b) => !(b.line > 0 && isSuppressed(c, opts.id, b.line)));
         if (bad.length === 0) {
           out.push({
             id: opts.id,
@@ -2292,12 +2697,17 @@ function applyRuleSeverities(results, config) {
 }
 export {
   BAND_COLOR,
+  CHILD_NODE_KEYS,
   ROBOTS_SOURCE_PATHS,
   SITEMAP_SOURCE_PATHS,
   allRules,
   applyRuleSeverities,
   arch001ComponentSize,
   arch002PropCount,
+  attrText,
+  attrTextOf,
+  attrValue,
+  attrValueOf,
   buildHtmlDocument,
   buildJsonReport,
   classify,
@@ -2314,6 +2724,7 @@ export {
   effectiveSeverity,
   escapeHtml,
   explainRule,
+  findAttr,
   formatAgentReport,
   formatConsoleReport,
   formatGithubReport,
@@ -2324,8 +2735,10 @@ export {
   headTagRule,
   imageRule,
   isPenalized,
+  lineOf,
   linkRule,
   noColorPalette,
+  parseComponentFacts,
   perf001ImageDimensions,
   perf002ImageLoading,
   perf003PreloadAs,
@@ -2374,5 +2787,7 @@ export {
   seo028TitleUnique,
   seo029DescriptionUnique,
   seo030HeadingOrder,
-  summarize
+  summarize,
+  textFromNodes,
+  valueFromNodes
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@svelte-vitals/core",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "Shared, runtime-agnostic core for svelte-vitals (types, rule engine, scorer, reporter).",
   "type": "module",
   "license": "MIT",
@@ -24,6 +24,9 @@
     "node": ">=18.20.8"
   },
   "sideEffects": false,
+  "dependencies": {
+    "svelte": "^5.56.4"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",