@sqlrooms/mosaic 0.29.0-rc.1 → 0.29.0-rc.3

package/dist/profiler/profilerController.d.ts

@@ -0,0 +1,64 @@
+import type { MosaicClient, Selection } from '@uwdata/mosaic-core';
+import { queryFieldInfo } from '@uwdata/mosaic-core';
+import type * as arrow from 'apache-arrow';
+import type { MosaicProfilerSorting } from './types';
+import type { ProfilerStore } from './createProfilerStore';
+/**
+ * Loads field metadata for the profiler table and writes the normalized field
+ * definitions into the profiler store.
+ */
+export declare function loadProfilerSchema(options: {
+    columns?: string[];
+    coordinator: Parameters<typeof queryFieldInfo>[0];
+    store: ProfilerStore;
+    tableName: string;
+}): Promise<void>;
+type ReadyConnection = {
+    coordinator: {
+        connect: (client: MosaicClient) => void;
+        disconnect: (client: MosaicClient) => void;
+    };
+};
+/**
+ * Connects the paged row client for the current profiler page and disconnects
+ * it when the caller tears down the lifecycle.
+ */
+export declare function connectProfilerPageClient(options: {
+    connection: ReadyConnection;
+    fieldNames: string[];
+    filter?: ReturnType<Selection['predicate']>;
+    pagination: {
+        pageIndex: number;
+        pageSize: number;
+    };
+    sorting: MosaicProfilerSorting;
+    store: ProfilerStore;
+    tableName: string;
+}): () => void;
+/**
+ * Connects either the filtered or total count client and routes updates into
+ * the corresponding store slice.
+ */
+export declare function connectProfilerCountClient(options: {
+    connection: ReadyConnection;
+    filterStable?: boolean;
+    selection?: Selection;
+    store: ProfilerStore;
+    tableName: string;
+    target: 'filtered' | 'total';
+}): () => void;
+/**
+ * Connects all per-column summary clients for the active schema and initializes
+ * matching empty summary state in the profiler store.
+ */
+export declare function connectProfilerSummaryClients(options: {
+    categoryLimit: number;
+    connection: ReadyConnection;
+    fields: arrow.Field[];
+    selection: Selection;
+    store: ProfilerStore;
+    summaryBins: number;
+    tableName: string;
+}): () => void;
+export {};
+//# sourceMappingURL=profilerController.d.ts.map

package/dist/profiler/profilerController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profilerController.d.ts","sourceRoot":"","sources":["../../src/profiler/profilerController.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;AAY3C,OAAO,KAAK,EAA6B,qBAAqB,EAAC,MAAM,SAAS,CAAC;AAC/E,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,uBAAuB,CAAC;AAYzD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IAChD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB,iBAgBA;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,yBAAyB,CAAC,OAAO,EAAE;IACjD,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,qBAAqB,CAAC;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB,cAeA;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,UAAU,EAAE,eAAe,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC;CAC9B,cAkBA;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE;IACrD,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,aAAa,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,cAsEA"}

package/dist/profiler/profilerController.js

@@ -0,0 +1,123 @@
+import { queryFieldInfo } from '@uwdata/mosaic-core';
+import { ProfilerCategoryClient, ProfilerCategoryTotalClient, } from './ProfilerCategoryClient';
+import { ProfilerCountClient } from './ProfilerCountClient';
+import { ProfilerHistogramClient, ProfilerHistogramTotalClient, } from './ProfilerHistogramClient';
+import { ProfilerPageClient } from './ProfilerPageClient';
+import { ProfilerUnsupportedSummaryClient } from './ProfilerUnsupportedSummaryClient';
+import { fieldInfoToProfilerField, getProfilerValueType, isProfilerHistogramType, isProfilerUnsupportedSummaryType, } from './utils';
+function toError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
+/**
+ * Loads field metadata for the profiler table and writes the normalized field
+ * definitions into the profiler store.
+ */
+export async function loadProfilerSchema(options) {
+    const { columns, coordinator, store, tableName } = options;
+    store.getState().setSchemaLoading(true);
+    try {
+        const fieldInfo = await queryFieldInfo(coordinator, columns?.length
+            ? columns.map((column) => ({ column, table: tableName }))
+            : [{ column: '*', table: tableName }]);
+        store.getState().setSchemaSuccess(fieldInfo.map(fieldInfoToProfilerField));
+    }
+    catch (error) {
+        store.getState().setSchemaSuccess([]);
+        store.getState().setSchemaError(toError(error));
+    }
+}
+/**
+ * Connects the paged row client for the current profiler page and disconnects
+ * it when the caller tears down the lifecycle.
+ */
+export function connectProfilerPageClient(options) {
+    const client = new ProfilerPageClient({
+        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 () => {
+        options.connection.coordinator.disconnect(client);
+    };
+}
+/**
+ * Connects either the filtered or total count client and routes updates into
+ * the corresponding store slice.
+ */
+export function connectProfilerCountClient(options) {
+    const setCountState = options.target === 'filtered'
+        ? options.store.getState().setFilteredCount
+        : options.store.getState().setTotalCount;
+    const client = new ProfilerCountClient({
+        filterStable: options.filterStable,
+        onStateChange: setCountState,
+        selection: options.selection,
+        tableName: options.tableName,
+    });
+    options.connection.coordinator.connect(client);
+    return () => {
+        options.connection.coordinator.disconnect(client);
+    };
+}
+/**
+ * Connects all per-column summary clients for the active schema and initializes
+ * matching empty summary state in the profiler store.
+ */
+export function connectProfilerSummaryClients(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 (isProfilerUnsupportedSummaryType(field.type)) {
+            return [
+                new ProfilerUnsupportedSummaryClient({
+                    field,
+                    onStateChange: update,
+                    selection,
+                    tableName,
+                }),
+            ];
+        }
+        if (isProfilerHistogramType(field.type)) {
+            const summaryClient = new ProfilerHistogramClient({
+                field,
+                onStateChange: update,
+                selection,
+                steps: summaryBins,
+                tableName,
+                valueType: getProfilerValueType(field.type) === 'date' ? 'date' : 'number',
+            });
+            return [
+                summaryClient,
+                new ProfilerHistogramTotalClient({
+                    summaryClient,
+                }),
+            ];
+        }
+        const summaryClient = new ProfilerCategoryClient({
+            categoryLimit,
+            field,
+            onStateChange: update,
+            selection,
+            tableName,
+        });
+        return [
+            summaryClient,
+            new ProfilerCategoryTotalClient({
+                summaryClient,
+            }),
+        ];
+    });
+    clients.forEach((client) => connection.coordinator.connect(client));
+    return () => {
+        clients.forEach((client) => connection.coordinator.disconnect(client));
+        store.getState().clearSummaries();
+    };
+}
+//# sourceMappingURL=profilerController.js.map

package/dist/profiler/profilerController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profilerController.js","sourceRoot":"","sources":["../../src/profiler/profilerController.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  ProfilerCategoryClient,\n  ProfilerCategoryTotalClient,\n} from './ProfilerCategoryClient';\nimport {ProfilerCountClient} from './ProfilerCountClient';\nimport {\n  ProfilerHistogramClient,\n  ProfilerHistogramTotalClient,\n} from './ProfilerHistogramClient';\nimport {ProfilerPageClient} from './ProfilerPageClient';\nimport {ProfilerUnsupportedSummaryClient} from './ProfilerUnsupportedSummaryClient';\nimport type {MosaicProfilerSummaryState, MosaicProfilerSorting} from './types';\nimport type {ProfilerStore} from './createProfilerStore';\nimport {\n  fieldInfoToProfilerField,\n  getProfilerValueType,\n  isProfilerHistogramType,\n  isProfilerUnsupportedSummaryType,\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 profiler table and writes the normalized field\n * definitions into the profiler store.\n */\nexport async function loadProfilerSchema(options: {\n  columns?: string[];\n  coordinator: Parameters<typeof queryFieldInfo>[0];\n  store: ProfilerStore;\n  tableName: string;\n}) {\n  const {columns, coordinator, store, tableName} = options;\n  store.getState().setSchemaLoading(true);\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.getState().setSchemaSuccess(fieldInfo.map(fieldInfoToProfilerField));\n  } catch (error: unknown) {\n    store.getState().setSchemaSuccess([]);\n    store.getState().setSchemaError(toError(error));\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 profiler page and disconnects\n * it when the caller tears down the lifecycle.\n */\nexport function connectProfilerPageClient(options: {\n  connection: ReadyConnection;\n  fieldNames: string[];\n  filter?: ReturnType<Selection['predicate']>;\n  pagination: {pageIndex: number; pageSize: number};\n  sorting: MosaicProfilerSorting;\n  store: ProfilerStore;\n  tableName: string;\n}) {\n  const client = new ProfilerPageClient({\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    options.connection.coordinator.disconnect(client);\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 connectProfilerCountClient(options: {\n  connection: ReadyConnection;\n  filterStable?: boolean;\n  selection?: Selection;\n  store: ProfilerStore;\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 ProfilerCountClient({\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    options.connection.coordinator.disconnect(client);\n  };\n}\n\n/**\n * Connects all per-column summary clients for the active schema and initializes\n * matching empty summary state in the profiler store.\n */\nexport function connectProfilerSummaryClients(options: {\n  categoryLimit: number;\n  connection: ReadyConnection;\n  fields: arrow.Field[];\n  selection: Selection;\n  store: ProfilerStore;\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: MosaicProfilerSummaryState) => {\n      store.getState().setSummary(field.name, summary);\n    };\n\n    if (isProfilerUnsupportedSummaryType(field.type)) {\n      return [\n        new ProfilerUnsupportedSummaryClient({\n          field,\n          onStateChange: update,\n          selection,\n          tableName,\n        }),\n      ];\n    }\n\n    if (isProfilerHistogramType(field.type)) {\n      const summaryClient = new ProfilerHistogramClient({\n        field,\n        onStateChange: update,\n        selection,\n        steps: summaryBins,\n        tableName,\n        valueType:\n          getProfilerValueType(field.type) === 'date' ? 'date' : 'number',\n      });\n\n      return [\n        summaryClient,\n        new ProfilerHistogramTotalClient({\n          summaryClient,\n        }),\n      ];\n    }\n\n    const summaryClient = new ProfilerCategoryClient({\n      categoryLimit,\n      field,\n      onStateChange: update,\n      selection,\n      tableName,\n    });\n\n    return [\n      summaryClient,\n      new ProfilerCategoryTotalClient({\n        summaryClient,\n      }),\n    ];\n  });\n\n  clients.forEach((client) => connection.coordinator.connect(client));\n\n  return () => {\n    clients.forEach((client) => connection.coordinator.disconnect(client));\n    store.getState().clearSummaries();\n  };\n}\n"]}

package/dist/profiler/types.d.ts

@@ -0,0 +1,86 @@
+import type { Selection } from '@uwdata/mosaic-core';
+import type { Interval1D } from '@uwdata/mosaic-plot';
+import type { Field, Table } from 'apache-arrow';
+import type { Dispatch, SetStateAction } from 'react';
+export type MosaicProfilerSorting = Array<{
+    id: string;
+    desc: boolean;
+}>;
+export type MosaicProfilerPaginationState = {
+    pageIndex: number;
+    pageSize: number;
+};
+export type MosaicProfilerBinValue = number | Date;
+export type MosaicProfilerBin = {
+    x0: MosaicProfilerBinValue;
+    x1: MosaicProfilerBinValue;
+    length: number;
+};
+export type MosaicProfilerSummaryStatus = {
+    error?: Error;
+    isLoading: boolean;
+};
+export type MosaicProfilerHistogramSummary = MosaicProfilerSummaryStatus & {
+    filteredBins: MosaicProfilerBin[];
+    filteredNullCount: number;
+    interactor: Interval1D | null;
+    kind: 'histogram';
+    totalBins: MosaicProfilerBin[];
+    totalNullCount: number;
+    valueType: 'date' | 'number';
+};
+export type MosaicProfilerCategoryBucket = {
+    filteredCount: number;
+    key: string;
+    kind: 'null' | 'overflow' | 'unique' | 'value';
+    label: string;
+    selectable: boolean;
+    totalCount: number;
+};
+export type MosaicProfilerCategorySummary = MosaicProfilerSummaryStatus & {
+    bucketCount: number;
+    buckets: MosaicProfilerCategoryBucket[];
+    kind: 'category';
+    selectedKey?: string;
+    toggleValue: (key: string) => void;
+};
+export type MosaicProfilerUnsupportedSummary = MosaicProfilerSummaryStatus & {
+    kind: 'unsupported';
+    label: string;
+};
+export type MosaicProfilerSummaryState = MosaicProfilerCategorySummary | MosaicProfilerHistogramSummary | MosaicProfilerUnsupportedSummary;
+export type MosaicProfilerColumnKind = 'category' | 'histogram' | 'unsupported';
+export type MosaicProfilerColumnState = {
+    field: Field;
+    kind: MosaicProfilerColumnKind;
+    name: string;
+    summary: MosaicProfilerSummaryState;
+};
+export type MosaicProfilerOptions = {
+    categoryLimit?: number;
+    columns?: string[];
+    initialSorting?: MosaicProfilerSorting;
+    pageSize?: number;
+    selection?: Selection;
+    selectionName?: string;
+    summaryBins?: number;
+    tableName: string;
+};
+export type UseMosaicProfilerReturn = {
+    columns: MosaicProfilerColumnState[];
+    filteredRowCount?: number;
+    hasFilters: boolean;
+    isLoading: boolean;
+    pageQuery: string;
+    pageTable?: Table;
+    pagination: MosaicProfilerPaginationState;
+    reset: () => void;
+    selection: Selection;
+    setPagination: Dispatch<SetStateAction<MosaicProfilerPaginationState>>;
+    setSorting: Dispatch<SetStateAction<MosaicProfilerSorting>>;
+    sorting: MosaicProfilerSorting;
+    sql: string;
+    tableError?: Error;
+    totalRowCount?: number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/profiler/types.d.ts.map

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

package/dist/profiler/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/profiler/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/profiler/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {Selection} from '@uwdata/mosaic-core';\nimport type {Interval1D} from '@uwdata/mosaic-plot';\nimport type {Field, Table} from 'apache-arrow';\nimport type {Dispatch, SetStateAction} from 'react';\n\nexport type MosaicProfilerSorting = Array<{id: string; desc: boolean}>;\n\nexport type MosaicProfilerPaginationState = {\n  pageIndex: number;\n  pageSize: number;\n};\n\nexport type MosaicProfilerBinValue = number | Date;\n\nexport type MosaicProfilerBin = {\n  x0: MosaicProfilerBinValue;\n  x1: MosaicProfilerBinValue;\n  length: number;\n};\n\nexport type MosaicProfilerSummaryStatus = {\n  error?: Error;\n  isLoading: boolean;\n};\n\nexport type MosaicProfilerHistogramSummary = MosaicProfilerSummaryStatus & {\n  filteredBins: MosaicProfilerBin[];\n  filteredNullCount: number;\n  interactor: Interval1D | null;\n  kind: 'histogram';\n  totalBins: MosaicProfilerBin[];\n  totalNullCount: number;\n  valueType: 'date' | 'number';\n};\n\nexport type MosaicProfilerCategoryBucket = {\n  filteredCount: number;\n  key: string;\n  kind: 'null' | 'overflow' | 'unique' | 'value';\n  label: string;\n  selectable: boolean;\n  totalCount: number;\n};\n\nexport type MosaicProfilerCategorySummary = MosaicProfilerSummaryStatus & {\n  bucketCount: number;\n  buckets: MosaicProfilerCategoryBucket[];\n  kind: 'category';\n  selectedKey?: string;\n  toggleValue: (key: string) => void;\n};\n\nexport type MosaicProfilerUnsupportedSummary = MosaicProfilerSummaryStatus & {\n  kind: 'unsupported';\n  label: string;\n};\n\nexport type MosaicProfilerSummaryState =\n  | MosaicProfilerCategorySummary\n  | MosaicProfilerHistogramSummary\n  | MosaicProfilerUnsupportedSummary;\n\nexport type MosaicProfilerColumnKind = 'category' | 'histogram' | 'unsupported';\n\nexport type MosaicProfilerColumnState = {\n  field: Field;\n  kind: MosaicProfilerColumnKind;\n  name: string;\n  summary: MosaicProfilerSummaryState;\n};\n\nexport type MosaicProfilerOptions = {\n  categoryLimit?: number;\n  columns?: string[];\n  initialSorting?: MosaicProfilerSorting;\n  pageSize?: number;\n  selection?: Selection;\n  selectionName?: string;\n  summaryBins?: number;\n  tableName: string;\n};\n\nexport type UseMosaicProfilerReturn = {\n  columns: MosaicProfilerColumnState[];\n  filteredRowCount?: number;\n  hasFilters: boolean;\n  isLoading: boolean;\n  pageQuery: string;\n  pageTable?: Table;\n  pagination: MosaicProfilerPaginationState;\n  reset: () => void;\n  selection: Selection;\n  setPagination: Dispatch<SetStateAction<MosaicProfilerPaginationState>>;\n  setSorting: Dispatch<SetStateAction<MosaicProfilerSorting>>;\n  sorting: MosaicProfilerSorting;\n  sql: string;\n  tableError?: Error;\n  totalRowCount?: number;\n};\n"]}

package/dist/profiler/useMosaicProfiler.d.ts

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

package/dist/profiler/useMosaicProfiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMosaicProfiler.d.ts","sourceRoot":"","sources":["../../src/profiler/useMosaicProfiler.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAEV,qBAAqB,EAGrB,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAuajB;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,qBAAqB,GAC7B,uBAAuB,CAqGzB"}

package/dist/profiler/useMosaicProfiler.js

@@ -0,0 +1,339 @@
+import { createId } from '@paralleldrive/cuid2';
+import { useDebounce } from '@sqlrooms/ui';
+import { Selection as MosaicSelection, } from '@uwdata/mosaic-core';
+import { useEffect, useMemo, useState, } from 'react';
+import { useStore } from 'zustand';
+import { useStoreWithMosaic } from '../MosaicSlice';
+import { createProfilerStore, } from './createProfilerStore';
+import { connectProfilerCountClient, connectProfilerPageClient, connectProfilerSummaryClients, loadProfilerSchema, } from './profilerController';
+import { buildProfilerBaseQuery, buildProfilerPageQuery, createEmptySummaryState, isProfilerHistogramType, isProfilerUnsupportedSummaryType, } from './utils';
+/**
+ * Tracks Mosaic selection updates as a monotonically increasing version so
+ * memoized queries and lifecycle effects can respond to crossfilter changes.
+ */
+function useSelectionVersion(selection) {
+    const [version, setVersion] = useState(0);
+    useEffect(() => {
+        const handleChange = () => setVersion((value) => value + 1);
+        selection.addEventListener('value', handleChange);
+        return () => selection.removeEventListener('value', handleChange);
+    }, [selection]);
+    return version;
+}
+/**
+ * Resolves the profiler selection, creating a crossfilter selection when the
+ * caller does not supply one, and exposes a version that changes with it.
+ */
+function useProfilerSelection(options) {
+    const { selection: providedSelection, selectionName } = options;
+    const generatedSelectionName = useMemo(() => `mosaic-profiler-${createId()}`, []);
+    const selectionKey = selectionName ?? generatedSelectionName;
+    const existingSelection = useStoreWithMosaic((state) => state.mosaic.selections[selectionKey]);
+    const getSelection = useStoreWithMosaic((state) => state.mosaic.getSelection);
+    const [fallbackSelection] = useState(() => MosaicSelection.crossfilter());
+    useEffect(() => {
+        if (!providedSelection && !existingSelection) {
+            getSelection(selectionKey, 'crossfilter');
+        }
+    }, [existingSelection, getSelection, providedSelection, selectionKey]);
+    const selection = providedSelection ?? existingSelection ?? fallbackSelection;
+    return {
+        selection,
+        selectionVersion: useSelectionVersion(selection),
+    };
+}
+/**
+ * Creates the per-profiler local store and subscribes to the raw state slices
+ * that the public profiler hook exposes.
+ */
+function useProfilerStoreState(options) {
+    const [profilerStore] = useState(() => createProfilerStore({
+        initialSorting: options.initialSorting,
+        pageSize: options.pageSize,
+    }));
+    return {
+        filteredCount: useStore(profilerStore, (state) => state.filteredCount),
+        lastNonEmptyPageTable: useStore(profilerStore, (state) => state.lastNonEmptyPageTable),
+        page: useStore(profilerStore, (state) => state.page),
+        pagination: useStore(profilerStore, (state) => state.pagination),
+        profilerStore,
+        schema: useStore(profilerStore, (state) => state.schema),
+        setPagination: useStore(profilerStore, (state) => state.setPagination),
+        setSorting: useStore(profilerStore, (state) => state.setSorting),
+        sorting: useStore(profilerStore, (state) => state.sorting),
+        summaries: useStore(profilerStore, (state) => state.summaries),
+        totalCount: useStore(profilerStore, (state) => state.totalCount),
+    };
+}
+/**
+ * Derives the profiler's field and SQL state from the current schema,
+ * selection, sorting, and pagination state.
+ */
+function useProfilerQueryState(options) {
+    const { pagination, rowSelectionVersion, schema, selection, selectionVersion, sorting, tableName, } = options;
+    const fields = schema.fields;
+    const fieldNames = useMemo(() => fields.map((field) => field.name), [fields]);
+    const filter = useMemo(() => {
+        void selectionVersion;
+        return selection.predicate();
+    }, [selection, selectionVersion]);
+    const rowFilter = useMemo(() => {
+        void rowSelectionVersion;
+        return selection.predicate();
+    }, [rowSelectionVersion, selection]);
+    const baseQuery = useMemo(() => buildProfilerBaseQuery({
+        columns: fieldNames,
+        filter,
+        sorting,
+        tableName,
+    }), [fieldNames, filter, sorting, tableName]);
+    const pageBaseQuery = useMemo(() => buildProfilerBaseQuery({
+        columns: fieldNames,
+        filter: rowFilter,
+        sorting,
+        tableName,
+    }), [fieldNames, rowFilter, sorting, tableName]);
+    return {
+        baseQuery,
+        datasetId: [tableName, ...fieldNames].join('\u0001'),
+        fieldNames,
+        fields,
+        hasFilters: Array.isArray(filter) ? filter.length > 0 : Boolean(filter),
+        pageQuery: buildProfilerPageQuery(pageBaseQuery, pagination).toString(),
+        rowFilter,
+    };
+}
+/**
+ * Owns the coordinator-backed schema, row, count, and summary client
+ * lifecycles for a profiler instance.
+ */
+function useProfilerLifecycles(options) {
+    const { categoryLimit, columns, connection, fieldNames, fields, pageSize, pagination, profilerStore, rowFilter, selection, selectionVersion, sorting, summaryBins, tableName, } = options;
+    useEffect(() => {
+        profilerStore.getState().syncPageSize(pageSize);
+    }, [pageSize, profilerStore]);
+    useEffect(() => {
+        profilerStore.getState().resetPageIndex();
+    }, [profilerStore, selectionVersion, tableName]);
+    useEffect(() => {
+        if (connection.status !== 'ready' || !tableName) {
+            profilerStore.getState().setSchemaSuccess([]);
+            profilerStore.getState().setSchemaError(undefined);
+            profilerStore
+                .getState()
+                .setSchemaLoading(connection.status === 'loading');
+            return;
+        }
+        void loadProfilerSchema({
+            columns,
+            coordinator: connection.coordinator,
+            store: profilerStore,
+            tableName,
+        });
+    }, [columns, connection, profilerStore, tableName]);
+    useEffect(() => {
+        if (connection.status !== 'ready' || !tableName || !fieldNames.length) {
+            profilerStore.getState().setPage({ isLoading: false });
+            return;
+        }
+        return connectProfilerPageClient({
+            connection,
+            fieldNames,
+            filter: rowFilter,
+            pagination,
+            sorting,
+            store: profilerStore,
+            tableName,
+        });
+    }, [
+        connection,
+        fieldNames,
+        pagination,
+        profilerStore,
+        rowFilter,
+        sorting,
+        tableName,
+    ]);
+    useEffect(() => {
+        if (connection.status !== 'ready' || !tableName) {
+            profilerStore.getState().setFilteredCount({ isLoading: false });
+            return;
+        }
+        return connectProfilerCountClient({
+            connection,
+            filterStable: true,
+            selection,
+            store: profilerStore,
+            tableName,
+            target: 'filtered',
+        });
+    }, [connection, profilerStore, selection, tableName]);
+    useEffect(() => {
+        if (connection.status !== 'ready' || !tableName) {
+            profilerStore.getState().setTotalCount({ isLoading: false });
+            return;
+        }
+        return connectProfilerCountClient({
+            connection,
+            store: profilerStore,
+            tableName,
+            target: 'total',
+        });
+    }, [connection, profilerStore, tableName]);
+    useEffect(() => {
+        if (connection.status !== 'ready' || !fields.length) {
+            profilerStore.getState().clearSummaries();
+            return;
+        }
+        return connectProfilerSummaryClients({
+            categoryLimit,
+            connection,
+            fields,
+            selection,
+            store: profilerStore,
+            summaryBins,
+            tableName,
+        });
+    }, [
+        categoryLimit,
+        connection,
+        fields,
+        profilerStore,
+        selection,
+        summaryBins,
+        tableName,
+    ]);
+}
+/**
+ * Maps the schema fields and summary state into the column model consumed by
+ * the profiler header and summary cells.
+ */
+function useProfilerColumns(options) {
+    const { fields, summaries } = options;
+    return useMemo(() => fields.map((field) => ({
+        field,
+        kind: isProfilerUnsupportedSummaryType(field.type)
+            ? 'unsupported'
+            : isProfilerHistogramType(field.type)
+                ? 'histogram'
+                : 'category',
+        name: field.name,
+        summary: summaries[field.name] ?? createEmptySummaryState(field),
+    })), [fields, summaries]);
+}
+/**
+ * Collapses the aggregated profiler client state into the loading and error
+ * signals exposed from the public hook.
+ */
+function useProfilerStatus(options) {
+    const { fields, filteredCount, page, schema, summaries, totalCount } = options;
+    const hasPendingSummaryInitialization = fields.length > 0 && Object.keys(summaries).length < fields.length;
+    return {
+        isLoading: schema.isLoading ||
+            page.isLoading ||
+            filteredCount.isLoading ||
+            totalCount.isLoading ||
+            hasPendingSummaryInitialization ||
+            Object.values(summaries).some((summary) => summary.isLoading),
+        tableError: schema.error ??
+            page.error ??
+            filteredCount.error ??
+            totalCount.error ??
+            Object.values(summaries).find((summary) => summary.error)?.error,
+    };
+}
+/**
+ * Keeps the last non-empty page result visible while live brushing has moved
+ * ahead of the deferred row query, avoiding transient "No rows" flashes.
+ */
+function useProfilerVisiblePageState(options) {
+    const { lastNonEmptyPageTable, page, pageDatasetId, rowSelectionVersion, selectionVersion, } = options;
+    const isRowDisplayStale = selectionVersion !== rowSelectionVersion;
+    const hasCurrentRows = !!page.pageTable && page.pageTable.numRows > 0;
+    const canReuseLastNonEmptyPage = !!lastNonEmptyPageTable &&
+        lastNonEmptyPageTable.datasetId === pageDatasetId;
+    const canShowStableEmpty = !page.isLoading &&
+        !isRowDisplayStale &&
+        (!page.pageTable || page.pageTable.numRows === 0);
+    const showStableEmpty = useDebounce(canShowStableEmpty, 120);
+    if (hasCurrentRows || !canReuseLastNonEmptyPage) {
+        return page.pageTable;
+    }
+    return showStableEmpty ? page.pageTable : lastNonEmptyPageTable.pageTable;
+}
+/**
+ * Aggregates Mosaic-backed schema, rows, counts, and summaries into the stable
+ * public profiler API consumed by the React table UI.
+ */
+export function useMosaicProfiler(options) {
+    const { categoryLimit = 20, columns, initialSorting = [], pageSize = 100, selection: providedSelection, selectionName, summaryBins = 18, tableName, } = options;
+    const connection = useStoreWithMosaic((state) => state.mosaic.connection);
+    const { selection, selectionVersion } = useProfilerSelection({
+        selection: providedSelection,
+        selectionName,
+    });
+    const rowSelectionVersion = useDebounce(selectionVersion, 100);
+    const { filteredCount, lastNonEmptyPageTable, page, pagination, profilerStore, schema, setPagination, setSorting, sorting, summaries, totalCount, } = useProfilerStoreState({
+        initialSorting,
+        pageSize,
+    });
+    const { baseQuery, datasetId, fieldNames, fields, hasFilters, pageQuery, rowFilter, } = useProfilerQueryState({
+        pagination,
+        rowSelectionVersion,
+        schema,
+        selection,
+        selectionVersion,
+        sorting,
+        tableName,
+    });
+    useProfilerLifecycles({
+        categoryLimit,
+        columns,
+        connection,
+        fieldNames,
+        fields,
+        pageSize,
+        pagination,
+        profilerStore,
+        rowFilter,
+        selection,
+        selectionVersion,
+        sorting,
+        summaryBins,
+        tableName,
+    });
+    const profilerColumns = useProfilerColumns({ fields, summaries });
+    const { isLoading, tableError } = useProfilerStatus({
+        fields,
+        filteredCount,
+        page,
+        schema,
+        summaries,
+        totalCount,
+    });
+    const visiblePage = useProfilerVisiblePageState({
+        lastNonEmptyPageTable,
+        page,
+        pageDatasetId: datasetId,
+        rowSelectionVersion,
+        selectionVersion,
+    });
+    return {
+        columns: profilerColumns,
+        filteredRowCount: filteredCount.count,
+        hasFilters,
+        isLoading,
+        pageQuery,
+        pageTable: visiblePage,
+        pagination,
+        reset: () => selection.reset(),
+        selection,
+        setPagination,
+        setSorting,
+        sorting,
+        sql: baseQuery.toString(),
+        tableError,
+        totalRowCount: totalCount.count,
+    };
+}
+//# sourceMappingURL=useMosaicProfiler.js.map