@sqlrooms/mosaic 0.29.0-rc.6 → 0.29.0-rc.8

package/dist/data-table-explorer/hooks/useDataTableExplorerStoreState.js

@@ -0,0 +1,28 @@
+import { useState } from 'react';
+import { useStore } from 'zustand';
+import { createDataTableExplorerStore, } from '../createDataTableExplorerStore';
+/**
+ * Creates the per-dataTableExplorer local store and subscribes to the raw state slices
+ * that the public dataTableExplorer hook exposes.
+ */
+export function useDataTableExplorerStoreState(options) {
+    const [dataTableExplorerStore] = useState(() => createDataTableExplorerStore({
+        initialSorting: options.initialSorting,
+        pageSize: options.pageSize,
+    }));
+    return {
+        client: useStore(dataTableExplorerStore, (state) => state.client),
+        filteredCount: useStore(dataTableExplorerStore, (state) => state.filteredCount),
+        lastNonEmptyPageTable: useStore(dataTableExplorerStore, (state) => state.lastNonEmptyPageTable),
+        page: useStore(dataTableExplorerStore, (state) => state.page),
+        pagination: useStore(dataTableExplorerStore, (state) => state.pagination),
+        dataTableExplorerStore,
+        schema: useStore(dataTableExplorerStore, (state) => state.schema),
+        setPagination: useStore(dataTableExplorerStore, (state) => state.setPagination),
+        setSorting: useStore(dataTableExplorerStore, (state) => state.setSorting),
+        sorting: useStore(dataTableExplorerStore, (state) => state.sorting),
+        summaries: useStore(dataTableExplorerStore, (state) => state.summaries),
+        totalCount: useStore(dataTableExplorerStore, (state) => state.totalCount),
+    };
+}
+//# sourceMappingURL=useDataTableExplorerStoreState.js.map

package/dist/data-table-explorer/hooks/useDataTableExplorerStoreState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataTableExplorerStoreState.js","sourceRoot":"","sources":["../../../src/data-table-explorer/hooks/useDataTableExplorerStoreState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAC,QAAQ,EAAC,MAAM,SAAS,CAAC;AACjC,OAAO,EACL,4BAA4B,GAE7B,MAAM,iCAAiC,CAAC;AAwBzC;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAC5C,OAA8C;IAE9C,MAAM,CAAC,sBAAsB,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAC7C,4BAA4B,CAAC;QAC3B,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC,CACH,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,QAAQ,CAAC,sBAAsB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC;QACjE,aAAa,EAAE,QAAQ,CACrB,sBAAsB,EACtB,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,aAAa,CAC/B;QACD,qBAAqB,EAAE,QAAQ,CAC7B,sBAAsB,EACtB,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,qBAAqB,CACvC;QACD,IAAI,EAAE,QAAQ,CAAC,sBAAsB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;QAC7D,UAAU,EAAE,QAAQ,CAAC,sBAAsB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;QACzE,sBAAsB;QACtB,MAAM,EAAE,QAAQ,CAAC,sBAAsB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC;QACjE,aAAa,EAAE,QAAQ,CACrB,sBAAsB,EACtB,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,aAAa,CAC/B;QACD,UAAU,EAAE,QAAQ,CAAC,sBAAsB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;QACzE,OAAO,EAAE,QAAQ,CAAC,sBAAsB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;QACnE,SAAS,EAAE,QAAQ,CAAC,sBAAsB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;QACvE,UAAU,EAAE,QAAQ,CAAC,sBAAsB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;KAC1E,CAAC;AACJ,CAAC","sourcesContent":["import {useState} from 'react';\nimport {useStore} from 'zustand';\nimport {\n  createDataTableExplorerStore,\n  type DataTableExplorerStore,\n} from '../createDataTableExplorerStore';\nimport type {DataTableExplorerSorting} from '../types';\nimport type {DataTableExplorerStoreState} from '../createDataTableExplorerStore';\n\nexport type UseDataTableExplorerStoreStateOptions = {\n  initialSorting: DataTableExplorerSorting;\n  pageSize: number;\n};\n\nexport type UseDataTableExplorerStoreStateReturn = {\n  client: DataTableExplorerStoreState['client'];\n  filteredCount: DataTableExplorerStoreState['filteredCount'];\n  lastNonEmptyPageTable: DataTableExplorerStoreState['lastNonEmptyPageTable'];\n  page: DataTableExplorerStoreState['page'];\n  pagination: DataTableExplorerStoreState['pagination'];\n  dataTableExplorerStore: DataTableExplorerStore;\n  schema: DataTableExplorerStoreState['schema'];\n  setPagination: DataTableExplorerStoreState['setPagination'];\n  setSorting: DataTableExplorerStoreState['setSorting'];\n  sorting: DataTableExplorerStoreState['sorting'];\n  summaries: DataTableExplorerStoreState['summaries'];\n  totalCount: DataTableExplorerStoreState['totalCount'];\n};\n\n/**\n * Creates the per-dataTableExplorer local store and subscribes to the raw state slices\n * that the public dataTableExplorer hook exposes.\n */\nexport function useDataTableExplorerStoreState(\n  options: UseDataTableExplorerStoreStateOptions,\n): UseDataTableExplorerStoreStateReturn {\n  const [dataTableExplorerStore] = useState(() =>\n    createDataTableExplorerStore({\n      initialSorting: options.initialSorting,\n      pageSize: options.pageSize,\n    }),\n  );\n\n  return {\n    client: useStore(dataTableExplorerStore, (state) => state.client),\n    filteredCount: useStore(\n      dataTableExplorerStore,\n      (state) => state.filteredCount,\n    ),\n    lastNonEmptyPageTable: useStore(\n      dataTableExplorerStore,\n      (state) => state.lastNonEmptyPageTable,\n    ),\n    page: useStore(dataTableExplorerStore, (state) => state.page),\n    pagination: useStore(dataTableExplorerStore, (state) => state.pagination),\n    dataTableExplorerStore,\n    schema: useStore(dataTableExplorerStore, (state) => state.schema),\n    setPagination: useStore(\n      dataTableExplorerStore,\n      (state) => state.setPagination,\n    ),\n    setSorting: useStore(dataTableExplorerStore, (state) => state.setSorting),\n    sorting: useStore(dataTableExplorerStore, (state) => state.sorting),\n    summaries: useStore(dataTableExplorerStore, (state) => state.summaries),\n    totalCount: useStore(dataTableExplorerStore, (state) => state.totalCount),\n  };\n}\n"]}

package/dist/data-table-explorer/hooks/useDataTableExplorerVisiblePage.d.ts

@@ -0,0 +1,15 @@
+import type { Table } from 'apache-arrow';
+import type { DataTableExplorerStoreState } from '../createDataTableExplorerStore';
+export type UseDataTableExplorerVisiblePageOptions = {
+    lastNonEmptyPageTable: DataTableExplorerStoreState['lastNonEmptyPageTable'];
+    pageDatasetId: string;
+    page: DataTableExplorerStoreState['page'];
+    rowSelectionVersion: number;
+    selectionVersion: number;
+};
+/**
+ * Keeps the last non-empty page result visible while live brushing has moved
+ * ahead of the deferred row query, avoiding transient "No rows" flashes.
+ */
+export declare function useDataTableExplorerVisiblePage(options: UseDataTableExplorerVisiblePageOptions): Table | undefined;
+//# sourceMappingURL=useDataTableExplorerVisiblePage.d.ts.map

package/dist/data-table-explorer/hooks/useDataTableExplorerVisiblePage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataTableExplorerVisiblePage.d.ts","sourceRoot":"","sources":["../../../src/data-table-explorer/hooks/useDataTableExplorerVisiblePage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,EAAC,2BAA2B,EAAC,MAAM,iCAAiC,CAAC;AAEjF,MAAM,MAAM,sCAAsC,GAAG;IACnD,qBAAqB,EAAE,2BAA2B,CAAC,uBAAuB,CAAC,CAAC;IAC5E,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAC1C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,sCAAsC,GAC9C,KAAK,GAAG,SAAS,CAwBnB"}

package/dist/data-table-explorer/hooks/useDataTableExplorerVisiblePage.js

@@ -0,0 +1,21 @@
+import { useDebounce } from '@sqlrooms/ui';
+/**
+ * Keeps the last non-empty page result visible while live brushing has moved
+ * ahead of the deferred row query, avoiding transient "No rows" flashes.
+ */
+export function useDataTableExplorerVisiblePage(options) {
+    const { lastNonEmptyPageTable, page, pageDatasetId, rowSelectionVersion, selectionVersion, } = options;
+    const isRowDisplayStale = selectionVersion !== rowSelectionVersion;
+    const hasCurrentRows = !!page.pageTable && page.pageTable.numRows > 0;
+    const canReuseLastNonEmptyPage = !!lastNonEmptyPageTable &&
+        lastNonEmptyPageTable.datasetId === pageDatasetId;
+    const canShowStableEmpty = !page.isLoading &&
+        !isRowDisplayStale &&
+        (!page.pageTable || page.pageTable.numRows === 0);
+    const showStableEmpty = useDebounce(canShowStableEmpty, 120);
+    if (hasCurrentRows || !canReuseLastNonEmptyPage) {
+        return page.pageTable;
+    }
+    return showStableEmpty ? page.pageTable : lastNonEmptyPageTable.pageTable;
+}
+//# sourceMappingURL=useDataTableExplorerVisiblePage.js.map

package/dist/data-table-explorer/hooks/useDataTableExplorerVisiblePage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataTableExplorerVisiblePage.js","sourceRoot":"","sources":["../../../src/data-table-explorer/hooks/useDataTableExplorerVisiblePage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AAYzC;;;GAGG;AACH,MAAM,UAAU,+BAA+B,CAC7C,OAA+C;IAE/C,MAAM,EACJ,qBAAqB,EACrB,IAAI,EACJ,aAAa,EACb,mBAAmB,EACnB,gBAAgB,GACjB,GAAG,OAAO,CAAC;IACZ,MAAM,iBAAiB,GAAG,gBAAgB,KAAK,mBAAmB,CAAC;IACnE,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,GAAG,CAAC,CAAC;IACtE,MAAM,wBAAwB,GAC5B,CAAC,CAAC,qBAAqB;QACvB,qBAAqB,CAAC,SAAS,KAAK,aAAa,CAAC;IACpD,MAAM,kBAAkB,GACtB,CAAC,IAAI,CAAC,SAAS;QACf,CAAC,iBAAiB;QAClB,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC;IACpD,MAAM,eAAe,GAAG,WAAW,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;IAE7D,IAAI,cAAc,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,OAAO,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC,SAAS,CAAC;AAC5E,CAAC","sourcesContent":["import {useDebounce} from '@sqlrooms/ui';\nimport type {Table} from 'apache-arrow';\nimport type {DataTableExplorerStoreState} from '../createDataTableExplorerStore';\n\nexport type UseDataTableExplorerVisiblePageOptions = {\n  lastNonEmptyPageTable: DataTableExplorerStoreState['lastNonEmptyPageTable'];\n  pageDatasetId: string;\n  page: DataTableExplorerStoreState['page'];\n  rowSelectionVersion: number;\n  selectionVersion: number;\n};\n\n/**\n * Keeps the last non-empty page result visible while live brushing has moved\n * ahead of the deferred row query, avoiding transient \"No rows\" flashes.\n */\nexport function useDataTableExplorerVisiblePage(\n  options: UseDataTableExplorerVisiblePageOptions,\n): Table | undefined {\n  const {\n    lastNonEmptyPageTable,\n    page,\n    pageDatasetId,\n    rowSelectionVersion,\n    selectionVersion,\n  } = options;\n  const isRowDisplayStale = selectionVersion !== rowSelectionVersion;\n  const hasCurrentRows = !!page.pageTable && page.pageTable.numRows > 0;\n  const canReuseLastNonEmptyPage =\n    !!lastNonEmptyPageTable &&\n    lastNonEmptyPageTable.datasetId === pageDatasetId;\n  const canShowStableEmpty =\n    !page.isLoading &&\n    !isRowDisplayStale &&\n    (!page.pageTable || page.pageTable.numRows === 0);\n  const showStableEmpty = useDebounce(canShowStableEmpty, 120);\n\n  if (hasCurrentRows || !canReuseLastNonEmptyPage) {\n    return page.pageTable;\n  }\n\n  return showStableEmpty ? page.pageTable : lastNonEmptyPageTable.pageTable;\n}\n"]}

package/dist/data-table-explorer/layout.d.ts

@@ -0,0 +1,11 @@
+import type { CSSProperties } from 'react';
+import type { DataTableExplorerColumnState } from './types';
+export declare const DATA_TABLE_EXPLORER_ROW_NUMBER_COLUMN_WIDTH_PX = 40;
+export declare const DATA_TABLE_EXPLORER_DEFAULT_COLUMN_WIDTH_PX = 140;
+export declare const DATA_TABLE_EXPLORER_UNSUPPORTED_COLUMN_WIDTH_PX = 104;
+export declare const DATA_TABLE_EXPLORER_ROW_NUMBER_WIDTH_STYLE: Pick<CSSProperties, "maxWidth" | "minWidth" | "width">;
+export declare const DATA_TABLE_EXPLORER_DEFAULT_COLUMN_WIDTH_STYLE: Pick<CSSProperties, "maxWidth" | "minWidth" | "width">;
+export declare const DATA_TABLE_EXPLORER_UNSUPPORTED_COLUMN_WIDTH_STYLE: Pick<CSSProperties, "maxWidth" | "minWidth" | "width">;
+export declare function getDataTableExplorerColumnWidthPx(column: DataTableExplorerColumnState): 140 | 104;
+export declare function getDataTableExplorerTableWidth(columns: DataTableExplorerColumnState[]): number;
+//# sourceMappingURL=layout.d.ts.map

package/dist/data-table-explorer/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/data-table-explorer/layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,OAAO,CAAC;AACzC,OAAO,KAAK,EAAC,4BAA4B,EAAC,MAAM,SAAS,CAAC;AAE1D,eAAO,MAAM,8CAA8C,KAAK,CAAC;AACjE,eAAO,MAAM,2CAA2C,MAAM,CAAC;AAC/D,eAAO,MAAM,+CAA+C,MAAM,CAAC;AAYnE,eAAO,MAAM,0CAA0C,wDAEtD,CAAC;AACF,eAAO,MAAM,8CAA8C,wDAE1D,CAAC;AACF,eAAO,MAAM,kDAAkD,wDAE9D,CAAC;AAEF,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,4BAA4B,aAKrC;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,4BAA4B,EAAE,UASxC"}

package/dist/data-table-explorer/layout.js

@@ -0,0 +1,23 @@
+export const DATA_TABLE_EXPLORER_ROW_NUMBER_COLUMN_WIDTH_PX = 40;
+export const DATA_TABLE_EXPLORER_DEFAULT_COLUMN_WIDTH_PX = 140;
+export const DATA_TABLE_EXPLORER_UNSUPPORTED_COLUMN_WIDTH_PX = 104;
+function getWidthStyle(widthPx) {
+    return {
+        maxWidth: widthPx,
+        minWidth: widthPx,
+        width: widthPx,
+    };
+}
+export const DATA_TABLE_EXPLORER_ROW_NUMBER_WIDTH_STYLE = getWidthStyle(DATA_TABLE_EXPLORER_ROW_NUMBER_COLUMN_WIDTH_PX);
+export const DATA_TABLE_EXPLORER_DEFAULT_COLUMN_WIDTH_STYLE = getWidthStyle(DATA_TABLE_EXPLORER_DEFAULT_COLUMN_WIDTH_PX);
+export const DATA_TABLE_EXPLORER_UNSUPPORTED_COLUMN_WIDTH_STYLE = getWidthStyle(DATA_TABLE_EXPLORER_UNSUPPORTED_COLUMN_WIDTH_PX);
+export function getDataTableExplorerColumnWidthPx(column) {
+    return column.kind === 'unsupported'
+        ? DATA_TABLE_EXPLORER_UNSUPPORTED_COLUMN_WIDTH_PX
+        : DATA_TABLE_EXPLORER_DEFAULT_COLUMN_WIDTH_PX;
+}
+export function getDataTableExplorerTableWidth(columns) {
+    return (DATA_TABLE_EXPLORER_ROW_NUMBER_COLUMN_WIDTH_PX +
+        columns.reduce((total, column) => total + getDataTableExplorerColumnWidthPx(column), 0));
+}
+//# sourceMappingURL=layout.js.map

package/dist/data-table-explorer/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../src/data-table-explorer/layout.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,8CAA8C,GAAG,EAAE,CAAC;AACjE,MAAM,CAAC,MAAM,2CAA2C,GAAG,GAAG,CAAC;AAC/D,MAAM,CAAC,MAAM,+CAA+C,GAAG,GAAG,CAAC;AAEnE,SAAS,aAAa,CACpB,OAAe;IAEf,OAAO;QACL,QAAQ,EAAE,OAAO;QACjB,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,OAAO;KACf,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,0CAA0C,GAAG,aAAa,CACrE,8CAA8C,CAC/C,CAAC;AACF,MAAM,CAAC,MAAM,8CAA8C,GAAG,aAAa,CACzE,2CAA2C,CAC5C,CAAC;AACF,MAAM,CAAC,MAAM,kDAAkD,GAAG,aAAa,CAC7E,+CAA+C,CAChD,CAAC;AAEF,MAAM,UAAU,iCAAiC,CAC/C,MAAoC;IAEpC,OAAO,MAAM,CAAC,IAAI,KAAK,aAAa;QAClC,CAAC,CAAC,+CAA+C;QACjD,CAAC,CAAC,2CAA2C,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,OAAuC;IAEvC,OAAO,CACL,8CAA8C;QAC9C,OAAO,CAAC,MAAM,CACZ,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,GAAG,iCAAiC,CAAC,MAAM,CAAC,EACpE,CAAC,CACF,CACF,CAAC;AACJ,CAAC","sourcesContent":["import type {CSSProperties} from 'react';\nimport type {DataTableExplorerColumnState} from './types';\n\nexport const DATA_TABLE_EXPLORER_ROW_NUMBER_COLUMN_WIDTH_PX = 40;\nexport const DATA_TABLE_EXPLORER_DEFAULT_COLUMN_WIDTH_PX = 140;\nexport const DATA_TABLE_EXPLORER_UNSUPPORTED_COLUMN_WIDTH_PX = 104;\n\nfunction getWidthStyle(\n  widthPx: number,\n): Pick<CSSProperties, 'maxWidth' | 'minWidth' | 'width'> {\n  return {\n    maxWidth: widthPx,\n    minWidth: widthPx,\n    width: widthPx,\n  };\n}\n\nexport const DATA_TABLE_EXPLORER_ROW_NUMBER_WIDTH_STYLE = getWidthStyle(\n  DATA_TABLE_EXPLORER_ROW_NUMBER_COLUMN_WIDTH_PX,\n);\nexport const DATA_TABLE_EXPLORER_DEFAULT_COLUMN_WIDTH_STYLE = getWidthStyle(\n  DATA_TABLE_EXPLORER_DEFAULT_COLUMN_WIDTH_PX,\n);\nexport const DATA_TABLE_EXPLORER_UNSUPPORTED_COLUMN_WIDTH_STYLE = getWidthStyle(\n  DATA_TABLE_EXPLORER_UNSUPPORTED_COLUMN_WIDTH_PX,\n);\n\nexport function getDataTableExplorerColumnWidthPx(\n  column: DataTableExplorerColumnState,\n) {\n  return column.kind === 'unsupported'\n    ? DATA_TABLE_EXPLORER_UNSUPPORTED_COLUMN_WIDTH_PX\n    : DATA_TABLE_EXPLORER_DEFAULT_COLUMN_WIDTH_PX;\n}\n\nexport function getDataTableExplorerTableWidth(\n  columns: DataTableExplorerColumnState[],\n) {\n  return (\n    DATA_TABLE_EXPLORER_ROW_NUMBER_COLUMN_WIDTH_PX +\n    columns.reduce(\n      (total, column) => total + getDataTableExplorerColumnWidthPx(column),\n      0,\n    )\n  );\n}\n"]}

package/dist/data-table-explorer/types.d.ts

@@ -0,0 +1,90 @@
+import type { QualifiedTableName } from '@sqlrooms/db';
+import type { MosaicClient, Selection } from '@uwdata/mosaic-core';
+import type { Interval1D } from '@uwdata/mosaic-plot';
+import type { Field, Table } from 'apache-arrow';
+import type { Dispatch, SetStateAction } from 'react';
+export type DataTableExplorerSorting = Array<{
+    id: string;
+    desc: boolean;
+}>;
+export type DataTableExplorerPaginationState = {
+    pageIndex: number;
+    pageSize: number;
+};
+export type DataTableExplorerBinValue = number | Date;
+export type DataTableExplorerBin = {
+    x0: DataTableExplorerBinValue;
+    x1: DataTableExplorerBinValue;
+    length: number;
+};
+export type DataTableExplorerSummaryStatus = {
+    error?: Error;
+    isLoading: boolean;
+};
+export type DataTableExplorerHistogramSummary = DataTableExplorerSummaryStatus & {
+    filteredBins: DataTableExplorerBin[];
+    filteredNullCount: number;
+    interactor: Interval1D | null;
+    kind: 'histogram';
+    totalBins: DataTableExplorerBin[];
+    totalNullCount: number;
+    valueType: 'date' | 'number';
+};
+export type DataTableExplorerCategoryBucket = {
+    filteredCount: number;
+    key: string;
+    kind: 'null' | 'overflow' | 'unique' | 'value';
+    label: string;
+    selectable: boolean;
+    totalCount: number;
+};
+export type DataTableExplorerCategorySummary = DataTableExplorerSummaryStatus & {
+    bucketCount: number;
+    buckets: DataTableExplorerCategoryBucket[];
+    client?: MosaicClient;
+    kind: 'category';
+    selectedKey?: string;
+    toggleValue: (key: string) => void;
+};
+export type DataTableExplorerUnsupportedSummary = DataTableExplorerSummaryStatus & {
+    kind: 'unsupported';
+    label: string;
+};
+export type DataTableExplorerSummaryState = DataTableExplorerCategorySummary | DataTableExplorerHistogramSummary | DataTableExplorerUnsupportedSummary;
+export type DataTableExplorerColumnKind = 'category' | 'histogram' | 'unsupported';
+export type DataTableExplorerColumnState = {
+    field: Field;
+    kind: DataTableExplorerColumnKind;
+    name: string;
+    summary: DataTableExplorerSummaryState;
+};
+export type DataTableExplorerTableReference = string | QualifiedTableName;
+export type DataTableExplorerOptions = {
+    categoryLimit?: number;
+    columns?: string[];
+    initialSorting?: DataTableExplorerSorting;
+    pageSize?: number;
+    selection?: Selection;
+    selectionName?: string;
+    summaryBins?: number;
+    tableName: DataTableExplorerTableReference;
+};
+export type UseDataTableExplorerReturn = {
+    client: MosaicClient | null;
+    columns: DataTableExplorerColumnState[];
+    filteredRowCount?: number;
+    hasFilters: boolean;
+    isLoading: boolean;
+    pageQuery: string;
+    pageTable?: Table;
+    pagination: DataTableExplorerPaginationState;
+    reset: () => void;
+    selection: Selection;
+    setPagination: Dispatch<SetStateAction<DataTableExplorerPaginationState>>;
+    setSorting: Dispatch<SetStateAction<DataTableExplorerSorting>>;
+    sorting: DataTableExplorerSorting;
+    sql: string;
+    tableError?: Error;
+    totalRowCount?: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/data-table-explorer/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/data-table-explorer/types.ts"],"names":[],"mappings":"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"}

package/dist/data-table-explorer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/data-table-explorer/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {QualifiedTableName} from '@sqlrooms/db';\nimport type {MosaicClient, Selection} from '@uwdata/mosaic-core';\nimport type {Interval1D} from '@uwdata/mosaic-plot';\nimport type {Field, Table} from 'apache-arrow';\nimport type {Dispatch, SetStateAction} from 'react';\n\nexport type DataTableExplorerSorting = Array<{id: string; desc: boolean}>;\n\nexport type DataTableExplorerPaginationState = {\n  pageIndex: number;\n  pageSize: number;\n};\n\nexport type DataTableExplorerBinValue = number | Date;\n\nexport type DataTableExplorerBin = {\n  x0: DataTableExplorerBinValue;\n  x1: DataTableExplorerBinValue;\n  length: number;\n};\n\nexport type DataTableExplorerSummaryStatus = {\n  error?: Error;\n  isLoading: boolean;\n};\n\nexport type DataTableExplorerHistogramSummary =\n  DataTableExplorerSummaryStatus & {\n    filteredBins: DataTableExplorerBin[];\n    filteredNullCount: number;\n    interactor: Interval1D | null;\n    kind: 'histogram';\n    totalBins: DataTableExplorerBin[];\n    totalNullCount: number;\n    valueType: 'date' | 'number';\n  };\n\nexport type DataTableExplorerCategoryBucket = {\n  filteredCount: number;\n  key: string;\n  kind: 'null' | 'overflow' | 'unique' | 'value';\n  label: string;\n  selectable: boolean;\n  totalCount: number;\n};\n\nexport type DataTableExplorerCategorySummary =\n  DataTableExplorerSummaryStatus & {\n    bucketCount: number;\n    buckets: DataTableExplorerCategoryBucket[];\n    client?: MosaicClient;\n    kind: 'category';\n    selectedKey?: string;\n    toggleValue: (key: string) => void;\n  };\n\nexport type DataTableExplorerUnsupportedSummary =\n  DataTableExplorerSummaryStatus & {\n    kind: 'unsupported';\n    label: string;\n  };\n\nexport type DataTableExplorerSummaryState =\n  | DataTableExplorerCategorySummary\n  | DataTableExplorerHistogramSummary\n  | DataTableExplorerUnsupportedSummary;\n\nexport type DataTableExplorerColumnKind =\n  | 'category'\n  | 'histogram'\n  | 'unsupported';\n\nexport type DataTableExplorerColumnState = {\n  field: Field;\n  kind: DataTableExplorerColumnKind;\n  name: string;\n  summary: DataTableExplorerSummaryState;\n};\n\nexport type DataTableExplorerTableReference = string | QualifiedTableName;\n\nexport type DataTableExplorerOptions = {\n  categoryLimit?: number;\n  columns?: string[];\n  initialSorting?: DataTableExplorerSorting;\n  pageSize?: number;\n  selection?: Selection;\n  selectionName?: string;\n  summaryBins?: number;\n  tableName: DataTableExplorerTableReference;\n};\n\nexport type UseDataTableExplorerReturn = {\n  client: MosaicClient | null;\n  columns: DataTableExplorerColumnState[];\n  filteredRowCount?: number;\n  hasFilters: boolean;\n  isLoading: boolean;\n  pageQuery: string;\n  pageTable?: Table;\n  pagination: DataTableExplorerPaginationState;\n  reset: () => void;\n  selection: Selection;\n  setPagination: Dispatch<SetStateAction<DataTableExplorerPaginationState>>;\n  setSorting: Dispatch<SetStateAction<DataTableExplorerSorting>>;\n  sorting: DataTableExplorerSorting;\n  sql: string;\n  tableError?: Error;\n  totalRowCount?: number;\n};\n"]}

package/dist/data-table-explorer/useDataTableExplorer.d.ts

@@ -0,0 +1,7 @@
+import type { DataTableExplorerOptions, UseDataTableExplorerReturn } from './types';
+/**
+ * Aggregates Mosaic-backed schema, rows, counts, and summaries into the stable
+ * public dataTableExplorer API consumed by the React table UI.
+ */
+export declare function useDataTableExplorer(options: DataTableExplorerOptions): UseDataTableExplorerReturn;
+//# sourceMappingURL=useDataTableExplorer.d.ts.map

package/dist/data-table-explorer/useDataTableExplorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataTableExplorer.d.ts","sourceRoot":"","sources":["../../src/data-table-explorer/useDataTableExplorer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAC3B,MAAM,SAAS,CAAC;AAejB;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,wBAAwB,GAChC,0BAA0B,CA+G5B"}

package/dist/data-table-explorer/useDataTableExplorer.js

@@ -0,0 +1,95 @@
+import { useDebounce } from '@sqlrooms/ui';
+import { useStoreWithMosaic } from '../MosaicSlice';
+import { useDataTableExplorerSelection } from './hooks/useDataTableExplorerSelection';
+import { useDataTableExplorerStoreState } from './hooks/useDataTableExplorerStoreState';
+import { useDataTableExplorerQueryState } from './hooks/useDataTableExplorerQueryState';
+import { useDataTableExplorerLifecycles } from './hooks/useDataTableExplorerLifecycles';
+import { useDataTableExplorerColumns } from './hooks/useDataTableExplorerColumns';
+import { useDataTableExplorerStatus } from './hooks/useDataTableExplorerStatus';
+import { useDataTableExplorerVisiblePage } from './hooks/useDataTableExplorerVisiblePage';
+function getTableReference(tableName) {
+    return typeof tableName === 'string' ? tableName : tableName.toString();
+}
+/**
+ * Aggregates Mosaic-backed schema, rows, counts, and summaries into the stable
+ * public dataTableExplorer API consumed by the React table UI.
+ */
+export function useDataTableExplorer(options) {
+    const { categoryLimit = 20, columns, initialSorting = [], pageSize = 100, selection: providedSelection, selectionName, summaryBins = 18, tableName: table, } = options;
+    const tableName = getTableReference(table);
+    const connection = useStoreWithMosaic((state) => state.mosaic.connection);
+    const { selection, selectionVersion } = useDataTableExplorerSelection({
+        selection: providedSelection,
+        selectionName,
+    });
+    const rowSelectionVersion = useDebounce(selectionVersion, 100);
+    const { client, filteredCount, lastNonEmptyPageTable, page, pagination, dataTableExplorerStore, schema: rawSchema, setPagination, setSorting, sorting, summaries, totalCount, } = useDataTableExplorerStoreState({
+        initialSorting,
+        pageSize,
+    });
+    const schema = rawSchema.tableName === tableName
+        ? rawSchema
+        : { ...rawSchema, fields: [], isLoading: true };
+    const { baseQuery, datasetId, fieldNames, fields, hasFilters, pageQuery, rowFilter, } = useDataTableExplorerQueryState({
+        pagination,
+        rowSelectionVersion,
+        schema,
+        selection,
+        selectionVersion,
+        sorting,
+        tableName,
+    });
+    useDataTableExplorerLifecycles({
+        categoryLimit,
+        columns,
+        connection,
+        fieldNames,
+        fields,
+        pageSize,
+        pagination,
+        dataTableExplorerStore,
+        rowFilter,
+        selection,
+        selectionVersion,
+        sorting,
+        summaryBins,
+        tableName,
+    });
+    const dataTableExplorerColumns = useDataTableExplorerColumns({
+        fields,
+        summaries,
+    });
+    const { isLoading, tableError } = useDataTableExplorerStatus({
+        filteredCount,
+        page,
+        schema,
+        summaries,
+        totalCount,
+    });
+    const visiblePage = useDataTableExplorerVisiblePage({
+        lastNonEmptyPageTable,
+        page,
+        pageDatasetId: datasetId,
+        rowSelectionVersion,
+        selectionVersion,
+    });
+    return {
+        client,
+        columns: dataTableExplorerColumns,
+        filteredRowCount: filteredCount.count,
+        hasFilters,
+        isLoading,
+        pageQuery,
+        pageTable: visiblePage,
+        pagination,
+        reset: () => selection.reset(),
+        selection,
+        setPagination,
+        setSorting,
+        sorting,
+        sql: baseQuery.toString(),
+        tableError,
+        totalRowCount: totalCount.count,
+    };
+}
+//# sourceMappingURL=useDataTableExplorer.js.map

package/dist/data-table-explorer/useDataTableExplorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataTableExplorer.js","sourceRoot":"","sources":["../../src/data-table-explorer/useDataTableExplorer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AACzC,OAAO,EAAC,kBAAkB,EAAC,MAAM,gBAAgB,CAAC;AAKlD,OAAO,EAAC,6BAA6B,EAAC,MAAM,uCAAuC,CAAC;AACpF,OAAO,EAAC,8BAA8B,EAAC,MAAM,wCAAwC,CAAC;AACtF,OAAO,EAAC,8BAA8B,EAAC,MAAM,wCAAwC,CAAC;AACtF,OAAO,EAAC,8BAA8B,EAAC,MAAM,wCAAwC,CAAC;AACtF,OAAO,EAAC,2BAA2B,EAAC,MAAM,qCAAqC,CAAC;AAChF,OAAO,EAAC,0BAA0B,EAAC,MAAM,oCAAoC,CAAC;AAC9E,OAAO,EAAC,+BAA+B,EAAC,MAAM,yCAAyC,CAAC;AAExF,SAAS,iBAAiB,CACxB,SAAgD;IAEhD,OAAO,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;AAC1E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAiC;IAEjC,MAAM,EACJ,aAAa,GAAG,EAAE,EAClB,OAAO,EACP,cAAc,GAAG,EAAE,EACnB,QAAQ,GAAG,GAAG,EACd,SAAS,EAAE,iBAAiB,EAC5B,aAAa,EACb,WAAW,GAAG,EAAE,EAChB,SAAS,EAAE,KAAK,GACjB,GAAG,OAAO,CAAC;IAEZ,MAAM,SAAS,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAE3C,MAAM,UAAU,GAAG,kBAAkB,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC1E,MAAM,EAAC,SAAS,EAAE,gBAAgB,EAAC,GAAG,6BAA6B,CAAC;QAClE,SAAS,EAAE,iBAAiB;QAC5B,aAAa;KACd,CAAC,CAAC;IACH,MAAM,mBAAmB,GAAG,WAAW,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAC/D,MAAM,EACJ,MAAM,EACN,aAAa,EACb,qBAAqB,EACrB,IAAI,EACJ,UAAU,EACV,sBAAsB,EACtB,MAAM,EAAE,SAAS,EACjB,aAAa,EACb,UAAU,EACV,OAAO,EACP,SAAS,EACT,UAAU,GACX,GAAG,8BAA8B,CAAC;QACjC,cAAc;QACd,QAAQ;KACT,CAAC,CAAC;IACH,MAAM,MAAM,GACV,SAAS,CAAC,SAAS,KAAK,SAAS;QAC/B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,EAAC,GAAG,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAC,CAAC;IAClD,MAAM,EACJ,SAAS,EACT,SAAS,EACT,UAAU,EACV,MAAM,EACN,UAAU,EACV,SAAS,EACT,SAAS,GACV,GAAG,8BAA8B,CAAC;QACjC,UAAU;QACV,mBAAmB;QACnB,MAAM;QACN,SAAS;QACT,gBAAgB;QAChB,OAAO;QACP,SAAS;KACV,CAAC,CAAC;IACH,8BAA8B,CAAC;QAC7B,aAAa;QACb,OAAO;QACP,UAAU;QACV,UAAU;QACV,MAAM;QACN,QAAQ;QACR,UAAU;QACV,sBAAsB;QACtB,SAAS;QACT,SAAS;QACT,gBAAgB;QAChB,OAAO;QACP,WAAW;QACX,SAAS;KACV,CAAC,CAAC;IACH,MAAM,wBAAwB,GAAG,2BAA2B,CAAC;QAC3D,MAAM;QACN,SAAS;KACV,CAAC,CAAC;IACH,MAAM,EAAC,SAAS,EAAE,UAAU,EAAC,GAAG,0BAA0B,CAAC;QACzD,aAAa;QACb,IAAI;QACJ,MAAM;QACN,SAAS;QACT,UAAU;KACX,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,+BAA+B,CAAC;QAClD,qBAAqB;QACrB,IAAI;QACJ,aAAa,EAAE,SAAS;QACxB,mBAAmB;QACnB,gBAAgB;KACjB,CAAC,CAAC;IAEH,OAAO;QACL,MAAM;QACN,OAAO,EAAE,wBAAwB;QACjC,gBAAgB,EAAE,aAAa,CAAC,KAAK;QACrC,UAAU;QACV,SAAS;QACT,SAAS;QACT,SAAS,EAAE,WAAW;QACtB,UAAU;QACV,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE;QAC9B,SAAS;QACT,aAAa;QACb,UAAU;QACV,OAAO;QACP,GAAG,EAAE,SAAS,CAAC,QAAQ,EAAE;QACzB,UAAU;QACV,aAAa,EAAE,UAAU,CAAC,KAAK;KAChC,CAAC;AACJ,CAAC","sourcesContent":["import {useDebounce} from '@sqlrooms/ui';\nimport {useStoreWithMosaic} from '../MosaicSlice';\nimport type {\n  DataTableExplorerOptions,\n  UseDataTableExplorerReturn,\n} from './types';\nimport {useDataTableExplorerSelection} from './hooks/useDataTableExplorerSelection';\nimport {useDataTableExplorerStoreState} from './hooks/useDataTableExplorerStoreState';\nimport {useDataTableExplorerQueryState} from './hooks/useDataTableExplorerQueryState';\nimport {useDataTableExplorerLifecycles} from './hooks/useDataTableExplorerLifecycles';\nimport {useDataTableExplorerColumns} from './hooks/useDataTableExplorerColumns';\nimport {useDataTableExplorerStatus} from './hooks/useDataTableExplorerStatus';\nimport {useDataTableExplorerVisiblePage} from './hooks/useDataTableExplorerVisiblePage';\n\nfunction getTableReference(\n  tableName: DataTableExplorerOptions['tableName'],\n): string {\n  return typeof tableName === 'string' ? tableName : tableName.toString();\n}\n\n/**\n * Aggregates Mosaic-backed schema, rows, counts, and summaries into the stable\n * public dataTableExplorer API consumed by the React table UI.\n */\nexport function useDataTableExplorer(\n  options: DataTableExplorerOptions,\n): UseDataTableExplorerReturn {\n  const {\n    categoryLimit = 20,\n    columns,\n    initialSorting = [],\n    pageSize = 100,\n    selection: providedSelection,\n    selectionName,\n    summaryBins = 18,\n    tableName: table,\n  } = options;\n\n  const tableName = getTableReference(table);\n\n  const connection = useStoreWithMosaic((state) => state.mosaic.connection);\n  const {selection, selectionVersion} = useDataTableExplorerSelection({\n    selection: providedSelection,\n    selectionName,\n  });\n  const rowSelectionVersion = useDebounce(selectionVersion, 100);\n  const {\n    client,\n    filteredCount,\n    lastNonEmptyPageTable,\n    page,\n    pagination,\n    dataTableExplorerStore,\n    schema: rawSchema,\n    setPagination,\n    setSorting,\n    sorting,\n    summaries,\n    totalCount,\n  } = useDataTableExplorerStoreState({\n    initialSorting,\n    pageSize,\n  });\n  const schema =\n    rawSchema.tableName === tableName\n      ? rawSchema\n      : {...rawSchema, fields: [], isLoading: true};\n  const {\n    baseQuery,\n    datasetId,\n    fieldNames,\n    fields,\n    hasFilters,\n    pageQuery,\n    rowFilter,\n  } = useDataTableExplorerQueryState({\n    pagination,\n    rowSelectionVersion,\n    schema,\n    selection,\n    selectionVersion,\n    sorting,\n    tableName,\n  });\n  useDataTableExplorerLifecycles({\n    categoryLimit,\n    columns,\n    connection,\n    fieldNames,\n    fields,\n    pageSize,\n    pagination,\n    dataTableExplorerStore,\n    rowFilter,\n    selection,\n    selectionVersion,\n    sorting,\n    summaryBins,\n    tableName,\n  });\n  const dataTableExplorerColumns = useDataTableExplorerColumns({\n    fields,\n    summaries,\n  });\n  const {isLoading, tableError} = useDataTableExplorerStatus({\n    filteredCount,\n    page,\n    schema,\n    summaries,\n    totalCount,\n  });\n  const visiblePage = useDataTableExplorerVisiblePage({\n    lastNonEmptyPageTable,\n    page,\n    pageDatasetId: datasetId,\n    rowSelectionVersion,\n    selectionVersion,\n  });\n\n  return {\n    client,\n    columns: dataTableExplorerColumns,\n    filteredRowCount: filteredCount.count,\n    hasFilters,\n    isLoading,\n    pageQuery,\n    pageTable: visiblePage,\n    pagination,\n    reset: () => selection.reset(),\n    selection,\n    setPagination,\n    setSorting,\n    sorting,\n    sql: baseQuery.toString(),\n    tableError,\n    totalRowCount: totalCount.count,\n  };\n}\n"]}

package/dist/data-table-explorer/utils.d.ts

@@ -0,0 +1,61 @@
+import type { FieldInfo } from '@uwdata/mosaic-core';
+import { Query } from '@uwdata/mosaic-sql';
+import * as arrow from 'apache-arrow';
+import type { DataTableExplorerBin, DataTableExplorerCategoryBucket, DataTableExplorerPaginationState, DataTableExplorerSorting, DataTableExplorerSummaryState } from './types';
+export type CategoryCountRow = {
+    bucketKind: 'null' | 'unique' | 'value';
+    total: number;
+    typedValue: unknown;
+};
+type QueryWhereInput = Parameters<ReturnType<typeof Query.from>['where']>[0];
+export declare function isDataTableExplorerHistogramType(type: arrow.DataType): boolean;
+export declare function isDataTableExplorerUnsupportedSummaryType(type: arrow.DataType): boolean;
+export declare function getDataTableExplorerValueType(type: arrow.DataType): 'date' | 'number' | 'string';
+export declare function buildSchemaQuery(tableName: string, columns?: string[]): ReturnType<typeof Query.from>;
+export declare function fieldInfoToDataTableExplorerField(info: FieldInfo): arrow.Field;
+export declare function buildDataTableExplorerBaseQuery(args: {
+    columns?: string[];
+    filter?: QueryWhereInput;
+    sorting?: DataTableExplorerSorting;
+    tableName: string;
+}): import("@uwdata/mosaic-sql").SelectQuery;
+export declare function buildDataTableExplorerPageQuery(baseQuery: ReturnType<typeof buildDataTableExplorerBaseQuery>, pagination: DataTableExplorerPaginationState): import("@uwdata/mosaic-sql").SelectQuery;
+export declare function normalizeDataTableExplorerPagination(pagination: Partial<DataTableExplorerPaginationState> | undefined): DataTableExplorerPaginationState;
+export declare function buildCountQuery(args: {
+    filter?: QueryWhereInput;
+    tableName: string;
+}): import("@uwdata/mosaic-sql").SelectQuery;
+export declare function buildDistinctCountQuery(args: {
+    filter?: QueryWhereInput;
+    fieldName: string;
+    tableName: string;
+}): import("@uwdata/mosaic-sql").SelectQuery;
+export declare function readCountData(data: unknown): number | undefined;
+export declare function rowsFromQueryResult<T>(data: unknown): T[];
+export declare function buildCategorySummaryQuery(tableName: string, fieldName: string, filter?: QueryWhereInput): import("@uwdata/mosaic-sql").SelectQuery;
+export declare function splitHistogramBins(rows: Array<{
+    x1: DataTableExplorerBin['x0'] | null;
+    x2: DataTableExplorerBin['x1'] | null;
+    y: number;
+}>): {
+    bins: DataTableExplorerBin[];
+    nullCount: number;
+};
+export declare function buildCategoryBuckets(filteredRows: CategoryCountRow[], totalRows: CategoryCountRow[], categoryLimit: number, selectedKey?: string): {
+    bucketCount: number;
+    buckets: DataTableExplorerCategoryBucket[];
+    selectedKey: string | undefined;
+};
+export declare function isSelectableCategoryKey(key: string): boolean;
+export declare function categoryKeyToSelectionValue(key?: string): unknown;
+export declare function serializeCategoryBucketKey(row: {
+    bucketKind: CategoryCountRow['bucketKind'];
+    typedValue: unknown;
+}): string;
+export declare function parseCategoryBucketKey(key: string): {
+    bucketKind: CategoryCountRow['bucketKind'];
+    typedValue: unknown;
+} | undefined;
+export declare function createEmptySummaryState(field: arrow.Field): DataTableExplorerSummaryState;
+export {};
+//# sourceMappingURL=utils.d.ts.map

package/dist/data-table-explorer/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/data-table-explorer/utils.ts"],"names":[],"mappings":"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"}