@layoutit/polycss 0.2.9 → 0.2.11

package/README.md

@@ -21,6 +21,9 @@ npm install @layoutit/polycss-react
 # Vue
 npm install @layoutit/polycss-vue
 
+# Morph
+npm install @layoutit/polycss-morph
+
 ```
 
 You can also load PolyCSS directly from a CDN. Here is a minimal custom-element scene:
@@ -153,14 +156,12 @@ const html = await exportPolySceneSnapshot(scene.host);
 
 If any referenced asset cannot be inlined, the function throws `PolySceneSnapshotError` with `code: "ASSET_INLINE_FAILED"`.
 
-### Prepared retained models
+### PolyCSS Morph
 
-The source tree includes `@layoutit/polycss-morph`, an imperative,
-framework-agnostic package for models prepared ahead of time and updated through
-one retained PolyCSS DOM graph. Version `0.0.1` is qualified for publication;
-this documentation does not announce npm registry availability.
+Use `@layoutit/polycss-morph` for models built ahead of time and updated through
+a stable PolyCSS DOM graph.
 
-Preparation is explicitly Node-only:
+Preparation runs in Node:
 
 ```ts
 import { preparePolyMorphModel } from "@layoutit/polycss-morph/prepare";
@@ -201,13 +202,16 @@ updates do not rebuild topology or redraw prepared image resources.
 Prepared playback uses a two-phase sample: apply `sample.update`, then call
 `runtime.commit(sample)` only after the retained mount accepts the update.
 
-Prepared solid triangles use the native CSS triangle primitive when supported.
-Preparation also emits packed alpha-atlas pages for WebKit/Safari and other
-browsers without a supported CSS triangle primitive. Every polygon receives a
-slice sized to its local-2D bounding rect. Mount creates object URLs from the
+Morph chooses the triangle paint path once when it mounts. It uses
+`corner-shape` where available, a larger CSS border triangle in Firefox, and
+prepared alpha-atlas pages in WebKit/Safari. Every polygon receives a slice
+sized to its local-2D bounding rect. Mount creates object URLs from the
 already-verified package bytes, selects the fallback once, and revokes those
 URLs at teardown; it never refetches, generates, or redraws the atlas.
 
+See the [PolyCSS Morph guide](https://polycss.com/guides/morph/), including the
+interactive cube-to-sphere example.
+
 ### Polygon Data Model
 
 Each polygon describes one renderable face:
@@ -288,7 +292,7 @@ Each visible polygon is emitted as one leaf element; the renderer chooses the le
 | `@layoutit/polycss` | Vanilla custom elements and imperative `createPolyScene` API. |
 | `@layoutit/polycss-react` | React components, hooks, controls, and core re-exports. |
 | `@layoutit/polycss-vue` | Vue 3 components, composables, controls, and core re-exports. |
-| `@layoutit/polycss-morph` | Prepared retained-model contracts, Node preparation, browser loading, sparse deformation, controls, springs, animation, skinning, and playback. |
+| `@layoutit/polycss-morph` | Prepared-model loading, retained DOM animation, morph targets, skinning, and playback. |
 
 ## Made with PolyCSS
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@layoutit/polycss",
-  "version": "0.2.9",
+  "version": "0.2.11",
   "description": "PolyCSS vanilla / custom-elements + imperative API. Renders OBJ / STL / glTF / GLB mesh polygons as DOM via CSS matrix3d.",
   "type": "module",
   "main": "dist/index.cjs",
@@ -62,7 +62,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@layoutit/polycss-core": "^0.2.9"
+    "@layoutit/polycss-core": "^0.2.11"
   },
   "devDependencies": {
     "tsup": "^8.0.1",