@ifc-lite/renderer 1.41.1 → 1.44.0

package/dist/section-2d-lift.d.ts

@@ -0,0 +1,105 @@
+/** Semantic cardinal section axis: down (Y), front (Z), side (X). */
+export type SectionAxis = 'down' | 'front' | 'side';
+/**
+ * Arbitrary (face-picked) section plane, issue #243. The same basis is used by
+ * `SectionCutter` to project triangle-plane intersections to 2D, so the
+ * round-trip through {@link createSectionLift} is exact.
+ */
+export interface SectionCustomPlane {
+    origin: [number, number, number];
+    tangent: [number, number, number];
+    bitangent: [number, number, number];
+}
+export interface CutPolygon2D {
+    polygon: {
+        outer: Array<{
+            x: number;
+            y: number;
+        }>;
+        holes: Array<Array<{
+            x: number;
+            y: number;
+        }>>;
+    };
+    ifcType: string;
+    expressId: number;
+    /** Optional per-polygon RGBA (0–1). When present, this cap polygon fills with
+     *  this colour (an `IfcMaterialLayerSet` wall/slab layer, or a frame+glass
+     *  window part) instead of the uniform cap fill. Absent ⇒ uniform cap style +
+     *  per-`ifcType` fallback, unchanged. */
+    color?: [number, number, number, number];
+}
+export interface DrawingLine2D {
+    line: {
+        start: {
+            x: number;
+            y: number;
+        };
+        end: {
+            x: number;
+            y: number;
+        };
+    };
+    category: string;
+    /**
+     * Express ID of the entity that authored this segment. Optional — only the
+     * IfcAnnotation / IfcGridAxis symbolic overlay sets it (so per-entity hide
+     * can drop an annotation's curves without a mesh). The section-cut and
+     * drawing-2d cutters leave it undefined.
+     */
+    ownerId?: number;
+}
+/** A 2D drawing point lifted onto the section plane in world space. */
+export type SectionLift = (x2d: number, y2d: number) => [number, number, number];
+/**
+ * Transform 2D coordinates to 3D coordinates on the section plane.
+ *
+ * Cardinal axis path (legacy, unchanged):
+ * - Y axis (down): 2D (x, y) = 3D (x, z) - looking down at XZ plane
+ * - Z axis (front): 2D (x, y) = 3D (x, y) - looking along Z at XY plane
+ * - X axis (side): 2D (x, y) = 3D (z, y) - looking along X at ZY plane
+ * When flipped, the 2D x coordinate is negated.
+ *
+ * Custom-plane path (issue #243): when `customPlane` is supplied, the
+ * 3D point is `origin + tangent*x2d + bitangent*y2d`. The same basis
+ * is used by `SectionCutter` to project triangle-plane intersections
+ * to 2D, so the round-trip is exact and the cap polygons land
+ * precisely on the user's tilted plane.
+ */
+export declare function transform2Dto3D(x2d: number, y2d: number, axis: SectionAxis, planePosition: number, flipped?: boolean, customPlane?: SectionCustomPlane): [number, number, number];
+/**
+ * Bind a lift ONCE per upload rather than re-resolving the axis/custom-plane
+ * branch per vertex. `uploadDrawing` runs over every cut polygon on each
+ * section-slider commit, so the branch is hoisted out of the inner loop; the
+ * returned closure allocates exactly the same one tuple per point that
+ * {@link transform2Dto3D} does.
+ */
+export declare function createSectionLift(axis: SectionAxis, planePosition: number, flipped?: boolean, customPlane?: SectionCustomPlane): SectionLift;
+/** Interleaved `[x, y, z, r, g, b, a]` cap vertices plus their triangle indices. */
+export interface CapFillGeometry {
+    vertices: Float32Array;
+    indices: Uint32Array;
+}
+/**
+ * Triangulate the cut polygons and lift them onto the section plane.
+ *
+ * Hole-aware ear-clipping (reused from the IfcAnnotationFillArea fill path)
+ * replaces the old convex fan. The fan ignored holes and inverted on the
+ * CONCAVE cross-sections that arbitrary IFC profiles (and material-layer
+ * slabs) cut into, leaving the cut face uncovered — it read as a hollow
+ * shell. Section 2D points are (x, y); the triangulator works in (x, z),
+ * so y maps to z.
+ *
+ * Returns `null` when nothing survives (no polygon had three usable points),
+ * so the caller can skip buffer creation entirely.
+ */
+export declare function buildCapFillGeometry(polygons: readonly CutPolygon2D[], lift: SectionLift): CapFillGeometry | null;
+/**
+ * Enumerate the cut outline as a line-list: every polygon's outer ring, every
+ * hole ring, then the extra drawing lines (hatching etc.), each lifted onto the
+ * section plane. Rings close back onto their first point.
+ *
+ * Returns `null` when there is nothing to draw.
+ */
+export declare function buildDrawingOutlineVertices(polygons: readonly CutPolygon2D[], lines: readonly DrawingLine2D[], lift: SectionLift): Float32Array | null;
+//# sourceMappingURL=section-2d-lift.d.ts.map

package/dist/section-2d-lift.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-2d-lift.d.ts","sourceRoot":"","sources":["../src/section-2d-lift.ts"],"names":[],"mappings":"AAkBA,qEAAqE;AACrE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAEpD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE;QACP,KAAK,EAAE,KAAK,CAAC;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACvC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC,CAAC;KAC/C,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB;;;6CAGyC;IACzC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE;QACJ,KAAK,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAChC,GAAG,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/B,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,uEAAuE;AACvE,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,OAAe,EACxB,WAAW,CAAC,EAAE,kBAAkB,GAC/B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CA8B1B;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,WAAW,EACjB,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,OAAe,EACxB,WAAW,CAAC,EAAE,kBAAkB,GAC/B,WAAW,CAEb;AAED,oFAAoF;AACpF,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,WAAW,CAAC;CACtB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,SAAS,YAAY,EAAE,EACjC,IAAI,EAAE,WAAW,GAChB,eAAe,GAAG,IAAI,CAwCxB;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,SAAS,YAAY,EAAE,EACjC,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,IAAI,EAAE,WAAW,GAChB,YAAY,GAAG,IAAI,CAmCrB"}

package/dist/section-2d-lift.js

@@ -0,0 +1,162 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * Section 2D → 3D lift and cap geometry building.
+ *
+ * Pure array maths, no GPU state: "what shape does the drawing have on the
+ * plane". `Section2DOverlayRenderer` owns the buffers and calls in here for the
+ * vertex data to put in them, which is why nothing in this file touches a
+ * `GPUDevice`. Its failure stories are geometric (the cap lands off a tilted
+ * plane, a concave cross-section triangulates inside-out, holes are not
+ * stitched, a flipped axis is mirrored the wrong way) and are all testable with
+ * plain numbers.
+ */
+import { earClip, joinHoles } from './symbolic-overlay-pipelines.js';
+/**
+ * Transform 2D coordinates to 3D coordinates on the section plane.
+ *
+ * Cardinal axis path (legacy, unchanged):
+ * - Y axis (down): 2D (x, y) = 3D (x, z) - looking down at XZ plane
+ * - Z axis (front): 2D (x, y) = 3D (x, y) - looking along Z at XY plane
+ * - X axis (side): 2D (x, y) = 3D (z, y) - looking along X at ZY plane
+ * When flipped, the 2D x coordinate is negated.
+ *
+ * Custom-plane path (issue #243): when `customPlane` is supplied, the
+ * 3D point is `origin + tangent*x2d + bitangent*y2d`. The same basis
+ * is used by `SectionCutter` to project triangle-plane intersections
+ * to 2D, so the round-trip is exact and the cap polygons land
+ * precisely on the user's tilted plane.
+ */
+export function transform2Dto3D(x2d, y2d, axis, planePosition, flipped = false, customPlane) {
+    if (customPlane) {
+        // Custom plane: bypass the cardinal-axis swap. `flipped` is
+        // intentionally ignored because for arbitrary planes the cutter
+        // does not mirror its 2D output (mirroring only makes sense for
+        // cardinal projections that have a consistent "view direction").
+        const o = customPlane.origin;
+        const t = customPlane.tangent;
+        const b = customPlane.bitangent;
+        return [
+            o[0] + t[0] * x2d + b[0] * y2d,
+            o[1] + t[1] * x2d + b[1] * y2d,
+            o[2] + t[2] * x2d + b[2] * y2d,
+        ];
+    }
+    // Handle flipped - the 2D x coordinate was negated during projection
+    const x = flipped ? -x2d : x2d;
+    switch (axis) {
+        case 'down': // Y axis - horizontal cut (floor plan)
+            // 2D.x = 3D.x, 2D.y = 3D.z -> 3D (x, planeY, y)
+            return [x, planePosition, y2d];
+        case 'front': // Z axis - vertical cut (section view)
+            // 2D.x = 3D.x, 2D.y = 3D.y -> 3D (x, y, planeZ)
+            return [x, y2d, planePosition];
+        case 'side': // X axis - vertical cut (side elevation)
+            // 2D.x = 3D.z, 2D.y = 3D.y -> 3D (planeX, y, x)
+            return [planePosition, y2d, x];
+    }
+}
+/**
+ * Bind a lift ONCE per upload rather than re-resolving the axis/custom-plane
+ * branch per vertex. `uploadDrawing` runs over every cut polygon on each
+ * section-slider commit, so the branch is hoisted out of the inner loop; the
+ * returned closure allocates exactly the same one tuple per point that
+ * {@link transform2Dto3D} does.
+ */
+export function createSectionLift(axis, planePosition, flipped = false, customPlane) {
+    return (x2d, y2d) => transform2Dto3D(x2d, y2d, axis, planePosition, flipped, customPlane);
+}
+/**
+ * Triangulate the cut polygons and lift them onto the section plane.
+ *
+ * Hole-aware ear-clipping (reused from the IfcAnnotationFillArea fill path)
+ * replaces the old convex fan. The fan ignored holes and inverted on the
+ * CONCAVE cross-sections that arbitrary IFC profiles (and material-layer
+ * slabs) cut into, leaving the cut face uncovered — it read as a hollow
+ * shell. Section 2D points are (x, y); the triangulator works in (x, z),
+ * so y maps to z.
+ *
+ * Returns `null` when nothing survives (no polygon had three usable points),
+ * so the caller can skip buffer creation entirely.
+ */
+export function buildCapFillGeometry(polygons, lift) {
+    const fillVertices = [];
+    const fillIndices = [];
+    let vertexOffset = 0;
+    for (const polygon of polygons) {
+        const outer = polygon.polygon.outer;
+        if (outer.length < 3)
+            continue;
+        // Per-polygon fill colour. A material-layer wall/slab delivers one polygon
+        // per layer, each carrying its IfcMaterial RGBA (window frame/glass parts
+        // likewise). Polygons WITHOUT a colour use the sentinel alpha −1 so the
+        // fill shader falls back to the uniform cap style (architectural fill +
+        // hatch) byte-identically — see fs_main.
+        const color = polygon.color ?? [0, 0, 0, -1];
+        const outerRing = outer.map((p) => ({ x: p.x, z: p.y }));
+        const holeRings = polygon.polygon.holes
+            .filter((h) => h.length >= 3)
+            .map((h) => h.map((p) => ({ x: p.x, z: p.y })));
+        const stitched = holeRings.length > 0 ? joinHoles(outerRing, holeRings) : outerRing;
+        const tris = earClip(stitched);
+        if (tris.length === 0)
+            continue;
+        const baseVertex = vertexOffset;
+        for (const pt of stitched) {
+            const [x3d, y3d, z3d] = lift(pt.x, pt.z);
+            fillVertices.push(x3d, y3d, z3d, color[0], color[1], color[2], color[3]);
+            vertexOffset++;
+        }
+        for (const [a, b, c] of tris) {
+            fillIndices.push(baseVertex + a, baseVertex + b, baseVertex + c);
+        }
+    }
+    if (fillVertices.length === 0)
+        return null;
+    return {
+        vertices: new Float32Array(fillVertices),
+        indices: new Uint32Array(fillIndices),
+    };
+}
+/**
+ * Enumerate the cut outline as a line-list: every polygon's outer ring, every
+ * hole ring, then the extra drawing lines (hatching etc.), each lifted onto the
+ * section plane. Rings close back onto their first point.
+ *
+ * Returns `null` when there is nothing to draw.
+ */
+export function buildDrawingOutlineVertices(polygons, lines, lift) {
+    const lineVertices = [];
+    // Polygon outlines
+    for (const polygon of polygons) {
+        const outer = polygon.polygon.outer;
+        for (let i = 0; i < outer.length; i++) {
+            const p1 = outer[i];
+            const p2 = outer[(i + 1) % outer.length];
+            const [x1, y1, z1] = lift(p1.x, p1.y);
+            const [x2, y2, z2] = lift(p2.x, p2.y);
+            lineVertices.push(x1, y1, z1, x2, y2, z2);
+        }
+        // Hole outlines
+        for (const hole of polygon.polygon.holes) {
+            for (let i = 0; i < hole.length; i++) {
+                const p1 = hole[i];
+                const p2 = hole[(i + 1) % hole.length];
+                const [x1, y1, z1] = lift(p1.x, p1.y);
+                const [x2, y2, z2] = lift(p2.x, p2.y);
+                lineVertices.push(x1, y1, z1, x2, y2, z2);
+            }
+        }
+    }
+    // Additional drawing lines (hatching, etc.)
+    for (const line of lines) {
+        const [x1, y1, z1] = lift(line.line.start.x, line.line.start.y);
+        const [x2, y2, z2] = lift(line.line.end.x, line.line.end.y);
+        lineVertices.push(x1, y1, z1, x2, y2, z2);
+    }
+    if (lineVertices.length === 0)
+        return null;
+    return new Float32Array(lineVertices);
+}
+//# sourceMappingURL=section-2d-lift.js.map

package/dist/section-2d-lift.js.map

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

package/dist/section-2d-line-buffer.d.ts

@@ -0,0 +1,58 @@
+/** Shared GPU resources a {@link WorldLineBuffer} borrows for the duration of a draw. */
+export interface SectionLinePipelineResources {
+    device: GPUDevice;
+    pipeline: GPURenderPipeline;
+    bindGroup: GPUBindGroup;
+    uniformBuffer: GPUBuffer;
+    /** Byte stride between the uniform slots in `uniformBuffer`. */
+    uniformStride: number;
+}
+export declare class WorldLineBuffer {
+    private readonly uniformSlot;
+    private buffer;
+    private count;
+    /**
+     * @param uniformSlot Index of this family's record in the shared uniform
+     *   buffer. Every family needs its own: the six overlay draws are encoded
+     *   into one pass and `queue.writeBuffer` lands before the pass runs, so a
+     *   shared record means the last family's colour is the one all six get.
+     *   See `SECTION_2D_UNIFORM_SLOT_INDEX`.
+     */
+    constructor(uniformSlot: number);
+    /**
+     * Replace the buffer's contents with a flat `[x,y,z, x,y,z, …]` line-list in
+     * world space. Anything shorter than one full segment clears instead, which
+     * is how every caller passes "no lines".
+     *
+     * Only **whole** segments are uploaded. The vertex count went straight to
+     * `pass.draw()` as `vertices.length / 3`, so a length that was not a multiple
+     * of 3 produced a *fractional* vertex count — a WebGPU validation error that
+     * kills the whole command buffer, taking every other overlay in the pass down
+     * with it — and an odd whole vertex count left a dangling half-segment the
+     * line-list topology would discard anyway. Both are reachable: these arrays
+     * are assembled by upstream polyline/arc flatteners, not written by hand.
+     *
+     * Truncating rather than rejecting the whole array is deliberate. One stray
+     * float from a flattener should cost the caller the incomplete tail segment,
+     * not the entire grid / DXF / annotation layer.
+     */
+    upload(device: GPUDevice, vertices: Float32Array): void;
+    /** Destroy the buffer and reset the count. Safe to call repeatedly. */
+    clear(): void;
+    has(): boolean;
+    /** Vertex count, for tests and for the caller's own bookkeeping. */
+    get vertexCount(): number;
+    /**
+     * Draw the buffer in `color`. `planeOffset` is left zeroed — these vertices
+     * are already in world space, so unlike the section-cut outline they do not
+     * ride the section plane.
+     *
+     * Writes into — and binds — **this family's own** uniform slot. Sharing one
+     * record across the pass's six draws meant the last write before submit was
+     * what every draw read.
+     *
+     * No-ops when the buffer is empty, so callers do not need their own guard.
+     */
+    draw(pass: GPURenderPassEncoder, resources: SectionLinePipelineResources, viewProj: Float32Array, color: readonly [number, number, number, number]): void;
+}
+//# sourceMappingURL=section-2d-line-buffer.d.ts.map

package/dist/section-2d-line-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-2d-line-buffer.d.ts","sourceRoot":"","sources":["../src/section-2d-line-buffer.ts"],"names":[],"mappings":"AA2BA,yFAAyF;AACzF,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,SAAS,EAAE,YAAY,CAAC;IACxB,aAAa,EAAE,SAAS,CAAC;IACzB,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAC;CACvB;AAKD,qBAAa,eAAe;IAWd,OAAO,CAAC,QAAQ,CAAC,WAAW;IAVxC,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,KAAK,CAAK;IAElB;;;;;;OAMG;gBAC0B,WAAW,EAAE,MAAM;IAEhD;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAcvD,uEAAuE;IACvE,KAAK,IAAI,IAAI;IAQb,GAAG,IAAI,OAAO;IAId,oEAAoE;IACpE,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,IAAI,EAAE,oBAAoB,EAC1B,SAAS,EAAE,4BAA4B,EACvC,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC/C,IAAI;CAeR"}

package/dist/section-2d-line-buffer.js

@@ -0,0 +1,109 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * One world-space line-list vertex buffer.
+ *
+ * `Section2DOverlayRenderer` backs five standalone line overlays (annotation
+ * #653, alignment, grid #967, DXF #2043, clash box #1277) that are byte-for-byte
+ * identical apart from which buffer they read and which colour they draw in.
+ * This is the ONLY thing those families genuinely own on their own: a vertex
+ * buffer and its vertex count.
+ *
+ * Deliberately NOT an owner of anything shared. The line pipeline, the
+ * bind-group layout, the bind group and the 160-byte uniform buffer stay owned
+ * solely by `Section2DOverlayRenderer` and are handed in per draw as
+ * {@link SectionLinePipelineResources}. That keeps the renderer's single
+ * `init()`/`dispose()` lifecycle the one place those resources are created and
+ * destroyed — giving each family its own pipeline handle is the split that
+ * would put one GPU object under six owners (issue #2456).
+ */
+import { SECTION_2D_UNIFORM_FLOATS, SECTION_2D_UNIFORM_SLOTS, } from './shaders/section-2d-overlay.wgsl.js';
+/** Minimum floats for one line segment: two 3-float vertices. */
+const FLOATS_PER_SEGMENT = 6;
+export class WorldLineBuffer {
+    uniformSlot;
+    buffer = null;
+    count = 0;
+    /**
+     * @param uniformSlot Index of this family's record in the shared uniform
+     *   buffer. Every family needs its own: the six overlay draws are encoded
+     *   into one pass and `queue.writeBuffer` lands before the pass runs, so a
+     *   shared record means the last family's colour is the one all six get.
+     *   See `SECTION_2D_UNIFORM_SLOT_INDEX`.
+     */
+    constructor(uniformSlot) {
+        this.uniformSlot = uniformSlot;
+    }
+    /**
+     * Replace the buffer's contents with a flat `[x,y,z, x,y,z, …]` line-list in
+     * world space. Anything shorter than one full segment clears instead, which
+     * is how every caller passes "no lines".
+     *
+     * Only **whole** segments are uploaded. The vertex count went straight to
+     * `pass.draw()` as `vertices.length / 3`, so a length that was not a multiple
+     * of 3 produced a *fractional* vertex count — a WebGPU validation error that
+     * kills the whole command buffer, taking every other overlay in the pass down
+     * with it — and an odd whole vertex count left a dangling half-segment the
+     * line-list topology would discard anyway. Both are reachable: these arrays
+     * are assembled by upstream polyline/arc flatteners, not written by hand.
+     *
+     * Truncating rather than rejecting the whole array is deliberate. One stray
+     * float from a flattener should cost the caller the incomplete tail segment,
+     * not the entire grid / DXF / annotation layer.
+     */
+    upload(device, vertices) {
+        this.clear();
+        const usableFloats = Math.floor(vertices.length / FLOATS_PER_SEGMENT) * FLOATS_PER_SEGMENT;
+        if (usableFloats === 0)
+            return;
+        const data = usableFloats === vertices.length ? vertices : vertices.subarray(0, usableFloats);
+        this.buffer = device.createBuffer({
+            size: data.byteLength,
+            usage: GPUBufferUsage.VERTEX | GPUBufferUsage.COPY_DST,
+        });
+        device.queue.writeBuffer(this.buffer, 0, data);
+        this.count = usableFloats / 3;
+    }
+    /** Destroy the buffer and reset the count. Safe to call repeatedly. */
+    clear() {
+        if (this.buffer) {
+            this.buffer.destroy();
+            this.buffer = null;
+        }
+        this.count = 0;
+    }
+    has() {
+        return this.count > 0;
+    }
+    /** Vertex count, for tests and for the caller's own bookkeeping. */
+    get vertexCount() {
+        return this.count;
+    }
+    /**
+     * Draw the buffer in `color`. `planeOffset` is left zeroed — these vertices
+     * are already in world space, so unlike the section-cut outline they do not
+     * ride the section plane.
+     *
+     * Writes into — and binds — **this family's own** uniform slot. Sharing one
+     * record across the pass's six draws meant the last write before submit was
+     * what every draw read.
+     *
+     * No-ops when the buffer is empty, so callers do not need their own guard.
+     */
+    draw(pass, resources, viewProj, color) {
+        if (!this.buffer || this.count === 0)
+            return;
+        const byteOffset = this.uniformSlot * resources.uniformStride;
+        const uniforms = new Float32Array(SECTION_2D_UNIFORM_FLOATS);
+        uniforms.set(viewProj, SECTION_2D_UNIFORM_SLOTS.viewProj);
+        // planeOffset stays 0 — vertices are already in world space.
+        uniforms.set(color, SECTION_2D_UNIFORM_SLOTS.lineColor);
+        resources.device.queue.writeBuffer(resources.uniformBuffer, byteOffset, uniforms);
+        pass.setPipeline(resources.pipeline);
+        pass.setBindGroup(0, resources.bindGroup, [byteOffset]);
+        pass.setVertexBuffer(0, this.buffer);
+        pass.draw(this.count);
+    }
+}
+//# sourceMappingURL=section-2d-line-buffer.js.map

package/dist/section-2d-line-buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"section-2d-line-buffer.js","sourceRoot":"","sources":["../src/section-2d-line-buffer.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EACL,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,sCAAsC,CAAC;AAY9C,iEAAiE;AACjE,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAE7B,MAAM,OAAO,eAAe;IAWG;IAVrB,MAAM,GAAqB,IAAI,CAAC;IAChC,KAAK,GAAG,CAAC,CAAC;IAElB;;;;;;OAMG;IACH,YAA6B,WAAmB;QAAnB,gBAAW,GAAX,WAAW,CAAQ;IAAG,CAAC;IAEpD;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,MAAiB,EAAE,QAAsB;QAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,kBAAkB,CAAC,GAAG,kBAAkB,CAAC;QAC3F,IAAI,YAAY,KAAK,CAAC;YAAE,OAAO;QAE/B,MAAM,IAAI,GAAG,YAAY,KAAK,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;QAC9F,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC;YAChC,IAAI,EAAE,IAAI,CAAC,UAAU;YACrB,KAAK,EAAE,cAAc,CAAC,MAAM,GAAG,cAAc,CAAC,QAAQ;SACvD,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,GAAG,YAAY,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,uEAAuE;IACvE,KAAK;QACH,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACrB,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,CAAC;IAED,GAAG;QACD,OAAO,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACxB,CAAC;IAED,oEAAoE;IACpE,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;;;;;;;;;OAUG;IACH,IAAI,CACF,IAA0B,EAC1B,SAAuC,EACvC,QAAsB,EACtB,KAAgD;QAEhD,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,KAAK,CAAC;YAAE,OAAO;QAE7C,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC,aAAa,CAAC;QAC9D,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,yBAAyB,CAAC,CAAC;QAC7D,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,wBAAwB,CAAC,QAAQ,CAAC,CAAC;QAC1D,6DAA6D;QAC7D,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,wBAAwB,CAAC,SAAS,CAAC,CAAC;QACxD,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,aAAa,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;QAElF,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;QACxD,IAAI,CAAC,eAAe,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;CACF"}

package/dist/section-2d-overlay.d.ts

@@ -1,3 +1,5 @@
+import { type CutPolygon2D, type DrawingLine2D, type SectionAxis, type SectionCustomPlane } from './section-2d-lift.js';
+export type { CutPolygon2D, DrawingLine2D, SectionCustomPlane } from './section-2d-lift.js';
 export interface Section2DOverlayCapStyle {
     fillColor: [number, number, number, number];
     strokeColor: [number, number, number, number];
@@ -40,45 +42,6 @@ export interface Section2DOverlayOptions {
      */
     showOutlines?: boolean;
 }
-export interface CutPolygon2D {
-    polygon: {
-        outer: Array<{
-            x: number;
-            y: number;
-        }>;
-        holes: Array<Array<{
-            x: number;
-            y: number;
-        }>>;
-    };
-    ifcType: string;
-    expressId: number;
-    /** Optional per-polygon RGBA (0–1). When present, this cap polygon fills with
-     *  this colour (an `IfcMaterialLayerSet` wall/slab layer, or a frame+glass
-     *  window part) instead of the uniform cap fill. Absent ⇒ uniform cap style +
-     *  per-`ifcType` fallback, unchanged. */
-    color?: [number, number, number, number];
-}
-export interface DrawingLine2D {
-    line: {
-        start: {
-            x: number;
-            y: number;
-        };
-        end: {
-            x: number;
-            y: number;
-        };
-    };
-    category: string;
-    /**
-     * Express ID of the entity that authored this segment. Optional — only the
-     * IfcAnnotation / IfcGridAxis symbolic overlay sets it (so per-entity hide
-     * can drop an annotation's curves without a mesh). The section-cut and
-     * drawing-2d cutters leave it undefined.
-     */
-    ownerId?: number;
-}
 export declare class Section2DOverlayRenderer {
     private device;
     private fillPipeline;
@@ -86,6 +49,8 @@ export declare class Section2DOverlayRenderer {
     private bindGroupLayout;
     private uniformBuffer;
     private bindGroup;
+    /** Byte stride between the uniform slots in {@link uniformBuffer}. Set by `init()`. */
+    private uniformStride;
     private format;
     private sampleCount;
     private initialized;
@@ -95,33 +60,20 @@ export declare class Section2DOverlayRenderer {
     private fillIndexCount;
     private lineVertexBuffer;
     private lineVertexCount;
-    private annotationLineVertexBuffer;
-    private annotationLineVertexCount;
-    private alignmentLineVertexBuffer;
-    private alignmentLineVertexCount;
-    private gridLineVertexBuffer;
-    private gridLineVertexCount;
-    private clashBoxLineVertexBuffer;
-    private clashBoxLineVertexCount;
+    private annotationLines;
+    private alignmentLines;
+    private gridLines;
+    private dxfLines;
+    private clashBoxLines;
     private clashBoxLineColor;
     constructor(device: GPUDevice, format: GPUTextureFormat, sampleCount?: number);
     private init;
     /**
-     * Transform 2D coordinates to 3D coordinates on the section plane.
-     *
-     * Cardinal axis path (legacy, unchanged):
-     * - Y axis (down): 2D (x, y) = 3D (x, z) - looking down at XZ plane
-     * - Z axis (front): 2D (x, y) = 3D (x, y) - looking along Z at XY plane
-     * - X axis (side): 2D (x, y) = 3D (z, y) - looking along X at ZY plane
-     * When flipped, the 2D x coordinate is negated.
-     *
-     * Custom-plane path (issue #243): when `customPlane` is supplied, the
-     * 3D point is `origin + tangent*x2d + bitangent*y2d`. The same basis
-     * is used by `SectionCutter` to project triangle-plane intersections
-     * to 2D, so the round-trip is exact and the cap polygons land
-     * precisely on the user's tilted plane.
+     * The shared line-pipeline resources a WorldLineBuffer borrows for a draw.
+     * Returns null before `init()` has produced them (or after `dispose()`), so
+     * every `draw*Lines3D` bails on the same condition it always did.
      */
-    private transform2Dto3D;
+    private lineResources;
     /**
      * Upload 2D drawing data to GPU buffers.
      *
@@ -135,11 +87,7 @@ export declare class Section2DOverlayRenderer {
      * would land off the actual cutting plane (the bug PR #581 hid by
      * suppressing the cap entirely for non-cardinal planes).
      */
-    uploadDrawing(polygons: CutPolygon2D[], lines: DrawingLine2D[], axis: 'down' | 'front' | 'side', planePosition: number, flipped?: boolean, customPlane?: {
-        origin: [number, number, number];
-        tangent: [number, number, number];
-        bitangent: [number, number, number];
-    }): void;
+    uploadDrawing(polygons: CutPolygon2D[], lines: DrawingLine2D[], axis: SectionAxis, planePosition: number, flipped?: boolean, customPlane?: SectionCustomPlane): void;
     /**
      * Clear uploaded geometry
      */
@@ -162,6 +110,14 @@ export declare class Section2DOverlayRenderer {
     uploadAnnotationLines3D(vertices: Float32Array): void;
     clearAnnotationLines3D(): void;
     hasAnnotationLines3D(): boolean;
+    /**
+     * Draw the standalone annotation line overlay. Uses the same line pipeline
+     * as the section cut outlines (vertex format: 3 floats per vertex, line-list
+     * topology) but reads from a separate vertex buffer. The pipeline's
+     * `planeOffset` uniform is zeroed so vertices render at their authored
+     * world position.
+     */
+    drawAnnotationLines3D(pass: GPURenderPassEncoder, viewProj: Float32Array): void;
     /**
      * Upload a flat Float32Array of 3D line-list vertices for the alignment
      * centerline overlay. Same format/pipeline as the annotation lines, kept in
@@ -171,14 +127,6 @@ export declare class Section2DOverlayRenderer {
     uploadAlignmentLines3D(vertices: Float32Array): void;
     clearAlignmentLines3D(): void;
     hasAlignmentLines3D(): boolean;
-    /**
-     * Draw the standalone annotation line overlay. Uses the same line pipeline
-     * as the section cut outlines (vertex format: 3 floats per vertex, line-list
-     * topology) but reads from a separate vertex buffer. The pipeline's
-     * `planeOffset` uniform is zeroed so vertices render at their authored
-     * world position.
-     */
-    drawAnnotationLines3D(pass: GPURenderPassEncoder, viewProj: Float32Array): void;
     /**
      * Draw the alignment centerline overlay. Identical pipeline/uniform setup as
      * `drawAnnotationLines3D`, reading from the separate alignment buffer.
@@ -198,6 +146,21 @@ export declare class Section2DOverlayRenderer {
      * `drawAlignmentLines3D`, reading from the separate grid buffer.
      */
     drawGridLines3D(pass: GPURenderPassEncoder, viewProj: Float32Array): void;
+    /**
+     * Upload the DXF reference-layer's line paths as a flat `[x,y,z, x,y,z, …]`
+     * line-list in world space (issue #2043). Mirrors `uploadGridLines3D` with
+     * a separate buffer so 3D DXF visibility is independent of the 2D
+     * underlay and the other overlays above. Pass an empty array (or omit)
+     * to clear.
+     */
+    uploadDxfLines3D(vertices: Float32Array): void;
+    clearDxfLines3D(): void;
+    hasDxfLines3D(): boolean;
+    /**
+     * Draw the 3D DXF reference-layer overlay. Identical pipeline/uniform
+     * setup as `drawGridLines3D`, reading from the separate DXF buffer.
+     */
+    drawDxfLines3D(pass: GPURenderPassEncoder, viewProj: Float32Array): void;
     /** Colour for the clash-overlap box (its own, not the shared overlay colour). */
     setClashBoxLineColor(color: readonly [number, number, number, number]): void;
     /**
@@ -219,7 +182,12 @@ export declare class Section2DOverlayRenderer {
      */
     draw(pass: GPURenderPassEncoder, options: Section2DOverlayOptions): void;
     /**
-     * Dispose of GPU resources
+     * Dispose of GPU resources.
+     *
+     * Every family's buffer must be released here. The clash box (#1277) was the
+     * sixth family added and was missing from this list, leaking its vertex
+     * buffer on every teardown — `section-2d-overlay-lifecycle.test.ts` now counts
+     * destroys against uploads so a seventh family cannot repeat it.
      */
     dispose(): void;
 }