@usenagi/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 hayakawasho
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,242 @@
+# nagi
+
+**Composition-style ergonomics for vanilla DOM. Bring your own mounter.**
+
+[![npm](https://img.shields.io/npm/v/@usenagi/core)](https://www.npmjs.com/package/@usenagi/core)
+[![bundle size](https://img.shields.io/bundlephobia/minzip/@usenagi/core)](https://bundlephobia.com/package/@usenagi/core)
+[![license](https://img.shields.io/npm/l/@usenagi/core)](./LICENSE)
+
+---
+
+## Why nagi?
+
+**既存 HTML に小さく足せる**
+WordPress、CMS、Webflow、静的サイトなどに、仮想 DOM やテンプレートを持ち込まず `setup()` / lifecycle / reactivity を追加できる。
+
+**アニメーションと相性が良い**
+GSAP、Lenis、IntersectionObserver などを `setup()` で初期化し、`useUnmount()` でクリーンアップできる。
+
+**マウント戦略を縛らない**
+`[data-component]` スキャン、manifest、lazy import、MutationObserver などは利用側で自由に組める。
+
+---
+
+## 30-second example
+
+```ts
+// counter.ts
+import { create, ref, useWatch, useDomRef } from "@usenagi/core";
+
+const { component } = create();
+
+component({
+  name: "counter",
+  setup() {
+    const { refs } = useDomRef<{
+      count: HTMLSpanElement;
+      btn: HTMLButtonElement;
+    }>();
+
+    const n = ref(0);
+    useWatch(n, (v) => {
+      refs.count.textContent = String(v);
+    });
+    refs.btn.addEventListener("click", () => {
+      n.value++;
+    });
+  },
+})(document.querySelector("#counter")!);
+```
+
+```html
+<div id="counter">
+  <span data-ref="count">0</span>
+  <button data-ref="btn">+</button>
+</div>
+```
+
+---
+
+## Quick start
+
+```bash
+npm i @usenagi/core
+```
+
+### First component
+
+```ts
+import { create, defineComponent, ref, useWatch, useDomRef } from "@usenagi/core";
+
+const Greeting = defineComponent({
+  name: "greeting",
+  setup(el, props) {
+    const { refs } = useDomRef<{ message: HTMLParagraphElement }>();
+    const text = ref((props.name as string) ?? "world");
+
+    useWatch(text, (v) => {
+      refs.message.textContent = `Hello, ${v}!`;
+    });
+    refs.message.textContent = `Hello, ${text.value}!`;
+  },
+});
+
+create().component(Greeting)(document.querySelector("#app")!);
+```
+
+### Scheduler + deferred mount
+
+遅延マウントが必要なら scheduler / cue addons を追加する。
+
+```ts
+import { create } from "@usenagi/core";
+import { createScheduler } from "@usenagi/core/addons/scheduler";
+import { visible, idle } from "@usenagi/core/addons/cue";
+
+const app = create({ scheduler: createScheduler() });
+
+// Intersection で visible になってからマウント
+app.component(HeavyWidget, { when: visible() })(el);
+
+// requestIdleCallback でマウント
+app.component(Analytics, { when: idle() })(el);
+```
+
+`when` は `setup()` の前に待機する条件、`priority` は `setup()` を含む mount task の実行タイミングを決める。
+
+### BYO mounter recipe
+
+`[data-component]` スキャン、manifest、cue を組み合わせて自動マウントする一例。
+→ [examples/recipes/byo-mounter](./examples/recipes/byo-mounter/main.ts)
+
+---
+
+## API
+
+### Reactivity
+
+| API                 | 説明                                         |
+| ------------------- | -------------------------------------------- |
+| `ref(value)`        | リアクティブな参照を作成                     |
+| `readonly(ref)`     | 読み取り専用ラッパー                         |
+| `computed(fn)`      | 依存する `ref` を自動追跡する派生値          |
+| `useWatch(ref, cb)` | 値変更時にコールバック。unmount 時に自動解除 |
+
+```ts
+const width = ref(10);
+const height = ref(5);
+const area = computed(() => width.value * height.value); // 自動再計算
+
+useWatch(area, (v) => {
+  output.textContent = String(v);
+});
+```
+
+### Lifecycle
+
+| API              | 説明                                       |
+| ---------------- | ------------------------------------------ |
+| `useMount(fn)`   | マウント完了後に1回実行                    |
+| `useUnmount(fn)` | アンマウント時に実行。クリーンアップに使う |
+
+```ts
+import gsap from 'gsap';
+
+setup(el) {
+  const tween = gsap.from(el, { opacity: 0, duration: 0.4 });
+  useUnmount(() => tween.kill());
+}
+```
+
+### DOM helpers
+
+| API                            | 説明                                            |
+| ------------------------------ | ----------------------------------------------- |
+| `useDomRef<T>()`               | `[data-ref]` 要素を型付きで取得                 |
+| `useRootRef()`                 | ルート要素を取得                                |
+| `useEvent(el, event, handler)` | イベントリスナーを登録。unmount 時に自動除去    |
+| `useSlot()`                    | 子コンポーネントをマウント。親の unmount に連動 |
+
+### Parent / child
+
+`useSlot()` で子コンポーネントをマウントできる。親から子へは `props` または `createContext` / `withContext` で値を渡せる。`addChild()` が返す child context から、子の `setup()` 返り値も参照できる。
+
+→ [examples/parent-child](./examples/parent-child/main.ts)
+
+### Observers
+
+| API                               | 説明                                                |
+| --------------------------------- | --------------------------------------------------- |
+| `useIntersectionWatch(cb, opts?)` | IntersectionObserver。unmount 時に自動解除          |
+| `useMediaQuery(query)`            | `matchMedia` の結果を `ReadonlyRef<boolean>` で返す |
+
+### Addons
+
+```ts
+import { createScheduler } from "@usenagi/core/addons/scheduler";
+import { visible, idle, interaction, media } from "@usenagi/core/addons/cue";
+```
+
+| API                      | 説明                                                                         |
+| ------------------------ | ---------------------------------------------------------------------------- |
+| `createScheduler(opts?)` | `scheduler.schedule(task, { priority, signal })` を実装した Scheduler を返す |
+| `visible(opts?)`         | 要素が viewport に入ったら解決する Cue                                       |
+| `idle(timeout?)`         | `requestIdleCallback` で解決する Cue                                         |
+| `interaction(events?)`   | 最初のユーザー操作で解決する Cue                                             |
+| `media(query)`           | media query が一致したら解決する Cue                                         |
+
+---
+
+## Comparison
+
+|                         | **nagi**    | Alpine.js | Stimulus | petite-vue |
+| ----------------------- | ----------- | --------- | -------- | ---------- |
+| Inline JS in HTML       | ✗           | ◯         | ✗        | ◯          |
+| Composition-style setup | ◯           | △         | ✗        | ◯          |
+| BYO mounter             | ◯           | △         | △        | △          |
+| Async mount cue         | ◯           | ✗         | ✗        | ✗          |
+| Lifecycle cleanup       | ◯           | △         | ◯        | △          |
+| `computed`              | ◯           | ◯         | ✗        | ◯          |
+| Core gzip               | ~2.6-2.9 kB | ~16 kB    | ~8 kB    | ~6 kB      |
+
+◯ = built-in、△ = userland / convention で対応可能、✗ = primary feature ではない。
+
+- **vs Alpine / petite-vue**: HTML に式を書かず、ロジックを `.ts` に寄せる。
+- **vs Stimulus**: Controller 規約なし。mounter は利用側で自由に組める。
+- **vs React / Vue**: 宣言的 UI フレームワークではなく、既存 DOM に lifecycle を足す layer。
+
+---
+
+## When to use / When not to
+
+**向いているケース**:
+
+- React/Vue ほどのランタイムを持ち込みにくいプロジェクト（CMS、Webflow、WordPress 等）
+- GSAP/Lenis を多用する、アニメーション主体のサイト
+- ページの一部だけに interactive な UI を追加したい
+- Composition-style な `setup()` / lifecycle / reactivity で書きたいが、仮想 DOM は不要
+
+**向いていないケース**:
+
+- リスト描画や条件分岐を HTML テンプレートで書きたい（`v-for`, `v-if` 相当は持たない）
+- 深いオブジェクトのリアクティビティが必要（`reactive({})` は提供しない）
+- SSR/hydration が必要
+- アプリ全体の状態管理、ルーティング、宣言的な view rendering をまとめて任せたい
+
+---
+
+## Examples
+
+| Example                                               | 説明                                         |
+| ----------------------------------------------------- | -------------------------------------------- |
+| [basic-counter](./examples/basic-counter/)            | `ref` + `useWatch` の最小例                  |
+| [computed](./examples/computed/)                      | `computed` で派生値 (width × height = area)  |
+| [parent-child](./examples/parent-child/)              | `createContext` + `withContext` + `useSlot`  |
+| [lenis-scroll-scene](./examples/lenis-scroll-scene/)  | Lenis + `computed` でスクロール進捗連動      |
+| [byo-mounter recipe](./examples/recipes/byo-mounter/) | `[data-component]` スキャン + manifest + cue |
+
+---
+
+## License
+
+MIT © [hayakawasho](https://github.com/hayakawasho)

package/dist/addons/cue.cjs.js

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});function e(){return new DOMException(`aborted`,`AbortError`)}function t(t,n,r){t.addEventListener(`abort`,()=>{n(),r(e())},{once:!0})}function n(n){return(r,i)=>new Promise((a,o)=>{if(i.aborted){o(e());return}let s=new IntersectionObserver(e=>{for(let t of e)if(t.isIntersecting){s.disconnect(),a();return}},n);s.observe(r),t(i,()=>s.disconnect(),o)})}function r(n){return(r,i)=>new Promise((r,a)=>{if(i.aborted){a(e());return}if(typeof requestIdleCallback!=`function`){let e=setTimeout(()=>r(),n??0);t(i,()=>clearTimeout(e),a);return}let o=requestIdleCallback(()=>r(),n==null?void 0:{timeout:n});t(i,()=>cancelIdleCallback(o),a)})}function i(n){return(r,i)=>new Promise((r,a)=>{if(i.aborted){a(e());return}let o=matchMedia(n);if(o.matches){r();return}let s=()=>{o.matches&&(o.removeEventListener(`change`,s),r())};o.addEventListener(`change`,s),t(i,()=>o.removeEventListener(`change`,s),a)})}function a(n=[`click`,`focus`,`pointerenter`]){return(r,i)=>new Promise((a,o)=>{if(i.aborted){o(e());return}let s=()=>{for(let e of n)r.removeEventListener(e,c)},c=()=>{s(),a()};for(let e of n)r.addEventListener(e,c,{once:!0});t(i,s,o)})}exports.idle=r,exports.interaction=a,exports.media=i,exports.visible=n;

package/dist/addons/cue.es.js

@@ -0,0 +1,77 @@
+//#region lib/addons/cue/index.ts
+function e() {
+	return new DOMException("aborted", "AbortError");
+}
+function t(t, n, r) {
+	t.addEventListener("abort", () => {
+		n(), r(e());
+	}, { once: !0 });
+}
+function n(n) {
+	return (r, i) => new Promise((a, o) => {
+		if (i.aborted) {
+			o(e());
+			return;
+		}
+		let s = new IntersectionObserver((e) => {
+			for (let t of e) if (t.isIntersecting) {
+				s.disconnect(), a();
+				return;
+			}
+		}, n);
+		s.observe(r), t(i, () => s.disconnect(), o);
+	});
+}
+function r(n) {
+	return (r, i) => new Promise((r, a) => {
+		if (i.aborted) {
+			a(e());
+			return;
+		}
+		if (typeof requestIdleCallback != "function") {
+			let e = setTimeout(() => r(), n ?? 0);
+			t(i, () => clearTimeout(e), a);
+			return;
+		}
+		let o = requestIdleCallback(() => r(), n == null ? void 0 : { timeout: n });
+		t(i, () => cancelIdleCallback(o), a);
+	});
+}
+function i(n) {
+	return (r, i) => new Promise((r, a) => {
+		if (i.aborted) {
+			a(e());
+			return;
+		}
+		let o = matchMedia(n);
+		if (o.matches) {
+			r();
+			return;
+		}
+		let s = () => {
+			o.matches && (o.removeEventListener("change", s), r());
+		};
+		o.addEventListener("change", s), t(i, () => o.removeEventListener("change", s), a);
+	});
+}
+function a(n = [
+	"click",
+	"focus",
+	"pointerenter"
+]) {
+	return (r, i) => new Promise((a, o) => {
+		if (i.aborted) {
+			o(e());
+			return;
+		}
+		let s = () => {
+			for (let e of n) r.removeEventListener(e, c);
+		}, c = () => {
+			s(), a();
+		};
+		for (let e of n) r.addEventListener(e, c, { once: !0 });
+		t(i, s, o);
+	});
+}
+//#endregion
+export { r as idle, a as interaction, i as media, n as visible };

package/dist/addons/scheduler.cjs.js

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});function e(e){return(e instanceof DOMException||e instanceof Error)&&e.name===`AbortError`}function t(t,r,i){if(i?.aborted)return;let{scheduler:a}=globalThis;if(typeof a?.postTask==`function`){a.postTask(t,{priority:r,signal:i}).catch(t=>{e(t)||queueMicrotask(()=>{throw t})});return}n(t,r,i)}function n(e,t,n){function r(){n?.aborted||e()}function i(e,t){let r=e();n?.addEventListener(`abort`,()=>t(r),{once:!0})}switch(t){case`user-blocking`:queueMicrotask(r);break;case`user-visible`:i(()=>requestAnimationFrame(r),cancelAnimationFrame);break;case`background`:typeof requestIdleCallback==`function`?i(()=>requestIdleCallback(r),cancelIdleCallback):i(()=>setTimeout(r,0),clearTimeout);break}}function r(e={}){let n=e.priority??`user-visible`;return{schedule(e,r={}){t(e,r.priority??n,r.signal)}}}exports.createScheduler=r;

package/dist/addons/scheduler.es.js

@@ -0,0 +1,52 @@
+//#region lib/utils/isAbortError.ts
+function e(e) {
+	return (e instanceof DOMException || e instanceof Error) && e.name === "AbortError";
+}
+//#endregion
+//#region lib/addons/scheduler/task.ts
+function t(t, r, i) {
+	if (i?.aborted) return;
+	let { scheduler: a } = globalThis;
+	if (typeof a?.postTask == "function") {
+		a.postTask(t, {
+			priority: r,
+			signal: i
+		}).catch((t) => {
+			e(t) || queueMicrotask(() => {
+				throw t;
+			});
+		});
+		return;
+	}
+	n(t, r, i);
+}
+function n(e, t, n) {
+	function r() {
+		n?.aborted || e();
+	}
+	function i(e, t) {
+		let r = e();
+		n?.addEventListener("abort", () => t(r), { once: !0 });
+	}
+	switch (t) {
+		case "user-blocking":
+			queueMicrotask(r);
+			break;
+		case "user-visible":
+			i(() => requestAnimationFrame(r), cancelAnimationFrame);
+			break;
+		case "background":
+			typeof requestIdleCallback == "function" ? i(() => requestIdleCallback(r), cancelIdleCallback) : i(() => setTimeout(r, 0), clearTimeout);
+			break;
+	}
+}
+//#endregion
+//#region lib/addons/scheduler/index.ts
+function r(e = {}) {
+	let n = e.priority ?? "user-visible";
+	return { schedule(e, r = {}) {
+		t(e, r.priority ?? n, r.signal);
+	} };
+}
+//#endregion
+export { r as createScheduler };

package/dist/main.es.js

@@ -0,0 +1,377 @@
+//#region lib/utils/isAbortError.ts
+function e(e) {
+	return (e instanceof DOMException || e instanceof Error) && e.name === "AbortError";
+}
+//#endregion
+//#region lib/core/internal/pending.ts
+function t() {
+	let e = /* @__PURE__ */ new Map();
+	return {
+		add(t) {
+			let n = e.get(t);
+			n && n.abort();
+			let r = new AbortController();
+			return e.set(t, r), {
+				signal: r.signal,
+				complete() {
+					return e.get(t) !== r || r.signal.aborted ? !1 : (e.delete(t), !0);
+				},
+				abort() {
+					e.get(t) === r && (r.abort(), e.delete(t));
+				}
+			};
+		},
+		abort(t) {
+			let n = e.get(t);
+			n && (n.abort(), e.delete(t));
+		}
+	};
+}
+//#endregion
+//#region lib/core/error.ts
+function n(e) {
+	let t = [], n = e;
+	for (; n;) t.unshift(n.name), n = n.parent;
+	return t.join(" > ");
+}
+var r = class e extends Error {
+	details;
+	constructor(e) {
+		super(`[nagi] Component error in phase "${e.phase}" for "${e.name}"${e.path ? ` (${e.path})` : ""}`, { cause: e.cause }), this.name = "LifecycleError", this.details = e;
+	}
+	static create(t, r, i, a = r.parent, o) {
+		return new e({
+			phase: t,
+			name: r.name,
+			uid: r.uid,
+			path: n(r),
+			parentName: a?.name,
+			parentUid: a?.uid,
+			element: r.element,
+			cause: i,
+			...o
+		});
+	}
+};
+function i(e) {
+	return e instanceof r;
+}
+//#endregion
+//#region lib/core/internal/registry.ts
+var a = /* @__PURE__ */ new WeakMap();
+function o(e, t) {
+	let n = a.get(e);
+	if (n) throw r.create("mount", t, /* @__PURE__ */ Error(`Component "${n.name}" (${n.uid}) is already mounted on this element`), n);
+	a.set(e, t);
+}
+//#endregion
+//#region lib/core/component.ts
+var s = /* @__PURE__ */ function(e) {
+	return e.MOUNTED = "Mounted", e.UNMOUNTED = "Unmounted", e;
+}({}), c = 0, l = class {
+	Mounted = [];
+	Unmounted = [];
+	parent = null;
+	#e = [];
+	uid;
+	name;
+	current = {};
+	props = {};
+	element;
+	provides = /* @__PURE__ */ new Map();
+	constructor(e, t) {
+		this.uid = `${t}.${c++}`, this.name = t, this.element = e;
+	}
+	onMount = () => {
+		let e = [];
+		for (let t of this.Mounted) try {
+			let n = t();
+			typeof n == "function" && e.push(n);
+		} catch (e) {
+			console.error("[nagi] onMount hook failed", r.create("mount", this, e));
+		}
+		this.Unmounted.push(...e);
+	};
+	onUnmount = () => {
+		for (let e of this.Unmounted) try {
+			e();
+		} catch (e) {
+			console.error("[nagi] onUnmount cleanup failed", r.create("unmount", this, e));
+		}
+		for (let e of this.#e) e.onUnmount();
+	};
+	addChild = (e) => {
+		this.#e.push(e), e.parent = this;
+		try {
+			e.onMount();
+		} catch (t) {
+			let n = this.#e.indexOf(e);
+			throw n !== -1 && this.#e.splice(n, 1), e.parent = null, t;
+		}
+	};
+	removeChild = (e) => {
+		let t = this.#e.indexOf(e);
+		t !== -1 && (this.#e.splice(t, 1), e.parent = null, e.onUnmount());
+	};
+	get childElements() {
+		return this.#e.map((e) => e.element);
+	}
+};
+function u(e) {
+	return e === void 0 ? (e) => (t) => ({
+		name: e.name,
+		setup(n) {
+			return e.setup(n, t);
+		}
+	}) : e;
+}
+//#endregion
+//#region lib/core/runtime.ts
+var d;
+function f(e) {
+	if (!d) throw Error(`"${e}" called outside setup() will never be run.`);
+	return d;
+}
+function p(e, t, n) {
+	let a = new l(t, e.name), o = d;
+	d = a;
+	try {
+		o && (a.parent = o), a.props = n, a.current = e.setup(t, n) || {};
+	} catch (e) {
+		throw d = o, i(e) ? e : r.create("setup", a, e, o, { props: a.props });
+	}
+	return d = o, a;
+}
+//#endregion
+//#region lib/core/app.ts
+function m(n = {}) {
+	let { scheduler: r } = n, i = t();
+	return {
+		component(t, { priority: n, when: a } = {}) {
+			return (s, c = {}) => {
+				function l() {
+					let e = p(t, s, c);
+					return o(s, e), e.onMount(), e;
+				}
+				if (!r) return l();
+				let u = i.add(s), d = () => {
+					r.schedule(() => {
+						u.complete() && l();
+					}, {
+						priority: n,
+						signal: u.signal
+					});
+				};
+				a ? a(s, u.signal).then(() => {
+					u.signal.aborted || d();
+				}, (t) => {
+					e(t) || (u.abort(), queueMicrotask(() => {
+						throw t;
+					}));
+				}) : d();
+			};
+		},
+		unmount(e) {
+			for (let t of e) {
+				i.abort(t);
+				let e = a.get(t);
+				e && (e.onUnmount(), a.delete(t));
+			}
+		}
+	};
+}
+//#endregion
+//#region lib/core/lifecycle.ts
+function h(e) {
+	return (t) => {
+		f(e)[e].push(t);
+	};
+}
+var g = h(s.MOUNTED), _ = h(s.UNMOUNTED), v = Symbol("watch"), y = null, b = class {
+	#e;
+	#t = /* @__PURE__ */ new Set();
+	constructor(e) {
+		this.#e = e;
+	}
+	get value() {
+		return y !== null && y.add(this), this.#e;
+	}
+	set value(e) {
+		if (Object.is(e, this.#e)) return;
+		let t = this.#e;
+		this.#e = e;
+		for (let n of Array.from(this.#t)) n(e, t);
+	}
+	[v](e) {
+		return this.#t.add(e), () => {
+			this.#t.delete(e);
+		};
+	}
+}, x = (e) => new b(e), S = class {
+	#e;
+	constructor(e) {
+		this.#e = e;
+	}
+	get value() {
+		return this.#e.value;
+	}
+	[v](e) {
+		return this.#e[v](e);
+	}
+}, C = (e) => new S(e);
+function w(e, t) {
+	return e[v](t);
+}
+function T(e, t) {
+	_(w(e, t));
+}
+function E(e) {
+	let t = x(void 0), n = [], r = () => {
+		n.forEach((e) => {
+			e();
+		}), n = [];
+	}, i = () => {
+		r();
+		let a = y, o = /* @__PURE__ */ new Set();
+		y = o;
+		let s;
+		try {
+			s = e();
+		} finally {
+			y = a;
+		}
+		t.value = s;
+		for (let e of o) n.push(e[v](() => {
+			i();
+		}));
+	};
+	return i(), _(r), C(t);
+}
+//#endregion
+//#region lib/hooks/createContext.ts
+function D() {
+	let e = Symbol();
+	return [{ _id: e }, () => {
+		let t = f("createContext.use");
+		for (; t !== null;) {
+			if (t.provides.has(e)) return t.provides.get(e);
+			t = t.parent;
+		}
+		throw Error("createContext.use: no provider found");
+	}];
+}
+function O(e, t) {
+	return (n) => ({
+		name: n.name,
+		setup(r, i) {
+			return f(`withContext.${n.name}`).provides.set(e._id, t), n.setup(r, i);
+		}
+	});
+}
+//#endregion
+//#region lib/hooks/domRefs.ts
+function k(e, t) {
+	return t.some((t) => t !== e && t.contains(e));
+}
+function A(e, t, n) {
+	let r = `[data-ref="${CSS.escape(e)}"]`, i = Array.from(t.querySelectorAll(r)).filter((e) => !k(e, n));
+	return i.length === 0 ? null : i.length === 1 ? i[0] : i;
+}
+function j(e, t) {
+	let n = /* @__PURE__ */ new Map();
+	return new Proxy({}, {
+		get(r, i) {
+			if (typeof i == "symbol" || i === "then") return;
+			if (n.has(i)) return n.get(i);
+			let a = A(i, e, t());
+			return n.set(i, a), a;
+		},
+		has(e, t) {
+			return typeof t == "string";
+		},
+		ownKeys() {
+			return [];
+		},
+		getOwnPropertyDescriptor() {},
+		set() {
+			return !1;
+		},
+		deleteProperty() {
+			return !1;
+		}
+	});
+}
+//#endregion
+//#region lib/hooks/useDomRef.ts
+function M() {
+	let e = f("useDomRef");
+	return { refs: j(e.element, () => e.childElements) };
+}
+//#endregion
+//#region lib/hooks/useEvent.ts
+function N(e, t, n, r) {
+	g(() => (e.addEventListener(t, n, r), () => {
+		e.removeEventListener(t, n, r);
+	}));
+}
+//#endregion
+//#region lib/hooks/useIntersectionWatch.ts
+function P(e, t, n = {
+	rootMargin: "0px",
+	threshold: .1
+}) {
+	let r = new IntersectionObserver(t, n);
+	function i(e) {
+		Array.isArray(e) ? e.forEach((e) => {
+			r.observe(e);
+		}) : r.observe(e);
+	}
+	i(e), _(() => {
+		r.disconnect();
+	});
+	function a(e) {
+		r.unobserve(e);
+	}
+	return { unwatch: a };
+}
+//#endregion
+//#region lib/hooks/useMediaQuery.ts
+function F(e, t) {
+	let n = window.matchMedia(e), r = x(n.matches), i = null;
+	function a(e) {
+		r.value = e.matches, e.matches ? i = t() : (i?.(), i = null);
+	}
+	return g(() => (n.addEventListener("change", a), n.matches && (i = t()), () => {
+		i?.(), n.removeEventListener("change", a);
+	})), { matchesQuery: C(r) };
+}
+//#endregion
+//#region lib/hooks/useRootRef.ts
+function I() {
+	return f("useRootRef").element;
+}
+//#endregion
+//#region lib/hooks/useSlot.ts
+function L() {
+	let e = f("useSlot");
+	return {
+		addChild(t, n, r = {}) {
+			let i = (t) => {
+				let i = p(n, t, r);
+				return e.addChild(i), i;
+			};
+			return Array.isArray(t) ? t.map((e) => i(e)) : [i(t)];
+		},
+		removeChild(t) {
+			t.forEach((t) => {
+				try {
+					e.removeChild(t);
+				} catch (n) {
+					console.error("[nagi] removeChild failed", r.create("removeChild", t, n, e));
+				}
+			});
+		}
+	};
+}
+//#endregion
+export { r as LifecycleError, E as computed, m as create, D as createContext, u as defineComponent, i as isLifecycleError, C as readonly, x as ref, M as useDomRef, N as useEvent, P as useIntersectionWatch, F as useMediaQuery, g as useMount, I as useRootRef, L as useSlot, _ as useUnmount, T as useWatch, O as withContext };

package/dist/main.umd.js

@@ -0,0 +1 @@
+(function(e,t){typeof exports==`object`&&typeof module<`u`?t(exports):typeof define==`function`&&define.amd?define([`exports`],t):(e=typeof globalThis<`u`?globalThis:e||self,t(e.Lake={}))})(this,function(e){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});function t(e){return(e instanceof DOMException||e instanceof Error)&&e.name===`AbortError`}function n(){let e=new Map;return{add(t){let n=e.get(t);n&&n.abort();let r=new AbortController;return e.set(t,r),{signal:r.signal,complete(){return e.get(t)!==r||r.signal.aborted?!1:(e.delete(t),!0)},abort(){e.get(t)===r&&(r.abort(),e.delete(t))}}},abort(t){let n=e.get(t);n&&(n.abort(),e.delete(t))}}}function r(e){let t=[],n=e;for(;n;)t.unshift(n.name),n=n.parent;return t.join(` > `)}var i=class e extends Error{details;constructor(e){super(`[nagi] Component error in phase "${e.phase}" for "${e.name}"${e.path?` (${e.path})`:``}`,{cause:e.cause}),this.name=`LifecycleError`,this.details=e}static create(t,n,i,a=n.parent,o){return new e({phase:t,name:n.name,uid:n.uid,path:r(n),parentName:a?.name,parentUid:a?.uid,element:n.element,cause:i,...o})}};function a(e){return e instanceof i}var o=new WeakMap;function s(e,t){let n=o.get(e);if(n)throw i.create(`mount`,t,Error(`Component "${n.name}" (${n.uid}) is already mounted on this element`),n);o.set(e,t)}var c=function(e){return e.MOUNTED=`Mounted`,e.UNMOUNTED=`Unmounted`,e}({}),l=0,u=class{Mounted=[];Unmounted=[];parent=null;#e=[];uid;name;current={};props={};element;provides=new Map;constructor(e,t){this.uid=`${t}.${l++}`,this.name=t,this.element=e}onMount=()=>{let e=[];for(let t of this.Mounted)try{let n=t();typeof n==`function`&&e.push(n)}catch(e){console.error(`[nagi] onMount hook failed`,i.create(`mount`,this,e))}this.Unmounted.push(...e)};onUnmount=()=>{for(let e of this.Unmounted)try{e()}catch(e){console.error(`[nagi] onUnmount cleanup failed`,i.create(`unmount`,this,e))}for(let e of this.#e)e.onUnmount()};addChild=e=>{this.#e.push(e),e.parent=this;try{e.onMount()}catch(t){let n=this.#e.indexOf(e);throw n!==-1&&this.#e.splice(n,1),e.parent=null,t}};removeChild=e=>{let t=this.#e.indexOf(e);t!==-1&&(this.#e.splice(t,1),e.parent=null,e.onUnmount())};get childElements(){return this.#e.map(e=>e.element)}};function d(e){return e===void 0?e=>t=>({name:e.name,setup(n){return e.setup(n,t)}}):e}var f;function p(e){if(!f)throw Error(`"${e}" called outside setup() will never be run.`);return f}function m(e,t,n){let r=new u(t,e.name),o=f;f=r;try{o&&(r.parent=o),r.props=n,r.current=e.setup(t,n)||{}}catch(e){throw f=o,a(e)?e:i.create(`setup`,r,e,o,{props:r.props})}return f=o,r}function h(e={}){let{scheduler:r}=e,i=n();return{component(e,{priority:n,when:a}={}){return(o,c={})=>{function l(){let t=m(e,o,c);return s(o,t),t.onMount(),t}if(!r)return l();let u=i.add(o),d=()=>{r.schedule(()=>{u.complete()&&l()},{priority:n,signal:u.signal})};a?a(o,u.signal).then(()=>{u.signal.aborted||d()},e=>{t(e)||(u.abort(),queueMicrotask(()=>{throw e}))}):d()}},unmount(e){for(let t of e){i.abort(t);let e=o.get(t);e&&(e.onUnmount(),o.delete(t))}}}}function g(e){return t=>{p(e)[e].push(t)}}var _=g(c.MOUNTED),v=g(c.UNMOUNTED),y=Symbol(`watch`),b=null,x=class{#e;#t=new Set;constructor(e){this.#e=e}get value(){return b!==null&&b.add(this),this.#e}set value(e){if(Object.is(e,this.#e))return;let t=this.#e;this.#e=e;for(let n of Array.from(this.#t))n(e,t)}[y](e){return this.#t.add(e),()=>{this.#t.delete(e)}}},S=e=>new x(e),C=class{#e;constructor(e){this.#e=e}get value(){return this.#e.value}[y](e){return this.#e[y](e)}},w=e=>new C(e);function T(e,t){return e[y](t)}function E(e,t){v(T(e,t))}function D(e){let t=S(void 0),n=[],r=()=>{n.forEach(e=>{e()}),n=[]},i=()=>{r();let a=b,o=new Set;b=o;let s;try{s=e()}finally{b=a}t.value=s;for(let e of o)n.push(e[y](()=>{i()}))};return i(),v(r),w(t)}function O(){let e=Symbol();return[{_id:e},()=>{let t=p(`createContext.use`);for(;t!==null;){if(t.provides.has(e))return t.provides.get(e);t=t.parent}throw Error(`createContext.use: no provider found`)}]}function k(e,t){return n=>({name:n.name,setup(r,i){return p(`withContext.${n.name}`).provides.set(e._id,t),n.setup(r,i)}})}function A(e,t){return t.some(t=>t!==e&&t.contains(e))}function j(e,t,n){let r=`[data-ref="${CSS.escape(e)}"]`,i=Array.from(t.querySelectorAll(r)).filter(e=>!A(e,n));return i.length===0?null:i.length===1?i[0]:i}function M(e,t){let n=new Map;return new Proxy({},{get(r,i){if(typeof i==`symbol`||i===`then`)return;if(n.has(i))return n.get(i);let a=j(i,e,t());return n.set(i,a),a},has(e,t){return typeof t==`string`},ownKeys(){return[]},getOwnPropertyDescriptor(){},set(){return!1},deleteProperty(){return!1}})}function N(){let e=p(`useDomRef`);return{refs:M(e.element,()=>e.childElements)}}function P(e,t,n,r){_(()=>(e.addEventListener(t,n,r),()=>{e.removeEventListener(t,n,r)}))}function F(e,t,n={rootMargin:`0px`,threshold:.1}){let r=new IntersectionObserver(t,n);function i(e){Array.isArray(e)?e.forEach(e=>{r.observe(e)}):r.observe(e)}i(e),v(()=>{r.disconnect()});function a(e){r.unobserve(e)}return{unwatch:a}}function I(e,t){let n=window.matchMedia(e),r=S(n.matches),i=null;function a(e){r.value=e.matches,e.matches?i=t():(i?.(),i=null)}return _(()=>(n.addEventListener(`change`,a),n.matches&&(i=t()),()=>{i?.(),n.removeEventListener(`change`,a)})),{matchesQuery:w(r)}}function L(){return p(`useRootRef`).element}function R(){let e=p(`useSlot`);return{addChild(t,n,r={}){let i=t=>{let i=m(n,t,r);return e.addChild(i),i};return Array.isArray(t)?t.map(e=>i(e)):[i(t)]},removeChild(t){t.forEach(t=>{try{e.removeChild(t)}catch(n){console.error(`[nagi] removeChild failed`,i.create(`removeChild`,t,n,e))}})}}}e.LifecycleError=i,e.computed=D,e.create=h,e.createContext=O,e.defineComponent=d,e.isLifecycleError=a,e.readonly=w,e.ref=S,e.useDomRef=N,e.useEvent=P,e.useIntersectionWatch=F,e.useMediaQuery=I,e.useMount=_,e.useRootRef=L,e.useSlot=R,e.useUnmount=v,e.useWatch=E,e.withContext=k});

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@usenagi/core",
+  "version": "0.1.0",
+  "description": "Composition-API ergonomics for vanilla DOM. Bring your own mounter.",
+  "main": "./dist/main.umd.js",
+  "module": "./dist/main.es.js",
+  "exports": {
+    ".": {
+      "types": "./types/main.d.ts",
+      "import": "./dist/main.es.js",
+      "require": "./dist/main.umd.js"
+    },
+    "./addons/scheduler": {
+      "types": "./types/addons/scheduler/index.d.ts",
+      "import": "./dist/addons/scheduler.es.js",
+      "require": "./dist/addons/scheduler.cjs.js"
+    },
+    "./addons/cue": {
+      "types": "./types/addons/cue/index.d.ts",
+      "import": "./dist/addons/cue.es.js",
+      "require": "./dist/addons/cue.cjs.js"
+    }
+  },
+  "files": [
+    "dist",
+    "types"
+  ],
+  "author": "hayakawasho",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hayakawasho/nagi.git"
+  },
+  "bugs": {
+    "url": "https://github.com/hayakawasho/nagi/issues"
+  },
+  "homepage": "https://github.com/hayakawasho/nagi#readme",
+  "keywords": [
+    "dom",
+    "component",
+    "reactivity",
+    "composition-api",
+    "gsap",
+    "animation",
+    "vanilla",
+    "progressive-enhancement"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "NODE_ENV=production tsc && vite build && vite build --config vite.addons.config.ts",
+    "watch": "vite build -w",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "oxlint ./lib",
+    "format": "biome format --write ./lib",
+    "fix:biome": "biome check --write ./lib",
+    "fix": "npm run fix:biome"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.13",
+    "happy-dom": "^20.9.0",
+    "oxlint": "^1.61.0",
+    "typescript": "^6.0.3",
+    "vite": "^8.0.10",
+    "vitest": "^4.1.5"
+  },
+  "type": "module",
+  "sideEffects": false
+}

package/types/addons/cue/index.d.ts

@@ -0,0 +1,5 @@
+import type { Cue } from "../../types";
+export declare function visible(opts?: IntersectionObserverInit): Cue;
+export declare function idle(timeout?: number): Cue;
+export declare function media(query: string): Cue;
+export declare function interaction(events?: string[]): Cue;

package/types/addons/scheduler/index.d.ts

@@ -0,0 +1,4 @@
+import type { SchedulePriority, Scheduler } from "../../types";
+export declare function createScheduler(opts?: {
+    priority?: SchedulePriority;
+}): Scheduler;

package/types/addons/scheduler/task.d.ts

@@ -0,0 +1,2 @@
+import type { SchedulePriority } from "../../types";
+export declare function scheduleTask(task: () => void, priority: SchedulePriority, signal?: AbortSignal): void;

package/types/core/app.d.ts

@@ -0,0 +1,27 @@
+import type { ComponentSetup, Cue, RefElement, SchedulePriority, Scheduler } from "../types";
+import type { ComponentContext } from "./component";
+type AppOptions = {
+    priority?: SchedulePriority;
+};
+type AsyncAppOptions = AppOptions & {
+    when?: Cue;
+};
+type SyncApp = {
+    component<S extends ComponentSetup>(wrap: S, opts?: AppOptions): (el: RefElement, props?: Record<string, any>) => ComponentContext<ReturnType<S["setup"]>>;
+    unmount(targets: RefElement[]): void;
+};
+type AsyncApp = {
+    component<S extends ComponentSetup>(wrap: S, opts?: AsyncAppOptions): (el: RefElement, props?: Record<string, any>) => void;
+    unmount(targets: RefElement[]): void;
+};
+export declare function create(): SyncApp;
+export declare function create(config: {
+    scheduler?: undefined;
+}): SyncApp;
+export declare function create(config: {
+    scheduler: Scheduler;
+}): AsyncApp;
+export declare function create(config: {
+    scheduler?: Scheduler | undefined;
+}): SyncApp | AsyncApp;
+export {};

package/types/core/component.d.ts

@@ -0,0 +1,28 @@
+import type { ComponentSetup, RefElement } from "../types";
+export declare enum LifecycleHooks {
+    MOUNTED = "Mounted",
+    UNMOUNTED = "Unmounted"
+}
+export declare class ComponentContext<T = any> {
+    #private;
+    private [LifecycleHooks.MOUNTED];
+    private [LifecycleHooks.UNMOUNTED];
+    parent: ComponentContext<T> | null;
+    readonly uid: string;
+    readonly name: string;
+    current: ReturnType<ComponentSetup<T>["setup"]>;
+    props: Parameters<ComponentSetup<T>["setup"]>[1];
+    element: RefElement;
+    provides: Map<symbol, unknown>;
+    constructor(element: RefElement, name: string);
+    onMount: () => void;
+    onUnmount: () => void;
+    addChild: (child: ComponentContext) => void;
+    removeChild: (child: ComponentContext) => void;
+    get childElements(): RefElement[];
+}
+export declare function defineComponent<Context extends Record<string, unknown>>(): <SetupResult extends Record<string, unknown> | void>(opts: {
+    name: string;
+    setup(el: RefElement, context: Context): SetupResult;
+}) => (context: Context) => ComponentSetup<SetupResult>;
+export declare function defineComponent<SetupResult extends Record<string, unknown> | void, Props extends Record<string, unknown>>(opts: ComponentSetup<SetupResult, Props>): ComponentSetup<SetupResult, Props>;

package/types/core/error.d.ts

@@ -0,0 +1,20 @@
+import type { RefElement } from "../types";
+import type { ComponentContext } from "./component";
+export type LifecycleErrorDetails = {
+    phase: "setup" | "mount" | "unmount" | "removeChild";
+    name: string;
+    uid?: string;
+    path?: string;
+    parentName?: string;
+    parentUid?: string;
+    element?: RefElement;
+    props?: unknown;
+    cause: unknown;
+};
+export declare function traceComponentTree(context: ComponentContext): string;
+export declare class LifecycleError extends Error {
+    readonly details: LifecycleErrorDetails;
+    constructor(details: LifecycleErrorDetails);
+    static create(phase: LifecycleErrorDetails["phase"], target: ComponentContext, cause: unknown, parent?: ComponentContext | null | undefined, extra?: Partial<LifecycleErrorDetails>): LifecycleError;
+}
+export declare function isLifecycleError(error: unknown): error is LifecycleError;

package/types/core/internal/pending.d.ts

@@ -0,0 +1,11 @@
+import type { RefElement } from "../../types";
+export type PendingMountTask = {
+    readonly signal: AbortSignal;
+    complete(): boolean;
+    abort(): void;
+};
+export type PendingMountTasks = {
+    add(el: RefElement): PendingMountTask;
+    abort(el: RefElement): void;
+};
+export declare function createPendingMountTasks(): PendingMountTasks;

package/types/core/internal/registry.d.ts

@@ -0,0 +1,4 @@
+import type { RefElement } from "../../types";
+import type { ComponentContext } from "../component";
+export declare const DOM_COMPONENT_INSTANCE: WeakMap<RefElement, ComponentContext<any>>;
+export declare function bindDOMNodeToComponent(el: RefElement, component: ComponentContext): void;

package/types/core/lifecycle.d.ts

@@ -0,0 +1,3 @@
+import type { LifecycleHandler } from "../types";
+export declare const useMount: (hook: LifecycleHandler) => void;
+export declare const useUnmount: (hook: LifecycleHandler) => void;

package/types/core/reactivity.d.ts

@@ -0,0 +1,22 @@
+type WatchCallback<T> = (newVal: T, oldVal: T) => void;
+type Unwatch = () => void;
+declare const WATCH: unique symbol;
+declare class Ref<T> {
+    #private;
+    constructor(value: T);
+    get value(): T;
+    set value(newVal: T);
+    [WATCH](callback: WatchCallback<T>): Unwatch;
+}
+declare const ref: <T = any>(val: T) => Ref<T>;
+declare class ReadonlyRef<T> {
+    #private;
+    constructor(value: Ref<T>);
+    get value(): T;
+    [WATCH](callback: WatchCallback<T>): Unwatch;
+}
+declare const readonly: <T = any>(ref: Ref<T>) => ReadonlyRef<T>;
+declare function useWatch<T>(ref: Ref<T> | ReadonlyRef<T>, callback: WatchCallback<T>): void;
+declare function computed<T>(getter: () => T): ReadonlyRef<T>;
+export { computed, readonly, ref, useWatch };
+export type { ReadonlyRef, Ref };

package/types/core/runtime.d.ts

@@ -0,0 +1,4 @@
+import { ComponentContext } from "./component";
+import type { ComponentSetup, RefElement } from "../types";
+export declare function getCurrentComponent(hookName: string): ComponentContext;
+export declare function createComponent(wrap: ComponentSetup, root: RefElement, props: Record<string, any>): ComponentContext<any>;

package/types/hooks/createContext.d.ts

@@ -0,0 +1,7 @@
+import type { ComponentSetup } from "../types";
+export type Provider<T> = {
+    readonly _id: symbol;
+    readonly _type?: T;
+};
+export declare function createContext<T>(): [Provider<T>, () => Readonly<T>];
+export declare function withContext<T>(key: Provider<T>, value: T): <SetupResult extends Record<string, unknown> | void, Props extends Record<string, unknown>>(component: ComponentSetup<SetupResult, Props>) => ComponentSetup<SetupResult, Props>;

package/types/hooks/domRefs.d.ts

@@ -0,0 +1,2 @@
+import type { RefElement } from "../types";
+export declare function domRefs<T extends Record<string, RefElement | RefElement[] | null>>(scope: RefElement, getBoundaries: () => RefElement[]): T;

package/types/hooks/useDomRef.d.ts

@@ -0,0 +1,4 @@
+import type { RefElement } from "../types";
+export declare function useDomRef<T extends Record<string, RefElement | RefElement[] | null>>(): {
+    refs: T;
+};

package/types/hooks/useEvent.d.ts

@@ -0,0 +1,3 @@
+type ElementEventListener<K extends keyof HTMLElementEventMap = keyof HTMLElementEventMap> = (this: HTMLElement, ev: HTMLElementEventMap[K]) => unknown;
+export declare function useEvent<T extends HTMLElement = HTMLElement, K extends keyof HTMLElementEventMap = keyof HTMLElementEventMap>(target: T, eventType: K, listener: ElementEventListener<K>, optionsOrUseCapture?: boolean | AddEventListenerOptions): void;
+export {};

package/types/hooks/useIntersectionWatch.d.ts

@@ -0,0 +1,3 @@
+export declare function useIntersectionWatch<T extends Element>(targetOrTargets: T | T[], callback: IntersectionObserverCallback, opts?: IntersectionObserverInit): {
+    unwatch: (el: T) => void;
+};

package/types/hooks/useMediaQuery.d.ts

@@ -0,0 +1,4 @@
+import type { Cleanup } from "../types";
+export declare function useMediaQuery(query: string, callbackWhenMatches: () => Cleanup): {
+    readonly matchesQuery: import("../main").ReadonlyRef<boolean>;
+};

package/types/hooks/useRootRef.d.ts

@@ -0,0 +1,2 @@
+import type { RefElement } from "../types";
+export declare function useRootRef<T extends RefElement = RefElement>(): T;

package/types/hooks/useSlot.d.ts

@@ -0,0 +1,6 @@
+import type { ComponentContext } from "../core/component";
+import type { ComponentSetup, RefElement } from "../types";
+export declare function useSlot(): {
+    addChild<Child extends ComponentSetup>(targetOrTargets: RefElement | RefElement[], child: Child, props?: Parameters<Child["setup"]>[1]): ComponentContext<ReturnType<Child["setup"]>>[];
+    removeChild(children: ComponentContext[]): void;
+};

package/types/main.d.ts

@@ -0,0 +1,17 @@
+export { create } from "./core/app";
+export { defineComponent } from "./core/component";
+export { isLifecycleError, LifecycleError } from "./core/error";
+export { useMount, useUnmount } from "./core/lifecycle";
+export { computed, readonly, ref, useWatch } from "./core/reactivity";
+export { createContext, withContext } from "./hooks/createContext";
+export { useDomRef } from "./hooks/useDomRef";
+export { useEvent } from "./hooks/useEvent";
+export { useIntersectionWatch } from "./hooks/useIntersectionWatch";
+export { useMediaQuery } from "./hooks/useMediaQuery";
+export { useRootRef } from "./hooks/useRootRef";
+export { useSlot } from "./hooks/useSlot";
+export type { ComponentContext } from "./core/component";
+export type { LifecycleErrorDetails } from "./core/error";
+export type { ReadonlyRef, Ref } from "./core/reactivity";
+export type { Provider } from "./hooks/createContext";
+export type { ComponentSetup, Cue, IComponent, RefElement, SchedulePriority, Scheduler, } from "./types";

package/types/types.d.ts

@@ -0,0 +1,18 @@
+export type RefElement = HTMLElement | SVGElement;
+export type ComponentProps<Props> = Readonly<Props>;
+export type ComponentSetup<SetupResult = void | Record<string, unknown>, Props = Record<string, unknown>> = {
+    name: string;
+    setup(el: RefElement, props: ComponentProps<Props>): SetupResult;
+};
+/** @deprecated Use `ComponentSetup` instead. */
+export type IComponent<SetupResult = void | Record<string, unknown>, Props = Record<string, unknown>> = ComponentSetup<SetupResult, Props>;
+export type Cleanup = () => void;
+export type LifecycleHandler = () => void | Cleanup;
+export type SchedulePriority = "user-blocking" | "user-visible" | "background";
+export type Scheduler = {
+    schedule(task: () => void, options?: {
+        priority?: SchedulePriority;
+        signal?: AbortSignal;
+    }): void;
+};
+export type Cue = (el: RefElement, signal: AbortSignal) => Promise<void>;

package/types/utils/isAbortError.d.ts

@@ -0,0 +1 @@
+export declare function isAbortError(error: unknown): boolean;