niceeval 0.12.2-canary.31 → 0.13.0

package/dist/report/runtime/resolved-page.d.ts

@@ -0,0 +1,133 @@
+import { Effect } from "effect";
+import type * as Scope from "effect/Scope";
+import { type JsonValue, type Sample, type SampleIdentity } from "../../analysis/contracts.js";
+import type { LocalizedText } from "../../shared/types.js";
+/** A closed page has no route back to an author callback or a live Sample. */
+export declare const RESOLVED_PAGE_FORMAT = "niceeval.report.resolved-page/v1";
+export interface ResolvedPageTarget {
+    readonly pageId: string;
+    readonly route: string;
+    /** Parameter identity is data, never a page loader or encoder callback. */
+    readonly params?: JsonValue;
+}
+export interface ResolvedPageTextProjection {
+    readonly locale: string;
+    readonly width: number;
+    readonly text: string;
+}
+export interface ResolvedPageWebProjection {
+    readonly locale: string;
+    readonly html: string;
+}
+/**
+ * A closed download remains a real byte payload until the site builder places
+ * it in a revision file. This boundary takes ownership through a defensive
+ * copy; byte-count limits deliberately remain a site-builder policy.
+ */
+export interface ResolvedPageDownload {
+    readonly id: string;
+    readonly path: string;
+    readonly mediaType: string;
+    /** The exact closed payload that view/static must write unchanged. */
+    readonly bytes: Uint8Array;
+    readonly byteLength: number;
+    readonly sha256?: string;
+}
+/** Download payload supplied by the live page-closure phase. */
+export interface ResolvedPageDownloadOutput {
+    readonly id: string;
+    readonly path: string;
+    readonly mediaType: string;
+    readonly bytes: Uint8Array;
+    readonly sha256?: string;
+}
+/** Closed renderer payloads that belong in a full site revision, not downloads. */
+export type ResolvedPageAssetKind = "style" | "script" | "source" | "diff" | "other";
+export interface ResolvedPageAsset {
+    readonly kind: ResolvedPageAssetKind;
+    /** Canonical POSIX-relative path within the eventual revision. */
+    readonly path: string;
+    readonly mediaType: string;
+    /** The exact closed payload that view/static must write unchanged. */
+    readonly bytes: Uint8Array;
+    readonly byteLength: number;
+    readonly sha256?: string;
+}
+/** Asset payload supplied by the live page-closure phase. */
+export interface ResolvedPageAssetOutput {
+    readonly kind: ResolvedPageAssetKind;
+    readonly path: string;
+    readonly mediaType: string;
+    readonly bytes: Uint8Array;
+    readonly sha256?: string;
+}
+/**
+ * The one closed product of a Page execution. `head` is structured data only;
+ * no React element, generic semantic tree, renderer, or author function may
+ * survive into this value.
+ */
+export interface ResolvedPage {
+    readonly format: typeof RESOLVED_PAGE_FORMAT;
+    readonly target: ResolvedPageTarget;
+    readonly sample: SampleIdentity;
+    readonly title: LocalizedText;
+    readonly head: JsonValue;
+    readonly text: readonly ResolvedPageTextProjection[];
+    readonly web: readonly ResolvedPageWebProjection[];
+    readonly downloads: readonly ResolvedPageDownload[];
+    readonly assets: readonly ResolvedPageAsset[];
+}
+/** The only live capability passed to the page closure phase. */
+export interface LiveResolvedPageContext {
+    readonly sample: Sample;
+    readonly target: ResolvedPageTarget;
+}
+/**
+ * The closure phase owns author/component resolution and must produce both
+ * projections before the enclosing Sample Scope closes. Its return type has no
+ * escape hatch for open component data.
+ */
+export interface ResolvedPageOutput {
+    readonly title: LocalizedText;
+    readonly head?: JsonValue;
+    readonly text: readonly ResolvedPageTextProjection[];
+    readonly web: readonly ResolvedPageWebProjection[];
+    /** Real payloads are closed here rather than discarded into summaries. */
+    readonly downloads?: readonly ResolvedPageDownloadOutput[];
+    /** Renderer assets and Source/Diff payloads remain distinct from downloads. */
+    readonly assets?: readonly ResolvedPageAssetOutput[];
+}
+export interface ResolvePageInput<Rendered, Error, Requirements> {
+    readonly sample: Sample;
+    readonly target: ResolvedPageTarget;
+    /** Already adapted at the public callback boundary. Evaluated exactly once. */
+    readonly render: Effect.Effect<Rendered, Error, Requirements>;
+    /**
+     * Resolves every author component and produces all closed projections. This
+     * operation is evaluated exactly once and receives the live Sample only here.
+     */
+    readonly close: (rendered: Rendered, context: LiveResolvedPageContext) => Effect.Effect<ResolvedPageOutput, Error, Requirements>;
+}
+export interface ResolvedPageClosureError {
+    readonly code: "report-resolved-page-invalid";
+    readonly path: readonly string[];
+    readonly reason: string;
+}
+/**
+ * Runs one Page render and one component-resolution closure while its caller's
+ * Sample Scope is live. The returned object is deliberately data-only, so it
+ * can outlive that Scope without retaining a reader, Promise, Effect Scope, or
+ * callback.
+ */
+export declare function resolvePage<Rendered, Error, Requirements>(input: ResolvePageInput<Rendered, Error, Requirements>): Effect.Effect<ResolvedPage, Error | ResolvedPageClosureError, Requirements | Scope.Scope>;
+/** Finds an already-built terminal projection. It never invokes a renderer. */
+export declare function resolvedPageTextProjection(page: ResolvedPage, input: {
+    readonly locale: string;
+    readonly width: number;
+}): ResolvedPageTextProjection | undefined;
+/** Finds an already-built browser projection. It never invokes a renderer. */
+export declare function resolvedPageWebProjection(page: ResolvedPage, input: {
+    readonly locale: string;
+}): ResolvedPageWebProjection | undefined;
+/** UTF-8 byte ordering is the canonical ordering shared by machine output. */
+export declare function compareUtf8(left: string, right: string): number;

package/dist/report/runtime/resolved-page.js

@@ -0,0 +1,14 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./resolved-page.cjs");
+const __niceevalExport0 = __niceevalCanonical["RESOLVED_PAGE_FORMAT"];
+export { __niceevalExport0 as RESOLVED_PAGE_FORMAT };
+const __niceevalExport1 = __niceevalCanonical["compareUtf8"];
+export { __niceevalExport1 as compareUtf8 };
+const __niceevalExport2 = __niceevalCanonical["resolvePage"];
+export { __niceevalExport2 as resolvePage };
+const __niceevalExport3 = __niceevalCanonical["resolvedPageTextProjection"];
+export { __niceevalExport3 as resolvedPageTextProjection };
+const __niceevalExport4 = __niceevalCanonical["resolvedPageWebProjection"];
+export { __niceevalExport4 as resolvedPageWebProjection };
+//# sourceMappingURL=resolved-page.js.map

package/dist/report/runtime/resolved-page.js.map

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

package/dist/report/runtime/text.cjs

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderResolvedPageText = renderResolvedPageText;
+exports.resolvedPageText = resolvedPageText;
+const resolved_page_ts_1 = require("./resolved-page.cjs");
+/**
+ * Reads one pre-closed terminal projection. This function deliberately has no
+ * Sample, callback, renderer, or Effect dependency.
+ */
+function renderResolvedPageText(page, options) {
+    const projection = (0, resolved_page_ts_1.resolvedPageTextProjection)(page, options);
+    if (projection !== undefined)
+        return projection.text;
+    throw textProjectionMissing(page, options);
+}
+/** A total variant for Host error mapping without exception inspection. */
+function resolvedPageText(page, options) {
+    const projection = (0, resolved_page_ts_1.resolvedPageTextProjection)(page, options);
+    if (projection !== undefined)
+        return Object.freeze({ state: "rendered", text: projection.text });
+    return textProjectionMissing(page, options);
+}
+function textProjectionMissing(page, options) {
+    return Object.freeze({
+        code: "report-text-projection-missing",
+        pageId: page.target.pageId,
+        route: page.target.route,
+        locale: options.locale,
+        width: options.width,
+    });
+}
+//# sourceMappingURL=text.cjs.map

package/dist/report/runtime/text.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["text.ts"],"names":[],"mappings":";;AAkBA,wDAKC;AAED,4CAQC;AAjCD,yDAAoF;AAcpF;;;GAGG;AACH,SAAgB,sBAAsB,CAAC,IAAkB,EAAE,OAAsC;IAC7F,MAAM,UAAU,GAAG,IAAA,6CAA0B,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7D,IAAI,UAAU,KAAK,SAAS;QACxB,OAAO,UAAU,CAAC,IAAI,CAAC;IAC3B,MAAM,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC;AACD,2EAA2E;AAC3E,SAAgB,gBAAgB,CAAC,IAAkB,EAAE,OAAsC;IAIvF,MAAM,UAAU,GAAG,IAAA,6CAA0B,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7D,IAAI,UAAU,KAAK,SAAS;QACxB,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,UAAmB,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IAChF,OAAO,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC;AACD,SAAS,qBAAqB,CAAC,IAAkB,EAAE,OAAsC;IACrF,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,IAAI,EAAE,gCAAyC;QAC/C,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;QAC1B,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;KACvB,CAAC,CAAC;AACP,CAAC","sourcesContent":["import { resolvedPageTextProjection, type ResolvedPage, } from \"./resolved-page.ts\";\nexport interface RenderResolvedPageTextOptions {\n    /** Explicit: a machine or terminal caller must never inherit process locale. */\n    readonly locale: string;\n    /** Explicit: closed terminal output is only reusable at the requested width. */\n    readonly width: number;\n}\nexport interface ResolvedPageTextProjectionMissing {\n    readonly code: \"report-text-projection-missing\";\n    readonly pageId: string;\n    readonly route: string;\n    readonly locale: string;\n    readonly width: number;\n}\n/**\n * Reads one pre-closed terminal projection. This function deliberately has no\n * Sample, callback, renderer, or Effect dependency.\n */\nexport function renderResolvedPageText(page: ResolvedPage, options: RenderResolvedPageTextOptions): string {\n    const projection = resolvedPageTextProjection(page, options);\n    if (projection !== undefined)\n        return projection.text;\n    throw textProjectionMissing(page, options);\n}\n/** A total variant for Host error mapping without exception inspection. */\nexport function resolvedPageText(page: ResolvedPage, options: RenderResolvedPageTextOptions): {\n    readonly state: \"rendered\";\n    readonly text: string;\n} | ResolvedPageTextProjectionMissing {\n    const projection = resolvedPageTextProjection(page, options);\n    if (projection !== undefined)\n        return Object.freeze({ state: \"rendered\" as const, text: projection.text });\n    return textProjectionMissing(page, options);\n}\nfunction textProjectionMissing(page: ResolvedPage, options: RenderResolvedPageTextOptions): ResolvedPageTextProjectionMissing {\n    return Object.freeze({\n        code: \"report-text-projection-missing\" as const,\n        pageId: page.target.pageId,\n        route: page.target.route,\n        locale: options.locale,\n        width: options.width,\n    });\n}\n"]}

package/dist/report/runtime/text.d.cts

@@ -0,0 +1,24 @@
+import { type ResolvedPage } from "./resolved-page.cjs";
+export interface RenderResolvedPageTextOptions {
+    /** Explicit: a machine or terminal caller must never inherit process locale. */
+    readonly locale: string;
+    /** Explicit: closed terminal output is only reusable at the requested width. */
+    readonly width: number;
+}
+export interface ResolvedPageTextProjectionMissing {
+    readonly code: "report-text-projection-missing";
+    readonly pageId: string;
+    readonly route: string;
+    readonly locale: string;
+    readonly width: number;
+}
+/**
+ * Reads one pre-closed terminal projection. This function deliberately has no
+ * Sample, callback, renderer, or Effect dependency.
+ */
+export declare function renderResolvedPageText(page: ResolvedPage, options: RenderResolvedPageTextOptions): string;
+/** A total variant for Host error mapping without exception inspection. */
+export declare function resolvedPageText(page: ResolvedPage, options: RenderResolvedPageTextOptions): {
+    readonly state: "rendered";
+    readonly text: string;
+} | ResolvedPageTextProjectionMissing;

package/dist/report/runtime/text.d.mts

@@ -0,0 +1,24 @@
+import { type ResolvedPage } from "./resolved-page.mjs";
+export interface RenderResolvedPageTextOptions {
+    /** Explicit: a machine or terminal caller must never inherit process locale. */
+    readonly locale: string;
+    /** Explicit: closed terminal output is only reusable at the requested width. */
+    readonly width: number;
+}
+export interface ResolvedPageTextProjectionMissing {
+    readonly code: "report-text-projection-missing";
+    readonly pageId: string;
+    readonly route: string;
+    readonly locale: string;
+    readonly width: number;
+}
+/**
+ * Reads one pre-closed terminal projection. This function deliberately has no
+ * Sample, callback, renderer, or Effect dependency.
+ */
+export declare function renderResolvedPageText(page: ResolvedPage, options: RenderResolvedPageTextOptions): string;
+/** A total variant for Host error mapping without exception inspection. */
+export declare function resolvedPageText(page: ResolvedPage, options: RenderResolvedPageTextOptions): {
+    readonly state: "rendered";
+    readonly text: string;
+} | ResolvedPageTextProjectionMissing;

package/dist/report/runtime/text.d.ts

@@ -0,0 +1,24 @@
+import { type ResolvedPage } from "./resolved-page.js";
+export interface RenderResolvedPageTextOptions {
+    /** Explicit: a machine or terminal caller must never inherit process locale. */
+    readonly locale: string;
+    /** Explicit: closed terminal output is only reusable at the requested width. */
+    readonly width: number;
+}
+export interface ResolvedPageTextProjectionMissing {
+    readonly code: "report-text-projection-missing";
+    readonly pageId: string;
+    readonly route: string;
+    readonly locale: string;
+    readonly width: number;
+}
+/**
+ * Reads one pre-closed terminal projection. This function deliberately has no
+ * Sample, callback, renderer, or Effect dependency.
+ */
+export declare function renderResolvedPageText(page: ResolvedPage, options: RenderResolvedPageTextOptions): string;
+/** A total variant for Host error mapping without exception inspection. */
+export declare function resolvedPageText(page: ResolvedPage, options: RenderResolvedPageTextOptions): {
+    readonly state: "rendered";
+    readonly text: string;
+} | ResolvedPageTextProjectionMissing;

package/dist/report/runtime/text.js

@@ -0,0 +1,8 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./text.cjs");
+const __niceevalExport0 = __niceevalCanonical["renderResolvedPageText"];
+export { __niceevalExport0 as renderResolvedPageText };
+const __niceevalExport1 = __niceevalCanonical["resolvedPageText"];
+export { __niceevalExport1 as resolvedPageText };
+//# sourceMappingURL=text.js.map

package/dist/report/runtime/text.js.map

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

package/dist/report/runtime/web.cjs

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderResolvedPageWeb = renderResolvedPageWeb;
+exports.resolvedPageWeb = resolvedPageWeb;
+const resolved_page_ts_1 = require("./resolved-page.cjs");
+/**
+ * Reads one pre-closed HTML body. view and static receive this exact string;
+ * neither can invoke Analysis or an author component while serving it.
+ */
+function renderResolvedPageWeb(page, options) {
+    const projection = (0, resolved_page_ts_1.resolvedPageWebProjection)(page, options);
+    if (projection !== undefined)
+        return projection.html;
+    throw webProjectionMissing(page, options);
+}
+/** A total variant for Host error mapping without exception inspection. */
+function resolvedPageWeb(page, options) {
+    const projection = (0, resolved_page_ts_1.resolvedPageWebProjection)(page, options);
+    if (projection !== undefined)
+        return Object.freeze({ state: "rendered", html: projection.html });
+    return webProjectionMissing(page, options);
+}
+function webProjectionMissing(page, options) {
+    return Object.freeze({
+        code: "report-web-projection-missing",
+        pageId: page.target.pageId,
+        route: page.target.route,
+        locale: options.locale,
+    });
+}
+//# sourceMappingURL=web.cjs.map

package/dist/report/runtime/web.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["web.ts"],"names":[],"mappings":";;AAeA,sDAKC;AAED,0CAQC;AA9BD,yDAAmF;AAWnF;;;GAGG;AACH,SAAgB,qBAAqB,CAAC,IAAkB,EAAE,OAAqC;IAC3F,MAAM,UAAU,GAAG,IAAA,4CAAyB,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5D,IAAI,UAAU,KAAK,SAAS;QACxB,OAAO,UAAU,CAAC,IAAI,CAAC;IAC3B,MAAM,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC;AACD,2EAA2E;AAC3E,SAAgB,eAAe,CAAC,IAAkB,EAAE,OAAqC;IAIrF,MAAM,UAAU,GAAG,IAAA,4CAAyB,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5D,IAAI,UAAU,KAAK,SAAS;QACxB,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,UAAmB,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IAChF,OAAO,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC;AACD,SAAS,oBAAoB,CAAC,IAAkB,EAAE,OAAqC;IACnF,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,IAAI,EAAE,+BAAwC;QAC9C,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;QAC1B,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM;KACzB,CAAC,CAAC;AACP,CAAC","sourcesContent":["import { resolvedPageWebProjection, type ResolvedPage, } from \"./resolved-page.ts\";\nexport interface RenderResolvedPageWebOptions {\n    /** Explicit: the page resolver closes one web body for each requested locale. */\n    readonly locale: string;\n}\nexport interface ResolvedPageWebProjectionMissing {\n    readonly code: \"report-web-projection-missing\";\n    readonly pageId: string;\n    readonly route: string;\n    readonly locale: string;\n}\n/**\n * Reads one pre-closed HTML body. view and static receive this exact string;\n * neither can invoke Analysis or an author component while serving it.\n */\nexport function renderResolvedPageWeb(page: ResolvedPage, options: RenderResolvedPageWebOptions): string {\n    const projection = resolvedPageWebProjection(page, options);\n    if (projection !== undefined)\n        return projection.html;\n    throw webProjectionMissing(page, options);\n}\n/** A total variant for Host error mapping without exception inspection. */\nexport function resolvedPageWeb(page: ResolvedPage, options: RenderResolvedPageWebOptions): {\n    readonly state: \"rendered\";\n    readonly html: string;\n} | ResolvedPageWebProjectionMissing {\n    const projection = resolvedPageWebProjection(page, options);\n    if (projection !== undefined)\n        return Object.freeze({ state: \"rendered\" as const, html: projection.html });\n    return webProjectionMissing(page, options);\n}\nfunction webProjectionMissing(page: ResolvedPage, options: RenderResolvedPageWebOptions): ResolvedPageWebProjectionMissing {\n    return Object.freeze({\n        code: \"report-web-projection-missing\" as const,\n        pageId: page.target.pageId,\n        route: page.target.route,\n        locale: options.locale,\n    });\n}\n"]}

package/dist/report/runtime/web.d.cts

@@ -0,0 +1,21 @@
+import { type ResolvedPage } from "./resolved-page.cjs";
+export interface RenderResolvedPageWebOptions {
+    /** Explicit: the page resolver closes one web body for each requested locale. */
+    readonly locale: string;
+}
+export interface ResolvedPageWebProjectionMissing {
+    readonly code: "report-web-projection-missing";
+    readonly pageId: string;
+    readonly route: string;
+    readonly locale: string;
+}
+/**
+ * Reads one pre-closed HTML body. view and static receive this exact string;
+ * neither can invoke Analysis or an author component while serving it.
+ */
+export declare function renderResolvedPageWeb(page: ResolvedPage, options: RenderResolvedPageWebOptions): string;
+/** A total variant for Host error mapping without exception inspection. */
+export declare function resolvedPageWeb(page: ResolvedPage, options: RenderResolvedPageWebOptions): {
+    readonly state: "rendered";
+    readonly html: string;
+} | ResolvedPageWebProjectionMissing;

package/dist/report/runtime/web.d.mts

@@ -0,0 +1,21 @@
+import { type ResolvedPage } from "./resolved-page.mjs";
+export interface RenderResolvedPageWebOptions {
+    /** Explicit: the page resolver closes one web body for each requested locale. */
+    readonly locale: string;
+}
+export interface ResolvedPageWebProjectionMissing {
+    readonly code: "report-web-projection-missing";
+    readonly pageId: string;
+    readonly route: string;
+    readonly locale: string;
+}
+/**
+ * Reads one pre-closed HTML body. view and static receive this exact string;
+ * neither can invoke Analysis or an author component while serving it.
+ */
+export declare function renderResolvedPageWeb(page: ResolvedPage, options: RenderResolvedPageWebOptions): string;
+/** A total variant for Host error mapping without exception inspection. */
+export declare function resolvedPageWeb(page: ResolvedPage, options: RenderResolvedPageWebOptions): {
+    readonly state: "rendered";
+    readonly html: string;
+} | ResolvedPageWebProjectionMissing;

package/dist/report/runtime/web.d.ts

@@ -0,0 +1,21 @@
+import { type ResolvedPage } from "./resolved-page.js";
+export interface RenderResolvedPageWebOptions {
+    /** Explicit: the page resolver closes one web body for each requested locale. */
+    readonly locale: string;
+}
+export interface ResolvedPageWebProjectionMissing {
+    readonly code: "report-web-projection-missing";
+    readonly pageId: string;
+    readonly route: string;
+    readonly locale: string;
+}
+/**
+ * Reads one pre-closed HTML body. view and static receive this exact string;
+ * neither can invoke Analysis or an author component while serving it.
+ */
+export declare function renderResolvedPageWeb(page: ResolvedPage, options: RenderResolvedPageWebOptions): string;
+/** A total variant for Host error mapping without exception inspection. */
+export declare function resolvedPageWeb(page: ResolvedPage, options: RenderResolvedPageWebOptions): {
+    readonly state: "rendered";
+    readonly html: string;
+} | ResolvedPageWebProjectionMissing;

package/dist/report/runtime/web.js

@@ -0,0 +1,8 @@
+import { createRequire as __niceevalCreateRequire } from "node:module";
+const __niceevalRequire = __niceevalCreateRequire(import.meta.url);
+const __niceevalCanonical = __niceevalRequire("./web.cjs");
+const __niceevalExport0 = __niceevalCanonical["renderResolvedPageWeb"];
+export { __niceevalExport0 as renderResolvedPageWeb };
+const __niceevalExport1 = __niceevalCanonical["resolvedPageWeb"];
+export { __niceevalExport1 as resolvedPageWeb };
+//# sourceMappingURL=web.js.map

package/dist/report/runtime/web.js.map

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

package/dist/report/theme.cjs

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chalk = exports.basalt = void 0;
+exports.defineTheme = defineTheme;
+exports.isThemeDefinition = isThemeDefinition;
+exports.registerThemeSourceBase = registerThemeSourceBase;
+exports.themeSourceBase = themeSourceBase;
+exports.themeAssetInputs = themeAssetInputs;
+exports.themeStylesheet = themeStylesheet;
+const node_path_1 = require("node:path");
+const THEME_DEFINITION = Symbol.for("niceeval.report.theme");
+const themeSourceBases = new WeakMap();
+const COLORS = ["accent", "positive", "negative", "warning", "page", "surface", "surfaceSubtle", "border", "borderStrong", "text", "textSecondary", "textTertiary", "focus"];
+const HEX = /^#[0-9a-f]{6}$/i;
+const cssName = (name) => name.replace(/[A-Z]/g, (x) => `-${x.toLowerCase()}`);
+function fail(path, message) {
+    throw new Error(`defineTheme ${path} ${message}`);
+}
+function assertColor(value, path) {
+    if (typeof value === "string") {
+        if (!HEX.test(value))
+            fail(path, `must be an opaque six-digit sRGB hex (#RRGGBB), got ${JSON.stringify(value)}.`);
+        return;
+    }
+    if (!value || typeof value !== "object" || !HEX.test(value.light) || !HEX.test(value.dark)) {
+        fail(path, "must be #RRGGBB or { light: #RRGGBB, dark: #RRGGBB }.");
+    }
+}
+function assertAssets(value) {
+    if (value === undefined)
+        return;
+    if (!Array.isArray(value))
+        fail("styles", "must be an array of { src } or { inline }.");
+    for (const [i, asset] of value.entries()) {
+        const item = asset;
+        if ((typeof item.src === "string") === (typeof item.inline === "string"))
+            fail(`styles[${i}]`, 'must contain exactly one of "src" or "inline".');
+        if (typeof item.src === "string" && (item.src.startsWith("/") || item.src.startsWith("~") || item.src.split(/[\\/]/).includes(".."))) {
+            fail(`styles[${i}].src`, "must be a local relative path without '..', an absolute path, or '~'.");
+        }
+    }
+}
+function defineTheme(theme) {
+    if (!theme || typeof theme !== "object" || Array.isArray(theme))
+        fail("", "expects a theme object.");
+    for (const key of Object.keys(theme)) {
+        if (!["appearance", ...COLORS, "series", "font", "fontSize", "radius", "styles"].includes(key))
+            fail(key, "is not a supported theme field.");
+    }
+    if (theme.appearance !== undefined && !["system", "light", "dark"].includes(theme.appearance))
+        fail("appearance", 'must be "system", "light", or "dark".');
+    for (const key of COLORS)
+        if (theme[key] !== undefined)
+            assertColor(theme[key], `theme.${key}`);
+    if (theme.series !== undefined) {
+        if (!Array.isArray(theme.series) || theme.series.length !== 6)
+            fail("theme.series", "must contain exactly six colors.");
+        theme.series.forEach((color, i) => assertColor(color, `theme.series[${i}]`));
+    }
+    for (const [key, value] of Object.entries({ ...(theme.font ?? {}), fontSize: theme.fontSize, radius: theme.radius })) {
+        if (value !== undefined && (typeof value !== "string" || !value || /[;}]/.test(value)))
+            fail(`theme.${key}`, 'must be a non-empty CSS value without ";" or "}"; use styles for full CSS.');
+    }
+    assertAssets(theme.styles);
+    const definition = { ...theme, kind: "theme" };
+    Object.defineProperty(definition, THEME_DEFINITION, { value: true });
+    return definition;
+}
+function isThemeDefinition(value) {
+    return typeof value === "object" && value !== null && value.kind === "theme" &&
+        value[THEME_DEFINITION] === true;
+}
+/** @internal Records the trusted module directory used to close relative theme assets. */
+function registerThemeSourceBase(theme, base) {
+    themeSourceBases.set(theme, base);
+}
+/** @internal The site builder never guesses a process-cwd for relative assets. */
+function themeSourceBase(theme) {
+    return themeSourceBases.get(theme);
+}
+/** @internal Exact local stylesheet inputs that a view watcher must retain. */
+function themeAssetInputs(theme) {
+    if (theme === undefined || theme.styles === undefined)
+        return Object.freeze([]);
+    const base = themeSourceBase(theme);
+    if (base === undefined)
+        return Object.freeze([]);
+    return Object.freeze(theme.styles.flatMap((asset) => "src" in asset && typeof asset.src === "string" ? [(0, node_path_1.resolve)(base, asset.src)] : []));
+}
+/**
+ * basalt —— 官方暗色主题,也是不装任何主题时的默认观感(docs/feature/reports/architecture.md)。
+ * 与 docs/SVG-DESIGN.md 的图示令牌同一份:近黑面、发丝线、零圆角、颜色只在有语义时出现。
+ * 官方 stylesheet 每个 var(--niceeval-*, <兜底>) 用点的兜底值抄的就是这里,
+ * test/unit/report-theme-tokens.test.ts 守护逐项相等,所以 basalt 不需要自带 styles。
+ */
+exports.basalt = defineTheme({
+    appearance: "dark",
+    accent: "#cbd6dc", positive: "#3ddc97", negative: "#ff6b6b", warning: "#e8b84a",
+    series: ["#3987e5", "#199e70", "#c98500", "#008300", "#e66767", "#d95926"],
+    page: "#050505", surface: "#0b0b0b", surfaceSubtle: "#111111",
+    border: "#262626", borderStrong: "#343434",
+    text: "#ededed", textSecondary: "#a1a1aa", textTertiary: "#74747b",
+    font: { sans: 'ui-sans-serif, system-ui, -apple-system, "Segoe UI", "Helvetica Neue", "PingFang SC", sans-serif', mono: "ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" },
+    fontSize: "13px", radius: "0",
+});
+/**
+ * chalk —— 官方浅色主题(docs/feature/reports/architecture.md)。白面、圆角、蓝 accent:
+ * 与 basalt 处处相反,同时证明官方样式没写死任何观感——差异完整住在主题令牌里。
+ */
+exports.chalk = defineTheme({
+    appearance: "light",
+    accent: "#2a78d6", positive: "#087f5b", negative: "#b42318", warning: "#9a6700",
+    series: ["#2a78d6", "#1baf7a", "#eda100", "#008300", "#e34948", "#eb6834"],
+    page: "#fafafa", surface: "#ffffff", surfaceSubtle: "#f4f4f5",
+    border: "#dedee2", borderStrong: "#c9c9cf",
+    text: "#111113", textSecondary: "#62636a", textTertiary: "#8b8d98",
+    font: { sans: 'ui-sans-serif, system-ui, -apple-system, "Segoe UI", "Helvetica Neue", "PingFang SC", sans-serif', mono: "ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" },
+    fontSize: "14px", radius: "8px",
+});
+function pair(value, fallback) {
+    const source = value ?? fallback;
+    return typeof source === "string" ? { light: source, dark: source } : source;
+}
+function themeStylesheet(theme) {
+    const all = { ...exports.basalt, ...theme };
+    const entries = COLORS.map((key) => [cssName(key), pair(all[key], (exports.basalt[key] ?? exports.basalt.accent))]);
+    const baseSeries = exports.basalt.series;
+    const series = (all.series ?? baseSeries).map((color, i) => [`series-${i + 1}`, pair(color, baseSeries[i])]);
+    const vars = [...entries, ...series].map(([key, color]) => {
+        const resolved = color;
+        return resolved.light === resolved.dark
+            ? `--niceeval-color-${key}:${resolved.light};`
+            : `--niceeval-color-${key}:light-dark(${resolved.light},${resolved.dark});`;
+    }).join("");
+    const font = all.font ?? exports.basalt.font;
+    const scheme = all.appearance === "light" ? "light" : all.appearance === "dark" ? "dark" : "light dark";
+    // .niceeval-report 也压一遍 color-scheme:官方 stylesheet 的兜底是 basalt 的 dark,
+    // 令牌块在级联后位,锁定/放开外观都以生效主题为准(tok-* 语法高亮的 light-dark() 靠它选支)。
+    return `:root{color-scheme:${scheme};${vars}--niceeval-font-sans:${font.sans ?? exports.basalt.font.sans};--niceeval-font-mono:${font.mono ?? exports.basalt.font.mono};--niceeval-font-size:${all.fontSize ?? exports.basalt.fontSize};--niceeval-radius:${all.radius ?? exports.basalt.radius};}.niceeval-report{color-scheme:${scheme};}`;
+}
+//# sourceMappingURL=theme.cjs.map

package/dist/report/theme.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["theme.ts"],"names":[],"mappings":";;;AAmFA,kCAyBC;AACD,8CAKC;AAED,0DAEC;AAED,0CAEC;AAED,4CAOC;AAsCD,0CAmBC;AA3LD,yCAAoC;AAsCpC,MAAM,gBAAgB,GAAkB,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAC5E,MAAM,gBAAgB,GAAG,IAAI,OAAO,EAAkB,CAAC;AAMvD,MAAM,MAAM,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,OAAO,CAAU,CAAC;AACtL,MAAM,GAAG,GAAG,iBAAiB,CAAC;AAC9B,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AACvF,SAAS,IAAI,CAAC,IAAY,EAAE,OAAe;IACvC,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,IAAI,OAAO,EAAE,CAAC,CAAC;AACtD,CAAC;AACD,SAAS,WAAW,CAAC,KAAc,EAAE,IAAY;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;YAChB,IAAI,CAAC,IAAI,EAAE,uDAAuD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChG,OAAO;IACX,CAAC;IACD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,CAAE,KAEpD,CAAC,KAAe,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAE,KAEhC,CAAC,IAAc,CAAC,EAAE,CAAC;QACjB,IAAI,CAAC,IAAI,EAAE,uDAAuD,CAAC,CAAC;IACxE,CAAC;AACL,CAAC;AACD,SAAS,YAAY,CAAC,KAAc;IAChC,IAAI,KAAK,KAAK,SAAS;QACnB,OAAO;IACX,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrB,IAAI,CAAC,QAAQ,EAAE,4CAA4C,CAAC,CAAC;IACjE,KAAK,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,KAGZ,CAAC;QACF,IAAI,CAAC,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC;YACpE,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,gDAAgD,CAAC,CAAC;QAC3E,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACnI,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,uEAAuE,CAAC,CAAC;QACtG,CAAC;IACL,CAAC;AACL,CAAC;AACD,SAAgB,WAAW,CAAC,KAAkB;IAC1C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAC3D,IAAI,CAAC,EAAE,EAAE,yBAAyB,CAAC,CAAC;IACxC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC,CAAC,YAAY,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;YAC1F,IAAI,CAAC,GAAG,EAAE,iCAAiC,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC;QACzF,IAAI,CAAC,YAAY,EAAE,uCAAuC,CAAC,CAAC;IAChE,KAAK,MAAM,GAAG,IAAI,MAAM;QACpB,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS;YACxB,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,SAAS,GAAG,EAAE,CAAC,CAAC;IAChD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YACzD,IAAI,CAAC,cAAc,EAAE,kCAAkC,CAAC,CAAC;QAC7D,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC;IACjF,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;QACnH,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClF,IAAI,CAAC,SAAS,GAAG,EAAE,EAAE,4EAA4E,CAAC,CAAC;IAC3G,CAAC;IACD,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3B,MAAM,UAAU,GAAG,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,OAAgB,EAAE,CAAC;IACxD,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,gBAAgB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,OAAO,UAA6B,CAAC;AACzC,CAAC;AACD,SAAgB,iBAAiB,CAAC,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAK,KAErD,CAAC,IAAI,KAAK,OAAO;QACd,KAAiC,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;AACtE,CAAC;AACD,0FAA0F;AAC1F,SAAgB,uBAAuB,CAAC,KAAsB,EAAE,IAAY;IACxE,gBAAgB,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC;AACD,kFAAkF;AAClF,SAAgB,eAAe,CAAC,KAAsB;IAClD,OAAO,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AACD,+EAA+E;AAC/E,SAAgB,gBAAgB,CAAC,KAAkC;IAC/D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;QACjD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,IAAI,KAAK,SAAS;QAClB,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAA,mBAAO,EAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7I,CAAC;AACD;;;;;GAKG;AACU,QAAA,MAAM,GAAG,WAAW,CAAC;IAC9B,UAAU,EAAE,MAAM;IAClB,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS;IAC/E,MAAM,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;IAC1E,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS;IAC7D,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS;IAC1C,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS;IAClE,IAAI,EAAE,EAAE,IAAI,EAAE,kGAAkG,EAAE,IAAI,EAAE,0DAA0D,EAAE;IACpL,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG;CAChC,CAAC,CAAC;AACH;;;GAGG;AACU,QAAA,KAAK,GAAG,WAAW,CAAC;IAC7B,UAAU,EAAE,OAAO;IACnB,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS;IAC/E,MAAM,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;IAC1E,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS;IAC7D,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS;IAC1C,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS;IAClE,IAAI,EAAE,EAAE,IAAI,EAAE,kGAAkG,EAAE,IAAI,EAAE,0DAA0D,EAAE;IACpL,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK;CAClC,CAAC,CAAC;AACH,SAAS,IAAI,CAAC,KAA6B,EAAE,QAAoB;IAI7D,MAAM,MAAM,GAAG,KAAK,IAAI,QAAQ,CAAC;IACjC,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AACjF,CAAC;AACD,SAAgB,eAAe,CAAC,KAAsB;IAClD,MAAM,GAAG,GAAgB,EAAE,GAAG,cAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IACjD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,cAAM,CAAC,GAAG,CAAC,IAAI,cAAM,CAAC,MAAM,CAAE,CAAC,CAAC,CAAC,CAAC;IACrG,MAAM,UAAU,GAAG,cAAM,CAAC,MAAO,CAAC;IAClC,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC;IAC9G,MAAM,IAAI,GAAG,CAAC,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACtD,MAAM,QAAQ,GAAG,KAGhB,CAAC;QACF,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ,CAAC,IAAI;YACnC,CAAC,CAAC,oBAAoB,GAAG,IAAI,QAAQ,CAAC,KAAK,GAAG;YAC9C,CAAC,CAAC,oBAAoB,GAAG,eAAe,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,IAAI,CAAC;IACpF,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,cAAM,CAAC,IAAK,CAAC;IACtC,MAAM,MAAM,GAAG,GAAG,CAAC,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC;IACxG,uEAAuE;IACvE,2DAA2D;IAC3D,OAAO,sBAAsB,MAAM,IAAI,IAAI,wBAAwB,IAAI,CAAC,IAAI,IAAI,cAAM,CAAC,IAAK,CAAC,IAAI,yBAAyB,IAAI,CAAC,IAAI,IAAI,cAAM,CAAC,IAAK,CAAC,IAAI,yBAAyB,GAAG,CAAC,QAAQ,IAAI,cAAM,CAAC,QAAQ,sBAAsB,GAAG,CAAC,MAAM,IAAI,cAAM,CAAC,MAAM,mCAAmC,MAAM,IAAI,CAAC;AACnT,CAAC","sourcesContent":["import type { ReportAsset } from \"./definition/report.ts\";\nimport { resolve } from \"node:path\";\nexport type ThemeHex = `#${string}`;\nexport type ThemeColor = ThemeHex | {\n    light: ThemeHex;\n    dark: ThemeHex;\n};\nexport type ThemeSeries = readonly [\n    ThemeColor,\n    ThemeColor,\n    ThemeColor,\n    ThemeColor,\n    ThemeColor,\n    ThemeColor\n];\nexport interface ReportTheme {\n    appearance?: \"system\" | \"light\" | \"dark\";\n    accent?: ThemeColor;\n    positive?: ThemeColor;\n    negative?: ThemeColor;\n    warning?: ThemeColor;\n    series?: ThemeSeries;\n    page?: ThemeColor;\n    surface?: ThemeColor;\n    surfaceSubtle?: ThemeColor;\n    border?: ThemeColor;\n    borderStrong?: ThemeColor;\n    text?: ThemeColor;\n    textSecondary?: ThemeColor;\n    textTertiary?: ThemeColor;\n    focus?: ThemeColor;\n    font?: {\n        sans?: string;\n        mono?: string;\n    };\n    fontSize?: string;\n    radius?: string;\n    styles?: readonly ReportAsset[];\n}\nconst THEME_DEFINITION: unique symbol = Symbol.for(\"niceeval.report.theme\");\nconst themeSourceBases = new WeakMap<object, string>();\nexport interface ThemeDefinition extends ReportTheme {\n    /** 与 ReportDefinition 同形的不可构造结构品牌；运行时仍由 Symbol.for 标记验证。 */\n    readonly __niceevalThemeDefinition: never;\n    readonly kind: \"theme\";\n}\nconst COLORS = [\"accent\", \"positive\", \"negative\", \"warning\", \"page\", \"surface\", \"surfaceSubtle\", \"border\", \"borderStrong\", \"text\", \"textSecondary\", \"textTertiary\", \"focus\"] as const;\nconst HEX = /^#[0-9a-f]{6}$/i;\nconst cssName = (name: string) => name.replace(/[A-Z]/g, (x) => `-${x.toLowerCase()}`);\nfunction fail(path: string, message: string): never {\n    throw new Error(`defineTheme ${path} ${message}`);\n}\nfunction assertColor(value: unknown, path: string): asserts value is ThemeColor {\n    if (typeof value === \"string\") {\n        if (!HEX.test(value))\n            fail(path, `must be an opaque six-digit sRGB hex (#RRGGBB), got ${JSON.stringify(value)}.`);\n        return;\n    }\n    if (!value || typeof value !== \"object\" || !HEX.test((value as {\n        light?: unknown;\n    }).light as string) || !HEX.test((value as {\n        dark?: unknown;\n    }).dark as string)) {\n        fail(path, \"must be #RRGGBB or { light: #RRGGBB, dark: #RRGGBB }.\");\n    }\n}\nfunction assertAssets(value: unknown): asserts value is readonly ReportAsset[] {\n    if (value === undefined)\n        return;\n    if (!Array.isArray(value))\n        fail(\"styles\", \"must be an array of { src } or { inline }.\");\n    for (const [i, asset] of value.entries()) {\n        const item = asset as {\n            src?: unknown;\n            inline?: unknown;\n        };\n        if ((typeof item.src === \"string\") === (typeof item.inline === \"string\"))\n            fail(`styles[${i}]`, 'must contain exactly one of \"src\" or \"inline\".');\n        if (typeof item.src === \"string\" && (item.src.startsWith(\"/\") || item.src.startsWith(\"~\") || item.src.split(/[\\\\/]/).includes(\"..\"))) {\n            fail(`styles[${i}].src`, \"must be a local relative path without '..', an absolute path, or '~'.\");\n        }\n    }\n}\nexport function defineTheme(theme: ReportTheme): ThemeDefinition {\n    if (!theme || typeof theme !== \"object\" || Array.isArray(theme))\n        fail(\"\", \"expects a theme object.\");\n    for (const key of Object.keys(theme)) {\n        if (![\"appearance\", ...COLORS, \"series\", \"font\", \"fontSize\", \"radius\", \"styles\"].includes(key))\n            fail(key, \"is not a supported theme field.\");\n    }\n    if (theme.appearance !== undefined && ![\"system\", \"light\", \"dark\"].includes(theme.appearance))\n        fail(\"appearance\", 'must be \"system\", \"light\", or \"dark\".');\n    for (const key of COLORS)\n        if (theme[key] !== undefined)\n            assertColor(theme[key], `theme.${key}`);\n    if (theme.series !== undefined) {\n        if (!Array.isArray(theme.series) || theme.series.length !== 6)\n            fail(\"theme.series\", \"must contain exactly six colors.\");\n        theme.series.forEach((color, i) => assertColor(color, `theme.series[${i}]`));\n    }\n    for (const [key, value] of Object.entries({ ...(theme.font ?? {}), fontSize: theme.fontSize, radius: theme.radius })) {\n        if (value !== undefined && (typeof value !== \"string\" || !value || /[;}]/.test(value)))\n            fail(`theme.${key}`, 'must be a non-empty CSS value without \";\" or \"}\"; use styles for full CSS.');\n    }\n    assertAssets(theme.styles);\n    const definition = { ...theme, kind: \"theme\" as const };\n    Object.defineProperty(definition, THEME_DEFINITION, { value: true });\n    return definition as ThemeDefinition;\n}\nexport function isThemeDefinition(value: unknown): value is ThemeDefinition {\n    return typeof value === \"object\" && value !== null && (value as {\n        kind?: unknown;\n    }).kind === \"theme\" &&\n        (value as Record<symbol, unknown>)[THEME_DEFINITION] === true;\n}\n/** @internal Records the trusted module directory used to close relative theme assets. */\nexport function registerThemeSourceBase(theme: ThemeDefinition, base: string): void {\n    themeSourceBases.set(theme, base);\n}\n/** @internal The site builder never guesses a process-cwd for relative assets. */\nexport function themeSourceBase(theme: ThemeDefinition): string | undefined {\n    return themeSourceBases.get(theme);\n}\n/** @internal Exact local stylesheet inputs that a view watcher must retain. */\nexport function themeAssetInputs(theme: ThemeDefinition | undefined): readonly string[] {\n    if (theme === undefined || theme.styles === undefined)\n        return Object.freeze([]);\n    const base = themeSourceBase(theme);\n    if (base === undefined)\n        return Object.freeze([]);\n    return Object.freeze(theme.styles.flatMap((asset) => \"src\" in asset && typeof asset.src === \"string\" ? [resolve(base, asset.src)] : []));\n}\n/**\n * basalt —— 官方暗色主题,也是不装任何主题时的默认观感(docs/feature/reports/architecture.md)。\n * 与 docs/SVG-DESIGN.md 的图示令牌同一份:近黑面、发丝线、零圆角、颜色只在有语义时出现。\n * 官方 stylesheet 每个 var(--niceeval-*, <兜底>) 用点的兜底值抄的就是这里,\n * test/unit/report-theme-tokens.test.ts 守护逐项相等,所以 basalt 不需要自带 styles。\n */\nexport const basalt = defineTheme({\n    appearance: \"dark\",\n    accent: \"#cbd6dc\", positive: \"#3ddc97\", negative: \"#ff6b6b\", warning: \"#e8b84a\",\n    series: [\"#3987e5\", \"#199e70\", \"#c98500\", \"#008300\", \"#e66767\", \"#d95926\"],\n    page: \"#050505\", surface: \"#0b0b0b\", surfaceSubtle: \"#111111\",\n    border: \"#262626\", borderStrong: \"#343434\",\n    text: \"#ededed\", textSecondary: \"#a1a1aa\", textTertiary: \"#74747b\",\n    font: { sans: 'ui-sans-serif, system-ui, -apple-system, \"Segoe UI\", \"Helvetica Neue\", \"PingFang SC\", sans-serif', mono: \"ui-monospace, SFMono-Regular, Menlo, Consolas, monospace\" },\n    fontSize: \"13px\", radius: \"0\",\n});\n/**\n * chalk —— 官方浅色主题(docs/feature/reports/architecture.md)。白面、圆角、蓝 accent:\n * 与 basalt 处处相反,同时证明官方样式没写死任何观感——差异完整住在主题令牌里。\n */\nexport const chalk = defineTheme({\n    appearance: \"light\",\n    accent: \"#2a78d6\", positive: \"#087f5b\", negative: \"#b42318\", warning: \"#9a6700\",\n    series: [\"#2a78d6\", \"#1baf7a\", \"#eda100\", \"#008300\", \"#e34948\", \"#eb6834\"],\n    page: \"#fafafa\", surface: \"#ffffff\", surfaceSubtle: \"#f4f4f5\",\n    border: \"#dedee2\", borderStrong: \"#c9c9cf\",\n    text: \"#111113\", textSecondary: \"#62636a\", textTertiary: \"#8b8d98\",\n    font: { sans: 'ui-sans-serif, system-ui, -apple-system, \"Segoe UI\", \"Helvetica Neue\", \"PingFang SC\", sans-serif', mono: \"ui-monospace, SFMono-Regular, Menlo, Consolas, monospace\" },\n    fontSize: \"14px\", radius: \"8px\",\n});\nfunction pair(value: ThemeColor | undefined, fallback: ThemeColor): {\n    light: string;\n    dark: string;\n} {\n    const source = value ?? fallback;\n    return typeof source === \"string\" ? { light: source, dark: source } : source;\n}\nexport function themeStylesheet(theme: ThemeDefinition): string {\n    const all: ReportTheme = { ...basalt, ...theme };\n    const entries = COLORS.map((key) => [cssName(key), pair(all[key], (basalt[key] ?? basalt.accent)!)]);\n    const baseSeries = basalt.series!;\n    const series = (all.series ?? baseSeries).map((color, i) => [`series-${i + 1}`, pair(color, baseSeries[i]!)]);\n    const vars = [...entries, ...series].map(([key, color]) => {\n        const resolved = color as {\n            light: string;\n            dark: string;\n        };\n        return resolved.light === resolved.dark\n            ? `--niceeval-color-${key}:${resolved.light};`\n            : `--niceeval-color-${key}:light-dark(${resolved.light},${resolved.dark});`;\n    }).join(\"\");\n    const font = all.font ?? basalt.font!;\n    const scheme = all.appearance === \"light\" ? \"light\" : all.appearance === \"dark\" ? \"dark\" : \"light dark\";\n    // .niceeval-report 也压一遍 color-scheme:官方 stylesheet 的兜底是 basalt 的 dark,\n    // 令牌块在级联后位,锁定/放开外观都以生效主题为准(tok-* 语法高亮的 light-dark() 靠它选支)。\n    return `:root{color-scheme:${scheme};${vars}--niceeval-font-sans:${font.sans ?? basalt.font!.sans};--niceeval-font-mono:${font.mono ?? basalt.font!.mono};--niceeval-font-size:${all.fontSize ?? basalt.fontSize};--niceeval-radius:${all.radius ?? basalt.radius};}.niceeval-report{color-scheme:${scheme};}`;\n}\n"]}

package/dist/report/theme.d.cts

@@ -0,0 +1,57 @@
+import type { ReportAsset } from "./definition/report.cjs";
+export type ThemeHex = `#${string}`;
+export type ThemeColor = ThemeHex | {
+    light: ThemeHex;
+    dark: ThemeHex;
+};
+export type ThemeSeries = readonly [ThemeColor, ThemeColor, ThemeColor, ThemeColor, ThemeColor, ThemeColor];
+export interface ReportTheme {
+    appearance?: "system" | "light" | "dark";
+    accent?: ThemeColor;
+    positive?: ThemeColor;
+    negative?: ThemeColor;
+    warning?: ThemeColor;
+    series?: ThemeSeries;
+    page?: ThemeColor;
+    surface?: ThemeColor;
+    surfaceSubtle?: ThemeColor;
+    border?: ThemeColor;
+    borderStrong?: ThemeColor;
+    text?: ThemeColor;
+    textSecondary?: ThemeColor;
+    textTertiary?: ThemeColor;
+    focus?: ThemeColor;
+    font?: {
+        sans?: string;
+        mono?: string;
+    };
+    fontSize?: string;
+    radius?: string;
+    styles?: readonly ReportAsset[];
+}
+export interface ThemeDefinition extends ReportTheme {
+    /** 与 ReportDefinition 同形的不可构造结构品牌；运行时仍由 Symbol.for 标记验证。 */
+    readonly __niceevalThemeDefinition: never;
+    readonly kind: "theme";
+}
+export declare function defineTheme(theme: ReportTheme): ThemeDefinition;
+export declare function isThemeDefinition(value: unknown): value is ThemeDefinition;
+/** @internal Records the trusted module directory used to close relative theme assets. */
+export declare function registerThemeSourceBase(theme: ThemeDefinition, base: string): void;
+/** @internal The site builder never guesses a process-cwd for relative assets. */
+export declare function themeSourceBase(theme: ThemeDefinition): string | undefined;
+/** @internal Exact local stylesheet inputs that a view watcher must retain. */
+export declare function themeAssetInputs(theme: ThemeDefinition | undefined): readonly string[];
+/**
+ * basalt —— 官方暗色主题,也是不装任何主题时的默认观感(docs/feature/reports/architecture.md)。
+ * 与 docs/SVG-DESIGN.md 的图示令牌同一份:近黑面、发丝线、零圆角、颜色只在有语义时出现。
+ * 官方 stylesheet 每个 var(--niceeval-*, <兜底>) 用点的兜底值抄的就是这里,
+ * test/unit/report-theme-tokens.test.ts 守护逐项相等,所以 basalt 不需要自带 styles。
+ */
+export declare const basalt: ThemeDefinition;
+/**
+ * chalk —— 官方浅色主题(docs/feature/reports/architecture.md)。白面、圆角、蓝 accent:
+ * 与 basalt 处处相反,同时证明官方样式没写死任何观感——差异完整住在主题令牌里。
+ */
+export declare const chalk: ThemeDefinition;
+export declare function themeStylesheet(theme: ThemeDefinition): string;