@metamesh/modeling 0.17.0 → 0.19.0

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;
@@ -48,7 +48,7 @@ export class RecipeRealization {
     realizedShape(shape) {
         return this.realized.get(shape);
     }
-    /** Prefers intermediate operands when not every computed output fits the retention budget. */
+    /** Prefers intermediate operands when not every memo output fits the retention budget. */
     retentionCandidates(values) {
         const shapes = new Set(recipeShapes(values));
         return [...shapes].sort((left, right) => Number(this.operands.has(right)) - Number(this.operands.has(left)));

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/session/dependencies.js

@@ -0,0 +1,93 @@
+import { isImmutableBuffer } from "../../geometry/immutable-buffer.js";
+import { isImmutableMathValue } from "../../geometry/math/immutable-value.js";
+import { geometryRecipe } from "../../model/geometry-recipes.js";
+import { generationDataMetadata } from "../../model/immutable-generation-data.js";
+const objectValue = (value) => typeof value === "object" && value !== null;
+function children(value, includeRecipeOperands = false) {
+    if (isImmutableBuffer(value) ||
+        isImmutableMathValue(value) ||
+        ArrayBuffer.isView(value) ||
+        value instanceof ArrayBuffer)
+        return [];
+    const recipe = geometryRecipe(value);
+    if (recipe !== undefined)
+        return includeRecipeOperands ? recipe.call.args : [];
+    return generationDataMetadata(value)?.children ?? Object.values(value);
+}
+/** Weak membership summaries avoid walking captured outline/grid graphs again on warm revisions. */
+export function createMemoProvenance() {
+    const summaries = new WeakMap();
+    const summarize = (root) => {
+        let summary = summaries.get(root);
+        if (summary !== undefined)
+            return summary;
+        summary = new WeakSet();
+        const visit = (value) => {
+            if (!objectValue(value) || summary.has(value))
+                return;
+            summary.add(value);
+            for (const child of children(value))
+                visit(child);
+        };
+        visit(root);
+        summaries.set(root, summary);
+        return summary;
+    };
+    return (output, modelParameters, calls) => {
+        const completed = [];
+        const transitive = new Map();
+        const roots = (values) => {
+            const found = new Set(), visited = new WeakSet();
+            const visit = (value) => {
+                if (!objectValue(value) || visited.has(value))
+                    return;
+                visited.add(value);
+                let owned = false;
+                for (const call of completed)
+                    if (call.members.has(value)) {
+                        found.add(call.id);
+                        owned = true;
+                    }
+                if (!owned)
+                    for (const child of children(value, true))
+                        visit(child);
+            };
+            for (const value of values)
+                visit(value);
+            return found;
+        };
+        const allParameters = (direct, dependencies) => {
+            const parameters = new Set(direct);
+            for (const dependency of dependencies)
+                for (const parameter of transitive.get(dependency) ?? [])
+                    parameters.add(parameter);
+            return parameters;
+        };
+        const computations = calls.map((call) => {
+            const dependencies = roots(call.inputs);
+            const parameters = [...call.parameters.keys()]
+                .filter((key) => typeof key === "string")
+                .sort();
+            transitive.set(call.id, allParameters(parameters, dependencies));
+            if (objectValue(call.value))
+                completed.push({ id: call.id, members: summarize(call.value) });
+            return Object.freeze({
+                id: call.id,
+                parameters: Object.freeze(parameters),
+                computations: Object.freeze([...dependencies].sort()),
+            });
+        });
+        return Object.freeze({
+            modelParameters: Object.freeze([...modelParameters].sort()),
+            computations: Object.freeze(computations),
+            parts: Object.freeze(output.map((part) => {
+                const dependencies = roots([part.geometry, part.transform]);
+                return Object.freeze({
+                    id: part.id,
+                    computations: Object.freeze([...dependencies].sort()),
+                    parameters: Object.freeze([...allParameters([], dependencies)].sort()),
+                });
+            })),
+        });
+    };
+}