@forgeax/engine-render 0.1.3 → 0.1.6

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

@@ -1,15 +1,19 @@
 import type { World } from '@forgeax/engine-ecs';
-import { type BindGroup, type BindGroupLayout, type Buffer, type RenderPipeline, type Result, RhiError } from '@forgeax/engine-rhi';
-import type { DerivedMaterialInterface, Handle, MaterialRenderState, PassKind, PrimitiveTopology } from '@forgeax/engine-types';
-import type { DynamicTextureStore } from '../dynamic-texture-store';
-import type { GpuResourceStore } from '../gpu-resource-store';
+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 { PipelineState, RenderSystemRuntime } from '../render-system';
 import type { MaterialSnapshot } from '../render-system-extract';
-import type { MaterialRenderProjection } from '../renderer/material/assembly.js';
-import { type MaterialDrawRoute, type MaterialPipelineMiss, type MaterialPipelineReady, type MaterialReadiness, type MaterialRenderReady } from '../renderer/material/pipeline-projection.js';
 import type { BindGroupCounts, MaterialBgAssemblyCacheEntry } from './frame-snapshot';
-export { applyParamSnapshotToUbo, writeMaterialSnapshotPayload, } from './material-payload';
+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)
@@ -22,23 +26,6 @@ export { applyParamSnapshotToUbo, writeMaterialSnapshotPayload, } from './materi
  * a structured `shader-compile-failed` on the null-narrow.
  */
 export declare function selectGeometryPipeline(pipelineState: PipelineState, tonemapActive: boolean, msaaActive: boolean): RenderPipeline | null;
-/**
- * Resolve a cooked material projection for record. The record stage receives
- * the already-resolved projection and an immutable artifact lookup; it never
- * follows parent GUIDs, reads authored material state, or invokes a compiler.
- * A missing or mismatched artifact is an explicit route miss so callers cannot
- * silently substitute a default shader.
- */
-export declare function selectCookedMaterialPipelineForRender(args: {
-    readonly projection: MaterialRenderProjection;
-    readonly lookupArtifact: (key: string) => import('@forgeax/engine-shader').MaterialRuntimeArtifact | undefined;
-}): MaterialPipelineReady | MaterialPipelineMiss;
-/** Route a record-stage draw through the canonical readiness result. */
-export declare function selectMaterialDrawForRender<TPipeline>(args: {
-    readonly readiness: MaterialReadiness;
-    readonly buildPipeline: (ready: MaterialRenderReady) => TPipeline;
-    readonly reportedDiagnosticKeys: Set<string>;
-}): MaterialDrawRoute<TPipeline>;
 /**
  * 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
@@ -69,49 +56,34 @@ 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];
 /**
- * Selects the PSO for a transparent (or any generic materialShaderId) draw
- * via the runtime's per-MaterialShader pipeline cache. Returns a
- * structured RhiError on cache miss / pending build -- the caller MUST
- * surface this via the error registry rather than substituting a silent
- * fallback (charter P3 explicit failure).
- *
- * The `getMaterialShaderPipeline` argument mirrors
- * {@link RenderSystemRuntime.getMaterialShaderPipeline}'s 9-arg signature
- * but is injected so the helper is unit-testable with a plain
- * `() => null` stand-in. The helper threads only the inputs the caller
- * already has on the dispatch entry -- it never reads from
- * MaterialAsset internals (plan-strategy section 5.6 gate R-H).
- *
- * @internal
+ * 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.
  */
-export declare function selectMaterialPipelineForRender(args: {
-    readonly materialShaderId: string;
-    readonly isHdr: boolean;
-    readonly renderState?: MaterialRenderState | undefined;
-    readonly topology?: PrimitiveTopology | undefined;
-    readonly indexFormat?: 'uint16' | 'uint32' | undefined;
-    readonly variantSet?: string | undefined;
-    readonly sampleCount?: number | undefined;
-    readonly getMaterialShaderPipeline: ((materialShaderId: string, isHdr: boolean, renderState?: MaterialRenderState, topology?: PrimitiveTopology, indexFormat?: 'uint16' | 'uint32', variantSet?: string, passKind?: PassKind, meshAttributes?: import('@forgeax/engine-types').VertexAttributeMap, sampleCount?: number) => RenderPipeline | null) | undefined;
-}): Result<RenderPipeline, RhiError>;
-export declare function residentTextureView(world: World, store: GpuResourceStore, runtime: RenderSystemRuntime, handle: Handle<'TextureAsset', 'shared'>, worldId?: number): any | undefined;
-export declare function videoTextureView(world: World, store: DynamicTextureStore | undefined, runtime: RenderSystemRuntime, entityKey: number, clip: Handle<'VideoAsset', 'shared'>, highPerfAvailable: boolean): any | undefined;
+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). An unavailable schema yields no
- * inferred layout fields.
+ * texture pair order in derive().bglEntries). Falls back to the built-in 4
+ * fields when the schema is unavailable.
  */
-export declare function userRegionTextureFieldOrder(projection: DerivedMaterialInterface | undefined): readonly string[];
+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): any;
+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
@@ -131,12 +103,70 @@ export declare function defaultViewForUserRegionField(field: string, pipelineSta
  *                       (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 per-Renderer EngineMetrics counter.
+ * @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
@@ -158,16 +188,17 @@ export interface PerSubmeshMaterialBgDeps {
     readonly runtime: RenderSystemRuntime;
     readonly pipelineState: PipelineState;
     readonly world: World;
-    readonly store: GpuResourceStore;
+    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<number, MaterialBgAssemblyCacheEntry>;
+    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): BindGroup;
+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

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

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

@@ -1,7 +1,32 @@
+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 { _InternalRenderPipelineContext } from '../render-pipeline-context';
-import type { MaterialSnapshot } from '../render-system-extract';
+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
@@ -14,5 +39,5 @@ import type { MaterialSnapshot } from '../render-system-extract';
  *
  * @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) => BindGroup, skylightResources: SkylightBindGroupResources, graphPass?: RhiRenderPassEncoder): boolean;
+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

@@ -1 +1 @@
-{"version":3,"file":"main-pass-sprite-draws.d.ts","sourceRoot":"","sources":["../../src/record/main-pass-sprite-draws.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,SAAS,EAId,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAC;AAQ7B,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,4BAA4B,CAAC;AAMpC,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAEjF,OAAO,KAAK,EAAE,gBAAgB,EAA2B,MAAM,0BAA0B,CAAC;AAW1F;;;;;;;;;;;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,KACd,SAAS,EACd,iBAAiB,EAAE,0BAA0B,EAC7C,SAAS,CAAC,EAAE,oBAAoB,GAC/B,OAAO,CAiPT"}
+{"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

@@ -1,6 +1,6 @@
 import { type RhiRenderPassEncoder, type TextureView } from '@forgeax/engine-rhi';
 import type { PassKind, PassSelector } from '@forgeax/engine-types';
-import type { _InternalRenderPipelineContext } from '../render-pipeline-context';
+import type { _InternalRenderPipelineContext } from './render-context';
 export type MainPassOptions = {
     readonly colorViews?: readonly (TextureView | null)[];
     readonly colorFormats?: readonly GPUTextureFormat[];

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

@@ -1 +1 @@
-{"version":3,"file":"main-pass.d.ts","sourceRoot":"","sources":["../../src/record/main-pass.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAU,QAAQ,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAM5E,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAiBjF,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,CAghBN;AAED,wBAAgB,cAAc,CAC5B,CAAC,EAAE,8BAA8B,EACjC,IAAI,EAAE,oBAAoB,EAC1B,QAAQ,CAAC,EAAE,YAAY,EACvB,OAAO,CAAC,EAAE,eAAe,GACxB,IAAI,CAEN"}
+{"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;AAiB5E,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,CA+hBN;AAED,wBAAgB,cAAc,CAC5B,CAAC,EAAE,8BAA8B,EACjC,IAAI,EAAE,oBAAoB,EAC1B,QAAQ,CAAC,EAAE,YAAY,EACvB,OAAO,CAAC,EAAE,eAAe,GACxB,IAAI,CAEN"}

package/dist/record/mesh-ssbo.d.ts

@@ -1,5 +1,6 @@
-import type { BindGroup, Buffer, RhiQueue } from '@forgeax/engine-rhi';
-import type { FoldDispatchPlan } from '../render-system-fold';
+import { type BindGroup, type Buffer, RhiError, type RhiQueue } from '@forgeax/engine-rhi';
+import type { DispatchEntry } from '../render-system-extract';
+import { type TransparentSortConfig } from '../systems/transparent-sort-config';
 import type { ValidatedRenderable } from './frame-snapshot';
 /**
  * Stride between per-renderable `entity_world` mat4 slots inside the
@@ -13,6 +14,16 @@ export declare const MESH_SSBO_BYTES = 192;
 export declare const MESH_UBO_FULL_ARRAY_BYTES: number;
 export declare const INSTANCE_UBO_FULL_ARRAY_BYTES: number;
 export declare const MAX_UNIFORM_INSTANCES = 128;
+/** The storage-backed InstanceData layout is current + previous mat4. */
+export declare const INSTANCE_STORAGE_STRIDE_FLOATS = 32;
+/**
+ * Project the ECS transform snapshot into the storage-backed InstanceData
+ * layout. The extract contract carries one current mat4 per instance; until
+ * the ECS snapshot owns a previous-instance column, current is the honest
+ * previous value as well. Uniform-backed variants keep the compact 16-float
+ * payload and do not use this projection.
+ */
+export declare function packInstanceStorageBuffer(transforms: Float32Array): Float32Array;
 /**
  * M3 / w12: extracts the underlying GPU resource object from a bind
  * group entry descriptor. Returns the raw object reference (Buffer,
@@ -169,5 +180,267 @@ export declare function isMeshSsboDevMode(): boolean;
  */
 export declare function uploadMeshSsboBatch(queue: RhiQueue, meshStorageBuffer: {
     readonly buffer: Buffer;
-}, validatedOrdered: readonly ValidatedRenderable[], foldDispatchPlan: FoldDispatchPlan | null, reactiveRevisionChanged?: boolean): void;
+}, validatedOrdered: readonly ValidatedRenderable[], foldDispatchPlan: FoldDispatchPlan | null): void;
+/**
+ * Per-bucket descriptor produced by {@link foldDispatchBuckets}.
+ *
+ * One bucket = one fold-eligible run of consecutive DispatchEntry whose
+ * `(layer, sortKey, materialHandle)` triple is equal. Singleton buckets
+ * (bucketSize=1) appear when the mode bypasses fold (D-5 mode 2/3) or
+ * when consecutive entries differ in one of the three keys.
+ *
+ * Fields:
+ *   - `entries` — original DispatchEntry slice for this bucket (preserves
+ *     the input ordering); the consumer uses these to look up per-entity
+ *     material BG handles, mesh handles (which are bucket-uniform by
+ *     construction since materialHandle key is included), etc.
+ *   - `bucketSize` — `entries.length`. Surfaced as a top-level field so
+ *     the consumer can pass it directly as `instanceCount` to
+ *     `drawIndexed`.
+ *   - `transforms` — assembled Float32Array of bucketSize world mat4s,
+ *     stride=16 floats per instance, column-major. Suitable for direct
+ *     `device.queue.writeBuffer` into an instance buffer used at @group(3).
+ *   - `materialHandle` / `layer` / `sortKey` — the three-tuple key for this
+ *     bucket. `sortKey` is mode-dependent: posZ (world[14]) for mode 0
+ *     (LAYER_Z), posY (world[13]) for mode 1 (LAYER_Y). Consumed by the
+ *     dispatch loop for bind-group selection / sort-stability invariants.
+ */
+export interface FoldBucket {
+    readonly entries: readonly DispatchEntry[];
+    readonly bucketSize: number;
+    readonly transforms: Float32Array;
+    readonly materialHandle: number;
+    readonly layer: number;
+    readonly sortKey: number;
+}
+/**
+ * Minimal renderable shape consumed by the helper. The real
+ * `RenderableSnapshot` carries many more fields; the helper only reads
+ * `transform.world` (a Float32Array of 16 column-major floats) and
+ * `material.transparent` (the LDR-split-sub-pass fold gate, see PR #502
+ * fix + feat-20260625 R2 fix-up: geometry-pass entities — non-transparent
+ * materials — MUST stay singleton because the sprite-pass dispatch path
+ * that consumes `headBuckets` does not run for them; folding them would
+ * overwrite their mesh-SSBO slot with identity and collapse 3D geometry
+ * to origin).
+ *
+ * Production callers pass `RenderableSnapshot[]` straight through —
+ * `RenderableSnapshot.material.transparent` is `boolean | undefined`
+ * (derived by the extract stage from `passes[0].renderState.blend !==
+ * undefined`, the post-feat-20260626-collapse SSOT; see
+ * `MaterialSnapshot.transparent`), structurally compatible with this
+ * minimal shape. The gate read inside the helper uses `=== true` /
+ * `!== true` so both `false` and `undefined` enter the singleton branch.
+ *
+ * feat-20260625-refactor-sprite-as-transparent-mesh R2 fix-up: gate
+ * migrated from `shadingModel === 'sprite'` (the union member was
+ * removed in M3 / w15) to `transparent === true` (the new SSOT for
+ * "routes through the LDR split sub-pass" — same predicate the
+ * `splitLdrSprite` filter at render-system-record.ts:4826/5612 uses).
+ */
+export interface FoldRenderableLike {
+    readonly transform: {
+        readonly world: Float32Array;
+    };
+    readonly material: {
+        readonly transparent?: boolean | undefined;
+    };
+}
+/**
+ * Linear-scan fold operator (plan-strategy D-1).
+ *
+ * Walks `orderedEntries` (must be transparent-sort-ordered when mode=0;
+ * the helper trusts the input ordering and only checks adjacent equality
+ * — non-consecutive entries with equal keys are NOT merged, preserving
+ * stable-sort semantics).
+ *
+ * @param orderedEntries — DispatchEntry[] in transparent-sort order. Empty
+ *   array yields zero buckets (defensive empty-bucket suppression).
+ * @param mode — current `TransparentSortConfig.mode`. Modes 0 (LAYER_Z)
+ *   and 1 (LAYER_Y) enable fold using the appropriate sort-axis coordinate
+ *   (posZ / posY respectively). Modes 2 and 3 produce singleton buckets
+ *   per entry (D-5 bypass).
+ * @param renderables — parallel snapshot array indexed by
+ *   `DispatchEntry.renderableIndex`. The helper reads `transform.world`
+ *   to (a) extract the sort-axis coordinate for the bucket key (posZ
+ *   world[14] for mode 0, posY world[13] for mode 1), and (b) copy 16
+ *   floats per entry into the assembled transforms buffer. Out-of-range /
+ *   missing renderables defensively contribute a zero mat4 slot.
+ * @returns Array of FoldBucket descriptors in input order.
+ */
+export declare function foldDispatchBuckets(orderedEntries: readonly DispatchEntry[], mode: TransparentSortConfig['mode'], renderables: readonly FoldRenderableLike[]): readonly FoldBucket[];
+/**
+ * Per-validatedOrdered-index fold metadata consumed by the record-stage
+ * dispatch loops. Built from {@link foldDispatchBuckets} output by
+ * {@link buildFoldDispatchPlan}; see plan-strategy §3.2 sequence diagram.
+ *
+ * Field semantics (consumer contract, w4-record-swap):
+ *   - `headBuckets[i]` is non-null when validatedOrdered index `i` is the
+ *     **bucket head** of a non-singleton (bucketSize > 1) fold bucket. The
+ *     dispatch loop overrides @group(3) instances BG to a transient buffer
+ *     holding `bucket.transforms` and emits `drawIndexed(idxCount,
+ *     bucket.bucketSize)` instead of per-entity drawIndexed.
+ *   - `skipIndices.has(i)` is true when index `i` is a non-head member of
+ *     a non-singleton fold bucket; the dispatch loop emits `continue`.
+ *   - Singleton buckets (bucketSize === 1) leave both arrays empty for
+ *     that index — dispatch falls through to the existing per-entity path
+ *     byte-identically (mode-bypass / non-foldable head / fold-disabled).
+ *
+ * Note: the maps are keyed on `validatedOrderedIndex`, NOT
+ * `renderableIndex`. The dispatch loops iterate `validatedOrdered` by
+ * positional index `i`, and that index drives mesh SSBO slot offset
+ * (`i * MESH_PER_ENTITY_STRIDE`), material UBO slot, and per-entity bind
+ * group cache keys, all of which the swap must coordinate with.
+ */
+export interface FoldDispatchPlan {
+    readonly headBuckets: ReadonlyMap<number, FoldBucket>;
+    readonly skipIndices: ReadonlySet<number>;
+    readonly foldedBucketCount: number;
+}
+/**
+ * Build the per-validatedOrdered-index fold metadata from a
+ * {@link foldDispatchBuckets} output.
+ *
+ * @param buckets — output of {@link foldDispatchBuckets}; ordered by
+ *   transparent-sort scan order.
+ * @param renderableIndexToValidatedIndex — map from `DispatchEntry.renderableIndex`
+ *   to the validated-ordered index `i` (the loop counter the dispatch
+ *   loops use). Caller builds this once per frame from `validatedOrdered`.
+ * @returns FoldDispatchPlan keyed by validated-ordered index.
+ *
+ * Empty / all-singleton input yields empty maps + `foldedBucketCount=0`,
+ * which the dispatch loops treat as "no fold this frame" — byte-identical
+ * to pre-feat behavior.
+ */
+export declare function buildFoldDispatchPlan(buckets: readonly FoldBucket[], renderableIndexToValidatedIndex: ReadonlyMap<number, number>): FoldDispatchPlan;
+/**
+ * WebGL2 uniform-fallback per-bucket instance-count ceiling
+ * (feat-20260622-chunk-gpu-instancing-sprite-tilemap M2 / D-2 +
+ * research N-1).
+ *
+ * 128 instances * 64 B/mat4 stride = 8192 B, comfortably below the WebGL2
+ * minimum 16384 B UBO size, leaving headroom for the per-frame material
+ * UBO slice. Locked at the type level via `RhiInstancingExceedsUniformCapDetail.limit`
+ * (literal 128) — a future cap change would be a major evolution, not a
+ * runtime knob.
+ */
+export declare const FOLD_UNIFORM_INSTANCE_CAP = 128;
+/**
+ * Minimal `RhiCapabilities` shape consumed by the cap-fallback helper.
+ *
+ * The real `RhiDevice.caps` carries many feature flags; the helper only
+ * reads `storageBuffer` (the WebGL2 / WebGPU split signal — true on
+ * WebGPU + dawn / wgpu native paths, false on the WebGL2 uniform-only
+ * fallback path). Mirrors the field name on the production `RhiCaps`
+ * type so the dispatch site can pass `runtime.device.caps` straight in.
+ */
+export interface FoldCapsLike {
+    readonly storageBuffer: boolean;
+}
+/**
+ * Decision POD returned by {@link evaluateFoldBucketUniformCap}.
+ *
+ * Fields:
+ *   - `fallback` — `true` when the bucket must NOT fold and the dispatch
+ *     site must route it through the per-entity drawIndexed exit (the
+ *     same exit the mode-gate bypass uses, plan-strategy D-9 "shared
+ *     fallback exit"). `false` when the bucket can fold normally.
+ *   - `error` — the structured RhiError to fire alongside the fallback.
+ *     Always populated when `fallback === true`; always `undefined` when
+ *     `fallback === false` (charter proposition 4: explicit failure on
+ *     the failure path; silent success on the success path).
+ *
+ * Caller contract: when `fallback === true`, fire the error via the
+ * runtime error registry AND draw the bucket's entries individually
+ * (each as a 1-instance drawIndexed). Skipping the fallback while still
+ * firing the error would leave the frame visually wrong (uniform buffer
+ * write would clip at 128 entries).
+ */
+export interface FoldBucketCapDecision {
+    readonly fallback: boolean;
+    readonly error: RhiError | undefined;
+}
+/**
+ * Decide whether a fold bucket fits the WebGL2 uniform-fallback per-bucket
+ * instance-count ceiling, returning the structured RhiError + fallback
+ * intent the dispatch site needs to act on
+ * (feat-20260622-chunk-gpu-instancing-sprite-tilemap M2 / w11 +
+ * plan-strategy D-2 + D-9 + AC-05).
+ *
+ * Decision matrix:
+ *
+ * | caps.storageBuffer | bucketSize  | fallback | error |
+ * |:--|:--|:--|:--|
+ * | `true`             | every       | `false`  | `undefined` (WebGPU has no per-binding instance cap inside the storage buffer's `maxStorageBufferBindingSize`; the byte-cap path emits `'limit-exceeded'` separately) |
+ * | `false`            | `<= 128`    | `false`  | `undefined` (fits inside the WebGL2 minimum 16384 B UBO with headroom) |
+ * | `false`            | `> 128`     | `true`   | `RhiError({ code: 'instancing-exceeds-uniform-cap', detail: { requested, limit: 128, scope } })` |
+ *
+ * Singleton buckets (`bucketSize === 1`) always pass — they are the
+ * mode-gate bypass output and never need the cap check (the cap is
+ * about *folded* bucket arity, not about per-entity per-frame work).
+ *
+ * @param bucket — the FoldBucket whose `bucketSize` is the sole input
+ *   (instance count = bucketSize); other fields are not consulted.
+ * @param caps — the runtime's RHI capability flags
+ *   (`runtime.device.caps`); only `storageBuffer` is read.
+ * @param scope — closed `'sprite' | 'tilemap-chunk'` discriminator the
+ *   dispatch site picks based on the call site (sprite-pass primary
+ *   sprite entry vs tilemap-chunk-derived entry). Surfaced verbatim on
+ *   the error's `.detail.scope` so AI users can branch their recovery
+ *   on which dispatch site overflowed.
+ * @returns a {@link FoldBucketCapDecision} POD; never throws.
+ */
+export declare function evaluateFoldBucketUniformCap(bucket: FoldBucket, caps: FoldCapsLike, scope: 'sprite' | 'tilemap-chunk'): FoldBucketCapDecision;
+/**
+ * Closed metric key for the AC-06 fold counter
+ * (feat-20260622-chunk-gpu-instancing-sprite-tilemap M3 / D-3).
+ *
+ * Semantics — count of instanced `drawIndexed` calls the fold operator
+ * emits this frame; one increment per non-singleton head bucket retained
+ * after the M2 / w11 cap-fallback filter. NOT entity count, NOT pre-
+ * filter bucket count — cap-overrun buckets that the dispatch site
+ * routed through the per-entity fallback exit do not count.
+ *
+ * Naming follows the EngineMetrics dot-namespace convention
+ * (`<feature>.<event>`); `render.instancing.*` covers both sprite and
+ * tilemap-chunk dispatch sites without scope ambiguity (research F-5,
+ * plan-strategy §8.2). The owning host evidence reads
+ * `ownerMetrics.snapshot()['render.instancing.foldedDraws']`.
+ */
+export declare const FOLDED_DRAWS_METRIC_KEY = "render.instancing.foldedDraws";
+/**
+ * Minimal `EngineMetrics` shape consumed by {@link incrementFoldedDrawsMetric}.
+ *
+ * The real `EngineMetrics` carries `snapshot()` + `reset()` too; the
+ * helper only writes, so the consumed surface narrows to a single
+ * method. Lets the unit test inject a `vi.fn()` mock without faking the
+ * read APIs.
+ */
+export interface FoldMetricsLike {
+    increment(name: string): void;
+}
+/**
+ * Bump the AC-06 `render.instancing.foldedDraws` counter once per fold-
+ * eligible head bucket in `plan` (M3 / w13, plan-strategy D-3).
+ *
+ * Single counter-write site for the metric — the record-stage consumer
+ * calls this once per `recordFrame` after the cap-fallback filter
+ * (M2 / w11) so cap-overrun buckets do not contribute (their members
+ * fall through to per-entity drawIndexed, which is not an instanced
+ * draw). `plan.foldedBucketCount` is the SSOT for "how many instanced
+ * drawIndexed will this frame emit"; passing the same plan to this
+ * helper keeps the metric and the actual dispatch in lockstep.
+ *
+ * Mode-bypass plans (D-5: mode != 0 yields singleton-only buckets which
+ * `buildFoldDispatchPlan` filters out) carry `foldedBucketCount === 0`
+ * and produce no increments — per-entity drawIndexed is not folded so
+ * the metric correctly stays at 0.
+ *
+ * @param plan — output of {@link buildFoldDispatchPlan} after possible
+ *   cap-fallback filtering by the record-stage consumer.
+ * @param metrics — the owner-provided EngineMetrics counter; only
+ *   `increment(name)` is called. Empty `plan.foldedBucketCount === 0`
+ *   produces zero calls (no metric churn for fold-disabled frames).
+ */
+export declare function incrementFoldedDrawsMetric(plan: FoldDispatchPlan, metrics: FoldMetricsLike): void;
 //# sourceMappingURL=mesh-ssbo.d.ts.map

package/dist/record/mesh-ssbo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mesh-ssbo.d.ts","sourceRoot":"","sources":["../../src/record/mesh-ssbo.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mesh-ssbo.d.ts","sourceRoot":"","sources":["../../src/record/mesh-ssbo.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,MAAM,EAAE,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC3F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAO1C,eAAO,MAAM,eAAe,MAAM,CAAC;AAMnC,eAAO,MAAM,yBAAyB,QAAY,CAAC;AAOnD,eAAO,MAAM,6BAA6B,QAAW,CAAC;AAEtD,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,yEAAyE;AACzE,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,YAAY,GAAG,YAAY,CAahF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;CAC5C,GAAG,MAAM,CAMT;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,SAAS,EACxB,MAAM,EAAE;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAClD,SAAS,CA0BX;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxD,QAAQ,EAAE,MAAM,GAAG,MAAM,EACzB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,SAAS,EACxB,MAAM,EAAE;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAClD,SAAS,CAOX;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC5C,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,GAC/B,IAAI,CAMN;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE;IACT,QAAQ,CAAC,YAAY,CAAC,EAClB,CAAC,CAAC,WAAW,EAAE,MAAM,KACjB;QAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;KAAE,GACrB;QACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;QACnB,QAAQ,CAAC,IAAI,EAAE,2BAA2B,GAAG,6BAA6B,CAAC;QAC3E,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;KACtC,CAAC,GACN,SAAS,CAAC;IACd,QAAQ,CAAC,aAAa,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;CACrE,EACD,WAAW,EAAE,MAAM,GAEjB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;CAAE,GACrB;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,2BAA2B,GAAG,6BAA6B,CAAC;IAC3E,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC,CAiCJ;AAYD;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,CAAC,MAAM,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,CAExF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAa3C;AAWD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,QAAQ,EACf,iBAAiB,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC9C,gBAAgB,EAAE,SAAS,mBAAmB,EAAE,EAChD,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,GACxC,IAAI,CAqDN;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;KAAE,CAAC;IACrD,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;KAAE,CAAC;CACnE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,SAAS,aAAa,EAAE,EACxC,IAAI,EAAE,qBAAqB,CAAC,MAAM,CAAC,EACnC,WAAW,EAAE,SAAS,kBAAkB,EAAE,GACzC,SAAS,UAAU,EAAE,CA8GvB;AA+CD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACtD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,+BAA+B,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3D,gBAAgB,CAqBlB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,QAAQ,GAAG,eAAe,GAChC,qBAAqB,CAgBvB;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,uBAAuB,kCAAkC,CAAC;AAEvE;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAIjG"}