@npm9912/v-map 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Dietmar Burkard
+
+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,185 @@
+# V-Map 🗺️
+
+**Eine moderne, provider-unabhängige Kartenkomponente für Webanwendungen.**  
+Gebaut mit [Stencil.js](https://stenciljs.com/), [OpenLayers](https://openlayers.org/), [Cesium](https://cesium.com/), [Leaflet](https://leafletjs.com/) und [Deck.gl](https://deck.gl/).
+
+[![npm version](https://badge.fury.io/js/@npm9912%2Fv-map.svg)](https://badge.fury.io/js/@npm9912%2Fv-map)
+[![CI Status](https://github.com/pt9912/v-map/actions/workflows/test.yml/badge.svg)](https://github.com/pt9912/v-map/actions)
+[![Storybook](https://img.shields.io/badge/Storybook-%23FF4785?logo=storybook&logoColor=white)](https://pt9912.github.io/v-map/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## ✨ Features
+
+- **Mehrere Provider**: OpenLayers, Leaflet, Cesium und Deck.gl
+- **Layer-Gruppen**: Basemap- und Overlay-Verwaltung mit Sichtbarkeitssteuerung
+- **GPU-beschleunigte Provider**: Integration von Deck.gl für große Datensätze
+- **Touch-Optimiert**: Funktioniert auf Desktop und mobilen Geräten
+- **TypeScript-Unterstützung**: Vollständige Typdefinitionen
+- **Storybook-Dokumentation**: Interaktive Beispiele und API-Docs
+- **Testing**: Vitest für Spec-, Unit- und Browser-Tests
+- **CI/CD**: Automatisiertes Testing und Releases via GitHub Actions
+- **Devcontainer-Support**: Voll ausgestattete Entwicklungsumgebung mit Docker
+
+---
+
+## 📦 Installation
+
+```bash
+npm install @pt9912/v-map
+# oder mit pnpm
+pnpm add @pt9912/v-map
+```
+
+---
+
+## 🚀 Verwendung
+
+```tsx
+import { VMap } from '@pt9912/v-map';
+
+<v-map flavour="ol" style={{ height: '400px' }}>
+  <v-map-layergroup group-title="Basis-Layer" basemap="true">
+    <v-map-layer-osm></v-map-layer-osm>
+  </v-map-layergroup>
+  <v-map-layergroup group-title="Vector-Layer">
+    <v-map-layer-geojson src="data/points.geojson"></v-map-layer-geojson>
+  </v-map-layergroup>
+</v-map>;
+```
+
+- `flavour` gibt es aktuell in: **`ol`**, **`cesium`**, **`leaflet`**, **`deck`**
+- Layer können kombiniert und gruppiert werden (`<v-map-layergroup>`).
+
+---
+
+## 🛠️ Entwicklung
+
+### Voraussetzungen
+
+- Node.js ≥ 22
+- pnpm ≥ 9
+- Docker (für Devcontainer-Umgebung)
+
+### Setup
+
+```bash
+pnpm install
+```
+
+### Dev-Server starten
+
+```bash
+pnpm start
+```
+
+Läuft standardmäßig auf: [http://localhost:3333](http://localhost:3333)
+
+---
+
+## 🧪 Tests
+
+Dieses Projekt nutzt **Vitest** für `spec`-, `unit`- und Browser-Tests.
+
+```bash
+pnpm test                       # spec + browser
+pnpm test:coverage             # alle Vitest-Projekte mit Coverage
+pnpm test:vitest:browser       # Browser-/Runtime-Tests
+pnpm test:vitest:browser:watch # Browser-Tests im Watch-Modus
+```
+
+---
+
+## 📖 Storybook
+
+Interaktive Dokumentation der Komponenten:
+
+```bash
+pnpm storybook
+```
+
+Erreichbar unter: [http://localhost:6006](http://localhost:6006)
+
+---
+
+## 🐳 Devcontainer
+
+Das Projekt enthält eine vorkonfigurierte **Devcontainer-Umgebung**:
+
+- Basierend auf `node:22`
+- Enthält pnpm, GitHub CLI, Linting/Prettier und Vitest
+- Automatisches Setup via `post-create.sh`
+
+Öffne das Repo in [VS Code Dev Containers](https://code.visualstudio.com/docs/devcontainers/containers) oder [GitHub Codespaces].
+
+---
+
+## 🔄 Build & Release
+
+### Build
+
+```bash
+pnpm build
+```
+
+Erzeugt distributierbare Bundles (`dist/`).
+
+### Release
+
+Releases werden über [semantic-release](https://semantic-release.gitbook.io/) automatisiert:
+
+- Commit Messages nach [Conventional Commits](https://www.conventionalcommits.org/)
+- Automatisches Versioning, Changelog & npm-Publish
+
+```bash
+pnpm release
+```
+
+---
+
+## 📂 Projektstruktur
+
+```
+v-map/
+├── src/
+│   ├── components/
+│   │   ├── v-map/               # Hauptkarte
+│   │   ├── v-map-layer-osm/     # OSM-Basemap
+│   │   ├── v-map-layer-geojson/ # GeoJSON-Daten
+│   │   └── v-map-layergroup/    # Layer-Gruppierung
+│   ├── map-provider/            # Provider-Implementierungen
+│   ├── testing/                 # Test-Setups und Mocks
+│   └── index.ts                 # Entry Point
+├── docs/dev/                    # Interne Entwicklerdoku
+├── .devcontainer/               # VS Code/Codespaces Setup
+├── .github/workflows/           # CI/CD Pipelines
+├── vite.config.ts               # Vite-Konfiguration
+├── vitest.config.mts            # Vitest-Projekte
+└── stencil.config.ts            # Stencil-Konfiguration
+```
+
+---
+
+## Architektur
+
+- Saubere Trennung von deklarativem DOM-API (WebComponents) und imperativer Kartenlogik (Provider).
+
+- Engine-Agnostisch: Austausch/Koexistenz von Leaflet, Deck.gl, Cesium über ein klares Interface.
+
+- Typsicherheit durch LayerConfig-Union + exhaustiveness checks.
+
+- Shadow-DOM-Kompatibilität (CSS-Injection, Adopted Stylesheets).
+
+- Erweiterbarkeit: Neue Layer-Typen oder Engines fügen sich über je einen Adapter ein.
+
+- Wiederverwendbarkeit: VMapLayerHelper als einheitliche Registrierungs-/Update-Pipeline.
+
+---
+
+## 🤝 Contributing
+
+Pull Requests und Issues sind willkommen!  
+Bitte halte dich an [Conventional Commits](https://www.conventionalcommits.org/).
+
+---

package/dist/cjs/_commonjsHelpers-B83fTs8d.js

@@ -0,0 +1,36 @@
+'use strict';
+
+var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
+
+function getDefaultExportFromCjs (x) {
+	return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, 'default') ? x['default'] : x;
+}
+
+function getAugmentedNamespace(n) {
+  if (n.__esModule) return n;
+  var f = n.default;
+	if (typeof f == "function") {
+		var a = function a () {
+			if (this instanceof a) {
+        return Reflect.construct(f, arguments, this.constructor);
+			}
+			return f.apply(this, arguments);
+		};
+		a.prototype = f.prototype;
+  } else a = {};
+  Object.defineProperty(a, '__esModule', {value: true});
+	Object.keys(n).forEach(function (k) {
+		var d = Object.getOwnPropertyDescriptor(n, k);
+		Object.defineProperty(a, k, d.get ? d : {
+			enumerable: true,
+			get: function () {
+				return n[k];
+			}
+		});
+	});
+	return a;
+}
+
+exports.commonjsGlobal = commonjsGlobal;
+exports.getAugmentedNamespace = getAugmentedNamespace;
+exports.getDefaultExportFromCjs = getDefaultExportFromCjs;

package/dist/cjs/app-globals-V2Kpy_OQ.js

@@ -0,0 +1,5 @@
+'use strict';
+
+const globalScripts = () => {};
+
+exports.globalScripts = globalScripts;