@adecore/database 0.23.1 → 0.24.1

package/README.md

@@ -107,7 +107,7 @@ The words live in the `database` namespace, in English and Dutch. `DatabaseProvi
 
 ## The helper binary
 
-The helper is a Rust program that holds the database drivers, so a crashing driver cannot take the backend down. The install brings a prebuilt one: `@adecore/database` lists a package per platform as an optional dependency (`@adecore/database-darwin-arm64` for Apple silicon, `-linux-x64`, `-linux-arm64` and `-win32-x64`), and the package manager installs the one that fits the machine. `helperPath()` returns its path, or `null` when the platform has no package or optional dependencies were left out.
+The helper is a Rust program that holds the database drivers, so a crashing driver cannot take the backend down. The install brings a prebuilt one: `@adecore/database` lists a package per platform as an optional dependency (`@adecore/database-darwin-arm64` for Apple silicon, `-linux-x64`, `-linux-arm64` and `-win32-x64`), and the package manager installs the one that fits the machine. `helperPath()` returns its path, or `null` when the platform has no package or optional dependencies were left out. `ADECORE_DATABASE_HELPER` overrides it with the path of another build.
 
 ```ts
 import { createDatabaseHost, helperPath, spawnHelper } from '@adecore/database/host';
@@ -127,7 +127,7 @@ The Linux binaries link against glibc 2.35 or newer. An app that wants its own b
 cargo build --release --locked --manifest-path helper/Cargo.toml
 ```
 
-The binary is `helper/target/release/adecore-database`.
+The binary is `helper/target/release/adecore-database`. When the package runs from the `src` of this checkout, such as through `bun link`, and no platform package has a binary, `helperPath()` returns that build.
 
 ### In an Electron app
 

package/dist/client/client.js

@@ -35,6 +35,8 @@ const raceAbort = (promise, signal) => {
 export const createDatabaseClient = (transport, options = {}) => {
     const createId = options.createId ?? (() => crypto.randomUUID());
     const live = new Map();
+    // Every session that opened on the helper and has not closed, also one a newer session replaced on its channel.
+    const held = new Set();
     const schemaListeners = new Set();
     const channelsOf = (connectionId) => {
         let channels = live.get(connectionId);
@@ -55,7 +57,8 @@ export const createDatabaseClient = (transport, options = {}) => {
             }
         }
     };
-    const send = async (method, params, signal) => {
+    /* With `settles`, an abort sends the cancel and waits for the answer, which can still carry what ran. */
+    const send = async (method, params, signal, settles = false) => {
         if (signal?.aborted) {
             throw cancelledError();
         }
@@ -64,8 +67,15 @@ export const createDatabaseClient = (transport, options = {}) => {
         return new Promise((resolve, reject) => {
             const onAbort = () => {
                 const cancel = { id: createId(), method: 'cancel', params: { request: id } };
-                new Promise((done) => done(transport(cancel))).catch(() => { });
-                reject(cancelledError());
+                const cancelling = new Promise((done) => done(transport(cancel)));
+                if (settles) {
+                    // Without a cancel on its way, nothing tells the request to stop, so its answer may never come.
+                    cancelling.catch(() => reject(cancelledError()));
+                }
+                else {
+                    cancelling.catch(() => { });
+                    reject(cancelledError());
+                }
             };
             signal?.addEventListener('abort', onAbort, { once: true });
             new Promise((done) => done(transport(request)))
@@ -97,6 +107,7 @@ export const createDatabaseClient = (transport, options = {}) => {
                 return Promise.resolve(opened);
             }
             track();
+            held.add(created);
             opening ??= send('open', { connection: connection.config })
                 .then((result) => (opened = result))
                 .finally(() => {
@@ -105,14 +116,14 @@ export const createDatabaseClient = (transport, options = {}) => {
             return opening;
         };
         /* Reads are safe to send twice, so they open again and retry once; a write is not, so it only drops the session. */
-        const request = async (method, build, requestOptions, retry) => {
+        const request = async (method, build, requestOptions, retry, settles = false) => {
             const signal = requestOptions?.signal;
             if (signal?.aborted) {
                 throw cancelledError();
             }
             const current = await raceAbort(open(), signal);
             try {
-                return await send(method, build(current.session), signal);
+                return await send(method, build(current.session), signal, settles);
             }
             catch (error) {
                 if (!isUnknownSession(error)) {
@@ -122,7 +133,7 @@ export const createDatabaseClient = (transport, options = {}) => {
                     opened = null;
                 }
                 if (retry) {
-                    return request(method, build, requestOptions, false);
+                    return request(method, build, requestOptions, false, settles);
                 }
                 throw error;
             }
@@ -135,6 +146,7 @@ export const createDatabaseClient = (transport, options = {}) => {
                     live.delete(connection.id);
                 }
             }
+            held.delete(created);
             const current = opened ?? (opening === null ? null : await opening.catch(() => null));
             opened = null;
             if (current !== null) {
@@ -172,7 +184,7 @@ export const createDatabaseClient = (transport, options = {}) => {
             },
             async execute(sql, executeOptions) {
                 const { signal: _signal, ...rest } = executeOptions ?? {};
-                const result = await request('execute', (id) => ({ session: id, sql, ...rest }), executeOptions, false);
+                const result = await request('execute', (id) => ({ session: id, sql, ...rest }), executeOptions, false, true);
                 if (result.results.some((item) => item.kind !== 'error' && changesSchema(item.sql))) {
                     notifySchemaChange({ connectionId: connection.id, ...(rest.schema === undefined ? {} : { schema: rest.schema }) });
                 }
@@ -231,14 +243,22 @@ export const createDatabaseClient = (transport, options = {}) => {
             return created.session;
         },
         async disconnect(connectionId) {
-            const existing = [...(live.get(connectionId)?.values() ?? [])];
+            const existing = new Set(live.get(connectionId)?.values());
+            for (const entry of held) {
+                if (entry.session.connection.id === connectionId) {
+                    existing.add(entry);
+                }
+            }
             live.delete(connectionId);
-            await Promise.all(existing.map((entry) => entry.close()));
+            await Promise.all([...existing].map((entry) => entry.close()));
         },
         async dispose() {
-            const all = [...live.values()].flatMap((channels) => [...channels.values()]);
+            const all = new Set([...live.values()].flatMap((channels) => [...channels.values()]));
+            for (const entry of held) {
+                all.add(entry);
+            }
             live.clear();
-            await Promise.all(all.map((entry) => entry.close()));
+            await Promise.all([...all].map((entry) => entry.close()));
         }
     };
 };

package/dist/client/types.d.ts

@@ -19,11 +19,13 @@ export interface RowsQuery {
     readonly offset: number;
     readonly limit: number;
     readonly cellLimit?: number;
+    readonly maxBytes?: number;
 }
 export interface ExecuteOptions extends RequestOptions {
     readonly schema?: string;
     readonly limit?: number;
     readonly cellLimit?: number;
+    readonly maxBytes?: number;
 }
 export interface DatabaseSession {
     readonly connection: Connection;
@@ -51,6 +53,7 @@ export interface PageQuery {
     readonly offset: number;
     readonly limit: number;
     readonly cellLimit?: number;
+    readonly maxBytes?: number;
 }
 export interface ExportRequest {
     readonly source: ExportSource;

package/dist/console/QueryConsole.js

@@ -179,11 +179,8 @@ export function QueryConsole({ connection, schema, onSchemaChange, value, defaul
             if (mode === 'manual' && !inTransaction) {
                 setInTransaction(await session.transaction('begin', { signal: controller.signal }));
             }
+            // A cancel that stopped the run midway still answers what ran and whether a transaction stayed open.
             const executed = await session.execute(target, { schema: activeSchema, limit: PAGE_SIZE, signal: controller.signal });
-            if (controller.signal.aborted) {
-                setRun({ status: 'cancelled' });
-                return;
-            }
             setInTransaction(executed.inTransaction);
             setTab(0);
             setPages({});
@@ -246,7 +243,7 @@ export function QueryConsole({ connection, schema, onSchemaChange, value, defaul
             setMode(next);
         }
     };
-    const loadPage = async (index, result, offset) => {
+    const loadPage = async (index, result, offset, before) => {
         if (session === null) {
             return;
         }
@@ -256,7 +253,7 @@ export function QueryConsole({ connection, schema, onSchemaChange, value, defaul
         try {
             const rows = await session.page(result.sql, { schema: activeSchema, offset, limit: PAGE_SIZE });
             if (generation.current === mine) {
-                setPages((current) => ({ ...current, [index]: { offset, rows } }));
+                setPages((current) => ({ ...current, [index]: { offset, rows, before } }));
             }
         }
         catch (error) {
@@ -291,12 +288,13 @@ export function QueryConsole({ connection, schema, onSchemaChange, value, defaul
     const page = pages[index];
     const shown = base?.kind === 'rows' && page !== undefined ? { kind: 'rows', sql: base.sql, ...page.rows } : base;
     const offset = page?.offset ?? 0;
+    const before = page?.before ?? [];
     const pager = base?.kind === 'rows' && shown?.kind === 'rows' && engine !== undefined && isPageable(base.sql, engine) && (shown.hasMore || offset > 0)
         ? {
-            page: offset / PAGE_SIZE + 1,
+            page: before.length + 1,
             loading: paging,
-            onPrevious: () => void loadPage(index, base, Math.max(0, offset - PAGE_SIZE)),
-            onNext: () => void loadPage(index, base, offset + PAGE_SIZE)
+            onPrevious: () => void loadPage(index, base, before.at(-1) ?? 0, before.slice(0, -1)),
+            onNext: () => void loadPage(index, base, offset + shown.rows.length, [...before, offset])
         }
         : undefined;
     const exportBase = files !== undefined && base?.kind === 'rows' ? base : undefined;
@@ -312,7 +310,7 @@ export function QueryConsole({ connection, schema, onSchemaChange, value, defaul
         placeholder: t('console.placeholder'),
         autoFocus
     };
-    return (_jsxs("div", { ref: ref, className: clsx('flex min-h-0 flex-col bg-surface text-text', className), children: [_jsxs("div", { className: "flex min-h-0 flex-1", children: [_jsxs("div", { className: "flex min-w-0 flex-1 flex-col", children: [_jsxs("div", { className: "flex shrink-0 flex-wrap items-center gap-2 border-b border-border px-3 py-2", children: [session !== null && (_jsxs(_Fragment, { children: [_jsx(RunButtons, { running: run.status === 'running', disabled: blank || busy, onCancel: () => running.current?.abort(), onRun: (scope) => requestRun(targetOf(scope)) }), _jsx(TransactionControls, { mode: mode, onModeChange: changeMode, open: inTransaction, busy: busy, onCommit: () => void settle('commit'), onRollback: () => void settle('rollback') })] })), _jsxs("div", { className: "ml-auto flex items-center gap-2", children: [toolbarEnd, session !== null && schemas.length > 0 && (_jsx(SchemaPicker, { schemas: schemas, value: activeSchema ?? null, disabled: busy, onValueChange: onSchemaChange ?? setPickedSchema })), session !== null && (_jsxs(Button, { variant: "secondary", size: "sm", "aria-pressed": historyOpen, className: "aria-pressed:bg-surface-active aria-pressed:text-text", onClick: () => setHistoryOpen(!historyOpen), children: [_jsx(Icon, { icon: History, size: 12 }), t('console.history.title')] }))] })] }), _jsx("div", { className: clsx('flex min-h-0 flex-1 flex-col', renderEditor === undefined && 'p-3'), children: renderEditor === undefined ? _jsx(SqlEditor, { ...editorProps }) : _jsx(AppEditor, { render: renderEditor, ...editorProps }) })] }), session !== null && historyOpen && _jsx(HistoryPanel, { entries: history.entries, onPick: pickHistory, onClear: history.clear })] }), session !== null && notice !== null && (_jsx(Banner, { icon: notice.tone === 'error' ? CircleAlert : Check, tone: notice.tone === 'error' ? 'error' : 'neutral', message: notice.description ?? notice.title, className: "shrink-0 pb-2", children: _jsx(Button, { size: "xs", onClick: () => setNotice(null), children: t('console.dismiss') }) })), session !== null && resultsOpen && (_jsxs("section", { ref: resultsPane, "aria-label": t('console.results'), className: "relative flex min-h-24 shrink-0 flex-col border-t border-border", style: { height: resultsHeight ?? '50%', maxHeight: `calc(100% - ${MIN_EDITOR_HEIGHT}px)` }, children: [_jsx(ColumnResizeHandle, { from: "bottom", onPointerDown: startResize }), _jsx(Tabs.Root, { value: index, onValueChange: (next) => setTab(Number(next)), children: _jsx(Tabs.List, { "aria-label": t('console.results'), className: "shrink-0 pr-1.5 pl-3", end: _jsx(IconButton, { icon: X, size: "sm", label: t('console.closeResults'), onClick: () => setResultsOpen(false) }), children: results.map((result, position) => (_jsx(Tabs.Tab, { value: position, children: statementLabel(result.sql) }, position))) }) }), run.status === 'failed' && _jsx(Banner, { icon: CircleAlert, tone: "error", message: run.message, className: "shrink-0 pt-2" }), run.status === 'cancelled' && _jsx(Banner, { icon: CircleAlert, tone: "neutral", message: t('console.cancelled'), className: "shrink-0 pt-2" }), shown !== undefined && (_jsx(StatementResultView, { result: shown, offset: offset, pager: pager, onExport: exportBase === undefined ? undefined : (format) => void exportResult(exportBase, format), exporting: exporting, engine: engine, valuePanelOpen: panelOpen, onValuePanelOpenChange: setPanelOpen, keys: keys, onFollowReference: act === undefined || connection === undefined
+    return (_jsxs("div", { ref: ref, className: clsx('flex min-h-0 flex-col bg-surface text-text', className), children: [_jsxs("div", { className: "flex min-h-0 flex-1", children: [_jsxs("div", { className: "flex min-w-0 flex-1 flex-col", children: [_jsxs("div", { className: "flex shrink-0 flex-wrap items-center gap-2 border-b border-border px-3 py-2", children: [session !== null && (_jsxs(_Fragment, { children: [_jsx(RunButtons, { running: run.status === 'running', disabled: blank || busy, onCancel: () => running.current?.abort(), onRun: (scope) => requestRun(targetOf(scope)) }), _jsx(TransactionControls, { mode: mode, onModeChange: changeMode, open: inTransaction, busy: busy, onCommit: () => void settle('commit'), onRollback: () => void settle('rollback') })] })), _jsxs("div", { className: "ml-auto flex items-center gap-2", children: [toolbarEnd, session !== null && schemas.length > 0 && (_jsx(SchemaPicker, { schemas: schemas, value: activeSchema ?? null, disabled: busy, onValueChange: onSchemaChange ?? setPickedSchema })), session !== null && (_jsxs(Button, { variant: "secondary", size: "sm", "aria-pressed": historyOpen, className: "aria-pressed:bg-surface-active aria-pressed:text-text", onClick: () => setHistoryOpen(!historyOpen), children: [_jsx(Icon, { icon: History, size: 12 }), t('console.history.title')] }))] })] }), _jsx("div", { className: clsx('flex min-h-0 flex-1 flex-col', renderEditor === undefined && 'p-3'), children: renderEditor === undefined ? _jsx(SqlEditor, { ...editorProps }) : _jsx(AppEditor, { render: renderEditor, ...editorProps }) })] }), session !== null && historyOpen && _jsx(HistoryPanel, { entries: history.entries, onPick: pickHistory, onClear: history.clear })] }), session !== null && notice !== null && (_jsx(Banner, { icon: notice.tone === 'error' ? CircleAlert : Check, tone: notice.tone === 'error' ? 'error' : 'neutral', message: notice.description ?? notice.title, className: "shrink-0 pb-2", children: _jsx(Button, { size: "xs", onClick: () => setNotice(null), children: t('console.dismiss') }) })), session !== null && resultsOpen && (_jsxs("section", { ref: resultsPane, "aria-label": t('console.results'), className: "relative flex min-h-24 shrink-0 flex-col border-t border-border", style: { height: resultsHeight ?? '50%', maxHeight: `calc(100% - ${MIN_EDITOR_HEIGHT}px)` }, children: [_jsx(ColumnResizeHandle, { from: "bottom", onPointerDown: startResize }), _jsx(Tabs.Root, { value: index, onValueChange: (next) => setTab(Number(next)), children: _jsx(Tabs.List, { "aria-label": t('console.results'), className: "shrink-0 pr-1.5 pl-3", end: _jsx(IconButton, { icon: X, size: "sm", label: t('console.closeResults'), onClick: () => setResultsOpen(false) }), children: results.map((result, position) => (_jsx(Tabs.Tab, { value: position, children: statementLabel(result.sql) }, position))) }) }), run.status === 'failed' && _jsx(Banner, { icon: CircleAlert, tone: "error", message: run.message, className: "shrink-0 pt-2" }), run.status === 'cancelled' && _jsx(Banner, { icon: CircleAlert, tone: "neutral", message: t('console.cancelled'), className: "shrink-0 pt-2" }), shown !== undefined && (_jsx(StatementResultView, { result: shown, offset: offset, pager: pager, onExport: exportBase === undefined ? undefined : (format) => void exportResult(exportBase, format), exporting: exporting, engine: engine, valuePanelOpen: panelOpen, onValuePanelOpenChange: setPanelOpen, keys: keys, onNotice: notify, onFollowReference: act === undefined || connection === undefined
                             ? undefined
                             : (reference) => act({
                                 kind: 'open-table',

package/dist/console/SqlEditor.js

@@ -1,10 +1,10 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { useEffect, useImperativeHandle, useRef } from 'react';
 import clsx from 'clsx';
-import { isApplePlatform, matchesShortcut, TextArea } from '@adecore/ui';
+import { isApplePlatform, TextArea } from '@adecore/ui';
 import { CODE_TEXT } from '../code-text.js';
 import { applyEdit, indentEdit, newlineEdit, outdentEdit } from './editing.js';
-import { RUN_ALL_SHORTCUT, RUN_SHORTCUT } from './shortcuts.js';
+import { runScopeOf } from './shortcuts.js';
 /*
  * Where the SQL is typed when the app brings no editor of its own: a plain text area that fills the
  * height it gets, with the same props an editor of the app receives.
@@ -40,15 +40,10 @@ export function SqlEditor({ ref, value, onValueChange, run, label, placeholder,
         onValueChange(applyEdit(before, edit));
     };
     const handleKeyDown = (event) => {
-        const apple = isApplePlatform();
-        if (matchesShortcut(RUN_ALL_SHORTCUT, event, apple)) {
+        const scope = runScopeOf(event, isApplePlatform());
+        if (scope !== null) {
             event.preventDefault();
-            run('all');
-            return;
-        }
-        if (matchesShortcut(RUN_SHORTCUT, event, apple)) {
-            event.preventDefault();
-            run('selection-or-statement');
+            run(scope);
             return;
         }
         if (event.nativeEvent.isComposing || event.metaKey || event.ctrlKey || event.altKey) {

package/dist/console/StatementResultView.d.ts

@@ -1,3 +1,4 @@
+import type { DatabaseNotice } from '../actions.ts';
 import type { Engine, FileFormat, StatementResult } from '../protocol/index.ts';
 import type { Reference } from '../table/references.ts';
 import type { ResultKeys } from './result-keys.ts';
@@ -18,5 +19,6 @@ export interface StatementResultViewProps {
     onValuePanelOpenChange?(open: boolean): void;
     keys?: ResultKeys | null;
     onFollowReference?(reference: Reference): void;
+    onNotice?(notice: DatabaseNotice): void;
 }
-export declare function StatementResultView({ result, offset, pager, onExport, exporting, engine, valuePanelOpen, onValuePanelOpenChange, keys, onFollowReference }: StatementResultViewProps): import("react").JSX.Element;
+export declare function StatementResultView({ result, offset, pager, onExport, exporting, engine, valuePanelOpen, onValuePanelOpenChange, keys, onFollowReference, onNotice }: StatementResultViewProps): import("react").JSX.Element;

package/dist/console/StatementResultView.js

@@ -12,12 +12,15 @@ import { ValuePanel } from '../value/ValuePanel.js';
 const RESULT_TABLE = 'result';
 const EXPORT_FORMATS = ['csv', 'tsv', 'json', 'sql'];
 /* One statement's outcome: a result set in a read-only grid, a count of affected rows, or the error the server gave. */
-export function StatementResultView({ result, offset = 0, pager, onExport, exporting = false, engine, valuePanelOpen = false, onValuePanelOpenChange, keys = null, onFollowReference }) {
+export function StatementResultView({ result, offset = 0, pager, onExport, exporting = false, engine, valuePanelOpen = false, onValuePanelOpenChange, keys = null, onFollowReference, onNotice }) {
     const { t } = useTranslation('database');
     const [focus, setFocus] = useState(null);
     const rows = useMemo(() => (result.kind === 'rows' ? result.rows.map((cells, index) => ({ key: `row:${index}`, number: offset + index + 1, cells })) : []), [result, offset]);
     const sqlTarget = useMemo(() => (engine === undefined ? undefined : { engine, table: RESULT_TABLE }), [engine]);
     const elapsed = t('console.elapsed', { value: formatDecimal(result.elapsedMs) });
+    if (result.kind === 'error' && result.error.code === 'cancelled') {
+        return (_jsxs("div", { className: "flex min-h-0 flex-1 flex-col gap-3 p-3", children: [_jsx(Banner, { icon: CircleAlert, tone: "neutral", className: "min-w-0", message: t('console.cancelled') }), _jsx("p", { className: "px-1 text-xs text-text-muted tabular-nums", children: elapsed })] }));
+    }
     if (result.kind === 'error') {
         return (_jsxs("div", { className: "flex min-h-0 flex-1 flex-col gap-3 p-3", children: [_jsx(Banner, { icon: CircleAlert, tone: "error", className: "min-w-0", message: _jsxs(_Fragment, { children: [result.error.message, result.error.sqlState !== undefined && (_jsx("span", { className: "ml-2 font-mono text-xs text-text-muted", children: t('console.sqlState', { state: result.error.sqlState }) }))] }) }), _jsx("p", { className: "px-1 text-xs text-text-muted tabular-nums", children: elapsed })] }));
     }
@@ -39,7 +42,7 @@ export function StatementResultView({ result, offset = 0, pager, onExport, expor
     const referenceMenu = (context) => follow === undefined || context.cell === null || keys?.isReference(context.cell.column) !== true ? null : (_jsxs(ContextMenu.Item, { disabled: referenceAt(context.cell) === null, onClick: () => context.cell !== null && follow(context.cell), children: [_jsx(Icon, { icon: ArrowUpRight, size: 14 }), t('table.goToReferenced')] }));
     const focusedRow = valuePanelOpen && focus !== null ? rows.find((row) => row.key === focus.rowKey) : undefined;
     const focusedCell = focus === null ? undefined : focusedRow?.cells[focus.column];
-    return (_jsxs(_Fragment, { children: [_jsx(ValueDock, { open: valuePanelOpen, panel: _jsx(ValuePanel, { column: focus === null ? null : (result.columns[focus.column] ?? null), value: focusedCell === undefined ? undefined : previewValueOf(focusedCell), loading: false, editable: false, onClose: () => onValuePanelOpenChange?.(false), className: "min-w-0 flex-1" }), children: _jsx(DataGrid, { label: t('console.result'), columns: keys?.columns ?? result.columns, rows: rows, empty: t('console.noRows'), sqlTarget: sqlTarget, onFocusedCellChange: setFocus, onFollow: follow, canFollow: (cell) => referenceAt(cell) !== null, menu: referenceMenu }) }), _jsxs("footer", { className: "flex h-10 shrink-0 items-center gap-4 border-t border-border px-3 text-xs text-text-muted", children: [_jsx("span", { className: "text-text tabular-nums", children: offset > 0 || pager !== undefined
+    return (_jsxs(_Fragment, { children: [_jsx(ValueDock, { open: valuePanelOpen, panel: _jsx(ValuePanel, { column: focus === null ? null : (result.columns[focus.column] ?? null), value: focusedCell === undefined ? undefined : previewValueOf(focusedCell), loading: false, editable: false, onClose: () => onValuePanelOpenChange?.(false), className: "min-w-0 flex-1" }), children: _jsx(DataGrid, { label: t('console.result'), columns: keys?.columns ?? result.columns, rows: rows, empty: t('console.noRows'), sqlTarget: sqlTarget, onFocusedCellChange: setFocus, onFollow: follow, canFollow: (cell) => referenceAt(cell) !== null, menu: referenceMenu, onNotice: onNotice }) }), _jsxs("footer", { className: "flex h-10 shrink-0 items-center gap-4 border-t border-border px-3 text-xs text-text-muted", children: [_jsx("span", { className: "text-text tabular-nums", children: offset > 0 || pager !== undefined
                             ? t('console.rowRange', { from: formatNumber(offset + Math.min(1, rows.length)), to: formatNumber(offset + rows.length) })
                             : t('console.rows', { rows: formatNumber(result.rows.length) }) }), pager === undefined && result.hasMore && _jsx("span", { children: t('console.hasMore') }), _jsx("span", { className: "tabular-nums", children: elapsed }), _jsxs("span", { className: "ml-auto flex items-center gap-1", children: [pager !== undefined && (_jsxs(_Fragment, { children: [pager.loading && _jsx(Spinner, { size: 14, label: t('console.loading') }), _jsx(IconButton, { icon: ChevronLeft, size: "sm", label: t('console.previousPage'), disabled: pager.page <= 1 || pager.loading, onClick: pager.onPrevious }), _jsx("span", { className: "min-w-12 text-center tabular-nums", children: t('console.page', { page: formatNumber(pager.page) }) }), _jsx(IconButton, { icon: ChevronRight, size: "sm", label: t('console.nextPage'), disabled: !result.hasMore || pager.loading, onClick: pager.onNext })] })), _jsxs(ButtonGroup, { children: [onExport !== undefined && (_jsxs(Menu.Root, { children: [_jsx(IconButton, { icon: Download, size: "sm", label: t('console.export'), disabled: exporting, render: _jsx(Menu.Trigger, {}) }), _jsx(Menu.Popup, { children: EXPORT_FORMATS.map((format) => (_jsx(Menu.Item, { onClick: () => onExport(format), children: t('console.exportAs', { format: format.toUpperCase() }) }, format))) })] })), onValuePanelOpenChange !== undefined && (_jsx(IconButton, { icon: PanelRight, size: "sm", label: t('console.valuePanel'), "aria-pressed": valuePanelOpen, onClick: () => onValuePanelOpenChange(!valuePanelOpen) }))] })] })] })] }));
 }

package/dist/console/shortcuts.d.ts

@@ -1,2 +1,5 @@
+import { type KeyLike } from '@adecore/ui';
+import type { QueryConsoleRunScope } from './editor-slot.ts';
 export declare const RUN_SHORTCUT: import("@adecore/ui").Shortcut;
 export declare const RUN_ALL_SHORTCUT: import("@adecore/ui").Shortcut;
+export declare const runScopeOf: (event: KeyLike, apple: boolean) => QueryConsoleRunScope | null;

package/dist/console/shortcuts.js

@@ -1,3 +1,14 @@
-import { shortcut } from '@adecore/ui';
-export const RUN_SHORTCUT = shortcut('Mod+Enter');
-export const RUN_ALL_SHORTCUT = shortcut('Mod+Shift+Enter');
+import { matchesShortcut, shortcut } from '@adecore/ui';
+/* The keys the toolbar's tooltips name, which an editor binds to its two runs. */
+export const RUN_SHORTCUT = /* @__PURE__ */ shortcut('Mod+Enter');
+export const RUN_ALL_SHORTCUT = /* @__PURE__ */ shortcut('Mod+Shift+Enter');
+/* The run a key event asks for, or null when it is neither run key. `apple` is the one `matchesShortcut` takes. */
+export const runScopeOf = (event, apple) => {
+    if (matchesShortcut(RUN_ALL_SHORTCUT, event, apple)) {
+        return 'all';
+    }
+    if (matchesShortcut(RUN_SHORTCUT, event, apple)) {
+        return 'selection-or-statement';
+    }
+    return null;
+};

package/dist/grid/DataGrid.d.ts

@@ -1,4 +1,5 @@
 import { type ReactNode, type Ref } from 'react';
+import type { DatabaseNotice } from '../actions.ts';
 import type { EditValue, Value } from '../protocol/index.ts';
 import type { SqlTarget } from '../sql.ts';
 import type { RangeBlock } from './aggregates.ts';
@@ -14,6 +15,7 @@ export interface DataGridProps {
     onSelectedKeysChange?(keys: ReadonlySet<string>): void;
     onCommit?(rowKey: string, column: number, value: EditValue): void;
     loadValue?(rowKey: string, column: number): Promise<Value | undefined>;
+    onNotice?(notice: DatabaseNotice): void;
     sorts?: readonly GridSort[];
     onSortsChange?(sorts: readonly GridSort[]): void;
     onFocusedCellChange?(cell: FocusedCell | null): void;
@@ -33,4 +35,4 @@ export interface DataGridProps {
     className?: string;
     ref?: Ref<HTMLDivElement>;
 }
-export declare function DataGrid({ columns, rows, label, editable, selectedKeys, onSelectedKeysChange, onCommit, loadValue, sorts, onSortsChange, onFocusedCellChange, onDeleteSelected, sqlTarget, queryMenu, menu, onDuplicateRows, onFollow, canFollow, onRangeChange, initialLayout, onLayoutChange, focusRequest, columnRequest, empty, className, ref }: DataGridProps): import("react").JSX.Element;
+export declare function DataGrid({ columns, rows, label, editable, selectedKeys, onSelectedKeysChange, onCommit, loadValue, onNotice, sorts, onSortsChange, onFocusedCellChange, onDeleteSelected, sqlTarget, queryMenu, menu, onDuplicateRows, onFollow, canFollow, onRangeChange, initialLayout, onLayoutChange, focusRequest, columnRequest, empty, className, ref }: DataGridProps): import("react").JSX.Element;

package/dist/grid/DataGrid.js

@@ -4,6 +4,7 @@ import clsx from 'clsx';
 import { Ban, Copy, RotateCcw } from 'lucide-react';
 import { useTranslation } from 'react-i18next';
 import { ContextMenu, copyText, EDIT_SHORTCUTS, Icon, isApplePlatform, isModHeld, Kbd, useContentSize } from '@adecore/ui';
+import { formatNumber } from '@adecore/ui/format';
 import { assignRef } from '../assign-ref.js';
 import { useNumberNotation } from '../client-context.js';
 import { usePopupPress } from '../use-popup-press.js';
@@ -14,7 +15,7 @@ import { NO_COLUMN_SELECTION, selectColumn, shownSelection } from './column-sele
 import { displayOrder, hideColumn, pinnedCount, showAllColumns, togglePin } from './column-view.js';
 import { COPY_FORMATS, formatCopy } from './copy-formats.js';
 import { CopyAsMenu } from './CopyAsMenu.js';
-import { cellView, copyTextOf, isPreview } from './display.js';
+import { columnNotation, cellView, copyTextOf, isPreview } from './display.js';
 import { draftOf, parseDraft } from './edit-value.js';
 import { parseEnumType } from './enum-type.js';
 import { GridHeaderCell } from './GridHeaderCell.js';
@@ -24,18 +25,19 @@ import { clampColumnWidth, columnOffsets, estimateColumnWidth, fitColumnWidth, F
 import { moveFocus } from './navigation.js';
 import { selectRow } from './row-selection.js';
 import { sortOnly, sortStateOf } from './sort.js';
+import { loadWholeCells } from './whole-cells.js';
 const NO_KEYS = new Set();
 const NO_SORTS = [];
 const signatureOf = (columns) => columns.map((column) => column.name).join('\u0000');
 const textOf = (view) => (view.suffix === undefined ? view.text : `${view.text} ${view.suffix}`);
-const estimateWidths = (columns, rows, notation) => columns.map((column, index) => estimateColumnWidth(column.name, rows.slice(0, 50).map((row) => textOf(cellView(row.cells[index] ?? null, column.kind, notation))), column.primaryKey === true));
+const estimateWidths = (columns, rows, notation) => columns.map((column, index) => estimateColumnWidth(column.name, rows.slice(0, 50).map((row) => textOf(cellView(row.cells[index] ?? null, column.kind, columnNotation(column, notation)))), column.primaryKey === true));
 /*
  * The table of the table view and of the console. Only the rows in view are drawn, at a fixed
  * height, inside a box as tall as all of them; the header and the row-number gutter stick to the edges
  * of the scroll box. Focus stays on that box and points at the cell with `aria-activedescendant`, so
  * a cell scrolled out of the window loses nothing.
  */
-export function DataGrid({ columns, rows, label, editable = false, selectedKeys, onSelectedKeysChange, onCommit, loadValue, sorts, onSortsChange, onFocusedCellChange, onDeleteSelected, sqlTarget, queryMenu, menu, onDuplicateRows, onFollow, canFollow, onRangeChange, initialLayout, onLayoutChange, focusRequest, columnRequest, empty, className, ref }) {
+export function DataGrid({ columns, rows, label, editable = false, selectedKeys, onSelectedKeysChange, onCommit, loadValue, onNotice, sorts, onSortsChange, onFocusedCellChange, onDeleteSelected, sqlTarget, queryMenu, menu, onDuplicateRows, onFollow, canFollow, onRangeChange, initialLayout, onLayoutChange, focusRequest, columnRequest, empty, className, ref }) {
     const { t } = useTranslation('database');
     const gridId = useId();
     const scroller = useRef(null);
@@ -290,36 +292,47 @@ export function DataGrid({ columns, rows, label, editable = false, selectedKeys,
             onCommit?.(row.key, position.column, value);
         }
     };
-    /* The cells of the range or of the picked columns, as the columns and rows a copy writes. */
-    const blockOf = () => {
+    /* The cells from row `top` to `bottom` in the given columns, with the whole value of every preview `loadValue` can fetch. */
+    const wholeCellsOf = async (top, bottom, indexes) => {
+        const shown = rows.slice(top, bottom + 1);
+        const whole = await loadWholeCells(shown.map((row) => indexes.map((index) => row.cells[index] ?? null)), loadValue === undefined ? undefined : (row, column) => loadValue(shown[row].key, indexes[column]));
+        if (whole.previews > 0) {
+            onNotice?.({
+                tone: 'error',
+                title: t('grid.copyPreviews.title', { count: whole.previews, formatted: formatNumber(whole.previews) }),
+                description: t(whole.tooLarge ? 'grid.copyPreviews.tooLarge' : 'grid.copyPreviews.unavailable')
+            });
+        }
+        return whole.rows;
+    };
+    const copyAs = async (format) => {
         if (block === null) {
-            return null;
+            return;
         }
-        return {
-            columns: block.columns.map((index) => ({ name: columns[index].name, kind: columns[index].kind })),
-            rows: rows.slice(block.top, block.bottom + 1).map((row) => block.columns.map((index) => row.cells[index] ?? null)),
+        const picked = block.columns;
+        const cells = await wholeCellsOf(block.top, block.bottom, picked);
+        await copyText(formatCopy(format, {
+            columns: picked.map((index) => ({ name: columns[index].name, kind: columns[index].kind })),
+            rows: cells,
             target: sqlTarget
-        };
+        }));
     };
-    const copyAs = (format) => {
-        const block = blockOf();
-        if (block !== null) {
-            copyText(formatCopy(format, block));
-        }
+    const copyOne = async (row, column) => {
+        const [cells] = await wholeCellsOf(row, row, [column]);
+        await copyText(copyTextOf(cells?.[0] ?? null));
     };
     /* One cell copies as it reads; a block copies as TSV, which a spreadsheet pastes into cells. */
     const copyRange = () => {
         if (block !== null && block.top === block.bottom && block.columns.length === 1) {
-            copyText(copyTextOf(rows[block.top]?.cells[block.columns[0]] ?? null));
+            void copyOne(block.top, block.columns[0]);
         }
         else {
-            copyAs('tsv');
+            void copyAs('tsv');
         }
     };
     const copyCell = () => {
-        const row = menuTarget === null ? undefined : rows[menuTarget.row];
-        if (row !== undefined && menuTarget?.column != null) {
-            copyText(copyTextOf(row.cells[menuTarget.column] ?? null));
+        if (menuTarget !== null && menuTarget.column !== null && rows[menuTarget.row] !== undefined) {
+            void copyOne(menuTarget.row, menuTarget.column);
         }
     };
     const selectAll = () => {
@@ -431,7 +444,7 @@ export function DataGrid({ columns, rows, label, editable = false, selectedKeys,
     const fitColumn = (index) => {
         const column = columns[index];
         if (column !== undefined) {
-            resizeColumn(index, fitColumnWidth(column.name, rows.map((row) => textOf(cellView(row.cells[index] ?? null, column.kind, notation))), column.primaryKey === true));
+            resizeColumn(index, fitColumnWidth(column.name, rows.map((row) => textOf(cellView(row.cells[index] ?? null, column.kind, columnNotation(column, notation)))), column.primaryKey === true));
         }
     };
     const changeView = (change) => {
@@ -507,5 +520,5 @@ export function DataGrid({ columns, rows, label, editable = false, selectedKeys,
             rowKeys: selection.has(menuRow.key) ? rows.filter((row) => selection.has(row.key)).map((row) => row.key) : [menuRow.key],
             cell: menuTarget.column === null ? null : { rowKey: menuRow.key, column: menuTarget.column }
         };
-    return (_jsx("div", { ref: attach, role: "grid", "aria-label": label, "aria-rowcount": rows.length + 1, "aria-colcount": order.length + 1, "aria-activedescendant": pickedColumns.length > 0 ? headerId(pickedColumns[0]) : focusCell === null ? undefined : cellId(focusCell.row, focusCell.column), tabIndex: 0, className: clsx('group/grid relative min-h-0 flex-1 overflow-auto bg-surface text-text outline-none', className), onKeyDown: handleKeyDown, onScroll: (event) => setScrolledBlock(scrollBlock(event.currentTarget.scrollTop - HEADER_HEIGHT)), children: _jsxs("div", { className: "relative min-w-full", style: { width: totalWidth }, children: [_jsxs("div", { role: "row", "aria-rowindex": 1, className: "sticky top-0 z-20 flex w-full border-b border-border bg-surface", style: { height: HEADER_HEIGHT }, children: [_jsxs("div", { className: PINNED_GROUP, children: [_jsx("div", { className: "shrink-0 border-r border-border bg-surface bg-clip-border", style: { width: gutter } }), headerCells.slice(0, pinnedShown)] }), headerCells.slice(pinnedShown)] }), _jsxs(ContextMenu.Root, { children: [_jsx(ContextMenu.Trigger, { role: "rowgroup", className: "relative", style: { height: rows.length * ROW_HEIGHT }, children: Array.from({ length: range.end - range.start }, (_, offset) => renderRow(range.start + offset)) }), _jsxs(ContextMenu.Popup, { children: [_jsxs(ContextMenu.Item, { disabled: menuCell === null, onClick: copyCell, children: [_jsx(Icon, { icon: Copy, size: 14 }), t('grid.copyValue'), _jsx(Kbd, { shortcut: EDIT_SHORTCUTS.copy })] }), _jsx(CopyAsMenu, { disabled: block === null, formats: sqlTarget === undefined ? COPY_FORMATS.filter((format) => format !== 'sql') : COPY_FORMATS, onCopy: copyAs }), menuContext !== null && menuCell !== null && queryMenu !== undefined && (_jsxs(_Fragment, { children: [_jsx(ContextMenu.Separator, {}), queryMenu(menuContext)] })), _jsx(ContextMenu.Separator, {}), editable && menuCell !== null && (_jsxs(_Fragment, { children: [_jsxs(ContextMenu.Item, { disabled: !settable || !nullable, onClick: () => commitValue(null), children: [_jsx(Icon, { icon: Ban, size: 14 }), t('grid.setNull')] }), hasDefault && (_jsxs(ContextMenu.Item, { disabled: !settable, onClick: () => commitValue({ kind: 'default' }), children: [_jsx(Icon, { icon: RotateCcw, size: 14 }), t('grid.setDefault')] }))] })), menuContext !== null && menu?.(menuContext)] })] }), rows.length === 0 && empty !== undefined && _jsx("div", { className: "sticky left-0 w-fit px-4 py-6 text-xs text-text-muted", children: empty })] }) }));
+    return (_jsx("div", { ref: attach, role: "grid", "aria-label": label, "aria-rowcount": rows.length + 1, "aria-colcount": order.length + 1, "aria-activedescendant": pickedColumns.length > 0 ? headerId(pickedColumns[0]) : focusCell === null ? undefined : cellId(focusCell.row, focusCell.column), tabIndex: 0, className: clsx('group/grid relative min-h-0 flex-1 overflow-auto bg-surface text-text outline-none', className), onKeyDown: handleKeyDown, onScroll: (event) => setScrolledBlock(scrollBlock(event.currentTarget.scrollTop - HEADER_HEIGHT)), children: _jsxs("div", { className: "relative min-w-full", style: { width: totalWidth }, children: [_jsxs("div", { role: "row", "aria-rowindex": 1, className: "sticky top-0 z-20 flex w-full border-b border-border bg-surface", style: { height: HEADER_HEIGHT }, children: [_jsxs("div", { className: PINNED_GROUP, children: [_jsx("div", { className: "shrink-0 border-r border-border bg-surface bg-clip-border", style: { width: gutter } }), headerCells.slice(0, pinnedShown)] }), headerCells.slice(pinnedShown)] }), _jsxs(ContextMenu.Root, { children: [_jsx(ContextMenu.Trigger, { role: "rowgroup", className: "relative", style: { height: rows.length * ROW_HEIGHT }, children: Array.from({ length: range.end - range.start }, (_, offset) => renderRow(range.start + offset)) }), _jsxs(ContextMenu.Popup, { children: [_jsxs(ContextMenu.Item, { disabled: menuCell === null, onClick: copyCell, children: [_jsx(Icon, { icon: Copy, size: 14 }), t('grid.copyValue'), _jsx(Kbd, { shortcut: EDIT_SHORTCUTS.copy })] }), _jsx(CopyAsMenu, { disabled: block === null, formats: sqlTarget === undefined ? COPY_FORMATS.filter((format) => format !== 'sql') : COPY_FORMATS, onCopy: (format) => void copyAs(format) }), menuContext !== null && menuCell !== null && queryMenu !== undefined && (_jsxs(_Fragment, { children: [_jsx(ContextMenu.Separator, {}), queryMenu(menuContext)] })), _jsx(ContextMenu.Separator, {}), editable && menuCell !== null && (_jsxs(_Fragment, { children: [_jsxs(ContextMenu.Item, { disabled: !settable || !nullable, onClick: () => commitValue(null), children: [_jsx(Icon, { icon: Ban, size: 14 }), t('grid.setNull')] }), hasDefault && (_jsxs(ContextMenu.Item, { disabled: !settable, onClick: () => commitValue({ kind: 'default' }), children: [_jsx(Icon, { icon: RotateCcw, size: 14 }), t('grid.setDefault')] }))] })), menuContext !== null && menu?.(menuContext)] })] }), rows.length === 0 && empty !== undefined && _jsx("div", { className: "sticky left-0 w-fit px-4 py-6 text-xs text-text-muted", children: empty })] }) }));
 }

package/dist/grid/GridRowView.js

@@ -6,7 +6,7 @@ import { formatNumber } from '@adecore/ui/format';
 import { CODE_TEXT } from '../code-text.js';
 import { CellEditor } from './CellEditor.js';
 import { cellIdOf } from './cell-id.js';
-import { cellView } from './display.js';
+import { columnNotation, cellView } from './display.js';
 import { EnumPicker } from './EnumPicker.js';
 import { ROW_HEIGHT } from './layout.js';
 /*
@@ -31,7 +31,7 @@ export const GridRowView = memo(function GridRowView({ row, index, selected, foc
     const cells = order.map((columnIndex, position) => {
         const column = columns[columnIndex];
         const cell = row.cells[columnIndex] ?? null;
-        const view = cellView(cell, column.kind, notation);
+        const view = cellView(cell, column.kind, columnNotation(column, notation));
         const cellPosition = { row: index, column: columnIndex };
         const isFocused = focusedColumn === columnIndex;
         const ranged = picked.has(columnIndex) || (position >= rangeStart && position <= rangeEnd && rangeStart >= 0);

package/dist/grid/RecordView.js

@@ -9,7 +9,7 @@ import { useNumberNotation } from '../client-context.js';
 import { CODE_TEXT } from '../code-text.js';
 import { ValueEditor } from '../value/ValueEditor.js';
 import { isNumericKind } from '../sql.js';
-import { cellView, copyTextOf, isPreview, numeralText } from './display.js';
+import { columnNotation, cellView, copyTextOf, isPreview, numeralText } from './display.js';
 import { draftOf, parseDraft } from './edit-value.js';
 import { parseEnumType } from './enum-type.js';
 import { EnumPicker } from './EnumPicker.js';
@@ -147,7 +147,7 @@ export function RecordView({ columns, rows, index, onIndexChange, focusedColumn,
                                             }
                                         } })) : (_jsxs("span", { className: "relative flex min-w-0 items-center", children: [_jsx(Input, { size: "sm", spellCheck: false, "aria-label": column.name, ref: (node) => {
                                                     fields.current[position] = node;
-                                                }, value: active ? editing.draft : textOf(cell, column.kind, notation, !editableField), placeholder: placeholder, readOnly: !editableField || (preview && (!active || editing.loading)), className: clsx(CODE_TEXT, 'min-w-0 flex-1', row.state === 'deleted' && 'line-through'), onFocus: () => void beginEdit(position), onBlur: commitEdit, onChange: (event) => changeDraft(position, event.target.value), onKeyDown: (event) => handleKeyDown(event, position) }), active && editing.loading && _jsx(Spinner, { size: 12, label: t('grid.loadingValue'), className: "absolute right-2" })] }))] }), _jsxs(ContextMenu.Popup, { children: [_jsxs(ContextMenu.Item, { onClick: () => copyText(copyTextOf(cell)), children: [_jsx(Icon, { icon: Copy, size: 14 }), t('grid.copyValue'), _jsx(Kbd, { shortcut: EDIT_SHORTCUTS.copy })] }), editable && (_jsxs(_Fragment, { children: [_jsx(ContextMenu.Separator, {}), _jsxs(ContextMenu.Item, { disabled: !editableField || !nullable, onClick: () => commitValue(position, null), children: [_jsx(Icon, { icon: Ban, size: 14 }), t('grid.setNull')] }), _jsxs(ContextMenu.Item, { disabled: !editableField, onClick: () => commitValue(position, { kind: 'default' }), children: [_jsx(Icon, { icon: RotateCcw, size: 14 }), t('grid.setDefault')] })] }))] })] }, position));
+                                                }, value: active ? editing.draft : textOf(cell, column.kind, columnNotation(column, notation), !editableField), placeholder: placeholder, readOnly: !editableField || (preview && (!active || editing.loading)), className: clsx(CODE_TEXT, 'min-w-0 flex-1', row.state === 'deleted' && 'line-through'), onFocus: () => void beginEdit(position), onBlur: commitEdit, onChange: (event) => changeDraft(position, event.target.value), onKeyDown: (event) => handleKeyDown(event, position) }), active && editing.loading && _jsx(Spinner, { size: 12, label: t('grid.loadingValue'), className: "absolute right-2" })] }))] }), _jsxs(ContextMenu.Popup, { children: [_jsxs(ContextMenu.Item, { onClick: () => copyText(copyTextOf(cell)), children: [_jsx(Icon, { icon: Copy, size: 14 }), t('grid.copyValue'), _jsx(Kbd, { shortcut: EDIT_SHORTCUTS.copy })] }), editable && (_jsxs(_Fragment, { children: [_jsx(ContextMenu.Separator, {}), _jsxs(ContextMenu.Item, { disabled: !editableField || !nullable, onClick: () => commitValue(position, null), children: [_jsx(Icon, { icon: Ban, size: 14 }), t('grid.setNull')] }), _jsxs(ContextMenu.Item, { disabled: !editableField, onClick: () => commitValue(position, { kind: 'default' }), children: [_jsx(Icon, { icon: RotateCcw, size: 14 }), t('grid.setDefault')] })] }))] })] }, position));
                 }) }))] }));
 }
 /* A field opened up to its whole value, fetched with `loadValue` when the row holds only a preview. */

package/dist/grid/display.d.ts

@@ -1,4 +1,5 @@
 import type { Cell, EditValue, ValueKind } from '../protocol/index.ts';
+import type { GridColumn } from './types.ts';
 export type Shown = Cell | {
     readonly kind: 'default';
 };
@@ -14,6 +15,7 @@ export declare const DISPLAY_LIMIT = 200;
 export declare const BINARY_PREVIEW_BYTES = 8;
 export declare const isPreview: (cell: Shown) => boolean;
 export declare const numeralText: (numeral: string | number, notation: NumberNotation) => string;
+export declare function columnNotation(column: GridColumn, notation: NumberNotation): NumberNotation;
 export declare const cellView: (cell: Shown, kind: ValueKind, notation?: NumberNotation) => CellView;
 export declare const copyTextOf: (cell: Shown) => string;
 export declare const shownOfEdit: (value: EditValue) => Shown;

package/dist/grid/display.js

@@ -24,6 +24,17 @@ export const numeralText = (numeral, notation) => {
     const formatted = formatNumeral(numeral);
     return formatted === String(numeral).trim() ? String(numeral) : formatted;
 };
+/* Identifiers are labels, even when the database stores their characters as a number. */
+export function columnNotation(column, notation) {
+    const identifierName = (name) => /^(?:id|.+_id)$/i.test(name) || /(?:Id|ID)$/.test(name);
+    return column.primaryKey === true ||
+        column.foreignKey === true ||
+        column.autoIncrement === true ||
+        identifierName(column.name) ||
+        (column.source !== undefined && identifierName(column.source.column))
+        ? 'database'
+        : notation;
+}
 const cut = (text) => (text.length > DISPLAY_LIMIT ? `${text.slice(0, DISPLAY_LIMIT)}${ELLIPSIS}` : text);
 export const cellView = (cell, kind, notation = 'database') => {
     const numeric = isNumericKind(kind);

package/dist/grid/whole-cells.d.ts

@@ -0,0 +1,9 @@
+import type { Value } from '../protocol/index.ts';
+import { type Shown } from './display.ts';
+export declare const WHOLE_COPY_LIMIT: number;
+export interface WholeCells {
+    readonly rows: readonly (readonly Shown[])[];
+    readonly previews: number;
+    readonly tooLarge: boolean;
+}
+export declare const loadWholeCells: (rows: readonly (readonly Shown[])[], load: ((row: number, column: number) => Promise<Value | undefined>) | undefined) => Promise<WholeCells>;

package/dist/grid/whole-cells.js

@@ -0,0 +1,49 @@
+import { isPreview, shownOfEdit } from './display.js';
+/* Characters of whole values one copy fetches at most, a byte of a binary value counting as two: past it the copy would hold the clipboard and the session for too long. */
+export const WHOLE_COPY_LIMIT = 16 * 1024 * 1024;
+/* The helper runs the requests of a session one after another, so more at once would only wait in its queue. */
+const PARALLEL_LOADS = 4;
+const wholeSize = (cell) => {
+    if (cell === null || typeof cell !== 'object' || cell.kind === 'default') {
+        return 0;
+    }
+    return cell.kind === 'longText' ? cell.length : cell.length * 2;
+};
+/*
+ * A block of cells with every preview replaced by the whole value `load` fetches for it, by its row and
+ * column in the block. A cell `load` resolves `undefined` for, or rejects for, stays a preview.
+ */
+export const loadWholeCells = async (rows, load) => {
+    const wanted = [];
+    let size = 0;
+    rows.forEach((cells, row) => cells.forEach((cell, column) => {
+        if (isPreview(cell)) {
+            wanted.push({ row, column });
+            size += wholeSize(cell);
+        }
+    }));
+    if (wanted.length === 0) {
+        return { rows, previews: 0, tooLarge: false };
+    }
+    if (load === undefined || size > WHOLE_COPY_LIMIT) {
+        return { rows, previews: wanted.length, tooLarge: load !== undefined };
+    }
+    const filled = rows.map((cells) => [...cells]);
+    let previews = 0;
+    let next = 0;
+    const work = async () => {
+        while (next < wanted.length) {
+            const { row, column } = wanted[next];
+            next += 1;
+            const value = await load(row, column).catch(() => undefined);
+            if (value === undefined) {
+                previews += 1;
+            }
+            else {
+                filled[row][column] = shownOfEdit(value);
+            }
+        }
+    };
+    await Promise.all(Array.from({ length: Math.min(PARALLEL_LOADS, wanted.length) }, work));
+    return { rows: filled, previews, tooLarge: false };
+};