@vielzeug/necromancer 2.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +75 -0
- package/dist/_active.cjs +2 -0
- package/dist/_active.cjs.map +1 -0
- package/dist/_active.d.ts +6 -0
- package/dist/_active.d.ts.map +1 -0
- package/dist/_active.js +15 -0
- package/dist/_active.js.map +1 -0
- package/dist/_elements.cjs +2 -0
- package/dist/_elements.cjs.map +1 -0
- package/dist/_elements.d.ts +3 -0
- package/dist/_elements.d.ts.map +1 -0
- package/dist/_elements.js +8 -0
- package/dist/_elements.js.map +1 -0
- package/dist/_handle.cjs +2 -0
- package/dist/_handle.cjs.map +1 -0
- package/dist/_handle.d.ts +6 -0
- package/dist/_handle.d.ts.map +1 -0
- package/dist/_handle.js +59 -0
- package/dist/_handle.js.map +1 -0
- package/dist/_motion.cjs +2 -0
- package/dist/_motion.cjs.map +1 -0
- package/dist/_motion.d.ts +8 -0
- package/dist/_motion.d.ts.map +1 -0
- package/dist/_motion.js +35 -0
- package/dist/_motion.js.map +1 -0
- package/dist/animate-each.cjs +2 -0
- package/dist/animate-each.cjs.map +1 -0
- package/dist/animate-each.d.ts +9 -0
- package/dist/animate-each.d.ts.map +1 -0
- package/dist/animate-each.js +28 -0
- package/dist/animate-each.js.map +1 -0
- package/dist/animate.cjs +2 -0
- package/dist/animate.cjs.map +1 -0
- package/dist/animate.d.ts +9 -0
- package/dist/animate.d.ts.map +1 -0
- package/dist/animate.js +16 -0
- package/dist/animate.js.map +1 -0
- package/dist/errors.cjs +2 -0
- package/dist/errors.cjs.map +1 -0
- package/dist/errors.d.ts +13 -0
- package/dist/errors.d.ts.map +1 -0
- package/dist/errors.js +13 -0
- package/dist/errors.js.map +1 -0
- package/dist/index.cjs +1 -0
- package/dist/index.d.ts +6 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +5 -0
- package/dist/layout.cjs +2 -0
- package/dist/layout.cjs.map +1 -0
- package/dist/layout.d.ts +12 -0
- package/dist/layout.d.ts.map +1 -0
- package/dist/layout.js +97 -0
- package/dist/layout.js.map +1 -0
- package/dist/necromancer.cjs +2 -0
- package/dist/necromancer.cjs.map +1 -0
- package/dist/necromancer.iife.js +2 -0
- package/dist/necromancer.iife.js.map +1 -0
- package/dist/necromancer.js +2 -0
- package/dist/necromancer.js.map +1 -0
- package/dist/testing/index.d.ts +46 -0
- package/dist/testing/index.d.ts.map +1 -0
- package/dist/testing.cjs +2 -0
- package/dist/testing.cjs.map +1 -0
- package/dist/testing.js +46 -0
- package/dist/testing.js.map +1 -0
- package/dist/types.d.ts +97 -0
- package/dist/types.d.ts.map +1 -0
- package/package.json +56 -0
package/dist/layout.js
ADDED
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
import { uniqueElements as e } from "./_elements.js";
|
|
2
|
+
import { NecromancerConfigError as t } from "./errors.js";
|
|
3
|
+
import { animateEach as n } from "./animate-each.js";
|
|
4
|
+
//#region src/layout.ts
|
|
5
|
+
function r(e, t) {
|
|
6
|
+
let n = 10 ** t;
|
|
7
|
+
return Math.round(e * n) / n;
|
|
8
|
+
}
|
|
9
|
+
function i(e) {
|
|
10
|
+
if ("offsetWidth" in e && "offsetHeight" in e) return {
|
|
11
|
+
height: e.offsetHeight,
|
|
12
|
+
width: e.offsetWidth
|
|
13
|
+
};
|
|
14
|
+
let t = e.getBoundingClientRect();
|
|
15
|
+
return {
|
|
16
|
+
height: t.height,
|
|
17
|
+
width: t.width
|
|
18
|
+
};
|
|
19
|
+
}
|
|
20
|
+
function a(e) {
|
|
21
|
+
let t = e.getBoundingClientRect(), n = i(e);
|
|
22
|
+
return {
|
|
23
|
+
height: n.height,
|
|
24
|
+
width: n.width,
|
|
25
|
+
x: t.x,
|
|
26
|
+
y: t.y
|
|
27
|
+
};
|
|
28
|
+
}
|
|
29
|
+
function o(e, t) {
|
|
30
|
+
return t === 0 ? 1 : e / t;
|
|
31
|
+
}
|
|
32
|
+
function s(e, n, r) {
|
|
33
|
+
let i = n(e);
|
|
34
|
+
if (typeof i != "string" || i.length === 0) throw new t(`getKey must return a non-empty string for every ${r} element.`);
|
|
35
|
+
return i;
|
|
36
|
+
}
|
|
37
|
+
function c(e, n, r) {
|
|
38
|
+
let i = /* @__PURE__ */ new Map();
|
|
39
|
+
for (let a of e) {
|
|
40
|
+
let e = s(a.element, n, r);
|
|
41
|
+
if (i.has(e)) throw new t(`getKey returned duplicate keys for the ${r} elements.`);
|
|
42
|
+
i.set(e, a);
|
|
43
|
+
}
|
|
44
|
+
return i;
|
|
45
|
+
}
|
|
46
|
+
function l(e, t) {
|
|
47
|
+
if (!e.isConnected) return;
|
|
48
|
+
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);
|
|
49
|
+
return r === 0 && i === 0 && s === 1 && c === 1 ? void 0 : {
|
|
50
|
+
element: e,
|
|
51
|
+
scaleX: s,
|
|
52
|
+
scaleY: c,
|
|
53
|
+
x: r,
|
|
54
|
+
y: i
|
|
55
|
+
};
|
|
56
|
+
}
|
|
57
|
+
function u(e, t) {
|
|
58
|
+
let n = new Map(e.map((e) => [e.element, e]));
|
|
59
|
+
return t.flatMap((e) => {
|
|
60
|
+
let t = n.get(e);
|
|
61
|
+
return t ? [l(e, t.rect)].filter((e) => !!e) : [];
|
|
62
|
+
});
|
|
63
|
+
}
|
|
64
|
+
function d(e, n, r) {
|
|
65
|
+
let i = /* @__PURE__ */ new Set();
|
|
66
|
+
return n.flatMap((n) => {
|
|
67
|
+
let a = s(n, r, "committed"), o = e.get(a);
|
|
68
|
+
if (i.has(a)) throw new t("getKey returned duplicate keys for the committed elements.");
|
|
69
|
+
return i.add(a), o ? [l(n, o.rect)].filter((e) => !!e) : [];
|
|
70
|
+
});
|
|
71
|
+
}
|
|
72
|
+
function f(i, o = {}) {
|
|
73
|
+
let s = e(i).map((e) => ({
|
|
74
|
+
element: e,
|
|
75
|
+
rect: a(e)
|
|
76
|
+
})), l = o.getKey, f = l ? c(s, l, "captured") : void 0, p = !1;
|
|
77
|
+
return { animate(i = {}) {
|
|
78
|
+
if (p) throw new t("This layout transition has already been animated.");
|
|
79
|
+
let { elements: a, ...o } = i, c = e(a ?? s.map(({ element: e }) => e)), m = l && f ? d(f, c, l) : u(s, c);
|
|
80
|
+
return p = !0, n(m.map(({ element: e }) => e), (e, t) => {
|
|
81
|
+
let n = m[t], i = `${r(n.x, 2)}px ${r(n.y, 2)}px`;
|
|
82
|
+
return [{
|
|
83
|
+
composite: "add",
|
|
84
|
+
scale: `${r(n.scaleX, 4)} ${r(n.scaleY, 4)}`,
|
|
85
|
+
translate: i
|
|
86
|
+
}, {
|
|
87
|
+
composite: "add",
|
|
88
|
+
scale: "1 1",
|
|
89
|
+
translate: "0px 0px"
|
|
90
|
+
}];
|
|
91
|
+
}, o);
|
|
92
|
+
} };
|
|
93
|
+
}
|
|
94
|
+
//#endregion
|
|
95
|
+
export { f as captureLayout };
|
|
96
|
+
|
|
97
|
+
//# sourceMappingURL=layout.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"layout.js","names":[],"sources":["../src/layout.ts"],"sourcesContent":["import type { LayoutAnimationOptions, LayoutCaptureOptions, LayoutTransition } from './types';\n\nimport { uniqueElements } from './_elements';\nimport { animateEach } from './animate-each';\nimport { NecromancerConfigError } from './errors';\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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"}
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});function e(e){return[...new Set(e)]}function t(e,t,n){return e.finished.then(()=>(t(),{status:n?`reduced`:`finished`}),e=>(t(),{reason:e,status:`cancelled`}))}function n(e,n,r=!1){let i=!1,a,o=!1,s,c=t(e,()=>{s?.(),s=void 0},r).then(e=>i&&o&&e.status===`cancelled`?{reason:a,status:`cancelled`}:e),l=t=>{i||(i=!0,a=t,o=t!==void 0,s?.(),s=void 0,e.cancel())};if(n){let e=()=>l(n.reason);n.addEventListener(`abort`,e,{once:!0}),s=()=>n.removeEventListener(`abort`,e)}return{animation:e,dispose:l,get disposed(){return i},result:c,[Symbol.dispose](){this.dispose()}}}function r(e,t){let n=!1,r,i=Promise.all(e.map(e=>e.result)).then(e=>(r?.(),r=void 0,e)),a=t=>{if(!n){n=!0,r?.(),r=void 0;for(let n of e)n.dispose(t)}};if(t){let e=()=>a(t.reason);t.addEventListener(`abort`,e,{once:!0}),r=()=>t.removeEventListener(`abort`,e)}return{dispose:a,get disposed(){return n},handles:e,results:i,[Symbol.dispose](){this.dispose()}}}var i=class e extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}static is(t){return t instanceof e}},a=class extends i{},o=class extends i{},s=180;function c(e){return e===`full`?!1:e===`reduced`||typeof matchMedia==`function`&&matchMedia(`(prefers-reduced-motion: reduce)`).matches}function l(e={},t=!1){let{duration:n,interrupt:r,motion:i=`system`,signal:a,...o}=e,c=n===void 0?{...o,duration:s}:{...o,duration:n};return t?{...c,delay:0,duration:0,endDelay:0,iterations:1}:c}function u(e,t){if(t===0)return e;let n=e.delay??0;if(typeof n!=`number`)throw new a(`A non-zero stagger requires a numeric delay; received ${typeof n}.`);return{...e,delay:n+t}}var d=new WeakMap;function f(e){for(let t of d.get(e)??[])t.dispose()}function p(e,t){let n=d.get(e);n||(n=new Set,d.set(e,n)),n.add(t),t.result.then(()=>{n?.delete(t),n?.size===0&&d.delete(e)})}function m(e,t,r={}){if(r.signal?.aborted)throw r.signal.reason;if(typeof e.animate!=`function`)throw new o(`The Web Animations API is not available in this environment.`);r.interrupt===`cancel`&&f(e);let i=c(r.motion??`system`),a=n(e.animate(t,l(r,i)),r.signal,i);return p(e,a),a}function h(e){if(!Number.isFinite(e)||e<0)throw new a(`stagger must be a finite, non-negative number.`)}function g(t,n,i={}){let{signal:a,stagger:o=0,...s}=i;if(h(o),a?.aborted)throw a.reason;let c=e(t),l=c.map((e,t)=>typeof n==`function`?n(e,t,c.length):n),d=[];try{for(let[e,t]of c.entries()){let n=l[e];d.push(m(t,n,u(s,e*o)))}}catch(e){for(let t of d)t.dispose(e);throw e}return r(d,a)}function _(e,t){let n=10**t;return Math.round(e*n)/n}function v(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 y(e){let t=e.getBoundingClientRect(),n=v(e);return{height:n.height,width:n.width,x:t.x,y:t.y}}function b(e,t){return t===0?1:e/t}function x(e,t,n){let r=t(e);if(typeof r!=`string`||r.length===0)throw new a(`getKey must return a non-empty string for every ${n} element.`);return r}function S(e,t,n){let r=new Map;for(let i of e){let e=x(i.element,t,n);if(r.has(e))throw new a(`getKey returned duplicate keys for the ${n} elements.`);r.set(e,i)}return r}function C(e,t){if(!e.isConnected)return;let n=y(e),r=t.x-n.x,i=t.y-n.y,a=b(t.width,n.width),o=b(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 w(e,t){let n=new Map(e.map(e=>[e.element,e]));return t.flatMap(e=>{let t=n.get(e);return t?[C(e,t.rect)].filter(e=>!!e):[]})}function T(e,t,n){let r=new Set;return t.flatMap(t=>{let i=x(t,n,`committed`),o=e.get(i);if(r.has(i))throw new a(`getKey returned duplicate keys for the committed elements.`);return r.add(i),o?[C(t,o.rect)].filter(e=>!!e):[]})}function E(t,n={}){let r=e(t).map(e=>({element:e,rect:y(e)})),i=n.getKey,o=i?S(r,i,`captured`):void 0,s=!1;return{animate(t={}){if(s)throw new a(`This layout transition has already been animated.`);let{elements:n,...c}=t,l=e(n??r.map(({element:e})=>e)),u=i&&o?T(o,l,i):w(r,l);return s=!0,g(u.map(({element:e})=>e),(e,t)=>{let n=u[t],r=`${_(n.x,2)}px ${_(n.y,2)}px`;return[{composite:`add`,scale:`${_(n.scaleX,4)} ${_(n.scaleY,4)}`,translate:r},{composite:`add`,scale:`1 1`,translate:`0px 0px`}]},c)}}}exports.NecromancerConfigError=a,exports.NecromancerError=i,exports.NecromancerUnsupportedError=o,exports.animate=m,exports.animateEach=g,exports.captureLayout=E;
|
|
2
|
+
//# sourceMappingURL=necromancer.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"necromancer.cjs","names":[],"sources":["../src/_elements.ts","../src/_handle.ts","../src/errors.ts","../src/_motion.ts","../src/_active.ts","../src/animate.ts","../src/animate-each.ts","../src/layout.ts"],"sourcesContent":["/** 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 type { AnimationGroup, AnimationHandle, AnimationResult } from './types';\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 const abort = () => dispose(signal.reason);\n\n signal.addEventListener('abort', abort, { once: true });\n removeAbortListener = () => signal.removeEventListener('abort', abort);\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 const abort = () => dispose(signal.reason);\n\n signal.addEventListener('abort', abort, { once: true });\n removeAbortListener = () => signal.removeEventListener('abort', abort);\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 /** Narrows an unknown error to any Necromancer-originated error. */\n static is(error: unknown): error is NecromancerError {\n return error instanceof NecromancerError;\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 type { AnimateOptions, MotionMode } from './types';\n\nimport { NecromancerConfigError } from './errors';\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 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 { AnimateOptions, AnimationHandle, Keyframes } from './types';\n\nimport { interruptAnimations, trackAnimation } from './_active';\nimport { createAnimationHandle } from './_handle';\nimport { resolveAnimationOptions, shouldReduceMotion } from './_motion';\nimport { NecromancerUnsupportedError } from './errors';\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","import type { AnimateEachOptions, AnimationGroup, AnimationHandle, KeyframeFactory, Keyframes } from './types';\n\nimport { uniqueElements } from './_elements';\nimport { createAnimationGroup } from './_handle';\nimport { withStaggeredDelay } from './_motion';\nimport { animate } from './animate';\nimport { NecromancerConfigError } from './errors';\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 type { LayoutAnimationOptions, LayoutCaptureOptions, LayoutTransition } from './types';\n\nimport { uniqueElements } from './_elements';\nimport { animateEach } from './animate-each';\nimport { NecromancerConfigError } from './errors';\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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"}
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
var Necromancer=(function(e){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});function t(e){return[...new Set(e)]}function n(e,t,n){return e.finished.then(()=>(t(),{status:n?`reduced`:`finished`}),e=>(t(),{reason:e,status:`cancelled`}))}function r(e,t,r=!1){let i=!1,a,o=!1,s,c=n(e,()=>{s?.(),s=void 0},r).then(e=>i&&o&&e.status===`cancelled`?{reason:a,status:`cancelled`}:e),l=t=>{i||(i=!0,a=t,o=t!==void 0,s?.(),s=void 0,e.cancel())};if(t){let e=()=>l(t.reason);t.addEventListener(`abort`,e,{once:!0}),s=()=>t.removeEventListener(`abort`,e)}return{animation:e,dispose:l,get disposed(){return i},result:c,[Symbol.dispose](){this.dispose()}}}function i(e,t){let n=!1,r,i=Promise.all(e.map(e=>e.result)).then(e=>(r?.(),r=void 0,e)),a=t=>{if(!n){n=!0,r?.(),r=void 0;for(let n of e)n.dispose(t)}};if(t){let e=()=>a(t.reason);t.addEventListener(`abort`,e,{once:!0}),r=()=>t.removeEventListener(`abort`,e)}return{dispose:a,get disposed(){return n},handles:e,results:i,[Symbol.dispose](){this.dispose()}}}var a=class e extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}static is(t){return t instanceof e}},o=class extends a{},s=class extends a{},c=180;function l(e){return e===`full`?!1:e===`reduced`||typeof matchMedia==`function`&&matchMedia(`(prefers-reduced-motion: reduce)`).matches}function u(e={},t=!1){let{duration:n,interrupt:r,motion:i=`system`,signal:a,...o}=e,s=n===void 0?{...o,duration:c}:{...o,duration:n};return t?{...s,delay:0,duration:0,endDelay:0,iterations:1}:s}function d(e,t){if(t===0)return e;let n=e.delay??0;if(typeof n!=`number`)throw new o(`A non-zero stagger requires a numeric delay; received ${typeof n}.`);return{...e,delay:n+t}}var f=new WeakMap;function p(e){for(let t of f.get(e)??[])t.dispose()}function m(e,t){let n=f.get(e);n||(n=new Set,f.set(e,n)),n.add(t),t.result.then(()=>{n?.delete(t),n?.size===0&&f.delete(e)})}function h(e,t,n={}){if(n.signal?.aborted)throw n.signal.reason;if(typeof e.animate!=`function`)throw new s(`The Web Animations API is not available in this environment.`);n.interrupt===`cancel`&&p(e);let i=l(n.motion??`system`),a=r(e.animate(t,u(n,i)),n.signal,i);return m(e,a),a}function g(e){if(!Number.isFinite(e)||e<0)throw new o(`stagger must be a finite, non-negative number.`)}function _(e,n,r={}){let{signal:a,stagger:o=0,...s}=r;if(g(o),a?.aborted)throw a.reason;let c=t(e),l=c.map((e,t)=>typeof n==`function`?n(e,t,c.length):n),u=[];try{for(let[e,t]of c.entries()){let n=l[e];u.push(h(t,n,d(s,e*o)))}}catch(e){for(let t of u)t.dispose(e);throw e}return i(u,a)}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 o(`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 o(`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 o(`getKey returned duplicate keys for the committed elements.`);return r.add(i),a?[w(t,a.rect)].filter(e=>!!e):[]})}function D(e,n={}){let r=t(e).map(e=>({element:e,rect:b(e)})),i=n.getKey,a=i?C(r,i,`captured`):void 0,s=!1;return{animate(e={}){if(s)throw new o(`This layout transition has already been animated.`);let{elements:n,...c}=e,l=t(n??r.map(({element:e})=>e)),u=i&&a?E(a,l,i):T(r,l);return s=!0,_(u.map(({element:e})=>e),(e,t)=>{let n=u[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`}]},c)}}}return e.NecromancerConfigError=o,e.NecromancerError=a,e.NecromancerUnsupportedError=s,e.animate=h,e.animateEach=_,e.captureLayout=D,e})({});
|
|
2
|
+
//# sourceMappingURL=necromancer.iife.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"necromancer.iife.js","names":[],"sources":["../src/_elements.ts","../src/_handle.ts","../src/errors.ts","../src/_motion.ts","../src/_active.ts","../src/animate.ts","../src/animate-each.ts","../src/layout.ts"],"sourcesContent":["/** 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 type { AnimationGroup, AnimationHandle, AnimationResult } from './types';\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 const abort = () => dispose(signal.reason);\n\n signal.addEventListener('abort', abort, { once: true });\n removeAbortListener = () => signal.removeEventListener('abort', abort);\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 const abort = () => dispose(signal.reason);\n\n signal.addEventListener('abort', abort, { once: true });\n removeAbortListener = () => signal.removeEventListener('abort', abort);\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 /** Narrows an unknown error to any Necromancer-originated error. */\n static is(error: unknown): error is NecromancerError {\n return error instanceof NecromancerError;\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 type { AnimateOptions, MotionMode } from './types';\n\nimport { NecromancerConfigError } from './errors';\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 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 { AnimateOptions, AnimationHandle, Keyframes } from './types';\n\nimport { interruptAnimations, trackAnimation } from './_active';\nimport { createAnimationHandle } from './_handle';\nimport { resolveAnimationOptions, shouldReduceMotion } from './_motion';\nimport { NecromancerUnsupportedError } from './errors';\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","import type { AnimateEachOptions, AnimationGroup, AnimationHandle, KeyframeFactory, Keyframes } from './types';\n\nimport { uniqueElements } from './_elements';\nimport { createAnimationGroup } from './_handle';\nimport { withStaggeredDelay } from './_motion';\nimport { animate } from './animate';\nimport { NecromancerConfigError } from './errors';\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 type { LayoutAnimationOptions, LayoutCaptureOptions, LayoutTransition } from './types';\n\nimport { uniqueElements } from './_elements';\nimport { animateEach } from './animate-each';\nimport { NecromancerConfigError } from './errors';\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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"}
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
function e(e){return[...new Set(e)]}function t(e,t,n){return e.finished.then(()=>(t(),{status:n?`reduced`:`finished`}),e=>(t(),{reason:e,status:`cancelled`}))}function n(e,n,r=!1){let i=!1,a,o=!1,s,c=t(e,()=>{s?.(),s=void 0},r).then(e=>i&&o&&e.status===`cancelled`?{reason:a,status:`cancelled`}:e),l=t=>{i||(i=!0,a=t,o=t!==void 0,s?.(),s=void 0,e.cancel())};if(n){let e=()=>l(n.reason);n.addEventListener(`abort`,e,{once:!0}),s=()=>n.removeEventListener(`abort`,e)}return{animation:e,dispose:l,get disposed(){return i},result:c,[Symbol.dispose](){this.dispose()}}}function r(e,t){let n=!1,r,i=Promise.all(e.map(e=>e.result)).then(e=>(r?.(),r=void 0,e)),a=t=>{if(!n){n=!0,r?.(),r=void 0;for(let n of e)n.dispose(t)}};if(t){let e=()=>a(t.reason);t.addEventListener(`abort`,e,{once:!0}),r=()=>t.removeEventListener(`abort`,e)}return{dispose:a,get disposed(){return n},handles:e,results:i,[Symbol.dispose](){this.dispose()}}}var i=class e extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}static is(t){return t instanceof e}},a=class extends i{},o=class extends i{},s=180;function c(e){return e===`full`?!1:e===`reduced`||typeof matchMedia==`function`&&matchMedia(`(prefers-reduced-motion: reduce)`).matches}function l(e={},t=!1){let{duration:n,interrupt:r,motion:i=`system`,signal:a,...o}=e,c=n===void 0?{...o,duration:s}:{...o,duration:n};return t?{...c,delay:0,duration:0,endDelay:0,iterations:1}:c}function u(e,t){if(t===0)return e;let n=e.delay??0;if(typeof n!=`number`)throw new a(`A non-zero stagger requires a numeric delay; received ${typeof n}.`);return{...e,delay:n+t}}var d=new WeakMap;function f(e){for(let t of d.get(e)??[])t.dispose()}function p(e,t){let n=d.get(e);n||(n=new Set,d.set(e,n)),n.add(t),t.result.then(()=>{n?.delete(t),n?.size===0&&d.delete(e)})}function m(e,t,r={}){if(r.signal?.aborted)throw r.signal.reason;if(typeof e.animate!=`function`)throw new o(`The Web Animations API is not available in this environment.`);r.interrupt===`cancel`&&f(e);let i=c(r.motion??`system`),a=n(e.animate(t,l(r,i)),r.signal,i);return p(e,a),a}function h(e){if(!Number.isFinite(e)||e<0)throw new a(`stagger must be a finite, non-negative number.`)}function g(t,n,i={}){let{signal:a,stagger:o=0,...s}=i;if(h(o),a?.aborted)throw a.reason;let c=e(t),l=c.map((e,t)=>typeof n==`function`?n(e,t,c.length):n),d=[];try{for(let[e,t]of c.entries()){let n=l[e];d.push(m(t,n,u(s,e*o)))}}catch(e){for(let t of d)t.dispose(e);throw e}return r(d,a)}function _(e,t){let n=10**t;return Math.round(e*n)/n}function v(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 y(e){let t=e.getBoundingClientRect(),n=v(e);return{height:n.height,width:n.width,x:t.x,y:t.y}}function b(e,t){return t===0?1:e/t}function x(e,t,n){let r=t(e);if(typeof r!=`string`||r.length===0)throw new a(`getKey must return a non-empty string for every ${n} element.`);return r}function S(e,t,n){let r=new Map;for(let i of e){let e=x(i.element,t,n);if(r.has(e))throw new a(`getKey returned duplicate keys for the ${n} elements.`);r.set(e,i)}return r}function C(e,t){if(!e.isConnected)return;let n=y(e),r=t.x-n.x,i=t.y-n.y,a=b(t.width,n.width),o=b(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 w(e,t){let n=new Map(e.map(e=>[e.element,e]));return t.flatMap(e=>{let t=n.get(e);return t?[C(e,t.rect)].filter(e=>!!e):[]})}function T(e,t,n){let r=new Set;return t.flatMap(t=>{let i=x(t,n,`committed`),o=e.get(i);if(r.has(i))throw new a(`getKey returned duplicate keys for the committed elements.`);return r.add(i),o?[C(t,o.rect)].filter(e=>!!e):[]})}function E(t,n={}){let r=e(t).map(e=>({element:e,rect:y(e)})),i=n.getKey,o=i?S(r,i,`captured`):void 0,s=!1;return{animate(t={}){if(s)throw new a(`This layout transition has already been animated.`);let{elements:n,...c}=t,l=e(n??r.map(({element:e})=>e)),u=i&&o?T(o,l,i):w(r,l);return s=!0,g(u.map(({element:e})=>e),(e,t)=>{let n=u[t],r=`${_(n.x,2)}px ${_(n.y,2)}px`;return[{composite:`add`,scale:`${_(n.scaleX,4)} ${_(n.scaleY,4)}`,translate:r},{composite:`add`,scale:`1 1`,translate:`0px 0px`}]},c)}}}export{a as NecromancerConfigError,i as NecromancerError,o as NecromancerUnsupportedError,m as animate,g as animateEach,E as captureLayout};
|
|
2
|
+
//# sourceMappingURL=necromancer.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"necromancer.js","names":[],"sources":["../src/_elements.ts","../src/_handle.ts","../src/errors.ts","../src/_motion.ts","../src/_active.ts","../src/animate.ts","../src/animate-each.ts","../src/layout.ts"],"sourcesContent":["/** 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 type { AnimationGroup, AnimationHandle, AnimationResult } from './types';\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 const abort = () => dispose(signal.reason);\n\n signal.addEventListener('abort', abort, { once: true });\n removeAbortListener = () => signal.removeEventListener('abort', abort);\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 const abort = () => dispose(signal.reason);\n\n signal.addEventListener('abort', abort, { once: true });\n removeAbortListener = () => signal.removeEventListener('abort', abort);\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 /** Narrows an unknown error to any Necromancer-originated error. */\n static is(error: unknown): error is NecromancerError {\n return error instanceof NecromancerError;\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 type { AnimateOptions, MotionMode } from './types';\n\nimport { NecromancerConfigError } from './errors';\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 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 { AnimateOptions, AnimationHandle, Keyframes } from './types';\n\nimport { interruptAnimations, trackAnimation } from './_active';\nimport { createAnimationHandle } from './_handle';\nimport { resolveAnimationOptions, shouldReduceMotion } from './_motion';\nimport { NecromancerUnsupportedError } from './errors';\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","import type { AnimateEachOptions, AnimationGroup, AnimationHandle, KeyframeFactory, Keyframes } from './types';\n\nimport { uniqueElements } from './_elements';\nimport { createAnimationGroup } from './_handle';\nimport { withStaggeredDelay } from './_motion';\nimport { animate } from './animate';\nimport { NecromancerConfigError } from './errors';\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 type { LayoutAnimationOptions, LayoutCaptureOptions, LayoutTransition } from './types';\n\nimport { uniqueElements } from './_elements';\nimport { animateEach } from './animate-each';\nimport { NecromancerConfigError } from './errors';\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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"}
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Testing utilities for code that calls Necromancer's animation functions.
|
|
3
|
+
*
|
|
4
|
+
* jsdom (and most non-browser DOM environments) do not implement `Element.animate()`,
|
|
5
|
+
* so any test that exercises `animate()`, `animateEach()`, or `captureLayout()` needs a
|
|
6
|
+
* substitute. This module has no test-runner import — it works the same under Vitest,
|
|
7
|
+
* Jest, or any other runner; use your runner's own spy/mock APIs on top if needed.
|
|
8
|
+
*/
|
|
9
|
+
export type AnimationCall = {
|
|
10
|
+
readonly animation: FakeAnimation;
|
|
11
|
+
readonly keyframes: Keyframe[] | PropertyIndexedKeyframes;
|
|
12
|
+
readonly options?: KeyframeAnimationOptions;
|
|
13
|
+
};
|
|
14
|
+
/** A minimal `Animation` stand-in. Call `finish()`/`cancel()` to settle it like the real API would. */
|
|
15
|
+
export declare class FakeAnimation {
|
|
16
|
+
#private;
|
|
17
|
+
/** Number of times `cancel()` has been called. */
|
|
18
|
+
cancelCallCount: number;
|
|
19
|
+
/** Number of times `finish()` has been called. */
|
|
20
|
+
finishCallCount: number;
|
|
21
|
+
/** Mirrors the native `Animation.finished` promise. */
|
|
22
|
+
finished: Promise<void>;
|
|
23
|
+
constructor();
|
|
24
|
+
/** Rejects `finished` with an `AbortError`, like a real cancelled `Animation`. */
|
|
25
|
+
cancel: () => void;
|
|
26
|
+
/** Resolves `finished`, like a real completed `Animation`. */
|
|
27
|
+
finish: () => void;
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* Replaces `Element.prototype.animate` with a deterministic fake for the duration of a test.
|
|
31
|
+
* Call `restore()` to put the original implementation (or its absence) back.
|
|
32
|
+
*
|
|
33
|
+
* @example
|
|
34
|
+
* const { calls, restore } = installFakeAnimations();
|
|
35
|
+
* const handle = animate(element, [{ opacity: 0 }, { opacity: 1 }]);
|
|
36
|
+
* calls[0]?.animation.finish();
|
|
37
|
+
* await handle.result; // { status: 'finished' }
|
|
38
|
+
* restore();
|
|
39
|
+
*/
|
|
40
|
+
export declare function installFakeAnimations(): {
|
|
41
|
+
calls: AnimationCall[];
|
|
42
|
+
restore: () => void;
|
|
43
|
+
};
|
|
44
|
+
/** Builds a `DOMRect` for mocking `Element.getBoundingClientRect()` in `captureLayout()` tests. */
|
|
45
|
+
export declare function createRect(x: number, y: number, width?: number, height?: number): DOMRect;
|
|
46
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,wBAAwB,CAAC;IAC1D,QAAQ,CAAC,OAAO,CAAC,EAAE,wBAAwB,CAAC;CAC7C,CAAC;AAEF,uGAAuG;AACvG,qBAAa,aAAa;;IAIxB,kDAAkD;IAClD,eAAe,SAAK;IACpB,kDAAkD;IAClD,eAAe,SAAK;IACpB,uDAAuD;IACvD,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;;IASxB,kFAAkF;IAClF,MAAM,QAAO,IAAI,CAGf;IAEF,8DAA8D;IAC9D,MAAM,QAAO,IAAI,CAGf;CACH;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,IAAI;IAAE,KAAK,EAAE,aAAa,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAwBvF;AAED,mGAAmG;AACnG,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,MAAM,SAAK,GAAG,OAAO,CAEjF"}
|
package/dist/testing.cjs
ADDED
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=class{#e;#t;cancelCallCount=0;finishCallCount=0;finished;constructor(){this.finished=new Promise((e,t)=>{this.#t=e,this.#e=t})}cancel=()=>{this.cancelCallCount+=1,this.#e(new DOMException(`The animation was canceled.`,`AbortError`))};finish=()=>{this.finishCallCount+=1,this.#t()}};function t(){let t=[],n=Object.getOwnPropertyDescriptor(Element.prototype,`animate`);return Object.defineProperty(Element.prototype,"animate",{configurable:!0,value:(n,r)=>{let i=new e;return t.push({animation:i,keyframes:n,options:r}),i},writable:!0}),{calls:t,restore(){n?Object.defineProperty(Element.prototype,"animate",n):Reflect.deleteProperty(Element.prototype,`animate`)}}}function n(e,t,n=20,r=20){return new DOMRect(e,t,n,r)}exports.FakeAnimation=e,exports.createRect=n,exports.installFakeAnimations=t;
|
|
2
|
+
//# sourceMappingURL=testing.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"testing.cjs","names":["#resolve","#reject"],"sources":["../src/testing/index.ts"],"sourcesContent":["/**\n * Testing utilities for code that calls Necromancer's animation functions.\n *\n * jsdom (and most non-browser DOM environments) do not implement `Element.animate()`,\n * so any test that exercises `animate()`, `animateEach()`, or `captureLayout()` needs a\n * substitute. This module has no test-runner import — it works the same under Vitest,\n * Jest, or any other runner; use your runner's own spy/mock APIs on top if needed.\n */\n\nexport type AnimationCall = {\n readonly animation: FakeAnimation;\n readonly keyframes: Keyframe[] | PropertyIndexedKeyframes;\n readonly options?: KeyframeAnimationOptions;\n};\n\n/** A minimal `Animation` stand-in. Call `finish()`/`cancel()` to settle it like the real API would. */\nexport class FakeAnimation {\n #reject!: (reason?: unknown) => void;\n #resolve!: () => void;\n\n /** Number of times `cancel()` has been called. */\n cancelCallCount = 0;\n /** Number of times `finish()` has been called. */\n finishCallCount = 0;\n /** Mirrors the native `Animation.finished` promise. */\n finished: Promise<void>;\n\n constructor() {\n this.finished = new Promise<void>((resolve, reject) => {\n this.#resolve = resolve;\n this.#reject = reject;\n });\n }\n\n /** Rejects `finished` with an `AbortError`, like a real cancelled `Animation`. */\n cancel = (): void => {\n this.cancelCallCount += 1;\n this.#reject(new DOMException('The animation was canceled.', 'AbortError'));\n };\n\n /** Resolves `finished`, like a real completed `Animation`. */\n finish = (): void => {\n this.finishCallCount += 1;\n this.#resolve();\n };\n}\n\n/**\n * Replaces `Element.prototype.animate` with a deterministic fake for the duration of a test.\n * Call `restore()` to put the original implementation (or its absence) back.\n *\n * @example\n * const { calls, restore } = installFakeAnimations();\n * const handle = animate(element, [{ opacity: 0 }, { opacity: 1 }]);\n * calls[0]?.animation.finish();\n * await handle.result; // { status: 'finished' }\n * restore();\n */\nexport function installFakeAnimations(): { calls: AnimationCall[]; restore: () => void } {\n const calls: AnimationCall[] = [];\n const descriptor = Object.getOwnPropertyDescriptor(Element.prototype, 'animate');\n\n Object.defineProperty(Element.prototype, 'animate', {\n configurable: true,\n value: (keyframes: Keyframe[] | PropertyIndexedKeyframes, options?: KeyframeAnimationOptions) => {\n const animation = new FakeAnimation();\n\n calls.push({ animation, keyframes, options });\n\n // Necromancer only consumes the documented Animation surface represented by FakeAnimation.\n return animation as unknown as Animation;\n },\n writable: true,\n });\n\n return {\n calls,\n restore() {\n if (descriptor) Object.defineProperty(Element.prototype, 'animate', descriptor);\n else Reflect.deleteProperty(Element.prototype, 'animate');\n },\n };\n}\n\n/** Builds a `DOMRect` for mocking `Element.getBoundingClientRect()` in `captureLayout()` tests. */\nexport function createRect(x: number, y: number, width = 20, height = 20): DOMRect {\n return new DOMRect(x, y, width, height);\n}\n"],"mappings":"mEAgBA,IAAa,EAAb,KAA2B,CACzB,GACA,GAGA,gBAAkB,EAElB,gBAAkB,EAElB,SAEA,aAAc,CACZ,KAAK,SAAW,IAAI,SAAe,EAAS,IAAW,CACrD,KAAKA,GAAW,EAChB,KAAKC,GAAU,CACjB,CAAC,CACH,CAGA,WAAqB,CACnB,KAAK,iBAAmB,EACxB,KAAKA,GAAQ,IAAI,aAAa,8BAA+B,YAAY,CAAC,CAC5E,EAGA,WAAqB,CACnB,KAAK,iBAAmB,EACxB,KAAKD,GAAS,CAChB,CACF,EAaA,SAAgB,GAAyE,CACvF,IAAM,EAAyB,CAAC,EAC1B,EAAa,OAAO,yBAAyB,QAAQ,UAAW,SAAS,EAe/E,OAbA,OAAO,eAAe,QAAQ,UAAW,UAAW,CAClD,aAAc,GACd,OAAQ,EAAkD,IAAuC,CAC/F,IAAM,EAAY,IAAI,EAKtB,OAHA,EAAM,KAAK,CAAE,YAAW,YAAW,SAAQ,CAAC,EAGrC,CACT,EACA,SAAU,EACZ,CAAC,EAEM,CACL,QACA,SAAU,CACJ,EAAY,OAAO,eAAe,QAAQ,UAAW,UAAW,CAAU,EACzE,QAAQ,eAAe,QAAQ,UAAW,SAAS,CAC1D,CACF,CACF,CAGA,SAAgB,EAAW,EAAW,EAAW,EAAQ,GAAI,EAAS,GAAa,CACjF,OAAO,IAAI,QAAQ,EAAG,EAAG,EAAO,CAAM,CACxC"}
|
package/dist/testing.js
ADDED
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
//#region src/testing/index.ts
|
|
2
|
+
var e = class {
|
|
3
|
+
#e;
|
|
4
|
+
#t;
|
|
5
|
+
cancelCallCount = 0;
|
|
6
|
+
finishCallCount = 0;
|
|
7
|
+
finished;
|
|
8
|
+
constructor() {
|
|
9
|
+
this.finished = new Promise((e, t) => {
|
|
10
|
+
this.#t = e, this.#e = t;
|
|
11
|
+
});
|
|
12
|
+
}
|
|
13
|
+
cancel = () => {
|
|
14
|
+
this.cancelCallCount += 1, this.#e(new DOMException("The animation was canceled.", "AbortError"));
|
|
15
|
+
};
|
|
16
|
+
finish = () => {
|
|
17
|
+
this.finishCallCount += 1, this.#t();
|
|
18
|
+
};
|
|
19
|
+
};
|
|
20
|
+
function t() {
|
|
21
|
+
let t = [], n = Object.getOwnPropertyDescriptor(Element.prototype, "animate");
|
|
22
|
+
return Object.defineProperty(Element.prototype, "animate", {
|
|
23
|
+
configurable: !0,
|
|
24
|
+
value: (n, r) => {
|
|
25
|
+
let i = new e();
|
|
26
|
+
return t.push({
|
|
27
|
+
animation: i,
|
|
28
|
+
keyframes: n,
|
|
29
|
+
options: r
|
|
30
|
+
}), i;
|
|
31
|
+
},
|
|
32
|
+
writable: !0
|
|
33
|
+
}), {
|
|
34
|
+
calls: t,
|
|
35
|
+
restore() {
|
|
36
|
+
n ? Object.defineProperty(Element.prototype, "animate", n) : Reflect.deleteProperty(Element.prototype, "animate");
|
|
37
|
+
}
|
|
38
|
+
};
|
|
39
|
+
}
|
|
40
|
+
function n(e, t, n = 20, r = 20) {
|
|
41
|
+
return new DOMRect(e, t, n, r);
|
|
42
|
+
}
|
|
43
|
+
//#endregion
|
|
44
|
+
export { e as FakeAnimation, n as createRect, t as installFakeAnimations };
|
|
45
|
+
|
|
46
|
+
//# sourceMappingURL=testing.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"testing.js","names":["#resolve","#reject"],"sources":["../src/testing/index.ts"],"sourcesContent":["/**\n * Testing utilities for code that calls Necromancer's animation functions.\n *\n * jsdom (and most non-browser DOM environments) do not implement `Element.animate()`,\n * so any test that exercises `animate()`, `animateEach()`, or `captureLayout()` needs a\n * substitute. This module has no test-runner import — it works the same under Vitest,\n * Jest, or any other runner; use your runner's own spy/mock APIs on top if needed.\n */\n\nexport type AnimationCall = {\n readonly animation: FakeAnimation;\n readonly keyframes: Keyframe[] | PropertyIndexedKeyframes;\n readonly options?: KeyframeAnimationOptions;\n};\n\n/** A minimal `Animation` stand-in. Call `finish()`/`cancel()` to settle it like the real API would. */\nexport class FakeAnimation {\n #reject!: (reason?: unknown) => void;\n #resolve!: () => void;\n\n /** Number of times `cancel()` has been called. */\n cancelCallCount = 0;\n /** Number of times `finish()` has been called. */\n finishCallCount = 0;\n /** Mirrors the native `Animation.finished` promise. */\n finished: Promise<void>;\n\n constructor() {\n this.finished = new Promise<void>((resolve, reject) => {\n this.#resolve = resolve;\n this.#reject = reject;\n });\n }\n\n /** Rejects `finished` with an `AbortError`, like a real cancelled `Animation`. */\n cancel = (): void => {\n this.cancelCallCount += 1;\n this.#reject(new DOMException('The animation was canceled.', 'AbortError'));\n };\n\n /** Resolves `finished`, like a real completed `Animation`. */\n finish = (): void => {\n this.finishCallCount += 1;\n this.#resolve();\n };\n}\n\n/**\n * Replaces `Element.prototype.animate` with a deterministic fake for the duration of a test.\n * Call `restore()` to put the original implementation (or its absence) back.\n *\n * @example\n * const { calls, restore } = installFakeAnimations();\n * const handle = animate(element, [{ opacity: 0 }, { opacity: 1 }]);\n * calls[0]?.animation.finish();\n * await handle.result; // { status: 'finished' }\n * restore();\n */\nexport function installFakeAnimations(): { calls: AnimationCall[]; restore: () => void } {\n const calls: AnimationCall[] = [];\n const descriptor = Object.getOwnPropertyDescriptor(Element.prototype, 'animate');\n\n Object.defineProperty(Element.prototype, 'animate', {\n configurable: true,\n value: (keyframes: Keyframe[] | PropertyIndexedKeyframes, options?: KeyframeAnimationOptions) => {\n const animation = new FakeAnimation();\n\n calls.push({ animation, keyframes, options });\n\n // Necromancer only consumes the documented Animation surface represented by FakeAnimation.\n return animation as unknown as Animation;\n },\n writable: true,\n });\n\n return {\n calls,\n restore() {\n if (descriptor) Object.defineProperty(Element.prototype, 'animate', descriptor);\n else Reflect.deleteProperty(Element.prototype, 'animate');\n },\n };\n}\n\n/** Builds a `DOMRect` for mocking `Element.getBoundingClientRect()` in `captureLayout()` tests. */\nexport function createRect(x: number, y: number, width = 20, height = 20): DOMRect {\n return new DOMRect(x, y, width, height);\n}\n"],"mappings":";AAgBA,IAAa,IAAb,MAA2B;CACzB;CACA;CAGA,kBAAkB;CAElB,kBAAkB;CAElB;CAEA,cAAc;EACZ,KAAK,WAAW,IAAI,SAAe,GAAS,MAAW;GAErD,AADA,KAAKA,KAAW,GAChB,KAAKC,KAAU;EACjB,CAAC;CACH;CAGA,eAAqB;EAEnB,AADA,KAAK,mBAAmB,GACxB,KAAKA,GAAQ,IAAI,aAAa,+BAA+B,YAAY,CAAC;CAC5E;CAGA,eAAqB;EAEnB,AADA,KAAK,mBAAmB,GACxB,KAAKD,GAAS;CAChB;AACF;AAaA,SAAgB,IAAyE;CACvF,IAAM,IAAyB,CAAC,GAC1B,IAAa,OAAO,yBAAyB,QAAQ,WAAW,SAAS;CAe/E,OAbA,OAAO,eAAe,QAAQ,WAAW,WAAW;EAClD,cAAc;EACd,QAAQ,GAAkD,MAAuC;GAC/F,IAAM,IAAY,IAAI,EAAc;GAKpC,OAHA,EAAM,KAAK;IAAE;IAAW;IAAW;GAAQ,CAAC,GAGrC;EACT;EACA,UAAU;CACZ,CAAC,GAEM;EACL;EACA,UAAU;GACR,AAAI,IAAY,OAAO,eAAe,QAAQ,WAAW,WAAW,CAAU,IACzE,QAAQ,eAAe,QAAQ,WAAW,SAAS;EAC1D;CACF;AACF;AAGA,SAAgB,EAAW,GAAW,GAAW,IAAQ,IAAI,IAAS,IAAa;CACjF,OAAO,IAAI,QAAQ,GAAG,GAAG,GAAO,CAAM;AACxC"}
|
package/dist/types.d.ts
ADDED
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
/** Chooses whether an animation uses full or reduced motion. */
|
|
2
|
+
export type MotionMode = 'full' | 'reduced' | 'system';
|
|
3
|
+
/** The terminal result of a lifecycle-owned animation. */
|
|
4
|
+
export type AnimationResult = {
|
|
5
|
+
readonly status: 'finished';
|
|
6
|
+
} | {
|
|
7
|
+
readonly status: 'reduced';
|
|
8
|
+
} | {
|
|
9
|
+
readonly reason?: unknown;
|
|
10
|
+
readonly status: 'cancelled';
|
|
11
|
+
};
|
|
12
|
+
/** Keyframes accepted by the Web Animations API. */
|
|
13
|
+
export type Keyframes = readonly Keyframe[] | PropertyIndexedKeyframes;
|
|
14
|
+
/**
|
|
15
|
+
* Native Web Animations timing options with Necromancer's ownership controls.
|
|
16
|
+
*
|
|
17
|
+
* `duration` defaults to `180` milliseconds. `motion` defaults to `'system'`.
|
|
18
|
+
* `signal` disposes the returned handle when aborted.
|
|
19
|
+
*
|
|
20
|
+
* Deliberately extends native `KeyframeAnimationOptions` in full rather than a narrower,
|
|
21
|
+
* Necromancer-specific timing type: every native field (`easing`, `fill`, `iterations`, a
|
|
22
|
+
* string `delay`/`duration`, etc.) reaches `element.animate()` unchanged. Callers already
|
|
23
|
+
* fluent in the Web Animations API bring that knowledge here directly, instead of learning
|
|
24
|
+
* a second, smaller timing vocabulary — the option chain below only ever *adds* ownership
|
|
25
|
+
* fields on top, never narrows what's already native.
|
|
26
|
+
*
|
|
27
|
+
* Option chain: `AnimateOptions` -> `AnimateEachOptions` (+`stagger`) -> `LayoutAnimationOptions`
|
|
28
|
+
* (+`elements`). Each layer's implementation module strips only the field it added before
|
|
29
|
+
* forwarding the rest down (see `animate-each.ts`, `layout.ts`, and `_motion.ts`'s
|
|
30
|
+
* `resolveAnimationOptions()`, which is the last stop and strips `interrupt`/`motion`/`signal`).
|
|
31
|
+
*/
|
|
32
|
+
export type AnimateOptions = KeyframeAnimationOptions & {
|
|
33
|
+
/**
|
|
34
|
+
* Cancels every active Necromancer-owned animation on the element as this
|
|
35
|
+
* animation begins. Native animations owned outside Necromancer are untouched.
|
|
36
|
+
*/
|
|
37
|
+
readonly interrupt?: 'cancel';
|
|
38
|
+
readonly motion?: MotionMode;
|
|
39
|
+
readonly signal?: AbortSignal;
|
|
40
|
+
};
|
|
41
|
+
/** Produces keyframes for an element at a stable position in an animation group. */
|
|
42
|
+
export type KeyframeFactory = (element: Element, index: number, total: number) => Keyframes;
|
|
43
|
+
/** Options for animating a group of elements. */
|
|
44
|
+
export type AnimateEachOptions = AnimateOptions & {
|
|
45
|
+
/** Milliseconds to delay each element after the preceding element. Defaults to `0`. */
|
|
46
|
+
readonly stagger?: number;
|
|
47
|
+
};
|
|
48
|
+
/** Options for animating positional layout changes captured by {@link captureLayout}. */
|
|
49
|
+
export type LayoutAnimationOptions = AnimateEachOptions & {
|
|
50
|
+
/**
|
|
51
|
+
* Elements in their committed layout. With {@link LayoutCaptureOptions.getKey},
|
|
52
|
+
* replacement elements match their captured predecessors by key.
|
|
53
|
+
*/
|
|
54
|
+
readonly elements?: Iterable<Element>;
|
|
55
|
+
};
|
|
56
|
+
/** Options for capturing positional layout changes. */
|
|
57
|
+
export interface LayoutCaptureOptions {
|
|
58
|
+
/** Maps an element to its stable, non-empty identity across a DOM replacement. */
|
|
59
|
+
readonly getKey?: (element: Element) => string;
|
|
60
|
+
}
|
|
61
|
+
/** A lifecycle-owned native Web Animation. */
|
|
62
|
+
export interface AnimationHandle {
|
|
63
|
+
/** The lifecycle-owned native Web Animation. */
|
|
64
|
+
readonly animation: Animation;
|
|
65
|
+
/** Resolves once the animation finishes, is reduced, or is cancelled. */
|
|
66
|
+
readonly result: Promise<AnimationResult>;
|
|
67
|
+
/** Whether this handle has been disposed. */
|
|
68
|
+
readonly disposed: boolean;
|
|
69
|
+
/** Cancels the native animation and releases owned listeners. */
|
|
70
|
+
dispose(reason?: unknown): void;
|
|
71
|
+
/** Calls {@link dispose}. */
|
|
72
|
+
[Symbol.dispose](): void;
|
|
73
|
+
}
|
|
74
|
+
/** A lifecycle-owned collection of animations. */
|
|
75
|
+
export interface AnimationGroup {
|
|
76
|
+
/** Child handles in the order supplied to {@link animateEach}. */
|
|
77
|
+
readonly handles: readonly AnimationHandle[];
|
|
78
|
+
/** Resolves after all children have reached a terminal state. */
|
|
79
|
+
readonly results: Promise<readonly AnimationResult[]>;
|
|
80
|
+
/** Whether this group has been disposed. */
|
|
81
|
+
readonly disposed: boolean;
|
|
82
|
+
/** Disposes every child and releases group ownership. */
|
|
83
|
+
dispose(reason?: unknown): void;
|
|
84
|
+
/** Calls {@link dispose}. */
|
|
85
|
+
[Symbol.dispose](): void;
|
|
86
|
+
}
|
|
87
|
+
/** A one-shot positional layout transition returned by {@link captureLayout}. */
|
|
88
|
+
export interface LayoutTransition {
|
|
89
|
+
/**
|
|
90
|
+
* Measures the current layout and animates elements from their captured positions.
|
|
91
|
+
*
|
|
92
|
+
* Omit `options.elements` to animate the captured elements, or supply the
|
|
93
|
+
* committed replacements when the transition was captured with `getKey`.
|
|
94
|
+
*/
|
|
95
|
+
animate(options?: LayoutAnimationOptions): AnimationGroup;
|
|
96
|
+
}
|
|
97
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEvD,0DAA0D;AAC1D,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GAC/B;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GAC9B;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC;AAEhE,oDAAoD;AACpD,MAAM,MAAM,SAAS,GAAG,SAAS,QAAQ,EAAE,GAAG,wBAAwB,CAAC;AAEvE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,cAAc,GAAG,wBAAwB,GAAG;IACtD;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B,CAAC;AAEF,oFAAoF;AACpF,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;AAE5F,iDAAiD;AACjD,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG;IAChD,uFAAuF;IACvF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,yFAAyF;AACzF,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,GAAG;IACxD;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;CACvC,CAAC;AAEF,uDAAuD;AACvD,MAAM,WAAW,oBAAoB;IACnC,kFAAkF;IAClF,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;CAChD;AAED,8CAA8C;AAC9C,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAC1C,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,iEAAiE;IACjE,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,6BAA6B;IAC7B,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;CAC1B;AAED,kDAAkD;AAClD,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAAC;IACtD,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,yDAAyD;IACzD,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,6BAA6B;IAC7B,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;CAC1B;AAED,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,cAAc,CAAC;CAC3D"}
|
package/package.json
ADDED
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@vielzeug/necromancer",
|
|
3
|
+
"version": "2.0.0",
|
|
4
|
+
"description": "Dependency-free, lifecycle-owned animation primitives built on the Web Animations API",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"files": [
|
|
7
|
+
"dist"
|
|
8
|
+
],
|
|
9
|
+
"main": "./dist/index.cjs",
|
|
10
|
+
"module": "./dist/index.js",
|
|
11
|
+
"types": "dist/index.d.ts",
|
|
12
|
+
"exports": {
|
|
13
|
+
".": {
|
|
14
|
+
"types": "./dist/index.d.ts",
|
|
15
|
+
"import": "./dist/index.js",
|
|
16
|
+
"require": "./dist/index.cjs"
|
|
17
|
+
},
|
|
18
|
+
"./testing": {
|
|
19
|
+
"types": "./dist/testing/index.d.ts",
|
|
20
|
+
"import": "./dist/testing.js",
|
|
21
|
+
"require": "./dist/testing.cjs"
|
|
22
|
+
}
|
|
23
|
+
},
|
|
24
|
+
"scripts": {
|
|
25
|
+
"build": "vite build && pnpm run build:bundle && pnpm run build:types",
|
|
26
|
+
"build:bundle": "vite build --config vite.bundle.config.ts",
|
|
27
|
+
"build:types": "tsc -p tsconfig.declarations.json",
|
|
28
|
+
"fix": "eslint --fix src",
|
|
29
|
+
"lint": "eslint src",
|
|
30
|
+
"prepublishOnly": "pnpm run build",
|
|
31
|
+
"test": "vitest",
|
|
32
|
+
"test:e2e": "pnpm run build && playwright test"
|
|
33
|
+
},
|
|
34
|
+
"publishConfig": {
|
|
35
|
+
"access": "public",
|
|
36
|
+
"registry": "https://registry.npmjs.org/"
|
|
37
|
+
},
|
|
38
|
+
"engines": {
|
|
39
|
+
"node": ">=22"
|
|
40
|
+
},
|
|
41
|
+
"typesVersions": {
|
|
42
|
+
"*": {
|
|
43
|
+
"testing": [
|
|
44
|
+
"dist/testing/index.d.ts"
|
|
45
|
+
]
|
|
46
|
+
}
|
|
47
|
+
},
|
|
48
|
+
"devDependencies": {
|
|
49
|
+
"@playwright/test": "^1.62.1",
|
|
50
|
+
"@types/node": "^26.1.2",
|
|
51
|
+
"jsdom": "^30.0.1",
|
|
52
|
+
"typescript": "^6.0.3",
|
|
53
|
+
"vite": "^8.2.0",
|
|
54
|
+
"vitest": "^4.1.10"
|
|
55
|
+
}
|
|
56
|
+
}
|