@sqlrooms/deck 0.29.0-rc.10

package/dist/block.js

@@ -0,0 +1,105 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { getTableIdentity, } from '@sqlrooms/duckdb';
+import { useBlockSettingsStore } from '@sqlrooms/documents';
+import { Button, Tooltip, TooltipContent, TooltipTrigger } from '@sqlrooms/ui';
+import { FocusIcon, MapIcon, SlidersVerticalIcon } from 'lucide-react';
+import { Component, useCallback, useEffect, useState, } from 'react';
+import { DeckMapSurface, directDeckMapDataAdapter, } from './DeckMapSurface';
+import { useStoreWithDeckMaps } from './DeckMapsSlice';
+import { createEmptyDeckMapConfig } from './mapConfig';
+import { createDeckMapConfigForTable, findGeometryColumn, findLongitudeLatitudeColumns, } from './mapConfigUtils';
+class DeckMapResourceErrorBoundary extends Component {
+    state = {
+        resetKey: this.props.resetKey,
+    };
+    static getDerivedStateFromError(error) {
+        return { error };
+    }
+    static getDerivedStateFromProps(props, state) {
+        return Object.is(props.resetKey, state.resetKey)
+            ? null
+            : { error: undefined, resetKey: props.resetKey };
+    }
+    componentDidCatch(error, errorInfo) {
+        console.error('[DeckMapResourceErrorBoundary] Map render failed', error, errorInfo);
+        this.props.onError(error);
+    }
+    render() {
+        if (this.state.error) {
+            return (_jsxs("div", { className: "text-muted-foreground flex h-full min-h-[320px] items-center justify-center p-4 text-center text-sm", children: ["Map failed to render: ", this.state.error.message] }));
+        }
+        return this.props.children;
+    }
+}
+/** Ensures a first-class map resource, optionally seeded from geospatial data. */
+export function ensureDeckMapResourceState(state, mapId, title) {
+    if (state.deckMaps.getMap(mapId))
+        return;
+    const table = state.db.tables.find((candidate) => Boolean(findLongitudeLatitudeColumns(candidate)) ||
+        Boolean(findGeometryColumn(candidate)));
+    state.deckMaps.ensureMap(mapId, {
+        title: title ?? 'Map',
+        config: table
+            ? createDeckMapConfigForTable({
+                tableName: table.tableName,
+                columns: table.columns,
+                tableReference: table.table,
+            })
+            : createEmptyDeckMapConfig(),
+    });
+    if (table)
+        state.deckMaps.setSelectedTable(mapId, getTableIdentity(table.table));
+}
+/** Mosaic-free worksheet map renderer backed only by `deckMaps`. */
+export function DeckMapBlockRenderer({ mapId, title, caption, onCaptionChange, selected, readOnly, headerActions, dataAdapter = directDeckMapDataAdapter, }) {
+    const map = useStoreWithDeckMaps((state) => state.deckMaps.config.mapsById[mapId]);
+    const tables = useStoreWithDeckMaps((state) => state.db.tables);
+    const ensureMap = useStoreWithDeckMaps((state) => state.deckMaps.ensureMap);
+    const updateMap = useStoreWithDeckMaps((state) => state.deckMaps.updateMap);
+    const setSelectedTable = useStoreWithDeckMaps((state) => state.deckMaps.setSelectedTable);
+    const reportMapIssue = useStoreWithDeckMaps((state) => state.deckMaps.reportMapIssue);
+    const clearMapIssue = useStoreWithDeckMaps((state) => state.deckMaps.clearMapIssue);
+    const requestOpenSettingsPanel = useBlockSettingsStore((state) => state.blockSettings.requestOpenSettingsPanel);
+    const requestCloseSettingsPanel = useBlockSettingsStore((state) => state.blockSettings.requestCloseSettingsPanel);
+    const isSettingsPanelOpen = useBlockSettingsStore((state) => state.blockSettings.runtime.isSettingsPanelOpen);
+    const isSettingsShown = Boolean(selected && isSettingsPanelOpen);
+    const [fitRequestVersion, setFitRequestVersion] = useState(0);
+    useEffect(() => {
+        if (mapId && !map)
+            ensureMap(mapId, { title: title ?? 'Embedded Map' });
+    }, [ensureMap, map, mapId, title]);
+    const handleTableChange = useCallback((table) => {
+        setSelectedTable(mapId, getTableIdentity(table.table));
+        const hasGeo = Boolean(findLongitudeLatitudeColumns(table)) ||
+            Boolean(findGeometryColumn(table));
+        updateMap(mapId, {
+            config: hasGeo
+                ? createDeckMapConfigForTable({
+                    tableName: table.tableName,
+                    columns: table.columns,
+                    tableReference: table.table,
+                })
+                : createEmptyDeckMapConfig(),
+        });
+    }, [mapId, setSelectedTable, updateMap]);
+    if (!map) {
+        return (_jsx("div", { className: "text-muted-foreground flex h-full min-h-[320px] items-center justify-center", children: "Preparing map..." }));
+    }
+    const hasDatasets = Object.keys(map.config.datasets).length > 0;
+    const canFitView = Boolean(map.config.fitToData && hasDatasets);
+    const fitViewLabel = canFitView
+        ? 'Fit map view to data'
+        : 'Fit view unavailable for this map';
+    return (_jsxs("div", { className: "flex h-full min-h-0 flex-col", children: [_jsxs("div", { className: "border-border flex shrink-0 items-center justify-between gap-2 border-b px-3 py-2", children: [_jsxs("div", { className: "flex min-w-0 flex-1 items-center gap-2", children: [_jsx(MapIcon, { className: "h-4 w-4 shrink-0" }), _jsx("input", { className: "min-w-0 flex-1 bg-transparent text-sm outline-none", value: caption ?? map.title, readOnly: readOnly, placeholder: map.selectedTable ?? title ?? 'Map caption', onChange: (event) => onCaptionChange?.(event.target.value || undefined) })] }), _jsxs("div", { className: "flex items-center gap-0.5", children: [_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsx("span", { className: "inline-flex", tabIndex: canFitView ? undefined : 0, "aria-label": canFitView ? undefined : fitViewLabel, children: _jsx(Button, { type: "button", variant: "ghost", size: "icon", className: "h-6 w-6", "aria-label": fitViewLabel, disabled: !canFitView, onClick: () => setFitRequestVersion((version) => version + 1), children: _jsx(FocusIcon, { className: "h-3.5 w-3.5" }) }) }) }), _jsx(TooltipContent, { children: fitViewLabel })] }), _jsx(Button, { type: "button", variant: isSettingsShown ? 'secondary' : 'ghost', size: "icon", className: "h-6 w-6", "aria-label": isSettingsShown ? 'Close map settings' : 'Open map settings', onClick: () => isSettingsShown
+                                    ? requestCloseSettingsPanel()
+                                    : requestOpenSettingsPanel(), children: _jsx(SlidersVerticalIcon, { className: "h-3.5 w-3.5" }) }), headerActions] })] }), _jsx("div", { className: "min-h-0 flex-1", children: hasDatasets ? (_jsx(DeckMapResourceErrorBoundary, { resetKey: map.config, onError: (error) => reportMapIssue(mapId, {
+                        kind: 'render-error',
+                        message: error.message,
+                        recoverable: true,
+                    }), children: _jsx(DeckMapSurface, { mapId: mapId, map: map, readOnly: readOnly, selected: selected, onUpdateMap: (patch) => updateMap(mapId, patch), onReportIssue: (issue) => reportMapIssue(mapId, issue), onClearIssue: (kind) => clearMapIssue(mapId, kind), fitRequestVersion: fitRequestVersion, dataAdapter: dataAdapter }) })) : (_jsx("div", { className: "flex h-full min-h-[320px] items-center justify-center p-4", children: _jsxs("select", { className: "border-border bg-background rounded border px-3 py-2 text-sm", value: map.selectedTable ?? '', disabled: readOnly, onChange: (event) => {
+                            const table = tables.find((candidate) => getTableIdentity(candidate.table) === event.target.value);
+                            if (table)
+                                handleTableChange(table);
+                        }, children: [_jsx("option", { value: "", children: "Select a table" }), tables.map((table) => (_jsx("option", { value: getTableIdentity(table.table), children: table.tableName }, getTableIdentity(table.table))))] }) })) })] }));
+}
+//# sourceMappingURL=block.js.map

package/dist/block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block.js","sourceRoot":"","sources":["../src/block.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  getTableIdentity,\n  type DataTable,\n  type DuckDbSliceState,\n} from '@sqlrooms/duckdb';\nimport {useBlockSettingsStore} from '@sqlrooms/documents';\nimport {Button, Tooltip, TooltipContent, TooltipTrigger} from '@sqlrooms/ui';\nimport {FocusIcon, MapIcon, SlidersVerticalIcon} from 'lucide-react';\nimport {\n  Component,\n  useCallback,\n  useEffect,\n  useState,\n  type ErrorInfo,\n  type ReactNode,\n} from 'react';\nimport {\n  DeckMapSurface,\n  directDeckMapDataAdapter,\n  type DeckMapDataAdapter,\n} from './DeckMapSurface';\nimport {type DeckMapsSliceState, useStoreWithDeckMaps} from './DeckMapsSlice';\nimport {createEmptyDeckMapConfig} from './mapConfig';\nimport {\n  createDeckMapConfigForTable,\n  findGeometryColumn,\n  findLongitudeLatitudeColumns,\n} from './mapConfigUtils';\n\ntype DeckMapResourceState = DeckMapsSliceState & DuckDbSliceState;\n\ntype DeckMapResourceErrorBoundaryProps = {\n  children: ReactNode;\n  onError: (error: Error) => void;\n  resetKey: unknown;\n};\n\ntype DeckMapResourceErrorBoundaryState = {\n  error?: Error;\n  resetKey: unknown;\n};\n\nclass DeckMapResourceErrorBoundary extends Component<\n  DeckMapResourceErrorBoundaryProps,\n  DeckMapResourceErrorBoundaryState\n> {\n  state: DeckMapResourceErrorBoundaryState = {\n    resetKey: this.props.resetKey,\n  };\n  static getDerivedStateFromError(error: Error) {\n    return {error};\n  }\n  static getDerivedStateFromProps(\n    props: DeckMapResourceErrorBoundaryProps,\n    state: DeckMapResourceErrorBoundaryState,\n  ) {\n    return Object.is(props.resetKey, state.resetKey)\n      ? null\n      : {error: undefined, resetKey: props.resetKey};\n  }\n  componentDidCatch(error: Error, errorInfo: ErrorInfo) {\n    console.error(\n      '[DeckMapResourceErrorBoundary] Map render failed',\n      error,\n      errorInfo,\n    );\n    this.props.onError(error);\n  }\n  render() {\n    if (this.state.error) {\n      return (\n        <div className=\"text-muted-foreground flex h-full min-h-[320px] items-center justify-center p-4 text-center text-sm\">\n          Map failed to render: {this.state.error.message}\n        </div>\n      );\n    }\n    return this.props.children;\n  }\n}\n\n/** Ensures a first-class map resource, optionally seeded from geospatial data. */\nexport function ensureDeckMapResourceState(\n  state: DeckMapResourceState,\n  mapId: string,\n  title?: string,\n) {\n  if (state.deckMaps.getMap(mapId)) return;\n  const table = state.db.tables.find(\n    (candidate) =>\n      Boolean(findLongitudeLatitudeColumns(candidate)) ||\n      Boolean(findGeometryColumn(candidate)),\n  );\n  state.deckMaps.ensureMap(mapId, {\n    title: title ?? 'Map',\n    config: table\n      ? createDeckMapConfigForTable({\n          tableName: table.tableName,\n          columns: table.columns,\n          tableReference: table.table,\n        })\n      : createEmptyDeckMapConfig(),\n  });\n  if (table)\n    state.deckMaps.setSelectedTable(mapId, getTableIdentity(table.table));\n}\n\nexport type DeckMapBlockRendererProps = {\n  mapId: string;\n  title?: string;\n  caption?: string;\n  onCaptionChange?: (caption: string | undefined) => void;\n  selected?: boolean;\n  readOnly?: boolean;\n  headerActions?: ReactNode;\n  dataAdapter?: DeckMapDataAdapter;\n};\n\n/** Mosaic-free worksheet map renderer backed only by `deckMaps`. */\nexport function DeckMapBlockRenderer({\n  mapId,\n  title,\n  caption,\n  onCaptionChange,\n  selected,\n  readOnly,\n  headerActions,\n  dataAdapter = directDeckMapDataAdapter,\n}: DeckMapBlockRendererProps) {\n  const map = useStoreWithDeckMaps(\n    (state) => state.deckMaps.config.mapsById[mapId],\n  );\n  const tables = useStoreWithDeckMaps((state) => state.db.tables);\n  const ensureMap = useStoreWithDeckMaps((state) => state.deckMaps.ensureMap);\n  const updateMap = useStoreWithDeckMaps((state) => state.deckMaps.updateMap);\n  const setSelectedTable = useStoreWithDeckMaps(\n    (state) => state.deckMaps.setSelectedTable,\n  );\n  const reportMapIssue = useStoreWithDeckMaps(\n    (state) => state.deckMaps.reportMapIssue,\n  );\n  const clearMapIssue = useStoreWithDeckMaps(\n    (state) => state.deckMaps.clearMapIssue,\n  );\n  const requestOpenSettingsPanel = useBlockSettingsStore(\n    (state) => state.blockSettings.requestOpenSettingsPanel,\n  );\n  const requestCloseSettingsPanel = useBlockSettingsStore(\n    (state) => state.blockSettings.requestCloseSettingsPanel,\n  );\n  const isSettingsPanelOpen = useBlockSettingsStore(\n    (state) => state.blockSettings.runtime.isSettingsPanelOpen,\n  );\n  const isSettingsShown = Boolean(selected && isSettingsPanelOpen);\n  const [fitRequestVersion, setFitRequestVersion] = useState(0);\n\n  useEffect(() => {\n    if (mapId && !map) ensureMap(mapId, {title: title ?? 'Embedded Map'});\n  }, [ensureMap, map, mapId, title]);\n\n  const handleTableChange = useCallback(\n    (table: DataTable) => {\n      setSelectedTable(mapId, getTableIdentity(table.table));\n      const hasGeo =\n        Boolean(findLongitudeLatitudeColumns(table)) ||\n        Boolean(findGeometryColumn(table));\n      updateMap(mapId, {\n        config: hasGeo\n          ? createDeckMapConfigForTable({\n              tableName: table.tableName,\n              columns: table.columns,\n              tableReference: table.table,\n            })\n          : createEmptyDeckMapConfig(),\n      });\n    },\n    [mapId, setSelectedTable, updateMap],\n  );\n\n  if (!map) {\n    return (\n      <div className=\"text-muted-foreground flex h-full min-h-[320px] items-center justify-center\">\n        Preparing map...\n      </div>\n    );\n  }\n  const hasDatasets = Object.keys(map.config.datasets).length > 0;\n  const canFitView = Boolean(map.config.fitToData && hasDatasets);\n  const fitViewLabel = canFitView\n    ? 'Fit map view to data'\n    : 'Fit view unavailable for this map';\n  return (\n    <div className=\"flex h-full min-h-0 flex-col\">\n      <div className=\"border-border flex shrink-0 items-center justify-between gap-2 border-b px-3 py-2\">\n        <div className=\"flex min-w-0 flex-1 items-center gap-2\">\n          <MapIcon className=\"h-4 w-4 shrink-0\" />\n          <input\n            className=\"min-w-0 flex-1 bg-transparent text-sm outline-none\"\n            value={caption ?? map.title}\n            readOnly={readOnly}\n            placeholder={map.selectedTable ?? title ?? 'Map caption'}\n            onChange={(event) =>\n              onCaptionChange?.(event.target.value || undefined)\n            }\n          />\n        </div>\n        <div className=\"flex items-center gap-0.5\">\n          <Tooltip>\n            <TooltipTrigger asChild>\n              <span\n                className=\"inline-flex\"\n                tabIndex={canFitView ? undefined : 0}\n                aria-label={canFitView ? undefined : fitViewLabel}\n              >\n                <Button\n                  type=\"button\"\n                  variant=\"ghost\"\n                  size=\"icon\"\n                  className=\"h-6 w-6\"\n                  aria-label={fitViewLabel}\n                  disabled={!canFitView}\n                  onClick={() => setFitRequestVersion((version) => version + 1)}\n                >\n                  <FocusIcon className=\"h-3.5 w-3.5\" />\n                </Button>\n              </span>\n            </TooltipTrigger>\n            <TooltipContent>{fitViewLabel}</TooltipContent>\n          </Tooltip>\n          <Button\n            type=\"button\"\n            variant={isSettingsShown ? 'secondary' : 'ghost'}\n            size=\"icon\"\n            className=\"h-6 w-6\"\n            aria-label={\n              isSettingsShown ? 'Close map settings' : 'Open map settings'\n            }\n            onClick={() =>\n              isSettingsShown\n                ? requestCloseSettingsPanel()\n                : requestOpenSettingsPanel()\n            }\n          >\n            <SlidersVerticalIcon className=\"h-3.5 w-3.5\" />\n          </Button>\n          {headerActions}\n        </div>\n      </div>\n      <div className=\"min-h-0 flex-1\">\n        {hasDatasets ? (\n          <DeckMapResourceErrorBoundary\n            resetKey={map.config}\n            onError={(error) =>\n              reportMapIssue(mapId, {\n                kind: 'render-error',\n                message: error.message,\n                recoverable: true,\n              })\n            }\n          >\n            <DeckMapSurface\n              mapId={mapId}\n              map={map}\n              readOnly={readOnly}\n              selected={selected}\n              onUpdateMap={(patch) => updateMap(mapId, patch)}\n              onReportIssue={(issue) => reportMapIssue(mapId, issue)}\n              onClearIssue={(kind) => clearMapIssue(mapId, kind)}\n              fitRequestVersion={fitRequestVersion}\n              dataAdapter={dataAdapter}\n            />\n          </DeckMapResourceErrorBoundary>\n        ) : (\n          <div className=\"flex h-full min-h-[320px] items-center justify-center p-4\">\n            <select\n              className=\"border-border bg-background rounded border px-3 py-2 text-sm\"\n              value={map.selectedTable ?? ''}\n              disabled={readOnly}\n              onChange={(event) => {\n                const table = tables.find(\n                  (candidate) =>\n                    getTableIdentity(candidate.table) === event.target.value,\n                );\n                if (table) handleTableChange(table);\n              }}\n            >\n              <option value=\"\">Select a table</option>\n              {tables.map((table) => (\n                <option\n                  key={getTableIdentity(table.table)}\n                  value={getTableIdentity(table.table)}\n                >\n                  {table.tableName}\n                </option>\n              ))}\n            </select>\n          </div>\n        )}\n      </div>\n    </div>\n  );\n}\n"]}

package/dist/blockDocumentRegistration.d.ts

@@ -0,0 +1,45 @@
+import type { BlockDocumentStatefulBlockCommandType, BlockDocumentStatefulBlockType } from '@sqlrooms/documents';
+import type { DuckDbSliceState } from '@sqlrooms/duckdb';
+import type { DeckMapsSliceState } from './DeckMapsSlice';
+export declare const DECK_MAP_BLOCK_TYPE = "map";
+export declare const DECK_MAP_BLOCK_DEFAULT_TITLE = "Embedded Map";
+export declare const DECK_MAP_BLOCK_DEFAULT_HEIGHT = 560;
+/**
+ * Options for configuring Deck map block document registration. Hosts pass
+ * these to `createDeckMapBlockDocumentType` / `createDeckMapBlockDocumentCommandType`.
+ */
+export type DeckMapBlockDocumentRegistrationOptions<TState> = {
+    /** Product label for the map block (defaults to "Map"). */
+    label?: string;
+    /** Description shown in block pickers. */
+    description?: string;
+    /** Default caption/title used when ensuring state. */
+    defaultTitle?: string;
+    /** Default height in pixels for the map block. */
+    defaultHeight?: number;
+    /** Minimum resizable height in pixels. */
+    minHeight?: number;
+    /** Maximum resizable height in pixels. */
+    maxHeight?: number;
+    /**
+     * Called after Deck map state is ensured. Hosts can add product-specific
+     * side effects; delete/remove stays host-owned.
+     */
+    afterEnsureState?: (options: {
+        state: TState;
+        blockInstanceId: string;
+        title: string;
+    }) => void;
+};
+/**
+ * Builds the shared TipTap/UI registration metadata for a Deck map stateful
+ * block. Hosts still own renderer maps, delete handlers, and product labels.
+ */
+export declare function createDeckMapBlockDocumentType<TState extends DeckMapsSliceState & DuckDbSliceState>(options: DeckMapBlockDocumentRegistrationOptions<TState> & {
+    getState: () => TState;
+}): BlockDocumentStatefulBlockType;
+/**
+ * Builds the shared command-type registration for a Deck map stateful block.
+ */
+export declare function createDeckMapBlockDocumentCommandType<TState extends DeckMapsSliceState & DuckDbSliceState>(options?: DeckMapBlockDocumentRegistrationOptions<TState>): BlockDocumentStatefulBlockCommandType<TState>;
+//# sourceMappingURL=blockDocumentRegistration.d.ts.map

package/dist/blockDocumentRegistration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockDocumentRegistration.d.ts","sourceRoot":"","sources":["../src/blockDocumentRegistration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qCAAqC,EACrC,8BAA8B,EAC/B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAIxD,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AACzC,eAAO,MAAM,4BAA4B,iBAAiB,CAAC;AAC3D,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAEjD;;;GAGG;AACH,MAAM,MAAM,uCAAuC,CAAC,MAAM,IAAI;IAC5D,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE;QAC3B,KAAK,EAAE,MAAM,CAAC;QACd,eAAe,EAAE,MAAM,CAAC;QACxB,KAAK,EAAE,MAAM,CAAC;KACf,KAAK,IAAI,CAAC;CACZ,CAAC;AAEF;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,SAAS,kBAAkB,GAAG,gBAAgB,EAEpD,OAAO,EAAE,uCAAuC,CAAC,MAAM,CAAC,GAAG;IACzD,QAAQ,EAAE,MAAM,MAAM,CAAC;CACxB,GACA,8BAA8B,CA8ChC;AAED;;GAEG;AACH,wBAAgB,qCAAqC,CACnD,MAAM,SAAS,kBAAkB,GAAG,gBAAgB,EAEpD,OAAO,GAAE,uCAAuC,CAAC,MAAM,CAAM,GAC5D,qCAAqC,CAAC,MAAM,CAAC,CAyB/C"}

package/dist/blockDocumentRegistration.js

@@ -0,0 +1,68 @@
+import { DeckMapBlockSettings } from './BlockMapSettings';
+import { ensureDeckMapResourceState } from './block';
+export const DECK_MAP_BLOCK_TYPE = 'map';
+export const DECK_MAP_BLOCK_DEFAULT_TITLE = 'Embedded Map';
+export const DECK_MAP_BLOCK_DEFAULT_HEIGHT = 560;
+/**
+ * Builds the shared TipTap/UI registration metadata for a Deck map stateful
+ * block. Hosts still own renderer maps, delete handlers, and product labels.
+ */
+export function createDeckMapBlockDocumentType(options) {
+    const { getState, label = 'Map', description = 'Embedded Deck.gl map', defaultTitle = DECK_MAP_BLOCK_DEFAULT_TITLE, defaultHeight = DECK_MAP_BLOCK_DEFAULT_HEIGHT, minHeight = 360, maxHeight = 1600, afterEnsureState, } = options;
+    return {
+        blockType: DECK_MAP_BLOCK_TYPE,
+        label,
+        description,
+        resizableHeight: true,
+        defaultHeight,
+        minHeight,
+        maxHeight,
+        requireScrollModifier: true,
+        scrollHintLabel: 'this map',
+        settings: DeckMapBlockSettings,
+        hasOwnHeaderActions: true,
+        createNode: (blockId) => {
+            const state = getState();
+            ensureDeckMapResourceState(state, blockId, defaultTitle);
+            afterEnsureState?.({
+                state,
+                blockInstanceId: blockId,
+                title: defaultTitle,
+            });
+            return {
+                type: 'blockDocumentStatefulBlock',
+                attrs: {
+                    id: blockId,
+                    blockType: DECK_MAP_BLOCK_TYPE,
+                    blockInstanceId: blockId,
+                    ownership: 'owned',
+                    caption: '',
+                    height: defaultHeight,
+                },
+            };
+        },
+    };
+}
+/**
+ * Builds the shared command-type registration for a Deck map stateful block.
+ */
+export function createDeckMapBlockDocumentCommandType(options = {}) {
+    const { label = 'Map', description = 'Embedded Deck.gl map', defaultTitle = DECK_MAP_BLOCK_DEFAULT_TITLE, defaultHeight = DECK_MAP_BLOCK_DEFAULT_HEIGHT, afterEnsureState, } = options;
+    return {
+        blockType: DECK_MAP_BLOCK_TYPE,
+        label,
+        description,
+        defaultTitle,
+        defaultHeight,
+        ensureState: ({ state, blockInstanceId, title }) => {
+            const resolvedTitle = title ?? defaultTitle;
+            ensureDeckMapResourceState(state, blockInstanceId, resolvedTitle);
+            afterEnsureState?.({
+                state,
+                blockInstanceId,
+                title: resolvedTitle,
+            });
+        },
+    };
+}
+//# sourceMappingURL=blockDocumentRegistration.js.map

package/dist/blockDocumentRegistration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockDocumentRegistration.js","sourceRoot":"","sources":["../src/blockDocumentRegistration.ts"],"names":[],"mappings":"AAMA,OAAO,EAAC,oBAAoB,EAAC,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAC,0BAA0B,EAAC,MAAM,SAAS,CAAC;AAEnD,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AACzC,MAAM,CAAC,MAAM,4BAA4B,GAAG,cAAc,CAAC;AAC3D,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAG,CAAC;AA8BjD;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAG5C,OAEC;IAED,MAAM,EACJ,QAAQ,EACR,KAAK,GAAG,KAAK,EACb,WAAW,GAAG,sBAAsB,EACpC,YAAY,GAAG,4BAA4B,EAC3C,aAAa,GAAG,6BAA6B,EAC7C,SAAS,GAAG,GAAG,EACf,SAAS,GAAG,IAAI,EAChB,gBAAgB,GACjB,GAAG,OAAO,CAAC;IAEZ,OAAO;QACL,SAAS,EAAE,mBAAmB;QAC9B,KAAK;QACL,WAAW;QACX,eAAe,EAAE,IAAI;QACrB,aAAa;QACb,SAAS;QACT,SAAS;QACT,qBAAqB,EAAE,IAAI;QAC3B,eAAe,EAAE,UAAU;QAC3B,QAAQ,EAAE,oBAAoB;QAC9B,mBAAmB,EAAE,IAAI;QACzB,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE;YACtB,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;YACzB,0BAA0B,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;YACzD,gBAAgB,EAAE,CAAC;gBACjB,KAAK;gBACL,eAAe,EAAE,OAAO;gBACxB,KAAK,EAAE,YAAY;aACpB,CAAC,CAAC;YAEH,OAAO;gBACL,IAAI,EAAE,4BAA4B;gBAClC,KAAK,EAAE;oBACL,EAAE,EAAE,OAAO;oBACX,SAAS,EAAE,mBAAmB;oBAC9B,eAAe,EAAE,OAAO;oBACxB,SAAS,EAAE,OAAO;oBAClB,OAAO,EAAE,EAAE;oBACX,MAAM,EAAE,aAAa;iBACtB;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qCAAqC,CAGnD,UAA2D,EAAE;IAE7D,MAAM,EACJ,KAAK,GAAG,KAAK,EACb,WAAW,GAAG,sBAAsB,EACpC,YAAY,GAAG,4BAA4B,EAC3C,aAAa,GAAG,6BAA6B,EAC7C,gBAAgB,GACjB,GAAG,OAAO,CAAC;IAEZ,OAAO;QACL,SAAS,EAAE,mBAAmB;QAC9B,KAAK;QACL,WAAW;QACX,YAAY;QACZ,aAAa;QACb,WAAW,EAAE,CAAC,EAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAC,EAAE,EAAE;YAC/C,MAAM,aAAa,GAAG,KAAK,IAAI,YAAY,CAAC;YAC5C,0BAA0B,CAAC,KAAK,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC;YAClE,gBAAgB,EAAE,CAAC;gBACjB,KAAK;gBACL,eAAe;gBACf,KAAK,EAAE,aAAa;aACrB,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type {\n  BlockDocumentStatefulBlockCommandType,\n  BlockDocumentStatefulBlockType,\n} from '@sqlrooms/documents';\nimport type {DuckDbSliceState} from '@sqlrooms/duckdb';\nimport type {DeckMapsSliceState} from './DeckMapsSlice';\nimport {DeckMapBlockSettings} from './BlockMapSettings';\nimport {ensureDeckMapResourceState} from './block';\n\nexport const DECK_MAP_BLOCK_TYPE = 'map';\nexport const DECK_MAP_BLOCK_DEFAULT_TITLE = 'Embedded Map';\nexport const DECK_MAP_BLOCK_DEFAULT_HEIGHT = 560;\n\n/**\n * Options for configuring Deck map block document registration. Hosts pass\n * these to `createDeckMapBlockDocumentType` / `createDeckMapBlockDocumentCommandType`.\n */\nexport type DeckMapBlockDocumentRegistrationOptions<TState> = {\n  /** Product label for the map block (defaults to \"Map\"). */\n  label?: string;\n  /** Description shown in block pickers. */\n  description?: string;\n  /** Default caption/title used when ensuring state. */\n  defaultTitle?: string;\n  /** Default height in pixels for the map block. */\n  defaultHeight?: number;\n  /** Minimum resizable height in pixels. */\n  minHeight?: number;\n  /** Maximum resizable height in pixels. */\n  maxHeight?: number;\n  /**\n   * Called after Deck map state is ensured. Hosts can add product-specific\n   * side effects; delete/remove stays host-owned.\n   */\n  afterEnsureState?: (options: {\n    state: TState;\n    blockInstanceId: string;\n    title: string;\n  }) => void;\n};\n\n/**\n * Builds the shared TipTap/UI registration metadata for a Deck map stateful\n * block. Hosts still own renderer maps, delete handlers, and product labels.\n */\nexport function createDeckMapBlockDocumentType<\n  TState extends DeckMapsSliceState & DuckDbSliceState,\n>(\n  options: DeckMapBlockDocumentRegistrationOptions<TState> & {\n    getState: () => TState;\n  },\n): BlockDocumentStatefulBlockType {\n  const {\n    getState,\n    label = 'Map',\n    description = 'Embedded Deck.gl map',\n    defaultTitle = DECK_MAP_BLOCK_DEFAULT_TITLE,\n    defaultHeight = DECK_MAP_BLOCK_DEFAULT_HEIGHT,\n    minHeight = 360,\n    maxHeight = 1600,\n    afterEnsureState,\n  } = options;\n\n  return {\n    blockType: DECK_MAP_BLOCK_TYPE,\n    label,\n    description,\n    resizableHeight: true,\n    defaultHeight,\n    minHeight,\n    maxHeight,\n    requireScrollModifier: true,\n    scrollHintLabel: 'this map',\n    settings: DeckMapBlockSettings,\n    hasOwnHeaderActions: true,\n    createNode: (blockId) => {\n      const state = getState();\n      ensureDeckMapResourceState(state, blockId, defaultTitle);\n      afterEnsureState?.({\n        state,\n        blockInstanceId: blockId,\n        title: defaultTitle,\n      });\n\n      return {\n        type: 'blockDocumentStatefulBlock',\n        attrs: {\n          id: blockId,\n          blockType: DECK_MAP_BLOCK_TYPE,\n          blockInstanceId: blockId,\n          ownership: 'owned',\n          caption: '',\n          height: defaultHeight,\n        },\n      };\n    },\n  };\n}\n\n/**\n * Builds the shared command-type registration for a Deck map stateful block.\n */\nexport function createDeckMapBlockDocumentCommandType<\n  TState extends DeckMapsSliceState & DuckDbSliceState,\n>(\n  options: DeckMapBlockDocumentRegistrationOptions<TState> = {},\n): BlockDocumentStatefulBlockCommandType<TState> {\n  const {\n    label = 'Map',\n    description = 'Embedded Deck.gl map',\n    defaultTitle = DECK_MAP_BLOCK_DEFAULT_TITLE,\n    defaultHeight = DECK_MAP_BLOCK_DEFAULT_HEIGHT,\n    afterEnsureState,\n  } = options;\n\n  return {\n    blockType: DECK_MAP_BLOCK_TYPE,\n    label,\n    description,\n    defaultTitle,\n    defaultHeight,\n    ensureState: ({state, blockInstanceId, title}) => {\n      const resolvedTitle = title ?? defaultTitle;\n      ensureDeckMapResourceState(state, blockInstanceId, resolvedTitle);\n      afterEnsureState?.({\n        state,\n        blockInstanceId,\n        title: resolvedTitle,\n      });\n    },\n  };\n}\n"]}

package/dist/createDeckJsonSpecFromDatasets.d.ts

@@ -0,0 +1,11 @@
+import type { CreateDeckJsonSpecFromDatasetsOptions, DeckJsonMapSpec } from './types';
+/**
+ * Generate a conservative starter Deck JSON spec from SQLRooms datasets.
+ *
+ * The helper favors predictable defaults:
+ * native point/line/polygon datasets become the matching GeoArrow layer, while
+ * mixed or unsupported inputs fall back to `GeoJsonLayer`. Callers can provide
+ * semantic hints for special layers such as trips, arcs, H3, or heatmaps.
+ */
+export declare function createDeckJsonSpecFromDatasets(options: CreateDeckJsonSpecFromDatasetsOptions): DeckJsonMapSpec;
+//# sourceMappingURL=createDeckJsonSpecFromDatasets.d.ts.map

package/dist/createDeckJsonSpecFromDatasets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDeckJsonSpecFromDatasets.d.ts","sourceRoot":"","sources":["../src/createDeckJsonSpecFromDatasets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,qCAAqC,EACrC,eAAe,EAEhB,MAAM,SAAS,CAAC;AAuFjB;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,qCAAqC,GAC7C,eAAe,CAcjB"}

package/dist/createDeckJsonSpecFromDatasets.js

@@ -0,0 +1,85 @@
+import { toArrowTable } from './datasets/tableAdapter';
+import { prepareDeckDataset } from './prepare/prepareDeckDataset';
+function buildLayerConfig(options) {
+    const { datasetId, input, hint } = options;
+    return {
+        dataset: datasetId,
+        geometryColumn: input.geometryColumn,
+        geometryEncodingHint: input.geometryEncodingHint,
+        sourceGeometryColumn: hint?.sourceGeometryColumn,
+        targetGeometryColumn: hint?.targetGeometryColumn,
+        timestampColumn: hint?.timestampColumn,
+        hexagonColumn: hint?.hexagonColumn,
+    };
+}
+function resolveExplicitLayerType(hint) {
+    if (hint?.type) {
+        return hint.type;
+    }
+    if (hint?.prefer === 'heatmap') {
+        return 'GeoArrowHeatmapLayer';
+    }
+    return undefined;
+}
+function isArrowTableDatasetInput(input) {
+    return Boolean(input && typeof input === 'object' && 'arrowTable' in input);
+}
+function chooseDefaultLayerType(datasetId, input, hint) {
+    const explicitType = resolveExplicitLayerType(hint);
+    if (explicitType) {
+        return explicitType;
+    }
+    if (!isArrowTableDatasetInput(input) || !input.arrowTable) {
+        return 'GeoJsonLayer';
+    }
+    try {
+        const prepared = prepareDeckDataset({
+            datasetId,
+            table: toArrowTable(input.arrowTable),
+            geometryColumn: input.geometryColumn,
+            geometryEncodingHint: input.geometryEncodingHint,
+        });
+        const resolved = prepared.resolveGeometry();
+        switch (resolved.encoding) {
+            case 'geoarrow.point':
+            case 'geoarrow.multipoint':
+                return hint?.prefer === 'heatmap'
+                    ? 'GeoArrowHeatmapLayer'
+                    : 'GeoArrowScatterplotLayer';
+            case 'geoarrow.linestring':
+            case 'geoarrow.multilinestring':
+                return 'GeoArrowPathLayer';
+            case 'geoarrow.polygon':
+            case 'geoarrow.multipolygon':
+                return 'GeoArrowPolygonLayer';
+            default:
+                return 'GeoJsonLayer';
+        }
+    }
+    catch {
+        return 'GeoJsonLayer';
+    }
+}
+/**
+ * Generate a conservative starter Deck JSON spec from SQLRooms datasets.
+ *
+ * The helper favors predictable defaults:
+ * native point/line/polygon datasets become the matching GeoArrow layer, while
+ * mixed or unsupported inputs fall back to `GeoJsonLayer`. Callers can provide
+ * semantic hints for special layers such as trips, arcs, H3, or heatmaps.
+ */
+export function createDeckJsonSpecFromDatasets(options) {
+    const { datasets, hints } = options;
+    return {
+        layers: Object.entries(datasets).map(([datasetId, input]) => ({
+            '@@type': chooseDefaultLayerType(datasetId, input, hints?.[datasetId]),
+            id: datasetId,
+            _sqlroomsBinding: buildLayerConfig({
+                datasetId,
+                input,
+                hint: hints?.[datasetId],
+            }),
+        })),
+    };
+}
+//# sourceMappingURL=createDeckJsonSpecFromDatasets.js.map

package/dist/createDeckJsonSpecFromDatasets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDeckJsonSpecFromDatasets.js","sourceRoot":"","sources":["../src/createDeckJsonSpecFromDatasets.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  DeckArrowTableDatasetInput,\n  CreateDeckJsonSpecFromDatasetsOptions,\n  DeckJsonMapSpec,\n  DeckJsonSpecDatasetHint,\n} from './types';\nimport type {GeometryEncodingHint} from './prepare/types';\nimport {toArrowTable} from './datasets/tableAdapter';\nimport {prepareDeckDataset} from './prepare/prepareDeckDataset';\n\nfunction buildLayerConfig(options: {\n  datasetId: string;\n  input: {geometryColumn?: string; geometryEncodingHint?: GeometryEncodingHint};\n  hint?: DeckJsonSpecDatasetHint;\n}) {\n  const {datasetId, input, hint} = options;\n\n  return {\n    dataset: datasetId,\n    geometryColumn: input.geometryColumn,\n    geometryEncodingHint: input.geometryEncodingHint,\n    sourceGeometryColumn: hint?.sourceGeometryColumn,\n    targetGeometryColumn: hint?.targetGeometryColumn,\n    timestampColumn: hint?.timestampColumn,\n    hexagonColumn: hint?.hexagonColumn,\n  };\n}\n\nfunction resolveExplicitLayerType(hint?: DeckJsonSpecDatasetHint) {\n  if (hint?.type) {\n    return hint.type;\n  }\n\n  if (hint?.prefer === 'heatmap') {\n    return 'GeoArrowHeatmapLayer' as const;\n  }\n\n  return undefined;\n}\n\nfunction isArrowTableDatasetInput(\n  input: unknown,\n): input is DeckArrowTableDatasetInput {\n  return Boolean(input && typeof input === 'object' && 'arrowTable' in input);\n}\n\nfunction chooseDefaultLayerType(\n  datasetId: string,\n  input: {\n    geometryColumn?: string;\n    geometryEncodingHint?: GeometryEncodingHint;\n  },\n  hint?: DeckJsonSpecDatasetHint,\n) {\n  const explicitType = resolveExplicitLayerType(hint);\n  if (explicitType) {\n    return explicitType;\n  }\n\n  if (!isArrowTableDatasetInput(input) || !input.arrowTable) {\n    return 'GeoJsonLayer' as const;\n  }\n\n  try {\n    const prepared = prepareDeckDataset({\n      datasetId,\n      table: toArrowTable(input.arrowTable),\n      geometryColumn: input.geometryColumn,\n      geometryEncodingHint: input.geometryEncodingHint,\n    });\n    const resolved = prepared.resolveGeometry();\n\n    switch (resolved.encoding) {\n      case 'geoarrow.point':\n      case 'geoarrow.multipoint':\n        return hint?.prefer === 'heatmap'\n          ? ('GeoArrowHeatmapLayer' as const)\n          : ('GeoArrowScatterplotLayer' as const);\n      case 'geoarrow.linestring':\n      case 'geoarrow.multilinestring':\n        return 'GeoArrowPathLayer' as const;\n      case 'geoarrow.polygon':\n      case 'geoarrow.multipolygon':\n        return 'GeoArrowPolygonLayer' as const;\n      default:\n        return 'GeoJsonLayer' as const;\n    }\n  } catch {\n    return 'GeoJsonLayer' as const;\n  }\n}\n\n/**\n * Generate a conservative starter Deck JSON spec from SQLRooms datasets.\n *\n * The helper favors predictable defaults:\n * native point/line/polygon datasets become the matching GeoArrow layer, while\n * mixed or unsupported inputs fall back to `GeoJsonLayer`. Callers can provide\n * semantic hints for special layers such as trips, arcs, H3, or heatmaps.\n */\nexport function createDeckJsonSpecFromDatasets(\n  options: CreateDeckJsonSpecFromDatasetsOptions,\n): DeckJsonMapSpec {\n  const {datasets, hints} = options;\n\n  return {\n    layers: Object.entries(datasets).map(([datasetId, input]) => ({\n      '@@type': chooseDefaultLayerType(datasetId, input, hints?.[datasetId]),\n      id: datasetId,\n      _sqlroomsBinding: buildLayerConfig({\n        datasetId,\n        input,\n        hint: hints?.[datasetId],\n      }),\n    })),\n  };\n}\n"]}

package/dist/createOrUpdateDeckMapResource.d.ts

@@ -0,0 +1,81 @@
+import type { DeckMapResource } from './DeckMapsSlice';
+import type { DeckMapConfig } from './mapConfig';
+/**
+ * Host callbacks used to coordinate a durable Deck map resource with its block
+ * document container, table registry, and optional config preparation.
+ */
+export type CreateOrUpdateDeckMapResourceHost = {
+    ensureBlockDocument: (blockDocumentId: string) => void;
+    findMapBlock: (blockDocumentId: string, mapId: string) => {
+        blockId: string;
+        mapId: string;
+        caption?: string;
+    } | undefined;
+    findMap: (mapId: string) => DeckMapResource | undefined;
+    createMapBlock: (options: {
+        blockDocumentId: string;
+        mapId: string;
+        title: string;
+        caption?: string;
+        intent?: string;
+        height?: number;
+    }) => Promise<{
+        blockId: string;
+        mapId: string;
+    }>;
+    updateBlockMetadata: (options: {
+        blockDocumentId: string;
+        blockId: string;
+        caption?: string;
+        intent?: string;
+        height?: number;
+    }) => void | Promise<void>;
+    ensureMap: (mapId: string, title: string) => void;
+    writeMap: (options: {
+        mapId: string;
+        title: string;
+        config: DeckMapConfig;
+        selectedTable?: string;
+    }) => void | Promise<void>;
+    findTable: (tableName: string) => {
+        tableIdentity: string;
+    } | undefined;
+    prepareConfig?: (options: {
+        config: DeckMapConfig;
+        existingMapConfig?: DeckMapConfig;
+        tableName?: string;
+        replaceLayers?: boolean;
+        replaceDatasets?: boolean;
+    }) => DeckMapConfig | Promise<DeckMapConfig>;
+};
+/** Input for creating or updating a Deck map resource and its owning block. */
+export type CreateOrUpdateDeckMapResourceParams = {
+    blockDocumentId: string;
+    config: DeckMapConfig;
+    mapId?: string;
+    tableName?: string;
+    title?: string;
+    caption?: string;
+    intent?: string;
+    height?: number;
+    /** Treat `config.spec.layers` as the complete replacement layer list. */
+    replaceLayers?: boolean;
+    /** Treat `config.datasets` as the complete replacement dataset registry. */
+    replaceDatasets?: boolean;
+    requireTableNameForSqlOnlyUpdate?: boolean;
+    artifactLabel?: string;
+    createMapId?: () => string;
+    missingMapBlockBehavior?: 'throw' | 'create';
+};
+/** Result identities and resolved table selection from a map resource write. */
+export type CreateOrUpdateDeckMapResourceResult = {
+    blockDocumentId: string;
+    blockId: string;
+    mapId: string;
+    selectedTable?: string;
+    message: string;
+    created: boolean;
+};
+/** Resource-native worksheet map orchestration with metadata-after-map-write ordering. */
+export declare function createOrUpdateDeckMapResource(host: CreateOrUpdateDeckMapResourceHost, params: CreateOrUpdateDeckMapResourceParams): Promise<CreateOrUpdateDeckMapResourceResult>;
+//# sourceMappingURL=createOrUpdateDeckMapResource.d.ts.map

package/dist/createOrUpdateDeckMapResource.d.ts.map

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

package/dist/createOrUpdateDeckMapResource.js

@@ -0,0 +1,82 @@
+import { getFirstDatasetSourceTableName, hasSqlOnlyDatasetSource, } from './datasetSourceUtils';
+import { assertDeckMapResourceConfig } from './mapResourceAuthoring';
+/** Resource-native worksheet map orchestration with metadata-after-map-write ordering. */
+export async function createOrUpdateDeckMapResource(host, params) {
+    const artifactLabel = params.artifactLabel ?? 'block document';
+    host.ensureBlockDocument(params.blockDocumentId);
+    const existingBlock = params.mapId
+        ? host.findMapBlock(params.blockDocumentId, params.mapId)
+        : undefined;
+    const missingBehavior = params.missingMapBlockBehavior ?? 'throw';
+    if (params.mapId && !existingBlock && missingBehavior === 'throw') {
+        throw new Error(`${artifactLabel} map block ${params.mapId} was not found in ${params.blockDocumentId}`);
+    }
+    const mapId = existingBlock?.mapId ?? params.mapId ?? params.createMapId?.();
+    if (!mapId)
+        throw new Error('mapId is required when creating a map block');
+    const existingMap = host.findMap(mapId);
+    const requestedTable = params.tableName ?? getFirstDatasetSourceTableName(params.config);
+    const preparedConfig = host.prepareConfig
+        ? await host.prepareConfig({
+            config: params.config,
+            existingMapConfig: existingMap?.config,
+            tableName: requestedTable,
+            replaceLayers: params.replaceLayers,
+            replaceDatasets: params.replaceDatasets,
+        })
+        : params.config;
+    assertDeckMapResourceConfig(preparedConfig);
+    const tableName = requestedTable ?? getFirstDatasetSourceTableName(preparedConfig);
+    if ((params.requireTableNameForSqlOnlyUpdate ?? true) &&
+        existingBlock &&
+        !tableName &&
+        hasSqlOnlyDatasetSource(params.config)) {
+        throw new Error(`tableName is required when updating a ${artifactLabel} map block with SQL-only dataset sources.`);
+    }
+    const table = tableName ? host.findTable(tableName) : undefined;
+    if (tableName && !table)
+        throw new Error(`Table "${tableName}" was not found.`);
+    const caption = params.caption?.trim() ||
+        params.title?.trim() ||
+        existingBlock?.caption?.trim() ||
+        existingMap?.title?.trim() ||
+        'Map';
+    const title = params.title?.trim() || caption;
+    const created = !existingBlock;
+    const block = existingBlock ??
+        (await host.createMapBlock({
+            blockDocumentId: params.blockDocumentId,
+            mapId,
+            title,
+            caption,
+            intent: params.intent,
+            height: params.height,
+        }));
+    host.ensureMap(block.mapId, title);
+    await host.writeMap({
+        mapId: block.mapId,
+        title,
+        config: preparedConfig,
+        selectedTable: table?.tableIdentity,
+    });
+    if (existingBlock) {
+        await host.updateBlockMetadata({
+            blockDocumentId: params.blockDocumentId,
+            blockId: block.blockId,
+            caption,
+            intent: params.intent,
+            height: params.height,
+        });
+    }
+    return {
+        blockDocumentId: params.blockDocumentId,
+        blockId: block.blockId,
+        mapId: block.mapId,
+        selectedTable: table?.tableIdentity,
+        created,
+        message: created
+            ? `Added ${artifactLabel} map block "${title}".`
+            : `Updated ${artifactLabel} map block "${title}".`,
+    };
+}
+//# sourceMappingURL=createOrUpdateDeckMapResource.js.map

package/dist/createOrUpdateDeckMapResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createOrUpdateDeckMapResource.js","sourceRoot":"","sources":["../src/createOrUpdateDeckMapResource.ts"],"names":[],"mappings":"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","sourcesContent":["import type {DeckMapResource} from './DeckMapsSlice';\nimport type {DeckMapConfig} from './mapConfig';\nimport {\n  getFirstDatasetSourceTableName,\n  hasSqlOnlyDatasetSource,\n} from './datasetSourceUtils';\nimport {assertDeckMapResourceConfig} from './mapResourceAuthoring';\n\n/**\n * Host callbacks used to coordinate a durable Deck map resource with its block\n * document container, table registry, and optional config preparation.\n */\nexport type CreateOrUpdateDeckMapResourceHost = {\n  ensureBlockDocument: (blockDocumentId: string) => void;\n  findMapBlock: (\n    blockDocumentId: string,\n    mapId: string,\n  ) => {blockId: string; mapId: string; caption?: string} | undefined;\n  findMap: (mapId: string) => DeckMapResource | undefined;\n  createMapBlock: (options: {\n    blockDocumentId: string;\n    mapId: string;\n    title: string;\n    caption?: string;\n    intent?: string;\n    height?: number;\n  }) => Promise<{blockId: string; mapId: string}>;\n  updateBlockMetadata: (options: {\n    blockDocumentId: string;\n    blockId: string;\n    caption?: string;\n    intent?: string;\n    height?: number;\n  }) => void | Promise<void>;\n  ensureMap: (mapId: string, title: string) => void;\n  writeMap: (options: {\n    mapId: string;\n    title: string;\n    config: DeckMapConfig;\n    selectedTable?: string;\n  }) => void | Promise<void>;\n  findTable: (tableName: string) => {tableIdentity: string} | undefined;\n  prepareConfig?: (options: {\n    config: DeckMapConfig;\n    existingMapConfig?: DeckMapConfig;\n    tableName?: string;\n    replaceLayers?: boolean;\n    replaceDatasets?: boolean;\n  }) => DeckMapConfig | Promise<DeckMapConfig>;\n};\n\n/** Input for creating or updating a Deck map resource and its owning block. */\nexport type CreateOrUpdateDeckMapResourceParams = {\n  blockDocumentId: string;\n  config: DeckMapConfig;\n  mapId?: string;\n  tableName?: string;\n  title?: string;\n  caption?: string;\n  intent?: string;\n  height?: number;\n  /** Treat `config.spec.layers` as the complete replacement layer list. */\n  replaceLayers?: boolean;\n  /** Treat `config.datasets` as the complete replacement dataset registry. */\n  replaceDatasets?: boolean;\n  requireTableNameForSqlOnlyUpdate?: boolean;\n  artifactLabel?: string;\n  createMapId?: () => string;\n  missingMapBlockBehavior?: 'throw' | 'create';\n};\n\n/** Result identities and resolved table selection from a map resource write. */\nexport type CreateOrUpdateDeckMapResourceResult = {\n  blockDocumentId: string;\n  blockId: string;\n  mapId: string;\n  selectedTable?: string;\n  message: string;\n  created: boolean;\n};\n\n/** Resource-native worksheet map orchestration with metadata-after-map-write ordering. */\nexport async function createOrUpdateDeckMapResource(\n  host: CreateOrUpdateDeckMapResourceHost,\n  params: CreateOrUpdateDeckMapResourceParams,\n): Promise<CreateOrUpdateDeckMapResourceResult> {\n  const artifactLabel = params.artifactLabel ?? 'block document';\n  host.ensureBlockDocument(params.blockDocumentId);\n  const existingBlock = params.mapId\n    ? host.findMapBlock(params.blockDocumentId, params.mapId)\n    : undefined;\n  const missingBehavior = params.missingMapBlockBehavior ?? 'throw';\n  if (params.mapId && !existingBlock && missingBehavior === 'throw') {\n    throw new Error(\n      `${artifactLabel} map block ${params.mapId} was not found in ${params.blockDocumentId}`,\n    );\n  }\n  const mapId = existingBlock?.mapId ?? params.mapId ?? params.createMapId?.();\n  if (!mapId) throw new Error('mapId is required when creating a map block');\n\n  const existingMap = host.findMap(mapId);\n  const requestedTable =\n    params.tableName ?? getFirstDatasetSourceTableName(params.config);\n  const preparedConfig = host.prepareConfig\n    ? await host.prepareConfig({\n        config: params.config,\n        existingMapConfig: existingMap?.config,\n        tableName: requestedTable,\n        replaceLayers: params.replaceLayers,\n        replaceDatasets: params.replaceDatasets,\n      })\n    : params.config;\n  assertDeckMapResourceConfig(preparedConfig);\n  const tableName =\n    requestedTable ?? getFirstDatasetSourceTableName(preparedConfig);\n  if (\n    (params.requireTableNameForSqlOnlyUpdate ?? true) &&\n    existingBlock &&\n    !tableName &&\n    hasSqlOnlyDatasetSource(params.config)\n  ) {\n    throw new Error(\n      `tableName is required when updating a ${artifactLabel} map block with SQL-only dataset sources.`,\n    );\n  }\n  const table = tableName ? host.findTable(tableName) : undefined;\n  if (tableName && !table)\n    throw new Error(`Table \"${tableName}\" was not found.`);\n\n  const caption =\n    params.caption?.trim() ||\n    params.title?.trim() ||\n    existingBlock?.caption?.trim() ||\n    existingMap?.title?.trim() ||\n    'Map';\n  const title = params.title?.trim() || caption;\n  const created = !existingBlock;\n  const block =\n    existingBlock ??\n    (await host.createMapBlock({\n      blockDocumentId: params.blockDocumentId,\n      mapId,\n      title,\n      caption,\n      intent: params.intent,\n      height: params.height,\n    }));\n  host.ensureMap(block.mapId, title);\n  await host.writeMap({\n    mapId: block.mapId,\n    title,\n    config: preparedConfig,\n    selectedTable: table?.tableIdentity,\n  });\n  if (existingBlock) {\n    await host.updateBlockMetadata({\n      blockDocumentId: params.blockDocumentId,\n      blockId: block.blockId,\n      caption,\n      intent: params.intent,\n      height: params.height,\n    });\n  }\n  return {\n    blockDocumentId: params.blockDocumentId,\n    blockId: block.blockId,\n    mapId: block.mapId,\n    selectedTable: table?.tableIdentity,\n    created,\n    message: created\n      ? `Added ${artifactLabel} map block \"${title}\".`\n      : `Updated ${artifactLabel} map block \"${title}\".`,\n  };\n}\n"]}

package/dist/dashboard.d.ts

@@ -0,0 +1,6 @@
+import { type MosaicDashboardPanelRenderer } from '@sqlrooms/mosaic';
+import { createDeckMapBoundsQuery } from './useDeckMapFitToBounds';
+export { createDeckMapBoundsQuery };
+export declare const deckMapDashboardPanelRenderer: MosaicDashboardPanelRenderer;
+export declare const deckMapDashboardAddPanelAction: import('@sqlrooms/mosaic').MosaicDashboardAddPanelAction;
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../src/dashboard.tsx"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,4BAA4B,EASlC,MAAM,kBAAkB,CAAC;AAwB1B,OAAO,EAGL,wBAAwB,EACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAC,wBAAwB,EAAC,CAAC;AAimBlC,eAAO,MAAM,6BAA6B,EAAE,4BAK3C,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,OAAO,kBAAkB,EAAE,6BAuBrE,CAAC"}