@forgeax/engine-render 0.1.4 → 0.1.7

package/dist/pipeline-spec.d.ts

@@ -1,7 +1,7 @@
 import { type VertexLayoutProjection } from '@forgeax/engine-geometry';
-import { type RegisteredMaterialShaderEntry, type ShaderRegistry } from '@forgeax/engine-shader';
-import { type BindGroupLayoutEntry, KNOWN_PASS_KINDS, type MaterialRenderState, type ParamSchemaEntry, type PrimitiveTopology, type VertexAttributeMap } from '@forgeax/engine-types';
-import { type PbrCaps } from './pbr-pipeline';
+import { KNOWN_PASS_KINDS, type MaterialRenderState, type Result } from '@forgeax/engine-types';
+import { VertexColorVariantConflictError } from './errors/render';
+export { type BglKind, type BindGroupLayoutDescriptorOutput, buildBindGroupLayoutDescriptor, createHdrpBindGroupLayoutDescriptor, } from './pbr-pipeline';
 export { KNOWN_PASS_KINDS };
 /**
  * The engine-owned deferred material target layout. `fs_gbuffer` returns
@@ -21,54 +21,13 @@ export declare function colorFormatsForPassKind(passKind: string, defaultColorFo
  * - `renderState`: optional per-material render-state overrides (blend/cull/depth/stencil)
  *
  * Business-agnostic: no `'pbr'` / `'sprite'` / `'skybox'` strings pollute this
- * type. BGL shape taxonomy is derived from `ShaderRegistry` internal reflection
+ * type. BGL shape taxonomy is derived from `ShaderCatalog` internal reflection
  * and never appears on the spec surface (plan-strategy D-7).
  *
  * @see plan-strategy §1 (4-axis) · D-7 (business-agnostic) · requirements §3.1
  */
-export interface PipelineSpec {
-    /** Shader identity + routing axis. */
-    readonly shader: {
-        /** Registered shader identifier (e.g. `'forgeax::default-standard-pbr'`). */
-        readonly id: string;
-        /** Pass kind for attachment shape selection. Must be in {@link KNOWN_PASS_KINDS} or registered. */
-        readonly passKind: string;
-        /** Shader variant set string (e.g. `'SKIN_AVAILABLE=1'`). `undefined` for no variant. */
-        readonly variantSet: string | undefined;
-        /** Fragment entry point; omitted means the shader's standard `fs_main`. */
-        readonly fragmentEntry?: string | undefined;
-    };
-    /** Attachment format + sample-count axis. */
-    readonly attachments: {
-        /** Colour attachment formats in draw order. Empty for depth-only passes (shadow-caster). */
-        readonly colorFormats: readonly GPUTextureFormat[];
-        /** Depth-stencil format, or `undefined` when no depth target is bound. */
-        readonly depthFormat: GPUTextureFormat | undefined;
-        /** Sample count: 1 (no MSAA) or 4 (4x MSAA). */
-        readonly sampleCount: 1 | 4;
-    };
-    /** Geometry layout axis. */
-    readonly geometry: {
-        /** Primitive topology baked into the PSO. */
-        readonly topology: PrimitiveTopology;
-        /** Strip index format (uint16 / uint32), only meaningful for strip topologies. */
-        readonly stripIndexFormat?: 'uint16' | 'uint32' | undefined;
-        /** Per-vertex attribute layout (position / normal / uv / tangent / skinIndex / skinWeight). */
-        readonly vertexLayout: VertexAttributeMap;
-        /** Canonical geometry-owned projection; derived when omitted for legacy callers. */
-        readonly vertexLayoutProjection?: VertexLayoutProjection | undefined;
-        /**
-         * Number of UV sets declared by the shader (derived from @location reflection).
-         * Forwarded to deriveVertexBufferLayout for clamp-to-last alias (D-1 / D-4).
-         * Undefined = fallback to mesh-provided UV count (no clamping).
-         * feat-20260629-multi-uv-set-support m3-w5: plumbed placeholder.
-         * TODO(M4/m4-w3): fill from naga reflection JSON when available.
-         */
-        readonly shaderUvSetCount?: number | undefined;
-    };
-    /** Per-material render-state overrides (optional — engine defaults applied when absent). */
-    readonly renderState: MaterialRenderState | undefined;
-}
+export type { PipelineSpec } from './pipeline-spec-types';
+import type { PipelineSpec } from './pipeline-spec-types';
 /**
  * Closed union of PipelineSpec error codes.
  *
@@ -81,7 +40,7 @@ export interface PipelineSpec {
  *
  * 2 transit codes:
  * - `'pipeline-build-failed'`: wraps RhiError from device.createRenderPipeline
- * - `'shader-not-registered'`: ShaderRegistry.lookup returned undefined
+ * - `'shader-not-registered'`: ShaderCatalog lookup returned undefined
  *
  * @see requirements §3.4 · AC-10 · charter P3
  */
@@ -114,36 +73,6 @@ export declare class PipelineSpecError extends Error {
         hint?: string;
     });
 }
-/**
- * Bind group layout shape derived from ShaderRegistry reflection.
- *
- * `entries` mirrors `GPUBindGroupLayoutDescriptor.entries` — the binding
- * slot layout the shader expects for a given variantSet.
- */
-export interface BindGroupLayoutShape {
-    readonly entries: readonly BindGroupLayoutEntry[];
-}
-/**
- * Derive BGL shape from a registered shader entry's paramSchema.
- *
- * Pure function: same `entry` always yields the same shape (no variant-set
- * dispatch — that role moved into `BglKind` after D-13's closed-union
- * dispatch landed; see plan-decisions.md). The `_variantSet` parameter is
- * preserved for backward signature compat but ignored — variant routing is
- * now explicit at the BglKind level (see `buildBindGroupLayoutDescriptor`
- * arms `pbr-skin-mesh-array` vs `hdrp-7-slot` vs `pbr-mesh-array`).
- *
- * This helper lives in `pipeline-spec.ts` (not ShaderRegistry) per D-1:
- * it wraps the existing `derive(paramSchema).bglEntries` from
- * `@forgeax/engine-types` so cacheKeyOf can hash BGL shape deterministically
- * without expanding the ShaderRegistry public interface.
- *
- * @param entry - material shader entry from ShaderRegistry.findMaterialArtifact
- * @param _variantSet - unused (post D-13); kept for backward signature compat
- * @returns the BGL shape for the given entry
- * @see plan-decisions.md D-13
- */
-export declare function deriveBglShapeFromShader(entry: RegisteredMaterialShaderEntry, _variantSet?: string | undefined): BindGroupLayoutShape;
 /**
  * Deterministic hash suffix for MaterialRenderState (sorted keys, JSON.stringify).
  *
@@ -154,7 +83,7 @@ export declare function renderStateHash(renderState: MaterialRenderState | undef
 /**
  * Compute a deterministic cache key from a PipelineSpec.
  *
- * The key covers all 4 axes + BGL shape hash (derived from ShaderRegistry
+ * The key covers all 4 axes + BGL shape hash (derived from ShaderCatalog
  * reflection via {@link deriveBglShapeFromShader}). Two specs that produce
  * the same cache key MUST produce byte-identical PSO descriptors.
  *
@@ -164,6 +93,12 @@ export declare function renderStateHash(renderState: MaterialRenderState | undef
  * @see plan-strategy §3.1 · requirements AC-02
  */
 export declare function cacheKeyOf(spec: PipelineSpec): string;
+/**
+ * Reconcile the authored vertex-color shader axis with the geometry-owned
+ * projection. COLOR_0 is a geometry fact and cannot be selected independently
+ * by a material variant.
+ */
+export declare function variantSetFromVertexLayoutProjection(projection: VertexLayoutProjection, authoredVariantSet: string | undefined): Result<string, VertexColorVariantConflictError>;
 /**
  * Build a `GPURenderPipelineDescriptor` from a PipelineSpec + shader modules.
  *
@@ -184,69 +119,6 @@ export declare function buildPipelineDescriptor(spec: PipelineSpec, modules: {
     fragmentEntryPoint?: string;
     layout?: unknown;
 }): Record<string, unknown>;
-/**
- * Closed union of bind-group-layout shapes the runtime constructs.
- *
- * Each kind names one physically distinct BGL the runtime has historically
- * built by hand. {@link buildBindGroupLayoutDescriptor} dispatches on this
- * union so every `device.createBindGroupLayout(...)` call site shares one
- * SSOT for entries / labels (plan-strategy §3.2; D-13 round-2 decision).
- *
- * Three groups by derivation source:
- * 1. Shader-derived (paramSchema reflection + injection chain):
- *    - `'pbr-material-merged'` — derived user region + Skylight 7 + lightmap 4
- *    - `'unlit-material'` — 7 entries: base PBR material only (no inject)
- *    - `'hdrp-7-slot'` — 7 entries (binding 0 + 3..8): HDRP cluster + SSAO group(2) BGL
- * 2. Caps-driven literal shapes (no shader):
- *    - `'pbr-view'` — 10 entries: view UBO + lights + 6 shadow bindings
- *      (directional 3/4, point 5/6, cascade 7, spot atlas 8, spot
- *      lightViewProj matrices 9 — feat-20260625)
- *    - `'pbr-mesh-array'` — 1 entry: per-entity mesh SSBO (dynamic-offset)
- *    - `'pbr-instances'` — 1 entry: per-instance SSBO (no dynamic-offset)
- *    - `'pbr-skin-mesh-array'` — 3 entries: meshes + current/previous skin palettes
- * 3. Attachment-driven (fullscreen post-process):
- *    - `'fullscreen-post'` — 2 entries: input texture + sampler. The texture
- *      `sampleType` is derived from `spec.attachments` (plan §R3 fix):
- *      `'depth32float'` → `'depth'`; `'r32float'` → `'unfilterable-float'`;
- *      else → `'float'`.
- *    - `'fullscreen-post-with-params'` — 3 entries: the same texture@0 +
- *      sampler@1 as `'fullscreen-post'`, plus a `buffer@2` uniform for the
- *      per-frame params UBO (feat-20260621 D-2: `entry.params !== undefined`
- *      passes route here; the layout stays group(1), q3=B). `'fullscreen-post'`
- *      stays byte-identical so param-less consumers degrade with no change.
- *    - `'fullscreen-post-with-scene-depth-msaa'` — the depth-read layout with
- *      `texture.multisampled=true`, selected for a 4-sample scene depth target.
- */
-export type BglKind = 'pbr-view' | 'pbr-material-merged' | 'pbr-mesh-array' | 'pbr-instances' | 'pbr-skin-mesh-array' | 'unlit-material' | 'hdrp-7-slot' | 'fullscreen-post' | 'fullscreen-post-with-params' | 'fullscreen-post-with-scene-depth' | 'fullscreen-post-with-scene-depth-msaa' | 'fullscreen-post-with-gbuffer-depth';
-/**
- * Output shape of {@link buildBindGroupLayoutDescriptor}: matches the RHI
- * `BindGroupLayoutDescriptor` (label + entries with `ExplicitUndefined`) so
- * the result can be passed directly to `device.createBindGroupLayout(...)`.
- *
- * `entries` is a mutable `Array` to match `GPUBindGroupLayoutDescriptor`
- * (WebGPU types declare it mutable). Callers MUST treat the array as
- * read-only — the dispatcher freezes neither the array nor its entries
- * for hot-path performance.
- */
-export interface BindGroupLayoutDescriptorOutput {
-    readonly label: string | undefined;
-    readonly entries: GPUBindGroupLayoutEntry[];
-}
-export declare function buildBindGroupLayoutDescriptor(spec: PipelineSpec, options: {
-    kind: BglKind;
-    registry?: ShaderRegistry;
-    caps?: PbrCaps;
-    /**
-     * Material paramSchema for the per-shader user-region derivation
-     * (`'pbr-material-merged'` / `'unlit-material'`). When supplied it is the
-     * authoritative source for the user-region BGL shape (D-1); when omitted,
-     * `buildPbrMaterialUserRegionEntries` falls back to the built-in
-     * standard-PBR 4-texture schema (user region is 9 entries), so
-     * the caps-driven `buildPbrPipelineLayouts` seam keeps working unchanged.
-     * A registry + resolvable shader id takes precedence over this field.
-     */
-    materialParamSchema?: readonly ParamSchemaEntry[];
-}): BindGroupLayoutDescriptorOutput;
 /**
  * Default colour-attachment ops carried by a passKind policy.
  *
@@ -329,7 +201,7 @@ export declare const passKindPolicyTable: Readonly<Record<string, PassKindAttach
  *
  * Stencil-op gate is auto-derived from `specAttachments.depthFormat`:
  * - `'depth24plus-stencil8'` → emits `stencilLoadOp:'clear', stencilStoreOp:'discard'`
- * - any other depth format → omits stencil ops entirely
+ * - every other depth format → omits stencil ops entirely
  *
  * This collapses the R3/R5 stencil-op duplicates that previously lived inline
  * at every forward-pass beginRenderPass site.
@@ -354,17 +226,6 @@ export declare function buildBeginRenderPassDescriptor(specAttachments: Pipeline
     readonly depthStoreOp?: 'store' | 'discard';
     readonly label?: string;
 }): Record<string, unknown>;
-/**
- * Dev-mode equality check: two PipelineSpec instances are structurally equal
- * when every axis field is `===` (shallow compare).
- *
- * Not intended for runtime hot paths — use `cacheKeyOf(a) === cacheKeyOf(b)`
- * for cache-hit checks. This function exists for dev-time assertions
- * (`assert(specsEqual(specA, specB))`) and unit-test round-trip verification.
- *
- * @see plan-strategy §3.2 · requirements AC-02
- */
-export declare function specsEqual(a: PipelineSpec, b: PipelineSpec): boolean;
 /**
  * Validate a PipelineSpec before attempting to build.
  *
@@ -464,7 +325,7 @@ export declare function getOrBuildPipeline(spec: PipelineSpec, deviceProvider: P
  *   - sprite goes through `getMaterialShaderPipeline('forgeax::sprite', ...)`
  *     lazily at first transparent-LDR-split draw — no boot-time pre-warm.
  *   - HDRP variant (`variantSet=''` or compound `=true` form) is registered
- *     lazily on `installPipeline(hdrpAsset)`, not at boot — adding HDRP
+ *     lazily when the clustered Standard profile activates, not at boot — adding clustered
  *     prewarm here would build PSOs against the URP layout (the boot-time
  *     `pbrModule` is the URP variant when `isHdrpActive=false`)
  *

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

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

package/dist/plugin.d.ts

@@ -1,17 +1,4 @@
 import type { Plugin } from '@forgeax/engine-plugin';
-import type { RenderFeature } from './features';
-import type { Renderer } from './renderer';
-declare module '@forgeax/engine-plugin' {
-    interface EngineContextServices {
-        renderer?: Renderer;
-    }
-}
-/** Install the built-in render and authoring component vocabulary in one World. */
+/** Install the built-in render ECS vocabulary in one World. */
 export declare function renderComponentsPlugin(): Plugin;
-/** Provide the renderer without transferring its host-owned lifetime. */
-export declare function rendererPlugin(renderer: Renderer): Plugin;
-/** Provide an App/Worker-owned Renderer and release it after dependent Fibers. */
-export declare function ownedRendererPlugin(renderer: Renderer): Plugin;
-/** Install a producer at Renderer safe points and remove it with the owning Fiber. */
-export declare function renderFeaturePlugin(feature: RenderFeature<unknown>): Plugin;
 //# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AA2BrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAiD3C,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAU,qBAAqB;QAC7B,QAAQ,CAAC,EAAE,QAAQ,CAAC;KACrB;CACF;AAED,mFAAmF;AACnF,wBAAgB,sBAAsB,IAAI,MAAM,CAS/C;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAQzD;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAS9D;AAED,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,MAAM,CAgB3E"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AA0DrD,+DAA+D;AAC/D,wBAAgB,sBAAsB,IAAI,MAAM,CAQ/C"}

package/dist/points-lines/__tests__/bounds.unit.test.d.ts

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

package/dist/points-lines/__tests__/bounds.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounds.unit.test.d.ts","sourceRoot":"","sources":["../../../src/points-lines/__tests__/bounds.unit.test.ts"],"names":[],"mappings":""}

package/dist/points-lines/__tests__/cache-recovery.unit.test.d.ts

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

package/dist/points-lines/__tests__/cache-recovery.unit.test.d.ts.map

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

package/dist/points-lines/__tests__/inspection-lanes.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=inspection-lanes.integration.test.d.ts.map

package/dist/points-lines/__tests__/inspection-lanes.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspection-lanes.integration.test.d.ts","sourceRoot":"","sources":["../../../src/points-lines/__tests__/inspection-lanes.integration.test.ts"],"names":[],"mappings":""}

package/dist/points-lines/__tests__/inspection.unit.test.d.ts

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

package/dist/points-lines/__tests__/inspection.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspection.unit.test.d.ts","sourceRoot":"","sources":["../../../src/points-lines/__tests__/inspection.unit.test.ts"],"names":[],"mappings":""}

package/dist/points-lines/__tests__/lane-structural.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lane-structural.integration.test.d.ts.map

package/dist/points-lines/__tests__/lane-structural.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lane-structural.integration.test.d.ts","sourceRoot":"","sources":["../../../src/points-lines/__tests__/lane-structural.integration.test.ts"],"names":[],"mappings":""}

package/dist/points-lines/__tests__/points-lines.bench.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=points-lines.bench.d.ts.map

package/dist/points-lines/__tests__/points-lines.bench.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"points-lines.bench.d.ts","sourceRoot":"","sources":["../../../src/points-lines/__tests__/points-lines.bench.ts"],"names":[],"mappings":""}

package/dist/points-lines/__tests__/raster-lane.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=raster-lane.integration.test.d.ts.map

package/dist/points-lines/__tests__/raster-lane.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raster-lane.integration.test.d.ts","sourceRoot":"","sources":["../../../src/points-lines/__tests__/raster-lane.integration.test.ts"],"names":[],"mappings":""}

package/dist/points-lines/__tests__/snapshot.unit.test.d.ts

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

package/dist/points-lines/__tests__/snapshot.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.unit.test.d.ts","sourceRoot":"","sources":["../../../src/points-lines/__tests__/snapshot.unit.test.ts"],"names":[],"mappings":""}

package/dist/points-lines/__tests__/view-ubo.unit.test.d.ts

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

package/dist/points-lines/__tests__/view-ubo.unit.test.d.ts.map

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

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

@@ -0,0 +1,36 @@
+import { type MaterialAsset, type MeshAsset, type Result } from '@forgeax/engine-types';
+import { type PointShape } from '../components/points';
+import type { PointsLinesBudgetExceededError, PointsLinesInvalidStyleError, PointsLinesMaterialUnsupportedError, PointsLinesStyleUnsupportedError, PointsLinesTopologyMismatchError } from '../errors/render';
+export interface PointsStyleInput {
+    readonly sizePx?: number;
+    readonly shape?: number;
+}
+export interface LinesStyleInput {
+    readonly widthPx?: number;
+}
+export interface PointsLinesAdmissionLimits {
+    readonly maxPoints?: number;
+    readonly maxSegments?: number;
+}
+export interface PointsLinesAdmissionInput {
+    readonly entity: number;
+    readonly points?: PointsStyleInput;
+    readonly lines?: LinesStyleInput;
+    readonly mesh: MeshAsset;
+    readonly material: MaterialAsset;
+    readonly limits?: PointsLinesAdmissionLimits;
+    readonly materialId?: string;
+}
+export interface PointsLinesAdmission {
+    readonly component: 'Points' | 'Lines';
+    readonly shape?: PointShape;
+    readonly sizePx?: number;
+    readonly widthPx?: number;
+    readonly pointCount: number;
+    readonly segmentCount: number;
+    readonly submeshes: readonly number[];
+}
+export type PointsLinesAdmissionError = PointsLinesInvalidStyleError | PointsLinesTopologyMismatchError | PointsLinesStyleUnsupportedError | PointsLinesMaterialUnsupportedError | PointsLinesBudgetExceededError;
+/** Validate one complete Points/Lines candidate before any renderer publication. */
+export declare function admitPointsLines(input: PointsLinesAdmissionInput): Result<PointsLinesAdmission, PointsLinesAdmissionError>;
+//# sourceMappingURL=admission.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"admission.d.ts","sourceRoot":"","sources":["../../src/points-lines/admission.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,aAAa,EAAE,KAAK,SAAS,EAAM,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACjG,OAAO,EAAE,KAAK,UAAU,EAAsC,MAAM,sBAAsB,CAAC;AAC3F,OAAO,KAAK,EACV,8BAA8B,EAC9B,4BAA4B,EAC5B,mCAAmC,EACnC,gCAAgC,EAChC,gCAAgC,EACjC,MAAM,kBAAkB,CAAC;AAS1B,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,0BAA0B,CAAC;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,QAAQ,GAAG,OAAO,CAAC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED,MAAM,MAAM,yBAAyB,GACjC,4BAA4B,GAC5B,gCAAgC,GAChC,gCAAgC,GAChC,mCAAmC,GACnC,8BAA8B,CAAC;AAgJnC,oFAAoF;AACpF,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,yBAAyB,GAC/B,MAAM,CAAC,oBAAoB,EAAE,yBAAyB,CAAC,CAkCzD"}

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

@@ -0,0 +1,8 @@
+import type { PointsLinesStyle } from './snapshot';
+/**
+ * Expands the local culling envelope by the maximum screen-space raster
+ * radius. The shader applies the exact physical-pixel offset; this envelope
+ * is deliberately conservative so transformed edge primitives are retained.
+ */
+export declare function expandPointsLinesBounds(bounds: ArrayLike<number>, style: PointsLinesStyle | undefined): Float32Array;
+//# sourceMappingURL=bounds.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bounds.d.ts","sourceRoot":"","sources":["../../src/points-lines/bounds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,EACzB,KAAK,EAAE,gBAAgB,GAAG,SAAS,GAClC,YAAY,CAYd"}

package/dist/points-lines/expansion-cache.d.ts

@@ -0,0 +1,28 @@
+import type { MeshAsset } from '@forgeax/engine-types';
+import type { PointsLinesRetainedSnapshot } from './snapshot';
+export interface PointsLinesExpandedGeometry {
+    readonly key: string;
+    readonly component: 'Points' | 'Lines';
+    /** Source endpoints retained for the M3 triangle-expansion consumer. */
+    readonly positions: Float32Array;
+    /** Interleaved position/otherPosition/corner stream for WGSL. */
+    readonly vertices: Float32Array;
+    /** Six indices per expanded quad. */
+    readonly indices: Uint32Array;
+    readonly sourceVertexCount: number;
+    readonly pointCount: number;
+    readonly segmentCount: number;
+    readonly expandedVertexCount: number;
+    readonly expandedIndexCount: number;
+    readonly sourceBytes: number;
+    readonly derivedBytes: number;
+    readonly bounds: Float32Array;
+}
+/** Shared CPU expansion cache. Material generations are not geometry key data. */
+export declare class PointsLinesExpansionCache {
+    private readonly entries;
+    getOrCreate(snapshot: PointsLinesRetainedSnapshot, mesh: MeshAsset): PointsLinesExpandedGeometry;
+    clear(): void;
+    get size(): number;
+}
+//# sourceMappingURL=expansion-cache.d.ts.map

package/dist/points-lines/expansion-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expansion-cache.d.ts","sourceRoot":"","sources":["../../src/points-lines/expansion-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAE9D,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,QAAQ,GAAG,OAAO,CAAC;IACvC,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,qCAAqC;IACrC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;CAC/B;AAED,kFAAkF;AAClF,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkD;IAE1E,WAAW,CAAC,QAAQ,EAAE,2BAA2B,EAAE,IAAI,EAAE,SAAS,GAAG,2BAA2B;IAYhG,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

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

@@ -0,0 +1,53 @@
+import type { RenderError } from '../errors/render';
+import type { PointsLinesRetainedSnapshot, PointsLinesStyle } from './snapshot';
+export type PointsLinesSourceError = Extract<RenderError, {
+    readonly code: `points-lines-${string}`;
+}>;
+export type PointsLinesInspectionLane = 'pending' | 'refused' | 'direct' | 'clustered' | 'cpu-webgl2';
+export interface PointsLinesInspectionCache {
+    readonly hit: boolean;
+    readonly rebuilds: number;
+    readonly evictions: number;
+}
+export type PointsLinesInspectionRefusal = Pick<PointsLinesSourceError, 'code' | 'expected' | 'hint' | 'detail'> & {
+    readonly generation: number;
+    readonly lastKnownGood: boolean;
+};
+export interface PointsLinesInspection {
+    readonly entityKey: number;
+    readonly worldId: number;
+    readonly component: 'Points' | 'Lines';
+    readonly meshHandle: number;
+    readonly meshGeneration: number;
+    readonly materialHandle: number;
+    readonly materialGeneration: number;
+    readonly style: PointsLinesStyle;
+    readonly topology: 'point-list' | 'line-list';
+    readonly lane: PointsLinesInspectionLane;
+    readonly pointCount: number;
+    readonly segmentCount: number;
+    readonly sourceBytes: number;
+    readonly derivedBytes: number;
+    readonly cache: PointsLinesInspectionCache;
+    readonly drawCount: number;
+    readonly uploadBytes: number;
+    readonly lastKnownGood: boolean;
+    readonly refusal?: PointsLinesInspectionRefusal;
+}
+export interface PointsLinesInspectionInput {
+    readonly snapshot: PointsLinesRetainedSnapshot;
+    readonly topology: 'point-list' | 'line-list';
+    readonly lane: PointsLinesInspectionLane;
+    readonly pointCount: number;
+    readonly segmentCount: number;
+    readonly sourceBytes: number;
+    readonly derivedBytes: number;
+    readonly cache: PointsLinesInspectionCache;
+    readonly drawCount: number;
+    readonly uploadBytes: number;
+    readonly lastKnownGood: boolean;
+    readonly refusal?: PointsLinesInspectionRefusal;
+}
+export declare function inspectPointsLines(input: PointsLinesInspectionInput): PointsLinesInspection;
+export declare function pointsLinesInspectionToJson(inspection: PointsLinesInspection): string;
+//# sourceMappingURL=inspection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inspection.d.ts","sourceRoot":"","sources":["../../src/points-lines/inspection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,2BAA2B,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEhF,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAC1C,WAAW,EACX;IAAE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,MAAM,EAAE,CAAA;CAAE,CAC5C,CAAC;AAEF,MAAM,MAAM,yBAAyB,GACjC,SAAS,GACT,SAAS,GACT,QAAQ,GACR,WAAW,GACX,YAAY,CAAC;AAEjB,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,4BAA4B,GAAG,IAAI,CAC7C,sBAAsB,EACtB,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,CACxC,GAAG;IACF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,QAAQ,GAAG,OAAO,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,WAAW,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,4BAA4B,CAAC;CACjD;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,WAAW,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,4BAA4B,CAAC;CACjD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,0BAA0B,GAAG,qBAAqB,CA0B3F;AAED,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,qBAAqB,GAAG,MAAM,CAErF"}

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

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

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

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