@math.gl/geometry 5.0.0-alpha.12 → 5.0.0-alpha.14

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,15 @@
+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. */
+    arc?: number;
+};
+/** 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":"AAGA,OAAO,EAAiB,KAAK,sBAAsB,EAAC,0CAAuC;AAC3F,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,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AACF,oFAAoF;AACpF,qBAAa,aAAc,SAAQ,kBAAkB;gBACvC,KAAK,GAAE,kBAAuB;CAmC3C"}

package/dist/parametric/torus-geometry.js

@@ -0,0 +1,36 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+import { assertPositive } 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 } = 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π]');
+        if (majorSegments < 3 || minorSegments < 3)
+            throw new RangeError('Torus requires at least three segments per axis');
+        super({
+            ...props,
+            uSegments: majorSegments,
+            vSegments: minorSegments,
+            periodicU: arc === Math.PI * 2,
+            periodicV: true,
+            sample: (u, v) => {
+                const theta = 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(u * arc),
+                Math.sin(v * Math.PI * 2),
+                -Math.cos(v * Math.PI * 2) * Math.sin(u * arc)
+            ]
+        });
+    }
+}
+//# 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":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;AAC5D,OAAO,EAAC,cAAc,EAA8B,0CAAuC;AAC3F,OAAO,EAAC,kBAAkB,EAAC,iCAA8B;AASzD,oFAAoF;AACpF,MAAM,OAAO,aAAc,SAAQ,kBAAkB;IACnD,YAAY,QAA4B,EAAE;QACxC,MAAM,EACJ,WAAW,GAAG,CAAC,EACf,WAAW,GAAG,GAAG,EACjB,aAAa,GAAG,EAAE,EAClB,aAAa,GAAG,EAAE,EAClB,GAAG,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,EAClB,GAAG,KAAK,CAAC;QACV,cAAc,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;QAC3C,cAAc,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;QAC3C,IAAI,WAAW,IAAI,WAAW;YAC5B,MAAM,IAAI,UAAU,CAAC,+CAA+C,CAAC,CAAC;QACxE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC;YACxD,MAAM,IAAI,UAAU,CAAC,wBAAwB,CAAC,CAAC;QACjD,IAAI,aAAa,GAAG,CAAC,IAAI,aAAa,GAAG,CAAC;YACxC,MAAM,IAAI,UAAU,CAAC,iDAAiD,CAAC,CAAC;QAC1E,KAAK,CAAC;YACJ,GAAG,KAAK;YACR,SAAS,EAAE,aAAa;YACxB,SAAS,EAAE,aAAa;YACxB,SAAS,EAAE,GAAG,KAAK,IAAI,CAAC,EAAE,GAAG,CAAC;YAC9B,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACf,MAAM,KAAK,GAAG,CAAC,GAAG,GAAG,EACnB,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,EACrB,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACrD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;YAC5F,CAAC;YACD,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAChB,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;gBAC7C,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;gBACzB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;aAC/C;SACF,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/parametric.cjs

@@ -0,0 +1,276 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// dist/parametric.js
+var parametric_exports = {};
+__export(parametric_exports, {
+  LatheGeometry: () => LatheGeometry,
+  ParametricGeometry: () => ParametricGeometry,
+  TorusGeometry: () => TorusGeometry
+});
+module.exports = __toCommonJS(parametric_exports);
+
+// dist/lib/geometry.js
+var geometryId = 0;
+var Geometry = class {
+  constructor(props) {
+    this.userData = {};
+    this.id = props.id || `geometry-${++geometryId}`;
+    this.topology = props.topology;
+    this.attributes = {};
+    let indices = props.indices ? normalizeAttribute(props.indices) : void 0;
+    for (const [name, input] of Object.entries(props.attributes || {})) {
+      const attribute = normalizeAttribute(input);
+      if (name === "POSITION" || name === "positions") {
+        attribute.size || (attribute.size = 3);
+      }
+      if (name === "indices") {
+        if (indices)
+          throw new Error("Geometry has multiple index attributes");
+        indices = attribute;
+      } else {
+        this.attributes[name] = attribute;
+      }
+    }
+    if (indices) {
+      if (!(indices.value instanceof Uint16Array || indices.value instanceof Uint32Array)) {
+        throw new Error("Geometry indices must be a Uint16Array or Uint32Array");
+      }
+      indices.size = 1;
+      this.indices = indices;
+      validateIndices(indices, this.attributes);
+    }
+    this.vertexCount = props.vertexCount ?? calculateVertexCount(this.attributes, this.indices);
+    if (!Number.isInteger(this.vertexCount) || this.vertexCount < 0) {
+      throw new Error("Geometry vertexCount must be a non-negative integer");
+    }
+  }
+  getVertexCount() {
+    return this.vertexCount;
+  }
+  getAttributes() {
+    return this.indices ? { indices: this.indices, ...this.attributes } : this.attributes;
+  }
+};
+function normalizeAttribute(input) {
+  const attribute = isTypedArray(input) ? { value: input } : { ...input };
+  if (!isTypedArray(attribute.value)) {
+    throw new Error("Geometry attributes must contain a typed-array value");
+  }
+  if (attribute.size !== void 0 && (!Number.isInteger(attribute.size) || attribute.size < 1)) {
+    throw new Error("Geometry attribute size must be a positive integer");
+  }
+  if (attribute.size && attribute.value.length % attribute.size !== 0) {
+    throw new Error("Geometry attribute length must be divisible by its size");
+  }
+  return attribute;
+}
+function isTypedArray(value) {
+  return ArrayBuffer.isView(value) && !(value instanceof DataView);
+}
+function validateIndices(indices, attributes) {
+  let maximumIndex = -1;
+  for (const index of indices.value)
+    maximumIndex = Math.max(maximumIndex, Number(index));
+  for (const [name, attribute] of Object.entries(attributes)) {
+    if (!attribute.constant && attribute.size) {
+      const attributeVertexCount = attribute.value.length / attribute.size;
+      if (maximumIndex >= attributeVertexCount) {
+        throw new Error(`Geometry index ${maximumIndex} exceeds ${name} vertex count ${attributeVertexCount}`);
+      }
+    }
+  }
+}
+function calculateVertexCount(attributes, indices) {
+  if (indices)
+    return indices.value.length;
+  let count = Infinity;
+  for (const attribute of Object.values(attributes)) {
+    if (!attribute.constant && attribute.size) {
+      count = Math.min(count, attribute.value.length / attribute.size);
+    }
+  }
+  if (!Number.isFinite(count))
+    throw new Error("Geometry has no countable attributes");
+  return count;
+}
+
+// dist/geometries/geometry-helpers.js
+function assertPositive(value, name) {
+  if (!Number.isFinite(value) || value <= 0)
+    throw new Error(`${name} must be greater than zero`);
+}
+function assertSegments(value, name, minimum = 1) {
+  if (!Number.isInteger(value) || value < minimum)
+    throw new Error(`${name} must be an integer >= ${minimum}`);
+}
+
+// dist/parametric/parametric-geometry.js
+var ParametricGeometry = class 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 > 4294967295)
+      throw new RangeError("Surface exceeds 32-bit index-buffer length");
+    if (!Number.isSafeInteger(count) || count > 4294967295)
+      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)));
+    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 > 65535 ? 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);
+}
+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);
+}
+
+// dist/parametric/torus-geometry.js
+var TorusGeometry = class extends ParametricGeometry {
+  constructor(props = {}) {
+    const { majorRadius = 1, minorRadius = 0.3, majorSegments = 48, minorSegments = 24, arc = Math.PI * 2 } = 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\u03C0]");
+    if (majorSegments < 3 || minorSegments < 3)
+      throw new RangeError("Torus requires at least three segments per axis");
+    super({
+      ...props,
+      uSegments: majorSegments,
+      vSegments: minorSegments,
+      periodicU: arc === Math.PI * 2,
+      periodicV: true,
+      sample: (u, v) => {
+        const theta = 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(u * arc),
+        Math.sin(v * Math.PI * 2),
+        -Math.cos(v * Math.PI * 2) * Math.sin(u * arc)
+      ]
+    });
+  }
+};
+
+// dist/parametric/lathe-geometry.js
+var LatheGeometry = class 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=parametric.cjs.map

package/dist/parametric.cjs.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../src/parametric.ts", "../src/lib/geometry.ts", "../src/geometries/geometry-helpers.ts", "../src/parametric/parametric-geometry.ts", "../src/parametric/torus-geometry.ts", "../src/parametric/lathe-geometry.ts"],
+  "mappings": "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",
+  "names": []
+}

package/dist/parametric.d.ts

@@ -0,0 +1,7 @@
+export { ParametricGeometry } from "./parametric/parametric-geometry.js";
+export type { ParametricGeometryProps, SurfaceSampler } from "./parametric/parametric-geometry.js";
+export { TorusGeometry } from "./parametric/torus-geometry.js";
+export type { TorusGeometryProps } from "./parametric/torus-geometry.js";
+export { LatheGeometry } from "./parametric/lathe-geometry.js";
+export type { LatheGeometryProps } from "./parametric/lathe-geometry.js";
+//# sourceMappingURL=parametric.d.ts.map

package/dist/parametric.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parametric.d.ts","sourceRoot":"","sources":["../src/parametric.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,kBAAkB,EAAC,4CAAyC;AACpE,YAAY,EAAC,uBAAuB,EAAE,cAAc,EAAC,4CAAyC;AAC9F,OAAO,EAAC,aAAa,EAAC,uCAAoC;AAC1D,YAAY,EAAC,kBAAkB,EAAC,uCAAoC;AACpE,OAAO,EAAC,aAAa,EAAC,uCAAoC;AAC1D,YAAY,EAAC,kBAAkB,EAAC,uCAAoC"}

package/dist/parametric.js

@@ -0,0 +1,7 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+export { ParametricGeometry } from "./parametric/parametric-geometry.js";
+export { TorusGeometry } from "./parametric/torus-geometry.js";
+export { LatheGeometry } from "./parametric/lathe-geometry.js";
+//# sourceMappingURL=parametric.js.map

package/dist/parametric.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parametric.js","sourceRoot":"","sources":["../src/parametric.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;AAC5D,OAAO,EAAC,kBAAkB,EAAC,4CAAyC;AAEpE,OAAO,EAAC,aAAa,EAAC,uCAAoC;AAE1D,OAAO,EAAC,aAAa,EAAC,uCAAoC"}

package/package.json

@@ -6,7 +6,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "5.0.0-alpha.12",
+  "version": "5.0.0-alpha.14",
   "keywords": [
     "geometry",
     "gltf",
@@ -27,6 +27,11 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
+    },
+    "./parametric": {
+      "types": "./dist/parametric.d.ts",
+      "import": "./dist/parametric.js",
+      "require": "./dist/parametric.cjs"
     }
   },
   "files": [
@@ -34,7 +39,7 @@
     "src"
   ],
   "dependencies": {
-    "@math.gl/types": "5.0.0-alpha.12"
+    "@math.gl/types": "5.0.0-alpha.14"
   },
-  "gitHead": "9f9ed72b110b898a5e2df55984b6cff67f8feab2"
+  "gitHead": "c4f1cbdd7fc9136a873efc511356cace8ff0001a"
 }

package/src/parametric/lathe-geometry.ts

@@ -0,0 +1,70 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+import type {PrimitiveGeometryProps} from '../geometries/geometry-helpers';
+import {ParametricGeometry, normalized} from './parametric-geometry';
+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 class LatheGeometry extends ParametricGeometry {
+  constructor(props: LatheGeometryProps) {
+    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: number) => {
+      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)];
+      }
+    });
+  }
+}

package/src/parametric/parametric-geometry.ts

@@ -0,0 +1,118 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+import {Geometry} from '../lib/geometry';
+import {assertSegments, type PrimitiveGeometryProps} from '../geometries/geometry-helpers';
+
+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 class ParametricGeometry extends Geometry {
+  constructor(props: ParametricGeometryProps) {
+    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: number, periodic: boolean) =>
+      periodic ? ((value % 1) + 1) % 1 : Math.max(0, Math.min(1, value));
+    const evaluate = (u: number, v: number) =>
+      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: number[];
+        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: Readonly<ArrayLike<number>>): number[] {
+  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: number[]): number[] {
+  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));
+}

package/src/parametric/torus-geometry.ts

@@ -0,0 +1,51 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+import {assertPositive, type PrimitiveGeometryProps} from '../geometries/geometry-helpers';
+import {ParametricGeometry} from './parametric-geometry';
+export type TorusGeometryProps = PrimitiveGeometryProps & {
+  majorRadius?: number;
+  minorRadius?: number;
+  majorSegments?: number;
+  minorSegments?: number;
+  /** Sweep in radians, (0, 2π]. Partial sweeps have open ends. */
+  arc?: number;
+};
+/** Ring torus around Y, with outward analytic normals and separate UV seam rows. */
+export class TorusGeometry extends ParametricGeometry {
+  constructor(props: TorusGeometryProps = {}) {
+    const {
+      majorRadius = 1,
+      minorRadius = 0.3,
+      majorSegments = 48,
+      minorSegments = 24,
+      arc = Math.PI * 2
+    } = 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π]');
+    if (majorSegments < 3 || minorSegments < 3)
+      throw new RangeError('Torus requires at least three segments per axis');
+    super({
+      ...props,
+      uSegments: majorSegments,
+      vSegments: minorSegments,
+      periodicU: arc === Math.PI * 2,
+      periodicV: true,
+      sample: (u, v) => {
+        const theta = 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(u * arc),
+        Math.sin(v * Math.PI * 2),
+        -Math.cos(v * Math.PI * 2) * Math.sin(u * arc)
+      ]
+    });
+  }
+}

package/src/parametric.ts

@@ -0,0 +1,9 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+export {ParametricGeometry} from './parametric/parametric-geometry';
+export type {ParametricGeometryProps, SurfaceSampler} from './parametric/parametric-geometry';
+export {TorusGeometry} from './parametric/torus-geometry';
+export type {TorusGeometryProps} from './parametric/torus-geometry';
+export {LatheGeometry} from './parametric/lathe-geometry';
+export type {LatheGeometryProps} from './parametric/lathe-geometry';