@vielzeug/necromancer 2.1.0 → 3.0.0

package/dist/types.d.ts

@@ -14,12 +14,12 @@ export type Keyframes = readonly Keyframe[] | PropertyIndexedKeyframes;
 /**
  * Native Web Animations timing options with Necromancer's ownership controls.
  *
- * `duration` defaults to `180` milliseconds. `motion` defaults to `'system'`.
- * `signal` disposes the returned handle when aborted.
+ * `motion` defaults to `'system'`. `signal` disposes the returned handle when aborted.
  *
  * Deliberately extends native `KeyframeAnimationOptions` in full rather than a narrower,
  * Necromancer-specific timing type: every native field (`easing`, `fill`, `iterations`, a
- * string `delay`/`duration`, etc.) reaches `element.animate()` unchanged. Callers already
+ * string `delay`/`duration`, etc.) reaches `element.animate()` unchanged unless reduced motion
+ * normalizes timing. Callers already
  * fluent in the Web Animations API bring that knowledge here directly, instead of learning
  * a second, smaller timing vocabulary — the option chain below only ever *adds* ownership
  * fields on top, never narrows what's already native.
@@ -27,36 +27,31 @@ export type Keyframes = readonly Keyframe[] | PropertyIndexedKeyframes;
  * Option chain: `AnimateOptions` -> `AnimateEachOptions` (+`stagger`) -> `LayoutAnimationOptions`
  * (+`elements`). Each layer's implementation module strips only the field it added before
  * forwarding the rest down (see `animate-each.ts`, `layout.ts`, and `_motion.ts`'s
- * `resolveAnimationOptions()`, which is the last stop and strips `interrupt`/`motion`/`signal`).
+ * `resolveAnimationOptions()`, which is the last stop and strips `motion`/`signal`).
  */
 export type AnimateOptions = KeyframeAnimationOptions & {
-    /**
-     * Cancels every active Necromancer-owned animation on the element as this
-     * animation begins. Native animations owned outside Necromancer are untouched.
-     */
-    readonly interrupt?: 'cancel';
     readonly motion?: MotionMode;
     readonly signal?: AbortSignal;
 };
 /** Produces keyframes for an element at a stable position in an animation group. */
-export type KeyframeFactory = (element: Element, index: number, total: number) => Keyframes;
+export type KeyframeFactory<ElementType extends Element = Element> = (element: ElementType, index: number, total: number) => Keyframes;
 /** Options for animating a group of elements. */
 export type AnimateEachOptions = AnimateOptions & {
     /** Milliseconds to delay each element after the preceding element. Defaults to `0`. */
     readonly stagger?: number;
 };
 /** Options for animating positional layout changes captured by {@link captureLayout}. */
-export type LayoutAnimationOptions = AnimateEachOptions & {
+export type LayoutAnimationOptions<ElementType extends Element = Element> = AnimateEachOptions & {
     /**
      * Elements in their committed layout. With {@link LayoutCaptureOptions.getKey},
      * replacement elements match their captured predecessors by key.
      */
-    readonly elements?: Iterable<Element>;
+    readonly elements?: Iterable<ElementType>;
 };
 /** Options for capturing positional layout changes. */
-export interface LayoutCaptureOptions {
+export interface LayoutCaptureOptions<ElementType extends Element = Element> {
     /** Maps an element to its stable, non-empty identity across a DOM replacement. */
-    readonly getKey?: (element: Element) => string;
+    readonly getKey?: (element: ElementType) => string;
 }
 /** A lifecycle-owned native Web Animation. */
 export interface AnimationHandle {
@@ -85,13 +80,13 @@ export interface AnimationGroup {
     [Symbol.dispose](): void;
 }
 /** A one-shot positional layout transition returned by {@link captureLayout}. */
-export interface LayoutTransition {
+export interface LayoutTransition<ElementType extends Element = Element> {
     /**
      * Measures the current layout and animates elements from their captured positions.
      *
      * Omit `options.elements` to animate the captured elements, or supply the
      * committed replacements when the transition was captured with `getKey`.
      */
-    animate(options?: LayoutAnimationOptions): AnimationGroup;
+    animate(options?: LayoutAnimationOptions<ElementType>): AnimationGroup;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEvD,0DAA0D;AAC1D,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GAC/B;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GAC9B;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC;AAEhE,oDAAoD;AACpD,MAAM,MAAM,SAAS,GAAG,SAAS,QAAQ,EAAE,GAAG,wBAAwB,CAAC;AAEvE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,cAAc,GAAG,wBAAwB,GAAG;IACtD;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B,CAAC;AAEF,oFAAoF;AACpF,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;AAE5F,iDAAiD;AACjD,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG;IAChD,uFAAuF;IACvF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,yFAAyF;AACzF,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,GAAG;IACxD;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;CACvC,CAAC;AAEF,uDAAuD;AACvD,MAAM,WAAW,oBAAoB;IACnC,kFAAkF;IAClF,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;CAChD;AAED,8CAA8C;AAC9C,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,iEAAiE;IACjE,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAC1C,6BAA6B;IAC7B,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;CAC1B;AAED,kDAAkD;AAClD,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAAC;IACtD,6BAA6B;IAC7B,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;CAC1B;AAED,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,cAAc,CAAC;CAC3D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEvD,0DAA0D;AAC1D,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GAC/B;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GAC9B;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC;AAEhE,oDAAoD;AACpD,MAAM,MAAM,SAAS,GAAG,SAAS,QAAQ,EAAE,GAAG,wBAAwB,CAAC;AAEvE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,cAAc,GAAG,wBAAwB,GAAG;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B,CAAC;AAEF,oFAAoF;AACpF,MAAM,MAAM,eAAe,CAAC,WAAW,SAAS,OAAO,GAAG,OAAO,IAAI,CACnE,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,KACV,SAAS,CAAC;AAEf,iDAAiD;AACjD,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG;IAChD,uFAAuF;IACvF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,yFAAyF;AACzF,MAAM,MAAM,sBAAsB,CAAC,WAAW,SAAS,OAAO,GAAG,OAAO,IAAI,kBAAkB,GAAG;IAC/F;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;CAC3C,CAAC;AAEF,uDAAuD;AACvD,MAAM,WAAW,oBAAoB,CAAC,WAAW,SAAS,OAAO,GAAG,OAAO;IACzE,kFAAkF;IAClF,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,MAAM,CAAC;CACpD;AAED,8CAA8C;AAC9C,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,iEAAiE;IACjE,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAC1C,6BAA6B;IAC7B,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;CAC1B;AAED,kDAAkD;AAClD,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAAC;IACtD,6BAA6B;IAC7B,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;CAC1B;AAED,iFAAiF;AACjF,MAAM,WAAW,gBAAgB,CAAC,WAAW,SAAS,OAAO,GAAG,OAAO;IACrE;;;;;OAKG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,sBAAsB,CAAC,WAAW,CAAC,GAAG,cAAc,CAAC;CACxE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vielzeug/necromancer",
-  "version": "2.1.0",
+  "version": "3.0.0",
   "description": "Dependency-free, lifecycle-owned animation primitives built on the Web Animations API",
   "repository": {
     "type": "git",
@@ -42,21 +42,22 @@
     "registry": "https://registry.npmjs.org/"
   },
   "scripts": {
-    "build": "vite build && pnpm run build:bundle && pnpm run build:types",
+    "build": "vite build && pnpm --silent run build:bundle && pnpm --silent run build:types && pnpm --silent run test:types",
     "build:bundle": "vite build --config vite.bundle.config.ts",
     "build:types": "tsc -p tsconfig.declarations.json",
     "fix": "biome check --write src",
     "lint": "biome ci src",
-    "prepublishOnly": "pnpm run build",
+    "prepublishOnly": "pnpm --silent run build",
     "test": "vitest",
-    "test:e2e": "pnpm run build && playwright test"
+    "test:e2e": "pnpm --silent run build && playwright test",
+    "test:types": "tsc -p tsconfig.type-tests.json"
   },
   "devDependencies": {
-    "@playwright/test": "^1.62.1",
-    "@types/node": "^26.2.0",
+    "@playwright/test": "^1.63.0",
+    "@types/node": "^26.4.1",
     "jsdom": "^30.0.1",
     "typescript": "^6.0.3",
-    "vite": "^8.2.1",
-    "vitest": "^4.1.10"
+    "vite": "^8.2.2",
+    "vitest": "^5.0.0"
   }
 }

package/dist/_active.cjs

@@ -1,2 +0,0 @@
-var e=new WeakMap;function t(t){for(let n of e.get(t)??[])n.dispose()}function n(t,n){let r=e.get(t);r||(r=new Set,e.set(t,r)),r.add(n),n.result.then(()=>{r?.delete(n),r?.size===0&&e.delete(t)})}exports.interruptAnimations=t,exports.trackAnimation=n;
-//# sourceMappingURL=_active.cjs.map

package/dist/_active.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"_active.cjs","names":[],"sources":["../src/_active.ts"],"sourcesContent":["import type { AnimationHandle } from './types';\n\n// Scoped to one DOM element by design: `interrupt: 'cancel'` answers \"replace whatever\n// Necromancer is doing to *this* element\", not \"coordinate across element categories\".\n// A caller that needs to cancel an animation on a different element (or coordinate several\n// elements as one unit) already has that element's own handle, or should use `animateEach()`\n// and a shared `signal` instead. Keeping the WeakMap element-scoped means it only ever needs\n// to answer one question and never grows into a general-purpose animation registry.\nconst handlesByElement = new WeakMap<Element, Set<AnimationHandle>>();\n\n/** Cancels active Necromancer-owned animations without touching native animations owned by callers. */\nexport function interruptAnimations(element: Element): void {\n  for (const handle of handlesByElement.get(element) ?? []) handle.dispose();\n}\n\n/** Tracks a handle until its terminal result releases the element association. */\nexport function trackAnimation(element: Element, handle: AnimationHandle): void {\n  let handles = handlesByElement.get(element);\n\n  if (!handles) {\n    handles = new Set();\n    handlesByElement.set(element, handles);\n  }\n\n  handles.add(handle);\n\n  void handle.result.then(() => {\n    handles?.delete(handle);\n\n    if (handles?.size === 0) handlesByElement.delete(element);\n  });\n}\n"],"mappings":"AAQA,IAAM,EAAmB,IAAI,QAG7B,SAAgB,EAAoB,EAAwB,CAC1D,IAAK,IAAM,KAAU,EAAiB,IAAI,CAAO,GAAK,CAAC,EAAG,EAAO,QAAQ,CAC3E,CAGA,SAAgB,EAAe,EAAkB,EAA+B,CAC9E,IAAI,EAAU,EAAiB,IAAI,CAAO,EAErC,IACH,EAAU,IAAI,IACd,EAAiB,IAAI,EAAS,CAAO,GAGvC,EAAQ,IAAI,CAAM,EAElB,EAAY,OAAO,SAAW,CAC5B,GAAS,OAAO,CAAM,EAElB,GAAS,OAAS,GAAG,EAAiB,OAAO,CAAO,CAC1D,CAAC,CACH"}

package/dist/_active.d.ts

@@ -1,6 +0,0 @@
-import type { AnimationHandle } from './types';
-/** Cancels active Necromancer-owned animations without touching native animations owned by callers. */
-export declare function interruptAnimations(element: Element): void;
-/** Tracks a handle until its terminal result releases the element association. */
-export declare function trackAnimation(element: Element, handle: AnimationHandle): void;
-//# sourceMappingURL=_active.d.ts.map

package/dist/_active.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"_active.d.ts","sourceRoot":"","sources":["../src/_active.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAU/C,uGAAuG;AACvG,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAE1D;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAe9E"}

package/dist/_active.js

@@ -1,15 +0,0 @@
-//#region src/_active.ts
-var e = /* @__PURE__ */ new WeakMap();
-function t(t) {
-	for (let n of e.get(t) ?? []) n.dispose();
-}
-function n(t, n) {
-	let r = e.get(t);
-	r || (r = /* @__PURE__ */ new Set(), e.set(t, r)), r.add(n), n.result.then(() => {
-		r?.delete(n), r?.size === 0 && e.delete(t);
-	});
-}
-//#endregion
-export { t as interruptAnimations, n as trackAnimation };
-
-//# sourceMappingURL=_active.js.map

package/dist/_active.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"_active.js","names":[],"sources":["../src/_active.ts"],"sourcesContent":["import type { AnimationHandle } from './types';\n\n// Scoped to one DOM element by design: `interrupt: 'cancel'` answers \"replace whatever\n// Necromancer is doing to *this* element\", not \"coordinate across element categories\".\n// A caller that needs to cancel an animation on a different element (or coordinate several\n// elements as one unit) already has that element's own handle, or should use `animateEach()`\n// and a shared `signal` instead. Keeping the WeakMap element-scoped means it only ever needs\n// to answer one question and never grows into a general-purpose animation registry.\nconst handlesByElement = new WeakMap<Element, Set<AnimationHandle>>();\n\n/** Cancels active Necromancer-owned animations without touching native animations owned by callers. */\nexport function interruptAnimations(element: Element): void {\n  for (const handle of handlesByElement.get(element) ?? []) handle.dispose();\n}\n\n/** Tracks a handle until its terminal result releases the element association. */\nexport function trackAnimation(element: Element, handle: AnimationHandle): void {\n  let handles = handlesByElement.get(element);\n\n  if (!handles) {\n    handles = new Set();\n    handlesByElement.set(element, handles);\n  }\n\n  handles.add(handle);\n\n  void handle.result.then(() => {\n    handles?.delete(handle);\n\n    if (handles?.size === 0) handlesByElement.delete(element);\n  });\n}\n"],"mappings":";AAQA,IAAM,oBAAmB,IAAI,QAAuC;AAGpE,SAAgB,EAAoB,GAAwB;CAC1D,KAAK,IAAM,KAAU,EAAiB,IAAI,CAAO,KAAK,CAAC,GAAG,EAAO,QAAQ;AAC3E;AAGA,SAAgB,EAAe,GAAkB,GAA+B;CAC9E,IAAI,IAAU,EAAiB,IAAI,CAAO;CAS1C,AAPK,MACH,oBAAU,IAAI,IAAI,GAClB,EAAiB,IAAI,GAAS,CAAO,IAGvC,EAAQ,IAAI,CAAM,GAElB,EAAY,OAAO,WAAW;EAG5B,AAFA,GAAS,OAAO,CAAM,GAElB,GAAS,SAAS,KAAG,EAAiB,OAAO,CAAO;CAC1D,CAAC;AACH"}