@anselmdk/feature-spec-md 0.11.0 → 0.11.1

package/dist/githubActionFtpMaintenance.js

@@ -0,0 +1,243 @@
+import { appendFile } from "node:fs/promises";
+import { ftpConnectionConfig, listRemoteDirectory, pathJoin, runCurl, } from "./githubActionFtp.js";
+export async function runFtpMaintenance(options) {
+    const config = ftpConnectionConfig(options);
+    const mode = maintenanceMode(options.mode ?? process.env.FEATURE_SPEC_FTP_MODE ?? "report");
+    const keepBuilds = positiveInteger(options["keep-builds"] ?? process.env.FEATURE_SPEC_FTP_KEEP_BUILDS, 10);
+    const requestedPaths = csv(options.paths ?? process.env.FEATURE_SPEC_FTP_PATHS);
+    const inventory = await inventoryRemoteDirectory(config.remoteDir, config);
+    const freeBytes = await remoteFreeBytes(config.remoteDir, config);
+    const cleanupPaths = mode === "report"
+        ? []
+        : cleanupCandidates(inventory, config.remoteDir, keepBuilds, requestedPaths);
+    if (mode === "cleanup" && !requestedPaths.length && keepBuilds < 1) {
+        throw new Error("Cleanup requires --keep-builds of at least 1 or --paths.");
+    }
+    if (mode === "cleanup") {
+        await deletePaths(cleanupPaths, inventory, config);
+    }
+    const afterInventory = mode === "cleanup"
+        ? await inventoryRemoteDirectory(config.remoteDir, config)
+        : inventory;
+    const summary = formatSummary({
+        config,
+        mode,
+        keepBuilds,
+        requestedPaths,
+        inventory,
+        cleanupPaths,
+        freeBytes,
+        afterInventory,
+    });
+    await writeSummary(summary, options);
+    console.log(summary);
+    return { summary, inventory, cleanupPaths, freeBytes };
+}
+export function parseFtpSizeResponse(response) {
+    const match = response.match(/(?:^|\s)(\d+)\s*$/m);
+    return match ? Number(match[1]) : undefined;
+}
+export function parseFtpHeadSize(response) {
+    const match = response.match(/^Size:\s*(\d+)\s*$/im);
+    return match ? Number(match[1]) : parseFtpSizeResponse(response);
+}
+async function inventoryRemoteDirectory(remoteDir, config) {
+    const entries = [];
+    await visit(remoteDir);
+    return entries.sort((a, b) => a.path.localeCompare(b.path));
+    async function visit(directory) {
+        const listing = await listRemoteDirectory(directory, config);
+        const names = listing
+            .split(/\r?\n/)
+            .map((line) => line.trim())
+            .filter(Boolean)
+            .map((line) => line.split(/\s+/).at(-1) ?? "")
+            .filter((name) => name && name !== "." && name !== "..");
+        for (const name of new Set(names)) {
+            const child = pathJoin(directory, name);
+            try {
+                await listRemoteDirectory(child, config);
+                entries.push({ path: child, kind: "directory", sizeBytes: 0 });
+                await visit(child);
+            }
+            catch {
+                const sizeBytes = (await remoteFileSize(child, config)) ?? 0;
+                entries.push({ path: child, kind: "file", sizeBytes });
+            }
+        }
+    }
+}
+async function remoteFileSize(remotePath, config) {
+    try {
+        const response = await runCurl(ftpArgs(config, ["--head"], remotePath));
+        return parseFtpHeadSize(response);
+    }
+    catch {
+        return undefined;
+    }
+}
+async function remoteFreeBytes(remoteDir, config) {
+    for (const command of ["SITE AVAIL", "STAT -f"]) {
+        try {
+            const response = await runCurl(ftpArgs(config, ["--quote", command, "--head"], remoteDir));
+            const size = parseFtpSizeResponse(response);
+            if (size !== undefined)
+                return size;
+        }
+        catch {
+            // FTP has no portable free-space command; unsupported servers are normal.
+        }
+    }
+    return undefined;
+}
+function cleanupCandidates(inventory, root, keepBuilds, requestedPaths) {
+    const exact = requestedPaths.map((item) => safeChildPath(root, item));
+    const buildRoot = pathJoin(root, "build");
+    const builds = inventory
+        .filter((entry) => entry.kind === "directory" && entry.path.startsWith(`${buildRoot}/`))
+        .map((entry) => entry.path.slice(buildRoot.length + 1).split("/")[0])
+        .filter((name) => /^\d+$/.test(name));
+    const oldBuilds = Array.from(new Set(builds))
+        .sort((a, b) => Number(b) - Number(a))
+        .slice(keepBuilds)
+        .map((name) => pathJoin(buildRoot, name));
+    return Array.from(new Set([...oldBuilds, ...exact]));
+}
+async function deletePaths(paths, inventory, config) {
+    for (const target of paths) {
+        const descendants = inventory
+            .filter((entry) => entry.path === target || entry.path.startsWith(`${target}/`))
+            .sort((a, b) => b.path.length - a.path.length);
+        for (const entry of descendants) {
+            await deleteRemote(entry.path, entry.kind, config);
+        }
+        if (!descendants.length) {
+            await deleteRemote(target, "file", config);
+        }
+    }
+}
+async function deleteRemote(remotePath, kind, config) {
+    const command = kind === "directory" ? "RMD" : "DELE";
+    await runCurl(ftpArgs(config, ["--quote", `${command} ${remotePath}`, "--list-only"], config.remoteDir));
+}
+function formatSummary(input) {
+    const lines = [
+        "## FTP storage diagnostic",
+        "",
+        `- Mode: **${input.mode}**`,
+        `- Root: \`${input.config.remoteDir || "/"}\``,
+        `- Files: **${input.inventory.filter((entry) => entry.kind === "file").length}**`,
+        `- Used: **${formatBytes(totalBytes(input.inventory))}**`,
+        `- Available: **${input.freeBytes === undefined ? "not reported by server" : formatBytes(input.freeBytes)}**`,
+        "",
+        "### Directory usage",
+        "",
+        "| Directory | Files | Size |",
+        "| --- | ---: | ---: |",
+        ...directoryRows(input.inventory, input.config.remoteDir),
+        "",
+        "### Cleanup",
+        "",
+        input.cleanupPaths.length
+            ? `The following paths ${input.mode === "cleanup" ? "were deleted" : "would be deleted"}:`
+            : "No cleanup paths selected.",
+        ...input.cleanupPaths.map((path) => `- \`${path}\``),
+    ];
+    if (input.mode === "cleanup") {
+        lines.push("", `After cleanup: **${formatBytes(totalBytes(input.afterInventory))}** used across **${input.afterInventory.filter((entry) => entry.kind === "file").length}** files.`);
+    }
+    else {
+        lines.push("", `Build retention: keep the newest **${input.keepBuilds}** numbered builds.`);
+    }
+    return lines.join("\n");
+}
+function directoryRows(inventory, root) {
+    const rows = new Map();
+    for (const entry of inventory.filter((item) => item.kind === "file")) {
+        const relative = entry.path.startsWith(`${root}/`)
+            ? entry.path.slice(root.length + 1)
+            : entry.path;
+        const parts = relative.split("/");
+        parts.pop();
+        for (let index = 0; index <= parts.length; index += 1) {
+            const directory = index
+                ? `${root}/${parts.slice(0, index).join("/")}`
+                : root || "/";
+            const current = rows.get(directory) ?? { files: 0, bytes: 0 };
+            current.files += 1;
+            current.bytes += entry.sizeBytes;
+            rows.set(directory, current);
+        }
+    }
+    return Array.from(rows.entries())
+        .sort(([, a], [, b]) => b.bytes - a.bytes)
+        .map(([directory, value]) => `| \`${directory || "/"}\` | ${value.files} | ${formatBytes(value.bytes)} |`);
+}
+function totalBytes(inventory) {
+    return inventory.reduce((sum, entry) => sum + (entry.kind === "file" ? entry.sizeBytes : 0), 0);
+}
+function ftpArgs(config, args, remotePath) {
+    const protocol = config.secure ? "ftps" : "ftp";
+    const port = config.port ? `:${config.port}` : "";
+    const encodedPath = remotePath
+        .split("/")
+        .filter(Boolean)
+        .map(encodeURIComponent)
+        .join("/");
+    return [
+        "--silent",
+        "--show-error",
+        "--fail",
+        "-u",
+        `${config.user}:${config.password}`,
+        ...args,
+        `${protocol}://${config.host}${port}/${encodedPath}`,
+    ];
+}
+function safeChildPath(root, value) {
+    if (!value || value.startsWith("/") || value.split("/").includes("..")) {
+        throw new Error(`Cleanup path must be relative to the FTP root: ${value}`);
+    }
+    return pathJoin(root, value);
+}
+function maintenanceMode(value) {
+    if (value === "report" || value === "dry-run" || value === "cleanup")
+        return value;
+    throw new Error(`Unknown FTP maintenance mode: ${value ?? ""}`);
+}
+function positiveInteger(value, fallback) {
+    if (value === undefined)
+        return fallback;
+    if (!/^\d+$/.test(value))
+        throw new Error(`Expected a non-negative integer: ${value}`);
+    return Number(value);
+}
+function csv(value) {
+    return (value ?? "")
+        .split(",")
+        .map((item) => item.trim())
+        .filter(Boolean);
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    const units = ["KiB", "MiB", "GiB", "TiB"];
+    let value = bytes;
+    let unit = "B";
+    for (const next of units) {
+        value /= 1024;
+        unit = next;
+        if (value < 1024)
+            break;
+    }
+    return `${value.toFixed(value >= 10 ? 1 : 2)} ${unit}`;
+}
+async function writeSummary(summary, options) {
+    const file = options["summary-file"] ?? process.env.GITHUB_STEP_SUMMARY;
+    if (file)
+        await appendFile(file, `${summary}\n`);
+    const output = options["output-file"] ?? process.env.GITHUB_OUTPUT;
+    if (output)
+        await appendFile(output, `ftp-summary<<FEATURE_SPEC_FTP_SUMMARY\n${summary}\nFEATURE_SPEC_FTP_SUMMARY\n`);
+}
+//# sourceMappingURL=githubActionFtpMaintenance.js.map

package/dist/githubActionFtpMaintenance.js.map

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

package/dist/githubActionReport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"githubActionReport.d.ts","sourceRoot":"","sources":["../src/githubActionReport.ts"],"names":[],"mappings":"AAGA,OAAO,EAOL,KAAK,mBAAmB,EACzB,MAAM,sBAAsB,CAAC;AAK9B,MAAM,MAAM,yBAAyB,GAAG,mBAAmB,CAAC;AAO5D,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,yBAAyB,iBA8DnC;AAqFD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,UAE9C;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;EAK/D"}
+{"version":3,"file":"githubActionReport.d.ts","sourceRoot":"","sources":["../src/githubActionReport.ts"],"names":[],"mappings":"AAGA,OAAO,EAOL,KAAK,mBAAmB,EACzB,MAAM,sBAAsB,CAAC;AAM9B,MAAM,MAAM,yBAAyB,GAAG,mBAAmB,CAAC;AAO5D,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,yBAAyB,iBA8DnC;AAqFD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,UAE9C;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;EAK/D"}

package/dist/githubActionReport.js

@@ -3,6 +3,7 @@ import { join } from "node:path";
 import { tmpdir } from "node:os";
 import { ftpConfig, listBuildNumbers, pathJoin, publicUrl, uploadDirectory, uploadFile, } from "./githubActionFtp.js";
 import { writeGithubOutput, writeGithubSummary } from "./githubActionOutput.js";
+import { formatGeneratedAt, renderGeneratedAt } from "./reportDate.js";
 import { writePublishedFeatureSpecFiles } from "./reportArtifacts.js";
 import { renderHtmlPage } from "./reportHtml.js";
 const defaultSpecPattern = "specs/**/*.model.md,specs/**/*.feature.md,specs/**/*.stack.md,specs/**/*.design.md";
@@ -92,7 +93,7 @@ li { margin: 0.35rem 0; }
 `,
         body: `
 <h1>Feature spec build reports</h1>
-<p>Generated ${escapeHtml(generatedAt)}.</p>
+<p ${renderGeneratedAt(generatedAt)}>Generated ${escapeHtml(formatGeneratedAt(generatedAt))}.</p>
 <p><a href="${escapeHtml(latestReportUrl(baseUrl))}"><strong>Open the latest report</strong></a></p>
 <ol>
 ${rows}

package/dist/githubActionReport.js.map

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

package/dist/imageComparison.d.ts

@@ -1,2 +1,8 @@
 export declare function pngsHaveIdenticalPixels(previousPath: string, currentPath: string): Promise<boolean | undefined>;
+/**
+ * Treats tiny rasterisation noise as visually equivalent while retaining a
+ * conservative guard against hiding real UI changes. The thresholds are based
+ * on decoded RGBA pixels, so PNG compression and metadata do not affect them.
+ */
+export declare function pngsAreVisuallyEquivalent(previousPath: string, currentPath: string): Promise<boolean | undefined>;
 //# sourceMappingURL=imageComparison.d.ts.map

package/dist/imageComparison.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"imageComparison.d.ts","sourceRoot":"","sources":["../src/imageComparison.ts"],"names":[],"mappings":"AAGA,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,gCAoBpB"}
+{"version":3,"file":"imageComparison.d.ts","sourceRoot":"","sources":["../src/imageComparison.ts"],"names":[],"mappings":"AAGA,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,gCAoBpB;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,gCAiCpB"}

package/dist/imageComparison.js

@@ -18,6 +18,40 @@ export async function pngsHaveIdenticalPixels(previousPath, currentPath) {
         return undefined;
     }
 }
+/**
+ * Treats tiny rasterisation noise as visually equivalent while retaining a
+ * conservative guard against hiding real UI changes. The thresholds are based
+ * on decoded RGBA pixels, so PNG compression and metadata do not affect them.
+ */
+export async function pngsAreVisuallyEquivalent(previousPath, currentPath) {
+    try {
+        const [previous, current] = await Promise.all([
+            readPng(previousPath),
+            readPng(currentPath),
+        ]);
+        if (previous.width !== current.width ||
+            previous.height !== current.height) {
+            return false;
+        }
+        let changedPixels = 0;
+        let totalDifference = 0;
+        for (let offset = 0; offset < previous.data.length; offset += 4) {
+            let pixelDifference = 0;
+            for (let channel = 0; channel < 4; channel += 1) {
+                pixelDifference += Math.abs(previous.data[offset + channel] - current.data[offset + channel]);
+            }
+            totalDifference += pixelDifference;
+            if (pixelDifference > 8)
+                changedPixels += 1;
+        }
+        const pixelCount = previous.width * previous.height;
+        return (changedPixels / pixelCount <= 0.001 &&
+            totalDifference / (pixelCount * 4) <= 1.5);
+    }
+    catch {
+        return undefined;
+    }
+}
 async function readPng(filePath) {
     return PNG.sync.read(await readFile(filePath));
 }

package/dist/imageComparison.js.map

@@ -1 +1 @@
-{"version":3,"file":"imageComparison.js","sourceRoot":"","sources":["../src/imageComparison.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE5B,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,YAAoB,EACpB,WAAmB;IAEnB,IAAI,CAAC;QACH,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC5C,OAAO,CAAC,YAAY,CAAC;YACrB,OAAO,CAAC,WAAW,CAAC;SACrB,CAAC,CAAC;QACH,IACE,QAAQ,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK;YAChC,QAAQ,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,EAClC,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,2EAA2E;QAC3E,qEAAqE;QACrE,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,QAAgB;IACrC,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AACjD,CAAC"}
+{"version":3,"file":"imageComparison.js","sourceRoot":"","sources":["../src/imageComparison.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE5B,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,YAAoB,EACpB,WAAmB;IAEnB,IAAI,CAAC;QACH,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC5C,OAAO,CAAC,YAAY,CAAC;YACrB,OAAO,CAAC,WAAW,CAAC;SACrB,CAAC,CAAC;QACH,IACE,QAAQ,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK;YAChC,QAAQ,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,EAClC,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,2EAA2E;QAC3E,qEAAqE;QACrE,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,YAAoB,EACpB,WAAmB;IAEnB,IAAI,CAAC;QACH,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC5C,OAAO,CAAC,YAAY,CAAC;YACrB,OAAO,CAAC,WAAW,CAAC;SACrB,CAAC,CAAC;QACH,IACE,QAAQ,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK;YAChC,QAAQ,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,EAClC,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,IAAI,eAAe,GAAG,CAAC,CAAC;QACxB,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC;YAChE,IAAI,eAAe,GAAG,CAAC,CAAC;YACxB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;gBAChD,eAAe,IAAI,IAAI,CAAC,GAAG,CACzB,QAAQ,CAAC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,CACjE,CAAC;YACJ,CAAC;YACD,eAAe,IAAI,eAAe,CAAC;YACnC,IAAI,eAAe,GAAG,CAAC;gBAAE,aAAa,IAAI,CAAC,CAAC;QAC9C,CAAC;QACD,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC;QACpD,OAAO,CACL,aAAa,GAAG,UAAU,IAAI,KAAK;YACnC,eAAe,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,IAAI,GAAG,CAC1C,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,QAAgB;IACrC,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/dist/reportDate.d.ts

@@ -0,0 +1,3 @@
+export declare function formatGeneratedAt(value: string | undefined): string;
+export declare function renderGeneratedAt(value: string | undefined): string;
+//# sourceMappingURL=reportDate.d.ts.map

package/dist/reportDate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportDate.d.ts","sourceRoot":"","sources":["../src/reportDate.ts"],"names":[],"mappings":"AAEA,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,UAqB1D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,UAG1D"}

package/dist/reportDate.js

@@ -0,0 +1,40 @@
+import { html } from "./html.js";
+export function formatGeneratedAt(value) {
+    const date = value ? new Date(value) : new Date();
+    if (Number.isNaN(date.getTime()))
+        return value ?? "";
+    const day = date.getDate();
+    const month = [
+        "January",
+        "February",
+        "March",
+        "April",
+        "May",
+        "June",
+        "July",
+        "August",
+        "September",
+        "October",
+        "November",
+        "December",
+    ][date.getMonth()];
+    const hours = String(date.getHours()).padStart(2, "0");
+    const minutes = String(date.getMinutes()).padStart(2, "0");
+    return `${day}${ordinalSuffix(day)} ${month} ${date.getFullYear()} at ${hours}:${minutes}`;
+}
+export function renderGeneratedAt(value) {
+    const timestamp = value ?? new Date().toISOString();
+    return `data-generated-at="${html(timestamp)}"`;
+}
+function ordinalSuffix(day) {
+    if (day >= 11 && day <= 13)
+        return "th";
+    if (day % 10 === 1)
+        return "st";
+    if (day % 10 === 2)
+        return "nd";
+    if (day % 10 === 3)
+        return "rd";
+    return "th";
+}
+//# sourceMappingURL=reportDate.js.map

package/dist/reportDate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportDate.js","sourceRoot":"","sources":["../src/reportDate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;IAClD,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,KAAK,IAAI,EAAE,CAAC;IACrD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG;QACZ,SAAS;QACT,UAAU;QACV,OAAO;QACP,OAAO;QACP,KAAK;QACL,MAAM;QACN,MAAM;QACN,QAAQ;QACR,WAAW;QACX,SAAS;QACT,UAAU;QACV,UAAU;KACX,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3D,OAAO,GAAG,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,WAAW,EAAE,OAAO,KAAK,IAAI,OAAO,EAAE,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,MAAM,SAAS,GAAG,KAAK,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACpD,OAAO,sBAAsB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;AAClD,CAAC;AAED,SAAS,aAAa,CAAC,GAAW;IAChC,IAAI,GAAG,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IACxC,IAAI,GAAG,GAAG,EAAE,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,GAAG,GAAG,EAAE,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,GAAG,GAAG,EAAE,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/reportHtml.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reportHtml.d.ts","sourceRoot":"","sources":["../src/reportHtml.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAM7B,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACjC,CAAC;AAEF,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,IAAI,EACJ,MAAW,EACX,OAAY,EACZ,QAAQ,EACR,QAAwC,GACzC,EAAE,eAAe,UAqGjB"}
+{"version":3,"file":"reportHtml.d.ts","sourceRoot":"","sources":["../src/reportHtml.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAM7B,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACjC,CAAC;AAEF,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,IAAI,EACJ,MAAW,EACX,OAAY,EACZ,QAAQ,EACR,QAAwC,GACzC,EAAE,eAAe,UAuGjB"}

package/dist/reportHtml.js

@@ -10,7 +10,7 @@ export function renderHtmlPage({ title, body, styles = "", scripts = "", maxWidt
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1">
   <title>${html(title)}</title>
-  <script>(function(){var saved;try{saved=localStorage.getItem("feature-spec-md-theme");}catch(error){}var dark=window.matchMedia("(prefers-color-scheme: dark)").matches;document.documentElement.dataset.theme=saved|| (dark?"dark":"light");})();</script>
+  <script>(function(){var saved;try{saved=localStorage.getItem("feature-spec-md-theme");}catch(error){}var explicit=saved==="dark"||saved==="light"?saved:null;var dark=window.matchMedia("(prefers-color-scheme: dark)").matches;document.documentElement.dataset.theme=explicit|| (dark?"dark":"light");})();</script>
   <style>
     :root {
       color-scheme: light;
@@ -78,6 +78,8 @@ ${scripts ? indentTemplateBlock(scripts, 2) : ""}
   </dialog>
   <script>
     (function(){
+      function formatGeneratedAt(value){var date=new Date(value);if(Number.isNaN(date.getTime()))return value;var day=date.getDate();var suffix=day>=11&&day<=13?"th":day%10===1?"st":day%10===2?"nd":day%10===3?"rd":"th";var months=["January","February","March","April","May","June","July","August","September","October","November","December"];var hours=String(date.getHours()).padStart(2,"0");var minutes=String(date.getMinutes()).padStart(2,"0");return day+suffix+" "+months[date.getMonth()]+" "+date.getFullYear()+" at "+hours+":"+minutes;}
+      document.querySelectorAll("[data-generated-at]").forEach(function(item){item.textContent="Generated "+formatGeneratedAt(item.getAttribute("data-generated-at"))+".";});
       var root=document.documentElement;
       var themeButton=document.querySelector(".theme-toggle");
       function updateThemeButton(){var dark=root.dataset.theme==="dark";themeButton.textContent=dark?"☀":"☾";themeButton.title=dark?"Use light mode":"Use dark mode";}

package/dist/reportHtml.js.map

@@ -1 +1 @@
-{"version":3,"file":"reportHtml.js","sourceRoot":"","sources":["../src/reportHtml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EACL,oBAAoB,GAErB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AAWrC,MAAM,UAAU,cAAc,CAAC,EAC7B,KAAK,EACL,IAAI,EACJ,MAAM,GAAG,EAAE,EACX,OAAO,GAAG,EAAE,EACZ,QAAQ,EACR,QAAQ,GAAG,2BAA2B,EAAE,GACxB;IAChB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG;;;;;WAKJ,IAAI,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAwCH,QAAQ,CAAC,QAAQ;;;;;;;;;;;;;;;;EAgBlC,mBAAmB,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;;;;;EAK1C,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC;EAC5B,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6B/C,CAAC;IAEA,OAAO,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"reportHtml.js","sourceRoot":"","sources":["../src/reportHtml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EACL,oBAAoB,GAErB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AAWrC,MAAM,UAAU,cAAc,CAAC,EAC7B,KAAK,EACL,IAAI,EACJ,MAAM,GAAG,EAAE,EACX,OAAO,GAAG,EAAE,EACZ,QAAQ,EACR,QAAQ,GAAG,2BAA2B,EAAE,GACxB;IAChB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG;;;;;WAKJ,IAAI,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAwCH,QAAQ,CAAC,QAAQ;;;;;;;;;;;;;;;;EAgBlC,mBAAmB,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;;;;;EAK1C,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC;EAC5B,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+B/C,CAAC;IAEA,OAAO,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC"}

package/dist/reportTemplate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reportTemplate.d.ts","sourceRoot":"","sources":["../src/reportTemplate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,eAAe,EACf,UAAU,EAEV,WAAW,EAEX,SAAS,EACT,WAAW,EACX,cAAc,EACd,SAAS,EAET,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;IAC/B,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAwCF,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,WAAW,EAAE,EACpB,OAAO,GAAE,aAAkB,UAe5B"}
+{"version":3,"file":"reportTemplate.d.ts","sourceRoot":"","sources":["../src/reportTemplate.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,eAAe,EACf,UAAU,EAEV,WAAW,EAEX,SAAS,EACT,WAAW,EACX,cAAc,EACd,SAAS,EAET,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;IAC/B,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,CAAC;AAwCF,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,WAAW,EAAE,EACpB,OAAO,GAAE,aAAkB,UAe5B"}

package/dist/reportTemplate.js

@@ -1,4 +1,5 @@
 import { html } from "./html.js";
+import { formatGeneratedAt, renderGeneratedAt } from "./reportDate.js";
 import { renderHtmlPage } from "./reportHtml.js";
 import { screenshotKey } from "./screenshots.js";
 const extensionDefinitions = [
@@ -26,17 +27,18 @@ export function renderHtmlReport(specs, options = {}) {
 }
 function featureReportBody({ specs, options, evidence, sourceLinks, title, }) {
     const documents = allReportDocuments(specs, options);
+    const generatedAt = options.generatedAt ?? new Date().toISOString();
     if (options.layers?.length) {
         return `
 <h1>${renderReportTitle(title, options.repositoryUrl)}</h1>
-<p>Generated ${html(formatGeneratedAt(options.generatedAt))}.</p>
+<p ${renderGeneratedAt(generatedAt)}>Generated ${html(formatGeneratedAt(generatedAt))}.</p>
 ${renderIssues(options.validationIssues ?? [])}
 ${renderLayeredDocuments(documents, options, evidence, sourceLinks)}
 `;
     }
     return `
 <h1>${renderReportTitle(title, options.repositoryUrl)}</h1>
-<p>Generated ${html(formatGeneratedAt(options.generatedAt))}.</p>
+<p ${renderGeneratedAt(generatedAt)}>Generated ${html(formatGeneratedAt(generatedAt))}.</p>
 ${renderOpenQuestionsAndAssumptions(documents, sourceLinks)}
 ${renderJourneyOverview(specs, options.coverage, sourceLinks)}
 ${renderIssues(options.validationIssues ?? [])}
@@ -84,7 +86,7 @@ function featureReportStyles() {
 .report-navigator{position:fixed;z-index:19;right:12px;top:12px;width:min(320px,calc(100vw - 24px));border:1px solid var(--border);border-radius:10px;background:var(--surface);box-shadow:0 8px 24px rgba(31,35,40,.16)}
 .navigator-trigger{appearance:none;display:flex;align-items:center;width:100%;border:0;border-radius:10px;background:transparent;color:var(--fg);cursor:pointer;font:inherit;padding:9px 12px;text-align:left}.navigator-trigger:hover{background:var(--surface-hover)}.navigator-trigger:focus-visible,.navigator-link:focus-visible,.navigator-scenarios:focus-visible{outline:2px solid var(--link);outline-offset:-2px}
 .navigator-current{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-size:13px;font-weight:650}
-.navigator-menu{display:none;border-top:1px solid var(--border);padding:10px}.report-navigator[data-open="true"] .navigator-menu{display:block}
+.navigator-menu{display:none;border-top:1px solid var(--border);padding:10px}.report-navigator[data-open="true"] .navigator-menu{display:block}.navigator-search{width:100%;border:1px solid var(--border);border-radius:6px;background:var(--surface);color:var(--fg);font:inherit;font-size:13px;padding:6px 8px;margin-bottom:8px}.navigator-search:focus-visible{outline:2px solid var(--link);outline-offset:1px}.navigator-no-results{color:var(--muted);font-size:13px;padding:8px}
 .navigator-links{max-height:calc(100vh - 100px);overflow:auto;padding:2px}.navigator-layer{margin:6px 0 2px}.navigator-row{display:flex;align-items:center;gap:4px}.navigator-link{appearance:none;display:flex;align-items:center;gap:7px;width:100%;min-width:0;border:0;border-radius:5px;background:transparent;color:var(--fg);cursor:pointer;font:inherit;font-size:13px;padding:6px 8px;text-align:left}.navigator-link:hover,.navigator-scenarios:hover{background:var(--surface-hover)}.navigator-link[aria-current="location"]{background:var(--surface-muted);box-shadow:inset 3px 0 var(--link);font-weight:650}.navigator-toggle-state{flex:0 0 auto;width:13px;color:var(--muted);font-size:10px;text-align:center}.navigator-link[aria-pressed="true"]>.navigator-toggle-state::before{content:"●"}.navigator-link[aria-pressed="false"]>.navigator-toggle-state::before{content:"○"}.navigator-link-label{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.navigator-document{padding-left:22px;color:var(--muted)}.navigator-document[aria-current="location"]{color:var(--fg)}.navigator-scenarios{appearance:none;flex:0 0 auto;border:1px solid var(--border);border-radius:999px;background:transparent;color:var(--muted);cursor:pointer;font:inherit;font-size:11px;padding:3px 7px}.navigator-scenarios[aria-pressed="true"]{background:var(--surface-muted);color:var(--fg)}
 .feature-policy{display:flex;gap:8px;flex-wrap:wrap;margin:-4px 0 12px}.feature-policy .badge{display:inline-flex;gap:5px;align-items:center}
 .scenario{border:1px solid var(--border);border-radius:8px;margin:12px 0;background:var(--surface)}
@@ -192,7 +194,10 @@ function initializeReportNavigator() {
   if (!(navigator instanceof HTMLElement)) return;
   const trigger = navigator.querySelector("[data-navigator-trigger]");
   const currentLabel = navigator.querySelector("[data-navigator-current]");
+  const search = navigator.querySelector("[data-navigator-search]");
+  const noResults = navigator.querySelector("[data-navigator-no-results]");
   const entries = Array.from(navigator.querySelectorAll("[data-navigator-target]"));
+  const layers = Array.from(navigator.querySelectorAll("[data-navigator-layer]"));
   const scenarioButtons = Array.from(navigator.querySelectorAll("[data-navigator-scenarios-target]"));
   const targets = entries
     .map((entry) => document.getElementById(entry.dataset.navigatorTarget))
@@ -205,6 +210,25 @@ function initializeReportNavigator() {
     trigger?.setAttribute("aria-expanded", String(open));
   }
 
+  function updateSearch() {
+    const query = search instanceof HTMLInputElement ? search.value.trim().toLocaleLowerCase() : "";
+    let matches = 0;
+    layers.forEach((layer) => {
+      const layerEntry = layer.querySelector("[data-navigator-layer-target]");
+      const layerMatches = layerEntry?.textContent?.trim().toLocaleLowerCase().includes(query) ?? false;
+      let layerHasMatch = false;
+      layer.querySelectorAll(".navigator-row").forEach((row) => {
+        const entry = row.querySelector("[data-navigator-target]");
+        const matchesEntry = layerMatches || entry?.textContent?.trim().toLocaleLowerCase().includes(query) || false;
+        row.hidden = !matchesEntry;
+        if (matchesEntry) layerHasMatch = true;
+      });
+      layer.hidden = !layerHasMatch;
+      if (layerHasMatch) matches += 1;
+    });
+    if (noResults instanceof HTMLElement) noResults.hidden = matches > 0;
+  }
+
   function updateActiveSection() {
     frame = 0;
     const visible = targets.filter((target) => target.getClientRects().length > 0);
@@ -256,6 +280,7 @@ function initializeReportNavigator() {
   }
 
   trigger?.addEventListener("click", () => setMenuOpen(navigator.dataset.open !== "true"));
+  search?.addEventListener("input", updateSearch);
   entries.forEach((entry, index) => entry.addEventListener("click", (event) => {
     event.preventDefault();
     toggleAndJumpTo(index);
@@ -289,6 +314,7 @@ function initializeReportNavigator() {
   });
   document.addEventListener("toggle", requestActiveUpdate, true);
   updateActiveSection();
+  updateSearch();
 }
 document.addEventListener("DOMContentLoaded", initializeReportNavigator);
 ${closeTag}
@@ -328,40 +354,6 @@ function renderReportTitle(title, repositoryUrl) {
     }
     return `<a ${attributes}>${html(title)}</a>`;
 }
-function formatGeneratedAt(value) {
-    const date = value ? new Date(value) : new Date();
-    if (Number.isNaN(date.getTime()))
-        return value ?? "";
-    const day = date.getDate();
-    const month = [
-        "January",
-        "February",
-        "March",
-        "April",
-        "May",
-        "June",
-        "July",
-        "August",
-        "September",
-        "October",
-        "November",
-        "December",
-    ][date.getMonth()];
-    const hours = String(date.getHours()).padStart(2, "0");
-    const minutes = String(date.getMinutes()).padStart(2, "0");
-    return `${day}${ordinalSuffix(day)} ${month} ${date.getFullYear()} at ${hours}:${minutes}`;
-}
-function ordinalSuffix(day) {
-    if (day >= 11 && day <= 13)
-        return "th";
-    if (day % 10 === 1)
-        return "st";
-    if (day % 10 === 2)
-        return "nd";
-    if (day % 10 === 3)
-        return "rd";
-    return "th";
-}
 function renderLayeredDocuments(documents, options, evidence, sourceLinks) {
     const configured = options.layers ?? [];
     const configuredIds = new Set(configured.map((layer) => layer.id));
@@ -389,8 +381,8 @@ function renderLayeredDocuments(documents, options, evidence, sourceLinks) {
 }
 function renderReportNavigator(layers) {
     const entries = layers
-        .map((layer) => `<div class="navigator-layer">
-    <div class="navigator-row">${renderNavigatorLink(`layer-${layer.id}`, layer.title, "navigator-layer-link")}</div>
+        .map((layer) => `<div class="navigator-layer" data-navigator-layer>
+    <div class="navigator-row">${renderNavigatorLink(`layer-${layer.id}`, layer.title, "navigator-layer-link", true)}</div>
     ${layer.documents
         .map((document) => `<div class="navigator-row">${renderNavigatorLink(document.frontmatter.id.toLowerCase(), document.title, "navigator-document")}${renderNavigatorScenarioButton(document)}</div>`)
         .join("")}
@@ -402,12 +394,15 @@ function renderReportNavigator(layers) {
     <span class="navigator-current" data-navigator-current>${html(firstTitle)}</span>
   </button>
   <div class="navigator-menu">
+    <input class="navigator-search" type="search" data-navigator-search aria-label="Search report navigation" placeholder="Search context" autocomplete="off">
     <div class="navigator-links">${entries}</div>
+    <div class="navigator-no-results" data-navigator-no-results hidden>No matching context</div>
   </div>
 </nav>`;
 }
-function renderNavigatorLink(id, title, className) {
-    return `<button class="navigator-link ${className}" type="button" data-navigator-target="${html(id)}" aria-pressed="false"><span class="navigator-toggle-state" aria-hidden="true"></span><span class="navigator-link-label">${html(title)}</span></button>`;
+function renderNavigatorLink(id, title, className, layer = false) {
+    const targetAttribute = layer ? " data-navigator-layer-target" : "";
+    return `<button class="navigator-link ${className}" type="button" data-navigator-target="${html(id)}"${targetAttribute} aria-pressed="false"><span class="navigator-toggle-state" aria-hidden="true"></span><span class="navigator-link-label">${html(title)}</span></button>`;
 }
 function renderNavigatorScenarioButton(document) {
     if (document.kind !== "feature" && document.kind !== undefined)