@pythia-software/query-table-ui 0.9.7 → 0.9.9

package/README.md

@@ -574,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,
@@ -653,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;
@@ -525,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;
@@ -645,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;
@@ -654,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 {
@@ -770,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 };