@pythia-software/query-table-ui 0.2.0 → 0.4.0

package/README.md

@@ -55,6 +55,11 @@ current query, including a saved default query. Configure `useQueryTable` with
 `syncUrl: true` so recipients load shared query URLs. Query tokens are encoded,
 not encrypted, and may contain raw filter values.
 
+`SelectionToolbar` action callbacks receive `(selectedIds, selection)`, so
+consumer-owned bulk actions can call `selection.replace(ids)` or
+`selection.retain(ids)` atomically. Existing callbacks that use only the first
+argument remain compatible.
+
 ## Mobile behavior
 
 The bundled theme keeps the table as a horizontally scrollable grid on narrow
@@ -72,3 +77,29 @@ providing their own responsive and touch-target styles.
 
 See the [repository README](https://github.com/Pythia-Software/query-table#readme)
 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/FormulaEditor-YCPICDIH.js

@@ -0,0 +1,251 @@
+// src/FormulaEditor.tsx
+import { useEffect, useRef, useState } from "react";
+import { EditorState } from "@codemirror/state";
+import {
+  EditorView,
+  keymap,
+  lineNumbers,
+  hoverTooltip
+} from "@codemirror/view";
+import { defaultKeymap, history, historyKeymap } from "@codemirror/commands";
+import {
+  autocompletion,
+  completionKeymap,
+  closeBrackets,
+  closeBracketsKeymap
+} from "@codemirror/autocomplete";
+import { linter } from "@codemirror/lint";
+import {
+  StreamLanguage,
+  syntaxHighlighting,
+  defaultHighlightStyle,
+  bracketMatching
+} from "@codemirror/language";
+import {
+  FORMULA_FUNCTIONS,
+  FormulaError
+} from "@pythia-software/query-table-core";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+var language = StreamLanguage.define({
+  token(stream) {
+    if (stream.eatSpace()) return null;
+    if (stream.match(/^"(?:[^"\\]|\\.)*"?/)) return "string";
+    if (stream.match(/^\[(?:[^\]]|\]\])*\]/)) return "variableName";
+    if (stream.match(/^(?:\d+(?:\.\d*)?|\.\d+)/)) return "number";
+    if (stream.match(/^(?:AND|OR|NOT|IN|BETWEEN|NULL|TRUE|FALSE)\b/i))
+      return "keyword";
+    if (stream.match(/^[a-zA-Z_][a-zA-Z_0-9]*/))
+      return "function(variableName)";
+    stream.next();
+    return "operator";
+  }
+});
+function signatureAt(text) {
+  const stack = [];
+  let quoted = false, field = false;
+  for (let i = 0; i < text.length; i++) {
+    const c = text[i];
+    if (quoted) {
+      if (c === "\\") i++;
+      else if (c === '"') quoted = false;
+      continue;
+    }
+    if (field) {
+      if (c === "]") {
+        if (text[i + 1] === "]") i++;
+        else field = false;
+      }
+      continue;
+    }
+    if (c === '"') {
+      quoted = true;
+      continue;
+    }
+    if (c === "[") {
+      field = true;
+      continue;
+    }
+    if (c === "(")
+      stack.push({
+        name: text.slice(0, i).match(/([A-Za-z_]+)\s*$/)?.[1]?.toUpperCase() ?? "",
+        argument: 1
+      });
+    else if (c === ")") stack.pop();
+    else if (c === "," && stack.length) stack[stack.length - 1].argument++;
+  }
+  const call = stack[stack.length - 1], spec = FORMULA_FUNCTIONS.find((f) => f.name === call?.name);
+  return spec && call ? `${spec.signature} \xB7 Argument ${call.argument} \u2014 ${spec.description}` : "Use [field] references. Ctrl+Space opens suggestions.";
+}
+function FormulaEditor({
+  value,
+  onChange,
+  fields,
+  compile
+}) {
+  const [hint, setHint] = useState(
+    "Use [field] references. Ctrl+Space opens suggestions."
+  );
+  const parent = useRef(null), editor = useRef();
+  const latest = useRef({ onChange, fields, compile });
+  latest.current = { onChange, fields, compile };
+  useEffect(() => {
+    if (!parent.current) return;
+    const view = new EditorView({
+      parent: parent.current,
+      state: EditorState.create({
+        doc: value,
+        extensions: [
+          lineNumbers(),
+          history(),
+          language,
+          syntaxHighlighting(defaultHighlightStyle),
+          bracketMatching(),
+          closeBrackets(),
+          EditorView.lineWrapping,
+          EditorView.contentAttributes.of({
+            "aria-label": "Computed column formula",
+            spellcheck: "false"
+          }),
+          keymap.of([
+            ...closeBracketsKeymap,
+            ...completionKeymap,
+            ...defaultKeymap,
+            ...historyKeymap
+          ]),
+          autocompletion({
+            override: [
+              (context) => {
+                const word = context.matchBefore(
+                  /\[[^\]]*|[a-zA-Z_][a-zA-Z_0-9]*/
+                );
+                if (!word && !context.explicit) return null;
+                return {
+                  from: word?.from ?? context.pos,
+                  options: [
+                    ...latest.current.fields.map((f) => ({
+                      label: `[${f.name.replace(/\]/g, "]]")}]`,
+                      displayLabel: f.label,
+                      detail: f.type,
+                      type: "variable",
+                      info: f.name
+                    })),
+                    ...FORMULA_FUNCTIONS.map((f) => ({
+                      label: f.name,
+                      type: "function",
+                      detail: f.signature,
+                      info: f.description,
+                      apply: `${f.name}(`
+                    })),
+                    ...[
+                      "TRUE",
+                      "FALSE",
+                      "NULL",
+                      "AND",
+                      "OR",
+                      "NOT",
+                      "IN",
+                      "BETWEEN"
+                    ].map((label) => ({ label, type: "keyword" }))
+                  ]
+                };
+              }
+            ]
+          }),
+          linter(
+            (view2) => {
+              try {
+                latest.current.compile(view2.state.doc.toString());
+                return [];
+              } catch (e) {
+                return [
+                  {
+                    from: Math.min(
+                      e instanceof FormulaError ? e.from : 0,
+                      view2.state.doc.length
+                    ),
+                    to: Math.min(
+                      e instanceof FormulaError ? e.to : view2.state.doc.length,
+                      view2.state.doc.length
+                    ),
+                    severity: "error",
+                    message: e instanceof Error ? e.message : String(e)
+                  }
+                ];
+              }
+            },
+            { delay: 250 }
+          ),
+          hoverTooltip((view2, pos) => {
+            const line = view2.state.doc.lineAt(pos);
+            const left = line.text.slice(0, pos - line.from).match(/[A-Za-z_0-9]*$/)?.[0] ?? "";
+            const right = line.text.slice(pos - line.from).match(/^[A-Za-z_0-9]*/)?.[0] ?? "";
+            const spec = FORMULA_FUNCTIONS.find(
+              (f) => f.name === (left + right).toUpperCase()
+            );
+            if (!spec) return null;
+            return {
+              pos: pos - left.length,
+              end: pos + right.length,
+              create() {
+                const dom = document.createElement("div");
+                dom.className = "qt-function-help";
+                dom.textContent = `${spec.signature} \u2014 ${spec.description}`;
+                return { dom };
+              }
+            };
+          }),
+          EditorView.updateListener.of((update) => {
+            if (update.docChanged)
+              latest.current.onChange(update.state.doc.toString());
+            if (update.docChanged || update.selectionSet)
+              setHint(
+                signatureAt(
+                  update.state.doc.sliceString(
+                    0,
+                    update.state.selection.main.head
+                  )
+                )
+              );
+          }),
+          EditorView.theme({
+            "&": {
+              fontSize: "13px",
+              border: "1px solid var(--qt-border, #cbd5e1)",
+              borderRadius: "6px"
+            },
+            ".cm-scroller": {
+              minHeight: "130px",
+              maxHeight: "260px",
+              fontFamily: "ui-monospace, monospace"
+            },
+            ".cm-content": { padding: "12px 0" },
+            ".cm-gutters": {
+              background: "var(--qt-bg-muted, #f8fafc)",
+              color: "var(--qt-muted, #64748b)"
+            }
+          })
+        ]
+      })
+    });
+    editor.current = view;
+    return () => {
+      view.destroy();
+      editor.current = void 0;
+    };
+  }, []);
+  useEffect(() => {
+    const view = editor.current;
+    if (view && view.state.doc.toString() !== value)
+      view.dispatch({
+        changes: { from: 0, to: view.state.doc.length, insert: value }
+      });
+  }, [value]);
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx("div", { ref: parent }),
+    /* @__PURE__ */ jsx("p", { className: "qt-formula-hint", "aria-live": "polite", children: hint })
+  ] });
+}
+export {
+  FormulaEditor as default
+};
+//# sourceMappingURL=FormulaEditor-YCPICDIH.js.map

package/dist/FormulaEditor-YCPICDIH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/FormulaEditor.tsx"],"sourcesContent":["import { useEffect, useRef, useState } from \"react\";\nimport { EditorState } from \"@codemirror/state\";\nimport {\n  EditorView,\n  keymap,\n  lineNumbers,\n  hoverTooltip,\n} from \"@codemirror/view\";\nimport { defaultKeymap, history, historyKeymap } from \"@codemirror/commands\";\nimport {\n  autocompletion,\n  completionKeymap,\n  closeBrackets,\n  closeBracketsKeymap,\n} from \"@codemirror/autocomplete\";\nimport { linter } from \"@codemirror/lint\";\nimport {\n  StreamLanguage,\n  syntaxHighlighting,\n  defaultHighlightStyle,\n  bracketMatching,\n} from \"@codemirror/language\";\nimport {\n  FORMULA_FUNCTIONS,\n  FormulaError,\n  type FieldDef,\n  type FormulaPlan,\n} from \"@pythia-software/query-table-core\";\n\nexport interface FormulaEditorProps {\n  value: string;\n  onChange: (value: string) => void;\n  fields: FieldDef[];\n  compile: (value: string) => FormulaPlan;\n}\nconst language = StreamLanguage.define({\n  token(stream) {\n    if (stream.eatSpace()) return null;\n    if (stream.match(/^\"(?:[^\"\\\\]|\\\\.)*\"?/)) return \"string\";\n    if (stream.match(/^\\[(?:[^\\]]|\\]\\])*\\]/)) return \"variableName\";\n    if (stream.match(/^(?:\\d+(?:\\.\\d*)?|\\.\\d+)/)) return \"number\";\n    if (stream.match(/^(?:AND|OR|NOT|IN|BETWEEN|NULL|TRUE|FALSE)\\b/i))\n      return \"keyword\";\n    if (stream.match(/^[a-zA-Z_][a-zA-Z_0-9]*/))\n      return \"function(variableName)\";\n    stream.next();\n    return \"operator\";\n  },\n});\nfunction signatureAt(text: string): string {\n  const stack: { name: string; argument: number }[] = [];\n  let quoted = false,\n    field = false;\n  for (let i = 0; i < text.length; i++) {\n    const c = text[i];\n    if (quoted) {\n      if (c === \"\\\\\") i++;\n      else if (c === '\"') quoted = false;\n      continue;\n    }\n    if (field) {\n      if (c === \"]\") {\n        if (text[i + 1] === \"]\") i++;\n        else field = false;\n      }\n      continue;\n    }\n    if (c === '\"') {\n      quoted = true;\n      continue;\n    }\n    if (c === \"[\") {\n      field = true;\n      continue;\n    }\n    if (c === \"(\")\n      stack.push({\n        name:\n          text\n            .slice(0, i)\n            .match(/([A-Za-z_]+)\\s*$/)?.[1]\n            ?.toUpperCase() ?? \"\",\n        argument: 1,\n      });\n    else if (c === \")\") stack.pop();\n    else if (c === \",\" && stack.length) stack[stack.length - 1]!.argument++;\n  }\n  const call = stack[stack.length - 1],\n    spec = FORMULA_FUNCTIONS.find((f) => f.name === call?.name);\n  return spec && call\n    ? `${spec.signature} · Argument ${call.argument} — ${spec.description}`\n    : \"Use [field] references. Ctrl+Space opens suggestions.\";\n}\nexport default function FormulaEditor({\n  value,\n  onChange,\n  fields,\n  compile,\n}: FormulaEditorProps) {\n  const [hint, setHint] = useState(\n    \"Use [field] references. Ctrl+Space opens suggestions.\",\n  );\n  const parent = useRef<HTMLDivElement>(null),\n    editor = useRef<EditorView>();\n  const latest = useRef({ onChange, fields, compile });\n  latest.current = { onChange, fields, compile };\n  useEffect(() => {\n    if (!parent.current) return;\n    const view = new EditorView({\n      parent: parent.current,\n      state: EditorState.create({\n        doc: value,\n        extensions: [\n          lineNumbers(),\n          history(),\n          language,\n          syntaxHighlighting(defaultHighlightStyle),\n          bracketMatching(),\n          closeBrackets(),\n          EditorView.lineWrapping,\n          EditorView.contentAttributes.of({\n            \"aria-label\": \"Computed column formula\",\n            spellcheck: \"false\",\n          }),\n          keymap.of([\n            ...closeBracketsKeymap,\n            ...completionKeymap,\n            ...defaultKeymap,\n            ...historyKeymap,\n          ]),\n          autocompletion({\n            override: [\n              (context) => {\n                const word = context.matchBefore(\n                  /\\[[^\\]]*|[a-zA-Z_][a-zA-Z_0-9]*/,\n                );\n                if (!word && !context.explicit) return null;\n                return {\n                  from: word?.from ?? context.pos,\n                  options: [\n                    ...latest.current.fields.map((f) => ({\n                      label: `[${f.name.replace(/\\]/g, \"]]\")}]`,\n                      displayLabel: f.label,\n                      detail: f.type,\n                      type: \"variable\",\n                      info: f.name,\n                    })),\n                    ...FORMULA_FUNCTIONS.map((f) => ({\n                      label: f.name,\n                      type: \"function\",\n                      detail: f.signature,\n                      info: f.description,\n                      apply: `${f.name}(`,\n                    })),\n                    ...[\n                      \"TRUE\",\n                      \"FALSE\",\n                      \"NULL\",\n                      \"AND\",\n                      \"OR\",\n                      \"NOT\",\n                      \"IN\",\n                      \"BETWEEN\",\n                    ].map((label) => ({ label, type: \"keyword\" })),\n                  ],\n                };\n              },\n            ],\n          }),\n          linter(\n            (view) => {\n              try {\n                latest.current.compile(view.state.doc.toString());\n                return [];\n              } catch (e) {\n                return [\n                  {\n                    from: Math.min(\n                      e instanceof FormulaError ? e.from : 0,\n                      view.state.doc.length,\n                    ),\n                    to: Math.min(\n                      e instanceof FormulaError ? e.to : view.state.doc.length,\n                      view.state.doc.length,\n                    ),\n                    severity: \"error\" as const,\n                    message: e instanceof Error ? e.message : String(e),\n                  },\n                ];\n              }\n            },\n            { delay: 250 },\n          ),\n          hoverTooltip((view, pos) => {\n            const line = view.state.doc.lineAt(pos);\n            const left =\n              line.text\n                .slice(0, pos - line.from)\n                .match(/[A-Za-z_0-9]*$/)?.[0] ?? \"\";\n            const right =\n              line.text.slice(pos - line.from).match(/^[A-Za-z_0-9]*/)?.[0] ??\n              \"\";\n            const spec = FORMULA_FUNCTIONS.find(\n              (f) => f.name === (left + right).toUpperCase(),\n            );\n            if (!spec) return null;\n            return {\n              pos: pos - left.length,\n              end: pos + right.length,\n              create() {\n                const dom = document.createElement(\"div\");\n                dom.className = \"qt-function-help\";\n                dom.textContent = `${spec.signature} — ${spec.description}`;\n                return { dom };\n              },\n            };\n          }),\n          EditorView.updateListener.of((update) => {\n            if (update.docChanged)\n              latest.current.onChange(update.state.doc.toString());\n            if (update.docChanged || update.selectionSet)\n              setHint(\n                signatureAt(\n                  update.state.doc.sliceString(\n                    0,\n                    update.state.selection.main.head,\n                  ),\n                ),\n              );\n          }),\n          EditorView.theme({\n            \"&\": {\n              fontSize: \"13px\",\n              border: \"1px solid var(--qt-border, #cbd5e1)\",\n              borderRadius: \"6px\",\n            },\n            \".cm-scroller\": {\n              minHeight: \"130px\",\n              maxHeight: \"260px\",\n              fontFamily: \"ui-monospace, monospace\",\n            },\n            \".cm-content\": { padding: \"12px 0\" },\n            \".cm-gutters\": {\n              background: \"var(--qt-bg-muted, #f8fafc)\",\n              color: \"var(--qt-muted, #64748b)\",\n            },\n          }),\n        ],\n      }),\n    });\n    editor.current = view;\n    return () => {\n      view.destroy();\n      editor.current = undefined;\n    };\n  }, []);\n  useEffect(() => {\n    const view = editor.current;\n    if (view && view.state.doc.toString() !== value)\n      view.dispatch({\n        changes: { from: 0, to: view.state.doc.length, insert: value },\n      });\n  }, [value]);\n  return (\n    <>\n      <div ref={parent} />\n      <p className=\"qt-formula-hint\" aria-live=\"polite\">\n        {hint}\n      </p>\n    </>\n  );\n}\n"],"mappings":";AAAA,SAAS,WAAW,QAAQ,gBAAgB;AAC5C,SAAS,mBAAmB;AAC5B;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,eAAe,SAAS,qBAAqB;AACtD;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,cAAc;AACvB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OAGK;AA6OH,mBACE,KADF;AArOJ,IAAM,WAAW,eAAe,OAAO;AAAA,EACrC,MAAM,QAAQ;AACZ,QAAI,OAAO,SAAS,EAAG,QAAO;AAC9B,QAAI,OAAO,MAAM,qBAAqB,EAAG,QAAO;AAChD,QAAI,OAAO,MAAM,sBAAsB,EAAG,QAAO;AACjD,QAAI,OAAO,MAAM,0BAA0B,EAAG,QAAO;AACrD,QAAI,OAAO,MAAM,+CAA+C;AAC9D,aAAO;AACT,QAAI,OAAO,MAAM,yBAAyB;AACxC,aAAO;AACT,WAAO,KAAK;AACZ,WAAO;AAAA,EACT;AACF,CAAC;AACD,SAAS,YAAY,MAAsB;AACzC,QAAM,QAA8C,CAAC;AACrD,MAAI,SAAS,OACX,QAAQ;AACV,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,IAAI,KAAK,CAAC;AAChB,QAAI,QAAQ;AACV,UAAI,MAAM,KAAM;AAAA,eACP,MAAM,IAAK,UAAS;AAC7B;AAAA,IACF;AACA,QAAI,OAAO;AACT,UAAI,MAAM,KAAK;AACb,YAAI,KAAK,IAAI,CAAC,MAAM,IAAK;AAAA,YACpB,SAAQ;AAAA,MACf;AACA;AAAA,IACF;AACA,QAAI,MAAM,KAAK;AACb,eAAS;AACT;AAAA,IACF;AACA,QAAI,MAAM,KAAK;AACb,cAAQ;AACR;AAAA,IACF;AACA,QAAI,MAAM;AACR,YAAM,KAAK;AAAA,QACT,MACE,KACG,MAAM,GAAG,CAAC,EACV,MAAM,kBAAkB,IAAI,CAAC,GAC5B,YAAY,KAAK;AAAA,QACvB,UAAU;AAAA,MACZ,CAAC;AAAA,aACM,MAAM,IAAK,OAAM,IAAI;AAAA,aACrB,MAAM,OAAO,MAAM,OAAQ,OAAM,MAAM,SAAS,CAAC,EAAG;AAAA,EAC/D;AACA,QAAM,OAAO,MAAM,MAAM,SAAS,CAAC,GACjC,OAAO,kBAAkB,KAAK,CAAC,MAAM,EAAE,SAAS,MAAM,IAAI;AAC5D,SAAO,QAAQ,OACX,GAAG,KAAK,SAAS,kBAAe,KAAK,QAAQ,WAAM,KAAK,WAAW,KACnE;AACN;AACe,SAAR,cAA+B;AAAA,EACpC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAuB;AACrB,QAAM,CAAC,MAAM,OAAO,IAAI;AAAA,IACtB;AAAA,EACF;AACA,QAAM,SAAS,OAAuB,IAAI,GACxC,SAAS,OAAmB;AAC9B,QAAM,SAAS,OAAO,EAAE,UAAU,QAAQ,QAAQ,CAAC;AACnD,SAAO,UAAU,EAAE,UAAU,QAAQ,QAAQ;AAC7C,YAAU,MAAM;AACd,QAAI,CAAC,OAAO,QAAS;AACrB,UAAM,OAAO,IAAI,WAAW;AAAA,MAC1B,QAAQ,OAAO;AAAA,MACf,OAAO,YAAY,OAAO;AAAA,QACxB,KAAK;AAAA,QACL,YAAY;AAAA,UACV,YAAY;AAAA,UACZ,QAAQ;AAAA,UACR;AAAA,UACA,mBAAmB,qBAAqB;AAAA,UACxC,gBAAgB;AAAA,UAChB,cAAc;AAAA,UACd,WAAW;AAAA,UACX,WAAW,kBAAkB,GAAG;AAAA,YAC9B,cAAc;AAAA,YACd,YAAY;AAAA,UACd,CAAC;AAAA,UACD,OAAO,GAAG;AAAA,YACR,GAAG;AAAA,YACH,GAAG;AAAA,YACH,GAAG;AAAA,YACH,GAAG;AAAA,UACL,CAAC;AAAA,UACD,eAAe;AAAA,YACb,UAAU;AAAA,cACR,CAAC,YAAY;AACX,sBAAM,OAAO,QAAQ;AAAA,kBACnB;AAAA,gBACF;AACA,oBAAI,CAAC,QAAQ,CAAC,QAAQ,SAAU,QAAO;AACvC,uBAAO;AAAA,kBACL,MAAM,MAAM,QAAQ,QAAQ;AAAA,kBAC5B,SAAS;AAAA,oBACP,GAAG,OAAO,QAAQ,OAAO,IAAI,CAAC,OAAO;AAAA,sBACnC,OAAO,IAAI,EAAE,KAAK,QAAQ,OAAO,IAAI,CAAC;AAAA,sBACtC,cAAc,EAAE;AAAA,sBAChB,QAAQ,EAAE;AAAA,sBACV,MAAM;AAAA,sBACN,MAAM,EAAE;AAAA,oBACV,EAAE;AAAA,oBACF,GAAG,kBAAkB,IAAI,CAAC,OAAO;AAAA,sBAC/B,OAAO,EAAE;AAAA,sBACT,MAAM;AAAA,sBACN,QAAQ,EAAE;AAAA,sBACV,MAAM,EAAE;AAAA,sBACR,OAAO,GAAG,EAAE,IAAI;AAAA,oBAClB,EAAE;AAAA,oBACF,GAAG;AAAA,sBACD;AAAA,sBACA;AAAA,sBACA;AAAA,sBACA;AAAA,sBACA;AAAA,sBACA;AAAA,sBACA;AAAA,sBACA;AAAA,oBACF,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,MAAM,UAAU,EAAE;AAAA,kBAC/C;AAAA,gBACF;AAAA,cACF;AAAA,YACF;AAAA,UACF,CAAC;AAAA,UACD;AAAA,YACE,CAACA,UAAS;AACR,kBAAI;AACF,uBAAO,QAAQ,QAAQA,MAAK,MAAM,IAAI,SAAS,CAAC;AAChD,uBAAO,CAAC;AAAA,cACV,SAAS,GAAG;AACV,uBAAO;AAAA,kBACL;AAAA,oBACE,MAAM,KAAK;AAAA,sBACT,aAAa,eAAe,EAAE,OAAO;AAAA,sBACrCA,MAAK,MAAM,IAAI;AAAA,oBACjB;AAAA,oBACA,IAAI,KAAK;AAAA,sBACP,aAAa,eAAe,EAAE,KAAKA,MAAK,MAAM,IAAI;AAAA,sBAClDA,MAAK,MAAM,IAAI;AAAA,oBACjB;AAAA,oBACA,UAAU;AAAA,oBACV,SAAS,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC;AAAA,kBACpD;AAAA,gBACF;AAAA,cACF;AAAA,YACF;AAAA,YACA,EAAE,OAAO,IAAI;AAAA,UACf;AAAA,UACA,aAAa,CAACA,OAAM,QAAQ;AAC1B,kBAAM,OAAOA,MAAK,MAAM,IAAI,OAAO,GAAG;AACtC,kBAAM,OACJ,KAAK,KACF,MAAM,GAAG,MAAM,KAAK,IAAI,EACxB,MAAM,gBAAgB,IAAI,CAAC,KAAK;AACrC,kBAAM,QACJ,KAAK,KAAK,MAAM,MAAM,KAAK,IAAI,EAAE,MAAM,gBAAgB,IAAI,CAAC,KAC5D;AACF,kBAAM,OAAO,kBAAkB;AAAA,cAC7B,CAAC,MAAM,EAAE,UAAU,OAAO,OAAO,YAAY;AAAA,YAC/C;AACA,gBAAI,CAAC,KAAM,QAAO;AAClB,mBAAO;AAAA,cACL,KAAK,MAAM,KAAK;AAAA,cAChB,KAAK,MAAM,MAAM;AAAA,cACjB,SAAS;AACP,sBAAM,MAAM,SAAS,cAAc,KAAK;AACxC,oBAAI,YAAY;AAChB,oBAAI,cAAc,GAAG,KAAK,SAAS,WAAM,KAAK,WAAW;AACzD,uBAAO,EAAE,IAAI;AAAA,cACf;AAAA,YACF;AAAA,UACF,CAAC;AAAA,UACD,WAAW,eAAe,GAAG,CAAC,WAAW;AACvC,gBAAI,OAAO;AACT,qBAAO,QAAQ,SAAS,OAAO,MAAM,IAAI,SAAS,CAAC;AACrD,gBAAI,OAAO,cAAc,OAAO;AAC9B;AAAA,gBACE;AAAA,kBACE,OAAO,MAAM,IAAI;AAAA,oBACf;AAAA,oBACA,OAAO,MAAM,UAAU,KAAK;AAAA,kBAC9B;AAAA,gBACF;AAAA,cACF;AAAA,UACJ,CAAC;AAAA,UACD,WAAW,MAAM;AAAA,YACf,KAAK;AAAA,cACH,UAAU;AAAA,cACV,QAAQ;AAAA,cACR,cAAc;AAAA,YAChB;AAAA,YACA,gBAAgB;AAAA,cACd,WAAW;AAAA,cACX,WAAW;AAAA,cACX,YAAY;AAAA,YACd;AAAA,YACA,eAAe,EAAE,SAAS,SAAS;AAAA,YACnC,eAAe;AAAA,cACb,YAAY;AAAA,cACZ,OAAO;AAAA,YACT;AAAA,UACF,CAAC;AAAA,QACH;AAAA,MACF,CAAC;AAAA,IACH,CAAC;AACD,WAAO,UAAU;AACjB,WAAO,MAAM;AACX,WAAK,QAAQ;AACb,aAAO,UAAU;AAAA,IACnB;AAAA,EACF,GAAG,CAAC,CAAC;AACL,YAAU,MAAM;AACd,UAAM,OAAO,OAAO;AACpB,QAAI,QAAQ,KAAK,MAAM,IAAI,SAAS,MAAM;AACxC,WAAK,SAAS;AAAA,QACZ,SAAS,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,IAAI,QAAQ,QAAQ,MAAM;AAAA,MAC/D,CAAC;AAAA,EACL,GAAG,CAAC,KAAK,CAAC;AACV,SACE,iCACE;AAAA,wBAAC,SAAI,KAAK,QAAQ;AAAA,IAClB,oBAAC,OAAE,WAAU,mBAAkB,aAAU,UACtC,gBACH;AAAA,KACF;AAEJ;","names":["view"]}

package/dist/index.d.ts

@@ -1,6 +1,8 @@
+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';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 
 interface CellContext<Row = any, V = unknown> {
     value: V;
@@ -153,9 +155,9 @@ declare function CellMenu<Row>({ field, value, x, y, onAddFilter, onClose, class
 
 interface SelectionToolbarProps {
     selection: SelectionApi;
-    /** Consumer-rendered action buttons. Receives the selected ids so the consumer
-     *  can gate/enable actions (e.g. mixed-state rules). */
-    actions: (selectedIds: RowId[]) => ReactNode;
+    /** Consumer-rendered action buttons. Receives the selected ids and the public
+     *  selection API. Existing callbacks that accept only ids remain supported. */
+    actions: (selectedIds: RowId[], selection: SelectionApi) => ReactNode;
     /** Hidden when nothing is selected unless `alwaysShow`. */
     alwaysShow?: boolean;
     className?: string;
@@ -169,4 +171,21 @@ interface SavedQueriesModalProps {
 }
 declare function SavedQueriesModal({ saved, onClose, onLoad }: SavedQueriesModalProps): ReactNode;
 
-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, SelectionToolbar, type SelectionToolbarProps, type TableClassNames, defaultRenderers, resolveRenderer, safeLinkHref };
+interface SelectColumnEditorProps<Row> {
+    api: QueryTableApi<Row>;
+    onClose: () => void;
+}
+declare function SelectColumnEditor<Row>({ api, onClose, }: SelectColumnEditorProps<Row>): react_jsx_runtime.JSX.Element;
+
+/** 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 }: {
+    field: string;
+    value: 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 };