@metamesh/modeling 0.19.0 → 0.20.0

package/dist/docs/reference/model/preflightInternalThreadCutter.md

@@ -1,93 +0,0 @@
-# preflightInternalThreadCutter
-
-Checks compensated cutter dimensions and conservative mesh estimates against host output limits.
-
-**preflightInternalThreadCutter**(`options`: [`InternalThreadCutterOptions`](../geometry/InternalThreadCutterOptions.md)): [`ThreadSolidPreflight`](../geometry/ThreadSolidPreflight.md)
-
-
-
-Requires active synchronous model execution and uses its resolution and limits. Estimates include
-the one-pitch extension beyond each requested face, without mesh buffers or native objects.
-Mesh validity, native construction, and aggregate output limits are checked later.
-
-## Parameters
-
-<a id="options"></a>
-
-**`options`** · [`InternalThreadCutterOptions`](../geometry/InternalThreadCutterOptions.md) · Required
-
-- [`nominalMajorDiameter`](../geometry/InternalThreadCutterOptions.md#nominalmajordiameter) · `number` · Required
-
-  Nominal major diameter before female compensation and faceting correction.
-
-- [`length`](../geometry/InternalThreadCutterOptions.md#length) · `number` · Required
-
-  Total threaded axial length in millimetres.
-
-- [`profile`](../geometry/InternalThreadCutterOptions.md#profile) · [`ThreadProfile`](../geometry/ThreadProfile-type.md) · Required
-
-  Validated periodic profile repeated around the shaft.
-
-- [`fit`](../geometry/InternalThreadCutterOptions.md#fit) · [`PrintableThreadFit`](../geometry/PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](../geometry/PrintableThreadFitPolicy.md) · Optional
-
-  Printable fit or caller-calibrated allowances. Default: `normal`.
-
-- [`bevel`](../geometry/InternalThreadCutterOptions.md#bevel) · [`Bevel`](../geometry/Bevel.md) · Optional
-
-  Bottom/top sizes in millimetres. Omitted disables both. Auto uses profile depth for standard/tapered ends,
-  or one sixth of the compensated male minor/female major radius for blunt ends.
-
-- [`ends`](../geometry/InternalThreadCutterOptions.md#ends) · [`ThreadEndTreatmentOptions`](../geometry/ThreadEndTreatmentOptions.md) · Optional
-
-  Optional bottom/top ridge-end treatments. Standalone ridges honor the requested boundaries;
-  BOSL2-style non-cut lead-in scaling is available on complete thread solids.
-
-- [`handedness`](../geometry/InternalThreadCutterOptions.md#handedness) · [`ThreadHandedness`](../geometry/ThreadHandedness.md) · Optional
-
-  Helix direction. Default: `right`.
-
-- [`limits`](../geometry/InternalThreadCutterOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
-
-  Explicit output and circular allocation ceilings.
-
-- [`phase`](../geometry/InternalThreadCutterOptions.md#phase) · `number` · Optional
-
-  Angular offset of the first start in degrees. Default: `0`.
-
-- [`resolution`](../geometry/InternalThreadCutterOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
-
-  Optional circular-resolution policy.
-
-- [`starts`](../geometry/InternalThreadCutterOptions.md#starts) · `number` · Optional
-
-  Number of evenly phased starts. Default: `1`.
-
-- [`tolerance`](../geometry/InternalThreadCutterOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
-
-  Optional numerical tolerance overrides.
-
-
-
-## Returns
-
-[`ThreadSolidPreflight`](../geometry/ThreadSolidPreflight.md)
-
-
-## Related APIs
-
-- [InternalThreadCutterOptions](../geometry/InternalThreadCutterOptions.md)
-- [ThreadSolidPreflight](../geometry/ThreadSolidPreflight.md)
-- [internalThreadCutter](internalThreadCutter.md)
-
-## Guides
-
-- [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
-- [Preflight guarantees and host settings](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
-
-## Supported imports
-
-```ts
-import { preflightInternalThreadCutter } from "@metamesh/modeling";
-```
-
-Package: `@metamesh/modeling@0.19.0`.

package/dist/docs/reference/model/preflightThreadedNut.md

@@ -1,109 +0,0 @@
-# preflightThreadedNut
-
-Checks nut dimensions, chamfers, end-face wall, and the extended compensated cutter's allocation plan.
-
-**preflightThreadedNut**(`options`: [`ThreadedNutOptions`](../geometry/ThreadedNutOptions.md)): [`ThreadedNutPreflight`](../geometry/ThreadedNutPreflight.md)
-
-
-
-Requires active synchronous model execution and uses its resolution and limits, without mesh
-buffers or native objects. Returned thread estimates cover the cutter, excluding the body and
-Boolean result. Mesh validity, native construction, and aggregate output limits are checked later.
-
-## Parameters
-
-<a id="options"></a>
-
-**`options`** · [`ThreadedNutOptions`](../geometry/ThreadedNutOptions.md) · Required
-
-- [`nominalMajorDiameter`](../geometry/ThreadedNutOptions.md#nominalmajordiameter) · `number` · Required
-
-  Nominal major diameter before female compensation and faceting correction.
-
-- [`shape`](../geometry/ThreadedNutOptions.md#shape) · [`ThreadedNutShape`](../geometry/ThreadedNutShape.md) · Required
-
-  Nut body shape.
-
-- [`thickness`](../geometry/ThreadedNutOptions.md#thickness) · `number` · Required
-
-  Nut thickness along +Z in millimetres.
-
-- [`width`](../geometry/ThreadedNutOptions.md#width) · `number` · Required
-
-  Across-flats width for hex/square or diameter for round, in millimetres.
-
-- [`profile`](../geometry/ThreadedNutOptions.md#profile) · [`ThreadProfile`](../geometry/ThreadProfile-type.md) · Required
-
-  Validated periodic profile repeated around the shaft.
-
-- [`fit`](../geometry/ThreadedNutOptions.md#fit) · [`PrintableThreadFit`](../geometry/PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](../geometry/PrintableThreadFitPolicy.md) · Optional
-
-  Printable fit or caller-calibrated allowances. Default: `normal`.
-
-- [`innerBevel`](../geometry/ThreadedNutOptions.md#innerbevel) · [`Bevel`](../geometry/Bevel.md) · Optional
-
-  Opening bevels in [bottom, top] order. Omitted or auto uses min(profile.depth, thickness/4); zero disables.
-
-- [`outerBevel`](../geometry/ThreadedNutOptions.md#outerbevel) · [`Bevel`](../geometry/Bevel.md) · Optional
-
-  Body bevels in [bottom, top] order. Omitted or auto uses min(profile.depth, thickness/4).
-  Use [0, "auto"] to keep the outside bottom flat without disabling its inner opening bevel.
-
-- [`bodyResolution`](../geometry/ThreadedNutOptions.md#bodyresolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
-
-  Optional physical policy for a round body, independent of the thread's matched facet grid.
-
-- [`ends`](../geometry/ThreadedNutOptions.md#ends) · [`ThreadEndTreatmentOptions`](../geometry/ThreadEndTreatmentOptions.md) · Optional
-
-  Optional bottom/top ridge-end treatments. Standalone ridges honor the requested boundaries;
-  BOSL2-style non-cut lead-in scaling is available on complete thread solids.
-
-- [`handedness`](../geometry/ThreadedNutOptions.md#handedness) · [`ThreadHandedness`](../geometry/ThreadHandedness.md) · Optional
-
-  Helix direction. Default: `right`.
-
-- [`limits`](../geometry/ThreadedNutOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
-
-  Explicit output and circular allocation ceilings.
-
-- [`phase`](../geometry/ThreadedNutOptions.md#phase) · `number` · Optional
-
-  Angular offset of the first start in degrees. Default: `0`.
-
-- [`resolution`](../geometry/ThreadedNutOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
-
-  Optional circular-resolution policy.
-
-- [`starts`](../geometry/ThreadedNutOptions.md#starts) · `number` · Optional
-
-  Number of evenly phased starts. Default: `1`.
-
-- [`tolerance`](../geometry/ThreadedNutOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
-
-  Optional numerical tolerance overrides.
-
-
-
-## Returns
-
-[`ThreadedNutPreflight`](../geometry/ThreadedNutPreflight.md)
-
-
-## Related APIs
-
-- [ThreadedNutOptions](../geometry/ThreadedNutOptions.md)
-- [ThreadedNutPreflight](../geometry/ThreadedNutPreflight.md)
-- [threadedNut](threadedNut.md)
-
-## Guides
-
-- [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
-- [Preflight guarantees and host settings](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
-
-## Supported imports
-
-```ts
-import { preflightThreadedNut } from "@metamesh/modeling";
-```
-
-Package: `@metamesh/modeling@0.19.0`.

package/dist/docs/reference/model/preflightThreadedRod.md

@@ -1,93 +0,0 @@
-# preflightThreadedRod
-
-Checks compensated rod dimensions and conservative mesh estimates against host output limits.
-
-**preflightThreadedRod**(`options`: [`ThreadedRodOptions`](../geometry/ThreadedRodOptions.md)): [`ThreadSolidPreflight`](../geometry/ThreadSolidPreflight.md)
-
-
-
-Requires active synchronous model execution and uses its resolution and limits. Returns selected
-sampling and conservative row/triangle estimates without mesh buffers or native objects.
-Mesh validity, native construction, and aggregate output limits are checked later.
-
-## Parameters
-
-<a id="options"></a>
-
-**`options`** · [`ThreadedRodOptions`](../geometry/ThreadedRodOptions.md) · Required
-
-- [`nominalMajorDiameter`](../geometry/ThreadedRodOptions.md#nominalmajordiameter) · `number` · Required
-
-  Nominal major diameter before male compensation.
-
-- [`length`](../geometry/ThreadedRodOptions.md#length) · `number` · Required
-
-  Total threaded axial length in millimetres.
-
-- [`profile`](../geometry/ThreadedRodOptions.md#profile) · [`ThreadProfile`](../geometry/ThreadProfile-type.md) · Required
-
-  Validated periodic profile repeated around the shaft.
-
-- [`bevel`](../geometry/ThreadedRodOptions.md#bevel) · [`Bevel`](../geometry/Bevel.md) · Optional
-
-  Bottom/top sizes in millimetres. Omitted disables both. Auto uses profile depth for standard/tapered ends,
-  or one sixth of the compensated male minor/female major radius for blunt ends.
-
-- [`fit`](../geometry/ThreadedRodOptions.md#fit) · [`PrintableThreadFit`](../geometry/PrintableThreadFit.md) \| [`PrintableThreadFitPolicy`](../geometry/PrintableThreadFitPolicy.md) · Optional
-
-  Printable fit or caller-calibrated allowances. Default: `normal`.
-
-- [`ends`](../geometry/ThreadedRodOptions.md#ends) · [`ThreadEndTreatmentOptions`](../geometry/ThreadEndTreatmentOptions.md) · Optional
-
-  Optional bottom/top ridge-end treatments. Standalone ridges honor the requested boundaries;
-  BOSL2-style non-cut lead-in scaling is available on complete thread solids.
-
-- [`handedness`](../geometry/ThreadedRodOptions.md#handedness) · [`ThreadHandedness`](../geometry/ThreadHandedness.md) · Optional
-
-  Helix direction. Default: `right`.
-
-- [`limits`](../geometry/ThreadedRodOptions.md#limits) · `Partial`\<[`ModelingLimits`](../geometry/ModelingLimits.md)\> · Optional
-
-  Explicit output and circular allocation ceilings.
-
-- [`phase`](../geometry/ThreadedRodOptions.md#phase) · `number` · Optional
-
-  Angular offset of the first start in degrees. Default: `0`.
-
-- [`resolution`](../geometry/ThreadedRodOptions.md#resolution) · [`GeometryResolution`](../geometry/GeometryResolution.md) · Optional
-
-  Optional circular-resolution policy.
-
-- [`starts`](../geometry/ThreadedRodOptions.md#starts) · `number` · Optional
-
-  Number of evenly phased starts. Default: `1`.
-
-- [`tolerance`](../geometry/ThreadedRodOptions.md#tolerance) · [`GeometryToleranceOptions`](../geometry/GeometryToleranceOptions.md) · Optional
-
-  Optional numerical tolerance overrides.
-
-
-
-## Returns
-
-[`ThreadSolidPreflight`](../geometry/ThreadSolidPreflight.md)
-
-
-## Related APIs
-
-- [ThreadedRodOptions](../geometry/ThreadedRodOptions.md)
-- [ThreadSolidPreflight](../geometry/ThreadSolidPreflight.md)
-- [threadedRod](threadedRod.md)
-
-## Guides
-
-- [Build printable threads](https://metamesh.studio/docs/develop/printable-threads#build-the-first-mating-pair)
-- [Preflight guarantees and host settings](../../guides/resolution-and-inspection.md#check-preflight-guarantees)
-
-## Supported imports
-
-```ts
-import { preflightThreadedRod } from "@metamesh/modeling";
-```
-
-Package: `@metamesh/modeling@0.19.0`.

package/dist/engine/operations/patterns.js

@@ -1,47 +0,0 @@
-import { gridPatternPlan, linearPatternPlan, pathPatternPlan, radialPatternPlan, } from "../../geometry/patterns/placements.js";
-import { assertSamplingCount } from "../../geometry/sampling-limits.js";
-import { restrictTransform3 } from "../../geometry/transform2.js";
-import { IDENTITY_TRANSFORM3 } from "../../geometry/transform3.js";
-/** Private pattern owner; all copies use the shared transform/metadata/lifetime path. */
-export function createPatternOperations(environment, transforms) {
-    const apply = (source, makePlan, operation) => {
-        environment.assertActive();
-        const plan = makePlan();
-        let vertices = 0, triangles = 0;
-        let kind;
-        const budget = (shape, multiplier) => {
-            const native = environment.resolveHandle(shape);
-            if (kind !== undefined && native.kind !== kind)
-                environment.throwGeometryError("INVALID_ARGUMENT", operation, "Pattern factories must return one shape dimension.");
-            kind = native.kind;
-            vertices += native.value.numVert() * multiplier;
-            if (native.kind === "solid")
-                triangles += native.value.numTri() * multiplier;
-            else
-                assertSamplingCount(vertices, operation, environment.limits.maxProfilePoints);
-            environment.assertMeshAllocation(vertices, triangles, (vertices + triangles) * 12, operation);
-        };
-        if (typeof source !== "function")
-            budget(source, plan.count);
-        const copies = [];
-        for (let index = 0; index < plan.count; index++) {
-            const shape = typeof source === "function" ? source(index) : source;
-            if (typeof source === "function")
-                budget(shape, 1);
-            const matrix = plan.transformAt(index, kind === "section" ? 2 : 3);
-            copies.push(matrix.every((value, i) => value === IDENTITY_TRANSFORM3[i])
-                ? shape
-                : kind === "section"
-                    ? transforms.operations.transform(shape, restrictTransform3(matrix))
-                    : transforms.operations.transform(shape, matrix));
-        }
-        return copies;
-    };
-    const operations = {
-        linearPattern: ((source, options) => apply(source, () => linearPatternPlan(options), "linearPattern")),
-        radialPattern: ((source, options) => apply(source, () => radialPatternPlan(options), "radialPattern")),
-        gridPattern: ((source, options) => apply(source, () => gridPatternPlan(options), "gridPattern")),
-        pathPattern: ((source, path, options) => apply(source, () => pathPatternPlan(path, options, environment.limits), "pathPattern")),
-    };
-    return operations;
-}

package/dist/geometry/loft/loft.js

@@ -1,105 +0,0 @@
-import { GeometryError } from "../errors.js";
-import { resolveExtrusionControls, resolveExtrusionDivisions, } from "../extrusion.js";
-import { assertMeshAllocationWithinLimits, resolveModelingLimits } from "../model-limits.js";
-import { capturePath2Input, path2InputData } from "../paths/path-value.js";
-import { assertSamplingCount } from "../sampling-limits.js";
-import { pointLoftProfile, prepareLoftGeometry } from "./loft-geometry.js";
-import {} from "./loft-options.js";
-import { simpleLoftMesh } from "./loft-simple-mesh.js";
-export { triangulateContour } from "./loft-triangulation.js";
-/**
- * Lofts simple point loops at z heights or explicit right-handed frames, in input order.
- *
- * Correspondence defaults to direct. CCW-normalized loops retain their
- * seam and original vertices; unequal counts gain subdivisions or repeated fan slots.
- * Both ends use ear-clipped caps, supporting concave profiles without center fans.
- * Intermediate slices interpolate placed world vertices, never frame axes.
- * Transformed coordinates must fit finite Float32 mesh storage.
- * Path2 profiles must be closed; raw point collections are interpreted as closed.
- *
- * @example Loft with explicit point correspondence
- * ```ts
- * const bottom = rectangleContour({ size: [20, 12] });
- * const top = rectangleContour({ size: [30, 20], treatment: { kind: "round", radius: 3 } });
- * mesh.loft([{ profile: bottom, z: 0 }, { profile: top, z: 30 }], { correspondence: "reindex" });
- * ```
- */
-export function loftMesh(stations, options = {}) {
-    if (typeof options !== "object" || options === null || Array.isArray(options))
-        throw new GeometryError("INVALID_ARGUMENT", "Loft options must be an object.", {
-            operation: "loftMesh",
-        });
-    const limits = resolveModelingLimits(options.limits);
-    if (!Array.isArray(stations) || stations.length < 2)
-        throw new GeometryError("INVALID_ARGUMENT", "Loft requires at least two stations.", {
-            operation: "loftMesh",
-        });
-    assertSamplingCount(stations.length, "loftMesh", limits.maxPathPoints);
-    const inputs = stations;
-    const input = inputs.map(({ profile, ...placement }) => ({
-        ...placement,
-        source: capturePath2Input(profile, true),
-    }));
-    assertSamplingCount(input.reduce((sum, station) => sum + station.source.count, 0), "loftMesh", 1_000_000);
-    let remaining = 1_000_000;
-    const profiles = input.map(({ source, ...placement }) => {
-        const points = path2InputData(source.input, true, {
-            maxPathPoints: Math.max(1, Math.min(limits.maxProfilePoints, remaining)),
-        }).points;
-        assertSamplingCount(points.length, "loftMesh", remaining);
-        remaining -= points.length;
-        return { ...placement, profile: pointLoftProfile(points) };
-    });
-    return simpleLoftMesh(prepareLoftGeometry(profiles, options, limits, false), limits);
-}
-/**
- * Linearly extrudes one simple profile along +Z with robust ear-clipped caps.
- * Path2 profiles must be closed; raw point collections have an implicit closing edge.
- * End treatments are unsupported and reject at runtime. Use Section.extrude for finished ends.
- *
- * @example Extrude point data without an engine
- * ```ts
- * const outline = rectangleContour({ size: [30, 20], treatment: { kind: "round", radius: 3 } });
- * mesh.extrude(outline, { height: 8 });
- * ```
- */
-export function extrudeMesh(input, options) {
-    const { height } = options;
-    const { center, scales, twist } = resolveExtrusionControls(height, options, "extrudeMesh");
-    if ("ends" in options)
-        throw new GeometryError("INVALID_ARGUMENT", "extrudeMesh does not support end treatments. Use Section.extrude instead.", { operation: "extrudeMesh" });
-    if (!Number.isFinite(height) || height <= 0) {
-        throw new GeometryError("INVALID_ARGUMENT", "Extrusion height must be finite and positive.", {
-            operation: "extrudeMesh",
-            details: { height },
-        });
-    }
-    const bottom = center ? -height / 2 : 0;
-    const limits = resolveModelingLimits(options.limits);
-    const profile = path2InputData(input, true, { maxPathPoints: limits.maxProfilePoints }).points;
-    assertSamplingCount(profile.length, "extrudeMesh", limits.maxProfilePoints);
-    const divisions = resolveExtrusionDivisions(profile, height, options);
-    const count = profile.length * (divisions + 2);
-    const triangles = (divisions + 1) * profile.length * 2 + (profile.length - 2) * 2;
-    assertMeshAllocationWithinLimits(count, triangles, (count + triangles) * 12, "extrudeMesh", limits);
-    const frame = (amount) => ({
-        origin: [0, 0, bottom + height * amount],
-        xAxis: [1, 0, 0],
-        yAxis: [0, 1, 0],
-        zAxis: [0, 0, 1],
-    });
-    const stations = Array.from({ length: divisions + 2 }, (_, index) => {
-        const amount = index / (divisions + 1);
-        const angle = ((twist * Math.PI) / 180) * amount;
-        const cosine = Math.cos(angle), sine = Math.sin(angle);
-        const sx = 1 + (scales[0] - 1) * amount, sy = 1 + (scales[1] - 1) * amount;
-        return {
-            frame: frame(amount),
-            profile: profile.map(([x, y]) => [
-                x * sx * cosine - y * sy * sine,
-                x * sx * sine + y * sy * cosine,
-            ]),
-        };
-    });
-    return loftMesh(stations, { correspondence: "direct", limits });
-}

package/dist/geometry/mechanical/index.js

@@ -1,14 +0,0 @@
-/**
- * Runtime-neutral, opt-in mechanical geometry helpers and standards data.
- *
- * @packageDocumentation
- */
-export { minimumCylindricalGearToothCountWithoutUndercut, resolveCylindricalGear, resolveCylindricalGearPair, resolveRackPitch, sampleCylindricalGearOutline, sampleInternalCylindricalGearSpaceOutline, sampleRackToothPath, } from "./gears.js";
-export { measureInternalCylindricalGearPairMotion } from "./gear-motion.js";
-export { threadRidgeMesh, threadSolidMesh } from "./threads/mesh.js";
-export { compensateThreadProfileAxially, compensateThreadProfileForFaceting, threadProfile, } from "./threads/profiles.js";
-export { preflightThreadSolidMesh } from "./threads/mesh-plan.js";
-export { sampleConventionalThreadHelices as sampleThreadHelices } from "./threads/helices.js";
-export { compensateThreadDiameters, PRINTABLE_THREAD_FIT_POLICIES, resolvePrintableThreadFitPolicy, resolveThreadCircularSegments, } from "./threads/fit.js";
-export { getMetricClearanceHoleDiameter, getMetricFastenerStandard, METRIC_FASTENER_STANDARDS, } from "./standards.js";
-export { resolveKnuckleHinge, } from "./knuckle-hinge.js";

package/dist/geometry/primitive-resolution.js

@@ -1,20 +0,0 @@
-import { GeometryError } from "./errors.js";
-import { resolveCircularSegments } from "./resolution.js";
-import { assertSamplingCount, resolveGeometrySamplingLimits } from "./sampling-limits.js";
-/**
- * Resolves a circular primitive's exact or adaptive segment count.
- *
- * @internal Exact counts override physical sampling, while explicit allocation ceilings still apply.
- */
-export function resolveCircularPrimitiveSegments(radius, options, operation) {
-    if (options.segments === undefined) {
-        return resolveCircularSegments(radius, {
-            ...options.resolution,
-            sizing: options.sizing ?? "vertex",
-        }, options.limits);
-    }
-    if (!Number.isSafeInteger(options.segments) || options.segments < 3)
-        throw new GeometryError("INVALID_ARGUMENT", "segments must be a safe integer of at least three.", { operation, details: { value: options.segments } });
-    assertSamplingCount(options.segments, operation, resolveGeometrySamplingLimits(options.limits).maxCircularSegments);
-    return options.segments;
-}

package/dist/geometry/svg/index.js

@@ -1 +0,0 @@
-export { parseSvgPath } from "./parser.js";

package/dist/geometry/sweeps/options.js

@@ -1,29 +0,0 @@
-import { GeometryError } from "../errors.js";
-import { vector2Data } from "../math/vector-value.js";
-/** @internal Validates local scales before any manufacturing buffer allocation. */
-export function resolveSweepScales(scale, stationCount) {
-    const fail = () => {
-        throw new GeometryError("INVALID_ARGUMENT", "Sweep scales must be positive finite XY pairs, with one pair per station when varying.", { operation: "sweep" });
-    };
-    const pair = (value) => {
-        if (typeof value === "number") {
-            if (!(value > 0) || !Number.isFinite(value))
-                fail();
-            return [value, value];
-        }
-        const coordinates = vector2Data(value);
-        if (!coordinates.every((n) => typeof n === "number" && Number.isFinite(n) && n > 0))
-            fail();
-        return coordinates;
-    };
-    if (scale === undefined ||
-        typeof scale === "number" ||
-        (typeof scale === "object" && scale !== null && "toData" in scale) ||
-        (Array.isArray(scale) && typeof scale[0] === "number")) {
-        const value = pair(scale ?? 1);
-        return Array.from({ length: stationCount }, () => value);
-    }
-    if (!Array.isArray(scale) || scale.length !== stationCount)
-        fail();
-    return scale.map(pair);
-}

package/dist/geometry/sweeps/sweep-closed.js

@@ -1,96 +0,0 @@
-import { GeometryError } from "../errors.js";
-import { add3, rotateAroundAxis3Radians, scale3 } from "../math/vector3.js";
-import { validateTriangleMesh } from "../mesh/mesh.js";
-import { resolveGeometryTolerance } from "../tolerance.js";
-import { resolveSweepScales } from "./options.js";
-import { computeSweepFrames, validateSweepOptions } from "./orientation.js";
-import { planSweepStations, refineSweepStations } from "./stations.js";
-import { assertSweepAllocation, normalizeSweepPath, normalizeSweepProfile, writeSweepVertex, } from "./validation.js";
-/** @internal Checks host allocation policy before frames or manufacturing buffers. */
-export const buildClosedSweepMesh = (profile, path, options = {}) => {
-    const operation = "sweep";
-    validateSweepOptions(options);
-    profile = normalizeSweepProfile(profile, operation, options.limits);
-    path = normalizeSweepPath(path, true, operation, options.limits);
-    assertSweepAllocation(path.length, profile.length, true, operation, options.limits);
-    let scales = resolveSweepScales(options.scale, path.length);
-    const seamProfileOffset = options.seamProfileOffset ?? 0;
-    if (!Number.isSafeInteger(seamProfileOffset)) {
-        throw new GeometryError("INVALID_ARGUMENT", "seamProfileOffset must be a safe integer.", {
-            operation,
-        });
-    }
-    const twistRadians = ((options.twist ?? 0) / 180) * Math.PI;
-    if (!Number.isFinite(twistRadians)) {
-        throw new GeometryError("NON_FINITE_VALUE", "Sweep twist must be finite.", {
-            operation,
-        });
-    }
-    const ringVertexCount = profile.length;
-    const normalizedSeamProfileOffset = ((seamProfileOffset % ringVertexCount) + ringVertexCount) % ringVertexCount;
-    const profileScale = profile.reduce((extent, [x, y]) => Math.max(extent, Math.abs(x), Math.abs(y)), 1);
-    const seamTolerance = resolveGeometryTolerance(profileScale).linear;
-    const cosine = Math.cos(twistRadians);
-    const sine = Math.sin(twistRadians);
-    for (let index = 0; index < profile.length; index++) {
-        const [profileX, profileY] = profile[index];
-        const [scaleX, scaleY] = scales[0];
-        const x = profileX * scaleX;
-        const y = profileY * scaleY;
-        const target = profile[(index + normalizedSeamProfileOffset) % profile.length];
-        if (Math.hypot(x * cosine - y * sine - target[0] * scaleX, x * sine + y * cosine - target[1] * scaleY) > seamTolerance) {
-            throw new GeometryError("INVALID_TOPOLOGY", "Sweep twist must end at the seam's corresponding profile orientation.", { operation });
-        }
-    }
-    if (twistRadians !== 0) {
-        const plan = planSweepStations([profile], path, scales, options);
-        assertSweepAllocation(plan.stationCount, profile.length, true, operation, options.limits);
-    }
-    let transportedFrames = computeSweepFrames(path, options);
-    let twists;
-    if (twistRadians !== 0) {
-        const plan = planSweepStations([profile], path, scales, options, transportedFrames);
-        assertSweepAllocation(plan.stationCount, profile.length, true, operation, options.limits);
-        const refined = refineSweepStations(path, scales, transportedFrames, options, plan);
-        path = refined.path;
-        scales = refined.scales;
-        transportedFrames = refined.frames;
-        twists = refined.twists;
-    }
-    const positions = new Float32Array(path.length * ringVertexCount * 3);
-    for (let ring = 0; ring < path.length; ring += 1) {
-        const point = path[ring];
-        const tangent = transportedFrames[ring].tangent;
-        const twist = twists?.[ring] ?? twistRadians * (ring / path.length);
-        const baseNormal = transportedFrames[ring].normal;
-        const normal = rotateAroundAxis3Radians(baseNormal, tangent, twist);
-        const binormal = rotateAroundAxis3Radians(transportedFrames[ring].binormal, tangent, twist);
-        const [scaleX, scaleY] = scales[ring];
-        for (let profileIndex = 0; profileIndex < profile.length; profileIndex += 1) {
-            const [x, y] = profile[profileIndex];
-            const vertex = add3(point, add3(scale3(normal, x * scaleX), scale3(binormal, y * scaleY)));
-            writeSweepVertex(positions, (ring * ringVertexCount + profileIndex) * 3, vertex, operation);
-        }
-    }
-    const indices = new Uint32Array(path.length * ringVertexCount * 2 * 3);
-    let cursor = 0;
-    for (let ring = 0; ring < path.length; ring += 1) {
-        const nextRing = (ring + 1) % path.length;
-        const nextProfileOffset = nextRing === 0 ? normalizedSeamProfileOffset : 0;
-        for (let profileIndex = 0; profileIndex < ringVertexCount; profileIndex += 1) {
-            const following = (profileIndex + 1) % ringVertexCount;
-            const a = ring * ringVertexCount + profileIndex;
-            const b = ring * ringVertexCount + following;
-            const c = nextRing * ringVertexCount + ((following + nextProfileOffset) % ringVertexCount);
-            const d = nextRing * ringVertexCount + ((profileIndex + nextProfileOffset) % ringVertexCount);
-            indices[cursor] = a;
-            indices[cursor + 1] = b;
-            indices[cursor + 2] = c;
-            indices[cursor + 3] = a;
-            indices[cursor + 4] = c;
-            indices[cursor + 5] = d;
-            cursor += 6;
-        }
-    }
-    return validateTriangleMesh({ indices, positions });
-};

package/dist/geometry/sweeps/sweep-mesh.js

@@ -1,32 +0,0 @@
-import { GeometryError } from "../errors.js";
-import { resolveModelingLimits } from "../model-limits.js";
-import { path2InputData, path3InputData, } from "../paths/path-value.js";
-import { validateSweepOptions } from "./orientation.js";
-import { buildClosedSweepMesh } from "./sweep-closed.js";
-import { buildOpenSweepMesh } from "./sweep-open.js";
-/**
- * Sweeps one explicitly ordered point loop, with caps or a geometrically matching closed seam.
- *
- * @example Sweep point data along a bent path
- * ```ts
- * const profile = rectangleContour({ size: [6, 3] });
- * mesh.sweep(profile, [[0, 0, 0], [0, 0, 15], [10, 0, 25]], {
- *   orientation: { kind: "transport", initialNormal: [0, 1, 0] },
- * });
- * ```
- */
-export function sweepMesh(profile, path, options = {}) {
-    validateSweepOptions(options);
-    const limits = resolveModelingLimits(options.limits);
-    const outline = path2InputData(profile, true, { maxPathPoints: limits.maxProfilePoints }).points;
-    const data = path3InputData(path, options.closed, limits);
-    const selected = { ...options, closed: data.closed };
-    if (data.closed) {
-        return buildClosedSweepMesh(outline, data.points, selected);
-    }
-    if ((options.seamProfileOffset ?? 0) !== 0)
-        throw new GeometryError("INVALID_ARGUMENT", "A seamProfileOffset requires a closed path.", {
-            operation: "sweep",
-        });
-    return buildOpenSweepMesh(outline, data.points, selected);
-}