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

package/dist/data-table-explorer/dashboard/MosaicDashboardDataTableExplorerPanelRenderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"MosaicDashboardDataTableExplorerPanelRenderer.js","sourceRoot":"","sources":["../../../src/data-table-explorer/dashboard/MosaicDashboardDataTableExplorerPanelRenderer.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AACzC,OAAO,EAAC,mBAAmB,EAAC,MAAM,cAAc,CAAC;AACjD,OAAO,EAAC,iBAAiB,EAAC,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAGL,2BAA2B,GAC5B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAC,0BAA0B,EAAC,MAAM,4CAA4C,CAAC;AACtF,OAAO,EAAC,gCAAgC,EAAC,MAAM,oCAAoC,CAAC;AAEpF,OAAO,EAAC,YAAY,EAAC,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAC,oBAAoB,EAAC,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAC,6CAA6C,EAAC,MAAM,iDAAiD,CAAC;AAQ9G,MAAM,6CAA6C,GAE/C,CAAC,EAAC,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAC,EAAE,EAAE;IACvD,MAAM,UAAU,GAAG,2BAA2B,CAC5C,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CACnC,CAAC;IAEF,MAAM,QAAQ,GACZ,OAAO,KAAK,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ;QACvC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ;QACvB,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,QAAQ,GAAG,oBAAoB,CAAC;QACpC,SAAS,EAAE,aAAa,CAAC,KAAK;QAC9B,QAAQ,EAAE,QAAQ,IAAI,EAAE;QACxB,aAAa;KACd,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,gCAAgC,CACtD,QAAQ,EACR,aAAa,EACb,UAAU,CAAC,MAAM,CAClB,CAAC;IAEF,0BAA0B,CAAC,SAAS,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;IAEpE,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,KAAC,WAAW,IAAC,SAAS,EAAC,eAAe,GAAG,CAAC;IACnD,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAClC,OAAO,CACL,cAAK,SAAS,EAAC,2EAA2E,gDAEpF,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,KAAC,iBAAiB,CAAC,IAAI,IAAC,QAAQ,EAAE,QAAQ,YACxC,eAAK,SAAS,EAAC,8BAA8B,aAC3C,cAAK,SAAS,EAAC,8BAA8B,YAC3C,MAAC,iBAAiB,CAAC,KAAK,eACtB,KAAC,iBAAiB,CAAC,MAAM,KAAG,EAC5B,KAAC,iBAAiB,CAAC,IAAI,KAAG,IACF,GACtB,EACN,KAAC,iBAAiB,CAAC,SAAS,KAAG,IAC3B,GACiB,CAC1B,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,wCAAwC,GAE1C,CAAC,EAAC,KAAK,EAAE,SAAS,EAAE,aAAa,EAAC,EAAE,EAAE;IACxC,MAAM,aAAa,GAAG,YAAY,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAE5D,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,CACL,cAAK,SAAS,EAAC,2EAA2E,mEAEpF,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,KAAC,6CAA6C,IAC5C,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,aAAa,GAC5B,CACH,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,6CAA6C,GACxD;IACE,SAAS,EAAE,wCAAwC;IACnD,aAAa,EAAE,6CAA6C;IAC5D,IAAI,EAAE,mBAAmB;CAC1B,CAAC","sourcesContent":["import {SpinnerPane} from '@sqlrooms/ui';\nimport {TablePropertiesIcon} from 'lucide-react';\nimport {DataTableExplorer} from '../DataTableExplorer';\nimport type {DataTableExplorerPanel} from '../../dashboard/dashboard-types';\nimport {\n  type MosaicDashboardPanelRenderer,\n  type DataTableExplorerPanelRendererProps,\n  useStoreWithMosaicDashboard,\n} from '../../dashboard/MosaicDashboardSlice';\nimport {usePanelClientRegistration} from '../../dashboard/usePanelClientRegistration';\nimport {useDataTableExplorerPanelClients} from './useDataTableExplorerPanelClients';\nimport {FC} from 'react';\nimport {useDataTable} from '@sqlrooms/db';\nimport {useDataTableExplorer} from '../useDataTableExplorer';\nimport {MosaicDashboardDataTableExplorerHeaderActions} from './MosaicDashboardDataTableExplorerHeaderActions';\nimport type {DataTable} from '@sqlrooms/db';\n\ntype MosaicDashboardDataTableExplorerRendererInnerProps = Omit<\n  DataTableExplorerPanelRendererProps,\n  'dashboardId'\n> & {selectedTable: DataTable};\n\nconst MosaicDashboardDataTableExplorerRendererInner: FC<\n  MosaicDashboardDataTableExplorerRendererInnerProps\n> = ({panel, dashboard, selectionName, selectedTable}) => {\n  const connection = useStoreWithMosaicDashboard(\n    (state) => state.mosaic.connection,\n  );\n\n  const pageSize =\n    typeof panel.config.pageSize === 'number'\n      ? panel.config.pageSize\n      : undefined;\n\n  const explorer = useDataTableExplorer({\n    tableName: selectedTable.table,\n    pageSize: pageSize ?? 10,\n    selectionName,\n  });\n\n  const explorerClients = useDataTableExplorerPanelClients(\n    explorer,\n    selectedTable,\n    connection.status,\n  );\n\n  usePanelClientRegistration(dashboard.id, panel.id, explorerClients);\n\n  if (connection.status === 'loading') {\n    return <SpinnerPane className=\"h-full w-full\" />;\n  }\n\n  if (connection.status !== 'ready') {\n    return (\n      <div className=\"text-muted-foreground flex h-full items-center justify-center p-4 text-sm\">\n        Mosaic connection is not ready.\n      </div>\n    );\n  }\n\n  return (\n    <DataTableExplorer.Root explorer={explorer}>\n      <div className=\"flex h-full min-h-0 flex-col\">\n        <div className=\"min-h-0 flex-1 overflow-auto\">\n          <DataTableExplorer.Table>\n            <DataTableExplorer.Header />\n            <DataTableExplorer.Rows />\n          </DataTableExplorer.Table>\n        </div>\n        <DataTableExplorer.StatusBar />\n      </div>\n    </DataTableExplorer.Root>\n  );\n};\n\nconst MosaicDashboardDataTableExplorerRenderer: FC<\n  DataTableExplorerPanelRendererProps\n> = ({panel, dashboard, selectionName}) => {\n  const selectedTable = useDataTable(dashboard.selectedTable);\n\n  if (!selectedTable) {\n    return (\n      <div className=\"text-muted-foreground flex h-full items-center justify-center p-4 text-sm\">\n        Data Table Explorer panels require a table source.\n      </div>\n    );\n  }\n\n  return (\n    <MosaicDashboardDataTableExplorerRendererInner\n      panel={panel}\n      dashboard={dashboard}\n      selectionName={selectionName}\n      selectedTable={selectedTable}\n    />\n  );\n};\n\nexport const mosaicDashboardDataTableExplorerPanelRenderer: MosaicDashboardPanelRenderer<DataTableExplorerPanel> =\n  {\n    component: MosaicDashboardDataTableExplorerRenderer,\n    headerActions: MosaicDashboardDataTableExplorerHeaderActions,\n    icon: TablePropertiesIcon,\n  };\n"]}
+{"version":3,"file":"MosaicDashboardDataTableExplorerPanelRenderer.js","sourceRoot":"","sources":["../../../src/data-table-explorer/dashboard/MosaicDashboardDataTableExplorerPanelRenderer.tsx"],"names":[],"mappings":"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","sourcesContent":["import {ScrollArea, ScrollBar, SpinnerPane} from '@sqlrooms/ui';\nimport {TablePropertiesIcon} from 'lucide-react';\nimport {DataTableExplorer} from '../DataTableExplorer';\nimport type {DataTableExplorerPanel} from '../../dashboard/dashboard-types';\nimport {\n  type MosaicDashboardPanelRenderer,\n  type DataTableExplorerPanelRendererProps,\n  useStoreWithMosaicDashboard,\n} from '../../dashboard/MosaicDashboardSlice';\nimport {usePanelClientRegistration} from '../../dashboard/usePanelClientRegistration';\nimport {useDataTableExplorerPanelClients} from './useDataTableExplorerPanelClients';\nimport {FC, useMemo} from 'react';\nimport {useDataTableExplorer} from '../useDataTableExplorer';\nimport {MosaicDashboardDataTableExplorerHeaderActions} from './MosaicDashboardDataTableExplorerHeaderActions';\nimport type {DataTable} from '@sqlrooms/db';\nimport {useTablesWithColumns} from '../../hooks/useTablesWithColumns';\nimport {resolveMosaicTableReference} from '../../mosaicTableReference';\n\ntype MosaicDashboardDataTableExplorerRendererInnerProps = Omit<\n  DataTableExplorerPanelRendererProps,\n  'dashboardId'\n> & {selectedTable: DataTable};\n\nconst MosaicDashboardDataTableExplorerRendererInner: FC<\n  MosaicDashboardDataTableExplorerRendererInnerProps\n> = ({panel, dashboard, selectionName, selectedTable}) => {\n  const connection = useStoreWithMosaicDashboard(\n    (state) => state.mosaic.connection,\n  );\n\n  const pageSize =\n    typeof panel.config.pageSize === 'number'\n      ? panel.config.pageSize\n      : undefined;\n\n  const explorer = useDataTableExplorer({\n    tableName: selectedTable.table,\n    pageSize: pageSize ?? 10,\n    selectionName,\n  });\n\n  const explorerClients = useDataTableExplorerPanelClients(\n    explorer,\n    selectedTable,\n    connection.status,\n  );\n\n  usePanelClientRegistration(dashboard.id, panel.id, explorerClients);\n\n  if (connection.status === 'loading') {\n    return <SpinnerPane className=\"h-full w-full\" />;\n  }\n\n  if (connection.status !== 'ready') {\n    return (\n      <div className=\"text-muted-foreground flex h-full items-center justify-center p-4 text-sm\">\n        Mosaic connection is not ready.\n      </div>\n    );\n  }\n\n  return (\n    <DataTableExplorer.Root explorer={explorer}>\n      <div className=\"flex h-full min-h-0 flex-col\">\n        <ScrollArea className=\"min-h-0 flex-1\">\n          <DataTableExplorer.Table>\n            <DataTableExplorer.Header />\n            <DataTableExplorer.Rows />\n          </DataTableExplorer.Table>\n          <ScrollBar orientation=\"horizontal\" />\n        </ScrollArea>\n        <DataTableExplorer.StatusBar />\n      </div>\n    </DataTableExplorer.Root>\n  );\n};\n\nconst MosaicDashboardDataTableExplorerRenderer: FC<\n  DataTableExplorerPanelRendererProps\n> = ({panel, dashboard, selectionName}) => {\n  const tables = useTablesWithColumns();\n  const selectedTable = useMemo(\n    () => resolveMosaicTableReference(tables, dashboard.selectedTable).table,\n    [dashboard.selectedTable, tables],\n  );\n\n  if (!selectedTable) {\n    return (\n      <div className=\"text-muted-foreground flex h-full items-center justify-center p-4 text-sm\">\n        Data Table Explorer panels require a table source.\n      </div>\n    );\n  }\n\n  return (\n    <MosaicDashboardDataTableExplorerRendererInner\n      panel={panel}\n      dashboard={dashboard}\n      selectionName={selectionName}\n      selectedTable={selectedTable}\n    />\n  );\n};\n\nexport const mosaicDashboardDataTableExplorerPanelRenderer: MosaicDashboardPanelRenderer<DataTableExplorerPanel> =\n  {\n    component: MosaicDashboardDataTableExplorerRenderer,\n    headerActions: MosaicDashboardDataTableExplorerHeaderActions,\n    icon: TablePropertiesIcon,\n  };\n"]}

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

@@ -2,17 +2,29 @@ import type { MosaicClient, Selection } from '@uwdata/mosaic-core';
 import { queryFieldInfo } from '@uwdata/mosaic-core';
 import type * as arrow from 'apache-arrow';
 import { DataTableExplorerCountClient } from './DataTableExplorerCountClient';
-import type { DataTableExplorerSorting } from './types';
+import type { DataTableExplorerSqlTableReference, DataTableExplorerSorting } from './types';
 import type { DataTableExplorerStore } from './createDataTableExplorerStore';
 /**
  * Loads field metadata for the dataTableExplorer table and writes the normalized field
  * definitions into the dataTableExplorer store.
+ *
+ * @param options.columns Optional subset of column names to load. When omitted,
+ * metadata is loaded for every column in the table.
+ * @param options.coordinator Mosaic coordinator used to run the field-info query.
+ * @param options.store Instance store that receives schema loading, success, and
+ * error state.
+ * @param options.tableIdentity Stable SQLRooms table identity used for store keys.
+ * This should preserve catalog/database identity when available.
+ * @param options.tableReference Mosaic SQL table reference used to query the table.
+ * Prefer a TableRefNode for qualified table names so dotted identifier parts are
+ * not reparsed as separate identifiers.
  */
 export declare function loadDataTableExplorerSchema(options: {
     columns?: string[];
     coordinator: Parameters<typeof queryFieldInfo>[0];
     store: DataTableExplorerStore;
-    tableName: string;
+    tableIdentity: string;
+    tableReference: DataTableExplorerSqlTableReference;
 }): Promise<void>;
 type ReadyConnection = {
     coordinator: {
@@ -23,6 +35,20 @@ type ReadyConnection = {
 /**
  * Connects the paged row client for the current dataTableExplorer page and disconnects
  * it when the caller tears down the lifecycle.
+ *
+ * @param options.connection Ready Mosaic connection that owns client
+ * registration.
+ * @param options.fieldNames Ordered fields to include in the page query and page
+ * dataset identity.
+ * @param options.filter Optional row filter applied to the page query.
+ * @param options.pagination Current page index and page size.
+ * @param options.sorting Current sort descriptors.
+ * @param options.store Instance store that receives page loading, data, and error
+ * state.
+ * @param options.tableName Stable SQLRooms table identity used for page dataset
+ * keys.
+ * @param options.tableReference Mosaic SQL table reference used in generated page
+ * queries.
  */
 export declare function connectDataTableExplorerPageClient(options: {
     connection: ReadyConnection;
@@ -35,10 +61,25 @@ export declare function connectDataTableExplorerPageClient(options: {
     sorting: DataTableExplorerSorting;
     store: DataTableExplorerStore;
     tableName: string;
+    tableReference: DataTableExplorerSqlTableReference;
 }): () => void;
 /**
  * Connects either the filtered or total count client and routes updates into
  * the corresponding store slice.
+ *
+ * @param options.connection Ready Mosaic connection that owns client
+ * registration.
+ * @param options.filterStable Whether Mosaic can treat this count query as
+ * stable under filter changes.
+ * @param options.selection Optional Mosaic selection that supplies cross-filter
+ * predicates.
+ * @param options.store Instance store that receives filtered or total count
+ * state.
+ * @param options.tableName Stable SQLRooms table identity used for client state.
+ * @param options.tableReference Mosaic SQL table reference used in generated count
+ * queries.
+ * @param options.target Selects whether updates go to the filtered or total count
+ * store slice.
  */
 export declare function connectDataTableExplorerCountClient(options: {
     connection: ReadyConnection;
@@ -46,6 +87,7 @@ export declare function connectDataTableExplorerCountClient(options: {
     selection?: Selection;
     store: DataTableExplorerStore;
     tableName: string;
+    tableReference: DataTableExplorerSqlTableReference;
     target: 'filtered' | 'total';
 }): {
     client: DataTableExplorerCountClient;
@@ -54,6 +96,19 @@ export declare function connectDataTableExplorerCountClient(options: {
 /**
  * Connects all per-column summary clients for the active schema and initializes
  * matching empty summary state in the dataTableExplorer store.
+ *
+ * @param options.categoryLimit Maximum number of category buckets to expose before
+ * grouping the remainder into an overflow bucket.
+ * @param options.connection Ready Mosaic connection that owns summary client
+ * registration.
+ * @param options.fields Active Arrow fields to summarize.
+ * @param options.selection Mosaic selection shared by summary clients.
+ * @param options.store Instance store that receives summary state.
+ * @param options.summaryBins Requested bin count for histogram summaries.
+ * @param options.tableName Human-readable or string table reference kept for
+ * summary clients that still accept string identities.
+ * @param options.tableReference Mosaic SQL table reference used in generated
+ * summary queries.
  */
 export declare function connectDataTableExplorerSummaryClients(options: {
     categoryLimit: number;
@@ -63,6 +118,7 @@ export declare function connectDataTableExplorerSummaryClients(options: {
     store: DataTableExplorerStore;
     summaryBins: number;
     tableName: string;
+    tableReference: DataTableExplorerSqlTableReference;
 }): () => void;
 export {};
 //# sourceMappingURL=dataTableExplorerController.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"dataTableExplorerController.d.ts","sourceRoot":"","sources":["../../src/data-table-explorer/dataTableExplorerController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAE,SAAS,EAAC,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAC,cAAc,EAAC,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAC;AAK3C,OAAO,EAAC,4BAA4B,EAAC,MAAM,gCAAgC,CAAC;AAO5E,OAAO,KAAK,EAEV,wBAAwB,EACzB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,gCAAgC,CAAC;AAY3E;;;GAGG;AACH,wBAAsB,2BAA2B,CAAC,OAAO,EAAE;IACzD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,KAAK,EAAE,sBAAsB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB,iBAqBA;AAED,KAAK,eAAe,GAAG;IACrB,WAAW,EAAE;QACX,OAAO,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;QACxC,UAAU,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;KAC5C,CAAC;CACH,CAAC;AAEF;;;GAGG;AACH,wBAAgB,kCAAkC,CAAC,OAAO,EAAE;IAC1D,UAAU,EAAE,eAAe,CAAC;IAC5B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC;IAC5C,UAAU,EAAE;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAC,CAAC;IAClD,OAAO,EAAE,wBAAwB,CAAC;IAClC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB,cAeA;AAED;;;GAGG;AACH,wBAAgB,mCAAmC,CAAC,OAAO,EAAE;IAC3D,UAAU,EAAE,eAAe,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,KAAK,EAAE,sBAAsB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC;CAC9B;;;EAqBA;AAED;;;GAGG;AACH,wBAAgB,sCAAsC,CAAC,OAAO,EAAE;IAC9D,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,eAAe,CAAC;IAC5B,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IACtB,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,sBAAsB,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,cAwEA"}
+{"version":3,"file":"dataTableExplorerController.d.ts","sourceRoot":"","sources":["../../src/data-table-explorer/dataTableExplorerController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAE,SAAS,EAAC,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAC,cAAc,EAAC,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAC;AAK3C,OAAO,EAAC,4BAA4B,EAAC,MAAM,gCAAgC,CAAC;AAO5E,OAAO,KAAK,EAEV,kCAAkC,EAClC,wBAAwB,EACzB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,gCAAgC,CAAC;AAY3E;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,2BAA2B,CAAC,OAAO,EAAE;IACzD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,KAAK,EAAE,sBAAsB,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,kCAAkC,CAAC;CACpD,iBAwBA;AAED,KAAK,eAAe,GAAG;IACrB,WAAW,EAAE;QACX,OAAO,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;QACxC,UAAU,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;KAC5C,CAAC;CACH,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kCAAkC,CAAC,OAAO,EAAE;IAC1D,UAAU,EAAE,eAAe,CAAC;IAC5B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC;IAC5C,UAAU,EAAE;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAC,CAAC;IAClD,OAAO,EAAE,wBAAwB,CAAC;IAClC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,kCAAkC,CAAC;CACpD,cAgBA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mCAAmC,CAAC,OAAO,EAAE;IAC3D,UAAU,EAAE,eAAe,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,KAAK,EAAE,sBAAsB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,kCAAkC,CAAC;IACnD,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC;CAC9B;;;EAsBA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sCAAsC,CAAC,OAAO,EAAE;IAC9D,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,eAAe,CAAC;IAC5B,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IACtB,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,sBAAsB,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,kCAAkC,CAAC;CACpD,cA4EA"}

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

@@ -11,26 +11,54 @@ function toError(error) {
 /**
  * Loads field metadata for the dataTableExplorer table and writes the normalized field
  * definitions into the dataTableExplorer store.
+ *
+ * @param options.columns Optional subset of column names to load. When omitted,
+ * metadata is loaded for every column in the table.
+ * @param options.coordinator Mosaic coordinator used to run the field-info query.
+ * @param options.store Instance store that receives schema loading, success, and
+ * error state.
+ * @param options.tableIdentity Stable SQLRooms table identity used for store keys.
+ * This should preserve catalog/database identity when available.
+ * @param options.tableReference Mosaic SQL table reference used to query the table.
+ * Prefer a TableRefNode for qualified table names so dotted identifier parts are
+ * not reparsed as separate identifiers.
  */
 export async function loadDataTableExplorerSchema(options) {
-    const { columns, coordinator, store, tableName } = options;
-    store.getState().setSchemaLoading(true, tableName);
+    const { columns, coordinator, store, tableIdentity, tableReference } = options;
+    store.getState().setSchemaLoading(true, tableIdentity);
     try {
+        // queryFieldInfo is typed as string-only, but Mosaic's runtime accepts
+        // TableRefNode values and preserves identifier boundaries for dotted names.
+        const fieldInfoTable = tableReference;
         const fieldInfo = await queryFieldInfo(coordinator, columns?.length
-            ? columns.map((column) => ({ column, table: tableName }))
-            : [{ column: '*', table: tableName }]);
+            ? columns.map((column) => ({ column, table: fieldInfoTable }))
+            : [{ column: '*', table: fieldInfoTable }]);
         store
             .getState()
-            .setSchemaSuccess(fieldInfo.map(fieldInfoToDataTableExplorerField), tableName);
+            .setSchemaSuccess(fieldInfo.map(fieldInfoToDataTableExplorerField), tableIdentity);
     }
     catch (error) {
-        store.getState().setSchemaSuccess([], tableName);
-        store.getState().setSchemaError(toError(error), tableName);
+        store.getState().setSchemaSuccess([], tableIdentity);
+        store.getState().setSchemaError(toError(error), tableIdentity);
     }
 }
 /**
  * Connects the paged row client for the current dataTableExplorer page and disconnects
  * it when the caller tears down the lifecycle.
+ *
+ * @param options.connection Ready Mosaic connection that owns client
+ * registration.
+ * @param options.fieldNames Ordered fields to include in the page query and page
+ * dataset identity.
+ * @param options.filter Optional row filter applied to the page query.
+ * @param options.pagination Current page index and page size.
+ * @param options.sorting Current sort descriptors.
+ * @param options.store Instance store that receives page loading, data, and error
+ * state.
+ * @param options.tableName Stable SQLRooms table identity used for page dataset
+ * keys.
+ * @param options.tableReference Mosaic SQL table reference used in generated page
+ * queries.
  */
 export function connectDataTableExplorerPageClient(options) {
     const client = new DataTableExplorerPageClient({
@@ -40,6 +68,7 @@ export function connectDataTableExplorerPageClient(options) {
         pagination: options.pagination,
         sorting: options.sorting,
         tableName: options.tableName,
+        tableReference: options.tableReference,
     });
     options.connection.coordinator.connect(client);
     return () => {
@@ -49,6 +78,20 @@ export function connectDataTableExplorerPageClient(options) {
 /**
  * Connects either the filtered or total count client and routes updates into
  * the corresponding store slice.
+ *
+ * @param options.connection Ready Mosaic connection that owns client
+ * registration.
+ * @param options.filterStable Whether Mosaic can treat this count query as
+ * stable under filter changes.
+ * @param options.selection Optional Mosaic selection that supplies cross-filter
+ * predicates.
+ * @param options.store Instance store that receives filtered or total count
+ * state.
+ * @param options.tableName Stable SQLRooms table identity used for client state.
+ * @param options.tableReference Mosaic SQL table reference used in generated count
+ * queries.
+ * @param options.target Selects whether updates go to the filtered or total count
+ * store slice.
  */
 export function connectDataTableExplorerCountClient(options) {
     const setCountState = options.target === 'filtered'
@@ -59,6 +102,7 @@ export function connectDataTableExplorerCountClient(options) {
         onStateChange: setCountState,
         selection: options.selection,
         tableName: options.tableName,
+        tableReference: options.tableReference,
     });
     options.connection.coordinator.connect(client);
     return {
@@ -71,9 +115,22 @@ export function connectDataTableExplorerCountClient(options) {
 /**
  * Connects all per-column summary clients for the active schema and initializes
  * matching empty summary state in the dataTableExplorer store.
+ *
+ * @param options.categoryLimit Maximum number of category buckets to expose before
+ * grouping the remainder into an overflow bucket.
+ * @param options.connection Ready Mosaic connection that owns summary client
+ * registration.
+ * @param options.fields Active Arrow fields to summarize.
+ * @param options.selection Mosaic selection shared by summary clients.
+ * @param options.store Instance store that receives summary state.
+ * @param options.summaryBins Requested bin count for histogram summaries.
+ * @param options.tableName Human-readable or string table reference kept for
+ * summary clients that still accept string identities.
+ * @param options.tableReference Mosaic SQL table reference used in generated
+ * summary queries.
  */
 export function connectDataTableExplorerSummaryClients(options) {
-    const { categoryLimit, connection, fields, selection, store, summaryBins, tableName, } = options;
+    const { categoryLimit, connection, fields, selection, store, summaryBins, tableName, tableReference, } = options;
     store.getState().initializeSummaries(fields);
     const clients = fields.flatMap((field) => {
         const update = (summary) => {
@@ -86,6 +143,7 @@ export function connectDataTableExplorerSummaryClients(options) {
                     onStateChange: update,
                     selection,
                     tableName,
+                    tableReference,
                 }),
             ];
         }
@@ -96,6 +154,7 @@ export function connectDataTableExplorerSummaryClients(options) {
                 selection,
                 steps: summaryBins,
                 tableName,
+                tableReference,
                 valueType: getDataTableExplorerValueType(field.type) === 'date'
                     ? 'date'
                     : 'number',
@@ -113,6 +172,7 @@ export function connectDataTableExplorerSummaryClients(options) {
             onStateChange: update,
             selection,
             tableName,
+            tableReference,
         });
         return [
             summaryClient,

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

@@ -1 +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"]}
+{"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  DataTableExplorerSqlTableReference,\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 *\n * @param options.columns Optional subset of column names to load. When omitted,\n * metadata is loaded for every column in the table.\n * @param options.coordinator Mosaic coordinator used to run the field-info query.\n * @param options.store Instance store that receives schema loading, success, and\n * error state.\n * @param options.tableIdentity Stable SQLRooms table identity used for store keys.\n * This should preserve catalog/database identity when available.\n * @param options.tableReference Mosaic SQL table reference used to query the table.\n * Prefer a TableRefNode for qualified table names so dotted identifier parts are\n * not reparsed as separate identifiers.\n */\nexport async function loadDataTableExplorerSchema(options: {\n  columns?: string[];\n  coordinator: Parameters<typeof queryFieldInfo>[0];\n  store: DataTableExplorerStore;\n  tableIdentity: string;\n  tableReference: DataTableExplorerSqlTableReference;\n}) {\n  const {columns, coordinator, store, tableIdentity, tableReference} = options;\n  store.getState().setSchemaLoading(true, tableIdentity);\n\n  try {\n    // queryFieldInfo is typed as string-only, but Mosaic's runtime accepts\n    // TableRefNode values and preserves identifier boundaries for dotted names.\n    const fieldInfoTable = tableReference as unknown as string;\n    const fieldInfo = await queryFieldInfo(\n      coordinator,\n      columns?.length\n        ? columns.map((column) => ({column, table: fieldInfoTable}))\n        : [{column: '*', table: fieldInfoTable}],\n    );\n    store\n      .getState()\n      .setSchemaSuccess(\n        fieldInfo.map(fieldInfoToDataTableExplorerField),\n        tableIdentity,\n      );\n  } catch (error: unknown) {\n    store.getState().setSchemaSuccess([], tableIdentity);\n    store.getState().setSchemaError(toError(error), tableIdentity);\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 *\n * @param options.connection Ready Mosaic connection that owns client\n * registration.\n * @param options.fieldNames Ordered fields to include in the page query and page\n * dataset identity.\n * @param options.filter Optional row filter applied to the page query.\n * @param options.pagination Current page index and page size.\n * @param options.sorting Current sort descriptors.\n * @param options.store Instance store that receives page loading, data, and error\n * state.\n * @param options.tableName Stable SQLRooms table identity used for page dataset\n * keys.\n * @param options.tableReference Mosaic SQL table reference used in generated page\n * queries.\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  tableReference: DataTableExplorerSqlTableReference;\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    tableReference: options.tableReference,\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 *\n * @param options.connection Ready Mosaic connection that owns client\n * registration.\n * @param options.filterStable Whether Mosaic can treat this count query as\n * stable under filter changes.\n * @param options.selection Optional Mosaic selection that supplies cross-filter\n * predicates.\n * @param options.store Instance store that receives filtered or total count\n * state.\n * @param options.tableName Stable SQLRooms table identity used for client state.\n * @param options.tableReference Mosaic SQL table reference used in generated count\n * queries.\n * @param options.target Selects whether updates go to the filtered or total count\n * store slice.\n */\nexport function connectDataTableExplorerCountClient(options: {\n  connection: ReadyConnection;\n  filterStable?: boolean;\n  selection?: Selection;\n  store: DataTableExplorerStore;\n  tableName: string;\n  tableReference: DataTableExplorerSqlTableReference;\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    tableReference: options.tableReference,\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 *\n * @param options.categoryLimit Maximum number of category buckets to expose before\n * grouping the remainder into an overflow bucket.\n * @param options.connection Ready Mosaic connection that owns summary client\n * registration.\n * @param options.fields Active Arrow fields to summarize.\n * @param options.selection Mosaic selection shared by summary clients.\n * @param options.store Instance store that receives summary state.\n * @param options.summaryBins Requested bin count for histogram summaries.\n * @param options.tableName Human-readable or string table reference kept for\n * summary clients that still accept string identities.\n * @param options.tableReference Mosaic SQL table reference used in generated\n * summary queries.\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  tableReference: DataTableExplorerSqlTableReference;\n}) {\n  const {\n    categoryLimit,\n    connection,\n    fields,\n    selection,\n    store,\n    summaryBins,\n    tableName,\n    tableReference,\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          tableReference,\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        tableReference,\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      tableReference,\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/useDataTableExplorerLifecycles.d.ts

@@ -1,8 +1,12 @@
 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 { DataTableExplorerPaginationState, DataTableExplorerSqlTableReference, DataTableExplorerSorting } from '../types';
 import type { DataTableExplorerStoreState } from '../createDataTableExplorerStore';
+/**
+ * Inputs required to synchronize a dataTableExplorer instance with Mosaic
+ * connection, selection, schema, row, count, and summary lifecycles.
+ */
 export type UseDataTableExplorerLifecyclesOptions = {
     categoryLimit: number;
     columns?: string[];
@@ -17,7 +21,21 @@ export type UseDataTableExplorerLifecyclesOptions = {
     selectionVersion: number;
     sorting: DataTableExplorerSorting;
     summaryBins: number;
+    /**
+     * Stable SQLRooms table identity used for store keys, selection resets, and
+     * dataset IDs. This should keep catalog/database identity when available.
+     */
+    tableIdentity: string;
+    /**
+     * String table reference used for readiness checks and legacy client inputs.
+     */
     tableName: string;
+    /**
+     * Mosaic SQL table reference used by generated queries. Use a TableRefNode for
+     * qualified names to preserve identifier boundaries such as dots inside table
+     * names.
+     */
+    tableReference: DataTableExplorerSqlTableReference;
 };
 export type UseDataTableExplorerLifecyclesReturn = {
     client: MosaicClient | null;
@@ -25,6 +43,10 @@ export type UseDataTableExplorerLifecyclesReturn = {
 /**
  * Owns the coordinator-backed schema, row, count, and summary client
  * lifecycles for a dataTableExplorer instance.
+ *
+ * The hook keeps SQLRooms identity state separate from Mosaic SQL references:
+ * tableIdentity drives local store keys, while tableReference is used at query
+ * boundaries.
  */
 export declare function useDataTableExplorerLifecycles(options: UseDataTableExplorerLifecyclesOptions): UseDataTableExplorerLifecyclesReturn;
 //# sourceMappingURL=useDataTableExplorerLifecycles.d.ts.map

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

@@ -1 +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"}
+{"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,kCAAkC,EAClC,wBAAwB,EACzB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAC,2BAA2B,EAAC,MAAM,iCAAiC,CAAC;AAQjF;;;GAGG;AACH,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;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,cAAc,EAAE,kCAAkC,CAAC;CACpD,CAAC;AAEF,MAAM,MAAM,oCAAoC,GAAG;IACjD,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;CAC7B,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,qCAAqC,GAC7C,oCAAoC,CA6KtC"}

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

@@ -3,22 +3,26 @@ import { connectDataTableExplorerCountClient, connectDataTableExplorerPageClient
 /**
  * Owns the coordinator-backed schema, row, count, and summary client
  * lifecycles for a dataTableExplorer instance.
+ *
+ * The hook keeps SQLRooms identity state separate from Mosaic SQL references:
+ * tableIdentity drives local store keys, while tableReference is used at query
+ * boundaries.
  */
 export function useDataTableExplorerLifecycles(options) {
-    const { categoryLimit, columns, connection, fieldNames, fields, pageSize, pagination, dataTableExplorerStore, rowFilter, selection, selectionVersion, sorting, summaryBins, tableName, } = options;
-    const previousTableNameRef = useRef(tableName);
+    const { categoryLimit, columns, connection, fieldNames, fields, pageSize, pagination, dataTableExplorerStore, rowFilter, selection, selectionVersion, sorting, summaryBins, tableIdentity, tableName, tableReference, } = options;
+    const previousTableNameRef = useRef(tableIdentity);
     useEffect(() => {
         dataTableExplorerStore.getState().syncPageSize(pageSize);
     }, [pageSize, dataTableExplorerStore]);
     useEffect(() => {
-        if (previousTableNameRef.current === tableName)
+        if (previousTableNameRef.current === tableIdentity)
             return;
         selection.reset();
-        previousTableNameRef.current = tableName;
-    }, [selection, tableName]);
+        previousTableNameRef.current = tableIdentity;
+    }, [selection, tableIdentity]);
     useEffect(() => {
         dataTableExplorerStore.getState().resetPageIndex();
-    }, [dataTableExplorerStore, selectionVersion, tableName]);
+    }, [dataTableExplorerStore, selectionVersion, tableIdentity]);
     useEffect(() => {
         if (connection.status !== 'ready' || !tableName) {
             dataTableExplorerStore.getState().setSchemaSuccess([]);
@@ -32,9 +36,17 @@ export function useDataTableExplorerLifecycles(options) {
             columns,
             coordinator: connection.coordinator,
             store: dataTableExplorerStore,
-            tableName,
+            tableIdentity,
+            tableReference,
         });
-    }, [columns, connection, dataTableExplorerStore, tableName]);
+    }, [
+        columns,
+        connection,
+        dataTableExplorerStore,
+        tableIdentity,
+        tableName,
+        tableReference,
+    ]);
     useEffect(() => {
         if (connection.status !== 'ready' || !tableName || !fieldNames.length) {
             dataTableExplorerStore.getState().setPage({ isLoading: false });
@@ -47,7 +59,8 @@ export function useDataTableExplorerLifecycles(options) {
             pagination,
             sorting,
             store: dataTableExplorerStore,
-            tableName,
+            tableName: tableIdentity,
+            tableReference,
         });
     }, [
         connection,
@@ -56,7 +69,9 @@ export function useDataTableExplorerLifecycles(options) {
         dataTableExplorerStore,
         rowFilter,
         sorting,
+        tableIdentity,
         tableName,
+        tableReference,
     ]);
     useEffect(() => {
         if (connection.status !== 'ready' || !tableName) {
@@ -69,7 +84,8 @@ export function useDataTableExplorerLifecycles(options) {
             filterStable: true,
             selection,
             store: dataTableExplorerStore,
-            tableName,
+            tableName: tableIdentity,
+            tableReference,
             target: 'filtered',
         });
         dataTableExplorerStore.getState().setClient(newClient);
@@ -77,7 +93,14 @@ export function useDataTableExplorerLifecycles(options) {
             cleanup();
             dataTableExplorerStore.getState().setClient(null);
         };
-    }, [connection, dataTableExplorerStore, selection, tableName]);
+    }, [
+        connection,
+        dataTableExplorerStore,
+        selection,
+        tableIdentity,
+        tableName,
+        tableReference,
+    ]);
     useEffect(() => {
         if (connection.status !== 'ready' || !tableName) {
             dataTableExplorerStore.getState().setTotalCount({ isLoading: false });
@@ -86,11 +109,18 @@ export function useDataTableExplorerLifecycles(options) {
         const { cleanup } = connectDataTableExplorerCountClient({
             connection,
             store: dataTableExplorerStore,
-            tableName,
+            tableName: tableIdentity,
+            tableReference,
             target: 'total',
         });
         return cleanup;
-    }, [connection, dataTableExplorerStore, tableName]);
+    }, [
+        connection,
+        dataTableExplorerStore,
+        tableIdentity,
+        tableName,
+        tableReference,
+    ]);
     useEffect(() => {
         if (connection.status !== 'ready' || !fields.length) {
             dataTableExplorerStore.getState().clearSummaries();
@@ -104,6 +134,7 @@ export function useDataTableExplorerLifecycles(options) {
             store: dataTableExplorerStore,
             summaryBins,
             tableName,
+            tableReference,
         });
     }, [
         categoryLimit,
@@ -112,7 +143,9 @@ export function useDataTableExplorerLifecycles(options) {
         dataTableExplorerStore,
         selection,
         summaryBins,
+        tableIdentity,
         tableName,
+        tableReference,
     ]);
     // Client is not returned - it's stored in the dataTableExplorerStore
     return { client: null };

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

@@ -1 +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"]}
+{"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  DataTableExplorerSqlTableReference,\n  DataTableExplorerSorting,\n} from '../types';\nimport type {DataTableExplorerStoreState} from '../createDataTableExplorerStore';\nimport {\n  connectDataTableExplorerCountClient,\n  connectDataTableExplorerPageClient,\n  connectDataTableExplorerSummaryClients,\n  loadDataTableExplorerSchema,\n} from '../dataTableExplorerController';\n\n/**\n * Inputs required to synchronize a dataTableExplorer instance with Mosaic\n * connection, selection, schema, row, count, and summary lifecycles.\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  /**\n   * Stable SQLRooms table identity used for store keys, selection resets, and\n   * dataset IDs. This should keep catalog/database identity when available.\n   */\n  tableIdentity: string;\n  /**\n   * String table reference used for readiness checks and legacy client inputs.\n   */\n  tableName: string;\n  /**\n   * Mosaic SQL table reference used by generated queries. Use a TableRefNode for\n   * qualified names to preserve identifier boundaries such as dots inside table\n   * names.\n   */\n  tableReference: DataTableExplorerSqlTableReference;\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 *\n * The hook keeps SQLRooms identity state separate from Mosaic SQL references:\n * tableIdentity drives local store keys, while tableReference is used at query\n * boundaries.\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    tableIdentity,\n    tableName,\n    tableReference,\n  } = options;\n  const previousTableNameRef = useRef(tableIdentity);\n\n  useEffect(() => {\n    dataTableExplorerStore.getState().syncPageSize(pageSize);\n  }, [pageSize, dataTableExplorerStore]);\n\n  useEffect(() => {\n    if (previousTableNameRef.current === tableIdentity) return;\n    selection.reset();\n    previousTableNameRef.current = tableIdentity;\n  }, [selection, tableIdentity]);\n\n  useEffect(() => {\n    dataTableExplorerStore.getState().resetPageIndex();\n  }, [dataTableExplorerStore, selectionVersion, tableIdentity]);\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      tableIdentity,\n      tableReference,\n    });\n  }, [\n    columns,\n    connection,\n    dataTableExplorerStore,\n    tableIdentity,\n    tableName,\n    tableReference,\n  ]);\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: tableIdentity,\n      tableReference,\n    });\n  }, [\n    connection,\n    fieldNames,\n    pagination,\n    dataTableExplorerStore,\n    rowFilter,\n    sorting,\n    tableIdentity,\n    tableName,\n    tableReference,\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: tableIdentity,\n      tableReference,\n      target: 'filtered',\n    });\n    dataTableExplorerStore.getState().setClient(newClient);\n\n    return () => {\n      cleanup();\n      dataTableExplorerStore.getState().setClient(null);\n    };\n  }, [\n    connection,\n    dataTableExplorerStore,\n    selection,\n    tableIdentity,\n    tableName,\n    tableReference,\n  ]);\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: tableIdentity,\n      tableReference,\n      target: 'total',\n    });\n\n    return cleanup;\n  }, [\n    connection,\n    dataTableExplorerStore,\n    tableIdentity,\n    tableName,\n    tableReference,\n  ]);\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      tableReference,\n    });\n  }, [\n    categoryLimit,\n    connection,\n    fields,\n    dataTableExplorerStore,\n    selection,\n    summaryBins,\n    tableIdentity,\n    tableName,\n    tableReference,\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

@@ -1,7 +1,10 @@
 import type { Selection } from '@uwdata/mosaic-core';
 import type { DataTableExplorerStoreState } from '../createDataTableExplorerStore';
-import type { DataTableExplorerPaginationState, DataTableExplorerSorting } from '../types';
+import type { DataTableExplorerPaginationState, DataTableExplorerSqlTableReference, DataTableExplorerSorting } from '../types';
 import { buildDataTableExplorerBaseQuery } from '../utils';
+/**
+ * Inputs used to derive memoized query state for a dataTableExplorer instance.
+ */
 export type UseDataTableExplorerQueryStateOptions = {
     pagination: DataTableExplorerPaginationState;
     rowSelectionVersion: number;
@@ -9,7 +12,15 @@ export type UseDataTableExplorerQueryStateOptions = {
     selection: Selection;
     selectionVersion: number;
     sorting: DataTableExplorerSorting;
-    tableName: string;
+    /**
+     * Stable SQLRooms table identity used to build dataset IDs and distinguish
+     * tables that share schema/table names across catalogs.
+     */
+    tableIdentity: string;
+    /**
+     * Mosaic SQL table reference used in generated queries.
+     */
+    tableReference: DataTableExplorerSqlTableReference;
 };
 export type UseDataTableExplorerQueryStateReturn = {
     baseQuery: ReturnType<typeof buildDataTableExplorerBaseQuery>;
@@ -23,6 +34,9 @@ export type UseDataTableExplorerQueryStateReturn = {
 /**
  * Derives the dataTableExplorer's field and SQL state from the current schema,
  * selection, sorting, and pagination state.
+ *
+ * @param options Current schema, selection, pagination, sorting, and table
+ * reference inputs for query generation.
  */
-export declare function useDataTableExplorerQueryState({ pagination, rowSelectionVersion, schema, selection, selectionVersion, sorting, tableName, }: UseDataTableExplorerQueryStateOptions): UseDataTableExplorerQueryStateReturn;
+export declare function useDataTableExplorerQueryState({ pagination, rowSelectionVersion, schema, selection, selectionVersion, sorting, tableIdentity, tableReference, }: UseDataTableExplorerQueryStateOptions): UseDataTableExplorerQueryStateReturn;
 //# sourceMappingURL=useDataTableExplorerQueryState.d.ts.map