@forgeax/engine-profiler 0.1.3 → 0.1.6

package/dist/recorder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../src/recorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAiB,KAAK,cAAc,EAAc,MAAM,aAAa,CAAC;AAC7E,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAEjB,gBAAgB,EAChB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;CACjC;AAED,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE1D,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;AAEtF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAClD,UAAU,CAAC,KAAK,EAAE,iBAAiB,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAC3D,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACvE,QAAQ,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IACjC,UAAU,CAAC,KAAK,EAAE,gBAAgB,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAC1D,QAAQ,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,IAAI,cAAc,CAAC,cAAc,CAAC,CAAC;CAC1C;AAgDD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAAC,IAAI,CAAC,CAKnF;AAgLD,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,YAAY,EACnB,YAAY,EAAE,oBAAoB,EAClC,gBAAgB,CAAC,EAAE;IAAE,8BAA8B,EAAE,MAAM,CAAA;CAAE,GAC5D,cAAc,CAAC,eAAe,CAAC,CAuJjC"}
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../src/recorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAiB,KAAK,cAAc,EAAc,MAAM,aAAa,CAAC;AAC7E,OAAO,KAAK,EACV,cAAc,EACd,iBAAiB,EAEjB,gBAAgB,EAChB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;CACjC;AAED,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE1D,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;AAEtF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAClD,UAAU,CAAC,KAAK,EAAE,iBAAiB,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAC3D,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACvE,QAAQ,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IACjC,UAAU,CAAC,KAAK,EAAE,gBAAgB,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAC1D,QAAQ,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,IAAI,cAAc,CAAC,cAAc,CAAC,CAAC;CAC1C;AAgDD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAAC,IAAI,CAAC,CAKnF;AAgLD,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,YAAY,EACnB,YAAY,EAAE,oBAAoB,EAClC,gBAAgB,CAAC,EAAE;IAAE,8BAA8B,EAAE,MAAM,CAAA;CAAE,GAC5D,cAAc,CAAC,eAAe,CAAC,CAsJjC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeax/engine-profiler",
-  "version": "0.1.3",
+  "version": "0.1.6",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",

package/scripts/generate-profile-types.mjs

@@ -4,22 +4,13 @@ const packageRoot = new URL('../', import.meta.url);
 const schemaPath = new URL('./schema/profile-capture.schema.json', packageRoot);
 const outputPath = new URL('./src/generated/profile-capture.ts', packageRoot);
 const schema = JSON.parse(readFileSync(schemaPath, 'utf8'));
-const literalUnion = (values) => values.map((value) => `'${value}'`).join(' | ');
-const resolveDefinition = (reference) => schema.$defs[reference.slice('#/$defs/'.length)];
-const profileSource = literalUnion(schema.$defs.source.enum);
-const profileRecordKind = literalUnion(
-  schema.$defs.record.oneOf.map(
-    ({ $ref }) => resolveDefinition($ref).properties.kind.const,
-  ),
-);
-const profileCompletenessStatus = literalUnion(schema.$defs.completeness.properties.status.enum);
 
 const output = `// Generated by scripts/generate-profile-types.mjs. Do not edit.
 // Schema version: ${schema.properties.schemaVersion.const}
 
-export type ProfileSource = ${profileSource};
-export type ProfileRecordKind = ${profileRecordKind};
-export type ProfileCompletenessStatus = ${profileCompletenessStatus};
+export type ProfileSource = 'app' | 'render';
+export type ProfileRecordKind = 'phase' | 'skip';
+export type ProfileCompletenessStatus = 'complete' | 'partial' | 'overflow';
 
 export interface ProfilePhaseRecord {
   readonly kind: 'phase';

package/src/__tests__/cli-input-errors.test.ts

@@ -1,4 +1,3 @@
-import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { describe, expect, it } from 'vitest';
 import { readCliInput, runProfilerCli } from '../cli.js';
@@ -56,44 +55,6 @@ describe('profiler CLI input error contract', () => {
     expect(readCliInput(['summary'], () => 'capture')).toBe('capture');
   });
 
-  it('returns a structured reader failure and retries the same reader deterministically', () => {
-    const input = readFileSync(
-      new URL('./fixtures/cli/valid-capture.json', import.meta.url),
-      'utf8',
-    );
-    let refuse = true;
-    const readStdin = (): string => {
-      if (refuse) {
-        refuse = false;
-        throw new Error('EISDIR: illegal operation on a directory, read');
-      }
-      return input;
-    };
-
-    const first = runProfilerCli(['summary'], readCliInput(['summary'], readStdin));
-    expectStructuredError(first, 'cli-input-stdin-read-failed');
-    expect(JSON.parse(first.stderr)).toEqual({
-      error: {
-        code: 'cli-input-stdin-read-failed',
-        expected: expect.any(String),
-        hint: expect.any(String),
-        detail: {
-          message: 'EISDIR: illegal operation on a directory, read',
-        },
-      },
-    });
-
-    const second = runProfilerCli(['summary'], readCliInput(['summary'], readStdin));
-    const repeat = runProfilerCli(['summary'], readCliInput(['summary'], readStdin));
-    expect(second.exitCode).toBe(0);
-    expect(second.stderr).toBe('');
-    expect(second.stdout).toBe(repeat.stdout);
-    expect(JSON.parse(second.stdout)).toMatchObject({
-      query: 'summary',
-      captureId: 'capture-0042',
-    });
-  });
-
   it('rejects empty stdin without producing a summary', () => {
     expectStructuredError(runProfilerCli(['summary'], ''), 'cli-input-empty');
   });

package/src/__tests__/cli-process.integration.test.ts

@@ -1,5 +1,5 @@
 import { spawnSync } from 'node:child_process';
-import { closeSync, openSync, readFileSync } from 'node:fs';
+import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { describe, expect, it } from 'vitest';
 
@@ -23,18 +23,6 @@ function runCli(args: readonly string[], input: string) {
   });
 }
 
-function runCliWithDirectoryStdin(args: readonly string[]) {
-  const stdin = openSync(fileURLToPath(new URL('./', import.meta.url)), 'r');
-  try {
-    return spawnSync(process.execPath, [cliPath, ...args], {
-      stdio: [stdin, 'pipe', 'pipe'],
-      encoding: 'utf8',
-    });
-  } finally {
-    closeSync(stdin);
-  }
-}
-
 function parseObject(output: string): Record<string, unknown> {
   return JSON.parse(output) as Record<string, unknown>;
 }
@@ -84,21 +72,6 @@ describe('profiler CLI public process contract', () => {
     });
   });
 
-  it('returns one structured stdin reader error through the built entry', () => {
-    const refusal = runCliWithDirectoryStdin(['summary']);
-
-    expect(refusal.status).toBe(2);
-    expect(refusal.stdout).toBe('');
-    expect(parseObject(refusal.stderr)).toEqual({
-      error: {
-        code: 'cli-input-stdin-read-failed',
-        expected: expect.any(String),
-        hint: expect.any(String),
-        detail: { message: expect.stringContaining('EISDIR') },
-      },
-    });
-  });
-
   it('compares two file artifacts deterministically through the built entry', () => {
     const args = ['compare', '--left-file', fixturePath, '--right-file', partialFixturePath];
     const first = runCli(args, 'stdin must not be read');

package/src/browser-user-timing.ts

@@ -1,5 +1,5 @@
 import type { Profiler } from './profiler.js';
-import type { ProfileDetail, RecorderSession } from './recorder.js';
+import type { RecorderSession } from './recorder.js';
 import type { ProfileCapture, ProfilePhaseStart, ProfileSource } from './types.js';
 
 /** The small browser API surface used by the opt-in User Timing adapter. */
@@ -17,15 +17,7 @@ export interface UserTimingProfilerOptions {
 
 type DiagnosticGlobal = Record<string, unknown>;
 type PhaseCatalog = ProfileCapture['phaseCatalog'];
-type BrowserProfileDetail = ProfileDetail;
-const DEFAULT_CAPTURE_ID = 'capture-0001';
-const CAPTURE_ID_PATTERN = /^capture-[0-9]{4,}$/;
-
-function resolveCaptureId(captureId: string | undefined): string {
-  return captureId === undefined || CAPTURE_ID_PATTERN.test(captureId)
-    ? (captureId ?? DEFAULT_CAPTURE_ID)
-    : DEFAULT_CAPTURE_ID;
-}
+type BrowserProfileDetail = 'owner' | 'passes' | 'nested';
 
 function partialCapture(captureId: string, phaseCatalog: PhaseCatalog): ProfileCapture {
   return {
@@ -73,7 +65,7 @@ export function createUserTimingProfiler(
   options: UserTimingProfilerOptions = {},
 ): Profiler | undefined {
   const diagnosticsKey = options.diagnosticsKey ?? '__forgeaxFramePhaseDiagnostics';
-  const captureId = resolveCaptureId(options.captureId);
+  const captureId = options.captureId ?? 'forgeax-user-timing';
   const timingEnabled = diagnosticsEnabled(diagnosticsKey);
   const detail = diagnosticsDetail(diagnosticsKey);
   const performanceApi = timingEnabled

package/src/cli.ts

@@ -31,7 +31,6 @@ type CliError = {
     | 'cli-input-empty'
     | 'cli-input-file-read-failed'
     | 'cli-input-invalid-json'
-    | 'cli-input-stdin-read-failed'
     | 'cli-query-invalid';
   readonly expected: string;
   readonly hint: string;
@@ -250,7 +249,7 @@ function parseArguments(args: readonly string[]): CliArguments | CliError {
   return validateCommand(state) ?? toCliArguments(state);
 }
 
-function readArtifact(filePath: string | undefined, stdin: string | CliError): string | CliError {
+function readArtifact(filePath: string | undefined, stdin: string): string | CliError {
   if (filePath !== undefined) {
     try {
       return readFileSync(filePath, 'utf8');
@@ -266,7 +265,6 @@ function readArtifact(filePath: string | undefined, stdin: string | CliError): s
       };
     }
   }
-  if (isCliError(stdin)) return stdin;
   if (stdin.trim().length === 0) {
     return {
       code: 'cli-input-empty',
@@ -352,10 +350,7 @@ function projectComparison(value: ProfileComparisonProjection): Record<string, u
   return { query: 'compare', ...value };
 }
 
-export function runProfilerCli(
-  args: readonly string[],
-  stdin: string | CliError,
-): ProfilerCliResult {
+export function runProfilerCli(args: readonly string[], stdin: string): ProfilerCliResult {
   const parsedArguments = parseArguments(args);
   if ('code' in parsedArguments) {
     return { stdout: '', stderr: output({ error: parsedArguments }), exitCode: 2 };
@@ -390,20 +385,10 @@ export function runProfilerCli(
   };
 }
 
-export function readCliInput(args: readonly string[], readStdin: () => string): string | CliError {
-  if (args.some((argument) => ['--file', '--left-file', '--right-file'].includes(argument))) {
-    return '';
-  }
-  try {
-    return readStdin();
-  } catch (error) {
-    return {
-      code: 'cli-input-stdin-read-failed',
-      expected: 'stdin can be read as one ProfileCapture JSON object',
-      hint: 'Provide readable ProfileCapture JSON on stdin or pass --file <path>.',
-      detail: { message: error instanceof Error ? error.message : String(error) },
-    };
-  }
+export function readCliInput(args: readonly string[], readStdin: () => string): string {
+  return args.some((argument) => ['--file', '--left-file', '--right-file'].includes(argument))
+    ? ''
+    : readStdin();
 }
 
 export function main(): void {

package/src/clock.ts

@@ -7,7 +7,7 @@ export function createProfileClock(readMicros: () => number = defaultReadMicros)
   return {
     nowMicros() {
       const currentMicros = readMicros();
-      if (currentMicros > lastMicros) lastMicros = currentMicros;
+      lastMicros = Math.max(lastMicros, currentMicros);
       return lastMicros;
     },
   };

package/src/compare.ts

@@ -50,10 +50,7 @@ export type ProfileComparisonError = ProfileArtifactError & {
   };
 };
 
-function withSide(
-  side: ProfileComparisonError['detail']['side'],
-  error: ProfileArtifactError,
-): ProfileComparisonError {
+function withSide(side: 'left' | 'right', error: ProfileArtifactError): ProfileComparisonError {
   return {
     ...error,
     detail: { ...error.detail, side },

package/src/index.ts

@@ -34,12 +34,6 @@ export { createProfiler } from './profiler.js';
 export type { ProfileDetail, RecorderSession } from './recorder.js';
 /** Validates a persisted capture before model building or CLI-style analysis. */
 export { validateProfileCapture } from './schema.js';
-export {
-  consumeToolPreviewProfile,
-  type ToolPreviewProfileManifest,
-  type ToolPreviewProfileRef,
-  type ToolPreviewProfileResult,
-} from './tool-preview-profile.js';
 export type {
   ProfileAllocationReport,
   ProfileCapture,

package/src/recorder.ts

@@ -34,14 +34,14 @@ const PHASE_RECORD_KIND = 1;
 const SKIP_RECORD_KIND = 2;
 
 interface RetainedRecordStore {
-  readonly kinds: Uint8Array;
+  readonly kinds: number[];
   readonly sources: ProfileSource[];
   readonly phases: string[];
-  readonly frameIds: Float64Array;
+  readonly frameIds: number[];
   readonly parentSources: Array<ProfileSource | undefined>;
   readonly parentPhases: Array<string | undefined>;
-  readonly startMicros: Float64Array;
-  readonly endMicros: Float64Array;
+  readonly startMicros: number[];
+  readonly endMicros: number[];
   readonly reasons: Array<string | undefined>;
   count: number;
 }
@@ -266,7 +266,6 @@ export function createRecorder(
 ): ProfilerResult<RecorderSession> {
   const validLimits = validateRecorderLimits(limits);
   if (!validLimits.ok) return validLimits;
-  const nowMicros = clock.nowMicros;
   const state: RecorderState = {
     limits,
     phaseCatalog,
@@ -279,15 +278,15 @@ export function createRecorder(
       render: new Set(phaseCatalog.render),
     },
     recordStore: {
-      kinds: new Uint8Array(limits.eventLimit),
-      sources: new Array<ProfileSource>(limits.eventLimit),
-      phases: new Array<string>(limits.eventLimit),
-      frameIds: new Float64Array(limits.eventLimit),
-      parentSources: new Array<ProfileSource | undefined>(limits.eventLimit),
-      parentPhases: new Array<string | undefined>(limits.eventLimit),
-      startMicros: new Float64Array(limits.eventLimit),
-      endMicros: new Float64Array(limits.eventLimit),
-      reasons: new Array<string | undefined>(limits.eventLimit),
+      kinds: [],
+      sources: [],
+      phases: [],
+      frameIds: [],
+      parentSources: [],
+      parentPhases: [],
+      startMicros: [],
+      endMicros: [],
+      reasons: [],
       count: 0,
     },
     captureId,
@@ -341,7 +340,7 @@ export function createRecorder(
       state.openSources[index] = source;
       state.openPhaseNames[index] = phase;
       state.openFrameIds[index] = frameId;
-      state.openStartMicros[index] = nowMicros();
+      state.openStartMicros[index] = clock.nowMicros();
       state.openDepth += 1;
       return OK_VOID;
     },
@@ -367,7 +366,7 @@ export function createRecorder(
       const parentSource = parentIndex >= 0 ? state.openSources[parentIndex] : undefined;
       const parentPhase = parentIndex >= 0 ? state.openPhaseNames[parentIndex] : undefined;
       if (!state.overflow) {
-        const endMicros = Math.max(startMicros, nowMicros());
+        const endMicros = Math.max(startMicros, clock.nowMicros());
         retainPhaseRecord(
           state,
           source,

package/dist/__tests__/browser-profile-detail-owner.test-d.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=browser-profile-detail-owner.test-d.d.ts.map

package/dist/__tests__/browser-profile-detail-owner.test-d.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"browser-profile-detail-owner.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/browser-profile-detail-owner.test-d.ts"],"names":[],"mappings":""}

package/dist/__tests__/browser-user-timing.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=browser-user-timing.test.d.ts.map

package/dist/__tests__/browser-user-timing.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"browser-user-timing.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/browser-user-timing.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/comparison-side-owner.test-d.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=comparison-side-owner.test-d.d.ts.map

package/dist/__tests__/comparison-side-owner.test-d.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"comparison-side-owner.test-d.d.ts","sourceRoot":"","sources":["../../src/__tests__/comparison-side-owner.test-d.ts"],"names":[],"mappings":""}

package/dist/__tests__/schema-derived-union-owner.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=schema-derived-union-owner.test.d.ts.map

package/dist/__tests__/schema-derived-union-owner.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema-derived-union-owner.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/schema-derived-union-owner.test.ts"],"names":[],"mappings":""}

package/dist/tool-preview-profile.d.ts

@@ -1,33 +0,0 @@
-import { type ProfileCapture } from './index.js';
-export interface ToolPreviewProfileRef {
-    readonly kind: 'profile-capture';
-    readonly digest: string;
-    readonly uri: string;
-}
-export interface ToolPreviewProfileManifest {
-    readonly runId: string;
-    readonly captureId: string;
-    readonly profileDigest: string;
-}
-export type ToolPreviewProfileResult = {
-    readonly ok: true;
-    readonly value: {
-        readonly runId: string;
-        readonly captureId: string;
-        readonly profile: ProfileCapture;
-    };
-} | {
-    readonly ok: false;
-    readonly error: {
-        readonly code: string;
-        readonly expected: string;
-        readonly hint: string;
-        readonly detail: unknown;
-    };
-};
-export declare function consumeToolPreviewProfile(input: {
-    readonly manifest: ToolPreviewProfileManifest;
-    readonly profile: unknown;
-    readonly ref: ToolPreviewProfileRef;
-}): ToolPreviewProfileResult;
-//# sourceMappingURL=tool-preview-profile.d.ts.map

package/dist/tool-preview-profile.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool-preview-profile.d.ts","sourceRoot":"","sources":["../src/tool-preview-profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAA0B,MAAM,YAAY,CAAC;AAEzE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,MAAM,wBAAwB,GAChC;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;KAClC,CAAC;CACH,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;KAC1B,CAAC;CACH,CAAC;AAEN,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,QAAQ,CAAC,QAAQ,EAAE,0BAA0B,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,qBAAqB,CAAC;CACrC,GAAG,wBAAwB,CAiB3B"}

package/src/__tests__/browser-profile-detail-owner.test-d.ts

@@ -1,26 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { describe, expect, expectTypeOf, it } from 'vitest';
-import type { ProfileDetail, RecorderSession } from '../index.js';
-
-type ExpectedProfileDetail = 'owner' | 'passes' | 'nested';
-const browserSource = readFileSync(new URL('../browser-user-timing.ts', import.meta.url), 'utf8');
-const recorderSource = readFileSync(new URL('../recorder.ts', import.meta.url), 'utf8');
-
-describe('browser ProfileDetail owner', () => {
-  it('preserves the public vocabulary and session detail projection', () => {
-    expectTypeOf<ProfileDetail>().toEqualTypeOf<ExpectedProfileDetail>();
-    expectTypeOf<RecorderSession['detail']>().toEqualTypeOf<ProfileDetail>();
-    expectTypeOf<ProfileDetail>().toEqualTypeOf<RecorderSession['detail']>();
-  });
-
-  it('derives the private browser view from the recorder owner', () => {
-    expect(browserSource).toContain(
-      "import type { ProfileDetail, RecorderSession } from './recorder.js';",
-    );
-    expect(browserSource).toContain('type BrowserProfileDetail = ProfileDetail;');
-    expect(browserSource).not.toContain(
-      "type BrowserProfileDetail = 'owner' | 'passes' | 'nested';",
-    );
-    expect(recorderSource).toContain("export type ProfileDetail = 'owner' | 'passes' | 'nested';");
-  });
-});

package/src/__tests__/browser-user-timing.test.ts

@@ -1,127 +0,0 @@
-import { afterEach, describe, expect, it, vi } from 'vitest';
-import { createUserTimingProfiler } from '../browser-user-timing.js';
-import { runProfilerCli } from '../cli.js';
-import { buildProfileModel } from '../model.js';
-import { validateProfileCapture } from '../schema.js';
-import type { ProfileCapture, ProfileResult } from '../types.js';
-
-const DIAGNOSTICS_KEY = '__forgeaxFramePhaseDiagnostics';
-const APP_PHASES = ['frame-total', 'world-update-primary'] as const;
-const RENDER_PHASES = ['extract', 'record'] as const;
-
-function expectOk<T, E>(result: ProfileResult<T, E>): T {
-  expect(result.ok).toBe(true);
-  if (!result.ok) throw new Error('expected a successful profiler result');
-  return result.value;
-}
-
-function enableDiagnostics(detail: 'owner' | 'passes' | 'nested' = 'nested'): void {
-  (globalThis as Record<string, unknown>)[DIAGNOSTICS_KEY] = { enabled: true, detail };
-}
-
-function registerCatalogs(
-  profiler: NonNullable<ReturnType<typeof createUserTimingProfiler>>,
-): void {
-  expectOk(profiler.registerPhaseCatalog('app', APP_PHASES));
-  expectOk(profiler.registerPhaseCatalog('render', RENDER_PHASES));
-}
-
-function finishOneFrame(
-  profiler: NonNullable<ReturnType<typeof createUserTimingProfiler>>,
-): ProfileCapture {
-  const session = expectOk(profiler.startCapture({ frameLimit: 2, eventLimit: 8 }));
-  expectOk(session.beginFrame(1));
-  expectOk(session.beginPhase({ source: 'app', phase: 'frame-total' }));
-  expectOk(session.endPhase());
-  expectOk(session.beginPhase({ source: 'render', phase: 'record' }));
-  expectOk(session.endPhase());
-  expectOk(session.endFrame());
-  return expectOk(session.finish());
-}
-
-afterEach(() => {
-  Reflect.deleteProperty(globalThis, DIAGNOSTICS_KEY);
-  vi.unstubAllGlobals();
-});
-
-describe('browser User Timing profiler', () => {
-  it('emits a schema-valid default capture through model and CLI consumers', () => {
-    enableDiagnostics();
-    const profiler = createUserTimingProfiler();
-    expect(profiler).toBeDefined();
-    if (profiler === undefined) return;
-    registerCatalogs(profiler);
-
-    const capture = finishOneFrame(profiler);
-
-    expect(capture.captureId).toBe('capture-0001');
-    expect(capture.completeness).toEqual({
-      status: 'partial',
-      retainedEventCount: 0,
-      droppedEventCount: 0,
-      incompleteReason: 'user-timing-transport',
-    });
-    expect(validateProfileCapture(capture).ok).toBe(true);
-
-    const model = buildProfileModel(capture);
-    expect(model.ok).toBe(true);
-    if (!model.ok) return;
-    expect(model.value.summary.captureId).toBe('capture-0001');
-
-    const cli = runProfilerCli(['summary'], JSON.stringify(capture));
-    expect(cli.exitCode).toBe(0);
-    expect(JSON.parse(cli.stdout)).toMatchObject({ captureId: 'capture-0001' });
-  });
-
-  it('preserves valid caller IDs and derives the default for invalid IDs', () => {
-    enableDiagnostics('owner');
-    const valid = createUserTimingProfiler({ captureId: 'capture-1234' });
-    expect(valid).toBeDefined();
-    if (valid === undefined) return;
-    expect(finishOneFrame(valid).captureId).toBe('capture-1234');
-
-    const invalid = createUserTimingProfiler({ captureId: 'host-session' });
-    expect(invalid).toBeDefined();
-    if (invalid === undefined) return;
-    const capture = finishOneFrame(invalid);
-    expect(capture.captureId).toBe('capture-0001');
-    expect(validateProfileCapture(capture).ok).toBe(true);
-  });
-
-  it('keeps disabled creation inert and retains onPhaseEnd-only callbacks', () => {
-    const mark = vi.fn();
-    vi.stubGlobal('performance', { mark });
-
-    expect(createUserTimingProfiler()).toBeUndefined();
-    expect(mark).not.toHaveBeenCalled();
-
-    const onPhaseEnd = vi.fn();
-    const profiler = createUserTimingProfiler({ onPhaseEnd });
-    expect(profiler).toBeDefined();
-    if (profiler === undefined) return;
-    const capture = finishOneFrame(profiler);
-
-    expect(onPhaseEnd).toHaveBeenCalledWith({ source: 'app', phase: 'frame-total' });
-    expect(onPhaseEnd).toHaveBeenCalledWith({ source: 'render', phase: 'record' });
-    expect(mark).not.toHaveBeenCalled();
-    expect(validateProfileCapture(capture).ok).toBe(true);
-  });
-
-  it('supports repeated start and finish with one partial artifact per session', () => {
-    enableDiagnostics('passes');
-    const profiler = createUserTimingProfiler();
-    expect(profiler).toBeDefined();
-    if (profiler === undefined) return;
-
-    const first = expectOk(profiler.startCapture({ frameLimit: 1, eventLimit: 1 }));
-    const firstCapture = expectOk(first.finish());
-    const second = expectOk(profiler.startCapture({ frameLimit: 1, eventLimit: 1 }));
-    const secondCapture = expectOk(second.finish());
-
-    expect(firstCapture.captureId).toBe('capture-0001');
-    expect(secondCapture.captureId).toBe('capture-0001');
-    expect(profiler.latestCapture()).toBe(secondCapture);
-    expect(validateProfileCapture(firstCapture).ok).toBe(true);
-    expect(validateProfileCapture(secondCapture).ok).toBe(true);
-  });
-});

package/src/__tests__/comparison-side-owner.test-d.ts

@@ -1,28 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { describe, expect, expectTypeOf, it } from 'vitest';
-import type { ProfileComparisonError } from '../index.js';
-
-type ComparisonErrorSide = ProfileComparisonError['detail']['side'];
-type ExpectedComparisonErrorSide = 'left' | 'right';
-
-const compareSource = readFileSync(new URL('../compare.ts', import.meta.url), 'utf8');
-
-describe('profile comparison side owner', () => {
-  it('keeps the public side vocabulary bilaterally exact', () => {
-    expectTypeOf<ComparisonErrorSide>().toEqualTypeOf<ExpectedComparisonErrorSide>();
-    expectTypeOf<ExpectedComparisonErrorSide>().toEqualTypeOf<ComparisonErrorSide>();
-
-    const acceptsSide = (side: ComparisonErrorSide): void => void side;
-    acceptsSide('left');
-    acceptsSide('right');
-    // @ts-expect-error Unknown sides remain outside the public comparison vocabulary.
-    acceptsSide('comparison-side-not-real');
-  });
-
-  it('derives withSide from the public error detail owner', () => {
-    expect(compareSource).toContain("side: ProfileComparisonError['detail']['side'],");
-    expect(compareSource).not.toContain("side: 'left' | 'right'");
-    expect(compareSource).toContain("withSide('left', leftModel.error)");
-    expect(compareSource).toContain("withSide('right', rightModel.error)");
-  });
-});

package/src/__tests__/schema-derived-union-owner.test.ts

@@ -1,57 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { describe, expect, it } from 'vitest';
-
-type Schema = { $defs: Record<string, unknown> };
-
-function readSchema(): Schema {
-  return JSON.parse(
-    readFileSync(new URL('../../schema/profile-capture.schema.json', import.meta.url), 'utf8'),
-  ) as Schema;
-}
-
-function literalUnion(values: readonly string[]): string {
-  return values.map((value) => `'${value}'`).join(' | ');
-}
-
-function readStringEnum(definition: unknown): readonly string[] {
-  return (definition as { enum: readonly string[] }).enum;
-}
-
-function readRecordKinds(schema: Schema): readonly string[] {
-  const record = schema.$defs.record as { oneOf: readonly { $ref: string }[] };
-  return record.oneOf.map(({ $ref }) => {
-    const definitionName = $ref.slice('#/$defs/'.length);
-    const definition = schema.$defs[definitionName] as {
-      properties: { kind: { const: string } };
-    };
-    return definition.properties.kind.const;
-  });
-}
-
-describe('schema-derived profiler union owners', () => {
-  it('projects the three closed unions from schema memberships', () => {
-    const schema = readSchema();
-    const source = readFileSync(
-      new URL('../../scripts/generate-profile-types.mjs', import.meta.url),
-      'utf8',
-    );
-    const generated = readFileSync(
-      new URL('../generated/profile-capture.ts', import.meta.url),
-      'utf8',
-    );
-
-    const sourceUnion = literalUnion(readStringEnum(schema.$defs.source));
-    const recordKindUnion = literalUnion(readRecordKinds(schema));
-    const completenessStatus = schema.$defs.completeness as {
-      properties: { status: { enum: readonly string[] } };
-    };
-    const completenessUnion = literalUnion(readStringEnum(completenessStatus.properties.status));
-
-    expect(generated).toContain(`export type ProfileSource = ${sourceUnion};`);
-    expect(generated).toContain(`export type ProfileRecordKind = ${recordKindUnion};`);
-    expect(generated).toContain(`export type ProfileCompletenessStatus = ${completenessUnion};`);
-    expect(source).toContain('schema.$defs.source.enum');
-    expect(source).toContain('schema.$defs.record.oneOf');
-    expect(source).toContain('schema.$defs.completeness.properties.status.enum');
-  });
-});