niceeval 0.12.2-canary.31 → 0.13.0

package/dist/report/host/node.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"node.js","sourceRoot":"","sources":["node.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdir, open as openFile, stat, writeFile } from \"node:fs/promises\";\nimport { dirname, relative, resolve, sep } from \"node:path\";\nimport { Context, Effect } from \"effect\";\nimport type * as Scope from \"effect/Scope\";\nimport { openReportViewSession, type OpenReportViewSessionInput, type ReportViewOpenError, type ReportViewSession, } from \"./view-session.ts\";\nimport type { ReportFileSystemError, ReportFileSystemFailure, ReportHostOutputPath, ReportFileSystemService, ReportExportTargetExists, } from \"./static.ts\";\nimport { openViewServer, type NodeViewServerError, type ReportViewServer, type ViewOptions, } from \"../../view/server.ts\";\nexport { basalt, chalk, defineTheme, isThemeDefinition, themeStylesheet, } from \"./node/theme.ts\";\nexport type { ReportTheme, ThemeColor, ThemeDefinition, ThemeFontSize, ThemeFontTokens, ThemeHex, ThemeRadius, ThemeSeries, } from \"./node/theme.ts\";\nexport { loadTrustedReportConfig, loadTrustedReportModule, loadTrustedThemeModule, resolveTrustedModulePath, ReportModuleLoadError, } from \"./node/loader.ts\";\nexport type { LoadedTrustedConfig, LoadedTrustedReport, LoadedTrustedTheme, ReportModuleLoadCode, ReportModuleLoadStage, } from \"./node/loader.ts\";\nexport type { NodeViewServerError, ReportViewServer, ViewOptions, } from \"../../view/server.ts\";\nexport type { OpenReportViewSessionInput, ReportViewExecutionRebuild, ReportViewRebuild, ReportViewThemeRebuild, } from \"./view-session.ts\";\n/** Node host request after its loader/watcher has closed over all live inputs. */\nexport type ReportViewRequest = OpenReportViewSessionInput;\nexport interface NodeReportViewHostService {\n    readonly open: (request: ReportViewRequest) => Effect.Effect<ReportViewSession, ReportViewOpenError, Scope.Scope>;\n    /** The live Node transport/watch composition, when this host provides it. */\n    readonly serve?: (options: ViewOptions) => Effect.Effect<ReportViewServer, NodeViewServerError | ReportViewOpenError, Scope.Scope>;\n}\n/**\n * Node-only orchestration seam. The live implementation can add a watcher,\n * module loader, and HTTP server without changing the fixed-execution session\n * contract or accepting Record service objects from callers.\n */\nexport class NodeReportViewHost extends Context.Tag(\"@niceeval/report/NodeReportViewHost\")<NodeReportViewHost, NodeReportViewHostService>() {\n}\nexport const NodeReportViewHostLive: NodeReportViewHostService = Object.freeze({\n    open: openReportViewSession,\n    serve: openViewServer,\n});\nexport function openNodeReportView(request: ReportViewRequest): Effect.Effect<ReportViewSession, ReportViewOpenError, Scope.Scope | NodeReportViewHost> {\n    return Effect.flatMap(NodeReportViewHost, (host) => host.open(request));\n}\n/** Opens the HTTP and watcher host around caller-supplied fixed rebuilds; host defaults to loopback. */\nexport function openNodeReportViewServer(options: ViewOptions): Effect.Effect<ReportViewServer, NodeViewServerError | ReportViewOpenError, Scope.Scope | NodeReportViewHost> {\n    return Effect.flatMap(NodeReportViewHost, (host) => host.serve === undefined\n        ? Effect.fail(Object.freeze({\n            code: \"report-view-server-failed\" as const,\n            operation: \"open\" as const,\n            reason: \"the configured Node Report host does not provide an HTTP server\",\n        }))\n        : host.serve(options));\n}\n/**\n * Concrete Node filesystem boundary for static exports. The exporter itself\n * remains platform-neutral and sees only this Effect service.\n */\nexport function makeNodeReportFileSystem(): ReportFileSystemService {\n    return Object.freeze({\n        // This deliberately has no success cache. Every export invocation must\n        // re-check its target so a completed or incomplete prior directory is\n        // consistently reported as target-exists before its first file write.\n        prepareOutput: (out: string) => Effect.tryPromise({\n            try: async () => {\n                const root = resolve(out);\n                await mkdir(dirname(root), { recursive: true });\n                try {\n                    await mkdir(root);\n                }\n                catch (error) {\n                    if (isAlreadyExists(error))\n                        throw new OutputTargetExistsError();\n                    throw error;\n                }\n            },\n            catch: (error): ReportFileSystemFailure => fileSystemFailure(\"prepare-output\", error),\n        }),\n        writeFile: (input: {\n            readonly out: string;\n            readonly path: ReportHostOutputPath;\n            readonly bytes: Uint8Array;\n        }) => Effect.tryPromise({\n            try: async () => {\n                const root = await preparedOutputRoot(input.out);\n                const target = resolve(root, input.path.value);\n                if (!isOutputChild(root, target)) {\n                    throw new Error(`Report host output escapes its root: ${input.path.value}`);\n                }\n                await mkdir(dirname(target), { recursive: true });\n                await writeFile(target, input.bytes, { flag: \"wx\" });\n            },\n            catch: (error): ReportFileSystemFailure => fileSystemFailure(\"write\", error),\n        }),\n        writeCompleteMarker: (out: string) => Effect.tryPromise({\n            try: async () => {\n                const root = await preparedOutputRoot(out);\n                const marker = resolve(root, \"_niceeval/complete\");\n                await mkdir(dirname(marker), { recursive: true });\n                await writeFile(marker, new Uint8Array(), { flag: \"wx\" });\n            },\n            catch: (error): ReportFileSystemFailure => fileSystemFailure(\"complete-marker\", error),\n        }),\n        syncDirectory: (out: string) => {\n            const root = resolve(out);\n            const acquire = Effect.tryPromise({\n                try: () => openFile(root, \"r\"),\n                catch: (error): ReportFileSystemFailure => fileSystemFailure(\"sync-directory\", error),\n            });\n            return Effect.scoped(Effect.acquireRelease(acquire, (handle) => Effect.tryPromise({\n                try: () => handle.close(),\n                // A close failure cannot produce a second public filesystem error\n                // after the primary operation; the handle is nevertheless scoped.\n                catch: () => undefined,\n            }).pipe(Effect.ignore)).pipe(Effect.flatMap((handle) => Effect.tryPromise({\n                try: () => handle.sync(),\n                catch: (error): ReportFileSystemFailure => fileSystemFailure(\"sync-directory\", error),\n            }))));\n        },\n    });\n}\nexport const NodeReportFileSystemLive: ReportFileSystemService = makeNodeReportFileSystem();\n/**\n * `writeFile` and the completion marker are valid only after the exporter has\n * prepared this invocation's root. They may make nested directories, but can\n * never recreate a missing root and silently bypass `prepareOutput`.\n */\nasync function preparedOutputRoot(out: string): Promise<string> {\n    const root = resolve(out);\n    const metadata = await stat(root);\n    if (!metadata.isDirectory()) {\n        throw new Error(\"the prepared report output root is not a directory\");\n    }\n    return root;\n}\nfunction isOutputChild(root: string, target: string): boolean {\n    const path = relative(root, target);\n    return path === \"\" || (!path.startsWith(`..${sep}`) && path !== \"..\" && !path.startsWith(sep));\n}\nclass OutputTargetExistsError extends Error {\n}\nfunction isAlreadyExists(error: unknown): boolean {\n    return typeof error === \"object\" && error !== null &&\n        \"code\" in error && (error as {\n        readonly code?: unknown;\n    }).code === \"EEXIST\";\n}\nfunction fileSystemFailure(operation: string, error: unknown): ReportFileSystemError | ReportExportTargetExists {\n    if (error instanceof OutputTargetExistsError) {\n        return Object.freeze({ code: \"report-export-target-exists\" });\n    }\n    return Object.freeze({\n        code: \"report-export-write-failed\",\n        // The public error is intentionally stable and never includes a Node\n        // errno message, absolute target path, or caller-provided filesystem text.\n        operation,\n    });\n}\n"]}
+{"version":3,"file":"node.js","sourceRoot":"","sources":["node.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdir, open as openFile, stat, writeFile } from \"node:fs/promises\";\nimport { dirname, relative, resolve, sep } from \"node:path\";\nimport { Context, Effect } from \"effect\";\nimport type * as Scope from \"effect/Scope\";\nimport { openReportViewSession, type OpenReportViewSessionInput, type ReportViewOpenError, type ReportViewSession, } from \"./view-session.ts\";\nimport type { ReportFileSystemError, ReportFileSystemFailure, ReportHostOutputPath, ReportFileSystemService, ReportExportTargetExists, } from \"./static.ts\";\nimport { openViewServer, type NodeViewServerError, type ReportViewServer, type ViewOptions, } from \"../../view/server.ts\";\nexport { basalt, chalk, defineTheme, isThemeDefinition, themeStylesheet, } from \"../theme.ts\";\nexport type { ReportTheme, ThemeColor, ThemeDefinition, ThemeHex, ThemeSeries, } from \"../theme.ts\";\nexport { loadTrustedReportConfig, loadTrustedReportModule, loadTrustedThemeModule, resolveTrustedModulePath, ReportModuleLoadError, } from \"./node/loader.ts\";\nexport type { LoadedTrustedConfig, LoadedTrustedReport, LoadedTrustedTheme, ReportModuleLoadCode, ReportModuleLoadStage, } from \"./node/loader.ts\";\nexport type { NodeViewServerError, ReportViewServer, ViewOptions, } from \"../../view/server.ts\";\nexport type { OpenReportViewSessionInput, ReportViewRebuild, } from \"./view-session.ts\";\n/** Node host request after its loader/watcher has closed over all live inputs. */\nexport type ReportViewRequest = OpenReportViewSessionInput;\nexport interface NodeReportViewHostService {\n    readonly open: (request: ReportViewRequest) => Effect.Effect<ReportViewSession, ReportViewOpenError, Scope.Scope>;\n    /** The live Node transport/watch composition, when this host provides it. */\n    readonly serve?: (options: ViewOptions) => Effect.Effect<ReportViewServer, NodeViewServerError | ReportViewOpenError, Scope.Scope>;\n}\n/**\n * Node-only orchestration seam. The live implementation can add a watcher,\n * module loader, and HTTP server without changing the fixed-execution session\n * contract or accepting Record service objects from callers.\n */\nexport class NodeReportViewHost extends Context.Tag(\"@niceeval/report/NodeReportViewHost\")<NodeReportViewHost, NodeReportViewHostService>() {\n}\nexport const NodeReportViewHostLive: NodeReportViewHostService = Object.freeze({\n    open: openReportViewSession,\n    serve: openViewServer,\n});\nexport function openNodeReportView(request: ReportViewRequest): Effect.Effect<ReportViewSession, ReportViewOpenError, Scope.Scope | NodeReportViewHost> {\n    return Effect.flatMap(NodeReportViewHost, (host) => host.open(request));\n}\n/** Opens the HTTP and watcher host around caller-supplied fixed rebuilds; host defaults to loopback. */\nexport function openNodeReportViewServer(options: ViewOptions): Effect.Effect<ReportViewServer, NodeViewServerError | ReportViewOpenError, Scope.Scope | NodeReportViewHost> {\n    return Effect.flatMap(NodeReportViewHost, (host) => host.serve === undefined\n        ? Effect.fail(Object.freeze({\n            code: \"report-view-server-failed\" as const,\n            operation: \"open\" as const,\n            reason: \"the configured Node Report host does not provide an HTTP server\",\n        }))\n        : host.serve(options));\n}\n/**\n * Concrete Node filesystem boundary for static exports. The exporter itself\n * remains platform-neutral and sees only this Effect service.\n */\nexport function makeNodeReportFileSystem(): ReportFileSystemService {\n    return Object.freeze({\n        // This deliberately has no success cache. Every export invocation must\n        // re-check its target so a completed or incomplete prior directory is\n        // consistently reported as target-exists before its first file write.\n        prepareOutput: (out: string) => Effect.tryPromise({\n            try: async () => {\n                const root = resolve(out);\n                await mkdir(dirname(root), { recursive: true });\n                try {\n                    await mkdir(root);\n                }\n                catch (error) {\n                    if (isAlreadyExists(error))\n                        throw new OutputTargetExistsError();\n                    throw error;\n                }\n            },\n            catch: (error): ReportFileSystemFailure => fileSystemFailure(\"prepare-output\", error),\n        }),\n        writeFile: (input: {\n            readonly out: string;\n            readonly path: ReportHostOutputPath;\n            readonly bytes: Uint8Array;\n        }) => Effect.tryPromise({\n            try: async () => {\n                const root = await preparedOutputRoot(input.out);\n                const target = resolve(root, input.path.value);\n                if (!isOutputChild(root, target)) {\n                    throw new Error(`Report host output escapes its root: ${input.path.value}`);\n                }\n                await mkdir(dirname(target), { recursive: true });\n                await writeFile(target, input.bytes, { flag: \"wx\" });\n            },\n            catch: (error): ReportFileSystemFailure => fileSystemFailure(\"write\", error),\n        }),\n        writeCompleteMarker: (out: string) => Effect.tryPromise({\n            try: async () => {\n                const root = await preparedOutputRoot(out);\n                const marker = resolve(root, \"_niceeval/complete\");\n                await mkdir(dirname(marker), { recursive: true });\n                await writeFile(marker, new Uint8Array(), { flag: \"wx\" });\n            },\n            catch: (error): ReportFileSystemFailure => fileSystemFailure(\"complete-marker\", error),\n        }),\n        syncDirectory: (out: string) => {\n            const root = resolve(out);\n            const acquire = Effect.tryPromise({\n                try: () => openFile(root, \"r\"),\n                catch: (error): ReportFileSystemFailure => fileSystemFailure(\"sync-directory\", error),\n            });\n            return Effect.scoped(Effect.acquireRelease(acquire, (handle) => Effect.tryPromise({\n                try: () => handle.close(),\n                // A close failure cannot produce a second public filesystem error\n                // after the primary operation; the handle is nevertheless scoped.\n                catch: () => undefined,\n            }).pipe(Effect.ignore)).pipe(Effect.flatMap((handle) => Effect.tryPromise({\n                try: () => handle.sync(),\n                catch: (error): ReportFileSystemFailure => fileSystemFailure(\"sync-directory\", error),\n            }))));\n        },\n    });\n}\nexport const NodeReportFileSystemLive: ReportFileSystemService = makeNodeReportFileSystem();\n/**\n * `writeFile` and the completion marker are valid only after the exporter has\n * prepared this invocation's root. They may make nested directories, but can\n * never recreate a missing root and silently bypass `prepareOutput`.\n */\nasync function preparedOutputRoot(out: string): Promise<string> {\n    const root = resolve(out);\n    const metadata = await stat(root);\n    if (!metadata.isDirectory()) {\n        throw new Error(\"the prepared report output root is not a directory\");\n    }\n    return root;\n}\nfunction isOutputChild(root: string, target: string): boolean {\n    const path = relative(root, target);\n    return path === \"\" || (!path.startsWith(`..${sep}`) && path !== \"..\" && !path.startsWith(sep));\n}\nclass OutputTargetExistsError extends Error {\n}\nfunction isAlreadyExists(error: unknown): boolean {\n    return typeof error === \"object\" && error !== null &&\n        \"code\" in error && (error as {\n        readonly code?: unknown;\n    }).code === \"EEXIST\";\n}\nfunction fileSystemFailure(operation: string, error: unknown): ReportFileSystemError | ReportExportTargetExists {\n    if (error instanceof OutputTargetExistsError) {\n        return Object.freeze({ code: \"report-export-target-exists\" });\n    }\n    return Object.freeze({\n        code: \"report-export-write-failed\",\n        // The public error is intentionally stable and never includes a Node\n        // errno message, absolute target path, or caller-provided filesystem text.\n        operation,\n    });\n}\n"]}

package/dist/report/host/node.d.cts

@@ -3,12 +3,12 @@ import type * as Scope from "effect/Scope";
 import { type OpenReportViewSessionInput, type ReportViewOpenError, type ReportViewSession } from "./view-session.cjs";
 import type { ReportFileSystemService } from "./static.cjs";
 import { type NodeViewServerError, type ReportViewServer, type ViewOptions } from "../../view/server.cjs";
-export { basalt, chalk, defineTheme, isThemeDefinition, themeStylesheet, } from "./node/theme.cjs";
-export type { ReportTheme, ThemeColor, ThemeDefinition, ThemeFontSize, ThemeFontTokens, ThemeHex, ThemeRadius, ThemeSeries, } from "./node/theme.cjs";
+export { basalt, chalk, defineTheme, isThemeDefinition, themeStylesheet, } from "../theme.cjs";
+export type { ReportTheme, ThemeColor, ThemeDefinition, ThemeHex, ThemeSeries, } from "../theme.cjs";
 export { loadTrustedReportConfig, loadTrustedReportModule, loadTrustedThemeModule, resolveTrustedModulePath, ReportModuleLoadError, } from "./node/loader.cjs";
 export type { LoadedTrustedConfig, LoadedTrustedReport, LoadedTrustedTheme, ReportModuleLoadCode, ReportModuleLoadStage, } from "./node/loader.cjs";
 export type { NodeViewServerError, ReportViewServer, ViewOptions, } from "../../view/server.cjs";
-export type { OpenReportViewSessionInput, ReportViewExecutionRebuild, ReportViewRebuild, ReportViewThemeRebuild, } from "./view-session.cjs";
+export type { OpenReportViewSessionInput, ReportViewRebuild, } from "./view-session.cjs";
 /** Node host request after its loader/watcher has closed over all live inputs. */
 export type ReportViewRequest = OpenReportViewSessionInput;
 export interface NodeReportViewHostService {

package/dist/report/host/node.d.mts

@@ -3,12 +3,12 @@ import type * as Scope from "effect/Scope";
 import { type OpenReportViewSessionInput, type ReportViewOpenError, type ReportViewSession } from "./view-session.mjs";
 import type { ReportFileSystemService } from "./static.mjs";
 import { type NodeViewServerError, type ReportViewServer, type ViewOptions } from "../../view/server.mjs";
-export { basalt, chalk, defineTheme, isThemeDefinition, themeStylesheet, } from "./node/theme.mjs";
-export type { ReportTheme, ThemeColor, ThemeDefinition, ThemeFontSize, ThemeFontTokens, ThemeHex, ThemeRadius, ThemeSeries, } from "./node/theme.mjs";
+export { basalt, chalk, defineTheme, isThemeDefinition, themeStylesheet, } from "../theme.mjs";
+export type { ReportTheme, ThemeColor, ThemeDefinition, ThemeHex, ThemeSeries, } from "../theme.mjs";
 export { loadTrustedReportConfig, loadTrustedReportModule, loadTrustedThemeModule, resolveTrustedModulePath, ReportModuleLoadError, } from "./node/loader.mjs";
 export type { LoadedTrustedConfig, LoadedTrustedReport, LoadedTrustedTheme, ReportModuleLoadCode, ReportModuleLoadStage, } from "./node/loader.mjs";
 export type { NodeViewServerError, ReportViewServer, ViewOptions, } from "../../view/server.mjs";
-export type { OpenReportViewSessionInput, ReportViewExecutionRebuild, ReportViewRebuild, ReportViewThemeRebuild, } from "./view-session.mjs";
+export type { OpenReportViewSessionInput, ReportViewRebuild, } from "./view-session.mjs";
 /** Node host request after its loader/watcher has closed over all live inputs. */
 export type ReportViewRequest = OpenReportViewSessionInput;
 export interface NodeReportViewHostService {

package/dist/report/host/node.d.ts

@@ -3,12 +3,12 @@ import type * as Scope from "effect/Scope";
 import { type OpenReportViewSessionInput, type ReportViewOpenError, type ReportViewSession } from "./view-session.js";
 import type { ReportFileSystemService } from "./static.js";
 import { type NodeViewServerError, type ReportViewServer, type ViewOptions } from "../../view/server.js";
-export { basalt, chalk, defineTheme, isThemeDefinition, themeStylesheet, } from "./node/theme.js";
-export type { ReportTheme, ThemeColor, ThemeDefinition, ThemeFontSize, ThemeFontTokens, ThemeHex, ThemeRadius, ThemeSeries, } from "./node/theme.js";
+export { basalt, chalk, defineTheme, isThemeDefinition, themeStylesheet, } from "../theme.js";
+export type { ReportTheme, ThemeColor, ThemeDefinition, ThemeHex, ThemeSeries, } from "../theme.js";
 export { loadTrustedReportConfig, loadTrustedReportModule, loadTrustedThemeModule, resolveTrustedModulePath, ReportModuleLoadError, } from "./node/loader.js";
 export type { LoadedTrustedConfig, LoadedTrustedReport, LoadedTrustedTheme, ReportModuleLoadCode, ReportModuleLoadStage, } from "./node/loader.js";
 export type { NodeViewServerError, ReportViewServer, ViewOptions, } from "../../view/server.js";
-export type { OpenReportViewSessionInput, ReportViewExecutionRebuild, ReportViewRebuild, ReportViewThemeRebuild, } from "./view-session.js";
+export type { OpenReportViewSessionInput, ReportViewRebuild, } from "./view-session.js";
 /** Node host request after its loader/watcher has closed over all live inputs. */
 export type ReportViewRequest = OpenReportViewSessionInput;
 export interface NodeReportViewHostService {

package/dist/report/host/progress.cjs

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportHostProgressObserver = void 0;
+exports.withReportHostPhase = withReportHostPhase;
+const effect_1 = require("effect");
+const noReportHostProgress = Object.freeze({ report: () => { } });
+/** Package-private observation seam used by the CLI without expanding the public Host SDK. */
+class ReportHostProgressObserver extends effect_1.Context.Reference()("@niceeval/report/host/ReportHostProgressObserver", { defaultValue: () => noReportHostProgress }) {
+}
+exports.ReportHostProgressObserver = ReportHostProgressObserver;
+function reportBestEffort(observer, event) {
+    return effect_1.Effect.sync(() => observer.report(event)).pipe(effect_1.Effect.catchAllCause(() => effect_1.Effect.void));
+}
+function outcomeOf(exit) {
+    if (effect_1.Exit.isSuccess(exit))
+        return "success";
+    if (effect_1.Cause.isInterruptedOnly(exit.cause))
+        return "interrupted";
+    if (effect_1.Option.isSome(effect_1.Cause.dieOption(exit.cause)))
+        return "defect";
+    return "failure";
+}
+/** Emits balanced phase events while preserving the original success, typed failure, defect, and interruption. */
+function withReportHostPhase(phase, effect) {
+    return effect_1.Effect.gen(function* () {
+        const observer = yield* ReportHostProgressObserver;
+        const startedAt = yield* effect_1.Clock.currentTimeNanos;
+        yield* reportBestEffort(observer, { type: "start", phase });
+        return yield* effect.pipe(effect_1.Effect.onExit((exit) => effect_1.Effect.gen(function* () {
+            const completedAt = yield* effect_1.Clock.currentTimeNanos;
+            const durationMs = Number(completedAt - startedAt) / 1000000;
+            yield* reportBestEffort(observer, {
+                type: "end",
+                phase,
+                outcome: outcomeOf(exit),
+                durationMs: Math.max(0, durationMs),
+            });
+        })));
+    });
+}
+//# sourceMappingURL=progress.cjs.map

package/dist/report/host/progress.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["progress.ts"],"names":[],"mappings":";;;AAgCA,kDAgBC;AAhDD,mCAAqE;AAerE,MAAM,oBAAoB,GAAsC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;AACrG,8FAA8F;AAC9F,MAAa,0BAA2B,SAAQ,gBAAO,CAAC,SAAS,EAA8B,CAAC,kDAAkD,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,oBAAoB,EAAE,CAAC;CAChM;AADD,gEACC;AACD,SAAS,gBAAgB,CAAC,QAA2C,EAAE,KAA8B;IACjG,OAAO,eAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,eAAM,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,eAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AACnG,CAAC;AACD,SAAS,SAAS,CAAI,IAA2B;IAC7C,IAAI,aAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QACpB,OAAO,SAAS,CAAC;IACrB,IAAI,cAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC;QACnC,OAAO,aAAa,CAAC;IACzB,IAAI,eAAM,CAAC,MAAM,CAAC,cAAK,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1C,OAAO,QAAQ,CAAC;IACpB,OAAO,SAAS,CAAC;AACrB,CAAC;AACD,kHAAkH;AAClH,SAAgB,mBAAmB,CAAU,KAAsB,EAAE,MAA8B;IAC/F,OAAO,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACvB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,0BAA0B,CAAC;QACnD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,cAAK,CAAC,gBAAgB,CAAC;QAChD,KAAK,CAAC,CAAC,gBAAgB,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5D,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,eAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClE,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,cAAK,CAAC,gBAAgB,CAAC;YAClD,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC;YAC7D,KAAK,CAAC,CAAC,gBAAgB,CAAC,QAAQ,EAAE;gBAC9B,IAAI,EAAE,KAAK;gBACX,KAAK;gBACL,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC;gBACxB,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC;aACtC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC,CAAC,CAAC;IACT,CAAC,CAAC,CAAC;AACP,CAAC","sourcesContent":["import { Cause, Clock, Context, Effect, Exit, Option } from \"effect\";\nexport type ReportHostPhase = \"record-open\" | \"selection\" | \"sample-open\" | \"report-execution\";\nexport type ReportHostPhaseOutcome = \"success\" | \"failure\" | \"defect\" | \"interrupted\";\nexport type ReportHostProgressEvent = {\n    readonly type: \"start\";\n    readonly phase: ReportHostPhase;\n} | {\n    readonly type: \"end\";\n    readonly phase: ReportHostPhase;\n    readonly outcome: ReportHostPhaseOutcome;\n    readonly durationMs: number;\n};\nexport interface ReportHostProgressObserverService {\n    readonly report: (event: ReportHostProgressEvent) => void;\n}\nconst noReportHostProgress: ReportHostProgressObserverService = Object.freeze({ report: () => { } });\n/** Package-private observation seam used by the CLI without expanding the public Host SDK. */\nexport class ReportHostProgressObserver extends Context.Reference<ReportHostProgressObserver>()(\"@niceeval/report/host/ReportHostProgressObserver\", { defaultValue: () => noReportHostProgress }) {\n}\nfunction reportBestEffort(observer: ReportHostProgressObserverService, event: ReportHostProgressEvent): Effect.Effect<void> {\n    return Effect.sync(() => observer.report(event)).pipe(Effect.catchAllCause(() => Effect.void));\n}\nfunction outcomeOf<E>(exit: Exit.Exit<unknown, E>): ReportHostPhaseOutcome {\n    if (Exit.isSuccess(exit))\n        return \"success\";\n    if (Cause.isInterruptedOnly(exit.cause))\n        return \"interrupted\";\n    if (Option.isSome(Cause.dieOption(exit.cause)))\n        return \"defect\";\n    return \"failure\";\n}\n/** Emits balanced phase events while preserving the original success, typed failure, defect, and interruption. */\nexport function withReportHostPhase<A, E, R>(phase: ReportHostPhase, effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R> {\n    return Effect.gen(function* () {\n        const observer = yield* ReportHostProgressObserver;\n        const startedAt = yield* Clock.currentTimeNanos;\n        yield* reportBestEffort(observer, { type: \"start\", phase });\n        return yield* effect.pipe(Effect.onExit((exit) => Effect.gen(function* () {\n            const completedAt = yield* Clock.currentTimeNanos;\n            const durationMs = Number(completedAt - startedAt) / 1000000;\n            yield* reportBestEffort(observer, {\n                type: \"end\",\n                phase,\n                outcome: outcomeOf(exit),\n                durationMs: Math.max(0, durationMs),\n            });\n        })));\n    });\n}\n"]}

package/dist/report/host/progress.d.cts

@@ -0,0 +1,22 @@
+import { Context, Effect } from "effect";
+export type ReportHostPhase = "record-open" | "selection" | "sample-open" | "report-execution";
+export type ReportHostPhaseOutcome = "success" | "failure" | "defect" | "interrupted";
+export type ReportHostProgressEvent = {
+    readonly type: "start";
+    readonly phase: ReportHostPhase;
+} | {
+    readonly type: "end";
+    readonly phase: ReportHostPhase;
+    readonly outcome: ReportHostPhaseOutcome;
+    readonly durationMs: number;
+};
+export interface ReportHostProgressObserverService {
+    readonly report: (event: ReportHostProgressEvent) => void;
+}
+declare const ReportHostProgressObserver_base: Context.ReferenceClass<ReportHostProgressObserver, "@niceeval/report/host/ReportHostProgressObserver", ReportHostProgressObserverService>;
+/** Package-private observation seam used by the CLI without expanding the public Host SDK. */
+export declare class ReportHostProgressObserver extends ReportHostProgressObserver_base {
+}
+/** Emits balanced phase events while preserving the original success, typed failure, defect, and interruption. */
+export declare function withReportHostPhase<A, E, R>(phase: ReportHostPhase, effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R>;
+export {};

package/dist/report/host/progress.d.mts

@@ -0,0 +1,22 @@
+import { Context, Effect } from "effect";
+export type ReportHostPhase = "record-open" | "selection" | "sample-open" | "report-execution";
+export type ReportHostPhaseOutcome = "success" | "failure" | "defect" | "interrupted";
+export type ReportHostProgressEvent = {
+    readonly type: "start";
+    readonly phase: ReportHostPhase;
+} | {
+    readonly type: "end";
+    readonly phase: ReportHostPhase;
+    readonly outcome: ReportHostPhaseOutcome;
+    readonly durationMs: number;
+};
+export interface ReportHostProgressObserverService {
+    readonly report: (event: ReportHostProgressEvent) => void;
+}
+declare const ReportHostProgressObserver_base: Context.ReferenceClass<ReportHostProgressObserver, "@niceeval/report/host/ReportHostProgressObserver", ReportHostProgressObserverService>;
+/** Package-private observation seam used by the CLI without expanding the public Host SDK. */
+export declare class ReportHostProgressObserver extends ReportHostProgressObserver_base {
+}
+/** Emits balanced phase events while preserving the original success, typed failure, defect, and interruption. */
+export declare function withReportHostPhase<A, E, R>(phase: ReportHostPhase, effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R>;
+export {};

package/dist/report/host/progress.d.ts

@@ -0,0 +1,22 @@
+import { Context, Effect } from "effect";
+export type ReportHostPhase = "record-open" | "selection" | "sample-open" | "report-execution";
+export type ReportHostPhaseOutcome = "success" | "failure" | "defect" | "interrupted";
+export type ReportHostProgressEvent = {
+    readonly type: "start";
+    readonly phase: ReportHostPhase;
+} | {
+    readonly type: "end";
+    readonly phase: ReportHostPhase;
+    readonly outcome: ReportHostPhaseOutcome;
+    readonly durationMs: number;
+};
+export interface ReportHostProgressObserverService {
+    readonly report: (event: ReportHostProgressEvent) => void;
+}
+declare const ReportHostProgressObserver_base: Context.ReferenceClass<ReportHostProgressObserver, "@niceeval/report/host/ReportHostProgressObserver", ReportHostProgressObserverService>;
+/** Package-private observation seam used by the CLI without expanding the public Host SDK. */
+export declare class ReportHostProgressObserver extends ReportHostProgressObserver_base {
+}
+/** Emits balanced phase events while preserving the original success, typed failure, defect, and interruption. */
+export declare function withReportHostPhase<A, E, R>(phase: ReportHostPhase, effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R>;
+export {};

package/dist/report/host/progress.js

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

package/dist/report/host/progress.js.map

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

package/dist/report/host/show-target.cjs

@@ -0,0 +1,214 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeShowTarget = executeShowTarget;
+exports.selectShowTarget = selectShowTarget;
+const effect_1 = require("effect");
+const resolved_page_ts_1 = require("../runtime/resolved-page.cjs");
+/**
+ * Executes exactly one target Page. In particular, this function never calls
+ * `params.enumerate()` because that would make `show` a hidden site build.
+ */
+function executeShowTarget(input) {
+    const selected = selectShowTarget(input.definition, input.request);
+    if (isShowTargetError(selected))
+        return effect_1.Effect.fail(selected);
+    return selected.kind === "plain"
+        ? executePlainTarget(input, selected)
+        : executeParameterizedTarget(input, selected);
+}
+/** Pure selection only; no page callback, loader, encoder, decoder, or enumeration runs here. */
+function selectShowTarget(definition, request) {
+    if (request.kind === "default") {
+        const page = definition.pages.find((candidate) => candidate.params === undefined && candidate.navigation !== false);
+        if (page === undefined)
+            return Object.freeze({ code: "report-show-target-default-missing" });
+        return plainSelection(page);
+    }
+    const page = definition.pages.find((candidate) => candidate.id === request.pageId);
+    if (page === undefined) {
+        return Object.freeze({ code: "report-show-target-page-missing", pageId: request.pageId });
+    }
+    if (request.kind === "page") {
+        if (page.params !== undefined) {
+            return Object.freeze({ code: "report-show-target-parameter-required", pageId: page.id });
+        }
+        return plainSelection(page);
+    }
+    if (page.params === undefined) {
+        return Object.freeze({ code: "report-show-target-parameter-unexpected", pageId: page.id });
+    }
+    if (!isNonEmptyString(request.key) || !isNonEmptyString(request.route)) {
+        return Object.freeze({ code: "report-show-target-route-invalid", pageId: page.id });
+    }
+    return Object.freeze({
+        kind: "parameterized",
+        page,
+        key: request.key,
+        route: request.route,
+    });
+}
+function executePlainTarget(input, selected) {
+    return effect_1.Effect.gen(function* () {
+        const loadContext = createPageLoadContext(selected.context, input.evidence);
+        const pageInput = selected.page.load === undefined
+            ? input.sample
+            : yield* invokeAuthorCallback(selected.page.id, "load", input.runAuthor, () => selected.page.load(input.sample, undefined, loadContext));
+        return yield* (0, resolved_page_ts_1.resolvePage)({
+            sample: input.sample,
+            target: selected.target,
+            render: invokeAuthorCallback(selected.page.id, "render", input.runAuthor, () => selected.page.render(pageInput, selected.context)),
+            close: (rendered, context) => invokeCloseCallback(input, selected.page.id, rendered, { ...context, page: selected.context }),
+        });
+    });
+}
+function executeParameterizedTarget(input, selected) {
+    return effect_1.Effect.gen(function* () {
+        const decoded = yield* decodeCanonicalParameters(selected.page, selected.key, input.runAuthor);
+        const context = pageContext(selected.page, decoded);
+        const target = Object.freeze({
+            pageId: selected.page.id,
+            route: selected.route,
+            params: decoded,
+        });
+        const loadContext = createPageLoadContext(context, input.evidence);
+        // Do not enumerate or impose a Host-wide parameter-member rule here.
+        // PageLoadContext.evidence and any public DomainView API are bound to this
+        // Sample and validate the concrete locator/identity a Page actually reads.
+        const pageInput = yield* invokeAuthorCallback(selected.page.id, "load", input.runAuthor, () => selected.page.load(input.sample, decoded, loadContext));
+        return yield* (0, resolved_page_ts_1.resolvePage)({
+            sample: input.sample,
+            target,
+            render: invokeAuthorCallback(selected.page.id, "render", input.runAuthor, () => selected.page.render(pageInput, context)),
+            close: (rendered, closeContext) => invokeCloseCallback(input, selected.page.id, rendered, { ...closeContext, page: context }),
+        });
+    });
+}
+/** Parameterized show always accepts only a canonical key. */
+function decodeCanonicalParameters(page, key, runAuthor) {
+    return effect_1.Effect.gen(function* () {
+        const decoded = yield* invokeAuthorCallback(page.id, "params-decode", runAuthor, () => page.params.decode(key));
+        const params = closePageParams(decoded);
+        if (params === undefined) {
+            return yield* effect_1.Effect.fail(Object.freeze({
+                code: "report-show-target-parameter-invalid",
+                pageId: page.id,
+                key,
+                reason: "decode-not-json",
+            }));
+        }
+        const encoded = yield* invokeAuthorCallback(page.id, "params-encode", runAuthor, () => page.params.encode(params));
+        if (encoded !== key) {
+            return yield* effect_1.Effect.fail(Object.freeze({
+                code: "report-show-target-parameter-invalid",
+                pageId: page.id,
+                key,
+                reason: "not-canonical",
+            }));
+        }
+        return params;
+    }).pipe(effect_1.Effect.catchAll((error) => {
+        if (error.code !== "report-show-target-callback-failed")
+            return effect_1.Effect.fail(error);
+        return effect_1.Effect.fail(Object.freeze({
+            code: "report-show-target-parameter-invalid",
+            pageId: page.id,
+            key,
+            reason: error.phase === "params-decode" ? "decode-failed" : "encode-failed",
+        }));
+    }));
+}
+function plainSelection(page) {
+    return Object.freeze({
+        kind: "plain",
+        page,
+        context: pageContext(page),
+        target: Object.freeze({ pageId: page.id, route: page.path }),
+    });
+}
+function pageContext(page, params) {
+    return Object.freeze({
+        id: page.id,
+        path: page.path,
+        title: page.title,
+        ...(params === undefined ? {} : { params }),
+    });
+}
+function createPageLoadContext(page, evidence) {
+    return Object.freeze({ page, evidence });
+}
+function invokeCloseCallback(input, pageId, rendered, context) {
+    return effect_1.Effect.suspend(() => {
+        try {
+            return runAuthorCallback(input.runAuthor, () => input.close(rendered, context));
+        }
+        catch {
+            return effect_1.Effect.fail(callbackFailed(pageId, "close"));
+        }
+    });
+}
+function invokeAuthorCallback(pageId, phase, runAuthor, callback) {
+    return effect_1.Effect.tryPromise({
+        try: () => new Promise((resolve) => resolve(runAuthorCallback(runAuthor, callback))),
+        catch: () => callbackFailed(pageId, phase),
+    });
+}
+function runAuthorCallback(runAuthor, callback) {
+    return runAuthor === undefined ? callback() : runAuthor(callback);
+}
+function callbackFailed(pageId, phase) {
+    return Object.freeze({
+        code: "report-show-target-callback-failed",
+        pageId,
+        phase,
+    });
+}
+function isShowTargetError(value) {
+    return "code" in value;
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.length > 0;
+}
+/** Closes decoded JSON before encode/load/render can observe or mutate it. */
+function closePageParams(value, active = new Set()) {
+    if (value === null || typeof value === "boolean" || typeof value === "string")
+        return value;
+    if (typeof value === "number")
+        return Number.isFinite(value) ? value : undefined;
+    if (typeof value !== "object" || value === null)
+        return undefined;
+    if (active.has(value))
+        return undefined;
+    active.add(value);
+    try {
+        if (Array.isArray(value)) {
+            const entries = [];
+            for (const entry of value) {
+                const closed = closePageParams(entry, active);
+                if (closed === undefined)
+                    return undefined;
+                entries.push(closed);
+            }
+            return Object.freeze(entries);
+        }
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype !== Object.prototype && prototype !== null)
+            return undefined;
+        const result = Object.create(null);
+        for (const key of Reflect.ownKeys(value)) {
+            if (typeof key !== "string")
+                return undefined;
+            const descriptor = Object.getOwnPropertyDescriptor(value, key);
+            if (descriptor === undefined || !descriptor.enumerable || !("value" in descriptor))
+                return undefined;
+            const closed = closePageParams(descriptor.value, active);
+            if (closed === undefined)
+                return undefined;
+            result[key] = closed;
+        }
+        return Object.freeze(Object.fromEntries(Object.entries(result).sort(([left], [right]) => (0, resolved_page_ts_1.compareUtf8)(left, right))));
+    }
+    finally {
+        active.delete(value);
+    }
+}
+//# sourceMappingURL=show-target.cjs.map

package/dist/report/host/show-target.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"show-target.js","sourceRoot":"","sources":["show-target.ts"],"names":[],"mappings":"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","sourcesContent":["import { Effect } from \"effect\";\nimport type * as Scope from \"effect/Scope\";\nimport type { JsonValue, Sample, } from \"../../analysis/contracts.ts\";\nimport type { PageContext, PageLoadContext, ReportDefinition, } from \"../definition/report.ts\";\nimport { compareUtf8, resolvePage, type LiveResolvedPageContext, type ResolvedPage, type ResolvedPageClosureError, type ResolvedPageOutput, type ResolvedPageTarget, } from \"../runtime/resolved-page.ts\";\n/** Metadata supplied to one selected Page callback while the Sample is open. */\nexport type ShowTargetPageContext = PageContext;\n/**\n * The executor consumes normalized author definitions directly. `enumerate`\n * exists on the parameterized declaration but has no call site in this file.\n */\nexport type ShowTargetPage = ReportDefinition[\"pages\"][number];\nexport type ShowTargetPlainPage = Extract<ShowTargetPage, {\n    readonly params?: never;\n}>;\nexport type ShowTargetParameterizedPage = Exclude<ShowTargetPage, ShowTargetPlainPage>;\nexport interface ShowTargetDefinition {\n    readonly pages: readonly ShowTargetPage[];\n}\nexport type ShowTargetRequest = {\n    readonly kind: \"default\";\n} | {\n    readonly kind: \"page\";\n    readonly pageId: string;\n} | {\n    readonly kind: \"parameterized-page\";\n    readonly pageId: string;\n    /** The exact incoming key that must survive decode → encode unchanged. */\n    readonly key: string;\n    /** The Host-provided concrete route for this one Page instance. */\n    readonly route: string;\n};\nexport interface ShowTargetCloseContext extends LiveResolvedPageContext {\n    readonly page: ShowTargetPageContext;\n}\n/**\n * Optional synchronous capture boundary for the exact start of an author\n * callback. Promise assimilation and Effect execution happen after it returns.\n */\nexport type ShowTargetRunAuthor = <Value>(callback: () => Value) => Value;\nexport interface ExecuteShowTargetInput<Error, Requirements> {\n    readonly definition: ShowTargetDefinition;\n    readonly sample: Sample;\n    readonly request: ShowTargetRequest;\n    /**\n     * This is the PageLoadContext evidence surface for the fixed Sample. A\n     * parameterized Page validates any locator/member it dereferences through\n     * this public API; the Host does not invent a generic member predicate or\n     * enumerate the Page to prove one exists.\n     */\n    readonly evidence: PageLoadContext[\"evidence\"];\n    /**\n     * Host-owned synchronous callback-start capture (for example,\n     * captureAnalysisIssues(...).run). When absent, callbacks run directly.\n     */\n    readonly runAuthor?: ShowTargetRunAuthor;\n    /**\n     * The private Page resolver. It resolves components and creates both text and\n     * web projections while the Sample Scope is live, then returns data only.\n     */\n    readonly close: (rendered: unknown, context: ShowTargetCloseContext) => Effect.Effect<ResolvedPageOutput, Error, Requirements>;\n}\nexport type ShowTargetError = {\n    readonly code: \"report-show-target-default-missing\";\n} | {\n    readonly code: \"report-show-target-page-missing\";\n    readonly pageId: string;\n} | {\n    readonly code: \"report-show-target-parameter-required\";\n    readonly pageId: string;\n} | {\n    readonly code: \"report-show-target-parameter-unexpected\";\n    readonly pageId: string;\n} | {\n    readonly code: \"report-show-target-route-invalid\";\n    readonly pageId: string;\n} | {\n    readonly code: \"report-show-target-parameter-invalid\";\n    readonly pageId: string;\n    readonly key: string;\n    readonly reason: \"decode-failed\" | \"decode-not-json\" | \"encode-failed\" | \"not-canonical\";\n} | {\n    readonly code: \"report-show-target-callback-failed\";\n    readonly pageId: string;\n    readonly phase: \"params-decode\" | \"params-encode\" | \"load\" | \"render\" | \"close\";\n};\ninterface SelectedPlainTarget {\n    readonly kind: \"plain\";\n    readonly page: ShowTargetPlainPage;\n    readonly context: ShowTargetPageContext;\n    readonly target: ResolvedPageTarget;\n}\ninterface SelectedParameterizedTarget {\n    readonly kind: \"parameterized\";\n    readonly page: ShowTargetParameterizedPage;\n    readonly key: string;\n    readonly route: string;\n}\ntype SelectedShowTarget = SelectedPlainTarget | SelectedParameterizedTarget;\n/**\n * Executes exactly one target Page. In particular, this function never calls\n * `params.enumerate()` because that would make `show` a hidden site build.\n */\nexport function executeShowTarget<Error, Requirements>(input: ExecuteShowTargetInput<Error, Requirements>): Effect.Effect<ResolvedPage, Error | ShowTargetError | ResolvedPageClosureError, Requirements | Scope.Scope> {\n    const selected = selectShowTarget(input.definition, input.request);\n    if (isShowTargetError(selected))\n        return Effect.fail(selected);\n    return selected.kind === \"plain\"\n        ? executePlainTarget(input, selected)\n        : executeParameterizedTarget(input, selected);\n}\n/** Pure selection only; no page callback, loader, encoder, decoder, or enumeration runs here. */\nexport function selectShowTarget(definition: ShowTargetDefinition, request: ShowTargetRequest): SelectedShowTarget | ShowTargetError {\n    if (request.kind === \"default\") {\n        const page = definition.pages.find((candidate): candidate is ShowTargetPlainPage => candidate.params === undefined && candidate.navigation !== false);\n        if (page === undefined)\n            return Object.freeze({ code: \"report-show-target-default-missing\" as const });\n        return plainSelection(page);\n    }\n    const page = definition.pages.find((candidate) => candidate.id === request.pageId);\n    if (page === undefined) {\n        return Object.freeze({ code: \"report-show-target-page-missing\" as const, pageId: request.pageId });\n    }\n    if (request.kind === \"page\") {\n        if (page.params !== undefined) {\n            return Object.freeze({ code: \"report-show-target-parameter-required\" as const, pageId: page.id });\n        }\n        return plainSelection(page);\n    }\n    if (page.params === undefined) {\n        return Object.freeze({ code: \"report-show-target-parameter-unexpected\" as const, pageId: page.id });\n    }\n    if (!isNonEmptyString(request.key) || !isNonEmptyString(request.route)) {\n        return Object.freeze({ code: \"report-show-target-route-invalid\" as const, pageId: page.id });\n    }\n    return Object.freeze({\n        kind: \"parameterized\" as const,\n        page,\n        key: request.key,\n        route: request.route,\n    });\n}\nfunction executePlainTarget<Error, Requirements>(input: ExecuteShowTargetInput<Error, Requirements>, selected: SelectedPlainTarget): Effect.Effect<ResolvedPage, Error | ShowTargetError | ResolvedPageClosureError, Requirements | Scope.Scope> {\n    return Effect.gen(function* () {\n        const loadContext = createPageLoadContext(selected.context, input.evidence);\n        const pageInput = selected.page.load === undefined\n            ? input.sample\n            : yield* invokeAuthorCallback(selected.page.id, \"load\", input.runAuthor, () => selected.page.load!(input.sample, undefined, loadContext));\n        return yield* resolvePage<unknown, Error | ShowTargetError, Requirements>({\n            sample: input.sample,\n            target: selected.target,\n            render: invokeAuthorCallback(selected.page.id, \"render\", input.runAuthor, () => selected.page.render(pageInput, selected.context)),\n            close: (rendered, context) => invokeCloseCallback(input, selected.page.id, rendered, { ...context, page: selected.context }),\n        });\n    });\n}\nfunction executeParameterizedTarget<Error, Requirements>(input: ExecuteShowTargetInput<Error, Requirements>, selected: SelectedParameterizedTarget): Effect.Effect<ResolvedPage, Error | ShowTargetError | ResolvedPageClosureError, Requirements | Scope.Scope> {\n    return Effect.gen(function* () {\n        const decoded = yield* decodeCanonicalParameters(selected.page, selected.key, input.runAuthor);\n        const context = pageContext(selected.page, decoded);\n        const target: ResolvedPageTarget = Object.freeze({\n            pageId: selected.page.id,\n            route: selected.route,\n            params: decoded,\n        });\n        const loadContext = createPageLoadContext(context, input.evidence);\n        // Do not enumerate or impose a Host-wide parameter-member rule here.\n        // PageLoadContext.evidence and any public DomainView API are bound to this\n        // Sample and validate the concrete locator/identity a Page actually reads.\n        const pageInput = yield* invokeAuthorCallback(selected.page.id, \"load\", input.runAuthor, () => selected.page.load(input.sample, decoded, loadContext));\n        return yield* resolvePage<unknown, Error | ShowTargetError, Requirements>({\n            sample: input.sample,\n            target,\n            render: invokeAuthorCallback(selected.page.id, \"render\", input.runAuthor, () => selected.page.render(pageInput, context)),\n            close: (rendered, closeContext) => invokeCloseCallback(input, selected.page.id, rendered, { ...closeContext, page: context }),\n        });\n    });\n}\n/** Parameterized show always accepts only a canonical key. */\nfunction decodeCanonicalParameters(page: ShowTargetParameterizedPage, key: string, runAuthor: ShowTargetRunAuthor | undefined): Effect.Effect<JsonValue, ShowTargetError> {\n    return Effect.gen(function* () {\n        const decoded = yield* invokeAuthorCallback(page.id, \"params-decode\", runAuthor, () => page.params.decode(key));\n        const params = closePageParams(decoded);\n        if (params === undefined) {\n            return yield* Effect.fail<ShowTargetError>(Object.freeze({\n                code: \"report-show-target-parameter-invalid\" as const,\n                pageId: page.id,\n                key,\n                reason: \"decode-not-json\" as const,\n            }));\n        }\n        const encoded = yield* invokeAuthorCallback(page.id, \"params-encode\", runAuthor, () => page.params.encode(params));\n        if (encoded !== key) {\n            return yield* Effect.fail<ShowTargetError>(Object.freeze({\n                code: \"report-show-target-parameter-invalid\" as const,\n                pageId: page.id,\n                key,\n                reason: \"not-canonical\" as const,\n            }));\n        }\n        return params;\n    }).pipe(Effect.catchAll((error): Effect.Effect<JsonValue, ShowTargetError> => {\n        if (error.code !== \"report-show-target-callback-failed\")\n            return Effect.fail(error);\n        return Effect.fail(Object.freeze({\n            code: \"report-show-target-parameter-invalid\" as const,\n            pageId: page.id,\n            key,\n            reason: error.phase === \"params-decode\" ? \"decode-failed\" as const : \"encode-failed\" as const,\n        }));\n    }));\n}\nfunction plainSelection(page: ShowTargetPlainPage): SelectedPlainTarget {\n    return Object.freeze({\n        kind: \"plain\" as const,\n        page,\n        context: pageContext(page),\n        target: Object.freeze({ pageId: page.id, route: page.path }),\n    });\n}\nfunction pageContext(page: ShowTargetPage, params?: JsonValue): ShowTargetPageContext {\n    return Object.freeze({\n        id: page.id,\n        path: page.path,\n        title: page.title,\n        ...(params === undefined ? {} : { params }),\n    });\n}\nfunction createPageLoadContext(page: ShowTargetPageContext, evidence: PageLoadContext[\"evidence\"]): PageLoadContext {\n    return Object.freeze({ page, evidence });\n}\nfunction invokeCloseCallback<Error, Requirements>(input: Pick<ExecuteShowTargetInput<Error, Requirements>, \"close\" | \"runAuthor\">, pageId: string, rendered: unknown, context: ShowTargetCloseContext): Effect.Effect<ResolvedPageOutput, Error | ShowTargetError, Requirements> {\n    return Effect.suspend<ResolvedPageOutput, Error | ShowTargetError, Requirements>(() => {\n        try {\n            return runAuthorCallback(input.runAuthor, () => input.close(rendered, context));\n        }\n        catch {\n            return Effect.fail(callbackFailed(pageId, \"close\"));\n        }\n    });\n}\nfunction invokeAuthorCallback<Value>(pageId: string, phase: Extract<ShowTargetError, {\n    readonly code: \"report-show-target-callback-failed\";\n}>[\"phase\"], runAuthor: ShowTargetRunAuthor | undefined, callback: () => Value | PromiseLike<Value>): Effect.Effect<Value, ShowTargetError> {\n    return Effect.tryPromise({\n        try: () => new Promise<Value>((resolve) => resolve(runAuthorCallback(runAuthor, callback))),\n        catch: (): ShowTargetError => callbackFailed(pageId, phase),\n    });\n}\nfunction runAuthorCallback<Value>(runAuthor: ShowTargetRunAuthor | undefined, callback: () => Value): Value {\n    return runAuthor === undefined ? callback() : runAuthor(callback);\n}\nfunction callbackFailed(pageId: string, phase: Extract<ShowTargetError, {\n    readonly code: \"report-show-target-callback-failed\";\n}>[\"phase\"]): ShowTargetError {\n    return Object.freeze({\n        code: \"report-show-target-callback-failed\" as const,\n        pageId,\n        phase,\n    });\n}\nfunction isShowTargetError(value: SelectedShowTarget | ShowTargetError): value is ShowTargetError {\n    return \"code\" in value;\n}\nfunction isNonEmptyString(value: unknown): value is string {\n    return typeof value === \"string\" && value.length > 0;\n}\n/** Closes decoded JSON before encode/load/render can observe or mutate it. */\nfunction closePageParams(value: unknown, active = new Set<object>()): JsonValue | undefined {\n    if (value === null || typeof value === \"boolean\" || typeof value === \"string\")\n        return value;\n    if (typeof value === \"number\")\n        return Number.isFinite(value) ? value : undefined;\n    if (typeof value !== \"object\" || value === null)\n        return undefined;\n    if (active.has(value))\n        return undefined;\n    active.add(value);\n    try {\n        if (Array.isArray(value)) {\n            const entries: JsonValue[] = [];\n            for (const entry of value) {\n                const closed = closePageParams(entry, active);\n                if (closed === undefined)\n                    return undefined;\n                entries.push(closed);\n            }\n            return Object.freeze(entries);\n        }\n        const prototype = Object.getPrototypeOf(value);\n        if (prototype !== Object.prototype && prototype !== null)\n            return undefined;\n        const result: Record<string, JsonValue> = Object.create(null) as Record<string, JsonValue>;\n        for (const key of Reflect.ownKeys(value)) {\n            if (typeof key !== \"string\")\n                return undefined;\n            const descriptor = Object.getOwnPropertyDescriptor(value, key);\n            if (descriptor === undefined || !descriptor.enumerable || !(\"value\" in descriptor))\n                return undefined;\n            const closed = closePageParams(descriptor.value, active);\n            if (closed === undefined)\n                return undefined;\n            result[key] = closed;\n        }\n        return Object.freeze(Object.fromEntries(Object.entries(result).sort(([left], [right]) => compareUtf8(left, right))));\n    }\n    finally {\n        active.delete(value);\n    }\n}\n"]}

package/dist/report/host/show-target.d.cts

@@ -0,0 +1,107 @@
+import { Effect } from "effect";
+import type * as Scope from "effect/Scope";
+import type { Sample } from "../../analysis/contracts.cjs";
+import type { PageContext, PageLoadContext, ReportDefinition } from "../definition/report.cjs";
+import { type LiveResolvedPageContext, type ResolvedPage, type ResolvedPageClosureError, type ResolvedPageOutput, type ResolvedPageTarget } from "../runtime/resolved-page.cjs";
+/** Metadata supplied to one selected Page callback while the Sample is open. */
+export type ShowTargetPageContext = PageContext;
+/**
+ * The executor consumes normalized author definitions directly. `enumerate`
+ * exists on the parameterized declaration but has no call site in this file.
+ */
+export type ShowTargetPage = ReportDefinition["pages"][number];
+export type ShowTargetPlainPage = Extract<ShowTargetPage, {
+    readonly params?: never;
+}>;
+export type ShowTargetParameterizedPage = Exclude<ShowTargetPage, ShowTargetPlainPage>;
+export interface ShowTargetDefinition {
+    readonly pages: readonly ShowTargetPage[];
+}
+export type ShowTargetRequest = {
+    readonly kind: "default";
+} | {
+    readonly kind: "page";
+    readonly pageId: string;
+} | {
+    readonly kind: "parameterized-page";
+    readonly pageId: string;
+    /** The exact incoming key that must survive decode → encode unchanged. */
+    readonly key: string;
+    /** The Host-provided concrete route for this one Page instance. */
+    readonly route: string;
+};
+export interface ShowTargetCloseContext extends LiveResolvedPageContext {
+    readonly page: ShowTargetPageContext;
+}
+/**
+ * Optional synchronous capture boundary for the exact start of an author
+ * callback. Promise assimilation and Effect execution happen after it returns.
+ */
+export type ShowTargetRunAuthor = <Value>(callback: () => Value) => Value;
+export interface ExecuteShowTargetInput<Error, Requirements> {
+    readonly definition: ShowTargetDefinition;
+    readonly sample: Sample;
+    readonly request: ShowTargetRequest;
+    /**
+     * This is the PageLoadContext evidence surface for the fixed Sample. A
+     * parameterized Page validates any locator/member it dereferences through
+     * this public API; the Host does not invent a generic member predicate or
+     * enumerate the Page to prove one exists.
+     */
+    readonly evidence: PageLoadContext["evidence"];
+    /**
+     * Host-owned synchronous callback-start capture (for example,
+     * captureAnalysisIssues(...).run). When absent, callbacks run directly.
+     */
+    readonly runAuthor?: ShowTargetRunAuthor;
+    /**
+     * The private Page resolver. It resolves components and creates both text and
+     * web projections while the Sample Scope is live, then returns data only.
+     */
+    readonly close: (rendered: unknown, context: ShowTargetCloseContext) => Effect.Effect<ResolvedPageOutput, Error, Requirements>;
+}
+export type ShowTargetError = {
+    readonly code: "report-show-target-default-missing";
+} | {
+    readonly code: "report-show-target-page-missing";
+    readonly pageId: string;
+} | {
+    readonly code: "report-show-target-parameter-required";
+    readonly pageId: string;
+} | {
+    readonly code: "report-show-target-parameter-unexpected";
+    readonly pageId: string;
+} | {
+    readonly code: "report-show-target-route-invalid";
+    readonly pageId: string;
+} | {
+    readonly code: "report-show-target-parameter-invalid";
+    readonly pageId: string;
+    readonly key: string;
+    readonly reason: "decode-failed" | "decode-not-json" | "encode-failed" | "not-canonical";
+} | {
+    readonly code: "report-show-target-callback-failed";
+    readonly pageId: string;
+    readonly phase: "params-decode" | "params-encode" | "load" | "render" | "close";
+};
+interface SelectedPlainTarget {
+    readonly kind: "plain";
+    readonly page: ShowTargetPlainPage;
+    readonly context: ShowTargetPageContext;
+    readonly target: ResolvedPageTarget;
+}
+interface SelectedParameterizedTarget {
+    readonly kind: "parameterized";
+    readonly page: ShowTargetParameterizedPage;
+    readonly key: string;
+    readonly route: string;
+}
+type SelectedShowTarget = SelectedPlainTarget | SelectedParameterizedTarget;
+/**
+ * Executes exactly one target Page. In particular, this function never calls
+ * `params.enumerate()` because that would make `show` a hidden site build.
+ */
+export declare function executeShowTarget<Error, Requirements>(input: ExecuteShowTargetInput<Error, Requirements>): Effect.Effect<ResolvedPage, Error | ShowTargetError | ResolvedPageClosureError, Requirements | Scope.Scope>;
+/** Pure selection only; no page callback, loader, encoder, decoder, or enumeration runs here. */
+export declare function selectShowTarget(definition: ShowTargetDefinition, request: ShowTargetRequest): SelectedShowTarget | ShowTargetError;
+export {};