@projektemacher/storymapjs 0.10.1 → 0.10.3

package/dist/js/storymap.d.ts

@@ -1,1357 +1,1431 @@
-import OlMap from 'ol/Map';
-import { Vector, Tile } from 'ol/layer';
-import { Style } from 'ol/style';
-import Projection from 'ol/proj/Projection';
-import TileGrid from 'ol/tilegrid/TileGrid';
-import OverviewMap from 'ol/control/OverviewMap';
-import { Map as Map$1 } from 'ol';
-import Overlay from 'ol/Overlay';
+import { default as default_2 } from 'ol/control/OverviewMap';
+import { default as default_3 } from 'ol/Map';
+import { default as default_4 } from 'ol/Overlay';
+import { default as default_5 } from 'ol/tilegrid/TileGrid';
+import { default as default_6 } from 'ol/proj/Projection';
+import { Map as Map_3 } from 'ol';
+import { Style } from 'ol/style';
+import { Tile } from 'ol/layer';
+import { Vector } from 'ol/layer';
+
+declare interface AnimationHandle {
+    stop: (jump?: boolean) => void;
+}
+
+/**
+ * Per-StoryMap GDPR consent manager. When the `consent_required` option is
+ * set, every external service (media embeds, map tiles, external font CSS)
+ * asks for permission before anything is loaded. Decisions are remembered
+ * per service in a cookie for 90 days — clearing cookies asks again.
+ */
+declare class ConsentManager {
+    private granted;
+    private denied;
+    /** unanswered asks per service (preloaded slides stack several) */
+    private pending;
+    constructor();
+    /** Seed the per-service state from the consent cookie, if present. */
+    private restore;
+    /** Persist the per-service state to the consent cookie. */
+    private persist;
+    isGranted(service: string): boolean;
+    isDenied(service: string): boolean;
+    /**
+     * Ask the visitor for permission to load `service` (a human-readable
+     * name like "YouTube" or "map tiles"), optionally naming the `host`.
+     * The ask is rendered into `container`; resolves `true`/`false` on the
+     * visitor's decision, or immediately when the service was already
+     * granted or denied.
+     */
+    request(service: string, host: string, container: HTMLElement): Promise<boolean>;
+}
+
+declare interface DragData {
+    sliding: boolean;
+    direction: string | null;
+    pagex: {
+        start: number;
+        end: number;
+    };
+    pagey: {
+        start: number;
+        end: number;
+    };
+    pos: {
+        start: {
+            x: number;
+            y: number;
+        };
+        end: {
+            x: number;
+            y: number;
+        };
+    };
+    new_pos: {
+        x: number;
+        y: number;
+    };
+    new_pos_parent: {
+        x: number;
+        y: number;
+    };
+    time: {
+        start: number;
+        end: number;
+    };
+    touch: boolean;
+}
+
+declare interface DragEventNames {
+    down: string;
+    up: string;
+    leave: string;
+    move: string;
+}
+
+/** Eventing members provided by the Evented mixin. */
+declare interface EventedInstance {
+    on: (type: string, fn: unknown, context?: unknown) => unknown;
+    off: (type: string, fn: unknown, context?: unknown) => unknown;
+    fire: (type: string, data?: unknown, target?: unknown) => unknown;
+    hasEventListeners: (type: string) => boolean;
+}
+
+declare type IconSpec = {
+    url: string;
+    size: number[];
+    anchor: number[];
+};
+
+declare interface LanguageEntry {
+    buttons?: Record<string, string>;
+    messages?: Record<string, string>;
+    [key: string]: unknown;
+}
+
+declare interface LatLngLiteral {
+    lat: number | undefined;
+    lon?: number | undefined;
+    lng?: number | undefined;
+}
+
+/** Legacy drag handlers historically mixed mouse and touch event surfaces. */
+declare type LegacyEvent = Event & {
+    originalEvent?: TouchEvent;
+    targetTouches?: TouchList;
+    pageX?: number;
+    pageY?: number;
+};
+
+/** A point of the connection line: either a slide or a raw lat/lon pair. */
+declare interface LinePoint {
+    location?: StorymapSlideLocation;
+    lat?: number;
+    lon?: number;
+}
+
+/**
+ * Append one stylesheet to the document head.
+ *
+ * @param url - The stylesheet URL.
+ * @param options - Optional AbortSignal to cancel an in-flight load.
+ * @returns Resolves when the stylesheet has loaded, rejects on error or abort.
+ */
+export declare function loadCSS(url: string, options?: LoadOptions): Promise<void>;
+
+declare interface LoadOptions {
+    /** Abort the load (removes the element, rejects the promise). */
+    signal?: AbortSignal;
+}
+
+declare class Map_2 extends Map_base {
+    constructor(...args: ConstructorParameters<typeof MapBase>);
+}
+
+declare const Map_base: {
+    new (...args: any[]): {
+        show(animate?: unknown): void;
+        hide(): void;
+        addTo(container: HTMLElement): /*elided*/ any;
+        removeFrom(container: HTMLElement): /*elided*/ any;
+        setPosition(pos: Record<string, number>, el?: HTMLElement): /*elided*/ any;
+        onLoaded(): void;
+        onAdd(): void;
+        onRemove(): void;
+        _el: Record<string, HTMLElement>;
+        data?: unknown;
+        on: (type: string, fn: unknown, context?: unknown) => unknown;
+        off: (type: string, fn: unknown, context?: unknown) => unknown;
+        fire: (type: string, data?: unknown, target?: unknown) => unknown;
+        hasEventListeners: (type: string) => boolean;
+    };
+} & {
+    new (...args: any[]): {
+        _vco_events?: Record<string, {
+            action: unknown;
+            context: unknown;
+        }[]>;
+        on(type: string, fn: unknown, context?: unknown): /*elided*/ any;
+        hasEventListeners(type: string): boolean;
+        off(type: string, fn: unknown, context?: unknown): /*elided*/ any;
+        fire(type: string, data?: unknown, target?: unknown): /*elided*/ any;
+    };
+} & typeof MapBase;
+
+declare class MapBase {
+    "_el": {
+        container: HTMLElement;
+        map: HTMLElement;
+        map_mask: HTMLElement;
+    };
+    "_loaded": {
+        data: boolean;
+        map: boolean;
+    };
+    "_map": Map_3 | null;
+    "_mini_map": default_2 | null;
+    "_markers": MapMarker[];
+    "zoom_min_max": {
+        min: number | null;
+        max: number | null;
+    };
+    "_line": Vector | null;
+    "_line_active": Vector | null;
+    "current_marker": number;
+    "bounds_array": number[][] | null;
+    "_tile_layer": Tile | null;
+    "_tile_layer_mini": Tile | null;
+    "_image_layer": Tile | null;
+    "data": StorymapData;
+    "options": StorymapOptions;
+    "animator": AnimationHandle | null;
+    "_transition_duration": number;
+    "timer": ReturnType<typeof setTimeout> | null;
+    "touch_scale": number;
+    "scroll": ScrollState;
+    "fire": EventedInstance["fire"];
+    constructor(elem: string | HTMLElement, data?: Partial<StorymapData>, options?: Partial<StorymapOptions>);
+    updateDisplay(w: number, h: number, animate?: boolean, d?: number, offset?: unknown): void;
+    goTo(n: number, change?: boolean): void;
+    panTo(loc: LatLngLiteral, animate?: boolean): void;
+    zoomTo(z: number, animate?: boolean): void;
+    viewTo(loc: StorymapSlideLocation, opts?: ViewToOptions): void;
+    getBoundsZoom(m1: LatLngLiteral, m2: LatLngLiteral, inside?: boolean, padding?: unknown): void;
+    markerOverview(): void;
+    calculateMarkerZooms(): void;
+    createMiniMap(): void;
+    setMapOffset(left: number, top: number): void;
+    calculateMinMaxZoom(): void;
+    updateMinMaxZoom(zoom: number): void;
+    initialMapLocation(): void;
+    show(): void;
+    hide(): void;
+    createMarkers(array: StorymapSlide[]): void;
+    createMarker(d: StorymapSlide): void;
+    _destroyMarker(marker: MapMarker): void;
+    _createMarkers(array: StorymapSlide[]): void;
+    /**
+     * A slide has a real location: lat and lon are both numbers — lat 0 and
+     * lon 0 are valid coordinates and must not be treated as missing.
+     */
+    _hasLocation(d: StorymapSlide): boolean;
+    _createMap(): void;
+    _createMiniMap(): void;
+    _createMarker(d?: StorymapSlide): void;
+    _addMarker(marker: MapMarker): void;
+    _removeMarker(marker: MapMarker): void;
+    _resetMarkersActive(): void;
+    _calculateMarkerZooms(): void;
+    _createLine(d?: StorymapSlide): unknown;
+    _addToLine(line: Vector | null, d: LinePoint): void;
+    _replaceLines(line: Vector | null, d: LinePoint[], animate?: {
+        duration: number;
+        retractFrom?: LinePoint[] | null;
+        growFrom?: LinePoint[] | null;
+    }): void;
+    _addLineToMap(line: Vector): void;
+    _panTo(loc: LatLngLiteral, animate?: boolean): void;
+    _zoomTo(z: number, animate?: boolean): void;
+    _viewTo(loc: StorymapSlideLocation, opts?: ViewToOptions): void;
+    _updateMapDisplay(animate?: boolean, d?: number): void;
+    _refreshMap(): void;
+    _getMapZoom(): number;
+    _getMapCenter(correct_for_center?: boolean): LatLngLiteral;
+    _getBoundsZoom(m1: LatLngLiteral, m2: LatLngLiteral, inside?: boolean, padding?: unknown): number;
+    _markerOverview(duration?: number): void;
+    /**
+     * Great-circle length of the route through all markers in kilometers;
+     * `undefined` when the map cannot compute it or there are fewer than two
+     * markers (issue #341).
+     */
+    getRouteDistance(): number | undefined;
+    _onMarkerChange(e?: unknown): void;
+    _onMarkerClick(e: {
+        marker_number: number;
+    }): void;
+    _onMapLoaded(e?: unknown): void;
+    _onWheel(e: WheelEvent): void;
+    _scollZoom(e?: unknown): void;
+    _scollZoomDone(e?: unknown): void;
+    _calculateZoomChange(origin: LatLngLiteral, destination: LatLngLiteral, correct_for_center?: boolean): number;
+    _updateDisplay(w?: number, h?: number, animate?: boolean, d?: number, offset?: unknown): void;
+    /** Re-apply runtime-changed options (no-op in the base class) */
+    applyOptions(_keys: string[]): void;
+    _initLayout(): void;
+    _initData(): void;
+    /** Hook after marker creation (overridden per engine as needed) */
+    _afterCreateMarkers(): void;
+    _initEvents(): void;
+}
+
+declare class MapMarker extends MapMarker_base {
+    constructor(...args: ConstructorParameters<typeof MapMarkerBase>);
+}
+
+declare const MapMarker_base: {
+    new (...args: any[]): {
+        _vco_events?: Record<string, {
+            action: unknown;
+            context: unknown;
+        }[]>;
+        on(type: string, fn: unknown, context?: unknown): /*elided*/ any;
+        hasEventListeners(type: string): boolean;
+        off(type: string, fn: unknown, context?: unknown): /*elided*/ any;
+        fire(type: string, data?: unknown, target?: unknown): /*elided*/ any;
+    };
+} & typeof MapMarkerBase;
+
+declare class MapMarkerBase {
+    "_el": Record<string, HTMLElement>;
+    "_marker": HTMLDivElement;
+    "_icon": IconSpec | HTMLDivElement | false;
+    "_custom_icon": IconSpec | false;
+    "_custom_icon_url": string;
+    "_custom_image_icon": string | false;
+    "marker_number": number;
+    "media_icon_class": string;
+    "timer": ReturnType<typeof setTimeout> | null;
+    "data": MapMarkerData;
+    "options": StorymapOptions;
+    "animator": AnimationHandle | null;
+    "fire": EventedInstance["fire"];
+    constructor(data?: MapMarkerData, options?: Partial<StorymapOptions>);
+    show(): void;
+    hide(): void;
+    addTo(m: unknown): void;
+    removeFrom(m: unknown): void;
+    updateDisplay(w: number, h: number, a?: boolean): void;
+    createMarker(d?: MapMarkerData, o?: StorymapOptions): void;
+    active(a: boolean): void;
+    location(): LatLngLiteral;
+    _createMarker(d?: MapMarkerData, o?: StorymapOptions): void;
+    _addTo(m: unknown): void;
+    _removeFrom(m: unknown): void;
+    _active(a: boolean): void;
+    _location(): LatLngLiteral;
+    _onMarkerClick(e?: unknown): void;
+    _initLayout(): void;
+    _updateDisplay(width: number, height: number, animate?: boolean): void;
+}
+
+declare interface MapMarkerData {
+    real_marker?: boolean;
+    location?: StorymapSlideLocation;
+    media?: StorymapSlideMedia & {
+        mediatype?: MediaTypeMatch | null;
+    };
+    text?: {
+        headline?: string;
+    };
+    type?: string;
+    [key: string]: unknown;
+}
+
+declare interface MediaInstance {
+    addTo: (container: HTMLElement) => void;
+    loadMedia: () => void;
+    stopMedia: () => void;
+    updateDisplay: (w?: number, h?: number, l?: string) => void;
+    _state?: {
+        loaded?: boolean;
+    };
+}
+
+/**
+ * Resolve the media handler for a slide's media object: matches the URL (and
+ * optional explicit `type`) against the supported media types — YouTube,
+ * Vimeo, images, audio, video, ...
+ *
+ * @param m - The slide media definition.
+ * @returns The matching media type entry, or `false` for unknown media.
+ */
+export declare function MediaType(m: StorymapSlideMedia): MediaTypeMatch | false;
+
+declare type MediaTypeMatch = {
+    type: string;
+    name: string;
+    match_str: string;
+    cls: new (data: StorymapSlideMedia, options: Record<string, unknown>) => unknown;
+};
+
+declare class MenuBar extends MenuBar_base {
+    constructor(...args: ConstructorParameters<typeof MenuBarBase>);
+}
+
+declare const MenuBar_base: {
+    new (...args: any[]): {
+        show(animate?: unknown): void;
+        hide(): void;
+        addTo(container: HTMLElement): /*elided*/ any;
+        removeFrom(container: HTMLElement): /*elided*/ any;
+        setPosition(pos: Record<string, number>, el?: HTMLElement): /*elided*/ any;
+        onLoaded(): void;
+        onAdd(): void;
+        onRemove(): void;
+        _el: Record<string, HTMLElement>;
+        data?: unknown;
+        on: (type: string, fn: unknown, context?: unknown) => unknown;
+        off: (type: string, fn: unknown, context?: unknown) => unknown;
+        fire: (type: string, data?: unknown, target?: unknown) => unknown;
+        hasEventListeners: (type: string) => boolean;
+    };
+} & {
+    new (...args: any[]): {
+        _vco_events?: Record<string, {
+            action: unknown;
+            context: unknown;
+        }[]>;
+        on(type: string, fn: unknown, context?: unknown): /*elided*/ any;
+        hasEventListeners(type: string): boolean;
+        off(type: string, fn: unknown, context?: unknown): /*elided*/ any;
+        fire(type: string, data?: unknown, target?: unknown): /*elided*/ any;
+    };
+} & typeof MenuBarBase;
+
+declare class MenuBarBase {
+    "_el": Record<string, HTMLElement>;
+    "collapsed": boolean;
+    "options": MenuBarOptions;
+    "animator": Record<string, unknown>;
+    "fire": EventedInstance["fire"];
+    constructor(elem: HTMLElement | string, parent_elem?: HTMLElement, options?: object);
+    show(d?: number): void;
+    hide(top: number): void;
+    setSticky(y: number): void;
+    setColor(inverted: boolean): void;
+    /**
+     * Reflect the fullscreen state in the button label/icon.
+     */
+    setFullscreenState(active: boolean): void;
+    /**
+     * Update the progress indicator (issue #247); no-op when disabled.
+     */
+    setProgress(current: number, total: number): void;
+    /**
+     * Update the route distance display (issue #341); no-op when disabled or
+     * before the first reading.
+     */
+    setDistance(kilometers?: number): void;
+    updateDisplay(w?: number, h?: number, a?: boolean): void;
+    _onButtonOverview(e: Event): void;
+    _onButtonBackToStart(e: Event): void;
+    _onButtonFullscreen(e: Event): void;
+    _onButtonCollapseMap(e: Event): void;
+    _initLayout(): void;
+    _updateDisplay(width?: number, height?: number, animate?: boolean): void;
+}
+
+declare interface MenuBarOptions {
+    width: number;
+    height: number;
+    duration: number;
+    ease: unknown;
+    menubar_default_y: number;
+    [key: string]: unknown;
+}
+
+declare class Message extends Message_base {
+    constructor(...args: ConstructorParameters<typeof MessageBase>);
+}
+
+declare const Message_base: {
+    new (...args: any[]): {
+        show(animate?: unknown): void;
+        hide(): void;
+        addTo(container: HTMLElement): /*elided*/ any;
+        removeFrom(container: HTMLElement): /*elided*/ any;
+        setPosition(pos: Record<string, number>, el?: HTMLElement): /*elided*/ any;
+        onLoaded(): void;
+        onAdd(): void;
+        onRemove(): void;
+        _el: Record<string, HTMLElement>;
+        data?: unknown;
+        on: (type: string, fn: unknown, context?: unknown) => unknown;
+        off: (type: string, fn: unknown, context?: unknown) => unknown;
+        fire: (type: string, data?: unknown, target?: unknown) => unknown;
+        hasEventListeners: (type: string) => boolean;
+    };
+} & {
+    new (...args: any[]): {
+        _vco_events?: Record<string, {
+            action: unknown;
+            context: unknown;
+        }[]>;
+        on(type: string, fn: unknown, context?: unknown): /*elided*/ any;
+        hasEventListeners(type: string): boolean;
+        off(type: string, fn: unknown, context?: unknown): /*elided*/ any;
+        fire(type: string, data?: unknown, target?: unknown): /*elided*/ any;
+    };
+} & typeof MessageBase;
+
+declare class MessageBase {
+    "_el": Record<string, HTMLElement>;
+    "options": MessageOptions;
+    "data": Record<string, unknown>;
+    "animator": Record<string, unknown>;
+    "fire": EventedInstance["fire"];
+    constructor(data?: Record<string, unknown>, options?: Record<string, unknown>, add_to_container?: HTMLElement);
+    updateMessage(t: string): void;
+    _updateMessage(t?: string): void;
+    _onMouseClick(): void;
+    _initLayout(): void;
+    _initEvents(): void;
+}
+
+declare interface MessageOptions {
+    width: number;
+    height: number;
+    message_class: string;
+    message_icon_class: string;
+    [key: string]: unknown;
+}
+
+declare class OpenLayers extends Map_2 {
+    "_map": default_3;
+    "_tile_layer": Tile;
+    "_line": Vector;
+    "_line_active": Vector;
+    "_tile_layer_mini": Tile | null;
+    "_mini_map": default_2;
+    "_markers": OpenLayersMapMarker[];
+    /** rAF handle of the running active-line draw animation */
+    "_line_animation": number | null;
+    _createMap(): void;
+    _getAttribution(map_type: string): string;
+    /**
+     * Create the tile layer and register its load handler. Deferred until
+     * the visitor allows map tiles in consent mode.
+     */
+    _addTileLayer(): void;
+    /**
+     * Ask for tile consent, then attach the layers if allowed.
+     */
+    _requestTileConsent(consent: ConsentManager, tile_service: string): Promise<void>;
+    /**
+     * Map tiles were allowed: attach the main tile layer, create the
+     * minimap's deferred layer if it was withheld, then re-fit.
+     */
+    _onTilesAllowed(): void;
+    /**
+     * Legacy zoomify image pyramid: the levels (image size per level), the
+     * max zoom and the mercator bounds the image occupies (stretched from
+     * the world's top-left corner, the original renderer's mapping).
+     */
+    _zoomifyPyramid(): {
+        sizes: Array<[number, number]>;
+        maxZoom: number;
+        extent: number[];
+        tileGrid: default_5;
+    } | null;
+    /**
+     * The zoomify overview state: the best-fit pyramid level for a map
+     * window (the level whose image, times the tolerance, fits the window —
+     * the legacy `_getBestFitZoom`) and the image's mercator center.
+     */
+    _zoomifyOverview(mapSize: [number, number]): {
+        zoom: number;
+        center: number[];
+    } | null;
+    _createTileLayer(map_type: string): Tile;
+    _createVectorStyleLayer(style_url: string): Tile;
+    _createMiniMap(): void;
+    _fitMiniMapToImage(): void;
+    _createMarker(d: StorymapSlide): void;
+    _addMarker(marker: OpenLayersMapMarker): void;
+    /**
+     * Position marker overlays on the unwrapped longitude path so they sit on
+     * the same world copy as the fitted view and the line (issue #381).
+     * Image-space coordinates are not degrees and stay untouched.
+     */
+    _afterCreateMarkers(): void;
+    _removeMarker(marker: OpenLayersMapMarker): void;
+    _getAllMarkersBounds(markers_array: OpenLayersMapMarker[]): number[][];
+    /**
+     * Normalize a longitude sequence so consecutive values differ by at most
+     * 180 degrees: markers keep their raw coordinates (OpenLayers wraps the
+     * display), but fits and lines use the unwrapped path (issue #381).
+     */
+    _unwrapLongitudes(lons: number[]): number[];
+    _markerCoordsToViewCoords(coords: number[][]): number[][];
+    /**
+     * The View extent for the `map_bbox` option, or `null` when unset.
+     */
+    _bboxExtent(): number[] | null;
+    /**
+     * The slide content panel can be opaque — it then covers part of the map
+     * and the effective visible area shrinks. Returns the pixel padding for
+     * the covered side (right in landscape, bottom in portrait) so fits keep
+     * the story inside the visible region; transparent panels add nothing.
+     */
+    _opaquePanelPadding(): [number, number, number, number];
+    _fitView(ol_map: default_3, coords: number[][], duration?: number): void;
+    _calculateMarkerZooms(): void;
+    /**
+     * Stroke style for the route lines: the dash pattern and line join are
+     * applied at init too, matching the original rendering (the lines are
+     * dashed "5,5" by default, not solid).
+     */
+    _lineStyle(color: string): Style;
+    _createLine(d?: StorymapSlide): Vector;
+    _addLineToMap(line: Vector): void;
+    _addToLine(line: Vector, d: LinePoint): void;
+    /**
+     * Replace a line's geometry. With `animate.duration > 0` only the latest
+     * hop animates, in sync with the view animation: the already-traveled
+     * prefix stays drawn while the new segment traces progressively, so half
+     * way through the pan the old connections are fully red and only half
+     * the new hop is. Backward navigation mirrors this: the traveled prefix
+     * stays drawn while the far end pulls back along the abandoned hop.
+     */
+    _replaceLines(line: Vector, array: LinePoint[], animate?: {
+        duration: number;
+        retractFrom?: LinePoint[] | null;
+        growFrom?: LinePoint[] | null;
+    }): void;
+    /** Cancel a running active-line draw animation. */
+    _cancelLineAnimation(): void;
+    /** Total euclidean length of a path in view coordinates. */
+    _pathLength(coords: number[][]): number;
+    /**
+     * The prefix of the path up to `length` (in view units), with the cut
+     * point interpolated inside its segment.
+     */
+    _truncatePath(coords: number[][], length: number): number[][];
+    _panTo(loc: LatLngLiteral, animate?: boolean): void;
+    _zoomTo(z: number, animate?: boolean): void;
+    _viewTo(loc: StorymapSlideLocation, opts?: ViewToOptions): void;
+    _toViewCoords(loc: LatLngLiteral): number[];
+    _getMapZoom(): number;
+    _getMapCenter(offset?: boolean): LatLngLiteral;
+    _getMapCenterOffset(location: LatLngLiteral, zoom: number): LatLngLiteral;
+    _fromViewCoords(coord: number[], projection: default_6): LatLngLiteral;
+    _getBoundsZoom(origin: LatLngLiteral, destination: LatLngLiteral, correct_for_center?: boolean): number;
+    _initialMapLocation(): void;
+    /**
+     * Great-circle (haversine) length of the route through all markers in
+     * kilometers (issue #341).
+     */
+    getRouteDistance(): number | undefined;
+    _markerOverview(duration?: number): void;
+    /**
+     * Re-apply runtime-changed options (driven by StoryMap.setMapOptions).
+     * Only keys with an immediate effect are handled here; everything else is
+     * picked up on the next navigation or layout pass.
+     */
+    applyOptions(keys: string[]): void;
+    _updateMapDisplay(animate?: boolean, d?: number, instant?: boolean): void;
+    _refreshMap(instant?: boolean): void;
+    /**
+     * Set the view synchronously (resize path): OL's animate() applies its
+     * end state asynchronously which can leave marker overlays rendering
+     * stale positions after a size change.
+     */
+    _setViewInstant(loc: StorymapSlideLocation, zoom: number): void;
+}
+
+declare class OpenLayersMapMarker extends MapMarker {
+    "_overlay": default_4;
+    _createMarker(d?: MapMarkerData, o?: StorymapOptions): void;
+    _createMarkerElement(d: MapMarkerData, o?: StorymapOptions): HTMLDivElement;
+    _addTo(m: Map_3): void;
+    _removeFrom(m: Map_3): void;
+    _active(a: boolean): void;
+    _customIconAnchor(size?: number[]): number[];
+    _location(): LatLngLiteral;
+}
+
+/** Wheel/scroll zoom bookkeeping (handles cleared via clearTimeout). */
+declare interface ScrollState {
+    start_time: number | null;
+    timer?: ReturnType<typeof setTimeout>;
+    timer_done?: ReturnType<typeof setTimeout>;
+}
+
+/**
+ * Switch the active UI language.
+ *
+ * @param code - A locale code for which a locale file exists (e.g. `"en"`).
+ * @returns The language entry that is now active.
+ */
+export declare function setLanguage(code: string): LanguageEntry;
+
+declare class Slide extends Slide_base {
+    constructor(...args: ConstructorParameters<typeof SlideBase>);
+}
+
+declare const Slide_base: {
+    new (...args: any[]): {
+        show(animate?: unknown): void;
+        hide(): void;
+        addTo(container: HTMLElement): /*elided*/ any;
+        removeFrom(container: HTMLElement): /*elided*/ any;
+        setPosition(pos: Record<string, number>, el?: HTMLElement): /*elided*/ any;
+        onLoaded(): void;
+        onAdd(): void;
+        onRemove(): void;
+        _el: Record<string, HTMLElement>;
+        data?: unknown;
+        on: (type: string, fn: unknown, context?: unknown) => unknown;
+        off: (type: string, fn: unknown, context?: unknown) => unknown;
+        fire: (type: string, data?: unknown, target?: unknown) => unknown;
+        hasEventListeners: (type: string) => boolean;
+    };
+} & {
+    new (...args: any[]): {
+        _vco_events?: Record<string, {
+            action: unknown;
+            context: unknown;
+        }[]>;
+        on(type: string, fn: unknown, context?: unknown): /*elided*/ any;
+        hasEventListeners(type: string): boolean;
+        off(type: string, fn: unknown, context?: unknown): /*elided*/ any;
+        fire(type: string, data?: unknown, target?: unknown): /*elided*/ any;
+    };
+} & typeof SlideBase;
+
+declare interface SlideBackgroundChange {
+    color_value?: string;
+    image?: boolean;
+}
+
+declare class SlideBase {
+    "_el": Record<string, HTMLElement>;
+    "_media": MediaInstance | null;
+    "_mediaclass": unknown;
+    "_text": Text_2;
+    "_state": {
+        loaded: boolean;
+    };
+    "has": SlideHas;
+    "title": string;
+    "data": StorymapSlide;
+    "options": SlideOptions;
+    "active": boolean;
+    "animator": unknown;
+    "fire": EventedInstance["fire"];
+    "onLoaded": () => void;
+    constructor(data: StorymapSlide, options: Record<string, unknown>, title_slide?: boolean);
+    show(): void;
+    hide(): void;
+    setActive(is_active: boolean): void;
+    updateDisplay(w?: number, h?: number, l?: string): void;
+    loadMedia(): void;
+    stopMedia(): void;
+    getBackground(): {
+        image: boolean;
+        color: boolean;
+        color_value: string;
+    };
+    scrollToTop(): void;
+    addCallToAction(str: string): void;
+    _onCallToAction(e: Event): void;
+    _initLayout(): void;
+    _updateDisplay(width?: number, height?: number, layout?: string): void;
+}
+
+declare interface SlideHas {
+    headline: boolean;
+    text: boolean;
+    media: boolean;
+    title: boolean;
+    background: {
+        image: boolean;
+        color: boolean;
+        color_value: string;
+    };
+}
+
+declare class SlideNav extends SlideNav_base {
+    constructor(...args: ConstructorParameters<typeof SlideNavBase>);
+}
+
+declare const SlideNav_base: {
+    new (...args: any[]): {
+        show(animate?: unknown): void;
+        hide(): void;
+        addTo(container: HTMLElement): /*elided*/ any;
+        removeFrom(container: HTMLElement): /*elided*/ any;
+        setPosition(pos: Record<string, number>, el?: HTMLElement): /*elided*/ any;
+        onLoaded(): void;
+        onAdd(): void;
+        onRemove(): void;
+        _el: Record<string, HTMLElement>;
+        data?: unknown;
+        on: (type: string, fn: unknown, context?: unknown) => unknown;
+        off: (type: string, fn: unknown, context?: unknown) => unknown;
+        fire: (type: string, data?: unknown, target?: unknown) => unknown;
+        hasEventListeners: (type: string) => boolean;
+    };
+} & {
+    new (...args: any[]): {
+        _vco_events?: Record<string, {
+            action: unknown;
+            context: unknown;
+        }[]>;
+        on(type: string, fn: unknown, context?: unknown): /*elided*/ any;
+        hasEventListeners(type: string): boolean;
+        off(type: string, fn: unknown, context?: unknown): /*elided*/ any;
+        fire(type: string, data?: unknown, target?: unknown): /*elided*/ any;
+    };
+} & typeof SlideNavBase;
+
+declare class SlideNavBase {
+    "_el": Record<string, HTMLElement>;
+    "mediatype": unknown;
+    "data": SlideNavData;
+    "options": SlideNavOptions;
+    "animator": AnimationHandle | null;
+    "animator_position": AnimationHandle | null;
+    "fire": EventedInstance["fire"];
+    constructor(data?: Partial<SlideNavData>, options?: Partial<SlideNavOptions>, add_to_container?: HTMLElement);
+    update(d?: Partial<SlideNavData>): void;
+    setColor(inverted: boolean): void;
+    updatePosition(pos: Record<string, number | string>, use_percent: boolean, duration: number, ease: unknown, start_value: number, return_to_default: boolean): void;
+    _onUpdatePositionComplete(return_to_default: boolean): void;
+    _onMouseClick(): void;
+    _update(d?: Partial<SlideNavData>): void;
+    _initLayout(): void;
+    _initEvents(): void;
+}
+
+declare interface SlideNavData {
+    title: string;
+    description: string;
+    date?: string;
+    [key: string]: unknown;
+}
+
+declare interface SlideNavOptions {
+    direction: string;
+    [key: string]: unknown;
+}
+
+declare interface SlideOptions {
+    duration: number;
+    slide_padding_lr: number;
+    ease: unknown;
+    width: number;
+    height: number;
+    skinny_size: number;
+    media_name?: string;
+    media_type?: string;
+    [key: string]: unknown;
+}
+
+export declare class StoryMap extends StoryMap_base {
+    /**
+     * The library base path (the directory containing the module).
+     * Derived from `import.meta.url`, which works both for the source module
+     * (src/main.ts) and the built ESM bundle (js/storymap.js).
+     */
+    static SCRIPT_PATH: string;
+    constructor(...args: ConstructorParameters<typeof StoryMapBase>);
+}
+
+declare const StoryMap_base: {
+    new (...args: any[]): {
+        _vco_events?: Record<string, {
+            action: unknown;
+            context: unknown;
+        }[]>;
+        on(type: string, fn: unknown, context?: unknown): /*elided*/ any;
+        hasEventListeners(type: string): boolean;
+        off(type: string, fn: unknown, context?: unknown): /*elided*/ any;
+        fire(type: string, data?: unknown, target?: unknown): /*elided*/ any;
+    };
+} & typeof StoryMapBase;
+
+/**
+ * Interactive StoryMap viewer.
+ *
+ * Renders a storymap JSON document (or a IIIF Presentation 3 manifest) into an
+ * element: an OpenLayers map on one side and a slide slider on the other.
+ *
+ * @example
+ * ```ts
+ * import { StoryMap } from "storymapjs";
+ * // from an inline data object
+ * const map = new StoryMap("embed", { storymap: { ... } }, { start_at_slide: 2 });
+ * // or straight from a source file (storymap JSON or IIIF manifest)
+ * const map2 = new StoryMap(document.getElementById("embed"), "./my-storymap.json");
+ * ```
+ */
+declare class StoryMapBase {
+    "_loaded": {
+        storyslider: boolean;
+        map: boolean;
+    };
+    "on": EventedInstance["on"];
+    "version": string;
+    "ready": boolean;
+    "_el": {
+        container: HTMLElement;
+        menubar: HTMLElement;
+        map: HTMLElement;
+        storyslider: HTMLElement;
+    };
+    "_storyslider": StorySlider;
+    "_map": OpenLayers;
+    "map": Map_3;
+    "_menubar": MenuBar;
+    "data": StorymapData;
+    "options": StorymapOptions;
+    "current_slide": number;
+    "animator_map": AnimationHandle | null;
+    "animator_storyslider": AnimationHandle | null;
+    "_autoplay_timer": ReturnType<typeof setTimeout> | null;
+    "_autoplay_stopped": boolean;
+    "_hash_initialized": boolean;
+    /** the data source was a IIIF Presentation manifest (legacy zoomify options are ignored) */
+    "_data_from_manifest": boolean;
+    "_resize_observer": ResizeObserver | null;
+    "_resize_timer": ReturnType<typeof setTimeout> | null;
+    "fire": EventedInstance["fire"];
+    "hasEventListeners": EventedInstance["hasEventListeners"];
+    /**
+     * Create a StoryMap inside the given element.
+     *
+     * @param elem - The container element, or its DOM id.
+     * @param data - Either an inline storymap document (`{ storymap: ... }`),
+     *   an inline IIIF Presentation 3 manifest, or the URL of a source file
+     *   (storymap JSON or IIIF manifest) that is fetched automatically.
+     * @param options - Optional {@link StorymapOptions} overrides (map type,
+     *   lines, fonts, animation, raw OpenLayers options via `map_options`...).
+     * @param listeners - Optional event listeners keyed by event name
+     *   (`change`, `title`, `loaded`, ...) attached on creation.
+     */
+    constructor(elem: string | HTMLElement, data: string | StorymapDataWrapper | Record<string, unknown>, options?: Partial<StorymapOptions>, listeners?: Record<string, StoryMapListener | StoryMapListener[]>);
+    _initData(data: string | StorymapDataWrapper | Record<string, unknown>): void;
+    _loadDataFromUrl(url: string, source: string): Promise<void>;
+    _initOptions(): void;
+    _loadLanguage(): void;
+    _loadFontCss(): Promise<void>;
+    _onFontLoaded(font: string): void;
+    /**
+     * Navigate to a slide by index.
+     *
+     * @param n - Zero-based slide index; the map animates to the slide's
+     *   marker (or the overview when `n` is 0 for storymaps with one).
+     */
+    goTo(n: number): void;
+    /**
+     * Re-measure the container and re-layout the map, slider and menubar.
+     * Called automatically on resize (see the `trackResize` option).
+     */
+    updateDisplay(): void;
+    /**
+     * Change a single map option at runtime and apply its effect immediately.
+     *
+     * Runtime-changeable options: `map_type` (rebuilds the tile layer),
+     * `show_lines`, `line_color`, `line_color_inactive`, `line_weight`,
+     * `line_opacity`, `line_dash`, `line_join`, `line_follows_path`,
+     * `show_history_line` (restyled instantly), `map_center_offset` (applied on
+     * the next navigation), `duration`, `ease`, `calculate_zoom`,
+     * `map_background_color`. All other options only take effect on the next
+     * navigation or require re-creating the StoryMap.
+     */
+    setMapOption(name: string, value: unknown): void;
+    /**
+     * Change several map options at runtime (see setMapOption).
+     */
+    setMapOptions(options: Partial<StorymapOptions>): void;
+    _initLayout(): void;
+    _initEvents(): void;
+    _updateDisplay(map_height?: number, animate?: boolean, d?: number): void;
+    _onDataLoaded(e?: unknown): void;
+    _startAutoplay(): void;
+    _scheduleAutoplay(): void;
+    _stopAutoplay(): void;
+    /** Keep the URL hash in sync with the current slide (#slide-N). */
+    _syncHash(): void;
+    /** A #slide-N hash deep-links the storymap (applied on load + hashchange). */
+    _applyHashSlide(): boolean;
+    _initResizeHandling(): void;
+    /**
+     * Resolve a caller-supplied map element (options.map_options.element).
+     * The passed element is "replaced by the real one": it is adopted as the
+     * map container (given the vco-map class) and moved into place between
+     * the menubar and the story slider.
+     */
+    _resolveMapElement(): HTMLElement | null;
+    _onTitle(e: unknown): void;
+    _onColorChange(e: {
+        color?: unknown;
+        image?: unknown;
+    }): void;
+    _onSlideChange(e: {
+        current_slide: number;
+    }): void;
+    _onMapChange(e: {
+        current_marker: number;
+    }): void;
+    _updateProgress(): void;
+    _onOverview(e?: unknown): void;
+    /**
+     * Toggle the native fullscreen API on the storymap container and keep the
+     * menubar button state in sync.
+     */
+    _onFullscreenToggle(e?: unknown): void;
+    _onFullscreenChange(): void;
+    _onBackToStart(e?: unknown): void;
+    _onMenuBarCollapse(e: {
+        y: number;
+    }): void;
+    _onMapLoaded(): void;
+    _onStorySliderLoaded(): void;
+    /**
+     * Compute and display the great-circle distance of the marker route
+     * (issue #341); hidden when `show_distance` is off.
+     */
+    _updateDistance(): void;
+    _onLoaded(): void;
+}
+
+declare interface StorymapData {
+    uniqueid?: string;
+    slides: StorymapSlide[];
+    [key: string]: unknown;
+}
+
+export declare interface StorymapDataWrapper {
+    storymap: StorymapData;
+}
+
+declare interface StorymapError {
+    path: string;
+    message: string;
+}
+
+declare type StoryMapListener = (e: unknown) => void;
+
+/** OpenLayers passthrough options (see StorymapOptions.map_options) */
+declare interface StorymapMapOptions {
+    /** HTMLElement or DOM id that becomes the real map container */
+    element?: HTMLElement | string;
+    /** Merged over the default view configuration */
+    view?: Record<string, unknown>;
+    /** Replaces the default (empty) controls list */
+    controls?: unknown[];
+    /** Replaces the default (empty) interactions list */
+    interactions?: unknown[];
+    /** Any other ol/Map constructor option (layers, pixelRatio, ...) */
+    [key: string]: unknown;
+}
+
+export declare interface StorymapOptions {
+    width: number;
+    height: number;
+    layout: string;
+    base_class: string;
+    default_bg_color: {
+        r: number;
+        g: number;
+        b: number;
+    };
+    map_size_sticky: number;
+    map_center_offset: {
+        left: number;
+        top: number;
+    } | null;
+    less_bounce: boolean;
+    start_at_slide: number;
+    call_to_action: boolean;
+    call_to_action_text: string;
+    menubar_height: number;
+    /** Show a fullscreen toggle button in the menubar (default: true) */
+    fullscreen: boolean;
+    /** Show the map overview button in the menubar (default: true) */
+    show_overview: boolean;
+    /** Show the back-to-the-beginning button in the menubar (default: true) */
+    show_back_to_start: boolean;
+    skinny_size: number;
+    duration: number;
+    ease: unknown;
+    dragging: boolean;
+    trackResize: boolean;
+    /** Re-fetch the source file on every load, bypassing caches (issue #417) */
+    nocache: boolean;
+    /** Advance slides automatically every N milliseconds; 0 disables (issue #380) */
+    autoplay: number;
+    /** Show a progress bar in the menubar (issue #247) */
+    show_progress: boolean;
+    /** Show the slide headline as a label on the active map marker (issue #243) */
+    marker_labels: boolean;
+    /** Default text alignment for slide text: left, center or right (issue #244) */
+    text_align: "left" | "center" | "right";
+    /** Override the overview fit center (issues #107, #271) */
+    map_overview_center: {
+        lat: number;
+        lon: number;
+    } | null;
+    map_type: string;
+    attribution: string;
+    map_mini: boolean;
+    map_subdomains: string;
+    map_as_image: boolean;
+    map_access_token: string;
+    map_background_color: string;
+    /**
+     * Limit the map to a bounding box `[west, south, east, north]` (lon/lat;
+     * raw image pixel coordinates for image-space maps). Nothing outside of
+     * the box can be visible. `null` (default) leaves the map unconstrained.
+     */
+    map_bbox: number[] | null;
+    /**
+     * Legacy zoomify image pyramid (map_type: "zoomify"): the tiles are
+     * placed at the standard mercator tile positions, stretched from the
+     * world's top-left corner.
+     */
+    zoomify?: {
+        path?: string;
+        width?: number;
+        height?: number;
+        tolerance?: number;
+        attribution?: string;
+    } | boolean;
+    /**
+     * Ask for permission before loading anything from external services
+     * (media embeds, map tiles, external font CSS) — GDPR consent mode.
+     * Grants are remembered per service in a cookie for 90 days.
+     */
+    consent_required: boolean;
+    /** Slide text color override, sets --vco-color-text (issue #177) */
+    text_color: string;
+    /** Slide panel background color override (issue #177) */
+    text_background_color: string;
+    /** Show the great-circle route distance in the menubar (issue #341) */
+    show_distance: boolean;
+    /**
+     * Raw OpenLayers map configuration. `controls` and `interactions` replace
+     * the StoryMapJS defaults, `view` is merged over the computed default view
+     * and `element` (an HTMLElement or DOM id) replaces the auto-created map
+     * container div.
+     */
+    map_options: StorymapMapOptions;
+    map_popup: boolean;
+    zoom_distance: number;
+    calculate_zoom: boolean;
+    line_follows_path: boolean;
+    line_color: string;
+    line_color_inactive: string;
+    line_join: string;
+    line_weight: number;
+    line_opacity: number;
+    line_dash: string;
+    show_lines: boolean;
+    show_history_line: boolean;
+    use_custom_markers: boolean;
+    iiif: {
+        url: string;
+        attribution: string;
+    };
+    map_height: number;
+    storyslider_height: number;
+    slide_padding_lr: number;
+    slide_default_fade: string;
+    menubar_default_y: number;
+    path_gfx: string;
+    script_path: string;
+    font_css: string;
+    language: string;
+    api_key_flickr: string;
+    [key: string]: unknown;
+}
+
+export declare interface StorymapSlide {
+    type?: string;
+    date?: string | Record<string, unknown> | null;
+    group?: string;
+    location?: StorymapSlideLocation;
+    media?: StorymapSlideMedia;
+    text?: StorymapSlideText;
+    background?: StorymapSlideBackground | string | null;
+    uniqueid?: string;
+    [key: string]: unknown;
+}
+
+declare interface StorymapSlideBackground {
+    url?: string | null;
+    color?: string | null;
+    opacity?: number;
+}
+
+declare interface StorymapSlideLocation {
+    lat?: number;
+    lon?: number;
+    zoom?: number;
+    line?: boolean;
+    icon?: string;
+    iconSize?: number[];
+    image?: string;
+    use_custom_marker?: boolean;
+    [key: string]: unknown;
+}
+
+declare interface StorymapSlideMedia {
+    url?: string | null;
+    caption?: string | null;
+    credit?: string | null;
+    thumb?: string | null;
+    mediatype?: MediaTypeMatch | null;
+    [key: string]: unknown;
+}
+
+declare interface StorymapSlideText {
+    headline?: string;
+    text?: string;
+    text_align?: string;
+}
+
+declare class StorySlider extends StorySlider_base {
+    constructor(...args: ConstructorParameters<typeof StorySliderBase>);
+}
+
+declare const StorySlider_base: {
+    new (...args: any[]): {
+        _vco_events?: Record<string, {
+            action: unknown;
+            context: unknown;
+        }[]>;
+        on(type: string, fn: unknown, context?: unknown): /*elided*/ any;
+        hasEventListeners(type: string): boolean;
+        off(type: string, fn: unknown, context?: unknown): /*elided*/ any;
+        fire(type: string, data?: unknown, target?: unknown): /*elided*/ any;
+    };
+} & typeof StorySliderBase;
+
+declare class StorySliderBase {
+    "_el": Record<string, HTMLElement>;
+    "_nav": {
+        previous: SlideNav;
+        next: SlideNav;
+    };
+    "slide_spacing": number;
+    "_slides": Slide[];
+    "_swipable": Swipable;
+    "preloadTimer": ReturnType<typeof setTimeout>;
+    "_message": Message;
+    "current_slide": number;
+    "current_bg_color": string | null;
+    "data": Partial<StorymapData>;
+    "options": StorySliderOptions;
+    "animator": AnimationHandle | null;
+    "animator_background": AnimationHandle | null;
+    "fire": EventedInstance["fire"];
+    "_loaded": boolean;
+    "hasEventListeners": EventedInstance["hasEventListeners"];
+    constructor(elem: HTMLElement | string, data: Partial<StorymapData>, options?: Partial<StorySliderOptions>, init?: boolean);
+    init(): void;
+    updateDisplay(w?: number, h?: number, a?: unknown, l?: string): void;
+    createSlide(d: StorymapSlide): void;
+    createSlides(array: StorymapData["slides"]): void;
+    _createSlides(array: StorymapData["slides"]): void;
+    _createSlide(d: StorymapSlide, title_slide?: boolean): void;
+    _addSlide(slide: Slide): void;
+    goToId(n: string | number, fast?: boolean, displayupdate?: boolean): void;
+    goTo(n: number, fast?: boolean, displayupdate?: boolean): void;
+    preloadSlides(): void;
+    getNavInfo(slide: Slide): {
+        title: string;
+        description: string;
+    };
+    next(): void;
+    previous(): void;
+    showNav(nav_obj: SlideNav, show: boolean): void;
+    changeBackground(bg: SlideBackgroundChange): void;
+    fadeInBackground(bg_css: string): void;
+    _updateDisplay(width?: number, height?: number, animate?: unknown, layout?: string): void;
+    _introInterface(): void;
+    _initLayout(): void;
+    _initEvents(): void;
+    _onKeyDown(e: Event): void;
+    _initData(): void;
+    _onBackgroundChange(e: SlideBackgroundChange): void;
+    _onMessageClick(e?: unknown): void;
+    _onSwipeNoDirection(e?: unknown): void;
+    _onNavigation(e: {
+        direction: string;
+    }): void;
+    _onSlideAdded(e?: unknown): void;
+    _onSlideChange(displayupdate?: boolean): void;
+    _onLoaded(): void;
+}
+
+declare interface StorySliderOptions {
+    id?: string;
+    layout: string;
+    width: number;
+    height: number;
+    default_bg_color: {
+        r: number;
+        g: number;
+        b: number;
+    };
+    slide_padding_lr: number;
+    start_at_slide: number;
+    slide_default_fade: string;
+    duration: number;
+    ease: unknown;
+    skinny_size?: number;
+    call_to_action?: boolean;
+    call_to_action_text?: string;
+    dragging?: boolean;
+    trackResize?: boolean;
+    [key: string]: unknown;
+}
+
+declare class Swipable extends Swipable_base {
+    constructor(...args: ConstructorParameters<typeof SwipableBase>);
+}
+
+declare const Swipable_base: {
+    new (...args: any[]): {
+        _vco_events?: Record<string, {
+            action: unknown;
+            context: unknown;
+        }[]>;
+        on(type: string, fn: unknown, context?: unknown): /*elided*/ any;
+        hasEventListeners(type: string): boolean;
+        off(type: string, fn: unknown, context?: unknown): /*elided*/ any;
+        fire(type: string, data?: unknown, target?: unknown): /*elided*/ any;
+    };
+} & typeof SwipableBase;
+
+declare class SwipableBase {
+    "mousedrag": DragEventNames;
+    "touchdrag": DragEventNames;
+    "_el": Record<string, HTMLElement>;
+    "options": SwipableOptions;
+    "animator": AnimationHandle | null;
+    "dragevent": DragEventNames;
+    "data": DragData;
+    "fire": EventedInstance["fire"];
+    constructor(drag_elem: HTMLElement, move_elem?: HTMLElement, options?: Record<string, unknown>);
+    enable(e?: LegacyEvent): void;
+    disable(): void;
+    stopMomentum(): void;
+    updateConstraint(c: SwipableOptions["constraint"]): void;
+    _onDragStart(e: LegacyEvent): void;
+    _onDragEnd(e: LegacyEvent): void;
+    _onDragMove(e: LegacyEvent): void;
+    _momentum(): void;
+    _animateMomentum(): void;
+}
+
+declare interface SwipableOptions {
+    snap: boolean;
+    enable: {
+        x: boolean;
+        y: boolean;
+    };
+    constraint: {
+        top: number | boolean;
+        bottom: number | boolean;
+        left: number | boolean;
+        right: number | boolean;
+    };
+    momentum_multiplier: number;
+    duration: number;
+    ease: unknown;
+}
+
+declare class Text_2 extends Text_base {
+    constructor(...args: ConstructorParameters<typeof TextBase>);
+}
+
+declare const Text_base: {
+    new (...args: any[]): {
+        _vco_events?: Record<string, {
+            action: unknown;
+            context: unknown;
+        }[]>;
+        on(type: string, fn: unknown, context?: unknown): /*elided*/ any;
+        hasEventListeners(type: string): boolean;
+        off(type: string, fn: unknown, context?: unknown): /*elided*/ any;
+        fire(type: string, data?: unknown, target?: unknown): /*elided*/ any;
+    };
+} & typeof TextBase;
+
+declare class TextBase {
+    "_el": Record<string, HTMLElement>;
+    "data": TextData;
+    "options": TextOptions;
+    "fire": EventedInstance["fire"];
+    constructor(data: TextData, options?: TextOptions, add_to_container?: HTMLElement);
+    show(): void;
+    hide(): void;
+    addTo(container: HTMLElement): void;
+    removeFrom(container: HTMLElement): void;
+    headlineHeight(): number;
+    addDateText(str: string): void;
+    onLoaded(): void;
+    onAdd(): void;
+    onRemove(): void;
+    _initLayout(): void;
+}
+
+declare interface TextData {
+    uniqueid?: string | null;
+    headline?: string;
+    text?: string;
+    text_align?: string;
+    date?: {
+        created_time?: string;
+        [key: string]: unknown;
+    } | null;
+}
+
+declare interface TextOptions {
+    title?: boolean;
+    text_align?: string;
+}
+
+/** Validate storymap JSON (the object containing a "storymap" property). */
+export declare function validateStorymap(data: unknown): StorymapError[];
+
+/** Validate and report all errors to the JavaScript console. Returns true when valid. */
+export declare function validateStorymapAndReport(data: unknown, source?: string): boolean;
+
+/** Options accepted by viewTo/_viewTo. */
+declare interface ViewToOptions {
+    calculate_zoom?: boolean;
+    duration?: number;
+    zoom?: number;
+}
+
+export { }
 
-/** Eventing members provided by the Evented mixin. */
-interface EventedInstance {
-    on: (type: string, fn: unknown, context?: unknown) => unknown;
-    off: (type: string, fn: unknown, context?: unknown) => unknown;
-    fire: (type: string, data?: unknown, target?: unknown) => unknown;
-    hasEventListeners: (type: string) => boolean;
-}
-
-interface StorymapSlideText {
-    headline?: string;
-    text?: string;
-    text_align?: string;
-}
-interface StorymapSlideLocation {
-    lat?: number;
-    lon?: number;
-    zoom?: number;
-    line?: boolean;
-    icon?: string;
-    iconSize?: number[];
-    image?: string;
-    use_custom_marker?: boolean;
-    [key: string]: unknown;
-}
-type MediaTypeMatch = {
-    type: string;
-    name: string;
-    match_str: string;
-    cls: new (data: StorymapSlideMedia, options: Record<string, unknown>) => unknown;
-};
-interface StorymapSlideMedia {
-    url?: string | null;
-    caption?: string | null;
-    credit?: string | null;
-    thumb?: string | null;
-    mediatype?: MediaTypeMatch | null;
-    [key: string]: unknown;
-}
-interface StorymapSlideBackground {
-    url?: string | null;
-    color?: string | null;
-    opacity?: number;
-}
-interface StorymapSlide {
-    type?: string;
-    date?: string | Record<string, unknown> | null;
-    group?: string;
-    location?: StorymapSlideLocation;
-    media?: StorymapSlideMedia;
-    text?: StorymapSlideText;
-    background?: StorymapSlideBackground | string | null;
-    uniqueid?: string;
-    [key: string]: unknown;
-}
-interface StorymapData {
-    uniqueid?: string;
-    slides: StorymapSlide[];
-    [key: string]: unknown;
-}
-interface StorymapDataWrapper {
-    storymap: StorymapData;
-}
-interface StorymapOptions {
-    width: number;
-    height: number;
-    layout: string;
-    base_class: string;
-    default_bg_color: {
-        r: number;
-        g: number;
-        b: number;
-    };
-    map_size_sticky: number;
-    map_center_offset: {
-        left: number;
-        top: number;
-    } | null;
-    less_bounce: boolean;
-    start_at_slide: number;
-    call_to_action: boolean;
-    call_to_action_text: string;
-    menubar_height: number;
-    /** Show a fullscreen toggle button in the menubar (default: true) */
-    fullscreen: boolean;
-    /** Show the map overview button in the menubar (default: true) */
-    show_overview: boolean;
-    /** Show the back-to-the-beginning button in the menubar (default: true) */
-    show_back_to_start: boolean;
-    skinny_size: number;
-    duration: number;
-    ease: unknown;
-    dragging: boolean;
-    trackResize: boolean;
-    /** Re-fetch the source file on every load, bypassing caches (issue #417) */
-    nocache: boolean;
-    /** Advance slides automatically every N milliseconds; 0 disables (issue #380) */
-    autoplay: number;
-    /** Show a progress bar in the menubar (issue #247) */
-    show_progress: boolean;
-    /** Show the slide headline as a label on the active map marker (issue #243) */
-    marker_labels: boolean;
-    /** Default text alignment for slide text: left, center or right (issue #244) */
-    text_align: "left" | "center" | "right";
-    /** Override the overview fit center (issues #107, #271) */
-    map_overview_center: {
-        lat: number;
-        lon: number;
-    } | null;
-    map_type: string;
-    attribution: string;
-    map_mini: boolean;
-    map_subdomains: string;
-    map_as_image: boolean;
-    map_access_token: string;
-    map_background_color: string;
-    /**
-     * Limit the map to a bounding box `[west, south, east, north]` (lon/lat;
-     * raw image pixel coordinates for image-space maps). Nothing outside of
-     * the box can be visible. `null` (default) leaves the map unconstrained.
-     */
-    map_bbox: number[] | null;
-    /**
-     * Legacy zoomify image pyramid (map_type: "zoomify"): the tiles are
-     * placed at the standard mercator tile positions, stretched from the
-     * world's top-left corner.
-     */
-    zoomify?: {
-        path?: string;
-        width?: number;
-        height?: number;
-        tolerance?: number;
-        attribution?: string;
-    } | boolean;
-    /**
-     * Ask for permission before loading anything from external services
-     * (media embeds, map tiles, external font CSS) — GDPR consent mode.
-     * Grants are remembered per service in a cookie for 90 days.
-     */
-    consent_required: boolean;
-    /** Slide text color override, sets --vco-color-text (issue #177) */
-    text_color: string;
-    /** Slide panel background color override (issue #177) */
-    text_background_color: string;
-    /** Show the great-circle route distance in the menubar (issue #341) */
-    show_distance: boolean;
-    /**
-     * Raw OpenLayers map configuration. `controls` and `interactions` replace
-     * the StoryMapJS defaults, `view` is merged over the computed default view
-     * and `element` (an HTMLElement or DOM id) replaces the auto-created map
-     * container div.
-     */
-    map_options: StorymapMapOptions;
-    map_popup: boolean;
-    zoom_distance: number;
-    calculate_zoom: boolean;
-    line_follows_path: boolean;
-    line_color: string;
-    line_color_inactive: string;
-    line_join: string;
-    line_weight: number;
-    line_opacity: number;
-    line_dash: string;
-    show_lines: boolean;
-    show_history_line: boolean;
-    use_custom_markers: boolean;
-    iiif: {
-        url: string;
-        attribution: string;
-    };
-    map_height: number;
-    storyslider_height: number;
-    slide_padding_lr: number;
-    slide_default_fade: string;
-    menubar_default_y: number;
-    path_gfx: string;
-    script_path: string;
-    font_css: string;
-    language: string;
-    api_key_flickr: string;
-    [key: string]: unknown;
-}
-interface AnimationHandle {
-    stop: (jump?: boolean) => void;
-}
-/** OpenLayers passthrough options (see StorymapOptions.map_options) */
-interface StorymapMapOptions {
-    /** HTMLElement or DOM id that becomes the real map container */
-    element?: HTMLElement | string;
-    /** Merged over the default view configuration */
-    view?: Record<string, unknown>;
-    /** Replaces the default (empty) controls list */
-    controls?: unknown[];
-    /** Replaces the default (empty) interactions list */
-    interactions?: unknown[];
-    /** Any other ol/Map constructor option (layers, pixelRatio, ...) */
-    [key: string]: unknown;
-}
-interface LatLngLiteral {
-    lat: number | undefined;
-    lon?: number | undefined;
-    lng?: number | undefined;
-}
-interface MapMarkerData {
-    real_marker?: boolean;
-    location?: StorymapSlideLocation;
-    media?: StorymapSlideMedia & {
-        mediatype?: MediaTypeMatch | null;
-    };
-    text?: {
-        headline?: string;
-    };
-    type?: string;
-    [key: string]: unknown;
-}
-type IconSpec = {
-    url: string;
-    size: number[];
-    anchor: number[];
-};
-
-declare class MapMarkerBase {
-    "_el": Record<string, HTMLElement>;
-    "_marker": HTMLDivElement;
-    "_icon": IconSpec | HTMLDivElement | false;
-    "_custom_icon": IconSpec | false;
-    "_custom_icon_url": string;
-    "_custom_image_icon": string | false;
-    "marker_number": number;
-    "media_icon_class": string;
-    "timer": ReturnType<typeof setTimeout> | null;
-    "data": MapMarkerData;
-    "options": StorymapOptions;
-    "animator": AnimationHandle | null;
-    "fire": EventedInstance["fire"];
-    constructor(data?: MapMarkerData, options?: Partial<StorymapOptions>);
-    show(): void;
-    hide(): void;
-    addTo(m: unknown): void;
-    removeFrom(m: unknown): void;
-    updateDisplay(w: number, h: number, a?: boolean): void;
-    createMarker(d?: MapMarkerData, o?: StorymapOptions): void;
-    active(a: boolean): void;
-    location(): LatLngLiteral;
-    _createMarker(d?: MapMarkerData, o?: StorymapOptions): void;
-    _addTo(m: unknown): void;
-    _removeFrom(m: unknown): void;
-    _active(a: boolean): void;
-    _location(): LatLngLiteral;
-    _onMarkerClick(e?: unknown): void;
-    _initLayout(): void;
-    _updateDisplay(width: number, height: number, animate?: boolean): void;
-}
-declare const MapMarker_base: {
-    new (...args: any[]): {
-        _vco_events?: Record<string, {
-            action: unknown;
-            context: unknown;
-        }[]>;
-        on(type: string, fn: unknown, context?: unknown): /*elided*/ any;
-        hasEventListeners(type: string): boolean;
-        off(type: string, fn: unknown, context?: unknown): /*elided*/ any;
-        fire(type: string, data?: unknown, target?: unknown): /*elided*/ any;
-    };
-} & typeof MapMarkerBase;
-declare class MapMarker extends MapMarker_base {
-    constructor(...args: ConstructorParameters<typeof MapMarkerBase>);
-}
-
-/** Options accepted by viewTo/_viewTo. */
-interface ViewToOptions {
-    calculate_zoom?: boolean;
-    duration?: number;
-    zoom?: number;
-}
-/** A point of the connection line: either a slide or a raw lat/lon pair. */
-interface LinePoint {
-    location?: StorymapSlideLocation;
-    lat?: number;
-    lon?: number;
-}
-
-/** Wheel/scroll zoom bookkeeping (handles cleared via clearTimeout). */
-interface ScrollState {
-    start_time: number | null;
-    timer?: ReturnType<typeof setTimeout>;
-    timer_done?: ReturnType<typeof setTimeout>;
-}
-declare class MapBase {
-    "_el": {
-        container: HTMLElement;
-        map: HTMLElement;
-        map_mask: HTMLElement;
-    };
-    "_loaded": {
-        data: boolean;
-        map: boolean;
-    };
-    "_map": Map$1 | null;
-    "_mini_map": OverviewMap | null;
-    "_markers": MapMarker[];
-    "zoom_min_max": {
-        min: number | null;
-        max: number | null;
-    };
-    "_line": Vector | null;
-    "_line_active": Vector | null;
-    "current_marker": number;
-    "bounds_array": number[][] | null;
-    "_tile_layer": Tile | null;
-    "_tile_layer_mini": Tile | null;
-    "_image_layer": Tile | null;
-    "data": StorymapData;
-    "options": StorymapOptions;
-    "animator": AnimationHandle | null;
-    "_transition_duration": number;
-    "timer": ReturnType<typeof setTimeout> | null;
-    "touch_scale": number;
-    "scroll": ScrollState;
-    "fire": EventedInstance["fire"];
-    constructor(elem: string | HTMLElement, data?: Partial<StorymapData>, options?: Partial<StorymapOptions>);
-    updateDisplay(w: number, h: number, animate?: boolean, d?: number, offset?: unknown): void;
-    goTo(n: number, change?: boolean): void;
-    panTo(loc: LatLngLiteral, animate?: boolean): void;
-    zoomTo(z: number, animate?: boolean): void;
-    viewTo(loc: StorymapSlideLocation, opts?: ViewToOptions): void;
-    getBoundsZoom(m1: LatLngLiteral, m2: LatLngLiteral, inside?: boolean, padding?: unknown): void;
-    markerOverview(): void;
-    calculateMarkerZooms(): void;
-    createMiniMap(): void;
-    setMapOffset(left: number, top: number): void;
-    calculateMinMaxZoom(): void;
-    updateMinMaxZoom(zoom: number): void;
-    initialMapLocation(): void;
-    show(): void;
-    hide(): void;
-    createMarkers(array: StorymapSlide[]): void;
-    createMarker(d: StorymapSlide): void;
-    _destroyMarker(marker: MapMarker): void;
-    _createMarkers(array: StorymapSlide[]): void;
-    /**
-     * A slide has a real location: lat and lon are both numbers — lat 0 and
-     * lon 0 are valid coordinates and must not be treated as missing.
-     */
-    _hasLocation(d: StorymapSlide): boolean;
-    _createMap(): void;
-    _createMiniMap(): void;
-    _createMarker(d?: StorymapSlide): void;
-    _addMarker(marker: MapMarker): void;
-    _removeMarker(marker: MapMarker): void;
-    _resetMarkersActive(): void;
-    _calculateMarkerZooms(): void;
-    _createLine(d?: StorymapSlide): unknown;
-    _addToLine(line: Vector | null, d: LinePoint): void;
-    _replaceLines(line: Vector | null, d: LinePoint[], animate?: {
-        duration: number;
-        retractFrom?: LinePoint[];
-    }): void;
-    _addLineToMap(line: Vector): void;
-    _panTo(loc: LatLngLiteral, animate?: boolean): void;
-    _zoomTo(z: number, animate?: boolean): void;
-    _viewTo(loc: StorymapSlideLocation, opts?: ViewToOptions): void;
-    _updateMapDisplay(animate?: boolean, d?: number): void;
-    _refreshMap(): void;
-    _getMapZoom(): number;
-    _getMapCenter(correct_for_center?: boolean): LatLngLiteral;
-    _getBoundsZoom(m1: LatLngLiteral, m2: LatLngLiteral, inside?: boolean, padding?: unknown): number;
-    _markerOverview(duration?: number): void;
-    /**
-     * Great-circle length of the route through all markers in kilometers;
-     * `undefined` when the map cannot compute it or there are fewer than two
-     * markers (issue #341).
-     */
-    getRouteDistance(): number | undefined;
-    _onMarkerChange(e?: unknown): void;
-    _onMarkerClick(e: {
-        marker_number: number;
-    }): void;
-    _onMapLoaded(e?: unknown): void;
-    _onWheel(e: WheelEvent): void;
-    _scollZoom(e?: unknown): void;
-    _scollZoomDone(e?: unknown): void;
-    _calculateZoomChange(origin: LatLngLiteral, destination: LatLngLiteral, correct_for_center?: boolean): number;
-    _updateDisplay(w?: number, h?: number, animate?: boolean, d?: number, offset?: unknown): void;
-    /** Re-apply runtime-changed options (no-op in the base class) */
-    applyOptions(_keys: string[]): void;
-    _initLayout(): void;
-    _initData(): void;
-    /** Hook after marker creation (overridden per engine as needed) */
-    _afterCreateMarkers(): void;
-    _initEvents(): void;
-}
-declare const Map_base: {
-    new (...args: any[]): {
-        show(animate?: unknown): void;
-        hide(): void;
-        addTo(container: HTMLElement): /*elided*/ any;
-        removeFrom(container: HTMLElement): /*elided*/ any;
-        setPosition(pos: Record<string, number>, el?: HTMLElement): /*elided*/ any;
-        onLoaded(): void;
-        onAdd(): void;
-        onRemove(): void;
-        _el: Record<string, HTMLElement>;
-        data?: unknown;
-        on: (type: string, fn: unknown, context?: unknown) => unknown;
-        off: (type: string, fn: unknown, context?: unknown) => unknown;
-        fire: (type: string, data?: unknown, target?: unknown) => unknown;
-        hasEventListeners: (type: string) => boolean;
-    };
-} & {
-    new (...args: any[]): {
-        _vco_events?: Record<string, {
-            action: unknown;
-            context: unknown;
-        }[]>;
-        on(type: string, fn: unknown, context?: unknown): /*elided*/ any;
-        hasEventListeners(type: string): boolean;
-        off(type: string, fn: unknown, context?: unknown): /*elided*/ any;
-        fire(type: string, data?: unknown, target?: unknown): /*elided*/ any;
-    };
-} & typeof MapBase;
-declare class Map extends Map_base {
-    constructor(...args: ConstructorParameters<typeof MapBase>);
-}
-
-declare class OpenLayersMapMarker extends MapMarker {
-    "_overlay": Overlay;
-    _createMarker(d?: MapMarkerData, o?: StorymapOptions): void;
-    _createMarkerElement(d: MapMarkerData, o?: StorymapOptions): HTMLDivElement;
-    _addTo(m: Map$1): void;
-    _removeFrom(m: Map$1): void;
-    _active(a: boolean): void;
-    _customIconAnchor(size?: number[]): number[];
-    _location(): LatLngLiteral;
-}
-
-/**
- * Per-StoryMap GDPR consent manager. When the `consent_required` option is
- * set, every external service (media embeds, map tiles, external font CSS)
- * asks for permission before anything is loaded. Decisions are remembered
- * per service in a cookie for 90 days — clearing cookies asks again.
- */
-declare class ConsentManager {
-    private granted;
-    private denied;
-    /** unanswered asks per service (preloaded slides stack several) */
-    private pending;
-    constructor();
-    /** Seed the per-service state from the consent cookie, if present. */
-    private restore;
-    /** Persist the per-service state to the consent cookie. */
-    private persist;
-    isGranted(service: string): boolean;
-    isDenied(service: string): boolean;
-    /**
-     * Ask the visitor for permission to load `service` (a human-readable
-     * name like "YouTube" or "map tiles"), optionally naming the `host`.
-     * The ask is rendered into `container`; resolves `true`/`false` on the
-     * visitor's decision, or immediately when the service was already
-     * granted or denied.
-     */
-    request(service: string, host: string, container: HTMLElement): Promise<boolean>;
-}
-
-declare class OpenLayers extends Map {
-    "_map": OlMap;
-    "_tile_layer": Tile;
-    "_line": Vector;
-    "_line_active": Vector;
-    "_tile_layer_mini": Tile | null;
-    "_mini_map": OverviewMap;
-    "_markers": OpenLayersMapMarker[];
-    /** rAF handle of the running active-line draw animation */
-    "_line_animation": number | null;
-    _createMap(): void;
-    _getAttribution(map_type: string): string;
-    /**
-     * Create the tile layer and register its load handler. Deferred until
-     * the visitor allows map tiles in consent mode.
-     */
-    _addTileLayer(): void;
-    /**
-     * Ask for tile consent, then attach the layers if allowed.
-     */
-    _requestTileConsent(consent: ConsentManager, tile_service: string): Promise<void>;
-    /**
-     * Map tiles were allowed: attach the main tile layer, create the
-     * minimap's deferred layer if it was withheld, then re-fit.
-     */
-    _onTilesAllowed(): void;
-    /**
-     * Legacy zoomify image pyramid: the levels (image size per level), the
-     * max zoom and the mercator bounds the image occupies (stretched from
-     * the world's top-left corner, the original renderer's mapping).
-     */
-    _zoomifyPyramid(): {
-        sizes: Array<[number, number]>;
-        maxZoom: number;
-        extent: number[];
-        tileGrid: TileGrid;
-    } | null;
-    /**
-     * The zoomify overview state: the best-fit pyramid level for a map
-     * window (the level whose image, times the tolerance, fits the window —
-     * the legacy `_getBestFitZoom`) and the image's mercator center.
-     */
-    _zoomifyOverview(mapSize: [number, number]): {
-        zoom: number;
-        center: number[];
-    } | null;
-    _createTileLayer(map_type: string): Tile;
-    _createVectorStyleLayer(style_url: string): Tile;
-    _createMiniMap(): void;
-    _fitMiniMapToImage(): void;
-    _createMarker(d: StorymapSlide): void;
-    _addMarker(marker: OpenLayersMapMarker): void;
-    /**
-     * Position marker overlays on the unwrapped longitude path so they sit on
-     * the same world copy as the fitted view and the line (issue #381).
-     * Image-space coordinates are not degrees and stay untouched.
-     */
-    _afterCreateMarkers(): void;
-    _removeMarker(marker: OpenLayersMapMarker): void;
-    _getAllMarkersBounds(markers_array: OpenLayersMapMarker[]): number[][];
-    /**
-     * Normalize a longitude sequence so consecutive values differ by at most
-     * 180 degrees: markers keep their raw coordinates (OpenLayers wraps the
-     * display), but fits and lines use the unwrapped path (issue #381).
-     */
-    _unwrapLongitudes(lons: number[]): number[];
-    _markerCoordsToViewCoords(coords: number[][]): number[][];
-    /**
-     * The View extent for the `map_bbox` option, or `null` when unset.
-     */
-    _bboxExtent(): number[] | null;
-    /**
-     * The slide content panel can be opaque — it then covers part of the map
-     * and the effective visible area shrinks. Returns the pixel padding for
-     * the covered side (right in landscape, bottom in portrait) so fits keep
-     * the story inside the visible region; transparent panels add nothing.
-     */
-    _opaquePanelPadding(): [number, number, number, number];
-    _fitView(ol_map: OlMap, coords: number[][], duration?: number): void;
-    _calculateMarkerZooms(): void;
-    /**
-     * Stroke style for the route lines: the dash pattern and line join are
-     * applied at init too, matching the original rendering (the lines are
-     * dashed "5,5" by default, not solid).
-     */
-    _lineStyle(color: string): Style;
-    _createLine(d?: StorymapSlide): Vector;
-    _addLineToMap(line: Vector): void;
-    _addToLine(line: Vector, d: LinePoint): void;
-    /**
-     * Replace a line's geometry. With `animate.duration > 0` the active line
-     * is drawn progressively, in sync with the view animation: the target
-     * path is truncated by cumulative length at the eased progress, so half
-     * way through the pan only half the route is red.
-     */
-    _replaceLines(line: Vector, array: LinePoint[], animate?: {
-        duration: number;
-        retractFrom?: LinePoint[];
-    }): void;
-    /** Cancel a running active-line draw animation. */
-    _cancelLineAnimation(): void;
-    /** Total euclidean length of a path in view coordinates. */
-    _pathLength(coords: number[][]): number;
-    /**
-     * The prefix of the path up to `length` (in view units), with the cut
-     * point interpolated inside its segment.
-     */
-    _truncatePath(coords: number[][], length: number): number[][];
-    _panTo(loc: LatLngLiteral, animate?: boolean): void;
-    _zoomTo(z: number, animate?: boolean): void;
-    _viewTo(loc: StorymapSlideLocation, opts?: ViewToOptions): void;
-    _toViewCoords(loc: LatLngLiteral): number[];
-    _getMapZoom(): number;
-    _getMapCenter(offset?: boolean): LatLngLiteral;
-    _getMapCenterOffset(location: LatLngLiteral, zoom: number): LatLngLiteral;
-    _fromViewCoords(coord: number[], projection: Projection): LatLngLiteral;
-    _getBoundsZoom(origin: LatLngLiteral, destination: LatLngLiteral, correct_for_center?: boolean): number;
-    _initialMapLocation(): void;
-    /**
-     * Great-circle (haversine) length of the route through all markers in
-     * kilometers (issue #341).
-     */
-    getRouteDistance(): number | undefined;
-    _markerOverview(duration?: number): void;
-    /**
-     * Re-apply runtime-changed options (driven by StoryMap.setMapOptions).
-     * Only keys with an immediate effect are handled here; everything else is
-     * picked up on the next navigation or layout pass.
-     */
-    applyOptions(keys: string[]): void;
-    _updateMapDisplay(animate?: boolean, d?: number, instant?: boolean): void;
-    _refreshMap(instant?: boolean): void;
-    /**
-     * Set the view synchronously (resize path): OL's animate() applies its
-     * end state asynchronously which can leave marker overlays rendering
-     * stale positions after a size change.
-     */
-    _setViewInstant(loc: StorymapSlideLocation, zoom: number): void;
-}
-
-interface MenuBarOptions {
-    width: number;
-    height: number;
-    duration: number;
-    ease: unknown;
-    menubar_default_y: number;
-    [key: string]: unknown;
-}
-declare class MenuBarBase {
-    "_el": Record<string, HTMLElement>;
-    "collapsed": boolean;
-    "options": MenuBarOptions;
-    "animator": Record<string, unknown>;
-    "fire": EventedInstance["fire"];
-    constructor(elem: HTMLElement | string, parent_elem?: HTMLElement, options?: object);
-    show(d?: number): void;
-    hide(top: number): void;
-    setSticky(y: number): void;
-    setColor(inverted: boolean): void;
-    /**
-     * Reflect the fullscreen state in the button label/icon.
-     */
-    setFullscreenState(active: boolean): void;
-    /**
-     * Update the progress indicator (issue #247); no-op when disabled.
-     */
-    setProgress(current: number, total: number): void;
-    /**
-     * Update the route distance display (issue #341); no-op when disabled or
-     * before the first reading.
-     */
-    setDistance(kilometers?: number): void;
-    updateDisplay(w?: number, h?: number, a?: boolean): void;
-    _onButtonOverview(e: Event): void;
-    _onButtonBackToStart(e: Event): void;
-    _onButtonFullscreen(e: Event): void;
-    _onButtonCollapseMap(e: Event): void;
-    _initLayout(): void;
-    _updateDisplay(width?: number, height?: number, animate?: boolean): void;
-}
-declare const MenuBar_base: {
-    new (...args: any[]): {
-        show(animate?: unknown): void;
-        hide(): void;
-        addTo(container: HTMLElement): /*elided*/ any;
-        removeFrom(container: HTMLElement): /*elided*/ any;
-        setPosition(pos: Record<string, number>, el?: HTMLElement): /*elided*/ any;
-        onLoaded(): void;
-        onAdd(): void;
-        onRemove(): void;
-        _el: Record<string, HTMLElement>;
-        data?: unknown;
-        on: (type: string, fn: unknown, context?: unknown) => unknown;
-        off: (type: string, fn: unknown, context?: unknown) => unknown;
-        fire: (type: string, data?: unknown, target?: unknown) => unknown;
-        hasEventListeners: (type: string) => boolean;
-    };
-} & {
-    new (...args: any[]): {
-        _vco_events?: Record<string, {
-            action: unknown;
-            context: unknown;
-        }[]>;
-        on(type: string, fn: unknown, context?: unknown): /*elided*/ any;
-        hasEventListeners(type: string): boolean;
-        off(type: string, fn: unknown, context?: unknown): /*elided*/ any;
-        fire(type: string, data?: unknown, target?: unknown): /*elided*/ any;
-    };
-} & typeof MenuBarBase;
-declare class MenuBar extends MenuBar_base {
-    constructor(...args: ConstructorParameters<typeof MenuBarBase>);
-}
-
-interface SlideNavData {
-    title: string;
-    description: string;
-    date?: string;
-    [key: string]: unknown;
-}
-interface SlideNavOptions {
-    direction: string;
-    [key: string]: unknown;
-}
-declare class SlideNavBase {
-    "_el": Record<string, HTMLElement>;
-    "mediatype": unknown;
-    "data": SlideNavData;
-    "options": SlideNavOptions;
-    "animator": AnimationHandle | null;
-    "animator_position": AnimationHandle | null;
-    "fire": EventedInstance["fire"];
-    constructor(data?: Partial<SlideNavData>, options?: Partial<SlideNavOptions>, add_to_container?: HTMLElement);
-    update(d?: Partial<SlideNavData>): void;
-    setColor(inverted: boolean): void;
-    updatePosition(pos: Record<string, number | string>, use_percent: boolean, duration: number, ease: unknown, start_value: number, return_to_default: boolean): void;
-    _onUpdatePositionComplete(return_to_default: boolean): void;
-    _onMouseClick(): void;
-    _update(d?: Partial<SlideNavData>): void;
-    _initLayout(): void;
-    _initEvents(): void;
-}
-declare const SlideNav_base: {
-    new (...args: any[]): {
-        show(animate?: unknown): void;
-        hide(): void;
-        addTo(container: HTMLElement): /*elided*/ any;
-        removeFrom(container: HTMLElement): /*elided*/ any;
-        setPosition(pos: Record<string, number>, el?: HTMLElement): /*elided*/ any;
-        onLoaded(): void;
-        onAdd(): void;
-        onRemove(): void;
-        _el: Record<string, HTMLElement>;
-        data?: unknown;
-        on: (type: string, fn: unknown, context?: unknown) => unknown;
-        off: (type: string, fn: unknown, context?: unknown) => unknown;
-        fire: (type: string, data?: unknown, target?: unknown) => unknown;
-        hasEventListeners: (type: string) => boolean;
-    };
-} & {
-    new (...args: any[]): {
-        _vco_events?: Record<string, {
-            action: unknown;
-            context: unknown;
-        }[]>;
-        on(type: string, fn: unknown, context?: unknown): /*elided*/ any;
-        hasEventListeners(type: string): boolean;
-        off(type: string, fn: unknown, context?: unknown): /*elided*/ any;
-        fire(type: string, data?: unknown, target?: unknown): /*elided*/ any;
-    };
-} & typeof SlideNavBase;
-declare class SlideNav extends SlideNav_base {
-    constructor(...args: ConstructorParameters<typeof SlideNavBase>);
-}
-
-interface TextData {
-    uniqueid?: string | null;
-    headline?: string;
-    text?: string;
-    text_align?: string;
-    date?: {
-        created_time?: string;
-        [key: string]: unknown;
-    } | null;
-}
-interface TextOptions {
-    title?: boolean;
-    text_align?: string;
-}
-declare class TextBase {
-    "_el": Record<string, HTMLElement>;
-    "data": TextData;
-    "options": TextOptions;
-    "fire": EventedInstance["fire"];
-    constructor(data: TextData, options?: TextOptions, add_to_container?: HTMLElement);
-    show(): void;
-    hide(): void;
-    addTo(container: HTMLElement): void;
-    removeFrom(container: HTMLElement): void;
-    headlineHeight(): number;
-    addDateText(str: string): void;
-    onLoaded(): void;
-    onAdd(): void;
-    onRemove(): void;
-    _initLayout(): void;
-}
-declare const Text_base: {
-    new (...args: any[]): {
-        _vco_events?: Record<string, {
-            action: unknown;
-            context: unknown;
-        }[]>;
-        on(type: string, fn: unknown, context?: unknown): /*elided*/ any;
-        hasEventListeners(type: string): boolean;
-        off(type: string, fn: unknown, context?: unknown): /*elided*/ any;
-        fire(type: string, data?: unknown, target?: unknown): /*elided*/ any;
-    };
-} & typeof TextBase;
-declare class Text extends Text_base {
-    constructor(...args: ConstructorParameters<typeof TextBase>);
-}
-
-interface MediaInstance {
-    addTo: (container: HTMLElement) => void;
-    loadMedia: () => void;
-    stopMedia: () => void;
-    updateDisplay: (w?: number, h?: number, l?: string) => void;
-    _state?: {
-        loaded?: boolean;
-    };
-}
-interface SlideHas {
-    headline: boolean;
-    text: boolean;
-    media: boolean;
-    title: boolean;
-    background: {
-        image: boolean;
-        color: boolean;
-        color_value: string;
-    };
-}
-interface SlideOptions {
-    duration: number;
-    slide_padding_lr: number;
-    ease: unknown;
-    width: number;
-    height: number;
-    skinny_size: number;
-    media_name?: string;
-    media_type?: string;
-    [key: string]: unknown;
-}
-declare class SlideBase {
-    "_el": Record<string, HTMLElement>;
-    "_media": MediaInstance | null;
-    "_mediaclass": unknown;
-    "_text": Text;
-    "_state": {
-        loaded: boolean;
-    };
-    "has": SlideHas;
-    "title": string;
-    "data": StorymapSlide;
-    "options": SlideOptions;
-    "active": boolean;
-    "animator": unknown;
-    "fire": EventedInstance["fire"];
-    "onLoaded": () => void;
-    constructor(data: StorymapSlide, options: Record<string, unknown>, title_slide?: boolean);
-    show(): void;
-    hide(): void;
-    setActive(is_active: boolean): void;
-    updateDisplay(w?: number, h?: number, l?: string): void;
-    loadMedia(): void;
-    stopMedia(): void;
-    getBackground(): {
-        image: boolean;
-        color: boolean;
-        color_value: string;
-    };
-    scrollToTop(): void;
-    addCallToAction(str: string): void;
-    _onCallToAction(e: Event): void;
-    _initLayout(): void;
-    _updateDisplay(width?: number, height?: number, layout?: string): void;
-}
-declare const Slide_base: {
-    new (...args: any[]): {
-        show(animate?: unknown): void;
-        hide(): void;
-        addTo(container: HTMLElement): /*elided*/ any;
-        removeFrom(container: HTMLElement): /*elided*/ any;
-        setPosition(pos: Record<string, number>, el?: HTMLElement): /*elided*/ any;
-        onLoaded(): void;
-        onAdd(): void;
-        onRemove(): void;
-        _el: Record<string, HTMLElement>;
-        data?: unknown;
-        on: (type: string, fn: unknown, context?: unknown) => unknown;
-        off: (type: string, fn: unknown, context?: unknown) => unknown;
-        fire: (type: string, data?: unknown, target?: unknown) => unknown;
-        hasEventListeners: (type: string) => boolean;
-    };
-} & {
-    new (...args: any[]): {
-        _vco_events?: Record<string, {
-            action: unknown;
-            context: unknown;
-        }[]>;
-        on(type: string, fn: unknown, context?: unknown): /*elided*/ any;
-        hasEventListeners(type: string): boolean;
-        off(type: string, fn: unknown, context?: unknown): /*elided*/ any;
-        fire(type: string, data?: unknown, target?: unknown): /*elided*/ any;
-    };
-} & typeof SlideBase;
-declare class Slide extends Slide_base {
-    constructor(...args: ConstructorParameters<typeof SlideBase>);
-}
-
-/** Legacy drag handlers historically mixed mouse and touch event surfaces. */
-type LegacyEvent = Event & {
-    originalEvent?: TouchEvent;
-    targetTouches?: TouchList;
-    pageX?: number;
-    pageY?: number;
-};
-
-interface DragEventNames {
-    down: string;
-    up: string;
-    leave: string;
-    move: string;
-}
-interface SwipableOptions {
-    snap: boolean;
-    enable: {
-        x: boolean;
-        y: boolean;
-    };
-    constraint: {
-        top: number | boolean;
-        bottom: number | boolean;
-        left: number | boolean;
-        right: number | boolean;
-    };
-    momentum_multiplier: number;
-    duration: number;
-    ease: unknown;
-}
-interface DragData {
-    sliding: boolean;
-    direction: string | null;
-    pagex: {
-        start: number;
-        end: number;
-    };
-    pagey: {
-        start: number;
-        end: number;
-    };
-    pos: {
-        start: {
-            x: number;
-            y: number;
-        };
-        end: {
-            x: number;
-            y: number;
-        };
-    };
-    new_pos: {
-        x: number;
-        y: number;
-    };
-    new_pos_parent: {
-        x: number;
-        y: number;
-    };
-    time: {
-        start: number;
-        end: number;
-    };
-    touch: boolean;
-}
-declare class SwipableBase {
-    "mousedrag": DragEventNames;
-    "touchdrag": DragEventNames;
-    "_el": Record<string, HTMLElement>;
-    "options": SwipableOptions;
-    "animator": AnimationHandle | null;
-    "dragevent": DragEventNames;
-    "data": DragData;
-    "fire": EventedInstance["fire"];
-    constructor(drag_elem: HTMLElement, move_elem?: HTMLElement, options?: Record<string, unknown>);
-    enable(e?: LegacyEvent): void;
-    disable(): void;
-    stopMomentum(): void;
-    updateConstraint(c: SwipableOptions["constraint"]): void;
-    _onDragStart(e: LegacyEvent): void;
-    _onDragEnd(e: LegacyEvent): void;
-    _onDragMove(e: LegacyEvent): void;
-    _momentum(): void;
-    _animateMomentum(): void;
-}
-declare const Swipable_base: {
-    new (...args: any[]): {
-        _vco_events?: Record<string, {
-            action: unknown;
-            context: unknown;
-        }[]>;
-        on(type: string, fn: unknown, context?: unknown): /*elided*/ any;
-        hasEventListeners(type: string): boolean;
-        off(type: string, fn: unknown, context?: unknown): /*elided*/ any;
-        fire(type: string, data?: unknown, target?: unknown): /*elided*/ any;
-    };
-} & typeof SwipableBase;
-declare class Swipable extends Swipable_base {
-    constructor(...args: ConstructorParameters<typeof SwipableBase>);
-}
-
-interface MessageOptions {
-    width: number;
-    height: number;
-    message_class: string;
-    message_icon_class: string;
-    [key: string]: unknown;
-}
-declare class MessageBase {
-    "_el": Record<string, HTMLElement>;
-    "options": MessageOptions;
-    "data": Record<string, unknown>;
-    "animator": Record<string, unknown>;
-    "fire": EventedInstance["fire"];
-    constructor(data?: Record<string, unknown>, options?: Record<string, unknown>, add_to_container?: HTMLElement);
-    updateMessage(t: string): void;
-    _updateMessage(t?: string): void;
-    _onMouseClick(): void;
-    _initLayout(): void;
-    _initEvents(): void;
-}
-declare const Message_base: {
-    new (...args: any[]): {
-        show(animate?: unknown): void;
-        hide(): void;
-        addTo(container: HTMLElement): /*elided*/ any;
-        removeFrom(container: HTMLElement): /*elided*/ any;
-        setPosition(pos: Record<string, number>, el?: HTMLElement): /*elided*/ any;
-        onLoaded(): void;
-        onAdd(): void;
-        onRemove(): void;
-        _el: Record<string, HTMLElement>;
-        data?: unknown;
-        on: (type: string, fn: unknown, context?: unknown) => unknown;
-        off: (type: string, fn: unknown, context?: unknown) => unknown;
-        fire: (type: string, data?: unknown, target?: unknown) => unknown;
-        hasEventListeners: (type: string) => boolean;
-    };
-} & {
-    new (...args: any[]): {
-        _vco_events?: Record<string, {
-            action: unknown;
-            context: unknown;
-        }[]>;
-        on(type: string, fn: unknown, context?: unknown): /*elided*/ any;
-        hasEventListeners(type: string): boolean;
-        off(type: string, fn: unknown, context?: unknown): /*elided*/ any;
-        fire(type: string, data?: unknown, target?: unknown): /*elided*/ any;
-    };
-} & typeof MessageBase;
-declare class Message extends Message_base {
-    constructor(...args: ConstructorParameters<typeof MessageBase>);
-}
-
-interface StorySliderOptions {
-    id?: string;
-    layout: string;
-    width: number;
-    height: number;
-    default_bg_color: {
-        r: number;
-        g: number;
-        b: number;
-    };
-    slide_padding_lr: number;
-    start_at_slide: number;
-    slide_default_fade: string;
-    duration: number;
-    ease: unknown;
-    skinny_size?: number;
-    call_to_action?: boolean;
-    call_to_action_text?: string;
-    dragging?: boolean;
-    trackResize?: boolean;
-    [key: string]: unknown;
-}
-interface SlideBackgroundChange {
-    color_value?: string;
-    image?: boolean;
-}
-declare class StorySliderBase {
-    "_el": Record<string, HTMLElement>;
-    "_nav": {
-        previous: SlideNav;
-        next: SlideNav;
-    };
-    "slide_spacing": number;
-    "_slides": Slide[];
-    "_swipable": Swipable;
-    "preloadTimer": ReturnType<typeof setTimeout>;
-    "_message": Message;
-    "current_slide": number;
-    "current_bg_color": string | null;
-    "data": Partial<StorymapData>;
-    "options": StorySliderOptions;
-    "animator": AnimationHandle | null;
-    "animator_background": AnimationHandle | null;
-    "fire": EventedInstance["fire"];
-    "_loaded": boolean;
-    "hasEventListeners": EventedInstance["hasEventListeners"];
-    constructor(elem: HTMLElement | string, data: Partial<StorymapData>, options?: Partial<StorySliderOptions>, init?: boolean);
-    init(): void;
-    updateDisplay(w?: number, h?: number, a?: unknown, l?: string): void;
-    createSlide(d: StorymapSlide): void;
-    createSlides(array: StorymapData["slides"]): void;
-    _createSlides(array: StorymapData["slides"]): void;
-    _createSlide(d: StorymapSlide, title_slide?: boolean): void;
-    _addSlide(slide: Slide): void;
-    goToId(n: string | number, fast?: boolean, displayupdate?: boolean): void;
-    goTo(n: number, fast?: boolean, displayupdate?: boolean): void;
-    preloadSlides(): void;
-    getNavInfo(slide: Slide): {
-        title: string;
-        description: string;
-    };
-    next(): void;
-    previous(): void;
-    showNav(nav_obj: SlideNav, show: boolean): void;
-    changeBackground(bg: SlideBackgroundChange): void;
-    fadeInBackground(bg_css: string): void;
-    _updateDisplay(width?: number, height?: number, animate?: unknown, layout?: string): void;
-    _introInterface(): void;
-    _initLayout(): void;
-    _initEvents(): void;
-    _onKeyDown(e: Event): void;
-    _initData(): void;
-    _onBackgroundChange(e: SlideBackgroundChange): void;
-    _onMessageClick(e?: unknown): void;
-    _onSwipeNoDirection(e?: unknown): void;
-    _onNavigation(e: {
-        direction: string;
-    }): void;
-    _onSlideAdded(e?: unknown): void;
-    _onSlideChange(displayupdate?: boolean): void;
-    _onLoaded(): void;
-}
-declare const StorySlider_base: {
-    new (...args: any[]): {
-        _vco_events?: Record<string, {
-            action: unknown;
-            context: unknown;
-        }[]>;
-        on(type: string, fn: unknown, context?: unknown): /*elided*/ any;
-        hasEventListeners(type: string): boolean;
-        off(type: string, fn: unknown, context?: unknown): /*elided*/ any;
-        fire(type: string, data?: unknown, target?: unknown): /*elided*/ any;
-    };
-} & typeof StorySliderBase;
-declare class StorySlider extends StorySlider_base {
-    constructor(...args: ConstructorParameters<typeof StorySliderBase>);
-}
+// Externally loaded script globals (YouTube/SoundCloud player APIs).
+// Everything the library or the test harness touches on window is typed
+// at its usage site instead.
 
-type StoryMapListener = (e: unknown) => void;
-/**
- * Interactive StoryMap viewer.
- *
- * Renders a storymap JSON document (or a IIIF Presentation 3 manifest) into an
- * element: an OpenLayers map on one side and a slide slider on the other.
- *
- * @example
- * ```ts
- * import { StoryMap } from "storymapjs";
- * // from an inline data object
- * const map = new StoryMap("embed", { storymap: { ... } }, { start_at_slide: 2 });
- * // or straight from a source file (storymap JSON or IIIF manifest)
- * const map2 = new StoryMap(document.getElementById("embed"), "./my-storymap.json");
- * ```
- */
-declare class StoryMapBase {
-    "_loaded": {
-        storyslider: boolean;
-        map: boolean;
+declare global {
+    // Externally loaded script globals
+    const YT: {
+        Player: new (el: HTMLElement | string, opts: unknown) => unknown;
+        PlayerState: Record<string, number>;
     };
-    "on": EventedInstance["on"];
-    "version": string;
-    "ready": boolean;
-    "_el": {
-        container: HTMLElement;
-        menubar: HTMLElement;
-        map: HTMLElement;
-        storyslider: HTMLElement;
+    const SC: {
+        Widget: (el: HTMLElement) => { pause(): void };
     };
-    "_storyslider": StorySlider;
-    "_map": OpenLayers;
-    "map": Map$1;
-    "_menubar": MenuBar;
-    "data": StorymapData;
-    "options": StorymapOptions;
-    "current_slide": number;
-    "animator_map": AnimationHandle | null;
-    "animator_storyslider": AnimationHandle | null;
-    "_autoplay_timer": ReturnType<typeof setTimeout> | null;
-    "_autoplay_stopped": boolean;
-    "_hash_initialized": boolean;
-    /** the data source was a IIIF Presentation manifest (legacy zoomify options are ignored) */
-    "_data_from_manifest": boolean;
-    "_resize_observer": ResizeObserver | null;
-    "_resize_timer": ReturnType<typeof setTimeout> | null;
-    "fire": EventedInstance["fire"];
-    "hasEventListeners": EventedInstance["hasEventListeners"];
-    /**
-     * Create a StoryMap inside the given element.
-     *
-     * @param elem - The container element, or its DOM id.
-     * @param data - Either an inline storymap document (`{ storymap: ... }`),
-     *   an inline IIIF Presentation 3 manifest, or the URL of a source file
-     *   (storymap JSON or IIIF manifest) that is fetched automatically.
-     * @param options - Optional {@link StorymapOptions} overrides (map type,
-     *   lines, fonts, animation, raw OpenLayers options via `map_options`...).
-     * @param listeners - Optional event listeners keyed by event name
-     *   (`change`, `title`, `loaded`, ...) attached on creation.
-     */
-    constructor(elem: string | HTMLElement, data: string | StorymapDataWrapper | Record<string, unknown>, options?: Partial<StorymapOptions>, listeners?: Record<string, StoryMapListener | StoryMapListener[]>);
-    _initData(data: string | StorymapDataWrapper | Record<string, unknown>): void;
-    _loadDataFromUrl(url: string, source: string): Promise<void>;
-    _initOptions(): void;
-    _loadLanguage(): void;
-    _loadFontCss(): Promise<void>;
-    _onFontLoaded(font: string): void;
-    /**
-     * Navigate to a slide by index.
-     *
-     * @param n - Zero-based slide index; the map animates to the slide's
-     *   marker (or the overview when `n` is 0 for storymaps with one).
-     */
-    goTo(n: number): void;
-    /**
-     * Re-measure the container and re-layout the map, slider and menubar.
-     * Called automatically on resize (see the `trackResize` option).
-     */
-    updateDisplay(): void;
-    /**
-     * Change a single map option at runtime and apply its effect immediately.
-     *
-     * Runtime-changeable options: `map_type` (rebuilds the tile layer),
-     * `show_lines`, `line_color`, `line_color_inactive`, `line_weight`,
-     * `line_opacity`, `line_dash`, `line_join`, `line_follows_path`,
-     * `show_history_line` (restyled instantly), `map_center_offset` (applied on
-     * the next navigation), `duration`, `ease`, `calculate_zoom`,
-     * `map_background_color`. All other options only take effect on the next
-     * navigation or require re-creating the StoryMap.
-     */
-    setMapOption(name: string, value: unknown): void;
-    /**
-     * Change several map options at runtime (see setMapOption).
-     */
-    setMapOptions(options: Partial<StorymapOptions>): void;
-    _initLayout(): void;
-    _initEvents(): void;
-    _updateDisplay(map_height?: number, animate?: boolean, d?: number): void;
-    _onDataLoaded(e?: unknown): void;
-    _startAutoplay(): void;
-    _scheduleAutoplay(): void;
-    _stopAutoplay(): void;
-    /** Keep the URL hash in sync with the current slide (#slide-N). */
-    _syncHash(): void;
-    /** A #slide-N hash deep-links the storymap (applied on load + hashchange). */
-    _applyHashSlide(): boolean;
-    _initResizeHandling(): void;
-    /**
-     * Resolve a caller-supplied map element (options.map_options.element).
-     * The passed element is "replaced by the real one": it is adopted as the
-     * map container (given the vco-map class) and moved into place between
-     * the menubar and the story slider.
-     */
-    _resolveMapElement(): HTMLElement | null;
-    _onTitle(e: unknown): void;
-    _onColorChange(e: {
-        color?: unknown;
-        image?: unknown;
-    }): void;
-    _onSlideChange(e: {
-        current_slide: number;
-    }): void;
-    _onMapChange(e: {
-        current_marker: number;
-    }): void;
-    _updateProgress(): void;
-    _onOverview(e?: unknown): void;
-    /**
-     * Toggle the native fullscreen API on the storymap container and keep the
-     * menubar button state in sync.
-     */
-    _onFullscreenToggle(e?: unknown): void;
-    _onFullscreenChange(): void;
-    _onBackToStart(e?: unknown): void;
-    _onMenuBarCollapse(e: {
-        y: number;
-    }): void;
-    _onMapLoaded(): void;
-    _onStorySliderLoaded(): void;
-    /**
-     * Compute and display the great-circle distance of the marker route
-     * (issue #341); hidden when `show_distance` is off.
-     */
-    _updateDistance(): void;
-    _onLoaded(): void;
-}
-declare const StoryMap_base: {
-    new (...args: any[]): {
-        _vco_events?: Record<string, {
-            action: unknown;
-            context: unknown;
-        }[]>;
-        on(type: string, fn: unknown, context?: unknown): /*elided*/ any;
-        hasEventListeners(type: string): boolean;
-        off(type: string, fn: unknown, context?: unknown): /*elided*/ any;
-        fire(type: string, data?: unknown, target?: unknown): /*elided*/ any;
-    };
-} & typeof StoryMapBase;
-declare class StoryMap extends StoryMap_base {
-    /**
-     * The library base path (the directory containing the module).
-     * Derived from `import.meta.url`, which works both for the source module
-     * (src/main.ts) and the built ESM bundle (js/storymap.js).
-     */
-    static SCRIPT_PATH: string;
-    constructor(...args: ConstructorParameters<typeof StoryMapBase>);
-}
-
-interface LoadOptions {
-    /** Abort the load (removes the element, rejects the promise). */
-    signal?: AbortSignal;
-}
-/**
- * Append one stylesheet to the document head.
- *
- * @param url - The stylesheet URL.
- * @param options - Optional AbortSignal to cancel an in-flight load.
- * @returns Resolves when the stylesheet has loaded, rejects on error or abort.
- */
-declare function loadCSS(url: string, options?: LoadOptions): Promise<void>;
-
-/**
- * Resolve the media handler for a slide's media object: matches the URL (and
- * optional explicit `type`) against the supported media types — YouTube,
- * Vimeo, images, audio, video, ...
- *
- * @param m - The slide media definition.
- * @returns The matching media type entry, or `false` for unknown media.
- */
-declare function MediaType(m: StorymapSlideMedia): MediaTypeMatch | false;
-
-interface LanguageEntry {
-    buttons?: Record<string, string>;
-    messages?: Record<string, string>;
-    [key: string]: unknown;
 }
-/**
- * Switch the active UI language.
- *
- * @param code - A locale code for which a locale file exists (e.g. `"en"`).
- * @returns The language entry that is now active.
- */
-declare function setLanguage(code: string): LanguageEntry;
-
-interface StorymapError {
-    path: string;
-    message: string;
-}
-/** Validate storymap JSON (the object containing a "storymap" property). */
-declare function validateStorymap(data: unknown): StorymapError[];
-/** Validate and report all errors to the JavaScript console. Returns true when valid. */
-declare function validateStorymapAndReport(data: unknown, source?: string): boolean;
-
-export { MediaType, StoryMap, loadCSS, setLanguage, validateStorymap, validateStorymapAndReport };