morphicons 0.1.0

package/dist/types-JAF3s76Y.d.ts

@@ -0,0 +1,60 @@
+//#region src/core/spring.d.ts
+declare class Spring {
+  x: number;
+  v: number;
+  k: number;
+  c: number;
+  config(k: number, c: number): void;
+  /** Starts (or restarts mid-flight) preserving velocity. */
+  start(): void;
+  /** Advances dt seconds. Returns true on settle (|1−x| < 0.001 ∧ |v| < 0.02). */
+  step(dt: number): boolean;
+}
+/** Spring presets (ζ = c/(2√k)) with the API's public names. */
+declare const SPRING_PRESETS: {
+  /** ζ = 1.00 — critically damped, no overshoot. */
+  readonly smooth: {
+    readonly k: 170;
+    readonly c: 26;
+  };
+  /** ζ = 0.73 — fast, subtle overshoot. */
+  readonly snappy: {
+    readonly k: 420;
+    readonly c: 30;
+  };
+  /** ζ = 0.40 — playful. */
+  readonly bouncy: {
+    readonly k: 300;
+    readonly c: 14;
+  };
+};
+type SpringPreset = keyof typeof SPRING_PRESETS;
+//#endregion
+//#region src/core/types.d.ts
+/** Attributes of an icon node (values as Lucide exports them: string or
+ *  number). `undefined` is allowed on purpose — lucide's SVGProps includes it
+ *  and the runtime treats an undefined attr as absent (fallback). */
+type IconNodeAttrs = Record<string, string | number | undefined>;
+/** Lucide-style icon data: a `[tag, attrs]` list. Structurally typed —
+ *  Lucide is neither a dependency nor a peer; Feather/Tabler/custom paths
+ *  work just the same. */
+type IconNode = ReadonlyArray<readonly [string, IconNodeAttrs]>;
+/** Input accepted by the core: an IconNode or a raw `d` attribute.
+ *  (SVGElement is resolved in the dom layer — the core never touches DOM.) */
+type IconInput = IconNode | string;
+/** Normalized subpath: a chain of cubics packed as points
+ *  [p0, c1, c2, p1, c1', c2', p2, …] → Float64Array of length 2·(3m+1),
+ *  with m = number of segments. Consecutive segments share an endpoint. */
+interface CubicPath {
+  pts: Float64Array;
+  closed: boolean;
+}
+/** Subpath sampled at N points by arc length + its topology. It is the
+ *  currency between resample and plan; an intermediate shape (interruption)
+ *  is also a list of Sampled. */
+interface Sampled {
+  pts: Float64Array;
+  closed: boolean;
+}
+//#endregion
+export { Sampled as a, SpringPreset as c, IconNodeAttrs as i, IconInput as n, SPRING_PRESETS as o, IconNode as r, Spring as s, CubicPath as t };

package/package.json

@@ -0,0 +1,106 @@
+{
+  "name": "morphicons",
+  "version": "0.1.0",
+  "description": "Universal morphing for stroke-based icons with spring physics — zero runtime dependencies",
+  "license": "MIT",
+  "author": "Guillermo (https://guillermolg.com)",
+  "homepage": "https://www.morphicons.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/guillermolg00/morphicons.git"
+  },
+  "bugs": "https://github.com/guillermolg00/morphicons/issues",
+  "keywords": [
+    "icons",
+    "svg",
+    "morphing",
+    "animation",
+    "spring",
+    "lucide",
+    "feather",
+    "tabler",
+    "react",
+    "icon-animation"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./dom": {
+      "types": "./dist/dom.d.ts",
+      "default": "./dist/dom.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "default": "./dist/react.js"
+    }
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "test": "bun test",
+    "typecheck": "tsc --noEmit && tsc -p playground --noEmit && tsc -p tsconfig.react.json --noEmit",
+    "play": "bun ./playground/index.html",
+    "lint": "biome check .",
+    "format": "biome check --write .",
+    "build": "tsdown",
+    "size": "size-limit",
+    "prepublishOnly": "bun run build"
+  },
+  "size-limit": [
+    {
+      "name": "core (gzip — anti-regression tripwire, see README)",
+      "path": "dist/index.js",
+      "import": "*",
+      "limit": "7 KB",
+      "gzip": true
+    },
+    {
+      "name": "core + dom (createMorph + scheduler)",
+      "path": "dist/dom.js",
+      "import": "*",
+      "limit": "7.5 KB",
+      "gzip": true
+    },
+    {
+      "name": "core + dom + react (MorphIcon, react external)",
+      "path": "dist/react.js",
+      "import": "*",
+      "ignore": [
+        "react"
+      ],
+      "limit": "8.5 KB",
+      "gzip": true
+    }
+  ],
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.6",
+    "@size-limit/preset-small-lib": "^13.0.3",
+    "@tabler/icons": "^3.46.0",
+    "@types/bun": "^1.3.14",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.4",
+    "feather-icons": "^4.29.2",
+    "lucide": "^1.28.0",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "size-limit": "^13.0.3",
+    "tsdown": "^0.22.14",
+    "typescript": "^7.0.2"
+  }
+}