@accelint/map-toolkit 1.1.0 → 1.3.0

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

@@ -15,6 +15,9 @@ import { IconLayer, IconLayerProps } from "@deck.gl/layers";
 import { SymbolOptions } from "milsymbol";
 
 //#region src/deckgl/symbol-layer/index.d.ts
+/**
+ * Internal props specific to SymbolLayer.
+ */
 type _SymbolLayerProps<TData = unknown> = {
   /**
    * An accessor function that returns the SIDC for a given data point.
@@ -29,9 +32,84 @@ type _SymbolLayerProps<TData = unknown> = {
    */
   defaultSymbolOptions?: SymbolOptions;
 };
+/**
+ * Props for SymbolLayer component.
+ * Extends IconLayer props with MIL-STD-2525 symbol rendering support.
+ */
 type SymbolLayerProps<TData = unknown> = _SymbolLayerProps<TData> & Omit<IconLayerProps<TData>, 'getIcon' | 'getColor' | 'iconAtlas' | 'iconMapping'>;
 /**
- * Provides a layer for rendering MIL-STD-2525 and APP-6 symbols.
+ * A Deck.gl layer for rendering MIL-STD-2525 and APP-6 military symbols.
+ *
+ * This layer extends IconLayer and automatically generates symbol icons from SIDC codes.
+ * It supports multiple symbology standards including MIL-STD-2525 B/C/D/E, STANAG APP6 B/D/E,
+ * and FM 1-02.2.
+ *
+ * Features:
+ * - Automatic symbol generation from SIDC codes
+ * - Caching for performance optimization
+ * - Customizable symbol options per data point
+ * - Dark/Light color modes
+ *
+ * Can be used directly with Deck.gl or as a JSX element with React Fiber:
+ * - React Fiber: `<symbolLayer id="symbols" data={[...]} ... />`
+ * - Direct: `new SymbolLayer({ id: 'symbols', data: [...], ... })`
+ *
+ * @example
+ * Direct Deck.gl usage:
+ * ```typescript
+ * import { Deck } from '@deck.gl/core';
+ * import { SymbolLayer } from '@accelint/map-toolkit/deckgl/symbol-layer';
+ *
+ * const layer = new SymbolLayer({
+ *   id: 'military-symbols',
+ *   data: [
+ *     { position: [-122.4, 37.74], sidc: 'SFG-UCI----D', name: 'Unit 1' },
+ *     { position: [-118.2, 34.05], sidc: 'SFG-UCIZ---D', name: 'Unit 2' },
+ *   ],
+ *   getSidc: d => d.sidc,
+ *   getPosition: d => d.position,
+ *   getSize: 32,
+ *   defaultSymbolOptions: {
+ *     colorMode: 'Dark',
+ *     size: 100,
+ *   },
+ * });
+ *
+ * new Deck({
+ *   initialViewState: { longitude: -120, latitude: 36, zoom: 6 },
+ *   controller: true,
+ *   layers: [layer],
+ * });
+ * ```
+ *
+ * @example
+ * React Fiber usage:
+ * ```tsx
+ * import '@accelint/map-toolkit/deckgl/symbol-layer/fiber';
+ * import { BaseMap } from '@accelint/map-toolkit/deckgl';
+ * import { View } from '@deckgl-fiber-renderer/dom';
+ *
+ * function MilitaryMap() {
+ *   const units = [
+ *     { position: [-122.4, 37.74], sidc: 'SFG-UCI----D', name: 'Unit 1' },
+ *     { position: [-118.2, 34.05], sidc: 'SFG-UCIZ---D', name: 'Unit 2' },
+ *   ];
+ *
+ *   return (
+ *     <BaseMap id="map" className="w-full h-full">
+ *       <View id="main" controller />
+ *       <symbolLayer
+ *         id="military-units"
+ *         data={units}
+ *         getSidc={d => d.sidc}
+ *         getPosition={d => d.position}
+ *         getSize={32}
+ *         defaultSymbolOptions={{ colorMode: 'Dark' }}
+ *       />
+ *     </BaseMap>
+ *   );
+ * }
+ * ```
  */
 declare class SymbolLayer<TData = unknown, TExtraProps extends {} = {}> extends IconLayer<TData, TExtraProps & Required<_SymbolLayerProps<TData>>> {
   static defaultProps: DefaultProps<SymbolLayerProps<unknown>>;

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

@@ -35,7 +35,78 @@ const defaultProps = {
 	}
 };
 /**
-* Provides a layer for rendering MIL-STD-2525 and APP-6 symbols.
+* A Deck.gl layer for rendering MIL-STD-2525 and APP-6 military symbols.
+*
+* This layer extends IconLayer and automatically generates symbol icons from SIDC codes.
+* It supports multiple symbology standards including MIL-STD-2525 B/C/D/E, STANAG APP6 B/D/E,
+* and FM 1-02.2.
+*
+* Features:
+* - Automatic symbol generation from SIDC codes
+* - Caching for performance optimization
+* - Customizable symbol options per data point
+* - Dark/Light color modes
+*
+* Can be used directly with Deck.gl or as a JSX element with React Fiber:
+* - React Fiber: `<symbolLayer id="symbols" data={[...]} ... />`
+* - Direct: `new SymbolLayer({ id: 'symbols', data: [...], ... })`
+*
+* @example
+* Direct Deck.gl usage:
+* ```typescript
+* import { Deck } from '@deck.gl/core';
+* import { SymbolLayer } from '@accelint/map-toolkit/deckgl/symbol-layer';
+*
+* const layer = new SymbolLayer({
+*   id: 'military-symbols',
+*   data: [
+*     { position: [-122.4, 37.74], sidc: 'SFG-UCI----D', name: 'Unit 1' },
+*     { position: [-118.2, 34.05], sidc: 'SFG-UCIZ---D', name: 'Unit 2' },
+*   ],
+*   getSidc: d => d.sidc,
+*   getPosition: d => d.position,
+*   getSize: 32,
+*   defaultSymbolOptions: {
+*     colorMode: 'Dark',
+*     size: 100,
+*   },
+* });
+*
+* new Deck({
+*   initialViewState: { longitude: -120, latitude: 36, zoom: 6 },
+*   controller: true,
+*   layers: [layer],
+* });
+* ```
+*
+* @example
+* React Fiber usage:
+* ```tsx
+* import '@accelint/map-toolkit/deckgl/symbol-layer/fiber';
+* import { BaseMap } from '@accelint/map-toolkit/deckgl';
+* import { View } from '@deckgl-fiber-renderer/dom';
+*
+* function MilitaryMap() {
+*   const units = [
+*     { position: [-122.4, 37.74], sidc: 'SFG-UCI----D', name: 'Unit 1' },
+*     { position: [-118.2, 34.05], sidc: 'SFG-UCIZ---D', name: 'Unit 2' },
+*   ];
+*
+*   return (
+*     <BaseMap id="map" className="w-full h-full">
+*       <View id="main" controller />
+*       <symbolLayer
+*         id="military-units"
+*         data={units}
+*         getSidc={d => d.sidc}
+*         getPosition={d => d.position}
+*         getSize={32}
+*         defaultSymbolOptions={{ colorMode: 'Dark' }}
+*       />
+*     </BaseMap>
+*   );
+* }
+* ```
 */
 var SymbolLayer = class extends IconLayer {
 	static defaultProps = defaultProps;

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["defaultProps: DefaultProps<SymbolLayerProps>"],"sources":["../../../src/deckgl/symbol-layer/index.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 { IconLayer, type IconLayerProps } from '@deck.gl/layers';\nimport ms, { type SymbolOptions } from 'milsymbol';\nimport type {\n  AccessorContext,\n  AccessorFunction,\n  DefaultProps,\n} from '@deck.gl/core';\n\nconst MilSymbol = ms.Symbol;\n\ntype _SymbolLayerProps<TData = unknown> = {\n  /**\n   * An accessor function that returns the SIDC for a given data point.\n   */\n  getSidc?: AccessorFunction<TData, string | number | bigint>;\n  /**\n   * An accessor function that returns symbol options for a given data point.\n   */\n  getSymbolOptions?: AccessorFunction<TData, SymbolOptions | null>;\n  /**\n   * Default symbol options to use when rendering symbols.\n   */\n  defaultSymbolOptions?: SymbolOptions;\n};\n\nexport type SymbolLayerProps<TData = unknown> = _SymbolLayerProps<TData> &\n  Omit<\n    IconLayerProps<TData>,\n    'getIcon' | 'getColor' | 'iconAtlas' | 'iconMapping'\n  >;\n\nconst defaultProps: DefaultProps<SymbolLayerProps> = {\n  // biome-ignore lint/suspicious/noExplicitAny: We don't know what the data type is.\n  getSidc: { type: 'accessor', value: (x: any) => x.sidc },\n  getSymbolOptions: { type: 'accessor', value: () => null },\n  getSize: { type: 'accessor', value: 32 },\n  defaultSymbolOptions: { type: 'object', value: {} },\n};\n\n/**\n * Provides a layer for rendering MIL-STD-2525 and APP-6 symbols.\n */\nexport class SymbolLayer<\n  TData = unknown,\n  // biome-ignore lint/complexity/noBannedTypes: Follows DeckGL format.\n  TExtraProps extends {} = {},\n> extends IconLayer<TData, TExtraProps & Required<_SymbolLayerProps<TData>>> {\n  static override defaultProps = defaultProps;\n  static override layerName = 'SymbolLayer';\n\n  /**\n   * The default symbol options to use when rendering symbols.\n   *\n   * @internal\n   */\n  protected defaultOptions: SymbolOptions;\n\n  /**\n   * Caches the results of the icon generation\n   *\n   * @internal\n   * @todo Use LRU cache to limit memory usage.\n   */\n  protected generationCache = new Map<string, string>();\n\n  constructor(...args: Partial<SymbolLayerProps<TData>>[]) {\n    // Props are frozen after the construction\n    const customGetIcons = {\n      getIcon: (data: TData, info: AccessorContext<TData>) =>\n        this.generateIcon(data, info),\n    } as IconLayerProps<TData>;\n\n    // biome-ignore lint/suspicious/noExplicitAny: Needed to retype the layer.\n    super(...(args as any), customGetIcons as any);\n\n    // Default options need to be set in the constructor.\n    this.defaultOptions = {\n      size: 100,\n      colorMode: 'Dark',\n      ...this.props.defaultSymbolOptions,\n    };\n  }\n\n  /**\n   * Generates an icon using the provided SIDC and symbol options.\n   *\n   * @param data A point's data\n   * @param info Contextual information about the point\n   * @returns DeckGL Icon Object\n   */\n  protected generateIcon = (data: TData, info: AccessorContext<TData>) => {\n    const { getSidc, getSymbolOptions } = this.props;\n    const sidc = getSidc(data, info).toString();\n\n    let currentSymbolOptions = this.defaultOptions;\n\n    const localOptions = getSymbolOptions(data, info);\n\n    if (localOptions) {\n      currentSymbolOptions = {\n        ...currentSymbolOptions,\n        ...localOptions,\n      };\n    }\n\n    const size = currentSymbolOptions.size as number;\n\n    const cacheKey = this.generateCacheKey(sidc, currentSymbolOptions);\n\n    if (this.generationCache.has(cacheKey)) {\n      const cachedUrl = this.generationCache.get(cacheKey) as string;\n\n      return {\n        id: cacheKey,\n        url: cachedUrl,\n        height: size,\n        width: size,\n      };\n    }\n\n    const dataUrl = new MilSymbol(sidc, currentSymbolOptions).toDataURL();\n\n    this.generationCache.set(cacheKey, dataUrl);\n\n    const returnData = {\n      id: cacheKey,\n      url: dataUrl,\n      height: size,\n      width: size,\n    };\n\n    return returnData;\n  };\n\n  /**\n   * Generates a cache key for the given SIDC and symbol options.\n   *\n   * @param sidc SIDC of the symbol\n   * @param options Options used to generate the symbol\n   * @returns String key for caching\n   */\n  protected generateCacheKey(sidc: string, options: SymbolOptions) {\n    return `${sidc}-${JSON.stringify(options)}`;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAoBA,MAAM,YAAY,GAAG;AAuBrB,MAAMA,eAA+C;CAEnD,SAAS;EAAE,MAAM;EAAY,QAAQ,MAAW,EAAE;EAAM;CACxD,kBAAkB;EAAE,MAAM;EAAY,aAAa;EAAM;CACzD,SAAS;EAAE,MAAM;EAAY,OAAO;EAAI;CACxC,sBAAsB;EAAE,MAAM;EAAU,OAAO,EAAE;EAAE;CACpD;;;;AAKD,IAAa,cAAb,cAIU,UAAmE;CAC3E,OAAgB,eAAe;CAC/B,OAAgB,YAAY;;;;;;CAO5B,AAAU;;;;;;;CAQV,AAAU,kCAAkB,IAAI,KAAqB;CAErD,YAAY,GAAG,MAA0C;EAEvD,MAAM,iBAAiB,EACrB,UAAU,MAAa,SACrB,KAAK,aAAa,MAAM,KAAK,EAChC;AAGD,QAAM,GAAI,MAAc,eAAsB;AAG9C,OAAK,iBAAiB;GACpB,MAAM;GACN,WAAW;GACX,GAAG,KAAK,MAAM;GACf;;;;;;;;;CAUH,AAAU,gBAAgB,MAAa,SAAiC;EACtE,MAAM,EAAE,SAAS,qBAAqB,KAAK;EAC3C,MAAM,OAAO,QAAQ,MAAM,KAAK,CAAC,UAAU;EAE3C,IAAI,uBAAuB,KAAK;EAEhC,MAAM,eAAe,iBAAiB,MAAM,KAAK;AAEjD,MAAI,aACF,wBAAuB;GACrB,GAAG;GACH,GAAG;GACJ;EAGH,MAAM,OAAO,qBAAqB;EAElC,MAAM,WAAW,KAAK,iBAAiB,MAAM,qBAAqB;AAElE,MAAI,KAAK,gBAAgB,IAAI,SAAS,CAGpC,QAAO;GACL,IAAI;GACJ,KAJgB,KAAK,gBAAgB,IAAI,SAAS;GAKlD,QAAQ;GACR,OAAO;GACR;EAGH,MAAM,UAAU,IAAI,UAAU,MAAM,qBAAqB,CAAC,WAAW;AAErE,OAAK,gBAAgB,IAAI,UAAU,QAAQ;AAS3C,SAPmB;GACjB,IAAI;GACJ,KAAK;GACL,QAAQ;GACR,OAAO;GACR;;;;;;;;;CAYH,AAAU,iBAAiB,MAAc,SAAwB;AAC/D,SAAO,GAAG,KAAK,GAAG,KAAK,UAAU,QAAQ"}
+{"version":3,"file":"index.js","names":["defaultProps: DefaultProps<SymbolLayerProps>"],"sources":["../../../src/deckgl/symbol-layer/index.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 { IconLayer, type IconLayerProps } from '@deck.gl/layers';\nimport ms, { type SymbolOptions } from 'milsymbol';\nimport type {\n  AccessorContext,\n  AccessorFunction,\n  DefaultProps,\n} from '@deck.gl/core';\n\nconst MilSymbol = ms.Symbol;\n\n/**\n * Internal props specific to SymbolLayer.\n */\ntype _SymbolLayerProps<TData = unknown> = {\n  /**\n   * An accessor function that returns the SIDC for a given data point.\n   */\n  getSidc?: AccessorFunction<TData, string | number | bigint>;\n  /**\n   * An accessor function that returns symbol options for a given data point.\n   */\n  getSymbolOptions?: AccessorFunction<TData, SymbolOptions | null>;\n  /**\n   * Default symbol options to use when rendering symbols.\n   */\n  defaultSymbolOptions?: SymbolOptions;\n};\n\n/**\n * Props for SymbolLayer component.\n * Extends IconLayer props with MIL-STD-2525 symbol rendering support.\n */\nexport type SymbolLayerProps<TData = unknown> = _SymbolLayerProps<TData> &\n  Omit<\n    IconLayerProps<TData>,\n    'getIcon' | 'getColor' | 'iconAtlas' | 'iconMapping'\n  >;\n\nconst defaultProps: DefaultProps<SymbolLayerProps> = {\n  // biome-ignore lint/suspicious/noExplicitAny: We don't know what the data type is.\n  getSidc: { type: 'accessor', value: (x: any) => x.sidc },\n  getSymbolOptions: { type: 'accessor', value: () => null },\n  getSize: { type: 'accessor', value: 32 },\n  defaultSymbolOptions: { type: 'object', value: {} },\n};\n\n/**\n * A Deck.gl layer for rendering MIL-STD-2525 and APP-6 military symbols.\n *\n * This layer extends IconLayer and automatically generates symbol icons from SIDC codes.\n * It supports multiple symbology standards including MIL-STD-2525 B/C/D/E, STANAG APP6 B/D/E,\n * and FM 1-02.2.\n *\n * Features:\n * - Automatic symbol generation from SIDC codes\n * - Caching for performance optimization\n * - Customizable symbol options per data point\n * - Dark/Light color modes\n *\n * Can be used directly with Deck.gl or as a JSX element with React Fiber:\n * - React Fiber: `<symbolLayer id=\"symbols\" data={[...]} ... />`\n * - Direct: `new SymbolLayer({ id: 'symbols', data: [...], ... })`\n *\n * @example\n * Direct Deck.gl usage:\n * ```typescript\n * import { Deck } from '@deck.gl/core';\n * import { SymbolLayer } from '@accelint/map-toolkit/deckgl/symbol-layer';\n *\n * const layer = new SymbolLayer({\n *   id: 'military-symbols',\n *   data: [\n *     { position: [-122.4, 37.74], sidc: 'SFG-UCI----D', name: 'Unit 1' },\n *     { position: [-118.2, 34.05], sidc: 'SFG-UCIZ---D', name: 'Unit 2' },\n *   ],\n *   getSidc: d => d.sidc,\n *   getPosition: d => d.position,\n *   getSize: 32,\n *   defaultSymbolOptions: {\n *     colorMode: 'Dark',\n *     size: 100,\n *   },\n * });\n *\n * new Deck({\n *   initialViewState: { longitude: -120, latitude: 36, zoom: 6 },\n *   controller: true,\n *   layers: [layer],\n * });\n * ```\n *\n * @example\n * React Fiber usage:\n * ```tsx\n * import '@accelint/map-toolkit/deckgl/symbol-layer/fiber';\n * import { BaseMap } from '@accelint/map-toolkit/deckgl';\n * import { View } from '@deckgl-fiber-renderer/dom';\n *\n * function MilitaryMap() {\n *   const units = [\n *     { position: [-122.4, 37.74], sidc: 'SFG-UCI----D', name: 'Unit 1' },\n *     { position: [-118.2, 34.05], sidc: 'SFG-UCIZ---D', name: 'Unit 2' },\n *   ];\n *\n *   return (\n *     <BaseMap id=\"map\" className=\"w-full h-full\">\n *       <View id=\"main\" controller />\n *       <symbolLayer\n *         id=\"military-units\"\n *         data={units}\n *         getSidc={d => d.sidc}\n *         getPosition={d => d.position}\n *         getSize={32}\n *         defaultSymbolOptions={{ colorMode: 'Dark' }}\n *       />\n *     </BaseMap>\n *   );\n * }\n * ```\n */\nexport class SymbolLayer<\n  TData = unknown,\n  // biome-ignore lint/complexity/noBannedTypes: Follows DeckGL format.\n  TExtraProps extends {} = {},\n> extends IconLayer<TData, TExtraProps & Required<_SymbolLayerProps<TData>>> {\n  static override defaultProps = defaultProps;\n  static override layerName = 'SymbolLayer';\n\n  /**\n   * The default symbol options to use when rendering symbols.\n   *\n   * @internal\n   */\n  protected defaultOptions: SymbolOptions;\n\n  /**\n   * Caches the results of the icon generation\n   *\n   * @internal\n   * @todo Use LRU cache to limit memory usage.\n   */\n  protected generationCache = new Map<string, string>();\n\n  constructor(...args: Partial<SymbolLayerProps<TData>>[]) {\n    // Props are frozen after the construction\n    const customGetIcons = {\n      getIcon: (data: TData, info: AccessorContext<TData>) =>\n        this.generateIcon(data, info),\n    } as IconLayerProps<TData>;\n\n    // biome-ignore lint/suspicious/noExplicitAny: Needed to retype the layer.\n    super(...(args as any), customGetIcons as any);\n\n    // Default options need to be set in the constructor.\n    this.defaultOptions = {\n      size: 100,\n      colorMode: 'Dark',\n      ...this.props.defaultSymbolOptions,\n    };\n  }\n\n  /**\n   * Generates an icon using the provided SIDC and symbol options.\n   *\n   * @param data A point's data\n   * @param info Contextual information about the point\n   * @returns DeckGL Icon Object\n   */\n  protected generateIcon = (data: TData, info: AccessorContext<TData>) => {\n    const { getSidc, getSymbolOptions } = this.props;\n    const sidc = getSidc(data, info).toString();\n\n    let currentSymbolOptions = this.defaultOptions;\n\n    const localOptions = getSymbolOptions(data, info);\n\n    if (localOptions) {\n      currentSymbolOptions = {\n        ...currentSymbolOptions,\n        ...localOptions,\n      };\n    }\n\n    const size = currentSymbolOptions.size as number;\n\n    const cacheKey = this.generateCacheKey(sidc, currentSymbolOptions);\n\n    if (this.generationCache.has(cacheKey)) {\n      const cachedUrl = this.generationCache.get(cacheKey) as string;\n\n      return {\n        id: cacheKey,\n        url: cachedUrl,\n        height: size,\n        width: size,\n      };\n    }\n\n    const dataUrl = new MilSymbol(sidc, currentSymbolOptions).toDataURL();\n\n    this.generationCache.set(cacheKey, dataUrl);\n\n    const returnData = {\n      id: cacheKey,\n      url: dataUrl,\n      height: size,\n      width: size,\n    };\n\n    return returnData;\n  };\n\n  /**\n   * Generates a cache key for the given SIDC and symbol options.\n   *\n   * @param sidc SIDC of the symbol\n   * @param options Options used to generate the symbol\n   * @returns String key for caching\n   */\n  protected generateCacheKey(sidc: string, options: SymbolOptions) {\n    return `${sidc}-${JSON.stringify(options)}`;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAoBA,MAAM,YAAY,GAAG;AA8BrB,MAAMA,eAA+C;CAEnD,SAAS;EAAE,MAAM;EAAY,QAAQ,MAAW,EAAE;EAAM;CACxD,kBAAkB;EAAE,MAAM;EAAY,aAAa;EAAM;CACzD,SAAS;EAAE,MAAM;EAAY,OAAO;EAAI;CACxC,sBAAsB;EAAE,MAAM;EAAU,OAAO,EAAE;EAAE;CACpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4ED,IAAa,cAAb,cAIU,UAAmE;CAC3E,OAAgB,eAAe;CAC/B,OAAgB,YAAY;;;;;;CAO5B,AAAU;;;;;;;CAQV,AAAU,kCAAkB,IAAI,KAAqB;CAErD,YAAY,GAAG,MAA0C;EAEvD,MAAM,iBAAiB,EACrB,UAAU,MAAa,SACrB,KAAK,aAAa,MAAM,KAAK,EAChC;AAGD,QAAM,GAAI,MAAc,eAAsB;AAG9C,OAAK,iBAAiB;GACpB,MAAM;GACN,WAAW;GACX,GAAG,KAAK,MAAM;GACf;;;;;;;;;CAUH,AAAU,gBAAgB,MAAa,SAAiC;EACtE,MAAM,EAAE,SAAS,qBAAqB,KAAK;EAC3C,MAAM,OAAO,QAAQ,MAAM,KAAK,CAAC,UAAU;EAE3C,IAAI,uBAAuB,KAAK;EAEhC,MAAM,eAAe,iBAAiB,MAAM,KAAK;AAEjD,MAAI,aACF,wBAAuB;GACrB,GAAG;GACH,GAAG;GACJ;EAGH,MAAM,OAAO,qBAAqB;EAElC,MAAM,WAAW,KAAK,iBAAiB,MAAM,qBAAqB;AAElE,MAAI,KAAK,gBAAgB,IAAI,SAAS,CAGpC,QAAO;GACL,IAAI;GACJ,KAJgB,KAAK,gBAAgB,IAAI,SAAS;GAKlD,QAAQ;GACR,OAAO;GACR;EAGH,MAAM,UAAU,IAAI,UAAU,MAAM,qBAAqB,CAAC,WAAW;AAErE,OAAK,gBAAgB,IAAI,UAAU,QAAQ;AAS3C,SAPmB;GACjB,IAAI;GACJ,KAAK;GACL,QAAQ;GACR,OAAO;GACR;;;;;;;;;CAYH,AAAU,iBAAiB,MAAc,SAAwB;AAC/D,SAAO,GAAG,KAAK,GAAG,KAAK,UAAU,QAAQ"}

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

@@ -1,4 +1,8 @@
 //#region src/deckgl/text-layer/character-sets.d.ts
+/**
+ * Valid keys for predefined character sets.
+ * Used for type-safe character set selection.
+ */
 type CharacterSetsKeys = keyof typeof CHARACTER_SETS;
 /**
  * Predefined character sets for TextLayer.
@@ -6,6 +10,32 @@ type CharacterSetsKeys = keyof typeof CHARACTER_SETS;
  * Use smaller character sets (ASCII_ALL, ASCII_ALPHA_NUMERIC) for better performance,
  * or use AUTO for dynamic optimization based on content.
  * EXPANDED includes ASCII and Latin characters with diacritics for international text.
+ *
+ * @example
+ * ```typescript
+ * import { TextLayer, CHARACTER_SETS } from '@accelint/map-toolkit/deckgl/text-layer';
+ *
+ * // Use ASCII-only for better performance
+ * const asciiLayer = new TextLayer({
+ *   id: 'ascii-text',
+ *   data: [...],
+ *   characterSet: CHARACTER_SETS.ASCII_ALL,
+ * });
+ *
+ * // Use EXPANDED for international text with diacritics
+ * const internationalLayer = new TextLayer({
+ *   id: 'international-text',
+ *   data: [...],
+ *   characterSet: CHARACTER_SETS.EXPANDED,
+ * });
+ *
+ * // Use AUTO for dynamic optimization
+ * const autoLayer = new TextLayer({
+ *   id: 'auto-text',
+ *   data: [...],
+ *   characterSet: CHARACTER_SETS.AUTO,
+ * });
+ * ```
  */
 declare const CHARACTER_SETS: Readonly<{
   readonly ALL_NUMBERS: "1234567890";

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

@@ -33,6 +33,32 @@ const EXPANDED = `${ASCII_ALL}${LATIN_ALL}`;
 * Use smaller character sets (ASCII_ALL, ASCII_ALPHA_NUMERIC) for better performance,
 * or use AUTO for dynamic optimization based on content.
 * EXPANDED includes ASCII and Latin characters with diacritics for international text.
+*
+* @example
+* ```typescript
+* import { TextLayer, CHARACTER_SETS } from '@accelint/map-toolkit/deckgl/text-layer';
+*
+* // Use ASCII-only for better performance
+* const asciiLayer = new TextLayer({
+*   id: 'ascii-text',
+*   data: [...],
+*   characterSet: CHARACTER_SETS.ASCII_ALL,
+* });
+*
+* // Use EXPANDED for international text with diacritics
+* const internationalLayer = new TextLayer({
+*   id: 'international-text',
+*   data: [...],
+*   characterSet: CHARACTER_SETS.EXPANDED,
+* });
+*
+* // Use AUTO for dynamic optimization
+* const autoLayer = new TextLayer({
+*   id: 'auto-text',
+*   data: [...],
+*   characterSet: CHARACTER_SETS.AUTO,
+* });
+* ```
 */
 const CHARACTER_SETS = Object.freeze({
 	ALL_NUMBERS,

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

@@ -1 +1 @@
-{"version":3,"file":"character-sets.js","names":[],"sources":["../../../src/deckgl/text-layer/character-sets.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\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\n/**\n * Predefined character sets for TextLayer.\n *\n * Use smaller character sets (ASCII_ALL, ASCII_ALPHA_NUMERIC) for better performance,\n * or use AUTO for dynamic optimization based on content.\n * EXPANDED includes ASCII and Latin characters with diacritics for international text.\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"],"mappings":";;;;;;;;;;;;;;AAYA,MAAM,cAAc;AAEpB,MAAM,0BAA0B;AAChC,MAAM,0BAA0B;AAChC,MAAM,gBAAgB;AAEtB,MAAM,gBAAgB,GAAG,0BAA0B;AACnD,MAAM,sBAAsB,GAAG,gBAAgB;AAC/C,MAAM,YAAY,GAAG,gBAAgB,cAAc;AAEnD,MAAM,OAAO;AAEb,MAAM,0BAA0B;AAChC,MAAM,0BAA0B;AAChC,MAAM,gBAAgB;AAEtB,MAAM,gBAAgB,GAAG,0BAA0B;AACnD,MAAM,sBAAsB,GAAG,gBAAgB;AAC/C,MAAM,YAAY,GAAG,gBAAgB,cAAc;AAEnD,MAAM,WAAW,GAAG,YAAY;;;;;;;;AAWhC,MAAa,iBAAiB,OAAO,OAAO;CAC1C;CAEA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CAEA;CACA;CACA;CACA;CACA;CACA;CACD,CAAU"}
+{"version":3,"file":"character-sets.js","names":[],"sources":["../../../src/deckgl/text-layer/character-sets.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\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\n/**\n * Valid keys for predefined character sets.\n * Used for type-safe character set selection.\n */\nexport type CharacterSetsKeys = keyof typeof CHARACTER_SETS;\n\n/**\n * Predefined character sets for TextLayer.\n *\n * Use smaller character sets (ASCII_ALL, ASCII_ALPHA_NUMERIC) for better performance,\n * or use AUTO for dynamic optimization based on content.\n * EXPANDED includes ASCII and Latin characters with diacritics for international text.\n *\n * @example\n * ```typescript\n * import { TextLayer, CHARACTER_SETS } from '@accelint/map-toolkit/deckgl/text-layer';\n *\n * // Use ASCII-only for better performance\n * const asciiLayer = new TextLayer({\n *   id: 'ascii-text',\n *   data: [...],\n *   characterSet: CHARACTER_SETS.ASCII_ALL,\n * });\n *\n * // Use EXPANDED for international text with diacritics\n * const internationalLayer = new TextLayer({\n *   id: 'international-text',\n *   data: [...],\n *   characterSet: CHARACTER_SETS.EXPANDED,\n * });\n *\n * // Use AUTO for dynamic optimization\n * const autoLayer = new TextLayer({\n *   id: 'auto-text',\n *   data: [...],\n *   characterSet: CHARACTER_SETS.AUTO,\n * });\n * ```\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"],"mappings":";;;;;;;;;;;;;;AAYA,MAAM,cAAc;AAEpB,MAAM,0BAA0B;AAChC,MAAM,0BAA0B;AAChC,MAAM,gBAAgB;AAEtB,MAAM,gBAAgB,GAAG,0BAA0B;AACnD,MAAM,sBAAsB,GAAG,gBAAgB;AAC/C,MAAM,YAAY,GAAG,gBAAgB,cAAc;AAEnD,MAAM,OAAO;AAEb,MAAM,0BAA0B;AAChC,MAAM,0BAA0B;AAChC,MAAM,gBAAgB;AAEtB,MAAM,gBAAgB,GAAG,0BAA0B;AACnD,MAAM,sBAAsB,GAAG,gBAAgB;AAC/C,MAAM,YAAY,GAAG,gBAAgB,cAAc;AAEnD,MAAM,WAAW,GAAG,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyChC,MAAa,iBAAiB,OAAO,OAAO;CAC1C;CAEA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CAEA;CACA;CACA;CACA;CACA;CACA;CACD,CAAU"}

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

@@ -13,6 +13,35 @@
 import { TextLayerProps } from "@deck.gl/layers";
 
 //#region src/deckgl/text-layer/default-settings.d.ts
+
+/**
+ * Default settings for TextLayer with opinionated styling.
+ *
+ * Provides consistent text rendering with white text, black outline,
+ * centered alignment, and system font stack for optimal performance.
+ *
+ * @example
+ * ```typescript
+ * import { TextLayer } from '@accelint/map-toolkit/deckgl/text-layer';
+ * import { defaultSettings } from '@accelint/map-toolkit/deckgl/text-layer/default-settings';
+ *
+ * // Use defaults as-is
+ * const layer = new TextLayer({
+ *   id: 'text',
+ *   data: [...],
+ *   ...defaultSettings,
+ * });
+ *
+ * // Override specific defaults
+ * const customLayer = new TextLayer({
+ *   id: 'text',
+ *   data: [...],
+ *   ...defaultSettings,
+ *   fontFamily: 'Arial',
+ *   getSize: 14,
+ * });
+ * ```
+ */
 declare const defaultSettings: Partial<TextLayerProps>;
 //#endregion
 export { defaultSettings };

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

@@ -14,6 +14,34 @@
 import { DEFAULT_TEXT_STYLE } from "../text-settings.js";
 
 //#region src/deckgl/text-layer/default-settings.ts
+/**
+* Default settings for TextLayer with opinionated styling.
+*
+* Provides consistent text rendering with white text, black outline,
+* centered alignment, and system font stack for optimal performance.
+*
+* @example
+* ```typescript
+* import { TextLayer } from '@accelint/map-toolkit/deckgl/text-layer';
+* import { defaultSettings } from '@accelint/map-toolkit/deckgl/text-layer/default-settings';
+*
+* // Use defaults as-is
+* const layer = new TextLayer({
+*   id: 'text',
+*   data: [...],
+*   ...defaultSettings,
+* });
+*
+* // Override specific defaults
+* const customLayer = new TextLayer({
+*   id: 'text',
+*   data: [...],
+*   ...defaultSettings,
+*   fontFamily: 'Arial',
+*   getSize: 14,
+* });
+* ```
+*/
 const defaultSettings = {
 	...DEFAULT_TEXT_STYLE,
 	fontFamily: "system-ui, sans-serif",

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

@@ -1 +1 @@
-{"version":3,"file":"default-settings.js","names":["defaultSettings: Partial<DglTextLayerProps>"],"sources":["../../../src/deckgl/text-layer/default-settings.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 { DEFAULT_TEXT_STYLE } from '../text-settings';\nimport type { TextLayerProps as DglTextLayerProps } from '@deck.gl/layers';\n\nexport const defaultSettings: Partial<DglTextLayerProps> = {\n  ...DEFAULT_TEXT_STYLE,\n  fontFamily: 'system-ui, sans-serif',\n  getAlignmentBaseline: 'center',\n  getTextAnchor: 'middle',\n  lineHeight: 1,\n} as const;\n"],"mappings":";;;;;;;;;;;;;;;;AAeA,MAAaA,kBAA8C;CACzD,GAAG;CACH,YAAY;CACZ,sBAAsB;CACtB,eAAe;CACf,YAAY;CACb"}
+{"version":3,"file":"default-settings.js","names":["defaultSettings: Partial<DglTextLayerProps>"],"sources":["../../../src/deckgl/text-layer/default-settings.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 { DEFAULT_TEXT_STYLE } from '../text-settings';\nimport type { TextLayerProps as DglTextLayerProps } from '@deck.gl/layers';\n\n/**\n * Default settings for TextLayer with opinionated styling.\n *\n * Provides consistent text rendering with white text, black outline,\n * centered alignment, and system font stack for optimal performance.\n *\n * @example\n * ```typescript\n * import { TextLayer } from '@accelint/map-toolkit/deckgl/text-layer';\n * import { defaultSettings } from '@accelint/map-toolkit/deckgl/text-layer/default-settings';\n *\n * // Use defaults as-is\n * const layer = new TextLayer({\n *   id: 'text',\n *   data: [...],\n *   ...defaultSettings,\n * });\n *\n * // Override specific defaults\n * const customLayer = new TextLayer({\n *   id: 'text',\n *   data: [...],\n *   ...defaultSettings,\n *   fontFamily: 'Arial',\n *   getSize: 14,\n * });\n * ```\n */\nexport const defaultSettings: Partial<DglTextLayerProps> = {\n  ...DEFAULT_TEXT_STYLE,\n  fontFamily: 'system-ui, sans-serif',\n  getAlignmentBaseline: 'center',\n  getTextAnchor: 'middle',\n  lineHeight: 1,\n} as const;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CA,MAAaA,kBAA8C;CACzD,GAAG;CACH,YAAY;CACZ,sBAAsB;CACtB,eAAe;CACf,YAAY;CACb"}

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

@@ -15,7 +15,16 @@ import { TextLayer as TextLayer$1, TextLayerProps as TextLayerProps$1 } from "@d
 import { LiteralUnion } from "type-fest";
 
 //#region src/deckgl/text-layer/index.d.ts
+/**
+ * Props for TextLayer component.
+ * Extends Deck.gl's TextLayerProps with enhanced character set support.
+ */
 interface TextLayerProps<TData = unknown> extends TextLayerProps$1<TData> {
+  /**
+   * Character set to use for text rendering.
+   * Can be a predefined CHARACTER_SETS key or a custom string of characters.
+   * Defaults to CHARACTER_SETS.EXPANDED for international text support.
+   */
   characterSet?: LiteralUnion<CharacterSetsKeys, string>;
 }
 /**
@@ -30,6 +39,62 @@ interface TextLayerProps<TData = unknown> extends TextLayerProps$1<TData> {
  * 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: [...], ... })`
+ *
+ * @example
+ * Direct Deck.gl usage:
+ * ```typescript
+ * import { Deck } from '@deck.gl/core';
+ * import { TextLayer } from '@accelint/map-toolkit/deckgl/text-layer';
+ *
+ * const layer = new TextLayer({
+ *   id: 'text-labels',
+ *   data: [
+ *     { position: [-122.4, 37.74], text: 'San Francisco' },
+ *     { position: [-118.2, 34.05], text: 'Los Angeles' },
+ *   ],
+ *   getText: d => d.text,
+ *   getPosition: d => d.position,
+ *   getSize: 14,
+ *   fontWeight: 600,
+ *   outlineWidth: 2,
+ * });
+ *
+ * new Deck({
+ *   initialViewState: { longitude: -120, latitude: 36, zoom: 6 },
+ *   controller: true,
+ *   layers: [layer],
+ * });
+ * ```
+ *
+ * @example
+ * React Fiber usage:
+ * ```tsx
+ * import '@accelint/map-toolkit/deckgl/text-layer/fiber';
+ * import { BaseMap } from '@accelint/map-toolkit/deckgl';
+ * import { View } from '@deckgl-fiber-renderer/dom';
+ *
+ * function MapWithLabels() {
+ *   const cities = [
+ *     { position: [-122.4, 37.74], text: 'San Francisco' },
+ *     { position: [-118.2, 34.05], text: 'Los Angeles' },
+ *   ];
+ *
+ *   return (
+ *     <BaseMap id="map" className="w-full h-full">
+ *       <View id="main" controller />
+ *       <textLayer
+ *         id="city-labels"
+ *         data={cities}
+ *         getText={d => d.text}
+ *         getPosition={d => d.position}
+ *         getSize={14}
+ *         fontWeight={600}
+ *         outlineWidth={2}
+ *       />
+ *     </BaseMap>
+ *   );
+ * }
+ * ```
  */
 declare class TextLayer<TData = unknown> extends TextLayer$1<TData> {
   static CHARACTER_SETS: Readonly<{

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

@@ -28,6 +28,62 @@ import { TextLayer as TextLayer$1 } from "@deck.gl/layers";
 * 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: [...], ... })`
+*
+* @example
+* Direct Deck.gl usage:
+* ```typescript
+* import { Deck } from '@deck.gl/core';
+* import { TextLayer } from '@accelint/map-toolkit/deckgl/text-layer';
+*
+* const layer = new TextLayer({
+*   id: 'text-labels',
+*   data: [
+*     { position: [-122.4, 37.74], text: 'San Francisco' },
+*     { position: [-118.2, 34.05], text: 'Los Angeles' },
+*   ],
+*   getText: d => d.text,
+*   getPosition: d => d.position,
+*   getSize: 14,
+*   fontWeight: 600,
+*   outlineWidth: 2,
+* });
+*
+* new Deck({
+*   initialViewState: { longitude: -120, latitude: 36, zoom: 6 },
+*   controller: true,
+*   layers: [layer],
+* });
+* ```
+*
+* @example
+* React Fiber usage:
+* ```tsx
+* import '@accelint/map-toolkit/deckgl/text-layer/fiber';
+* import { BaseMap } from '@accelint/map-toolkit/deckgl';
+* import { View } from '@deckgl-fiber-renderer/dom';
+*
+* function MapWithLabels() {
+*   const cities = [
+*     { position: [-122.4, 37.74], text: 'San Francisco' },
+*     { position: [-118.2, 34.05], text: 'Los Angeles' },
+*   ];
+*
+*   return (
+*     <BaseMap id="map" className="w-full h-full">
+*       <View id="main" controller />
+*       <textLayer
+*         id="city-labels"
+*         data={cities}
+*         getText={d => d.text}
+*         getPosition={d => d.position}
+*         getSize={14}
+*         fontWeight={600}
+*         outlineWidth={2}
+*       />
+*     </BaseMap>
+*   );
+* }
+* ```
 */
 var TextLayer = class extends TextLayer$1 {
 	static CHARACTER_SETS = CHARACTER_SETS;

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["DglTextLayer"],"sources":["../../../src/deckgl/text-layer/index.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  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"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,IAAa,YAAb,cAAgDA,YAAoB;CAClE,OAAO,iBAAiB;CAExB,OAAgB,YAAY;CAE5B,YAAY,OAA8B;EACxC,MAAM,EACJ,eAAe,eAAe,UAC9B,cACA,GAAG,SACD;AAEJ,QAAM;GAEJ,GAAG;GAGH,GAAG;GAGH,cACE,eAAe,iBAAsC;GAEvD,cAAc;IAEZ,GAAG,gBAAgB;IAGnB,GAAG;IACJ;GACF,CAAC"}
+{"version":3,"file":"index.js","names":["DglTextLayer"],"sources":["../../../src/deckgl/text-layer/index.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  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\n/**\n * Props for TextLayer component.\n * Extends Deck.gl's TextLayerProps with enhanced character set support.\n */\nexport interface TextLayerProps<TData = unknown>\n  extends DglTextLayerProps<TData> {\n  /**\n   * Character set to use for text rendering.\n   * Can be a predefined CHARACTER_SETS key or a custom string of characters.\n   * Defaults to CHARACTER_SETS.EXPANDED for international text support.\n   */\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 *\n * @example\n * Direct Deck.gl usage:\n * ```typescript\n * import { Deck } from '@deck.gl/core';\n * import { TextLayer } from '@accelint/map-toolkit/deckgl/text-layer';\n *\n * const layer = new TextLayer({\n *   id: 'text-labels',\n *   data: [\n *     { position: [-122.4, 37.74], text: 'San Francisco' },\n *     { position: [-118.2, 34.05], text: 'Los Angeles' },\n *   ],\n *   getText: d => d.text,\n *   getPosition: d => d.position,\n *   getSize: 14,\n *   fontWeight: 600,\n *   outlineWidth: 2,\n * });\n *\n * new Deck({\n *   initialViewState: { longitude: -120, latitude: 36, zoom: 6 },\n *   controller: true,\n *   layers: [layer],\n * });\n * ```\n *\n * @example\n * React Fiber usage:\n * ```tsx\n * import '@accelint/map-toolkit/deckgl/text-layer/fiber';\n * import { BaseMap } from '@accelint/map-toolkit/deckgl';\n * import { View } from '@deckgl-fiber-renderer/dom';\n *\n * function MapWithLabels() {\n *   const cities = [\n *     { position: [-122.4, 37.74], text: 'San Francisco' },\n *     { position: [-118.2, 34.05], text: 'Los Angeles' },\n *   ];\n *\n *   return (\n *     <BaseMap id=\"map\" className=\"w-full h-full\">\n *       <View id=\"main\" controller />\n *       <textLayer\n *         id=\"city-labels\"\n *         data={cities}\n *         getText={d => d.text}\n *         getPosition={d => d.position}\n *         getSize={14}\n *         fontWeight={600}\n *         outlineWidth={2}\n *       />\n *     </BaseMap>\n *   );\n * }\n * ```\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"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuGA,IAAa,YAAb,cAAgDA,YAAoB;CAClE,OAAO,iBAAiB;CAExB,OAAgB,YAAY;CAE5B,YAAY,OAA8B;EACxC,MAAM,EACJ,eAAe,eAAe,UAC9B,cACA,GAAG,SACD;AAEJ,QAAM;GAEJ,GAAG;GAGH,GAAG;GAGH,cACE,eAAe,iBAAsC;GAEvD,cAAc;IAEZ,GAAG,gBAAgB;IAGnB,GAAG;IACJ;GACF,CAAC"}

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

@@ -2,6 +2,25 @@
 /**
  * Event keys for map cursor state changes.
  * These events are used for communication between cursor stores and consumers.
+ *
+ * @example
+ * ```typescript
+ * import { Broadcast } from '@accelint/bus';
+ * import { MapCursorEvents } from '@accelint/map-toolkit/map-cursor';
+ * import type { MapCursorEventType } from '@accelint/map-toolkit/map-cursor';
+ *
+ * const bus = Broadcast.getInstance<MapCursorEventType>();
+ *
+ * // Listen for cursor changes
+ * bus.on(MapCursorEvents.changed, (event) => {
+ *   console.log('Cursor changed to:', event.payload.currentCursor);
+ * });
+ *
+ * // Listen for rejections
+ * bus.on(MapCursorEvents.rejected, (event) => {
+ *   console.warn('Cursor change rejected:', event.payload.reason);
+ * });
+ * ```
  */
 declare const MapCursorEvents: {
   /** Emitted when a component requests a cursor change */

package/dist/map-cursor/events.js

@@ -15,6 +15,25 @@
 /**
 * Event keys for map cursor state changes.
 * These events are used for communication between cursor stores and consumers.
+*
+* @example
+* ```typescript
+* import { Broadcast } from '@accelint/bus';
+* import { MapCursorEvents } from '@accelint/map-toolkit/map-cursor';
+* import type { MapCursorEventType } from '@accelint/map-toolkit/map-cursor';
+*
+* const bus = Broadcast.getInstance<MapCursorEventType>();
+*
+* // Listen for cursor changes
+* bus.on(MapCursorEvents.changed, (event) => {
+*   console.log('Cursor changed to:', event.payload.currentCursor);
+* });
+*
+* // Listen for rejections
+* bus.on(MapCursorEvents.rejected, (event) => {
+*   console.warn('Cursor change rejected:', event.payload.reason);
+* });
+* ```
 */
 const MapCursorEvents = {
 	changeRequest: "cursor:change-request",

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

@@ -1 +1 @@
-{"version":3,"file":"events.js","names":[],"sources":["../../src/map-cursor/events.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 * Event keys for map cursor state changes.\n * These events are used for communication between cursor stores and consumers.\n */\nexport const MapCursorEvents = {\n  /** Emitted when a component requests a cursor change */\n  changeRequest: 'cursor:change-request',\n  /** Emitted when the cursor has been changed */\n  changed: 'cursor:changed',\n  /** Emitted when a cursor change request is rejected */\n  rejected: 'cursor:rejected',\n} as const;\n"],"mappings":";;;;;;;;;;;;;;;;;;AAgBA,MAAa,kBAAkB;CAE7B,eAAe;CAEf,SAAS;CAET,UAAU;CACX"}
+{"version":3,"file":"events.js","names":[],"sources":["../../src/map-cursor/events.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 * Event keys for map cursor state changes.\n * These events are used for communication between cursor stores and consumers.\n *\n * @example\n * ```typescript\n * import { Broadcast } from '@accelint/bus';\n * import { MapCursorEvents } from '@accelint/map-toolkit/map-cursor';\n * import type { MapCursorEventType } from '@accelint/map-toolkit/map-cursor';\n *\n * const bus = Broadcast.getInstance<MapCursorEventType>();\n *\n * // Listen for cursor changes\n * bus.on(MapCursorEvents.changed, (event) => {\n *   console.log('Cursor changed to:', event.payload.currentCursor);\n * });\n *\n * // Listen for rejections\n * bus.on(MapCursorEvents.rejected, (event) => {\n *   console.warn('Cursor change rejected:', event.payload.reason);\n * });\n * ```\n */\nexport const MapCursorEvents = {\n  /** Emitted when a component requests a cursor change */\n  changeRequest: 'cursor:change-request',\n  /** Emitted when the cursor has been changed */\n  changed: 'cursor:changed',\n  /** Emitted when a cursor change request is rejected */\n  rejected: 'cursor:rejected',\n} as const;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,MAAa,kBAAkB;CAE7B,eAAe;CAEf,SAAS;CAET,UAAU;CACX"}