@forgeax/engine-render-graph 0.0.0-dev.8d955ade1c79

package/dist/errors.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Private code-to-detail authority for the complete RenderGraphError surface.
+ *
+ * The two resource-key errors intentionally share DanglingReadDetail. Keeping
+ * that fact in this map lets the public code and detail unions, plus the
+ * constructor arguments, derive from one authority without
+ * exporting a framework or runtime registry.
+ */
+interface RenderGraphErrorDetailByCode {
+    'dangling-read': DanglingReadDetail;
+    'cap-missing': CapMissingDetail;
+    'duplicate-resource': DuplicateResourceDetail;
+    'alias-source-missing': AliasSourceDetail;
+    'unknown-resource': DanglingReadDetail;
+    'resource-alloc-failed': ResourceAllocFailedDetail;
+    'invalid-format': InvalidFormatDetail;
+    'observation-absent': ObservationDetail;
+    'observation-invalid-format': ObservationDetail;
+    'observation-invalid-size': ObservationDetail;
+    'observation-missing-copy-src': ObservationDetail;
+    'observation-stale': ObservationDetail;
+    'observation-retired': ObservationDetail;
+    'invalid-color-domain': ColorDomainDetail;
+    'missing-color-domain': ColorDomainDetail;
+    'color-domain-mismatch': ColorDomainDetail;
+    'duplicate-pass-name': DeclarationDetail;
+    'duplicate-resource-label': DeclarationDetail;
+    'builder-sealed': DeclarationDetail;
+    'foreign-resource-handle': ResourceAccessDetail;
+    'resource-not-declared-by-pass': ResourceAccessDetail;
+    'uninitialized-read': ResourceAccessDetail;
+    'access-conflict': ResourceAccessDetail;
+    'capability-missing': CapabilityDetail;
+    'resource-descriptor-invalid': DescriptorDetail;
+    'import-usage-mismatch': DescriptorDetail;
+    'resource-allocation-failed': ResourceAllocFailedDetail;
+    'resource-resolution-failed': ResourceAccessDetail;
+    'pass-encode-failed': PassFailureDetail;
+    'compiled-graph-retired': LifecycleDetail;
+    'resource-retire-failed': LifecycleDetail;
+}
+/** Closed RenderGraphErrorCode union derived from the private detail map. */
+export type RenderGraphErrorCode = keyof RenderGraphErrorDetailByCode;
+/** Detail union projected from the private code-to-detail map. */
+export type RenderGraphErrorDetail = RenderGraphErrorDetailByCode[RenderGraphErrorCode];
+/**
+ * Constructor arguments correlated by code. `detail` remains optional to
+ * preserve the existing envelope behavior for callers that only need the
+ * top-level fields.
+ */
+type RenderGraphErrorConstructorArgs = {
+    [Code in RenderGraphErrorCode]: {
+        code: Code;
+        expected: string;
+        hint: string;
+        detail?: RenderGraphErrorDetailByCode[Code] | undefined;
+    };
+}[RenderGraphErrorCode];
+/** Detail variant for dangling-read and unknown-resource errors. */
+export interface DanglingReadDetail {
+    readonly resourceKey: string;
+    readonly passName: string;
+}
+/** Detail variant for cap-missing errors. */
+export interface CapMissingDetail {
+    readonly cap: 'compute' | 'storageBuffer';
+    readonly passName: string;
+}
+/** Detail variant for duplicate-resource errors. */
+export interface DuplicateResourceDetail {
+    readonly resourceKey: string;
+}
+/** Detail variant for aliases whose source is not a registered color target. */
+export interface AliasSourceDetail {
+    readonly aliasKey: string;
+    readonly sourceKey: string;
+}
+/** Detail variant for resource-alloc-failed errors. */
+export interface ResourceAllocFailedDetail {
+    readonly resourceKey: string;
+    readonly passName?: string | undefined;
+    readonly rhiCode?: string | undefined;
+}
+/** Detail variant for invalid-format errors. */
+export interface InvalidFormatDetail {
+    readonly resourceKey: string;
+    readonly format: string;
+    readonly expected: readonly string[];
+}
+/** Generic current-frame observation failures. */
+export interface ObservationDetail {
+    readonly frameId?: number | undefined;
+    readonly expected?: string | undefined;
+}
+export interface ColorDomainDetail {
+    readonly value?: string | undefined;
+    readonly resourceKey?: string | undefined;
+    readonly sourceDomain?: string | undefined;
+    readonly destinationDomain?: string | undefined;
+}
+export interface DeclarationDetail {
+    readonly passName?: string | undefined;
+    readonly resourceLabel?: string | undefined;
+}
+export interface ResourceAccessDetail {
+    readonly passName?: string | undefined;
+    readonly resourceLabel?: string | undefined;
+    readonly usage?: string | undefined;
+    readonly accesses?: readonly string[] | undefined;
+}
+export interface CapabilityDetail extends ResourceAccessDetail {
+    readonly capability: 'compute' | 'storage-buffer' | 'storage-texture' | 'indirect';
+}
+export interface DescriptorDetail {
+    readonly resourceLabel: string;
+    readonly field: string;
+    readonly expected: string;
+    readonly actual?: string | number | undefined;
+}
+export interface PassFailureDetail {
+    readonly passName: string;
+    readonly passKind: 'raster' | 'compute' | 'copy';
+    readonly cause: unknown;
+}
+export interface LifecycleDetail {
+    readonly generation: number;
+    readonly resourceLabel?: string | undefined;
+    readonly cause?: unknown;
+}
+/**
+ * Structured RenderGraph error.
+ *
+ * Four readonly fields aligned with AGENTS.md "Errors are structured"
+ * and RhiError (research Finding 8):
+ * - `.code` — closed union member (L1 key signal).
+ * - `.expected` — expected-state description (L2 detail).
+ * - `.hint` — actionable recovery guidance (L2 detail).
+ * - `.detail` — narrowed payload per code variant.
+ */
+export declare class RenderGraphError extends Error {
+    readonly code: RenderGraphErrorCode;
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: RenderGraphErrorDetail | undefined;
+    constructor(args: RenderGraphErrorConstructorArgs);
+}
+export { err, ok, type Result, type ResultErr, type ResultOk, } from '@forgeax/engine-types';
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

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

package/dist/graph.d.ts

@@ -0,0 +1,403 @@
+import type { RhiCaps, ComputePassDescriptor as RhiComputePassDescriptor, RhiComputePassEncoder, RhiDevice, Texture, TextureFormat, TextureView } from '@forgeax/engine-rhi';
+import { RenderGraphError, type Result } from './errors.js';
+import { type CurrentFrameObservationDescriptor, type CurrentFrameObservationLease } from './observation.js';
+import type { PassEntry } from './pass-registry.js';
+import { type ColorDomainConnection, type ColorValueDomain } from './pipeline/color-value-domain.js';
+import type { ResourceEntry } from './resource-registry.js';
+export type ResourceKind = 'texture' | 'buffer';
+export type ResourceLifetime = 'transient' | 'persistent';
+export type BufferRole = 'auto-storage-or-uniform' | 'uniform';
+/**
+ * Three-state size for addColorTarget (D-8):
+ * - 'swapchain' — matches the output canvas size
+ * - 'half-swapchain' — 1/2 the output canvas size (bloom downscale)
+ * - { w, h } — fixed pixel dimensions (shadow maps, etc.)
+ */
+export type ColorTargetSize = 'swapchain' | 'half-swapchain' | {
+    readonly w: number;
+    readonly h: number;
+};
+/**
+ * Color target descriptor for addColorTarget (D-8).
+ *
+ * format: GPU texture format (e.g. 'rgba16float', 'bgra8unorm').
+ * size: target dimensions relative to swap-chain or absolute.
+ * lifetime: allocation lifetime (default 'transient'); persistent targets keep
+ * their physical texture across unchanged compiles and replace it on descriptor drift.
+ * sample: multisample count (default 1; MSAA count=4 via #301).
+ * usage: GPU texture usage flags (default RENDER_ATTACHMENT | TEXTURE_BINDING).
+ * viewFormats: extra GPU texture formats viewable via createTextureView from this
+ *   texture; mirrors GPUTextureDescriptor.viewFormats. The LDR MSAA path needs
+ *   `bgra8unorm` storage + `bgra8unorm-srgb` view (hardware sRGB encoding on
+ *   store), so the consumer pre-declares the alternate format here.
+ */
+export interface ColorTargetDescriptor {
+    readonly format: TextureFormat;
+    readonly size: ColorTargetSize;
+    readonly lifetime?: ResourceLifetime | undefined;
+    readonly sample?: number | undefined;
+    readonly usage?: number | undefined;
+    readonly viewFormats?: readonly TextureFormat[] | undefined;
+    /** Semantic color domain. Omitted only for legacy graphs without domain connections. */
+    readonly domain?: ColorValueDomain | undefined;
+}
+export interface ResolvedColorTargetDescriptor {
+    readonly texture: Texture;
+    readonly format: TextureFormat;
+    readonly size: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly usage: number;
+    readonly sample: number;
+}
+export interface ResourceDescriptor {
+    readonly kind: ResourceKind;
+    readonly lifetime: ResourceLifetime;
+    readonly bufferRole?: BufferRole;
+}
+/**
+ * Opaque handle returned by addColorTarget. Resolved to a TextureView after
+ * compile by calling resolve(name) in a pass execute closure.
+ */
+export type ColorTargetHandle = string;
+/**
+ * Per-pass resolve context: maps color target names to compiled TextureViews.
+ * A pass execute closure receives this alongside the user-provided Ctx.
+ */
+export interface ResolveContext {
+    /** Resolve a color target name to its compiled TextureView, or undefined if not compiled. */
+    readonly resolve: (name: string) => unknown;
+}
+export interface PassDescriptor<Ctx = unknown> {
+    readonly reads: readonly string[];
+    readonly writes: readonly string[];
+    readonly execute?: ((ctx: Ctx) => void) | ((ctx: Ctx, resolve: ResolveContext) => void);
+    readonly compute?: boolean;
+    readonly storageBuffer?: boolean;
+    /** Explicit resource-to-resource color-domain edges validated at compile time. */
+    readonly colorConnections?: readonly ColorDomainConnection[] | undefined;
+}
+export interface ComputePassDescriptor<Ctx> {
+    readonly reads: readonly string[];
+    readonly writes: readonly string[];
+    readonly storageBuffer?: boolean | undefined;
+    readonly begin?: ((frame: Ctx) => RhiComputePassDescriptor) | undefined;
+    readonly onBeginError?: ((frame: Ctx, cause: unknown) => void) | undefined;
+    readonly after?: ((frame: Ctx) => void) | undefined;
+    encode(context: {
+        readonly pass: RhiComputePassEncoder;
+        readonly frame: Ctx;
+        readonly resources: ResolveContext;
+    }): void;
+}
+/** Optional nested observer for per-pass execution attribution. */
+export type PassExecuteRunner = (passName: string, action: () => void) => void;
+export interface PassInfo {
+    readonly name: string;
+    readonly reads: readonly string[];
+    readonly writes: readonly string[];
+}
+export interface ResourceInfo {
+    readonly key: string;
+    readonly kind: ResourceKind;
+    readonly lifetime: ResourceLifetime;
+}
+export interface InternalizedPass {
+    readonly name: string;
+    readonly reads: readonly string[];
+    readonly writes: readonly string[];
+}
+/**
+ * RHI buffer binding type a buffer resource resolves to after compile.
+ * Mirrors the `@webgpu/types` GPUBufferBindingType subset used by the
+ * storage-vs-uniform cap switch (research Finding 7; runtime template
+ * `pbr-pipeline.ts` `caps.storageBuffer ? 'read-only-storage' : 'uniform'`).
+ */
+export type ResolvedBufferType = 'read-only-storage' | 'uniform';
+/**
+ * Resolved buffer binding for a registered `kind:'buffer'` resource.
+ * Produced by compile() per AC-09 / D-6.1: the declarative graph picks the
+ * concrete binding type from `caps.storageBuffer`, so a consumer building a
+ * bind-group layout reads `resolvedBufferType` instead of duplicating the
+ * cap switch.
+ */
+export interface ResolvedBuffer {
+    readonly key: string;
+    readonly resolvedBufferType: ResolvedBufferType;
+}
+export interface InternalizedGraph {
+    readonly passes: readonly InternalizedPass[];
+    /**
+     * Buffer resources resolved to a concrete RHI binding type (AC-09).
+     * Empty when the graph declares no `kind:'buffer'` resources.
+     */
+    readonly resolvedBuffers: readonly ResolvedBuffer[];
+    /**
+     * Resolved TextureViews keyed by resource name.
+     * Populated by the compile allocation phase for addColorTarget resources.
+     * Empty when no color targets were declared.
+     */
+    readonly resolvedTextures: ReadonlyMap<string, TextureView>;
+}
+export interface CompileOptions {
+    readonly backendKind: 'webgpu' | 'wgpu-native' | 'wgpu-webgl2' | 'null';
+    readonly caps: RhiCaps;
+    /**
+     * RHI device interface handle for real GPU texture allocation (D-1).
+     * Required when the graph has addColorTarget resources; the compile phase
+     * calls device.createTexture/createTextureView for each color target.
+     */
+    readonly device?: RhiDevice | undefined;
+}
+export declare class RenderGraph<Ctx = unknown> {
+    private readonly resources;
+    private readonly passes;
+    private compiled;
+    /** Transient texture pool: keyed by descriptor, reused across compiles (D-2). */
+    private readonly transientPool;
+    /**
+     * Pending-destroy queue (bug-20260622): replaced textures awaiting GPU
+     * retirement before actual device.destroyTexture. drainTransient(),
+     * setTransientEntry(), and setPersistentEntry() push here instead of destroying immediately;
+     * reclaimRetiredTransients() (called post-queue.submit in recordFrame) drains
+     * the queue when the GPU signals onSubmittedWorkDone.
+     */
+    private readonly pendingDestroy;
+    /** Persistent textures: keyed by resource name, kept across compiles. */
+    private readonly persistentTextures;
+    /** Swap-chain size for resolving 'swapchain' / 'half-swapchain' sizes. */
+    private swapChainWidth;
+    private swapChainHeight;
+    /** Last compile-time swap-chain size; diff triggers recompile-invalidation. */
+    private compiledWidth;
+    private compiledHeight;
+    /**
+     * feat-20260612 M-4 / w15: device reference stashed at compile-time so
+     * drain() can release pooled textures via device.destroyTexture without
+     * a separate parameter. Set by compile(); null until the first compile.
+     * Render-graph stays RHI-pure (no runtime dep): the destroy bookkeeping
+     * SSOT is the RHI shim, exactly as GpuTexture.destroy() routes through it.
+     */
+    private lastDevice;
+    /**
+     * Set the current swap-chain dimensions (w7).
+     * The compile allocation phase uses this to resolve 'swapchain' and
+     * 'half-swapchain' size specifiers. Returns true when dimensions differ
+     * from the last compile, signalling that a recompile is needed.
+     */
+    setSwapChainSize(width: number, height: number): boolean;
+    /**
+     * w7: resolve a color-target name to its compiled TextureView.
+     * Returns the GPU view after compile, or undefined if not yet compiled
+     * or the name was not registered via addColorTarget.
+     */
+    getColorTargetView(name: string): unknown;
+    /**
+     * w7: resolve a color-target name to its compiled GPU Texture handle.
+     * Returns the texture after compile, or undefined if not yet compiled.
+     */
+    getColorTargetTexture(name: string): unknown;
+    getColorTargetDescriptor(name: string): ResolvedColorTargetDescriptor | undefined;
+    /**
+     * Declare a color target alias: both names share the same physical texture.
+     * The source must already be registered via addColorTarget.
+     * Used for hdrComposited -> hdrColor folding (KB-1 / D-2). The returned
+     * Result contains the opaque alias handle or a duplicate-resource error.
+     */
+    addColorTargetAlias(name: string, source: string): Result<ColorTargetHandle, RenderGraphError>;
+    addResource(key: string, descriptor: ResourceDescriptor): Result<ResourceEntry, RenderGraphError>;
+    /**
+     * Declare a color target resource that the compiler will allocate as a
+     * transient or persistent GPU texture (D-1 / D-8). A successful Result
+     * contains an opaque string handle that can be referenced in pass read/write
+     * arrays and resolved to a TextureView via resolve(name) inside a pass
+     * execute closure. A duplicate key is rejected before registry publication.
+     *
+     * Omitted lifetime preserves the default `transient`; `persistent` retains
+     * identity across unchanged compiles and replaces on descriptor drift.
+     * format/size/sample/usage are stored on the resource entry for the compile
+     * allocation phase (w6).
+     */
+    addColorTarget(name: string, desc: ColorTargetDescriptor): Result<ColorTargetHandle, RenderGraphError>;
+    addPass(name: string, descriptor: PassDescriptor<Ctx>): PassEntry<Ctx>;
+    /** @internal Renderer composition seam for declaring feature work at its semantic target. */
+    _addPassBefore(name: string, before: string, descriptor: PassDescriptor<Ctx>): PassEntry<Ctx>;
+    addComputePass(name: string, descriptor: ComputePassDescriptor<Ctx>): PassEntry<Ctx>;
+    /** @internal Renderer composition seam for declaring feature work at its semantic target. */
+    _addComputePassBefore(name: string, before: string, descriptor: ComputePassDescriptor<Ctx>): PassEntry<Ctx>;
+    private addComputePassAt;
+    /**
+     * Validate a producer-scoped current-frame texture without exposing graph
+     * resource names through the observation lease.
+     */
+    createCurrentFrameObservationLease(descriptor: CurrentFrameObservationDescriptor, currentFrameId: number): Result<CurrentFrameObservationLease, RenderGraphError>;
+    /**
+     * Compile the graph into an internalized form.
+     *
+     * Phases (plan-strategy 3.1):
+     * 1. Cap-gate fail-fast
+     * 2. Unknown-resource fail-fast (every pass read/write key is registered)
+     * 3. Dangling-read fail-fast
+     * 4. Preserve declaration order as the temporal authority
+     * 5. Buffer-role resolution (AC-09 / D-6.1)
+     * 6. GPU allocation for color targets (D-1) — when device is provided and the
+     *    graph has addColorTarget resources, allocate textures via
+     *    device.createTexture/createTextureView. Errors surface as
+     *    'resource-alloc-failed' or 'invalid-format'.
+     */
+    compile(opts: CompileOptions): Result<InternalizedGraph, RenderGraphError>;
+    /**
+     * feat-20260612 M-4 / w15: release every pooled GPU texture and clear
+     * the pools.
+     *
+     * Walks `transientPool` + `persistentTextures`, forwarding each
+     * `PooledTexture.texture` opaque handle to `device.destroyTexture(...)`,
+     * then clears both Maps. The destroy bookkeeping SSOT is the RHI shim
+     * (architecture-principles §1 SSOT: same path GpuTexture.destroy()
+     * uses); render-graph stays RHI-pure (no runtime dep).
+     *
+     * Plan-strategy D-7: drain covers the dispose exit path (`Renderer.dispose()`);
+     * descriptor-drift replacement during compile is fenced through
+     * `pendingDestroy` and `reclaimRetiredTransients()`.
+     *
+     * Idempotent (architecture-principles §6): a second drain on cleared
+     * Maps is a no-op. drain() before any compile is also a safe no-op.
+     * Per-handle errors from the RHI shim (e.g. 'destroy-after-destroy'
+     * on a stale handle) are tolerated so the dispose chain can make
+     * progress (mirrors gpuStore.destroyAll's swallow-and-continue
+     * policy; plan-strategy D-3 / D-8). The structured error stays
+     * available on the device handle for future inspector hooks.
+     */
+    drain(): void;
+    /**
+     * Relinquish every texture owned by this graph after its last frame has
+     * been submitted. Unlike {@link drain}, this does not synchronously destroy
+     * GPU resources: they join `pendingDestroy` and are released by
+     * `reclaimRetiredTransients()` only after `onSubmittedWorkDone` resolves.
+     *
+     * A retired graph is no longer executable. Runtime replaces a memoized
+     * per-frame graph through this entry when topology changes (rather than
+     * dropping the graph and its pools), while `drain()` remains the teardown
+     * path where immediate destruction is safe.
+     */
+    retire(): void;
+    /**
+     * Release every transient-pool texture while keeping persistentTextures
+     * intact (AC-09: resize drain, plan-strategy D-4).
+     *
+     * Walks `transientPool` values and forwards each `PooledTexture.texture`
+     * opaque handle to `device.destroyTexture(...)`, then clears the transient
+     * pool. Mirror of `drain()` but scoped to the transient pool only.
+     *
+     * Persistent textures survive `drainTransient` — they are only released by
+     * the full `drain()` on teardown. `drainTransient` is an internal helper
+     * called by `compile()` when swap-chain size changes; it is NOT a public API
+     * (callers should use `drain()` for teardown).
+     *
+     * Idempotent (architecture-principles §6): a second drainTransient on an
+     * already-cleared transient pool is a no-op.
+     */
+    private drainTransient;
+    /**
+     * Guarded transient pool insert (AC-08, plan-strategy D-4).
+     *
+     * Before overwriting a key in the transient pool, destroys the old pooled
+     * texture via `device.destroyTexture(...)` to prevent stranded GPU textures.
+     * The guard is defensive: in current production code flow this code path is
+     * unreachable (set() only follows a get() miss inside allocateColorTargets),
+     * but the single-line guard costs almost nothing and closes the symmetry gap
+     * (every GPU resource allocation has a paired destroy).
+     *
+     * When `lastDevice` is null (no device ever stashed), the old entry is
+     * silently dropped without destroy (mirrors drainTransient's null-device
+     * fast path).
+     */
+    private setTransientEntry;
+    /**
+     * Publish a persistent replacement only after a complete allocation succeeds.
+     * The old handle remains fenced until the GPU retires work that may still
+     * reference it, just like a transient replacement.
+     */
+    private setPersistentEntry;
+    /**
+     * bug-20260622 D-2: reclaim pool textures queued in pendingDestroy after
+     * the GPU has retired all prior command buffers.
+     *
+     * Takes a snapshot of pendingDestroy, then calls
+     * `lastDevice.queue.onSubmittedWorkDone()`. When the promise resolves,
+     * the snapshot items are actually destroyed via
+     * `device.destroyTexture(...)` and removed from the queue.
+     *
+     * Idempotent (architecture-principles D-4): a second reclaim on an
+     * already-drained pendingDestroy is a no-op. When lastDevice is null
+     * (no device ever stashed), pendingDestroy is cleared directly.
+     *
+     * Per-handle destroy errors are tolerated (swallow-and-continue,
+     * plan-strategy D-5) — a stale-handle destroy-after-destroy does not
+     * interrupt the reclaim chain.
+     */
+    reclaimRetiredTransients(): Promise<void>;
+    /**
+     * Drop the pendingDestroy queue WITHOUT calling device.destroyTexture
+     * (feat-20260622-s5 M3 / B-2 / B-AC-02).
+     *
+     * Used on the device-lost recover() rebuild path: the queue holds
+     * PooledTexture handles minted against the now-lost device, so calling
+     * destroyTexture on them against the freshly-rebuilt device is meaningless
+     * (the old GPUDevice owns them; spec retires its resources implicitly when
+     * it is lost). recover() calls this after `gpuStore.destroyAll()` and before
+     * `tryCreateWebGPURenderer` so no stale handle reaches the new device.
+     *
+     * device-lost is an upstream judgement (createRenderer's health state); the
+     * graph stays RHI-pure and takes no device parameter — it only exposes the
+     * clear entry. Same effect as the existing null-device fast paths in drain()
+     * / reclaimRetiredTransients() (`pendingDestroy.length = 0`), surfaced as a
+     * method recover() can call directly. Idempotent: a second call on an
+     * already-empty queue is a no-op.
+     */
+    clearPendingDestroy(): void;
+    /**
+     * Execute the compiled graph in declaration order, calling
+     * each pass's execute closure with the provided context. Passes without an
+     * execute closure are silently skipped.
+     */
+    execute(ctx: Ctx, runPass?: PassExecuteRunner): void;
+    listPasses(): readonly PassInfo[];
+    listResources(): readonly ResourceInfo[];
+    private validateCaps;
+    private validateColorDomains;
+    private validateNoUnknownResource;
+    /**
+     * Resolve every registered `kind:'buffer'` resource to a concrete RHI
+     * binding type (AC-09 / D-6.1). `bufferRole='auto-storage-or-uniform'`
+     * (the default when unset) picks `'read-only-storage'` when the backend
+     * advertises `caps.storageBuffer`, else falls back to `'uniform'`;
+     * `bufferRole='uniform'` is always `'uniform'`. Mirrors the runtime
+     * `pbr-pipeline.ts` cap switch (research Finding 7), expressed here in the
+     * RHI-pure graph layer so consumers never duplicate the branch.
+     */
+    private resolveBuffers;
+    private validateColorTargetFormats;
+    /**
+     * Phase 7: allocate GPU textures for registered color targets (D-1 / D-2).
+     *
+     * For each addColorTarget resource, resolves the concrete size from the
+     * ColorTargetSize descriptor and swapChainSize, then looks up the transient
+     * pool by descriptor key. Pool hit reuses the same physical texture/view;
+     * pool miss (drift) triggers device.createTexture/createTextureView rebuild.
+     *
+     * Alias targets (addColorTargetAlias) fold into the source's physical texture
+     * (KB-1 MoveNode pattern). Persistent targets are retained across compiles
+     * with size-drift rebuild.
+     *
+     * device === undefined is a no-op (returns an empty map).
+     * Allocation is transactional: newly created textures are destroyed on any
+     * failure, and pool mutations are committed only after every target succeeds.
+     */
+    private allocateColorTargets;
+    private resolveWidth;
+    private resolveHeight;
+    private validateNoDanglingRead;
+}
+//# sourceMappingURL=graph.d.ts.map

package/dist/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,OAAO,EACP,qBAAqB,IAAI,wBAAwB,EACjD,qBAAqB,EACrB,SAAS,EACT,OAAO,EACP,aAAa,EACb,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAML,gBAAgB,EAChB,KAAK,MAAM,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,iCAAiC,EACtC,KAAK,4BAA4B,EAElC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EAEtB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAK5D,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEhD,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,YAAY,CAAC;AAE1D,MAAM,MAAM,UAAU,GAAG,yBAAyB,GAAG,SAAS,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GACvB,WAAW,GACX,gBAAgB,GAChB;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/C;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,aAAa,EAAE,GAAG,SAAS,CAAC;IAC5D,wFAAwF;IACxF,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;CAChD;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAEvC;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,6FAA6F;IAC7F,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CAC7C;AAED,MAAM,WAAW,cAAc,CAAC,GAAG,GAAG,OAAO;IAC3C,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC,CAAC;IACxF,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,kFAAkF;IAClF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,qBAAqB,EAAE,GAAG,SAAS,CAAC;CAC1E;AAED,MAAM,WAAW,qBAAqB,CAAC,GAAG;IACxC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,wBAAwB,CAAC,GAAG,SAAS,CAAC;IACxE,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC3E,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACpD,MAAM,CAAC,OAAO,EAAE;QACd,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;QACrC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC;QACpB,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;KACpC,GAAG,IAAI,CAAC;CACV;AAED,mEAAmE;AACnE,MAAM,MAAM,iBAAiB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;AAI/E,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;CACrC;AAID,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,GAAG,SAAS,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;CACjD;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,SAAS,cAAc,EAAE,CAAC;IACpD;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CAC7D;AAID,MAAM,WAAW,cAAc;IAK7B,QAAQ,CAAC,WAAW,EAAE,QAAQ,GAAG,aAAa,GAAG,aAAa,GAAG,MAAM,CAAC;IACxE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CACzC;AAyJD,qBAAa,WAAW,CAAC,GAAG,GAAG,OAAO;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAkC;IAElD,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoC;IAClE;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuB;IACtD,yEAAyE;IACzE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAoC;IACvE,0EAA0E;IAC1E,OAAO,CAAC,cAAc,CAAO;IAC7B,OAAO,CAAC,eAAe,CAAO;IAC9B,+EAA+E;IAC/E,OAAO,CAAC,aAAa,CAAO;IAC5B,OAAO,CAAC,cAAc,CAAO;IAC7B;;;;;;OAMG;IACH,OAAO,CAAC,UAAU,CAA4B;IAE9C;;;;;OAKG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IASxD;;;;OAIG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIzC;;;OAGG;IACH,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI5C,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,6BAA6B,GAAG,SAAS;IAgBjF;;;;;OAKG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,iBAAiB,EAAE,gBAAgB,CAAC;IAM9F,WAAW,CACT,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,kBAAkB,GAC7B,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC;IAI1C;;;;;;;;;;;OAWG;IACH,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,qBAAqB,GAC1B,MAAM,CAAC,iBAAiB,EAAE,gBAAgB,CAAC;IAM9C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC;IAItE,6FAA6F;IAC7F,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC;IAI7F,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,qBAAqB,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC;IAIpF,6FAA6F;IAC7F,qBAAqB,CACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,qBAAqB,CAAC,GAAG,CAAC,GACrC,SAAS,CAAC,GAAG,CAAC;IAIjB,OAAO,CAAC,gBAAgB;IAyCxB;;;OAGG;IACH,kCAAkC,CAChC,UAAU,EAAE,iCAAiC,EAC7C,cAAc,EAAE,MAAM,GACrB,MAAM,CAAC,4BAA4B,EAAE,gBAAgB,CAAC;IAIzD;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAAC,iBAAiB,EAAE,gBAAgB,CAAC;IA8D1E;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,KAAK,IAAI,IAAI;IAuCb;;;;;;;;;;OAUG;IACH,MAAM,IAAI,IAAI;IAoBd;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,cAAc;IAetB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;;;;;;;;;;;;;;;OAgBG;IACG,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B/C;;;;;;;;;;;;;;;;;OAiBG;IACH,mBAAmB,IAAI,IAAI;IAI3B;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI;IAwBpD,UAAU,IAAI,SAAS,QAAQ,EAAE;IAQjC,aAAa,IAAI,SAAS,YAAY,EAAE;IAcxC,OAAO,CAAC,YAAY;IAmCpB,OAAO,CAAC,oBAAoB;IAkB5B,OAAO,CAAC,yBAAyB;IAkCjC;;;;;;;;OAQG;IACH,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,0BAA0B;IAqBlC;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,oBAAoB;IA0K5B,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,sBAAsB;CAyB/B"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { RenderGraphBuilder } from './builder.js';
+export { err, type InvalidFormatDetail, ok, RenderGraphError, type RenderGraphErrorCode, type RenderGraphErrorDetail, type ResourceAllocFailedDetail, type Result, type ResultErr, type ResultOk, } from './errors.js';
+export type { BufferRole, ColorTargetDescriptor, ColorTargetHandle, ColorTargetSize, CompileOptions, ComputePassDescriptor, InternalizedGraph, InternalizedPass, PassDescriptor, PassInfo, ResolveContext, ResolvedBuffer, ResolvedBufferType, ResolvedColorTargetDescriptor, ResourceDescriptor, ResourceInfo, ResourceKind, ResourceLifetime, } from './graph.js';
+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, 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';
+//# 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":"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,yBAAyB,EAC9B,KAAK,MAAM,EACX,KAAK,SAAS,EACd,KAAK,QAAQ,GACd,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,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"}