@usenagi/core 0.3.0 → 0.4.0

package/README.ja.md

@@ -32,9 +32,9 @@ GSAP、Lenis、IntersectionObserver などを `setup()` で初期化し、`useUn
 // counter.ts
 import { create, signal, useWatch, useDomRef } from "@usenagi/core";
 
-const { component } = create();
+const app = create();
 
-component({
+app.component({
   name: "counter",
   setup() {
     const { refs } = useDomRef<{
@@ -71,13 +71,14 @@ npm i @usenagi/core
 ### First component
 
 ```ts
-import { create, defineComponent, signal, useWatch, useDomRef } from "@usenagi/core";
+import { create, defineComponent, propTypes, signal, useWatch, useDomRef } from "@usenagi/core";
 
 const Greeting = defineComponent({
   name: "greeting",
+  props: propTypes<{ name: string }>(),
   setup(el, props) {
     const { refs } = useDomRef<{ message: HTMLParagraphElement }>();
-    const text = signal((props.name as string) ?? "world");
+    const text = signal(props.name ?? "world");
 
     useWatch(text, (v) => {
       refs.message.textContent = `Hello, ${v}!`;
@@ -118,6 +119,13 @@ app.component(Analytics, { when: idle() })(el);
 
 ## API
 
+### Component Definition
+
+| API                    | 説明                                                             |
+| ---------------------- | ---------------------------------------------------------------- |
+| `defineComponent(opts)` | 型安全な `ComponentSetup` 定義ヘルパー                          |
+| `propTypes<T>()`       | コンポーネント props の型マーカー（ランタイムコストゼロ）         |
+
 ### Reactivity
 
 | API                    | 説明                                                   |
@@ -174,7 +182,7 @@ setup(el) {
 | API                               | 説明                                                        |
 | --------------------------------- | ----------------------------------------------------------- |
 | `useIntersectionWatch(cb, opts?)` | IntersectionObserver のラッパー。unmount 時に自動で切断する |
-| `useMediaQuery(query)`            | `matchMedia` の結果を `ReadonlySignal<boolean>` で返す      |
+| `useMediaQuery(query, cb)` | query 一致時に callback を実行し、`matchesQuery` を `ReadonlySignal<boolean>` で返す |
 
 ### Addons
 
@@ -205,8 +213,7 @@ import { visible, idle, interaction, media } from "@usenagi/core/addons/cue";
 
 | API | 説明 |
 | --- | --- |
-| `schedulerAddon(opts?)` | 遅延 mount 用 addon（内部で `createScheduler` を使用） |
-| `createScheduler(opts?)` | カスタム Scheduler 実装用の low-level API |
+| `schedulerAddon(opts?)` | 遅延 mount 用 addon |
 | `visible(opts?)` | 要素が viewport に入ったときに解決する Cue |
 | `idle(timeout?)` | `requestIdleCallback` で解決する Cue |
 | `interaction(events?)` | 最初のユーザー操作で解決する Cue |

package/README.md

@@ -32,9 +32,9 @@ You are free to implement `[data-component]` scanning, manifests, lazy imports,
 // counter.ts
 import { create, signal, useWatch, useDomRef } from "@usenagi/core";
 
-const { component } = create();
+const app = create();
 
-component({
+app.component({
   name: "counter",
   setup() {
     const { refs } = useDomRef<{
@@ -71,13 +71,14 @@ npm i @usenagi/core
 ### First component
 
 ```ts
-import { create, defineComponent, signal, useWatch, useDomRef } from "@usenagi/core";
+import { create, defineComponent, propTypes, signal, useWatch, useDomRef } from "@usenagi/core";
 
 const Greeting = defineComponent({
   name: "greeting",
+  props: propTypes<{ name: string }>(),
   setup(el, props) {
     const { refs } = useDomRef<{ message: HTMLParagraphElement }>();
-    const text = signal((props.name as string) ?? "world");
+    const text = signal(props.name ?? "world");
 
     useWatch(text, (v) => {
       refs.message.textContent = `Hello, ${v}!`;
@@ -118,6 +119,13 @@ An example of automatic mounting by combining `[data-component]` scanning, manif
 
 ## API
 
+### Component Definition
+
+| API                    | Description                                                                 |
+| ---------------------- | --------------------------------------------------------------------------- |
+| `defineComponent(opts)` | Type-safe helper to define a `ComponentSetup` object                       |
+| `propTypes<T>()`       | Type-only marker for declaring component props shape (zero runtime cost)    |
+
 ### Reactivity
 
 | API                    | Description                                                       |
@@ -174,7 +182,7 @@ You can mount child components with `useSlot()`. You can pass values from parent
 | API                               | Description                                                         |
 | --------------------------------- | ------------------------------------------------------------------- |
 | `useIntersectionWatch(cb, opts?)` | IntersectionObserver wrapper; automatically disconnected on unmount |
-| `useMediaQuery(query)`            | Returns `matchMedia` result as a `ReadonlySignal<boolean>`          |
+| `useMediaQuery(query, cb)` | Runs `callback` when the query matches; returns `matchesQuery` as `ReadonlySignal<boolean>` |
 
 ### Addons
 
@@ -205,8 +213,7 @@ import { visible, idle, interaction, media } from "@usenagi/core/addons/cue";
 
 | API | Description |
 | --- | --- |
-| `schedulerAddon(opts?)` | Addon for deferred mount (uses `createScheduler` internally) |
-| `createScheduler(opts?)` | Low-level API for custom Scheduler implementations |
+| `schedulerAddon(opts?)` | Addon for deferred mount |
 | `visible(opts?)` | A Cue that resolves when the element enters the viewport |
 | `idle(timeout?)` | A Cue that resolves via `requestIdleCallback` |
 | `interaction(events?)` | A Cue that resolves on the first user interaction |

package/dist/addons/scheduler.cjs.js

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});function e(e){return e}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,n,r){if(r?.aborted)return;let{scheduler:a}=globalThis;if(typeof a?.postTask==`function`){a.postTask(e,{priority:n,signal:r}).catch(e=>{t(e)||queueMicrotask(()=>{throw e})});return}i(e,n,r)}function i(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 a(e={}){let t=e.priority??`user-visible`;return{schedule(e,n={}){r(e,n.priority??t,n.signal)}}}function o(r){return e({name:`@usenagi/scheduler`,install(e){let i=a(r),o=n();e.addMountMiddleware((e,n,r)=>(n,a)=>{let s=o.add(n),c=()=>{i.schedule(()=>{s.complete()&&e(n,a)},{priority:r.priority,signal:s.signal})},{when:l}=r;l?l(n,s.signal).then(()=>{s.signal.aborted||c()},e=>{t(e)||(s.abort(),queueMicrotask(()=>{throw e}))}):c()}),e.addUnmountMiddleware(e=>t=>{t.forEach(o.abort),e(t)})}})}exports.createScheduler=a,exports.schedulerAddon=o;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});function e(e){return e}function t(){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 n(e){return(e instanceof DOMException||e instanceof Error)&&e.name===`AbortError`}function r(e,t,r){if(r?.aborted)return;let{scheduler:a}=globalThis;if(typeof a?.postTask==`function`){a.postTask(e,{priority:t,signal:r}).catch(e=>{n(e)||queueMicrotask(()=>{throw e})});return}i(e,t,r)}function i(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 a(e={}){let t=e.priority??`user-visible`;return{schedule(e,n={}){r(e,n.priority??t,n.signal)}}}function o(e){return(e instanceof DOMException||e instanceof Error)&&e.name===`AbortError`}function s(n){return e({name:`@usenagi/scheduler`,install(e){let r=a(n),i=t();e.addMountMiddleware((e,t,n)=>(t,a)=>{let s=i.add(t),c=()=>{r.schedule(()=>{s.complete()&&e(t,a)},{priority:n.priority,signal:s.signal})},{when:l}=n;l?l(t,s.signal).then(()=>{s.signal.aborted||c()},e=>{o(e)||(s.abort(),queueMicrotask(()=>{throw e}))}):c()}),e.addUnmountMiddleware(e=>t=>{t.forEach(i.abort),e(t)})}})}exports.schedulerAddon=s;

package/dist/addons/scheduler.es.js

@@ -3,13 +3,8 @@ function e(e) {
 	return e;
 }
 //#endregion
-//#region lib/utils/isAbortError.ts
-function t(e) {
-	return (e instanceof DOMException || e instanceof Error) && e.name === "AbortError";
-}
-//#endregion
-//#region lib/addons/scheduler/pending.ts
-function n() {
+//#region lib/addons/scheduler/_internal/pending.ts
+function t() {
 	let e = /* @__PURE__ */ new Map();
 	return {
 		add(t) {
@@ -33,22 +28,25 @@ function n() {
 	};
 }
 //#endregion
-//#region lib/addons/scheduler/task.ts
-function r(e, n, r) {
+//#region lib/addons/scheduler/_internal/schedule.ts
+function n(e) {
+	return (e instanceof DOMException || e instanceof Error) && e.name === "AbortError";
+}
+function r(e, t, r) {
 	if (r?.aborted) return;
 	let { scheduler: a } = globalThis;
 	if (typeof a?.postTask == "function") {
 		a.postTask(e, {
-			priority: n,
+			priority: t,
 			signal: r
 		}).catch((e) => {
-			t(e) || queueMicrotask(() => {
+			n(e) || queueMicrotask(() => {
 				throw e;
 			});
 		});
 		return;
 	}
-	i(e, n, r);
+	i(e, t, r);
 }
 function i(e, t, n) {
 	function r() {
@@ -70,8 +68,6 @@ function i(e, t, n) {
 			break;
 	}
 }
-//#endregion
-//#region lib/addons/scheduler/scheduler.ts
 function a(e = {}) {
 	let t = e.priority ?? "user-visible";
 	return { schedule(e, n = {}) {
@@ -79,33 +75,36 @@ function a(e = {}) {
 	} };
 }
 //#endregion
-//#region lib/addons/scheduler/addon.ts
-function o(r) {
+//#region lib/addons/scheduler/index.ts
+function o(e) {
+	return (e instanceof DOMException || e instanceof Error) && e.name === "AbortError";
+}
+function s(n) {
 	return e({
 		name: "@usenagi/scheduler",
 		install(e) {
-			let i = a(r), o = n();
-			e.addMountMiddleware((e, n, r) => (n, a) => {
-				let s = o.add(n), c = () => {
-					i.schedule(() => {
-						s.complete() && e(n, a);
+			let r = a(n), i = t();
+			e.addMountMiddleware((e, t, n) => (t, a) => {
+				let s = i.add(t), c = () => {
+					r.schedule(() => {
+						s.complete() && e(t, a);
 					}, {
-						priority: r.priority,
+						priority: n.priority,
 						signal: s.signal
 					});
-				}, { when: l } = r;
-				l ? l(n, s.signal).then(() => {
+				}, { when: l } = n;
+				l ? l(t, s.signal).then(() => {
 					s.signal.aborted || c();
 				}, (e) => {
-					t(e) || (s.abort(), queueMicrotask(() => {
+					o(e) || (s.abort(), queueMicrotask(() => {
 						throw e;
 					}));
 				}) : c();
 			}), e.addUnmountMiddleware((e) => (t) => {
-				t.forEach(o.abort), e(t);
+				t.forEach(i.abort), e(t);
 			});
 		}
 	});
 }
 //#endregion
-export { a as createScheduler, o as schedulerAddon };
+export { s as schedulerAddon };

package/dist/main.es.js

@@ -1,5 +1,10 @@
 //#region lib/core/addon.ts
-function e() {
+function e(e) {
+	return e;
+}
+//#endregion
+//#region lib/core/_internal/addonRegistry.ts
+function t() {
 	let e = /* @__PURE__ */ new Set(), t = [], n = [], r = [], i = {
 		get installedAddons() {
 			return e;
@@ -29,9 +34,6 @@ function e() {
 	};
 	return i;
 }
-function t(e) {
-	return e;
-}
 //#endregion
 //#region lib/core/error.ts
 function n(e) {
@@ -62,7 +64,7 @@ function i(e) {
 	return e instanceof r;
 }
 //#endregion
-//#region lib/core/internal/registry.ts
+//#region lib/core/_internal/registry.ts
 var a = /* @__PURE__ */ new WeakMap();
 function o(e, t) {
 	let n = a.get(e);
@@ -70,10 +72,10 @@ function o(e, t) {
 	a.set(e, t);
 }
 //#endregion
-//#region lib/core/component.ts
+//#region lib/core/_internal/component.ts
 var s = /* @__PURE__ */ function(e) {
 	return e.MOUNTED = "Mounted", e.UNMOUNTED = "Unmounted", e;
-}({}), c = 0, l = class {
+}(s || {}), c = 0, l = class {
 	Mounted = [];
 	Unmounted = [];
 	parent = null;
@@ -121,67 +123,93 @@ var s = /* @__PURE__ */ function(e) {
 	get childElements() {
 		return this.#e.map((e) => e.element);
 	}
-};
-function u(e) {
-	return 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;
+}, u;
+function d(e) {
+	if (!u) throw Error(`"${e}" called outside setup() will never be run.`);
+	return u;
 }
-function p(e, t, n = {}) {
-	let a = new l(t, e.name), o = d;
-	d = a;
+function f(e, t, n = {}) {
+	let a = new l(t, e.name), o = u;
+	u = 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 });
+		throw u = o, i(e) ? e : r.create("setup", a, e, o, { props: a.props });
 	}
-	return d = o, a;
+	return u = o, a;
 }
 //#endregion
 //#region lib/core/app.ts
-function m() {
-	let t = e(), n = (e) => {
+function p() {
+	let e = t(), n = (e) => {
 		for (let t of e) {
 			let e = a.get(t);
 			e && (e.onUnmount(), a.delete(t));
 		}
 	}, r = {
-		install(...e) {
-			return e.forEach(t.install), r;
+		install(...t) {
+			return t.forEach(e.install), r;
 		},
-		component(e, n = {}) {
-			let r = t.composeComponent(e), i = t.composeMount((e, t) => {
-				let n = p(r, e, t);
+		component(t, n = {}) {
+			let r = e.composeComponent(t), i = e.composeMount((e, t) => {
+				let n = f(r, e, t);
 				return o(e, n), n.onMount(), n;
 			}, r, n);
 			return (e, t = {}) => i(e, t);
 		},
-		unmount(e) {
-			t.composeUnmount(n)(e);
+		unmount(t) {
+			e.composeUnmount(n)(t);
 		}
 	};
 	return r;
 }
 //#endregion
+//#region lib/core/component.ts
+function m(e) {
+	return e;
+}
+//#endregion
+//#region lib/core/context.ts
+function h() {
+	let e = Symbol();
+	return [{ _id: e }, () => {
+		let t = d("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 g(e, t) {
+	return (n) => ({
+		name: n.name,
+		setup(r, i) {
+			return d(`withContext.${n.name}`).provides.set(e._id, t), n.setup(r, i);
+		}
+	});
+}
+//#endregion
 //#region lib/core/lifecycle.ts
-function h(e) {
+function _(e) {
 	return (t) => {
-		f(e)[e].push(t);
+		d(e)[e].push(t);
 	};
 }
-var g = h(s.MOUNTED), _ = h(s.UNMOUNTED), v = Symbol("watch"), y = null, b = class {
+var v = _(s.MOUNTED), y = _(s.UNMOUNTED);
+//#endregion
+//#region lib/core/props.ts
+function b() {}
+//#endregion
+//#region lib/core/reactivity.ts
+var x = Symbol("watch"), S = null, C = class {
 	#e;
 	#t = /* @__PURE__ */ new Set();
 	constructor(e) {
 		this.#e = e;
 	}
 	get value() {
-		return y !== null && y.add(this), this.#e;
+		return S !== null && S.add(this), this.#e;
 	}
 	set value(e) {
 		if (Object.is(e, this.#e)) return;
@@ -189,12 +217,12 @@ var g = h(s.MOUNTED), _ = h(s.UNMOUNTED), v = Symbol("watch"), y = null, b = cla
 		this.#e = e;
 		for (let n of Array.from(this.#t)) n(e, t);
 	}
-	[v](e) {
+	[x](e) {
 		return this.#t.add(e), () => {
 			this.#t.delete(e);
 		};
 	}
-}, x = (e) => new b(e), S = class {
+}, w = (e) => new C(e), T = class {
 	#e;
 	constructor(e) {
 		this.#e = e;
@@ -202,75 +230,54 @@ var g = h(s.MOUNTED), _ = h(s.UNMOUNTED), v = Symbol("watch"), y = null, b = cla
 	get value() {
 		return this.#e.value;
 	}
-	[v](e) {
-		return this.#e[v](e);
+	[x](e) {
+		return this.#e[x](e);
 	}
-}, C = (e) => new S(e);
-function w(e, t) {
-	return e[v](t);
+}, E = (e) => new T(e);
+function D(e, t) {
+	return e[x](t);
 }
-function T(e, t) {
-	_(w(e, t));
+function O(e, t) {
+	y(D(e, t));
 }
-function E(e) {
-	let t = x(void 0), n = [], r = () => {
+function k(e) {
+	let t = w(void 0), n = [], r = () => {
 		n.forEach((e) => {
 			e();
 		}), n = [];
 	}, i = () => {
 		r();
-		let a = y, o = /* @__PURE__ */ new Set();
-		y = o;
+		let a = S, o = /* @__PURE__ */ new Set();
+		S = o;
 		let s;
 		try {
 			s = e();
 		} finally {
-			y = a;
+			S = a;
 		}
 		t.value = s;
-		for (let e of o) n.push(e[v](() => {
+		for (let e of o) n.push(e[x](() => {
 			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);
-		}
-	});
+	return i(), y(r), E(t);
 }
 //#endregion
-//#region lib/hooks/domRefs.ts
-function k(e, t) {
+//#region lib/hooks/core/useDomRef.ts
+function A(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));
+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 j(e, t) {
+function M(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());
+			let a = j(i, e, t());
 			return n.set(i, a), a;
 		},
 		has(e, t) {
@@ -288,22 +295,43 @@ function j(e, t) {
 		}
 	});
 }
+function N() {
+	let e = d("useDomRef");
+	return { refs: M(e.element, () => e.childElements) };
+}
 //#endregion
-//#region lib/hooks/useDomRef.ts
-function M() {
-	let e = f("useDomRef");
-	return { refs: j(e.element, () => e.childElements) };
+//#region lib/hooks/core/useSlot.ts
+function P() {
+	let e = d("useSlot");
+	return {
+		addChild(t, n, r) {
+			let i = (t) => {
+				let i = f(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
 //#region lib/hooks/useEvent.ts
-function N(e, t, n, r) {
-	g(() => (e.addEventListener(t, n, r), () => {
+function F(e, t, n, r) {
+	v(() => (e.addEventListener(t, n, r), () => {
 		e.removeEventListener(t, n, r);
 	}));
 }
 //#endregion
 //#region lib/hooks/useIntersectionWatch.ts
-function P(e, t, n = {
+function I(e, t, n = {
 	rootMargin: "0px",
 	threshold: .1
 }) {
@@ -313,9 +341,9 @@ function P(e, t, n = {
 			r.observe(e);
 		}) : r.observe(e);
 	}
-	i(e), _(() => {
+	v(() => (i(e), () => {
 		r.disconnect();
-	});
+	}));
 	function a(e) {
 		r.unobserve(e);
 	}
@@ -323,40 +351,14 @@ function P(e, t, n = {
 }
 //#endregion
 //#region lib/hooks/useMediaQuery.ts
-function F(e, t) {
-	let n = window.matchMedia(e), r = x(n.matches), i = null;
+function L(e, t) {
+	let n = window.matchMedia(e), r = w(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()), () => {
+	return v(() => (n.addEventListener("change", a), n.matches && (i = t()), () => {
 		i?.(), n.removeEventListener("change", a);
-	})), { matchesQuery: C(r) };
-}
-//#endregion
-//#region lib/hooks/useSlot.ts
-function I() {
-	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));
-				}
-			});
-		}
-	};
+	})), { matchesQuery: E(r) };
 }
 //#endregion
-//#region lib/props.ts
-function L() {}
-//#endregion
-export { r as LifecycleError, m as create, D as createContext, t as defineAddon, u as defineComponent, i as isLifecycleError, L as propTypes, C as readonly, x as signal, E as useComputed, M as useDomRef, N as useEvent, P as useIntersectionWatch, F as useMediaQuery, g as useMount, I as useSlot, _ as useUnmount, T as useWatch, O as withContext };
+export { r as LifecycleError, p as create, h as createContext, e as defineAddon, m as defineComponent, i as isLifecycleError, b as propTypes, E as readonly, w as signal, k as useComputed, N as useDomRef, F as useEvent, I as useIntersectionWatch, L as useMediaQuery, v as useMount, P as useSlot, y as useUnmount, O as useWatch, g as withContext };

package/dist/main.umd.js

@@ -1 +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(){let e=new Set,t=[],n=[],r=[],i={get installedAddons(){return e},addComponentMiddleware(e){t.push(e)},addMountMiddleware(e){n.push(e)},addUnmountMiddleware(e){r.push(e)},composeComponent(e){return t.reduce((e,t)=>t(e),e)},composeMount(e,t,r){return n.reduce((e,n)=>n(e,t,r),e)},composeUnmount(e){return r.reduce((e,t)=>t(e),e)},install(t){if(e.has(t.name))throw Error(`[nagi] addon "${t.name}" is already installed`);t.install(i),e.add(t.name)}};return i}function n(e){return e}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}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(){let e=t(),n=e=>{for(let t of e){let e=o.get(t);e&&(e.onUnmount(),o.delete(t))}},r={install(...t){return t.forEach(e.install),r},component(t,n={}){let r=e.composeComponent(t),i=e.composeMount((e,t)=>{let n=m(r,e,t);return s(e,n),n.onMount(),n},r,n);return(e,t={})=>i(e,t)},unmount(t){e.composeUnmount(n)(t)}};return r}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(){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))}})}}}function R(){}e.LifecycleError=i,e.create=h,e.createContext=O,e.defineAddon=n,e.defineComponent=d,e.isLifecycleError=a,e.propTypes=R,e.readonly=w,e.signal=S,e.useComputed=D,e.useDomRef=N,e.useEvent=P,e.useIntersectionWatch=F,e.useMediaQuery=I,e.useMount=_,e.useSlot=L,e.useUnmount=v,e.useWatch=E,e.withContext=k});
+(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.Nagi={}))})(this,function(e){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});function t(e){return e}function n(){let e=new Set,t=[],n=[],r=[],i={get installedAddons(){return e},addComponentMiddleware(e){t.push(e)},addMountMiddleware(e){n.push(e)},addUnmountMiddleware(e){r.push(e)},composeComponent(e){return t.reduce((e,t)=>t(e),e)},composeMount(e,t,r){return n.reduce((e,n)=>n(e,t,r),e)},composeUnmount(e){return r.reduce((e,t)=>t(e),e)},install(t){if(e.has(t.name))throw Error(`[nagi] addon "${t.name}" is already installed`);t.install(i),e.add(t.name)}};return i}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}(c||{}),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)}},d;function f(e){if(!d)throw Error(`"${e}" called outside setup() will never be run.`);return d}function p(e,t,n={}){let r=new u(t,e.name),o=d;d=r;try{o&&(r.parent=o),r.props=n,r.current=e.setup(t,n)||{}}catch(e){throw d=o,a(e)?e:i.create(`setup`,r,e,o,{props:r.props})}return d=o,r}function m(){let e=n(),t=e=>{for(let t of e){let e=o.get(t);e&&(e.onUnmount(),o.delete(t))}},r={install(...t){return t.forEach(e.install),r},component(t,n={}){let r=e.composeComponent(t),i=e.composeMount((e,t)=>{let n=p(r,e,t);return s(e,n),n.onMount(),n},r,n);return(e,t={})=>i(e,t)},unmount(n){e.composeUnmount(t)(n)}};return r}function h(e){return e}function g(){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 _(e,t){return n=>({name:n.name,setup(r,i){return f(`withContext.${n.name}`).provides.set(e._id,t),n.setup(r,i)}})}function v(e){return t=>{f(e)[e].push(t)}}var y=v(c.MOUNTED),b=v(c.UNMOUNTED);function x(){}var S=Symbol(`watch`),C=null,w=class{#e;#t=new Set;constructor(e){this.#e=e}get value(){return C!==null&&C.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)}[S](e){return this.#t.add(e),()=>{this.#t.delete(e)}}},T=e=>new w(e),E=class{#e;constructor(e){this.#e=e}get value(){return this.#e.value}[S](e){return this.#e[S](e)}},D=e=>new E(e);function O(e,t){return e[S](t)}function k(e,t){b(O(e,t))}function A(e){let t=T(void 0),n=[],r=()=>{n.forEach(e=>{e()}),n=[]},i=()=>{r();let a=C,o=new Set;C=o;let s;try{s=e()}finally{C=a}t.value=s;for(let e of o)n.push(e[S](()=>{i()}))};return i(),b(r),D(t)}function j(e,t){return t.some(t=>t!==e&&t.contains(e))}function M(e,t,n){let r=`[data-ref="${CSS.escape(e)}"]`,i=Array.from(t.querySelectorAll(r)).filter(e=>!j(e,n));return i.length===0?null:i.length===1?i[0]:i}function N(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=M(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 P(){let e=f(`useDomRef`);return{refs:N(e.element,()=>e.childElements)}}function F(){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`,i.create(`removeChild`,t,n,e))}})}}}function I(e,t,n,r){y(()=>(e.addEventListener(t,n,r),()=>{e.removeEventListener(t,n,r)}))}function L(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)}y(()=>(i(e),()=>{r.disconnect()}));function a(e){r.unobserve(e)}return{unwatch:a}}function R(e,t){let n=window.matchMedia(e),r=T(n.matches),i=null;function a(e){r.value=e.matches,e.matches?i=t():(i?.(),i=null)}return y(()=>(n.addEventListener(`change`,a),n.matches&&(i=t()),()=>{i?.(),n.removeEventListener(`change`,a)})),{matchesQuery:D(r)}}e.LifecycleError=i,e.create=m,e.createContext=g,e.defineAddon=t,e.defineComponent=h,e.isLifecycleError=a,e.propTypes=x,e.readonly=D,e.signal=T,e.useComputed=A,e.useDomRef=P,e.useEvent=I,e.useIntersectionWatch=L,e.useMediaQuery=R,e.useMount=y,e.useSlot=F,e.useUnmount=b,e.useWatch=k,e.withContext=_});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usenagi/core",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Composition-API ergonomics for vanilla DOM. Bring your own mounter.",
   "main": "./dist/main.umd.js",
   "module": "./dist/main.es.js",
@@ -61,10 +61,10 @@
   "devDependencies": {
     "@biomejs/biome": "^2.4.13",
     "happy-dom": "^20.9.0",
-    "oxlint": "^1.61.0",
+    "oxlint": "^1.66.0",
     "typescript": "^6.0.3",
-    "vite": "^8.0.10",
-    "vitest": "^4.1.5"
+    "vite": "^8.0.14",
+    "vitest": "^4.1.7"
   },
   "type": "module",
   "sideEffects": false

package/types/addons/scheduler/_internal/pending.d.ts

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

package/types/addons/scheduler/_internal/schedule.d.ts

@@ -0,0 +1,11 @@
+import type { SchedulePriority } from "../../../types";
+type Scheduler = {
+    schedule(task: () => void, options?: {
+        priority?: SchedulePriority;
+        signal?: AbortSignal;
+    }): void;
+};
+declare function createScheduler(opts?: {
+    priority?: SchedulePriority;
+}): Scheduler;
+export {};

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

@@ -1,2 +1,10 @@
-export { schedulerAddon } from "./addon";
-export { createScheduler } from "./scheduler";
+import type { Cue, SchedulePriority } from "../../types";
+declare module "../../core/addon" {
+    interface MountOptions {
+        priority?: SchedulePriority;
+        when?: Cue;
+    }
+}
+export declare function schedulerAddon(opts?: {
+    priority?: SchedulePriority;
+}): import("../../main").Addon;

package/types/core/_internal/addonRegistry.d.ts

@@ -0,0 +1,10 @@
+import type { ComponentSetup } from "../../types";
+import type { Addon, AddonContext, MountFn, MountOptions, UnmountFn } from "../addon";
+type AddonRegistry = AddonContext & {
+    composeComponent<S extends ComponentSetup>(setup: S): S;
+    composeMount(mountFn: MountFn, setup: ComponentSetup, opts: MountOptions): MountFn;
+    composeUnmount(unmountFn: UnmountFn): UnmountFn;
+    install(addon: Addon): void;
+};
+declare function createAddonRegistry(): AddonRegistry;
+export {};

package/types/core/_internal/component.d.ts

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

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

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

package/types/core/addon.d.ts

@@ -20,13 +20,6 @@ export type AddonContext = {
     addMountMiddleware(middleware: MountMiddleware): void;
     addUnmountMiddleware(middleware: UnmountMiddleware): void;
 };
-type AddonRegistry = AddonContext & {
-    composeComponent<S extends ComponentSetup>(setup: S): S;
-    composeMount(mountFn: MountFn, setup: ComponentSetup, opts: MountOptions): MountFn;
-    composeUnmount(unmountFn: UnmountFn): UnmountFn;
-    install(addon: Addon): void;
-};
-export declare function createAddonRegistry(): AddonRegistry;
 /**
  * Identity helper for type inference only — no runtime effect.
  */

package/types/core/app.d.ts

@@ -1,9 +1,8 @@
-import type { ComponentSetup, RefElement } from "../types";
+import type { ComponentContext, ComponentSetup, ExposedSetup, RefElement } from "../types";
 import type { Addon, MountOptions } from "./addon";
-import type { ComponentContext } from "./component";
 type App = {
     install(...addons: Addon[]): App;
-    component<S extends ComponentSetup>(component: S, opts?: MountOptions): (el: RefElement, props?: Record<string, any>) => ComponentContext<ReturnType<S["setup"]>> | void;
+    component<S extends ComponentSetup>(component: S, opts?: MountOptions): (el: RefElement, props?: Record<string, any>) => ComponentContext<ExposedSetup<ReturnType<S["setup"]>>> | void;
     unmount(targets: RefElement[]): void;
 };
 export declare function create(): App;

package/types/core/component.d.ts

@@ -1,26 +1,4 @@
 import type { ComponentProps, 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<SetupResult extends Record<string, unknown> | void, Props extends Record<string, unknown>>(opts: {
     name: string;
     props: Props;

package/types/core/error.d.ts

@@ -1,5 +1,5 @@
 import type { RefElement } from "../types";
-import type { ComponentContext } from "./component";
+import type { ComponentContextImpl } from "./_internal/component";
 export type LifecycleErrorDetails = {
     phase: "setup" | "mount" | "unmount" | "removeChild";
     name: string;
@@ -11,10 +11,9 @@ export type LifecycleErrorDetails = {
     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;
+    static create(phase: LifecycleErrorDetails["phase"], target: ComponentContextImpl, cause: unknown, parent?: ComponentContextImpl | null | undefined, extra?: Partial<LifecycleErrorDetails>): LifecycleError;
 }
 export declare function isLifecycleError(error: unknown): error is LifecycleError;

package/types/core/runtime.d.ts

@@ -1,4 +1,5 @@
-import { ComponentContext } from "./component";
+import { ComponentContextImpl } from "./_internal/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>;
+declare function getCurrentComponent(hookName: string): ComponentContextImpl;
+declare function createComponent<S extends ComponentSetup>(wrap: S, root: RefElement, props?: Record<string, any>): ComponentContextImpl<ReturnType<S["setup"]>>;
+export {};

package/types/hooks/{useDomRef.d.ts → core/useDomRef.d.ts}

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

package/types/hooks/{useSlot.d.ts → core/useSlot.d.ts}

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

package/types/main.d.ts

@@ -1,19 +1,18 @@
 export { defineAddon } from "./core/addon";
 export { create } from "./core/app";
 export { defineComponent } from "./core/component";
+export { createContext, withContext } from "./core/context";
 export { isLifecycleError, LifecycleError } from "./core/error";
 export { useMount, useUnmount } from "./core/lifecycle";
+export { propTypes } from "./core/props";
 export { readonly, signal, useComputed, useWatch } from "./core/reactivity";
-export { createContext, withContext } from "./hooks/createContext";
-export { useDomRef } from "./hooks/useDomRef";
+export { useDomRef } from "./hooks/core/useDomRef";
+export { useSlot } from "./hooks/core/useSlot";
 export { useEvent } from "./hooks/useEvent";
 export { useIntersectionWatch } from "./hooks/useIntersectionWatch";
 export { useMediaQuery } from "./hooks/useMediaQuery";
-export { useSlot } from "./hooks/useSlot";
-export { propTypes } from "./props";
-export type { Addon, AddonContext, ComponentMiddleware, MountFn, MountMiddleware, MountOptions, UnmountFn, UnmountMiddleware, } from "./core/addon";
-export type { ComponentContext } from "./core/component";
+export type { Addon, AddonContext, MountOptions } from "./core/addon";
+export type { Provider } from "./core/context";
 export type { LifecycleErrorDetails } from "./core/error";
 export type { ReadonlySignal, Signal } from "./core/reactivity";
-export type { Provider } from "./hooks/createContext";
-export type { ComponentSetup, Cue, IComponent, RefElement, SchedulePriority, Scheduler, } from "./types";
+export type { Cleanup, ComponentContext, ComponentSetup, Cue, RefElement, SchedulePriority, } from "./types";

package/types/types.d.ts

@@ -1,18 +1,20 @@
 export type RefElement = HTMLElement | SVGElement;
 export type ComponentProps<Props> = Readonly<Props>;
+type IsAny<T> = 0 extends 1 & T ? true : false;
+/** Normalize the return value of setup to the type stored in `current` (void / undefined → empty object). */
+export type ExposedSetup<T> = IsAny<T> extends true ? Record<string, unknown> : [T] extends [void | undefined] ? Record<string, never> : T extends Record<string, unknown> ? T : Record<string, never>;
 export type ComponentSetup<SetupResult = void | Record<string, unknown>, Props extends Record<string, unknown> = 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 extends Record<string, unknown> = Record<string, unknown>> = ComponentSetup<SetupResult, Props>;
+/** Mounted component instance exposed to app / hook callers. */
+export type ComponentContext<Exposed extends Record<string, unknown> = Record<string, never>> = {
+    readonly current: Exposed;
+    readonly element: RefElement;
+    readonly name: string;
+};
 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>;
+export {};

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

@@ -1,10 +0,0 @@
-import type { Cue, SchedulePriority } from "../../types";
-declare module "../../core/addon" {
-    interface MountOptions {
-        priority?: SchedulePriority;
-        when?: Cue;
-    }
-}
-export declare function schedulerAddon(opts?: {
-    priority?: SchedulePriority;
-}): import("../../main").Addon;

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

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

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

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

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

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

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

@@ -1,4 +0,0 @@
-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/hooks/domRefs.d.ts

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

package/types/utils/isAbortError.d.ts

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