@accelint/map-toolkit 1.4.0 → 1.5.0

package/dist/deckgl/shapes/shared/constants.js

@@ -200,15 +200,15 @@ function formatDistance(value) {
 	return value.toFixed(2);
 }
 /**
-* Format circle tooltip text showing diameter and area.
+* Format circle tooltip text showing radius and area.
 *
-* @param diameter - Circle diameter in the specified units
+* @param radius - Circle radius in the specified units
 * @param area - Circle area in the specified units squared
 * @param unitAbbrev - Unit abbreviation (e.g., 'km', 'mi')
-* @returns Formatted tooltip text: "d: {diameter} {unit}\n{area} {unit}²"
+* @returns Formatted tooltip text: "r: {radius} {unit}\n{area} {unit}²"
 */
-function formatCircleTooltip(diameter, area, unitAbbrev) {
-	return `d: ${formatDistance(diameter)} ${unitAbbrev}\n${formatDistance(area)} ${unitAbbrev}²`;
+function formatCircleTooltip(radius, area, unitAbbrev) {
+	return `r: ${formatDistance(radius)} ${unitAbbrev}\n${formatDistance(area)} ${unitAbbrev}²`;
 }
 /**
 * Format rectangle tooltip text showing dimensions and area.

package/dist/deckgl/shapes/shared/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","names":["DEFAULT_STYLE_PROPERTIES: StyleProperties","DASH_ARRAYS: Record<\n  'solid' | 'dashed' | 'dotted',\n  [number, number] | null\n>","DEFAULT_EDIT_HANDLE_COLOR: Color","DEFAULT_EDIT_HANDLE_OUTLINE_COLOR: Color","EMPTY_FEATURE_COLLECTION: import('geojson').FeatureCollection","TOOLTIP_CHARACTER_SET: string[]"],"sources":["../../../../src/deckgl/shapes/shared/constants.ts"],"sourcesContent":["/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport { DEFAULT_TEXT_STYLE } from '../../text-settings';\nimport type { Color } from '@deck.gl/core';\nimport type { StyleProperties } from './types';\n\n/**\n * Layer IDs for shape layers\n */\nexport const SHAPE_LAYER_IDS = {\n  DISPLAY: 'DISPLAY_SHAPES',\n  DISPLAY_HIGHLIGHT: 'DISPLAY_SHAPES::Highlight',\n  DISPLAY_LABELS: 'DISPLAY_SHAPES::Labels',\n} as const;\n\n/**\n * Base fill opacity multiplier for standard semi-transparent look.\n * Multiplies alpha by 0.2 (reduces to 20% of original opacity).\n */\nexport const BASE_FILL_OPACITY = 0.2;\n\n/**\n * Default border/outline width in pixels when not specified in styleProperties\n */\nexport const DEFAULT_LINE_WIDTH = 2;\n\n/**\n * Additional pixels added to border/outline width on hover\n */\nexport const HOVER_WIDTH_INCREASE = 2;\n\n/**\n * Additional pixels added to border/outline width for selection highlight\n */\nexport const HIGHLIGHT_WIDTH_INCREASE = 5;\n\n/**\n * Fixed opacity for label background (0-255)\n */\nexport const LABEL_BACKGROUND_OPACITY = 200;\n\n/**\n * Fixed opacity for label border (0-255)\n */\nexport const LABEL_BORDER_OPACITY = 255;\n\n/**\n * Default colors as RGBA arrays for DeckGL layers.\n *\n * These are the canonical color values used throughout the shapes system.\n * All other color constants should derive from these to maintain consistency.\n */\nexport const DEFAULT_COLORS = {\n  /** Default fill color (white at full alpha) */\n  fill: [255, 255, 255, 255] as Color,\n  /** Default border/outline color (outline-interactive-hover: #888a8f) */\n  line: [136, 138, 143, 255] as Color,\n  /** Highlight/selection color (turquoise at ~39% alpha) */\n  highlight: [40, 245, 190, 100] as Color,\n} as const;\n\n/**\n * Tentative (during-drawing) colors.\n *\n * These colors are used for the shape preview while drawing.\n * Fill is semi-transparent (8% opacity) to not obscure underlying features.\n * Border/outline uses the same color as saved shapes for consistency.\n */\nexport const DEFAULT_TENTATIVE_COLORS = {\n  /** Tentative fill color (white at 8% opacity: 0.08 * 255 ≈ 20) */\n  fill: [255, 255, 255, 20] as Color,\n  /** Tentative border/outline color (same as saved shapes for consistency) */\n  line: DEFAULT_COLORS.line,\n} as const;\n\n/**\n * Default style properties for saved shapes.\n *\n * These are applied when a shape is completed/saved.\n * Can be overridden via styleDefaults in draw options.\n */\nexport const DEFAULT_STYLE_PROPERTIES: StyleProperties = {\n  fillColor: DEFAULT_COLORS.fill,\n  lineColor: DEFAULT_COLORS.line,\n  lineWidth: 2,\n  linePattern: 'solid',\n};\n\n/**\n * Border/outline width options (in pixels)\n */\nexport const LINE_WIDTHS = [1, 2, 4, 8] as const;\n\n/**\n * Border/outline pattern options\n */\nexport const LINE_PATTERNS = ['solid', 'dashed', 'dotted'] as const;\n\n/**\n * Dash array patterns for border/outline rendering\n */\nexport const DASH_ARRAYS: Record<\n  'solid' | 'dashed' | 'dotted',\n  [number, number] | null\n> = {\n  solid: null,\n  dashed: [8, 4],\n  dotted: [2, 4],\n};\n\n/**\n * Default tentative fill color (white at 8% opacity - rgba(255, 255, 255, 0.08))\n * Used when drawing new shapes before they're completed.\n * 0.08 * 255 ≈ 20\n */\nexport const DEFAULT_TENTATIVE_FILL_COLOR: Color = [255, 255, 255, 20];\n\n/**\n * Default tentative border/outline color (outline-interactive-hover: #888a8f)\n * Used when drawing new shapes before they're completed.\n */\nexport const DEFAULT_TENTATIVE_LINE_COLOR: Color = [136, 138, 143, 255];\n\n/**\n * Default edit handle color (white) - used by both draw and edit layers\n */\nexport const DEFAULT_EDIT_HANDLE_COLOR: Color = [255, 255, 255, 255];\n\n/**\n * Edit handle outline color (dark for contrast)\n */\nexport const DEFAULT_EDIT_HANDLE_OUTLINE_COLOR: Color = [0, 0, 0, 200];\n\n/**\n * Empty feature collection for initializing editable layers\n */\nexport const EMPTY_FEATURE_COLLECTION: import('geojson').FeatureCollection = {\n  type: 'FeatureCollection',\n  features: [],\n};\n\n/**\n * Custom character set for deck.gl TextLayer used by tooltip rendering.\n *\n * deck.gl's TextLayer uses SDF (Signed Distance Field) font rendering which\n * by default only supports basic ASCII characters (32-128). Special characters\n * like degree symbol (°) and superscript 2 (²) must be explicitly included\n * for tooltip text like \"100.5 km²\" to render correctly.\n */\nexport const TOOLTIP_CHARACTER_SET: string[] = ['°', '²'];\n\n// Add standard ASCII characters (space through tilde + DEL)\nfor (let i = 32; i <= 128; i++) {\n  TOOLTIP_CHARACTER_SET.push(String.fromCharCode(i));\n}\n\n/**\n * Sublayer props for tooltip text rendering.\n * Used by both draw-shape-layer and edit-shape-layer for area/distance tooltips.\n */\nexport const TOOLTIP_SUBLAYER_PROPS = {\n  tooltips: {\n    ...DEFAULT_TEXT_STYLE,\n    fontFamily: 'Roboto MonoVariable, monospace',\n    characterSet: TOOLTIP_CHARACTER_SET,\n    getTextAnchor: 'start',\n    getAlignmentBaseline: 'bottom',\n    getPixelOffset: [8, 0],\n  },\n};\n\n/**\n * Shared edit handle sublayer props for EditableGeoJsonLayer.\n * Used by both draw-shape-layer and edit-shape-layer.\n */\nexport const EDIT_HANDLE_SUBLAYER_PROPS = {\n  editHandlePointOutline: {\n    getFillColor: DEFAULT_EDIT_HANDLE_COLOR,\n    getRadius: 6,\n  },\n  editHandlePoint: {\n    getFillColor: DEFAULT_EDIT_HANDLE_COLOR,\n    getRadius: 4,\n  },\n};\n\n/**\n * Combined sublayer props for EditableGeoJsonLayer with tooltips and edit handles.\n * Used by both draw-shape-layer and edit-shape-layer.\n */\nexport const EDITABLE_LAYER_SUBLAYER_PROPS = {\n  ...TOOLTIP_SUBLAYER_PROPS,\n  ...EDIT_HANDLE_SUBLAYER_PROPS,\n};\n\n/**\n * Format a distance value for tooltip display.\n * Used by draw and edit mode tooltips for consistent formatting.\n *\n * @param value - The distance value to format\n * @returns The formatted string with 2 decimal places\n */\nexport function formatDistance(value: number): string {\n  return value.toFixed(2);\n}\n\n// =============================================================================\n// Tooltip Text Formatters\n// =============================================================================\n// These functions generate consistent tooltip text for both draw and edit modes.\n\n/**\n * Format circle tooltip text showing diameter and area.\n *\n * @param diameter - Circle diameter in the specified units\n * @param area - Circle area in the specified units squared\n * @param unitAbbrev - Unit abbreviation (e.g., 'km', 'mi')\n * @returns Formatted tooltip text: \"d: {diameter} {unit}\\n{area} {unit}²\"\n */\nexport function formatCircleTooltip(\n  diameter: number,\n  area: number,\n  unitAbbrev: string,\n): string {\n  return `d: ${formatDistance(diameter)} ${unitAbbrev}\\n${formatDistance(area)} ${unitAbbrev}²`;\n}\n\n/**\n * Format rectangle tooltip text showing dimensions and area.\n *\n * @param width - Rectangle width in the specified units\n * @param height - Rectangle height in the specified units\n * @param area - Rectangle area in the specified units squared\n * @param unitAbbrev - Unit abbreviation (e.g., 'km', 'mi')\n * @returns Formatted tooltip text: \"{width} {unit} x {height} {unit}\\n{area} {unit}²\"\n */\nexport function formatRectangleTooltip(\n  width: number,\n  height: number,\n  area: number,\n  unitAbbrev: string,\n): string {\n  return `${formatDistance(width)} ${unitAbbrev} x ${formatDistance(height)} ${unitAbbrev}\\n${formatDistance(area)} ${unitAbbrev}²`;\n}\n\n/**\n * Format ellipse tooltip text showing axes and area.\n *\n * @param majorAxis - Ellipse major axis (full length) in the specified units\n * @param minorAxis - Ellipse minor axis (full length) in the specified units\n * @param area - Ellipse area in the specified units squared\n * @param unitAbbrev - Unit abbreviation (e.g., 'km', 'mi')\n * @returns Formatted tooltip text: \"{major} {unit} x {minor} {unit}\\n{area} {unit}²\"\n */\nexport function formatEllipseTooltip(\n  majorAxis: number,\n  minorAxis: number,\n  area: number,\n  unitAbbrev: string,\n): string {\n  return `${formatDistance(majorAxis)} ${unitAbbrev} x ${formatDistance(minorAxis)} ${unitAbbrev}\\n${formatDistance(area)} ${unitAbbrev}²`;\n}\n\n/**\n * Format simple distance tooltip text.\n *\n * @param distance - Distance value in the specified units\n * @param unitAbbrev - Unit abbreviation (e.g., 'km', 'mi')\n * @returns Formatted tooltip text: \"{distance} {unit}\"\n */\nexport function formatDistanceTooltip(\n  distance: number,\n  unitAbbrev: string,\n): string {\n  return `${formatDistance(distance)} ${unitAbbrev}`;\n}\n\n// =============================================================================\n// Edit Event Type Classification\n// =============================================================================\n\n/**\n * Continuous edit event types that fire during dragging.\n * These are emitted repeatedly while the user drags during an edit operation.\n */\nexport const CONTINUOUS_EDIT_TYPES = new Set([\n  'movePosition',\n  'unionGeometry',\n  'scaling',\n  'rotating',\n  'translating',\n]);\n\n/**\n * Completion edit event types that fire when dragging ends.\n * These are emitted once when the user finishes an edit action.\n */\nexport const COMPLETION_EDIT_TYPES = new Set([\n  'finishMovePosition',\n  'addPosition',\n  'removePosition',\n  'scaled',\n  'rotated',\n  'translated',\n]);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAqBA,MAAa,kBAAkB;CAC7B,SAAS;CACT,mBAAmB;CACnB,gBAAgB;CACjB;;;;;AAMD,MAAa,oBAAoB;;;;AAKjC,MAAa,qBAAqB;;;;AAKlC,MAAa,uBAAuB;;;;AAKpC,MAAa,2BAA2B;;;;;;;AAkBxC,MAAa,iBAAiB;CAE5B,MAAM;EAAC;EAAK;EAAK;EAAK;EAAI;CAE1B,MAAM;EAAC;EAAK;EAAK;EAAK;EAAI;CAE1B,WAAW;EAAC;EAAI;EAAK;EAAK;EAAI;CAC/B;;;;;;;;AASD,MAAa,2BAA2B;CAEtC,MAAM;EAAC;EAAK;EAAK;EAAK;EAAG;CAEzB,MAAM,eAAe;CACtB;;;;;;;AAQD,MAAaA,2BAA4C;CACvD,WAAW,eAAe;CAC1B,WAAW,eAAe;CAC1B,WAAW;CACX,aAAa;CACd;;;;AAKD,MAAa,cAAc;CAAC;CAAG;CAAG;CAAG;CAAE;;;;AAKvC,MAAa,gBAAgB;CAAC;CAAS;CAAU;CAAS;;;;AAK1D,MAAaC,cAGT;CACF,OAAO;CACP,QAAQ,CAAC,GAAG,EAAE;CACd,QAAQ,CAAC,GAAG,EAAE;CACf;;;;AAkBD,MAAaC,4BAAmC;CAAC;CAAK;CAAK;CAAK;CAAI;;;;AAKpE,MAAaC,oCAA2C;CAAC;CAAG;CAAG;CAAG;CAAI;;;;AAKtE,MAAaC,2BAAgE;CAC3E,MAAM;CACN,UAAU,EAAE;CACb;;;;;;;;;AAUD,MAAaC,wBAAkC,CAAC,KAAK,IAAI;AAGzD,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,IACzB,uBAAsB,KAAK,OAAO,aAAa,EAAE,CAAC;;;;;AAOpD,MAAa,yBAAyB,EACpC,UAAU;CACR,GAAG;CACH,YAAY;CACZ,cAAc;CACd,eAAe;CACf,sBAAsB;CACtB,gBAAgB,CAAC,GAAG,EAAE;CACvB,EACF;;;;;AAMD,MAAa,6BAA6B;CACxC,wBAAwB;EACtB,cAAc;EACd,WAAW;EACZ;CACD,iBAAiB;EACf,cAAc;EACd,WAAW;EACZ;CACF;;;;;AAMD,MAAa,gCAAgC;CAC3C,GAAG;CACH,GAAG;CACJ;;;;;;;;AASD,SAAgB,eAAe,OAAuB;AACpD,QAAO,MAAM,QAAQ,EAAE;;;;;;;;;;AAgBzB,SAAgB,oBACd,UACA,MACA,YACQ;AACR,QAAO,MAAM,eAAe,SAAS,CAAC,GAAG,WAAW,IAAI,eAAe,KAAK,CAAC,GAAG,WAAW;;;;;;;;;;;AAY7F,SAAgB,uBACd,OACA,QACA,MACA,YACQ;AACR,QAAO,GAAG,eAAe,MAAM,CAAC,GAAG,WAAW,KAAK,eAAe,OAAO,CAAC,GAAG,WAAW,IAAI,eAAe,KAAK,CAAC,GAAG,WAAW;;;;;;;;;;;AAYjI,SAAgB,qBACd,WACA,WACA,MACA,YACQ;AACR,QAAO,GAAG,eAAe,UAAU,CAAC,GAAG,WAAW,KAAK,eAAe,UAAU,CAAC,GAAG,WAAW,IAAI,eAAe,KAAK,CAAC,GAAG,WAAW;;;;;;;;;AAUxI,SAAgB,sBACd,UACA,YACQ;AACR,QAAO,GAAG,eAAe,SAAS,CAAC,GAAG;;;;;;AAWxC,MAAa,wBAAwB,IAAI,IAAI;CAC3C;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;AAMF,MAAa,wBAAwB,IAAI,IAAI;CAC3C;CACA;CACA;CACA;CACA;CACA;CACD,CAAC"}
+{"version":3,"file":"constants.js","names":["DEFAULT_STYLE_PROPERTIES: StyleProperties","DASH_ARRAYS: Record<\n  'solid' | 'dashed' | 'dotted',\n  [number, number] | null\n>","DEFAULT_EDIT_HANDLE_COLOR: Color","DEFAULT_EDIT_HANDLE_OUTLINE_COLOR: Color","EMPTY_FEATURE_COLLECTION: import('geojson').FeatureCollection","TOOLTIP_CHARACTER_SET: string[]"],"sources":["../../../../src/deckgl/shapes/shared/constants.ts"],"sourcesContent":["/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport { DEFAULT_TEXT_STYLE } from '../../text-settings';\nimport type { Color } from '@deck.gl/core';\nimport type { StyleProperties } from './types';\n\n/**\n * Layer IDs for shape layers\n */\nexport const SHAPE_LAYER_IDS = {\n  DISPLAY: 'DISPLAY_SHAPES',\n  DISPLAY_HIGHLIGHT: 'DISPLAY_SHAPES::Highlight',\n  DISPLAY_LABELS: 'DISPLAY_SHAPES::Labels',\n} as const;\n\n/**\n * Base fill opacity multiplier for standard semi-transparent look.\n * Multiplies alpha by 0.2 (reduces to 20% of original opacity).\n */\nexport const BASE_FILL_OPACITY = 0.2;\n\n/**\n * Default border/outline width in pixels when not specified in styleProperties\n */\nexport const DEFAULT_LINE_WIDTH = 2;\n\n/**\n * Additional pixels added to border/outline width on hover\n */\nexport const HOVER_WIDTH_INCREASE = 2;\n\n/**\n * Additional pixels added to border/outline width for selection highlight\n */\nexport const HIGHLIGHT_WIDTH_INCREASE = 5;\n\n/**\n * Fixed opacity for label background (0-255)\n */\nexport const LABEL_BACKGROUND_OPACITY = 200;\n\n/**\n * Fixed opacity for label border (0-255)\n */\nexport const LABEL_BORDER_OPACITY = 255;\n\n/**\n * Default colors as RGBA arrays for DeckGL layers.\n *\n * These are the canonical color values used throughout the shapes system.\n * All other color constants should derive from these to maintain consistency.\n */\nexport const DEFAULT_COLORS = {\n  /** Default fill color (white at full alpha) */\n  fill: [255, 255, 255, 255] as Color,\n  /** Default border/outline color (outline-interactive-hover: #888a8f) */\n  line: [136, 138, 143, 255] as Color,\n  /** Highlight/selection color (turquoise at ~39% alpha) */\n  highlight: [40, 245, 190, 100] as Color,\n} as const;\n\n/**\n * Tentative (during-drawing) colors.\n *\n * These colors are used for the shape preview while drawing.\n * Fill is semi-transparent (8% opacity) to not obscure underlying features.\n * Border/outline uses the same color as saved shapes for consistency.\n */\nexport const DEFAULT_TENTATIVE_COLORS = {\n  /** Tentative fill color (white at 8% opacity: 0.08 * 255 ≈ 20) */\n  fill: [255, 255, 255, 20] as Color,\n  /** Tentative border/outline color (same as saved shapes for consistency) */\n  line: DEFAULT_COLORS.line,\n} as const;\n\n/**\n * Default style properties for saved shapes.\n *\n * These are applied when a shape is completed/saved.\n * Can be overridden via styleDefaults in draw options.\n */\nexport const DEFAULT_STYLE_PROPERTIES: StyleProperties = {\n  fillColor: DEFAULT_COLORS.fill,\n  lineColor: DEFAULT_COLORS.line,\n  lineWidth: 2,\n  linePattern: 'solid',\n};\n\n/**\n * Border/outline width options (in pixels)\n */\nexport const LINE_WIDTHS = [1, 2, 4, 8] as const;\n\n/**\n * Border/outline pattern options\n */\nexport const LINE_PATTERNS = ['solid', 'dashed', 'dotted'] as const;\n\n/**\n * Dash array patterns for border/outline rendering\n */\nexport const DASH_ARRAYS: Record<\n  'solid' | 'dashed' | 'dotted',\n  [number, number] | null\n> = {\n  solid: null,\n  dashed: [8, 4],\n  dotted: [2, 4],\n};\n\n/**\n * Default tentative fill color (white at 8% opacity - rgba(255, 255, 255, 0.08))\n * Used when drawing new shapes before they're completed.\n * 0.08 * 255 ≈ 20\n */\nexport const DEFAULT_TENTATIVE_FILL_COLOR: Color = [255, 255, 255, 20];\n\n/**\n * Default tentative border/outline color (outline-interactive-hover: #888a8f)\n * Used when drawing new shapes before they're completed.\n */\nexport const DEFAULT_TENTATIVE_LINE_COLOR: Color = [136, 138, 143, 255];\n\n/**\n * Default edit handle color (white) - used by both draw and edit layers\n */\nexport const DEFAULT_EDIT_HANDLE_COLOR: Color = [255, 255, 255, 255];\n\n/**\n * Edit handle outline color (dark for contrast)\n */\nexport const DEFAULT_EDIT_HANDLE_OUTLINE_COLOR: Color = [0, 0, 0, 200];\n\n/**\n * Empty feature collection for initializing editable layers\n */\nexport const EMPTY_FEATURE_COLLECTION: import('geojson').FeatureCollection = {\n  type: 'FeatureCollection',\n  features: [],\n};\n\n/**\n * Custom character set for deck.gl TextLayer used by tooltip rendering.\n *\n * deck.gl's TextLayer uses SDF (Signed Distance Field) font rendering which\n * by default only supports basic ASCII characters (32-128). Special characters\n * like degree symbol (°) and superscript 2 (²) must be explicitly included\n * for tooltip text like \"100.5 km²\" to render correctly.\n */\nexport const TOOLTIP_CHARACTER_SET: string[] = ['°', '²'];\n\n// Add standard ASCII characters (space through tilde + DEL)\nfor (let i = 32; i <= 128; i++) {\n  TOOLTIP_CHARACTER_SET.push(String.fromCharCode(i));\n}\n\n/**\n * Sublayer props for tooltip text rendering.\n * Used by both draw-shape-layer and edit-shape-layer for area/distance tooltips.\n */\nexport const TOOLTIP_SUBLAYER_PROPS = {\n  tooltips: {\n    ...DEFAULT_TEXT_STYLE,\n    fontFamily: 'Roboto MonoVariable, monospace',\n    characterSet: TOOLTIP_CHARACTER_SET,\n    getTextAnchor: 'start',\n    getAlignmentBaseline: 'bottom',\n    getPixelOffset: [8, 0],\n  },\n};\n\n/**\n * Shared edit handle sublayer props for EditableGeoJsonLayer.\n * Used by both draw-shape-layer and edit-shape-layer.\n */\nexport const EDIT_HANDLE_SUBLAYER_PROPS = {\n  editHandlePointOutline: {\n    getFillColor: DEFAULT_EDIT_HANDLE_COLOR,\n    getRadius: 6,\n  },\n  editHandlePoint: {\n    getFillColor: DEFAULT_EDIT_HANDLE_COLOR,\n    getRadius: 4,\n  },\n};\n\n/**\n * Combined sublayer props for EditableGeoJsonLayer with tooltips and edit handles.\n * Used by both draw-shape-layer and edit-shape-layer.\n */\nexport const EDITABLE_LAYER_SUBLAYER_PROPS = {\n  ...TOOLTIP_SUBLAYER_PROPS,\n  ...EDIT_HANDLE_SUBLAYER_PROPS,\n};\n\n/**\n * Format a distance value for tooltip display.\n * Used by draw and edit mode tooltips for consistent formatting.\n *\n * @param value - The distance value to format\n * @returns The formatted string with 2 decimal places\n */\nexport function formatDistance(value: number): string {\n  return value.toFixed(2);\n}\n\n// =============================================================================\n// Tooltip Text Formatters\n// =============================================================================\n// These functions generate consistent tooltip text for both draw and edit modes.\n\n/**\n * Format circle tooltip text showing radius and area.\n *\n * @param radius - Circle radius in the specified units\n * @param area - Circle area in the specified units squared\n * @param unitAbbrev - Unit abbreviation (e.g., 'km', 'mi')\n * @returns Formatted tooltip text: \"r: {radius} {unit}\\n{area} {unit}²\"\n */\nexport function formatCircleTooltip(\n  radius: number,\n  area: number,\n  unitAbbrev: string,\n): string {\n  return `r: ${formatDistance(radius)} ${unitAbbrev}\\n${formatDistance(area)} ${unitAbbrev}²`;\n}\n\n/**\n * Format rectangle tooltip text showing dimensions and area.\n *\n * @param width - Rectangle width in the specified units\n * @param height - Rectangle height in the specified units\n * @param area - Rectangle area in the specified units squared\n * @param unitAbbrev - Unit abbreviation (e.g., 'km', 'mi')\n * @returns Formatted tooltip text: \"{width} {unit} x {height} {unit}\\n{area} {unit}²\"\n */\nexport function formatRectangleTooltip(\n  width: number,\n  height: number,\n  area: number,\n  unitAbbrev: string,\n): string {\n  return `${formatDistance(width)} ${unitAbbrev} x ${formatDistance(height)} ${unitAbbrev}\\n${formatDistance(area)} ${unitAbbrev}²`;\n}\n\n/**\n * Format ellipse tooltip text showing axes and area.\n *\n * @param majorAxis - Ellipse major axis (full length) in the specified units\n * @param minorAxis - Ellipse minor axis (full length) in the specified units\n * @param area - Ellipse area in the specified units squared\n * @param unitAbbrev - Unit abbreviation (e.g., 'km', 'mi')\n * @returns Formatted tooltip text: \"{major} {unit} x {minor} {unit}\\n{area} {unit}²\"\n */\nexport function formatEllipseTooltip(\n  majorAxis: number,\n  minorAxis: number,\n  area: number,\n  unitAbbrev: string,\n): string {\n  return `${formatDistance(majorAxis)} ${unitAbbrev} x ${formatDistance(minorAxis)} ${unitAbbrev}\\n${formatDistance(area)} ${unitAbbrev}²`;\n}\n\n/**\n * Format simple distance tooltip text.\n *\n * @param distance - Distance value in the specified units\n * @param unitAbbrev - Unit abbreviation (e.g., 'km', 'mi')\n * @returns Formatted tooltip text: \"{distance} {unit}\"\n */\nexport function formatDistanceTooltip(\n  distance: number,\n  unitAbbrev: string,\n): string {\n  return `${formatDistance(distance)} ${unitAbbrev}`;\n}\n\n// =============================================================================\n// Edit Event Type Classification\n// =============================================================================\n\n/**\n * Continuous edit event types that fire during dragging.\n * These are emitted repeatedly while the user drags during an edit operation.\n */\nexport const CONTINUOUS_EDIT_TYPES = new Set([\n  'movePosition',\n  'unionGeometry',\n  'scaling',\n  'rotating',\n  'translating',\n]);\n\n/**\n * Completion edit event types that fire when dragging ends.\n * These are emitted once when the user finishes an edit action.\n */\nexport const COMPLETION_EDIT_TYPES = new Set([\n  'finishMovePosition',\n  'addPosition',\n  'removePosition',\n  'scaled',\n  'rotated',\n  'translated',\n]);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAqBA,MAAa,kBAAkB;CAC7B,SAAS;CACT,mBAAmB;CACnB,gBAAgB;CACjB;;;;;AAMD,MAAa,oBAAoB;;;;AAKjC,MAAa,qBAAqB;;;;AAKlC,MAAa,uBAAuB;;;;AAKpC,MAAa,2BAA2B;;;;;;;AAkBxC,MAAa,iBAAiB;CAE5B,MAAM;EAAC;EAAK;EAAK;EAAK;EAAI;CAE1B,MAAM;EAAC;EAAK;EAAK;EAAK;EAAI;CAE1B,WAAW;EAAC;EAAI;EAAK;EAAK;EAAI;CAC/B;;;;;;;;AASD,MAAa,2BAA2B;CAEtC,MAAM;EAAC;EAAK;EAAK;EAAK;EAAG;CAEzB,MAAM,eAAe;CACtB;;;;;;;AAQD,MAAaA,2BAA4C;CACvD,WAAW,eAAe;CAC1B,WAAW,eAAe;CAC1B,WAAW;CACX,aAAa;CACd;;;;AAKD,MAAa,cAAc;CAAC;CAAG;CAAG;CAAG;CAAE;;;;AAKvC,MAAa,gBAAgB;CAAC;CAAS;CAAU;CAAS;;;;AAK1D,MAAaC,cAGT;CACF,OAAO;CACP,QAAQ,CAAC,GAAG,EAAE;CACd,QAAQ,CAAC,GAAG,EAAE;CACf;;;;AAkBD,MAAaC,4BAAmC;CAAC;CAAK;CAAK;CAAK;CAAI;;;;AAKpE,MAAaC,oCAA2C;CAAC;CAAG;CAAG;CAAG;CAAI;;;;AAKtE,MAAaC,2BAAgE;CAC3E,MAAM;CACN,UAAU,EAAE;CACb;;;;;;;;;AAUD,MAAaC,wBAAkC,CAAC,KAAK,IAAI;AAGzD,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,IACzB,uBAAsB,KAAK,OAAO,aAAa,EAAE,CAAC;;;;;AAOpD,MAAa,yBAAyB,EACpC,UAAU;CACR,GAAG;CACH,YAAY;CACZ,cAAc;CACd,eAAe;CACf,sBAAsB;CACtB,gBAAgB,CAAC,GAAG,EAAE;CACvB,EACF;;;;;AAMD,MAAa,6BAA6B;CACxC,wBAAwB;EACtB,cAAc;EACd,WAAW;EACZ;CACD,iBAAiB;EACf,cAAc;EACd,WAAW;EACZ;CACF;;;;;AAMD,MAAa,gCAAgC;CAC3C,GAAG;CACH,GAAG;CACJ;;;;;;;;AASD,SAAgB,eAAe,OAAuB;AACpD,QAAO,MAAM,QAAQ,EAAE;;;;;;;;;;AAgBzB,SAAgB,oBACd,QACA,MACA,YACQ;AACR,QAAO,MAAM,eAAe,OAAO,CAAC,GAAG,WAAW,IAAI,eAAe,KAAK,CAAC,GAAG,WAAW;;;;;;;;;;;AAY3F,SAAgB,uBACd,OACA,QACA,MACA,YACQ;AACR,QAAO,GAAG,eAAe,MAAM,CAAC,GAAG,WAAW,KAAK,eAAe,OAAO,CAAC,GAAG,WAAW,IAAI,eAAe,KAAK,CAAC,GAAG,WAAW;;;;;;;;;;;AAYjI,SAAgB,qBACd,WACA,WACA,MACA,YACQ;AACR,QAAO,GAAG,eAAe,UAAU,CAAC,GAAG,WAAW,KAAK,eAAe,UAAU,CAAC,GAAG,WAAW,IAAI,eAAe,KAAK,CAAC,GAAG,WAAW;;;;;;;;;AAUxI,SAAgB,sBACd,UACA,YACQ;AACR,QAAO,GAAG,eAAe,SAAS,CAAC,GAAG;;;;;;AAWxC,MAAa,wBAAwB,IAAI,IAAI;CAC3C;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;AAMF,MAAa,wBAAwB,IAAI,IAAI;CAC3C;CACA;CACA;CACA;CACA;CACA;CACD,CAAC"}

package/dist/deckgl/shapes/shared/utils/layer-config.js

@@ -13,8 +13,8 @@
 
 'use client';
 
-import { DEFAULT_EDIT_HANDLE_COLOR, EDITABLE_LAYER_SUBLAYER_PROPS } from "../constants.js";
 import { DEFAULT_DISTANCE_UNITS, getDistanceUnitFromAbbreviation } from "../../../../shared/units.js";
+import { DEFAULT_EDIT_HANDLE_COLOR, EDITABLE_LAYER_SUBLAYER_PROPS } from "../constants.js";
 
 //#region src/deckgl/shapes/shared/utils/layer-config.ts
 /**

package/dist/shared/cleanup.d.ts

@@ -0,0 +1,58 @@
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import { UniqueId } from "@accelint/core";
+
+//#region src/shared/cleanup.d.ts
+/**
+ * Returns the current generation counter for a map instance.
+ *
+ * Use as a `key` prop on `<MapLibre>` to force a clean remount whenever the map's
+ * stores are cleared (e.g., on Activity deactivation).
+ *
+ * @param mapId - The map instance ID
+ * @returns The current generation (0 on first render, increments with each cleanup)
+ */
+declare function getMapGeneration(mapId: UniqueId): number;
+/**
+ * Clears ALL map store state for a given map instance.
+ *
+ * This function calls cleanup for every store in the map-toolkit. It's called
+ * automatically by MapProvider when a map instance unmounts.
+ *
+ * **⚠️ IMPORTANT: When creating a new store with createMapStore():**
+ * 1. Export a `clear*State(mapId)` function from your store
+ * 2. Import and add it to this `clearAllMapStores()` function
+ * 3. The cleanup function should call your store's internal cleanup mechanism
+ *
+ * @param mapId - The map instance ID to clean up
+ *
+ * @example
+ * ```typescript
+ * // In your store file (e.g., my-feature/store.ts)
+ * export function clearMyFeatureState(mapId: UniqueId): void {
+ *   myFeatureStore.cleanup(mapId);
+ * }
+ *
+ * // Then add to this file:
+ * import { clearMyFeatureState } from '../my-feature/store';
+ *
+ * export function clearAllMapStores(mapId: UniqueId): void {
+ *   // ... existing cleanups
+ *   clearMyFeatureState(mapId);
+ * }
+ * ```
+ */
+declare function clearAllMapStores(mapId: UniqueId): void;
+//#endregion
+export { clearAllMapStores, getMapGeneration };
+//# sourceMappingURL=cleanup.d.ts.map

package/dist/shared/cleanup.js

@@ -0,0 +1,93 @@
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+import { clearCameraState } from "../camera/store.js";
+import { clearCursorCoordinateState } from "../cursor-coordinates/store.js";
+import { clearSelectionState } from "../deckgl/shapes/display-shape-layer/store.js";
+import { clearCursorState } from "../map-cursor/store.js";
+import { clearDrawingState } from "../deckgl/shapes/draw-shape-layer/store.js";
+import { clearEditingState } from "../deckgl/shapes/edit-shape-layer/store.js";
+import { clearMapModeState } from "../map-mode/store.js";
+import { clearViewportState } from "../viewport/store.js";
+
+//#region src/shared/cleanup.ts
+/**
+* Tracks how many times each map instance has been cleaned up.
+*
+* This counter is module-level (not React state), so React 19's Activity component
+* does NOT preserve it across deactivation/reactivation cycles. Each time
+* `clearAllMapStores` runs (during Activity deactivation cleanup), the generation
+* increments. On reactivation, `BaseMap` reads the new generation during render and
+* passes it as `key` to `<MapLibre>`, forcing a clean remount of react-map-gl's Map
+* component — which resets `mapInstance` to `null` and prevents the crash caused by
+* `setProps` being called on a destroyed MapLibre instance (one whose `map.style` was
+* set to `undefined` by `map.remove()`).
+*/
+const mapGenerations = /* @__PURE__ */ new Map();
+/**
+* Returns the current generation counter for a map instance.
+*
+* Use as a `key` prop on `<MapLibre>` to force a clean remount whenever the map's
+* stores are cleared (e.g., on Activity deactivation).
+*
+* @param mapId - The map instance ID
+* @returns The current generation (0 on first render, increments with each cleanup)
+*/
+function getMapGeneration(mapId) {
+	return mapGenerations.get(mapId) ?? 0;
+}
+/**
+* Clears ALL map store state for a given map instance.
+*
+* This function calls cleanup for every store in the map-toolkit. It's called
+* automatically by MapProvider when a map instance unmounts.
+*
+* **⚠️ IMPORTANT: When creating a new store with createMapStore():**
+* 1. Export a `clear*State(mapId)` function from your store
+* 2. Import and add it to this `clearAllMapStores()` function
+* 3. The cleanup function should call your store's internal cleanup mechanism
+*
+* @param mapId - The map instance ID to clean up
+*
+* @example
+* ```typescript
+* // In your store file (e.g., my-feature/store.ts)
+* export function clearMyFeatureState(mapId: UniqueId): void {
+*   myFeatureStore.cleanup(mapId);
+* }
+*
+* // Then add to this file:
+* import { clearMyFeatureState } from '../my-feature/store';
+*
+* export function clearAllMapStores(mapId: UniqueId): void {
+*   // ... existing cleanups
+*   clearMyFeatureState(mapId);
+* }
+* ```
+*/
+function clearAllMapStores(mapId) {
+	const nextGen = (mapGenerations.get(mapId) ?? 0) + 1;
+	mapGenerations.set(mapId, nextGen);
+	clearMapModeState(mapId);
+	clearCursorState(mapId);
+	clearCameraState(mapId);
+	clearViewportState(mapId);
+	clearCursorCoordinateState(mapId);
+	clearDrawingState(mapId);
+	clearEditingState(mapId);
+	clearSelectionState(mapId);
+}
+
+//#endregion
+export { clearAllMapStores, getMapGeneration };
+//# sourceMappingURL=cleanup.js.map

package/dist/shared/cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.js","names":[],"sources":["../../src/shared/cleanup.ts"],"sourcesContent":["/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { clearCameraState } from '../camera/store';\nimport { clearCursorCoordinateState } from '../cursor-coordinates/store';\nimport { clearSelectionState } from '../deckgl/shapes/display-shape-layer/store';\nimport { clearDrawingState } from '../deckgl/shapes/draw-shape-layer/store';\nimport { clearEditingState } from '../deckgl/shapes/edit-shape-layer/store';\nimport { clearCursorState } from '../map-cursor/store';\nimport { clearMapModeState } from '../map-mode/store';\nimport { clearViewportState } from '../viewport/store';\nimport type { UniqueId } from '@accelint/core';\n\n/**\n * Tracks how many times each map instance has been cleaned up.\n *\n * This counter is module-level (not React state), so React 19's Activity component\n * does NOT preserve it across deactivation/reactivation cycles. Each time\n * `clearAllMapStores` runs (during Activity deactivation cleanup), the generation\n * increments. On reactivation, `BaseMap` reads the new generation during render and\n * passes it as `key` to `<MapLibre>`, forcing a clean remount of react-map-gl's Map\n * component — which resets `mapInstance` to `null` and prevents the crash caused by\n * `setProps` being called on a destroyed MapLibre instance (one whose `map.style` was\n * set to `undefined` by `map.remove()`).\n */\nconst mapGenerations = new Map<UniqueId, number>();\n\n/**\n * Returns the current generation counter for a map instance.\n *\n * Use as a `key` prop on `<MapLibre>` to force a clean remount whenever the map's\n * stores are cleared (e.g., on Activity deactivation).\n *\n * @param mapId - The map instance ID\n * @returns The current generation (0 on first render, increments with each cleanup)\n */\nexport function getMapGeneration(mapId: UniqueId): number {\n  return mapGenerations.get(mapId) ?? 0;\n}\n\n/**\n * Clears ALL map store state for a given map instance.\n *\n * This function calls cleanup for every store in the map-toolkit. It's called\n * automatically by MapProvider when a map instance unmounts.\n *\n * **⚠️ IMPORTANT: When creating a new store with createMapStore():**\n * 1. Export a `clear*State(mapId)` function from your store\n * 2. Import and add it to this `clearAllMapStores()` function\n * 3. The cleanup function should call your store's internal cleanup mechanism\n *\n * @param mapId - The map instance ID to clean up\n *\n * @example\n * ```typescript\n * // In your store file (e.g., my-feature/store.ts)\n * export function clearMyFeatureState(mapId: UniqueId): void {\n *   myFeatureStore.cleanup(mapId);\n * }\n *\n * // Then add to this file:\n * import { clearMyFeatureState } from '../my-feature/store';\n *\n * export function clearAllMapStores(mapId: UniqueId): void {\n *   // ... existing cleanups\n *   clearMyFeatureState(mapId);\n * }\n * ```\n */\nexport function clearAllMapStores(mapId: UniqueId): void {\n  // Increment generation so BaseMap's next render passes a new key to <MapLibre>,\n  // forcing a clean remount and resetting react-map-gl's internal mapInstance state.\n  const nextGen = (mapGenerations.get(mapId) ?? 0) + 1;\n  mapGenerations.set(mapId, nextGen);\n\n  // Core stores\n  clearMapModeState(mapId);\n  clearCursorState(mapId);\n  clearCameraState(mapId);\n  clearViewportState(mapId);\n  clearCursorCoordinateState(mapId);\n\n  // Shape layer stores\n  clearDrawingState(mapId);\n  clearEditingState(mapId);\n  clearSelectionState(mapId);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCA,MAAM,iCAAiB,IAAI,KAAuB;;;;;;;;;;AAWlD,SAAgB,iBAAiB,OAAyB;AACxD,QAAO,eAAe,IAAI,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCtC,SAAgB,kBAAkB,OAAuB;CAGvD,MAAM,WAAW,eAAe,IAAI,MAAM,IAAI,KAAK;AACnD,gBAAe,IAAI,OAAO,QAAQ;AAGlC,mBAAkB,MAAM;AACxB,kBAAiB,MAAM;AACvB,kBAAiB,MAAM;AACvB,oBAAmB,MAAM;AACzB,4BAA2B,MAAM;AAGjC,mBAAkB,MAAM;AACxB,mBAAkB,MAAM;AACxB,qBAAoB,MAAM"}

package/dist/shared/create-map-store.d.ts

@@ -167,6 +167,18 @@ type MapStore<TState, TActions> = {
    * Clear instance state (for tests or manual cleanup).
    */
   clear: (mapId: UniqueId) => void;
+  /**
+   * Set initial state to be used when instance is created or updated.
+   * Handles both initialization scenarios:
+   * - If instance doesn't exist yet: stores pending state for getInstance
+   * - If instance already exists: updates existing instance directly
+   *
+   * This dual-path approach ensures correct initialization regardless of
+   * React lifecycle timing (e.g., React Strict Mode double-mount).
+   *
+   * Safe to call during render. Idempotent for repeated calls with same state.
+   */
+  setInitialState: (mapId: UniqueId, state: TState) => void;
   /**
    * Low-level access for custom hooks or useSyncExternalStore.
    */

package/dist/shared/create-map-store.js

@@ -103,16 +103,18 @@ function mapClear() {
 function createMapStore(config) {
 	const { defaultState, actions: createActions, bus, onCleanup } = config;
 	const instances = /* @__PURE__ */ new Map();
+	const pendingInitialState = /* @__PURE__ */ new Map();
 	const subscriptionCache = /* @__PURE__ */ new Map();
 	const snapshotCache = /* @__PURE__ */ new Map();
 	function getInstance(mapId) {
 		let instance = instances.get(mapId);
 		if (!instance) {
 			instance = {
-				state: { ...defaultState },
+				state: pendingInitialState.get(mapId) ?? { ...defaultState },
 				subscribers: /* @__PURE__ */ new Set()
 			};
 			instances.set(mapId, instance);
+			pendingInitialState.delete(mapId);
 		}
 		return instance;
 	}
@@ -154,8 +156,6 @@ function createMapStore(config) {
 		if (onCleanup) onCleanup(mapId, instance.state);
 		if (instance.busCleanup) instance.busCleanup();
 		instances.delete(mapId);
-		subscriptionCache.delete(mapId);
-		snapshotCache.delete(mapId);
 	}
 	function subscribe(mapId) {
 		let cached = subscriptionCache.get(mapId);
@@ -236,6 +236,11 @@ function createMapStore(config) {
 			const instance = instances.get(mapId);
 			if (instance) cleanupInstance(mapId, instance);
 		},
+		setInitialState: (mapId, state) => {
+			const instance = instances.get(mapId);
+			if (instance) instance.state = state;
+			pendingInitialState.set(mapId, state);
+		},
 		subscribe,
 		snapshot,
 		serverSnapshot

package/dist/shared/create-map-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-map-store.js","names":[],"sources":["../../src/shared/create-map-store.ts"],"sourcesContent":["/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { useRef, useSyncExternalStore } from 'react';\nimport type { UniqueId } from '@accelint/core';\n\n// =============================================================================\n// Immutable Map Helpers\n// =============================================================================\n\n/**\n * Create a new Map with an entry added or updated (immutable).\n *\n * @param map - The Map to copy\n * @param key - The key to set\n * @param value - The value to set\n * @returns A new Map with the entry added/updated\n *\n * @example\n * ```ts\n * const newMap = mapSet(state.cursorOwners, 'draw-layer', 'crosshair');\n * set({ cursorOwners: newMap });\n * ```\n */\nexport function mapSet<K, V>(map: Map<K, V>, key: K, value: V): Map<K, V> {\n  const newMap = new Map(map);\n  newMap.set(key, value);\n  return newMap;\n}\n\n/**\n * Create a new Map with an entry removed (immutable).\n *\n * @param map - The Map to copy\n * @param key - The key to remove\n * @returns A new Map with the entry removed\n *\n * @example\n * ```ts\n * const newMap = mapDelete(state.cursorOwners, 'draw-layer');\n * set({ cursorOwners: newMap });\n * ```\n */\nexport function mapDelete<K, V>(map: Map<K, V>, key: K): Map<K, V> {\n  const newMap = new Map(map);\n  newMap.delete(key);\n  return newMap;\n}\n\n/**\n * Create a new empty Map (immutable replacement for Map.clear()).\n *\n * @returns A new empty Map\n *\n * @example\n * ```ts\n * set({ pendingRequests: mapClear<string, PendingRequest>() });\n * ```\n */\nexport function mapClear<K, V>(): Map<K, V> {\n  return new Map<K, V>();\n}\n\n/**\n * Helper methods passed to action creators and bus setup functions.\n *\n * This type is exported for consumers building custom store extensions or\n * helper functions that need to interact with store state.\n *\n * @example\n * ```ts\n * import type { StoreHelpers } from '@accelint/map-toolkit/shared';\n *\n * function createCustomAction<T>(helpers: StoreHelpers<T>) {\n *   return () => {\n *     const current = helpers.get();\n *     helpers.set({ ...current, modified: true });\n *   };\n * }\n * ```\n */\nexport type StoreHelpers<TState> = {\n  /** Get current state */\n  get: () => TState;\n  /** Update state (partial merge) and notify subscribers */\n  set: (updates: Partial<TState>) => void;\n  /** Replace entire state and notify subscribers */\n  replace: (state: TState) => void;\n  /** Notify subscribers without changing state */\n  notify: () => void;\n};\n\n/**\n * Configuration for creating a map store\n */\nexport type MapStoreConfig<TState, TActions> = {\n  /** Default state for new instances and SSR */\n  defaultState: TState;\n\n  /**\n   * Action creators - receives mapId and helpers, returns action methods.\n   * Actions are cached per mapId for referential stability.\n   */\n  actions: (mapId: UniqueId, helpers: StoreHelpers<TState>) => TActions;\n\n  /**\n   * Optional bus listener setup. Called when first subscriber mounts.\n   * Return cleanup function to unsubscribe.\n   */\n  bus?: (mapId: UniqueId, helpers: StoreHelpers<TState>) => () => void;\n\n  /**\n   * Optional cleanup when instance is destroyed (last subscriber unmounts).\n   */\n  onCleanup?: (mapId: UniqueId, state: TState) => void;\n};\n\n/**\n * Instance data for a single map\n */\ntype Instance<TState, TActions> = {\n  state: TState;\n  actions?: TActions;\n  subscribers: Set<() => void>;\n  busCleanup?: () => void;\n};\n\n/**\n * The store object returned by createMapStore\n */\nexport type MapStore<TState, TActions> = {\n  /**\n   * React hook - the primary way to use the store.\n   * Returns state and actions with proper memoization.\n   */\n  use: (mapId: UniqueId) => { state: TState } & TActions;\n\n  /**\n   * React hook with selector for derived state.\n   * Only re-renders when the underlying state changes.\n   *\n   * The selector result is memoized - it only recomputes when the **state reference**\n   * changes, not on every render or when the selector function changes. This means:\n   *\n   * - Selectors that create new objects/arrays are safe without additional memoization\n   * - Changing the selector function does NOT trigger recomputation (by design)\n   * - This prevents infinite re-render loops when using inline arrow functions\n   *\n   * **Important**: The selector function is intentionally NOT tracked as a dependency.\n   * If you need the selector to change dynamically, extract the changing value as a\n   * separate dependency and use it within a stable selector, or use the `use()` hook\n   * with your own `useMemo` for derived state.\n   *\n   * @example\n   * ```ts\n   * // Returns primitive - recomputes when state.count changes\n   * const count = store.useSelector(mapId, (s) => s.count);\n   *\n   * // Returns existing reference - recomputes when state.items ref changes\n   * const items = store.useSelector(mapId, (s) => s.items);\n   *\n   * // Safe: derived object is memoized internally, no infinite loops\n   * const derived = store.useSelector(mapId, (s) => ({ doubled: s.count * 2 }));\n   *\n   * // If you need dynamic selector behavior, use the base hook instead:\n   * const { state } = store.use(mapId);\n   * const filtered = useMemo(() => filterFn(state.items), [state.items, filterFn]);\n   * ```\n   */\n  useSelector: <TSelected>(\n    mapId: UniqueId,\n    selector: (state: TState) => TSelected,\n  ) => TSelected;\n\n  /**\n   * Get actions without subscribing to state changes.\n   * Useful for event handlers or effects.\n   */\n  actions: (mapId: UniqueId) => TActions;\n\n  /**\n   * Get current state (non-reactive, for imperative code).\n   */\n  get: (mapId: UniqueId) => TState;\n\n  /**\n   * Update state directly (usually prefer actions).\n   */\n  set: (mapId: UniqueId, updates: Partial<TState>) => void;\n\n  /**\n   * Check if instance exists (has been initialized).\n   */\n  exists: (mapId: UniqueId) => boolean;\n\n  /**\n   * Clear instance state (for tests or manual cleanup).\n   */\n  clear: (mapId: UniqueId) => void;\n\n  /**\n   * Low-level access for custom hooks or useSyncExternalStore.\n   */\n  subscribe: (mapId: UniqueId) => (callback: () => void) => () => void;\n  snapshot: (mapId: UniqueId) => () => TState;\n  serverSnapshot: () => TState;\n};\n\n/**\n * Creates a store for managing state across multiple map instances.\n *\n * @param config - Store configuration including default state, actions, and optional bus setup\n * @returns A MapStore instance with hooks and methods for accessing/updating state\n *\n * @example\n * ```ts\n * const cursorStore = createMapStore({\n *   defaultState: { cursor: 'default', owner: null },\n *\n *   actions: (mapId, { get, set }) => ({\n *     setCursor: (cursor: string, owner: string) => {\n *       set({ cursor, owner });\n *     },\n *     clearCursor: () => {\n *       set({ cursor: 'default', owner: null });\n *     },\n *   }),\n *\n *   bus: (mapId, { set }) => {\n *     return cursorBus.on(CursorEvents.change, (e) => {\n *       if (e.payload.id === mapId) {\n *         set({ cursor: e.payload.cursor });\n *       }\n *     });\n *   },\n * });\n *\n * // In component:\n * function CursorDisplay({ mapId }) {\n *   const { state, setCursor } = cursorStore.use(mapId);\n *   return <div style={{ cursor: state.cursor }} />;\n * }\n * ```\n */\nexport function createMapStore<TState, TActions>(\n  config: MapStoreConfig<TState, TActions>,\n): MapStore<TState, TActions> {\n  const { defaultState, actions: createActions, bus, onCleanup } = config;\n\n  const instances = new Map<UniqueId, Instance<TState, TActions>>();\n\n  // Cached functions for referential stability\n  const subscriptionCache = new Map<\n    UniqueId,\n    (callback: () => void) => () => void\n  >();\n  const snapshotCache = new Map<UniqueId, () => TState>();\n\n  function getInstance(mapId: UniqueId): Instance<TState, TActions> {\n    let instance = instances.get(mapId);\n    if (!instance) {\n      instance = {\n        state: { ...defaultState },\n        subscribers: new Set(),\n      };\n      instances.set(mapId, instance);\n    }\n    return instance;\n  }\n\n  function notify(mapId: UniqueId): void {\n    const instance = instances.get(mapId);\n    if (instance) {\n      for (const callback of instance.subscribers) {\n        callback();\n      }\n    }\n  }\n\n  function getHelpers(mapId: UniqueId): StoreHelpers<TState> {\n    return {\n      get: () => getInstance(mapId).state,\n      set: (updates) => {\n        const instance = getInstance(mapId);\n        instance.state = { ...instance.state, ...updates };\n        notify(mapId);\n      },\n      replace: (state) => {\n        const instance = getInstance(mapId);\n        instance.state = state;\n        notify(mapId);\n      },\n      notify: () => notify(mapId),\n    };\n  }\n\n  function getActions(mapId: UniqueId): TActions {\n    const instance = getInstance(mapId);\n    if (!instance.actions) {\n      instance.actions = createActions(mapId, getHelpers(mapId));\n    }\n    return instance.actions;\n  }\n\n  /**\n   * Clean up instance when last subscriber unmounts.\n   *\n   * @param mapId - Unique identifier for the map instance\n   * @param instance - The instance to clean up\n   */\n  function cleanupInstance(\n    mapId: UniqueId,\n    instance: Instance<TState, TActions>,\n  ): void {\n    if (onCleanup) {\n      onCleanup(mapId, instance.state);\n    }\n    if (instance.busCleanup) {\n      instance.busCleanup();\n    }\n    instances.delete(mapId);\n    subscriptionCache.delete(mapId);\n    snapshotCache.delete(mapId);\n  }\n\n  function subscribe(mapId: UniqueId): (callback: () => void) => () => void {\n    let cached = subscriptionCache.get(mapId);\n    if (!cached) {\n      cached = (callback: () => void) => {\n        const instance = getInstance(mapId);\n\n        // Setup bus on first subscriber\n        if (instance.subscribers.size === 0 && bus) {\n          instance.busCleanup = bus(mapId, getHelpers(mapId));\n        }\n\n        instance.subscribers.add(callback);\n\n        return () => {\n          instance.subscribers.delete(callback);\n\n          // Cleanup when last subscriber unmounts\n          if (instance.subscribers.size === 0) {\n            cleanupInstance(mapId, instance);\n          }\n        };\n      };\n      subscriptionCache.set(mapId, cached);\n    }\n    return cached;\n  }\n\n  function snapshot(mapId: UniqueId): () => TState {\n    let cached = snapshotCache.get(mapId);\n    if (!cached) {\n      cached = () => {\n        // State is already a new object reference when updated via set()\n        // which creates { ...instance.state, ...updates }\n        return getInstance(mapId).state;\n      };\n      snapshotCache.set(mapId, cached);\n    }\n    return cached;\n  }\n\n  function serverSnapshot(): TState {\n    return defaultState;\n  }\n\n  /**\n   * Main hook - returns state and actions.\n   *\n   * @param mapId - Unique identifier for the map instance\n   * @returns Object containing state and all actions\n   */\n  function use(mapId: UniqueId): { state: TState } & TActions {\n    const state = useSyncExternalStore(\n      subscribe(mapId),\n      snapshot(mapId),\n      serverSnapshot,\n    );\n\n    const actions = getActions(mapId);\n\n    // Return merged object with state wrapper for clarity\n    return { state, ...actions };\n  }\n\n  /**\n   * Selector hook - only re-renders when selected value changes.\n   *\n   * Note: The selector function is intentionally NOT tracked as a dependency.\n   * This prevents infinite re-render loops when using inline arrow functions.\n   * If you need dynamic selector behavior, use the `use()` hook with `useMemo`.\n   *\n   * @param mapId - Unique identifier for the map instance\n   * @param selector - Function to select derived state\n   * @returns The selected value\n   */\n  function useSelector<TSelected>(\n    mapId: UniqueId,\n    selector: (state: TState) => TSelected,\n  ): TSelected {\n    // Cache the previous state and selected value to avoid unnecessary re-computation.\n    // We intentionally do NOT track selector changes - only state changes trigger\n    // recomputation. This prevents infinite loops with inline selectors.\n    const cache = useRef<{ state: TState; selected: TSelected } | null>(null);\n\n    const state = useSyncExternalStore(\n      subscribe(mapId),\n      snapshot(mapId),\n      serverSnapshot,\n    );\n\n    // Only recompute if state reference changed (selector changes are ignored)\n    if (cache.current === null || cache.current.state !== state) {\n      cache.current = {\n        state,\n        selected: selector(state),\n      };\n    }\n\n    return cache.current.selected;\n  }\n\n  return {\n    use,\n    useSelector,\n    actions: getActions,\n    get: (mapId) => getInstance(mapId).state,\n    set: (mapId, updates) => {\n      const instance = getInstance(mapId);\n      instance.state = { ...instance.state, ...updates };\n      notify(mapId);\n    },\n    exists: (mapId) => instances.has(mapId),\n    clear: (mapId) => {\n      const instance = instances.get(mapId);\n      if (instance) {\n        cleanupInstance(mapId, instance);\n      }\n    },\n    subscribe,\n    snapshot,\n    serverSnapshot,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"create-map-store.js","names":[],"sources":["../../src/shared/create-map-store.ts"],"sourcesContent":["/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { useRef, useSyncExternalStore } from 'react';\nimport type { UniqueId } from '@accelint/core';\n\n// =============================================================================\n// Immutable Map Helpers\n// =============================================================================\n\n/**\n * Create a new Map with an entry added or updated (immutable).\n *\n * @param map - The Map to copy\n * @param key - The key to set\n * @param value - The value to set\n * @returns A new Map with the entry added/updated\n *\n * @example\n * ```ts\n * const newMap = mapSet(state.cursorOwners, 'draw-layer', 'crosshair');\n * set({ cursorOwners: newMap });\n * ```\n */\nexport function mapSet<K, V>(map: Map<K, V>, key: K, value: V): Map<K, V> {\n  const newMap = new Map(map);\n  newMap.set(key, value);\n  return newMap;\n}\n\n/**\n * Create a new Map with an entry removed (immutable).\n *\n * @param map - The Map to copy\n * @param key - The key to remove\n * @returns A new Map with the entry removed\n *\n * @example\n * ```ts\n * const newMap = mapDelete(state.cursorOwners, 'draw-layer');\n * set({ cursorOwners: newMap });\n * ```\n */\nexport function mapDelete<K, V>(map: Map<K, V>, key: K): Map<K, V> {\n  const newMap = new Map(map);\n  newMap.delete(key);\n  return newMap;\n}\n\n/**\n * Create a new empty Map (immutable replacement for Map.clear()).\n *\n * @returns A new empty Map\n *\n * @example\n * ```ts\n * set({ pendingRequests: mapClear<string, PendingRequest>() });\n * ```\n */\nexport function mapClear<K, V>(): Map<K, V> {\n  return new Map<K, V>();\n}\n\n/**\n * Helper methods passed to action creators and bus setup functions.\n *\n * This type is exported for consumers building custom store extensions or\n * helper functions that need to interact with store state.\n *\n * @example\n * ```ts\n * import type { StoreHelpers } from '@accelint/map-toolkit/shared';\n *\n * function createCustomAction<T>(helpers: StoreHelpers<T>) {\n *   return () => {\n *     const current = helpers.get();\n *     helpers.set({ ...current, modified: true });\n *   };\n * }\n * ```\n */\nexport type StoreHelpers<TState> = {\n  /** Get current state */\n  get: () => TState;\n  /** Update state (partial merge) and notify subscribers */\n  set: (updates: Partial<TState>) => void;\n  /** Replace entire state and notify subscribers */\n  replace: (state: TState) => void;\n  /** Notify subscribers without changing state */\n  notify: () => void;\n};\n\n/**\n * Configuration for creating a map store\n */\nexport type MapStoreConfig<TState, TActions> = {\n  /** Default state for new instances and SSR */\n  defaultState: TState;\n\n  /**\n   * Action creators - receives mapId and helpers, returns action methods.\n   * Actions are cached per mapId for referential stability.\n   */\n  actions: (mapId: UniqueId, helpers: StoreHelpers<TState>) => TActions;\n\n  /**\n   * Optional bus listener setup. Called when first subscriber mounts.\n   * Return cleanup function to unsubscribe.\n   */\n  bus?: (mapId: UniqueId, helpers: StoreHelpers<TState>) => () => void;\n\n  /**\n   * Optional cleanup when instance is destroyed (last subscriber unmounts).\n   */\n  onCleanup?: (mapId: UniqueId, state: TState) => void;\n};\n\n/**\n * Instance data for a single map\n */\ntype Instance<TState, TActions> = {\n  state: TState;\n  actions?: TActions;\n  subscribers: Set<() => void>;\n  busCleanup?: () => void;\n};\n\n/**\n * The store object returned by createMapStore\n */\nexport type MapStore<TState, TActions> = {\n  /**\n   * React hook - the primary way to use the store.\n   * Returns state and actions with proper memoization.\n   */\n  use: (mapId: UniqueId) => { state: TState } & TActions;\n\n  /**\n   * React hook with selector for derived state.\n   * Only re-renders when the underlying state changes.\n   *\n   * The selector result is memoized - it only recomputes when the **state reference**\n   * changes, not on every render or when the selector function changes. This means:\n   *\n   * - Selectors that create new objects/arrays are safe without additional memoization\n   * - Changing the selector function does NOT trigger recomputation (by design)\n   * - This prevents infinite re-render loops when using inline arrow functions\n   *\n   * **Important**: The selector function is intentionally NOT tracked as a dependency.\n   * If you need the selector to change dynamically, extract the changing value as a\n   * separate dependency and use it within a stable selector, or use the `use()` hook\n   * with your own `useMemo` for derived state.\n   *\n   * @example\n   * ```ts\n   * // Returns primitive - recomputes when state.count changes\n   * const count = store.useSelector(mapId, (s) => s.count);\n   *\n   * // Returns existing reference - recomputes when state.items ref changes\n   * const items = store.useSelector(mapId, (s) => s.items);\n   *\n   * // Safe: derived object is memoized internally, no infinite loops\n   * const derived = store.useSelector(mapId, (s) => ({ doubled: s.count * 2 }));\n   *\n   * // If you need dynamic selector behavior, use the base hook instead:\n   * const { state } = store.use(mapId);\n   * const filtered = useMemo(() => filterFn(state.items), [state.items, filterFn]);\n   * ```\n   */\n  useSelector: <TSelected>(\n    mapId: UniqueId,\n    selector: (state: TState) => TSelected,\n  ) => TSelected;\n\n  /**\n   * Get actions without subscribing to state changes.\n   * Useful for event handlers or effects.\n   */\n  actions: (mapId: UniqueId) => TActions;\n\n  /**\n   * Get current state (non-reactive, for imperative code).\n   */\n  get: (mapId: UniqueId) => TState;\n\n  /**\n   * Update state directly (usually prefer actions).\n   */\n  set: (mapId: UniqueId, updates: Partial<TState>) => void;\n\n  /**\n   * Check if instance exists (has been initialized).\n   */\n  exists: (mapId: UniqueId) => boolean;\n\n  /**\n   * Clear instance state (for tests or manual cleanup).\n   */\n  clear: (mapId: UniqueId) => void;\n\n  /**\n   * Set initial state to be used when instance is created or updated.\n   * Handles both initialization scenarios:\n   * - If instance doesn't exist yet: stores pending state for getInstance\n   * - If instance already exists: updates existing instance directly\n   *\n   * This dual-path approach ensures correct initialization regardless of\n   * React lifecycle timing (e.g., React Strict Mode double-mount).\n   *\n   * Safe to call during render. Idempotent for repeated calls with same state.\n   */\n  setInitialState: (mapId: UniqueId, state: TState) => void;\n\n  /**\n   * Low-level access for custom hooks or useSyncExternalStore.\n   */\n  subscribe: (mapId: UniqueId) => (callback: () => void) => () => void;\n  snapshot: (mapId: UniqueId) => () => TState;\n  serverSnapshot: () => TState;\n};\n\n/**\n * Creates a store for managing state across multiple map instances.\n *\n * @param config - Store configuration including default state, actions, and optional bus setup\n * @returns A MapStore instance with hooks and methods for accessing/updating state\n *\n * @example\n * ```ts\n * const cursorStore = createMapStore({\n *   defaultState: { cursor: 'default', owner: null },\n *\n *   actions: (mapId, { get, set }) => ({\n *     setCursor: (cursor: string, owner: string) => {\n *       set({ cursor, owner });\n *     },\n *     clearCursor: () => {\n *       set({ cursor: 'default', owner: null });\n *     },\n *   }),\n *\n *   bus: (mapId, { set }) => {\n *     return cursorBus.on(CursorEvents.change, (e) => {\n *       if (e.payload.id === mapId) {\n *         set({ cursor: e.payload.cursor });\n *       }\n *     });\n *   },\n * });\n *\n * // In component:\n * function CursorDisplay({ mapId }) {\n *   const { state, setCursor } = cursorStore.use(mapId);\n *   return <div style={{ cursor: state.cursor }} />;\n * }\n * ```\n */\nexport function createMapStore<TState, TActions>(\n  config: MapStoreConfig<TState, TActions>,\n): MapStore<TState, TActions> {\n  const { defaultState, actions: createActions, bus, onCleanup } = config;\n\n  const instances = new Map<UniqueId, Instance<TState, TActions>>();\n\n  // Stores initial state to be used when instance is first created\n  // This allows setting initial state BEFORE any getInstance call\n  const pendingInitialState = new Map<UniqueId, TState>();\n\n  // Cached functions for referential stability\n  const subscriptionCache = new Map<\n    UniqueId,\n    (callback: () => void) => () => void\n  >();\n  const snapshotCache = new Map<UniqueId, () => TState>();\n\n  function getInstance(mapId: UniqueId): Instance<TState, TActions> {\n    let instance = instances.get(mapId);\n    if (!instance) {\n      // Check for pending initial state - use it instead of default\n      const initialState = pendingInitialState.get(mapId);\n      instance = {\n        state: initialState ?? { ...defaultState },\n        subscribers: new Set(),\n      };\n      instances.set(mapId, instance);\n      pendingInitialState.delete(mapId); // Clear after use\n    }\n    return instance;\n  }\n\n  function notify(mapId: UniqueId): void {\n    const instance = instances.get(mapId);\n    if (instance) {\n      for (const callback of instance.subscribers) {\n        callback();\n      }\n    }\n  }\n\n  function getHelpers(mapId: UniqueId): StoreHelpers<TState> {\n    return {\n      get: () => getInstance(mapId).state,\n      set: (updates) => {\n        const instance = getInstance(mapId);\n        instance.state = { ...instance.state, ...updates };\n        notify(mapId);\n      },\n      replace: (state) => {\n        const instance = getInstance(mapId);\n        instance.state = state;\n        notify(mapId);\n      },\n      notify: () => notify(mapId),\n    };\n  }\n\n  function getActions(mapId: UniqueId): TActions {\n    const instance = getInstance(mapId);\n    if (!instance.actions) {\n      instance.actions = createActions(mapId, getHelpers(mapId));\n    }\n    return instance.actions;\n  }\n\n  /**\n   * Clean up instance when last subscriber unmounts.\n   *\n   * @param mapId - Unique identifier for the map instance\n   * @param instance - The instance to clean up\n   */\n  function cleanupInstance(\n    mapId: UniqueId,\n    instance: Instance<TState, TActions>,\n  ): void {\n    if (onCleanup) {\n      onCleanup(mapId, instance.state);\n    }\n    if (instance.busCleanup) {\n      instance.busCleanup();\n    }\n    instances.delete(mapId);\n    // NOTE: Do NOT delete subscriptionCache or snapshotCache here!\n    // These are function reference caches. Clearing them causes React's\n    // useSyncExternalStore to see a new subscribe function reference on the next\n    // render, which triggers re-subscription, which triggers cleanupInstance again,\n    // creating an infinite cycle. The cached functions call getInstance() dynamically,\n    // so they work correctly even after the instance is recreated.\n    //\n    // NOTE: Do NOT delete pendingInitialState here!\n    // In React Strict Mode, cleanup runs but then subscribe re-runs BEFORE render.\n    // The pending state must survive cleanup so it's available when getInstance\n    // creates a new instance during the Strict Mode remount.\n  }\n\n  function subscribe(mapId: UniqueId): (callback: () => void) => () => void {\n    let cached = subscriptionCache.get(mapId);\n    if (!cached) {\n      cached = (callback: () => void) => {\n        const instance = getInstance(mapId);\n\n        // Setup bus on first subscriber\n        if (instance.subscribers.size === 0 && bus) {\n          instance.busCleanup = bus(mapId, getHelpers(mapId));\n        }\n\n        instance.subscribers.add(callback);\n\n        return () => {\n          instance.subscribers.delete(callback);\n\n          // Cleanup when last subscriber unmounts\n          if (instance.subscribers.size === 0) {\n            cleanupInstance(mapId, instance);\n          }\n        };\n      };\n      subscriptionCache.set(mapId, cached);\n    }\n    return cached;\n  }\n\n  function snapshot(mapId: UniqueId): () => TState {\n    let cached = snapshotCache.get(mapId);\n    if (!cached) {\n      cached = () => {\n        // State is already a new object reference when updated via set()\n        // which creates { ...instance.state, ...updates }\n        return getInstance(mapId).state;\n      };\n      snapshotCache.set(mapId, cached);\n    }\n    return cached;\n  }\n\n  function serverSnapshot(): TState {\n    return defaultState;\n  }\n\n  /**\n   * Main hook - returns state and actions.\n   *\n   * @param mapId - Unique identifier for the map instance\n   * @returns Object containing state and all actions\n   */\n  function use(mapId: UniqueId): { state: TState } & TActions {\n    const state = useSyncExternalStore(\n      subscribe(mapId),\n      snapshot(mapId),\n      serverSnapshot,\n    );\n\n    const actions = getActions(mapId);\n\n    // Return merged object with state wrapper for clarity\n    return { state, ...actions };\n  }\n\n  /**\n   * Selector hook - only re-renders when selected value changes.\n   *\n   * Note: The selector function is intentionally NOT tracked as a dependency.\n   * This prevents infinite re-render loops when using inline arrow functions.\n   * If you need dynamic selector behavior, use the `use()` hook with `useMemo`.\n   *\n   * @param mapId - Unique identifier for the map instance\n   * @param selector - Function to select derived state\n   * @returns The selected value\n   */\n  function useSelector<TSelected>(\n    mapId: UniqueId,\n    selector: (state: TState) => TSelected,\n  ): TSelected {\n    // Cache the previous state and selected value to avoid unnecessary re-computation.\n    // We intentionally do NOT track selector changes - only state changes trigger\n    // recomputation. This prevents infinite loops with inline selectors.\n    const cache = useRef<{ state: TState; selected: TSelected } | null>(null);\n\n    const state = useSyncExternalStore(\n      subscribe(mapId),\n      snapshot(mapId),\n      serverSnapshot,\n    );\n\n    // Only recompute if state reference changed (selector changes are ignored)\n    if (cache.current === null || cache.current.state !== state) {\n      cache.current = {\n        state,\n        selected: selector(state),\n      };\n    }\n\n    return cache.current.selected;\n  }\n\n  return {\n    use,\n    useSelector,\n    actions: getActions,\n    get: (mapId) => getInstance(mapId).state,\n    set: (mapId, updates) => {\n      const instance = getInstance(mapId);\n      instance.state = { ...instance.state, ...updates };\n      notify(mapId);\n    },\n    exists: (mapId) => instances.has(mapId),\n    clear: (mapId) => {\n      const instance = instances.get(mapId);\n      if (instance) {\n        cleanupInstance(mapId, instance);\n      }\n    },\n    setInitialState: (mapId, state) => {\n      // If instance already exists, update it directly.\n      // This handles React Strict Mode where subscribe() might create the instance\n      // BEFORE setInitialState is called during the re-render.\n      const instance = instances.get(mapId);\n      if (instance) {\n        instance.state = state;\n        // Don't call notify() - this is initialization, not a state change that\n        // should trigger re-renders. The component will get the state on next render.\n      }\n\n      // Always also set pending state for the case where getInstance is called later\n      pendingInitialState.set(mapId, state);\n    },\n    subscribe,\n    snapshot,\n    serverSnapshot,\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@accelint/map-toolkit",
   "description": "A collection of components and utilities to simplify visualizing and working with geospatial data.",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "author": "https://hypergiant.com",
   "$schema": "https://json.schemastore.org/package",
   "devDependencies": {
@@ -46,11 +46,11 @@
     "@accelint/bus": "3.0.2",
     "@accelint/core": "0.5.2",
     "@accelint/design-foundation": "3.0.0",
-    "@accelint/design-toolkit": "9.6.0",
+    "@accelint/design-toolkit": "9.7.0",
     "@accelint/geo": "0.6.0",
-    "@accelint/logger": "0.1.5",
-    "@accelint/postcss-tailwind-css-modules": "1.0.1",
+    "@accelint/logger": "1.0.0",
     "@accelint/smeegl": "0.3.5",
+    "@accelint/postcss-tailwind-css-modules": "1.0.1",
     "@accelint/typescript-config": "0.1.4",
     "@accelint/vitest-config": "0.1.6"
   },
@@ -113,6 +113,7 @@
     "./map-mode/use-map-mode": "./dist/map-mode/use-map-mode.js",
     "./maplibre": "./dist/maplibre/index.js",
     "./maplibre/hooks/use-maplibre": "./dist/maplibre/hooks/use-maplibre.js",
+    "./shared/cleanup": "./dist/shared/cleanup.js",
     "./shared/constants": "./dist/shared/constants.js",
     "./shared/create-map-store": "./dist/shared/create-map-store.js",
     "./shared/units": "./dist/shared/units.js",
@@ -161,7 +162,7 @@
     "@accelint/bus": "3.0.2",
     "@accelint/core": "0.5.2",
     "@accelint/geo": "0.6.0",
-    "@accelint/logger": "0.1.5"
+    "@accelint/logger": "1.0.0"
   },
   "private": false,
   "publishConfig": {