-
-**Plugins for OpenLAyeRs** is based on the [masterportalAPI](https://bitbucket.org/geowerkstatt-hamburg/masterportalapi) and [OpenLayers](https://openlayers.org/).
-
-POLAR is ...
-
-* ... a configurable map client package.
-* ... a flexible map client factory.
-* ... an extensible library.
-
-## Quick Start
-
-Usage without NPM is documented [here](#getting-started-for-developers).
-
-### Installation (via NPM)
-
-```bash
-npm i @polar/client-generic
-```
-
-### Embedding POLAR
-#### .js
-```js
-import polar from '@polar/client-generic'
-
-polar.createMap({
- // a div must have this id
- containerId: 'polarstern',
- // any service register – this is Hamburg's
- services: 'https://geodienste.hamburg.de/services-internet.json',
- mapConfiguration: {
- // this initially shows Hamburg's city plan
- layers: [{
- id: '453',
- visibility: true,
- type: 'background',
- }]
- }
-})
-```
-
-#### .html
-```html
-
-```
-
-See our [documentation page](https://dataport.github.io/polar/) for all features and configuration options included in this modulith client, with running examples.
-
-## Example clients
-
-The most common use case for this client is in citizen's application processes regarding public service.
-
-Other clients with more specific code include the [Denkmalkarte Schleswig-Holstein](https://efi2.schleswig-holstein.de/dish/dish_client/index.html), a memorial map, and the [Meldemichel Hamburg](https://static.hamburg.de/kartenclient/prod/), a map to inspect and create reports regarding damages to public infrastructure. The latter is currently being migrated to the version seen in this repository.
-
-A more abstract example is the "Snowbox", which is a test environment for developers with many plugins active:
-
-
-
-
-
-## Backers and users
-
-### States of Germany
-
-
-
-
Freie Hansestadt Bremen
-
Freie und Hansestadt Hamburg
-
-
-
Sachsen-Anhalt
-
Schleswig-Holstein
-
-
-
-### Government agencies
-
-* [Senatskanzlei Hamburg](https://www.hamburg.de/senatskanzlei/)
-* [Landesamt für Denkmalpflege Schleswig-Holstein](https://www.schleswig-holstein.de/DE/landesregierung/ministerien-behoerden/LD/ld_node.html)
-* [Dataport AöR](https://www.dataport.de/)
-
-## Technical concepts
-
-### Reusability *and* adaptability
-
-POLAR is built to ease the creation of new map clients. A lot of feature requests in map clients are recurring and can be fulfilled with reusable parts. Then again, many map clients require a _little extra_.
-
-POLAR is built to serve both worlds. For generic use cases, generic clients are ready-made and usable by configuration. More specific use cases can be matched with special clients that still make use of the plugins and fill in the missing parts.
-
-POLAR runs both as full page application and as component. The most common usage is as component: Think of it as a form input where the input data is geospatial.
-
-### Plugin-based approach
-
-To see our plugins in action, please visit our [documentation page](https://dataport.github.io/polar/) to see running examples. Plugins are designed to be configurable, optional, and replacable.
-
-|Name|Details|
-|-|-|
-|[AddressSearch](https://github.com/Dataport/polar/tree/main/packages/plugins/AddressSearch)|Offers a search field and standard search service implementations with API for your own configurable custom search services. For already usable search services, see the documentation of the package. Integration with Reverse Geocoder and Pins possible, or usable as a data source for further processing.|
-|[Attributions](https://github.com/Dataport/polar/tree/main/packages/plugins/Attributions)|Shows layer copyright information of visible layers and client.|
-|[Draw](https://github.com/Dataport/polar/tree/main/packages/plugins/Draw)|Allows the user to draw various geometries onto the map. The resulting GeoJSON can be forwarded to later processing steps, or be used by the Export plugin to generate screenshots.|
-|[Export](https://github.com/Dataport/polar/tree/main/packages/plugins/Export)|Offers screenshot functionality for the user or further processing.|
-|[Filter](https://github.com/Dataport/polar/tree/main/packages/plugins/Filter)|Allows users to filter vector layers to content relevant to their interests.|
-|[Fullscreen](https://github.com/Dataport/polar/tree/main/packages/plugins/Fullscreen)|User can toggle between integrated and fullscreen view with this plugin.|
-|[GeoLocation](https://github.com/Dataport/polar/tree/main/packages/plugins/GeoLocation)|Geolocalizes the user either on user demand or as a background procedure. An icon is shown on the user position on the map.|
-|[Gfi](https://github.com/Dataport/polar/tree/main/packages/plugins/Gfi)|Short for "Get Feature Information". Retrieves feature information from a WMS or WFS layer for display or usage by further processing steps. Can be used as feature list viewer for vector layers.|
-|[IconMenu](https://github.com/Dataport/polar/tree/main/packages/plugins/IconMenu)|Handles display of visible plugin buttons. Only relevant for programming clients, no direct user feature.|
-|[LayerChooser](https://github.com/Dataport/polar/tree/main/packages/plugins/LayerChooser)|Allows choosing a background layer and an arbitrary amount of feature or overlay layers. WMS layers can optionally be filtered by sub-layers by the user.|
-|[Legend](https://github.com/Dataport/polar/tree/main/packages/plugins/Legend)|Displays an overview of layer legend images as delivered by the used WMS services. Images can be clicked for large view.|
-|[LoadingIndicator](https://github.com/Dataport/polar/tree/main/packages/plugins/LoadingIndicator)|Loading spinner. Only relevant for programming clients, no direct user feature.|
-|[PointerPosition](https://github.com/Dataport/polar/tree/main/packages/plugins/PointerPosition)|Displays the current/last pointer position in a coordinate reference system chosen by the user.|
-|[Pins](https://github.com/Dataport/polar/tree/main/packages/plugins/Pins)|Pin feature that allows users to set and move pins to indicate a position. Integration with AddressSearch and ReverseGeocoder configurable.|
-|[ReverseGeocoder](https://github.com/Dataport/polar/tree/main/packages/plugins/ReverseGeocoder)|Configurable to translate an arbitrary coordinate to an address. Integration with AddressSearch and Pins configurable.|
-|[Scale](https://github.com/Dataport/polar/tree/main/packages/plugins/Scale)|Shows current scale as ratio and size indicator.|
-|[Toast](https://github.com/Dataport/polar/tree/main/packages/plugins/Toast)|Shows information to the user. Configurable in many plugins to communicate status updates or procedural advice.|
-|[Zoom](https://github.com/Dataport/polar/tree/main/packages/plugins/Zoom)|Allows zooming in and out of the client with buttons.|
-
-## Getting started (for developers)
-
-For a detailed step-by-step guide, please refer to our comprehensive [Getting Started guide](https://github.com/Dataport/polar/tree/main/gettingStarted.md).
-
-## Stay In Touch
-
-- [Contact us via email 📧](mailto:polar@dataport.de)
-
-made by [Dataport](https://www.dataport.de/) with ❤️
+# POLAR
\ No newline at end of file
diff --git a/babel.config.js b/babel.config.js
deleted file mode 100644
index 487cbc3e43..0000000000
--- a/babel.config.js
+++ /dev/null
@@ -1,14 +0,0 @@
-/* eslint-env node */
-
-module.exports = {
- presets: [['@babel/preset-env', { targets: { node: 'current' } }]],
- env: {
- /*
- * babel needed for jesting: Node does not support import/export;
- * .babelrc does not work here since it does not affect node_modules/ol (babel.config.js does)
- */
- test: {
- plugins: ['@babel/plugin-transform-modules-commonjs'],
- },
- },
-}
diff --git a/commitlint.config.js b/commitlint.config.js
new file mode 100644
index 0000000000..586d4ab114
--- /dev/null
+++ b/commitlint.config.js
@@ -0,0 +1,19 @@
+import { globSync } from 'node:fs'
+import { basename } from 'node:path'
+
+export default {
+ extends: ['@commitlint/config-conventional'],
+ rules: {
+ 'scope-enum': [
+ 2,
+ 'always',
+ [
+ 'arch',
+ 'release',
+ 'core',
+ ...globSync('src/plugins/*/').map((path) => basename(path)),
+ ...globSync('examples/*/').map((path) => basename(path)),
+ ],
+ ],
+ },
+}
diff --git a/docs/architecture/decisions/ADR-0001.md b/docs/architecture/decisions/ADR-0001.md
new file mode 100644
index 0000000000..8166228b14
--- /dev/null
+++ b/docs/architecture/decisions/ADR-0001.md
@@ -0,0 +1,21 @@
+# We write ADRs from now on
+
+## Status
+
+Accepted.
+
+## Context
+
+As time goes by, it becomes unclear whether architectural decisions have been made accidentally or on purpose, and, if on purpose, what the motivations were.
+
+## Decision
+
+From now on, all greater or debatable architectural decisions shall be denoted as an ADR within this document, like the "example ADR" you are currently reading. The used template is from [here](https://github.com/joelparkerhenderson/architecture-decision-record/tree/main/locales/en/templates/decision-record-template-by-michael-nygard). Also, questions arising about architecture shall be answered in such an ADR format to procude future references.
+
+If certain points change while not obsoleting the ADR as such, ADRs may be modified later.
+
+## Consequences
+
+* (+) Architecture decisions will become more transparent and understandable.
+* (+) A truth base is defined and referencable.
+* (-) Time needed for documentation.
diff --git a/docs/architecture/decisions/ADR-0002.md b/docs/architecture/decisions/ADR-0002.md
new file mode 100644
index 0000000000..9dec6f4cbe
--- /dev/null
+++ b/docs/architecture/decisions/ADR-0002.md
@@ -0,0 +1,22 @@
+# Plugin-based architecture
+
+## Status
+
+Revoked by ADR 0009.
+
+## Context
+
+With recurring requirements, a desire grows to avoid repetition and reuse components. This can be implemented with a plugin-based architecture to create new map clients and have the most common features already done.
+
+## Decision
+
+An architecture for the client has been designed that models how we get to re-use functionality without re-writing it while still being open for extensions. The following graphic explains the architecture in further detail.
+
+
+
+## Consequences
+
+* (+) Higher quality of features since multiple parties use them.
+* (+) Implement once, use multiple times.
+* (+) Parts are easier to exchange/develop, and not all clients are required to update immediately.
+* (-) More difficult to understand the codebase.
diff --git a/docs/architecture/decisions/ADR-0003.md b/docs/architecture/decisions/ADR-0003.md
new file mode 100644
index 0000000000..6a0b51c9e2
--- /dev/null
+++ b/docs/architecture/decisions/ADR-0003.md
@@ -0,0 +1,17 @@
+# Error toasts have to be dismissed manually
+
+## Status
+
+Accepted.
+
+## Context
+
+Information relevant for the user is displayed in toasts which close automatically after a custom timeout.
+
+## Decision
+
+A timeout set for toasts that contain error messages will be ignored. Such toasts can only be closed manually by clicking the close button.
+
+## Consequences
+
+* (+) The user is forced to handle error messages and thus is more aware of errors that occur.
diff --git a/docs/architecture/decisions/ADR-0004.md b/docs/architecture/decisions/ADR-0004.md
new file mode 100644
index 0000000000..95a9eb0d76
--- /dev/null
+++ b/docs/architecture/decisions/ADR-0004.md
@@ -0,0 +1,19 @@
+# Vuex mutations have no map side effects
+
+## Status
+
+Obsoleted (Vuex is replaced with Pinia).
+
+## Context
+
+OL Map interactions are usually side effects by nature, but are not asynchronous. It was unclear whether such changes belong to actions or mutations.
+
+## Decision
+
+It has been decided that map side effects do not belong to mutations, but to actions.
+
+## Consequences
+
+* (+) Mutations stay clean of side effects.
+* (+) On potential extension of such map calls, asynchronous behaviour may be required; in that case, actions are already the correct position.
+* (-) This restriction must be manually enforced.
diff --git a/docs/architecture/decisions/ADR-0005.md b/docs/architecture/decisions/ADR-0005.md
new file mode 100644
index 0000000000..af9d6cccba
--- /dev/null
+++ b/docs/architecture/decisions/ADR-0005.md
@@ -0,0 +1,24 @@
+# Difference between actions, utils and lib-packages
+
+## Status
+
+Accepted.
+
+## Context
+
+`actions`, `utils` and `lib`-packages can often consist of very similar code. It was not always clear enough where to place certain functionality, which was ultimately up to each developers own preference.
+
+## Decision
+
+When deciding on where to place code (when writing or refactoring), the following ordered list should be followed:
+
+* Does the functionality also change some part of the state? `action`
+* Should the functionality be usable outside of an integrated client? `action`
+* Does the functionality **not** have state changes, but belongs to a certain `action`? Either locally in the same file as the `action` or in a folder named after the `action` in the path `store/ACTIONNAME`
+* Does the functionality **not** have state changes, but be reusable in the plugin / core? `utils`
+* Should the functionality be reusable for multiple plugins / the core? `lib`-package
+
+## Consequences
+
+* (+) Gives clarity on where specific code fragments should reside.
+* (-) This restriction must be manually enforced.
diff --git a/docs/architecture/decisions/ADR-0006.md b/docs/architecture/decisions/ADR-0006.md
new file mode 100644
index 0000000000..44a58b73e9
--- /dev/null
+++ b/docs/architecture/decisions/ADR-0006.md
@@ -0,0 +1,20 @@
+# `console` statement standardization
+
+## Status
+
+Accepted.
+
+## Context
+
+In production environments it may seem unclear if an error or warning message is shown in the console from which part of the application they occurred.
+
+## Decision
+
+All `console.warn` and `console.error` messages have to show the application's part in which they are invoked.
+We add the location to the console messages at compile-time using Vite.
+
+## Consequences
+
+* (+) Errors and warnings can more easily be tracked back to the place in which they occur.
+* (+) This restriction is enforced automatically.
+* (-) Console messages are more verbose.
diff --git a/docs/architecture/decisions/ADR-0007.md b/docs/architecture/decisions/ADR-0007.md
new file mode 100644
index 0000000000..ebeb4eb370
--- /dev/null
+++ b/docs/architecture/decisions/ADR-0007.md
@@ -0,0 +1,19 @@
+# How to expose additional exports of a package
+
+## Status
+
+Accepted.
+
+## Context
+
+There are multiple ways of exposing additional exports of a package. They can either be exposed in the main file or configured as additional export nodes via rollup and the package.json.
+
+## Decision
+
+All exports should be exposed through the main file of the package as additional named exports.
+
+## Consequences
+
+* (+) A package consumer does not need to know additional paths to import.
+* (+) This pattern is established by most major frameworks.
+* (-) This restriction must be manually enforced.
diff --git a/docs/architecture/decisions/ADR-0008.md b/docs/architecture/decisions/ADR-0008.md
new file mode 100644
index 0000000000..d95510a4dc
--- /dev/null
+++ b/docs/architecture/decisions/ADR-0008.md
@@ -0,0 +1,19 @@
+# Configuration parameters in tables have to be ordered by a) required and b) alphabetically.
+
+## Status
+
+Accepted.
+
+## Context
+
+If a developer is reading the docs, having the configuration parameters order first by required values then alphabetically makes it easier to find relevant parameters.
+
+## Decision
+
+All docs shall be sorted as proposed.
+
+## Consequences
+
+* (+) Better readability of documentation.
+* (+) Clear placement of new parameters.
+* (-) This restriction must be manually enforced.
diff --git a/docs/architecture/decisions/ADR-0009.md b/docs/architecture/decisions/ADR-0009.md
new file mode 100644
index 0000000000..32de144d24
--- /dev/null
+++ b/docs/architecture/decisions/ADR-0009.md
@@ -0,0 +1,23 @@
+# Revoke "ADR 0002: Plugin-based architecture" regarding packaging
+
+## Status
+
+Accepted.
+
+## Context
+
+The current structure uses NPM packages so segment the codebase into reusable parts. These packages have no known outside usage and slow down development in various positions as well as make documentation and changelogs a burden. Instead of a differentiation of core, plugins, and libs, all of these parts shall reside in a single package whilst maintaining the current pluginability feature. This single package shall also offer a default modulith client with all parts readymade for instantiating that can optionally be used.
+
+If accepted, the original ADR shall gain an additional sentence linking to this ADR regarding this future change, as this won't be executed easily, in a short time, or in a single step.
+
+## Decision
+
+We will restructure the architecture as shown in the next big major version.
+
+## Consequences
+
+* (+) Easier maintenance (no superfluous changelogs, easier type access, less boilerplate, faster releases).
+* (+) Easier to understand the codebase.
+* (-) It's not possible to use different versions of packages in the same client, especially old versions.
+ * (+) We never did this anyway and it may have produced complex fix scenarios (LTS for majors?) that no longer may occur.
+* (-) We'll have to introduce technical limitations (architecture checks) regarding imports to prevent the codebase structure from degrading to spaghetti.
diff --git a/docs/architecture/decisions/ADR-0010.md b/docs/architecture/decisions/ADR-0010.md
new file mode 100644
index 0000000000..d21bbd87be
--- /dev/null
+++ b/docs/architecture/decisions/ADR-0010.md
@@ -0,0 +1,18 @@
+# Manage ADRs with Git
+
+## Status
+
+Accepted.
+
+## Context
+
+Currently, ADRs are managed in a single GitHub wiki page of POLAR.
+
+## Decision
+
+We move the ADRs to the repository in a documentation folder. We write one file per ADR.
+
+## Consequences
+
+- (+) Changes to ADRs can more comfortably be tracked via Git.
+- (o) There is more overhead in creating and updating ADRs, which may lead to writing less of them.
diff --git a/docs/architecture/decisions/ADR-0011.md b/docs/architecture/decisions/ADR-0011.md
new file mode 100644
index 0000000000..3fffb35317
--- /dev/null
+++ b/docs/architecture/decisions/ADR-0011.md
@@ -0,0 +1,28 @@
+# Split customer-specific clients into separate repositories
+
+## Status
+
+Accepted.
+
+## Context
+
+The new architecture, as introduced by ADR 0009, has a generic NPM package (@polar/polar, which replaces the packages @polar/core, @polar/lib-X, @polar/plugin-X and @polar/client-generic) and several customer-specific clients (@polar/client-X).
+
+The customer-specific clients are developed because of individual contracts and are (usually) not of major interest for other users. The maintenance of these clients is done primarily for the customers and does not contribute to the project's vision.
+
+## Decision
+
+Customer-specific clients (i.e., clients that are not the snowbox or the generic client) are moved to separate repositories (one repository per client).
+
+The new structure shall ensure that core changes can still be developed against a customer-specific client using HMR.
+
+## Consequences
+
+- (+) The repository structure is easier to understand (no monorepo).
+- (+) Rules for contributions can be different between core and clients.
+- (+) Contributors do not have to deal with customer-specific clients.
+- (+) Real-world examples for implementing your own client in your own repository are provided.
+- (+) Generating SBOMs is easier.
+- (-) Following up with updates needs to be done in different repositories.
+ - (+) However, SemVer is used and helpers such as renovate exist.
+- (o) Documentation of breaking changes including a migration guide is necessary.
diff --git a/docs/architecture/index.md b/docs/architecture/index.md
new file mode 100644
index 0000000000..456d50f5b6
--- /dev/null
+++ b/docs/architecture/index.md
@@ -0,0 +1,46 @@
+---
+title: Architecture
+---
+
+# Architecture documentation
+
+## User perspective
+When using POLAR, it behaves a simple fragment that can be used in any web-based setting.
+It may either work standalone, in which case there are only inputs for configuration, or as a part of a process, in which case there are both inputs and outputs for further processing.
+
+The purpose of POLAR is to handle all geospatial interactions of a user and utilize the decentralized geospatial infrastructure for that end.
+
+
+
+*Viewn from the outside, POLAR is just a component*
+
+## Usage examples
+POLAR is designed to increase *application efficiency* and *correctness* for the public sector, but may be used in any form process or as a standalone map client.
+The provided _visualisations_ ease communication between citizens and administrative staff, allowing them to effectively share the *where*.
+
+POLAR is already in use for ...
+
+- ... **citizens** to ...
+ - communicate parcel data in applications.
+ - mark their current position for reports.
+ - read information on water levels, bathing spots, and much other public information.
+- ... **officials in charge** to ...
+ - coordinate city services regarding reports.
+ - present governmental data to the public.
+ - manage and update department geospatial data.
+- ... **developers** to ...
+ - heavily reduce implementation time.
+ - easily use geospatial systems without domain expertise.
+ - use POLAR as component in low code platforms.
+
+## Inner architecture
+On the inside, POLAR is constructed from many smaller and isolated packages that each encapsulate a specific part of the business logic.
+These parts can be mixed and matched, and are easily replacable for situations where further extension would make them overly complicated.
+
+For client-specific business logic, this can be placed in the very client itself to prevent bloat in other parts of the product.
+
+All in all, this makes POLAR a versatile map client factory.
+
+
+
+*Viewn from the inside, POLAR is a map client factory*
diff --git a/pages/assets/iframe-resizer/LICENSE b/docs/assets/iframe-resizer/LICENSE
similarity index 100%
rename from pages/assets/iframe-resizer/LICENSE
rename to docs/assets/iframe-resizer/LICENSE
diff --git a/pages/assets/iframe-resizer/README.md b/docs/assets/iframe-resizer/README.md
similarity index 100%
rename from pages/assets/iframe-resizer/README.md
rename to docs/assets/iframe-resizer/README.md
diff --git a/pages/assets/iframe-resizer/js/iframeResizer.contentWindow.js b/docs/assets/iframe-resizer/js/iframeResizer.contentWindow.js
similarity index 100%
rename from pages/assets/iframe-resizer/js/iframeResizer.contentWindow.js
rename to docs/assets/iframe-resizer/js/iframeResizer.contentWindow.js
diff --git a/pages/assets/iframe-resizer/js/iframeResizer.js b/docs/assets/iframe-resizer/js/iframeResizer.js
similarity index 100%
rename from pages/assets/iframe-resizer/js/iframeResizer.js
rename to docs/assets/iframe-resizer/js/iframeResizer.js
diff --git a/pages/assets/landessymbole/bremen.svg b/docs/assets/landessymbole/bremen.svg
similarity index 100%
rename from pages/assets/landessymbole/bremen.svg
rename to docs/assets/landessymbole/bremen.svg
diff --git a/pages/assets/landessymbole/hamburg.svg b/docs/assets/landessymbole/hamburg.svg
similarity index 100%
rename from pages/assets/landessymbole/hamburg.svg
rename to docs/assets/landessymbole/hamburg.svg
diff --git a/pages/assets/landessymbole/sachsen-anhalt.svg b/docs/assets/landessymbole/sachsen-anhalt.svg
similarity index 100%
rename from pages/assets/landessymbole/sachsen-anhalt.svg
rename to docs/assets/landessymbole/sachsen-anhalt.svg
diff --git a/pages/assets/landessymbole/schleswig-holstein.svg b/docs/assets/landessymbole/schleswig-holstein.svg
similarity index 100%
rename from pages/assets/landessymbole/schleswig-holstein.svg
rename to docs/assets/landessymbole/schleswig-holstein.svg
diff --git a/pages/assets/landessymbole/sources.md b/docs/assets/landessymbole/sources.md
similarity index 100%
rename from pages/assets/landessymbole/sources.md
rename to docs/assets/landessymbole/sources.md
diff --git a/docs/assets/logo-polar--horizontal--dark.svg b/docs/assets/logo-polar--horizontal--dark.svg
new file mode 100644
index 0000000000..75d2cdc3a3
--- /dev/null
+++ b/docs/assets/logo-polar--horizontal--dark.svg
@@ -0,0 +1,3 @@
+
diff --git a/docs/assets/logo-polar--horizontal.svg b/docs/assets/logo-polar--horizontal.svg
new file mode 100644
index 0000000000..64f8e0879d
--- /dev/null
+++ b/docs/assets/logo-polar--horizontal.svg
@@ -0,0 +1,3 @@
+
diff --git a/docs/assets/logo-polar.svg b/docs/assets/logo-polar.svg
new file mode 100644
index 0000000000..0c8a1effb1
--- /dev/null
+++ b/docs/assets/logo-polar.svg
@@ -0,0 +1,41 @@
+
+
diff --git a/pages/assets/manypixels-decentralized.svg b/docs/assets/manypixels-decentralized.svg
similarity index 100%
rename from pages/assets/manypixels-decentralized.svg
rename to docs/assets/manypixels-decentralized.svg
diff --git a/pages/assets/manypixels-legal.svg b/docs/assets/manypixels-legal.svg
similarity index 100%
rename from pages/assets/manypixels-legal.svg
rename to docs/assets/manypixels-legal.svg
diff --git a/pages/assets/manypixels-map.svg b/docs/assets/manypixels-map.svg
similarity index 100%
rename from pages/assets/manypixels-map.svg
rename to docs/assets/manypixels-map.svg
diff --git a/pages/assets/manypixels-mobile.svg b/docs/assets/manypixels-mobile.svg
similarity index 100%
rename from pages/assets/manypixels-mobile.svg
rename to docs/assets/manypixels-mobile.svg
diff --git a/pages/assets/manypixels-puzzle.svg b/docs/assets/manypixels-puzzle.svg
similarity index 100%
rename from pages/assets/manypixels-puzzle.svg
rename to docs/assets/manypixels-puzzle.svg
diff --git a/pages/assets/maps_pin.jpg b/docs/assets/maps_pin.jpg
similarity index 100%
rename from pages/assets/maps_pin.jpg
rename to docs/assets/maps_pin.jpg
diff --git a/pages/assets/polar-architecture.png b/docs/assets/polar-architecture.png
similarity index 100%
rename from pages/assets/polar-architecture.png
rename to docs/assets/polar-architecture.png
diff --git a/pages/assets/polar-outer-architecture.png b/docs/assets/polar-outer-architecture.png
similarity index 100%
rename from pages/assets/polar-outer-architecture.png
rename to docs/assets/polar-outer-architecture.png
diff --git a/pages/assets/polar_example_screenshot.png b/docs/assets/polar_example_screenshot.png
similarity index 100%
rename from pages/assets/polar_example_screenshot.png
rename to docs/assets/polar_example_screenshot.png
diff --git a/pages/assets/productive-users/dataport-logo.svg b/docs/assets/productive-users/dataport-logo.svg
similarity index 100%
rename from pages/assets/productive-users/dataport-logo.svg
rename to docs/assets/productive-users/dataport-logo.svg
diff --git a/pages/assets/productive-users/hamburg-logo.svg b/docs/assets/productive-users/hamburg-logo.svg
similarity index 100%
rename from pages/assets/productive-users/hamburg-logo.svg
rename to docs/assets/productive-users/hamburg-logo.svg
diff --git a/pages/assets/productive-users/schleswig-holstein-logo.svg b/docs/assets/productive-users/schleswig-holstein-logo.svg
similarity index 100%
rename from pages/assets/productive-users/schleswig-holstein-logo.svg
rename to docs/assets/productive-users/schleswig-holstein-logo.svg
diff --git a/pages/assets/productive-users/sources.md b/docs/assets/productive-users/sources.md
similarity index 100%
rename from pages/assets/productive-users/sources.md
rename to docs/assets/productive-users/sources.md
diff --git a/docs/assets/sources.md b/docs/assets/sources.md
new file mode 100644
index 0000000000..fe18c53140
--- /dev/null
+++ b/docs/assets/sources.md
@@ -0,0 +1,6 @@
+| File | Source |
+| --------------------------- | ------------------------------------------------------------------------------------------- |
+| logo-polar.svg and variants | designed by POLAR UI/UX |
+| manypixels-\*.svg | https://www.manypixels.co/ |
+| maps_pin.jpg | https://unsplash.com/de/fotos/person-die-eine-rote-runde-medikamentenpille-halt-Z8UgB80_46w |
+| polar-\*-architecture.png | self-made |
diff --git a/docs/configuration.md b/docs/configuration.md
new file mode 100644
index 0000000000..d022a90563
--- /dev/null
+++ b/docs/configuration.md
@@ -0,0 +1,21 @@
+---
+title: Configuration
+---
+
+# Configuration
+About configuration, integration, and common use cases.
+
+## Client documentation
+For special usecases, there are specialized clients based on POLAR.
+
+The following specialized clients are managed by the POLAR core team:
+- [Style preview documentation ↗](https://dataport.github.io/polar-client-style-preview)
+
+Not sure where to start?
+Use the package @polar/polar and its documentation for an unspecialized client _including all plugins_.
+
+## Usage pattern
+All clients come with instructions documented above. However, they all mostly share how their integration works. Overall, these parts are required:
+
+- *TODO*
+
diff --git a/docs/contact.md b/docs/contact.md
new file mode 100644
index 0000000000..138bb4415b
--- /dev/null
+++ b/docs/contact.md
@@ -0,0 +1,6 @@
+---
+title: Contact
+---
+
+# Contact
+Mail us at polar@dataport.de
diff --git a/docs/development.md b/docs/development.md
new file mode 100644
index 0000000000..c023334849
--- /dev/null
+++ b/docs/development.md
@@ -0,0 +1,35 @@
+---
+title: Development
+---
+
+# Development
+
+Hint:
+Developing yourself is optional.
+POLAR supplies ready-made clients for many use cases, and you may commission us to write additional features.
+
+## Where to code
+POLAR clients run everywhere.
+To develop plugins and clients anew, a certain setup is required.
+To avoid redoing it, it is advised to create additional plugins and clients in a fork of the project.
+
+There are no further requirements.
+If you aim to merge back, please contact us before starting to put in work.
+
+TODO: Update this section, especially for clients
+
+## Required skills
+Depending on what exactly you plan to write anew, the required skills may vary.
+POLAR is a purely front-end solution and as such general knowledge about web development is advisable.
+
+We are especially writing the client with the following libraries, to which additional knowledge is helpful for contributions.
+
+ *OpenLayers*
+
+ *Vue*
+
+ *Vuex*
+
+ *TypeScript*
+
+ *SCSS*
diff --git a/docs/index.md b/docs/index.md
new file mode 100644
index 0000000000..5aad09f527
--- /dev/null
+++ b/docs/index.md
@@ -0,0 +1,11 @@
+---
+title: Introduction
+---
+
+# What is POLAR?
+
+POLAR is ...
+
+* ... a configurable map client package.
+* ... a flexible map client factory.
+* ... an extensible library.
diff --git a/docs/legal-notice.md b/docs/legal-notice.md
new file mode 120000
index 0000000000..a4ef2b2e5a
--- /dev/null
+++ b/docs/legal-notice.md
@@ -0,0 +1 @@
+../LEGALNOTICE.md
\ No newline at end of file
diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
new file mode 100644
index 0000000000..d784b755f5
--- /dev/null
+++ b/docs/troubleshooting.md
@@ -0,0 +1,9 @@
+---
+title: Troubleshooting
+---
+
+## Common pitfalls
+
+### Map is not displayed
+
+- For Safari on iPadOS: Are the options "Advanced tracking protections" and "blocking of all cookies" enabled? If so, disable them and try again.
\ No newline at end of file
diff --git a/eslint.config.ts b/eslint.config.ts
new file mode 100644
index 0000000000..edd4ccbdd7
--- /dev/null
+++ b/eslint.config.ts
@@ -0,0 +1,243 @@
+import mainConfig from '@dataport/eslint-config-geodev'
+import browserConfig from '@dataport/eslint-config-geodev/browser'
+import htmlConfig from '@dataport/eslint-config-geodev/html'
+import jsonConfig from '@dataport/eslint-config-geodev/json'
+import markdownConfig from '@dataport/eslint-config-geodev/markdown'
+import tsConfig from '@dataport/eslint-config-geodev/typescript'
+import vueConfig from '@dataport/eslint-config-geodev/vue'
+import importPlugin from 'eslint-plugin-import'
+import perfectionist from 'eslint-plugin-perfectionist'
+import prettierConfig from 'eslint-plugin-prettier/recommended'
+import vue from 'eslint-plugin-vue'
+import { defineConfig } from 'eslint/config'
+
+import local from './eslintRules/index.js'
+
+/**
+ * POLAR-specific ESLint configuration
+ */
+const polarConfig = defineConfig({
+ plugins: {
+ import: importPlugin,
+ perfectionist,
+ vue,
+ local,
+ },
+ rules: {
+ 'prettier/prettier': 'error',
+
+ // Re-enable rules that are disabled by prettier but do not collide
+ curly: ['error', 'all'],
+
+ // POLAR-specific rules
+ 'no-warning-comments': 'warn',
+ 'no-void': 'off',
+ '@stylistic/lines-around-comment': [
+ 'error',
+ {
+ beforeBlockComment: true,
+ allowBlockStart: true,
+ allowObjectStart: true,
+ allowArrayStart: true,
+ allowClassStart: true,
+ allowEnumStart: true,
+ allowInterfaceStart: true,
+ allowModuleStart: true,
+ allowTypeStart: true,
+ },
+ ],
+ 'import-x/order': 'off',
+ 'import/consistent-type-specifier-style': ['error', 'prefer-top-level'],
+ 'perfectionist/sort-imports': [
+ 'error',
+ {
+ groups: [
+ 'type-import',
+ { newlinesBetween: 0 },
+ 'type-internal',
+ { newlinesBetween: 0 },
+ 'type-parent',
+ { newlinesBetween: 0 },
+ 'type-sibling',
+ { newlinesBetween: 0 },
+ 'type-index',
+ ['value-builtin', 'value-external'],
+ 'value-internal',
+ ['value-parent', 'value-sibling', 'value-index'],
+ 'ts-equals-import',
+ 'unknown',
+ ],
+ },
+ ],
+ 'perfectionist/sort-named-imports': 'error',
+ 'vue/html-self-closing': [
+ 'error',
+ {
+ html: {
+ void: 'always',
+ },
+ },
+ ],
+ 'local/import-style': 'error',
+ },
+})
+
+/**
+ * POLAR-specific TypeScript ESLint configuration
+ */
+const polarTsConfig = defineConfig({
+ rules: {
+ // Relaxed rules
+ '@typescript-eslint/no-unsafe-argument': 'off',
+ '@typescript-eslint/no-unsafe-assignment': 'off',
+ '@typescript-eslint/no-unsafe-call': 'off',
+ '@typescript-eslint/no-unsafe-member-access': 'off',
+ '@typescript-eslint/no-unsafe-return': 'off',
+ '@typescript-eslint/restrict-template-expressions': [
+ 'error',
+ {
+ allowAny: true,
+ allowNumber: true,
+ },
+ ],
+
+ // POLAR-specific rules
+ 'perfectionist/sort-interfaces': [
+ 'error',
+ {
+ type: 'natural',
+ groups: ['required-member', 'unknown'],
+ },
+ ],
+ '@typescript-eslint/consistent-type-imports': [
+ 'error',
+ {
+ disallowTypeAnnotations: true,
+ fixStyle: 'separate-type-imports',
+ prefer: 'type-imports',
+ },
+ ],
+ },
+})
+
+/**
+ * POLAR-specific Vue ESLint configuration
+ */
+const polarVueConfig = defineConfig({
+ rules: {
+ // POLAR-specific rules
+ 'vue/no-empty-component-block': 'error',
+ 'vue/block-order': [
+ 'error',
+ {
+ order: ['template', 'script', 'style'],
+ },
+ ],
+ 'vue/block-lang': [
+ 'error',
+ {
+ template: {
+ allowNoLang: true,
+ },
+ script: {
+ lang: 'ts',
+ },
+ style: {
+ allowNoLang: true,
+ },
+ },
+ ],
+ 'vue/component-api-style': ['error', ['script-setup', 'composition']],
+ 'vue/require-default-export': 'error',
+ 'vue/enforce-style-attribute': ['error', { allow: ['scoped'] }],
+ },
+})
+
+/**
+ * POLAR-specific HTML ESLint configuration
+ */
+const polarHtmlConfig = defineConfig({
+ rules: {
+ // POLAR-specific rules
+ '@html-eslint/require-closing-tags': ['error', { selfClosing: 'always' }],
+ '@html-eslint/no-extra-spacing-attrs': [
+ 'error',
+ { enforceBeforeSelfClose: true },
+ ],
+ },
+})
+
+export default defineConfig([
+ {
+ ignores: [
+ 'vue2/',
+ 'node_modules/',
+ 'docs/assets/',
+ 'docs-html/',
+ '.vscode/',
+ '**/dist/**',
+ '**/.dist.preview/**',
+
+ // Legacy list
+ '**/build',
+ '**/.cache',
+ '**/coverage',
+ '**/tests_output',
+ '*.d.ts',
+ '.nx/',
+ ],
+ },
+ {
+ files: ['**/*.js', '**/*.mjs', '**/*.cjs'],
+ extends: [mainConfig, browserConfig, prettierConfig, polarConfig],
+ },
+ {
+ files: ['**/*.ts'],
+ extends: [
+ mainConfig,
+ browserConfig,
+ tsConfig,
+ prettierConfig,
+ polarConfig,
+ polarTsConfig,
+ ],
+ },
+ {
+ files: ['**/eslint.config.ts'],
+ rules: {
+ '@typescript-eslint/naming-convention': 'off',
+ },
+ },
+ {
+ files: ['**/*.vue'],
+ extends: [
+ mainConfig,
+ browserConfig,
+ tsConfig,
+ vueConfig,
+ prettierConfig,
+ polarConfig,
+ polarTsConfig,
+ polarVueConfig,
+ ],
+ },
+ {
+ files: ['**/examples/**/*.vue'],
+ rules: {
+ 'vue/enforce-style-attribute': ['error', { allow: ['scoped', 'module'] }],
+ },
+ },
+ {
+ files: ['**/*.json'],
+ ignores: ['package-lock.json'],
+ extends: [jsonConfig],
+ },
+ {
+ files: ['**/*.md'],
+ extends: [markdownConfig],
+ },
+ {
+ files: ['**/*.html'],
+ extends: [htmlConfig, polarHtmlConfig],
+ },
+])
diff --git a/eslintRules/import-style.ts b/eslintRules/import-style.ts
new file mode 100644
index 0000000000..a376175c2d
--- /dev/null
+++ b/eslintRules/import-style.ts
@@ -0,0 +1,201 @@
+import type { Rule } from 'eslint'
+
+import path from 'node:path'
+
+/**
+ * Returns the context key for a path that is already relative to srcRoot.
+ *
+ * Contexts:
+ * - "core" → src/core/**
+ * - "plugins/" → src/plugins//**
+ * - "lib/" → src/lib//**
+ * - "components/" → src/components//**
+ * - null → everything else (no context)
+ */
+function getContext(srcRelPath: string): string | null {
+ const parts = srcRelPath.split('/')
+ if (parts[0] === 'core') {
+ return 'core'
+ }
+ if (parts[0] === 'plugins' && parts.length > 1) {
+ return `plugins/${parts[1]}`
+ }
+ if (parts[0] === 'lib' && parts.length > 1) {
+ return `lib/${parts[1]}`
+ }
+ if (parts[0] === 'components' && parts.length > 1) {
+ return `components/${parts[1]}`
+ }
+ return null
+}
+
+/**
+ * Resolves an import specifier to a path that is relative to srcRoot.
+ * Handles both `@/…` (alias) and relative (`./`, `../`) specifiers.
+ * Returns null when the specifier is external or resolves outside srcRoot.
+ */
+function resolveToSrcRel(
+ importPath: string,
+ currentSrcRel: string,
+ srcRoot: string
+): string | null {
+ let abs: string
+ if (importPath.startsWith('@/')) {
+ abs = path.join(srcRoot, importPath.slice(2))
+ } else if (importPath.startsWith('.')) {
+ abs = path.resolve(
+ path.join(srcRoot, path.dirname(currentSrcRel)),
+ importPath
+ )
+ } else {
+ return null
+ }
+ const rel = path.relative(srcRoot, abs).replace(/\\/g, '/')
+ return rel.startsWith('..') ? null : rel
+}
+
+/**
+ * Enforces POLAR import style conventions:
+ *
+ * 1. `.ts` extensions must be omitted in import/export sources.
+ * 2. Same-context imports must use relative paths (`./` or `../`).
+ * 3. Cross-context or context-less imports must use the `@/…` alias.
+ *
+ * A "context" is one of:
+ * - `core` for every file inside `src/core/`
+ * - `plugins/` for every file inside `src/plugins//`
+ * - `lib/` for every file inside `src/lib//`
+ * - `components/` for every file inside `src/components//`
+ * - (none) for all other files
+ *
+ * Files outside `srcDir` (default `"src"`) are ignored.
+ *
+ * @example rule options { srcDir: "src" }
+ */
+const importStyle: Rule.RuleModule = {
+ meta: {
+ type: 'suggestion',
+ fixable: 'code',
+ schema: [
+ {
+ type: 'object',
+ properties: {
+ srcDir: { type: 'string' },
+ },
+ additionalProperties: false,
+ },
+ ],
+ messages: {
+ wrongPath: 'Import path "{{ actual }}" should be "{{ expected }}".',
+ },
+ },
+
+ create(context) {
+ const srcDirOption: string = context.options[0]?.srcDir ?? 'src'
+ const srcRoot = path.resolve(context.cwd, srcDirOption)
+
+ const currentSrcRel = path
+ .relative(srcRoot, path.resolve(context.filename))
+ .replace(/\\/g, '/')
+
+ // File is outside srcRoot — skip entirely
+ if (currentSrcRel.startsWith('..')) {
+ return {}
+ }
+
+ const currentCtx = getContext(currentSrcRel)
+
+ function check(sourceNode: { value?: unknown; raw?: string }) {
+ if (typeof sourceNode.value !== 'string') {
+ return
+ }
+
+ const raw = sourceNode.value
+
+ // Only handle project-internal specifiers
+ if (!raw.startsWith('@/') && !raw.startsWith('.')) {
+ return
+ }
+
+ // Always strip the .ts extension
+ const withoutExt = raw.endsWith('.ts') ? raw.slice(0, -3) : raw
+
+ // Resolve to a srcRoot-relative path for context comparison
+ const targetSrcRel = resolveToSrcRel(withoutExt, currentSrcRel, srcRoot)
+
+ if (targetSrcRel === null) {
+ // Cannot resolve within src (edge case) — only fix extension
+ if (withoutExt !== raw) {
+ // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+ const q = sourceNode.raw![0]
+ context.report({
+ node: sourceNode as Rule.Node,
+ messageId: 'wrongPath',
+ data: { actual: raw, expected: withoutExt },
+ fix: (fixer) =>
+ fixer.replaceText(
+ sourceNode as Rule.Node,
+ `${q}${withoutExt}${q}`
+ ),
+ })
+ }
+ return
+ }
+
+ const targetCtx = getContext(targetSrcRel)
+
+ // Determine the canonical form of this import
+ let expected: string
+
+ if (currentCtx !== null && currentCtx === targetCtx) {
+ // Same context → relative path (no @/ alias)
+ const currentDir = path.join(srcRoot, path.dirname(currentSrcRel))
+ const targetAbs = path.join(srcRoot, targetSrcRel)
+ let rel = path.relative(currentDir, targetAbs).replace(/\\/g, '/')
+ if (rel === '') {
+ // The target file's extension-stripped path is identical to the
+ // current file's directory. This happens when a file imports a
+ // sibling file whose name matches its own folder, e.g. importing
+ // `../types.ts` from a file inside a folder named `types`.
+ rel = `../${path.basename(targetAbs)}`
+ } else if (!rel.startsWith('.')) {
+ rel = `./${rel}`
+ }
+ expected = rel
+ } else {
+ // Cross-context or no context → alias
+ expected = `@/${targetSrcRel}`
+ }
+
+ if (raw !== expected) {
+ // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+ const q = sourceNode.raw![0]
+ context.report({
+ node: sourceNode as Rule.Node,
+ messageId: 'wrongPath',
+ data: { actual: raw, expected },
+ fix: (fixer) =>
+ fixer.replaceText(sourceNode as Rule.Node, `${q}${expected}${q}`),
+ })
+ }
+ }
+
+ return {
+ /* eslint-disable @typescript-eslint/naming-convention */
+ ImportDeclaration(node) {
+ check(node.source)
+ },
+ ExportAllDeclaration(node) {
+ check(node.source)
+ },
+ ExportNamedDeclaration(node) {
+ if (node.source) {
+ check(node.source)
+ }
+ },
+ /* eslint-enable @typescript-eslint/naming-convention */
+ }
+ },
+}
+
+export default importStyle
diff --git a/eslintRules/index.ts b/eslintRules/index.ts
new file mode 100644
index 0000000000..427b1eac92
--- /dev/null
+++ b/eslintRules/index.ts
@@ -0,0 +1,9 @@
+import importStyle from './import-style.js'
+
+export default {
+ rules: {
+ /* eslint-disable @typescript-eslint/naming-convention */
+ 'import-style': importStyle,
+ /* eslint-enable @typescript-eslint/naming-convention */
+ },
+}
diff --git a/examples/generic/index.html b/examples/generic/index.html
new file mode 100644
index 0000000000..9550af4d23
--- /dev/null
+++ b/examples/generic/index.html
@@ -0,0 +1,66 @@
+
+
+
+ Generic POLAR client
+
+
+
+
+
+
+
+
+
+
+ Get started in minutes with POLAR's intuitive API. Our framework is
+ designed to make complex mapping tasks simple while giving you full
+ control when you need it.
+
-
-
-
-
-
diff --git a/packages/clients/dish/src/plugins/DishExportMap/README.md b/packages/clients/dish/src/plugins/DishExportMap/README.md
deleted file mode 100644
index 044c8539af..0000000000
--- a/packages/clients/dish/src/plugins/DishExportMap/README.md
+++ /dev/null
@@ -1,52 +0,0 @@
-# DishExportMap
-
-DishExportMap is a plugin that was created specifically for the internal use of the DISH client. It creates a URL to address a backend that triggeres a PDF print with information about a selected monument and a map section centering on the selected monument.
-
-The original print feature was part of the outdated map in the internal DISH software, so the focus was on recreating the old feature and implement it in the polar client. The backend expects specific values and does not leave much room for different configurations which is the reason for a lot of hardcoded values. Due to missing documentation of the original feature, it is not always clear as to why some values must be set or what their meaning is. The URL has to be composed in a certain way to address the backend so that the print works successfully.
-
-## Plugin Configuration
-
-The following parameters for the plugin must be defined in the map configuration. As to this moment, most of these should not be changed due to the restricted backend.
-
-| parameter name | type | description |
-| - | - | - |
-| printApproach | string | No description available. |
-| printRequester | string | No description available. |
-| xPrint | number | No description available. |
-| yPrint | number | No description available. |
-| VersionHintergrund | string | Version for background service. |
-| LayerNameWMS | string | Layers from the WMS to print. Since they differ from the monument configuration, they are hardcoded and taken from the configuration of the original application to recreate the right look for the map section. |
-| VersionWFS | string | Version for WFS. |
-| PropertyNameWFS | string | No description available. |
-| FilterTypeWFS | string | No description available. |
-| PrintImageURL | internalHost + '/Content/MapsTmp' | Probably the URL to the created map section. The internalHost is set in the urlParams. |
-| PrintImagePath | string | Probably the relative path to the created map section. |
-| urlParams | DishUrlParams | These parameters are needed to create the url to the backend and the default layer urls. The urlParams should be set in the `createMap` call. |
-
-### example configuration
-
-```js
-dishExportMap: {
- printApproach: 'scale',
- printRequester: 'client',
- xPrint: 18,
- yPrint: 20,
- versionHintergrund: '1.1.1' // ⚠️ Do not change
- proxyHintergrund: 'y',
- versionWMS: '1.1.1',
- layerNameWMS:
- '0,9,1,10,2,11,3,12,4,13,25,27,24,26,6,15,19,30,20,31,21,32,22,33,23,34,29,36,28,35',
- versionWFS: '1.1.0' // ⚠️ Do not change
- propertyNameWFS: 'objektid',
- filterTypeWFS: 'EQUAL_TO',
- printImagePath: 'ContentMapsTmp',
- urlParams: {
- internalHost: 'http://10.61.63.54',
- internServicesBaseUrl: 'http://10.61.63.54:8081/dish-deegree-3.5.0/services'
- },
-},
-```
-
-## Usage
-
-The user selects a feature from the monument WMS within the map that they want to print as a pdf. This selection activates the button "Kartendruck PDF". After pressing the button, a dialog with the editable title for the PDF and a rectangular overlay to show the extent for the map section is displayed. If the user confirms with pressing "Karte drucken", the browser opens a new tab while addressing the backend with the composed URL. The PDF-to-print is shown in this new browser tab.
\ No newline at end of file
diff --git a/packages/clients/dish/src/plugins/Modal/HintsIntern.vue b/packages/clients/dish/src/plugins/Modal/HintsIntern.vue
deleted file mode 100644
index e84cb91bc6..0000000000
--- a/packages/clients/dish/src/plugins/Modal/HintsIntern.vue
+++ /dev/null
@@ -1,52 +0,0 @@
-
-
-
- Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
- eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
- voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet
- clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit
- amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam
- nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed
- diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum.
- Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
- sit amet.
-
-
- Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
- eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
- voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet
- clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit
- amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam
- nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed
- diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum.
- Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor
- sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed
- diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam
- erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea
- rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum
- dolor sit amet. Duis autem vel eum iriure dolor in hendrerit in vulputate
- velit esse molestie consequat, vel illum dolore eu feugiat nulla facilisis
- at vero eros et accumsan et iusto odio dignissim qui blandit praesent
- luptatum zzril delenit augue duis dolore te feugait nulla facilisi. Lorem
- ipsum dolor sit amet,
-
-
-
-
-
-
diff --git a/packages/clients/dish/src/plugins/Modal/locales.ts b/packages/clients/dish/src/plugins/Modal/locales.ts
deleted file mode 100644
index ab7763c53a..0000000000
--- a/packages/clients/dish/src/plugins/Modal/locales.ts
+++ /dev/null
@@ -1,53 +0,0 @@
-import { Locale } from '@polar/lib-custom-types'
-
-export const dishModalDe = {
- modal: {
- welcome: {
- header: 'Willkommen in der Denkmalkarte Schleswig-Holstein',
- landesdachmarkeAlt:
- 'Logo der Landesdachmarke "Schleswig-Holstein. Der echte Norden."',
- p1: 'Kulturdenkmale sind gesetzlich geschützt, und nachrichtlich in ein Verzeichnis, die sogenannte Denkmalliste, aufzunehmen. Die Denkmaleigenschaft ist nicht von der Eintragung in die Denkmalliste, oder von der Darstellung in der Denkmalkarte abhängig. Auch Objekte, die nicht hier verzeichnet sind, können als Kulturdenkmale kraft Gesetz (Ipsa Lege) geschützt sein, wenn sie die gesetzlichen Kriterien für die Denkmaleigenschaft erfüllen.',
- p2: 'In der Denkmalkarte werden Kulturdenkmale in der Zuständigkeit des Landesamtes für Denkmalpflege Schleswig-Holstein (Baudenkmale, Gründenkmale, Schutzzonen vom Typ Denkmalbereich) dargestellt, mit Ausnahme der Hansestadt Lübeck.',
- p3: 'Die Darstellungen in der Denkmalkarte haben informatorischen Charakter. Sie sind nicht rechtsverbindlich. Für tagesaktuelle, rechtsverbindliche Auskünfte wenden Sie sich bitte an:',
- link1: 'Landesamt für Denkmalpflege Schleswig-Holstein',
- link2: 'Planungs- und Genehmigungsverfahren',
- p4: 'Die Nutzung der Denkmalkarte ersetzt nicht die förmliche Beteiligung der jeweils zuständigen Denkmalbehörde in',
- confirmRead:
- 'Hiermit bestätige ich, dass ich die Informationen zur Kenntnis genommen habe.',
- closeInfo: "Los geht's!",
- },
- hints: {
- mainTitle: 'Denkmalkarte Schleswig-Holstein',
- title: 'Benutzungshinweise',
- subTitle: 'Allgemeine Informationen',
- },
- hintsIntern: {
- mainTitle: 'Interne Denkmalkarte Schleswig-Holstein',
- },
- },
-} as const
-
-const locales: Locale[] = [
- {
- type: 'de',
- resources: {
- plugins: {
- dish: {
- ...dishModalDe,
- },
- },
- },
- },
- {
- type: 'en',
- resources: {
- plugins: {
- dish: {
- modal: {},
- },
- },
- },
- },
-]
-
-export default locales
diff --git a/packages/clients/dish/src/polar-client.ts b/packages/clients/dish/src/polar-client.ts
deleted file mode 100644
index 6424ca66af..0000000000
--- a/packages/clients/dish/src/polar-client.ts
+++ /dev/null
@@ -1,119 +0,0 @@
-/* eslint-disable @typescript-eslint/naming-convention */
-import client, { MapInstance } from '@polar/core'
-import merge from 'lodash.merge'
-import { getWfsFeatures } from '@polar/lib-get-features'
-import { getPointCoordinate } from '@polar/plugin-pins'
-import { Feature } from 'ol'
-import { FeatureCollection, Geometry, GeometryCollection } from 'geojson'
-import { GeoJSON } from 'ol/format'
-import packageInfo from '../package.json'
-import { navigateToDenkmal } from './utils/navigateToDenkmal'
-import { addPlugins } from './addPlugins'
-import { services } from './services'
-import { getMapConfiguration } from './mapConfigurations/mapConfig'
-import { CONTENT_ENUM } from './plugins/Modal/store'
-import './styles.css'
-import selectionLayer from './selectionLayer'
-import { DishUrlParams } from './types'
-// eslint-disable-next-line no-console
-console.log(`DISH map client running in version ${packageInfo.version}.`)
-
-export default {
- createMap: async ({ containerId, mode, urlParams, configOverride }) => {
- addPlugins(client, mode)
- const layerConf = services(mode, urlParams)
- const mapConfiguration = getMapConfiguration(mode, urlParams)
-
- const map = await client.createMap({
- containerId,
- mapConfiguration: merge(
- {
- ...mapConfiguration,
- layerConf,
- },
- configOverride || {}
- ),
- })
- const parameters = new URL(document.location as unknown as string)
- .searchParams
- // using naming from backend to avoid multiple names for same thing
- const objektId = parameters.get('ObjektID')
- if (mode === 'INTERN') {
- subscribeToExportedMap(map)
- map.$store.commit('plugin/selectionObject/setObjectId', objektId)
- if (typeof objektId === 'string') {
- zoomToInternalFeature(map, objektId, urlParams)
- }
- } else if (typeof objektId === 'string' && mode === 'EXTERN') {
- navigateToDenkmal(map, objektId)
- }
- if (mode === 'EXTERN') {
- map.$store.commit('plugin/modal/setClosed', false)
- }
- // @ts-expect-error | intentionally expand window; no environment affected
- window.openBenutzungshinweise = function (isIntern = false) {
- map.$store.commit(
- 'plugin/modal/setContent',
- isIntern ? CONTENT_ENUM.HINTSINTERN : CONTENT_ENUM.HINTS
- )
- map.$store.commit('plugin/modal/setClosed', false)
- }
- },
-}
-
-function subscribeToExportedMap(instance: MapInstance) {
- instance.subscribe('plugin/export/exportedMap', (screenshot) => {
- if (screenshot) {
- const newWindow = window.open()
- newWindow?.document.write(
- `Kartenausgabe`
- )
- }
- })
-}
-
-function zoomToInternalFeature(
- instance: MapInstance,
- objektId: string,
- urlParams: DishUrlParams
-) {
- getWfsFeatures(null, `${urlParams.internServicesBaseUrl}/wfs`, objektId, {
- fieldName: 'objektid',
- featurePrefix: 'app',
- typeName: 'TBLGIS_ORA',
- xmlns: 'http://www.deegree.org/app',
- useRightHandWildcard: false,
- })
- .then((featureCollection: FeatureCollection) => {
- const { features } = featureCollection
- if (features.length === 0) {
- throw Error(`No features for ID ${objektId} found.`)
- }
- if (features.length > 1) {
- console.warn(
- `@polar/client-dish: More than one feature found for id ${objektId}. Arbitrarily using first-returned.`
- )
- }
- const feature = features[0]
- const geometry = feature.geometry as Exclude
- const centerCoord = getPointCoordinate(
- 'EPSG:25832',
- 'EPSG:25832',
- geometry.type,
- geometry.coordinates
- )
- instance.$store.getters.map.getView().setCenter(centerCoord)
- instance.$store.getters.map.getView().setZoom(9)
- selectionLayer
- .getSource()
- ?.addFeature(new GeoJSON().readFeature(feature) as Feature)
- instance.$store.getters.map.addLayer(selectionLayer)
- })
- .catch((error) => {
- console.error('@polar/client-dish', error)
- instance.$store.dispatch('plugin/toast/addToast', {
- type: 'warning',
- text: 'dish.idNotFound',
- })
- })
-}
diff --git a/packages/clients/dish/src/types.ts b/packages/clients/dish/src/types.ts
deleted file mode 100644
index 7af82a5688..0000000000
--- a/packages/clients/dish/src/types.ts
+++ /dev/null
@@ -1,137 +0,0 @@
-// naming convention doesn't hold since backend names are used in Beschreibung
-/* eslint-disable @typescript-eslint/naming-convention */
-
-import { FeatureCollection, GeometryObject } from 'geojson'
-import {
- AddressSearchConfiguration,
- MapConfig,
- QueryParameters,
- PluginOptions,
- RenderType,
-} from '@polar/lib-custom-types'
-
-/* Search backend documentation:
- * https://efi2.schleswig-holstein.de/dish/dish_service/help.html
- */
-
-/** as specified by efi search backend */
-export interface EfiSearchFeature {
- Date: string | null
- anriss: string
- beschreibung: string // not yet parsed
- index: number
- link: string
- linkText: string
- rating: string
- titel: '' // always empty string ✨
-}
-
-/** as specified by efi information backend */
-export interface EfiBeschreibung {
- Wert: string
- ObjektID: string
- objektansprache: string
- Kreis: string
- Gemeinde: string
- wohnplatz: string
- strasse: string
- objektart: string
- objektfunktion: string
- objektplz: string
- tbldlisteinaKurzBeschreibungen: string
- tbldlisteinaBeschreibungen: string
-}
-
-/** after beschreibung is parsed ... */
-export interface ParsedEfiSearchFeature
- extends Omit {
- beschreibung: EfiBeschreibung
- geometry?: GeometryObject
-}
-
-/** used for wfs sub-configuration of dish search */
-export interface WfsConfiguration {
- id: string
- srsName: string
- typeName: string
- fieldName: string
- featurePrefix: string
- xmlns: string
-}
-
-export interface DishParameters extends QueryParameters {
- searchKey: string
- wfsConfiguration: WfsConfiguration
- // topic: EfiTopic
- addRightHandWildcard: boolean
- volltexttyp?: 'CONTAINS' | 'FREETEXT'
-}
-
-export type DishAutocompleteFunction = (
- signal: AbortSignal,
- url: string,
- inputValue: string
-) => Promise
-
-export interface DishFeaturePropertiesOnSuccess {
- Bezeichnung: string // ehem. "Name"
- Foto: string
- Kreis: string
- Gemeinde: string
- PLZ: string
- Straße: string
- Objektnummer: string
- Detailinformationen: string
- Export: string
-}
-
-export interface DishFeaturePropertiesOnError {
- Information: string
-}
-
-export type DishFeatureProperties =
- | DishFeaturePropertiesOnSuccess
- | DishFeaturePropertiesOnError
-
-export interface ModalState {
- confirmed: boolean
- closed: boolean
- content: number
-}
-
-export interface DishUrlParams {
- internalHost: string
- internServicesBaseUrl: string
-}
-
-export interface DishMapConfig
- extends Omit {
- addressSearch: AddressSearchConfiguration
- dishModal?: {
- isInternMap: boolean
- }
- dishExportMap?: {
- printApproach: string
- printRequester: string
- xPrint: number
- yPrint: number
- versionHintergrund: string
- proxyHintergrund: string
- versionWMS: string
- layerNameWMS: string
- versionWFS: string
- propertyNameWFS: string
- filterTypeWFS: string
- printImagePath: string
- urlParams: DishUrlParams
- }
-}
-
-export interface SelectionObjectState {
- objectId: string
-}
-
-export interface SelectionObjectOptions extends PluginOptions {
- renderType?: RenderType
- targetContainerId?: string
-}
diff --git a/packages/clients/generic/API.md b/packages/clients/generic/API.md
deleted file mode 100644
index abf55fb6a3..0000000000
--- a/packages/clients/generic/API.md
+++ /dev/null
@@ -1,69 +0,0 @@
-# Generic MapClient API 🗺️ `@polar/client-generic`
-
-This client is based on [POLAR](https://github.com/Dataport/polar) and subsequently the [masterportalAPI](https://bitbucket.org/geowerkstatt-hamburg/masterportalapi/src/master/). The following documentation only contains how this specific client can be used, and the minimal information required to get it running.
-
-For all additional details, check the [full documentation](https://dataport.github.io/polar/docs/generic/client-generic.html).
-
-For the development test deployments and example configurations, [see here](https://dataport.github.io/polar#plugin-gallery).
-
-For a minimum working example, [see here](https://github.com/dopenguin/polar-fossgis-2024).
-
-## Basic usage
-
-The NPM package `@polar/client-generic` can be installed via NPM or downloaded from the [release page](https://github.com/Dataport/polar/releases). When using `import mapClient from '@polar/client-generic'`, the object `mapClient` contains a method `createMap`. This is the main method required to get the client up and running. Should you use another import method, check the package's `dist` folder for available files.
-
-The method expects a single object with the following parameters.
-
-| fieldName | type | description |
-| - | - | - |
-| containerId | string | ID of the container the map is supposed to render itself to. |
-| services | object[] \| string | Either a link to a service registry or an array containing service description objects. For more details, see the startup section on [POLAR documentation](https://dataport.github.io/polar/documentation.html#configuration). This parameter can be seen as an accessible version of `mapConfiguration.layerConf`. |
-| mapConfiguration | object | See [documentation of `@polar/core`](https://dataport.github.io/polar/docs/generic/core.html) for all possible configuration options. |
-| enabledPlugins | string[]? | This is a client-specific field. Since the `@polar/client-generic` client contains all existing plugins, they are activated by strings. The strings match their package names: `'address-search' \| 'attributions' \| 'draw'* \| 'export' \| 'filter'* \| 'fullscreen'* \| 'geo-location'* \| 'gfi'* \| 'icon-menu' \| 'layer-chooser'* \| 'legend' \| 'loading-indicator' \| 'pins' \| 'reverse-geocoder' \| 'scale' \| 'toast' \| 'zoom'*`. The plugins marked with * are nested in the `'icon-menu'` in this pre-layouting, hence they depend upon it being active, too. |
-| modifyLayerConfiguration | ((layerConf: object[]) => object[])? | Defaults to identity function. This function is applied to the loaded layer configuration before usage. That is, the `services` can be modified by this to e.g. set parameters not supported by the service register, add additional layers, and so on. |
-
-In your HTML, a div with unique ID (`containerId` from above) is required that holds the following style properties. Width and height can be changed as you need, but are required to be defined.
-
-```html
-
-
-
-
-```
-
-`createMap` returns a Promise of a map instance. This returned instance is required to retrieve information from the map.
-
-The package also includes a `style.css` and an `index.html` file. The `style.css`'s relative path must, if it isn't the default value `'./style.css'`, be included in the `mapConfiguration` as follows:
-
-```js
-{
- // ...
- stylePath: '../the/relative/path/style.css'
-}
-```
-
-The value to `stylePath` is the same as as a `link` tag would have in its `href`.
-
-### Destroy instance
-
-The `mapInstance` returned by the `createMap` call can be destroyed by calling `mapInstance.$destroy`. This will not remove the rendered HTML, but unlink all internal creations and effects. This should be called before re-navigating, usual lifecycle hooks are `beforeDestroy` or `beforeUnmount`, depending on the framework in use.
-
-After this, `createMap` can be used again when the DOM is restored. That is, the original `div` with its `id` must be recreated, since POLAR changes the DOM in the `div`. Normally, an SPA will take care of this by itself since it will render the outlying component anew.
-
-Should this not be the case in your framework, the following snippet restores the DOM:
-
-```js
-// assuming the render div's id was `"polarstern"`
-const polarstern = document.getElementById('polarstern-wrapper')
-const newStar = document.createElement('div')
-newStar.id = 'polarstern'
-newStar.classList.add('polarstern')
-polarstern?.parentElement?.replaceChild(newStar, polarstern)
-```
diff --git a/packages/clients/generic/CHANGELOG.md b/packages/clients/generic/CHANGELOG.md
deleted file mode 100644
index 581576c37e..0000000000
--- a/packages/clients/generic/CHANGELOG.md
+++ /dev/null
@@ -1,10 +0,0 @@
-# CHANGELOG
-
-## unpublished
-
-- Feature: Directly expose `createMap` to be able to import it directly when using this client.
-- Chore: Update `@polar`-dependencies to the latest versions.
-
-## 1.0.0
-
-Initial release.
diff --git a/packages/clients/generic/README.md b/packages/clients/generic/README.md
deleted file mode 100644
index acbe52bcb0..0000000000
--- a/packages/clients/generic/README.md
+++ /dev/null
@@ -1,9 +0,0 @@
-# POLAR client Generic
-
-## Contents
-
-This client contains all available plugins in a monolithic fashion; that is, everything is included in a default combination and can be activated by configuration.
-
-## Configuration
-
-A detailed API description is provided in the contained `API.md` file. You may also consider viewing [our GitHub page](https://dataport.github.io/polar/) where we use this client to produce the examples.
diff --git a/packages/clients/generic/package.json b/packages/clients/generic/package.json
deleted file mode 100644
index c6a923bc01..0000000000
--- a/packages/clients/generic/package.json
+++ /dev/null
@@ -1,49 +0,0 @@
-{
- "name": "@polar/client-generic",
- "version": "1.0.0",
- "description": "POLAR Client Generic. General purpose client with everything plugged in.",
- "keywords": ["OpenLayers", "ol", "POLAR", "client", "generic"],
- "license": "EUPL-1.2",
- "type": "module",
- "author": "Dataport AöR ",
- "main": "dist/polar-client.js",
- "repository": {
- "type": "git",
- "url": "git+https://github.com/Dataport/polar.git",
- "directory": "packages/clients/generic"
- },
- "files": [
- "dist/**/**.*",
- "docs/**/**.*",
- "CHANGELOG.md",
- "API.md"
- ],
- "scripts": {
- "prepublishOnly": "npm run build",
- "build": "rimraf dist && vite build && cd ../../.. && npm run docs:generic"
- },
- "devDependencies": {
- "@polar/core": "^3.0.0",
- "@polar/lib-custom-types": "^2.0.0",
- "@polar/plugin-address-search": "^3.0.0",
- "@polar/plugin-attributions": "^1.4.0",
- "@polar/plugin-draw": "^3.0.0",
- "@polar/plugin-export": "^1.2.2",
- "@polar/plugin-filter": "^3.0.0",
- "@polar/plugin-fullscreen": "^1.2.3",
- "@polar/plugin-geo-location": "^2.0.0",
- "@polar/plugin-gfi": "^3.0.0",
- "@polar/plugin-icon-menu": "^1.3.1",
- "@polar/plugin-layer-chooser": "^2.0.0",
- "@polar/plugin-legend": "^1.1.2",
- "@polar/plugin-loading-indicator": "^1.2.1",
- "@polar/plugin-pins": "^3.0.0",
- "@polar/plugin-reverse-geocoder": "^3.0.0",
- "@polar/plugin-scale": "^3.0.0",
- "@polar/plugin-toast": "^1.1.2",
- "@polar/plugin-zoom": "^1.4.0"
- },
- "nx": {
- "includedScripts": ["build"]
- }
-}
diff --git a/packages/clients/generic/src/polar-client.ts b/packages/clients/generic/src/polar-client.ts
deleted file mode 100644
index 9aa613dc5f..0000000000
--- a/packages/clients/generic/src/polar-client.ts
+++ /dev/null
@@ -1,193 +0,0 @@
-import core, {
- setLayout,
- NineLayout,
- NineLayoutTag,
- PolarCore,
-} from '@polar/core'
-import { MapConfig, Menu } from '@polar/lib-custom-types'
-import AddressSearch from '@polar/plugin-address-search'
-import Attributions from '@polar/plugin-attributions'
-import Draw from '@polar/plugin-draw'
-import Export from '@polar/plugin-export'
-import Filter from '@polar/plugin-filter'
-import Fullscreen from '@polar/plugin-fullscreen'
-import GeoLocation from '@polar/plugin-geo-location'
-import Gfi from '@polar/plugin-gfi'
-import IconMenu from '@polar/plugin-icon-menu'
-import LayerChooser from '@polar/plugin-layer-chooser'
-import Legend from '@polar/plugin-legend'
-import LoadingIndicator from '@polar/plugin-loading-indicator'
-import Pins from '@polar/plugin-pins'
-import ReverseGeocoder from '@polar/plugin-reverse-geocoder'
-import Scale from '@polar/plugin-scale'
-import Toast from '@polar/plugin-toast'
-import Zoom from '@polar/plugin-zoom'
-import packageInfo from '../package.json'
-
-/* TODO
- * The types below do not match. This is intentional due to this file setting
- * a base for later configuration; it is not meant to contain a full config.
- *
- * We should work something out to make types partial, and maybe identify what's
- * left to do as a type on a per-client basis.
- */
-
-type PluginName =
- | 'address-search'
- | 'attributions'
- | 'draw'
- | 'export'
- | 'filter'
- | 'fullscreen'
- | 'geo-location'
- | 'gfi'
- | 'icon-menu'
- | 'layer-chooser'
- | 'legend'
- | 'loading-indicator'
- | 'pins'
- | 'reverse-geocoder'
- | 'scale'
- | 'toast'
- | 'zoom'
-
-// eslint-disable-next-line no-console
-console.info(`@polar/client-generic: running in v${packageInfo.version}.`)
-
-setLayout(NineLayout)
-
-const addPlugins = (coreInstance: PolarCore, enabledPlugins: PluginName[]) => {
- const iconMenu =
- enabledPlugins.includes('icon-menu') &&
- IconMenu({
- displayComponent: true,
- menus: [
- enabledPlugins.includes('layer-chooser') && {
- plugin: LayerChooser({}),
- icon: 'fa-layer-group',
- id: 'layerChooser',
- },
- enabledPlugins.includes('draw') && {
- plugin: Draw({}),
- icon: 'fa-pencil',
- id: 'draw',
- },
- enabledPlugins.includes('filter') && {
- plugin: Filter({
- layers: {},
- }),
- icon: 'fa-filter',
- id: 'filter',
- },
- enabledPlugins.includes('gfi') && {
- plugin: Gfi({
- renderType: 'iconMenu',
- coordinateSources: [],
- layers: {},
- }),
- icon: 'fa-location-pin',
- id: 'gfi',
- },
- enabledPlugins.includes('zoom') && {
- plugin: Zoom({ renderType: 'iconMenu' }),
- id: 'zoom',
- },
- enabledPlugins.includes('fullscreen') && {
- plugin: Fullscreen({ renderType: 'iconMenu' }),
- id: 'fullscreen',
- },
- enabledPlugins.includes('geo-location') && {
- plugin: GeoLocation({
- renderType: 'iconMenu',
- }),
- id: 'geoLocation',
- },
- enabledPlugins.includes('attributions') && {
- plugin: Attributions({
- renderType: 'iconMenu',
- }),
- icon: 'fa-regular fa-copyright',
- id: 'attributions',
- },
- ].filter((x) => x) as Menu[],
- layoutTag: NineLayoutTag.TOP_RIGHT,
- })
-
- coreInstance.addPlugins(
- [
- iconMenu,
- enabledPlugins.includes('address-search') &&
- AddressSearch({
- layoutTag: NineLayoutTag.TOP_LEFT,
- searchMethods: [],
- }),
- enabledPlugins.includes('pins') && Pins({}),
- enabledPlugins.includes('legend') &&
- Legend({
- layoutTag: NineLayoutTag.BOTTOM_RIGHT,
- displayComponent: true,
- }),
- enabledPlugins.includes('export') &&
- Export({
- layoutTag: NineLayoutTag.BOTTOM_LEFT,
- displayComponent: true,
- }),
- enabledPlugins.includes('loading-indicator') &&
- LoadingIndicator({
- layoutTag: NineLayoutTag.MIDDLE_MIDDLE,
- }),
- enabledPlugins.includes('reverse-geocoder') &&
- ReverseGeocoder({
- url: '',
- }),
- enabledPlugins.includes('scale') &&
- Scale({
- layoutTag: NineLayoutTag.BOTTOM_RIGHT,
- displayComponent: true,
- }),
- enabledPlugins.includes('toast') &&
- Toast({
- layoutTag: NineLayoutTag.BOTTOM_MIDDLE,
- displayComponent: true,
- }),
- ].filter((x) => x)
- )
-}
-
-export const createMap = ({
- containerId,
- services,
- mapConfiguration,
- enabledPlugins = [],
- modifyLayerConfiguration = (x) => x,
-}: {
- containerId: string
- services: object[]
- mapConfiguration: MapConfig
- enabledPlugins: Array
- modifyLayerConfiguration: (layerConf: object[]) => object[]
-}) =>
- new Promise((resolve) => {
- const coreInstance = { ...core }
-
- addPlugins(coreInstance, enabledPlugins)
-
- coreInstance.rawLayerList.initializeLayerList(
- services,
- async (layerConf) => {
- const client = await coreInstance.createMap({
- containerId,
- mapConfiguration: {
- ...mapConfiguration,
- layerConf: modifyLayerConfiguration(layerConf),
- },
- })
-
- resolve(client)
- }
- )
- })
-
-export default {
- createMap,
-}
diff --git a/packages/clients/generic/vite.config.js b/packages/clients/generic/vite.config.js
deleted file mode 100644
index 2b1324cbe5..0000000000
--- a/packages/clients/generic/vite.config.js
+++ /dev/null
@@ -1,19 +0,0 @@
-import { getClientConfig } from '../../../viteConfigs'
-
-export default getClientConfig({
- base: '',
- build: {
- lib: {
- name: 'PolarClientGeneric',
- entry: '../src/polar-client.ts',
- fileName: 'polar-client',
- },
- rollupOptions: {
- output: {
- assetFileNames: (assetInfo) =>
- assetInfo.name === 'style.css' ? 'polar-client.css' : assetInfo.name,
- },
- },
- },
- root: 'example',
-})
diff --git a/packages/clients/meldemichel/API.md b/packages/clients/meldemichel/API.md
deleted file mode 100644
index 3207e07a14..0000000000
--- a/packages/clients/meldemichel/API.md
+++ /dev/null
@@ -1,198 +0,0 @@
-# Meldemichel MapClient API 🗺️ `@polar/client-meldemichel`
-
-This client is based on [POLAR](https://github.com/Dataport/polar) and subsequently the [masterportalAPI](https://bitbucket.org/geowerkstatt-hamburg/masterportalapi/src/master/). The following documentation only contains how this specific client can be used, and the minimal information required to get it running.
-
-For all additional details, check the [full documentation](https://dataport.github.io/polar/docs/meldemichel/client-meldemichel.html).
-
-For the development test deployments, [see here](./example/index.html).
-
-## Basic usage
-
-The NPM package `@polar/client-meldemichel` can be installed via NPM or downloaded from the [release page](https://github.com/Dataport/polar/releases). When using `import mapClient from '@polar/client-meldemichel'`, the object `mapClient` contains a method `createMap`. This is the main method required to get the client up and running. Should you use another import method, check the package's `dist` folder for available files.
-
-The method expects a single object with the following parameters.
-
-| fieldName | type | description |
-| - | - | - |
-| containerId | string | ID of the container the map is supposed to render itself to. |
-| mode | enum["REPORT", "SINGLE", "COMPLETE"] | See chapters below for an overview of the modes. |
-| stadtwaldActive | boolean? | This layer only works in 'SINGLE' mode and should not be activated in the others. If not set, any existing previous state is kept; off by default. |
-| afmUrl | string? | `COMPLETE` mode only. The URL used here is the URL of the AfM service to open to create a new damage report. |
-| reportServiceId | string? | `COMPLETE` mode only. ID of the report layer to display. Both the Filter and the Feature List will work with this layer. The client will also provide tooltips and cluster the features. |
-| configOverride | object? | This can be used to override the configuration of any installed plugin; see full documentation. It is also used to set initial pins in `SINGLE` mode. See documentation of `SINGLE` further below. |
-
-It returns a Promise of a map instance. This returned instance is required to retrieve information from the map.
-
-The package also includes a `style.css` and an `index.html` file. The `style.css`'s relative path must, if it isn't the default value `'./style.css'`, be included in the `configOverride` as follows:
-
-```js
-{
- // ...
- configOverride: {
- stylePath: '../the/relative/path/style.css'
- }
-}
-```
-
-The value to `stylePath` is the same as as a `link` tag would have in its `href`.
-
-The `index.html` is used in `COMPLETE` mode, which is not run in the AfM. You may, however, use it for testing or inspecting an example.
-
-### Instance reuse
-
-The `mapInstance` and its HTML environment are kept in the client; it is returned and rerendered on subsequent `createMap` calls to a div with the given `id`. Due to this, everything will appear to the user as it was previously left, including opened menus.
-
-Since in `SINGLE` mode, changes to the pins are required between renders, hence the parameters in `configOverride.pins` are used to update the client. Should additional updates be required, please let us know.
-
-Calling `watch`/`subscribe` on the client will return an `unwatch`/`unsubscribe` method. It should be called on leaving the map's page; depending on framework/library in e.g. the `beforeDestroy` or `beforeUnmount` method.
-
-## Rendering in SINGLE or REPORT mode
-
-A document rendering the map client could e.g. look like this:
-
-```html
-
-
-
- REPORT EXAMPLE
-
-
-
-
-
-
-
-
-
-
-```
-
-## Rendering COMPLETE mode (full page)
-
-The `index.html` included in the package's `dist` folder has been prepared for this mode and must merely be hosted.
-
-Please see the table in chapter `Basic usage` about configuration options.
-
-## Rendering COMPLETE mode (embedded element)
-
-To embed the COMPLETE mode map on any page, provide a div with an id like `meldemichel-map-client`; you may choose any id you like.
-
-The following script tag can then be used to render the productive services of the Meldemichel map client.
-
-```html
-
-```
-
-POLAR will rebuild the given div to contain a ShadowDOM that hosts the map. The outer div will change to have the id `meldemichel-map-client-wrapper` (resp. `${yourId}-wrapper`) and can be used to style the map's height and width with, for example:
-
-```css
-#meldemichel-map-client-wrapper {
- /* "position: relative;" is the minimum required styling */
- position: relative;
- height: 400px;
- width: 100%;
-}
-```
-
-To also serve users with JS disabled some content, this fragment is common:
-
-```html
-
-
-
-
-```
-
-For a complete example, you may also check [the running embedded scenario](https://dataport.github.io/polar/docs/meldemichel/example/complete_embedded.html) or its [source file](https://github.com/Dataport/polar/blob/main/packages/clients/meldemichel/example/complete_embedded.html).
diff --git a/packages/clients/meldemichel/CHANGELOG.md b/packages/clients/meldemichel/CHANGELOG.md
deleted file mode 100644
index e115913de8..0000000000
--- a/packages/clients/meldemichel/CHANGELOG.md
+++ /dev/null
@@ -1,106 +0,0 @@
-# CHANGELOG
-
-## unpublished
-
-- Chore: Update `@polar`-dependencies to the latest versions.
-
-## 1.2.1
-
-- Feature: Add `stadtwaldActive` as startup parameter for `createMap` object and `meldemichel/setMapState` action. Refer to the API.md regarding further details.
-- Fix: Import type `MpApiParameters` from correct position.
-- Chore: Change value of `pins.movable` configuration to `'drag'` as using a boolean has been deprecated in a future release.
-- Chore: Update `@polar`-dependencies to the latest versions.
-
-## 1.1.2
-
-- Chore: Fix bugs via dependency updates.
- - resolve filter bugs for features of unknown filter categories; they were sometimes visible
-
-## 1.1.1
-
-- Chore: Fix bugs via dependency updates.
- - restore Safari 15 compatibility
- - resolve time filter bugs where selected time frame was applied incorrectly
-
-## 1.1.0
-
-- Change: The search now no longer focuses on the first result after a successful search.
-
-## 1.0.0
-
-Initial release. 🎉
-
-## 1.0.0-beta.7
-
-- Fix: Use `@polar/plugins-pins@1.3.1` to fix the map getting dragged along with the pin in some situations.
-
-## 1.0.0-beta.6
-
-- Feature: Add `@polar/plugin-address-search` and `@polar/plugin-reverse-geocoder` to mode `SINGLE`.
-
-## 1.0.0-beta.5
-
-- Fix: Add missing API.md change. No further changes to previous version.
-
-## 1.0.0-beta.4
-
-- Fix: The previously proclaimed SPA-readiness was erroneous in that a memory leak occurred due to the client not being garbage-collectable. This has been resolved by reusing the map entirely instead of setting up a new one. Given configuration regarding pins is interpreted despite reuse.
-- Change: The main library file is no longer published as `.mjs`, but as `.js` file. This is due to internal tooling updates. A rename of the import suffices.
-
-## 1.0.0-beta.3
-
-- Fix: The gazetteer search returned confusing results. This was due to a wildcard option that allowed the return of imprecise matches. This has been deactivated since it tended to result in more confusion than it was helpful. The search now works as it does in the previous Meldemichel implementation.
-
-## 1.0.0-beta.2
-
-- Feature: This client now supports the `@polar/core`'s field `stylePath`. The usage is documented in the API.md file.
-- Feature: Update icon of `layerChooser` in `iconMenu` to `fa-layer-group` to clear-up the content hidden behind the menu button.
-- Feature: Update the close-button of the GFI window to indicate more clearly that it leads to the FeatureList.
-- Feature: Move attributions from the `iconMenu` to the bottom-right, use a smaller icon and a different colour to clear-up the secondary nature of the content.
-- Feature: The client is now SPA-ready. The `API.md` has been extended with example code.
-- Fix: Size and colours of GFI navigation arrows have been aligned to neighbouring items in mobile mode.
-- Fix: Fixed an issue on narrow devices sometimes showing undefined content in the gfi after clicking somewhere in the map where no feature is present.
-
-## 1.0.0-beta.1
-
-- Fix: The modes `SINGLE` and `REPORT` falsely ran the GFI plugin dependent upon configuration only available in `COMPLETE` mode. This issue has been resolved.
-
-## 1.0.0-beta.0
-
-Beta release. Feature-complete, but some known (and unknown?) bugs remain.
-
-- Feature: Add features for `COMPLETE` mode:
- - Feature List
- - AfM Button
- - Filter
- - Mobile views for small devices
-- Fix: The listenable `mapState` field `vendor_maps_position` has been changed in its formatting. It now matches the formatting of the neighbouring `mapCenter` field (`number,number`) instead of being an array.
-- Fix: The listenable `mapState` field `vendor_maps_address_to` has been renamed to `vendor_maps_distance_to` to match the previous name.
-
-### Dependency updates
-
-Please check the package changelogs regarding details.
-
-|Package|Previous|Current|
-|-|-|-|
-| `@polar/core | ^1.1.0 | ^1.2.1 |
-| `@polar/lib-custom-types | ^1.1.0 | ^1.2.0 |
-| `@polar/lib-invisible-style | * | ^1.0.0 |
-| `@polar/plugin-address-search | ^1.0.0 | ^1.1.0 |
-| `@polar/plugin-attributions | ^1.0.0 | ^1.1.0 |
-| `@polar/plugin-filter | * | ^1.0.0 |
-| `@polar/plugin-fullscreen | ^1.0.0 | ^1.1.0 |
-| `@polar/plugin-geo-location | ^1.1.0 | ^1.2.0 |
-| `@polar/plugin-gfi | ^1.0.0 | ^1.1.0 |
-| `@polar/plugin-icon-menu | ^1.0.1 | ^1.1.0 |
-| `@polar/plugin-layer-chooser | ^1.0.0 | ^1.1.0 |
-| `@polar/plugin-loading-indicator | ^1.0.0 | ^1.0.1 |
-| `@polar/plugin-pins | ^1.1.0 | ^1.1.1 |
-| `@polar/plugin-reverse-geocoder | ^1.0.0 | ^1.0.1 |
-| `@polar/plugin-scale | ^1.0.0 | ^1.0.1 |
-| `@polar/plugin-toast | ^1.0.0 | ^1.0.1 |
-| `@polar/plugin-zoom | ^1.0.0 | ^1.1.0 |
-
-## 1.0.0-alpaka.0
-
-Test release. Feature-complete for AfM integration.
diff --git a/packages/clients/meldemichel/example/index.html b/packages/clients/meldemichel/example/index.html
deleted file mode 100644
index 98c610b54c..0000000000
--- a/packages/clients/meldemichel/example/index.html
+++ /dev/null
@@ -1,58 +0,0 @@
-
-
-
-
- Meldemichel Example Hub (Build Test)
-
-
-
-
-
-
-
Meldemichel Example Hub
-
This is a minimal test page. Stage services are used.
+ 
+ 
-
