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

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

@@ -0,0 +1,358 @@
+import { createId } from '@paralleldrive/cuid2';
+import { useDebounce } from '@sqlrooms/ui';
+import { Selection as MosaicSelection, } from '@uwdata/mosaic-core';
+import { useEffect, useMemo, useRef, useState, } from 'react';
+import { useStore } from 'zustand';
+import { useStoreWithMosaic } from '../MosaicSlice';
+import { createDataTableExplorerStore, } from './createDataTableExplorerStore';
+import { connectDataTableExplorerCountClient, connectDataTableExplorerPageClient, connectDataTableExplorerSummaryClients, loadDataTableExplorerSchema, } from './dataTableExplorerController';
+import { buildDataTableExplorerBaseQuery, buildDataTableExplorerPageQuery, createEmptySummaryState, isDataTableExplorerHistogramType, isDataTableExplorerUnsupportedSummaryType, } from './utils';
+/**
+ * Tracks Mosaic selection updates as a monotonically increasing version so
+ * memoized queries and lifecycle effects can respond to crossfilter changes.
+ */
+function useSelectionVersion(selection) {
+    const [version, setVersion] = useState(0);
+    useEffect(() => {
+        const handleChange = () => setVersion((value) => value + 1);
+        selection.addEventListener('value', handleChange);
+        return () => selection.removeEventListener('value', handleChange);
+    }, [selection]);
+    return version;
+}
+/**
+ * Resolves the dataTableExplorer selection, creating a crossfilter selection when the
+ * caller does not supply one, and exposes a version that changes with it.
+ */
+function useDataTableExplorerSelection(options) {
+    const { selection: providedSelection, selectionName } = options;
+    const generatedSelectionName = useMemo(() => `mosaic-data-table-explorer-${createId()}`, []);
+    const selectionKey = selectionName ?? generatedSelectionName;
+    const existingSelection = useStoreWithMosaic((state) => state.mosaic.selections[selectionKey]);
+    const getSelection = useStoreWithMosaic((state) => state.mosaic.getSelection);
+    const [fallbackSelection] = useState(() => MosaicSelection.crossfilter());
+    useEffect(() => {
+        if (!providedSelection && !existingSelection) {
+            getSelection(selectionKey, 'crossfilter');
+        }
+    }, [existingSelection, getSelection, providedSelection, selectionKey]);
+    const selection = providedSelection ?? existingSelection ?? fallbackSelection;
+    return {
+        selection,
+        selectionVersion: useSelectionVersion(selection),
+    };
+}
+/**
+ * Creates the per-dataTableExplorer local store and subscribes to the raw state slices
+ * that the public dataTableExplorer hook exposes.
+ */
+function useDataTableExplorerStoreState(options) {
+    const [dataTableExplorerStore] = useState(() => createDataTableExplorerStore({
+        initialSorting: options.initialSorting,
+        pageSize: options.pageSize,
+    }));
+    return {
+        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),
+    };
+}
+/**
+ * Derives the dataTableExplorer's field and SQL state from the current schema,
+ * selection, sorting, and pagination state.
+ */
+function useDataTableExplorerQueryState(options) {
+    const { pagination, rowSelectionVersion, schema, selection, selectionVersion, sorting, tableName, } = options;
+    const fields = schema.fields;
+    const fieldNames = useMemo(() => fields.map((field) => field.name), [fields]);
+    const filter = useMemo(() => {
+        void selectionVersion;
+        return selection.predicate();
+    }, [selection, selectionVersion]);
+    const rowFilter = useMemo(() => {
+        void rowSelectionVersion;
+        return selection.predicate();
+    }, [rowSelectionVersion, selection]);
+    const baseQuery = useMemo(() => buildDataTableExplorerBaseQuery({
+        columns: fieldNames,
+        filter,
+        sorting,
+        tableName,
+    }), [fieldNames, filter, sorting, tableName]);
+    const pageBaseQuery = useMemo(() => buildDataTableExplorerBaseQuery({
+        columns: fieldNames,
+        filter: rowFilter,
+        sorting,
+        tableName,
+    }), [fieldNames, rowFilter, sorting, tableName]);
+    return {
+        baseQuery,
+        datasetId: [tableName, ...fieldNames].join('\u0001'),
+        fieldNames,
+        fields,
+        hasFilters: Array.isArray(filter) ? filter.length > 0 : Boolean(filter),
+        pageQuery: buildDataTableExplorerPageQuery(pageBaseQuery, pagination).toString(),
+        rowFilter,
+    };
+}
+/**
+ * Owns the coordinator-backed schema, row, count, and summary client
+ * lifecycles for a dataTableExplorer instance.
+ */
+function useDataTableExplorerLifecycles(options) {
+    const { categoryLimit, columns, connection, fieldNames, fields, pageSize, pagination, dataTableExplorerStore, rowFilter, selection, selectionVersion, sorting, summaryBins, tableName, } = options;
+    const previousTableNameRef = useRef(tableName);
+    useEffect(() => {
+        dataTableExplorerStore.getState().syncPageSize(pageSize);
+    }, [pageSize, dataTableExplorerStore]);
+    useEffect(() => {
+        if (previousTableNameRef.current === tableName)
+            return;
+        selection.reset();
+        previousTableNameRef.current = tableName;
+    }, [selection, tableName]);
+    useEffect(() => {
+        dataTableExplorerStore.getState().resetPageIndex();
+    }, [dataTableExplorerStore, selectionVersion, tableName]);
+    useEffect(() => {
+        if (connection.status !== 'ready' || !tableName) {
+            dataTableExplorerStore.getState().setSchemaSuccess([]);
+            dataTableExplorerStore.getState().setSchemaError(undefined);
+            dataTableExplorerStore
+                .getState()
+                .setSchemaLoading(connection.status === 'loading');
+            return;
+        }
+        void loadDataTableExplorerSchema({
+            columns,
+            coordinator: connection.coordinator,
+            store: dataTableExplorerStore,
+            tableName,
+        });
+    }, [columns, connection, dataTableExplorerStore, tableName]);
+    useEffect(() => {
+        if (connection.status !== 'ready' || !tableName || !fieldNames.length) {
+            dataTableExplorerStore.getState().setPage({ isLoading: false });
+            return;
+        }
+        return connectDataTableExplorerPageClient({
+            connection,
+            fieldNames,
+            filter: rowFilter,
+            pagination,
+            sorting,
+            store: dataTableExplorerStore,
+            tableName,
+        });
+    }, [
+        connection,
+        fieldNames,
+        pagination,
+        dataTableExplorerStore,
+        rowFilter,
+        sorting,
+        tableName,
+    ]);
+    useEffect(() => {
+        if (connection.status !== 'ready' || !tableName) {
+            dataTableExplorerStore.getState().setFilteredCount({ isLoading: false });
+            return;
+        }
+        return connectDataTableExplorerCountClient({
+            connection,
+            filterStable: true,
+            selection,
+            store: dataTableExplorerStore,
+            tableName,
+            target: 'filtered',
+        });
+    }, [connection, dataTableExplorerStore, selection, tableName]);
+    useEffect(() => {
+        if (connection.status !== 'ready' || !tableName) {
+            dataTableExplorerStore.getState().setTotalCount({ isLoading: false });
+            return;
+        }
+        return connectDataTableExplorerCountClient({
+            connection,
+            store: dataTableExplorerStore,
+            tableName,
+            target: 'total',
+        });
+    }, [connection, dataTableExplorerStore, tableName]);
+    useEffect(() => {
+        if (connection.status !== 'ready' || !fields.length) {
+            dataTableExplorerStore.getState().clearSummaries();
+            return;
+        }
+        return connectDataTableExplorerSummaryClients({
+            categoryLimit,
+            connection,
+            fields,
+            selection,
+            store: dataTableExplorerStore,
+            summaryBins,
+            tableName,
+        });
+    }, [
+        categoryLimit,
+        connection,
+        fields,
+        dataTableExplorerStore,
+        selection,
+        summaryBins,
+        tableName,
+    ]);
+}
+/**
+ * Maps the schema fields and summary state into the column model consumed by
+ * the dataTableExplorer header and summary cells.
+ */
+function useDataTableExplorerColumns(options) {
+    const { fields, summaries } = options;
+    return useMemo(() => fields.map((field) => ({
+        field,
+        kind: isDataTableExplorerUnsupportedSummaryType(field.type)
+            ? 'unsupported'
+            : isDataTableExplorerHistogramType(field.type)
+                ? 'histogram'
+                : 'category',
+        name: field.name,
+        summary: summaries[field.name] ?? createEmptySummaryState(field),
+    })), [fields, summaries]);
+}
+/**
+ * Collapses the aggregated dataTableExplorer client state into the loading and error
+ * signals exposed from the public hook.
+ */
+function useDataTableExplorerStatus(options) {
+    const { fields, filteredCount, page, schema, summaries, totalCount } = options;
+    const hasPendingSummaryInitialization = fields.length > 0 && Object.keys(summaries).length < fields.length;
+    return {
+        isLoading: schema.isLoading ||
+            page.isLoading ||
+            filteredCount.isLoading ||
+            totalCount.isLoading ||
+            hasPendingSummaryInitialization ||
+            Object.values(summaries).some((summary) => summary.isLoading),
+        tableError: schema.error ??
+            page.error ??
+            filteredCount.error ??
+            totalCount.error ??
+            Object.values(summaries).find((summary) => summary.error)?.error,
+    };
+}
+/**
+ * Keeps the last non-empty page result visible while live brushing has moved
+ * ahead of the deferred row query, avoiding transient "No rows" flashes.
+ */
+function useDataTableExplorerVisiblePageState(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;
+}
+function getTableReference(table) {
+    return [table.table.database, table.table.schema, table.table.table]
+        .filter((part) => Boolean(part))
+        .join('.');
+}
+/**
+ * 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 { 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({
+        fields,
+        filteredCount,
+        page,
+        schema,
+        summaries,
+        totalCount,
+    });
+    const visiblePage = useDataTableExplorerVisiblePageState({
+        lastNonEmptyPageTable,
+        page,
+        pageDatasetId: datasetId,
+        rowSelectionVersion,
+        selectionVersion,
+    });
+    return {
+        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":"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","sourcesContent":["import {createId} from '@paralleldrive/cuid2';\nimport {useDebounce} from '@sqlrooms/ui';\nimport {\n  Selection as MosaicSelection,\n  type Selection,\n} from '@uwdata/mosaic-core';\nimport {\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n  type Dispatch,\n  type SetStateAction,\n} from 'react';\nimport {useStore} from 'zustand';\nimport {useStoreWithMosaic, type MosaicSliceState} from '../MosaicSlice';\nimport {\n  createDataTableExplorerStore,\n  type DataTableExplorerStore,\n  type DataTableExplorerStoreState,\n} from './createDataTableExplorerStore';\nimport {\n  connectDataTableExplorerCountClient,\n  connectDataTableExplorerPageClient,\n  connectDataTableExplorerSummaryClients,\n  loadDataTableExplorerSchema,\n} from './dataTableExplorerController';\nimport type {\n  DataTableExplorerColumnState,\n  DataTableExplorerOptions,\n  DataTableExplorerPaginationState,\n  DataTableExplorerSorting,\n  UseDataTableExplorerReturn,\n} from './types';\nimport {\n  buildDataTableExplorerBaseQuery,\n  buildDataTableExplorerPageQuery,\n  createEmptySummaryState,\n  isDataTableExplorerHistogramType,\n  isDataTableExplorerUnsupportedSummaryType,\n} from './utils';\nimport {DataTable} from '@sqlrooms/db';\n\ntype DataTableExplorerSelectionState = {\n  selection: Selection;\n  selectionVersion: number;\n};\n\ntype DataTableExplorerStoreSlice = {\n  filteredCount: DataTableExplorerStoreState['filteredCount'];\n  lastNonEmptyPageTable: DataTableExplorerStoreState['lastNonEmptyPageTable'];\n  page: DataTableExplorerStoreState['page'];\n  pagination: DataTableExplorerPaginationState;\n  dataTableExplorerStore: DataTableExplorerStore;\n  schema: DataTableExplorerStoreState['schema'];\n  setPagination: Dispatch<SetStateAction<DataTableExplorerPaginationState>>;\n  setSorting: Dispatch<SetStateAction<DataTableExplorerSorting>>;\n  sorting: DataTableExplorerSorting;\n  summaries: DataTableExplorerStoreState['summaries'];\n  totalCount: DataTableExplorerStoreState['totalCount'];\n};\n\ntype DataTableExplorerQueryState = {\n  baseQuery: ReturnType<typeof buildDataTableExplorerBaseQuery>;\n  datasetId: string;\n  fieldNames: string[];\n  fields: DataTableExplorerStoreState['schema']['fields'];\n  hasFilters: boolean;\n  pageQuery: string;\n  rowFilter: ReturnType<Selection['predicate']>;\n};\n\n/**\n * Tracks Mosaic selection updates as a monotonically increasing version so\n * memoized queries and lifecycle effects can respond to crossfilter changes.\n */\nfunction useSelectionVersion(selection: Selection) {\n  const [version, setVersion] = useState(0);\n\n  useEffect(() => {\n    const handleChange = () => setVersion((value) => value + 1);\n    selection.addEventListener('value', handleChange);\n    return () => selection.removeEventListener('value', handleChange);\n  }, [selection]);\n\n  return version;\n}\n\n/**\n * Resolves the dataTableExplorer selection, creating a crossfilter selection when the\n * caller does not supply one, and exposes a version that changes with it.\n */\nfunction useDataTableExplorerSelection(\n  options: Pick<DataTableExplorerOptions, 'selection' | 'selectionName'>,\n): DataTableExplorerSelectionState {\n  const {selection: providedSelection, selectionName} = options;\n  const generatedSelectionName = useMemo(\n    () => `mosaic-data-table-explorer-${createId()}`,\n    [],\n  );\n  const selectionKey = selectionName ?? generatedSelectionName;\n  const existingSelection = useStoreWithMosaic(\n    (state) => state.mosaic.selections[selectionKey],\n  );\n  const getSelection = useStoreWithMosaic((state) => state.mosaic.getSelection);\n  const [fallbackSelection] = useState(() => MosaicSelection.crossfilter());\n\n  useEffect(() => {\n    if (!providedSelection && !existingSelection) {\n      getSelection(selectionKey, 'crossfilter');\n    }\n  }, [existingSelection, getSelection, providedSelection, selectionKey]);\n\n  const selection = providedSelection ?? existingSelection ?? fallbackSelection;\n\n  return {\n    selection,\n    selectionVersion: useSelectionVersion(selection),\n  };\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 */\nfunction useDataTableExplorerStoreState(options: {\n  initialSorting: DataTableExplorerSorting;\n  pageSize: number;\n}): DataTableExplorerStoreSlice {\n  const [dataTableExplorerStore] = useState(() =>\n    createDataTableExplorerStore({\n      initialSorting: options.initialSorting,\n      pageSize: options.pageSize,\n    }),\n  );\n\n  return {\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\n/**\n * Derives the dataTableExplorer's field and SQL state from the current schema,\n * selection, sorting, and pagination state.\n */\nfunction useDataTableExplorerQueryState(options: {\n  pagination: DataTableExplorerPaginationState;\n  rowSelectionVersion: number;\n  schema: DataTableExplorerStoreState['schema'];\n  selection: Selection;\n  selectionVersion: number;\n  sorting: DataTableExplorerSorting;\n  tableName: string;\n}): DataTableExplorerQueryState {\n  const {\n    pagination,\n    rowSelectionVersion,\n    schema,\n    selection,\n    selectionVersion,\n    sorting,\n    tableName,\n  } = options;\n  const fields = schema.fields;\n  const fieldNames = useMemo(() => fields.map((field) => field.name), [fields]);\n  const filter = useMemo(() => {\n    void selectionVersion;\n    return selection.predicate();\n  }, [selection, selectionVersion]);\n  const rowFilter = useMemo(() => {\n    void rowSelectionVersion;\n    return selection.predicate();\n  }, [rowSelectionVersion, selection]);\n  const baseQuery = useMemo(\n    () =>\n      buildDataTableExplorerBaseQuery({\n        columns: fieldNames,\n        filter,\n        sorting,\n        tableName,\n      }),\n    [fieldNames, filter, sorting, tableName],\n  );\n  const pageBaseQuery = useMemo(\n    () =>\n      buildDataTableExplorerBaseQuery({\n        columns: fieldNames,\n        filter: rowFilter,\n        sorting,\n        tableName,\n      }),\n    [fieldNames, rowFilter, sorting, tableName],\n  );\n\n  return {\n    baseQuery,\n    datasetId: [tableName, ...fieldNames].join('\\u0001'),\n    fieldNames,\n    fields,\n    hasFilters: Array.isArray(filter) ? filter.length > 0 : Boolean(filter),\n    pageQuery: buildDataTableExplorerPageQuery(\n      pageBaseQuery,\n      pagination,\n    ).toString(),\n    rowFilter,\n  };\n}\n\n/**\n * Owns the coordinator-backed schema, row, count, and summary client\n * lifecycles for a dataTableExplorer instance.\n */\nfunction useDataTableExplorerLifecycles(options: {\n  categoryLimit: number;\n  columns?: string[];\n  connection: MosaicSliceState['mosaic']['connection'];\n  fieldNames: string[];\n  fields: DataTableExplorerStoreState['schema']['fields'];\n  pageSize: number;\n  pagination: DataTableExplorerPaginationState;\n  dataTableExplorerStore: DataTableExplorerStore;\n  rowFilter: ReturnType<Selection['predicate']>;\n  selection: Selection;\n  selectionVersion: number;\n  sorting: DataTableExplorerSorting;\n  summaryBins: number;\n  tableName: string;\n}) {\n  const {\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  } = options;\n  const previousTableNameRef = useRef(tableName);\n\n  useEffect(() => {\n    dataTableExplorerStore.getState().syncPageSize(pageSize);\n  }, [pageSize, dataTableExplorerStore]);\n\n  useEffect(() => {\n    if (previousTableNameRef.current === tableName) return;\n    selection.reset();\n    previousTableNameRef.current = tableName;\n  }, [selection, tableName]);\n\n  useEffect(() => {\n    dataTableExplorerStore.getState().resetPageIndex();\n  }, [dataTableExplorerStore, selectionVersion, tableName]);\n\n  useEffect(() => {\n    if (connection.status !== 'ready' || !tableName) {\n      dataTableExplorerStore.getState().setSchemaSuccess([]);\n      dataTableExplorerStore.getState().setSchemaError(undefined);\n      dataTableExplorerStore\n        .getState()\n        .setSchemaLoading(connection.status === 'loading');\n      return;\n    }\n\n    void loadDataTableExplorerSchema({\n      columns,\n      coordinator: connection.coordinator,\n      store: dataTableExplorerStore,\n      tableName,\n    });\n  }, [columns, connection, dataTableExplorerStore, tableName]);\n\n  useEffect(() => {\n    if (connection.status !== 'ready' || !tableName || !fieldNames.length) {\n      dataTableExplorerStore.getState().setPage({isLoading: false});\n      return;\n    }\n\n    return connectDataTableExplorerPageClient({\n      connection,\n      fieldNames,\n      filter: rowFilter,\n      pagination,\n      sorting,\n      store: dataTableExplorerStore,\n      tableName,\n    });\n  }, [\n    connection,\n    fieldNames,\n    pagination,\n    dataTableExplorerStore,\n    rowFilter,\n    sorting,\n    tableName,\n  ]);\n\n  useEffect(() => {\n    if (connection.status !== 'ready' || !tableName) {\n      dataTableExplorerStore.getState().setFilteredCount({isLoading: false});\n      return;\n    }\n\n    return connectDataTableExplorerCountClient({\n      connection,\n      filterStable: true,\n      selection,\n      store: dataTableExplorerStore,\n      tableName,\n      target: 'filtered',\n    });\n  }, [connection, dataTableExplorerStore, selection, tableName]);\n\n  useEffect(() => {\n    if (connection.status !== 'ready' || !tableName) {\n      dataTableExplorerStore.getState().setTotalCount({isLoading: false});\n      return;\n    }\n\n    return connectDataTableExplorerCountClient({\n      connection,\n      store: dataTableExplorerStore,\n      tableName,\n      target: 'total',\n    });\n  }, [connection, dataTableExplorerStore, tableName]);\n\n  useEffect(() => {\n    if (connection.status !== 'ready' || !fields.length) {\n      dataTableExplorerStore.getState().clearSummaries();\n      return;\n    }\n\n    return connectDataTableExplorerSummaryClients({\n      categoryLimit,\n      connection,\n      fields,\n      selection,\n      store: dataTableExplorerStore,\n      summaryBins,\n      tableName,\n    });\n  }, [\n    categoryLimit,\n    connection,\n    fields,\n    dataTableExplorerStore,\n    selection,\n    summaryBins,\n    tableName,\n  ]);\n}\n\n/**\n * Maps the schema fields and summary state into the column model consumed by\n * the dataTableExplorer header and summary cells.\n */\nfunction useDataTableExplorerColumns(options: {\n  fields: DataTableExplorerStoreState['schema']['fields'];\n  summaries: DataTableExplorerStoreState['summaries'];\n}) {\n  const {fields, summaries} = options;\n\n  return useMemo<DataTableExplorerColumnState[]>(\n    () =>\n      fields.map((field) => ({\n        field,\n        kind: isDataTableExplorerUnsupportedSummaryType(field.type)\n          ? 'unsupported'\n          : isDataTableExplorerHistogramType(field.type)\n            ? 'histogram'\n            : 'category',\n        name: field.name,\n        summary: summaries[field.name] ?? createEmptySummaryState(field),\n      })),\n    [fields, summaries],\n  );\n}\n\n/**\n * Collapses the aggregated dataTableExplorer client state into the loading and error\n * signals exposed from the public hook.\n */\nfunction useDataTableExplorerStatus(options: {\n  filteredCount: DataTableExplorerStoreState['filteredCount'];\n  fields: DataTableExplorerStoreState['schema']['fields'];\n  page: DataTableExplorerStoreState['page'];\n  schema: DataTableExplorerStoreState['schema'];\n  summaries: DataTableExplorerStoreState['summaries'];\n  totalCount: DataTableExplorerStoreState['totalCount'];\n}) {\n  const {fields, filteredCount, page, schema, summaries, totalCount} = options;\n  const hasPendingSummaryInitialization =\n    fields.length > 0 && Object.keys(summaries).length < fields.length;\n\n  return {\n    isLoading:\n      schema.isLoading ||\n      page.isLoading ||\n      filteredCount.isLoading ||\n      totalCount.isLoading ||\n      hasPendingSummaryInitialization ||\n      Object.values(summaries).some((summary) => summary.isLoading),\n    tableError:\n      schema.error ??\n      page.error ??\n      filteredCount.error ??\n      totalCount.error ??\n      Object.values(summaries).find((summary) => summary.error)?.error,\n  };\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 */\nfunction useDataTableExplorerVisiblePageState(options: {\n  lastNonEmptyPageTable: DataTableExplorerStoreState['lastNonEmptyPageTable'];\n  pageDatasetId: string;\n  page: DataTableExplorerStoreState['page'];\n  rowSelectionVersion: number;\n  selectionVersion: number;\n}) {\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\nfunction getTableReference(table: DataTable): string {\n  return [table.table.database, table.table.schema, table.table.table]\n    .filter((part): part is string => Boolean(part))\n    .join('.');\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    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    fields,\n    filteredCount,\n    page,\n    schema,\n    summaries,\n    totalCount,\n  });\n  const visiblePage = useDataTableExplorerVisiblePageState({\n    lastNonEmptyPageTable,\n    page,\n    pageDatasetId: datasetId,\n    rowSelectionVersion,\n    selectionVersion,\n  });\n\n  return {\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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"}