@pythia-software/query-table-ui 0.3.0 → 0.4.1

package/README.md

@@ -81,3 +81,25 @@ for customization and backend integration details.
 ## SELECT editor
 
 `QueryBuilder` includes an **Edit columns** action. The exported `SelectColumnEditor` also accepts `{ api, onClose }` for standalone use. It supports draft column ordering, a searchable catalogue, sampled value frequencies, and a lazy-loaded CodeMirror formula editor with grouped live previews and regex inspection. Shared-definition saves and query-layout application are separate actions.
+
+### Filter value presentation
+
+Queries keep stable string keys while consumers can display names and rich badges.
+Static options accept either strings (the existing API) or `{ value, label }` objects.
+Wrap the table and query builder in `FilterValueProvider` to supply presentation for
+current values, suggestions, and cell quick filters:
+
+```tsx
+<FilterValueProvider value={{
+  label: (field, key) => lookup(field, key)?.name ?? key,
+  render: (field, key) => <Badge value={lookup(field, key)} fallback={key} />,
+}}>
+  <QueryBuilder api={api} fields={schema.fields} total={api.total} />
+  <DataTable {...tableProps} />
+</FilterValueProvider>
+```
+
+The searchable static picker matches both labels and keys. Selection emits the
+canonical `value` only; presentation is never serialized into queries. A resolver
+can present a current value even when it is absent from the options. Strings without
+a presentation provider retain the existing select control.

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import * as react from 'react';
 import { ReactNode, SetStateAction } from 'react';
 import { FieldDef, QueryState, RowId, FieldStats, WhereClause } from '@pythia-software/query-table-core';
 import { SelectionApi, ColumnDragApi, QueryTableApi, AggregationsApi, SavedQueriesApi } from '@pythia-software/query-table-react';
@@ -176,4 +177,16 @@ interface SelectColumnEditorProps<Row> {
 }
 declare function SelectColumnEditor<Row>({ api, onClose, }: SelectColumnEditorProps<Row>): react_jsx_runtime.JSX.Element;
 
-export { type CellContext, CellMenu, type CellMenuProps, type CellRenderer, DataTable, type DataTableProps, FieldPicker, type FieldPickerProps, type MenuClassNames, MetricsPanel, type MetricsPanelProps, QueryBuilder, type QueryBuilderClassNames, type QueryBuilderProps, type RenderRegistry, SavedQueriesModal, type SavedQueriesModalProps, SelectColumnEditor, type SelectColumnEditorProps, SelectionToolbar, type SelectionToolbarProps, type TableClassNames, defaultRenderers, resolveRenderer, safeLinkHref };
+/** Consumer-owned presentation; canonical values remain in queries and URLs. */
+interface FilterValuePresentation {
+    label?: (field: string, value: string) => string;
+    render?: (field: string, value: string) => ReactNode;
+}
+declare const FilterValueProvider: react.Provider<FilterValuePresentation>;
+declare function PresentedFilterValue({ field, value, label }: {
+    field: string;
+    value: string;
+    label?: string;
+}): react_jsx_runtime.JSX.Element;
+
+export { type CellContext, CellMenu, type CellMenuProps, type CellRenderer, DataTable, type DataTableProps, FieldPicker, type FieldPickerProps, type FilterValuePresentation, FilterValueProvider, type MenuClassNames, MetricsPanel, type MetricsPanelProps, PresentedFilterValue, QueryBuilder, type QueryBuilderClassNames, type QueryBuilderProps, type RenderRegistry, SavedQueriesModal, type SavedQueriesModalProps, SelectColumnEditor, type SelectColumnEditorProps, SelectionToolbar, type SelectionToolbarProps, type TableClassNames, defaultRenderers, resolveRenderer, safeLinkHref };