@standardbeagle/edit-db 0.4.685 → 0.4.688

package/dist/hooks/useDataTable.d.ts

@@ -1,3 +1,4 @@
+import { DefaultSort } from './useEditorConfig';
 import { Table, Column, Join } from '../types/schema';
 import { ColumnDef, ColumnFiltersState, SortingState } from '@tanstack/react-table';
 import { DrillFrame } from '../lib/drill-stack';
@@ -129,4 +130,12 @@ interface UseDataTableResult {
  * @param onOpenColumn - Callback when opening a side panel column
  * @returns Data table state and control functions
  */
+/**
+ * The sort a grid opens with, from the host's `defaultSort` config: the table's
+ * own entry wins over `"*"`. Empty when nothing is configured, when the named
+ * column is not on the table, or when it cannot drive an ORDER BY (blob/JSON),
+ * so the caller falls back to its positional default instead of erroring the
+ * first query.
+ */
+export declare function resolveConfiguredSort(table: Table | null, defaultSort: Record<string, DefaultSort> | undefined): SortingState;
 export declare function useDataTable(table: Table | null, id?: string, filterTable?: string, filterColumn?: string, onExpandContent?: (rowIndex: number, columnName: string) => void, onOpenColumn?: (panel: DrillFrame) => void): UseDataTableResult;

package/dist/hooks/useEditorConfig.d.ts

@@ -1,5 +1,10 @@
 import { ReactNode } from 'react';
 import { TableAction } from '../lib/table-action';
+/** One configured grid sort: the column name and its direction (ascending unless `desc`). */
+export interface DefaultSort {
+    column: string;
+    desc?: boolean;
+}
 /**
  * Optional, opt-in editor features. Kept tiny and separate from the data/schema
  * contexts so feature flags don't force those providers to re-render and so
@@ -32,6 +37,19 @@ export interface EditorConfig {
      * annotate but sit in the middle of the natural column order.
      */
     trailingColumns?: string[];
+    /**
+     * Sort a grid opens with, keyed by table name; `"*"` covers every table
+     * without its own entry. Resolved by `resolveConfiguredSort` in
+     * useDataTable, which drops an entry naming a column the table lacks or
+     * cannot ORDER BY, so a host-wide `id desc` is safe on keyless tables.
+     */
+    defaultSort?: Record<string, DefaultSort>;
+    /**
+     * Column the header quick-search starts on, keyed by table name. Applied by
+     * the header only when the column is one it can search (string/numeric);
+     * anything else falls back to the first searchable column.
+     */
+    defaultSearchColumns?: Record<string, string>;
     /**
      * Host-contributed actions on each table in the navigation list, rendered in
      * the table's kebab menu AFTER the built-in Download actions. The host owns

package/dist/lib/search-column.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Which column the header quick-search starts on. The host's configured column
+ * for the table wins when it is one of the searchable options; otherwise the
+ * first option, so a table with no configuration behaves as before. Returns the
+ * option's `value` (the `name,paramType` pair the header keys its picker by).
+ */
+export declare function pickDefaultSearchColumn(options: ReadonlyArray<{
+    key: string;
+    value: string;
+}> | undefined, configured: string | undefined): string;

package/dist/lib/search-column.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@standardbeagle/edit-db",
   "private": false,
-  "version": "0.4.685",
+  "version": "0.4.688",
   "type": "module",
   "dependencies": {
     "@radix-ui/react-slot": "^1.2.4",