leaflet-anvil 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tim Tilch
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,108 @@
+# Leaflet Anvil 🛠️
+
+Ein minimalistisches, leistungsstarkes Toolkit zum Zeichnen und Editieren von Geometrien in [Leaflet](https://leafletjs.com/). Fokus liegt
+auf einer sauberen API, modernen TypeScript-Features und Unterstützung für komplexe geometrische Operationen wie Union und Subtract.
+
+## Features
+
+- **Zeichen-Modi**: Marker, Polylines, Polygone, Rechtecke, Quadrate, Dreiecke, Kreise und Freehand-Drawing.
+- **Editier-Tools**: Drag, Scale, Rotate und Vertex-Editing.
+- **Geometrische Operationen**:
+    - `Union`: Verschmelzen von zwei Polygonen.
+    - `Subtract`: Abziehen eines Polygons von einem anderen.
+    - `Cut` & `Split`: Zerschneiden von Linien oder Flächen.
+- **Smart Helpers**: Snapping (Einrasten) an vorhandenen Punkten und Magnetic-Modus.
+- **Event-basiert**: Einfache Integration durch ein konsistentes Event-System.
+
+## Installation
+
+```bash
+npm install leaflet-anvil
+```
+
+*Hinweis: Leaflet ist eine Peer-Dependency und muss ebenfalls installiert sein.*
+
+## Schnellstart
+
+```typescript
+import L from 'leaflet';
+import { Anvil } from 'leaflet-anvil';
+
+const map = L.map('map').setView([51.505, -0.09], 13);
+L.tileLayer('https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png').addTo(map);
+
+// Anvil initialisieren
+const anvil = new Anvil(map, {
+    snapping: true,
+    snapDistance: 15
+});
+
+// Einen Modus aktivieren
+anvil.enable('draw:polygon');
+
+// Auf Events reagieren
+map.on('anvil:created', (e) => {
+    console.log('Neuer Layer erstellt:', e.layer);
+});
+```
+
+## Verfügbare Modi
+
+Aktivierung über `anvil.enable(modeName)`:
+
+| Modus            | Beschreibung                            |
+|:-----------------|:----------------------------------------|
+| `draw:marker`    | Setzt einen Marker                      |
+| `draw:polyline`  | Zeichnet eine Linie                     |
+| `draw:polygon`   | Zeichnet eine geschlossene Fläche       |
+| `draw:rectangle` | Zeichnet ein Rechteck                   |
+| `draw:circle`    | Zeichnet einen Kreis                    |
+| `draw:freehand`  | Freihandzeichnen (Klicken und Ziehen)   |
+| `edit`           | Bearbeiten von Eckpunkten (Vertices)    |
+| `drag`           | Verschieben von ganzen Layern           |
+| `rotate`         | Rotieren von Geometrien                 |
+| `scale`          | Skalieren von Geometrien                |
+| `union`          | Verschmelzen zweier Polygone            |
+| `subtract`       | Abziehen des zweiten vom ersten Polygon |
+| `delete`         | Layer per Klick entfernen               |
+
+## API Referenz
+
+### Anvil Options
+
+| Option                    | Typ             | Standard | Beschreibung                        |
+|:--------------------------|:----------------|:---------|:------------------------------------|
+| `snapping`                | `boolean`       | `false`  | Aktiviert Snapping an Eckpunkten    |
+| `snapDistance`            | `number`        | `10`     | Distanz in Pixeln für Snapping      |
+| `preventSelfIntersection` | `boolean`       | `false`  | Verhindert Selbstüberschneidungen   |
+| `pathOptions`             | `L.PathOptions` | `{}`     | Standard-Styles für neue Geometrien |
+
+### Events (`ANVIL_EVENTS`)
+
+Alle Events werden auf der Leaflet-Map gefeuert:
+
+- `anvil:created`: Wenn ein neuer Layer fertiggestellt wurde.
+- `anvil:edited`: Wenn ein Layer verändert wurde (drag/rotate/edit/scale).
+- `anvil:deleted`: Wenn ein Layer entfernt wurde.
+- `anvil:modechange`: Wenn der aktive Modus wechselt.
+
+## Entwicklung
+
+```bash
+# Abhängigkeiten installieren
+npm install
+
+# Entwicklungsserver (Vite)
+npm run dev
+
+# Tests ausführen
+npm test
+
+# Build erstellen
+npm run build
+```
+
+## Lizenz
+
+MIT
+

package/dist/index.d.mts

@@ -0,0 +1,50 @@
+import * as L from 'leaflet';
+
+interface Mode {
+    enable(): void;
+    disable(): void;
+}
+interface AnvilOptions {
+    layerGroup?: L.FeatureGroup;
+    snapping?: boolean;
+    snapDistance?: number;
+    magnetic?: boolean;
+    freehandTolerance?: number;
+    preventSelfIntersection?: boolean;
+    pathOptions?: L.PathOptions;
+    ghostPathOptions?: L.PathOptions;
+    vertexOptions?: L.MarkerOptions;
+}
+declare class Anvil {
+    private map;
+    private modeManager;
+    private store;
+    private options;
+    constructor(map: L.Map, options?: AnvilOptions);
+    enable(mode: 'draw:polygon' | 'draw:polyline' | 'draw:marker' | 'draw:rectangle' | 'draw:square' | 'draw:triangle' | 'draw:circle' | 'draw:freehand' | 'cut' | 'split' | 'union' | 'subtract' | 'drag' | 'scale' | 'rotate' | 'edit' | 'delete'): void;
+    disable(): void;
+    getLayerGroup(): L.FeatureGroup;
+}
+
+declare const ANVIL_EVENTS: {
+    readonly CREATED: "anvil:created";
+    readonly EDITED: "anvil:edited";
+    readonly DELETED: "anvil:deleted";
+    readonly SPLIT: "anvil:split";
+    readonly UNION: "anvil:union";
+    readonly SUBTRACT: "anvil:subtract";
+    readonly MODE_CHANGE: "anvil:modechange";
+};
+
+interface AnvilControlOptions extends L.ControlOptions {
+    position?: L.ControlPosition;
+}
+declare class AnvilControl extends L.Control {
+    private _btns;
+    private _anvil;
+    constructor(anvil: Anvil, options?: L.ControlOptions);
+    onAdd(map: L.Map): HTMLElement;
+}
+declare function anvilControl(anvil: Anvil, options?: AnvilControlOptions): AnvilControl;
+
+export { ANVIL_EVENTS, Anvil, AnvilControl, type AnvilControlOptions, type AnvilOptions, type Mode, anvilControl };

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+import * as L from 'leaflet';
+
+interface Mode {
+    enable(): void;
+    disable(): void;
+}
+interface AnvilOptions {
+    layerGroup?: L.FeatureGroup;
+    snapping?: boolean;
+    snapDistance?: number;
+    magnetic?: boolean;
+    freehandTolerance?: number;
+    preventSelfIntersection?: boolean;
+    pathOptions?: L.PathOptions;
+    ghostPathOptions?: L.PathOptions;
+    vertexOptions?: L.MarkerOptions;
+}
+declare class Anvil {
+    private map;
+    private modeManager;
+    private store;
+    private options;
+    constructor(map: L.Map, options?: AnvilOptions);
+    enable(mode: 'draw:polygon' | 'draw:polyline' | 'draw:marker' | 'draw:rectangle' | 'draw:square' | 'draw:triangle' | 'draw:circle' | 'draw:freehand' | 'cut' | 'split' | 'union' | 'subtract' | 'drag' | 'scale' | 'rotate' | 'edit' | 'delete'): void;
+    disable(): void;
+    getLayerGroup(): L.FeatureGroup;
+}
+
+declare const ANVIL_EVENTS: {
+    readonly CREATED: "anvil:created";
+    readonly EDITED: "anvil:edited";
+    readonly DELETED: "anvil:deleted";
+    readonly SPLIT: "anvil:split";
+    readonly UNION: "anvil:union";
+    readonly SUBTRACT: "anvil:subtract";
+    readonly MODE_CHANGE: "anvil:modechange";
+};
+
+interface AnvilControlOptions extends L.ControlOptions {
+    position?: L.ControlPosition;
+}
+declare class AnvilControl extends L.Control {
+    private _btns;
+    private _anvil;
+    constructor(anvil: Anvil, options?: L.ControlOptions);
+    onAdd(map: L.Map): HTMLElement;
+}
+declare function anvilControl(anvil: Anvil, options?: AnvilControlOptions): AnvilControl;
+
+export { ANVIL_EVENTS, Anvil, AnvilControl, type AnvilControlOptions, type AnvilOptions, type Mode, anvilControl };