partforge 0.168.0 → 0.169.1

package/README.md

@@ -198,16 +198,27 @@ second>` (a model with no playing animation turns until the first camera grab,
 never under `prefers-reduced-motion`), `fill: 0.8` (frame the model so its
 bounding box, as seen from the opening view, spans that fraction of the preview
 along its tighter axis — larger in a small card; with a turntable the model swept
-a full turn is framed, so it never clips as it turns and a round part still fills; the model is
-centred on its geometry, so a lopsided part turns about its hub), `camera: "default"` (drop the carried camera
+a full turn is framed, so it never clips as it turns and a round part still fills, and it
+turns about its hub; a model that is not turning has its on-screen outline centred, since 0.169.0), `camera: "default"` (drop the carried camera
 and projection and keep the file's own framing; a carried render mode and
 environment still apply) and `renderMode: "cad" | "realistic"` (the opening
-mode, over any carried one; it can change afterwards). An unknown option key
+mode, over any carried one; it can change afterwards), and `autostart: false`
+(0.169.0+: the animation or turntable waits at its first frame until
+`handle.motion.start()`). An unknown option key
 throws. A baked animation always plays as authored — it
 loops, or plays once and holds its end pose. Every handle carries `drawn`, which
 resolves after the first frame showing the meshes, so a host can cross-fade from
 a still image.
 
+`handle.motion` (0.169.0+; `null` before `ready` and once disposed) drives that
+motion: `start()` begins a waiting one (idempotent), `restart()` puts the model
+back as it opened — the opening camera framing, the animation from its start or
+the turntable turning again — and starts it, `state` is `"waiting"`,
+`"playing"`, `"stopped"` (a drag stopped the turntable, or nothing moves) or
+`"finished"` (a play-once animation ended), and `onChange(cb)` hears each change.
+Under `prefers-reduced-motion` nothing moves and `restart()` only resets the
+camera; a turntable mount is framed for its full turn either way.
+
 ```js
 const glb = await runtime.exportPreview();               // Uint8Array: the view on screen
 mount(part, { createWorker, elements, preview: glb });   // drawn at once, replaced by the build
@@ -218,6 +229,8 @@ const card = mountPreview(cardStage, {                   // a landing-page card
   zoom: false, pan: false, turntable: 14, fill: 0.8, camera: "default", renderMode: "cad",
 });
 await card.drawn;                                        // the first frame is on the canvas
+// With autostart: false the card waits at that frame: fade it in, then
+// card.motion.start(); a "replay" button calls card.motion.restart().
 ```
 
 Every `elements` entry defaults to the legacy global ID (`#app`, `#controls`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "partforge",
-  "version": "0.168.0",
+  "version": "0.169.1",
   "description": "Turn a declarative part definition into a parametric-CAD web app (three.js + Manifold/Replicad). Requires a Vite-based consumer.",
   "type": "module",
   "license": "MIT",
@@ -149,7 +149,7 @@
     "@monogrid/gainmap-js": "^3.4.0",
     "eslint": "^10.10.0",
     "globals": "^17.12.0",
-    "happy-dom": "^20.10.6",
+    "happy-dom": "^21.0.4",
     "knip": "^6.35.1",
     "playwright": "^1.49.0",
     "sharp": "^0.35.4",