@metamesh/modeling 0.17.0 → 0.18.0

package/dist/engine/{inspection-operations.js → operations/inspection.js}

@@ -1,13 +1,13 @@
-import { vector3Data } from "../geometry/math/vector-value.js";
-import { ownScopedManifoldValue } from "./native/context.js";
-import { copiedMeshViews } from "./native/copied-views.js";
-import { measureSolidDistance } from "./native/distance.js";
-import { assertNativeSolidStatus } from "./native/status.js";
+import { vector3Data } from "../../geometry/math/vector-value.js";
+import { ownScopedManifoldValue } from "../native/context.js";
+import { copiedMeshViews } from "../native/copied-views.js";
+import { measureSolidDistance } from "../native/distance.js";
+import { assertNativeSolidStatus } from "../native/status.js";
 /** Internal host-bound inspection operations. */
 export function createInspectionOperations(environment) {
     const { scope, throwGeometryError, nativeSolid, resolveHandle, ownSolid, ownSection, wrapSolid, wrapSection, validateFiniteNumber, requirePositiveNumber, validateCoordinates, analyzedMeshFor, solidInspectionFor, sectionInspectionFor, solidComponentsFor, sectionComponentsFor, } = environment;
     const operations = {
-        toTriangleMesh: (value) => copiedMeshViews(analyzedMeshFor(value).mesh, new Map()),
+        toMesh: (value) => copiedMeshViews(analyzedMeshFor(value).mesh, new Map()),
         inspectSection: sectionInspectionFor,
         inspectSolid: solidInspectionFor,
         isEmpty: (handle) => {

package/dist/engine/{knuckle-hinge-operation.js → operations/knuckle-hinge.js}

@@ -1,7 +1,7 @@
-import { GeometryError } from "../geometry/errors.js";
-import { resolveKnuckleHinge } from "../geometry/mechanical/knuckle-hinge.js";
-import { assertPrimitiveOptions } from "../geometry/primitive-resolvers.js";
-import { assertSamplingCount } from "../geometry/sampling-limits.js";
+import { GeometryError } from "../../geometry/errors.js";
+import { resolveKnuckleHinge } from "../../geometry/mechanical/knuckle-hinge.js";
+import { assertPrimitiveOptions } from "../../geometry/primitive-resolvers.js";
+import { assertSamplingCount } from "../../geometry/sampling-limits.js";
 /** Composes existing scoped operations after resolving both halves against one host policy. */
 export function createKnuckleHingeOperation(environment, operations) {
     return (options) => {

package/dist/engine/{loft-operations.js → operations/loft.js}

@@ -1,13 +1,16 @@
-import { GeometryError } from "../geometry/errors.js";
-import { loftProfilePointCount, pointLoftProfile, prepareLoftGeometry, } from "../geometry/loft/loft-geometry.js";
-import { loftFrame, resolveLoftControls } from "../geometry/loft/loft-options.js";
-import { simpleLoftMesh } from "../geometry/loft/loft-simple-mesh.js";
-import { analyzeTriangleMesh } from "../geometry/mesh/mesh.js";
-import { capturePath2Input, path2InputData, } from "../geometry/paths/path-value.js";
-import { assertSamplingCount } from "../geometry/sampling-limits.js";
-import { correspondingPrimitiveProfiles, rectangularPrimitiveFamily, } from "./primitive-profiles.js";
-import { buildProfileLoftMesh } from "./profile-mesh.js";
-const explicitProfile = (value) => typeof value === "object" && value !== null && "components" in value;
+import { GeometryError } from "../../geometry/errors.js";
+import { loftProfilePointCount, pointLoftProfile, prepareLoftGeometry, } from "../../geometry/loft/loft-geometry.js";
+import { loftFrame, resolveLoftControls } from "../../geometry/loft/loft-options.js";
+import { simpleLoftMesh } from "../../geometry/loft/loft-simple-mesh.js";
+import { analyzeTriangleMesh } from "../../geometry/mesh/mesh.js";
+import { capturePath2Input, path2InputData, } from "../../geometry/paths/path-value.js";
+import { assertSamplingCount, } from "../../geometry/sampling-limits.js";
+import { buildProfileLoftMesh } from "./primitives/profile-mesh.js";
+import { correspondingPrimitiveProfiles, rectangularPrimitiveFamily, } from "./primitives/profiles.js";
+const explicitProfile = (value) => typeof value === "object" &&
+    value !== null &&
+    "components" in value &&
+    Array.isArray(value.components);
 const pointProfile = (value) => Array.isArray(value) || (typeof value === "object" && value !== null && "toData" in value);
 const fail = (message) => {
     throw new GeometryError("INVALID_ARGUMENT", message, { operation: "loft" });
@@ -124,8 +127,6 @@ export function createLoftOperation(environment, solidFromMesh) {
             selected = environment.withResolutionDefaults({ ...value, limits: sampling });
             recipeSampled = sources.map((source) => source !== undefined);
             const known = sources.every((source) => source !== undefined);
-            if (value.correspondence === undefined && !known)
-                fail("Arbitrary Sections and point loops require an explicit correspondence method for loft.");
             const family = value.correspondence === undefined && known
                 ? sources.every((source) => source.family === sources[0].family)
                     ? sources

package/dist/engine/{mechanical-operations.js → operations/mechanical.js}

@@ -1,5 +1,5 @@
-import { createKnuckleHingeOperation } from "./knuckle-hinge-operation.js";
-import * as kernel from "./native/index.js";
+import * as kernel from "../native/index.js";
+import { createKnuckleHingeOperation } from "./knuckle-hinge.js";
 /** Internal host-bound mechanical operations. */
 export function createMechanicalOperations(environment, construction) {
     const { resolution } = environment;

package/dist/engine/{pattern-operations.js → operations/patterns.js}

@@ -1,7 +1,7 @@
-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";
+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) => {

package/dist/engine/{primitive-anchors.js → operations/primitives/anchors.js}

@@ -1,9 +1,13 @@
-import { anchor3, boxAnchor3 } from "../geometry/anchors.js";
-import { resolveCylinderRadii } from "../geometry/cylinder.js";
+import { anchor3, boxAnchor3 } from "../../../geometry/anchors.js";
+import { resolveCylinderRadii } from "../../../geometry/cylinder.js";
+import { vector3Data } from "../../../geometry/math/vector-value.js";
+import { resolveTubeRadii } from "../../../geometry/primitive-resolvers.js";
 const faces = ["left", "right", "back", "front", "bottom", "top"];
 /** Nominal primitive datums; construction validates dimensions before these factories run. */
 export function boxAnchors(options) {
-    const size = typeof options.size === "number" ? [options.size, options.size, options.size] : options.size;
+    const size = typeof options.size === "number"
+        ? [options.size, options.size, options.size]
+        : vector3Data(options.size);
     const center = options.center === false ? [size[0] / 2, size[1] / 2, size[2] / 2] : [0, 0, 0];
     return {
         center: anchor3(center, [0, 0, 1]),
@@ -39,7 +43,8 @@ export function cylinderAnchors(options) {
 }
 /** Tube cap centers lie on the nominal cap planes, including the central opening. */
 export function tubeAnchors(options) {
-    return axialAnchors([options.outerRadius, options.outerRadius], options.height, options.center ?? true);
+    const { outerRadius } = resolveTubeRadii(options);
+    return axialAnchors([outerRadius, outerRadius], options.height, options.center ?? true);
 }
 /** Sphere principal surface points and its origin reference. */
 export function sphereAnchors(options) {

package/dist/engine/{primitive-operations.js → operations/primitives/construction.js}

@@ -1,17 +1,19 @@
-import { resolveCircularSampling } from "../geometry/circular-sampling.js";
-import { resolveCylinderRadii } from "../geometry/cylinder.js";
-import { resolveModelingLimits } from "../geometry/model-limits.js";
-import { assertPrimitiveOptions } from "../geometry/primitive-resolvers.js";
-import { regularPolygonContour, starContour } from "../geometry/profiles/profiles.js";
-import { rectangleContour, resolveRectangle, } from "../geometry/profiles/rectangle.js";
-import { ellipseContour } from "../geometry/profiles/shapes.js";
-import { requireProfileVertexCount } from "../geometry/profiles/validation.js";
-import * as kernel from "./native/index.js";
-import { boxAnchors, cylinderAnchors, originAnchor, planarAnchors, sphereAnchors, torusAnchors, tubeAnchors, } from "./primitive-anchors.js";
-import { ellipticalSectionProfile, polygonSectionProfile, rectangleSectionProfile, } from "./primitive-profiles.js";
+import { resolveCircularSampling } from "../../../geometry/circular-sampling.js";
+import { resolveCylinderRadii } from "../../../geometry/cylinder.js";
+import { vector2Data } from "../../../geometry/math/vector-value.js";
+import { resolveModelingLimits } from "../../../geometry/model-limits.js";
+import { assertPrimitiveOptions } from "../../../geometry/primitive-resolvers.js";
+import { ellipseContour } from "../../../geometry/profiles/primitives/ellipse.js";
+import { rectangleContour, resolveRectangle, } from "../../../geometry/profiles/primitives/rectangle.js";
+import { regularPolygonContour } from "../../../geometry/profiles/primitives/regular-polygon.js";
+import { starContour } from "../../../geometry/profiles/primitives/star.js";
+import { requireProfileVertexCount } from "../../../geometry/profiles/validation.js";
+import * as kernel from "../../native/index.js";
+import { boxAnchors, cylinderAnchors, originAnchor, planarAnchors, sphereAnchors, torusAnchors, tubeAnchors, } from "./anchors.js";
+import { ellipticalSectionProfile, polygonSectionProfile, rectangleSectionProfile, } from "./profiles.js";
 /** Internal host-bound primitive operations. */
 export function createPrimitiveOperations(environment, transforms, sections) {
-    const { module, scope, assertActive, throwGeometryError, ownSection, validateFiniteNumber, requirePositiveNumber, validateCoordinates, withResolutionDefaults, resolveCircularSegments, } = environment;
+    const { module, scope, assertActive, throwGeometryError, ownSection, requirePositiveNumber, validateCoordinates, withResolutionDefaults, resolveCircularSegments, } = environment;
     const { placedSolid, placedSection } = transforms;
     const fromContours = (contours) => sections.polygon({ contours });
     const operations = {
@@ -102,7 +104,7 @@ export function createPrimitiveOperations(environment, transforms, sections) {
                     }),
             };
             const points = rectangleContour(options);
-            const dimensions = typeof value.size === "number" ? [value.size, value.size] : value.size;
+            const dimensions = typeof value.size === "number" ? [value.size, value.size] : vector2Data(value.size);
             const section = setbacks.every((pair) => pair.every((distance) => distance === 0))
                 ? ownSection(module.CrossSection.square(dimensions, value.center ?? true))
                 : fromContours([points]);
@@ -131,7 +133,8 @@ export function createPrimitiveOperations(environment, transforms, sections) {
         ellipse: (value) => placedSection(value, () => {
             if ((value.radius === undefined) === (value.size === undefined))
                 throwGeometryError("INVALID_ARGUMENT", "ellipse", "Specify exactly one radius or size tuple.");
-            const radii = value.radius ?? [value.size[0] / 2, value.size[1] / 2];
+            const dimensions = vector2Data(value.radius ?? value.size);
+            const radii = value.radius === undefined ? [dimensions[0] / 2, dimensions[1] / 2] : dimensions;
             validateCoordinates(radii, 2, "ellipse");
             const resolved = withResolutionDefaults(value);
             const section = fromContours([
@@ -150,12 +153,8 @@ export function createPrimitiveOperations(environment, transforms, sections) {
             return environment.rememberPrimitiveProfile(section, polygonSectionProfile(`polygon-${value.sides}`, loop, resolved.resolution, resolved.limits));
         }),
         star: (value) => placedSection(value, () => {
-            const angle = (validateFiniteNumber(value.rotation ?? 0, "star") * Math.PI) / 180;
             const resolved = withResolutionDefaults(value);
-            const loop = starContour(value.outerRadius, value.points, value.innerRadius, resolved.limits).map(([x, y]) => [
-                x * Math.cos(angle) - y * Math.sin(angle),
-                x * Math.sin(angle) + y * Math.cos(angle),
-            ]);
+            const loop = starContour({ ...value, limits: resolved.limits });
             const section = environment.rememberAnchors(fromContours([loop]), originAnchor());
             return environment.rememberPrimitiveProfile(section, polygonSectionProfile(`star-${value.points}`, loop, resolved.resolution, resolved.limits));
         }),

package/dist/engine/{primitive-correspondence.js → operations/primitives/correspondence.js}

@@ -1,7 +1,7 @@
-import { GeometryError } from "../geometry/errors.js";
-import { matchProfiles, } from "../geometry/profiles/matched.js";
-import { createProfileSpanSampler } from "../geometry/profiles/span-sampling.js";
-import { assertSamplingCount } from "../geometry/sampling-limits.js";
+import { GeometryError } from "../../../geometry/errors.js";
+import { matchProfiles, } from "../../../geometry/profiles/match-profiles.js";
+import { createProfileSpanSampler } from "../../../geometry/profiles/span-sampling.js";
+import { assertSamplingCount, } from "../../../geometry/sampling-limits.js";
 /** Primitive exact counts describe physical facets; identified user Profile counts describe analytic grids. */
 export function samplePrimitiveFamily(sources, profiles, resolution, limits) {
     const matched = matchProfiles(profiles, { resolution, limits });

package/dist/engine/{profile-mesh.js → operations/primitives/profile-mesh.js}

@@ -1,15 +1,15 @@
-import { GeometryError } from "../geometry/errors.js";
-import { loftFrame } from "../geometry/loft/loft-options.js";
-import { assertMeshAllocationWithinLimits } from "../geometry/model-limits.js";
-import { writeMeshVertex } from "../geometry/numeric.js";
-import { normalizeRegion, signedContourArea } from "../geometry/regions.js";
-import { assertSamplingCount } from "../geometry/sampling-limits.js";
-import { resolveSweepScales } from "../geometry/sweeps/options.js";
-import { computeSweepFrames, validateSweepOptions } from "../geometry/sweeps/orientation.js";
-import { planSweepStations, refineSweepStations } from "../geometry/sweeps/stations.js";
-import { normalizeSweepPath } from "../geometry/sweeps/validation.js";
-import { resolveGeometryTolerance } from "../geometry/tolerance.js";
-import { frameTransform3 } from "../geometry/transform3.js";
+import { GeometryError } from "../../../geometry/errors.js";
+import { loftFrame } from "../../../geometry/loft/loft-options.js";
+import { assertMeshAllocationWithinLimits } from "../../../geometry/model-limits.js";
+import { writeMeshVertex } from "../../../geometry/numeric.js";
+import { normalizeRegion, signedContourArea } from "../../../geometry/regions.js";
+import { assertSamplingCount } from "../../../geometry/sampling-limits.js";
+import { resolveSweepScales } from "../../../geometry/sweeps/options.js";
+import { computeSweepFrames, validateSweepOptions } from "../../../geometry/sweeps/orientation.js";
+import { planSweepStations, refineSweepStations } from "../../../geometry/sweeps/stations.js";
+import { normalizeSweepPath } from "../../../geometry/sweeps/validation.js";
+import { resolveGeometryTolerance } from "../../../geometry/tolerance.js";
+import { frameTransform3 } from "../../../geometry/transform3.js";
 const fail = (message) => {
     throw new GeometryError("INVALID_ARGUMENT", message, { operation: "loft" });
 };

package/dist/engine/{primitive-profiles.js → operations/primitives/profiles.js}

@@ -1,10 +1,10 @@
-import { planarCubicControl } from "../geometry/curves/evaluation.js";
-import { resolveLineSegmentCount, resolveUniformCubicSegments, } from "../geometry/curves/sampling.js";
-import { GeometryError } from "../geometry/errors.js";
-import {} from "../geometry/profiles/matched.js";
-import { rectangleProfile, resolveRectangle, } from "../geometry/profiles/rectangle.js";
-import { resolveArcSegments, resolveGeometryResolution, } from "../geometry/resolution.js";
-import { samplePrimitiveFamily } from "./primitive-correspondence.js";
+import { planarCubicControl } from "../../../geometry/curves/evaluation.js";
+import { resolveLineSegmentCount, resolveUniformCubicSegments, } from "../../../geometry/curves/sampling.js";
+import { GeometryError } from "../../../geometry/errors.js";
+import {} from "../../../geometry/profiles/match-profiles.js";
+import { rectangleProfile, resolveRectangle, } from "../../../geometry/profiles/primitives/rectangle.js";
+import { resolveArcSegments, resolveGeometryResolution, } from "../../../geometry/resolution.js";
+import { samplePrimitiveFamily } from "./correspondence.js";
 const identity = [1, 0, 0, 0, 1, 0, 0, 0, 1];
 const cornerIds = ["top-right", "top-left", "bottom-left", "bottom-right"];
 /** Captures rectangle landmarks separately from its existing native filled geometry. */

package/dist/engine/{section-operations.js → operations/sections.js}

@@ -1,11 +1,11 @@
-import { path2InputData, path2InputPointCount, } from "../geometry/paths/path-value.js";
-import { assertSamplingCount } from "../geometry/sampling-limits.js";
-import { strokePathContours } from "../geometry/stroke-path.js";
-import { preflightSvgRegion } from "../geometry/svg-import.js";
-import { parseSvgPath } from "../geometry/svg/index.js";
-import { sampleTextContours } from "../geometry/text-contours.js";
-import * as kernel from "./native/index.js";
-import { MAX_AGGREGATE_CONTOURS } from "./native/regions.js";
+import { path2InputData, path2InputPointCount, } from "../../geometry/paths/path-value.js";
+import { assertSamplingCount } from "../../geometry/sampling-limits.js";
+import { strokePathContours } from "../../geometry/stroke-path.js";
+import { preflightSvgRegion } from "../../geometry/svg/import.js";
+import { parseSvgPath } from "../../geometry/svg/index.js";
+import { sampleTextContours } from "../../geometry/text-contours.js";
+import * as kernel from "../native/index.js";
+import { MAX_AGGREGATE_CONTOURS } from "../native/regions.js";
 /** Internal host-bound section operations. */
 export function createSectionOperations(environment, transforms) {
     const { module, limits, scope, assertActive, throwGeometryError, nativeSolid, nativeSection, wrapSection, ownSection, validateFiniteNumber, validateCoordinates, assertOperandCount, withResolutionDefaults, resolveCircularSegments, } = environment;

package/dist/engine/{transform-operations.js → operations/transforms.js}

@@ -1,11 +1,11 @@
-import { attachmentTransform3 } from "../geometry/anchors.js";
-import { vector2Data, vector3Data, } from "../geometry/math/vector-value.js";
-import { assertPrimitiveOptions } from "../geometry/primitive-resolvers.js";
-import { readTransformMatrix } from "../geometry/transform-matrix.js";
-import { transform2, transform3, } from "../geometry/transform-value.js";
-import { eulerTransform3, scaleTransform3, translationTransform3, validateTransform3, } from "../geometry/transform3.js";
-import * as kernel from "./native/index.js";
-import { transformPrimitiveSectionProfile } from "./primitive-profiles.js";
+import { attachmentTransform3 } from "../../geometry/anchors.js";
+import { vector2Data, vector3Data, } from "../../geometry/math/vector-value.js";
+import { assertPrimitiveOptions } from "../../geometry/primitive-resolvers.js";
+import { readTransformMatrix } from "../../geometry/transform-matrix.js";
+import { transform2, transform3, } from "../../geometry/transform-value.js";
+import { eulerTransform3, scaleTransform3, translationTransform3, validateTransform3, } from "../../geometry/transform3.js";
+import * as kernel from "../native/index.js";
+import { transformPrimitiveSectionProfile } from "./primitives/profiles.js";
 /** Internal host-bound transform operations. */
 export function createTransformOperations(environment) {
     const { scope, throwGeometryError, resolveHandle, nativeSolid, wrapSolid, ownSection, validateFiniteNumber, validateCoordinates, } = environment;

package/dist/engine/placement.js

@@ -1,11 +1,10 @@
 import { validateAnalyzedSolidMesh } from "../geometry/mesh/mesh-solid.js";
 import { analyzeTriangleMesh } from "../geometry/mesh/mesh.js";
-import { composeTransform3, eulerTransform3, translationTransform3, } from "../geometry/transform3.js";
+import { IDENTITY_TRANSFORM3 } from "../geometry/transform3.js";
 /** Places already validated immutable geometry once, retaining its indexed topology. */
-export function placeFinalizedGeometry(source, position, rotation, meshValidation) {
-    if ([...position, ...rotation].every((value) => value === 0))
+export function placeFinalizedGeometry(source, matrix, meshValidation) {
+    if (matrix.every((value, index) => value === IDENTITY_TRANSFORM3[index]))
         return source;
-    const matrix = composeTransform3(translationTransform3(position), eulerTransform3(rotation));
     const positions = new Float32Array(source.positions.length);
     for (let offset = 0; offset < positions.length; offset += 3) {
         const x = source.positions[offset], y = source.positions[offset + 1], z = source.positions[offset + 2];

package/dist/engine/recipe-realization.js

@@ -1,7 +1,7 @@
 import { GeometryError } from "../geometry/errors.js";
+import { immutableBufferView, isImmutableBuffer } from "../geometry/immutable-buffer.js";
 import { isImmutableMathValue } from "../geometry/math/immutable-value.js";
 import { geometryRecipe, isGeometryRecipe } from "../model/geometry-recipes.js";
-import { immutableBufferView, isImmutableBuffer } from "../model/immutable-buffer.js";
 import { generationDataMetadata } from "../model/immutable-generation-data.js";
 /**
  * Evaluates immutable recipes within one host revision. These maps memoize borrowed native handles;

package/dist/engine/serialize-3mf.js

@@ -0,0 +1,116 @@
+import { Zip, ZipDeflate } from "fflate";
+import { GeometryError } from "../geometry/errors.js";
+import { analyzeSolidMesh } from "../geometry/mesh/mesh-solid.js";
+import { analyzeTriangleMesh, } from "../geometry/mesh/mesh.js";
+import { MeshViewCache } from "./mesh-view-cache.js";
+const namespace = "http://schemas.microsoft.com/3dmanufacturing/core/2015/02";
+const declaration = '<?xml version="1.0" encoding="UTF-8"?>';
+const encoder = new TextEncoder();
+const escapeXml = (value) => value.replace(/[&<>"']/g, (character) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&apos;" })[character]);
+/** Private core 3MF serializer. It preserves the selected buffers and streams bounded XML chunks. */
+export function meshesTo3mf(parts, options) {
+    if (options.meshValidation !== undefined &&
+        options.meshValidation !== "topology" &&
+        options.meshValidation !== "solid")
+        throw new GeometryError("INVALID_ARGUMENT", "Unsupported mesh validation mode.", {
+            operation: "export3mf",
+        });
+    const name = options.name ?? "MetaMesh model";
+    if (typeof name !== "string" ||
+        name.length === 0 ||
+        name.length > 1024 ||
+        // eslint-disable-next-line no-control-regex -- XML 1.0 disallows these control characters.
+        /[\u0000-\u0008\u000b\u000c\u000e-\u001f\ud800-\udfff\ufffe\uffff]/u.test(name))
+        throw new GeometryError("INVALID_ARGUMENT", "3MF names require one through 1024 valid XML characters.", { operation: "export3mf" });
+    const analyzed = new MeshViewCache();
+    for (const part of parts) {
+        let facts = analyzed.get(part);
+        if (facts !== undefined)
+            continue;
+        facts =
+            options.meshValidation === "solid"
+                ? analyzeSolidMesh(part)
+                : analyzeTriangleMesh(part, { requireClosed: true, includeTopology: true });
+        if (!(facts.signedVolume > 0) || facts.vertexCount >= 2 ** 31 || facts.triangleCount >= 2 ** 31)
+            throw new GeometryError("INVALID_TOPOLOGY", "3MF parts require positive oriented volume and valid core resource counts.", { operation: "export3mf" });
+        analyzed.set(part, facts);
+    }
+    const chunks = [];
+    let bytes = 0, complete = false;
+    const zip = new Zip((error, data, final) => {
+        if (error !== null)
+            throw error;
+        bytes += data.byteLength;
+        if (bytes >= 0xffffffff)
+            throw new GeometryError("COMPLEXITY_LIMIT", "3MF ZIP output exceeds its 32-bit container limit.", { operation: "export3mf" });
+        chunks.push(data);
+        complete = final;
+    });
+    const add = (path) => {
+        const file = new ZipDeflate(path, { level: 6 });
+        file.mtime = new Date(1980, 0, 1);
+        zip.add(file);
+        return file;
+    };
+    const addText = (path, contents) => add(path).push(encoder.encode(contents), true);
+    try {
+        addText("[Content_Types].xml", `${declaration}<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types"><Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/><Default Extension="model" ContentType="application/vnd.ms-package.3dmanufacturing-3dmodel+xml"/></Types>`);
+        addText("_rels/.rels", `${declaration}<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"><Relationship Target="/3D/3dmodel.model" Id="model" Type="http://schemas.microsoft.com/3dmanufacturing/2013/01/3dmodel"/></Relationships>`);
+        const model = add("3D/3dmodel.model");
+        let xml = "", xmlBytes = 0;
+        const flush = (final = false) => {
+            const data = encoder.encode(xml);
+            xmlBytes += data.byteLength;
+            if (xmlBytes >= 0xffffffff)
+                throw new GeometryError("COMPLEXITY_LIMIT", "3MF model XML exceeds its 32-bit ZIP entry limit.", { operation: "export3mf" });
+            model.push(data, final);
+            xml = "";
+        };
+        const append = (value) => {
+            xml += value;
+            if (xml.length >= 32_768)
+                flush();
+        };
+        append(`${declaration}<model unit="millimeter" xml:lang="en-US" xmlns="${namespace}"><metadata name="Application">MetaMesh Modeling</metadata><metadata name="Title">${escapeXml(name)}</metadata><resources>`);
+        const colors = new Map();
+        for (const part of parts)
+            if (part.color !== undefined && !colors.has(part.color.toLowerCase()))
+                colors.set(part.color.toLowerCase(), colors.size);
+        const materialId = parts.length + 1;
+        if (colors.size) {
+            append(`<basematerials id="${materialId}">`);
+            for (const color of colors.keys())
+                append(`<base name="Color ${color.slice(1)}" displaycolor="${color.toUpperCase()}FF"/>`);
+            append("</basematerials>");
+        }
+        parts.forEach((part, index) => {
+            const material = part.color === undefined
+                ? ""
+                : ` pid="${materialId}" pindex="${colors.get(part.color.toLowerCase())}"`;
+            append(`<object id="${index + 1}" name="${escapeXml(part.id)}" partnumber="${escapeXml(part.id)}" type="model"${material}><mesh><vertices>`);
+            for (let offset = 0; offset < part.positions.length; offset += 3)
+                append(`<vertex x="${part.positions[offset]}" y="${part.positions[offset + 1]}" z="${part.positions[offset + 2]}"/>`);
+            append("</vertices><triangles>");
+            for (let offset = 0; offset < part.indices.length; offset += 3)
+                append(`<triangle v1="${part.indices[offset]}" v2="${part.indices[offset + 1]}" v3="${part.indices[offset + 2]}"/>`);
+            append("</triangles></mesh></object>");
+        });
+        append("</resources><build>");
+        parts.forEach((_, index) => append(`<item objectid="${index + 1}"/>`));
+        append("</build></model>");
+        flush(true);
+        zip.end();
+        if (!complete)
+            throw new Error("The synchronous 3MF compressor did not complete.");
+        const result = new Uint8Array(bytes);
+        let offset = 0;
+        for (const chunk of chunks) {
+            result.set(chunk, offset);
+            offset += chunk.byteLength;
+        }
+        return result.buffer;
+    }
+    finally {
+        zip.terminate();
+    }
+}

package/dist/engine/{deferred-context.js → session/deferred-context.js}

@@ -1,7 +1,7 @@
-import { geometryRecipe, isGeometryRecipe } from "../model/geometry-recipes.js";
-import { dispatchModelOperation } from "../model/operation-dispatch.js";
-import { createRecipeContext } from "../model/recipe-declaration.js";
-import { RecipeRealization } from "./recipe-realization.js";
+import { geometryRecipe, isGeometryRecipe } from "../../model/geometry-recipes.js";
+import { dispatchModelOperation } from "../../model/operation-dispatch.js";
+import { createRecipeContext } from "../../model/recipe-declaration.js";
+import { RecipeRealization } from "../recipe-realization.js";
 /** Supplies active observations and limits without capturing the host's implicit sampling policy. */
 export function createDeferredContext(owner, native, limits, duringNative, assertActive, restoreNative = () => undefined) {
     const realization = new RecipeRealization(owner, native, duringNative, restoreNative);

package/dist/engine/{model-dependencies.js → session/dependencies.js}

@@ -32,7 +32,7 @@ export function createModelDependencies(output, modelParameters, entries, reader
             computations: Object.freeze([...(entry?.dependencies.keys() ?? [])].sort()),
         }))),
         parts: Object.freeze(output.map((part) => {
-            const roots = [part.geometry, part.position, part.rotation].flatMap((value) => {
+            const roots = [part.geometry, part.transform].flatMap((value) => {
                 const id = typeof value === "function" ? readerIds.get(value) : undefined;
                 return id === undefined ? [] : [id];
             });

package/dist/engine/{session-graph.js → session/graph.js}

@@ -1,8 +1,9 @@
-import { GeometryError } from "../geometry/errors.js";
-import { GenerationError, } from "../model/generation.js";
-import { captureGenerationDependencies, captureGenerationValue, compareGenerationValues, generationDataEntries, } from "../model/immutable-generation-data.js";
-import { createModelDependencies } from "./model-dependencies.js";
-import { assertSynchronousScopeResult } from "./native/ownership.js";
+import { GeometryError } from "../../geometry/errors.js";
+import { captureDiagnosticPath } from "../../model/diagnostic-path.js";
+import { GenerationError, } from "../../model/generation.js";
+import { captureGenerationDependencies, captureGenerationValue, compareGenerationValues, generationDataEntries, isImmutableGenerationValue, } from "../../model/immutable-generation-data.js";
+import { assertSynchronousScopeResult } from "../native/ownership.js";
+import { createModelDependencies } from "./dependencies.js";
 function reusableEntry(node) {
     if (node.state.kind === "ready")
         return node.state.entry;
@@ -28,7 +29,9 @@ function evaluateComputed(callback) {
 /** Reuse immutable captures only when the host supplies the same input value. */
 function captureParameters(input, previousInput, previousSnapshot) {
     return Object.freeze(Object.fromEntries(Array.from(generationDataEntries(input), ([key, value]) => {
-        if (Object.is(value, previousInput[key]) && Object.hasOwn(previousSnapshot, key))
+        if (Object.is(value, previousInput[key]) &&
+            Object.hasOwn(previousSnapshot, key) &&
+            isImmutableGenerationValue(value))
             return [key, previousSnapshot[key]];
         return [key, captureGenerationValue(value)];
     })));
@@ -329,6 +332,7 @@ export function createGenerationGraph(options, maxParts) {
                     severity,
                     message,
                     ...(metadata?.parameterId === undefined ? {} : { parameterId: metadata.parameterId }),
+                    ...(metadata?.path === undefined ? {} : { path: captureDiagnosticPath(metadata.path) }),
                 }));
                 if (severity === "error") {
                     assertionFailure ??= new GenerationError(diagnostics);
@@ -345,11 +349,9 @@ export function createGenerationGraph(options, maxParts) {
                 const configuration = typeof value === "object" && value !== null && "geometry" in value
                     ? value
                     : { geometry: value };
-                for (const value of [
-                    configuration.geometry,
-                    configuration.position,
-                    configuration.rotation,
-                ])
+                if ("position" in configuration || "rotation" in configuration)
+                    invalid("Part placement uses transform; position and rotation are not supported.");
+                for (const value of [configuration.geometry, configuration.transform])
                     if (typeof value === "function" && !readerIds.has(value))
                         invalid("Part readers must belong to this model session.");
                 const descriptor = Object.freeze({ ...configuration, id });

package/dist/engine/{session-native.js → session/native-cache.js}

@@ -1,4 +1,4 @@
-import { generationValueBytes } from "../model/immutable-generation-data.js";
+import { generationValueBytes } from "../../model/immutable-generation-data.js";
 function disposeValues(values) {
     const errors = [];
     for (const value of new Set(values)) {

package/dist/engine/{session.js → session/session.js}

@@ -1,15 +1,16 @@
-import { GeometryError } from "../geometry/errors.js";
-import { resolveModelingLimits } from "../geometry/model-limits.js";
-import { bindModelContext } from "../model/execution-binding.js";
-import { captureGenerationValue, generationValueBytes, } from "../model/immutable-generation-data.js";
+import { GeometryError } from "../../geometry/errors.js";
+import { resolveModelingLimits } from "../../geometry/model-limits.js";
+import { bindModelContext } from "../../model/execution-binding.js";
+import { GenerationError } from "../../model/generation.js";
+import { captureGenerationValue, generationValueBytes, } from "../../model/immutable-generation-data.js";
 import { createDeferredContext } from "./deferred-context.js";
-import { createGenerationGraph } from "./session-graph.js";
-import { createNativeGeometryCache } from "./session-native.js";
-import { createSnapshotCache } from "./session-snapshot.js";
+import { createGenerationGraph } from "./graph.js";
+import { createNativeGeometryCache } from "./native-cache.js";
+import { createSnapshotCache } from "./snapshot-cache.js";
 function invalid(message) {
     throw new GeometryError("INVALID_ARGUMENT", message, { operation: "generate" });
 }
-/** Coordinates native transactions and bounded atomic cache commits; snapshots own their lifetime. */
+/** Coordinates native transactions and bounded atomic cache commits; results remain durable after cache cleanup. */
 export function createSession(program, suppliedOptions, engineLimits, transaction) {
     const options = Object.freeze({
         ...suppliedOptions,
@@ -58,6 +59,11 @@ export function createSession(program, suppliedOptions, engineLimits, transactio
             // Nothing becomes reusable until geometry validation AND native cleanup have succeeded.
             revision.commit();
         }
+        catch (error) {
+            if (mode === "validate" && error instanceof GenerationError)
+                return error.diagnostics;
+            throw error;
+        }
         finally {
             try {
                 revision.dispose();
@@ -69,8 +75,8 @@ export function createSession(program, suppliedOptions, engineLimits, transactio
         return completed.capture.snapshot;
     }
     return Object.freeze({
-        run: (params) => execute(params, "run"),
-        validate: (params) => execute(params, "validate"),
+        run: (params) => execute(params === undefined ? {} : params, "run"),
+        check: (params) => execute(params === undefined ? {} : params, "validate"),
         clearCache() {
             if (running)
                 invalid("Cannot clear a running session.");