@ifc-lite/drawing-2d 2.0.0 → 2.1.0

package/dist/sheet/scale-stamp.js

@@ -0,0 +1,277 @@
+/* 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/. */
+/**
+ * The scale record a to-scale sheet carries on the paper itself: a drawn scale
+ * bar plus the "1:N" text, laid out in millimetres in a band below the drawing
+ * (issue #2042).
+ *
+ * WHY A SHEET WITHOUT THIS IS DANGEROUS. A to-scale PDF whose only record of
+ * its scale is its filename says nothing once it is printed. The whole promise
+ * of the export is "measurements taken off the print are correct", and a sheet
+ * that carries no scale invites someone to measure it at an assumed one. The
+ * printed ratio fixes that for the original; the BAR fixes it for every copy
+ * after, because a photocopier that shrinks a sheet to 94% shrinks the bar with
+ * it while the text "1:100" keeps claiming a scale the paper no longer has.
+ * Those are two different failures, so the sheet carries both.
+ *
+ * WHAT THIS FILE MUST NEVER DO — the reason it exists as layout maths and not
+ * as a sheet template. `sheet-types.ts`'s `calculateDrawingTransform` fits a
+ * drawing into a fixed viewport (`fitScale = min(scaleX, scaleY, 1)`), which
+ * silently shrinks it. Adding furniture through anything that re-fits would
+ * turn an exact sheet into a plausible-looking wrong one, which is the single
+ * defect this whole feature exists to prevent. So the band is added by GROWING
+ * the page down (and right, only if the stamp is wider than the drawing) and
+ * the drawing's `PdfScaleTransform` is passed through untouched — same
+ * `worldToMm`, same offsets, same object. Adding a scale bar cannot move a
+ * single millimetre of the drawing, by construction rather than by care.
+ *
+ * The emission is deliberately not here: these are plain rectangles and text
+ * runs in page millimetres, so the viewer can write them with jsPDF while the
+ * sibling renderers in this folder keep emitting SVG strings.
+ */
+import { formatScaleFactorLabel, formatSheetScaleLabel, } from '../pdf-scale.js';
+// ═══════════════════════════════════════════════════════════════════════════
+// LAYOUT CONSTANTS (millimetres on paper, at any scale)
+// ═══════════════════════════════════════════════════════════════════════════
+const BAR_TOP_GAP_MM = 4;
+const BAR_HEIGHT_MM = 2.5;
+const TICK_LABEL_GAP_MM = 1;
+const TICK_LABEL_HEIGHT_MM = 2.5;
+const RATIO_TEXT_GAP_MM = 1.5;
+const RATIO_TEXT_HEIGHT_MM = 3.5;
+const BOTTOM_PAD_MM = 2;
+/** Height of the whole band. Independent of scale, bar length and page size. */
+export const SCALE_STAMP_HEIGHT_MM = BAR_TOP_GAP_MM +
+    BAR_HEIGHT_MM +
+    TICK_LABEL_GAP_MM +
+    TICK_LABEL_HEIGHT_MM +
+    RATIO_TEXT_GAP_MM +
+    RATIO_TEXT_HEIGHT_MM +
+    BOTTOM_PAD_MM;
+/** Shortest bar worth printing: below this the divisions stop being readable. */
+const MIN_BAR_WIDTH_MM = 20;
+/** What a bar is aimed at when there is room, mm. */
+const TARGET_BAR_WIDTH_MM = 60;
+/**
+ * Division lengths a surveyor would recognise, in metres. The 1-2-5 sequence
+ * is what keeps the labels round ("0 1 2 3 4 m") instead of "0 1.27 2.54"; a
+ * bar whose ticks fall on arbitrary numbers is measurable but unreadable.
+ */
+const DIVISION_STEPS_M = [
+    0.05, 0.1, 0.2, 0.5, 1, 2, 5, 10, 20, 50, 100, 200, 500, 1000,
+];
+/** Division counts, most preferred first. */
+const DIVISION_COUNTS = [4, 2];
+/**
+ * Width of one character as a fraction of the text height. Helvetica averages
+ * about 0.5 em, so this OVER-estimates on purpose: the only thing it decides
+ * is whether the page has to grow to hold the band, and over-estimating leaves
+ * blank paper while under-estimating would run a label off the sheet.
+ */
+const TEXT_WIDTH_PER_HEIGHT = 0.62;
+// ═══════════════════════════════════════════════════════════════════════════
+// BUILD
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Lay out a scale bar and its ratio text with their top-left corner at
+ * (`originXMm`, `originYMm`).
+ *
+ * Throws on a non-finite or non-positive `worldToMm` and on non-finite
+ * placement: a stamp is the sheet's statement about its own scale, so emitting
+ * one from numbers that do not describe a scale would be worse than emitting
+ * none at all.
+ */
+export function buildScaleStamp(options) {
+    const { worldToMm, availableWidthMm, originXMm, originYMm } = options;
+    if (!Number.isFinite(worldToMm) || worldToMm <= 0) {
+        throw new Error(`Invalid scale for a scale bar: ${worldToMm} mm per metre. Expected a positive finite number.`);
+    }
+    if (!Number.isFinite(availableWidthMm) ||
+        !Number.isFinite(originXMm) ||
+        !Number.isFinite(originYMm)) {
+        throw new Error('Invalid scale bar placement: origin and available width must be finite.');
+    }
+    const { divisions, divisionMetres } = chooseBarDivisions(worldToMm, availableWidthMm);
+    const divisionWidthMm = divisionMetres * worldToMm;
+    const barWidthMm = divisions * divisionWidthMm;
+    const barTopMm = originYMm + BAR_TOP_GAP_MM;
+    // Alternating filled and hollow divisions: the classic bar, and the one that
+    // still reads at a glance after a photocopy has washed out the tick labels.
+    const rects = [];
+    for (let i = 0; i < divisions; i++) {
+        rects.push({
+            xMm: originXMm + i * divisionWidthMm,
+            yMm: barTopMm,
+            widthMm: divisionWidthMm,
+            heightMm: BAR_HEIGHT_MM,
+            filled: i % 2 === 0,
+        });
+    }
+    const tickBaselineMm = barTopMm + BAR_HEIGHT_MM + TICK_LABEL_GAP_MM + TICK_LABEL_HEIGHT_MM;
+    const texts = [];
+    for (let i = 0; i <= divisions; i++) {
+        const metres = i * divisionMetres;
+        // Same rounding rule as the ratio below (2 dp, trailing zeros trimmed):
+        // one rule for every number this package prints on a sheet, rather than a
+        // second one here that could disagree about, say, 0.30000000000000004.
+        const value = formatScaleFactorLabel(metres);
+        texts.push({
+            // The unit rides on the last label only: repeating "m" under every tick
+            // is clutter, and omitting it everywhere leaves the bar unitless.
+            text: i === divisions ? `${value} m` : value,
+            xMm: originXMm + i * divisionWidthMm,
+            yMm: tickBaselineMm,
+            align: 'center',
+            heightMm: TICK_LABEL_HEIGHT_MM,
+            metres,
+        });
+    }
+    // The ratio goes through the shared formatter, so a 1:99.5 sheet prints
+    // "1:99.5" and never the materially different "1:100" (#2119). `worldToMm`
+    // IS the scale the drawing was laid out at, so deriving the label from it
+    // rather than from a separately passed factor removes the whole class of
+    // sheet-says-one-thing-drawn-at-another defects.
+    //
+    // And when 2 decimals cannot hold the factor — "as displayed" delivers
+    // 1:87.3456 — the label says "about", because a bare "1:87.35" would be a
+    // number an engineer trusts and should not. The bar below it stays exact.
+    const scaleLabel = formatSheetScaleLabel(1000 / worldToMm);
+    const ratioBaselineMm = tickBaselineMm + RATIO_TEXT_GAP_MM + RATIO_TEXT_HEIGHT_MM;
+    texts.push({
+        text: `Scale ${scaleLabel}`,
+        xMm: originXMm,
+        yMm: ratioBaselineMm,
+        align: 'left',
+        heightMm: RATIO_TEXT_HEIGHT_MM,
+        metres: null,
+    });
+    return {
+        bar: {
+            xMm: originXMm,
+            yMm: barTopMm,
+            widthMm: barWidthMm,
+            heightMm: BAR_HEIGHT_MM,
+            divisions,
+            divisionMetres,
+            divisionWidthMm,
+        },
+        rects,
+        texts,
+        widthMm: stampWidthMm(originXMm, barWidthMm, texts),
+        heightMm: SCALE_STAMP_HEIGHT_MM,
+        scaleLabel,
+    };
+}
+/**
+ * Grow `base` by a scale band under the drawing.
+ *
+ * The page gains exactly `SCALE_STAMP_HEIGHT_MM` of height, and width only if
+ * the band is wider than the drawing. The transform is returned as it came in
+ * — see {@link StampedSheetLayout.transform}.
+ *
+ * PRECONDITION on `marginMm`: the bar's end tick labels are centred on their
+ * ticks, so roughly half a label hangs past each end of the bar. The margin has
+ * to absorb that. Zero (or a very small) margin is accepted by the guard below
+ * and lays the band out correctly, but the outermost label can then sit partly
+ * off the page. The export path passes `VIEW_PDF_MARGIN_MM` (10 mm), which is
+ * comfortably more than any label produced by the 1-2-5 division sequence.
+ * This is a cosmetic bound only: it does not move the bar, so a division still
+ * measures exactly its labelled world length whatever the margin.
+ */
+export function addScaleStamp(base, options) {
+    const { marginMm } = options;
+    if (!Number.isFinite(marginMm) || marginMm < 0) {
+        throw new Error(`Invalid sheet margin: ${marginMm}mm. Expected a non-negative finite number.`);
+    }
+    if (!Number.isFinite(base.page.widthMm) || !Number.isFinite(base.page.heightMm) ||
+        base.page.widthMm <= 0 || base.page.heightMm <= 0) {
+        throw new Error('Cannot add a scale bar to a page that has no usable size.');
+    }
+    const stamp = buildScaleStamp({
+        worldToMm: base.transform.worldToMm,
+        availableWidthMm: Math.max(0, base.page.widthMm - marginMm * 2),
+        originXMm: marginMm,
+        // The drawing's bottom edge: `computePdfScaleLayout` puts it exactly one
+        // margin above the page bottom, so the band starts where the ink stops.
+        originYMm: base.page.heightMm - marginMm,
+    });
+    const page = {
+        widthMm: Math.max(base.page.widthMm, marginMm * 2 + stamp.widthMm),
+        heightMm: base.page.heightMm + stamp.heightMm,
+    };
+    if (!Number.isFinite(page.widthMm) || !Number.isFinite(page.heightMm)) {
+        throw new Error(`Adding a scale bar produced a non-finite page (${page.widthMm}x${page.heightMm}mm).`);
+    }
+    return { page, transform: base.transform, stamp };
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// INTERNALS
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Pick the division count and length whose bar comes closest to
+ * `TARGET_BAR_WIDTH_MM` without exceeding the space available.
+ *
+ * When nothing readable fits — a drawing narrower than the shortest useful bar
+ * — the shortest readable bar wins anyway and the caller's page grows to hold
+ * it. A bar squeezed to 3 mm would be present, in scale, and useless, which is
+ * the one outcome worse than a slightly wider sheet.
+ */
+function chooseBarDivisions(worldToMm, availableWidthMm) {
+    let fitting = null;
+    let fittingScore = Infinity;
+    let smallest = null;
+    let smallestWidth = Infinity;
+    let largest = null;
+    let largestWidth = -Infinity;
+    for (const divisions of DIVISION_COUNTS) {
+        for (const divisionMetres of DIVISION_STEPS_M) {
+            const widthMm = divisions * divisionMetres * worldToMm;
+            if (!Number.isFinite(widthMm) || widthMm <= 0)
+                continue;
+            const candidate = { divisions, divisionMetres };
+            if (widthMm > largestWidth) {
+                largest = candidate;
+                largestWidth = widthMm;
+            }
+            if (widthMm >= MIN_BAR_WIDTH_MM && widthMm < smallestWidth) {
+                smallest = candidate;
+                smallestWidth = widthMm;
+            }
+            if (widthMm >= MIN_BAR_WIDTH_MM && widthMm <= availableWidthMm) {
+                const score = Math.abs(widthMm - TARGET_BAR_WIDTH_MM);
+                if (score < fittingScore) {
+                    fitting = candidate;
+                    fittingScore = score;
+                }
+            }
+        }
+    }
+    const chosen = fitting ?? smallest ?? largest;
+    if (!chosen) {
+        throw new Error(`No scale bar length is expressible at ${worldToMm} mm per metre. Choose a less extreme scale.`);
+    }
+    return chosen;
+}
+/**
+ * How far right of `originXMm` the band reaches — the number that decides
+ * whether the page has to grow.
+ *
+ * Tick labels are deliberately NOT counted. Each is centred on its tick, so the
+ * last one overhangs the bar's end by half its width: about 2 mm of a 10 mm
+ * margin, on blank paper, and counting it would widen every sheet by that much
+ * for nothing. Only the bar and the left-aligned runs can actually reach past
+ * the drawing.
+ */
+function stampWidthMm(originXMm, barWidthMm, texts) {
+    let right = originXMm + barWidthMm;
+    for (const text of texts) {
+        if (text.align !== 'left')
+            continue;
+        const textRight = text.xMm + text.text.length * text.heightMm * TEXT_WIDTH_PER_HEIGHT;
+        if (textRight > right)
+            right = textRight;
+    }
+    return right - originXMm;
+}
+//# sourceMappingURL=scale-stamp.js.map

package/dist/sheet/scale-stamp.js.map

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

package/dist/view-plane.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Camera-derived section plane for exporting the 3D viewport as a to-scale
+ * vector PDF (issue #2042).
+ *
+ * # Defect class this module guards against
+ * A "1:100" page that is dimensionally plausible but geometrically wrong —
+ * **mirrored, skewed, or off-page**. Every one of those comes from the same
+ * root cause: the drawing basis and the page transform disagreeing.
+ *
+ *  - **Skew / wrong scale.** `projectTo2DBasis` is a plain pair of dot
+ *    products; it is a *rigid* projection only when `tangent`/`bitangent`
+ *    are unit-length AND mutually orthogonal AND perpendicular to the view
+ *    normal. An `up` vector taken verbatim from an orbiting camera is
+ *    generally NOT perpendicular to the view direction, so using it raw
+ *    stretches one screen axis: a wall measured on the print then reads
+ *    (say) 0.97 m instead of 1.00 m — a defect an engineer only discovers
+ *    with a ruler. The basis built here is re-orthogonalised, so
+ *    `|projected(a) − projected(b)| == |a − b|` exactly for any two points
+ *    lying in a plane parallel to the drawing plane.
+ *  - **Mirroring** (the #2119 defect class). The basis is fixed as
+ *    `cross(tangent, bitangent) === normal`, with `tangent` = screen-right
+ *    and `bitangent` = screen-up, so a point to the right of the camera
+ *    target lands to the right of the page centre after `worldPointToPdfMm`
+ *    (which applies the paper Y flip, and only that).
+ *  - **Off-page geometry.** The plane is placed strictly IN FRONT of all
+ *    eight world-bounds corners along the view direction, so every point of
+ *    the model has a positive view depth inside `[0, viewDepth]` — the
+ *    window the depth raster and the projection bands both key off. A plane
+ *    placed inside the model would silently cut away half the drawing.
+ *
+ * The camera is treated as an ORTHOGRAPHIC (parallel) projection along
+ * `position → target`. That is the only scale-truthful reading of "print
+ * what I see at 1:N": a perspective image has no single scale.
+ *
+ * All world coordinates are in the same metric, RTC-shifted world space as
+ * `MeshData.positions` + `MeshData.origin` (WebGL Y-up, metres).
+ */
+import type { MeshData } from '@ifc-lite/geometry';
+import type { SectionPlaneConfig, Vec3 } from './types.js';
+/** The subset of a 3D camera the parallel projection actually needs. */
+export interface CameraFrame {
+    /** Eye position (world, metres). */
+    position: Vec3;
+    /** Orbit target / look-at point (world, metres). */
+    target: Vec3;
+    /** Camera up hint. Need NOT be perpendicular to the view direction — it is
+     *  re-orthogonalised here — but must not be the zero vector. */
+    up: Vec3;
+}
+/** An axis-aligned world-space box (absolute world coords, metres). */
+export interface WorldBounds3D {
+    min: Vec3;
+    max: Vec3;
+}
+/** A synthetic section plane standing in for the camera. */
+export interface CameraSectionPlane {
+    /**
+     * Plane config whose `customPlane` carries the orthonormal camera basis.
+     * `flipped` is always `false` and `normal = −viewDir`, so the whole model
+     * sits on the KEPT (negative signed-depth) side and every point's VIEW
+     * depth `−signedDepth(p, plane)` is in `(0, viewDepth)`.
+     */
+    plane: SectionPlaneConfig;
+    /**
+     * Depth of the kept window along the view direction — the model's full
+     * extent plus padding on both ends. Feed it to `SectionConfig`'s
+     * `projectionBelowDepth` (with a tiny `projectionAboveDepth`) so the whole
+     * model projects as solid, and to the hidden-line occluder depth.
+     */
+    viewDepth: number;
+}
+/**
+ * World-space AABB of `meshes`, folding each mesh's local frame:
+ * `world = origin + positions[3i..3i+3]`.
+ *
+ * Reading `positions` without adding `origin` is the standing local-frame
+ * defect in this codebase (see `MeshData.origin`): it reports a box around
+ * the model ORIGIN instead of around the model, which would place the
+ * synthetic camera plane in the wrong place entirely.
+ *
+ * Returns `null` when no mesh contributes a vertex — the caller must decide
+ * what an empty view means rather than receive an inverted/infinite box.
+ */
+export declare function worldBoundsOfMeshes(meshes: readonly MeshData[]): WorldBounds3D | null;
+/** The eight corners of a world AABB, in a fixed order. */
+export declare function worldBoundsCorners(bounds: WorldBounds3D): Vec3[];
+/**
+ * Build the synthetic section plane that represents the current camera view.
+ *
+ * @param camera World-space eye/target/up.
+ * @param worldBounds World AABB of everything that will be drawn (see
+ *        {@link worldBoundsOfMeshes}).
+ *
+ * @throws when the camera degenerates (eye == target) or the bounds are
+ *         non-finite — both would otherwise yield a NaN transform and a
+ *         blank-but-plausible PDF page.
+ */
+export declare function buildCameraSectionPlane(camera: CameraFrame, worldBounds: WorldBounds3D): CameraSectionPlane;
+//# sourceMappingURL=view-plane.d.ts.map

package/dist/view-plane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-plane.d.ts","sourceRoot":"","sources":["../src/view-plane.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAe,kBAAkB,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAOxE,wEAAwE;AACxE,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,QAAQ,EAAE,IAAI,CAAC;IACf,oDAAoD;IACpD,MAAM,EAAE,IAAI,CAAC;IACb;oEACgE;IAChE,EAAE,EAAE,IAAI,CAAC;CACV;AAED,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,IAAI,CAAC;IACV,GAAG,EAAE,IAAI,CAAC;CACX;AAED,4DAA4D;AAC5D,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,KAAK,EAAE,kBAAkB,CAAC;IAC1B;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,GAAG,aAAa,GAAG,IAAI,CA4BrF;AAED,2DAA2D;AAC3D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,EAAE,CAWhE;AAoBD;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,aAAa,GACzB,kBAAkB,CA6FpB"}

package/dist/view-plane.js

@@ -0,0 +1,183 @@
+/* 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/. */
+import { vec3, vec3Cross, vec3Dot, vec3Length, vec3Normalize, vec3Sub } from './math.js';
+// ═══════════════════════════════════════════════════════════════════════════
+// WORLD BOUNDS
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * World-space AABB of `meshes`, folding each mesh's local frame:
+ * `world = origin + positions[3i..3i+3]`.
+ *
+ * Reading `positions` without adding `origin` is the standing local-frame
+ * defect in this codebase (see `MeshData.origin`): it reports a box around
+ * the model ORIGIN instead of around the model, which would place the
+ * synthetic camera plane in the wrong place entirely.
+ *
+ * Returns `null` when no mesh contributes a vertex — the caller must decide
+ * what an empty view means rather than receive an inverted/infinite box.
+ */
+export function worldBoundsOfMeshes(meshes) {
+    let minX = Infinity, minY = Infinity, minZ = Infinity;
+    let maxX = -Infinity, maxY = -Infinity, maxZ = -Infinity;
+    let any = false;
+    for (const mesh of meshes) {
+        const { positions, origin } = mesh;
+        const ox = origin ? origin[0] : 0;
+        const oy = origin ? origin[1] : 0;
+        const oz = origin ? origin[2] : 0;
+        const vertexCount = Math.floor(positions.length / 3);
+        for (let i = 0; i < vertexCount; i++) {
+            const x = positions[i * 3] + ox;
+            const y = positions[i * 3 + 1] + oy;
+            const z = positions[i * 3 + 2] + oz;
+            if (!Number.isFinite(x) || !Number.isFinite(y) || !Number.isFinite(z))
+                continue;
+            if (x < minX)
+                minX = x;
+            if (y < minY)
+                minY = y;
+            if (z < minZ)
+                minZ = z;
+            if (x > maxX)
+                maxX = x;
+            if (y > maxY)
+                maxY = y;
+            if (z > maxZ)
+                maxZ = z;
+            any = true;
+        }
+    }
+    if (!any)
+        return null;
+    return { min: vec3(minX, minY, minZ), max: vec3(maxX, maxY, maxZ) };
+}
+/** The eight corners of a world AABB, in a fixed order. */
+export function worldBoundsCorners(bounds) {
+    const { min, max } = bounds;
+    const corners = [];
+    for (const x of [min.x, max.x]) {
+        for (const y of [min.y, max.y]) {
+            for (const z of [min.z, max.z]) {
+                corners.push(vec3(x, y, z));
+            }
+        }
+    }
+    return corners;
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// CAMERA PLANE
+// ═══════════════════════════════════════════════════════════════════════════
+/** Smallest cross-product length treated as "up is parallel to the view". */
+const PARALLEL_EPSILON = 1e-6;
+/**
+ * A reference up that is guaranteed not to be parallel to `viewDir`: world
+ * +Y unless the camera looks (near-)straight up or down, in which case world
+ * +Z. Without this, a top-down / bottom-up view — the single most common
+ * plan-drawing camera — produces a zero-length right vector and a basis full
+ * of NaN, i.e. a blank PDF.
+ */
+function fallbackUp(viewDir) {
+    return Math.abs(viewDir.y) < 0.9 ? vec3(0, 1, 0) : vec3(0, 0, 1);
+}
+/**
+ * Build the synthetic section plane that represents the current camera view.
+ *
+ * @param camera World-space eye/target/up.
+ * @param worldBounds World AABB of everything that will be drawn (see
+ *        {@link worldBoundsOfMeshes}).
+ *
+ * @throws when the camera degenerates (eye == target) or the bounds are
+ *         non-finite — both would otherwise yield a NaN transform and a
+ *         blank-but-plausible PDF page.
+ */
+export function buildCameraSectionPlane(camera, worldBounds) {
+    const rawView = vec3Sub(camera.target, camera.position);
+    if (vec3Length(rawView) < PARALLEL_EPSILON) {
+        throw new Error('Cannot build a camera section plane: the camera position and target coincide, ' +
+            'so the view direction is undefined.');
+    }
+    const viewDir = vec3Normalize(rawView);
+    for (const v of [worldBounds.min, worldBounds.max]) {
+        if (!Number.isFinite(v.x) || !Number.isFinite(v.y) || !Number.isFinite(v.z)) {
+            throw new Error('Cannot build a camera section plane: world bounds must be finite.');
+        }
+    }
+    // ── Orthonormal basis ───────────────────────────────────────────────────
+    // tangent   = screen right
+    // bitangent = screen up, RE-ORTHOGONALISED against the view direction
+    // normal    = −viewDir (points back at the viewer)
+    //
+    // `cross(tangent, bitangent) === normal` holds by construction, which is
+    // what keeps the page from coming out mirrored (#2119 defect class).
+    // NORMALISED before the parallel test below. `|cross(viewDir, up)|` is
+    // `|up| * sin(angle)`, so testing it against a fixed epsilon without
+    // normalising makes the threshold depend on the LENGTH of `up`: a long up
+    // vector that is genuinely almost parallel to the view still clears the
+    // epsilon, and the basis is then built from a direction that is numerically
+    // noise. Normalising first makes PARALLEL_EPSILON a pure angle tolerance.
+    const upHint = vec3Length(camera.up) < PARALLEL_EPSILON ? fallbackUp(viewDir) : vec3Normalize(camera.up);
+    let right = vec3Cross(viewDir, upHint);
+    if (vec3Length(right) < PARALLEL_EPSILON) {
+        right = vec3Cross(viewDir, fallbackUp(viewDir));
+    }
+    const tangent = vec3Normalize(right);
+    const bitangent = vec3Normalize(vec3Cross(tangent, viewDir));
+    const normal = vec3(-viewDir.x, -viewDir.y, -viewDir.z);
+    // ── Plane placement: strictly in front of every bounds corner ───────────
+    // `s = dot(corner, viewDir)` grows AWAY from the viewer, so the nearest
+    // corner is at `sMin`. Putting the plane a pad before `sMin` guarantees
+    // every corner has a strictly positive view depth.
+    const corners = worldBoundsCorners(worldBounds);
+    let sMin = Infinity;
+    let sMax = -Infinity;
+    for (const c of corners) {
+        const s = vec3Dot(c, viewDir);
+        if (s < sMin)
+            sMin = s;
+        if (s > sMax)
+            sMax = s;
+    }
+    const span = sMax - sMin;
+    // Relative pad so it stays meaningful from a door handle to a city block,
+    // with an absolute floor for a degenerate (flat) box.
+    const pad = Math.max(span * 1e-3, 1e-4);
+    const planeS = sMin - pad;
+    // A genuine point ON the plane, used as the 2D basis origin so drawing
+    // coordinates stay centred on the model instead of on the world origin.
+    const center = vec3((worldBounds.min.x + worldBounds.max.x) / 2, (worldBounds.min.y + worldBounds.max.y) / 2, (worldBounds.min.z + worldBounds.max.z) / 2);
+    const shift = planeS - vec3Dot(center, viewDir);
+    const origin = vec3(center.x + viewDir.x * shift, center.y + viewDir.y * shift, center.z + viewDir.z * shift);
+    // dot(origin, normal) = −dot(origin, viewDir) = −planeS, computed in closed
+    // form rather than re-derived from `origin` so the offset carries no extra
+    // rounding from the point reconstruction above.
+    const distance = -planeS;
+    // Legacy cardinal fields. Every plane-aware helper (`signedDepth`,
+    // `projectPointForPlane`, `SectionCutter`, the depth raster) checks
+    // `customPlane` FIRST, so these only feed code that predates arbitrary
+    // planes. They are set to the closest cardinal reading of this plane
+    // rather than to a lie like `position: 0`.
+    const axis = dominantAxis(normal);
+    const position = origin[axis];
+    return {
+        plane: {
+            axis,
+            position,
+            flipped: false,
+            customPlane: { normal, distance, origin, tangent, bitangent },
+        },
+        viewDepth: span + pad * 2,
+    };
+}
+/** The cardinal axis the plane normal is most aligned with. */
+function dominantAxis(normal) {
+    const ax = Math.abs(normal.x);
+    const ay = Math.abs(normal.y);
+    const az = Math.abs(normal.z);
+    if (ax >= ay && ax >= az)
+        return 'x';
+    if (ay >= az)
+        return 'y';
+    return 'z';
+}
+//# sourceMappingURL=view-plane.js.map

package/dist/view-plane.js.map

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

package/dist/world-line-seeds.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Project world-space 3D segments (the section rim produced by
+ * `half-space-clip.ts`) into classified `DrawingLine`s (issue #2042).
+ *
+ * # Defect class this module guards against
+ * **A line producer that invents its own projection or its own depth
+ * convention.** Everything else in this pipeline — the section cutter, the
+ * edge extractor, the projection bands, and the hidden-line depth raster —
+ * derives 2D coordinates from `projectPointForPlane` and view depths from
+ * `−signedDepth`. A producer that re-implements either (a hand-rolled dot
+ * product, a forgotten sign, a `depth` measured from the wrong side) emits
+ * lines that look right on their own but sit in a *different frame* from the
+ * depth buffer they are sampled against — so hidden-line removal silently
+ * dashes visible edges, or leaves occluded ones solid, with no error
+ * anywhere. This module does nothing but call those two shared helpers.
+ *
+ * The rim of a section cut is, by definition, geometry lying IN the cut
+ * plane, so it is emitted as `category: 'cut'` (heavy line weight). It is
+ * still handed to the hidden-line stage rather than drawn unconditionally:
+ * on an oblique 3D view the far side of a cut object is genuinely behind
+ * other geometry and must print dashed.
+ */
+import type { DrawingLine, SectionPlaneConfig, Vec3 } from './types.js';
+/** A world-space segment to be drawn, with its source element metadata. */
+export interface WorldLineSeed {
+    start: Vec3;
+    end: Vec3;
+    entityId: number;
+    ifcType: string;
+    modelIndex: number;
+}
+/**
+ * Project `seeds` into drawing lines against `plane`.
+ *
+ * Segments whose 2D projection collapses to a point (an edge parallel to the
+ * view direction) are dropped: they carry no information on the page and
+ * would only add zero-length strokes for the line merger and the PDF writer
+ * to trip over.
+ */
+export declare function projectWorldLineSeeds(seeds: readonly WorldLineSeed[], plane: SectionPlaneConfig): DrawingLine[];
+//# sourceMappingURL=world-line-seeds.d.ts.map

package/dist/world-line-seeds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-line-seeds.d.ts","sourceRoot":"","sources":["../src/world-line-seeds.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAW,kBAAkB,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIjF,2EAA2E;AAC3E,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,IAAI,CAAC;IACZ,GAAG,EAAE,IAAI,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,KAAK,EAAE,kBAAkB,GACxB,WAAW,EAAE,CA8Bf"}