@vielzeug/necromancer 2.1.0 → 26.10.0

package/dist/layout.js

@@ -1,97 +1,2 @@
-import { NecromancerConfigError as e } from "./errors.js";
-import { uniqueElements as t } from "./_elements.js";
-import { animateEach as n } from "./animate-each.js";
-//#region src/layout.ts
-function r(e, t) {
-	let n = 10 ** t;
-	return Math.round(e * n) / n;
-}
-function i(e) {
-	if ("offsetWidth" in e && "offsetHeight" in e) return {
-		height: e.offsetHeight,
-		width: e.offsetWidth
-	};
-	let t = e.getBoundingClientRect();
-	return {
-		height: t.height,
-		width: t.width
-	};
-}
-function a(e) {
-	let t = e.getBoundingClientRect(), n = i(e);
-	return {
-		height: n.height,
-		width: n.width,
-		x: t.x,
-		y: t.y
-	};
-}
-function o(e, t) {
-	return t === 0 ? 1 : e / t;
-}
-function s(t, n, r) {
-	let i = n(t);
-	if (typeof i != "string" || i.length === 0) throw new e(`getKey must return a non-empty string for every ${r} element.`);
-	return i;
-}
-function c(t, n, r) {
-	let i = /* @__PURE__ */ new Map();
-	for (let a of t) {
-		let t = s(a.element, n, r);
-		if (i.has(t)) throw new e(`getKey returned duplicate keys for the ${r} elements.`);
-		i.set(t, a);
-	}
-	return i;
-}
-function l(e, t) {
-	if (!e.isConnected) return;
-	let n = a(e), r = t.x - n.x, i = t.y - n.y, s = o(t.width, n.width), c = o(t.height, n.height);
-	return r === 0 && i === 0 && s === 1 && c === 1 ? void 0 : {
-		element: e,
-		scaleX: s,
-		scaleY: c,
-		x: r,
-		y: i
-	};
-}
-function u(e, t) {
-	let n = new Map(e.map((e) => [e.element, e]));
-	return t.flatMap((e) => {
-		let t = n.get(e);
-		return t ? [l(e, t.rect)].filter((e) => !!e) : [];
-	});
-}
-function d(t, n, r) {
-	let i = /* @__PURE__ */ new Set();
-	return n.flatMap((n) => {
-		let a = s(n, r, "committed"), o = t.get(a);
-		if (i.has(a)) throw new e("getKey returned duplicate keys for the committed elements.");
-		return i.add(a), o ? [l(n, o.rect)].filter((e) => !!e) : [];
-	});
-}
-function f(i, o = {}) {
-	let s = t(i).map((e) => ({
-		element: e,
-		rect: a(e)
-	})), l = o.getKey, f = l ? c(s, l, "captured") : void 0, p = !1;
-	return { animate(i = {}) {
-		if (p) throw new e("This layout transition has already been animated.");
-		let { elements: a, ...o } = i, c = t(a ?? s.map(({ element: e }) => e)), m = l && f ? d(f, c, l) : u(s, c);
-		return p = !0, n(m.map(({ element: e }) => e), (e, t) => {
-			let n = m[t], i = `${r(n.x, 2)}px ${r(n.y, 2)}px`;
-			return [{
-				composite: "add",
-				scale: `${r(n.scaleX, 4)} ${r(n.scaleY, 4)}`,
-				translate: i
-			}, {
-				composite: "add",
-				scale: "1 1",
-				translate: "0px 0px"
-			}];
-		}, o);
-	} };
-}
-//#endregion
-export { f as captureLayout };
-
+import{NecromancerConfigError as e}from"./errors.js";import{uniqueElements as t}from"./_elements.js";import{animateEach as n}from"./animate-each.js";function round(e,t){let n=10**t;return Math.round(e*n)/n}function measureSize(e){if(`offsetWidth`in e&&`offsetHeight`in e)return{height:e.offsetHeight,width:e.offsetWidth};let t=e.getBoundingClientRect();return{height:t.height,width:t.width}}function measureLayout(e){let t=e.getBoundingClientRect(),n=measureSize(e);return{height:n.height,width:n.width,x:t.x,y:t.y}}function computeScale(e,t){return t===0?1:e/t}function readKey(t,n,r){let i=n(t);if(typeof i!=`string`||i.length===0)throw new e(`getKey must return a non-empty string for every ${r} element.`);return i}function createKeyMap(t,n,r){let i=new Map;for(let a of t){let t=readKey(a.element,n,r);if(i.has(t))throw new e(`getKey returned duplicate keys for the ${r} elements.`);i.set(t,a)}return i}function changedElement(e,t){if(!e.isConnected)return;let n=measureLayout(e),r=t.x-n.x,i=t.y-n.y,a=computeScale(t.width,n.width),o=computeScale(t.height,n.height);return r===0&&i===0&&a===1&&o===1?void 0:{element:e,scaleX:a,scaleY:o,x:r,y:i}}function matchByIdentity(e,t){let n=new Map(e.map(e=>[e.element,e]));return t.flatMap(e=>{let t=n.get(e);return t?[changedElement(e,t.rect)].filter(e=>!!e):[]})}function matchByKey(t,n,r){let i=new Set;return n.flatMap(n=>{let a=readKey(n,r,`committed`),o=t.get(a);if(i.has(a))throw new e(`getKey returned duplicate keys for the committed elements.`);return i.add(a),o?[changedElement(n,o.rect)].filter(e=>!!e):[]})}function captureLayout(r,i={}){let a=t(r).map(e=>({element:e,rect:measureLayout(e)})),o=i.getKey,s=o?createKeyMap(a,o,`captured`):void 0,c=!1;return{animate(r={}){if(c)throw new e(`This layout transition has already been animated.`);let{elements:i,...l}=r,u=t(i??a.map(({element:e})=>e)),d=o&&s?matchByKey(s,u,o):matchByIdentity(a,u);return c=!0,n(d.map(({element:e})=>e),(e,t)=>{let n=d[t],r=`${round(n.x,2)}px ${round(n.y,2)}px`;return[{composite:`add`,scale:`${round(n.scaleX,4)} ${round(n.scaleY,4)}`,translate:r},{composite:`add`,scale:`1 1`,translate:`0px 0px`}]},l)}}}export{captureLayout};
 //# sourceMappingURL=layout.js.map

package/dist/layout.js.map

@@ -1 +1 @@
-{"version":3,"file":"layout.js","names":[],"sources":["../src/layout.ts"],"sourcesContent":["import { uniqueElements } from './_elements';\nimport { animateEach } from './animate-each';\nimport { NecromancerConfigError } from './errors';\nimport type { LayoutAnimationOptions, LayoutCaptureOptions, LayoutTransition } from './types';\n\ntype LayoutRect = Readonly<Pick<DOMRectReadOnly, 'height' | 'width' | 'x' | 'y'>>;\ntype LayoutEntry = Readonly<{ element: Element; rect: LayoutRect }>;\ntype LayoutChange = Readonly<{ element: Element; scaleX: number; scaleY: number; x: number; y: number }>;\n\n// Rounds before templating into a keyframe string purely for DevTools readability — a `getBoundingClientRect()`\n// subtraction routinely produces values like `12.340000000000002`, which is noise once rendered as CSS.\n// Pixels only need whole-number precision; scale factors (close to 1) need finer precision to stay visually exact.\nfunction round(value: number, precision: number): number {\n  const factor = 10 ** precision;\n\n  return Math.round(value * factor) / factor;\n}\n\n// `getBoundingClientRect()`'s width/height is the rotated, axis-aligned bounding box — using it\n// for size would distort the scale ratio under any rotation. `offsetWidth`/`offsetHeight` report\n// the box's own untransformed layout size instead. Elements without an offset box (e.g. SVG)\n// fall back to the bounding rect, accepting that same distortion as the only option available.\nfunction measureSize(element: Element): Readonly<{ height: number; width: number }> {\n  if ('offsetWidth' in element && 'offsetHeight' in element) {\n    return { height: (element as HTMLElement).offsetHeight, width: (element as HTMLElement).offsetWidth };\n  }\n\n  const rect = element.getBoundingClientRect();\n\n  return { height: rect.height, width: rect.width };\n}\n\nfunction measureLayout(element: Element): LayoutRect {\n  const rect = element.getBoundingClientRect();\n  const size = measureSize(element);\n\n  return { height: size.height, width: size.width, x: rect.x, y: rect.y };\n}\n\n// `next` is 0 exactly when the element has collapsed (e.g. `display: none` mid-transition);\n// there's no meaningful ratio to compute then, so treat it as unscaled rather than producing Infinity/NaN.\nfunction computeScale(captured: number, next: number): number {\n  return next === 0 ? 1 : captured / next;\n}\n\nfunction readKey(element: Element, getKey: (element: Element) => string, phase: string): string {\n  const key = getKey(element);\n\n  if (typeof key !== 'string' || key.length === 0) {\n    throw new NecromancerConfigError(`getKey must return a non-empty string for every ${phase} element.`);\n  }\n\n  return key;\n}\n\nfunction createKeyMap(entries: readonly LayoutEntry[], getKey: (element: Element) => string, phase: string) {\n  const keys = new Map<string, LayoutEntry>();\n\n  for (const entry of entries) {\n    const key = readKey(entry.element, getKey, phase);\n\n    if (keys.has(key)) {\n      throw new NecromancerConfigError(`getKey returned duplicate keys for the ${phase} elements.`);\n    }\n\n    keys.set(key, entry);\n  }\n\n  return keys;\n}\n\nfunction changedElement(element: Element, rect: LayoutRect): LayoutChange | undefined {\n  if (!element.isConnected) return undefined;\n\n  const next = measureLayout(element);\n  const x = rect.x - next.x;\n  const y = rect.y - next.y;\n  const scaleX = computeScale(rect.width, next.width);\n  const scaleY = computeScale(rect.height, next.height);\n\n  return x === 0 && y === 0 && scaleX === 1 && scaleY === 1 ? undefined : { element, scaleX, scaleY, x, y };\n}\n\nfunction matchByIdentity(entries: readonly LayoutEntry[], elements: readonly Element[]): LayoutChange[] {\n  const captured = new Map(entries.map((entry) => [entry.element, entry]));\n\n  return elements.flatMap((element) => {\n    const entry = captured.get(element);\n\n    return entry\n      ? [changedElement(element, entry.rect)].filter((change): change is LayoutChange => Boolean(change))\n      : [];\n  });\n}\n\nfunction matchByKey(\n  captured: ReadonlyMap<string, LayoutEntry>,\n  elements: readonly Element[],\n  getKey: (element: Element) => string,\n): LayoutChange[] {\n  const committed = new Set<string>();\n\n  return elements.flatMap((element) => {\n    const key = readKey(element, getKey, 'committed');\n    const entry = captured.get(key);\n\n    if (committed.has(key)) {\n      throw new NecromancerConfigError('getKey returned duplicate keys for the committed elements.');\n    }\n\n    committed.add(key);\n\n    return entry\n      ? [changedElement(element, entry.rect)].filter((change): change is LayoutChange => Boolean(change))\n      : [];\n  });\n}\n\n/**\n * Captures the current position and size of unique elements for a later FLIP animation.\n *\n * Each element's `x`/`y` position and `width`/`height` are captured. Rotation and other\n * transforms are not captured or compensated. Capture before mutating the DOM, then call\n * the returned transition's `animate()` method after the browser has applied the resulting\n * layout — position changes animate via translate, and size changes via scale, both\n * additively composed on top of any authored transform.\n */\nexport function captureLayout(elements: Iterable<Element>, options: LayoutCaptureOptions = {}): LayoutTransition {\n  const entries: LayoutEntry[] = uniqueElements(elements).map((element) => ({\n    element,\n    rect: measureLayout(element),\n  }));\n  const getKey = options.getKey;\n  const captured = getKey ? createKeyMap(entries, getKey, 'captured') : undefined;\n\n  let consumed = false;\n\n  return {\n    animate(options: LayoutAnimationOptions = {}) {\n      if (consumed) throw new NecromancerConfigError('This layout transition has already been animated.');\n\n      const { elements: committedElements, ...animationOptions } = options;\n      const elements = uniqueElements(committedElements ?? entries.map(({ element }) => element));\n      const changed = getKey && captured ? matchByKey(captured, elements, getKey) : matchByIdentity(entries, elements);\n\n      consumed = true;\n\n      return animateEach(\n        changed.map(({ element }) => element),\n        (_, index) => {\n          // `changed` was mapped directly into the elements array above, so this index is always in range.\n          const change = changed[index]!;\n          const translate = `${round(change.x, 2)}px ${round(change.y, 2)}px`;\n          const scale = `${round(change.scaleX, 4)} ${round(change.scaleY, 4)}`;\n\n          return [\n            { composite: 'add', scale, translate },\n            { composite: 'add', scale: '1 1', translate: '0px 0px' },\n          ];\n        },\n        animationOptions,\n      );\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"layout.js","names":[],"sources":["../src/layout.ts"],"sourcesContent":["import { uniqueElements } from './_elements';\nimport { animateEach } from './animate-each';\nimport { NecromancerConfigError } from './errors';\nimport type { LayoutAnimationOptions, LayoutCaptureOptions, LayoutTransition } from './types';\n\ntype LayoutRect = Readonly<Pick<DOMRectReadOnly, 'height' | 'width' | 'x' | 'y'>>;\ntype LayoutEntry<ElementType extends Element> = Readonly<{ element: ElementType; rect: LayoutRect }>;\ntype LayoutChange<ElementType extends Element> = Readonly<{\n  element: ElementType;\n  scaleX: number;\n  scaleY: number;\n  x: number;\n  y: number;\n}>;\n\n// Rounds before templating into a keyframe string purely for DevTools readability — a `getBoundingClientRect()`\n// subtraction routinely produces values like `12.340000000000002`, which is noise once rendered as CSS.\n// Pixels only need whole-number precision; scale factors (close to 1) need finer precision to stay visually exact.\nfunction round(value: number, precision: number): number {\n  const factor = 10 ** precision;\n\n  return Math.round(value * factor) / factor;\n}\n\n// `getBoundingClientRect()`'s width/height is the rotated, axis-aligned bounding box — using it\n// for size would distort the scale ratio under any rotation. `offsetWidth`/`offsetHeight` report\n// the box's own untransformed layout size instead. Elements without an offset box (e.g. SVG)\n// fall back to the bounding rect, accepting that same distortion as the only option available.\nfunction measureSize(element: Element): Readonly<{ height: number; width: number }> {\n  if ('offsetWidth' in element && 'offsetHeight' in element) {\n    return { height: (element as HTMLElement).offsetHeight, width: (element as HTMLElement).offsetWidth };\n  }\n\n  const rect = element.getBoundingClientRect();\n\n  return { height: rect.height, width: rect.width };\n}\n\nfunction measureLayout(element: Element): LayoutRect {\n  const rect = element.getBoundingClientRect();\n  const size = measureSize(element);\n\n  return { height: size.height, width: size.width, x: rect.x, y: rect.y };\n}\n\n// `next` is 0 exactly when the element has collapsed (e.g. `display: none` mid-transition);\n// there's no meaningful ratio to compute then, so treat it as unscaled rather than producing Infinity/NaN.\nfunction computeScale(captured: number, next: number): number {\n  return next === 0 ? 1 : captured / next;\n}\n\nfunction readKey<ElementType extends Element>(\n  element: ElementType,\n  getKey: (element: ElementType) => string,\n  phase: string,\n): string {\n  const key = getKey(element);\n\n  if (typeof key !== 'string' || key.length === 0) {\n    throw new NecromancerConfigError(`getKey must return a non-empty string for every ${phase} element.`);\n  }\n\n  return key;\n}\n\nfunction createKeyMap<ElementType extends Element>(\n  entries: readonly LayoutEntry<ElementType>[],\n  getKey: (element: ElementType) => string,\n  phase: string,\n) {\n  const keys = new Map<string, LayoutEntry<ElementType>>();\n\n  for (const entry of entries) {\n    const key = readKey(entry.element, getKey, phase);\n\n    if (keys.has(key)) {\n      throw new NecromancerConfigError(`getKey returned duplicate keys for the ${phase} elements.`);\n    }\n\n    keys.set(key, entry);\n  }\n\n  return keys;\n}\n\nfunction changedElement<ElementType extends Element>(\n  element: ElementType,\n  rect: LayoutRect,\n): LayoutChange<ElementType> | undefined {\n  if (!element.isConnected) return undefined;\n\n  const next = measureLayout(element);\n  const x = rect.x - next.x;\n  const y = rect.y - next.y;\n  const scaleX = computeScale(rect.width, next.width);\n  const scaleY = computeScale(rect.height, next.height);\n\n  return x === 0 && y === 0 && scaleX === 1 && scaleY === 1 ? undefined : { element, scaleX, scaleY, x, y };\n}\n\nfunction matchByIdentity<ElementType extends Element>(\n  entries: readonly LayoutEntry<ElementType>[],\n  elements: readonly ElementType[],\n): LayoutChange<ElementType>[] {\n  const captured = new Map(entries.map((entry) => [entry.element, entry]));\n\n  return elements.flatMap((element) => {\n    const entry = captured.get(element);\n\n    return entry\n      ? [changedElement(element, entry.rect)].filter((change): change is LayoutChange<ElementType> => Boolean(change))\n      : [];\n  });\n}\n\nfunction matchByKey<ElementType extends Element>(\n  captured: ReadonlyMap<string, LayoutEntry<ElementType>>,\n  elements: readonly ElementType[],\n  getKey: (element: ElementType) => string,\n): LayoutChange<ElementType>[] {\n  const committed = new Set<string>();\n\n  return elements.flatMap((element) => {\n    const key = readKey(element, getKey, 'committed');\n    const entry = captured.get(key);\n\n    if (committed.has(key)) {\n      throw new NecromancerConfigError('getKey returned duplicate keys for the committed elements.');\n    }\n\n    committed.add(key);\n\n    return entry\n      ? [changedElement(element, entry.rect)].filter((change): change is LayoutChange<ElementType> => Boolean(change))\n      : [];\n  });\n}\n\n/**\n * Captures the current position and size of unique elements for a later FLIP animation.\n *\n * Each element's `x`/`y` position and `width`/`height` are captured. Rotation and other\n * transforms are not captured or compensated. Capture before mutating the DOM, then call\n * the returned transition's `animate()` method after the browser has applied the resulting\n * layout — position changes animate via translate, and size changes via scale, both\n * additively composed on top of any authored transform.\n */\nexport function captureLayout<ElementType extends Element>(\n  elements: Iterable<ElementType>,\n  options: LayoutCaptureOptions<ElementType> = {},\n): LayoutTransition<ElementType> {\n  const entries: LayoutEntry<ElementType>[] = uniqueElements(elements).map((element) => ({\n    element,\n    rect: measureLayout(element),\n  }));\n  const getKey = options.getKey;\n  const captured = getKey ? createKeyMap(entries, getKey, 'captured') : undefined;\n\n  let consumed = false;\n\n  return {\n    animate(options: LayoutAnimationOptions<ElementType> = {}) {\n      if (consumed) throw new NecromancerConfigError('This layout transition has already been animated.');\n\n      const { elements: committedElements, ...animationOptions } = options;\n      const elements = uniqueElements(committedElements ?? entries.map(({ element }) => element));\n      const changed = getKey && captured ? matchByKey(captured, elements, getKey) : matchByIdentity(entries, elements);\n\n      consumed = true;\n\n      return animateEach(\n        changed.map(({ element }) => element),\n        (_, index) => {\n          // `changed` was mapped directly into the elements array above, so this index is always in range.\n          const change = changed[index]!;\n          const translate = `${round(change.x, 2)}px ${round(change.y, 2)}px`;\n          const scale = `${round(change.scaleX, 4)} ${round(change.scaleY, 4)}`;\n\n          return [\n            { composite: 'add', scale, translate },\n            { composite: 'add', scale: '1 1', translate: '0px 0px' },\n          ];\n        },\n        animationOptions,\n      );\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/motion.cjs

@@ -0,0 +1,2 @@
+const e=require("./errors.cjs");function shouldReduceMotion(e){return e===`full`?!1:e===`reduced`||typeof matchMedia==`function`&&matchMedia(`(prefers-reduced-motion: reduce)`).matches}function resolveAnimationOptions(e={},t=!1){let{motion:n,signal:r,...i}=e;return t?{...i,delay:0,duration:0,endDelay:0,iterations:1}:i}function withStaggeredDelay(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=resolveAnimationOptions,exports.shouldReduceMotion=shouldReduceMotion,exports.withStaggeredDelay=withStaggeredDelay;
+//# sourceMappingURL=motion.cjs.map

package/dist/motion.cjs.map

@@ -0,0 +1 @@
+{"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,mBAAmB,EAA2B,CAK5D,OAJI,IAAS,OAAe,GAExB,IAAS,WAEN,OAAO,YAAe,YAAc,WAAW,kCAAkC,CAAC,CAAC,OAC5F,CAGA,SAAgB,wBAAwB,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,mBAAmB,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 → motion.d.ts}

@@ -5,4 +5,4 @@ export declare function shouldReduceMotion(mode: MotionMode): boolean;
 export declare function resolveAnimationOptions(options?: AnimateOptions, reduced?: boolean): KeyframeAnimationOptions;
 /** Adds an element's stagger offset without changing native nonnumeric delays when no offset is needed. */
 export declare function withStaggeredDelay(options: AnimateOptions, offset: number): AnimateOptions;
-//# sourceMappingURL=_motion.d.ts.map
+//# sourceMappingURL=motion.d.ts.map

package/dist/motion.d.ts.map

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,2 @@
+import{NecromancerConfigError as e}from"./errors.js";function shouldReduceMotion(e){return e===`full`?!1:e===`reduced`||typeof matchMedia==`function`&&matchMedia(`(prefers-reduced-motion: reduce)`).matches}function resolveAnimationOptions(e={},t=!1){let{motion:n,signal:r,...i}=e;return t?{...i,delay:0,duration:0,endDelay:0,iterations:1}:i}function withStaggeredDelay(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}}export{resolveAnimationOptions,shouldReduceMotion,withStaggeredDelay};
+//# sourceMappingURL=motion.js.map

package/dist/motion.js.map

@@ -0,0 +1 @@
+{"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":"qDAIA,SAAgB,mBAAmB,EAA2B,CAK5D,OAJI,IAAS,OAAe,GAExB,IAAS,WAEN,OAAO,YAAe,YAAc,WAAW,kCAAkC,CAAC,CAAC,OAC5F,CAGA,SAAgB,wBAAwB,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,mBAAmB,EAAyB,EAAgC,CAC1F,GAAI,IAAW,EAAG,OAAO,EAEzB,IAAM,EAAQ,EAAQ,OAAS,EAE/B,GAAI,OAAO,GAAU,SACnB,MAAM,IAAI,EAAuB,yDAAyD,OAAO,EAAM,EAAE,EAG3G,MAAO,CAAE,GAAG,EAAS,MAAO,EAAQ,CAAO,CAC7C"}

package/dist/necromancer.cjs

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});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)})}function r(e,t){let n=()=>t(e.reason);return e.addEventListener(`abort`,n,{once:!0}),()=>e.removeEventListener(`abort`,n)}function i(e,t,n){return e.finished.then(()=>(t(),{status:n?`reduced`:`finished`}),e=>(t(),{reason:e,status:`cancelled`}))}function a(e,t,n=!1){let a=!1,o,s=!1,c,l=i(e,()=>{c?.(),c=void 0},n).then(e=>a&&s&&e.status===`cancelled`?{reason:o,status:`cancelled`}:e),u=t=>{a||(a=!0,o=t,s=t!==void 0,c?.(),c=void 0,e.cancel())};return t&&(c=r(t,u)),{animation:e,dispose:u,get disposed(){return a},result:l,[Symbol.dispose](){this.dispose()}}}function o(e,t){let n=!1,i,a=Promise.all(e.map(e=>e.result)).then(e=>(i?.(),i=void 0,e)),o=t=>{if(!n){n=!0,i?.(),i=void 0;for(let n of e)n.dispose(t)}};return t&&(i=r(t,o)),{dispose:o,get disposed(){return n},handles:e,results:a,[Symbol.dispose](){this.dispose()}}}var s=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},c=class extends s{},l=class extends s{},u=180;function d(e){return e===`full`?!1:e===`reduced`||typeof matchMedia==`function`&&matchMedia(`(prefers-reduced-motion: reduce)`).matches}function f(e={},t=!1){let{duration:n,interrupt:r,motion:i=`system`,signal:a,...o}=e,s=n===void 0?{...o,duration:u}:{...o,duration:n};return t?{...s,delay:0,duration:0,endDelay:0,iterations:1}:s}function p(e,t){if(t===0)return e;let n=e.delay??0;if(typeof n!=`number`)throw new c(`A non-zero stagger requires a numeric delay; received ${typeof n}.`);return{...e,delay:n+t}}function m(e,r,i={}){if(i.signal?.aborted)throw i.signal.reason;if(typeof e.animate!=`function`)throw new l(`The Web Animations API is not available in this environment.`);i.interrupt===`cancel`&&t(e);let o=d(i.motion??`system`),s=a(e.animate(r,f(i,o)),i.signal,o);return n(e,s),s}function h(e){return[...new Set(e)]}function g(e){if(!Number.isFinite(e)||e<0)throw new c(`stagger must be a finite, non-negative number.`)}function _(e,t,n={}){let{signal:r,stagger:i=0,...a}=n;if(g(i),r?.aborted)throw r.reason;let s=h(e),c=s.map((e,n)=>typeof t==`function`?t(e,n,s.length):t),l=[];try{for(let[e,t]of s.entries()){let n=c[e];l.push(m(t,n,p(a,e*i)))}}catch(e){for(let t of l)t.dispose(e);throw e}return o(l,r)}function v(e,t){let n=10**t;return Math.round(e*n)/n}function y(e){if(`offsetWidth`in e&&`offsetHeight`in e)return{height:e.offsetHeight,width:e.offsetWidth};let t=e.getBoundingClientRect();return{height:t.height,width:t.width}}function b(e){let t=e.getBoundingClientRect(),n=y(e);return{height:n.height,width:n.width,x:t.x,y:t.y}}function x(e,t){return t===0?1:e/t}function S(e,t,n){let r=t(e);if(typeof r!=`string`||r.length===0)throw new c(`getKey must return a non-empty string for every ${n} element.`);return r}function C(e,t,n){let r=new Map;for(let i of e){let e=S(i.element,t,n);if(r.has(e))throw new c(`getKey returned duplicate keys for the ${n} elements.`);r.set(e,i)}return r}function w(e,t){if(!e.isConnected)return;let n=b(e),r=t.x-n.x,i=t.y-n.y,a=x(t.width,n.width),o=x(t.height,n.height);return r===0&&i===0&&a===1&&o===1?void 0:{element:e,scaleX:a,scaleY:o,x:r,y:i}}function T(e,t){let n=new Map(e.map(e=>[e.element,e]));return t.flatMap(e=>{let t=n.get(e);return t?[w(e,t.rect)].filter(e=>!!e):[]})}function E(e,t,n){let r=new Set;return t.flatMap(t=>{let i=S(t,n,`committed`),a=e.get(i);if(r.has(i))throw new c(`getKey returned duplicate keys for the committed elements.`);return r.add(i),a?[w(t,a.rect)].filter(e=>!!e):[]})}function D(e,t={}){let n=h(e).map(e=>({element:e,rect:b(e)})),r=t.getKey,i=r?C(n,r,`captured`):void 0,a=!1;return{animate(e={}){if(a)throw new c(`This layout transition has already been animated.`);let{elements:t,...o}=e,s=h(t??n.map(({element:e})=>e)),l=r&&i?E(i,s,r):T(n,s);return a=!0,_(l.map(({element:e})=>e),(e,t)=>{let n=l[t],r=`${v(n.x,2)}px ${v(n.y,2)}px`;return[{composite:`add`,scale:`${v(n.scaleX,4)} ${v(n.scaleY,4)}`,translate:r},{composite:`add`,scale:`1 1`,translate:`0px 0px`}]},o)}}}exports.NecromancerConfigError=c,exports.NecromancerError=s,exports.NecromancerUnsupportedError=l,exports.animate=m,exports.animateEach=_,exports.captureLayout=D;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});function attachAbortSignalListener(e,t){let abort=()=>t(e.reason);return e.addEventListener(`abort`,abort,{once:!0}),e.aborted?(e.removeEventListener(`abort`,abort),t(e.reason),()=>void 0):()=>e.removeEventListener(`abort`,abort)}function createResultPromise(e,t,n){return e.finished.then(()=>(t(),{status:n?`reduced`:`finished`}),e=>(t(),{reason:e,status:`cancelled`}))}function createAnimationHandle(e,t,n=!1){let r=!1,i,a=!1,o,s=createResultPromise(e,()=>{o?.(),o=void 0},n).then(e=>r&&a&&e.status===`cancelled`?{reason:i,status:`cancelled`}:e),dispose=t=>{r||(r=!0,i=t,a=t!==void 0,o?.(),o=void 0,e.cancel())};return t&&(o=attachAbortSignalListener(t,dispose)),{animation:e,dispose,get disposed(){return r},result:s,[Symbol.dispose](){this.dispose()}}}function createAnimationGroup(e,t){let n=!1,r,i=Promise.all(e.map(e=>e.result)).then(e=>(r?.(),r=void 0,e)),dispose=t=>{if(!n){n=!0,r?.(),r=void 0;for(let n of e)n.dispose(t)}};return t&&(r=attachAbortSignalListener(t,dispose)),{dispose,get disposed(){return n},handles:e,results:i,[Symbol.dispose](){this.dispose()}}}var NecromancerError=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},NecromancerConfigError=class extends NecromancerError{},NecromancerUnsupportedError=class extends NecromancerError{};function shouldReduceMotion(e){return e===`full`?!1:e===`reduced`||typeof matchMedia==`function`&&matchMedia(`(prefers-reduced-motion: reduce)`).matches}function resolveAnimationOptions(e={},t=!1){let{motion:n,signal:r,...i}=e;return t?{...i,delay:0,duration:0,endDelay:0,iterations:1}:i}function withStaggeredDelay(e,t){if(t===0)return e;let n=e.delay??0;if(typeof n!=`number`)throw new NecromancerConfigError(`A non-zero stagger requires a numeric delay; received ${typeof n}.`);return{...e,delay:n+t}}function animate(e,t,n={}){if(n.signal?.aborted)throw n.signal.reason;if(typeof e.animate!=`function`)throw new NecromancerUnsupportedError(`The Web Animations API is not available in this environment.`);let r=shouldReduceMotion(n.motion??`system`);return createAnimationHandle(e.animate(t,resolveAnimationOptions(n,r)),n.signal,r)}function uniqueElements(e){return[...new Set(e)]}function validateStagger(e){if(!Number.isFinite(e)||e<0)throw new NecromancerConfigError(`stagger must be a finite, non-negative number.`)}function animateEach(e,t,n={}){let{signal:r,stagger:i=0,...a}=n;if(validateStagger(i),r?.aborted)throw r.reason;let o=uniqueElements(e),s=o.map((e,n)=>typeof t==`function`?t(e,n,o.length):t);if(r?.aborted)throw r.reason;let c=[];try{for(let[e,t]of o.entries()){let n=s[e];c.push(animate(t,n,withStaggeredDelay(a,e*i)))}}catch(e){for(let t of c)t.dispose(e);throw e}return createAnimationGroup(c,r)}function round(e,t){let n=10**t;return Math.round(e*n)/n}function measureSize(e){if(`offsetWidth`in e&&`offsetHeight`in e)return{height:e.offsetHeight,width:e.offsetWidth};let t=e.getBoundingClientRect();return{height:t.height,width:t.width}}function measureLayout(e){let t=e.getBoundingClientRect(),n=measureSize(e);return{height:n.height,width:n.width,x:t.x,y:t.y}}function computeScale(e,t){return t===0?1:e/t}function readKey(e,t,n){let r=t(e);if(typeof r!=`string`||r.length===0)throw new NecromancerConfigError(`getKey must return a non-empty string for every ${n} element.`);return r}function createKeyMap(e,t,n){let r=new Map;for(let i of e){let e=readKey(i.element,t,n);if(r.has(e))throw new NecromancerConfigError(`getKey returned duplicate keys for the ${n} elements.`);r.set(e,i)}return r}function changedElement(e,t){if(!e.isConnected)return;let n=measureLayout(e),r=t.x-n.x,i=t.y-n.y,a=computeScale(t.width,n.width),o=computeScale(t.height,n.height);return r===0&&i===0&&a===1&&o===1?void 0:{element:e,scaleX:a,scaleY:o,x:r,y:i}}function matchByIdentity(e,t){let n=new Map(e.map(e=>[e.element,e]));return t.flatMap(e=>{let t=n.get(e);return t?[changedElement(e,t.rect)].filter(e=>!!e):[]})}function matchByKey(e,t,n){let r=new Set;return t.flatMap(t=>{let i=readKey(t,n,`committed`),a=e.get(i);if(r.has(i))throw new NecromancerConfigError(`getKey returned duplicate keys for the committed elements.`);return r.add(i),a?[changedElement(t,a.rect)].filter(e=>!!e):[]})}function captureLayout(e,t={}){let n=uniqueElements(e).map(e=>({element:e,rect:measureLayout(e)})),r=t.getKey,i=r?createKeyMap(n,r,`captured`):void 0,a=!1;return{animate(e={}){if(a)throw new NecromancerConfigError(`This layout transition has already been animated.`);let{elements:t,...o}=e,s=uniqueElements(t??n.map(({element:e})=>e)),c=r&&i?matchByKey(i,s,r):matchByIdentity(n,s);return a=!0,animateEach(c.map(({element:e})=>e),(e,t)=>{let n=c[t],r=`${round(n.x,2)}px ${round(n.y,2)}px`;return[{composite:`add`,scale:`${round(n.scaleX,4)} ${round(n.scaleY,4)}`,translate:r},{composite:`add`,scale:`1 1`,translate:`0px 0px`}]},o)}}}exports.NecromancerConfigError=NecromancerConfigError,exports.NecromancerError=NecromancerError,exports.NecromancerUnsupportedError=NecromancerUnsupportedError,exports.animate=animate,exports.animateEach=animateEach,exports.captureLayout=captureLayout,exports.shouldReduceMotion=shouldReduceMotion;
 //# sourceMappingURL=necromancer.cjs.map

package/dist/necromancer.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"necromancer.cjs","names":[],"sources":["../src/_active.ts","../src/_handle.ts","../src/errors.ts","../src/_motion.ts","../src/animate.ts","../src/_elements.ts","../src/animate-each.ts","../src/layout.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","import type { AnimationGroup, AnimationHandle, AnimationResult } from './types';\n\n/**\n * Attaches an abort listener to a signal and returns a function that removes it.\n * When the signal aborts, calls the dispose function with the signal's reason.\n */\nfunction attachAbortSignalListener(signal: AbortSignal, dispose: (reason?: unknown) => void): () => void {\n  const abort = () => dispose(signal.reason);\n\n  signal.addEventListener('abort', abort, { once: true });\n\n  return () => signal.removeEventListener('abort', abort);\n}\n\nfunction createResultPromise(animation: Animation, onSettled: () => void, reduced: boolean): Promise<AnimationResult> {\n  return animation.finished.then(\n    () => {\n      onSettled();\n\n      return { status: reduced ? 'reduced' : 'finished' };\n    },\n    (reason: unknown) => {\n      onSettled();\n\n      return { reason, status: 'cancelled' };\n    },\n  );\n}\n\n/** Wraps a native Animation with Necromancer's lifecycle contract. */\nexport function createAnimationHandle(animation: Animation, signal?: AbortSignal, reduced = false): AnimationHandle {\n  let disposed = false;\n  let disposeReason: unknown;\n  let hasDisposeReason = false;\n  let removeAbortListener: (() => void) | undefined;\n\n  const result: Promise<AnimationResult> = createResultPromise(\n    animation,\n    () => {\n      removeAbortListener?.();\n      removeAbortListener = undefined;\n    },\n    reduced,\n  ).then((outcome): AnimationResult => {\n    if (disposed && hasDisposeReason && outcome.status === 'cancelled') {\n      return { reason: disposeReason, status: 'cancelled' };\n    }\n\n    return outcome;\n  });\n\n  const dispose = (reason?: unknown): void => {\n    if (disposed) return;\n\n    disposed = true;\n    disposeReason = reason;\n    hasDisposeReason = reason !== undefined;\n    removeAbortListener?.();\n    removeAbortListener = undefined;\n    animation.cancel();\n  };\n\n  if (signal) {\n    removeAbortListener = attachAbortSignalListener(signal, dispose);\n  }\n\n  return {\n    animation,\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    result,\n    [Symbol.dispose]() {\n      this.dispose();\n    },\n  };\n}\n\n/** Combines child animation handles under one disposal owner. */\nexport function createAnimationGroup(handles: readonly AnimationHandle[], signal?: AbortSignal): AnimationGroup {\n  let disposed = false;\n  let removeAbortListener: (() => void) | undefined;\n\n  const results: Promise<readonly AnimationResult[]> = Promise.all(handles.map((handle) => handle.result)).then(\n    (childResults): readonly AnimationResult[] => {\n      removeAbortListener?.();\n      removeAbortListener = undefined;\n\n      return childResults;\n    },\n  );\n\n  const dispose = (reason?: unknown): void => {\n    if (disposed) return;\n\n    disposed = true;\n    removeAbortListener?.();\n    removeAbortListener = undefined;\n    for (const handle of handles) handle.dispose(reason);\n  };\n\n  if (signal) {\n    removeAbortListener = attachAbortSignalListener(signal, dispose);\n  }\n\n  return {\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    handles,\n    results,\n    [Symbol.dispose]() {\n      this.dispose();\n    },\n  };\n}\n","/** Base class for errors raised by `@vielzeug/necromancer`. */\nexport class NecromancerError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** Thrown when a Necromancer-owned option is invalid. */\nexport class NecromancerConfigError extends NecromancerError {}\n\n/** Thrown when the runtime does not implement the Web Animations API. */\nexport class NecromancerUnsupportedError extends NecromancerError {}\n","import { NecromancerConfigError } from './errors';\nimport type { AnimateOptions, MotionMode } from './types';\n\nconst DEFAULT_DURATION = 180;\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 { duration, interrupt: _interrupt, motion: _motion = 'system', signal: _signal, ...nativeOptions } = options;\n  const timing =\n    duration === undefined ? { ...nativeOptions, duration: DEFAULT_DURATION } : { ...nativeOptions, duration };\n\n  return reduced ? { ...timing, delay: 0, duration: 0, endDelay: 0, iterations: 1 } : timing;\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","import { interruptAnimations, trackAnimation } from './_active';\nimport { createAnimationHandle } from './_handle';\nimport { resolveAnimationOptions, shouldReduceMotion } from './_motion';\nimport { NecromancerUnsupportedError } from './errors';\nimport type { AnimateOptions, AnimationHandle, Keyframes } from './types';\n\n/**\n * Starts a lifecycle-owned native Web Animation for one element.\n *\n * The returned handle cancels its native animation when disposed. By default, the\n * operating system's reduced-motion preference suppresses movement.\n */\nexport function animate(element: Element, keyframes: Keyframes, options: AnimateOptions = {}): AnimationHandle {\n  if (options.signal?.aborted) throw options.signal.reason;\n\n  if (typeof element.animate !== 'function') {\n    throw new NecromancerUnsupportedError('The Web Animations API is not available in this environment.');\n  }\n\n  if (options.interrupt === 'cancel') interruptAnimations(element);\n\n  const reduced = shouldReduceMotion(options.motion ?? 'system');\n  const nativeAnimation = element.animate(\n    keyframes as Keyframe[] | PropertyIndexedKeyframes,\n    resolveAnimationOptions(options, reduced),\n  );\n  const handle = createAnimationHandle(nativeAnimation, options.signal, reduced);\n\n  trackAnimation(element, handle);\n\n  return handle;\n}\n","/** Deduplicates elements while preserving first-seen order. Shared by `animateEach()` and `captureLayout()`. */\nexport function uniqueElements(elements: Iterable<Element>): Element[] {\n  return [...new Set(elements)];\n}\n","import { uniqueElements } from './_elements';\nimport { createAnimationGroup } from './_handle';\nimport { withStaggeredDelay } from './_motion';\nimport { animate } from './animate';\nimport { NecromancerConfigError } from './errors';\nimport type { AnimateEachOptions, AnimationGroup, AnimationHandle, KeyframeFactory, Keyframes } from './types';\n\nfunction validateStagger(stagger: number): void {\n  if (!Number.isFinite(stagger) || stagger < 0) {\n    throw new NecromancerConfigError('stagger must be a finite, non-negative number.');\n  }\n}\n\n/**\n * Starts lifecycle-owned animations for unique elements in iteration order.\n *\n * Each subsequent element starts after `stagger` milliseconds. A keyframe factory\n * receives the stable unique-element index and total before any animation starts.\n */\nexport function animateEach(\n  elements: Iterable<Element>,\n  keyframes: Keyframes | KeyframeFactory,\n  options: AnimateEachOptions = {},\n): AnimationGroup {\n  const { signal, stagger = 0, ...animationOptions } = options;\n\n  validateStagger(stagger);\n\n  if (signal?.aborted) throw signal.reason;\n\n  const unique = uniqueElements(elements);\n  const frames = unique.map((element, index) =>\n    typeof keyframes === 'function' ? keyframes(element, index, unique.length) : keyframes,\n  );\n  const handles: AnimationHandle[] = [];\n\n  try {\n    for (const [index, element] of unique.entries()) {\n      // `frames` was built above from `unique`, one entry per element, so this index is always in range.\n      const currentFrames = frames[index]!;\n\n      handles.push(animate(element, currentFrames, withStaggeredDelay(animationOptions, index * stagger)));\n    }\n  } catch (error) {\n    for (const handle of handles) handle.dispose(error);\n\n    throw error;\n  }\n\n  return createAnimationGroup(handles, signal);\n}\n","import { uniqueElements } from './_elements';\nimport { animateEach } from './animate-each';\nimport { NecromancerConfigError } from './errors';\nimport type { LayoutAnimationOptions, LayoutCaptureOptions, LayoutTransition } from './types';\n\ntype LayoutRect = Readonly<Pick<DOMRectReadOnly, 'height' | 'width' | 'x' | 'y'>>;\ntype LayoutEntry = Readonly<{ element: Element; rect: LayoutRect }>;\ntype LayoutChange = Readonly<{ element: Element; scaleX: number; scaleY: number; x: number; y: number }>;\n\n// Rounds before templating into a keyframe string purely for DevTools readability — a `getBoundingClientRect()`\n// subtraction routinely produces values like `12.340000000000002`, which is noise once rendered as CSS.\n// Pixels only need whole-number precision; scale factors (close to 1) need finer precision to stay visually exact.\nfunction round(value: number, precision: number): number {\n  const factor = 10 ** precision;\n\n  return Math.round(value * factor) / factor;\n}\n\n// `getBoundingClientRect()`'s width/height is the rotated, axis-aligned bounding box — using it\n// for size would distort the scale ratio under any rotation. `offsetWidth`/`offsetHeight` report\n// the box's own untransformed layout size instead. Elements without an offset box (e.g. SVG)\n// fall back to the bounding rect, accepting that same distortion as the only option available.\nfunction measureSize(element: Element): Readonly<{ height: number; width: number }> {\n  if ('offsetWidth' in element && 'offsetHeight' in element) {\n    return { height: (element as HTMLElement).offsetHeight, width: (element as HTMLElement).offsetWidth };\n  }\n\n  const rect = element.getBoundingClientRect();\n\n  return { height: rect.height, width: rect.width };\n}\n\nfunction measureLayout(element: Element): LayoutRect {\n  const rect = element.getBoundingClientRect();\n  const size = measureSize(element);\n\n  return { height: size.height, width: size.width, x: rect.x, y: rect.y };\n}\n\n// `next` is 0 exactly when the element has collapsed (e.g. `display: none` mid-transition);\n// there's no meaningful ratio to compute then, so treat it as unscaled rather than producing Infinity/NaN.\nfunction computeScale(captured: number, next: number): number {\n  return next === 0 ? 1 : captured / next;\n}\n\nfunction readKey(element: Element, getKey: (element: Element) => string, phase: string): string {\n  const key = getKey(element);\n\n  if (typeof key !== 'string' || key.length === 0) {\n    throw new NecromancerConfigError(`getKey must return a non-empty string for every ${phase} element.`);\n  }\n\n  return key;\n}\n\nfunction createKeyMap(entries: readonly LayoutEntry[], getKey: (element: Element) => string, phase: string) {\n  const keys = new Map<string, LayoutEntry>();\n\n  for (const entry of entries) {\n    const key = readKey(entry.element, getKey, phase);\n\n    if (keys.has(key)) {\n      throw new NecromancerConfigError(`getKey returned duplicate keys for the ${phase} elements.`);\n    }\n\n    keys.set(key, entry);\n  }\n\n  return keys;\n}\n\nfunction changedElement(element: Element, rect: LayoutRect): LayoutChange | undefined {\n  if (!element.isConnected) return undefined;\n\n  const next = measureLayout(element);\n  const x = rect.x - next.x;\n  const y = rect.y - next.y;\n  const scaleX = computeScale(rect.width, next.width);\n  const scaleY = computeScale(rect.height, next.height);\n\n  return x === 0 && y === 0 && scaleX === 1 && scaleY === 1 ? undefined : { element, scaleX, scaleY, x, y };\n}\n\nfunction matchByIdentity(entries: readonly LayoutEntry[], elements: readonly Element[]): LayoutChange[] {\n  const captured = new Map(entries.map((entry) => [entry.element, entry]));\n\n  return elements.flatMap((element) => {\n    const entry = captured.get(element);\n\n    return entry\n      ? [changedElement(element, entry.rect)].filter((change): change is LayoutChange => Boolean(change))\n      : [];\n  });\n}\n\nfunction matchByKey(\n  captured: ReadonlyMap<string, LayoutEntry>,\n  elements: readonly Element[],\n  getKey: (element: Element) => string,\n): LayoutChange[] {\n  const committed = new Set<string>();\n\n  return elements.flatMap((element) => {\n    const key = readKey(element, getKey, 'committed');\n    const entry = captured.get(key);\n\n    if (committed.has(key)) {\n      throw new NecromancerConfigError('getKey returned duplicate keys for the committed elements.');\n    }\n\n    committed.add(key);\n\n    return entry\n      ? [changedElement(element, entry.rect)].filter((change): change is LayoutChange => Boolean(change))\n      : [];\n  });\n}\n\n/**\n * Captures the current position and size of unique elements for a later FLIP animation.\n *\n * Each element's `x`/`y` position and `width`/`height` are captured. Rotation and other\n * transforms are not captured or compensated. Capture before mutating the DOM, then call\n * the returned transition's `animate()` method after the browser has applied the resulting\n * layout — position changes animate via translate, and size changes via scale, both\n * additively composed on top of any authored transform.\n */\nexport function captureLayout(elements: Iterable<Element>, options: LayoutCaptureOptions = {}): LayoutTransition {\n  const entries: LayoutEntry[] = uniqueElements(elements).map((element) => ({\n    element,\n    rect: measureLayout(element),\n  }));\n  const getKey = options.getKey;\n  const captured = getKey ? createKeyMap(entries, getKey, 'captured') : undefined;\n\n  let consumed = false;\n\n  return {\n    animate(options: LayoutAnimationOptions = {}) {\n      if (consumed) throw new NecromancerConfigError('This layout transition has already been animated.');\n\n      const { elements: committedElements, ...animationOptions } = options;\n      const elements = uniqueElements(committedElements ?? entries.map(({ element }) => element));\n      const changed = getKey && captured ? matchByKey(captured, elements, getKey) : matchByIdentity(entries, elements);\n\n      consumed = true;\n\n      return animateEach(\n        changed.map(({ element }) => element),\n        (_, index) => {\n          // `changed` was mapped directly into the elements array above, so this index is always in range.\n          const change = changed[index]!;\n          const translate = `${round(change.x, 2)}px ${round(change.y, 2)}px`;\n          const scale = `${round(change.scaleX, 4)} ${round(change.scaleY, 4)}`;\n\n          return [\n            { composite: 'add', scale, translate },\n            { composite: 'add', scale: '1 1', translate: '0px 0px' },\n          ];\n        },\n        animationOptions,\n      );\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"necromancer.cjs","names":[],"sources":["../src/_handle.ts","../src/errors.ts","../src/motion.ts","../src/animate.ts","../src/_elements.ts","../src/animate-each.ts","../src/layout.ts"],"sourcesContent":["import type { AnimationGroup, AnimationHandle, AnimationResult } from './types';\n\n/**\n * Attaches an abort listener to a signal and returns a function that removes it.\n * When the signal aborts, calls the dispose function with the signal's reason.\n */\nfunction attachAbortSignalListener(signal: AbortSignal, dispose: (reason?: unknown) => void): () => void {\n  const abort = () => dispose(signal.reason);\n\n  signal.addEventListener('abort', abort, { once: true });\n\n  if (signal.aborted) {\n    signal.removeEventListener('abort', abort);\n    dispose(signal.reason);\n    return () => undefined;\n  }\n\n  return () => signal.removeEventListener('abort', abort);\n}\n\nfunction createResultPromise(animation: Animation, onSettled: () => void, reduced: boolean): Promise<AnimationResult> {\n  return animation.finished.then(\n    () => {\n      onSettled();\n\n      return { status: reduced ? 'reduced' : 'finished' };\n    },\n    (reason: unknown) => {\n      onSettled();\n\n      return { reason, status: 'cancelled' };\n    },\n  );\n}\n\n/** Wraps a native Animation with Necromancer's lifecycle contract. */\nexport function createAnimationHandle(animation: Animation, signal?: AbortSignal, reduced = false): AnimationHandle {\n  let disposed = false;\n  let disposeReason: unknown;\n  let hasDisposeReason = false;\n  let removeAbortListener: (() => void) | undefined;\n\n  const result: Promise<AnimationResult> = createResultPromise(\n    animation,\n    () => {\n      removeAbortListener?.();\n      removeAbortListener = undefined;\n    },\n    reduced,\n  ).then((outcome): AnimationResult => {\n    if (disposed && hasDisposeReason && outcome.status === 'cancelled') {\n      return { reason: disposeReason, status: 'cancelled' };\n    }\n\n    return outcome;\n  });\n\n  const dispose = (reason?: unknown): void => {\n    if (disposed) return;\n\n    disposed = true;\n    disposeReason = reason;\n    hasDisposeReason = reason !== undefined;\n    removeAbortListener?.();\n    removeAbortListener = undefined;\n    animation.cancel();\n  };\n\n  if (signal) {\n    removeAbortListener = attachAbortSignalListener(signal, dispose);\n  }\n\n  return {\n    animation,\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    result,\n    [Symbol.dispose]() {\n      this.dispose();\n    },\n  };\n}\n\n/** Combines child animation handles under one disposal owner. */\nexport function createAnimationGroup(handles: readonly AnimationHandle[], signal?: AbortSignal): AnimationGroup {\n  let disposed = false;\n  let removeAbortListener: (() => void) | undefined;\n\n  const results: Promise<readonly AnimationResult[]> = Promise.all(handles.map((handle) => handle.result)).then(\n    (childResults): readonly AnimationResult[] => {\n      removeAbortListener?.();\n      removeAbortListener = undefined;\n\n      return childResults;\n    },\n  );\n\n  const dispose = (reason?: unknown): void => {\n    if (disposed) return;\n\n    disposed = true;\n    removeAbortListener?.();\n    removeAbortListener = undefined;\n    for (const handle of handles) handle.dispose(reason);\n  };\n\n  if (signal) {\n    removeAbortListener = attachAbortSignalListener(signal, dispose);\n  }\n\n  return {\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    handles,\n    results,\n    [Symbol.dispose]() {\n      this.dispose();\n    },\n  };\n}\n","/** Base class for errors raised by `@vielzeug/necromancer`. */\nexport class NecromancerError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** Thrown when a Necromancer-owned option is invalid. */\nexport class NecromancerConfigError extends NecromancerError {}\n\n/** Thrown when the runtime does not implement the Web Animations API. */\nexport class NecromancerUnsupportedError extends NecromancerError {}\n","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","import { createAnimationHandle } from './_handle';\nimport { NecromancerUnsupportedError } from './errors';\nimport { resolveAnimationOptions, shouldReduceMotion } from './motion';\nimport type { AnimateOptions, AnimationHandle, Keyframes } from './types';\n\n/**\n * Starts a lifecycle-owned native Web Animation for one element.\n *\n * The returned handle cancels its native animation when disposed. By default, the\n * operating system's reduced-motion preference suppresses movement.\n */\nexport function animate(element: Element, keyframes: Keyframes, options: AnimateOptions = {}): AnimationHandle {\n  if (options.signal?.aborted) throw options.signal.reason;\n\n  if (typeof element.animate !== 'function') {\n    throw new NecromancerUnsupportedError('The Web Animations API is not available in this environment.');\n  }\n\n  const reduced = shouldReduceMotion(options.motion ?? 'system');\n  const nativeAnimation = element.animate(\n    keyframes as Keyframe[] | PropertyIndexedKeyframes,\n    resolveAnimationOptions(options, reduced),\n  );\n  return createAnimationHandle(nativeAnimation, options.signal, reduced);\n}\n","/** Deduplicates elements while preserving first-seen order. Shared by `animateEach()` and `captureLayout()`. */\nexport function uniqueElements<ElementType extends Element>(elements: Iterable<ElementType>): ElementType[] {\n  return [...new Set(elements)];\n}\n","import { uniqueElements } from './_elements';\nimport { createAnimationGroup } from './_handle';\nimport { animate } from './animate';\nimport { NecromancerConfigError } from './errors';\nimport { withStaggeredDelay } from './motion';\nimport type { AnimateEachOptions, AnimationGroup, AnimationHandle, KeyframeFactory, Keyframes } from './types';\n\nfunction validateStagger(stagger: number): void {\n  if (!Number.isFinite(stagger) || stagger < 0) {\n    throw new NecromancerConfigError('stagger must be a finite, non-negative number.');\n  }\n}\n\n/**\n * Starts lifecycle-owned animations for unique elements in iteration order.\n *\n * Each subsequent element starts after `stagger` milliseconds. A keyframe factory\n * receives the stable unique-element index and total before any animation starts.\n */\nexport function animateEach<ElementType extends Element>(\n  elements: Iterable<ElementType>,\n  keyframes: Keyframes | KeyframeFactory<ElementType>,\n  options: AnimateEachOptions = {},\n): AnimationGroup {\n  const { signal, stagger = 0, ...animationOptions } = options;\n\n  validateStagger(stagger);\n\n  if (signal?.aborted) throw signal.reason;\n\n  const unique = uniqueElements(elements);\n  const frames = unique.map((element, index) =>\n    typeof keyframes === 'function' ? keyframes(element, index, unique.length) : keyframes,\n  );\n\n  if (signal?.aborted) throw signal.reason;\n\n  const handles: AnimationHandle[] = [];\n\n  try {\n    for (const [index, element] of unique.entries()) {\n      // `frames` was built above from `unique`, one entry per element, so this index is always in range.\n      const currentFrames = frames[index]!;\n\n      handles.push(animate(element, currentFrames, withStaggeredDelay(animationOptions, index * stagger)));\n    }\n  } catch (error) {\n    for (const handle of handles) handle.dispose(error);\n\n    throw error;\n  }\n\n  return createAnimationGroup(handles, signal);\n}\n","import { uniqueElements } from './_elements';\nimport { animateEach } from './animate-each';\nimport { NecromancerConfigError } from './errors';\nimport type { LayoutAnimationOptions, LayoutCaptureOptions, LayoutTransition } from './types';\n\ntype LayoutRect = Readonly<Pick<DOMRectReadOnly, 'height' | 'width' | 'x' | 'y'>>;\ntype LayoutEntry<ElementType extends Element> = Readonly<{ element: ElementType; rect: LayoutRect }>;\ntype LayoutChange<ElementType extends Element> = Readonly<{\n  element: ElementType;\n  scaleX: number;\n  scaleY: number;\n  x: number;\n  y: number;\n}>;\n\n// Rounds before templating into a keyframe string purely for DevTools readability — a `getBoundingClientRect()`\n// subtraction routinely produces values like `12.340000000000002`, which is noise once rendered as CSS.\n// Pixels only need whole-number precision; scale factors (close to 1) need finer precision to stay visually exact.\nfunction round(value: number, precision: number): number {\n  const factor = 10 ** precision;\n\n  return Math.round(value * factor) / factor;\n}\n\n// `getBoundingClientRect()`'s width/height is the rotated, axis-aligned bounding box — using it\n// for size would distort the scale ratio under any rotation. `offsetWidth`/`offsetHeight` report\n// the box's own untransformed layout size instead. Elements without an offset box (e.g. SVG)\n// fall back to the bounding rect, accepting that same distortion as the only option available.\nfunction measureSize(element: Element): Readonly<{ height: number; width: number }> {\n  if ('offsetWidth' in element && 'offsetHeight' in element) {\n    return { height: (element as HTMLElement).offsetHeight, width: (element as HTMLElement).offsetWidth };\n  }\n\n  const rect = element.getBoundingClientRect();\n\n  return { height: rect.height, width: rect.width };\n}\n\nfunction measureLayout(element: Element): LayoutRect {\n  const rect = element.getBoundingClientRect();\n  const size = measureSize(element);\n\n  return { height: size.height, width: size.width, x: rect.x, y: rect.y };\n}\n\n// `next` is 0 exactly when the element has collapsed (e.g. `display: none` mid-transition);\n// there's no meaningful ratio to compute then, so treat it as unscaled rather than producing Infinity/NaN.\nfunction computeScale(captured: number, next: number): number {\n  return next === 0 ? 1 : captured / next;\n}\n\nfunction readKey<ElementType extends Element>(\n  element: ElementType,\n  getKey: (element: ElementType) => string,\n  phase: string,\n): string {\n  const key = getKey(element);\n\n  if (typeof key !== 'string' || key.length === 0) {\n    throw new NecromancerConfigError(`getKey must return a non-empty string for every ${phase} element.`);\n  }\n\n  return key;\n}\n\nfunction createKeyMap<ElementType extends Element>(\n  entries: readonly LayoutEntry<ElementType>[],\n  getKey: (element: ElementType) => string,\n  phase: string,\n) {\n  const keys = new Map<string, LayoutEntry<ElementType>>();\n\n  for (const entry of entries) {\n    const key = readKey(entry.element, getKey, phase);\n\n    if (keys.has(key)) {\n      throw new NecromancerConfigError(`getKey returned duplicate keys for the ${phase} elements.`);\n    }\n\n    keys.set(key, entry);\n  }\n\n  return keys;\n}\n\nfunction changedElement<ElementType extends Element>(\n  element: ElementType,\n  rect: LayoutRect,\n): LayoutChange<ElementType> | undefined {\n  if (!element.isConnected) return undefined;\n\n  const next = measureLayout(element);\n  const x = rect.x - next.x;\n  const y = rect.y - next.y;\n  const scaleX = computeScale(rect.width, next.width);\n  const scaleY = computeScale(rect.height, next.height);\n\n  return x === 0 && y === 0 && scaleX === 1 && scaleY === 1 ? undefined : { element, scaleX, scaleY, x, y };\n}\n\nfunction matchByIdentity<ElementType extends Element>(\n  entries: readonly LayoutEntry<ElementType>[],\n  elements: readonly ElementType[],\n): LayoutChange<ElementType>[] {\n  const captured = new Map(entries.map((entry) => [entry.element, entry]));\n\n  return elements.flatMap((element) => {\n    const entry = captured.get(element);\n\n    return entry\n      ? [changedElement(element, entry.rect)].filter((change): change is LayoutChange<ElementType> => Boolean(change))\n      : [];\n  });\n}\n\nfunction matchByKey<ElementType extends Element>(\n  captured: ReadonlyMap<string, LayoutEntry<ElementType>>,\n  elements: readonly ElementType[],\n  getKey: (element: ElementType) => string,\n): LayoutChange<ElementType>[] {\n  const committed = new Set<string>();\n\n  return elements.flatMap((element) => {\n    const key = readKey(element, getKey, 'committed');\n    const entry = captured.get(key);\n\n    if (committed.has(key)) {\n      throw new NecromancerConfigError('getKey returned duplicate keys for the committed elements.');\n    }\n\n    committed.add(key);\n\n    return entry\n      ? [changedElement(element, entry.rect)].filter((change): change is LayoutChange<ElementType> => Boolean(change))\n      : [];\n  });\n}\n\n/**\n * Captures the current position and size of unique elements for a later FLIP animation.\n *\n * Each element's `x`/`y` position and `width`/`height` are captured. Rotation and other\n * transforms are not captured or compensated. Capture before mutating the DOM, then call\n * the returned transition's `animate()` method after the browser has applied the resulting\n * layout — position changes animate via translate, and size changes via scale, both\n * additively composed on top of any authored transform.\n */\nexport function captureLayout<ElementType extends Element>(\n  elements: Iterable<ElementType>,\n  options: LayoutCaptureOptions<ElementType> = {},\n): LayoutTransition<ElementType> {\n  const entries: LayoutEntry<ElementType>[] = uniqueElements(elements).map((element) => ({\n    element,\n    rect: measureLayout(element),\n  }));\n  const getKey = options.getKey;\n  const captured = getKey ? createKeyMap(entries, getKey, 'captured') : undefined;\n\n  let consumed = false;\n\n  return {\n    animate(options: LayoutAnimationOptions<ElementType> = {}) {\n      if (consumed) throw new NecromancerConfigError('This layout transition has already been animated.');\n\n      const { elements: committedElements, ...animationOptions } = options;\n      const elements = uniqueElements(committedElements ?? entries.map(({ element }) => element));\n      const changed = getKey && captured ? matchByKey(captured, elements, getKey) : matchByIdentity(entries, elements);\n\n      consumed = true;\n\n      return animateEach(\n        changed.map(({ element }) => element),\n        (_, index) => {\n          // `changed` was mapped directly into the elements array above, so this index is always in range.\n          const change = changed[index]!;\n          const translate = `${round(change.x, 2)}px ${round(change.y, 2)}px`;\n          const scale = `${round(change.scaleX, 4)} ${round(change.scaleY, 4)}`;\n\n          return [\n            { composite: 'add', scale, translate },\n            { composite: 'add', scale: '1 1', translate: '0px 0px' },\n          ];\n        },\n        animationOptions,\n      );\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/necromancer.iife.js

@@ -1,2 +1,2 @@
-var Necromancer=(function(e){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var t=new WeakMap;function n(e){for(let n of t.get(e)??[])n.dispose()}function r(e,n){let r=t.get(e);r||(r=new Set,t.set(e,r)),r.add(n),n.result.then(()=>{r?.delete(n),r?.size===0&&t.delete(e)})}function i(e,t){let n=()=>t(e.reason);return e.addEventListener(`abort`,n,{once:!0}),()=>e.removeEventListener(`abort`,n)}function a(e,t,n){return e.finished.then(()=>(t(),{status:n?`reduced`:`finished`}),e=>(t(),{reason:e,status:`cancelled`}))}function o(e,t,n=!1){let r=!1,o,s=!1,c,l=a(e,()=>{c?.(),c=void 0},n).then(e=>r&&s&&e.status===`cancelled`?{reason:o,status:`cancelled`}:e),u=t=>{r||(r=!0,o=t,s=t!==void 0,c?.(),c=void 0,e.cancel())};return t&&(c=i(t,u)),{animation:e,dispose:u,get disposed(){return r},result:l,[Symbol.dispose](){this.dispose()}}}function s(e,t){let n=!1,r,a=Promise.all(e.map(e=>e.result)).then(e=>(r?.(),r=void 0,e)),o=t=>{if(!n){n=!0,r?.(),r=void 0;for(let n of e)n.dispose(t)}};return t&&(r=i(t,o)),{dispose:o,get disposed(){return n},handles:e,results:a,[Symbol.dispose](){this.dispose()}}}var c=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},l=class extends c{},u=class extends c{},d=180;function f(e){return e===`full`?!1:e===`reduced`||typeof matchMedia==`function`&&matchMedia(`(prefers-reduced-motion: reduce)`).matches}function p(e={},t=!1){let{duration:n,interrupt:r,motion:i=`system`,signal:a,...o}=e,s=n===void 0?{...o,duration:d}:{...o,duration:n};return t?{...s,delay:0,duration:0,endDelay:0,iterations:1}:s}function m(e,t){if(t===0)return e;let n=e.delay??0;if(typeof n!=`number`)throw new l(`A non-zero stagger requires a numeric delay; received ${typeof n}.`);return{...e,delay:n+t}}function h(e,t,i={}){if(i.signal?.aborted)throw i.signal.reason;if(typeof e.animate!=`function`)throw new u(`The Web Animations API is not available in this environment.`);i.interrupt===`cancel`&&n(e);let a=f(i.motion??`system`),s=o(e.animate(t,p(i,a)),i.signal,a);return r(e,s),s}function g(e){return[...new Set(e)]}function _(e){if(!Number.isFinite(e)||e<0)throw new l(`stagger must be a finite, non-negative number.`)}function v(e,t,n={}){let{signal:r,stagger:i=0,...a}=n;if(_(i),r?.aborted)throw r.reason;let o=g(e),c=o.map((e,n)=>typeof t==`function`?t(e,n,o.length):t),l=[];try{for(let[e,t]of o.entries()){let n=c[e];l.push(h(t,n,m(a,e*i)))}}catch(e){for(let t of l)t.dispose(e);throw e}return s(l,r)}function y(e,t){let n=10**t;return Math.round(e*n)/n}function b(e){if(`offsetWidth`in e&&`offsetHeight`in e)return{height:e.offsetHeight,width:e.offsetWidth};let t=e.getBoundingClientRect();return{height:t.height,width:t.width}}function x(e){let t=e.getBoundingClientRect(),n=b(e);return{height:n.height,width:n.width,x:t.x,y:t.y}}function S(e,t){return t===0?1:e/t}function C(e,t,n){let r=t(e);if(typeof r!=`string`||r.length===0)throw new l(`getKey must return a non-empty string for every ${n} element.`);return r}function w(e,t,n){let r=new Map;for(let i of e){let e=C(i.element,t,n);if(r.has(e))throw new l(`getKey returned duplicate keys for the ${n} elements.`);r.set(e,i)}return r}function T(e,t){if(!e.isConnected)return;let n=x(e),r=t.x-n.x,i=t.y-n.y,a=S(t.width,n.width),o=S(t.height,n.height);return r===0&&i===0&&a===1&&o===1?void 0:{element:e,scaleX:a,scaleY:o,x:r,y:i}}function E(e,t){let n=new Map(e.map(e=>[e.element,e]));return t.flatMap(e=>{let t=n.get(e);return t?[T(e,t.rect)].filter(e=>!!e):[]})}function D(e,t,n){let r=new Set;return t.flatMap(t=>{let i=C(t,n,`committed`),a=e.get(i);if(r.has(i))throw new l(`getKey returned duplicate keys for the committed elements.`);return r.add(i),a?[T(t,a.rect)].filter(e=>!!e):[]})}function O(e,t={}){let n=g(e).map(e=>({element:e,rect:x(e)})),r=t.getKey,i=r?w(n,r,`captured`):void 0,a=!1;return{animate(e={}){if(a)throw new l(`This layout transition has already been animated.`);let{elements:t,...o}=e,s=g(t??n.map(({element:e})=>e)),c=r&&i?D(i,s,r):E(n,s);return a=!0,v(c.map(({element:e})=>e),(e,t)=>{let n=c[t],r=`${y(n.x,2)}px ${y(n.y,2)}px`;return[{composite:`add`,scale:`${y(n.scaleX,4)} ${y(n.scaleY,4)}`,translate:r},{composite:`add`,scale:`1 1`,translate:`0px 0px`}]},o)}}}return e.NecromancerConfigError=l,e.NecromancerError=c,e.NecromancerUnsupportedError=u,e.animate=h,e.animateEach=v,e.captureLayout=O,e})({});
+var Necromancer=(function(e){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});function attachAbortSignalListener(e,t){let abort=()=>t(e.reason);return e.addEventListener(`abort`,abort,{once:!0}),e.aborted?(e.removeEventListener(`abort`,abort),t(e.reason),()=>void 0):()=>e.removeEventListener(`abort`,abort)}function createResultPromise(e,t,n){return e.finished.then(()=>(t(),{status:n?`reduced`:`finished`}),e=>(t(),{reason:e,status:`cancelled`}))}function createAnimationHandle(e,t,n=!1){let r=!1,i,a=!1,o,s=createResultPromise(e,()=>{o?.(),o=void 0},n).then(e=>r&&a&&e.status===`cancelled`?{reason:i,status:`cancelled`}:e),dispose=t=>{r||(r=!0,i=t,a=t!==void 0,o?.(),o=void 0,e.cancel())};return t&&(o=attachAbortSignalListener(t,dispose)),{animation:e,dispose,get disposed(){return r},result:s,[Symbol.dispose](){this.dispose()}}}function createAnimationGroup(e,t){let n=!1,r,i=Promise.all(e.map(e=>e.result)).then(e=>(r?.(),r=void 0,e)),dispose=t=>{if(!n){n=!0,r?.(),r=void 0;for(let n of e)n.dispose(t)}};return t&&(r=attachAbortSignalListener(t,dispose)),{dispose,get disposed(){return n},handles:e,results:i,[Symbol.dispose](){this.dispose()}}}var NecromancerError=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},NecromancerConfigError=class extends NecromancerError{},NecromancerUnsupportedError=class extends NecromancerError{};function shouldReduceMotion(e){return e===`full`?!1:e===`reduced`||typeof matchMedia==`function`&&matchMedia(`(prefers-reduced-motion: reduce)`).matches}function resolveAnimationOptions(e={},t=!1){let{motion:n,signal:r,...i}=e;return t?{...i,delay:0,duration:0,endDelay:0,iterations:1}:i}function withStaggeredDelay(e,t){if(t===0)return e;let n=e.delay??0;if(typeof n!=`number`)throw new NecromancerConfigError(`A non-zero stagger requires a numeric delay; received ${typeof n}.`);return{...e,delay:n+t}}function animate(e,t,n={}){if(n.signal?.aborted)throw n.signal.reason;if(typeof e.animate!=`function`)throw new NecromancerUnsupportedError(`The Web Animations API is not available in this environment.`);let r=shouldReduceMotion(n.motion??`system`);return createAnimationHandle(e.animate(t,resolveAnimationOptions(n,r)),n.signal,r)}function uniqueElements(e){return[...new Set(e)]}function validateStagger(e){if(!Number.isFinite(e)||e<0)throw new NecromancerConfigError(`stagger must be a finite, non-negative number.`)}function animateEach(e,t,n={}){let{signal:r,stagger:i=0,...a}=n;if(validateStagger(i),r?.aborted)throw r.reason;let o=uniqueElements(e),s=o.map((e,n)=>typeof t==`function`?t(e,n,o.length):t);if(r?.aborted)throw r.reason;let c=[];try{for(let[e,t]of o.entries()){let n=s[e];c.push(animate(t,n,withStaggeredDelay(a,e*i)))}}catch(e){for(let t of c)t.dispose(e);throw e}return createAnimationGroup(c,r)}function round(e,t){let n=10**t;return Math.round(e*n)/n}function measureSize(e){if(`offsetWidth`in e&&`offsetHeight`in e)return{height:e.offsetHeight,width:e.offsetWidth};let t=e.getBoundingClientRect();return{height:t.height,width:t.width}}function measureLayout(e){let t=e.getBoundingClientRect(),n=measureSize(e);return{height:n.height,width:n.width,x:t.x,y:t.y}}function computeScale(e,t){return t===0?1:e/t}function readKey(e,t,n){let r=t(e);if(typeof r!=`string`||r.length===0)throw new NecromancerConfigError(`getKey must return a non-empty string for every ${n} element.`);return r}function createKeyMap(e,t,n){let r=new Map;for(let i of e){let e=readKey(i.element,t,n);if(r.has(e))throw new NecromancerConfigError(`getKey returned duplicate keys for the ${n} elements.`);r.set(e,i)}return r}function changedElement(e,t){if(!e.isConnected)return;let n=measureLayout(e),r=t.x-n.x,i=t.y-n.y,a=computeScale(t.width,n.width),o=computeScale(t.height,n.height);return r===0&&i===0&&a===1&&o===1?void 0:{element:e,scaleX:a,scaleY:o,x:r,y:i}}function matchByIdentity(e,t){let n=new Map(e.map(e=>[e.element,e]));return t.flatMap(e=>{let t=n.get(e);return t?[changedElement(e,t.rect)].filter(e=>!!e):[]})}function matchByKey(e,t,n){let r=new Set;return t.flatMap(t=>{let i=readKey(t,n,`committed`),a=e.get(i);if(r.has(i))throw new NecromancerConfigError(`getKey returned duplicate keys for the committed elements.`);return r.add(i),a?[changedElement(t,a.rect)].filter(e=>!!e):[]})}function captureLayout(e,t={}){let n=uniqueElements(e).map(e=>({element:e,rect:measureLayout(e)})),r=t.getKey,i=r?createKeyMap(n,r,`captured`):void 0,a=!1;return{animate(e={}){if(a)throw new NecromancerConfigError(`This layout transition has already been animated.`);let{elements:t,...o}=e,s=uniqueElements(t??n.map(({element:e})=>e)),c=r&&i?matchByKey(i,s,r):matchByIdentity(n,s);return a=!0,animateEach(c.map(({element:e})=>e),(e,t)=>{let n=c[t],r=`${round(n.x,2)}px ${round(n.y,2)}px`;return[{composite:`add`,scale:`${round(n.scaleX,4)} ${round(n.scaleY,4)}`,translate:r},{composite:`add`,scale:`1 1`,translate:`0px 0px`}]},o)}}}return e.NecromancerConfigError=NecromancerConfigError,e.NecromancerError=NecromancerError,e.NecromancerUnsupportedError=NecromancerUnsupportedError,e.animate=animate,e.animateEach=animateEach,e.captureLayout=captureLayout,e.shouldReduceMotion=shouldReduceMotion,e})({});
 //# sourceMappingURL=necromancer.iife.js.map

package/dist/necromancer.iife.js.map

@@ -1 +1 @@
-{"version":3,"file":"necromancer.iife.js","names":[],"sources":["../src/_active.ts","../src/_handle.ts","../src/errors.ts","../src/_motion.ts","../src/animate.ts","../src/_elements.ts","../src/animate-each.ts","../src/layout.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","import type { AnimationGroup, AnimationHandle, AnimationResult } from './types';\n\n/**\n * Attaches an abort listener to a signal and returns a function that removes it.\n * When the signal aborts, calls the dispose function with the signal's reason.\n */\nfunction attachAbortSignalListener(signal: AbortSignal, dispose: (reason?: unknown) => void): () => void {\n  const abort = () => dispose(signal.reason);\n\n  signal.addEventListener('abort', abort, { once: true });\n\n  return () => signal.removeEventListener('abort', abort);\n}\n\nfunction createResultPromise(animation: Animation, onSettled: () => void, reduced: boolean): Promise<AnimationResult> {\n  return animation.finished.then(\n    () => {\n      onSettled();\n\n      return { status: reduced ? 'reduced' : 'finished' };\n    },\n    (reason: unknown) => {\n      onSettled();\n\n      return { reason, status: 'cancelled' };\n    },\n  );\n}\n\n/** Wraps a native Animation with Necromancer's lifecycle contract. */\nexport function createAnimationHandle(animation: Animation, signal?: AbortSignal, reduced = false): AnimationHandle {\n  let disposed = false;\n  let disposeReason: unknown;\n  let hasDisposeReason = false;\n  let removeAbortListener: (() => void) | undefined;\n\n  const result: Promise<AnimationResult> = createResultPromise(\n    animation,\n    () => {\n      removeAbortListener?.();\n      removeAbortListener = undefined;\n    },\n    reduced,\n  ).then((outcome): AnimationResult => {\n    if (disposed && hasDisposeReason && outcome.status === 'cancelled') {\n      return { reason: disposeReason, status: 'cancelled' };\n    }\n\n    return outcome;\n  });\n\n  const dispose = (reason?: unknown): void => {\n    if (disposed) return;\n\n    disposed = true;\n    disposeReason = reason;\n    hasDisposeReason = reason !== undefined;\n    removeAbortListener?.();\n    removeAbortListener = undefined;\n    animation.cancel();\n  };\n\n  if (signal) {\n    removeAbortListener = attachAbortSignalListener(signal, dispose);\n  }\n\n  return {\n    animation,\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    result,\n    [Symbol.dispose]() {\n      this.dispose();\n    },\n  };\n}\n\n/** Combines child animation handles under one disposal owner. */\nexport function createAnimationGroup(handles: readonly AnimationHandle[], signal?: AbortSignal): AnimationGroup {\n  let disposed = false;\n  let removeAbortListener: (() => void) | undefined;\n\n  const results: Promise<readonly AnimationResult[]> = Promise.all(handles.map((handle) => handle.result)).then(\n    (childResults): readonly AnimationResult[] => {\n      removeAbortListener?.();\n      removeAbortListener = undefined;\n\n      return childResults;\n    },\n  );\n\n  const dispose = (reason?: unknown): void => {\n    if (disposed) return;\n\n    disposed = true;\n    removeAbortListener?.();\n    removeAbortListener = undefined;\n    for (const handle of handles) handle.dispose(reason);\n  };\n\n  if (signal) {\n    removeAbortListener = attachAbortSignalListener(signal, dispose);\n  }\n\n  return {\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    handles,\n    results,\n    [Symbol.dispose]() {\n      this.dispose();\n    },\n  };\n}\n","/** Base class for errors raised by `@vielzeug/necromancer`. */\nexport class NecromancerError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** Thrown when a Necromancer-owned option is invalid. */\nexport class NecromancerConfigError extends NecromancerError {}\n\n/** Thrown when the runtime does not implement the Web Animations API. */\nexport class NecromancerUnsupportedError extends NecromancerError {}\n","import { NecromancerConfigError } from './errors';\nimport type { AnimateOptions, MotionMode } from './types';\n\nconst DEFAULT_DURATION = 180;\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 { duration, interrupt: _interrupt, motion: _motion = 'system', signal: _signal, ...nativeOptions } = options;\n  const timing =\n    duration === undefined ? { ...nativeOptions, duration: DEFAULT_DURATION } : { ...nativeOptions, duration };\n\n  return reduced ? { ...timing, delay: 0, duration: 0, endDelay: 0, iterations: 1 } : timing;\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","import { interruptAnimations, trackAnimation } from './_active';\nimport { createAnimationHandle } from './_handle';\nimport { resolveAnimationOptions, shouldReduceMotion } from './_motion';\nimport { NecromancerUnsupportedError } from './errors';\nimport type { AnimateOptions, AnimationHandle, Keyframes } from './types';\n\n/**\n * Starts a lifecycle-owned native Web Animation for one element.\n *\n * The returned handle cancels its native animation when disposed. By default, the\n * operating system's reduced-motion preference suppresses movement.\n */\nexport function animate(element: Element, keyframes: Keyframes, options: AnimateOptions = {}): AnimationHandle {\n  if (options.signal?.aborted) throw options.signal.reason;\n\n  if (typeof element.animate !== 'function') {\n    throw new NecromancerUnsupportedError('The Web Animations API is not available in this environment.');\n  }\n\n  if (options.interrupt === 'cancel') interruptAnimations(element);\n\n  const reduced = shouldReduceMotion(options.motion ?? 'system');\n  const nativeAnimation = element.animate(\n    keyframes as Keyframe[] | PropertyIndexedKeyframes,\n    resolveAnimationOptions(options, reduced),\n  );\n  const handle = createAnimationHandle(nativeAnimation, options.signal, reduced);\n\n  trackAnimation(element, handle);\n\n  return handle;\n}\n","/** Deduplicates elements while preserving first-seen order. Shared by `animateEach()` and `captureLayout()`. */\nexport function uniqueElements(elements: Iterable<Element>): Element[] {\n  return [...new Set(elements)];\n}\n","import { uniqueElements } from './_elements';\nimport { createAnimationGroup } from './_handle';\nimport { withStaggeredDelay } from './_motion';\nimport { animate } from './animate';\nimport { NecromancerConfigError } from './errors';\nimport type { AnimateEachOptions, AnimationGroup, AnimationHandle, KeyframeFactory, Keyframes } from './types';\n\nfunction validateStagger(stagger: number): void {\n  if (!Number.isFinite(stagger) || stagger < 0) {\n    throw new NecromancerConfigError('stagger must be a finite, non-negative number.');\n  }\n}\n\n/**\n * Starts lifecycle-owned animations for unique elements in iteration order.\n *\n * Each subsequent element starts after `stagger` milliseconds. A keyframe factory\n * receives the stable unique-element index and total before any animation starts.\n */\nexport function animateEach(\n  elements: Iterable<Element>,\n  keyframes: Keyframes | KeyframeFactory,\n  options: AnimateEachOptions = {},\n): AnimationGroup {\n  const { signal, stagger = 0, ...animationOptions } = options;\n\n  validateStagger(stagger);\n\n  if (signal?.aborted) throw signal.reason;\n\n  const unique = uniqueElements(elements);\n  const frames = unique.map((element, index) =>\n    typeof keyframes === 'function' ? keyframes(element, index, unique.length) : keyframes,\n  );\n  const handles: AnimationHandle[] = [];\n\n  try {\n    for (const [index, element] of unique.entries()) {\n      // `frames` was built above from `unique`, one entry per element, so this index is always in range.\n      const currentFrames = frames[index]!;\n\n      handles.push(animate(element, currentFrames, withStaggeredDelay(animationOptions, index * stagger)));\n    }\n  } catch (error) {\n    for (const handle of handles) handle.dispose(error);\n\n    throw error;\n  }\n\n  return createAnimationGroup(handles, signal);\n}\n","import { uniqueElements } from './_elements';\nimport { animateEach } from './animate-each';\nimport { NecromancerConfigError } from './errors';\nimport type { LayoutAnimationOptions, LayoutCaptureOptions, LayoutTransition } from './types';\n\ntype LayoutRect = Readonly<Pick<DOMRectReadOnly, 'height' | 'width' | 'x' | 'y'>>;\ntype LayoutEntry = Readonly<{ element: Element; rect: LayoutRect }>;\ntype LayoutChange = Readonly<{ element: Element; scaleX: number; scaleY: number; x: number; y: number }>;\n\n// Rounds before templating into a keyframe string purely for DevTools readability — a `getBoundingClientRect()`\n// subtraction routinely produces values like `12.340000000000002`, which is noise once rendered as CSS.\n// Pixels only need whole-number precision; scale factors (close to 1) need finer precision to stay visually exact.\nfunction round(value: number, precision: number): number {\n  const factor = 10 ** precision;\n\n  return Math.round(value * factor) / factor;\n}\n\n// `getBoundingClientRect()`'s width/height is the rotated, axis-aligned bounding box — using it\n// for size would distort the scale ratio under any rotation. `offsetWidth`/`offsetHeight` report\n// the box's own untransformed layout size instead. Elements without an offset box (e.g. SVG)\n// fall back to the bounding rect, accepting that same distortion as the only option available.\nfunction measureSize(element: Element): Readonly<{ height: number; width: number }> {\n  if ('offsetWidth' in element && 'offsetHeight' in element) {\n    return { height: (element as HTMLElement).offsetHeight, width: (element as HTMLElement).offsetWidth };\n  }\n\n  const rect = element.getBoundingClientRect();\n\n  return { height: rect.height, width: rect.width };\n}\n\nfunction measureLayout(element: Element): LayoutRect {\n  const rect = element.getBoundingClientRect();\n  const size = measureSize(element);\n\n  return { height: size.height, width: size.width, x: rect.x, y: rect.y };\n}\n\n// `next` is 0 exactly when the element has collapsed (e.g. `display: none` mid-transition);\n// there's no meaningful ratio to compute then, so treat it as unscaled rather than producing Infinity/NaN.\nfunction computeScale(captured: number, next: number): number {\n  return next === 0 ? 1 : captured / next;\n}\n\nfunction readKey(element: Element, getKey: (element: Element) => string, phase: string): string {\n  const key = getKey(element);\n\n  if (typeof key !== 'string' || key.length === 0) {\n    throw new NecromancerConfigError(`getKey must return a non-empty string for every ${phase} element.`);\n  }\n\n  return key;\n}\n\nfunction createKeyMap(entries: readonly LayoutEntry[], getKey: (element: Element) => string, phase: string) {\n  const keys = new Map<string, LayoutEntry>();\n\n  for (const entry of entries) {\n    const key = readKey(entry.element, getKey, phase);\n\n    if (keys.has(key)) {\n      throw new NecromancerConfigError(`getKey returned duplicate keys for the ${phase} elements.`);\n    }\n\n    keys.set(key, entry);\n  }\n\n  return keys;\n}\n\nfunction changedElement(element: Element, rect: LayoutRect): LayoutChange | undefined {\n  if (!element.isConnected) return undefined;\n\n  const next = measureLayout(element);\n  const x = rect.x - next.x;\n  const y = rect.y - next.y;\n  const scaleX = computeScale(rect.width, next.width);\n  const scaleY = computeScale(rect.height, next.height);\n\n  return x === 0 && y === 0 && scaleX === 1 && scaleY === 1 ? undefined : { element, scaleX, scaleY, x, y };\n}\n\nfunction matchByIdentity(entries: readonly LayoutEntry[], elements: readonly Element[]): LayoutChange[] {\n  const captured = new Map(entries.map((entry) => [entry.element, entry]));\n\n  return elements.flatMap((element) => {\n    const entry = captured.get(element);\n\n    return entry\n      ? [changedElement(element, entry.rect)].filter((change): change is LayoutChange => Boolean(change))\n      : [];\n  });\n}\n\nfunction matchByKey(\n  captured: ReadonlyMap<string, LayoutEntry>,\n  elements: readonly Element[],\n  getKey: (element: Element) => string,\n): LayoutChange[] {\n  const committed = new Set<string>();\n\n  return elements.flatMap((element) => {\n    const key = readKey(element, getKey, 'committed');\n    const entry = captured.get(key);\n\n    if (committed.has(key)) {\n      throw new NecromancerConfigError('getKey returned duplicate keys for the committed elements.');\n    }\n\n    committed.add(key);\n\n    return entry\n      ? [changedElement(element, entry.rect)].filter((change): change is LayoutChange => Boolean(change))\n      : [];\n  });\n}\n\n/**\n * Captures the current position and size of unique elements for a later FLIP animation.\n *\n * Each element's `x`/`y` position and `width`/`height` are captured. Rotation and other\n * transforms are not captured or compensated. Capture before mutating the DOM, then call\n * the returned transition's `animate()` method after the browser has applied the resulting\n * layout — position changes animate via translate, and size changes via scale, both\n * additively composed on top of any authored transform.\n */\nexport function captureLayout(elements: Iterable<Element>, options: LayoutCaptureOptions = {}): LayoutTransition {\n  const entries: LayoutEntry[] = uniqueElements(elements).map((element) => ({\n    element,\n    rect: measureLayout(element),\n  }));\n  const getKey = options.getKey;\n  const captured = getKey ? createKeyMap(entries, getKey, 'captured') : undefined;\n\n  let consumed = false;\n\n  return {\n    animate(options: LayoutAnimationOptions = {}) {\n      if (consumed) throw new NecromancerConfigError('This layout transition has already been animated.');\n\n      const { elements: committedElements, ...animationOptions } = options;\n      const elements = uniqueElements(committedElements ?? entries.map(({ element }) => element));\n      const changed = getKey && captured ? matchByKey(captured, elements, getKey) : matchByIdentity(entries, elements);\n\n      consumed = true;\n\n      return animateEach(\n        changed.map(({ element }) => element),\n        (_, index) => {\n          // `changed` was mapped directly into the elements array above, so this index is always in range.\n          const change = changed[index]!;\n          const translate = `${round(change.x, 2)}px ${round(change.y, 2)}px`;\n          const scale = `${round(change.scaleX, 4)} ${round(change.scaleY, 4)}`;\n\n          return [\n            { composite: 'add', scale, translate },\n            { composite: 'add', scale: '1 1', translate: '0px 0px' },\n          ];\n        },\n        animationOptions,\n      );\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"necromancer.iife.js","names":[],"sources":["../src/_handle.ts","../src/errors.ts","../src/motion.ts","../src/animate.ts","../src/_elements.ts","../src/animate-each.ts","../src/layout.ts"],"sourcesContent":["import type { AnimationGroup, AnimationHandle, AnimationResult } from './types';\n\n/**\n * Attaches an abort listener to a signal and returns a function that removes it.\n * When the signal aborts, calls the dispose function with the signal's reason.\n */\nfunction attachAbortSignalListener(signal: AbortSignal, dispose: (reason?: unknown) => void): () => void {\n  const abort = () => dispose(signal.reason);\n\n  signal.addEventListener('abort', abort, { once: true });\n\n  if (signal.aborted) {\n    signal.removeEventListener('abort', abort);\n    dispose(signal.reason);\n    return () => undefined;\n  }\n\n  return () => signal.removeEventListener('abort', abort);\n}\n\nfunction createResultPromise(animation: Animation, onSettled: () => void, reduced: boolean): Promise<AnimationResult> {\n  return animation.finished.then(\n    () => {\n      onSettled();\n\n      return { status: reduced ? 'reduced' : 'finished' };\n    },\n    (reason: unknown) => {\n      onSettled();\n\n      return { reason, status: 'cancelled' };\n    },\n  );\n}\n\n/** Wraps a native Animation with Necromancer's lifecycle contract. */\nexport function createAnimationHandle(animation: Animation, signal?: AbortSignal, reduced = false): AnimationHandle {\n  let disposed = false;\n  let disposeReason: unknown;\n  let hasDisposeReason = false;\n  let removeAbortListener: (() => void) | undefined;\n\n  const result: Promise<AnimationResult> = createResultPromise(\n    animation,\n    () => {\n      removeAbortListener?.();\n      removeAbortListener = undefined;\n    },\n    reduced,\n  ).then((outcome): AnimationResult => {\n    if (disposed && hasDisposeReason && outcome.status === 'cancelled') {\n      return { reason: disposeReason, status: 'cancelled' };\n    }\n\n    return outcome;\n  });\n\n  const dispose = (reason?: unknown): void => {\n    if (disposed) return;\n\n    disposed = true;\n    disposeReason = reason;\n    hasDisposeReason = reason !== undefined;\n    removeAbortListener?.();\n    removeAbortListener = undefined;\n    animation.cancel();\n  };\n\n  if (signal) {\n    removeAbortListener = attachAbortSignalListener(signal, dispose);\n  }\n\n  return {\n    animation,\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    result,\n    [Symbol.dispose]() {\n      this.dispose();\n    },\n  };\n}\n\n/** Combines child animation handles under one disposal owner. */\nexport function createAnimationGroup(handles: readonly AnimationHandle[], signal?: AbortSignal): AnimationGroup {\n  let disposed = false;\n  let removeAbortListener: (() => void) | undefined;\n\n  const results: Promise<readonly AnimationResult[]> = Promise.all(handles.map((handle) => handle.result)).then(\n    (childResults): readonly AnimationResult[] => {\n      removeAbortListener?.();\n      removeAbortListener = undefined;\n\n      return childResults;\n    },\n  );\n\n  const dispose = (reason?: unknown): void => {\n    if (disposed) return;\n\n    disposed = true;\n    removeAbortListener?.();\n    removeAbortListener = undefined;\n    for (const handle of handles) handle.dispose(reason);\n  };\n\n  if (signal) {\n    removeAbortListener = attachAbortSignalListener(signal, dispose);\n  }\n\n  return {\n    dispose,\n    get disposed() {\n      return disposed;\n    },\n    handles,\n    results,\n    [Symbol.dispose]() {\n      this.dispose();\n    },\n  };\n}\n","/** Base class for errors raised by `@vielzeug/necromancer`. */\nexport class NecromancerError extends Error {\n  constructor(message: string, opts?: ErrorOptions) {\n    super(message, opts);\n    this.name = new.target.name;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\n/** Thrown when a Necromancer-owned option is invalid. */\nexport class NecromancerConfigError extends NecromancerError {}\n\n/** Thrown when the runtime does not implement the Web Animations API. */\nexport class NecromancerUnsupportedError extends NecromancerError {}\n","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","import { createAnimationHandle } from './_handle';\nimport { NecromancerUnsupportedError } from './errors';\nimport { resolveAnimationOptions, shouldReduceMotion } from './motion';\nimport type { AnimateOptions, AnimationHandle, Keyframes } from './types';\n\n/**\n * Starts a lifecycle-owned native Web Animation for one element.\n *\n * The returned handle cancels its native animation when disposed. By default, the\n * operating system's reduced-motion preference suppresses movement.\n */\nexport function animate(element: Element, keyframes: Keyframes, options: AnimateOptions = {}): AnimationHandle {\n  if (options.signal?.aborted) throw options.signal.reason;\n\n  if (typeof element.animate !== 'function') {\n    throw new NecromancerUnsupportedError('The Web Animations API is not available in this environment.');\n  }\n\n  const reduced = shouldReduceMotion(options.motion ?? 'system');\n  const nativeAnimation = element.animate(\n    keyframes as Keyframe[] | PropertyIndexedKeyframes,\n    resolveAnimationOptions(options, reduced),\n  );\n  return createAnimationHandle(nativeAnimation, options.signal, reduced);\n}\n","/** Deduplicates elements while preserving first-seen order. Shared by `animateEach()` and `captureLayout()`. */\nexport function uniqueElements<ElementType extends Element>(elements: Iterable<ElementType>): ElementType[] {\n  return [...new Set(elements)];\n}\n","import { uniqueElements } from './_elements';\nimport { createAnimationGroup } from './_handle';\nimport { animate } from './animate';\nimport { NecromancerConfigError } from './errors';\nimport { withStaggeredDelay } from './motion';\nimport type { AnimateEachOptions, AnimationGroup, AnimationHandle, KeyframeFactory, Keyframes } from './types';\n\nfunction validateStagger(stagger: number): void {\n  if (!Number.isFinite(stagger) || stagger < 0) {\n    throw new NecromancerConfigError('stagger must be a finite, non-negative number.');\n  }\n}\n\n/**\n * Starts lifecycle-owned animations for unique elements in iteration order.\n *\n * Each subsequent element starts after `stagger` milliseconds. A keyframe factory\n * receives the stable unique-element index and total before any animation starts.\n */\nexport function animateEach<ElementType extends Element>(\n  elements: Iterable<ElementType>,\n  keyframes: Keyframes | KeyframeFactory<ElementType>,\n  options: AnimateEachOptions = {},\n): AnimationGroup {\n  const { signal, stagger = 0, ...animationOptions } = options;\n\n  validateStagger(stagger);\n\n  if (signal?.aborted) throw signal.reason;\n\n  const unique = uniqueElements(elements);\n  const frames = unique.map((element, index) =>\n    typeof keyframes === 'function' ? keyframes(element, index, unique.length) : keyframes,\n  );\n\n  if (signal?.aborted) throw signal.reason;\n\n  const handles: AnimationHandle[] = [];\n\n  try {\n    for (const [index, element] of unique.entries()) {\n      // `frames` was built above from `unique`, one entry per element, so this index is always in range.\n      const currentFrames = frames[index]!;\n\n      handles.push(animate(element, currentFrames, withStaggeredDelay(animationOptions, index * stagger)));\n    }\n  } catch (error) {\n    for (const handle of handles) handle.dispose(error);\n\n    throw error;\n  }\n\n  return createAnimationGroup(handles, signal);\n}\n","import { uniqueElements } from './_elements';\nimport { animateEach } from './animate-each';\nimport { NecromancerConfigError } from './errors';\nimport type { LayoutAnimationOptions, LayoutCaptureOptions, LayoutTransition } from './types';\n\ntype LayoutRect = Readonly<Pick<DOMRectReadOnly, 'height' | 'width' | 'x' | 'y'>>;\ntype LayoutEntry<ElementType extends Element> = Readonly<{ element: ElementType; rect: LayoutRect }>;\ntype LayoutChange<ElementType extends Element> = Readonly<{\n  element: ElementType;\n  scaleX: number;\n  scaleY: number;\n  x: number;\n  y: number;\n}>;\n\n// Rounds before templating into a keyframe string purely for DevTools readability — a `getBoundingClientRect()`\n// subtraction routinely produces values like `12.340000000000002`, which is noise once rendered as CSS.\n// Pixels only need whole-number precision; scale factors (close to 1) need finer precision to stay visually exact.\nfunction round(value: number, precision: number): number {\n  const factor = 10 ** precision;\n\n  return Math.round(value * factor) / factor;\n}\n\n// `getBoundingClientRect()`'s width/height is the rotated, axis-aligned bounding box — using it\n// for size would distort the scale ratio under any rotation. `offsetWidth`/`offsetHeight` report\n// the box's own untransformed layout size instead. Elements without an offset box (e.g. SVG)\n// fall back to the bounding rect, accepting that same distortion as the only option available.\nfunction measureSize(element: Element): Readonly<{ height: number; width: number }> {\n  if ('offsetWidth' in element && 'offsetHeight' in element) {\n    return { height: (element as HTMLElement).offsetHeight, width: (element as HTMLElement).offsetWidth };\n  }\n\n  const rect = element.getBoundingClientRect();\n\n  return { height: rect.height, width: rect.width };\n}\n\nfunction measureLayout(element: Element): LayoutRect {\n  const rect = element.getBoundingClientRect();\n  const size = measureSize(element);\n\n  return { height: size.height, width: size.width, x: rect.x, y: rect.y };\n}\n\n// `next` is 0 exactly when the element has collapsed (e.g. `display: none` mid-transition);\n// there's no meaningful ratio to compute then, so treat it as unscaled rather than producing Infinity/NaN.\nfunction computeScale(captured: number, next: number): number {\n  return next === 0 ? 1 : captured / next;\n}\n\nfunction readKey<ElementType extends Element>(\n  element: ElementType,\n  getKey: (element: ElementType) => string,\n  phase: string,\n): string {\n  const key = getKey(element);\n\n  if (typeof key !== 'string' || key.length === 0) {\n    throw new NecromancerConfigError(`getKey must return a non-empty string for every ${phase} element.`);\n  }\n\n  return key;\n}\n\nfunction createKeyMap<ElementType extends Element>(\n  entries: readonly LayoutEntry<ElementType>[],\n  getKey: (element: ElementType) => string,\n  phase: string,\n) {\n  const keys = new Map<string, LayoutEntry<ElementType>>();\n\n  for (const entry of entries) {\n    const key = readKey(entry.element, getKey, phase);\n\n    if (keys.has(key)) {\n      throw new NecromancerConfigError(`getKey returned duplicate keys for the ${phase} elements.`);\n    }\n\n    keys.set(key, entry);\n  }\n\n  return keys;\n}\n\nfunction changedElement<ElementType extends Element>(\n  element: ElementType,\n  rect: LayoutRect,\n): LayoutChange<ElementType> | undefined {\n  if (!element.isConnected) return undefined;\n\n  const next = measureLayout(element);\n  const x = rect.x - next.x;\n  const y = rect.y - next.y;\n  const scaleX = computeScale(rect.width, next.width);\n  const scaleY = computeScale(rect.height, next.height);\n\n  return x === 0 && y === 0 && scaleX === 1 && scaleY === 1 ? undefined : { element, scaleX, scaleY, x, y };\n}\n\nfunction matchByIdentity<ElementType extends Element>(\n  entries: readonly LayoutEntry<ElementType>[],\n  elements: readonly ElementType[],\n): LayoutChange<ElementType>[] {\n  const captured = new Map(entries.map((entry) => [entry.element, entry]));\n\n  return elements.flatMap((element) => {\n    const entry = captured.get(element);\n\n    return entry\n      ? [changedElement(element, entry.rect)].filter((change): change is LayoutChange<ElementType> => Boolean(change))\n      : [];\n  });\n}\n\nfunction matchByKey<ElementType extends Element>(\n  captured: ReadonlyMap<string, LayoutEntry<ElementType>>,\n  elements: readonly ElementType[],\n  getKey: (element: ElementType) => string,\n): LayoutChange<ElementType>[] {\n  const committed = new Set<string>();\n\n  return elements.flatMap((element) => {\n    const key = readKey(element, getKey, 'committed');\n    const entry = captured.get(key);\n\n    if (committed.has(key)) {\n      throw new NecromancerConfigError('getKey returned duplicate keys for the committed elements.');\n    }\n\n    committed.add(key);\n\n    return entry\n      ? [changedElement(element, entry.rect)].filter((change): change is LayoutChange<ElementType> => Boolean(change))\n      : [];\n  });\n}\n\n/**\n * Captures the current position and size of unique elements for a later FLIP animation.\n *\n * Each element's `x`/`y` position and `width`/`height` are captured. Rotation and other\n * transforms are not captured or compensated. Capture before mutating the DOM, then call\n * the returned transition's `animate()` method after the browser has applied the resulting\n * layout — position changes animate via translate, and size changes via scale, both\n * additively composed on top of any authored transform.\n */\nexport function captureLayout<ElementType extends Element>(\n  elements: Iterable<ElementType>,\n  options: LayoutCaptureOptions<ElementType> = {},\n): LayoutTransition<ElementType> {\n  const entries: LayoutEntry<ElementType>[] = uniqueElements(elements).map((element) => ({\n    element,\n    rect: measureLayout(element),\n  }));\n  const getKey = options.getKey;\n  const captured = getKey ? createKeyMap(entries, getKey, 'captured') : undefined;\n\n  let consumed = false;\n\n  return {\n    animate(options: LayoutAnimationOptions<ElementType> = {}) {\n      if (consumed) throw new NecromancerConfigError('This layout transition has already been animated.');\n\n      const { elements: committedElements, ...animationOptions } = options;\n      const elements = uniqueElements(committedElements ?? entries.map(({ element }) => element));\n      const changed = getKey && captured ? matchByKey(captured, elements, getKey) : matchByIdentity(entries, elements);\n\n      consumed = true;\n\n      return animateEach(\n        changed.map(({ element }) => element),\n        (_, index) => {\n          // `changed` was mapped directly into the elements array above, so this index is always in range.\n          const change = changed[index]!;\n          const translate = `${round(change.x, 2)}px ${round(change.y, 2)}px`;\n          const scale = `${round(change.scaleX, 4)} ${round(change.scaleY, 4)}`;\n\n          return [\n            { composite: 'add', scale, translate },\n            { composite: 'add', scale: '1 1', translate: '0px 0px' },\n          ];\n        },\n        animationOptions,\n      );\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/necromancer.js

@@ -1,2 +1,2 @@
-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)})}function r(e,t){let n=()=>t(e.reason);return e.addEventListener(`abort`,n,{once:!0}),()=>e.removeEventListener(`abort`,n)}function i(e,t,n){return e.finished.then(()=>(t(),{status:n?`reduced`:`finished`}),e=>(t(),{reason:e,status:`cancelled`}))}function a(e,t,n=!1){let a=!1,o,s=!1,c,l=i(e,()=>{c?.(),c=void 0},n).then(e=>a&&s&&e.status===`cancelled`?{reason:o,status:`cancelled`}:e),u=t=>{a||(a=!0,o=t,s=t!==void 0,c?.(),c=void 0,e.cancel())};return t&&(c=r(t,u)),{animation:e,dispose:u,get disposed(){return a},result:l,[Symbol.dispose](){this.dispose()}}}function o(e,t){let n=!1,i,a=Promise.all(e.map(e=>e.result)).then(e=>(i?.(),i=void 0,e)),o=t=>{if(!n){n=!0,i?.(),i=void 0;for(let n of e)n.dispose(t)}};return t&&(i=r(t,o)),{dispose:o,get disposed(){return n},handles:e,results:a,[Symbol.dispose](){this.dispose()}}}var s=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},c=class extends s{},l=class extends s{},u=180;function d(e){return e===`full`?!1:e===`reduced`||typeof matchMedia==`function`&&matchMedia(`(prefers-reduced-motion: reduce)`).matches}function f(e={},t=!1){let{duration:n,interrupt:r,motion:i=`system`,signal:a,...o}=e,s=n===void 0?{...o,duration:u}:{...o,duration:n};return t?{...s,delay:0,duration:0,endDelay:0,iterations:1}:s}function p(e,t){if(t===0)return e;let n=e.delay??0;if(typeof n!=`number`)throw new c(`A non-zero stagger requires a numeric delay; received ${typeof n}.`);return{...e,delay:n+t}}function m(e,r,i={}){if(i.signal?.aborted)throw i.signal.reason;if(typeof e.animate!=`function`)throw new l(`The Web Animations API is not available in this environment.`);i.interrupt===`cancel`&&t(e);let o=d(i.motion??`system`),s=a(e.animate(r,f(i,o)),i.signal,o);return n(e,s),s}function h(e){return[...new Set(e)]}function g(e){if(!Number.isFinite(e)||e<0)throw new c(`stagger must be a finite, non-negative number.`)}function _(e,t,n={}){let{signal:r,stagger:i=0,...a}=n;if(g(i),r?.aborted)throw r.reason;let s=h(e),c=s.map((e,n)=>typeof t==`function`?t(e,n,s.length):t),l=[];try{for(let[e,t]of s.entries()){let n=c[e];l.push(m(t,n,p(a,e*i)))}}catch(e){for(let t of l)t.dispose(e);throw e}return o(l,r)}function v(e,t){let n=10**t;return Math.round(e*n)/n}function y(e){if(`offsetWidth`in e&&`offsetHeight`in e)return{height:e.offsetHeight,width:e.offsetWidth};let t=e.getBoundingClientRect();return{height:t.height,width:t.width}}function b(e){let t=e.getBoundingClientRect(),n=y(e);return{height:n.height,width:n.width,x:t.x,y:t.y}}function x(e,t){return t===0?1:e/t}function S(e,t,n){let r=t(e);if(typeof r!=`string`||r.length===0)throw new c(`getKey must return a non-empty string for every ${n} element.`);return r}function C(e,t,n){let r=new Map;for(let i of e){let e=S(i.element,t,n);if(r.has(e))throw new c(`getKey returned duplicate keys for the ${n} elements.`);r.set(e,i)}return r}function w(e,t){if(!e.isConnected)return;let n=b(e),r=t.x-n.x,i=t.y-n.y,a=x(t.width,n.width),o=x(t.height,n.height);return r===0&&i===0&&a===1&&o===1?void 0:{element:e,scaleX:a,scaleY:o,x:r,y:i}}function T(e,t){let n=new Map(e.map(e=>[e.element,e]));return t.flatMap(e=>{let t=n.get(e);return t?[w(e,t.rect)].filter(e=>!!e):[]})}function E(e,t,n){let r=new Set;return t.flatMap(t=>{let i=S(t,n,`committed`),a=e.get(i);if(r.has(i))throw new c(`getKey returned duplicate keys for the committed elements.`);return r.add(i),a?[w(t,a.rect)].filter(e=>!!e):[]})}function D(e,t={}){let n=h(e).map(e=>({element:e,rect:b(e)})),r=t.getKey,i=r?C(n,r,`captured`):void 0,a=!1;return{animate(e={}){if(a)throw new c(`This layout transition has already been animated.`);let{elements:t,...o}=e,s=h(t??n.map(({element:e})=>e)),l=r&&i?E(i,s,r):T(n,s);return a=!0,_(l.map(({element:e})=>e),(e,t)=>{let n=l[t],r=`${v(n.x,2)}px ${v(n.y,2)}px`;return[{composite:`add`,scale:`${v(n.scaleX,4)} ${v(n.scaleY,4)}`,translate:r},{composite:`add`,scale:`1 1`,translate:`0px 0px`}]},o)}}}export{c as NecromancerConfigError,s as NecromancerError,l as NecromancerUnsupportedError,m as animate,_ as animateEach,D as captureLayout};
+function attachAbortSignalListener(e,t){let abort=()=>t(e.reason);return e.addEventListener(`abort`,abort,{once:!0}),e.aborted?(e.removeEventListener(`abort`,abort),t(e.reason),()=>void 0):()=>e.removeEventListener(`abort`,abort)}function createResultPromise(e,t,n){return e.finished.then(()=>(t(),{status:n?`reduced`:`finished`}),e=>(t(),{reason:e,status:`cancelled`}))}function createAnimationHandle(e,t,n=!1){let r=!1,i,a=!1,o,s=createResultPromise(e,()=>{o?.(),o=void 0},n).then(e=>r&&a&&e.status===`cancelled`?{reason:i,status:`cancelled`}:e),dispose=t=>{r||(r=!0,i=t,a=t!==void 0,o?.(),o=void 0,e.cancel())};return t&&(o=attachAbortSignalListener(t,dispose)),{animation:e,dispose,get disposed(){return r},result:s,[Symbol.dispose](){this.dispose()}}}function createAnimationGroup(e,t){let n=!1,r,i=Promise.all(e.map(e=>e.result)).then(e=>(r?.(),r=void 0,e)),dispose=t=>{if(!n){n=!0,r?.(),r=void 0;for(let n of e)n.dispose(t)}};return t&&(r=attachAbortSignalListener(t,dispose)),{dispose,get disposed(){return n},handles:e,results:i,[Symbol.dispose](){this.dispose()}}}var NecromancerError=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},NecromancerConfigError=class extends NecromancerError{},NecromancerUnsupportedError=class extends NecromancerError{};function shouldReduceMotion(e){return e===`full`?!1:e===`reduced`||typeof matchMedia==`function`&&matchMedia(`(prefers-reduced-motion: reduce)`).matches}function resolveAnimationOptions(e={},t=!1){let{motion:n,signal:r,...i}=e;return t?{...i,delay:0,duration:0,endDelay:0,iterations:1}:i}function withStaggeredDelay(e,t){if(t===0)return e;let n=e.delay??0;if(typeof n!=`number`)throw new NecromancerConfigError(`A non-zero stagger requires a numeric delay; received ${typeof n}.`);return{...e,delay:n+t}}function animate(e,t,n={}){if(n.signal?.aborted)throw n.signal.reason;if(typeof e.animate!=`function`)throw new NecromancerUnsupportedError(`The Web Animations API is not available in this environment.`);let r=shouldReduceMotion(n.motion??`system`);return createAnimationHandle(e.animate(t,resolveAnimationOptions(n,r)),n.signal,r)}function uniqueElements(e){return[...new Set(e)]}function validateStagger(e){if(!Number.isFinite(e)||e<0)throw new NecromancerConfigError(`stagger must be a finite, non-negative number.`)}function animateEach(e,t,n={}){let{signal:r,stagger:i=0,...a}=n;if(validateStagger(i),r?.aborted)throw r.reason;let o=uniqueElements(e),s=o.map((e,n)=>typeof t==`function`?t(e,n,o.length):t);if(r?.aborted)throw r.reason;let c=[];try{for(let[e,t]of o.entries()){let n=s[e];c.push(animate(t,n,withStaggeredDelay(a,e*i)))}}catch(e){for(let t of c)t.dispose(e);throw e}return createAnimationGroup(c,r)}function round(e,t){let n=10**t;return Math.round(e*n)/n}function measureSize(e){if(`offsetWidth`in e&&`offsetHeight`in e)return{height:e.offsetHeight,width:e.offsetWidth};let t=e.getBoundingClientRect();return{height:t.height,width:t.width}}function measureLayout(e){let t=e.getBoundingClientRect(),n=measureSize(e);return{height:n.height,width:n.width,x:t.x,y:t.y}}function computeScale(e,t){return t===0?1:e/t}function readKey(e,t,n){let r=t(e);if(typeof r!=`string`||r.length===0)throw new NecromancerConfigError(`getKey must return a non-empty string for every ${n} element.`);return r}function createKeyMap(e,t,n){let r=new Map;for(let i of e){let e=readKey(i.element,t,n);if(r.has(e))throw new NecromancerConfigError(`getKey returned duplicate keys for the ${n} elements.`);r.set(e,i)}return r}function changedElement(e,t){if(!e.isConnected)return;let n=measureLayout(e),r=t.x-n.x,i=t.y-n.y,a=computeScale(t.width,n.width),o=computeScale(t.height,n.height);return r===0&&i===0&&a===1&&o===1?void 0:{element:e,scaleX:a,scaleY:o,x:r,y:i}}function matchByIdentity(e,t){let n=new Map(e.map(e=>[e.element,e]));return t.flatMap(e=>{let t=n.get(e);return t?[changedElement(e,t.rect)].filter(e=>!!e):[]})}function matchByKey(e,t,n){let r=new Set;return t.flatMap(t=>{let i=readKey(t,n,`committed`),a=e.get(i);if(r.has(i))throw new NecromancerConfigError(`getKey returned duplicate keys for the committed elements.`);return r.add(i),a?[changedElement(t,a.rect)].filter(e=>!!e):[]})}function captureLayout(e,t={}){let n=uniqueElements(e).map(e=>({element:e,rect:measureLayout(e)})),r=t.getKey,i=r?createKeyMap(n,r,`captured`):void 0,a=!1;return{animate(e={}){if(a)throw new NecromancerConfigError(`This layout transition has already been animated.`);let{elements:t,...o}=e,s=uniqueElements(t??n.map(({element:e})=>e)),c=r&&i?matchByKey(i,s,r):matchByIdentity(n,s);return a=!0,animateEach(c.map(({element:e})=>e),(e,t)=>{let n=c[t],r=`${round(n.x,2)}px ${round(n.y,2)}px`;return[{composite:`add`,scale:`${round(n.scaleX,4)} ${round(n.scaleY,4)}`,translate:r},{composite:`add`,scale:`1 1`,translate:`0px 0px`}]},o)}}}export{NecromancerConfigError,NecromancerError,NecromancerUnsupportedError,animate,animateEach,captureLayout,shouldReduceMotion};
 //# sourceMappingURL=necromancer.js.map