@edgepdf/viewer-js 0.0.1

package/dist/lib/coordinate-mapper.d.ts

@@ -0,0 +1,229 @@
+import L from 'leaflet';
+import type { ImageInfo, LeafletCoords, ImageCoords, CoordinateBounds } from '@edgepdf/types';
+/**
+ * Image position information within the tile grid canvas
+ */
+export interface ImagePosition {
+    /** Width of rendered image in canvas coordinates */
+    imageRenderWidth: number;
+    /** Height of rendered image in canvas coordinates */
+    imageRenderHeight: number;
+    /** X offset of image within canvas */
+    imageOffsetX: number;
+    /** Y offset of image within canvas */
+    imageOffsetY: number;
+    /** Total canvas width */
+    canvasWidth: number;
+    /** Total canvas height */
+    canvasHeight: number;
+}
+/**
+ * CoordinateMapper - Handles coordinate conversion between Leaflet and image pixel coordinates
+ *
+ * This class provides bidirectional coordinate conversion between:
+ * - Leaflet coordinates [y, x] (using custom CRS)
+ * - Image pixel coordinates {x, y}
+ *
+ * The conversion accounts for aspect ratio differences between the image and the tile grid canvas,
+ * properly handling cases where the image doesn't fill the entire canvas.
+ *
+ * @example
+ * ```typescript
+ * const mapper = new CoordinateMapper({
+ *   width: 2000,
+ *   height: 3000,
+ *   tileSize: 256,
+ *   maxZoom: 5,
+ *   minZoom: 0
+ * });
+ *
+ * // Convert Leaflet coordinates to image coordinates
+ * const imageCoords = mapper.leafletToImage([1500, 1000]);
+ * // { x: 1000, y: 1500, withinBounds: true }
+ *
+ * // Convert image coordinates to Leaflet coordinates
+ * const leafletCoords = mapper.imageToLeaflet({ x: 1000, y: 1500 });
+ * // [1500, 1000]
+ * ```
+ */
+export declare class CoordinateMapper {
+    private imageInfo;
+    /**
+     * Creates a new CoordinateMapper instance
+     *
+     * @param imageInfo - Image information including width, height, and zoom levels
+     *
+     * @throws {Error} If imageInfo is invalid
+     */
+    constructor(imageInfo: ImageInfo);
+    /**
+     * Calculates the image position and dimensions within the tile grid canvas.
+     * This handles aspect ratio differences between the image and the canvas.
+     *
+     * @returns Object containing image render dimensions and offsets
+     */
+    calculateImagePosition(): ImagePosition;
+    /**
+     * Converts Leaflet coordinates to image pixel coordinates.
+     *
+     * Accounts for image position within the tile grid canvas and aspect ratio differences.
+     *
+     * @param leafletCoords - Leaflet coordinates [y, x] (lat, lng in CRS.Simple)
+     * @returns Object containing image pixel coordinates and bounds check
+     *
+     * @example
+     * ```typescript
+     * const result = mapper.leafletToImage([1500, 1000]);
+     * // { x: 1000, y: 1500, withinBounds: true }
+     * ```
+     */
+    leafletToImage(leafletCoords: LeafletCoords): ImageCoords & {
+        withinBounds: boolean;
+    };
+    /**
+     * Converts image pixel coordinates to Leaflet coordinates.
+     *
+     * Accounts for image position within the tile grid canvas and aspect ratio differences.
+     *
+     * @param imageCoords - Image pixel coordinates {x, y}
+     * @returns Leaflet coordinates [y, x] (lat, lng in CRS.Simple)
+     *
+     * @example
+     * ```typescript
+     * const leafletCoords = mapper.imageToLeaflet({ x: 1000, y: 1500 });
+     * // [1500, 1000]
+     * ```
+     */
+    imageToLeaflet(imageCoords: ImageCoords): LeafletCoords;
+    /**
+     * Calculates the center point of the image in Leaflet coordinates.
+     *
+     * @returns Object containing center coordinates {x, y} in Leaflet coordinate system
+     *
+     * @example
+     * ```typescript
+     * const center = mapper.getImageCenter();
+     * // { x: 1000, y: 1500 } - center of a 2000x3000 image
+     * ```
+     */
+    getImageCenter(): {
+        x: number;
+        y: number;
+    };
+    /**
+     * Calculates the bounds for the map based on the tile grid.
+     *
+     * Uses the minimum zoom level to ensure consistent coordinate system
+     * across all zoom levels.
+     *
+     * @returns Leaflet bounds expression [[minY, minX], [maxY, maxX]]
+     *
+     * @example
+     * ```typescript
+     * const bounds = mapper.calculateMapBounds();
+     * // [[0, 0], [512, 512]] for minZoom 0 with tileSize 256
+     * ```
+     */
+    calculateMapBounds(): L.LatLngBoundsExpression;
+    /**
+     * Validates Leaflet coordinates and checks bounds
+     *
+     * @param coords - Leaflet coordinates [y, x]
+     * @throws {Error} If coordinates are invalid or out of bounds
+     */
+    validateLeafletCoords(coords: LeafletCoords): void;
+    /**
+     * Validates image pixel coordinates and checks bounds
+     *
+     * @param coords - Image pixel coordinates {x, y}
+     * @throws {Error} If coordinates are invalid or out of bounds
+     */
+    validateImageCoords(coords: ImageCoords): void;
+    /**
+     * Creates a custom CRS (Coordinate Reference System) for direct tile coordinate mapping.
+     * This extends Leaflet's Simple CRS with a custom transformation.
+     *
+     * @returns Custom CRS instance
+     */
+    createCustomCRS(): L.CRS;
+    /**
+     * Calculates the aspect ratio of the image
+     *
+     * @returns Aspect ratio (width / height)
+     *
+     * @example
+     * ```typescript
+     * const aspectRatio = mapper.getAspectRatio();
+     * // 0.666... for a 2000x3000 image
+     * ```
+     */
+    getAspectRatio(): number;
+    /**
+     * Gets the coordinate bounds for the image
+     *
+     * @returns Coordinate bounds object
+     *
+     * @example
+     * ```typescript
+     * const bounds = mapper.getBounds();
+     * // { minX: 0, maxX: 2000, minY: 0, maxY: 3000 }
+     * ```
+     */
+    getBounds(): CoordinateBounds;
+    /**
+     * Gets the image information
+     *
+     * @returns Image info object
+     */
+    getImageInfo(): ImageInfo;
+    /**
+     * Checks if coordinates are within bounds
+     *
+     * @param coords - Image pixel coordinates {x, y}
+     * @returns True if coordinates are within bounds, false otherwise
+     *
+     * @example
+     * ```typescript
+     * const isValid = mapper.isWithinBounds({ x: 1000, y: 1500 });
+     * // true
+     * ```
+     */
+    isWithinBounds(coords: ImageCoords): boolean;
+    /**
+     * Clamps coordinates to valid bounds
+     *
+     * If coordinates are outside bounds, they are clamped to the nearest valid value.
+     *
+     * @param coords - Image pixel coordinates {x, y}
+     * @returns Clamped coordinates within bounds
+     *
+     * @example
+     * ```typescript
+     * const clamped = mapper.clampToBounds({ x: 2500, y: 3500 });
+     * // { x: 2000, y: 3000 } (clamped to max bounds)
+     * ```
+     */
+    clampToBounds(coords: ImageCoords): ImageCoords;
+    /**
+     * Calculates offset for centering coordinates
+     *
+     * This is useful for centering a point in a viewport or container.
+     *
+     * @param coords - Image pixel coordinates {x, y} to center
+     * @param containerWidth - Width of the container/viewport
+     * @param containerHeight - Height of the container/viewport
+     * @returns Offset coordinates {x, y} to apply for centering
+     *
+     * @example
+     * ```typescript
+     * const offset = mapper.calculateCenterOffset(
+     *   { x: 1000, y: 1500 },
+     *   800, // container width
+     *   600  // container height
+     * );
+     * // { x: 600, y: 1200 } - offset to center the point
+     * ```
+     */
+    calculateCenterOffset(coords: ImageCoords, containerWidth: number, containerHeight: number): ImageCoords;
+}
+//# sourceMappingURL=coordinate-mapper.d.ts.map

package/dist/lib/coordinate-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinate-mapper.d.ts","sourceRoot":"","sources":["../../src/lib/coordinate-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,SAAS,CAAC;AACxB,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,WAAW,EACX,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,gBAAgB,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAY;IAE7B;;;;;;OAMG;gBACS,SAAS,EAAE,SAAS;IAchC;;;;;OAKG;IACH,sBAAsB,IAAI,aAAa;IAuCvC;;;;;;;;;;;;;OAaG;IACH,cAAc,CACZ,aAAa,EAAE,aAAa,GAC3B,WAAW,GAAG;QAAE,YAAY,EAAE,OAAO,CAAA;KAAE;IAyB1C;;;;;;;;;;;;;OAaG;IACH,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,aAAa;IAkBvD;;;;;;;;;;OAUG;IACH,cAAc,IAAI;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE;IAU1C;;;;;;;;;;;;;OAaG;IACH,kBAAkB,IAAI,CAAC,CAAC,sBAAsB;IAU9C;;;;;OAKG;IACH,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAqBlD;;;;;OAKG;IACH,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IA+B9C;;;;;OAKG;IACH,eAAe,IAAI,CAAC,CAAC,GAAG;IAMxB;;;;;;;;;;OAUG;IACH,cAAc,IAAI,MAAM;IAIxB;;;;;;;;;;OAUG;IACH,SAAS,IAAI,gBAAgB;IAS7B;;;;OAIG;IACH,YAAY,IAAI,SAAS;IAIzB;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IAS5C;;;;;;;;;;;;;OAaG;IACH,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW;IAO/C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,qBAAqB,CACnB,MAAM,EAAE,WAAW,EACnB,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,GACtB,WAAW;CAaf"}

package/dist/lib/marker-delete-popup.d.ts

@@ -0,0 +1,20 @@
+import type { Marker } from '@edgepdf/types';
+/**
+ * Options for creating a delete confirmation popup
+ */
+export interface DeletePopupOptions {
+    /** Current marker data */
+    marker: Marker;
+    /** Callback when delete is confirmed */
+    onConfirm: () => void;
+    /** Callback when cancel is clicked */
+    onCancel: () => void;
+}
+/**
+ * Creates and shows a delete confirmation popup for a marker
+ *
+ * @param options - Delete popup options
+ * @returns HTML element containing the popup
+ */
+export declare function createDeletePopup(options: DeletePopupOptions): HTMLElement;
+//# sourceMappingURL=marker-delete-popup.d.ts.map

package/dist/lib/marker-delete-popup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marker-delete-popup.d.ts","sourceRoot":"","sources":["../../src/lib/marker-delete-popup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAOD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAsG1E"}

package/dist/lib/marker-edit-popup.d.ts

@@ -0,0 +1,23 @@
+import type { Marker } from '@edgepdf/types';
+/**
+ * Options for creating an edit popup
+ */
+export interface EditPopupOptions {
+    /** Current marker data */
+    marker: Marker;
+    /** Callback when save is clicked */
+    onSave: (updates: {
+        title?: string;
+        href?: string;
+    }) => void;
+    /** Callback when cancel is clicked */
+    onCancel: () => void;
+}
+/**
+ * Creates and shows an edit popup for a marker
+ *
+ * @param options - Edit popup options
+ * @returns HTML element containing the popup
+ */
+export declare function createEditPopup(options: EditPopupOptions): HTMLElement;
+//# sourceMappingURL=marker-edit-popup.d.ts.map

package/dist/lib/marker-edit-popup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marker-edit-popup.d.ts","sourceRoot":"","sources":["../../src/lib/marker-edit-popup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,MAAM,EAAE,CAAC,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7D,sCAAsC;IACtC,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAOD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,WAAW,CA2ItE"}

package/dist/lib/marker-manager.d.ts

@@ -0,0 +1,408 @@
+import L from 'leaflet';
+import type { Marker, MarkerData, LeafletCoords, ImageCoords, ImageInfo, MarkerEvent, MarkerEventType, MarkerInteractionConfig, MarkerSelectionState } from '@edgepdf/types';
+import { CoordinateMapper } from './coordinate-mapper.js';
+/**
+ * Options for creating a marker
+ */
+export interface CreateMarkerOptions {
+    /** Leaflet coordinates [lat, lng] */
+    position?: LeafletCoords;
+    /** Image pixel coordinates {x, y} */
+    imageCoords?: ImageCoords;
+    /** Marker title/tooltip text */
+    title?: string;
+    /** Marker annotation/description */
+    annotation?: string;
+    /** Link URL (optional) */
+    href?: string;
+    /** Link target (optional) */
+    target?: string;
+    /** Show label/tooltip */
+    showLabel?: boolean;
+    /** Custom marker ID (auto-generated if not provided) */
+    id?: string;
+}
+/**
+ * MarkerManager - Manages markers on the Leaflet map
+ *
+ * This class handles:
+ * - Marker creation from coordinates (Leaflet or image pixel coordinates)
+ * - Marker positioning and coordinate storage
+ * - Marker lifecycle management (add, remove, update, get)
+ * - Marker validation
+ * - Marker interactions (dragging, selection, tooltips, popups)
+ * - Event handling for marker actions
+ *
+ * @example
+ * ```typescript
+ * const markerManager = new MarkerManager({
+ *   map: leafletMap,
+ *   coordinateMapper: coordinateMapper,
+ *   imageInfo: imageInfo
+ * });
+ *
+ * // Enable interactions
+ * markerManager.setInteractionConfig({
+ *   draggable: true,
+ *   selectable: true,
+ *   showTooltips: true,
+ *   showPopups: true
+ * });
+ *
+ * // Listen to marker events
+ * markerManager.on('dragend', (event) => {
+ *   console.log('Marker dragged:', event.marker.id);
+ * });
+ *
+ * // Create marker from Leaflet coordinates
+ * const marker = markerManager.createMarker({
+ *   position: [1500, 1000],
+ *   title: 'My Marker'
+ * });
+ *
+ * // Get all markers
+ * const allMarkers = markerManager.getAllMarkers();
+ * ```
+ */
+export declare class MarkerManager {
+    private map;
+    private coordinateMapper;
+    private imageInfo;
+    private markers;
+    private leafletMarkers;
+    private markerLayerGroup;
+    private eventListeners;
+    private selectedIds;
+    private interactionConfig;
+    /**
+     * Creates a new MarkerManager instance
+     *
+     * @param options - Configuration options
+     * @param options.map - Leaflet map instance
+     * @param options.coordinateMapper - Coordinate mapper for coordinate conversion
+     * @param options.imageInfo - Image information for validation
+     *
+     * @throws {Error} If map is not provided or invalid
+     * @throws {Error} If coordinateMapper is not provided
+     * @throws {Error} If imageInfo is not provided
+     */
+    constructor(options: {
+        map: L.Map;
+        coordinateMapper: CoordinateMapper;
+        imageInfo: ImageInfo;
+    });
+    /**
+     * Creates a new marker from coordinates
+     *
+     * Either position (Leaflet coordinates) or imageCoords must be provided.
+     * If both are provided, position takes precedence.
+     *
+     * @param options - Marker creation options
+     * @param options.position - Leaflet coordinates [lat, lng]
+     * @param options.imageCoords - Image pixel coordinates {x, y}
+     * @param options.title - Marker title/tooltip text
+     * @param options.annotation - Marker annotation/description
+     * @param options.href - Link URL (optional)
+     * @param options.target - Link target (optional)
+     * @param options.showLabel - Show label/tooltip
+     * @param options.id - Custom marker ID (auto-generated if not provided)
+     *
+     * @returns The created marker
+     *
+     * @throws {Error} If neither position nor imageCoords is provided
+     * @throws {Error} If coordinates are invalid or out of bounds
+     */
+    createMarker(options: CreateMarkerOptions): Marker;
+    /**
+     * Gets a marker by ID
+     *
+     * @param id - Marker ID
+     * @returns The marker, or undefined if not found
+     */
+    getMarker(id: string): Marker | null;
+    /**
+     * Gets all markers
+     *
+     * @returns Array of all markers
+     */
+    getAllMarkers(): Marker[];
+    /**
+     * Exports all markers as JSON data
+     *
+     * Serializes all markers into a MarkerData object that can be saved to a file
+     * or transmitted. The exported data includes metadata like export timestamp
+     * and version.
+     *
+     * @returns MarkerData object containing all markers and metadata
+     *
+     * @example
+     * ```typescript
+     * const markerData = markerManager.exportMarkers();
+     * const jsonString = JSON.stringify(markerData, null, 2);
+     * // Save to file or send to server
+     * ```
+     */
+    exportMarkers(): MarkerData;
+    /**
+     * Imports markers from MarkerData
+     *
+     * Validates and imports markers from a MarkerData object. This method:
+     * - Validates the data structure
+     * - Validates each marker's coordinates are within bounds
+     * - Creates markers using the imported data
+     * - Handles coordinate compatibility (ensures both Leaflet and image coordinates are valid)
+     *
+     * @param data - MarkerData object to import
+     * @param options - Import options
+     * @param options.clearExisting - If true, removes all existing markers before import (default: false)
+     * @param options.validateCoordinates - If true, validates coordinates are within bounds (default: true)
+     *
+     * @returns Import result with success status and details
+     *
+     * @throws {Error} If data structure is invalid
+     * @throws {Error} If marker validation fails
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   const result = markerManager.importMarkers(markerData, {
+     *     clearExisting: true,
+     *     validateCoordinates: true
+     *   });
+     *   console.log(`Imported ${result.importedCount} markers`);
+     * } catch (error) {
+     *   console.error('Import failed:', error);
+     * }
+     * ```
+     */
+    importMarkers(data: MarkerData, options?: {
+        clearExisting?: boolean;
+        validateCoordinates?: boolean;
+    }): {
+        success: boolean;
+        importedCount: number;
+        errors: string[];
+    };
+    /**
+     * Removes a marker by ID
+     *
+     * @param id - Marker ID
+     * @returns True if marker was removed, false if not found
+     */
+    removeMarker(id: string): boolean;
+    /**
+     * Removes all markers
+     */
+    removeAllMarkers(): void;
+    /**
+     * Updates a marker's position
+     *
+     * @param id - Marker ID
+     * @param position - New Leaflet coordinates [lat, lng]
+     * @returns True if marker was updated, false if not found
+     *
+     * @throws {Error} If coordinates are invalid or out of bounds
+     */
+    updateMarkerPosition(id: string, position: LeafletCoords): boolean;
+    /**
+     * Updates a marker's properties (excluding position)
+     *
+     * @param id - Marker ID
+     * @param updates - Partial marker properties to update
+     * @returns True if marker was updated, false if not found
+     */
+    updateMarker(id: string, updates: Partial<Omit<Marker, 'id' | 'position' | 'x' | 'y' | 'zoom'>>): boolean;
+    /**
+     * Gets the number of markers
+     *
+     * @returns Number of markers
+     */
+    getMarkerCount(): number;
+    /**
+     * Checks if a marker exists
+     *
+     * @param id - Marker ID
+     * @returns True if marker exists, false otherwise
+     */
+    hasMarker(id: string): boolean;
+    /**
+     * Sets the interaction configuration for markers
+     *
+     * @param config - Interaction configuration
+     */
+    setInteractionConfig(config: Partial<MarkerInteractionConfig>): void;
+    /**
+     * Gets the current interaction configuration
+     *
+     * @returns Current interaction configuration
+     */
+    getInteractionConfig(): MarkerInteractionConfig;
+    /**
+     * Selects a marker by ID
+     *
+     * @param id - Marker ID to select
+     * @returns True if marker was selected, false if not found
+     */
+    selectMarker(id: string): boolean;
+    /**
+     * Deselects a marker by ID
+     *
+     * @param id - Marker ID to deselect
+     * @returns True if marker was deselected, false if not found
+     */
+    deselectMarker(id: string): boolean;
+    /**
+     * Deselects all markers
+     */
+    deselectAllMarkers(): void;
+    /**
+     * Gets the current selection state
+     *
+     * @returns Selection state
+     */
+    getSelectionState(): MarkerSelectionState;
+    /**
+     * Checks if a marker is selected
+     *
+     * @param id - Marker ID
+     * @returns True if marker is selected
+     */
+    isMarkerSelected(id: string): boolean;
+    /**
+     * Deletes a marker by ID (triggers delete event)
+     *
+     * @param id - Marker ID to delete
+     * @returns True if marker was deleted, false if not found
+     */
+    deleteMarker(id: string): boolean;
+    /**
+     * Registers an event listener
+     *
+     * @param eventType - Event type to listen for
+     * @param callback - Callback function
+     * @returns Unsubscribe function
+     */
+    on(eventType: MarkerEventType, callback: (event: MarkerEvent) => void): () => void;
+    /**
+     * Unregisters an event listener
+     *
+     * @param eventType - Event type
+     * @param callback - Callback function to remove
+     */
+    off(eventType: MarkerEventType, callback: (event: MarkerEvent) => void): void;
+    /**
+     * Removes all event listeners for a specific event type, or all events if no type is provided
+     *
+     * @param eventType - Optional event type to clear
+     */
+    removeAllListeners(eventType?: MarkerEventType): void;
+    /**
+     * Disposes of the marker manager and cleans up resources
+     *
+     * This should be called when the marker manager is no longer needed.
+     */
+    dispose(): void;
+    /**
+     * Creates a Leaflet marker from marker data
+     *
+     * @param marker - Marker data
+     * @returns Leaflet marker instance
+     */
+    private createLeafletMarker;
+    /**
+     * Sets up interaction handlers for a marker
+     *
+     * @param leafletMarker - Leaflet marker instance
+     * @param marker - Marker data
+     */
+    private setupMarkerInteractions;
+    /**
+     * Handles marker click events
+     *
+     * @param marker - Marker that was clicked
+     */
+    private handleMarkerClick;
+    /**
+     * Updates the visual appearance of a marker based on selection state
+     *
+     * @param id - Marker ID
+     * @param selected - Whether marker is selected
+     */
+    private updateMarkerSelectionVisual;
+    /**
+     * Emits an event to all registered listeners
+     *
+     * @param eventType - Event type
+     * @param marker - Marker that triggered the event
+     * @param coordinates - Optional coordinates
+     */
+    private emitEvent;
+    /**
+     * Escapes HTML to prevent XSS
+     *
+     * @param text - Text to escape
+     * @returns Escaped HTML string
+     */
+    private escapeHtml;
+    /**
+     * Creates popup content HTML for a marker
+     *
+     * @param marker - Marker data
+     * @returns HTML string for popup content
+     */
+    private createPopupContent;
+    /**
+     * Updates Leaflet marker display (tooltip/popup)
+     *
+     * @param leafletMarker - Leaflet marker instance
+     * @param marker - Marker data
+     */
+    private updateLeafletMarkerDisplay;
+    /**
+     * Attaches event listeners to popup edit/delete buttons
+     *
+     * @param leafletMarker - Leaflet marker instance
+     * @param marker - Marker data
+     */
+    private attachPopupButtonListeners;
+    /**
+     * Handles marker edit action
+     *
+     * @param marker - Marker to edit
+     */
+    private handleEdit;
+    /**
+     * Handles marker delete action
+     *
+     * @param marker - Marker to delete
+     */
+    private handleDelete;
+    /**
+     * Validates a marker
+     *
+     * @param marker - Marker to validate
+     * @throws {Error} If marker is invalid
+     */
+    private validateMarker;
+    /**
+     * Validates marker data structure for import
+     *
+     * @param markerData - Marker data to validate
+     * @throws {Error} If marker data is invalid
+     */
+    private validateMarkerData;
+    /**
+     * Validates marker coordinates are within bounds
+     *
+     * @param markerData - Marker data to validate
+     * @throws {Error} If coordinates are out of bounds
+     */
+    private validateMarkerCoordinates;
+    /**
+     * Generates a unique marker ID
+     *
+     * @returns Unique marker ID
+     */
+    private generateMarkerId;
+}
+//# sourceMappingURL=marker-manager.d.ts.map

package/dist/lib/marker-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marker-manager.d.ts","sourceRoot":"","sources":["../../src/lib/marker-manager.ts"],"names":[],"mappings":"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"}