@sqlrooms/deck 0.29.0-rc.11 → 0.29.0-rc.13

package/dist/json/scaleFunction.js.map

@@ -1 +1 @@
-{"version":3,"file":"scaleFunction.js","sourceRoot":"","sources":["../../src/json/scaleFunction.ts"],"names":[],"mappings":"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","sourcesContent":["import type * as arrow from 'apache-arrow';\nimport {isBindableGeoArrowFieldIdentifier} from './compileGeoArrowAccessor';\n\nconst SQLROOMS_SCALE_MARKER = Symbol.for('@sqlrooms/deck/sqlrooms-scale');\n\nexport type LinearScaleConfig = {\n  field: string;\n  type?: 'linear';\n  domain?: 'auto' | [number, number];\n  /** When set, map domain → range. When omitted, use raw field minus domain min. */\n  range?: [number, number];\n};\n\nexport type ScaleMarker = LinearScaleConfig & {\n  [SQLROOMS_SCALE_MARKER]: true;\n};\n\n/** Marker returned by the Deck JSON `scale` function before table-aware compile. */\nexport function createScaleMarker(\n  props: Record<string, unknown>,\n): ScaleMarker | undefined {\n  const field = typeof props.field === 'string' ? props.field.trim() : '';\n  if (!field) return undefined;\n\n  const domain =\n    props.domain === 'auto'\n      ? 'auto'\n      : Array.isArray(props.domain) &&\n          props.domain.length === 2 &&\n          typeof props.domain[0] === 'number' &&\n          typeof props.domain[1] === 'number'\n        ? ([props.domain[0], props.domain[1]] as [number, number])\n        : 'auto';\n\n  const range =\n    Array.isArray(props.range) &&\n    props.range.length === 2 &&\n    typeof props.range[0] === 'number' &&\n    typeof props.range[1] === 'number'\n      ? ([props.range[0], props.range[1]] as [number, number])\n      : undefined;\n\n  return {\n    [SQLROOMS_SCALE_MARKER]: true,\n    field,\n    type: 'linear',\n    domain,\n    ...(range ? {range} : {}),\n  };\n}\n\nexport function isScaleMarker(value: unknown): value is ScaleMarker {\n  return Boolean(\n    value &&\n    typeof value === 'object' &&\n    (value as {[SQLROOMS_SCALE_MARKER]?: boolean})[SQLROOMS_SCALE_MARKER],\n  );\n}\n\nfunction readNumericDomain(vector: arrow.Vector): [number, number] | null {\n  let min = Infinity;\n  let max = -Infinity;\n  for (let i = 0; i < vector.length; i++) {\n    // Arrow/SQL NULL must not become 0 via Number(null).\n    if (typeof vector.isValid === 'function' && !vector.isValid(i)) {\n      continue;\n    }\n    const raw = vector.get(i);\n    if (raw == null) continue;\n    const v = Number(raw);\n    if (!Number.isFinite(v)) continue;\n    if (v < min) min = v;\n    if (v > max) max = v;\n  }\n  if (!Number.isFinite(min) || !Number.isFinite(max)) return null;\n  return [min, max];\n}\n\n/**\n * Linear scale `@@=` expression. Non-identifier fields need\n * {@link compileLinearScaleAccessor}.\n */\nexport function compileLinearScaleExpression(\n  table: arrow.Table,\n  scale: LinearScaleConfig,\n): string | undefined {\n  const field = scale.field.trim();\n  if (!field || !isBindableGeoArrowFieldIdentifier(field)) return undefined;\n\n  const vector = table.getChild(field);\n  if (!vector) return undefined;\n\n  const domain =\n    scale.domain === 'auto' || scale.domain === undefined\n      ? readNumericDomain(vector)\n      : scale.domain;\n  if (!domain) return undefined;\n\n  const [d0, d1] = domain;\n\n  if (!scale.range) {\n    if (d0 === 0) return `@@=${field}`;\n    return `@@=Math.max(0, ${field} - ${d0})`;\n  }\n\n  const [r0, r1] = scale.range;\n  const span = d1 - d0;\n  if (span === 0) {\n    return `@@=${r0}`;\n  }\n\n  const lo = Math.min(r0, r1);\n  const hi = Math.max(r0, r1);\n  // Clamp after linear map (bigint coercion lives in compileGeoArrowAccessor).\n  return `@@=Math.max(${lo}, Math.min(${hi}, ${r0} + (${field} - ${d0}) / ${span} * ${r1 - r0}))`;\n}\n\n/** Elevation accessor for any Arrow column name (incl. non-identifiers). */\nexport function compileLinearScaleAccessor(\n  table: arrow.Table,\n  scale: LinearScaleConfig,\n):\n  | ((info: {index: number; data: {data: unknown}; target: number[]}) => number)\n  | undefined {\n  const field = scale.field.trim();\n  if (!field) return undefined;\n\n  const vector = table.getChild(field);\n  if (!vector) return undefined;\n\n  const domain =\n    scale.domain === 'auto' || scale.domain === undefined\n      ? readNumericDomain(vector)\n      : scale.domain;\n  if (!domain) return undefined;\n\n  const [d0, d1] = domain;\n  const range = scale.range;\n\n  return ({index, data}) => {\n    const batch = data.data as arrow.Table | arrow.RecordBatch;\n    const child = batch.getChild?.(field) ?? vector;\n    const raw = child?.get(index);\n    if (raw == null) return 0;\n    const v = Number(raw);\n    if (!Number.isFinite(v)) return 0;\n\n    if (!range) {\n      return Math.max(0, v - d0);\n    }\n\n    const [r0, r1] = range;\n    const span = d1 - d0;\n    if (span === 0) return r0;\n    const lo = Math.min(r0, r1);\n    const hi = Math.max(r0, r1);\n    return Math.max(lo, Math.min(hi, r0 + ((v - d0) / span) * (r1 - r0)));\n  };\n}\n"]}
+{"version":3,"file":"scaleFunction.js","sourceRoot":"","sources":["../../src/json/scaleFunction.ts"],"names":[],"mappings":"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","sourcesContent":["import type * as arrow from 'apache-arrow';\nimport {isBindableGeoArrowFieldIdentifier} from './compileGeoArrowAccessor';\n\nconst SQLROOMS_SCALE_MARKER = Symbol.for('@sqlrooms/deck/sqlrooms-scale');\n\nexport type LinearScaleConfig = {\n  field: string;\n  type?: 'linear';\n  domain?: 'auto' | [number, number];\n  /** When set, map domain → range. When omitted, use raw field minus domain min. */\n  range?: [number, number];\n};\n\nexport type ScaleMarker = LinearScaleConfig & {\n  [SQLROOMS_SCALE_MARKER]: true;\n};\n\n/** Marker returned by the Deck JSON `scale` function before table-aware compile. */\nexport function createScaleMarker(\n  props: Record<string, unknown>,\n): ScaleMarker | undefined {\n  const field = typeof props.field === 'string' ? props.field.trim() : '';\n  if (!field) return undefined;\n\n  const domain =\n    props.domain === 'auto'\n      ? 'auto'\n      : Array.isArray(props.domain) &&\n          props.domain.length === 2 &&\n          typeof props.domain[0] === 'number' &&\n          typeof props.domain[1] === 'number'\n        ? ([props.domain[0], props.domain[1]] as [number, number])\n        : 'auto';\n\n  const range =\n    Array.isArray(props.range) &&\n    props.range.length === 2 &&\n    typeof props.range[0] === 'number' &&\n    typeof props.range[1] === 'number'\n      ? ([props.range[0], props.range[1]] as [number, number])\n      : undefined;\n\n  return {\n    [SQLROOMS_SCALE_MARKER]: true,\n    field,\n    type: 'linear',\n    domain,\n    ...(range ? {range} : {}),\n  };\n}\n\nexport function isScaleMarker(value: unknown): value is ScaleMarker {\n  return Boolean(\n    value &&\n    typeof value === 'object' &&\n    (value as {[SQLROOMS_SCALE_MARKER]?: boolean})[SQLROOMS_SCALE_MARKER],\n  );\n}\n\nfunction readNumericDomain(vector: arrow.Vector): [number, number] | null {\n  let min = Infinity;\n  let max = -Infinity;\n  for (let i = 0; i < vector.length; i++) {\n    // Arrow/SQL NULL must not become 0 via Number(null).\n    if (typeof vector.isValid === 'function' && !vector.isValid(i)) {\n      continue;\n    }\n    const raw = vector.get(i);\n    if (raw == null) continue;\n    const v = Number(raw);\n    if (!Number.isFinite(v)) continue;\n    if (v < min) min = v;\n    if (v > max) max = v;\n  }\n  if (!Number.isFinite(min) || !Number.isFinite(max)) return null;\n  return [min, max];\n}\n\n/**\n * Linear scale `@@=` expression. Non-identifier fields need\n * {@link compileLinearScaleAccessor}.\n */\nexport function compileLinearScaleExpression(\n  table: arrow.Table,\n  scale: LinearScaleConfig,\n): string | undefined {\n  const field = scale.field.trim();\n  if (!field || !isBindableGeoArrowFieldIdentifier(field)) return undefined;\n\n  const vector = table.getChild(field);\n  if (!vector) return undefined;\n\n  const domain =\n    scale.domain === 'auto' || scale.domain === undefined\n      ? readNumericDomain(vector)\n      : scale.domain;\n  if (!domain) return undefined;\n\n  const [d0, d1] = domain;\n\n  if (!scale.range) {\n    if (d0 === 0) return `@@=${field}`;\n    return `@@=Math.max(0, ${field} - ${d0})`;\n  }\n\n  const [r0, r1] = scale.range;\n  const span = d1 - d0;\n  if (span === 0) {\n    return `@@=${r0}`;\n  }\n\n  const lo = Math.min(r0, r1);\n  const hi = Math.max(r0, r1);\n  // Clamp after linear map (bigint coercion lives in compileGeoArrowAccessor).\n  return `@@=Math.max(${lo}, Math.min(${hi}, ${r0} + (${field} - ${d0}) / ${span} * ${r1 - r0}))`;\n}\n\nfunction readLinearScaleRawValue(\n  value: unknown,\n  field: string,\n  vector: arrow.Vector,\n): unknown {\n  if (!value || typeof value !== 'object') return undefined;\n\n  const object = value as {\n    index?: unknown;\n    data?: {data?: {getChild?: (name: string) => arrow.Vector | null}};\n    properties?: Record<string, unknown>;\n  };\n\n  if (typeof object.index === 'number') {\n    const batch = object.data?.data;\n    if (batch?.getChild) {\n      return batch.getChild(field)?.get(object.index);\n    }\n    if (batch) {\n      // Batch-local index (GeoArrow) without this field — do not fall back to\n      // the table-level vector.\n      return undefined;\n    }\n    return vector.get(object.index);\n  }\n\n  const sources = [object.properties, object as Record<string, unknown>];\n  for (const source of sources) {\n    if (source && typeof source === 'object' && field in source) {\n      return source[field];\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Elevation accessor for any Arrow column name (incl. non-identifiers).\n * Reads GeoArrow `{index, data}` callbacks or GeoJSON `{properties}` features.\n */\nexport function compileLinearScaleAccessor(\n  table: arrow.Table,\n  scale: LinearScaleConfig,\n): ((value: unknown) => number) | undefined {\n  const field = scale.field.trim();\n  if (!field) return undefined;\n\n  const vector = table.getChild(field);\n  if (!vector) return undefined;\n\n  const domain =\n    scale.domain === 'auto' || scale.domain === undefined\n      ? readNumericDomain(vector)\n      : scale.domain;\n  if (!domain) return undefined;\n\n  const [d0, d1] = domain;\n  const range = scale.range;\n\n  return (value) => {\n    const raw = readLinearScaleRawValue(value, field, vector);\n    if (raw == null) return 0;\n    const v = Number(raw);\n    if (!Number.isFinite(v)) return 0;\n\n    if (!range) {\n      return Math.max(0, v - d0);\n    }\n\n    const [r0, r1] = range;\n    const span = d1 - d0;\n    if (span === 0) return r0;\n    const lo = Math.min(r0, r1);\n    const hi = Math.max(r0, r1);\n    return Math.max(lo, Math.min(hi, r0 + ((v - d0) / span) * (r1 - r0)));\n  };\n}\n"]}

package/dist/mapAiConfig.d.ts

@@ -105,6 +105,12 @@ export declare const DeckMapResourceToolParameters: z.ZodObject<{
         }, z.core.$loose>>;
         settingsOpen: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$loose>;
+    pointBinding: z.ZodOptional<z.ZodObject<{
+        dataset: z.ZodString;
+        longitudeColumn: z.ZodString;
+        latitudeColumn: z.ZodString;
+        geometryColumn: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     tableName: z.ZodOptional<z.ZodString>;
     replaceLayers: z.ZodOptional<z.ZodBoolean>;
     replaceDatasets: z.ZodOptional<z.ZodBoolean>;

package/dist/mapAiConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapAiConfig.d.ts","sourceRoot":"","sources":["../src/mapAiConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAwCtB,kFAAkF;AAClF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqBN,CAAC;AAEtC,mFAAmF;AACnF,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiBxC,CAAC"}
+{"version":3,"file":"mapAiConfig.d.ts","sourceRoot":"","sources":["../src/mapAiConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAgDtB,kFAAkF;AAClF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqBN,CAAC;AAEtC,mFAAmF;AACnF,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoBxC,CAAC"}

package/dist/mapAiConfig.js

@@ -31,6 +31,12 @@ const DeckMapFitToDataConfig = z.looseObject({
     padding: z.number().optional(),
     maxZoom: z.number().optional(),
 });
+const DeckMapPointBindingParameter = z.object({
+    dataset: z.string().trim().min(1),
+    longitudeColumn: z.string().trim().min(1),
+    latitudeColumn: z.string().trim().min(1),
+    geometryColumn: z.string().trim().min(1).optional(),
+});
 /** Validates the portable Deck map config accepted from commands and AI tools. */
 export const DeckMapResourceConfigParameter = z.looseObject({
     spec: z.union([z.string(), z.record(z.string(), z.unknown())]),
@@ -56,6 +62,7 @@ export const DeckMapResourceConfigParameter = z.looseObject({
 export const DeckMapResourceToolParameters = z.object({
     title: z.string().optional().default('Map'),
     config: DeckMapResourceConfigParameter,
+    pointBinding: DeckMapPointBindingParameter.optional().describe('Structured point provenance for a table-backed dataset. Prefer this over authoring transformSql when longitude and latitude columns should become WKB point geometry.'),
     tableName: z.string().optional(),
     replaceLayers: z
         .boolean()

package/dist/mapAiConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"mapAiConfig.js","sourceRoot":"","sources":["../src/mapAiConfig.ts"],"names":[],"mappings":"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","sourcesContent":["import {z} from 'zod';\nimport type {DeckMapConfig} from './mapConfig';\n\nconst DeckMapDatasetSource = z.union([\n  z.looseObject({\n    sqlQuery: z.string(),\n  }),\n  z.looseObject({\n    tableName: z.string(),\n    transformSql: z.string().optional(),\n  }),\n]);\nconst DeckMapDatasetConfig = z.looseObject({\n  source: DeckMapDatasetSource.optional().describe(\n    'Dataset source. Required for new maps; may be omitted only by a sparse update patch that retains an existing source.',\n  ),\n  geometryColumn: z.string().optional(),\n  geometryEncodingHint: z.enum(['geoarrow', 'wkb', 'wkt']).optional(),\n});\n\nconst DeckMapInteractionConfig = z.looseObject({\n  type: z.literal('point-radius-brush'),\n  dataset: z.string(),\n  longitudeColumn: z.string(),\n  latitudeColumn: z.string(),\n  radiusMeters: z.number().optional(),\n  event: z.enum(['hover', 'click']).optional(),\n});\n\nconst DeckMapFitToDataConfig = z.looseObject({\n  dataset: z.string(),\n  longitudeColumn: z.string().optional(),\n  latitudeColumn: z.string().optional(),\n  geometryColumn: z.string().optional(),\n  geometryColumns: z.array(z.string()).optional(),\n  h3Column: z.string().optional(),\n  padding: z.number().optional(),\n  maxZoom: z.number().optional(),\n});\n\n/** Validates the portable Deck map config accepted from commands and AI tools. */\nexport const DeckMapResourceConfigParameter = z.looseObject({\n  spec: z.union([z.string(), z.record(z.string(), z.unknown())]),\n  datasets: z\n    .record(z.string(), DeckMapDatasetConfig)\n    .describe(\n      'Resource datasets keyed by id. Every dataset in a new map must define source.tableName or source.sqlQuery. For visual-only updates send an empty object {} so merge keeps the existing registry — do not omit this field.',\n    ),\n  configMode: z.enum(['basic', 'custom']).optional(),\n  mapStyle: z.string().optional(),\n  mapProps: z.record(z.string(), z.unknown()).optional(),\n  showLegends: z.boolean().optional(),\n  interaction: DeckMapInteractionConfig.optional(),\n  fitToData: DeckMapFitToDataConfig.optional(),\n  dataPolicy: z\n    .looseObject({\n      disabled: z.boolean().optional(),\n      maxRows: z.number().int().min(1).optional(),\n      reason: z.string().optional(),\n    })\n    .optional(),\n  settingsOpen: z.boolean().optional(),\n}) satisfies z.ZodType<DeckMapConfig>;\n\n/** Validates inputs for an AI or command invocation that writes a map resource. */\nexport const DeckMapResourceToolParameters = z.object({\n  title: z.string().optional().default('Map'),\n  config: DeckMapResourceConfigParameter,\n  tableName: z.string().optional(),\n  replaceLayers: z\n    .boolean()\n    .optional()\n    .describe(\n      'Set true when config.spec.layers is the complete desired list and omitted existing layers should be removed.',\n    ),\n  replaceDatasets: z\n    .boolean()\n    .optional()\n    .describe(\n      'Set true when config.datasets is the complete desired registry and omitted existing datasets should be removed.',\n    ),\n  reasoning: z.string(),\n});\n"]}
+{"version":3,"file":"mapAiConfig.js","sourceRoot":"","sources":["../src/mapAiConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAItB,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC;IACnC,CAAC,CAAC,WAAW,CAAC;QACZ,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;KACrB,CAAC;IACF,CAAC,CAAC,WAAW,CAAC;QACZ,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;QACrB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACpC,CAAC;CACH,CAAC,CAAC;AACH,MAAM,oBAAoB,GAAG,CAAC,CAAC,WAAW,CAAC;IACzC,MAAM,EAAE,oBAAoB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC9C,sHAAsH,CACvH;IACD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,oBAAoB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE;CACpE,CAAC,CAAC;AAEH,MAAM,wBAAwB,GAAG,CAAC,CAAC,WAAW,CAAC;IAC7C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAC;AAEH,MAAM,sBAAsB,GAAG,CAAC,CAAC,WAAW,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC/C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEH,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACpD,CAA0C,CAAC;AAE5C,kFAAkF;AAClF,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,WAAW,CAAC;IAC1D,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC9D,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,oBAAoB,CAAC;SACxC,QAAQ,CACP,2NAA2N,CAC5N;IACH,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtD,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACnC,WAAW,EAAE,wBAAwB,CAAC,QAAQ,EAAE;IAChD,SAAS,EAAE,sBAAsB,CAAC,QAAQ,EAAE;IAC5C,UAAU,EAAE,CAAC;SACV,WAAW,CAAC;QACX,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC3C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC9B,CAAC;SACD,QAAQ,EAAE;IACb,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAoC,CAAC;AAEtC,mFAAmF;AACnF,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAC3C,MAAM,EAAE,8BAA8B;IACtC,YAAY,EAAE,4BAA4B,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC5D,uKAAuK,CACxK;IACD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,aAAa,EAAE,CAAC;SACb,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,8GAA8G,CAC/G;IACH,eAAe,EAAE,CAAC;SACf,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,iHAAiH,CAClH;IACH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC","sourcesContent":["import {z} from 'zod';\nimport type {DeckMapConfig} from './mapConfig';\nimport type {DeckMapPointBinding} from './mapConfigUtils';\n\nconst DeckMapDatasetSource = z.union([\n  z.looseObject({\n    sqlQuery: z.string(),\n  }),\n  z.looseObject({\n    tableName: z.string(),\n    transformSql: z.string().optional(),\n  }),\n]);\nconst DeckMapDatasetConfig = z.looseObject({\n  source: DeckMapDatasetSource.optional().describe(\n    'Dataset source. Required for new maps; may be omitted only by a sparse update patch that retains an existing source.',\n  ),\n  geometryColumn: z.string().optional(),\n  geometryEncodingHint: z.enum(['geoarrow', 'wkb', 'wkt']).optional(),\n});\n\nconst DeckMapInteractionConfig = z.looseObject({\n  type: z.literal('point-radius-brush'),\n  dataset: z.string(),\n  longitudeColumn: z.string(),\n  latitudeColumn: z.string(),\n  radiusMeters: z.number().optional(),\n  event: z.enum(['hover', 'click']).optional(),\n});\n\nconst DeckMapFitToDataConfig = z.looseObject({\n  dataset: z.string(),\n  longitudeColumn: z.string().optional(),\n  latitudeColumn: z.string().optional(),\n  geometryColumn: z.string().optional(),\n  geometryColumns: z.array(z.string()).optional(),\n  h3Column: z.string().optional(),\n  padding: z.number().optional(),\n  maxZoom: z.number().optional(),\n});\n\nconst DeckMapPointBindingParameter = z.object({\n  dataset: z.string().trim().min(1),\n  longitudeColumn: z.string().trim().min(1),\n  latitudeColumn: z.string().trim().min(1),\n  geometryColumn: z.string().trim().min(1).optional(),\n}) satisfies z.ZodType<DeckMapPointBinding>;\n\n/** Validates the portable Deck map config accepted from commands and AI tools. */\nexport const DeckMapResourceConfigParameter = z.looseObject({\n  spec: z.union([z.string(), z.record(z.string(), z.unknown())]),\n  datasets: z\n    .record(z.string(), DeckMapDatasetConfig)\n    .describe(\n      'Resource datasets keyed by id. Every dataset in a new map must define source.tableName or source.sqlQuery. For visual-only updates send an empty object {} so merge keeps the existing registry — do not omit this field.',\n    ),\n  configMode: z.enum(['basic', 'custom']).optional(),\n  mapStyle: z.string().optional(),\n  mapProps: z.record(z.string(), z.unknown()).optional(),\n  showLegends: z.boolean().optional(),\n  interaction: DeckMapInteractionConfig.optional(),\n  fitToData: DeckMapFitToDataConfig.optional(),\n  dataPolicy: z\n    .looseObject({\n      disabled: z.boolean().optional(),\n      maxRows: z.number().int().min(1).optional(),\n      reason: z.string().optional(),\n    })\n    .optional(),\n  settingsOpen: z.boolean().optional(),\n}) satisfies z.ZodType<DeckMapConfig>;\n\n/** Validates inputs for an AI or command invocation that writes a map resource. */\nexport const DeckMapResourceToolParameters = z.object({\n  title: z.string().optional().default('Map'),\n  config: DeckMapResourceConfigParameter,\n  pointBinding: DeckMapPointBindingParameter.optional().describe(\n    'Structured point provenance for a table-backed dataset. Prefer this over authoring transformSql when longitude and latitude columns should become WKB point geometry.',\n  ),\n  tableName: z.string().optional(),\n  replaceLayers: z\n    .boolean()\n    .optional()\n    .describe(\n      'Set true when config.spec.layers is the complete desired list and omitted existing layers should be removed.',\n    ),\n  replaceDatasets: z\n    .boolean()\n    .optional()\n    .describe(\n      'Set true when config.datasets is the complete desired registry and omitted existing datasets should be removed.',\n    ),\n  reasoning: z.string(),\n});\n"]}

package/dist/mapAiSharedInstructions.d.ts

@@ -1,3 +1,3 @@
-/** Shared Deck map AI rules for dashboard and worksheet prompts. */
+/** Shared Deck map AI rules for dashboard and document prompts. */
 export declare function getDeckMapSharedAiContractRules(): string;
 //# sourceMappingURL=mapAiSharedInstructions.d.ts.map

package/dist/mapAiSharedInstructions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapAiSharedInstructions.d.ts","sourceRoot":"","sources":["../src/mapAiSharedInstructions.ts"],"names":[],"mappings":"AAEA,oEAAoE;AACpE,wBAAgB,+BAA+B,IAAI,MAAM,CAYxD"}
+{"version":3,"file":"mapAiSharedInstructions.d.ts","sourceRoot":"","sources":["../src/mapAiSharedInstructions.ts"],"names":[],"mappings":"AAEA,mEAAmE;AACnE,wBAAgB,+BAA+B,IAAI,MAAM,CAaxD"}

package/dist/mapAiSharedInstructions.js

@@ -1,13 +1,14 @@
 import { DECK_TABLE_DATASET_SOURCE_RELATION } from './datasets/tableDatasetSql';
-/** Shared Deck map AI rules for dashboard and worksheet prompts. */
+/** Shared Deck map AI rules for dashboard and document prompts. */
 export function getDeckMapSharedAiContractRules() {
     const src = DECK_TABLE_DATASET_SOURCE_RELATION;
-    return `Shared Deck map authoring rules (dashboard and worksheet):
-- Scatterplot/Heatmap/Column require Point positions — do not bind them to Polygon/MultiPolygon geom. Prefer GeoArrowPolygonLayer / GeoArrowSolidPolygonLayer for Polygon, GeoJsonLayer for WKB/WKT MultiPolygon, or transformSql with ST_AsWKB(ST_Centroid(geom)) / ST_PointOnSurface(geom) when the user wants points (e.g. SELECT * EXCLUDE (geom), ST_AsWKB(ST_Centroid(geom)) AS geom FROM ${src}). The runtime will not invent centroids.
+    return `Shared Deck map authoring rules (dashboard and document):
+- Scatterplot/Heatmap/Column require Point positions — do not bind them to Polygon/MultiPolygon geom. Prefer GeoArrowPolygonLayer for Polygon, GeoJsonLayer for WKB/WKT MultiPolygon, or transformSql with ST_AsWKB(ST_Centroid(geom)) / ST_PointOnSurface(geom) when the user wants points (e.g. SELECT * EXCLUDE (geom), ST_AsWKB(ST_Centroid(geom)) AS geom FROM ${src}). The runtime will not invent centroids.
 - Mixed Point/LineString/Polygon columns: use GeoJsonLayer. Typed GeoArrowPolygon/Path/Scatterplot layers need a uniform geometry type. To keep one class, filter with WHERE ST_GeometryType(geom) IN (...) then use the matching typed layer.
 - Never write SELECT *, ST_AsWKB(col) AS col — DuckDB keeps the original column and the WKB alias collides. Use SELECT * EXCLUDE (col), ST_AsWKB(...) AS col, or omit transformSql when geom already exists. Bare ST_Point(...) / table GEOMETRY columns are projected to WKB by the dataset pipeline; prefer explicit ST_AsWKB when practical.
 - GeoArrowHeatmapLayer: omit colorRange (UI scheme selector owns it) and omit getWeight (default uniform density). Do not bind getWeight to a column — basic mode has no weight-column control.
 - Never set mapStyle to a mapbox:// URL — MapLibre cannot load that scheme. Omit mapStyle for the host basemap, or use a token-free MapLibre https:// style URL.
+- Built-in mapStyle IDs are light and dark. New maps default to the app theme at creation; omit mapStyle on updates to preserve the saved selection. Never put tile API keys in map configs.
 - GeoArrowH3HexagonLayer: set getHexagon to "@@=h3_column" (or _sqlroomsBinding.hexagonColumn). When aggregating lon/lat, prefer h3_h3_to_string(h3_latlng_to_cell(lat, lon, res)) AS h3_cell (lat before lon).
 - GeoArrowArcLayer: bind WKB via _sqlroomsBinding.sourceGeometryColumn / targetGeometryColumn only (do not set getSourcePosition/getTargetPosition). Use ST_AsWKB(ST_Point(...)); set geometryEncodingHint to "wkb".
 - GeoArrowTripsLayer = animated path over time; GeoArrowArcLayer = static OD curve. Prefer TripsLayer for animated/trips/moving routes.

package/dist/mapAiSharedInstructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"mapAiSharedInstructions.js","sourceRoot":"","sources":["../src/mapAiSharedInstructions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,4BAA4B,CAAC;AAE9E,oEAAoE;AACpE,MAAM,UAAU,+BAA+B;IAC7C,MAAM,GAAG,GAAG,kCAAkC,CAAC;IAC/C,OAAO;kYACyX,GAAG;;;;;;;;qlBAQgN,CAAC;AACtlB,CAAC","sourcesContent":["import {DECK_TABLE_DATASET_SOURCE_RELATION} from './datasets/tableDatasetSql';\n\n/** Shared Deck map AI rules for dashboard and worksheet prompts. */\nexport function getDeckMapSharedAiContractRules(): string {\n  const src = DECK_TABLE_DATASET_SOURCE_RELATION;\n  return `Shared Deck map authoring rules (dashboard and worksheet):\n- Scatterplot/Heatmap/Column require Point positions — do not bind them to Polygon/MultiPolygon geom. Prefer GeoArrowPolygonLayer / GeoArrowSolidPolygonLayer for Polygon, GeoJsonLayer for WKB/WKT MultiPolygon, or transformSql with ST_AsWKB(ST_Centroid(geom)) / ST_PointOnSurface(geom) when the user wants points (e.g. SELECT * EXCLUDE (geom), ST_AsWKB(ST_Centroid(geom)) AS geom FROM ${src}). The runtime will not invent centroids.\n- Mixed Point/LineString/Polygon columns: use GeoJsonLayer. Typed GeoArrowPolygon/Path/Scatterplot layers need a uniform geometry type. To keep one class, filter with WHERE ST_GeometryType(geom) IN (...) then use the matching typed layer.\n- Never write SELECT *, ST_AsWKB(col) AS col — DuckDB keeps the original column and the WKB alias collides. Use SELECT * EXCLUDE (col), ST_AsWKB(...) AS col, or omit transformSql when geom already exists. Bare ST_Point(...) / table GEOMETRY columns are projected to WKB by the dataset pipeline; prefer explicit ST_AsWKB when practical.\n- GeoArrowHeatmapLayer: omit colorRange (UI scheme selector owns it) and omit getWeight (default uniform density). Do not bind getWeight to a column — basic mode has no weight-column control.\n- Never set mapStyle to a mapbox:// URL — MapLibre cannot load that scheme. Omit mapStyle for the host basemap, or use a token-free MapLibre https:// style URL.\n- GeoArrowH3HexagonLayer: set getHexagon to \"@@=h3_column\" (or _sqlroomsBinding.hexagonColumn). When aggregating lon/lat, prefer h3_h3_to_string(h3_latlng_to_cell(lat, lon, res)) AS h3_cell (lat before lon).\n- GeoArrowArcLayer: bind WKB via _sqlroomsBinding.sourceGeometryColumn / targetGeometryColumn only (do not set getSourcePosition/getTargetPosition). Use ST_AsWKB(ST_Point(...)); set geometryEncodingHint to \"wkb\".\n- GeoArrowTripsLayer = animated path over time; GeoArrowArcLayer = static OD curve. Prefer TripsLayer for animated/trips/moving routes.\n- COLOR SCALE FIELD VARIANCE: Before choosing a numeric colorScale field, confirm it has real range (min < max / not all zeros or a single constant). Prefer SUMMARIZE table_name or SELECT min(col), max(col), count(DISTINCT col) FROM ... when unsure. Do NOT color by a flat column unless the user explicitly asks for that column by name. If no varying column exists, use a flat fill color instead of colorScale. Categorical fields need more than one distinct non-null value to be useful. Geometry, lon/lat, H3 index, and opaque ID columns are not useful color fields unless the user asks for them.`;\n}\n"]}
+{"version":3,"file":"mapAiSharedInstructions.js","sourceRoot":"","sources":["../src/mapAiSharedInstructions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kCAAkC,EAAC,MAAM,4BAA4B,CAAC;AAE9E,mEAAmE;AACnE,MAAM,UAAU,+BAA+B;IAC7C,MAAM,GAAG,GAAG,kCAAkC,CAAC;IAC/C,OAAO;sWAC6V,GAAG;;;;;;;;;qlBAS4O,CAAC;AACtlB,CAAC","sourcesContent":["import {DECK_TABLE_DATASET_SOURCE_RELATION} from './datasets/tableDatasetSql';\n\n/** Shared Deck map AI rules for dashboard and document prompts. */\nexport function getDeckMapSharedAiContractRules(): string {\n  const src = DECK_TABLE_DATASET_SOURCE_RELATION;\n  return `Shared Deck map authoring rules (dashboard and document):\n- Scatterplot/Heatmap/Column require Point positions — do not bind them to Polygon/MultiPolygon geom. Prefer GeoArrowPolygonLayer for Polygon, GeoJsonLayer for WKB/WKT MultiPolygon, or transformSql with ST_AsWKB(ST_Centroid(geom)) / ST_PointOnSurface(geom) when the user wants points (e.g. SELECT * EXCLUDE (geom), ST_AsWKB(ST_Centroid(geom)) AS geom FROM ${src}). The runtime will not invent centroids.\n- Mixed Point/LineString/Polygon columns: use GeoJsonLayer. Typed GeoArrowPolygon/Path/Scatterplot layers need a uniform geometry type. To keep one class, filter with WHERE ST_GeometryType(geom) IN (...) then use the matching typed layer.\n- Never write SELECT *, ST_AsWKB(col) AS col — DuckDB keeps the original column and the WKB alias collides. Use SELECT * EXCLUDE (col), ST_AsWKB(...) AS col, or omit transformSql when geom already exists. Bare ST_Point(...) / table GEOMETRY columns are projected to WKB by the dataset pipeline; prefer explicit ST_AsWKB when practical.\n- GeoArrowHeatmapLayer: omit colorRange (UI scheme selector owns it) and omit getWeight (default uniform density). Do not bind getWeight to a column — basic mode has no weight-column control.\n- Never set mapStyle to a mapbox:// URL — MapLibre cannot load that scheme. Omit mapStyle for the host basemap, or use a token-free MapLibre https:// style URL.\n- Built-in mapStyle IDs are light and dark. New maps default to the app theme at creation; omit mapStyle on updates to preserve the saved selection. Never put tile API keys in map configs.\n- GeoArrowH3HexagonLayer: set getHexagon to \"@@=h3_column\" (or _sqlroomsBinding.hexagonColumn). When aggregating lon/lat, prefer h3_h3_to_string(h3_latlng_to_cell(lat, lon, res)) AS h3_cell (lat before lon).\n- GeoArrowArcLayer: bind WKB via _sqlroomsBinding.sourceGeometryColumn / targetGeometryColumn only (do not set getSourcePosition/getTargetPosition). Use ST_AsWKB(ST_Point(...)); set geometryEncodingHint to \"wkb\".\n- GeoArrowTripsLayer = animated path over time; GeoArrowArcLayer = static OD curve. Prefer TripsLayer for animated/trips/moving routes.\n- COLOR SCALE FIELD VARIANCE: Before choosing a numeric colorScale field, confirm it has real range (min < max / not all zeros or a single constant). Prefer SUMMARIZE table_name or SELECT min(col), max(col), count(DISTINCT col) FROM ... when unsure. Do NOT color by a flat column unless the user explicitly asks for that column by name. If no varying column exists, use a flat fill color instead of colorScale. Categorical fields need more than one distinct non-null value to be useful. Geometry, lon/lat, H3 index, and opaque ID columns are not useful color fields unless the user asks for them.`;\n}\n"]}

package/dist/mapConfig.d.ts

@@ -43,6 +43,7 @@ export type DeckMapConfig = {
     spec: DeckJsonMapProps['spec'];
     datasets: Record<string, DeckMapDatasetConfig>;
     configMode?: DeckMapConfigMode;
+    /** Built-in basemap ID (`light`/`dark`) or custom style URL. */
     mapStyle?: string;
     mapProps?: Record<string, unknown>;
     showLegends?: boolean;
@@ -51,9 +52,13 @@ export type DeckMapConfig = {
     dataPolicy?: DeckMapDataPolicyOverride;
     settingsOpen?: boolean;
 };
+/** Adds a creation-time basemap default while preserving explicit custom styles. */
+export declare function withDefaultDeckMapStyle(config: DeckMapConfig): DeckMapConfig;
+/** Retains a map's basemap on config replacement unless a new style is supplied. */
+export declare function withPreservedDeckMapStyle(config: DeckMapConfig, previousConfig: DeckMapConfig | null): DeckMapConfig;
 /** Creates the portable empty configuration used for a new Deck map. */
 export declare function createEmptyDeckMapConfig(): DeckMapConfig;
-/** Adapter-facing dashboard panel shape; worksheet resources never store it. */
+/** Adapter-facing dashboard panel shape; document resources never store it. */
 export type DeckMapDashboardPanelConfig = DeckMapConfig;
 export type DeckMapDashboardDatasetConfig = DeckMapDatasetConfig;
 export type DeckMapDashboardDatasetSource = DeckMapDatasetSource;

package/dist/mapConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapConfig.d.ts","sourceRoot":"","sources":["../src/mapConfig.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,SAAS,CAAC;AAEjB,eAAO,MAAM,6BAA6B,kBAAkB,CAAC;AAC7D,eAAO,MAAM,gCAAgC,SAAU,CAAC;AAExD,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAC5B,IAAI,CAAC,mBAAmB,EAAE,UAAU,CAAC,GACrC,IAAI,CAAC,qBAAqB,EAAE,WAAW,GAAG,cAAc,CAAC,CAAC;AAE9D,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,mBAAmB,EAAE,UAAU,CAAC,GAAG;IACzE,MAAM,CAAC,EAAE,oBAAoB,CAAC;CAC/B,CAAC;AAEF,0EAA0E;AAC1E,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,oBAAoB,GAAG,SAAS,GACvC,MAAM,IAAI,IAAI,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAEjD;AAED,uEAAuE;AACvE,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,oBAAoB,GAAG,SAAS,GACvC,MAAM,IAAI,IAAI,CAAC,qBAAqB,EAAE,WAAW,GAAG,cAAc,CAAC,CAErE;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEnD,oDAAoD;AACpD,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAC/C,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,wBAAwB,CAAC;IACvC,SAAS,CAAC,EAAE,sBAAsB,CAAC;IACnC,UAAU,CAAC,EAAE,yBAAyB,CAAC;IACvC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,wEAAwE;AACxE,wBAAgB,wBAAwB,IAAI,aAAa,CAQxD;AAED,gFAAgF;AAChF,MAAM,MAAM,2BAA2B,GAAG,aAAa,CAAC;AACxD,MAAM,MAAM,6BAA6B,GAAG,oBAAoB,CAAC;AACjE,MAAM,MAAM,6BAA6B,GAAG,oBAAoB,CAAC;AACjE,MAAM,MAAM,iCAAiC,GAAG,wBAAwB,CAAC;AACzE,MAAM,MAAM,+BAA+B,GAAG,sBAAsB,CAAC;AAErE,eAAO,MAAM,kCAAkC,kCAA4B,CAAC;AAC5E,eAAO,MAAM,oCAAoC,oCAA8B,CAAC;AAEhF,MAAM,MAAM,wCAAwC,GAAG,aAAa,GAAG;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,oEAAoE;AACpE,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,wCAAwC;;;;YAOD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EAExE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,aAAa,GAAG,IAAI,CAUtB"}
+{"version":3,"file":"mapConfig.d.ts","sourceRoot":"","sources":["../src/mapConfig.ts"],"names":[],"mappings":"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"}

package/dist/mapConfig.js

@@ -1,4 +1,5 @@
 import { createId } from '@paralleldrive/cuid2';
+import { getDefaultDeckMapStyle } from './mapStyles';
 export const DECK_MAP_DASHBOARD_PANEL_TYPE = 'deck-json-map';
 export const DEFAULT_DECK_MAP_MAX_DATA_POINTS = 100_000;
 /** Returns whether a map dataset source is a pinned literal SQL query. */
@@ -9,15 +10,39 @@ export function isDeckMapSqlDatasetSource(source) {
 export function isDeckMapTableDatasetSource(source) {
     return Boolean(source && 'tableName' in source);
 }
+/** Adds a creation-time basemap default while preserving explicit custom styles. */
+export function withDefaultDeckMapStyle(config) {
+    return config.mapStyle || config.mapProps?.mapStyle
+        ? config
+        : { ...config, mapStyle: getDefaultDeckMapStyle() };
+}
+/** Retains a map's basemap on config replacement unless a new style is supplied. */
+export function withPreservedDeckMapStyle(config, previousConfig) {
+    if (config.mapStyle || config.mapProps?.mapStyle)
+        return config;
+    if (previousConfig?.mapStyle) {
+        return { ...config, mapStyle: previousConfig.mapStyle };
+    }
+    if (previousConfig?.mapProps?.mapStyle) {
+        return {
+            ...config,
+            mapProps: {
+                ...config.mapProps,
+                mapStyle: previousConfig.mapProps.mapStyle,
+            },
+        };
+    }
+    return config;
+}
 /** Creates the portable empty configuration used for a new Deck map. */
 export function createEmptyDeckMapConfig() {
-    return {
+    return withDefaultDeckMapStyle({
         spec: {
             initialViewState: { longitude: 0, latitude: 20, zoom: 1.5 },
             layers: [],
         },
         datasets: {},
-    };
+    });
 }
 export const isDeckMapDashboardSqlDatasetSource = isDeckMapSqlDatasetSource;
 export const isDeckMapDashboardTableDatasetSource = isDeckMapTableDatasetSource;
@@ -28,7 +53,7 @@ export function createDeckMapDashboardPanelConfig(options) {
         id: createId(),
         type: DECK_MAP_DASHBOARD_PANEL_TYPE,
         title: title ?? 'Map',
-        config: JSON.parse(JSON.stringify(config)),
+        config: JSON.parse(JSON.stringify(withDefaultDeckMapStyle(config))),
     };
 }
 /**

package/dist/mapConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"mapConfig.js","sourceRoot":"","sources":["../src/mapConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,sBAAsB,CAAC;AAO9C,MAAM,CAAC,MAAM,6BAA6B,GAAG,eAAe,CAAC;AAC7D,MAAM,CAAC,MAAM,gCAAgC,GAAG,OAAO,CAAC;AAgBxD,0EAA0E;AAC1E,MAAM,UAAU,yBAAyB,CACvC,MAAwC;IAExC,OAAO,OAAO,CAAC,MAAM,IAAI,UAAU,IAAI,MAAM,CAAC,CAAC;AACjD,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,2BAA2B,CACzC,MAAwC;IAExC,OAAO,OAAO,CAAC,MAAM,IAAI,WAAW,IAAI,MAAM,CAAC,CAAC;AAClD,CAAC;AA2CD,wEAAwE;AACxE,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,IAAI,EAAE;YACJ,gBAAgB,EAAE,EAAC,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAC;YACzD,MAAM,EAAE,EAAE;SACX;QACD,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC;AASD,MAAM,CAAC,MAAM,kCAAkC,GAAG,yBAAyB,CAAC;AAC5E,MAAM,CAAC,MAAM,oCAAoC,GAAG,2BAA2B,CAAC;AAMhF,oEAAoE;AACpE,MAAM,UAAU,iCAAiC,CAC/C,OAAiD;IAEjD,MAAM,EAAC,KAAK,EAAE,GAAG,MAAM,EAAC,GAAG,OAAO,CAAC;IACnC,OAAO;QACL,EAAE,EAAE,QAAQ,EAAE;QACd,IAAI,EAAE,6BAA6B;QACnC,KAAK,EAAE,KAAK,IAAI,KAAK;QACrB,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAA4B;KACtE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAA+B;IAE/B,IACE,CAAC,MAAM,CAAC,IAAI;QACZ,CAAC,MAAM,CAAC,QAAQ;QAChB,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;QACnC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAC9B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAuB,CAAC;AACjC,CAAC","sourcesContent":["import {createId} from '@paralleldrive/cuid2';\nimport type {\n  DeckJsonMapProps,\n  DeckSqlDatasetInput,\n  DeckTableDatasetInput,\n} from './types';\n\nexport const DECK_MAP_DASHBOARD_PANEL_TYPE = 'deck-json-map';\nexport const DEFAULT_DECK_MAP_MAX_DATA_POINTS = 100_000;\n\nexport type DeckMapDataPolicyOverride = {\n  disabled?: boolean;\n  maxRows?: number;\n  reason?: string;\n};\n\nexport type DeckMapDatasetSource =\n  | Pick<DeckSqlDatasetInput, 'sqlQuery'>\n  | Pick<DeckTableDatasetInput, 'tableName' | 'transformSql'>;\n\nexport type DeckMapDatasetConfig = Omit<DeckSqlDatasetInput, 'sqlQuery'> & {\n  source?: DeckMapDatasetSource;\n};\n\n/** Returns whether a map dataset source is a pinned literal SQL query. */\nexport function isDeckMapSqlDatasetSource(\n  source: DeckMapDatasetSource | undefined,\n): source is Pick<DeckSqlDatasetInput, 'sqlQuery'> {\n  return Boolean(source && 'sqlQuery' in source);\n}\n\n/** Returns whether a map dataset source is backed by a named table. */\nexport function isDeckMapTableDatasetSource(\n  source: DeckMapDatasetSource | undefined,\n): source is Pick<DeckTableDatasetInput, 'tableName' | 'transformSql'> {\n  return Boolean(source && 'tableName' in source);\n}\n\nexport type DeckMapInteractionConfig = {\n  type: 'point-radius-brush';\n  dataset: string;\n  longitudeColumn: string;\n  latitudeColumn: string;\n  radiusMeters?: number;\n  event?: 'hover' | 'click';\n};\n\nexport type DeckMapFitToDataConfig = {\n  dataset: string;\n  longitudeColumn?: string;\n  latitudeColumn?: string;\n  geometryColumn?: string;\n  /**\n   * Multiple geometry columns whose extents should be combined when fitting\n   * the view. Used for arc layers that have separate source and target\n   * geometries — a single `geometryColumn` would only cover one endpoint.\n   */\n  geometryColumns?: string[];\n  h3Column?: string;\n  padding?: number;\n  maxZoom?: number;\n};\n\nexport type DeckMapConfigMode = 'basic' | 'custom';\n\n/** Durable, host-neutral Deck map configuration. */\nexport type DeckMapConfig = {\n  spec: DeckJsonMapProps['spec'];\n  datasets: Record<string, DeckMapDatasetConfig>;\n  configMode?: DeckMapConfigMode;\n  mapStyle?: string;\n  mapProps?: Record<string, unknown>;\n  showLegends?: boolean;\n  interaction?: DeckMapInteractionConfig;\n  fitToData?: DeckMapFitToDataConfig;\n  dataPolicy?: DeckMapDataPolicyOverride;\n  settingsOpen?: boolean;\n};\n\n/** Creates the portable empty configuration used for a new Deck map. */\nexport function createEmptyDeckMapConfig(): DeckMapConfig {\n  return {\n    spec: {\n      initialViewState: {longitude: 0, latitude: 20, zoom: 1.5},\n      layers: [],\n    },\n    datasets: {},\n  };\n}\n\n/** Adapter-facing dashboard panel shape; worksheet resources never store it. */\nexport type DeckMapDashboardPanelConfig = DeckMapConfig;\nexport type DeckMapDashboardDatasetConfig = DeckMapDatasetConfig;\nexport type DeckMapDashboardDatasetSource = DeckMapDatasetSource;\nexport type DeckMapDashboardInteractionConfig = DeckMapInteractionConfig;\nexport type DeckMapDashboardFitToDataConfig = DeckMapFitToDataConfig;\n\nexport const isDeckMapDashboardSqlDatasetSource = isDeckMapSqlDatasetSource;\nexport const isDeckMapDashboardTableDatasetSource = isDeckMapTableDatasetSource;\n\nexport type CreateDeckMapDashboardPanelConfigOptions = DeckMapConfig & {\n  title?: string;\n};\n\n/** Creates a Mosaic panel only for the opt-in dashboard adapter. */\nexport function createDeckMapDashboardPanelConfig(\n  options: CreateDeckMapDashboardPanelConfigOptions,\n) {\n  const {title, ...config} = options;\n  return {\n    id: createId(),\n    type: DECK_MAP_DASHBOARD_PANEL_TYPE,\n    title: title ?? 'Map',\n    config: JSON.parse(JSON.stringify(config)) as Record<string, unknown>,\n  };\n}\n\n/**\n * Returns a record as a Deck map config when it has the required top-level\n * spec and dataset registry, otherwise returns `null`.\n */\nexport function asDeckJsonMapConfig(\n  config: Record<string, unknown>,\n): DeckMapConfig | null {\n  if (\n    !config.spec ||\n    !config.datasets ||\n    typeof config.datasets !== 'object' ||\n    Array.isArray(config.datasets)\n  ) {\n    return null;\n  }\n  return config as DeckMapConfig;\n}\n"]}
+{"version":3,"file":"mapConfig.js","sourceRoot":"","sources":["../src/mapConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAC,sBAAsB,EAAC,MAAM,aAAa,CAAC;AAOnD,MAAM,CAAC,MAAM,6BAA6B,GAAG,eAAe,CAAC;AAC7D,MAAM,CAAC,MAAM,gCAAgC,GAAG,OAAO,CAAC;AAgBxD,0EAA0E;AAC1E,MAAM,UAAU,yBAAyB,CACvC,MAAwC;IAExC,OAAO,OAAO,CAAC,MAAM,IAAI,UAAU,IAAI,MAAM,CAAC,CAAC;AACjD,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,2BAA2B,CACzC,MAAwC;IAExC,OAAO,OAAO,CAAC,MAAM,IAAI,WAAW,IAAI,MAAM,CAAC,CAAC;AAClD,CAAC;AA4CD,oFAAoF;AACpF,MAAM,UAAU,uBAAuB,CAAC,MAAqB;IAC3D,OAAO,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,EAAE,QAAQ;QACjD,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,EAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,sBAAsB,EAAE,EAAC,CAAC;AACtD,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,yBAAyB,CACvC,MAAqB,EACrB,cAAoC;IAEpC,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,EAAE,QAAQ;QAAE,OAAO,MAAM,CAAC;IAChE,IAAI,cAAc,EAAE,QAAQ,EAAE,CAAC;QAC7B,OAAO,EAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAC,CAAC;IACxD,CAAC;IACD,IAAI,cAAc,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;QACvC,OAAO;YACL,GAAG,MAAM;YACT,QAAQ,EAAE;gBACR,GAAG,MAAM,CAAC,QAAQ;gBAClB,QAAQ,EAAE,cAAc,CAAC,QAAQ,CAAC,QAAQ;aAC3C;SACF,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,wBAAwB;IACtC,OAAO,uBAAuB,CAAC;QAC7B,IAAI,EAAE;YACJ,gBAAgB,EAAE,EAAC,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAC;YACzD,MAAM,EAAE,EAAE;SACX;QACD,QAAQ,EAAE,EAAE;KACb,CAAC,CAAC;AACL,CAAC;AASD,MAAM,CAAC,MAAM,kCAAkC,GAAG,yBAAyB,CAAC;AAC5E,MAAM,CAAC,MAAM,oCAAoC,GAAG,2BAA2B,CAAC;AAMhF,oEAAoE;AACpE,MAAM,UAAU,iCAAiC,CAC/C,OAAiD;IAEjD,MAAM,EAAC,KAAK,EAAE,GAAG,MAAM,EAAC,GAAG,OAAO,CAAC;IACnC,OAAO;QACL,EAAE,EAAE,QAAQ,EAAE;QACd,IAAI,EAAE,6BAA6B;QACnC,KAAK,EAAE,KAAK,IAAI,KAAK;QACrB,MAAM,EAAE,IAAI,CAAC,KAAK,CAChB,IAAI,CAAC,SAAS,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,CACrB;KAC7B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAA+B;IAE/B,IACE,CAAC,MAAM,CAAC,IAAI;QACZ,CAAC,MAAM,CAAC,QAAQ;QAChB,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;QACnC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAC9B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAuB,CAAC;AACjC,CAAC","sourcesContent":["import {createId} from '@paralleldrive/cuid2';\nimport {getDefaultDeckMapStyle} from './mapStyles';\nimport type {\n  DeckJsonMapProps,\n  DeckSqlDatasetInput,\n  DeckTableDatasetInput,\n} from './types';\n\nexport const DECK_MAP_DASHBOARD_PANEL_TYPE = 'deck-json-map';\nexport const DEFAULT_DECK_MAP_MAX_DATA_POINTS = 100_000;\n\nexport type DeckMapDataPolicyOverride = {\n  disabled?: boolean;\n  maxRows?: number;\n  reason?: string;\n};\n\nexport type DeckMapDatasetSource =\n  | Pick<DeckSqlDatasetInput, 'sqlQuery'>\n  | Pick<DeckTableDatasetInput, 'tableName' | 'transformSql'>;\n\nexport type DeckMapDatasetConfig = Omit<DeckSqlDatasetInput, 'sqlQuery'> & {\n  source?: DeckMapDatasetSource;\n};\n\n/** Returns whether a map dataset source is a pinned literal SQL query. */\nexport function isDeckMapSqlDatasetSource(\n  source: DeckMapDatasetSource | undefined,\n): source is Pick<DeckSqlDatasetInput, 'sqlQuery'> {\n  return Boolean(source && 'sqlQuery' in source);\n}\n\n/** Returns whether a map dataset source is backed by a named table. */\nexport function isDeckMapTableDatasetSource(\n  source: DeckMapDatasetSource | undefined,\n): source is Pick<DeckTableDatasetInput, 'tableName' | 'transformSql'> {\n  return Boolean(source && 'tableName' in source);\n}\n\nexport type DeckMapInteractionConfig = {\n  type: 'point-radius-brush';\n  dataset: string;\n  longitudeColumn: string;\n  latitudeColumn: string;\n  radiusMeters?: number;\n  event?: 'hover' | 'click';\n};\n\nexport type DeckMapFitToDataConfig = {\n  dataset: string;\n  longitudeColumn?: string;\n  latitudeColumn?: string;\n  geometryColumn?: string;\n  /**\n   * Multiple geometry columns whose extents should be combined when fitting\n   * the view. Used for arc layers that have separate source and target\n   * geometries — a single `geometryColumn` would only cover one endpoint.\n   */\n  geometryColumns?: string[];\n  h3Column?: string;\n  padding?: number;\n  maxZoom?: number;\n};\n\nexport type DeckMapConfigMode = 'basic' | 'custom';\n\n/** Durable, host-neutral Deck map configuration. */\nexport type DeckMapConfig = {\n  spec: DeckJsonMapProps['spec'];\n  datasets: Record<string, DeckMapDatasetConfig>;\n  configMode?: DeckMapConfigMode;\n  /** Built-in basemap ID (`light`/`dark`) or custom style URL. */\n  mapStyle?: string;\n  mapProps?: Record<string, unknown>;\n  showLegends?: boolean;\n  interaction?: DeckMapInteractionConfig;\n  fitToData?: DeckMapFitToDataConfig;\n  dataPolicy?: DeckMapDataPolicyOverride;\n  settingsOpen?: boolean;\n};\n\n/** Adds a creation-time basemap default while preserving explicit custom styles. */\nexport function withDefaultDeckMapStyle(config: DeckMapConfig): DeckMapConfig {\n  return config.mapStyle || config.mapProps?.mapStyle\n    ? config\n    : {...config, mapStyle: getDefaultDeckMapStyle()};\n}\n\n/** Retains a map's basemap on config replacement unless a new style is supplied. */\nexport function withPreservedDeckMapStyle(\n  config: DeckMapConfig,\n  previousConfig: DeckMapConfig | null,\n): DeckMapConfig {\n  if (config.mapStyle || config.mapProps?.mapStyle) return config;\n  if (previousConfig?.mapStyle) {\n    return {...config, mapStyle: previousConfig.mapStyle};\n  }\n  if (previousConfig?.mapProps?.mapStyle) {\n    return {\n      ...config,\n      mapProps: {\n        ...config.mapProps,\n        mapStyle: previousConfig.mapProps.mapStyle,\n      },\n    };\n  }\n  return config;\n}\n\n/** Creates the portable empty configuration used for a new Deck map. */\nexport function createEmptyDeckMapConfig(): DeckMapConfig {\n  return withDefaultDeckMapStyle({\n    spec: {\n      initialViewState: {longitude: 0, latitude: 20, zoom: 1.5},\n      layers: [],\n    },\n    datasets: {},\n  });\n}\n\n/** Adapter-facing dashboard panel shape; document resources never store it. */\nexport type DeckMapDashboardPanelConfig = DeckMapConfig;\nexport type DeckMapDashboardDatasetConfig = DeckMapDatasetConfig;\nexport type DeckMapDashboardDatasetSource = DeckMapDatasetSource;\nexport type DeckMapDashboardInteractionConfig = DeckMapInteractionConfig;\nexport type DeckMapDashboardFitToDataConfig = DeckMapFitToDataConfig;\n\nexport const isDeckMapDashboardSqlDatasetSource = isDeckMapSqlDatasetSource;\nexport const isDeckMapDashboardTableDatasetSource = isDeckMapTableDatasetSource;\n\nexport type CreateDeckMapDashboardPanelConfigOptions = DeckMapConfig & {\n  title?: string;\n};\n\n/** Creates a Mosaic panel only for the opt-in dashboard adapter. */\nexport function createDeckMapDashboardPanelConfig(\n  options: CreateDeckMapDashboardPanelConfigOptions,\n) {\n  const {title, ...config} = options;\n  return {\n    id: createId(),\n    type: DECK_MAP_DASHBOARD_PANEL_TYPE,\n    title: title ?? 'Map',\n    config: JSON.parse(\n      JSON.stringify(withDefaultDeckMapStyle(config)),\n    ) as Record<string, unknown>,\n  };\n}\n\n/**\n * Returns a record as a Deck map config when it has the required top-level\n * spec and dataset registry, otherwise returns `null`.\n */\nexport function asDeckJsonMapConfig(\n  config: Record<string, unknown>,\n): DeckMapConfig | null {\n  if (\n    !config.spec ||\n    !config.datasets ||\n    typeof config.datasets !== 'object' ||\n    Array.isArray(config.datasets)\n  ) {\n    return null;\n  }\n  return config as DeckMapConfig;\n}\n"]}

package/dist/mapConfigUtils.d.ts

@@ -38,6 +38,23 @@ export declare function createDeckMapPointTransformSql(options: {
     latitudeColumn: string;
     geometryColumn: string;
 }): string;
+/** Structured provenance for a table-backed longitude/latitude point dataset. */
+export type DeckMapPointBinding = {
+    dataset: string;
+    longitudeColumn: string;
+    latitudeColumn: string;
+    geometryColumn?: string;
+};
+/**
+ * Applies a structured longitude/latitude point binding to a native Deck map
+ * config. The generated geometry SQL intentionally comes from the same
+ * canonical helper used by first-party map builders.
+ */
+export declare function applyDeckMapPointBinding<T extends DeckMapDashboardPanelConfig>(options: {
+    config: T;
+    pointBinding: DeckMapPointBinding;
+    sourceColumns: readonly DeckMapConfigColumn[];
+}): T;
 /**
  * Post-normalizes an existing Deck map config so table-backed lon/lat datasets
  * without `transformSql`, `sqlQuery`, or a native geometry column get a WKB
@@ -108,4 +125,9 @@ export declare function regenerateMapConfigForTable(panel: {
     dataPolicy?: import("./mapConfig").DeckMapDataPolicyOverride;
     settingsOpen?: boolean;
 };
+/**
+ * Applies a document map table pick: regenerate geospatial config when
+ * possible, otherwise retarget the single table-backed dataset.
+ */
+export declare function applyDeckMapTableSelection(config: DeckMapConfig, table: DataTable, longitudeColumn?: string, latitudeColumn?: string): DeckMapConfig;
 //# sourceMappingURL=mapConfigUtils.d.ts.map

package/dist/mapConfigUtils.d.ts.map

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

package/dist/mapConfigUtils.js

@@ -1,6 +1,7 @@
 import { getRawSqlTableReference, makeQualifiedTableName, quoteParsedRawSqlTableReference, } from '@sqlrooms/duckdb';
-import { createDeckMapDashboardPanelConfig, } from './mapConfig';
+import { createDeckMapDashboardPanelConfig, isDeckMapTableDatasetSource, } from './mapConfig';
 import { DECK_TABLE_DATASET_SOURCE_RELATION } from './datasets/tableDatasetSql';
+import { getDefaultDeckMapStyle } from './mapStyles';
 const LONGITUDE_COLUMN_NAMES = ['longitude', 'lon', 'lng', 'long', 'x'];
 const LATITUDE_COLUMN_NAMES = ['latitude', 'lat', 'y'];
 const GEOMETRY_COLUMN_NAMES = ['geometry', 'geom'];
@@ -172,6 +173,7 @@ const DECK_MAP_POINT_LAYER_TYPES = new Set([
     'GeoArrowScatterplotLayer',
     'GeoArrowHeatmapLayer',
     'GeoArrowColumnLayer',
+    'GeoJsonLayer',
 ]);
 function isDeckMapConfigRecord(value) {
     return Boolean(value && typeof value === 'object' && !Array.isArray(value));
@@ -206,10 +208,15 @@ function normalizeDeckMapPointLayers(options) {
         const binding = isDeckMapConfigRecord(layer._sqlroomsBinding)
             ? layer._sqlroomsBinding
             : {};
+        const geometryBinding = { ...binding };
+        delete geometryBinding.longitudeColumn;
+        delete geometryBinding.latitudeColumn;
+        const pointLayer = { ...layer };
+        delete pointLayer.getPosition;
         return {
-            ...layer,
+            ...pointLayer,
             _sqlroomsBinding: {
-                ...binding,
+                ...geometryBinding,
                 dataset: typeof binding.dataset === 'string'
                     ? binding.dataset
                     : options.datasetId,
@@ -219,6 +226,108 @@ function normalizeDeckMapPointLayers(options) {
     });
     return (changed ? layers : options.layers);
 }
+/**
+ * Applies a structured longitude/latitude point binding to a native Deck map
+ * config. The generated geometry SQL intentionally comes from the same
+ * canonical helper used by first-party map builders.
+ */
+export function applyDeckMapPointBinding(options) {
+    const { config, pointBinding } = options;
+    const datasetId = pointBinding.dataset.trim();
+    const longitudeColumn = pointBinding.longitudeColumn.trim();
+    const latitudeColumn = pointBinding.latitudeColumn.trim();
+    if (!datasetId || !longitudeColumn || !latitudeColumn) {
+        throw new Error('Point binding requires dataset, longitudeColumn, and latitudeColumn.');
+    }
+    const dataset = config.datasets[datasetId];
+    if (!dataset) {
+        throw new Error(`Point binding references unknown dataset "${datasetId}".`);
+    }
+    if (!isDeckMapTableDatasetSource(dataset.source)) {
+        throw new Error(`Point binding dataset "${datasetId}" must use source.tableName.`);
+    }
+    const geometryColumn = pointBinding.geometryColumn?.trim() || DEFAULT_GEOMETRY_COLUMN;
+    const sourceColumnNames = new Set(options.sourceColumns.map((column) => column.name.toLowerCase()));
+    for (const [bindingName, columnName] of [
+        ['longitudeColumn', longitudeColumn],
+        ['latitudeColumn', latitudeColumn],
+    ]) {
+        if (!sourceColumnNames.has(columnName.toLowerCase())) {
+            throw new Error(`Point binding ${bindingName} "${columnName}" was not found in source columns.`);
+        }
+    }
+    if (sourceColumnNames.has(geometryColumn.toLowerCase())) {
+        throw new Error(`Point binding geometryColumn "${geometryColumn}" conflicts with an existing source column.`);
+    }
+    const datasetIds = Object.keys(config.datasets);
+    let parsedSpec = config.spec;
+    if (typeof parsedSpec === 'string') {
+        try {
+            parsedSpec = JSON.parse(parsedSpec);
+        }
+        catch {
+            // Durable resource validation reports the invalid serialized spec.
+        }
+    }
+    const spec = isDeckMapConfigRecord(parsedSpec)
+        ? {
+            ...parsedSpec,
+            ...(Array.isArray(parsedSpec.layers)
+                ? {
+                    layers: normalizeDeckMapPointLayers({
+                        layers: parsedSpec.layers,
+                        datasetId,
+                        datasetIds,
+                        geometryColumn,
+                    }),
+                }
+                : {}),
+        }
+        : parsedSpec;
+    let fitToData = config.fitToData;
+    if (isDeckMapConfigRecord(fitToData) && fitToData.dataset === datasetId) {
+        const geometryFit = { ...fitToData };
+        delete geometryFit.longitudeColumn;
+        delete geometryFit.latitudeColumn;
+        delete geometryFit.geometryColumns;
+        delete geometryFit.h3Column;
+        fitToData = { ...geometryFit, geometryColumn };
+    }
+    else if (!fitToData) {
+        fitToData = {
+            dataset: datasetId,
+            geometryColumn,
+            padding: 40,
+            maxZoom: 12,
+        };
+    }
+    const interaction = config.interaction?.type === 'point-radius-brush' &&
+        config.interaction.dataset === datasetId
+        ? { ...config.interaction, longitudeColumn, latitudeColumn }
+        : config.interaction;
+    return {
+        ...config,
+        spec,
+        ...(interaction !== config.interaction ? { interaction } : {}),
+        datasets: {
+            ...config.datasets,
+            [datasetId]: {
+                ...dataset,
+                source: {
+                    tableName: dataset.source.tableName,
+                    transformSql: createDeckMapPointTransformSql({
+                        longitudeColumn,
+                        latitudeColumn,
+                        geometryColumn,
+                    }),
+                },
+                geometryColumn,
+                geometryEncodingHint: 'wkb',
+            },
+        },
+        fitToData,
+    };
+}
 /**
  * Post-normalizes an existing Deck map config so table-backed lon/lat datasets
  * without `transformSql`, `sqlQuery`, or a native geometry column get a WKB
@@ -441,7 +550,7 @@ export function createDeckMapConfigForTable(options) {
                     },
                 }
                 : {}),
-        ...(options.mapStyle ? { mapStyle: options.mapStyle } : {}),
+        mapStyle: options.mapStyle ?? getDefaultDeckMapStyle(),
     };
 }
 export const createDeckMapDashboardConfigForTable = createDeckMapConfigForTable;
@@ -480,7 +589,11 @@ export function regenerateMapConfigForTable(panel, table, longitudeColumn, latit
     });
     const nextDataset = Object.values(nextConfig.datasets)[0];
     if (existingDatasetIds.length === 0) {
-        return nextConfig;
+        return {
+            ...nextConfig,
+            mapStyle: existingConfig.mapStyle,
+            mapProps: existingConfig.mapProps,
+        };
     }
     if (existingDatasetIds.length === 1 && nextDataset) {
         const datasetId = existingDatasetIds[0];
@@ -501,4 +614,38 @@ export function regenerateMapConfigForTable(panel, table, longitudeColumn, latit
         fitToData: nextConfig.fitToData ?? existingConfig.fitToData,
     };
 }
+/**
+ * Applies a document map table pick: regenerate geospatial config when
+ * possible, otherwise retarget the single table-backed dataset.
+ */
+export function applyDeckMapTableSelection(config, table, longitudeColumn, latitudeColumn) {
+    const regenerated = regenerateMapConfigForTable({ config }, table, longitudeColumn, latitudeColumn);
+    if (regenerated !== config) {
+        return regenerated;
+    }
+    const datasetIds = Object.keys(config.datasets ?? {});
+    if (datasetIds.length !== 1)
+        return config;
+    const datasetId = datasetIds[0];
+    const dataset = config.datasets[datasetId];
+    if (!dataset || !isDeckMapTableDatasetSource(dataset.source)) {
+        return config;
+    }
+    const tableName = quoteDeckMapSqlTableReference(table.table);
+    if (dataset.source.tableName === tableName)
+        return config;
+    return {
+        ...config,
+        datasets: {
+            ...config.datasets,
+            [datasetId]: {
+                ...dataset,
+                source: {
+                    ...dataset.source,
+                    tableName,
+                },
+            },
+        },
+    };
+}
 //# sourceMappingURL=mapConfigUtils.js.map