what-react 0.12.3 → 0.13.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "what-react",
-  "version": "0.12.3",
+  "version": "0.13.0",
   "description": "React compatibility layer for What Framework — real React semantics (value hooks, re-renders, context) on a dedicated compat runtime",
   "type": "module",
   "sideEffects": false,
@@ -53,7 +53,7 @@
     "compatibility"
   ],
   "peerDependencies": {
-    "what-core": "^0.12.3"
+    "what-core": "^0.13.0"
   },
   "author": "ZVN DEV (https://zvndev.com)",
   "license": "MIT",

package/src/hooks.js

@@ -240,7 +240,7 @@ export function useContext(context) {
 // ---- useSyncExternalStore ----
 // Spec-compliant: returns the snapshot VALUE and re-renders on store change.
 
-export function useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot) {
+export function useSyncExternalStore(subscribe, getSnapshot, _getServerSnapshot) {
   const inst = _requireInstance('useSyncExternalStore');
   const slot = _getHookSlot(inst);
   if (!slot.init) {
@@ -306,7 +306,7 @@ export function useId() {
 
 // ---- useDebugValue ----
 
-export function useDebugValue() {}
+export function useDebugValue(_value, _format) {}
 
 // ---- use (React 19-style, minimal) ----
 // Context → useContext. Thenable → resolved value or throw for Suspense.
@@ -330,7 +330,11 @@ export function use(usable) {
       return useContext(usable);
     }
   }
-  throw new Error('[what-react] use() expects a promise or a context.');
+  // ERROR_CODES.USE_INVALID_ARG
+  throw Object.assign(
+    new Error('[what-react] use() expects a promise or a context.'),
+    { code: 'ERR_USE_INVALID_ARG' },
+  );
 }
 
 // ---- useSignal (escape hatch) ----

package/src/index.js

@@ -17,7 +17,7 @@
  */
 
 import { Fragment as WhatFragment } from 'what-core';
-import { getBridge, _getCurrentInstance, flushUpdates, _drainAll, runInCommit } from './runtime.js';
+import { getBridge, _getCurrentInstance, flushUpdates, _drainAll } from './runtime.js';
 import {
   useState,
   useReducer,
@@ -126,7 +126,7 @@ function getClassWrapper(ClassComp) {
             if (derived != null) instance.state = { ...instance.state, ...derived };
           }
           if (instance.componentDidCatch) {
-            try { instance.componentDidCatch(error, { componentStack: '' }); } catch (e) { /* boundary error */ }
+            try { instance.componentDidCatch(error, { componentStack: '' }); } catch { /* boundary error */ }
           }
           forceRender();
         };
@@ -166,7 +166,7 @@ function getClassWrapper(ClassComp) {
   // Copy static properties (defaultProps, contextType, custom statics)
   for (const key of Object.getOwnPropertyNames(ClassComp)) {
     if (key !== 'prototype' && key !== 'length' && key !== 'name' && key !== 'caller' && key !== 'arguments') {
-      try { wrapper[key] = ClassComp[key]; } catch (e) { /* read-only static */ }
+      try { wrapper[key] = ClassComp[key]; } catch { /* read-only static */ }
     }
   }
 
@@ -382,7 +382,11 @@ export const Children = {
   only(children) {
     const arr = Children.toArray(children);
     if (arr.length !== 1) {
-      throw new Error('React.Children.only expected to receive a single React element child.');
+      // ERROR_CODES.CHILDREN_ONLY
+    throw Object.assign(
+      new Error('React.Children.only expected to receive a single React element child.'),
+      { code: 'ERR_CHILDREN_ONLY' },
+    );
     }
     return arr[0];
   },
@@ -422,7 +426,7 @@ export function cloneElement(element, props, ...children) {
 
 export function createFactory(type) {
   const factory = createElement.bind(null, type);
-  factory.type = type;
+  /** @type {any} */ (factory).type = type;
   return factory;
 }
 

package/src/runtime.js

@@ -57,11 +57,15 @@ export function _getCurrentInstance() {
 
 export function _requireInstance(hookName) {
   if (!currentInstance) {
-    throw new Error(
-      `[what-react] ${hookName}() called outside of a component render. ` +
-      `Hooks can only be called while a what-react component is rendering. ` +
-      `If this happens inside a React library, make sure ALL react imports are ` +
-      `aliased to what-react (one module instance) — see the reactCompat() vite plugin.`
+    // ERROR_CODES.HOOK_OUTSIDE_RENDER
+    throw Object.assign(
+      new Error(
+        `[what-react] ${hookName}() called outside of a component render. ` +
+        `Hooks can only be called while a what-react component is rendering. ` +
+        `If this happens inside a React library, make sure ALL react imports are ` +
+        `aliased to what-react (one module instance) — see the reactCompat() vite plugin.`
+      ),
+      { code: 'ERR_HOOK_OUTSIDE_RENDER' },
     );
   }
   return currentInstance;
@@ -519,7 +523,7 @@ function mountElement(v, container, svg, owner) {
 
   const rn = {
     kind: KIND_ELEMENT, vnode: v, key: v.key ?? null, dom: el,
-    children: [], ref: props.ref || null,
+    children: /** @type {any[]} */ ([]), ref: props.ref || null,
   };
 
   // Children
@@ -578,7 +582,7 @@ function mountPortal(v, container, owner) {
   const dom = document.createComment('w:portal');
   container.appendChild(dom);
   const target = v.props && v.props.container;
-  const rn = { kind: KIND_PORTAL, vnode: v, key: v.key ?? null, dom, container: target || null, children: [] };
+  const rn = { kind: KIND_PORTAL, vnode: v, key: v.key ?? null, dom, container: target || null, children: /** @type {any[]} */ ([]) };
   if (!target) {
     console.warn('[what-react] createPortal: target container not found');
     return rn;
@@ -620,10 +624,10 @@ function mountOpaque(v, container) {
       let n = start.nextSibling;
       while (n && n !== end) {
         const next = n.nextSibling;
-        holder.appendChild(n);
+        /** @type {DocumentFragment} */ (holder).appendChild(n);
         n = next;
       }
-      try { dispose(); } catch (e) { /* already disposed */ }
+      try { dispose(); } catch { /* already disposed */ }
     }),
   };
 }
@@ -984,7 +988,7 @@ export function getBridge(renderFn) {
     const rn = runInCommit(() => mountRNode(vnode, KIND_COMPONENT, frag, false, null));
     try {
       whatOnCleanup(() => unmountRNode(rn, false));
-    } catch (e) {
+    } catch {
       // Not inside a core component (unusual) — leak-free unmount unavailable.
     }
     return frag;
@@ -1054,6 +1058,7 @@ function changeEventFor(el) {
   return 'change';
 }
 
+/** @this {any} */
 function eventProxy(e) {
   if (!e.nativeEvent) e.nativeEvent = e;
   if (!e.persist) e.persist = noop;
@@ -1061,6 +1066,7 @@ function eventProxy(e) {
   if (handler) return handler(e);
 }
 
+/** @this {any} */
 function eventProxyCapture(e) {
   if (!e.nativeEvent) e.nativeEvent = e;
   if (!e.persist) e.persist = noop;
@@ -1180,7 +1186,7 @@ export function setProperty(el, name, value, oldValue, svg) {
     try {
       el[name] = value == null ? '' : value;
       return;
-    } catch (e) { /* read-only property — fall through to attribute */ }
+    } catch { /* read-only property — fall through to attribute */ }
   }
   if (value == null || value === false) el.removeAttribute(name);
   else el.setAttribute(name, value === true ? '' : value);

package/src/vite-plugin.js

@@ -156,7 +156,7 @@ export function reactCompat(options = {}) {
     name: 'what-react-compat',
     enforce: 'pre',
 
-    config(config, { command }) {
+    config(config, { }) {
       const root = config.root || process.cwd();
 
       // Resolve what-react and what-core paths from installed packages