@continuum-js/dom 0.3.0 → 0.3.1

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export declare function scope<T>(fn: () => T): {
 };
 /** Register a cleanup in the current owner (no-op outside any owner). */
 export declare function onCleanup(fn: () => void): void;
+/** Anything placeable in JSX: nodes, behaviors (live-bound), primitives, arrays. */
 export type Child = Node | Behavior<unknown> | string | number | boolean | null | undefined | Child[];
 type Props = Record<string, unknown> | null;
 /** Fragment marker for `--jsxFragmentFactory Fragment`. */
@@ -21,10 +22,12 @@ export declare function h(tag: string | Component | typeof Fragment, props: Prop
 export declare function dyn<T>(b: Behavior<T>, render: (v: T) => Child): Node;
 /** Keyed list: reuses rows by key, reorders with minimal moves (LIS). */
 export declare function each<T, K>(items: Behavior<T[]>, key: (item: T) => K, render: (item: T) => Child): Node;
+/** A context handle: identity plus the value used when nothing was provided. */
 export interface Context<T> {
     readonly id: symbol;
     readonly defaultValue: T;
 }
+/** Create a context. Provide with `provide`, read with `use`. */
 export declare function createContext<T>(defaultValue: T): Context<T>;
 /** Write a context value into the current owner. */
 export declare function provide<T>(ctx: Context<T>, value: T): void;

package/dist/index.js

@@ -276,12 +276,30 @@ export function dyn(b, render) {
     frag.appendChild(start);
     frag.appendChild(end);
     let current = null;
-    const update = (v) => {
+    // Level-triggered: render the behavior's CURRENT value, not the delivered
+    // occurrence. A listener that runs earlier in the post phase may re-enter
+    // with a new moment (e.g. a router redirect); the stale queued delivery
+    // then must not clobber the newer render. Deduping by Object.is also makes
+    // duplicate deliveries free.
+    let hasRendered = false;
+    let renderedValue;
+    const update = () => {
+        const v = b.sampleNoTrans();
+        if (hasRendered && Object.is(renderedValue, v))
+            return;
+        hasRendered = true;
+        renderedValue = v;
         if (current) {
             current.dispose();
-            for (const n of current.nodes)
-                if (n.parentNode)
-                    n.parentNode.removeChild(n);
+            // Sweep the whole live range between the markers: a nested dynamic
+            // region at the root of this one may have swapped nodes since build,
+            // so the recorded node list can be stale.
+            let n = start.nextSibling;
+            while (n && n !== end) {
+                const next = n.nextSibling;
+                n.parentNode?.removeChild(n);
+                n = next;
+            }
         }
         current = buildScoped(owner, () => render(v));
         const parent = end.parentNode;
@@ -386,6 +404,7 @@ export function each(items, key, render) {
     });
     return frag;
 }
+/** Create a context. Provide with `provide`, read with `use`. */
 export function createContext(defaultValue) {
     return { id: Symbol("context"), defaultValue };
 }
@@ -480,6 +499,14 @@ export function animationFrames() {
 }
 // ---------------------------------------------------------------------------
 // Control-flow components — JSX wrappers over the rendering helpers.
+//
+// The function/component pairing is a deliberate symmetry, not duplication:
+//   when(b, then, else)  ↔  <Show when={b}>       — conditional region
+//   dyn(b, render)       ↔  <Dynamic of={b}>      — switching subtree
+//   each(b, by, render)  ↔  <Each of={b} by={..}> — keyed list
+//   portal(target, ch)   ↔  <Portal mount={..}>   — render elsewhere
+// Functions compose in plain code (no JSX required); components read better
+// inside markup. Both call the same implementation.
 // ---------------------------------------------------------------------------
 // JSX always delivers children as the rest array; a single render function
 // arrives as `[fn]`. Normalize to a render callback.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@continuum-js/dom",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Continuum DOM renderer — fine-grained bindings, dynamic regions, ownership, context",
   "license": "MIT",
   "repository": {
@@ -38,6 +38,6 @@
     "access": "public"
   },
   "dependencies": {
-    "@continuum-js/frp": "0.3.0"
+    "@continuum-js/frp": "0.3.1"
   }
 }