@pilotiq/pilotiq 0.7.1 → 0.8.0

package/dist/react/FormCollabBindingRegistry.d.ts

@@ -0,0 +1,62 @@
+import type { CollabRoom } from './CollabRoomContext.js';
+/**
+ * Binding contract that a collab plugin returns from
+ * `registerFormCollabBinding` — wraps a single form's value map in a
+ * shared CRDT type (typically a `Y.Map` on the surrounding record's
+ * `Y.Doc`) so every field on the form syncs across clients.
+ *
+ * Pilotiq's `FormStateProvider` calls into this contract when a
+ * `<RecordCollabRoom>` is mounted up-tree:
+ *
+ *   - `get()` is read once on mount to overlay any already-synced
+ *     state on top of the form's SSR-rendered defaults.
+ *   - `set(name, v)` is called from `setValue` after the local React
+ *     state update — every controlled field's edit lands in the CRDT.
+ *   - `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.
+ *   - `destroy()` is called on unmount — gives the plugin a chance to
+ *     remove its CRDT observer.
+ *
+ * `unknown` payloads keep pilotiq core Yjs-free; the binding owns its
+ * own type knowledge. Same posture as `CollabExtensionFactory`.
+ */
+export interface FormCollabBinding {
+    /** Snapshot of the current synced values. Called once on mount. */
+    get(): Record<string, unknown>;
+    /** Write the local edit to the CRDT. Triggers a broadcast to peers. */
+    set(name: string, value: unknown): void;
+    /** Subscribe to remote changes. Returns an unsubscribe function. */
+    subscribe(fn: (snapshot: Record<string, unknown>) => void): () => void;
+    /** Cleanup hook called when the form unmounts. */
+    destroy(): void;
+}
+export interface FormCollabBindingFactoryArgs {
+    /** Active collab room — provides `ydoc`, `provider`, `user`. Opaque to pilotiq core. */
+    room: CollabRoom;
+    /**
+     * Form identifier — used by the binding to partition CRDT state when
+     * multiple forms render against the same room (e.g. a record page that
+     * shows a primary form plus a side-mounted action form). Most pages
+     * only have one form, so most bindings use this as the `Y.Map` name.
+     */
+    formId: string;
+    /**
+     * Initial values from pilotiq's normal SSR resolution. The binding
+     * uses these to perform the idempotent "first-load seed" (`!ymap.has(k)`
+     * gated write) so the first client to open a record populates the
+     * Y.Map with the DB-derived defaults; subsequent clients find the
+     * map already populated and skip.
+     */
+    initial: Record<string, unknown>;
+}
+export type FormCollabBindingFactory = (args: FormCollabBindingFactoryArgs) => FormCollabBinding;
+/**
+ * Register the form-level CRDT binding factory. Called once at boot by
+ * `@pilotiq-pro/collab`'s plugin. No-op when no plugin registers —
+ * `FormStateProvider` falls back to its plain local-state path.
+ */
+export declare function registerFormCollabBinding(factory: FormCollabBindingFactory): void;
+/** Returns the registered binding factory, or `null`. */
+export declare function getFormCollabBinding(): FormCollabBindingFactory | null;
+//# sourceMappingURL=FormCollabBindingRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FormCollabBindingRegistry.d.ts","sourceRoot":"","sources":["../../src/react/FormCollabBindingRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAExD;;;;;;;;;;;;;;;;;;;;;GAqBG;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,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;CACjC;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"}

package/dist/react/FormCollabBindingRegistry.js

@@ -0,0 +1,14 @@
+let _factory = null;
+/**
+ * Register the form-level CRDT binding factory. Called once at boot by
+ * `@pilotiq-pro/collab`'s plugin. No-op when no plugin registers —
+ * `FormStateProvider` falls back to its plain local-state path.
+ */
+export function registerFormCollabBinding(factory) {
+    _factory = factory;
+}
+/** Returns the registered binding factory, or `null`. */
+export function getFormCollabBinding() {
+    return _factory;
+}
+//# sourceMappingURL=FormCollabBindingRegistry.js.map

package/dist/react/FormCollabBindingRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormCollabBindingRegistry.js","sourceRoot":"","sources":["../../src/react/FormCollabBindingRegistry.ts"],"names":[],"mappings":"AAyDA,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/RecordWrapperGate.d.ts

@@ -0,0 +1,25 @@
+import { type ReactNode } from 'react';
+export interface RecordWrapperGateProps {
+    currentPath?: string;
+    basePath: string;
+    children: ReactNode;
+}
+/**
+ * Conditionally wraps the page tree with the plugin-registered
+ * `RecordWrapper` when the current URL resolves to a record-bound edit
+ * page. Pass-through in every other case:
+ *
+ *   - no plugin registered a wrapper (`getRecordWrapper() === null`)
+ *   - the URL isn't a record-edit URL (list / create / view / dashboard / …)
+ *   - `currentPath` not yet known on the very first SSR render
+ *
+ * Mounted once inside `AppShell` around the page content area so
+ * record-scoped plugins (collab room, audit trail, …) get one
+ * lifetimed mount per record-view-or-edit without each plugin having
+ * to thread URL parsing into its own provider.
+ *
+ * Scope limited to `/edit` URLs in v1; view-page support (read-only
+ * collab cursors on `ViewPage`) is a follow-up.
+ */
+export declare function RecordWrapperGate({ currentPath, basePath, children }: RecordWrapperGateProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=RecordWrapperGate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RecordWrapperGate.d.ts","sourceRoot":"","sources":["../../src/react/RecordWrapperGate.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAM,MAAM,CAAA;IACpB,QAAQ,EAAM,SAAS,CAAA;CACxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,sBAAsB,2CAY5F"}

package/dist/react/RecordWrapperGate.js

@@ -0,0 +1,30 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { getRecordWrapper } from './RecordWrapperRegistry.js';
+import { parseRecordEditUrl } from './parseRecordEditUrl.js';
+/**
+ * Conditionally wraps the page tree with the plugin-registered
+ * `RecordWrapper` when the current URL resolves to a record-bound edit
+ * page. Pass-through in every other case:
+ *
+ *   - no plugin registered a wrapper (`getRecordWrapper() === null`)
+ *   - the URL isn't a record-edit URL (list / create / view / dashboard / …)
+ *   - `currentPath` not yet known on the very first SSR render
+ *
+ * Mounted once inside `AppShell` around the page content area so
+ * record-scoped plugins (collab room, audit trail, …) get one
+ * lifetimed mount per record-view-or-edit without each plugin having
+ * to thread URL parsing into its own provider.
+ *
+ * Scope limited to `/edit` URLs in v1; view-page support (read-only
+ * collab cursors on `ViewPage`) is a follow-up.
+ */
+export function RecordWrapperGate({ currentPath, basePath, children }) {
+    const Wrapper = getRecordWrapper();
+    if (!Wrapper || !currentPath)
+        return _jsx(_Fragment, { children: children });
+    const identity = parseRecordEditUrl(currentPath, basePath);
+    if (!identity)
+        return _jsx(_Fragment, { children: children });
+    return (_jsx(Wrapper, { resourceSlug: identity.resourceSlug, recordId: identity.recordId, children: children }));
+}
+//# sourceMappingURL=RecordWrapperGate.js.map

package/dist/react/RecordWrapperGate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecordWrapperGate.js","sourceRoot":"","sources":["../../src/react/RecordWrapperGate.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAQ5D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAA0B;IAC3F,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAA;IAClC,IAAI,CAAC,OAAO,IAAI,CAAC,WAAW;QAAE,OAAO,4BAAG,QAAQ,GAAI,CAAA;IAEpD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;IAC1D,IAAI,CAAC,QAAQ;QAAE,OAAO,4BAAG,QAAQ,GAAI,CAAA;IAErC,OAAO,CACL,KAAC,OAAO,IAAC,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,YACtE,QAAQ,GACD,CACX,CAAA;AACH,CAAC"}

package/dist/react/RecordWrapperRegistry.d.ts

@@ -0,0 +1,31 @@
+import type { ComponentType, ReactNode } from 'react';
+/**
+ * Props the page-record wrapper receives from `RecordWrapperGate` when
+ * the current URL resolves to a record-bound edit page (`${base}/.../:id/edit`).
+ *
+ * The wrapper is responsible for whatever record-scoped context the
+ * plugin owns — `@pilotiq-pro/collab` mounts a `<RecordCollabRoom>`
+ * here so every collab field inside the page shares one Y.Doc + WS
+ * connection. Other plugins could mount per-record presence, audit
+ * logging, or anything else that's record-bound rather than panel-bound.
+ *
+ * `resourceSlug` is the slash-joined slug-path (cluster-prefixed for
+ * clustered resources, parent-prefixed for nested-relation edits) so
+ * two URLs that target different records always produce distinct
+ * wrapper keys / room names.
+ */
+export interface RecordWrapperProps {
+    resourceSlug: string;
+    recordId: string;
+    children: ReactNode;
+}
+/**
+ * Register a component that wraps the page tree on every record-edit
+ * route. Called once at boot by a plugin (e.g. `@pilotiq-pro/collab`).
+ * No-op when no plugin registers — `RecordWrapperGate` passes through
+ * unchanged.
+ */
+export declare function registerRecordWrapper(C: ComponentType<RecordWrapperProps>): void;
+/** Returns the registered wrapper component, or `null`. */
+export declare function getRecordWrapper(): ComponentType<RecordWrapperProps> | null;
+//# sourceMappingURL=RecordWrapperRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RecordWrapperRegistry.d.ts","sourceRoot":"","sources":["../../src/react/RecordWrapperRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAErD;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAM,MAAM,CAAA;IACpB,QAAQ,EAAM,SAAS,CAAA;CACxB;AAID;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,aAAa,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAEhF;AAED,2DAA2D;AAC3D,wBAAgB,gBAAgB,IAAI,aAAa,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAE3E"}

package/dist/react/RecordWrapperRegistry.js

@@ -0,0 +1,15 @@
+let _component = null;
+/**
+ * Register a component that wraps the page tree on every record-edit
+ * route. Called once at boot by a plugin (e.g. `@pilotiq-pro/collab`).
+ * No-op when no plugin registers — `RecordWrapperGate` passes through
+ * unchanged.
+ */
+export function registerRecordWrapper(C) {
+    _component = C;
+}
+/** Returns the registered wrapper component, or `null`. */
+export function getRecordWrapper() {
+    return _component;
+}
+//# sourceMappingURL=RecordWrapperRegistry.js.map

package/dist/react/RecordWrapperRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecordWrapperRegistry.js","sourceRoot":"","sources":["../../src/react/RecordWrapperRegistry.ts"],"names":[],"mappings":"AAuBA,IAAI,UAAU,GAA6C,IAAI,CAAA;AAE/D;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,CAAoC;IACxE,UAAU,GAAG,CAAC,CAAA;AAChB,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,gBAAgB;IAC9B,OAAO,UAAU,CAAA;AACnB,CAAC"}

package/dist/react/SchemaRenderer.d.ts

@@ -1,5 +1,12 @@
 import React from 'react';
 import type { ElementMeta } from '../schema/Element.js';
+import { dispatchHandlerAction as actionDispatchHandlerAction } from './schemaRenderer/action/helpers.js';
+/**
+ * Re-export `dispatchHandlerAction` from the action helpers so existing
+ * consumers (e.g. `RepeaterInput.tsx`) keep working through this barrel.
+ * Phase 4 may shift these imports onto the action subpath directly.
+ */
+export declare const dispatchHandlerAction: typeof actionDispatchHandlerAction;
 /**
  * Render a flat list of resolved field-meta as standalone form inputs,
  * outside any pilotiq Form wrapper. Useful for embedding the schema
@@ -26,32 +33,20 @@ export interface FormFieldsProps {
     values?: Record<string, unknown>;
 }
 export declare function FormFields({ elements, values }: FormFieldsProps): React.ReactElement;
-import type { NotificationMeta } from '../notifications/Notification.js';
-type Notify = (n: NotificationMeta | Omit<NotificationMeta, 'id'>) => void;
-type Navigate = (url: string) => void;
-/**
- * Fetch + JSON dispatch for handler-style actions (no schema, no modal,
- * just a button). Sends `ids[]` plus arbitrary `values` fields. Server
- * returns `{ ok, redirect, notifications }` (or `{ ok: false, error }` on
- * failure). On success: drain notifications, SPA-navigate; on failure:
- * surface the error as a toast. No full page reload in any case.
- */
-export declare function dispatchHandlerAction(url: string, ids: string[], navigate: Navigate, notify: Notify, values?: Record<string, string>, formSnapshot?: FormData): Promise<void>;
-/**
- * Render one child of a form's resolved schema with per-field values + errors.
- *
- * Exported so sibling renderers (e.g. `SelectFieldInput`'s inline-create
- * modal) can render a sub-schema with the same FieldShell + error-stamping
- * conventions as the parent form. Public surface beyond the file boundary
- * stays narrow — callers should pass `child.type === 'field'` elements;
- * non-field elements fall through to `renderElement`.
- */
+/** Re-export the form-layer `renderFormChild` with `renderElement`
+ *  pre-bound, so external consumers (e.g. `SelectFieldInput.tsx`) keep
+ *  importing it from `SchemaRenderer.js` with the same four-arg signature.
+ *  Internal callers (action layer dialogs, ActionGroupTrigger) get the
+ *  same closure through prop injection. */
 export declare function renderFormChild(child: ElementMeta, index: number, values: Record<string, unknown>, errors: Record<string, string[]>): React.ReactNode;
 export interface SchemaRendererProps {
+    /** Resolved schema elements (server-side `resolveSchema` output) that
+     * the renderer walks recursively. */
     elements: ElementMeta[];
     /**
-     * Plan #15 — per-widget initial payload map keyed by element id.
-     * Auto-gen page stubs pass `vp._widgetData` here so widget renderers
+     * Initial widget data — a record keyed by widget id whose values are
+     * stamped onto the SSR pass by `tagWidgetUrls` + `resolveServerDataElements`.
+     * Surfaces through `<WidgetDataProvider>` so per-widget components
      * can read their first-paint payload through `useInitialWidgetData`.
      * Optional — pages with no widgets ship `undefined` and the provider
      * is a no-op.
@@ -59,5 +54,4 @@ export interface SchemaRendererProps {
     widgetData?: Record<string, unknown>;
 }
 export declare function SchemaRenderer({ elements, widgetData }: SchemaRendererProps): import("react/jsx-runtime").JSX.Element | null;
-export {};
 //# sourceMappingURL=SchemaRenderer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SchemaRenderer.d.ts","sourceRoot":"","sources":["../../src/react/SchemaRenderer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AA8HvD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAG,WAAW,EAAE,CAAA;IACxB,MAAM,CAAC,EAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,eAAe,GAAG,KAAK,CAAC,YAAY,CAapF;AAieD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AAExE,KAAK,MAAM,GAAM,CAAC,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,KAAK,IAAI,CAAA;AAC7E,KAAK,QAAQ,GAAI,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;AAkDtC;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAO,MAAM,EAChB,GAAG,EAAO,MAAM,EAAE,EAClB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAI,MAAM,EAChB,MAAM,GAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACrC,YAAY,CAAC,EAAE,QAAQ,GACtB,OAAO,CAAC,IAAI,CAAC,CAoCf;AAqvFD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAC/B,KAAK,CAAC,SAAS,CAejB;AAsnGD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC;AAED,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,mBAAmB,kDAW3E"}
+{"version":3,"file":"SchemaRenderer.d.ts","sourceRoot":"","sources":["../../src/react/SchemaRenderer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsC,MAAM,OAAO,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAoCvD,OAAO,EACL,qBAAqB,IAAI,2BAA2B,EACrD,MAAM,oCAAoC,CAAA;AAa3C;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,oCAA8B,CAAA;AAEhE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAG,WAAW,EAAE,CAAA;IACxB,MAAM,CAAC,EAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,eAAe,GAAG,KAAK,CAAC,YAAY,CAapF;AA2BD;;;;2CAI2C;AAC3C,wBAAgB,eAAe,CAC7B,KAAK,EAAG,WAAW,EACnB,KAAK,EAAG,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAC/B,KAAK,CAAC,SAAS,CAEjB;AAiYD,MAAM,WAAW,mBAAmB;IAClC;yCACqC;IACrC,QAAQ,EAAI,WAAW,EAAE,CAAA;IACzB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC;AAED,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,mBAAmB,kDAW3E"}