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

package/README.md

@@ -7,7 +7,7 @@ and selection toolbar.
 ## Install
 
 ```bash
-npm install @pythia-software/query-table-core @pythia-software/query-table-react @pythia-software/query-table-ui react
+npm install @pythia-software/query-table-core @pythia-software/query-table-react @pythia-software/query-table-ui react react-dom
 ```
 
 ## Use
@@ -40,9 +40,44 @@ export function OrdersTable({ table, schema }) {
 }
 ```
 
+`DataTable` virtualizes body rows and uses a 600px maximum-height scroll
+viewport by default. Set `maxHeight` to match the surrounding layout;
+`estimateRowHeight` (37px by default) and `overscan` (8 rows) are available for
+unusually sized or expensive custom row renderers. Visible rows are measured,
+so the estimate does not require every row to have a fixed height.
+
 The bundled `link` renderer allows only HTTP(S), email, telephone, relative,
 and fragment URLs. Applications remain responsible for validating URLs emitted
 by custom renderers.
 
+The query builder's **Share** button copies a URL containing the complete
+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
+screens so columns remain comparable. It adds a scroll cue, touch-sized query
+controls, button-based reordering alongside desktop drag-and-drop, sticky row
+selection, single-column metric cards, and bottom-sheet menus and dialogs. Keep
+the standard viewport meta tag in the host page:
+
+```html
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+```
+
+Applications that omit `theme.css` and use only `classNames` are responsible for
+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.

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":"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","names":["view"]}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 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;
@@ -29,6 +30,7 @@ interface TableClassNames {
     headerRow?: string;
     th?: string;
     resizeHandle?: string;
+    resizeGuide?: string;
     tbody?: string;
     row?: string;
     rowSelected?: string;
@@ -79,6 +81,12 @@ interface DataTableProps<Row> {
     total?: number | null;
     loading?: boolean;
     emptyMessage?: string;
+    /** Maximum height of the scroll viewport. Defaults to 600px. */
+    maxHeight?: number | string;
+    /** Estimated row height in pixels; measured rows replace the estimate. Defaults to 37. */
+    estimateRowHeight?: number;
+    /** Extra rows rendered above and below the visible range. Defaults to 8. */
+    overscan?: number;
     /** Tailwind / bespoke styling slots (Mode B). */
     classNames?: TableClassNames;
 }
@@ -146,9 +154,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;
@@ -162,4 +170,10 @@ 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;
+
+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 };