@pythia-software/query-table-ui 0.9.6 → 0.9.8

package/README.md

@@ -115,7 +115,11 @@ Open **Column Widths** to resize in one step:
 - **Fit All to Screen** fills the viewport; when content overflows, narrow
   columns keep their content width and only the widest ones are trimmed. It
   sets `query.fitToScreen`, so shared links and saved queries fit each viewer's
-  available table area after loading and when that area changes.
+  available table area after loading and when that area changes. No column
+  is trimmed below what its buttons and links need (links shorten to an
+  ellipsis first); if those minimums exceed the screen, the table scrolls
+  horizontally. Set `select.minWidth` on a field whose host renderer needs
+  room the table cannot measure.
 - **Equal Widths** splits the viewport evenly.
 - **Reset Widths** drops explicit widths back to schema defaults.
 
@@ -570,7 +574,7 @@ and original/decoded copying; objects, JSON strings and escaped strings share
 the same inspector. Custom `render` functions and registered keys take precedence.
 Detail properties inherit these displays and embed initially collapsed JSON
 trees in popovers, modals, and expanded rows. A button beside the property label
-opens the full viewer with filter/highlight search, match navigation, and copy
+opens the full viewer with Filter/Find search, match navigation, and copy
 controls. JSON property options can be edited, saved, and shared through the
 existing property-view controls.
 See the [cell display guide](../../docs/cell-displays.md) for typed configuration,
@@ -649,3 +653,6 @@ Hiding a pie remainder retains the full denominator and leaves its angular
 share empty; it does not rescale the selected groups to 100%. A real group named
 Other remains visible. Both settings survive query links and saved views.
 Use `display.legendPosition: "none"` to hide the chart key.
+
+JSON inspection choices now travel with item query links and snapshots. See
+[portable inspection state and semantic attention](../../docs/json-inspection-state.md).

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode, SetStateAction, CSSProperties, ButtonHTMLAttributes, PointerEvent, Ref, MutableRefObject } from 'react';
-import { FieldDef, QueryState, LinkTargets, CellDisplay, JsonCellDisplay, RowId, AggregationClause, AggregationBucket, AggregationResultEntry, MetricValue, SavedQuery, FieldStats, WhereClause, MetricValueFormat, FieldSchema, PropertyViewState, RelationshipAdapter, ObjectReference, PropertyFormat, PropertyViewStorage, ItemPropertyMode, FormulaFunction, GroupedRow } from '@pythia-software/query-table-core';
+import { FieldDef, QueryState, LinkTargets, CellDisplay, JsonCellDisplay, JsonInspectionState, JsonInspectionScope, AttentionRegistry, RowId, AggregationClause, AggregationBucket, AggregationResultEntry, MetricValue, SavedQuery, FieldStats, WhereClause, MetricValueFormat, FieldSchema, ScopedJsonInspectionState, PropertyViewState, RelationshipAdapter, ObjectReference, PropertyFormat, PropertyViewStorage, ItemPropertyMode, FormulaFunction, GroupedRow } from '@pythia-software/query-table-core';
 import { ItemDetailsApi, SelectionApi, ColumnDragApi, QueryTableApi, QueryFilterApi, AggregationsApi, SavedQueriesApi, RequestActivityApi, PropertyViewApi, GroupingApi } from '@pythia-software/query-table-react';
 import { Placement } from '@floating-ui/react';
 
@@ -85,18 +85,6 @@ interface IconProps {
 }
 declare function Icon({ name, size, className, filled }: IconProps): react.JSX.Element;
 
-interface JsonCellProps {
-    value: unknown;
-    label?: string;
-    display?: JsonCellDisplay | undefined;
-}
-/** Compact cell plus a shared searchable inspector. Mountable outside DataTable. */
-declare function JsonCell({ value, label, display }: JsonCellProps): ReactNode;
-/** The same searchable JSON value embedded in item details, pages or host cards. */
-declare function JsonValueView({ value, label, display, compact }: JsonCellProps & {
-    compact?: boolean;
-}): ReactNode;
-
 interface JsonEntry {
     /** Unambiguous JSONPath; bracket notation preserves dots/quotes in keys. */
     path: string;
@@ -121,6 +109,30 @@ declare function inspectJsonValue(input: unknown, display?: JsonCellDisplay, inc
 /** Search keys, full paths and typed values; case insensitive, literal matching. */
 declare function searchJsonEntries(entries: JsonEntry[], search: string): JsonEntry[];
 
+interface JsonInspectionResolution {
+    status: "ready" | "unavailable";
+    missingPaths: string[];
+    selectedMatchUnavailable: boolean;
+}
+interface JsonCellProps {
+    value: unknown;
+    label?: string;
+    display?: JsonCellDisplay | undefined;
+    /** Controlled portable state. Omit to keep local state. */
+    inspectionState?: JsonInspectionState | undefined;
+    onInspectionStateChange?: ((state: JsonInspectionState) => void) | undefined;
+    inspectionScope?: JsonInspectionScope | undefined;
+    attention?: AttentionRegistry | undefined;
+    onInspectionResolution?: ((result: JsonInspectionResolution) => void) | undefined;
+}
+/** Compact cell plus a shared searchable inspector. Mountable outside DataTable. */
+declare function JsonCell(props: JsonCellProps): ReactNode;
+declare function createJsonInspectionState(inspection: JsonInspection, display?: JsonCellDisplay, compact?: boolean): JsonInspectionState;
+/** The same searchable JSON value embedded in item details, pages or host cards. */
+declare function JsonValueView(props: JsonCellProps & {
+    compact?: boolean;
+}): ReactNode;
+
 interface TableClassNames {
     wrap?: string;
     table?: string;
@@ -246,7 +258,14 @@ interface MetricClassNames {
 }
 declare function createMetricColorResolver(theme?: MetricTheme): {
     token: (name: MetricToken) => string;
-    color(field: string, value: MetricValue): string;
+    color: (field: string, value: MetricValue) => string;
+    /**
+     * Colours whole group keys drawn together. Single values resolve as
+     * `color`. A tuple's colour depends only on the theme and its values,
+     * except that tuples sharing a chart take the next free colour rather
+     * than repeat one while the palette has room.
+     */
+    tupleColors(fields: readonly string[], tuples: ReadonlyArray<readonly MetricValue[]>): (values: readonly MetricValue[]) => string;
 };
 
 interface QueryBuilderProps<Row> {
@@ -518,6 +537,12 @@ declare function RequestActivity({ activity, children, id, }: RequestActivityPro
 
 interface ObjectPropertiesProps<Row> {
     schema: FieldSchema<Row>;
+    recordId?: RowId;
+    jsonInspections?: readonly ScopedJsonInspectionState[];
+    onJsonInspectionChange?: (inspection: ScopedJsonInspectionState) => void;
+    attention?: AttentionRegistry | undefined;
+    /** Preserve focus for inspectors restored by semantic attention. */
+    preserveFocus?: boolean | undefined;
     row: Row;
     view: PropertyViewState;
     onViewChange?: (view: PropertyViewState) => void;
@@ -526,6 +551,9 @@ interface ObjectPropertiesProps<Row> {
     onOpenReference?: (reference: ObjectReference) => void;
     /** Explicit projection coverage distinguishes unloaded fields from NULL values. */
     loadedFields?: readonly string[];
+    /** The collection query the row came from, passed to renderers; group link
+     * summaries resolve their destinations from it. */
+    query?: QueryState;
     locale?: string;
     theme?: MetricTheme;
     now?: number;
@@ -635,7 +663,7 @@ declare function EditorChoice({ selected, title, detail, code, onClick, }: {
 }): react.JSX.Element;
 
 declare function useMobileLayout(): boolean;
-declare function ModalSurface({ title, onClose, children, className, chrome, returnFocus, backdropClassName, initialFocus, }: {
+declare function ModalSurface({ title, onClose, children, className, chrome, returnFocus, backdropClassName, initialFocus, preserveFocus, }: {
     title: string;
     onClose: () => void;
     children?: ReactNode;
@@ -644,6 +672,8 @@ declare function ModalSurface({ title, onClose, children, className, chrome, ret
     returnFocus?: HTMLElement | null | undefined;
     backdropClassName?: string | undefined;
     initialFocus?: string | undefined;
+    /** Semantic attention may reveal a dialog while preserving the caller's focus. */
+    preserveFocus?: boolean | undefined;
 }): ReactNode;
 
 interface ReorderItem {
@@ -760,4 +790,4 @@ declare function GroupedColumnsEditor({ controller, onClose, renderers, initialF
     renderers?: RenderRegistry<GroupedRow>;
 }): react.JSX.Element;
 
-export { type CellContext, CellMenu, type CellMenuProps, type CellRenderer, type ColumnRole, ColumnRoleBadge, DataTable, type DataTableProps, EditorChoice, EditorContext, EditorModal, type EditorPaneSize, EditorPaneTitle, EditorPanelSeparator, EditorPanelToggle, type EditorWorkbench, FieldPicker, type FieldPickerProps, type FilterValuePresentation, FilterValueProvider, FormulaEditor, type FormulaEditorActions, type FormulaEditorProps, FormulaFunctionBrowser, type GroupLinkOptions, GroupedColumnsEditor, Icon, type IconName, type IconProps, ItemDetailShare, JsonCell, type JsonCellProps, type JsonEntry, type JsonInspection, JsonValueView, Menu, type MenuAnchor, MenuButton, type MenuButtonProps, type MenuClassNames, MenuGroup, type MenuGroupProps, MenuItem, type MenuItemProps, type MenuProps, MenuSeparator, MenuSubmenu, type MenuSubmenuProps, MetricCard, type MetricCardProps, type MetricClassNames, type MetricTheme, MetricsEditor, type MetricsEditorProps, MetricsPanel, type MetricsPanelProps, ModalSurface, ObjectInspector, type ObjectInspectorProps, ObjectProperties, type ObjectPropertiesProps, PickerAnchor, PickerSurface, Popover, type PopoverProps, PresentedFilterValue, PropertyViewControls, PropertyViewEditor, QueryBuilder, type QueryBuilderClassNames, type QueryBuilderProps, QueryFilterRow, type RenderRegistry, ReorderList, RequestActivity, type RequestActivityProps, SavedQueriesModal, type SavedQueriesModalProps, SelectColumnEditor, type SelectColumnEditorProps, type SelectPresentation, SelectionToolbar, type SelectionToolbarProps, type TableClassNames, createGroupLinkRenderer, createMetricColorResolver, defaultRenderers, formatMetricOutput, formatPropertyValue, inspectJsonValue, itemDetailHref, metricTimestamp, resolveRenderer, safeLinkHref, searchJsonEntries, useEditorWorkbench, useMobileLayout, validateMetricFormat };
+export { type CellContext, CellMenu, type CellMenuProps, type CellRenderer, type ColumnRole, ColumnRoleBadge, DataTable, type DataTableProps, EditorChoice, EditorContext, EditorModal, type EditorPaneSize, EditorPaneTitle, EditorPanelSeparator, EditorPanelToggle, type EditorWorkbench, FieldPicker, type FieldPickerProps, type FilterValuePresentation, FilterValueProvider, FormulaEditor, type FormulaEditorActions, type FormulaEditorProps, FormulaFunctionBrowser, type GroupLinkOptions, GroupedColumnsEditor, Icon, type IconName, type IconProps, ItemDetailShare, JsonCell, type JsonCellProps, type JsonEntry, type JsonInspection, type JsonInspectionResolution, JsonValueView, Menu, type MenuAnchor, MenuButton, type MenuButtonProps, type MenuClassNames, MenuGroup, type MenuGroupProps, MenuItem, type MenuItemProps, type MenuProps, MenuSeparator, MenuSubmenu, type MenuSubmenuProps, MetricCard, type MetricCardProps, type MetricClassNames, type MetricTheme, MetricsEditor, type MetricsEditorProps, MetricsPanel, type MetricsPanelProps, ModalSurface, ObjectInspector, type ObjectInspectorProps, ObjectProperties, type ObjectPropertiesProps, PickerAnchor, PickerSurface, Popover, type PopoverProps, PresentedFilterValue, PropertyViewControls, PropertyViewEditor, QueryBuilder, type QueryBuilderClassNames, type QueryBuilderProps, QueryFilterRow, type RenderRegistry, ReorderList, RequestActivity, type RequestActivityProps, SavedQueriesModal, type SavedQueriesModalProps, SelectColumnEditor, type SelectColumnEditorProps, type SelectPresentation, SelectionToolbar, type SelectionToolbarProps, type TableClassNames, createGroupLinkRenderer, createJsonInspectionState, createMetricColorResolver, defaultRenderers, formatMetricOutput, formatPropertyValue, inspectJsonValue, itemDetailHref, metricTimestamp, resolveRenderer, safeLinkHref, searchJsonEntries, useEditorWorkbench, useMobileLayout, validateMetricFormat };