@forgeax/engine-rhi-debug 0.1.2

package/dist/frame-model.d.ts

@@ -0,0 +1,126 @@
+import type { TapePassEntry, TapeResourceEntry } from './protocol/tape-index';
+import type { Tape as V7Tape } from './protocol/types';
+import type { CreateDescriptor, DrawPipelineState, HandleId, InspectBindingEntry, InspectDrawCall, RhiCallEvent } from './types';
+export type { CreateDescriptor, DrawPipelineState } from './types';
+export interface PassDrawItem {
+    readonly workIndex: number;
+    readonly eventKind: 'draw' | 'drawIndexed' | 'dispatchWorkgroups' | 'dispatchWorkgroupsIndirect' | 'drawIndirect' | 'drawIndexedIndirect';
+}
+export interface PassNode {
+    readonly kind: 'render' | 'compute';
+    readonly passIdx: number;
+    readonly draws: readonly PassDrawItem[];
+}
+export interface DrawEntry {
+    readonly frameIdx: number;
+    readonly passIdx: number;
+    readonly bindings: readonly InspectBindingEntry[];
+    readonly drawCall: InspectDrawCall;
+    readonly colorAttachmentHandleId: string | undefined;
+    readonly pipelineState: DrawPipelineState;
+    readonly vertexBuffers: ReadonlyMap<number, {
+        readonly handleId: HandleId;
+        readonly offset: number;
+        readonly size: number;
+    }>;
+    readonly indexBuffer?: {
+        handleId: HandleId;
+        format: GPUIndexFormat;
+        offset: number;
+    } | undefined;
+    readonly depthStencil: DrawDepthStencil;
+}
+export interface DrawDepthStencil {
+    readonly depthStencilViewHandleId: HandleId | undefined;
+    readonly depthStencilAttachment: GPURenderPassDepthStencilAttachment | undefined;
+}
+export interface CommandEntry {
+    readonly passIdx: number;
+    readonly eventIdx: number;
+    readonly isDraw: boolean;
+    readonly kind: string;
+    readonly groupLabel: string | undefined;
+    readonly markerLabel: string | undefined;
+}
+export interface FrameModelMeta {
+    readonly totalDraws: number;
+    readonly totalPasses: number;
+    readonly hasCompute: boolean;
+}
+export interface WorkEntry {
+    readonly workIndex: number;
+    readonly eventIndex: number;
+    readonly passIndex: number;
+    readonly kind: string;
+}
+export interface FrameModel {
+    readonly tree: readonly PassNode[];
+    readonly draws: readonly DrawEntry[];
+    readonly meta: FrameModelMeta;
+    readonly commands: readonly CommandEntry[];
+    readonly resources: ReadonlyMap<HandleId, CreateDescriptor>;
+    readonly resourceLifecycle: ResourceLifecycleSummary;
+    readonly works: readonly WorkEntry[];
+    readonly passes: readonly TapePassEntry[];
+    readonly resourceEntries: readonly TapeResourceEntry[];
+}
+export declare function buildFrameModel(tape: V7Tape): FrameModel;
+/** A byte estimate that distinguishes known descriptor size from unavailable GPU facts. */
+export type ResourceByteEstimate = {
+    readonly status: 'known';
+    readonly bytes: number;
+    readonly basis: 'buffer-descriptor' | 'texture-tight-layout';
+} | {
+    readonly status: 'unavailable';
+    readonly reason: 'non-memory-resource' | 'unsupported-texture-dimension' | 'unsupported-texture-format' | 'invalid-texture-size';
+};
+export type ResourceKind = 'buffer' | 'texture' | 'texture-view' | 'sampler' | 'bind-group-layout' | 'bind-group' | 'pipeline-layout' | 'render-pipeline' | 'compute-pipeline' | 'shader-module';
+export type ResourceOrigin = 'engine' | 'swapchain';
+export interface ResourceLifecycleEntry {
+    readonly handleId: HandleId;
+    readonly kind: ResourceKind;
+    readonly origin: ResourceOrigin;
+    readonly state: 'live' | 'destroyed';
+    readonly createdEventIndex: number;
+    readonly destroyedEventIndex?: number;
+    readonly byteEstimate: ResourceByteEstimate;
+}
+export interface ResourceLifecycleSummary {
+    /** This is the resource closure represented by the tape, not the whole device heap. */
+    readonly scope: 'captured-tape-resource-closure';
+    readonly counts: {
+        readonly created: number;
+        readonly destroyed: number;
+        readonly live: number;
+        readonly destroyEvents: number;
+        readonly unknownDestroyEvents: number;
+    };
+    readonly bytes: {
+        readonly knownCreated: number;
+        readonly knownDestroyed: number;
+        readonly knownLive: number;
+        readonly unavailableCreated: number;
+        readonly unavailableDestroyed: number;
+        readonly unavailableLive: number;
+    };
+    readonly originBreakdown: Readonly<Record<ResourceOrigin, {
+        readonly created: number;
+        readonly destroyed: number;
+        readonly live: number;
+        readonly knownCreated: number;
+        readonly knownDestroyed: number;
+        readonly knownLive: number;
+        readonly unavailableCreated: number;
+        readonly unavailableDestroyed: number;
+        readonly unavailableLive: number;
+    }>>;
+    readonly availability: {
+        readonly destroy: 'observed-buffer-texture';
+        readonly retire: 'unavailable';
+        readonly driverAllocation: 'unavailable';
+    };
+    readonly resources: readonly ResourceLifecycleEntry[];
+}
+/** Build a pure lifecycle ledger from the ordered tape events. */
+export declare function buildResourceLifecycle(events: readonly RhiCallEvent[]): ResourceLifecycleSummary;
+//# sourceMappingURL=frame-model.d.ts.map

package/dist/frame-model.d.ts.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export { createRhiDebugError, type RhiDebugError, type RhiDebugErrorCode, type RhiDebugErrorDetail, type RhiDebugErrorFor, } from './errors';
+export type { CommandEntry, CreateDescriptor, DrawDepthStencil, DrawEntry, DrawPipelineState, FrameModel, FrameModelMeta, PassDrawItem, PassNode, WorkEntry, } from './frame-model';
+export { buildFrameModel } from './frame-model';
+export { decodeTape, encodeTape } from './protocol/codec';
+export type { EventCategory, EventSemantics } from './protocol/event-semantics';
+export { EVENT_SEMANTICS, eventKinds, isWorkEvent, resourceKindForEvent, workEventKinds, } from './protocol/event-semantics';
+export type { TapeIndex, TapePassEntry, TapeResourceEntry, TapeWorkEntry, } from './protocol/tape-index';
+export { buildTapeIndex } from './protocol/tape-index';
+export type { BootstrapResource, InitialDataSlice, RhiCallEvent as V7RhiCallEvent, RhiCapsRecorded as V7RhiCapsRecorded, RhiDebugResult, Tape as V7Tape, TapeBlob as V7TapeBlob, TapeBlobCompression, TapeEncodeOptions, } from './protocol/types';
+export { TAPE_FORMAT_VERSION as V7_TAPE_FORMAT_VERSION, TAPE_MAGIC, } from './protocol/types';
+export { readbackTexturePixels } from './readback';
+export { attachRecorder, type CaptureFrameOptions, type CreateShaderModuleFn, type EncodedTape, type RecordableBackend, type RecorderAttachment, type RecorderBackend, type RecorderOptions, } from './recorder/session';
+export { type InspectField, openReplay, type ReadbackSubresource, type ReplayBackend, type ReplayReadbackResult, type ReplaySession, type TextureSubresource, type WorkInspection, } from './replay/session';
+export { decodeTexelRaw, decodeToRgba8, halfToFloat } from './texel-decode';
+export { bytesPerTexel, type ChannelType, type FormatInfo, formatInfo, } from './texel-layout';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,GACtB,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,SAAS,GACV,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EACL,eAAe,EACf,UAAU,EACV,WAAW,EACX,oBAAoB,EACpB,cAAc,GACf,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,aAAa,GACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,IAAI,cAAc,EAC9B,eAAe,IAAI,iBAAiB,EACpC,cAAc,EACd,IAAI,IAAI,MAAM,EACd,QAAQ,IAAI,UAAU,EACtB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,IAAI,sBAAsB,EAC7C,UAAU,GACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EACL,cAAc,EACd,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,KAAK,YAAY,EACjB,UAAU,EACV,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,cAAc,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EACL,aAAa,EACb,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,UAAU,GACX,MAAM,gBAAgB,CAAC"}