morphicons 1.4.0 → 1.4.1

package/README.md

@@ -13,7 +13,14 @@
   <a href="https://www.morphicons.com"><strong>morphicons.com</strong></a> — live playground
 </p>
 
-Universal morphing for stroke-based icons (Lucide, Tabler, Heroicons, Iconoir, or your own paths): **any icon morphs into any other** with spring physics. Rotations are never declared by hand — they emerge from the math (2D Procrustes + polar interpolation). Zero runtime dependencies.
+<p align="center">
+  <a href="https://github.com/sponsors/guillermolg00">
+    <img src="https://img.shields.io/badge/%E2%98%95%20Buy%20me%20a%20coffee-EA4AAA" alt="Buy me a coffee — sponsor morphicons on GitHub Sponsors">
+  </a>
+</p>
+
+Universal morphing for stroke-based icons (Lucide, Tab
+ler, Heroicons, Iconoir, or your own paths): **any icon morphs into any other** with spring physics. Rotations are never declared by hand — they emerge from the math (2D Procrustes + polar interpolation). Zero runtime dependencies.
 
 ```tsx
 import { MorphIcon } from "morphicons/react";
@@ -312,7 +319,7 @@ c_k(t) = c_{A,k} + t·d_k + (σ*ᵗ·R(t·θ*) − I)·(c_{A,k} − g_A)
 
 ### 6. Serialization and canonical snap
 
-In flight, each subpath is emitted as `M x y L x y …` (+ `Z` if the pair is closed↔closed; closed→open flies open, the loop opening at the cut chosen by the circular correspondence) with 2 decimals — invisible at 24px, and the frame's only allocation. On settle, the driver **snaps to the canonical `d`** of the target icon: exact fidelity at rest (real curves, not polylines), subpath count reset after duplications, and the DOM ends up identical to a static icon's. The jump is < 0.02px — imperceptible.
+In flight, each subpath is emitted as `M x y L x y …` (+ `Z` if the pair is closed↔closed; closed→open flies open, the loop opening at the cut chosen by the circular correspondence) with 2 decimals — invisible at 24px, and the frame's only allocation. On settle, the driver **snaps to the canonical `d`** of the target icon: exact fidelity at rest (real curves, not polylines), subpath count reset after duplications, and the DOM ends up identical to a static icon's. The jump is < 0.02px — imperceptible. The canonical `d` itself is emitted with 4 decimals, and that is a correctness choice, not a size one: arc→cubic conversion goes through trig whose last ulp differs across JS engines, and SSR hydration compares the server's bytes against the browser's — quantized emission keeps them identical, where full precision leaked each engine's ulp into the markup (a Next hydration mismatch on icons with non-cardinal arcs).
 
 ### 7. The spring
 

package/dist/dom.d.ts

@@ -27,8 +27,9 @@ interface Morph {
   destroy(): void;
 }
 /** Canonical `d` of an icon: the input string verbatim, or the real cubics
- *  at full precision (the at-rest snap). Exported because it is what a
- *  binding renders at SSR/rest before any runtime exists. */
+ *  quantized to 4 decimals (the at-rest snap; engine-stable bytes so SSR
+ *  hydration matches, see fmtCanon in core/serialize). Exported because it
+ *  is what a binding renders at SSR/rest before any runtime exists. */
 declare function canonicalD(icon: IconInput): string;
 /** Creates the morph instance over a `<path>` and paints the initial icon. */
 declare function createMorph(el: PathEl, icon: IconInput): Morph;

package/dist/dom.js

@@ -1,4 +1,4 @@
-import { a as buildPlan, c as cubicsToPathD, f as interpPolar, l as serialize, n as Spring, r as resampleIcon, s as iconToCubics, t as SPRING_PRESETS, u as allocOutputs } from "./spring-BTcHiHR5.js";
+import { a as buildPlan, c as cubicsToPathD, f as interpPolar, l as serialize, n as Spring, r as resampleIcon, s as iconToCubics, t as SPRING_PRESETS, u as allocOutputs } from "./spring-CBynweFS.js";
 //#region src/dom/index.ts
 const tickers = /* @__PURE__ */ new Set();
 let rafId = 0;
@@ -41,8 +41,9 @@ function sampledOf(icon) {
 	return s;
 }
 /** Canonical `d` of an icon: the input string verbatim, or the real cubics
-*  at full precision (the at-rest snap). Exported because it is what a
-*  binding renders at SSR/rest before any runtime exists. */
+*  quantized to 4 decimals (the at-rest snap; engine-stable bytes so SSR
+*  hydration matches, see fmtCanon in core/serialize). Exported because it
+*  is what a binding renders at SSR/rest before any runtime exists. */
 function canonicalD(icon) {
 	if (typeof icon === "string") return icon;
 	let d = canon.get(icon);

package/dist/index.d.ts

@@ -72,7 +72,8 @@ declare function resampleIcon(input: IconInput, N?: number): Sampled[];
 /** Sampled subpaths → polyline `d` attribute. `closed[k]` appends Z to
  *  subpath k (closed loops in flight); without flags everything is open. */
 declare function serialize(subs: readonly Float64Array[], closed?: readonly boolean[]): string;
-/** Cubic subpaths → canonical `d` at full precision (round-trip). */
+/** Cubic subpaths → canonical `d`, quantized to 4 decimals (engine-stable
+ *  bytes; see fmtCanon). */
 declare function cubicsToPathD(paths: readonly CubicPath[]): string;
 //#endregion
 export { type CubicPath, type IconInput, type IconNode, type IconNodeAttrs, type MorphPlan, type PlanItem, SPRING_PRESETS, type Sampled, Spring, type SpringPreset, type ViewBox, allocOutputs, buildPlan, cubicsToPathD, fitIcon, iconToCubics, interpLinear, interpPolar, resampleIcon, resamplePath, serialize };

package/dist/index.js

@@ -1,2 +1,2 @@
-import { a as buildPlan, c as cubicsToPathD, d as interpLinear, f as interpPolar, i as resamplePath, l as serialize, n as Spring, o as fitIcon, r as resampleIcon, s as iconToCubics, t as SPRING_PRESETS, u as allocOutputs } from "./spring-BTcHiHR5.js";
+import { a as buildPlan, c as cubicsToPathD, d as interpLinear, f as interpPolar, i as resamplePath, l as serialize, n as Spring, o as fitIcon, r as resampleIcon, s as iconToCubics, t as SPRING_PRESETS, u as allocOutputs } from "./spring-CBynweFS.js";
 export { SPRING_PRESETS, Spring, allocOutputs, buildPlan, cubicsToPathD, fitIcon, iconToCubics, interpLinear, interpPolar, resampleIcon, resamplePath, serialize };

package/dist/react-native.js

@@ -1,4 +1,4 @@
-import { a as buildPlan, f as interpPolar, l as serialize, r as resampleIcon, u as allocOutputs } from "./spring-BTcHiHR5.js";
+import { a as buildPlan, f as interpPolar, l as serialize, r as resampleIcon, u as allocOutputs } from "./spring-CBynweFS.js";
 import { canonicalD, createMorph } from "./dom.js";
 import { forwardRef, useCallback, useEffect, useImperativeHandle, useLayoutEffect, useRef, useState } from "react";
 import { jsx } from "react/jsx-runtime";

package/dist/react.js

@@ -1,4 +1,4 @@
-import { a as buildPlan, f as interpPolar, l as serialize, r as resampleIcon, u as allocOutputs } from "./spring-BTcHiHR5.js";
+import { a as buildPlan, f as interpPolar, l as serialize, r as resampleIcon, u as allocOutputs } from "./spring-CBynweFS.js";
 import { canonicalD, createMorph } from "./dom.js";
 import { forwardRef, useCallback, useEffect, useImperativeHandle, useLayoutEffect, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";

package/dist/{spring-BTcHiHR5.js → spring-CBynweFS.js}

@@ -305,12 +305,16 @@ function serialize(subs, closed) {
 	}
 	return d;
 }
-/** Cubic subpaths → canonical `d` at full precision (round-trip). */
+function fmtCanon(v) {
+	return String(Math.round(v * 1e4) / 1e4);
+}
+/** Cubic subpaths → canonical `d`, quantized to 4 decimals (engine-stable
+*  bytes; see fmtCanon). */
 function cubicsToPathD(paths) {
 	let d = "";
 	for (const { pts, closed } of paths) {
-		d += `M${pts[0]} ${pts[1]}`;
-		for (let i = 2; i < pts.length; i += 6) d += `C${pts[i]} ${pts[i + 1]} ${pts[i + 2]} ${pts[i + 3]} ${pts[i + 4]} ${pts[i + 5]}`;
+		d += `M${fmtCanon(pts[0])} ${fmtCanon(pts[1])}`;
+		for (let i = 2; i < pts.length; i += 6) d += `C${fmtCanon(pts[i])} ${fmtCanon(pts[i + 1])} ${fmtCanon(pts[i + 2])} ${fmtCanon(pts[i + 3])} ${fmtCanon(pts[i + 4])} ${fmtCanon(pts[i + 5])}`;
 		if (closed) d += "Z";
 	}
 	return d;

package/dist/svelte-shared.js

@@ -1,4 +1,4 @@
-import { a as buildPlan, f as interpPolar, l as serialize, r as resampleIcon, u as allocOutputs } from "./spring-BTcHiHR5.js";
+import { a as buildPlan, f as interpPolar, l as serialize, r as resampleIcon, u as allocOutputs } from "./spring-CBynweFS.js";
 import { canonicalD, createMorph } from "./dom.js";
 //#region src/svelte/shared.ts
 /** Frozen shape of the from→to pair at t, using the pure core (SSR-safe).

package/dist/vue.js

@@ -1,4 +1,4 @@
-import { a as buildPlan, f as interpPolar, l as serialize, r as resampleIcon, u as allocOutputs } from "./spring-BTcHiHR5.js";
+import { a as buildPlan, f as interpPolar, l as serialize, r as resampleIcon, u as allocOutputs } from "./spring-CBynweFS.js";
 import { canonicalD, createMorph } from "./dom.js";
 import { defineComponent, h, onBeforeUnmount, onMounted, shallowRef, watch } from "vue";
 //#region src/vue/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "morphicons",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "Universal morphing for stroke-based icons with spring physics — zero runtime dependencies",
   "license": "MIT",
   "author": "Guillermo (https://guillermolg.com)",