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

package/README.md

@@ -7,7 +7,16 @@ Use this package when you want a **map-first analytics experience** in a SQLRoom
 - `createKeplerSlice()` to add Kepler state/actions to your Room store
 - `KeplerMapContainer` and `KeplerPlotContainer` for rendering maps/overlays
 - `KeplerSidePanels` for layer/filter/interaction UI
-- utilities for map config persistence and dataset synchronization
+- utilities for map config persistence, dataset synchronization, and migration
+  from legacy Kepler-owned tabs to artifact-backed tabs
+
+## Selection model
+
+- `createKeplerSlice()` manages Kepler map documents and runtime state keyed by
+  map id, but it does not own host-level map selection.
+- Render maps with explicit ids, for example `<KeplerMapContainer mapId={id} />`.
+- Use `@sqlrooms/artifacts` when an app needs multiple user-managed map tabs;
+  artifact state should own the selected map artifact.
 
 ## Installation
 
@@ -51,7 +60,7 @@ export const {roomStore, useRoomStore} = createRoomStore<RoomState>(
 );
 
 function MapPanel() {
-  const mapId = useRoomStore((state) => state.kepler.config.currentMapId);
+  const mapId = useRoomStore((state) => state.kepler.config.maps[0]?.id);
   const addTableToMap = useRoomStore((state) => state.kepler.addTableToMap);
   const isTableReady = useRoomStore((state) =>
     Boolean(state.db.findTableByName('earthquakes')),
@@ -94,6 +103,7 @@ createKeplerSlice({
 
 ## Related packages
 
+- `@sqlrooms/artifacts` for artifact-backed map tabs
 - `@sqlrooms/kepler-config` for Zod schemas used by persisted Kepler config
 - `@sqlrooms/room-shell` for Room store composition and UI shell
 - `@sqlrooms/duckdb` for DuckDB-backed table loading/querying

package/dist/KeplerSlice.d.ts

@@ -1,7 +1,6 @@
 import { VectorTileDatasetMetadata } from '@kepler.gl/constants';
-import { Layer } from '@kepler.gl/layers';
 import { KeplerGlState } from '@kepler.gl/reducers';
-import { AddDataToMapPayload } from '@kepler.gl/types';
+import { AddDataToMapPayload, MinSavedLayer, ParsedLayer } from '@kepler.gl/types';
 import { KeplerApplicationConfig } from '@kepler.gl/utils';
 import { KeplerMapSchema, KeplerSliceConfig } from '@sqlrooms/kepler-config';
 import { RoomShellSliceState, type StateCreator } from '@sqlrooms/room-shell';
@@ -11,9 +10,15 @@ import { ReduxLoggerOptions } from 'redux-logger';
 export type KeplerGLBasicProps = {
     mapboxApiAccessToken?: string;
 };
+export type CreateInitialMapKeplerStateContext = {
+    reason: 'initialize' | 'create-map' | 'duplicate-map' | 'register-map' | 'sync-config';
+    defaultInitialMapKeplerState: Partial<KeplerGlState>;
+    mapId?: string;
+    name?: string;
+};
 export type CreateKeplerSliceOptions = {
     config?: Partial<KeplerSliceConfig>;
-    initialKeplerState?: Partial<KeplerGlState>;
+    createInitialMapKeplerState?: (context: CreateInitialMapKeplerStateContext) => Partial<KeplerGlState>;
     basicKeplerProps?: Partial<KeplerGLBasicProps>;
     actionLogging?: boolean | ReduxLoggerOptions;
     middlewares?: Middleware[];
@@ -49,14 +54,23 @@ export type KeplerSliceState = {
             [mapId: string]: Dispatch;
         };
         initialize: () => Promise<void>;
+        destroy: () => Promise<void>;
         setConfig: (config: KeplerSliceConfig) => void;
         /**
          * Update the datasets in all the kepler map so that they correspond to
          * the latest table schemas in the database
          */
         syncKeplerDatasets: () => Promise<void>;
-        addLayer: (mapId: string, layer: Layer, datasetId: string) => void;
-        addTableToMap: (mapId: string, tableName: string, options?: AddDataToMapPayload['options']) => Promise<void>;
+        addLayer: (mapId: string, layer: ParsedLayer | MinSavedLayer | undefined, datasetId: string) => void;
+        addFilter: (mapId: string, datasetId: string) => void;
+        setFilter: (mapId: string, filterIdx: number, prop: string | string[], value: any, valueIndex?: number) => void;
+        setFilterAnimationTime: (mapId: string, filterIdx: number, prop: string, value: any) => void;
+        setFilterAnimationWindow: (mapId: string, filterId: string, animationWindow: string) => void;
+        setFilterView: (mapId: string, filterIdx: number, view: 'side' | 'enlarged' | 'minified') => void;
+        updateTooltipFields: (mapId: string, datasetId: string, fieldNames: string[]) => void;
+        toggleSplitMap: (mapId: string, index?: number) => void;
+        toggleLayerForMap: (mapId: string, mapIndex: number, layerId: string) => void;
+        addTableToMap: (mapId: string, tableName: string, options?: AddDataToMapPayload['options'], config?: AddDataToMapPayload['config']) => Promise<void>;
         addTileSetToMap: (mapId: string, tableName: string, tileset: {
             name: string;
             type: string;
@@ -65,23 +79,27 @@ export type KeplerSliceState = {
         addConfigToMap: (mapId: string, config: KeplerMapSchema) => void;
         removeDatasetFromMaps: (datasetId: string) => void;
         dispatchAction: (mapId: string, action: KeplerAction) => void;
-        setCurrentMapId: (mapId: string) => void;
+        ensureMap: (mapId: string, name?: string) => void;
         /**
          * Create a new map and return the map id
          * @param name - The name of the map
          * @returns The map id
          */
-        createMap: (name?: string) => string;
+        createMap: (name?: string, options?: {
+            id?: string;
+        }) => string;
         deleteMap: (mapId: string) => void;
+        duplicateMap: (mapId: string) => Promise<{
+            success: boolean;
+            message?: string;
+            code?: string;
+        }>;
         renameMap: (mapId: string, name: string) => void;
-        closeMap: (mapId: string) => void;
-        setOpenTabs: (tabIds: string[]) => void;
-        getCurrentMap: () => KeplerMapSchema | undefined;
         registerKeplerMapIfNotExists: (mapId: string) => void;
         __reduxProviderStore: ReduxStore<KeplerGlReduxState, AnyAction> | undefined;
     };
 };
-export declare function createKeplerSlice({ basicKeplerProps, config: initialConfigProps, initialKeplerState, actionLogging, middlewares: additionalMiddlewares, applicationConfig, onAction, }?: CreateKeplerSliceOptions): StateCreator<KeplerSliceState>;
+export declare function createKeplerSlice({ basicKeplerProps, config: initialConfigProps, createInitialMapKeplerState, actionLogging, middlewares: additionalMiddlewares, applicationConfig, onAction, }?: CreateKeplerSliceOptions): StateCreator<KeplerSliceState>;
 type RoomStateWithDiscuss = RoomShellSliceState & KeplerSliceState;
 export declare function useStoreWithKepler<T>(selector: (state: RoomStateWithDiscuss) => T): T;
 export {};

package/dist/KeplerSlice.d.ts.map

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

package/dist/KeplerSlice.js

@@ -1,4 +1,4 @@
-import { addDataToMap, addLayer as addLayerAction, deleteEntry, ActionTypes as KeplerActionTypes, registerEntry, removeDataset, requestMapStyles, wrapTo, } from '@kepler.gl/actions';
+import { addDataToMap, addFilter as addFilterAction, addLayer as addLayerAction, deleteEntry, interactionConfigChange, ActionTypes as KeplerActionTypes, registerEntry, removeDataset, requestMapStyles, setFilter as setFilterAction, setFilterAnimationTime as setFilterAnimationTimeAction, setFilterAnimationWindow as setFilterAnimationWindowAction, setFilterView as setFilterViewAction, toggleLayerForMap as toggleLayerForMapAction, toggleSplitMap as toggleSplitMapAction, wrapTo, } from '@kepler.gl/actions';
 import { ALL_FIELD_TYPES } from '@kepler.gl/constants';
 import { castDuckDBTypesForKepler, getDuckDBColumnTypes, getDuckDBColumnTypesMap, restoreGeoarrowMetadata, setGeoArrowWKBExtension, } from '@kepler.gl/duckdb';
 import { arrowSchemaToFields } from '@kepler.gl/processors';
@@ -7,7 +7,9 @@ import { KeplerGLSchemaClass } from '@kepler.gl/schemas';
 import { KeplerTable } from '@kepler.gl/table';
 import { initApplicationConfig, } from '@kepler.gl/utils';
 import { createId } from '@paralleldrive/cuid2';
+import { KeplerSliceConfig } from '@sqlrooms/kepler-config';
 import { createSlice, useBaseRoomShellStore, } from '@sqlrooms/room-shell';
+import { getTheme } from '@sqlrooms/ui';
 import { produce, setAutoFreeze } from 'immer';
 import { taskMiddleware } from 'react-palm/tasks';
 import { compose } from 'redux';
@@ -20,9 +22,39 @@ class DesktopKeplerTable extends KeplerTable {
         return (d) => d;
     };
 }
+function createDefaultMapKeplerState(resolvedTheme) {
+    return {
+        mapStyle: {
+            styleType: resolvedTheme === 'dark' ? 'dark-matter' : 'positron',
+        },
+        uiState: {
+            ...INITIAL_UI_STATE,
+            currentModal: null,
+            mapControls: {
+                visibleLayers: INITIAL_UI_STATE.mapControls.visibleLayers,
+                splitMap: {
+                    show: true,
+                    active: false,
+                },
+                mapLegend: {
+                    show: true,
+                    active: false,
+                },
+                toggle3d: {
+                    show: true,
+                    active: false,
+                },
+                mapDraw: {
+                    show: true,
+                    active: false,
+                },
+            },
+        },
+    };
+}
 export function createDefaultKeplerConfig(props) {
     const mapId = createId();
-    return {
+    const config = {
         maps: [
             {
                 id: mapId,
@@ -31,10 +63,9 @@ export function createDefaultKeplerConfig(props) {
                 lastOpenedAt: Date.now(),
             },
         ],
-        currentMapId: mapId,
-        openTabs: [mapId],
         ...props,
     };
+    return KeplerSliceConfig.parse(config);
 }
 export function hasMapId(action) {
     return (typeof action.payload === 'object' &&
@@ -51,37 +82,38 @@ const SKIP_AUTO_SAVE_ACTIONS = [
     KeplerActionTypes.UPDATE_MAP,
     KeplerActionTypes.MOUSE_MOVE,
 ];
-export function createKeplerSlice({ basicKeplerProps = {}, config: initialConfigProps, initialKeplerState = {
-    mapStyle: { styleType: 'positron' },
-    uiState: {
-        ...INITIAL_UI_STATE,
-        currentModal: null,
-        mapControls: {
-            visibleLayers: INITIAL_UI_STATE.mapControls.visibleLayers,
-            mapLegend: {
-                show: true,
-                active: false,
-            },
-            toggle3d: {
-                show: true,
-                active: false,
-            },
-        },
-    },
-}, actionLogging = false, middlewares: additionalMiddlewares = [], applicationConfig, onAction, } = {}) {
+export function createKeplerSlice({ basicKeplerProps = {}, config: initialConfigProps, createInitialMapKeplerState, actionLogging = false, middlewares: additionalMiddlewares = [], applicationConfig, onAction, } = {}) {
     const initialConfig = createDefaultKeplerConfig(initialConfigProps);
     initApplicationConfig({
         table: DesktopKeplerTable,
         ...applicationConfig,
     });
+    let syncKeplerPromise = null;
+    // When a caller arrives while a sync is already in-flight, the in-flight run
+    // may have captured a stale snapshot of db.tables/kepler.map (missing maps or
+    // tables added by createMap, duplicateMap, etc.). Setting this flag tells the
+    // active run to loop once more with a fresh snapshot after it finishes, so
+    // late mutations are never silently dropped.
+    let pendingKeplerSync = false;
     const updateMapLastOpenedAt = (maps, mapId, now = Date.now()) => {
         const map = maps.find((item) => item.id === mapId);
         if (map) {
             map.lastOpenedAt = now;
         }
     };
-    return createSlice((set, get) => {
-        const keplerReducer = keplerGlReducer.initialState(initialKeplerState);
+    return createSlice((set, get, _store) => {
+        function resolveInitialMapKeplerState(context) {
+            const resolvedTheme = getTheme();
+            const defaultInitialMapKeplerState = createDefaultMapKeplerState(resolvedTheme);
+            return (createInitialMapKeplerState?.({
+                ...context,
+                defaultInitialMapKeplerState,
+            }) ?? defaultInitialMapKeplerState);
+        }
+        function createKeplerReducer(context) {
+            return keplerGlReducer.initialState(resolveInitialMapKeplerState(context));
+        }
+        const keplerReducer = createKeplerReducer({ reason: 'initialize' });
         const middlewares = [
             taskMiddleware,
             saveKeplerConfigMiddleware,
@@ -116,18 +148,22 @@ export function createKeplerSlice({ basicKeplerProps = {}, config: initialConfig
                 __reduxProviderStore: undefined,
                 forwardDispatch: {},
                 setConfig: (config) => {
+                    const nextConfig = KeplerSliceConfig.parse(config);
                     set((state) => produce(state, (draft) => {
-                        draft.kepler.config = config;
+                        draft.kepler.config = nextConfig;
                     }));
                     updateMapReduxStates();
                     updateForwardDispatch();
-                    updateMapConfigs();
                     get().kepler.syncKeplerDatasets();
+                    updateMapConfigs();
                 },
                 async initialize() {
                     const config = get().kepler.config;
-                    const currentMapId = config.currentMapId;
-                    const keplerInitialState = keplerReducer(undefined, registerEntry({ id: currentMapId }));
+                    const keplerInitialState = config.maps.reduce((mapState, map) => createKeplerReducer({
+                        reason: 'initialize',
+                        mapId: map.id,
+                        name: map.name,
+                    })(mapState, registerEntry({ id: map.id })), {});
                     set({
                         kepler: {
                             ...get().kepler,
@@ -153,15 +189,77 @@ export function createKeplerSlice({ basicKeplerProps = {}, config: initialConfig
                         },
                     });
                     updateForwardDispatch();
-                    updateMapConfigs();
                     await get().kepler.syncKeplerDatasets();
-                    requestMapStyle(config.currentMapId);
+                    updateMapConfigs();
+                    for (const mapId of Object.keys(get().kepler.map)) {
+                        requestMapStyle(mapId);
+                    }
+                },
+                async destroy() {
+                    // no-op
                 },
                 addLayer: (mapId, layer, datasetId) => {
                     get().kepler.registerKeplerMapIfNotExists(mapId);
                     get().kepler.dispatchAction(mapId, addLayerAction(layer, datasetId));
                 },
-                addTableToMap: async (mapId, tableName, options = {}) => {
+                addFilter: (mapId, datasetId) => {
+                    get().kepler.registerKeplerMapIfNotExists(mapId);
+                    get().kepler.dispatchAction(mapId, addFilterAction(datasetId));
+                },
+                setFilter: (mapId, filterIdx, prop, value, valueIndex) => {
+                    get().kepler.registerKeplerMapIfNotExists(mapId);
+                    get().kepler.dispatchAction(mapId, setFilterAction(filterIdx, prop, value, valueIndex));
+                },
+                setFilterAnimationTime: (mapId, filterIdx, prop, value) => {
+                    get().kepler.registerKeplerMapIfNotExists(mapId);
+                    get().kepler.dispatchAction(mapId, setFilterAnimationTimeAction(filterIdx, prop, value));
+                },
+                setFilterAnimationWindow: (mapId, filterId, animationWindow) => {
+                    get().kepler.registerKeplerMapIfNotExists(mapId);
+                    get().kepler.dispatchAction(mapId, setFilterAnimationWindowAction({ id: filterId, animationWindow }));
+                },
+                setFilterView: (mapId, filterIdx, view) => {
+                    get().kepler.registerKeplerMapIfNotExists(mapId);
+                    get().kepler.dispatchAction(mapId, setFilterViewAction(filterIdx, view));
+                },
+                updateTooltipFields: (mapId, datasetId, fieldNames) => {
+                    get().kepler.registerKeplerMapIfNotExists(mapId);
+                    const mapState = get().kepler.map[mapId];
+                    const tooltipConfig = mapState?.visState?.interactionConfig?.tooltip;
+                    if (!tooltipConfig)
+                        return;
+                    const currentFieldsToShow = tooltipConfig.config?.fieldsToShow || {};
+                    const existingFields = currentFieldsToShow[datasetId] || [];
+                    const existingByName = new Map(existingFields.map((field) => [
+                        field.name,
+                        field,
+                    ]));
+                    const nextFields = Array.from(new Set(fieldNames)).map((name) => existingByName.get(name) ?? { name, format: null });
+                    if (nextFields.length === existingFields.length &&
+                        nextFields.every((field, index) => field.name === existingFields[index]?.name &&
+                            field.format === existingFields[index]?.format)) {
+                        return;
+                    }
+                    get().kepler.dispatchAction(mapId, interactionConfigChange({
+                        ...tooltipConfig,
+                        config: {
+                            ...tooltipConfig.config,
+                            fieldsToShow: {
+                                ...currentFieldsToShow,
+                                [datasetId]: nextFields,
+                            },
+                        },
+                    }));
+                },
+                toggleSplitMap: (mapId, index) => {
+                    get().kepler.registerKeplerMapIfNotExists(mapId);
+                    get().kepler.dispatchAction(mapId, toggleSplitMapAction(index));
+                },
+                toggleLayerForMap: (mapId, mapIndex, layerId) => {
+                    get().kepler.registerKeplerMapIfNotExists(mapId);
+                    get().kepler.dispatchAction(mapId, toggleLayerForMapAction(mapIndex, layerId));
+                },
+                addTableToMap: async (mapId, tableName, options = {}, config = {}) => {
                     const connector = await get().db.getConnector();
                     const duckDbColumns = await getDuckDBColumnTypes({
                         query: (query) => connector.query(query).result,
@@ -180,93 +278,141 @@ export function createKeplerSlice({ basicKeplerProps = {}, config: initialConfig
                             info: { label: tableName, id: tableName },
                             metadata: { tableName },
                         };
-                        get().kepler.dispatchAction(mapId, addDataToMap({ datasets, options }));
+                        get().kepler.dispatchAction(mapId, addDataToMap({ datasets, options, config }));
                     }
                 },
-                getCurrentMap: () => {
-                    return get().kepler.config.maps.find((map) => map.id === get().kepler.config.currentMapId);
-                },
-                setCurrentMapId: (mapId) => {
-                    return set((state) => produce(state, (draft) => {
-                        const now = Date.now();
-                        draft.kepler.config.currentMapId = mapId;
-                        updateMapLastOpenedAt(draft.kepler.config.maps, mapId, now);
-                    }));
-                },
-                createMap: (name) => {
-                    const mapId = createId();
+                ensureMap: (mapId, name) => {
                     const now = Date.now();
                     set((state) => produce(state, (draft) => {
+                        const existing = draft.kepler.config.maps.find((map) => map.id === mapId);
+                        if (existing) {
+                            if (name && existing.name !== name) {
+                                existing.name = name;
+                            }
+                            return;
+                        }
                         draft.kepler.config.maps.push({
                             id: mapId,
                             name: name ?? 'Untitled Map',
                             lastOpenedAt: now,
                         });
-                        draft.kepler.config.openTabs.push(mapId);
-                        draft.kepler.map = keplerReducer(draft.kepler.map, registerEntry({ id: mapId }));
+                        draft.kepler.map = createKeplerReducer({
+                            reason: 'create-map',
+                            mapId,
+                            name,
+                        })(draft.kepler.map, registerEntry({ id: mapId }));
                         draft.kepler.forwardDispatch[mapId] = getForwardDispatch(mapId);
                     }));
+                    if (!get().kepler.map[mapId]) {
+                        get().kepler.registerKeplerMapIfNotExists(mapId);
+                    }
                     requestMapStyle(mapId);
                     get().kepler.syncKeplerDatasets();
+                },
+                createMap: (name, options) => {
+                    const mapId = options?.id ?? createId();
+                    get().kepler.ensureMap(mapId, name);
                     return mapId;
                 },
                 async syncKeplerDatasets() {
-                    for (const mapId of Object.keys(get().kepler.map)) {
-                        const keplerDatasets = get().kepler.map[mapId]?.visState.datasets;
-                        for (const { table } of get().db.tables) {
-                            // TODO: remove this once getDuckDBColumnTypesMap can handle qualified table names
-                            // const qualifiedTable = table.toString();
-                            if (
-                            // !table.schema?.startsWith('__') && // skip internal schemas
-                            // !keplerDatasets?.[qualifiedTable]
-                            table.schema === 'main' &&
-                                !keplerDatasets?.[table.table]) {
-                                await get().kepler.addTableToMap(mapId, table.table, {
-                                    autoCreateLayers: false,
-                                    centerMap: false,
-                                });
+                    if (syncKeplerPromise) {
+                        pendingKeplerSync = true;
+                        return syncKeplerPromise;
+                    }
+                    syncKeplerPromise = (async () => {
+                        // Loop until no new sync was requested during the current pass.
+                        // Each iteration reads a fresh snapshot of db.tables and kepler.map,
+                        // so tables/maps added concurrently are picked up on the next pass.
+                        do {
+                            pendingKeplerSync = false;
+                            for (const mapId of Object.keys(get().kepler.map)) {
+                                const mapState = get().kepler.map[mapId];
+                                if (!mapState)
+                                    continue;
+                                const keplerDatasets = mapState.visState.datasets;
+                                // Only sync tables that are referenced by existing layers or filters
+                                const referencedDataIds = new Set();
+                                for (const layer of mapState.visState.layers ?? []) {
+                                    if (layer.config.dataId) {
+                                        referencedDataIds.add(layer.config.dataId);
+                                    }
+                                }
+                                for (const filter of mapState.visState.filters ?? []) {
+                                    for (const dataId of filter.dataId ?? []) {
+                                        referencedDataIds.add(dataId);
+                                    }
+                                }
+                                const availableTables = new Set(get()
+                                    .db.tables.filter((t) => t.table.schema === 'main')
+                                    .map((t) => t.table.table));
+                                for (const dataId of referencedDataIds) {
+                                    if (!keplerDatasets?.[dataId] &&
+                                        availableTables.has(dataId)) {
+                                        await get().kepler.addTableToMap(mapId, dataId, {
+                                            autoCreateLayers: false,
+                                            centerMap: false,
+                                        });
+                                    }
+                                }
                             }
-                        }
+                        } while (pendingKeplerSync);
+                    })();
+                    try {
+                        await syncKeplerPromise;
+                    }
+                    finally {
+                        syncKeplerPromise = null;
                     }
                 },
                 deleteMap: (mapId) => {
                     set((state) => produce(state, (draft) => {
-                        const openTabs = draft.kepler.config.openTabs;
                         const maps = draft.kepler.config.maps;
-                        const wasCurrentMap = draft.kepler.config.currentMapId === mapId;
-                        const deletingIndex = openTabs.indexOf(mapId);
-                        // Remove from maps and openTabs
                         draft.kepler.config.maps = maps.filter((map) => map.id !== mapId);
-                        draft.kepler.config.openTabs = openTabs.filter((id) => id !== mapId);
-                        // If we deleted the current map, select another one
-                        if (wasCurrentMap) {
-                            const newOpenTabs = draft.kepler.config.openTabs;
-                            const remainingMaps = draft.kepler.config.maps;
-                            if (newOpenTabs.length > 0) {
-                                // Select from remaining open tabs
-                                const newIndex = deletingIndex === 0
-                                    ? 0
-                                    : Math.min(deletingIndex - 1, newOpenTabs.length - 1);
-                                const newSelectedId = newOpenTabs[newIndex];
-                                if (newSelectedId) {
-                                    draft.kepler.config.currentMapId = newSelectedId;
-                                    updateMapLastOpenedAt(draft.kepler.config.maps, newSelectedId, Date.now());
-                                }
-                            }
-                            else if (remainingMaps.length > 0) {
-                                // No open tabs left, open a closed map
-                                const mapToOpen = remainingMaps[0];
-                                if (mapToOpen) {
-                                    draft.kepler.config.openTabs.push(mapToOpen.id);
-                                    draft.kepler.config.currentMapId = mapToOpen.id;
-                                    updateMapLastOpenedAt(draft.kepler.config.maps, mapToOpen.id, Date.now());
-                                }
-                            }
-                        }
                         draft.kepler.map = keplerReducer(draft.kepler.map, deleteEntry(mapId));
                         delete draft.kepler.forwardDispatch[mapId];
                     }));
                 },
+                duplicateMap: async (mapId) => {
+                    // Ensure the map's redux state is registered, consistent with other kepler actions
+                    get().kepler.registerKeplerMapIfNotExists(mapId);
+                    const sourceMap = get().kepler.config.maps.find((m) => m.id === mapId);
+                    const sourceMapState = get().kepler.map[mapId];
+                    if (!sourceMap || !sourceMapState) {
+                        return {
+                            success: false,
+                            message: 'Unable to duplicate map: source map or state not found',
+                            code: 'source-map-not-found',
+                        };
+                    }
+                    const newMapId = createId();
+                    const now = Date.now();
+                    // Save the source map state using Kepler's schema manager
+                    const savedConfig = KeplerGLSchemaManager.getConfigToSave(sourceMapState);
+                    set((state) => produce(state, (draft) => {
+                        draft.kepler.config.maps.push({
+                            id: newMapId,
+                            name: `Copy of ${sourceMap.name}`,
+                            config: savedConfig,
+                            lastOpenedAt: now,
+                        });
+                        // Register the new map with empty state, then load the config
+                        draft.kepler.map = createKeplerReducer({
+                            reason: 'duplicate-map',
+                            mapId: newMapId,
+                            name: `Copy of ${sourceMap.name}`,
+                        })(draft.kepler.map, registerEntry({ id: newMapId }));
+                        draft.kepler.forwardDispatch[newMapId] =
+                            getForwardDispatch(newMapId);
+                    }));
+                    // Load the saved config into the new map
+                    get().kepler.addConfigToMap(newMapId, savedConfig);
+                    requestMapStyle(newMapId);
+                    get().kepler.syncKeplerDatasets();
+                    return {
+                        success: true,
+                        message: 'Map duplicated successfully',
+                    };
+                },
                 renameMap: (mapId, name) => {
                     set((state) => produce(state, (draft) => {
                         const map = draft.kepler.config.maps.find((map) => map.id === mapId);
@@ -275,21 +421,6 @@ export function createKeplerSlice({ basicKeplerProps = {}, config: initialConfig
                         }
                     }));
                 },
-                closeMap: (mapId) => {
-                    set((state) => produce(state, (draft) => {
-                        const openTabs = draft.kepler.config.openTabs;
-                        // Don't close if it's the last open tab (defensive check, TabStrip also prevents this)
-                        if (openTabs.length <= 1)
-                            return;
-                        // Just remove from openTabs - TabStrip handles selection via onSelect before calling onClose
-                        draft.kepler.config.openTabs = openTabs.filter((id) => id !== mapId);
-                    }));
-                },
-                setOpenTabs: (tabIds) => {
-                    set((state) => produce(state, (draft) => {
-                        draft.kepler.config.openTabs = tabIds;
-                    }));
-                },
                 addDataToMap: (mapId, data) => {
                     get().kepler.registerKeplerMapIfNotExists(mapId);
                     get().kepler.dispatchAction(mapId, addDataToMap(data));
@@ -343,7 +474,10 @@ export function createKeplerSlice({ basicKeplerProps = {}, config: initialConfig
                         set({
                             kepler: {
                                 ...get().kepler,
-                                map: keplerReducer(get().kepler.map, registerEntry({ id: mapId })),
+                                map: createKeplerReducer({
+                                    reason: 'register-map',
+                                    mapId,
+                                })(get().kepler.map, registerEntry({ id: mapId })),
                                 forwardDispatch: {
                                     ...get().kepler.forwardDispatch,
                                     [mapId]: getForwardDispatch(mapId),
@@ -410,7 +544,11 @@ export function createKeplerSlice({ basicKeplerProps = {}, config: initialConfig
                 // Register redux state of maps that are not in the config
                 for (const map of draft.kepler.config.maps) {
                     if (!draft.kepler.map[map.id]) {
-                        draft.kepler.map = keplerReducer(draft.kepler.map, registerEntry({ id: map.id }));
+                        draft.kepler.map = createKeplerReducer({
+                            reason: 'sync-config',
+                            mapId: map.id,
+                            name: map.name,
+                        })(draft.kepler.map, registerEntry({ id: map.id }));
                         draft.kepler.forwardDispatch[map.id] = getForwardDispatch(map.id);
                     }
                 }
@@ -418,10 +556,7 @@ export function createKeplerSlice({ basicKeplerProps = {}, config: initialConfig
         }
         function updateForwardDispatch() {
             const config = get().kepler.config;
-            const currentMapId = config.currentMapId;
-            const forwardDispatch = {
-                [currentMapId]: getForwardDispatch(currentMapId),
-            };
+            const forwardDispatch = {};
             if (config) {
                 for (const { id } of config.maps) {
                     forwardDispatch[id] = getForwardDispatch(id);