@pilotiq/pilotiq 0.10.0 → 0.12.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.12.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.12.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,133 @@
 # @pilotiq/pilotiq
 
+## 0.12.0
+
+### Minor Changes
+
+- Add `CurrentUserContext` exported from `@pilotiq/pilotiq/react` so plugins can read the active user (driven by `Pilotiq.user(req => …)`) without prop-drilling through `panel`. `AppShell` mounts the provider around the layout-provider chain seeded from `panel.userMenu?.user`; plugins call `useCurrentUser()` from inside any layout provider or descendant component.
+
+  Also fixes collab text field chrome: the single-line `TextLikeInput.tsx` chrome now uses `overflow-x-clip` instead of `overflow-x-auto` so `CollaborationCaret` user-name labels can escape the input upward (CSS spec: `auto` on either axis forces the other axis to non-visible too; `clip` is the one non-visible value that allows the orthogonal axis to remain `visible`). Trade-off: long text gets clipped on the right rather than horizontally scrollable inside a collab field — acceptable for plain-text fields where the presence label is the higher-value affordance.
+
+## 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/AppShell.d.ts

@@ -83,5 +83,5 @@ export interface AppShellProps {
     componentSlotRegistry?: ComponentSlotRegistry;
     children: React.ReactNode;
 }
-export declare function AppShell({ layout, notifications, componentRegistry, rightPanelRegistry, layoutProviderRegistry, ...props }: AppShellProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+export declare function AppShell({ layout, notifications, componentRegistry, rightPanelRegistry, layoutProviderRegistry, ...props }: AppShellProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=AppShell.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AppShell.d.ts","sourceRoot":"","sources":["../../src/react/AppShell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAA;AAKlD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAE1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAInE,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAEhF,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACxG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAErD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAEjE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAA;QACZ,QAAQ,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;QAC3C,oEAAoE;QACpE,UAAU,CAAC,EAAE,OAAO,EAAE,CAAA;QACtB;sEAC8D;QAC9D,QAAQ,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;QAC9B;;qEAE6D;QAC7D,qBAAqB,CAAC,EAAE,yBAAyB,CAAA;QACjD;;yEAEiE;QACjE,YAAY,CAAC,EAAE,gBAAgB,CAAA;QAC/B;;wEAEgE;QAChE,YAAY,CAAC,EAAE,eAAe,CAAA;QAC9B;;;yCAGiC;QACjC,WAAW,CAAC,EAAE,aAAa,CAAA;QAC3B,WAAW,CAAC,EAAE,OAAO,CAAA;QACrB;;;iEAGyD;QACzD,iBAAiB,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;KACtC,CAAA;IACD,QAAQ,EAAE,MAAM,CAAA;IAChB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAA;IAC7B;8CAC0C;IAC1C,aAAa,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAClC;;;;wCAIoC;IACpC,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IACvC;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC;QAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;IAC7G;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,qBAAqB,CAAA;IAC7C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED,wBAAgB,QAAQ,CAAC,EAAE,MAAkB,EAAE,aAAa,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,0EA4FrJ"}
+{"version":3,"file":"AppShell.d.ts","sourceRoot":"","sources":["../../src/react/AppShell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAA;AAKlD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAE1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAInE,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAEhF,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACxG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAErD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAGjE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAA;QACZ,QAAQ,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;QAC3C,oEAAoE;QACpE,UAAU,CAAC,EAAE,OAAO,EAAE,CAAA;QACtB;sEAC8D;QAC9D,QAAQ,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;QAC9B;;qEAE6D;QAC7D,qBAAqB,CAAC,EAAE,yBAAyB,CAAA;QACjD;;yEAEiE;QACjE,YAAY,CAAC,EAAE,gBAAgB,CAAA;QAC/B;;wEAEgE;QAChE,YAAY,CAAC,EAAE,eAAe,CAAA;QAC9B;;;yCAGiC;QACjC,WAAW,CAAC,EAAE,aAAa,CAAA;QAC3B,WAAW,CAAC,EAAE,OAAO,CAAA;QACrB;;;iEAGyD;QACzD,iBAAiB,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;KACtC,CAAA;IACD,QAAQ,EAAE,MAAM,CAAA;IAChB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAA;IAC7B;8CAC0C;IAC1C,aAAa,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAClC;;;;wCAIoC;IACpC,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IACvC;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC;QAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;IAC7G;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,qBAAqB,CAAA;IAC7C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED,wBAAgB,QAAQ,CAAC,EAAE,MAAkB,EAAE,aAAa,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,2CAqGrJ"}

package/dist/react/AppShell.js

@@ -11,6 +11,7 @@ import { RightSidebar } from './RightSidebar.js';
 import { RecordWrapperGate } from './RecordWrapperGate.js';
 import { useIsMobile } from './hooks/use-mobile.js';
 import { RenderHookSlot } from './RenderHookSlot.js';
+import { CurrentUserProvider } from './CurrentUserContext.js';
 export function AppShell({ layout = 'sidebar', notifications, componentRegistry, rightPanelRegistry, layoutProviderRegistry, ...props }) {
     const Layout = layout === 'topbar' ? TopbarLayout : SidebarLayout;
     // exactOptionalPropertyTypes: only spread `initialNotifications` when set.
@@ -53,7 +54,12 @@ export function AppShell({ layout = 'sidebar', notifications, componentRegistry,
     // provider sits OUTERMOST (closest to the layout root); LAST sits
     // INNERMOST (closest to the page tree). Empty / unset → no wrap.
     const wrapped = wrapInLayoutProviders(_jsx(ComponentRegistryProvider, { value: componentRegistry, children: _jsx(RightPanelRegistryProvider, { value: rightPanelRegistry, children: rightSidebarMeta ? (_jsx(RightSidebarProvider, { meta: rightSidebarMeta, basePath: props.basePath, children: inner })) : (inner) }) }), layoutProviderRegistry, props.basePath);
-    return wrapped;
+    // `CurrentUserProvider` sits OUTSIDE the layout-provider chain so
+    // plugin-registered providers (e.g. `@pilotiq-pro/collab`'s
+    // CollabProvider, which threads the user into CollaborationCaret
+    // presence labels) can read the active user via `useCurrentUser()`.
+    // Value source mirrors what the top-right user dropdown renders.
+    return (_jsx(CurrentUserProvider, { value: props.panel.userMenu?.user ?? null, children: wrapped }));
 }
 /**
  * Fold registered layout providers around `tree` from last to first so

package/dist/react/AppShell.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppShell.js","sourceRoot":"","sources":["../../src/react/AppShell.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"AppShell.js","sourceRoot":"","sources":["../../src/react/AppShell.tsx"],"names":[],"mappings":"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"}

package/dist/react/CollabTextRendererRegistry.d.ts

@@ -0,0 +1,75 @@
+import type { ComponentType } from 'react';
+/**
+ * Module-level registry slot for the collab-aware plain-text editor renderer.
+ *
+ * Wiring posture (mirrors `CollabExtensionFactoryRegistry` /
+ * `FormCollabBindingRegistry`):
+ *   - `@pilotiq/tiptap`'s `registerTiptap(...)` calls `registerCollabTextRenderer(...)`
+ *     once at boot. The registered component closes over `@tiptap/*` imports so
+ *     pilotiq core stays free of any tiptap peer dep — same posture as the
+ *     existing rich-text renderer registry.
+ *   - `TextLikeInput` checks for the registered component when a `<RecordCollabRoom>`
+ *     is mounted up-tree AND the field hasn't opted out via `.collab(false)` AND
+ *     the field has no `.mask()`. If present, the legacy `BoundTextInput`
+ *     (Y.Text + `computeDelta` + heuristic `preserveCursor`) is bypassed in
+ *     favour of a y-prosemirror-backed Tiptap editor that anchors selections to
+ *     `Yjs.RelativePosition` — the architectural fix for the cursor-jump and
+ *     two-peer concurrent-insert races documented in
+ *     `docs/plans/text-fields-tiptap-backed-collab.md`.
+ *
+ * Wire props are deliberately framework-agnostic — the renderer doesn't take a
+ * `binding` since it consumes the room's `ydoc` directly via the existing
+ * `useCollabRoom()` + `getCollabExtensions()` plumbing on its own side. Core
+ * keeps the seam narrow: handler callbacks + DOM chrome only.
+ */
+export interface CollabTextRendererProps {
+    /** Field name — drives the `Y.XmlFragment` selector inside the collab adapter. */
+    name: string;
+    /** `true` for textarea-like (multiple paragraphs); `false` for input-like. */
+    multiline: boolean;
+    /**
+     * Server-rendered default value. The renderer is expected to seed the
+     * `Y.XmlFragment` from this on first connect when the room has no
+     * persisted state for this field (i.e. brand-new record).
+     */
+    defaultValue: string;
+    /** Optional placeholder hint. */
+    placeholder?: string;
+    /** Disabled / read-only state. */
+    disabled?: boolean;
+    /** Fired on every editor `update` with the editor's current plain text. */
+    onChange: (text: string) => void;
+    /** Fired on editor blur — host wires this to live-onBlur trigger semantics. */
+    onBlur: () => void;
+    /**
+     * Single-line submit — fired when `multiline: false` AND the user presses
+     * Enter. The renderer is expected to blur the editor after invoking this.
+     * Multiline mode ignores it (Enter inserts a paragraph instead).
+     */
+    onSubmit?: () => void;
+    /**
+     * Tailwind className applied to the editor's contenteditable wrapper so the
+     * rendered editor matches the native `<input>` / `<textarea>` chrome it
+     * replaces. The host owns the styling — the adapter just forwards.
+     */
+    className?: string;
+    /**
+     * Additional DOM attributes for the editor's contenteditable wrapper —
+     * typically `id`, `aria-*`, `autocomplete`, etc.
+     */
+    editorAttributes?: Record<string, string>;
+}
+export type CollabTextRenderer = ComponentType<CollabTextRendererProps>;
+/**
+ * Register the collab plain-text editor component. Called once at boot by
+ * `@pilotiq/tiptap`'s `registerTiptap()` (or directly by an app that imports
+ * the renderer). Calling with `null` clears the registry — useful for tests.
+ *
+ * No-op behaviour when no renderer is registered: `TextLikeInput` falls back
+ * to the legacy `BoundTextInput` path (or the plain controlled / uncontrolled
+ * input when no collab room is mounted).
+ */
+export declare function registerCollabTextRenderer(component: CollabTextRenderer | null): void;
+/** Returns the registered component, or `null` when no adapter is installed. */
+export declare function getCollabTextRenderer(): CollabTextRenderer | null;
+//# sourceMappingURL=CollabTextRendererRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CollabTextRendererRegistry.d.ts","sourceRoot":"","sources":["../../src/react/CollabTextRendererRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAE1C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,uBAAuB;IACtC,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAA;IACZ,8EAA8E;IAC9E,SAAS,EAAE,OAAO,CAAA;IAClB;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAA;IACpB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,2EAA2E;IAC3E,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,+EAA+E;IAC/E,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC1C;AAED,MAAM,MAAM,kBAAkB,GAAG,aAAa,CAAC,uBAAuB,CAAC,CAAA;AAIvE;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,kBAAkB,GAAG,IAAI,GAAG,IAAI,CAErF;AAED,gFAAgF;AAChF,wBAAgB,qBAAqB,IAAI,kBAAkB,GAAG,IAAI,CAEjE"}

package/dist/react/CollabTextRendererRegistry.js

@@ -0,0 +1,18 @@
+let _renderer = null;
+/**
+ * Register the collab plain-text editor component. Called once at boot by
+ * `@pilotiq/tiptap`'s `registerTiptap()` (or directly by an app that imports
+ * the renderer). Calling with `null` clears the registry — useful for tests.
+ *
+ * No-op behaviour when no renderer is registered: `TextLikeInput` falls back
+ * to the legacy `BoundTextInput` path (or the plain controlled / uncontrolled
+ * input when no collab room is mounted).
+ */
+export function registerCollabTextRenderer(component) {
+    _renderer = component;
+}
+/** Returns the registered component, or `null` when no adapter is installed. */
+export function getCollabTextRenderer() {
+    return _renderer;
+}
+//# sourceMappingURL=CollabTextRendererRegistry.js.map

package/dist/react/CollabTextRendererRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CollabTextRendererRegistry.js","sourceRoot":"","sources":["../../src/react/CollabTextRendererRegistry.ts"],"names":[],"mappings":"AAiEA,IAAI,SAAS,GAA8B,IAAI,CAAA;AAE/C;;;;;;;;GAQG;AACH,MAAM,UAAU,0BAA0B,CAAC,SAAoC;IAC7E,SAAS,GAAG,SAAS,CAAA;AACvB,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,qBAAqB;IACnC,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/dist/react/CurrentUserContext.d.ts

@@ -0,0 +1,39 @@
+import { type ReactNode } from 'react';
+/**
+ * Resolved identity of the user driving the current page. Mirrors the
+ * `UserMenuMeta.user` shape that `panelInfo()` ships to the renderer —
+ * whichever fields the `Pilotiq.user(req => …)` resolver populated.
+ *
+ * `null` is the no-user state: either the panel never wired a resolver,
+ * or the resolver returned `null` for this request. Consumers should
+ * gracefully fall back (no avatar, no presence label, etc.) rather than
+ * treating absence as an error.
+ */
+export interface CurrentUser {
+    name?: string;
+    email?: string;
+    avatar?: string;
+}
+/**
+ * Mounted by `AppShell` around the layout-provider chain so plugins
+ * (collab user presence, audit-trail attribution, analytics
+ * client-side opt-outs, …) can read the active user via
+ * `useCurrentUser()` without prop-drilling through `panel`.
+ *
+ * Value source is `viewProps.panel.userMenu?.user` — the same shape the
+ * top-right dropdown renders. The provider sits OUTSIDE
+ * `layoutProviderRegistry` so plugin-registered layout providers can
+ * subscribe.
+ */
+export declare function CurrentUserProvider({ value, children, }: {
+    value: CurrentUser | null;
+    children: ReactNode;
+}): ReactNode;
+/**
+ * Read the active user inside any descendant of `<AppShell>`. Returns
+ * `null` outside an `AppShell` mount (defensive — keeps storybook /
+ * isolated-render tests from throwing) and when no user resolved for
+ * the request.
+ */
+export declare function useCurrentUser(): CurrentUser | null;
+//# sourceMappingURL=CurrentUserContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CurrentUserContext.d.ts","sourceRoot":"","sources":["../../src/react/CurrentUserContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAEjE;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAI,MAAM,CAAA;IACf,KAAK,CAAC,EAAG,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,WAAW,GAAG,IAAI,CAAA;IACzB,QAAQ,EAAE,SAAS,CAAA;CACpB,GAAG,SAAS,CAEZ;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,WAAW,GAAG,IAAI,CAEnD"}

package/dist/react/CurrentUserContext.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from 'react';
+const CurrentUserContext = createContext(null);
+/**
+ * Mounted by `AppShell` around the layout-provider chain so plugins
+ * (collab user presence, audit-trail attribution, analytics
+ * client-side opt-outs, …) can read the active user via
+ * `useCurrentUser()` without prop-drilling through `panel`.
+ *
+ * Value source is `viewProps.panel.userMenu?.user` — the same shape the
+ * top-right dropdown renders. The provider sits OUTSIDE
+ * `layoutProviderRegistry` so plugin-registered layout providers can
+ * subscribe.
+ */
+export function CurrentUserProvider({ value, children, }) {
+    return _jsx(CurrentUserContext.Provider, { value: value, children: children });
+}
+/**
+ * Read the active user inside any descendant of `<AppShell>`. Returns
+ * `null` outside an `AppShell` mount (defensive — keeps storybook /
+ * isolated-render tests from throwing) and when no user resolved for
+ * the request.
+ */
+export function useCurrentUser() {
+    return useContext(CurrentUserContext);
+}
+//# sourceMappingURL=CurrentUserContext.js.map

package/dist/react/CurrentUserContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CurrentUserContext.js","sourceRoot":"","sources":["../../src/react/CurrentUserContext.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAA;AAkBjE,MAAM,kBAAkB,GAAG,aAAa,CAAqB,IAAI,CAAC,CAAA;AAElE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAClC,KAAK,EACL,QAAQ,GAIT;IACC,OAAO,KAAC,kBAAkB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAA+B,CAAA;AAC5F,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,UAAU,CAAC,kBAAkB,CAAC,CAAA;AACvC,CAAC"}

package/dist/react/FormCollabBindingRegistry.d.ts

@@ -62,11 +62,18 @@ export interface TextBinding {
  *   - `subscribe(fn)` registers a listener that fires when REMOTE
  *     changes land; `fn(snapshot)` receives the full updated map.
  *     The provider re-applies this snapshot onto its React state.
- *   - `getTextBinding(name)` (Phase F.6) returns a `Y.Text`-backed
- *     handle for text-shaped fields, or `null` for non-text fields and
- *     text fields opted out via `.collab(false)`. The text/non-text
- *     allowlist lives in the binding impl — `FormStateProvider` asks
- *     for every field and routes per-field on the answer.
+ *   - `getTextBinding(name)` (Phase F.6) was the per-field `Y.Text`
+ *     handle for character-level CRDT on top-level text inputs. After
+ *     the Tiptap-backed text-collab swap (Phase D, 2026-05), bindings
+ *     are expected to return `null` for every top-level field —
+ *     character-level CRDT now lives in the Tiptap renderer's
+ *     `Collaboration` extension (`Y.XmlFragment` per field). Returning
+ *     a non-null `TextBinding` here is still supported for legacy
+ *     bindings, but the active `@pilotiq-pro/collab` impl no longer
+ *     allocates `Y.Text` for top-level fields. Row-text leaves under
+ *     Repeater / Builder continue to route through Y.Text via
+ *     `getRowTextBinding` — the Tiptap-backed renderer only handles
+ *     top-level (non-dotted-path) field names today.
  *   - `destroy()` is called on unmount — gives the plugin a chance to
  *     remove its CRDT observer. Implementations are expected to cascade
  *     into every `TextBinding` they issued.
@@ -81,15 +88,150 @@ export interface FormCollabBinding {
     set(name: string, value: unknown): void;
     /** Subscribe to remote changes. Returns an unsubscribe function. */
     subscribe(fn: (snapshot: Record<string, unknown>) => void): () => void;
-    /** Phase F.6 — per-field text-CRDT handle. Returns `null` for non-text
-     *  fields or text fields opted out via `.collab(false)`. Optional so
-     *  existing F1-era plugins keep type-checking without a no-op stub;
-     *  when absent, every text field stays on today's whole-string LWW
-     *  path (i.e. F.6 character-level CRDT is opt-in by impl). */
+    /** Phase F.6 / Phase D — per-field text-CRDT handle. Post Phase D,
+     *  `@pilotiq-pro/collab` returns `null` for every top-level text
+     *  field (character-level CRDT moved into `@pilotiq/tiptap`'s
+     *  `CollabTextRenderer`, which mounts its own `Y.XmlFragment` per
+     *  field via the `Collaboration` extension). The method is preserved
+     *  on the contract for legacy bindings and for the row-text leaves
+     *  routed through `getRowTextBinding` (under Repeater / Builder).
+     *  Optional so existing F1-era plugins keep type-checking without a
+     *  no-op stub; absent reads as "binding has no top-level text CRDT
+     *  surface," same as returning `null` for every field. */
     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;
@@ -110,13 +252,15 @@ export interface FormCollabBindingFactoryArgs {
     initial: Record<string, unknown>;
     /**
      * Phase F.6 — initial form meta from the server. The binding walks
-     * this once at construction to decide which fields are text-shaped
-     * (`fieldType ∈ { text, textarea, email, slug, markdown }`) and
-     * which have opted out via `.collab(false)`. Text fields get a
-     * dedicated `Y.Text` and route through `getTextBinding`; non-text
-     * fields stay on the `Y.Map`. The meta is captured at mount; later
-     * structural changes from `live()` re-resolves aren't re-walked
-     * (rare in practice — dynamic field add/remove is an F-followup).
+     * this once at construction to index Repeater / Builder array names
+     * for row-level CRDT and to identify which row leaves are text-shaped
+     * (`fieldType ∈ { text, textarea, email, slug, markdown }` and not
+     * `.collab(false)`). Post Phase D, top-level text fields no longer
+     * need to be partitioned here — their character-level CRDT lives in
+     * the Tiptap renderer's `Y.XmlFragment`, not in a binding-allocated
+     * `Y.Text`. The meta is captured at mount; later structural changes
+     * from `live()` re-resolves aren't re-walked (rare in practice —
+     * dynamic field add/remove is an F-followup).
      */
     formMeta: ElementMeta;
 }

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":"AAsQA,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"}