@sqlrooms/deck 0.29.0-rc.10

package/dist/datasets/helpers.js

@@ -0,0 +1,155 @@
+import { isSqlDatasetInput, isTableDatasetInput, } from '../types';
+import { resolveArrowTable } from './normalizeDatasets';
+export const DEFAULT_MAX_PREPARED_DATASET_ENTRIES = 20;
+let nextDatasetAccess = 0;
+let nextTableIdentity = 0;
+let nextSqlSourceIdentity = 0;
+const tableIdentities = new WeakMap();
+const sqlSourceIdentities = new WeakMap();
+/** Return a monotonic access timestamp used by the prepared-dataset LRU. */
+export function nextAccessTimestamp() {
+    nextDatasetAccess += 1;
+    return nextDatasetAccess;
+}
+/**
+ * Assign a stable cache identity to an Arrow table object.
+ *
+ * Table identities are stored in a `WeakMap` so this cache does not extend the
+ * lifetime of tables once they are no longer referenced elsewhere.
+ */
+export function getTableIdentity(table) {
+    const cached = tableIdentities.get(table);
+    if (cached) {
+        return cached;
+    }
+    nextTableIdentity += 1;
+    const identity = `table:${nextTableIdentity}`;
+    tableIdentities.set(table, identity);
+    return identity;
+}
+/**
+ * Assign a stable cache identity to the current SQL source object.
+ *
+ * For SQL datasets we include the upstream DuckDB connector identity in the
+ * cache key so two rooms using the same SQL text do not accidentally share
+ * prepared results across different database instances.
+ */
+export function getSqlSourceIdentity(sqlSourceIdentity) {
+    const cached = sqlSourceIdentities.get(sqlSourceIdentity);
+    if (cached) {
+        return cached;
+    }
+    nextSqlSourceIdentity += 1;
+    const identity = `sql-source:${nextSqlSourceIdentity}`;
+    sqlSourceIdentities.set(sqlSourceIdentity, identity);
+    return identity;
+}
+export function buildGeometryKey(input) {
+    return `${input.geometryColumn ?? ''}\u0001${input.geometryEncodingHint ?? ''}`;
+}
+/**
+ * Build the canonical cache key for one dataset input.
+ *
+ * The key intentionally ignores the user-facing dataset id and instead uses
+ * the underlying data identity:
+ *
+ * - SQL/table datasets: DuckDB connector identity + compiled SQL + geometry options
+ * - Arrow datasets: table object identity + geometry options
+ *
+ * Unresolved Arrow inputs (`arrowTable: undefined`) return `undefined`, which
+ * signals that the dataset should remain in `loading` until a table exists.
+ */
+export function resolvePreparedDatasetCacheKey(options) {
+    const { input, sqlSourceIdentity } = options;
+    if (isSqlDatasetInput(input) || isTableDatasetInput(input)) {
+        if (!sqlSourceIdentity) {
+            throw new Error('SQL-backed dataset cache keys require a sqlSourceIdentity object.');
+        }
+        if (isTableDatasetInput(input)) {
+            return [
+                'table',
+                getSqlSourceIdentity(sqlSourceIdentity),
+                input.tableName,
+                input.transformSql ?? '',
+                buildGeometryKey(input),
+            ].join('\u0001');
+        }
+        return [
+            'sql',
+            getSqlSourceIdentity(sqlSourceIdentity),
+            input.sqlQuery,
+            buildGeometryKey(input),
+        ].join('\u0001');
+    }
+    const table = resolveArrowTable(input);
+    if (!table) {
+        return undefined;
+    }
+    return ['arrow', getTableIdentity(table), buildGeometryKey(input)].join('\u0001');
+}
+/**
+ * Clone a cache entry while replacing its consumer set and refreshing the
+ * access timestamp.
+ *
+ * This keeps the discriminated union shape intact while centralizing the
+ * bookkeeping needed by consumer reconciliation and LRU tracking.
+ */
+export function cloneEntryWithConsumers(entry, consumers) {
+    const lastAccessedAt = nextAccessTimestamp();
+    if (entry.status === 'loading') {
+        return {
+            status: 'loading',
+            promise: entry.promise,
+            consumers,
+            lastAccessedAt,
+        };
+    }
+    if (entry.status === 'ready') {
+        return {
+            status: 'ready',
+            prepared: entry.prepared,
+            consumers,
+            lastAccessedAt,
+        };
+    }
+    return {
+        status: 'error',
+        error: entry.error,
+        consumers,
+        lastAccessedAt,
+    };
+}
+/** Mark an entry as recently used without changing its lifecycle payload. */
+export function touchEntry(entry) {
+    return cloneEntryWithConsumers(entry, new Set(entry.consumers));
+}
+/**
+ * Evict least-recently-used settled entries when the cache exceeds capacity.
+ *
+ * Only `ready` and `error` entries participate in eviction. `loading` entries
+ * are preserved so in-flight work is not discarded, and referenced entries are
+ * preserved so active maps never lose their prepared data mid-render.
+ */
+export function evictLruEntries(entries, maxEntries) {
+    const settledEntries = Object.entries(entries).filter(([, entry]) => entry.status !== 'loading');
+    if (settledEntries.length <= maxEntries) {
+        return entries;
+    }
+    const evictable = settledEntries
+        .filter(([, entry]) => entry.consumers.size === 0)
+        .sort(([, left], [, right]) => left.lastAccessedAt - right.lastAccessedAt);
+    if (evictable.length === 0) {
+        return entries;
+    }
+    const nextEntries = { ...entries };
+    let settledCount = settledEntries.length;
+    for (const [cacheKey] of evictable) {
+        if (settledCount <= maxEntries) {
+            break;
+        }
+        delete nextEntries[cacheKey];
+        settledCount -= 1;
+    }
+    return nextEntries;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/datasets/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/datasets/helpers.ts"],"names":[],"mappings":"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","sourcesContent":["import type * as arrow from 'apache-arrow';\nimport {\n  isSqlDatasetInput,\n  isTableDatasetInput,\n  type DeckDatasetInput,\n} from '../types';\nimport {resolveArrowTable} from './normalizeDatasets';\nimport type {PreparedDatasetCacheEntry} from './types';\n\nexport const DEFAULT_MAX_PREPARED_DATASET_ENTRIES = 20;\n\nlet nextDatasetAccess = 0;\nlet nextTableIdentity = 0;\nlet nextSqlSourceIdentity = 0;\n\nconst tableIdentities = new WeakMap<arrow.Table, string>();\nconst sqlSourceIdentities = new WeakMap<object, string>();\n\n/** Return a monotonic access timestamp used by the prepared-dataset LRU. */\nexport function nextAccessTimestamp(): number {\n  nextDatasetAccess += 1;\n  return nextDatasetAccess;\n}\n\n/**\n * Assign a stable cache identity to an Arrow table object.\n *\n * Table identities are stored in a `WeakMap` so this cache does not extend the\n * lifetime of tables once they are no longer referenced elsewhere.\n */\nexport function getTableIdentity(table: arrow.Table): string {\n  const cached = tableIdentities.get(table);\n  if (cached) {\n    return cached;\n  }\n\n  nextTableIdentity += 1;\n  const identity = `table:${nextTableIdentity}`;\n  tableIdentities.set(table, identity);\n  return identity;\n}\n\n/**\n * Assign a stable cache identity to the current SQL source object.\n *\n * For SQL datasets we include the upstream DuckDB connector identity in the\n * cache key so two rooms using the same SQL text do not accidentally share\n * prepared results across different database instances.\n */\nexport function getSqlSourceIdentity(sqlSourceIdentity: object): string {\n  const cached = sqlSourceIdentities.get(sqlSourceIdentity);\n  if (cached) {\n    return cached;\n  }\n\n  nextSqlSourceIdentity += 1;\n  const identity = `sql-source:${nextSqlSourceIdentity}`;\n  sqlSourceIdentities.set(sqlSourceIdentity, identity);\n  return identity;\n}\n\nexport function buildGeometryKey(input: DeckDatasetInput): string {\n  return `${input.geometryColumn ?? ''}\\u0001${input.geometryEncodingHint ?? ''}`;\n}\n\n/**\n * Build the canonical cache key for one dataset input.\n *\n * The key intentionally ignores the user-facing dataset id and instead uses\n * the underlying data identity:\n *\n * - SQL/table datasets: DuckDB connector identity + compiled SQL + geometry options\n * - Arrow datasets: table object identity + geometry options\n *\n * Unresolved Arrow inputs (`arrowTable: undefined`) return `undefined`, which\n * signals that the dataset should remain in `loading` until a table exists.\n */\nexport function resolvePreparedDatasetCacheKey(options: {\n  input: DeckDatasetInput;\n  sqlSourceIdentity?: object;\n}): string | undefined {\n  const {input, sqlSourceIdentity} = options;\n\n  if (isSqlDatasetInput(input) || isTableDatasetInput(input)) {\n    if (!sqlSourceIdentity) {\n      throw new Error(\n        'SQL-backed dataset cache keys require a sqlSourceIdentity object.',\n      );\n    }\n\n    if (isTableDatasetInput(input)) {\n      return [\n        'table',\n        getSqlSourceIdentity(sqlSourceIdentity),\n        input.tableName,\n        input.transformSql ?? '',\n        buildGeometryKey(input),\n      ].join('\\u0001');\n    }\n\n    return [\n      'sql',\n      getSqlSourceIdentity(sqlSourceIdentity),\n      input.sqlQuery,\n      buildGeometryKey(input),\n    ].join('\\u0001');\n  }\n\n  const table = resolveArrowTable(input);\n  if (!table) {\n    return undefined;\n  }\n\n  return ['arrow', getTableIdentity(table), buildGeometryKey(input)].join(\n    '\\u0001',\n  );\n}\n\n/**\n * Clone a cache entry while replacing its consumer set and refreshing the\n * access timestamp.\n *\n * This keeps the discriminated union shape intact while centralizing the\n * bookkeeping needed by consumer reconciliation and LRU tracking.\n */\nexport function cloneEntryWithConsumers(\n  entry: PreparedDatasetCacheEntry,\n  consumers: Set<string>,\n): PreparedDatasetCacheEntry {\n  const lastAccessedAt = nextAccessTimestamp();\n\n  if (entry.status === 'loading') {\n    return {\n      status: 'loading',\n      promise: entry.promise,\n      consumers,\n      lastAccessedAt,\n    };\n  }\n\n  if (entry.status === 'ready') {\n    return {\n      status: 'ready',\n      prepared: entry.prepared,\n      consumers,\n      lastAccessedAt,\n    };\n  }\n\n  return {\n    status: 'error',\n    error: entry.error,\n    consumers,\n    lastAccessedAt,\n  };\n}\n\n/** Mark an entry as recently used without changing its lifecycle payload. */\nexport function touchEntry(\n  entry: PreparedDatasetCacheEntry,\n): PreparedDatasetCacheEntry {\n  return cloneEntryWithConsumers(entry, new Set(entry.consumers));\n}\n\n/**\n * Evict least-recently-used settled entries when the cache exceeds capacity.\n *\n * Only `ready` and `error` entries participate in eviction. `loading` entries\n * are preserved so in-flight work is not discarded, and referenced entries are\n * preserved so active maps never lose their prepared data mid-render.\n */\nexport function evictLruEntries(\n  entries: Record<string, PreparedDatasetCacheEntry>,\n  maxEntries: number,\n): Record<string, PreparedDatasetCacheEntry> {\n  const settledEntries = Object.entries(entries).filter(\n    ([, entry]) => entry.status !== 'loading',\n  );\n\n  if (settledEntries.length <= maxEntries) {\n    return entries;\n  }\n\n  const evictable = settledEntries\n    .filter(([, entry]) => entry.consumers.size === 0)\n    .sort(([, left], [, right]) => left.lastAccessedAt - right.lastAccessedAt);\n\n  if (evictable.length === 0) {\n    return entries;\n  }\n\n  const nextEntries = {...entries};\n  let settledCount = settledEntries.length;\n\n  for (const [cacheKey] of evictable) {\n    if (settledCount <= maxEntries) {\n      break;\n    }\n\n    delete nextEntries[cacheKey];\n    settledCount -= 1;\n  }\n\n  return nextEntries;\n}\n"]}

package/dist/datasets/normalizeDatasets.d.ts

@@ -0,0 +1,11 @@
+import type * as arrow from 'apache-arrow';
+import { type DeckDatasetInput, type DeckJsonMapProps } from '../types';
+export declare function resolveArrowTable(input: DeckDatasetInput): arrow.Table | undefined;
+/**
+ * Validate and normalize a raw datasets record into canonical
+ * `DeckDatasetInput` entries.
+ *
+ * @throws {Error} If `datasets` is empty (DeckJsonMap requires at least one entry).
+ */
+export declare function normalizeDatasets(datasets: DeckJsonMapProps['datasets']): Record<string, DeckDatasetInput>;
+//# sourceMappingURL=normalizeDatasets.d.ts.map

package/dist/datasets/normalizeDatasets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeDatasets.d.ts","sourceRoot":"","sources":["../../src/datasets/normalizeDatasets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAC;AAC3C,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,UAAU,CAAC;AAqClB,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,gBAAgB,GACtB,KAAK,CAAC,KAAK,GAAG,SAAS,CAMzB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,gBAAgB,CAAC,UAAU,CAAC,GACrC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAalC"}

package/dist/datasets/normalizeDatasets.js

@@ -0,0 +1,50 @@
+import { isArrowTableDatasetInput, isSqlDatasetInput, isTableDatasetInput, } from '../types';
+import { toArrowTable } from './tableAdapter';
+function normalizeDatasetEntry(datasetId, input) {
+    if (isSqlDatasetInput(input)) {
+        return {
+            sqlQuery: input.sqlQuery,
+            geometryColumn: input.geometryColumn,
+            geometryEncodingHint: input.geometryEncodingHint,
+        };
+    }
+    if (isArrowTableDatasetInput(input)) {
+        return {
+            arrowTable: input.arrowTable,
+            geometryColumn: input.geometryColumn,
+            geometryEncodingHint: input.geometryEncodingHint,
+        };
+    }
+    if (isTableDatasetInput(input)) {
+        return {
+            tableName: input.tableName,
+            transformSql: input.transformSql,
+            geometryColumn: input.geometryColumn,
+            geometryEncodingHint: input.geometryEncodingHint,
+        };
+    }
+    throw new Error(`Dataset "${datasetId}" has an unrecognized input shape. Expected { sqlQuery }, { tableName }, { tableName, transformSql }, or { arrowTable }.`);
+}
+export function resolveArrowTable(input) {
+    if (!isArrowTableDatasetInput(input) || input.arrowTable === undefined) {
+        return undefined;
+    }
+    return toArrowTable(input.arrowTable);
+}
+/**
+ * Validate and normalize a raw datasets record into canonical
+ * `DeckDatasetInput` entries.
+ *
+ * @throws {Error} If `datasets` is empty (DeckJsonMap requires at least one entry).
+ */
+export function normalizeDatasets(datasets) {
+    const entries = Object.entries(datasets);
+    if (entries.length === 0) {
+        throw new Error('DeckJsonMap requires at least one dataset entry.');
+    }
+    return Object.fromEntries(entries.map(([datasetId, input]) => [
+        datasetId,
+        normalizeDatasetEntry(datasetId, input),
+    ]));
+}
+//# sourceMappingURL=normalizeDatasets.js.map

package/dist/datasets/normalizeDatasets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeDatasets.js","sourceRoot":"","sources":["../../src/datasets/normalizeDatasets.ts"],"names":[],"mappings":"AACA,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,GAGpB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAE5C,SAAS,qBAAqB,CAC5B,SAAiB,EACjB,KAAuB;IAEvB,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO;YACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;SACjD,CAAC;IACJ,CAAC;IAED,IAAI,wBAAwB,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,OAAO;YACL,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;SACjD,CAAC;IACJ,CAAC;IAED,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO;YACL,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;SACjD,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,KAAK,CACb,YAAY,SAAS,0HAA0H,CAChJ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAAuB;IAEvB,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACvE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;AACxC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAsC;IAEtC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEzC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,OAAO,MAAM,CAAC,WAAW,CACvB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;QAClC,SAAS;QACT,qBAAqB,CAAC,SAAS,EAAE,KAAK,CAAC;KACxC,CAAC,CACH,CAAC;AACJ,CAAC","sourcesContent":["import type * as arrow from 'apache-arrow';\nimport {\n  isArrowTableDatasetInput,\n  isSqlDatasetInput,\n  isTableDatasetInput,\n  type DeckDatasetInput,\n  type DeckJsonMapProps,\n} from '../types';\nimport {toArrowTable} from './tableAdapter';\n\nfunction normalizeDatasetEntry(\n  datasetId: string,\n  input: DeckDatasetInput,\n): DeckDatasetInput {\n  if (isSqlDatasetInput(input)) {\n    return {\n      sqlQuery: input.sqlQuery,\n      geometryColumn: input.geometryColumn,\n      geometryEncodingHint: input.geometryEncodingHint,\n    };\n  }\n\n  if (isArrowTableDatasetInput(input)) {\n    return {\n      arrowTable: input.arrowTable,\n      geometryColumn: input.geometryColumn,\n      geometryEncodingHint: input.geometryEncodingHint,\n    };\n  }\n\n  if (isTableDatasetInput(input)) {\n    return {\n      tableName: input.tableName,\n      transformSql: input.transformSql,\n      geometryColumn: input.geometryColumn,\n      geometryEncodingHint: input.geometryEncodingHint,\n    };\n  }\n\n  throw new Error(\n    `Dataset \"${datasetId}\" has an unrecognized input shape. Expected { sqlQuery }, { tableName }, { tableName, transformSql }, or { arrowTable }.`,\n  );\n}\n\nexport function resolveArrowTable(\n  input: DeckDatasetInput,\n): arrow.Table | undefined {\n  if (!isArrowTableDatasetInput(input) || input.arrowTable === undefined) {\n    return undefined;\n  }\n\n  return toArrowTable(input.arrowTable);\n}\n\n/**\n * Validate and normalize a raw datasets record into canonical\n * `DeckDatasetInput` entries.\n *\n * @throws {Error} If `datasets` is empty (DeckJsonMap requires at least one entry).\n */\nexport function normalizeDatasets(\n  datasets: DeckJsonMapProps['datasets'],\n): Record<string, DeckDatasetInput> {\n  const entries = Object.entries(datasets);\n\n  if (entries.length === 0) {\n    throw new Error('DeckJsonMap requires at least one dataset entry.');\n  }\n\n  return Object.fromEntries(\n    entries.map(([datasetId, input]) => [\n      datasetId,\n      normalizeDatasetEntry(datasetId, input),\n    ]),\n  );\n}\n"]}

package/dist/datasets/tableAdapter.d.ts

@@ -0,0 +1,11 @@
+import type { Table as ArrowTable } from 'apache-arrow';
+export type SupportedTable = ArrowTable;
+/**
+ * Normalize supported table runtimes to Apache Arrow for deck preparation.
+ *
+ * `@sqlrooms/deck` uses Apache Arrow internally because GeoArrow integration
+ * and the existing preparation pipeline depend on Arrow's `Table` / `Vector`
+ * APIs. The public `arrowTable` dataset input is therefore Apache Arrow.
+ */
+export declare function toArrowTable(table: SupportedTable): ArrowTable;
+//# sourceMappingURL=tableAdapter.d.ts.map

package/dist/datasets/tableAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableAdapter.d.ts","sourceRoot":"","sources":["../../src/datasets/tableAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,KAAK,IAAI,UAAU,EAAC,MAAM,cAAc,CAAC;AAEtD,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC;AAExC;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,CAE9D"}

package/dist/datasets/tableAdapter.js

@@ -0,0 +1,11 @@
+/**
+ * Normalize supported table runtimes to Apache Arrow for deck preparation.
+ *
+ * `@sqlrooms/deck` uses Apache Arrow internally because GeoArrow integration
+ * and the existing preparation pipeline depend on Arrow's `Table` / `Vector`
+ * APIs. The public `arrowTable` dataset input is therefore Apache Arrow.
+ */
+export function toArrowTable(table) {
+    return table;
+}
+//# sourceMappingURL=tableAdapter.js.map

package/dist/datasets/tableAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableAdapter.js","sourceRoot":"","sources":["../../src/datasets/tableAdapter.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,KAAqB;IAChD,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import type {Table as ArrowTable} from 'apache-arrow';\n\nexport type SupportedTable = ArrowTable;\n\n/**\n * Normalize supported table runtimes to Apache Arrow for deck preparation.\n *\n * `@sqlrooms/deck` uses Apache Arrow internally because GeoArrow integration\n * and the existing preparation pipeline depend on Arrow's `Table` / `Vector`\n * APIs. The public `arrowTable` dataset input is therefore Apache Arrow.\n */\nexport function toArrowTable(table: SupportedTable): ArrowTable {\n  return table;\n}\n"]}

package/dist/datasets/tableDatasetSql.d.ts

@@ -0,0 +1,16 @@
+import type { DeckTableDatasetInput } from '../types';
+/** Reserved relation name that table dataset transforms must read from. */
+export declare const DECK_TABLE_DATASET_SOURCE_RELATION = "__sqlrooms_source";
+/** Error thrown when a table dataset input cannot be compiled to a table ref. */
+export declare class DeckTableDatasetInvalidTableNameError extends Error {
+    constructor();
+}
+/**
+ * Compiles a structured table dataset input into executable SQL.
+ *
+ * Direct table inputs compile to `SELECT * FROM <quoted table>`. Transformed
+ * inputs bind the table to the reserved `__sqlrooms_source` CTE and nest the
+ * authored `transformSql` so its CTEs remain self-contained.
+ */
+export declare function createDeckTableDatasetSql(input: DeckTableDatasetInput): string;
+//# sourceMappingURL=tableDatasetSql.d.ts.map

package/dist/datasets/tableDatasetSql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableDatasetSql.d.ts","sourceRoot":"","sources":["../../src/datasets/tableDatasetSql.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,UAAU,CAAC;AAEpD,2EAA2E;AAC3E,eAAO,MAAM,kCAAkC,sBAAsB,CAAC;AAEtE,iFAAiF;AACjF,qBAAa,qCAAsC,SAAQ,KAAK;;CAK/D;AAqBD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,qBAAqB,GAC3B,MAAM,CAyBR"}

package/dist/datasets/tableDatasetSql.js

@@ -0,0 +1,49 @@
+import { quoteParsedRawSqlTableReference } from '@sqlrooms/duckdb';
+/** Reserved relation name that table dataset transforms must read from. */
+export const DECK_TABLE_DATASET_SOURCE_RELATION = '__sqlrooms_source';
+/** Error thrown when a table dataset input cannot be compiled to a table ref. */
+export class DeckTableDatasetInvalidTableNameError extends Error {
+    constructor() {
+        super('Deck table dataset input requires a valid tableName.');
+        this.name = 'DeckTableDatasetInvalidTableNameError';
+    }
+}
+function cleanTransformSql(transformSql) {
+    return transformSql.trim().replace(/(?:\s*;+\s*)+$/, '');
+}
+function createTransformedTableDatasetSql(options) {
+    return [
+        `WITH ${DECK_TABLE_DATASET_SOURCE_RELATION} AS (`,
+        `  SELECT * FROM ${options.tableReference}`,
+        `)`,
+        `SELECT *`,
+        `FROM (`,
+        options.transformSql,
+        `) AS "__sqlrooms_transform"`,
+    ].join('\n');
+}
+/**
+ * Compiles a structured table dataset input into executable SQL.
+ *
+ * Direct table inputs compile to `SELECT * FROM <quoted table>`. Transformed
+ * inputs bind the table to the reserved `__sqlrooms_source` CTE and nest the
+ * authored `transformSql` so its CTEs remain self-contained.
+ */
+export function createDeckTableDatasetSql(input) {
+    const tableReference = quoteParsedRawSqlTableReference(input.tableName);
+    if (!tableReference) {
+        throw new DeckTableDatasetInvalidTableNameError();
+    }
+    if (!input.transformSql?.trim()) {
+        return `SELECT * FROM ${tableReference}`;
+    }
+    const transformSql = cleanTransformSql(input.transformSql);
+    if (!new RegExp(`\\b${DECK_TABLE_DATASET_SOURCE_RELATION}\\b`, 'i').test(transformSql)) {
+        throw new Error(`Deck table dataset transformSql must reference ${DECK_TABLE_DATASET_SOURCE_RELATION}.`);
+    }
+    return createTransformedTableDatasetSql({
+        tableReference,
+        transformSql,
+    });
+}
+//# sourceMappingURL=tableDatasetSql.js.map

package/dist/datasets/tableDatasetSql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tableDatasetSql.js","sourceRoot":"","sources":["../../src/datasets/tableDatasetSql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,+BAA+B,EAAC,MAAM,kBAAkB,CAAC;AAGjE,2EAA2E;AAC3E,MAAM,CAAC,MAAM,kCAAkC,GAAG,mBAAmB,CAAC;AAEtE,iFAAiF;AACjF,MAAM,OAAO,qCAAsC,SAAQ,KAAK;IAC9D;QACE,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,GAAG,uCAAuC,CAAC;IACtD,CAAC;CACF;AAED,SAAS,iBAAiB,CAAC,YAAoB;IAC7C,OAAO,YAAY,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,gCAAgC,CAAC,OAGzC;IACC,OAAO;QACL,QAAQ,kCAAkC,OAAO;QACjD,mBAAmB,OAAO,CAAC,cAAc,EAAE;QAC3C,GAAG;QACH,UAAU;QACV,QAAQ;QACR,OAAO,CAAC,YAAY;QACpB,6BAA6B;KAC9B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAA4B;IAE5B,MAAM,cAAc,GAAG,+BAA+B,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACxE,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,qCAAqC,EAAE,CAAC;IACpD,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,IAAI,EAAE,EAAE,CAAC;QAChC,OAAO,iBAAiB,cAAc,EAAE,CAAC;IAC3C,CAAC;IAED,MAAM,YAAY,GAAG,iBAAiB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC3D,IACE,CAAC,IAAI,MAAM,CAAC,MAAM,kCAAkC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,CAClE,YAAY,CACb,EACD,CAAC;QACD,MAAM,IAAI,KAAK,CACb,kDAAkD,kCAAkC,GAAG,CACxF,CAAC;IACJ,CAAC;IAED,OAAO,gCAAgC,CAAC;QACtC,cAAc;QACd,YAAY;KACb,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {quoteParsedRawSqlTableReference} from '@sqlrooms/duckdb';\nimport type {DeckTableDatasetInput} from '../types';\n\n/** Reserved relation name that table dataset transforms must read from. */\nexport const DECK_TABLE_DATASET_SOURCE_RELATION = '__sqlrooms_source';\n\n/** Error thrown when a table dataset input cannot be compiled to a table ref. */\nexport class DeckTableDatasetInvalidTableNameError extends Error {\n  constructor() {\n    super('Deck table dataset input requires a valid tableName.');\n    this.name = 'DeckTableDatasetInvalidTableNameError';\n  }\n}\n\nfunction cleanTransformSql(transformSql: string): string {\n  return transformSql.trim().replace(/(?:\\s*;+\\s*)+$/, '');\n}\n\nfunction createTransformedTableDatasetSql(options: {\n  tableReference: string;\n  transformSql: string;\n}) {\n  return [\n    `WITH ${DECK_TABLE_DATASET_SOURCE_RELATION} AS (`,\n    `  SELECT * FROM ${options.tableReference}`,\n    `)`,\n    `SELECT *`,\n    `FROM (`,\n    options.transformSql,\n    `) AS \"__sqlrooms_transform\"`,\n  ].join('\\n');\n}\n\n/**\n * Compiles a structured table dataset input into executable SQL.\n *\n * Direct table inputs compile to `SELECT * FROM <quoted table>`. Transformed\n * inputs bind the table to the reserved `__sqlrooms_source` CTE and nest the\n * authored `transformSql` so its CTEs remain self-contained.\n */\nexport function createDeckTableDatasetSql(\n  input: DeckTableDatasetInput,\n): string {\n  const tableReference = quoteParsedRawSqlTableReference(input.tableName);\n  if (!tableReference) {\n    throw new DeckTableDatasetInvalidTableNameError();\n  }\n\n  if (!input.transformSql?.trim()) {\n    return `SELECT * FROM ${tableReference}`;\n  }\n\n  const transformSql = cleanTransformSql(input.transformSql);\n  if (\n    !new RegExp(`\\\\b${DECK_TABLE_DATASET_SOURCE_RELATION}\\\\b`, 'i').test(\n      transformSql,\n    )\n  ) {\n    throw new Error(\n      `Deck table dataset transformSql must reference ${DECK_TABLE_DATASET_SOURCE_RELATION}.`,\n    );\n  }\n\n  return createTransformedTableDatasetSql({\n    tableReference,\n    transformSql,\n  });\n}\n"]}

package/dist/datasets/types.d.ts

@@ -0,0 +1,40 @@
+import type * as arrow from 'apache-arrow';
+import type { GeometryEncodingHint, PreparedDeckDataset } from '../prepare/types';
+/**
+ * One cached prepared-dataset entry keyed by resolved dataset identity.
+ *
+ * The entry tracks both lifecycle state and eviction metadata:
+ *
+ * - `consumers` records which hook instances currently reference the entry, so
+ *   live entries are not evicted while a map is still using them
+ * - `lastAccessedAt` drives the internal LRU policy for settled entries
+ * - the discriminated union stores either the in-flight preparation promise,
+ *   the prepared dataset, or the terminal error
+ */
+export type PreparedDatasetCacheEntry = {
+    /** Consumer ids currently subscribed to this cache entry. */
+    consumers: Set<string>;
+    /** Monotonic access counter used to evict the least-recently-used entry. */
+    lastAccessedAt: number;
+} & ({
+    status: 'loading';
+    promise: Promise<void>;
+} | {
+    status: 'ready';
+    prepared: PreparedDeckDataset;
+} | {
+    status: 'error';
+    error: Error;
+});
+export type PreparedDatasetStoreOptions = {
+    /** Maximum number of settled prepared entries to retain before LRU eviction. */
+    maxEntries?: number;
+    /** Injectable preparation function for tests and future specialization. */
+    prepareDataset?: (options: {
+        datasetId: string;
+        geometryColumn?: string;
+        geometryEncodingHint?: GeometryEncodingHint;
+        table: arrow.Table;
+    }) => PreparedDeckDataset;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/datasets/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAC,oBAAoB,EAAE,mBAAmB,EAAC,MAAM,kBAAkB,CAAC;AAEhF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,6DAA6D;IAC7D,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,4EAA4E;IAC5E,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,CACA;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAAC,GAC3C;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,mBAAmB,CAAA;CAAC,GAChD;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAC,CAClC,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE;QACzB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;QAC5C,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;KACpB,KAAK,mBAAmB,CAAC;CAC3B,CAAC"}

package/dist/datasets/types.js

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

package/dist/datasets/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/datasets/types.ts"],"names":[],"mappings":"","sourcesContent":["import type * as arrow from 'apache-arrow';\nimport type {GeometryEncodingHint, PreparedDeckDataset} from '../prepare/types';\n\n/**\n * One cached prepared-dataset entry keyed by resolved dataset identity.\n *\n * The entry tracks both lifecycle state and eviction metadata:\n *\n * - `consumers` records which hook instances currently reference the entry, so\n *   live entries are not evicted while a map is still using them\n * - `lastAccessedAt` drives the internal LRU policy for settled entries\n * - the discriminated union stores either the in-flight preparation promise,\n *   the prepared dataset, or the terminal error\n */\nexport type PreparedDatasetCacheEntry = {\n  /** Consumer ids currently subscribed to this cache entry. */\n  consumers: Set<string>;\n  /** Monotonic access counter used to evict the least-recently-used entry. */\n  lastAccessedAt: number;\n} & (\n  | {status: 'loading'; promise: Promise<void>}\n  | {status: 'ready'; prepared: PreparedDeckDataset}\n  | {status: 'error'; error: Error}\n);\n\nexport type PreparedDatasetStoreOptions = {\n  /** Maximum number of settled prepared entries to retain before LRU eviction. */\n  maxEntries?: number;\n  /** Injectable preparation function for tests and future specialization. */\n  prepareDataset?: (options: {\n    datasetId: string;\n    geometryColumn?: string;\n    geometryEncodingHint?: GeometryEncodingHint;\n    table: arrow.Table;\n  }) => PreparedDeckDataset;\n};\n"]}

package/dist/datasets/usePreparedDatasetStates.d.ts

@@ -0,0 +1,16 @@
+import { type DeckDatasetInput, type PreparedDeckDatasetState } from '../types';
+/**
+ * Subscribe a `DeckJsonMap` instance to prepared dataset state.
+ *
+ * This hook is intentionally a thin React adapter over the internal prepared
+ * dataset store. The heavy work lives in the store so prepared geometry can be
+ * reused across rerenders and even across multiple map instances, while the
+ * hook itself focuses on subscribing React to the store and cleaning up the
+ * consumer membership for this map instance.
+ *
+ * It preserves the current loading behavior for unresolved Arrow inputs, so a
+ * caller can pass `{arrowTable: undefined}` and still render the basemap while
+ * data is loading.
+ */
+export declare function usePreparedDatasetStates(datasets: Record<string, DeckDatasetInput>): Record<string, PreparedDeckDatasetState>;
+//# sourceMappingURL=usePreparedDatasetStates.d.ts.map

package/dist/datasets/usePreparedDatasetStates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePreparedDatasetStates.d.ts","sourceRoot":"","sources":["../../src/datasets/usePreparedDatasetStates.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,KAAK,gBAAgB,EAAE,KAAK,wBAAwB,EAAC,MAAM,UAAU,CAAC;AA0B9E;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GACzC,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CA6B1C"}

package/dist/datasets/usePreparedDatasetStates.js

@@ -0,0 +1,59 @@
+import { useStoreWithDuckDb } from '@sqlrooms/duckdb';
+import { useEffect, useId, useMemo, useState } from 'react';
+import { useStore } from 'zustand';
+import { shallow } from 'zustand/shallow';
+import { preparedDatasetStore, resolvePreparedDeckDatasetStates, } from './PreparedDatasetStore';
+/**
+ * Stabilize a `datasets` record so that a new object reference created on
+ * every render (e.g. an inline `{ earthquakes: { arrowTable } }` literal)
+ * does not cause downstream effects and memos to re-run when nothing
+ * actually changed.  Uses Zustand's `shallow` to compare top-level keys
+ * and per-entry identity.
+ *
+ * Implemented via the "adjusting state during rendering" pattern so the
+ * React compiler does not flag ref access during render.
+ */
+function useStableDatasets(datasets) {
+    const [stable, setStable] = useState(datasets);
+    if (!shallow(stable, datasets)) {
+        setStable(datasets);
+    }
+    return stable;
+}
+/**
+ * Subscribe a `DeckJsonMap` instance to prepared dataset state.
+ *
+ * This hook is intentionally a thin React adapter over the internal prepared
+ * dataset store. The heavy work lives in the store so prepared geometry can be
+ * reused across rerenders and even across multiple map instances, while the
+ * hook itself focuses on subscribing React to the store and cleaning up the
+ * consumer membership for this map instance.
+ *
+ * It preserves the current loading behavior for unresolved Arrow inputs, so a
+ * caller can pass `{arrowTable: undefined}` and still render the basemap while
+ * data is loading.
+ */
+export function usePreparedDatasetStates(datasets) {
+    const stableDatasets = useStableDatasets(datasets);
+    const executeSql = useStoreWithDuckDb((state) => state.db.executeSql);
+    const connector = useStoreWithDuckDb((state) => state.db.connector);
+    const consumerId = useId();
+    const entries = useStore(preparedDatasetStore, (state) => state.entries);
+    useEffect(() => {
+        preparedDatasetStore.getState().syncDatasetsForConsumer({
+            consumerId,
+            datasets: stableDatasets,
+            executeSql,
+            sqlSourceIdentity: connector,
+        });
+        return () => {
+            preparedDatasetStore.getState().removeConsumer(consumerId);
+        };
+    }, [connector, consumerId, stableDatasets, executeSql]);
+    return useMemo(() => resolvePreparedDeckDatasetStates({
+        datasets: stableDatasets,
+        entries,
+        sqlSourceIdentity: connector,
+    }), [connector, stableDatasets, entries]);
+}
+//# sourceMappingURL=usePreparedDatasetStates.js.map

package/dist/datasets/usePreparedDatasetStates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePreparedDatasetStates.js","sourceRoot":"","sources":["../../src/datasets/usePreparedDatasetStates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAC,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAC,MAAM,OAAO,CAAC;AAC1D,OAAO,EAAC,QAAQ,EAAC,MAAM,SAAS,CAAC;AACjC,OAAO,EAAC,OAAO,EAAC,MAAM,iBAAiB,CAAC;AAExC,OAAO,EACL,oBAAoB,EACpB,gCAAgC,GACjC,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;GASG;AACH,SAAS,iBAAiB,CACxB,QAA0C;IAE1C,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC/B,SAAS,CAAC,QAAQ,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAA0C;IAE1C,MAAM,cAAc,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,kBAAkB,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;IACtE,MAAM,SAAS,GAAG,kBAAkB,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;IACpE,MAAM,UAAU,GAAG,KAAK,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,QAAQ,CAAC,oBAAoB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEzE,SAAS,CAAC,GAAG,EAAE;QACb,oBAAoB,CAAC,QAAQ,EAAE,CAAC,uBAAuB,CAAC;YACtD,UAAU;YACV,QAAQ,EAAE,cAAc;YACxB,UAAU;YACV,iBAAiB,EAAE,SAAS;SAC7B,CAAC,CAAC;QAEH,OAAO,GAAG,EAAE;YACV,oBAAoB,CAAC,QAAQ,EAAE,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QAC7D,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC,CAAC;IAExD,OAAO,OAAO,CACZ,GAAG,EAAE,CACH,gCAAgC,CAAC;QAC/B,QAAQ,EAAE,cAAc;QACxB,OAAO;QACP,iBAAiB,EAAE,SAAS;KAC7B,CAAC,EACJ,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,CAAC,CACrC,CAAC;AACJ,CAAC","sourcesContent":["import {useStoreWithDuckDb} from '@sqlrooms/duckdb';\nimport {useEffect, useId, useMemo, useState} from 'react';\nimport {useStore} from 'zustand';\nimport {shallow} from 'zustand/shallow';\nimport {type DeckDatasetInput, type PreparedDeckDatasetState} from '../types';\nimport {\n  preparedDatasetStore,\n  resolvePreparedDeckDatasetStates,\n} from './PreparedDatasetStore';\n\n/**\n * Stabilize a `datasets` record so that a new object reference created on\n * every render (e.g. an inline `{ earthquakes: { arrowTable } }` literal)\n * does not cause downstream effects and memos to re-run when nothing\n * actually changed.  Uses Zustand's `shallow` to compare top-level keys\n * and per-entry identity.\n *\n * Implemented via the \"adjusting state during rendering\" pattern so the\n * React compiler does not flag ref access during render.\n */\nfunction useStableDatasets(\n  datasets: Record<string, DeckDatasetInput>,\n): Record<string, DeckDatasetInput> {\n  const [stable, setStable] = useState(datasets);\n  if (!shallow(stable, datasets)) {\n    setStable(datasets);\n  }\n  return stable;\n}\n\n/**\n * Subscribe a `DeckJsonMap` instance to prepared dataset state.\n *\n * This hook is intentionally a thin React adapter over the internal prepared\n * dataset store. The heavy work lives in the store so prepared geometry can be\n * reused across rerenders and even across multiple map instances, while the\n * hook itself focuses on subscribing React to the store and cleaning up the\n * consumer membership for this map instance.\n *\n * It preserves the current loading behavior for unresolved Arrow inputs, so a\n * caller can pass `{arrowTable: undefined}` and still render the basemap while\n * data is loading.\n */\nexport function usePreparedDatasetStates(\n  datasets: Record<string, DeckDatasetInput>,\n): Record<string, PreparedDeckDatasetState> {\n  const stableDatasets = useStableDatasets(datasets);\n  const executeSql = useStoreWithDuckDb((state) => state.db.executeSql);\n  const connector = useStoreWithDuckDb((state) => state.db.connector);\n  const consumerId = useId();\n  const entries = useStore(preparedDatasetStore, (state) => state.entries);\n\n  useEffect(() => {\n    preparedDatasetStore.getState().syncDatasetsForConsumer({\n      consumerId,\n      datasets: stableDatasets,\n      executeSql,\n      sqlSourceIdentity: connector,\n    });\n\n    return () => {\n      preparedDatasetStore.getState().removeConsumer(consumerId);\n    };\n  }, [connector, consumerId, stableDatasets, executeSql]);\n\n  return useMemo(\n    () =>\n      resolvePreparedDeckDatasetStates({\n        datasets: stableDatasets,\n        entries,\n        sqlSourceIdentity: connector,\n      }),\n    [connector, stableDatasets, entries],\n  );\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * {@include ../README.md}
+ * @packageDocumentation
+ */
+export { ColorScaleLegend } from '@sqlrooms/color-scales';
+export { createDeckJsonSpecFromDatasets } from './createDeckJsonSpecFromDatasets';
+export { DeckMapBlockSettings } from './BlockMapSettings';
+export { DeckMapSettingsPanel, type DeckMapSettingsPanelProps, } from './MapSettings';
+export { DeckMapBlockRenderer, ensureDeckMapResourceState, type DeckMapBlockRendererProps, } from './block';
+export { asDeckJsonMapConfig, createEmptyDeckMapConfig, createDeckMapDashboardPanelConfig, DEFAULT_DECK_MAP_MAX_DATA_POINTS, DECK_MAP_DASHBOARD_PANEL_TYPE, isDeckMapDashboardSqlDatasetSource, isDeckMapDashboardTableDatasetSource, } from './mapConfig';
+export { getDeckMapDataPolicy, type DeckMapDataPolicy } from './mapDataPolicy';
+export { createDeckMapDashboardConfigForTable, createDeckMapConfigForTable, createDeckMapDashboardPanelConfigForTable, createDeckMapPointTransformSql, findDeckMapLongitudeLatitudeColumns, findGeometryColumn, findLongitudeLatitudeColumns, normalizeDeckMapFillColor, normalizeDeckMapPointConfig, quoteDeckMapSqlIdentifier, quoteDeckMapSqlTableReference, regenerateMapConfigForTable, } from './mapConfigUtils';
+export type { DeckMapConfigColumn, DeckMapFillColor, DeckMapTableReference, } from './mapConfigUtils';
+export { getFirstDatasetSourceTableName, hasSqlOnlyDatasetSource, } from './datasetSourceUtils';
+export type { DeckMapDatasetSourceConfig } from './datasetSourceUtils';
+export { DeckMapResourceConfigParameter, DeckMapResourceToolParameters, } from './mapAiConfig';
+export { DeckMapResourceConfigError, assertDeckMapResourceConfig, getDeckMapResourceAiInstructions, getDeckMapResourceConfigIssues, mergeDeckMapResourceConfigPatch, type DeckMapResourceConfigMergeOptions, type DeckMapResourceConfigIssue, type DeckMapResourceConfigValidationOptions, } from './mapResourceAuthoring';
+export { createOrUpdateDeckMapResource, type CreateOrUpdateDeckMapResourceHost, type CreateOrUpdateDeckMapResourceParams, type CreateOrUpdateDeckMapResourceResult, } from './createOrUpdateDeckMapResource';
+export { DeckMapResourceSchema, DeckMapsSliceConfig, createDeckMapsSlice, useStoreWithDeckMaps, } from './DeckMapsSlice';
+export type { DeckMapResource, DeckMapRuntimeIssue, DeckMapRuntimeIssueReporter, DeckMapsSliceState, } from './DeckMapsSlice';
+export { DeckMapSurface, directDeckMapDataAdapter, type DeckMapDataAdapter, type DeckMapSurfaceProps, } from './DeckMapSurface';
+export { DECK_MAP_BLOCK_DEFAULT_HEIGHT, DECK_MAP_BLOCK_DEFAULT_TITLE, DECK_MAP_BLOCK_TYPE, createDeckMapBlockDocumentCommandType, createDeckMapBlockDocumentType, type DeckMapBlockDocumentRegistrationOptions, } from './blockDocumentRegistration';
+export type { DeckMapConfigMode, DeckMapDashboardFitToDataConfig, CreateDeckMapDashboardPanelConfigOptions, DeckMapDashboardDatasetConfig, DeckMapDataPolicyOverride, DeckMapDashboardInteractionConfig, DeckMapDashboardPanelConfig, DeckMapConfig, DeckMapDatasetConfig, DeckMapDatasetSource, DeckMapFitToDataConfig, DeckMapInteractionConfig, } from './mapConfig';
+export { DeckJsonMap } from './DeckJsonMap';
+export { DeckMapDefaultStylesProvider, resolveDeckMapStyle, useDeckMapDefaultStyles, type DeckMapDefaultStyles, type DeckMapStyle, } from './DeckMapDefaultStylesProvider';
+export { ColorScaleFunction, GeometryEncodingHint as DeckGeometryEncodingHint, DeckJsonMapLayerSpec, DeckJsonMapSpec, LayerBindingConfig, LayerBindingProps, } from './DeckJsonMapSpec';
+export { createDeckJsonConfiguration } from './json/createDeckJsonConfiguration';
+export { prepareDeckDataset } from './prepare/prepareDeckDataset';
+export type { ColorLegendConfig, ColorScaleConfig } from '@sqlrooms/color-scales';
+export type { GeometryEncodingHint, PreparedDeckDataset, PreparedGeoArrowLayerData, ResolvedGeometryColumn, ResolvedGeometryEncoding, } from './prepare/types';
+export { isArrowTableDatasetInput, isSqlDatasetInput, isTableDatasetInput, } from './types';
+export { DECK_TABLE_DATASET_SOURCE_RELATION, createDeckTableDatasetSql, } from './datasets/tableDatasetSql';
+export type { CreateDeckJsonSpecFromDatasetsOptions, DeckArrowTableDatasetInput, DeckAutoLayerType, DeckDatasetInput, DeckJsonMapHandle, DeckJsonMapProps, DeckJsonSpecDatasetHint, DeckSqlDatasetInput, DeckTableDatasetInput, DeckTable, PreparedDeckDatasetState, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,27 @@
+/**
+ * {@include ../README.md}
+ * @packageDocumentation
+ */
+export { ColorScaleLegend } from '@sqlrooms/color-scales';
+export { createDeckJsonSpecFromDatasets } from './createDeckJsonSpecFromDatasets';
+export { DeckMapBlockSettings } from './BlockMapSettings';
+export { DeckMapSettingsPanel, } from './MapSettings';
+export { DeckMapBlockRenderer, ensureDeckMapResourceState, } from './block';
+export { asDeckJsonMapConfig, createEmptyDeckMapConfig, createDeckMapDashboardPanelConfig, DEFAULT_DECK_MAP_MAX_DATA_POINTS, DECK_MAP_DASHBOARD_PANEL_TYPE, isDeckMapDashboardSqlDatasetSource, isDeckMapDashboardTableDatasetSource, } from './mapConfig';
+export { getDeckMapDataPolicy } from './mapDataPolicy';
+export { createDeckMapDashboardConfigForTable, createDeckMapConfigForTable, createDeckMapDashboardPanelConfigForTable, createDeckMapPointTransformSql, findDeckMapLongitudeLatitudeColumns, findGeometryColumn, findLongitudeLatitudeColumns, normalizeDeckMapFillColor, normalizeDeckMapPointConfig, quoteDeckMapSqlIdentifier, quoteDeckMapSqlTableReference, regenerateMapConfigForTable, } from './mapConfigUtils';
+export { getFirstDatasetSourceTableName, hasSqlOnlyDatasetSource, } from './datasetSourceUtils';
+export { DeckMapResourceConfigParameter, DeckMapResourceToolParameters, } from './mapAiConfig';
+export { DeckMapResourceConfigError, assertDeckMapResourceConfig, getDeckMapResourceAiInstructions, getDeckMapResourceConfigIssues, mergeDeckMapResourceConfigPatch, } from './mapResourceAuthoring';
+export { createOrUpdateDeckMapResource, } from './createOrUpdateDeckMapResource';
+export { DeckMapResourceSchema, DeckMapsSliceConfig, createDeckMapsSlice, useStoreWithDeckMaps, } from './DeckMapsSlice';
+export { DeckMapSurface, directDeckMapDataAdapter, } from './DeckMapSurface';
+export { DECK_MAP_BLOCK_DEFAULT_HEIGHT, DECK_MAP_BLOCK_DEFAULT_TITLE, DECK_MAP_BLOCK_TYPE, createDeckMapBlockDocumentCommandType, createDeckMapBlockDocumentType, } from './blockDocumentRegistration';
+export { DeckJsonMap } from './DeckJsonMap';
+export { DeckMapDefaultStylesProvider, resolveDeckMapStyle, useDeckMapDefaultStyles, } from './DeckMapDefaultStylesProvider';
+export { ColorScaleFunction, GeometryEncodingHint as DeckGeometryEncodingHint, DeckJsonMapLayerSpec, DeckJsonMapSpec, LayerBindingConfig, LayerBindingProps, } from './DeckJsonMapSpec';
+export { createDeckJsonConfiguration } from './json/createDeckJsonConfiguration';
+export { prepareDeckDataset } from './prepare/prepareDeckDataset';
+export { isArrowTableDatasetInput, isSqlDatasetInput, isTableDatasetInput, } from './types';
+export { DECK_TABLE_DATASET_SOURCE_RELATION, createDeckTableDatasetSql, } from './datasets/tableDatasetSql';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAC,gBAAgB,EAAC,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAC,8BAA8B,EAAC,MAAM,kCAAkC,CAAC;AAChF,OAAO,EAAC,oBAAoB,EAAC,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,oBAAoB,GAErB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,oBAAoB,EACpB,0BAA0B,GAE3B,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,iCAAiC,EACjC,gCAAgC,EAChC,6BAA6B,EAC7B,kCAAkC,EAClC,oCAAoC,GACrC,MAAM,aAAa,CAAC;AACrB,OAAO,EAAC,oBAAoB,EAAyB,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EACL,oCAAoC,EACpC,2BAA2B,EAC3B,yCAAyC,EACzC,8BAA8B,EAC9B,mCAAmC,EACnC,kBAAkB,EAClB,4BAA4B,EAC5B,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,EACzB,6BAA6B,EAC7B,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC;AAM1B,OAAO,EACL,8BAA8B,EAC9B,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,8BAA8B,EAC9B,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,gCAAgC,EAChC,8BAA8B,EAC9B,+BAA+B,GAIhC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,6BAA6B,GAI9B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAOzB,OAAO,EACL,cAAc,EACd,wBAAwB,GAGzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC5B,mBAAmB,EACnB,qCAAqC,EACrC,8BAA8B,GAE/B,MAAM,6BAA6B,CAAC;AAerC,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAC1C,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,EACnB,uBAAuB,GAGxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,kBAAkB,EAClB,oBAAoB,IAAI,wBAAwB,EAChD,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAC,2BAA2B,EAAC,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAC,kBAAkB,EAAC,MAAM,8BAA8B,CAAC;AAUhE,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,kCAAkC,EAClC,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC","sourcesContent":["/**\n * {@include ../README.md}\n * @packageDocumentation\n */\n\nexport {ColorScaleLegend} from '@sqlrooms/color-scales';\nexport {createDeckJsonSpecFromDatasets} from './createDeckJsonSpecFromDatasets';\nexport {DeckMapBlockSettings} from './BlockMapSettings';\nexport {\n  DeckMapSettingsPanel,\n  type DeckMapSettingsPanelProps,\n} from './MapSettings';\nexport {\n  DeckMapBlockRenderer,\n  ensureDeckMapResourceState,\n  type DeckMapBlockRendererProps,\n} from './block';\nexport {\n  asDeckJsonMapConfig,\n  createEmptyDeckMapConfig,\n  createDeckMapDashboardPanelConfig,\n  DEFAULT_DECK_MAP_MAX_DATA_POINTS,\n  DECK_MAP_DASHBOARD_PANEL_TYPE,\n  isDeckMapDashboardSqlDatasetSource,\n  isDeckMapDashboardTableDatasetSource,\n} from './mapConfig';\nexport {getDeckMapDataPolicy, type DeckMapDataPolicy} from './mapDataPolicy';\nexport {\n  createDeckMapDashboardConfigForTable,\n  createDeckMapConfigForTable,\n  createDeckMapDashboardPanelConfigForTable,\n  createDeckMapPointTransformSql,\n  findDeckMapLongitudeLatitudeColumns,\n  findGeometryColumn,\n  findLongitudeLatitudeColumns,\n  normalizeDeckMapFillColor,\n  normalizeDeckMapPointConfig,\n  quoteDeckMapSqlIdentifier,\n  quoteDeckMapSqlTableReference,\n  regenerateMapConfigForTable,\n} from './mapConfigUtils';\nexport type {\n  DeckMapConfigColumn,\n  DeckMapFillColor,\n  DeckMapTableReference,\n} from './mapConfigUtils';\nexport {\n  getFirstDatasetSourceTableName,\n  hasSqlOnlyDatasetSource,\n} from './datasetSourceUtils';\nexport type {DeckMapDatasetSourceConfig} from './datasetSourceUtils';\nexport {\n  DeckMapResourceConfigParameter,\n  DeckMapResourceToolParameters,\n} from './mapAiConfig';\nexport {\n  DeckMapResourceConfigError,\n  assertDeckMapResourceConfig,\n  getDeckMapResourceAiInstructions,\n  getDeckMapResourceConfigIssues,\n  mergeDeckMapResourceConfigPatch,\n  type DeckMapResourceConfigMergeOptions,\n  type DeckMapResourceConfigIssue,\n  type DeckMapResourceConfigValidationOptions,\n} from './mapResourceAuthoring';\nexport {\n  createOrUpdateDeckMapResource,\n  type CreateOrUpdateDeckMapResourceHost,\n  type CreateOrUpdateDeckMapResourceParams,\n  type CreateOrUpdateDeckMapResourceResult,\n} from './createOrUpdateDeckMapResource';\nexport {\n  DeckMapResourceSchema,\n  DeckMapsSliceConfig,\n  createDeckMapsSlice,\n  useStoreWithDeckMaps,\n} from './DeckMapsSlice';\nexport type {\n  DeckMapResource,\n  DeckMapRuntimeIssue,\n  DeckMapRuntimeIssueReporter,\n  DeckMapsSliceState,\n} from './DeckMapsSlice';\nexport {\n  DeckMapSurface,\n  directDeckMapDataAdapter,\n  type DeckMapDataAdapter,\n  type DeckMapSurfaceProps,\n} from './DeckMapSurface';\nexport {\n  DECK_MAP_BLOCK_DEFAULT_HEIGHT,\n  DECK_MAP_BLOCK_DEFAULT_TITLE,\n  DECK_MAP_BLOCK_TYPE,\n  createDeckMapBlockDocumentCommandType,\n  createDeckMapBlockDocumentType,\n  type DeckMapBlockDocumentRegistrationOptions,\n} from './blockDocumentRegistration';\nexport type {\n  DeckMapConfigMode,\n  DeckMapDashboardFitToDataConfig,\n  CreateDeckMapDashboardPanelConfigOptions,\n  DeckMapDashboardDatasetConfig,\n  DeckMapDataPolicyOverride,\n  DeckMapDashboardInteractionConfig,\n  DeckMapDashboardPanelConfig,\n  DeckMapConfig,\n  DeckMapDatasetConfig,\n  DeckMapDatasetSource,\n  DeckMapFitToDataConfig,\n  DeckMapInteractionConfig,\n} from './mapConfig';\nexport {DeckJsonMap} from './DeckJsonMap';\nexport {\n  DeckMapDefaultStylesProvider,\n  resolveDeckMapStyle,\n  useDeckMapDefaultStyles,\n  type DeckMapDefaultStyles,\n  type DeckMapStyle,\n} from './DeckMapDefaultStylesProvider';\nexport {\n  ColorScaleFunction,\n  GeometryEncodingHint as DeckGeometryEncodingHint,\n  DeckJsonMapLayerSpec,\n  DeckJsonMapSpec,\n  LayerBindingConfig,\n  LayerBindingProps,\n} from './DeckJsonMapSpec';\nexport {createDeckJsonConfiguration} from './json/createDeckJsonConfiguration';\nexport {prepareDeckDataset} from './prepare/prepareDeckDataset';\n\nexport type {ColorLegendConfig, ColorScaleConfig} from '@sqlrooms/color-scales';\nexport type {\n  GeometryEncodingHint,\n  PreparedDeckDataset,\n  PreparedGeoArrowLayerData,\n  ResolvedGeometryColumn,\n  ResolvedGeometryEncoding,\n} from './prepare/types';\nexport {\n  isArrowTableDatasetInput,\n  isSqlDatasetInput,\n  isTableDatasetInput,\n} from './types';\nexport {\n  DECK_TABLE_DATASET_SOURCE_RELATION,\n  createDeckTableDatasetSql,\n} from './datasets/tableDatasetSql';\nexport type {\n  CreateDeckJsonSpecFromDatasetsOptions,\n  DeckArrowTableDatasetInput,\n  DeckAutoLayerType,\n  DeckDatasetInput,\n  DeckJsonMapHandle,\n  DeckJsonMapProps,\n  DeckJsonSpecDatasetHint,\n  DeckSqlDatasetInput,\n  DeckTableDatasetInput,\n  DeckTable,\n  PreparedDeckDatasetState,\n} from './types';\n"]}

package/dist/json/aggregateWaypoints.d.ts

@@ -0,0 +1,14 @@
+import * as arrow from 'apache-arrow';
+/**
+ * Auto-aggregates per-waypoint rows into LineString vectors for PathLayer.
+ * Detects group-by ID and order columns by naming patterns, groups rows,
+ * and builds a GeoArrow List<FixedSizeList<2, Float64>> linestring vector.
+ *
+ * Also builds a timestamps list column if a timestamp-like column is found,
+ * suitable for GeoArrowTripsLayer.
+ */
+export declare function tryAggregateWaypointsToLineStrings(table: arrow.Table): {
+    table: arrow.Table;
+    geometryVector: arrow.Vector;
+} | null;
+//# sourceMappingURL=aggregateWaypoints.d.ts.map