add zone, add popup address, add popup zone, add remove marker, add close popup

This commit is contained in:
david nguyen 2025-10-07 16:25:36 -04:00 committed by David Nguyen
parent 849a6f07a0
commit 943c4fc4ae
Signed by: david.nguyen
GPG Key ID: D5FB5A5715829326
6 changed files with 9 additions and 195 deletions

View File

@ -1,99 +0,0 @@
# CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
## Project Overview
`@svrnty/ngx-open-map-wrapper` is an Angular 16+ library that provides a unified map component with automatic fallback between MapLibre GL (WebGL vector maps) and Leaflet (raster maps). The library automatically detects WebGL support and chooses the optimal rendering engine.
## Architecture
### Adapter Pattern
The library uses the **Adapter pattern** to abstract away differences between MapLibre GL and Leaflet:
- **`IMapAdapter`** (map-adapter.interface.d.ts): Common interface defining map operations
- **`LibreAdapter`** (libre-adapter.d.ts): MapLibre GL implementation
- **`LeafletAdapter`** (leaflet-adapter.d.ts): Leaflet implementation
- **`MapFacade`** (map-facade.d.ts): Facade that selects the appropriate adapter based on WebGL support and user preferences
### Component Structure
- **`OpenMapComponent`** (open-map.component.d.ts): Main Angular component that:
- Uses `WebglDetectionDirective` to detect WebGL support
- Initializes `MapFacade` with the appropriate adapter
- Exposes a unified API via input signals and output events
- Emits `mapReady` event with the `MapFacade` instance
- **`WebglDetectionDirective`** (webgl-detection.directive.d.ts): Directive that detects WebGL support on the user's device and emits the result
### Key Interfaces
**MapOptions**:
- `center: LatLng` - [lat, lng] tuple
- `zoom: number`
- `styleUrl: string` - MapLibre style URL
- `tileUrl: string` - Tile server URL for Leaflet
**Zone** (for delivery/shipping zones):
- `id: string`
- `name?: string`
- `color?: string`
- `opacity?: number`
- `polygon: GeoPoint[]` - Array of {x, y} points
- `shippingFee?: number`
- `deliverySchedule?: string`
**Address** (for popup display):
- `line1, line2, postalCode, subdivision, city, country`
- `shippingFee?: number`
- `deliverySchedule?: string`
### Core APIs
Both adapters implement:
- `init(container, options)` - Initialize map
- `setCenter(latLng)` - Pan to location
- `setZoom(zoom)` - Set zoom level
- `addMarker(latLng, options?)` - Add marker with optional id/color
- `removeMarker(id?)` - Remove specific or all markers
- `addZone(zones)` - Add delivery zones as polygons
- `updateZone(zones)` - Update existing zones
- `openPopup(address)` - Show address popup
- `closePopup()` - Hide popup
- `on(type, event)` - Event listener
- `destroy()` - Cleanup
### Zoom Level Handling
The facade includes a `leafletZoomOffset` property because MapLibre GL and Leaflet use different zoom level scales. When using Leaflet, the facade adjusts zoom levels to maintain visual consistency.
## Development
This is a **compiled Angular library** (not a workspace with source code). The repository contains:
- `/lib` - TypeScript declaration files (.d.ts)
- `/fesm2022` - Compiled ES modules
- `package.json` - Library metadata and peer dependencies
**Peer Dependencies**:
- `@angular/common` and `@angular/core`: ^16.0.0 || ^17.0.0 || ^18.0.0 || ^19.0.0
- `maplibre-gl`: ^5.0.0
- `leaflet`: ^1.0.0 || ^2.0.0
**Installation**:
```bash
yarn add ngx-open-open-map-wrapper leaflet maplibre-gl
```
**CSS Imports Required**:
```css
@import "leaflet/dist/leaflet.css";
@import "maplibre-gl/dist/maplibre-gl.css";
```
## Recent Changes (Current Branch: feature/zone)
Based on git status and recent commits:
- Added `addZone()` and `updateZone()` methods to `IMapAdapter` interface
- Both adapters now support zone management (delivery/shipping zones as polygons)
- Zone objects include shipping fees and delivery schedules for e-commerce use cases

View File

@ -1,5 +1,5 @@
import {Map, NavigationControl, Marker, Popup} from 'maplibre-gl';
import { Map as Map$1, TileLayer, Marker as Marker$1 } from 'leaflet';
import { Map as Map$1, TileLayer, Marker as Marker$1, polygon } from 'leaflet';
import * as i0 from '@angular/core';
import { inject, PLATFORM_ID, output, Directive, Injector, input, runInInjectionContext, effect, ViewChild, Component } from '@angular/core';
import { isPlatformBrowser } from '@angular/common';
@ -130,35 +130,6 @@ class LibreAdapter {
});
}
}
openAddressPopup(address)
{
const bounds = this.map.getBounds();
const corner = bounds.getNorthWest();
this.closePopup();
this.popup = new Popup({
closeButton: false,
closeOnClick: false,
})
.setLngLat([corner.lng, corner.lat])
.setHTML(`
<div class="delivery-address">
<p>${address.line1}</p>
${address.line2 ? `<p>${address.line2}</p>` : ''}
<p>${address.city}, ${address.postalCode}</p>
<p>${address.subdivision}, ${address.country}</p>
${address.shippingFee ? `<p>Shipping ${address.shippingFee}</p>` : ''}
${address.deliverySchedule ? `<p>Delivery time estimate ${address.deliverySchedule}</p>` : ''}
</div>`)
.addTo(this.map);
this.map.on('move', () => {
if (this.popup) {
const newBounds = this.map.getBounds();
const newCorner = newBounds.getNorthWest();
this.popup.setLngLat([newCorner.lng, newCorner.lat]);
}
});
}
openZonePopup(zone)
{
let sumLng = 0;
@ -263,47 +234,10 @@ class LeafletAdapter {
if (zone.opacity)
opacity = zone.opacity;
const polygon = L.polygon(latlngs, { color, fillOpacity: opacity })
polygon(latlngs, { color, fillOpacity: opacity })
.addTo(this.map);
}
}
openAddressPopup(address)
{
const bounds = this.map.getBounds();
const corner = bounds.getNorthEast();
if (this.popup) {
this.map.removeLayer(this.popup);
}
this.popup = new Marker$1(corner, {
opacity: 0
})
.addTo(this.map)
.bindTooltip(`
<div class="delivery-address">
<p>${address.line1}</p>
${address.line2 ? `<p>${address.line2}</p>` : ''}
<p>${address.city}, ${address.postalCode}</p>
<p>${address.subdivision}, ${address.country}</p>
${address.shippingFee ? `<p>Shipping ${address.shippingFee}</p>` : ''}
${address.deliverySchedule ? `<p>Delivery time estimate ${address.deliverySchedule}</p>` : ''}
</div>`,
{
permanent: true,
offset: [-38, 135]
})
.openTooltip();
this.map.on('move', () => {
if (this.popup) {
const newBounds = this.map.getBounds();
const newCorner = newBounds.getNorthEast();
this.popup.setLatLng(newCorner);
}
});
}
openZonePopup(zone)
{
let sumLat = 0;
@ -323,17 +257,13 @@ class LeafletAdapter {
opacity: 0
})
.addTo(this.map)
.bindTooltip(`
<div class="delivery-zone">
.bindPopup(`
<div >
${zone.name ? `<p><strong>${zone.name}</strong></p>` : ''}
${zone.shippingFee ? `<p>Shipping: ${zone.shippingFee}</p>` : ''}
${zone.deliverySchedule ? `<p>Delivery: ${zone.deliverySchedule}</p>` : ''}
</div>`,
{
permanent: true,
offset: [0, 0]
})
.openTooltip();
</div>`)
.openPopup();
}
closePopup()
{
@ -386,9 +316,6 @@ class MapFacade {
updateZone(zones) {
this.adapter.updateZone(zones);
}
openAddressPopup(deliveryAddress) {
this.adapter.openAddressPopup(deliveryAddress);
}
openZonePopup(zone) {
this.adapter.openZonePopup(zone);
}

View File

@ -1,4 +1,4 @@
import {Zone, IMapAdapter, LatLng, MapOptions, Address} from './map-adapter.interface';
import {Zone, IMapAdapter, LatLng, MapOptions} from './map-adapter.interface';
export declare class LeafletAdapter implements IMapAdapter {
private map;
private deliveryCheckMarker?;
@ -13,7 +13,6 @@ export declare class LeafletAdapter implements IMapAdapter {
addZone(zone: Zone[]): void;
updateZone(zone: Zone[]): void;
openZonePopup(zone: Zone) : void
openAddressPopup(address: Address): void;
closePopup(): void;
on(type: string, event: (e: any) => void): void;
}

View File

@ -1,4 +1,4 @@
import {Address, IMapAdapter, LatLng, MapOptions, Zone} from './map-adapter.interface';
import {IMapAdapter, LatLng, MapOptions, Zone} from './map-adapter.interface';
export declare class LibreAdapter implements IMapAdapter {
private map;
private deliveryCheckMarker?;
@ -13,7 +13,6 @@ export declare class LibreAdapter implements IMapAdapter {
addZone(zone: Zone[]): void;
updateZone(zone: Zone[]): void;
openZonePopup(zone: Zone) : void
openAddressPopup(address: Address): void;
closePopup(): void;
on(type: string, event: (e: any) => void): void;
}

View File

@ -18,16 +18,6 @@ export interface Zone {
shippingFee?: number;
deliverySchedule?: string;
}
export interface Address {
line1: string;
line2?: string;
postalCode: string;
subdivision: string;
city: string;
country: string;
shippingFee?: number;
deliverySchedule?: string;
}
export type LatLng = [number, number];
export declare function getLngLat(latLng: LatLng): [number, number];
@ -41,7 +31,6 @@ export interface IMapAdapter {
addZone(zone: Zone[]): void;
updateZone(zone: Zone[]): void;
openZonePopup(zone: Zone) : void
openAddressPopup(address: Address): void;
closePopup(): void;
on(
type: string,

View File

@ -1,4 +1,4 @@
import {IMapAdapter, MapOptions, LatLng, Zone, Address} from './map-adapter.interface';
import {IMapAdapter, MapOptions, LatLng, Zone} from './map-adapter.interface';
export declare class MapFacade implements IMapAdapter {
private readonly adapter;
private readonly leafletZoomOffset;
@ -12,7 +12,6 @@ export declare class MapFacade implements IMapAdapter {
addZone(zone: Zone[]): void;
updateZone(zone: Zone[]): void;
openZonePopup(zone: Zone) : void
openAddressPopup(address: Address): void;
closePopup(): void;
on(type: string, event: (e: any) => void): void;
}