@svelte-vitals/core 0.55.2 → 0.55.3

package/dist/{json-BQf9Qb2D.d.ts → json-DmLgFEwV.d.ts}

@@ -430,6 +430,10 @@ interface HeadTag {
   /** Source file the tag came from (static mode); unset on a rendered head. */
   file?: string;
 }
+/** Whether a `<link>`'s `rel` holds `token`: `rel` is a set of space-separated keywords (`dns-prefetch preconnect`). */
+declare function hasRel(tag: {
+  rel?: string;
+}, token: string): boolean;
 /** Resolved effective head for a single route (design §8). */
 interface ResolvedHead {
   /** Route path, e.g. '/blog/[slug]'. */
@@ -529,6 +533,8 @@ interface Project {
     value?: string;
     file: string;
   };
+  /** `kit.router.type: 'hash'` in `svelte.config.{js,ts}`: SvelteKit then never server-renders or prerenders a page. */
+  kitHashRouter?: true;
   /**
    * The project's compiled SvelteKit alias entries, in Kit's own order (`$lib` first), read from
    * `svelte.config.{js,ts}`. Absent means no config was read — resolution then falls back to
@@ -566,6 +572,8 @@ interface Project {
    * `<link rel="canonical">`, rendered on every route beside `%sveltekit.head%` (static mode).
    */
   appHtmlHeadTags?: Omit<HeadTag, 'presence' | 'file'>[];
+  /** HTML comments inside the shell's `<head>` (`<!--seo-head-->`), which a `transformPageChunk` hook may replace with tags. */
+  appHtmlHeadComments?: string[];
 }
 declare const defaultProject: Project;
 /** A concrete, agent-actionable remediation for a finding (design §10, issue #18). */
@@ -738,6 +746,10 @@ interface BranchStep {
   group: number;
   /** branch index within the group (if: 0..n consequent→else; await: 0=pending,1=then,2=catch) */
   branch: number;
+  /** A heading renders here whichever arm is taken: every arm of the block has one, a prop the use passes decides the arm, or the place's own conditions select it. */
+  always?: true;
+  /** The body of an `{#each}` (headings only): it may render any number of times, or none. */
+  repeat?: true;
 }
 /** Where a folded occurrence sits, for the finding location. */
 interface A11yOccurrenceInfo {
@@ -889,7 +901,7 @@ declare function stripTextDirective(fragment: string): string;
  * so seo/single-h1 never needs to know which mode produced them.
  */
 interface HeadingInfo {
-  /** Heading level 1–6 (the `n` in <hn>). */
+  /** Heading level: 1–6 (the `n` in <hn>), an ARIA heading's `aria-level`, or 0 when the source does not determine it (source mode). */
   level: number;
   /** 1-based source line, or 0 if unknown (rendered mode does not track lines). */
   line: number;
@@ -901,6 +913,15 @@ interface HeadingInfo {
    * above it. Group numbers are route-wide: each file instance has its own range.
    */
   path?: BranchStep[];
+  /**
+   * Its place in document order (source mode): the source offset of each placement from the route's
+   * outermost file down — a layout's `{@render children()}`, a component's tag, a snippet's
+   * `{@render}` — and last its own. Compared element by element (`documentOrder`); rendered-mode
+   * headings carry none and arrive in order.
+   */
+  order?: number[];
+  /** A `role="heading"` element: it holds its outline level for seo/heading-level-skip, but is not an `<h1>` for seo/single-h1. */
+  aria?: true;
 }
 /** Resolved page-body headings for a single route (page + layout chain). */
 interface ResolvedHeadings {
@@ -908,9 +929,8 @@ interface ResolvedHeadings {
   headings: HeadingInfo[];
   /**
    * Headings found in child components rendered (transitively) by this route's
-   * chain files — source mode only; absent in rendered mode. Kept separate from
-   * `headings` because their position in document order is unknown: safe for
-   * counting (seo/single-h1), unusable for outline order (seo/heading-level-skip).
+   * chain files — source mode only; absent in rendered mode. Their `order` places
+   * them among `headings`.
    */
   componentHeadings?: HeadingInfo[];
   /**
@@ -965,6 +985,13 @@ interface KitModuleFacts {
     resolved: string;
     line: number;
   }[];
+  /** The targets of the `.set()`/`.update()` writes recorded in `importedStateWrites` from a handler, for the collector to drop those that reach a persistence client. */
+  storeWriteTargets?: {
+    name: string;
+    imported: string;
+    resolved: string;
+    line: number;
+  }[];
   /** Value imports whose specifier resolves to a repo-local `.svelte.ts`/`.svelte.js` runes module (security/shared-state-import). */
   runesModuleImports: {
     source: string;
@@ -978,7 +1005,7 @@ interface KitModuleFacts {
     line: number;
     inHandler: boolean;
   }[];
-  /** Browser-global reads in server-executed positions — top level, handler bodies, the `init` hook (correctness/server-browser-global). Empty when the file itself exports `ssr = false`. */
+  /** Browser-global reads in server-executed positions — top level, handler bodies, the `init` hook (correctness/server-browser-global). Empty when the file itself exports a literal `ssr = false`. */
   browserGlobalRefs: {
     name: string;
     line: number;
@@ -986,18 +1013,46 @@ interface KitModuleFacts {
   }[];
   /** Root-relative `redirect()` literals in this Kit module (correctness/base-path-navigation). */
   basePathLinks: BasePathLinkFact[];
-  /** Set when this file disables SSR via `export const ssr = false` (inline or same-file alias export) — the declaration's line (seo/ssr-disabled). */
+  /** Set when this file disables SSR via `export const ssr = false` or `= dev` (inline or same-file alias export) — the declaration's line (seo/ssr-disabled). */
   ssrDisabled?: {
     line: number;
   };
   /** Set when this file exports `ssr` as anything but a literal `false` (`true`, a computed value, a re-export) — it may turn SSR back on under a layout's `ssr = false` (see `appSsrDisabled`, `routeNeverSsr`). */
   ssrEnabled?: true;
+  /** Set when this file exports `ssr` as the literal `true` (inline or same-file alias export); implies `ssrEnabled`. */
+  ssrTrue?: true;
   /** Set when this file disables client-side rendering via `export const csr = false` (inline or same-file alias export). With no client runtime, a universal load only runs during SSR — performance/load-waterfall's browser-waterfall premise doesn't hold. */
   csrDisabled?: {
     line: number;
   };
+  /** Set when this file exports `csr` as anything but `false` — it may turn CSR back on under a layout's `csr = false` (see `universalNeverCsr`). */
+  csrEnabled?: true;
   /** Set when the exported `load` redirects or throws `error()` on every call — every path through its body reaches a `redirect()`/`error()` before any `return`, directly or through a same-file top-level function that always does (see `loadNeverRenders` in kit-module-parse.ts). A `+page` module carrying it means the route never renders its own page. */
   loadNeverRenders?: true;
+  /** Set when the exported `load` redirects or errors on every call once `if (building)` (from `$app/environment`) is read false, as on every request; the page renders only if its route is prerendered (see `prerenderExported`). */
+  loadNeverRendersOutsideBuild?: true;
+  /** The module exports `prerender`, in any form. */
+  prerenderExported?: true;
+  /** The request paths the exported `handle` of a hooks file answers before calling `resolve` (see `handleAnsweredPaths` in kit-module-parse.ts): a route they cover never renders. */
+  answeredPaths?: {
+    op: 'eq' | 'starts';
+    v: string;
+  }[];
+  /** The string literals a `transformPageChunk` the exported `handle` passes to `resolve` replaces in the page HTML (`html.replace('<!--seo-head-->', …)`). */
+  pageChunkTokens?: string[];
+  /** The imported flag a load's leading guard reads (`if (!FLAG) redirect(…)`): `collectKitModuleFacts` sets `loadNeverRenders` when that export is the literal `false`. */
+  pendingFlagGuard?: {
+    resolved: string;
+    name: string;
+    member?: string;
+  };
+  /** The imported factory `export const load = factory(…)` calls: `collectKitModuleFacts` sets `loadNeverRenders` when the function it returns redirects or errors on every call. */
+  pendingLoadFactory?: {
+    resolved: string;
+    name: string;
+  };
+  /** Set when the exported `load` sends a request without a session away before rendering (see `loadGatesOnLocals` in kit-module-parse.ts); every route under a `+layout` carrying it is behind a login. */
+  loadGated?: true;
   /** Sequential-await analysis of the exported `load` function (performance/load-waterfall, performance/sequential-awaits): 1-based lines of await sites that depend on an earlier await's result, and of sites independent of all earlier awaits. Set only when at least one list is non-empty. */
   loadWaterfalls?: {
     dependentLines: number[];
@@ -1011,7 +1066,22 @@ interface KitModuleFacts {
   readFailed?: true;
 }
 /** The rule-context fields the per-route SSR resolution reads. */
-type SsrScope = Pick<RuleContext, 'kitModules' | 'components' | 'sourceFiles'>;
+type SsrScope = Pick<RuleContext, 'kitModules' | 'components' | 'sourceFiles'> & {
+  project?: Pick<Project, 'kitHashRouter'>;
+};
+/**
+ * Whether a `+page` file's route never renders because a layout above it redirects or errors in its
+ * `load` on every call (`loadNeverRenders`). Not the root layout: one that sent every request away
+ * would leave the app nothing to serve, so that reading is more likely wrong than the app, and acting
+ * on it would silence every route.
+ */
+declare function layoutNeverRenders(file: string, scope: SsrScope): boolean;
+/**
+ * Whether a `+page` file's route never renders because its own `load` redirects or errors on every
+ * request, a build-time `if (building)` aside (`loadNeverRendersOutsideBuild`), and nothing on its chain
+ * exports `prerender`, so the build never renders it either.
+ */
+declare function pageRendersOnlyWhenBuilding(file: string, scope: SsrScope): boolean;
 /** Whether a `+page`/`+layout` file (module or component) belongs to a route that is never server-rendered. */
 declare function routeNeverSsr(file: string, scope: SsrScope): boolean;
 //#endregion
@@ -1343,8 +1413,13 @@ declare function buildJsonReport(results: Result[], config: Config, meta: {
   version: string;
 }, ruleIds?: readonly string[], examined?: Record<string, Record<string, number>>, skipped?: JsonReport['skipped']): JsonReport;
 /** Render results as the documented JSON report string (design §7). */
-declare function formatJsonReport(results: Result[], config: Config, meta: {
+declare function formatJsonReport(...args: Parameters<typeof formatJsonReportChunks>): string;
+/**
+ * `formatJsonReport`'s text in pieces, one route at a time: a large prerendered site's report is
+ * longer than the longest string V8 can hold.
+ */
+declare function formatJsonReportChunks(results: Result[], config: Config, meta: {
   version: string;
-}, ruleIds?: readonly string[], examined?: Record<string, Record<string, number>>, skipped?: JsonReport['skipped']): string;
+}, ruleIds?: readonly string[], examined?: Record<string, Record<string, number>>, skipped?: JsonReport['skipped']): Generator<string>;
 //#endregion
-export { formatGithubReport as $, routeNeverSsr as A, EachBlockFact as At, NAMING_ATTRS as B, compileOverrides as C, defaultConfig as Ct, withFailedRulesOff as D, ResolvedHead as Dt, settingSeverity as E, HeadTag as Et, ANCESTRY_DEPENDENT_TAGS as F, collectComponentFacts as Ft, isTopFragment as G, SECTIONING_TAGS as H, ASIDE_DEMOTING_TAGS as I, emptyComponentFacts as It, stripTextDirective as J, resolveLandmark as K, BranchStep as L, skippedFileWarnings as Lt, ResolvedHeadings as M, OrphanEffectFact as Mt, A11yOccurrenceInfo as N, SourceSpan as Nt, withIndexableOff as O, isClassicScriptType as Ot, A11ySkipCause as P, SuppressionDirective as Pt, formatMarkdownReport as Q, IDREF_ATTRS as R, Runtime as Rt, SEARCH_RESULT_RULES as S, Value as St, selectRules as T, defineConfig as Tt, decodeFragmentId as U, ResolvedA11y as V, foldOccurrences as W, ResolvedImages as X, ImageInfo as Y, isSvgSrc as Z, isPlainObject as _, RuleSetting as _t, HealthResult as a, summarize as at, validateRuleSetting as b, Severity as bt, ScoreResult as c, Config as ct, Rule as d, KitAlias as dt, Classification as et, RuleContext as f, Presence as ft, RuleOptionsSpec as g, RuleOverride as gt, RuleOptionSpec as h, RuleOptions as ht, formatJsonReport as i, hasFailureAtOrAbove as it, HeadingInfo as j, EffectFact as jt, KitModuleFacts as k, ComponentFacts as kt, computeHealth as l, Detection as lt, isPenalized as m, Result as mt, RuleEvidence as n, classify as nt, ScoreModel as o, CATEGORIES as ot, docsUrlFor as p, Project as pt, splitTokens as q, buildJsonReport as r, effectiveSeverity as rt, ScoreOptions as s, Category as st, JsonReport as t, Summary as tt, computeScore as u, Fix as ut, resolveRuleOptions as v, RuleSettingObject as vt, formatFailedRuleWarning as w, defaultProject as wt, CompiledOverride as x, TreatDynamicAs as xt, shouldSkipRangeCheck as y, Scope as yt, LandmarkInput as z, withReadLimit as zt };
+export { ResolvedImages as $, KitModuleFacts as A, ResolvedHead as At, BranchStep as B, emptyComponentFacts as Bt, SEARCH_RESULT_RULES as C, Severity as Ct, settingSeverity as D, defaultProject as Dt, selectRules as E, defaultConfig as Et, ResolvedHeadings as F, EffectFact as Ft, SECTIONING_TAGS as G, LandmarkInput as H, Runtime as Ht, A11yOccurrenceInfo as I, OrphanEffectFact as It, isTopFragment as J, decodeFragmentId as K, A11ySkipCause as L, SourceSpan as Lt, pageRendersOnlyWhenBuilding as M, isClassicScriptType as Mt, routeNeverSsr as N, ComponentFacts as Nt, withFailedRulesOff as O, defineConfig as Ot, HeadingInfo as P, EachBlockFact as Pt, ImageInfo as Q, ANCESTRY_DEPENDENT_TAGS as R, SuppressionDirective as Rt, CompiledOverride as S, Scope as St, formatFailedRuleWarning as T, Value as Tt, NAMING_ATTRS as U, withReadLimit as Ut, IDREF_ATTRS as V, skippedFileWarnings as Vt, ResolvedA11y as W, splitTokens as X, resolveLandmark as Y, stripTextDirective as Z, RuleOptionsSpec as _, Result as _t, formatJsonReportChunks as a, classify as at, shouldSkipRangeCheck as b, RuleSetting as bt, ScoreOptions as c, summarize as ct, computeScore as d, Config as dt, isSvgSrc as et, Rule as f, Detection as ft, RuleOptionSpec as g, Project as gt, isPenalized as h, Presence as ht, formatJsonReport as i, Summary as it, layoutNeverRenders as j, hasRel as jt, withIndexableOff as k, HeadTag as kt, ScoreResult as l, CATEGORIES as lt, docsUrlFor as m, KitAlias as mt, RuleEvidence as n, formatGithubReport as nt, HealthResult as o, effectiveSeverity as ot, RuleContext as p, Fix as pt, foldOccurrences as q, buildJsonReport as r, Classification as rt, ScoreModel as s, hasFailureAtOrAbove as st, JsonReport as t, formatMarkdownReport as tt, computeHealth as u, Category as ut, isPlainObject as v, RuleOptions as vt, compileOverrides as w, TreatDynamicAs as wt, validateRuleSetting as x, RuleSettingObject as xt, resolveRuleOptions as y, RuleOverride as yt, ASIDE_DEMOTING_TAGS as z, collectComponentFacts as zt };