@standardbeagle/edit-db 0.4.597 → 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/hooks/useTableExport.d.ts

@@ -10,4 +10,4 @@ import { ExportFormat, ExportResult } from '../lib/export';
  * <see cref="DEFAULT_ROW_CAP"/> bounds the drain; the result reports
  * `truncated` so the caller can warn instead of silently shipping a partial file.
  */
-export declare function useTableExport(): (table: Table, format: ExportFormat) => Promise<ExportResult>;
+export declare function useTableExport(): (table: Table, format: ExportFormat, signal?: AbortSignal) => Promise<ExportResult>;

package/dist/hooks/useTableExport.test.d.ts

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

package/dist/lib/export.d.ts

@@ -26,6 +26,8 @@ export declare const UTF8_BOM = "\uFEFF";
  * `null`/`undefined` become a bare empty field; an empty string becomes a
  * quoted empty pair (`""`) so the two stay distinguishable in the output bytes.
  * bigint and Date get exact/stable string forms; objects are JSON-encoded.
+ * String values that would execute as a spreadsheet formula are prefixed with
+ * an apostrophe.
  */
 export declare function formatCsvCell(value: unknown): string;
 export interface CsvOptions {
@@ -62,8 +64,12 @@ export interface ExportAllOptions {
      * Pull one page at the given offset. This is the ONLY data seam — the caller
      * closes over the existing fetcher/query-builder so the current filters and
      * sort are honored, and no new HTTP client is introduced.
+     *
+     * The abort signal is passed to the seam on every page — not left for each
+     * call site to close over — so cancelling reaches the IN-FLIGHT request,
+     * not just the loop's next iteration.
      */
-    fetchPage: (offset: number, limit: number) => Promise<ExportPage>;
+    fetchPage: (offset: number, limit: number, signal: AbortSignal | undefined) => Promise<ExportPage>;
     /** Page size for each fetch. Default 500. */
     pageSize?: number;
     /** Hard stop after this many rows; the result is marked `truncated`. */

package/dist/lib/format-value.d.ts

@@ -45,10 +45,19 @@ export interface FormatOptions {
 export declare function resolveDisplayFormat(column: Column, formatKey?: string): DisplayFormat | null;
 /** "4 hours ago" / "in 3 days" via Intl.RelativeTimeFormat. */
 export declare function formatRelative(date: Date, now?: Date): string;
+/**
+ * Display labels for an enum column, or null when it has none that can be
+ * trusted. `enum-labels` are positional against `enum-values`, so a count
+ * mismatch would mislabel every value; it is treated as no labels at all.
+ */
+export declare function usableEnumLabels(column: Column): string[] | null;
+/** The label for one enum value, or null when the column has no usable labels or the value is not one of them. */
+export declare function enumLabelFor(value: unknown, column: Column): string | null;
 /**
  * Format a scalar value for display, given its column. Returns a muted
- * placeholder for null/empty, a locale-formatted node for known formats (with a
- * `title` revealing the exact value), or the plain string otherwise.
+ * placeholder for null/empty, the enum label for a labelled enum value (with
+ * the stored value in `title`), a locale-formatted node for known formats (with
+ * a `title` revealing the exact value), or the plain string otherwise.
  */
 export declare function formatColumnValue(value: unknown, column: Column, options?: FormatOptions): ReactNode;
 /**

package/dist/lib/query-builder.d.ts

@@ -38,6 +38,17 @@ interface RowData {
 }
 export declare function isGraphQlName(value: unknown): value is string;
 export declare function assertGraphQlName(value: unknown, kind: string): asserts value is string;
+/**
+ * The single producer of a table's generated filter input type name.
+ *
+ * The server names it `TableFilter<graphQlName>Input`
+ * (DbTable.TableFilterTypeName, src/BifrostQL.Core/Model/DbTable.cs). Spelling
+ * it inline invites the `<graphQlName>Filter` guess, which parses fine and then
+ * fails server-side with "Unknown type '<graphQlName>Filter'." on every
+ * FILTERED request while the unfiltered path keeps working. Every builder that
+ * declares a `$filter` variable calls this, so the two sides cannot drift.
+ */
+export declare function tableFilterTypeName(table: Table): string;
 export declare function getFilterOperators(paramType: string): string[];
 /**
  * Parses the header filter (a JSON `[column, operator, value, type]` tuple carried

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.597",
+  "version": "0.4.688",
   "type": "module",
   "dependencies": {
     "@radix-ui/react-slot": "^1.2.4",
@@ -39,7 +39,7 @@
     "storybook": "^10.4.1",
     "tailwindcss": "^4.3.0",
     "typescript": "^5.9.3",
-    "vite": "^7.3.6",
+    "vite": "^8.2.2",
     "vite-plugin-dts": "^4.5.4",
     "vitest": "^4.1.8"
   },