@geoimpact/sep-map-sdk 0.0.1

package/README.md

@@ -0,0 +1,82 @@
+# @geoimpact/sep-map-sdk
+
+The official React-based map SDK for Swiss Energy Planning (SEP) applications by geoimpact.
+
+## Features
+
+- 🗺️ **Interactive Map**: Built on Leaflet with high-performance vector tiles.
+- 🔍 **Address Search**: Integrated Swiss address search with autocomplete.
+- 📐 **Perimeter Selection**: Select and interact with building/land perimeters.
+- 🎨 **Customizable**: extensive styling options and layer management.
+- 🌐 **Web Component**: Works in React, Vue, Angular, or Vanilla JS.
+
+## Installation
+
+```bash
+npm install @geoimpact/sep-map-sdk
+```
+
+## Usage
+
+### React
+
+```tsx
+import { SEPMapSDK } from '@geoimpact/sep-map-sdk';
+import { useEffect, useRef } from 'react';
+// Import CSS (required)
+import '@geoimpact/sep-map-sdk/dist/style.css'; 
+
+function MapComponent() {
+  const containerRef = useRef(null);
+
+  useEffect(() => {
+    if (!containerRef.current) return;
+
+    const map = new SEPMapSDK({
+      container: containerRef.current,
+      clientId: 'YOUR_CLIENT_ID',
+      token: 'YOUR_JWT_TOKEN', // Optional: if using authenticated layers
+      features: {
+        addressSearch: true,
+        perimeterSelection: true
+      }
+    });
+
+    return () => map.destroy();
+  }, []);
+
+  return <div ref={containerRef} style={{ height: '600px' }} />;
+}
+```
+
+### Vanilla JS / Web Component
+
+You can also use the SDK via a script tag or as a web component.
+
+```html
+<link rel="stylesheet" href="path/to/sep-map-sdk.css">
+<script src="path/to/sep-map.umd.js"></script>
+
+<div id="map" style="height: 600px;"></div>
+
+<script>
+  const map = new SEPMapSDK({
+    container: '#map',
+    clientId: 'YOUR_CLIENT_ID'
+  });
+</script>
+```
+
+## Configuration
+
+| Option | Type | Required | Description |
+|--------|------|----------|-------------|
+| `clientId` | `string` | Yes | Your application client ID. |
+| `container` | `HTMLElement \| string` | Yes | DOM element or selector to mount the map. |
+| `token` | `string` | No | JWT token for authenticated services. |
+| `language` | `'de' \| 'fr' \| 'it' \| 'en'` | No | Initial language (default: 'de'). |
+| `features` | `FeatureConfig` | No | Enable/disable specific features. |
+
+## License
+
+Proprietary - geoimpact AG