@florasync/leaflet-geokit 0.7.0 → 0.8.0

package/dist/types/e2e/tool-events-harness.spec.d.ts

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

package/dist/types/e2e/tool-hooks.spec.d.ts

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

package/dist/types/src/components/LeafletDrawMapElement.d.ts

@@ -1,5 +1,5 @@
 import type { Feature, FeatureCollection } from "geojson";
-import type { LeafletDrawMapElementAPI, MeasurementSystem } from "@src/types/public";
+import type { LeafletDrawMapElementAPI, IntegratedToolEventEmitter, IntegratedToolHooks, MeasurementSystem } from "@src/types/public";
 import { type LogLevel } from "@src/utils/logger";
 import type * as LeafletNS from "leaflet";
 export declare class LeafletDrawMapElement extends HTMLElement implements LeafletDrawMapElementAPI {
@@ -30,6 +30,8 @@ export declare class LeafletDrawMapElement extends HTMLElement implements Leafle
     private _useExternalLeaflet;
     private _skipLeafletStyles;
     private _leafletInstance;
+    private _toolHooks;
+    private _toolEventEmitter;
     constructor();
     private _controlsFromAttributes;
     private _mapConfig;
@@ -74,6 +76,10 @@ export declare class LeafletDrawMapElement extends HTMLElement implements Leafle
     set skipLeafletStyles(v: boolean);
     get leafletInstance(): typeof LeafletNS | undefined;
     set leafletInstance(v: typeof LeafletNS | undefined);
+    get toolHooks(): IntegratedToolHooks | undefined;
+    set toolHooks(v: IntegratedToolHooks | undefined);
+    get toolEventEmitter(): IntegratedToolEventEmitter | undefined;
+    set toolEventEmitter(v: IntegratedToolEventEmitter | undefined);
     get themeCss(): string;
     set themeCss(v: string);
     getGeoJSON(): Promise<FeatureCollection>;

package/dist/types/src/lib/MapController.d.ts

@@ -2,7 +2,7 @@ import * as BundledL from "leaflet";
 import "leaflet-draw";
 import "leaflet-ruler";
 import type { Feature, FeatureCollection } from "geojson";
-import type { DrawControlsConfig, MapConfig, MeasurementSystem } from "@src/types/public";
+import type { DrawControlsConfig, MapConfig, MeasurementSystem, IntegratedToolEventEmitter, IntegratedToolHooks } from "@src/types/public";
 import { type Logger } from "@src/utils/logger";
 import type { TileURLTemplate } from "@src/lib/TileProviderFactory";
 export interface MapControllerCallbacks {
@@ -38,6 +38,10 @@ export interface MapControllerOptions {
     leaflet?: typeof BundledL;
     /** Prefer external Leaflet if available (falls back to bundled if missing/invalid). */
     useExternalLeaflet?: boolean;
+    /** Optional hooks for integrated tool lifecycle/events. */
+    toolHooks?: IntegratedToolHooks;
+    /** Optional event emitter for integrated tool lifecycle/events. */
+    toolEventEmitter?: IntegratedToolEventEmitter;
 }
 interface TileLayerCallbacks {
     onTileError?: (error: unknown) => void;
@@ -68,7 +72,12 @@ export declare class MapController {
     private activeCakeSession;
     private moveConfirmationUI;
     private activeMoveHandler;
+    private emitToolEvent;
     constructor(opts: MapControllerOptions);
+    setToolObservers(options: {
+        toolHooks?: IntegratedToolHooks;
+        toolEventEmitter?: IntegratedToolEventEmitter;
+    }): void;
     private resolveLeaflet;
     init(): Promise<void>;
     destroy(): Promise<void>;

package/dist/types/src/preact/core.d.ts

@@ -1,4 +1,5 @@
 import type { LeafletDrawMapElement } from "@src/components/LeafletDrawMapElement";
+import type { IntegratedToolEventEmitter, IntegratedToolHooks } from "@src/types/public";
 type Primitive = string | number | boolean | null | undefined;
 type LeafletMode = "external" | "bundled";
 export interface PreactLeafletGeoKitProps {
@@ -17,6 +18,10 @@ export interface PreactLeafletGeoKitProps {
     externalLeaflet?: boolean;
     /** Optional explicit Leaflet namespace (window.L equivalent). */
     leafletInstance?: any;
+    /** Optional integrated tool hooks map. */
+    toolHooks?: IntegratedToolHooks;
+    /** Optional integrated tool event emitter. */
+    toolEventEmitter?: IntegratedToolEventEmitter;
     /** Initial GeoJSON text to load once on ready. */
     initialGeoJSONText?: string;
     /** Called whenever draw/edit/delete/merge occurs, with latest serialized FeatureCollection. */

package/dist/types/src/react/core.d.ts

@@ -1,5 +1,6 @@
 import React from "react";
 import type { LeafletDrawMapElement } from "@src/components/LeafletDrawMapElement";
+import type { IntegratedToolEventEmitter, IntegratedToolHooks } from "@src/types/public";
 type Primitive = string | number | boolean | null | undefined;
 type LeafletMode = "external" | "bundled";
 export interface ReactLeafletGeoKitProps {
@@ -18,6 +19,10 @@ export interface ReactLeafletGeoKitProps {
     externalLeaflet?: boolean;
     /** Optional explicit Leaflet namespace (window.L equivalent). */
     leafletInstance?: any;
+    /** Optional integrated tool hooks map. */
+    toolHooks?: IntegratedToolHooks;
+    /** Optional integrated tool event emitter. */
+    toolEventEmitter?: IntegratedToolEventEmitter;
     /** Initial GeoJSON text to load once on ready. */
     initialGeoJSONText?: string;
     /** Called whenever draw/edit/delete/merge occurs, with latest serialized FeatureCollection. */

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

@@ -31,6 +31,12 @@ export interface MapConfig {
     skipLeafletStyles?: boolean;
 }
 export type MeasurementSystem = "metric" | "imperial";
+export type IntegratedToolEventName = "tool:polygon:created" | "tool:polyline:created" | "tool:rectangle:created" | "tool:circle:created" | "tool:marker:created" | "tool:layer-cake:session-started" | "tool:layer-cake:saved" | "tool:move:pending" | "tool:move:confirmed" | "tool:move:cancelled" | "tool:edit:applied" | "tool:delete:applied" | "tool:ruler:units-changed";
+export type IntegratedToolHooks = Partial<Record<IntegratedToolEventName, (detail: unknown) => void>>;
+export interface IntegratedToolEventEmitter {
+    emit?: (eventName: IntegratedToolEventName, detail: unknown) => void;
+    dispatchEvent?: (event: Event) => boolean;
+}
 /**
  * Draw controls toggles (presence = true on the element).
  */
@@ -122,6 +128,10 @@ export interface LeafletDrawMapElementAPI {
     skipLeafletStyles?: boolean;
     /** Optional injection of a pre-existing Leaflet namespace to use instead of bundled import. */
     leafletInstance?: typeof Leaflet;
+    /** Optional per-tool hooks keyed by integrated tool event name. */
+    toolHooks?: IntegratedToolHooks;
+    /** Optional emitter for integrated tool events. */
+    toolEventEmitter?: IntegratedToolEventEmitter;
     /** Tile provider identifier (e.g., "osm", "here") */
     tileProvider?: "osm" | "here" | string;
     /** Provider-specific style (e.g., "lite.day" for HERE) */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@florasync/leaflet-geokit",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Framework-agnostic Leaflet + Leaflet.draw web component with TypeScript, verbose logging, and tests.",
   "type": "module",
   "main": "./dist/leaflet-geokit.umd.js",