@svelte-vitals/core 0.11.0 → 0.12.0

package/dist/index.d.ts

@@ -105,6 +105,12 @@ interface HeadTag {
     property?: string;
     /** <link rel="...">. */
     rel?: string;
+    /** <link as="..."> keyword (e.g. 'font') when statically literal; undefined when absent or dynamically bound. */
+    as?: string;
+    /** True when a <link> has an `as` attribute at all (literal or dynamic). Distinguishes "no as" from "dynamic as". */
+    hasAs?: boolean;
+    /** True when a <link> has a `crossorigin` attribute (presence only; value is irrelevant to the checks). */
+    hasCrossorigin?: boolean;
     /** Where this tag was set relative to the route. Never 'none' (absence = no tag). */
     presence: Exclude<Presence, 'none'>;
     /** Whether the tag's value is static/dynamic/absent (design §4). */
@@ -229,6 +235,9 @@ declare const seo009HtmlLang: Rule;
 declare const perf001ImageDimensions: Rule;
 declare const perf002ImageLoading: Rule;
 
+declare const perf003PreloadAs: Rule;
+declare const perf004FontPreloadCrossorigin: Rule;
+
 declare const allRules: Rule[];
 
 interface RuleInfo {
@@ -275,6 +284,23 @@ interface ImageRuleOptions {
 /** Build a route-scoped Performance rule that checks each <img> against `ok` (issue #10). */
 declare function imageRule(opts: ImageRuleOptions): Rule;
 
+interface LinkRuleOptions {
+    id: string;
+    title: string;
+    severity: Severity;
+    /** Noun phrase for messages, e.g. '`as` on a preloaded `<link>`'. */
+    label: string;
+    recommendation: string;
+    rationale: string;
+    fix?: Fix;
+    /** Which link tags this rule evaluates (e.g. rel === 'preload'). */
+    relevant: (tag: HeadTag) => boolean;
+    /** Returns true when a relevant link satisfies the rule (passes). */
+    ok: (tag: HeadTag) => boolean;
+}
+/** Build a route-scoped Performance rule that checks each relevant <link> in the effective head. */
+declare function linkRule(opts: LinkRuleOptions): Rule;
+
 interface Summary {
     critical: number;
     warning: number;
@@ -411,4 +437,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 Config, type ConsoleReportOptions, type Detection, type Fix, type HeadProvider, type HeadTag, type HealthResult, type ImageInfo, type JsonReport, type Presence, type Project, ROBOTS_SOURCE_PATHS, type ResolvedHead, 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 Summary, type TreatDynamicAs, type Value, allRules, applyRuleSeverities, buildHtmlDocument, buildJsonReport, classify, computeHealth, computeScore, defaultConfig, defaultProject, defineConfig, docsUrlFor, effectiveSeverity, escapeHtml, explainRule, formatAgentReport, formatConsoleReport, formatGithubReport, formatHtmlReport, formatJsonReport, formatSarifReport, hasFailureAtOrAbove, headTagRule, imageRule, isPenalized, perf001ImageDimensions, perf002ImageLoading, runRules, safeHref, scoreBand, scoresByCategory, selectRules, seo001Title, seo002Description, seo003Canonical, seo004OgImage, seo005OgTitle, seo006Robots, seo007Sitemap, seo008JsonLd, seo009HtmlLang, summarize };
+export { BAND_COLOR, type Category, type Classification, type Config, type ConsoleReportOptions, type Detection, type Fix, type HeadProvider, type HeadTag, type HealthResult, type ImageInfo, type JsonReport, type Presence, type Project, ROBOTS_SOURCE_PATHS, type ResolvedHead, 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 Summary, type TreatDynamicAs, type Value, allRules, applyRuleSeverities, buildHtmlDocument, buildJsonReport, classify, computeHealth, computeScore, defaultConfig, defaultProject, defineConfig, docsUrlFor, effectiveSeverity, escapeHtml, explainRule, formatAgentReport, formatConsoleReport, formatGithubReport, formatHtmlReport, formatJsonReport, formatSarifReport, hasFailureAtOrAbove, headTagRule, imageRule, isPenalized, linkRule, perf001ImageDimensions, perf002ImageLoading, perf003PreloadAs, perf004FontPreloadCrossorigin, runRules, safeHref, scoreBand, scoresByCategory, selectRules, seo001Title, seo002Description, seo003Canonical, seo004OgImage, seo005OgTitle, seo006Robots, seo007Sitemap, seo008JsonLd, seo009HtmlLang, summarize };

package/dist/index.js

@@ -373,6 +373,91 @@ var perf002ImageLoading = imageRule({
   ok: (img) => img.hasLoading
 });
 
+// src/rules/perf/link-rule.ts
+function linkRule(opts) {
+  const docsUrl = docsUrlFor(opts.id);
+  return {
+    id: opts.id,
+    title: opts.title,
+    category: "performance",
+    severity: opts.severity,
+    scope: "route",
+    rationale: opts.rationale,
+    ...opts.fix ? { fix: opts.fix } : {},
+    async check(ctx) {
+      const out = [];
+      for (const head of ctx.heads) {
+        const links = head.tags.filter((t) => t.kind === "link" && opts.relevant(t));
+        if (links.length === 0) continue;
+        const bad = links.filter((t) => !opts.ok(t));
+        if (bad.length === 0) {
+          out.push({
+            id: opts.id,
+            category: "performance",
+            severity: opts.severity,
+            detection: { presence: "own", value: "static" },
+            route: head.route,
+            message: opts.label,
+            recommendation: opts.recommendation,
+            docsUrl
+          });
+          continue;
+        }
+        for (const tag of bad) {
+          out.push({
+            id: opts.id,
+            category: "performance",
+            severity: opts.severity,
+            detection: { presence: "none", value: "absent" },
+            route: head.route,
+            // Point at the file the link actually came from (a layout in static
+            // mode); fall back to the route's representative file when the tag
+            // carries no file (rendered mode).
+            location: tag.file ?? head.file,
+            message: `Missing ${opts.label}`,
+            recommendation: opts.recommendation,
+            docsUrl,
+            ...opts.fix ? { fix: { ...opts.fix } } : {}
+          });
+        }
+      }
+      return out;
+    }
+  };
+}
+
+// src/rules/perf/resource-hints.ts
+var perf003PreloadAs = linkRule({
+  id: "PERF003",
+  title: "Preload missing as",
+  severity: "warning",
+  label: "`as` on a preloaded `<link>`",
+  recommendation: 'Add an `as` attribute to every `<link rel="preload">` so the browser knows the resource type and can prioritize it.',
+  rationale: 'A `<link rel="preload">` without an `as` attribute is ignored by the browser (or fetched a second time), wasting the preload.',
+  fix: {
+    description: "Add an `as` attribute matching the resource type to the preload link.",
+    snippet: '<link rel="preload" href="/app.css" as="style" />',
+    lang: "html"
+  },
+  relevant: (t) => t.rel === "preload",
+  ok: (t) => t.hasAs === true
+});
+var perf004FontPreloadCrossorigin = linkRule({
+  id: "PERF004",
+  title: "Font preload missing crossorigin",
+  severity: "warning",
+  label: "`crossorigin` on a font preload",
+  recommendation: 'Add `crossorigin` to `<link rel="preload" as="font">` \u2014 fonts are fetched in CORS mode, so without it the preload fetches a second, unused copy.',
+  rationale: "A font preload without `crossorigin` does not match the actual (CORS) font request, so the preloaded file is never used and the font downloads twice.",
+  fix: {
+    description: "Add the `crossorigin` attribute to the font preload link.",
+    snippet: '<link rel="preload" href="/inter.woff2" as="font" type="font/woff2" crossorigin />',
+    lang: "html"
+  },
+  relevant: (t) => t.rel === "preload" && t.as === "font",
+  ok: (t) => t.hasCrossorigin === true
+});
+
 // src/rules/index.ts
 var allRules = [
   seo001Title,
@@ -385,7 +470,9 @@ var allRules = [
   seo008JsonLd,
   seo009HtmlLang,
   perf001ImageDimensions,
-  perf002ImageLoading
+  perf002ImageLoading,
+  perf003PreloadAs,
+  perf004FontPreloadCrossorigin
 ];
 function explainRule(id) {
   const target = id.toUpperCase();
@@ -993,8 +1080,11 @@ export {
   headTagRule,
   imageRule,
   isPenalized,
+  linkRule,
   perf001ImageDimensions,
   perf002ImageLoading,
+  perf003PreloadAs,
+  perf004FontPreloadCrossorigin,
   runRules,
   safeHref,
   scoreBand,

package/package.json

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