@fayz-ai/admin 0.14.0 → 0.16.0

package/dist/components/right-rail.d.ts

@@ -7,6 +7,18 @@ export interface RightRailPanelDef {
     icon?: React.ComponentType<{
         className?: string;
     }>;
+    /** The icon is already a mark of its own (a portrait) — render it bare
+     *  instead of inside the tinted square a glyph needs. */
+    iconBare?: boolean;
+    /** Glyph after the label, saying the tab does more than select itself — the
+     *  assistant's chevron, which says the name on it can be changed. */
+    trailing?: React.ComponentType<{
+        className?: string;
+    }>;
+    /** What the panel IS, after what it is called — the colleague's job title
+     *  beside their name. Shown only where the header has room for it: the
+     *  identity row, never the tab strip. */
+    sublabel?: string;
     /** Lower sorts first. Default 100. */
     order?: number;
     /** Count chip on the tab. Hidden when count is 0. `destructive` renders the
@@ -19,6 +31,37 @@ export interface RightRailPanelDef {
      *  renders it far from where it was registered. */
     Component: React.ComponentType;
 }
+/** An internal page inside the active panel: the header stops being a tab strip
+ *  and becomes "← Voltar | <title>" for as long as one is open. */
+export interface RightRailDrill {
+    title: string;
+    back: () => void;
+    /** Names where back goes ("Voltar ao Chat"). Defaults to a plain "Voltar" —
+     *  worth setting when the page came from somewhere else in the app and the
+     *  destination is not obvious from where you are standing. */
+    backLabel?: string;
+    /**
+     * Keep the panel's own controls in the header instead of clearing it.
+     *
+     * Off by default, and that is right for a page from ELSEWHERE: nothing of the
+     * chat's applies to a connector's settings. A panel drilling into its own
+     * view is the other case — the conversation is still the chat, and taking
+     * away "nova conversa" while you are in one is taking away the way out.
+     */
+    keepActions?: boolean;
+    /**
+     * A face to put before the title.
+     *
+     * The centred title answers "what am I looking at"; when the answer is a
+     * PERSON, the name alone is the weaker half of it — the portrait is how the
+     * colleague is recognised everywhere else in the panel, and dropping it here
+     * made the header of a conversation look like the header of a settings page.
+     */
+    avatar?: {
+        name: string;
+        src?: string;
+    };
+}
 interface RightRailState {
     /** A shell able to render the rail is mounted. Contributors read this to
      *  decide between the rail and their own fallback surface. */
@@ -32,6 +75,17 @@ interface RightRailState {
     close: () => void;
     /** Same tab closes, a different tab switches. */
     togglePanel: (id: string) => void;
+    /**
+     * The active tab was clicked again.
+     *
+     * Selecting what is already selected is normally nothing, but a tab that
+     * carries an identity — the assistant's face and name — is also the natural
+     * place to change that identity. The rail does not know what that means, so
+     * it just counts the click and the panel decides (see useRightRailReselect).
+     */
+    reselects: number;
+    reselectId: string | null;
+    reselect: (id: string) => void;
     registerPanel: (panel: RightRailPanelDef) => void;
     unregisterPanel: (id: string) => void;
     /** Badge-only update. Separate from `registerPanel` on purpose: a badge
@@ -42,17 +96,57 @@ interface RightRailState {
     /** Label/icon change without a lifecycle event — same reasoning as the badge.
      *  The chat panel renames itself to the persona the current screen invited
      *  ("Growth Analyst"), and re-registering for that would close the open rail. */
-    updateMeta: (id: string, meta: Partial<Pick<RightRailPanelDef, 'label' | 'icon'>>) => void;
+    updateMeta: (id: string, meta: Partial<Pick<RightRailPanelDef, 'label' | 'icon' | 'iconBare' | 'trailing' | 'sublabel'>>) => void;
     /** Distance (px) from the viewport's right edge to the open column's left
      *  edge — MEASURED from the rendered card, so clamps and drags are included.
      *  The FAB reads it to stay anchored to the CONTENT's bottom-right corner. */
     width: number;
     setWidth: (width: number) => void;
+    /** Set by whatever owns the header while an internal page is open. */
+    drill: RightRailDrill | null;
+    setDrill: (drill: RightRailDrill | null) => void;
+    pageSlot: HTMLElement | null;
+    setPageSlot: (element: HTMLElement | null) => void;
+    /** A page is occupying the column; the active panel stays mounted behind it. */
+    pageOpen: boolean;
+    /** Opens the column if it was closed — clicking a deal should show the deal. */
+    showPage: () => void;
+    /**
+     * Leaving the page CLOSES the column.
+     *
+     * It used to only drop the page, which handed the column back to the chat —
+     * so saving a booking, or simply navigating to another screen, left the
+     * assistant open on top of a screen that never asked for it. The column was
+     * opened to show the page; with the page gone it has nothing to show.
+     */
+    closePage: () => void;
 }
 export declare const useRightRailStore: import("zustand").UseBoundStore<import("zustand").StoreApi<RightRailState>>;
 /** Register a panel while the caller is mounted. `Component` must be
  *  referentially stable or the panel remounts on every parent render. */
 export declare function useRightRailPanel(panel: RightRailPanelDef | null): void;
+export declare const RightRailActionsSlotProvider: React.Provider<HTMLElement | null>;
+export declare function RightRailActions({ children }: {
+    children: React.ReactNode;
+}): React.JSX.Element;
+export declare const RightRailLeadingSlotProvider: React.Provider<HTMLElement | null>;
+export declare function RightRailLeading({ children }: {
+    children: React.ReactNode;
+}): React.JSX.Element;
+/** Run `handler` when the user clicks the tab of a panel that is already open.
+ *  Counts, not booleans: two clicks in a row are two events. */
+export declare function useRightRailReselect(id: string, handler: () => void): void;
+/** A shell able to host the rail is mounted, so a panel's chrome (its header,
+ *  its back link) belongs to the rail rather than to the panel itself. */
+export declare function useRightRailHosted(): boolean;
+/**
+ * Give the rail's header to an internal page: "← Voltar | <title>" replaces the
+ * tab strip until the page closes.
+ *
+ * Pass null when there is no internal page open. `back` is read through a ref,
+ * so a caller does not have to memoise it to avoid re-registering.
+ */
+export declare function useRightRailDrill(drill: RightRailDrill | null): void;
 /** No panels registered means no column and no divider. */
 export declare function useHasRightRail(): boolean;
 /** The user's dragged width, remembered per browser. */

package/dist/components/right-rail.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"right-rail.d.ts","sourceRoot":"","sources":["../../src/components/right-rail.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B;4CAC4C;AAE5C,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAClD,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;yEACqE;IACrE,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,SAAS,GAAG,aAAa,CAAA;KAAE,CAAA;IAC3D;uDACmD;IACnD,SAAS,EAAE,KAAK,CAAC,aAAa,CAAA;CAC/B;AAED,UAAU,cAAc;IACtB;kEAC8D;IAC9D,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IACtC,IAAI,EAAE,OAAO,CAAA;IACb,qEAAqE;IACrE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,MAAM,EAAE,iBAAiB,EAAE,CAAA;IAC3B,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,iDAAiD;IACjD,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,aAAa,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAA;IACjD,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACrC;;;gCAG4B;IAC5B,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;IACpE;;qFAEiF;IACjF,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC,KAAK,IAAI,CAAA;IAC1F;;kFAE8E;IAC9E,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CAClC;AAED,eAAO,MAAM,iBAAiB,6EA+C3B,CAAA;AAEH;yEACyE;AACzE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,GAAG,IAAI,CAoCvE;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAID,wDAAwD;AACxD,wBAAgB,kBAAkB,CAAC,QAAQ,SAAM,GAAG,MAAM,CAOzD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAMvD"}
+{"version":3,"file":"right-rail.d.ts","sourceRoot":"","sources":["../../src/components/right-rail.tsx"],"names":[],"mappings":"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"}

package/dist/components/settings/ConnectedCompanySettings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConnectedCompanySettings.d.ts","sourceRoot":"","sources":["../../../src/components/settings/ConnectedCompanySettings.tsx"],"names":[],"mappings":"AA0BA,wBAAgB,wBAAwB,gCAuCvC"}
+{"version":3,"file":"ConnectedCompanySettings.d.ts","sourceRoot":"","sources":["../../../src/components/settings/ConnectedCompanySettings.tsx"],"names":[],"mappings":"AA2BA,wBAAgB,wBAAwB,gCA8CvC"}

package/dist/components/settings/ConnectedUserProfile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConnectedUserProfile.d.ts","sourceRoot":"","sources":["../../../src/components/settings/ConnectedUserProfile.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAkB9B,wBAAgB,oBAAoB,sBAgFnC"}
+{"version":3,"file":"ConnectedUserProfile.d.ts","sourceRoot":"","sources":["../../../src/components/settings/ConnectedUserProfile.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAqB9B,wBAAgB,oBAAoB,sBA0GnC"}

package/dist/components/settings/LocationsCrudPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LocationsCrudPage.d.ts","sourceRoot":"","sources":["../../../src/components/settings/LocationsCrudPage.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C,eAAO,MAAM,iBAAiB,EAAE,SA8B/B,CAAA;AAED,eAAO,MAAM,iBAAiB;;CAAoC,CAEjE"}
+{"version":3,"file":"LocationsCrudPage.d.ts","sourceRoot":"","sources":["../../../src/components/settings/LocationsCrudPage.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C,eAAO,MAAM,iBAAiB,EAAE,SA+D/B,CAAA;AAED,eAAO,MAAM,iBAAiB;;CAAoC,CAEjE"}

package/dist/components/settings/MyRecordPanel.d.ts

@@ -0,0 +1,3 @@
+import * as React from 'react';
+export declare function MyRecordPanel(): React.JSX.Element | null;
+//# sourceMappingURL=MyRecordPanel.d.ts.map

package/dist/components/settings/MyRecordPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MyRecordPanel.d.ts","sourceRoot":"","sources":["../../../src/components/settings/MyRecordPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAgD9B,wBAAgB,aAAa,6BA8G5B"}

package/dist/components/settings/MyWorkspaceCard.d.ts

@@ -0,0 +1,3 @@
+import * as React from 'react';
+export declare function MyWorkspaceCard(): React.JSX.Element | null;
+//# sourceMappingURL=MyWorkspaceCard.d.ts.map

package/dist/components/settings/MyWorkspaceCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MyWorkspaceCard.d.ts","sourceRoot":"","sources":["../../../src/components/settings/MyWorkspaceCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AA2D9B,wBAAgB,eAAe,6BAyL9B"}

package/dist/components/settings/SettingsPage.d.ts

@@ -43,7 +43,15 @@ interface SettingsPageProps {
      *  self-managed behaviour used by standalone <SettingsPage> mounts.
      *  `null` means the URL is at bare /settings: show the index, not a tab. */
     activeTabId?: string | null;
+    /** The shell's page band is already drawing a back affordance for this route.
+     *  Set explicitly rather than inferred from `controlled`: the band renders on
+     *  its own conditions, and guessing produced two "← Configurações" rows, one
+     *  under the other, on every settings tab. */
+    hideBack?: boolean;
+    /** The shell's page band already names the screen. Without this the index at
+     *  /settings prints "Configurações" twice, one line under the other. */
+    hideTitle?: boolean;
 }
-export declare function SettingsPage({ tabs, extraTabs, defaultTab, className, beforeContent, afterContent, showCompany, showBranding, hideNav, activeTabId, }: SettingsPageProps): React.JSX.Element;
+export declare function SettingsPage({ tabs, extraTabs, defaultTab, className, beforeContent, afterContent, showCompany, showBranding, hideNav, activeTabId, hideBack, hideTitle, }: SettingsPageProps): React.JSX.Element;
 export {};
 //# sourceMappingURL=SettingsPage.d.ts.map

package/dist/components/settings/SettingsPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SettingsPage.d.ts","sourceRoot":"","sources":["../../../src/components/settings/SettingsPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAqC9B,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB;wEACoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;gEACgE;AAChE,wBAAgB,mBAAmB,CAAC,EAClC,WAAkB,EAClB,YAAmB,GACpB,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,WAAW,EAAE,CAcxE;AAED,UAAU,iBAAiB;IACzB,IAAI,CAAC,EAAE,WAAW,EAAE,CAAA;IACpB,SAAS,CAAC,EAAE,WAAW,EAAE,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC/B,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC9B;;+BAE2B;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;yCACqC;IACrC,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;+EAE2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;;gFAK4E;IAC5E,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,SAAS,EACT,UAAU,EACV,SAAS,EACT,aAAa,EACb,YAAY,EACZ,WAAkB,EAClB,YAAmB,EACnB,OAAe,EACf,WAAW,GACZ,EAAE,iBAAiB,qBA0MnB"}
+{"version":3,"file":"SettingsPage.d.ts","sourceRoot":"","sources":["../../../src/components/settings/SettingsPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAY9B,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB;wEACoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;gEACgE;AAChE,wBAAgB,mBAAmB,CAAC,EAClC,WAAkB,EAClB,YAAmB,GACpB,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,WAAW,EAAE,CAcxE;AAED,UAAU,iBAAiB;IACzB,IAAI,CAAC,EAAE,WAAW,EAAE,CAAA;IACpB,SAAS,CAAC,EAAE,WAAW,EAAE,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC/B,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC9B;;+BAE2B;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;yCACqC;IACrC,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;+EAE2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;;gFAK4E;IAC5E,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B;;;kDAG8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;4EACwE;IACxE,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,SAAS,EACT,UAAU,EACV,SAAS,EACT,aAAa,EACb,YAAY,EACZ,WAAkB,EAClB,YAAmB,EACnB,OAAe,EACf,WAAW,EACX,QAAQ,EACR,SAAS,GACV,EAAE,iBAAiB,qBA0MnB"}

package/dist/components/shared/ContactPicker.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
+import { type EntityDef } from '@fayz-ai/core';
 import { type EntityLookup } from '../../crud/archetype-lookup';
 export interface ContactPickerValue {
     /** Person id — undefined while the user has only typed a name. */
@@ -10,13 +11,8 @@ export interface ContactPickerValue {
 export interface ContactPickerProps {
     value: ContactPickerValue | null;
     onChange: (value: ContactPickerValue | null) => void;
-    /**
-     * `people.kind` for records created here (e.g. 'client', 'lead', 'contact').
-     * Also narrows the default lookup, so a vertical only searches its own people.
-     */
+    /** `people.kind` the default lookup searches, so a vertical only sees its own people. */
     kind?: string;
-    /** Per-vertical extension table linked by `person_id` — skipped when absent from the pool. */
-    extensionTable?: string;
     /** Search source. Defaults to the `person` archetype lookup narrowed by `kind`. */
     lookup?: EntityLookup;
     /**
@@ -79,16 +75,34 @@ export interface ContactPickerProps {
      */
     createLabel?: string;
     /**
-     * Fires when the inline create form opens/closes. The create form owns phone
-     * and email while it is open, so a host that ALSO renders a phone/handle field
-     * (the conversations composer does) hides its own to avoid asking twice.
+     * Fires when the inline create form opens/closes, so a host that renders its
+     * own field around the picker can hide it rather than ask twice.
      */
     onCreatingChange?: (creating: boolean) => void;
     className?: string;
     /** Extra hint under the input while a name is typed but nothing is selected. */
     hint?: React.ReactNode;
-    /** ISO2 country driving the quick-create phone mask. Defaults to BR. */
-    phoneCountry?: string;
+    /**
+     * What this field creates — the app's own entity ("Client", "Student"), the
+     * same definition its registry page uses.
+     *
+     * "Create" opens THAT form: the fields this app requires, the rest one click
+     * away, written by the entity's own provider — which is what knows how to
+     * write the base table and the vertical's extension together. Without it the
+     * field searches only; there is no generic contact shape to fall back on that
+     * would not write a record some app considers invalid.
+     *
+     * The entity also decides who may: with `permission.feature` declared and no
+     * `create` grant, the field searches but never offers to register.
+     */
+    createEntityDef?: EntityDef;
+    /**
+     * Chevron on the right of the search box, saying the field picks from a list.
+     * On by default for `inline`, where there is no border to say it otherwise.
+     */
+    chevron?: boolean;
+    /** Marks the search input `aria-required`; the visible mark belongs to the host row. */
+    required?: boolean;
 }
-export declare function ContactPicker({ value, onChange, kind, extensionTable, lookup, allowFreeText, clearable, disabled, autoFocus, placeholder, variant, label, secondaryText, handleField, createLabel, onCreatingChange, className, hint, phoneCountry, }: ContactPickerProps): React.JSX.Element;
+export declare function ContactPicker({ value, onChange, kind, lookup, allowFreeText, clearable, disabled, autoFocus, placeholder, variant, label, secondaryText, handleField, createLabel, onCreatingChange, className, hint, createEntityDef, chevron, required, }: ContactPickerProps): React.JSX.Element;
 //# sourceMappingURL=ContactPicker.d.ts.map

package/dist/components/shared/ContactPicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContactPicker.d.ts","sourceRoot":"","sources":["../../../src/components/shared/ContactPicker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+C,MAAM,OAAO,CAAA;AAInE,OAAO,EAAyB,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAA;AA+BtF,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAA;IAChC,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,KAAK,IAAI,CAAA;IACpD;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,8FAA8F;IAC9F,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,mFAAmF;IACnF,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,yEAAyE;IACzE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;IAC5B,+GAA+G;IAC/G,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;;;;;;OAUG;IACH,WAAW,CAAC,EAAE;QACZ,kEAAkE;QAClE,KAAK,EAAE,MAAM,CAAA;QACb,8DAA8D;QAC9D,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,KAAK,EAAE,MAAM,CAAA;QACb,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;QACjC,4DAA4D;QAC5D,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,CAAA;IACD;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAA;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gFAAgF;IAChF,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,QAAQ,EACR,IAAI,EACJ,cAAc,EACd,MAAM,EACN,aAAqB,EACrB,SAAgB,EAChB,QAAQ,EACR,SAAS,EACT,WAAW,EACX,OAAiB,EACjB,KAAK,EACL,aAAa,EACb,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,IAAI,EACJ,YAAY,GACb,EAAE,kBAAkB,qBAwSpB"}
+{"version":3,"file":"ContactPicker.d.ts","sourceRoot":"","sources":["../../../src/components/shared/ContactPicker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+C,MAAM,OAAO,CAAA;AAGnE,OAAO,EAA0D,KAAK,SAAS,EAAE,MAAM,eAAe,CAAA;AACtG,OAAO,EAAyB,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAqBtF,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAA;IAChC,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,KAAK,IAAI,CAAA;IACpD,yFAAyF;IACzF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,mFAAmF;IACnF,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,yEAAyE;IACzE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;IAC5B,+GAA+G;IAC/G,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;;;;;;OAUG;IACH,WAAW,CAAC,EAAE;QACZ,kEAAkE;QAClE,KAAK,EAAE,MAAM,CAAA;QACb,8DAA8D;QAC9D,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,KAAK,EAAE,MAAM,CAAA;QACb,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;QACjC,4DAA4D;QAC5D,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,CAAA;IACD;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAA;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gFAAgF;IAChF,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB;;;;;;;;;;;;OAYG;IACH,eAAe,CAAC,EAAE,SAAS,CAAA;IAC3B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,QAAQ,EACR,IAAI,EACJ,MAAM,EACN,aAAqB,EACrB,SAAgB,EAChB,QAAQ,EACR,SAAS,EACT,WAAW,EACX,OAAiB,EACjB,KAAK,EACL,aAAa,EACb,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,IAAI,EACJ,eAAe,EACf,OAAO,EACP,QAAQ,GACT,EAAE,kBAAkB,qBA2QpB"}

package/dist/components/shared/RecordPickerModal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RecordPickerModal.d.ts","sourceRoot":"","sources":["../../../src/components/shared/RecordPickerModal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+C,MAAM,OAAO,CAAA;AAsBnE,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,uEAAuE;IACvE,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,gFAAgF;IAChF,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,CAAA;IACtC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAA;IAC3B,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,eAAe,CAAA;IACvC,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,IAAI,CAAA;IAC/B,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4EAA4E;IAC5E,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7D;8EAC0E;IAC1E,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;IACtB;kCAC8B;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,EACnC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAC1D,QAAe,EAAE,WAAuB,EAAE,YAA0B,EACpE,UAA+B,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAC/D,EAAE,sBAAsB,CAAC,CAAC,CAAC,qBAwL3B"}
+{"version":3,"file":"RecordPickerModal.d.ts","sourceRoot":"","sources":["../../../src/components/shared/RecordPickerModal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+C,MAAM,OAAO,CAAA;AAsBnE,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,uEAAuE;IACvE,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,gFAAgF;IAChF,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,CAAA;IACtC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAA;IAC3B,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,eAAe,CAAA;IACvC,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,IAAI,CAAA;IAC/B,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4EAA4E;IAC5E,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7D;8EAC0E;IAC1E,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;IACtB;kCAC8B;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAmDD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,EACnC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAC1D,QAAe,EAAE,WAAuB,EAAE,YAA0B,EACpE,UAA+B,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAC/D,EAAE,sBAAsB,CAAC,CAAC,CAAC,qBAyM3B"}

package/dist/crud/CrudAgentSurface.d.ts

@@ -0,0 +1,27 @@
+import type { EntityDef } from '@fayz-ai/core';
+import type { AgentSurfaceContribution } from '../lib/agent-surface';
+interface CrudStoreLike {
+    create: (data: Record<string, unknown>) => Promise<{
+        id: string;
+    }>;
+    /** Rows currently loaded — read only to publish what a unique field already
+     *  holds, never as the list of everything that exists. */
+    items?: Array<Record<string, unknown>> | null;
+}
+export interface CrudSurfaceInput {
+    entityDef: EntityDef<any>;
+    store: CrudStoreLike;
+    /** Screen-specific guidance, appended to CREATE_GUIDANCE. */
+    instructions?: string;
+    /** Field keys whose values must not repeat. */
+    uniqueFields?: string[];
+}
+/**
+ * The contribution itself, built from a GETTER so the component can re-render
+ * without re-registering and the snapshot still reads the live list. Exported
+ * because what the assistant is told is worth testing without a DOM.
+ */
+export declare function buildCrudSurfaceContribution(read: () => CrudSurfaceInput): AgentSurfaceContribution;
+export declare function CrudAgentSurface(props: CrudSurfaceInput): null;
+export {};
+//# sourceMappingURL=CrudAgentSurface.d.ts.map

package/dist/crud/CrudAgentSurface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CrudAgentSurface.d.ts","sourceRoot":"","sources":["../../src/crud/CrudAgentSurface.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,eAAe,CAAA;AAG5D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AAoEpE,UAAU,aAAa;IACrB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAClE;8DAC0D;IAC1D,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAA;CAC9C;AAoBD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAA;IACzB,KAAK,EAAE,aAAa,CAAA;IACpB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CACxB;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,gBAAgB,GAC3B,wBAAwB,CAiE1B;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,QAYvD"}

package/dist/crud/CrudDetailPage.d.ts

@@ -7,6 +7,15 @@ interface CrudDetailPageProps {
     namePlural: string;
     basePath: string;
     initialTab?: string;
+    /**
+     * Path segments past the tab id, handed to the tab component as `tabPath`.
+     *
+     * This is what lets something INSIDE a record be linkable without inventing a
+     * top-level route for it: `/clients/:id/scribe/:recordingId` opens the
+     * client, on the recordings tab, on that recording — keeping the name, the
+     * other tabs and the way back that `#/scribe/:id` threw away.
+     */
+    tabPath?: string[];
     onBack: () => void;
     onEdit?: () => void;
     onDelete?: () => void;
@@ -16,11 +25,20 @@ interface CrudDetailPageProps {
     /** Saves ONE field. Absent means read-only — the same signal that already
      *  decides the Edit button. */
     onFieldSave?: (key: string, value: unknown) => Promise<void> | void;
+    /** Extra badges beside the name — facts ABOUT the record that do not live on
+     *  it. The org role is the case that forced this: it belongs to the
+     *  membership, not to the person, so there is no field to render it from and
+     *  no honest place to put it except next to the name. */
+    badges?: React.ReactNode;
+    /** Makes the hero photo replaceable. Absent means the image is display-only,
+     *  which is what every registry screen wants; the profile passes it because
+     *  there the photo IS the account's photo. */
+    onImageChange?: (file: File) => Promise<void> | void;
 }
 /** @internal exportado para teste — a resolução das abas do arquétipo. */
 export declare function getArchetypeTabs(layout?: FormLayout, archetypeKind?: string): DetailTab[];
 /** @internal exportado para teste — resolve `DetailTab.icon` contra o lucide. */
 export declare function resolveTabIcon(name: string): LucideIcon | null;
-export declare function CrudDetailPage({ entityDef, item, namePlural, basePath, initialTab, onBack, onEdit, onDelete, feature, embedded, onFieldSave, }: CrudDetailPageProps): React.JSX.Element;
+export declare function CrudDetailPage({ entityDef, item, namePlural, basePath, initialTab, tabPath, onBack, onEdit, onDelete, feature, embedded, onFieldSave, badges, onImageChange, }: CrudDetailPageProps): React.JSX.Element;
 export {};
 //# sourceMappingURL=CrudDetailPage.d.ts.map

package/dist/crud/CrudDetailPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CrudDetailPage.d.ts","sourceRoot":"","sources":["../../src/crud/CrudDetailPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA2C,MAAM,OAAO,CAAA;AAG/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AA4B9C,OAAO,KAAK,EAAE,SAAS,EAAwB,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE3F,UAAU,mBAAmB;IAC3B,SAAS,EAAE,SAAS,CAAA;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;mCAC+B;IAC/B,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CACpE;AAiWD,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAgCzF;AAmCD,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAK9D;AAED,wBAAgB,cAAc,CAAC,EAC7B,SAAS,EACT,IAAI,EACJ,UAAU,EACV,QAAQ,EACR,UAAU,EACV,MAAM,EACN,MAAM,EACN,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,WAAW,GACZ,EAAE,mBAAmB,qBA2KrB"}
+{"version":3,"file":"CrudDetailPage.d.ts","sourceRoot":"","sources":["../../src/crud/CrudDetailPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA2C,MAAM,OAAO,CAAA;AAG/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AA+B9C,OAAO,KAAK,EAAE,SAAS,EAAwB,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE3F,UAAU,mBAAmB;IAC3B,SAAS,EAAE,SAAS,CAAA;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;mCAC+B;IAC/B,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IACnE;;;6DAGyD;IACzD,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACxB;;kDAE8C;IAC9C,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CACrD;AAiWD,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAgCzF;AAmCD,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAK9D;AAED,wBAAgB,cAAc,CAAC,EAC7B,SAAS,EACT,IAAI,EACJ,UAAU,EACV,QAAQ,EACR,UAAU,EACV,OAAO,EACP,MAAM,EACN,MAAM,EACN,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,WAAW,EACX,MAAM,EACN,aAAa,GACd,EAAE,mBAAmB,qBA2QrB"}

package/dist/crud/CrudFormPage.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import type { EntityDef } from '@fayz-ai/core';
+import type { FieldDef, EntityDef } from '@fayz-ai/core';
 interface CrudFormPageProps {
     entityDef: EntityDef;
     mode: 'create' | 'edit';
@@ -20,7 +20,48 @@ interface CrudFormPageProps {
     formId?: string;
     /** Drop the inline Cancel/Save row: the host renders them somewhere better. */
     hideActions?: boolean;
+    /**
+     * Opens showing ONLY the essentials — the required fields — with a link that
+     * reveals the whole registry. For a form that interrupts something else: the
+     * supplier missing mid-invoice needs a name, not twenty fields the person
+     * posting it does not have to hand.
+     */
+    essentialFirst?: boolean;
+    /**
+     * Render the fields in a <div> instead of a <form>, and hand the host a way
+     * to submit them (`submitRef`).
+     *
+     * For a host that is ITSELF a form — a lookup's inline create sitting inside
+     * an invoice or a booking. A form nested in a form cannot be submitted at
+     * all: the button is associated correctly and `requestSubmit()` is simply
+     * ignored, so the only symptom is a dead button. Verified in Chromium.
+     *
+     * The trade is native `required` validation, which `submit` replaces with its
+     * own check over the entity's required fields.
+     */
+    noForm?: boolean;
+    /** Receives the submit function while mounted. Only useful with `noForm`. */
+    submitRef?: React.MutableRefObject<(() => void) | null>;
 }
-export declare function CrudFormPage({ entityDef, mode, initialData, onSubmit, onCancel, namePlural, embedded, hideBreadcrumb, formId, hideActions }: CrudFormPageProps): React.JSX.Element;
+/**
+ * Empty for the purpose of a REQUIRED check.
+ *
+ * Deliberately not `!value`: `0` is a price a merchant meant to type and
+ * `false` is an answer to a checkbox, and treating either as missing is how a
+ * validator starts refusing valid input. Spelled out rather than leaning on
+ * string coercion — `!String(v ?? '').trim()` happens to agree on every case
+ * here, and agreeing by accident is not the same as saying what you mean.
+ */
+export declare function isEmptyValue(value: unknown): boolean;
+/**
+ * The required fields a save would fail on, in the order they appear on screen.
+ *
+ * Pure and exported because it is the whole judgement — the rest is wiring —
+ * and because it is the same question the agent path (`ai-tool-handlers.ts`)
+ * asks of the same record. Fields hidden by `visibleWhen` are skipped: a field
+ * the merchant cannot see is not one they can be asked to fill.
+ */
+export declare function missingRequiredFields(fields: FieldDef[], values: Record<string, unknown>): FieldDef[];
+export declare function CrudFormPage({ entityDef, mode, initialData, onSubmit, onCancel, namePlural, embedded, hideBreadcrumb, formId, hideActions, essentialFirst, noForm, submitRef }: CrudFormPageProps): React.JSX.Element;
 export {};
 //# sourceMappingURL=CrudFormPage.d.ts.map

package/dist/crud/CrudFormPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CrudFormPage.d.ts","sourceRoot":"","sources":["../../src/crud/CrudFormPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAA;AAkBlD,OAAO,KAAK,EAAwB,SAAS,EAAE,MAAM,eAAe,CAAA;AAKpE,UAAU,iBAAiB;IACzB,SAAS,EAAE,SAAS,CAAA;IACpB,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACjC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7D,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;iFAC6E;IAC7E,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+EAA+E;IAC/E,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAkXD,wBAAgB,YAAY,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,iBAAiB,qBA6O9J"}
+{"version":3,"file":"CrudFormPage.d.ts","sourceRoot":"","sources":["../../src/crud/CrudFormPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAA;AAmBlD,OAAO,KAAK,EAAE,QAAQ,EAAc,SAAS,EAAE,MAAM,eAAe,CAAA;AAMpE,UAAU,iBAAiB;IACzB,SAAS,EAAE,SAAS,CAAA;IACpB,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACjC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7D,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;iFAC6E;IAC7E,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+EAA+E;IAC/E,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,CAAA;CACxD;AAaD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKpD;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,QAAQ,EAAE,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,QAAQ,EAAE,CAOZ;AA6bD,wBAAgB,YAAY,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,iBAAiB,qBAuUjM"}

package/dist/crud/CrudListView.d.ts

@@ -1,7 +1,8 @@
 import React from 'react';
 import type { ColumnDef as TanStackColumnDef } from '@tanstack/react-table';
 import type { EntityDef } from '@fayz-ai/core';
-import { type StatTileData } from '@fayz-ai/ui';
+import { type RowBulkAction, type StatTileData } from '@fayz-ai/ui';
+import { type AskAIIntro } from '../components/AskAI';
 /** A resolved facet: a field plus the options to render. */
 export interface CrudFacet {
     field: string;
@@ -21,6 +22,23 @@ export interface CrudFacet {
      */
     display?: 'pills' | 'tabs';
 }
+/**
+ * "Criar com IA" on a list, and what the assistant knows while it is open.
+ *
+ * `instructions` and `uniqueFields` are what turn a generic create into one
+ * that can actually finish: the first says how THIS entity is filled, the
+ * second publishes the values already taken so an invented identifier does not
+ * collide with a row that exists.
+ */
+export interface CrudAiCreate {
+    hint?: string;
+    description?: string;
+    intro?: AskAIIntro;
+    /** Guidance appended to the generic create guidance while the list is open. */
+    instructions?: string;
+    /** Field keys that must not repeat (a coupon code, a slug). */
+    uniqueFields?: string[];
+}
 /**
  * A sibling list this one sits beside — rendered in the header strip next to (or
  * instead of) the facet tabs, as a link rather than a filter. This is what turns
@@ -40,19 +58,10 @@ export interface CrudNavTab {
  * One entry in the bar that appears when rows are ticked. It receives the
  * selected ROWS, not their ids: an action that has to go back to the store to
  * learn what it is acting on is an action that can act on stale data.
+ *
+ * The same shape a plugin's own ListView takes — one contract for both.
  */
-export interface CrudBulkAction<T> {
-    id: string;
-    label: string;
-    icon?: React.ComponentType<{
-        className?: string;
-    }>;
-    onSelect: (rows: T[]) => void | Promise<void>;
-    destructive?: boolean;
-    /** Sends the action to the "…" menu instead of the button row. */
-    overflow?: boolean;
-    disabled?: boolean;
-}
+export type CrudBulkAction<T> = RowBulkAction<T>;
 export interface CrudListViewProps<T extends {
     id: string;
 }> {
@@ -90,6 +99,15 @@ export interface CrudListViewProps<T extends {
     onBulkDelete?: (rows: T[]) => void;
     onImport?: () => void;
     onExport?: () => void;
+    /**
+     * Offer "Criar com IA" in the create menu.
+     *
+     * OPT-IN, not automatic, and the reason is honesty: the assistant reaches a
+     * record through the data primitives, which only see entities a plugin
+     * published in `queryEntities`. Turn it on where the entity IS reachable —
+     * elsewhere the door would open on an assistant that cannot do the thing.
+     */
+    aiCreate?: CrudAiCreate;
     feature?: string;
     readOnly?: boolean;
     /** Esta lista é uma SEÇÃO de outra tela, não a tela. Mantém as ações no
@@ -130,5 +148,5 @@ export interface CrudListViewProps<T extends {
  */
 export declare function CrudListView<T extends {
     id: string;
-}>({ entityDef, columns, items, total, page, pageSize, onPageChange, display, search, onSearchChange, searchPlaceholder, facets, activeFilters, onFacetChange, onNew, addLabel, onRowClick, onDelete, bulkActions, onBulkDelete, onImport, onExport, feature, readOnly, embedded, emptyMessage, navTabs, activeNavTab, headerActions, stats, onRefresh, refreshFromCache, onSort, onSortField, onSortDir, sortBy, sortDir, error, }: CrudListViewProps<T>): React.JSX.Element;
+}>({ entityDef, columns, items, total, page, pageSize, onPageChange, display, search, onSearchChange, searchPlaceholder, facets, activeFilters, onFacetChange, onNew, addLabel, onRowClick, onDelete, bulkActions, onBulkDelete, onImport, onExport, aiCreate, feature, readOnly, embedded, emptyMessage, navTabs, activeNavTab, headerActions, stats, onRefresh, refreshFromCache, onSort, onSortField, onSortDir, sortBy, sortDir, error, }: CrudListViewProps<T>): React.JSX.Element;
 //# sourceMappingURL=CrudListView.d.ts.map

package/dist/crud/CrudListView.d.ts.map

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

package/dist/crud/CrudPage.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { type CrudNavTab } from './CrudListView';
+import { type CrudAiCreate, type CrudNavTab } from './CrudListView';
 import type { StatTileData } from '@fayz-ai/ui';
 import type { EntityDef } from '@fayz-ai/core';
 import type { CrudStore } from '../stores/createCrudStore';
@@ -19,12 +19,23 @@ interface CrudPageProps<T extends {
     activeNavTab?: string;
     /** Summary tiles for the list, derived from the rows currently loaded. */
     stats?: (items: T[] | null, total: number) => StatTileData[];
+    /**
+     * Offer "Criar com IA" on this list, and publish a tool that can actually do
+     * it.
+     *
+     * The tool writes through THIS list's store — the same provider the form
+     * uses — which is what lets a provider-backed entity (the shop's products,
+     * behind a commerce API with no table of its own) be created by conversation
+     * at all. The agent's global data primitives cannot reach those; they resolve
+     * a target by table.
+     */
+    aiCreate?: CrudAiCreate;
     /** Este CRUD é uma SEÇÃO de outra tela (um cadastro dentro de uma aba de
      *  configurações). Ver CrudListView.embedded. */
     embedded?: boolean;
 }
 export declare function CrudPage<T extends {
     id: string;
-}>({ entityDef: rawEntityDef, useStore, basePath, display, feature, readOnly, navTabs, activeNavTab, stats, embedded }: CrudPageProps<T>): React.JSX.Element;
+}>({ entityDef: rawEntityDef, useStore, basePath, display, feature, readOnly, navTabs, activeNavTab, stats, embedded, aiCreate }: CrudPageProps<T>): React.JSX.Element;
 export {};
 //# sourceMappingURL=CrudPage.d.ts.map

package/dist/crud/CrudPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CrudPage.d.ts","sourceRoot":"","sources":["../../src/crud/CrudPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAA;AAUhF,OAAO,EAAgC,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAgB/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAG1D,KAAK,WAAW,GAAG,OAAO,GAAG,OAAO,CAAA;AAYpC,UAAU,aAAa,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;IAC9C,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IACvB,QAAQ,EAAE,MAAM,SAAS,CAAC,CAAC,CAAC,CAAA;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,WAAW,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,UAAU,EAAE,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,YAAY,EAAE,CAAA;IAC5D;qDACiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAmID,wBAAgB,QAAQ,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC,qBA4bvL"}
+{"version":3,"file":"CrudPage.d.ts","sourceRoot":"","sources":["../../src/crud/CrudPage.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAA;AAUhF,OAAO,EAAgB,KAAK,YAAY,EAAkB,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEjG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAgB/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAG1D,KAAK,WAAW,GAAG,OAAO,GAAG,OAAO,CAAA;AAYpC,UAAU,aAAa,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;IAC9C,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IACvB,QAAQ,EAAE,MAAM,SAAS,CAAC,CAAC,CAAC,CAAA;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,WAAW,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,UAAU,EAAE,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,YAAY,EAAE,CAAA;IAC5D;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB;qDACiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAmID,wBAAgB,QAAQ,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC,qBAodjM"}

package/dist/crud/CrudRecordModal.d.ts

@@ -6,14 +6,28 @@ export interface CrudRecordModalProps {
     /** The saved record, for a caller that wants to retry what it was doing. */
     onSaved?: (record: Record<string, any>) => void;
     entityDef: EntityDef;
-    /** Reads the record. Null closes the form with the empty state. */
-    load: () => Promise<Record<string, any> | null>;
+    /** 'edit' (default) reads via `load`; 'create' opens blank over `initialData`. */
+    mode?: 'create' | 'edit';
+    /** Reads the record. Null closes the form with the empty state. Edit only. */
+    load?: () => Promise<Record<string, any> | null>;
+    /** What is already known about the new record (the name the search missed). */
+    initialData?: Record<string, any>;
+    /** Writes. Throwing keeps the form open with the message on it. */
     save: (data: Record<string, any>) => Promise<Record<string, any> | void>;
+    /**
+     * The caller's own message above the form — for a refusal that has an ANSWER,
+     * not just a text. "That e-mail already belongs to Ana Souza — use her
+     * record" is a button; as a thrown error it would be a dead end. Render it
+     * from a `save` that resolves instead of throwing.
+     */
+    notice?: React.ReactNode;
     /** Defaults to the entity's own name. */
     title?: React.ReactNode;
     description?: React.ReactNode;
     /** Shown when `load` answers null — there is no record to edit. */
     emptyLabel?: React.ReactNode;
+    /** Opens showing only required fields, with a link to the rest. */
+    essentialFirst?: boolean;
 }
-export declare function CrudRecordModal({ open, onClose, onSaved, entityDef, load, save, title, description, emptyLabel, }: CrudRecordModalProps): React.JSX.Element;
+export declare function CrudRecordModal({ open, onClose, onSaved, entityDef, mode, load, initialData, save, title, description, emptyLabel, essentialFirst, notice, }: CrudRecordModalProps): React.JSX.Element;
 //# sourceMappingURL=CrudRecordModal.d.ts.map