geoadmin · pakb · Nov 13, 2025 · Nov 13, 2025 · Nov 6, 2025 · Nov 6, 2025
diff --git a/.gitignore b/.gitignore
@@ -45,3 +45,6 @@ package-lock.json
 **/scripts/check-layer-providers-results/*invalid_providers_wmts.yaml
 **/scripts/check-layer-providers-results/*invalid_providers_content.yaml
 **/scripts/check-layer-providers-results/*valid_providers.json
+
+# Dev
+.specstory
diff --git a/.prettierignore b/.prettierignore
@@ -0,0 +1,11 @@
+pnpm-lock.yaml
+.github/
+patches/
+
+node_modules/
+**/node_modules
+packages/**/dist/
+
+packages/viewer/index.html
+packages/viewer/public/icon.svg
+packages/viewer/src/assets/svg/swiss-flag.svg
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -109,15 +109,15 @@ The store is divided into modules that mostly correspond to the application part
 The goal is to have a centralized way of dealing with changes, and not delegate that to each component.
 
 Store plugins can be used to react to store changes.
-See the [store read-me](packages/viewer/src/store/README.md) for more information.
+See the [store read-me](packages/mapviewer/src/store/README.md) for more information.
 
 ### Best practices
 
 - Prefer primitive data or javascript plain object in reactive data (Vue Component data or refs, Vuex store data)
 - Don't use a complex object as reactive data
 - Avoid using JavaScript getter and setter in class that are used in reactive data
 
-See also [Store Best Practices](packages/viewer/src/store/README.md#best-practices)
+See also [Store Best Practices](packages/mapviewer/src/store/README.md#best-practices)
 
 ### Vue Composition API
 

diff --git a/PACKAGES.md b/PACKAGES.md
@@ -0,0 +1,152 @@
+# @swissgeo Packages Dependency Map
+
+State made on the 2026-01-21 (subject to change)
+
+This document maps the dependencies between the packages exported to NPMJS.com under the `@swissgeo` organization.
+
+## Dependency Graph
+
+```mermaid
+graph TD
+    subgraph Core Libraries
+        api["@swissgeo/api"]
+        coordinates["@swissgeo/coordinates"]
+        elevation["@swissgeo/elevation-profile"]
+        layers["@swissgeo/layers"]
+        log["@swissgeo/log"]
+        numbers["@swissgeo/numbers"]
+        theme["@swissgeo/theme"]
+        tooltip["@swissgeo/tooltip"]
+    end
+
+    subgraph Configuration Packages
+        eslint["@swissgeo/config-eslint"]
+        prettier["@swissgeo/config-prettier"]
+        stylelint["@swissgeo/config-stylelint"]
+        typescript["@swissgeo/config-typescript"]
+        staging["@swissgeo/staging-config"]
+    end
+
+    %% Dependencies
+    api --> coordinates
+    api --> layers
+    api --> log
+    api --> numbers
+    api --> staging
+    api --> theme
+
+    coordinates --> log
+    coordinates --> numbers
+
+    elevation --> api
+    elevation --> coordinates
+    elevation --> log
+    elevation --> numbers
+    elevation --> staging
+    elevation --> tooltip
+
+    layers --> coordinates
+    layers --> log
+    layers --> numbers
+    layers --> staging
+
+    numbers --> log
+
+    theme --> staging
+
+    %% DevDependencies to Config (optional to show, but mapping them helps)
+    api -.-> eslint
+    api -.-> prettier
+    api -.-> typescript
+
+    coordinates -.-> eslint
+    coordinates -.-> typescript
+
+    drawing -.-> eslint
+    drawing -.-> prettier
+    drawing -.-> stylelint
+    drawing -.-> typescript
+
+    elevation -.-> eslint
+    elevation -.-> stylelint
+    elevation -.-> typescript
+
+    layers -.-> eslint
+    layers -.-> typescript
+
+    log -.-> eslint
+    log -.-> typescript
+
+    numbers -.-> eslint
+    numbers -.-> typescript
+
+    theme -.-> eslint
+    theme -.-> stylelint
+    theme -.-> typescript
+
+    tooltip -.-> eslint
+    tooltip -.-> stylelint
+    tooltip -.-> typescript
+
+    eslint -.-> typescript
+    prettier -.-> typescript
+    staging -.-> eslint
+    staging -.-> typescript
+    stylelint -.-> typescript
+
+```
+
+## Dependency Table
+
+| Package | Dependencies (@swissgeo) | DevDependencies (@swissgeo) |
+| ------- | ------------------------ | --------------------------- |
+| `@swissgeo/api` | `coordinates`, `layers`, `log`, `numbers`, `staging-config`, `theme` | `config-eslint`, `config-prettier`, `config-typescript` |
+| `@swissgeo/coordinates` | `log`, `numbers` | `config-eslint`, `config-typescript` |
+| `@swissgeo/elevation-profile` | `api`, `coordinates`, `log`, `numbers`, `staging-config`, `tooltip` | `config-eslint`, `config-stylelint`, `config-typescript` |
+| `@swissgeo/layers` | `coordinates`, `log`, `numbers`, `staging-config` | `config-eslint`, `config-typescript` |
+| `@swissgeo/log` | - | `config-eslint`, `config-typescript` |
+| `@swissgeo/numbers` | `log` | `config-eslint`, `config-typescript` |
+| `@swissgeo/theme` | `staging-config` | `config-eslint`, `config-stylelint`, `config-typescript` |
+| `@swissgeo/tooltip` | - | `config-eslint`, `config-stylelint`, `config-typescript` |
+| `@swissgeo/config-eslint` | - | `config-typescript` |
+| `@swissgeo/config-prettier` | - | `config-typescript` |
+| `@swissgeo/config-stylelint` | - | `config-typescript` |
+| `@swissgeo/config-typescript` | - | - |
+| `@swissgeo/staging-config` | - | `config-eslint`, `config-typescript` |
+
+## Dependency Matrix
+
+This table shows which package imports which dependency.
+- **X**: Production dependency
+- **d**: Development dependency
+
+| Importing Package | api | coord | draw | elev | layr | log | numb | thme | tool | esl | pret | styl | ts | stag |
+| :--- | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: |
+| `@swissgeo/api` | - | X | | | X | X | X | X | | d | | | d | X |
+| `@swissgeo/coordinates` | | - | | | | X | X | | | d | | | d | |
+| `@swissgeo/elevation-profile` | X | X | | - | | X | X | | X | d | | d | d | X |
+| `@swissgeo/layers` | | X | | | - | X | X | | | d | | | d | X |
+| `@swissgeo/log` | | | | | | - | | | | d | | | d | |
+| `@swissgeo/numbers` | | | | | | X | - | | | d | | | d | |
+| `@swissgeo/theme` | | | | | | | | - | | d | | d | d | X |
+| `@swissgeo/tooltip` | | | | | | | | | - | d | | d | d | |
+| `@swissgeo/config-eslint` | | | | | | | | | | - | | | d | |
+| `@swissgeo/config-prettier` | | | | | | | | | | | - | | d | |
+| `@swissgeo/config-stylelint` | | | | | | | | | | | | - | d | |
+| `@swissgeo/config-typescript` | | | | | | | | | | | | | - | |
+| `@swissgeo/staging-config` | | | | | | | | | | d | | | d | - |
+
+**Legend:**
+- **api**: `@swissgeo/api`
+- **coord**: `@swissgeo/coordinates`
+- **elev**: `@swissgeo/elevation-profile`
+- **layr**: `@swissgeo/layers`
+- **log**: `@swissgeo/log`
+- **numb**: `@swissgeo/numbers`
+- **thme**: `@swissgeo/theme`
+- **tool**: `@swissgeo/tooltip`
+- **esl**: `@swissgeo/config-eslint`
+- **pret**: `@swissgeo/config-prettier`
+- **styl**: `@swissgeo/config-stylelint`
+- **ts**: `@swissgeo/config-typescript`
+- **stag**: `@swissgeo/staging-config`
diff --git a/README.md b/README.md
@@ -37,15 +37,44 @@ pnpm run dev
 
 See [CONTRIBUTING.md](CONTRIBUTING.md)
 
+## Exported Packages
+
+This monorepo contains several packages that are published to [NPMJS.com](https://www.npmjs.com/org/swissgeo) under the `@swissgeo` organization.
+Detailed dependency mapping can be found in [PACKAGES.md](PACKAGES.md).
+
+### Core Libraries
+
+| Package | Version | Description |
+| ------- | ------- | ----------- |
+| [`@swissgeo/api`](https://www.npmjs.com/package/@swissgeo/api) | ![npm (scoped)](https://img.shields.io/npm/v/@swissgeo/api) | API utilities to interact with SWISSGEO's backend services |
+| [`@swissgeo/coordinates`](https://www.npmjs.com/package/@swissgeo/coordinates) | ![npm (scoped)](https://img.shields.io/npm/v/@swissgeo/coordinates) | Projection definition and coordinates utils for SWISSGEO projects |
+| [`@swissgeo/drawing`](https://www.npmjs.com/package/@swissgeo/drawing) | ![npm (scoped)](https://img.shields.io/npm/v/@swissgeo/drawing) | Components to draw on a map and export the result as KML or GeoJSON |
+| [`@swissgeo/elevation-profile`](https://www.npmjs.com/package/@swissgeo/elevation-profile) | ![npm (scoped)](https://img.shields.io/npm/v/@swissgeo/elevation-profile) | Components to request and display an elevation profile over Switzerland |
+| [`@swissgeo/layers`](https://www.npmjs.com/package/@swissgeo/layers) | ![npm (scoped)](https://img.shields.io/npm/v/@swissgeo/layers) | Layers definition for SwissGeo |
+| [`@swissgeo/log`](https://www.npmjs.com/package/@swissgeo/log) | ![npm (scoped)](https://img.shields.io/npm/v/@swissgeo/log) | Logging utils for SWISSGEO projects |
+| [`@swissgeo/numbers`](https://www.npmjs.com/package/@swissgeo/numbers) | ![npm (scoped)](https://img.shields.io/npm/v/@swissgeo/numbers) | Numbers utils for SWISSGEO projects |
+| [`@swissgeo/theme`](https://www.npmjs.com/package/@swissgeo/theme) | ![npm (scoped)](https://img.shields.io/npm/v/@swissgeo/theme) | Shared SCSS variable and theme utilities |
+| [`@swissgeo/tooltip`](https://www.npmjs.com/package/@swissgeo/tooltip) | ![npm (scoped)](https://img.shields.io/npm/v/@swissgeo/tooltip) | Tooltip for geoadmin |
+
+### Configuration Packages
+
+| Package | Version | Description |
+| ------- | ------- | ----------- |
+| [`@swissgeo/config-eslint`](https://www.npmjs.com/package/@swissgeo/config-eslint) | ![npm (scoped)](https://img.shields.io/npm/v/@swissgeo/config-eslint) | Shared ESLint config for SWISSGEO projects |
+| [`@swissgeo/config-prettier`](https://www.npmjs.com/package/@swissgeo/config-prettier) | ![npm (scoped)](https://img.shields.io/npm/v/@swissgeo/config-prettier) | Shared Prettier config for SWISSGEO projects |
+| [`@swissgeo/config-stylelint`](https://www.npmjs.com/package/@swissgeo/config-stylelint) | ![npm (scoped)](https://img.shields.io/npm/v/@swissgeo/config-stylelint) | Shared Stylelint config for SWISSGEO projects |
+| [`@swissgeo/config-typescript`](https://www.npmjs.com/package/@swissgeo/config-typescript) | ![npm (scoped)](https://img.shields.io/npm/v/@swissgeo/config-typescript) | TypeScript configuration for SWISSGEO projects |
+| [`@swissgeo/staging-config`](https://www.npmjs.com/package/@swissgeo/staging-config) | ![npm (scoped)](https://img.shields.io/npm/v/@swissgeo/staging-config) | Staging config utils for swissgeo |
+
 ## Check External Layer Provider list
 
-In the `Import` tool we provide a hardcoded list of provider via the [external-providers.json](packages/viewer/src/modules/menu/components/advancedTools/ImportCatalogue/external-providers.json) file. Because we have quite a lot of provider, we have a CLI tool in order to
+In the `Import` tool we provide a hardcoded list of provider via the [external-providers.json](packages/mapviewer/src/modules/menu/components/advancedTools/ImportCatalogue/external-providers.json) file. Because we have quite a lot of provider, we have a CLI tool in order to
 check their validity. The tool can also be used with a single url as input parameter to see the URL would be valid
 for our application.
 
 ```bash
 pnpm install
-./packages/viewer/scripts/check-external-layers-providers.js
+./packages/mapviewer/scripts/check-external-layers-providers.js
 ```
 
 You can use `-h` option to get more detail on the script.
diff --git a/env.d.ts b/env.d.ts
@@ -1 +1 @@
-/// <reference types="vite/client" />
+/// <reference types="vite/client" />
diff --git a/package.json b/package.json
@@ -10,30 +10,42 @@
         "build:int": "pnpm --recursive --if-present run build:int",
         "build:prod": "pnpm --recursive --if-present run build:prod",
         "dev": "pnpm --filter=web-mapviewer run dev ",
+        "dev:https": "pnpm --filter=web-mapviewer run dev:https ",
         "force-reinstall": "node ./scripts/force-pnpm-reinstall.js",
         "format": "prettier --write .",
         "format:check": "prettier --check .",
         "lint": "pnpm run --recursive --parallel --no-bail --if-present lint",
         "lint:no-fix": "pnpm run --recursive --parallel --no-bail --if-present lint:no-fix ",
-        "preview": "pnpm run build-libs && pnpm --filter=web-mapviewer run preview",
-        "preview:dev": "pnpm run build-libs && pnpm --filter=web-mapviewer run preview:dev ",
-        "preview:int": "pnpm run build-libs && pnpm --filter=web-mapviewer run preview:int",
-        "preview:prod": "pnpm run build-libs && pnpm --filter=web-mapviewer run preview:prod",
-        "preview:test": "pnpm run build-libs && pnpm --filter=web-mapviewer run preview:test",
+        "preview": "pnpm --filter=web-mapviewer run preview",
+        "preview:dev": "pnpm --filter=web-mapviewer run preview:dev ",
+        "preview:int": "pnpm --filter=web-mapviewer run preview:int",
+        "preview:prod": "pnpm --filter=web-mapviewer run preview:prod",
+        "preview:test": "pnpm --filter=web-mapviewer run preview:test",
+        "publish": "pnpm --filter=!web-mapviewer --filter=!@swissgeo/layers --recursive publish --access public --tag latest",
+        "publish:prepare": "pnpm --filter=!web-mapviewer --filter=!@swissgeo/layers --recursive --parallel build",
         "test:component": "pnpm --filter=web-mapviewer run test:component",
         "test:component:ci": "pnpm --filter=web-mapviewer run test:component:ci",
         "test:e2e": "pnpm --filter=web-mapviewer run test:e2e",
         "test:e2e:ci": "pnpm --filter=web-mapviewer run test:e2e:ci",
         "test:e2e:headless": "pnpm --filter=web-mapviewer run test:e2e:headless",
         "test:unit": "pnpm run --recursive --parallel --no-bail --if-present test:unit",
         "test:unit:watch": "pnpm run --recursive --if-present  test:unit:watch",
-        "update:workspace": "node ./scripts/update-pnpm-workspace.js"
+        "update:workspace": "tsx ./scripts/update-pnpm-workspace.ts"
     },
     "engines": {
         "node": ">=22.18",
         "pnpm": ">=10.15"
     },
     "devDependencies": {
+        "@prettier/plugin-xml": "catalog:",
+        "@swissgeo/config-prettier": "workspace:*",
+        "@types/node": "catalog:",
+        "prettier": "catalog:",
+        "prettier-plugin-jsdoc": "catalog:",
+        "prettier-plugin-packagejson": "catalog:",
+        "prettier-plugin-tailwindcss": "catalog:",
+        "tsx": "catalog:",
+        "vitest": "catalog:",
         "yaml": "catalog:"
     },
     "pnpm": {
@@ -44,16 +56,17 @@
             "sharp",
             "vue-demi"
         ],
+        "patchedDependencies": {
+            "@geoblocks/mapfishprint@0.2.22": "patches/@geoblocks__mapfishprint@0.2.22.patch",
+            "ol@10.8.0": "patches/ol@10.8.0.patch"
+        },
         "ignoredBuiltDependencies": [
             "core-js",
             "cypress",
             "es5-ext",
             "esbuild",
             "protobufjs",
             "sharp"
-        ],
-        "patchedDependencies": {
-            "vite": "patches/vite.patch"
-        }
+        ]
     }
 }
diff --git a/packages/api/README.md b/packages/api/README.md
@@ -0,0 +1,72 @@
+# @swissgeo/api
+
+API utilities to interact with SWISSGEO's backend services.
+
+This package provides a collection of functions and types to interact with various SWISSGEO services, including search, elevation (height), profile, print, and more.
+
+## Installation
+
+```bash
+pnpm add @swissgeo/api
+```
+
+### Peer dependencies
+
+Most functions that deal with coordinates require the [@swissgeo/coordinates](https://www.npmjs.com/package/@swissgeo/coordinates) package to access the coordinate transformation utilities.
+
+```bash
+pnpm add @swissgeo/coordinates
+```
+
+## Features
+
+This package provides utilities for:
+
+- **Features**: Interaction with geographic features.
+- **Feedback**: Sending feedback to the platform.
+- **Files**: KML file management. Aimed at the drawing tools on [map.geo.admin.ch](https://map.geo.admin.ch).
+- **Height**: Requesting elevation at specific coordinates.
+- **Icons**: Accessing platform icons.
+- **LV03 Reframe**: Coordinate transformation (LV03 <-> LV95).
+- **Print**: Interacting with MapFish Print services.
+- **Profile**: Requesting elevation profiles.
+- **QR Code**: Generating QR codes.
+- **Search**: Searching for locations, layers, and features (in layers).
+- **Shortlink**: Generating and resolving shorten URL.
+- **Topics**: Accessing map topics and layers metadata.
+- **What3Words**: Integration with What3Words services.
+
+## Usage (some samples)
+
+### Search API
+
+```typescript
+import { LV95 } from '@swissgeo/coordinates'
+import { searchAPI } from '@swissgeo/api'
+
+const results = await searchAPI.search({ 
+    queryString: "Bern",
+    outputProjection: LV95,
+    lang: 'en',
+    // in m/px, you can get this from your OpenLayers instance by calling map.getView().getResolution()
+    resolution: 1000
+})
+```
+
+### Height API
+
+```typescript
+import { LV95, WGS84 } from '@swissgeo/coordinates'
+import { heightAPI } from '@swissgeo/api'
+
+const elevation = await getHeightForPosition([2600000, 1200000], LV95)
+const elevationWGS84 = await getHeightForPosition([7.530, 46.627], WGS84)
+```
+
+## License
+
+BSD-3-Clause
+
+## Repository
+
+[https://github.com/geoadmin/web-mapviewer](https://github.com/geoadmin/web-mapviewer)
diff --git a/packages/api/eslint.config.mts b/packages/api/eslint.config.mts
@@ -0,0 +1,12 @@
+import defaultConfig from '@swissgeo/config-eslint'
+
+export default [
+    ...defaultConfig,
+    {
+        languageOptions: {
+            parserOptions: {
+                tsconfigRootDir: import.meta.dirname,
+            },
+        },
+    },
+]
Original file line number	Diff line number	Diff line change
		@@ -1 +1 @@
		/// <reference types="vite/client" />
		/// <reference types="vite/client" />