niceeval 0.12.2-canary.31 → 0.13.0

package/dist/report/execution/paths.cjs

@@ -0,0 +1,182 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateReportRoute = validateReportRoute;
+exports.validateParameterKey = validateParameterKey;
+exports.validateDownloadPath = validateDownloadPath;
+exports.routeWithParameterKey = routeWithParameterKey;
+exports.staticPathForRoute = staticPathForRoute;
+exports.staticPathForDownload = staticPathForDownload;
+exports.hostStaticPath = hostStaticPath;
+exports.staticPathConflicts = staticPathConflicts;
+const SEGMENT_PATTERN = /^[a-z0-9][a-z0-9._~-]*$/;
+const WINDOWS_DEVICE = /^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\..*)?$/i;
+const encoder = new TextEncoder();
+function validateReportRoute(value) {
+    if (value === "/")
+        return undefined;
+    if (!value.startsWith("/"))
+        return invalid(value, "route", "a route must be absolute");
+    const segments = value.slice(1).split("/");
+    return validateSegments(value, "route", segments, { allowMany: true });
+}
+function validateParameterKey(value) {
+    return validateSegments(value, "parameter-key", [value], { allowMany: false });
+}
+function validateDownloadPath(value) {
+    if (value.startsWith("/"))
+        return invalid(value, "download", "a download path must be relative");
+    return validateSegments(value, "download", value.split("/"), { allowMany: true });
+}
+function routeWithParameterKey(path, key) {
+    return path === "/" ? `/${key}` : `${path}/${key}`;
+}
+function staticPathForRoute(route) {
+    const routeSegments = route === "/" ? [] : route.slice(1).split("/");
+    const segments = [...routeSegments, "index.html"];
+    return Object.freeze({
+        owner: "route",
+        source: route,
+        segments: Object.freeze(segments),
+        posix: segments.join("/"),
+    });
+}
+function staticPathForDownload(path) {
+    const segments = ["downloads", ...path.split("/")];
+    return Object.freeze({
+        owner: "download",
+        source: path,
+        segments: Object.freeze(segments),
+        posix: segments.join("/"),
+    });
+}
+/** Host-owned files participate in exactly the same collision analysis. */
+function hostStaticPath(path) {
+    const segments = path.split("/");
+    return Object.freeze({
+        owner: "host",
+        source: path,
+        segments: Object.freeze(segments),
+        posix: path,
+    });
+}
+function staticPathConflicts(paths) {
+    const conflicts = [];
+    const emitted = new Set();
+    const exact = new Map();
+    const folded = new Map();
+    const windows = new Map();
+    const trie = newPathTrie();
+    const ordered = [...paths].sort((left, right) => compareUtf8(left.posix, right.posix));
+    for (const path of ordered) {
+        const exactPath = exact.get(path.posix);
+        if (exactPath !== undefined) {
+            addConflict(conflicts, emitted, "exact", exactPath, path);
+        }
+        else {
+            const foldedPath = folded.get(foldedStaticPath(path.segments));
+            if (foldedPath !== undefined) {
+                addConflict(conflicts, emitted, "case-fold", foldedPath, path);
+            }
+            else {
+                const windowsPath = windows.get(windowsStaticPath(path.segments));
+                if (windowsPath !== undefined) {
+                    addConflict(conflicts, emitted, "windows-equivalent", windowsPath, path);
+                }
+            }
+        }
+        let node = trie;
+        for (const segment of path.segments) {
+            for (const ancestor of node.terminals.values()) {
+                addConflict(conflicts, emitted, "file-directory-prefix", ancestor, path);
+            }
+            let child = node.children.get(segment);
+            if (child === undefined) {
+                child = newPathTrie();
+                node.children.set(segment, child);
+            }
+            node = child;
+        }
+        for (const descendant of descendantTerminals(node)) {
+            addConflict(conflicts, emitted, "file-directory-prefix", path, descendant);
+        }
+        node.terminals.set(pathSourceKey(path), path);
+        exact.set(path.posix, exactPath ?? path);
+        folded.set(foldedStaticPath(path.segments), folded.get(foldedStaticPath(path.segments)) ?? path);
+        windows.set(windowsStaticPath(path.segments), windows.get(windowsStaticPath(path.segments)) ?? path);
+    }
+    return Object.freeze(conflicts);
+}
+function validateSegments(value, kind, segments, options) {
+    if (encoder.encode(value).byteLength > 1024) {
+        return invalid(value, kind, "a path may contain at most 1,024 UTF-8 bytes");
+    }
+    if (value.includes("%") || value.includes("?") || value.includes("#") || value.includes("\\")) {
+        return invalid(value, kind, "a path cannot contain percent, query, fragment, or backslash syntax");
+    }
+    if (segments.length === 0 || (options.allowMany && segments.length > 32)) {
+        return invalid(value, kind, "a path needs from one through 32 segments");
+    }
+    for (const segment of segments) {
+        if (segment.length === 0 || segment === "." || segment === "..") {
+            return invalid(value, kind, "a path cannot contain an empty, dot, or dot-dot segment");
+        }
+        if (encoder.encode(segment).byteLength > 128) {
+            return invalid(value, kind, "a path segment may contain at most 128 UTF-8 bytes");
+        }
+        if (!SEGMENT_PATTERN.test(segment)) {
+            return invalid(value, kind, "a path segment must match [a-z0-9][a-z0-9._~-]*");
+        }
+        if (segment.endsWith(".") || segment.endsWith(" ")) {
+            return invalid(value, kind, "a path segment cannot end in dot or space");
+        }
+        if (WINDOWS_DEVICE.test(segment)) {
+            return invalid(value, kind, "a path segment cannot be a Windows device name");
+        }
+    }
+    return undefined;
+}
+function newPathTrie() {
+    return { children: new Map(), terminals: new Map() };
+}
+function* descendantTerminals(node) {
+    for (const child of node.children.values()) {
+        yield* child.terminals.values();
+        yield* descendantTerminals(child);
+    }
+}
+function addConflict(conflicts, emitted, kind, left, right) {
+    const leftKey = pathSourceKey(left);
+    const rightKey = pathSourceKey(right);
+    const pair = compareUtf8(leftKey, rightKey) <= 0 ? `${leftKey}\u0001${rightKey}` : `${rightKey}\u0001${leftKey}`;
+    const key = `${kind}\u0000${pair}`;
+    if (emitted.has(key))
+        return;
+    emitted.add(key);
+    conflicts.push(Object.freeze({ kind, left, right }));
+}
+function pathSourceKey(path) {
+    return `${path.owner}\u0000${path.source}`;
+}
+function foldedStaticPath(segments) {
+    return segments.join("/").toLowerCase();
+}
+function windowsStaticPath(segments) {
+    return segments.map((segment) => segment.replace(/[. ]+$/u, "").toLowerCase()).join("/");
+}
+function invalid(value, kind, reason) {
+    return Object.freeze({ code: "report-path-invalid", value, kind, reason });
+}
+function compareUtf8(left, right) {
+    if (left === right)
+        return 0;
+    const leftBytes = encoder.encode(left);
+    const rightBytes = encoder.encode(right);
+    const length = Math.min(leftBytes.length, rightBytes.length);
+    for (let index = 0; index < length; index += 1) {
+        const delta = leftBytes[index] - rightBytes[index];
+        if (delta !== 0)
+            return delta;
+    }
+    return leftBytes.length - rightBytes.length;
+}
+//# sourceMappingURL=paths.cjs.map

package/dist/report/execution/paths.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["paths.ts"],"names":[],"mappings":"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","sourcesContent":["/** Route and download validation is pure so every host target shares one collision set. */\nexport interface ReportPathInvalid {\n    readonly code: \"report-path-invalid\";\n    readonly value: string;\n    readonly kind: \"route\" | \"parameter-key\" | \"download\";\n    readonly reason: string;\n}\nexport interface ReportStaticPath {\n    readonly owner: \"route\" | \"download\" | \"host\";\n    readonly source: string;\n    readonly segments: readonly string[];\n    readonly posix: string;\n}\nexport interface ReportStaticPathConflict {\n    readonly kind: \"exact\" | \"case-fold\" | \"windows-equivalent\" | \"file-directory-prefix\";\n    readonly left: ReportStaticPath;\n    readonly right: ReportStaticPath;\n}\nconst SEGMENT_PATTERN = /^[a-z0-9][a-z0-9._~-]*$/;\nconst WINDOWS_DEVICE = /^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\\..*)?$/i;\nconst encoder = new TextEncoder();\nexport function validateReportRoute(value: string): ReportPathInvalid | undefined {\n    if (value === \"/\")\n        return undefined;\n    if (!value.startsWith(\"/\"))\n        return invalid(value, \"route\", \"a route must be absolute\");\n    const segments = value.slice(1).split(\"/\");\n    return validateSegments(value, \"route\", segments, { allowMany: true });\n}\nexport function validateParameterKey(value: string): ReportPathInvalid | undefined {\n    return validateSegments(value, \"parameter-key\", [value], { allowMany: false });\n}\nexport function validateDownloadPath(value: string): ReportPathInvalid | undefined {\n    if (value.startsWith(\"/\"))\n        return invalid(value, \"download\", \"a download path must be relative\");\n    return validateSegments(value, \"download\", value.split(\"/\"), { allowMany: true });\n}\nexport function routeWithParameterKey(path: string, key: string): string {\n    return path === \"/\" ? `/${key}` : `${path}/${key}`;\n}\nexport function staticPathForRoute(route: string): ReportStaticPath {\n    const routeSegments = route === \"/\" ? [] : route.slice(1).split(\"/\");\n    const segments = [...routeSegments, \"index.html\"];\n    return Object.freeze({\n        owner: \"route\" as const,\n        source: route,\n        segments: Object.freeze(segments),\n        posix: segments.join(\"/\"),\n    });\n}\nexport function staticPathForDownload(path: string): ReportStaticPath {\n    const segments = [\"downloads\", ...path.split(\"/\")];\n    return Object.freeze({\n        owner: \"download\" as const,\n        source: path,\n        segments: Object.freeze(segments),\n        posix: segments.join(\"/\"),\n    });\n}\n/** Host-owned files participate in exactly the same collision analysis. */\nexport function hostStaticPath(path: string): ReportStaticPath {\n    const segments = path.split(\"/\");\n    return Object.freeze({\n        owner: \"host\" as const,\n        source: path,\n        segments: Object.freeze(segments),\n        posix: path,\n    });\n}\nexport function staticPathConflicts(paths: readonly ReportStaticPath[]): readonly ReportStaticPathConflict[] {\n    const conflicts: ReportStaticPathConflict[] = [];\n    const emitted = new Set<string>();\n    const exact = new Map<string, ReportStaticPath>();\n    const folded = new Map<string, ReportStaticPath>();\n    const windows = new Map<string, ReportStaticPath>();\n    const trie = newPathTrie();\n    const ordered = [...paths].sort((left, right) => compareUtf8(left.posix, right.posix));\n    for (const path of ordered) {\n        const exactPath = exact.get(path.posix);\n        if (exactPath !== undefined) {\n            addConflict(conflicts, emitted, \"exact\", exactPath, path);\n        }\n        else {\n            const foldedPath = folded.get(foldedStaticPath(path.segments));\n            if (foldedPath !== undefined) {\n                addConflict(conflicts, emitted, \"case-fold\", foldedPath, path);\n            }\n            else {\n                const windowsPath = windows.get(windowsStaticPath(path.segments));\n                if (windowsPath !== undefined) {\n                    addConflict(conflicts, emitted, \"windows-equivalent\", windowsPath, path);\n                }\n            }\n        }\n        let node = trie;\n        for (const segment of path.segments) {\n            for (const ancestor of node.terminals.values()) {\n                addConflict(conflicts, emitted, \"file-directory-prefix\", ancestor, path);\n            }\n            let child = node.children.get(segment);\n            if (child === undefined) {\n                child = newPathTrie();\n                node.children.set(segment, child);\n            }\n            node = child;\n        }\n        for (const descendant of descendantTerminals(node)) {\n            addConflict(conflicts, emitted, \"file-directory-prefix\", path, descendant);\n        }\n        node.terminals.set(pathSourceKey(path), path);\n        exact.set(path.posix, exactPath ?? path);\n        folded.set(foldedStaticPath(path.segments), folded.get(foldedStaticPath(path.segments)) ?? path);\n        windows.set(windowsStaticPath(path.segments), windows.get(windowsStaticPath(path.segments)) ?? path);\n    }\n    return Object.freeze(conflicts);\n}\nfunction validateSegments(value: string, kind: ReportPathInvalid[\"kind\"], segments: readonly string[], options: {\n    readonly allowMany: boolean;\n}): ReportPathInvalid | undefined {\n    if (encoder.encode(value).byteLength > 1024) {\n        return invalid(value, kind, \"a path may contain at most 1,024 UTF-8 bytes\");\n    }\n    if (value.includes(\"%\") || value.includes(\"?\") || value.includes(\"#\") || value.includes(\"\\\\\")) {\n        return invalid(value, kind, \"a path cannot contain percent, query, fragment, or backslash syntax\");\n    }\n    if (segments.length === 0 || (options.allowMany && segments.length > 32)) {\n        return invalid(value, kind, \"a path needs from one through 32 segments\");\n    }\n    for (const segment of segments) {\n        if (segment.length === 0 || segment === \".\" || segment === \"..\") {\n            return invalid(value, kind, \"a path cannot contain an empty, dot, or dot-dot segment\");\n        }\n        if (encoder.encode(segment).byteLength > 128) {\n            return invalid(value, kind, \"a path segment may contain at most 128 UTF-8 bytes\");\n        }\n        if (!SEGMENT_PATTERN.test(segment)) {\n            return invalid(value, kind, \"a path segment must match [a-z0-9][a-z0-9._~-]*\");\n        }\n        if (segment.endsWith(\".\") || segment.endsWith(\" \")) {\n            return invalid(value, kind, \"a path segment cannot end in dot or space\");\n        }\n        if (WINDOWS_DEVICE.test(segment)) {\n            return invalid(value, kind, \"a path segment cannot be a Windows device name\");\n        }\n    }\n    return undefined;\n}\ninterface PathTrie {\n    readonly children: Map<string, PathTrie>;\n    readonly terminals: Map<string, ReportStaticPath>;\n}\nfunction newPathTrie(): PathTrie {\n    return { children: new Map(), terminals: new Map() };\n}\nfunction* descendantTerminals(node: PathTrie): Iterable<ReportStaticPath> {\n    for (const child of node.children.values()) {\n        yield* child.terminals.values();\n        yield* descendantTerminals(child);\n    }\n}\nfunction addConflict(conflicts: ReportStaticPathConflict[], emitted: Set<string>, kind: ReportStaticPathConflict[\"kind\"], left: ReportStaticPath, right: ReportStaticPath): void {\n    const leftKey = pathSourceKey(left);\n    const rightKey = pathSourceKey(right);\n    const pair = compareUtf8(leftKey, rightKey) <= 0 ? `${leftKey}\\u0001${rightKey}` : `${rightKey}\\u0001${leftKey}`;\n    const key = `${kind}\\u0000${pair}`;\n    if (emitted.has(key))\n        return;\n    emitted.add(key);\n    conflicts.push(Object.freeze({ kind, left, right }));\n}\nfunction pathSourceKey(path: ReportStaticPath): string {\n    return `${path.owner}\\u0000${path.source}`;\n}\nfunction foldedStaticPath(segments: readonly string[]): string {\n    return segments.join(\"/\").toLowerCase();\n}\nfunction windowsStaticPath(segments: readonly string[]): string {\n    return segments.map((segment) => segment.replace(/[. ]+$/u, \"\").toLowerCase()).join(\"/\");\n}\nfunction invalid(value: string, kind: ReportPathInvalid[\"kind\"], reason: string): ReportPathInvalid {\n    return Object.freeze({ code: \"report-path-invalid\" as const, value, kind, reason });\n}\nfunction compareUtf8(left: string, right: string): number {\n    if (left === right)\n        return 0;\n    const leftBytes = encoder.encode(left);\n    const rightBytes = encoder.encode(right);\n    const length = Math.min(leftBytes.length, rightBytes.length);\n    for (let index = 0; index < length; index += 1) {\n        const delta = leftBytes[index]! - rightBytes[index]!;\n        if (delta !== 0)\n            return delta;\n    }\n    return leftBytes.length - rightBytes.length;\n}\n"]}

package/dist/report/execution/paths.d.cts

@@ -0,0 +1,27 @@
+/** Route and download validation is pure so every host target shares one collision set. */
+export interface ReportPathInvalid {
+    readonly code: "report-path-invalid";
+    readonly value: string;
+    readonly kind: "route" | "parameter-key" | "download";
+    readonly reason: string;
+}
+export interface ReportStaticPath {
+    readonly owner: "route" | "download" | "host";
+    readonly source: string;
+    readonly segments: readonly string[];
+    readonly posix: string;
+}
+export interface ReportStaticPathConflict {
+    readonly kind: "exact" | "case-fold" | "windows-equivalent" | "file-directory-prefix";
+    readonly left: ReportStaticPath;
+    readonly right: ReportStaticPath;
+}
+export declare function validateReportRoute(value: string): ReportPathInvalid | undefined;
+export declare function validateParameterKey(value: string): ReportPathInvalid | undefined;
+export declare function validateDownloadPath(value: string): ReportPathInvalid | undefined;
+export declare function routeWithParameterKey(path: string, key: string): string;
+export declare function staticPathForRoute(route: string): ReportStaticPath;
+export declare function staticPathForDownload(path: string): ReportStaticPath;
+/** Host-owned files participate in exactly the same collision analysis. */
+export declare function hostStaticPath(path: string): ReportStaticPath;
+export declare function staticPathConflicts(paths: readonly ReportStaticPath[]): readonly ReportStaticPathConflict[];

package/dist/report/execution/paths.d.mts

@@ -0,0 +1,27 @@
+/** Route and download validation is pure so every host target shares one collision set. */
+export interface ReportPathInvalid {
+    readonly code: "report-path-invalid";
+    readonly value: string;
+    readonly kind: "route" | "parameter-key" | "download";
+    readonly reason: string;
+}
+export interface ReportStaticPath {
+    readonly owner: "route" | "download" | "host";
+    readonly source: string;
+    readonly segments: readonly string[];
+    readonly posix: string;
+}
+export interface ReportStaticPathConflict {
+    readonly kind: "exact" | "case-fold" | "windows-equivalent" | "file-directory-prefix";
+    readonly left: ReportStaticPath;
+    readonly right: ReportStaticPath;
+}
+export declare function validateReportRoute(value: string): ReportPathInvalid | undefined;
+export declare function validateParameterKey(value: string): ReportPathInvalid | undefined;
+export declare function validateDownloadPath(value: string): ReportPathInvalid | undefined;
+export declare function routeWithParameterKey(path: string, key: string): string;
+export declare function staticPathForRoute(route: string): ReportStaticPath;
+export declare function staticPathForDownload(path: string): ReportStaticPath;
+/** Host-owned files participate in exactly the same collision analysis. */
+export declare function hostStaticPath(path: string): ReportStaticPath;
+export declare function staticPathConflicts(paths: readonly ReportStaticPath[]): readonly ReportStaticPathConflict[];

package/dist/report/execution/paths.d.ts

@@ -0,0 +1,27 @@
+/** Route and download validation is pure so every host target shares one collision set. */
+export interface ReportPathInvalid {
+    readonly code: "report-path-invalid";
+    readonly value: string;
+    readonly kind: "route" | "parameter-key" | "download";
+    readonly reason: string;
+}
+export interface ReportStaticPath {
+    readonly owner: "route" | "download" | "host";
+    readonly source: string;
+    readonly segments: readonly string[];
+    readonly posix: string;
+}
+export interface ReportStaticPathConflict {
+    readonly kind: "exact" | "case-fold" | "windows-equivalent" | "file-directory-prefix";
+    readonly left: ReportStaticPath;
+    readonly right: ReportStaticPath;
+}
+export declare function validateReportRoute(value: string): ReportPathInvalid | undefined;
+export declare function validateParameterKey(value: string): ReportPathInvalid | undefined;
+export declare function validateDownloadPath(value: string): ReportPathInvalid | undefined;
+export declare function routeWithParameterKey(path: string, key: string): string;
+export declare function staticPathForRoute(route: string): ReportStaticPath;
+export declare function staticPathForDownload(path: string): ReportStaticPath;
+/** Host-owned files participate in exactly the same collision analysis. */
+export declare function hostStaticPath(path: string): ReportStaticPath;
+export declare function staticPathConflicts(paths: readonly ReportStaticPath[]): readonly ReportStaticPathConflict[];

package/dist/report/execution/paths.js

@@ -0,0 +1,20 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./paths.cjs");
+const __niceevalExport0 = __niceevalCanonical["hostStaticPath"];
+export { __niceevalExport0 as hostStaticPath };
+const __niceevalExport1 = __niceevalCanonical["routeWithParameterKey"];
+export { __niceevalExport1 as routeWithParameterKey };
+const __niceevalExport2 = __niceevalCanonical["staticPathConflicts"];
+export { __niceevalExport2 as staticPathConflicts };
+const __niceevalExport3 = __niceevalCanonical["staticPathForDownload"];
+export { __niceevalExport3 as staticPathForDownload };
+const __niceevalExport4 = __niceevalCanonical["staticPathForRoute"];
+export { __niceevalExport4 as staticPathForRoute };
+const __niceevalExport5 = __niceevalCanonical["validateDownloadPath"];
+export { __niceevalExport5 as validateDownloadPath };
+const __niceevalExport6 = __niceevalCanonical["validateParameterKey"];
+export { __niceevalExport6 as validateParameterKey };
+const __niceevalExport7 = __niceevalCanonical["validateReportRoute"];
+export { __niceevalExport7 as validateReportRoute };
+//# sourceMappingURL=paths.js.map

package/dist/report/execution/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sources":[],"names":[],"mappings":""}

package/dist/report/extension/assets.cjs

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertRendererAssets = assertRendererAssets;
+exports.collectRendererAssetDeclarations = collectRendererAssetDeclarations;
+exports.materializeRendererAssets = materializeRendererAssets;
+/** Renderer asset declarations and Host-owned materialization helpers. */
+const node_crypto_1 = require("node:crypto");
+const node_path_1 = require("node:path");
+const node_url_1 = require("node:url");
+const tree_ts_1 = require("../definition/tree.cjs");
+const meta_ts_1 = require("./meta.cjs");
+const ASSET_EXTENSIONS = {
+    styles: new Set([".css"]),
+    scripts: new Set([".js", ".mjs"]),
+};
+function assertLocalAssetPath(path, where) {
+    const segments = path.split(/[\\/]+/u);
+    if (path.startsWith("/") || /^[A-Za-z]:/.test(path) || path.startsWith("~") || segments.includes("..")) {
+        throw new TypeError(`defineRenderer ${where} ${JSON.stringify(path)} must be a local relative path without "..", an absolute path, or "~".`);
+    }
+    if (/^https?:\/\//iu.test(path) || path.startsWith("//")) {
+        throw new TypeError(`defineRenderer ${where} ${JSON.stringify(path)} cannot be an external URL; declare third-party scripts in Report head instead.`);
+    }
+}
+function assertAssetPath(path, field, index) {
+    assertLocalAssetPath(path, `assets.${field}[${index}]`);
+    const extension = (0, node_path_1.extname)(path).toLowerCase();
+    if (!ASSET_EXTENSIONS[field].has(extension)) {
+        throw new TypeError(`defineRenderer assets.${field}[${index}] ${JSON.stringify(path)} has unsupported extension ${JSON.stringify(extension)}.`);
+    }
+}
+/** Validates closed local asset paths at renderer-definition time. */
+function assertRendererAssets(assets, label = "defineRenderer") {
+    if (assets === undefined)
+        return;
+    if (typeof assets !== "object" || assets === null || Array.isArray(assets)) {
+        throw new TypeError(`${label} assets must be { styles?: string[], scripts?: string[] }`);
+    }
+    for (const field of ["styles", "scripts"]) {
+        const paths = assets[field];
+        if (paths === undefined)
+            continue;
+        if (!Array.isArray(paths))
+            throw new TypeError(`${label} assets.${field} must be an array of local paths`);
+        paths.forEach((path, index) => {
+            if (typeof path !== "string" || path.length === 0) {
+                throw new TypeError(`${label} assets.${field}[${index}] must be a non-empty local path`);
+            }
+            assertAssetPath(path, field, index);
+        });
+    }
+}
+const REACT_ELEMENT_MARKERS = new Set([
+    Symbol.for("react.element"),
+    Symbol.for("react.transitional.element"),
+]);
+function isReportElement(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return false;
+    const element = value;
+    return typeof element.$$typeof === "symbol" && REACT_ELEMENT_MARKERS.has(element.$$typeof) &&
+        typeof element.props === "object" && element.props !== null;
+}
+/** Collects assets from the resolved standard React tree in declaration order. */
+function collectRendererAssetDeclarations(tree) {
+    const declarations = [];
+    const visit = (node) => {
+        if (node === null || node === undefined || typeof node === "boolean" ||
+            typeof node === "string" || typeof node === "number" || typeof node === "bigint") {
+            return;
+        }
+        if (Array.isArray(node)) {
+            for (const child of node)
+                visit(child);
+            return;
+        }
+        if (!isReportElement(node))
+            return;
+        const meta = (0, meta_ts_1.rendererMetaOf)(node.type);
+        if (meta !== undefined && (meta.styles.length > 0 || meta.scripts.length > 0)) {
+            declarations.push(meta);
+        }
+        if (node.type === tree_ts_1.Fragment || node.props.children !== undefined) {
+            visit(node.props.children);
+        }
+    };
+    visit(tree);
+    return Object.freeze(declarations);
+}
+function resolveAssetPath(moduleUrl, relativePath) {
+    const base = moduleUrl.startsWith("file:") ? (0, node_path_1.dirname)((0, node_url_1.fileURLToPath)(moduleUrl)) : (0, node_path_1.dirname)(moduleUrl);
+    return (0, node_path_1.resolve)(base, relativePath);
+}
+function contentHash(content) {
+    return (0, node_crypto_1.createHash)("sha256").update(content).digest("hex");
+}
+/**
+ * Materializes closed renderer asset declarations.  The Host supplies file IO
+ * so author code never gains a filesystem capability or executable callback.
+ */
+async function materializeRendererAssets(declarations, readFile) {
+    const styles = [];
+    const scripts = [];
+    const assetsByHash = new Map();
+    const contentsByPath = new Map();
+    const readCached = async (absolutePath) => {
+        const cached = contentsByPath.get(absolutePath);
+        if (cached !== undefined)
+            return cached;
+        const content = await readFile(absolutePath);
+        contentsByPath.set(absolutePath, content);
+        return content;
+    };
+    const materialize = async (kind, bucket, moduleUrl, relativePath) => {
+        const absolutePath = resolveAssetPath(moduleUrl, relativePath);
+        const content = await readCached(absolutePath);
+        const extension = (0, node_path_1.extname)(relativePath).toLowerCase() || (kind === "style" ? ".css" : ".js");
+        const hash = contentHash(content);
+        const key = `${kind}:${hash}:${extension}`;
+        let asset = assetsByHash.get(key);
+        if (asset === undefined) {
+            asset = Object.freeze({
+                hash,
+                ext: extension,
+                path: `assets/${hash}${extension}`,
+                kind,
+                content,
+            });
+            assetsByHash.set(key, asset);
+            bucket.push(asset);
+        }
+    };
+    for (const declaration of declarations) {
+        for (const relativePath of declaration.styles) {
+            await materialize("style", styles, declaration.moduleUrl, relativePath);
+        }
+        for (const relativePath of declaration.scripts) {
+            await materialize("script", scripts, declaration.moduleUrl, relativePath);
+        }
+    }
+    return Object.freeze({ styles: Object.freeze(styles), scripts: Object.freeze(scripts) });
+}
+//# sourceMappingURL=assets.cjs.map

package/dist/report/extension/assets.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["assets.ts"],"names":[],"mappings":"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","sourcesContent":["/** Renderer asset declarations and Host-owned materialization helpers. */\nimport { createHash } from \"node:crypto\";\nimport { dirname, extname, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { Fragment, type ReportElement, type ReportNode, } from \"../definition/tree.ts\";\nimport { rendererMetaOf } from \"./meta.ts\";\nimport type { MaterializedRendererAsset, PageRendererAssets, RendererAssetPaths, } from \"./types.ts\";\nconst ASSET_EXTENSIONS = {\n    styles: new Set([\".css\"]),\n    scripts: new Set([\".js\", \".mjs\"]),\n} as const;\nfunction assertLocalAssetPath(path: string, where: string): void {\n    const segments = path.split(/[\\\\/]+/u);\n    if (path.startsWith(\"/\") || /^[A-Za-z]:/.test(path) || path.startsWith(\"~\") || segments.includes(\"..\")) {\n        throw new TypeError(`defineRenderer ${where} ${JSON.stringify(path)} must be a local relative path without \"..\", an absolute path, or \"~\".`);\n    }\n    if (/^https?:\\/\\//iu.test(path) || path.startsWith(\"//\")) {\n        throw new TypeError(`defineRenderer ${where} ${JSON.stringify(path)} cannot be an external URL; declare third-party scripts in Report head instead.`);\n    }\n}\nfunction assertAssetPath(path: string, field: \"styles\" | \"scripts\", index: number): void {\n    assertLocalAssetPath(path, `assets.${field}[${index}]`);\n    const extension = extname(path).toLowerCase();\n    if (!ASSET_EXTENSIONS[field].has(extension as never)) {\n        throw new TypeError(`defineRenderer assets.${field}[${index}] ${JSON.stringify(path)} has unsupported extension ${JSON.stringify(extension)}.`);\n    }\n}\n/** Validates closed local asset paths at renderer-definition time. */\nexport function assertRendererAssets(assets: RendererAssetPaths | undefined, label = \"defineRenderer\"): void {\n    if (assets === undefined)\n        return;\n    if (typeof assets !== \"object\" || assets === null || Array.isArray(assets)) {\n        throw new TypeError(`${label} assets must be { styles?: string[], scripts?: string[] }`);\n    }\n    for (const field of [\"styles\", \"scripts\"] as const) {\n        const paths = assets[field];\n        if (paths === undefined)\n            continue;\n        if (!Array.isArray(paths))\n            throw new TypeError(`${label} assets.${field} must be an array of local paths`);\n        paths.forEach((path, index) => {\n            if (typeof path !== \"string\" || path.length === 0) {\n                throw new TypeError(`${label} assets.${field}[${index}] must be a non-empty local path`);\n            }\n            assertAssetPath(path, field, index);\n        });\n    }\n}\nexport interface RendererAssetDeclaration {\n    readonly moduleUrl: string;\n    readonly styles: readonly string[];\n    readonly scripts: readonly string[];\n}\nconst REACT_ELEMENT_MARKERS = new Set<symbol>([\n    Symbol.for(\"react.element\"),\n    Symbol.for(\"react.transitional.element\"),\n]);\nfunction isReportElement(value: unknown): value is ReportElement {\n    if (typeof value !== \"object\" || value === null || Array.isArray(value))\n        return false;\n    const element = value as Partial<ReportElement>;\n    return typeof element.$$typeof === \"symbol\" && REACT_ELEMENT_MARKERS.has(element.$$typeof) &&\n        typeof element.props === \"object\" && element.props !== null;\n}\n/** Collects assets from the resolved standard React tree in declaration order. */\nexport function collectRendererAssetDeclarations(tree: ReportNode): readonly RendererAssetDeclaration[] {\n    const declarations: RendererAssetDeclaration[] = [];\n    const visit = (node: ReportNode): void => {\n        if (node === null || node === undefined || typeof node === \"boolean\" ||\n            typeof node === \"string\" || typeof node === \"number\" || typeof node === \"bigint\") {\n            return;\n        }\n        if (Array.isArray(node)) {\n            for (const child of node)\n                visit(child);\n            return;\n        }\n        if (!isReportElement(node))\n            return;\n        const meta = rendererMetaOf(node.type);\n        if (meta !== undefined && (meta.styles.length > 0 || meta.scripts.length > 0)) {\n            declarations.push(meta);\n        }\n        if (node.type === Fragment || node.props.children !== undefined) {\n            visit(node.props.children as ReportNode);\n        }\n    };\n    visit(tree);\n    return Object.freeze(declarations);\n}\nfunction resolveAssetPath(moduleUrl: string, relativePath: string): string {\n    const base = moduleUrl.startsWith(\"file:\") ? dirname(fileURLToPath(moduleUrl)) : dirname(moduleUrl);\n    return resolve(base, relativePath);\n}\nfunction contentHash(content: Uint8Array): string {\n    return createHash(\"sha256\").update(content).digest(\"hex\");\n}\n/**\n * Materializes closed renderer asset declarations.  The Host supplies file IO\n * so author code never gains a filesystem capability or executable callback.\n */\nexport async function materializeRendererAssets(declarations: readonly RendererAssetDeclaration[], readFile: (absolutePath: string) => Promise<Uint8Array>): Promise<PageRendererAssets> {\n    const styles: MaterializedRendererAsset[] = [];\n    const scripts: MaterializedRendererAsset[] = [];\n    const assetsByHash = new Map<string, MaterializedRendererAsset>();\n    const contentsByPath = new Map<string, Uint8Array>();\n    const readCached = async (absolutePath: string): Promise<Uint8Array> => {\n        const cached = contentsByPath.get(absolutePath);\n        if (cached !== undefined)\n            return cached;\n        const content = await readFile(absolutePath);\n        contentsByPath.set(absolutePath, content);\n        return content;\n    };\n    const materialize = async (kind: \"style\" | \"script\", bucket: MaterializedRendererAsset[], moduleUrl: string, relativePath: string): Promise<void> => {\n        const absolutePath = resolveAssetPath(moduleUrl, relativePath);\n        const content = await readCached(absolutePath);\n        const extension = extname(relativePath).toLowerCase() || (kind === \"style\" ? \".css\" : \".js\");\n        const hash = contentHash(content);\n        const key = `${kind}:${hash}:${extension}`;\n        let asset = assetsByHash.get(key);\n        if (asset === undefined) {\n            asset = Object.freeze({\n                hash,\n                ext: extension,\n                path: `assets/${hash}${extension}`,\n                kind,\n                content,\n            });\n            assetsByHash.set(key, asset);\n            bucket.push(asset);\n        }\n    };\n    for (const declaration of declarations) {\n        for (const relativePath of declaration.styles) {\n            await materialize(\"style\", styles, declaration.moduleUrl, relativePath);\n        }\n        for (const relativePath of declaration.scripts) {\n            await materialize(\"script\", scripts, declaration.moduleUrl, relativePath);\n        }\n    }\n    return Object.freeze({ styles: Object.freeze(styles), scripts: Object.freeze(scripts) });\n}\n"]}

package/dist/report/extension/assets.d.cts

@@ -0,0 +1,17 @@
+/** Renderer asset declarations and Host-owned materialization helpers. */
+import { type ReportNode } from "../definition/tree.cjs";
+import type { PageRendererAssets, RendererAssetPaths } from "./types.cjs";
+/** Validates closed local asset paths at renderer-definition time. */
+export declare function assertRendererAssets(assets: RendererAssetPaths | undefined, label?: string): void;
+export interface RendererAssetDeclaration {
+    readonly moduleUrl: string;
+    readonly styles: readonly string[];
+    readonly scripts: readonly string[];
+}
+/** Collects assets from the resolved standard React tree in declaration order. */
+export declare function collectRendererAssetDeclarations(tree: ReportNode): readonly RendererAssetDeclaration[];
+/**
+ * Materializes closed renderer asset declarations.  The Host supplies file IO
+ * so author code never gains a filesystem capability or executable callback.
+ */
+export declare function materializeRendererAssets(declarations: readonly RendererAssetDeclaration[], readFile: (absolutePath: string) => Promise<Uint8Array>): Promise<PageRendererAssets>;

package/dist/report/extension/assets.d.mts

@@ -0,0 +1,17 @@
+/** Renderer asset declarations and Host-owned materialization helpers. */
+import { type ReportNode } from "../definition/tree.mjs";
+import type { PageRendererAssets, RendererAssetPaths } from "./types.mjs";
+/** Validates closed local asset paths at renderer-definition time. */
+export declare function assertRendererAssets(assets: RendererAssetPaths | undefined, label?: string): void;
+export interface RendererAssetDeclaration {
+    readonly moduleUrl: string;
+    readonly styles: readonly string[];
+    readonly scripts: readonly string[];
+}
+/** Collects assets from the resolved standard React tree in declaration order. */
+export declare function collectRendererAssetDeclarations(tree: ReportNode): readonly RendererAssetDeclaration[];
+/**
+ * Materializes closed renderer asset declarations.  The Host supplies file IO
+ * so author code never gains a filesystem capability or executable callback.
+ */
+export declare function materializeRendererAssets(declarations: readonly RendererAssetDeclaration[], readFile: (absolutePath: string) => Promise<Uint8Array>): Promise<PageRendererAssets>;

package/dist/report/extension/assets.d.ts

@@ -0,0 +1,17 @@
+/** Renderer asset declarations and Host-owned materialization helpers. */
+import { type ReportNode } from "../definition/tree.js";
+import type { PageRendererAssets, RendererAssetPaths } from "./types.js";
+/** Validates closed local asset paths at renderer-definition time. */
+export declare function assertRendererAssets(assets: RendererAssetPaths | undefined, label?: string): void;
+export interface RendererAssetDeclaration {
+    readonly moduleUrl: string;
+    readonly styles: readonly string[];
+    readonly scripts: readonly string[];
+}
+/** Collects assets from the resolved standard React tree in declaration order. */
+export declare function collectRendererAssetDeclarations(tree: ReportNode): readonly RendererAssetDeclaration[];
+/**
+ * Materializes closed renderer asset declarations.  The Host supplies file IO
+ * so author code never gains a filesystem capability or executable callback.
+ */
+export declare function materializeRendererAssets(declarations: readonly RendererAssetDeclaration[], readFile: (absolutePath: string) => Promise<Uint8Array>): Promise<PageRendererAssets>;

package/dist/report/extension/assets.js

@@ -0,0 +1,10 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./assets.cjs");
+const __niceevalExport0 = __niceevalCanonical["assertRendererAssets"];
+export { __niceevalExport0 as assertRendererAssets };
+const __niceevalExport1 = __niceevalCanonical["collectRendererAssetDeclarations"];
+export { __niceevalExport1 as collectRendererAssetDeclarations };
+const __niceevalExport2 = __niceevalCanonical["materializeRendererAssets"];
+export { __niceevalExport2 as materializeRendererAssets };
+//# sourceMappingURL=assets.js.map

package/dist/report/extension/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sources":[],"names":[],"mappings":""}