what-core 0.12.4 → 0.13.0

package/dist/testing.min.js

@@ -1 +1 @@
-import{V as m,c as f,e as p,h as w,l as b}from"./chunk-M5GDJRVX.min.js";import{a as h}from"./chunk-O3SKPRTY.min.js";var l=null;function E(){return typeof document<"u"&&(l=document.createElement("div"),l.id="test-root",document.body.appendChild(l)),l}function v(){l&&(l.innerHTML="",l.parentNode&&l.parentNode.removeChild(l),l=null)}function N(e,t={}){let{container:n}=t,o=n||E();if(!o)throw new Error("No DOM container available. Are you running in Node.js without jsdom?");let s=m(e,o);return{container:o,unmount:s,getByText:r=>d(o,r),getByTestId:r=>o.querySelector(`[data-testid="${r}"]`),getByRole:r=>o.querySelector(`[role="${r}"]`),getAllByText:r=>g(o,r),queryByText:r=>d(o,r),queryByTestId:r=>o.querySelector(`[data-testid="${r}"]`),debug:()=>console.log(o.innerHTML),findByText:(r,u)=>y(()=>d(o,r),{timeout:u}),findByTestId:(r,u)=>y(()=>o.querySelector(`[data-testid="${r}"]`),{timeout:u})}}function q(e,t){let n=E();if(!n)throw new Error("No DOM container available. Are you running in Node.js without jsdom?");let o={},s=null,r;return b(u=>{s=u;let c=h(e,t||{});r=m(c,n)}),{container:n,signals:new Proxy(o,{get(u,c){if(c in u)return u[c]},set(u,c,i){return u[c]=i,!0}}),update(){w()},unmount(){r&&r(),s&&s(),v()},getByText:u=>d(n,u),getByTestId:u=>n.querySelector(`[data-testid="${u}"]`),queryByText:u=>d(n,u),debug:()=>console.log(n.innerHTML)}}function C(){w()}function M(e){let t=[],n=[],o=f,s=new Map,r=i=>{t.includes(i)||t.push(i)},u=i=>{n.includes(i)||n.push(i)},c;return b(i=>{c=i;let a=p(()=>{e()})}),c&&c(),{accessed:t,written:n}}function D(e,t){let n=[t],o=0,s=f(t,e),r=s.set;s.set=function(i){let a=typeof i=="function"?i(s.peek()):i;return Object.is(s.peek(),a)||(o++,n.push(a)),r(a)};let u=s,c=function(...i){if(i.length===0)return u();let a=typeof i[0]=="function"?i[0](u.peek()):i[0];return Object.is(u.peek(),a)||(o++,n.push(a)),u(a)};return c._signal=!0,c.peek=s.peek,c.set=s.set,c.subscribe=s.subscribe,s._debugName&&(c._debugName=s._debugName),s._subs&&(c._subs=s._subs),Object.defineProperty(c,"history",{get(){return n}}),Object.defineProperty(c,"setCount",{get(){return o}}),c.reset=function(i){let a=i!==void 0?i:t;n.length=0,n.push(a),o=0,u(a)},c}function d(e,t){let n=t instanceof RegExp?t:null,o=document.createTreeWalker(e,NodeFilter.SHOW_TEXT,null,!1);for(;o.nextNode();){let s=o.currentNode;if(n?n.test(s.textContent):s.textContent.includes(t))return s.parentElement}return null}function g(e,t){let n=[],o=t instanceof RegExp?t:null,s=document.createTreeWalker(e,NodeFilter.SHOW_TEXT,null,!1);for(;s.nextNode();){let r=s.currentNode;(o?o.test(r.textContent):r.textContent.includes(t))&&n.push(r.parentElement)}return n}var H={click(e){let t=new MouseEvent("click",{bubbles:!0,cancelable:!0,view:typeof window<"u"?window:void 0});return e.dispatchEvent(t),t},change(e,t){e.value=t;let n=new Event("input",{bubbles:!0});e.dispatchEvent(n);let o=new Event("change",{bubbles:!0});return e.dispatchEvent(o),o},input(e,t){e.value=t;let n=new Event("input",{bubbles:!0});return e.dispatchEvent(n),n},submit(e){let t=new Event("submit",{bubbles:!0,cancelable:!0});return e.dispatchEvent(t),t},focus(e){e.focus();let t=new FocusEvent("focus",{bubbles:!0});return e.dispatchEvent(t),t},blur(e){e.blur();let t=new FocusEvent("blur",{bubbles:!0});return e.dispatchEvent(t),t},keyDown(e,t,n={}){let o=new KeyboardEvent("keydown",{bubbles:!0,cancelable:!0,key:t,...n});return e.dispatchEvent(o),o},keyUp(e,t,n={}){let o=new KeyboardEvent("keyup",{bubbles:!0,cancelable:!0,key:t,...n});return e.dispatchEvent(o),o},mouseEnter(e){let t=new MouseEvent("mouseenter",{bubbles:!0});return e.dispatchEvent(t),t},mouseLeave(e){let t=new MouseEvent("mouseleave",{bubbles:!0});return e.dispatchEvent(t),t}};async function y(e,t={}){let{timeout:n=1e3,interval:o=50}=t,s=Date.now();for(;Date.now()-s<n;){try{let r=e();if(r)return r}catch{}await new Promise(r=>setTimeout(r,o))}throw new Error(`waitFor timed out after ${n}ms`)}async function O(e,t={}){let{timeout:n=1e3,interval:o=50}=t,s=Date.now(),r=e();if(!r)throw new Error("Element not found");for(;Date.now()-s<n;){if(r=e(),!r)return;await new Promise(u=>setTimeout(u,o))}throw new Error(`Element still present after ${n}ms`)}async function _(e){let t=await e();return w(),await new Promise(n=>queueMicrotask(n)),await new Promise(n=>setTimeout(n,0)),t}function F(e){let t=f(e),n=[e];return p(()=>{n.push(t())}),{signal:t,get value(){return t()},set value(o){t.set(o)},history:n,reset(){n.length=0,n.push(t())}}}function R(e="MockComponent"){let t=[];function n(o){return t.push({props:o,timestamp:Date.now()}),h("div",{"data-testid":`mock-${e}`},JSON.stringify(o,null,2))}return n.displayName=e,n.calls=t,n.lastCall=()=>t[t.length-1],n.reset=()=>{t.length=0},n}var j={toBeInTheDocument(e){if(!e||!e.parentNode)throw new Error("Expected element to be in the document")},toHaveTextContent(e,t){if(!e)throw new Error("Element not found");let n=e.textContent;if(!(t instanceof RegExp?t.test(n):n.includes(t)))throw new Error(`Expected "${n}" to contain "${t}"`)},toHaveAttribute(e,t,n){if(!e)throw new Error("Element not found");let o=e.getAttribute(t);if(n!==void 0&&o!==n)throw new Error(`Expected attribute "${t}" to be "${n}", got "${o}"`);if(n===void 0&&o===null)throw new Error(`Expected element to have attribute "${t}"`)},toHaveClass(e,t){if(!e)throw new Error("Element not found");if(!e.classList.contains(t))throw new Error(`Expected element to have class "${t}"`)},toBeVisible(e){if(!e)throw new Error("Element not found");let t=window.getComputedStyle(e);if(t.display==="none"||t.visibility==="hidden"||t.opacity==="0")throw new Error("Expected element to be visible")},toBeDisabled(e){if(!e)throw new Error("Element not found");if(!e.disabled)throw new Error("Expected element to be disabled")},toHaveValue(e,t){if(!e)throw new Error("Element not found");if(e.value!==t)throw new Error(`Expected value to be "${t}", got "${e.value}"`)}},A={getByText:e=>d(document.body,e),getByTestId:e=>document.querySelector(`[data-testid="${e}"]`),getByRole:e=>document.querySelector(`[role="${e}"]`),getAllByText:e=>g(document.body,e),queryByText:e=>d(document.body,e),queryByTestId:e=>document.querySelector(`[data-testid="${e}"]`),debug:()=>console.log(document.body.innerHTML)};export{_ as act,v as cleanup,F as createTestSignal,j as expect,H as fireEvent,C as flushEffects,R as mockComponent,D as mockSignal,N as render,q as renderTest,A as screen,E as setupDOM,M as trackSignals,y as waitFor,O as waitForElementToBeRemoved};
+import{W as x,a as k,b as _,c as E,d as b,f as y,i as h,m as g}from"./chunk-OKM3GKVP.min.js";import{a as v}from"./chunk-O3SKPRTY.min.js";var f=null;function N(){return typeof document<"u"&&(f=document.createElement("div"),f.id="test-root",document.body.appendChild(f)),f}function q(){f&&(f.innerHTML="",f.parentNode&&f.parentNode.removeChild(f),f=null)}function H(e,t={}){let{container:n}=t,o=n||N();if(!o)throw new Error("No DOM container available. Are you running in Node.js without jsdom?");let s=x(e,o);return{container:o,unmount:s,getByText:r=>p(o,r),getByTestId:r=>o.querySelector(`[data-testid="${r}"]`),getByRole:r=>o.querySelector(`[role="${r}"]`),getAllByText:r=>$(o,r),queryByText:r=>p(o,r),queryByTestId:r=>o.querySelector(`[data-testid="${r}"]`),debug:()=>console.log(o.innerHTML),findByText:(r,u)=>S(()=>p(o,r),{timeout:u}),findByTestId:(r,u)=>S(()=>o.querySelector(`[data-testid="${r}"]`),{timeout:u})}}function O(e,t){let n=N();if(!n)throw new Error("No DOM container available. Are you running in Node.js without jsdom?");let o={},s=null,r;return g(u=>{s=u;let c=v(e,t||{});r=x(c,n)}),{container:n,signals:new Proxy(o,{get(u,c){if(c in u)return u[c]},set(u,c,i){return u[c]=i,!0}}),update(){h()},unmount(){r&&r(),s&&s(),q()},getByText:u=>p(n,u),getByTestId:u=>n.querySelector(`[data-testid="${u}"]`),queryByText:u=>p(n,u),debug:()=>console.log(n.innerHTML)}}function R(){h()}var B="(unnamed)";function F(e){if(!k)throw new Error('[what] trackSignals() requires a development build. Signal debug names and subscriber back-references are stripped in production, so there is nothing to report. Run your tests with NODE_ENV !== "production".');let t=[],n=[],o=(l,d)=>{l.includes(d)||l.push(d)},s=_,r={...s||{},onSignalUpdate(l){o(n,l?._debugName||B),s?.onSignalUpdate?.(l)}};delete r.__isPreinstallBuffer;let u=b(0,"__trackSignals_probe__"),c={current:null},i=null,a=(l,d)=>{for(let w of l||[]){if(d.has(w))continue;d.add(w);let m=w._signalOwner;if(m){m!==u&&o(t,m._debugName||B);continue}let T=w._owner;T?.deps&&a(T.deps,d)}};E(r);try{g(d=>{c.current=d,y(()=>{u(),e()})});let l=new Set;for(let d of u._subs)a(d.deps,l)}catch(l){i=l}finally{c.current?.(),E(s)}if(i)throw i;return{accessed:t,written:n}}function A(e,t){let n=[t],o=0,s=b(t,e),r=s.set;s.set=function(i){let a=typeof i=="function"?i(s.peek()):i;return Object.is(s.peek(),a)||(o++,n.push(a)),r(a)};let u=s,c=function(...i){if(i.length===0)return u();let a=typeof i[0]=="function"?i[0](u.peek()):i[0];return Object.is(u.peek(),a)||(o++,n.push(a)),u(a)};return c._signal=!0,c.peek=s.peek,c.set=s.set,c.subscribe=s.subscribe,s._debugName&&(c._debugName=s._debugName),s._subs&&(c._subs=s._subs),Object.defineProperty(c,"history",{get(){return n}}),Object.defineProperty(c,"setCount",{get(){return o}}),c.reset=function(i){let a=i!==void 0?i:t;n.length=0,n.push(a),o=0,u(a)},c}function p(e,t){let n=t instanceof RegExp?t:null,o=document.createTreeWalker(e,NodeFilter.SHOW_TEXT,null);for(;o.nextNode();){let s=o.currentNode,r=s.textContent||"";if(n?n.test(r):r.includes(t))return s.parentElement}return null}function $(e,t){let n=[],o=t instanceof RegExp?t:null,s=document.createTreeWalker(e,NodeFilter.SHOW_TEXT,null);for(;s.nextNode();){let r=s.currentNode,u=r.textContent||"";(o?o.test(u):u.includes(t))&&n.push(r.parentElement)}return n}var P={click(e){let t=new MouseEvent("click",{bubbles:!0,cancelable:!0,view:typeof window<"u"?window:void 0});return e.dispatchEvent(t),t},change(e,t){e.value=t;let n=new Event("input",{bubbles:!0});e.dispatchEvent(n);let o=new Event("change",{bubbles:!0});return e.dispatchEvent(o),o},input(e,t){e.value=t;let n=new Event("input",{bubbles:!0});return e.dispatchEvent(n),n},submit(e){let t=new Event("submit",{bubbles:!0,cancelable:!0});return e.dispatchEvent(t),t},focus(e){e.focus();let t=new FocusEvent("focus",{bubbles:!0});return e.dispatchEvent(t),t},blur(e){e.blur();let t=new FocusEvent("blur",{bubbles:!0});return e.dispatchEvent(t),t},keyDown(e,t,n={}){let o=new KeyboardEvent("keydown",{bubbles:!0,cancelable:!0,key:t,...n});return e.dispatchEvent(o),o},keyUp(e,t,n={}){let o=new KeyboardEvent("keyup",{bubbles:!0,cancelable:!0,key:t,...n});return e.dispatchEvent(o),o},mouseEnter(e){let t=new MouseEvent("mouseenter",{bubbles:!0});return e.dispatchEvent(t),t},mouseLeave(e){let t=new MouseEvent("mouseleave",{bubbles:!0});return e.dispatchEvent(t),t}};async function S(e,t={}){let{timeout:n=1e3,interval:o=50}=t,s=Date.now();for(;Date.now()-s<n;){try{let r=e();if(r)return r}catch{}await new Promise(r=>setTimeout(r,o))}throw new Error(`waitFor timed out after ${n}ms`)}async function j(e,t={}){let{timeout:n=1e3,interval:o=50}=t,s=Date.now(),r=e();if(!r)throw new Error("Element not found");for(;Date.now()-s<n;){if(r=e(),!r)return;await new Promise(u=>setTimeout(u,o))}throw new Error(`Element still present after ${n}ms`)}async function I(e){let t=await e();return h(),await new Promise(n=>queueMicrotask(()=>n())),await new Promise(n=>setTimeout(()=>n(),0)),t}function L(e){let t=b(e),n=[e];return y(()=>{n.push(t())}),{signal:t,get value(){return t()},set value(o){t.set(o)},history:n,reset(){n.length=0,n.push(t())}}}function V(e="MockComponent"){let t=[];function n(o){return t.push({props:o,timestamp:Date.now()}),v("div",{"data-testid":`mock-${e}`},JSON.stringify(o,null,2))}return n.displayName=e,n.calls=t,n.lastCall=()=>t[t.length-1],n.reset=()=>{t.length=0},n}var U={toBeInTheDocument(e){if(!e||!e.parentNode)throw new Error("Expected element to be in the document")},toHaveTextContent(e,t){if(!e)throw new Error("Element not found");let n=e.textContent;if(!(t instanceof RegExp?t.test(n):n.includes(t)))throw new Error(`Expected "${n}" to contain "${t}"`)},toHaveAttribute(e,t,n){if(!e)throw new Error("Element not found");let o=e.getAttribute(t);if(n!==void 0&&o!==n)throw new Error(`Expected attribute "${t}" to be "${n}", got "${o}"`);if(n===void 0&&o===null)throw new Error(`Expected element to have attribute "${t}"`)},toHaveClass(e,t){if(!e)throw new Error("Element not found");if(!e.classList.contains(t))throw new Error(`Expected element to have class "${t}"`)},toBeVisible(e){if(!e)throw new Error("Element not found");let t=window.getComputedStyle(e);if(t.display==="none"||t.visibility==="hidden"||t.opacity==="0")throw new Error("Expected element to be visible")},toBeDisabled(e){if(!e)throw new Error("Element not found");if(!e.disabled)throw new Error("Expected element to be disabled")},toHaveValue(e,t){if(!e)throw new Error("Element not found");if(e.value!==t)throw new Error(`Expected value to be "${t}", got "${e.value}"`)}},W={getByText:e=>p(document.body,e),getByTestId:e=>document.querySelector(`[data-testid="${e}"]`),getByRole:e=>document.querySelector(`[role="${e}"]`),getAllByText:e=>$(document.body,e),queryByText:e=>p(document.body,e),queryByTestId:e=>document.querySelector(`[data-testid="${e}"]`),debug:()=>console.log(document.body.innerHTML)};export{I as act,q as cleanup,L as createTestSignal,U as expect,P as fireEvent,R as flushEffects,V as mockComponent,A as mockSignal,H as render,O as renderTest,W as screen,N as setupDOM,F as trackSignals,S as waitFor,j as waitForElementToBeRemoved};

package/index.d.ts

@@ -52,10 +52,17 @@ export function onRootCleanup(fn: () => void): void;
 // --- Virtual DOM ---
 
 export type PrimitiveChild = string | number | boolean | null | undefined;
-export type VNodeChild = PrimitiveChild | VNode | (() => VNodeChild) | VNodeChild[];
+
+// `VNode<any>`, not `VNode`. VNode is invariant in P (its `tag` holds a
+// `Component<P>`, whose parameter position is contravariant under
+// strictFunctionTypes), so `VNode` — which means `VNode<Record<string, any>>` —
+// rejects every specifically-typed node. `h('div', {}, h('h1', { style: '' }))`
+// did not compile for any TypeScript user before 0.12.5, and neither did
+// passing that tree to mount().
+export type VNodeChild = PrimitiveChild | VNode<any> | (() => VNodeChild) | VNodeChild[];
 
 /** A component may legitimately render nothing, so `null` is part of the contract. */
-export type Component<P = {}> = ((props: P & { children?: VNodeChild }) => VNode | null) & {
+export type Component<P = {}> = ((props: P & { children?: VNodeChild }) => VNode<any> | null) & {
   /**
    * Opt out of realizing compiled children before the component runs.
    *
@@ -89,7 +96,7 @@ export function html(strings: TemplateStringsArray, ...values: any[]): VNode | V
 
 // --- DOM ---
 
-export function mount(vnode: VNodeChild, container: string | Element): () => void;
+export function mount(vnode: VNodeChild, container: string | Element | DocumentFragment): () => void;
 
 /** Attach reactive bindings to server-rendered DOM instead of creating it. */
 export function hydrate(vnode: VNodeChild, container: Element): Node | null;
@@ -867,6 +874,15 @@ export interface ErrorCodeDefinition {
 
 export const ERROR_CODES: Record<string, ErrorCodeDefinition>;
 
+/**
+ * Look up a catalogue entry by its `ERR_*` code.
+ *
+ * Errors thrown outside what-core carry only their code — the suggestion and
+ * the worked example live once, in the catalogue, so that the client bundle
+ * does not have to ship the prose. This is how they are recovered.
+ */
+export function getErrorDefinition(code: string): ErrorCodeDefinition | undefined;
+
 export interface WhatErrorJSON {
   code: string;
   message: string;
@@ -965,3 +981,24 @@ export function getMountedComponents(): unknown[];
 export function registerSignal(sig: unknown): void;
 export function unregisterSignal(sig: unknown): void;
 export function getActiveSignals(): unknown[];
+
+// --- Internal cross-package exports ---
+// Underscore-prefixed names are not public API and carry no compatibility
+// promise. They are declared here because sibling packages in this repo import
+// them across the package boundary (what-server, what-text), and an
+// undeclared cross-package import is exactly the rename that ships broken:
+// `hygiene:types` skips `_`-prefixed names in its reverse direction, so
+// nothing else would have caught it. Application code should not use these.
+
+/** @internal Used by what-server. True for `aria-*` and `data-*` attribute names. */
+export function _isAriaAttr(name: string): boolean;
+/** @internal Used by what-server. Opens an SSR component scope. */
+export function _beginComponentSSR(...args: unknown[]): unknown;
+/** @internal Used by what-server. Closes the scope opened by `_beginComponentSSR`. */
+export function _endComponentSSR(...args: unknown[]): unknown;
+/** @internal Used by what-server. The keyed-array mapping `<For>` compiles down to. */
+export function _mapArrayToArray(...args: unknown[]): unknown;
+/** @internal Used by what-server/node. Installs the Node AsyncLocalStorage backend. */
+export function __installServerContextStorage(storage: unknown): void;
+/** @internal Used by what-text. Lets the text engine intercept text-node insertion. */
+export function _setTextInsertHook(hook: unknown): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "what-core",
-  "version": "0.12.4",
+  "version": "0.13.0",
   "description": "What Framework - Signal-based UI framework built for AI agents",
   "type": "module",
   "main": "src/index.js",

package/render.d.ts

@@ -42,3 +42,10 @@ export function isHydrating(): boolean;
 // SVG counterpart to template(): elements are created in the SVG namespace, which
 // a plain innerHTML template cannot do.
 export function svgTemplate(html: string): () => Element;
+
+/**
+ * @internal The component-call helper the compiler emits for `<Component />`.
+ * Re-exported by what-framework/render so compiled output can import it from
+ * the package a scaffolded app actually depends on.
+ */
+export function _$createComponent(component: unknown, props?: unknown, ...args: unknown[]): unknown;

package/src/a11y.js

@@ -21,7 +21,7 @@ export function useFocus() {
   return {
     current: () => focusedElement(),
     focus: (element) => element?.focus(),
-    blur: () => document.activeElement?.blur(),
+    blur: () => /** @type {HTMLElement | null} */ (document.activeElement)?.blur(),
   };
 }
 
@@ -241,7 +241,7 @@ export function SkipLink({ href = '#main', children = 'Skip to content' }) {
     class: 'what-skip-link',
     onClick: (e) => {
       e.preventDefault();
-      const target = document.querySelector(href);
+      const target = /** @type {HTMLElement | null} */ (document.querySelector(href));
       if (target) {
         target.focus();
         target.scrollIntoView();
@@ -683,7 +683,7 @@ export function useDescribedBy(description) {
 
 // --- Labelledby ---
 
-export function useLabelledBy(label) {
+export function useLabelledBy(_label) {
   const id = useId('label');
 
   return {

package/src/agent-context.js

@@ -8,7 +8,7 @@ import { getCollectedErrors } from './errors.js';
 // --- Version ---
 // Keep in sync with packages/core/package.json (checked by
 // core/test/guardrails.test.js so it can't silently go stale again).
-const VERSION = '0.12.4';
+const VERSION = '0.13.0';
 
 // --- Component Registry ---
 // Tracks mounted components for agent inspection.

package/src/animation.js

@@ -213,7 +213,7 @@ export function useTransition(options = {}) {
     isTransitioning.set(true);
     progress.set(0);
 
-    return new Promise((resolve) => {
+    return /** @type {Promise<void>} */ (new Promise((resolve) => {
       const startTime = performance.now();
 
       function tick(time) {
@@ -231,7 +231,7 @@ export function useTransition(options = {}) {
       }
 
       requestAnimationFrame(tick);
-    });
+    }));
   }
 
   return {
@@ -339,7 +339,7 @@ export function useGesture(element, handlers = {}) {
     }
   }
 
-  function handleEnd(e) {
+  function handleEnd(_e) {
     if (!state.isDragging.peek()) return;
 
     if (longPressTimer) {
@@ -453,7 +453,6 @@ export function useGesture(element, handlers = {}) {
 
 export function useAnimatedValue(initialValue) {
   const value = signal(initialValue);
-  const animations = [];
 
   return {
     value: () => value(),
@@ -531,7 +530,7 @@ export function createTransitionClasses(name) {
 export async function cssTransition(element, name, type = 'enter', duration = 300) {
   const classes = createTransitionClasses(name);
 
-  return new Promise((resolve) => {
+  return /** @type {Promise<void>} */ (new Promise((resolve) => {
     scheduleWrite(() => {
       // Initial state
       element.classList.add(classes[type]);
@@ -554,5 +553,5 @@ export async function cssTransition(element, name, type = 'enter', duration = 30
         });
       });
     });
-  });
+  }));
 }

package/src/components.js

@@ -2,7 +2,7 @@
 // memo, lazy, Suspense, ErrorBoundary
 
 import { h } from './h.js';
-import { signal, effect, untrack, __DEV__ } from './reactive.js';
+import { signal, __DEV__ } from './reactive.js';
 import { isServerRender } from './server-context.js';
 
 // Legacy errorBoundaryStack removed — tree-based resolution via _parentCtx._errorBoundary

package/src/data.js

@@ -288,16 +288,7 @@ export function useFetch(url, options = {}) {
 // Stale-while-revalidate pattern with caching
 
 export function useSWR(rawKey, fetcher, options = {}) {
-  const {
-    revalidateOnFocus = true,
-    revalidateOnReconnect = true,
-    refreshInterval = 0,
-    dedupingInterval = 2000,
-    fallbackData,
-    onSuccess,
-    onError,
-    suspense = false,
-  } = options;
+  const { revalidateOnFocus = true, revalidateOnReconnect = true, refreshInterval = 0, dedupingInterval = 2000, fallbackData, onSuccess, onError } = options;
 
   // Support null/undefined/false key for conditional/dependent fetching
   // When key is falsy, don't fetch — return idle state

package/src/dom.js

@@ -2,8 +2,8 @@
 // Components run ONCE. Signals create individual DOM effects.
 // No VDOM reconciler, no diffing — direct DOM manipulation driven by signals.
 
-import { effect, batch, untrack, signal, __DEV__, __devtools } from './reactive.js';
-import { reportError, _injectGetCurrentComponent, shallowEqual } from './components.js';
+import { effect, untrack, signal, __DEV__, __devtools } from './reactive.js';
+import { reportError, _injectGetCurrentComponent } from './components.js';
 import { _setComponentRef } from './helpers.js';
 // SVG elements that need namespace
 const SVG_ELEMENTS = new Set([
@@ -119,7 +119,7 @@ function disposeComponent(ctx) {
   // Run effect disposals
   if (ctx.effects) {
     for (const dispose of ctx.effects) {
-      try { dispose(); } catch (e) { /* already disposed */ }
+      try { dispose(); } catch { /* already disposed */ }
     }
   }
 
@@ -139,7 +139,7 @@ function disposeComponent(ctx) {
     }
   }
 
-  if (__DEV__ && __devtools?.onComponentUnmount) __devtools.onComponentUnmount(ctx);
+  if (__DEV__ && __devtools?.onComponentUnmount) __devtools.onComponentUnmount?.(ctx);
   mountedComponents.delete(ctx);
 }
 
@@ -169,7 +169,7 @@ export function disposeTree(node) {
     const disposers = node._hydrationDisposers;
     node._hydrationDisposers = null;
     for (let i = 0; i < disposers.length; i++) {
-      try { disposers[i](); } catch (e) { /* already disposed */ }
+      try { disposers[i](); } catch { /* already disposed */ }
     }
   }
   // Check comment node WeakMap for component context — only for comment nodes
@@ -181,12 +181,12 @@ export function disposeTree(node) {
   }
   // Dispose reactive function child effects ({() => ...} wrappers)
   if (node._dispose) {
-    try { node._dispose(); } catch (e) { /* already disposed */ }
+    try { node._dispose(); } catch { /* already disposed */ }
   }
   // Dispose reactive prop effects (value: () => ..., class: () => ..., etc.)
   if (node._propEffects) {
     for (const key in node._propEffects) {
-      try { node._propEffects[key](); } catch (e) { /* already disposed */ }
+      try { node._propEffects[key](); } catch { /* already disposed */ }
     }
   }
   // Recursively dispose children
@@ -384,7 +384,7 @@ const _propsProxyHandler = {
     }
     return undefined;
   },
-  set(target, key) {
+  set(_target, _key) {
     // Props are read-only from the component's perspective.
     // Reject all writes — especially dangerous prototype-chain keys.
     return false;
@@ -436,6 +436,7 @@ export function _beginComponentSSR(Component) {
   const ctx = {
     hooks: [],
     hookIndex: 0,
+    /** @type {Array<() => void>} */
     effects: [],
     cleanups: [],
     mounted: false,
@@ -563,6 +564,7 @@ function createComponent(vnode, parent, isSvg) {
   const ctx = {
     hooks: [],
     hookIndex: 0,
+    /** @type {Array<() => void>} */
     effects: [],
     cleanups: [],
     mounted: false,
@@ -587,7 +589,7 @@ function createComponent(vnode, parent, isSvg) {
 
   // Track for disposal
   mountedComponents.add(ctx);
-  if (__DEV__ && __devtools?.onComponentMount) __devtools.onComponentMount(ctx);
+  if (__DEV__ && __devtools?.onComponentMount) __devtools.onComponentMount?.(ctx);
 
   // Props signal for reactive updates from parent
   const propsChildren = children.length === 0 ? undefined : children.length === 1 ? children[0] : children;
@@ -699,7 +701,9 @@ function createErrorBoundary(vnode, parent) {
   const endComment = document.createComment('eb:end');
 
   const boundaryCtx = {
-    hooks: [], hookIndex: 0, effects: [], cleanups: [],
+    hooks: /** @type {any[]} */ ([]), hookIndex: 0,
+    effects: /** @type {Array<() => void>} */ ([]),
+    cleanups: /** @type {Array<() => void>} */ ([]),
     mounted: false, disposed: false,
     _parentCtx: componentStack[componentStack.length - 1] || null,
     _errorBoundary: handleError,
@@ -719,11 +723,12 @@ function createErrorBoundary(vnode, parent) {
     componentStack.push(boundaryCtx);
 
     // Remove old content between comment boundaries
-    if (startComment.parentNode) {
+    const openParent = startComment.parentNode;
+    if (openParent) {
       while (startComment.nextSibling && startComment.nextSibling !== endComment) {
         const old = startComment.nextSibling;
         disposeTree(old);
-        old.parentNode.removeChild(old);
+        openParent.removeChild(old);
       }
     }
 
@@ -767,7 +772,9 @@ function createSuspenseBoundary(vnode, parent) {
   const endComment = document.createComment('sb:end');
 
   const boundaryCtx = {
-    hooks: [], hookIndex: 0, effects: [], cleanups: [],
+    hooks: /** @type {any[]} */ ([]), hookIndex: 0,
+    effects: /** @type {Array<() => void>} */ ([]),
+    cleanups: /** @type {Array<() => void>} */ ([]),
     mounted: false, disposed: false,
     _parentCtx: componentStack[componentStack.length - 1] || null,
     _suspenseBoundary: boundary,
@@ -795,11 +802,12 @@ function createSuspenseBoundary(vnode, parent) {
     componentStack.push(boundaryCtx);
 
     // Remove old content between comment boundaries
-    if (startComment.parentNode) {
+    const openParent = startComment.parentNode;
+    if (openParent) {
       while (startComment.nextSibling && startComment.nextSibling !== endComment) {
         const old = startComment.nextSibling;
         disposeTree(old);
-        old.parentNode.removeChild(old);
+        openParent.removeChild(old);
       }
     }
 
@@ -830,7 +838,7 @@ function createSuspenseBoundary(vnode, parent) {
 }
 
 // Portal component handler
-function createPortalDOM(vnode, parent) {
+function createPortalDOM(vnode, _parent) {
   const { container } = vnode.props;
   const children = vnode.children;
 
@@ -840,7 +848,9 @@ function createPortalDOM(vnode, parent) {
   }
 
   const portalCtx = {
-    hooks: [], hookIndex: 0, effects: [], cleanups: [],
+    hooks: /** @type {any[]} */ ([]), hookIndex: 0,
+    effects: /** @type {Array<() => void>} */ ([]),
+    cleanups: /** @type {Array<() => void>} */ ([]),
     mounted: false, disposed: false,
     _parentCtx: componentStack[componentStack.length - 1] || null,
   };
@@ -942,7 +952,7 @@ function setProp(el, key, value, isSvg) {
   if (typeof value === 'function' && !_isEventProp(key) && key !== 'ref') {
     if (!el._propEffects) el._propEffects = {};
     if (el._propEffects[key]) {
-      try { el._propEffects[key](); } catch (e) { /* already disposed */ }
+      try { el._propEffects[key](); } catch { /* already disposed */ }
     }
     el._propEffects[key] = effect(() => {
       const resolved = value();
@@ -1056,7 +1066,7 @@ function setProp(el, key, value, isSvg) {
   // reset first so removeAttribute() clears both the attribute and the property.
   if (value == null) {
     if (key in el) {
-      try { el[key] = ''; } catch (e) { /* read-only reflected prop */ }
+      try { el[key] = ''; } catch { /* read-only reflected prop */ }
     }
     el.removeAttribute(key);
     return;