@fluixi/dom 1.0.0-alpha.83 → 1.0.0-alpha.85

package/dist/lib/flow/client-only.mjs

@@ -1 +1,36 @@
-import{createMemo as u,createSignal as c}from"@fluixi/reactive/signal";var i=Symbol.for("fluixi.dom.server-host"),l=globalThis,s=l[i]??={server:typeof document>"u",nodes:null};function r(){return s.server}var n={active:!1,cursor:null,parents:[]};function d(e){if(r())return e.fallback??null;let t=n.active,[o,a]=c(!t);return t&&queueMicrotask(()=>a(!0)),u(()=>o()?e.children:e.fallback??null,void 0,{name:"client-only"})}var x=d;export{d as ClientOnly,x as NoSsr};
+// src/lib/flow/client-only.ts
+import { createMemo, createSignal } from "@fluixi/reactive/signal";
+
+// src/lib/dom/server/host.ts
+var STATE = /* @__PURE__ */ Symbol.for("fluixi.dom.server-host");
+var realm = globalThis;
+var state = realm[STATE] ??= {
+  server: typeof document === "undefined",
+  nodes: null
+};
+function isServer() {
+  return state.server;
+}
+
+// src/lib/dom/hydration-state.ts
+var hydration = {
+  active: false,
+  cursor: null,
+  parents: []
+};
+
+// src/lib/flow/client-only.ts
+function ClientOnly(props) {
+  if (isServer()) return props.fallback ?? null;
+  const hydrating = hydration.active;
+  const [ready, setReady] = createSignal(!hydrating);
+  if (hydrating) queueMicrotask(() => setReady(true));
+  return createMemo(() => ready() ? props.children : props.fallback ?? null, void 0, {
+    name: "client-only"
+  });
+}
+var NoSsr = ClientOnly;
+export {
+  ClientOnly,
+  NoSsr
+};

package/dist/lib/flow/dynamic.cjs

@@ -1 +1,53 @@
-"use strict";var a=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var l=Object.prototype.hasOwnProperty;var d=(n,e)=>{for(var s in e)a(n,s,{get:e[s],enumerable:!0})},T=(n,e,s,c)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of y(e))!l.call(n,t)&&t!==s&&a(n,t,{get:()=>e[t],enumerable:!(c=u(e,t))||c.enumerable});return n};var m=n=>T(a({},"__esModule",{value:!0}),n);var g={};d(g,{Dynamic:()=>A});module.exports=m(g);var r=require("@fluixi/reactive/signal");function f(n){return typeof n=="function"?n:(()=>n)}function A(n){let e=f(n.component),{component:s,...c}=n,t=(0,r.getOwner)(),i=null,p;return(0,r.createMemo)(()=>{let o=e();return o!==p&&(i&&(0,r.disposeScope)(i),i=(0,r.createChildOwner)(t),p=o),o==null?null:typeof o=="string"?{tag:o,props:c}:(0,r.runWithOwner)(i,()=>o(c))},void 0,{name:"Dynamic"})}
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/flow/dynamic.ts
+var dynamic_exports = {};
+__export(dynamic_exports, {
+  Dynamic: () => Dynamic
+});
+module.exports = __toCommonJS(dynamic_exports);
+var import_signal = require("@fluixi/reactive/signal");
+
+// src/lib/flow/utils.ts
+function normalizeAccessor(value) {
+  return typeof value === "function" ? value : (() => value);
+}
+
+// src/lib/flow/dynamic.ts
+function Dynamic(props) {
+  const getComponent = normalizeAccessor(props.component);
+  const { component: _c, ...rest } = props;
+  const parentOwner = (0, import_signal.getOwner)();
+  let scope = null;
+  let current;
+  return (0, import_signal.createMemo)(() => {
+    const C = getComponent();
+    if (C !== current) {
+      if (scope) (0, import_signal.disposeScope)(scope);
+      scope = (0, import_signal.createChildOwner)(parentOwner);
+      current = C;
+    }
+    if (C == null) return null;
+    if (typeof C === "string") {
+      return { tag: C, props: rest };
+    }
+    return (0, import_signal.runWithOwner)(scope, () => C(rest));
+  }, void 0, { name: "Dynamic" });
+}

package/dist/lib/flow/dynamic.d.ts

@@ -11,11 +11,11 @@ export interface DynamicProps<T extends Record<string, any> = Record<string, any
     [key: string]: any;
 }
 /**
- * Renders a component dynamically — mirrors SolidJS `<Dynamic>`.
+ * Renders a component dynamically: mirrors SolidJS `<Dynamic>`.
  *
  * The `component` prop can be a reactive accessor.  When it changes,
  * the old output is discarded and the new component is called.
- * Returns a memo — works in both JSX and `html` templates.
+ * Returns a memo: works in both JSX and `html` templates.
  *
  * @example JSX
  * <Dynamic component={tab() === 'a' ? CompA : CompB} value={x()} />

package/dist/lib/flow/dynamic.js

@@ -1,11 +1,11 @@
 import { createMemo, createChildOwner, disposeScope, getOwner, runWithOwner } from '@fluixi/reactive/signal';
 import { normalizeAccessor } from './utils.js';
 /**
- * Renders a component dynamically — mirrors SolidJS `<Dynamic>`.
+ * Renders a component dynamically: mirrors SolidJS `<Dynamic>`.
  *
  * The `component` prop can be a reactive accessor.  When it changes,
  * the old output is discarded and the new component is called.
- * Returns a memo — works in both JSX and `html` templates.
+ * Returns a memo: works in both JSX and `html` templates.
  *
  * @example JSX
  * <Dynamic component={tab() === 'a' ? CompA : CompB} value={x()} />
@@ -35,7 +35,7 @@ export function Dynamic(props) {
         if (C == null)
             return null;
         if (typeof C === 'string') {
-            // Intrinsic element — return a descriptor that the runtime can handle.
+            // Intrinsic element: return a descriptor that the runtime can handle.
             return { tag: C, props: rest };
         }
         return runWithOwner(scope, () => C(rest));

package/dist/lib/flow/dynamic.mjs

@@ -1 +1,32 @@
-import{createMemo as a,createChildOwner as p,disposeScope as f,getOwner as u,runWithOwner as y}from"@fluixi/reactive/signal";function s(n){return typeof n=="function"?n:(()=>n)}function g(n){let c=s(n.component),{component:l,...t}=n,i=u(),r=null,o;return a(()=>{let e=c();return e!==o&&(r&&f(r),r=p(i),o=e),e==null?null:typeof e=="string"?{tag:e,props:t}:y(r,()=>e(t))},void 0,{name:"Dynamic"})}export{g as Dynamic};
+// src/lib/flow/dynamic.ts
+import { createMemo, createChildOwner, disposeScope, getOwner, runWithOwner } from "@fluixi/reactive/signal";
+
+// src/lib/flow/utils.ts
+function normalizeAccessor(value) {
+  return typeof value === "function" ? value : (() => value);
+}
+
+// src/lib/flow/dynamic.ts
+function Dynamic(props) {
+  const getComponent = normalizeAccessor(props.component);
+  const { component: _c, ...rest } = props;
+  const parentOwner = getOwner();
+  let scope = null;
+  let current;
+  return createMemo(() => {
+    const C = getComponent();
+    if (C !== current) {
+      if (scope) disposeScope(scope);
+      scope = createChildOwner(parentOwner);
+      current = C;
+    }
+    if (C == null) return null;
+    if (typeof C === "string") {
+      return { tag: C, props: rest };
+    }
+    return runWithOwner(scope, () => C(rest));
+  }, void 0, { name: "Dynamic" });
+}
+export {
+  Dynamic
+};

package/dist/lib/flow/error-boundary.cjs

@@ -1 +1,43 @@
-"use strict";var l=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var i=Object.prototype.hasOwnProperty;var y=(n,r)=>{for(var t in r)l(n,t,{get:r[t],enumerable:!0})},d=(n,r,t,c)=>{if(r&&typeof r=="object"||typeof r=="function")for(let e of f(r))!i.call(n,e)&&e!==t&&l(n,e,{get:()=>r[e],enumerable:!(c=u(r,e))||c.enumerable});return n};var k=n=>d(l({},"__esModule",{value:!0}),n);var h={};y(h,{ErrorBoundary:()=>b});module.exports=k(h);var a=require("@fluixi/reactive/signal");function b(n){let[r,t]=(0,a.createSignal)(null),c=()=>t(null);return(0,a.createMemo)(()=>{let e=r();if(e!==null)return typeof n.fallback=="function"?n.fallback(e,c):n.fallback;try{return typeof n.children=="function"?n.children():n.children}catch(o){return t(o),typeof n.fallback=="function"?n.fallback(o,c):n.fallback}},void 0,{name:"ErrorBoundary"})}
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/flow/error-boundary.ts
+var error_boundary_exports = {};
+__export(error_boundary_exports, {
+  ErrorBoundary: () => ErrorBoundary
+});
+module.exports = __toCommonJS(error_boundary_exports);
+var import_signal = require("@fluixi/reactive/signal");
+function ErrorBoundary(props) {
+  const [error, setError] = (0, import_signal.createSignal)(null);
+  const reset = () => setError(null);
+  return (0, import_signal.createMemo)(() => {
+    const err = error();
+    if (err !== null) {
+      return typeof props.fallback === "function" ? props.fallback(err, reset) : props.fallback;
+    }
+    try {
+      const content = typeof props.children === "function" ? props.children() : props.children;
+      return content;
+    } catch (e) {
+      setError(e);
+      return typeof props.fallback === "function" ? props.fallback(e, reset) : props.fallback;
+    }
+  }, void 0, { name: "ErrorBoundary" });
+}

package/dist/lib/flow/error-boundary.d.ts

@@ -9,10 +9,10 @@ export interface ErrorBoundaryProps {
  * Catches synchronous errors thrown during child rendering.
  *
  * When a child throws, renders `fallback` instead.  `fallback` can be a
- * static value or a function `(err, reset) => UI` — calling `reset()` clears
+ * static value or a function `(err, reset) => UI`, calling `reset()` clears
  * the error state and retries rendering the children.
  *
- * Returns a memo — works in both JSX and `html` templates.
+ * Returns a memo: works in both JSX and `html` templates.
  *
  * Note: Only catches errors thrown synchronously during the render phase
  * (memo evaluation).  Async errors inside effects are not caught here.

package/dist/lib/flow/error-boundary.js

@@ -3,10 +3,10 @@ import { createMemo, createSignal } from '@fluixi/reactive/signal';
  * Catches synchronous errors thrown during child rendering.
  *
  * When a child throws, renders `fallback` instead.  `fallback` can be a
- * static value or a function `(err, reset) => UI` — calling `reset()` clears
+ * static value or a function `(err, reset) => UI`, calling `reset()` clears
  * the error state and retries rendering the children.
  *
- * Returns a memo — works in both JSX and `html` templates.
+ * Returns a memo: works in both JSX and `html` templates.
  *
  * Note: Only catches errors thrown synchronously during the render phase
  * (memo evaluation).  Async errors inside effects are not caught here.
@@ -39,7 +39,7 @@ export function ErrorBoundary(props) {
             return content;
         }
         catch (e) {
-            // Caught a synchronous render error — switch to fallback.
+            // Caught a synchronous render error: switch to fallback.
             setError(e);
             return typeof props.fallback === 'function'
                 ? props.fallback(e, reset)

package/dist/lib/flow/error-boundary.mjs

@@ -1 +1,22 @@
-import{createMemo as o,createSignal as l}from"@fluixi/reactive/signal";function d(n){let[a,e]=l(null),t=()=>e(null);return o(()=>{let c=a();if(c!==null)return typeof n.fallback=="function"?n.fallback(c,t):n.fallback;try{return typeof n.children=="function"?n.children():n.children}catch(r){return e(r),typeof n.fallback=="function"?n.fallback(r,t):n.fallback}},void 0,{name:"ErrorBoundary"})}export{d as ErrorBoundary};
+// src/lib/flow/error-boundary.ts
+import { createMemo, createSignal } from "@fluixi/reactive/signal";
+function ErrorBoundary(props) {
+  const [error, setError] = createSignal(null);
+  const reset = () => setError(null);
+  return createMemo(() => {
+    const err = error();
+    if (err !== null) {
+      return typeof props.fallback === "function" ? props.fallback(err, reset) : props.fallback;
+    }
+    try {
+      const content = typeof props.children === "function" ? props.children() : props.children;
+      return content;
+    } catch (e) {
+      setError(e);
+      return typeof props.fallback === "function" ? props.fallback(e, reset) : props.fallback;
+    }
+  }, void 0, { name: "ErrorBoundary" });
+}
+export {
+  ErrorBoundary
+};

package/dist/lib/flow/for.cjs

@@ -1 +1,66 @@
-"use strict";var u=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var T=Object.getOwnPropertyNames;var A=Object.prototype.hasOwnProperty;var x=(r,e)=>{for(var t in e)u(r,t,{get:e[t],enumerable:!0})},v=(r,e,t,a)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of T(e))!A.call(r,n)&&n!==t&&u(r,n,{get:()=>e[n],enumerable:!(a=f(e,n))||a.enumerable});return r};var U=r=>v(u({},"__esModule",{value:!0}),r);var b={};x(b,{For:()=>m});module.exports=U(b);var i=require("@fluixi/reactive/signal");function p(r){return()=>{let e=r();return typeof e=="function"?e():e}}var c={active:!1,cursor:null,parents:[]};function h(r){let e=c.parents.lastIndexOf(r);e!==-1&&(c.parents.length=e),c.cursor=r.nextSibling}function d(r){if(!c.active||r==null)return;let e=Array.isArray(r)?r[r.length-1]:r;e&&typeof e.nodeType=="number"&&h(e)}function m(r){let e=p(()=>r.each),t=()=>r.fallback??null,a=(n,o)=>{let s=r.children,y=Array.isArray(s)?s.map(l=>typeof l=="function"?l(n,o):l):typeof s=="function"?s(n,o):s;return d(y),y};return r.by?(0,i.keyArray)(e,r.by,(n,o)=>a(n,o),{fallback:t}):(0,i.mapArray)(e,(n,o)=>a(n,o),{fallback:t})}
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/flow/for.ts
+var for_exports = {};
+__export(for_exports, {
+  For: () => For
+});
+module.exports = __toCommonJS(for_exports);
+var import_signal = require("@fluixi/reactive/signal");
+
+// src/lib/flow/utils.ts
+function resolveReactiveProp(read) {
+  return () => {
+    const value = read();
+    return typeof value === "function" ? value() : value;
+  };
+}
+
+// src/lib/dom/hydration-state.ts
+var hydration = {
+  active: false,
+  cursor: null,
+  parents: []
+};
+function ascendPast(node) {
+  const idx = hydration.parents.lastIndexOf(node);
+  if (idx !== -1) hydration.parents.length = idx;
+  hydration.cursor = node.nextSibling;
+}
+function hydrateAdvancePast(rendered) {
+  if (!hydration.active || rendered == null) return;
+  const last = Array.isArray(rendered) ? rendered[rendered.length - 1] : rendered;
+  if (last && typeof last.nodeType === "number") {
+    ascendPast(last);
+  }
+}
+
+// src/lib/flow/for.ts
+function For(props) {
+  const each = resolveReactiveProp(() => props.each);
+  const fallback = () => props.fallback ?? null;
+  const render = (item, index) => {
+    const children = props.children;
+    const rendered = Array.isArray(children) ? children.map((c) => typeof c === "function" ? c(item, index) : c) : typeof children === "function" ? children(item, index) : children;
+    hydrateAdvancePast(rendered);
+    return rendered;
+  };
+  return props.by ? (0, import_signal.keyArray)(each, props.by, (item, index) => render(item, index), { fallback }) : (0, import_signal.mapArray)(each, (item, index) => render(item, index), { fallback });
+}

package/dist/lib/flow/for.d.ts

@@ -1,8 +1,8 @@
 import { Accessor } from '@fluixi/reactive/signal';
 type EachSource<T> = ReadonlyArray<T> | (() => ReadonlyArray<T> | null | undefined) | Accessor<ReadonlyArray<T>> | null | undefined | false;
-/** Props when `by` is NOT provided — item is the plain value `T`. */
+/** Props when `by` is not provided: item is the plain value `T`. */
 export interface ForPropsUnkeyed<T, U = any> {
-    /** Reactive array to iterate over — static, readonly, accessor, or signal. */
+    /** Reactive array to iterate over: static, readonly, accessor, or signal. */
     each: EachSource<T>;
     /** Rendered when the array is empty or nullish. */
     fallback?: any;
@@ -15,15 +15,15 @@ export interface ForPropsUnkeyed<T, U = any> {
     children: (item: T, index: Accessor<number>) => U;
     by?: undefined;
 }
-/** Props when `by` IS provided — item is a reactive `Accessor<T>`. */
+/** Props when `by` is provided: item is a reactive `Accessor<T>`. */
 export interface ForPropsKeyed<T, U = any> {
-    /** Reactive array to iterate over — static, readonly, accessor, or signal. */
+    /** Reactive array to iterate over: static, readonly, accessor, or signal. */
     each: EachSource<T>;
     /** Rendered when the array is empty or nullish. */
     fallback?: any;
     /**
      * Render function called once per unique key.
-     * `item` is a reactive accessor — call `item()` inside to read the current value.
+     * `item` is a reactive accessor: call `item()` inside to read the current value.
      * The same DOM is reused whenever `by(item)` returns the same key, even if the
      * object reference changes.
      *
@@ -39,21 +39,21 @@ export interface ForPropsKeyed<T, U = any> {
 }
 export type ForProps<T, U = any> = ForPropsUnkeyed<T, U> | ForPropsKeyed<T, U>;
 /**
- * Keyed list rendering — mirrors SolidJS `<For>`.
+ * Keyed list rendering: mirrors SolidJS `<For>`.
  *
- * Default: keyed by object reference. Same object at new index → only index
+ * Default: keyed by object reference. Same object at new index -> only index
  * signal updates (no DOM re-render). Removed items are disposed.
  *
  * With `by`: keyed by the return value of `by(item)`. When the same key is
  * found in the previous render, the DOM entry is reused and the index signal
  * is updated. The item accessor is a live `createMemo(() => list[idx()])` so
  * that reading `item().someField` inside a reactive context creates a
- * fine-grained dependency on the store proxy property — not a frozen snapshot.
+ * fine-grained dependency on the store proxy property, not a frozen snapshot.
  *
  * @example Reference-keyed (default)
  * <For each={items}>{(item, idx) => <li>{item.name}</li>}</For>
  *
- * @example Stable-key (by prop) — survives object recreation
+ * @example Stable-key (by prop): survives object recreation
  * <For each={rows} by={r => r.id}>
  *   {(row, idx) => <tr><td>{() => row().name}</td></tr>}
  * </For>

package/dist/lib/flow/for.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"for.d.ts","sourceRoot":"","sources":["../../../src/lib/flow/for.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAsB,MAAM,yBAAyB,CAAC;AAIvE,KAAK,UAAU,CAAC,CAAC,IACb,aAAa,CAAC,CAAC,CAAC,GAChB,CAAC,MAAM,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,GAC3C,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAC1B,IAAI,GACJ,SAAS,GACT,KAAK,CAAC;AAEV,qEAAqE;AACrE,MAAM,WAAW,eAAe,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG;IACzC,8EAA8E;IAC9E,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACpB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf;;;;;OAKG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClD,EAAE,CAAC,EAAE,SAAS,CAAC;CAChB;AAED,sEAAsE;AACtE,MAAM,WAAW,aAAa,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG;IACvC,8EAA8E;IAC9E,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACpB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf;;;;;;;;OAQG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5D;;;OAGG;IACH,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,GAAG,CAAC;CACtB;AAED,MAAM,MAAM,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,IAAI,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,wBAAgB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;AACrE,wBAAgB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC"}
+{"version":3,"file":"for.d.ts","sourceRoot":"","sources":["../../../src/lib/flow/for.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAsB,MAAM,yBAAyB,CAAC;AAIvE,KAAK,UAAU,CAAC,CAAC,IACb,aAAa,CAAC,CAAC,CAAC,GAChB,CAAC,MAAM,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,GAC3C,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAC1B,IAAI,GACJ,SAAS,GACT,KAAK,CAAC;AAEV,oEAAoE;AACpE,MAAM,WAAW,eAAe,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG;IACzC,6EAA6E;IAC7E,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACpB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf;;;;;OAKG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClD,EAAE,CAAC,EAAE,SAAS,CAAC;CAChB;AAED,qEAAqE;AACrE,MAAM,WAAW,aAAa,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG;IACvC,6EAA6E;IAC7E,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACpB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf;;;;;;;;OAQG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5D;;;OAGG;IACH,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,GAAG,CAAC;CACtB;AAED,MAAM,MAAM,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,IAAI,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,wBAAgB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;AACrE,wBAAgB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC"}

package/dist/lib/flow/for.js

@@ -4,7 +4,7 @@ import { hydrateAdvancePast } from '../dom/hydration-state.js';
 export function For(props) {
     // Read `each` lazily through the prop getter so `each={items()}` re-runs inside
     // mapArray's tracking memo (fine-grained keyed diffing), while `each={items}` still
-    // works — resolveReactiveProp unwraps the accessor form once.
+    // works: resolveReactiveProp unwraps the accessor form once.
     const each = resolveReactiveProp(() => props.each);
     const fallback = () => props.fallback ?? null;
     // Render the children (a fn, or an array of fn/values) for one item, then
@@ -19,7 +19,7 @@ export function For(props) {
         hydrateAdvancePast(rendered);
         return rendered;
     };
-    // `by` → key-function reconciliation (item is a live accessor); default →
+    // `by` -> key-function reconciliation (item is a live accessor); default -> 
     // reference reconciliation (item is the plain value). Both keep each item in
     // its own root so list items stay owner-stable.
     return props.by

package/dist/lib/flow/for.mjs

@@ -1 +1,45 @@
-import{mapArray as d,keyArray as f}from"@fluixi/reactive/signal";function u(r){return()=>{let e=r();return typeof e=="function"?e():e}}var a={active:!1,cursor:null,parents:[]};function p(r){let e=a.parents.lastIndexOf(r);e!==-1&&(a.parents.length=e),a.cursor=r.nextSibling}function y(r){if(!a.active||r==null)return;let e=Array.isArray(r)?r[r.length-1]:r;e&&typeof e.nodeType=="number"&&p(e)}function m(r){let e=u(()=>r.each),c=()=>r.fallback??null,i=(n,t)=>{let o=r.children,l=Array.isArray(o)?o.map(s=>typeof s=="function"?s(n,t):s):typeof o=="function"?o(n,t):o;return y(l),l};return r.by?f(e,r.by,(n,t)=>i(n,t),{fallback:c}):d(e,(n,t)=>i(n,t),{fallback:c})}export{m as For};
+// src/lib/flow/for.ts
+import { mapArray, keyArray } from "@fluixi/reactive/signal";
+
+// src/lib/flow/utils.ts
+function resolveReactiveProp(read) {
+  return () => {
+    const value = read();
+    return typeof value === "function" ? value() : value;
+  };
+}
+
+// src/lib/dom/hydration-state.ts
+var hydration = {
+  active: false,
+  cursor: null,
+  parents: []
+};
+function ascendPast(node) {
+  const idx = hydration.parents.lastIndexOf(node);
+  if (idx !== -1) hydration.parents.length = idx;
+  hydration.cursor = node.nextSibling;
+}
+function hydrateAdvancePast(rendered) {
+  if (!hydration.active || rendered == null) return;
+  const last = Array.isArray(rendered) ? rendered[rendered.length - 1] : rendered;
+  if (last && typeof last.nodeType === "number") {
+    ascendPast(last);
+  }
+}
+
+// src/lib/flow/for.ts
+function For(props) {
+  const each = resolveReactiveProp(() => props.each);
+  const fallback = () => props.fallback ?? null;
+  const render = (item, index) => {
+    const children = props.children;
+    const rendered = Array.isArray(children) ? children.map((c) => typeof c === "function" ? c(item, index) : c) : typeof children === "function" ? children(item, index) : children;
+    hydrateAdvancePast(rendered);
+    return rendered;
+  };
+  return props.by ? keyArray(each, props.by, (item, index) => render(item, index), { fallback }) : mapArray(each, (item, index) => render(item, index), { fallback });
+}
+export {
+  For
+};

package/dist/lib/flow/index-flow.cjs

@@ -1 +1,67 @@
-"use strict";var s=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var p=(e,r)=>{for(var n in r)s(e,n,{get:r[n],enumerable:!0})},y=(e,r,n,o)=>{if(r&&typeof r=="object"||typeof r=="function")for(let t of d(r))!f.call(e,t)&&t!==n&&s(e,t,{get:()=>r[t],enumerable:!(o=u(r,t))||o.enumerable});return e};var T=e=>y(s({},"__esModule",{value:!0}),e);var A={};p(A,{Index:()=>v});module.exports=T(A);var l=require("@fluixi/reactive/signal");function i(e){return()=>{let r=e();return typeof r=="function"?r():r}}var a={active:!1,cursor:null,parents:[]};function x(e){let r=a.parents.lastIndexOf(e);r!==-1&&(a.parents.length=r),a.cursor=e.nextSibling}function c(e){if(!a.active||e==null)return;let r=Array.isArray(e)?e[e.length-1]:e;r&&typeof r.nodeType=="number"&&x(r)}function v(e){let r=i(()=>e.each);return(0,l.indexArray)(r,(n,o)=>{let t=e.children(n,o);return c(t),t},{fallback:()=>e.fallback??null})}
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/flow/index-flow.ts
+var index_flow_exports = {};
+__export(index_flow_exports, {
+  Index: () => Index
+});
+module.exports = __toCommonJS(index_flow_exports);
+var import_signal = require("@fluixi/reactive/signal");
+
+// src/lib/flow/utils.ts
+function resolveReactiveProp(read) {
+  return () => {
+    const value = read();
+    return typeof value === "function" ? value() : value;
+  };
+}
+
+// src/lib/dom/hydration-state.ts
+var hydration = {
+  active: false,
+  cursor: null,
+  parents: []
+};
+function ascendPast(node) {
+  const idx = hydration.parents.lastIndexOf(node);
+  if (idx !== -1) hydration.parents.length = idx;
+  hydration.cursor = node.nextSibling;
+}
+function hydrateAdvancePast(rendered) {
+  if (!hydration.active || rendered == null) return;
+  const last = Array.isArray(rendered) ? rendered[rendered.length - 1] : rendered;
+  if (last && typeof last.nodeType === "number") {
+    ascendPast(last);
+  }
+}
+
+// src/lib/flow/index-flow.ts
+function Index(props) {
+  const each = resolveReactiveProp(() => props.each);
+  return (0, import_signal.indexArray)(
+    each,
+    (item, index) => {
+      const rendered = props.children(item, index);
+      hydrateAdvancePast(rendered);
+      return rendered;
+    },
+    { fallback: () => props.fallback ?? null }
+  );
+}

package/dist/lib/flow/index-flow.d.ts

@@ -6,7 +6,7 @@ export interface IndexProps<T, U = any> {
     fallback?: any;
     /**
      * Render function called once per stable index slot.
-     * `item` is a reactive accessor — updates when the item at that index changes.
+     * `item` is a reactive accessor: updates when the item at that index changes.
      * `index` is a plain number (stable).
      *
      * JSX:    <Index each={items()}>{(item, index) => <li>{item().name}</li>}</Index>
@@ -15,20 +15,20 @@ export interface IndexProps<T, U = any> {
     children: (item: Accessor<T>, index: number) => U;
 }
 /**
- * Non-keyed list rendering — mirrors SolidJS `<Index>`.
+ * Non-keyed list rendering: mirrors SolidJS `<Index>`.
  *
  * Keyed by position. When the list grows, new slots are created.
  * When it shrinks, trailing slots are disposed. When an item at a
  * given index changes value, only the `item` signal updates (no re-render).
- * Returns a memo of the rendered array — works in both JSX and `html` templates.
+ * Returns a memo of the rendered array: works in both JSX and `html` templates.
  *
  * @example JSX
  * <Index each={items()} fallback={<p>Empty</p>}>
- *   {(item, index) => <li>{index} — {item().name}</li>}
+ *   {(item, index) => <li>{index}: {item().name}</li>}
  * </Index>
  *
  * @example html template
- * Index({ each: items, children: (item, i) => html`<li>${i} — ${item().name}</li>` })
+ * Index({ each: items, children: (item, i) => html`<li>${i}. ${item().name}</li>` })
  */
 export declare function Index<T, U = any>(props: IndexProps<T, U>): Accessor<U[] | any>;
 //# sourceMappingURL=index-flow.d.ts.map

package/dist/lib/flow/index-flow.js

@@ -2,20 +2,20 @@ import { indexArray } from '@fluixi/reactive/signal';
 import { resolveReactiveProp } from './utils.js';
 import { hydrateAdvancePast } from '../dom/hydration-state.js';
 /**
- * Non-keyed list rendering — mirrors SolidJS `<Index>`.
+ * Non-keyed list rendering: mirrors SolidJS `<Index>`.
  *
  * Keyed by position. When the list grows, new slots are created.
  * When it shrinks, trailing slots are disposed. When an item at a
  * given index changes value, only the `item` signal updates (no re-render).
- * Returns a memo of the rendered array — works in both JSX and `html` templates.
+ * Returns a memo of the rendered array: works in both JSX and `html` templates.
  *
  * @example JSX
  * <Index each={items()} fallback={<p>Empty</p>}>
- *   {(item, index) => <li>{index} — {item().name}</li>}
+ *   {(item, index) => <li>{index}: {item().name}</li>}
  * </Index>
  *
  * @example html template
- * Index({ each: items, children: (item, i) => html`<li>${i} — ${item().name}</li>` })
+ * Index({ each: items, children: (item, i) => html`<li>${i}. ${item().name}</li>` })
  */
 export function Index(props) {
     const each = resolveReactiveProp(() => props.each);

package/dist/lib/flow/index-flow.mjs

@@ -1 +1,46 @@
-import{indexArray as l}from"@fluixi/reactive/signal";function o(e){return()=>{let r=e();return typeof r=="function"?r():r}}var t={active:!1,cursor:null,parents:[]};function c(e){let r=t.parents.lastIndexOf(e);r!==-1&&(t.parents.length=r),t.cursor=e.nextSibling}function a(e){if(!t.active||e==null)return;let r=Array.isArray(e)?e[e.length-1]:e;r&&typeof r.nodeType=="number"&&c(r)}function x(e){let r=o(()=>e.each);return l(r,(s,i)=>{let n=e.children(s,i);return a(n),n},{fallback:()=>e.fallback??null})}export{x as Index};
+// src/lib/flow/index-flow.ts
+import { indexArray } from "@fluixi/reactive/signal";
+
+// src/lib/flow/utils.ts
+function resolveReactiveProp(read) {
+  return () => {
+    const value = read();
+    return typeof value === "function" ? value() : value;
+  };
+}
+
+// src/lib/dom/hydration-state.ts
+var hydration = {
+  active: false,
+  cursor: null,
+  parents: []
+};
+function ascendPast(node) {
+  const idx = hydration.parents.lastIndexOf(node);
+  if (idx !== -1) hydration.parents.length = idx;
+  hydration.cursor = node.nextSibling;
+}
+function hydrateAdvancePast(rendered) {
+  if (!hydration.active || rendered == null) return;
+  const last = Array.isArray(rendered) ? rendered[rendered.length - 1] : rendered;
+  if (last && typeof last.nodeType === "number") {
+    ascendPast(last);
+  }
+}
+
+// src/lib/flow/index-flow.ts
+function Index(props) {
+  const each = resolveReactiveProp(() => props.each);
+  return indexArray(
+    each,
+    (item, index) => {
+      const rendered = props.children(item, index);
+      hydrateAdvancePast(rendered);
+      return rendered;
+    },
+    { fallback: () => props.fallback ?? null }
+  );
+}
+export {
+  Index
+};