@forgeax/engine-render 0.1.27 → 0.1.29

package/dist/pipeline/standard-output/auto-exposure/inspection.d.ts

@@ -0,0 +1,111 @@
+import type { CameraExposure } from '../../../components/camera';
+export type AutoExposureErrorCode = 'auto-exposure-invalid-parameter' | 'auto-exposure-capability-unavailable' | 'auto-exposure-stale-generation' | 'auto-exposure-stage-failed';
+export interface AutoExposureInvalidParameterDetail {
+    readonly field: string;
+    readonly value: number;
+    readonly expected: string;
+}
+export interface AutoExposureCapabilityUnavailableDetail {
+    readonly capability: 'compute' | 'storage-buffer' | 'float-filterable';
+    readonly generation: number;
+}
+export interface AutoExposureStaleGenerationDetail {
+    readonly expectedGeneration: number;
+    readonly actualGeneration: number;
+}
+export interface AutoExposureStageFailedDetail {
+    readonly stage: 'prepare' | 'record';
+    readonly operation: string;
+    readonly cause: unknown;
+}
+export type AutoExposureErrorDetailByCode = {
+    'auto-exposure-invalid-parameter': AutoExposureInvalidParameterDetail;
+    'auto-exposure-capability-unavailable': AutoExposureCapabilityUnavailableDetail;
+    'auto-exposure-stale-generation': AutoExposureStaleGenerationDetail;
+    'auto-exposure-stage-failed': AutoExposureStageFailedDetail;
+};
+export type AutoExposureErrorDetail = AutoExposureErrorDetailByCode[AutoExposureErrorCode];
+export declare class AutoExposureInvalidParameterError extends Error {
+    readonly detail: AutoExposureInvalidParameterDetail;
+    readonly code: "auto-exposure-invalid-parameter";
+    readonly expected: string;
+    readonly hint: string;
+    constructor(detail: AutoExposureInvalidParameterDetail);
+}
+export declare class AutoExposureCapabilityUnavailableError extends Error {
+    readonly detail: AutoExposureCapabilityUnavailableDetail;
+    readonly code: "auto-exposure-capability-unavailable";
+    readonly expected: string;
+    readonly hint: string;
+    constructor(detail: AutoExposureCapabilityUnavailableDetail);
+}
+export declare class AutoExposureStaleGenerationError extends Error {
+    readonly detail: AutoExposureStaleGenerationDetail;
+    readonly code: "auto-exposure-stale-generation";
+    readonly expected: string;
+    readonly hint: string;
+    constructor(detail: AutoExposureStaleGenerationDetail);
+}
+export declare class AutoExposureStageFailedError extends Error {
+    readonly detail: AutoExposureStageFailedDetail;
+    readonly code: "auto-exposure-stage-failed";
+    readonly expected: string;
+    readonly hint: string;
+    constructor(detail: AutoExposureStageFailedDetail);
+}
+export type AutoExposureError = AutoExposureInvalidParameterError | AutoExposureCapabilityUnavailableError | AutoExposureStaleGenerationError | AutoExposureStageFailedError;
+type AutoExposureErrorInput = {
+    [C in AutoExposureErrorCode]: {
+        readonly code: C;
+        readonly detail: AutoExposureErrorDetailByCode[C];
+    };
+}[AutoExposureErrorCode];
+export type AutoExposureErrorRecord = {
+    [C in AutoExposureErrorCode]: {
+        readonly code: C;
+        readonly expected: string;
+        readonly hint: string;
+        readonly detail: AutoExposureErrorDetailByCode[C];
+    };
+}[AutoExposureErrorCode];
+export type AutoExposureResetReason = 'camera-change' | 'manual-mode' | 'device-lost' | 'stale-generation';
+export interface AutoExposureCost {
+    readonly histogramBytes: number;
+    /** Logical stages retained for the inspect contract: clear, histogram, adapt. */
+    readonly passCount: number;
+    /** The logical stages share one real timestamped compute pass. */
+    readonly physicalPassCount: number;
+}
+export interface AutoExposureReceipt {
+    readonly frameId: number;
+    readonly committed: boolean;
+}
+/**
+ * Describes where the detached `actual` value came from.  A successful live
+ * GPU submission is intentionally not a CPU observation: its numeric result
+ * remains resident in the GPU state buffer until an explicit readback owner
+ * is requested.  Keeping that state distinct prevents fallback from being
+ * presented as the measured exposure.
+ */
+export type AutoExposureActualState = 'accepted' | 'fallback' | 'gpu-resident';
+export interface AutoExposureInspection {
+    readonly requested: CameraExposure;
+    readonly actual: number | null;
+    readonly actualState: AutoExposureActualState;
+    readonly fallback: number;
+    readonly lastKnownGood: number;
+    readonly targetGeneration: number;
+    readonly recentFailure?: AutoExposureError;
+    readonly reset: readonly AutoExposureResetReason[];
+    readonly cost: AutoExposureCost;
+    readonly receipt: AutoExposureReceipt;
+}
+export interface AutoExposureInspectionInput extends Omit<AutoExposureInspection, 'actualState' | 'recentFailure'> {
+    readonly actualState?: AutoExposureActualState;
+    readonly recentFailure?: AutoExposureError | AutoExposureErrorRecord;
+}
+export declare function createAutoExposureError(input: AutoExposureErrorInput | AutoExposureErrorRecord): AutoExposureError;
+/** Project detached bounded facts; GPU handles and histogram buckets never cross this boundary. */
+export declare function createAutoExposureInspection(input: AutoExposureInspectionInput): Readonly<AutoExposureInspection>;
+export {};
+//# sourceMappingURL=inspection.d.ts.map

package/dist/pipeline/standard-output/auto-exposure/inspection.d.ts.map

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

package/dist/pipeline/standard-output/auto-exposure/oracle.d.ts

@@ -0,0 +1,16 @@
+export declare function luminanceHistogram(pixels: readonly (readonly [number, number, number, number])[], bins?: 256): Uint32Array;
+/**
+ * Mirror the fixed shader-side center weighting for deterministic tests. The
+ * sample list is row-major over the metering grid (one sample per 4x4 block),
+ * so the helper never changes the texture-read/sample-count contract.
+ */
+export declare function centerWeight(block: readonly [number, number], sampleGrid: readonly [number, number]): number;
+export declare function weightedLuminanceHistogram(pixels: readonly (readonly [number, number, number, number])[], sampleGrid: readonly [number, number], bins?: 256): Uint32Array;
+/** Fixed product target mapping used to compare GPU adaptation with a CPU oracle. */
+export declare function autoExposureTarget(histogram: Uint32Array, compensationEv: number, rangeEv: readonly [number, number], fallback: number): number;
+export declare function histogramPercentile(histogram: Uint32Array, percentile: number): number;
+export declare function adaptExposure(current: number, target: number, deltaTime: number, upRate: number, downRate: number): number;
+export declare function bradfordAdaptD65(rgb: readonly [number, number, number], temperature: number): [number, number, number];
+export declare function linearRgbToLab(rgb: readonly [number, number, number]): [number, number, number];
+export declare function ciede2000(first: readonly [number, number, number], second: readonly [number, number, number]): number;
+//# sourceMappingURL=oracle.d.ts.map

package/dist/pipeline/standard-output/auto-exposure/oracle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/standard-output/auto-exposure/oracle.ts"],"names":[],"mappings":"AAiDA,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,EAC9D,IAAI,MAAwC,GAC3C,WAAW,CAab;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,MAAM,CASR;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,EAC9D,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EACrC,IAAI,MAAwC,GAC3C,WAAW,CAoBb;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,WAAW,EACtB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,QAAQ,EAAE,MAAM,GACf,MAAM,CA0CR;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAgBtF;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,MAAM,CAOR;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACtC,WAAW,EAAE,MAAM,GAClB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAgB1B;AAQD,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAM/F;AAED,wBAAgB,SAAS,CACvB,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACxC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GACxC,MAAM,CAuCR"}

package/dist/pipeline/standard-output/auto-exposure/preset.d.ts

@@ -0,0 +1,14 @@
+/** Versioned product constants. External standards supply formulas, not these values. */
+export interface AutoExposurePreset {
+    readonly version: 'auto-exposure-v1';
+    readonly histogramBins: 256;
+    readonly sampleBlockSize: 4;
+    readonly lowPercentile: number;
+    readonly highPercentile: number;
+    readonly middleGray: number;
+    readonly logLuminanceMin: number;
+    readonly logLuminanceMax: number;
+    readonly referenceFormulas: readonly string[];
+}
+export declare const AUTO_EXPOSURE_PRESET_V1: AutoExposurePreset;
+//# sourceMappingURL=preset.d.ts.map

package/dist/pipeline/standard-output/auto-exposure/preset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/standard-output/auto-exposure/preset.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,CAAC,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/C;AAED,eAAO,MAAM,uBAAuB,EAAE,kBAcpC,CAAC"}

package/dist/pipeline/standard-output/auto-exposure/state.d.ts

@@ -0,0 +1,46 @@
+import { type Result } from '@forgeax/engine-types';
+import { AutoExposureInvalidParameterError, type AutoExposureReceipt, type AutoExposureResetReason, AutoExposureStaleGenerationError } from './inspection';
+/** CPU-side ownership record for the two GPU state slots and accepted candidate. */
+export interface AutoExposureState {
+    readonly acceptedEv: number;
+    readonly fallback: number;
+    readonly lastKnownGood: number;
+    readonly targetGeneration: number;
+    readonly deviceEpoch: number;
+    readonly reset: readonly AutoExposureResetReason[];
+    readonly receipt: AutoExposureReceipt;
+}
+export interface AutoExposureCandidate {
+    readonly ev: number;
+    readonly generation: number;
+    readonly deviceEpoch: number;
+    readonly frameId: number;
+}
+export interface AutoExposureSubmissionMetadata {
+    readonly generation: number;
+    readonly deviceEpoch: number;
+    readonly frameId: number;
+}
+export declare function createAutoExposureState(input: {
+    readonly fallback: number;
+    readonly targetGeneration?: number;
+    readonly deviceEpoch?: number;
+    readonly frameId?: number;
+}): Result<AutoExposureState, AutoExposureInvalidParameterError>;
+export declare function prepareAutoExposureCandidate(state: AutoExposureState, candidate: AutoExposureCandidate): Result<AutoExposureCandidate, AutoExposureStaleGenerationError | AutoExposureInvalidParameterError>;
+/** Publish a candidate only after the owning frame transaction has submitted. */
+export declare function commitAutoExposureCandidate(state: AutoExposureState, candidate: AutoExposureCandidate): AutoExposureState;
+/**
+ * Publish only the successful-submit receipt for the live GPU path.
+ *
+ * The numeric candidate is produced and retained by the GPU state buffer. No
+ * CPU readback is permitted on the frame path, so this transaction helper must
+ * not manufacture an accepted exposure from fallback/LKG data.
+ */
+export declare function commitAutoExposureSubmission(state: AutoExposureState, metadata: AutoExposureSubmissionMetadata): AutoExposureState;
+/** Reset GPU state ownership while retaining the accepted EV as the fallback. */
+export declare function resetAutoExposureState(state: AutoExposureState, reason: AutoExposureResetReason, input: {
+    readonly targetGeneration: number;
+    readonly deviceEpoch: number;
+}): AutoExposureState;
+//# sourceMappingURL=state.d.ts.map

package/dist/pipeline/standard-output/auto-exposure/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/standard-output/auto-exposure/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EACL,iCAAiC,EACjC,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,gCAAgC,EACjC,MAAM,cAAc,CAAC;AAEtB,oFAAoF;AACpF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACnD,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;CACvC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAMD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,MAAM,CAAC,iBAAiB,EAAE,iCAAiC,CAAC,CAiC/D;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,iBAAiB,EACxB,SAAS,EAAE,qBAAqB,GAC/B,MAAM,CACP,qBAAqB,EACrB,gCAAgC,GAAG,iCAAiC,CACrE,CAsBA;AAED,iFAAiF;AACjF,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,iBAAiB,EACxB,SAAS,EAAE,qBAAqB,GAC/B,iBAAiB,CAOnB;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,iBAAiB,EACxB,QAAQ,EAAE,8BAA8B,GACvC,iBAAiB,CAWnB;AAED,iFAAiF;AACjF,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,uBAAuB,EAC/B,KAAK,EAAE;IAAE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACzE,iBAAiB,CAQnB"}

package/dist/pipeline/standard-output/color-transform.d.ts

@@ -0,0 +1,27 @@
+import type { ColorValueDomain } from '@forgeax/engine-render-graph';
+import type { StandardOutputEncoding, StandardOutputLogicalStage } from './types';
+export interface StandardOutputDomainTransition {
+    readonly stage: StandardOutputLogicalStage;
+    readonly input: ColorValueDomain;
+    readonly output: ColorValueDomain;
+}
+export declare const LINEAR_HDR_DOMAIN: ColorValueDomain;
+export declare const LINEAR_LDR_DOMAIN: ColorValueDomain;
+export declare const DISPLAY_ENCODED_DOMAIN: ColorValueDomain;
+/** D65 product white point shared by the Camera output oracle. */
+export declare const D65_TEMPERATURE_KELVIN = 6504;
+export declare const CAMERA_COLOR_LUT_ZERO_COST_STRENGTH = 0;
+export declare function outputEncodingOwner(encoding: StandardOutputEncoding): string;
+export declare function outputEncodingUsesOetf(encoding: StandardOutputEncoding): boolean;
+export type StandardRgb = readonly [number, number, number];
+export type StandardRgba = readonly [number, number, number, number];
+/** Apply the camera's Bradford white-balance adaptation in linear HDR. */
+export declare function applyStandardWhiteBalance(rgb: StandardRgb, temperature: number, tint: number): [number, number, number];
+export interface StandardColorLutData {
+    readonly size: number;
+    /** RGBA half-float texels in z-major, y-major, x-major order. */
+    readonly data: ArrayLike<number>;
+}
+/** CPU reference for the fixed clamp-to-edge, texel-center trilinear LUT sample. */
+export declare function sampleStandardColorLut(data: StandardColorLutData, rgb: StandardRgb, strength?: number, alpha?: number): StandardRgba;
+//# sourceMappingURL=color-transform.d.ts.map

package/dist/pipeline/standard-output/color-transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-transform.d.ts","sourceRoot":"","sources":["../../../src/pipeline/standard-output/color-transform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,KAAK,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAElF,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;CACnC;AAED,eAAO,MAAM,iBAAiB,EAAE,gBAA+B,CAAC;AAChE,eAAO,MAAM,iBAAiB,EAAE,gBAA+B,CAAC;AAChE,eAAO,MAAM,sBAAsB,EAAE,gBAAoC,CAAC;AAE1E,kEAAkE;AAClE,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAC3C,eAAO,MAAM,mCAAmC,IAAI,CAAC;AAErD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,CAE5E;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,OAAO,CAEhF;AAED,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC5D,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAErE,0EAA0E;AAC1E,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,WAAW,EAChB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACX,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAM1B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CAClC;AA+BD,oFAAoF;AACpF,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,oBAAoB,EAC1B,GAAG,EAAE,WAAW,EAChB,QAAQ,SAAI,EACZ,KAAK,SAAI,GACR,YAAY,CAwCd"}

package/dist/pipeline/standard-output/graph.d.ts

@@ -0,0 +1,15 @@
+import { type Result } from '@forgeax/engine-types';
+import type { StandardOutputPlan, StandardOutputRequest } from './types';
+export declare class StandardOutputPlanError extends Error {
+    readonly code: "standard-output-plan-invalid";
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: {
+        readonly field: string;
+        readonly actual: string;
+    };
+    constructor(field: string, actual: string, expected: string);
+}
+export declare function createStandardOutputPlan(input: StandardOutputRequest): StandardOutputPlan;
+export declare function validateStandardOutputPlan(plan: StandardOutputPlan): Result<StandardOutputPlan, StandardOutputPlanError>;
+//# sourceMappingURL=graph.d.ts.map

package/dist/pipeline/standard-output/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../src/pipeline/standard-output/graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAGV,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,SAAS,CAAC;AAEjB,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,EAAG,8BAA8B,CAAU;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;gBAEzD,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAO5D;AAsCD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,qBAAqB,GAAG,kBAAkB,CAwBzF;AAUD,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,kBAAkB,GACvB,MAAM,CAAC,kBAAkB,EAAE,uBAAuB,CAAC,CA0CrD"}

package/dist/pipeline/standard-output/lut-admission.d.ts

@@ -0,0 +1,29 @@
+import type { SamplerDescriptor } from '@forgeax/engine-rhi';
+import type { TextureAsset } from '@forgeax/engine-types';
+import { type Result } from '@forgeax/engine-types';
+export type StandardLutAdmissionErrorCode = 'standard-lut-shape-invalid' | 'standard-lut-limit-exceeded' | 'standard-lut-filter-unavailable' | 'standard-lut-bind-failed';
+export type StandardLutAdmissionError = {
+    readonly code: StandardLutAdmissionErrorCode;
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: Readonly<Record<string, number | string | boolean>>;
+};
+export interface StandardColorLutAdmissionInput {
+    readonly texture: TextureAsset;
+    readonly maxTextureDimension3D: number;
+    readonly rgba16floatFilterable: boolean;
+    readonly bind: () => boolean;
+}
+export interface StandardColorLutAdmission {
+    readonly viewDimension: '3d';
+    readonly extent: Readonly<{
+        width: number;
+        height: number;
+        depth: number;
+    }>;
+    readonly sampler: SamplerDescriptor;
+}
+export declare function createStandardLutSamplerDescriptor(): SamplerDescriptor;
+export declare function lutTexelCenter(index: number, size: number): number;
+export declare function admitStandardColorLut(input: StandardColorLutAdmissionInput): Result<StandardColorLutAdmission, StandardLutAdmissionError>;
+//# sourceMappingURL=lut-admission.d.ts.map

package/dist/pipeline/standard-output/lut-admission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lut-admission.d.ts","sourceRoot":"","sources":["../../../src/pipeline/standard-output/lut-admission.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,MAAM,6BAA6B,GACrC,4BAA4B,GAC5B,6BAA6B,GAC7B,iCAAiC,GACjC,0BAA0B,CAAC;AAE/B,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,CAAC,IAAI,EAAE,6BAA6B,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CACtE,CAAC;AAEF,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;CACrC;AAED,wBAAgB,kCAAkC,IAAI,iBAAiB,CAStE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAElE;AAWD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,8BAA8B,GACpC,MAAM,CAAC,yBAAyB,EAAE,yBAAyB,CAAC,CAgE9D"}

package/dist/pipeline/standard-output/lut-gpu.d.ts

@@ -0,0 +1,48 @@
+import type { AssetRegistry } from '@forgeax/engine-assets-runtime';
+import type { World } from '@forgeax/engine-ecs';
+import type { RenderGraphBuilder, RenderGraphError } from '@forgeax/engine-render-graph';
+import type { BindGroup, BindGroupLayout, RhiDevice, Sampler, Texture, TextureView } from '@forgeax/engine-rhi';
+import { type Handle, type Result } from '@forgeax/engine-types';
+import type { GpuResidencyCache } from '../../device/gpu-residency';
+import type { RenderPipelineFrame, RenderPipelineTarget } from '../../render-pipeline';
+import { type StandardLutAdmissionError, type StandardLutAdmissionErrorCode } from './lut-admission';
+export interface StandardLutGpuResources {
+    readonly texture: Texture;
+    readonly view: TextureView;
+    readonly sampler: Sampler;
+    readonly sourceKey: string;
+    readonly size: number;
+    readonly strength: number;
+    readonly bindGroupLayout: BindGroupLayout;
+    readonly bindGroup: BindGroup;
+}
+export interface StandardLutGraphProjection {
+    readonly view: import('@forgeax/engine-render-graph').GraphTextureView;
+    readonly sampler: Sampler;
+    readonly strength: number;
+    readonly bindGroupLayout: BindGroupLayout;
+    readonly bindGroup: BindGroup;
+}
+export interface StandardLutGpuPreparationInput {
+    readonly world: World;
+    readonly handle: Handle<'TextureAsset', 'shared'>;
+    readonly strength: number;
+    readonly assets: AssetRegistry;
+    readonly gpuStore: GpuResidencyCache;
+    readonly device: RhiDevice;
+}
+/** Release only the projection-owned LUT objects; texture residency is cache-owned. */
+export declare function retireStandardLutGpuResources(_resources: StandardLutGpuResources): void;
+export type StandardLutGpuErrorCode = StandardLutAdmissionErrorCode | 'standard-lut-strength-invalid' | 'standard-lut-catalog-source-missing' | 'standard-lut-residency-failed' | 'standard-lut-not-resident' | 'standard-lut-3d-view-unavailable' | 'standard-lut-sampler-failed' | 'standard-lut-bind-group-layout-failed' | 'standard-lut-bind-failed';
+export interface StandardLutGpuError {
+    readonly code: StandardLutGpuErrorCode;
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: Readonly<Record<string, number | string | boolean>>;
+}
+export type StandardLutPreparationError = StandardLutAdmissionError | StandardLutGpuError;
+/** Resolve, admit, make resident, and bind one ordinary TextureAsset LUT. */
+export declare function prepareStandardLutGpu(input: StandardLutGpuPreparationInput): Result<StandardLutGpuResources, StandardLutPreparationError>;
+/** Record a fullscreen 3D LUT sample into the same Standard graph. */
+export declare function addStandardColorLutPass(graph: RenderGraphBuilder<RenderPipelineFrame>, input: RenderPipelineTarget, output: RenderPipelineTarget, lut: StandardLutGraphProjection): Result<void, RenderGraphError>;
+//# sourceMappingURL=lut-gpu.d.ts.map

package/dist/pipeline/standard-output/lut-gpu.d.ts.map

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

package/dist/pipeline/standard-output/lut-state.d.ts

@@ -0,0 +1,68 @@
+import { type Result } from '@forgeax/engine-types';
+export type StandardLutResetReason = 'device-recovered' | 'resource-removed' | 'validation-failed';
+export type StandardLutStateErrorCode = 'standard-lut-stale-generation' | 'standard-lut-invalid-resident';
+export interface StandardLutStateError {
+    readonly code: StandardLutStateErrorCode;
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: Readonly<Record<string, number | string>>;
+}
+/** Bounded preparation failure retained for recovery and detached inspection. */
+export interface StandardLutFailure {
+    readonly code: string;
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: Readonly<Record<string, number | string | boolean>>;
+}
+export interface StandardLutState {
+    readonly resident: string | null;
+    readonly lastKnownGood: string | null;
+    readonly sourceKey: string | null;
+    readonly targetGeneration: number;
+    readonly deviceEpoch: number;
+    readonly recentFailure?: StandardLutFailure;
+    readonly reset: readonly StandardLutResetReason[];
+    readonly receipt: Readonly<{
+        frameId: number;
+        committed: boolean;
+    }>;
+}
+export interface StandardLutCandidate {
+    readonly resident: string;
+    readonly sourceKey?: string;
+    readonly generation: number;
+    readonly deviceEpoch: number;
+    readonly frameId: number;
+}
+export declare function createStandardLutState(input?: {
+    readonly resident?: string | null;
+    readonly targetGeneration?: number;
+    readonly deviceEpoch?: number;
+    readonly frameId?: number;
+}): StandardLutState;
+export declare function prepareStandardLutCandidate(state: StandardLutState, candidate: StandardLutCandidate): Result<StandardLutCandidate, StandardLutStateError>;
+/** Publish LUT residency only after the owning frame has submitted. */
+export declare function commitStandardLutCandidate(state: StandardLutState, candidate: StandardLutCandidate): StandardLutState;
+/** Keep the accepted/LKG resource while recording a failed replacement. */
+export declare function recordStandardLutFailure(state: StandardLutState, failure: StandardLutFailure): StandardLutState;
+/** Detached, bounded LUT facts for renderer inspection. */
+export interface StandardLutInspection {
+    readonly resident: string | null;
+    readonly lastKnownGood: string | null;
+    readonly sourceKey: string | null;
+    readonly targetGeneration: number;
+    readonly deviceEpoch: number;
+    readonly recentFailure?: StandardLutFailure;
+    readonly reset: readonly StandardLutResetReason[];
+    readonly receipt: Readonly<{
+        frameId: number;
+        committed: boolean;
+    }>;
+}
+export declare function inspectStandardLutState(state: StandardLutState): Readonly<StandardLutInspection>;
+/** Retire device-bound residency while retaining the compatible LKG identity. */
+export declare function resetStandardLutState(state: StandardLutState, reason: StandardLutResetReason, input: {
+    readonly targetGeneration: number;
+    readonly deviceEpoch: number;
+}): StandardLutState;
+//# sourceMappingURL=lut-state.d.ts.map

package/dist/pipeline/standard-output/lut-state.d.ts.map

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

package/dist/pipeline/standard-output/resources.d.ts

@@ -0,0 +1,10 @@
+import type { World } from '@forgeax/engine-ecs';
+import { type Result, RhiError } from '@forgeax/engine-rhi';
+import type { RenderFrameState } from '../../record/frame-snapshot';
+import type { RenderSystemInternals } from '../../record/render-context';
+import type { CameraSnapshot } from '../../render-contract';
+/** Ordinary frames and detached recovery graphs prepare the same output resources. */
+export declare function prepareStandardOutputResources(state: RenderFrameState, internals: RenderSystemInternals, camera: CameraSnapshot | undefined, world: World): Result<void, RhiError>;
+/** Drop lost-device handles without destroying them; retain only reset CPU/LKG facts. */
+export declare function resetStandardOutputForDeviceLoss(state: RenderFrameState, deviceEpoch: number): void;
+//# sourceMappingURL=resources.d.ts.map

package/dist/pipeline/standard-output/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../../src/pipeline/standard-output/resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAW,KAAK,MAAM,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAErE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAS5D,sFAAsF;AACtF,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,gBAAgB,EACvB,SAAS,EAAE,qBAAqB,EAChC,MAAM,EAAE,cAAc,GAAG,SAAS,EAClC,KAAK,EAAE,KAAK,GACX,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CA6ExB;AAED,yFAAyF;AACzF,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,gBAAgB,EACvB,WAAW,EAAE,MAAM,GAClB,IAAI,CAiBN"}

package/dist/pipeline/standard-output/types.d.ts

@@ -0,0 +1,39 @@
+import type { ColorValueDomain } from '@forgeax/engine-render-graph';
+export declare const STANDARD_OUTPUT_LOGICAL_STAGES: readonly ["temporal", "meter", "bloom", "exposure-white-balance", "tone", "lut", "fxaa", "output-encoding"];
+export type StandardOutputLogicalStage = (typeof STANDARD_OUTPUT_LOGICAL_STAGES)[number];
+export type StandardOutputLane = 'direct' | 'clustered';
+export type StandardOutputEncoding = 'explicit-oetf' | 'srgb-attachment';
+export interface StandardColorLutBinding {
+    readonly viewDimension: '3d';
+    readonly size: number;
+    readonly strength: number;
+}
+export interface StandardOutputRequest {
+    readonly lane: StandardOutputLane;
+    readonly temporal: boolean;
+    readonly meter: boolean;
+    readonly bloom: boolean;
+    readonly exposure: boolean;
+    readonly whiteBalance: boolean;
+    readonly lut: boolean;
+    readonly fxaa: boolean;
+    readonly outputEncoding: StandardOutputEncoding;
+}
+export interface StandardOutputPhysicalStage {
+    readonly name: StandardOutputLogicalStage;
+    readonly input: ColorValueDomain;
+    readonly output: ColorValueDomain;
+}
+export interface StandardOutputPlan {
+    readonly lane: StandardOutputLane;
+    readonly features: Readonly<Pick<StandardOutputRequest, 'temporal' | 'meter' | 'bloom' | 'exposure' | 'whiteBalance' | 'lut' | 'fxaa'>>;
+    readonly outputEncoding: StandardOutputEncoding;
+    readonly logicalStages: readonly StandardOutputLogicalStage[];
+    readonly physicalStages: readonly StandardOutputPhysicalStage[];
+    readonly finalWriterCount: 1;
+    readonly outputEncodingCount: 1;
+    readonly incrementalResources: readonly string[];
+    readonly incrementalBindings: number;
+    readonly incrementalTimestamps: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/pipeline/standard-output/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/pipeline/standard-output/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,eAAO,MAAM,8BAA8B,6GASjC,CAAC;AAEX,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,8BAA8B,CAAC,CAAC,MAAM,CAAC,CAAC;AACzF,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,WAAW,CAAC;AACxD,MAAM,MAAM,sBAAsB,GAAG,eAAe,GAAG,iBAAiB,CAAC;AAEzE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,cAAc,EAAE,sBAAsB,CAAC;CACjD;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CACzB,IAAI,CACF,qBAAqB,EACrB,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,cAAc,GAAG,KAAK,GAAG,MAAM,CAC9E,CACF,CAAC;IACF,QAAQ,CAAC,cAAc,EAAE,sBAAsB,CAAC;IAChD,QAAQ,CAAC,aAAa,EAAE,SAAS,0BAA0B,EAAE,CAAC;IAC9D,QAAQ,CAAC,cAAc,EAAE,SAAS,2BAA2B,EAAE,CAAC;IAChE,QAAQ,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC7B,QAAQ,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAChC,QAAQ,CAAC,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IACjD,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;CACxC"}

package/dist/pipeline/standard-pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"standard-pipeline.d.ts","sourceRoot":"","sources":["../../src/pipeline/standard-pipeline.ts"],"names":[],"mappings":"AAMA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAA6B,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,KAAK,EACV,cAAc,EAIf,MAAM,oBAAoB,CAAC;AAsC5B,OAAO,EAGL,oBAAoB,EACpB,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAE5B,iEAAiE;AACjE,eAAO,MAAM,gCAAgC,ykEA6D5C,CAAC;AACF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX,GAAG,MAAM,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,2BAA2B,CAAC,CAkB3E;AA4SD,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,QAAQ,CAAC,QAAQ,EAAE,OAAO,oBAAoB,CAAC;CAChD;AAED,wBAAgB,uCAAuC,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAE1F;AAED,4EAA4E;AAC5E,MAAM,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAiG1C,eAAO,MAAM,gBAAgB,EAAE,gBAG7B,CAAC;AAEH,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"standard-pipeline.d.ts","sourceRoot":"","sources":["../../src/pipeline/standard-pipeline.ts"],"names":[],"mappings":"AAOA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EAA6B,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAIxD,OAAO,KAAK,EACV,cAAc,EAIf,MAAM,oBAAoB,CAAC;AAwC5B,OAAO,EAGL,oBAAoB,EACpB,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAE5B,iEAAiE;AACjE,eAAO,MAAM,gCAAgC,ykEA6D5C,CAAC;AACF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX,GAAG,MAAM,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,2BAA2B,CAAC,CAkB3E;AA2aD,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,QAAQ,CAAC,QAAQ,EAAE,OAAO,oBAAoB,CAAC;CAChD;AAED,wBAAgB,uCAAuC,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAE1F;AAED,4EAA4E;AAC5E,MAAM,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAiG1C,eAAO,MAAM,gBAAgB,EAAE,gBAG7B,CAAC;AAEH,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/pipeline/standard-post.d.ts

@@ -1,4 +1,4 @@
-import type { CompiledRenderGraphInfo } from '@forgeax/engine-render-graph';
+import type { CompiledRenderGraphInfo, GraphTextureView } from '@forgeax/engine-render-graph';
 import { type Result } from '@forgeax/engine-types';
 import type { RenderPipelineBuildContext, RenderPipelineBuildError, RenderPipelineFrame, RenderPipelineTopology } from '../render-pipeline';
 import { type RenderPipelineTarget } from '../render-pipeline';
@@ -43,6 +43,6 @@ export declare function inspectStandardBloomGraph(graph: CompiledRenderGraphInfo
  * path exact-zero while preserving the existing half-resolution four-pass
  * implementation for the enabled path.
  */
-export declare function addStandardPost(context: RenderPipelineBuildContext<RenderPipelineFrame>, topology: RenderPipelineTopology, scene: RenderPipelineTarget, depth: RenderPipelineTarget, surface: StandardPostSurface, sceneTemporal?: RenderPipelineTarget): Result<void, RenderPipelineBuildError>;
+export declare function addStandardPost(context: RenderPipelineBuildContext<RenderPipelineFrame>, topology: RenderPipelineTopology, scene: RenderPipelineTarget, depth: RenderPipelineTarget, surface: StandardPostSurface, sceneTemporal?: RenderPipelineTarget, secondaryReactivity?: GraphTextureView): Result<void, RenderPipelineBuildError>;
 export {};
 //# sourceMappingURL=standard-post.d.ts.map

package/dist/pipeline/standard-post.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"standard-post.d.ts","sourceRoot":"","sources":["../../src/pipeline/standard-post.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAA0B,MAAM,8BAA8B,CAAC;AAEpG,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAK7D,OAAO,KAAK,EACV,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,oBAAoB,EAE1B,MAAM,oBAAoB,CAAC;AAW5B,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;CACxC;AAED,oFAAoF;AACpF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;CAQtC,CAAC;AAEF,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAyCD,8EAA8E;AAC9E,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,uBAAuB,GAAG,SAAS,GACzC,4BAA4B,CA8B9B;AAyBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,0BAA0B,CAAC,mBAAmB,CAAC,EACxD,QAAQ,EAAE,sBAAsB,EAChC,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,mBAAmB,EAC5B,aAAa,CAAC,EAAE,oBAAoB,GACnC,MAAM,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAsOxC"}
+{"version":3,"file":"standard-post.d.ts","sourceRoot":"","sources":["../../src/pipeline/standard-post.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EAEvB,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAK7D,OAAO,KAAK,EACV,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,oBAAoB,EAE1B,MAAM,oBAAoB,CAAC;AAiB5B,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;CACxC;AAED,oFAAoF;AACpF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;CAQtC,CAAC;AAEF,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAyCD,8EAA8E;AAC9E,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,uBAAuB,GAAG,SAAS,GACzC,4BAA4B,CA8B9B;AAyBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,0BAA0B,CAAC,mBAAmB,CAAC,EACxD,QAAQ,EAAE,sBAAsB,EAChC,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,mBAAmB,EAC5B,aAAa,CAAC,EAAE,oBAAoB,EACpC,mBAAmB,CAAC,EAAE,gBAAgB,GACrC,MAAM,CAAC,IAAI,EAAE,wBAAwB,CAAC,CA0XxC"}

package/dist/pipeline-builder.d.ts

@@ -67,6 +67,7 @@ export interface PipelineBuilderContext {
     readonly colorFormat: GPUTextureFormat;
     /** Additional color targets for an MRT pass; the first target is colorFormat. */
     readonly colorFormats?: readonly GPUTextureFormat[] | undefined;
+    readonly fragmentConstants?: Readonly<Record<string, number>> | undefined;
     /** Depth attachment format, or `undefined` for a color-only pass. */
     readonly depthFormat: GPUTextureFormat | undefined;
     /**
@@ -77,7 +78,7 @@ export interface PipelineBuilderContext {
      */
     readonly vertexBuffers: readonly GPUVertexBufferLayout[];
     /** Explicit layout family selected by the renderer assembly. */
-    readonly layoutKind?: 'pbr-skin' | undefined;
+    readonly layoutKind?: 'pbr-skin' | 'gpu-driven-skin' | undefined;
     /** Pipeline label (for GPU debug captures); defaults to `pbr-pipeline-${id}`. */
     readonly label?: string | undefined;
     /**

package/dist/pipeline-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline-builder.d.ts","sourceRoot":"","sources":["../src/pipeline-builder.ts"],"names":[],"mappings":"AA2CA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,cAAc,EAEnB,KAAK,MAAM,EACX,KAAK,SAAS,EACd,QAAQ,EACR,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG9F;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uFAAuF;IACvF,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IACtC;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CACjD;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,kCAAkC;IACjD,kBAAkB,CAAC,IAAI,EAAE;QACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACrC,GAAG,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;CACpC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,mBAAmB,EAAE,kCAAkC,CAAC;IACjE;;;;OAIG;IACH,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC,iFAAiF;IACjF,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,gBAAgB,EAAE,GAAG,SAAS,CAAC;IAChE,qEAAqE;IACrE,QAAQ,CAAC,WAAW,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACnD;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACzD,gEAAgE;IAChE,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAC7C,iFAAiF;IACjF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,CAAC,EAAE;QACtB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;QAChC,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;KACzC,CAAC;CACH;AAED;;;;;;;;;GASG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,IAAI,CAAC,sBAAsB,EAAE,aAAa,GAAG,aAAa,GAAG,cAAc,CAAC,GAChF,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAmDxB;AAMD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,8BAA8B,CAC5C,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,mBAAmB,EAC1B,GAAG,EAAE,sBAAsB,EAC3B,WAAW,CAAC,EAAE,mBAAmB,EACjC,QAAQ,CAAC,EAAE,gBAAgB,EAC3B,WAAW,CAAC,EAAE,MAAM,EACpB,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,QAAQ,GAAE,QAAoB,EAO9B,WAAW,GAAE,MAAU,GACtB,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,CA4MlC"}
+{"version":3,"file":"pipeline-builder.d.ts","sourceRoot":"","sources":["../src/pipeline-builder.ts"],"names":[],"mappings":"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"}

package/dist/pipeline-spec-types.d.ts

@@ -7,6 +7,8 @@ export interface PipelineSpec {
         readonly variantSet: string | undefined;
         readonly vertexEntry?: string;
         readonly fragmentEntry?: string;
+        /** Pipeline-time fragment overrides; not runtime WGSL feature defines. */
+        readonly fragmentConstants?: Readonly<Record<string, number>> | undefined;
     };
     readonly attachments: {
         readonly colorFormats: readonly GPUTextureFormat[];
@@ -19,6 +21,8 @@ export interface PipelineSpec {
         readonly vertexLayout: VertexAttributeMap;
         /** Geometry-owned immutable descriptor projection, when already derived. */
         readonly vertexLayoutProjection?: VertexLayoutProjection | undefined;
+        /** Explicit multi-stream layout supplied by the prepared-graphics owner. */
+        readonly vertexBuffers?: readonly GPUVertexBufferLayout[];
         readonly shaderUvSetCount?: number | undefined;
     };
     readonly renderState: MaterialRenderState | undefined;

package/dist/pipeline-spec-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline-spec-types.d.ts","sourceRoot":"","sources":["../src/pipeline-spec-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;QACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;KACjC,CAAC;IACF,QAAQ,CAAC,WAAW,EAAE;QACpB,QAAQ,CAAC,YAAY,EAAE,SAAS,gBAAgB,EAAE,CAAC;QACnD,QAAQ,CAAC,WAAW,EAAE,gBAAgB,GAAG,SAAS,CAAC;QACnD,QAAQ,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC;KAC7B,CAAC;IACF,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;QACrC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;QAC5D,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;QAC1C,4EAA4E;QAC5E,QAAQ,CAAC,sBAAsB,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;QACrE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAChD,CAAC;IACF,QAAQ,CAAC,WAAW,EAAE,mBAAmB,GAAG,SAAS,CAAC;CACvD"}
+{"version":3,"file":"pipeline-spec-types.d.ts","sourceRoot":"","sources":["../src/pipeline-spec-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;QACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAChC,0EAA0E;QAC1E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;KAC3E,CAAC;IACF,QAAQ,CAAC,WAAW,EAAE;QACpB,QAAQ,CAAC,YAAY,EAAE,SAAS,gBAAgB,EAAE,CAAC;QACnD,QAAQ,CAAC,WAAW,EAAE,gBAAgB,GAAG,SAAS,CAAC;QACnD,QAAQ,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC;KAC7B,CAAC;IACF,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;QACrC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;QAC5D,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;QAC1C,4EAA4E;QAC5E,QAAQ,CAAC,sBAAsB,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;QACrE,4EAA4E;QAC5E,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;QAC1D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAChD,CAAC;IACF,QAAQ,CAAC,WAAW,EAAE,mBAAmB,GAAG,SAAS,CAAC;CACvD"}

package/dist/pipeline-spec.d.ts

@@ -99,15 +99,7 @@ export declare function cacheKeyOf(spec: PipelineSpec): string;
  * by a material variant.
  */
 export declare function variantSetFromVertexLayoutProjection(projection: VertexLayoutProjection, authoredVariantSet: string | undefined): Result<string, VertexColorVariantConflictError>;
-/**
- * Derive the capability axes shared by every Standard PBR draw owner.
- *
- * The all-true key is the canonical empty key used by the shader manifest;
- * every other capability pair stays explicit so a no-local-light frame on a
- * device without storage buffers cannot accidentally select a storage-backed
- * PSO. Vertex-color is supplied here because the empty-key rule is only valid
- * when that geometry-owned axis is also true.
- */
+/** Explicit geometry and lighting facts survive composition before manifest key canonicalization. */
 export declare function standardCapabilityVariantSet(clustered: boolean, storageBuffer: boolean, vertexColorAvailable: boolean): string;
 /**
  * Project the frame-owned Standard topology onto its material variant axes.