humn 1.3.4 → 1.4.0

package/dist/humn.js

@@ -1,5 +1,5 @@
 let N = null, x = null;
-const M = () => N, b = (t) => {
+const j = () => N, v = (t) => {
   N = t;
 }, S = () => x, w = (t) => {
   x = t;
@@ -8,8 +8,8 @@ class T {
   constructor({ memory: e, synapses: r }) {
     const o = { ...e };
     this._persistenceMap = /* @__PURE__ */ new Map();
-    for (const [n, s] of Object.entries(e)) if (s && s.__humn_persist) {
-      const c = s.config.key || n;
+    for (const [n, s] of Object.entries(e)) if (s && typeof s == "object" && s.__humn_persist) {
+      const c = s.config?.key || n;
       this._persistenceMap.set(n, c);
       try {
         const i = localStorage.getItem(c);
@@ -59,7 +59,7 @@ class T {
     } });
   }
   get memory() {
-    const e = M();
+    const e = j();
     if (!e) return this._memory;
     this._listeners.has(e) || this._listeners.set(e, /* @__PURE__ */ new Set());
     const r = this._listeners.get(e);
@@ -136,7 +136,7 @@ function A(t, e = {}, r = {}) {
     else t.removeAttribute(n);
   }
 }
-function j(t, e, r) {
+function M(t, e, r) {
   if (!(E(e) || E(r))) {
     const o = Math.max(e.length, r.length);
     for (let n = 0; n < o; n++) m(t, e[n], r[n], n);
@@ -152,8 +152,8 @@ function j(t, e, r) {
       if (k) {
         const h = k.vNode;
         m(o, i, h, l);
-        const u = i.el || h.el, v = o.childNodes[l];
-        u && v !== u && o.insertBefore(u, v), delete c[a];
+        const u = i.el || h.el, b = o.childNodes[l];
+        u && b !== u && o.insertBefore(u, b), delete c[a];
       } else {
         const h = f(i, y(o)), u = o.childNodes[l];
         u ? o.insertBefore(h, u) : o.appendChild(h);
@@ -196,14 +196,14 @@ function m(t, e, r, o = 0) {
     return;
   }
   const n = r.el || t.childNodes[o];
-  n && (e.el = n, A(n, e.props, r.props), j(n, e.children, r.children));
+  n && (e.el = n, A(n, e.props, r.props), M(n, e.children, r.children));
 }
 const R = (t, e) => {
   let r = null;
   const o = () => {
-    b(o);
+    v(o);
     const n = { tag: e, props: {}, children: [] };
-    m(t, n, r), b(null), r = n;
+    m(t, n, r), v(null), r = n;
   };
   o();
 }, W = (t, e = {}) => ({ __humn_persist: !0, initial: t, config: e });

package/dist/humn.js.map

@@ -1 +1 @@
-{"version":3,"file":"humn.js","sources":["../src/observer.js","../src/cortex.js","../src/css.js","../src/h.js","../src/lifecycle.js","../src/patch.js","../src/mount.js","../src/persist.js"],"sourcesContent":["/**\n * @file Observer module for tracking global state during rendering.\n * @module observer\n */\n\nlet currentObserver = null // For Cortex/State dependency\nlet currentInstance = null // For Lifecycle Hooks\n\n/**\n * Gets the current observer (render function).\n * @returns {function|null}\n */\nexport const getObserver = () => currentObserver\n\n/**\n * Sets the current observer.\n * @param {function|null} obs\n */\nexport const setObserver = (obs) => {\n  currentObserver = obs\n}\n\n/**\n * Gets the current component instance (hook container).\n * @returns {object|null}\n */\nexport const getInstance = () => currentInstance\n\n/**\n * Sets the current component instance.\n * @param {object|null} inst\n */\nexport const setInstance = (inst) => {\n  currentInstance = inst\n}\n","import { isDev } from './metrics.js'\nimport { getObserver } from './observer.js'\n\n/**\n * @typedef {object} Synapses\n * @property {function} set - Function to update the memory\n * @property {function} get - Function to get the memory\n */\n\n/**\n * @typedef {object} CortexParams\n * @property {object} memory - The initial state\n * @property {function(function, function): object} synapses - The synapses function\n */\n\n/**\n * The Cortex class manages the state of the application.\n * This uses a Proxy for fine-grained reactivity, ensuring only those components\n * which use the updated value get re-rendered.\n *\n * WHY: We use Proxies instead of simple getters/setters because it allows us to\n * detect access to nested properties dynamically without needing to declare\n * dependencies upfront. This \"magic\" auto-subscription is what makes Humn's\n * DX so clean.\n */\nexport class Cortex {\n  /**\n   * Creates an instance of Cortex.\n   * @param {CortexParams} CortexParams - The parameters for the Cortex.\n   */\n  constructor({ memory, synapses }) {\n    const liveMemory = { ...memory }\n    this._persistenceMap = new Map()\n\n    // Load in any existing values from local-storage\n    for (const [key, value] of Object.entries(memory)) {\n      if (value && value.__humn_persist) {\n        const storageKey = value.config.key || key\n        this._persistenceMap.set(key, storageKey)\n\n        try {\n          const stored = localStorage.getItem(storageKey)\n          if (stored !== null) {\n            liveMemory[key] = JSON.parse(stored)\n          } else {\n            liveMemory[key] = value.initial\n          }\n        } catch (err) {\n          if (isDev)\n            console.warn(`Humn: Failed to load '${key}' from storage.`, err)\n          liveMemory[key] = value.initial\n        }\n      }\n    }\n\n    this._memory = liveMemory\n    this._listeners = new Map()\n\n    const get = () => this._memory\n\n    const set = (updater) => {\n      let nextState\n      let changedPaths = new Set()\n\n      if (typeof updater === 'function') {\n        const clone = structuredClone(this._memory)\n        const proxy = this._createChangeTrackingProxy(clone, changedPaths)\n        const result = updater(proxy)\n\n        if (result && typeof result === 'object') {\n          nextState = { ...this._memory, ...result }\n          Object.keys(result).forEach((key) => changedPaths.add(key))\n        } else {\n          nextState = clone\n        }\n      } else {\n        nextState = { ...this._memory, ...updater }\n        changedPaths = new Set(Object.keys(updater))\n      }\n\n      this._memory = nextState\n\n      // If we need to persist any of the values\n      // we save them to localStorage here\n      if (this._persistenceMap.size > 0) {\n        this._persistenceMap.forEach((storageKey, stateKey) => {\n          const isDirty = Array.from(changedPaths).some(\n            (path) => path === stateKey || path.startsWith(stateKey + '.'),\n          )\n\n          if (isDirty) {\n            try {\n              const value = this._memory[stateKey]\n              localStorage.setItem(storageKey, JSON.stringify(value))\n            } catch (err) {\n              if (isDev)\n                console.error(`Humn: Failed to save '${stateKey}'.`, err)\n            }\n          }\n        })\n      }\n\n      this._notifyRelevantListeners(changedPaths)\n    }\n\n    this.synapses = synapses(set, get)\n  }\n\n  /**\n   * Creates a Proxy that tracks which properties are being mutated.\n   * Includes a GET trap to recursively proxy nested objects for deep mutation tracking.\n   *\n   * WHY: We need to know exactly which paths were changed so we can notify ONLY\n   * the components that care about those specific paths. If we just knew \"something changed\",\n   * we'd have to re-render the whole app (like Redux) or rely on manual optimization.\n   */\n  _createChangeTrackingProxy(obj, changedPaths, path = '') {\n    return new Proxy(obj, {\n      get: (target, prop) => {\n        if (typeof prop === 'symbol' || prop === '__proto__')\n          return target[prop]\n\n        const value = target[prop]\n        const fullPath = path ? `${path}.${prop}` : prop\n\n        // Recursively proxy nested objects so we can trap their sets too\n        if (typeof value === 'object' && value !== null) {\n          return this._createChangeTrackingProxy(value, changedPaths, fullPath)\n        }\n        return value\n      },\n      set: (target, prop, value) => {\n        if (typeof prop === 'symbol' || prop === '__proto__') {\n          target[prop] = value\n          return true\n        }\n\n        const fullPath = path ? `${path}.${prop}` : prop\n        changedPaths.add(fullPath)\n\n        target[prop] = value\n        return true\n      },\n    })\n  }\n\n  /**\n   * Only notify listeners that read properties which changed\n   */\n  _notifyRelevantListeners(changedPaths) {\n    this._listeners.forEach((accessedPaths, renderFn) => {\n      const shouldNotify = Array.from(accessedPaths).some((accessedPath) => {\n        return Array.from(changedPaths).some((changedPath) => {\n          // Check for exact match or parent/child relationship\n          return (\n            accessedPath === changedPath ||\n            accessedPath.startsWith(changedPath + '.') ||\n            changedPath.startsWith(accessedPath + '.')\n          )\n        })\n      })\n\n      if (shouldNotify) renderFn()\n    })\n  }\n\n  /**\n   * Creates a Proxy that tracks which properties are accessed during render\n   *\n   * WHY: This is the other half of the magic. By tracking what a component READS\n   * during its render, we build a precise dependency graph. If a component reads\n   * `state.user.name`, it will only re-render when `state.user.name` changes,\n   * not when `state.count` changes.\n   */\n  _createAccessTrackingProxy(obj, accessedPaths, path = '') {\n    if (typeof obj !== 'object' || obj === null) return obj\n\n    return new Proxy(obj, {\n      get: (target, prop) => {\n        // We don't care about prototype and symbol properties\n        if (typeof prop === 'symbol' || prop === '__proto__')\n          return target[prop]\n\n        const fullPath = path ? `${path}.${prop}` : prop\n        accessedPaths.add(fullPath)\n\n        const value = target[prop]\n\n        // Recursively wrap nested objects\n        if (typeof value === 'object' && value !== null)\n          return this._createAccessTrackingProxy(value, accessedPaths, fullPath)\n\n        return value\n      },\n    })\n  }\n\n  /**\n   * Returns memory wrapped in a tracking Proxy\n   */\n  get memory() {\n    const currentObserver = getObserver()\n\n    if (!currentObserver) return this._memory\n\n    if (!this._listeners.has(currentObserver))\n      this._listeners.set(currentObserver, new Set())\n\n    const accessedPaths = this._listeners.get(currentObserver)\n\n    return this._createAccessTrackingProxy(this._memory, accessedPaths)\n  }\n}\n","/**\n * @file Runtime Scoped CSS implementation using Native CSS Nesting.\n * @module css\n */\n\nlet styleSheet = null\nconst cache = new Set()\n\n/**\n * Simple DJB2 hashing function.\n */\nfunction hashString(str) {\n  let hash = 5381\n  let i = str.length\n  while (i) {\n    hash = (hash * 33) ^ str.charCodeAt(--i)\n  }\n  return (hash >>> 0).toString(36)\n}\n\n/**\n * Lightweight Runtime Minifier.\n * Removes comments and collapses whitespace.\n * We do not strip spaces around colons/brackets to ensure safety for calc().\n */\nfunction minify(css) {\n  return css\n    .replace(/\\/\\*[\\s\\S]*?\\*\\//g, '') // Remove comments\n    .replace(/\\s+/g, ' ') // Collapse newlines/tabs to single space\n    .trim() // Remove leading/trailing\n}\n\n/**\n * Scoped CSS Tag.\n * Wraps content in a unique class using Native CSS Nesting.\n * Supports two signatures:\n * 1. Tagged Template: css`...`\n * 2. Function: css(string, isSingleRoot)\n */\nexport function css(stringsOrStr, ...args) {\n  let raw = ''\n  let isSingleRoot = false\n\n  // Detect usage of Tagged Template vs Function Call\n  if (Array.isArray(stringsOrStr) && stringsOrStr.raw) {\n    raw = stringsOrStr.reduce((acc, str, i) => {\n      return acc + str + (args[i] || '')\n    }, '')\n  } else {\n    raw = stringsOrStr\n    // If called as function, the first arg is our boolean flag\n    isSingleRoot = args[0] === true\n  }\n  let content = minify(raw)\n\n  if (!content) return ''\n\n  if (isSingleRoot) {\n    // Transforms selectors to apply to BOTH the root (using &) AND descendants.\n    // e.g. \"div\" -> \"div&, div\"\n\n    // Regex Breakdown:\n    // 1. (^|[{};,])      -> Hard Start (Line start, brace, semi, comma)\n    // 2. (\\s*)           -> Whitespace\n    // 3. (?!from|to)     -> Negative Lookahead: Ignore 'from'/'to' (keyframes)\n    // 4. ( ... )+        -> Compound Selector:\n    //    (?:[.#]?[\\w-]+ ... ) -> Matches tags (div), classes (.class), ids (#id)\n    // 5. (?=\\s*\\{)       -> Lookahead: Must be followed by {\n\n    content = content.replace(\n      /(^|[{};,])(\\s*)(?!from|to)((?:[.#]?[\\w-]+|\\[[^\\]]+\\]|:{1,2}[^:,{\\s]+)+)(?=\\s*\\{)/gi,\n      '$1$2$3&, $3',\n    )\n  }\n\n  const hash = hashString(content)\n  const hashedClassName = `humn-${hash}`\n\n  if (cache.has(hash)) {\n    return hashedClassName\n  }\n\n  if (!styleSheet) {\n    styleSheet = document.createElement('style')\n    styleSheet.id = 'humn-styles'\n    document.head.appendChild(styleSheet)\n  }\n\n  styleSheet.textContent += `.${hashedClassName} { \n    ${content} \n  }\\n`\n  cache.add(hash)\n\n  return hashedClassName\n}\n","/**\n * @typedef {object} VNode\n * @property {string} tag\n * @property {object} props\n * @property {VNode[]} children\n */\n\n/**\n * Creates a virtual DOM node.\n * This is a hyperscript-like function.\n *\n * @param {string} tag - The tag name of the element.\n * @param {object} props - The properties of the element.\n * @param {VNode[]|VNode} children - The children of the element.\n * @returns {VNode} The virtual DOM node.\n */\nexport const h = (tag, props = {}, children = []) => {\n  const childArray = Array.isArray(children) ? children : [children]\n\n  // Filter out null/false so we don't have \"ghost\" nodes\n  const cleanChildren = childArray\n    .flat()\n    .filter((c) => c !== null && c !== undefined && c !== false && c !== '')\n\n  return {\n    tag,\n    props,\n    children: cleanChildren,\n  }\n}\n","/**\n * @file Lifecycle hooks for components.\n * @module lifecycle\n */\nimport { getInstance } from './observer.js'\n\n/**\n * Registers a callback to run after the component mounts.\n * @param {function} fn - The callback function.\n */\nexport function onMount(fn) {\n  const instance = getInstance()\n  if (instance) {\n    instance.mounts.push(fn)\n  }\n}\n\n/**\n * Registers a callback to run when the component unmounts.\n * @param {function} fn - The callback function.\n */\nexport function onCleanup(fn) {\n  const instance = getInstance()\n  if (instance) {\n    instance.cleanups.push(fn)\n  }\n}\n","/**\n * @file This file contains the diffing and patching algorithm for the virtual DOM,\n * including support for Keyed Diffing.\n * @module patch\n */\nimport { track } from './metrics.js'\nimport { setInstance } from './observer.js'\n\nfunction getNamespace(parent) {\n  if (parent.namespaceURI === SVG_NS && parent.tagName !== 'foreignObject') {\n    return SVG_NS\n  }\n  if (parent.namespaceURI === MATH_NS) {\n    return MATH_NS\n  }\n  return null\n}\n\n/**\n * Checks if a list of children contains keys.\n * @param {Array<import(\"./h.js\").VNode>} children - The list of VNodes.\n * @returns {boolean} True if keys are present.\n */\nexport function hasKeys(children) {\n  return children && children.some((c) => c && c.props && c.props.key != null)\n}\n\nconst SVG_NS = 'http://www.w3.org/2000/svg'\nconst MATH_NS = 'http://www.w3.org/1998/Math/MathML'\n/**\n * Creates a real DOM element from a virtual node.\n * @param {import(\"./h.js\").VNode | string | number} vNode\n * @param {string} [namespace] - The current namespace URI (if any).\n * @returns {Text | HTMLElement | SVGElement}\n */\nfunction createElement(vNode, namespace) {\n  if (typeof vNode === 'string' || typeof vNode === 'number') {\n    return document.createTextNode(String(vNode))\n  }\n\n  if (typeof vNode.tag === 'function') {\n    const childVNode = renderComponent(vNode)\n    vNode.child = childVNode\n\n    const el = createElement(childVNode, namespace)\n\n    vNode.el = el\n    if (vNode.hooks?.mounts.length > 0) {\n      setTimeout(() => vNode.hooks.mounts.forEach((fn) => fn()), 0)\n    }\n    return el\n  }\n\n  track('elementsCreated')\n\n  const tag = vNode.tag\n\n  // We prioritize specific tag declarations over the inherited namespace.\n  if (tag === 'svg') namespace = SVG_NS\n  else if (tag === 'math') namespace = MATH_NS\n  // NOTE: If we are inside 'foreignObject', we must NOT use the SVG NS.\n  // We handle this by resetting 'ns' in the recursion step below,\n  // so 'ns' entering here is already null for the foreignObject's children.\n\n  // createElementNS is slower than createElement, so only use it if we have a namespace.\n  const element = namespace\n    ? document.createElementNS(namespace, tag)\n    : document.createElement(tag)\n\n  vNode.el = element\n  patchProps(element, vNode.props)\n\n  // If we are currently at a 'foreignObject', children must exit the SVG namespace.\n  const childNS = tag === 'foreignObject' ? null : namespace\n\n  vNode.children.forEach((child) => {\n    element.appendChild(createElement(child, childNS))\n  })\n\n  return element\n}\n\n/**\n * Updates the properties (attributes/events) of a DOM element.\n * @param {HTMLElement} element - The DOM element to update.\n * @param {object} [newProps={}] - The new properties.\n * @param {object} [oldProps={}] - The old properties.\n *\n * WHY: We check against the LIVE DOM value for inputs (value/checked) to prevent\n * the \"cursor jumping\" bug. If we just blindly set the attribute, the browser\n * might reset the cursor position to the end of the input.\n */\nfunction patchProps(element, newProps = {}, oldProps = {}) {\n  if (!element) return\n\n  const allProps = { ...oldProps, ...newProps }\n\n  for (const key in allProps) {\n    const oldValue = oldProps[key]\n    const newValue = newProps[key]\n\n    // Handle removed props\n    if (newValue === undefined || newValue === null) {\n      element.removeAttribute(key)\n      track('patches')\n      continue\n    }\n\n    // We check against the LIVE DOM value to prevent cursor jumping\n    if (key === 'value' || key === 'checked') {\n      if (element[key] !== newValue) {\n        element[key] = newValue\n        track('patches')\n      }\n      continue\n    }\n\n    // If prop hasn't changed, skip\n    if (oldValue === newValue) continue\n\n    track('patches')\n\n    // Handle Events\n    if (key.startsWith('on')) {\n      const eventName = key.slice(2).toLowerCase()\n      if (oldValue) element.removeEventListener(eventName, oldValue)\n      element.addEventListener(eventName, newValue)\n    }\n    // Handle the disabled attribute\n    if (key === 'disabled') {\n      element.disabled = newValue === true || newValue === 'true'\n    }\n    // Handle standard attributes\n    else {\n      element.setAttribute(key, newValue)\n    }\n  }\n}\n\n/**\n * Reconciles the children of a node, handling both simple lists and keyed reordering.\n * @param {HTMLElement} parent - The parent DOM element.\n * @param {Array<import(\"./h.js\").VNode>} newChildren - The new list of children.\n * @param {Array<import(\"./h.js\").VNode>} oldChildren - The old list of children.\n *\n * WHY: This is the most complex part of the VDOM. We need to efficiently update\n * a list of items. Without keys, we just update index-by-index, which is fast\n * but causes issues if items are reordered (state gets mixed up).\n * With keys, we can track items as they move around, preserving their state\n * and minimizing DOM operations.\n */\nfunction reconcileChildren(parent, newChildren, oldChildren) {\n  const isKeyed = hasKeys(newChildren) || hasKeys(oldChildren)\n\n  // If no keys are used, use the fast index-based simple loop.\n  // This is faster for static lists or simple text replacements.\n  if (!isKeyed) {\n    const maxLen = Math.max(newChildren.length, oldChildren.length)\n    for (let i = 0; i < maxLen; i++) {\n      patch(parent, newChildren[i], oldChildren[i], i)\n    }\n    return\n  }\n\n  reconcileKeyedChildren(parent, newChildren, oldChildren)\n}\n\n/**\n * Handles the complex logic of reconciling keyed children.\n *\n * WHY: When keys are present, we can't just iterate by index. We need to map\n * existing children by their key so we can find them even if they've moved.\n * This allows us to re-use DOM nodes (preserving focus/state) instead of\n * destroying and re-creating them.\n */\nfunction reconcileKeyedChildren(parent, newChildren, oldChildren) {\n  // Map existing children by Key for O(1) lookup\n  const keyed = {}\n  oldChildren.forEach((child, i) => {\n    const key = (child.props && child.props.key) != null ? child.props.key : i\n    keyed[key] = { vNode: child, index: i }\n  })\n\n  newChildren.forEach((newChild, i) => {\n    const key =\n      (newChild.props && newChild.props.key) != null ? newChild.props.key : i\n    const existingChildMatch = keyed[key]\n\n    if (existingChildMatch) {\n      // A. MATCH FOUND - The item existed before\n      const oldVNode = existingChildMatch.vNode\n\n      // Update the node's content recursively\n      patch(parent, newChild, oldVNode, i)\n\n      // If the DOM node isn't in the right spot, move it.\n      // We use oldVNode.el because patch transfers the ref, but just to be safe:\n      const element = newChild.el || oldVNode.el\n\n      // Get the node currently at this index in the real DOM\n      const domChildAtIndex = parent.childNodes[i]\n\n      // If the element exists but is in the wrong place, move it\n      if (element && domChildAtIndex !== element) {\n        parent.insertBefore(element, domChildAtIndex)\n        track('patches')\n      }\n\n      // Remove from map so we know it was re-used\n      delete keyed[key]\n    } else {\n      // B. NO MATCH - This is a new item\n      const newElement = createElement(newChild, getNamespace(parent))\n      const domChildAtIndex = parent.childNodes[i]\n\n      if (domChildAtIndex) {\n        parent.insertBefore(newElement, domChildAtIndex)\n      } else {\n        parent.appendChild(newElement)\n      }\n    }\n  })\n\n  // Remove any old keys that weren't used in the new list\n  Object.values(keyed).forEach(({ vNode }) => {\n    if (vNode.el && vNode.el.parentNode === parent) {\n      runUnmount(vNode) // Clean up hooks\n      parent.removeChild(vNode.el)\n      track('elementsRemoved')\n    }\n  })\n}\n\n/**\n * Executes a Functional Component, tracks hooks, and returns the VNode.\n * @param {import(\"./h.js\").VNode} vNode - The component vNode.\n * @returns {import(\"./h.js\").VNode} The rendered child vNode.\n */\nfunction renderComponent(vNode) {\n  track('componentsRendered')\n\n  // 1. Prepare Hook Container\n  const hooks = {\n    mounts: [],\n    cleanups: [],\n  }\n\n  // 2. Set Global Scope\n  setInstance(hooks)\n\n  // 3. Run the User's Component Function\n  // We pass props as the first argument\n  const renderedVNode = vNode.tag(vNode.props)\n\n  // 4. Clear Global Scope\n  setInstance(null)\n\n  // 5. Attach hooks to the VNode so we can run them later\n  vNode.hooks = hooks\n\n  return renderedVNode\n}\n\n/**\n * Helper to recursively run cleanup hooks when a tree is removed.\n * @param {import(\"./h.js\").VNode} vNode - The vNode to unmount.\n */\nfunction runUnmount(vNode) {\n  if (!vNode) return\n\n  // 1. Run hooks for this node\n  if (vNode.hooks && vNode.hooks.cleanups) {\n    vNode.hooks.cleanups.forEach((fn) => fn())\n  }\n\n  // 2. Recurse into child (if component)\n  if (vNode.child) {\n    runUnmount(vNode.child)\n  }\n\n  // 3. Recurse into children (if element)\n  if (vNode.children) {\n    vNode.children.forEach(runUnmount)\n  }\n}\n\n/**\n * The main diffing function. Compares V-DOM trees and updates the real DOM.\n * @param {HTMLElement} parent - The parent DOM element.\n * @param {import(\"./h.js\").VNode | string | number} newVNode - The new virtual node.\n * @param {import(\"./h.js\").VNode | string | number} oldVNode - The old virtual node.\n * @param {number} [index=0] - The index of the child node (used for simple diffing).\n */\nexport function patch(parent, newVNode, oldVNode, index = 0) {\n  track('diffs')\n\n  // Case 1: Removal - The new node is null/undefined, so we remove the old one.\n  if (newVNode === undefined || newVNode === null) {\n    const el = oldVNode.el || parent.childNodes[index]\n\n    // Recursive Cleanup\n    runUnmount(oldVNode)\n\n    if (el) {\n      parent.removeChild(el)\n      track('elementsRemoved')\n    }\n    return\n  }\n\n  // Case 2: Component - If it's a function, we delegate to the component logic.\n  if (typeof newVNode.tag === 'function') {\n    const isNew = !oldVNode\n\n    const childVNode = renderComponent(newVNode)\n    newVNode.child = childVNode\n\n    const oldChild = oldVNode ? oldVNode.child : undefined\n    patch(parent, childVNode, oldChild, index)\n\n    newVNode.el = childVNode.el\n\n    // Run mount hooks on the next tick\n    if (isNew && newVNode.hooks && newVNode.hooks.mounts.length > 0) {\n      setTimeout(() => {\n        newVNode.hooks.mounts.forEach((fn) => fn())\n      }, 0)\n    }\n    // TODO: Handle updates (running old cleanups if necessary) for Phase 2\n    return\n  }\n\n  // Case 3: Creation - No old node exists, so we create a new one.\n  if (oldVNode === undefined || oldVNode === null) {\n    parent.appendChild(createElement(newVNode, getNamespace(parent)))\n    return\n  }\n\n  // Case 4: Replacement - The node type changed (e.g. div -> span), so we replace it entirely.\n  if (\n    typeof newVNode !== typeof oldVNode ||\n    (typeof newVNode !== 'string' && newVNode.tag !== oldVNode.tag)\n  ) {\n    const el = oldVNode.el || parent.childNodes[index]\n    if (el) {\n      parent.replaceChild(createElement(newVNode, getNamespace(parent)), el)\n      track('patches')\n    }\n    return\n  }\n\n  // Case 5: Text Update - It's a text node, so we just update the text content.\n  if (typeof newVNode === 'string' || typeof newVNode === 'number') {\n    if (newVNode !== oldVNode) {\n      const el = parent.childNodes[index]\n      if (el) {\n        el.nodeValue = String(newVNode)\n        track('patches')\n      } else {\n        // Self healing: if text node missing, append it\n        parent.appendChild(document.createTextNode(String(newVNode)))\n      }\n    }\n    return\n  }\n\n  // Case 6: Update - Same tag, so we update props and recurse into children.\n  const el = oldVNode.el || parent.childNodes[index]\n\n  if (!el) return\n\n  // Transfer DOM reference to the new VNode\n  newVNode.el = el\n\n  patchProps(el, newVNode.props, oldVNode.props)\n\n  reconcileChildren(el, newVNode.children, oldVNode.children)\n}\n","/**\n * @file Mounts the application to the DOM.\n * @module mount\n */\nimport { setObserver } from './observer.js'\nimport { patch } from './patch.js'\n\n/**\n * Mounts a component to a target DOM element.\n * @param {HTMLElement} target - The DOM element to mount to.\n * @param {function} Component - The root component function.\n */\nexport const mount = (target, Component) => {\n  let prevVNode = null\n\n  const lifecycle = () => {\n    setObserver(lifecycle)\n\n    const nextVNode = {\n      tag: Component,\n      props: {},\n      children: [],\n    }\n\n    patch(target, nextVNode, prevVNode)\n    setObserver(null)\n    prevVNode = nextVNode\n  }\n\n  lifecycle()\n}\n","/**\n * @typedef {object} HumnPersist\n * @property {boolean} __humn_persist\n * @property {any} initial\n * @property {PersistConfig} config\n */\n\n/**\n * @typedef {object} PersistConfig\n * @property {string} key\n */\n\n/**\n * Marks a section of the state for persistence in localStorage.\n *\n * @param {any} initial - The initial value of the state.\n * @param {PersistConfig} config - The configuration for persistence.\n * @returns {HumnPersist}\n */\nexport const persist = (initial, config = {}) => ({\n  __humn_persist: true,\n  initial,\n  config,\n})\n"],"names":["currentObserver","currentInstance","getObserver","setObserver","obs","getInstance","setInstance","inst","Cortex","memory","synapses","liveMemory","this","_persistenceMap","Map","key","value","Object","entries","__humn_persist","storageKey","config","set","stored","localStorage","getItem","JSON","parse","initial","err","_memory","_listeners","updater","nextState","changedPaths","Set","clone","structuredClone","result","_createChangeTrackingProxy","keys","forEach","add","size","stateKey","Array","from","some","path","startsWith","setItem","stringify","_notifyRelevantListeners","obj","Proxy","get","target","prop","fullPath","accessedPaths","renderFn","accessedPath","changedPath","_createAccessTrackingProxy","has","styleSheet","cache","css","stringsOrStr","args","raw","isSingleRoot","isArray","reduce","acc","str","i","content","replace","trim","hash","length","charCodeAt","toString","hashedClassName","document","createElement","id","head","appendChild","textContent","h","tag","props","children","flat","filter","c","onMount","fn","instance","mounts","push","onCleanup","cleanups","getNamespace","parent","namespaceURI","SVG_NS","tagName","MATH_NS","hasKeys","vNode","namespace","createTextNode","String","childVNode","renderComponent","child","el","hooks","setTimeout","element","createElementNS","patchProps","childNS","newProps","oldProps","allProps","oldValue","newValue","eventName","slice","toLowerCase","removeEventListener","addEventListener","disabled","setAttribute","removeAttribute","reconcileChildren","newChildren","oldChildren","maxLen","Math","max","patch","keyed","index","newChild","existingChildMatch","oldVNode","domChildAtIndex","childNodes","insertBefore","newElement","values","parentNode","runUnmount","removeChild","renderedVNode","newVNode","isNew","replaceChild","nodeValue","mount","Component","prevVNode","lifecycle","nextVNode","persist"],"mappings":"AAKA,IAAIA,IAAkB,MAClBC,IAAkB;AAMf,MAAMC,IAAc,MAAMF,GAMpBG,IAAeC,OAAAA;AAC1BJ,EAAAA,IAAkBI;AAAAA,GAOPC,IAAc,MAAMJ,GAMpBK,IAAeC,CAAAA,MAAAA;AAC1BN,EAAAA,IAAkBM;AAAAA;ACRb,MAAMC,EAAAA;AAAAA,EAKX,cAAYC,QAAEA,GAAMC,UAAEA,EAAAA,GAAAA;AACpB,UAAMC,IAAa,EAAA,GAAKF,EAAAA;AACxBG,SAAKC,kBAAkB,oBAAIC;AAG3B,eAAK,CAAOC,GAAKC,CAAAA,KAAUC,OAAOC,QAAQT,GACxC,KAAIO,KAASA,EAAMG,gBAAgB;AACjC,YAAMC,IAAaJ,EAAMK,OAAON,OAAOA;AACvCH,WAAKC,gBAAgBS,IAAIP,GAAKK,CAAAA;AAE9B,UAAA;AACE,cAAMG,IAASC,aAAaC,QAAQL,CAAAA;AAElCT,QAAAA,EAAWI,KADTQ,MAAW,OACKG,KAAKC,MAAMJ,KAEXP,EAAMY;AAAAA,MAE5B,QAASC;AAGPlB,QAAAA,EAAWI,CAAAA,IAAOC,EAAMY;AAAAA,MAC1B;AAAA,IACF;AAGFhB,SAAKkB,UAAUnB,GACfC,KAAKmB,aAAa,oBAAIjB,OAiDtBF,KAAKF,WAAWA,EA7CHsB,CAAAA,MAAAA;AACX,UAAIC,GACAC,IAAe,oBAAIC;AAEvB,UAAuB,OAAZH,KAAY,YAAY;AACjC,cAAMI,IAAQC,gBAAgBzB,KAAKkB,OAAAA,GAE7BQ,IAASN,EADDpB,KAAK2B,2BAA2BH,GAAOF,CAAAA,CAAAA;AAGjDI,QAAAA,KAA4B,OAAXA,KAAW,YAC9BL,IAAY,EAAA,GAAKrB,KAAKkB,SAAAA,GAAYQ,EAAAA,GAClCrB,OAAOuB,KAAKF,CAAAA,EAAQG,QAAS1B,CAAAA,MAAQmB,EAAaQ,IAAI3B,CAAAA,CAAAA,KAEtDkB,IAAYG;AAAAA,MAEhB,MACEH,CAAAA,IAAY,EAAA,GAAKrB,KAAKkB,YAAYE,EAAAA,GAClCE,IAAe,IAAIC,IAAIlB,OAAOuB,KAAKR,CAAAA,CAAAA;AAGrCpB,WAAKkB,UAAUG,GAIXrB,KAAKC,gBAAgB8B,OAAO,KAC9B/B,KAAKC,gBAAgB4B,QAAQ,CAACrB,GAAYwB,MAAAA;AAKxC,YAJgBC,MAAMC,KAAKZ,CAAAA,EAAca,KACtCC,CAAAA,MAASA,MAASJ,KAAYI,EAAKC,WAAWL,IAAW,GAAA,CAAA,EAI1D,KAAA;AACE,gBAAM5B,IAAQJ,KAAKkB,QAAQc,CAAAA;AAC3BpB,uBAAa0B,QAAQ9B,GAAYM,KAAKyB,UAAUnC,CAAAA,CAAAA;AAAAA,QAClD;QAGA;AAAA,MAAA,CAAA,GAKNJ,KAAKwC,yBAAyBlB,CAAAA;AAAAA,IAAAA,GA5CpB,MAAMtB,KAAKkB,OAAAA;AAAAA,EAgDzB;AAAA,EAUA,2BAA2BuB,GAAKnB,GAAcc,IAAO;AACnD,WAAO,IAAIM,MAAMD,GAAK,EACpBE,KAAK,CAACC,GAAQC,MAAAA;AACZ,UAAoB,OAATA,KAAS,YAAYA,MAAS,YACvC,QAAOD,EAAOC,CAAAA;AAEhB,YAAMzC,IAAQwC,EAAOC,CAAAA,GACfC,IAAWV,IAAO,GAAGA,CAAAA,IAAQS,CAAAA,KAASA;AAG5C,aAAqB,OAAVzC,KAAU,YAAYA,MAAU,OAClCJ,KAAK2B,2BAA2BvB,GAAOkB,GAAcwB,CAAAA,IAEvD1C;AAAAA,OAETM,KAAK,CAACkC,GAAQC,GAAMzC;AAClB,UAAoB,OAATyC,KAAS,YAAYA,MAAS,YAEvC,QADAD,EAAOC,CAAAA,IAAQzC;AAIjB,YAAM0C,IAAWV,IAAO,GAAGA,CAAAA,IAAQS,CAAAA,KAASA;AAI5C,aAHAvB,EAAaQ,IAAIgB,CAAAA,GAEjBF,EAAOC,CAAAA,IAAQzC,GAAAA;AAAAA,IACR,EAAA,CAAA;AAAA,EAGb;AAAA,EAKA,yBAAyBkB,GAAAA;AACvBtB,SAAKmB,WAAWU,QAAQ,CAACkB,GAAeC,MAAAA;AACjBf,YAAMC,KAAKa,GAAeZ,KAAMc,CAAAA,MAC5ChB,MAAMC,KAAKZ,CAAAA,EAAca,KAAMe,CAAAA,MAGlCD,MAAiBC,KACjBD,EAAaZ,WAAWa,IAAc,GAAA,KACtCA,EAAYb,WAAWY,IAAe,GAAA,CAAA,CAAA,KAK1BD,EAAAA;AAAAA,IAAAA,CAAAA;AAAAA,EAEtB;AAAA,EAUA,2BAA2BP,GAAKM,GAAeX,IAAO,IAAA;AACpD,WAAmB,OAARK,KAAQ,YAAYA,MAAQ,OAAaA,IAE7C,IAAIC,MAAMD,GAAK,EACpBE,KAAK,CAACC,GAAQC,MAAAA;AAEZ,UAAoB,OAATA,KAAS,YAAYA,MAAS,YACvC,QAAOD,EAAOC,CAAAA;AAEhB,YAAMC,IAAWV,IAAO,GAAGA,CAAAA,IAAQS,CAAAA,KAASA;AAC5CE,MAAAA,EAAcjB,IAAIgB,CAAAA;AAElB,YAAM1C,IAAQwC,EAAOC,CAAAA;AAGrB,aAAqB,OAAVzC,KAAU,YAAYA,MAAU,OAClCJ,KAAKmD,2BAA2B/C,GAAO2C,GAAeD,CAAAA,IAExD1C;AAAAA,IAAAA,EAAAA,CAAAA;AAAAA,EAGb;AAAA,EAKA,IAAA;AACE,UAAMhB,IAAkBE,EAAAA;AAExB,QAAA,CAAKF,EAAiB,QAAOY,KAAKkB;AAE7BlB,SAAKmB,WAAWiC,IAAIhE,CAAAA,KACvBY,KAAKmB,WAAWT,IAAItB,GAAiB,oBAAImC,KAAAA;AAE3C,UAAMwB,IAAgB/C,KAAKmB,WAAWwB,IAAIvD,CAAAA;AAE1C,WAAOY,KAAKmD,2BAA2BnD,KAAKkB,SAAS6B,CAAAA;AAAAA,EACvD;AAAA;AC9MF,IAAIM,IAAa;AACjB,MAAMC,IAAQ,oBAAI/B;AAiCX,SAASgC,EAAIC,MAAiBC,GAAAA;AACnC,MAAIC,IAAM,IACNC;AAGA1B,QAAM2B,QAAQJ,CAAAA,KAAiBA,EAAaE,MAC9CA,IAAMF,EAAaK,OAAO,CAACC,GAAKC,GAAKC,MAC5BF,IAAMC,KAAON,EAAKO,CAAAA,KAAM,KAC9B,OAEHN,IAAMF,GAENG,IAAeF,EAAK,CAAA,MAApBE;AAEF,MAAIM,KA5BN,SAAgBV;AACd,WAAOA,EACJW,QAAQ,qBAAqB,EAAA,EAC7BA,QAAQ,QAAQ,GAAA,EAChBC;EACL,GAuBuBT,CAAAA;AAErB,MAAA,CAAKO,EAAS,QAAO;AAEjBN,QAYFM,IAAUA,EAAQC,QAChB,sFACA,aAAA;AAIJ,QAAME,KAhER,SAAoBL,GAAAA;AAClB,QAAIK,IAAO,MACPJ,IAAID,EAAIM;AACZ,WAAOL,IACLI,CAAAA,IAAe,KAAPA,IAAaL,EAAIO,WAAAA,EAAaN,CAAAA;AAExC,YAAQI,MAAS,GAAGG,SAAS,EAAA;AAAA,EAC/B,GAyD0BN,CAAAA,GAClBO,IAAkB,QAAQJ;AAEhC,SAAId,EAAMF,IAAIgB,CAAAA,MAITf,MACHA,IAAaoB,SAASC,cAAc,OAAA,GACpCrB,EAAWsB,KAAK,eAChBF,SAASG,KAAKC,YAAYxB,CAAAA,IAG5BA,EAAWyB,eAAe,IAAIN,CAAAA;AAAAA,MAC1BP,CAAAA;AAAAA;AAAAA,GAEJX,EAAMxB,IAAIsC,KAZDI;AAeX;AC9EY,MAACO,IAAI,CAACC,GAAKC,IAAQ,CAAA,GAAIC,IAAW,CAAA,OAQrC,EACLF,KAAAA,GACAC,UACAC,WAViBjD,MAAM2B,QAAQsB,CAAAA,IAAYA,IAAW,CAACA,CAAAA,GAItDC,KAAAA,EACAC,OAAQC,CAAAA,MAAMA,KAAAA,QAAiCA,MAAjCA,MAAgDA,MAAM,EAANA,EAAAA;ACZ5D,SAASC,EAAQC,GAAAA;AACtB,QAAMC,IAAW/F,EAAAA;AACb+F,EAAAA,KACFA,EAASC,OAAOC,KAAKH,CAAAA;AAEzB;AAMO,SAASI,EAAUJ,GAAAA;AACxB,QAAMC,IAAW/F;AACb+F,EAAAA,KACFA,EAASI,SAASF,KAAKH;AAE3B;AClBA,SAASM,EAAaC,GAAAA;AACpB,SAAIA,EAAOC,iBAAiBC,KAAUF,EAAOG,YAAY,kBAChDD,IAELF,EAAOC,iBAAiBG,IACnBA,IAEF;AACT;AAOO,SAASC,EAAQjB,GAAAA;AACtB,SAAOA,KAAYA,EAAS/C,KAAMkD,OAAMA,KAAKA,EAAEJ,SAASI,EAAEJ,MAAM9E,OAAO;AACzE;AAEA,MAAM6F,IAAS,8BACTE,IAAU;AAOhB,SAASxB,EAAc0B,GAAOC;AAC5B,MAAqB,OAAVD,KAAU,YAA6B,OAAVA,KAAU,SAChD,QAAO3B,SAAS6B,eAAeC,OAAOH,CAAAA,CAAAA;AAGxC,MAAyB,OAAdA,EAAMpB,OAAQ,YAAY;AACnC,UAAMwB,IAAaC,EAAgBL,CAAAA;AACnCA,IAAAA,EAAMM,QAAQF;AAEd,UAAMG,IAAKjC,EAAc8B,GAAYH;AAMrC,WAJAD,EAAMO,KAAKA,GACPP,EAAMQ,OAAOnB,OAAOpB,SAAS,KAC/BwC,WAAW,MAAMT,EAAMQ,MAAMnB,OAAO5D,QAAS0D,CAAAA,MAAOA,EAAAA,CAAAA,GAAO,CAAA,GAEtDoB;AAAAA,EACT;AAIA,QAAM3B,IAAMoB,EAAMpB;AAGN,EAARA,MAAQ,QAAOqB,IAAYL,IACtBhB,MAAQ,WAAQqB,IAAYH;AAMrC,QAAMY,IAAUT,IACZ5B,SAASsC,gBAAgBV,GAAWrB,CAAAA,IACpCP,SAASC,cAAcM,CAAAA;AAE3BoB,EAAAA,EAAMO,KAAKG,GACXE,EAAWF,GAASV,EAAMnB,KAAAA;AAG1B,QAAMgC,IAAUjC,MAAQ,kBAAkB,OAAOqB;AAMjD,SAJAD,EAAMlB,SAASrD,QAAS6E,CAAAA,MAAAA;AACtBI,MAAQjC,YAAYH,EAAcgC,GAAOO,CAAAA,CAAAA;AAAAA,EAAAA,CAAAA,GAGpCH;AACT;AAYA,SAASE,EAAWF,GAASI,IAAW,CAAA,GAAIC,IAAW,CAAA,GAAA;AACrD,MAAA,CAAKL,EAAS;AAEd,QAAMM,IAAW,EAAA,GAAKD,GAAAA,GAAaD,EAAAA;AAEnC,aAAW/G,KAAOiH,GAAU;AAC1B,UAAMC,IAAWF,EAAShH,CAAAA,GACpBmH,IAAWJ,EAAS/G,CAAAA;AAG1B,QAAImH,KAAAA,KAOJ,KAAInH,MAAQ,WAAWA,MAAQ;AAS/B,UAAIkH,MAAaC,GAAjB;AAKA,YAAInH,EAAIkC,WAAW,IAAA,GAAO;AACxB,gBAAMkF,IAAYpH,EAAIqH,MAAM,CAAA,EAAGC;AAC3BJ,UAAAA,KAAUP,EAAQY,oBAAoBH,GAAWF,IACrDP,EAAQa,iBAAiBJ,GAAWD,CAAAA;AAAAA,QACtC;AAEY,QAARnH,MAAQ,aACV2G,EAAQc,WAAWN,YAAqBA,MAAa,SAIrDR,EAAQe,aAAa1H,GAAKmH,CAAAA;AAAAA,MAhBD;AAAA,UARrBR,CAAAA,EAAQ3G,CAAAA,MAASmH,MACnBR,EAAQ3G,CAAAA,IAAOmH;AAAAA,QARjBR,CAAAA,EAAQgB,gBAAgB3H;EAiC5B;AACF;AAcA,SAAS4H,EAAkBjC,GAAQkC,GAAaC,GAAAA;AAK9C,MAAA,EAJgB9B,EAAQ6B,MAAgB7B,EAAQ8B,CAAAA,IAIlC;AACZ,UAAMC,IAASC,KAAKC,IAAIJ,EAAY3D,QAAQ4D,EAAY5D,MAAAA;AACxD,aAASL,IAAI,GAAGA,IAAIkE,GAAQlE,IAC1BqE,CAAAA,EAAMvC,GAAQkC,EAAYhE,CAAAA,GAAIiE,EAAYjE,CAAAA,GAAIA,CAAAA;AAEhD;AAAA,EACF;AAAA,GAaF,SAAgC8B,GAAQkC,GAAaC,GAAAA;AAEnD,UAAMK,IAAQ,CAAA;AACdL,IAAAA,EAAYpG,QAAQ,CAAC6E,GAAO1C,MAAAA;AAC1B,YAAM7D,KAAOuG,EAAMzB,SAASyB,EAAMzB,MAAM9E,QAAQ,OAAOuG,EAAMzB,MAAM9E,MAAM6D;AACzEsE,MAAAA,EAAMnI,CAAAA,IAAO,EAAEiG,OAAOM,GAAO6B,OAAOvE,EAAAA;AAAAA,IAAAA,CAAAA,GAGtCgE,EAAYnG,QAAQ,CAAC2G,GAAUxE,MAAAA;AAC7B,YAAM7D,KACHqI,EAASvD,SAASuD,EAASvD,MAAM9E,QAAQ,OAAOqI,EAASvD,MAAM9E,MAAM6D,GAClEyE,IAAqBH,EAAMnI,CAAAA;AAEjC,UAAIsI,GAAoB;AAEtB,cAAMC,IAAWD,EAAmBrC;AAGpCiC,QAAAA,EAAMvC,GAAQ0C,GAAUE,GAAU1E,CAAAA;AAIlC,cAAM8C,IAAU0B,EAAS7B,MAAM+B,EAAS/B,IAGlCgC,IAAkB7C,EAAO8C,WAAW5E,CAAAA;AAGtC8C,QAAAA,KAAW6B,MAAoB7B,KACjChB,EAAO+C,aAAa/B,GAAS6B,CAAAA,GAAAA,OAKxBL,EAAMnI,CAAAA;AAAAA,MACf,OAAO;AAEL,cAAM2I,IAAapE,EAAc8D,GAAU3C,EAAaC,CAAAA,CAAAA,GAClD6C,IAAkB7C,EAAO8C,WAAW5E,CAAAA;AAEtC2E,QAAAA,IACF7C,EAAO+C,aAAaC,GAAYH,CAAAA,IAEhC7C,EAAOjB,YAAYiE,CAAAA;AAAAA,MAEvB;AAAA,IAAA,CAAA,GAIFzI,OAAO0I,OAAOT,CAAAA,EAAOzG,QAAQ,CAAA,EAAGuE,OAAAA,EAAAA,MAAAA;AAC1BA,MAAAA,EAAMO,MAAMP,EAAMO,GAAGqC,eAAelD,MACtCmD,EAAW7C,CAAAA,GACXN,EAAOoD,YAAY9C,EAAMO,EAAAA;AAAAA,IAAAA,CAAAA;AAAAA,EAI/B,GAnEyBb,GAAQkC,GAAaC,CAAAA;AAC9C;AAyEA,SAASxB,EAAgBL,GAAAA;AAIvB,QAAMQ,IAAQ,EACZnB,QAAQ,CAAA,GACRG,UAAU;AAIZlG,EAAAA,EAAYkH,CAAAA;AAIZ,QAAMuC,IAAgB/C,EAAMpB,IAAIoB,EAAMnB,KAAAA;AAQtC,SALAvF,EAAY,IAAA,GAGZ0G,EAAMQ,QAAQA,GAEPuC;AACT;AAMA,SAASF,EAAW7C;AACbA,EAAAA,MAGDA,EAAMQ,SAASR,EAAMQ,MAAMhB,YAC7BQ,EAAMQ,MAAMhB,SAAS/D,QAAS0D,OAAOA,EAAAA,CAAAA,GAInCa,EAAMM,SACRuC,EAAW7C,EAAMM,KAAAA,GAIfN,EAAMlB,YACRkB,EAAMlB,SAASrD,QAAQoH;AAE3B;AASO,SAASZ,EAAMvC,GAAQsD,GAAUV,GAAUH,IAAQ,GAAA;AAIxD,MAAIa,KAAAA,MAA6C;AAC/C,UAAMzC,IAAK+B,EAAS/B,MAAMb,EAAO8C,WAAWL,CAAAA;AAS5C,WANAU,EAAWP,CAAAA,GAAAA,MAEP/B,KACFb,EAAOoD,YAAYvC,CAAAA;AAAAA,EAIvB;AAGA,aAAWyC,EAASpE,OAAQ,YAAY;AACtC,UAAMqE,KAASX,GAETlC,IAAaC,EAAgB2C,CAAAA;AACnCA,WAAAA,EAAS1C,QAAQF,GAGjB6B,EAAMvC,GAAQU,GADGkC,IAAWA,EAAShC,gBACD6B,CAAAA,GAEpCa,EAASzC,KAAKH,EAAWG,IAAAA,MAGrB0C,KAASD,EAASxC,SAASwC,EAASxC,MAAMnB,OAAOpB,SAAS,KAC5DwC,WAAW,MAAA;AACTuC,MAAAA,EAASxC,MAAMnB,OAAO5D,QAAS0D,CAAAA,MAAOA,EAAAA,CAAAA;AAAAA,IAAAA,GACrC,CAAA;AAAA,EAIP;AAGA,MAAImD,KAAAA,KAEF,QAAA,KADA5C,EAAOjB,YAAYH,EAAc0E,GAAUvD,EAAaC,CAAAA,CAAAA,CAAAA;AAK1D,MAAA,OACSsD,KAAAA,OAAoBV,YACnBU,KAAa,YAAYA,EAASpE,QAAQ0D,EAAS1D,KAC3D;AACA,UAAM2B,IAAK+B,EAAS/B,MAAMb,EAAO8C,WAAWL,CAAAA;AAK5C,WAAA,MAJI5B,KACFb,EAAOwD,aAAa5E,EAAc0E,GAAUvD,EAAaC,CAAAA,CAAAA,GAAUa,CAAAA;AAAAA,EAIvE;AAGA,MAAwB,OAAbyC,KAAa,YAAgC,OAAbA,KAAa,UAAU;AAChE,QAAIA,MAAaV,GAAU;AACzB,YAAM/B,IAAKb,EAAO8C,WAAWL;AACzB5B,MAAAA,IACFA,EAAG4C,YAAYhD,OAAO6C,KAItBtD,EAAOjB,YAAYJ,SAAS6B,eAAeC,OAAO6C,CAAAA,CAAAA,CAAAA;AAAAA,IAEtD;AACA;AAAA,EACF;AAGA,QAAMzC,IAAK+B,EAAS/B,MAAMb,EAAO8C,WAAWL,CAAAA;AAEvC5B,EAAAA,MAGLyC,EAASzC,KAAKA,GAEdK,EAAWL,GAAIyC,EAASnE,OAAOyD,EAASzD,KAAAA,GAExC8C,EAAkBpB,GAAIyC,EAASlE,UAAUwD,EAASxD,QAAAA;AACpD;AC7WY,MAACsE,IAAQ,CAAC5G,GAAQ6G;AAC5B,MAAIC,IAAY;AAEhB,QAAMC,IAAY,MAAA;AAChBpK,IAAAA,EAAYoK,CAAAA;AAEZ,UAAMC,IAAY,EAChB5E,KAAKyE,GACLxE,OAAO,CAAA,GACPC,UAAU,CAAA,EAAA;AAGZmD,IAAAA,EAAMzF,GAAQgH,GAAWF,CAAAA,GACzBnK,EAAY,OACZmK,IAAYE;AAAAA,EAAAA;AAGdD,EAAAA,EAAAA;AAAAA,GCVWE,IAAU,CAAC7I,GAASP,IAAS,QAAE,EAC1CF,gBAAAA,IACAS,SAAAA,GACAP;"}
+{"version":3,"file":"humn.js","sources":["../src/observer.js","../src/cortex.js","../src/css.js","../src/h.js","../src/lifecycle.js","../src/patch.js","../src/mount.js","../src/persist.js"],"sourcesContent":["/**\n * @file Observer module for tracking global state during rendering.\n * @module observer\n */\n\nlet currentObserver = null // For Cortex/State dependency\nlet currentInstance = null // For Lifecycle Hooks\n\n/**\n * Gets the current observer (render function).\n * @returns {function|null}\n */\nexport const getObserver = () => currentObserver\n\n/**\n * Sets the current observer.\n * @param {function|null} obs\n */\nexport const setObserver = (obs) => {\n  currentObserver = obs\n}\n\n/**\n * Gets the current component instance (hook container).\n * @returns {object|null}\n */\nexport const getInstance = () => currentInstance\n\n/**\n * Sets the current component instance.\n * @param {object|null} inst\n */\nexport const setInstance = (inst) => {\n  currentInstance = inst\n}\n","import { isDev } from './metrics.js'\nimport { getObserver } from './observer.js'\n\n/**\n * Mapped type for the Memory configuration object.\n * Allows each property to be the raw value OR a persisted wrapper.\n * @template T\n * @typedef { { [K in keyof T]: T[K] | import('./persist.js').Persisted<T[K]> } } MemoryInput\n */\n\n/**\n * Deeply unwraps persisted values from the memory shape.\n * @template {object} T\n * @typedef {{ [K in keyof T]: T[K] extends import('./persist.js').Persisted<infer I> ? I : T[K] }} UnwrappedMemory\n */\n\n/**\n * @template T\n * @callback Getter\n * @returns {T}\n */\n\n/**\n * @template T\n * @callback Setter\n * @param {Partial<T> | ((state: T) => void | Partial<T> | unknown)} updater\n * @returns {void}\n */\n\n/**\n * @template M, S\n * @callback SynapsesBuilder\n * @param {Setter<M>} set\n * @param {Getter<M>} get\n * @returns {S}\n */\n\n/**\n * @template M, S\n * @typedef {object} CortexConfig\n * @property {MemoryInput<M>} memory - The initial state configuration\n * @property {SynapsesBuilder<M, S>} synapses - The synapses builder function\n */\n\n/**\n * The Cortex class manages the state of the application.\n *\n * @template {object} MemoryType The shape of the application state\n * @template {object} SynapsesType The shape of the actions/methods\n */\nexport class Cortex {\n  /**\n   * Creates an instance of Cortex.\n   * @param {CortexConfig<MemoryType, SynapsesType>} config\n   */\n  constructor({ memory, synapses }) {\n    const liveMemory = { ...memory }\n    this._persistenceMap = new Map()\n\n    // Load in any existing values from local-storage\n    for (const [key, value] of Object.entries(memory)) {\n      if (value && typeof value === 'object' && value.__humn_persist) {\n        const storageKey = value.config?.key || key\n        this._persistenceMap.set(key, storageKey)\n\n        try {\n          const stored = localStorage.getItem(storageKey)\n          if (stored !== null) {\n            liveMemory[key] = JSON.parse(stored)\n          } else {\n            liveMemory[key] = value.initial\n          }\n        } catch (err) {\n          if (isDev)\n            console.warn(`Humn: Failed to load '${key}' from storage.`, err)\n          liveMemory[key] = value.initial\n        }\n      }\n    }\n\n    /** @type {UnwrappedMemory<MemoryType>} */\n    this._memory = liveMemory\n    this._listeners = new Map()\n\n    /** @type {Getter<UnwrappedMemory<MemoryType>>} */\n    const get = () => this._memory\n\n    /** @type {Setter<UnwrappedMemory<MemoryType>>} */\n    const set = (updater) => {\n      let nextState\n      let changedPaths = new Set()\n\n      if (typeof updater === 'function') {\n        const clone = structuredClone(this._memory)\n        const proxy = this._createChangeTrackingProxy(clone, changedPaths)\n        const result = updater(proxy)\n\n        if (result && typeof result === 'object') {\n          nextState = { ...this._memory, ...result }\n          Object.keys(result).forEach((key) => changedPaths.add(key))\n        } else {\n          nextState = clone\n        }\n      } else {\n        nextState = { ...this._memory, ...updater }\n        changedPaths = new Set(Object.keys(updater))\n      }\n\n      this._memory = nextState\n\n      // Persistence logic\n      if (this._persistenceMap.size > 0) {\n        this._persistenceMap.forEach((storageKey, stateKey) => {\n          const isDirty = Array.from(changedPaths).some(\n            (path) => path === stateKey || path.startsWith(stateKey + '.'),\n          )\n\n          if (isDirty) {\n            try {\n              const value = this._memory[stateKey]\n              localStorage.setItem(storageKey, JSON.stringify(value))\n            } catch (err) {\n              if (isDev)\n                console.error(`Humn: Failed to save '${stateKey}'.`, err)\n            }\n          }\n        })\n      }\n\n      this._notifyRelevantListeners(changedPaths)\n    }\n\n    /** @type {SynapsesType} */\n    this.synapses = synapses(set, get)\n  }\n\n  /**\n   * Creates a Proxy that tracks which properties are being mutated.\n   * Includes a GET trap to recursively proxy nested objects for deep mutation tracking.\n   *\n   * WHY: We need to know exactly which paths were changed so we can notify ONLY\n   * the components that care about those specific paths. If we just knew \"something changed\",\n   * we'd have to re-render the whole app (like Redux) or rely on manual optimization.\n   */\n  _createChangeTrackingProxy(obj, changedPaths, path = '') {\n    return new Proxy(obj, {\n      get: (target, prop) => {\n        if (typeof prop === 'symbol' || prop === '__proto__')\n          return target[prop]\n\n        const value = target[prop]\n        const fullPath = path ? `${path}.${prop}` : prop\n\n        // Recursively proxy nested objects so we can trap their sets too\n        if (typeof value === 'object' && value !== null) {\n          return this._createChangeTrackingProxy(value, changedPaths, fullPath)\n        }\n        return value\n      },\n      set: (target, prop, value) => {\n        if (typeof prop === 'symbol' || prop === '__proto__') {\n          target[prop] = value\n          return true\n        }\n\n        const fullPath = path ? `${path}.${prop}` : prop\n        changedPaths.add(fullPath)\n\n        target[prop] = value\n        return true\n      },\n    })\n  }\n\n  /**\n   * Only notify listeners that read properties which changed\n   */\n  _notifyRelevantListeners(changedPaths) {\n    this._listeners.forEach((accessedPaths, renderFn) => {\n      const shouldNotify = Array.from(accessedPaths).some((accessedPath) => {\n        return Array.from(changedPaths).some((changedPath) => {\n          // Check for exact match or parent/child relationship\n          return (\n            accessedPath === changedPath ||\n            accessedPath.startsWith(changedPath + '.') ||\n            changedPath.startsWith(accessedPath + '.')\n          )\n        })\n      })\n\n      if (shouldNotify) renderFn()\n    })\n  }\n\n  /**\n   * Creates a Proxy that tracks which properties are accessed during render\n   *\n   * WHY: This is the other half of the magic. By tracking what a component READS\n   * during its render, we build a precise dependency graph. If a component reads\n   * `state.user.name`, it will only re-render when `state.user.name` changes,\n   * not when `state.count` changes.\n   */\n  _createAccessTrackingProxy(obj, accessedPaths, path = '') {\n    if (typeof obj !== 'object' || obj === null) return obj\n\n    return new Proxy(obj, {\n      get: (target, prop) => {\n        // We don't care about prototype and symbol properties\n        if (typeof prop === 'symbol' || prop === '__proto__')\n          return target[prop]\n\n        const fullPath = path ? `${path}.${prop}` : prop\n        accessedPaths.add(fullPath)\n\n        const value = target[prop]\n\n        // Recursively wrap nested objects\n        if (typeof value === 'object' && value !== null)\n          return this._createAccessTrackingProxy(value, accessedPaths, fullPath)\n\n        return value\n      },\n    })\n  }\n\n  /**\n   * @returns {UnwrappedMemory<MemoryType>}\n   */\n  get memory() {\n    const currentObserver = getObserver()\n\n    if (!currentObserver) return this._memory\n\n    if (!this._listeners.has(currentObserver))\n      this._listeners.set(currentObserver, new Set())\n\n    const accessedPaths = this._listeners.get(currentObserver)\n\n    return this._createAccessTrackingProxy(this._memory, accessedPaths)\n  }\n}\n","/**\n * @file Runtime Scoped CSS implementation using Native CSS Nesting.\n * @module css\n */\n\nlet styleSheet = null\nconst cache = new Set()\n\n/**\n * Simple DJB2 hashing function.\n */\nfunction hashString(str) {\n  let hash = 5381\n  let i = str.length\n  while (i) {\n    hash = (hash * 33) ^ str.charCodeAt(--i)\n  }\n  return (hash >>> 0).toString(36)\n}\n\n/**\n * Lightweight Runtime Minifier.\n * Removes comments and collapses whitespace.\n * We do not strip spaces around colons/brackets to ensure safety for calc().\n */\nfunction minify(css) {\n  return css\n    .replace(/\\/\\*[\\s\\S]*?\\*\\//g, '') // Remove comments\n    .replace(/\\s+/g, ' ') // Collapse newlines/tabs to single space\n    .trim() // Remove leading/trailing\n}\n\n/**\n * Scoped CSS Tag.\n * Wraps content in a unique class using Native CSS Nesting.\n * Supports two signatures:\n * 1. Tagged Template: css`...`\n * 2. Function: css(string, isSingleRoot)\n */\nexport function css(stringsOrStr, ...args) {\n  let raw = ''\n  let isSingleRoot = false\n\n  // Detect usage of Tagged Template vs Function Call\n  if (Array.isArray(stringsOrStr) && stringsOrStr.raw) {\n    raw = stringsOrStr.reduce((acc, str, i) => {\n      return acc + str + (args[i] || '')\n    }, '')\n  } else {\n    raw = stringsOrStr\n    // If called as function, the first arg is our boolean flag\n    isSingleRoot = args[0] === true\n  }\n  let content = minify(raw)\n\n  if (!content) return ''\n\n  if (isSingleRoot) {\n    // Transforms selectors to apply to BOTH the root (using &) AND descendants.\n    // e.g. \"div\" -> \"div&, div\"\n\n    // Regex Breakdown:\n    // 1. (^|[{};,])      -> Hard Start (Line start, brace, semi, comma)\n    // 2. (\\s*)           -> Whitespace\n    // 3. (?!from|to)     -> Negative Lookahead: Ignore 'from'/'to' (keyframes)\n    // 4. ( ... )+        -> Compound Selector:\n    //    (?:[.#]?[\\w-]+ ... ) -> Matches tags (div), classes (.class), ids (#id)\n    // 5. (?=\\s*\\{)       -> Lookahead: Must be followed by {\n\n    content = content.replace(\n      /(^|[{};,])(\\s*)(?!from|to)((?:[.#]?[\\w-]+|\\[[^\\]]+\\]|:{1,2}[^:,{\\s]+)+)(?=\\s*\\{)/gi,\n      '$1$2$3&, $3',\n    )\n  }\n\n  const hash = hashString(content)\n  const hashedClassName = `humn-${hash}`\n\n  if (cache.has(hash)) {\n    return hashedClassName\n  }\n\n  if (!styleSheet) {\n    styleSheet = document.createElement('style')\n    styleSheet.id = 'humn-styles'\n    document.head.appendChild(styleSheet)\n  }\n\n  styleSheet.textContent += `.${hashedClassName} { \n    ${content} \n  }\\n`\n  cache.add(hash)\n\n  return hashedClassName\n}\n","/**\n * @typedef {object} VNode\n * @property {string} tag\n * @property {object} props\n * @property {VNode[]} children\n */\n\n/**\n * Creates a virtual DOM node.\n * This is a hyperscript-like function.\n *\n * @param {string} tag - The tag name of the element.\n * @param {object} props - The properties of the element.\n * @param {VNode[]|VNode} children - The children of the element.\n * @returns {VNode} The virtual DOM node.\n */\nexport const h = (tag, props = {}, children = []) => {\n  const childArray = Array.isArray(children) ? children : [children]\n\n  // Filter out null/false so we don't have \"ghost\" nodes\n  const cleanChildren = childArray\n    .flat()\n    .filter((c) => c !== null && c !== undefined && c !== false && c !== '')\n\n  return {\n    tag,\n    props,\n    children: cleanChildren,\n  }\n}\n","/**\n * @file Lifecycle hooks for components.\n * @module lifecycle\n */\nimport { getInstance } from './observer.js'\n\n/**\n * Registers a callback to run after the component mounts.\n * @param {function} fn - The callback function.\n */\nexport function onMount(fn) {\n  const instance = getInstance()\n  if (instance) {\n    instance.mounts.push(fn)\n  }\n}\n\n/**\n * Registers a callback to run when the component unmounts.\n * @param {function} fn - The callback function.\n */\nexport function onCleanup(fn) {\n  const instance = getInstance()\n  if (instance) {\n    instance.cleanups.push(fn)\n  }\n}\n","/**\n * @file This file contains the diffing and patching algorithm for the virtual DOM,\n * including support for Keyed Diffing.\n * @module patch\n */\nimport { track } from './metrics.js'\nimport { setInstance } from './observer.js'\n\nfunction getNamespace(parent) {\n  if (parent.namespaceURI === SVG_NS && parent.tagName !== 'foreignObject') {\n    return SVG_NS\n  }\n  if (parent.namespaceURI === MATH_NS) {\n    return MATH_NS\n  }\n  return null\n}\n\n/**\n * Checks if a list of children contains keys.\n * @param {Array<import(\"./h.js\").VNode>} children - The list of VNodes.\n * @returns {boolean} True if keys are present.\n */\nexport function hasKeys(children) {\n  return children && children.some((c) => c && c.props && c.props.key != null)\n}\n\nconst SVG_NS = 'http://www.w3.org/2000/svg'\nconst MATH_NS = 'http://www.w3.org/1998/Math/MathML'\n/**\n * Creates a real DOM element from a virtual node.\n * @param {import(\"./h.js\").VNode | string | number} vNode\n * @param {string} [namespace] - The current namespace URI (if any).\n * @returns {Text | HTMLElement | SVGElement}\n */\nfunction createElement(vNode, namespace) {\n  if (typeof vNode === 'string' || typeof vNode === 'number') {\n    return document.createTextNode(String(vNode))\n  }\n\n  if (typeof vNode.tag === 'function') {\n    const childVNode = renderComponent(vNode)\n    vNode.child = childVNode\n\n    const el = createElement(childVNode, namespace)\n\n    vNode.el = el\n    if (vNode.hooks?.mounts.length > 0) {\n      setTimeout(() => vNode.hooks.mounts.forEach((fn) => fn()), 0)\n    }\n    return el\n  }\n\n  track('elementsCreated')\n\n  const tag = vNode.tag\n\n  // We prioritize specific tag declarations over the inherited namespace.\n  if (tag === 'svg') namespace = SVG_NS\n  else if (tag === 'math') namespace = MATH_NS\n  // NOTE: If we are inside 'foreignObject', we must NOT use the SVG NS.\n  // We handle this by resetting 'ns' in the recursion step below,\n  // so 'ns' entering here is already null for the foreignObject's children.\n\n  // createElementNS is slower than createElement, so only use it if we have a namespace.\n  const element = namespace\n    ? document.createElementNS(namespace, tag)\n    : document.createElement(tag)\n\n  vNode.el = element\n  patchProps(element, vNode.props)\n\n  // If we are currently at a 'foreignObject', children must exit the SVG namespace.\n  const childNS = tag === 'foreignObject' ? null : namespace\n\n  vNode.children.forEach((child) => {\n    element.appendChild(createElement(child, childNS))\n  })\n\n  return element\n}\n\n/**\n * Updates the properties (attributes/events) of a DOM element.\n * @param {HTMLElement} element - The DOM element to update.\n * @param {object} [newProps={}] - The new properties.\n * @param {object} [oldProps={}] - The old properties.\n *\n * WHY: We check against the LIVE DOM value for inputs (value/checked) to prevent\n * the \"cursor jumping\" bug. If we just blindly set the attribute, the browser\n * might reset the cursor position to the end of the input.\n */\nfunction patchProps(element, newProps = {}, oldProps = {}) {\n  if (!element) return\n\n  const allProps = { ...oldProps, ...newProps }\n\n  for (const key in allProps) {\n    const oldValue = oldProps[key]\n    const newValue = newProps[key]\n\n    // Handle removed props\n    if (newValue === undefined || newValue === null) {\n      element.removeAttribute(key)\n      track('patches')\n      continue\n    }\n\n    // We check against the LIVE DOM value to prevent cursor jumping\n    if (key === 'value' || key === 'checked') {\n      if (element[key] !== newValue) {\n        element[key] = newValue\n        track('patches')\n      }\n      continue\n    }\n\n    // If prop hasn't changed, skip\n    if (oldValue === newValue) continue\n\n    track('patches')\n\n    // Handle Events\n    if (key.startsWith('on')) {\n      const eventName = key.slice(2).toLowerCase()\n      if (oldValue) element.removeEventListener(eventName, oldValue)\n      element.addEventListener(eventName, newValue)\n    }\n    // Handle the disabled attribute\n    if (key === 'disabled') {\n      element.disabled = newValue === true || newValue === 'true'\n    }\n    // Handle standard attributes\n    else {\n      element.setAttribute(key, newValue)\n    }\n  }\n}\n\n/**\n * Reconciles the children of a node, handling both simple lists and keyed reordering.\n * @param {HTMLElement} parent - The parent DOM element.\n * @param {Array<import(\"./h.js\").VNode>} newChildren - The new list of children.\n * @param {Array<import(\"./h.js\").VNode>} oldChildren - The old list of children.\n *\n * WHY: This is the most complex part of the VDOM. We need to efficiently update\n * a list of items. Without keys, we just update index-by-index, which is fast\n * but causes issues if items are reordered (state gets mixed up).\n * With keys, we can track items as they move around, preserving their state\n * and minimizing DOM operations.\n */\nfunction reconcileChildren(parent, newChildren, oldChildren) {\n  const isKeyed = hasKeys(newChildren) || hasKeys(oldChildren)\n\n  // If no keys are used, use the fast index-based simple loop.\n  // This is faster for static lists or simple text replacements.\n  if (!isKeyed) {\n    const maxLen = Math.max(newChildren.length, oldChildren.length)\n    for (let i = 0; i < maxLen; i++) {\n      patch(parent, newChildren[i], oldChildren[i], i)\n    }\n    return\n  }\n\n  reconcileKeyedChildren(parent, newChildren, oldChildren)\n}\n\n/**\n * Handles the complex logic of reconciling keyed children.\n *\n * WHY: When keys are present, we can't just iterate by index. We need to map\n * existing children by their key so we can find them even if they've moved.\n * This allows us to re-use DOM nodes (preserving focus/state) instead of\n * destroying and re-creating them.\n */\nfunction reconcileKeyedChildren(parent, newChildren, oldChildren) {\n  // Map existing children by Key for O(1) lookup\n  const keyed = {}\n  oldChildren.forEach((child, i) => {\n    const key = (child.props && child.props.key) != null ? child.props.key : i\n    keyed[key] = { vNode: child, index: i }\n  })\n\n  newChildren.forEach((newChild, i) => {\n    const key =\n      (newChild.props && newChild.props.key) != null ? newChild.props.key : i\n    const existingChildMatch = keyed[key]\n\n    if (existingChildMatch) {\n      // A. MATCH FOUND - The item existed before\n      const oldVNode = existingChildMatch.vNode\n\n      // Update the node's content recursively\n      patch(parent, newChild, oldVNode, i)\n\n      // If the DOM node isn't in the right spot, move it.\n      // We use oldVNode.el because patch transfers the ref, but just to be safe:\n      const element = newChild.el || oldVNode.el\n\n      // Get the node currently at this index in the real DOM\n      const domChildAtIndex = parent.childNodes[i]\n\n      // If the element exists but is in the wrong place, move it\n      if (element && domChildAtIndex !== element) {\n        parent.insertBefore(element, domChildAtIndex)\n        track('patches')\n      }\n\n      // Remove from map so we know it was re-used\n      delete keyed[key]\n    } else {\n      // B. NO MATCH - This is a new item\n      const newElement = createElement(newChild, getNamespace(parent))\n      const domChildAtIndex = parent.childNodes[i]\n\n      if (domChildAtIndex) {\n        parent.insertBefore(newElement, domChildAtIndex)\n      } else {\n        parent.appendChild(newElement)\n      }\n    }\n  })\n\n  // Remove any old keys that weren't used in the new list\n  Object.values(keyed).forEach(({ vNode }) => {\n    if (vNode.el && vNode.el.parentNode === parent) {\n      runUnmount(vNode) // Clean up hooks\n      parent.removeChild(vNode.el)\n      track('elementsRemoved')\n    }\n  })\n}\n\n/**\n * Executes a Functional Component, tracks hooks, and returns the VNode.\n * @param {import(\"./h.js\").VNode} vNode - The component vNode.\n * @returns {import(\"./h.js\").VNode} The rendered child vNode.\n */\nfunction renderComponent(vNode) {\n  track('componentsRendered')\n\n  // 1. Prepare Hook Container\n  const hooks = {\n    mounts: [],\n    cleanups: [],\n  }\n\n  // 2. Set Global Scope\n  setInstance(hooks)\n\n  // 3. Run the User's Component Function\n  // We pass props as the first argument\n  const renderedVNode = vNode.tag(vNode.props)\n\n  // 4. Clear Global Scope\n  setInstance(null)\n\n  // 5. Attach hooks to the VNode so we can run them later\n  vNode.hooks = hooks\n\n  return renderedVNode\n}\n\n/**\n * Helper to recursively run cleanup hooks when a tree is removed.\n * @param {import(\"./h.js\").VNode} vNode - The vNode to unmount.\n */\nfunction runUnmount(vNode) {\n  if (!vNode) return\n\n  // 1. Run hooks for this node\n  if (vNode.hooks && vNode.hooks.cleanups) {\n    vNode.hooks.cleanups.forEach((fn) => fn())\n  }\n\n  // 2. Recurse into child (if component)\n  if (vNode.child) {\n    runUnmount(vNode.child)\n  }\n\n  // 3. Recurse into children (if element)\n  if (vNode.children) {\n    vNode.children.forEach(runUnmount)\n  }\n}\n\n/**\n * The main diffing function. Compares V-DOM trees and updates the real DOM.\n * @param {HTMLElement} parent - The parent DOM element.\n * @param {import(\"./h.js\").VNode | string | number} newVNode - The new virtual node.\n * @param {import(\"./h.js\").VNode | string | number} oldVNode - The old virtual node.\n * @param {number} [index=0] - The index of the child node (used for simple diffing).\n */\nexport function patch(parent, newVNode, oldVNode, index = 0) {\n  track('diffs')\n\n  // Case 1: Removal - The new node is null/undefined, so we remove the old one.\n  if (newVNode === undefined || newVNode === null) {\n    const el = oldVNode.el || parent.childNodes[index]\n\n    // Recursive Cleanup\n    runUnmount(oldVNode)\n\n    if (el) {\n      parent.removeChild(el)\n      track('elementsRemoved')\n    }\n    return\n  }\n\n  // Case 2: Component - If it's a function, we delegate to the component logic.\n  if (typeof newVNode.tag === 'function') {\n    const isNew = !oldVNode\n\n    const childVNode = renderComponent(newVNode)\n    newVNode.child = childVNode\n\n    const oldChild = oldVNode ? oldVNode.child : undefined\n    patch(parent, childVNode, oldChild, index)\n\n    newVNode.el = childVNode.el\n\n    // Run mount hooks on the next tick\n    if (isNew && newVNode.hooks && newVNode.hooks.mounts.length > 0) {\n      setTimeout(() => {\n        newVNode.hooks.mounts.forEach((fn) => fn())\n      }, 0)\n    }\n    // TODO: Handle updates (running old cleanups if necessary) for Phase 2\n    return\n  }\n\n  // Case 3: Creation - No old node exists, so we create a new one.\n  if (oldVNode === undefined || oldVNode === null) {\n    parent.appendChild(createElement(newVNode, getNamespace(parent)))\n    return\n  }\n\n  // Case 4: Replacement - The node type changed (e.g. div -> span), so we replace it entirely.\n  if (\n    typeof newVNode !== typeof oldVNode ||\n    (typeof newVNode !== 'string' && newVNode.tag !== oldVNode.tag)\n  ) {\n    const el = oldVNode.el || parent.childNodes[index]\n    if (el) {\n      parent.replaceChild(createElement(newVNode, getNamespace(parent)), el)\n      track('patches')\n    }\n    return\n  }\n\n  // Case 5: Text Update - It's a text node, so we just update the text content.\n  if (typeof newVNode === 'string' || typeof newVNode === 'number') {\n    if (newVNode !== oldVNode) {\n      const el = parent.childNodes[index]\n      if (el) {\n        el.nodeValue = String(newVNode)\n        track('patches')\n      } else {\n        // Self healing: if text node missing, append it\n        parent.appendChild(document.createTextNode(String(newVNode)))\n      }\n    }\n    return\n  }\n\n  // Case 6: Update - Same tag, so we update props and recurse into children.\n  const el = oldVNode.el || parent.childNodes[index]\n\n  if (!el) return\n\n  // Transfer DOM reference to the new VNode\n  newVNode.el = el\n\n  patchProps(el, newVNode.props, oldVNode.props)\n\n  reconcileChildren(el, newVNode.children, oldVNode.children)\n}\n","/**\n * @file Mounts the application to the DOM.\n * @module mount\n */\nimport { setObserver } from './observer.js'\nimport { patch } from './patch.js'\n\n/**\n * Mounts a component to a target DOM element.\n * @param {HTMLElement} target - The DOM element to mount to.\n * @param {function} Component - The root component function.\n */\nexport const mount = (target, Component) => {\n  let prevVNode = null\n\n  const lifecycle = () => {\n    setObserver(lifecycle)\n\n    const nextVNode = {\n      tag: Component,\n      props: {},\n      children: [],\n    }\n\n    patch(target, nextVNode, prevVNode)\n    setObserver(null)\n    prevVNode = nextVNode\n  }\n\n  lifecycle()\n}\n","/**\n * Represents a value wrapped by the persist() function.\n * @template T\n * @typedef {object} Persisted\n * @property {T} initial\n * @property {boolean} __humn_persist\n * @property {PersistConfig} [config]\n */\n\n/**\n * @typedef {object} PersistConfig\n * @property {string} key\n */\n\n/**\n * Marks a section of the state for persistence in localStorage.\n * @template T\n * @param {T} initial\n * @param {PersistConfig} [config]\n * @returns {Persisted<T>}\n */\nexport const persist = (initial, config = {}) => ({\n  __humn_persist: true,\n  initial,\n  config,\n})\n"],"names":["currentObserver","currentInstance","getObserver","setObserver","obs","getInstance","setInstance","inst","Cortex","memory","synapses","liveMemory","this","_persistenceMap","Map","key","value","Object","entries","__humn_persist","storageKey","config","set","stored","localStorage","getItem","JSON","parse","initial","err","_memory","_listeners","updater","nextState","changedPaths","Set","clone","structuredClone","result","_createChangeTrackingProxy","keys","forEach","add","size","stateKey","Array","from","some","path","startsWith","setItem","stringify","_notifyRelevantListeners","obj","Proxy","get","target","prop","fullPath","accessedPaths","renderFn","accessedPath","changedPath","_createAccessTrackingProxy","has","styleSheet","cache","css","stringsOrStr","args","raw","isSingleRoot","isArray","reduce","acc","str","i","content","replace","trim","hash","length","charCodeAt","toString","hashedClassName","document","createElement","id","head","appendChild","textContent","h","tag","props","children","flat","filter","c","onMount","fn","instance","mounts","push","onCleanup","cleanups","getNamespace","parent","namespaceURI","SVG_NS","tagName","MATH_NS","hasKeys","vNode","namespace","createTextNode","String","childVNode","renderComponent","child","el","hooks","setTimeout","element","createElementNS","patchProps","childNS","newProps","oldProps","allProps","oldValue","newValue","eventName","slice","toLowerCase","removeEventListener","addEventListener","disabled","setAttribute","removeAttribute","reconcileChildren","newChildren","oldChildren","maxLen","Math","max","patch","keyed","index","newChild","existingChildMatch","oldVNode","domChildAtIndex","childNodes","insertBefore","newElement","values","parentNode","runUnmount","removeChild","renderedVNode","newVNode","isNew","replaceChild","nodeValue","mount","Component","prevVNode","lifecycle","nextVNode","persist"],"mappings":"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"}

package/dist/humn.umd.js

@@ -1,4 +1,4 @@
-(function(a,h){typeof exports=="object"&&typeof module<"u"?h(exports):typeof define=="function"&&define.amd?define(["exports"],h):h((a=typeof globalThis<"u"?globalThis:a||self).Humn={})})(this,function(a){"use strict";let h=null,v=null;const j=()=>h,w=t=>{h=t},x=()=>v,C=t=>{v=t};let p=null;const E=new Set;function _(t){return t.namespaceURI===b&&t.tagName!=="foreignObject"?b:t.namespaceURI===k?k:null}function N(t){return t&&t.some(e=>e&&e.props&&e.props.key!=null)}const b="http://www.w3.org/2000/svg",k="http://www.w3.org/1998/Math/MathML";function d(t,e){if(typeof t=="string"||typeof t=="number")return document.createTextNode(String(t));if(typeof t.tag=="function"){const r=A(t);t.child=r;const i=d(r,e);return t.el=i,t.hooks?.mounts.length>0&&setTimeout(()=>t.hooks.mounts.forEach(c=>c()),0),i}const s=t.tag;s==="svg"?e=b:s==="math"&&(e=k);const o=e?document.createElementNS(e,s):document.createElement(s);t.el=o,S(o,t.props);const n=s==="foreignObject"?null:e;return t.children.forEach(r=>{o.appendChild(d(r,n))}),o}function S(t,e={},s={}){if(!t)return;const o={...s,...e};for(const n in o){const r=s[n],i=e[n];if(i!=null)if(n!=="value"&&n!=="checked"){if(r!==i){if(n.startsWith("on")){const c=n.slice(2).toLowerCase();r&&t.removeEventListener(c,r),t.addEventListener(c,i)}n==="disabled"?t.disabled=i===!0||i==="true":t.setAttribute(n,i)}}else t[n]!==i&&(t[n]=i);else t.removeAttribute(n)}}function M(t,e,s){if(!(N(e)||N(s))){const o=Math.max(e.length,s.length);for(let n=0;n<o;n++)g(t,e[n],s[n],n);return}(function(o,n,r){const i={};r.forEach((c,l)=>{const u=(c.props&&c.props.key)!=null?c.props.key:l;i[u]={vNode:c,index:l}}),n.forEach((c,l)=>{const u=(c.props&&c.props.key)!=null?c.props.key:l,T=i[u];if(T){const m=T.vNode;g(o,c,m,l);const f=c.el||m.el,$=o.childNodes[l];f&&$!==f&&o.insertBefore(f,$),delete i[u]}else{const m=d(c,_(o)),f=o.childNodes[l];f?o.insertBefore(m,f):o.appendChild(m)}}),Object.values(i).forEach(({vNode:c})=>{c.el&&c.el.parentNode===o&&(y(c),o.removeChild(c.el))})})(t,e,s)}function A(t){const e={mounts:[],cleanups:[]};C(e);const s=t.tag(t.props);return C(null),t.hooks=e,s}function y(t){t&&(t.hooks&&t.hooks.cleanups&&t.hooks.cleanups.forEach(e=>e()),t.child&&y(t.child),t.children&&t.children.forEach(y))}function g(t,e,s,o=0){if(e==null){const r=s.el||t.childNodes[o];return y(s),void(r&&t.removeChild(r))}if(typeof e.tag=="function"){const r=!s,i=A(e);return e.child=i,g(t,i,s?s.child:void 0,o),e.el=i.el,void(r&&e.hooks&&e.hooks.mounts.length>0&&setTimeout(()=>{e.hooks.mounts.forEach(c=>c())},0))}if(s==null)return void t.appendChild(d(e,_(t)));if(typeof e!=typeof s||typeof e!="string"&&e.tag!==s.tag){const r=s.el||t.childNodes[o];return void(r&&t.replaceChild(d(e,_(t)),r))}if(typeof e=="string"||typeof e=="number"){if(e!==s){const r=t.childNodes[o];r?r.nodeValue=String(e):t.appendChild(document.createTextNode(String(e)))}return}const n=s.el||t.childNodes[o];n&&(e.el=n,S(n,e.props,s.props),M(n,e.children,s.children))}a.Cortex=class{constructor({memory:t,synapses:e}){const s={...t};this._persistenceMap=new Map;for(const[o,n]of Object.entries(t))if(n&&n.__humn_persist){const r=n.config.key||o;this._persistenceMap.set(o,r);try{const i=localStorage.getItem(r);s[o]=i!==null?JSON.parse(i):n.initial}catch{s[o]=n.initial}}this._memory=s,this._listeners=new Map,this.synapses=e(o=>{let n,r=new Set;if(typeof o=="function"){const i=structuredClone(this._memory),c=o(this._createChangeTrackingProxy(i,r));c&&typeof c=="object"?(n={...this._memory,...c},Object.keys(c).forEach(l=>r.add(l))):n=i}else n={...this._memory,...o},r=new Set(Object.keys(o));this._memory=n,this._persistenceMap.size>0&&this._persistenceMap.forEach((i,c)=>{if(Array.from(r).some(l=>l===c||l.startsWith(c+".")))try{const l=this._memory[c];localStorage.setItem(i,JSON.stringify(l))}catch{}}),this._notifyRelevantListeners(r)},()=>this._memory)}_createChangeTrackingProxy(t,e,s=""){return new Proxy(t,{get:(o,n)=>{if(typeof n=="symbol"||n==="__proto__")return o[n];const r=o[n],i=s?`${s}.${n}`:n;return typeof r=="object"&&r!==null?this._createChangeTrackingProxy(r,e,i):r},set:(o,n,r)=>{if(typeof n=="symbol"||n==="__proto__")return o[n]=r,!0;const i=s?`${s}.${n}`:n;return e.add(i),o[n]=r,!0}})}_notifyRelevantListeners(t){this._listeners.forEach((e,s)=>{Array.from(e).some(o=>Array.from(t).some(n=>o===n||o.startsWith(n+".")||n.startsWith(o+".")))&&s()})}_createAccessTrackingProxy(t,e,s=""){return typeof t!="object"||t===null?t:new Proxy(t,{get:(o,n)=>{if(typeof n=="symbol"||n==="__proto__")return o[n];const r=s?`${s}.${n}`:n;e.add(r);const i=o[n];return typeof i=="object"&&i!==null?this._createAccessTrackingProxy(i,e,r):i}})}get memory(){const t=j();if(!t)return this._memory;this._listeners.has(t)||this._listeners.set(t,new Set);const e=this._listeners.get(t);return this._createAccessTrackingProxy(this._memory,e)}},a.css=function(t,...e){let s="",o=!1;Array.isArray(t)&&t.raw?s=t.reduce((c,l,u)=>c+l+(e[u]||""),""):(s=t,o=e[0]===!0);let n=(function(c){return c.replace(/\/\*[\s\S]*?\*\//g,"").replace(/\s+/g," ").trim()})(s);if(!n)return"";o&&(n=n.replace(/(^|[{};,])(\s*)(?!from|to)((?:[.#]?[\w-]+|\[[^\]]+\]|:{1,2}[^:,{\s]+)+)(?=\s*\{)/gi,"$1$2$3&, $3"));const r=(function(c){let l=5381,u=c.length;for(;u;)l=33*l^c.charCodeAt(--u);return(l>>>0).toString(36)})(n),i=`humn-${r}`;return E.has(r)||(p||(p=document.createElement("style"),p.id="humn-styles",document.head.appendChild(p)),p.textContent+=`.${i} { 
+(function(a,h){typeof exports=="object"&&typeof module<"u"?h(exports):typeof define=="function"&&define.amd?define(["exports"],h):h((a=typeof globalThis<"u"?globalThis:a||self).Humn={})})(this,function(a){"use strict";let h=null,v=null;const $=()=>h,w=t=>{h=t},x=()=>v,C=t=>{v=t};let p=null;const E=new Set;function _(t){return t.namespaceURI===b&&t.tagName!=="foreignObject"?b:t.namespaceURI===k?k:null}function N(t){return t&&t.some(e=>e&&e.props&&e.props.key!=null)}const b="http://www.w3.org/2000/svg",k="http://www.w3.org/1998/Math/MathML";function d(t,e){if(typeof t=="string"||typeof t=="number")return document.createTextNode(String(t));if(typeof t.tag=="function"){const r=j(t);t.child=r;const i=d(r,e);return t.el=i,t.hooks?.mounts.length>0&&setTimeout(()=>t.hooks.mounts.forEach(c=>c()),0),i}const s=t.tag;s==="svg"?e=b:s==="math"&&(e=k);const o=e?document.createElementNS(e,s):document.createElement(s);t.el=o,S(o,t.props);const n=s==="foreignObject"?null:e;return t.children.forEach(r=>{o.appendChild(d(r,n))}),o}function S(t,e={},s={}){if(!t)return;const o={...s,...e};for(const n in o){const r=s[n],i=e[n];if(i!=null)if(n!=="value"&&n!=="checked"){if(r!==i){if(n.startsWith("on")){const c=n.slice(2).toLowerCase();r&&t.removeEventListener(c,r),t.addEventListener(c,i)}n==="disabled"?t.disabled=i===!0||i==="true":t.setAttribute(n,i)}}else t[n]!==i&&(t[n]=i);else t.removeAttribute(n)}}function M(t,e,s){if(!(N(e)||N(s))){const o=Math.max(e.length,s.length);for(let n=0;n<o;n++)g(t,e[n],s[n],n);return}(function(o,n,r){const i={};r.forEach((c,l)=>{const u=(c.props&&c.props.key)!=null?c.props.key:l;i[u]={vNode:c,index:l}}),n.forEach((c,l)=>{const u=(c.props&&c.props.key)!=null?c.props.key:l,A=i[u];if(A){const m=A.vNode;g(o,c,m,l);const f=c.el||m.el,T=o.childNodes[l];f&&T!==f&&o.insertBefore(f,T),delete i[u]}else{const m=d(c,_(o)),f=o.childNodes[l];f?o.insertBefore(m,f):o.appendChild(m)}}),Object.values(i).forEach(({vNode:c})=>{c.el&&c.el.parentNode===o&&(y(c),o.removeChild(c.el))})})(t,e,s)}function j(t){const e={mounts:[],cleanups:[]};C(e);const s=t.tag(t.props);return C(null),t.hooks=e,s}function y(t){t&&(t.hooks&&t.hooks.cleanups&&t.hooks.cleanups.forEach(e=>e()),t.child&&y(t.child),t.children&&t.children.forEach(y))}function g(t,e,s,o=0){if(e==null){const r=s.el||t.childNodes[o];return y(s),void(r&&t.removeChild(r))}if(typeof e.tag=="function"){const r=!s,i=j(e);return e.child=i,g(t,i,s?s.child:void 0,o),e.el=i.el,void(r&&e.hooks&&e.hooks.mounts.length>0&&setTimeout(()=>{e.hooks.mounts.forEach(c=>c())},0))}if(s==null)return void t.appendChild(d(e,_(t)));if(typeof e!=typeof s||typeof e!="string"&&e.tag!==s.tag){const r=s.el||t.childNodes[o];return void(r&&t.replaceChild(d(e,_(t)),r))}if(typeof e=="string"||typeof e=="number"){if(e!==s){const r=t.childNodes[o];r?r.nodeValue=String(e):t.appendChild(document.createTextNode(String(e)))}return}const n=s.el||t.childNodes[o];n&&(e.el=n,S(n,e.props,s.props),M(n,e.children,s.children))}a.Cortex=class{constructor({memory:t,synapses:e}){const s={...t};this._persistenceMap=new Map;for(const[o,n]of Object.entries(t))if(n&&typeof n=="object"&&n.__humn_persist){const r=n.config?.key||o;this._persistenceMap.set(o,r);try{const i=localStorage.getItem(r);s[o]=i!==null?JSON.parse(i):n.initial}catch{s[o]=n.initial}}this._memory=s,this._listeners=new Map,this.synapses=e(o=>{let n,r=new Set;if(typeof o=="function"){const i=structuredClone(this._memory),c=o(this._createChangeTrackingProxy(i,r));c&&typeof c=="object"?(n={...this._memory,...c},Object.keys(c).forEach(l=>r.add(l))):n=i}else n={...this._memory,...o},r=new Set(Object.keys(o));this._memory=n,this._persistenceMap.size>0&&this._persistenceMap.forEach((i,c)=>{if(Array.from(r).some(l=>l===c||l.startsWith(c+".")))try{const l=this._memory[c];localStorage.setItem(i,JSON.stringify(l))}catch{}}),this._notifyRelevantListeners(r)},()=>this._memory)}_createChangeTrackingProxy(t,e,s=""){return new Proxy(t,{get:(o,n)=>{if(typeof n=="symbol"||n==="__proto__")return o[n];const r=o[n],i=s?`${s}.${n}`:n;return typeof r=="object"&&r!==null?this._createChangeTrackingProxy(r,e,i):r},set:(o,n,r)=>{if(typeof n=="symbol"||n==="__proto__")return o[n]=r,!0;const i=s?`${s}.${n}`:n;return e.add(i),o[n]=r,!0}})}_notifyRelevantListeners(t){this._listeners.forEach((e,s)=>{Array.from(e).some(o=>Array.from(t).some(n=>o===n||o.startsWith(n+".")||n.startsWith(o+".")))&&s()})}_createAccessTrackingProxy(t,e,s=""){return typeof t!="object"||t===null?t:new Proxy(t,{get:(o,n)=>{if(typeof n=="symbol"||n==="__proto__")return o[n];const r=s?`${s}.${n}`:n;e.add(r);const i=o[n];return typeof i=="object"&&i!==null?this._createAccessTrackingProxy(i,e,r):i}})}get memory(){const t=$();if(!t)return this._memory;this._listeners.has(t)||this._listeners.set(t,new Set);const e=this._listeners.get(t);return this._createAccessTrackingProxy(this._memory,e)}},a.css=function(t,...e){let s="",o=!1;Array.isArray(t)&&t.raw?s=t.reduce((c,l,u)=>c+l+(e[u]||""),""):(s=t,o=e[0]===!0);let n=(function(c){return c.replace(/\/\*[\s\S]*?\*\//g,"").replace(/\s+/g," ").trim()})(s);if(!n)return"";o&&(n=n.replace(/(^|[{};,])(\s*)(?!from|to)((?:[.#]?[\w-]+|\[[^\]]+\]|:{1,2}[^:,{\s]+)+)(?=\s*\{)/gi,"$1$2$3&, $3"));const r=(function(c){let l=5381,u=c.length;for(;u;)l=33*l^c.charCodeAt(--u);return(l>>>0).toString(36)})(n),i=`humn-${r}`;return E.has(r)||(p||(p=document.createElement("style"),p.id="humn-styles",document.head.appendChild(p)),p.textContent+=`.${i} { 
     ${n} 
   }
 `,E.add(r)),i},a.h=(t,e={},s=[])=>({tag:t,props:e,children:(Array.isArray(s)?s:[s]).flat().filter(o=>o!=null&&o!==!1&&o!=="")}),a.mount=(t,e)=>{let s=null;const o=()=>{w(o);const n={tag:e,props:{},children:[]};g(t,n,s),w(null),s=n};o()},a.onCleanup=function(t){const e=x();e&&e.cleanups.push(t)},a.onMount=function(t){const e=x();e&&e.mounts.push(t)},a.persist=(t,e={})=>({__humn_persist:!0,initial:t,config:e}),Object.defineProperty(a,Symbol.toStringTag,{value:"Module"})});

package/dist/humn.umd.js.map

@@ -1 +1 @@
-{"version":3,"file":"humn.umd.js","sources":["../src/observer.js","../src/css.js","../src/patch.js","../src/persist.js","../src/cortex.js","../src/h.js","../src/mount.js","../src/lifecycle.js"],"sourcesContent":["/**\n * @file Observer module for tracking global state during rendering.\n * @module observer\n */\n\nlet currentObserver = null // For Cortex/State dependency\nlet currentInstance = null // For Lifecycle Hooks\n\n/**\n * Gets the current observer (render function).\n * @returns {function|null}\n */\nexport const getObserver = () => currentObserver\n\n/**\n * Sets the current observer.\n * @param {function|null} obs\n */\nexport const setObserver = (obs) => {\n  currentObserver = obs\n}\n\n/**\n * Gets the current component instance (hook container).\n * @returns {object|null}\n */\nexport const getInstance = () => currentInstance\n\n/**\n * Sets the current component instance.\n * @param {object|null} inst\n */\nexport const setInstance = (inst) => {\n  currentInstance = inst\n}\n","/**\n * @file Runtime Scoped CSS implementation using Native CSS Nesting.\n * @module css\n */\n\nlet styleSheet = null\nconst cache = new Set()\n\n/**\n * Simple DJB2 hashing function.\n */\nfunction hashString(str) {\n  let hash = 5381\n  let i = str.length\n  while (i) {\n    hash = (hash * 33) ^ str.charCodeAt(--i)\n  }\n  return (hash >>> 0).toString(36)\n}\n\n/**\n * Lightweight Runtime Minifier.\n * Removes comments and collapses whitespace.\n * We do not strip spaces around colons/brackets to ensure safety for calc().\n */\nfunction minify(css) {\n  return css\n    .replace(/\\/\\*[\\s\\S]*?\\*\\//g, '') // Remove comments\n    .replace(/\\s+/g, ' ') // Collapse newlines/tabs to single space\n    .trim() // Remove leading/trailing\n}\n\n/**\n * Scoped CSS Tag.\n * Wraps content in a unique class using Native CSS Nesting.\n * Supports two signatures:\n * 1. Tagged Template: css`...`\n * 2. Function: css(string, isSingleRoot)\n */\nexport function css(stringsOrStr, ...args) {\n  let raw = ''\n  let isSingleRoot = false\n\n  // Detect usage of Tagged Template vs Function Call\n  if (Array.isArray(stringsOrStr) && stringsOrStr.raw) {\n    raw = stringsOrStr.reduce((acc, str, i) => {\n      return acc + str + (args[i] || '')\n    }, '')\n  } else {\n    raw = stringsOrStr\n    // If called as function, the first arg is our boolean flag\n    isSingleRoot = args[0] === true\n  }\n  let content = minify(raw)\n\n  if (!content) return ''\n\n  if (isSingleRoot) {\n    // Transforms selectors to apply to BOTH the root (using &) AND descendants.\n    // e.g. \"div\" -> \"div&, div\"\n\n    // Regex Breakdown:\n    // 1. (^|[{};,])      -> Hard Start (Line start, brace, semi, comma)\n    // 2. (\\s*)           -> Whitespace\n    // 3. (?!from|to)     -> Negative Lookahead: Ignore 'from'/'to' (keyframes)\n    // 4. ( ... )+        -> Compound Selector:\n    //    (?:[.#]?[\\w-]+ ... ) -> Matches tags (div), classes (.class), ids (#id)\n    // 5. (?=\\s*\\{)       -> Lookahead: Must be followed by {\n\n    content = content.replace(\n      /(^|[{};,])(\\s*)(?!from|to)((?:[.#]?[\\w-]+|\\[[^\\]]+\\]|:{1,2}[^:,{\\s]+)+)(?=\\s*\\{)/gi,\n      '$1$2$3&, $3',\n    )\n  }\n\n  const hash = hashString(content)\n  const hashedClassName = `humn-${hash}`\n\n  if (cache.has(hash)) {\n    return hashedClassName\n  }\n\n  if (!styleSheet) {\n    styleSheet = document.createElement('style')\n    styleSheet.id = 'humn-styles'\n    document.head.appendChild(styleSheet)\n  }\n\n  styleSheet.textContent += `.${hashedClassName} { \n    ${content} \n  }\\n`\n  cache.add(hash)\n\n  return hashedClassName\n}\n","/**\n * @file This file contains the diffing and patching algorithm for the virtual DOM,\n * including support for Keyed Diffing.\n * @module patch\n */\nimport { track } from './metrics.js'\nimport { setInstance } from './observer.js'\n\nfunction getNamespace(parent) {\n  if (parent.namespaceURI === SVG_NS && parent.tagName !== 'foreignObject') {\n    return SVG_NS\n  }\n  if (parent.namespaceURI === MATH_NS) {\n    return MATH_NS\n  }\n  return null\n}\n\n/**\n * Checks if a list of children contains keys.\n * @param {Array<import(\"./h.js\").VNode>} children - The list of VNodes.\n * @returns {boolean} True if keys are present.\n */\nexport function hasKeys(children) {\n  return children && children.some((c) => c && c.props && c.props.key != null)\n}\n\nconst SVG_NS = 'http://www.w3.org/2000/svg'\nconst MATH_NS = 'http://www.w3.org/1998/Math/MathML'\n/**\n * Creates a real DOM element from a virtual node.\n * @param {import(\"./h.js\").VNode | string | number} vNode\n * @param {string} [namespace] - The current namespace URI (if any).\n * @returns {Text | HTMLElement | SVGElement}\n */\nfunction createElement(vNode, namespace) {\n  if (typeof vNode === 'string' || typeof vNode === 'number') {\n    return document.createTextNode(String(vNode))\n  }\n\n  if (typeof vNode.tag === 'function') {\n    const childVNode = renderComponent(vNode)\n    vNode.child = childVNode\n\n    const el = createElement(childVNode, namespace)\n\n    vNode.el = el\n    if (vNode.hooks?.mounts.length > 0) {\n      setTimeout(() => vNode.hooks.mounts.forEach((fn) => fn()), 0)\n    }\n    return el\n  }\n\n  track('elementsCreated')\n\n  const tag = vNode.tag\n\n  // We prioritize specific tag declarations over the inherited namespace.\n  if (tag === 'svg') namespace = SVG_NS\n  else if (tag === 'math') namespace = MATH_NS\n  // NOTE: If we are inside 'foreignObject', we must NOT use the SVG NS.\n  // We handle this by resetting 'ns' in the recursion step below,\n  // so 'ns' entering here is already null for the foreignObject's children.\n\n  // createElementNS is slower than createElement, so only use it if we have a namespace.\n  const element = namespace\n    ? document.createElementNS(namespace, tag)\n    : document.createElement(tag)\n\n  vNode.el = element\n  patchProps(element, vNode.props)\n\n  // If we are currently at a 'foreignObject', children must exit the SVG namespace.\n  const childNS = tag === 'foreignObject' ? null : namespace\n\n  vNode.children.forEach((child) => {\n    element.appendChild(createElement(child, childNS))\n  })\n\n  return element\n}\n\n/**\n * Updates the properties (attributes/events) of a DOM element.\n * @param {HTMLElement} element - The DOM element to update.\n * @param {object} [newProps={}] - The new properties.\n * @param {object} [oldProps={}] - The old properties.\n *\n * WHY: We check against the LIVE DOM value for inputs (value/checked) to prevent\n * the \"cursor jumping\" bug. If we just blindly set the attribute, the browser\n * might reset the cursor position to the end of the input.\n */\nfunction patchProps(element, newProps = {}, oldProps = {}) {\n  if (!element) return\n\n  const allProps = { ...oldProps, ...newProps }\n\n  for (const key in allProps) {\n    const oldValue = oldProps[key]\n    const newValue = newProps[key]\n\n    // Handle removed props\n    if (newValue === undefined || newValue === null) {\n      element.removeAttribute(key)\n      track('patches')\n      continue\n    }\n\n    // We check against the LIVE DOM value to prevent cursor jumping\n    if (key === 'value' || key === 'checked') {\n      if (element[key] !== newValue) {\n        element[key] = newValue\n        track('patches')\n      }\n      continue\n    }\n\n    // If prop hasn't changed, skip\n    if (oldValue === newValue) continue\n\n    track('patches')\n\n    // Handle Events\n    if (key.startsWith('on')) {\n      const eventName = key.slice(2).toLowerCase()\n      if (oldValue) element.removeEventListener(eventName, oldValue)\n      element.addEventListener(eventName, newValue)\n    }\n    // Handle the disabled attribute\n    if (key === 'disabled') {\n      element.disabled = newValue === true || newValue === 'true'\n    }\n    // Handle standard attributes\n    else {\n      element.setAttribute(key, newValue)\n    }\n  }\n}\n\n/**\n * Reconciles the children of a node, handling both simple lists and keyed reordering.\n * @param {HTMLElement} parent - The parent DOM element.\n * @param {Array<import(\"./h.js\").VNode>} newChildren - The new list of children.\n * @param {Array<import(\"./h.js\").VNode>} oldChildren - The old list of children.\n *\n * WHY: This is the most complex part of the VDOM. We need to efficiently update\n * a list of items. Without keys, we just update index-by-index, which is fast\n * but causes issues if items are reordered (state gets mixed up).\n * With keys, we can track items as they move around, preserving their state\n * and minimizing DOM operations.\n */\nfunction reconcileChildren(parent, newChildren, oldChildren) {\n  const isKeyed = hasKeys(newChildren) || hasKeys(oldChildren)\n\n  // If no keys are used, use the fast index-based simple loop.\n  // This is faster for static lists or simple text replacements.\n  if (!isKeyed) {\n    const maxLen = Math.max(newChildren.length, oldChildren.length)\n    for (let i = 0; i < maxLen; i++) {\n      patch(parent, newChildren[i], oldChildren[i], i)\n    }\n    return\n  }\n\n  reconcileKeyedChildren(parent, newChildren, oldChildren)\n}\n\n/**\n * Handles the complex logic of reconciling keyed children.\n *\n * WHY: When keys are present, we can't just iterate by index. We need to map\n * existing children by their key so we can find them even if they've moved.\n * This allows us to re-use DOM nodes (preserving focus/state) instead of\n * destroying and re-creating them.\n */\nfunction reconcileKeyedChildren(parent, newChildren, oldChildren) {\n  // Map existing children by Key for O(1) lookup\n  const keyed = {}\n  oldChildren.forEach((child, i) => {\n    const key = (child.props && child.props.key) != null ? child.props.key : i\n    keyed[key] = { vNode: child, index: i }\n  })\n\n  newChildren.forEach((newChild, i) => {\n    const key =\n      (newChild.props && newChild.props.key) != null ? newChild.props.key : i\n    const existingChildMatch = keyed[key]\n\n    if (existingChildMatch) {\n      // A. MATCH FOUND - The item existed before\n      const oldVNode = existingChildMatch.vNode\n\n      // Update the node's content recursively\n      patch(parent, newChild, oldVNode, i)\n\n      // If the DOM node isn't in the right spot, move it.\n      // We use oldVNode.el because patch transfers the ref, but just to be safe:\n      const element = newChild.el || oldVNode.el\n\n      // Get the node currently at this index in the real DOM\n      const domChildAtIndex = parent.childNodes[i]\n\n      // If the element exists but is in the wrong place, move it\n      if (element && domChildAtIndex !== element) {\n        parent.insertBefore(element, domChildAtIndex)\n        track('patches')\n      }\n\n      // Remove from map so we know it was re-used\n      delete keyed[key]\n    } else {\n      // B. NO MATCH - This is a new item\n      const newElement = createElement(newChild, getNamespace(parent))\n      const domChildAtIndex = parent.childNodes[i]\n\n      if (domChildAtIndex) {\n        parent.insertBefore(newElement, domChildAtIndex)\n      } else {\n        parent.appendChild(newElement)\n      }\n    }\n  })\n\n  // Remove any old keys that weren't used in the new list\n  Object.values(keyed).forEach(({ vNode }) => {\n    if (vNode.el && vNode.el.parentNode === parent) {\n      runUnmount(vNode) // Clean up hooks\n      parent.removeChild(vNode.el)\n      track('elementsRemoved')\n    }\n  })\n}\n\n/**\n * Executes a Functional Component, tracks hooks, and returns the VNode.\n * @param {import(\"./h.js\").VNode} vNode - The component vNode.\n * @returns {import(\"./h.js\").VNode} The rendered child vNode.\n */\nfunction renderComponent(vNode) {\n  track('componentsRendered')\n\n  // 1. Prepare Hook Container\n  const hooks = {\n    mounts: [],\n    cleanups: [],\n  }\n\n  // 2. Set Global Scope\n  setInstance(hooks)\n\n  // 3. Run the User's Component Function\n  // We pass props as the first argument\n  const renderedVNode = vNode.tag(vNode.props)\n\n  // 4. Clear Global Scope\n  setInstance(null)\n\n  // 5. Attach hooks to the VNode so we can run them later\n  vNode.hooks = hooks\n\n  return renderedVNode\n}\n\n/**\n * Helper to recursively run cleanup hooks when a tree is removed.\n * @param {import(\"./h.js\").VNode} vNode - The vNode to unmount.\n */\nfunction runUnmount(vNode) {\n  if (!vNode) return\n\n  // 1. Run hooks for this node\n  if (vNode.hooks && vNode.hooks.cleanups) {\n    vNode.hooks.cleanups.forEach((fn) => fn())\n  }\n\n  // 2. Recurse into child (if component)\n  if (vNode.child) {\n    runUnmount(vNode.child)\n  }\n\n  // 3. Recurse into children (if element)\n  if (vNode.children) {\n    vNode.children.forEach(runUnmount)\n  }\n}\n\n/**\n * The main diffing function. Compares V-DOM trees and updates the real DOM.\n * @param {HTMLElement} parent - The parent DOM element.\n * @param {import(\"./h.js\").VNode | string | number} newVNode - The new virtual node.\n * @param {import(\"./h.js\").VNode | string | number} oldVNode - The old virtual node.\n * @param {number} [index=0] - The index of the child node (used for simple diffing).\n */\nexport function patch(parent, newVNode, oldVNode, index = 0) {\n  track('diffs')\n\n  // Case 1: Removal - The new node is null/undefined, so we remove the old one.\n  if (newVNode === undefined || newVNode === null) {\n    const el = oldVNode.el || parent.childNodes[index]\n\n    // Recursive Cleanup\n    runUnmount(oldVNode)\n\n    if (el) {\n      parent.removeChild(el)\n      track('elementsRemoved')\n    }\n    return\n  }\n\n  // Case 2: Component - If it's a function, we delegate to the component logic.\n  if (typeof newVNode.tag === 'function') {\n    const isNew = !oldVNode\n\n    const childVNode = renderComponent(newVNode)\n    newVNode.child = childVNode\n\n    const oldChild = oldVNode ? oldVNode.child : undefined\n    patch(parent, childVNode, oldChild, index)\n\n    newVNode.el = childVNode.el\n\n    // Run mount hooks on the next tick\n    if (isNew && newVNode.hooks && newVNode.hooks.mounts.length > 0) {\n      setTimeout(() => {\n        newVNode.hooks.mounts.forEach((fn) => fn())\n      }, 0)\n    }\n    // TODO: Handle updates (running old cleanups if necessary) for Phase 2\n    return\n  }\n\n  // Case 3: Creation - No old node exists, so we create a new one.\n  if (oldVNode === undefined || oldVNode === null) {\n    parent.appendChild(createElement(newVNode, getNamespace(parent)))\n    return\n  }\n\n  // Case 4: Replacement - The node type changed (e.g. div -> span), so we replace it entirely.\n  if (\n    typeof newVNode !== typeof oldVNode ||\n    (typeof newVNode !== 'string' && newVNode.tag !== oldVNode.tag)\n  ) {\n    const el = oldVNode.el || parent.childNodes[index]\n    if (el) {\n      parent.replaceChild(createElement(newVNode, getNamespace(parent)), el)\n      track('patches')\n    }\n    return\n  }\n\n  // Case 5: Text Update - It's a text node, so we just update the text content.\n  if (typeof newVNode === 'string' || typeof newVNode === 'number') {\n    if (newVNode !== oldVNode) {\n      const el = parent.childNodes[index]\n      if (el) {\n        el.nodeValue = String(newVNode)\n        track('patches')\n      } else {\n        // Self healing: if text node missing, append it\n        parent.appendChild(document.createTextNode(String(newVNode)))\n      }\n    }\n    return\n  }\n\n  // Case 6: Update - Same tag, so we update props and recurse into children.\n  const el = oldVNode.el || parent.childNodes[index]\n\n  if (!el) return\n\n  // Transfer DOM reference to the new VNode\n  newVNode.el = el\n\n  patchProps(el, newVNode.props, oldVNode.props)\n\n  reconcileChildren(el, newVNode.children, oldVNode.children)\n}\n","/**\n * @typedef {object} HumnPersist\n * @property {boolean} __humn_persist\n * @property {any} initial\n * @property {PersistConfig} config\n */\n\n/**\n * @typedef {object} PersistConfig\n * @property {string} key\n */\n\n/**\n * Marks a section of the state for persistence in localStorage.\n *\n * @param {any} initial - The initial value of the state.\n * @param {PersistConfig} config - The configuration for persistence.\n * @returns {HumnPersist}\n */\nexport const persist = (initial, config = {}) => ({\n  __humn_persist: true,\n  initial,\n  config,\n})\n","import { isDev } from './metrics.js'\nimport { getObserver } from './observer.js'\n\n/**\n * @typedef {object} Synapses\n * @property {function} set - Function to update the memory\n * @property {function} get - Function to get the memory\n */\n\n/**\n * @typedef {object} CortexParams\n * @property {object} memory - The initial state\n * @property {function(function, function): object} synapses - The synapses function\n */\n\n/**\n * The Cortex class manages the state of the application.\n * This uses a Proxy for fine-grained reactivity, ensuring only those components\n * which use the updated value get re-rendered.\n *\n * WHY: We use Proxies instead of simple getters/setters because it allows us to\n * detect access to nested properties dynamically without needing to declare\n * dependencies upfront. This \"magic\" auto-subscription is what makes Humn's\n * DX so clean.\n */\nexport class Cortex {\n  /**\n   * Creates an instance of Cortex.\n   * @param {CortexParams} CortexParams - The parameters for the Cortex.\n   */\n  constructor({ memory, synapses }) {\n    const liveMemory = { ...memory }\n    this._persistenceMap = new Map()\n\n    // Load in any existing values from local-storage\n    for (const [key, value] of Object.entries(memory)) {\n      if (value && value.__humn_persist) {\n        const storageKey = value.config.key || key\n        this._persistenceMap.set(key, storageKey)\n\n        try {\n          const stored = localStorage.getItem(storageKey)\n          if (stored !== null) {\n            liveMemory[key] = JSON.parse(stored)\n          } else {\n            liveMemory[key] = value.initial\n          }\n        } catch (err) {\n          if (isDev)\n            console.warn(`Humn: Failed to load '${key}' from storage.`, err)\n          liveMemory[key] = value.initial\n        }\n      }\n    }\n\n    this._memory = liveMemory\n    this._listeners = new Map()\n\n    const get = () => this._memory\n\n    const set = (updater) => {\n      let nextState\n      let changedPaths = new Set()\n\n      if (typeof updater === 'function') {\n        const clone = structuredClone(this._memory)\n        const proxy = this._createChangeTrackingProxy(clone, changedPaths)\n        const result = updater(proxy)\n\n        if (result && typeof result === 'object') {\n          nextState = { ...this._memory, ...result }\n          Object.keys(result).forEach((key) => changedPaths.add(key))\n        } else {\n          nextState = clone\n        }\n      } else {\n        nextState = { ...this._memory, ...updater }\n        changedPaths = new Set(Object.keys(updater))\n      }\n\n      this._memory = nextState\n\n      // If we need to persist any of the values\n      // we save them to localStorage here\n      if (this._persistenceMap.size > 0) {\n        this._persistenceMap.forEach((storageKey, stateKey) => {\n          const isDirty = Array.from(changedPaths).some(\n            (path) => path === stateKey || path.startsWith(stateKey + '.'),\n          )\n\n          if (isDirty) {\n            try {\n              const value = this._memory[stateKey]\n              localStorage.setItem(storageKey, JSON.stringify(value))\n            } catch (err) {\n              if (isDev)\n                console.error(`Humn: Failed to save '${stateKey}'.`, err)\n            }\n          }\n        })\n      }\n\n      this._notifyRelevantListeners(changedPaths)\n    }\n\n    this.synapses = synapses(set, get)\n  }\n\n  /**\n   * Creates a Proxy that tracks which properties are being mutated.\n   * Includes a GET trap to recursively proxy nested objects for deep mutation tracking.\n   *\n   * WHY: We need to know exactly which paths were changed so we can notify ONLY\n   * the components that care about those specific paths. If we just knew \"something changed\",\n   * we'd have to re-render the whole app (like Redux) or rely on manual optimization.\n   */\n  _createChangeTrackingProxy(obj, changedPaths, path = '') {\n    return new Proxy(obj, {\n      get: (target, prop) => {\n        if (typeof prop === 'symbol' || prop === '__proto__')\n          return target[prop]\n\n        const value = target[prop]\n        const fullPath = path ? `${path}.${prop}` : prop\n\n        // Recursively proxy nested objects so we can trap their sets too\n        if (typeof value === 'object' && value !== null) {\n          return this._createChangeTrackingProxy(value, changedPaths, fullPath)\n        }\n        return value\n      },\n      set: (target, prop, value) => {\n        if (typeof prop === 'symbol' || prop === '__proto__') {\n          target[prop] = value\n          return true\n        }\n\n        const fullPath = path ? `${path}.${prop}` : prop\n        changedPaths.add(fullPath)\n\n        target[prop] = value\n        return true\n      },\n    })\n  }\n\n  /**\n   * Only notify listeners that read properties which changed\n   */\n  _notifyRelevantListeners(changedPaths) {\n    this._listeners.forEach((accessedPaths, renderFn) => {\n      const shouldNotify = Array.from(accessedPaths).some((accessedPath) => {\n        return Array.from(changedPaths).some((changedPath) => {\n          // Check for exact match or parent/child relationship\n          return (\n            accessedPath === changedPath ||\n            accessedPath.startsWith(changedPath + '.') ||\n            changedPath.startsWith(accessedPath + '.')\n          )\n        })\n      })\n\n      if (shouldNotify) renderFn()\n    })\n  }\n\n  /**\n   * Creates a Proxy that tracks which properties are accessed during render\n   *\n   * WHY: This is the other half of the magic. By tracking what a component READS\n   * during its render, we build a precise dependency graph. If a component reads\n   * `state.user.name`, it will only re-render when `state.user.name` changes,\n   * not when `state.count` changes.\n   */\n  _createAccessTrackingProxy(obj, accessedPaths, path = '') {\n    if (typeof obj !== 'object' || obj === null) return obj\n\n    return new Proxy(obj, {\n      get: (target, prop) => {\n        // We don't care about prototype and symbol properties\n        if (typeof prop === 'symbol' || prop === '__proto__')\n          return target[prop]\n\n        const fullPath = path ? `${path}.${prop}` : prop\n        accessedPaths.add(fullPath)\n\n        const value = target[prop]\n\n        // Recursively wrap nested objects\n        if (typeof value === 'object' && value !== null)\n          return this._createAccessTrackingProxy(value, accessedPaths, fullPath)\n\n        return value\n      },\n    })\n  }\n\n  /**\n   * Returns memory wrapped in a tracking Proxy\n   */\n  get memory() {\n    const currentObserver = getObserver()\n\n    if (!currentObserver) return this._memory\n\n    if (!this._listeners.has(currentObserver))\n      this._listeners.set(currentObserver, new Set())\n\n    const accessedPaths = this._listeners.get(currentObserver)\n\n    return this._createAccessTrackingProxy(this._memory, accessedPaths)\n  }\n}\n","/**\n * @typedef {object} VNode\n * @property {string} tag\n * @property {object} props\n * @property {VNode[]} children\n */\n\n/**\n * Creates a virtual DOM node.\n * This is a hyperscript-like function.\n *\n * @param {string} tag - The tag name of the element.\n * @param {object} props - The properties of the element.\n * @param {VNode[]|VNode} children - The children of the element.\n * @returns {VNode} The virtual DOM node.\n */\nexport const h = (tag, props = {}, children = []) => {\n  const childArray = Array.isArray(children) ? children : [children]\n\n  // Filter out null/false so we don't have \"ghost\" nodes\n  const cleanChildren = childArray\n    .flat()\n    .filter((c) => c !== null && c !== undefined && c !== false && c !== '')\n\n  return {\n    tag,\n    props,\n    children: cleanChildren,\n  }\n}\n","/**\n * @file Mounts the application to the DOM.\n * @module mount\n */\nimport { setObserver } from './observer.js'\nimport { patch } from './patch.js'\n\n/**\n * Mounts a component to a target DOM element.\n * @param {HTMLElement} target - The DOM element to mount to.\n * @param {function} Component - The root component function.\n */\nexport const mount = (target, Component) => {\n  let prevVNode = null\n\n  const lifecycle = () => {\n    setObserver(lifecycle)\n\n    const nextVNode = {\n      tag: Component,\n      props: {},\n      children: [],\n    }\n\n    patch(target, nextVNode, prevVNode)\n    setObserver(null)\n    prevVNode = nextVNode\n  }\n\n  lifecycle()\n}\n","/**\n * @file Lifecycle hooks for components.\n * @module lifecycle\n */\nimport { getInstance } from './observer.js'\n\n/**\n * Registers a callback to run after the component mounts.\n * @param {function} fn - The callback function.\n */\nexport function onMount(fn) {\n  const instance = getInstance()\n  if (instance) {\n    instance.mounts.push(fn)\n  }\n}\n\n/**\n * Registers a callback to run when the component unmounts.\n * @param {function} fn - The callback function.\n */\nexport function onCleanup(fn) {\n  const instance = getInstance()\n  if (instance) {\n    instance.cleanups.push(fn)\n  }\n}\n"],"names":["g","f","exports","module","define","amd","globalThis","self","Humn","this","currentObserver","currentInstance","getObserver","setObserver","obs","getInstance","setInstance","inst","styleSheet","cache","Set","getNamespace","parent","namespaceURI","SVG_NS","tagName","MATH_NS","hasKeys","children","some","c","props","key","createElement","vNode","namespace","document","createTextNode","String","tag","childVNode","renderComponent","child","el","hooks","mounts","length","setTimeout","forEach","fn","element","createElementNS","patchProps","childNS","appendChild","newProps","oldProps","allProps","oldValue","newValue","startsWith","eventName","slice","toLowerCase","removeEventListener","addEventListener","disabled","setAttribute","removeAttribute","reconcileChildren","newChildren","oldChildren","maxLen","Math","max","i","patch","keyed","index","newChild","existingChildMatch","oldVNode","domChildAtIndex","childNodes","insertBefore","newElement","Object","values","parentNode","runUnmount","removeChild","cleanups","renderedVNode","newVNode","isNew","replaceChild","nodeValue","Cortex","constructor","memory","synapses","liveMemory","_persistenceMap","Map","value","entries","__humn_persist","storageKey","config","set","stored","localStorage","getItem","JSON","parse","initial","err","_memory","_listeners","updater","nextState","changedPaths","clone","structuredClone","result","_createChangeTrackingProxy","keys","add","size","stateKey","Array","from","path","setItem","stringify","_notifyRelevantListeners","obj","Proxy","get","target","prop","fullPath","accessedPaths","renderFn","accessedPath","changedPath","_createAccessTrackingProxy","has","css","stringsOrStr","args","raw","isSingleRoot","isArray","reduce","acc","str","content","replace","trim","hash","charCodeAt","toString","hashedClassName","id","head","textContent","h","flat","filter","mount","Component","prevVNode","lifecycle","nextVNode","onCleanup","instance","push","onMount","persist","defineProperty","Symbol","toStringTag"],"mappings":"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"}
+{"version":3,"file":"humn.umd.js","sources":["../src/observer.js","../src/css.js","../src/patch.js","../src/persist.js","../src/cortex.js","../src/h.js","../src/mount.js","../src/lifecycle.js"],"sourcesContent":["/**\n * @file Observer module for tracking global state during rendering.\n * @module observer\n */\n\nlet currentObserver = null // For Cortex/State dependency\nlet currentInstance = null // For Lifecycle Hooks\n\n/**\n * Gets the current observer (render function).\n * @returns {function|null}\n */\nexport const getObserver = () => currentObserver\n\n/**\n * Sets the current observer.\n * @param {function|null} obs\n */\nexport const setObserver = (obs) => {\n  currentObserver = obs\n}\n\n/**\n * Gets the current component instance (hook container).\n * @returns {object|null}\n */\nexport const getInstance = () => currentInstance\n\n/**\n * Sets the current component instance.\n * @param {object|null} inst\n */\nexport const setInstance = (inst) => {\n  currentInstance = inst\n}\n","/**\n * @file Runtime Scoped CSS implementation using Native CSS Nesting.\n * @module css\n */\n\nlet styleSheet = null\nconst cache = new Set()\n\n/**\n * Simple DJB2 hashing function.\n */\nfunction hashString(str) {\n  let hash = 5381\n  let i = str.length\n  while (i) {\n    hash = (hash * 33) ^ str.charCodeAt(--i)\n  }\n  return (hash >>> 0).toString(36)\n}\n\n/**\n * Lightweight Runtime Minifier.\n * Removes comments and collapses whitespace.\n * We do not strip spaces around colons/brackets to ensure safety for calc().\n */\nfunction minify(css) {\n  return css\n    .replace(/\\/\\*[\\s\\S]*?\\*\\//g, '') // Remove comments\n    .replace(/\\s+/g, ' ') // Collapse newlines/tabs to single space\n    .trim() // Remove leading/trailing\n}\n\n/**\n * Scoped CSS Tag.\n * Wraps content in a unique class using Native CSS Nesting.\n * Supports two signatures:\n * 1. Tagged Template: css`...`\n * 2. Function: css(string, isSingleRoot)\n */\nexport function css(stringsOrStr, ...args) {\n  let raw = ''\n  let isSingleRoot = false\n\n  // Detect usage of Tagged Template vs Function Call\n  if (Array.isArray(stringsOrStr) && stringsOrStr.raw) {\n    raw = stringsOrStr.reduce((acc, str, i) => {\n      return acc + str + (args[i] || '')\n    }, '')\n  } else {\n    raw = stringsOrStr\n    // If called as function, the first arg is our boolean flag\n    isSingleRoot = args[0] === true\n  }\n  let content = minify(raw)\n\n  if (!content) return ''\n\n  if (isSingleRoot) {\n    // Transforms selectors to apply to BOTH the root (using &) AND descendants.\n    // e.g. \"div\" -> \"div&, div\"\n\n    // Regex Breakdown:\n    // 1. (^|[{};,])      -> Hard Start (Line start, brace, semi, comma)\n    // 2. (\\s*)           -> Whitespace\n    // 3. (?!from|to)     -> Negative Lookahead: Ignore 'from'/'to' (keyframes)\n    // 4. ( ... )+        -> Compound Selector:\n    //    (?:[.#]?[\\w-]+ ... ) -> Matches tags (div), classes (.class), ids (#id)\n    // 5. (?=\\s*\\{)       -> Lookahead: Must be followed by {\n\n    content = content.replace(\n      /(^|[{};,])(\\s*)(?!from|to)((?:[.#]?[\\w-]+|\\[[^\\]]+\\]|:{1,2}[^:,{\\s]+)+)(?=\\s*\\{)/gi,\n      '$1$2$3&, $3',\n    )\n  }\n\n  const hash = hashString(content)\n  const hashedClassName = `humn-${hash}`\n\n  if (cache.has(hash)) {\n    return hashedClassName\n  }\n\n  if (!styleSheet) {\n    styleSheet = document.createElement('style')\n    styleSheet.id = 'humn-styles'\n    document.head.appendChild(styleSheet)\n  }\n\n  styleSheet.textContent += `.${hashedClassName} { \n    ${content} \n  }\\n`\n  cache.add(hash)\n\n  return hashedClassName\n}\n","/**\n * @file This file contains the diffing and patching algorithm for the virtual DOM,\n * including support for Keyed Diffing.\n * @module patch\n */\nimport { track } from './metrics.js'\nimport { setInstance } from './observer.js'\n\nfunction getNamespace(parent) {\n  if (parent.namespaceURI === SVG_NS && parent.tagName !== 'foreignObject') {\n    return SVG_NS\n  }\n  if (parent.namespaceURI === MATH_NS) {\n    return MATH_NS\n  }\n  return null\n}\n\n/**\n * Checks if a list of children contains keys.\n * @param {Array<import(\"./h.js\").VNode>} children - The list of VNodes.\n * @returns {boolean} True if keys are present.\n */\nexport function hasKeys(children) {\n  return children && children.some((c) => c && c.props && c.props.key != null)\n}\n\nconst SVG_NS = 'http://www.w3.org/2000/svg'\nconst MATH_NS = 'http://www.w3.org/1998/Math/MathML'\n/**\n * Creates a real DOM element from a virtual node.\n * @param {import(\"./h.js\").VNode | string | number} vNode\n * @param {string} [namespace] - The current namespace URI (if any).\n * @returns {Text | HTMLElement | SVGElement}\n */\nfunction createElement(vNode, namespace) {\n  if (typeof vNode === 'string' || typeof vNode === 'number') {\n    return document.createTextNode(String(vNode))\n  }\n\n  if (typeof vNode.tag === 'function') {\n    const childVNode = renderComponent(vNode)\n    vNode.child = childVNode\n\n    const el = createElement(childVNode, namespace)\n\n    vNode.el = el\n    if (vNode.hooks?.mounts.length > 0) {\n      setTimeout(() => vNode.hooks.mounts.forEach((fn) => fn()), 0)\n    }\n    return el\n  }\n\n  track('elementsCreated')\n\n  const tag = vNode.tag\n\n  // We prioritize specific tag declarations over the inherited namespace.\n  if (tag === 'svg') namespace = SVG_NS\n  else if (tag === 'math') namespace = MATH_NS\n  // NOTE: If we are inside 'foreignObject', we must NOT use the SVG NS.\n  // We handle this by resetting 'ns' in the recursion step below,\n  // so 'ns' entering here is already null for the foreignObject's children.\n\n  // createElementNS is slower than createElement, so only use it if we have a namespace.\n  const element = namespace\n    ? document.createElementNS(namespace, tag)\n    : document.createElement(tag)\n\n  vNode.el = element\n  patchProps(element, vNode.props)\n\n  // If we are currently at a 'foreignObject', children must exit the SVG namespace.\n  const childNS = tag === 'foreignObject' ? null : namespace\n\n  vNode.children.forEach((child) => {\n    element.appendChild(createElement(child, childNS))\n  })\n\n  return element\n}\n\n/**\n * Updates the properties (attributes/events) of a DOM element.\n * @param {HTMLElement} element - The DOM element to update.\n * @param {object} [newProps={}] - The new properties.\n * @param {object} [oldProps={}] - The old properties.\n *\n * WHY: We check against the LIVE DOM value for inputs (value/checked) to prevent\n * the \"cursor jumping\" bug. If we just blindly set the attribute, the browser\n * might reset the cursor position to the end of the input.\n */\nfunction patchProps(element, newProps = {}, oldProps = {}) {\n  if (!element) return\n\n  const allProps = { ...oldProps, ...newProps }\n\n  for (const key in allProps) {\n    const oldValue = oldProps[key]\n    const newValue = newProps[key]\n\n    // Handle removed props\n    if (newValue === undefined || newValue === null) {\n      element.removeAttribute(key)\n      track('patches')\n      continue\n    }\n\n    // We check against the LIVE DOM value to prevent cursor jumping\n    if (key === 'value' || key === 'checked') {\n      if (element[key] !== newValue) {\n        element[key] = newValue\n        track('patches')\n      }\n      continue\n    }\n\n    // If prop hasn't changed, skip\n    if (oldValue === newValue) continue\n\n    track('patches')\n\n    // Handle Events\n    if (key.startsWith('on')) {\n      const eventName = key.slice(2).toLowerCase()\n      if (oldValue) element.removeEventListener(eventName, oldValue)\n      element.addEventListener(eventName, newValue)\n    }\n    // Handle the disabled attribute\n    if (key === 'disabled') {\n      element.disabled = newValue === true || newValue === 'true'\n    }\n    // Handle standard attributes\n    else {\n      element.setAttribute(key, newValue)\n    }\n  }\n}\n\n/**\n * Reconciles the children of a node, handling both simple lists and keyed reordering.\n * @param {HTMLElement} parent - The parent DOM element.\n * @param {Array<import(\"./h.js\").VNode>} newChildren - The new list of children.\n * @param {Array<import(\"./h.js\").VNode>} oldChildren - The old list of children.\n *\n * WHY: This is the most complex part of the VDOM. We need to efficiently update\n * a list of items. Without keys, we just update index-by-index, which is fast\n * but causes issues if items are reordered (state gets mixed up).\n * With keys, we can track items as they move around, preserving their state\n * and minimizing DOM operations.\n */\nfunction reconcileChildren(parent, newChildren, oldChildren) {\n  const isKeyed = hasKeys(newChildren) || hasKeys(oldChildren)\n\n  // If no keys are used, use the fast index-based simple loop.\n  // This is faster for static lists or simple text replacements.\n  if (!isKeyed) {\n    const maxLen = Math.max(newChildren.length, oldChildren.length)\n    for (let i = 0; i < maxLen; i++) {\n      patch(parent, newChildren[i], oldChildren[i], i)\n    }\n    return\n  }\n\n  reconcileKeyedChildren(parent, newChildren, oldChildren)\n}\n\n/**\n * Handles the complex logic of reconciling keyed children.\n *\n * WHY: When keys are present, we can't just iterate by index. We need to map\n * existing children by their key so we can find them even if they've moved.\n * This allows us to re-use DOM nodes (preserving focus/state) instead of\n * destroying and re-creating them.\n */\nfunction reconcileKeyedChildren(parent, newChildren, oldChildren) {\n  // Map existing children by Key for O(1) lookup\n  const keyed = {}\n  oldChildren.forEach((child, i) => {\n    const key = (child.props && child.props.key) != null ? child.props.key : i\n    keyed[key] = { vNode: child, index: i }\n  })\n\n  newChildren.forEach((newChild, i) => {\n    const key =\n      (newChild.props && newChild.props.key) != null ? newChild.props.key : i\n    const existingChildMatch = keyed[key]\n\n    if (existingChildMatch) {\n      // A. MATCH FOUND - The item existed before\n      const oldVNode = existingChildMatch.vNode\n\n      // Update the node's content recursively\n      patch(parent, newChild, oldVNode, i)\n\n      // If the DOM node isn't in the right spot, move it.\n      // We use oldVNode.el because patch transfers the ref, but just to be safe:\n      const element = newChild.el || oldVNode.el\n\n      // Get the node currently at this index in the real DOM\n      const domChildAtIndex = parent.childNodes[i]\n\n      // If the element exists but is in the wrong place, move it\n      if (element && domChildAtIndex !== element) {\n        parent.insertBefore(element, domChildAtIndex)\n        track('patches')\n      }\n\n      // Remove from map so we know it was re-used\n      delete keyed[key]\n    } else {\n      // B. NO MATCH - This is a new item\n      const newElement = createElement(newChild, getNamespace(parent))\n      const domChildAtIndex = parent.childNodes[i]\n\n      if (domChildAtIndex) {\n        parent.insertBefore(newElement, domChildAtIndex)\n      } else {\n        parent.appendChild(newElement)\n      }\n    }\n  })\n\n  // Remove any old keys that weren't used in the new list\n  Object.values(keyed).forEach(({ vNode }) => {\n    if (vNode.el && vNode.el.parentNode === parent) {\n      runUnmount(vNode) // Clean up hooks\n      parent.removeChild(vNode.el)\n      track('elementsRemoved')\n    }\n  })\n}\n\n/**\n * Executes a Functional Component, tracks hooks, and returns the VNode.\n * @param {import(\"./h.js\").VNode} vNode - The component vNode.\n * @returns {import(\"./h.js\").VNode} The rendered child vNode.\n */\nfunction renderComponent(vNode) {\n  track('componentsRendered')\n\n  // 1. Prepare Hook Container\n  const hooks = {\n    mounts: [],\n    cleanups: [],\n  }\n\n  // 2. Set Global Scope\n  setInstance(hooks)\n\n  // 3. Run the User's Component Function\n  // We pass props as the first argument\n  const renderedVNode = vNode.tag(vNode.props)\n\n  // 4. Clear Global Scope\n  setInstance(null)\n\n  // 5. Attach hooks to the VNode so we can run them later\n  vNode.hooks = hooks\n\n  return renderedVNode\n}\n\n/**\n * Helper to recursively run cleanup hooks when a tree is removed.\n * @param {import(\"./h.js\").VNode} vNode - The vNode to unmount.\n */\nfunction runUnmount(vNode) {\n  if (!vNode) return\n\n  // 1. Run hooks for this node\n  if (vNode.hooks && vNode.hooks.cleanups) {\n    vNode.hooks.cleanups.forEach((fn) => fn())\n  }\n\n  // 2. Recurse into child (if component)\n  if (vNode.child) {\n    runUnmount(vNode.child)\n  }\n\n  // 3. Recurse into children (if element)\n  if (vNode.children) {\n    vNode.children.forEach(runUnmount)\n  }\n}\n\n/**\n * The main diffing function. Compares V-DOM trees and updates the real DOM.\n * @param {HTMLElement} parent - The parent DOM element.\n * @param {import(\"./h.js\").VNode | string | number} newVNode - The new virtual node.\n * @param {import(\"./h.js\").VNode | string | number} oldVNode - The old virtual node.\n * @param {number} [index=0] - The index of the child node (used for simple diffing).\n */\nexport function patch(parent, newVNode, oldVNode, index = 0) {\n  track('diffs')\n\n  // Case 1: Removal - The new node is null/undefined, so we remove the old one.\n  if (newVNode === undefined || newVNode === null) {\n    const el = oldVNode.el || parent.childNodes[index]\n\n    // Recursive Cleanup\n    runUnmount(oldVNode)\n\n    if (el) {\n      parent.removeChild(el)\n      track('elementsRemoved')\n    }\n    return\n  }\n\n  // Case 2: Component - If it's a function, we delegate to the component logic.\n  if (typeof newVNode.tag === 'function') {\n    const isNew = !oldVNode\n\n    const childVNode = renderComponent(newVNode)\n    newVNode.child = childVNode\n\n    const oldChild = oldVNode ? oldVNode.child : undefined\n    patch(parent, childVNode, oldChild, index)\n\n    newVNode.el = childVNode.el\n\n    // Run mount hooks on the next tick\n    if (isNew && newVNode.hooks && newVNode.hooks.mounts.length > 0) {\n      setTimeout(() => {\n        newVNode.hooks.mounts.forEach((fn) => fn())\n      }, 0)\n    }\n    // TODO: Handle updates (running old cleanups if necessary) for Phase 2\n    return\n  }\n\n  // Case 3: Creation - No old node exists, so we create a new one.\n  if (oldVNode === undefined || oldVNode === null) {\n    parent.appendChild(createElement(newVNode, getNamespace(parent)))\n    return\n  }\n\n  // Case 4: Replacement - The node type changed (e.g. div -> span), so we replace it entirely.\n  if (\n    typeof newVNode !== typeof oldVNode ||\n    (typeof newVNode !== 'string' && newVNode.tag !== oldVNode.tag)\n  ) {\n    const el = oldVNode.el || parent.childNodes[index]\n    if (el) {\n      parent.replaceChild(createElement(newVNode, getNamespace(parent)), el)\n      track('patches')\n    }\n    return\n  }\n\n  // Case 5: Text Update - It's a text node, so we just update the text content.\n  if (typeof newVNode === 'string' || typeof newVNode === 'number') {\n    if (newVNode !== oldVNode) {\n      const el = parent.childNodes[index]\n      if (el) {\n        el.nodeValue = String(newVNode)\n        track('patches')\n      } else {\n        // Self healing: if text node missing, append it\n        parent.appendChild(document.createTextNode(String(newVNode)))\n      }\n    }\n    return\n  }\n\n  // Case 6: Update - Same tag, so we update props and recurse into children.\n  const el = oldVNode.el || parent.childNodes[index]\n\n  if (!el) return\n\n  // Transfer DOM reference to the new VNode\n  newVNode.el = el\n\n  patchProps(el, newVNode.props, oldVNode.props)\n\n  reconcileChildren(el, newVNode.children, oldVNode.children)\n}\n","/**\n * Represents a value wrapped by the persist() function.\n * @template T\n * @typedef {object} Persisted\n * @property {T} initial\n * @property {boolean} __humn_persist\n * @property {PersistConfig} [config]\n */\n\n/**\n * @typedef {object} PersistConfig\n * @property {string} key\n */\n\n/**\n * Marks a section of the state for persistence in localStorage.\n * @template T\n * @param {T} initial\n * @param {PersistConfig} [config]\n * @returns {Persisted<T>}\n */\nexport const persist = (initial, config = {}) => ({\n  __humn_persist: true,\n  initial,\n  config,\n})\n","import { isDev } from './metrics.js'\nimport { getObserver } from './observer.js'\n\n/**\n * Mapped type for the Memory configuration object.\n * Allows each property to be the raw value OR a persisted wrapper.\n * @template T\n * @typedef { { [K in keyof T]: T[K] | import('./persist.js').Persisted<T[K]> } } MemoryInput\n */\n\n/**\n * Deeply unwraps persisted values from the memory shape.\n * @template {object} T\n * @typedef {{ [K in keyof T]: T[K] extends import('./persist.js').Persisted<infer I> ? I : T[K] }} UnwrappedMemory\n */\n\n/**\n * @template T\n * @callback Getter\n * @returns {T}\n */\n\n/**\n * @template T\n * @callback Setter\n * @param {Partial<T> | ((state: T) => void | Partial<T> | unknown)} updater\n * @returns {void}\n */\n\n/**\n * @template M, S\n * @callback SynapsesBuilder\n * @param {Setter<M>} set\n * @param {Getter<M>} get\n * @returns {S}\n */\n\n/**\n * @template M, S\n * @typedef {object} CortexConfig\n * @property {MemoryInput<M>} memory - The initial state configuration\n * @property {SynapsesBuilder<M, S>} synapses - The synapses builder function\n */\n\n/**\n * The Cortex class manages the state of the application.\n *\n * @template {object} MemoryType The shape of the application state\n * @template {object} SynapsesType The shape of the actions/methods\n */\nexport class Cortex {\n  /**\n   * Creates an instance of Cortex.\n   * @param {CortexConfig<MemoryType, SynapsesType>} config\n   */\n  constructor({ memory, synapses }) {\n    const liveMemory = { ...memory }\n    this._persistenceMap = new Map()\n\n    // Load in any existing values from local-storage\n    for (const [key, value] of Object.entries(memory)) {\n      if (value && typeof value === 'object' && value.__humn_persist) {\n        const storageKey = value.config?.key || key\n        this._persistenceMap.set(key, storageKey)\n\n        try {\n          const stored = localStorage.getItem(storageKey)\n          if (stored !== null) {\n            liveMemory[key] = JSON.parse(stored)\n          } else {\n            liveMemory[key] = value.initial\n          }\n        } catch (err) {\n          if (isDev)\n            console.warn(`Humn: Failed to load '${key}' from storage.`, err)\n          liveMemory[key] = value.initial\n        }\n      }\n    }\n\n    /** @type {UnwrappedMemory<MemoryType>} */\n    this._memory = liveMemory\n    this._listeners = new Map()\n\n    /** @type {Getter<UnwrappedMemory<MemoryType>>} */\n    const get = () => this._memory\n\n    /** @type {Setter<UnwrappedMemory<MemoryType>>} */\n    const set = (updater) => {\n      let nextState\n      let changedPaths = new Set()\n\n      if (typeof updater === 'function') {\n        const clone = structuredClone(this._memory)\n        const proxy = this._createChangeTrackingProxy(clone, changedPaths)\n        const result = updater(proxy)\n\n        if (result && typeof result === 'object') {\n          nextState = { ...this._memory, ...result }\n          Object.keys(result).forEach((key) => changedPaths.add(key))\n        } else {\n          nextState = clone\n        }\n      } else {\n        nextState = { ...this._memory, ...updater }\n        changedPaths = new Set(Object.keys(updater))\n      }\n\n      this._memory = nextState\n\n      // Persistence logic\n      if (this._persistenceMap.size > 0) {\n        this._persistenceMap.forEach((storageKey, stateKey) => {\n          const isDirty = Array.from(changedPaths).some(\n            (path) => path === stateKey || path.startsWith(stateKey + '.'),\n          )\n\n          if (isDirty) {\n            try {\n              const value = this._memory[stateKey]\n              localStorage.setItem(storageKey, JSON.stringify(value))\n            } catch (err) {\n              if (isDev)\n                console.error(`Humn: Failed to save '${stateKey}'.`, err)\n            }\n          }\n        })\n      }\n\n      this._notifyRelevantListeners(changedPaths)\n    }\n\n    /** @type {SynapsesType} */\n    this.synapses = synapses(set, get)\n  }\n\n  /**\n   * Creates a Proxy that tracks which properties are being mutated.\n   * Includes a GET trap to recursively proxy nested objects for deep mutation tracking.\n   *\n   * WHY: We need to know exactly which paths were changed so we can notify ONLY\n   * the components that care about those specific paths. If we just knew \"something changed\",\n   * we'd have to re-render the whole app (like Redux) or rely on manual optimization.\n   */\n  _createChangeTrackingProxy(obj, changedPaths, path = '') {\n    return new Proxy(obj, {\n      get: (target, prop) => {\n        if (typeof prop === 'symbol' || prop === '__proto__')\n          return target[prop]\n\n        const value = target[prop]\n        const fullPath = path ? `${path}.${prop}` : prop\n\n        // Recursively proxy nested objects so we can trap their sets too\n        if (typeof value === 'object' && value !== null) {\n          return this._createChangeTrackingProxy(value, changedPaths, fullPath)\n        }\n        return value\n      },\n      set: (target, prop, value) => {\n        if (typeof prop === 'symbol' || prop === '__proto__') {\n          target[prop] = value\n          return true\n        }\n\n        const fullPath = path ? `${path}.${prop}` : prop\n        changedPaths.add(fullPath)\n\n        target[prop] = value\n        return true\n      },\n    })\n  }\n\n  /**\n   * Only notify listeners that read properties which changed\n   */\n  _notifyRelevantListeners(changedPaths) {\n    this._listeners.forEach((accessedPaths, renderFn) => {\n      const shouldNotify = Array.from(accessedPaths).some((accessedPath) => {\n        return Array.from(changedPaths).some((changedPath) => {\n          // Check for exact match or parent/child relationship\n          return (\n            accessedPath === changedPath ||\n            accessedPath.startsWith(changedPath + '.') ||\n            changedPath.startsWith(accessedPath + '.')\n          )\n        })\n      })\n\n      if (shouldNotify) renderFn()\n    })\n  }\n\n  /**\n   * Creates a Proxy that tracks which properties are accessed during render\n   *\n   * WHY: This is the other half of the magic. By tracking what a component READS\n   * during its render, we build a precise dependency graph. If a component reads\n   * `state.user.name`, it will only re-render when `state.user.name` changes,\n   * not when `state.count` changes.\n   */\n  _createAccessTrackingProxy(obj, accessedPaths, path = '') {\n    if (typeof obj !== 'object' || obj === null) return obj\n\n    return new Proxy(obj, {\n      get: (target, prop) => {\n        // We don't care about prototype and symbol properties\n        if (typeof prop === 'symbol' || prop === '__proto__')\n          return target[prop]\n\n        const fullPath = path ? `${path}.${prop}` : prop\n        accessedPaths.add(fullPath)\n\n        const value = target[prop]\n\n        // Recursively wrap nested objects\n        if (typeof value === 'object' && value !== null)\n          return this._createAccessTrackingProxy(value, accessedPaths, fullPath)\n\n        return value\n      },\n    })\n  }\n\n  /**\n   * @returns {UnwrappedMemory<MemoryType>}\n   */\n  get memory() {\n    const currentObserver = getObserver()\n\n    if (!currentObserver) return this._memory\n\n    if (!this._listeners.has(currentObserver))\n      this._listeners.set(currentObserver, new Set())\n\n    const accessedPaths = this._listeners.get(currentObserver)\n\n    return this._createAccessTrackingProxy(this._memory, accessedPaths)\n  }\n}\n","/**\n * @typedef {object} VNode\n * @property {string} tag\n * @property {object} props\n * @property {VNode[]} children\n */\n\n/**\n * Creates a virtual DOM node.\n * This is a hyperscript-like function.\n *\n * @param {string} tag - The tag name of the element.\n * @param {object} props - The properties of the element.\n * @param {VNode[]|VNode} children - The children of the element.\n * @returns {VNode} The virtual DOM node.\n */\nexport const h = (tag, props = {}, children = []) => {\n  const childArray = Array.isArray(children) ? children : [children]\n\n  // Filter out null/false so we don't have \"ghost\" nodes\n  const cleanChildren = childArray\n    .flat()\n    .filter((c) => c !== null && c !== undefined && c !== false && c !== '')\n\n  return {\n    tag,\n    props,\n    children: cleanChildren,\n  }\n}\n","/**\n * @file Mounts the application to the DOM.\n * @module mount\n */\nimport { setObserver } from './observer.js'\nimport { patch } from './patch.js'\n\n/**\n * Mounts a component to a target DOM element.\n * @param {HTMLElement} target - The DOM element to mount to.\n * @param {function} Component - The root component function.\n */\nexport const mount = (target, Component) => {\n  let prevVNode = null\n\n  const lifecycle = () => {\n    setObserver(lifecycle)\n\n    const nextVNode = {\n      tag: Component,\n      props: {},\n      children: [],\n    }\n\n    patch(target, nextVNode, prevVNode)\n    setObserver(null)\n    prevVNode = nextVNode\n  }\n\n  lifecycle()\n}\n","/**\n * @file Lifecycle hooks for components.\n * @module lifecycle\n */\nimport { getInstance } from './observer.js'\n\n/**\n * Registers a callback to run after the component mounts.\n * @param {function} fn - The callback function.\n */\nexport function onMount(fn) {\n  const instance = getInstance()\n  if (instance) {\n    instance.mounts.push(fn)\n  }\n}\n\n/**\n * Registers a callback to run when the component unmounts.\n * @param {function} fn - The callback function.\n */\nexport function onCleanup(fn) {\n  const instance = getInstance()\n  if (instance) {\n    instance.cleanups.push(fn)\n  }\n}\n"],"names":["g","f","exports","module","define","amd","globalThis","self","Humn","this","currentObserver","currentInstance","getObserver","setObserver","obs","getInstance","setInstance","inst","styleSheet","cache","Set","getNamespace","parent","namespaceURI","SVG_NS","tagName","MATH_NS","hasKeys","children","some","c","props","key","createElement","vNode","namespace","document","createTextNode","String","tag","childVNode","renderComponent","child","el","hooks","mounts","length","setTimeout","forEach","fn","element","createElementNS","patchProps","childNS","appendChild","newProps","oldProps","allProps","oldValue","newValue","startsWith","eventName","slice","toLowerCase","removeEventListener","addEventListener","disabled","setAttribute","removeAttribute","reconcileChildren","newChildren","oldChildren","maxLen","Math","max","i","patch","keyed","index","newChild","existingChildMatch","oldVNode","domChildAtIndex","childNodes","insertBefore","newElement","Object","values","parentNode","runUnmount","removeChild","cleanups","renderedVNode","newVNode","isNew","replaceChild","nodeValue","Cortex","constructor","memory","synapses","liveMemory","_persistenceMap","Map","value","entries","__humn_persist","storageKey","config","set","stored","localStorage","getItem","JSON","parse","initial","_memory","_listeners","updater","nextState","changedPaths","clone","structuredClone","result","_createChangeTrackingProxy","keys","add","size","stateKey","Array","from","path","setItem","stringify","_notifyRelevantListeners","obj","Proxy","get","target","prop","fullPath","accessedPaths","renderFn","accessedPath","changedPath","_createAccessTrackingProxy","has","css","stringsOrStr","args","raw","isSingleRoot","isArray","reduce","acc","str","content","replace","trim","hash","charCodeAt","toString","hashedClassName","id","head","textContent","h","flat","filter","mount","Component","prevVNode","lifecycle","nextVNode","onCleanup","instance","push","onMount","persist","defineProperty","Symbol","toStringTag"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,33 +1,56 @@
 /**
- * @typedef {object} Synapses@typedef {object} Synapses
- * @property {function} set - Function to update the memory
- * @property {function} get - Function to get the memory
+ * Mapped type for the Memory configuration object.
+ * Allows each property to be the raw value OR a persisted wrapper.
+ * @template T
+ * @typedef { { [K in keyof T]: T[K] | import('./persist.js').Persisted<T[K]> } } MemoryInput
  */
 /**
- * @typedef {object} CortexParams@typedef {object} CortexParams
- * @property {object} memory - The initial state
- * @property {function(function, function): object} synapses - The synapses function
+ * Deeply unwraps persisted values from the memory shape.
+ * @template {object} T
+ * @typedef {{ [K in keyof T]: T[K] extends import('./persist.js').Persisted<infer I> ? I : T[K] }} UnwrappedMemory
+ */
+/**
+ * @template T
+ * @callback Getter@callback Getter
+ * @returns {T}
+ */
+/**
+ * @template T
+ * @callback Setter@callback Setter
+ * @param {Partial<T> | ((state: T) => void | Partial<T> | unknown)} updater
+ * @returns {void}
+ */
+/**
+ * @template M, S
+ * @callback SynapsesBuilder@callback SynapsesBuilder
+ * @param {Setter<M>} set
+ * @param {Getter<M>} get
+ * @returns {S}
+ */
+/**
+ * @template M, S
+ * @typedef {object} CortexConfig@typedef {object} CortexConfig
+ * @property {MemoryInput<M>} memory - The initial state configuration
+ * @property {SynapsesBuilder<M, S>} synapses - The synapses builder function
  */
 /**
  * The Cortex class manages the state of the application.
- * This uses a Proxy for fine-grained reactivity, ensuring only those components
- * which use the updated value get re-rendered.
  *
- * WHY: We use Proxies instead of simple getters/setters because it allows us to
- * detect access to nested properties dynamically without needing to declare
- * dependencies upfront. This "magic" auto-subscription is what makes Humn's
- * DX so clean.
+ * @template {object} MemoryType The shape of the application state
+ * @template {object} SynapsesType The shape of the actions/methods
  */
-export declare class Cortex {
+export declare class Cortex<MemoryType extends unknown, SynapsesType extends unknown> {
     /**
      * Creates an instance of Cortex.
-     * @param {CortexParams} CortexParams - The parameters for the Cortex.
+     * @param {CortexConfig<MemoryType, SynapsesType>} config
      */
-    constructor({ memory, synapses }: CortexParams);
+    constructor({ memory, synapses }: CortexConfig<MemoryType, SynapsesType>);
     _persistenceMap: Map<any, any>;
-    _memory: any;
+    /** @type {UnwrappedMemory<MemoryType>} */
+    _memory: UnwrappedMemory<MemoryType>;
     _listeners: Map<any, any>;
-    synapses: any;
+    /** @type {SynapsesType} */
+    synapses: SynapsesType;
     /**
      * Creates a Proxy that tracks which properties are being mutated.
      * Includes a GET trap to recursively proxy nested objects for deep mutation tracking.
@@ -51,20 +74,20 @@ export declare class Cortex {
      */
     _createAccessTrackingProxy(obj: any, accessedPaths: any, path?: string): any;
     /**
-     * Returns memory wrapped in a tracking Proxy
+     * @returns {UnwrappedMemory<MemoryType>}
      */
-    get memory(): any;
+    get memory(): UnwrappedMemory<MemoryType>;
 }
 
-export declare type CortexParams = {
+export declare type CortexConfig<M, S> = {
     /**
-     * - The initial state
+     * - The initial state configuration
      */
-    memory: object;
+    memory: MemoryInput<M>;
     /**
-     * - The synapses function
+     * - The synapses builder function
      */
-    synapses: (arg0: Function, arg1: Function) => object;
+    synapses: SynapsesBuilder<M, S>;
 };
 
 /**
@@ -76,13 +99,15 @@ export declare type CortexParams = {
  */
 export declare function css(stringsOrStr: any, ...args: any[]): string;
 
+export declare type Getter<T> = () => T;
+
 export declare function h(tag: string, props?: object, children?: VNode[] | VNode): VNode;
 
-export declare type HumnPersist = {
-    __humn_persist: boolean;
-    initial: any;
-    config: PersistConfig;
-};
+/**
+ * Mapped type for the Memory configuration object.
+ * Allows each property to be the raw value OR a persisted wrapper.
+ */
+export declare type MemoryInput<T> = { [K in keyof T]: T[K] | Persisted<T[K]>; };
 
 export declare function mount(target: HTMLElement, Component: Function): void;
 
@@ -98,23 +123,30 @@ export declare function onCleanup(fn: Function): void;
  */
 export declare function onMount(fn: Function): void;
 
-export declare function persist(initial: any, config?: PersistConfig): HumnPersist;
+export declare function persist<T>(initial: T, config?: PersistConfig): Persisted<T>;
 
 export declare type PersistConfig = {
     key: string;
 };
 
-export declare type Synapses = {
-    /**
-     * - Function to update the memory
-     */
-    set: Function;
-    /**
-     * - Function to get the memory
-     */
-    get: Function;
+/**
+ * Represents a value wrapped by the persist() function.
+ */
+export declare type Persisted<T> = {
+    initial: T;
+    __humn_persist: boolean;
+    config?: PersistConfig;
 };
 
+export declare type Setter<T> = (updater: Partial<T> | ((state: T) => void | Partial<T> | unknown)) => void;
+
+export declare type SynapsesBuilder<M, S> = (set: Setter<M>, get: Getter<M>) => S;
+
+/**
+ * Deeply unwraps persisted values from the memory shape.
+ */
+export declare type UnwrappedMemory<T extends unknown> = { [K in keyof T]: T[K] extends Persisted<infer I> ? I : T[K]; };
+
 export declare type VNode = {
     tag: string;
     props: object;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "humn",
-  "version": "1.3.4",
+  "version": "1.4.0",
   "description": "A minimal, human-centric reactive UI library with built in state management.",
   "keywords": [
     "reactive",
@@ -34,7 +34,7 @@
   ],
   "scripts": {
     "build": "vite build",
-    "dev": "node --inspect ../../node_modules/vite/bin/vite.js --port 3000 --open /playground/",
+    "dev": "concurrently 'yarn vite build --watch' 'node --inspect ../../node_modules/vite/bin/vite.js --port 3000 --open /playground/'",
     "prepublishOnly": "npm run build",
     "qa:test": "vitest run",
     "qa:test:watch": "vitest watch"
@@ -46,6 +46,7 @@
     "@semantic-release/github": "^12.0.2",
     "@semantic-release/npm": "^13.1.2",
     "@types/node": "^24.10.1",
+    "concurrently": "^9.2.1",
     "conventional-changelog-conventionalcommits": "^9.1.0",
     "jsdom": "^27.2.0",
     "semantic-release": "^25.0.2",