@barefootjs/shared 0.4.0 → 0.5.1

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { BF_SCOPE, BF_SLOT, BF_HOST, BF_AT, BF_ROOT, BF_PROPS, BF_COND, BF_ITEM, BF_PORTAL_OWNER, BF_PORTAL_ID, BF_PORTAL_PLACEHOLDER, BF_PARENT_OWNED_PREFIX, BF_SCOPE_COMMENT_PREFIX, BF_LOOP_START, BF_LOOP_END, BF_LOOP_ITEM, loopStartMarker, loopEndMarker, BF_KEY, BF_KEY_PREFIX, BF_PLACEHOLDER, BF_ASYNC, BF_ASYNC_RESOLVE, BF_PARENT_SCOPE_PLACEHOLDER, } from './markers';
+export { BF_SCOPE, BF_SLOT, BF_HOST, BF_AT, BF_ROOT, BF_PROPS, BF_COND, BF_ITEM, BF_PORTAL_OWNER, BF_PORTAL_ID, BF_PORTAL_PLACEHOLDER, BF_PARENT_OWNED_PREFIX, BF_SCOPE_COMMENT_PREFIX, BF_LOOP_START, BF_LOOP_END, BF_LOOP_ITEM, loopItemMarker, loopStartMarker, loopEndMarker, BF_KEY, BF_KEY_PREFIX, BF_PLACEHOLDER, BF_ASYNC, BF_ASYNC_RESOLVE, BF_PARENT_SCOPE_PLACEHOLDER, } from './markers';
 export { classifyDOMProp, toHTMLAttrName, toHTMLAttrNameRuntime, isBooleanAttr, isEventProp, BOOLEAN_ATTRS, } from './dom-prop';
 export type { DOMPropKind, DOMPropClassification } from './dom-prop';

package/dist/index.js

@@ -15,6 +15,9 @@ var BF_SCOPE_COMMENT_PREFIX = "bf-scope:";
 var BF_LOOP_START = "bf-loop";
 var BF_LOOP_END = "bf-/loop";
 var BF_LOOP_ITEM = "bf-loop-i";
+function loopItemMarker(key) {
+  return `${BF_LOOP_ITEM}:${key}`;
+}
 function loopStartMarker(markerId) {
   return `${BF_LOOP_START}:${markerId}`;
 }
@@ -194,6 +197,7 @@ export {
   toHTMLAttrNameRuntime,
   toHTMLAttrName,
   loopStartMarker,
+  loopItemMarker,
   loopEndMarker,
   isEventProp,
   isBooleanAttr,

package/dist/markers.d.ts

@@ -85,6 +85,16 @@ export declare const BF_LOOP_END = "bf-/loop";
  * nodes (#1212).
  */
 export declare const BF_LOOP_ITEM = "bf-loop-i";
+/**
+ * Build the per-item anchor comment value for a loop item: `bf-loop-i:<key>`.
+ *
+ * The key is embedded in the comment value (comments cannot carry
+ * attributes) so an item's identity survives SSR → hydration and so a
+ * range-scoped `insert()` can anchor a whole-item conditional to it
+ * without a wrapper element. An item's range runs from this anchor until
+ * the next `bf-loop-i:*` anchor or the loop end marker.
+ */
+export declare function loopItemMarker(key: string): string;
 /** Build the start-marker comment value for a loop. */
 export declare function loopStartMarker(markerId: string): string;
 /** Build the end-marker comment value for a loop. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@barefootjs/shared",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "Shared constants for BarefootJS compiler and runtime",
   "type": "module",
   "main": "./dist/index.js",

package/src/index.ts

@@ -15,6 +15,7 @@ export {
   BF_LOOP_START,
   BF_LOOP_END,
   BF_LOOP_ITEM,
+  loopItemMarker,
   loopStartMarker,
   loopEndMarker,
   BF_KEY,

package/src/markers.ts

@@ -122,6 +122,19 @@ export const BF_LOOP_END = 'bf-/loop'
  */
 export const BF_LOOP_ITEM = 'bf-loop-i'
 
+/**
+ * Build the per-item anchor comment value for a loop item: `bf-loop-i:<key>`.
+ *
+ * The key is embedded in the comment value (comments cannot carry
+ * attributes) so an item's identity survives SSR → hydration and so a
+ * range-scoped `insert()` can anchor a whole-item conditional to it
+ * without a wrapper element. An item's range runs from this anchor until
+ * the next `bf-loop-i:*` anchor or the loop end marker.
+ */
+export function loopItemMarker(key: string): string {
+  return `${BF_LOOP_ITEM}:${key}`
+}
+
 /** Build the start-marker comment value for a loop. */
 export function loopStartMarker(markerId: string): string {
   return `${BF_LOOP_START}:${markerId}`