@florasync/leaflet-geokit 0.2.0 → 0.4.0

package/dist/types/src/types/public.d.ts

@@ -0,0 +1,106 @@
+import type { Feature, FeatureCollection, Geometry } from "geojson";
+import type { LogLevel } from "@src/utils/logger";
+import type * as Leaflet from "leaflet";
+/**
+ * Basic map configuration derived from element attributes.
+ */
+export interface MapConfig {
+    latitude: number;
+    longitude: number;
+    zoom: number;
+    minZoom?: number;
+    maxZoom?: number;
+    tileUrl: string;
+    tileAttribution?: string;
+    readOnly?: boolean;
+    fitToDataOnLoad?: boolean;
+    logLevel?: LogLevel;
+    devOverlay?: boolean;
+    polygonAllowIntersection?: boolean;
+    /** Use Canvas rendering instead of SVG for better performance with large datasets. Default: true */
+    preferCanvas?: boolean;
+    /**
+     * If true, attempt to use an externally provided Leaflet/Leaflet.draw instead of bundled imports.
+     * When enabled, MapController will validate the presence of window.L and Draw APIs; if absent, it may fall back to bundled.
+     */
+    useExternalLeaflet?: boolean;
+    /**
+     * If true, skip injecting Leaflet/Draw CSS and default icon wiring (host is responsible).
+     * Ignored when useExternalLeaflet is false (bundled path still injects by default).
+     */
+    skipLeafletStyles?: boolean;
+}
+export type MeasurementSystem = "metric" | "imperial";
+/**
+ * Draw controls toggles (presence = true on the element).
+ */
+export interface DrawControlsConfig {
+    polygon?: boolean;
+    polyline?: boolean;
+    rectangle?: boolean;
+    circle?: boolean;
+    /** Draw a Layer Cake base circle + manager to create concentric donut polygons. */
+    cake?: boolean;
+    marker?: boolean;
+    edit?: boolean;
+    delete?: boolean;
+    ruler?: boolean;
+}
+/**
+ * Public API that the custom element exposes (methods/properties).
+ * This is provided for typing in TS consumers who may cast the element.
+ */
+export interface LeafletDrawMapElementAPI {
+    latitude: number;
+    longitude: number;
+    zoom: number;
+    minZoom?: number;
+    maxZoom?: number;
+    tileUrl: string;
+    tileAttribution?: string;
+    readOnly: boolean;
+    logLevel: LogLevel;
+    devOverlay: boolean;
+    themeCss: string;
+    /** Prefer external Leaflet/Draw if available (falls back to bundled if missing). */
+    useExternalLeaflet?: boolean;
+    /** Disable our CSS/icon injection when host supplies styles. */
+    skipLeafletStyles?: boolean;
+    /** Optional injection of a pre-existing Leaflet namespace to use instead of bundled import. */
+    leafletInstance?: typeof Leaflet;
+    getGeoJSON(): Promise<FeatureCollection>;
+    loadGeoJSON(fc: FeatureCollection): Promise<void>;
+    clearLayers(): Promise<void>;
+    addFeatures(fc: FeatureCollection): Promise<string[]>;
+    updateFeature(id: string, feature: Feature): Promise<void>;
+    removeFeature(id: string): Promise<void>;
+    fitBoundsToData(padding?: number): Promise<void>;
+    /**
+     * Fit the map view to an arbitrary bounds tuple [[south, west], [north, east]].
+     * Optional padding is a ratio of the bounds size (e.g., 0.05 for 5%).
+     */
+    fitBounds(bounds: [[number, number], [number, number]], padding?: number): Promise<void>;
+    setView(lat: number, lng: number, zoom?: number): Promise<void>;
+    loadGeoJSONFromUrl(url: string): Promise<void>;
+    loadGeoJSONFromText(text: string): Promise<void>;
+    /**
+     * Emits 'leaflet-draw:export' with the current FeatureCollection.
+     * Returns the exported FeatureCollection for convenience.
+     */
+    exportGeoJSON(): Promise<FeatureCollection>;
+    /**
+     * Merge all visible polygon layers into a single polygon.
+     * This removes the original polygon features and adds a new merged feature.
+     * @param options Optional configuration for the merge operation
+     * @returns Promise resolving to the ID of the newly created merged feature, or null if no polygons to merge
+     */
+    mergePolygons(options?: {
+        /** Properties to apply to the merged feature (defaults to properties from first polygon) */
+        properties?: Record<string, any>;
+    }): Promise<string | null>;
+    /**
+     * Change the measurement system for the Leaflet ruler tool.
+     */
+    setMeasurementUnits(system: MeasurementSystem): Promise<void>;
+}
+export type { Feature, FeatureCollection, Geometry };

package/dist/types/src/utils/geodesic.d.ts

@@ -0,0 +1,8 @@
+export declare function magicRound(value: number): number;
+export interface PreciseDistanceResult {
+    meters: number;
+    bearingDegrees: number;
+    algorithm: "vincenty" | "karney";
+    iterations: number;
+}
+export declare function computePreciseDistance(lat1: number, lon1: number, lat2: number, lon2: number): PreciseDistanceResult;

package/dist/types/src/utils/geojson.d.ts

@@ -0,0 +1,70 @@
+import type { Feature, FeatureCollection, Geometry, Position, Polygon, MultiPolygon, GeoJsonProperties } from "geojson";
+export type BBox = [
+    minLng: number,
+    minLat: number,
+    maxLng: number,
+    maxLat: number
+];
+export type BoundsPair = [[number, number], [number, number]];
+export declare function normalizeId(feature: Feature): string | undefined;
+/**
+ * Callback function for processing a single coordinate position
+ */
+export type CoordinateProcessor = (coord: Position) => void;
+/**
+ * Iterate all coordinates of a Geometry and call the processor function for each Position.
+ */
+export declare function eachCoord(geom: Geometry, cb: CoordinateProcessor): void;
+/**
+ * Compute bounding box [minLng, minLat, maxLng, maxLat] for a single feature.
+ * Returns null when the feature has no geometry.
+ */
+export declare function bboxOfFeature(feature: Feature): BBox | null;
+/**
+ * Compute bounding box for a FeatureCollection. Returns null if no features have geometry.
+ */
+export declare function bboxOfFeatureCollection(fc: FeatureCollection): BBox | null;
+/**
+ * Convert a bbox to [[south, west], [north, east]] tuple.
+ */
+export declare function bboxToBoundsPair(b: BBox): BoundsPair;
+/**
+ * Expand Multi* geometries and GeometryCollections into multiple single-geometry Features.
+ * - MultiPolygon → multiple Polygon features
+ * - MultiLineString → multiple LineString features
+ * - MultiPoint → multiple Point features
+ * - GeometryCollection → one feature per child geometry
+ * Other geometry types are returned unchanged.
+ */
+export declare function expandMultiGeometries(fc: FeatureCollection): FeatureCollection;
+/**
+ * Check if a geometry is a Polygon
+ */
+export declare function isPolygon(geometry: Geometry | null): geometry is Polygon;
+/**
+ * Check if a geometry is a MultiPolygon
+ */
+export declare function isMultiPolygon(geometry: Geometry | null): geometry is MultiPolygon;
+/**
+ * Extract polygon coordinates from a feature
+ * Returns array of rings for each polygon (outer + inner rings)
+ */
+export declare function extractPolygonCoordinates(feature: Feature): Position[][][];
+/**
+ * Merge multiple polygon features into a single polygon feature.
+ * Attempts to create a topological union of the polygons, falling back to
+ * a MultiPolygon if the union operation fails.
+ *
+ * @param features Array of features to merge (only polygon features will be used)
+ * @param properties Properties for the resulting feature (defaults to first feature's properties)
+ * @returns A new Feature with a unified Polygon or MultiPolygon, or null if no valid polygons found
+ */
+export declare function mergePolygons(features: Feature[], properties?: GeoJsonProperties): Feature | null;
+/**
+ * Merge polygons from a FeatureCollection into a single polygon feature.
+ *
+ * @param fc FeatureCollection containing polygons to merge
+ * @param properties Properties for the resulting feature (defaults to first feature's properties)
+ * @returns A Feature with a merged Polygon/MultiPolygon, or null if no polygon features found
+ */
+export declare function mergePolygonsFromCollection(fc: FeatureCollection, properties?: GeoJsonProperties): Feature | null;

package/dist/types/src/utils/leaflet-guards.d.ts

@@ -0,0 +1,9 @@
+import type * as LType from "leaflet";
+export interface AssertDrawOptions {
+    onError?: (message: string) => void;
+}
+/**
+ * Validate that Leaflet.draw APIs exist on the provided Leaflet namespace.
+ * Returns true when present, false otherwise.
+ */
+export declare function assertDrawPresent(L: typeof LType, opts?: AssertDrawOptions): boolean;

package/dist/types/src/utils/logger.d.ts

@@ -0,0 +1,12 @@
+export type LogLevel = "trace" | "debug" | "info" | "warn" | "error" | "silent";
+export interface Logger {
+    level: LogLevel;
+    trace: (...args: unknown[]) => void;
+    debug: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+    child: (childName: string) => Logger;
+    setLevel: (level: LogLevel) => void;
+}
+export declare function createLogger(name: string, level?: LogLevel, sink?: Console): Logger;

package/dist/types/src/utils/ruler.d.ts

@@ -0,0 +1,31 @@
+export type MeasurementSystem = "metric" | "imperial";
+export interface RulerLengthUnitOptions {
+    display: string;
+    decimal: number;
+    factor: number | null;
+    label: string;
+}
+export interface RulerAngleUnitOptions {
+    display: string;
+    decimal: number;
+    factor: number | null;
+    label: string;
+}
+export interface RulerOptions {
+    position: string;
+    circleMarker: {
+        color: string;
+        radius: number;
+    };
+    lineStyle: {
+        color: string;
+        dashArray: string;
+    };
+    lengthUnit: RulerLengthUnitOptions;
+    angleUnit: RulerAngleUnitOptions;
+}
+/**
+ * Build Leaflet-ruler options for a given measurement system.
+ */
+export declare function getRulerOptions(system: MeasurementSystem): RulerOptions;
+export declare const measurementSystemDescriptions: Record<MeasurementSystem, string>;

package/dist/types/tests/bbox-more.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tests/component-api-more.spec.d.ts

@@ -0,0 +1 @@
+import "@src/index";

package/dist/types/tests/component-delegation.spec.d.ts

@@ -0,0 +1 @@
+import "@src/index";

package/dist/types/tests/component-events.spec.d.ts

@@ -0,0 +1 @@
+import "@src/index";

package/dist/types/tests/component-io.spec.d.ts

@@ -0,0 +1 @@
+import "@src/index";

package/dist/types/tests/django-shim.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tests/draw-cake.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tests/eachcoord.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tests/element.spec.d.ts

@@ -0,0 +1 @@
+import "@src/index";

package/dist/types/tests/featureStore-more.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tests/featureStore.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tests/framework-runtime-externalization.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tests/geodesic.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tests/geojson-merge.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tests/geojson-more.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tests/geojson.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tests/layer-cake-baker.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tests/layer-cake-controls.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tests/layer-cake-editing.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tests/layer-cake-manager.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tests/leaflet-assets.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tests/leaflet-draw-circle-resize-patch.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tests/logger-more.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tests/logger.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tests/map-controller.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tests/mapcontroller-merge.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tests/preact-bundled-shim.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tests/react-bundled-shim.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/tests/react-shim.spec.d.ts

@@ -0,0 +1 @@
+import "@src/index";

package/dist/types/tests/ruler.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/vite.config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vite").UserConfig;
+export default _default;

package/dist/types/vite.config.external.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vite").UserConfig;
+export default _default;

package/dist/types/vite.config.preact-bundled.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vite").UserConfig;
+export default _default;

package/dist/types/vite.config.preact.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vite").UserConfig;
+export default _default;

package/dist/types/vite.config.react-bundled.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vite").UserConfig;
+export default _default;

package/dist/types/vite.config.react.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vite").UserConfig;
+export default _default;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@florasync/leaflet-geokit",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Framework-agnostic Leaflet + Leaflet.draw web component with TypeScript, verbose logging, and tests.",
   "type": "module",
   "main": "./dist/leaflet-geokit.umd.js",
@@ -11,6 +11,30 @@
       "types": "./dist/types/index.d.ts",
       "import": "./dist/leaflet-geokit.es.js",
       "require": "./dist/leaflet-geokit.umd.js"
+    },
+    "./django": {
+      "types": "./dist/types/django/index.d.ts",
+      "import": "./dist/django/index.js"
+    },
+    "./external": {
+      "types": "./dist/types/src/external.d.ts",
+      "import": "./dist/leaflet-geokit.external.es.js"
+    },
+    "./preact": {
+      "types": "./dist/types/preact/index.d.ts",
+      "import": "./dist/preact/index.js"
+    },
+    "./preact-bundled": {
+      "types": "./dist/types/preact-bundled/index.d.ts",
+      "import": "./dist/preact-bundled/index.js"
+    },
+    "./react": {
+      "types": "./dist/types/react/index.d.ts",
+      "import": "./dist/react/index.js"
+    },
+    "./react-bundled": {
+      "types": "./dist/types/react-bundled/index.d.ts",
+      "import": "./dist/react-bundled/index.js"
     }
   },
   "files": [
@@ -35,10 +59,19 @@
   "homepage": "https://github.com/FloraSync/leaflet-geokit#readme",
   "scripts": {
     "dev": "vite",
-    "build": "tsc -p tsconfig.json --emitDeclarationOnly && vite build",
+    "build": "tsc -p tsconfig.json --emitDeclarationOnly && vite build && vite build -c vite.config.external.ts && vite build -c vite.config.django.ts && vite build -c vite.config.preact.ts && vite build -c vite.config.preact-bundled.ts && vite build -c vite.config.react.ts && vite build -c vite.config.react-bundled.ts",
+    "build:analyze": "npm run build:analyze:main && npm run build:analyze:external && npm run build:analyze:django && npm run build:analyze:preact && npm run build:analyze:preact-bundled && npm run build:analyze:react && npm run build:analyze:react-bundled",
+    "build:analyze:main": "BUNDLE_ANALYZE=1 BUNDLE_ANALYZE_REPORT=dist/stats/main.html vite build",
+    "build:analyze:external": "BUNDLE_ANALYZE=1 BUNDLE_ANALYZE_REPORT=dist/stats/external.html vite build -c vite.config.external.ts",
+    "build:analyze:django": "BUNDLE_ANALYZE=1 BUNDLE_ANALYZE_REPORT=dist/stats/django.html vite build -c vite.config.django.ts",
+    "build:analyze:preact": "BUNDLE_ANALYZE=1 BUNDLE_ANALYZE_REPORT=dist/stats/preact.html vite build -c vite.config.preact.ts",
+    "build:analyze:preact-bundled": "BUNDLE_ANALYZE=1 BUNDLE_ANALYZE_REPORT=dist/stats/preact-bundled.html vite build -c vite.config.preact-bundled.ts",
+    "build:analyze:react": "BUNDLE_ANALYZE=1 BUNDLE_ANALYZE_REPORT=dist/stats/react.html vite build -c vite.config.react.ts",
+    "build:analyze:react-bundled": "BUNDLE_ANALYZE=1 BUNDLE_ANALYZE_REPORT=dist/stats/react-bundled.html vite build -c vite.config.react-bundled.ts",
     "preview": "vite preview",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "lint": "eslint . --ext .ts,.tsx,.js,.jsx",
+    "lint:fix": "eslint . --ext .ts,.tsx,.js,.jsx --fix",
     "format": "prettier --write .",
     "prettier:check": "prettier --check .",
     "test": "npm run test:unit && npm run test:e2e",
@@ -70,26 +103,49 @@
     "leaflet": "^1.9.4",
     "leaflet-draw": "^1.0.4",
     "leaflet-ruler": "^1.0.0",
-    "preact": "^10.24.0",
     "uuid": "^9.0.1"
   },
+  "peerDependencies": {
+    "preact": "^10.24.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
+  "peerDependenciesMeta": {
+    "preact": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
   "devDependencies": {
-    "@playwright/test": "^1.47.0",
+    "@playwright/test": "^1.58.2",
     "@preact/preset-vite": "^2.8.0",
     "@testing-library/dom": "^10.4.0",
     "@testing-library/preact": "^3.2.4",
+    "@testing-library/react": "^16.1.0",
     "@types/geojson": "^7946.0.14",
     "@types/leaflet": "^1.9.9",
     "@types/leaflet-draw": "^1.0.10",
     "@types/node": "^22.0.0",
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
     "@typescript-eslint/eslint-plugin": "^8.0.1",
     "@typescript-eslint/parser": "^8.0.1",
     "@vitest/coverage-v8": "^3.2.4",
+    "baseline-browser-mapping": "^2.9.17",
     "eslint": "^9.9.0",
     "happy-dom": "^18.0.1",
-    "husky": "^9.0.11",
+    "husky": "^9.1.7",
     "lint-staged": "^15.2.10",
+    "preact": "^10.28.3",
     "prettier": "^3.3.2",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "rollup-plugin-visualizer": "^6.0.5",
     "typescript": "^5.5.4",
     "vite": "^7.1.4",
     "vitest": "^3.2.4"