tutuca 0.13.3 → 0.15.0

package/dist/tutuca-cli.js

@@ -1039,8 +1039,68 @@ var init_immer2 = __esm({
 });
 
 // src/path.js
-function warnRawDynStep(op, step) {
-  console.warn(`Path.${op} reached a DynStep: call toTransactionPath() first`, step);
+function stepToJson(step) {
+  if (step instanceof SeqStep) return { f: step.field, k: step.key };
+  if (step instanceof FieldStep) return { f: step.field };
+  if (step instanceof SeqAccessStep) return { f: step.seqField, a: step.keyField };
+  return null;
+}
+function stepFromJson(j) {
+  if (j == null || typeof j.f !== "string") return null;
+  if (j.k !== void 0) return new SeqStep(j.f, j.k);
+  if (j.a !== void 0) return new SeqAccessStep(j.f, j.a);
+  return new FieldStep(j.f);
+}
+function pathToJson(path) {
+  const out = [];
+  for (const step of path.steps) {
+    const j = stepToJson(step);
+    if (j === null) return null;
+    out.push(j);
+  }
+  return out;
+}
+function pathFromJson(j) {
+  if (!Array.isArray(j)) return null;
+  const steps = [];
+  for (const item of j) {
+    const step = stepFromJson(item);
+    if (step === null) return null;
+    steps.push(step);
+  }
+  return new Path(steps);
+}
+function walkItems(stack, items, renderPath, path) {
+  let prev = stack.it;
+  for (const step of items) {
+    const next = step.lookup(prev);
+    if (next === NONE) {
+      console.warn("bad PathItem", { root: stack.it, step, path });
+      return null;
+    }
+    renderPath = renderPath.pushItem(step);
+    stack = step.enterFrame(stack, next, renderPath);
+    prev = next;
+  }
+  return [stack, renderPath];
+}
+function keyedPath(path, key) {
+  const steps = path.steps;
+  const last = steps[steps.length - 1];
+  if (last instanceof SeqStep || last instanceof FieldStep)
+    return new Path(steps.slice(0, -1).concat(new SeqStep(last.field, key)));
+  return null;
+}
+function renderPathText(path) {
+  return JSON.stringify(pathToJson(path));
+}
+function parseRenderPath(text) {
+  try {
+    return pathFromJson(JSON.parse(text));
+  } catch (err) {
+    console.warn("bad render path", err, text);
+    return null;
+  }
 }
 function metaChain(n) {
   const out = [];
@@ -1061,26 +1121,23 @@ function findHandlers(comp, eventIds, vid, eventName) {
   }
   return null;
 }
-function resolvePathStep(comp, nodeIds, vid) {
-  for (let i = 0; i < nodeIds.length; i++) {
-    const ctx = new StepCtx(comp, nodeIds, i, vid);
-    const step = ctx.resolveNode().toPathStep(ctx);
-    if (step !== null) return step;
+function resolvePathPart(comp, nodeRefs, vid) {
+  for (let i = 0; i < nodeRefs.length; i++) {
+    const ref = nodeRefs[i];
+    if (ref.base != null) return { base: ref.base };
+    if (ref.nid === void 0 || ref.nid === null) continue;
+    const ctx = new StepCtx(comp, nodeRefs, i, vid);
+    const step = ctx.resolveNode()?.toPathStep(ctx) ?? null;
+    if (step !== null) return { step };
   }
   return null;
 }
-var NONE, readKey, writeKey, writeSeqKey, Step, BindStep, ScopeBindStep, FieldStep, SeqStep, SeqAccessStep, EachBindStep, EachRenderItStep, DynStep, DynEachStep, Path, StepCtx, NO_EVENT_INFO, BUBBLING_EVENTS, PathBuilder;
+var NONE, writeKey, writeSeqKey, Step, BindStep, ScopeBindStep, FieldStep, SeqStep, SeqAccessStep, EachBindStep, EachRenderItStep, Path, EMPTY_PATH, DispatchPath, StepCtx, NO_EVENT_INFO, BUBBLING_EVENTS, PathBuilder;
 var init_path = __esm({
   "src/path.js"() {
     init_collection();
     init_immer2();
     NONE = /* @__PURE__ */ Symbol("NONE");
-    readKey = (value, key, dval = null) => {
-      if (value == null) return dval;
-      if (value instanceof Map) return value.has(key) ? value.get(key) : dval;
-      if (value instanceof Set) return value.has(key) ? key : dval;
-      return Object.hasOwn(value, key) ? value[key] : dval;
-    };
     writeKey = (value, key, next) => {
       if (value instanceof Map) value.set(key, next);
       else if (value instanceof Set) {
@@ -1088,20 +1145,15 @@ var init_path = __esm({
         value.add(next);
       } else value[key] = next;
     };
-    writeSeqKey = (value, key, next) => {
-      if (value instanceof Map || value instanceof Set || Array.isArray(value) || Object.hasOwn(value, key))
-        writeKey(value, key, next);
-      else if (typeof value?.set === "function") value.set(key, next);
-      else writeKey(value, key, next);
-    };
+    writeSeqKey = (value, key, next) => !(value instanceof Map || value instanceof Set || Array.isArray(value)) && !Object.hasOwn(value, key) && typeof value?.set === "function" ? value.set(key, next) : writeKey(value, key, next);
     Step = class {
-      lookup(_v, dval = null) {
-        return dval;
-      }
       setDraftValue(_root, _v) {
       }
-      enterFrame(stack, next) {
-        return stack.enter(next, {}, true);
+      // Re-enter this step while rebuilding a stack. `renderPath` is the dispatch
+      // position AFTER this step: a rebuilt frame must carry the same render path
+      // the renderer had there, or the provides it publishes would be located wrong.
+      enterFrame(stack, next, renderPath) {
+        return stack.enter(next, {}, true, renderPath);
       }
       toAbstractPathStep() {
         return this;
@@ -1118,41 +1170,29 @@ var init_path = __esm({
         return null;
       }
     };
-    BindStep = class _BindStep extends Step {
+    BindStep = class extends Step {
       constructor(binds) {
         super();
         this.binds = binds;
       }
-      lookup(v, _dval) {
+      lookup(v) {
         return v;
       }
-      enterFrame(stack, next) {
-        return stack.enter(next, { ...this.binds }, false);
-      }
-      withIndex(i) {
-        return new _BindStep({ ...this.binds, key: i });
-      }
-      withKey(key) {
-        return new _BindStep({ ...this.binds, key });
+      enterFrame(stack, next, renderPath) {
+        return stack.enter(next, { ...this.binds }, false, renderPath);
       }
       toAbstractPathStep() {
         return null;
       }
     };
-    ScopeBindStep = class _ScopeBindStep extends BindStep {
+    ScopeBindStep = class extends BindStep {
       constructor(val, binds = {}) {
         super(binds);
         this.val = val;
       }
-      enterFrame(stack, next) {
+      enterFrame(stack, next, renderPath) {
         const dyn = this.val.evalAsHandler(stack)?.call(stack.it) ?? {};
-        return stack.enter(next, { ...this.binds, ...dyn }, false);
-      }
-      withIndex(i) {
-        return new _ScopeBindStep(this.val, { ...this.binds, key: i });
-      }
-      withKey(key) {
-        return new _ScopeBindStep(this.val, { ...this.binds, key });
+        return stack.enter(next, { ...this.binds, ...dyn }, false, renderPath);
       }
     };
     FieldStep = class extends Step {
@@ -1160,18 +1200,12 @@ var init_path = __esm({
         super();
         this.field = field;
       }
-      lookup(v, dval = null) {
-        return readKey(v, this.field, dval);
+      lookup(v) {
+        return seqGet(v, this.field, NONE);
       }
       setDraftValue(root, v) {
         writeKey(root, this.field, v);
       }
-      withIndex(i) {
-        return new SeqStep(this.field, i);
-      }
-      withKey(k) {
-        return new SeqStep(this.field, k);
-      }
       toKey() {
         return { field: this.field };
       }
@@ -1182,15 +1216,15 @@ var init_path = __esm({
         this.field = field;
         this.key = key;
       }
-      lookup(v, dval = null) {
-        return seqGet(readKey(v, this.field, null), this.key, dval);
+      lookup(v) {
+        return seqGet(seqGet(v, this.field, null), this.key, NONE);
       }
       setDraftValue(root, v) {
-        const seq = readKey(root, this.field, null);
+        const seq = seqGet(root, this.field, null);
         if (seq != null) writeSeqKey(seq, this.key, v);
       }
-      enterFrame(stack, next) {
-        return stack.enter(next, { key: this.key }, true);
+      enterFrame(stack, next, renderPath) {
+        return stack.enter(next, { key: this.key }, true, renderPath);
       }
       toKey() {
         return { field: this.field, key: this.key };
@@ -1202,20 +1236,20 @@ var init_path = __esm({
         this.seqField = seqField;
         this.keyField = keyField;
       }
-      lookup(v, dval = null) {
-        const seq = readKey(v, this.seqField, NONE);
-        const key = readKey(v, this.keyField, NONE);
-        return key !== NONE && seq !== NONE ? seqGet(seq, key, dval) : dval;
+      lookup(v) {
+        const seq = seqGet(v, this.seqField, NONE);
+        const key = seqGet(v, this.keyField, NONE);
+        return key !== NONE && seq !== NONE ? seqGet(seq, key, NONE) : NONE;
       }
       setDraftValue(root, v) {
-        const seq = readKey(root, this.seqField, NONE);
-        const key = readKey(root, this.keyField, NONE);
+        const seq = seqGet(root, this.seqField, NONE);
+        const key = seqGet(root, this.keyField, NONE);
         if (seq !== NONE && key !== NONE) writeSeqKey(seq, key, v);
       }
       // Resolve `keyField` against `v` now and freeze it as a literal-key `SeqStep`, so a
       // later lookup/setValue lands on this same item even if `keyField` changes meanwhile.
       pinKey(v) {
-        const key = readKey(v, this.keyField, NONE);
+        const key = seqGet(v, this.keyField, NONE);
         return key === NONE ? this : new SeqStep(this.seqField, key);
       }
       // The key is a *field reference* resolved live, so it is unknown without a value;
@@ -1226,67 +1260,31 @@ var init_path = __esm({
       }
     };
     EachBindStep = class extends Step {
-      constructor(iterInfo, key) {
+      constructor(eachNode, key) {
         super();
-        this.iterInfo = iterInfo;
+        this.eachNode = eachNode;
         this.key = key;
       }
-      lookup(v, _dval) {
+      lookup(v) {
         return v;
       }
       // Replay the renderer's per-item binds (key, value + any @enrich-with binds)
       // so a rebuilt stack matches the one @each rendered with.
-      enterFrame(stack, next) {
-        return stack.enter(next, this.iterInfo.enrichBinds(stack, this.key), false);
+      enterFrame(stack, next, renderPath) {
+        return stack.enter(next, this.eachNode.enrichBinds(stack, this.key), false, renderPath);
       }
       toAbstractPathStep() {
         return null;
       }
     };
     EachRenderItStep = class extends SeqStep {
-      enterFrame(stack, next) {
-        return stack.enter(next, { key: this.key, value: next }, false).enter(next, {}, true);
+      enterFrame(stack, next, renderPath) {
+        return stack.enter(next, { key: this.key, value: next }, false, renderPath).enter(next, {}, true, renderPath);
       }
       toAbstractPathStep() {
         return new SeqStep(this.field, this.key);
       }
     };
-    DynStep = class extends Step {
-      constructor(producerCompId, producerSteps) {
-        super();
-        this.producerCompId = producerCompId;
-        this.producerSteps = producerSteps;
-        this.interiorCids = /* @__PURE__ */ new Set();
-      }
-      // Steps spliced into the transaction path in place of this marker.
-      teleportSteps() {
-        return this.producerSteps;
-      }
-      lookup(_v, dval = null) {
-        warnRawDynStep("lookup", this);
-        return dval;
-      }
-      enterFrame(stack, _next) {
-        warnRawDynStep("enterFrame", this);
-        return stack;
-      }
-    };
-    DynEachStep = class extends DynStep {
-      constructor(producerCompId, producerSteps, key) {
-        super(producerCompId, producerSteps);
-        this.key = key;
-      }
-      teleportSteps() {
-        const { producerSteps, key } = this;
-        if (producerSteps.length === 0) return producerSteps;
-        const last = producerSteps[producerSteps.length - 1];
-        if (!(last instanceof FieldStep)) {
-          console.warn("DynEachStep: seq-access dynamic cannot be iterated", this);
-          return producerSteps;
-        }
-        return producerSteps.slice(0, -1).concat(new SeqStep(last.field, key));
-      }
-    };
     Path = class _Path {
       constructor(steps = []) {
         this.steps = steps;
@@ -1294,43 +1292,13 @@ var init_path = __esm({
       concat(steps) {
         return new _Path(this.steps.concat(steps));
       }
-      popStep() {
-        return new _Path(this.steps.slice(0, -1));
-      }
-      // The dispatch path: frame-only steps removed, one step per crossed component
-      // (DynStep included). `popStep` over it bubbles through every component.
+      // Frame-only steps removed, one step per crossed component: `popStep` over the
+      // result bubbles through every component.
       compact() {
         const out = [];
         for (const step of this.steps) {
           const s = step.toAbstractPathStep();
-          if (s !== null) {
-            if (s !== step) s._originCid = step._originCid;
-            out.push(s);
-          }
-        }
-        return new _Path(out);
-      }
-      // The abstract path used to apply a transaction: every DynStep is teleported —
-      // the steps interior to its producer..consumer span are dropped and the
-      // producer's own path spliced in — so a mutation lands on the data's real
-      // location. A path with no DynStep is returned unchanged.
-      toTransactionPath() {
-        let hasDyn = false;
-        for (const step of this.steps)
-          if (step instanceof DynStep) {
-            hasDyn = true;
-            break;
-          }
-        if (!hasDyn) return this;
-        const out = [];
-        for (const step of this.steps) {
-          if (step instanceof DynStep) {
-            while (out.length > 0 && step.interiorCids.has(out[out.length - 1]._originCid)) out.pop();
-            for (const ts of step.teleportSteps()) {
-              ts._originCid = step.producerCompId;
-              out.push(ts);
-            }
-          } else out.push(step);
+          if (s !== null) out.push(s);
         }
         return new _Path(out);
       }
@@ -1338,7 +1306,6 @@ var init_path = __esm({
       // key as it is *now* so a later lookup/setValue lands on the same item even if the
       // keyField changed meanwhile (e.g. the selected tab moved while an intent was in
       // flight). Returns a new Path with those steps replaced; `this` if nothing pinned.
-      // Must be called on a transaction path (no DynSteps — call toTransactionPath first).
       pinKeys(root) {
         let curVal = root;
         let out = null;
@@ -1346,7 +1313,7 @@ var init_path = __esm({
           const step = this.steps[i];
           const pinned = step.pinKey(curVal);
           if (pinned !== step) (out ??= this.steps.slice())[i] = pinned;
-          curVal = step.lookup(curVal, NONE);
+          curVal = step.lookup(curVal);
           if (curVal === NONE) break;
         }
         return out ? new _Path(out) : this;
@@ -1354,20 +1321,20 @@ var init_path = __esm({
       lookup(v, dval = null) {
         let curVal = v;
         for (const step of this.steps) {
-          curVal = step.lookup(curVal, NONE);
+          curVal = step.lookup(curVal);
           if (curVal === NONE) return dval;
         }
         return curVal;
       }
       // The values entered along the path, root→leaf (root included): index 0 is `root`,
       // the last entry is the leaf this path resolves to. Stops early at the first
-      // unresolvable step. Call on a transaction path (no DynSteps). Used to walk the
-      // component instances on a dispatch path (filter via Components.getCompFor).
+      // unresolvable step. Used to walk the component instances on a dispatch path
+      // (filter via Components.getCompFor).
       resolveChain(root) {
         const out = [root];
         let curVal = root;
         for (const step of this.steps) {
-          curVal = step.lookup(curVal, NONE);
+          curVal = step.lookup(curVal);
           if (curVal === NONE) break;
           out.push(curVal);
         }
@@ -1376,7 +1343,7 @@ var init_path = __esm({
       // A flat `[{ field, key? }]` list of the addressing steps, skipping frame-only
       // steps (binds). Generic path introspection so tooling (e.g. the storybook
       // activity log) can identify which subtree a transaction touched without
-      // depending on Step internals. Call on a transaction path (no DynSteps).
+      // depending on Step internals.
       toKeys() {
         const out = [];
         for (const step of this.steps) {
@@ -1390,69 +1357,132 @@ var init_path = __esm({
         return produce(root, (draft) => {
           let parent = draft;
           for (let i = 0; i < this.steps.length - 1; i++) {
-            parent = this.steps[i].lookup(parent, NONE);
+            parent = this.steps[i].lookup(parent);
             if (parent === NONE) return;
           }
           this.steps.at(-1).setDraftValue(parent, v);
         });
       }
+    };
+    EMPTY_PATH = new Path([]);
+    DispatchPath = class _DispatchPath {
+      constructor(frames = [{ base: EMPTY_PATH, items: [] }]) {
+        this.frames = frames;
+      }
+      // Plain addressing steps in one frame based at the root: what a caller means
+      // by "this position" when it has no continuation of its own.
+      static ofSteps(steps) {
+        return new _DispatchPath([{ base: EMPTY_PATH, items: steps.slice() }]);
+      }
+      get top() {
+        return this.frames[this.frames.length - 1];
+      }
+      _withTopItems(items) {
+        const frames = this.frames.slice();
+        frames[frames.length - 1] = { base: this.top.base, items };
+        return new _DispatchPath(frames);
+      }
+      concat(steps) {
+        return this._withTopItems(this.top.items.concat(steps));
+      }
+      pushItem(step) {
+        return this.concat([step]);
+      }
+      pushFrame(base) {
+        return new _DispatchPath(this.frames.concat({ base, items: [] }));
+      }
+      // Whether bubbling has anywhere left to go: another step in this frame, or a
+      // visual caller underneath it. (A path always has at least one frame.)
+      canPop() {
+        return this.frames.length > 1 || this.frames[0].items.length > 0;
+      }
+      // One component closer to the root. At the top of a frame that is popping back
+      // to the visual caller, not to the producer's own parent — the caller is where
+      // the `*name` was written, and where an unhandled message should keep going.
+      popStep() {
+        const { top } = this;
+        if (top.items.length > 0) return this._withTopItems(top.items.slice(0, -1));
+        if (this.frames.length > 1) return new _DispatchPath(this.frames.slice(0, -1));
+        return this;
+      }
+      // Drop frame-only steps inside every frame independently; a frame's base is
+      // already addressing-only.
+      compact() {
+        return new _DispatchPath(
+          this.frames.map(({ base, items }) => ({ base, items: new Path(items).compact().steps }))
+        );
+      }
+      // A stable string for the ADDRESS this path denotes, for the render cache. The
+      // same immutable value can sit at two places in the tree, and a subtree rendered
+      // at one of them bakes that address in — the provides it publishes are located
+      // there. Frame-only steps address nothing, so they are compacted out: two sites
+      // that differ only in binds do render the same subtree.
+      get addressKey() {
+        this._addressKey ??= renderPathText(this.toTransactionPath().compact());
+        return this._addressKey;
+      }
+      // The active transaction address: the top frame's absolute base followed by
+      // its ordinary descendant steps. This is where a mutation lands.
+      toTransactionPath() {
+        const { base, items } = this.top;
+        return base.concat(items);
+      }
+      // Rebuild the render stack this path was dispatched from. A frame with a base
+      // re-enters at that absolute value first — replaying the resume a `*name`
+      // render performed — and then walks its ordinary items.
       buildStack(stack) {
-        let prev = stack.it;
-        for (const step of this.steps) {
-          const next = step.lookup(prev, NONE);
-          if (next === NONE) {
-            console.warn("bad PathItem", { root: stack.it, step, path: this });
-            return null;
+        let renderPath = new _DispatchPath();
+        for (let i = 0; i < this.frames.length; i++) {
+          const { base, items } = this.frames[i];
+          if (i > 0 || base.steps.length > 0) {
+            const baseValue = base.lookup(stack.root, NONE);
+            if (baseValue === NONE) {
+              console.warn("bad frame base", { base, path: this });
+              return null;
+            }
+            renderPath = renderPath.pushFrame(base);
+            stack = stack.enter(baseValue, {}, true, renderPath);
           }
-          stack = step.enterFrame(stack, next);
-          prev = next;
+          const walked = walkItems(stack, items, renderPath, this);
+          if (walked === null) return null;
+          [stack, renderPath] = walked;
         }
         return stack;
       }
-      static fromNodeAndEventName(node, eventName, rootNode, maxDepth, comps, stopOnNoEvent = true) {
-        const pathSteps = [];
-        const pendingDyns = [];
+      // Reconstruct the dispatch position of a DOM event from the `data-*` stamps and
+      // `§…§` meta comments the renderer left on the way down. `stopOnNoEvent` is off for
+      // drag events, whose path is needed even where no handler is registered.
+      static fromNodeAndEventName(node, eventName, rootNode, comps, stopOnNoEvent = true) {
+        const parts = [];
         const bubbles = BUBBLING_EVENTS.has(eventName);
-        let depth = 0;
         let eventIds = [];
         let handlers = null;
-        let nodeIds = [];
+        let nodeRefs = [];
         let isLeafComponent = true;
         const crossComponent = (cidNum, vid) => {
           const comp = comps.getComponentForId(cidNum);
-          let pushStep = true;
+          let pushPart = true;
           if (handlers === null && (isLeafComponent || bubbles)) {
             handlers = findHandlers(comp, eventIds, vid, eventName);
             if (handlers === null) {
               if (isLeafComponent && stopOnNoEvent && !bubbles) return false;
             } else if (!isLeafComponent) {
-              pathSteps.length = 0;
-              pendingDyns.length = 0;
-              pushStep = false;
+              parts.length = 0;
+              pushPart = false;
             }
           }
           isLeafComponent = false;
-          for (const dyn of pendingDyns) dyn.interiorCids.add(cidNum);
-          if (pushStep) {
-            const step = resolvePathStep(comp, nodeIds, vid);
-            if (step) {
-              step._originCid = cidNum;
-              pathSteps.push(step);
-              if (step instanceof DynStep) {
-                step.interiorCids.add(cidNum);
-                pendingDyns.push(step);
-              }
-            }
+          if (pushPart) {
+            const part = resolvePathPart(comp, nodeRefs, vid);
+            if (part) parts.push(part);
           }
-          for (let i = pendingDyns.length - 1; i >= 0; i--)
-            if (pendingDyns[i].producerCompId === cidNum) pendingDyns.splice(i, 1);
           eventIds = [];
-          nodeIds = [];
+          nodeRefs = [];
           return true;
         };
-        while (node && node !== rootNode && depth < maxDepth) {
+        while (node && node !== rootNode) {
           if (node?.dataset) {
-            const { eid, cid, vid } = node.dataset;
+            const { eid, cid, vid, rp } = node.dataset;
             if (eid !== void 0) eventIds.push(eid);
             const metas = metaChain(node.previousSibling);
             let sawComp = false;
@@ -1460,19 +1490,26 @@ var init_path = __esm({
               if (m.$ === "Comp") {
                 sawComp = true;
                 if (!crossComponent(m.cid, m.vid)) return NO_EVENT_INFO;
-                nodeIds.push({ nid: m.nid });
+                nodeRefs.push({ nid: m.nid, base: pathFromJson(m.base) });
               } else {
-                nodeIds.push({ nid: m.nid, si: m.si, sk: m.sk });
+                nodeRefs.push({ nid: m.nid, si: m.si, sk: m.sk });
+              }
+            }
+            if (!sawComp && cid !== void 0) {
+              if (!crossComponent(+cid, vid)) return NO_EVENT_INFO;
+              if (rp !== void 0) {
+                const base = parseRenderPath(rp);
+                if (base !== null) nodeRefs.push({ base });
               }
             }
-            if (!sawComp && cid !== void 0 && !crossComponent(+cid, vid)) return NO_EVENT_INFO;
           }
-          depth += 1;
           node = node.parentNode;
         }
-        if (pendingDyns.length > 0)
-          console.warn("event reconstruction: dynamic-var producer not found", pendingDyns);
-        return [new _Path(pathSteps.reverse()), handlers];
+        parts.reverse();
+        let path = new _DispatchPath();
+        for (const part of parts)
+          path = part.base !== void 0 ? path.pushFrame(part.base) : path.pushItem(part.step);
+        return [path, handlers];
       }
     };
     StepCtx = class _StepCtx {
@@ -1500,13 +1537,6 @@ var init_path = __esm({
       resolveNode() {
         return this.comp.getNodeForId(+this.meta.nid, this.vid);
       }
-      applyKey(pi) {
-        if (pi === null) return null;
-        const m = this.meta;
-        if (m.si !== void 0) return pi.withIndex(+m.si);
-        if (m.sk !== void 0) return pi.withKey(m.sk);
-        return pi;
-      }
     };
     NO_EVENT_INFO = [null, null];
     BUBBLING_EVENTS = /* @__PURE__ */ new Set(["drop"]);
@@ -1514,6 +1544,9 @@ var init_path = __esm({
       constructor() {
         this.pathChanges = [];
       }
+      toPath() {
+        return new Path(this.pathChanges);
+      }
       add(pathChange) {
         this.pathChanges.push(pathChange);
         return this;
@@ -1531,14 +1564,6 @@ var init_path = __esm({
   }
 });
 
-// src/util/env.js
-var isMac;
-var init_env = __esm({
-  "src/util/env.js"() {
-    isMac = (globalThis.navigator?.userAgent ?? "").toLowerCase().includes("mac");
-  }
-});
-
 // src/value.js
 function sizeOf(v) {
   if (v == null) return null;
@@ -1675,25 +1700,12 @@ function _parsePredicate(s, tokens, px) {
   }
   return new PredicateVal(pred, args);
 }
-function kindOf(val) {
-  if (val === null) return 0;
-  if (val instanceof ConstVal) return val.kind;
-  if (val instanceof StrTplVal) return val.kind;
-  if (val instanceof SeqAccessVal) return K_SEQ;
-  if (val instanceof FieldVal) return K_FIELD;
-  if (val instanceof MethodVal) return K_METHOD;
-  if (val instanceof BindVal) return K_BIND;
-  if (val instanceof DynVal) return K_DYN;
-  if (val instanceof NameVal) return K_NAME;
-  if (val instanceof EventMemberVal) return K_EVENT;
-  return 0;
-}
-var VALID_VAL_ID_RE, isValidValId, VALID_FLOAT_RE, STR_TPL_SPLIT_RE, mkVal, VAL_TOKEN_RE, tokenizeValue, unescapeStr, K_CONST, K_STRTPL, K_FIELD, K_BIND, K_DYN, K_NAME, K_SEQ, K_METHOD, K_EVENT, G_BOOL, G_TEXT, G_COMPONENT, G_SEQUENCE, G_PROVIDE, G_FIELD, G_VALUE, G_HANDLER_ARG, G_ALL, toNullIfNaN, predTruthy, PREDICATES, parseText, parseComponent, parseSequence, parseField, parseProvide, parseMacroAttr, parseReceiveHandler, parseAlterHandler, BaseVal, ConstVal, NULL_CONST_VAL, PredicateVal, VarVal, StrTplVal, NameVal, HandlerNameVal, mk404Handler, keyIs, macCtrl, nullSafe, EVENT_CONVENIENCES, EventMemberVal, RenderVal, RenderNameVal, BindVal, BindMemberVal, DynVal, FieldVal, MethodVal, SeqAccessVal;
+var isMac, VALID_VAL_ID_RE, isValidValId, VALID_FLOAT_RE, STR_TPL_SPLIT_RE, mkVal, VAL_TOKEN_RE, tokenizeValue, unescapeStr, K_CONST, K_STRTPL, K_FIELD, K_BIND, K_DYN, K_NAME, K_SEQ, K_METHOD, K_EVENT, G_BOOL, G_TEXT, G_COMPONENT, G_SEQUENCE, G_PROVIDE, G_FIELD, G_VALUE, G_HANDLER_ARG, G_ALL, toNullIfNaN, predTruthy, PREDICATES, parseText, parseComponent, parseSequence, parseField, parseProvide, parseMacroAttr, parseReceiveHandler, parseAlterHandler, kindOf, BaseVal, ConstVal, NULL_CONST_VAL, PredicateVal, StrTplVal, NameVal, HandlerNameVal, mk404Handler, keyIs, macCtrl, nullSafe, EVENT_CONVENIENCES, EventMemberVal, SigilNameVal, BindVal, BindMemberVal, DynVal, FieldVal, MethodVal, SeqAccessVal;
 var init_value = __esm({
   "src/value.js"() {
     init_collection();
     init_path();
-    init_env();
+    isMac = (globalThis.navigator?.userAgent ?? "").toLowerCase().includes("mac");
     VALID_VAL_ID_RE = /^[a-zA-Z][a-zA-Z0-9_]*\??$/;
     isValidValId = (name) => VALID_VAL_ID_RE.test(name);
     VALID_FLOAT_RE = /^-?[0-9]+(\.[0-9]+)?$/;
@@ -1740,9 +1752,10 @@ var init_value = __esm({
     parseMacroAttr = (s, px) => _parseSingle(s, px, G_ALL);
     parseReceiveHandler = (s, px) => _parseHandler(s, px, "receive", true, true, false);
     parseAlterHandler = (s, px) => _parseHandler(s, px, "alter", false, false, true)?.handlerVal ?? null;
+    kindOf = (val) => val?.kind ?? 0;
     BaseVal = class {
-      render(_stack, _rx) {
-      }
+      // No kind: never accepted by a group (PredicateVal, which only parseBool builds).
+      kind = 0;
       eval(_stack) {
       }
       toPathItem() {
@@ -1762,9 +1775,6 @@ var init_value = __esm({
         this.val = val;
         this.kind = kind;
       }
-      render(_stack, _rx) {
-        return this.val;
-      }
       eval(_stack) {
         return this.val;
       }
@@ -1790,9 +1800,7 @@ var init_value = __esm({
         return `${this.pred.name} ${this.args.map(String).join(" ")}`;
       }
     };
-    VarVal = class extends BaseVal {
-    };
-    StrTplVal = class _StrTplVal extends VarVal {
+    StrTplVal = class _StrTplVal extends BaseVal {
       constructor(vals) {
         super();
         this.vals = vals;
@@ -1805,9 +1813,6 @@ var init_value = __esm({
         for (const v of this.vals) if (!(v instanceof ConstVal) || v.fromMacroVar) return false;
         return true;
       }
-      render(stack, _rx) {
-        return this.eval(stack);
-      }
       eval(stack) {
         const strs = new Array(this.vals.length);
         for (let i = 0; i < this.vals.length; i++) strs[i] = this.vals[i]?.eval(stack, "");
@@ -1844,7 +1849,8 @@ var init_value = __esm({
         return new _StrTplVal(lo === 0 && hi === vals.length ? vals : vals.slice(lo, hi));
       }
     };
-    NameVal = class extends VarVal {
+    NameVal = class extends BaseVal {
+      kind = K_NAME;
       constructor(name) {
         super();
         this.name = name;
@@ -1894,6 +1900,7 @@ var init_value = __esm({
       dragKey: nullSafe((info) => info.lookupBind("key"))
     };
     EventMemberVal = class extends BaseVal {
+      kind = K_EVENT;
       constructor(members) {
         super();
         this.members = members;
@@ -1916,24 +1923,21 @@ var init_value = __esm({
         return `e.${this.members.join(".")}`;
       }
     };
-    RenderVal = class extends BaseVal {
-      render(stack, _rx) {
-        return this.eval(stack);
-      }
-    };
-    RenderNameVal = class extends RenderVal {
+    SigilNameVal = class extends BaseVal {
       constructor(name) {
         super();
         this.name = name;
       }
+      toString() {
+        return this.sigil + this.name;
+      }
     };
-    BindVal = class extends RenderNameVal {
+    BindVal = class extends SigilNameVal {
+      kind = K_BIND;
+      sigil = "@";
       eval(stack) {
         return stack.lookupBind(this.name);
       }
-      toString() {
-        return `@${this.name}`;
-      }
     };
     BindMemberVal = class extends BindVal {
       constructor(name, member) {
@@ -1948,37 +1952,35 @@ var init_value = __esm({
         return `@${this.name}.${this.member}`;
       }
     };
-    DynVal = class extends RenderNameVal {
+    DynVal = class extends SigilNameVal {
+      kind = K_DYN;
+      sigil = "*";
       eval(stack) {
         return stack.lookupDynamic(this.name);
       }
-      toString() {
-        return `*${this.name}`;
-      }
     };
-    FieldVal = class extends RenderNameVal {
+    FieldVal = class extends SigilNameVal {
+      kind = K_FIELD;
+      sigil = ".";
       eval(stack) {
         return stack.lookupFieldRaw(this.name);
       }
       toPathItem() {
         return new FieldStep(this.name);
       }
-      toString() {
-        return `.${this.name}`;
-      }
     };
-    MethodVal = class extends RenderNameVal {
+    MethodVal = class extends SigilNameVal {
+      kind = K_METHOD;
+      sigil = "$";
       eval(stack) {
         return stack.lookupMethod(this.name);
       }
       evalAsHandler(stack) {
         return stack.lookupFieldRaw(this.name);
       }
-      toString() {
-        return `$${this.name}`;
-      }
     };
-    SeqAccessVal = class extends RenderVal {
+    SeqAccessVal = class extends BaseVal {
+      kind = K_SEQ;
       constructor(seqVal, keyVal) {
         super();
         this.seqVal = seqVal;
@@ -2013,11 +2015,11 @@ function parseDirectiveValue(px, directiveName, source, parser) {
 function parseIterationDirectives(attributes, px) {
   const parseNamed = (name) => {
     const attr = attributes.getNamedItem(`@${name}`);
-    return attr ? parseDirectiveValue(px, name, attr.value, parseAlterHandler) : null;
+    return attr ? parseIterDirective(px, name, attr.value) : null;
   };
   return { whenVal: parseNamed("when"), loopWithVal: parseNamed("loop-with") };
 }
-var Attributes, booleanAttrsRaw, booleanAttrs, AttrParser, ConstAttrs, DynAttrs, BaseAttr, Attr, ConstAttr, RawHtmlAttr, NOT_SET_VAL, IfAttr, EventHandler;
+var Attributes, booleanAttrsRaw, booleanAttrs, ITER_DIRECTIVES, parseIterDirective, AttrParser, ConstAttrs, DynAttrs, BaseAttr, Attr, ConstAttr, RawHtmlAttr, NOT_SET_VAL, IfAttr, EventHandler;
 var init_attribute = __esm({
   "src/attribute.js"() {
     init_value();
@@ -2025,15 +2027,18 @@ var init_attribute = __esm({
       constructor(items) {
         this.items = items;
       }
-      static parse(attributes, px, parseAll = false) {
-        return new AttrParser(px).parse(attributes, parseAll);
-      }
       isConstant() {
         return false;
       }
     };
     booleanAttrsRaw = "itemscope,allowfullscreen,formnovalidate,ismap,nomodule,novalidate,readonly,async,autofocus,autoplay,controls,default,defer,disabled,hidden,inert,loop,open,required,reversed,scoped,seamless,checked,muted,multiple,selected";
     booleanAttrs = new Set(booleanAttrsRaw.split(","));
+    ITER_DIRECTIVES = {
+      when: "whenVal",
+      "loop-with": "loopWithVal",
+      "enrich-with": "enrichWithVal"
+    };
+    parseIterDirective = (px, name, s) => parseDirectiveValue(px, name, s, parseAlterHandler);
     AttrParser = class {
       constructor(px) {
         this.px = px;
@@ -2071,11 +2076,22 @@ var init_attribute = __esm({
           this.px.onParseIssue("bad-value", info);
         }
       }
-      parseThen(s) {
-        if (this.ifAttr) this.ifAttr.thenVal = parseText(s, this.px) ?? NOT_SET_VAL;
+      // `@then` / `@else` fill the branches of the `@if.<attr>` on the same element.
+      parseBranch(slot, name, s) {
+        if (this.ifAttr === null) return this._orphan(name, s, "if");
+        this.ifAttr[slot] = parseText(s, this.px) ?? NOT_SET_VAL;
+      }
+      // `@when` / `@loop-with` / `@enrich-with` amend the `@each` on the same element. A
+      // loop-less `@enrich-with` is a scope of its own; the other two need the loop.
+      parseIter(name, s) {
+        const val = parseIterDirective(this.px, name, s);
+        if (this.eachAttr !== null) this.eachAttr[ITER_DIRECTIVES[name]] = val;
+        else if (name === "enrich-with") this.pushWrapper("scope", s, val);
+        else this._orphan(name, s, "each");
       }
-      parseElse(value) {
-        if (this.ifAttr) this.ifAttr.elseVal = parseText(value, this.px) ?? NOT_SET_VAL;
+      // A directive that only means something next to another one, written alone.
+      _orphan(name, value, needs) {
+        this.px.onParseIssue("orphan-directive", { name, value, needs });
       }
       parseEvent(directiveName, value) {
         const [eventName, ...modifiers] = directiveName.slice(3).split("+");
@@ -2089,77 +2105,51 @@ var init_attribute = __esm({
           this.events.add(eventName, handler, modifiers);
         }
       }
-      _parseDirectiveValue(directiveName, s, parserFn) {
-        return parseDirectiveValue(this.px, directiveName, s, parserFn);
-      }
       parseDirective(s, directiveName) {
         switch (directiveName) {
           case "dangerouslysetinnerhtml":
             this.attrs ??= [];
-            this.attrs.push(new RawHtmlAttr(this._parseDirectiveValue(directiveName, s, parseText)));
+            this.attrs.push(new RawHtmlAttr(parseDirectiveValue(this.px, directiveName, s, parseText)));
             this.hasDynamic = true;
             return;
           case "push-view":
-            this.pushWrapper("push-view", s, this._parseDirectiveValue(directiveName, s, parseText));
+            this.pushWrapper("push-view", s, parseDirectiveValue(this.px, directiveName, s, parseText));
             return;
           case "text":
-            this.textChild = this._parseDirectiveValue(directiveName, s, parseText);
+            this.textChild = parseDirectiveValue(this.px, directiveName, s, parseText);
             return;
           case "show":
-            this.pushWrapper("show", s, this._parseDirectiveValue(directiveName, s, parseBool));
+            this.pushWrapper("show", s, parseDirectiveValue(this.px, directiveName, s, parseBool));
             return;
           case "hide":
-            this.pushWrapper("hide", s, this._parseDirectiveValue(directiveName, s, parseBool));
+            this.pushWrapper("hide", s, parseDirectiveValue(this.px, directiveName, s, parseBool));
             return;
           case "each": {
-            const val = this._parseDirectiveValue(directiveName, s, parseSequence);
+            const val = parseDirectiveValue(this.px, directiveName, s, parseSequence);
             this.eachAttr = this.pushWrapper("each", s, val);
             return;
           }
-          case "enrich-with":
-            if (this.eachAttr !== null)
-              this.eachAttr.enrichWithVal = this._parseDirectiveValue(
-                directiveName,
-                s,
-                parseAlterHandler
-              );
-            else
-              this.pushWrapper(
-                "scope",
-                s,
-                this._parseDirectiveValue(directiveName, s, parseAlterHandler)
-              );
-            return;
           case "when":
-            this._parseWhen(s);
-            return;
           case "loop-with":
-            this._parseLoopWith(s);
+          case "enrich-with":
+            this.parseIter(directiveName, s);
             return;
           case "then":
-            this.parseThen(s);
+            this.parseBranch("thenVal", directiveName, s);
             return;
           case "else":
-            this.parseElse(s);
+            this.parseBranch("elseVal", directiveName, s);
             return;
         }
         if (directiveName.startsWith("on.")) this.parseEvent(directiveName, s);
         else if (directiveName.startsWith("if.")) this.parseIf(directiveName, s);
-        else if (directiveName.startsWith("then.")) this.parseThen(s);
-        else if (directiveName.startsWith("else.")) this.parseElse(s);
+        else if (directiveName.startsWith("then.")) this.parseBranch("thenVal", directiveName, s);
+        else if (directiveName.startsWith("else.")) this.parseBranch("elseVal", directiveName, s);
         else {
           const info = { name: directiveName, value: s };
           this.px.onParseIssue("unknown-directive", info);
         }
       }
-      _parseWhen(s) {
-        if (this.eachAttr !== null)
-          this.eachAttr.whenVal = this._parseDirectiveValue("when", s, parseAlterHandler);
-      }
-      _parseLoopWith(s) {
-        if (this.eachAttr !== null)
-          this.eachAttr.loopWithVal = this._parseDirectiveValue("loop-with", s, parseAlterHandler);
-      }
       parse(attributes, parseAll = false) {
         for (const { name, value } of attributes) {
           const charCode = name.charCodeAt(0);
@@ -2420,6 +2410,17 @@ function addChild(normalizedChildren, child) {
     else normalizedChildren.push(child);
   } else normalizedChildren.push(new VText(child));
 }
+function applyAttrs(node, attrs, placeChildren) {
+  const hasValue = "value" in attrs;
+  const hasChecked = "checked" in attrs;
+  if (hasValue || hasChecked) {
+    const { value: _v, checked: _c, ...rest } = attrs;
+    applyProperties(node, rest);
+  } else applyProperties(node, attrs);
+  placeChildren();
+  if (hasValue) applyValueLast(node, attrs.value);
+  if (hasChecked) setProp(node, "checked", attrs.checked, isNamespaced(node));
+}
 function diffProps(a, b) {
   if (a === b) return null;
   let diff = null;
@@ -2450,22 +2451,16 @@ function morphNode(domNode, source, target, opts) {
     }
     if (type3 === 1 && source.isSameKind(target)) {
       const propsDiff = diffProps(source.attrs, target.attrs);
-      const hasValue = propsDiff != null && "value" in propsDiff;
-      const hasChecked = propsDiff != null && "checked" in propsDiff;
-      if (propsDiff) {
-        if (hasValue || hasChecked) {
-          const { value: _v, checked: _c, ...rest } = propsDiff;
-          applyProperties(domNode, rest);
-        } else applyProperties(domNode, propsDiff);
-      }
-      if (!target.attrs.dangerouslySetInnerHTML) {
+      const placeChildren = () => {
+        if (target.attrs.dangerouslySetInnerHTML) return;
         const ns = effectiveNs(target, opts);
         morphChildren(domNode, source.childs, target.childs, childOpts(target, ns, opts));
+      };
+      if (propsDiff) applyAttrs(domNode, propsDiff, placeChildren);
+      else placeChildren();
+      if (!(propsDiff && "value" in propsDiff) && source.tag === "SELECT") {
+        if (target.attrs.value !== void 0) applyValueLast(domNode, target.attrs.value);
       }
-      if (hasValue) applyValueLast(domNode, propsDiff.value);
-      else if (source.tag === "SELECT" && target.attrs.value !== void 0)
-        applyValueLast(domNode, target.attrs.value);
-      if (hasChecked) setProp(domNode, "checked", propsDiff.checked, false);
       return domNode;
     }
     if (type3 === 11) {
@@ -2685,16 +2680,7 @@ var init_vdom = __esm({
         const createOpts = attrs.is != null ? { is: attrs.is } : void 0;
         const node = ns === null ? doc.createElement(tag, createOpts) : doc.createElementNS(ns, tag, createOpts);
         const cOpts = childOpts(this, ns, opts);
-        if ("value" in attrs || "checked" in attrs) {
-          const { value, checked, ...rest } = attrs;
-          applyProperties(node, rest);
-          appendChildNodes(node, this.childs, cOpts);
-          if (value !== void 0) applyValueLast(node, value);
-          if (checked !== void 0) setProp(node, "checked", checked, false);
-        } else {
-          applyProperties(node, attrs);
-          appendChildNodes(node, this.childs, cOpts);
-        }
+        applyAttrs(node, attrs, () => appendChildNodes(node, this.childs, cOpts));
         return node;
       }
     };
@@ -2702,20 +2688,16 @@ var init_vdom = __esm({
 });
 
 // src/anode.js
-function resolveDynProducer(comp, name) {
-  const own = comp?.provide?.[name];
-  const producerComp = own != null ? comp : comp?.scope?.lookupProvider(name) ?? null;
-  const producerProvide = own ?? producerComp?.provide?.[name];
-  if (producerComp == null || producerProvide == null) return null;
-  const pi = producerProvide.val?.toPathItem?.() ?? null;
-  return { producerCompId: producerComp.id, producerSteps: pi ? [pi] : [] };
-}
-function optimizeChilds(childs) {
-  for (let i = 0; i < childs.length; i++) {
-    const child = childs[i];
-    if (child.isConstant()) childs[i] = new RenderOnceNode(child);
-    else child.optimize();
+function renderTarget(val, stack) {
+  if (val instanceof DynVal) {
+    const loc = stack.lookupDynamicLocated(val.name);
+    if (loc?.path == null) return [loc?.value ?? null, stack.renderPath, null];
+    return [loc.value, stack.renderPath.pushFrame(loc.path), loc.path];
   }
+  const step = val.toPathItem?.() ?? null;
+  if (step === null) return [val.eval(stack), stack.renderPath, null];
+  const path = stack.renderPath.pushItem(step);
+  return [val.eval(stack), path, stack.pendingFrame ? path.toTransactionPath() : null];
 }
 function optimizeNode(node) {
   if (node.isConstant()) return new RenderOnceNode(node);
@@ -2816,11 +2798,6 @@ function makeWrapperNode(data, px) {
   }
   return node;
 }
-function dynRenderStep(comp, name, key) {
-  const p = resolveDynProducer(comp, name);
-  if (!p) return null;
-  return key === void 0 ? new DynStep(p.producerCompId, p.producerSteps) : new DynEachStep(p.producerCompId, p.producerSteps, key);
-}
 function parseRenderEach(px, value, as, attrs) {
   const seqVal = parseXOpVal("render-each", value, px, parseSequence);
   if (seqVal === null) return null;
@@ -2837,7 +2814,7 @@ function xOp(consumed = [], { wrappable = false, wrapper = null, ignoresChildren
   return { consumed: new Set(consumed), wrappable, wrapper, ignoresChildren };
 }
 function trimEdgeWhite(node) {
-  if (!node.isWhiteSpace?.()) return false;
+  if (!node.isWhiteSpace()) return false;
   node.condenseWhiteSpace();
   return true;
 }
@@ -2848,7 +2825,7 @@ function condenseChildsWhites(childs) {
   if (last > 0 && trimEdgeWhite(childs[last])) emptied = true;
   for (let i = 1; i < last; i++) {
     const cur = childs[i];
-    if (!(cur.isWhiteSpace?.() && cur.hasNewLine())) continue;
+    if (!(cur.isWhiteSpace() && cur.hasNewLine())) continue;
     const bothBlock = isBlockDomNode(childs[i - 1]) && isBlockDomNode(childs[i + 1]);
     cur.condenseWhiteSpace(bothBlock ? "" : " ");
     if (bothBlock) emptied = true;
@@ -2875,7 +2852,7 @@ function compileModifiers(eventName, names) {
     return w(this, f, args, ctx);
   };
 }
-var BaseNode, TextNode, CommentNode, ChildsNode, DomNode, FragmentNode, maybeFragment, VALID_NODE_RE, ANode, MacroNode, RenderViewId, RenderNode, RenderItNode, RenderTextNode, RenderOnceNode, WrapperNode, ShowNode, HideNode, PushViewNameNode, SlotNode, ScopeNode, EachNode, IterInfo, X_OPS, WRAPPER_NODES, ParseContext, _htmlBlockTags, HTML_BLOCK_TAGS, isBlockDomNode, isEmptyText, isIgnorableXChild, hasMeaningfulChilds, View, NodeEvents, NodeEvent, fwdIfCtxPred, fwdIfEventPred, fwdIfKey, fwdCtrl, fwdMeta, fwdAlt, MOD_WRAPPERS_FOR_ANY_EVENT, MOD_WRAPPERS_BY_EVENT, MOD_EFFECTS, NO_WRAPPERS, identityModifierWrapper;
+var BaseNode, TextNode, CommentNode, ChildsNode, DomNode, FragmentNode, maybeFragment, VALID_NODE_RE, ANode, MacroNode, RenderViewId, RenderNode, RenderItNode, RenderTextNode, RenderOnceNode, WrapperNode, ShowNode, HideNode, PushViewNameNode, SlotNode, ScopeNode, EachNode, IterInfo, X_OPS, WRAPPER_NODES, ParseContext, _htmlBlockTags, HTML_BLOCK_TAGS, isBlockDomNode, isEmptyText, isIgnorableXChild, hasMeaningfulChilds, NodeEvents, NodeEvent, fwdIfCtxPred, fwdIfEventPred, fwdIfKey, fwdCtrl, fwdMeta, fwdAlt, MOD_WRAPPERS_FOR_ANY_EVENT, MOD_WRAPPERS_BY_EVENT, MOD_EFFECTS, NO_WRAPPERS, identityModifierWrapper;
 var init_anode = __esm({
   "src/anode.js"() {
     init_attribute();
@@ -2887,8 +2864,11 @@ var init_anode = __esm({
       render(_stack, _rx) {
         return null;
       }
-      setDataAttr(key, val) {
-        console.warn("setDataAttr not implemented for", this, { key, val });
+      // Stamp a `data-*` attribute on the element(s) this node renders. A no-op for
+      // nodes that produce no element of their own (text, `<x render*>`): a view whose
+      // root is one of those records its component boundary in the `§Comp§` meta
+      // comment instead (see Renderer._rValComp).
+      setDataAttr(_key, _val) {
       }
       isConstant() {
         return false;
@@ -2927,8 +2907,6 @@ var init_anode = __esm({
       isConstant() {
         return true;
       }
-      setDataAttr(_key, _val) {
-      }
     };
     CommentNode = class extends TextNode {
       render(_stack, rx) {
@@ -2944,7 +2922,8 @@ var init_anode = __esm({
         return this.childs.every((v) => v.isConstant());
       }
       optimize() {
-        optimizeChilds(this.childs);
+        const { childs } = this;
+        for (let i = 0; i < childs.length; i++) childs[i] = optimizeNode(childs[i]);
       }
     };
     DomNode = class extends ChildsNode {
@@ -2956,8 +2935,7 @@ var init_anode = __esm({
       }
       render(stack, rx) {
         const childNodes = new Array(this.childs.length);
-        for (let i = 0; i < childNodes.length; i++)
-          childNodes[i] = this.childs[i]?.render?.(stack, rx) ?? null;
+        for (let i = 0; i < childNodes.length; i++) childNodes[i] = this.childs[i].render(stack, rx);
         return rx.renderTag(this.tagName, this.attrs.eval(stack), childNodes, this.namespace);
       }
       setDataAttr(key, val) {
@@ -2969,7 +2947,7 @@ var init_anode = __esm({
     };
     FragmentNode = class extends ChildsNode {
       render(stack, rx) {
-        return rx.renderFragment(this.childs.map((c) => c?.render(stack, rx)));
+        return rx.renderFragment(this.childs.map((c) => c.render(stack, rx)));
       }
       setDataAttr(key, val) {
         for (const child of this.childs) child.setDataAttr(key, val);
@@ -2983,8 +2961,10 @@ var init_anode = __esm({
         this.nodeId = nodeId;
         this.val = val;
       }
-      toPathStep(ctx) {
-        return ctx.applyKey(this.val?.toPathItem?.() ?? null);
+      // The addressing step this node contributes to an event's dispatch path, given
+      // the `StepCtx` of the meta that named it; null when it addresses nothing.
+      toPathStep(_ctx) {
+        return this.val?.toPathItem?.() ?? null;
       }
       static parse(html, px) {
         const nodes = px.parseHTML(html);
@@ -3000,8 +2980,8 @@ var init_anode = __esm({
         return maybeFragment(trimmed);
       }
       static fromDOM(node, px) {
-        if (node instanceof px.Text) return new TextNode(node.textContent);
-        else if (node instanceof px.Comment) return new CommentNode(node.textContent);
+        if (node.nodeType === 3) return new TextNode(node.textContent);
+        if (node.nodeType === 8) return new CommentNode(node.textContent);
         const { childNodes, attributes: attrs, tagName: tag } = node;
         const childs = [];
         for (let i = 0; i < childNodes.length; i++) {
@@ -3019,11 +2999,11 @@ var init_anode = __esm({
               const slotName = attrs.getNamedItem("name")?.value ?? "_";
               return px.frame.macroSlots[slotName] ?? maybeFragment(childs);
             }
-            const [nAttrs, wrappers] = Attributes.parse(attrs, px, true);
+            const [nAttrs, wrappers] = new AttrParser(px).parse(attrs, true);
             px.onAttributes(nAttrs, wrappers, null, true, tag);
             return wrap(px.newMacroNode(macroName, nAttrs.toMacroVars(), childs), px, wrappers);
           } else if (VALID_NODE_RE.test(tag)) {
-            const [nAttrs, wrappers, textChild] = Attributes.parse(attrs, px);
+            const [nAttrs, wrappers, textChild] = new AttrParser(px).parse(attrs);
             px.onAttributes(nAttrs, wrappers, textChild, false, tag);
             if (textChild) childs.unshift(new RenderTextNode(null, textChild));
             const domChilds = tag !== "PRE" ? condenseChildsWhites(childs) : childs;
@@ -3082,34 +3062,32 @@ var init_anode = __esm({
       evalViewName(stack) {
         return this.viewVal ? this.viewVal.eval(stack) : null;
       }
-      // A `<x render*>` produces no DOM element of its own to carry `data-cid`;
-      // when it is a view's root the component boundary is recorded in the `Comp`
-      // meta comment instead (see Renderer._rValComp), so this is a no-op.
-      setDataAttr(_key, _val) {
-      }
     };
     RenderNode = class extends RenderViewId {
       render(stack, rx) {
-        const newStack = stack.enter(this.val.eval(stack), {}, true);
-        return rx.renderIt(newStack, this, "", this.evalViewName(stack));
+        const [value, renderPath, base] = renderTarget(this.val, stack);
+        const newStack = stack.enter(value, {}, true, renderPath, false);
+        return rx.renderIt(newStack, this, this.evalViewName(stack), base);
       }
+      // A `*name` target contributes no step: the site recorded the absolute base it
+      // resumed at, and event reconstruction turns that into a continuation frame.
       toPathStep(ctx) {
-        if (this.val instanceof DynVal) return dynRenderStep(ctx.comp, this.val.name);
+        if (this.val instanceof DynVal) return null;
         return super.toPathStep(ctx);
       }
     };
     RenderItNode = class extends RenderViewId {
       render(stack, rx) {
-        const newStack = stack.enter(stack.it, {}, true);
-        return rx.renderIt(newStack, this, "", this.evalViewName(stack));
+        const base = stack.pendingFrame ? stack.renderPath.toTransactionPath() : null;
+        const newStack = stack.enter(stack.it, {}, true, stack.renderPath, false);
+        return rx.renderIt(newStack, this, this.evalViewName(stack), base);
       }
       toPathStep(ctx) {
         const next = ctx.next();
         if (next === null) return null;
         const nextNode = next.resolveNode();
         if (nextNode instanceof EachNode && next.hasKey) {
-          if (nextNode.val instanceof DynVal)
-            return dynRenderStep(ctx.comp, nextNode.val.name, next.key);
+          if (nextNode.val instanceof DynVal) return null;
           return new EachRenderItStep(nextNode.val.name, next.key);
         }
         return null;
@@ -3119,9 +3097,6 @@ var init_anode = __esm({
       render(stack, _rx) {
         return this.val.eval(stack);
       }
-      // Renders to a text node, which can't carry `data-cid`.
-      setDataAttr(_key, _val) {
-      }
     };
     RenderOnceNode = class extends BaseNode {
       constructor(node) {
@@ -3196,36 +3171,46 @@ var init_anode = __esm({
     EachNode = class extends WrapperNode {
       constructor(nodeId, val) {
         super(nodeId, val);
-        this.iterInfo = new IterInfo(val, null, null, null);
+        this.iterInfo = new IterInfo();
       }
       render(stack, rx) {
-        return rx.renderEachWhen(stack, this.iterInfo, this.node, this.nodeId);
-      }
-      toPathStep(ctx) {
-        return ctx.hasKey ? new EachBindStep(this.iterInfo, ctx.key) : null;
+        return rx.renderEachWhen(stack, this);
       }
-      static register = true;
-    };
-    IterInfo = class {
-      constructor(val, whenVal, loopWithVal, enrichWithVal) {
-        this.val = val;
-        this.whenVal = whenVal;
-        this.loopWithVal = loopWithVal;
-        this.enrichWithVal = enrichWithVal;
-      }
-      eval(stack) {
-        const seq = this.val.eval(stack) ?? [];
-        const filter = this.whenVal?.evalAsHandler(stack) ?? filterAlwaysTrue;
-        const loopWith = this.loopWithVal?.evalAsHandler(stack) ?? nullLoopWith;
-        const enricher = this.enrichWithVal?.evalAsHandler(stack) ?? null;
-        return { seq, filter, loopWith, enricher };
+      // The sequence and the three loop handlers, resolved against `stack`.
+      evalIter(stack) {
+        const { whenVal, loopWithVal, enrichWithVal } = this.iterInfo;
+        return {
+          seq: this.val.eval(stack) ?? [],
+          filter: whenVal?.evalAsHandler(stack) ?? filterAlwaysTrue,
+          loopWith: loopWithVal?.evalAsHandler(stack) ?? nullLoopWith,
+          enricher: enrichWithVal?.evalAsHandler(stack) ?? null
+        };
       }
       // Rebuild the per-item binds for `key` (see iteration.js bindsForKey).
       enrichBinds(stack, key) {
-        const { seq, filter, loopWith, enricher } = this.eval(stack);
+        const { seq, filter, loopWith, enricher } = this.evalIter(stack);
         const ctx = makeLoopCtx(stack, filter);
         return bindsForKey({ seq, it: stack.it, loopWith, enricher, ctx }, key);
       }
+      toPathStep(ctx) {
+        return ctx.hasKey ? new EachBindStep(this, ctx.key) : null;
+      }
+      // Where one item lives, for the render path. `@each` re-binds `it` to the item
+      // whether or not the body is a component, so the position moves either way and
+      // the step has to address it — `.rows` iterated at `key` IS `rows[key]`.
+      // Null for a dynamic sequence: `*rows` carries its own absolute path and enters
+      // a continuation frame instead (see Renderer.renderEachWhen).
+      itemStep(key) {
+        return this.val instanceof FieldVal ? new SeqStep(this.val.name, key) : null;
+      }
+      static register = true;
+    };
+    IterInfo = class {
+      constructor() {
+        this.whenVal = null;
+        this.loopWithVal = null;
+        this.enrichWithVal = null;
+      }
     };
     X_OPS = {
       slot: xOp(),
@@ -3249,26 +3234,31 @@ var init_anode = __esm({
       scope: ScopeNode,
       "push-view": PushViewNameNode
     };
-    ParseContext = class _ParseContext {
-      constructor(document2, Text, Comment, nodes, events2, macroNodes, frame, parent) {
-        this.nodes = nodes ?? [];
-        this.events = events2 ?? [];
-        this.macroNodes = macroNodes ?? [];
-        this.parent = parent ?? null;
-        this.frame = frame ?? {};
-        this.document = document2 ?? globalThis.document;
-        this.Text = Text ?? globalThis.Text;
-        this.Comment = Comment ?? globalThis.Comment;
-        this.cacheConstNodes = true;
+    ParseContext = class {
+      constructor(document2 = globalThis.document) {
+        this.document = document2;
+        this.nodes = [];
+        this.events = [];
+        this.macroNodes = [];
+        this.parent = null;
+        this.frame = {};
         this.currentTag = null;
       }
       isInsideMacro(name) {
         return this.frame.macroName === name || this.parent?.isInsideMacro(name);
       }
+      // A macro body parses in a child context that shares every accumulator with
+      // its parent (nodes, events, macroNodes, and whatever a subclass collects) and
+      // differs only in its frame. Cloned rather than constructed so a subclass
+      // keeps collecting inside macro bodies without re-implementing this — the
+      // lint and class-set contexts used to lose (or had to copy) exactly that.
       enterMacro(macroName, macroVars, macroSlots) {
-        const { document: document2, Text, Comment, nodes, events: events2, macroNodes } = this;
-        const frame = { macroName, macroVars, macroSlots };
-        return new _ParseContext(document2, Text, Comment, nodes, events2, macroNodes, frame, this);
+        const child = Object.create(Object.getPrototypeOf(this));
+        return Object.assign(child, this, {
+          frame: { macroName, macroVars, macroSlots },
+          parent: this,
+          currentTag: null
+        });
       }
       parseHTML(html) {
         const t = this.document.createElement("template");
@@ -3333,33 +3323,8 @@ var init_anode = __esm({
       return node instanceof DomNode && HTML_BLOCK_TAGS.has(node.tagName);
     };
     isEmptyText = (c) => c instanceof TextNode && c.val === "";
-    isIgnorableXChild = (c) => c instanceof CommentNode || (c.isWhiteSpace?.() ?? false);
+    isIgnorableXChild = (c) => c instanceof CommentNode || c.isWhiteSpace();
     hasMeaningfulChilds = (childs) => childs.some((c) => !isIgnorableXChild(c));
-    View = class {
-      constructor(name, rawView = "No View Defined", style = "", anode = null, ctx = null) {
-        this.name = name;
-        this.anode = anode;
-        this.style = style;
-        this.ctx = ctx;
-        this.rawView = rawView;
-      }
-      compile(ctx, scope, cid) {
-        this.ctx = ctx;
-        this.anode = ANode.parse(this.rawView, ctx);
-        this.anode.setDataAttr("data-cid", cid);
-        this.anode.setDataAttr("data-vid", this.name);
-        this.ctx.compile(scope);
-        if (ctx.cacheConstNodes) this.anode = optimizeNode(this.anode);
-      }
-      render(stack, rx) {
-        if (this.anode === null) {
-          throw new Error(
-            `tutuca: view "${this.name}" was rendered before it was compiled — its component is not registered in this app/scope. Source: ${String(this.rawView).slice(0, 80).replace(/\s+/g, " ")}…`
-          );
-        }
-        return this.anode.render(stack, rx);
-      }
-    };
     NodeEvents = class {
       constructor(id) {
         this.id = id;
@@ -3374,7 +3339,7 @@ var init_anode = __esm({
       getHandlersFor(eventName) {
         let r = null;
         for (const handler of this.handlers)
-          if (handler.handlesEventName(eventName)) {
+          if (handler.name === eventName) {
             r ??= [];
             r.push(handler);
           }
@@ -3388,9 +3353,6 @@ var init_anode = __esm({
         this.modifierWrapper = compileModifiers(name, modifiers);
         this.modifiers = modifiers;
       }
-      handlesEventName(name) {
-        return this.name === name;
-      }
       getHandlerAndArgs(stack, event) {
         const r = this.handlerCall.getHandlerAndArgs(stack, event);
         r[0] = this.modifierWrapper(r[0], event);
@@ -3424,11 +3386,212 @@ var init_anode = __esm({
   }
 });
 
+// src/stack.js
+function lookup(chain, name, dv = null) {
+  let n = chain;
+  while (n !== null) {
+    const r = n[0].lookup(name);
+    if (r === STOP) return dv;
+    if (r !== NEXT) return r;
+    n = n[1];
+  }
+  return dv;
+}
+function computeViewsId(views) {
+  let s = "";
+  let n = views;
+  while (n !== null) {
+    s += n[0];
+    n = n[1];
+  }
+  return s === "main" ? "" : s;
+}
+var STOP, NEXT, DEFAULT_ROUTE, isTypeName, BindFrame, DynFrame, Stack, NOT_FOUND;
+var init_stack = __esm({
+  "src/stack.js"() {
+    init_path();
+    STOP = /* @__PURE__ */ Symbol("STOP");
+    NEXT = /* @__PURE__ */ Symbol("NEXT");
+    DEFAULT_ROUTE = ["dyn", "lex"];
+    isTypeName = (s) => {
+      const c = s.charCodeAt(0);
+      return c >= 65 && c <= 90;
+    };
+    BindFrame = class {
+      constructor(it, binds, isFrame) {
+        this.it = it;
+        this.binds = binds;
+        this.isFrame = isFrame;
+      }
+      lookup(name) {
+        const v = this.binds[name];
+        return v === void 0 ? this.isFrame ? STOP : NEXT : v;
+      }
+    };
+    DynFrame = class {
+      constructor(binds, types) {
+        this.binds = binds;
+        this.types = types;
+      }
+      lookup(name) {
+        const v = (isTypeName(name) ? this.types : this.binds)[name];
+        return v === void 0 ? NEXT : v;
+      }
+    };
+    Stack = class _Stack {
+      constructor(fields) {
+        Object.assign(this, fields);
+      }
+      _with(patch) {
+        return new _Stack({ ...this, ...patch });
+      }
+      // Evaluate every provide the entered component publishes and push them as one
+      // dynBinds frame, keyed by NAME. A value is published together with the absolute
+      // path it lives at: the same declaration is read as `*name` AND resumed at by
+      // `<x render="*name">`, so a consumer needs both halves. Types go in the same
+      // frame's other map. No-op with no provides.
+      _pushProvides() {
+        const comp = this.comps.getCompFor(this.it);
+        if (comp == null) return this;
+        const { provide, provideType } = comp;
+        const binds = {};
+        const types = {};
+        let has2 = false;
+        const base = this._publishBase();
+        for (const k in provide) {
+          const step = provide[k].toPathItem?.() ?? null;
+          if (step === null) continue;
+          const value = provide[k].eval(this);
+          binds[k] = { value, path: base === null ? null : base.concat([step]) };
+          has2 = true;
+        }
+        for (const k in provideType) {
+          types[k] = provideType[k];
+          has2 = true;
+        }
+        if (!has2) return this;
+        return this._with({ dynBinds: [new DynFrame(binds, types), this.dynBinds] });
+      }
+      // The absolute address of the component being entered, or null when this
+      // position cannot be written down as one. Frame-only steps carry bindings and
+      // address nothing, so they are compacted away first; what is left is checked
+      // against the value actually being rendered, because a scope CAN move the
+      // render position without contributing an addressing step (a plain `@each`
+      // body re-binds `it` to the item while its rebuild step is an identity).
+      //
+      // A null base still publishes the VALUE — `*name` reads it fine — but there is
+      // nowhere to resume, so `<x render="*name">` renders nothing rather than
+      // editing whatever happens to live at the address we guessed.
+      _publishBase() {
+        const base = this.renderPath.toTransactionPath().compact();
+        return base.lookup(this.root, NOT_FOUND) === this.it ? base : null;
+      }
+      static root(comps, it, ctx = null) {
+        return new _Stack({
+          comps,
+          root: it,
+          it,
+          binds: [new BindFrame(it, {}, true), null],
+          dynBinds: [new DynFrame({}, {}), null],
+          views: ["main", null],
+          viewsId: "",
+          renderPath: new DispatchPath(),
+          pendingFrame: false,
+          ctx
+        })._pushProvides();
+      }
+      // `renderPath` defaults to this stack's own: an ordinary scope does not move.
+      // `pendingFrame` clears on a component frame (which emits the base) and is
+      // inherited by transparent scopes, which have to carry it to the next boundary.
+      enter(it, bindings = {}, isFrame = true, renderPath = this.renderPath, pendingFrame = null) {
+        const stack = this._with({
+          it,
+          binds: [new BindFrame(it, bindings, isFrame), this.binds],
+          renderPath,
+          pendingFrame: pendingFrame ?? (isFrame ? false : this.pendingFrame)
+        });
+        return isFrame ? stack._pushProvides() : stack;
+      }
+      pushViewName(name) {
+        const views = [name, this.views];
+        return this._with({ views, viewsId: computeViewsId(views) });
+      }
+      // Published types are stable per scope and would only churn the render cache, so
+      // the cache key covers values alone.
+      _pushDynBindValuesToArray(arr, comp) {
+        for (const k in comp.provide) arr.push(this.lookupDynamic(k));
+        for (const k in comp.lookup) arr.push(this.lookupDynamic(k));
+      }
+      // `*name`: the nearest binding above (including this component's own provides,
+      // pushed on entering it), else a path registered in the component's lexical
+      // scope, else this component's declared default, else null.
+      //
+      // One chain walk and no producer resolution: a lookup names what it WANTS, so the
+      // frame it wants is keyed by that name. The default belongs to the CONSUMER's
+      // declaration and is evaluated against the consumer's stack, which is why it is
+      // consulted only after the whole chain has missed.
+      lookupDynamicLocated(name) {
+        if (isTypeName(name)) return null;
+        const v = lookup(this.dynBinds, name);
+        if (v != null) return v;
+        const comp = this.comps.getCompFor(this.it);
+        if (comp == null) return null;
+        const path = comp.scope?.lookupPath?.(name) ?? null;
+        if (path !== null) {
+          const value2 = path.lookup(this.root, NOT_FOUND);
+          if (value2 !== NOT_FOUND) return { value: value2, path };
+        }
+        const dval = comp.lookup[name] ?? null;
+        if (dval === null) return null;
+        const step = dval.toPathItem?.() ?? null;
+        const value = dval.eval(this);
+        return step === null ? { value, path: null } : { value, path: this.renderPath.toTransactionPath().concat([step]) };
+      }
+      lookupDynamic(name) {
+        if (isTypeName(name)) return lookup(this.dynBinds, name);
+        return this.lookupDynamicLocated(name)?.value ?? null;
+      }
+      lookupBind(name) {
+        return lookup(this.binds, name);
+      }
+      lookupFieldRaw(name) {
+        return this.it[name] ?? null;
+      }
+      lookupMethod(name) {
+        const fn = this.it[name];
+        return fn instanceof Function ? fn.call(this.it) : null;
+      }
+      // The dispatched DOM event / drag info, read only by EventMemberVal's
+      // `e.<member>` handler args. Null outside a live event transaction (`ctx` is
+      // then a send/intent transaction, which carries no `e`).
+      lookupEvent() {
+        return this.ctx?.e ?? null;
+      }
+      lookupDragInfo() {
+        return this.ctx?.dragInfo ?? null;
+      }
+      getHandlerFor(name, key) {
+        return this.comps.getHandlerFor(this.it, name, key);
+      }
+      lookupBestView(views, defaultViewName) {
+        let n = this.views;
+        while (n !== null) {
+          const view = views[n[0]];
+          if (view !== void 0) return view;
+          n = n[1];
+        }
+        return views[defaultViewName];
+      }
+    };
+    NOT_FOUND = /* @__PURE__ */ Symbol("NOT_FOUND");
+  }
+});
+
 // src/components.js
-var COMPONENT, Components, ComponentStack, ProvideInfo, LookupInfo, isString, isTypeName, _rawSpecKeys, KNOWN_SPEC_KEYS, _compId, Component;
+var COMPONENT, Components, ComponentStack, isString, _rawSpecKeys, KNOWN_SPEC_KEYS, COMPONENT_METHODS;
 var init_components = __esm({
   "src/components.js"() {
-    init_anode();
+    init_stack();
     init_value();
     COMPONENT = /* @__PURE__ */ Symbol.for("tutuca.component");
     Components = class {
@@ -3436,7 +3599,7 @@ var init_components = __esm({
         this.byId = /* @__PURE__ */ new Map();
       }
       registerComponent(Comp) {
-        this.byId.set(Comp[COMPONENT].id, Comp);
+        this.byId.set(Comp.id, Comp);
       }
       getComponentForId(id) {
         return this.byId.get(id) ?? null;
@@ -3456,7 +3619,7 @@ var init_components = __esm({
       }
       compileStyles() {
         const styles2 = [];
-        for (const Comp of this.byId.values()) styles2.push(Comp[COMPONENT].compileStyle());
+        for (const Comp of this.byId.values()) styles2.push(Comp.compileStyle());
         return styles2.join("\n");
       }
     };
@@ -3467,15 +3630,17 @@ var init_components = __esm({
         this.byName = {};
         this.intentsByName = {};
         this.macros = {};
+        this.paths = {};
       }
       enter() {
         return new _ComponentStack(this.comps, this);
       }
       registerComponents(comps, opts) {
-        const { aliases: aliases2 = {} } = opts ?? {};
+        const { aliases: aliases2 = {}, paths } = opts ?? {};
+        if (paths) this.registerPaths(paths);
         for (let i = 0; i < comps.length; i++) {
           const Comp = comps[i];
-          Comp[COMPONENT].scope = this.enter();
+          Comp.scope = this.enter();
           this.comps.registerComponent(Comp);
           this.byName[Comp.name] = Comp;
         }
@@ -3486,6 +3651,27 @@ var init_components = __esm({
           else console.warn("alias", alias, "to inexistent component", aliases2[alias]);
         }
       }
+      // Register lowercase names as absolute paths from the app state root. A
+      // descendant that declares one in its `lookup` reads and renders `*name` without
+      // anything above it publishing one — which is what makes a session, a theme or a
+      // host-owned value available in its natural registration scope, instead of forcing
+      // an application root whose only job is to `provide` it. Register on a nested
+      // scope to narrow a name; nearest registration wins.
+      //
+      // Uppercase names are ignored: a component TYPE is what `lookupComponent` already
+      // answers, and a type has no path.
+      registerPaths(paths) {
+        for (const name in paths) {
+          if (isTypeName(name)) {
+            console.warn("registerPaths: a type name has no path", name);
+            continue;
+          }
+          this.paths[name] = paths[name].toPath();
+        }
+      }
+      lookupPath(name) {
+        return this.paths[name] ?? this.parent?.lookupPath(name) ?? null;
+      }
       registerMacros(macros) {
         for (const key in macros) {
           const lower = key.toLowerCase();
@@ -3517,97 +3703,56 @@ var init_components = __esm({
       lookupComponent(name) {
         return this.byName[name] ?? this.parent?.lookupComponent(name) ?? null;
       }
-      // The component in this scope chain that provides `name`, innermost first. A lookup
-      // names a value without naming its producer, so the render-target teleport
-      // (resolveDynProducer) recovers the producer here instead. Sound because
-      // PROVIDE_NAME_COLLISION keeps a provide name to one producer per chain; with two,
-      // this returns the innermost and the linter has already reported the ambiguity.
-      lookupProvider(name) {
+      // Whether anything in this scope chain provides `name`. Existence only: a lookup
+      // names what it WANTS and takes whoever is nearest above it at render time, so
+      // there is no producer to identify — several components may publish one name and
+      // the live render ancestry decides. Used by the linter to tell a lookup that can
+      // be satisfied from one that never will be.
+      hasProvider(name) {
         for (const compName in this.byName) {
-          const Comp = this.byName[compName];
-          if (Comp.provide?.[name] !== void 0) return Comp;
+          if (this.byName[compName].provide?.[name] !== void 0) return true;
         }
-        return this.parent?.lookupProvider(name) ?? null;
+        return this.parent?.hasProvider(name) ?? false;
       }
       lookupMacro(name) {
         return this.macros[name] ?? this.parent?.lookupMacro(name) ?? null;
       }
     };
-    ProvideInfo = class {
-      constructor(val) {
-        this.val = val;
-      }
-    };
-    LookupInfo = class {
-      constructor(val) {
-        this.val = val;
-      }
-    };
     isString = (v) => typeof v === "string";
-    isTypeName = (s) => {
-      const c = s.charCodeAt(0);
-      return c >= 65 && c <= 90;
-    };
     _rawSpecKeys = "name view style commonStyle globalStyle receive intent alter views provide lookup fields methods statics";
     KNOWN_SPEC_KEYS = new Set(_rawSpecKeys.split(" "));
-    _compId = 0;
-    Component = class {
-      constructor(Class, o) {
-        this.id = _compId++;
-        this.name = o.name ?? "UnkComp";
-        this.Class = Class;
-        this.views = { main: new View("main", o.view, o.style) };
-        this.commonStyle = o.commonStyle ?? "";
-        this.globalStyle = o.globalStyle ?? "";
-        this.receive = o.receive ?? {};
-        this.intent = o.intent ?? {};
-        this.alter = o.alter ?? {};
-        for (const name in o.views ?? {}) {
-          const v = o.views[name];
-          const { view, style } = isString(v) ? { view: v } : v;
-          this.views[name] = new View(name, view, style);
-        }
-        this._rawProvide = o.provide ?? {};
-        this._rawLookup = o.lookup ?? [];
-        this.provide = {};
-        this.provideType = {};
-        this.lookup = {};
-        this.scope = null;
-        this.spec = o;
-        this.extra = {};
-        for (const key of Object.keys(o)) if (!KNOWN_SPEC_KEYS.has(key)) this.extra[key] = o[key];
-      }
+    COMPONENT_METHODS = {
       compile(ParseContext2) {
         for (const name in this.views)
           this.views[name].compile(new ParseContext2(), this.scope, this.id);
         const ctx = this.views.main.ctx;
         for (const key in this._rawProvide) {
           if (isTypeName(key)) {
-            if (this._rawProvide[key] === "self") this.provideType[key] = this.Class;
+            if (this._rawProvide[key] === "self") this.provideType[key] = this;
             continue;
           }
           const val = parseProvide(this._rawProvide[key], ctx);
-          if (val) this.provide[key] = new ProvideInfo(val);
+          if (val) this.provide[key] = val;
         }
         for (const entry of this._rawLookup) {
           const name = isString(entry) ? entry : isString(entry?.name) ? entry.name : null;
           if (name === null) continue;
           const defStr = isString(entry?.default) ? entry.default : null;
-          this.lookup[name] = new LookupInfo(defStr === null ? null : parseField(defStr, ctx));
+          this.lookup[name] = defStr === null ? null : parseField(defStr, ctx);
         }
         for (const key in this.lookup)
           if (this.provide[key] !== void 0)
             console.warn("name declared in both provide and lookup", this.name, key);
-      }
+      },
       getView(name) {
         return this.views[name] ?? this.views.main;
-      }
-      getEventForId(id, name = "main") {
-        return this.getView(name).ctx.getEventForId(id);
-      }
-      getNodeForId(id, name = "main") {
-        return this.getView(name).ctx.getNodeForId(id);
-      }
+      },
+      getEventForId(id, viewName) {
+        return this.getView(viewName).ctx.getEventForId(id);
+      },
+      getNodeForId(id, viewName) {
+        return this.getView(viewName).ctx.getNodeForId(id);
+      },
       compileStyle() {
         const { id, commonStyle, globalStyle, views } = this;
         const styles2 = commonStyle ? [`[data-cid="${id}"]{${commonStyle}}`] : [];
@@ -3622,6 +3767,63 @@ var init_components = __esm({
   }
 });
 
+// src/util/parsectx.js
+var ParseCtxClassSetCollector;
+var init_parsectx = __esm({
+  "src/util/parsectx.js"() {
+    init_anode();
+    init_value();
+    ParseCtxClassSetCollector = class extends ParseContext {
+      constructor(...args) {
+        super(...args);
+        this.classes = /* @__PURE__ */ new Set();
+      }
+      _addClasses(s) {
+        for (const v of s.split(/\s+/)) {
+          this.classes.add(v);
+        }
+      }
+      onAttributes(attrs, _wrapperAttrs, _textChild, _isMacroCall, _tag) {
+        if (Array.isArray(attrs.items)) {
+          for (const attr of attrs.items) {
+            if (attr.name !== "class") {
+              continue;
+            }
+            const { val, thenVal, elseVal } = attr;
+            if (thenVal !== void 0) {
+              this._maybeAddVal(thenVal);
+              this._maybeAddVal(elseVal);
+            } else {
+              this._maybeAddVal(val);
+            }
+          }
+        } else {
+          const attr = attrs.items.class;
+          if (attr) {
+            this._addClasses(attr);
+          }
+        }
+      }
+      _maybeAddVal(value) {
+        if (!this._maybeAddStrTpl(value) && typeof value?.val === "string") {
+          this._addClasses(value.val);
+        }
+      }
+      _maybeAddStrTpl(value) {
+        if (value?.vals !== void 0) {
+          for (const val of value.vals) {
+            if (val instanceof ConstVal && val.val !== "") {
+              this._addClasses(val.val);
+            }
+          }
+          return true;
+        }
+        return false;
+      }
+    };
+  }
+});
+
 // tools/core/html-tokenizer.js
 function isWhitespace(c) {
   return c === CharCodes.Space || c === CharCodes.NewLine || c === CharCodes.Tab || c === CharCodes.FormFeed || c === CharCodes.CarriageReturn;
@@ -5958,7 +6160,6 @@ function checkComponent(Comp, lx = new LintContext(), { wellKnownExtras = EMPTY_
     checkFieldMethodNameCollisions(lx, Comp);
     checkProvidesAreAddressable(lx, Comp);
     checkProvidedTypes(lx, Comp);
-    checkProvideNameCollisions(lx, Comp);
     checkLookupShapes(lx, Comp);
     checkLookupTypesResolve(lx, Comp);
     checkLookupsHaveProviders(lx, Comp);
@@ -6533,19 +6734,6 @@ function checkProvidedTypes(lx, Comp) {
     if (raw !== "self") lx.error(PROVIDE_TYPE_BAD_SHAPE, { name, value: raw });
   }
 }
-function checkProvideNameCollisions(lx, Comp) {
-  const scope = Comp.scope;
-  if (!scope) return;
-  for (const name in Comp.provide) {
-    for (let s = scope; s; s = s.parent) {
-      for (const otherName in s.byName) {
-        const Other = s.byName[otherName];
-        if (Other !== Comp && Other.provide?.[name] !== void 0)
-          lx.error(PROVIDE_NAME_COLLISION, { name, other: Other.name });
-      }
-    }
-  }
-}
 function checkLookupShapes(lx, Comp) {
   const raw = Comp._rawLookup;
   if (!Array.isArray(raw)) {
@@ -6586,8 +6774,8 @@ function checkLookupsHaveProviders(lx, Comp) {
   if (!scope) return;
   for (const name in Comp.lookup) {
     if (isTypeName2(name)) continue;
-    if (scope.lookupProvider?.(name)) continue;
-    const info = { name, hasDefault: Comp.lookup[name].val != null };
+    if (scope.hasProvider?.(name) || scope.lookupPath?.(name)) continue;
+    const info = { name, hasDefault: Comp.lookup[name] != null };
     if (info.hasDefault) lx.hint(LOOKUP_NO_PROVIDER, info);
     else lx.error(LOOKUP_NO_PROVIDER, info);
   }
@@ -6608,11 +6796,12 @@ function checkUnreferencedDynamics(lx, Comp, referencedDynamics) {
     }
   }
 }
-var KNOWN_COMPONENT_SPEC_KEYS, EMPTY_SET, FRAMEWORK_WELL_KNOWN_EXTRAS, KNOWN_DIRECTIVE_NAMES, isTypeName2, ALT_HANDLER_NOT_DEFINED, ALT_HANDLER_NOT_REFERENCED, DYN_VAL_NOT_DEFINED, DYN_ALIAS_NOT_REFERENCED, PROVIDE_NOT_ADDRESSABLE, PROVIDE_TYPE_BAD_SHAPE, PROVIDE_NAME_COLLISION, LOOKUP_BAD_SHAPE, LOOKUP_NO_PROVIDER, RENDER_IT_OUTSIDE_OF_LOOP, UNKNOWN_EVENT_MODIFIER, RECEIVE_HANDLER_NOT_IMPLEMENTED, EVENT_HANDLER_METHOD_NOT_ALLOWED, HANDLER_NAME_COLLISION, FIELD_VAL_NOT_DEFINED, FIELD_VAL_IS_METHOD, METHOD_VAL_NOT_DEFINED, METHOD_VAL_IS_FIELD, DUPLICATE_ATTR_DEFINITION, IF_NO_BRANCH_SET, UNKNOWN_COMPONENT_NAME, UNKNOWN_MACRO_ARG, UNKNOWN_DIRECTIVE, UNKNOWN_X_OP, UNKNOWN_X_ATTR, X_OP_IGNORES_CHILDREN, MAYBE_DROP_AT_PREFIX, MAYBE_ADD_AT_PREFIX, BAD_VALUE, UNSUPPORTED_EXPR_SYNTAX, BINDING_MEMBER_TOO_DEEP, SUGGEST_BINDING_MEMBER, REDUNDANT_TEMPLATE_STRING, PLACEHOLDERLESS_TEMPLATE_STRING, CONSTANT_CONDITION, UNKNOWN_COMPONENT_SPEC_KEY, COMP_FIELD_BAD_SHAPE, ASYNC_HANDLER, TOP_LEVEL_AT_RULE_IN_SCOPED_STYLE, GLOBAL_SELECTOR_IN_SCOPED_STYLE, FIELD_METHOD_NAME_COLLISION, X_KNOWN_OP_NAMES, X_KNOWN_ATTR_NAMES, HOST_DIRECTIVE_ONLY_NAMES, LEVEL_WARN2, LEVEL_ERROR2, LEVEL_HINT, PARSE_ISSUES, BINDING_MEMBER_TOO_DEEP_RE, UNSUPPORTED_EXPR_GUIDANCE, HTML_LINT_OPTS, NO_WRAPPERS2, ANY_EVENT_MODIFIERS, fixTo, BOOL_CONDITION_ORIGINS, isBoolConditionCtx, ATTR_VAL_CHECKERS, NODE_KIND_TO_CTX, HANDLER_CHANNELS, ASYNC_HANDLER_HELP, NON_NESTABLE_AT_RULE, GLOBAL_LEADING_SELECTOR, IGNORE_DIRECTIVE, blankRun, STYLE_TO_GLOBAL_HELP, KNOWN_LOOKUP_KEYS, LintContext, LintParseContext;
+var KNOWN_COMPONENT_SPEC_KEYS, EMPTY_SET, FRAMEWORK_WELL_KNOWN_EXTRAS, KNOWN_DIRECTIVE_NAMES, isTypeName2, ALT_HANDLER_NOT_DEFINED, ALT_HANDLER_NOT_REFERENCED, DYN_VAL_NOT_DEFINED, DYN_ALIAS_NOT_REFERENCED, PROVIDE_NOT_ADDRESSABLE, PROVIDE_TYPE_BAD_SHAPE, LOOKUP_BAD_SHAPE, LOOKUP_NO_PROVIDER, RENDER_IT_OUTSIDE_OF_LOOP, UNKNOWN_EVENT_MODIFIER, RECEIVE_HANDLER_NOT_IMPLEMENTED, EVENT_HANDLER_METHOD_NOT_ALLOWED, HANDLER_NAME_COLLISION, FIELD_VAL_NOT_DEFINED, FIELD_VAL_IS_METHOD, METHOD_VAL_NOT_DEFINED, METHOD_VAL_IS_FIELD, DUPLICATE_ATTR_DEFINITION, IF_NO_BRANCH_SET, UNKNOWN_COMPONENT_NAME, UNKNOWN_MACRO_ARG, UNKNOWN_DIRECTIVE, ORPHAN_DIRECTIVE, UNKNOWN_X_OP, UNKNOWN_X_ATTR, X_OP_IGNORES_CHILDREN, MAYBE_DROP_AT_PREFIX, MAYBE_ADD_AT_PREFIX, BAD_VALUE, UNSUPPORTED_EXPR_SYNTAX, BINDING_MEMBER_TOO_DEEP, SUGGEST_BINDING_MEMBER, REDUNDANT_TEMPLATE_STRING, PLACEHOLDERLESS_TEMPLATE_STRING, CONSTANT_CONDITION, UNKNOWN_COMPONENT_SPEC_KEY, COMP_FIELD_BAD_SHAPE, ASYNC_HANDLER, TOP_LEVEL_AT_RULE_IN_SCOPED_STYLE, GLOBAL_SELECTOR_IN_SCOPED_STYLE, FIELD_METHOD_NAME_COLLISION, X_KNOWN_OP_NAMES, X_KNOWN_ATTR_NAMES, HOST_DIRECTIVE_ONLY_NAMES, LEVEL_WARN2, LEVEL_ERROR2, LEVEL_HINT, PARSE_ISSUES, BINDING_MEMBER_TOO_DEEP_RE, UNSUPPORTED_EXPR_GUIDANCE, HTML_LINT_OPTS, NO_WRAPPERS2, ANY_EVENT_MODIFIERS, fixTo, BOOL_CONDITION_ORIGINS, isBoolConditionCtx, ATTR_VAL_CHECKERS, NODE_KIND_TO_CTX, HANDLER_CHANNELS, ASYNC_HANDLER_HELP, NON_NESTABLE_AT_RULE, GLOBAL_LEADING_SELECTOR, IGNORE_DIRECTIVE, blankRun, STYLE_TO_GLOBAL_HELP, KNOWN_LOOKUP_KEYS, LintContext, LintParseContext;
 var init_lint_check = __esm({
   "tools/core/lint-check.js"() {
     init_anode();
     init_components();
+    init_parsectx();
     init_htmllinter();
     init_closest_name();
     KNOWN_COMPONENT_SPEC_KEYS = new Set(
@@ -6646,7 +6835,6 @@ var init_lint_check = __esm({
     DYN_ALIAS_NOT_REFERENCED = "DYN_ALIAS_NOT_REFERENCED";
     PROVIDE_NOT_ADDRESSABLE = "PROVIDE_NOT_ADDRESSABLE";
     PROVIDE_TYPE_BAD_SHAPE = "PROVIDE_TYPE_BAD_SHAPE";
-    PROVIDE_NAME_COLLISION = "PROVIDE_NAME_COLLISION";
     LOOKUP_BAD_SHAPE = "LOOKUP_BAD_SHAPE";
     LOOKUP_NO_PROVIDER = "LOOKUP_NO_PROVIDER";
     RENDER_IT_OUTSIDE_OF_LOOP = "RENDER_IT_OUTSIDE_OF_LOOP";
@@ -6663,6 +6851,7 @@ var init_lint_check = __esm({
     UNKNOWN_COMPONENT_NAME = "UNKNOWN_COMPONENT_NAME";
     UNKNOWN_MACRO_ARG = "UNKNOWN_MACRO_ARG";
     UNKNOWN_DIRECTIVE = "UNKNOWN_DIRECTIVE";
+    ORPHAN_DIRECTIVE = "ORPHAN_DIRECTIVE";
     UNKNOWN_X_OP = "UNKNOWN_X_OP";
     UNKNOWN_X_ATTR = "UNKNOWN_X_ATTR";
     X_OP_IGNORES_CHILDREN = "X_OP_IGNORES_CHILDREN";
@@ -6697,6 +6886,7 @@ var init_lint_check = __esm({
     LEVEL_HINT = "hint";
     PARSE_ISSUES = {
       "unknown-directive": { id: UNKNOWN_DIRECTIVE, candidates: KNOWN_DIRECTIVE_NAMES },
+      "orphan-directive": { id: ORPHAN_DIRECTIVE },
       "unknown-x-op": { id: UNKNOWN_X_OP, candidates: X_KNOWN_OP_NAMES, atPrefix: X_KNOWN_OP_NAMES },
       "unknown-x-attr": {
         id: UNKNOWN_X_ATTR,
@@ -6851,13 +7041,14 @@ var init_lint_check = __esm({
         this.reports.push({ id, info, level, context: { ...this.frame }, suggestion });
       }
     };
-    LintParseContext = class extends ParseContext {
-      constructor(document2, Text, Comment) {
-        super(document2, Text, Comment);
+    LintParseContext = class extends ParseCtxClassSetCollector {
+      constructor(document2) {
+        super(document2);
         this.attrs = [];
         this.parseIssues = [];
       }
       onAttributes(attrs, wrapperAttrs, textChild, isMacroCall = false, tag = null) {
+        super.onAttributes(attrs, wrapperAttrs, textChild, isMacroCall, tag);
         this.attrs.push({ attrs, wrapperAttrs, textChild, isMacroCall, tag });
       }
       onParseIssue(kind, info) {
@@ -6974,7 +7165,7 @@ var init_lint_rules = __esm({
         code: LOOKUP_NO_PROVIDER,
         level: "error",
         group: "Dynamic bindings",
-        summary: "`lookup` name is provided by no component in scope."
+        summary: "`lookup` name is neither provided in scope nor a registered path."
       },
       {
         code: PROVIDE_TYPE_BAD_SHAPE,
@@ -6982,12 +7173,6 @@ var init_lint_rules = __esm({
         group: "Dynamic bindings",
         summary: 'A PascalCase `provide` publishes a component type; its value must be `"self"`.'
       },
-      {
-        code: PROVIDE_NAME_COLLISION,
-        level: "error",
-        group: "Dynamic bindings",
-        summary: "Two components in one scope chain `provide` the same name."
-      },
       // Templates / events
       {
         code: RENDER_IT_OUTSIDE_OF_LOOP,
@@ -7019,6 +7204,12 @@ var init_lint_rules = __esm({
         group: "Templates / events",
         summary: "`@directive` name is not recognized (typo or unsupported)."
       },
+      {
+        code: ORPHAN_DIRECTIVE,
+        level: "error",
+        group: "Templates / events",
+        summary: "`@when` / `@loop-with` without an `@each`, or `@then` / `@else` without an `@if`, on the same element — the directive is ignored."
+      },
       {
         code: UNKNOWN_X_OP,
         level: "error",
@@ -7276,19 +7467,19 @@ function lintIdToMessage(id, info) {
     case "DYN_ALIAS_NOT_REFERENCED":
       return `Lookup '${info.name}' is defined but never used — remove it or reference it as '*${info.name}' in a view`;
     case "PROVIDE_NOT_ADDRESSABLE":
-      return `Provide '${info.name}' value '${info.value}' must be a field ('.f') or seq-access ('.s[.k]') — a method/constant can't be a render target`;
+      return `Provide '${info.name}' value '${info.value}' must be a field ('.f') or seq-access ('.s[.k]') — a provide doubles as the path '<x render="*${info.name}">' resumes at, so this one is dropped and '*${info.name}' resolves to nothing`;
     case "LOOKUP_BAD_SHAPE":
       return `Lookup '${info.name}' has an invalid shape: ${info.problem}`;
     case "LOOKUP_NO_PROVIDER":
-      return info.hasDefault ? `Lookup '${info.name}' is provided by no component in scope, so it always resolves to its default` : `Lookup '${info.name}' is provided by no component in scope — add a 'provide' for it, or give this lookup a default`;
+      return info.hasDefault ? `Lookup '${info.name}' is provided by no component in scope and matches no registered path, so it always resolves to its default` : `Lookup '${info.name}' is provided by no component in scope and matches no registered path — add a 'provide' for it, register a path under that name, or give this lookup a default`;
     case "PROVIDE_TYPE_BAD_SHAPE":
       return `Provide '${info.name}' starts uppercase, so it publishes a component type — its value must be 'self', not '${info.value}'`;
-    case "PROVIDE_NAME_COLLISION":
-      return `Provide '${info.name}' is also provided by '${info.other}' in the same scope — one name, one provider, so a lookup can find it`;
     case "UNKNOWN_MACRO_ARG":
       return `Argument '${info.name}' is not declared in macro '${info.macroName}'`;
     case "UNKNOWN_DIRECTIVE":
       return `Unknown directive '@${info.name}=${JSON.stringify(info.value)}'${fmtTagSuffix(info)}`;
+    case "ORPHAN_DIRECTIVE":
+      return `'@${info.name}=${JSON.stringify(info.value)}' needs an '@${info.needs}' on the same element — it was ignored${fmtTagSuffix(info)}`;
     case "UNKNOWN_X_OP":
       return `Unknown <x> op '${info.name}=${JSON.stringify(info.value)}'${fmtTagSuffix(info)}`;
     case "UNKNOWN_X_ATTR":
@@ -12661,303 +12852,105 @@ function getComponentDoc(comp) {
     });
   }
   return {
-    name,
-    methods: userMethods,
-    receive: receiveHandlers,
-    intent: intentHandlers,
-    fields: fieldDocs
-  };
-}
-function docComponents(normalized, { name = null } = {}) {
-  const comps = normalized.components;
-  const picked = name === null ? comps : comps.filter((c) => c.name === name);
-  return new ComponentDocs({ items: picked.map((comp) => getComponentDoc(comp)) });
-}
-var init_docs = __esm({
-  "tools/core/docs.js"() {
-    init_results();
-  }
-});
-
-// tools/core/lint.js
-function lintComponents(normalized, { name = null, LintParseContextClass, wellKnownExtras = /* @__PURE__ */ new Set() }) {
-  const comps = normalized.components;
-  const picked = name === null ? comps : comps.filter((c) => c.name === name);
-  const stack = new ComponentStack();
-  stack.registerComponents(comps);
-  if (normalized.macros) stack.registerMacros(normalized.macros);
-  if (normalized.intentHandlers) stack.registerIntentHandlers(normalized.intentHandlers);
-  const results = [];
-  for (const comp of picked) {
-    comp.compile(LintParseContextClass);
-    const lx = checkComponent(comp, void 0, { wellKnownExtras });
-    results.push(
-      new LintComponentResult({
-        componentName: comp.name,
-        findings: lx.reports.map((r) => new LintFinding(r))
-      })
-    );
-  }
-  return new LintReport({ components: results });
-}
-var init_lint2 = __esm({
-  "tools/core/lint.js"() {
-    init_components();
-    init_lint_check();
-    init_results();
-  }
-});
-
-// tools/core/list.js
-function summarize(comp) {
-  const { fields: fieldMap, name } = comp;
-  const fields = [];
-  for (const fieldName in fieldMap) {
-    const f = fieldMap[fieldName];
-    fields.push({ name: fieldName, type: f.type });
-  }
-  return new ComponentSummary({
-    name,
-    views: Object.keys(comp.views ?? {}),
-    fields
-  });
-}
-function listComponents(normalized, { name = null, limit = 0 } = {}) {
-  const comps = normalized.components;
-  const picked = name === null ? comps : comps.filter((c) => c.name === name);
-  const total = picked.length;
-  const capped = limit > 0 ? picked.slice(0, limit) : picked;
-  return new ComponentList({
-    items: capped.map(summarize),
-    total,
-    truncated: capped.length < total
-  });
-}
-function listExamples(normalized, { limit = 0 } = {}) {
-  const sections = normalized.sections;
-  const total = sections.reduce((n, s) => n + (s.items?.length ?? 0), 0);
-  if (limit <= 0) {
-    return new ExampleIndex({ sections, total, truncated: false });
-  }
-  const capped = [];
-  let remaining = limit;
-  for (const s of sections) {
-    if (remaining <= 0) break;
-    const items = s.items.slice(0, remaining);
-    capped.push({ ...s, items });
-    remaining -= items.length;
-  }
-  return new ExampleIndex({
-    sections: capped,
-    total,
-    truncated: capped.reduce((n, s) => n + s.items.length, 0) < total
-  });
-}
-var init_list = __esm({
-  "tools/core/list.js"() {
-    init_results();
-  }
-});
-
-// src/stack.js
-function routeLookup(route, lex, dyn) {
-  for (let i = 0; i < route.length; i++) {
-    const leg = route[i];
-    if (leg === "dyn") {
-      const v = dyn();
-      if (v != null) return v;
-    } else if (leg === "lex") {
-      const v = lex();
-      if (v != null) return v;
-    } else {
-      console.warn("unknown lookup route leg", leg, '- expected "dyn" or "lex"');
-    }
-  }
-  return null;
-}
-function lookup(chain, name, dv = null) {
-  let n = chain;
-  while (n !== null) {
-    const r = n[0].lookup(name);
-    if (r === STOP) return dv;
-    if (r !== NEXT) return r;
-    n = n[1];
-  }
-  return dv;
-}
-function computeViewsId(views) {
-  let s = "";
-  let n = views;
-  while (n !== null) {
-    s += n[0];
-    n = n[1];
-  }
-  return s === "main" ? "" : s;
-}
-var STOP, NEXT, DEFAULT_ROUTE, BindFrame, ObjectFrame, Stack;
-var init_stack = __esm({
-  "src/stack.js"() {
-    STOP = /* @__PURE__ */ Symbol("STOP");
-    NEXT = /* @__PURE__ */ Symbol("NEXT");
-    DEFAULT_ROUTE = ["dyn", "lex"];
-    BindFrame = class {
-      constructor(it, binds, isFrame) {
-        this.it = it;
-        this.binds = binds;
-        this.isFrame = isFrame;
-      }
-      lookup(name) {
-        const v = this.binds[name];
-        return v === void 0 ? this.isFrame ? STOP : NEXT : v;
-      }
-    };
-    ObjectFrame = class {
-      constructor(binds) {
-        this.binds = binds;
-      }
-      lookup(key) {
-        const v = this.binds[key];
-        return v === void 0 ? NEXT : v;
-      }
-    };
-    Stack = class _Stack {
-      constructor(comps, it, binds, dynBinds, views, viewsId, ctx = null) {
-        this.comps = comps;
-        this.it = it;
-        this.binds = binds;
-        this.dynBinds = dynBinds;
-        this.views = views;
-        this.viewsId = viewsId;
-        this.ctx = ctx;
-      }
-      // Evaluate every provide the entered component publishes and push them as one
-      // dynBinds frame, keyed by NAME. Published types go in the same frame: a type name
-      // starts A-Z and a value name does not, so the two namespaces cannot collide and
-      // nearest-ancestor-wins falls out of frame order for both. No-op with no provides.
-      _pushProvides() {
-        const comp = this.comps.getCompFor(this.it);
-        if (comp == null) return this;
-        const { provide, provideType } = comp;
-        const dynObj = {};
-        let has2 = false;
-        for (const k in provide) {
-          dynObj[k] = provide[k].val.eval(this);
-          has2 = true;
-        }
-        for (const k in provideType) {
-          dynObj[k] = provideType[k];
-          has2 = true;
-        }
-        if (!has2) return this;
-        const newDynBinds = [new ObjectFrame(dynObj), this.dynBinds];
-        const { comps, it, binds, views, viewsId, ctx } = this;
-        return new _Stack(comps, it, binds, newDynBinds, views, viewsId, ctx);
-      }
-      static root(comps, it, ctx) {
-        const binds = [new BindFrame(it, {}, true), null];
-        const dynBinds = [new ObjectFrame({}), null];
-        const views = ["main", null];
-        return new _Stack(comps, it, binds, dynBinds, views, "", ctx)._pushProvides();
-      }
-      enter(it, bindings = {}, isFrame = true) {
-        const { comps, binds, dynBinds, views, viewsId, ctx } = this;
-        const newBinds = [new BindFrame(it, bindings, isFrame), binds];
-        const stack = new _Stack(comps, it, newBinds, dynBinds, views, viewsId, ctx);
-        return isFrame ? stack._pushProvides() : stack;
-      }
-      pushViewName(name) {
-        const { comps, it, binds, dynBinds, views, ctx } = this;
-        const newViews = [name, views];
-        return new _Stack(comps, it, binds, dynBinds, newViews, computeViewsId(newViews), ctx);
-      }
-      // Published types are stable per scope and would only churn the render cache, so
-      // the cache key covers values alone.
-      _pushDynBindValuesToArray(arr, comp) {
-        for (const k in comp.provide) arr.push(this.lookupDynamic(k));
-        for (const k in comp.lookup) arr.push(this.lookupDynamic(k));
-      }
-      // `*name`: the nearest binding above (including this component's own provides,
-      // pushed on entering it), else this component's declared default, else null.
-      lookupDynamic(name) {
-        const v = lookup(this.dynBinds, name);
-        if (v != null) return v;
-        const comp = this.comps.getCompFor(this.it);
-        return comp?.lookup[name]?.val?.eval(this) ?? null;
-      }
-      lookupBind(name) {
-        return lookup(this.binds, name);
-      }
-      lookupFieldRaw(name) {
-        return this.it[name] ?? null;
-      }
-      lookupMethod(name) {
-        const fn = this.it[name];
-        return fn instanceof Function ? fn.call(this.it) : null;
-      }
-      // The dispatched DOM event / drag info, read only by EventMemberVal's
-      // `e.<member>` handler args. Null outside a live event transaction.
-      lookupEvent() {
-        return this.ctx?.event ?? null;
-      }
-      lookupDragInfo() {
-        return this.ctx?.dragInfo ?? null;
-      }
-      getHandlerFor(name, key) {
-        return this.comps.getHandlerFor(this.it, name, key);
-      }
-      lookupBestView(views, defaultViewName) {
-        let n = this.views;
-        while (n !== null) {
-          const view = views[n[0]];
-          if (view !== void 0) return view;
-          n = n[1];
-        }
-        return views[defaultViewName];
-      }
-    };
+    name,
+    methods: userMethods,
+    receive: receiveHandlers,
+    intent: intentHandlers,
+    fields: fieldDocs
+  };
+}
+function docComponents(normalized, { name = null } = {}) {
+  const comps = normalized.components;
+  const picked = name === null ? comps : comps.filter((c) => c.name === name);
+  return new ComponentDocs({ items: picked.map((comp) => getComponentDoc(comp)) });
+}
+var init_docs = __esm({
+  "tools/core/docs.js"() {
+    init_results();
   }
 });
 
-// src/oo.js
-function mkCompField(field, scope, args) {
-  const Comp = scope?.lookupComponent(field.type) ?? null;
-  if (Comp === null)
-    console.warn(
-      scope ? `component field "${field.name}": component "${field.type}" not found in scope` : `component field "${field.name}": cannot resolve component "${field.type}" — built without a registered scope (use ${field.type}.make({}) as the default, or build via a registered component)`
+// tools/core/lint.js
+function lintComponents(normalized, { name = null, LintParseContextClass, wellKnownExtras = /* @__PURE__ */ new Set() }) {
+  const comps = normalized.components;
+  const picked = name === null ? comps : comps.filter((c) => c.name === name);
+  const stack = new ComponentStack();
+  stack.registerComponents(comps);
+  if (normalized.macros) stack.registerMacros(normalized.macros);
+  if (normalized.intentHandlers) stack.registerIntentHandlers(normalized.intentHandlers);
+  const results = [];
+  for (const comp of picked) {
+    comp.compile(LintParseContextClass);
+    const lx = checkComponent(comp, void 0, { wellKnownExtras });
+    results.push(
+      new LintComponentResult({
+        componentName: comp.name,
+        findings: lx.reports.map((r) => new LintFinding(r))
+      })
     );
-  return Comp?.make({ ...field.args, ...args }, { scope }) ?? null;
-}
-function fieldFromDescriptor(name, value) {
-  const FieldCls = fieldsByTypeName[value.type] ?? FieldAny;
-  const probe = new FieldCls(name);
-  return [FieldCls, probe.coerceOr(value.defaultValue, probe.defaultValue)];
-}
-function classFromData(name, { fields = {}, methods, statics }) {
-  const b = new ClassBuilder(name);
-  for (const field in fields) {
-    const value = fields[field];
-    const type3 = typeof value;
-    if (type3 === "string") b.addField(field, value, FieldString);
-    else if (type3 === "number") b.addField(field, value, FieldFloat);
-    else if (type3 === "boolean") b.addField(field, value, FieldBool);
-    else if (Array.isArray(value)) b.addField(field, [...value], FieldList);
-    else if (value instanceof Set) b.addField(field, new Set(value), FieldSet);
-    else if (value instanceof Map) b.addField(field, new Map(value), FieldMap);
-    else if (value?.type && Object.hasOwn(value, "defaultValue")) {
-      const [FieldCls, dval] = fieldFromDescriptor(field, value);
-      b.addField(field, dval, FieldCls);
-    } else if (value?.component && value?.args !== void 0)
-      b.addCompField(field, value.component, value.args);
-    else if (isPlainObject(value)) b.addField(field, { ...value }, FieldObject);
-    else {
-      const FieldCls = value?.[FIELD_CLASS] ?? FieldAny;
-      b.addField(field, value, FieldCls);
-    }
   }
-  if (methods) b.methods(methods);
-  if (statics) b.statics(statics);
-  return b.build();
+  return new LintReport({ components: results });
+}
+var init_lint2 = __esm({
+  "tools/core/lint.js"() {
+    init_components();
+    init_lint_check();
+    init_results();
+  }
+});
+
+// tools/core/list.js
+function summarize(comp) {
+  const { fields: fieldMap, name } = comp;
+  const fields = [];
+  for (const fieldName in fieldMap) {
+    const f = fieldMap[fieldName];
+    fields.push({ name: fieldName, type: f.type });
+  }
+  return new ComponentSummary({
+    name,
+    views: Object.keys(comp.views ?? {}),
+    fields
+  });
+}
+function listComponents(normalized, { name = null, limit = 0 } = {}) {
+  const comps = normalized.components;
+  const picked = name === null ? comps : comps.filter((c) => c.name === name);
+  const total = picked.length;
+  const capped = limit > 0 ? picked.slice(0, limit) : picked;
+  return new ComponentList({
+    items: capped.map(summarize),
+    total,
+    truncated: capped.length < total
+  });
+}
+function listExamples(normalized, { limit = 0 } = {}) {
+  const sections = normalized.sections;
+  const total = sections.reduce((n, s) => n + (s.items?.length ?? 0), 0);
+  if (limit <= 0) {
+    return new ExampleIndex({ sections, total, truncated: false });
+  }
+  const capped = [];
+  let remaining = limit;
+  for (const s of sections) {
+    if (remaining <= 0) break;
+    const items = s.items.slice(0, remaining);
+    capped.push({ ...s, items });
+    remaining -= items.length;
+  }
+  return new ExampleIndex({
+    sections: capped,
+    total,
+    truncated: capped.reduce((n, s) => n + s.items.length, 0) < total
+  });
 }
+var init_list = __esm({
+  "tools/core/list.js"() {
+    init_results();
+  }
+});
+
+// src/oo.js
 function validateDraftFields(current2, draft) {
   const meta = metaOf(current2);
   if (!meta) return;
@@ -12972,226 +12965,41 @@ function validateDraftFields(current2, draft) {
     }
   }
 }
-function assertNoReservedComponentStatics(statics = {}) {
-  for (const name in statics) {
-    if (RESERVED_COMPONENT_STATICS.has(name)) {
-      throw new TypeError(`component static "${name}" is reserved by the framework`);
-    }
-  }
-}
-var BAD_VALUE2, nullCoercer, Field, CHECK_TYPE_ANY, CHECK_TYPE_INT, CHECK_TYPE_FLOAT, CHECK_TYPE_BOOL, CHECK_TYPE_STRING, CHECK_TYPE_LIST, CHECK_TYPE_OBJECT, CHECK_TYPE_MAP, CHECK_TYPE_SET, COERCE_NONE, COERCE_BOOL, COERCE_STRING, COERCE_INT, COERCE_LIST, COERCE_OBJECT, COERCE_MAP, COERCE_SET, FieldBool, FieldAny, FieldString, FieldInt, FieldFloat, metaOf, getTypeName, FieldComp, FieldList, FieldObject, FieldMap, FieldSet, ClassBuilder, FIELD_CLASS, fieldsByTypeName, META_KEYS, RESERVED_COMPONENT_STATICS;
+var BAD_VALUE2, COERCE_NONE, COERCE_MAP, FIELD_TYPES, metaOf, RESERVED_COMPONENT_STATICS;
 var init_oo = __esm({
   "src/oo.js"() {
     init_collection();
     init_components();
-    init_immer2();
     BAD_VALUE2 = /* @__PURE__ */ Symbol("BadValue");
-    nullCoercer = (v) => v;
-    Field = class {
-      constructor(type3, name, typeCheck, coercer, defaultValue = null) {
-        this.type = type3;
-        this.name = name;
-        this.typeCheck = typeCheck;
-        this.coercer = coercer;
-        this.defaultValue = defaultValue;
-      }
-      isValid(v) {
-        return this.typeCheck(v);
-      }
-      coerceOr(v, defaultValue = null) {
-        if (this.isValid(v)) return v;
-        const v1 = this.coercer(v);
-        return this.isValid(v1) ? v1 : defaultValue;
-      }
-      coerceOrDefault(v) {
-        return this.coerceOr(v, this.defaultValue);
-      }
-    };
-    CHECK_TYPE_ANY = (_v) => true;
-    CHECK_TYPE_INT = Number.isInteger;
-    CHECK_TYPE_FLOAT = Number.isFinite;
-    CHECK_TYPE_BOOL = (v) => typeof v === "boolean";
-    CHECK_TYPE_STRING = (v) => typeof v === "string";
-    CHECK_TYPE_LIST = Array.isArray;
-    CHECK_TYPE_OBJECT = isPlainObject;
-    CHECK_TYPE_MAP = (v) => v instanceof Map;
-    CHECK_TYPE_SET = (v) => v instanceof Set;
     COERCE_NONE = (_v) => null;
-    COERCE_BOOL = (v) => !!v;
-    COERCE_STRING = (v) => v?.toString?.() ?? "";
-    COERCE_INT = (v) => Number.isFinite(v) ? Math.trunc(v) : null;
-    COERCE_LIST = (v) => Array.isArray(v) ? [...v] : null;
-    COERCE_OBJECT = (v) => isPlainObject(v) ? { ...v } : null;
     COERCE_MAP = (v) => {
       if (v instanceof Map) return new Map(v);
       if (Array.isArray(v) || isPlainObject(v))
         return new Map(Array.isArray(v) ? v : Object.entries(v));
       return null;
     };
-    COERCE_SET = (v) => v instanceof Set || Array.isArray(v) ? new Set(v) : null;
-    FieldBool = class extends Field {
-      constructor(name, defaultValue = false) {
-        super("bool", name, CHECK_TYPE_BOOL, COERCE_BOOL, defaultValue);
-      }
-    };
-    FieldAny = class extends Field {
-      constructor(name, defaultValue = null) {
-        super("any", name, CHECK_TYPE_ANY, nullCoercer, defaultValue);
-      }
-    };
-    FieldString = class extends Field {
-      constructor(name, defaultValue = "") {
-        super("text", name, CHECK_TYPE_STRING, COERCE_STRING, defaultValue);
-      }
-    };
-    FieldInt = class extends Field {
-      constructor(name, defaultValue = 0) {
-        super("int", name, CHECK_TYPE_INT, COERCE_INT, defaultValue);
-      }
-    };
-    FieldFloat = class extends Field {
-      constructor(name, defaultValue = 0) {
-        super("float", name, CHECK_TYPE_FLOAT, COERCE_NONE, defaultValue);
-      }
-    };
-    metaOf = (v) => v?.constructor?.[COMPONENT] ?? v?.constructor?.getMetaClass?.();
-    getTypeName = (v) => metaOf(v)?.name ?? null;
-    FieldComp = class extends Field {
-      constructor(type3, name, args) {
-        super(type3, name, (v) => getTypeName(v) === type3, nullCoercer, null);
-        this.args = args;
-      }
-    };
-    FieldList = class extends Field {
-      constructor(name, defaultValue = []) {
-        super("list", name, CHECK_TYPE_LIST, COERCE_LIST, defaultValue);
-      }
-    };
-    FieldObject = class extends Field {
-      constructor(name, defaultValue = {}) {
-        super("object", name, CHECK_TYPE_OBJECT, COERCE_OBJECT, defaultValue);
-      }
-    };
-    FieldMap = class extends Field {
-      constructor(name, defaultValue = /* @__PURE__ */ new Map()) {
-        super("map", name, CHECK_TYPE_MAP, COERCE_MAP, defaultValue);
-      }
-    };
-    FieldSet = class extends Field {
-      constructor(name, defaultValue = /* @__PURE__ */ new Set()) {
-        super("set", name, CHECK_TYPE_SET, COERCE_SET, defaultValue);
-      }
+    FIELD_TYPES = {
+      any: [(_v) => true, COERCE_NONE, () => null],
+      text: [(v) => typeof v === "string", (v) => v?.toString?.() ?? "", () => ""],
+      int: [Number.isInteger, (v) => Number.isFinite(v) ? Math.trunc(v) : null, () => 0],
+      float: [Number.isFinite, COERCE_NONE, () => 0],
+      bool: [(v) => typeof v === "boolean", (v) => !!v, () => false],
+      list: [Array.isArray, (v) => Array.isArray(v) ? [...v] : null, () => []],
+      object: [isPlainObject, (v) => isPlainObject(v) ? { ...v } : null, () => ({})],
+      map: [(v) => v instanceof Map, COERCE_MAP, () => /* @__PURE__ */ new Map()],
+      set: [
+        (v) => v instanceof Set,
+        (v) => v instanceof Set || Array.isArray(v) ? new Set(v) : null,
+        () => /* @__PURE__ */ new Set()
+      ]
     };
-    ClassBuilder = class {
-      constructor(name) {
-        this.name = name;
-        this.fields = {};
-        this.compFields = /* @__PURE__ */ new Set();
-        this._methods = {};
-        this._statics = {};
-      }
-      build() {
-        const { name, fields, compFields, _methods } = this;
-        const defaults = Object.fromEntries(
-          Object.entries(fields).map(([fieldName, field]) => [fieldName, field.defaultValue])
-        );
-        const Class = {
-          [name]: class {
-            constructor(values = {}) {
-              Object.assign(this, defaults, values);
-            }
-          }
-        }[name];
-        Class[DRAFTABLE] = true;
-        Object.assign(Class.prototype, _methods);
-        const metaClass = { fields, name, methods: _methods };
-        Object.assign(
-          Class,
-          {
-            getMetaClass: () => metaClass,
-            make(inArgs = {}, opts = {}) {
-              const args = {};
-              const scope = opts.scope ?? this[COMPONENT]?.scope ?? this.scope;
-              for (const key in inArgs) {
-                const field = fields[key];
-                if (compFields.has(key)) args[key] = mkCompField(field, scope, inArgs[key]);
-                else if (field === void 0)
-                  console.warn("extra argument to constructor:", name, key, inArgs);
-                else args[key] = field.coerceOrDefault(inArgs[key]);
-              }
-              for (const key of compFields)
-                if (args[key] === void 0) args[key] = mkCompField(fields[key], scope, inArgs[key]);
-              return freeze(new this(args), true);
-            }
-          },
-          this._statics
-        );
-        return Class;
-      }
-      methods(proto) {
-        for (const k in proto) this._methods[k] = proto[k];
-      }
-      statics(proto) {
-        for (const k in proto) this._statics[k] = proto[k];
-      }
-      addField(name, dval, FieldCls) {
-        const field = new FieldCls(name, dval);
-        this.fields[name] = field;
-        return field;
-      }
-      addCompField(name, type3, args) {
-        const field = new FieldComp(type3, name, args);
-        this.compFields.add(name);
-        this.fields[name] = field;
-        return field;
-      }
-    };
-    FIELD_CLASS = /* @__PURE__ */ Symbol.for("tutuca.fieldClass");
-    fieldsByTypeName = {
-      text: FieldString,
-      int: FieldInt,
-      float: FieldFloat,
-      bool: FieldBool,
-      list: FieldList,
-      object: FieldObject,
-      map: FieldMap,
-      set: FieldSet,
-      any: FieldAny
-    };
-    META_KEYS = "name id fields methods views receive intent alter provide provideType lookup spec extra commonStyle globalStyle scope _rawProvide _rawLookup".split(
-      " "
-    );
+    metaOf = (v) => v?.constructor?.getMetaClass?.();
     RESERVED_COMPONENT_STATICS = /* @__PURE__ */ new Set([
-      ...META_KEYS,
-      "make",
-      "getMetaClass",
-      ...Object.getOwnPropertyNames(Component.prototype)
+      ..."name id fields methods views receive intent alter provide provideType lookup spec extra commonStyle globalStyle scope _rawProvide _rawLookup make getMetaClass".split(
+        " "
+      ),
+      ...Object.keys(COMPONENT_METHODS)
     ]);
-    Component.fromSpec = (opts) => {
-      assertNoReservedComponentStatics(opts.statics);
-      const Class = classFromData(opts.name, opts);
-      const comp = new Component(Class, opts);
-      const metaClass = Class.getMetaClass();
-      comp.fields = metaClass.fields;
-      comp.methods = metaClass.methods;
-      Class.getMetaClass = () => comp;
-      Class[COMPONENT] = comp;
-      for (const key of META_KEYS)
-        if (!Object.hasOwn(Class, key))
-          Object.defineProperty(Class, key, {
-            get() {
-              return comp[key];
-            },
-            set(v) {
-              comp[key] = v;
-            },
-            configurable: true
-          });
-      for (const key of Object.getOwnPropertyNames(Component.prototype))
-        if (key !== "constructor" && !Object.hasOwn(Class, key))
-          Class[key] = (...args) => comp[key](...args);
-      return Class;
-    };
   }
 });
 
@@ -13199,11 +13007,22 @@ var init_oo = __esm({
 function nullHandler() {
   return this;
 }
+function subscribe(list, cb) {
+  list.push(cb);
+  return () => {
+    const i = list.indexOf(cb);
+    if (i !== -1) list.splice(i, 1);
+  };
+}
+function warnUnknownLeg(what, leg) {
+  console.warn(`unknown ${what} route leg`, leg, '- expected "dyn" or "lex"');
+  return null;
+}
 function warnNotIntent(verb) {
   console.warn(`ctx.${verb}() is only meaningful in an "intent" handler - ignored`);
 }
 function rootDispatcher(transactor) {
-  return new Dispatcher(new Path([]), transactor, null);
+  return new Dispatcher(new DispatchPath(), transactor, null);
 }
 var State2, Transactor, Transaction, InputEvent, NameArgsTransaction, SendEvent, IntentEvent, PASS, REFUSAL_RING_CAP, INTENT_DEPTH, IntentWalk, Completion, Dispatcher, EventContext, PathChanges;
 var init_transactor = __esm({
@@ -13251,14 +13070,7 @@ var init_transactor = __esm({
       // carry: kind, name, args, path, pathKeys, targetPath, handler, handlerName,
       // matched, before, after, parent, timestamp. Purely observational.
       observe(cb) {
-        this._observers.push(cb);
-        return () => {
-          const i = this._observers.indexOf(cb);
-          if (i !== -1) this._observers.splice(i, 1);
-        };
-      }
-      _emit(record) {
-        for (const cb of this._observers) cb(record);
+        return subscribe(this._observers, cb);
       }
       // Record a refusal: a dispatch the runtime could not carry out. Kinds are
       // open strings; today the runtime raises NO_HANDLER (a receive name with no
@@ -13277,11 +13089,7 @@ var init_transactor = __esm({
       // Subscribe to refusal records as they happen. Returns an unsubscribe fn,
       // like observe().
       observeRefusals(cb) {
-        this._refusalObservers.push(cb);
-        return () => {
-          const i = this._refusalObservers.indexOf(cb);
-          if (i !== -1) this._refusalObservers.splice(i, 1);
-        };
+        return subscribe(this._refusalObservers, cb);
       }
       // Build and dispatch one observer record. Pins field-resolved keys (e.g. a
       // `.a[.selId]` render target reconstructed from a DOM event) against the root the
@@ -13290,7 +13098,7 @@ var init_transactor = __esm({
       _emitRecord(root, { kind, name, args, path, targetPath, handler, handlerName, matched, before, after, parent }) {
         if (this._observers.length === 0) return;
         const pinned = path.pinKeys(root);
-        this._emit({
+        const record = {
           kind,
           name,
           args: args ?? null,
@@ -13304,14 +13112,14 @@ var init_transactor = __esm({
           after,
           parent,
           timestamp: Date.now()
-        });
+        };
+        for (const cb of this._observers) cb(record);
       }
       // The observer record for a settled transaction. The resolved handler
       // (`_resolvedHandler`/`_matched`) and per-leaf before/after (`_before`/`_after`)
       // were captured while the handler ran (see callHandler / Transaction.run).
       _emitTransaction(transaction, root) {
         if (this._observers.length === 0) return;
-        if (transaction._resolvedHandler === void 0) return;
         this._emitRecord(root, {
           kind: transaction.observeKind,
           name: transaction.observeName,
@@ -13325,26 +13133,22 @@ var init_transactor = __esm({
           parent: transaction.parentTransaction
         });
       }
-      // Make `child` a tracked unit of `parent`'s subtree: the parent's completion stays open
-      // until the child's *whole* subtree settles. Tracking happens at dispatch time — during
-      // the parent's handler or afterTransaction — while the parent's self-unit is still held,
-      // so the parent counter can't reach zero before the child is registered. Returns `child`.
-      _link(child, parent) {
-        if (parent) {
-          const release = parent.completion.track();
-          child.completion.whenSubtreeSettled().then(release);
-        }
-        return child;
-      }
       // `origin` is where the message came FROM, pinned now for the same reason an
       // intent's answerPath is: a reply must reach the sender that asked even if a key
       // moved while the message was in flight. Null when nobody is waiting — a host
       // sendAtRoot or a view's own `@on.*` — and ctx.sendReply refuses on that.
-      pushSend(path, name, args = [], parent = null, origin = null) {
+      //
+      // The parent's subtree stays open until this message's whole subtree settles. The
+      // unit is taken now, at dispatch — during the parent's handler or afterTransaction,
+      // while the parent's self-unit is still held — so its counter can't reach zero first.
+      pushSend(path, name, args = [], parent = null, origin = null, txnPath = null) {
         const t = new SendEvent(path, this, name, args, parent);
-        t.origin = origin === null ? null : origin.toTransactionPath().pinKeys(this.state.val);
+        t.txnPath = txnPath;
+        t.origin = origin;
+        t.originPinned = origin === null ? null : origin.toTransactionPath().pinKeys(this.state.val);
         this.pushTransaction(t);
-        return this._link(t, parent);
+        if (parent) t.completion.carry(parent.completion.track());
+        return t;
       }
       // Raise an intent: a job the sender did not address, walked along a route until
       // something answers. `opts.route` is a list of legs (see DEFAULT_ROUTE) and
@@ -13368,7 +13172,7 @@ var init_transactor = __esm({
         return this.transactions.length > 0;
       }
       transactNext() {
-        if (this.hasPendingTransactions) this.transact(this.transactions.shift());
+        this.transact(this.transactions.shift());
       }
       transact(transaction) {
         try {
@@ -13381,8 +13185,7 @@ var init_transactor = __esm({
           } else console.warn("undefined new state", { curState, transaction });
         } finally {
           transaction.ensureWalkAdvanced?.();
-          transaction._completion?.ensureSelfSettled();
-          transaction._completion?.releaseSelf();
+          transaction._completion?.finish();
         }
       }
       transactInputNow(path, event, eventHandler, dragInfo) {
@@ -13392,6 +13195,7 @@ var init_transactor = __esm({
     Transaction = class {
       constructor(path, transactor, parentTransaction = null) {
         this.path = path;
+        this.txnPath = null;
         this.transactor = transactor;
         this.parentTransaction = parentTransaction;
         this._completion = null;
@@ -13411,39 +13215,41 @@ var init_transactor = __esm({
       whenSubtreeSettled() {
         return this.completion.whenSubtreeSettled();
       }
-      afterTransaction() {
-      }
-      // Ending a walk and forwarding belong to the two dispatch buckets; the base warns
-      // rather than throwing, so a stray call from the wrong place is a message and not a
-      // crash. `walk` is undefined here, which is how ctx.reply/ctx.fail tell the two apart.
-      stop() {
-        warnNotIntent("stop");
-      }
-      forward(_opts) {
-        console.warn('ctx.forward() needs a "receive" or "intent" handler - ignored');
-      }
-      // The kind reported to observers (see Transactor.observe); null on the base.
-      get observeKind() {
-        return null;
-      }
-      // The name reported to observers; null on the base. Overridden by NameArgs (the
-      // dispatched message name) and InputEvent (the DOM event type). Kept separate from
-      // `name`/`ctx.name` so it can't change handler-visible behavior.
-      get observeName() {
-        return null;
-      }
+      // Every transaction kind defines `observeKind` / `observeName` (what observers see;
+      // kept apart from `name`/`ctx.name` so they can't change handler-visible behavior),
+      // `getHandlerAndArgs(root, instance, comps)`, and the three `_forward*` hooks below.
       callHandler(root, instance, draft, comps) {
         const [handler, args] = this.getHandlerAndArgs(root, instance, comps);
         this._resolvedHandler = handler;
         return handler.apply(instance, [draft, ...args]);
       }
-      getHandlerAndArgs(_root, _instance, _comps) {
-        return null;
+      // `forward` is where a name can LEAVE the component: the message being handled is
+      // raised again as an INTENT under the same name (`_forwardName()`) with the same
+      // arguments unless `opts.args` says otherwise, from the position `_forwardPath()`
+      // names. Deferred to afterTransaction so the state the handler produced is in place
+      // before the walk starts. (`IntentEvent` overrides both: in an intent body, forward
+      // amends the walk that is already running.)
+      forward(opts) {
+        this._forward = opts ?? {};
+      }
+      afterTransaction() {
+        const f = this._forward;
+        if (f === void 0) return;
+        this._forward = void 0;
+        const name = this._forwardName();
+        if (name === void 0) {
+          this.transactor.refuse("FORWARD_NO_NAME", {});
+          return;
+        }
+        const { args = this._forwardArgs(), ...rest } = f;
+        this.transactor.pushIntent(this._forwardPath(), name, args, rest, this);
       }
-      // The path used to apply the mutation. Teleports dynamic-var renders so it lands on
-      // the data's real location (the dispatch `this.path` keeps intermediates).
+      // The path used to apply the mutation: the ACTIVE frame of the dispatch path, so
+      // an event inside a `<x render="*name">` subtree updates the value where it
+      // really lives (the dispatch `this.path` keeps the visual callers, for bubbling).
+      // `txnPath`, when pinned by the sender, wins.
       getTransactionPath() {
-        return this.path.toTransactionPath().compact();
+        return this.txnPath ?? this.path.toTransactionPath();
       }
       run(curRoot, comps) {
         const txnPath = this.getTransactionPath();
@@ -13467,12 +13273,20 @@ var init_transactor = __esm({
         this.dragInfo = dragInfo;
         this._dispatchPath = null;
       }
-      // Frame steps removed, DynStep + one step per crossed component kept: bubbling
-      // it visits every component (including intermediates of a dynamic-var render).
+      // Frame-only steps removed, one step per crossed component kept — inside every
+      // continuation frame independently, so bubbling it visits every component and
+      // then returns to the caller that wrote the `*name`.
       get dispatchPath() {
         this._dispatchPath ??= this.path.compact();
         return this._dispatchPath;
       }
+      // Only a DOM event's path carries frame-only bind steps (they replay the handler's
+      // arguments, but address no state); the compacted path is where the mutation lands,
+      // so a handler inside @each still updates the component that owns the view. Every
+      // other transaction is dispatched at an already-compacted position.
+      getTransactionPath() {
+        return this.dispatchPath.toTransactionPath();
+      }
       // A DOM event is an ADDRESSED message like any other — it reaches the component that
       // owns the view and stops. It keeps its own class only because it resolves its handler
       // from the compiled view and runs synchronously, not because it is a different channel.
@@ -13482,40 +13296,29 @@ var init_transactor = __esm({
       get observeName() {
         return this.e?.type ?? null;
       }
-      // A view's name is a message. `forward` is where that name can LEAVE the component:
-      // it becomes an intent with the same name and the same arguments, so a view that says
-      // `@on.click="saveDraft .text"` never has to change when an ancestor takes the job over.
-      // (A `$method` handler has a name too, so forwarding one raises an intent under it.)
-      forward(opts) {
-        this._forward = opts ?? {};
-      }
-      afterTransaction() {
-        const f = this._forward;
-        if (f === void 0) return;
-        this._forward = void 0;
-        const { args = this._handlerArgs ?? [], ...rest } = f;
+      // A view's name is a message, and forwarding it means a view that says
+      // `@on.click="saveDraft .text"` never has to change when an ancestor takes the job
+      // over. (A `$method` handler has a name too, so forwarding one raises an intent under
+      // it.) `handler` is a NodeEvent, whose own `name` is the DOM event type; the MESSAGE
+      // name is the one the view wrote, on the handler call it wraps.
+      _forwardName() {
         const hv = this.handler?.handlerCall?.handlerVal ?? this.handler?.handlerVal;
-        const name = hv?.name;
-        if (name === void 0) {
-          this.transactor.refuse("FORWARD_NO_NAME", {});
-          return;
-        }
-        this.transactor.pushIntent(this.dispatchPath, name, args, rest, this);
+        return hv?.name;
+      }
+      _forwardArgs() {
+        return this._handlerArgs ?? [];
+      }
+      _forwardPath() {
+        return this.dispatchPath;
       }
       getHandlerAndArgs(root, _instance, comps) {
-        const stack = this.path.toTransactionPath().buildStack(Stack.root(comps, root, this));
+        const stack = this.path.buildStack(Stack.root(comps, root, this));
         const [handler, args] = this.handler.getHandlerAndArgs(stack, this);
         this._handlerArgs = [...args];
         const path = this.dispatchPath;
         args.push(new EventContext(path, this.transactor, this));
         return [handler, args];
       }
-      // The dispatched DOM event, read only through `e.<member>` handler args
-      // (src/value.js EventMemberVal via Stack.lookupEvent). There is no bare
-      // implicit-name vocabulary anymore: every arg carries a sigil.
-      get event() {
-        return this.e;
-      }
     };
     NameArgsTransaction = class extends Transaction {
       constructor(path, transactor, name, args, parentTransaction) {
@@ -13533,6 +13336,17 @@ var init_transactor = __esm({
       get observeName() {
         return this.name;
       }
+      // `forward` in a RECEIVE body starts a walk: the message that arrived becomes an
+      // intent, keeping its name and payload.
+      _forwardName() {
+        return this.name;
+      }
+      _forwardArgs() {
+        return this.args;
+      }
+      _forwardPath() {
+        return this.path;
+      }
       getHandlerForName(comp) {
         const handlers = comp?.[this.handlerProp];
         const exact = handlers?.[this.name];
@@ -13563,19 +13377,6 @@ var init_transactor = __esm({
       get observeKind() {
         return this._isAnswer ? "answer" : "receive";
       }
-      // `forward` in a RECEIVE body starts a walk: the message that arrived becomes an
-      // intent, keeping its name and payload. This is what lets a view's name leave the
-      // component without the view changing.
-      forward(opts) {
-        this._forward = opts ?? {};
-      }
-      afterTransaction() {
-        const f = this._forward;
-        if (f === void 0) return;
-        this._forward = void 0;
-        const { args = this.args, ...rest } = f;
-        this.transactor.pushIntent(this.path, this.name, args, rest, this);
-      }
     };
     IntentEvent = class extends NameArgsTransaction {
       handlerProp = "intent";
@@ -13589,9 +13390,6 @@ var init_transactor = __esm({
       forward(opts) {
         this.walk.amend(opts, this.path);
       }
-      stop() {
-        this.walk.finish(null, null);
-      }
       afterTransaction() {
         this.ensureWalkAdvanced();
       }
@@ -13629,7 +13427,7 @@ var init_transactor = __esm({
         while (this.legIndex < this.route.length) {
           const leg = this.route[this.legIndex];
           if (leg === "dyn") {
-            if (this.dynAt.steps.length === 0) {
+            if (!this.dynAt.canPop()) {
               this.legIndex++;
               continue;
             }
@@ -13641,7 +13439,7 @@ var init_transactor = __esm({
             this.legIndex++;
             return this._tryLex();
           }
-          console.warn("unknown intent route leg", leg, '- expected "dyn" or "lex"');
+          warnUnknownLeg("intent", leg);
           this.legIndex++;
         }
         this.exhaust("noHandler");
@@ -13726,11 +13524,11 @@ var init_transactor = __esm({
         if (this.ended) return;
         this.ended = true;
         if (name === null) return this.release?.();
-        const path = this.answerPath ?? this.origin;
-        const t = new SendEvent(path, this.transactor, name, args, this.parent);
+        const t = new SendEvent(this.origin, this.transactor, name, args, this.parent);
+        t.txnPath = this.answerPath;
         t._isAnswer = true;
         this.transactor.pushTransaction(t);
-        if (this.release) t.completion.whenSubtreeSettled().then(this.release);
+        if (this.release) t.completion.carry(this.release);
       }
     };
     Completion = class {
@@ -13738,12 +13536,12 @@ var init_transactor = __esm({
         this.val = void 0;
         this.selfSettled = false;
         this.subtreeSettled = false;
-        this.pending = 1;
+        this.pending = 0;
         this._selfResolve = null;
         this._selfPromise = null;
         this._subtreeResolve = null;
         this._subtreePromise = null;
-        this._selfReleased = false;
+        this._releaseSelf = this.track();
       }
       whenSettled() {
         if (this.selfSettled) return Promise.resolve(this.val);
@@ -13766,38 +13564,38 @@ var init_transactor = __esm({
         this.val = val;
         this._selfResolve?.(val);
       }
-      // Settle self even when no handler produced a value (undefined-state / throw paths).
-      ensureSelfSettled() {
-        if (!this.selfSettled) this.markSelfSettled(this.val);
+      // The transaction is done processing: self is settled (with the value the handler
+      // produced, or none on the undefined-state / throw paths) and the self-unit goes.
+      finish() {
+        this.markSelfSettled(this.val);
+        this._releaseSelf();
       }
-      // Register an outstanding unit; returns a one-shot release.
+      // Register an outstanding unit; returns its one-shot release. The subtree settles
+      // when the last unit is released.
       track() {
         this.pending++;
         let done = false;
         return () => {
           if (done) return;
           done = true;
-          this._release();
+          if (--this.pending === 0) {
+            this.subtreeSettled = true;
+            this._subtreeResolve?.(this.val);
+          }
         };
       }
-      releaseSelf() {
-        if (this._selfReleased) return;
-        this._selfReleased = true;
-        this._release();
-      }
-      _release() {
-        if (--this.pending === 0) {
-          this.subtreeSettled = true;
-          this._subtreeResolve?.(this.val);
-        }
+      // Hand a unit held elsewhere to this subtree: `release` runs once this transaction
+      // and everything it spawned have settled.
+      carry(release) {
+        this.whenSubtreeSettled().then(release);
       }
     };
     Dispatcher = class {
-      constructor(path, transactor, parentTransaction, root = transactor.state.val) {
+      constructor(path, transactor, parentTransaction) {
         this.path = path;
         this.transactor = transactor;
         this.parent = parentTransaction;
-        this.root = root;
+        this.root = transactor.state.val;
       }
       // Walk the component instances on this ctx's path, leaf→root, calling
       // callback(Component, instance). Return false from the callback to stop early.
@@ -13822,28 +13620,37 @@ var init_transactor = __esm({
       // replayed; provides are pushed on every component frame either way, so a provide
       // that reads a loop binding is the one case this cannot reproduce faithfully.
       _stack() {
-        this._stackMemo ??= this.path.toTransactionPath().buildStack(Stack.root(this.transactor.comps, this.root, this.parent));
+        this._stackMemo ??= this.path.buildStack(
+          Stack.root(this.transactor.comps, this.root, this.parent)
+        );
         return this._stackMemo;
       }
       // Resolve a name the way the renderer would. `opts.route` takes the same legs in
       // the same spelling as `ctx.intent` — `["dyn"]` the render ancestry, `["lex"]` the
       // registration scope, default both.
+      // Legs are tried in route order, like the intent walker's; an unknown leg warns and
+      // is skipped, and an empty route resolves to null.
       lookup(name, opts) {
-        return routeLookup(
-          opts?.route ?? DEFAULT_ROUTE,
-          () => this._lookupLex(name),
-          () => this._stack()?.lookupDynamic(name) ?? null
-        );
+        for (const leg of opts?.route ?? DEFAULT_ROUTE) {
+          const v = leg === "dyn" ? this._stack()?.lookupDynamic(name) ?? null : leg === "lex" ? this._lookupLex(name) : warnUnknownLeg("lookup", leg);
+          if (v != null) return v;
+        }
+        return null;
       }
       // The `lex` leg without a Stack: the scope of the component whose handler is
-      // running, which is the leaf of this ctx's path.
+      // running, which is the leaf of this ctx's path. A type name resolves to the
+      // component registered under it; a value name to a path registered under it
+      // (see ComponentStack.registerPaths), read against the current root.
       _lookupLex(name) {
         let Comp = null;
         this.walkPath((c) => {
           Comp = c;
           return false;
         });
-        return Comp?.scope?.lookupComponent(name) ?? null;
+        const scope = Comp?.scope;
+        if (scope == null) return null;
+        if (isTypeName(name)) return scope.lookupComponent(name) ?? null;
+        return scope.lookupPath(name)?.lookup(this.root) ?? null;
       }
       // A component lookup is a value lookup constrained to a component. The `lex` leg
       // can only ever answer with one; the `dyn` leg reads a binding an ancestor
@@ -13904,11 +13711,19 @@ var init_transactor = __esm({
           this.transactor.refuse("NO_SENDER", { name });
           return null;
         }
-        return this.sendAtPath(origin, name, args);
+        return this.transactor.pushSend(
+          origin,
+          name,
+          args,
+          this.parent,
+          this.path,
+          this.parent.originPinned
+        );
       }
-      // End the walk answering nothing — "served, and no answer".
+      // End the walk answering nothing — "served, and no answer". Like reply/fail,
+      // legal only in an `intent` handler.
       stop() {
-        return this.parent.stop();
+        return this.parent.walk === void 0 ? warnNotIntent("stop") : this.parent.walk.finish(null, null);
       }
       // From an `intent` body: hand the intent to the next hop, optionally amending it.
       // From a `receive` body: turn the message that arrived into an intent. One word from
@@ -13987,7 +13802,6 @@ var init_app = __esm({
         this.transactor = new Transactor(comps, null);
         this.ParseContext = ParseContext2;
         this.renderer = renderer;
-        this.maxEventNodeDepth = Infinity;
         this._transactNextBatchId = this._evictCacheId = null;
         this._eventNames = new Set(_evs);
         this.dragInfo = this.curDragOver = null;
@@ -14014,12 +13828,11 @@ var init_app = __esm({
       _dispatchEvent(e) {
         const { type: type3 } = e;
         const isDrag = type3 === "dragover" || type3 === "dragstart" || type3 === "dragend" || type3 === "drop";
-        const { rootNode: root, maxEventNodeDepth: maxDepth, comps, transactor } = this;
-        const [path, handlers] = Path.fromNodeAndEventName(
+        const { rootNode, comps, transactor } = this;
+        const [path, handlers] = DispatchPath.fromNodeAndEventName(
           e.target,
           type3,
-          root,
-          maxDepth,
+          rootNode,
           comps,
           !isDrag
         );
@@ -14083,7 +13896,7 @@ var init_app = __esm({
           const txnPath = path.compact().toTransactionPath();
           const value = txnPath.lookup(rootValue);
           const dragType = e.target.dataset.dragtype ?? "?";
-          const stack = path.toTransactionPath().buildStack(this.makeStack(rootValue));
+          const stack = path.buildStack(this.makeStack(rootValue));
           this.dragInfo = new DragInfo(stack, value, dragType, e.target);
         } else if (type3 === "drop") {
           e.preventDefault();
@@ -14128,10 +13941,9 @@ var init_app = __esm({
       }
       compile() {
         for (const Comp of this.comps.byId.values()) {
-          const meta = Comp[COMPONENT];
-          meta.compile(this.ParseContext);
-          for (const key in meta.views)
-            for (const name of meta.views[key].ctx.genEventNames()) this._eventNames.add(name);
+          Comp.compile(this.ParseContext);
+          for (const key in Comp.views)
+            for (const name of Comp.views[key].ctx.genEventNames()) this._eventNames.add(name);
         }
         this._compiled = true;
       }
@@ -14154,11 +13966,13 @@ var init_app = __esm({
       }
       stop() {
         this.stopCacheEvictionInterval();
+        clearTimeout(this._transactNextBatchId);
+        this._transactNextBatchId = null;
         for (const name of this._eventNames)
           this.rootNode.removeEventListener(name, this, listenerOpts(name));
       }
       sendAtRoot(name, args) {
-        this.transactor.pushSend(new Path([]), name, args);
+        this.transactor.pushSend(new DispatchPath(), name, args);
       }
       registerComponents(comps, opts) {
         const scope = this.compStack.enter();
@@ -14242,28 +14056,21 @@ var init_cache = __esm({
       set(_keys, _cacheKey, _v) {
       }
       evict() {
-        return { hit: 0, miss: 0, badKey: 0 };
       }
     };
     WeakMapDomCache = class {
       constructor() {
-        this.hit = this.miss = this.badKey = 0;
         this.keysByLen = /* @__PURE__ */ new Map();
       }
-      _returnValue(r) {
-        if (r === void 0) this.miss += 1;
-        else this.hit += 1;
-        return r;
-      }
       get(keys, cacheKey) {
         const len = keys.length;
         let cur = this.keysByLen.get(len);
-        if (!cur) return this._returnValue(void 0);
+        if (!cur) return void 0;
         for (let i = 0; i < len - 1; i++) {
           cur = cur.get(keys[i]);
-          if (!cur) return this._returnValue(void 0);
+          if (!cur) return void 0;
         }
-        return this._returnValue(cur.get(keys[len - 1])?.[cacheKey]);
+        return cur.get(keys[len - 1])?.[cacheKey];
       }
       set(keys, cacheKey, v) {
         const len = keys.length;
@@ -14276,10 +14083,7 @@ var init_cache = __esm({
           const key = keys[i];
           let next = cur.get(key);
           if (!next) {
-            if (!isWeakKey(key)) {
-              this.badKey += 1;
-              return;
-            }
+            if (!isWeakKey(key)) return;
             next = /* @__PURE__ */ new WeakMap();
             cur.set(key, next);
           }
@@ -14289,31 +14093,48 @@ var init_cache = __esm({
         const leaf = cur.get(lastKey);
         if (leaf) leaf[cacheKey] = v;
         else if (isWeakKey(lastKey)) cur.set(lastKey, { [cacheKey]: v });
-        else this.badKey += 1;
       }
       evict() {
-        const { hit, miss, badKey } = this;
-        this.hit = this.miss = this.badKey = 0;
         this.keysByLen = /* @__PURE__ */ new Map();
-        return { hit, miss, badKey };
       }
     };
   }
 });
 
 // src/renderer.js
-var DATASET_ATTRS, Renderer;
+function stampRenderBase(vdom, text) {
+  if (vdom instanceof VNode)
+    return new VNode(
+      vdom.tag,
+      { ...vdom.attrs, "data-rp": text },
+      vdom.childs,
+      vdom.key,
+      vdom.namespace
+    );
+  if (vdom instanceof VFragment)
+    return new VFragment(vdom.childs.map((c) => stampRenderBase(c, text)));
+  return vdom;
+}
+var Renderer;
 var init_renderer = __esm({
   "src/renderer.js"() {
     init_cache();
     init_iteration();
+    init_path();
+    init_value();
     init_vdom();
-    DATASET_ATTRS = ["nid", "cid", "eid", "vid", "si", "sk"];
     Renderer = class {
       constructor(comps) {
         this.comps = comps;
         this.cache = new WeakMapDomCache();
-        this.renderTag = h;
+      }
+      // Parse nodes build their VDOM through the renderer, never by importing vdom.js
+      // themselves: a component may have been compiled by ANOTHER copy of the library
+      // (a docs example imports the dist bundle while the host app runs from src), and
+      // `render()` recognizes VNodes by `instanceof` against ITS copy's classes. Going
+      // through `rx` guarantees the rendering copy makes them.
+      renderTag(tag, attrs, childs, namespace) {
+        return h(tag, attrs, childs, namespace);
       }
       renderFragment(childs) {
         return new VFragment(childs);
@@ -14324,38 +14145,24 @@ var init_renderer = __esm({
       setNullCache() {
         this.cache = new NullDomCache();
       }
-      // Library utilities for consumers embedding tutuca: render a value to a detached
-      // DOM node / an HTML string. Not called by the framework itself.
-      renderToDOM(stack, val) {
-        const rootNode = document.createElement("div");
-        const rOpts = { document };
-        render(h("DIV", null, [this.renderRoot(stack, val)]), rootNode, rOpts);
-        return rootNode.childNodes[0];
-      }
-      renderToString(stack, val, cleanAttrs = true) {
-        const dom = this.renderToDOM(stack, val);
-        if (cleanAttrs) {
-          const nodes = dom.querySelectorAll("[data-nid],[data-cid],[data-eid]");
-          for (const { dataset } of nodes) for (const name of DATASET_ATTRS) delete dataset[name];
-        }
-        return dom.innerHTML;
-      }
       renderRoot(stack, val, viewName = null) {
         const comp = this.comps.getCompFor(val);
         if (comp === null) return null;
         return this._rValComp(stack, val, comp, comp.getView(viewName).anode, "ROOT", viewName);
       }
-      renderIt(stack, node, key, viewName) {
+      // Render `stack.it` at a `<x render*>` site (`node`). `base` is the absolute
+      // path the site resumed at, when it rendered a `*name` (see _rValComp).
+      renderIt(stack, node, viewName, base = null) {
         const comp = this.comps.getCompFor(stack.it);
-        return comp ? this._rValComp(stack, stack.it, comp, node, key, viewName) : null;
+        return comp ? this._rValComp(stack, stack.it, comp, node, "", viewName, base) : null;
       }
       // `node` is the parse node of the render site (`<x render>` / `render-it` /
       // `render-each`, or the view's root anode for the app root). It keys the
       // cache as a globally-unique object: node ids alone are unique only within a
       // single view, so the same value rendered by two components (e.g. through a
       // shared dynamic-var sequence) would otherwise collide in the cache.
-      _rValComp(stack, val, comp, node, key, viewName) {
-        const cacheKey = `${viewName ?? ""}${stack.viewsId ?? ""}${key}`;
+      _rValComp(stack, val, comp, node, key, viewName, base = null) {
+        const cacheKey = `${viewName ?? ""}${stack.viewsId ?? ""}${key}${stack.renderPath.addressKey}`;
         const cachePath = [node, val];
         stack._pushDynBindValuesToArray(cachePath, comp);
         const cachedNode = this.cache.get(cachePath, cacheKey);
@@ -14363,30 +14170,43 @@ var init_renderer = __esm({
         const view = viewName ? comp.getView(viewName) : stack.lookupBestView(comp.views, "main");
         const body = this.renderView(view, stack);
         if (body == null) return null;
+        const baseJson = base === null ? null : pathToJson(base);
         const meta = this._renderMetadata({
           $: "Comp",
           nid: node?.nodeId ?? null,
           cid: comp.id,
-          vid: view.name
+          vid: view.name,
+          ...baseJson === null ? null : { base: baseJson }
         });
-        const dom = new VFragment([meta, body]);
+        const dom = new VFragment([
+          meta,
+          baseJson === null ? body : stampRenderBase(body, JSON.stringify(baseJson))
+        ]);
         this.cache.set(cachePath, cacheKey, dom);
         return dom;
       }
       pushEachEntry(r, nid, attrName, key, dom) {
         r.push(this._renderMetadata({ $: "Each", nid, [attrName]: key }), dom);
       }
-      renderEachWhen(stack, iterInfo, view, nid) {
-        const { seq, filter, loopWith, enricher } = iterInfo.eval(stack);
+      renderEachWhen(stack, each2) {
+        const { val: seqVal, node: view, nodeId: nid } = each2;
+        const { seq, filter, loopWith, enricher } = each2.evalIter(stack);
+        const seqPath = seqVal instanceof DynVal ? stack.lookupDynamicLocated(seqVal.name)?.path ?? null : null;
         const r = [];
         const it = stack.it;
         const renderOne = (key, value, attrName, binds) => {
+          const itemBase = seqPath === null ? null : keyedPath(seqPath, key);
+          const itemStep = itemBase === null ? each2.itemStep(key) : null;
+          const itemPath = itemBase !== null ? stack.renderPath.pushFrame(itemBase) : itemStep !== null ? stack.renderPath.pushItem(itemStep) : stack.renderPath;
           const cachePath = enricher ? [view, it, value] : [view, value];
-          const cacheKey = `${stack.viewsId ?? ""}${nid}${key}`;
+          const cacheKey = `${stack.viewsId ?? ""}${nid}${key}${itemPath.addressKey}`;
           const cachedNode = this.cache.get(cachePath, cacheKey);
           if (cachedNode) this.pushEachEntry(r, nid, attrName, key, cachedNode);
           else {
-            const dom = this.renderView(view, stack.enter(value, binds, false));
+            const dom = this.renderView(
+              view,
+              stack.enter(value, binds, false, itemPath, itemBase !== null)
+            );
             if (dom != null) this.pushEachEntry(r, nid, attrName, key, dom);
             this.cache.set(cachePath, cacheKey, dom);
           }
@@ -14424,9 +14244,7 @@ var init_renderer = __esm({
 
 // src/util/render.js
 function reindexComponents(comps) {
-  for (let i = 0; i < comps.length; i++) {
-    comps[i][COMPONENT].id = i;
-  }
+  for (let i = 0; i < comps.length; i++) comps[i].id = i;
 }
 function serializeContainer(container) {
   for (const input of container.querySelectorAll("input")) {
@@ -14435,19 +14253,19 @@ function serializeContainer(container) {
   }
   return container.innerHTML;
 }
-function renderToHTMLNode(document2, components, macros, rootState, ParseContext2, opts = { noCache: true }) {
+function renderToHTMLNode(document2, components, macros, rootState, ParseContext2, { noCache = true, paths = null, intentHandlers = null, view = null } = {}) {
   const container = document2.createElement("div");
   document2.body.appendChild(container);
   reindexComponents(components);
   const comps = new Components();
   const renderer = new Renderer(comps);
   const app = new App(container, comps, renderer, ParseContext2);
-  const scope = app.registerComponents(components);
+  const scope = app.registerComponents(components, { paths });
   if (macros) scope.registerMacros(macros);
-  if (opts.intentHandlers) scope.registerIntentHandlers(opts.intentHandlers);
-  app.rootViewName = opts.view ?? null;
+  if (intentHandlers) scope.registerIntentHandlers(intentHandlers);
+  app.rootViewName = view;
   app.transactor.state.set(rootState);
-  app.start(opts);
+  app.start({ noCache });
   return {
     container,
     app,
@@ -14457,18 +14275,18 @@ function renderToHTMLNode(document2, components, macros, rootState, ParseContext
     }
   };
 }
-async function renderToHTMLDriven(document2, components, macros, rootState, ParseContext2, { phase = null, intentHandlers = null, view = null } = {}) {
+async function renderToHTMLDriven(document2, components, macros, rootState, ParseContext2, { phase = null, ...opts } = {}) {
   const { container, app, cleanup } = renderToHTMLNode(
     document2,
     components,
     macros,
     rootState,
     ParseContext2,
-    { noCache: true, intentHandlers, view }
+    opts
   );
   try {
     if (phase) {
-      dispatchPhase(rootDispatcher(app.transactor), new Path([]), phase, app.state.val);
+      dispatchPhase(rootDispatcher(app.transactor), new DispatchPath(), phase, app.state.val);
       await app.transactor.settle();
     }
     return serializeContainer(container);
@@ -14706,7 +14524,7 @@ async function driveStack(stack, value, phase, opts = {}) {
         val
       );
     });
-  dispatchPhase(rootDispatcher(transactor), new Path([]), phase, value);
+  dispatchPhase(rootDispatcher(transactor), new DispatchPath(), phase, value);
   await transactor.settle();
   return transactor.state.val;
 }
@@ -15406,23 +15224,30 @@ function installSkill(skill, root, scope, force, dotAgents, dryRun, opts) {
     });
   }
   const target = targetDir(scope, skill.name, dotAgents);
-  if (targetHasSkillFiles(target) && !force) {
-    emitError(opts, {
-      code: CODES.SKILL_TARGET_EXISTS,
-      message: `${target} already contains skill files`,
-      hint: "Re-run with --force to overwrite, or --dry-run to see what would change."
-    });
-  }
   const baseDir = dotAgents ? ".agents/skills" : ".claude/skills";
   const rel = scope === "project" ? `${baseDir}/${skill.name}` : target;
+  const exists = targetHasSkillFiles(target);
   if (dryRun) {
     const files = walkFiles(src, { match: () => true }).map((f) => relative(src, f));
     process.stdout.write(`would install ${skill.name} skill → ${rel}
 `);
     for (const f of files) process.stdout.write(`  + ${f}
 `);
+    if (exists) {
+      process.stdout.write(
+        `  note: ${rel} already contains skill files; re-run with --force to overwrite them
+`
+      );
+    }
     return;
   }
+  if (exists && !force) {
+    emitError(opts, {
+      code: CODES.SKILL_TARGET_EXISTS,
+      message: `${target} already contains skill files`,
+      hint: "Re-run with --force to overwrite, or --dry-run to see what would change."
+    });
+  }
   mkdirSync2(target, { recursive: true });
   cpSync(src, target, { recursive: true });
   process.stdout.write(`installed ${skill.name} skill → ${rel}
@@ -15520,16 +15345,16 @@ async function createNodeEnv() {
   const dom = new JSDOM("<!DOCTYPE html><html><head></head><body></body></html>", {
     virtualConsole
   });
-  const { document: document2, Text, Comment } = dom.window;
+  const { document: document2 } = dom.window;
   globalThis.document = document2;
   class HeadlessParseContext extends ParseContext {
     constructor() {
-      super(document2, Text, Comment);
+      super(document2);
     }
   }
   class HeadlessLintParseContext extends LintParseContext {
     constructor() {
-      super(document2, Text, Comment);
+      super(document2);
     }
   }
   return {
@@ -15538,7 +15363,7 @@ async function createNodeEnv() {
     LintParseContext: HeadlessLintParseContext
   };
 }
-var init_env2 = __esm({
+var init_env = __esm({
   "tools/cli/env.js"() {
     init_anode();
     init_lint_check();
@@ -16039,7 +15864,7 @@ var init_storybook = __esm({
     init_chai2();
     init_module();
     init_test();
-    init_env2();
+    init_env();
     init_errors();
     init_pkg();
     init_walk();
@@ -16224,7 +16049,7 @@ export async function resolve(specifier, context, nextResolve) {
 init_errors();
 
 // tools/cli/with-module.js
-init_env2();
+init_env();
 init_errors();
 import { statSync as statSync2 } from "node:fs";
 import { parseArgs as parseArgs4 } from "node:util";