@accelint/map-toolkit 0.5.0 → 0.6.0

package/dist/{node_modules/.pnpm/@math.gl_web-mercator@4.1.0/node_modules/@math.gl/web-mercator/dist/math-utils.js → deckgl/shapes/index.js}

@@ -11,15 +11,10 @@
  */
 
 
-//#region ../../node_modules/.pnpm/@math.gl+web-mercator@4.1.0/node_modules/@math.gl/web-mercator/dist/math-utils.js
-function clamp(x, min, max) {
-	return x < min ? min : x > max ? max : x;
-}
-function ieLog2(x) {
-	return Math.log(x) * Math.LOG2E;
-}
-const log2 = Math.log2 || ieLog2;
+import { BASE_FILL_OPACITY, DASH_ARRAYS, DEFAULT_COLORS, DEFAULT_STYLE_PROPERTIES, SHAPE_LAYER_IDS, STROKE_PATTERNS, STROKE_WIDTHS } from "./shared/constants.js";
+import { SHAPE_EVENTS, ShapeEvents } from "./shared/events.js";
+import { DisplayShapeLayer } from "./display-shape-layer/index.js";
+import { useShapeSelection } from "./display-shape-layer/use-shape-selection.js";
+import { ShapeFeatureType } from "./shared/types.js";
 
-//#endregion
-export { clamp, log2 };
-//# sourceMappingURL=math-utils.js.map
+export { BASE_FILL_OPACITY, DASH_ARRAYS, DEFAULT_COLORS, DEFAULT_STYLE_PROPERTIES, DisplayShapeLayer, SHAPE_EVENTS, SHAPE_LAYER_IDS, STROKE_PATTERNS, STROKE_WIDTHS, ShapeEvents, ShapeFeatureType, useShapeSelection };

package/dist/deckgl/shapes/shared/constants.d.ts

@@ -0,0 +1,78 @@
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import { StyleProperties } from "./types.js";
+import { Color } from "@deck.gl/core";
+
+//#region src/deckgl/shapes/shared/constants.d.ts
+/**
+ * Layer IDs for shape layers
+ */
+declare const SHAPE_LAYER_IDS: {
+  readonly DISPLAY: "DISPLAY_SHAPES";
+  readonly DISPLAY_HIGHLIGHT: "DISPLAY_SHAPES::Highlight";
+  readonly DISPLAY_LABELS: "DISPLAY_SHAPES::Labels";
+};
+/**
+ * Base fill opacity multiplier (60%) for standard semi-transparent look
+ */
+declare const BASE_FILL_OPACITY = 0.2;
+/**
+ * Default stroke width in pixels when not specified in styleProperties
+ */
+declare const DEFAULT_STROKE_WIDTH = 2;
+/**
+ * Additional pixels added to stroke width on hover
+ */
+declare const HOVER_WIDTH_INCREASE = 2;
+/**
+ * Additional pixels added to stroke width for selection highlight
+ */
+declare const HIGHLIGHT_WIDTH_INCREASE = 5;
+/**
+ * Fixed opacity for label background (0-255)
+ */
+declare const LABEL_BACKGROUND_OPACITY = 200;
+/**
+ * Fixed opacity for label border (0-255)
+ */
+declare const LABEL_BORDER_OPACITY = 255;
+/**
+ * Default colors as RGBA arrays for DeckGL layers
+ */
+declare const DEFAULT_COLORS: {
+  /** Default fill color (background-surface-muted gray at full alpha) */
+  readonly fill: Color;
+  /** Default stroke color (outline-interactive-hover gray at full alpha) */
+  readonly stroke: Color;
+  /** Highlight/selection color (turquoise at ~39% alpha) */
+  readonly highlight: Color;
+};
+/**
+ * Default style properties for new shapes
+ */
+declare const DEFAULT_STYLE_PROPERTIES: StyleProperties;
+/**
+ * Stroke width options
+ */
+declare const STROKE_WIDTHS: readonly [1, 2, 4, 8];
+/**
+ * Stroke pattern options
+ */
+declare const STROKE_PATTERNS: readonly ["solid", "dashed", "dotted"];
+/**
+ * Dash array patterns for stroke rendering
+ */
+declare const DASH_ARRAYS: Record<'solid' | 'dashed' | 'dotted', [number, number] | null>;
+//#endregion
+export { BASE_FILL_OPACITY, DASH_ARRAYS, DEFAULT_COLORS, DEFAULT_STROKE_WIDTH, DEFAULT_STYLE_PROPERTIES, HIGHLIGHT_WIDTH_INCREASE, HOVER_WIDTH_INCREASE, LABEL_BACKGROUND_OPACITY, LABEL_BORDER_OPACITY, SHAPE_LAYER_IDS, STROKE_PATTERNS, STROKE_WIDTHS };
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1,109 @@
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+'use client';
+
+//#region src/deckgl/shapes/shared/constants.ts
+/**
+* Layer IDs for shape layers
+*/
+const SHAPE_LAYER_IDS = {
+	DISPLAY: "DISPLAY_SHAPES",
+	DISPLAY_HIGHLIGHT: "DISPLAY_SHAPES::Highlight",
+	DISPLAY_LABELS: "DISPLAY_SHAPES::Labels"
+};
+/**
+* Base fill opacity multiplier (60%) for standard semi-transparent look
+*/
+const BASE_FILL_OPACITY = .2;
+/**
+* Default stroke width in pixels when not specified in styleProperties
+*/
+const DEFAULT_STROKE_WIDTH = 2;
+/**
+* Additional pixels added to stroke width on hover
+*/
+const HOVER_WIDTH_INCREASE = 2;
+/**
+* Additional pixels added to stroke width for selection highlight
+*/
+const HIGHLIGHT_WIDTH_INCREASE = 5;
+/**
+* Fixed opacity for label background (0-255)
+*/
+const LABEL_BACKGROUND_OPACITY = 200;
+/**
+* Fixed opacity for label border (0-255)
+*/
+const LABEL_BORDER_OPACITY = 255;
+/**
+* Default colors as RGBA arrays for DeckGL layers
+*/
+const DEFAULT_COLORS = {
+	fill: [
+		255,
+		255,
+		255,
+		255
+	],
+	stroke: [
+		136,
+		138,
+		143,
+		255
+	],
+	highlight: [
+		40,
+		245,
+		190,
+		100
+	]
+};
+/**
+* Default style properties for new shapes
+*/
+const DEFAULT_STYLE_PROPERTIES = {
+	fillColor: DEFAULT_COLORS.fill,
+	strokeColor: DEFAULT_COLORS.stroke,
+	strokeWidth: 2,
+	strokePattern: "solid"
+};
+/**
+* Stroke width options
+*/
+const STROKE_WIDTHS = [
+	1,
+	2,
+	4,
+	8
+];
+/**
+* Stroke pattern options
+*/
+const STROKE_PATTERNS = [
+	"solid",
+	"dashed",
+	"dotted"
+];
+/**
+* Dash array patterns for stroke rendering
+*/
+const DASH_ARRAYS = {
+	solid: null,
+	dashed: [8, 4],
+	dotted: [2, 4]
+};
+
+//#endregion
+export { BASE_FILL_OPACITY, DASH_ARRAYS, DEFAULT_COLORS, DEFAULT_STROKE_WIDTH, DEFAULT_STYLE_PROPERTIES, HIGHLIGHT_WIDTH_INCREASE, HOVER_WIDTH_INCREASE, LABEL_BACKGROUND_OPACITY, LABEL_BORDER_OPACITY, SHAPE_LAYER_IDS, STROKE_PATTERNS, STROKE_WIDTHS };
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","names":["DEFAULT_STYLE_PROPERTIES: StyleProperties","DASH_ARRAYS: Record<\n  'solid' | 'dashed' | 'dotted',\n  [number, number] | null\n>"],"sources":["../../../../src/deckgl/shapes/shared/constants.ts"],"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'use client';\n\nimport type { Color } from '@deck.gl/core';\nimport type { StyleProperties } from './types';\n\n/**\n * Layer IDs for shape layers\n */\nexport const SHAPE_LAYER_IDS = {\n  DISPLAY: 'DISPLAY_SHAPES',\n  DISPLAY_HIGHLIGHT: 'DISPLAY_SHAPES::Highlight',\n  DISPLAY_LABELS: 'DISPLAY_SHAPES::Labels',\n} as const;\n\n/**\n * Base fill opacity multiplier (60%) for standard semi-transparent look\n */\nexport const BASE_FILL_OPACITY = 0.2;\n\n/**\n * Default stroke width in pixels when not specified in styleProperties\n */\nexport const DEFAULT_STROKE_WIDTH = 2;\n\n/**\n * Additional pixels added to stroke width on hover\n */\nexport const HOVER_WIDTH_INCREASE = 2;\n\n/**\n * Additional pixels added to stroke width for selection highlight\n */\nexport const HIGHLIGHT_WIDTH_INCREASE = 5;\n\n/**\n * Fixed opacity for label background (0-255)\n */\nexport const LABEL_BACKGROUND_OPACITY = 200;\n\n/**\n * Fixed opacity for label border (0-255)\n */\nexport const LABEL_BORDER_OPACITY = 255;\n\n/**\n * Default colors as RGBA arrays for DeckGL layers\n */\nexport const DEFAULT_COLORS = {\n  /** Default fill color (background-surface-muted gray at full alpha) */\n  fill: [255, 255, 255, 255] as Color,\n  /** Default stroke color (outline-interactive-hover gray at full alpha) */\n  stroke: [136, 138, 143, 255] as Color,\n  /** Highlight/selection color (turquoise at ~39% alpha) */\n  highlight: [40, 245, 190, 100] as Color,\n} as const;\n\n/**\n * Default style properties for new shapes\n */\nexport const DEFAULT_STYLE_PROPERTIES: StyleProperties = {\n  fillColor: DEFAULT_COLORS.fill,\n  strokeColor: DEFAULT_COLORS.stroke,\n  strokeWidth: 2,\n  strokePattern: 'solid',\n};\n\n/**\n * Stroke width options\n */\nexport const STROKE_WIDTHS = [1, 2, 4, 8] as const;\n\n/**\n * Stroke pattern options\n */\nexport const STROKE_PATTERNS = ['solid', 'dashed', 'dotted'] as const;\n\n/**\n * Dash array patterns for stroke rendering\n */\nexport const DASH_ARRAYS: Record<\n  'solid' | 'dashed' | 'dotted',\n  [number, number] | null\n> = {\n  solid: null,\n  dashed: [8, 4],\n  dotted: [2, 4],\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAoBA,MAAa,kBAAkB;CAC7B,SAAS;CACT,mBAAmB;CACnB,gBAAgB;CACjB;;;;AAKD,MAAa,oBAAoB;;;;AAKjC,MAAa,uBAAuB;;;;AAKpC,MAAa,uBAAuB;;;;AAKpC,MAAa,2BAA2B;;;;AAKxC,MAAa,2BAA2B;;;;AAKxC,MAAa,uBAAuB;;;;AAKpC,MAAa,iBAAiB;CAE5B,MAAM;EAAC;EAAK;EAAK;EAAK;EAAI;CAE1B,QAAQ;EAAC;EAAK;EAAK;EAAK;EAAI;CAE5B,WAAW;EAAC;EAAI;EAAK;EAAK;EAAI;CAC/B;;;;AAKD,MAAaA,2BAA4C;CACvD,WAAW,eAAe;CAC1B,aAAa,eAAe;CAC5B,aAAa;CACb,eAAe;CAChB;;;;AAKD,MAAa,gBAAgB;CAAC;CAAG;CAAG;CAAG;CAAE;;;;AAKzC,MAAa,kBAAkB;CAAC;CAAS;CAAU;CAAS;;;;AAK5D,MAAaC,cAGT;CACF,OAAO;CACP,QAAQ,CAAC,GAAG,EAAE;CACd,QAAQ,CAAC,GAAG,EAAE;CACf"}

package/dist/deckgl/shapes/shared/events.d.ts

@@ -0,0 +1,73 @@
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import { ShapeId } from "./types.js";
+import { Payload } from "@accelint/bus";
+import { UniqueId } from "@accelint/core";
+
+//#region src/deckgl/shapes/shared/events.d.ts
+/**
+ * Shape interaction events for DisplayShapeLayer
+ */
+declare const ShapeEvents: {
+  /** Shape selected */
+  readonly selected: "shapes:selected";
+  /** Selection cleared */
+  readonly deselected: "shapes:deselected";
+  /** Shape hovered (for cursor changes) */
+  readonly hovered: "shapes:hovered";
+};
+type ShapeEventType = (typeof ShapeEvents)[keyof typeof ShapeEvents];
+/**
+ * Event payload types (all payloads are serializable)
+ */
+type ShapeSelectedEvent = Payload<'shapes:selected', {
+  shapeId: ShapeId;
+  /** Map instance ID for multi-map event isolation */
+  mapId: UniqueId;
+}>;
+type ShapeDeselectedEvent = Payload<'shapes:deselected', {
+  /** Map instance ID for multi-map event isolation */
+  mapId: UniqueId;
+}>;
+type ShapeHoveredEvent = Payload<'shapes:hovered', {
+  /** Shape ID being hovered, or null when hover ends */
+  shapeId: ShapeId | null;
+  /** Map instance ID for multi-map event isolation */
+  mapId: UniqueId;
+}>;
+/**
+ * Union of all shape event types
+ */
+type ShapeEvent = ShapeSelectedEvent | ShapeDeselectedEvent | ShapeHoveredEvent;
+/**
+ * Aliases for backward compatibility
+ */
+declare const SHAPE_EVENTS: {
+  /** Shape selected */
+  readonly selected: "shapes:selected";
+  /** Selection cleared */
+  readonly deselected: "shapes:deselected";
+  /** Shape hovered (for cursor changes) */
+  readonly hovered: "shapes:hovered";
+};
+type ShapeEventPayload = ShapeEvent;
+type ShapeEventHandler<T extends ShapeEventType = ShapeEventType> = (event: Extract<ShapeEvent, {
+  type: T;
+}>) => void;
+/**
+ * Shape events namespace for bus integration
+ */
+declare const ShapeEventsNamespace = "shapes";
+//#endregion
+export { SHAPE_EVENTS, ShapeDeselectedEvent, ShapeEvent, ShapeEventHandler, ShapeEventPayload, ShapeEventType, ShapeEvents, ShapeEventsNamespace, ShapeHoveredEvent, ShapeSelectedEvent };
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1,58 @@
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+'use client';
+
+//#region src/deckgl/shapes/shared/events.ts
+/**
+* Shape interaction events for DisplayShapeLayer
+*/
+const ShapeEvents = {
+	selected: "shapes:selected",
+	deselected: "shapes:deselected",
+	hovered: "shapes:hovered"
+};
+/**
+* Aliases for backward compatibility
+*/
+const SHAPE_EVENTS = ShapeEvents;
+/**
+* Shape events namespace for bus integration
+*/
+const ShapeEventsNamespace = "shapes";
+/**
+* Note: These utility functions are deprecated in favor of direct bus usage.
+* Use `useEmit` and `useOn` from '@accelint/bus/react' in React components instead.
+*
+* @example
+* ```tsx
+* import { useEmit, useOn } from '@accelint/bus/react';
+* import { ShapeEvents } from '@accelint/map-toolkit/deckgl/shapes';
+*
+* function MyComponent() {
+*   const emit = useEmit();
+*
+*   // Emit shape selected event
+*   emit(ShapeEvents.selected, { shapeId: 'some-id' });
+*
+*   // Listen to shape events
+*   useOn(ShapeEvents.selected, (event) => {
+*     console.log('Shape selected:', event.data.shapeId);
+*   });
+* }
+* ```
+*/
+
+//#endregion
+export { SHAPE_EVENTS, ShapeEvents, ShapeEventsNamespace };
+//# sourceMappingURL=events.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","names":[],"sources":["../../../../src/deckgl/shapes/shared/events.ts"],"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'use client';\n\nimport type { Payload } from '@accelint/bus';\nimport type { UniqueId } from '@accelint/core';\nimport type { ShapeId } from './types';\n\n/**\n * Shape interaction events for DisplayShapeLayer\n */\nexport const ShapeEvents = {\n  /** Shape selected */\n  selected: 'shapes:selected',\n  /** Selection cleared */\n  deselected: 'shapes:deselected',\n  /** Shape hovered (for cursor changes) */\n  hovered: 'shapes:hovered',\n} as const;\n\nexport type ShapeEventType = (typeof ShapeEvents)[keyof typeof ShapeEvents];\n\n/**\n * Event payload types (all payloads are serializable)\n */\n\nexport type ShapeSelectedEvent = Payload<\n  'shapes:selected',\n  {\n    shapeId: ShapeId;\n    /** Map instance ID for multi-map event isolation */\n    mapId: UniqueId;\n  }\n>;\n\nexport type ShapeDeselectedEvent = Payload<\n  'shapes:deselected',\n  {\n    /** Map instance ID for multi-map event isolation */\n    mapId: UniqueId;\n  }\n>;\n\nexport type ShapeHoveredEvent = Payload<\n  'shapes:hovered',\n  {\n    /** Shape ID being hovered, or null when hover ends */\n    shapeId: ShapeId | null;\n    /** Map instance ID for multi-map event isolation */\n    mapId: UniqueId;\n  }\n>;\n\n/**\n * Union of all shape event types\n */\nexport type ShapeEvent =\n  | ShapeSelectedEvent\n  | ShapeDeselectedEvent\n  | ShapeHoveredEvent;\n\n/**\n * Aliases for backward compatibility\n */\nexport const SHAPE_EVENTS = ShapeEvents;\nexport type ShapeEventPayload = ShapeEvent;\nexport type ShapeEventHandler<T extends ShapeEventType = ShapeEventType> = (\n  event: Extract<ShapeEvent, { type: T }>,\n) => void;\n\n/**\n * Shape events namespace for bus integration\n */\nexport const ShapeEventsNamespace = 'shapes';\n\n/**\n * Note: These utility functions are deprecated in favor of direct bus usage.\n * Use `useEmit` and `useOn` from '@accelint/bus/react' in React components instead.\n *\n * @example\n * ```tsx\n * import { useEmit, useOn } from '@accelint/bus/react';\n * import { ShapeEvents } from '@accelint/map-toolkit/deckgl/shapes';\n *\n * function MyComponent() {\n *   const emit = useEmit();\n *\n *   // Emit shape selected event\n *   emit(ShapeEvents.selected, { shapeId: 'some-id' });\n *\n *   // Listen to shape events\n *   useOn(ShapeEvents.selected, (event) => {\n *     console.log('Shape selected:', event.data.shapeId);\n *   });\n * }\n * ```\n */\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAqBA,MAAa,cAAc;CAEzB,UAAU;CAEV,YAAY;CAEZ,SAAS;CACV;;;;AA8CD,MAAa,eAAe;;;;AAS5B,MAAa,uBAAuB"}

package/dist/deckgl/shapes/shared/types.d.ts

@@ -0,0 +1,158 @@
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import { UniqueId } from "@accelint/core";
+import { Color } from "@deck.gl/core";
+import { Feature, LineString, Point, Polygon } from "geojson";
+
+//#region src/deckgl/shapes/shared/types.d.ts
+/**
+ * Supported shape types
+ */
+declare const ShapeFeatureType: {
+  readonly Circle: "Circle";
+  readonly Polygon: "Polygon";
+  readonly LineString: "LineString";
+  readonly Point: "Point";
+};
+type ShapeFeatureType = (typeof ShapeFeatureType)[keyof typeof ShapeFeatureType];
+/**
+ * Shape ID type - uses UniqueId from core
+ */
+type ShapeId = UniqueId;
+/**
+ * Stroke width options (in pixels)
+ */
+type StrokeWidth = 1 | 2 | 4 | 8;
+/**
+ * Stroke pattern options
+ */
+type StrokePattern = 'solid' | 'dashed' | 'dotted';
+/**
+ * Style properties for rendering shapes
+ */
+interface StyleProperties {
+  /** Fill color as RGBA array [r, g, b, a] where each value is 0-255 */
+  fillColor: Color;
+  /** Stroke color as RGBA array [r, g, b, a] where each value is 0-255 */
+  strokeColor: Color;
+  /** Stroke width in pixels */
+  strokeWidth: StrokeWidth;
+  /** Stroke pattern */
+  strokePattern: StrokePattern;
+  /** Optional icon properties for Point geometries */
+  icon?: {
+    /** Icon atlas URL or data */
+    atlas?: string;
+    /** Icon mapping (name to position in atlas) */
+    mapping?: Record<string, {
+      x: number;
+      y: number;
+      width: number;
+      height: number;
+      mask?: boolean;
+    }>;
+    /** Icon name to use from mapping */
+    name?: string;
+    /** Icon size in pixels */
+    size?: number;
+  };
+  /** Optional custom label pixel offset [x, y] */
+  labelOffset?: [number, number];
+  /** Optional custom label vertical anchor */
+  labelVerticalAnchor?: 'top' | 'middle' | 'bottom';
+  /** Optional custom label horizontal anchor */
+  labelHorizontalAnchor?: 'left' | 'center' | 'right';
+  /** Optional custom label coordinate anchor (position along geometry) */
+  labelCoordinateAnchor?: 'center' | 'start' | 'middle' | 'end' | 'top' | 'right' | 'bottom' | 'left';
+}
+/**
+ * Circle-specific properties for precise rendering
+ * Stored alongside the polygon approximation
+ */
+interface CircleProperties {
+  /** Center point as [longitude, latitude] */
+  center: [number, number];
+  /** Radius with value and units */
+  radius: {
+    /** Radius value */
+    value: number;
+    /** Units (hardcoded to kilometers for v1) */
+    units: 'kilometers';
+  };
+}
+/**
+ * Custom geometry types supported
+ */
+type CustomGeometry = Point | LineString | Polygon;
+/**
+ * GeoJSON Feature with style properties
+ */
+interface StyledFeature extends Feature {
+  properties: {
+    /** Style properties for rendering */
+    styleProperties: StyleProperties;
+    /** Circle properties (only for Circle type shapes) */
+    circleProperties?: CircleProperties;
+    /** Shape ID for correlation */
+    shapeId?: ShapeId;
+  };
+}
+/**
+ * Shape data structure for DisplayShapeLayer
+ */
+interface DisplayShape {
+  /** Unique identifier */
+  id: ShapeId;
+  /** Full shape name used internally and in UI */
+  name: string;
+  /**
+   * Optional short display label shown on the map
+   * If not provided, the `name` property will be used instead
+   * Useful for showing abbreviated text on the map (e.g., "NYC" vs "New York City Office")
+   */
+  label?: string;
+  /** Shape type */
+  shapeType: ShapeFeatureTypeValues;
+  /** GeoJSON feature with geometry and style properties */
+  feature: ShapeFeature;
+  /** UTC timestamp (only set when saved) */
+  lastUpdated?: number;
+}
+/**
+ * Alias for backward compatibility
+ * @deprecated Use DisplayShape instead
+ */
+type EditableShape = DisplayShape;
+/**
+ * Alias for ShapeFeatureType values
+ */
+type ShapeFeatureTypeValues = ShapeFeatureType;
+/**
+ * Alias for StyledFeature (shape feature)
+ */
+type ShapeFeature = StyledFeature;
+/**
+ * Alias for StyledFeature properties
+ */
+type ShapeFeatureProperties = StyledFeature['properties'];
+/**
+ * Circle radius type
+ */
+type CircleRadius = CircleProperties['radius'];
+/**
+ * Coordinate as [longitude, latitude]
+ */
+type Coordinate = [number, number];
+//#endregion
+export { CircleProperties, CircleRadius, Coordinate, CustomGeometry, DisplayShape, EditableShape, ShapeFeature, ShapeFeatureProperties, ShapeFeatureType, ShapeFeatureTypeValues, ShapeId, StrokePattern, StrokeWidth, StyleProperties, StyledFeature };
+//# sourceMappingURL=types.d.ts.map

package/dist/{node_modules/.pnpm/@math.gl_web-mercator@4.1.0/node_modules/@math.gl/web-mercator/dist/get-bounds.js → deckgl/shapes/shared/types.js}

@@ -11,10 +11,19 @@
  */
 
 
-import "./web-mercator-utils.js";
+'use client';
 
-//#region ../../node_modules/.pnpm/@math.gl+web-mercator@4.1.0/node_modules/@math.gl/web-mercator/dist/get-bounds.js
-const DEGREES_TO_RADIANS = Math.PI / 180;
+//#region src/deckgl/shapes/shared/types.ts
+/**
+* Supported shape types
+*/
+const ShapeFeatureType = {
+	Circle: "Circle",
+	Polygon: "Polygon",
+	LineString: "LineString",
+	Point: "Point"
+};
 
 //#endregion
-//# sourceMappingURL=get-bounds.js.map
+export { ShapeFeatureType };
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../../../src/deckgl/shapes/shared/types.ts"],"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'use client';\n\nimport type { UniqueId } from '@accelint/core';\nimport type { Color } from '@deck.gl/core';\nimport type { Feature, LineString, Point, Polygon } from 'geojson';\n\n/**\n * Supported shape types\n */\nexport const ShapeFeatureType = {\n  Circle: 'Circle',\n  Polygon: 'Polygon',\n  LineString: 'LineString',\n  Point: 'Point',\n} as const;\n\nexport type ShapeFeatureType =\n  (typeof ShapeFeatureType)[keyof typeof ShapeFeatureType];\n\n/**\n * Shape ID type - uses UniqueId from core\n */\nexport type ShapeId = UniqueId;\n\n/**\n * Stroke width options (in pixels)\n */\nexport type StrokeWidth = 1 | 2 | 4 | 8;\n\n/**\n * Stroke pattern options\n */\nexport type StrokePattern = 'solid' | 'dashed' | 'dotted';\n\n/**\n * Style properties for rendering shapes\n */\nexport interface StyleProperties {\n  /** Fill color as RGBA array [r, g, b, a] where each value is 0-255 */\n  fillColor: Color;\n  /** Stroke color as RGBA array [r, g, b, a] where each value is 0-255 */\n  strokeColor: Color;\n  /** Stroke width in pixels */\n  strokeWidth: StrokeWidth;\n  /** Stroke pattern */\n  strokePattern: StrokePattern;\n  /** Optional icon properties for Point geometries */\n  icon?: {\n    /** Icon atlas URL or data */\n    atlas?: string;\n    /** Icon mapping (name to position in atlas) */\n    mapping?: Record<\n      string,\n      { x: number; y: number; width: number; height: number; mask?: boolean }\n    >;\n    /** Icon name to use from mapping */\n    name?: string;\n    /** Icon size in pixels */\n    size?: number;\n  };\n  /** Optional custom label pixel offset [x, y] */\n  labelOffset?: [number, number];\n  /** Optional custom label vertical anchor */\n  labelVerticalAnchor?: 'top' | 'middle' | 'bottom';\n  /** Optional custom label horizontal anchor */\n  labelHorizontalAnchor?: 'left' | 'center' | 'right';\n  /** Optional custom label coordinate anchor (position along geometry) */\n  labelCoordinateAnchor?:\n    | 'center'\n    | 'start'\n    | 'middle'\n    | 'end'\n    | 'top'\n    | 'right'\n    | 'bottom'\n    | 'left';\n}\n\n/**\n * Circle-specific properties for precise rendering\n * Stored alongside the polygon approximation\n */\nexport interface CircleProperties {\n  /** Center point as [longitude, latitude] */\n  center: [number, number];\n  /** Radius with value and units */\n  radius: {\n    /** Radius value */\n    value: number;\n    /** Units (hardcoded to kilometers for v1) */\n    units: 'kilometers';\n  };\n}\n\n/**\n * Custom geometry types supported\n */\nexport type CustomGeometry = Point | LineString | Polygon;\n\n/**\n * GeoJSON Feature with style properties\n */\nexport interface StyledFeature extends Feature {\n  properties: {\n    /** Style properties for rendering */\n    styleProperties: StyleProperties;\n    /** Circle properties (only for Circle type shapes) */\n    circleProperties?: CircleProperties;\n    /** Shape ID for correlation */\n    shapeId?: ShapeId;\n  };\n}\n\n/**\n * Shape data structure for DisplayShapeLayer\n */\nexport interface DisplayShape {\n  /** Unique identifier */\n  id: ShapeId;\n  /** Full shape name used internally and in UI */\n  name: string;\n  /**\n   * Optional short display label shown on the map\n   * If not provided, the `name` property will be used instead\n   * Useful for showing abbreviated text on the map (e.g., \"NYC\" vs \"New York City Office\")\n   */\n  label?: string;\n  /** Shape type */\n  shapeType: ShapeFeatureTypeValues;\n  /** GeoJSON feature with geometry and style properties */\n  feature: ShapeFeature;\n  /** UTC timestamp (only set when saved) */\n  lastUpdated?: number;\n}\n\n/**\n * Alias for backward compatibility\n * @deprecated Use DisplayShape instead\n */\nexport type EditableShape = DisplayShape;\n\n/**\n * Alias for ShapeFeatureType values\n */\nexport type ShapeFeatureTypeValues = ShapeFeatureType;\n\n/**\n * Alias for StyledFeature (shape feature)\n */\nexport type ShapeFeature = StyledFeature;\n\n/**\n * Alias for StyledFeature properties\n */\nexport type ShapeFeatureProperties = StyledFeature['properties'];\n\n/**\n * Circle radius type\n */\nexport type CircleRadius = CircleProperties['radius'];\n\n/**\n * Coordinate as [longitude, latitude]\n */\nexport type Coordinate = [number, number];\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAqBA,MAAa,mBAAmB;CAC9B,QAAQ;CACR,SAAS;CACT,YAAY;CACZ,OAAO;CACR"}

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

@@ -10,9 +10,9 @@
  * governing permissions and limitations under the License.
  */
 
+import { AccessorContext, AccessorFunction, DefaultProps } from "@deck.gl/core";
 import { IconLayer, IconLayerProps } from "@deck.gl/layers";
 import { SymbolOptions } from "milsymbol";
-import { AccessorContext, AccessorFunction, DefaultProps } from "@deck.gl/core";
 
 //#region src/deckgl/symbol-layer/index.d.ts
 type _SymbolLayerProps<TData = unknown> = {

package/dist/viewport/viewport-size.d.ts

@@ -13,7 +13,7 @@
 import { SupportedDistanceUnit } from "./types.js";
 import { ComponentPropsWithRef } from "react";
 import { UniqueId } from "@accelint/core";
-import * as react_jsx_runtime0 from "react/jsx-runtime";
+import * as react_jsx_runtime1 from "react/jsx-runtime";
 
 //#region src/viewport/viewport-size.d.ts
 type ViewportSizeProps = ComponentPropsWithRef<'span'> & {
@@ -48,7 +48,7 @@ declare function ViewportSize({
   instanceId,
   unit,
   ...rest
-}: ViewportSizeProps): react_jsx_runtime0.JSX.Element;
+}: ViewportSizeProps): react_jsx_runtime1.JSX.Element;
 //#endregion
 export { ViewportSize, ViewportSizeProps };
 //# sourceMappingURL=viewport-size.d.ts.map