@forgeax/engine-render 0.1.7 → 0.1.20

package/dist/temporal/transaction.d.ts

@@ -0,0 +1,9 @@
+import { type RendererFrameTransaction } from '../assembly/renderer-frame-transaction';
+import type { TemporalHistory } from './history';
+import type { TemporalView } from './view';
+export interface TemporalFrameCandidate {
+    readonly view: TemporalView;
+    readonly history: TemporalHistory;
+}
+export declare function stageTemporalFrame(candidate: TemporalFrameCandidate): RendererFrameTransaction<TemporalFrameCandidate>;
+//# sourceMappingURL=transaction.d.ts.map

package/dist/temporal/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../src/temporal/transaction.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,wBAAwB,EAE9B,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAE3C,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;CACnC;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,sBAAsB,GAChC,wBAAwB,CAAC,sBAAsB,CAAC,CAElD"}

package/dist/temporal/view.d.ts

@@ -0,0 +1,56 @@
+import type { Antialias } from '../components/camera';
+export declare const HALTON_23_8: readonly [readonly number[], readonly number[], readonly number[], readonly number[], readonly number[], readonly number[], readonly number[], readonly number[]];
+export type TemporalResetReason = 'first-frame' | 'resize' | 'camera-cut' | 'history-version' | 'view-switch' | 'environment-change' | 'fog-change' | 'device-recover' | 'submit-failure';
+export interface TemporalViewInput {
+    readonly antialias: Antialias;
+    readonly width: number;
+    readonly height: number;
+    readonly frameIndex?: number;
+    readonly historyVersion?: number;
+    readonly viewIdentity?: string;
+    readonly environmentSignature?: string;
+    readonly fogSignature?: string;
+    readonly deviceGeneration?: number;
+    readonly cameraCut?: boolean;
+    readonly historyValid?: boolean;
+    readonly currentUnjitteredViewProjection?: ArrayLike<number> | undefined;
+    readonly previousUnjitteredViewProjection?: ArrayLike<number> | undefined;
+    readonly resetReason?: TemporalResetReason | undefined;
+}
+interface TemporalViewSnapshot {
+    readonly antialias: Antialias;
+    readonly width: number;
+    readonly height: number;
+    readonly frameIndex: number;
+    readonly historyVersion: number;
+    readonly viewIdentity: string;
+    readonly environmentSignature: string;
+    readonly fogSignature: string;
+    readonly deviceGeneration: number;
+    readonly cameraCut: boolean;
+    readonly historyValid: boolean;
+    readonly currentUnjitteredViewProjection: ArrayLike<number> | undefined;
+    readonly previousUnjitteredViewProjection: ArrayLike<number> | undefined;
+    readonly resetReason: TemporalResetReason | undefined;
+}
+export interface TemporalView {
+    readonly input: Readonly<TemporalViewSnapshot>;
+    readonly historyVersion: number;
+    readonly mode: 'off' | 'taa';
+    readonly jitter: readonly [number, number] | undefined;
+    readonly jitterCancellationUv: readonly [number, number] | undefined;
+    readonly currentJitterUv: readonly [number, number] | undefined;
+    readonly historyValid: boolean;
+    readonly temporalFrameIndex: number;
+    /** Unjittered matrices are supplied by the renderer projection owner. */
+    readonly currentUnjitteredViewProjection: ArrayLike<number> | undefined;
+    readonly previousUnjitteredViewProjection: ArrayLike<number> | undefined;
+    readonly currentProjection: 'jittered' | 'unjittered';
+    readonly previousProjection: 'unjittered';
+    readonly historyRequired: boolean;
+    readonly resetReason: TemporalResetReason | undefined;
+}
+export declare function createTemporalView(input: TemporalViewInput): TemporalView;
+export declare function resolveTemporalReset(previous: TemporalView | undefined, next: TemporalView): TemporalResetReason | undefined;
+export {};
+//# sourceMappingURL=view.d.ts.map

package/dist/temporal/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../src/temporal/view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAItD,eAAO,MAAM,WAAW,mKASb,CAAC;AAEZ,MAAM,MAAM,mBAAmB,GAC3B,aAAa,GACb,QAAQ,GACR,YAAY,GACZ,iBAAiB,GACjB,aAAa,GACb,oBAAoB,GACpB,YAAY,GACZ,gBAAgB,GAChB,gBAAgB,CAAC;AAErB,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,+BAA+B,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACzE,QAAQ,CAAC,gCAAgC,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAC1E,QAAQ,CAAC,WAAW,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;CACxD;AAED,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,+BAA+B,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACxE,QAAQ,CAAC,gCAAgC,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACzE,QAAQ,CAAC,WAAW,EAAE,mBAAmB,GAAG,SAAS,CAAC;CACvD;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IAC/C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,oBAAoB,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACrE,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAChE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,yEAAyE;IACzE,QAAQ,CAAC,+BAA+B,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACxE,QAAQ,CAAC,gCAAgC,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACzE,QAAQ,CAAC,iBAAiB,EAAE,UAAU,GAAG,YAAY,CAAC;IACtD,QAAQ,CAAC,kBAAkB,EAAE,YAAY,CAAC;IAC1C,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,mBAAmB,GAAG,SAAS,CAAC;CACvD;AASD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CAyDzE;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,YAAY,GAAG,SAAS,EAClC,IAAI,EAAE,YAAY,GACjB,mBAAmB,GAAG,SAAS,CAajC"}

package/dist/transmission/backdrop.d.ts

@@ -0,0 +1,147 @@
+import { type GraphResourceResolver, type GraphTextureView, type RenderGraphBuilder, RenderGraphError } from '@forgeax/engine-render-graph';
+import type { RhiDevice, RhiRenderPassEncoder } from '@forgeax/engine-rhi';
+import { type Result } from '@forgeax/engine-types';
+import type { RenderPipelineFrame, RenderPipelineTarget, RenderPipelineTopology } from '../render-pipeline';
+import type { TransmissionDemand } from './projection';
+export declare const TRANSMISSION_BACKDROP_PHASES: readonly ["opaque-resolve", "transmission-backdrop-copy", "transmission-backdrop-mip", "transmission-forward", "transparent", "temporal"];
+export type TransmissionBackdropPhase = (typeof TRANSMISSION_BACKDROP_PHASES)[number];
+export declare function transmissionDemandForTopology(topology: RenderPipelineTopology): TransmissionDemand;
+export interface TransmissionBackdropTopologyInput {
+    readonly demand: TransmissionDemand;
+    readonly sourceSampleCount: 1 | 4;
+}
+export interface TransmissionBackdropTopology {
+    readonly active: boolean;
+    readonly sourceSampleCount: 1 | 4;
+    readonly copyCount: number;
+    readonly mipCount: number;
+    readonly submitCount: 1;
+    readonly aliasCount: 0;
+    readonly phases: readonly TransmissionBackdropPhase[];
+}
+export declare function resolveTransmissionBackdropTopology(input: TransmissionBackdropTopologyInput): TransmissionBackdropTopology;
+export interface TransmissionCapabilityFacts {
+    readonly format: string;
+    readonly renderAttachment: boolean;
+    readonly copySrc: boolean;
+    readonly textureBinding: boolean;
+    readonly mipView: boolean;
+    readonly filteringSampler: boolean;
+    readonly bindGroupLayout: boolean;
+    readonly msaaResolve: boolean;
+    readonly resourceCreation: boolean;
+    /** Accepted as diagnostic input only; it never changes the verdict. */
+    readonly backendKind?: string | undefined;
+}
+export type TransmissionCapabilityFact = 'format' | 'renderAttachment' | 'copySrc' | 'textureBinding' | 'mipView' | 'filteringSampler' | 'bindGroupLayout' | 'msaaResolve' | 'resourceCreation';
+/** Probe the complete backdrop descriptor once per device generation. */
+export declare function probeTransmissionCapability(device: RhiDevice): TransmissionCapabilityFacts;
+export type TransmissionCapabilityVerdict = {
+    readonly ok: true;
+    readonly missing: readonly [];
+} | {
+    readonly ok: false;
+    readonly missing: readonly TransmissionCapabilityFact[];
+};
+export declare function evaluateTransmissionCapability(facts: TransmissionCapabilityFacts): TransmissionCapabilityVerdict;
+export type TransmissionAdmissionResult = {
+    readonly ok: true;
+    readonly published: true;
+    readonly generation: number;
+    readonly demand: TransmissionDemand;
+} | {
+    readonly ok: false;
+    readonly published: false;
+    readonly generation: number;
+    readonly demand: TransmissionDemand;
+    readonly missing: readonly TransmissionCapabilityFact[];
+};
+export interface TransmissionBackdropExtent {
+    readonly width: number;
+    readonly height: number;
+}
+/** Detached physical facts committed with a backdrop candidate. */
+export interface TransmissionBackdropResourceFacts {
+    readonly extent: TransmissionBackdropExtent;
+    readonly format: string;
+    /** Total resident mip levels, including level zero. */
+    readonly mipCount: number;
+    readonly bytes: number;
+    readonly deviceGeneration: number;
+}
+export type TransmissionLifecycleState = 'inactive' | 'resident' | 'recovering' | 'device-lost' | 'failed';
+export type TransmissionRecoveryState = 'idle' | 'compatible-lkg' | 'rebuild-required' | 'recovered' | 'failed';
+export interface TransmissionCandidateAdmissionInspection {
+    readonly generation: number;
+    readonly demand: TransmissionDemand;
+    readonly capability: TransmissionCapabilityVerdict;
+    readonly lifecycle: TransmissionLifecycleState;
+    readonly lastKnownGood: boolean;
+    readonly recovery: TransmissionRecoveryState;
+    readonly resource?: TransmissionBackdropResourceFacts;
+}
+/** Candidate/LKG fence for the private backdrop topology. */
+export declare class TransmissionCandidateAdmission {
+    private generation;
+    private demand;
+    private capability;
+    private lifecycle;
+    private lastKnownGood;
+    private recovery;
+    private resource;
+    admit(demand: TransmissionDemand, facts: TransmissionCapabilityFacts, resource?: TransmissionBackdropResourceFacts): TransmissionAdmissionResult;
+    inspect(): {
+        readonly generation: number;
+        readonly demand: TransmissionDemand;
+    };
+    /**
+     * Drop physical resource identity after device loss without dropping the
+     * persistent material demand. The next successful admission must publish a
+     * replacement resource before it can become the LKG.
+     */
+    markDeviceLost(): void;
+    markRecoveryStarted(): void;
+    inspectLifecycle(): TransmissionCandidateAdmissionInspection;
+}
+export interface TransmissionBackdropGraphInput {
+    readonly graph: RenderGraphBuilder<RenderPipelineFrame>;
+    /** The resolved single-sample source; MSAA source is never copied directly. */
+    readonly source: RenderPipelineTarget;
+    readonly demand: TransmissionDemand;
+    readonly copySize: {
+        readonly width: number;
+        readonly height: number;
+    };
+    /**
+     * Renderer-owned fullscreen/downsample record path for rough mips. The
+     * callback must bind the existing cached sampler/pipeline and draw into the
+     * supplied destination view on the graph-owned render pass.
+     */
+    readonly encodeRoughMip?: TransmissionBackdropMipEncoder | undefined;
+    /** Production callers install typed scene consumers after the copy/mip chain. */
+    readonly includeConsumerPasses?: boolean;
+}
+export interface TransmissionBackdropMipEncoderContext {
+    readonly pass: RhiRenderPassEncoder;
+    readonly frame: RenderPipelineFrame;
+    readonly resources: GraphResourceResolver;
+    readonly source: GraphTextureView;
+    readonly destination: GraphTextureView;
+    readonly level: number;
+}
+/** Existing fullscreen/downsample owner injected by the renderer assembly. */
+export type TransmissionBackdropMipEncoder = (context: TransmissionBackdropMipEncoderContext) => void;
+export interface TransmissionBackdropGraph {
+    readonly topology: TransmissionBackdropTopology;
+    readonly backdrop: RenderPipelineTarget | undefined;
+    readonly mipViews: readonly GraphTextureView[];
+}
+/**
+ * Adds the private backdrop and its ordered consumers to the caller's graph.
+ * The returned target stays inside the Standard pipeline owner; no public
+ * render-target or per-object copy is created.
+ */
+export declare function addTransmissionBackdropPasses(input: TransmissionBackdropGraphInput): Result<TransmissionBackdropGraph, RenderGraphError>;
+/** Adds the final ordering marker after typed transmission and transparent draws. */
+export declare function addTransmissionBackdropTemporalPass(graph: RenderGraphBuilder<RenderPipelineFrame>, source: RenderPipelineTarget): Result<void, RenderGraphError>;
+//# sourceMappingURL=backdrop.d.ts.map

package/dist/transmission/backdrop.d.ts.map

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

package/dist/transmission/inspection.d.ts

@@ -0,0 +1,57 @@
+import type { TransmissionBackdropExtent, TransmissionBackdropTopology, TransmissionCandidateAdmissionInspection, TransmissionCapabilityVerdict, TransmissionLifecycleState, TransmissionRecoveryState } from './backdrop';
+import type { TransmissionDemand } from './projection';
+export type { TransmissionBackdropExtent, TransmissionCandidateAdmissionInspection, TransmissionLifecycleState, TransmissionRecoveryState, } from './backdrop';
+export interface TransmissionInspection {
+    readonly activeCount: number;
+    readonly needsRoughMips: boolean;
+    readonly extent: TransmissionBackdropExtent;
+    readonly format: string;
+    /** Total resident mip levels, including level zero. */
+    readonly mipCount: number;
+    readonly bytes: number;
+    readonly copyCount: number;
+    readonly transmissionDrawCount: number;
+    readonly fallbackCount: number;
+    readonly generation: number;
+    readonly singleLayer: true;
+    readonly lifecycle: TransmissionLifecycleState;
+    readonly lastKnownGood: boolean;
+    readonly recovery: TransmissionRecoveryState;
+    readonly capability: TransmissionCapabilityVerdict;
+}
+export interface TransmissionInspectionInput {
+    readonly demand: TransmissionDemand;
+    readonly topology: Pick<TransmissionBackdropTopology, 'active' | 'copyCount' | 'mipCount'>;
+    readonly extent: TransmissionBackdropExtent;
+    readonly generation: number;
+    readonly lastKnownGood: boolean;
+    readonly recovery: TransmissionRecoveryState;
+    readonly lifecycle?: TransmissionLifecycleState;
+    /** Whether a committed physical backdrop is resident on the active device. */
+    readonly resourcePresent?: boolean;
+    readonly format?: string;
+    /** Override only when the resource receipt reports the actual total. */
+    readonly mipCount?: number;
+    /** Override only when the resource receipt reports the actual allocation. */
+    readonly bytes?: number;
+    readonly transmissionDrawCount?: number;
+    readonly fallbackCount?: number;
+    readonly capability?: TransmissionCapabilityVerdict;
+}
+export interface TransmissionInspectionFromAdmissionInput {
+    readonly admission: TransmissionCandidateAdmissionInspection;
+    readonly topology: TransmissionInspectionInput['topology'];
+    readonly extent: TransmissionBackdropExtent;
+    readonly transmissionDrawCount?: number;
+    readonly fallbackCount?: number;
+}
+export declare function estimateTransmissionBackdropBytes(extent: TransmissionBackdropExtent, mipCount: number, format?: string): number;
+/**
+ * Project the last completed backdrop facts into a detached, stable POD.
+ * Demand and copy/mip topology are read from their existing owners; this
+ * function never accepts a texture, view, encoder, queue, or graph handle.
+ */
+export declare function inspectTransmission(input: TransmissionInspectionInput): TransmissionInspection;
+export declare function inspectTransmissionFromAdmission(input: TransmissionInspectionFromAdmissionInput): TransmissionInspection;
+export declare function transmissionInspectionToJson(inspection: TransmissionInspection): string;
+//# sourceMappingURL=inspection.d.ts.map

package/dist/transmission/inspection.d.ts.map

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

package/dist/transmission/oracle.d.ts

@@ -0,0 +1,42 @@
+/** Pure CPU expectations for transmission math; this module has no GPU ownership. */
+export type Color3 = readonly [number, number, number];
+export type Uv2 = readonly [number, number];
+export declare const DEFAULT_IOR = 1.5;
+export declare const DEFAULT_GUARD_BAND = 0.02;
+export interface TransmissionEnergy {
+    readonly reflection: number;
+    readonly transmission: number;
+    readonly diffuse: number;
+    readonly metallicResidual: number;
+}
+export interface BackdropResolution {
+    readonly source: 'refracted' | 'environment' | 'unrefracted';
+    readonly color: Color3;
+}
+export interface BackdropInputs {
+    readonly uv: Uv2;
+    readonly refracted?: Color3;
+    readonly environment?: Color3;
+    readonly unrefracted: Color3;
+    readonly guardBand?: number;
+}
+/** Returns dielectric F0 for air to a material with the supplied IOR. */
+export declare function fresnelF0(ior: number): number;
+/**
+ * Returns unpolarized dielectric reflectance. `eta` is incident IOR divided
+ * by transmitted IOR, so values above one can produce total internal
+ * reflection. This is a CPU oracle only; it does not sample a GPU resource.
+ */
+export declare function fresnelReflectance(cosTheta: number, eta: number): number;
+export declare function splitTransmissionEnergy(input: {
+    readonly transmission: number;
+    readonly metallic: number;
+    readonly cosTheta: number;
+    readonly ior: number;
+}): TransmissionEnergy;
+export declare function beerLambertAttenuation(color: Color3, thickness: number, distance?: number): Color3;
+export declare function roughnessToLod(roughness: number, maxLod: number): number;
+export declare function isWithinGuardBand(uv: Uv2, guardBand?: number): boolean;
+export declare function resolveRefractionBackdrop(input: BackdropInputs): BackdropResolution;
+export declare function isFiniteColor(color: Color3): boolean;
+//# sourceMappingURL=oracle.d.ts.map

package/dist/transmission/oracle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle.d.ts","sourceRoot":"","sources":["../../src/transmission/oracle.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,MAAM,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACvD,MAAM,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE5C,eAAO,MAAM,WAAW,MAAM,CAAC;AAC/B,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa,GAAG,aAAa,CAAC;IAC7D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC;IACjB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAYD,yEAAyE;AACzE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAexE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,GAAG,kBAAkB,CAarB;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAiBR;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIxE;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,SAAqB,GAAG,OAAO,CAIlF;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,cAAc,GAAG,kBAAkB,CAenF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD"}

package/dist/transmission/projection.d.ts

@@ -0,0 +1,37 @@
+/** The two CPU facts that are allowed to influence transmission topology. */
+export interface TransmissionDemand {
+    readonly activeCount: number;
+    readonly needsRoughMips: boolean;
+}
+/** Detached material facts supplied by the persistent render-scene owner. */
+export interface TransmissionDemandCandidate {
+    readonly attached: boolean;
+    readonly ready: boolean;
+    readonly transmission: number;
+    readonly roughness: number;
+}
+export type TransmissionDemandOperation = {
+    readonly kind: 'upsert';
+    readonly key: string;
+    readonly candidate: TransmissionDemandCandidate;
+} | {
+    readonly kind: 'remove';
+    readonly key: string;
+};
+/**
+ * Incremental CPU projection for transmission topology.
+ *
+ * The projection stores no material, visibility, camera, or GPU object. Each
+ * operation updates the two counters directly; an empty operation list is a
+ * no-scan steady-state frame.
+ */
+export declare class PersistentTransmissionDemandProjection {
+    private readonly records;
+    private activeCount;
+    private roughCount;
+    apply(operations: readonly TransmissionDemandOperation[]): TransmissionDemand;
+    inspect(): TransmissionDemand;
+    private addCounts;
+    private removeCounts;
+}
+//# sourceMappingURL=projection.d.ts.map

package/dist/transmission/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../src/transmission/projection.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAED,6EAA6E;AAC7E,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,2BAA2B,GACnC;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,2BAA2B,CAAC;CACjD,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAmBtD;;;;;;GAMG;AACH,qBAAa,sCAAsC;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAC9D,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,UAAU,CAAK;IAEvB,KAAK,CAAC,UAAU,EAAE,SAAS,2BAA2B,EAAE,GAAG,kBAAkB;IAe7E,OAAO,IAAI,kBAAkB;IAO7B,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,YAAY;CAIrB"}

package/dist/typed-render-graph-primitives.d.ts

@@ -1,4 +1,4 @@
-import type { GraphAccess, RenderGraphBuilder, RenderGraphError } from '@forgeax/engine-render-graph';
+import type { GraphAccess, GraphTextureView, RenderGraphBuilder, RenderGraphError } from '@forgeax/engine-render-graph';
 import { type PassKind, type PassSelector, type Result } from '@forgeax/engine-types';
 import type { RenderPipelineFrame, RenderPipelineGpuDrivenProjection } from './render-pipeline';
 import { type RenderPipelineTarget } from './render-pipeline';
@@ -19,6 +19,8 @@ export interface TypedScenePassOptions {
     readonly clearColor?: readonly [number, number, number, number] | undefined;
     readonly colorLoadOp?: GPULoadOp | undefined;
     readonly depthLoadOp?: GPULoadOp | undefined;
+    readonly recordMode?: 'opaque' | 'transmission' | 'transparent' | undefined;
+    readonly transmissionBackdrop?: GraphTextureView | undefined;
     readonly extraAccesses?: readonly GraphAccess[] | undefined;
     readonly gpuDriven?: RenderPipelineGpuDrivenProjection | undefined;
 }
@@ -31,6 +33,13 @@ export interface TypedBloomTargets {
     readonly blurH: RenderPipelineTarget;
     readonly blurV: RenderPipelineTarget;
 }
+/** The semantic Bloom pass owner; graph inspection consumes these same identities. */
+export declare const TYPED_BLOOM_PASS_NAMES: {
+    readonly bright: "bloom-bright";
+    readonly blurH: "bloom-blur-h";
+    readonly blurV: "bloom-blur-v";
+    readonly composite: "bloom-composite";
+};
 export declare function addTypedBloomPasses(graph: RenderGraphBuilder<RenderPipelineFrame>, targets: TypedBloomTargets): Result<void, RenderGraphError>;
 export interface TypedSsaoTargets {
     readonly normal: RenderPipelineTarget;
@@ -47,11 +56,30 @@ export interface TypedFullscreenPassOptions {
     readonly outputOnly?: boolean | undefined;
     readonly rawSwapchainOutput?: boolean | undefined;
     readonly depth?: RenderPipelineTarget | undefined;
+    readonly additionalReads?: readonly {
+        readonly key: string;
+        readonly target: RenderPipelineTarget;
+    }[];
+    /** Optional per-pass copy of the params UBO payload. */
+    readonly paramsTransform?: ((params: Uint8Array | undefined) => Uint8Array | undefined) | undefined;
 }
+export interface TypedTemporalResolveTargets {
+    readonly scene: RenderPipelineTarget;
+    readonly currentTemporal: RenderPipelineTarget;
+    readonly depth: RenderPipelineTarget;
+    readonly historyColor: RenderPipelineTarget;
+    readonly historyTemporal: RenderPipelineTarget;
+    readonly writeColor: RenderPipelineTarget;
+    readonly writeTemporal: RenderPipelineTarget;
+}
+export declare function addTypedTemporalResolvePass(graph: RenderGraphBuilder<RenderPipelineFrame>, targets: TypedTemporalResolveTargets): Result<void, RenderGraphError>;
 export declare function addTypedFullscreenPass(graph: RenderGraphBuilder<RenderPipelineFrame>, options: TypedFullscreenPassOptions): Result<void, RenderGraphError>;
 export declare function addTypedCompositePostEffects(graph: RenderGraphBuilder<RenderPipelineFrame>, effects: readonly string[], input: RenderPipelineTarget, output: RenderPipelineTarget, depth: RenderPipelineTarget, size: {
     readonly width: number;
     readonly height: number;
 }): Result<void, RenderGraphError>;
-export declare function addTypedTonemapPass(graph: RenderGraphBuilder<RenderPipelineFrame>, input: RenderPipelineTarget, output: RenderPipelineTarget, outputOnly?: boolean): Result<void, RenderGraphError>;
+export declare function addTypedOutputTransformPass(graph: RenderGraphBuilder<RenderPipelineFrame>, input: RenderPipelineTarget, output: RenderPipelineTarget, options?: {
+    readonly outputOnly?: boolean;
+    readonly outputTransform?: boolean;
+}): Result<void, RenderGraphError>;
 //# sourceMappingURL=typed-render-graph-primitives.d.ts.map

package/dist/typed-render-graph-primitives.d.ts.map

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

package/dist/typed-shadow-atlas.d.ts

@@ -0,0 +1,10 @@
+export interface DirectionalShadowAtlasGrid {
+    readonly columns: 1 | 2;
+    readonly rows: 1 | 2;
+}
+/**
+ * The directional CSM atlas layout is one compact contract for raster writes
+ * and shader reads: 1 -> 1x1, 2 -> 2x1, and 3/4 -> 2x2.
+ */
+export declare function resolveDirectionalShadowAtlasGrid(cascadeCount: number): DirectionalShadowAtlasGrid;
+//# sourceMappingURL=typed-shadow-atlas.d.ts.map

package/dist/typed-shadow-atlas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-shadow-atlas.d.ts","sourceRoot":"","sources":["../src/typed-shadow-atlas.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,YAAY,EAAE,MAAM,GACnB,0BAA0B,CAK5B"}

package/dist/typed-shadow-passes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typed-shadow-passes.d.ts","sourceRoot":"","sources":["../src/typed-shadow-passes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAM,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AASxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,EAA8B,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE1F,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;CACnD;AAwBD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,EAC9C,QAAQ,EAAE,sBAAsB,GAC/B,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAwH9C"}
+{"version":3,"file":"typed-shadow-passes.d.ts","sourceRoot":"","sources":["../src/typed-shadow-passes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAM,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AASxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,EAA8B,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAG1F,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;CACnD;AAwBD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,EAC9C,QAAQ,EAAE,sBAAsB,GAC/B,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAwH9C"}

package/dist/volume/capability.d.ts

@@ -0,0 +1,57 @@
+import { type EntityHandle, type World } from '@forgeax/engine-ecs';
+import type { RhiCaps } from '@forgeax/engine-rhi';
+/**
+ * The single capability predicate for the authored volumetric-fog producer.
+ * Shader sources are part of the device-bound bundle: compute/storage alone
+ * is not enough to claim that the three fused graph passes can execute.
+ */
+export declare function hasVolumetricFogCapability(caps: Pick<RhiCaps, 'compute' | 'storageTexture'>, shaders: unknown): boolean;
+export type VolumetricFogLightKind = 'directional' | 'point' | 'spot';
+export type VolumetricFogLightResolution = {
+    readonly status: 'available';
+    readonly entity: EntityHandle;
+    readonly kind: VolumetricFogLightKind;
+} | {
+    readonly status: 'unresolved';
+    readonly reason: 'missing-entity' | 'wrong-component' | 'ambiguous';
+    readonly entity: EntityHandle;
+    readonly expected: 'DirectionalLight | PointLight | SpotLight';
+    readonly actual: string;
+    readonly hint: string;
+};
+export type VolumetricFogLightPairResolution = {
+    readonly status: 'available';
+    readonly mode: 'point-spot';
+    readonly point: EntityHandle;
+    readonly spot: EntityHandle;
+} | {
+    readonly status: 'unresolved';
+    readonly reason: 'missing-entity' | 'same-entity' | 'wrong-component';
+    readonly point: EntityHandle;
+    readonly spot: EntityHandle;
+    readonly expected: 'PointLight + SpotLight in the same World';
+    readonly actual: string;
+    readonly hint: string;
+};
+/** Resolve the narrow official Point+Spot pair without creating a light owner. */
+export declare function resolveVolumetricFogLightPair(world: World, point: EntityHandle, spot: EntityHandle): VolumetricFogLightPairResolution;
+/**
+ * Resolve the required VolumetricFog.light reference in its owning World.
+ * PointLight is a valid primary selection for the exact Point+Spot pair.
+ * EntityHandle has no portable world tag, so a handle absent from this World
+ * (the same World contract) is reported as missing-entity;
+ * is reported as missing-entity; callers must not manufacture a light.
+ */
+export declare function resolveSelectedVolumetricLight(world: World, entity: EntityHandle): VolumetricFogLightResolution;
+export interface IntegratedVolumeResource {
+    /** Logical resolved-volume identity; this is not a physical graph resource. */
+    readonly identity: 'volume-integrated';
+    readonly format: 'rgba16float';
+    readonly stage: 'resolved';
+}
+export type VolumeConsumer = 'opaque' | 'transparent' | 'sprite' | 'vfx' | 'custom';
+export declare function resolveIntegratedVolumeConsumer(resource: IntegratedVolumeResource, consumer: VolumeConsumer): {
+    readonly consumer: VolumeConsumer;
+    readonly resource: IntegratedVolumeResource;
+};
+//# sourceMappingURL=capability.d.ts.map

package/dist/volume/capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../../src/volume/capability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,YAAY,EAAE,KAAK,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAMnD;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,gBAAgB,CAAC,EACjD,OAAO,EAAE,OAAO,GACf,OAAO,CAET;AAED,MAAM,MAAM,sBAAsB,GAAG,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;AAGtE,MAAM,MAAM,4BAA4B,GACpC;IACE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;CACvC,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,iBAAiB,GAAG,WAAW,CAAC;IACpE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,2CAA2C,CAAC;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEN,MAAM,MAAM,gCAAgC,GACxC;IACE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;CAC7B,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,aAAa,GAAG,iBAAiB,CAAC;IACtE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,0CAA0C,CAAC;IAC9D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEN,kFAAkF;AAClF,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,YAAY,GACjB,gCAAgC,CAsClC;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,YAAY,GACnB,4BAA4B,CA4C9B;AAED,MAAM,WAAW,wBAAwB;IACvC,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,aAAa,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEpF,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,wBAAwB,EAClC,QAAQ,EAAE,cAAc,GACvB;IAAE,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAA;CAAE,CAKpF"}

package/dist/volume/component.d.ts

@@ -0,0 +1,61 @@
+import { type EntityHandle } from '@forgeax/engine-ecs';
+import { type Result } from '@forgeax/engine-types';
+import { type VolumeError } from '../errors/render';
+export interface VolumeDensityBinding {
+    readonly guid: string;
+    readonly generation: number;
+    readonly shape: {
+        readonly viewDimension: '2d' | '2d-array' | '3d';
+        readonly extent: {
+            readonly width: number;
+            readonly height: number;
+            readonly depth?: number;
+            readonly layers?: number;
+        };
+    };
+    readonly format: string;
+    readonly colorSpace?: 'linear' | 'srgb';
+}
+export interface VolumeBounds {
+    readonly min: readonly [number, number, number];
+    readonly max: readonly [number, number, number];
+}
+export interface VolumetricFogAuthoring {
+    /** Invalid authoring reports closed code, expected, hint, and detail fields. */
+    /** The selected DirectionalLight or PointLight in this World. */
+    readonly light: EntityHandle;
+    /** The optional same-World SpotLight paired with a PointLight. */
+    readonly spotLight?: EntityHandle;
+    readonly density: VolumeDensityBinding;
+    readonly bounds: VolumeBounds;
+    readonly extinction: readonly [number, number, number];
+    readonly albedo: readonly [number, number, number];
+    readonly emission: readonly [number, number, number];
+    readonly anisotropy: number;
+    readonly maxDistance: number;
+    readonly ownerCount?: number;
+}
+export type VolumetricFogLightSelection = {
+    readonly light: EntityHandle;
+    readonly spotLight?: undefined;
+} | {
+    readonly light: EntityHandle;
+    readonly spotLight: EntityHandle;
+};
+export interface ValidatedVolumetricFog extends VolumetricFogAuthoring {
+    readonly ownerCount: 1;
+}
+export declare const VolumetricFog: import("@forgeax/engine-ecs").Component<"VolumetricFog", {
+    readonly light: "entity";
+    readonly spotLight: "entity";
+    readonly density: "shared<TextureAsset>";
+    readonly boundsMin: "array<f32, 3>";
+    readonly boundsMax: "array<f32, 3>";
+    readonly extinction: "array<f32, 3>";
+    readonly albedo: "array<f32, 3>";
+    readonly emission: "array<f32, 3>";
+    readonly anisotropy: "f32";
+    readonly maxDistance: "f32";
+}>;
+export declare function validateVolumetricFog(input: VolumetricFogAuthoring): Result<ValidatedVolumetricFog, VolumeError>;
+//# sourceMappingURL=component.d.ts.map

package/dist/volume/component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../src/volume/component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAEL,KAAK,WAAW,EAIjB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,aAAa,EAAE,IAAI,GAAG,UAAU,GAAG,IAAI,CAAC;QACjD,QAAQ,CAAC,MAAM,EAAE;YACf,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;YACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;SAC1B,CAAC;KACH,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;CACzC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,sBAAsB;IACrC,gFAAgF;IAChF,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvD,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,MAAM,2BAA2B,GACnC;IAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,GAChE;IAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAA;CAAE,CAAC;AAEvE,MAAM,WAAW,sBAAuB,SAAQ,sBAAsB;IACpE,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;CACxB;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;EAWxB,CAAC;AAmBH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,sBAAsB,GAC5B,MAAM,CAAC,sBAAsB,EAAE,WAAW,CAAC,CAsB7C"}