xv-webcomponents 1.20.2 → 1.22.1-qa.0

package/dist/types/components.d.ts

@@ -9,6 +9,7 @@ import { SIZE_VAR_STR, XV_SORT_DIR } from "./types/enum";
 import { XvDataTableCheck, XvDataTableReorder } from "./components/xv-data-table/_vars";
 import { DropdownItemData } from "./components/xv-dropdown/_vars";
 import { XvFileUploaderVariants } from "./components/xv-file-uploader/_vars";
+import { GeoMapSelection } from "./components/xv-geo-map/xv-geo-map";
 import { MenuItem } from "./components/xv-mega-menu-next/xv-mega-menu-next.model";
 import { NOTIFICATION_VARIANTS_STR } from "./components/xv-notification/_vars";
 import { OverflowMenuEvent, OverflowMenuVariant } from "./components/xv-overflow-menu/_vars";
@@ -22,6 +23,7 @@ export { SIZE_VAR_STR, XV_SORT_DIR } from "./types/enum";
 export { XvDataTableCheck, XvDataTableReorder } from "./components/xv-data-table/_vars";
 export { DropdownItemData } from "./components/xv-dropdown/_vars";
 export { XvFileUploaderVariants } from "./components/xv-file-uploader/_vars";
+export { GeoMapSelection } from "./components/xv-geo-map/xv-geo-map";
 export { MenuItem } from "./components/xv-mega-menu-next/xv-mega-menu-next.model";
 export { NOTIFICATION_VARIANTS_STR } from "./components/xv-notification/_vars";
 export { OverflowMenuEvent, OverflowMenuVariant } from "./components/xv-overflow-menu/_vars";
@@ -123,7 +125,7 @@ export namespace Components {
          */
         "type": 'button' | 'submit' | 'reset';
         /**
-          * Button value is optional
+          * Button value is optional. Reflected — xv-button-group-v2 keys its children by the attribute.
          */
         "value"?: string;
         /**
@@ -362,6 +364,10 @@ export namespace Components {
     interface XvDatepicker {
         "block"?: boolean;
         "disabled"?: boolean;
+        /**
+          * Individual dates to disable within the min/max range. Each entry may be a `Date`, a bare 'yyyy-MM-dd' string, or a full ISO string — all normalised to a local 'yyyy-MM-dd' key that matches the calendar grid. Composes with min/max: a day is selectable only when it is inside the range AND not listed here (e.g. to allow only certain weekdays / block holidays).
+         */
+        "disabledDates"?: (Date | string)[];
         /**
           * Error status. Can be boolean or string
          */
@@ -509,6 +515,96 @@ export namespace Components {
     }
     interface XvFooter {
     }
+    /**
+     * Minimal ATV planner map: MapLibre + PLZ boundaries from the XvGeoTool API.
+     * Click a PLZ to (de)select it. No further UI — selection state and reach
+     * data are emitted via `changeSelection` for the host page to display.
+     * MapLibre (~250 KB gzip) is loaded lazily when the component scrolls near
+     * the viewport, so the host page's initial load stays untouched.
+     */
+    interface XvGeoMapV2 {
+        /**
+          * Base URL of the geo API (Xv.Api v1/geo — contract-compatible with the XvGeoTool API). Default is the same-origin Front Door route, so no CORS is involved on crossvertise pages.
+          * @default '/api-fd/v1/geo'
+         */
+        "apiBase": string;
+        /**
+          * @default '© CARTO, © OpenStreetMap contributors'
+         */
+        "attribution": string;
+        /**
+          * @default 51.16
+         */
+        "centerLat": number;
+        /**
+          * Initial map center
+          * @default 10.45
+         */
+        "centerLng": number;
+        /**
+          * Remove the optimizer proposal highlight.
+         */
+        "clearPreview": () => Promise<void>;
+        /**
+          * Clear the whole selection.
+         */
+        "clearSelection": () => Promise<void>;
+        /**
+          * Indicator whose per-unit values feed the tooltips and the emitted population sum (e.g. ATV_DEVICES)
+          * @default 'MBI_P_T_2025'
+         */
+        "indicator": string;
+        /**
+          * Unit label shown behind the indicator value in the tooltip
+          * @default 'Einwohner'
+         */
+        "indicatorLabel": string;
+        /**
+          * Load the map bundle only when scrolled near the viewport (default: true)
+          * @default true
+         */
+        "lazy": boolean;
+        /**
+          * Geo level to display and select: plz5, gemeinde, kreis, regbez, bundesland
+          * @default 'plz5'
+         */
+        "level": string;
+        /**
+          * Highlight what a radius extension would ADD (optimizer proposal): the units within `km` that are not part of the selection render in the preview color. Visual only — the selection and its change events stay untouched. Returns the number of added units.
+         */
+        "previewByRadius": (startPlz: string, km: number) => Promise<number>;
+        /**
+          * Shape resolution: medium = simplified geometry (snappy), high = originals
+          * @default 'medium'
+         */
+        "resolution": 'medium' | 'high';
+        /**
+          * Select all PLZs within `km` around a start PLZ ("Umkreis"). Replaces the selection unless `add` is true.
+         */
+        "selectByRadius": (startPlz: string, km: number, add?: boolean) => Promise<GeoMapSelection | null>;
+        /**
+          * Select an explicit list of PLZs ("PLZ-Liste" paste, query-param restore). Replaces the selection unless `add` is true.
+         */
+        "selectPostalCodes": (codes: string[], add?: boolean) => Promise<GeoMapSelection | null>;
+        /**
+          * Minimum zoom before boundaries are loaded and selectable (use ~5 for bundesland, 9 for plz5)
+          * @default 9
+         */
+        "selectZoom": number;
+        /**
+          * Raster tile URL template. Default: CARTO Positron — light, minimal, made for data overlays; fits the crossvertise design. For production traffic, license a tile plan (CARTO/MapTiler/Geofabrik) and set the keyed URL here.
+          * @default 'https://basemaps.cartocdn.com/rastertiles/light_all/{z}/{x}/{y}@2x.png'
+         */
+        "tiles": string;
+        /**
+          * Explicit URL of maplibre-gl-worker.mjs (maplibre-gl-shared.mjs must sit next to it). Needed when the host bundler relocates the maplibre chunk so import.meta.url-relative worker resolution breaks (e.g. Angular/Vite dev server).
+         */
+        "workerUrl"?: string;
+        /**
+          * @default 5.5
+         */
+        "zoom": number;
+    }
     interface XvHeader {
     }
     /**
@@ -740,6 +836,14 @@ export namespace Components {
     }
     interface XvPagination {
         "block"?: boolean;
+        /**
+          * @default 10
+         */
+        "itemsPerPage": number;
+        /**
+          * @default [10, 20, 30, 40, 50, 100]
+         */
+        "itemsPerPageOptions": number[] | string;
         /**
           * @default 1
          */
@@ -802,6 +906,7 @@ export namespace Components {
           * @default false
          */
         "error": string | boolean;
+        "helper"?: string;
         /**
           * @default false
          */
@@ -954,6 +1059,7 @@ export namespace Components {
          */
         "error": string | boolean;
         "focusInput": () => Promise<void>;
+        "helper"?: string;
         /**
           * @default ''
          */
@@ -1203,6 +1309,10 @@ export interface XvFileUploaderCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLXvFileUploaderElement;
 }
+export interface XvGeoMapV2CustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLXvGeoMapV2Element;
+}
 export interface XvHeaderCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLXvHeaderElement;
@@ -1598,6 +1708,31 @@ declare global {
         prototype: HTMLXvFooterElement;
         new (): HTMLXvFooterElement;
     };
+    interface HTMLXvGeoMapV2ElementEventMap {
+        "changeSelection": GeoMapSelection;
+        "mapReady": void;
+    }
+    /**
+     * Minimal ATV planner map: MapLibre + PLZ boundaries from the XvGeoTool API.
+     * Click a PLZ to (de)select it. No further UI — selection state and reach
+     * data are emitted via `changeSelection` for the host page to display.
+     * MapLibre (~250 KB gzip) is loaded lazily when the component scrolls near
+     * the viewport, so the host page's initial load stays untouched.
+     */
+    interface HTMLXvGeoMapV2Element extends Components.XvGeoMapV2, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLXvGeoMapV2ElementEventMap>(type: K, listener: (this: HTMLXvGeoMapV2Element, ev: XvGeoMapV2CustomEvent<HTMLXvGeoMapV2ElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLXvGeoMapV2ElementEventMap>(type: K, listener: (this: HTMLXvGeoMapV2Element, ev: XvGeoMapV2CustomEvent<HTMLXvGeoMapV2ElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLXvGeoMapV2Element: {
+        prototype: HTMLXvGeoMapV2Element;
+        new (): HTMLXvGeoMapV2Element;
+    };
     interface HTMLXvHeaderElementEventMap {
         "xvMetaNavUpdate": any;
     }
@@ -2090,6 +2225,7 @@ declare global {
         "xv-dropdown-v2-item": HTMLXvDropdownV2ItemElement;
         "xv-file-uploader": HTMLXvFileUploaderElement;
         "xv-footer": HTMLXvFooterElement;
+        "xv-geo-map-v2": HTMLXvGeoMapV2Element;
         "xv-header": HTMLXvHeaderElement;
         "xv-header-next": HTMLXvHeaderNextElement;
         "xv-image-viewer": HTMLXvImageViewerElement;
@@ -2221,7 +2357,7 @@ declare namespace LocalJSX {
          */
         "type"?: 'button' | 'submit' | 'reset';
         /**
-          * Button value is optional
+          * Button value is optional. Reflected — xv-button-group-v2 keys its children by the attribute.
          */
         "value"?: string;
         /**
@@ -2482,6 +2618,10 @@ declare namespace LocalJSX {
     interface XvDatepicker {
         "block"?: boolean;
         "disabled"?: boolean;
+        /**
+          * Individual dates to disable within the min/max range. Each entry may be a `Date`, a bare 'yyyy-MM-dd' string, or a full ISO string — all normalised to a local 'yyyy-MM-dd' key that matches the calendar grid. Composes with min/max: a day is selectable only when it is inside the range AND not listed here (e.g. to allow only certain weekdays / block holidays).
+         */
+        "disabledDates"?: (Date | string)[];
         /**
           * Error status. Can be boolean or string
          */
@@ -2635,6 +2775,84 @@ declare namespace LocalJSX {
     }
     interface XvFooter {
     }
+    /**
+     * Minimal ATV planner map: MapLibre + PLZ boundaries from the XvGeoTool API.
+     * Click a PLZ to (de)select it. No further UI — selection state and reach
+     * data are emitted via `changeSelection` for the host page to display.
+     * MapLibre (~250 KB gzip) is loaded lazily when the component scrolls near
+     * the viewport, so the host page's initial load stays untouched.
+     */
+    interface XvGeoMapV2 {
+        /**
+          * Base URL of the geo API (Xv.Api v1/geo — contract-compatible with the XvGeoTool API). Default is the same-origin Front Door route, so no CORS is involved on crossvertise pages.
+          * @default '/api-fd/v1/geo'
+         */
+        "apiBase"?: string;
+        /**
+          * @default '© CARTO, © OpenStreetMap contributors'
+         */
+        "attribution"?: string;
+        /**
+          * @default 51.16
+         */
+        "centerLat"?: number;
+        /**
+          * Initial map center
+          * @default 10.45
+         */
+        "centerLng"?: number;
+        /**
+          * Indicator whose per-unit values feed the tooltips and the emitted population sum (e.g. ATV_DEVICES)
+          * @default 'MBI_P_T_2025'
+         */
+        "indicator"?: string;
+        /**
+          * Unit label shown behind the indicator value in the tooltip
+          * @default 'Einwohner'
+         */
+        "indicatorLabel"?: string;
+        /**
+          * Load the map bundle only when scrolled near the viewport (default: true)
+          * @default true
+         */
+        "lazy"?: boolean;
+        /**
+          * Geo level to display and select: plz5, gemeinde, kreis, regbez, bundesland
+          * @default 'plz5'
+         */
+        "level"?: string;
+        /**
+          * Selection changed: selected PLZs + population sum of the selection
+         */
+        "onChangeSelection"?: (event: XvGeoMapV2CustomEvent<GeoMapSelection>) => void;
+        /**
+          * Map finished initializing
+         */
+        "onMapReady"?: (event: XvGeoMapV2CustomEvent<void>) => void;
+        /**
+          * Shape resolution: medium = simplified geometry (snappy), high = originals
+          * @default 'medium'
+         */
+        "resolution"?: 'medium' | 'high';
+        /**
+          * Minimum zoom before boundaries are loaded and selectable (use ~5 for bundesland, 9 for plz5)
+          * @default 9
+         */
+        "selectZoom"?: number;
+        /**
+          * Raster tile URL template. Default: CARTO Positron — light, minimal, made for data overlays; fits the crossvertise design. For production traffic, license a tile plan (CARTO/MapTiler/Geofabrik) and set the keyed URL here.
+          * @default 'https://basemaps.cartocdn.com/rastertiles/light_all/{z}/{x}/{y}@2x.png'
+         */
+        "tiles"?: string;
+        /**
+          * Explicit URL of maplibre-gl-worker.mjs (maplibre-gl-shared.mjs must sit next to it). Needed when the host bundler relocates the maplibre chunk so import.meta.url-relative worker resolution breaks (e.g. Angular/Vite dev server).
+         */
+        "workerUrl"?: string;
+        /**
+          * @default 5.5
+         */
+        "zoom"?: number;
+    }
     interface XvHeader {
         "onXvMetaNavUpdate"?: (event: XvHeaderCustomEvent<any>) => void;
     }
@@ -2876,6 +3094,14 @@ declare namespace LocalJSX {
     }
     interface XvPagination {
         "block"?: boolean;
+        /**
+          * @default 10
+         */
+        "itemsPerPage"?: number;
+        /**
+          * @default [10, 20, 30, 40, 50, 100]
+         */
+        "itemsPerPageOptions"?: number[] | string;
         "onPageChange"?: (event: XvPaginationCustomEvent<{ page: number, itemsPerPage: number; }>) => void;
         /**
           * @default 1
@@ -2939,6 +3165,7 @@ declare namespace LocalJSX {
           * @default false
          */
         "error"?: string | boolean;
+        "helper"?: string;
         /**
           * @default false
          */
@@ -3097,6 +3324,7 @@ declare namespace LocalJSX {
           * @default false
          */
         "error"?: string | boolean;
+        "helper"?: string;
         /**
           * @default ''
          */
@@ -3319,6 +3547,7 @@ declare namespace LocalJSX {
         "xv-dropdown-v2-item": XvDropdownV2Item;
         "xv-file-uploader": XvFileUploader;
         "xv-footer": XvFooter;
+        "xv-geo-map-v2": XvGeoMapV2;
         "xv-header": XvHeader;
         "xv-header-next": XvHeaderNext;
         "xv-image-viewer": XvImageViewer;
@@ -3420,6 +3649,14 @@ declare module "@stencil/core" {
             "xv-dropdown-v2-item": LocalJSX.XvDropdownV2Item & JSXBase.HTMLAttributes<HTMLXvDropdownV2ItemElement>;
             "xv-file-uploader": LocalJSX.XvFileUploader & JSXBase.HTMLAttributes<HTMLXvFileUploaderElement>;
             "xv-footer": LocalJSX.XvFooter & JSXBase.HTMLAttributes<HTMLXvFooterElement>;
+            /**
+             * Minimal ATV planner map: MapLibre + PLZ boundaries from the XvGeoTool API.
+             * Click a PLZ to (de)select it. No further UI — selection state and reach
+             * data are emitted via `changeSelection` for the host page to display.
+             * MapLibre (~250 KB gzip) is loaded lazily when the component scrolls near
+             * the viewport, so the host page's initial load stays untouched.
+             */
+            "xv-geo-map-v2": LocalJSX.XvGeoMapV2 & JSXBase.HTMLAttributes<HTMLXvGeoMapV2Element>;
             "xv-header": LocalJSX.XvHeader & JSXBase.HTMLAttributes<HTMLXvHeaderElement>;
             /**
              * Drop-in successor of `xv-header` for the new headless CMS.

package/dist/types/utils/utils.d.ts

@@ -3,6 +3,15 @@ type FetchInit = RequestInit & Partial<{
     raw: boolean;
 }>;
 export declare function format(first?: string, middle?: string, last?: string): string;
+/**
+ * Returns the highest-priority field message (error → warning → helper):
+ * the first field carrying a non-empty string. Boolean flags (border/icon
+ * state only) carry no text and are skipped.
+ */
+export declare const resolveFieldMessage: (fields: Record<"error" | "warning" | "helper", string | boolean | null | undefined>) => {
+    level: "error" | "warning" | "helper";
+    text: string;
+} | null;
 export declare function uidGenerator(): string;
 /**
  * Walks through the given DOM collection and runs the given callback.

package/dist/xv-webcomponents/index.esm.js

@@ -1 +1 @@
-export{c as format}from"./p-OqHMuwQF.js";
+export{e as format}from"./p-CQm2sRKT.js";