@code3d/core 0.0.1-alpha.6 → 0.0.1-alpha.8

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.
 
@@ -194,10 +209,19 @@ Try [mounting-plate.ts](../app/examples/sketches/mounting-plate.ts).
 
 ## Cached computations and custom primitives
 
-`cached(fn, options?)` memoizes synchronous, deterministic data computations.
+`cache(fn)` memoizes synchronous, deterministic data computations;
+`cache(fn, args)` immediately returns the cached result for an argument tuple.
+Both forms share the same function identity and argument keys. Supply custom
+codecs in the third argument: `cache(fn, undefined, options)` for a function or
+`cache(fn, args, options)` for a value.
 Pass changing captured state as arguments and treat returned data as immutable.
 Memory hits reuse the retained result; optional `encoder` / `decoder` pairs only
-run when saving to disk or restoring it. The App fingerprints static definitions
+run when saving to disk or restoring it. Newly computed entries are eligible
+for disk storage when computation reaches the configured threshold (1 ms by
+default). Faster results remain in memory and are not encoded or written on later
+memory hits. Change the threshold in **Settings → Cache** in the App; it applies
+to new computations and preserves existing cache entries. Existing
+disk records can still be restored. The App fingerprints static definitions
 and their dependencies for persistent reuse; dynamic closures and ordinary Node
 calls use function identity for memory reuse. No author cache IDs are needed.
 
@@ -287,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-3RIMOCPP.js → chunk-EWPRWRLV.js}

@@ -2,7 +2,7 @@ import {
   __name,
   clearKernelOperationCache,
   setKernelNativeMemoryCounter
-} from "./chunk-T3RAUNSF.js";
+} from "./chunk-MICNLFBF.js";
 
 // packages/core/src/library/open-cascade.ts
 import { setOC } from "replicad";
@@ -16,4 +16,4 @@ __name(installOpenCascade, "installOpenCascade");
 export {
   installOpenCascade
 };
-//# sourceMappingURL=chunk-3RIMOCPP.js.map
+//# sourceMappingURL=chunk-EWPRWRLV.js.map

package/bld/chunks/{chunk-T6COR2SG.js → chunk-HSU2FH3L.js}

@@ -1,12 +1,12 @@
 import {
   installOpenCascade
-} from "./chunk-3RIMOCPP.js";
+} from "./chunk-EWPRWRLV.js";
 import {
   __name,
   installFontEngine,
   installModelResourceReader,
   installSketchSolver
-} from "./chunk-T3RAUNSF.js";
+} from "./chunk-MICNLFBF.js";
 
 // packages/core/src/node/index.ts
 import initOpenCascade from "@code3d/opencascade";
@@ -28,4 +28,4 @@ installSketchSolver(
     ), "locateFile")
   })
 );
-//# sourceMappingURL=chunk-T6COR2SG.js.map
+//# sourceMappingURL=chunk-HSU2FH3L.js.map