@npm9912/v-map 0.1.0

package/dist/types/components/v-map-builder/v-map-builder.d.ts

@@ -0,0 +1,48 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+import type { BuilderConfig } from '../../utils/diff';
+/**
+ * A component that builds map configurations dynamically from JSON/YAML configuration scripts.
+ *
+ * @part mount - The container element where the generated map and layers are mounted.
+ */
+export declare class VMapBuilder {
+    hostEl: HTMLElement;
+    /**
+     * Configuration object for the map builder. Can be any structure that will be normalized to BuilderConfig.
+     */
+    mapconfig?: unknown;
+    /**
+     * Event emitted when the map configuration has been successfully parsed and is ready to use.
+     */
+    configReady: EventEmitter<BuilderConfig>;
+    /**
+     * Event emitted when there is an error parsing the map configuration.
+     */
+    configError: EventEmitter<{
+        message: string;
+        errors?: string[];
+    }>;
+    private current?;
+    componentDidLoad(): Promise<void>;
+    onMapConfigChanged(_oldValue: string, _newValue: string): Promise<void>;
+    private parseFromSlot;
+    private normalizeLayerType;
+    private toOptionalString;
+    private toOptionalNumber;
+    private toOptionalBoolean;
+    private toCsv;
+    private cleanRecord;
+    private normalizeLayer;
+    private normalize;
+    private normalizeStyles;
+    private normalizeStyle;
+    private syncStyles;
+    private ensureAttr;
+    private ensureGroup;
+    private toKebabCase;
+    private createLayerEl;
+    private patchLayer;
+    private applyDiff;
+    private onSlotChange;
+    render(): any;
+}

package/dist/types/components/v-map-builder/v-map-builder.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/components/v-map-layer-geojson/v-map-layer-geojson.d.ts

@@ -0,0 +1,129 @@
+import type { VMapErrorHost } from '../../layer/v-map-layer-helper';
+import type { VMapErrorDetail } from '../../utils/events';
+import { StyleEvent } from '../../types/styling';
+export declare class VMapLayerGeoJSON implements VMapErrorHost {
+    el: HTMLElement;
+    /** Current load state of the layer. */
+    loadState: 'idle' | 'loading' | 'ready' | 'error';
+    /** Prop, die du intern nutzt/weiterverarbeitest */
+    geojson?: string;
+    /**
+     * URL to fetch GeoJSON data from. Alternative to providing data via slot.
+     */
+    url: string | null;
+    /**
+     * Whether the layer is visible on the map.
+     */
+    visible: boolean;
+    /**
+     * Z-index for layer stacking order. Higher values render on top.
+     */
+    zIndex: number;
+    /**
+     * Opazität der geojson-Kacheln (0–1).
+     * @default 1
+     */
+    opacity: number;
+    /**
+     * Fill color for polygon geometries (CSS color value)
+     * @default 'rgba(0,100,255,0.3)'
+     */
+    fillColor?: string;
+    /**
+     * Fill opacity for polygon geometries (0-1)
+     * @default 0.3
+     */
+    fillOpacity?: number;
+    /**
+     * Stroke color for lines and polygon outlines (CSS color value)
+     * @default 'rgba(0,100,255,1)'
+     */
+    strokeColor?: string;
+    /**
+     * Stroke width in pixels
+     * @default 2
+     */
+    strokeWidth?: number;
+    /**
+     * Stroke opacity (0-1)
+     * @default 1
+     */
+    strokeOpacity?: number;
+    /**
+     * Point radius for point geometries in pixels
+     * @default 6
+     */
+    pointRadius?: number;
+    /**
+     * Point color for point geometries (CSS color value)
+     * @default 'rgba(0,100,255,1)'
+     */
+    pointColor?: string;
+    /**
+     * Icon URL for point features (alternative to pointColor/pointRadius)
+     */
+    iconUrl?: string;
+    /**
+     * Icon size as [width, height] in pixels (comma-separated string like "32,32")
+     * @default "32,32"
+     */
+    iconSize?: string;
+    /**
+     * Text property name from feature properties to display as label
+     */
+    textProperty?: string;
+    /**
+     * Text color for labels (CSS color value)
+     * @default '#000000'
+     */
+    textColor?: string;
+    /**
+     * Text size for labels in pixels
+     * @default 12
+     */
+    textSize?: number;
+    private geoSlot?;
+    private mo?;
+    private lastString?;
+    private layerId;
+    private didLoad;
+    private hasLoadedOnce;
+    private helper;
+    private appliedGeostylerStyle?;
+    /**
+     * Returns the internal layer ID used by the map provider.
+     */
+    getLayerId(): Promise<string>;
+    setLoadState(state: 'idle' | 'loading' | 'ready' | 'error'): void;
+    /** Returns the last error detail, if any. */
+    getError(): Promise<VMapErrorDetail | undefined>;
+    connectedCallback(): Promise<void>;
+    componentWillLoad(): Promise<void>;
+    componentDidLoad(): Promise<void>;
+    disconnectedCallback(): Promise<void>;
+    isReady(): boolean;
+    onGeoJsonChanged(oldValue: string, newValue: string): Promise<void>;
+    onUrlChanged(oldValue: string, newValue: string): Promise<void>;
+    onVisibleChanged(): Promise<void>;
+    onOpacityChanged(): Promise<void>;
+    onZIndexChanged(): Promise<void>;
+    onStyleChanged(): Promise<void>;
+    /**
+     * Listen for style events from v-map-style components
+     */
+    onStyleReady(event: CustomEvent<StyleEvent>): Promise<void>;
+    /**
+     * Check if this layer is targeted by a style component
+     */
+    private isTargetedByStyle;
+    private applyExistingStyles;
+    /**
+     * Update the layer with the applied geostyler style
+     */
+    private updateLayerWithGeostylerStyle;
+    private onSlotChange;
+    private observeAssignedNodes;
+    private readGeoJsonFromSlot;
+    private createLayerConfig;
+    render(): any;
+}

package/dist/types/components/v-map-layer-geojson/v-map-layer-geojson.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/components/v-map-layer-geotiff/v-map-layer-geotiff.d.ts

@@ -0,0 +1,74 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+import type { VMapLayer } from '../../types/vmaplayer';
+import type { VMapErrorDetail } from '../../utils/events';
+import type { VMapErrorHost } from '../../layer/v-map-layer-helper';
+import type { ColorMap as GeoStylerColorMap } from 'geostyler-style';
+export declare class VMapLayerGeoTIFF implements VMapLayer, VMapErrorHost {
+    el: HTMLElement;
+    /** Current load state of the layer. */
+    loadState: 'idle' | 'loading' | 'ready' | 'error';
+    /**
+     * URL to the GeoTIFF file to be displayed on the map.
+     */
+    url: string;
+    visible: boolean;
+    /**
+     * Opazität der GeoTIFF-Kacheln (0–1).
+     * @default 1
+     */
+    opacity: number;
+    /**
+     * Z-index for layer stacking order. Higher values render on top.
+     */
+    zIndex: number;
+    /**
+     * NoData Values to discard (overriding any nodata values in the metadata).
+     */
+    nodata?: number;
+    /**
+     * ColorMap für die Visualisierung (kann entweder ein vordefinierter Name oder eine GeoStyler ColorMap sein).
+     */
+    colorMap?: string | GeoStylerColorMap;
+    /**
+     * Value range for colormap normalization [min, max].
+     */
+    valueRange?: [number, number];
+    /**
+     * Wird ausgelöst, wenn der GeoTIFF-Layer bereit ist.
+     * @event ready
+     */
+    ready: EventEmitter<void>;
+    private didLoad;
+    private hasLoadedOnce;
+    private helper;
+    setLoadState(state: 'idle' | 'loading' | 'ready' | 'error'): void;
+    /** Returns the last error detail, if any. */
+    getError(): Promise<VMapErrorDetail | undefined>;
+    onUrlChanged(): Promise<void>;
+    onVisibleChanged(): Promise<void>;
+    onOpacityChanged(): Promise<void>;
+    onZIndexChanged(): Promise<void>;
+    onNodataChanged(): Promise<void>;
+    onColorMapChanged(): Promise<void>;
+    onValueRangeChanged(): Promise<void>;
+    isReady(): boolean;
+    /**
+     * Returns the internal layer ID used by the map provider.
+     */
+    getLayerId(): Promise<string>;
+    private createLayerConfig;
+    connectedCallback(): Promise<void>;
+    disconnectedCallback(): Promise<void>;
+    /**
+     * Handle styleReady event from v-map-style component
+     */
+    private handleStyleReady;
+    /**
+     * Extract RasterSymbolizer from GeoStyler Style
+     */
+    private extractRasterSymbolizer;
+    componentWillLoad(): Promise<void>;
+    componentDidLoad(): Promise<void>;
+    componentWillRender(): Promise<void>;
+    render(): void;
+}

package/dist/types/components/v-map-layer-geotiff/v-map-layer-geotiff.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/components/v-map-layer-google/v-map-layer-google.d.ts

@@ -0,0 +1,78 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+import type { VMapErrorDetail } from '../../utils/events';
+import { type VMapErrorHost } from '../../layer/v-map-layer-helper';
+/**
+ * Google Maps Basemap Layer
+ */
+export declare class VMapLayerGoogle implements VMapErrorHost {
+    el: HTMLElement;
+    /** Current load state of the layer. */
+    loadState: 'idle' | 'loading' | 'ready' | 'error';
+    /**
+     * Karten-Typ: "roadmap" | "satellite" | "hybrid" | "terrain".
+     * @default "roadmap"
+     */
+    mapType: 'roadmap' | 'satellite' | 'terrain' | 'hybrid';
+    /**
+     * Google Maps API-Schlüssel.
+     * @example
+     * <v-map-layer-google api-key="YOUR_KEY"></v-map-layer-google>
+     */
+    apiKey?: string;
+    /**
+     * Sprach-Lokalisierung (BCP-47, z. B. "de", "en-US").
+     * @default "en"
+     */
+    language?: string;
+    /**
+     * Region-Bias (ccTLD/Region-Code, z. B. "DE", "US").
+     * Beeinflusst Labels/Suchergebnisse.
+     */
+    region?: string;
+    /**
+     * Sichtbarkeit des Layers.
+     * @default true
+     */
+    visible: boolean;
+    /**
+     * Opazität des Layers (0–1).
+     * @default 1
+     */
+    opacity: number;
+    /**
+     * Scale factor for tile display.
+     * @default "scaleFactor1x"
+     */
+    scale?: 'scaleFactor1x' | 'scaleFactor2x' | 'scaleFactor4x';
+    /**
+     * Maximum zoom level for the layer.
+     */
+    maxZoom?: number;
+    /**
+     * Custom styles for the Google Map (JSON array of styling objects).
+     * Can be passed as JSON string or array.
+     */
+    styles?: Record<string, unknown>[] | string;
+    /**
+     * Google Maps libraries to load (comma-separated string).
+     * @example "geometry,places,drawing"
+     */
+    libraries?: string;
+    /**
+     * Signalisiert, dass der Google-Layer bereit ist. `detail` enthält Metadaten.
+     * @event ready
+     */
+    ready: EventEmitter<void>;
+    private hasLoadedOnce;
+    private helper;
+    setLoadState(state: 'idle' | 'loading' | 'ready' | 'error'): void;
+    /** Returns the last error detail, if any. */
+    getError(): Promise<VMapErrorDetail | undefined>;
+    parseStyles(newValue: Record<string, unknown>[] | string): void;
+    private createLayerConfig;
+    connectedCallback(): Promise<void>;
+    componentWillLoad(): Promise<void>;
+    componentDidLoad(): Promise<void>;
+    disconnectedCallback(): Promise<void>;
+    render(): void;
+}

package/dist/types/components/v-map-layer-osm/error-api.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/components/v-map-layer-osm/v-map-layer-osm.d.ts

@@ -0,0 +1,50 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+import type { VMapLayer } from '../../types/vmaplayer';
+import { type VMapErrorDetail } from '../../utils/events';
+import { type VMapErrorHost } from '../../layer/v-map-layer-helper';
+export declare class VMapLayerOSM implements VMapLayer, VMapErrorHost {
+    el: HTMLElement;
+    /** Current load state of the layer. */
+    loadState: 'idle' | 'loading' | 'ready' | 'error';
+    visible: boolean;
+    /**
+     * Opazität der OSM-Kacheln (0–1).
+     * @default 1
+     */
+    opacity: number;
+    /**
+     * Z-index for layer stacking order. Higher values render on top.
+     */
+    zIndex: number;
+    /**
+     * Base URL for OpenStreetMap tile server. Defaults to the standard OSM tile server.
+     */
+    url: string;
+    /**
+     * Wird ausgelöst, wenn der OSM-Layer bereit ist.
+     * @event ready
+     */
+    ready: EventEmitter<void>;
+    private didLoad;
+    private hasLoadedOnce;
+    private helper;
+    setLoadState(state: 'idle' | 'loading' | 'ready' | 'error'): void;
+    /** Returns the last error detail, if any. */
+    getError(): Promise<VMapErrorDetail | undefined>;
+    onVisibleChanged(): Promise<void>;
+    onOpacityChanged(): Promise<void>;
+    onZIndexChanged(): Promise<void>;
+    onUrlChanged(oldValue: string, newValue: string): Promise<void>;
+    isReady(): boolean;
+    /**
+     * Returns the internal layer ID used by the map provider.
+     */
+    getLayerId(): Promise<string>;
+    private createLayerConfig;
+    connectedCallback(): Promise<void>;
+    componentWillLoad(): Promise<void>;
+    componentDidLoad(): Promise<void>;
+    componentWillRender(): Promise<void>;
+    disconnectedCallback(): Promise<void>;
+    render(): void;
+}

package/dist/types/components/v-map-layer-osm/v-map-layer-osm.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/components/v-map-layer-scatterplot/v-map-layer-scatterplot.d.ts

@@ -0,0 +1,54 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+import type { VMapErrorDetail } from '../../utils/events';
+import { type VMapErrorHost } from '../../layer/v-map-layer-helper';
+export type Color = string | [number, number, number, number?];
+export declare class VMapLayerScatterplot implements VMapErrorHost {
+    el: HTMLElement;
+    /** Current load state of the layer. */
+    loadState: 'idle' | 'loading' | 'ready' | 'error';
+    /**
+     * Datenquelle für Punkte. Erwartet Objekte mit mindestens
+     * einer Position in [lon, lat]. Zusätzliche Felder sind erlaubt.
+     */
+    data?: string;
+    /**
+     * Optionaler Remote-Pfad für JSON/CSV/GeoJSON, der zu `data` geladen wird.
+     */
+    url?: string;
+    /**
+     * Funktion zur Bestimmung der Füllfarbe je Punkt. Rückgabe
+     * z. B. [r,g,b] oder CSS-Farbe (providerabhängig).
+     */
+    getFillColor: Color;
+    /**
+     * Funktion/konstanter Wert für den Punkt-Radius.
+     * @default 4
+     */
+    getRadius: number;
+    /**
+     * Globale Opazität (0–1).
+     * @default 1
+     */
+    opacity: number;
+    /**
+     * Sichtbarkeit des Layers.
+     * @default true
+     */
+    visible: boolean;
+    /**
+     * Wird ausgelöst, sobald der Scatterplot registriert wurde.
+     * @event ready
+     */
+    ready: EventEmitter<void>;
+    private hasLoadedOnce;
+    private helper;
+    setLoadState(state: 'idle' | 'loading' | 'ready' | 'error'): void;
+    /** Returns the last error detail, if any. */
+    getError(): Promise<VMapErrorDetail | undefined>;
+    private createLayerConfig;
+    connectedCallback(): Promise<void>;
+    componentWillLoad(): Promise<void>;
+    componentDidLoad(): Promise<void>;
+    disconnectedCallback(): Promise<void>;
+    render(): void;
+}

package/dist/types/components/v-map-layer-terrain/v-map-layer-terrain.d.ts

@@ -0,0 +1,74 @@
+import type { VMapErrorHost } from '../../layer/v-map-layer-helper';
+import type { VMapErrorDetail } from '../../utils/events';
+export declare class VMapLayerTerrain implements VMapErrorHost {
+    el: HTMLElement;
+    /** Current load state of the layer. */
+    loadState: 'idle' | 'loading' | 'ready' | 'error';
+    /**
+     * URL zu Höhenraster im Heightmap-Format (z. B. GeoTIFF oder PNG Heightmap).
+     */
+    elevationData: string;
+    /**
+     * Optionale Textur (RGB) für das Terrain.
+     */
+    texture?: string;
+    /**
+     * JSON-Repräsentation eines Elevation-Decoders (z. B. '{"r":1,"g":1,"b":1,"offset":0}').
+     */
+    elevationDecoder?: string;
+    /**
+     * Darstellung des Mesh als Drahtgitter.
+     */
+    wireframe?: boolean;
+    /**
+     * Basisfarbe für das Terrain. Erwartet Hex oder RGB (z. B. '#ff0000' oder '255,0,0').
+     */
+    color?: string;
+    /**
+     * Minimale Zoomstufe für das Terrain.
+     */
+    minZoom?: number;
+    /**
+     * Maximale Zoomstufe für das Terrain.
+     */
+    maxZoom?: number;
+    /**
+     * Fehler-Toleranz für das Mesh (wird an TerrainRenderer durchgereicht).
+     */
+    meshMaxError?: number;
+    /**
+     * Sichtbarkeit des Layers.
+     */
+    visible: boolean;
+    /**
+     * Opazität des Layers.
+     */
+    opacity: number;
+    /**
+     * Z-Index für die Darstellung.
+     */
+    zIndex: number;
+    private didLoad;
+    private hasLoadedOnce;
+    private helper;
+    setLoadState(state: 'idle' | 'loading' | 'ready' | 'error'): void;
+    /** Returns the last error detail, if any. */
+    getError(): Promise<VMapErrorDetail | undefined>;
+    componentWillLoad(): void;
+    componentDidLoad(): Promise<void>;
+    connectedCallback(): Promise<void>;
+    disconnectedCallback(): Promise<void>;
+    /**
+     * Liefert `true`, sobald das Terrain-Layer initialisiert wurde.
+     */
+    isReady(): Promise<boolean>;
+    onVisibleChanged(): Promise<void>;
+    onOpacityChanged(): Promise<void>;
+    onZIndexChanged(): Promise<void>;
+    onTerrainConfigChanged(): Promise<void>;
+    private pushTerrainUpdate;
+    private getElevationDecoder;
+    private getColorArray;
+    private createLayerConfig;
+    render(): any;
+}

package/dist/types/components/v-map-layer-terrain/v-map-layer-terrain.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/components/v-map-layer-terrain-geotiff/v-map-layer-terrain-geotiff.d.ts

@@ -0,0 +1,117 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+import type { VMapLayer } from '../../types/vmaplayer';
+import type { VMapErrorDetail } from '../../utils/events';
+import type { VMapErrorHost } from '../../layer/v-map-layer-helper';
+import type { ColorMap as GeoStylerColorMap } from 'geostyler-style';
+export declare class VMapLayerTerrainGeotiff implements VMapLayer, VMapErrorHost {
+    el: HTMLElement;
+    /** Current load state of the layer. */
+    loadState: 'idle' | 'loading' | 'ready' | 'error';
+    /**
+     * URL to the GeoTIFF file containing elevation data.
+     */
+    url: string;
+    /**
+     * Quell-Projektion des GeoTIFF (z. B. "EPSG:32632" oder proj4-String)
+     */
+    projection?: string;
+    /**
+     * Erzwingt die Verwendung der projection-Prop, ignoriert GeoKeys
+     */
+    forceProjection?: boolean;
+    visible: boolean;
+    /**
+     * Opacity of the terrain layer (0–1).
+     * @default 1
+     */
+    opacity: number;
+    /**
+     * Z-index for layer stacking order. Higher values render on top.
+     */
+    zIndex: number;
+    /**
+     * NoData value to discard (overriding any nodata values in the metadata).
+     */
+    nodata?: number;
+    /**
+     * Mesh error tolerance in meters (Martini).
+     * Smaller values = more detailed mesh, but slower.
+     * @default 4.0
+     */
+    meshMaxError?: number;
+    /**
+     * Enable wireframe mode (show only mesh lines).
+     * @default false
+     */
+    wireframe?: boolean;
+    /**
+     * Optional texture URL (can be an image or tile URL).
+     */
+    texture?: string;
+    /**
+     * Color for the terrain (if no texture is provided).
+     * [r, g, b] with values 0-255.
+     * @default [255, 255, 255]
+     */
+    color?: [number, number, number];
+    /**
+     * ColorMap for elevation data visualization.
+     * Only relevant when no texture is set.
+     */
+    colorMap?: string | GeoStylerColorMap;
+    /**
+     * Value range for colormap normalization [min, max].
+     */
+    valueRange?: [number, number];
+    /**
+     * Elevation exaggeration factor.
+     * @default 1.0
+     */
+    elevationScale?: number;
+    /**
+     * Rendering mode for GeoTIFF terrain.
+     * @default terrain
+     */
+    renderMode?: 'terrain' | 'colormap';
+    /**
+     * Minimum zoom level.
+     */
+    minZoom?: number;
+    /**
+     * Maximum zoom level.
+     */
+    maxZoom?: number;
+    /**
+     * Tile size in pixels.
+     * @default 256
+     */
+    tileSize?: number;
+    /**
+     * Fired when the terrain layer is ready.
+     * @event ready
+     */
+    ready: EventEmitter<void>;
+    private didLoad;
+    private hasLoadedOnce;
+    private helper;
+    setLoadState(state: 'idle' | 'loading' | 'ready' | 'error'): void;
+    /** Returns the last error detail, if any. */
+    getError(): Promise<VMapErrorDetail | undefined>;
+    onUrlChanged(): Promise<void>;
+    onVisibleChanged(): Promise<void>;
+    onOpacityChanged(): Promise<void>;
+    onZIndexChanged(): Promise<void>;
+    onPropertyChanged(): Promise<void>;
+    isReady(): boolean;
+    /**
+     * Returns the internal layer ID used by the map provider.
+     */
+    getLayerId(): Promise<string>;
+    private createLayerConfig;
+    connectedCallback(): Promise<void>;
+    disconnectedCallback(): Promise<void>;
+    componentWillLoad(): Promise<void>;
+    componentDidLoad(): Promise<void>;
+    componentWillRender(): Promise<void>;
+    render(): any;
+}

package/dist/types/components/v-map-layer-terrain-geotiff/v-map-layer-terrain-geotiff.test.d.ts

@@ -0,0 +1 @@
+export {};