@accelint/map-toolkit 0.6.0 → 1.1.0

package/dist/deckgl/text-settings.js

@@ -0,0 +1,83 @@
+/*
+ * 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.
+ */
+
+
+//#region src/deckgl/text-settings.ts
+/**
+* Shared font settings for SDF (Signed Distance Field) text rendering.
+*
+* These settings are optimized for cross-platform legibility, particularly
+* on Windows machines where text can appear thin/hard to read without
+* proper SDF configuration.
+*
+* Used by:
+* - TextLayer component
+* - Shape label layers
+* - Draw/edit mode tooltips
+*/
+const SDF_FONT_SETTINGS = {
+	fontSize: 22,
+	sdf: true,
+	buffer: 10,
+	cutoff: .19,
+	radius: 10,
+	smoothing: .1
+};
+/**
+* Default text size in pixels for deck.gl TextLayer.
+* Works in conjunction with SDF_FONT_SETTINGS for proper rendering.
+*/
+const DEFAULT_TEXT_SIZE = 12;
+/**
+* Default text color (white) for deck.gl TextLayer.
+*/
+const DEFAULT_TEXT_COLOR = [
+	255,
+	255,
+	255,
+	255
+];
+/**
+* Default text outline color (black) for deck.gl TextLayer.
+*/
+const DEFAULT_TEXT_OUTLINE_COLOR = [
+	0,
+	0,
+	0,
+	255
+];
+/**
+* Default text outline width in pixels for deck.gl TextLayer.
+*/
+const DEFAULT_TEXT_OUTLINE_WIDTH = 2;
+/**
+* Default font weight for deck.gl TextLayer.
+*/
+const DEFAULT_FONT_WEIGHT = 500;
+/**
+* Combined default text style settings for deck.gl TextLayer.
+* Spread this object into TextLayer props for consistent cross-platform rendering.
+*
+* Includes: fontSettings, fontWeight, getSize, getColor, outlineWidth, outlineColor
+*/
+const DEFAULT_TEXT_STYLE = {
+	fontSettings: { ...SDF_FONT_SETTINGS },
+	fontWeight: DEFAULT_FONT_WEIGHT,
+	getSize: DEFAULT_TEXT_SIZE,
+	getColor: DEFAULT_TEXT_COLOR,
+	outlineWidth: DEFAULT_TEXT_OUTLINE_WIDTH,
+	outlineColor: DEFAULT_TEXT_OUTLINE_COLOR
+};
+
+//#endregion
+export { DEFAULT_FONT_WEIGHT, DEFAULT_TEXT_COLOR, DEFAULT_TEXT_OUTLINE_COLOR, DEFAULT_TEXT_OUTLINE_WIDTH, DEFAULT_TEXT_SIZE, DEFAULT_TEXT_STYLE, SDF_FONT_SETTINGS };
+//# sourceMappingURL=text-settings.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text-settings.js","names":["SDF_FONT_SETTINGS: NonNullable<TextLayerProps['fontSettings']>","DEFAULT_TEXT_COLOR: Color","DEFAULT_TEXT_OUTLINE_COLOR: Color"],"sources":["../../src/deckgl/text-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 type { Color } from '@deck.gl/core';\nimport type { TextLayerProps } from '@deck.gl/layers';\n\n/**\n * Shared font settings for SDF (Signed Distance Field) text rendering.\n *\n * These settings are optimized for cross-platform legibility, particularly\n * on Windows machines where text can appear thin/hard to read without\n * proper SDF configuration.\n *\n * Used by:\n * - TextLayer component\n * - Shape label layers\n * - Draw/edit mode tooltips\n */\nexport const SDF_FONT_SETTINGS: NonNullable<TextLayerProps['fontSettings']> = {\n  fontSize: 22,\n  sdf: true,\n  buffer: 10,\n  cutoff: 0.19,\n  radius: 10,\n  smoothing: 0.1,\n};\n\n/**\n * Default text size in pixels for deck.gl TextLayer.\n * Works in conjunction with SDF_FONT_SETTINGS for proper rendering.\n */\nexport const DEFAULT_TEXT_SIZE = 12;\n\n/**\n * Default text color (white) for deck.gl TextLayer.\n */\nexport const DEFAULT_TEXT_COLOR: Color = [255, 255, 255, 255];\n\n/**\n * Default text outline color (black) for deck.gl TextLayer.\n */\nexport const DEFAULT_TEXT_OUTLINE_COLOR: Color = [0, 0, 0, 255];\n\n/**\n * Default text outline width in pixels for deck.gl TextLayer.\n */\nexport const DEFAULT_TEXT_OUTLINE_WIDTH = 2;\n\n/**\n * Default font weight for deck.gl TextLayer.\n */\nexport const DEFAULT_FONT_WEIGHT = 500;\n\n/**\n * Combined default text style settings for deck.gl TextLayer.\n * Spread this object into TextLayer props for consistent cross-platform rendering.\n *\n * Includes: fontSettings, fontWeight, getSize, getColor, outlineWidth, outlineColor\n */\nexport const DEFAULT_TEXT_STYLE = {\n  fontSettings: { ...SDF_FONT_SETTINGS },\n  fontWeight: DEFAULT_FONT_WEIGHT,\n  getSize: DEFAULT_TEXT_SIZE,\n  getColor: DEFAULT_TEXT_COLOR,\n  outlineWidth: DEFAULT_TEXT_OUTLINE_WIDTH,\n  outlineColor: DEFAULT_TEXT_OUTLINE_COLOR,\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,MAAaA,oBAAiE;CAC5E,UAAU;CACV,KAAK;CACL,QAAQ;CACR,QAAQ;CACR,QAAQ;CACR,WAAW;CACZ;;;;;AAMD,MAAa,oBAAoB;;;;AAKjC,MAAaC,qBAA4B;CAAC;CAAK;CAAK;CAAK;CAAI;;;;AAK7D,MAAaC,6BAAoC;CAAC;CAAG;CAAG;CAAG;CAAI;;;;AAK/D,MAAa,6BAA6B;;;;AAK1C,MAAa,sBAAsB;;;;;;;AAQnC,MAAa,qBAAqB;CAChC,cAAc,EAAE,GAAG,mBAAmB;CACtC,YAAY;CACZ,SAAS;CACT,UAAU;CACV,cAAc;CACd,cAAc;CACf"}

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

@@ -1 +1 @@
-{"version":3,"file":"events.js","names":[],"sources":["../../src/map-cursor/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/**\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 */\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"}

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

@@ -12,6 +12,6 @@
 
 import { MapCursorEvents } from "./events.js";
 import { CSSCursorType, CursorChangeRequestEvent, CursorChangedEvent, CursorRejectedEvent, MapCursorEventType } from "./types.js";
-import { destroyStore, getOrCreateStore } from "./store.js";
+import { clearCursorState, cursorStore, getCursor } from "./store.js";
 import { UseMapCursorReturn, useMapCursor, useMapCursorEffect } from "./use-map-cursor.js";
-export { type CSSCursorType, type CursorChangeRequestEvent, type CursorChangedEvent, type CursorRejectedEvent, type MapCursorEventType, MapCursorEvents, type UseMapCursorReturn, destroyStore, getOrCreateStore, useMapCursor, useMapCursorEffect };
+export { type CSSCursorType, type CursorChangeRequestEvent, type CursorChangedEvent, type CursorRejectedEvent, type MapCursorEventType, MapCursorEvents, type UseMapCursorReturn, clearCursorState, cursorStore, getCursor, useMapCursor, useMapCursorEffect };

package/dist/map-cursor/index.js

@@ -12,7 +12,7 @@
 
 
 import { MapCursorEvents } from "./events.js";
-import { destroyStore, getOrCreateStore } from "./store.js";
+import { clearCursorState, cursorStore, getCursor } from "./store.js";
 import { useMapCursor, useMapCursorEffect } from "./use-map-cursor.js";
 
-export { MapCursorEvents, destroyStore, getOrCreateStore, useMapCursor, useMapCursorEffect };
+export { MapCursorEvents, clearCursorState, cursorStore, getCursor, useMapCursor, useMapCursorEffect };

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

@@ -10,84 +10,55 @@
  * governing permissions and limitations under the License.
  */
 
+import { MapStore } from "../shared/create-map-store.js";
 import { CSSCursorType } from "./types.js";
 import { UniqueId } from "@accelint/core";
 
 //#region src/map-cursor/store.d.ts
 /**
- * Creates or retrieves a cached subscription function for a given instanceId.
- * Uses a fan-out pattern: 1 bus listener -> N React subscribers.
- * Automatically cleans up cursor state when the last subscriber unsubscribes.
- *
- * @param instanceId - The unique identifier for the map cursor instance
- * @returns A subscription function for useSyncExternalStore
+ * State shape for map cursor
  */
-declare function getOrCreateSubscription(instanceId: UniqueId): (onStoreChange: () => void) => () => void;
+type CursorState = {
+  /** Map of owner -> cursor */
+  cursorOwners: Map<string, CSSCursorType>;
+  /** Current active cursor (for priority tracking) */
+  currentCursor: CSSCursorType | null;
+  /** Current cursor owner (for priority tracking) */
+  currentOwner: string | null;
+};
 /**
- * Creates or retrieves a cached snapshot function for a given instanceId.
- * The cursor returned gets equality checked, so it needs to be stable or React re-renders unnecessarily.
- *
- * @param instanceId - The unique identifier for the map cursor instance
- * @returns A snapshot function for useSyncExternalStore
+ * Actions for cursor management
  */
-declare function getOrCreateSnapshot(instanceId: UniqueId): () => CSSCursorType;
+type CursorActions = {
+  /** Request a cursor change */
+  requestCursorChange: (cursor: CSSCursorType, owner: string) => void;
+  /** Clear cursor for an owner */
+  clearCursor: (owner: string) => void;
+};
 /**
- * Creates or retrieves a cached server snapshot function for a given instanceId.
- * Server snapshots always return the default cursor since cursor state is client-only.
- * Required for SSR/RSC compatibility with useSyncExternalStore.
- *
- * @param instanceId - The unique identifier for the map cursor instance
- * @returns A server snapshot function for useSyncExternalStore
+ * Cursor store
  */
-declare function getOrCreateServerSnapshot(instanceId: UniqueId): () => CSSCursorType;
+declare const cursorStore: MapStore<CursorState, CursorActions>;
 /**
- * Creates or retrieves a cached requestCursorChange function for a given instanceId.
- * This maintains referential stability for the function reference.
- *
- * @param instanceId - The unique identifier for the map cursor instance
- * @returns A requestCursorChange function for this instance
+ * Get effective cursor (computed from state)
  */
-declare function getOrCreateRequestCursorChange(instanceId: UniqueId): (cursor: CSSCursorType, owner: string) => void;
+declare function getCursor(mapId: UniqueId): CSSCursorType;
 /**
- * Creates or retrieves a cached clearCursor function for a given instanceId.
- * This maintains referential stability for the function reference.
+ * Hook for effective cursor value.
  *
- * @param instanceId - The unique identifier for the map cursor instance
- * @returns A clearCursor function for this instance
- */
-declare function getOrCreateClearCursor(instanceId: UniqueId): (owner: string) => void;
-/**
- * Get the current cursor for a given instance (direct access, not reactive).
- * @internal - For internal map-toolkit use only
+ * **Internal use only** - not exported from the public API.
+ * Use `useMapCursor` instead, which provides:
+ * - MapContext integration (auto-resolves mapId inside MapProvider)
+ * - Actions (requestCursorChange, clearCursor)
+ * - Better ergonomics for consumers
  *
- * @param instanceId - The unique identifier for the map instance
- * @returns The current cursor
+ * This hook exists for internal composition (used by useMapCursor).
  */
-declare function getCursor(instanceId: UniqueId): CSSCursorType;
+declare function useCursor(mapId: UniqueId): CSSCursorType;
 /**
- * Manually clear all cursor state for a specific instanceId.
- * This is typically not needed as cleanup happens automatically when all subscribers unmount.
- * Use this only in advanced scenarios where manual cleanup is required.
- *
- * @param instanceId - The unique identifier for the map cursor instance to clear
- *
- * @example
- * ```tsx
- * // Manual cleanup (rarely needed)
- * clearCursorState('my-map-instance');
- * ```
+ * Clear cursor state
  */
-declare function clearCursorState(instanceId: UniqueId): void;
-/** @deprecated Use module functions directly */
-declare function getOrCreateStore(id: UniqueId): {
-  getSnapshot: () => CSSCursorType;
-};
-/** @deprecated Use clearCursorState instead */
-declare function destroyStore(id: UniqueId): void;
-/** @deprecated Use direct function calls instead */
-declare function getStore(id: UniqueId): {
-  getSnapshot: () => CSSCursorType;
-} | undefined;
+declare function clearCursorState(mapId: UniqueId): void;
 //#endregion
-export { clearCursorState, destroyStore, getCursor, getOrCreateClearCursor, getOrCreateRequestCursorChange, getOrCreateServerSnapshot, getOrCreateSnapshot, getOrCreateStore, getOrCreateSubscription, getStore };
+export { clearCursorState, cursorStore, getCursor, useCursor };
 //# sourceMappingURL=store.d.ts.map