@playfast/reform-profiler 1.0.2 → 1.2.0

package/dist/registry.js

@@ -0,0 +1,57 @@
+import { GlobalValue, Option } from 'effect';
+const state = GlobalValue.globalValue(Symbol.for('reform-profiler/registry'), () => ({
+    entries: new Map(),
+    listeners: new Set(),
+    version: { current: 0 },
+    overlay: { owner: Option.none() },
+}));
+const notify = () => {
+    state.version.current += 1;
+    [...state.listeners].forEach((listener) => listener());
+};
+export const registerProfiler = (registration) => {
+    const existing = state.entries.get(registration.handle);
+    state.entries.set(registration.handle, {
+        registration,
+        count: existing === undefined ? 1 : existing.count + 1,
+    });
+    if (existing === undefined) {
+        notify();
+    }
+    return () => {
+        const current = state.entries.get(registration.handle);
+        if (current === undefined) {
+            return;
+        }
+        if (current.count <= 1) {
+            state.entries.delete(registration.handle);
+            notify();
+        }
+        else {
+            state.entries.set(registration.handle, { ...current, count: current.count - 1 });
+        }
+    };
+};
+export const listProfilers = () => [...state.entries.values()].map((entry) => entry.registration);
+export const subscribeProfilers = (listener) => {
+    state.listeners.add(listener);
+    return () => {
+        state.listeners.delete(listener);
+    };
+};
+export const profilersVersion = () => state.version.current;
+// First mounted overlay claims render; later instances no-op until claim released.
+export const claimOverlay = (owner) => {
+    if (Option.isNone(state.overlay.owner)) {
+        state.overlay.owner = Option.some(owner);
+        return true;
+    }
+    return Option.contains(state.overlay.owner, owner);
+};
+export const releaseOverlay = (owner) => {
+    if (Option.contains(state.overlay.owner, owner)) {
+        state.overlay.owner = Option.none();
+        notify();
+    }
+};
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/report.d.ts

@@ -0,0 +1,3 @@
+import type { ProfilerHandle } from './recorder.js';
+export declare const formatReport: (profiler: ProfilerHandle) => string;
+//# sourceMappingURL=report.d.ts.map

package/dist/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,YAAY,CAAA;AAiD7D,eAAO,MAAM,YAAY,GAAI,UAAU,cAAc,KAAG,MAqBvD,CAAA"}

package/dist/report.js

@@ -0,0 +1,48 @@
+const sortedRows = (stats) => [...stats.entries()]
+    .map(([name, stat]) => ({ name, stat }))
+    .toSorted((left, right) => right.stat.totalMs - left.stat.totalMs || right.stat.count - left.stat.count);
+const MS_DECIMALS = 2;
+const formatMs = (durationMs) => durationMs.toFixed(MS_DECIMALS);
+const COUNT_WIDTH = 7;
+const TOTAL_WIDTH = 9;
+const AVG_WIDTH = 8;
+const ruleOverhead = '── '.length + ' '.length;
+const section = ({ title, rows, timed }) => {
+    if (rows.length === 0) {
+        return [];
+    }
+    const nameWidth = Math.max('name'.length, ...rows.map((row) => row.name.length));
+    const header = timed
+        ? `${'name'.padEnd(nameWidth)}  ${'count'.padStart(COUNT_WIDTH)}  ${'total ms'.padStart(TOTAL_WIDTH)}  ${'avg ms'.padStart(AVG_WIDTH)}`
+        : `${'name'.padEnd(nameWidth)}  ${'count'.padStart(COUNT_WIDTH)}`;
+    const lines = rows.map((row) => timed
+        ? `${row.name.padEnd(nameWidth)}  ${String(row.stat.count).padStart(COUNT_WIDTH)}  ${formatMs(row.stat.totalMs).padStart(TOTAL_WIDTH)}  ${formatMs(row.stat.count === 0 ? 0 : row.stat.totalMs / row.stat.count).padStart(AVG_WIDTH)}`
+        : `${row.name.padEnd(nameWidth)}  ${String(row.stat.count).padStart(COUNT_WIDTH)}`);
+    return [
+        `── ${title} ${'─'.repeat(Math.max(0, header.length - title.length - ruleOverhead))}`,
+        header,
+        ...lines,
+        '',
+    ];
+};
+export const formatReport = (profiler) => {
+    const snapshot = profiler.snapshot();
+    const frameRows = snapshot.frames.count === 0 ? [] : [{ name: 'frame', stat: snapshot.frames }];
+    const dropped = snapshot.dropped === 0
+        ? []
+        : [`(${snapshot.dropped} early records evicted from the ring buffer)`, ''];
+    return [
+        `reform profile — ${profiler.label}`,
+        '',
+        ...section({ title: 'Events', rows: sortedRows(snapshot.events), timed: false }),
+        ...section({ title: 'Reducers', rows: sortedRows(snapshot.reducers), timed: true }),
+        ...section({ title: 'State updates', rows: sortedRows(snapshot.states), timed: false }),
+        ...section({ title: 'Calcs', rows: sortedRows(snapshot.calcs), timed: true }),
+        ...section({ title: 'Queries', rows: sortedRows(snapshot.queries), timed: true }),
+        ...section({ title: 'Procedures', rows: sortedRows(snapshot.procedures), timed: true }),
+        ...section({ title: 'Renders', rows: sortedRows(snapshot.renders), timed: true }),
+        ...section({ title: 'Frames', rows: frameRows, timed: true }),
+        ...dropped,
+    ].join('\n');
+};
+//# sourceMappingURL=report.js.map

package/dist/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,GAAG,CAAC,KAAuC,EAAsB,EAAE,CACjF,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;KACjB,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAO,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;KAC5C,QAAQ,CACP,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAC9F,CAAA;AAEL,MAAM,WAAW,GAAG,CAAC,CAAA;AACrB,MAAM,QAAQ,GAAG,CAAC,UAAkB,EAAU,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;AAEhF,MAAM,WAAW,GAAG,CAAC,CAAA;AACrB,MAAM,WAAW,GAAG,CAAC,CAAA;AACrB,MAAM,SAAS,GAAG,CAAC,CAAA;AACnB,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAA;AAQ9C,MAAM,OAAO,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAW,EAAyB,EAAE;IACzE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,CAAA;IACX,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;IAChF,MAAM,MAAM,GAAG,KAAK;QAClB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE;QACvI,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAA;IACnE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAC7B,KAAK;QACH,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE;QACtO,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CACrF,CAAA;IACD,OAAO;QACL,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC,EAAE;QACrF,MAAM;QACN,GAAG,KAAK;QACR,EAAE;KACH,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAwB,EAAU,EAAE;IAC/D,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAA;IACpC,MAAM,SAAS,GACb,QAAQ,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IAC/E,MAAM,OAAO,GACX,QAAQ,CAAC,OAAO,KAAK,CAAC;QACpB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,OAAO,8CAA8C,EAAE,EAAE,CAAC,CAAA;IAC9E,OAAO;QACL,oBAAoB,QAAQ,CAAC,KAAK,EAAE;QACpC,EAAE;QACF,GAAG,OAAO,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAChF,GAAG,OAAO,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACnF,GAAG,OAAO,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACvF,GAAG,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC7E,GAAG,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACjF,GAAG,OAAO,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACvF,GAAG,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACjF,GAAG,OAAO,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC7D,GAAG,OAAO;KACX,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC,CAAA"}

package/dist/trace.d.ts

@@ -0,0 +1,36 @@
+import type { ProfilerHandle } from './recorder.js';
+export type ChromeTraceEvent = {
+    readonly ph: 'X';
+    readonly name: string;
+    readonly cat: string;
+    readonly ts: number;
+    readonly dur: number;
+    readonly pid: number;
+    readonly tid: number;
+    readonly args: Readonly<Record<string, string>>;
+} | {
+    readonly ph: 'i';
+    readonly name: string;
+    readonly cat: string;
+    readonly ts: number;
+    readonly pid: number;
+    readonly tid: number;
+    readonly s: 't';
+    readonly args: Readonly<Record<string, string>>;
+} | {
+    readonly ph: 'M';
+    readonly name: 'process_name' | 'thread_name';
+    readonly ts: 0;
+    readonly pid: number;
+    readonly tid: number;
+    readonly args: {
+        readonly name: string;
+    };
+};
+export interface ChromeTrace {
+    readonly traceEvents: ReadonlyArray<ChromeTraceEvent>;
+    readonly displayTimeUnit: 'ms';
+}
+export declare const toChromeTrace: (profiler: ProfilerHandle) => ChromeTrace;
+export declare const traceJson: (profiler: ProfilerHandle) => string;
+//# sourceMappingURL=trace.d.ts.map

package/dist/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,YAAY,CAAA;AAE7D,MAAM,MAAM,gBAAgB,GACxB;IACE,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAA;IAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAChD,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAA;IAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAA;IACf,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAChD,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAA;IAChB,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,aAAa,CAAA;IAC7C,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAA;IACd,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CACzC,CAAA;AAEL,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAA;IACrD,QAAQ,CAAC,eAAe,EAAE,IAAI,CAAA;CAC/B;AAkBD,eAAO,MAAM,aAAa,GAAI,UAAU,cAAc,KAAG,WA0CxD,CAAA;AAED,eAAO,MAAM,SAAS,GAAI,UAAU,cAAc,KAAG,MAEZ,CAAA"}

package/dist/trace.js

@@ -0,0 +1,58 @@
+const lanes = {
+    frame: { tid: 1, title: 'frames' },
+    event: { tid: 2, title: 'events' },
+    reducer: { tid: 3, title: 'reducers' },
+    state: { tid: 4, title: 'state updates' },
+    calc: { tid: 5, title: 'calcs' },
+    query: { tid: 6, title: 'queries' },
+    procedure: { tid: 7, title: 'procedures' },
+    render: { tid: 8, title: 'renders' },
+};
+const instantKinds = new Set(['event', 'state']);
+const pid = 1;
+const US_PER_MS = 1000;
+export const toChromeTrace = (profiler) => {
+    const { records } = profiler.snapshot();
+    const meta = [
+        {
+            ph: 'M',
+            name: 'process_name',
+            ts: 0,
+            pid,
+            tid: 0,
+            args: { name: `reform: ${profiler.label}` },
+        },
+        ...Object.values(lanes).map((lane) => ({
+            ph: 'M',
+            name: 'thread_name',
+            ts: 0,
+            pid,
+            tid: lane.tid,
+            args: { name: lane.title },
+        })),
+    ];
+    const body = records.map((record) => {
+        const startUs = record.start * US_PER_MS;
+        const cat = record.kind;
+        const tid = lanes[record.kind].tid;
+        const args = record.detail === '' ? {} : { detail: record.detail };
+        const complete = {
+            ph: 'X',
+            name: record.name,
+            cat,
+            ts: startUs,
+            dur: record.dur * US_PER_MS,
+            pid,
+            tid,
+            args,
+        };
+        return instantKinds.has(record.kind)
+            ? { ph: 'i', name: record.name, cat, ts: startUs, pid, tid, s: 't', args }
+            : complete;
+    });
+    return { traceEvents: [...meta, ...body], displayTimeUnit: 'ms' };
+};
+export const traceJson = (profiler) => 
+// oxlint-disable-next-line reform-rules/no-json-parse-stringify -- Trace Event Format is a foreign wire format consumed by Chrome DevTools/Perfetto, not Schema-typed data
+JSON.stringify(toChromeTrace(profiler));
+//# sourceMappingURL=trace.js.map

package/dist/trace.js.map

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

package/package.json

@@ -1,55 +1,75 @@
 {
   "name": "@playfast/reform-profiler",
-  "playbook": "./playbook",
-  "version": "1.0.2",
-  "type": "module",
+  "version": "1.2.0",
   "description": "Performance profiler for reform scenes — a recording Instrumentation, Chrome DevTools trace export, terminal reports, and a React overlay. Dev builds get the real recorder; prod builds resolve to no-op stubs.",
   "keywords": [
-    "reform",
+    "devtools",
     "effect",
-    "profiler",
     "performance",
-    "devtools"
+    "profiler",
+    "reform"
   ],
+  "bugs": {
+    "url": "https://github.com/playfast/reform/issues"
+  },
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "https://github.com/playfast/reform.git",
     "directory": "packages/reform-profiler"
   },
-  "bugs": {
-    "url": "https://github.com/playfast/reform/issues"
-  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "type": "module",
   "sideEffects": false,
+  "main": "./dist/noop.js",
+  "types": "./dist/noop.d.ts",
   "exports": {
     "./package.json": "./package.json",
     ".": {
-      "development": "./src/index.ts",
-      "default": "./src/noop.ts"
+      "playfast-src": {
+        "development": "./src/index.ts",
+        "default": "./src/noop.ts"
+      },
+      "development": "./dist/index.js",
+      "types": "./dist/noop.d.ts",
+      "default": "./dist/noop.js"
     },
     "./react": {
-      "development": "./src/react/index.ts",
-      "default": "./src/react/noop.ts"
+      "playfast-src": {
+        "development": "./src/react/index.ts",
+        "default": "./src/react/noop.ts"
+      },
+      "development": "./dist/react/index.js",
+      "types": "./dist/react/noop.d.ts",
+      "default": "./dist/react/noop.js"
     },
-    "./recorder": "./src/index.ts"
+    "./recorder": {
+      "playfast-src": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
   },
-  "files": [
-    "src",
-    "README.md"
-  ],
   "scripts": {
     "clean": "rm -rf dist .tsbuildinfo",
     "check": "tsc --noEmit",
-    "build": "tsc -p tsconfig.build.json",
+    "build": "rm -rf dist .tsbuildinfo && tsc -p tsconfig.build.json && bun ../../scripts/fix-esm-extensions.ts dist",
     "test": "vitest run",
     "test:watch": "vitest",
     "coverage": "vitest run --coverage",
     "lint": "oxlint src",
-    "lint:fix": "oxlint --fix src"
+    "lint:fix": "oxlint --fix src",
+    "prepack": "bun run build"
   },
   "peerDependencies": {
-    "effect": "*",
     "@playfast/reform": "*",
+    "effect": "*",
     "react": "^19.0.0"
   },
   "peerDependenciesMeta": {
@@ -57,7 +77,5 @@
       "optional": true
     }
   },
-  "publishConfig": {
-    "access": "public"
-  }
+  "playbook": "./playbook"
 }

package/src/index.ts

@@ -7,7 +7,7 @@ export {
   type ProfileSnapshot,
   type ProfileStat,
 } from './recorder'
-export { type ProfiledScene, profileScene } from './profileScene'
+export { type CapturedProfiledScene, type ProfiledScene, profileScene } from './profileScene'
 export { type ChromeTrace, type ChromeTraceEvent, toChromeTrace, traceJson } from './trace'
 export { formatReport } from './report'
 export {

package/src/noop.ts

@@ -1,10 +1,7 @@
-import { noopInstrumentation, type Scene, type UiContract } from '@playfast/reform'
-import type { ProfiledScene } from './profileScene'
-import type {
-  ProfilerHandle,
-  ProfilerOptionsExternalApi,
-  ProfileSnapshot,
-} from './recorder'
+import { type CapturedScene, type Scene, type UiContract } from '@playfast/reform'
+import { noopInstrumentation } from '@playfast/reform/internal'
+import type { CapturedProfiledScene, ProfiledScene } from './profileScene'
+import type { ProfilerHandle, ProfilerOptionsExternalApi, ProfileSnapshot } from './recorder'
 import type { ProfilerRegistration } from './registry'
 import type { ChromeTrace } from './trace'
 
@@ -18,7 +15,7 @@ export type {
   ProfileSnapshot,
   ProfileStat,
 } from './recorder'
-export type { ProfiledScene } from './profileScene'
+export type { CapturedProfiledScene, ProfiledScene } from './profileScene'
 export type { ChromeTrace, ChromeTraceEvent } from './trace'
 export type { ProfilerRegistration } from './registry'
 
@@ -47,10 +44,45 @@ export const noopProfiler: ProfilerHandle = {
 export const makeProfiler = (_options: ProfilerOptionsExternalApi = {}): ProfilerHandle =>
   noopProfiler
 
-export const profileScene = <C extends UiContract, S extends ReadonlyArray<unknown>>(
+const profileCapturedScene = <
+  C extends UiContract,
+  S extends ReadonlyArray<unknown>,
+  Services,
+  P,
+  N extends string,
+  Identity,
+>(
+  base: CapturedScene<C, S, Services, P, N, Identity>,
+): CapturedProfiledScene<C, S, Services, P, N, Identity> => ({
+  scene: base,
+  profiler: noopProfiler,
+})
+
+export function profileScene<
+  C extends UiContract,
+  S extends ReadonlyArray<unknown>,
+  Services,
+  P,
+  N extends string,
+  Identity,
+>(
+  base: CapturedScene<C, S, Services, P, N, Identity>,
+  _options?: ProfilerOptionsExternalApi,
+): CapturedProfiledScene<C, S, Services, P, N, Identity>
+export function profileScene<C extends UiContract, S extends ReadonlyArray<unknown>>(
+  base: Scene<C, S>,
+  _options?: ProfilerOptionsExternalApi,
+): ProfiledScene<C, S>
+export function profileScene<C extends UiContract, S extends ReadonlyArray<unknown>>(
   base: Scene<C, S>,
   _options: ProfilerOptionsExternalApi = {},
-): ProfiledScene<C, S> => ({ scene: base, profiler: noopProfiler })
+): ProfiledScene<C, S> {
+  return base.capture<ProfiledScene<C, S>>(
+    <Services, P, N extends string, Identity>(
+      exactScene: CapturedScene<C, S, Services, P, N, Identity>,
+    ): ProfiledScene<C, S> => profileCapturedScene(exactScene),
+  )
+}
 
 const emptyTrace: ChromeTrace = { traceEvents: [], displayTimeUnit: 'ms' }
 
@@ -61,11 +93,15 @@ export const traceJson = (_profiler: ProfilerHandle): string =>
 
 export const formatReport = (_profiler: ProfilerHandle): string => ''
 
-export const registerProfiler = (_registration: ProfilerRegistration): (() => void) => () => {}
+export const registerProfiler =
+  (_registration: ProfilerRegistration): (() => void) =>
+  () => {}
 
 export const listProfilers = (): ReadonlyArray<ProfilerRegistration> => []
 
-export const subscribeProfilers = (_listener: () => void): (() => void) => () => {}
+export const subscribeProfilers =
+  (_listener: () => void): (() => void) =>
+  () => {}
 
 export const profilersVersion = (): number => 0
 

package/src/profileScene.ts

@@ -1,5 +1,6 @@
 import { Effect, Layer } from 'effect'
-import { profiledScene, type Scene, type UiContract } from '@playfast/reform'
+import { type CapturedScene, profiledScene, type Scene, type UiContract } from '@playfast/reform'
+import { type AnySceneCapture, type SceneCapture } from '@playfast/reform/internal'
 import { makeProfiler, type ProfilerHandle, type ProfilerOptionsExternalApi } from './recorder'
 import { registerProfiler } from './registry'
 
@@ -11,29 +12,94 @@ export interface ProfiledScene<
   readonly profiler: ProfilerHandle
 }
 
-export const profileScene = <C extends UiContract, S extends ReadonlyArray<unknown>>(
+export interface CapturedProfiledScene<
+  C extends UiContract,
+  S extends ReadonlyArray<unknown>,
+  Services,
+  P,
+  N extends string,
+  Identity,
+> extends ProfiledScene<C, S> {
+  readonly scene: CapturedScene<C, S, Services, P, N, Identity>
+}
+
+const makeLifecycle = (profiler: ProfilerHandle) =>
+  Layer.scopedDiscard(
+    Effect.acquireRelease(
+      Effect.sync(() => registerProfiler({ label: profiler.label, handle: profiler })),
+      (unregister) => Effect.sync(unregister),
+    ),
+  )
+
+const withLifecycle = <
+  C extends UiContract,
+  S extends ReadonlyArray<unknown>,
+  Services,
+  P,
+  N extends string,
+  Identity,
+>(
+  base: CapturedScene<C, S, Services, P, N, Identity>,
+  lifecycle: ReturnType<typeof makeLifecycle>,
+): CapturedScene<C, S, Services, P, N, Identity> => {
+  const captured: CapturedScene<C, S, Services, P, N, Identity> = {
+    kind: 'Scene',
+    composition: base.composition,
+    // Lifecycle on the first provide layer tracks the runtime's build/dispose scope.
+    provide: base.provide.map((layer, index) =>
+      index === 0 ? Layer.merge(layer, lifecycle) : layer,
+    ),
+    ...(base.boot === undefined ? {} : { boot: base.boot }),
+    ...(base.instrumentation === undefined ? {} : { instrumentation: base.instrumentation }),
+    capture: <Result>(capture: SceneCapture<C, S, Result>): Result => capture(captured),
+    captureAny: <Result>(capture: AnySceneCapture<Result>): Result => capture(captured),
+  }
+  return captured
+}
+
+const profileCapturedScene = <
+  C extends UiContract,
+  S extends ReadonlyArray<unknown>,
+  Services,
+  P,
+  N extends string,
+  Identity,
+>(
+  base: CapturedScene<C, S, Services, P, N, Identity>,
+  profiler: ProfilerHandle,
+  lifecycle: ReturnType<typeof makeLifecycle>,
+): CapturedProfiledScene<C, S, Services, P, N, Identity> => ({
+  scene: withLifecycle(profiledScene(base, profiler), lifecycle),
+  profiler,
+})
+
+export function profileScene<
+  C extends UiContract,
+  S extends ReadonlyArray<unknown>,
+  Services,
+  P,
+  N extends string,
+  Identity,
+>(
+  base: CapturedScene<C, S, Services, P, N, Identity>,
+  options?: ProfilerOptionsExternalApi,
+): CapturedProfiledScene<C, S, Services, P, N, Identity>
+export function profileScene<C extends UiContract, S extends ReadonlyArray<unknown>>(
+  base: Scene<C, S>,
+  options?: ProfilerOptionsExternalApi,
+): ProfiledScene<C, S>
+export function profileScene<C extends UiContract, S extends ReadonlyArray<unknown>>(
   base: Scene<C, S>,
   options: ProfilerOptionsExternalApi = {},
-): ProfiledScene<C, S> => {
+): ProfiledScene<C, S> {
   const profiler = makeProfiler({
     label: options.label ?? base.composition.manifest.title,
     ...(options.capacity !== undefined ? { capacity: options.capacity } : {}),
   })
-  const lifecycle = Layer.scopedDiscard(
-    Effect.acquireRelease(
-      Effect.sync(() => registerProfiler({ label: profiler.label, handle: profiler })),
-      (unregister) => Effect.sync(unregister),
-    ),
+  const lifecycle = makeLifecycle(profiler)
+  return base.capture<ProfiledScene<C, S>>(
+    <Services, P, N extends string, Identity>(
+      exactScene: CapturedScene<C, S, Services, P, N, Identity>,
+    ): ProfiledScene<C, S> => profileCapturedScene(exactScene, profiler, lifecycle),
   )
-  const wrapped = profiledScene(base, profiler)
-  return {
-    // Lifecycle on first provide layer so register/unregister track runtime build/dispose.
-    scene: {
-      ...wrapped,
-      provide: wrapped.provide.map((layer, index) =>
-        index === 0 ? Layer.merge(layer, lifecycle) : layer,
-      ),
-    },
-    profiler,
-  }
 }