@code3d/core 0.0.1-alpha.7 → 0.0.1-alpha.9

package/README.md

@@ -75,6 +75,19 @@ Build readable models from named intermediate values and public operations. A
 profile followed by extrusion, or solids combined with Boolean operations,
 keeps the construction understandable and editable by both people and agents.
 
+## Measure geometry for another part
+
+`distance(a, b, axis?)` measures models, finite topology, bounds or point anchors
+in their solved placement and returns a normal non-negative number. Omit the axis
+for shortest geometric distance; supply `x`, `y`, `z`, a direction vector or a
+straight edge/axis reference for the gap between projected intervals. Overlap
+returns zero. Existing relations are resolved on demand, before any group is
+needed; subsequent relations do not update the number.
+
+See the [measurement reference](../web/src/content/docs/docs/reference/core.md#measurements)
+and the [fitted beam example](../app/examples/operations/distance.ts). They cover
+finite geometry, nested occurrences, axis frames and source-order dependencies.
+
 ## Find the modeling API
 
 | Task                                                                            | Start here                                                                           |
@@ -114,7 +127,9 @@ including in mixed `Model[]` collections. Nesting preserves each group's hierarc
 `expose()` adds named references when callers need to address members.
 
 A topology ID belongs to its owning model and element kind. It is a number or a
-flat numeric path, such as `.edge([1, 3])`. Operations track unambiguous ancestry;
+flat numeric path, such as `.edge([1, 3])`. Local edits (`fillet`, `chamfer`, `shell`)
+preserve one-to-one IDs and allocate fresh IDs for new elements without reusing
+retired numbers. Loft, extrusion and Booleans prefix inherited IDs by input;
 transforms preserve complete paths. Inspect the result after topology changes
 instead of assuming IDs from a different model still apply.
 
@@ -296,3 +311,29 @@ npm test --workspace @code3d/core
 
 Use the [agent entry](../../docs/agents.md) to work on a project through the CLI,
 or the [App README](../app/README.md) to develop the editor and visualization.
+
+## Geometry measurements
+
+`model.bounds(relativeTo?)` returns readonly `minimum`, `maximum` and `size`
+XYZ vectors for tight finite geometry bounds. By default it uses the model's
+own local frame. An explicit reference includes solved placement and nested
+member occurrences in that reference's frame. Empty groups have no finite
+bounds; a source occurring more than once in the reference is ambiguous.
+
+`model.position(relativeTo)` returns the model origin in the explicit reference's
+local frame. A model's origin in its own frame is always `[0, 0, 0]`, including
+point models whose geometry may be offset from that origin. Neither query
+changes the model or its placement. These methods are available on every model
+kind, including groups. As model members, `bounds` and `position` are reserved
+names and cannot be used as exposed element names.
+
+```ts
+import {box, group, offset} from '@code3d/core';
+
+const base = box(20, 4, 20);
+const part = box(8, 12, 4).relate(self => [self.on(base.up), offset(20, 0, 0)]);
+const size = part.bounds().size; // [8, 12, 4]
+const origin = part.position(base); // [20, 8, 0]
+const minimum = part.bounds(base).minimum; // [16, 2, -2]
+export default group([base, part]);
+```

package/bld/chunks/{chunk-C3AJ6WNB.js → chunk-2NWM3BLX.js}

@@ -2,7 +2,7 @@ import {
   __name,
   castOwnedShape,
   primitiveConstructor
-} from "./chunk-4WLVDYUJ.js";
+} from "./chunk-OALDEU3F.js";
 
 // packages/core/src/library/replicad.ts
 import * as replicadModule from "replicad";
@@ -27,4 +27,4 @@ export {
   replicad,
   definePrimitive
 };
-//# sourceMappingURL=chunk-C3AJ6WNB.js.map
+//# sourceMappingURL=chunk-2NWM3BLX.js.map