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

package/dist/record/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/record/helpers.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,KAAK,IAAI,EAAQ,MAAM,sBAAsB,CAAC;AAKvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACnG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D,uFAAuF;AACvF,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,GACpD,MAAM,GAAG,SAAS,CAQpB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,GAAG,SAAS,EAC9D,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,gBAAgB,CAAC,GAAG,SAAS,GACzD,MAAM,CAGR;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,IAAI,CAAC,gBAAgB,EAAE,6BAA6B,CAAC,EACjE,gBAAgB,EAAE,MAAM,EACxB,WAAW,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC5C,IAAI,CAkBN;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,IAAI,CAAC,gBAAgB,EAAE,uBAAuB,CAAC,EAC3D,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC5C,IAAI,CAkBN;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,IAAI,CAAC,gBAAgB,EAAE,sBAAsB,CAAC,EAC1D,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC5C,IAAI,CAkBN;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,IAAI,CAAC,gBAAgB,EAAE,qBAAqB,CAAC,EACzD,aAAa,EAAE,MAAM,EACrB,mBAAmB,EAAE,MAAM,GAC1B,IAAI,CAUN;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,IAAI,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,EACvD,WAAW,EAAE,MAAM,EACnB,mBAAmB,EAAE,MAAM,GAC1B,IAAI,CAUN;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,qBAAqB,EAChC,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,IAAI,CAAC,gBAAgB,EAAE,sCAAsC,CAAC,EAC1E,cAAc,EAAE,MAAM,GACrB,IAAI,CAgCN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAEzE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAO9D;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAoBpE"}

package/dist/record/main-pass-geometry.d.ts

@@ -0,0 +1,28 @@
+import type { World } from '@forgeax/engine-ecs';
+import { type BindGroup, type RhiRenderPassEncoder } from '@forgeax/engine-rhi';
+import type { PassKind } from '@forgeax/engine-types';
+import type { PointsLinesRecordPlan } from '../points-lines/record';
+import type { MaterialSnapshot } from '../render-system-extract';
+import type { _InternalRenderPipelineContext } from './render-context';
+/**
+ * Issues a prepared Points/Lines draw into the already-open geometry pass.
+ * Pass lifetime, attachments, bind groups, and submission remain owned by the
+ * existing main-pass interpreter.
+ */
+export declare function recordPointsLinesDraw(pass: RhiRenderPassEncoder, plan: PointsLinesRecordPlan): void;
+/**
+ * feat-20260704 M3/w19: per-entity geometry (main colour) draw loop, extracted
+ * verbatim from recordMainPass. Walks `c.validatedOrdered`, selects the
+ * per-entity / per-submesh PBR / unlit / skin pipeline, uploads the per-submesh
+ * material UBO slices, binds view / material / mesh / instances bind groups, and
+ * issues the per-submesh draws into the already-begun geometry `pass`. Fully-
+ * transparent entities are skipped here (drawn in the LDR blend sub-pass);
+ * mixed meshes draw their opaque submeshes here and skip transparent submeshes.
+ * The pass-selector match set, per-entity material-slot start table, MSAA sample
+ * count, Standard group(2) bind group, fallback mesh group(2) bind group, and
+ * the shared per-submesh material BG builder are threaded in explicitly.
+ *
+ * @internal
+ */
+export declare function recordGeometryDraws(c: _InternalRenderPipelineContext, pass: RhiRenderPassEncoder, matchedMaterials: ReadonlyMap<number, ReadonlySet<number>> | null, materialSlotIndices: readonly (readonly number[])[], sampleCount: number, meshGroup2: BindGroup | null, meshBindGroup: BindGroup | null, resolveMaterialBindGroup: (materialSlot: number, submeshMaterial: MaterialSnapshot, entityKey: number, materialWorld: World) => BindGroup, passKind?: PassKind): void;
+//# sourceMappingURL=main-pass-geometry.d.ts.map

package/dist/record/main-pass-geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main-pass-geometry.d.ts","sourceRoot":"","sources":["../../src/record/main-pass-geometry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EACL,KAAK,SAAS,EAId,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,QAAQ,EAAqB,MAAM,uBAAuB,CAAC;AAWzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAGpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAgBjE,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,kBAAkB,CAAC;AA8EvE;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,oBAAoB,EAC1B,IAAI,EAAE,qBAAqB,GAC1B,IAAI,CAON;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,CAAC,EAAE,8BAA8B,EACjC,IAAI,EAAE,oBAAoB,EAC1B,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,EACjE,mBAAmB,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,EACnD,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,SAAS,GAAG,IAAI,EAC5B,aAAa,EAAE,SAAS,GAAG,IAAI,EAC/B,wBAAwB,EAAE,CACxB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,gBAAgB,EACjC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,KAAK,KACjB,SAAS,EACd,QAAQ,GAAE,QAAoB,GAC7B,IAAI,CAgtBN"}

package/dist/record/main-pass-material.d.ts

@@ -0,0 +1,204 @@
+import type { World } from '@forgeax/engine-ecs';
+import { type BindGroup, type BindGroupLayout, type Buffer, type RenderPipeline, type TextureView } from '@forgeax/engine-rhi';
+import type { Handle, MaterialRenderState, ParamSchemaEntry, PrimitiveTopology, TextureAsset } from '@forgeax/engine-types';
+import { derive } from '@forgeax/engine-types';
+import type { GpuResidencyCache } from '../device/gpu-residency';
+import { type SkylightBindGroupResources } from '../ibl/skylight-bind-group';
+import type { MaterialSnapshot } from '../render-system-extract';
+import type { BindGroupCounts, MaterialBgAssemblyCacheEntry } from './frame-snapshot';
+import { type PipelineState, type RenderSystemRuntime } from './render-context';
+/**
+ * Keep line primitives visible when they share a depth plane with filled
+ * geometry. The same topology policy is consumed by the CPU and GPU-driven
+ * raster lanes so a mixed mesh does not change appearance when ownership
+ * moves between them.
+ */
+export declare function geometryRenderStateForTopology(topology: PrimitiveTopology, renderState: MaterialRenderState | undefined): MaterialRenderState | undefined;
+/**
+ * feat-20260604-learn-render-4.10-anti-aliasing-msaa M2 / w9: pick the static
+ * unlit geometry pipeline handle for a (tonemapActive x msaaActive)
+ * combination. The four mode axes (LDR/HDR x single/MSAA) map to the 14 static
+ * pipeline handles built in createRenderer (7 base + 7 count=4 variants). A
+ * pipeline's `multisample.count` must match the colour-attachment sampleCount,
+ * so the count=4 variant is required whenever the camera carries
+ * `antialias === 'msaa'`. Returns null when the requested pipeline was not
+ * built (empty-manifest path / MSAA variant build failure) -- the caller fires
+ * a structured `shader-compile-failed` on the null-narrow.
+ */
+export declare function selectGeometryPipeline(pipelineState: PipelineState, tonemapActive: boolean, msaaActive: boolean): RenderPipeline | null;
+/**
+ * feat-city-glb Bug 5 (per-submesh transparency): true when EVERY submesh
+ * material of the entity is transparent (blend). Used by the geometry pass to
+ * decide whether to skip the whole entity (fully transparent → deferred to the
+ * blend sub-pass) vs. draw its opaque submeshes and skip only the transparent
+ * ones per-submesh.
+ *
+ * Falls back to the entity-level `material.transparent` when `materials` is
+ * absent (single-material entities / test fixtures), byte-identical to the
+ * pre-fix whole-entity gate.
+ *
+ * @internal
+ */
+export declare function isEntityFullyTransparent(source: {
+    readonly material: MaterialSnapshot;
+    readonly materials?: readonly MaterialSnapshot[];
+}): boolean;
+/**
+ * feat-city-glb Bug 5: true when the entity has at least one transparent AND at
+ * least one opaque submesh — i.e. it must be drawn in BOTH the geometry pass
+ * (opaque submeshes) and the blend sub-pass (transparent submeshes). A pure-
+ * opaque or pure-transparent entity returns false (handled by the whole-entity
+ * fast paths).
+ *
+ * @internal
+ */
+export declare function entityHasTransparentSubmesh(source: {
+    readonly material: MaterialSnapshot;
+    readonly materials?: readonly MaterialSnapshot[];
+}): boolean;
+export declare function residentTextureView(world: World, store: GpuResidencyCache, runtime: RenderSystemRuntime, handle: Handle<'TextureAsset', 'shared'>, worldId?: World | number): TextureView | undefined;
+type DynamicTextureStore = import('@forgeax/engine-assets-runtime').DynamicTextureStore;
+export declare function videoTextureView(world: World, store: DynamicTextureStore | undefined, runtime: RenderSystemRuntime, entityKey: number, clip: Handle<'VideoAsset', 'shared'>, highPerfAvailable: boolean): TextureView | undefined;
+export declare const BUILTIN_USER_REGION_TEXTURE_FIELDS: readonly string[];
+/** Derives the logical-content UV scale for an uploaded material texture. */
+export declare function materialTextureUvScale(texture: Pick<TextureAsset, 'width' | 'height' | 'format'> | undefined): readonly [number, number];
+/**
+ * Appends the engine-owned scale for every built-in material texture binding.
+ * Asset dimensions remain logical; this is the sole record-stage projection
+ * from a bound texture asset to its shader sampling coordinates.
+ */
+type MaterialUboPayload = ArrayBuffer | Uint8Array | Float32Array;
+export declare function applyMaterialTextureUvScales(payload: MaterialUboPayload, material: MaterialSnapshot, world: World): void;
+/**
+ * feat-20260621-learn-render-5-5-parallax M2 / w8 (D-3): ordered user-region
+ * texture field names for a material's bind-group assembly, derived from the
+ * shader's paramSchema via the `derive()` SSOT (insertion order = sampler/
+ * texture pair order in derive().bglEntries). Falls back to the built-in 4
+ * fields when the schema is unavailable.
+ */
+export declare function userRegionTextureFieldOrder(schema: Parameters<typeof derive>[0] | undefined): readonly string[];
+/**
+ * feat-20260621-learn-render-5-5-parallax M2 / w8: the fallback texture view
+ * for a user-region field when no handle is provided (graceful, charter P3).
+ * normalTexture decodes to a flat tangent normal; everything else (baseColor,
+ * MR, height, ...) uses the 1x1 white default (height white -> zero displacement).
+ */
+export declare function defaultViewForUserRegionField(field: string, pipelineState: PipelineState): TextureView;
+/**
+ * feat-20260527-sprite-nineslice M4 / w17 (AC-16): once-per-renderable
+ * detection of "Transform.scale below the four 9-slice corner anchors". Pure
+ * helper extracted out of recordFrame so unit tests can drive it without a
+ * GPU device — the recordFrame loop calls this with its `transformWorld` /
+ * `slices` / `renderableIndex` / `seenIndices` / `metrics` arguments.
+ *
+ * The scale-vs-anchor formula mirrors plan-strategy §D-3 — the world x scale must
+ * accommodate `|slices.x| + |slices.z|`, and `scaleY` must accommodate
+ * `|slices.y| + |slices.w|`. Slices ≡ all zero is a no-op (legacy quad
+ * path); a breach increments `nineslice.scale-too-small` exactly once per
+ * `renderableIndex` per RenderSystem lifetime via the `seenIndices` Set
+ * (the same warn-once anchor pattern used for missing-texture sprites).
+ *
+ * @param transformWorld The entity's resolved Transform.world mat4 (16 floats column-major).
+ * @param slices         The four anchor distances `[left, top, right, bottom]`
+ *                       (sentinel `bottom < 0` for tile mode is consumed via abs()).
+ * @param renderableIndex The entity index into the validated renderables list.
+ * @param seenIndices    The per-frame-state guard Set; entries are added on increment.
+ * @param metrics        The owner-provided EngineMetrics counter.
+ * @internal — exported for unit-test access (w17).
+ */
+export declare function detectNineSliceScaleTooSmall(transformWorld: Float32Array, slices: readonly [number, number, number, number], renderableIndex: number, seenIndices: Set<number>, metrics: {
+    increment(name: string): void;
+}): void;
+/**
+ * Build the 128-byte Material UBO payload for a PBR / unlit material entry
+ * (feat-20260527-sprite-nineslice M2 / w11; D-7 regression-net helper).
+ *
+ * Byte-for-byte equivalent to the legacy hard-coded PBR write path; each
+ * deviation is caught by `render-system-record-pbr-ubo-stable.test.ts`.
+ * The schema-driven paramSnapshot overlay (feat-20260523 M9-T05; AC-14)
+ * positions vec4 / f32 slots onto std140 [slot0 vec4, slot1 f32 metallic,
+ * slot1 f32 roughness] mirroring the engine-shipped default-standard-pbr
+ * Material struct.
+ */
+export declare function buildPbrMaterialUboPayload(material: MaterialSnapshot): Uint8Array;
+/**
+ * Write the standard material payload into caller-owned storage.
+ *
+ * The allocating wrapper above remains the byte-stable test/helper surface,
+ * while the frame recorder reuses one scratch slot for all materials. A
+ * scene with thousands of submeshes otherwise allocates one 304-byte
+ * Uint8Array per material per frame, creating avoidable GC pressure without
+ * changing GPU-visible bytes.
+ */
+export declare function writePbrMaterialUboPayload(buf: Uint8Array | Float32Array, material: MaterialSnapshot): void;
+/**
+ * Generic std140 UBO writer driven by `derive(paramSchema).uboLayout.entries`
+ * (feat-20260625-refactor-sprite-as-transparent-mesh M1 / w3, plan-strategy
+ * section 2 D-2).
+ *
+ * For each numeric entry in the schema, looks up the matching value in
+ * `paramSnapshot` and writes it at the std140 offset `derive` computed.
+ * Vec / color entries pull from `paramSnapshot[name]` as a `readonly number[]`
+ * (writes `min(size/4, value.length)` floats, padding with 0 if shorter for
+ * the field's declared width); scalar entries pull a single number.
+ *
+ * Behaviour:
+ *   - schema or snapshot `undefined` -> no writes (caller may keep payload
+ *     baseline).
+ *   - missing snapshot field -> that field's bytes are left untouched
+ *     (overlay semantics; same shape the legacy inline overlay had).
+ *   - field type the writer cannot interpret (texture / sampler / storage_
+ *     buffer / value-type mismatch) -> skipped silently; `derive` strips
+ *     non-numeric entries from `uboLayout.entries` so the loop only iterates
+ *     numeric fields.
+ *
+ * The writer reads `paramSnapshot` only -- it does NOT call
+ * `runtime.assets.get<MaterialAsset>` or cast `firstMaterial`. Gate R-H
+ * (plan-strategy section 5.6) bans those paths through
+ * `scripts/forgeax/check-render-record-no-material-asset-get.mjs`.
+ *
+ * standard-pbr remains byte-identical to `buildPbrMaterialUboPayload`: the
+ * engine's stock PBR material ships `paramSnapshot: undefined`, so this
+ * writer is a no-op on that path; the explicit field writes in the helper
+ * above cover every byte. User shaders (sprite-shaped 4 x vec4 or another
+ * paramSchema) get their fields written at the offsets declared by derive.
+ *
+ * @internal export-for-test (consumed inside `recordFrame` + render-system-
+ * record.test.ts; not part of the package's public surface).
+ */
+export declare function applyParamSnapshotToUbo(payload: MaterialUboPayload, paramSchema: readonly ParamSchemaEntry[] | undefined, paramSnapshot: Readonly<Record<string, number | readonly number[] | string | undefined>> | undefined): void;
+/**
+ * feat-20260704 M3/w19: shared per-submesh material bind-group assembly, hoisted
+ * from the `buildPerSubmeshMaterialBg` closure inside recordMainPass so both the
+ * geometry pass and the LDR blend sub-pass (extracted to separate functions)
+ * call the identical layout.
+ *
+ * feat-city-glb Bug 5 (per-submesh transparency): a transparent PBR submesh
+ * binds the identical metallic/roughness/normal/emissive/occlusion +
+ * Skylight layout the geometry pass uses (the sub-pass previously bound a
+ * sprite-only BG, which cannot render a PBR decal). The per-frame closure state
+ * (runtime / pipelineState / world / store / skylightResources / the shared
+ * material BG cache + counters) is threaded through `deps`; the caller passes
+ * the per-submesh material snapshot + entityKey (video texture routing) and sets
+ * the dynamic UBO offset itself.
+ *
+ * @internal
+ */
+export interface PerSubmeshMaterialBgDeps {
+    readonly runtime: RenderSystemRuntime;
+    readonly pipelineState: PipelineState;
+    readonly world: World;
+    readonly store: GpuResidencyCache;
+    readonly materialSlice: number;
+    readonly videoHighPerfAvailable: boolean;
+    readonly skylightResources: SkylightBindGroupResources;
+    readonly materialBgShared: Map<string, WeakMap<object, unknown>>;
+    /** Cross-frame final BG reuse keyed by the stable source material handle. */
+    readonly materialBgAssemblyCache: Map<string, MaterialBgAssemblyCacheEntry>;
+    readonly bindGroupCounts: BindGroupCounts;
+}
+/** @internal Exported only so buffer-generation invalidation stays regression-tested. */
+export declare function isMaterialBgAssemblyCacheHit(cached: MaterialBgAssemblyCacheEntry | undefined, material: MaterialSnapshot, materialBgl: BindGroupLayout, materialBuffer: Buffer, skylightResources: SkylightBindGroupResources, materialResourceEpoch: number): cached is MaterialBgAssemblyCacheEntry;
+export declare function buildPerSubmeshMaterialBg(deps: PerSubmeshMaterialBgDeps, submeshMaterial: MaterialSnapshot, entityKey: number, materialWorld?: World): BindGroup;
+export {};
+//# sourceMappingURL=main-pass-material.d.ts.map

package/dist/record/main-pass-material.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main-pass-material.d.ts","sourceRoot":"","sources":["../../src/record/main-pass-material.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAgB,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAK/D,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,eAAe,EACpB,KAAK,MAAM,EACX,KAAK,cAAc,EAGnB,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAM7B,OAAO,KAAK,EACV,MAAM,EAEN,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EAEjB,YAAY,EACb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAiD,MAAM,uBAAuB,CAAC;AAC9F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,EAGL,KAAK,0BAA0B,EAChC,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAEtF,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,mBAAmB,EAEzB,MAAM,kBAAkB,CAAC;AA2C1B;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,iBAAiB,EAC3B,WAAW,EAAE,mBAAmB,GAAG,SAAS,GAC3C,mBAAmB,GAAG,SAAS,CAOjC;AAED;;;;;;;;;;GAUG;AAYH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,OAAO,EACtB,UAAU,EAAE,OAAO,GAClB,cAAc,GAAG,IAAI,CAKvB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAClD,GAAG,OAAO,CAOV;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAClD,GAAG,OAAO,CAOV;AAqBD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,QAAQ,CAAC,EACxC,OAAO,GAAE,KAAK,GAAG,MAAc,GAC9B,WAAW,GAAG,SAAS,CAczB;AAqCD,KAAK,mBAAmB,GAAG,OAAO,gCAAgC,EAAE,mBAAmB,CAAC;AA8CxF,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,mBAAmB,GAAG,SAAS,EACtC,OAAO,EAAE,mBAAmB,EAC5B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,EACpC,iBAAiB,EAAE,OAAO,GACzB,WAAW,GAAG,SAAS,CA8CzB;AAMD,eAAO,MAAM,kCAAkC,EAAE,SAAS,MAAM,EAO/D,CAAC;AA2BF,6EAA6E;AAC7E,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC,GAAG,SAAS,GACrE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAG3B;AAWD;;;;GAIG;AACH,KAAK,kBAAkB,GAAG,WAAW,GAAG,UAAU,GAAG,YAAY,CAAC;AASlE,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,kBAAkB,EAC3B,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,KAAK,GACX,IAAI,CAgFN;AAqBD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,GAC/C,SAAS,MAAM,EAAE,CAInB;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,aAAa,GAC3B,WAAW,CAIb;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,4BAA4B,CAC1C,cAAc,EAAE,YAAY,EAC5B,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACjD,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,EACxB,OAAO,EAAE;IAAE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACzC,IAAI,CAaN;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,gBAAgB,GAAG,UAAU,CAIjF;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,UAAU,GAAG,YAAY,EAC9B,QAAQ,EAAE,gBAAgB,GACzB,IAAI,CA4FN;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,kBAAkB,EAC3B,WAAW,EAAE,SAAS,gBAAgB,EAAE,GAAG,SAAS,EACpD,aAAa,EACT,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC,GACzE,SAAS,GACZ,IAAI,CA+BN;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,iBAAiB,EAAE,0BAA0B,CAAC;IACvD,QAAQ,CAAC,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjE,6EAA6E;IAC7E,QAAQ,CAAC,uBAAuB,EAAE,GAAG,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC;IAC5E,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;CAC3C;AAED,yFAAyF;AACzF,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,4BAA4B,GAAG,SAAS,EAChD,QAAQ,EAAE,gBAAgB,EAC1B,WAAW,EAAE,eAAe,EAC5B,cAAc,EAAE,MAAM,EACtB,iBAAiB,EAAE,0BAA0B,EAC7C,qBAAqB,EAAE,MAAM,GAC5B,MAAM,IAAI,4BAA4B,CAcxC;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,wBAAwB,EAC9B,eAAe,EAAE,gBAAgB,EACjC,SAAS,EAAE,MAAM,EACjB,aAAa,GAAE,KAAkB,GAChC,SAAS,CA2KX"}

package/dist/record/main-pass-sprite-draws.d.ts

@@ -0,0 +1,43 @@
+import type { World } from '@forgeax/engine-ecs';
+import { type BindGroup, type RhiRenderPassEncoder } from '@forgeax/engine-rhi';
+import { type SkylightBindGroupResources } from '../ibl/skylight-bind-group';
+import type { InstanceBufferCacheEntry } from '../instance-buffer-cache';
+import type { MaterialSnapshot, SpriteInstancesSnapshot } from '../render-system-extract';
+import type { _InternalRenderPipelineContext } from './render-context';
+export type { SpriteInstancesSnapshot };
+/**
+ * Build the interleaved sprite instance payload consumed by this record owner.
+ * The extract stage validates the two packed arrays before they reach this
+ * function, so the record path has one source of count-mismatch errors.
+ */
+export declare function interleaveSpriteInstanceBuffer(transforms: Float32Array, regions: Float32Array, includePrevious?: boolean): Float32Array;
+/**
+ * Check whether the existing per-entity sprite buffer still matches the
+ * extract snapshot and interleaved byte count.
+ */
+export declare function spriteInstancesCacheHit(entry: InstanceBufferCacheEntry | undefined, snapshot: SpriteInstancesSnapshot, requestedBytes: number): boolean;
+/**
+ * Decide whether the LDR record needs the transparent sprite sub-pass. This
+ * remains beside the sprite record owner so the frame stage and draw stage
+ * share the same transparent-material rule.
+ */
+export declare function computeSplitLdrSprite(validatedOrdered: readonly ({
+    readonly source: {
+        readonly material: MaterialSnapshot;
+        readonly materials?: readonly MaterialSnapshot[];
+    };
+} | undefined)[], tonemapActive: boolean): boolean;
+/**
+ * feat-20260704 M3/w19: LDR sprite split sub-pass, extracted verbatim from
+ * recordMainPass. Runs after the geometry pass when there are sprite / LDR
+ * transparent entities and the split path is active (splitLdrSprite && a raw
+ * unorm swap-chain view exists). Ends the geometry `pass`, opens a `spritePass`
+ * on the resolved transparent-pass view (loadOp=load), draws the sprite / sprite-lit
+ * entities (fold-instanced where possible) then the generic per-submesh
+ * transparent PBR submeshes, and ends the sprite pass. Returns the updated
+ * `geometryPassEnded` flag so the caller skips the unconditional pass.end().
+ *
+ * @internal
+ */
+export declare function recordSpritePass(c: _InternalRenderPipelineContext, pass: RhiRenderPassEncoder, matchedIndices: Set<number> | null, materialSlotIndices: readonly (readonly number[])[], sampleCount: number, resolveMaterialBindGroup: (materialSlot: number, submeshMaterial: MaterialSnapshot, entityKey: number, materialWorld: World) => BindGroup, skylightResources: SkylightBindGroupResources, graphPass?: RhiRenderPassEncoder): boolean;
+//# sourceMappingURL=main-pass-sprite-draws.d.ts.map

package/dist/record/main-pass-sprite-draws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main-pass-sprite-draws.d.ts","sourceRoot":"","sources":["../../src/record/main-pass-sprite-draws.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EACL,KAAK,SAAS,EAId,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAQ7B,OAAO,EAGL,KAAK,0BAA0B,EAChC,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAOzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAU1F,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,kBAAkB,CAAC;AAGvE,YAAY,EAAE,uBAAuB,EAAE,CAAC;AAExC;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,YAAY,EACxB,OAAO,EAAE,YAAY,EACrB,eAAe,UAAQ,GACtB,YAAY,CAoBd;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,wBAAwB,GAAG,SAAS,EAC3C,QAAQ,EAAE,uBAAuB,EACjC,cAAc,EAAE,MAAM,GACrB,OAAO,CAMT;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,gBAAgB,EAAE,SAAS,CACvB;IACE,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;QACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;KAClD,CAAC;CACH,GACD,SAAS,CACZ,EAAE,EACH,aAAa,EAAE,OAAO,GACrB,OAAO,CAYT;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,CAAC,EAAE,8BAA8B,EACjC,IAAI,EAAE,oBAAoB,EAC1B,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,EAClC,mBAAmB,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,EACnD,WAAW,EAAE,MAAM,EACnB,wBAAwB,EAAE,CACxB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,gBAAgB,EACjC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,KAAK,KACjB,SAAS,EACd,iBAAiB,EAAE,0BAA0B,EAC7C,SAAS,CAAC,EAAE,oBAAoB,GAC/B,OAAO,CA4NT"}

package/dist/record/main-pass.d.ts

@@ -0,0 +1,20 @@
+import { type RhiRenderPassEncoder, type TextureView } from '@forgeax/engine-rhi';
+import type { PassKind, PassSelector } from '@forgeax/engine-types';
+import type { _InternalRenderPipelineContext } from './render-context';
+export type MainPassOptions = {
+    readonly colorViews?: readonly (TextureView | null)[];
+    readonly colorFormats?: readonly GPUTextureFormat[];
+    readonly depthView?: TextureView | null;
+    readonly passKind?: PassKind;
+    readonly clearColor?: readonly [number, number, number, number];
+};
+/**
+ * feat-20260529-rendergraph-pass-abstraction M4 / w13b: main forward
+ * (geometry) pass recording, extracted verbatim from recordFrame. Uses the
+ * SHARED frame encoder (c.encoder); the geometry + optional LDR sprite-split
+ * sub-pass write into geometryColorView (HDR target or swap-chain view).
+ * Driven by the render-graph 'main' pass execute closure.
+ */
+export declare function recordMainPass(c: _InternalRenderPipelineContext, selector?: PassSelector, options?: MainPassOptions, graphPass?: RhiRenderPassEncoder): void;
+export declare function encodeMainPass(c: _InternalRenderPipelineContext, pass: RhiRenderPassEncoder, selector?: PassSelector, options?: MainPassOptions): void;
+//# sourceMappingURL=main-pass.d.ts.map

package/dist/record/main-pass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main-pass.d.ts","sourceRoot":"","sources":["../../src/record/main-pass.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAU,QAAQ,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAkB5E,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,kBAAkB,CAAC;AASvE,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC;IACtD,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACpD,QAAQ,CAAC,SAAS,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACjE,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,CAAC,EAAE,8BAA8B,EACjC,QAAQ,CAAC,EAAE,YAAY,EACvB,OAAO,CAAC,EAAE,eAAe,EACzB,SAAS,CAAC,EAAE,oBAAoB,GAC/B,IAAI,CAiiBN;AAED,wBAAgB,cAAc,CAC5B,CAAC,EAAE,8BAA8B,EACjC,IAAI,EAAE,oBAAoB,EAC1B,QAAQ,CAAC,EAAE,YAAY,EACvB,OAAO,CAAC,EAAE,eAAe,GACxB,IAAI,CAEN"}