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

package/dist/points-lines/prepare.d.ts

@@ -0,0 +1,67 @@
+import type { MeshAsset } from '@forgeax/engine-types';
+import { type Result } from '@forgeax/engine-types';
+import { PointsLinesPrepareFailedError } from '../errors/render';
+import type { PointsLinesExpandedGeometry, PointsLinesExpansionCache } from './expansion-cache';
+import { type PointsLinesBackend, type PointsLinesLane, type PointsLinesLaneContract } from './record';
+import type { PointsLinesRetainedSnapshot } from './snapshot';
+export interface PointsLinesGpuResourceAdapter<Resource> {
+    create(geometry: PointsLinesExpandedGeometry): Result<Resource, Error>;
+    upload(resource: Resource, geometry: PointsLinesExpandedGeometry): Result<number, Error>;
+    validate(resource: Resource, geometry: PointsLinesExpandedGeometry): Result<void, Error>;
+    destroy(resource: Resource): void;
+}
+export interface PointsLinesPreparedResource<Resource> {
+    readonly resource: Resource;
+    readonly geometry: PointsLinesExpandedGeometry;
+    readonly snapshot: PointsLinesRetainedSnapshot;
+    readonly uploadedBytes: number;
+    readonly lastKnownGood: true;
+}
+export interface PointsLinesPreparationOptions<Resource> {
+    readonly cache: PointsLinesExpansionCache;
+    readonly adapter: PointsLinesGpuResourceAdapter<Resource>;
+}
+export interface PointsLinesLanePreparationAdapter<Resource> {
+    readonly contract: PointsLinesLaneContract;
+    prepare(snapshot: PointsLinesRetainedSnapshot, mesh: MeshAsset): Result<PointsLinesPreparedResource<Resource>, PointsLinesPrepareFailedError>;
+    resetForDeviceLoss(): void;
+    lastKnownGood(): PointsLinesPreparedResource<Resource> | undefined;
+    inspect(): PointsLinesPreparationInspection<Resource>;
+}
+export interface PointsLinesPreparationInspection<Resource> {
+    readonly status: 'empty' | 'resident' | 'rebuild-pending';
+    readonly lastKnownGood: boolean;
+    readonly liveResource: Resource | undefined;
+    readonly liveBytes: number;
+    readonly candidateBytes: number;
+    readonly cacheEntries: number;
+    readonly uploads: number;
+    readonly rebuilds: number;
+    readonly failures: number;
+}
+/**
+ * Owns one atomic candidate/LKG pair for a Points/Lines render projection.
+ * GPU resources are supplied by the existing DeviceScope adapter; this class
+ * keeps no backend handle or second resource ledger.
+ */
+export declare class PointsLinesPreparation<Resource> {
+    private readonly options;
+    private live;
+    private pendingCandidateBytes;
+    private status;
+    private uploads;
+    private rebuilds;
+    private failures;
+    constructor(options: PointsLinesPreparationOptions<Resource>);
+    prepare(snapshot: PointsLinesRetainedSnapshot, mesh: MeshAsset): Result<PointsLinesPreparedResource<Resource>, PointsLinesPrepareFailedError>;
+    resetForDeviceLoss(): void;
+    lastKnownGood(): PointsLinesPreparedResource<Resource> | undefined;
+    inspect(): PointsLinesPreparationInspection<Resource>;
+    private fail;
+}
+/**
+ * Binds the existing atomic preparation owner to a lane contract. It carries
+ * no RHI handle and does not add a second cache or recovery owner.
+ */
+export declare function createPointsLinesLanePreparationAdapter<Resource>(lane: PointsLinesLane, backend: PointsLinesBackend, options: PointsLinesPreparationOptions<Resource>): PointsLinesLanePreparationAdapter<Resource>;
+//# sourceMappingURL=prepare.d.ts.map

package/dist/points-lines/prepare.d.ts.map

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

package/dist/points-lines/record.d.ts

@@ -0,0 +1,60 @@
+import type { PointsLinesExpandedGeometry } from './expansion-cache';
+import type { PointsLinesRetainedSnapshot } from './snapshot';
+export declare const POINTS_LINES_MATERIAL_SHADER_ID = "forgeax::points-lines";
+export type PointsLinesLane = 'direct' | 'clustered' | 'cpu-webgl2';
+export type PointsLinesBackend = 'webgpu' | 'wgpu-webgl2' | 'null';
+export interface PointsLinesLaneContract {
+    readonly lane: PointsLinesLane;
+    readonly backend: PointsLinesBackend;
+    readonly authoring: 'shared';
+    readonly evidence: 'runtime' | 'structural-only';
+    readonly material: {
+        readonly source: 'MaterialAsset';
+        readonly shaderId: typeof POINTS_LINES_MATERIAL_SHADER_ID;
+        readonly shadingModel: 'unlit';
+        readonly clusteredLighting: false;
+        readonly lit: false;
+    };
+    readonly graph: {
+        readonly additionalAttachments: 0;
+        readonly additionalPasses: 0;
+    };
+    readonly shadowDrawCount: 0;
+    readonly capabilities: {
+        readonly compute: false;
+        readonly storage: false;
+        readonly indirect: false;
+    };
+}
+export interface PointsLinesRecordPlan {
+    readonly lane: PointsLinesLane;
+    readonly backend: PointsLinesBackend;
+    readonly materialShaderId: typeof POINTS_LINES_MATERIAL_SHADER_ID;
+    readonly component: 'Points' | 'Lines';
+    readonly meshGeneration: number;
+    readonly materialGeneration: number;
+    readonly vertexCount: number;
+    readonly indexCount: number;
+    readonly drawCount: 0 | 1;
+    readonly shadowDrawCount: 0;
+    readonly conservativeMarginPx: number;
+    readonly graph: PointsLinesLaneContract['graph'];
+}
+/**
+ * Describes the shared lane boundary without selecting a backend in authoring.
+ * Every lane uses CPU-uploaded triangle expansion; capability flags therefore
+ * stay false, including on WebGPU, and the graph remains the existing pass.
+ */
+export declare function createPointsLinesLaneContract(lane: PointsLinesLane, backend: PointsLinesBackend): PointsLinesLaneContract;
+/**
+ * Turns one retained expansion into the bounded draw facts consumed by the
+ * existing record pass. The shader expands one quad per point or segment,
+ * so the limits are exactly four vertices and six indices per primitive.
+ */
+export declare function createPointsLinesRecordPlan(snapshot: PointsLinesRetainedSnapshot, geometry: PointsLinesExpandedGeometry, contract: PointsLinesLaneContract): PointsLinesRecordPlan;
+export interface PointsLinesLaneAdapter {
+    readonly contract: PointsLinesLaneContract;
+    createRecordPlan(snapshot: PointsLinesRetainedSnapshot, geometry: PointsLinesExpandedGeometry): PointsLinesRecordPlan;
+}
+export declare function createPointsLinesLaneAdapter(lane: PointsLinesLane, backend: PointsLinesBackend): PointsLinesLaneAdapter;
+//# sourceMappingURL=record.d.ts.map

package/dist/points-lines/record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../src/points-lines/record.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAE9D,eAAO,MAAM,+BAA+B,0BAA0B,CAAC;AAEvE,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,CAAC;AACpE,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,aAAa,GAAG,MAAM,CAAC;AAEnE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,iBAAiB,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;QACjC,QAAQ,CAAC,QAAQ,EAAE,OAAO,+BAA+B,CAAC;QAC1D,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;QAC/B,QAAQ,CAAC,iBAAiB,EAAE,KAAK,CAAC;QAClC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC;KACrB,CAAC;IACF,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,qBAAqB,EAAE,CAAC,CAAC;QAClC,QAAQ,CAAC,gBAAgB,EAAE,CAAC,CAAC;KAC9B,CAAC;IACF,QAAQ,CAAC,eAAe,EAAE,CAAC,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE;QACrB,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;QACxB,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;QACxB,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,+BAA+B,CAAC;IAClE,QAAQ,CAAC,SAAS,EAAE,QAAQ,GAAG,OAAO,CAAC;IACvC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,CAAC,CAAC;IAC5B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC,OAAO,CAAC,CAAC;CAClD;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,kBAAkB,GAC1B,uBAAuB,CAiBzB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,2BAA2B,EACrC,QAAQ,EAAE,2BAA2B,EACrC,QAAQ,EAAE,uBAAuB,GAChC,qBAAqB,CAqBvB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;IAC3C,gBAAgB,CACd,QAAQ,EAAE,2BAA2B,EACrC,QAAQ,EAAE,2BAA2B,GACpC,qBAAqB,CAAC;CAC1B;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,kBAAkB,GAC1B,sBAAsB,CAOxB"}

package/dist/points-lines/snapshot.d.ts

@@ -0,0 +1,49 @@
+import type { PointShape } from '../components/points';
+export interface PointsLinesViewport {
+    readonly width: number;
+    readonly height: number;
+    readonly dpr: number;
+}
+export type PointsLinesStyle = {
+    readonly kind: 'points';
+    readonly sizePx: number;
+    readonly shape: PointShape;
+} | {
+    readonly kind: 'lines';
+    readonly widthPx: number;
+};
+export type PointsLinesInvalidation = 'none' | 'mesh' | 'material' | 'style' | 'view' | 'scene';
+/**
+ * Detached facts retained between frames for the Points/Lines owner.
+ *
+ * The snapshot deliberately contains no World, ECS row, AssetRegistry, GPU
+ * handle, or derived triangle data. Mesh and material generations are the
+ * producer-owned fences used by prepare; viewport and projection are the
+ * only camera-owned facts in this projection.
+ */
+export interface PointsLinesRetainedSnapshot {
+    readonly worldId: number;
+    readonly entityKey: number;
+    readonly component: 'Points' | 'Lines' | undefined;
+    readonly meshHandle: number;
+    readonly meshGeneration: number;
+    readonly materialHandle: number;
+    readonly materialGeneration: number;
+    readonly style: PointsLinesStyle | undefined;
+    readonly layer: number;
+    readonly sortKey: number | undefined;
+    readonly visible: boolean;
+    readonly sourceBounds: Float32Array;
+    readonly viewport: PointsLinesViewport;
+    readonly projection: Float32Array;
+    readonly dedicatedResourceBytes?: number;
+}
+export interface PointsLinesSnapshotInput extends Omit<PointsLinesRetainedSnapshot, 'sourceBounds' | 'viewport' | 'projection' | 'sortKey'> {
+    readonly sortKey?: number | undefined;
+    readonly sourceBounds: ArrayLike<number>;
+    readonly viewport: PointsLinesViewport;
+    readonly projection: ArrayLike<number>;
+}
+export declare function createPointsLinesSnapshot(input: PointsLinesSnapshotInput): PointsLinesRetainedSnapshot;
+export declare function comparePointsLinesSnapshots(previous: PointsLinesRetainedSnapshot, next: PointsLinesRetainedSnapshot): PointsLinesInvalidation;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/points-lines/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/points-lines/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAChF;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAEhG;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;IAClC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAC1C;AAED,MAAM,WAAW,wBACf,SAAQ,IAAI,CACV,2BAA2B,EAC3B,cAAc,GAAG,UAAU,GAAG,YAAY,GAAG,SAAS,CACvD;IACD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CACxC;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,wBAAwB,GAC9B,2BAA2B,CAkB7B;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,2BAA2B,EACrC,IAAI,EAAE,2BAA2B,GAChC,uBAAuB,CAiCzB"}

package/dist/post-process-errors.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Closed union of fullscreen post-process error codes.
+ *
+ * Exactly 7 members; AI users perform exhaustive `switch (err.code)` without a default
+ * and TS guards completeness (AC-08).
+ *
+ * | code | channel | trigger |
+ * |:--|:--|:--|
+ * | `'post-process-already-registered'` | throw | a second fullscreen effect registration under an already-registered `id` |
+ * | `'post-process-not-found'` | throw / `Result.err` | a typed fullscreen plan whose `shader` id resolves to no registered post-process |
+ * | `'fullscreen-input-not-found'` | throw | a typed fullscreen plan whose `reads` key is not a graph-declared color target, or a depth key missing TEXTURE_BINDING (D-4) |
+ * | `'ssao-radius-non-positive'` | throw | SSAO `radius <= 0` |
+ * | `'ssao-bias-negative'` | throw | SSAO `bias < 0` |
+ * | `'params-size-mismatch'` | throw | a fullscreen effect declaration with `params.byteSize < 16` or `defaultValue.length !== byteSize` (feat-20260621 M-A4 / D-4) |
+ * | `'params-update-size-mismatch'` | throw | per-frame data-driven write where `PostProcessParams.data` byteLength !== registered `params.byteSize` (feat-20260621 M-A4 / D-4) |
+ */
+export type PostProcessErrorCode = keyof typeof POST_PROCESS_POLICY;
+/**
+ * Detail for `'post-process-already-registered'`: the post-process id that was already taken.
+ * AI consumers read `.detail.id` by property access (charter P4), no message parsing.
+ */
+export interface PostProcessPreviouslyRegisteredDetail {
+    readonly id: string;
+}
+/**
+ * Detail for `'post-process-not-found'`: the post-process id that resolved to no
+ * registered entry. Read via `.detail.id` after the code guard.
+ */
+export interface PostProcessNotFoundDetail {
+    readonly id: string;
+}
+/**
+ * Detail for `'fullscreen-input-not-found'`: the graph resource key that the
+ * per-pass resolve context could not resolve, plus the pass name that referenced
+ * it. Both fields are read via property access after `if (err.code === 'fullscreen-input-not-found')`
+ * (charter P4); the AI user immediately knows WHICH key to declare and WHICH
+ * pass needs wiring.
+ */
+export interface FullscreenInputNotFoundDetail {
+    /** The reads[0] key that resolved to undefined (e.g. 'offscreenColor' / 'hdrColor'). */
+    readonly readsKey: string;
+    /** The name assigned to the typed fullscreen pass (e.g. 'pp' / 'post'). */
+    readonly passName: string;
+}
+/**
+ * Detail for `'ssao-radius-non-positive'`: the SSAO radius parameter was zero or negative.
+ * AI consumers read `.detail.paramName` / `.detail.value` by property access (charter P4).
+ */
+export interface SsaoRadiusNonPositiveDetail {
+    readonly paramName: string;
+    readonly value: number;
+}
+/**
+ * Detail for `'ssao-bias-negative'`: the SSAO bias parameter was negative.
+ * AI consumers read `.detail.paramName` / `.detail.value` by property access.
+ */
+export interface SsaoBiasNegativeDetail {
+    readonly paramName: string;
+    readonly value: number;
+}
+/**
+ * Detail for `'params-size-mismatch'`: the register call's byteSize / defaultValue.length
+ * is invalid. Carries `byteSize` (the declared size) and `actualLength` (defaultValue.length).
+ * AI consumers read `.detail.byteSize` / `.detail.actualLength` after the code guard.
+ */
+export interface PostProcessParamsSizeMismatchDetail {
+    readonly byteSize: number;
+    readonly actualLength: number;
+}
+/**
+ * Detail for `'params-update-size-mismatch'`: the per-frame data-driven write
+ * (PostProcessParams.data) had a byteLength that did not equal the registered
+ * `params.byteSize`. Carries `byteSize` (registered) + `actualLength` (the
+ * supplied data byteLength). AI consumers read `.detail.byteSize` /
+ * `.detail.actualLength` after the code guard.
+ *
+ * NOTE (feat-20260621 M-A2): this code is wired here so dispatchFullscreenPass
+ * can fail-fast on a mismatched per-frame write; the full error-model
+ * formalization (expected/hint refinement, JSDoc member count, public
+ * PostProcessError union variant) is finished in M-A4.
+ */
+export interface PostProcessParamsUpdateSizeMismatchDetail {
+    readonly byteSize: number;
+    readonly actualLength: number;
+}
+/**
+ * Conditional resolver from `PostProcessErrorCode` to its detail payload type. Used by the
+ * constructor signature so `new PostProcessError({ code: 'X', detail })` narrows the
+ * `detail` parameter to the variant payload at compile time.
+ */
+export type PostProcessErrorDetailFor<C extends PostProcessErrorCode> = C extends 'post-process-already-registered' ? PostProcessPreviouslyRegisteredDetail : C extends 'post-process-not-found' ? PostProcessNotFoundDetail : C extends 'fullscreen-input-not-found' ? FullscreenInputNotFoundDetail : C extends 'ssao-radius-non-positive' ? SsaoRadiusNonPositiveDetail : C extends 'ssao-bias-negative' ? SsaoBiasNegativeDetail : C extends 'params-size-mismatch' ? PostProcessParamsSizeMismatchDetail : C extends 'params-update-size-mismatch' ? PostProcessParamsUpdateSizeMismatchDetail : never;
+/**
+ * Tagged union of `.detail` payloads. The variants are unique by structural fields
+ * (`{ id }` for the two id-by-string variants vs `{ readsKey, passName }` for the
+ * graph-resource-miss variant); the code discriminator narrows the intent across
+ * the two id-shaped variants.
+ */
+export type PostProcessErrorDetail = PostProcessErrorDetailFor<PostProcessErrorCode>;
+declare const POST_PROCESS_POLICY: {
+    'post-process-already-registered': {
+        expected: string;
+        hint: (detail: unknown) => string;
+    };
+    'post-process-not-found': {
+        expected: string;
+        hint: (detail: unknown) => string;
+    };
+    'fullscreen-input-not-found': {
+        expected: string;
+        hint: (detail: unknown) => string;
+    };
+    'ssao-radius-non-positive': {
+        expected: string;
+        hint: (detail: unknown) => string;
+    };
+    'ssao-bias-negative': {
+        expected: string;
+        hint: (detail: unknown) => string;
+    };
+    'params-size-mismatch': {
+        expected: string;
+        hint: (detail: unknown) => string;
+    };
+    'params-update-size-mismatch': {
+        expected: string;
+        hint: (detail: unknown) => string;
+    };
+};
+declare class PostProcessErrorClass<C extends PostProcessErrorCode> extends Error {
+    readonly code: C;
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: PostProcessErrorDetailFor<C>;
+    constructor(args: {
+        code: C;
+        detail: PostProcessErrorDetailFor<C>;
+    });
+}
+/**
+ * Variant intersection: a `PostProcessErrorClass` instance whose `code` literal narrows to
+ * `C` and whose `detail` narrows to `PostProcessErrorDetailFor<C>`, so `if (err.code === 'X')`
+ * simultaneously narrows `err.detail` (charter P3 + P4 discriminated union).
+ */
+type PostProcessErrorVariant<C extends PostProcessErrorCode> = PostProcessErrorClass<C> & {
+    readonly code: C;
+    readonly detail: PostProcessErrorDetailFor<C>;
+};
+interface PostProcessErrorConstructor {
+    new <C extends PostProcessErrorCode>(args: {
+        code: C;
+        detail: PostProcessErrorDetailFor<C>;
+    }): PostProcessErrorVariant<C>;
+    readonly prototype: PostProcessErrorClass<PostProcessErrorCode>;
+}
+/**
+ * Public PostProcessError type - mapped from the authoritative code union.
+ *
+ * ```ts
+ * function recover(err: PostProcessError): string {
+ *   switch (err.code) {
+ *     case 'post-process-already-registered': return `id taken: ${err.detail.id}`;
+ *     case 'post-process-not-found':          return `bad id: ${err.detail.id}`;
+ *     case 'fullscreen-input-not-found':      return `bad reads key: ${err.detail.readsKey} on pass ${err.detail.passName}`;
+ *   }
+ * }
+ * ```
+ */
+export type PostProcessError = {
+    [C in PostProcessErrorCode]: PostProcessErrorVariant<C>;
+}[PostProcessErrorCode];
+/**
+ * PostProcessError constructor - `new PostProcessError({ code, detail })`.
+ *
+ * The generic `C` is inferred from the literal `code` argument, which narrows `detail` to
+ * the per-code payload (`PostProcessErrorDetailFor<C>`) and narrows the return type to the
+ * corresponding `PostProcessErrorVariant<C>` so the call site walks the discriminated union
+ * without manual cast (AppError pattern; TS class declarations cannot directly express
+ * `<C> ... PostProcessErrorVariant<C>` polymorphism, hence the typed-cast affordance).
+ */
+export declare const PostProcessError: PostProcessErrorConstructor;
+export {};
+//# sourceMappingURL=post-process-errors.d.ts.map

package/dist/post-process-errors.d.ts.map

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

package/dist/prepare/prepared-graphics-resolver.d.ts

@@ -0,0 +1,59 @@
+import type { BindGroup, Buffer, RenderPipeline, RhiDevice } from '@forgeax/engine-rhi';
+import { type Result } from '@forgeax/engine-types';
+import { type RenderError } from '../errors/render';
+import type { PreparedGraphicsResourceLease, RenderFeatureResolvedGpuBuffer } from '../features/prepared-gpu-work';
+import type { RenderFeatureBindingsDescriptor, RenderFeaturePreparedRef } from '../features/prepared-graphics';
+import type { PreparedGraphicsItem, PreparedGraphicsKind, PreparedGraphicsNormalizedDescriptor } from '../features/prepared-graphics-store';
+type PreparedBufferKind = Exclude<PreparedGraphicsKind, 'pipeline' | 'bindings'>;
+export type PreparedGraphicsReference = RenderFeaturePreparedRef<'pipeline'> | RenderFeaturePreparedRef<'bindings'> | RenderFeaturePreparedRef<'vertex-data'> | RenderFeaturePreparedRef<'index-data'>;
+export type PreparedGraphicsResolvedResource = {
+    readonly kind: 'pipeline';
+    readonly reference: RenderFeaturePreparedRef;
+    readonly handle: RenderPipeline;
+} | {
+    readonly kind: 'bindings';
+    readonly reference: RenderFeaturePreparedRef;
+    readonly handle: BindGroup | undefined;
+    readonly pipeline?: RenderPipeline;
+    readonly descriptor?: RenderFeatureBindingsDescriptor;
+    readonly dynamicOffsets?: readonly number[];
+} | {
+    readonly kind: PreparedBufferKind;
+    readonly reference: RenderFeaturePreparedRef;
+    readonly handle: Buffer;
+    readonly size: number;
+    readonly physicalUsage: number;
+};
+export interface PreparedGraphicsResolverInput {
+    readonly device: RhiDevice;
+    /** Owning feature identity survives lookup failures for feature-local diagnostics. */
+    readonly featureIdentity?: string;
+    readonly generation: number;
+    readonly capabilityAvailable: boolean;
+    readonly lookup: (reference: RenderFeaturePreparedRef) => PreparedGraphicsItem | undefined;
+    readonly resolvePipeline: (descriptor: PreparedGraphicsNormalizedDescriptor & {
+        readonly kind: 'pipeline';
+    }) => Result<RenderPipeline, unknown>;
+    readonly resolveBindings: (descriptor: RenderFeatureBindingsDescriptor, pipeline: RenderPipeline) => Result<undefined | BindGroup | {
+        readonly handle: BindGroup;
+        readonly dynamicOffsets?: readonly number[];
+        readonly release: () => Result<void, unknown>;
+    }, unknown>;
+    readonly resolveGpuBuffer?: (reference: import('../features/prepared-gpu-work').RenderFeatureGpuBufferRef) => RenderFeatureResolvedGpuBuffer | undefined;
+    readonly featureOrder?: number;
+}
+export interface PreparedGraphicsResolver {
+    resolve(reference: PreparedGraphicsReference): Result<PreparedGraphicsResolvedResource, RenderError>;
+    readonly leases: readonly PreparedGraphicsResourceLease[];
+    readonly resolveGpuBuffer?: PreparedGraphicsResolverInput['resolveGpuBuffer'];
+    release(): Result<void, RenderError>;
+}
+export type { PreparedGraphicsResourceLease } from '../features/prepared-gpu-work';
+export interface PreparedGraphicsResolvedSnapshot {
+    readonly generation: number;
+    readonly leases?: readonly PreparedGraphicsResourceLease[];
+    readonly resolve: (reference: RenderFeaturePreparedRef) => PreparedGraphicsResolvedResource | undefined;
+    readonly resolveGpuBuffer?: (reference: import('../features/prepared-gpu-work').RenderFeatureGpuBufferRef) => RenderFeatureResolvedGpuBuffer | undefined;
+}
+export declare function createPreparedGraphicsResolver(input: PreparedGraphicsResolverInput): PreparedGraphicsResolver;
+//# sourceMappingURL=prepared-graphics-resolver.d.ts.map

package/dist/prepare/prepared-graphics-resolver.d.ts.map

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

package/dist/record/__tests__/material-bg-cache.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=material-bg-cache.unit.test.d.ts.map

package/dist/record/__tests__/material-bg-cache.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-bg-cache.unit.test.d.ts","sourceRoot":"","sources":["../../../src/record/__tests__/material-bg-cache.unit.test.ts"],"names":[],"mappings":""}

package/dist/record/__tests__/material-slot-plan.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=material-slot-plan.unit.test.d.ts.map

package/dist/record/__tests__/material-slot-plan.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-slot-plan.unit.test.d.ts","sourceRoot":"","sources":["../../../src/record/__tests__/material-slot-plan.unit.test.ts"],"names":[],"mappings":""}

package/dist/record/__tests__/typed-frame-graph-plan.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=typed-frame-graph-plan.unit.test.d.ts.map

package/dist/record/__tests__/typed-frame-graph-plan.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-frame-graph-plan.unit.test.d.ts","sourceRoot":"","sources":["../../../src/record/__tests__/typed-frame-graph-plan.unit.test.ts"],"names":[],"mappings":""}

package/dist/record/__tests__/video-texture-view.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=video-texture-view.unit.test.d.ts.map

package/dist/record/__tests__/video-texture-view.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-texture-view.unit.test.d.ts","sourceRoot":"","sources":["../../../src/record/__tests__/video-texture-view.unit.test.ts"],"names":[],"mappings":""}

package/dist/record/frame-lighting.d.ts

@@ -0,0 +1,121 @@
+import { type BindGroup, type BindGroupLayout, type TextureView } from '@forgeax/engine-rhi';
+import type { CameraSnapshot } from '../render-contract';
+import type { DirectionalLightSnapshot, ExtractedLights, RenderableSnapshot, SkyboxSnapshot, SkylightSnapshot } from '../render-system-extract';
+import type { BindGroupCounts, RenderFrameState } from './frame-snapshot';
+import type { PipelineState, RecordProfileRunner, RenderSystemInternals } from './render-context';
+/**
+ * feat-20260704 M3/w18: per-frame bind-group cache resolution, extracted
+ * verbatim from `recordFrame`. Walks the handle-identity WeakMap caches
+ * (feat-20260531 M2 + feat-20260622 M3) to resolve or lazily create the view
+ * (@group 0), mesh (@group 2), and — when HDRP is active — HDRP-unified cluster
+ * bind groups. Returns all three (null when `hasValidated` is false, the Case E
+ * clear-pass-only path). No new mutable state: `bindGroupCounts` accounting +
+ * cache maps are threaded through explicitly.
+ *
+ * @internal
+ */
+export declare function buildPerFrameBindGroups(internals: RenderSystemInternals, frameState: RenderFrameState, pipelineState: PipelineState, hasValidated: boolean, bindGroupCounts: BindGroupCounts, graphTargets?: {
+    readonly directionalShadow?: TextureView | undefined;
+    readonly spotShadow?: TextureView | undefined;
+}, includeView?: boolean): {
+    viewBindGroup: BindGroup | null;
+    meshBindGroup: BindGroup | null;
+    hdrpClusterBindGroup: BindGroup | null;
+    hdrpClusterMembershipBindGroup: BindGroup | null;
+};
+/**
+ * feat-20260704 M3/w18: per-frame lighting preparation, extracted verbatim from
+ * `recordFrame`. (1) URP-only multi-light warn-once (directional / point / spot
+ * over `LIGHT_ARRAY_MAX_SLOTS`; HDRP gated off — 256 SSBO lights). (2) pin the
+ * point + spot shadow snapshot lists onto frameState for the URP shadow caster
+ * pass closures + lazy-allocate the point-shadow cube_array atlas on first
+ * non-empty frame (AC-09 zero-shadow zero-alloc). (3) destructure ExtractedLights
+ * into the directional-fallback `light` (zero-intensity Case C default), point /
+ * spot arrays, and totalLightCount.
+ *
+ * @internal
+ */
+export declare function prepareFrameLighting(internals: RenderSystemInternals, frameState: RenderFrameState, lights: ExtractedLights): {
+    light: DirectionalLightSnapshot;
+    pointLights: ExtractedLights['point'];
+    spotLights: ExtractedLights['spot'];
+    totalLightCount: number;
+};
+/**
+ * feat-20260704 M3/w18: per-frame full rewrite of the PointLight + SpotLight
+ * std430 storage buffers, extracted verbatim from `recordFrame`.
+ *
+ * feat-20260519-light-casters-point-spot-pbr M3 / w20 (D-S1 + D-S2 + D-S6):
+ * header (16 B count u32 + 12 B pad) at offset 0 + first-slice cap N=4 slots
+ * packed sequentially. The N>4 fail-fast upstream ensures the counts are <= 4
+ * when the listener registry consumed the structured error; the slice keeps
+ * the buffer write bounded even if downstream listeners ignore the RhiError
+ * (charter P9 graceful degradation: surplus entities dropped, frame records).
+ *
+ * @internal
+ */
+export declare function writePointSpotLightBuffers(internals: RenderSystemInternals, pipelineState: PipelineState, lights: ExtractedLights): void;
+/**
+ * feat-20260704 M3/w18: write the point-shadow params UBO (bound at viewBg
+ * binding 6), extracted verbatim from `recordFrame`.
+ *
+ * feat-20260612-point-light-shadows-urp-hdrp Round-2 F-1: 4 lanes x vec4<f32>;
+ * lane[shadowAtlasLayer] = (near, far, 1/(far-near), 0). Lanes for non-shadow
+ * slots stay zero (the WGSL sample path is gated by PointLight.shadowAtlasLayer
+ * >= 0). Always writes the full 64 B so stale non-zero lanes from a previous
+ * frame's allocation cannot poison the current frame.
+ *
+ * @internal
+ */
+export declare function writeShadowParamsBuffer(internals: RenderSystemInternals, frameState: RenderFrameState, pipelineState: PipelineState): void;
+/**
+ * feat-20260704 M3/w18: zero-light standard-material once-warn, extracted
+ * verbatim from `recordFrame`.
+ *
+ * feat-20260520-skylight-ibl-cubemap M4 / t27 (AC-10): fires once per
+ * RenderSystem lifetime when the 0-light three-condition conjunction holds — no
+ * Skylight, 0 direct light (totalLightCount === 0), AND at least one builtin
+ * standard/PBR material (which renders black with no light). Custom shaders
+ * own their lighting contract and cannot be classified by this generic
+ * diagnostic. Suppressed under NODE_ENV=production.
+ *
+ * @internal
+ */
+export declare function warnZeroLightStandard(frameState: RenderFrameState, renderables: readonly RenderableSnapshot[], skylight: SkylightSnapshot | undefined, totalLightCount: number): void;
+/**
+ * feat-20260704 M3/w18: HDRP per-frame CPU cluster binning + light-data /
+ * cluster-grid / light-index-list / cluster-uniform / SSAO uniform buffer
+ * uploads. Extracted verbatim from `recordFrame`. Runs only when the HDRP
+ * pipeline is active. A zero-punctual frame explicitly clears the persistent
+ * cluster buffers so stale membership cannot leak across frames; direct and
+ * non-clustered paths remain untouched.
+ *
+ * feat-20260608-cluster-lighting M5 / w21 + M6 / w23 + r2 fix-up: fail-soft
+ * semantics preserved verbatim — index-list-overflow and light-budget-exceeded
+ * fire once per frame (via `frameState.hdrpOncePerFrameFired`) and continue
+ * rendering.
+ *
+ * @internal
+ */
+export declare function writeHdrpClusterAndSsaoBuffers(internals: RenderSystemInternals, frameState: RenderFrameState, camera: CameraSnapshot, pointLights: ExtractedLights['point'], spotLights: ExtractedLights['spot'], profilePhase?: RecordProfileRunner, useGpuMembership?: boolean, membershipBindGroupLayout?: BindGroupLayout | null): void;
+/**
+ * feat-20260704 M3/w18: resolve `tonemapActive` + `skyboxActive` for this
+ * frame, extracted verbatim from `recordFrame`.
+ *
+ * feat-20260519-tonemap-reinhard-mvp: tonemap is active when the camera carries
+ * `tonemap !== 'none'` (routes geometry into the HDR offscreen target + a
+ * fullscreen tonemap pass). feat-20260531-skybox-env-background M2 / w9: skybox
+ * is active only when a SkyboxBackground entity is present AND tonemap is active
+ * (hdrColor is only allocated on the tonemap path). M3 / w20: once-warn when
+ * tonemap is 'none' but a skybox exists (config issue, not resource-timing —
+ * no structured error). M3 / w18: skybox degrades to clear-colour for a frame
+ * while its cubemap view is not yet resident (lazy equirect projection pending
+ * / failed; the lazy trigger owns the fire-once-on-failed error).
+ *
+ * @internal
+ */
+export declare function resolveSkyboxActive(internals: RenderSystemInternals, frameState: RenderFrameState, camera: CameraSnapshot, skybox: SkyboxSnapshot | undefined): {
+    tonemapActive: boolean;
+    skyboxActive: boolean;
+};
+//# sourceMappingURL=frame-lighting.d.ts.map

package/dist/record/frame-lighting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-lighting.d.ts","sourceRoot":"","sources":["../../src/record/frame-lighting.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,KAAK,SAAS,EACd,KAAK,eAAe,EAEpB,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AA2B7B,OAAO,KAAK,EAAE,cAAc,EAA0B,MAAM,oBAAoB,CAAC;AACjF,OAAO,KAAK,EACV,wBAAwB,EACxB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAIlC,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAU1E,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAWlG;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,qBAAqB,EAChC,UAAU,EAAE,gBAAgB,EAC5B,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,OAAO,EACrB,eAAe,EAAE,eAAe,EAChC,YAAY,CAAC,EAAE;IACb,QAAQ,CAAC,iBAAiB,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,UAAU,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC/C,EACD,WAAW,UAAO,GACjB;IACD,aAAa,EAAE,SAAS,GAAG,IAAI,CAAC;IAChC,aAAa,EAAE,SAAS,GAAG,IAAI,CAAC;IAChC,oBAAoB,EAAE,SAAS,GAAG,IAAI,CAAC;IACvC,8BAA8B,EAAE,SAAS,GAAG,IAAI,CAAC;CAClD,CA0QA;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,qBAAqB,EAChC,UAAU,EAAE,gBAAgB,EAC5B,MAAM,EAAE,eAAe,GACtB;IACD,KAAK,EAAE,wBAAwB,CAAC;IAChC,WAAW,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IACtC,UAAU,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IACpC,eAAe,EAAE,MAAM,CAAC;CACzB,CAyFA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,qBAAqB,EAChC,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,eAAe,GACtB,IAAI,CA+CN;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,qBAAqB,EAChC,UAAU,EAAE,gBAAgB,EAC5B,aAAa,EAAE,aAAa,GAC3B,IAAI,CA4BN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,gBAAgB,EAC5B,WAAW,EAAE,SAAS,kBAAkB,EAAE,EAC1C,QAAQ,EAAE,gBAAgB,GAAG,SAAS,EACtC,eAAe,EAAE,MAAM,GACtB,IAAI,CAgBN;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,qBAAqB,EAChC,UAAU,EAAE,gBAAgB,EAC5B,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,eAAe,CAAC,OAAO,CAAC,EACrC,UAAU,EAAE,eAAe,CAAC,MAAM,CAAC,EACnC,YAAY,CAAC,EAAE,mBAAmB,EAClC,gBAAgB,UAAQ,EACxB,yBAAyB,GAAE,eAAe,GAAG,IAAW,GACvD,IAAI,CA6WN;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,qBAAqB,EAChC,UAAU,EAAE,gBAAgB,EAC5B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,cAAc,GAAG,SAAS,GACjC;IAAE,aAAa,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,CAqCnD"}