@ai-matrx/records-ui 0.93.12 → 0.93.26

package/dist/index.d.cts

@@ -1215,6 +1215,8 @@ interface PersonPickerProps {
     autoOpen?: boolean | undefined;
     /** The list closed: the cell commits who is picked. */
     onClose?: (() => void) | undefined;
+    /** What was typed to open a grid cell's list: its first search (`FieldEditorControlProps.initialSearch`). */
+    initialSearch?: string | undefined;
 }
 /** A Person record in the kernel Table, as this picker needs to read it. */
 interface PersonRecord {
@@ -1236,7 +1238,7 @@ declare function personRecordForMember(client: RecordsClient, personTableId: Uui
     ok: false;
     error: RecordsError;
 }>;
-declare function PersonPicker({ field, value, onChange, disabled, id, className, autoOpen, onClose }: PersonPickerProps): react.JSX.Element;
+declare function PersonPicker({ field, value, onChange, disabled, id, className, autoOpen, onClose, initialSearch }: PersonPickerProps): react.JSX.Element;
 
 /** Which cell is open. A grid opens exactly one at a time, like every other grid. */
 interface CellAddress {
@@ -1269,6 +1271,12 @@ interface GridEditing {
      * exactly that, replacing the value, as every spreadsheet does; a picker column opens as usual.
      */
     begin: (address: CellAddress, seed?: string | null) => void;
+    /**
+     * What was typed to open a PICKER cell (a choice, a multi-choice, a person): the list opens with
+     * it in its search box (merged-grid review 2, A2 — Airtable). `null` when the cell was opened by
+     * Enter, a click or a double-click.
+     */
+    searchSeed: string | null;
     /** `via`: a key (Escape) or a pointer (the picker's own close) — how the grid gets its keys back. */
     cancel: (via?: EditVia) => void;
     /**
@@ -2545,6 +2553,12 @@ interface FieldEditorControlProps {
     autoOpen?: boolean | undefined;
     /** The picker's list closed (a pick, Escape, a click away): the cell commits what is chosen. */
     onClose?: (() => void) | undefined;
+    /**
+     * WHAT THE PERSON TYPED TO OPEN A GRID CELL'S PICKER (merged-grid review 2, A2 — Airtable): a
+     * letter typed on a selected choice, multi-choice or person cell opens its list with that text
+     * already in the search box. Honoured by the choice and person pickers.
+     */
+    initialSearch?: string | undefined;
     /** The control's own answer is final (a choice cell's Add / Keep as typed): commit it now. */
     onCommit?: (() => void) | undefined;
     /** The control's own Cancel: the cell goes back to what it held. */
@@ -2561,7 +2575,7 @@ declare function FieldLabel({ field, htmlFor, children }: {
     htmlFor: string;
     children?: ReactNode;
 }): react.JSX.Element;
-declare function FieldControl({ field, value, onChange, disabled, id, autoOpen, onClose, onCommit, onCancel, addsChoices }: FieldEditorControlProps): string | number | bigint | true | Iterable<ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | react.JSX.Element;
+declare function FieldControl({ field, value, onChange, disabled, id, autoOpen, onClose, onCommit, onCancel, addsChoices, initialSearch }: FieldEditorControlProps): string | number | bigint | true | Iterable<ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | react.JSX.Element;
 /** The chip a picked record shows as — REC-2's "a record is a chip" in one place. */
 declare function RecordChip({ title, onRemove, className, }: {
     title: string;
@@ -4355,9 +4369,20 @@ interface TablesHomeProps {
      * Default false: the package's own home, lists and all.
      */
     makingOnly?: boolean | undefined;
+    /**
+     * THE HOST'S OWN BUTTONS ASK (merged-grid review 2, J6: "New table" sat ~1,700 px down /data-v2,
+     * then as a row of its own). A host whose page header already has an action bar puts "New table"
+     * and "Start from an example" THERE and passes how many times each was pressed; this list then
+     * draws no button row of its own, and opens the name box / the examples when asked. Absent: the
+     * list draws its own buttons, as before.
+     */
+    askedBy?: {
+        create: number;
+        examples: number;
+    } | undefined;
     className?: string | undefined;
 }
-declare function TablesHome({ onOpenTable, organizationName, makingOnly, className }: TablesHomeProps): react.JSX.Element;
+declare function TablesHome({ onOpenTable, organizationName, makingOnly, askedBy, className }: TablesHomeProps): react.JSX.Element;
 
 interface WhereItLivesProps {
     tableId: Uuid$1;

package/dist/index.d.ts

@@ -1215,6 +1215,8 @@ interface PersonPickerProps {
     autoOpen?: boolean | undefined;
     /** The list closed: the cell commits who is picked. */
     onClose?: (() => void) | undefined;
+    /** What was typed to open a grid cell's list: its first search (`FieldEditorControlProps.initialSearch`). */
+    initialSearch?: string | undefined;
 }
 /** A Person record in the kernel Table, as this picker needs to read it. */
 interface PersonRecord {
@@ -1236,7 +1238,7 @@ declare function personRecordForMember(client: RecordsClient, personTableId: Uui
     ok: false;
     error: RecordsError;
 }>;
-declare function PersonPicker({ field, value, onChange, disabled, id, className, autoOpen, onClose }: PersonPickerProps): react.JSX.Element;
+declare function PersonPicker({ field, value, onChange, disabled, id, className, autoOpen, onClose, initialSearch }: PersonPickerProps): react.JSX.Element;
 
 /** Which cell is open. A grid opens exactly one at a time, like every other grid. */
 interface CellAddress {
@@ -1269,6 +1271,12 @@ interface GridEditing {
      * exactly that, replacing the value, as every spreadsheet does; a picker column opens as usual.
      */
     begin: (address: CellAddress, seed?: string | null) => void;
+    /**
+     * What was typed to open a PICKER cell (a choice, a multi-choice, a person): the list opens with
+     * it in its search box (merged-grid review 2, A2 — Airtable). `null` when the cell was opened by
+     * Enter, a click or a double-click.
+     */
+    searchSeed: string | null;
     /** `via`: a key (Escape) or a pointer (the picker's own close) — how the grid gets its keys back. */
     cancel: (via?: EditVia) => void;
     /**
@@ -2545,6 +2553,12 @@ interface FieldEditorControlProps {
     autoOpen?: boolean | undefined;
     /** The picker's list closed (a pick, Escape, a click away): the cell commits what is chosen. */
     onClose?: (() => void) | undefined;
+    /**
+     * WHAT THE PERSON TYPED TO OPEN A GRID CELL'S PICKER (merged-grid review 2, A2 — Airtable): a
+     * letter typed on a selected choice, multi-choice or person cell opens its list with that text
+     * already in the search box. Honoured by the choice and person pickers.
+     */
+    initialSearch?: string | undefined;
     /** The control's own answer is final (a choice cell's Add / Keep as typed): commit it now. */
     onCommit?: (() => void) | undefined;
     /** The control's own Cancel: the cell goes back to what it held. */
@@ -2561,7 +2575,7 @@ declare function FieldLabel({ field, htmlFor, children }: {
     htmlFor: string;
     children?: ReactNode;
 }): react.JSX.Element;
-declare function FieldControl({ field, value, onChange, disabled, id, autoOpen, onClose, onCommit, onCancel, addsChoices }: FieldEditorControlProps): string | number | bigint | true | Iterable<ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | react.JSX.Element;
+declare function FieldControl({ field, value, onChange, disabled, id, autoOpen, onClose, onCommit, onCancel, addsChoices, initialSearch }: FieldEditorControlProps): string | number | bigint | true | Iterable<ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | react.JSX.Element;
 /** The chip a picked record shows as — REC-2's "a record is a chip" in one place. */
 declare function RecordChip({ title, onRemove, className, }: {
     title: string;
@@ -4355,9 +4369,20 @@ interface TablesHomeProps {
      * Default false: the package's own home, lists and all.
      */
     makingOnly?: boolean | undefined;
+    /**
+     * THE HOST'S OWN BUTTONS ASK (merged-grid review 2, J6: "New table" sat ~1,700 px down /data-v2,
+     * then as a row of its own). A host whose page header already has an action bar puts "New table"
+     * and "Start from an example" THERE and passes how many times each was pressed; this list then
+     * draws no button row of its own, and opens the name box / the examples when asked. Absent: the
+     * list draws its own buttons, as before.
+     */
+    askedBy?: {
+        create: number;
+        examples: number;
+    } | undefined;
     className?: string | undefined;
 }
-declare function TablesHome({ onOpenTable, organizationName, makingOnly, className }: TablesHomeProps): react.JSX.Element;
+declare function TablesHome({ onOpenTable, organizationName, makingOnly, askedBy, className }: TablesHomeProps): react.JSX.Element;
 
 interface WhereItLivesProps {
     tableId: Uuid$1;