@pilotiq/pilotiq 0.10.0 → 0.11.0

package/.turbo/turbo-build.log

@@ -1,8 +1,8 @@
 
-> @pilotiq/pilotiq@0.10.0 build /home/runner/work/pilotiq/pilotiq/packages/pilotiq
+> @pilotiq/pilotiq@0.11.0 build /home/runner/work/pilotiq/pilotiq/packages/pilotiq
 > tsc -p tsconfig.build.json && pnpm run copy-assets
 
 
-> @pilotiq/pilotiq@0.10.0 copy-assets /home/runner/work/pilotiq/pilotiq/packages/pilotiq
+> @pilotiq/pilotiq@0.11.0 copy-assets /home/runner/work/pilotiq/pilotiq/packages/pilotiq
 > mkdir -p dist/styles && cp -R src/styles/*.css dist/styles/
 

package/CHANGELOG.md

@@ -1,5 +1,125 @@
 # @pilotiq/pilotiq
 
+## 0.11.0
+
+### Minor Changes
+
+- d36902d: feat(pilotiq): F.5a — Repeater/Builder row-identity contract for collab
+
+  Widens `FormCollabBinding` with five optional row-array methods plus a
+  `RowsEvent` type so the upcoming `Y.Array<Y.Map>` impl in
+  `@pilotiq-pro/collab` (F.5b) has a stable surface to hook into. Renderer
+  side wiring is live in this release — `RepeaterInput` + `BuilderInput`
+  already dispatch `add` / `remove` / `reorder` / `subscribe` through the
+  binding when one is registered and reconcile remote row events into
+  their local state by `__id`. No behaviour change for non-collab forms
+  or bindings that pre-date F.5; pre-F.5 bindings keep typechecking
+  because every new method is optional.
+
+  ### New public surface
+
+  - **`useRowBinding(arrayName)`** — returns a `RowBindingApi` pre-bound
+    to a Repeater/Builder field name, or `null` when no F.5 binding is
+    active (outside a collab room, pre-F.5 plugin, opted out via
+    `.collab(false)`, or non-array field).
+  - **`RowBindingApi`** — `{ add, remove, reorder, subscribe }`. Each
+    method's `arrayName` arg is pre-bound; `subscribe(fn)` returns an
+    unsubscribe function for `useEffect` cleanup.
+  - **`RowsEvent`** — `add | remove | move` discriminated union with
+    `rowId` + indices for the renderer to reconcile against its current
+    `rows` state.
+  - **`FormCollabBinding.addRow / removeRow / reorderRows / setRow /
+getRowTextBinding / subscribeRows`** — all optional. Bindings opt
+    into F.5 by implementing the trio `addRow + removeRow + reorderRows`;
+    `subscribeRows` and `setRow` layer on for remote-event + dotted-path
+    routing; `getRowTextBinding` is reserved for F.5c (per-row `Y.Text`).
+
+  ### `FormStateProvider` routing
+
+  - `setValue` and the live-resolve overlay both route through
+    `routeBindingWrite` — top-level names go to `binding.set`, row leaves
+    (matching `parseRowFieldPath`) go to `binding.setRow` when available.
+    Pre-F.5 row leaves continue to stay local-only.
+  - The provider walks `formMeta` for top-level Repeater/Builder field
+    names at binding mount and builds a per-array `RowBindingApi` map
+    exposed via `useRowBinding`.
+
+  ### Known v1 limitations (kept from the F.5 plan)
+
+  - Nested Repeaters (e.g. `articles.0.comments.0.body`) stay local-only
+    — `parseRowFieldPath` returns `null` and the binding never sees them.
+  - Server-derived row values now propagate through `setRow` when
+    available; without an F.5 binding they continue to be dropped.
+  - F.5c (`getRowTextBinding`) — character-level `Y.Text` per row text
+    field — lands in a follow-up; row leaves stay on row-level LWW until
+    then.
+
+- b70cb49: feat(pilotiq): F.5c — per-row Y.Text composition with F.6
+
+  Wires `useFieldState(dottedName).textBinding` to resolve through
+  `FormCollabBinding.getRowTextBinding(arrayName, rowId, fieldName)` so
+  Repeater/Builder row text fields ride character-level CRDT when the
+  plugin implements F.5c. Previously dotted-name `textBinding` always
+  returned `null`; now it returns a stable handle when:
+
+  - the row's `__id` is already stamped in the values map,
+  - the inner field's `fieldType` is in the F.6 allowlist
+    (`text / textarea / email / slug / markdown`),
+  - the field isn't opted out via `.collab(false)`,
+  - the active binding implements `getRowTextBinding`.
+
+  ### Walker
+
+  A new `collectRowTextLeavesByArray(formMeta)` helper walks each
+  Repeater's inner schema + each Builder block's template once at
+  binding mount and stashes the per-array text-leaf names on
+  `FormStateApi.rowTextLeaves`. Nested Repeater/Builder boundaries stop
+  the walk — 5-segment dotted paths remain out of scope.
+
+  ### Renderer surface unchanged
+
+  `BoundTextInput` already branches on `textBinding != null` from F.6,
+  so rows pick up the character-level path automatically once an F.5c-
+  capable binding is registered. No new renderer wiring beyond the
+  walker + `useFieldState` resolver.
+
+### Patch Changes
+
+- 08ab5bb: fix(pilotiq): F.5c row-text integration — stamp row `__id` and walk `template` not `children`
+
+  Two integration gaps in the just-shipped F.5c per-row Y.Text path made
+  character-level CRDT silently fall back to LWW for every Repeater /
+  Builder row text leaf. Both green-CI / broken-at-render bugs.
+
+  ### `collectRowTextLeavesByArray` walked the wrong meta key
+
+  The walker read `meta.children` for the Repeater's inner row schema,
+  but `RepeaterField.toMeta()` emits the row schema under `meta.template`
+  (`meta.children` is the per-resolved-row child list, not the field-
+  level template). Walker always returned empty → `FormStateApi.rowTextLeaves`
+  stayed `null` → `useFieldState(dottedName).textBinding` short-circuited
+  on every dotted row-leaf name. The unit-test fixture mirrored the same
+  wrong shape, so CI passed while the renderer was inert.
+
+  ### `RepeaterInput` / `BuilderInput` never stamped row `__id` in `ctx.values`
+
+  `resolveRowTextBinding` looks up `rowIdAtIndex(ctx.values, name, i)` which
+  reads `values['${name}.${i}.__id']`. The renderer maintained row identity
+  in local component state but never mirrored it into `ctx.values`, so the
+  lookup returned `null` and the binding chain never fired — even for
+  locally-added rows.
+
+  Both renderers now mirror `rows` into `ctx.values` via a single
+  `useEffect` keyed on the rows array. Pre-existing server-seeded rows
+  were unaffected because the seed wasn't a renderer concern; only
+  locally-added or remote-reconciled rows hit the gap.
+
+  ### Tests
+
+  `formStateHelpers.test.ts`'s hand-built `repeater()` helper now emits
+  `template:` instead of `children:` to match `RepeaterField.toMeta()`.
+  Catches future drift between meta producers and walkers.
+
 ## 0.10.0
 
 ### Minor Changes

package/dist/react/FormCollabBindingRegistry.d.ts

@@ -89,7 +89,137 @@ export interface FormCollabBinding {
     getTextBinding?(name: string): TextBinding | null;
     /** Cleanup hook called when the form unmounts. */
     destroy(): void;
+    /**
+     * Add a row to a Repeater or Builder field. `rowId` is the stable
+     * `__id` the renderer already mints (UUID for new rows / DB PK for
+     * relationship-backed rows) — the binding indexes the row's CRDT
+     * surface by this id so concurrent inserts from peers both survive.
+     *
+     * Idempotent — calling with a `rowId` that already exists in the
+     * Repeater's array is a no-op. `initial` may carry pre-filled values
+     * for the new row (e.g. the inner fields' `default()` from schema
+     * resolution); the binding seeds them onto the row's storage under
+     * the same idempotent posture as top-level `set` (first writer wins
+     * across concurrent first-mounters).
+     *
+     * Renderer call sites: `RepeaterInput.addRow()` + `BuilderInput.addBlock()`.
+     * When absent, F.5 row-level CRDT degrades to v1 behaviour (whole-array
+     * LWW under the top-level Y.Map).
+     */
+    addRow?(arrayName: string, rowId: string, initial: Record<string, unknown>): void;
+    /**
+     * Remove a row from a Repeater/Builder field by stable id. Idempotent
+     * — a missing `rowId` is a no-op. Triggered by the renderer's row
+     * delete button.
+     */
+    removeRow?(arrayName: string, rowId: string): void;
+    /**
+     * Apply a new row order. `newOrder` is the full list of row ids in
+     * their final positions; the binding computes the minimal CRDT move
+     * sequence and applies it inside a single transaction (peers see one
+     * coalesced update, not N intermediate states).
+     *
+     * Called by drag-and-drop / up-down move handlers in
+     * `RepeaterInput` + `BuilderInput`.
+     */
+    reorderRows?(arrayName: string, newOrder: string[]): void;
+    /**
+     * Write a single field on a row. Replaces the dotted-path `set` for
+     * row leaves (`tags.0.label` → `setRow('tags', rowId, 'label', value)`).
+     *
+     * Binding routes by allowlist same as top-level `set`: text-shaped
+     * fields go through the row's `TextBinding` when a `Y.Text` exists
+     * (see `getRowTextBinding`); non-text fields land on the row's
+     * scalar field-map under LWW.
+     *
+     * `FormStateProvider` calls this on every local edit when both a
+     * dotted-path name is being written AND `setRow` is implemented;
+     * otherwise the v1 skip-on-dot path runs.
+     */
+    setRow?(arrayName: string, rowId: string, fieldName: string, value: unknown): void;
+    /**
+     * Per-row text-CRDT handle. Composes with F.6's `BoundTextInput`:
+     * the renderer asks for one of these when a row leaf is text-shaped
+     * AND not opted out via `.collab(false)`, then threads it through
+     * the existing `TextBinding` plumbing inside the row.
+     *
+     * Returns `null` for non-text fields, fields opted out via collab,
+     * rows not yet present in the binding's index (e.g. before
+     * `addRow` has propagated), or when the binding doesn't yet
+     * implement per-row text CRDT (deferred to F.5c).
+     */
+    getRowTextBinding?(arrayName: string, rowId: string, fieldName: string): TextBinding | null;
+    /**
+     * Subscribe to row-lifecycle events for a Repeater/Builder array.
+     * Fires on remote add / remove / move; the renderer reconciles its
+     * `rows` state by `__id`. Local mutations fire too — the renderer
+     * deduplicates by checking whether the event's `rowId` matches one
+     * it just dispatched itself (the binding's roundtrip + the
+     * renderer's optimistic update converge).
+     */
+    subscribeRows?(arrayName: string, fn: (event: RowsEvent) => void): () => void;
 }
+/**
+ * Phase F.5 — array-scoped imperative API exposed to Repeater / Builder
+ * renderers through `useRowBinding(arrayName)`. Each method's first arg
+ * (`arrayName`) is pre-bound by the hook so call sites read naturally.
+ *
+ * Returned by the hook only when the active binding implements all four
+ * F.5 row methods (`addRow + removeRow + reorderRows`); partial impls
+ * read as null so renderers can do a single existence check before
+ * proceeding. `setRow` is intentionally NOT exposed here — it's invoked
+ * implicitly via `FormStateProvider.setValue`'s dotted-path routing,
+ * so renderers never need to touch it directly.
+ */
+export interface RowBindingApi {
+    /** Register a new row in the array's CRDT surface. `initial` may
+     *  carry pre-seeded values (e.g. clone of a sibling); pass `{}` (or
+     *  omit) for empty rows. Idempotent under existing rowId. */
+    add(rowId: string, initial?: Record<string, unknown>): void;
+    /** Remove the row with the given id. Idempotent for unknown ids. */
+    remove(rowId: string): void;
+    /** Replace the array's row order. `newOrder` is the full list of row
+     *  ids in their post-reorder positions; the binding emits the minimal
+     *  CRDT move sequence in one transaction so peers observe a single
+     *  coalesced update. */
+    reorder(newOrder: string[]): void;
+    /** Subscribe to remote row-lifecycle events on this array. Returns
+     *  an unsubscribe fn the renderer's `useEffect` cleanup hangs on.
+     *  Local mutations may also surface here (Yjs observers fire on
+     *  local transactions); the renderer is expected to dedupe by
+     *  rowId presence in its current state. Optional on the underlying
+     *  contract — `null` when the binding lacks `subscribeRows`. */
+    subscribe(fn: (event: RowsEvent) => void): () => void;
+}
+/**
+ * Phase F.5 — row-lifecycle event surfaced through `subscribeRows`.
+ *
+ *   - `add`    — a new row was inserted at `index`. `values` carries
+ *                the row's seeded field values (mirrors `addRow.initial`).
+ *   - `remove` — a row was removed; `index` is its position at the
+ *                moment of removal.
+ *   - `move`   — a row shifted positions. `from` and `to` are 0-based
+ *                indices in the post-reorder layout (i.e. the row at
+ *                position `from` ended up at `to`).
+ *
+ * Pilotiq core stays Yjs-free — the binding impl in `@pilotiq-pro/collab`
+ * translates `Y.Array<Y.Map>` `observe` deltas into these events.
+ */
+export type RowsEvent = {
+    kind: 'add';
+    rowId: string;
+    index: number;
+    values: Record<string, unknown>;
+} | {
+    kind: 'remove';
+    rowId: string;
+    index: number;
+} | {
+    kind: 'move';
+    rowId: string;
+    from: number;
+    to: number;
+};
 export interface FormCollabBindingFactoryArgs {
     /** Active collab room — provides `ydoc`, `provider`, `user`. Opaque to pilotiq core. */
     room: CollabRoom;

package/dist/react/FormCollabBindingRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormCollabBindingRegistry.d.ts","sourceRoot":"","sources":["../../src/react/FormCollabBindingRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAExD;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAG,MAAM,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,IAAQ,MAAM,CAAA;IAClB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAA;IAClC,OAAO,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;IAC/C,OAAO,IAAK,IAAI,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,GAAG,IAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,uEAAuE;IACvE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;IACvC,oEAAoE;IACpE,SAAS,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;IACtE;;;;kEAI8D;IAC9D,cAAc,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAA;IACjD,kDAAkD;IAClD,OAAO,IAAO,IAAI,CAAA;CACnB;AAED,MAAM,WAAW,4BAA4B;IAC3C,wFAAwF;IACxF,IAAI,EAAK,UAAU,CAAA;IACnB;;;;;OAKG;IACH,MAAM,EAAG,MAAM,CAAA;IACf;;;;;;OAMG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC;;;;;;;;;OASG;IACH,QAAQ,EAAE,WAAW,CAAA;CACtB;AAED,MAAM,MAAM,wBAAwB,GAAG,CAAC,IAAI,EAAE,4BAA4B,KAAK,iBAAiB,CAAA;AAIhG;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAEjF;AAED,yDAAyD;AACzD,wBAAgB,oBAAoB,IAAI,wBAAwB,GAAG,IAAI,CAEtE"}
+{"version":3,"file":"FormCollabBindingRegistry.d.ts","sourceRoot":"","sources":["../../src/react/FormCollabBindingRegistry.ts"],"names":[],"mappings":"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"}

package/dist/react/FormCollabBindingRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"FormCollabBindingRegistry.js","sourceRoot":"","sources":["../../src/react/FormCollabBindingRegistry.ts"],"names":[],"mappings":"AAuHA,IAAI,QAAQ,GAAoC,IAAI,CAAA;AAEpD;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAiC;IACzE,QAAQ,GAAG,OAAO,CAAA;AACpB,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,oBAAoB;IAClC,OAAO,QAAQ,CAAA;AACjB,CAAC"}
+{"version":3,"file":"FormCollabBindingRegistry.js","sourceRoot":"","sources":["../../src/react/FormCollabBindingRegistry.ts"],"names":[],"mappings":"AAwPA,IAAI,QAAQ,GAAoC,IAAI,CAAA;AAEpD;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAiC;IACzE,QAAQ,GAAG,OAAO,CAAA;AACpB,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,oBAAoB;IAClC,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/react/FormStateContext.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
 import type { ElementMeta } from '../schema/Element.js';
-import { type TextBinding } from './FormCollabBindingRegistry.js';
+import { type RowBindingApi, type TextBinding } from './FormCollabBindingRegistry.js';
 export type FieldStatus = 'idle' | 'pending';
 export interface FormStateApi {
     values: Record<string, unknown>;
@@ -27,6 +27,29 @@ export interface FormStateApi {
      *  non-null answers, so a `Map.get()` hit means the binding has opted
      *  this field into the character-level path. */
     textBindings: ReadonlyMap<string, TextBinding> | null;
+    /** Phase F.5 — per-Repeater/Builder row-array bindings. `null` outside a
+     *  collab room or when the binding doesn't implement F.5 row methods.
+     *  Each entry's API methods are pre-bound to the array name so renderers
+     *  call `.add(rowId, initial)` rather than `binding.addRow(name, …)`. */
+    rowBindings: ReadonlyMap<string, RowBindingApi> | null;
+    /**
+     * Phase F.5c — per-array set of inner-field names that should route
+     * through `Y.Text` (character-level CRDT) instead of row-level Y.Map
+     * LWW. Built from a single meta walk at binding mount. Read by
+     * `useFieldState(dottedName).textBinding` to decide whether to call
+     * `getRowTextBinding`. Sparse — only arrays with at least one
+     * text-shaped row leaf appear; absence on a key means "no text leaves
+     * in this Repeater/Builder".
+     */
+    rowTextLeaves: ReadonlyMap<string, ReadonlySet<string>> | null;
+    /**
+     * Phase F.5c — resolve a per-row `TextBinding`. Pre-bound to the
+     * active F.5 binding so consumers don't reach for `bindingRef`
+     * directly. Returns `null` when no binding implements F.5c OR the
+     * row+field doesn't qualify (renderer caller should fall back to
+     * `defaultValue` like a non-collab form).
+     */
+    getRowTextBinding: ((arrayName: string, rowId: string, fieldName: string) => TextBinding | null) | null;
 }
 /** Hook for direct access to the form context. Returns `null` outside a
  *  `FormStateProvider` (e.g. an action modal, or a form without any live
@@ -70,6 +93,21 @@ export interface UseFieldStateResult {
      *  `applyDelta + observe`; null → today's whole-string LWW path. */
     textBinding: TextBinding | null;
 }
+/**
+ * Phase F.5 — return the row-array CRDT API for a Repeater/Builder field.
+ * Returns `null` when:
+ *
+ *   - No `FormStateProvider` is mounted (e.g. uncontrolled form path).
+ *   - No `<RecordCollabRoom>` is up-tree (no binding registered).
+ *   - The active binding doesn't implement F.5's row methods.
+ *   - The named field opted out via `.collab(false)` (skipped at meta walk).
+ *   - The named field isn't a Repeater/Builder.
+ *
+ * RepeaterInput + BuilderInput call this once per render and proceed
+ * with the v1 local-only behaviour when null. The returned API methods
+ * are pre-bound to the array name so consumers don't repeat it.
+ */
+export declare function useRowBinding(arrayName: string): RowBindingApi | null;
 /** Per-field accessor. Inside a `FormStateProvider` it returns the controlled
  *  value + setter + live trigger; outside, it returns sentinels and callers
  *  should fall back to `defaultValue` (uncontrolled inputs). */

package/dist/react/FormStateContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormStateContext.d.ts","sourceRoot":"","sources":["../../src/react/FormStateContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAQN,MAAM,OAAO,CAAA;AACd,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAWvD,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,gCAAgC,CAAA;AAEvC,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,CAAA;AAE5C,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACtC,QAAQ,EAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IACrD;;;;;;qEAMiE;IACjE,WAAW,EAAI,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;IAC9D,MAAM,EAAS,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IACvC;8EAC0E;IAC1E,WAAW,EAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,KAAK,IAAI,CAAA;IACzD,QAAQ,EAAO,WAAW,CAAA;IAC1B,QAAQ,EAAO,OAAO,CAAA;IACtB,WAAW,EAAI,CAAC,IAAI,EAAE,MAAM,KAAK,WAAW,CAAA;IAC5C;;;;;oDAKgD;IAChD,YAAY,EAAG,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,IAAI,CAAA;CACvD;AAID;;4DAE4D;AAC5D,wBAAgB,YAAY,IAAI,YAAY,GAAG,IAAI,CAElD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,uBAA4B,CAAA;AAetD,MAAM,WAAW,mBAAmB;IAClC;;;;;;oDAMgD;IAChD,UAAU,EAAG,OAAO,CAAA;IACpB,KAAK,EAAQ,OAAO,CAAA;IACpB,QAAQ,EAAK,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;IACjC;;;;mBAIe;IACf,WAAW,EAAE,CAAC,aAAa,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;IAC9C,qEAAqE;IACrE,OAAO,EAAM,OAAO,CAAA;IACpB,MAAM,EAAO,MAAM,EAAE,CAAA;IACrB;;;;;;;wEAOoE;IACpE,WAAW,EAAE,WAAW,GAAG,IAAI,CAAA;CAChC;AAED;;gEAEgE;AAChE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CA6B/D;AAWD,MAAM,WAAW,sBAAsB;IACrC;oDACgD;IAChD,WAAW,EAAI,WAAW,CAAA;IAC1B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IACvC,QAAQ,EAAO,KAAK,CAAC,SAAS,CAAA;IAC9B,+EAA+E;IAC/E,SAAS,CAAC,EAAK,OAAO,KAAK,CAAA;IAC3B;gFAC4E;IAC5E,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAA;IAC1C;;;;wDAIoD;IACpD,OAAO,CAAC,EAAO,KAAK,CAAC,SAAS,CAAC,eAAe,GAAG,IAAI,CAAC,CAAA;CACvD;AAED;;;uEAGuE;AACvE,wBAAgB,iBAAiB,CAAC,EAChC,WAAW,EACX,aAAa,EACb,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,OAAO,GACR,EAAE,sBAAsB,GAAG,KAAK,CAAC,YAAY,CAqW7C"}
+{"version":3,"file":"FormStateContext.d.ts","sourceRoot":"","sources":["../../src/react/FormStateContext.tsx"],"names":[],"mappings":"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"}

package/dist/react/FormStateContext.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, } from 'react';
-import { collectFieldDefaults, findFieldMeta, parseFormDataToNested, readNestedValue, writeNestedValue, } from './formStateHelpers.js';
+import { collectFieldDefaults, collectRowArrayFieldNames, collectRowTextLeavesByArray, findFieldMeta, parseFormDataToNested, parseRowFieldPath, readNestedValue, routeBindingWrite, rowIdAtIndex, writeNestedValue, } from './formStateHelpers.js';
 import { runJsHandler } from './fieldJsHandler.js';
 import { useToast } from './Toaster.js';
 import { useCollabRoom } from './CollabRoomContext.js';
@@ -21,16 +21,24 @@ export function useFormState() {
  */
 export const FormIdContext = createContext('');
 /**
- * Phase F2 — returns `true` iff the named field has explicitly opted out
- * of realtime collab via `Field.collab(false)`. Sparse meta — absent =
- * inherit the panel default (collab on). Walks the form meta tree the
- * same way `findFieldMeta` does; cheap because it only runs on the
- * per-write path (already a hot path, but every check is one map
- * lookup + one boolean compare).
+ * Phase F.5 — return the row-array CRDT API for a Repeater/Builder field.
+ * Returns `null` when:
+ *
+ *   - No `FormStateProvider` is mounted (e.g. uncontrolled form path).
+ *   - No `<RecordCollabRoom>` is up-tree (no binding registered).
+ *   - The active binding doesn't implement F.5's row methods.
+ *   - The named field opted out via `.collab(false)` (skipped at meta walk).
+ *   - The named field isn't a Repeater/Builder.
+ *
+ * RepeaterInput + BuilderInput call this once per render and proceed
+ * with the v1 local-only behaviour when null. The returned API methods
+ * are pre-bound to the array name so consumers don't repeat it.
  */
-function fieldOptsOutOfCollab(formMeta, name) {
-    const meta = findFieldMeta(formMeta, name);
-    return meta?.collab === false;
+export function useRowBinding(arrayName) {
+    const ctx = useContext(FormStateContext);
+    if (!ctx?.rowBindings)
+        return null;
+    return ctx.rowBindings.get(arrayName) ?? null;
 }
 /** Per-field accessor. Inside a `FormStateProvider` it returns the controlled
  *  value + setter + live trigger; outside, it returns sentinels and callers
@@ -58,13 +66,37 @@ export function useFieldState(name) {
         triggerLive: (valueOverride) => ctx.triggerLive(name, valueOverride),
         pending: ctx.fieldStatus(name) === 'pending',
         errors: ctx.errors[name] ?? [],
-        // Phase F.6 — dotted-path inner-Repeater rows skipped in v1 (deferred
-        // to F.5 alongside Y.Array row identity). Outside a collab room or
-        // for non-text fields, the stash returns null and the renderer falls
-        // back to today's whole-string LWW path.
-        textBinding: dotted ? null : (ctx.textBindings?.get(name) ?? null),
+        // Phase F.6 — top-level text fields resolve from the binding-mount
+        // text stash. Phase F.5c — dotted-path row leaves resolve through
+        // `getRowTextBinding` when the field is text-shaped AND the row's
+        // `__id` is already stamped in the values map. Outside a collab
+        // room, for non-text fields, or before `addRow` has settled the
+        // row's id, the lookup returns null and `BoundTextInput` falls
+        // back to today's uncontrolled-input path.
+        textBinding: dotted
+            ? resolveRowTextBinding(ctx, name)
+            : (ctx.textBindings?.get(name) ?? null),
     };
 }
+/**
+ * Phase F.5c — dotted-name `TextBinding` resolver. Returns `null`
+ * whenever any precondition fails so the caller's renderer can take a
+ * single branch on null vs non-null.
+ */
+function resolveRowTextBinding(ctx, dottedName) {
+    if (!ctx.rowTextLeaves || !ctx.getRowTextBinding)
+        return null;
+    const parsed = parseRowFieldPath(dottedName);
+    if (!parsed)
+        return null;
+    const set = ctx.rowTextLeaves.get(parsed.arrayName);
+    if (!set?.has(parsed.fieldName))
+        return null;
+    const rowId = rowIdAtIndex(ctx.values, parsed.arrayName, parsed.index);
+    if (!rowId)
+        return null;
+    return ctx.getRowTextBinding(parsed.arrayName, rowId, parsed.fieldName);
+}
 /** Provider component for the controlled form path. Holds the values map,
  *  the current form meta (replaced wholesale on live POST), and the
  *  per-field live trigger. Mounted by `FormRenderer` when the form has a
@@ -82,6 +114,15 @@ export function FormStateProvider({ initialMeta, initialErrors, children, fetchI
     // existing `setValuesState` overlay below already triggers one when the
     // room has pre-existing state.
     const [textBindings, setTextBindings] = useState(null);
+    // Phase F.5 — per-Repeater/Builder row-array stash. Same lifecycle as
+    // `textBindings`: populated on collab mount when the binding implements
+    // F.5 row methods, cleared on unmount.
+    const [rowBindings, setRowBindings] = useState(null);
+    // Phase F.5c — per-array set of text-shaped row leaves + a pre-bound
+    // resolver. Both populated at binding mount when the active binding
+    // implements `getRowTextBinding`; cleared on unmount.
+    const [rowTextLeaves, setRowTextLeaves] = useState(null);
+    const [getRowTextBinding, setGetRowTextBinding] = useState(null);
     const { notify } = useToast();
     // Track an incrementing in-flight id so out-of-order responses are dropped.
     // useRef (not useState) so React StrictMode dev double-invokes don't
@@ -157,6 +198,52 @@ export function FormStateProvider({ initialMeta, initialErrors, children, fetchI
             if (textStash.size > 0)
                 setTextBindings(textStash);
         }
+        // Phase F.5 — build a `RowBindingApi` per top-level Repeater/Builder
+        // field when the binding implements all three lifecycle methods. The
+        // walk reads from formMeta (structural — fields exist regardless of
+        // whether the form has any rows yet); the API is then pre-bound to
+        // the array name so `RepeaterInput` calls `rb.add(rowId, …)` rather
+        // than `binding.addRow(name, rowId, …)`. Partial F.5 impls (e.g. a
+        // binding that has addRow but not reorderRows) skip the stash — the
+        // contract says all three or nothing. F.5c's per-row text path is
+        // exposed separately via `getRowTextBinding` and stays optional.
+        if (binding.addRow && binding.removeRow && binding.reorderRows) {
+            const { addRow, removeRow, reorderRows, subscribeRows } = binding;
+            const arrayNames = collectRowArrayFieldNames(formMetaRef.current);
+            if (arrayNames.length > 0) {
+                const rowStash = new Map();
+                for (const arrayName of arrayNames) {
+                    rowStash.set(arrayName, {
+                        add: (rowId, initial = {}) => addRow.call(binding, arrayName, rowId, initial),
+                        remove: (rowId) => removeRow.call(binding, arrayName, rowId),
+                        reorder: (newOrder) => reorderRows.call(binding, arrayName, newOrder),
+                        // Partial F.5 impl: a binding may ship add/remove/reorder
+                        // without `subscribeRows` (e.g. tests). Substitute a no-op
+                        // subscription so renderer code stays uniform — the cleanup
+                        // fn is still called on unmount but no events ever arrive.
+                        subscribe: subscribeRows
+                            ? (fn) => subscribeRows.call(binding, arrayName, fn)
+                            : () => () => { },
+                    });
+                }
+                setRowBindings(rowStash);
+            }
+        }
+        // Phase F.5c — capture the per-array text-leaf allowlist + bind the
+        // row-text resolver to the active binding. `getRowTextBinding` may
+        // be absent on partial F.5 impls; we expose the resolver as null in
+        // that case so `useFieldState` short-circuits cleanly.
+        if (binding.getRowTextBinding) {
+            const leaves = collectRowTextLeavesByArray(formMetaRef.current);
+            if (leaves.size > 0) {
+                setRowTextLeaves(leaves);
+                const bound = binding.getRowTextBinding;
+                // useState's functional-updater overload would invoke the
+                // stored function during set; wrapping in a fresh closure keeps
+                // React's setState path from confusing it for an updater fn.
+                setGetRowTextBinding(() => (arrayName, rowId, fieldName) => bound.call(binding, arrayName, rowId, fieldName));
+            }
+        }
         // Subscribe to remote changes. Local writes ALSO trigger this
         // (Yjs observers fire on local transactions too) — the per-key
         // Object.is short-circuit below collapses them into no-op renders.
@@ -178,6 +265,9 @@ export function FormStateProvider({ initialMeta, initialErrors, children, fetchI
             binding.destroy();
             bindingRef.current = null;
             setTextBindings(null);
+            setRowBindings(null);
+            setRowTextLeaves(null);
+            setGetRowTextBinding(null);
         };
         // `valuesRef.current` is intentionally read once at mount — initial
         // values seed the binding; subsequent edits flow through `setValue`
@@ -239,14 +329,13 @@ export function FormStateProvider({ initialMeta, initialErrors, children, fetchI
                 return prev;
             return { ...prev, [name]: value };
         });
-        // Phase F2 — proxy the write through the collab binding when active
-        // AND the field hasn't opted out via `.collab(false)`. Dotted-path
-        // names (Repeater / Builder row leaves) stay local-only in v1; their
-        // syncing belongs to Phase F.5 (`Y.Array<Y.Map>` row identity).
-        const binding = bindingRef.current;
-        if (binding && !name.includes('.') && !fieldOptsOutOfCollab(formMetaRef.current, name)) {
-            binding.set(name, value);
-        }
+        // Phase F2 / F.5 — proxy the write through the collab binding when
+        // active AND the field hasn't opted out via `.collab(false)`. Top-level
+        // fields ride `binding.set`. Row leaves (dotted paths matching
+        // `parseRowFieldPath`) route through `binding.setRow` when the
+        // binding implements F.5 — otherwise stay local-only (same posture
+        // as pre-F.5).
+        routeBindingWrite(bindingRef.current, formMetaRef.current, valuesRef.current, name, value);
         // Fire the client-side JS hook synchronously after the state write.
         // Dotted-name fields don't go through here (their setter is a no-op
         // in `useFieldState`); they fire JS via `triggerLive` instead so we
@@ -317,18 +406,19 @@ export function FormStateProvider({ initialMeta, initialErrors, children, fetchI
                 const serverValues = data.form.values;
                 if (serverValues) {
                     setValuesState((prev) => ({ ...prev, ...serverValues }));
-                    // Phase F2 (Q2) — derived fields propagate to peers via the
-                    // collab binding so every client sees the auto-`slug` / etc.
-                    // without each peer roundtripping the server. Skip dotted-path
-                    // names + fields that opted out.
+                    // Phase F2 (Q2) / F.5 — derived fields propagate to peers via the
+                    // collab binding so every client sees the auto-`slug` / etc. without
+                    // each peer roundtripping the server. Row leaves route through
+                    // `setRow` when the binding implements F.5; top-level fields ride
+                    // `set`. The rowId lookup needs the freshest values — merge
+                    // `valuesRef.current` with the server overlay so a row-id stamped
+                    // by this very server-resolve response is visible to `rowIdAtIndex`.
                     const binding = bindingRef.current;
                     if (binding) {
+                        const lookupValues = { ...valuesRef.current, ...serverValues };
                         for (const [k, v] of Object.entries(serverValues)) {
-                            if (k.includes('.'))
-                                continue;
-                            if (fieldOptsOutOfCollab(data.form, k))
-                                continue;
-                            binding.set(k, v);
+                            // routeBindingWrite handles `.collab(false)` opt-out internally.
+                            routeBindingWrite(binding, data.form, lookupValues, k, v);
                         }
                     }
                 }
@@ -406,7 +496,10 @@ export function FormStateProvider({ initialMeta, initialErrors, children, fetchI
         inFlight,
         fieldStatus,
         textBindings,
-    }), [values, setValue, triggerLive, errors, applyErrors, formMeta, inFlight, fieldStatus, textBindings]);
+        rowBindings,
+        rowTextLeaves,
+        getRowTextBinding,
+    }), [values, setValue, triggerLive, errors, applyErrors, formMeta, inFlight, fieldStatus, textBindings, rowBindings, rowTextLeaves, getRowTextBinding]);
     return (_jsx(FormStateContext.Provider, { value: api, children: children }));
 }
 //# sourceMappingURL=FormStateContext.js.map