@forgeax/engine-render-graph 0.1.20 → 0.1.23

package/README.md

@@ -107,6 +107,49 @@ label. Compute work that targets the parent command encoder, such as resolving t
 belongs in `after`; pass commands remain in `encode`. `onBeginError` lets the pass owner terminalize
 feature-local evidence before the graph returns `pass-encode-failed`.
 
+### Pass instrumentation
+
+Renderer-owned instrumentation may be supplied as the third argument to
+`compiled.execute(frame, runPass, instrumentation)`. The graph calls
+`instrumentation.begin` immediately before each executable pass and applies the
+returned descriptor decorator at the actual `beginRenderPass` or
+`beginComputePass` boundary. This is the single seam for pass-level timestamp
+queries and similar graph-neutral observation; it preserves pass name, kind, and
+execution index without moving timing policy into the graph.
+
+```ts
+compiled.execute(frame, undefined, {
+  begin: (pass) =>
+    pass.kind === 'compute'
+      ? {
+          computePassDescriptor: (descriptor) => ({
+            ...descriptor,
+            timestampWrites: {
+              querySet,
+              beginningOfPassWriteIndex: 0,
+              endOfPassWriteIndex: 1,
+            },
+          }),
+        }
+      : undefined,
+});
+```
+
+The graph never calls a backend-specific command-encoder timestamp helper.
+Pass instrumentation must preserve any producer-owned descriptor facts; a
+policy owner that cannot merge an existing `timestampWrites` pair should fail
+closed instead of overwriting it. Copy passes expose `beforeCopy`/`afterCopy`
+hooks for non-timing instrumentation, but WebGPU has no portable copy-pass
+timestamp descriptor.
+> [!NOTE]
+> `timestampWrites` and an `after(frame)` callback are neutral graph seams. They
+> let a pipeline owner place a backend command at a declared pass boundary, but
+> Render owns the `GpuPassTiming` session, decimal tick parser, bounded facts,
+> four-status observation, and benchmark validator. RenderGraph must not import
+> that timing contract, name a timing status, or decide whether a measurement is
+> accepted. The public route is documented in
+> [`@forgeax/engine-render`](../render/README.md).
+
 ## Compile and execution
 
 `compile({ device, surfaceSize })`:

package/dist/__tests__/render-graph-gpu-timing-instrumentation.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=render-graph-gpu-timing-instrumentation.unit.test.d.ts.map

package/dist/__tests__/render-graph-gpu-timing-instrumentation.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-graph-gpu-timing-instrumentation.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/render-graph-gpu-timing-instrumentation.unit.test.ts"],"names":[],"mappings":""}

package/dist/builder.d.ts.map

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

package/dist/compiled-graph.d.ts

@@ -2,7 +2,7 @@ import type { RhiDevice, Texture, TextureView } from '@forgeax/engine-rhi';
 import { RenderGraphError, type Result } from './errors.js';
 import type { ResolvedColorTargetDescriptor } from './graph.js';
 import type { CompiledPass, CompiledResource, CompiledView } from './kernel-internal.js';
-import type { CompiledRenderGraph, CompiledRenderGraphInfo, RenderGraphFrame, RenderGraphPassRunner } from './types.js';
+import type { CompiledRenderGraph, CompiledRenderGraphInfo, RenderGraphFrame, RenderGraphPassInstrumentation, RenderGraphPassRunner } from './types.js';
 export declare class CompiledRenderGraphImpl<FrameCtx extends RenderGraphFrame> implements CompiledRenderGraph<FrameCtx> {
     private readonly generation;
     private readonly owner;
@@ -19,7 +19,7 @@ export declare class CompiledRenderGraphImpl<FrameCtx extends RenderGraphFrame>
     getColorTargetView(name: string): TextureView | undefined;
     getColorTargetTexture(name: string): Texture | undefined;
     getColorTargetDescriptor(name: string): ResolvedColorTargetDescriptor | undefined;
-    execute(frame: FrameCtx, runPass?: RenderGraphPassRunner): Result<void, RenderGraphError>;
+    execute(frame: FrameCtx, runPass?: RenderGraphPassRunner, instrumentation?: RenderGraphPassInstrumentation<FrameCtx>): Result<void, RenderGraphError>;
     retire(): Promise<Result<void, RenderGraphError>>;
     private finishRetire;
     private resolveFrameResources;

package/dist/compiled-graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compiled-graph.d.ts","sourceRoot":"","sources":["../src/compiled-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,SAAS,EACT,OAAO,EACP,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAW,gBAAgB,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,YAAY,EAEb,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EAKvB,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAiBpB,qBAAa,uBAAuB,CAAC,QAAQ,SAAS,gBAAgB,CACpE,YAAW,mBAAmB,CAAC,QAAQ,CAAC;IAMtC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,sBAAsB;IAXzC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAsD;gBAGvD,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC,EAC1D,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,EAClD,MAAM,EAAE,SAAS,YAAY,CAAC,QAAQ,CAAC,EAAE,EACzC,IAAI,EAAE,uBAAuB,EAC7B,sBAAsB,EAAE,WAAW,CAAC,MAAM,EAAE,6BAA6B,CAAC;IAG7F,OAAO,IAAI,uBAAuB;IAIlC,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAQzD,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAOxD,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,6BAA6B,GAAG,SAAS;IAIjF,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAgJzF,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;YAOnC,YAAY;IA+C1B,OAAO,CAAC,qBAAqB;IAiD7B,OAAO,CAAC,kBAAkB;CAwE3B"}
+{"version":3,"file":"compiled-graph.d.ts","sourceRoot":"","sources":["../src/compiled-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,SAAS,EACT,OAAO,EACP,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAW,gBAAgB,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,YAAY,EAEb,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EAKvB,gBAAgB,EAChB,8BAA8B,EAC9B,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAiBpB,qBAAa,uBAAuB,CAAC,QAAQ,SAAS,gBAAgB,CACpE,YAAW,mBAAmB,CAAC,QAAQ,CAAC;IAMtC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,sBAAsB;IAXzC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAsD;gBAGvD,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC,EAC1D,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,EAClD,MAAM,EAAE,SAAS,YAAY,CAAC,QAAQ,CAAC,EAAE,EACzC,IAAI,EAAE,uBAAuB,EAC7B,sBAAsB,EAAE,WAAW,CAAC,MAAM,EAAE,6BAA6B,CAAC;IAG7F,OAAO,IAAI,uBAAuB;IAIlC,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAQzD,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAOxD,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,6BAA6B,GAAG,SAAS;IAIjF,OAAO,CACL,KAAK,EAAE,QAAQ,EACf,OAAO,CAAC,EAAE,qBAAqB,EAC/B,eAAe,CAAC,EAAE,8BAA8B,CAAC,QAAQ,CAAC,GACzD,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAqKjC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;YAOnC,YAAY;IA+C1B,OAAO,CAAC,qBAAqB;IAiD7B,OAAO,CAAC,kBAAkB;CAwE3B"}

package/dist/index.d.ts

@@ -4,5 +4,5 @@ export type { BufferRole, ColorTargetDescriptor, ColorTargetHandle, ColorTargetS
 export { RenderGraph } from './graph.js';
 export { type CurrentFrameObservationDescriptor, type CurrentFrameObservationLease, type CurrentFrameObservationLifetime, type CurrentFrameObservationSource, createCurrentFrameObservationLease, type ObservationSize, } from './observation.js';
 export { COLOR_VALUE_DOMAINS, type ColorDomainConnection, type ColorDomainConversion, type ColorDomainValidation, type ColorResourceDescriptor, type ColorValueDomain, deserializeColorResourceDescriptor, deserializeColorValueDomain, isColorValueDomain, serializeColorResourceDescriptor, serializeColorValueDomain, validateColorDomainConnection, } from './pipeline/color-value-domain.js';
-export type { CompiledRenderGraph, CompiledRenderGraphInfo, CompiledResourceDescriptor, ComputeGraphPass, CopyGraphPass, GraphAccess, GraphAccessInfo, GraphBuffer, GraphBufferAccess, GraphBufferDescriptor, GraphExtent, GraphPass, GraphPassKind, GraphResource, GraphResourceKind, GraphResourceOrigin, GraphResourceResolver, GraphTexture, GraphTextureAccess, GraphTextureDescriptor, GraphTextureView, GraphTextureViewDescriptor, ImportedBufferDescriptor, ImportedTextureDescriptor, ImportedTextureViewResolver, RasterColorAttachment, RasterDepthStencilAttachment, RasterGraphPass, RenderGraphCompileOptions, RenderGraphFrame, RenderGraphPassExecution, RenderGraphPassRunner, } from './types.js';
+export type { CompiledRenderGraph, CompiledRenderGraphInfo, CompiledResourceDescriptor, ComputeGraphPass, CopyGraphPass, GraphAccess, GraphAccessInfo, GraphBuffer, GraphBufferAccess, GraphBufferDescriptor, GraphExtent, GraphPass, GraphPassKind, GraphResource, GraphResourceKind, GraphResourceOrigin, GraphResourceResolver, GraphTexture, GraphTextureAccess, GraphTextureDescriptor, GraphTextureView, GraphTextureViewDescriptor, ImportedBufferDescriptor, ImportedTextureDescriptor, ImportedTextureViewResolver, RasterColorAttachment, RasterDepthStencilAttachment, RasterGraphPass, RenderGraphCompileOptions, RenderGraphFrame, RenderGraphPassExecution, RenderGraphPassInstrumentation, RenderGraphPassInstrumentationScope, RenderGraphPassRunner, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EACL,GAAG,EACH,KAAK,mBAAmB,EACxB,EAAE,EACF,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,MAAM,EACX,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,UAAU,EACV,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,QAAQ,EACR,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,6BAA6B,EAC7B,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EACL,KAAK,iCAAiC,EACtC,KAAK,4BAA4B,EACjC,KAAK,+BAA+B,EACpC,KAAK,6BAA6B,EAClC,kCAAkC,EAClC,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,kCAAkC,EAClC,2BAA2B,EAC3B,kBAAkB,EAClB,gCAAgC,EAChC,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,0BAA0B,EAC1B,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,EACX,SAAS,EACT,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,qBAAqB,EACrB,4BAA4B,EAC5B,eAAe,EACf,yBAAyB,EACzB,gBAAgB,EAChB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EACL,GAAG,EACH,KAAK,mBAAmB,EACxB,EAAE,EACF,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,MAAM,EACX,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,UAAU,EACV,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,QAAQ,EACR,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,6BAA6B,EAC7B,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EACL,KAAK,iCAAiC,EACtC,KAAK,4BAA4B,EACjC,KAAK,+BAA+B,EACpC,KAAK,6BAA6B,EAClC,kCAAkC,EAClC,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,kCAAkC,EAClC,2BAA2B,EAC3B,kBAAkB,EAClB,gCAAgC,EAChC,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,0BAA0B,EAC1B,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,EACX,SAAS,EACT,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,0BAA0B,EAC1B,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,qBAAqB,EACrB,4BAA4B,EAC5B,eAAe,EACf,yBAAyB,EACzB,gBAAgB,EAChB,wBAAwB,EACxB,8BAA8B,EAC9B,mCAAmC,EACnC,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/index.mjs

@@ -96,7 +96,7 @@ var CompiledRenderGraphImpl = class {
   getColorTargetDescriptor(name) {
     return this.colorTargetDescriptors.get(name);
   }
-  execute(frame, runPass) {
+  execute(frame, runPass, instrumentation) {
     if (this.retired) {
       return err(
         new RenderGraphError({
@@ -113,8 +113,10 @@ var CompiledRenderGraphImpl = class {
       const resolver = this.createPassResolver(pass, resolved.value);
       try {
         if (pass.pass.descriptor.executeIf?.(frame) === false) continue;
+        const execution = { name: pass.name, kind: pass.pass.kind, executionIndex };
         let encodeResult = ok(void 0);
         const encode = () => {
+          const scope = instrumentation?.begin(execution, frame);
           switch (pass.pass.kind) {
             case "raster": {
               const descriptor = pass.pass.descriptor;
@@ -160,11 +162,14 @@ var CompiledRenderGraphImpl = class {
                   ...attachment.stencilReadOnly === void 0 ? {} : { stencilReadOnly: attachment.stencilReadOnly }
                 };
               }
-              const encoder = frame.encoder.beginRenderPass({
+              const baseDescriptor = {
                 label: pass.name,
                 colorAttachments,
-                ...depthStencilAttachment === void 0 ? {} : { depthStencilAttachment }
-              });
+                ...depthStencilAttachment === void 0 ? {} : { depthStencilAttachment },
+                ...pass.pass.descriptor.occlusionQuerySet === void 0 ? {} : { occlusionQuerySet: pass.pass.descriptor.occlusionQuerySet }
+              };
+              const instrumentedDescriptor = scope?.renderPassDescriptor?.(baseDescriptor) ?? baseDescriptor;
+              const encoder = frame.encoder.beginRenderPass(instrumentedDescriptor);
               try {
                 descriptor.encode({ pass: encoder, frame, resources: resolver });
               } finally {
@@ -174,9 +179,13 @@ var CompiledRenderGraphImpl = class {
             }
             case "compute": {
               const begin = pass.pass.descriptor.begin?.(frame);
+              const instrumentedBegin = scope?.computePassDescriptor?.(begin ?? {}) ?? begin;
               let encoder;
               try {
-                encoder = frame.encoder.beginComputePass({ ...begin ?? {}, label: pass.name });
+                encoder = frame.encoder.beginComputePass({
+                  ...instrumentedBegin ?? {},
+                  label: pass.name
+                });
               } catch (cause) {
                 pass.pass.descriptor.onBeginError?.(frame, cause);
                 throw cause;
@@ -190,14 +199,19 @@ var CompiledRenderGraphImpl = class {
               break;
             }
             case "copy":
-              pass.pass.descriptor.encode({ encoder: frame.encoder, frame, resources: resolver });
+              scope?.beforeCopy?.(frame.encoder);
+              try {
+                pass.pass.descriptor.encode({ encoder: frame.encoder, frame, resources: resolver });
+              } finally {
+                scope?.afterCopy?.(frame.encoder);
+              }
               break;
           }
         };
         if (runPass === void 0) {
           encode();
         } else {
-          runPass({ name: pass.name, kind: pass.pass.kind, executionIndex }, encode);
+          runPass(execution, encode);
         }
         if (!encodeResult.ok) return encodeResult;
       } catch (cause) {
@@ -867,7 +881,8 @@ var RenderGraphBuilder = class {
         const item = this.normalizeAccess(passIndex, pass, access);
         if (!item.ok) return item;
         normalized.push(item.value);
-        const usage = this.resources.get(item.value.resourceId)?.kind === "buffer" ? bufferUsage(access.usage) : textureUsage(access.usage);
+        const resource = this.resources.get(item.value.resourceId);
+        const usage = (resource?.kind === "texture" && resource.origin === "created" ? resource.descriptor.usage ?? 0 : 0) | (resource?.kind === "buffer" ? bufferUsage(access.usage) : textureUsage(access.usage));
         usageByResource.set(
           item.value.resourceId,
           (usageByResource.get(item.value.resourceId) ?? 0) | usage