@ai-matrx/records-ui 0.102.15 → 0.102.17

package/dist/index.d.cts

@@ -1369,6 +1369,8 @@ interface PersonPickerProps {
     autoOpen?: boolean | undefined;
     /** The list closed: the cell commits who is picked. */
     onClose?: (() => void) | undefined;
+    /** Escape in a grid cell's list: the cell's cancel — nothing is written (`PickOrAdd.onEscape`). */
+    onCancel?: (() => void) | undefined;
     /** What was typed to open a grid cell's list: its first search (`FieldEditorControlProps.initialSearch`). */
     initialSearch?: string | undefined;
 }
@@ -1392,7 +1394,7 @@ declare function personRecordForMember(client: RecordsClient, personTableId: Uui
     ok: false;
     error: RecordsError;
 }>;
-declare function PersonPicker({ field, value, onChange, disabled, id, className, autoOpen, onClose, initialSearch }: PersonPickerProps): react.JSX.Element;
+declare function PersonPicker({ field, value, onChange, disabled, id, className, autoOpen, onClose, onCancel, initialSearch }: PersonPickerProps): react.JSX.Element;
 
 interface RecordVersions {
     /** The version the person saw this record at; waits for the read of freshly drawn rows. `null` = unread. */
@@ -3178,8 +3180,10 @@ interface RelationPickerProps {
     autoOpen?: boolean | undefined;
     /** The list closed: the cell commits what is picked. */
     onClose?: (() => void) | undefined;
+    /** Escape in a grid cell's list: the cell's cancel — nothing is written (`PickOrAdd.onEscape`). */
+    onCancel?: (() => void) | undefined;
 }
-declare function RelationPicker({ field, value, onChange, disabled, id, className, allowCreate, onPicked, autoOpen, onClose }: RelationPickerProps): react.JSX.Element;
+declare function RelationPicker({ field, value, onChange, disabled, id, className, allowCreate, onPicked, autoOpen, onClose, onCancel }: RelationPickerProps): react.JSX.Element;
 
 interface PickOrAddItem {
     id: string;
@@ -3244,6 +3248,13 @@ interface PickOrAddProps {
      * new choice word + Enter did nothing, while Tab then Enter added it). Absent: the add line.
      */
     onEnterWithNoMatch?: (() => void) | undefined;
+    /**
+     * ESCAPE PUTS EVERYTHING BACK (REVIEW-FIX 2, 2026-10-06). In a grid cell closing the list is the
+     * cell's commit, so Escape — which only closed it — wrote whatever the list held, a choice taken
+     * off by Backspace included. When given, Escape (from the search box or Radix's own dismiss) calls
+     * this INSTEAD of closing: the cell's cancel, which writes nothing and shows what it held.
+     */
+    onEscape?: (() => void) | undefined;
     /**
      * IN A GRID CELL (lane CELL-EDITORS, 2026-10-06). No trigger button is drawn: the list hangs from
      * `children` — what the cell already shows — the way Airtable's and the old Sheet's lists hang from
@@ -3259,13 +3270,8 @@ interface PickOrAddProps {
      * arrows chose a row — finishes (the old Sheet's B2-04: Enter used to toggle the first row forever).
      */
     multi?: boolean | undefined;
-    /**
-     * THE ADD ROW LEADS THE LIST (nothing typed matches, Notion's "Create …"): it is highlighted first,
-     * so one Enter makes it; the existing items stay listed under it.
-     */
-    addFirst?: boolean | undefined;
 }
-declare function PickOrAdd({ triggerLabel, triggerText, triggerId, open, onOpenChange, search, onSearch, items, onPick, notice, empty, add, foot, footNote, onEnterWithNoMatch, anchored, children, chips, multi, addFirst, }: PickOrAddProps): react.JSX.Element;
+declare function PickOrAdd({ triggerLabel, triggerText, triggerId, open, onOpenChange, search, onSearch, items, onPick, notice, empty, add, foot, footNote, onEnterWithNoMatch, anchored, children, chips, multi, onEscape, }: PickOrAddProps): react.JSX.Element;
 
 /** What the panel says while the chosen list is empty. */
 declare const ENTITY_REFERENCE_KINDS_MISSING = "Choose at least one kind of thing this column points at.";
@@ -3354,7 +3360,7 @@ interface FieldEditorControlProps {
      * grows the row. Honoured by the choice and person pickers; every other control ignores it.
      */
     autoOpen?: boolean | undefined;
-    /** The picker's list closed (a pick, Escape, a click away): the cell commits what is chosen. */
+    /** The picker's list closed (a pick, Enter, Tab, a click away): the cell commits what is chosen. Escape is `onCancel`. */
     onClose?: (() => void) | undefined;
     /**
      * WHAT THE PERSON TYPED TO OPEN A GRID CELL'S PICKER (merged-grid review 2, A2 — Airtable): a
@@ -3861,7 +3867,10 @@ declare function readLooks(client: Pick<RecordsClient, "viewLookRead">, tableId:
 declare function keepLook(client: Pick<RecordsClient, "viewLookSet">, tableId: Uuid$1, viewId: Uuid$1, look: ViewLook | null): Promise<RecordsResult<Record<string, unknown> | null>>;
 /** The words of the look bar. One sentence, then the doors. */
 declare const LOOK_WORDS: {
+    /** The reason, for a tooltip or a screen reader — never a line on the page (interface-text). */
     readonly yours: "You changed how this view looks. Only you see it.";
+    /** The visible label for the same fact. */
+    readonly yoursLabel: "Only you see this";
     readonly saveToView: "Save to view";
     readonly saveAsNew: "Save as new view";
     readonly reset: "Reset to view";

package/dist/index.d.ts

@@ -1369,6 +1369,8 @@ interface PersonPickerProps {
     autoOpen?: boolean | undefined;
     /** The list closed: the cell commits who is picked. */
     onClose?: (() => void) | undefined;
+    /** Escape in a grid cell's list: the cell's cancel — nothing is written (`PickOrAdd.onEscape`). */
+    onCancel?: (() => void) | undefined;
     /** What was typed to open a grid cell's list: its first search (`FieldEditorControlProps.initialSearch`). */
     initialSearch?: string | undefined;
 }
@@ -1392,7 +1394,7 @@ declare function personRecordForMember(client: RecordsClient, personTableId: Uui
     ok: false;
     error: RecordsError;
 }>;
-declare function PersonPicker({ field, value, onChange, disabled, id, className, autoOpen, onClose, initialSearch }: PersonPickerProps): react.JSX.Element;
+declare function PersonPicker({ field, value, onChange, disabled, id, className, autoOpen, onClose, onCancel, initialSearch }: PersonPickerProps): react.JSX.Element;
 
 interface RecordVersions {
     /** The version the person saw this record at; waits for the read of freshly drawn rows. `null` = unread. */
@@ -3178,8 +3180,10 @@ interface RelationPickerProps {
     autoOpen?: boolean | undefined;
     /** The list closed: the cell commits what is picked. */
     onClose?: (() => void) | undefined;
+    /** Escape in a grid cell's list: the cell's cancel — nothing is written (`PickOrAdd.onEscape`). */
+    onCancel?: (() => void) | undefined;
 }
-declare function RelationPicker({ field, value, onChange, disabled, id, className, allowCreate, onPicked, autoOpen, onClose }: RelationPickerProps): react.JSX.Element;
+declare function RelationPicker({ field, value, onChange, disabled, id, className, allowCreate, onPicked, autoOpen, onClose, onCancel }: RelationPickerProps): react.JSX.Element;
 
 interface PickOrAddItem {
     id: string;
@@ -3244,6 +3248,13 @@ interface PickOrAddProps {
      * new choice word + Enter did nothing, while Tab then Enter added it). Absent: the add line.
      */
     onEnterWithNoMatch?: (() => void) | undefined;
+    /**
+     * ESCAPE PUTS EVERYTHING BACK (REVIEW-FIX 2, 2026-10-06). In a grid cell closing the list is the
+     * cell's commit, so Escape — which only closed it — wrote whatever the list held, a choice taken
+     * off by Backspace included. When given, Escape (from the search box or Radix's own dismiss) calls
+     * this INSTEAD of closing: the cell's cancel, which writes nothing and shows what it held.
+     */
+    onEscape?: (() => void) | undefined;
     /**
      * IN A GRID CELL (lane CELL-EDITORS, 2026-10-06). No trigger button is drawn: the list hangs from
      * `children` — what the cell already shows — the way Airtable's and the old Sheet's lists hang from
@@ -3259,13 +3270,8 @@ interface PickOrAddProps {
      * arrows chose a row — finishes (the old Sheet's B2-04: Enter used to toggle the first row forever).
      */
     multi?: boolean | undefined;
-    /**
-     * THE ADD ROW LEADS THE LIST (nothing typed matches, Notion's "Create …"): it is highlighted first,
-     * so one Enter makes it; the existing items stay listed under it.
-     */
-    addFirst?: boolean | undefined;
 }
-declare function PickOrAdd({ triggerLabel, triggerText, triggerId, open, onOpenChange, search, onSearch, items, onPick, notice, empty, add, foot, footNote, onEnterWithNoMatch, anchored, children, chips, multi, addFirst, }: PickOrAddProps): react.JSX.Element;
+declare function PickOrAdd({ triggerLabel, triggerText, triggerId, open, onOpenChange, search, onSearch, items, onPick, notice, empty, add, foot, footNote, onEnterWithNoMatch, anchored, children, chips, multi, onEscape, }: PickOrAddProps): react.JSX.Element;
 
 /** What the panel says while the chosen list is empty. */
 declare const ENTITY_REFERENCE_KINDS_MISSING = "Choose at least one kind of thing this column points at.";
@@ -3354,7 +3360,7 @@ interface FieldEditorControlProps {
      * grows the row. Honoured by the choice and person pickers; every other control ignores it.
      */
     autoOpen?: boolean | undefined;
-    /** The picker's list closed (a pick, Escape, a click away): the cell commits what is chosen. */
+    /** The picker's list closed (a pick, Enter, Tab, a click away): the cell commits what is chosen. Escape is `onCancel`. */
     onClose?: (() => void) | undefined;
     /**
      * WHAT THE PERSON TYPED TO OPEN A GRID CELL'S PICKER (merged-grid review 2, A2 — Airtable): a
@@ -3861,7 +3867,10 @@ declare function readLooks(client: Pick<RecordsClient, "viewLookRead">, tableId:
 declare function keepLook(client: Pick<RecordsClient, "viewLookSet">, tableId: Uuid$1, viewId: Uuid$1, look: ViewLook | null): Promise<RecordsResult<Record<string, unknown> | null>>;
 /** The words of the look bar. One sentence, then the doors. */
 declare const LOOK_WORDS: {
+    /** The reason, for a tooltip or a screen reader — never a line on the page (interface-text). */
     readonly yours: "You changed how this view looks. Only you see it.";
+    /** The visible label for the same fact. */
+    readonly yoursLabel: "Only you see this";
     readonly saveToView: "Save to view";
     readonly saveAsNew: "Save as new view";
     readonly reset: "Reset to view";