humn 0.0.2

package/README.md

@@ -0,0 +1,94 @@
+# Humn (Human)
+
+> **The organic, human-centric UI library for the modern web.**
+
+**Humn** is a complete, reactive frontend library with built in state management designed to replace the likes of React/Svelte/Solid AND Zustand/Kea/Redux in your stack.
+
+It rejects the complexity of modern frameworks \* no stale closures, no "Hook Rules", and no heavy compilers. Humn decouples your application's **Cortex** (Logic/State) from its **Body** (View), creating applications that are easy to reason about, simple to test, and naturally reactive.
+
+## Core Features
+
+- **🧬 Biological Architecture:** A strict separation of concerns. Your data lives in the `Cortex`; your UI is just a dumb projection of that memory.
+- **⚡ Zero-Build Reactive View:** Write standard JavaScript. Components are just functions that return virtual DOM nodes. No compilation required (unless you want it).
+- **🧠 Built-in Global State:** No need for Redux or Zustand. The `Cortex` is built-in, handling deep updates, async actions, and side effects out of the box.
+- **mutative syntax, immutable updates:** Write `state.count++`. We handle the immutability and render triggers for you.
+- **🎨 Scoped Styles:** Encapsulated CSS that lives alongside your components.
+
+## Installation
+
+```bash
+npm install humn
+# or yarn add humn
+# or pnpm install humn
+```
+
+## The "Hello World" (That actually scales)
+
+Unlike other libraries, Humn encourages separating logic from the start.
+
+### The Cortex (Logic)
+
+```JavaScript
+
+import { Cortex } from 'humn';
+
+export const appStore = new Cortex({
+  memory: {
+    count: 0,
+    user: 'Guest'
+  },
+  synapses: (set, get) => ({
+    increment: () => set(state => { state.count++ }),
+    login: (name) => set({ user: name })
+  })
+});
+```
+
+### The View (UI)
+
+```JavaScript
+
+import { h, mount } from 'humn-js';
+import { appStore } from './store';
+
+const App = () => {
+  // 1. Read Memory (Auto-subscribes)
+  const { count, user } = appStore.memory;
+  const { increment } = appStore.synapses;
+
+  // 2. Return V-DOM
+  return h('div', { class: 'container' }, [
+    h('h1', {}, `Hello, ${user}`),
+    h('p', {}, `Vital Signs: ${count}`),
+    h('button', { onclick: increment }, 'Pulse')
+  ]);
+};
+
+// 3. Mount
+mount(document.getElementById('root'), App);
+```
+
+## Roadmap
+
+### Phase 1: The Core Engine (Current)
+
+- [x] **Cortex:** State management with dependency tracking.
+- [x] **Virtual DOM:** Lightweight `h()` function.
+- [x] **Reconciliation:** Keyed Diffing Algorithm.
+- [x] **Scoped Styles:** Runtime CSS-in-JS with `css` tag.
+- [x] **Lifecycle Hooks:** `onMount` and `onCleanup` for components (Needed for API calls/Timers).
+
+### Phase 2: The Ecosystem (Next)
+
+- [ ] **Global Store Persist:** Middleware to save Cortex state to `localStorage`.
+- [ ] **Router:** A built-in store that syncs with `window.history`.
+- [ ] **Async Components:** Handling `Promise` rendering (Suspense).
+
+### Phase 3: Developer Experience
+
+- [ ] **Humn Compiler:** `.humn` files for Svelte-like syntax.
+- [ ] **DevTools:** Browser extension to inspect the Cortex Memory.
+
+## Contributing
+
+We are building a library for humans, by humans. Please read CODING_STANDARDS.md before pushing code.

package/dist/humn.js

@@ -0,0 +1,207 @@
+let C = null, S = null;
+const x = () => C, g = (t) => {
+  C = t;
+}, A = () => S, k = (t) => {
+  S = t;
+};
+class T {
+  /**
+   * Creates an instance of Cortex.
+   * @param {CortexParams} CortexParams - The parameters for the Cortex.
+   */
+  constructor({ memory: e, synapses: s }) {
+    this._memory = e, this._listeners = /* @__PURE__ */ new Set();
+    const i = () => this._memory, c = (n) => {
+      let r;
+      if (typeof n == "function") {
+        const o = structuredClone(this._memory);
+        r = n(o) || o;
+      } else
+        r = { ...this._memory, ...n };
+      this._memory = r, this._listeners.forEach((o) => o());
+    };
+    this.synapses = s(c, i);
+  }
+  /**
+   * Get the memory and register the current observer.
+   * @returns {object} The current state
+   */
+  get memory() {
+    const e = x();
+    return e && this._listeners.add(e), this._memory;
+  }
+}
+let h = null;
+const E = /* @__PURE__ */ new Set();
+function I(t) {
+  let e = 5381, s = t.length;
+  for (; s; )
+    e = e * 33 ^ t.charCodeAt(--s);
+  return (e >>> 0).toString(36);
+}
+function O(t) {
+  return t.replace(/\/\*[\s\S]*?\*\//g, "").replace(/\s+/g, " ").trim();
+}
+function K(t, ...e) {
+  const s = t.reduce((r, o, l) => r + o + (e[l] || ""), ""), i = O(s);
+  if (!i) return "";
+  const c = I(i), n = `humn-${c}`;
+  return E.has(c) || (h || (h = document.createElement("style"), h.id = "humn-styles", document.head.appendChild(h)), h.textContent += `.${n} { 
+    ${i} 
+  }
+`, E.add(c)), n;
+}
+const $ = (t, e = {}, s = []) => {
+  const c = (Array.isArray(s) ? s : [s]).flat().filter((n) => n != null && n !== !1 && n !== "");
+  return {
+    tag: t,
+    props: e,
+    children: c
+  };
+};
+function B(t) {
+  const e = A();
+  e && e.mounts.push(t);
+}
+function M(t) {
+  const e = A();
+  e && e.cleanups.push(t);
+}
+function b(t) {
+  return t && t.some((e) => e && e.props && e.props.key != null);
+}
+function a(t) {
+  if (typeof t == "string" || typeof t == "number")
+    return document.createTextNode(String(t));
+  if (typeof t.tag == "function") {
+    const s = d(t);
+    t.child = s;
+    const i = a(s);
+    return t.el = i, t.hooks && t.hooks.mounts.length > 0 && setTimeout(() => t.hooks.mounts.forEach((c) => c()), 0), i;
+  }
+  const e = document.createElement(t.tag);
+  return t.el = e, _(e, t.props), t.children.forEach((s) => {
+    e.appendChild(a(s));
+  }), e;
+}
+function _(t, e = {}, s = {}) {
+  if (!t) return;
+  const i = { ...s, ...e };
+  for (const c in i) {
+    const n = s[c], r = e[c];
+    if (r == null) {
+      t.removeAttribute(c);
+      continue;
+    }
+    if (c === "value" || c === "checked") {
+      t[c] !== r && (t[c] = r);
+      continue;
+    }
+    if (n !== r) {
+      if (c.startsWith("on")) {
+        const o = c.slice(2).toLowerCase();
+        n && t.removeEventListener(o, n), t.addEventListener(o, r);
+      }
+      c === "disabled" ? t.disabled = r === !0 || r === "true" : t.setAttribute(c, r);
+    }
+  }
+}
+function L(t, e, s) {
+  if (!(b(e) || b(s))) {
+    const n = Math.max(e.length, s.length);
+    for (let r = 0; r < n; r++)
+      m(t, e[r], s[r], r);
+    return;
+  }
+  const c = {};
+  s.forEach((n, r) => {
+    const o = (n.props && n.props.key) != null ? n.props.key : r;
+    c[o] = { vNode: n, index: r };
+  }), e.forEach((n, r) => {
+    const o = (n.props && n.props.key) != null ? n.props.key : r, l = c[o];
+    if (l) {
+      const f = l.vNode;
+      m(t, n, f, r);
+      const u = n.el || f.el, y = t.childNodes[r];
+      u && y !== u && t.insertBefore(u, y), delete c[o];
+    } else {
+      const f = a(n), u = t.childNodes[r];
+      u ? t.insertBefore(f, u) : t.appendChild(f);
+    }
+  }), Object.values(c).forEach(({ vNode: n }) => {
+    n.el && n.el.parentNode === t && t.removeChild(n.el);
+  });
+}
+function d(t) {
+  const e = {
+    mounts: [],
+    cleanups: []
+  };
+  k(e);
+  const s = t.tag(t.props);
+  return k(null), t.hooks = e, s;
+}
+function p(t) {
+  t && (t.hooks && t.hooks.cleanups && t.hooks.cleanups.forEach((e) => e()), t.child && p(t.child), t.children && t.children.forEach(p));
+}
+function m(t, e, s, i = 0) {
+  if (e == null) {
+    const n = s.el || t.childNodes[i];
+    p(s), n && t.removeChild(n);
+    return;
+  }
+  if (typeof e.tag == "function") {
+    const n = !s, r = d(e);
+    e.child = r;
+    const o = s ? s.child : void 0;
+    m(t, r, o, i), e.el = r.el, n && e.hooks && e.hooks.mounts.length > 0 && setTimeout(() => {
+      e.hooks.mounts.forEach((l) => l());
+    }, 0);
+    return;
+  }
+  if (s == null) {
+    t.appendChild(a(e));
+    return;
+  }
+  if (e == null) {
+    const n = s.el || t.childNodes[i];
+    n && t.removeChild(n);
+    return;
+  }
+  if (typeof e != typeof s || typeof e != "string" && e.tag !== s.tag) {
+    const n = s.el || t.childNodes[i];
+    n && t.replaceChild(a(e), n);
+    return;
+  }
+  if (typeof e == "string" || typeof e == "number") {
+    if (e !== s) {
+      const n = t.childNodes[i];
+      n ? n.nodeValue = String(e) : t.appendChild(document.createTextNode(String(e)));
+    }
+    return;
+  }
+  const c = s.el || t.childNodes[i];
+  c && (e.el = c, _(c, e.props, s.props), L(c, e.children, s.children));
+}
+const j = (t, e) => {
+  let s = null;
+  const i = () => {
+    g(i);
+    const c = {
+      tag: e,
+      props: {},
+      children: []
+    };
+    m(t, c, s), g(null), s = c;
+  };
+  i();
+};
+export {
+  T as Cortex,
+  K as css,
+  $ as h,
+  j as mount,
+  M as onCleanup,
+  B as onMount
+};
+//# sourceMappingURL=humn.js.map

package/dist/humn.js.map

@@ -0,0 +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"],"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 { 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 */\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    this._memory = memory;\n    this._listeners = new Set();\n\n    const get = () => this._memory;\n\n    const set = (updater) => {\n      let nextState;\n      if (typeof updater === \"function\") {\n        const clone = structuredClone(this._memory);\n        const result = updater(clone);\n        nextState = result || clone;\n      } else {\n        nextState = { ...this._memory, ...updater };\n      }\n\n      this._memory = nextState;\n      this._listeners.forEach((render) => render());\n    };\n\n    this.synapses = synapses(set, get);\n  }\n\n  /**\n   * Get the memory and register the current observer.\n   * @returns {object} The current state\n   */\n  get memory() {\n    const currentObserver = getObserver();\n    if (currentObserver) this._listeners.add(currentObserver);\n    return this._memory;\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 */\nexport function css(strings, ...args) {\n  const raw = strings.reduce((acc, str, i) => {\n    return acc + str + (args[i] || \"\");\n  }, \"\");\n\n  const content = minify(raw);\n\n  if (!content) return \"\";\n\n  const hash = hashString(content);\n  const className = `humn-${hash}`;\n\n  if (cache.has(hash)) {\n    return className;\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 += `.${className} { \n    ${content} \n  }\\n`;\n  cache.add(hash);\n\n  return className;\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 { setInstance } from \"./observer.js\";\n\n/**\n * Checks if a list of children contains keys.\n * @param {Array<import(\"./h\").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\n/**\n * Creates a real DOM element from a virtual node.\n * @param {import(\"./h\").VNode | string | number} vNode - The virtual node.\n * @returns {Text | HTMLElement} The created DOM element.\n */\nfunction createElement(vNode) {\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    // Recursively create the DOM for the child\n    const el = createElement(childVNode);\n    vNode.el = el;\n\n    // Queue Mount Hooks\n    if (vNode.hooks && vNode.hooks.mounts.length > 0) {\n      setTimeout(() => vNode.hooks.mounts.forEach((fn) => fn()), 0);\n    }\n    return el;\n  }\n\n  const el = document.createElement(vNode.tag);\n  vNode.el = el;\n  patchProps(el, vNode.props);\n\n  vNode.children.forEach((child) => {\n    el.appendChild(createElement(child));\n  });\n\n  return el;\n}\n\n/**\n * Updates the properties (attributes/events) of a DOM element.\n * @param {HTMLElement} el - The DOM element to update.\n * @param {object} [newProps={}] - The new properties.\n * @param {object} [oldProps={}] - The old properties.\n */\nfunction patchProps(el, newProps = {}, oldProps = {}) {\n  if (!el) 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      el.removeAttribute(key);\n      continue;\n    }\n\n    // We check against the LIVE DOM value to prevent cursor jumping\n    if (key === \"value\" || key === \"checked\") {\n      if (el[key] !== newValue) {\n        el[key] = newValue;\n      }\n      continue;\n    }\n\n    // If prop hasn't changed, skip\n    if (oldValue === newValue) continue;\n\n    // Handle Events\n    if (key.startsWith(\"on\")) {\n      const eventName = key.slice(2).toLowerCase();\n      if (oldValue) el.removeEventListener(eventName, oldValue);\n      el.addEventListener(eventName, newValue);\n    }\n    // Handle the disabled attribute\n    if (key === \"disabled\") {\n      el.disabled = newValue === true || newValue === \"true\";\n    }\n    // Handle standard attributes\n    else {\n      el.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\").VNode>} newChildren - The new list of children.\n * @param {Array<import(\"./h\").VNode>} oldChildren - The old list of children.\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  // Keyed Diffing\n  // Map existing children by Key\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 oldItem = keyed[key];\n\n    if (oldItem) {\n      // A. MATCH FOUND\n      const oldVNode = oldItem.vNode;\n\n      // Update the node's content (Recursion)\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 el = 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 (el && domChildAtIndex !== el) {\n        parent.insertBefore(el, domChildAtIndex);\n      }\n\n      // Remove from map so we know it was re-used\n      delete keyed[key];\n    } else {\n      // B. NO MATCH (New Item)\n      const newEl = createElement(newChild);\n      const domChildAtIndex = parent.childNodes[i];\n\n      if (domChildAtIndex) {\n        parent.insertBefore(newEl, domChildAtIndex);\n      } else {\n        parent.appendChild(newEl);\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      parent.removeChild(vNode.el);\n    }\n  });\n}\n\n/**\n * Executes a Functional Component, tracks hooks, and returns the VNode.\n * @param {import(\"./h\").VNode} vNode - The component vNode.\n * @returns {import(\"./h\").VNode} The rendered child vNode.\n */\nfunction renderComponent(vNode) {\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\").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\").VNode | string | number} newVNode - The new virtual node.\n * @param {import(\"./h\").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  // --- HANDLE UNMOUNTING (Cleanup Hooks) ---\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) parent.removeChild(el);\n    return;\n  }\n\n  // --- HANDLE COMPONENT (Functional VNode) ---\n  if (typeof newVNode.tag === \"function\") {\n    const isNew = !oldVNode;\n\n    // 1. Render the component function\n    const childVNode = renderComponent(newVNode);\n\n    // 2. Store the result in the vNode (\"unwrap\" it)\n    newVNode.child = childVNode;\n\n    // 3. Recursively patch the result\n    const oldChild = oldVNode ? oldVNode.child : undefined;\n    patch(parent, childVNode, oldChild, index);\n\n    // 4. Ensure VNode holds the DOM reference\n    newVNode.el = childVNode.el;\n\n    // 5. Run Mount Hooks (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  // Start - No old node? Create new.\n  if (oldVNode === undefined || oldVNode === null) {\n    parent.appendChild(createElement(newVNode));\n    return;\n  }\n\n  // Removal - No new node? Remove old.\n  if (newVNode === undefined || newVNode === null) {\n    // Try to find the element on the VNode, or fallback to index\n    const el = oldVNode.el || parent.childNodes[index];\n    if (el) parent.removeChild(el);\n    return;\n  }\n\n  // Changed Type - (e.g. <div> becomes <span>) -> Replace whole node\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) parent.replaceChild(createElement(newVNode), el);\n    return;\n  }\n\n  // Text Update\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      } else {\n        // Self healing: if text node missing, append it\n        parent.appendChild(document.createTextNode(String(newVNode)));\n      }\n    }\n    return;\n  }\n\n  // Same Tag - Update Props & 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"],"names":["currentObserver","currentInstance","getObserver","setObserver","obs","getInstance","setInstance","inst","Cortex","memory","synapses","get","set","updater","nextState","clone","render","styleSheet","cache","hashString","str","hash","i","minify","css","strings","args","raw","acc","content","className","h","tag","props","children","cleanChildren","c","onMount","fn","instance","onCleanup","hasKeys","createElement","vNode","childVNode","renderComponent","el","patchProps","child","newProps","oldProps","allProps","key","oldValue","newValue","eventName","reconcileChildren","parent","newChildren","oldChildren","maxLen","patch","keyed","newChild","oldItem","oldVNode","domChildAtIndex","newEl","hooks","renderedVNode","runUnmount","newVNode","index","isNew","oldChild","mount","target","Component","prevVNode","lifecycle","nextVNode"],"mappings":"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"}

package/dist/humn.umd.js

@@ -0,0 +1,5 @@
+(function(u,f){typeof exports=="object"&&typeof module<"u"?f(exports):typeof define=="function"&&define.amd?define(["exports"],f):(u=typeof globalThis<"u"?globalThis:u||self,f(u.Humn={}))})(this,(function(u){"use strict";let f=null,k=null;const I=()=>f,d=t=>{f=t},E=()=>k,b=t=>{k=t};class O{constructor({memory:e,synapses:s}){this._memory=e,this._listeners=new Set;const r=()=>this._memory,c=n=>{let i;if(typeof n=="function"){const o=structuredClone(this._memory);i=n(o)||o}else i={...this._memory,...n};this._memory=i,this._listeners.forEach(o=>o())};this.synapses=s(c,r)}get memory(){const e=I();return e&&this._listeners.add(e),this._memory}}let a=null;const C=new Set;function x(t){let e=5381,s=t.length;for(;s;)e=e*33^t.charCodeAt(--s);return(e>>>0).toString(36)}function L(t){return t.replace(/\/\*[\s\S]*?\*\//g,"").replace(/\s+/g," ").trim()}function M(t,...e){const s=t.reduce((i,o,l)=>i+o+(e[l]||""),""),r=L(s);if(!r)return"";const c=x(r),n=`humn-${c}`;return C.has(c)||(a||(a=document.createElement("style"),a.id="humn-styles",document.head.appendChild(a)),a.textContent+=`.${n} { 
+    ${r} 
+  }
+`,C.add(c)),n}const j=(t,e={},s=[])=>{const c=(Array.isArray(s)?s:[s]).flat().filter(n=>n!=null&&n!==!1&&n!=="");return{tag:t,props:e,children:c}};function K(t){const e=E();e&&e.mounts.push(t)}function $(t){const e=E();e&&e.cleanups.push(t)}function S(t){return t&&t.some(e=>e&&e.props&&e.props.key!=null)}function m(t){if(typeof t=="string"||typeof t=="number")return document.createTextNode(String(t));if(typeof t.tag=="function"){const s=_(t);t.child=s;const r=m(s);return t.el=r,t.hooks&&t.hooks.mounts.length>0&&setTimeout(()=>t.hooks.mounts.forEach(c=>c()),0),r}const e=document.createElement(t.tag);return t.el=e,A(e,t.props),t.children.forEach(s=>{e.appendChild(m(s))}),e}function A(t,e={},s={}){if(!t)return;const r={...s,...e};for(const c in r){const n=s[c],i=e[c];if(i==null){t.removeAttribute(c);continue}if(c==="value"||c==="checked"){t[c]!==i&&(t[c]=i);continue}if(n!==i){if(c.startsWith("on")){const o=c.slice(2).toLowerCase();n&&t.removeEventListener(o,n),t.addEventListener(o,i)}c==="disabled"?t.disabled=i===!0||i==="true":t.setAttribute(c,i)}}}function B(t,e,s){if(!(S(e)||S(s))){const n=Math.max(e.length,s.length);for(let i=0;i<n;i++)y(t,e[i],s[i],i);return}const c={};s.forEach((n,i)=>{const o=(n.props&&n.props.key)!=null?n.props.key:i;c[o]={vNode:n,index:i}}),e.forEach((n,i)=>{const o=(n.props&&n.props.key)!=null?n.props.key:i,l=c[o];if(l){const p=l.vNode;y(t,n,p,i);const h=n.el||p.el,T=t.childNodes[i];h&&T!==h&&t.insertBefore(h,T),delete c[o]}else{const p=m(n),h=t.childNodes[i];h?t.insertBefore(p,h):t.appendChild(p)}}),Object.values(c).forEach(({vNode:n})=>{n.el&&n.el.parentNode===t&&t.removeChild(n.el)})}function _(t){const e={mounts:[],cleanups:[]};b(e);const s=t.tag(t.props);return b(null),t.hooks=e,s}function g(t){t&&(t.hooks&&t.hooks.cleanups&&t.hooks.cleanups.forEach(e=>e()),t.child&&g(t.child),t.children&&t.children.forEach(g))}function y(t,e,s,r=0){if(e==null){const n=s.el||t.childNodes[r];g(s),n&&t.removeChild(n);return}if(typeof e.tag=="function"){const n=!s,i=_(e);e.child=i;const o=s?s.child:void 0;y(t,i,o,r),e.el=i.el,n&&e.hooks&&e.hooks.mounts.length>0&&setTimeout(()=>{e.hooks.mounts.forEach(l=>l())},0);return}if(s==null){t.appendChild(m(e));return}if(e==null){const n=s.el||t.childNodes[r];n&&t.removeChild(n);return}if(typeof e!=typeof s||typeof e!="string"&&e.tag!==s.tag){const n=s.el||t.childNodes[r];n&&t.replaceChild(m(e),n);return}if(typeof e=="string"||typeof e=="number"){if(e!==s){const n=t.childNodes[r];n?n.nodeValue=String(e):t.appendChild(document.createTextNode(String(e)))}return}const c=s.el||t.childNodes[r];c&&(e.el=c,A(c,e.props,s.props),B(c,e.children,s.children))}const H=(t,e)=>{let s=null;const r=()=>{d(r);const c={tag:e,props:{},children:[]};y(t,c,s),d(null),s=c};r()};u.Cortex=O,u.css=M,u.h=j,u.mount=H,u.onCleanup=$,u.onMount=K,Object.defineProperty(u,Symbol.toStringTag,{value:"Module"})}));
+//# sourceMappingURL=humn.umd.js.map

package/dist/humn.umd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"humn.umd.js","sources":["../src/observer.js","../src/cortex.js","../src/css.js","../src/h.js","../src/lifecycle.js","../src/patch.js","../src/mount.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 { 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 */\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    this._memory = memory;\n    this._listeners = new Set();\n\n    const get = () => this._memory;\n\n    const set = (updater) => {\n      let nextState;\n      if (typeof updater === \"function\") {\n        const clone = structuredClone(this._memory);\n        const result = updater(clone);\n        nextState = result || clone;\n      } else {\n        nextState = { ...this._memory, ...updater };\n      }\n\n      this._memory = nextState;\n      this._listeners.forEach((render) => render());\n    };\n\n    this.synapses = synapses(set, get);\n  }\n\n  /**\n   * Get the memory and register the current observer.\n   * @returns {object} The current state\n   */\n  get memory() {\n    const currentObserver = getObserver();\n    if (currentObserver) this._listeners.add(currentObserver);\n    return this._memory;\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 */\nexport function css(strings, ...args) {\n  const raw = strings.reduce((acc, str, i) => {\n    return acc + str + (args[i] || \"\");\n  }, \"\");\n\n  const content = minify(raw);\n\n  if (!content) return \"\";\n\n  const hash = hashString(content);\n  const className = `humn-${hash}`;\n\n  if (cache.has(hash)) {\n    return className;\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 += `.${className} { \n    ${content} \n  }\\n`;\n  cache.add(hash);\n\n  return className;\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 { setInstance } from \"./observer.js\";\n\n/**\n * Checks if a list of children contains keys.\n * @param {Array<import(\"./h\").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\n/**\n * Creates a real DOM element from a virtual node.\n * @param {import(\"./h\").VNode | string | number} vNode - The virtual node.\n * @returns {Text | HTMLElement} The created DOM element.\n */\nfunction createElement(vNode) {\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    // Recursively create the DOM for the child\n    const el = createElement(childVNode);\n    vNode.el = el;\n\n    // Queue Mount Hooks\n    if (vNode.hooks && vNode.hooks.mounts.length > 0) {\n      setTimeout(() => vNode.hooks.mounts.forEach((fn) => fn()), 0);\n    }\n    return el;\n  }\n\n  const el = document.createElement(vNode.tag);\n  vNode.el = el;\n  patchProps(el, vNode.props);\n\n  vNode.children.forEach((child) => {\n    el.appendChild(createElement(child));\n  });\n\n  return el;\n}\n\n/**\n * Updates the properties (attributes/events) of a DOM element.\n * @param {HTMLElement} el - The DOM element to update.\n * @param {object} [newProps={}] - The new properties.\n * @param {object} [oldProps={}] - The old properties.\n */\nfunction patchProps(el, newProps = {}, oldProps = {}) {\n  if (!el) 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      el.removeAttribute(key);\n      continue;\n    }\n\n    // We check against the LIVE DOM value to prevent cursor jumping\n    if (key === \"value\" || key === \"checked\") {\n      if (el[key] !== newValue) {\n        el[key] = newValue;\n      }\n      continue;\n    }\n\n    // If prop hasn't changed, skip\n    if (oldValue === newValue) continue;\n\n    // Handle Events\n    if (key.startsWith(\"on\")) {\n      const eventName = key.slice(2).toLowerCase();\n      if (oldValue) el.removeEventListener(eventName, oldValue);\n      el.addEventListener(eventName, newValue);\n    }\n    // Handle the disabled attribute\n    if (key === \"disabled\") {\n      el.disabled = newValue === true || newValue === \"true\";\n    }\n    // Handle standard attributes\n    else {\n      el.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\").VNode>} newChildren - The new list of children.\n * @param {Array<import(\"./h\").VNode>} oldChildren - The old list of children.\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  // Keyed Diffing\n  // Map existing children by Key\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 oldItem = keyed[key];\n\n    if (oldItem) {\n      // A. MATCH FOUND\n      const oldVNode = oldItem.vNode;\n\n      // Update the node's content (Recursion)\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 el = 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 (el && domChildAtIndex !== el) {\n        parent.insertBefore(el, domChildAtIndex);\n      }\n\n      // Remove from map so we know it was re-used\n      delete keyed[key];\n    } else {\n      // B. NO MATCH (New Item)\n      const newEl = createElement(newChild);\n      const domChildAtIndex = parent.childNodes[i];\n\n      if (domChildAtIndex) {\n        parent.insertBefore(newEl, domChildAtIndex);\n      } else {\n        parent.appendChild(newEl);\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      parent.removeChild(vNode.el);\n    }\n  });\n}\n\n/**\n * Executes a Functional Component, tracks hooks, and returns the VNode.\n * @param {import(\"./h\").VNode} vNode - The component vNode.\n * @returns {import(\"./h\").VNode} The rendered child vNode.\n */\nfunction renderComponent(vNode) {\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\").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\").VNode | string | number} newVNode - The new virtual node.\n * @param {import(\"./h\").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  // --- HANDLE UNMOUNTING (Cleanup Hooks) ---\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) parent.removeChild(el);\n    return;\n  }\n\n  // --- HANDLE COMPONENT (Functional VNode) ---\n  if (typeof newVNode.tag === \"function\") {\n    const isNew = !oldVNode;\n\n    // 1. Render the component function\n    const childVNode = renderComponent(newVNode);\n\n    // 2. Store the result in the vNode (\"unwrap\" it)\n    newVNode.child = childVNode;\n\n    // 3. Recursively patch the result\n    const oldChild = oldVNode ? oldVNode.child : undefined;\n    patch(parent, childVNode, oldChild, index);\n\n    // 4. Ensure VNode holds the DOM reference\n    newVNode.el = childVNode.el;\n\n    // 5. Run Mount Hooks (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  // Start - No old node? Create new.\n  if (oldVNode === undefined || oldVNode === null) {\n    parent.appendChild(createElement(newVNode));\n    return;\n  }\n\n  // Removal - No new node? Remove old.\n  if (newVNode === undefined || newVNode === null) {\n    // Try to find the element on the VNode, or fallback to index\n    const el = oldVNode.el || parent.childNodes[index];\n    if (el) parent.removeChild(el);\n    return;\n  }\n\n  // Changed Type - (e.g. <div> becomes <span>) -> Replace whole node\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) parent.replaceChild(createElement(newVNode), el);\n    return;\n  }\n\n  // Text Update\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      } else {\n        // Self healing: if text node missing, append it\n        parent.appendChild(document.createTextNode(String(newVNode)));\n      }\n    }\n    return;\n  }\n\n  // Same Tag - Update Props & 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"],"names":["currentObserver","currentInstance","getObserver","setObserver","obs","getInstance","setInstance","inst","Cortex","memory","synapses","get","set","updater","nextState","clone","render","styleSheet","cache","hashString","str","hash","i","minify","css","strings","args","raw","acc","content","className","h","tag","props","children","cleanChildren","c","onMount","fn","instance","onCleanup","hasKeys","createElement","vNode","childVNode","renderComponent","el","patchProps","child","newProps","oldProps","allProps","key","oldValue","newValue","eventName","reconcileChildren","parent","newChildren","oldChildren","maxLen","patch","keyed","newChild","oldItem","oldVNode","domChildAtIndex","newEl","hooks","renderedVNode","runUnmount","newVNode","index","isNew","oldChild","mount","target","Component","prevVNode","lifecycle","nextVNode"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @typedef {object} Synapses@typedef {object} Synapses
+ * @property {function} set - Function to update the memory
+ * @property {function} get - Function to get the memory
+ */
+/**
+ * @typedef {object} CortexParams@typedef {object} CortexParams
+ * @property {object} memory - The initial state
+ * @property {function(function, function): object} synapses - The synapses function
+ */
+/**
+ * The Cortex class manages the state of the application.
+ */
+export declare class Cortex {
+    /**
+     * Creates an instance of Cortex.
+     * @param {CortexParams} CortexParams - The parameters for the Cortex.
+     */
+    constructor({ memory, synapses }: CortexParams);
+    _memory: any;
+    _listeners: Set<any>;
+    synapses: any;
+    /**
+     * Get the memory and register the current observer.
+     * @returns {object} The current state
+     */
+    get memory(): object;
+}
+
+export declare type CortexParams = {
+    /**
+     * - The initial state
+     */
+    memory: object;
+    /**
+     * - The synapses function
+     */
+    synapses: (arg0: Function, arg1: Function) => object;
+};
+
+/**
+ * Scoped CSS Tag.
+ * Wraps content in a unique class using Native CSS Nesting.
+ */
+export declare function css(strings: any, ...args: any[]): string;
+
+export declare function h(tag: string, props?: object, children?: VNode[] | VNode): VNode;
+
+export declare function mount(target: HTMLElement, Component: Function): void;
+
+/**
+ * Registers a callback to run when the component unmounts.
+ * @param {function} fn - The callback function.
+ */
+export declare function onCleanup(fn: Function): void;
+
+/**
+ * Registers a callback to run after the component mounts.
+ * @param {function} fn - The callback function.
+ */
+export declare function onMount(fn: Function): void;
+
+export declare type Synapses = {
+    /**
+     * - Function to update the memory
+     */
+    set: Function;
+    /**
+     * - Function to get the memory
+     */
+    get: Function;
+};
+
+export declare type VNode = {
+    tag: string;
+    props: object;
+    children: VNode[];
+};
+
+export { }

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "humn",
+  "version": "0.0.2",
+  "description": "A minimal, human-centric reactive UI library with built in state management.",
+  "type": "module",
+  "main": "./dist/humn.umd.js",
+  "module": "./dist/humn.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/humn.js",
+      "require": "./dist/humn.umd.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "test": "vitest",
+    "dev": "vite --port 3000 --open /playground/",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "reactive",
+    "ui",
+    "state",
+    "store",
+    "cortex"
+  ],
+  "author": "Keeghan McGarry",
+  "license": "MIT",
+  "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e",
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "typescript": "^5.9.3",
+    "vite": "^7.2.6",
+    "vite-plugin-dts": "^4.5.4"
+  }
+}