@rivi-software/agentic-seo-check 0.1.0 → 0.2.0

package/dist/core/types.d.ts

@@ -2,10 +2,10 @@
  * Shared types for the SEO audit core. These shapes are the public contract
  * of the CLI JSON output and the MCP tool results (`schemaVersion: 1`).
  */
-export type Severity = 'error' | 'warning' | 'info';
+export type Severity = "error" | "warning" | "info";
 export declare const SEVERITY_RANK: Record<Severity, number>;
-export type Category = 'title' | 'meta' | 'headings' | 'canonical' | 'indexing' | 'document' | 'social' | 'images' | 'links' | 'international' | 'structured-data' | 'content' | 'keyword' | 'response' | 'rendering' | 'performance' | 'site' | 'tool';
-export type Requirement = 'render' | 'lighthouse' | 'crawl' | 'keyword';
+export type Category = "title" | "meta" | "headings" | "canonical" | "indexing" | "document" | "social" | "images" | "links" | "international" | "structured-data" | "content" | "keyword" | "response" | "rendering" | "performance" | "site" | "aeo" | "tool";
+export type Requirement = "render" | "lighthouse" | "crawl" | "keyword" | "ai-bots";
 /** Static description of a rule, exposed through `seo_list_rules` / `agentic-seo-check rules`. */
 export interface RuleMeta {
     id: string;
@@ -68,16 +68,51 @@ export interface HreflangInfo {
     url: string | null;
 }
 export interface StructuredDataItem {
-    source: 'json-ld' | 'microdata';
+    source: "json-ld" | "microdata";
     types: string[];
     context: string | null;
     data: Record<string, unknown>;
 }
 export interface StructuredDataError {
-    source: 'json-ld';
+    source: "json-ld";
     message: string;
     snippet: string;
 }
+/** A heading (or FAQ `<summary>`/`<dt>`) phrased as a question, and the text that follows it. */
+export interface QuestionHeading {
+    /** 1-6 for h1-h6, 0 for `<summary>` and `<dt>`. */
+    level: number;
+    text: string;
+    /** Words between the question and the next heading or question. */
+    sectionWords: number;
+    /** Words in the first paragraph, list item or definition after the question, or null when there is none. */
+    firstBlockWords: number | null;
+}
+/** What an answer engine needs from a page beyond classic SEO, read once by the extractor. */
+export interface AnswerSignals {
+    /** Content of each robots meta tag by name (robots, googlebot, bingbot, ...), lower-cased. */
+    robotsMeta: {
+        name: string;
+        content: string;
+    }[];
+    questions: QuestionHeading[];
+    /** Lists with two or more items outside navigation, header, footer and aside. */
+    lists: number;
+    /** Tables with two or more rows outside navigation, header, footer and aside. */
+    tables: number;
+    /** Elements with `data-nosnippet`, the outermost ones only. */
+    nosnippetElements: number;
+    nosnippetWords: number;
+    nosnippetSelectors: string[];
+    /** Selector of an empty JavaScript app root (`#root`, `#__next`, ...), when the page has one. */
+    emptyAppRoot: string | null;
+    /** A `<noscript>` element mentions JavaScript ("please enable JavaScript"). */
+    noscriptAsksForJavaScript: boolean;
+    /** `<time>` elements in the body. */
+    timeElements: number;
+    /** The visible text contains a written date (2026-03-14, 14/03/2026, March 14, 2026, 14 March 2026). */
+    mentionsDate: boolean;
+}
 /** Everything the extractor pulls out of one HTML document. Rules read only this. */
 export interface ExtractedPage {
     /** URL used to resolve relative links (the final URL after redirects, or the base URL for files/inline HTML). */
@@ -108,6 +143,8 @@ export interface ExtractedPage {
     wordCount: number;
     htmlBytes: number;
     hasBaseHref: boolean;
+    /** Signals the AEO audit reads; the SEO rules do not use them. */
+    answer: AnswerSignals;
 }
 export interface RedirectHop {
     url: string;
@@ -177,9 +214,9 @@ export interface LighthouseAuditSummary {
     displayValue: string | null;
 }
 export interface PerformanceResult {
-    tool: 'lighthouse';
+    tool: "lighthouse";
     lighthouseVersion: string;
-    formFactor: 'mobile' | 'desktop';
+    formFactor: "mobile" | "desktop";
     requestedUrl: string;
     finalUrl: string;
     metrics: LighthouseMetrics;
@@ -188,7 +225,7 @@ export interface PerformanceResult {
     agenticBrowsingAudits: LighthouseAuditSummary[];
 }
 export interface RenderComparison {
-    tool: 'playwright';
+    tool: "playwright";
     renderedUrl: string;
     consoleErrors: string[];
     raw: RenderSnapshot;
@@ -204,10 +241,10 @@ export interface RenderSnapshot {
     internalLinks: number;
     structuredDataCount: number;
 }
-export type PageSource = 'url' | 'file' | 'html';
+export type PageSource = "url" | "file" | "html";
 export interface PageAudit {
     schemaVersion: 1;
-    kind: 'page';
+    kind: "page";
     /** What the caller asked for (URL, path, or "inline-html"). */
     target: string;
     /** Final URL after redirects, or the file path. */
@@ -264,9 +301,9 @@ export interface IssueRollup {
 }
 export interface SiteAudit {
     schemaVersion: 1;
-    kind: 'site';
+    kind: "site";
     target: string;
-    source: 'crawl' | 'directory';
+    source: "crawl" | "directory";
     auditedAt: string;
     crawl: CrawlStats;
     robotsTxt: RobotsTxtInfo | null;
@@ -280,6 +317,144 @@ export interface SiteAudit {
     score: number;
 }
 export type Audit = PageAudit | SiteAudit;
+/**
+ * What an AI crawler fetches pages for, which decides what blocking it costs: `search` crawlers
+ * feed a search index that AI answers draw on (Google AI Overviews, Copilot), `answer` bots fetch
+ * pages for an AI answer or an AI search index, `training` bots collect text to train models.
+ */
+export type AiBotPurpose = "search" | "answer" | "training";
+/** What the server answered a request with an AI bot's User-Agent (`aiBots` only). */
+export interface BotProbe {
+    status: number | null;
+    /** The server refused or challenged this User-Agent while the audit's own request got the page. */
+    blocked: boolean;
+    /** Why it counts as blocked: "HTTP 403", "challenge page", "connection failed: ...". */
+    reason: string | null;
+}
+export interface AiBotAccess {
+    /** The bot's robots.txt token, e.g. "OAI-SearchBot". */
+    name: string;
+    operator: string;
+    purpose: AiBotPurpose;
+    usedFor: string;
+    /**
+     * The robots.txt group the bot follows: "named" when a group names it, "googlebot" for Applebot
+     * following the Googlebot group (Apple's documented fallback), "wildcard" when only
+     * `User-agent: *` applies, "none" when nothing does.
+     */
+    robotsGroup: "named" | "googlebot" | "wildcard" | "none";
+    /** robots.txt lets the bot fetch the audited page (the start page of a crawl or directory). */
+    allowed: boolean;
+    /**
+     * Audited pages robots.txt keeps this bot from while `User-agent: *` lets crawlers fetch them.
+     * Paths disallowed for every crawler are left to the SEO audit's `site.robots-blocked-pages`.
+     */
+    blockedPages: number;
+    probe?: BotProbe;
+}
+/** One `Content-Signal` line of robots.txt (contentsignals.org). */
+export interface ContentSignal {
+    /** User agents of the robots.txt group the line sits in. */
+    userAgents: string[];
+    /** The path the line is limited to, or null for the whole site. */
+    path: string | null;
+    /** Each signal and its value as written, lower-cased: { search: "yes", "ai-input": "no" }. */
+    signals: Record<string, string>;
+}
+export interface AiCrawlerReport {
+    robotsTxt: string;
+    status: "found" | "missing" | "unreachable";
+    httpStatus: number | null;
+    /**
+     * The shared AI training preference (`User-Agent: __usage_ai-training`) for the audited page:
+     * "disallowed" opts out of training, "none" when robots.txt names no such group.
+     */
+    trainingPreference: "allowed" | "disallowed" | "none";
+    contentSignals: ContentSignal[];
+    bots: AiBotAccess[];
+    /** With `aiBots`: the User-Agent and status of the audit's own request, which each probe is compared with. */
+    probeBaseline?: {
+        userAgent: string;
+        status: number | null;
+    };
+}
+export interface LlmsTxtInfo {
+    url: string;
+    status: "found" | "missing" | "invalid";
+    httpStatus: number | null;
+    /** The H1 line, the one part the llms.txt format requires. */
+    title: string | null;
+    /** The blockquote after the title. */
+    summary: string | null;
+    /** H2 section names (capped). */
+    sections: string[];
+    /** Markdown links in the file. */
+    links: number;
+    bytes: number;
+    /** Why the file does not follow the format, when it does not. */
+    problems: string[];
+}
+export interface AeoPageSummary {
+    indexable: boolean;
+    /** "blocked" by nosnippet or max-snippet:0, "limited" by a short max-snippet or data-nosnippet. */
+    googleSnippets: "allowed" | "limited" | "blocked";
+    /** "excluded" by noarchive or noindex, "snippet-only" by nocache (Bing's rules for Copilot). */
+    copilotAnswers: "allowed" | "snippet-only" | "excluded";
+    wordCount: number;
+    questions: number;
+    structuredDataTypes: string[];
+    author: string | null;
+    datePublished: string | null;
+    dateModified: string | null;
+}
+export interface AeoPage {
+    url: string;
+    depth?: number;
+    score: number;
+    counts: SeverityCounts;
+    summary: AeoPageSummary;
+}
+export interface AeoSummary {
+    pages: number;
+    /** null when the target has no site to read robots.txt from (an HTML string or a single file). */
+    robotsTxt: "found" | "missing" | "unreachable" | null;
+    searchCrawlersBlocked: string[];
+    answerBotsBlocked: string[];
+    trainingBotsBlocked: string[];
+    trainingPreference: "allowed" | "disallowed" | "none" | null;
+    /** Bots the server refused or challenged, with `aiBots`; null without it. */
+    blockedByServer: string[] | null;
+    llmsTxt: "found" | "missing" | "invalid" | null;
+    /** The audited page, or the start page of a crawl or directory. */
+    page: AeoPageSummary | null;
+}
+/**
+ * An answer engine optimization audit: can AI crawlers reach the site, may answer engines quote
+ * it, and is the content easy to lift into an answer. Its score counts AEO findings only.
+ */
+export interface AeoAudit {
+    schemaVersion: 1;
+    kind: "aeo";
+    target: string;
+    url: string;
+    source: PageSource | "crawl" | "directory";
+    /** 0-100. Indicative only: the average page score minus weighted site-wide findings. */
+    score: number;
+    counts: SeverityCounts;
+    auditedAt: string;
+    summary: AeoSummary;
+    /**
+     * Site-wide findings (robots.txt, llms.txt, bot probes), then the page findings: all of them for
+     * one page or with `pageDetail: "full"`, none for a site with `pageDetail: "summary"` (see `issues`).
+     */
+    findings: Finding[];
+    crawlers: AiCrawlerReport | null;
+    llmsTxt: LlmsTxtInfo | null;
+    /** Crawl and directory audits: each page's score and summary. */
+    pages?: AeoPage[];
+    /** Crawl and directory audits: page findings rolled up by rule. */
+    issues?: IssueRollup[];
+}
 export interface Thresholds {
     titleMinChars: number;
     titleMaxChars: number;
@@ -292,5 +467,5 @@ export interface Thresholds {
     maxKeywordDensityPercent: number;
 }
 export declare const DEFAULT_THRESHOLDS: Thresholds;
-export declare function emptyCounts(): SeverityCounts;
-export declare function countFindings(findings: Finding[]): SeverityCounts;
+export declare const emptyCounts: () => SeverityCounts;
+export declare const countFindings: (findings: Finding[]) => SeverityCounts;

package/dist/core/types.js

@@ -2,7 +2,11 @@
  * Shared types for the SEO audit core. These shapes are the public contract
  * of the CLI JSON output and the MCP tool results (`schemaVersion: 1`).
  */
-export const SEVERITY_RANK = { error: 3, warning: 2, info: 1 };
+export const SEVERITY_RANK = {
+    error: 3,
+    warning: 2,
+    info: 1,
+};
 export const DEFAULT_THRESHOLDS = {
     titleMinChars: 30,
     titleMaxChars: 60,
@@ -14,13 +18,16 @@ export const DEFAULT_THRESHOLDS = {
     deepPageDepth: 3,
     maxKeywordDensityPercent: 3,
 };
-export function emptyCounts() {
-    return { error: 0, warning: 0, info: 0 };
-}
-export function countFindings(findings) {
+export const emptyCounts = () => ({
+    error: 0,
+    warning: 0,
+    info: 0,
+});
+export const countFindings = (findings) => {
     const counts = emptyCounts();
-    for (const f of findings)
-        counts[f.severity]++;
+    for (const f of findings) {
+        counts[f.severity] += 1;
+    }
     return counts;
-}
+};
 //# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,CAAC,MAAM,aAAa,GAA6B,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AA0UzF,MAAM,CAAC,MAAM,kBAAkB,GAAe;IAC5C,aAAa,EAAE,EAAE;IACjB,aAAa,EAAE,EAAE;IACjB,mBAAmB,EAAE,EAAE;IACvB,mBAAmB,EAAE,GAAG;IACxB,UAAU,EAAE,EAAE;IACd,gBAAgB,EAAE,GAAG;IACrB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,CAAC;IAChB,wBAAwB,EAAE,CAAC;CAC5B,CAAC;AAEF,MAAM,UAAU,WAAW;IACzB,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAmB;IAC/C,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,QAAQ;QAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC/C,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,CAAC,MAAM,aAAa,GAA6B;IACrD,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,CAAC;IACV,IAAI,EAAE,CAAC;CACR,CAAC;AAugBF,MAAM,CAAC,MAAM,kBAAkB,GAAe;IAC5C,aAAa,EAAE,EAAE;IACjB,aAAa,EAAE,EAAE;IACjB,mBAAmB,EAAE,EAAE;IACvB,mBAAmB,EAAE,GAAG;IACxB,UAAU,EAAE,EAAE;IACd,gBAAgB,EAAE,GAAG;IACrB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,CAAC;IAChB,wBAAwB,EAAE,CAAC;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,GAAmB,EAAE,CAAC,CAAC;IAChD,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,CAAC;IACV,IAAI,EAAE,CAAC;CACR,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAmB,EAAkB,EAAE;IACnE,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;IAE7B,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/dist/core/url.d.ts

@@ -1,20 +1,20 @@
-export declare function isHttpUrl(value: string): boolean;
+export declare const isHttpUrl: (value: string) => boolean;
 /** Resolve `href` against `base`, returning null for non-http(s) or unparsable values. */
-export declare function resolveUrl(href: string, base: string): string | null;
+export declare const resolveUrl: (href: string, base: string) => string | null;
 /**
  * Canonical form used for visited-sets and comparisons: lower-cased scheme/host,
  * default ports dropped, fragment removed, tracking parameters removed.
  * Path and remaining query are kept verbatim (trailing slashes matter to servers).
  */
-export declare function normalizeUrl(input: string): string | null;
-export declare function hostOf(url: string): string | null;
-export declare function stripWww(host: string): string;
+export declare const normalizeUrl: (input: string) => string | null;
+export declare const hostOf: (url: string) => string | null;
+export declare const stripWww: (host: string) => string;
 /** Same site: identical host ignoring `www.`; optionally any subdomain of the start host. */
-export declare function isSameSite(candidate: string, startHost: string, includeSubdomains?: boolean): boolean;
+export declare const isSameSite: (candidate: string, startHost: string, includeSubdomains?: boolean) => boolean;
 /** Heuristic: does the path look like it points at an HTML document (not an asset)? */
-export declare function looksLikeHtml(url: string): boolean;
-/** Compare two URLs by path only (used for static-directory audits where the host is synthetic). */
-export declare function samePath(a: string, b: string): boolean;
+export declare const looksLikeHtml: (url: string) => boolean;
 /** `/dir/index.html` -> `/dir/`, `/page.html` -> `/page`, trailing slash dropped except root. */
-export declare function normalizePath(pathname: string): string;
-export declare function truncate(value: string, max?: number): string;
+export declare const normalizePath: (pathname: string) => string;
+/** Compare two URLs by path only (used for static-directory audits where the host is synthetic). */
+export declare const samePath: (a: string, b: string) => boolean;
+export declare const truncate: (value: string, max?: number) => string;

package/dist/core/url.js

@@ -1,125 +1,169 @@
-import path from 'node:path';
+import path from "node:path";
 const TRACKING_PARAMS = new Set([
-    'utm_source',
-    'utm_medium',
-    'utm_campaign',
-    'utm_term',
-    'utm_content',
-    'utm_id',
-    'fbclid',
-    'gclid',
-    'dclid',
-    'msclkid',
-    'mc_cid',
-    'mc_eid',
-    '_hsenc',
-    '_hsmi',
-    'ref',
+    "utm_source",
+    "utm_medium",
+    "utm_campaign",
+    "utm_term",
+    "utm_content",
+    "utm_id",
+    "fbclid",
+    "gclid",
+    "dclid",
+    "msclkid",
+    "mc_cid",
+    "mc_eid",
+    "_hsenc",
+    "_hsmi",
+    "ref",
 ]);
 const NON_HTML_EXTENSIONS = new Set([
-    '.pdf', '.jpg', '.jpeg', '.png', '.gif', '.webp', '.avif', '.svg', '.ico', '.bmp', '.tiff',
-    '.mp4', '.webm', '.mp3', '.wav', '.ogg', '.mov', '.avi',
-    '.zip', '.gz', '.tar', '.rar', '.7z', '.dmg', '.exe', '.msi',
-    '.css', '.js', '.mjs', '.map', '.json', '.xml', '.txt', '.rss', '.atom',
-    '.woff', '.woff2', '.ttf', '.otf', '.eot',
-    '.doc', '.docx', '.xls', '.xlsx', '.ppt', '.pptx', '.csv',
+    ".pdf",
+    ".jpg",
+    ".jpeg",
+    ".png",
+    ".gif",
+    ".webp",
+    ".avif",
+    ".svg",
+    ".ico",
+    ".bmp",
+    ".tiff",
+    ".mp4",
+    ".webm",
+    ".mp3",
+    ".wav",
+    ".ogg",
+    ".mov",
+    ".avi",
+    ".zip",
+    ".gz",
+    ".tar",
+    ".rar",
+    ".7z",
+    ".dmg",
+    ".exe",
+    ".msi",
+    ".css",
+    ".js",
+    ".mjs",
+    ".map",
+    ".json",
+    ".xml",
+    ".txt",
+    ".rss",
+    ".atom",
+    ".woff",
+    ".woff2",
+    ".ttf",
+    ".otf",
+    ".eot",
+    ".doc",
+    ".docx",
+    ".xls",
+    ".xlsx",
+    ".ppt",
+    ".pptx",
+    ".csv",
 ]);
-export function isHttpUrl(value) {
-    return /^https?:\/\//i.test(value.trim());
-}
+export const isHttpUrl = (value) => /^https?:\/\//iu.test(value.trim());
 /** Resolve `href` against `base`, returning null for non-http(s) or unparsable values. */
-export function resolveUrl(href, base) {
+export const resolveUrl = (href, base) => {
     const trimmed = href.trim();
-    if (!trimmed)
+    if (!trimmed) {
         return null;
-    if (/^(mailto|tel|sms|javascript|data|blob|file|ftp|whatsapp|skype):/i.test(trimmed))
+    }
+    if (/^(?:mailto|tel|sms|javascript|data|blob|file|ftp|whatsapp|skype):/iu.test(trimmed)) {
         return null;
+    }
     try {
         const url = new URL(trimmed, base);
-        if (url.protocol !== 'http:' && url.protocol !== 'https:')
+        if (url.protocol !== "http:" && url.protocol !== "https:") {
             return null;
+        }
         return url.href;
     }
     catch {
         return null;
     }
-}
+};
 /**
  * Canonical form used for visited-sets and comparisons: lower-cased scheme/host,
  * default ports dropped, fragment removed, tracking parameters removed.
  * Path and remaining query are kept verbatim (trailing slashes matter to servers).
  */
-export function normalizeUrl(input) {
+export const normalizeUrl = (input) => {
     try {
         const url = new URL(input);
-        if (url.protocol !== 'http:' && url.protocol !== 'https:')
+        if (url.protocol !== "http:" && url.protocol !== "https:") {
             return null;
-        url.hash = '';
+        }
+        url.hash = "";
         url.hostname = url.hostname.toLowerCase();
-        if ((url.protocol === 'http:' && url.port === '80') || (url.protocol === 'https:' && url.port === '443')) {
-            url.port = '';
+        if ((url.protocol === "http:" && url.port === "80") ||
+            (url.protocol === "https:" && url.port === "443")) {
+            url.port = "";
         }
         const params = [...url.searchParams.keys()];
         for (const key of params) {
-            if (TRACKING_PARAMS.has(key.toLowerCase()))
+            if (TRACKING_PARAMS.has(key.toLowerCase())) {
                 url.searchParams.delete(key);
+            }
+        }
+        if ([...url.searchParams.keys()].length === 0) {
+            url.search = "";
         }
-        if ([...url.searchParams.keys()].length === 0)
-            url.search = '';
         return url.href;
     }
     catch {
         return null;
     }
-}
-export function hostOf(url) {
+};
+export const hostOf = (url) => {
     try {
         return new URL(url).hostname.toLowerCase();
     }
     catch {
         return null;
     }
-}
-export function stripWww(host) {
-    return host.replace(/^www\./i, '');
-}
+};
+export const stripWww = (host) => host.replace(/^www\./iu, "");
 /** Same site: identical host ignoring `www.`; optionally any subdomain of the start host. */
-export function isSameSite(candidate, startHost, includeSubdomains = false) {
+export const isSameSite = (candidate, startHost, includeSubdomains = false) => {
     const host = hostOf(candidate);
-    if (!host)
+    if (!host) {
         return false;
+    }
     const a = stripWww(host);
     const b = stripWww(startHost.toLowerCase());
-    if (a === b)
+    if (a === b) {
         return true;
+    }
     return includeSubdomains && a.endsWith(`.${b}`);
-}
+};
 /** Heuristic: does the path look like it points at an HTML document (not an asset)? */
-export function looksLikeHtml(url) {
+export const looksLikeHtml = (url) => {
     try {
         const { pathname } = new URL(url);
         const ext = path.posix.extname(pathname).toLowerCase();
-        if (!ext)
+        if (!ext) {
             return true;
-        if (ext === '.html' || ext === '.htm' || ext === '.php' || ext === '.asp' || ext === '.aspx' || ext === '.jsp')
+        }
+        if (ext === ".html" ||
+            ext === ".htm" ||
+            ext === ".php" ||
+            ext === ".asp" ||
+            ext === ".aspx" ||
+            ext === ".jsp") {
             return true;
+        }
         return !NON_HTML_EXTENSIONS.has(ext);
     }
     catch {
         return false;
     }
-}
-/** Compare two URLs by path only (used for static-directory audits where the host is synthetic). */
-export function samePath(a, b) {
-    try {
-        return normalizePath(new URL(a).pathname) === normalizePath(new URL(b).pathname);
-    }
-    catch {
-        return false;
-    }
-}
+};
 /** `/dir/index.html` -> `/dir/`, `/page.html` -> `/page`, trailing slash dropped except root. */
-export function normalizePath(pathname) {
+export const normalizePath = (pathname) => {
     let p = pathname;
     try {
         p = decodeURIComponent(p);
@@ -127,13 +171,21 @@ export function normalizePath(pathname) {
     catch {
         /* keep as-is */
     }
-    p = p.replace(/\/index\.html?$/i, '/');
-    p = p.replace(/\.html?$/i, '');
-    if (p.length > 1 && p.endsWith('/'))
+    p = p.replace(/\/index\.html?$/iu, "/");
+    p = p.replace(/\.html?$/iu, "");
+    if (p.length > 1 && p.endsWith("/")) {
         p = p.slice(0, -1);
-    return p === '' ? '/' : p;
-}
-export function truncate(value, max = 120) {
-    return value.length > max ? `${value.slice(0, max - 1)}…` : value;
-}
+    }
+    return p === "" ? "/" : p;
+};
+/** Compare two URLs by path only (used for static-directory audits where the host is synthetic). */
+export const samePath = (a, b) => {
+    try {
+        return (normalizePath(new URL(a).pathname) === normalizePath(new URL(b).pathname));
+    }
+    catch {
+        return false;
+    }
+};
+export const truncate = (value, max = 120) => value.length > max ? `${value.slice(0, max - 1)}…` : value;
 //# sourceMappingURL=url.js.map

package/dist/core/url.js.map

@@ -1 +1 @@
-{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/core/url.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/core/url.ts"],"names":[],"mappings":"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"}