@box-kite/react 2.2.0 → 2.2.1

package/docs/components.md

@@ -35,7 +35,7 @@ These hold state, measure the DOM or portal into it. A Server Component may impo
 | `@box-kite/react/components/checkbox` | `Checkbox` (default) |  |
 | `@box-kite/react/components/combobox` | `Combobox` (default), `ComboboxUtils` |  |
 | `@box-kite/react/components/dashboard` | `DashboardGrid` (default), `DashboardUtils`, `Widget` |  |
-| `@box-kite/react/components/dataGrid` | `dataGrid` (default) |  |
+| `@box-kite/react/components/dataGrid` | `dataGrid` (default), `DATA_GRID_LOCALE_TEXT` |  |
 | `@box-kite/react/components/dialog` | `Dialog` (default), `AlertDialog` |  |
 | `@box-kite/react/components/dropdown` | `Dropdown` (default) | **deprecated** |
 | `@box-kite/react/components/form` | `Form` (default) |  |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@box-kite/react",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "type": "module",
   "sideEffects": [
     "pages/**"
@@ -116,7 +116,7 @@
         "./diagnostics-*"
       ],
       "gzip": true,
-      "limit": "36.28 KB"
+      "limit": "36.74 KB"
     },
     {
       "name": "Box in a Server Component (react-server entry)",
@@ -127,7 +127,7 @@
         "./diagnostics-*"
       ],
       "gzip": true,
-      "limit": "34.69 KB"
+      "limit": "35.16 KB"
     },
     {
       "name": "Behavior primitives (a11y entry)",
@@ -160,7 +160,7 @@
         "./diagnostics-*"
       ],
       "gzip": true,
-      "limit": "54.73 KB"
+      "limit": "55.18 KB"
     },
     {
       "name": "Spec renderer (spec entry)",
@@ -188,7 +188,7 @@
       "name": "Core engine (@box-kite/core, no React)",
       "path": "dist-core/core.mjs",
       "gzip": true,
-      "limit": "35.73 KB",
+      "limit": "36.20 KB",
       "ignore": [
         "./diagnostics-*"
       ]
@@ -202,7 +202,7 @@
         "./diagnostics-*"
       ],
       "gzip": true,
-      "limit": "38.35 KB"
+      "limit": "38.83 KB"
     },
     {
       "name": "Popover",
@@ -213,7 +213,7 @@
         "./diagnostics-*"
       ],
       "gzip": true,
-      "limit": "39.88 KB"
+      "limit": "40.35 KB"
     },
     {
       "name": "Menu",
@@ -224,7 +224,7 @@
         "./diagnostics-*"
       ],
       "gzip": true,
-      "limit": "42.15 KB"
+      "limit": "42.63 KB"
     },
     {
       "name": "Accordion",
@@ -235,7 +235,7 @@
         "./diagnostics-*"
       ],
       "gzip": true,
-      "limit": "37.60 KB"
+      "limit": "38.07 KB"
     },
     {
       "name": "Agent",
@@ -246,7 +246,7 @@
         "./diagnostics-*"
       ],
       "gzip": true,
-      "limit": "38.34 KB"
+      "limit": "38.80 KB"
     },
     {
       "name": "Markdown",
@@ -257,7 +257,7 @@
         "./diagnostics-*"
       ],
       "gzip": true,
-      "limit": "36.84 KB"
+      "limit": "37.30 KB"
     },
     {
       "name": "Skeleton",
@@ -268,7 +268,7 @@
         "./diagnostics-*"
       ],
       "gzip": true,
-      "limit": "36.17 KB"
+      "limit": "36.64 KB"
     },
     {
       "name": "Tabs",
@@ -279,7 +279,7 @@
         "./diagnostics-*"
       ],
       "gzip": true,
-      "limit": "38.80 KB"
+      "limit": "39.26 KB"
     },
     {
       "name": "Slider",
@@ -290,7 +290,7 @@
         "./diagnostics-*"
       ],
       "gzip": true,
-      "limit": "37.95 KB"
+      "limit": "38.42 KB"
     },
     {
       "name": "Progress",
@@ -301,7 +301,7 @@
         "./diagnostics-*"
       ],
       "gzip": true,
-      "limit": "36.15 KB"
+      "limit": "36.62 KB"
     },
     {
       "name": "Toaster",
@@ -312,7 +312,7 @@
         "./diagnostics-*"
       ],
       "gzip": true,
-      "limit": "39.62 KB"
+      "limit": "40.08 KB"
     },
     {
       "name": "Combobox",
@@ -323,7 +323,7 @@
         "./diagnostics-*"
       ],
       "gzip": true,
-      "limit": "45.41 KB"
+      "limit": "45.88 KB"
     },
     {
       "name": "Dashboard",
@@ -334,7 +334,7 @@
         "./diagnostics-*"
       ],
       "gzip": true,
-      "limit": "41.80 KB"
+      "limit": "42.27 KB"
     },
     {
       "name": "DataGrid",
@@ -345,7 +345,7 @@
         "./diagnostics-*"
       ],
       "gzip": true,
-      "limit": "83.18 KB"
+      "limit": "87.02 KB"
     },
     {
       "name": "DataGrid export, the chunk fetched on the first press",
@@ -367,7 +367,7 @@
         "./diagnostics-*"
       ],
       "gzip": true,
-      "limit": "114.74 KB"
+      "limit": "118.64 KB"
     }
   ],
   "repository": {
@@ -387,7 +387,13 @@
     "react-server-components",
     "rsc",
     "accessibility",
-    "typescript"
+    "typescript",
+    "components",
+    "ui-components",
+    "ai",
+    "mcp",
+    "agents",
+    "generative-ui"
   ],
   "author": "Maxim Procopenco",
   "license": "MIT",
@@ -401,7 +407,7 @@
     "react-dom": "^16.14.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
   },
   "dependencies": {
-    "@box-kite/core": "2.2.0",
+    "@box-kite/core": "2.2.1",
     "csstype": "^3.2.3",
     "use-sync-external-store": "^1.6.0"
   },

package/utils/dataGrid/activeCellStore.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Which cell holds the grid's tab stop, as a store each cell subscribes to by its own coordinates. Handed
+ * down as a value, a move changed it for every cell on screen; subscribed to, it re-renders the two cells
+ * whose answer changed.
+ */
+export default class ActiveCellStore {
+    private row;
+    private column;
+    private readonly listeners;
+    constructor(row: number, column: number);
+    subscribe: (listener: () => void) => (() => void);
+    isActive(row: number, column: number): boolean;
+    set(row: number, column: number): void;
+}

package/utils/dataGrid/filterDraftUtils.d.ts

@@ -0,0 +1,19 @@
+import { FilterValue, NumberFilterValue } from '../../components/dataGrid/contracts/dataGridContract';
+/** What a number filter's inputs hold while they are being typed into: text, since `1.` is on its way to a number. */
+export interface NumberFilterDraft {
+    operator: NumberFilterValue['operator'];
+    value: string;
+    valueTo: string;
+}
+/**
+ * Whether a filter input's draft already says what the grid holds. When it does not, the grid's value
+ * came from somewhere else — "Clear filters", a controlled prop — and the input has to take it.
+ */
+declare namespace FilterDraftUtils {
+    /** A text filter stores what was typed, and a blank one is no filter at all. */
+    function textMatches(draft: string, filter: FilterValue | undefined): boolean;
+    function numberDraft(filter: FilterValue | undefined): NumberFilterDraft;
+    /** Read the way the model parses, so `1.` matches a stored `1` and a half-typed number is never rewritten. */
+    function numberMatches(draft: NumberFilterDraft, filter: FilterValue | undefined): boolean;
+}
+export default FilterDraftUtils;

package/utils/dataGrid/headerCellUtils.d.ts

@@ -0,0 +1,50 @@
+/** Where the travelling header hover sits: each edge's distance from the same edge of the header, in px. */
+export interface HeaderHoverBounds {
+    left: number;
+    right: number;
+    top: number;
+    bottom: number;
+}
+/** The travelling hover's whole state. Physical edges, because a measured pixel has no reading order. */
+export interface HeaderHoverState {
+    bounds?: HeaderHoverBounds;
+    visible: boolean;
+    /** Shown this update from nothing, so it appears where it is rather than travelling from where it last was. */
+    entering: boolean;
+    /** Which way it last travelled: the leading edge is the fast one, which is what makes it stretch and settle. */
+    backward: boolean;
+    /** Hidden by the resizer between two cells rather than by leaving: the next cell is travelled to, not entered. */
+    paused: boolean;
+}
+/**
+ * What a header cell does with the pointer: which press sorts, and the model behind `def.headerHover:
+ * 'sliding'` — one pill that flows from the cell it was on to the one under the pointer.
+ */
+declare namespace HeaderCellUtils {
+    /** A sortable header cell: the only kind a press does anything on, and so the only kind that hovers. */
+    const CELL_SELECTOR = "[role=\"columnheader\"][aria-sort]";
+    /**
+     * Whether a press sorts: anywhere in the cell but a control inside it. Judged on where the press *began*,
+     * since a resize drag released over the cell fires its click on the cell itself.
+     */
+    function isSortPress(cell: Element, pressedOn: EventTarget | null): boolean;
+    const INITIAL: HeaderHoverState;
+    /** Whether the pointer is over a resizer, where a press resizes, so no cell hovers. */
+    function isOnResizer(target: EventTarget | null): boolean;
+    /** The hoverable cell an event landed in, if it belongs to this header. Over the resizer there is none. */
+    function cellAt(header: Element, target: EventTarget | null): HTMLElement | undefined;
+    /**
+     * The cell's box against the header's own, which is the hover's containing block — less the resizer's line
+     * where it stands inside the cell, so the pill keeps the same distance from it as the neighbour's does.
+     */
+    function bounds(header: Element, cell: Element): HeaderHoverBounds;
+    function sameBounds(a: HeaderHoverBounds | undefined, b: HeaderHoverBounds | undefined): boolean;
+    /** The next state for a pointer over `next` — a cell's bounds, or `undefined` for anywhere that does not hover. */
+    function hover(state: HeaderHoverState, next: HeaderHoverBounds | undefined): HeaderHoverState;
+    /**
+     * Over the resizer: hidden, but still on its way between two cells. The handle sits on the boundary every
+     * move from cell to cell crosses, so treating it as a leave would turn each move into an entrance.
+     */
+    function pause(state: HeaderHoverState): HeaderHoverState;
+}
+export default HeaderCellUtils;