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

package/README.md

@@ -4,6 +4,12 @@ The TypeScript modeling runtime used by Code3D. Compose solids, profiles, curves
 points, and editable sketches; inspect their geometry and reuse the same models
 in the App or a supported Node.js runtime.
 
+Model constructors define the initial origin; derived operations inherit their main
+input frame. `group`, `union`, and `intersect` use the first member or operand,
+`cut` uses the stock, and `loft` uses the first section. See the
+[default origin rules](../web/src/content/docs/docs/concepts/local-coordinates.md#default-origin-rules)
+for all constructors and explicit origin operations.
+
 ## Start with a model
 
 ```sh
@@ -43,6 +49,28 @@ angles use degrees. Read [local coordinates](../web/src/content/docs/docs/concep
 and [relations](../web/src/content/docs/docs/guides/relations.mdx) before mixing
 origin changes, alignment, and rotation.
 
+Constraints express `on` and `align` only. Put relative `offset` and `rotate`
+transformations in the `relate` array after the constraints. Zero values add no
+centering or orientation condition; use point or axis alignment to center a part.
+The App's gizmos edit or insert independent array entries.
+
+Choose a
+center with `pivot([x,y,z])`, self topology with `pivotVertex(id)`/`axisEdge(id)`,
+or references with `pivotPoint(pointRef)`/`axisLine(lineRef)`; finish each selector
+with `rotate`. Point rotations retain self XYZ axes, including external centers. Consecutive constraints solve jointly; transformations
+then act on that result in order. A later constraint starts a new segment using
+the preceding pose. Independent offsets use fixed composition axes, and rotations
+default to self's current origin. Each completed transformation is one array item,
+for example `[offset(0, 8, 0), rotate(0, 25, 0)]`. Only pivot/axis selections
+chain into `rotate`; completed transformations cannot chain into another operation.
+Keep a selected reference while moving it with
+`pivotVertex(id).pivotOffset(dx, dy, dz).rotate(x, y, z)` or
+`axisLine(axis).axisOffset(dx, dy, dz).rotate(angle)`. Point offsets use self local
+axes; axis offsets use the selected axis frame and preserve its direction.
+Each selector accepts one matching offset, followed by `rotate`.
+See the [transformation example](../app/examples/constraints/transformations.ts)
+and [placement guide](../web/src/content/docs/docs/guides/relations.mdx#transform-a-joint-result).
+
 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.
@@ -65,7 +93,7 @@ Dimension-based primitives and numeric modeling methods retain required TypeScri
 signatures while providing runtime defaults for omitted or `undefined` values.
 Rotations and displacements default to zero, scaling to one, extrusion distance
 to ten, and fillet radius, chamfer distance and shell thickness to one. Relation
-rotation chains use the same angle defaults; `pivot()` defaults to local zero.
+rotation selectors use the same angle defaults; `pivot()` defaults to local zero.
 Explicit invalid values retain their normal errors. These defaults work in
 ordinary JavaScript execution as well as App previews.
 
@@ -142,7 +170,7 @@ const draft = sketch().relate(s => s.plane.align(host.surface(2)));
 ```
 
 The target may be a named plane or a planar `host.surface(id)`. The sketch plane
-normal is local `+Y`; alignment uses the same directed-plane, target-frame offset
+normal is local `+Y`; alignment uses the same directed-plane alignment, composition-axis offset
 and rotation semantics as model relations. It does not implicitly center the
 sketch on a trimmed surface. An unbounded sketch plane cannot use `on()` to place
 finite geometry against a bound; use `align()`. Topology-only pivots such as
@@ -162,7 +190,7 @@ of that geometry are not separate authoring definitions. Context outlines are
 visual references only, not snapping targets or imported geometry constraints.
 The select-surface-and-create UI is tracked separately within
 [#114](https://github.com/vilicvane/code3d/issues/114).
-Try [sketch-on-surface.ts](../app/examples/sketch-on-surface.ts).
+Try [mounting-plate.ts](../app/examples/sketches/mounting-plate.ts).
 
 ## Cached computations and custom primitives
 

package/bld/chunks/{chunk-U5G2VU2I.js → chunk-3RIMOCPP.js}

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

package/bld/chunks/{chunk-P5VGKAEM.js → chunk-KYW4AWKO.js}

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