@accelint/map-toolkit 0.1.0 → 0.2.0

package/dist/deckgl/base-map/types.d.ts

@@ -1,21 +1,61 @@
 import { Payload } from '@accelint/bus';
+import { UniqueId } from '@accelint/core';
 import { PickingInfo } from '@deck.gl/core';
 import { MjolnirGestureEvent, MjolnirPointerEvent } from 'mjolnir.js';
 import { MapEvents } from './events.js';
 
+/**
+ * PickingInfo without the viewport property, as it cannot be serialized through the event bus.
+ * The viewport contains function properties that would break serialization.
+ */
 type NonFuncPickingInfo = Omit<PickingInfo, 'viewport'>;
+/**
+ * MjolnirGestureEvent without function properties and non-serializable objects.
+ * These properties are omitted to allow the event to be serialized through the event bus.
+ */
 type NonFuncMjolnirGestureEvent = Omit<MjolnirGestureEvent, 'stopPropagation' | 'preventDefault' | 'stopImmediatePropagation' | 'srcEvent' | 'rootElement' | 'target' | 'changedPointers' | 'pointers'>;
+/**
+ * MjolnirPointerEvent without function properties and non-serializable objects.
+ * These properties are omitted to allow the event to be serialized through the event bus.
+ */
 type NonFuncMjolnirPointerEvent = Omit<MjolnirPointerEvent, 'stopPropagation' | 'preventDefault' | 'stopImmediatePropagation' | 'srcEvent' | 'rootElement' | 'target'>;
+/**
+ * Payload for map click events emitted through the event bus.
+ * Contains picking information about what was clicked and the gesture event details.
+ */
 type MapClickPayload = {
+    /** Information about the picked object and its properties */
     info: NonFuncPickingInfo;
+    /** The gesture event that triggered the click */
     event: NonFuncMjolnirGestureEvent;
+    /** The map instance the event occurred within */
+    id: UniqueId;
 };
+/**
+ * Payload for map hover events emitted through the event bus.
+ * Contains picking information about what is being hovered and the pointer event details.
+ */
 type MapHoverPayload = {
+    /** Information about the picked object and its properties */
     info: NonFuncPickingInfo;
+    /** The pointer event that triggered the hover */
     event: NonFuncMjolnirPointerEvent;
+    /** The map instance the event occurred within */
+    id: UniqueId;
 };
+/**
+ * Type for map click events in the event bus.
+ * Combines the event name with the click payload.
+ */
 type MapClickEvent = Payload<typeof MapEvents.click, MapClickPayload>;
+/**
+ * Type for map hover events in the event bus.
+ * Combines the event name with the hover payload.
+ */
 type MapHoverEvent = Payload<typeof MapEvents.hover, MapHoverPayload>;
+/**
+ * Union type of all map event types that can be emitted through the event bus.
+ */
 type MapEventType = MapClickEvent | MapHoverEvent;
 
 export type { MapClickEvent, MapClickPayload, MapEventType, MapHoverEvent, MapHoverPayload };

package/dist/deckgl/index.d.ts

@@ -1,12 +1,13 @@
-export { BaseMap, bus } from './base-map/index.js';
+export { BaseMap, BaseMapProps } from './base-map/index.js';
 export { BASE_MAP_STYLE, PARAMETERS } from './base-map/constants.js';
 export { MapEvents, MapEventsNamespace } from './base-map/events.js';
 export { SymbolLayer, SymbolLayerProps } from './symbol-layer/index.js';
 export { MapClickEvent, MapClickPayload, MapEventType, MapHoverEvent, MapHoverPayload } from './base-map/types.js';
 import 'react/jsx-runtime';
-import '@accelint/bus';
+import '@accelint/core';
 import '@deckgl-fiber-renderer/types';
 import '@deck.gl/layers';
 import 'milsymbol';
 import '@deck.gl/core';
+import '@accelint/bus';
 import 'mjolnir.js';

package/dist/deckgl/index.js

@@ -1,4 +1,4 @@
-export { BaseMap, bus } from './base-map/index.js';
+export { BaseMap } from './base-map/index.js';
 export { BASE_MAP_STYLE, PARAMETERS } from './base-map/constants.js';
 export { MapEvents, MapEventsNamespace } from './base-map/events.js';
 export { SymbolLayer } from './symbol-layer/index.js';

package/dist/deckgl/text-layer/character-sets.d.ts

@@ -0,0 +1,20 @@
+type CharacterSetsKeys = keyof typeof CHARACTER_SETS;
+declare const CHARACTER_SETS: Readonly<{
+    readonly ALL_NUMBERS: "1234567890";
+    readonly ASCII_ALL: "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890 !\"#$%&'()*+,-./:;<=>?@[]^_`{|}~";
+    readonly ASCII_ALPHA_NUMERIC: "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890";
+    readonly ASCII_LETTERS: "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
+    readonly ASCII_LETTERS_LOWERCASE: "abcdefghijklmnopqrstuvwxyz";
+    readonly ASCII_LETTERS_UPPERCASE: "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+    readonly ASCII_SYMBOLS: " !\"#$%&'()*+,-./:;<=>?@[]^_`{|}~";
+    readonly AUTO: "auto";
+    readonly EXPANDED: "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890 !\"#$%&'()*+,-./:;<=>?@[]^_`{|}~àáâãäåæçèéêëìíîïðñòóôõöøùúûüýþÿßÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞ1234567890 ¡¿¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿×÷";
+    readonly LATIN_ALL: "àáâãäåæçèéêëìíîïðñòóôõöøùúûüýþÿßÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞ1234567890 ¡¿¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿×÷";
+    readonly LATIN_ALPHA_NUMERIC: "àáâãäåæçèéêëìíîïðñòóôõöøùúûüýþÿßÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞ1234567890";
+    readonly LATIN_LETTERS: "àáâãäåæçèéêëìíîïðñòóôõöøùúûüýþÿßÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞ";
+    readonly LATIN_LETTERS_LOWERCASE: "àáâãäåæçèéêëìíîïðñòóôõöøùúûüýþÿß";
+    readonly LATIN_LETTERS_UPPERCASE: "ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞ";
+    readonly LATIN_SYMBOLS: " ¡¿¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿×÷";
+}>;
+
+export { CHARACTER_SETS, type CharacterSetsKeys };

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

@@ -0,0 +1,36 @@
+const ALL_NUMBERS = "1234567890";
+const ASCII_LETTERS_LOWERCASE = "abcdefghijklmnopqrstuvwxyz";
+const ASCII_LETTERS_UPPERCASE = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+const ASCII_SYMBOLS = " !\"#$%&'()*+,-./:;<=>?@[]^_`{|}~";
+const ASCII_LETTERS = `${ASCII_LETTERS_LOWERCASE}${ASCII_LETTERS_UPPERCASE}`;
+const ASCII_ALPHA_NUMERIC = `${ASCII_LETTERS}${ALL_NUMBERS}`;
+const ASCII_ALL = `${ASCII_LETTERS}${ALL_NUMBERS}${ASCII_SYMBOLS}`;
+const AUTO = "auto";
+const LATIN_LETTERS_LOWERCASE = "\xE0\xE1\xE2\xE3\xE4\xE5\xE6\xE7\xE8\xE9\xEA\xEB\xEC\xED\xEE\xEF\xF0\xF1\xF2\xF3\xF4\xF5\xF6\xF8\xF9\xFA\xFB\xFC\xFD\xFE\xFF\xDF";
+const LATIN_LETTERS_UPPERCASE = "\xC0\xC1\xC2\xC3\xC4\xC5\xC6\xC7\xC8\xC9\xCA\xCB\xCC\xCD\xCE\xCF\xD0\xD1\xD2\xD3\xD4\xD5\xD6\xD8\xD9\xDA\xDB\xDC\xDD\xDE";
+const LATIN_SYMBOLS = " \xA1\xBF\xA2\xA3\xA4\xA5\xA6\xA7\xA8\xA9\xAA\xAB\xAC\xAD\xAE\xAF\xB0\xB1\xB2\xB3\xB4\xB5\xB6\xB7\xB8\xB9\xBA\xBB\xBC\xBD\xBE\xBF\xD7\xF7";
+const LATIN_LETTERS = `${LATIN_LETTERS_LOWERCASE}${LATIN_LETTERS_UPPERCASE}`;
+const LATIN_ALPHA_NUMERIC = `${LATIN_LETTERS}${ALL_NUMBERS}`;
+const LATIN_ALL = `${LATIN_LETTERS}${ALL_NUMBERS}${LATIN_SYMBOLS}`;
+const EXPANDED = `${ASCII_ALL}${LATIN_ALL}`;
+const CHARACTER_SETS = Object.freeze({
+  ALL_NUMBERS,
+  ASCII_ALL,
+  ASCII_ALPHA_NUMERIC,
+  ASCII_LETTERS,
+  ASCII_LETTERS_LOWERCASE,
+  ASCII_LETTERS_UPPERCASE,
+  ASCII_SYMBOLS,
+  AUTO,
+  EXPANDED,
+  LATIN_ALL,
+  LATIN_ALPHA_NUMERIC,
+  LATIN_LETTERS,
+  LATIN_LETTERS_LOWERCASE,
+  LATIN_LETTERS_UPPERCASE,
+  LATIN_SYMBOLS
+});
+
+export { CHARACTER_SETS };
+//# sourceMappingURL=character-sets.js.map
+//# sourceMappingURL=character-sets.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/deckgl/text-layer/character-sets.ts"],"names":[],"mappings":"AAYA,MAAM,WAAA,GAAc,YAAA;AAEpB,MAAM,uBAAA,GAA0B,4BAAA;AAChC,MAAM,uBAAA,GAA0B,4BAAA;AAChC,MAAM,aAAA,GAAgB,mCAAA;AAEtB,MAAM,aAAA,GAAgB,CAAA,EAAG,uBAAuB,CAAA,EAAG,uBAAuB,CAAA,CAAA;AAC1E,MAAM,mBAAA,GAAsB,CAAA,EAAG,aAAa,CAAA,EAAG,WAAW,CAAA,CAAA;AAC1D,MAAM,YAAY,CAAA,EAAG,aAAa,CAAA,EAAG,WAAW,GAAG,aAAa,CAAA,CAAA;AAEhE,MAAM,IAAA,GAAO,MAAA;AAEb,MAAM,uBAAA,GAA0B,kIAAA;AAChC,MAAM,uBAAA,GAA0B,0HAAA;AAChC,MAAM,aAAA,GAAgB,2IAAA;AAEtB,MAAM,aAAA,GAAgB,CAAA,EAAG,uBAAuB,CAAA,EAAG,uBAAuB,CAAA,CAAA;AAC1E,MAAM,mBAAA,GAAsB,CAAA,EAAG,aAAa,CAAA,EAAG,WAAW,CAAA,CAAA;AAC1D,MAAM,YAAY,CAAA,EAAG,aAAa,CAAA,EAAG,WAAW,GAAG,aAAa,CAAA,CAAA;AAEhE,MAAM,QAAA,GAAW,CAAA,EAAG,SAAS,CAAA,EAAG,SAAS,CAAA,CAAA;AAIlC,MAAM,cAAA,GAAiB,OAAO,MAAA,CAAO;AAAA,EAC1C,WAAA;AAAA,EAEA,SAAA;AAAA,EACA,mBAAA;AAAA,EACA,aAAA;AAAA,EACA,uBAAA;AAAA,EACA,uBAAA;AAAA,EACA,aAAA;AAAA,EAEA,IAAA;AAAA,EACA,QAAA;AAAA,EAEA,SAAA;AAAA,EACA,mBAAA;AAAA,EACA,aAAA;AAAA,EACA,uBAAA;AAAA,EACA,uBAAA;AAAA,EACA;AACF,CAAU","file":"character-sets.js","sourcesContent":["/*\n * Copyright 2025 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\nconst ALL_NUMBERS = '1234567890';\n\nconst ASCII_LETTERS_LOWERCASE = 'abcdefghijklmnopqrstuvwxyz';\nconst ASCII_LETTERS_UPPERCASE = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';\nconst ASCII_SYMBOLS = ' !\"#$%&\\'()*+,-./:;<=>?@[]^_`{|}~';\n\nconst ASCII_LETTERS = `${ASCII_LETTERS_LOWERCASE}${ASCII_LETTERS_UPPERCASE}`;\nconst ASCII_ALPHA_NUMERIC = `${ASCII_LETTERS}${ALL_NUMBERS}`;\nconst ASCII_ALL = `${ASCII_LETTERS}${ALL_NUMBERS}${ASCII_SYMBOLS}`;\n\nconst AUTO = 'auto';\n\nconst LATIN_LETTERS_LOWERCASE = 'àáâãäåæçèéêëìíîïðñòóôõöøùúûüýþÿß';\nconst LATIN_LETTERS_UPPERCASE = 'ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞ';\nconst LATIN_SYMBOLS = ' ¡¿¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿×÷';\n\nconst LATIN_LETTERS = `${LATIN_LETTERS_LOWERCASE}${LATIN_LETTERS_UPPERCASE}`;\nconst LATIN_ALPHA_NUMERIC = `${LATIN_LETTERS}${ALL_NUMBERS}`;\nconst LATIN_ALL = `${LATIN_LETTERS}${ALL_NUMBERS}${LATIN_SYMBOLS}`;\n\nconst EXPANDED = `${ASCII_ALL}${LATIN_ALL}`;\n\nexport type CharacterSetsKeys = keyof typeof CHARACTER_SETS;\n\nexport const CHARACTER_SETS = Object.freeze({\n  ALL_NUMBERS,\n\n  ASCII_ALL,\n  ASCII_ALPHA_NUMERIC,\n  ASCII_LETTERS,\n  ASCII_LETTERS_LOWERCASE,\n  ASCII_LETTERS_UPPERCASE,\n  ASCII_SYMBOLS,\n\n  AUTO,\n  EXPANDED,\n\n  LATIN_ALL,\n  LATIN_ALPHA_NUMERIC,\n  LATIN_LETTERS,\n  LATIN_LETTERS_LOWERCASE,\n  LATIN_LETTERS_UPPERCASE,\n  LATIN_SYMBOLS,\n} as const);\n"]}

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

@@ -0,0 +1,5 @@
+import { TextLayerProps } from '@deck.gl/layers';
+
+declare const defaultSettings: Partial<TextLayerProps>;
+
+export { defaultSettings };

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

@@ -0,0 +1,23 @@
+const defaultSettings = {
+  fontFamily: "system-ui, sans-serif",
+  fontSettings: {
+    fontSize: 22,
+    sdf: true,
+    buffer: 10,
+    cutoff: 0.19,
+    radius: 10,
+    smoothing: 0.1
+  },
+  fontWeight: 500,
+  getAlignmentBaseline: "center",
+  getColor: [255, 255, 255, 255],
+  getSize: 12,
+  getTextAnchor: "middle",
+  lineHeight: 1,
+  outlineColor: [0, 0, 0, 255],
+  outlineWidth: 2
+};
+
+export { defaultSettings };
+//# sourceMappingURL=default-settings.js.map
+//# sourceMappingURL=default-settings.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/deckgl/text-layer/default-settings.ts"],"names":[],"mappings":"AAeO,MAAM,eAAA,GAA2C;AAAA,EACtD,UAAA,EAAY,uBAAA;AAAA,EACZ,YAAA,EAAc;AAAA,IACZ,QAAA,EAAU,EAAA;AAAA,IACV,GAAA,EAAK,IAAA;AAAA,IACL,MAAA,EAAQ,EAAA;AAAA,IACR,MAAA,EAAQ,IAAA;AAAA,IACR,MAAA,EAAQ,EAAA;AAAA,IACR,SAAA,EAAW;AAAA,GACb;AAAA,EACA,UAAA,EAAY,GAAA;AAAA,EACZ,oBAAA,EAAsB,QAAA;AAAA,EACtB,QAAA,EAAU,CAAC,GAAA,EAAK,GAAA,EAAK,KAAK,GAAG,CAAA;AAAA,EAC7B,OAAA,EAAS,EAAA;AAAA,EACT,aAAA,EAAe,QAAA;AAAA,EACf,UAAA,EAAY,CAAA;AAAA,EACZ,YAAA,EAAc,CAAC,CAAA,EAAG,CAAA,EAAG,GAAG,GAAG,CAAA;AAAA,EAC3B,YAAA,EAAc;AAChB","file":"default-settings.js","sourcesContent":["/*\n * Copyright 2025 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 type { Color } from '@deck.gl/core';\nimport type { TextLayerProps } from '@deck.gl/layers';\n\nexport const defaultSettings: Partial<TextLayerProps> = {\n  fontFamily: 'system-ui, sans-serif',\n  fontSettings: {\n    fontSize: 22,\n    sdf: true,\n    buffer: 10,\n    cutoff: 0.19,\n    radius: 10,\n    smoothing: 0.1,\n  },\n  fontWeight: 500,\n  getAlignmentBaseline: 'center',\n  getColor: [255, 255, 255, 255] as Color,\n  getSize: 12,\n  getTextAnchor: 'middle',\n  lineHeight: 1,\n  outlineColor: [0, 0, 0, 255] as Color,\n  outlineWidth: 2,\n} as const;\n"]}

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

@@ -0,0 +1,31 @@
+import { TextLayerProps } from './index.js';
+import '@deck.gl/layers';
+import './character-sets.js';
+import 'type-fest';
+
+declare global {
+    namespace React {
+        namespace JSX {
+            interface IntrinsicElements {
+                /**
+                 * A styled text layer for DeckGL Fiber with enhanced styling capabilities.
+                 *
+                 * Provides customizable font styling, text outline support, and extended character sets.
+                 *
+                 * @example
+                 * ```tsx
+                 * <textLayer
+                 *   id="my-text"
+                 *   data={textData}
+                 *   getText={d => d.text}
+                 *   getPosition={d => d.position}
+                 *   getSize={12}
+                 *   fontWeight={500}
+                 * />
+                 * ```
+                 */
+                textLayer: TextLayerProps;
+            }
+        }
+    }
+}

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

@@ -0,0 +1,6 @@
+import { extend } from '@deckgl-fiber-renderer/dom';
+import { TextLayer } from './index.js';
+
+extend({ TextLayer });
+//# sourceMappingURL=fiber.js.map
+//# sourceMappingURL=fiber.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/deckgl/text-layer/fiber.ts"],"names":[],"mappings":";;;AAeA,MAAA,CAAO,EAAE,WAAW,CAAA","file":"fiber.js","sourcesContent":["/*\n * Copyright 2025 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 { extend } from '@deckgl-fiber-renderer/dom';\nimport { TextLayer, type TextLayerProps } from './index';\n\nextend({ TextLayer });\n\ndeclare global {\n  namespace React {\n    // biome-ignore lint/style/useNamingConvention: Built-in React namespace.\n    namespace JSX {\n      interface IntrinsicElements {\n        /**\n         * A styled text layer for DeckGL Fiber with enhanced styling capabilities.\n         *\n         * Provides customizable font styling, text outline support, and extended character sets.\n         *\n         * @example\n         * ```tsx\n         * <textLayer\n         *   id=\"my-text\"\n         *   data={textData}\n         *   getText={d => d.text}\n         *   getPosition={d => d.position}\n         *   getSize={12}\n         *   fontWeight={500}\n         * />\n         * ```\n         */\n        textLayer: TextLayerProps;\n      }\n    }\n  }\n}\n"]}

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

@@ -0,0 +1,43 @@
+import { TextLayerProps as TextLayerProps$1, TextLayer as TextLayer$1 } from '@deck.gl/layers';
+import { CharacterSetsKeys } from './character-sets.js';
+import { LiteralUnion } from 'type-fest';
+
+interface TextLayerProps<TData = unknown> extends TextLayerProps$1<TData> {
+    characterSet?: LiteralUnion<CharacterSetsKeys, string>;
+}
+/**
+ * A styled text layer that extends Deck.gl's TextLayer with enhanced styling capabilities.
+ *
+ * This layer provides:
+ * - Customizable font styling (size, weight, family, line height)
+ * - Text outline support
+ * - Extended character set support
+ * - Consistent styling based on design specifications
+ *
+ * Can be used directly with Deck.gl or as a JSX element with React Fiber:
+ * - React Fiber: `<textLayer id="text" data={[...]} ... />`
+ * - Direct: `new TextLayer({ id: 'text', data: [...], ... })`
+ */
+declare class TextLayer<TData = unknown> extends TextLayer$1<TData> {
+    static CHARACTER_SETS: Readonly<{
+        readonly ALL_NUMBERS: "1234567890";
+        readonly ASCII_ALL: "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890 !\"#$%&'()*+,-./:;<=>?@[]^_`{|}~";
+        readonly ASCII_ALPHA_NUMERIC: "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890";
+        readonly ASCII_LETTERS: "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
+        readonly ASCII_LETTERS_LOWERCASE: "abcdefghijklmnopqrstuvwxyz";
+        readonly ASCII_LETTERS_UPPERCASE: "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+        readonly ASCII_SYMBOLS: " !\"#$%&'()*+,-./:;<=>?@[]^_`{|}~";
+        readonly AUTO: "auto";
+        readonly EXPANDED: "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890 !\"#$%&'()*+,-./:;<=>?@[]^_`{|}~àáâãäåæçèéêëìíîïðñòóôõöøùúûüýþÿßÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞ1234567890 ¡¿¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿×÷";
+        readonly LATIN_ALL: "àáâãäåæçèéêëìíîïðñòóôõöøùúûüýþÿßÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞ1234567890 ¡¿¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿×÷";
+        readonly LATIN_ALPHA_NUMERIC: "àáâãäåæçèéêëìíîïðñòóôõöøùúûüýþÿßÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞ1234567890";
+        readonly LATIN_LETTERS: "àáâãäåæçèéêëìíîïðñòóôõöøùúûüýþÿßÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞ";
+        readonly LATIN_LETTERS_LOWERCASE: "àáâãäåæçèéêëìíîïðñòóôõöøùúûüýþÿß";
+        readonly LATIN_LETTERS_UPPERCASE: "ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞ";
+        readonly LATIN_SYMBOLS: " ¡¿¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿×÷";
+    }>;
+    static layerName: string;
+    constructor(props: TextLayerProps<TData>);
+}
+
+export { TextLayer, type TextLayerProps };

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

@@ -0,0 +1,33 @@
+import { TextLayer as TextLayer$1 } from '@deck.gl/layers';
+import { CHARACTER_SETS } from './character-sets.js';
+import { defaultSettings } from './default-settings.js';
+
+class TextLayer extends TextLayer$1 {
+  static CHARACTER_SETS = CHARACTER_SETS;
+  static layerName = "textLayer";
+  constructor(props) {
+    const {
+      characterSet = CHARACTER_SETS.EXPANDED,
+      fontSettings,
+      ...rest
+    } = props;
+    super({
+      // set opinionated defaults
+      ...defaultSettings,
+      // user props override defaults
+      ...rest,
+      // handle special characterSet logic
+      characterSet: CHARACTER_SETS[characterSet] ?? characterSet,
+      fontSettings: {
+        // merge fontSettings
+        ...defaultSettings.fontSettings,
+        // user props override defaults
+        ...fontSettings
+      }
+    });
+  }
+}
+
+export { TextLayer };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/deckgl/text-layer/index.ts"],"names":["DglTextLayer"],"mappings":";;;;AAuCO,MAAM,kBAAmCA,WAAA,CAAoB;AAAA,EAClE,OAAO,cAAA,GAAiB,cAAA;AAAA,EAExB,OAAgB,SAAA,GAAY,WAAA;AAAA,EAE5B,YAAY,KAAA,EAA8B;AACxC,IAAA,MAAM;AAAA,MACJ,eAAe,cAAA,CAAe,QAAA;AAAA,MAC9B,YAAA;AAAA,MACA,GAAG;AAAA,KACL,GAAI,KAAA;AAEJ,IAAA,KAAA,CAAM;AAAA;AAAA,MAEJ,GAAG,eAAA;AAAA;AAAA,MAGH,GAAG,IAAA;AAAA;AAAA,MAGH,YAAA,EACE,cAAA,CAAe,YAAiC,CAAA,IAAK,YAAA;AAAA,MAEvD,YAAA,EAAc;AAAA;AAAA,QAEZ,GAAG,eAAA,CAAgB,YAAA;AAAA;AAAA,QAGnB,GAAG;AAAA;AACL,KACD,CAAA;AAAA,EACH;AACF","file":"index.js","sourcesContent":["/*\n * Copyright 2025 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  TextLayer as DglTextLayer,\n  type TextLayerProps as DglTextLayerProps,\n} from '@deck.gl/layers';\nimport { CHARACTER_SETS, type CharacterSetsKeys } from './character-sets.js';\nimport { defaultSettings } from './default-settings.js';\nimport type { LiteralUnion } from 'type-fest';\n\nexport interface TextLayerProps<TData = unknown>\n  extends DglTextLayerProps<TData> {\n  // A union type that preserves autocompletion for CharacterSetsKeys while allowing any string.\n  characterSet?: LiteralUnion<CharacterSetsKeys, string>;\n}\n\n/**\n * A styled text layer that extends Deck.gl's TextLayer with enhanced styling capabilities.\n *\n * This layer provides:\n * - Customizable font styling (size, weight, family, line height)\n * - Text outline support\n * - Extended character set support\n * - Consistent styling based on design specifications\n *\n * Can be used directly with Deck.gl or as a JSX element with React Fiber:\n * - React Fiber: `<textLayer id=\"text\" data={[...]} ... />`\n * - Direct: `new TextLayer({ id: 'text', data: [...], ... })`\n */\nexport class TextLayer<TData = unknown> extends DglTextLayer<TData> {\n  static CHARACTER_SETS = CHARACTER_SETS;\n\n  static override layerName = 'textLayer';\n\n  constructor(props: TextLayerProps<TData>) {\n    const {\n      characterSet = CHARACTER_SETS.EXPANDED,\n      fontSettings,\n      ...rest\n    } = props;\n\n    super({\n      // set opinionated defaults\n      ...defaultSettings,\n\n      // user props override defaults\n      ...rest,\n\n      // handle special characterSet logic\n      characterSet:\n        CHARACTER_SETS[characterSet as CharacterSetsKeys] ?? characterSet,\n\n      fontSettings: {\n        // merge fontSettings\n        ...defaultSettings.fontSettings,\n\n        // user props override defaults\n        ...fontSettings,\n      },\n    });\n  }\n}\n"]}

package/dist/decorators/deckgl.js

@@ -1,9 +1,11 @@
 import { jsx } from 'react/jsx-runtime';
+import { uuid } from '@accelint/core';
 import { BaseMap } from '../deckgl/base-map/index.js';
 
+const STORYBOOK_MAP_ID = uuid();
 const withDeckGL = () => {
   return (Story) => {
-    return /* @__PURE__ */ jsx(BaseMap, { className: "h-dvh w-dvw", children: /* @__PURE__ */ jsx(Story, {}) });
+    return /* @__PURE__ */ jsx(BaseMap, { className: "h-dvh w-dvw", id: STORYBOOK_MAP_ID, children: /* @__PURE__ */ jsx(Story, {}) });
   };
 };
 

package/dist/decorators/deckgl.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/decorators/deckgl.tsx"],"names":[],"mappings":";;;AAiBO,MAAM,aAAa,MAAiB;AACzC,EAAA,OAAO,CAAC,KAAA,KAAU;AAChB,IAAA,2BACG,OAAA,EAAA,EAAQ,SAAA,EAAU,aAAA,EACjB,QAAA,kBAAA,GAAA,CAAC,SAAM,CAAA,EACT,CAAA;AAAA,EAEJ,CAAA;AACF","file":"deckgl.js","sourcesContent":["// __private-exports\n\n/*\n * Copyright 2025 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 { BaseMap } from '../deckgl/base-map';\nimport type { Decorator } from '@storybook/react';\n\nexport const withDeckGL = (): Decorator => {\n  return (Story) => {\n    return (\n      <BaseMap className='h-dvh w-dvw'>\n        <Story />\n      </BaseMap>\n    );\n  };\n};\n"]}
+{"version":3,"sources":["../../src/decorators/deckgl.tsx"],"names":[],"mappings":";;;;AAmBA,MAAM,mBAAmB,IAAA,EAAK;AAEvB,MAAM,aAAa,MAAiB;AACzC,EAAA,OAAO,CAAC,KAAA,KAAU;AAChB,IAAA,uBACE,GAAA,CAAC,WAAQ,SAAA,EAAU,aAAA,EAAc,IAAI,gBAAA,EACnC,QAAA,kBAAA,GAAA,CAAC,SAAM,CAAA,EACT,CAAA;AAAA,EAEJ,CAAA;AACF","file":"deckgl.js","sourcesContent":["// __private-exports\n\n/*\n * Copyright 2025 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 { uuid } from '@accelint/core';\nimport { BaseMap } from '../deckgl/base-map';\nimport type { Decorator } from '@storybook/react';\n\n// Module-level constant - stable across all Storybook renders\nconst STORYBOOK_MAP_ID = uuid();\n\nexport const withDeckGL = (): Decorator => {\n  return (Story) => {\n    return (\n      <BaseMap className='h-dvh w-dvw' id={STORYBOOK_MAP_ID}>\n        <Story />\n      </BaseMap>\n    );\n  };\n};\n"]}

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

@@ -0,0 +1,37 @@
+/**
+ * Namespace prefix for all map mode events.
+ */
+declare const MapModeEventsNamespace = "map-mode";
+/**
+ * Event type constants for map mode state management.
+ *
+ * These events are emitted through the `@accelint/bus` event bus to coordinate
+ * map mode changes across components in a decoupled manner.
+ *
+ * @example
+ * ```ts
+ * import { useOn, useEmit } from '@accelint/bus/react';
+ * import { MapModeEvents } from '@accelint/map-toolkit/map-mode';
+ *
+ * // Listen for mode changes
+ * useOn(MapModeEvents.changed, (event) => {
+ *   console.log('Mode changed to:', event.payload.currentMode);
+ * });
+ *
+ * // Emit a decision
+ * const emitDecision = useEmit(MapModeEvents.changeDecision);
+ * emitDecision({ authId, approved: true, owner: 'my-id', id });
+ * ```
+ */
+declare const MapModeEvents: {
+    /** Emitted when the map mode has successfully changed */
+    readonly changed: "map-mode:changed";
+    /** Emitted when a component requests a mode change */
+    readonly changeRequest: "map-mode:change:request";
+    /** Emitted when authorization is required for a mode change */
+    readonly changeAuthorization: "map-mode:change:authorization";
+    /** Emitted when an authorization decision is made (approve/reject) */
+    readonly changeDecision: "map-mode:change:decision";
+};
+
+export { MapModeEvents, MapModeEventsNamespace };

package/dist/map-mode/events.js

@@ -0,0 +1,15 @@
+const MapModeEventsNamespace = "map-mode";
+const MapModeEvents = {
+  /** Emitted when the map mode has successfully changed */
+  changed: `${MapModeEventsNamespace}:changed`,
+  /** Emitted when a component requests a mode change */
+  changeRequest: `${MapModeEventsNamespace}:change:request`,
+  /** Emitted when authorization is required for a mode change */
+  changeAuthorization: `${MapModeEventsNamespace}:change:authorization`,
+  /** Emitted when an authorization decision is made (approve/reject) */
+  changeDecision: `${MapModeEventsNamespace}:change:decision`
+};
+
+export { MapModeEvents, MapModeEventsNamespace };
+//# sourceMappingURL=events.js.map
+//# sourceMappingURL=events.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/map-mode/events.ts"],"names":[],"mappings":"AAeO,MAAM,sBAAA,GAAyB;AAuB/B,MAAM,aAAA,GAAgB;AAAA;AAAA,EAE3B,OAAA,EAAS,GAAG,sBAAsB,CAAA,QAAA,CAAA;AAAA;AAAA,EAElC,aAAA,EAAe,GAAG,sBAAsB,CAAA,eAAA,CAAA;AAAA;AAAA,EAExC,mBAAA,EAAqB,GAAG,sBAAsB,CAAA,qBAAA,CAAA;AAAA;AAAA,EAE9C,cAAA,EAAgB,GAAG,sBAAsB,CAAA,gBAAA;AAC3C","file":"events.js","sourcesContent":["/*\n * Copyright 2025 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 * Namespace prefix for all map mode events.\n */\nexport const MapModeEventsNamespace = 'map-mode';\n\n/**\n * Event type constants for map mode state management.\n *\n * These events are emitted through the `@accelint/bus` event bus to coordinate\n * map mode changes across components in a decoupled manner.\n *\n * @example\n * ```ts\n * import { useOn, useEmit } from '@accelint/bus/react';\n * import { MapModeEvents } from '@accelint/map-toolkit/map-mode';\n *\n * // Listen for mode changes\n * useOn(MapModeEvents.changed, (event) => {\n *   console.log('Mode changed to:', event.payload.currentMode);\n * });\n *\n * // Emit a decision\n * const emitDecision = useEmit(MapModeEvents.changeDecision);\n * emitDecision({ authId, approved: true, owner: 'my-id', id });\n * ```\n */\nexport const MapModeEvents = {\n  /** Emitted when the map mode has successfully changed */\n  changed: `${MapModeEventsNamespace}:changed`,\n  /** Emitted when a component requests a mode change */\n  changeRequest: `${MapModeEventsNamespace}:change:request`,\n  /** Emitted when authorization is required for a mode change */\n  changeAuthorization: `${MapModeEventsNamespace}:change:authorization`,\n  /** Emitted when an authorization decision is made (approve/reject) */\n  changeDecision: `${MapModeEventsNamespace}:change:decision`,\n} as const;\n"]}

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

@@ -0,0 +1,6 @@
+export { MapModeEvents, MapModeEventsNamespace } from './events.js';
+export { MapModeStore, destroyStore, getOrCreateStore, getStore } from './store.js';
+export { UseMapModeReturn, useMapMode } from './use-map-mode.js';
+export { MapModeEventType, ModeChangeAuthorizationEvent, ModeChangeAuthorizationPayload, ModeChangeDecisionEvent, ModeChangeDecisionPayload, ModeChangeRequestEvent, ModeChangeRequestPayload, ModeChangedEvent, ModeChangedPayload } from './types.js';
+import '@accelint/core';
+import '@accelint/bus';

package/dist/map-mode/index.js

@@ -0,0 +1,5 @@
+export { MapModeEvents, MapModeEventsNamespace } from './events.js';
+export { MapModeStore, destroyStore, getOrCreateStore, getStore } from './store.js';
+export { useMapMode } from './use-map-mode.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js","sourcesContent":[]}

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

@@ -0,0 +1,122 @@
+import { UniqueId } from '@accelint/core';
+
+/**
+ * External store for managing map mode state.
+ *
+ * This store implements the observable pattern for use with React's `useSyncExternalStore` hook.
+ * It manages all mode state, ownership tracking, authorization flow, and event bus communication
+ * outside of React's component tree.
+ *
+ * Each store instance is identified by a unique `id` and operates independently,
+ * enabling scenarios with multiple isolated map instances (e.g., main map + minimap).
+ * Stores communicate via the event bus and filter events by `id` to ensure isolation.
+ *
+ * The store always initializes in 'default' mode and does not accept a custom default mode.
+ *
+ * @see {getOrCreateStore} - Creates or retrieves a store for a given map instance
+ * @see {destroyStore} - Destroys a store and cleans up its resources
+ */
+declare class MapModeStore {
+    private readonly id;
+    private mode;
+    private readonly defaultMode;
+    private readonly modeOwners;
+    private readonly pendingRequests;
+    private readonly listeners;
+    private readonly bus;
+    private readonly unsubscribers;
+    constructor(id: UniqueId);
+    /**
+     * Get current mode snapshot (for useSyncExternalStore)
+     */
+    getSnapshot: () => string;
+    /**
+     * Subscribe to mode changes (for useSyncExternalStore)
+     */
+    subscribe: (listener: () => void) => (() => void);
+    /**
+     * Request a mode change
+     *
+     * If the mode change can be auto-accepted (no ownership conflicts), the mode changes immediately.
+     * Otherwise, an authorization request is emitted and stored as a pending request.
+     *
+     * **Important**: If the requester already has a pending authorization request, it will be replaced
+     * with this new request. Only one pending request per requester is maintained at a time.
+     *
+     * @param desiredMode - The mode to switch to (automatically trimmed of whitespace)
+     * @param requestOwner - Unique identifier of the component requesting the change (automatically trimmed of whitespace)
+     * @throws Error if either parameter is empty or whitespace-only
+     *
+     * @example
+     * ```ts
+     * // First request from 'drawing-tool'
+     * store.requestModeChange('drawing', 'drawing-tool');
+     * // → Creates pending request with authId 'abc-123'
+     *
+     * // Second request from same 'drawing-tool' before first is resolved
+     * store.requestModeChange('measuring', 'drawing-tool');
+     * // → Replaces pending request, new authId 'def-456', old 'abc-123' is discarded
+     * ```
+     */
+    requestModeChange: (desiredMode: string, requestOwner: string) => void;
+    /**
+     * Notify all subscribers of state change
+     */
+    private notify;
+    /**
+     * Setup event listeners for bus events
+     *
+     * Note: Event listeners remain active even after early returns in handlers.
+     * This is by design - cleanup happens in destroy() which is called automatically
+     * by MapProvider on unmount. Consumers don't need to manually manage cleanup.
+     */
+    private setupEventListeners;
+    /**
+     * Determine if a mode change request should be auto-accepted without authorization
+     */
+    private shouldAutoAcceptRequest;
+    /**
+     * Handle mode change request logic
+     */
+    private handleModeChangeRequest;
+    /**
+     * Handle authorization decision
+     *
+     * Processes approval/rejection decisions from mode owners. Only the current mode's owner
+     * can make authorization decisions. If a decision comes from a non-owner, a warning is
+     * logged and the decision is ignored to prevent unauthorized mode changes.
+     *
+     * @param payload - The authorization decision containing authId, approved status, and owner
+     */
+    private handleAuthorizationDecision;
+    /**
+     * Approve a request and reject all others
+     */
+    private approveRequestAndRejectOthers;
+    /**
+     * Handle pending requests when returning to default mode
+     */
+    private handlePendingRequestsOnDefaultMode;
+    /**
+     * Set mode and notify listeners
+     */
+    private setMode;
+    /**
+     * Clean up store resources
+     */
+    destroy(): void;
+}
+/**
+ * Get or create a store for a given map instance
+ */
+declare function getOrCreateStore(id: UniqueId): MapModeStore;
+/**
+ * Destroy and remove a store from the registry
+ */
+declare function destroyStore(id: UniqueId): void;
+/**
+ * Get a store by map ID (for testing/advanced use)
+ */
+declare function getStore(id: UniqueId): MapModeStore | undefined;
+
+export { MapModeStore, destroyStore, getOrCreateStore, getStore };