@jini-ai/admin 0.3.0 → 0.3.6

package/dist/react/components/DataTable.d.ts

@@ -1,4 +1,5 @@
 import type { ReactNode } from 'react';
+import type { DataTableSortDirection, DataTableSortState } from '../../core/data-table/types.js';
 /**
  * @file The admin list table.
  *
@@ -12,16 +13,37 @@ import type { ReactNode } from 'react';
  *
  * What the corpus did **not** contain is just as load-bearing:
  *
- * - **No sorting.** Zero of 25.
  * - **No pagination.** Zero of 25.
  * - **No row selection.** Zero of 25 — the checkboxes that appear inside some of those tables are
  *   field controls belonging to the row's own data, not a selection model.
  *
- * None of the three is implemented here. A table component that ships sorting nobody asked for has
- * to guess at comparator semantics, controlled-vs-uncontrolled state, and multi-column precedence,
- * and every one of those guesses becomes a compatibility obligation the moment it ships. When a
- * host needs sorting, it will arrive with a real requirement attached and can be added then —
- * additively, since `columns` is already a descriptor list with somewhere to put it.
+ * Pagination and row selection stay cut for the same reason sorting originally was: nobody in the
+ * corpus asked for either, and guessing at their shape (page-size defaults, single- vs. multi-select)
+ * would be a compatibility obligation nobody has paid for yet.
+ *
+ * ## Sorting (added once two hosts needed it)
+ *
+ * Sorting **did** ship — this component's own history is the case study for the plan above. Posts
+ * and Pages both hand-rolled an identical click-to-sort header (a button, a caret, an `aria-label`
+ * carrying the accessible state) because this component had nowhere to put it, and more screens were
+ * about to make it a third and fourth copy. The three guesses the original cut worried about each
+ * resolved to something concrete once real callers existed:
+ *
+ * - **Comparator semantics** — a column that wants to sort supplies
+ *   {@link DataTableColumnSort.compare}, an ascending-order comparator exactly like `Array#sort`'s
+ *   own contract. `DataTable` negates it for `"desc"` rather than taking two functions — a column's
+ *   ordering is one relation, not two.
+ * - **Controlled vs. uncontrolled** — controlled, via {@link DataTableProps.sort} and
+ *   {@link DataTableProps.onSortChange}. `DataTable` holds no sort state of its own: direction is
+ *   transient view state the owning screen already held before this existed, and centralizing the
+ *   comparator/caret/`aria-sort` plumbing does not change who owns that state.
+ * - **Multi-column precedence** — not built. Exactly one column sorts at a time: activating a
+ *   different sortable column's header replaces the active one outright; activating the same
+ *   column's header again toggles its direction. Nobody asked for combined multi-column sort.
+ *
+ * A column that omits {@link DataTableColumn.sort} renders its `<th>` exactly as it always has — no
+ * button, no caret, no `aria-sort` — so every existing caller that never mentions sorting sees no
+ * change at all.
  *
  * `<tfoot>` appeared exactly once, so it is an optional prop rather than part of the core shape.
  *
@@ -42,8 +64,30 @@ import type { ReactNode } from 'react';
  * a wide table scroll instead of breaking the page, and it is also why `RowMenu` portals its popup
  * out to `document.body` rather than positioning inside this box.
  */
+export type { DataTableSortDirection, DataTableSortState };
+/** Enables click-to-sort on one column (`DataTableColumn.sort`). Everything a host needs to decide
+ *  is here; `DataTable` only wires the click, renders the caret, and sets `aria-sort`. */
+export interface DataTableColumnSort<Row> {
+    /** Ascending-order comparator, exactly like `Array#sort`'s own contract. `DataTable` negates its
+     *  result when the active direction is `"desc"` rather than asking for a second function — a
+     *  column's ordering is one relation, not two. Reach for `Date.parse` on an ISO-8601 **text**
+     *  column (never a plain string compare — that breaks the moment a non-`Z` UTC-offset value shows
+     *  up) and `localeCompare` for free text. */
+    compare: (a: Row, b: Row) => number;
+    /** Direction this column starts at the first time it becomes active — a click while a DIFFERENT
+     *  column was active, or the first sort of a session. Defaults to `"asc"`; override for a column
+     *  whose natural first read runs the other way, e.g. a date column's "newest first". Has no effect
+     *  on the same column's own toggle, which always flips. */
+    defaultDirection?: DataTableSortDirection;
+    /** This column's accessible name for every sort state — `direction` is `null` when a different
+     *  column is currently active. State the current state and what activating the control does next;
+     *  `DataTable` does not synthesize this from `header`, since `header` may be arbitrary markup with
+     *  no reliable plain-text form. */
+    label: (direction: DataTableSortDirection | null) => string;
+}
 export interface DataTableColumn<Row> {
-    /** Stable identity for this column. Not rendered — used as the React key. */
+    /** Stable identity for this column. Not rendered — used as the React key, and as the `column`
+     *  value in {@link DataTableSortState} when this column is sortable. */
     key: string;
     /** Header content. Omit for a column that carries no visible heading (a row-actions column);
      *  supply {@link headerLabel} when you do, so the column is still named for assistive tech. */
@@ -56,6 +100,9 @@ export interface DataTableColumn<Row> {
     headerClassName?: string;
     /** Class on this column's `<td>`. A function receives the row, for per-row variation. */
     cellClassName?: string | ((row: Row, index: number) => string | undefined);
+    /** Makes this column's header clickable to sort. Omit for a column that never sorts — its `<th>`
+     *  renders exactly as it always has, with no button, no caret, and no `aria-sort`. */
+    sort?: DataTableColumnSort<Row>;
 }
 export interface DataTableProps<Row> {
     rows: readonly Row[];
@@ -89,9 +136,24 @@ export interface DataTableProps<Row> {
     className?: string;
     /** Appended to `.table-scroll`. */
     scrollClassName?: string;
+    /**
+     * Controlled sort state: the active column's `key` plus direction, or `null`/`undefined` for "no
+     * column is the active sort". `DataTable` never derives or persists this itself — sort direction
+     * is transient view state the owning screen already held before this existed; centralizing the
+     * comparator/caret/`aria-sort` plumbing here does not change who owns that state.
+     */
+    sort?: DataTableSortState | null;
+    /**
+     * Called with the state a header click produces. Activating a different sortable column's header
+     * replaces `sort` outright (single active column — no multi-column precedence); activating the
+     * already-active column's header toggles its direction. `DataTable` computes the next value; the
+     * host only stores it and passes it back as `sort`.
+     */
+    onSortChange?: (next: DataTableSortState) => void;
 }
 /**
- * @complexity O(rows × columns) per render — one pass, no sorting or grouping work.
+ * @complexity O(rows × columns) per render for cell rendering, same as always; see
+ * {@link sortedTableRows} for the one added cost, paid only when `sort` names an active column.
  */
 export declare function DataTable<Row>(props: DataTableProps<Row>): import("react").JSX.Element;
 //# sourceMappingURL=DataTable.d.ts.map

package/dist/react/components/DataTable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DataTable.d.ts","sourceRoot":"","sources":["../../../src/react/components/DataTable.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,MAAM,WAAW,eAAe,CAAC,GAAG;IAClC,6EAA6E;IAC7E,GAAG,EAAE,MAAM,CAAC;IACZ;mGAC+F;IAC/F,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IAC7C,qCAAqC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yFAAyF;IACzF,aAAa,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,cAAc,CAAC,GAAG;IACjC,IAAI,EAAE,SAAS,GAAG,EAAE,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C;;2DAEuD;IACvD,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;qBAGiB;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,wEAAwE;IACxE,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,2FAA2F;IAC3F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;4BACwB;IACxB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,sEAAsE;IACtE,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC/D,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAYD;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,KAAK,EAAE,cAAc,CAAC,GAAG,CAAC,+BAwCxD"}
+{"version":3,"file":"DataTable.d.ts","sourceRoot":"","sources":["../../../src/react/components/DataTable.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEjG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AAIH,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,CAAC;AAE3D;0FAC0F;AAC1F,MAAM,WAAW,mBAAmB,CAAC,GAAG;IACtC;;;;iDAI6C;IAC7C,OAAO,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,KAAK,MAAM,CAAC;IACpC;;;+DAG2D;IAC3D,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C;;;uCAGmC;IACnC,KAAK,EAAE,CAAC,SAAS,EAAE,sBAAsB,GAAG,IAAI,KAAK,MAAM,CAAC;CAC7D;AAED,MAAM,WAAW,eAAe,CAAC,GAAG;IAClC;4EACwE;IACxE,GAAG,EAAE,MAAM,CAAC;IACZ;mGAC+F;IAC/F,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IAC7C,qCAAqC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yFAAyF;IACzF,aAAa,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC,CAAC;IAC3E;0FACsF;IACtF,IAAI,CAAC,EAAE,mBAAmB,CAAC,GAAG,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,cAAc,CAAC,GAAG;IACjC,IAAI,EAAE,SAAS,GAAG,EAAE,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C;;2DAEuD;IACvD,MAAM,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;qBAGiB;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,wEAAwE;IACxE,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,2FAA2F;IAC3F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;4BACwB;IACxB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,sEAAsE;IACtE,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC/D,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACjC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;CACnD;AAmED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,KAAK,EAAE,cAAc,CAAC,GAAG,CAAC,+BAiExD"}

package/dist/react/components/DataTable.js

@@ -5,7 +5,56 @@ function resolveCellClassName(column, row, index) {
         : column.cellClassName;
 }
 /**
- * @complexity O(rows × columns) per render — one pass, no sorting or grouping work.
+ * `rows` in display order: unchanged when there is no active sort, or the active column declares no
+ * `sort` of its own (defensive against a stale `sort.column` naming a column that no longer exists,
+ * or never did). A fresh array is only allocated on the path that actually sorts, so the 20+ callers
+ * with no `sort` prop at all pay nothing beyond the `Array#find`.
+ *
+ * @complexity O(columns) to find the active column, plus O(n log n) in `rows.length` when it has a
+ * comparator; O(1)/no allocation otherwise.
+ */
+function sortedTableRows(rows, columns, sort) {
+    const activeColumn = sort ? columns.find((column) => column.key === sort.column) : undefined;
+    if (!sort || !activeColumn?.sort)
+        return rows;
+    const sign = sort.direction === 'asc' ? 1 : -1;
+    const { compare } = activeColumn.sort;
+    return [...rows].sort((a, b) => sign * compare(a, b));
+}
+/**
+ * The sort state a click on `column`'s header produces: toggles direction when `column` is already
+ * active, otherwise switches to it at its own {@link DataTableColumnSort.defaultDirection}.
+ *
+ * @complexity Time/space: O(1).
+ */
+function nextSortState(current, column) {
+    if (current?.column === column.key) {
+        return { column: column.key, direction: current.direction === 'asc' ? 'desc' : 'asc' };
+    }
+    return { column: column.key, direction: column.sort?.defaultDirection ?? 'asc' };
+}
+/** The `aria-sort` value for a sortable `<th>` — the APG table-sorting pattern's `"none"` for a
+ *  sortable-but-currently-inactive column, so assistive tech still discovers it is sortable. */
+function ariaSortValue(direction) {
+    if (direction === 'asc')
+        return 'ascending';
+    if (direction === 'desc')
+        return 'descending';
+    return 'none';
+}
+/** The caret glyph for a sortable header. `"⇅"` — a neutral, always-visible both-direction glyph —
+ *  when `direction` is `null` (not the active sort), so an unsorted column still visibly reads as
+ *  clickable rather than only revealing that fact after the first click; `"▲"`/`"▼"` once it is.
+ *  `aria-hidden` at the call site: the real accessible state is the button's `aria-label` plus the
+ *  `<th>`'s own `aria-sort`, not this glyph. */
+function sortCaretGlyph(direction) {
+    if (direction === null)
+        return ' ⇅';
+    return direction === 'asc' ? ' ▲' : ' ▼';
+}
+/**
+ * @complexity O(rows × columns) per render for cell rendering, same as always; see
+ * {@link sortedTableRows} for the one added cost, paid only when `sort` names an active column.
  */
 export function DataTable(props) {
     // Loading wins over empty deliberately: `rows` is legitimately `[]` during a first fetch, and
@@ -15,6 +64,13 @@ export function DataTable(props) {
         return _jsx(_Fragment, { children: props.loadingContent });
     if (!props.loading && props.rows.length === 0 && props.empty !== undefined)
         return _jsx(_Fragment, { children: props.empty });
-    return (_jsx("div", { className: ['table-scroll', props.scrollClassName].filter(Boolean).join(' '), children: _jsxs("table", { className: ['list-table', props.className].filter(Boolean).join(' '), "aria-label": props.label, children: [props.caption === undefined ? null : _jsx("caption", { children: props.caption }), _jsx("thead", { children: _jsx("tr", { children: props.columns.map((column) => (_jsx("th", { scope: "col", className: column.headerClassName, "aria-label": column.header === undefined ? column.headerLabel : undefined, children: column.header }, column.key))) }) }), _jsx("tbody", { children: props.rows.map((row, index) => (_jsx("tr", { className: props.rowClassName?.(row, index), children: props.columns.map((column) => (_jsx("td", { className: resolveCellClassName(column, row, index), children: column.cell(row, index) }, column.key))) }, props.rowKey(row, index)))) }), props.footer === undefined ? null : _jsx("tfoot", { children: props.footer })] }) }));
+    const rows = sortedTableRows(props.rows, props.columns, props.sort);
+    return (_jsx("div", { className: ['table-scroll', props.scrollClassName].filter(Boolean).join(' '), children: _jsxs("table", { className: ['list-table', props.className].filter(Boolean).join(' '), "aria-label": props.label, children: [props.caption === undefined ? null : _jsx("caption", { children: props.caption }), _jsx("thead", { children: _jsx("tr", { children: props.columns.map((column) => {
+                            if (!column.sort) {
+                                return (_jsx("th", { scope: "col", className: column.headerClassName, "aria-label": column.header === undefined ? column.headerLabel : undefined, children: column.header }, column.key));
+                            }
+                            const direction = props.sort?.column === column.key ? props.sort.direction : null;
+                            return (_jsx("th", { scope: "col", className: column.headerClassName, "aria-sort": ariaSortValue(direction), children: _jsxs("button", { type: "button", className: "sortable-column-header", onClick: () => props.onSortChange?.(nextSortState(props.sort, column)), "aria-label": column.sort.label(direction), children: [column.header, _jsx("span", { "aria-hidden": "true", children: sortCaretGlyph(direction) })] }) }, column.key));
+                        }) }) }), _jsx("tbody", { children: rows.map((row, index) => (_jsx("tr", { className: props.rowClassName?.(row, index), children: props.columns.map((column) => (_jsx("td", { className: resolveCellClassName(column, row, index), children: column.cell(row, index) }, column.key))) }, props.rowKey(row, index)))) }), props.footer === undefined ? null : _jsx("tfoot", { children: props.footer })] }) }));
 }
 //# sourceMappingURL=DataTable.js.map

package/dist/react/components/DataTable.js.map

@@ -1 +1 @@
-{"version":3,"file":"DataTable.js","sourceRoot":"","sources":["../../../src/react/components/DataTable.tsx"],"names":[],"mappings":";AAgGA,SAAS,oBAAoB,CAC3B,MAA4B,EAC5B,GAAQ,EACR,KAAa;IAEb,OAAO,OAAO,MAAM,CAAC,aAAa,KAAK,UAAU;QAC/C,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC;QAClC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAM,KAA0B;IACvD,8FAA8F;IAC9F,6FAA6F;IAC7F,SAAS;IACT,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,cAAc,KAAK,SAAS;QAAE,OAAO,4BAAG,KAAK,CAAC,cAAc,GAAI,CAAC;IAC5F,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,4BAAG,KAAK,CAAC,KAAK,GAAI,CAAC;IAEtG,OAAO,CACL,cAAK,SAAS,EAAE,CAAC,cAAc,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAC/E,iBAAO,SAAS,EAAE,CAAC,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAc,KAAK,CAAC,KAAK,aACjG,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,4BAAU,KAAK,CAAC,OAAO,GAAW,EACxE,0BACE,uBACG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAC7B,aAEE,KAAK,EAAC,KAAK,EACX,SAAS,EAAE,MAAM,CAAC,eAAe,gBACrB,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,YAEvE,MAAM,CAAC,MAAM,IALT,MAAM,CAAC,GAAG,CAMZ,CACN,CAAC,GACC,GACC,EACR,0BACG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAC9B,aAAmC,SAAS,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,YAC3E,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAC7B,aAAqB,SAAS,EAAE,oBAAoB,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,YACrE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IADjB,MAAM,CAAC,GAAG,CAEd,CACN,CAAC,IALK,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAM5B,CACN,CAAC,GACI,EACP,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,0BAAQ,KAAK,CAAC,MAAM,GAAS,IAC5D,GACJ,CACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"DataTable.js","sourceRoot":"","sources":["../../../src/react/components/DataTable.tsx"],"names":[],"mappings":"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"}

package/dist/react/index.d.ts

@@ -39,7 +39,7 @@ export { ConfirmDialog } from './components/ConfirmDialog/ConfirmDialog.js';
 export type { ConfirmDialogProps } from './components/ConfirmDialog/ConfirmDialog.js';
 export type { ConfirmDialogController, UseConfirmDialog } from './components/ConfirmDialog/ConfirmDialog.hooks.js';
 export { DataTable } from './components/DataTable.js';
-export type { DataTableColumn, DataTableProps } from './components/DataTable.js';
+export type { DataTableColumn, DataTableColumnSort, DataTableProps, DataTableSortDirection, DataTableSortState, } from './components/DataTable.js';
 export { InteractiveHtmlEditor } from './components/InteractiveHtmlEditor/InteractiveHtmlEditor.js';
 export type { InteractiveHtmlEditorProps } from './components/InteractiveHtmlEditor/InteractiveHtmlEditor.js';
 export { RowMenu } from './components/RowMenu/RowMenu.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAIH,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxD,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAC5E,YAAY,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AAEtF,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAC5E,YAAY,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AAGtF,YAAY,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AAInH,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAKjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AACpG,YAAY,EAAE,0BAA0B,EAAE,MAAM,6DAA6D,CAAC;AAE9G,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAC1D,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAKjF,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC9D,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,EACf,YAAY,EACZ,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,gCAAgC,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC/F,YAAY,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,gCAAgC,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC/F,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAIH,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxD,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAC5E,YAAY,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AAEtF,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAC5E,YAAY,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AAGtF,YAAY,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,mDAAmD,CAAC;AAKnH,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAKnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AACpG,YAAY,EAAE,0BAA0B,EAAE,MAAM,6DAA6D,CAAC;AAE9G,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAC1D,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAKjF,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC9D,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,EACf,YAAY,EACZ,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,gCAAgC,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC/F,YAAY,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,gCAAgC,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC/F,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/react/index.js

@@ -36,8 +36,9 @@
 export { resolveTone, toneClassName } from './types.js';
 export { ConfirmButton } from './components/ConfirmButton/ConfirmButton.js';
 export { ConfirmDialog } from './components/ConfirmDialog/ConfirmDialog.js';
-// The list table. Deliberately has no sorting, pagination or row selection — see its file header
-// for the corpus evidence behind each omission.
+// The list table. Sorting is opt-in per column (`DataTableColumn.sort`); pagination and row
+// selection are still deliberately absent — see its file header for the corpus evidence behind
+// every one of these decisions.
 export { DataTable } from './components/DataTable.js';
 // Visual click-into-text editing surface for a bespoke HTML document, built on GrapesJS. See its
 // own file header for the styling-contract exception it carries (vendor CSS import) and the

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,gGAAgG;AAChG,kDAAkD;AAClD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGxD,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAG5E,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAM5E,iGAAiG;AACjG,gDAAgD;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAGtD,iGAAiG;AACjG,4FAA4F;AAC5F,wCAAwC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AAGpG,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAG1D,qGAAqG;AACrG,iGAAiG;AACjG,uFAAuF;AACvF,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAW9D,OAAO,EAAE,gCAAgC,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE/F,OAAO,EAAE,gCAAgC,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,gGAAgG;AAChG,kDAAkD;AAClD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGxD,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAG5E,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAM5E,4FAA4F;AAC5F,+FAA+F;AAC/F,gCAAgC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAStD,iGAAiG;AACjG,4FAA4F;AAC5F,wCAAwC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AAGpG,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAG1D,qGAAqG;AACrG,iGAAiG;AACjG,uFAAuF;AACvF,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAW9D,OAAO,EAAE,gCAAgC,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE/F,OAAO,EAAE,gCAAgC,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jini-ai/admin",
-  "version": "0.3.0",
+  "version": "0.3.6",
   "description": "Composable admin surface for Jini-hosted products: framework-free contracts, panel registry, and route model in `/core`; React shell and panels in `/react`. Import only the layers you need.",
   "license": "Apache-2.0",
   "repository": {
@@ -80,8 +80,8 @@
     "react-dom": "^19.2.0"
   },
   "dependencies": {
-    "@jini-ai/agentic": "0.3.0",
-    "@jini-ai/ui": "0.3.0"
+    "@jini-ai/ui": "0.3.6",
+    "@jini-ai/agentic": "0.3.0"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",