@accelint/map-toolkit 1.4.0 → 2.0.0

package/dist/deckgl/shapes/shared/utils/style-utils.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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
@@ -11,8 +11,6 @@
  */
 
 
-'use client';
-
 import { BASE_FILL_OPACITY, DASH_ARRAYS, DEFAULT_COLORS, DEFAULT_LINE_WIDTH } from "../constants.js";
 
 //#region src/deckgl/shapes/shared/utils/style-utils.ts
@@ -20,45 +18,44 @@ import { BASE_FILL_OPACITY, DASH_ARRAYS, DEFAULT_COLORS, DEFAULT_LINE_WIDTH } fr
 * Normalize a Color to a 4-element RGBA array.
 * Handles RGB arrays (adds alpha 255), RGBA arrays, and typed arrays.
 *
-* @param color - The color to normalize
-* @returns 4-element RGBA array [r, g, b, a]
+* @param color - The color to normalize.
+* @returns 4-element RGBA array [r, g, b, a].
+* @example
+* ```typescript
+* normalizeColor([255, 128, 0]);        // → [255, 128, 0, 255]
+* normalizeColor([255, 128, 0, 200]);   // → [255, 128, 0, 200]
+* ```
 */
 function normalizeColor(color) {
-	if (color instanceof Uint8Array || color instanceof Uint8ClampedArray) return [
+	if (color instanceof Uint8Array || color instanceof Uint8ClampedArray || Array.isArray(color) && color.length >= 3) return [
 		color[0] ?? 0,
 		color[1] ?? 0,
 		color[2] ?? 0,
 		color[3] ?? 255
 	];
-	if (!Array.isArray(color) || color.length < 3) return [
+	return [
 		0,
 		0,
 		0,
 		255
 	];
-	return [
-		color[0] ?? 0,
-		color[1] ?? 0,
-		color[2] ?? 0,
-		color[3] ?? 255
-	];
 }
 /**
 * Get fill color for a feature.
 * Colors are passed through as-is unless applyBaseOpacity is true.
 *
-* @param feature - The styled feature
-* @param applyBaseOpacity - When true, multiplies alpha by BASE_FILL_OPACITY (0.2)
-* @returns RGBA color array
+* @param feature - The styled feature.
+* @param applyBaseOpacity - When true, multiplies alpha by BASE_FILL_OPACITY (0.2).
+* @returns RGBA color array.
+* @example
+* ```typescript
+* getFillColor(feature);        // → [255, 255, 255, 255]  (full opacity)
+* getFillColor(feature, true);  // → [255, 255, 255, 51]   (255 × 0.2)
+* ```
 */
 function getFillColor(feature, applyBaseOpacity = false) {
-	const rgba = normalizeColor((feature.properties?.styleProperties)?.fillColor ?? DEFAULT_COLORS.fill);
-	if (applyBaseOpacity) return [
-		rgba[0],
-		rgba[1],
-		rgba[2],
-		Math.round(rgba[3] * BASE_FILL_OPACITY)
-	];
+	const rgba = normalizeColor(feature.properties.styleProperties?.fillColor ?? DEFAULT_COLORS.fill);
+	if (applyBaseOpacity) rgba[3] = Math.round(rgba[3] * BASE_FILL_OPACITY);
 	return rgba;
 }
 /**
@@ -68,11 +65,15 @@ function getFillColor(feature, applyBaseOpacity = false) {
 * Named to match deck.gl's `getLineColor` accessor convention.
 * Reads from `lineColor` in the feature's style properties.
 *
-* @param feature - The styled feature
-* @returns RGBA color array
+* @param feature - The styled feature.
+* @returns RGBA color array.
+* @example
+* ```typescript
+* getLineColor(feature); // → [136, 138, 143, 255]  (default line color)
+* ```
 */
 function getLineColor(feature) {
-	return normalizeColor((feature.properties?.styleProperties)?.lineColor ?? DEFAULT_COLORS.line);
+	return normalizeColor(feature.properties.styleProperties?.lineColor ?? DEFAULT_COLORS.line);
 }
 /**
 * Get border/outline width for a feature.
@@ -80,20 +81,30 @@ function getLineColor(feature) {
 * Named to match deck.gl's `getLineWidth` accessor convention.
 * Reads from `lineWidth` in the feature's style properties.
 *
-* @param feature - The styled feature
-* @returns Border/outline width in pixels
+* @param feature - The styled feature.
+* @returns Border/outline width in pixels.
+* @example
+* ```typescript
+* getLineWidth(feature); // → 2  (default width)
+* ```
 */
 function getLineWidth(feature) {
-	return (feature.properties?.styleProperties)?.lineWidth ?? DEFAULT_LINE_WIDTH;
+	return feature.properties.styleProperties?.lineWidth ?? DEFAULT_LINE_WIDTH;
 }
 /**
 * Get dash array for border/outline pattern.
 *
-* @param feature - The styled feature
-* @returns Dash array [dash, gap] or null for solid outlines
+* @param feature - The styled feature.
+* @returns Dash array [dash, gap] or null for solid outlines.
+* @example
+* ```typescript
+* getDashArray(solidFeature);   // → null
+* getDashArray(dashedFeature);  // → [8, 4]
+* getDashArray(dottedFeature);  // → [2, 4]
+* ```
 */
 function getDashArray(feature) {
-	return DASH_ARRAYS[(feature.properties?.styleProperties)?.linePattern ?? "solid"] || null;
+	return DASH_ARRAYS[feature.properties.styleProperties?.linePattern ?? "solid"] ?? null;
 }
 
 //#endregion

package/dist/deckgl/shapes/shared/utils/style-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"style-utils.js","names":[],"sources":["../../../../../src/deckgl/shapes/shared/utils/style-utils.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 {\n  BASE_FILL_OPACITY,\n  DASH_ARRAYS,\n  DEFAULT_COLORS,\n  DEFAULT_LINE_WIDTH,\n} from '../constants';\nimport type { Color } from '@deck.gl/core';\nimport type { StyledFeature } from '../types';\n\n/**\n * Normalize a Color to a 4-element RGBA array.\n * Handles RGB arrays (adds alpha 255), RGBA arrays, and typed arrays.\n *\n * @param color - The color to normalize\n * @returns 4-element RGBA array [r, g, b, a]\n */\nexport function normalizeColor(color: Color): [number, number, number, number] {\n  if (color instanceof Uint8Array || color instanceof Uint8ClampedArray) {\n    return [color[0] ?? 0, color[1] ?? 0, color[2] ?? 0, color[3] ?? 255];\n  }\n\n  // Handle RGB (3-element) or RGBA (4-element) arrays\n  // Validate array has at least 3 elements for RGB\n  if (!Array.isArray(color) || color.length < 3) {\n    return [0, 0, 0, 255]; // Fallback to opaque black\n  }\n  return [color[0] ?? 0, color[1] ?? 0, color[2] ?? 0, color[3] ?? 255];\n}\n\n/**\n * Get fill color for a feature.\n * Colors are passed through as-is unless applyBaseOpacity is true.\n *\n * @param feature - The styled feature\n * @param applyBaseOpacity - When true, multiplies alpha by BASE_FILL_OPACITY (0.2)\n * @returns RGBA color array\n */\nexport function getFillColor(\n  feature: StyledFeature,\n  applyBaseOpacity = false,\n): Color {\n  const styleProps = feature.properties?.styleProperties;\n  const color = styleProps?.fillColor ?? DEFAULT_COLORS.fill;\n\n  // Normalize to 4-element array\n  const rgba = normalizeColor(color);\n\n  if (applyBaseOpacity) {\n    // Apply base opacity multiplier to alpha channel\n    return [rgba[0], rgba[1], rgba[2], Math.round(rgba[3] * BASE_FILL_OPACITY)];\n  }\n\n  return rgba;\n}\n\n/**\n * Get border/outline color for a feature.\n * Outlines are always rendered at their literal alpha value.\n *\n * Named to match deck.gl's `getLineColor` accessor convention.\n * Reads from `lineColor` in the feature's style properties.\n *\n * @param feature - The styled feature\n * @returns RGBA color array\n */\nexport function getLineColor(feature: StyledFeature): Color {\n  const styleProps = feature.properties?.styleProperties;\n  const color = styleProps?.lineColor ?? DEFAULT_COLORS.line;\n\n  return normalizeColor(color);\n}\n\n/**\n * Get border/outline width for a feature.\n *\n * Named to match deck.gl's `getLineWidth` accessor convention.\n * Reads from `lineWidth` in the feature's style properties.\n *\n * @param feature - The styled feature\n * @returns Border/outline width in pixels\n */\nexport function getLineWidth(feature: StyledFeature): number {\n  const styleProps = feature.properties?.styleProperties;\n  return styleProps?.lineWidth ?? DEFAULT_LINE_WIDTH;\n}\n\n/**\n * Get dash array for border/outline pattern.\n *\n * @param feature - The styled feature\n * @returns Dash array [dash, gap] or null for solid outlines\n */\nexport function getDashArray(feature: StyledFeature): [number, number] | null {\n  const styleProps = feature.properties?.styleProperties;\n  const pattern = styleProps?.linePattern ?? 'solid';\n\n  return DASH_ARRAYS[pattern] || null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,eAAe,OAAgD;AAC7E,KAAI,iBAAiB,cAAc,iBAAiB,kBAClD,QAAO;EAAC,MAAM,MAAM;EAAG,MAAM,MAAM;EAAG,MAAM,MAAM;EAAG,MAAM,MAAM;EAAI;AAKvE,KAAI,CAAC,MAAM,QAAQ,MAAM,IAAI,MAAM,SAAS,EAC1C,QAAO;EAAC;EAAG;EAAG;EAAG;EAAI;AAEvB,QAAO;EAAC,MAAM,MAAM;EAAG,MAAM,MAAM;EAAG,MAAM,MAAM;EAAG,MAAM,MAAM;EAAI;;;;;;;;;;AAWvE,SAAgB,aACd,SACA,mBAAmB,OACZ;CAKP,MAAM,OAAO,gBAJM,QAAQ,YAAY,kBACb,aAAa,eAAe,KAGpB;AAElC,KAAI,iBAEF,QAAO;EAAC,KAAK;EAAI,KAAK;EAAI,KAAK;EAAI,KAAK,MAAM,KAAK,KAAK,kBAAkB;EAAC;AAG7E,QAAO;;;;;;;;;;;;AAaT,SAAgB,aAAa,SAA+B;AAI1D,QAAO,gBAHY,QAAQ,YAAY,kBACb,aAAa,eAAe,KAE1B;;;;;;;;;;;AAY9B,SAAgB,aAAa,SAAgC;AAE3D,SADmB,QAAQ,YAAY,kBACpB,aAAa;;;;;;;;AASlC,SAAgB,aAAa,SAAiD;AAI5E,QAAO,aAHY,QAAQ,YAAY,kBACX,eAAe,YAEZ"}
+{"version":3,"file":"style-utils.js","names":[],"sources":["../../../../../src/deckgl/shapes/shared/utils/style-utils.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 {\n  BASE_FILL_OPACITY,\n  DASH_ARRAYS,\n  DEFAULT_COLORS,\n  DEFAULT_LINE_WIDTH,\n} from '../constants';\nimport type { Color } from '@deck.gl/core';\nimport type { StyledFeature } from '../types';\n\n/**\n * Normalize a Color to a 4-element RGBA array.\n * Handles RGB arrays (adds alpha 255), RGBA arrays, and typed arrays.\n *\n * @param color - The color to normalize.\n * @returns 4-element RGBA array [r, g, b, a].\n * @example\n * ```typescript\n * normalizeColor([255, 128, 0]);        // → [255, 128, 0, 255]\n * normalizeColor([255, 128, 0, 200]);   // → [255, 128, 0, 200]\n * ```\n */\nexport function normalizeColor(color: Color): [number, number, number, number] {\n  if (\n    color instanceof Uint8Array ||\n    color instanceof Uint8ClampedArray ||\n    (Array.isArray(color) && color.length >= 3)\n  ) {\n    return [color[0] ?? 0, color[1] ?? 0, color[2] ?? 0, color[3] ?? 255];\n  }\n\n  return [0, 0, 0, 255]; // Fallback to opaque black for malformed input\n}\n\n/**\n * Get fill color for a feature.\n * Colors are passed through as-is unless applyBaseOpacity is true.\n *\n * @param feature - The styled feature.\n * @param applyBaseOpacity - When true, multiplies alpha by BASE_FILL_OPACITY (0.2).\n * @returns RGBA color array.\n * @example\n * ```typescript\n * getFillColor(feature);        // → [255, 255, 255, 255]  (full opacity)\n * getFillColor(feature, true);  // → [255, 255, 255, 51]   (255 × 0.2)\n * ```\n */\nexport function getFillColor(\n  feature: StyledFeature,\n  applyBaseOpacity = false,\n): [number, number, number, number] {\n  const color =\n    feature.properties.styleProperties?.fillColor ?? DEFAULT_COLORS.fill;\n\n  const rgba = normalizeColor(color);\n\n  if (applyBaseOpacity) {\n    rgba[3] = Math.round(rgba[3] * BASE_FILL_OPACITY);\n  }\n\n  return rgba;\n}\n\n/**\n * Get border/outline color for a feature.\n * Outlines are always rendered at their literal alpha value.\n *\n * Named to match deck.gl's `getLineColor` accessor convention.\n * Reads from `lineColor` in the feature's style properties.\n *\n * @param feature - The styled feature.\n * @returns RGBA color array.\n * @example\n * ```typescript\n * getLineColor(feature); // → [136, 138, 143, 255]  (default line color)\n * ```\n */\nexport function getLineColor(\n  feature: StyledFeature,\n): [number, number, number, number] {\n  const color =\n    feature.properties.styleProperties?.lineColor ?? DEFAULT_COLORS.line;\n\n  return normalizeColor(color);\n}\n\n/**\n * Get border/outline width for a feature.\n *\n * Named to match deck.gl's `getLineWidth` accessor convention.\n * Reads from `lineWidth` in the feature's style properties.\n *\n * @param feature - The styled feature.\n * @returns Border/outline width in pixels.\n * @example\n * ```typescript\n * getLineWidth(feature); // → 2  (default width)\n * ```\n */\nexport function getLineWidth(feature: StyledFeature): number {\n  return feature.properties.styleProperties?.lineWidth ?? DEFAULT_LINE_WIDTH;\n}\n\n/**\n * Get dash array for border/outline pattern.\n *\n * @param feature - The styled feature.\n * @returns Dash array [dash, gap] or null for solid outlines.\n * @example\n * ```typescript\n * getDashArray(solidFeature);   // → null\n * getDashArray(dashedFeature);  // → [8, 4]\n * getDashArray(dottedFeature);  // → [2, 4]\n * ```\n */\nexport function getDashArray(feature: StyledFeature): [number, number] | null {\n  const pattern = feature.properties.styleProperties?.linePattern ?? 'solid';\n\n  return DASH_ARRAYS[pattern] ?? null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,SAAgB,eAAe,OAAgD;AAC7E,KACE,iBAAiB,cACjB,iBAAiB,qBAChB,MAAM,QAAQ,MAAM,IAAI,MAAM,UAAU,EAEzC,QAAO;EAAC,MAAM,MAAM;EAAG,MAAM,MAAM;EAAG,MAAM,MAAM;EAAG,MAAM,MAAM;EAAI;AAGvE,QAAO;EAAC;EAAG;EAAG;EAAG;EAAI;;;;;;;;;;;;;;;AAgBvB,SAAgB,aACd,SACA,mBAAmB,OACe;CAIlC,MAAM,OAAO,eAFX,QAAQ,WAAW,iBAAiB,aAAa,eAAe,KAEhC;AAElC,KAAI,iBACF,MAAK,KAAK,KAAK,MAAM,KAAK,KAAK,kBAAkB;AAGnD,QAAO;;;;;;;;;;;;;;;;AAiBT,SAAgB,aACd,SACkC;AAIlC,QAAO,eAFL,QAAQ,WAAW,iBAAiB,aAAa,eAAe,KAEtC;;;;;;;;;;;;;;;AAgB9B,SAAgB,aAAa,SAAgC;AAC3D,QAAO,QAAQ,WAAW,iBAAiB,aAAa;;;;;;;;;;;;;;AAe1D,SAAgB,aAAa,SAAiD;AAG5E,QAAO,YAFS,QAAQ,WAAW,iBAAiB,eAAe,YAEpC"}

package/dist/deckgl/symbol-layer/fiber.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/deckgl/symbol-layer/fiber.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/deckgl/symbol-layer/index.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/deckgl/symbol-layer/index.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/deckgl/text-layer/character-sets.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/deckgl/text-layer/default-settings.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/deckgl/text-layer/default-settings.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/deckgl/text-layer/fiber.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/deckgl/text-layer/fiber.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/deckgl/text-layer/index.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/deckgl/text-layer/index.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/deckgl/text-settings.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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
@@ -68,9 +68,9 @@ declare const DEFAULT_TEXT_STYLE: {
   };
   fontWeight: number;
   getSize: number;
-  getColor: [number, number, number, number];
+  getColor: readonly [number, number, number, number];
   outlineWidth: number;
-  outlineColor: [number, number, number, number];
+  outlineColor: readonly [number, number, number, number];
 };
 //#endregion
 export { DEFAULT_FONT_WEIGHT, DEFAULT_TEXT_COLOR, DEFAULT_TEXT_OUTLINE_COLOR, DEFAULT_TEXT_OUTLINE_WIDTH, DEFAULT_TEXT_SIZE, DEFAULT_TEXT_STYLE, SDF_FONT_SETTINGS };

package/dist/deckgl/text-settings.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/map-cursor/events.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/map-cursor/index.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/map-cursor/index.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/map-cursor/store.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/map-cursor/store.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/map-cursor/types.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/map-cursor/types.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/map-cursor/use-map-cursor.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/map-cursor/use-map-cursor.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/map-mode/events.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/map-mode/index.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/map-mode/index.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/map-mode/store.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/map-mode/store.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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
@@ -12,9 +12,9 @@
 
 
 import { createMapStore, mapClear, mapDelete, mapSet } from "../shared/create-map-store.js";
+import { createLoggerDomain } from "../shared/logger.js";
 import { MapModeEvents } from "./events.js";
 import { Broadcast } from "@accelint/bus";
-import { getLogger } from "@accelint/logger";
 import { uuid } from "@accelint/core";
 
 //#region src/map-mode/store.ts
@@ -41,12 +41,7 @@ import { uuid } from "@accelint/core";
 * }
 * ```
 */
-const logger = getLogger({
-	enabled: process.env.NODE_ENV !== "production" && process.env.NODE_ENV !== "test",
-	level: "warn",
-	prefix: "[MapMode]",
-	pretty: true
-});
+const logger = createLoggerDomain("[MapMode]");
 const DEFAULT_MODE = "default";
 /**
 * Typed event bus instance for map mode events.

package/dist/map-mode/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","names":["requestsToReject: PendingRequest[]","matchingRequestOwner: string | null","matchingRequest: PendingRequest | null"],"sources":["../../src/map-mode/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\n/**\n * Map Mode Store\n *\n * Manages mode state with ownership-based authorization.\n *\n * @example\n * ```tsx\n * import { modeStore } from '@accelint/map-toolkit/map-mode';\n *\n * function MapControls({ mapId }) {\n *   const { state, requestModeChange } = modeStore.use(mapId);\n *\n *   return (\n *     <div>\n *       <p>Current mode: {state.mode}</p>\n *       <button onClick={() => requestModeChange('draw', 'draw-layer')}>\n *         Draw Mode\n *       </button>\n *     </div>\n *   );\n * }\n * ```\n */\n\nimport { Broadcast } from '@accelint/bus';\nimport { uuid } from '@accelint/core';\nimport { getLogger } from '@accelint/logger';\nimport {\n  createMapStore,\n  mapClear,\n  mapDelete,\n  mapSet,\n} from '../shared/create-map-store';\nimport { MapModeEvents } from './events';\nimport type { UniqueId } from '@accelint/core';\nimport type { StoreHelpers } from '../shared/create-map-store';\nimport type { MapModeEventType, ModeChangeDecisionPayload } from './types';\n\nconst logger = getLogger({\n  enabled:\n    process.env.NODE_ENV !== 'production' && process.env.NODE_ENV !== 'test',\n  level: 'warn',\n  prefix: '[MapMode]',\n  pretty: true,\n});\n\nconst DEFAULT_MODE = 'default';\n\n/**\n * Typed event bus instance for map mode events.\n */\nconst mapModeBus = Broadcast.getInstance<MapModeEventType>();\n\n/**\n * Internal type for tracking pending authorization requests.\n */\ntype PendingRequest = {\n  authId: string;\n  desiredMode: string;\n  currentMode: string;\n  requestOwner: string;\n};\n\n/**\n * State shape for map mode\n */\ntype MapModeState = {\n  mode: string;\n  modeOwners: Map<string, string>;\n  pendingRequests: Map<string, PendingRequest>;\n};\n\n/**\n * Actions for map mode\n */\ntype MapModeActions = {\n  /** Request a mode change */\n  requestModeChange: (desiredMode: string, requestOwner: string) => void;\n};\n\n/**\n * Determine if a mode change request should be auto-accepted without authorization.\n *\n * Auto-accept conditions:\n * - Owner returning to default mode\n * - Owner switching between their own modes\n * - No ownership conflicts exist\n * - Entering an owned mode from default mode\n *\n * @param state - Current mode state\n * @param desiredMode - The mode being requested\n * @param requestOwner - The component requesting the mode change\n * @returns True if the request should be auto-accepted\n */\nfunction shouldAutoAcceptRequest(\n  state: MapModeState,\n  desiredMode: string,\n  requestOwner: string,\n): boolean {\n  const currentModeOwner = state.modeOwners.get(state.mode);\n  const desiredModeOwner = state.modeOwners.get(desiredMode);\n\n  // Owner returning to default mode\n  if (desiredMode === DEFAULT_MODE && requestOwner === currentModeOwner) {\n    return true;\n  }\n\n  // Owner switching between their own modes\n  if (requestOwner === currentModeOwner) {\n    return true;\n  }\n\n  // No ownership conflicts exist\n  if (!(currentModeOwner || desiredModeOwner)) {\n    return true;\n  }\n\n  // Entering an owned mode from default mode\n  if (state.mode === DEFAULT_MODE && requestOwner === desiredModeOwner) {\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * Approve a request and reject all others (immutable update)\n */\nfunction approveRequestAndRejectOthers(\n  instanceId: UniqueId,\n  state: MapModeState,\n  approvedRequest: PendingRequest,\n  excludeAuthId: string,\n  decisionOwner: string,\n  reason: string,\n  emitApproval: boolean,\n  set: StoreHelpers<MapModeState>['set'],\n): void {\n  // Collect all other pending requests to emit rejections for\n  const requestsToReject: PendingRequest[] = [];\n  for (const request of state.pendingRequests.values()) {\n    if (request.authId !== excludeAuthId) {\n      requestsToReject.push(request);\n    }\n  }\n\n  // Build immutable updates: clear pending requests, update owners\n  const newModeOwners =\n    approvedRequest.desiredMode !== DEFAULT_MODE\n      ? mapSet(\n          state.modeOwners,\n          approvedRequest.desiredMode,\n          approvedRequest.requestOwner,\n        )\n      : state.modeOwners;\n\n  // Immutable update: clear pending requests, update owners, change mode\n  set({\n    mode: approvedRequest.desiredMode,\n    pendingRequests: mapClear<string, PendingRequest>(),\n    modeOwners: newModeOwners,\n  });\n\n  // Emit mode changed event\n  mapModeBus.emit(MapModeEvents.changed, {\n    previousMode: state.mode,\n    currentMode: approvedRequest.desiredMode,\n    id: instanceId,\n  });\n\n  // Emit approval decision if requested\n  if (emitApproval) {\n    mapModeBus.emit(MapModeEvents.changeDecision, {\n      authId: approvedRequest.authId,\n      approved: true,\n      owner: decisionOwner,\n      reason,\n      id: instanceId,\n    });\n  }\n\n  // Emit rejection events for all other pending requests\n  for (const request of requestsToReject) {\n    mapModeBus.emit(MapModeEvents.changeDecision, {\n      authId: request.authId,\n      approved: false,\n      owner: decisionOwner,\n      reason: 'Request auto-rejected because another request was approved',\n      id: instanceId,\n    });\n  }\n}\n\n/**\n * Handle pending requests when returning to default mode (immutable update)\n */\nfunction handlePendingRequestsOnDefaultMode(\n  instanceId: UniqueId,\n  state: MapModeState,\n  previousMode: string,\n  set: StoreHelpers<MapModeState>['set'],\n): void {\n  const firstEntry = Array.from(state.pendingRequests.values())[0];\n  if (!firstEntry) {\n    return;\n  }\n\n  const previousModeOwner = state.modeOwners.get(previousMode);\n\n  if (!previousModeOwner) {\n    return;\n  }\n\n  // If the first pending request is for default mode, reject all requests\n  if (firstEntry.desiredMode === DEFAULT_MODE) {\n    const allRequests = Array.from(state.pendingRequests.values());\n\n    // Immutable update: clear pending requests\n    set({ pendingRequests: mapClear<string, PendingRequest>() });\n\n    for (const request of allRequests) {\n      mapModeBus.emit(MapModeEvents.changeDecision, {\n        authId: request.authId,\n        approved: false,\n        owner: previousModeOwner,\n        reason: 'Request rejected - already in requested mode',\n        id: instanceId,\n      } satisfies ModeChangeDecisionPayload);\n    }\n  } else {\n    // Auto-accept the first pending request for a different mode\n    approveRequestAndRejectOthers(\n      instanceId,\n      state,\n      firstEntry,\n      firstEntry.authId,\n      previousModeOwner,\n      'Auto-accepted when mode owner returned to default',\n      true,\n      set,\n    );\n  }\n}\n\n/**\n * Handle authorization decision (immutable update)\n */\nfunction handleAuthorizationDecision(\n  instanceId: UniqueId,\n  state: MapModeState,\n  payload: {\n    approved: boolean;\n    authId: string;\n    owner: string;\n  },\n  set: StoreHelpers<MapModeState>['set'],\n): void {\n  const { approved, authId, owner: decisionOwner } = payload;\n\n  // Verify decision is from current mode's owner\n  const currentModeOwner = state.modeOwners.get(state.mode);\n  if (decisionOwner !== currentModeOwner) {\n    logger.warn(\n      `Authorization decision from \"${decisionOwner}\" ignored - not the owner of mode \"${state.mode}\" (owner: ${currentModeOwner || 'none'})`,\n    );\n    return;\n  }\n\n  // Find the request with matching authId\n  let matchingRequestOwner: string | null = null;\n  let matchingRequest: PendingRequest | null = null;\n\n  for (const [requestOwner, request] of state.pendingRequests.entries()) {\n    if (request.authId === authId) {\n      matchingRequestOwner = requestOwner;\n      matchingRequest = request;\n      break;\n    }\n  }\n\n  if (!(matchingRequest && matchingRequestOwner)) {\n    return;\n  }\n\n  if (approved) {\n    approveRequestAndRejectOthers(\n      instanceId,\n      state,\n      matchingRequest,\n      authId,\n      decisionOwner,\n      '',\n      false,\n      set,\n    );\n  } else {\n    // Immutable update: remove the rejected request\n    set({\n      pendingRequests: mapDelete(state.pendingRequests, matchingRequestOwner),\n    });\n  }\n}\n\n/**\n * Handle mode change request logic (immutable update)\n */\nfunction handleModeChangeRequest(\n  instanceId: UniqueId,\n  state: MapModeState,\n  desiredMode: string,\n  requestOwner: string,\n  set: StoreHelpers<MapModeState>['set'],\n): void {\n  const desiredModeOwner = state.modeOwners.get(desiredMode);\n\n  // Check if this request should be auto-accepted\n  if (shouldAutoAcceptRequest(state, desiredMode, requestOwner)) {\n    // Build immutable updates\n    const newModeOwners =\n      desiredMode !== DEFAULT_MODE && !desiredModeOwner\n        ? mapSet(state.modeOwners, desiredMode, requestOwner)\n        : state.modeOwners;\n\n    // Clear requester's pending request since mode changed successfully\n    const newPendingRequests = mapDelete(state.pendingRequests, requestOwner);\n\n    const previousMode = state.mode;\n\n    // Immutable update\n    set({\n      mode: desiredMode,\n      modeOwners: newModeOwners,\n      pendingRequests: newPendingRequests,\n    });\n\n    mapModeBus.emit(MapModeEvents.changed, {\n      previousMode,\n      currentMode: desiredMode,\n      id: instanceId,\n    });\n\n    return;\n  }\n\n  // Otherwise, send authorization request\n  const authId = uuid();\n\n  // Immutable update: add pending request\n  set({\n    pendingRequests: mapSet(state.pendingRequests, requestOwner, {\n      authId,\n      desiredMode,\n      currentMode: state.mode,\n      requestOwner,\n    }),\n  });\n\n  mapModeBus.emit(MapModeEvents.changeAuthorization, {\n    authId,\n    desiredMode,\n    currentMode: state.mode,\n    id: instanceId,\n  });\n}\n\n/**\n * Map mode store\n */\nexport const modeStore = createMapStore<MapModeState, MapModeActions>({\n  defaultState: {\n    mode: DEFAULT_MODE,\n    modeOwners: new Map(),\n    pendingRequests: new Map(),\n  },\n\n  actions: (instanceId) => ({\n    requestModeChange: (desiredMode: string, requestOwner: string) => {\n      const trimmedDesiredMode = desiredMode.trim();\n      const trimmedRequestOwner = requestOwner.trim();\n\n      if (!trimmedDesiredMode) {\n        throw new Error('requestModeChange requires non-empty desiredMode');\n      }\n      if (!trimmedRequestOwner) {\n        throw new Error('requestModeChange requires non-empty requestOwner');\n      }\n\n      mapModeBus.emit(MapModeEvents.changeRequest, {\n        desiredMode: trimmedDesiredMode,\n        owner: trimmedRequestOwner,\n        id: instanceId,\n      });\n    },\n  }),\n\n  bus: (instanceId, { get, set }) => {\n    // Listen for mode change requests\n    const unsubRequest = mapModeBus.on(MapModeEvents.changeRequest, (event) => {\n      const { desiredMode, owner: requestOwner, id } = event.payload;\n\n      const state = get();\n      // Filter: only handle if targeted at this map\n      if (id !== instanceId || desiredMode === state.mode) {\n        return;\n      }\n\n      handleModeChangeRequest(\n        instanceId,\n        state,\n        desiredMode,\n        requestOwner,\n        set,\n      );\n    });\n\n    // Listen for authorization decisions\n    const unsubDecision = mapModeBus.on(\n      MapModeEvents.changeDecision,\n      (event) => {\n        const { id, approved, authId, owner } = event.payload;\n\n        // Filter: only handle if targeted at this map\n        if (id !== instanceId) {\n          return;\n        }\n\n        handleAuthorizationDecision(\n          instanceId,\n          get(),\n          { approved, authId, owner },\n          set,\n        );\n      },\n    );\n\n    // Listen for mode changes to handle pending requests\n    const unsubChanged = mapModeBus.on(MapModeEvents.changed, (event) => {\n      const { currentMode, previousMode, id } = event.payload;\n\n      // Filter: only handle if targeted at this map\n      if (id !== instanceId) {\n        return;\n      }\n\n      const state = get();\n      // When mode owner changes to default mode, handle pending requests\n      if (currentMode === DEFAULT_MODE && state.pendingRequests.size > 0) {\n        handlePendingRequestsOnDefaultMode(\n          instanceId,\n          state,\n          previousMode,\n          set,\n        );\n      }\n    });\n\n    return () => {\n      unsubRequest();\n      unsubDecision();\n      unsubChanged();\n    };\n  },\n});\n\n// =============================================================================\n// Convenience exports\n// =============================================================================\n\n/**\n * Get the current mode for a map instance.\n *\n * @param mapId - Unique identifier for the map instance\n * @returns The current active mode string\n *\n * @example\n * ```typescript\n * import { getMode } from '@accelint/map-toolkit/map-mode';\n *\n * const currentMode = getMode(mapId);\n * console.log('Current mode:', currentMode); // 'default', 'drawing', etc.\n * ```\n */\nexport function getMode(mapId: UniqueId): string {\n  return modeStore.get(mapId).mode;\n}\n\n/**\n * Hook for current mode value.\n *\n * **Internal use only** - not exported from the public API.\n * Use `useMapMode` instead for better ergonomics and MapContext integration.\n *\n * @param mapId - Unique identifier for the map instance\n * @returns The current active mode string\n */\nexport function useMode(mapId: UniqueId): string {\n  return modeStore.useSelector(mapId, (state) => state.mode);\n}\n\n/**\n * Get the owner of the current mode for a given map instance.\n *\n * @internal - For internal map-toolkit use only\n * @param instanceId - Unique identifier for the map instance\n * @returns The owner ID of the current mode, or undefined if unowned\n */\nexport function getCurrentModeOwner(instanceId: UniqueId): string | undefined {\n  const state = modeStore.get(instanceId);\n  return state.modeOwners.get(state.mode);\n}\n\n/**\n * Check if a given owner is registered as the owner of any mode.\n * This includes both active mode owners and pending mode requests.\n *\n * @internal - For internal map-toolkit use only\n * @param instanceId - Unique identifier for the map instance\n * @param owner - The owner ID to check\n * @returns True if the owner is registered for any mode\n */\nexport function isRegisteredModeOwner(\n  instanceId: UniqueId,\n  owner: string,\n): boolean {\n  const state = modeStore.get(instanceId);\n\n  // Check active mode owners\n  for (const modeOwner of state.modeOwners.values()) {\n    if (modeOwner === owner) {\n      return true;\n    }\n  }\n\n  // Check pending mode requests (owner is the key in pendingRequests map)\n  if (state.pendingRequests.has(owner)) {\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * Manually clear map mode state for a specific map instance.\n *\n * Removes all mode ownership data, pending requests, and resets to default state.\n * This is typically not needed as cleanup happens automatically.\n * Use only in advanced scenarios where manual cleanup is required.\n *\n * @param instanceId - Unique identifier for the map instance to clear\n * @returns void\n *\n * @example\n * ```typescript\n * import { clearMapModeState } from '@accelint/map-toolkit/map-mode';\n *\n * // Manual cleanup when destroying a map\n * clearMapModeState(mapId);\n * ```\n */\nexport function clearMapModeState(instanceId: UniqueId): void {\n  modeStore.clear(instanceId);\n}\n"],"mappings":"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"}
+{"version":3,"file":"store.js","names":["requestsToReject: PendingRequest[]","matchingRequestOwner: string | null","matchingRequest: PendingRequest | null"],"sources":["../../src/map-mode/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\n/**\n * Map Mode Store\n *\n * Manages mode state with ownership-based authorization.\n *\n * @example\n * ```tsx\n * import { modeStore } from '@accelint/map-toolkit/map-mode';\n *\n * function MapControls({ mapId }) {\n *   const { state, requestModeChange } = modeStore.use(mapId);\n *\n *   return (\n *     <div>\n *       <p>Current mode: {state.mode}</p>\n *       <button onClick={() => requestModeChange('draw', 'draw-layer')}>\n *         Draw Mode\n *       </button>\n *     </div>\n *   );\n * }\n * ```\n */\n\nimport { Broadcast } from '@accelint/bus';\nimport { uuid } from '@accelint/core';\nimport { createLoggerDomain } from '@/shared/logger';\nimport {\n  createMapStore,\n  mapClear,\n  mapDelete,\n  mapSet,\n} from '../shared/create-map-store';\nimport { MapModeEvents } from './events';\nimport type { UniqueId } from '@accelint/core';\nimport type { StoreHelpers } from '../shared/create-map-store';\nimport type { MapModeEventType, ModeChangeDecisionPayload } from './types';\n\nconst logger = createLoggerDomain('[MapMode]');\n\nconst DEFAULT_MODE = 'default';\n\n/**\n * Typed event bus instance for map mode events.\n */\nconst mapModeBus = Broadcast.getInstance<MapModeEventType>();\n\n/**\n * Internal type for tracking pending authorization requests.\n */\ntype PendingRequest = {\n  authId: string;\n  desiredMode: string;\n  currentMode: string;\n  requestOwner: string;\n};\n\n/**\n * State shape for map mode\n */\ntype MapModeState = {\n  mode: string;\n  modeOwners: Map<string, string>;\n  pendingRequests: Map<string, PendingRequest>;\n};\n\n/**\n * Actions for map mode\n */\ntype MapModeActions = {\n  /** Request a mode change */\n  requestModeChange: (desiredMode: string, requestOwner: string) => void;\n};\n\n/**\n * Determine if a mode change request should be auto-accepted without authorization.\n *\n * Auto-accept conditions:\n * - Owner returning to default mode\n * - Owner switching between their own modes\n * - No ownership conflicts exist\n * - Entering an owned mode from default mode\n *\n * @param state - Current mode state\n * @param desiredMode - The mode being requested\n * @param requestOwner - The component requesting the mode change\n * @returns True if the request should be auto-accepted\n */\nfunction shouldAutoAcceptRequest(\n  state: MapModeState,\n  desiredMode: string,\n  requestOwner: string,\n): boolean {\n  const currentModeOwner = state.modeOwners.get(state.mode);\n  const desiredModeOwner = state.modeOwners.get(desiredMode);\n\n  // Owner returning to default mode\n  if (desiredMode === DEFAULT_MODE && requestOwner === currentModeOwner) {\n    return true;\n  }\n\n  // Owner switching between their own modes\n  if (requestOwner === currentModeOwner) {\n    return true;\n  }\n\n  // No ownership conflicts exist\n  if (!(currentModeOwner || desiredModeOwner)) {\n    return true;\n  }\n\n  // Entering an owned mode from default mode\n  if (state.mode === DEFAULT_MODE && requestOwner === desiredModeOwner) {\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * Approve a request and reject all others (immutable update)\n */\nfunction approveRequestAndRejectOthers(\n  instanceId: UniqueId,\n  state: MapModeState,\n  approvedRequest: PendingRequest,\n  excludeAuthId: string,\n  decisionOwner: string,\n  reason: string,\n  emitApproval: boolean,\n  set: StoreHelpers<MapModeState>['set'],\n): void {\n  // Collect all other pending requests to emit rejections for\n  const requestsToReject: PendingRequest[] = [];\n  for (const request of state.pendingRequests.values()) {\n    if (request.authId !== excludeAuthId) {\n      requestsToReject.push(request);\n    }\n  }\n\n  // Build immutable updates: clear pending requests, update owners\n  const newModeOwners =\n    approvedRequest.desiredMode !== DEFAULT_MODE\n      ? mapSet(\n          state.modeOwners,\n          approvedRequest.desiredMode,\n          approvedRequest.requestOwner,\n        )\n      : state.modeOwners;\n\n  // Immutable update: clear pending requests, update owners, change mode\n  set({\n    mode: approvedRequest.desiredMode,\n    pendingRequests: mapClear<string, PendingRequest>(),\n    modeOwners: newModeOwners,\n  });\n\n  // Emit mode changed event\n  mapModeBus.emit(MapModeEvents.changed, {\n    previousMode: state.mode,\n    currentMode: approvedRequest.desiredMode,\n    id: instanceId,\n  });\n\n  // Emit approval decision if requested\n  if (emitApproval) {\n    mapModeBus.emit(MapModeEvents.changeDecision, {\n      authId: approvedRequest.authId,\n      approved: true,\n      owner: decisionOwner,\n      reason,\n      id: instanceId,\n    });\n  }\n\n  // Emit rejection events for all other pending requests\n  for (const request of requestsToReject) {\n    mapModeBus.emit(MapModeEvents.changeDecision, {\n      authId: request.authId,\n      approved: false,\n      owner: decisionOwner,\n      reason: 'Request auto-rejected because another request was approved',\n      id: instanceId,\n    });\n  }\n}\n\n/**\n * Handle pending requests when returning to default mode (immutable update)\n */\nfunction handlePendingRequestsOnDefaultMode(\n  instanceId: UniqueId,\n  state: MapModeState,\n  previousMode: string,\n  set: StoreHelpers<MapModeState>['set'],\n): void {\n  const firstEntry = Array.from(state.pendingRequests.values())[0];\n  if (!firstEntry) {\n    return;\n  }\n\n  const previousModeOwner = state.modeOwners.get(previousMode);\n\n  if (!previousModeOwner) {\n    return;\n  }\n\n  // If the first pending request is for default mode, reject all requests\n  if (firstEntry.desiredMode === DEFAULT_MODE) {\n    const allRequests = Array.from(state.pendingRequests.values());\n\n    // Immutable update: clear pending requests\n    set({ pendingRequests: mapClear<string, PendingRequest>() });\n\n    for (const request of allRequests) {\n      mapModeBus.emit(MapModeEvents.changeDecision, {\n        authId: request.authId,\n        approved: false,\n        owner: previousModeOwner,\n        reason: 'Request rejected - already in requested mode',\n        id: instanceId,\n      } satisfies ModeChangeDecisionPayload);\n    }\n  } else {\n    // Auto-accept the first pending request for a different mode\n    approveRequestAndRejectOthers(\n      instanceId,\n      state,\n      firstEntry,\n      firstEntry.authId,\n      previousModeOwner,\n      'Auto-accepted when mode owner returned to default',\n      true,\n      set,\n    );\n  }\n}\n\n/**\n * Handle authorization decision (immutable update)\n */\nfunction handleAuthorizationDecision(\n  instanceId: UniqueId,\n  state: MapModeState,\n  payload: {\n    approved: boolean;\n    authId: string;\n    owner: string;\n  },\n  set: StoreHelpers<MapModeState>['set'],\n): void {\n  const { approved, authId, owner: decisionOwner } = payload;\n\n  // Verify decision is from current mode's owner\n  const currentModeOwner = state.modeOwners.get(state.mode);\n  if (decisionOwner !== currentModeOwner) {\n    logger.warn(\n      `Authorization decision from \"${decisionOwner}\" ignored - not the owner of mode \"${state.mode}\" (owner: ${currentModeOwner || 'none'})`,\n    );\n    return;\n  }\n\n  // Find the request with matching authId\n  let matchingRequestOwner: string | null = null;\n  let matchingRequest: PendingRequest | null = null;\n\n  for (const [requestOwner, request] of state.pendingRequests.entries()) {\n    if (request.authId === authId) {\n      matchingRequestOwner = requestOwner;\n      matchingRequest = request;\n      break;\n    }\n  }\n\n  if (!(matchingRequest && matchingRequestOwner)) {\n    return;\n  }\n\n  if (approved) {\n    approveRequestAndRejectOthers(\n      instanceId,\n      state,\n      matchingRequest,\n      authId,\n      decisionOwner,\n      '',\n      false,\n      set,\n    );\n  } else {\n    // Immutable update: remove the rejected request\n    set({\n      pendingRequests: mapDelete(state.pendingRequests, matchingRequestOwner),\n    });\n  }\n}\n\n/**\n * Handle mode change request logic (immutable update)\n */\nfunction handleModeChangeRequest(\n  instanceId: UniqueId,\n  state: MapModeState,\n  desiredMode: string,\n  requestOwner: string,\n  set: StoreHelpers<MapModeState>['set'],\n): void {\n  const desiredModeOwner = state.modeOwners.get(desiredMode);\n\n  // Check if this request should be auto-accepted\n  if (shouldAutoAcceptRequest(state, desiredMode, requestOwner)) {\n    // Build immutable updates\n    const newModeOwners =\n      desiredMode !== DEFAULT_MODE && !desiredModeOwner\n        ? mapSet(state.modeOwners, desiredMode, requestOwner)\n        : state.modeOwners;\n\n    // Clear requester's pending request since mode changed successfully\n    const newPendingRequests = mapDelete(state.pendingRequests, requestOwner);\n\n    const previousMode = state.mode;\n\n    // Immutable update\n    set({\n      mode: desiredMode,\n      modeOwners: newModeOwners,\n      pendingRequests: newPendingRequests,\n    });\n\n    mapModeBus.emit(MapModeEvents.changed, {\n      previousMode,\n      currentMode: desiredMode,\n      id: instanceId,\n    });\n\n    return;\n  }\n\n  // Otherwise, send authorization request\n  const authId = uuid();\n\n  // Immutable update: add pending request\n  set({\n    pendingRequests: mapSet(state.pendingRequests, requestOwner, {\n      authId,\n      desiredMode,\n      currentMode: state.mode,\n      requestOwner,\n    }),\n  });\n\n  mapModeBus.emit(MapModeEvents.changeAuthorization, {\n    authId,\n    desiredMode,\n    currentMode: state.mode,\n    id: instanceId,\n  });\n}\n\n/**\n * Map mode store\n */\nexport const modeStore = createMapStore<MapModeState, MapModeActions>({\n  defaultState: {\n    mode: DEFAULT_MODE,\n    modeOwners: new Map(),\n    pendingRequests: new Map(),\n  },\n\n  actions: (instanceId) => ({\n    requestModeChange: (desiredMode: string, requestOwner: string) => {\n      const trimmedDesiredMode = desiredMode.trim();\n      const trimmedRequestOwner = requestOwner.trim();\n\n      if (!trimmedDesiredMode) {\n        throw new Error('requestModeChange requires non-empty desiredMode');\n      }\n      if (!trimmedRequestOwner) {\n        throw new Error('requestModeChange requires non-empty requestOwner');\n      }\n\n      mapModeBus.emit(MapModeEvents.changeRequest, {\n        desiredMode: trimmedDesiredMode,\n        owner: trimmedRequestOwner,\n        id: instanceId,\n      });\n    },\n  }),\n\n  bus: (instanceId, { get, set }) => {\n    // Listen for mode change requests\n    const unsubRequest = mapModeBus.on(MapModeEvents.changeRequest, (event) => {\n      const { desiredMode, owner: requestOwner, id } = event.payload;\n\n      const state = get();\n      // Filter: only handle if targeted at this map\n      if (id !== instanceId || desiredMode === state.mode) {\n        return;\n      }\n\n      handleModeChangeRequest(\n        instanceId,\n        state,\n        desiredMode,\n        requestOwner,\n        set,\n      );\n    });\n\n    // Listen for authorization decisions\n    const unsubDecision = mapModeBus.on(\n      MapModeEvents.changeDecision,\n      (event) => {\n        const { id, approved, authId, owner } = event.payload;\n\n        // Filter: only handle if targeted at this map\n        if (id !== instanceId) {\n          return;\n        }\n\n        handleAuthorizationDecision(\n          instanceId,\n          get(),\n          { approved, authId, owner },\n          set,\n        );\n      },\n    );\n\n    // Listen for mode changes to handle pending requests\n    const unsubChanged = mapModeBus.on(MapModeEvents.changed, (event) => {\n      const { currentMode, previousMode, id } = event.payload;\n\n      // Filter: only handle if targeted at this map\n      if (id !== instanceId) {\n        return;\n      }\n\n      const state = get();\n      // When mode owner changes to default mode, handle pending requests\n      if (currentMode === DEFAULT_MODE && state.pendingRequests.size > 0) {\n        handlePendingRequestsOnDefaultMode(\n          instanceId,\n          state,\n          previousMode,\n          set,\n        );\n      }\n    });\n\n    return () => {\n      unsubRequest();\n      unsubDecision();\n      unsubChanged();\n    };\n  },\n});\n\n// =============================================================================\n// Convenience exports\n// =============================================================================\n\n/**\n * Get the current mode for a map instance.\n *\n * @param mapId - Unique identifier for the map instance\n * @returns The current active mode string\n *\n * @example\n * ```typescript\n * import { getMode } from '@accelint/map-toolkit/map-mode';\n *\n * const currentMode = getMode(mapId);\n * console.log('Current mode:', currentMode); // 'default', 'drawing', etc.\n * ```\n */\nexport function getMode(mapId: UniqueId): string {\n  return modeStore.get(mapId).mode;\n}\n\n/**\n * Hook for current mode value.\n *\n * **Internal use only** - not exported from the public API.\n * Use `useMapMode` instead for better ergonomics and MapContext integration.\n *\n * @param mapId - Unique identifier for the map instance\n * @returns The current active mode string\n */\nexport function useMode(mapId: UniqueId): string {\n  return modeStore.useSelector(mapId, (state) => state.mode);\n}\n\n/**\n * Get the owner of the current mode for a given map instance.\n *\n * @internal - For internal map-toolkit use only\n * @param instanceId - Unique identifier for the map instance\n * @returns The owner ID of the current mode, or undefined if unowned\n */\nexport function getCurrentModeOwner(instanceId: UniqueId): string | undefined {\n  const state = modeStore.get(instanceId);\n  return state.modeOwners.get(state.mode);\n}\n\n/**\n * Check if a given owner is registered as the owner of any mode.\n * This includes both active mode owners and pending mode requests.\n *\n * @internal - For internal map-toolkit use only\n * @param instanceId - Unique identifier for the map instance\n * @param owner - The owner ID to check\n * @returns True if the owner is registered for any mode\n */\nexport function isRegisteredModeOwner(\n  instanceId: UniqueId,\n  owner: string,\n): boolean {\n  const state = modeStore.get(instanceId);\n\n  // Check active mode owners\n  for (const modeOwner of state.modeOwners.values()) {\n    if (modeOwner === owner) {\n      return true;\n    }\n  }\n\n  // Check pending mode requests (owner is the key in pendingRequests map)\n  if (state.pendingRequests.has(owner)) {\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * Manually clear map mode state for a specific map instance.\n *\n * Removes all mode ownership data, pending requests, and resets to default state.\n * This is typically not needed as cleanup happens automatically.\n * Use only in advanced scenarios where manual cleanup is required.\n *\n * @param instanceId - Unique identifier for the map instance to clear\n * @returns void\n *\n * @example\n * ```typescript\n * import { clearMapModeState } from '@accelint/map-toolkit/map-mode';\n *\n * // Manual cleanup when destroying a map\n * clearMapModeState(mapId);\n * ```\n */\nexport function clearMapModeState(instanceId: UniqueId): void {\n  modeStore.clear(instanceId);\n}\n"],"mappings":"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"}

package/dist/map-mode/types.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/map-mode/types.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/map-mode/use-map-mode.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/map-mode/use-map-mode.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/maplibre/hooks/use-maplibre.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/maplibre/hooks/use-maplibre.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/maplibre/index.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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

package/dist/maplibre/index.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 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