@pythia-software/query-table-ui 0.1.0 → 0.2.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,35 @@ 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.
+
+## 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.

package/dist/index.d.ts

@@ -29,6 +29,7 @@ interface TableClassNames {
     headerRow?: string;
     th?: string;
     resizeHandle?: string;
+    resizeGuide?: string;
     tbody?: string;
     row?: string;
     rowSelected?: string;
@@ -79,6 +80,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;
 }