@pilotiq/pilotiq 0.6.1 → 0.7.0

package/dist/react/AppShell.d.ts

@@ -30,6 +30,11 @@ export interface AppShellProps {
          *  `panelInfo()` server-side. */
         renderHooks?: RenderHookMap;
         themeEditor?: boolean;
+        /** AI suggestion mode — absent means `'auto'` (the default). When
+         *  set to `'review'`, AI plugins read this and stage writes as
+         *  `PendingSuggestion`s for user approval instead of applying
+         *  immediately. Plan: `docs/plans/ai-review-mode.md`. */
+        aiSuggestionsMode?: 'auto' | 'review';
     };
     basePath: string;
     /** Pathname used to compute active-link state in the sidebar/topbar. */
@@ -52,7 +57,18 @@ export interface AppShellProps {
      * chrome simply doesn't mount.
      */
     rightPanelRegistry?: RightPanelRegistry;
+    /**
+     * Build-time layout-provider registry from the Vite plugin. Each entry
+     * is a React component that wraps the panel's layout tree at the
+     * root. Plugins register via `Pilotiq.layoutProvider(C)`; the Vite
+     * plugin harvests refs into this array. Empty `[]` is the no-op
+     * default — chrome renders without any extra wrapping.
+     */
+    layoutProviderRegistry?: ReadonlyArray<React.ComponentType<{
+        children: React.ReactNode;
+        basePath?: string;
+    }>>;
     children: React.ReactNode;
 }
-export declare function AppShell({ layout, notifications, componentRegistry, rightPanelRegistry, ...props }: AppShellProps): import("react/jsx-runtime").JSX.Element;
+export declare function AppShell({ layout, notifications, componentRegistry, rightPanelRegistry, layoutProviderRegistry, ...props }: AppShellProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
 //# 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,KAAmB,MAAM,OAAO,CAAA;AAKvC,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;AAKnE,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACxG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAGrD,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;;;yCAGiC;QACjC,WAAW,CAAC,EAAE,aAAa,CAAA;QAC3B,WAAW,CAAC,EAAE,OAAO,CAAA;KACtB,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,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED,wBAAgB,QAAQ,CAAC,EAAE,MAAkB,EAAE,aAAa,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,GAAG,KAAK,EAAE,EAAE,aAAa,2CAwD7H"}
+{"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;AAKnE,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACxG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAGrD,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;;;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,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,0EA0ErJ"}

package/dist/react/AppShell.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useState } from 'react';
+import { useEffect, useState } from 'react';
 import { SidebarLayout } from './layouts/SidebarLayout.js';
 import { TopbarLayout } from './layouts/TopbarLayout.js';
 import { ToasterProvider } from './Toaster.js';
@@ -10,10 +10,20 @@ import { RightSidebarProvider, useRightSidebarOptional } from './RightSidebarCon
 import { RightSidebar } from './RightSidebar.js';
 import { useIsMobile } from './hooks/use-mobile.js';
 import { RenderHookSlot } from './RenderHookSlot.js';
-export function AppShell({ layout = 'sidebar', notifications, componentRegistry, rightPanelRegistry, ...props }) {
+export function AppShell({ layout = 'sidebar', notifications, componentRegistry, rightPanelRegistry, layoutProviderRegistry, ...props }) {
     const Layout = layout === 'topbar' ? TopbarLayout : SidebarLayout;
     // exactOptionalPropertyTypes: only spread `initialNotifications` when set.
     const toasterProps = notifications ? { initialNotifications: notifications } : {};
+    // Stamp the panel-wide AI suggestion mode on a window global so the
+    // AI plugin's `update_form_state` client-tool handler can read it
+    // without context plumbing. Singleton flag — doesn't change between
+    // pages within the same panel. Plan: `docs/plans/ai-review-mode.md`.
+    const aiSuggestionsMode = props.panel.aiSuggestionsMode ?? 'auto';
+    useEffect(() => {
+        if (typeof window === 'undefined')
+            return;
+        window.__pilotiqAiSuggestionsMode = aiSuggestionsMode;
+    }, [aiSuggestionsMode]);
     // Plan #12 — palette open state lives at AppShell so the trigger pill
     // (rendered inside the layout's header) and the palette dialog both
     // observe the same flag via context.
@@ -28,7 +38,28 @@ export function AppShell({ layout = 'sidebar', notifications, componentRegistry,
     const hooks = props.panel.renderHooks;
     const rightSidebarMeta = props.panel.rightSidebar;
     const inner = (_jsx(ToasterProvider, { ...toasterProps, children: _jsxs(CommandPaletteProvider, { setOpen: setPaletteOpen, children: [_jsx(RenderHookSlot, { name: "panels::body.start", hooks: hooks }), _jsx(RightSidebarLayoutFrame, { children: _jsx(Layout, { ...props }) }), _jsx(RenderHookSlot, { name: "panels::body.end", hooks: hooks }), _jsx(CommandPalette, { ...paletteProps }), rightSidebarMeta && (_jsx(RightSidebar, { basePath: props.basePath, ...(props.currentPath !== undefined ? { currentPath: props.currentPath } : {}) }))] }) }));
-    return (_jsx(ComponentRegistryProvider, { value: componentRegistry, children: _jsx(RightPanelRegistryProvider, { value: rightPanelRegistry, children: rightSidebarMeta ? (_jsx(RightSidebarProvider, { meta: rightSidebarMeta, basePath: props.basePath, children: inner })) : (inner) }) }));
+    // Plugin-registered layout providers (e.g. AI chat queue, tenant
+    // theme switcher). Wraps in registration order: the FIRST registered
+    // 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;
+}
+/**
+ * Fold registered layout providers around `tree` from last to first so
+ * the first-registered provider ends up outermost in the React tree
+ * (closest to the layout root) — matches the registration-order
+ * intuition documented on `Pilotiq.layoutProvider`.
+ */
+function wrapInLayoutProviders(tree, registry, basePath) {
+    if (!registry || registry.length === 0)
+        return tree;
+    let acc = tree;
+    for (let i = registry.length - 1; i >= 0; i--) {
+        const Provider = registry[i];
+        acc = _jsx(Provider, { basePath: basePath, children: acc });
+    }
+    return acc;
 }
 /**
  * Padding shim that compresses host content when the right sidebar is

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/PendingSuggestionApplierRegistry.d.ts

@@ -0,0 +1,34 @@
+import type { PendingSuggestion } from './PendingSuggestionsContext.js';
+/**
+ * A function that applies a `PendingSuggestion` to its target field —
+ * registered by the field renderer (or editor adapter) on mount, looked
+ * up by aggregate consumers (e.g. a chat-sidebar pending-pill's
+ * "Approve all" button) that live outside the form's React tree.
+ *
+ * The applier is responsible for the apply *only*. Dismissing the
+ * suggestion from the queue is the caller's job — the apply path is
+ * decoupled from the queue-side bookkeeping so a future Phase that
+ * mirrors approvals to a server can do both via different code paths.
+ */
+export type PendingSuggestionApplier = (suggestion: PendingSuggestion) => void;
+/**
+ * Register an applier for `(formId, fieldName)`. Returns an unregister
+ * function for `useEffect` cleanup. Re-registering with the same key
+ * replaces the previous entry — the most recently mounted renderer
+ * wins (typical in multi-instance form scenarios where an old form
+ * unmounts after a new one mounts during navigation).
+ */
+export declare function registerPendingSuggestionApplier(formId: string | undefined, fieldName: string, apply: PendingSuggestionApplier): () => void;
+/**
+ * Look up an applier for `(formId, fieldName)`. Tries the form-scoped
+ * key first; falls back to the wildcard form ('*') so a producer that
+ * pushed a suggestion without `formId` still resolves an applier from
+ * a single-form page.
+ */
+export declare function getPendingSuggestionApplier(formId: string | undefined, fieldName: string): PendingSuggestionApplier | undefined;
+/**
+ * Test seam — clear the registry between tests. Not part of the public
+ * API.
+ */
+export declare function _clearAppliersForTests(): void;
+//# sourceMappingURL=PendingSuggestionApplierRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PendingSuggestionApplierRegistry.d.ts","sourceRoot":"","sources":["../../src/react/PendingSuggestionApplierRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAEvE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,UAAU,EAAE,iBAAiB,KAAK,IAAI,CAAA;AAoB9E;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAK,MAAM,GAAG,SAAS,EAC7B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAM,wBAAwB,GAClC,MAAM,IAAI,CASZ;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAK,MAAM,GAAG,SAAS,EAC7B,SAAS,EAAE,MAAM,GAChB,wBAAwB,GAAG,SAAS,CAOtC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/react/PendingSuggestionApplierRegistry.js

@@ -0,0 +1,51 @@
+const _entries = new Map();
+/**
+ * Compose the registry key. `formId` defaults to `'*'` (global form
+ * scope) so renderers in non-multi-form pages don't have to thread an
+ * id. Form-scoped registrations always win over the wildcard when both
+ * exist for the same field name.
+ */
+function keyFor(formId, fieldName) {
+    return `${formId ?? '*'}::${fieldName}`;
+}
+/**
+ * Register an applier for `(formId, fieldName)`. Returns an unregister
+ * function for `useEffect` cleanup. Re-registering with the same key
+ * replaces the previous entry — the most recently mounted renderer
+ * wins (typical in multi-instance form scenarios where an old form
+ * unmounts after a new one mounts during navigation).
+ */
+export function registerPendingSuggestionApplier(formId, fieldName, apply) {
+    const key = keyFor(formId, fieldName);
+    const entry = { formId, fieldName, apply };
+    _entries.set(key, entry);
+    return () => {
+        // Only delete if this entry is still the one we registered — a
+        // re-register from another instance may have replaced us.
+        if (_entries.get(key) === entry)
+            _entries.delete(key);
+    };
+}
+/**
+ * Look up an applier for `(formId, fieldName)`. Tries the form-scoped
+ * key first; falls back to the wildcard form ('*') so a producer that
+ * pushed a suggestion without `formId` still resolves an applier from
+ * a single-form page.
+ */
+export function getPendingSuggestionApplier(formId, fieldName) {
+    if (formId !== undefined) {
+        const scoped = _entries.get(keyFor(formId, fieldName));
+        if (scoped)
+            return scoped.apply;
+    }
+    const wild = _entries.get(keyFor(undefined, fieldName));
+    return wild?.apply;
+}
+/**
+ * Test seam — clear the registry between tests. Not part of the public
+ * API.
+ */
+export function _clearAppliersForTests() {
+    _entries.clear();
+}
+//# sourceMappingURL=PendingSuggestionApplierRegistry.js.map

package/dist/react/PendingSuggestionApplierRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PendingSuggestionApplierRegistry.js","sourceRoot":"","sources":["../../src/react/PendingSuggestionApplierRegistry.ts"],"names":[],"mappings":"AAqBA,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAA;AAEjD;;;;;GAKG;AACH,SAAS,MAAM,CAAC,MAA0B,EAAE,SAAiB;IAC3D,OAAO,GAAG,MAAM,IAAI,GAAG,KAAK,SAAS,EAAE,CAAA;AACzC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gCAAgC,CAC9C,MAA6B,EAC7B,SAAiB,EACjB,KAAmC;IAEnC,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACrC,MAAM,KAAK,GAAkB,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAA;IACzD,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IACxB,OAAO,GAAG,EAAE;QACV,+DAA+D;QAC/D,0DAA0D;QAC1D,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK;YAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACvD,CAAC,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,MAA6B,EAC7B,SAAiB;IAEjB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAA;QACtD,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC,KAAK,CAAA;IACjC,CAAC;IACD,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAA;IACvD,OAAO,IAAI,EAAE,KAAK,CAAA;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB;IACpC,QAAQ,CAAC,KAAK,EAAE,CAAA;AAClB,CAAC"}

package/dist/react/PendingSuggestionOverlayRegistry.d.ts

@@ -0,0 +1,46 @@
+import type { ComponentType } from 'react';
+import type { PendingSuggestion } from './PendingSuggestionsContext.js';
+import type { ElementMeta } from '../schema/Element.js';
+/**
+ * Props the per-field overlay component receives from `FieldShell` when
+ * one or more pending suggestions target the field.
+ *
+ * The overlay is responsible for both rendering AND applying the
+ * suggestion. On Approve, call `onApprove()` (which dismisses the
+ * suggestion from the queue) AFTER mutating the form's field value to
+ * `suggestion.suggestedValue` — the queue is just a notification surface,
+ * applying is the renderer's job.
+ *
+ * The Tiptap `RichTextField` renderer skips this slot entirely — it
+ * mirrors suggestions into the editor's inline AiSuggestion extension
+ * instead. Other field types (Text / Textarea / Select / Number / …)
+ * render the registered overlay below their input.
+ */
+export interface PendingSuggestionOverlayProps {
+    /** First suggestion targeting this field. Aggregate UIs handle stacks. */
+    suggestion: PendingSuggestion;
+    /** Drop from queue (callable after applying). */
+    onApprove: () => void;
+    /** Drop from queue without applying. */
+    onReject: () => void;
+    /** Field type string (`text` / `select` / `toggle` / `slider` / `color` /
+     *  …) so per-fieldType overlay renderers can branch. Sparse — older
+     *  hosts may omit. Phase C of ai-review-mode. */
+    fieldType?: string;
+    /** Resolved field meta — gives the overlay access to per-field config
+     *  (`options` for Select, `min/max` for Slider, etc.) needed to render
+     *  human-friendly comparisons rather than raw values. Sparse — older
+     *  hosts may omit. */
+    el?: ElementMeta;
+}
+/**
+ * Register a component to render below any `FieldShell` whose field has at
+ * least one matching pending suggestion in the
+ * `<PendingSuggestionsContext>` queue. Called once at boot by a plugin
+ * (e.g. `@pilotiq-pro/ai`). No-op when no plugin registers — `FieldShell`
+ * skips the overlay slot.
+ */
+export declare function registerPendingSuggestionOverlay(C: ComponentType<PendingSuggestionOverlayProps>): void;
+/** Returns the registered overlay component, or `null`. */
+export declare function getPendingSuggestionOverlay(): ComponentType<PendingSuggestionOverlayProps> | null;
+//# sourceMappingURL=PendingSuggestionOverlayRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PendingSuggestionOverlayRegistry.d.ts","sourceRoot":"","sources":["../../src/react/PendingSuggestionOverlayRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAC1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAEvD;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,6BAA6B;IAC5C,0EAA0E;IAC1E,UAAU,EAAE,iBAAiB,CAAA;IAC7B,iDAAiD;IACjD,SAAS,EAAG,MAAM,IAAI,CAAA;IACtB,wCAAwC;IACxC,QAAQ,EAAI,MAAM,IAAI,CAAA;IACtB;;qDAEiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;0BAGsB;IACtB,EAAE,CAAC,EAAS,WAAW,CAAA;CACxB;AAID;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAAC,CAAC,EAAE,aAAa,CAAC,6BAA6B,CAAC,GAAG,IAAI,CAEtG;AAED,2DAA2D;AAC3D,wBAAgB,2BAA2B,IAAI,aAAa,CAAC,6BAA6B,CAAC,GAAG,IAAI,CAEjG"}

package/dist/react/PendingSuggestionOverlayRegistry.js

@@ -0,0 +1,16 @@
+let _component = null;
+/**
+ * Register a component to render below any `FieldShell` whose field has at
+ * least one matching pending suggestion in the
+ * `<PendingSuggestionsContext>` queue. Called once at boot by a plugin
+ * (e.g. `@pilotiq-pro/ai`). No-op when no plugin registers — `FieldShell`
+ * skips the overlay slot.
+ */
+export function registerPendingSuggestionOverlay(C) {
+    _component = C;
+}
+/** Returns the registered overlay component, or `null`. */
+export function getPendingSuggestionOverlay() {
+    return _component;
+}
+//# sourceMappingURL=PendingSuggestionOverlayRegistry.js.map

package/dist/react/PendingSuggestionOverlayRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PendingSuggestionOverlayRegistry.js","sourceRoot":"","sources":["../../src/react/PendingSuggestionOverlayRegistry.ts"],"names":[],"mappings":"AAqCA,IAAI,UAAU,GAAwD,IAAI,CAAA;AAE1E;;;;;;GAMG;AACH,MAAM,UAAU,gCAAgC,CAAC,CAA+C;IAC9F,UAAU,GAAG,CAAC,CAAA;AAChB,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,2BAA2B;IACzC,OAAO,UAAU,CAAA;AACnB,CAAC"}

package/dist/react/PendingSuggestionsContext.d.ts

@@ -0,0 +1,153 @@
+import React from 'react';
+/**
+ * One AI- (or extension-) sourced suggested field-value change. Sits in a
+ * unified queue read by:
+ *
+ *   - the Tiptap `RichTextField` renderer — for `richtext` fields, the
+ *     suggestion is mirrored into the editor's `AiSuggestion` extension as
+ *     an inline diff with per-hunk Approve/Reject chips
+ *   - `FieldShell`'s overlay slot — for any other field type, a registered
+ *     overlay component renders a `currentValue` vs `suggestedValue` diff
+ *     card below the input
+ *   - aggregate "Pending suggestions" pills (e.g. in a chat sidebar) — read
+ *     the full list to show counts + bulk approve / reject affordances
+ *
+ * The shape is intentionally generic — the `meta` bag carries field-type-
+ * specific extras (e.g. `editorRange: { from, to }` for `richtext`).
+ *
+ * Pilotiq core does NOT push or apply suggestions itself. The provider
+ * implementation + push paths live in plugin packages (e.g.
+ * `@pilotiq-pro/ai`); core just owns the type, context, and hooks so any
+ * field renderer can subscribe through one open-core seam.
+ */
+/**
+ * Where a suggestion came from. Lets aggregate consumers (pill UIs)
+ * filter the shared queue by surface — e.g. a popover-chat scoped pill
+ * shows only suggestions produced by its own session, while the
+ * sidebar pill shows everything. Sparse on push; consumers treat
+ * absence as "unknown origin, include in unfiltered views".
+ */
+export interface PendingSuggestionOrigin {
+    /**
+     * Which UI surface initiated the agent run that produced this
+     * suggestion. `'field-action'` covers the `✦` per-field dropdown.
+     */
+    surface: 'sidebar' | 'popover' | 'field-action';
+    /**
+     * Stable id of the agent run / chat turn that produced this
+     * suggestion. Popover pills filter on this so they only see their
+     * own session's output even when the panel-wide queue holds many.
+     */
+    runId?: string;
+    /** Slug of the agent whose tool call produced the suggestion. */
+    agentSlug?: string;
+}
+export interface PendingSuggestion {
+    /** Stable id; the producer is responsible for uniqueness. */
+    id: string;
+    /** Field name this suggestion targets. Matched verbatim in the renderer. */
+    fieldName: string;
+    /**
+     * Form scope. Multi-form pages (Plan #5 reactive fields) stamp the form's
+     * id here so a renderer in form A doesn't pick up a suggestion meant for
+     * form B. Optional — when both producer and consumer omit it, suggestions
+     * are global.
+     */
+    formId?: string;
+    /** Snapshot of the field's value at the time the suggestion was produced. */
+    currentValue: unknown;
+    /** Proposed replacement. */
+    suggestedValue: unknown;
+    /** Optional attribution surfaced on the diff overlay / inline chip. */
+    source?: {
+        agentSlug?: string;
+        agentLabel?: string;
+    };
+    /**
+     * Provenance hint for cross-surface filtering. Sparse — pushed when
+     * the producer knows which agent run / chat surface it's running
+     * inside (e.g. the popover-chat tagging its turn id so its scoped
+     * pill can filter the shared queue). Aggregate consumers that don't
+     * care just leave the field unread.
+     */
+    origin?: PendingSuggestionOrigin;
+    /** Wallclock ms when produced. Producers fill this in on `push`. */
+    createdAt: number;
+    /** Field-type-specific extras (e.g. `editorRange: { from, to }`). Sparse. */
+    meta?: Record<string, unknown>;
+}
+export interface PendingSuggestionsApi {
+    /** Full list across every field + form. Aggregate consumers read this. */
+    list: readonly PendingSuggestion[];
+    /** Add a suggestion to the queue. Returns the (possibly producer-supplied) id. */
+    push: (suggestion: Omit<PendingSuggestion, 'createdAt'> & {
+        createdAt?: number;
+    }) => string;
+    /**
+     * Drop the suggestion from the queue. Used by both inline approval
+     * paths (where the renderer applies directly and just notifies the
+     * queue) AND by Reject. For aggregate consumers (e.g. a chat-pill
+     * "Approve all" button) that live outside the form's React tree, see
+     * `approve` below — it looks up a registered applier and calls it
+     * before dismissing.
+     */
+    dismiss: (id: string) => void;
+    /**
+     * Apply + dismiss. Resolves the suggestion's `(formId, fieldName)`
+     * pair against `PendingSuggestionApplierRegistry`; if an applier is
+     * registered (FieldShell + Tiptap bridge auto-register on mount),
+     * runs it and then dismisses. If no applier is registered (or the
+     * applier throws), falls through to a plain `dismiss` so the queue
+     * still clears — never strands an entry.
+     *
+     * Use this from cross-tree surfaces (chat-sidebar pending-pill).
+     * Inline surfaces (FieldShell overlay, Tiptap chip) apply via their
+     * own React-tree-local mutators and call `dismiss` directly.
+     */
+    approve: (id: string) => void;
+    /**
+     * Drop every suggestion matching the optional filter. With no filter,
+     * empties the entire queue.
+     */
+    dismissAll: (filter?: {
+        fieldName?: string;
+        formId?: string;
+    }) => void;
+    /**
+     * Apply + dismiss every suggestion matching the optional filter.
+     * Calls `approve(id)` per entry — same fall-through semantics if an
+     * applier is missing or throws.
+     */
+    approveAll: (filter?: {
+        fieldName?: string;
+        formId?: string;
+    }) => void;
+}
+/**
+ * Context default is a no-op API — fields that subscribe in trees without a
+ * real provider mounted (e.g. the marketing site's preview, headless tests)
+ * see an empty list and no-op approval methods. Never throws.
+ */
+export declare const PendingSuggestionsContext: React.Context<PendingSuggestionsApi>;
+/** Read the full queue + producer methods. Used by aggregate UIs. */
+export declare function usePendingSuggestions(): PendingSuggestionsApi;
+/**
+ * Subscribe a single field-renderer to its slice of the queue. Returns
+ * `list` already filtered + a `dismiss` callback that the renderer wires
+ * to its Approve / Reject buttons.
+ *
+ * Matching rules:
+ *   - `s.fieldName === fieldName` (verbatim)
+ *   - if both `formId` args are non-`undefined`, they must match; otherwise
+ *     the entry passes (so global suggestions reach scoped readers and
+ *     vice-versa)
+ *
+ * The list reference is stable across renders unless the underlying
+ * filtered slice actually changes — useful for `useEffect` dependencies
+ * in renderers that mirror suggestions into their own state.
+ */
+export declare function usePendingSuggestionsForField(fieldName: string, formId?: string): {
+    list: readonly PendingSuggestion[];
+    dismiss: (id: string) => void;
+};
+//# sourceMappingURL=PendingSuggestionsContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PendingSuggestionsContext.d.ts","sourceRoot":"","sources":["../../src/react/PendingSuggestionsContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6C,MAAM,OAAO,CAAA;AAEjE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,OAAO,EAAK,SAAS,GAAG,SAAS,GAAG,cAAc,CAAA;IAClD;;;;OAIG;IACH,KAAK,CAAC,EAAM,MAAM,CAAA;IAClB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,EAAE,EAAe,MAAM,CAAA;IACvB,4EAA4E;IAC5E,SAAS,EAAQ,MAAM,CAAA;IACvB;;;;;OAKG;IACH,MAAM,CAAC,EAAU,MAAM,CAAA;IACvB,6EAA6E;IAC7E,YAAY,EAAK,OAAO,CAAA;IACxB,4BAA4B;IAC5B,cAAc,EAAG,OAAO,CAAA;IACxB,uEAAuE;IACvE,MAAM,CAAC,EAAE;QACP,SAAS,CAAC,EAAG,MAAM,CAAA;QACnB,UAAU,CAAC,EAAE,MAAM,CAAA;KACpB,CAAA;IACD;;;;;;OAMG;IACH,MAAM,CAAC,EAAU,uBAAuB,CAAA;IACxC,oEAAoE;IACpE,SAAS,EAAQ,MAAM,CAAA;IACvB,6EAA6E;IAC7E,IAAI,CAAC,EAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACzC;AAED,MAAM,WAAW,qBAAqB;IACpC,0EAA0E;IAC1E,IAAI,EAAS,SAAS,iBAAiB,EAAE,CAAA;IACzC,kFAAkF;IAClF,IAAI,EAAS,CAAC,UAAU,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAA;IAClG;;;;;;;OAOG;IACH,OAAO,EAAM,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC;;;;;;;;;;;OAWG;IACH,OAAO,EAAM,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC;;;OAGG;IACH,UAAU,EAAG,CAAC,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IACvE;;;;OAIG;IACH,UAAU,EAAG,CAAC,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;CACxE;AAWD;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,sCAAiD,CAAA;AAEvF,qEAAqE;AACrE,wBAAgB,qBAAqB,IAAI,qBAAqB,CAE7D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAI,MAAM,GAChB;IACD,IAAI,EAAK,SAAS,iBAAiB,EAAE,CAAA;IACrC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9B,CAQA"}

package/dist/react/PendingSuggestionsContext.js

@@ -0,0 +1,46 @@
+import { createContext, useContext, useMemo } from 'react';
+const NOOP_API = Object.freeze({
+    list: Object.freeze([]),
+    push: () => '',
+    dismiss: () => { },
+    approve: () => { },
+    dismissAll: () => { },
+    approveAll: () => { },
+});
+/**
+ * Context default is a no-op API — fields that subscribe in trees without a
+ * real provider mounted (e.g. the marketing site's preview, headless tests)
+ * see an empty list and no-op approval methods. Never throws.
+ */
+export const PendingSuggestionsContext = createContext(NOOP_API);
+/** Read the full queue + producer methods. Used by aggregate UIs. */
+export function usePendingSuggestions() {
+    return useContext(PendingSuggestionsContext);
+}
+/**
+ * Subscribe a single field-renderer to its slice of the queue. Returns
+ * `list` already filtered + a `dismiss` callback that the renderer wires
+ * to its Approve / Reject buttons.
+ *
+ * Matching rules:
+ *   - `s.fieldName === fieldName` (verbatim)
+ *   - if both `formId` args are non-`undefined`, they must match; otherwise
+ *     the entry passes (so global suggestions reach scoped readers and
+ *     vice-versa)
+ *
+ * The list reference is stable across renders unless the underlying
+ * filtered slice actually changes — useful for `useEffect` dependencies
+ * in renderers that mirror suggestions into their own state.
+ */
+export function usePendingSuggestionsForField(fieldName, formId) {
+    const api = useContext(PendingSuggestionsContext);
+    const list = useMemo(() => api.list.filter(s => {
+        if (s.fieldName !== fieldName)
+            return false;
+        if (formId === undefined || s.formId === undefined)
+            return true;
+        return s.formId === formId;
+    }), [api.list, fieldName, formId]);
+    return { list, dismiss: api.dismiss };
+}
+//# sourceMappingURL=PendingSuggestionsContext.js.map

package/dist/react/PendingSuggestionsContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PendingSuggestionsContext.js","sourceRoot":"","sources":["../../src/react/PendingSuggestionsContext.tsx"],"names":[],"mappings":"AAAA,OAAc,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAyHjE,MAAM,QAAQ,GAA0B,MAAM,CAAC,MAAM,CAAC;IACpD,IAAI,EAAQ,MAAM,CAAC,MAAM,CAAC,EAAE,CAAiC;IAC7D,IAAI,EAAQ,GAAG,EAAE,CAAC,EAAE;IACpB,OAAO,EAAK,GAAG,EAAE,GAAE,CAAC;IACpB,OAAO,EAAK,GAAG,EAAE,GAAE,CAAC;IACpB,UAAU,EAAE,GAAG,EAAE,GAAE,CAAC;IACpB,UAAU,EAAE,GAAG,EAAE,GAAE,CAAC;CACrB,CAAC,CAAA;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,aAAa,CAAwB,QAAQ,CAAC,CAAA;AAEvF,qEAAqE;AACrE,MAAM,UAAU,qBAAqB;IACnC,OAAO,UAAU,CAAC,yBAAyB,CAAC,CAAA;AAC9C,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,6BAA6B,CAC3C,SAAiB,EACjB,MAAiB;IAKjB,MAAM,GAAG,GAAG,UAAU,CAAC,yBAAyB,CAAC,CAAA;IACjD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QAC7C,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS;YAAE,OAAO,KAAK,CAAA;QAC3C,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,IAAI,CAAA;QAC/D,OAAO,CAAC,CAAC,MAAM,KAAK,MAAM,CAAA;IAC5B,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAA;IAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAA;AACvC,CAAC"}

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;AA6HvD;;;;;;;;;;;;;;;;;;;;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;AAunFD;;;;;;;;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;AA41FD,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;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"}