@vielzeug/necromancer 3.0.0 → 26.10.1

package/dist/testing.js

@@ -1,49 +1,2 @@
-//#region src/testing/index.ts
-var e = class {
-	#e;
-	#t;
-	cancelCallCount = 0;
-	finishCallCount = 0;
-	finished;
-	constructor() {
-		this.finished = new Promise((e, t) => {
-			this.#t = e, this.#e = t;
-		});
-	}
-	cancel = () => {
-		this.cancelCallCount += 1, this.#e(new DOMException("The animation was canceled.", "AbortError"));
-	};
-	finish = () => {
-		this.finishCallCount += 1, this.#t();
-	};
-};
-function t() {
-	let t = [], n = Object.getOwnPropertyDescriptor(Element.prototype, "animate"), r = !1;
-	Object.defineProperty(Element.prototype, "animate", {
-		configurable: !0,
-		value: (n, r) => {
-			let i = new e();
-			return t.push({
-				animation: i,
-				keyframes: n,
-				options: r
-			}), i;
-		},
-		writable: !0
-	});
-	let i = () => {
-		r || (r = !0, n ? Object.defineProperty(Element.prototype, "animate", n) : Reflect.deleteProperty(Element.prototype, "animate"));
-	};
-	return {
-		calls: t,
-		restore: i,
-		[Symbol.dispose]: i
-	};
-}
-function n(e, t, n = 20, r = 20) {
-	return new DOMRect(e, t, n, r);
-}
-//#endregion
-export { e as FakeAnimation, n as createRect, t as installFakeAnimations };
-
+var FakeAnimation=class{#e;#t;cancelCallCount=0;finishCallCount=0;finished;constructor(){this.finished=new Promise((e,t)=>{this.#t=e,this.#e=t})}cancel=()=>{this.cancelCallCount+=1,this.#e(new DOMException(`The animation was canceled.`,`AbortError`))};finish=()=>{this.finishCallCount+=1,this.#t()}};function installFakeAnimations(){let e=[],t=Object.getOwnPropertyDescriptor(Element.prototype,`animate`),n=!1;Object.defineProperty(Element.prototype,"animate",{configurable:!0,value:(t,n)=>{let r=new FakeAnimation;return e.push({animation:r,keyframes:t,options:n}),r},writable:!0});let restore=()=>{n||(n=!0,t?Object.defineProperty(Element.prototype,"animate",t):Reflect.deleteProperty(Element.prototype,`animate`))};return{calls:e,restore,[Symbol.dispose]:restore}}function createRect(e,t,n=20,r=20){return new DOMRect(e,t,n,r)}export{FakeAnimation,createRect,installFakeAnimations};
 //# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -1 +1 @@
-{"version":3,"file":"testing.js","names":[],"sources":["../src/testing/index.ts"],"sourcesContent":["/**\n * Testing utilities for code that calls Necromancer's animation functions.\n *\n * jsdom (and most non-browser DOM environments) do not implement `Element.animate()`,\n * so any test that exercises `animate()`, `animateEach()`, or `captureLayout()` needs a\n * substitute. This module has no test-runner import — it works the same under Vitest,\n * Jest, or any other runner; use your runner's own spy/mock APIs on top if needed.\n */\n\nexport type AnimationCall = {\n  readonly animation: FakeAnimation;\n  readonly keyframes: Keyframe[] | PropertyIndexedKeyframes;\n  readonly options?: KeyframeAnimationOptions;\n};\n\n/** A minimal `Animation` stand-in. Call `finish()`/`cancel()` to settle it like the real API would. */\nexport class FakeAnimation {\n  #reject!: (reason?: unknown) => void;\n  #resolve!: () => void;\n\n  /** Number of times `cancel()` has been called. */\n  cancelCallCount = 0;\n  /** Number of times `finish()` has been called. */\n  finishCallCount = 0;\n  /** Mirrors the native `Animation.finished` promise. */\n  finished: Promise<void>;\n\n  constructor() {\n    this.finished = new Promise<void>((resolve, reject) => {\n      this.#resolve = resolve;\n      this.#reject = reject;\n    });\n  }\n\n  /** Rejects `finished` with an `AbortError`, like a real cancelled `Animation`. */\n  cancel = (): void => {\n    this.cancelCallCount += 1;\n    this.#reject(new DOMException('The animation was canceled.', 'AbortError'));\n  };\n\n  /** Resolves `finished`, like a real completed `Animation`. */\n  finish = (): void => {\n    this.finishCallCount += 1;\n    this.#resolve();\n  };\n}\n\n/**\n * Replaces `Element.prototype.animate` with a deterministic lifecycle fake for a test.\n * Dispose the installation or call `restore()` to restore the original implementation.\n *\n * @example\n * using animations = installFakeAnimations();\n * const handle = animate(element, [{ opacity: 0 }, { opacity: 1 }]);\n * animations.calls[0]?.animation.finish();\n * await handle.result; // { status: 'finished' }\n */\nexport function installFakeAnimations(): {\n  readonly calls: readonly AnimationCall[];\n  restore(): void;\n  [Symbol.dispose](): void;\n} {\n  const calls: AnimationCall[] = [];\n  const descriptor = Object.getOwnPropertyDescriptor(Element.prototype, 'animate');\n  let restored = false;\n\n  Object.defineProperty(Element.prototype, 'animate', {\n    configurable: true,\n    value: (keyframes: Keyframe[] | PropertyIndexedKeyframes, options?: KeyframeAnimationOptions) => {\n      const animation = new FakeAnimation();\n\n      calls.push({ animation, keyframes, options });\n\n      // Necromancer only consumes the documented Animation surface represented by FakeAnimation.\n      return animation as unknown as Animation;\n    },\n    writable: true,\n  });\n\n  const restore = (): void => {\n    if (restored) return;\n\n    restored = true;\n    if (descriptor) Object.defineProperty(Element.prototype, 'animate', descriptor);\n    else Reflect.deleteProperty(Element.prototype, 'animate');\n  };\n\n  return {\n    calls,\n    restore,\n    [Symbol.dispose]: restore,\n  };\n}\n\n/** Builds a `DOMRect` for mocking `Element.getBoundingClientRect()` in `captureLayout()` tests. */\nexport function createRect(x: number, y: number, width = 20, height = 20): DOMRect {\n  return new DOMRect(x, y, width, height);\n}\n"],"mappings":";AAgBA,IAAa,IAAb,MAA2B;CACzB;CACA;CAGA,kBAAkB;CAElB,kBAAkB;CAElB;CAEA,cAAc;EACZ,KAAK,WAAW,IAAI,SAAe,GAAS,MAAW;GAErD,AADA,KAAK,KAAW,GAChB,KAAK,KAAU;EACjB,CAAC;CACH;CAGA,eAAqB;EAEnB,AADA,KAAK,mBAAmB,GACxB,KAAK,GAAQ,IAAI,aAAa,+BAA+B,YAAY,CAAC;CAC5E;CAGA,eAAqB;EAEnB,AADA,KAAK,mBAAmB,GACxB,KAAK,GAAS;CAChB;AACF;AAYA,SAAgB,IAId;CACA,IAAM,IAAyB,CAAC,GAC1B,IAAa,OAAO,yBAAyB,QAAQ,WAAW,SAAS,GAC3E,IAAW;CAEf,OAAO,eAAe,QAAQ,WAAW,WAAW;EAClD,cAAc;EACd,QAAQ,GAAkD,MAAuC;GAC/F,IAAM,IAAY,IAAI,EAAc;GAKpC,OAHA,EAAM,KAAK;IAAE;IAAW;IAAW;GAAQ,CAAC,GAGrC;EACT;EACA,UAAU;CACZ,CAAC;CAED,IAAM,UAAsB;EACtB,MAEJ,IAAW,IACP,IAAY,OAAO,eAAe,QAAQ,WAAW,WAAW,CAAU,IACzE,QAAQ,eAAe,QAAQ,WAAW,SAAS;CAC1D;CAEA,OAAO;EACL;EACA;GACC,OAAO,UAAU;CACpB;AACF;AAGA,SAAgB,EAAW,GAAW,GAAW,IAAQ,IAAI,IAAS,IAAa;CACjF,OAAO,IAAI,QAAQ,GAAG,GAAG,GAAO,CAAM;AACxC"}
+{"version":3,"file":"testing.js","names":[],"sources":["../src/testing/index.ts"],"sourcesContent":["/**\n * Testing utilities for code that calls Necromancer's animation functions.\n *\n * jsdom (and most non-browser DOM environments) do not implement `Element.animate()`,\n * so any test that exercises `animate()`, `animateEach()`, or `captureLayout()` needs a\n * substitute. This module has no test-runner import: it works the same under Vitest,\n * Jest, or any other runner; use your runner's own spy/mock APIs on top if needed.\n */\n\nexport type AnimationCall = {\n  readonly animation: FakeAnimation;\n  readonly keyframes: Keyframe[] | PropertyIndexedKeyframes;\n  readonly options?: KeyframeAnimationOptions;\n};\n\n/** A minimal `Animation` stand-in. Call `finish()`/`cancel()` to settle it like the real API would. */\nexport class FakeAnimation {\n  #reject!: (reason?: unknown) => void;\n  #resolve!: () => void;\n\n  /** Number of times `cancel()` has been called. */\n  cancelCallCount = 0;\n  /** Number of times `finish()` has been called. */\n  finishCallCount = 0;\n  /** Mirrors the native `Animation.finished` promise. */\n  finished: Promise<void>;\n\n  constructor() {\n    this.finished = new Promise<void>((resolve, reject) => {\n      this.#resolve = resolve;\n      this.#reject = reject;\n    });\n  }\n\n  /** Rejects `finished` with an `AbortError`, like a real cancelled `Animation`. */\n  cancel = (): void => {\n    this.cancelCallCount += 1;\n    this.#reject(new DOMException('The animation was canceled.', 'AbortError'));\n  };\n\n  /** Resolves `finished`, like a real completed `Animation`. */\n  finish = (): void => {\n    this.finishCallCount += 1;\n    this.#resolve();\n  };\n}\n\n/**\n * Replaces `Element.prototype.animate` with a deterministic lifecycle fake for a test.\n * Dispose the installation or call `restore()` to restore the original implementation.\n *\n * @example\n * using animations = installFakeAnimations();\n * const handle = animate(element, [{ opacity: 0 }, { opacity: 1 }]);\n * animations.calls[0]?.animation.finish();\n * await handle.result; // { status: 'finished' }\n */\nexport function installFakeAnimations(): {\n  readonly calls: readonly AnimationCall[];\n  restore(): void;\n  [Symbol.dispose](): void;\n} {\n  const calls: AnimationCall[] = [];\n  const descriptor = Object.getOwnPropertyDescriptor(Element.prototype, 'animate');\n  let restored = false;\n\n  Object.defineProperty(Element.prototype, 'animate', {\n    configurable: true,\n    value: (keyframes: Keyframe[] | PropertyIndexedKeyframes, options?: KeyframeAnimationOptions) => {\n      const animation = new FakeAnimation();\n\n      calls.push({ animation, keyframes, options });\n\n      // Necromancer only consumes the documented Animation surface represented by FakeAnimation.\n      return animation as unknown as Animation;\n    },\n    writable: true,\n  });\n\n  const restore = (): void => {\n    if (restored) return;\n\n    restored = true;\n    if (descriptor) Object.defineProperty(Element.prototype, 'animate', descriptor);\n    else Reflect.deleteProperty(Element.prototype, 'animate');\n  };\n\n  return {\n    calls,\n    restore,\n    [Symbol.dispose]: restore,\n  };\n}\n\n/** Builds a `DOMRect` for mocking `Element.getBoundingClientRect()` in `captureLayout()` tests. */\nexport function createRect(x: number, y: number, width = 20, height = 20): DOMRect {\n  return new DOMRect(x, y, width, height);\n}\n"],"mappings":"AAgBA,IAAa,cAAb,KAA2B,CACzB,GACA,GAGA,gBAAkB,EAElB,gBAAkB,EAElB,SAEA,aAAc,CACZ,KAAK,SAAW,IAAI,SAAe,EAAS,IAAW,CACrD,KAAK,GAAW,EAChB,KAAK,GAAU,CACjB,CAAC,CACH,CAGA,WAAqB,CACnB,KAAK,iBAAmB,EACxB,KAAK,GAAQ,IAAI,aAAa,8BAA+B,YAAY,CAAC,CAC5E,EAGA,WAAqB,CACnB,KAAK,iBAAmB,EACxB,KAAK,GAAS,CAChB,CACF,EAYA,SAAgB,uBAId,CACA,IAAM,EAAyB,CAAC,EAC1B,EAAa,OAAO,yBAAyB,QAAQ,UAAW,SAAS,EAC3E,EAAW,GAEf,OAAO,eAAe,QAAQ,UAAW,UAAW,CAClD,aAAc,GACd,OAAQ,EAAkD,IAAuC,CAC/F,IAAM,EAAY,IAAI,cAKtB,OAHA,EAAM,KAAK,CAAE,YAAW,YAAW,SAAQ,CAAC,EAGrC,CACT,EACA,SAAU,EACZ,CAAC,EAED,IAAM,YAAsB,CACtB,IAEJ,EAAW,GACP,EAAY,OAAO,eAAe,QAAQ,UAAW,UAAW,CAAU,EACzE,QAAQ,eAAe,QAAQ,UAAW,SAAS,EAC1D,EAEA,MAAO,CACL,QACA,SACC,OAAO,SAAU,OACpB,CACF,CAGA,SAAgB,WAAW,EAAW,EAAW,EAAQ,GAAI,EAAS,GAAa,CACjF,OAAO,IAAI,QAAQ,EAAG,EAAG,EAAO,CAAM,CACxC"}

package/dist/types.d.ts

@@ -21,12 +21,12 @@ export type Keyframes = readonly Keyframe[] | PropertyIndexedKeyframes;
  * 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
+ * a second, smaller timing vocabulary: the option chain below only ever *adds* ownership
  * fields on top, never narrows what's already native.
  *
  * 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
+ * forwarding the rest down (see `animate-each.ts`, `layout.ts`, and `motion.ts`'s
  * `resolveAnimationOptions()`, which is the last stop and strips `motion`/`signal`).
  */
 export type AnimateOptions = KeyframeAnimationOptions & {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vielzeug/necromancer",
-  "version": "3.0.0",
-  "description": "Dependency-free, lifecycle-owned animation primitives built on the Web Animations API",
+  "version": "26.10.1",
+  "description": "Lifecycle-owned Web Animations API primitives with native access, per-handle groups, and additive FLIP",
   "repository": {
     "type": "git",
     "url": "https://github.com/helmuthdu/vielzeug",
@@ -54,10 +54,10 @@
   },
   "devDependencies": {
     "@playwright/test": "^1.63.0",
-    "@types/node": "^26.4.1",
-    "jsdom": "^30.0.1",
+    "@types/node": "^26.6.2",
+    "jsdom": "^30.1.1",
     "typescript": "^6.0.3",
-    "vite": "^8.2.2",
-    "vitest": "^5.0.0"
+    "vite": "^8.3.0",
+    "vitest": "^5.0.1"
   }
 }

package/dist/_motion.cjs

@@ -1,2 +0,0 @@
-const e=require("./errors.cjs");function t(e){return e===`full`?!1:e===`reduced`||typeof matchMedia==`function`&&matchMedia(`(prefers-reduced-motion: reduce)`).matches}function n(e={},t=!1){let{motion:n,signal:r,...i}=e;return t?{...i,delay:0,duration:0,endDelay:0,iterations:1}:i}function r(t,n){if(n===0)return t;let r=t.delay??0;if(typeof r!=`number`)throw new e.NecromancerConfigError(`A non-zero stagger requires a numeric delay; received ${typeof r}.`);return{...t,delay:r+n}}exports.resolveAnimationOptions=n,exports.shouldReduceMotion=t,exports.withStaggeredDelay=r;
-//# sourceMappingURL=_motion.cjs.map

package/dist/_motion.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"_motion.cjs","names":[],"sources":["../src/_motion.ts"],"sourcesContent":["import { NecromancerConfigError } from './errors';\nimport type { AnimateOptions, MotionMode } from './types';\n\n/** Reports whether the requested motion preference reduces visible movement. */\nexport function shouldReduceMotion(mode: MotionMode): boolean {\n  if (mode === 'full') return false;\n\n  if (mode === 'reduced') return true;\n\n  return typeof matchMedia === 'function' && matchMedia('(prefers-reduced-motion: reduce)').matches;\n}\n\n/** Converts ownership options to native timing, collapsing reduced motion to an instant transition. */\nexport function resolveAnimationOptions(options: AnimateOptions = {}, reduced = false): KeyframeAnimationOptions {\n  const { motion: _motion, signal: _signal, ...nativeOptions } = options;\n\n  return reduced ? { ...nativeOptions, delay: 0, duration: 0, endDelay: 0, iterations: 1 } : nativeOptions;\n}\n\n/** Adds an element's stagger offset without changing native nonnumeric delays when no offset is needed. */\nexport function withStaggeredDelay(options: AnimateOptions, offset: number): AnimateOptions {\n  if (offset === 0) return options;\n\n  const delay = options.delay ?? 0;\n\n  if (typeof delay !== 'number') {\n    throw new NecromancerConfigError(`A non-zero stagger requires a numeric delay; received ${typeof delay}.`);\n  }\n\n  return { ...options, delay: delay + offset };\n}\n"],"mappings":"gCAIA,SAAgB,EAAmB,EAA2B,CAK5D,OAJI,IAAS,OAAe,GAExB,IAAS,WAEN,OAAO,YAAe,YAAc,WAAW,kCAAkC,CAAC,CAAC,OAC5F,CAGA,SAAgB,EAAwB,EAA0B,CAAC,EAAG,EAAU,GAAiC,CAC/G,GAAM,CAAE,OAAQ,EAAS,OAAQ,EAAS,GAAG,GAAkB,EAE/D,OAAO,EAAU,CAAE,GAAG,EAAe,MAAO,EAAG,SAAU,EAAG,SAAU,EAAG,WAAY,CAAE,EAAI,CAC7F,CAGA,SAAgB,EAAmB,EAAyB,EAAgC,CAC1F,GAAI,IAAW,EAAG,OAAO,EAEzB,IAAM,EAAQ,EAAQ,OAAS,EAE/B,GAAI,OAAO,GAAU,SACnB,MAAM,IAAI,EAAA,uBAAuB,yDAAyD,OAAO,EAAM,EAAE,EAG3G,MAAO,CAAE,GAAG,EAAS,MAAO,EAAQ,CAAO,CAC7C"}

package/dist/_motion.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"_motion.d.ts","sourceRoot":"","sources":["../src/_motion.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1D,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAM5D;AAED,uGAAuG;AACvG,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,cAAmB,EAAE,OAAO,UAAQ,GAAG,wBAAwB,CAI/G;AAED,2GAA2G;AAC3G,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAU1F"}

package/dist/_motion.js

@@ -1,28 +0,0 @@
-import { NecromancerConfigError as e } from "./errors.js";
-//#region src/_motion.ts
-function t(e) {
-	return e === "full" ? !1 : e === "reduced" || typeof matchMedia == "function" && matchMedia("(prefers-reduced-motion: reduce)").matches;
-}
-function n(e = {}, t = !1) {
-	let { motion: n, signal: r, ...i } = e;
-	return t ? {
-		...i,
-		delay: 0,
-		duration: 0,
-		endDelay: 0,
-		iterations: 1
-	} : i;
-}
-function r(t, n) {
-	if (n === 0) return t;
-	let r = t.delay ?? 0;
-	if (typeof r != "number") throw new e(`A non-zero stagger requires a numeric delay; received ${typeof r}.`);
-	return {
-		...t,
-		delay: r + n
-	};
-}
-//#endregion
-export { n as resolveAnimationOptions, t as shouldReduceMotion, r as withStaggeredDelay };
-
-//# sourceMappingURL=_motion.js.map

package/dist/_motion.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"_motion.js","names":[],"sources":["../src/_motion.ts"],"sourcesContent":["import { NecromancerConfigError } from './errors';\nimport type { AnimateOptions, MotionMode } from './types';\n\n/** Reports whether the requested motion preference reduces visible movement. */\nexport function shouldReduceMotion(mode: MotionMode): boolean {\n  if (mode === 'full') return false;\n\n  if (mode === 'reduced') return true;\n\n  return typeof matchMedia === 'function' && matchMedia('(prefers-reduced-motion: reduce)').matches;\n}\n\n/** Converts ownership options to native timing, collapsing reduced motion to an instant transition. */\nexport function resolveAnimationOptions(options: AnimateOptions = {}, reduced = false): KeyframeAnimationOptions {\n  const { motion: _motion, signal: _signal, ...nativeOptions } = options;\n\n  return reduced ? { ...nativeOptions, delay: 0, duration: 0, endDelay: 0, iterations: 1 } : nativeOptions;\n}\n\n/** Adds an element's stagger offset without changing native nonnumeric delays when no offset is needed. */\nexport function withStaggeredDelay(options: AnimateOptions, offset: number): AnimateOptions {\n  if (offset === 0) return options;\n\n  const delay = options.delay ?? 0;\n\n  if (typeof delay !== 'number') {\n    throw new NecromancerConfigError(`A non-zero stagger requires a numeric delay; received ${typeof delay}.`);\n  }\n\n  return { ...options, delay: delay + offset };\n}\n"],"mappings":";;AAIA,SAAgB,EAAmB,GAA2B;CAK5D,OAJI,MAAS,SAAe,KAExB,MAAS,aAEN,OAAO,cAAe,cAAc,WAAW,kCAAkC,CAAC,CAAC;AAC5F;AAGA,SAAgB,EAAwB,IAA0B,CAAC,GAAG,IAAU,IAAiC;CAC/G,IAAM,EAAE,QAAQ,GAAS,QAAQ,GAAS,GAAG,MAAkB;CAE/D,OAAO,IAAU;EAAE,GAAG;EAAe,OAAO;EAAG,UAAU;EAAG,UAAU;EAAG,YAAY;CAAE,IAAI;AAC7F;AAGA,SAAgB,EAAmB,GAAyB,GAAgC;CAC1F,IAAI,MAAW,GAAG,OAAO;CAEzB,IAAM,IAAQ,EAAQ,SAAS;CAE/B,IAAI,OAAO,KAAU,UACnB,MAAM,IAAI,EAAuB,yDAAyD,OAAO,EAAM,EAAE;CAG3G,OAAO;EAAE,GAAG;EAAS,OAAO,IAAQ;CAAO;AAC7C"}