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

package/dist/tableInterop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableInterop.js","sourceRoot":"","sources":["../src/tableInterop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EACL,UAAU,IAAI,gBAAgB,GAE/B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAC,YAAY,EAAE,UAAU,EAA2B,MAAM,cAAc,CAAC;AAEhF,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;AAQnE,SAAS,kBAAkB,CACzB,KAAQ,EACR,OAGC;IAED,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,EAAC,QAAQ,EAAE,gBAAgB,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,EAAC,GAAG,OAAO,CAAC;IAC9E,IAAI,UAAkC,CAAC;IAEvC,MAAM,OAAO,GAAiB;QAC5B,QAAQ;QACR,aAAa,EAAE,GAAG,EAAE;YAClB,UAAU,KAAK,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAC1C,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,cAAc,EAAE,GAAG,EAAE,CAAC,KAAK;KAC5B,CAAC;IAEF,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE;QAC1C,KAAK,EAAE,OAAO;QACd,UAAU,EAAE,KAAK;QACjB,YAAY,EAAE,KAAK;QACnB,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAQ,KAA0C,CAAC,aAAa,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,KAAc;IAEd,OAAO,eAAe,CAAC,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;AACjD,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,OAAO,CACZ,KAAK;QACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,OAAO,CAAE,KAA6B,CAAC,OAAO,CAAC,CACtD,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,CACZ,KAAK;QACL,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAQ,KAA+B,CAAC,SAAS,KAAK,UAAU;QAChE,OAAQ,KAA8B,CAAC,QAAQ,KAAK,UAAU,CAC/D,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,+BAA+B,CAC7C,UAAsB;IAEtB,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAClD,MAAM,aAAa,GACjB,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvE,OAAO,kBAAkB,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE;QAC7C,QAAQ;QACR,gBAAgB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,EAAE,KAAK,EAAE,IAAI,YAAY,CAAC,KAAK,CAAC;KAC3E,CAA2B,CAAC;AAC/B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,iBAAiB,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAC1D,IAAI,iBAAiB,EAAE,CAAC;QACtB,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,YAAY,CAAC,gBAAgB,CAAC,KAAK,EAAE,EAAC,MAAM,EAAE,QAAQ,EAAC,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,IAAI,KAAK,CACb,uFAAuF,CACxF,CAAC;AACJ,CAAC","sourcesContent":["import {decodeIPC} from '@uwdata/mosaic-core';\nimport {\n  tableToIPC as mosaicTableToIPC,\n  type Table as MosaicTable,\n} from '@uwdata/flechette';\nimport {tableFromIPC, tableToIPC, type Table as ArrowTable} from 'apache-arrow';\n\nconst TABLE_INTEROP = Symbol.for('@sqlrooms/mosaic-table-interop');\n\ntype TableInterop = {\n  ipcBytes: Uint8Array;\n  getArrowTable: () => ArrowTable;\n  getMosaicTable: () => object;\n};\n\nfunction attachTableInterop<T extends object>(\n  table: T,\n  options: {\n    ipcBytes: Uint8Array;\n    decodeArrowTable?: (ipcBytes: Uint8Array) => ArrowTable;\n  },\n): T {\n  if (getTableInterop(table)) {\n    return table;\n  }\n\n  const {ipcBytes, decodeArrowTable = (bytes) => tableFromIPC(bytes)} = options;\n  let arrowTable: ArrowTable | undefined;\n\n  const interop: TableInterop = {\n    ipcBytes,\n    getArrowTable: () => {\n      arrowTable ??= decodeArrowTable(ipcBytes);\n      return arrowTable;\n    },\n    getMosaicTable: () => table,\n  };\n\n  Object.defineProperty(table, TABLE_INTEROP, {\n    value: interop,\n    enumerable: false,\n    configurable: false,\n    writable: false,\n  });\n\n  return table;\n}\n\nexport function getTableInterop(value: unknown): TableInterop | undefined {\n  if (!value || typeof value !== 'object') {\n    return undefined;\n  }\n\n  return (value as {[TABLE_INTEROP]?: TableInterop})[TABLE_INTEROP];\n}\n\nexport function getArrowTableFromInterop(\n  value: unknown,\n): ArrowTable | undefined {\n  return getTableInterop(value)?.getArrowTable();\n}\n\nfunction isArrowTable(value: unknown): value is ArrowTable {\n  return Boolean(\n    value &&\n    typeof value === 'object' &&\n    Array.isArray((value as {batches?: unknown}).batches),\n  );\n}\n\nfunction isMosaicTable(value: unknown): value is MosaicTable {\n  return Boolean(\n    value &&\n    typeof value === 'object' &&\n    typeof (value as {toColumns?: unknown}).toColumns === 'function' &&\n    typeof (value as {getChild?: unknown}).getChild === 'function',\n  );\n}\n\n/**\n * Convert an Apache Arrow table into the Mosaic-native table shape while\n * attaching Mosaic-internal IPC-backed interop metadata.\n *\n * Mosaic core expects Flechette tables, while SQLRooms public client APIs\n * expose Apache Arrow. IPC remains the durable bridge. The original Arrow\n * table is referenced weakly so Arrow-native callers can often reuse it\n * without forcing Mosaic-only consumers to retain both table runtimes.\n */\nexport function createMosaicTableFromArrowTable(\n  arrowTable: ArrowTable,\n): MosaicTable {\n  const ipcBytes = tableToIPC(arrowTable, 'stream');\n  const arrowTableRef =\n    typeof WeakRef === 'undefined' ? undefined : new WeakRef(arrowTable);\n\n  return attachTableInterop(decodeIPC(ipcBytes), {\n    ipcBytes,\n    decodeArrowTable: (bytes) => arrowTableRef?.deref() ?? tableFromIPC(bytes),\n  }) as unknown as MosaicTable;\n}\n\n/**\n * Convert a raw Mosaic client result to the Apache Arrow shape exposed by\n * SQLRooms public hooks.\n *\n * Results produced by {@link createMosaicTableFromArrowTable} use the\n * interop fast path. Plain third-party Flechette tables are still accepted as\n * a compatibility fallback, but that path has to re-encode through IPC.\n */\nexport function toArrowClientResult(value: unknown): ArrowTable {\n  if (isArrowTable(value)) {\n    return value;\n  }\n\n  const interopArrowTable = getArrowTableFromInterop(value);\n  if (interopArrowTable) {\n    return interopArrowTable;\n  }\n\n  if (isMosaicTable(value)) {\n    return tableFromIPC(mosaicTableToIPC(value, {format: 'stream'}));\n  }\n\n  throw new Error(\n    'useMosaicClient expected a Mosaic table result that can be converted to Apache Arrow.',\n  );\n}\n"]}

package/dist/useMosaicClient.d.ts

@@ -1,22 +1,12 @@
-import { Selection } from '@uwdata/mosaic-core';
-import { Query } from '@uwdata/mosaic-sql';
-export type UseMosaicClientOptions<T = unknown> = {
-    /** Unique id for this client (auto-generated if not provided) */
-    id?: string;
-    /** Selection name for cross-filtering (will create if doesn't exist) */
-    selectionName?: string;
-    /** Or pass a Selection directly */
-    selection?: Selection;
-    /** Query builder - receives current filter predicate */
-    query: (filter: unknown) => ReturnType<typeof Query.from>;
-    /** Callback when query results are received */
-    queryResult?: (result: T) => void;
+import { type MosaicClientOptions } from './MosaicSlice';
+export type UseMosaicClientOptions = MosaicClientOptions & {
     /** Whether to automatically connect when mosaic is ready */
     enabled?: boolean;
 };
-export declare function useMosaicClient<T = unknown>(options: UseMosaicClientOptions<T>): {
-    data: NonNullable<T> | null;
+export declare function useMosaicClient(options: UseMosaicClientOptions): {
+    data: import("apache-arrow").Table<any> | null;
     isLoading: boolean;
+    error: Error | undefined;
     client: import("@uwdata/mosaic-core").MosaicClient | null;
 };
 //# sourceMappingURL=useMosaicClient.d.ts.map

package/dist/useMosaicClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useMosaicClient.d.ts","sourceRoot":"","sources":["../src/useMosaicClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAC,KAAK,EAAC,MAAM,oBAAoB,CAAC;AAKzC,MAAM,MAAM,sBAAsB,CAAC,CAAC,GAAG,OAAO,IAAI;IAChD,iEAAiE;IACjE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,wDAAwD;IACxD,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,UAAU,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1D,+CAA+C;IAC/C,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;IAClC,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,wBAAgB,eAAe,CAAC,CAAC,GAAG,OAAO,EACzC,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC;;;;EA+DnC"}
+{"version":3,"file":"useMosaicClient.d.ts","sourceRoot":"","sources":["../src/useMosaicClient.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,KAAK,mBAAmB,EAAqB,MAAM,eAAe,CAAC;AAG3E,MAAM,MAAM,sBAAsB,GAAG,mBAAmB,GAAG;IACzD,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB;;;;;EA+E9D"}

package/dist/useMosaicClient.js

@@ -1,22 +1,32 @@
-import { useEffect, useMemo, useRef } from 'react';
 import { createId } from '@paralleldrive/cuid2';
+import { useEffect, useMemo, useRef } from 'react';
 import { useStoreWithMosaic } from './MosaicSlice';
+import { toArrowClientResult } from './tableInterop';
 export function useMosaicClient(options) {
-    const { id: providedId, selectionName, selection: directSelection, query, queryResult, enabled = true, } = options;
+    const { id: providedId, selectionName, selection: directSelection, query, queryResult, queryError, enabled = true, } = options;
     // Use stable id - generate once if not provided
     const stableId = useMemo(() => providedId ?? createId(), [providedId]);
     const connectionStatus = useStoreWithMosaic((s) => s.mosaic.connection.status);
     const ensureClient = useStoreWithMosaic((s) => s.mosaic.ensureClient);
     const destroyClient = useStoreWithMosaic((s) => s.mosaic.destroyClient);
-    // Select per-client state from store
+    // Select the raw Mosaic client state; public hook data is normalized below.
     const clientState = useStoreWithMosaic((s) => s.mosaic.clients[stableId]);
     // Keep query and queryResult in refs so they can be accessed in effect
     const queryRef = useRef(query);
     const queryResultRef = useRef(queryResult);
+    const queryErrorRef = useRef(queryError);
     useEffect(() => {
         queryRef.current = query;
         queryResultRef.current = queryResult;
-    }, [query, queryResult]);
+        queryErrorRef.current = queryError;
+    }, [query, queryError, queryResult]);
+    const clientData = clientState?.data;
+    const arrowData = useMemo(() => {
+        if (!clientData) {
+            return null;
+        }
+        return toArrowClientResult(clientData);
+    }, [clientData]);
     useEffect(() => {
         if (!enabled || connectionStatus !== 'ready') {
             return;
@@ -26,7 +36,12 @@ export function useMosaicClient(options) {
             selectionName,
             selection: directSelection,
             query: queryRef.current,
-            onQueryResult: queryResultRef.current,
+            onQueryResult: (result) => {
+                queryResultRef.current?.(toArrowClientResult(result));
+            },
+            onQueryError: (error) => {
+                queryErrorRef.current?.(error);
+            },
         });
         return () => {
             destroyClient(stableId);
@@ -41,8 +56,9 @@ export function useMosaicClient(options) {
         destroyClient,
     ]);
     return {
-        data: clientState?.data ?? null,
+        data: arrowData,
         isLoading: clientState?.isLoading ?? connectionStatus !== 'ready',
+        error: clientState?.error,
         client: clientState?.client ?? null,
     };
 }

package/dist/useMosaicClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"useMosaicClient.js","sourceRoot":"","sources":["../src/useMosaicClient.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAC,MAAM,OAAO,CAAC;AACjD,OAAO,EAAC,QAAQ,EAAC,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAC,kBAAkB,EAAC,MAAM,eAAe,CAAC;AAiBjD,MAAM,UAAU,eAAe,CAC7B,OAAkC;IAElC,MAAM,EACJ,EAAE,EAAE,UAAU,EACd,aAAa,EACb,SAAS,EAAE,eAAe,EAC1B,KAAK,EACL,WAAW,EACX,OAAO,GAAG,IAAI,GACf,GAAG,OAAO,CAAC;IAEZ,gDAAgD;IAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,IAAI,QAAQ,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAEvE,MAAM,gBAAgB,GAAG,kBAAkB,CACzC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAClC,CAAC;IACF,MAAM,YAAY,GAAG,kBAAkB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACtE,MAAM,aAAa,GAAG,kBAAkB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAExE,qCAAqC;IACrC,MAAM,WAAW,GAAG,kBAAkB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE1E,uEAAuE;IACvE,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IAE3C,SAAS,CAAC,GAAG,EAAE;QACb,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC;QACzB,cAAc,CAAC,OAAO,GAAG,WAAW,CAAC;IACvC,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;IAEzB,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,IAAI,gBAAgB,KAAK,OAAO,EAAE,CAAC;YAC7C,OAAO;QACT,CAAC;QAED,YAAY,CAAC;YACX,EAAE,EAAE,QAAQ;YACZ,aAAa;YACb,SAAS,EAAE,eAAe;YAC1B,KAAK,EAAE,QAAQ,CAAC,OAAO;YACvB,aAAa,EAAE,cAAc,CAAC,OAAO;SACtC,CAAC,CAAC;QAEH,OAAO,GAAG,EAAE;YACV,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC,CAAC;IACJ,CAAC,EAAE;QACD,OAAO;QACP,gBAAgB;QAChB,QAAQ;QACR,aAAa;QACb,eAAe;QACf,YAAY;QACZ,aAAa;KACd,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAG,WAAW,EAAE,IAAiB,IAAI,IAAI;QAC7C,SAAS,EAAE,WAAW,EAAE,SAAS,IAAI,gBAAgB,KAAK,OAAO;QACjE,MAAM,EAAE,WAAW,EAAE,MAAM,IAAI,IAAI;KACpC,CAAC;AACJ,CAAC","sourcesContent":["import {Selection} from '@uwdata/mosaic-core';\nimport {Query} from '@uwdata/mosaic-sql';\nimport {useEffect, useMemo, useRef} from 'react';\nimport {createId} from '@paralleldrive/cuid2';\nimport {useStoreWithMosaic} from './MosaicSlice';\n\nexport type UseMosaicClientOptions<T = unknown> = {\n  /** Unique id for this client (auto-generated if not provided) */\n  id?: string;\n  /** Selection name for cross-filtering (will create if doesn't exist) */\n  selectionName?: string;\n  /** Or pass a Selection directly */\n  selection?: Selection;\n  /** Query builder - receives current filter predicate */\n  query: (filter: unknown) => ReturnType<typeof Query.from>;\n  /** Callback when query results are received */\n  queryResult?: (result: T) => void;\n  /** Whether to automatically connect when mosaic is ready */\n  enabled?: boolean;\n};\n\nexport function useMosaicClient<T = unknown>(\n  options: UseMosaicClientOptions<T>,\n) {\n  const {\n    id: providedId,\n    selectionName,\n    selection: directSelection,\n    query,\n    queryResult,\n    enabled = true,\n  } = options;\n\n  // Use stable id - generate once if not provided\n  const stableId = useMemo(() => providedId ?? createId(), [providedId]);\n\n  const connectionStatus = useStoreWithMosaic(\n    (s) => s.mosaic.connection.status,\n  );\n  const ensureClient = useStoreWithMosaic((s) => s.mosaic.ensureClient);\n  const destroyClient = useStoreWithMosaic((s) => s.mosaic.destroyClient);\n\n  // Select per-client state from store\n  const clientState = useStoreWithMosaic((s) => s.mosaic.clients[stableId]);\n\n  // Keep query and queryResult in refs so they can be accessed in effect\n  const queryRef = useRef(query);\n  const queryResultRef = useRef(queryResult);\n\n  useEffect(() => {\n    queryRef.current = query;\n    queryResultRef.current = queryResult;\n  }, [query, queryResult]);\n\n  useEffect(() => {\n    if (!enabled || connectionStatus !== 'ready') {\n      return;\n    }\n\n    ensureClient({\n      id: stableId,\n      selectionName,\n      selection: directSelection,\n      query: queryRef.current,\n      onQueryResult: queryResultRef.current,\n    });\n\n    return () => {\n      destroyClient(stableId);\n    };\n  }, [\n    enabled,\n    connectionStatus,\n    stableId,\n    selectionName,\n    directSelection,\n    ensureClient,\n    destroyClient,\n  ]);\n\n  return {\n    data: (clientState?.data as T | null) ?? null,\n    isLoading: clientState?.isLoading ?? connectionStatus !== 'ready',\n    client: clientState?.client ?? null,\n  };\n}\n"]}
+{"version":3,"file":"useMosaicClient.js","sourceRoot":"","sources":["../src/useMosaicClient.ts"],"names":[],"mappings":"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","sourcesContent":["import {createId} from '@paralleldrive/cuid2';\nimport {useEffect, useMemo, useRef} from 'react';\nimport {type MosaicClientOptions, useStoreWithMosaic} from './MosaicSlice';\nimport {toArrowClientResult} from './tableInterop';\n\nexport type UseMosaicClientOptions = MosaicClientOptions & {\n  /** Whether to automatically connect when mosaic is ready */\n  enabled?: boolean;\n};\n\nexport function useMosaicClient(options: UseMosaicClientOptions) {\n  const {\n    id: providedId,\n    selectionName,\n    selection: directSelection,\n    query,\n    queryResult,\n    queryError,\n    enabled = true,\n  } = options;\n\n  // Use stable id - generate once if not provided\n  const stableId = useMemo(() => providedId ?? createId(), [providedId]);\n\n  const connectionStatus = useStoreWithMosaic(\n    (s) => s.mosaic.connection.status,\n  );\n  const ensureClient = useStoreWithMosaic((s) => s.mosaic.ensureClient);\n  const destroyClient = useStoreWithMosaic((s) => s.mosaic.destroyClient);\n\n  // Select the raw Mosaic client state; public hook data is normalized below.\n  const clientState = useStoreWithMosaic((s) => s.mosaic.clients[stableId]);\n\n  // Keep query and queryResult in refs so they can be accessed in effect\n  const queryRef = useRef(query);\n  const queryResultRef = useRef(queryResult);\n  const queryErrorRef = useRef(queryError);\n\n  useEffect(() => {\n    queryRef.current = query;\n    queryResultRef.current = queryResult;\n    queryErrorRef.current = queryError;\n  }, [query, queryError, queryResult]);\n\n  const clientData = clientState?.data;\n  const arrowData = useMemo(() => {\n    if (!clientData) {\n      return null;\n    }\n    return toArrowClientResult(clientData);\n  }, [clientData]);\n\n  useEffect(() => {\n    if (!enabled || connectionStatus !== 'ready') {\n      return;\n    }\n\n    ensureClient({\n      id: stableId,\n      selectionName,\n      selection: directSelection,\n      query: queryRef.current,\n      onQueryResult: (result) => {\n        queryResultRef.current?.(toArrowClientResult(result));\n      },\n      onQueryError: (error) => {\n        queryErrorRef.current?.(error);\n      },\n    });\n\n    return () => {\n      destroyClient(stableId);\n    };\n  }, [\n    enabled,\n    connectionStatus,\n    stableId,\n    selectionName,\n    directSelection,\n    ensureClient,\n    destroyClient,\n  ]);\n\n  return {\n    data: arrowData,\n    isLoading: clientState?.isLoading ?? connectionStatus !== 'ready',\n    error: clientState?.error,\n    client: clientState?.client ?? null,\n  };\n}\n"]}

package/package.json

@@ -1,16 +1,19 @@
 {
   "name": "@sqlrooms/mosaic",
-  "version": "0.29.0-rc.1",
+  "version": "0.29.0-rc.3",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "module": "dist/index.js",
   "type": "module",
   "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
   "author": "SQLRooms Contributors",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/sqlrooms/sqlrooms.git"
+    "url": "git+https://github.com/sqlrooms/sqlrooms.git"
   },
   "files": [
     "dist"
@@ -20,25 +23,46 @@
   },
   "dependencies": {
     "@paralleldrive/cuid2": "^3.0.0",
-    "@sqlrooms/duckdb": "0.29.0-rc.1",
-    "@sqlrooms/room-store": "0.29.0-rc.1",
+    "@sqlrooms/codemirror": "0.29.0-rc.3",
+    "@sqlrooms/color-scales": "0.29.0-rc.3",
+    "@sqlrooms/data-table": "0.29.0-rc.3",
+    "@sqlrooms/db": "0.29.0-rc.3",
+    "@sqlrooms/duckdb": "0.29.0-rc.3",
+    "@sqlrooms/layout": "0.29.0-rc.3",
+    "@sqlrooms/layout-config": "0.29.0-rc.3",
+    "@sqlrooms/room-store": "0.29.0-rc.3",
+    "@sqlrooms/ui": "0.29.0-rc.3",
+    "@sqlrooms/utils": "0.29.0-rc.3",
+    "@uwdata/flechette": "^2.2.6",
     "@uwdata/mosaic-core": "^0.21.0",
+    "@uwdata/mosaic-plot": "^0.21.0",
     "@uwdata/mosaic-spec": "^0.21.0",
     "@uwdata/mosaic-sql": "^0.21.0",
     "@uwdata/vgplot": "^0.21.0",
+    "apache-arrow": "17.0.0",
     "immer": "^11.0.1",
-    "zod": "^4.1.8"
+    "lucide-react": "^0.556.0",
+    "zod": "^4.1.8",
+    "zustand": "^5.0.8"
   },
   "peerDependencies": {
     "react": ">=18",
     "react-dom": ">=18"
   },
+  "devDependencies": {
+    "@jest/globals": "^30.3.0",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "jsdom": "^29.1.1",
+    "ts-jest": "^29.4.4"
+  },
   "scripts": {
     "dev": "tsc -w",
     "build": "tsc",
+    "test": "NODE_OPTIONS='--experimental-vm-modules --no-warnings' jest",
     "lint": "eslint .",
     "typecheck": "tsc --noEmit",
     "typedoc": "typedoc"
   },
-  "gitHead": "69f127fd34bd7f2ce3d75d6098dbf8c1f5ab50f3"
+  "gitHead": "cfe98c975d09c59aa8b2f2b01e7ef9fd96bc90b0"
 }