@svelte-vitals/core 0.55.2 → 0.55.4

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

@@ -1,4 +1,3 @@
-//#region src/runtime.d.ts
 /**
  * Runtime abstraction (design §8). Core defines only the interface; concrete
  * adapters (Node / Deno / Bun) live in the CLI package and are the only place
@@ -36,8 +35,6 @@ interface Runtime {
  * deliberately not a dependency, and pure enough to live in core.
  */
 declare function withReadLimit(readFile: (path: string) => Promise<string>, limit?: number): (path: string) => Promise<string>;
-//#endregion
-//#region src/component.d.ts
 /** An `{#each}` block in a component template. */
 interface EachBlockFact {
   /** True when the block has a key, e.g. `{#each items as item (item.id)}`. */
@@ -181,7 +178,7 @@ interface AriaElementFact {
   /** Set when the element also carries a spread attribute — its full attribute set is
    *  unknowable, so required-prop presence checks must treat it as satisfied (a11y/required-aria-props). */
   hasSpread?: true;
-  /** Set when the element carries a `use:` action, which may set `role` at runtime (svelte-dnd-action's handles do). */
+  /** Set when the element carries a `use:` action or is an item of a svelte-dnd-action zone — either may set `role` at runtime. */
   hasAction?: true;
 }
 /**
@@ -387,8 +384,6 @@ declare function emptyComponentFacts(file: string): ComponentFacts;
  * must never throw).
  */
 declare function collectComponentFacts(rt: Runtime, cwd: string): Promise<ComponentFacts[]>;
-//#endregion
-//#region src/head.d.ts
 /**
  * A normalized head tag. The mode-independent boundary (design §8): the static
  * SourceHeadProvider (CLI, via the runtime-abstracted `HeadProvider` below) and
@@ -430,6 +425,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]'. */
@@ -448,8 +447,6 @@ interface ResolvedHead {
  * so a whitespace-only `type` is a data block, not a classic script.
  */
 declare function isClassicScriptType(type: string | undefined): boolean;
-//#endregion
-//#region src/types.d.ts
 type Severity = 'critical' | 'warning' | 'info';
 /** Where a head tag is set, relative to the route being evaluated (design §4). */
 type Presence = 'own' | 'inherited' | 'none';
@@ -529,6 +526,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 +565,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). */
@@ -662,8 +663,6 @@ interface Config {
 declare const defaultConfig: Config;
 /** Merge user config over defaults. Identity helper for config files (design §6). */
 declare function defineConfig(config?: Partial<Config>): Config;
-//#endregion
-//#region src/summary.d.ts
 interface Summary {
   critical: number;
   warning: number;
@@ -681,15 +680,11 @@ declare function effectiveSeverity(result: Result, config: Config): Severity;
 declare function summarize(results: Result[], config: Config): Summary;
 /** Whether the run should fail the build/CI per the minimum failing severity. */
 declare function hasFailureAtOrAbove(summary: Summary, min: Severity): boolean;
-//#endregion
-//#region src/reporter/github.d.ts
 /**
  * Render penalized findings as GitHub Actions workflow commands (issue #18, design slice 5).
  * GitHub turns these into inline PR annotations and run-annotation entries. Returns '' when clean.
  */
 declare function formatGithubReport(results: Result[], config: Config): string;
-//#endregion
-//#region src/reporter/markdown.d.ts
 /**
  * Render a compact Markdown summary — Health score, per-category table, severity counts, and
  * a findings table — suitable for a GitHub Actions job summary or a sticky PR comment
@@ -699,8 +694,6 @@ declare function formatGithubReport(results: Result[], config: Config): string;
 declare function formatMarkdownReport(results: Result[], config: Config, meta: {
   version: string;
 }): string;
-//#endregion
-//#region src/images.d.ts
 /**
  * A normalized <img> occurrence — the mode-independent boundary for Performance
  * rules (mirrors head.ts). Attribute presence only: a dynamically-bound attribute
@@ -718,6 +711,8 @@ interface ImageInfo {
   hasSrcset: boolean;
   /** True when the <img>'s src is known to be an SVG (`isSvgSrc`; performance/responsive-image). */
   svg?: boolean;
+  /** True when the <img>'s src is a binding named for a QR code (`qrDataUrl`, `setup.qrCode`): drawn at one fixed size (performance/responsive-image). */
+  qr?: boolean;
   /** 1-based source line, or 0 if unknown. */
   line: number;
   /** Source file the <img> came from. */
@@ -730,14 +725,16 @@ interface ResolvedImages {
   route: string;
   images: ImageInfo[];
 }
-//#endregion
-//#region src/a11y.d.ts
 /** One step of a template branch address: which exclusive block, and which arm of it. */
 interface BranchStep {
   /** index of the {#if}/{#await} block among its file's blocks (document order) */
   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 {
@@ -881,15 +878,13 @@ declare function isTopFragment(id: string): boolean;
  * nothing. Returns an empty string when the fragment is a directive and nothing else.
  */
 declare function stripTextDirective(fragment: string): string;
-//#endregion
-//#region src/headings.d.ts
 /**
  * A normalized page-body heading occurrence — the mode-independent boundary for
  * the heading-hierarchy rule (mirrors images.ts). Both providers collect these
  * 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 +896,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 +912,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[];
   /**
@@ -923,8 +926,6 @@ interface ResolvedHeadings {
   /** `dynamicHeading`, but from a component loaded with `import()` — source-mode collection folds it in only on routes never server-rendered. */
   clientOnlyHeading?: boolean;
 }
-//#endregion
-//#region src/kit-module.d.ts
 /**
  * Facts parsed from one SvelteKit route/hooks file for the SSR shared-state rules
  * (the security kit-module rules). Collected by `collectKitModuleFacts` (static/CLI + vite build mode).
@@ -965,6 +966,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 +986,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 +994,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,11 +1047,24 @@ 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
-//#region src/config-apply.d.ts
 /** The severity a setting selects: `'off'`, an explicit severity, or undefined (leave the built-in). */
 declare function settingSeverity(setting: RuleSetting | undefined): Severity | 'off' | undefined;
 /** Drop rules disabled via config (design §6), including a `defaultOff` rule with no entry. */
@@ -1059,8 +1108,6 @@ interface CompiledOverride {
  * targets (every component, every route) must hoist this out of their loop.
  */
 declare function compileOverrides(config: Config): CompiledOverride[];
-//#endregion
-//#region src/rule-options.d.ts
 /**
  * One configurable option. `kind` decides the merge semantics, so no rule
  * writes merge code of its own: `integer` replaces, and the two collection
@@ -1138,8 +1185,6 @@ declare function validateRuleSetting(label: string, ruleId: string, setting: unk
   baseline?: RuleOptions;
   skipRangeCheck?: boolean;
 }): string[];
-//#endregion
-//#region src/rule.d.ts
 /** Input given to every rule. Mode-independent: rules see only ResolvedHead[] (design §8, §10). */
 interface RuleContext {
   heads: ResolvedHead[];
@@ -1217,8 +1262,6 @@ declare function docsUrlFor(id: string): string;
  *   otherwise (static/inherited) → not penalized
  */
 declare function isPenalized(detection: Detection, treatDynamicAs: TreatDynamicAs): boolean;
-//#endregion
-//#region src/scoring/score.d.ts
 interface ScoreModel {
   routeAverage: number;
   sitePenalty: number;
@@ -1261,8 +1304,6 @@ interface HealthResult {
 }
 /** Combined weighted Health score over the categories present in `results` (#10). */
 declare function computeHealth(results: Result[], config: Config): HealthResult;
-//#endregion
-//#region src/reporter/json.d.ts
 declare function issueOf(result: Result): {
   fix?: Fix | undefined;
   docsUrl?: string | undefined;
@@ -1343,8 +1384,12 @@ 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;
-//#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 };
+}, ruleIds?: readonly string[], examined?: Record<string, Record<string, number>>, skipped?: JsonReport['skipped']): Generator<string>;
+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 };