ajo 0.1.27 → 0.1.28

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./context.cjs"),y=Symbol.for("ajo.key"),h=Symbol.for("ajo.memo"),b=Symbol.for("ajo.ref"),p=Symbol.for("ajo.cache"),c=Symbol.for("ajo.generator"),l=Symbol.for("ajo.iterator"),m=Symbol.for("ajo.render"),a=Symbol.for("ajo.args"),v=t=>t.children,C=(t,e,...r)=>((e??={}).nodeName=t,!("children"in e)&&r.length&&(e.children=r.length==1?r[0]:r),e),f=(t,e)=>{let r=e.firstChild;for(t of g(t)){const n=E(t,e,r);r==null?e.appendChild(n):n==r?r=n.nextSibling:n==r.nextSibling?(e.appendChild(r),r=n.nextSibling):W(e,n,r)}for(;r;){const n=r.nextSibling;r.nodeType==1&&w(r),e.removeChild(r),r=n}},g=function*(t){if(t==null)return;const e=typeof t;if(e!="boolean")if(e=="string")yield t;else if(e=="number"||e=="bigint")yield String(t);else if(Symbol.iterator in t)for(t of t)yield*g(t);else"nodeName"in t?typeof t.nodeName=="function"?yield*N(t):yield t:yield String(t)},N=function*({nodeName:t,...e}){t.constructor.name=="GeneratorFunction"?yield k(t,e):yield*g(t(e))},k=function(t,e){const r={...t.attrs},n={...t.args};for(const s in e)s.startsWith("attr:")?r[s.slice(5)]=e[s]:s=="key"||s=="skip"||s=="memo"||s=="ref"||s.startsWith("set:")?r[s]=e[s]:n[s]=e[s];return{...r,nodeName:t.is??"div",[c]:t,[a]:n}},E=(t,e,r)=>typeof t=="string"?O(t,r):T(t,e,r),O=(t,e)=>{for(;e&&e.nodeType!=3;)e=e.nextSibling;return e?e.data!=t&&(e.data=t):e=document.createTextNode(t),e},T=({nodeName:t,children:e,key:r,skip:n,memo:s,ref:S,[c]:u,[a]:j,...x},A,i)=>{for(;i&&(i.localName!=t||i[y]!=null&&i[y]!=r||i[c]&&i[c]!=u);)i=i.nextSibling;return i??=document.createElementNS(x.xmlns??A.namespaceURI,t),r!=null&&(i[y]=r),(s==null||G(i[h],i[h]=s))&&(F(i[p]??R(i),i[p]=x,i),n||(u?B(u,j,i):f(e,i)),typeof S=="function"&&(i[b]=S)(i)),i},F=(t,e,r)=>{for(const n in{...t,...e})t[n]!==e[n]&&(n.startsWith("set:")?r[n.slice(4)]=e[n]:e[n]==null||e[n]===!1?r.removeAttribute(n):r.setAttribute(n,e[n]===!0?"":e[n]))},G=(t,e)=>Array.isArray(t)&&Array.isArray(e)?t.some((r,n)=>r!==e[n]):t!==e,R=t=>Array.from(t.attributes).reduce((e,r)=>(e[r.name]=r.value,e),{}),W=(t,e,r)=>{if(e.contains(document.activeElement)){const n=e.nextSibling;for(;r&&r!=e;){const s=r.nextSibling;t.insertBefore(r,n),r=s}}else t.insertBefore(e,r)},w=t=>{for(const e of t.children)w(e);typeof t.return=="function"&&t.return(),t[b]?.(null)},B=(t,e,r)=>{r[c]??=(I(r),t),Object.assign(r[a]??={},e),r[m]()},I=t=>{Object.assign(t,M),t[o.Context]=Object.create(o.current()?.[o.Context]??null)},M={[m](){const t=o.current();o.current(this);try{const{value:e,done:r}=(this[l]??=this[c].call(this,this[a])).next();f(e,this),this[b]?.(this),r&&this.return()}catch(e){this.throw(e)}finally{o.current(t)}},next(t){if(typeof t=="function")try{t.call(this,this[a])}catch(e){this.throw(e)}o.current()?.contains(this)||this[m]()},throw(t){for(let e=this;e;e=e.parentNode)if(typeof e[l]?.throw=="function")try{return f(e[l].throw(t).value,e)}catch(r){t=new Error(r instanceof Error?r.message:r,{cause:t})}throw t},return(){try{this[l]?.return()}catch(t){this.throw(t)}finally{this[l]=null}}};exports.Fragment=v;exports.h=C;exports.render=f;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./context.cjs"),y=Symbol.for("ajo.key"),j=Symbol.for("ajo.memo"),g=Symbol.for("ajo.ref"),p=Symbol.for("ajo.cache"),c=Symbol.for("ajo.generator"),a=Symbol.for("ajo.iterator"),b=Symbol.for("ajo.render"),f=Symbol.for("ajo.args"),N=t=>t.children,k=(t,e,...r)=>((e??={}).nodeName=t,!("children"in e)&&r.length&&(e.children=r.length==1?r[0]:r),e),l=(t,e,r=e.firstChild,i=null)=>{for(t of S(t)){const n=T(t,e,r);r==null?m(e,n,i):n==r?r=n.nextSibling:n==r.nextSibling?(m(e,r,i),r=n.nextSibling):m(e,n,r)}for(;r!=i;){const n=r.nextSibling;r.nodeType==1&&A(r),e.removeChild(r),r=n}},S=function*(t){if(t==null)return;const e=typeof t;if(e!="boolean")if(e=="string")yield t;else if(e=="number"||e=="bigint")yield String(t);else if(Symbol.iterator in t)for(t of t)yield*S(t);else"nodeName"in t?typeof t.nodeName=="function"?yield*E(t):yield t:yield String(t)},E=function*({nodeName:t,...e}){t.constructor.name=="GeneratorFunction"?yield O(t,e):yield*S(t(e))},O=function(t,e){const r={...t.attrs},i={...t.args};for(const n in e)n.startsWith("attr:")?r[n.slice(5)]=e[n]:n=="key"||n=="skip"||n=="memo"||n=="ref"||n.startsWith("set:")?r[n]=e[n]:i[n]=e[n];return{...r,nodeName:t.is??"div",[c]:t,[f]:i}},T=(t,e,r)=>typeof t=="string"?F(t,r):G(t,e,r),F=(t,e)=>{for(;e&&e.nodeType!=3;)e=e.nextSibling;return e?e.data!=t&&(e.data=t):e=document.createTextNode(t),e},G=({nodeName:t,children:e,key:r,skip:i,memo:n,ref:x,[c]:u,[f]:v,...w},C,s)=>{for(;s&&(s.localName!=t||s[y]!=null&&s[y]!=r||s[c]&&s[c]!=u);)s=s.nextSibling;return s??=document.createElementNS(w.xmlns??C.namespaceURI,t),r!=null&&(s[y]=r),(n==null||W(s[j],s[j]=n))&&(R(s[p]??B(s),s[p]=w,s),i||(u?I(u,v,s):l(e,s)),typeof x=="function"&&(s[g]=x)(s)),s},R=(t,e,r)=>{for(const i in{...t,...e})t[i]!==e[i]&&(i.startsWith("set:")?r[i.slice(4)]=e[i]:e[i]==null||e[i]===!1?r.removeAttribute(i):r.setAttribute(i,e[i]===!0?"":e[i]))},W=(t,e)=>Array.isArray(t)&&Array.isArray(e)?t.some((r,i)=>r!==e[i]):t!==e,B=t=>Array.from(t.attributes).reduce((e,r)=>(e[r.name]=r.value,e),{}),m=(t,e,r)=>{if(e.contains(document.activeElement)){const i=e.nextSibling;for(;r&&r!=e;){const n=r.nextSibling;t.insertBefore(r,i),r=n}}else t.insertBefore(e,r)},A=t=>{for(const e of t.children)A(e);typeof t.return=="function"&&t.return(),t[g]?.(null)},I=(t,e,r)=>{r[c]??=(M(r),t),Object.assign(r[f]??={},e),r[b]()},M=t=>{Object.assign(t,h),t[o.Context]=Object.create(o.current()?.[o.Context]??null)},h={[b](){const t=o.current();o.current(this);try{const{value:e,done:r}=(this[a]??=this[c].call(this,this[f])).next();l(e,this),this[g]?.(this),r&&this.return()}catch(e){this.throw(e)}finally{o.current(t)}},next(t){if(typeof t=="function")try{t.call(this,this[f])}catch(e){this.throw(e)}o.current()?.contains(this)||this[b]()},throw(t){for(let e=this;e;e=e.parentNode)if(typeof e[a]?.throw=="function")try{return l(e[a].throw(t).value,e)}catch(r){t=new Error(r instanceof Error?r.message:r,{cause:t})}throw t},return(){try{this[a]?.return()}catch(t){this.throw(t)}finally{this[a]=null}}};exports.Fragment=N;exports.h=k;exports.render=l;

package/dist/index.js

@@ -1,94 +1,93 @@
-import { Context as h, current as l } from "./context.js";
-const u = Symbol.for("ajo.key"), p = Symbol.for("ajo.memo"), b = Symbol.for("ajo.ref"), w = Symbol.for("ajo.cache"), o = Symbol.for("ajo.generator"), c = Symbol.for("ajo.iterator"), y = Symbol.for("ajo.render"), a = Symbol.for("ajo.args"), M = (t) => t.children, U = (t, e, ...r) => ((e ??= {}).nodeName = t, !("children" in e) && r.length && (e.children = r.length == 1 ? r[0] : r), e), m = (t, e) => {
-  let r = e.firstChild;
-  for (t of g(t)) {
-    const i = k(t, e, r);
-    r == null ? e.appendChild(i) : i == r ? r = i.nextSibling : i == r.nextSibling ? (e.appendChild(r), r = i.nextSibling) : W(e, i, r);
+import { Context as j, current as f } from "./context.js";
+const u = Symbol.for("ajo.key"), p = Symbol.for("ajo.memo"), g = Symbol.for("ajo.ref"), A = Symbol.for("ajo.cache"), o = Symbol.for("ajo.generator"), a = Symbol.for("ajo.iterator"), m = Symbol.for("ajo.render"), c = Symbol.for("ajo.args"), U = (t) => t.children, h = (t, r, ...e) => ((r ??= {}).nodeName = t, !("children" in r) && e.length && (r.children = e.length == 1 ? e[0] : e), r), b = (t, r, e = r.firstChild, i = null) => {
+  for (t of S(t)) {
+    const n = G(t, r, e);
+    e == null ? y(r, n, i) : n == e ? e = n.nextSibling : n == e.nextSibling ? (y(r, e, i), e = n.nextSibling) : y(r, n, e);
   }
-  for (; r; ) {
-    const i = r.nextSibling;
-    r.nodeType == 1 && j(r), e.removeChild(r), r = i;
+  for (; e != i; ) {
+    const n = e.nextSibling;
+    e.nodeType == 1 && v(e), r.removeChild(e), e = n;
   }
-}, g = function* (t) {
+}, S = function* (t) {
   if (t == null) return;
-  const e = typeof t;
-  if (e != "boolean")
-    if (e == "string") yield t;
-    else if (e == "number" || e == "bigint") yield String(t);
-    else if (Symbol.iterator in t) for (t of t) yield* g(t);
+  const r = typeof t;
+  if (r != "boolean")
+    if (r == "string") yield t;
+    else if (r == "number" || r == "bigint") yield String(t);
+    else if (Symbol.iterator in t) for (t of t) yield* S(t);
     else "nodeName" in t ? typeof t.nodeName == "function" ? yield* C(t) : yield t : yield String(t);
-}, C = function* ({ nodeName: t, ...e }) {
-  t.constructor.name == "GeneratorFunction" ? yield N(t, e) : yield* g(t(e));
-}, N = function(t, e) {
-  const r = { ...t.attrs }, i = { ...t.args };
-  for (const s in e)
-    s.startsWith("attr:") ? r[s.slice(5)] = e[s] : s == "key" || s == "skip" || s == "memo" || s == "ref" || s.startsWith("set:") ? r[s] = e[s] : i[s] = e[s];
-  return { ...r, nodeName: t.is ?? "div", [o]: t, [a]: i };
-}, k = (t, e, r) => typeof t == "string" ? E(t, r) : G(t, e, r), E = (t, e) => {
-  for (; e && e.nodeType != 3; ) e = e.nextSibling;
-  return e ? e.data != t && (e.data = t) : e = document.createTextNode(t), e;
-}, G = ({ nodeName: t, children: e, key: r, skip: i, memo: s, ref: S, [o]: f, [a]: A, ...x }, v, n) => {
-  for (; n && (n.localName != t || n[u] != null && n[u] != r || n[o] && n[o] != f); ) n = n.nextSibling;
-  return n ??= document.createElementNS(x.xmlns ?? v.namespaceURI, t), r != null && (n[u] = r), (s == null || R(n[p], n[p] = s)) && (O(n[w] ?? T(n), n[w] = x, n), i || (f ? B(f, A, n) : m(e, n)), typeof S == "function" && (n[b] = S)(n)), n;
-}, O = (t, e, r) => {
-  for (const i in { ...t, ...e })
-    t[i] !== e[i] && (i.startsWith("set:") ? r[i.slice(4)] = e[i] : e[i] == null || e[i] === !1 ? r.removeAttribute(i) : r.setAttribute(i, e[i] === !0 ? "" : e[i]));
-}, R = (t, e) => Array.isArray(t) && Array.isArray(e) ? t.some((r, i) => r !== e[i]) : t !== e, T = (t) => Array.from(t.attributes).reduce((e, r) => (e[r.name] = r.value, e), {}), W = (t, e, r) => {
-  if (e.contains(document.activeElement)) {
-    const i = e.nextSibling;
-    for (; r && r != e; ) {
-      const s = r.nextSibling;
-      t.insertBefore(r, i), r = s;
+}, C = function* ({ nodeName: t, ...r }) {
+  t.constructor.name == "GeneratorFunction" ? yield E(t, r) : yield* S(t(r));
+}, E = function(t, r) {
+  const e = { ...t.attrs }, i = { ...t.args };
+  for (const n in r)
+    n.startsWith("attr:") ? e[n.slice(5)] = r[n] : n == "key" || n == "skip" || n == "memo" || n == "ref" || n.startsWith("set:") ? e[n] = r[n] : i[n] = r[n];
+  return { ...e, nodeName: t.is ?? "div", [o]: t, [c]: i };
+}, G = (t, r, e) => typeof t == "string" ? O(t, e) : R(t, r, e), O = (t, r) => {
+  for (; r && r.nodeType != 3; ) r = r.nextSibling;
+  return r ? r.data != t && (r.data = t) : r = document.createTextNode(t), r;
+}, R = ({ nodeName: t, children: r, key: e, skip: i, memo: n, ref: x, [o]: l, [c]: N, ...w }, k, s) => {
+  for (; s && (s.localName != t || s[u] != null && s[u] != e || s[o] && s[o] != l); ) s = s.nextSibling;
+  return s ??= document.createElementNS(w.xmlns ?? k.namespaceURI, t), e != null && (s[u] = e), (n == null || W(s[p], s[p] = n)) && (T(s[A] ?? B(s), s[A] = w, s), i || (l ? F(l, N, s) : b(r, s)), typeof x == "function" && (s[g] = x)(s)), s;
+}, T = (t, r, e) => {
+  for (const i in { ...t, ...r })
+    t[i] !== r[i] && (i.startsWith("set:") ? e[i.slice(4)] = r[i] : r[i] == null || r[i] === !1 ? e.removeAttribute(i) : e.setAttribute(i, r[i] === !0 ? "" : r[i]));
+}, W = (t, r) => Array.isArray(t) && Array.isArray(r) ? t.some((e, i) => e !== r[i]) : t !== r, B = (t) => Array.from(t.attributes).reduce((r, e) => (r[e.name] = e.value, r), {}), y = (t, r, e) => {
+  if (r.contains(document.activeElement)) {
+    const i = r.nextSibling;
+    for (; e && e != r; ) {
+      const n = e.nextSibling;
+      t.insertBefore(e, i), e = n;
     }
-  } else t.insertBefore(e, r);
-}, j = (t) => {
-  for (const e of t.children) j(e);
-  typeof t.return == "function" && t.return(), t[b]?.(null);
-}, B = (t, e, r) => {
-  r[o] ??= (F(r), t), Object.assign(r[a] ??= {}, e), r[y]();
-}, F = (t) => {
-  Object.assign(t, I), t[h] = Object.create(l()?.[h] ?? null);
-}, I = {
-  [y]() {
-    const t = l();
-    l(this);
+  } else t.insertBefore(r, e);
+}, v = (t) => {
+  for (const r of t.children) v(r);
+  typeof t.return == "function" && t.return(), t[g]?.(null);
+}, F = (t, r, e) => {
+  e[o] ??= (I(e), t), Object.assign(e[c] ??= {}, r), e[m]();
+}, I = (t) => {
+  Object.assign(t, K), t[j] = Object.create(f()?.[j] ?? null);
+}, K = {
+  [m]() {
+    const t = f();
+    f(this);
     try {
-      const { value: e, done: r } = (this[c] ??= this[o].call(this, this[a])).next();
-      m(e, this), this[b]?.(this), r && this.return();
-    } catch (e) {
-      this.throw(e);
+      const { value: r, done: e } = (this[a] ??= this[o].call(this, this[c])).next();
+      b(r, this), this[g]?.(this), e && this.return();
+    } catch (r) {
+      this.throw(r);
     } finally {
-      l(t);
+      f(t);
     }
   },
   next(t) {
     if (typeof t == "function") try {
-      t.call(this, this[a]);
-    } catch (e) {
-      this.throw(e);
+      t.call(this, this[c]);
+    } catch (r) {
+      this.throw(r);
     }
-    l()?.contains(this) || this[y]();
+    f()?.contains(this) || this[m]();
   },
   throw(t) {
-    for (let e = this; e; e = e.parentNode) if (typeof e[c]?.throw == "function") try {
-      return m(e[c].throw(t).value, e);
-    } catch (r) {
-      t = new Error(r instanceof Error ? r.message : r, { cause: t });
+    for (let r = this; r; r = r.parentNode) if (typeof r[a]?.throw == "function") try {
+      return b(r[a].throw(t).value, r);
+    } catch (e) {
+      t = new Error(e instanceof Error ? e.message : e, { cause: t });
     }
     throw t;
   },
   return() {
     try {
-      this[c]?.return();
+      this[a]?.return();
     } catch (t) {
       this.throw(t);
     } finally {
-      this[c] = null;
+      this[a] = null;
     }
   }
 };
 export {
-  M as Fragment,
-  U as h,
-  m as render
+  U as Fragment,
+  h,
+  b as render
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ajo",
-  "version": "0.1.27",
+  "version": "0.1.28",
   "description": "ajo is a JavaScript view library for building user interfaces",
   "type": "module",
   "types": "./types.ts",
@@ -33,11 +33,11 @@
     "types.ts"
   ],
   "devDependencies": {
-    "@types/node": "24.3.0",
-    "happy-dom": "18.0.1",
-    "vite": "7.1.4",
+    "@types/node": "24.10.1",
+    "happy-dom": "20.0.11",
+    "vite": "7.2.4",
     "vite-tsconfig-paths": "5.1.4",
-    "vitest": "3.2.4"
+    "vitest": "4.0.14"
   },
   "keywords": [
     "ui",

package/readme.md

@@ -148,7 +148,7 @@ function* MapComponent(args) {
           new GoogleMap(el, args.config)
         }
       }}
-      skip={true}
+      skip
     >
       {/* Google Maps API manages children elements */}
     </div>
@@ -183,13 +183,17 @@ for await (const chunk of stream(<App />)) response.write(chunk)
 
 ### Core Module (`ajo`)
 
-#### `render(children: Children, container: Element): void`
-Renders JSX into a DOM container element.
+#### `render(children: Children, container: Element, child?: ChildNode, ref?: ChildNode): void`
+Renders JSX into a DOM container element. When `child` and `ref` are provided, only nodes between them (inclusive of `child`, exclusive of `ref`) are reconciled, leaving the rest of the container untouched.
 
 ```javascript
 import { render } from 'ajo'
 
 render(<App />, document.getElementById('root'))
+
+// Update only the <main> region without touching header/footer
+const container = document.body
+render(<main>Updated</main>, container, container.querySelector('main'), container.querySelector('footer'))
 ```
 
 #### `h(type: Type, props?: Props, ...children: Children[]): VNode`

package/types.ts

@@ -2,9 +2,9 @@ declare module 'ajo' {
 
 	type Tag = keyof (HTMLElementTagNameMap & SVGElementTagNameMap)
 
-	type Type = Tag | Stateless | Stateful
+	type Type<TArguments extends Props = {}, TTag extends Tag = 'div'> = Tag | Stateless<TArguments> | Stateful<TArguments, TTag>
 
-	type Component<TProps extends Props = {}> = Stateless<TProps> | Stateful<TProps>
+	type Component<TArguments extends Props = {}> = Stateless<TArguments> | Stateful<TArguments>
 
 	type Props = Record<string, unknown>
 
@@ -61,11 +61,12 @@ declare module 'ajo' {
 
 	function Fragment({ children }: ElementChildrenAttribute): typeof children
 	function h(tag: Type, props?: Props | null, ...children: Children[]): VNode<Type, Props>
-	function render(h: Children, el: Element, child?: Node, ref?: Node): void
+	function render(h: Children, el: ParentNode, child?: ChildNode, ref?: ChildNode): void
 }
 
 declare module 'ajo/context' {
 	function context<T>(fallback?: T): (value?: T) => T
+	function current(): import('ajo').Stateful | null
 }
 
 declare module 'ajo/html' {