niceeval 0.12.2-canary.31 → 0.13.0

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

@@ -0,0 +1,317 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RESOLVED_PAGE_FORMAT = void 0;
+exports.resolvePage = resolvePage;
+exports.resolvedPageTextProjection = resolvedPageTextProjection;
+exports.resolvedPageWebProjection = resolvedPageWebProjection;
+exports.compareUtf8 = compareUtf8;
+const effect_1 = require("effect");
+const contracts_ts_1 = require("../../analysis/contracts.cjs");
+/** A closed page has no route back to an author callback or a live Sample. */
+exports.RESOLVED_PAGE_FORMAT = "niceeval.report.resolved-page/v1";
+/**
+ * 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.
+ */
+function resolvePage(input) {
+    return effect_1.Effect.gen(function* () {
+        const rendered = yield* input.render;
+        const output = yield* input.close(rendered, {
+            sample: input.sample,
+            target: input.target,
+        });
+        return yield* closeResolvedPage({
+            sample: input.sample,
+            target: input.target,
+            output,
+        });
+    });
+}
+/** Finds an already-built terminal projection. It never invokes a renderer. */
+function resolvedPageTextProjection(page, input) {
+    return page.text.find((projection) => projection.locale === input.locale && projection.width === input.width);
+}
+/** Finds an already-built browser projection. It never invokes a renderer. */
+function resolvedPageWebProjection(page, input) {
+    return page.web.find((projection) => projection.locale === input.locale);
+}
+function closeResolvedPage(input) {
+    return effect_1.Effect.try({
+        try: () => freezeResolvedPage(input),
+        catch: (error) => Object.freeze({
+            code: "report-resolved-page-invalid",
+            path: Object.freeze([]),
+            reason: error instanceof Error ? error.message : "a Page closure returned an invalid value",
+        }),
+    });
+}
+function freezeResolvedPage(input) {
+    const target = freezeTarget(input.target, input.sample);
+    const title = freezeLocalizedText(input.output.title, input.sample, ["title"]);
+    const head = closeJson(input.output.head ?? null, input.sample, ["head"], new Set());
+    const text = freezeTextProjections(input.output.text, input.sample);
+    const web = freezeWebProjections(input.output.web, input.sample);
+    const downloads = freezeDownloads(input.output.downloads ?? []);
+    const assets = freezeAssets(input.output.assets ?? []);
+    assertDistinctPayloadPaths(downloads, assets);
+    const sample = input.sample.snapshot.identity;
+    if (sample.kind !== "analysis-sample" || !isNonEmptyString(sample.id)) {
+        throw new TypeError("sample identity must be a closed analysis-sample identity");
+    }
+    return Object.freeze({
+        format: exports.RESOLVED_PAGE_FORMAT,
+        target,
+        sample: Object.freeze({ kind: "analysis-sample", id: sample.id }),
+        title,
+        head,
+        text,
+        web,
+        downloads,
+        assets,
+    });
+}
+function freezeTarget(input, sample) {
+    if (!isNonEmptyString(input.pageId))
+        throw new TypeError("target.pageId must be a non-empty string");
+    if (!isNonEmptyString(input.route))
+        throw new TypeError("target.route must be a non-empty string");
+    return Object.freeze({
+        pageId: input.pageId,
+        route: input.route,
+        ...(input.params === undefined
+            ? {}
+            : { params: closeJson(input.params, sample, ["target", "params"], new Set()) }),
+    });
+}
+function freezeLocalizedText(value, sample, path) {
+    if (typeof value === "string")
+        return value;
+    const closed = closeJson(value, sample, path, new Set());
+    if (Array.isArray(closed) || closed === null || typeof closed !== "object") {
+        throw new TypeError(`${path.join(".")} must be a string or locale map`);
+    }
+    const entries = Object.entries(closed);
+    if (entries.length === 0 || entries.some(([locale, text]) => !isNonEmptyString(locale) || typeof text !== "string")) {
+        throw new TypeError(`${path.join(".")} must be a non-empty locale map of strings`);
+    }
+    const result = Object.create(null);
+    for (const [locale, text] of entries) {
+        // The validation above proves this is a locale-string pair.
+        result[locale] = text;
+    }
+    return Object.freeze(result);
+}
+function freezeTextProjections(value, sample) {
+    if (!Array.isArray(value) || value.length === 0) {
+        throw new TypeError("a resolved Page must contain at least one text projection");
+    }
+    const seen = new Set();
+    const closed = value.map((projection, index) => {
+        if (projection === null || typeof projection !== "object" || Array.isArray(projection)) {
+            throw new TypeError(`text[${index}] must be a projection object`);
+        }
+        if (rejectLiveCapability(projection, sample, ["text", String(index)])) {
+            throw new TypeError(`text[${index}] retains a live Sample capability`);
+        }
+        if (!isNonEmptyString(projection.locale) || !isPositiveSafeInteger(projection.width) || typeof projection.text !== "string") {
+            throw new TypeError(`text[${index}] must contain locale, positive width, and text`);
+        }
+        const key = `${projection.locale}\u0000${projection.width}`;
+        if (seen.has(key))
+            throw new TypeError(`text projection ${JSON.stringify(key)} is duplicated`);
+        seen.add(key);
+        return Object.freeze({ locale: projection.locale, width: projection.width, text: projection.text });
+    });
+    return Object.freeze(closed.sort((left, right) => compareUtf8(left.locale, right.locale) || left.width - right.width));
+}
+function freezeWebProjections(value, sample) {
+    if (!Array.isArray(value) || value.length === 0) {
+        throw new TypeError("a resolved Page must contain at least one web projection");
+    }
+    const seen = new Set();
+    const closed = value.map((projection, index) => {
+        if (projection === null || typeof projection !== "object" || Array.isArray(projection)) {
+            throw new TypeError(`web[${index}] must be a projection object`);
+        }
+        if (rejectLiveCapability(projection, sample, ["web", String(index)])) {
+            throw new TypeError(`web[${index}] retains a live Sample capability`);
+        }
+        if (!isNonEmptyString(projection.locale) || typeof projection.html !== "string") {
+            throw new TypeError(`web[${index}] must contain locale and html`);
+        }
+        if (seen.has(projection.locale))
+            throw new TypeError(`web locale ${JSON.stringify(projection.locale)} is duplicated`);
+        seen.add(projection.locale);
+        return Object.freeze({ locale: projection.locale, html: projection.html });
+    });
+    return Object.freeze(closed.sort((left, right) => compareUtf8(left.locale, right.locale)));
+}
+function freezeDownloads(value) {
+    if (!Array.isArray(value))
+        throw new TypeError("downloads must be an array");
+    const ids = new Set();
+    const paths = new Set();
+    const closed = value.map((download, index) => {
+        if (!isPlainDataRecord(download) || !hasExactFields(download, ["id", "path", "mediaType", "bytes", "sha256"], ["id", "path", "mediaType", "bytes"])) {
+            throw new TypeError(`downloads[${index}] must be a closed payload object`);
+        }
+        if (!isNonEmptyString(download.id) || !isCanonicalRelativePath(download.path) || !isNonEmptyString(download.mediaType) ||
+            !(download.bytes instanceof Uint8Array) ||
+            (download.sha256 !== undefined && !isNonEmptyString(download.sha256))) {
+            throw new TypeError(`downloads[${index}] has an invalid payload`);
+        }
+        if (ids.has(download.id) || paths.has(download.path)) {
+            throw new TypeError(`downloads[${index}] repeats an id or path`);
+        }
+        ids.add(download.id);
+        paths.add(download.path);
+        // A non-empty TypedArray cannot be Object.freeze()'d by ECMAScript. The
+        // frozen wrapper owns this fresh copy, so later mutation of the author's
+        // buffer cannot alter the resolved payload.
+        const bytes = new Uint8Array(download.bytes);
+        return Object.freeze({
+            id: download.id,
+            path: download.path,
+            mediaType: download.mediaType,
+            bytes,
+            byteLength: bytes.byteLength,
+            ...(download.sha256 === undefined ? {} : { sha256: download.sha256 }),
+        });
+    });
+    return Object.freeze(closed.sort((left, right) => compareUtf8(left.path, right.path) || compareUtf8(left.id, right.id)));
+}
+function freezeAssets(value) {
+    if (!Array.isArray(value))
+        throw new TypeError("assets must be an array");
+    const paths = new Set();
+    const closed = value.map((asset, index) => {
+        if (!isPlainDataRecord(asset) || !hasExactFields(asset, ["kind", "path", "mediaType", "bytes", "sha256"], ["kind", "path", "mediaType", "bytes"])) {
+            throw new TypeError(`assets[${index}] must be a closed payload object`);
+        }
+        if (!isResolvedPageAssetKind(asset.kind) || !isCanonicalRelativePath(asset.path) ||
+            !isNonEmptyString(asset.mediaType) || !(asset.bytes instanceof Uint8Array) ||
+            (asset.sha256 !== undefined && !isNonEmptyString(asset.sha256))) {
+            throw new TypeError(`assets[${index}] has an invalid payload`);
+        }
+        if (paths.has(asset.path))
+            throw new TypeError(`assets[${index}] repeats a path`);
+        paths.add(asset.path);
+        // TypedArray elements cannot be frozen by ECMAScript. The frozen wrapper
+        // owns this independent payload; callers cannot mutate the author's copy.
+        const bytes = new Uint8Array(asset.bytes);
+        return Object.freeze({
+            kind: asset.kind,
+            path: asset.path,
+            mediaType: asset.mediaType,
+            bytes,
+            byteLength: bytes.byteLength,
+            ...(asset.sha256 === undefined ? {} : { sha256: asset.sha256 }),
+        });
+    });
+    return Object.freeze(closed.sort((left, right) => compareUtf8(left.path, right.path) ||
+        compareUtf8(left.kind, right.kind) ||
+        compareUtf8(left.mediaType, right.mediaType)));
+}
+/** A full revision receives one namespace of emitted paths across payload kinds. */
+function assertDistinctPayloadPaths(downloads, assets) {
+    const downloadPaths = new Set(downloads.map((download) => download.path));
+    for (const asset of assets) {
+        if (downloadPaths.has(asset.path)) {
+            throw new TypeError(`asset path ${JSON.stringify(asset.path)} conflicts with a download path`);
+        }
+    }
+}
+function closeJson(value, sample, path, active) {
+    if (value === null || typeof value === "boolean" || typeof value === "string")
+        return value;
+    if (typeof value === "number") {
+        if (!Number.isFinite(value))
+            throw new TypeError(`${path.join(".")} contains a non-finite number`);
+        return value;
+    }
+    if (typeof value === "undefined" || typeof value === "bigint" || typeof value === "symbol" || typeof value === "function") {
+        throw new TypeError(`${path.join(".")} contains a non-closed value`);
+    }
+    if (rejectLiveCapability(value, sample, path)) {
+        throw new TypeError(`${path.join(".")} retains a live Sample capability`);
+    }
+    if (active.has(value))
+        throw new TypeError(`${path.join(".")} contains a cycle`);
+    active.add(value);
+    try {
+        if (Array.isArray(value)) {
+            return Object.freeze(value.map((entry, index) => closeJson(entry, sample, [...path, String(index)], active)));
+        }
+        if (!isPlainDataRecord(value)) {
+            throw new TypeError(`${path.join(".")} must be a plain data object`);
+        }
+        const result = Object.create(null);
+        for (const key of Object.keys(value).sort(compareUtf8)) {
+            result[key] = closeJson(value[key], sample, [...path, key], active);
+        }
+        return Object.freeze(result);
+    }
+    finally {
+        active.delete(value);
+    }
+}
+function rejectLiveCapability(value, sample, _path) {
+    if (value === sample)
+        return true;
+    const brand = Object.getOwnPropertyDescriptor(value, contracts_ts_1.sampleCapabilityTypeId);
+    if (brand !== undefined && "value" in brand && brand.value === true)
+        return true;
+    const kind = Object.getOwnPropertyDescriptor(value, "kind");
+    const snapshot = Object.getOwnPropertyDescriptor(value, "snapshot");
+    return kind !== undefined && "value" in kind && kind.value === "analysis-sample" && snapshot !== undefined;
+}
+function isPlainDataRecord(value) {
+    if (Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null)
+        return false;
+    for (const key of Reflect.ownKeys(value)) {
+        if (typeof key !== "string")
+            return false;
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        if (descriptor === undefined || !descriptor.enumerable || !("value" in descriptor))
+            return false;
+    }
+    return true;
+}
+function hasExactFields(value, allowed, required) {
+    const keys = Object.getOwnPropertyNames(value);
+    return keys.every((key) => allowed.includes(key)) &&
+        required.every((key) => Object.hasOwn(value, key));
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.length > 0;
+}
+function isPositiveSafeInteger(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+}
+function isResolvedPageAssetKind(value) {
+    return value === "style" || value === "script" || value === "source" || value === "diff" || value === "other";
+}
+function isCanonicalRelativePath(value) {
+    if (!isNonEmptyString(value) || value.startsWith("/") || value.endsWith("/") || value.includes("\\") || value.includes("\u0000")) {
+        return false;
+    }
+    return value.split("/").every((segment) => segment.length > 0 && segment !== "." && segment !== "..");
+}
+const textEncoder = new TextEncoder();
+/** UTF-8 byte ordering is the canonical ordering shared by machine output. */
+function compareUtf8(left, right) {
+    if (left === right)
+        return 0;
+    const leftBytes = textEncoder.encode(left);
+    const rightBytes = textEncoder.encode(right);
+    const length = Math.min(leftBytes.length, rightBytes.length);
+    for (let index = 0; index < length; index += 1) {
+        const difference = leftBytes[index] - rightBytes[index];
+        if (difference !== 0)
+            return difference;
+    }
+    return leftBytes.length - rightBytes.length;
+}
+//# sourceMappingURL=resolved-page.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolved-page.js","sourceRoot":"","sources":["resolved-page.ts"],"names":[],"mappings":"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","sourcesContent":["import { Effect } from \"effect\";\nimport type * as Scope from \"effect/Scope\";\nimport { sampleCapabilityTypeId, type JsonValue, type Sample, type SampleIdentity, } from \"../../analysis/contracts.ts\";\nimport type { LocalizedText } from \"../../shared/types.ts\";\n/** A closed page has no route back to an author callback or a live Sample. */\nexport const RESOLVED_PAGE_FORMAT = \"niceeval.report.resolved-page/v1\";\nexport interface ResolvedPageTarget {\n    readonly pageId: string;\n    readonly route: string;\n    /** Parameter identity is data, never a page loader or encoder callback. */\n    readonly params?: JsonValue;\n}\nexport interface ResolvedPageTextProjection {\n    readonly locale: string;\n    readonly width: number;\n    readonly text: string;\n}\nexport interface ResolvedPageWebProjection {\n    readonly locale: string;\n    readonly html: string;\n}\n/**\n * A closed download remains a real byte payload until the site builder places\n * it in a revision file. This boundary takes ownership through a defensive\n * copy; byte-count limits deliberately remain a site-builder policy.\n */\nexport interface ResolvedPageDownload {\n    readonly id: string;\n    readonly path: string;\n    readonly mediaType: string;\n    /** The exact closed payload that view/static must write unchanged. */\n    readonly bytes: Uint8Array;\n    readonly byteLength: number;\n    readonly sha256?: string;\n}\n/** Download payload supplied by the live page-closure phase. */\nexport interface ResolvedPageDownloadOutput {\n    readonly id: string;\n    readonly path: string;\n    readonly mediaType: string;\n    readonly bytes: Uint8Array;\n    readonly sha256?: string;\n}\n/** Closed renderer payloads that belong in a full site revision, not downloads. */\nexport type ResolvedPageAssetKind = \"style\" | \"script\" | \"source\" | \"diff\" | \"other\";\nexport interface ResolvedPageAsset {\n    readonly kind: ResolvedPageAssetKind;\n    /** Canonical POSIX-relative path within the eventual revision. */\n    readonly path: string;\n    readonly mediaType: string;\n    /** The exact closed payload that view/static must write unchanged. */\n    readonly bytes: Uint8Array;\n    readonly byteLength: number;\n    readonly sha256?: string;\n}\n/** Asset payload supplied by the live page-closure phase. */\nexport interface ResolvedPageAssetOutput {\n    readonly kind: ResolvedPageAssetKind;\n    readonly path: string;\n    readonly mediaType: string;\n    readonly bytes: Uint8Array;\n    readonly sha256?: string;\n}\n/**\n * The one closed product of a Page execution. `head` is structured data only;\n * no React element, generic semantic tree, renderer, or author function may\n * survive into this value.\n */\nexport interface ResolvedPage {\n    readonly format: typeof RESOLVED_PAGE_FORMAT;\n    readonly target: ResolvedPageTarget;\n    readonly sample: SampleIdentity;\n    readonly title: LocalizedText;\n    readonly head: JsonValue;\n    readonly text: readonly ResolvedPageTextProjection[];\n    readonly web: readonly ResolvedPageWebProjection[];\n    readonly downloads: readonly ResolvedPageDownload[];\n    readonly assets: readonly ResolvedPageAsset[];\n}\n/** The only live capability passed to the page closure phase. */\nexport interface LiveResolvedPageContext {\n    readonly sample: Sample;\n    readonly target: ResolvedPageTarget;\n}\n/**\n * The closure phase owns author/component resolution and must produce both\n * projections before the enclosing Sample Scope closes. Its return type has no\n * escape hatch for open component data.\n */\nexport interface ResolvedPageOutput {\n    readonly title: LocalizedText;\n    readonly head?: JsonValue;\n    readonly text: readonly ResolvedPageTextProjection[];\n    readonly web: readonly ResolvedPageWebProjection[];\n    /** Real payloads are closed here rather than discarded into summaries. */\n    readonly downloads?: readonly ResolvedPageDownloadOutput[];\n    /** Renderer assets and Source/Diff payloads remain distinct from downloads. */\n    readonly assets?: readonly ResolvedPageAssetOutput[];\n}\nexport interface ResolvePageInput<Rendered, Error, Requirements> {\n    readonly sample: Sample;\n    readonly target: ResolvedPageTarget;\n    /** Already adapted at the public callback boundary. Evaluated exactly once. */\n    readonly render: Effect.Effect<Rendered, Error, Requirements>;\n    /**\n     * Resolves every author component and produces all closed projections. This\n     * operation is evaluated exactly once and receives the live Sample only here.\n     */\n    readonly close: (rendered: Rendered, context: LiveResolvedPageContext) => Effect.Effect<ResolvedPageOutput, Error, Requirements>;\n}\nexport interface ResolvedPageClosureError {\n    readonly code: \"report-resolved-page-invalid\";\n    readonly path: readonly string[];\n    readonly reason: string;\n}\n/**\n * Runs one Page render and one component-resolution closure while its caller's\n * Sample Scope is live. The returned object is deliberately data-only, so it\n * can outlive that Scope without retaining a reader, Promise, Effect Scope, or\n * callback.\n */\nexport function resolvePage<Rendered, Error, Requirements>(input: ResolvePageInput<Rendered, Error, Requirements>): Effect.Effect<ResolvedPage, Error | ResolvedPageClosureError, Requirements | Scope.Scope> {\n    return Effect.gen(function* () {\n        const rendered = yield* input.render;\n        const output = yield* input.close(rendered, {\n            sample: input.sample,\n            target: input.target,\n        });\n        return yield* closeResolvedPage({\n            sample: input.sample,\n            target: input.target,\n            output,\n        });\n    });\n}\n/** Finds an already-built terminal projection. It never invokes a renderer. */\nexport function resolvedPageTextProjection(page: ResolvedPage, input: {\n    readonly locale: string;\n    readonly width: number;\n}): ResolvedPageTextProjection | undefined {\n    return page.text.find((projection) => projection.locale === input.locale && projection.width === input.width);\n}\n/** Finds an already-built browser projection. It never invokes a renderer. */\nexport function resolvedPageWebProjection(page: ResolvedPage, input: {\n    readonly locale: string;\n}): ResolvedPageWebProjection | undefined {\n    return page.web.find((projection) => projection.locale === input.locale);\n}\nfunction closeResolvedPage(input: {\n    readonly sample: Sample;\n    readonly target: ResolvedPageTarget;\n    readonly output: ResolvedPageOutput;\n}): Effect.Effect<ResolvedPage, ResolvedPageClosureError> {\n    return Effect.try({\n        try: () => freezeResolvedPage(input),\n        catch: (error): ResolvedPageClosureError => Object.freeze({\n            code: \"report-resolved-page-invalid\" as const,\n            path: Object.freeze([]),\n            reason: error instanceof Error ? error.message : \"a Page closure returned an invalid value\",\n        }),\n    });\n}\nfunction freezeResolvedPage(input: {\n    readonly sample: Sample;\n    readonly target: ResolvedPageTarget;\n    readonly output: ResolvedPageOutput;\n}): ResolvedPage {\n    const target = freezeTarget(input.target, input.sample);\n    const title = freezeLocalizedText(input.output.title, input.sample, [\"title\"]);\n    const head = closeJson(input.output.head ?? null, input.sample, [\"head\"], new Set<object>());\n    const text = freezeTextProjections(input.output.text, input.sample);\n    const web = freezeWebProjections(input.output.web, input.sample);\n    const downloads = freezeDownloads(input.output.downloads ?? []);\n    const assets = freezeAssets(input.output.assets ?? []);\n    assertDistinctPayloadPaths(downloads, assets);\n    const sample = input.sample.snapshot.identity;\n    if (sample.kind !== \"analysis-sample\" || !isNonEmptyString(sample.id)) {\n        throw new TypeError(\"sample identity must be a closed analysis-sample identity\");\n    }\n    return Object.freeze({\n        format: RESOLVED_PAGE_FORMAT,\n        target,\n        sample: Object.freeze({ kind: \"analysis-sample\" as const, id: sample.id }),\n        title,\n        head,\n        text,\n        web,\n        downloads,\n        assets,\n    });\n}\nfunction freezeTarget(input: ResolvedPageTarget, sample: Sample): ResolvedPageTarget {\n    if (!isNonEmptyString(input.pageId))\n        throw new TypeError(\"target.pageId must be a non-empty string\");\n    if (!isNonEmptyString(input.route))\n        throw new TypeError(\"target.route must be a non-empty string\");\n    return Object.freeze({\n        pageId: input.pageId,\n        route: input.route,\n        ...(input.params === undefined\n            ? {}\n            : { params: closeJson(input.params, sample, [\"target\", \"params\"], new Set<object>()) }),\n    });\n}\nfunction freezeLocalizedText(value: LocalizedText, sample: Sample, path: readonly string[]): LocalizedText {\n    if (typeof value === \"string\")\n        return value;\n    const closed = closeJson(value, sample, path, new Set<object>());\n    if (Array.isArray(closed) || closed === null || typeof closed !== \"object\") {\n        throw new TypeError(`${path.join(\".\")} must be a string or locale map`);\n    }\n    const entries = Object.entries(closed);\n    if (entries.length === 0 || entries.some(([locale, text]) => !isNonEmptyString(locale) || typeof text !== \"string\")) {\n        throw new TypeError(`${path.join(\".\")} must be a non-empty locale map of strings`);\n    }\n    const result: Record<string, string> = Object.create(null) as Record<string, string>;\n    for (const [locale, text] of entries) {\n        // The validation above proves this is a locale-string pair.\n        result[locale] = text as string;\n    }\n    return Object.freeze(result);\n}\nfunction freezeTextProjections(value: readonly ResolvedPageTextProjection[], sample: Sample): readonly ResolvedPageTextProjection[] {\n    if (!Array.isArray(value) || value.length === 0) {\n        throw new TypeError(\"a resolved Page must contain at least one text projection\");\n    }\n    const seen = new Set<string>();\n    const closed = value.map((projection, index) => {\n        if (projection === null || typeof projection !== \"object\" || Array.isArray(projection)) {\n            throw new TypeError(`text[${index}] must be a projection object`);\n        }\n        if (rejectLiveCapability(projection, sample, [\"text\", String(index)])) {\n            throw new TypeError(`text[${index}] retains a live Sample capability`);\n        }\n        if (!isNonEmptyString(projection.locale) || !isPositiveSafeInteger(projection.width) || typeof projection.text !== \"string\") {\n            throw new TypeError(`text[${index}] must contain locale, positive width, and text`);\n        }\n        const key = `${projection.locale}\\u0000${projection.width}`;\n        if (seen.has(key))\n            throw new TypeError(`text projection ${JSON.stringify(key)} is duplicated`);\n        seen.add(key);\n        return Object.freeze({ locale: projection.locale, width: projection.width, text: projection.text });\n    });\n    return Object.freeze(closed.sort((left, right) => compareUtf8(left.locale, right.locale) || left.width - right.width));\n}\nfunction freezeWebProjections(value: readonly ResolvedPageWebProjection[], sample: Sample): readonly ResolvedPageWebProjection[] {\n    if (!Array.isArray(value) || value.length === 0) {\n        throw new TypeError(\"a resolved Page must contain at least one web projection\");\n    }\n    const seen = new Set<string>();\n    const closed = value.map((projection, index) => {\n        if (projection === null || typeof projection !== \"object\" || Array.isArray(projection)) {\n            throw new TypeError(`web[${index}] must be a projection object`);\n        }\n        if (rejectLiveCapability(projection, sample, [\"web\", String(index)])) {\n            throw new TypeError(`web[${index}] retains a live Sample capability`);\n        }\n        if (!isNonEmptyString(projection.locale) || typeof projection.html !== \"string\") {\n            throw new TypeError(`web[${index}] must contain locale and html`);\n        }\n        if (seen.has(projection.locale))\n            throw new TypeError(`web locale ${JSON.stringify(projection.locale)} is duplicated`);\n        seen.add(projection.locale);\n        return Object.freeze({ locale: projection.locale, html: projection.html });\n    });\n    return Object.freeze(closed.sort((left, right) => compareUtf8(left.locale, right.locale)));\n}\nfunction freezeDownloads(value: readonly ResolvedPageDownloadOutput[]): readonly ResolvedPageDownload[] {\n    if (!Array.isArray(value))\n        throw new TypeError(\"downloads must be an array\");\n    const ids = new Set<string>();\n    const paths = new Set<string>();\n    const closed = value.map((download, index) => {\n        if (!isPlainDataRecord(download) || !hasExactFields(download, [\"id\", \"path\", \"mediaType\", \"bytes\", \"sha256\"], [\"id\", \"path\", \"mediaType\", \"bytes\"])) {\n            throw new TypeError(`downloads[${index}] must be a closed payload object`);\n        }\n        if (!isNonEmptyString(download.id) || !isCanonicalRelativePath(download.path) || !isNonEmptyString(download.mediaType) ||\n            !(download.bytes instanceof Uint8Array) ||\n            (download.sha256 !== undefined && !isNonEmptyString(download.sha256))) {\n            throw new TypeError(`downloads[${index}] has an invalid payload`);\n        }\n        if (ids.has(download.id) || paths.has(download.path)) {\n            throw new TypeError(`downloads[${index}] repeats an id or path`);\n        }\n        ids.add(download.id);\n        paths.add(download.path);\n        // A non-empty TypedArray cannot be Object.freeze()'d by ECMAScript. The\n        // frozen wrapper owns this fresh copy, so later mutation of the author's\n        // buffer cannot alter the resolved payload.\n        const bytes = new Uint8Array(download.bytes);\n        return Object.freeze({\n            id: download.id,\n            path: download.path,\n            mediaType: download.mediaType,\n            bytes,\n            byteLength: bytes.byteLength,\n            ...(download.sha256 === undefined ? {} : { sha256: download.sha256 }),\n        });\n    });\n    return Object.freeze(closed.sort((left, right) => compareUtf8(left.path, right.path) || compareUtf8(left.id, right.id)));\n}\nfunction freezeAssets(value: readonly ResolvedPageAssetOutput[]): readonly ResolvedPageAsset[] {\n    if (!Array.isArray(value))\n        throw new TypeError(\"assets must be an array\");\n    const paths = new Set<string>();\n    const closed = value.map((asset, index) => {\n        if (!isPlainDataRecord(asset) || !hasExactFields(asset, [\"kind\", \"path\", \"mediaType\", \"bytes\", \"sha256\"], [\"kind\", \"path\", \"mediaType\", \"bytes\"])) {\n            throw new TypeError(`assets[${index}] must be a closed payload object`);\n        }\n        if (!isResolvedPageAssetKind(asset.kind) || !isCanonicalRelativePath(asset.path) ||\n            !isNonEmptyString(asset.mediaType) || !(asset.bytes instanceof Uint8Array) ||\n            (asset.sha256 !== undefined && !isNonEmptyString(asset.sha256))) {\n            throw new TypeError(`assets[${index}] has an invalid payload`);\n        }\n        if (paths.has(asset.path))\n            throw new TypeError(`assets[${index}] repeats a path`);\n        paths.add(asset.path);\n        // TypedArray elements cannot be frozen by ECMAScript. The frozen wrapper\n        // owns this independent payload; callers cannot mutate the author's copy.\n        const bytes = new Uint8Array(asset.bytes);\n        return Object.freeze({\n            kind: asset.kind,\n            path: asset.path,\n            mediaType: asset.mediaType,\n            bytes,\n            byteLength: bytes.byteLength,\n            ...(asset.sha256 === undefined ? {} : { sha256: asset.sha256 }),\n        });\n    });\n    return Object.freeze(closed.sort((left, right) => compareUtf8(left.path, right.path) ||\n        compareUtf8(left.kind, right.kind) ||\n        compareUtf8(left.mediaType, right.mediaType)));\n}\n/** A full revision receives one namespace of emitted paths across payload kinds. */\nfunction assertDistinctPayloadPaths(downloads: readonly ResolvedPageDownload[], assets: readonly ResolvedPageAsset[]): void {\n    const downloadPaths = new Set(downloads.map((download) => download.path));\n    for (const asset of assets) {\n        if (downloadPaths.has(asset.path)) {\n            throw new TypeError(`asset path ${JSON.stringify(asset.path)} conflicts with a download path`);\n        }\n    }\n}\nfunction closeJson(value: unknown, sample: Sample, path: readonly string[], active: Set<object>): JsonValue {\n    if (value === null || typeof value === \"boolean\" || typeof value === \"string\")\n        return value;\n    if (typeof value === \"number\") {\n        if (!Number.isFinite(value))\n            throw new TypeError(`${path.join(\".\")} contains a non-finite number`);\n        return value;\n    }\n    if (typeof value === \"undefined\" || typeof value === \"bigint\" || typeof value === \"symbol\" || typeof value === \"function\") {\n        throw new TypeError(`${path.join(\".\")} contains a non-closed value`);\n    }\n    if (rejectLiveCapability(value, sample, path)) {\n        throw new TypeError(`${path.join(\".\")} retains a live Sample capability`);\n    }\n    if (active.has(value))\n        throw new TypeError(`${path.join(\".\")} contains a cycle`);\n    active.add(value);\n    try {\n        if (Array.isArray(value)) {\n            return Object.freeze(value.map((entry, index) => closeJson(entry, sample, [...path, String(index)], active)));\n        }\n        if (!isPlainDataRecord(value)) {\n            throw new TypeError(`${path.join(\".\")} must be a plain data object`);\n        }\n        const result: Record<string, JsonValue> = Object.create(null) as Record<string, JsonValue>;\n        for (const key of Object.keys(value).sort(compareUtf8)) {\n            result[key] = closeJson(value[key], sample, [...path, key], active);\n        }\n        return Object.freeze(result);\n    }\n    finally {\n        active.delete(value);\n    }\n}\nfunction rejectLiveCapability(value: object, sample: Sample, _path: readonly string[]): boolean {\n    if (value === sample)\n        return true;\n    const brand = Object.getOwnPropertyDescriptor(value, sampleCapabilityTypeId);\n    if (brand !== undefined && \"value\" in brand && brand.value === true)\n        return true;\n    const kind = Object.getOwnPropertyDescriptor(value, \"kind\");\n    const snapshot = Object.getOwnPropertyDescriptor(value, \"snapshot\");\n    return kind !== undefined && \"value\" in kind && kind.value === \"analysis-sample\" && snapshot !== undefined;\n}\nfunction isPlainDataRecord(value: object): value is Readonly<Record<string, unknown>> {\n    if (Object.getPrototypeOf(value) !== Object.prototype && Object.getPrototypeOf(value) !== null)\n        return false;\n    for (const key of Reflect.ownKeys(value)) {\n        if (typeof key !== \"string\")\n            return false;\n        const descriptor = Object.getOwnPropertyDescriptor(value, key);\n        if (descriptor === undefined || !descriptor.enumerable || !(\"value\" in descriptor))\n            return false;\n    }\n    return true;\n}\nfunction hasExactFields(value: Readonly<Record<string, unknown>>, allowed: readonly string[], required: readonly string[]): boolean {\n    const keys = Object.getOwnPropertyNames(value);\n    return keys.every((key) => allowed.includes(key)) &&\n        required.every((key) => Object.hasOwn(value, key));\n}\nfunction isNonEmptyString(value: unknown): value is string {\n    return typeof value === \"string\" && value.length > 0;\n}\nfunction isPositiveSafeInteger(value: unknown): value is number {\n    return typeof value === \"number\" && Number.isSafeInteger(value) && value > 0;\n}\nfunction isResolvedPageAssetKind(value: unknown): value is ResolvedPageAssetKind {\n    return value === \"style\" || value === \"script\" || value === \"source\" || value === \"diff\" || value === \"other\";\n}\nfunction isCanonicalRelativePath(value: unknown): value is string {\n    if (!isNonEmptyString(value) || value.startsWith(\"/\") || value.endsWith(\"/\") || value.includes(\"\\\\\") || value.includes(\"\\u0000\")) {\n        return false;\n    }\n    return value.split(\"/\").every((segment) => segment.length > 0 && segment !== \".\" && segment !== \"..\");\n}\nconst textEncoder = new TextEncoder();\n/** UTF-8 byte ordering is the canonical ordering shared by machine output. */\nexport function compareUtf8(left: string, right: string): number {\n    if (left === right)\n        return 0;\n    const leftBytes = textEncoder.encode(left);\n    const rightBytes = textEncoder.encode(right);\n    const length = Math.min(leftBytes.length, rightBytes.length);\n    for (let index = 0; index < length; index += 1) {\n        const difference = leftBytes[index]! - rightBytes[index]!;\n        if (difference !== 0)\n            return difference;\n    }\n    return leftBytes.length - rightBytes.length;\n}\n"]}

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

@@ -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.cjs";
+import type { LocalizedText } from "../../shared/types.cjs";
+/** 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.d.mts

@@ -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.mjs";
+import type { LocalizedText } from "../../shared/types.mjs";
+/** 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;