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

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

@@ -0,0 +1,130 @@
+import { queryFieldInfo } from '@uwdata/mosaic-core';
+import { DataTableExplorerCategoryClient, DataTableExplorerCategoryTotalClient, } from './DataTableExplorerCategoryClient';
+import { DataTableExplorerCountClient } from './DataTableExplorerCountClient';
+import { DataTableExplorerHistogramClient, DataTableExplorerHistogramTotalClient, } from './DataTableExplorerHistogramClient';
+import { DataTableExplorerPageClient } from './DataTableExplorerPageClient';
+import { DataTableExplorerUnsupportedSummaryClient } from './DataTableExplorerUnsupportedSummaryClient';
+import { fieldInfoToDataTableExplorerField, getDataTableExplorerValueType, isDataTableExplorerHistogramType, isDataTableExplorerUnsupportedSummaryType, } from './utils';
+function toError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
+/**
+ * Loads field metadata for the dataTableExplorer table and writes the normalized field
+ * definitions into the dataTableExplorer store.
+ */
+export async function loadDataTableExplorerSchema(options) {
+    const { columns, coordinator, store, tableName } = options;
+    store.getState().setSchemaLoading(true, tableName);
+    try {
+        const fieldInfo = await queryFieldInfo(coordinator, columns?.length
+            ? columns.map((column) => ({ column, table: tableName }))
+            : [{ column: '*', table: tableName }]);
+        store
+            .getState()
+            .setSchemaSuccess(fieldInfo.map(fieldInfoToDataTableExplorerField), tableName);
+    }
+    catch (error) {
+        store.getState().setSchemaSuccess([], tableName);
+        store.getState().setSchemaError(toError(error), tableName);
+    }
+}
+/**
+ * Connects the paged row client for the current dataTableExplorer page and disconnects
+ * it when the caller tears down the lifecycle.
+ */
+export function connectDataTableExplorerPageClient(options) {
+    const client = new DataTableExplorerPageClient({
+        columns: options.fieldNames,
+        filter: options.filter,
+        onStateChange: (state) => options.store.getState().setPage(state),
+        pagination: options.pagination,
+        sorting: options.sorting,
+        tableName: options.tableName,
+    });
+    options.connection.coordinator.connect(client);
+    return () => {
+        client.destroy();
+    };
+}
+/**
+ * Connects either the filtered or total count client and routes updates into
+ * the corresponding store slice.
+ */
+export function connectDataTableExplorerCountClient(options) {
+    const setCountState = options.target === 'filtered'
+        ? options.store.getState().setFilteredCount
+        : options.store.getState().setTotalCount;
+    const client = new DataTableExplorerCountClient({
+        filterStable: options.filterStable,
+        onStateChange: setCountState,
+        selection: options.selection,
+        tableName: options.tableName,
+    });
+    options.connection.coordinator.connect(client);
+    return {
+        client,
+        cleanup: () => {
+            client.destroy();
+        },
+    };
+}
+/**
+ * Connects all per-column summary clients for the active schema and initializes
+ * matching empty summary state in the dataTableExplorer store.
+ */
+export function connectDataTableExplorerSummaryClients(options) {
+    const { categoryLimit, connection, fields, selection, store, summaryBins, tableName, } = options;
+    store.getState().initializeSummaries(fields);
+    const clients = fields.flatMap((field) => {
+        const update = (summary) => {
+            store.getState().setSummary(field.name, summary);
+        };
+        if (isDataTableExplorerUnsupportedSummaryType(field.type)) {
+            return [
+                new DataTableExplorerUnsupportedSummaryClient({
+                    field,
+                    onStateChange: update,
+                    selection,
+                    tableName,
+                }),
+            ];
+        }
+        if (isDataTableExplorerHistogramType(field.type)) {
+            const summaryClient = new DataTableExplorerHistogramClient({
+                field,
+                onStateChange: update,
+                selection,
+                steps: summaryBins,
+                tableName,
+                valueType: getDataTableExplorerValueType(field.type) === 'date'
+                    ? 'date'
+                    : 'number',
+            });
+            return [
+                summaryClient,
+                new DataTableExplorerHistogramTotalClient({
+                    summaryClient,
+                }),
+            ];
+        }
+        const summaryClient = new DataTableExplorerCategoryClient({
+            categoryLimit,
+            field,
+            onStateChange: update,
+            selection,
+            tableName,
+        });
+        return [
+            summaryClient,
+            new DataTableExplorerCategoryTotalClient({
+                summaryClient,
+            }),
+        ];
+    });
+    clients.forEach((client) => connection.coordinator.connect(client));
+    return () => {
+        clients.forEach((client) => client.destroy());
+        store.getState().clearSummaries();
+    };
+}
+//# sourceMappingURL=dataTableExplorerController.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dataTableExplorerController.js","sourceRoot":"","sources":["../../src/data-table-explorer/dataTableExplorerController.ts"],"names":[],"mappings":"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","sourcesContent":["import type {MosaicClient, Selection} from '@uwdata/mosaic-core';\nimport {queryFieldInfo} from '@uwdata/mosaic-core';\nimport type * as arrow from 'apache-arrow';\nimport {\n  DataTableExplorerCategoryClient,\n  DataTableExplorerCategoryTotalClient,\n} from './DataTableExplorerCategoryClient';\nimport {DataTableExplorerCountClient} from './DataTableExplorerCountClient';\nimport {\n  DataTableExplorerHistogramClient,\n  DataTableExplorerHistogramTotalClient,\n} from './DataTableExplorerHistogramClient';\nimport {DataTableExplorerPageClient} from './DataTableExplorerPageClient';\nimport {DataTableExplorerUnsupportedSummaryClient} from './DataTableExplorerUnsupportedSummaryClient';\nimport type {\n  DataTableExplorerSummaryState,\n  DataTableExplorerSorting,\n} from './types';\nimport type {DataTableExplorerStore} from './createDataTableExplorerStore';\nimport {\n  fieldInfoToDataTableExplorerField,\n  getDataTableExplorerValueType,\n  isDataTableExplorerHistogramType,\n  isDataTableExplorerUnsupportedSummaryType,\n} from './utils';\n\nfunction toError(error: unknown): Error {\n  return error instanceof Error ? error : new Error(String(error));\n}\n\n/**\n * Loads field metadata for the dataTableExplorer table and writes the normalized field\n * definitions into the dataTableExplorer store.\n */\nexport async function loadDataTableExplorerSchema(options: {\n  columns?: string[];\n  coordinator: Parameters<typeof queryFieldInfo>[0];\n  store: DataTableExplorerStore;\n  tableName: string;\n}) {\n  const {columns, coordinator, store, tableName} = options;\n  store.getState().setSchemaLoading(true, tableName);\n\n  try {\n    const fieldInfo = await queryFieldInfo(\n      coordinator,\n      columns?.length\n        ? columns.map((column) => ({column, table: tableName}))\n        : [{column: '*', table: tableName}],\n    );\n    store\n      .getState()\n      .setSchemaSuccess(\n        fieldInfo.map(fieldInfoToDataTableExplorerField),\n        tableName,\n      );\n  } catch (error: unknown) {\n    store.getState().setSchemaSuccess([], tableName);\n    store.getState().setSchemaError(toError(error), tableName);\n  }\n}\n\ntype ReadyConnection = {\n  coordinator: {\n    connect: (client: MosaicClient) => void;\n    disconnect: (client: MosaicClient) => void;\n  };\n};\n\n/**\n * Connects the paged row client for the current dataTableExplorer page and disconnects\n * it when the caller tears down the lifecycle.\n */\nexport function connectDataTableExplorerPageClient(options: {\n  connection: ReadyConnection;\n  fieldNames: string[];\n  filter?: ReturnType<Selection['predicate']>;\n  pagination: {pageIndex: number; pageSize: number};\n  sorting: DataTableExplorerSorting;\n  store: DataTableExplorerStore;\n  tableName: string;\n}) {\n  const client = new DataTableExplorerPageClient({\n    columns: options.fieldNames,\n    filter: options.filter,\n    onStateChange: (state) => options.store.getState().setPage(state),\n    pagination: options.pagination,\n    sorting: options.sorting,\n    tableName: options.tableName,\n  });\n\n  options.connection.coordinator.connect(client);\n\n  return () => {\n    client.destroy();\n  };\n}\n\n/**\n * Connects either the filtered or total count client and routes updates into\n * the corresponding store slice.\n */\nexport function connectDataTableExplorerCountClient(options: {\n  connection: ReadyConnection;\n  filterStable?: boolean;\n  selection?: Selection;\n  store: DataTableExplorerStore;\n  tableName: string;\n  target: 'filtered' | 'total';\n}) {\n  const setCountState =\n    options.target === 'filtered'\n      ? options.store.getState().setFilteredCount\n      : options.store.getState().setTotalCount;\n\n  const client = new DataTableExplorerCountClient({\n    filterStable: options.filterStable,\n    onStateChange: setCountState,\n    selection: options.selection,\n    tableName: options.tableName,\n  });\n\n  options.connection.coordinator.connect(client);\n\n  return {\n    client,\n    cleanup: () => {\n      client.destroy();\n    },\n  };\n}\n\n/**\n * Connects all per-column summary clients for the active schema and initializes\n * matching empty summary state in the dataTableExplorer store.\n */\nexport function connectDataTableExplorerSummaryClients(options: {\n  categoryLimit: number;\n  connection: ReadyConnection;\n  fields: arrow.Field[];\n  selection: Selection;\n  store: DataTableExplorerStore;\n  summaryBins: number;\n  tableName: string;\n}) {\n  const {\n    categoryLimit,\n    connection,\n    fields,\n    selection,\n    store,\n    summaryBins,\n    tableName,\n  } = options;\n\n  store.getState().initializeSummaries(fields);\n\n  const clients: MosaicClient[] = fields.flatMap((field): MosaicClient[] => {\n    const update = (summary: DataTableExplorerSummaryState) => {\n      store.getState().setSummary(field.name, summary);\n    };\n\n    if (isDataTableExplorerUnsupportedSummaryType(field.type)) {\n      return [\n        new DataTableExplorerUnsupportedSummaryClient({\n          field,\n          onStateChange: update,\n          selection,\n          tableName,\n        }),\n      ];\n    }\n\n    if (isDataTableExplorerHistogramType(field.type)) {\n      const summaryClient = new DataTableExplorerHistogramClient({\n        field,\n        onStateChange: update,\n        selection,\n        steps: summaryBins,\n        tableName,\n        valueType:\n          getDataTableExplorerValueType(field.type) === 'date'\n            ? 'date'\n            : 'number',\n      });\n\n      return [\n        summaryClient,\n        new DataTableExplorerHistogramTotalClient({\n          summaryClient,\n        }),\n      ];\n    }\n\n    const summaryClient = new DataTableExplorerCategoryClient({\n      categoryLimit,\n      field,\n      onStateChange: update,\n      selection,\n      tableName,\n    });\n\n    return [\n      summaryClient,\n      new DataTableExplorerCategoryTotalClient({\n        summaryClient,\n      }),\n    ];\n  });\n\n  clients.forEach((client) => connection.coordinator.connect(client));\n\n  return () => {\n    clients.forEach((client) => client.destroy());\n    store.getState().clearSummaries();\n  };\n}\n"]}

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

@@ -0,0 +1,12 @@
+import type { DataTableExplorerStoreState } from '../createDataTableExplorerStore';
+import type { DataTableExplorerColumnState } from '../types';
+export type UseDataTableExplorerColumnsOptions = {
+    fields: DataTableExplorerStoreState['schema']['fields'];
+    summaries: DataTableExplorerStoreState['summaries'];
+};
+/**
+ * Maps the schema fields and summary state into the column model consumed by
+ * the dataTableExplorer header and summary cells.
+ */
+export declare function useDataTableExplorerColumns({ fields, summaries, }: UseDataTableExplorerColumnsOptions): DataTableExplorerColumnState[];
+//# sourceMappingURL=useDataTableExplorerColumns.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDataTableExplorerColumns.d.ts","sourceRoot":"","sources":["../../../src/data-table-explorer/hooks/useDataTableExplorerColumns.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,2BAA2B,EAAC,MAAM,iCAAiC,CAAC;AACjF,OAAO,KAAK,EAAC,4BAA4B,EAAC,MAAM,UAAU,CAAC;AAO3D,MAAM,MAAM,kCAAkC,GAAG;IAC/C,MAAM,EAAE,2BAA2B,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC;IACxD,SAAS,EAAE,2BAA2B,CAAC,WAAW,CAAC,CAAC;CACrD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,EAC1C,MAAM,EACN,SAAS,GACV,EAAE,kCAAkC,GAAG,4BAA4B,EAAE,CAerE"}

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

@@ -0,0 +1,19 @@
+import { useMemo } from 'react';
+import { createEmptySummaryState, isDataTableExplorerHistogramType, isDataTableExplorerUnsupportedSummaryType, } from '../utils';
+/**
+ * Maps the schema fields and summary state into the column model consumed by
+ * the dataTableExplorer header and summary cells.
+ */
+export function useDataTableExplorerColumns({ fields, summaries, }) {
+    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]);
+}
+//# sourceMappingURL=useDataTableExplorerColumns.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDataTableExplorerColumns.js","sourceRoot":"","sources":["../../../src/data-table-explorer/hooks/useDataTableExplorerColumns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,OAAO,CAAC;AAG9B,OAAO,EACL,uBAAuB,EACvB,gCAAgC,EAChC,yCAAyC,GAC1C,MAAM,UAAU,CAAC;AAOlB;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAAC,EAC1C,MAAM,EACN,SAAS,GAC0B;IACnC,OAAO,OAAO,CACZ,GAAG,EAAE,CACH,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrB,KAAK;QACL,IAAI,EAAE,yCAAyC,CAAC,KAAK,CAAC,IAAI,CAAC;YACzD,CAAC,CAAC,aAAa;YACf,CAAC,CAAC,gCAAgC,CAAC,KAAK,CAAC,IAAI,CAAC;gBAC5C,CAAC,CAAC,WAAW;gBACb,CAAC,CAAC,UAAU;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,uBAAuB,CAAC,KAAK,CAAC;KACjE,CAAC,CAAC,EACL,CAAC,MAAM,EAAE,SAAS,CAAC,CACpB,CAAC;AACJ,CAAC","sourcesContent":["import {useMemo} from 'react';\nimport type {DataTableExplorerStoreState} from '../createDataTableExplorerStore';\nimport type {DataTableExplorerColumnState} from '../types';\nimport {\n  createEmptySummaryState,\n  isDataTableExplorerHistogramType,\n  isDataTableExplorerUnsupportedSummaryType,\n} from '../utils';\n\nexport type UseDataTableExplorerColumnsOptions = {\n  fields: DataTableExplorerStoreState['schema']['fields'];\n  summaries: DataTableExplorerStoreState['summaries'];\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 */\nexport function useDataTableExplorerColumns({\n  fields,\n  summaries,\n}: UseDataTableExplorerColumnsOptions): DataTableExplorerColumnState[] {\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"]}

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

@@ -0,0 +1,30 @@
+import type { MosaicClient, Selection } from '@uwdata/mosaic-core';
+import type { MosaicSliceState } from '../../MosaicSlice';
+import type { DataTableExplorerStore } from '../createDataTableExplorerStore';
+import type { DataTableExplorerPaginationState, DataTableExplorerSorting } from '../types';
+import type { DataTableExplorerStoreState } from '../createDataTableExplorerStore';
+export type UseDataTableExplorerLifecyclesOptions = {
+    categoryLimit: number;
+    columns?: string[];
+    connection: MosaicSliceState['mosaic']['connection'];
+    fieldNames: string[];
+    fields: DataTableExplorerStoreState['schema']['fields'];
+    pageSize: number;
+    pagination: DataTableExplorerPaginationState;
+    dataTableExplorerStore: DataTableExplorerStore;
+    rowFilter: ReturnType<Selection['predicate']>;
+    selection: Selection;
+    selectionVersion: number;
+    sorting: DataTableExplorerSorting;
+    summaryBins: number;
+    tableName: string;
+};
+export type UseDataTableExplorerLifecyclesReturn = {
+    client: MosaicClient | null;
+};
+/**
+ * Owns the coordinator-backed schema, row, count, and summary client
+ * lifecycles for a dataTableExplorer instance.
+ */
+export declare function useDataTableExplorerLifecycles(options: UseDataTableExplorerLifecyclesOptions): UseDataTableExplorerLifecyclesReturn;
+//# sourceMappingURL=useDataTableExplorerLifecycles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDataTableExplorerLifecycles.d.ts","sourceRoot":"","sources":["../../../src/data-table-explorer/hooks/useDataTableExplorerLifecycles.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,YAAY,EAAE,SAAS,EAAC,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,iCAAiC,CAAC;AAC5E,OAAO,KAAK,EACV,gCAAgC,EAChC,wBAAwB,EACzB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAC,2BAA2B,EAAC,MAAM,iCAAiC,CAAC;AAQjF,MAAM,MAAM,qCAAqC,GAAG;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC;IACrD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,2BAA2B,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,gCAAgC,CAAC;IAC7C,sBAAsB,EAAE,sBAAsB,CAAC;IAC/C,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC;IAC9C,SAAS,EAAE,SAAS,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,wBAAwB,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,oCAAoC,GAAG;IACjD,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;CAC7B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,qCAAqC,GAC7C,oCAAoC,CA8ItC"}

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

@@ -0,0 +1,120 @@
+import { useEffect, useRef } from 'react';
+import { connectDataTableExplorerCountClient, connectDataTableExplorerPageClient, connectDataTableExplorerSummaryClients, loadDataTableExplorerSchema, } from '../dataTableExplorerController';
+/**
+ * Owns the coordinator-backed schema, row, count, and summary client
+ * lifecycles for a dataTableExplorer instance.
+ */
+export 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 });
+            dataTableExplorerStore.getState().setClient(null);
+            return;
+        }
+        const { client: newClient, cleanup } = connectDataTableExplorerCountClient({
+            connection,
+            filterStable: true,
+            selection,
+            store: dataTableExplorerStore,
+            tableName,
+            target: 'filtered',
+        });
+        dataTableExplorerStore.getState().setClient(newClient);
+        return () => {
+            cleanup();
+            dataTableExplorerStore.getState().setClient(null);
+        };
+    }, [connection, dataTableExplorerStore, selection, tableName]);
+    useEffect(() => {
+        if (connection.status !== 'ready' || !tableName) {
+            dataTableExplorerStore.getState().setTotalCount({ isLoading: false });
+            return;
+        }
+        const { cleanup } = connectDataTableExplorerCountClient({
+            connection,
+            store: dataTableExplorerStore,
+            tableName,
+            target: 'total',
+        });
+        return cleanup;
+    }, [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,
+    ]);
+    // Client is not returned - it's stored in the dataTableExplorerStore
+    return { client: null };
+}
+//# sourceMappingURL=useDataTableExplorerLifecycles.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDataTableExplorerLifecycles.js","sourceRoot":"","sources":["../../../src/data-table-explorer/hooks/useDataTableExplorerLifecycles.ts"],"names":[],"mappings":"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","sourcesContent":["import {useEffect, useRef} from 'react';\nimport type {MosaicClient, Selection} from '@uwdata/mosaic-core';\nimport type {MosaicSliceState} from '../../MosaicSlice';\nimport type {DataTableExplorerStore} from '../createDataTableExplorerStore';\nimport type {\n  DataTableExplorerPaginationState,\n  DataTableExplorerSorting,\n} from '../types';\nimport type {DataTableExplorerStoreState} from '../createDataTableExplorerStore';\nimport {\n  connectDataTableExplorerCountClient,\n  connectDataTableExplorerPageClient,\n  connectDataTableExplorerSummaryClients,\n  loadDataTableExplorerSchema,\n} from '../dataTableExplorerController';\n\nexport type UseDataTableExplorerLifecyclesOptions = {\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\nexport type UseDataTableExplorerLifecyclesReturn = {\n  client: MosaicClient | null;\n};\n\n/**\n * Owns the coordinator-backed schema, row, count, and summary client\n * lifecycles for a dataTableExplorer instance.\n */\nexport function useDataTableExplorerLifecycles(\n  options: UseDataTableExplorerLifecyclesOptions,\n): UseDataTableExplorerLifecyclesReturn {\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      dataTableExplorerStore.getState().setClient(null);\n      return;\n    }\n\n    const {client: newClient, cleanup} = connectDataTableExplorerCountClient({\n      connection,\n      filterStable: true,\n      selection,\n      store: dataTableExplorerStore,\n      tableName,\n      target: 'filtered',\n    });\n    dataTableExplorerStore.getState().setClient(newClient);\n\n    return () => {\n      cleanup();\n      dataTableExplorerStore.getState().setClient(null);\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    const {cleanup} = connectDataTableExplorerCountClient({\n      connection,\n      store: dataTableExplorerStore,\n      tableName,\n      target: 'total',\n    });\n\n    return cleanup;\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  // Client is not returned - it's stored in the dataTableExplorerStore\n  return {client: null};\n}\n"]}

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

@@ -0,0 +1,28 @@
+import type { Selection } from '@uwdata/mosaic-core';
+import type { DataTableExplorerStoreState } from '../createDataTableExplorerStore';
+import type { DataTableExplorerPaginationState, DataTableExplorerSorting } from '../types';
+import { buildDataTableExplorerBaseQuery } from '../utils';
+export type UseDataTableExplorerQueryStateOptions = {
+    pagination: DataTableExplorerPaginationState;
+    rowSelectionVersion: number;
+    schema: DataTableExplorerStoreState['schema'];
+    selection: Selection;
+    selectionVersion: number;
+    sorting: DataTableExplorerSorting;
+    tableName: string;
+};
+export type UseDataTableExplorerQueryStateReturn = {
+    baseQuery: ReturnType<typeof buildDataTableExplorerBaseQuery>;
+    datasetId: string;
+    fieldNames: string[];
+    fields: DataTableExplorerStoreState['schema']['fields'];
+    hasFilters: boolean;
+    pageQuery: string;
+    rowFilter: ReturnType<Selection['predicate']>;
+};
+/**
+ * Derives the dataTableExplorer's field and SQL state from the current schema,
+ * selection, sorting, and pagination state.
+ */
+export declare function useDataTableExplorerQueryState({ pagination, rowSelectionVersion, schema, selection, selectionVersion, sorting, tableName, }: UseDataTableExplorerQueryStateOptions): UseDataTableExplorerQueryStateReturn;
+//# sourceMappingURL=useDataTableExplorerQueryState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDataTableExplorerQueryState.d.ts","sourceRoot":"","sources":["../../../src/data-table-explorer/hooks/useDataTableExplorerQueryState.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAC,2BAA2B,EAAC,MAAM,iCAAiC,CAAC;AACjF,OAAO,KAAK,EACV,gCAAgC,EAChC,wBAAwB,EACzB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,+BAA+B,EAEhC,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,qCAAqC,GAAG;IAClD,UAAU,EAAE,gCAAgC,CAAC;IAC7C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IAC9C,SAAS,EAAE,SAAS,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,wBAAwB,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,oCAAoC,GAAG;IACjD,SAAS,EAAE,UAAU,CAAC,OAAO,+BAA+B,CAAC,CAAC;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,2BAA2B,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC;IACxD,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC;CAC/C,CAAC;AAEF;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,EAC7C,UAAU,EACV,mBAAmB,EACnB,MAAM,EACN,SAAS,EACT,gBAAgB,EAChB,OAAO,EACP,SAAS,GACV,EAAE,qCAAqC,GAAG,oCAAoC,CA4C9E"}

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

@@ -0,0 +1,40 @@
+import { useMemo } from 'react';
+import { buildDataTableExplorerBaseQuery, buildDataTableExplorerPageQuery, } from '../utils';
+/**
+ * Derives the dataTableExplorer's field and SQL state from the current schema,
+ * selection, sorting, and pagination state.
+ */
+export function useDataTableExplorerQueryState({ pagination, rowSelectionVersion, schema, selection, selectionVersion, sorting, tableName, }) {
+    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('
'),
+        fieldNames,
+        fields,
+        hasFilters: Array.isArray(filter) ? filter.length > 0 : Boolean(filter),
+        pageQuery: buildDataTableExplorerPageQuery(pageBaseQuery, pagination).toString(),
+        rowFilter,
+    };
+}
+//# sourceMappingURL=useDataTableExplorerQueryState.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDataTableExplorerQueryState.js","sourceRoot":"","sources":["../../../src/data-table-explorer/hooks/useDataTableExplorerQueryState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,OAAO,CAAC;AAO9B,OAAO,EACL,+BAA+B,EAC/B,+BAA+B,GAChC,MAAM,UAAU,CAAC;AAsBlB;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAAC,EAC7C,UAAU,EACV,mBAAmB,EACnB,MAAM,EACN,SAAS,EACT,gBAAgB,EAChB,OAAO,EACP,SAAS,GAC6B;IACtC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE;QAC1B,KAAK,gBAAgB,CAAC;QACtB,OAAO,SAAS,CAAC,SAAS,EAAE,CAAC;IAC/B,CAAC,EAAE,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE;QAC7B,KAAK,mBAAmB,CAAC;QACzB,OAAO,SAAS,CAAC,SAAS,EAAE,CAAC;IAC/B,CAAC,EAAE,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,OAAO,CACvB,GAAG,EAAE,CACH,+BAA+B,CAAC;QAC9B,OAAO,EAAE,UAAU;QACnB,MAAM;QACN,OAAO;QACP,SAAS;KACV,CAAC,EACJ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,CACzC,CAAC;IACF,MAAM,aAAa,GAAG,OAAO,CAC3B,GAAG,EAAE,CACH,+BAA+B,CAAC;QAC9B,OAAO,EAAE,UAAU;QACnB,MAAM,EAAE,SAAS;QACjB,OAAO;QACP,SAAS;KACV,CAAC,EACJ,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,CAC5C,CAAC;IAEF,OAAO;QACL,SAAS;QACT,SAAS,EAAE,CAAC,SAAS,EAAE,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAC/C,UAAU;QACV,MAAM;QACN,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACvE,SAAS,EAAE,+BAA+B,CACxC,aAAa,EACb,UAAU,CACX,CAAC,QAAQ,EAAE;QACZ,SAAS;KACV,CAAC;AACJ,CAAC","sourcesContent":["import {useMemo} from 'react';\nimport type {Selection} from '@uwdata/mosaic-core';\nimport type {DataTableExplorerStoreState} from '../createDataTableExplorerStore';\nimport type {\n  DataTableExplorerPaginationState,\n  DataTableExplorerSorting,\n} from '../types';\nimport {\n  buildDataTableExplorerBaseQuery,\n  buildDataTableExplorerPageQuery,\n} from '../utils';\n\nexport type UseDataTableExplorerQueryStateOptions = {\n  pagination: DataTableExplorerPaginationState;\n  rowSelectionVersion: number;\n  schema: DataTableExplorerStoreState['schema'];\n  selection: Selection;\n  selectionVersion: number;\n  sorting: DataTableExplorerSorting;\n  tableName: string;\n};\n\nexport type UseDataTableExplorerQueryStateReturn = {\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 * Derives the dataTableExplorer's field and SQL state from the current schema,\n * selection, sorting, and pagination state.\n */\nexport function useDataTableExplorerQueryState({\n  pagination,\n  rowSelectionVersion,\n  schema,\n  selection,\n  selectionVersion,\n  sorting,\n  tableName,\n}: UseDataTableExplorerQueryStateOptions): UseDataTableExplorerQueryStateReturn {\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"]}

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

@@ -0,0 +1,13 @@
+import { type Selection } from '@uwdata/mosaic-core';
+import type { DataTableExplorerOptions } from '../types';
+export type UseDataTableExplorerSelectionOptions = Pick<DataTableExplorerOptions, 'selection' | 'selectionName'>;
+export type UseDataTableExplorerSelectionReturn = {
+    selection: Selection;
+    selectionVersion: number;
+};
+/**
+ * Resolves the dataTableExplorer selection, creating a crossfilter selection when the
+ * caller does not supply one, and exposes a version that changes with it.
+ */
+export declare function useDataTableExplorerSelection(options: UseDataTableExplorerSelectionOptions): UseDataTableExplorerSelectionReturn;
+//# sourceMappingURL=useDataTableExplorerSelection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDataTableExplorerSelection.d.ts","sourceRoot":"","sources":["../../../src/data-table-explorer/hooks/useDataTableExplorerSelection.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,SAAS,EACf,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAC,wBAAwB,EAAC,MAAM,UAAU,CAAC;AAEvD,MAAM,MAAM,oCAAoC,GAAG,IAAI,CACrD,wBAAwB,EACxB,WAAW,GAAG,eAAe,CAC9B,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG;IAChD,SAAS,EAAE,SAAS,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAkBF;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,oCAAoC,GAC5C,mCAAmC,CAyBrC"}

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

@@ -0,0 +1,40 @@
+import { createId } from '@paralleldrive/cuid2';
+import { Selection as MosaicSelection, } from '@uwdata/mosaic-core';
+import { useEffect, useMemo, useState } from 'react';
+import { useStoreWithMosaic } from '../../MosaicSlice';
+/**
+ * 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.
+ */
+export 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),
+    };
+}
+//# sourceMappingURL=useDataTableExplorerSelection.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDataTableExplorerSelection.js","sourceRoot":"","sources":["../../../src/data-table-explorer/hooks/useDataTableExplorerSelection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EACL,SAAS,IAAI,eAAe,GAE7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAC,MAAM,OAAO,CAAC;AACnD,OAAO,EAAC,kBAAkB,EAAC,MAAM,mBAAmB,CAAC;AAarD;;;GAGG;AACH,SAAS,mBAAmB,CAAC,SAAoB;IAC/C,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAE1C,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC5D,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAClD,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACpE,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAC3C,OAA6C;IAE7C,MAAM,EAAC,SAAS,EAAE,iBAAiB,EAAE,aAAa,EAAC,GAAG,OAAO,CAAC;IAC9D,MAAM,sBAAsB,GAAG,OAAO,CACpC,GAAG,EAAE,CAAC,8BAA8B,QAAQ,EAAE,EAAE,EAChD,EAAE,CACH,CAAC;IACF,MAAM,YAAY,GAAG,aAAa,IAAI,sBAAsB,CAAC;IAC7D,MAAM,iBAAiB,GAAG,kBAAkB,CAC1C,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,CACjD,CAAC;IACF,MAAM,YAAY,GAAG,kBAAkB,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC9E,MAAM,CAAC,iBAAiB,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,WAAW,EAAE,CAAC,CAAC;IAE1E,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,iBAAiB,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC7C,YAAY,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC,EAAE,CAAC,iBAAiB,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,CAAC,CAAC,CAAC;IAEvE,MAAM,SAAS,GAAG,iBAAiB,IAAI,iBAAiB,IAAI,iBAAiB,CAAC;IAE9E,OAAO;QACL,SAAS;QACT,gBAAgB,EAAE,mBAAmB,CAAC,SAAS,CAAC;KACjD,CAAC;AACJ,CAAC","sourcesContent":["import {createId} from '@paralleldrive/cuid2';\nimport {\n  Selection as MosaicSelection,\n  type Selection,\n} from '@uwdata/mosaic-core';\nimport {useEffect, useMemo, useState} from 'react';\nimport {useStoreWithMosaic} from '../../MosaicSlice';\nimport type {DataTableExplorerOptions} from '../types';\n\nexport type UseDataTableExplorerSelectionOptions = Pick<\n  DataTableExplorerOptions,\n  'selection' | 'selectionName'\n>;\n\nexport type UseDataTableExplorerSelectionReturn = {\n  selection: Selection;\n  selectionVersion: number;\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 */\nexport function useDataTableExplorerSelection(\n  options: UseDataTableExplorerSelectionOptions,\n): UseDataTableExplorerSelectionReturn {\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"]}

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

@@ -0,0 +1,18 @@
+import type { DataTableExplorerStoreState } from '../createDataTableExplorerStore';
+export type UseDataTableExplorerStatusOptions = {
+    filteredCount: DataTableExplorerStoreState['filteredCount'];
+    page: DataTableExplorerStoreState['page'];
+    schema: DataTableExplorerStoreState['schema'];
+    summaries: DataTableExplorerStoreState['summaries'];
+    totalCount: DataTableExplorerStoreState['totalCount'];
+};
+export type UseDataTableExplorerStatusReturn = {
+    isLoading: boolean;
+    tableError?: Error;
+};
+/**
+ * Collapses the aggregated dataTableExplorer client state into the loading and error
+ * signals exposed from the public hook.
+ */
+export declare function useDataTableExplorerStatus(options: UseDataTableExplorerStatusOptions): UseDataTableExplorerStatusReturn;
+//# sourceMappingURL=useDataTableExplorerStatus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDataTableExplorerStatus.d.ts","sourceRoot":"","sources":["../../../src/data-table-explorer/hooks/useDataTableExplorerStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,2BAA2B,EAAC,MAAM,iCAAiC,CAAC;AAEjF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,aAAa,EAAE,2BAA2B,CAAC,eAAe,CAAC,CAAC;IAC5D,IAAI,EAAE,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,EAAE,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IAC9C,SAAS,EAAE,2BAA2B,CAAC,WAAW,CAAC,CAAC;IACpD,UAAU,EAAE,2BAA2B,CAAC,YAAY,CAAC,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,KAAK,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,iCAAiC,GACzC,gCAAgC,CAqBlC"}

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

@@ -0,0 +1,23 @@
+/**
+ * Collapses the aggregated dataTableExplorer client state into the loading and error
+ * signals exposed from the public hook.
+ */
+export function useDataTableExplorerStatus(options) {
+    const { filteredCount, page, schema, summaries, totalCount } = options;
+    const hasPendingSummaryInitialization = schema.fields.length > 0 &&
+        Object.keys(summaries).length < schema.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,
+    };
+}
+//# sourceMappingURL=useDataTableExplorerStatus.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDataTableExplorerStatus.js","sourceRoot":"","sources":["../../../src/data-table-explorer/hooks/useDataTableExplorerStatus.ts"],"names":[],"mappings":"AAeA;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAA0C;IAE1C,MAAM,EAAC,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAC,GAAG,OAAO,CAAC;IACrE,MAAM,+BAA+B,GACnC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QACxB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;IAEvD,OAAO;QACL,SAAS,EACP,MAAM,CAAC,SAAS;YAChB,IAAI,CAAC,SAAS;YACd,aAAa,CAAC,SAAS;YACvB,UAAU,CAAC,SAAS;YACpB,+BAA+B;YAC/B,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;QAC/D,UAAU,EACR,MAAM,CAAC,KAAK;YACZ,IAAI,CAAC,KAAK;YACV,aAAa,CAAC,KAAK;YACnB,UAAU,CAAC,KAAK;YAChB,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK;KACnE,CAAC;AACJ,CAAC","sourcesContent":["import type {DataTableExplorerStoreState} from '../createDataTableExplorerStore';\n\nexport type UseDataTableExplorerStatusOptions = {\n  filteredCount: DataTableExplorerStoreState['filteredCount'];\n  page: DataTableExplorerStoreState['page'];\n  schema: DataTableExplorerStoreState['schema'];\n  summaries: DataTableExplorerStoreState['summaries'];\n  totalCount: DataTableExplorerStoreState['totalCount'];\n};\n\nexport type UseDataTableExplorerStatusReturn = {\n  isLoading: boolean;\n  tableError?: Error;\n};\n\n/**\n * Collapses the aggregated dataTableExplorer client state into the loading and error\n * signals exposed from the public hook.\n */\nexport function useDataTableExplorerStatus(\n  options: UseDataTableExplorerStatusOptions,\n): UseDataTableExplorerStatusReturn {\n  const {filteredCount, page, schema, summaries, totalCount} = options;\n  const hasPendingSummaryInitialization =\n    schema.fields.length > 0 &&\n    Object.keys(summaries).length < schema.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"]}

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

@@ -0,0 +1,27 @@
+import { type DataTableExplorerStore } from '../createDataTableExplorerStore';
+import type { DataTableExplorerSorting } from '../types';
+import type { DataTableExplorerStoreState } from '../createDataTableExplorerStore';
+export type UseDataTableExplorerStoreStateOptions = {
+    initialSorting: DataTableExplorerSorting;
+    pageSize: number;
+};
+export type UseDataTableExplorerStoreStateReturn = {
+    client: DataTableExplorerStoreState['client'];
+    filteredCount: DataTableExplorerStoreState['filteredCount'];
+    lastNonEmptyPageTable: DataTableExplorerStoreState['lastNonEmptyPageTable'];
+    page: DataTableExplorerStoreState['page'];
+    pagination: DataTableExplorerStoreState['pagination'];
+    dataTableExplorerStore: DataTableExplorerStore;
+    schema: DataTableExplorerStoreState['schema'];
+    setPagination: DataTableExplorerStoreState['setPagination'];
+    setSorting: DataTableExplorerStoreState['setSorting'];
+    sorting: DataTableExplorerStoreState['sorting'];
+    summaries: DataTableExplorerStoreState['summaries'];
+    totalCount: DataTableExplorerStoreState['totalCount'];
+};
+/**
+ * Creates the per-dataTableExplorer local store and subscribes to the raw state slices
+ * that the public dataTableExplorer hook exposes.
+ */
+export declare function useDataTableExplorerStoreState(options: UseDataTableExplorerStoreStateOptions): UseDataTableExplorerStoreStateReturn;
+//# sourceMappingURL=useDataTableExplorerStoreState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDataTableExplorerStoreState.d.ts","sourceRoot":"","sources":["../../../src/data-table-explorer/hooks/useDataTableExplorerStoreState.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAC,wBAAwB,EAAC,MAAM,UAAU,CAAC;AACvD,OAAO,KAAK,EAAC,2BAA2B,EAAC,MAAM,iCAAiC,CAAC;AAEjF,MAAM,MAAM,qCAAqC,GAAG;IAClD,cAAc,EAAE,wBAAwB,CAAC;IACzC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,oCAAoC,GAAG;IACjD,MAAM,EAAE,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IAC9C,aAAa,EAAE,2BAA2B,CAAC,eAAe,CAAC,CAAC;IAC5D,qBAAqB,EAAE,2BAA2B,CAAC,uBAAuB,CAAC,CAAC;IAC5E,IAAI,EAAE,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAC1C,UAAU,EAAE,2BAA2B,CAAC,YAAY,CAAC,CAAC;IACtD,sBAAsB,EAAE,sBAAsB,CAAC;IAC/C,MAAM,EAAE,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IAC9C,aAAa,EAAE,2BAA2B,CAAC,eAAe,CAAC,CAAC;IAC5D,UAAU,EAAE,2BAA2B,CAAC,YAAY,CAAC,CAAC;IACtD,OAAO,EAAE,2BAA2B,CAAC,SAAS,CAAC,CAAC;IAChD,SAAS,EAAE,2BAA2B,CAAC,WAAW,CAAC,CAAC;IACpD,UAAU,EAAE,2BAA2B,CAAC,YAAY,CAAC,CAAC;CACvD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,qCAAqC,GAC7C,oCAAoC,CA+BtC"}