@math.gl/geometry 5.0.0-alpha.2 → 5.0.0-alpha.20

package/dist/lib/hinge-tree.js

@@ -0,0 +1,144 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+import { Matrix4 } from '@math.gl/core';
+/** Experimental rigid-panel kinematics, independent of mesh topology and rendering.
+ * Snapshots its inputs. Does not infer shared edges, solve closed loops or detect collisions.
+ */
+export class HingeTree {
+    constructor(panels) {
+        this.local = new Matrix4();
+        this.world = new Matrix4();
+        this.root = new Matrix4();
+        this.panelCount = panels.length;
+        const children = panels.map(() => []);
+        const order = [];
+        this.joints = panels.map((panel, index) => {
+            const { parent } = panel;
+            if (!Number.isInteger(parent) || parent < -1 || parent >= panels.length || parent === index) {
+                throw new RangeError('Invalid hinge parent index');
+            }
+            if (parent === -1)
+                order.push(index);
+            else
+                children[parent].push(index);
+            const rest = new Matrix4();
+            if (panel.restTransform !== undefined) {
+                validateRigidTransform(panel.restTransform);
+                rest.copy(panel.restTransform);
+            }
+            const pivot = parent === -1 ? [0, 0, 0] : copyVector(panel.pivot);
+            const axis = parent === -1 ? [1, 0, 0] : copyVector(panel.axis);
+            const length = Math.hypot(...axis);
+            if (!Number.isFinite(length) || length === 0)
+                throw new RangeError('Invalid hinge axis');
+            for (let i = 0; i < 3; i++)
+                axis[i] /= length;
+            return {
+                parent,
+                rest,
+                pivot,
+                negativePivot: pivot.map(value => -value),
+                axis
+            };
+        });
+        // Iterative traversal supports deep trees without consuming the call stack.
+        for (let i = 0; i < order.length; i++) {
+            for (const child of children[order[i]])
+                order.push(child);
+        }
+        if (order.length !== panels.length)
+            throw new RangeError('Hinge parents contain a cycle');
+        this.order = order;
+        this.angles = new Float64Array(panels.length);
+    }
+    /** Evaluate one angle per panel in radians (root angles must be zero).
+     * Returns column-major matrices in input-panel order, 16 doubles per panel.
+     * rootTransform places the whole forest; omitted means identity.
+     * Output may alias the inputs: angles and root transform are snapshotted first.
+     * Finite inputs that overflow during composition throw; output may then be partial.
+     */
+    evaluate(angles, output = new Float64Array(this.panelCount * 16), rootTransform) {
+        if (angles.length !== this.panelCount)
+            throw new RangeError('Expected one angle per panel');
+        if (!(output instanceof Float64Array) || output.length !== this.panelCount * 16) {
+            throw new RangeError('Expected 16 Float64 values per panel');
+        }
+        for (let i = 0; i < angles.length; i++) {
+            if (!Number.isFinite(angles[i]) || (this.joints[i].parent === -1 && angles[i] !== 0)) {
+                throw new RangeError('Expected finite angles and zero root angles');
+            }
+            this.angles[i] = angles[i];
+        }
+        this.root.identity();
+        if (rootTransform !== undefined) {
+            validateRigidTransform(rootTransform);
+            this.root.copy(rootTransform);
+        }
+        for (const index of this.order) {
+            const joint = this.joints[index];
+            this.local.identity();
+            if (joint.parent !== -1) {
+                this.local
+                    .translate(joint.pivot)
+                    .rotateAxis(this.angles[index], joint.axis)
+                    .translate(joint.negativePivot);
+            }
+            this.local.multiplyRight(joint.rest);
+            if (joint.parent === -1)
+                this.world.copy(this.root);
+            else {
+                for (let i = 0; i < 16; i++)
+                    this.world[i] = output[joint.parent * 16 + i];
+            }
+            this.world.multiplyRight(this.local);
+            for (let i = 0; i < 16; i++) {
+                if (!Number.isFinite(this.world[i]))
+                    throw new RangeError('Hinge transform overflow');
+                output[index * 16 + i] = this.world[i];
+            }
+        }
+        return output;
+    }
+}
+function copyVector(vector) {
+    if (!vector ||
+        vector.length !== 3 ||
+        !Number.isFinite(vector[0]) ||
+        !Number.isFinite(vector[1]) ||
+        !Number.isFinite(vector[2])) {
+        throw new RangeError('Expected a finite hinge pivot and axis');
+    }
+    return [...vector];
+}
+/** Accept proper rigid affine transforms, allowing numerical roundoff. */
+function validateRigidTransform(matrix) {
+    if (matrix.length !== 16)
+        throw new RangeError('Expected a 4x4 rigid transform');
+    for (let i = 0; i < 16; i++) {
+        if (!Number.isFinite(matrix[i]))
+            throw new RangeError('Expected a finite rigid transform');
+    }
+    const tolerance = 1e-6;
+    if (Math.abs(matrix[3]) > tolerance ||
+        Math.abs(matrix[7]) > tolerance ||
+        Math.abs(matrix[11]) > tolerance ||
+        Math.abs(matrix[15] - 1) > tolerance)
+        throw new RangeError('Expected an affine rigid transform');
+    for (let a = 0; a < 3; a++) {
+        for (let b = a; b < 3; b++) {
+            let dot = 0;
+            for (let row = 0; row < 3; row++)
+                dot += matrix[a * 4 + row] * matrix[b * 4 + row];
+            if (Math.abs(dot - (a === b ? 1 : 0)) > tolerance) {
+                throw new RangeError('Rigid transforms cannot scale or shear');
+            }
+        }
+    }
+    const determinant = matrix[0] * (matrix[5] * matrix[10] - matrix[6] * matrix[9]) -
+        matrix[4] * (matrix[1] * matrix[10] - matrix[2] * matrix[9]) +
+        matrix[8] * (matrix[1] * matrix[6] - matrix[2] * matrix[5]);
+    if (Math.abs(determinant - 1) > tolerance)
+        throw new RangeError('Rigid transforms cannot reflect');
+}
+//# sourceMappingURL=hinge-tree.js.map

package/dist/lib/hinge-tree.js.map

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

package/dist/parametric/lathe-geometry.d.ts

@@ -0,0 +1,14 @@
+import type { PrimitiveGeometryProps } from "../geometries/geometry-helpers.js";
+import { ParametricGeometry } from "./parametric-geometry.js";
+export type LatheGeometryProps = PrimitiveGeometryProps & {
+    /** Ordered [radius, height] profile, with nonnegative radii. */
+    points: readonly (readonly [number, number])[];
+    segments?: number;
+    phiStart?: number;
+    phiLength?: number;
+};
+/** Revolves a piecewise-linear profile around Y; smooth profile normals, no end caps. */
+export declare class LatheGeometry extends ParametricGeometry {
+    constructor(props: LatheGeometryProps);
+}
+//# sourceMappingURL=lathe-geometry.d.ts.map

package/dist/parametric/lathe-geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lathe-geometry.d.ts","sourceRoot":"","sources":["../../src/parametric/lathe-geometry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,sBAAsB,EAAC,0CAAuC;AAC3E,OAAO,EAAC,kBAAkB,EAAa,iCAA8B;AACrE,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,GAAG;IACxD,gEAAgE;IAChE,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AACF,yFAAyF;AACzF,qBAAa,aAAc,SAAQ,kBAAkB;gBACvC,KAAK,EAAE,kBAAkB;CAuDtC"}

package/dist/parametric/lathe-geometry.js

@@ -0,0 +1,48 @@
+import { ParametricGeometry, normalized } from "./parametric-geometry.js";
+/** Revolves a piecewise-linear profile around Y; smooth profile normals, no end caps. */
+export class LatheGeometry extends ParametricGeometry {
+    constructor(props) {
+        const { points, segments = 48, phiStart = 0, phiLength = Math.PI * 2 } = props;
+        if (!points ||
+            points.length < 2 ||
+            points.some(p => p.length !== 2 || !p.every(Number.isFinite) || p[0] < 0))
+            throw new RangeError('Lathe needs at least two finite [nonnegative radius, height] points');
+        if (!Number.isFinite(phiStart) ||
+            !Number.isFinite(phiLength) ||
+            phiLength <= 0 ||
+            phiLength > Math.PI * 2)
+            throw new RangeError('Invalid lathe angular sweep');
+        if (segments < 3)
+            throw new RangeError('Lathe requires at least three angular segments');
+        const profile = points.map(p => [...p]);
+        const edgeNormals = profile.slice(1).map((p, i) => {
+            const dr = p[0] - profile[i][0], dy = p[1] - profile[i][1];
+            if (dr === 0 && dy === 0)
+                throw new RangeError('Consecutive profile points must differ');
+            return normalized([dy, -dr, 0]);
+        });
+        const profileNormals = profile.map((_, i) => {
+            const before = edgeNormals[Math.max(0, i - 1)], after = edgeNormals[Math.min(i, edgeNormals.length - 1)];
+            return normalized(before.map((value, axis) => value + after[axis]));
+        });
+        const section = (v) => {
+            const coordinate = v * (profile.length - 1), i = Math.min(profile.length - 2, Math.floor(coordinate));
+            return { i, t: coordinate - i };
+        };
+        super({
+            ...props,
+            uSegments: segments,
+            vSegments: profile.length - 1,
+            periodicU: phiLength === Math.PI * 2,
+            sample: (u, v) => {
+                const { i, t } = section(v), radius = profile[i][0] * (1 - t) + profile[i + 1][0] * t, height = profile[i][1] * (1 - t) + profile[i + 1][1] * t, theta = phiStart + u * phiLength;
+                return [radius * Math.cos(theta), height, -radius * Math.sin(theta)];
+            },
+            normal: (u, v) => {
+                const { i, t } = section(v), n = profileNormals[i].map((value, axis) => value * (1 - t) + profileNormals[i + 1][axis] * t), theta = phiStart + u * phiLength;
+                return [n[0] * Math.cos(theta), n[1], -n[0] * Math.sin(theta)];
+            }
+        });
+    }
+}
+//# sourceMappingURL=lathe-geometry.js.map

package/dist/parametric/lathe-geometry.js.map

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

package/dist/parametric/parametric-geometry.d.ts

@@ -0,0 +1,20 @@
+import { Geometry } from "../lib/geometry.js";
+import { type PrimitiveGeometryProps } from "../geometries/geometry-helpers.js";
+export type SurfaceSampler = (u: number, v: number) => Readonly<ArrayLike<number>>;
+export type ParametricGeometryProps = PrimitiveGeometryProps & {
+    /** Samples the normalized [0,1]² parameter domain. */
+    sample: SurfaceSampler;
+    /** Optional analytic normals; otherwise estimated from neighboring samples. */
+    normal?: SurfaceSampler;
+    uSegments?: number;
+    vSegments?: number;
+    /** Closed axes duplicate their first position/normal at UV 1. */
+    periodicU?: boolean;
+    periodicV?: boolean;
+};
+/** Indexed surface grid. Front faces and normals follow ∂P/∂u × ∂P/∂v. */
+export declare class ParametricGeometry extends Geometry {
+    constructor(props: ParametricGeometryProps);
+}
+export declare function normalized(vector: number[]): number[];
+//# sourceMappingURL=parametric-geometry.d.ts.map

package/dist/parametric/parametric-geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parametric-geometry.d.ts","sourceRoot":"","sources":["../../src/parametric/parametric-geometry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,QAAQ,EAAC,2BAAwB;AACzC,OAAO,EAAiB,KAAK,sBAAsB,EAAC,0CAAuC;AAE3F,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;AACnF,MAAM,MAAM,uBAAuB,GAAG,sBAAsB,GAAG;IAC7D,sDAAsD;IACtD,MAAM,EAAE,cAAc,CAAC;IACvB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,0EAA0E;AAC1E,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,KAAK,EAAE,uBAAuB;CAoF3C;AAMD,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAMrD"}

package/dist/parametric/parametric-geometry.js

@@ -0,0 +1,88 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+import { Geometry } from "../lib/geometry.js";
+import { assertSegments } from "../geometries/geometry-helpers.js";
+/** Indexed surface grid. Front faces and normals follow ∂P/∂u × ∂P/∂v. */
+export class ParametricGeometry extends Geometry {
+    constructor(props) {
+        const { sample, normal, uSegments = 32, vSegments = 32, periodicU = false, periodicV = false } = props;
+        assertSegments(uSegments, 'uSegments');
+        assertSegments(vSegments, 'vSegments');
+        const count = (uSegments + 1) * (vSegments + 1);
+        const indexCount = uSegments * vSegments * 6;
+        if (!Number.isSafeInteger(indexCount) || indexCount > 0xffffffff)
+            throw new RangeError('Surface exceeds 32-bit index-buffer length');
+        if (!Number.isSafeInteger(count) || count > 0xffffffff)
+            throw new RangeError('Surface exceeds 32-bit indexing');
+        const positions = new Float32Array(count * 3), normals = new Float32Array(count * 3), uvs = new Float32Array(count * 2);
+        const canonical = (value, periodic) => periodic ? ((value % 1) + 1) % 1 : Math.max(0, Math.min(1, value));
+        const evaluate = (u, v) => readVector(sample(canonical(u, periodicU), canonical(v, periodicV)));
+        // A small finite-difference step estimates smooth-surface normals independently
+        // of tessellation density. Open boundaries use one-sided differences.
+        const step = 1e-5;
+        let row = 0;
+        for (let j = 0; j <= vSegments; j++)
+            for (let i = 0; i <= uSegments; i++, row++) {
+                const u = i / uSegments, v = j / vSegments;
+                const sampleU = canonical(u, periodicU), sampleV = canonical(v, periodicV);
+                positions.set(evaluate(sampleU, sampleV), row * 3);
+                let n;
+                if (normal)
+                    n = readVector(normal(sampleU, sampleV));
+                else {
+                    const left = evaluate(sampleU - step, sampleV), right = evaluate(sampleU + step, sampleV);
+                    const below = evaluate(sampleU, sampleV - step), above = evaluate(sampleU, sampleV + step);
+                    const du = normalized(right.map((value, axis) => value - left[axis]));
+                    const dv = normalized(above.map((value, axis) => value - below[axis]));
+                    n = [
+                        du[1] * dv[2] - du[2] * dv[1],
+                        du[2] * dv[0] - du[0] * dv[2],
+                        du[0] * dv[1] - du[1] * dv[0]
+                    ];
+                }
+                normals.set(normalized(n), row * 3);
+                uvs.set([u, v], row * 2);
+            }
+        for (const value of positions)
+            if (!Number.isFinite(value))
+                throw new RangeError('Positions must be representable as Float32');
+        const indices = count > 0xffff ? new Uint32Array(indexCount) : new Uint16Array(indexCount);
+        const stride = uSegments + 1;
+        let cursor = 0;
+        for (let j = 0; j < vSegments; j++)
+            for (let i = 0; i < uSegments; i++) {
+                const a = j * stride + i, b = a + 1, c = a + stride, d = c + 1;
+                indices[cursor++] = a;
+                indices[cursor++] = b;
+                indices[cursor++] = d;
+                indices[cursor++] = a;
+                indices[cursor++] = d;
+                indices[cursor++] = c;
+            }
+        super({
+            id: props.id,
+            topology: 'triangle-list',
+            indices,
+            attributes: {
+                POSITION: { size: 3, value: positions },
+                NORMAL: { size: 3, value: normals },
+                TEXCOORD_0: { size: 2, value: uvs },
+                ...props.attributes
+            }
+        });
+    }
+}
+function readVector(value) {
+    if (!value || value.length !== 3 || !Array.from(value).every(Number.isFinite))
+        throw new RangeError('Surface samples and normals must be finite triples');
+    return Array.from(value);
+}
+export function normalized(vector) {
+    const scale = Math.max(...vector.map(Math.abs));
+    if (!scale)
+        return [0, 0, 0];
+    const scaled = vector.map(value => value / scale), length = Math.hypot(...scaled);
+    return scaled.map(value => (value === 0 ? 0 : value / length));
+}
+//# sourceMappingURL=parametric-geometry.js.map

package/dist/parametric/parametric-geometry.js.map

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

package/dist/parametric/torus-geometry.d.ts

@@ -0,0 +1,19 @@
+import { type PrimitiveGeometryProps } from "../geometries/geometry-helpers.js";
+import { ParametricGeometry } from "./parametric-geometry.js";
+export type TorusGeometryProps = PrimitiveGeometryProps & {
+    majorRadius?: number;
+    minorRadius?: number;
+    majorSegments?: number;
+    minorSegments?: number;
+    /** Sweep in radians, (0, 2π]. Partial sweeps have open ends unless cap is enabled. */
+    arc?: number;
+    /** Rotation in radians about Y; positive angles turn toward negative Z. */
+    startAngle?: number;
+    /** Close partial sweeps with flat end disks. Ignored for a full revolution. */
+    cap?: boolean;
+};
+/** Ring torus around Y, with outward analytic normals and separate UV seam rows. */
+export declare class TorusGeometry extends ParametricGeometry {
+    constructor(props?: TorusGeometryProps);
+}
+//# sourceMappingURL=torus-geometry.d.ts.map

package/dist/parametric/torus-geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"torus-geometry.d.ts","sourceRoot":"","sources":["../../src/parametric/torus-geometry.ts"],"names":[],"mappings":"AAIA,OAAO,EAIL,KAAK,sBAAsB,EAC5B,0CAAuC;AACxC,OAAO,EAAC,kBAAkB,EAAC,iCAA8B;AACzD,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,GAAG;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sFAAsF;IACtF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AACF,oFAAoF;AACpF,qBAAa,aAAc,SAAQ,kBAAkB;gBACvC,KAAK,GAAE,kBAAuB;CA4F3C"}

package/dist/parametric/torus-geometry.js

@@ -0,0 +1,89 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+import { Geometry } from "../lib/geometry.js";
+import { assertPositive, assertSegments, makeIndices } from "../geometries/geometry-helpers.js";
+import { ParametricGeometry } from "./parametric-geometry.js";
+/** Ring torus around Y, with outward analytic normals and separate UV seam rows. */
+export class TorusGeometry extends ParametricGeometry {
+    constructor(props = {}) {
+        const { majorRadius = 1, minorRadius = 0.3, majorSegments = 48, minorSegments = 24, arc = Math.PI * 2, startAngle = 0, cap = false } = props;
+        assertPositive(majorRadius, 'majorRadius');
+        assertPositive(minorRadius, 'minorRadius');
+        if (minorRadius >= majorRadius)
+            throw new RangeError('Ring torus requires minorRadius < majorRadius');
+        if (!Number.isFinite(arc) || arc <= 0 || arc > Math.PI * 2)
+            throw new RangeError('arc must be in (0, 2π]');
+        assertSegments(majorSegments, 'majorSegments', 3);
+        assertSegments(minorSegments, 'minorSegments', 3);
+        if (!Number.isFinite(startAngle))
+            throw new RangeError('startAngle must be finite');
+        const hasCaps = cap && arc < Math.PI * 2;
+        super({
+            ...props,
+            attributes: hasCaps ? undefined : props.attributes,
+            uSegments: majorSegments,
+            vSegments: minorSegments,
+            periodicU: arc === Math.PI * 2,
+            periodicV: true,
+            sample: (u, v) => {
+                const theta = startAngle + u * arc, phi = v * Math.PI * 2, radius = majorRadius + minorRadius * Math.cos(phi);
+                return [radius * Math.cos(theta), minorRadius * Math.sin(phi), -radius * Math.sin(theta)];
+            },
+            normal: (u, v) => [
+                Math.cos(v * Math.PI * 2) * Math.cos(startAngle + u * arc),
+                Math.sin(v * Math.PI * 2),
+                -Math.cos(v * Math.PI * 2) * Math.sin(startAngle + u * arc)
+            ]
+        });
+        if (hasCaps) {
+            const surfacePositions = this.attributes['POSITION'].value;
+            const positions = Array.from(surfacePositions);
+            const normals = Array.from(this.attributes['NORMAL'].value);
+            const textureCoordinates = Array.from(this.attributes['TEXCOORD_0'].value);
+            const indices = Array.from(this.indices.value);
+            for (const [angle, direction] of [
+                [startAngle, -1],
+                [startAngle + arc, 1]
+            ]) {
+                const normal = [-Math.sin(angle) * direction, 0, -Math.cos(angle) * direction];
+                const centerIndex = positions.length / 3;
+                positions.push(majorRadius * Math.cos(angle), 0, -majorRadius * Math.sin(angle));
+                normals.push(...normal);
+                textureCoordinates.push(0.5, 0.5);
+                for (let minorSegment = 0; minorSegment <= minorSegments; minorSegment++) {
+                    // The final disk vertex duplicates the first exactly, matching the tube UV seam.
+                    const tubeAngle = ((minorSegment % minorSegments) * Math.PI * 2) / minorSegments;
+                    // Copy boundary positions so disk and tube edges match bit for bit.
+                    const boundaryOffset = (minorSegment * (majorSegments + 1) + (direction < 0 ? 0 : majorSegments)) * 3;
+                    positions.push(...surfacePositions.slice(boundaryOffset, boundaryOffset + 3));
+                    normals.push(...normal);
+                    textureCoordinates.push((Math.cos(tubeAngle) + 1) / 2, (Math.sin(tubeAngle) + 1) / 2);
+                    if (minorSegment < minorSegments) {
+                        const firstIndex = centerIndex + minorSegment + 1;
+                        const secondIndex = firstIndex + 1;
+                        indices.push(centerIndex, ...(direction > 0 ? [secondIndex, firstIndex] : [firstIndex, secondIndex]));
+                    }
+                }
+            }
+            const cappedGeometry = new Geometry({
+                id: this.id,
+                topology: this.topology,
+                indices: makeIndices(positions.length / 3, indices),
+                attributes: {
+                    POSITION: { size: 3, value: new Float32Array(positions) },
+                    NORMAL: { size: 3, value: new Float32Array(normals) },
+                    TEXCOORD_0: { size: 2, value: new Float32Array(textureCoordinates) },
+                    ...props.attributes
+                }
+            });
+            // Finish construction with validated cap data while retaining ParametricGeometry inheritance.
+            Object.assign(this, {
+                attributes: cappedGeometry.attributes,
+                indices: cappedGeometry.indices,
+                vertexCount: cappedGeometry.vertexCount
+            });
+        }
+    }
+}
+//# sourceMappingURL=torus-geometry.js.map

package/dist/parametric/torus-geometry.js.map

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