@barefootjs/client 0.34.0 → 0.35.1

package/dist/csr-adapter.js

@@ -168757,7 +168757,7 @@ Additional information: BADCLIENT: Bad error code, ${badCode} not found in range
 var import_typescript25 = __toESM(require_typescript(), 1);
 
 // ../jsx/src/analyzer.ts
-var import_typescript10 = __toESM(require_typescript(), 1);
+var import_typescript11 = __toESM(require_typescript(), 1);
 
 // ../jsx/src/expression-parser.ts
 var import_typescript = __toESM(require_typescript(), 1);
@@ -169095,6 +169095,12 @@ class BindingScope {
   }
 }
 
+// ../jsx/src/ir-to-client-js/safe-html.ts
+function safeHtml(expr) {
+  return expr;
+}
+var EMPTY_MARKUP = safeHtml("''");
+
 // ../jsx/src/ir-to-client-js/html-template.ts
 var VOID_ELEMENTS = new Set([
   "area",
@@ -169152,14 +169158,17 @@ function freshCounters() {
 }
 
 // ../jsx/src/analyzer-context.ts
-var import_typescript9 = __toESM(require_typescript(), 1);
+var import_typescript10 = __toESM(require_typescript(), 1);
 
 // ../jsx/src/strip-types.ts
 var import_typescript8 = __toESM(require_typescript(), 1);
 
+// ../jsx/src/reactivity-checker.ts
+var import_typescript9 = __toESM(require_typescript(), 1);
+
 // ../jsx/src/analyzer-context.ts
-var _typePrinter = import_typescript9.default.createPrinter({ removeComments: true, omitTrailingSemicolon: true });
-var _blankTypeSourceFile = import_typescript9.default.createSourceFile("__bf_types__.ts", "", import_typescript9.default.ScriptTarget.Latest);
+var _typePrinter = import_typescript10.default.createPrinter({ removeComments: true, omitTrailingSemicolon: true });
+var _blankTypeSourceFile = import_typescript10.default.createSourceFile("__bf_types__.ts", "", import_typescript10.default.ScriptTarget.Latest);
 
 // ../jsx/src/errors.ts
 var ErrorCodes = {
@@ -169381,6 +169390,7 @@ var CLIENT_EXPORTS = new Set([
   "isSSRPortal",
   "findSiblingSlot",
   "cleanupPortalPlaceholder",
+  "trackPosition",
   "createSearchParams",
   "queryHref",
   "formatDate",
@@ -169391,46 +169401,46 @@ function extractFreeIdentifiersFromNode(node) {
   const ids = new Set;
   const boundNames = new Set;
   function addBindingNames(name, out) {
-    if (import_typescript10.default.isIdentifier(name))
+    if (import_typescript11.default.isIdentifier(name))
       out.push(name.text);
-    else if (import_typescript10.default.isObjectBindingPattern(name))
+    else if (import_typescript11.default.isObjectBindingPattern(name))
       name.elements.forEach((e) => addBindingNames(e.name, out));
-    else if (import_typescript10.default.isArrayBindingPattern(name))
+    else if (import_typescript11.default.isArrayBindingPattern(name))
       name.elements.forEach((e) => {
-        if (!import_typescript10.default.isOmittedExpression(e))
+        if (!import_typescript11.default.isOmittedExpression(e))
           addBindingNames(e.name, out);
       });
   }
   function visit(n) {
-    if (import_typescript10.default.isTypeNode(n))
+    if (import_typescript11.default.isTypeNode(n))
       return;
-    if (import_typescript10.default.isIdentifier(n)) {
+    if (import_typescript11.default.isIdentifier(n)) {
       const parent = n.parent;
-      if (parent && import_typescript10.default.isPropertyAccessExpression(parent) && parent.name === n)
+      if (parent && import_typescript11.default.isPropertyAccessExpression(parent) && parent.name === n)
         return;
-      if (parent && import_typescript10.default.isPropertyAssignment(parent) && parent.name === n)
+      if (parent && import_typescript11.default.isPropertyAssignment(parent) && parent.name === n)
         return;
-      if (parent && import_typescript10.default.isParameter(parent) && parent.name === n)
+      if (parent && import_typescript11.default.isParameter(parent) && parent.name === n)
         return;
-      if (parent && import_typescript10.default.isVariableDeclaration(parent) && parent.name === n)
+      if (parent && import_typescript11.default.isVariableDeclaration(parent) && parent.name === n)
         return;
       if (boundNames.has(n.text))
         return;
       ids.add(n.text);
       return;
     }
-    if (import_typescript10.default.isArrowFunction(n)) {
+    if (import_typescript11.default.isArrowFunction(n)) {
       const params = [];
       for (const p of n.parameters)
         addBindingNames(p.name, params);
       for (const name of params)
         boundNames.add(name);
-      import_typescript10.default.forEachChild(n, visit);
+      import_typescript11.default.forEachChild(n, visit);
       for (const name of params)
         boundNames.delete(name);
       return;
     }
-    import_typescript10.default.forEachChild(n, visit);
+    import_typescript11.default.forEachChild(n, visit);
   }
   visit(node);
   return ids;
@@ -169441,7 +169451,8 @@ var BROWSER_ONLY_CLIENT_APIS = new Set([
   "createPortal",
   "isSSRPortal",
   "findSiblingSlot",
-  "cleanupPortalPlaceholder"
+  "cleanupPortalPlaceholder",
+  "trackPosition"
 ]);
 var REACTIVE_PRIMITIVES = new Set([
   "createSignal",
@@ -169489,7 +169500,7 @@ var REACTIVE_BINDING_KINDS = new Set([
 ]);
 
 // ../jsx/src/module-exports.ts
-var import_typescript11 = __toESM(require_typescript(), 1);
+var import_typescript12 = __toESM(require_typescript(), 1);
 function formatParamWithType(p) {
   const rest = p.isRest ? "..." : "";
   const optional = p.optional ? "?" : "";
@@ -169524,21 +169535,21 @@ function findAssignedNames(bodyText, candidates) {
   const assigned = new Set;
   if (candidates.size === 0)
     return assigned;
-  const sf = import_typescript11.default.createSourceFile("bf-assignment-scan.tsx", bodyText, import_typescript11.default.ScriptTarget.Latest, false, import_typescript11.default.ScriptKind.TSX);
+  const sf = import_typescript12.default.createSourceFile("bf-assignment-scan.tsx", bodyText, import_typescript12.default.ScriptTarget.Latest, false, import_typescript12.default.ScriptKind.TSX);
   const record = (target) => {
-    if (import_typescript11.default.isIdentifier(target) && candidates.has(target.text)) {
+    if (import_typescript12.default.isIdentifier(target) && candidates.has(target.text)) {
       assigned.add(target.text);
     }
   };
   const visit = (node) => {
-    if (import_typescript11.default.isBinaryExpression(node) && isAssignmentOperator(node.operatorToken.kind)) {
+    if (import_typescript12.default.isBinaryExpression(node) && isAssignmentOperator(node.operatorToken.kind)) {
       record(node.left);
-    } else if ((import_typescript11.default.isPrefixUnaryExpression(node) || import_typescript11.default.isPostfixUnaryExpression(node)) && (node.operator === import_typescript11.default.SyntaxKind.PlusPlusToken || node.operator === import_typescript11.default.SyntaxKind.MinusMinusToken)) {
+    } else if ((import_typescript12.default.isPrefixUnaryExpression(node) || import_typescript12.default.isPostfixUnaryExpression(node)) && (node.operator === import_typescript12.default.SyntaxKind.PlusPlusToken || node.operator === import_typescript12.default.SyntaxKind.MinusMinusToken)) {
       record(node.operand);
     }
-    import_typescript11.default.forEachChild(node, visit);
+    import_typescript12.default.forEachChild(node, visit);
   };
-  import_typescript11.default.forEachChild(sf, visit);
+  import_typescript12.default.forEachChild(sf, visit);
   return assigned;
 }
 function closeOverWritersOfMutableBindings(primaryRefs, declarations, mutableNames) {
@@ -169561,12 +169572,9 @@ function closeOverWritersOfMutableBindings(primaryRefs, declarations, mutableNam
   return reachable;
 }
 function isAssignmentOperator(kind) {
-  return kind >= import_typescript11.default.SyntaxKind.FirstAssignment && kind <= import_typescript11.default.SyntaxKind.LastAssignment;
+  return kind >= import_typescript12.default.SyntaxKind.FirstAssignment && kind <= import_typescript12.default.SyntaxKind.LastAssignment;
 }
 
-// ../jsx/src/reactivity-checker.ts
-var import_typescript12 = __toESM(require_typescript(), 1);
-
 // ../jsx/src/free-refs.ts
 var import_typescript13 = __toESM(require_typescript(), 1);
 var _bindingMapCache = new WeakMap;

package/dist/index.d.ts

@@ -7,6 +7,6 @@ export { unwrap } from './unwrap.ts';
 export { queryHref, type QueryParams, type QueryParamValue } from './query-href.ts';
 export { formatDate } from './format-date.ts';
 export { createContext, type Context } from './context.ts';
-export { useContext, provideContext, createPortal, isSSRPortal, findSiblingSlot, cleanupPortalPlaceholder, type Portal, type PortalChildren, type PortalOptions, type Renderable, } from './shims.ts';
+export { useContext, provideContext, createPortal, isSSRPortal, findSiblingSlot, cleanupPortalPlaceholder, trackPosition, type Portal, type PortalChildren, type PortalOptions, type Renderable, } from './shims.ts';
 export { Async, Region, type AsyncProps, type RegionProps, } from './builtins.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,sBAAsB,EACtB,UAAU,EACV,cAAc,EACd,UAAU,EACV,SAAS,EACT,OAAO,EACP,OAAO,EACP,KAAK,EACL,eAAe,EACf,SAAS,EACT,OAAO,EACP,gBAAgB,EAMhB,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,sBAAsB,EACtB,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,IAAI,EACT,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,6BAA6B,CAAA;AAEpC,OAAO,EACL,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,aAAa,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAA;AAE1D,OAAO,EACL,UAAU,EACV,cAAc,EACd,YAAY,EACZ,WAAW,EACX,eAAe,EACf,wBAAwB,EACxB,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,YAAY,CAAA;AAKnB,OAAO,EACL,KAAK,EACL,MAAM,EACN,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,sBAAsB,EACtB,UAAU,EACV,cAAc,EACd,UAAU,EACV,SAAS,EACT,OAAO,EACP,OAAO,EACP,KAAK,EACL,eAAe,EACf,SAAS,EACT,OAAO,EACP,gBAAgB,EAMhB,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,sBAAsB,EACtB,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,IAAI,EACT,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,6BAA6B,CAAA;AAEpC,OAAO,EACL,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,aAAa,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAA;AAE1D,OAAO,EACL,UAAU,EACV,cAAc,EACd,YAAY,EACZ,WAAW,EACX,eAAe,EACf,wBAAwB,EACxB,aAAa,EACb,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,YAAY,CAAA;AAKnB,OAAO,EACL,KAAK,EACL,MAAM,EACN,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,eAAe,CAAA"}

package/dist/index.js

@@ -285,6 +285,9 @@ function findSiblingSlot(_el, _slotSelector) {
 function cleanupPortalPlaceholder(_portalId) {
   return browserOnly("cleanupPortalPlaceholder");
 }
+function trackPosition(_update) {
+  return browserOnly("trackPosition");
+}
 // src/builtins.ts
 function compiledAway(name) {
   throw new Error(`[barefootjs] <${name}> is a compiler built-in and is compiled away. ` + `If you are seeing this at runtime, the JSX was rendered without going ` + `through the BarefootJS compiler — please report a bug.`);
@@ -299,6 +302,7 @@ export {
   useContext,
   unwrap,
   untrack,
+  trackPosition,
   splitProps,
   setProfilerSink,
   queryHref,

package/dist/runtime/component.d.ts

@@ -189,6 +189,29 @@ export declare function escapeAttr(value: unknown): string;
  * the reactive path.
  */
 export declare function escapeText(value: unknown): string;
+/**
+ * Neutralize a value for splicing into an HTML COMMENT (`<!--...-->`), the
+ * whole-item loop conditional's `bf-loop-i:<key>` anchor (#1665,
+ * `itemAnchorTemplate` in `ir-to-client-js/html-template.ts`) being the one
+ * caller today. Standard HTML escaping (`escapeAttr`/`escapeText`) does
+ * NOT help here: `-`, `<`, `>` are not special in comment content the way
+ * `& < > " '` are in text/attributes — the only thing that terminates a
+ * comment early is the literal three-character sequence `-->`, which
+ * `escapeAttr` never touches.
+ *
+ * The key's exact text does not need to round-trip: nothing reads it back
+ * out of the DOM (`mapArrayAnchored` matches items positionally on first
+ * hydration and by its own JS-computed key afterward, never by re-parsing
+ * `Comment.nodeValue`, `map-array.ts`'s `isItemAnchor`/`findItemAnchors`).
+ * So replacing every ASCII hyphen with the visually-similar U+2010 HYPHEN
+ * is sufficient and simpler than a reversible escape: it makes `-->`
+ * unconstructible from the result (a hyphen adjacent to the template's own
+ * literal `-->` can no longer complete the sequence), and — because it is
+ * a different Unicode character rather than an HTML entity — needs no
+ * decoding: HTML comments do not interpret character references at all,
+ * so `&#45;` would appear as literal text `&#45;`, not `-`.
+ */
+export declare function escapeCommentText(value: unknown): string;
 /**
  * Brand carried by `bfMarkup()` — see that function's docstring. A string
  * key (not a `Symbol`) because the brand must survive `structuredClone`
@@ -213,7 +236,7 @@ export interface BfMarkup {
  * itself assembled from a JSX element passed at a non-`children` component
  * prop position (`header={<strong>Title</strong>}`) — every text segment
  * inside that assembly was already escaped node-by-node during the
- * assembly (the same `escapeHtml` / `escapeTextSlotExpr` calls
+ * assembly (the same `escapeHtml` calls / `spliceChildValue` door
  * `html-template.ts` uses for ordinary element children), so the
  * concatenated result is exactly as safe as any other compiler-emitted
  * template fragment.
@@ -231,8 +254,8 @@ export declare function isBfMarkup(value: unknown): value is BfMarkup;
 /**
  * `escapeText`'s counterpart for a claim-plan slot the compiler has
  * classified `kind: 'markup'` at STATIC/initial-render time
- * (`html-template.ts`'s `escapeTextSlotExpr`, gated on the same
- * `ctx.dynamicElements` membership `emit-reactive.ts` reads to pick the
+ * (`html-template.ts`'s `spliceChildValue` door, `safe-html.ts`, gated on
+ * the same `ctx.dynamicElements` membership `emit-reactive.ts` reads to pick the
  * writer kind for the REACTIVE side, below) — #2651. A `bfMarkup()`-branded
  * value is compiler-built HTML the compiler already escaped piecewise
  * while assembling it, and must reach the template raw, unescaped a second
@@ -245,9 +268,8 @@ export declare function isBfMarkup(value: unknown): value is BfMarkup;
 export declare function escapeTextOrMarkup(value: unknown): string;
 /**
  * Nullish guard for a bare `${children}` passthrough splice
- * (`ir-to-client-js/html-template.ts`'s no-`slotId` `'expression'` branches
- * — the "bare `${...}` interpolations" the docstring above `escapeTextSlotExpr`
- * describes) — #2775. The value here is ALREADY-STRINGIFIED MARKUP, not an
+ * (`ir-to-client-js/safe-html.ts`'s `spliceChildValue` door, no-`slotId`
+ * `'expression'` branches) — #2775. The value here is ALREADY-STRINGIFIED MARKUP, not an
  * arbitrary prop: `materializeComponent` (this file, "Template functions
  * expect children as an HTML string, not an array") joins a component's
  * `children` into an HTML string before the template lambda ever runs, so by
@@ -278,7 +300,7 @@ export declare function markupOrEmpty(value: unknown): string;
  * interpret HTML, so a raw un-escaped string is an injection/corruption
  * risk exactly where the initial SSR/CSR TEMPLATE already calls
  * `escapeText` on the same expression (`html-template.ts`'s
- * `escapeTextSlotExpr`). A live `Node`, by contrast, must pass through
+ * `spliceChildValue` door, `safe-html.ts`). A live `Node`, by contrast, must pass through
  * untouched — `escapeText(node)` would stringify it to garbage, and
  * `writeMarkup`'s own `instanceof Node` check needs the real object to
  * splice in by identity. This is the single call every "dynamic JSX/text

package/dist/runtime/component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../src/runtime/component.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../src/runtime/component.ts"],"names":[],"mappings":"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"}

package/dist/runtime/index.d.ts

@@ -8,6 +8,7 @@ export { queryHref, type QueryParams, type QueryParamValue } from '../query-href
 export { formatDate } from '../format-date.ts';
 export { createContext, useContext, provideContext, setCurrentScope, type Context, } from './context.ts';
 export { createPortal, isSSRPortal, findSiblingSlot, cleanupPortalPlaceholder, type Portal, type PortalOptions, type Renderable, type PortalChildren, } from './portal.ts';
+export { trackPosition } from './track-position.ts';
 export { getLoopChildren, getLoopNodes } from './loop-markers.ts';
 export { qsaItem, upsertChildItem } from './qsa-item.ts';
 export { mapArray, mapArrayAnchored } from './map-array.ts';
@@ -15,7 +16,7 @@ export { mapArrayLazy, type LazyRowEntry, type LazyRowPlan } from './map-array-l
 export { patchLeaf } from './patch-leaf.ts';
 export { claimSlots, lazySlots, lazyClaimSlots, textOrNode, type SlotSpec, type ClaimPlan, type ClaimedSlots, type ClaimedSlotsRW, type SlotWriter } from './claim-slots.ts';
 export { registerTemplate, getTemplate, hasTemplate, type TemplateFn } from './template.ts';
-export { createComponent, mountRowRoot, renderChild, withParentScope, parseHTML, escapeAttr, escapeText, escapeTextOrNode, bfMarkup, isBfMarkup, escapeTextOrMarkup, markupOrEmpty, type BfMarkup, } from './component.ts';
+export { createComponent, mountRowRoot, renderChild, withParentScope, parseHTML, escapeAttr, escapeText, escapeCommentText, escapeTextOrNode, bfMarkup, isBfMarkup, escapeTextOrMarkup, markupOrEmpty, type BfMarkup, } from './component.ts';
 export { applyRestAttrs } from './apply-rest-attrs.ts';
 export { spreadAttrs } from './spread-attrs.ts';
 export { styleToCss } from './style.ts';

package/dist/runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"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"}

package/dist/runtime/index.js

@@ -9,7 +9,7 @@ import {
   onCleanup,
   onMount,
   untrack as untrack4,
-  batch,
+  batch as batch2,
   setProfilerSink,
   beginTurn,
   endTurn,
@@ -1614,6 +1614,11 @@ function escapeText(value) {
     return "";
   return escapeAttr(value);
 }
+function escapeCommentText(value) {
+  if (value == null)
+    return "";
+  return String(value).replace(/-/g, "‐");
+}
 var BF_MARKUP_BRAND = "__bfMarkup";
 function bfMarkup(html) {
   return { [BF_MARKUP_BRAND]: html };
@@ -1747,6 +1752,46 @@ function cleanupPortalPlaceholder(portalId) {
   const placeholder = document.querySelector(`template[${BF_PORTAL_PLACEHOLDER}="${portalId}"]`);
   placeholder?.remove();
 }
+var pendingPortals = [];
+var pendingObserver = null;
+function moveToContainerEnd(container, element) {
+  const moveBefore = container.moveBefore;
+  if (typeof moveBefore === "function") {
+    moveBefore.call(container, element, null);
+  } else {
+    container.appendChild(element);
+  }
+}
+function flushPendingPortals() {
+  for (const pending of pendingPortals.slice()) {
+    if (!pending.subject.isConnected)
+      continue;
+    pendingPortals.splice(pendingPortals.indexOf(pending), 1);
+    if (pending.element.parentNode === pending.container) {
+      moveToContainerEnd(pending.container, pending.element);
+    }
+  }
+  if (pendingPortals.length === 0 && pendingObserver) {
+    pendingObserver.disconnect();
+    pendingObserver = null;
+  }
+}
+function enqueuePendingPortal(pending) {
+  pendingPortals.push(pending);
+  if (!pendingObserver) {
+    pendingObserver = new MutationObserver(flushPendingPortals);
+    pendingObserver.observe(document, { childList: true, subtree: true });
+  }
+}
+function cancelPendingPortal(element) {
+  const idx = pendingPortals.findIndex((p) => p.element === element);
+  if (idx >= 0)
+    pendingPortals.splice(idx, 1);
+  if (pendingPortals.length === 0 && pendingObserver) {
+    pendingObserver.disconnect();
+    pendingObserver = null;
+  }
+}
 function createPortal(children, container = document.body, options) {
   let element;
   if (children instanceof HTMLElement) {
@@ -1768,16 +1813,35 @@ function createPortal(children, container = document.body, options) {
       element.setAttribute(BF_PORTAL_OWNER, scopeId);
     }
   }
+  const owner = options?.ownerScope;
+  const formerParent = children instanceof HTMLElement ? children.parentNode : null;
+  const subject = owner && !element.contains(owner) ? owner : formerParent instanceof Element ? formerParent : null;
   container.appendChild(element);
+  if (subject && !subject.isConnected && typeof MutationObserver !== "undefined") {
+    enqueuePendingPortal({ element, container, subject });
+  }
   return {
     element,
     unmount() {
+      cancelPendingPortal(element);
       if (element.parentNode) {
         element.parentNode.removeChild(element);
       }
     }
   };
 }
+// src/runtime/track-position.ts
+function trackPosition(update) {
+  update();
+  const onChange = () => update();
+  window.addEventListener("scroll", onChange, true);
+  window.addEventListener("resize", onChange);
+  return () => {
+    window.removeEventListener("scroll", onChange, true);
+    window.removeEventListener("resize", onChange);
+    update();
+  };
+}
 // src/runtime/loop-markers.ts
 function findLoopMarkers(container, markerId) {
   let startMarker = null;
@@ -1904,7 +1968,7 @@ function upsertChildItem(primaryEl, name, slotId, props, key, anchorScope) {
   return null;
 }
 // src/runtime/map-array.ts
-import { createSignal, createEffect, createRoot as createRoot2 } from "@barefootjs/client/reactive";
+import { createSignal, createEffect, createRoot as createRoot2, batch } from "@barefootjs/client/reactive";
 function scopeIdOf(start) {
   const rest = (start.nodeValue ?? "").slice(BF_SCOPE_COMMENT_PREFIX.length);
   const pipe = rest.indexOf("|");
@@ -2049,17 +2113,20 @@ function createItemScope(item, index, renderItem, existingPrimary, existingExtra
   let primaryEl;
   let dispose;
   let setItem;
+  let setIndex;
   let extras = [];
   let startMarker = null;
   let scopeComments = null;
   createRoot2((d) => {
     dispose = d;
     const [itemAccessor, itemSetter] = createSignal(item);
+    const [indexAccessor, indexSetter] = createSignal(index);
     setItem = itemSetter;
+    setIndex = indexSetter;
     const ownsRowMount = !existingPrimary && !!rowMount;
     const prevRowMount = ownsRowMount ? setRowMountPoint(rowMount) : null;
     try {
-      primaryEl = renderItem(itemAccessor, index, existingPrimary);
+      primaryEl = renderItem(itemAccessor, indexAccessor, existingPrimary);
     } catch (err) {
       const parked = rowMount?.mounted;
       if (parked?.parentNode)
@@ -2092,7 +2159,7 @@ function createItemScope(item, index, renderItem, existingPrimary, existingExtra
   if (rowMount && !existingPrimary && extras.length > 0 && primaryEl.parentNode) {
     primaryEl.remove();
   }
-  return { startMarker, primaryEl, extras, scopeComments, dispose, setItem };
+  return { startMarker, primaryEl, extras, scopeComments, dispose, setItem, setIndex };
 }
 function mapArray(accessor, container, getKey, renderItem, markerId, bfId, keyAttrName2 = BF_KEY) {
   if (!container)
@@ -2170,7 +2237,8 @@ function mapArray(accessor, container, getKey, renderItem, markerId, bfId, keyAt
             extras: range.extras,
             scopeComments: range.scopeComments,
             dispose: () => {},
-            setItem: () => {}
+            setItem: () => {},
+            setIndex: () => {}
           });
         }
       }
@@ -2216,7 +2284,10 @@ function mapArray(accessor, container, getKey, renderItem, markerId, bfId, keyAt
       newKeys.add(key);
       const existing = scopes.get(key);
       if (existing) {
-        existing.setItem(item);
+        batch(() => {
+          existing.setItem(item);
+          existing.setIndex(i2);
+        });
         desiredOrder.push(existing);
       } else {
         const scope = createItemScope(item, i2, renderItem, undefined, undefined, undefined, undefined, { container, anchor });
@@ -2314,23 +2385,26 @@ function removeAnchorScope(scope, end) {
 function createAnchorScope(item, index, key, renderItem, existingAnchor) {
   let dispose;
   let setItem;
+  let setIndex;
   let returned;
   createRoot2((d) => {
     dispose = d;
     const [itemAccessor, itemSetter] = createSignal(item);
+    const [indexAccessor, indexSetter] = createSignal(index);
     setItem = itemSetter;
-    returned = renderItem(itemAccessor, index, existingAnchor);
+    setIndex = indexSetter;
+    returned = renderItem(itemAccessor, indexAccessor, existingAnchor);
     return;
   });
   if (existingAnchor) {
-    return { anchor: existingAnchor, pending: null, dispose, setItem };
+    return { anchor: existingAnchor, pending: null, dispose, setItem, setIndex };
   }
   const frag = returned;
   const anchor = frag.firstChild;
   if (anchor && !anchor.nodeValue?.startsWith(ITEM_PREFIX)) {
     anchor.nodeValue = loopItemMarker(key);
   }
-  return { anchor, pending: frag, dispose, setItem };
+  return { anchor, pending: frag, dispose, setItem, setIndex };
 }
 function mapArrayAnchored(accessor, container, getKey, renderItem, markerId, bfId) {
   if (!container)
@@ -2381,7 +2455,10 @@ function mapArrayAnchored(accessor, container, getKey, renderItem, markerId, bfI
       newKeys.add(key);
       const existing = scopes.get(key);
       if (existing) {
-        existing.setItem(item);
+        batch(() => {
+          existing.setItem(item);
+          existing.setIndex(i);
+        });
         desiredOrder.push(existing);
       } else {
         const scope = createAnchorScope(item, i, key, renderItem);
@@ -2452,6 +2529,7 @@ function mapArrayLazy(accessor, container, getKey, plan, markerId, bfId, keyAttr
       key,
       primaryEl: undefined,
       item,
+      index,
       refs: null,
       last: null
     };
@@ -2481,7 +2559,7 @@ function mapArrayLazy(accessor, container, getKey, plan, markerId, bfId, keyAttr
           const el = doms[i2];
           const ssrKey = el.getAttribute(keyAttrName2);
           const key = ssrKey !== null ? ssrKey : getKey ? getKey(items[i2], i2) : String(i2);
-          const entry = { key, primaryEl: el, item: items[i2], refs: null, last: null };
+          const entry = { key, primaryEl: el, item: items[i2], index: i2, refs: null, last: null };
           entries.set(key, entry);
           list.push(entry);
         }
@@ -2536,11 +2614,19 @@ function mapArrayLazy(accessor, container, getKey, plan, markerId, bfId, keyAttr
       newKeys.add(key);
       const existing = entries.get(key);
       if (existing) {
-        if (!Object.is(existing.item, item)) {
+        const itemChanged = !Object.is(existing.item, item);
+        const indexChanged = plan.indexDriven === true && existing.index !== i2;
+        if (itemChanged) {
           const prevItem = existing.item;
           existing.item = item;
+          existing.index = i2;
           untrack2(() => plan.applyItem(existing, prevItem));
           markStranded();
+        } else if (indexChanged) {
+          existing.index = i2;
+          untrack2(() => plan.applyItem(existing, item));
+        } else {
+          existing.index = i2;
         }
         desiredOrder.push(existing);
       } else {
@@ -3402,6 +3488,7 @@ export {
   upsertChild,
   unwrap,
   untrack4 as untrack,
+  trackPosition,
   textOrNode,
   textNodeAfterComment as tAfter,
   styleToCss,
@@ -3455,6 +3542,7 @@ export {
   escapeTextOrNode,
   escapeTextOrMarkup,
   escapeText,
+  escapeCommentText,
   escapeAttr,
   endTurn,
   disposeScope,
@@ -3475,7 +3563,7 @@ export {
   claimSlots,
   bfMarkup,
   beginTurn,
-  batch,
+  batch2 as batch,
   applyRestAttrs,
   __slot,
   __bf_swap,

package/dist/runtime/map-array-lazy.d.ts

@@ -65,6 +65,18 @@
  *   (a misclassification must be harmless, not silently wrong) and for the
  *   three stranding sequences it prevents, each reproduced before it existed.
  *
+ * **Index-driven bindings (#2859 follow-up).** A row's position is tracked
+ * on `entry.index`, updated on every reconcile whether or not any binding
+ * reads it. A plan that sets `indexDriven: true` (emitted when
+ * `LazyRowPlanData.readsIndex`) is telling the runtime that some binding of
+ * `applyItem` reads `entry.index` — so the reconciler also calls
+ * `applyItem` on a pure reorder (item unchanged, position changed), not only
+ * on an item change. This mirrors the eager `mapArray` runtime's per-row
+ * index SIGNAL (`ItemScope.setIndex`) with no per-row reactive resource: the
+ * reconciler already knows a row's position changed the same way it already
+ * knows its item changed, so re-delivering that fact through a signal would
+ * be exactly the redundant machinery this design exists to avoid.
+ *
  * **Plan (compiler-emitted) obligations:**
  * - `createRow` MUST write ALL bindings — item-driven AND outer-involving —
  *   with current values (it is CSR creation; it computes everything anyway)
@@ -121,6 +133,13 @@ export interface LazyRowEntry<T> {
     key: string;
     primaryEl: HTMLElement;
     item: T;
+    /**
+     * The row's current position in the reconciled list (#2859 follow-up).
+     * Kept current on EVERY reconcile, whether or not the plan reads it —
+     * cheap bookkeeping, and it is what makes a bare reorder (no item change)
+     * detectable for `plan.indexDriven` loops.
+     */
+    index: number;
     /** plan-owned: claimed DOM refs, null until the row's first item-driven write */
     refs: unknown | null;
     /** plan-owned: per-binding last-value dedup state */
@@ -149,6 +168,16 @@ export interface LazyRowPlan<T> {
      *  nodeValue) to initialize its dedup value and write only where the
      *  computed value differs (read-compare-write, spec §9.3(1)). */
     applyOuter?(entries: ReadonlyArray<LazyRowEntry<T>>, seed: boolean): void;
+    /**
+     * True when some binding, condition, or preamble-substituted dependency of
+     * this row reads the loop's INDEX (#2859 follow-up,
+     * `LazyRowPlanData.readsIndex`). Such a binding is always `readsItem`
+     * (compiler-side), so the runtime must also call `applyItem` when a row's
+     * POSITION changes with no item change — a plain reorder — not only when
+     * `!Object.is(oldItem, newItem)`. Absent/false for every other loop, which
+     * keeps a bare reorder exactly as cheap as before this widening.
+     */
+    indexDriven?: boolean;
 }
 /**
  * Lazy-row-graph keyed list rendering (spec/slot-unification.md §9).

package/dist/runtime/map-array-lazy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"map-array-lazy.d.ts","sourceRoot":"","sources":["../../src/runtime/map-array-lazy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkHG;AAMH;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,WAAW,CAAA;IACtB,IAAI,EAAE,CAAC,CAAA;IACP,iFAAiF;IACjF,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;IACpB,qDAAqD;IACrD,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B;gFAC4E;IAC5E,SAAS,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAAA;IAC7D;;;4EAGwE;IACxE,SAAS,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAA;IACpD;;;;;;;qEAOiE;IACjE,UAAU,CAAC,CAAC,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;CAC1E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,QAAQ,EAAE,MAAM,CAAC,EAAE,EACnB,SAAS,EAAE,WAAW,GAAG,IAAI,EAC7B,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,IAAI,EACnD,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EACpB,QAAQ,CAAC,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,EACb,WAAW,GAAE,MAAe,GAC3B,IAAI,CA0SN"}
+{"version":3,"file":"map-array-lazy.d.ts","sourceRoot":"","sources":["../../src/runtime/map-array-lazy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8HG;AAMH;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,WAAW,CAAA;IACtB,IAAI,EAAE,CAAC,CAAA;IACP;;;;;OAKG;IACH,KAAK,EAAE,MAAM,CAAA;IACb,iFAAiF;IACjF,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;IACpB,qDAAqD;IACrD,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B;gFAC4E;IAC5E,SAAS,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAAA;IAC7D;;;4EAGwE;IACxE,SAAS,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAA;IACpD;;;;;;;qEAOiE;IACjE,UAAU,CAAC,CAAC,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;IACzE;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,QAAQ,EAAE,MAAM,CAAC,EAAE,EACnB,SAAS,EAAE,WAAW,GAAG,IAAI,EAC7B,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,GAAG,IAAI,EACnD,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EACpB,QAAQ,CAAC,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,EACb,WAAW,GAAE,MAAe,GAC3B,IAAI,CAwTN"}