@accelint/map-toolkit 0.5.0 → 1.0.0

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

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

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

@@ -0,0 +1,54 @@
+/*
+ * 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;
+//#endregion
+export { ShapeDeselectedEvent, ShapeEvent, ShapeEventType, ShapeEvents, ShapeHoveredEvent, ShapeSelectedEvent };
+//# sourceMappingURL=events.d.ts.map

package/dist/{packages/hotkey-manager/dist/lib/is-mac/index.js → deckgl/shapes/shared/events.js}

@@ -11,14 +11,18 @@
  */
 
 
-import { isClient } from "../is-client/index.js";
+'use client';
 
-//#region ../hotkey-manager/dist/lib/is-mac/index.js
+//#region src/deckgl/shapes/shared/events.ts
 /**
-* Is `true` when client-side and on a Mac
+* Shape interaction events for DisplayShapeLayer
 */
-const isMac = isClient && window.navigator.userAgent.indexOf("Mac") !== -1;
+const ShapeEvents = {
+	selected: "shapes:selected",
+	deselected: "shapes:deselected",
+	hovered: "shapes:hovered"
+};
 
 //#endregion
-export { isMac };
-//# sourceMappingURL=index.js.map
+export { ShapeEvents };
+//# 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"],"mappings":";;;;;;;;;;;;;;;;;;;AAqBA,MAAa,cAAc;CAEzB,UAAU;CAEV,YAAY;CAEZ,SAAS;CACV"}

package/dist/deckgl/shapes/shared/hooks/use-shift-zoom-disable.js

@@ -0,0 +1,84 @@
+/*
+ * 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';
+
+import { MapEvents } from "../../../base-map/events.js";
+import { useEffect, useRef } from "react";
+import { useEmit } from "@accelint/bus/react";
+
+//#region src/deckgl/shapes/shared/hooks/use-shift-zoom-disable.ts
+/**
+* Hook to disable map zoom while Shift key is held during shape operations.
+*
+* This prevents MapLibre's boxZoom (Shift+drag) from interfering with
+* Shift modifier constraints like:
+* - Shift for uniform scaling during edit
+* - Shift for rotation snap during edit
+* - Shift for square constraint during rectangle drawing
+*
+* @param mapId - The map instance ID
+* @param isActive - Whether the hook should be active (e.g., when editing/drawing)
+*/
+function useShiftZoomDisable(mapId, isActive) {
+	const emitDisableZoom = useEmit(MapEvents.disableZoom);
+	const emitEnableZoom = useEmit(MapEvents.enableZoom);
+	const isZoomDisabledRef = useRef(false);
+	useEffect(() => {
+		if (!isActive) return;
+		const disableZoom = () => {
+			if (!isZoomDisabledRef.current) {
+				isZoomDisabledRef.current = true;
+				emitDisableZoom({ id: mapId });
+			}
+		};
+		const enableZoom = () => {
+			if (isZoomDisabledRef.current) {
+				isZoomDisabledRef.current = false;
+				emitEnableZoom({ id: mapId });
+			}
+		};
+		const handleKeyDown = (event) => {
+			if (event.key === "Shift") disableZoom();
+		};
+		const handleKeyUp = (event) => {
+			if (event.key === "Shift") enableZoom();
+		};
+		const handleMouseDown = (event) => {
+			if (event.shiftKey) disableZoom();
+		};
+		const handleBlur = () => {
+			enableZoom();
+		};
+		document.addEventListener("keydown", handleKeyDown);
+		document.addEventListener("keyup", handleKeyUp);
+		document.addEventListener("mousedown", handleMouseDown, { capture: true });
+		window.addEventListener("blur", handleBlur);
+		return () => {
+			document.removeEventListener("keydown", handleKeyDown);
+			document.removeEventListener("keyup", handleKeyUp);
+			document.removeEventListener("mousedown", handleMouseDown, { capture: true });
+			window.removeEventListener("blur", handleBlur);
+			enableZoom();
+		};
+	}, [
+		isActive,
+		mapId,
+		emitDisableZoom,
+		emitEnableZoom
+	]);
+}
+
+//#endregion
+export { useShiftZoomDisable };
+//# sourceMappingURL=use-shift-zoom-disable.js.map

package/dist/deckgl/shapes/shared/hooks/use-shift-zoom-disable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-shift-zoom-disable.js","names":[],"sources":["../../../../../src/deckgl/shapes/shared/hooks/use-shift-zoom-disable.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 { useEmit } from '@accelint/bus/react';\nimport { useEffect, useRef } from 'react';\nimport { MapEvents } from '@/deckgl/base-map/events';\nimport type { UniqueId } from '@accelint/core';\nimport type {\n  MapDisableZoomEvent,\n  MapEnableZoomEvent,\n} from '@/deckgl/base-map/types';\n\n/**\n * Hook to disable map zoom while Shift key is held during shape operations.\n *\n * This prevents MapLibre's boxZoom (Shift+drag) from interfering with\n * Shift modifier constraints like:\n * - Shift for uniform scaling during edit\n * - Shift for rotation snap during edit\n * - Shift for square constraint during rectangle drawing\n *\n * @param mapId - The map instance ID\n * @param isActive - Whether the hook should be active (e.g., when editing/drawing)\n */\nexport function useShiftZoomDisable(mapId: UniqueId, isActive: boolean): void {\n  const emitDisableZoom = useEmit<MapDisableZoomEvent>(MapEvents.disableZoom);\n  const emitEnableZoom = useEmit<MapEnableZoomEvent>(MapEvents.enableZoom);\n  const isZoomDisabledRef = useRef(false);\n\n  useEffect(() => {\n    if (!isActive) {\n      return;\n    }\n\n    const disableZoom = () => {\n      if (!isZoomDisabledRef.current) {\n        isZoomDisabledRef.current = true;\n        emitDisableZoom({ id: mapId });\n      }\n    };\n\n    const enableZoom = () => {\n      if (isZoomDisabledRef.current) {\n        isZoomDisabledRef.current = false;\n        emitEnableZoom({ id: mapId });\n      }\n    };\n\n    const handleKeyDown = (event: KeyboardEvent) => {\n      if (event.key === 'Shift') {\n        disableZoom();\n      }\n    };\n\n    const handleKeyUp = (event: KeyboardEvent) => {\n      if (event.key === 'Shift') {\n        enableZoom();\n      }\n    };\n\n    // Also catch Shift state on mousedown to handle edge cases where\n    // keydown might have been missed (e.g., focus issues)\n    const handleMouseDown = (event: MouseEvent) => {\n      if (event.shiftKey) {\n        disableZoom();\n      }\n    };\n\n    // Re-enable zoom if the window loses focus while Shift is held\n    const handleBlur = () => {\n      enableZoom();\n    };\n\n    document.addEventListener('keydown', handleKeyDown);\n    document.addEventListener('keyup', handleKeyUp);\n    document.addEventListener('mousedown', handleMouseDown, { capture: true });\n    window.addEventListener('blur', handleBlur);\n\n    return () => {\n      document.removeEventListener('keydown', handleKeyDown);\n      document.removeEventListener('keyup', handleKeyUp);\n      document.removeEventListener('mousedown', handleMouseDown, {\n        capture: true,\n      });\n      window.removeEventListener('blur', handleBlur);\n\n      // Ensure zoom is re-enabled when unmounting\n      enableZoom();\n    };\n  }, [isActive, mapId, emitDisableZoom, emitEnableZoom]);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCA,SAAgB,oBAAoB,OAAiB,UAAyB;CAC5E,MAAM,kBAAkB,QAA6B,UAAU,YAAY;CAC3E,MAAM,iBAAiB,QAA4B,UAAU,WAAW;CACxE,MAAM,oBAAoB,OAAO,MAAM;AAEvC,iBAAgB;AACd,MAAI,CAAC,SACH;EAGF,MAAM,oBAAoB;AACxB,OAAI,CAAC,kBAAkB,SAAS;AAC9B,sBAAkB,UAAU;AAC5B,oBAAgB,EAAE,IAAI,OAAO,CAAC;;;EAIlC,MAAM,mBAAmB;AACvB,OAAI,kBAAkB,SAAS;AAC7B,sBAAkB,UAAU;AAC5B,mBAAe,EAAE,IAAI,OAAO,CAAC;;;EAIjC,MAAM,iBAAiB,UAAyB;AAC9C,OAAI,MAAM,QAAQ,QAChB,cAAa;;EAIjB,MAAM,eAAe,UAAyB;AAC5C,OAAI,MAAM,QAAQ,QAChB,aAAY;;EAMhB,MAAM,mBAAmB,UAAsB;AAC7C,OAAI,MAAM,SACR,cAAa;;EAKjB,MAAM,mBAAmB;AACvB,eAAY;;AAGd,WAAS,iBAAiB,WAAW,cAAc;AACnD,WAAS,iBAAiB,SAAS,YAAY;AAC/C,WAAS,iBAAiB,aAAa,iBAAiB,EAAE,SAAS,MAAM,CAAC;AAC1E,SAAO,iBAAiB,QAAQ,WAAW;AAE3C,eAAa;AACX,YAAS,oBAAoB,WAAW,cAAc;AACtD,YAAS,oBAAoB,SAAS,YAAY;AAClD,YAAS,oBAAoB,aAAa,iBAAiB,EACzD,SAAS,MACV,CAAC;AACF,UAAO,oBAAoB,QAAQ,WAAW;AAG9C,eAAY;;IAEb;EAAC;EAAU;EAAO;EAAiB;EAAe,CAAC"}