what-core 0.6.2 → 0.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "what-core",
-  "version": "0.6.2",
+  "version": "0.8.0",
   "description": "What Framework - The closest framework to vanilla JS",
   "type": "module",
   "main": "src/index.js",

package/src/dom.js

@@ -5,7 +5,6 @@
 import { effect, batch, untrack, signal, __DEV__, __devtools } from './reactive.js';
 import { reportError, _injectGetCurrentComponent, shallowEqual } from './components.js';
 import { _setComponentRef } from './helpers.js';
-
 // SVG elements that need namespace
 const SVG_ELEMENTS = new Set([
   'svg', 'path', 'circle', 'rect', 'line', 'polyline', 'polygon', 'ellipse',
@@ -74,16 +73,20 @@ function disposeComponent(ctx) {
   mountedComponents.delete(ctx);
 }
 
-// Dispose all components and reactive effects attached to a DOM subtree
+// Dispose all components and reactive effects attached to a DOM subtree.
+// Performance: checks _componentCtx / _dispose / _propEffects before walking
+// children, and only checks _commentCtxMap for comment nodes (nodeType 8).
 export function disposeTree(node) {
   if (!node) return;
   if (node._componentCtx) {
     disposeComponent(node._componentCtx);
   }
-  // Check comment node WeakMap for component context
-  const commentCtx = _commentCtxMap.get(node);
-  if (commentCtx) {
-    disposeComponent(commentCtx);
+  // Check comment node WeakMap for component context — only for comment nodes
+  if (node.nodeType === 8) {
+    const commentCtx = _commentCtxMap.get(node);
+    if (commentCtx) {
+      disposeComponent(commentCtx);
+    }
   }
   // Dispose reactive function child effects ({() => ...} wrappers)
   if (node._dispose) {
@@ -95,9 +98,11 @@ export function disposeTree(node) {
       try { node._propEffects[key](); } catch (e) { /* already disposed */ }
     }
   }
-  if (node.childNodes) {
-    for (const child of node.childNodes) {
-      disposeTree(child);
+  // Recursively dispose children
+  const children = node.childNodes;
+  if (children && children.length > 0) {
+    for (let i = 0; i < children.length; i++) {
+      disposeTree(children[i]);
     }
   }
 }
@@ -216,6 +221,31 @@ export function createDOM(vnode, parent, isSvg) {
 // --- Component Rendering ---
 // Components run ONCE. Props are passed as a signal for reactive access.
 
+// Shared Proxy handler for reactive props — defined once, reused by all components.
+// The Proxy target must be a plain object (not a function) so that ownKeys
+// invariants are satisfied. The propsSignal is stored as target._sig.
+const _propsProxyHandler = {
+  get(target, key) {
+    if (key === '_sig') return undefined; // hide internal property
+    return target._sig()[key];
+  },
+  has(target, key) {
+    if (key === '_sig') return false;
+    return key in target._sig();
+  },
+  ownKeys(target) {
+    return Reflect.ownKeys(target._sig());
+  },
+  getOwnPropertyDescriptor(target, key) {
+    if (key === '_sig') return undefined;
+    const current = target._sig();
+    if (key in current) {
+      return { value: current[key], writable: false, enumerable: true, configurable: true };
+    }
+    return undefined;
+  },
+};
+
 const componentStack = [];
 
 export function getCurrentComponent() {
@@ -256,6 +286,20 @@ function createComponent(vnode, parent, isSvg) {
   }
 
   // Component context for hooks
+  // Error boundary lookup: walk the parent chain once, cache the result.
+  const parentCtx = componentStack[componentStack.length - 1] || null;
+  let errorBoundary = null;
+  if (parentCtx) {
+    // Fast path: if parent has an error boundary, use it directly
+    errorBoundary = parentCtx._errorBoundary || null;
+    if (!errorBoundary) {
+      let p = parentCtx._parentCtx;
+      while (p) {
+        if (p._errorBoundary) { errorBoundary = p._errorBoundary; break; }
+        p = p._parentCtx;
+      }
+    }
+  }
   const ctx = {
     hooks: [],
     hookIndex: 0,
@@ -264,15 +308,8 @@ function createComponent(vnode, parent, isSvg) {
     mounted: false,
     disposed: false,
     Component,
-    _parentCtx: componentStack[componentStack.length - 1] || null,
-    _errorBoundary: (() => {
-      let p = componentStack[componentStack.length - 1];
-      while (p) {
-        if (p._errorBoundary) return p._errorBoundary;
-        p = p._parentCtx;
-      }
-      return null;
-    })()
+    _parentCtx: parentCtx,
+    _errorBoundary: errorBoundary,
   };
 
   // Component boundaries: use comment nodes instead of <span style="display:contents">
@@ -294,35 +331,24 @@ function createComponent(vnode, parent, isSvg) {
 
   // Props signal for reactive updates from parent
   const propsChildren = children.length === 0 ? undefined : children.length === 1 ? children[0] : children;
-  const propsSignal = signal({ ...props, children: propsChildren });
+  // Merge children into props without spreading when possible
+  let mergedProps;
+  if (propsChildren !== undefined) {
+    mergedProps = props ? Object.assign({}, props, { children: propsChildren }) : { children: propsChildren };
+  } else {
+    mergedProps = props ? Object.assign({}, props) : {};
+  }
+  const propsSignal = signal(mergedProps);
   ctx._propsSignal = propsSignal;
 
   // Create a reactive props proxy: reading any prop inside an effect
   // will auto-track the dependency on the propsSignal. This makes prop
   // access reactive across re-renders without requiring the component
   // to be re-executed.
-  const reactiveProps = new Proxy({}, {
-    get(_, key) {
-      // Access the signal to create a reactive dependency
-      const current = propsSignal();
-      return current[key];
-    },
-    has(_, key) {
-      const current = propsSignal();
-      return key in current;
-    },
-    ownKeys() {
-      const current = propsSignal();
-      return Reflect.ownKeys(current);
-    },
-    getOwnPropertyDescriptor(_, key) {
-      const current = propsSignal();
-      if (key in current) {
-        return { value: current[key], writable: false, enumerable: true, configurable: true };
-      }
-      return undefined;
-    },
-  });
+  // Reuse shared trap handlers to minimize per-component allocation.
+  // Store propsSignal on a plain object target (Proxy invariant: ownKeys must
+  // match non-configurable own properties of target; functions have 'prototype').
+  const reactiveProps = new Proxy({ _sig: propsSignal }, _propsProxyHandler);
 
   // Component runs ONCE — not inside an effect
   componentStack.push(ctx);
@@ -550,8 +576,9 @@ function createElementFromVNode(vnode, parent, isSvg) {
   }
 
   // Append children
-  for (const child of children) {
-    const node = createDOM(child, el, svgContext && tag !== 'foreignObject');
+  const isSvgChildren = svgContext && tag !== 'foreignObject';
+  for (let i = 0; i < children.length; i++) {
+    const node = createDOM(children[i], el, isSvgChildren);
     if (node) el.appendChild(node);
   }
 
@@ -563,16 +590,16 @@ function createElementFromVNode(vnode, parent, isSvg) {
 // Only applied once for fine-grained (no diffing). Reactive props use effects.
 
 function applyProps(el, newProps, oldProps, isSvg) {
-  newProps = newProps || {};
-  oldProps = oldProps || {};
+  if (!newProps) return;
 
   for (const key in newProps) {
     if (key === 'key' || key === 'children') continue;
 
     // Handle ref
     if (key === 'ref') {
-      if (typeof newProps.ref === 'function') newProps.ref(el);
-      else if (newProps.ref) newProps.ref.current = el;
+      const ref = newProps.ref;
+      if (typeof ref === 'function') ref(el);
+      else if (ref) ref.current = el;
       continue;
     }
 
@@ -609,10 +636,13 @@ function setProp(el, key, value, isSvg) {
     if (old) el.removeEventListener(event, old, useCapture);
     if (value == null) return;
     if (!el._events) el._events = {};
+    // Single closure per event listener. Uses untrack to prevent accidental
+    // signal subscriptions inside event handlers.
     const wrappedHandler = (e) => {
       if (!e.nativeEvent) e.nativeEvent = e;
-      return untrack(() => value(e));
+      return untrack(() => wrappedHandler._handler(e));
     };
+    wrappedHandler._handler = value;
     wrappedHandler._original = value;
     el._events[storageKey] = wrappedHandler;
     const eventOpts = value._eventOpts;

package/src/guardrails.js

@@ -150,6 +150,8 @@ const VALID_EXPORTS = new Set([
   // Scheduler
   'scheduleRead', 'scheduleWrite', 'flushScheduler', 'measure', 'mutate',
   'useScheduledEffect', 'nextFrame', 'raf', 'onResize', 'onIntersect', 'smoothScrollTo',
+  // Text insertion hook (for external text engines)
+  '_setTextInsertHook',
   // Animation
   'spring', 'tween', 'easings', 'useTransition', 'useGesture', 'useAnimatedValue',
   'createTransitionClasses', 'cssTransition',

package/src/h.js

@@ -8,9 +8,25 @@
 const EMPTY_OBJ = Object.create(null);
 const EMPTY_ARR = [];
 
-export function h(tag, props, ...children) {
+export function h(tag, props) {
   props = props || EMPTY_OBJ;
-  const flat = flattenChildren(children);
+  // Collect children from arguments[2..n] without rest args — avoids array allocation
+  // when there are 0-1 children (common case: leaf elements, text nodes).
+  const argLen = arguments.length;
+  let flat;
+  if (argLen <= 2) {
+    flat = EMPTY_ARR;
+  } else if (argLen === 3) {
+    flat = _flattenSingle(arguments[2]);
+  } else {
+    // Multiple children: flatten all arguments from position 2 onward
+    const out = [];
+    for (let i = 2; i < argLen; i++) {
+      _flattenInto(arguments[i], out);
+    }
+    flat = out;
+  }
+
   const key = props.key ?? null;
 
   // Strip key from props passed to component/element
@@ -27,24 +43,33 @@ export function Fragment({ children }) {
   return children;
 }
 
-function flattenChildren(children) {
-  const out = [];
-  for (let i = 0; i < children.length; i++) {
-    const child = children[i];
-    if (child == null || child === false || child === true) continue;
-    if (Array.isArray(child)) {
-      out.push(...flattenChildren(child));
-    } else if (typeof child === 'object' && child._vnode) {
-      out.push(child);
-    } else if (typeof child === 'function') {
-      // Reactive child — preserve function for fine-grained DOM updates
-      out.push(child);
-    } else {
-      // Text node
-      out.push(String(child));
+// Fast path for single child (most common case)
+function _flattenSingle(child) {
+  if (child == null || child === false || child === true) return EMPTY_ARR;
+  if (Array.isArray(child)) {
+    const out = [];
+    _flattenInto(child, out);
+    return out;
+  }
+  if (typeof child === 'object' && child._vnode) return [child];
+  if (typeof child === 'function') return [child];
+  return [String(child)];
+}
+
+// Flatten a child (or array of children) into the output array
+function _flattenInto(child, out) {
+  if (child == null || child === false || child === true) return;
+  if (Array.isArray(child)) {
+    for (let i = 0; i < child.length; i++) {
+      _flattenInto(child[i], out);
     }
+  } else if (typeof child === 'object' && child._vnode) {
+    out.push(child);
+  } else if (typeof child === 'function') {
+    out.push(child);
+  } else {
+    out.push(String(child));
   }
-  return out;
 }
 
 // JSX-like tagged template alternative (no build step needed)

package/src/index.js

@@ -173,6 +173,9 @@ export {
   validateImports,
 } from './guardrails.js';
 
+// Generic text insertion hook (used by external text engines like what-text)
+export { _setTextInsertHook } from './render.js';
+
 // Agent context (global inspection API)
 export {
   installAgentContext,