@metamesh/modeling 0.18.0 → 0.19.0

package/dist/docs/reference/text/VectorFont.md

@@ -8,7 +8,7 @@ A prepared font owns its parsed bytes; keep handles local to their Worker or inv
 
 
 
-`readonly` **layout**: (`text`: `string`, `options`: [`VectorTextLayoutOptions`](VectorTextLayoutOptions.md)) => [`VectorTextLayout`](VectorTextLayout.md)
+`readonly` **layout**: (`text`: `string`, `options`: [`VectorTextLayoutOptions`](../geometry/VectorTextLayoutOptions.md)) => [`VectorTextLayout`](../geometry/VectorTextLayout.md)
 
 
 
@@ -24,33 +24,33 @@ Shape horizontal lines or one circular line; bounded to 512 UTF-16 units and sup
 
 <a id="options"></a>
 
-**`options`** · [`VectorTextLayoutOptions`](VectorTextLayoutOptions.md) · Required
+**`options`** · [`VectorTextLayoutOptions`](../geometry/VectorTextLayoutOptions.md) · Required
 
-- [`fontSize`](VectorTextLayoutOptions.md#fontsize) · `number` · Required
+- [`fontSize`](../geometry/VectorTextLayoutOptions.md#fontsize) · `number` · Required
 
   Em size in millimetres, greater than zero and at most 10000; not the visible glyph height.
 
-- [`align`](VectorTextLayoutOptions.md#align) · `"left"` \| `"right"` \| `"center"` · Optional
+- [`align`](../geometry/VectorTextLayoutOptions.md#align) · `"left"` \| `"right"` \| `"center"` · Optional
 
   Place the advance's start, midpoint or end at the datum; defaults to center on arcs, otherwise left.
 
-- [`baseline`](VectorTextLayoutOptions.md#baseline) · [`VectorTextArcBaseline`](VectorTextArcBaseline.md) · Optional
+- [`baseline`](../geometry/VectorTextLayoutOptions.md#baseline) · [`VectorTextArcBaseline`](../geometry/VectorTextArcBaseline.md) · Optional
 
   Omitted uses horizontal lines. Arcs require one line and baseline vertical alignment.
 
-- [`lineHeight`](VectorTextLayoutOptions.md#lineheight) · `number` · Optional
+- [`lineHeight`](../geometry/VectorTextLayoutOptions.md#lineheight) · `number` · Optional
 
   Baseline spacing in ems, 0.5–5; omitted uses the selected face's natural vertical metrics.
 
-- [`verticalAlign`](VectorTextLayoutOptions.md#verticalalign) · `"top"` \| `"bottom"` \| `"center"` \| `"baseline"` · Optional
+- [`verticalAlign`](../geometry/VectorTextLayoutOptions.md#verticalalign) · `"top"` \| `"bottom"` \| `"center"` \| `"baseline"` · Optional
 
   Place the first baseline or complete ink bounds at Y=0; arcs only accept baseline.
 
-- [`fontWeight`](VectorTextLayoutOptions.md#fontweight) · `number` · Optional
+- [`fontWeight`](../geometry/VectorTextLayoutOptions.md#fontweight) · `number` · Optional
 
   Actual static or variable weight, 1–1000; defaults to the prepared face's static weight.
 
-- [`letterSpacing`](VectorTextLayoutOptions.md#letterspacing) · `number` · Optional
+- [`letterSpacing`](../geometry/VectorTextLayoutOptions.md#letterspacing) · `number` · Optional
 
   Tracking between glyph clusters in millimetres, -100–100; defaults to zero.
 
@@ -58,7 +58,7 @@ Shape horizontal lines or one circular line; bounded to 512 UTF-16 units and sup
 
 #### Returns
 
-[`VectorTextLayout`](VectorTextLayout.md)
+[`VectorTextLayout`](../geometry/VectorTextLayout.md)
 
 ***
 
@@ -66,7 +66,7 @@ Shape horizontal lines or one circular line; bounded to 512 UTF-16 units and sup
 
 
 
-`readonly` **measure**: (`text`: `string`, `options`: [`VectorTextLayoutOptions`](VectorTextLayoutOptions.md)) => [`VectorTextMetrics`](VectorTextMetrics.md)
+`readonly` **measure**: (`text`: `string`, `options`: [`VectorTextLayoutOptions`](../geometry/VectorTextLayoutOptions.md)) => [`VectorTextMetrics`](../geometry/VectorTextMetrics.md)
 
 
 
@@ -82,33 +82,33 @@ Measure the same cached vector layout; all returned lengths are in millimetres.
 
 <a id="options-1"></a>
 
-**`options`** · [`VectorTextLayoutOptions`](VectorTextLayoutOptions.md) · Required
+**`options`** · [`VectorTextLayoutOptions`](../geometry/VectorTextLayoutOptions.md) · Required
 
-- [`fontSize`](VectorTextLayoutOptions.md#fontsize) · `number` · Required
+- [`fontSize`](../geometry/VectorTextLayoutOptions.md#fontsize) · `number` · Required
 
   Em size in millimetres, greater than zero and at most 10000; not the visible glyph height.
 
-- [`align`](VectorTextLayoutOptions.md#align) · `"left"` \| `"right"` \| `"center"` · Optional
+- [`align`](../geometry/VectorTextLayoutOptions.md#align) · `"left"` \| `"right"` \| `"center"` · Optional
 
   Place the advance's start, midpoint or end at the datum; defaults to center on arcs, otherwise left.
 
-- [`baseline`](VectorTextLayoutOptions.md#baseline) · [`VectorTextArcBaseline`](VectorTextArcBaseline.md) · Optional
+- [`baseline`](../geometry/VectorTextLayoutOptions.md#baseline) · [`VectorTextArcBaseline`](../geometry/VectorTextArcBaseline.md) · Optional
 
   Omitted uses horizontal lines. Arcs require one line and baseline vertical alignment.
 
-- [`lineHeight`](VectorTextLayoutOptions.md#lineheight) · `number` · Optional
+- [`lineHeight`](../geometry/VectorTextLayoutOptions.md#lineheight) · `number` · Optional
 
   Baseline spacing in ems, 0.5–5; omitted uses the selected face's natural vertical metrics.
 
-- [`verticalAlign`](VectorTextLayoutOptions.md#verticalalign) · `"top"` \| `"bottom"` \| `"center"` \| `"baseline"` · Optional
+- [`verticalAlign`](../geometry/VectorTextLayoutOptions.md#verticalalign) · `"top"` \| `"bottom"` \| `"center"` \| `"baseline"` · Optional
 
   Place the first baseline or complete ink bounds at Y=0; arcs only accept baseline.
 
-- [`fontWeight`](VectorTextLayoutOptions.md#fontweight) · `number` · Optional
+- [`fontWeight`](../geometry/VectorTextLayoutOptions.md#fontweight) · `number` · Optional
 
   Actual static or variable weight, 1–1000; defaults to the prepared face's static weight.
 
-- [`letterSpacing`](VectorTextLayoutOptions.md#letterspacing) · `number` · Optional
+- [`letterSpacing`](../geometry/VectorTextLayoutOptions.md#letterspacing) · `number` · Optional
 
   Tracking between glyph clusters in millimetres, -100–100; defaults to zero.
 
@@ -116,7 +116,7 @@ Measure the same cached vector layout; all returned lengths are in millimetres.
 
 #### Returns
 
-[`VectorTextMetrics`](VectorTextMetrics.md)
+[`VectorTextMetrics`](../geometry/VectorTextMetrics.md)
 
 ***
 
@@ -124,7 +124,7 @@ Measure the same cached vector layout; all returned lengths are in millimetres.
 
 
 
-`readonly` **toSvg**: (`text`: `string`, `options`: [`VectorTextLayoutOptions`](VectorTextLayoutOptions.md)) => `string`
+`readonly` **toSvg**: (`text`: `string`, `options`: [`VectorTextLayoutOptions`](../geometry/VectorTextLayoutOptions.md)) => `string`
 
 
 
@@ -140,33 +140,33 @@ Serialize visible horizontal or circular outlines as bounded path-only SVG in ph
 
 <a id="options-2"></a>
 
-**`options`** · [`VectorTextLayoutOptions`](VectorTextLayoutOptions.md) · Required
+**`options`** · [`VectorTextLayoutOptions`](../geometry/VectorTextLayoutOptions.md) · Required
 
-- [`fontSize`](VectorTextLayoutOptions.md#fontsize) · `number` · Required
+- [`fontSize`](../geometry/VectorTextLayoutOptions.md#fontsize) · `number` · Required
 
   Em size in millimetres, greater than zero and at most 10000; not the visible glyph height.
 
-- [`align`](VectorTextLayoutOptions.md#align) · `"left"` \| `"right"` \| `"center"` · Optional
+- [`align`](../geometry/VectorTextLayoutOptions.md#align) · `"left"` \| `"right"` \| `"center"` · Optional
 
   Place the advance's start, midpoint or end at the datum; defaults to center on arcs, otherwise left.
 
-- [`baseline`](VectorTextLayoutOptions.md#baseline) · [`VectorTextArcBaseline`](VectorTextArcBaseline.md) · Optional
+- [`baseline`](../geometry/VectorTextLayoutOptions.md#baseline) · [`VectorTextArcBaseline`](../geometry/VectorTextArcBaseline.md) · Optional
 
   Omitted uses horizontal lines. Arcs require one line and baseline vertical alignment.
 
-- [`lineHeight`](VectorTextLayoutOptions.md#lineheight) · `number` · Optional
+- [`lineHeight`](../geometry/VectorTextLayoutOptions.md#lineheight) · `number` · Optional
 
   Baseline spacing in ems, 0.5–5; omitted uses the selected face's natural vertical metrics.
 
-- [`verticalAlign`](VectorTextLayoutOptions.md#verticalalign) · `"top"` \| `"bottom"` \| `"center"` \| `"baseline"` · Optional
+- [`verticalAlign`](../geometry/VectorTextLayoutOptions.md#verticalalign) · `"top"` \| `"bottom"` \| `"center"` \| `"baseline"` · Optional
 
   Place the first baseline or complete ink bounds at Y=0; arcs only accept baseline.
 
-- [`fontWeight`](VectorTextLayoutOptions.md#fontweight) · `number` · Optional
+- [`fontWeight`](../geometry/VectorTextLayoutOptions.md#fontweight) · `number` · Optional
 
   Actual static or variable weight, 1–1000; defaults to the prepared face's static weight.
 
-- [`letterSpacing`](VectorTextLayoutOptions.md#letterspacing) · `number` · Optional
+- [`letterSpacing`](../geometry/VectorTextLayoutOptions.md#letterspacing) · `number` · Optional
 
   Tracking between glyph clusters in millimetres, -100–100; defaults to zero.
 
@@ -179,8 +179,14 @@ Serialize visible horizontal or circular outlines as bounded path-only SVG in ph
 
 ## Related APIs
 
-- [VectorTextLayout](VectorTextLayout.md)
-- [VectorTextLayoutOptions](VectorTextLayoutOptions.md)
-- [VectorTextMetrics](VectorTextMetrics.md)
+- [VectorTextLayout](../geometry/VectorTextLayout.md)
+- [VectorTextLayoutOptions](../geometry/VectorTextLayoutOptions.md)
+- [VectorTextMetrics](../geometry/VectorTextMetrics.md)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Supported imports
+
+```ts
+import type { VectorFont } from "@metamesh/modeling/text";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

package/dist/docs/reference/text/VectorFontOptions.md

@@ -14,4 +14,10 @@ Identifies the actual weight of a static face, without synthesizing a different
 
 Actual weight of a static face, 1–1000; defaults to 400.
 
-Package: `@metamesh/modeling@0.18.0`.
+## Supported imports
+
+```ts
+import type { VectorFontOptions } from "@metamesh/modeling/text";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

package/dist/docs/reference/text/categories/font-preparation.md

@@ -18,18 +18,6 @@ Layout returns immutable paths and metrics in Y-up millimetres. Pass the prepare
 | --- | --- |
 | [VectorFont](../VectorFont.md) | A prepared font owns its parsed bytes; keep handles local to their Worker or invocation. Invalid arguments and bounded-work failures use GeometryError; unexpected dependency errors propagate. |
 | [VectorFontOptions](../VectorFontOptions.md) | Identifies the actual weight of a static face, without synthesizing a different weight. |
-| [VectorTextArcBaseline](../VectorTextArcBaseline.md) | A circular baseline centered at the XY origin, with rigid shaped glyph groups. |
-| [VectorTextLayout](../VectorTextLayout.md) | Immutable vector layout with no browser, font parser, or kernel ownership. |
-| [VectorTextLayoutOptions](../VectorTextLayoutOptions.md) | Text bounded to 512 UTF-16 units: horizontal lines or one circular line without wrapping. |
-| [VectorTextMetrics](../VectorTextMetrics.md) | Text measurements from the same immutable layout that supplies geometry and SVG outlines. |
-| [VectorTextOptions](../VectorTextOptions.md) | Shaping controls for a prepared exact font face; all lengths are in millimetres. |
-| [Bounds2Data](../Bounds2Data.md) | Plain axis-aligned XY bounds for interchange; use bounds2 for immutable measurement methods. |
-
-## Type aliases
-
-| API | Summary |
-| --- | --- |
-| [Vector2Data](../Vector2Data.md) | A two-dimensional Cartesian vector or point. |
 
 ## Values
 
@@ -37,4 +25,4 @@ Layout returns immutable paths and metrics in Y-up millimetres. Pass the prepare
 | --- | --- |
 | [MAX_VECTOR_FONT_BYTES](../MAX_VECTOR_FONT_BYTES.md) | Maximum input font size in bytes, checked before parsing or shaping untrusted font data. |
 
-Package: `@metamesh/modeling@0.18.0`.
+Package: `@metamesh/modeling@0.19.0`.

package/dist/docs/reference/text/prepareVectorFont.md

@@ -43,4 +43,10 @@ async function prepareLabel(fontBytes: Uint8Array) {
 - [VectorFont](VectorFont.md)
 - [VectorFontOptions](VectorFontOptions.md)
 
-Package: `@metamesh/modeling@0.18.0`.
+## Supported imports
+
+```ts
+import { prepareVectorFont } from "@metamesh/modeling/text";
+```
+
+Package: `@metamesh/modeling@0.19.0`.

package/dist/docs/reference/text.md

@@ -20,4 +20,4 @@ Paths and metrics use Y-up millimetres and a baseline origin. Empty layouts can
 
 - [Font preparation](text/categories/font-preparation.md) — Prepare exact font bytes within limits and reuse vector layouts.
 
-Package: `@metamesh/modeling@0.18.0`.
+Package: `@metamesh/modeling@0.19.0`.

package/dist/engine/finalization.js

@@ -1,11 +1,10 @@
 import { GeometryError } from "../geometry/errors.js";
-import { immutableMeshView, isImmutableBuffer, } from "../geometry/immutable-buffer.js";
+import { immutableMeshView } from "../geometry/immutable-buffer.js";
 import { optimizePlanarPatches } from "../geometry/mesh/mesh-planar.js";
 import { validateAnalyzedSolidMesh } from "../geometry/mesh/mesh-solid.js";
+import { MeshViewCache } from "../geometry/mesh/mesh-view-cache.js";
 import { analyzeTriangleMesh, } from "../geometry/mesh/mesh.js";
-import { MeshViewCache } from "./mesh-view-cache.js";
 import { copiedMeshViews, copiedUint32Array } from "./native/copied-views.js";
-const isArray = (value) => Array.isArray(value);
 function fitsGeometryLimits(mesh, limits) {
     const buffers = new Set([mesh.positions.buffer, mesh.indices.buffer]);
     let bytes = 0;
@@ -82,74 +81,3 @@ export function createGeometryFinalizer(execution, limits, options) {
         return result;
     };
 }
-/** Captures mutable external buffers once before an asynchronous snapshot export begins. */
-export function captureExportParts(parts, limits) {
-    if (!isArray(parts) || parts.length === 0 || parts.length > limits.maxParts)
-        throw new GeometryError("COMPLEXITY_LIMIT", `Export requires one through ${limits.maxParts} parts.`, {
-            operation: "export3mf",
-        });
-    const captured = parts.map((part) => {
-        if (typeof part !== "object" || part === null)
-            throw new GeometryError("INVALID_ARGUMENT", "Export part IDs must be unique canonical identifiers.", { operation: "export3mf" });
-        // Trusted immutable storage can outlive the asynchronous export directly. Mutable external
-        // input is captured once below, preserving shared backing buffers before the first await.
-        const { positions, indices } = part;
-        const immutable = isImmutableBuffer(positions) && isImmutableBuffer(indices);
-        const mesh = immutableMeshView({ positions, indices });
-        const id = part.id, color = part.color;
-        return {
-            id,
-            immutable,
-            positions: mesh.positions,
-            indices: mesh.indices,
-            ...(color === undefined ? {} : { color }),
-        };
-    });
-    const identifiers = new Set();
-    const buffers = new Set();
-    let vertexCount = 0, triangleCount = 0, byteCount = 0;
-    for (const part of captured) {
-        if (typeof part !== "object" ||
-            part === null ||
-            typeof part.id !== "string" ||
-            !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(part.id) ||
-            part.id.length > 64 ||
-            identifiers.has(part.id))
-            throw new GeometryError("INVALID_ARGUMENT", "Export part IDs must be unique canonical identifiers.", { operation: "export3mf" });
-        identifiers.add(part.id);
-        if (part.color !== undefined &&
-            (typeof part.color !== "string" || !/^#[\da-f]{6}$/i.test(part.color)))
-            throw new GeometryError("INVALID_ARGUMENT", "Export colors must be six-digit hex strings.", {
-                operation: "export3mf",
-            });
-        if (!(part.positions instanceof Float32Array) ||
-            !(part.indices instanceof Uint32Array) ||
-            !(part.positions.buffer instanceof ArrayBuffer) ||
-            !(part.indices.buffer instanceof ArrayBuffer))
-            throw new GeometryError("INVALID_MESH", "Export requires transferable copied mesh arrays.", {
-                operation: "export3mf",
-            });
-        vertexCount += part.positions.length / 3;
-        triangleCount += part.indices.length / 3;
-        for (const buffer of [part.positions.buffer, part.indices.buffer]) {
-            if (!buffers.has(buffer)) {
-                buffers.add(buffer);
-                byteCount += buffer.byteLength;
-            }
-        }
-        if (vertexCount > limits.maxVertices ||
-            triangleCount > limits.maxTriangles ||
-            byteCount > limits.maxBytes)
-            throw new GeometryError("COMPLEXITY_LIMIT", "Export snapshot exceeds the execution limits.", {
-                operation: "export3mf",
-            });
-    }
-    const copiedBuffers = new Map();
-    return captured.map((part) => ({
-        id: part.id,
-        ...(part.immutable
-            ? { positions: part.positions, indices: part.indices }
-            : copiedMeshViews(part, copiedBuffers)),
-        ...(part.color === undefined ? {} : { color: part.color }),
-    }));
-}

package/dist/engine/index.js

@@ -5,7 +5,6 @@ import createManifoldModule from "./kernel/manifold.js";
 import { withManifoldScope } from "./native/context.js";
 import { createSession } from "./session/session.js";
 export { defaultModelingLimits };
-export { export3mf } from "./export-3mf.js";
 /** URL of the package's pinned WASM asset; browser bundlers may replace it with their emitted URL. */
 export const modelingWasmUrl = new URL("./kernel/manifold.wasm", import.meta.url).href;
 /**
@@ -81,7 +80,8 @@ function engineFromModule(module, engineLimits) {
  * @example Build a box in a host application
  * ```ts
  * import { box, generate } from "@metamesh/modeling";
- * import { createModelEngine, export3mf } from "@metamesh/modeling/engine";
+ * import { createModelEngine } from "@metamesh/modeling/engine";
+ * import { export3mf } from "@metamesh/modeling/export";
  *
  * const engine = await createModelEngine();
  * const model = generate<Record<never, never>>(({ part }) => [part("body", box({ size: [30, 20, 8] }))]);

package/dist/engine/native/construction-mesh.js

@@ -0,0 +1,41 @@
+import { GeometryError } from "../../geometry/errors.js";
+import { assertMeshAllocationWithinLimits, } from "../../geometry/model-limits.js";
+import { ownScopedManifoldValue, scopedManifoldModule, } from "./context.js";
+import { assertNativeSolidStatus } from "./status.js";
+/** Builds new native geometry with retained Double construction coordinates and proxy topology. */
+export function nativeConstructionMesh(scope, mesh, limits, operation) {
+    const vertices = mesh.positions.length / 3;
+    assertMeshAllocationWithinLimits(vertices, mesh.indices.length / 3, mesh.positions.byteLength +
+        mesh.indices.byteLength +
+        mesh.nativePositions.byteLength +
+        vertices * 144, operation, limits);
+    const fail = (message) => {
+        throw new GeometryError("DEGENERATE_GEOMETRY", message, { operation });
+    };
+    if (mesh.nativePositions.length !== mesh.positions.length)
+        fail("Native construction coordinates must cover every proxy vertex.");
+    const key = (x, y, z) => `${x},${y},${z}`;
+    const coordinates = new Map();
+    for (let index = 0; index < mesh.positions.length; index += 3) {
+        if (![0, 1, 2].every((axis) => Number.isFinite(mesh.nativePositions[index + axis])))
+            fail("Native construction coordinates must be finite.");
+        const identity = key(mesh.positions[index], mesh.positions[index + 1], mesh.positions[index + 2]);
+        const prior = coordinates.get(identity);
+        if (prior !== undefined &&
+            [0, 1, 2].some((axis) => mesh.nativePositions[prior + axis] !== mesh.nativePositions[index + axis]))
+            fail("A captured construction vertex has ambiguous native coordinates.");
+        coordinates.set(identity, index);
+    }
+    const module = scopedManifoldModule(scope);
+    const proxy = ownScopedManifoldValue(scope, new module.Manifold(new module.Mesh({ numProp: 3, vertProperties: mesh.positions, triVerts: mesh.indices })));
+    assertNativeSolidStatus(proxy, operation);
+    const result = ownScopedManifoldValue(scope, proxy.warpBatch((positions, count) => {
+        for (let vertex = 0; vertex < count; vertex++) {
+            const offset = vertex * 3;
+            const source = coordinates.get(key(positions[offset], positions[offset + 1], positions[offset + 2])) ?? fail("Native construction lost a captured vertex identity.");
+            positions.set(mesh.nativePositions.subarray(source, source + 3), offset);
+        }
+    }));
+    assertNativeSolidStatus(result, operation);
+    return result;
+}

package/dist/engine/native/material-components.js

@@ -2,6 +2,7 @@ import { GeometryError } from "../../geometry/errors.js";
 import { triangleSolidAngle } from "../../geometry/mesh/mesh-solid-intersections.js";
 import { assertMeshAllocationWithinLimits, } from "../../geometry/model-limits.js";
 import { ownScopedManifoldValue, scopedManifoldModule, } from "./context.js";
+import { observeNativeMesh, } from "./mesh-observation.js";
 import { assertNativeSolidStatus } from "./status.js";
 const MAXIMUM_CONTAINMENT_TESTS = 2_000_000;
 /** Certifies the native sign only when its floating-point error cannot reach zero. */
@@ -34,56 +35,6 @@ function certifiedNativeOrientation(volume, bounds, triangles) {
         return undefined;
     return Math.abs(volume) > error ? (volume < 0 ? -1 : 1) : undefined;
 }
-/** Observes native coordinates and topology without converting geometry to Float32. */
-function nativeShellMesh(scope, shell, limits) {
-    const vertices = shell.numVert();
-    const properties = shell.numPropVert();
-    const triangles = shell.numTri();
-    // Both native observation work and copied topology stay within the host's mesh limits.
-    // Charge the Float64 coordinates, Float32 property mesh, index map and triangle indices.
-    assertMeshAllocationWithinLimits(Math.max(vertices, properties), triangles, vertices * 24 + properties * (shell.numProp() + 4) * 4 + triangles * 12, "components", limits);
-    const coordinates = new Float64Array(vertices * 3);
-    const encoded = ownScopedManifoldValue(scope, shell.warpBatch((positions, count) => {
-        coordinates.set(positions);
-        for (let vertex = 0; vertex < count; vertex++) {
-            // Exact Float32-safe IDs recover native indices even when property vertices
-            // are duplicated or reordered by getMesh(). The original coordinates stay Float64.
-            positions[vertex * 3] = vertex % 65536;
-            positions[vertex * 3 + 1] = Math.floor(vertex / 65536);
-            positions[vertex * 3 + 2] = 0;
-        }
-    }));
-    assertNativeSolidStatus(encoded, "components");
-    if (encoded.numVert() !== vertices || encoded.numTri() !== triangles)
-        throw new GeometryError("INVALID_TOPOLOGY", "Native observation changed shell topology.", {
-            operation: "components",
-        });
-    const mesh = encoded.getMesh();
-    if (mesh.numVert !== properties || mesh.numTri !== triangles)
-        throw new GeometryError("INVALID_TOPOLOGY", "Native observation changed property topology.", {
-            operation: "components",
-        });
-    const indices = new Uint32Array(properties);
-    for (let vertex = 0; vertex < properties; vertex++) {
-        const offset = vertex * mesh.numProp;
-        const low = mesh.vertProperties[offset];
-        const high = mesh.vertProperties[offset + 1];
-        const index = low + high * 65536;
-        if (!Number.isInteger(low) ||
-            low < 0 ||
-            low >= 65536 ||
-            !Number.isInteger(high) ||
-            high < 0 ||
-            !Number.isSafeInteger(index) ||
-            index >= vertices ||
-            mesh.vertProperties[offset + 2] !== 0)
-            throw new GeometryError("INVALID_TOPOLOGY", "Native observation lost a vertex identity.", {
-                operation: "components",
-            });
-        indices[vertex] = index;
-    }
-    return { coordinates, vertexIndices: indices, triangles: mesh.triVerts };
-}
 /** Computes signed enclosed volume without rounding, including folded contact boundaries. */
 function nativeShellOrientation(mesh) {
     const { coordinates, vertexIndices, triangles } = mesh;
@@ -186,7 +137,7 @@ export function solidMaterialComponents(scope, solid, limits) {
             shell.numPropVert() * (shell.numProp() + 4) * 4 +
             shell.numTri() * 12;
         assertMeshAllocationWithinLimits(Math.max(vertices, properties), triangles, bytes, "components", limits);
-        const mesh = nativeShellMesh(scope, shell, limits);
+        const mesh = observeNativeMesh(scope, shell, limits, "components");
         meshes.set(shell, mesh);
         observedVertices = vertices;
         observedProperties = properties;

package/dist/engine/native/mesh-observation.js

@@ -0,0 +1,55 @@
+import { GeometryError } from "../../geometry/errors.js";
+import { assertMeshAllocationWithinLimits, } from "../../geometry/model-limits.js";
+import { ownScopedManifoldValue } from "./context.js";
+import { assertNativeSolidStatus } from "./status.js";
+/** Observes native coordinates and topology without a Float32 geometry round trip. */
+export function observeNativeMesh(scope, solid, limits, operation) {
+    const vertices = solid.numVert();
+    const properties = solid.numPropVert();
+    const triangles = solid.numTri();
+    assertMeshAllocationWithinLimits(Math.max(vertices, properties), triangles, vertices * 24 + properties * (solid.numProp() + 4) * 4 + triangles * 20 + 4, operation, limits);
+    const coordinates = new Float64Array(vertices * 3);
+    const encoded = ownScopedManifoldValue(scope, solid.warpBatch((positions, count) => {
+        coordinates.set(positions);
+        for (let vertex = 0; vertex < count; vertex++) {
+            // Float32-safe IDs preserve native identity through property-vertex duplication/reordering.
+            positions[vertex * 3] = vertex % 65536;
+            positions[vertex * 3 + 1] = Math.floor(vertex / 65536);
+            positions[vertex * 3 + 2] = 0;
+        }
+    }));
+    assertNativeSolidStatus(encoded, operation);
+    if (encoded.numVert() !== vertices || encoded.numTri() !== triangles)
+        throw new GeometryError("INVALID_TOPOLOGY", "Native observation changed shell topology.", {
+            operation,
+        });
+    const mesh = encoded.getMesh();
+    if (mesh.numVert !== properties || mesh.numTri !== triangles)
+        throw new GeometryError("INVALID_TOPOLOGY", "Native observation changed property topology.", {
+            operation,
+        });
+    const indices = new Uint32Array(properties);
+    for (let vertex = 0; vertex < properties; vertex++) {
+        const offset = vertex * mesh.numProp;
+        const low = mesh.vertProperties[offset];
+        const high = mesh.vertProperties[offset + 1];
+        const index = low + high * 65536;
+        if (!Number.isInteger(low) ||
+            low < 0 ||
+            low >= 65536 ||
+            !Number.isInteger(high) ||
+            high < 0 ||
+            !Number.isSafeInteger(index) ||
+            index >= vertices ||
+            mesh.vertProperties[offset + 2] !== 0)
+            throw new GeometryError("INVALID_TOPOLOGY", "Native observation lost a vertex identity.", {
+                operation,
+            });
+        indices[vertex] = index;
+    }
+    return {
+        coordinates,
+        vertexIndices: indices,
+        triangles: mesh.triVerts,
+    };
+}

package/dist/engine/native/regions.js

@@ -82,7 +82,8 @@ export function regionToCrossSection(context, region, limits = {}) {
         return ownScopedManifoldValue(context, module.CrossSection.union([]));
     return ownScopedManifoldValue(context, new module.CrossSection(contoursFromRegion(normalized)));
 }
-const regionFromLoops = (loops) => {
+/** Internal filled-loop classification shared by native Section and exact collar observations. */
+export const regionFromLoops = (loops) => {
     const outers = loops
         .filter((loop) => signedContourArea(loop) > 0)
         .map((outer) => ({ outer: normalizeContour(outer, true), holes: [] }));

package/dist/engine/operations/context.js

@@ -3,6 +3,7 @@ import { createConstructionOperations } from "./construction.js";
 import { createOperationEnvironment } from "./environment.js";
 import { createHoleCutterOperation } from "./hole-cutter.js";
 import { createInspectionOperations } from "./inspection.js";
+import { createJoinOperation } from "./join.js";
 import { createMechanicalOperations } from "./mechanical.js";
 import { createPatternOperations } from "./patterns.js";
 import { createPrimitiveOperations } from "./primitives/construction.js";
@@ -39,6 +40,7 @@ export function createModelingContext(owner, initialResolution) {
             ...sections,
             ...primitives,
             ...construction,
+            join: createJoinOperation(environment),
             holeCutter: createHoleCutterOperation(environment, {
                 cylinder: primitives.cylinder,
                 extrude: construction.extrude,

package/dist/engine/operations/extrusion-finishing.js

@@ -1,14 +1,14 @@
-import { convexContourOffsets } from "../../geometry/convex-offset.js";
 import { edgeTreatmentPointCount, edgeTreatmentSetbacks, sampleEdgeTreatment, } from "../../geometry/edge-finishing.js";
 import { GeometryError } from "../../geometry/errors.js";
 import { resolveExtrusionControls } from "../../geometry/extrusion.js";
 import { assertMeshAllocationWithinLimits, } from "../../geometry/model-limits.js";
+import { planRegionOffsets } from "../../geometry/region-offset.js";
 import { assertSamplingCount } from "../../geometry/sampling-limits.js";
 import { buildProfileLoftMesh } from "./primitives/profile-mesh.js";
 const fail = (message) => {
     throw new GeometryError("INVALID_ARGUMENT", message, { operation: "extrude" });
 };
-/** Finishes inward convex extrusion rims with exact parallel-edge offsets and retained correspondence. */
+/** Finishes every material rim through one source-corresponding regular offset family. */
 export function buildFinishedExtrusion(module, profile, options) {
     const controls = resolveExtrusionControls(options.height, options, "extrude");
     if (controls.twist !== 0 ||
@@ -17,15 +17,6 @@ export function buildFinishedExtrusion(module, profile, options) {
         fail("End treatments require a straight extrusion without twist, top scaling or divisions.");
     if (typeof options.ends !== "object" || options.ends === null || Array.isArray(options.ends))
         fail("ends must be an object.");
-    if (profile.components.length !== 1 || profile.components[0].holes.length !== 0)
-        fail("End treatments require one convex contour without holes; use explicit loft profiles for other topology.");
-    const contour = profile.components[0].outer, points = contour.points;
-    const { magnification, offset } = convexContourOffsets(points, "extrude");
-    const sampling = {
-        resolution: options.resolution,
-        limits: options.limits,
-        magnification,
-    };
     const bottom = options.ends.bottom, top = options.ends.top;
     const bottomSize = bottom === undefined
         ? [0, 0]
@@ -33,10 +24,23 @@ export function buildFinishedExtrusion(module, profile, options) {
     const topSize = top === undefined ? [0, 0] : edgeTreatmentSetbacks(top, "extrude", Math.PI / 2, options.limits);
     if (bottomSize[1] + topSize[1] >= options.height)
         fail("End treatments must leave positive length between their side setbacks.");
+    const plan = planRegionOffsets(profile, [0, Math.max(bottomSize[0], topSize[0])], "extrude", options.limits);
+    const sampling = {
+        resolution: options.resolution,
+        limits: options.limits,
+        magnification: plan.magnification,
+    };
     const rowCount = (bottom === undefined ? 1 : edgeTreatmentPointCount(bottom, "extrude", sampling)) +
         (top === undefined ? 1 : edgeTreatmentPointCount(top, "extrude", sampling));
     assertSamplingCount(rowCount, "extrude", options.limits.maxPathPoints);
-    const vertexCount = rowCount * points.length, triangleCount = 2 * vertexCount - 4;
+    let pointCount = 0, contourCount = 0;
+    for (const component of profile.components) {
+        for (const contour of [component.outer, ...component.holes]) {
+            pointCount += contour.points.length;
+            contourCount++;
+        }
+    }
+    const vertexCount = rowCount * pointCount, triangleCount = 2 * vertexCount + 4 * contourCount;
     assertMeshAllocationWithinLimits(vertexCount, triangleCount, 12 * (vertexCount + triangleCount), "extrude", options.limits);
     const bottomPoints = bottom === undefined ? [[0, 0]] : sampleEdgeTreatment(bottom, "extrude", sampling);
     const topPoints = top === undefined ? [[0, 0]] : sampleEdgeTreatment(top, "extrude", sampling);
@@ -44,12 +48,9 @@ export function buildFinishedExtrusion(module, profile, options) {
         ...bottomPoints.map(([inset, depth]) => ({ inset, z: depth })),
         ...[...topPoints].reverse().map(([inset, depth]) => ({ inset, z: options.height - depth })),
     ];
-    offset(Math.max(bottomSize[0], topSize[0])); // fit fails before allocating the full station family
     const stations = rows.map(({ inset, z }) => ({
         z: controls.center ? z - options.height / 2 : z,
-        profile: {
-            components: [{ ...profile.components[0], outer: { ...contour, points: offset(inset) } }],
-        },
+        profile: plan.profileAt(inset),
     }));
     return buildProfileLoftMesh(module, stations, options.limits);
 }