@script-it/json-views-react 0.1.0-beta.1 → 2026.10.27

package/dist/json/json-view.js

@@ -18,6 +18,7 @@ import { GeneralRecordView, RecordView } from './record-view.js';
 import { ProjectedTableView } from './table-view.js';
 import { KanbanView } from './kanban-view.js';
 import { useViewerState } from '../viewer-state.js';
+import { TableCellOptionsContext } from '../structured-data/table-cell-options.js';
 const VIEW_TAB_CLASS = 'h-7 shrink-0 gap-1.5 rounded-md px-2 py-0 text-xs font-medium text-muted-foreground shadow-none hover:bg-accent hover:text-foreground data-[state=active]:bg-accent data-[state=active]:text-foreground data-[state=active]:shadow-none [&>svg]:shrink-0';
 function slashPath(view) {
     const segments = view.path.segments.map((segment) => {
@@ -98,7 +99,7 @@ function ConfiguredView(props) {
     }
     return _jsx(AdaptiveView, { ...props });
 }
-export function JsonViewer({ compiled, defaultKey, editing, filePath, fillHeight = false, onCurrentPathChange, renderExternalWidget, renderMarkdown, sourceControl, sourceContent, sourceVisible, onSourceVisibleChange, uiSize, viewsEnabled = true, tabularRoot = false, }) {
+export function JsonViewer({ compiled, defaultKey, editing, filePath, fillHeight = false, onCurrentPathChange, renderExternalWidget, renderMarkdown, sourceControl, sourceContent, sourceVisible, onSourceVisibleChange, tableCells, uiSize, viewsEnabled = true, tabularRoot = false, }) {
     const { types } = useJsonViewsRegistries();
     const viewerState = useViewerState();
     const firstViewTab = viewsEnabled && compiled.views[0] ? `view:${compiled.views[0].id}` : 'root';
@@ -146,11 +147,12 @@ export function JsonViewer({ compiled, defaultKey, editing, filePath, fillHeight
     }, [compiled.root, currentPath, defaultKey, rawViews]);
     const settingsRawView = activeRawView ?? rootDraftRawView;
     const settingsDeclarationIndex = declaredView?.declarationIndex ?? rawViews.length;
+    // Only the compiled view is needed here, so the per-value validation pass is skipped.
     const settingsView = useMemo(() => {
         if (declaredView)
             return declaredView;
         const candidate = compileJsonViewMetadata(compiled.root, types, {
-            metadata: metadataWithViews(compiled, [...rawViews, rootDraftRawView]),
+            metadata: metadataWithViews(compiled, [...rawViews, rootDraftRawView]), validateValues: false,
         });
         return candidate.views.find((view) => view.declarationIndex === rawViews.length);
     }, [compiled, declaredView, rawViews, rootDraftRawView, types, types.version]);
@@ -169,7 +171,7 @@ export function JsonViewer({ compiled, defaultKey, editing, filePath, fillHeight
             views[declaredView.declarationIndex] = previewRawView;
         else
             views.push(previewRawView);
-        const candidate = compileJsonViewMetadata(compiled.root, types, { metadata: metadataWithViews(compiled, views) });
+        const candidate = compileJsonViewMetadata(compiled.root, types, { metadata: metadataWithViews(compiled, views), validateValues: false });
         return candidate.views.find((view) => view.declarationIndex === settingsDeclarationIndex);
     }, [compiled, declaredView, previewRawView, rawViews, settingsDeclarationIndex, types, types.version]);
     const previewSettings = useCallback((next) => {
@@ -215,7 +217,7 @@ export function JsonViewer({ compiled, defaultKey, editing, filePath, fillHeight
         if (!editing)
             throw new Error('This JSON is read-only');
         if (requiredIndex !== undefined) {
-            const candidate = compileJsonViewMetadata(compiled.root, types, { metadata: metadataWithViews(compiled, views) });
+            const candidate = compileJsonViewMetadata(compiled.root, types, { metadata: metadataWithViews(compiled, views), validateValues: false });
             const valid = candidate.views.some((view) => view.declarationIndex === requiredIndex);
             const issue = candidate.diagnostics.find((item) => item.scope === 'view' && item.metadataPath[2] === requiredIndex);
             if (!valid)
@@ -291,32 +293,32 @@ export function JsonViewer({ compiled, defaultKey, editing, filePath, fillHeight
         if (!query)
             setSearchOpenTab(undefined);
     };
-    return (_jsx(Tabs, { value: selectedTab, onValueChange: (value) => { if (value !== 'source')
-            setActiveTab(value); onSourceVisibleChange?.(value === 'source'); }, className: cn('flex min-h-0 flex-1 flex-col bg-background text-foreground', fillHeight && 'h-full'), children: _jsxs("div", { "data-id": "json-viewer-content", className: cn('flex min-h-0 w-full max-w-none flex-1 flex-col px-3 py-4 sm:px-6 sm:py-5', fillHeight && 'h-full'), children: [hasToolbar && (_jsxs("div", { "data-id": "json-viewer-toolbar", className: "relative flex min-h-8 shrink-0 flex-nowrap items-center gap-x-2", children: [_jsxs("div", { "data-id": "jsonView-toolbar-actions", className: "ml-auto flex h-8 shrink-0 items-center gap-1", children: [selectedTab !== 'source' && searchable && (searchOpen ? (_jsxs("label", { "data-id": "jsonView-search-control", className: "flex h-7 w-44 items-center overflow-hidden rounded-md border border-transparent bg-transparent transition-[width,background-color] focus-within:border-border focus-within:bg-card sm:w-52", children: [_jsx(Search, { className: "mx-1.5 h-3.5 w-3.5 shrink-0 text-muted-foreground" }), _jsx("input", { ref: searchInput, "aria-label": "Search rows", className: "h-full min-w-0 flex-1 bg-transparent pr-2 text-xs outline-none placeholder:text-muted-foreground", value: query, onBlur: closeSearch, onChange: (event) => setQuery(event.target.value), onKeyDown: (event) => {
-                                                if (event.key === 'Escape') {
-                                                    setQuery('');
-                                                    setSearchOpenTab(undefined);
-                                                }
-                                            }, placeholder: "Type to search\u2026" })] })) : (_jsx("button", { "data-id": "jsonView-search-button", type: "button", "aria-label": "Search rows", title: "Search", className: "grid h-7 w-7 shrink-0 place-items-center rounded-md text-muted-foreground hover:bg-accent hover:text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring", onClick: () => setSearchOpenTab(selectedTab), children: _jsx(Search, { className: "h-3.5 w-3.5" }) }))), editing && settingsRawView && (_jsx(JsonViewViewSettings, { hasUnsavedChanges: previewRawView !== undefined, view: previewView ?? settingsView ?? activeView, rawView: activeView.display === 'html' ? activeRawView ?? settingsDraftRawView : settingsDraftRawView, schema: compiled.schema, disabled: editing.saving, saveMode: viewSaveMode, saveUnavailableReason: canPersistViews ? undefined : editing.viewCreationUnavailableReason, unavailableReason: settingsUnavailableReason, onPreview: previewSettings, onSave: saveSettingsView, onDuplicate: declaredView && activeRawView && canPersistViews ? async () => {
-                                        const name = uniqueViewName(`${declaredView.name} copy`, rawViews);
-                                        const id = uniqueViewId(name, rawViews);
-                                        const duplicate = { ...activeRawView, id, name };
-                                        const nextViews = [...rawViews];
-                                        const duplicateIndex = declaredView.declarationIndex + 1;
-                                        nextViews.splice(duplicateIndex, 0, duplicate);
-                                        await persistViews(nextViews, duplicateIndex);
-                                        setActiveTab(`view:${id}`);
-                                    } : undefined, onDelete: declaredView && canPersistViews ? async () => {
-                                        const nextViews = [...rawViews];
-                                        nextViews.splice(declaredView.declarationIndex, 1);
-                                        await persistViews(nextViews);
-                                        setActiveTab('root');
-                                    } : undefined }, typeof settingsDraftRawView.id === 'string' ? settingsDraftRawView.id : '__view_settings__')), sourceControl, _jsx(Diagnostics, { compiled: compiled })] }), (hasTabs || canAddViews || sourceContent) && (_jsxs("div", { "data-id": "jsonView-view-controls", className: "flex min-w-0 flex-1 items-center", children: [canAddViews && _jsx(JsonViewAddView, { align: "start", root: compiled.root, schema: compiled.schema, currentPath: jsonPathForValuePath(currentPath), disabled: editing.saving, onAdd: addView, unavailableReason: addViewUnavailableReason }, "add-view"), (hasTabs || sourceContent) && (_jsxs(TabsList, { "data-id": "jsonView-json-tabs", className: "h-8 min-w-0 flex-initial justify-start gap-0.5 overflow-x-auto overscroll-x-contain rounded-none bg-transparent p-0", children: [compiled.views.map((view) => {
-                                            const Icon = view.display === 'html' ? LayoutGrid : view.display === 'kanban'
-                                                ? Columns3
-                                                : isInferredSingleRecord(view) || (view.value !== null && typeof view.value === 'object' && !Array.isArray(view.value) && !isRecordCollection(view.value))
-                                                    ? FileText
-                                                    : Table2;
-                                            return _jsxs(ViewTab, { id: `jsonView-json-tab-${view.id}`, value: `view:${view.id}`, path: slashPath(view), children: [_jsx(Icon, { className: "h-3.5 w-3.5" }), view.name] }, view.id);
-                                        }), _jsxs(ViewTab, { id: "jsonView-json-tab-root", value: "root", path: isInferredSingleRecord(rootView) && !forceTable ? 'Root record' : 'Root table', children: [isInferredSingleRecord(rootView) && !forceTable ? _jsx(FileText, { className: "h-3.5 w-3.5" }) : _jsx(Table2, { className: "h-3.5 w-3.5" }), _jsx("span", { className: "sr-only", children: isInferredSingleRecord(rootView) && !forceTable ? 'Record' : 'Table' })] }), sourceContent && _jsxs(ViewTab, { id: "jsonView-json-tab-source", value: "source", path: "Source", children: [_jsx(Braces, { className: "h-3.5 w-3.5" }), _jsx("span", { className: "sr-only", children: "Source" })] })] }, "view-tabs"))] }))] })), _jsx(TabsContent, { value: selectedTab, className: cn('mt-2 min-w-0', fillHeight && 'flex min-h-0 flex-1 flex-col'), children: selectedTab === 'source' ? sourceContent : _jsx(ConfiguredView, { forceTable: forceTable, compiled: compiled, copyFileName: defaultKey === 'root' ? 'document.json' : defaultKey, editing: editing, filePath: filePath, fillHeight: fillHeight, onCurrentPathChange: rememberCurrentPath, onSaveView: saveColumnView, query: query, rawView: columnRawView, renderExternalWidget: renderExternalWidget, renderMarkdown: renderMarkdown, uiSize: uiSize, view: renderedView }, selectedTab) })] }) }));
+    return (_jsx(TableCellOptionsContext.Provider, { value: tableCells, children: _jsx(Tabs, { value: selectedTab, onValueChange: (value) => { if (value !== 'source')
+                setActiveTab(value); onSourceVisibleChange?.(value === 'source'); }, className: cn('flex min-h-0 flex-1 flex-col bg-background text-foreground', fillHeight && 'h-full'), children: _jsxs("div", { "data-id": "json-viewer-content", className: cn('flex min-h-0 w-full max-w-none flex-1 flex-col px-3 py-4 sm:px-6 sm:py-5', fillHeight && 'h-full'), children: [hasToolbar && (_jsxs("div", { "data-id": "json-viewer-toolbar", className: "relative flex min-h-8 shrink-0 flex-nowrap items-center gap-x-2", children: [_jsxs("div", { "data-id": "jsonView-toolbar-actions", className: "ml-auto flex h-8 shrink-0 items-center gap-1", children: [selectedTab !== 'source' && searchable && (searchOpen ? (_jsxs("label", { "data-id": "jsonView-search-control", className: "flex h-7 w-44 items-center overflow-hidden rounded-md border border-transparent bg-transparent transition-[width,background-color] focus-within:border-border focus-within:bg-card sm:w-52", children: [_jsx(Search, { className: "mx-1.5 h-3.5 w-3.5 shrink-0 text-muted-foreground" }), _jsx("input", { ref: searchInput, "aria-label": "Search rows", className: "h-full min-w-0 flex-1 bg-transparent pr-2 text-xs outline-none placeholder:text-muted-foreground", value: query, onBlur: closeSearch, onChange: (event) => setQuery(event.target.value), onKeyDown: (event) => {
+                                                    if (event.key === 'Escape') {
+                                                        setQuery('');
+                                                        setSearchOpenTab(undefined);
+                                                    }
+                                                }, placeholder: "Type to search\u2026" })] })) : (_jsx("button", { "data-id": "jsonView-search-button", type: "button", "aria-label": "Search rows", title: "Search", className: "grid h-7 w-7 shrink-0 place-items-center rounded-md text-muted-foreground hover:bg-accent hover:text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring", onClick: () => setSearchOpenTab(selectedTab), children: _jsx(Search, { className: "h-3.5 w-3.5" }) }))), editing && settingsRawView && (_jsx(JsonViewViewSettings, { hasUnsavedChanges: previewRawView !== undefined, view: previewView ?? settingsView ?? activeView, rawView: activeView.display === 'html' ? activeRawView ?? settingsDraftRawView : settingsDraftRawView, schema: compiled.schema, disabled: editing.saving, saveMode: viewSaveMode, saveUnavailableReason: canPersistViews ? undefined : editing.viewCreationUnavailableReason, unavailableReason: settingsUnavailableReason, onPreview: previewSettings, onSave: saveSettingsView, onDuplicate: declaredView && activeRawView && canPersistViews ? async () => {
+                                            const name = uniqueViewName(`${declaredView.name} copy`, rawViews);
+                                            const id = uniqueViewId(name, rawViews);
+                                            const duplicate = { ...activeRawView, id, name };
+                                            const nextViews = [...rawViews];
+                                            const duplicateIndex = declaredView.declarationIndex + 1;
+                                            nextViews.splice(duplicateIndex, 0, duplicate);
+                                            await persistViews(nextViews, duplicateIndex);
+                                            setActiveTab(`view:${id}`);
+                                        } : undefined, onDelete: declaredView && canPersistViews ? async () => {
+                                            const nextViews = [...rawViews];
+                                            nextViews.splice(declaredView.declarationIndex, 1);
+                                            await persistViews(nextViews);
+                                            setActiveTab('root');
+                                        } : undefined }, typeof settingsDraftRawView.id === 'string' ? settingsDraftRawView.id : '__view_settings__')), sourceControl, _jsx(Diagnostics, { compiled: compiled })] }), (hasTabs || canAddViews || sourceContent) && (_jsxs("div", { "data-id": "jsonView-view-controls", className: "flex min-w-0 flex-1 items-center", children: [canAddViews && _jsx(JsonViewAddView, { align: "start", root: compiled.root, schema: compiled.schema, currentPath: jsonPathForValuePath(currentPath), disabled: editing.saving, onAdd: addView, unavailableReason: addViewUnavailableReason }, "add-view"), (hasTabs || sourceContent) && (_jsxs(TabsList, { "data-id": "jsonView-json-tabs", className: "h-8 min-w-0 flex-initial justify-start gap-0.5 overflow-x-auto overscroll-x-contain rounded-none bg-transparent p-0", children: [compiled.views.map((view) => {
+                                                const Icon = view.display === 'html' ? LayoutGrid : view.display === 'kanban'
+                                                    ? Columns3
+                                                    : isInferredSingleRecord(view) || (view.value !== null && typeof view.value === 'object' && !Array.isArray(view.value) && !isRecordCollection(view.value))
+                                                        ? FileText
+                                                        : Table2;
+                                                return _jsxs(ViewTab, { id: `jsonView-json-tab-${view.id}`, value: `view:${view.id}`, path: slashPath(view), children: [_jsx(Icon, { className: "h-3.5 w-3.5" }), view.name] }, view.id);
+                                            }), _jsxs(ViewTab, { id: "jsonView-json-tab-root", value: "root", path: isInferredSingleRecord(rootView) && !forceTable ? 'Root record' : 'Root table', children: [isInferredSingleRecord(rootView) && !forceTable ? _jsx(FileText, { className: "h-3.5 w-3.5" }) : _jsx(Table2, { className: "h-3.5 w-3.5" }), _jsx("span", { className: "sr-only", children: isInferredSingleRecord(rootView) && !forceTable ? 'Record' : 'Table' })] }), sourceContent && _jsxs(ViewTab, { id: "jsonView-json-tab-source", value: "source", path: "Source", children: [_jsx(Braces, { className: "h-3.5 w-3.5" }), _jsx("span", { className: "sr-only", children: "Source" })] })] }, "view-tabs"))] }))] })), _jsx(TabsContent, { value: selectedTab, className: cn('mt-2 min-w-0', fillHeight && 'flex min-h-0 flex-1 flex-col'), children: selectedTab === 'source' ? sourceContent : _jsx(ConfiguredView, { forceTable: forceTable, compiled: compiled, copyFileName: defaultKey === 'root' ? 'document.json' : defaultKey, editing: editing, filePath: filePath, fillHeight: fillHeight, onCurrentPathChange: rememberCurrentPath, onSaveView: saveColumnView, query: query, rawView: columnRawView, renderExternalWidget: renderExternalWidget, renderMarkdown: renderMarkdown, uiSize: uiSize, view: renderedView }, selectedTab) })] }) }) }));
 }

package/dist/json/schema-value.js

@@ -2,6 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { useCallback, useContext, useEffect, useRef, useState } from 'react';
 import { AlertTriangle, Check, ExternalLink } from 'lucide-react';
 import { cn } from '../lib/cn.js';
+import { submitsOnEnter, useEnterKeyBehavior } from '../lib/enter-key.js';
 import { OptionPill, optionColorsForValues } from '../primitives/option-pill.js';
 import { EditValueAction, StructuredValueCellFrame } from '../structured-data/atomic-value-editor.js';
 import { StructuredCellFillContext } from '../structured-data/structured-cell-fill-context.js';
@@ -106,6 +107,7 @@ export function SchemaEditor({ descriptor, disabled, label, minHeight, onCancel,
     const baseChanged = useEditBaseChanged();
     const fillCell = useContext(StructuredCellFillContext);
     const format = descriptor.type;
+    const enterKey = useEnterKeyBehavior(widgets.getDefinition(format)?.enterKey);
     const stringDraft = typeof draft === 'string' || typeof draft === 'number' || typeof draft === 'boolean'
         ? String(draft)
         : Array.isArray(draft) ? JSON.stringify(draft) : '';
@@ -208,10 +210,16 @@ export function SchemaEditor({ descriptor, disabled, label, minHeight, onCancel,
             : (format === 'body' || format === 'markdown' || format === 'html')
                 ? 'leading-normal [&_textarea]:[font:inherit]'
                 : '[&_input]:[font:inherit] [&_textarea]:[font:inherit]'), "aria-label": `Edit ${label}`, onKeyDown: (event) => {
-            if (event.key !== 'Enter' || event.target instanceof HTMLButtonElement)
+            // React delivers keys from a widget's portaled popup (a date picker,
+            // a choice menu) here too; that popup owns them. A widget that
+            // handled Enter itself, such as a code editor, keeps it.
+            const target = event.target;
+            if (event.defaultPrevented || !(target instanceof Element) || !event.currentTarget.contains(target))
                 return;
-            const textarea = event.target instanceof HTMLTextAreaElement;
-            if (textarea && !event.metaKey && !event.ctrlKey)
+            if (target instanceof HTMLButtonElement)
+                return;
+            const multiline = target instanceof HTMLTextAreaElement || (target instanceof HTMLElement && target.isContentEditable);
+            if (!submitsOnEnter(event, { multiline, enterKey }))
                 return;
             event.preventDefault();
             void commit();

package/dist/json/table-view.js

@@ -3,7 +3,7 @@ import { isLongText } from './long-text.js';
 import { useJsonSourceLiterals } from './source-literals.js';
 import { useCallback, useEffect, useMemo, useState } from 'react';
 import { useJsonViewsRegistries } from '../widget-registry.js';
-import { AtomicValueEditor } from '../structured-data/atomic-value-editor.js';
+import { AtomicValueEditor, EditValueAction, StructuredValueCellFrame } from '../structured-data/atomic-value-editor.js';
 import { isEditableAtomicValue } from '../structured-data/atomic-value.js';
 import { TabularObjectArrayView, ValueCell, ValueCellContent } from '../tabular-data-view.js';
 import {} from '@script-it/json-views-core';
@@ -46,8 +46,21 @@ export function ProjectedTableView({ compiled, editing, filePath, copyFileName,
     const [editPath, setEditPath] = useState();
     const [openRowPath, setOpenRowPath] = useState();
     const [openCell, setOpenCell] = useState();
-    const unfilteredProjection = useMemo(() => projectJsonViewCollection(compiled.root, { ...view, filter: undefined }, compiled.schema, types, sourceLiteral), [compiled.root, compiled.schema, view, types, types.version, sourceLiteral]);
     const completeProjection = useMemo(() => projectJsonViewCollection(compiled.root, view, compiled.schema, types, sourceLiteral), [compiled.root, compiled.schema, view, types, types.version, sourceLiteral]);
+    // Without a filter, the complete projection already is the unfiltered one.
+    const unfilteredProjection = useMemo(() => view.filter
+        ? projectJsonViewCollection(compiled.root, { ...view, filter: undefined }, compiled.schema, types, sourceLiteral)
+        : completeProjection, [compiled.root, compiled.schema, completeProjection, view, types, types.version, sourceLiteral]);
+    // The first record with a schema match decides each column's descriptor. This
+    // does not depend on the search query, unlike the rest of the table model.
+    const columnDescriptors = useMemo(() => Object.fromEntries(completeProjection.columns.map((column) => {
+        for (const row of unfilteredProjection.rows) {
+            const schema = schemaForJsonViewPath(compiled.schema, resolveJsonViewRowPath(compiled.root, row, column.path).sourcePath);
+            if (schema)
+                return [column.id, schema.descriptor];
+        }
+        return [column.id, compiled.schema.find((schema) => sameJsonViewPath(schema.path, column.path))?.descriptor];
+    })), [compiled.root, compiled.schema, completeProjection.columns, unfilteredProjection]);
     const projected = useMemo(() => {
         const indices = completeProjection.rows.flatMap((row, index) => matchesSearch(row.value, query) ? [index] : []);
         return {
@@ -65,16 +78,8 @@ export function ProjectedTableView({ compiled, editing, filePath, copyFileName,
             fieldOccurrences.set(field, occurrence + 1);
             return [column.id, JSON.stringify([field, occurrence])];
         }));
-        const descriptors = Object.fromEntries(visibleColumns.map((column) => {
-            const descriptor = unfilteredProjection.rows.flatMap((row) => {
-                const path = resolveJsonViewRowPath(compiled.root, row, column.path).sourcePath;
-                const schema = schemaForJsonViewPath(compiled.schema, path);
-                return schema ? [schema.descriptor] : [];
-            })[0] ?? compiled.schema.find((schema) => sameJsonViewPath(schema.path, column.path))?.descriptor;
-            return [column.id, descriptor];
-        }));
         const columnFilterOperators = Object.fromEntries(visibleColumns.map((column) => {
-            const descriptor = descriptors[column.id];
+            const descriptor = columnDescriptors[column.id];
             const defaults = descriptor?.type === 'date' ? DATE_FILTER_OPERATORS : FILTER_OPERATORS;
             const declared = descriptor ? types.filterOperators(descriptor) : undefined;
             return [column.id, declared ? [
@@ -94,7 +99,7 @@ export function ProjectedTableView({ compiled, editing, filePath, copyFileName,
             ])),
             titleColumn: visibleColumns[0],
         };
-    }, [compiled.root, compiled.schema, completeProjection, projected.records, types, unfilteredProjection]);
+    }, [columnDescriptors, completeProjection, projected.records, types, unfilteredProjection]);
     const declaredColumnActions = rawView && onSaveView ? {
         activeFilters: view.filter?.rules.flatMap((rule) => {
             const column = tableModel.visibleColumns.find((candidate) => sameJsonViewPath(candidate.path, rule.path));
@@ -281,8 +286,16 @@ export function ProjectedTableView({ compiled, editing, filePath, copyFileName,
             const schema = schemaForJsonViewPath(compiled.schema, resolved.sourcePath);
             const descriptor = schema?.descriptor;
             const coloredDescriptor = descriptor && withColumnOptionColors(descriptor, columnFilterValues[column] ?? [value], visibleColumns.findIndex((candidate) => candidate.id === column));
-            if (isLongText(value, descriptor))
-                return (_jsx("button", { type: "button", className: "block h-full w-full min-w-0 truncate px-1.5 py-1 text-left hover:bg-accent focus-visible:ring-1 focus-visible:ring-ring", "aria-label": `Open ${displayColumn.label} in record`, onClick: () => { setEditPath(resolved.sourcePath); setOpenRowPath(row.sourcePath); }, children: value || '—' }));
+            if (isLongText(value, descriptor)) {
+                const openRecordEditor = () => { setEditPath(resolved.sourcePath); setOpenRowPath(row.sourcePath); };
+                // Render before applying the plain-text shortcut. A group preserves
+                // native link interactions without nesting links inside a button.
+                if (renderMarkdown && (descriptor?.type === 'markdown' || descriptor?.type === 'body'))
+                    return (_jsx(StructuredValueCellFrame, { activationLabel: `Open ${displayColumn.label} in record`, activationRole: "group", onActivate: openRecordEditor, actions: editing && editing.canReplace?.(resolved.sourcePath) !== false
+                            ? _jsx(EditValueAction, { label: displayColumn.label, onClick: openRecordEditor })
+                            : undefined, children: _jsx("div", { className: "min-w-0 flex-1 break-words pr-2", children: _jsx(JsonViewSchemaValueDisplay, { sourcePath: resolved.sourcePath, descriptor: descriptor, value: value, onOpen: open, renderMarkdown: renderMarkdown }) }) }));
+                return _jsx("button", { type: "button", className: "block h-full w-full min-w-0 truncate px-1.5 py-1 text-left hover:bg-accent focus-visible:ring-1 focus-visible:ring-ring", "aria-label": `Open ${displayColumn.label} in record`, onClick: openRecordEditor, children: value || '—' });
+            }
             if (coloredDescriptor) {
                 return (_jsx(JsonViewSchemaValueCell, { sourcePath: resolved.sourcePath, descriptor: coloredDescriptor, suppressRequiredValidation: editing?.isDraftRow?.(row.sourcePath) === true, onOptionColorChange: editing?.setOptionColor && schema ? (optionValue, color) => editing.setOptionColor(schema.declaration, optionValue, color) : undefined, inputKey: String(resolved.sourcePath[resolved.sourcePath.length - 1] ?? displayColumn.label), label: descriptor.title ?? displayColumn.label, value: value, onOpen: open, onClear: editing && resolved.value !== JSON_VIEW_PATH_MISSING ? () => editing.clear(resolved.sourcePath) : undefined, onCommit: editing && editing.canReplace?.(resolved.sourcePath) !== false && resolved.value !== JSON_VIEW_PATH_MISSING ? (next) => editing.replace(resolved.sourcePath, next) : undefined, renderExternalWidget: renderExternalWidget, renderMarkdown: renderMarkdown, saving: editing?.saving }));
             }

package/dist/json/view-model.d.ts

@@ -3,7 +3,7 @@ import { type CompiledJsonViewMetadata, type CompiledJsonViewView, type JsonView
 export declare function isRecordCollection(value: unknown): boolean;
 export declare function presentsRecordCollection(view: CompiledJsonViewView, forceTable?: boolean): boolean;
 export declare function matchesSearch(value: unknown, query: string): boolean;
-export declare function rawViewsFor(compiled: CompiledJsonViewMetadata): unknown[];
+export declare function rawViewsFor(compiled: CompiledJsonViewMetadata): readonly unknown[];
 export declare function rawViewFor(compiled: CompiledJsonViewMetadata, view: CompiledJsonViewView): Record<string, unknown> | undefined;
 export declare function uniqueViewName(label: string, views: readonly unknown[]): string;
 export declare function uniqueViewId(name: string, views: readonly unknown[]): string;

package/dist/json/view-model.js

@@ -34,6 +34,8 @@ export function matchesSearch(value, query) {
         return String(value).toLocaleLowerCase().includes(normalized);
     }
 }
+// A stable empty result keeps memos that depend on the raw views from recomputing every render.
+const NO_RAW_VIEWS = Object.freeze([]);
 export function rawViewsFor(compiled) {
     const metadata = compiled.metadata;
     if (metadata !== null && typeof metadata === 'object' && !Array.isArray(metadata)) {
@@ -41,7 +43,7 @@ export function rawViewsFor(compiled) {
         if (Array.isArray(views))
             return views;
     }
-    return compiled.inference?.views ?? [];
+    return compiled.inference?.views ?? NO_RAW_VIEWS;
 }
 export function rawViewFor(compiled, view) {
     const raw = rawViewsFor(compiled)[view.declarationIndex];

package/dist/json/view-settings.js

@@ -516,28 +516,48 @@ function isRecordCollectionValue(value) {
         return value.every(isRecord);
     return isRecord(value) && Object.values(value).every(isRecord);
 }
-function discoverViewPaths(root) {
+/** The option for one location, as a walk of the whole document would list it:
+ * own properties only, nothing under `$jsonviews`, and the canonical path
+ * spelling. Scalars are options too; they just are not record collections.
+ * Without a path, the root is the option.
+ */
+function resolveViewPathOption(root, currentPath) {
     if (!isRecord(root) && !Array.isArray(root))
-        return [];
-    const options = [];
-    const visit = (value, path) => {
-        options.push({
-            path: collectionPath(path),
-            label: path.length === 0 ? (Array.isArray(root) ? 'Data' : 'Root') : path.map((segment) => typeof segment === 'number' ? String(segment + 1) : friendlyLabel(segment)).join(' › '),
-            recordCollection: isRecordCollectionValue(value),
-        });
-        if (Array.isArray(value)) {
-            value.forEach((child, index) => visit(child, [...path, index]));
-            return;
+        return undefined;
+    const path = [];
+    let value = root;
+    if (currentPath !== undefined) {
+        let segments;
+        try {
+            segments = parseJsonViewPath(currentPath, { root: '$' }).segments;
         }
-        if (!isRecord(value))
-            return;
-        Object.entries(value)
-            .filter(([key]) => key !== '$jsonviews')
-            .forEach(([key, child]) => visit(child, [...path, key]));
+        catch {
+            return undefined;
+        }
+        for (const segment of segments) {
+            if (segment.kind === 'property') {
+                if (segment.key === '$jsonviews' || !isRecord(value) || !Object.prototype.hasOwnProperty.call(value, segment.key))
+                    return undefined;
+                value = value[segment.key];
+                path.push(segment.key);
+            }
+            else if (segment.kind === 'index') {
+                if (!Array.isArray(value) || !Object.prototype.hasOwnProperty.call(value, segment.index))
+                    return undefined;
+                value = value[segment.index];
+                path.push(segment.index);
+            }
+            else
+                return undefined;
+        }
+        if (collectionPath(path) !== currentPath)
+            return undefined;
+    }
+    return {
+        path: collectionPath(path),
+        label: path.length === 0 ? (Array.isArray(root) ? 'Data' : 'Root') : path.map((segment) => typeof segment === 'number' ? String(segment + 1) : friendlyLabel(segment)).join(' › '),
+        recordCollection: isRecordCollectionValue(value),
     };
-    visit(root, []);
-    return options;
 }
 function collectionFields(root, option, schema) {
     if (!option)
@@ -577,12 +597,11 @@ export function JsonViewAddView({ align = 'start', currentPath, disabled = false
     const popoverRef = useRef(null);
     const portalContainer = useJsonViewsPortalContainer();
     const position = useAnchoredPosition(open, triggerRef, popoverRef, 'bottom', align);
-    const options = useMemo(() => discoverViewPaths(root), [root]);
-    const selectedOption = options.find((option) => option.path === currentPath)
-        ?? (currentPath === undefined ? options[0] : undefined);
+    const selectedOption = useMemo(() => resolveViewPathOption(root, currentPath), [currentPath, root]);
     const unavailableReason = unavailableReasonOverride
         ?? (selectedOption ? undefined : 'This location is not document data that a view can target.');
-    const fields = useMemo(() => collectionFields(root, selectedOption, schema), [root, schema, selectedOption]);
+    // Field discovery reads every record; only the open popover uses it.
+    const fields = useMemo(() => open ? collectionFields(root, selectedOption, schema) : [], [open, root, schema, selectedOption]);
     const groupFields = fields.filter((field) => field.kind !== 'array' && field.kind !== 'object');
     const preferredGroup = groupFields.find((field) => field.type === 'select') ?? groupFields[0];
     const reset = () => {

package/dist/json/view-types.d.ts

@@ -4,6 +4,7 @@ import { type ValuePath } from '@script-it/json-views-core';
 import { type CompiledJsonViewMetadata } from '@script-it/json-views-core';
 import { type JsonViewSchemaExternalWidgetRenderer } from './schema-value.js';
 import type { JsonValueReplacement } from '@script-it/json-views-core';
+import type { JsonViewsTableCellOptions } from '../structured-data/table-cell-options.js';
 export interface JsonViewJsonEditing {
     canEditViews?: boolean;
     /** Why view creation is visible but unavailable. */
@@ -40,6 +41,8 @@ export interface JsonViewerProps {
     sourceVisible?: boolean;
     onSourceVisibleChange?: (visible: boolean) => void;
     sourceControl?: ReactNode;
+    /** Clamps tall table cells and reveals one on selection (default), or lets rows grow to fit. */
+    tableCells?: JsonViewsTableCellOptions;
     uiSize?: UiSize;
     viewsEnabled?: boolean;
     /** CSV is already tabular, irrespective of JSON prediction confidence. */

package/dist/json/viewers/general/json-node-view.js

@@ -60,7 +60,11 @@ function NodeView({ node, navigateTo, filePath, currentPath, currentJsonPath, cu
     }
     if (typeof node === 'string') {
         const content = (_jsx(ExpandedStringValue, { value: node, renderAsMarkdown: renderAsMarkdown, renderMarkdown: renderMarkdown }));
-        return atomicEditing ? (_jsx(AtomicValueEditor, { label: currentLabel, multiline: node.includes('\n'), onCommit: (nextValue) => atomicEditing.commit(currentJsonPath, nextValue), saving: atomicEditing.saving, value: node, children: content })) : content;
+        return atomicEditing ? (_jsx(AtomicValueEditor
+        // Shown as Markdown, the string is a document: Enter breaks the line.
+        , { 
+            // Shown as Markdown, the string is a document: Enter breaks the line.
+            enterKey: renderAsMarkdown && renderMarkdown ? 'newline' : undefined, label: currentLabel, multiline: node.includes('\n'), onCommit: (nextValue) => atomicEditing.commit(currentJsonPath, nextValue), saving: atomicEditing.saving, value: node, children: content })) : content;
     }
     const content = (_jsx("div", { className: "whitespace-pre-wrap text-sm text-foreground", style: { overflowWrap: 'anywhere' }, children: sourceLiteral !== undefined ? _jsx(JsonSourceNumber, { literal: sourceLiteral }) : String(node) }));
     return atomicEditing && isEditableAtomicValue(node) ? (_jsx(AtomicValueEditor, { label: currentLabel, onCommit: (nextValue) => atomicEditing.commit(currentJsonPath, nextValue), saving: atomicEditing.saving, value: node, children: content })) : content;
@@ -210,6 +214,6 @@ function ObjectView({ obj, navigateTo, currentJsonPath, atomicEditing, renderMar
                                     if (!atomicEditing || atomicEditing.canReplace?.(jsonPath) === false) {
                                         return (_jsx(StructuredValueCellFrame, { actions: expandAction, children: content }));
                                     }
-                                    return (_jsx(AtomicValueEditor, { actions: expandAction, label: k, multiline: true, onCommit: (nextValue) => atomicEditing.commit(jsonPath, nextValue), saving: atomicEditing.saving, value: v, children: content }));
+                                    return (_jsx(AtomicValueEditor, { actions: expandAction, enterKey: "newline", label: k, multiline: true, onCommit: (nextValue) => atomicEditing.commit(jsonPath, nextValue), saving: atomicEditing.saving, value: v, children: content }));
                                 })() : (_jsx(GeneralJsonValueCell, { atomicEditing: atomicEditing, label: k, navigateTo: () => navigateTo(k, [k]), path: [...currentJsonPath, k], renderMarkdown: renderMarkdown, renderExternalWidget: renderExternalWidget, schemaForPath: schemaForPath, value: v })) })] }, k))) }) }) }) }));
 }

package/dist/lib/enter-key.d.ts

@@ -0,0 +1,29 @@
+/** What a plain Enter does in a multiline control: save the value, or break the line. */
+export type EnterKeyBehavior = 'submit' | 'newline';
+/** Structural, so React's synthetic events and native events both fit. */
+export interface EnterKeyEvent {
+    key: string;
+    ctrlKey: boolean;
+    metaKey: boolean;
+    shiftKey: boolean;
+    isComposing?: boolean;
+    keyCode?: number;
+    nativeEvent?: {
+        isComposing?: boolean;
+    };
+}
+/** An IME is confirming composed text, so the Enter belongs to the IME.
+ *  Safari reports that keydown with keyCode 229 instead of `isComposing`. */
+export declare function isComposing(event: EnterKeyEvent): boolean;
+/**
+ * Whether a keydown saves the editor it happened in. A single-line control
+ * saves on Enter. In a multiline control Cmd/Ctrl+Enter always saves,
+ * Shift+Enter never does (the browser inserts the line break), and a plain
+ * Enter saves only when the editor's behavior is `'submit'`.
+ */
+export declare function submitsOnEnter(event: EnterKeyEvent, { multiline, enterKey }: {
+    multiline: boolean;
+    enterKey: EnterKeyBehavior;
+}): boolean;
+/** Soft keyboards have no Shift+Enter, so on mobile Return always breaks the line. */
+export declare function useEnterKeyBehavior(preferred?: EnterKeyBehavior): EnterKeyBehavior;

package/dist/lib/enter-key.js

@@ -0,0 +1,27 @@
+import { useJsonViewsDevice } from '../browser-device.js';
+/** An IME is confirming composed text, so the Enter belongs to the IME.
+ *  Safari reports that keydown with keyCode 229 instead of `isComposing`. */
+export function isComposing(event) {
+    return event.isComposing === true || event.nativeEvent?.isComposing === true || event.keyCode === 229;
+}
+/**
+ * Whether a keydown saves the editor it happened in. A single-line control
+ * saves on Enter. In a multiline control Cmd/Ctrl+Enter always saves,
+ * Shift+Enter never does (the browser inserts the line break), and a plain
+ * Enter saves only when the editor's behavior is `'submit'`.
+ */
+export function submitsOnEnter(event, { multiline, enterKey }) {
+    if (event.key !== 'Enter' || isComposing(event))
+        return false;
+    if (!multiline)
+        return true;
+    if (event.metaKey || event.ctrlKey)
+        return true;
+    if (event.shiftKey)
+        return false;
+    return enterKey === 'submit';
+}
+/** Soft keyboards have no Shift+Enter, so on mobile Return always breaks the line. */
+export function useEnterKeyBehavior(preferred = 'submit') {
+    return useJsonViewsDevice() === 'mobile' ? 'newline' : preferred;
+}

package/dist/primitives/choice-control.js

@@ -2,6 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import * as React from 'react';
 import { Check, ChevronDown, Palette } from 'lucide-react';
 import { cn } from '../lib/cn.js';
+import { isComposing } from '../lib/enter-key.js';
 import { DropdownMenu, DropdownMenuContent, DropdownMenuTrigger, } from './dropdown-menu.js';
 import { OptionPill, optionColorsForValues } from './option-pill.js';
 const OPTION_COLORS = [
@@ -59,7 +60,7 @@ export const ChoiceControl = React.forwardRef(({ mode, value, onValueChange, opt
         choose(nextValue);
     };
     const handleQueryKeyDown = (event) => {
-        if (event.key === 'Enter' && canCreate) {
+        if (event.key === 'Enter' && canCreate && !isComposing(event)) {
             event.preventDefault();
             createOption();
         }

package/dist/structured-data/atomic-value-editor.d.ts

@@ -1,10 +1,13 @@
 import { type ReactNode } from 'react';
+import { type EnterKeyBehavior } from '../lib/enter-key.js';
 import type { AtomicValue } from './atomic-value.js';
 interface AtomicValueEditorProps {
     actions?: ReactNode;
     children: ReactNode;
     className?: string;
     editorClassName?: string;
+    /** Long-form text keeps Enter for line breaks and saves on Cmd/Ctrl+Enter. */
+    enterKey?: EnterKeyBehavior;
     label: string;
     multiline?: boolean;
     onCommit: (value: AtomicValue) => Promise<void>;
@@ -17,7 +20,7 @@ export declare function EditValueAction({ disabled, label, onClick, }: {
     label: string;
     onClick: () => void;
 }): import("react").JSX.Element;
-export declare function AtomicValueEditor({ actions, children, className, editorClassName, label, multiline, onCommit, preserveLayout, saving, value, }: AtomicValueEditorProps): import("react").JSX.Element;
+export declare function AtomicValueEditor({ actions, children, className, editorClassName, enterKey, label, multiline, onCommit, preserveLayout, saving, value, }: AtomicValueEditorProps): import("react").JSX.Element;
 export declare function StructuredValueCellFrame({ activationDisabled, activationLabel, activationRole, actions, children, leading, className, onActivate, overlayActions, }: {
     activationDisabled?: boolean;
     activationLabel?: string;

package/dist/structured-data/atomic-value-editor.js

@@ -2,6 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useContext, useEffect, useLayoutEffect, useRef, useState, } from 'react';
 import { Pencil } from 'lucide-react';
 import { cn } from '../lib/cn.js';
+import { submitsOnEnter, useEnterKeyBehavior } from '../lib/enter-key.js';
 import { StructuredCellFillContext } from './structured-cell-fill-context.js';
 import { useEditBaseChanged } from './edit-base.js';
 const CONTROL_CLASS = 'min-h-8 w-full min-w-0 rounded-md border border-border bg-background px-2 [font:inherit] text-foreground outline-none transition-colors placeholder:text-muted-foreground hover:border-input focus:border-ring focus:ring-2 focus:ring-inset focus:ring-ring/20';
@@ -11,7 +12,7 @@ export function EditValueAction({ disabled = false, label, onClick, }) {
             onClick();
         }, children: _jsx(Pencil, { className: "h-3.5 w-3.5" }) }));
 }
-export function AtomicValueEditor({ actions, children, className, editorClassName, label, multiline = false, onCommit, preserveLayout = false, saving = false, value, }) {
+export function AtomicValueEditor({ actions, children, className, editorClassName, enterKey, label, multiline = false, onCommit, preserveLayout = false, saving = false, value, }) {
     const [editing, setEditing] = useState(false);
     const fillCell = useContext(StructuredCellFillContext);
     const frameRef = useRef(null);
@@ -29,7 +30,7 @@ export function AtomicValueEditor({ actions, children, className, editorClassNam
         setEditing(false);
     };
     if (editing) {
-        const editor = (_jsx(AtomicValueDirectEditor, { controlClassName: editorClassName, label: label, disabled: saving, minHeight: editorMinHeight, multiline: multiline, onCancel: stopEditing, onCommit: async (nextValue) => {
+        const editor = (_jsx(AtomicValueDirectEditor, { controlClassName: editorClassName, enterKey: enterKey, label: label, disabled: saving, minHeight: editorMinHeight, multiline: multiline, onCancel: stopEditing, onCommit: async (nextValue) => {
                 await onCommit(nextValue);
                 stopEditing();
             }, value: value }));
@@ -65,16 +66,21 @@ export function StructuredValueCellFrame({ activationDisabled = false, activatio
         // boundary of its column unmistakable.
         fillCell ? 'h-full items-center rounded-none py-2 pl-3 pr-0' : 'rounded-md px-1.5', onActivate && !activationDisabled
             ? fillCell
-                ? 'before:absolute before:inset-y-0 before:-left-5 before:right-0 hover:before:bg-primary/10 dark:hover:before:bg-primary/25'
+                ? 'before:pointer-events-none before:absolute before:inset-y-0 before:-left-5 before:right-0 hover:before:bg-primary/10 dark:hover:before:bg-primary/25'
                 : 'hover:bg-primary/10 dark:hover:bg-primary/25'
             : fillCell
-                ? 'before:absolute before:inset-y-0 before:-left-5 before:right-0 hover:before:bg-accent/70'
+                ? 'before:pointer-events-none before:absolute before:inset-y-0 before:-left-5 before:right-0 hover:before:bg-accent/70'
                 : 'hover:bg-accent/70', fillCell && onActivate && !activationDisabled && 'cursor-text', className), onClick: (event) => {
             // The table cell's padding belongs to the same action as its value.
             // Child actions keep their own handlers and must not activate twice.
             if (fillCell && event.target === event.currentTarget && !activationDisabled)
                 onActivate?.();
-        }, children: [leading && _jsx("span", { className: "mr-1.5 flex min-h-7 shrink-0 items-center", children: leading }), _jsx("div", { "data-id": onActivate ? 'atomic-edit-value' : undefined, "aria-disabled": onActivate ? activationDisabled : undefined, "aria-label": onActivate ? activationLabel : undefined, role: onActivate ? activationRole : undefined, tabIndex: onActivate && !activationDisabled ? 0 : undefined, title: onActivate ? activationLabel : undefined, className: cn('flex min-h-7 min-w-0 flex-1 items-center', fillCell && 'self-stretch', 
+        }, children: [leading && _jsx("span", { className: "mr-1.5 flex min-h-7 shrink-0 items-center", children: leading }), _jsx("div", { "data-id": onActivate ? 'atomic-edit-value' : undefined, "aria-disabled": onActivate ? activationDisabled : undefined, "aria-label": onActivate ? activationLabel : undefined, role: onActivate ? activationRole : undefined, tabIndex: onActivate && !activationDisabled ? 0 : undefined, title: onActivate ? activationLabel : undefined, className: cn('flex min-h-7 min-w-0 flex-1 items-center', 
+                // Auto margins centre a value like `items-center` does, but drop
+                // to zero when a clamped table cell is shorter than the value, so
+                // it starts at the top instead of losing its first lines above
+                // the clip.
+                fillCell && 'self-stretch *:my-auto', 
                 // The actions overlay the trailing edge, so the value ends before
                 // their lane: truncation stops short of the chip rather than being
                 // covered by it. Reserved unconditionally — sizing it on hover
@@ -113,7 +119,7 @@ export function StructuredValueCellFrame({ activationDisabled = false, activatio
                 // chip belongs beside its first line.
                 overlayActions ? 'top-2 right-2 rounded-md bg-background/90 shadow-sm' : fillCell ? 'top-1/2 -translate-y-1/2' : 'top-0.5'), children: actions }))] }));
 }
-function AtomicValueDirectEditor({ controlClassName, disabled = false, label, minHeight, multiline, onCancel, onCommit, value, }) {
+function AtomicValueDirectEditor({ controlClassName, disabled = false, enterKey: preferredEnterKey, label, minHeight, multiline, onCancel, onCommit, value, }) {
     const [draft, setDraft] = useState(typeof value === 'boolean' ? value : String(value));
     const [error, setError] = useState();
     const containerRef = useRef(null);
@@ -122,6 +128,7 @@ function AtomicValueDirectEditor({ controlClassName, disabled = false, label, mi
     const originalValueRef = useRef(value);
     const attemptedCommitRef = useRef(false);
     const baseChanged = useEditBaseChanged();
+    const enterKey = useEnterKeyBehavior(preferredEnterKey);
     useEffect(() => {
         containerRef.current?.querySelector('input, textarea')?.focus({ preventScroll: multiline });
     }, [multiline]);
@@ -130,7 +137,9 @@ function AtomicValueDirectEditor({ controlClassName, disabled = false, label, mi
             return;
         const textarea = textareaRef.current;
         textarea.style.height = 'auto';
-        textarea.style.height = `${Math.max(minHeight ?? 0, textarea.scrollHeight)}px`;
+        // A border-box height also holds the borders `scrollHeight` leaves out.
+        const borders = textarea.offsetHeight - textarea.clientHeight;
+        textarea.style.height = `${Math.max(minHeight ?? 0, textarea.scrollHeight + borders)}px`;
     }, [draft, minHeight, multiline]);
     const commit = async (nextBoolean) => {
         if (committingRef.current)
@@ -182,8 +191,7 @@ function AtomicValueDirectEditor({ controlClassName, disabled = false, label, mi
                 onCancel();
                 return;
             }
-            const isTextarea = event.target instanceof HTMLTextAreaElement;
-            if (event.key === 'Enter' && (!isTextarea || event.metaKey || event.ctrlKey)) {
+            if (submitsOnEnter(event, { multiline: event.target instanceof HTMLTextAreaElement, enterKey })) {
                 event.preventDefault();
                 void commit();
             }

package/dist/structured-data/table-cell-options.d.ts

@@ -0,0 +1,20 @@
+/** How table cells treat content taller than the cell height limit. */
+export interface JsonViewsTableCellOptions {
+    /** `'clamp'` clips each cell at the maximum height; `'grow'` lets rows fit
+     *  their tallest value. @default 'clamp' */
+    overflow?: 'clamp' | 'grow';
+    /** Pixels, or any CSS length. Sets `--json-views-table-cell-max-height`
+     *  on the table, overriding host CSS for this viewer. @default '9rem' */
+    maxHeight?: number | string;
+    /** How a clamped cell shows the rest of its content: `'select'` floats it
+     *  over the rows below while the cell is selected; `'none'` keeps it
+     *  clipped. @default 'select' */
+    reveal?: 'select' | 'none';
+}
+/** Provided by `JsonViewer`, so every table it renders shares one policy. */
+export declare const TableCellOptionsContext: import("react").Context<JsonViewsTableCellOptions | undefined>;
+export declare function resolveTableCellOptions(options: JsonViewsTableCellOptions | undefined): {
+    clamp: boolean;
+    maxHeight: string | undefined;
+    reveal: boolean;
+};