@micrio/client 6.1.3 → 6.1.5

package/micrio.min.d.ts

@@ -12,10 +12,23 @@ declare module '@micrio/client' {
 	 * @returns A Promise resolving to the loaded TextureBitmap.
 	 */
 	export const loadTexture: (src: string) => Promise<TextureBitmap>;
+	/**
+	 * Mathematical utility functions.
+	 * @author Marcel Duin <marcel@micr.io>
+	 */
 	/**
 	 * Calculates the positive modulo (floored division remainder).
 	 */
 	export const mod: (n: number, m?: number) => number;
+	/**
+	 * Converts a Camera.View tuple `[x, y, w, h]` to a center-based JSON object.
+	 */
+	export const toCenterJSON: (v: Models.Camera.View) => {
+		centerX: number;
+		centerY: number;
+		width: number;
+		height: number;
+	};
 	/**
 	 * Defines various enums used throughout the Micrio application,
 	 * primarily for standardizing action types and option values.
@@ -316,7 +329,7 @@ declare module '@micrio/client' {
 		 * Initializes the engine (replaces WebAssembly loading).
 		 * @throws Error if engine initialization fails
 		 */
-		load(): Promise<void>;
+		load(): void;
 		private _hostDrawQuad;
 		private _hostGetTileOpacity;
 		private _hostSetTileOpacity;
@@ -402,12 +415,6 @@ declare module '@micrio/client' {
 		 */
 		animateTo(idx: number): void;
 	}
-	/**
-	 * Converts seconds into a human-readable time string (hh?:mm:ss).
-	 * @param s Time in seconds. Can be negative for remaining time display.
-	 * @returns Formatted time string (e.g., "1:23", "1:05:09", "-0:15").
-	 */
-	export function parseTime(s: number): string;
 	/**
 	 * Centralized data loading controller.
 	 * Uses the `bundle.json` endpoint which returns info + data for multiple
@@ -437,6 +444,8 @@ declare module '@micrio/client' {
 		getSpaceData(id: string): Models.Spaces.Space | undefined;
 		/** Returns the organisation data from the bundle, or undefined. */
 		getOrganisation(): Models.ImageInfo.Organisation | undefined;
+		/** Returns the album info for an album ID from the bundle cache. */
+		getAlbum(id: string): Models.ImageInfo.GallerySettings | undefined;
 		/**
 		 * Returns the full bundle entry (info + data) for a single image ID,
 		 * fetching the bundle once if not cached.
@@ -600,36 +609,6 @@ declare module '@micrio/client' {
 		/** Fades out the image smoothly or instantly. */
 		fadeOut(direct?: boolean): void;
 	}
-	/**
-	 * Direction-keyed area rectangles for grid/gallery slide and swipe transitions.
-	 * Areas use [x0, y0, x1, y1] in normalized parent-canvas coordinates and
-	 * extend outside [0,1] to represent off-screen positions.
-	 *
-	 * Direction conventions (degrees of motion of the entering image):
-	 *   0   = enters from top
-	 *   90  = enters from right
-	 *   180 = enters from bottom
-	 *   270 = enters from left
-	 *
-	 * @author Marcel Duin <marcel@micr.io>
-	 */
-	/** Slide transition entry areas (entering image starts half-off-screen). */
-	export const slideAreas: Record<number, Models.Camera.ViewRect>;
-	/** Swipe transition entry areas (entering image starts fully off-screen). */
-	export const swipeAreas: Record<number, Models.Camera.ViewRect>;
-	/** Swipe transition exit areas (leaving image moves fully off-screen). */
-	export const swipeExitAreas: Record<number, Models.Camera.ViewRect>;
-	/** Centered visible slot. */
-	export const centerArea: Models.Camera.ViewRect;
-	/** Off-screen slot to the left, same height. */
-	export const leftSlot: Models.Camera.ViewRect;
-	/** Off-screen slot to the right, same height. */
-	export const rightSlot: Models.Camera.ViewRect;
-	/**
-	 * Returns the horizontal slot area for an integer offset from the active slot.
-	 * offset=0 → centered visible; positive → off to the right; negative → off to the left.
-	 */
-	export const horizontalSlot: (offset: number) => Models.Camera.ViewRect;
 	/**
 	 * Micrio grid display controller
 	 * @author Marcel Duin <marcel@micr.io>
@@ -1143,7 +1122,6 @@ declare module '@micrio/client' {
 				markersScale?: boolean;
 				/** Albums */
 				gallery?: GallerySettings;
-				album?: AlbumInfo; /** V5 only */
 				/** FOR OMNI OBJECTS */
 				omni?: OmniSettings;
 				/** Optional marker settings */
@@ -1192,6 +1170,10 @@ declare module '@micrio/client' {
 				watermarkOpacity?: number;
 			};
 			type GallerySettings = {
+				/** Album/image ID for the gallery */
+				id?: string;
+				/** Gallery name */
+				name?: string;
 				/** Gallery has an associated .bin archive with thumbnails */
 				archive?: string;
 				/** Archive layer offset */
@@ -1206,6 +1188,8 @@ declare module '@micrio/client' {
 				isSpreads?: boolean;
 				/** For spreads, number of cover pages to show as single page */
 				coverPages?: number;
+				/** Optional viewer settings that override/merge with defaults */
+				settings?: Partial<ImageInfo.Settings>;
 				revisions?: {
 					[key: string]: RevisionType;
 				};
@@ -1793,6 +1777,7 @@ declare module '@micrio/client' {
 					id: string;
 					data: Models.Spaces.Space;
 				}[];
+				album?: ImageInfo.GallerySettings;
 			};
 		}
 		namespace Assets {
@@ -1985,36 +1970,13 @@ declare module '@micrio/client' {
 				blur?: number;
 			}
 		}
-		/** Albums */
-		interface AlbumInfo {
-			/** The album ID */
-			id: string;
-			/** The album name */
-			name: string;
-			/** The album UX type */
-			type: ('swipe' | 'switch' | 'grid');
-			/** The album image sorting */
-			sort?: ('name' | '-name' | 'created' | '-created' | 'random');
-			/** Album pages are shown as book spreads */
-			isSpreads?: boolean;
-			/** The number of single cover pages in case of spreads */
-			coverPages?: number;
-			/** Published revision number */
-			revision: number;
-			/** Available page data (markers, etc) */
-			published: {
-				[key: string]: RevisionType;
-			};
-			/** Album organisation */
-			organisation?: ImageInfo.Organisation;
-		}
 		interface Album {
 			/** The number of pages in this album */
 			numPages: number;
 			/** The current page index */
 			currentIndex: number;
 			/** The album info */
-			info?: AlbumInfo;
+			info?: ImageInfo.GallerySettings;
 			/** Go to previous page */
 			prev: () => void;
 			/** Go to next page */
@@ -2292,8 +2254,6 @@ declare module '@micrio/client' {
 				'volume'?: number;
 				/** Fade music to this volume while other audio plays (between 0 and 1). Default: 0 */
 				'data-mutedvolume'?: number;
-				/** Configuration for the grid which the viewer will use. */
-				'data-grid'?: string;
 				/** Toggle limited rendering mode in WebAssembly. */
 				'data-limited'?: boolean;
 			}
@@ -2393,13 +2353,6 @@ declare module '@micrio/client' {
 			/** Was panning active before pinching started? */
 			wasPanning: boolean;
 		};
-		/** State for debouncing 'update' events. */
-		updates: {
-			/** Timeout ID for the debounced update. */
-			to: number;
-			/** Stack of event types that triggered the update. */
-			stack: string[];
-		};
 	};
 	/** Event listener options for passive listeners. */
 	export const eventPassive: AddEventListenerOptions;
@@ -2466,101 +2419,6 @@ declare module '@micrio/client' {
 		/** Has touch support */
 		hasTouch: boolean;
 	}
-	/**
-	 * List of internal Micrio event types that should trigger a debounced 'update' event.
-	 * The 'update' event signals that the overall state relevant for external integrations might have changed.
-	 * @readonly
-	 */
-	export const UpdateEvents: (keyof Models.MicrioEventMap)[];
-	/**
-	 * Update event handler module.
-	 * Manages debounced 'update' event dispatching when internal state changes.
-	 */
-	export class UpdateHandler {
-		private ctx;
-		constructor(ctx: EventContext);
-		/** Hooks listeners for events that should trigger a debounced 'update' event. */
-		hook(): void;
-		/** Unhooks listeners for the debounced 'update' event. */
-		unhook(): void;
-		/**
-		 * Event listener callback that queues the event type and triggers the debounced dispatch.
-		 * @param e The Event object.
-		 */
-		private handleEvent;
-		/**
-		 * Dispatches the 'update' event with the accumulated event types and current state.
-		 * Clears the event stack.
-		 */
-		private dispatch;
-	}
-	export { UpdateEvents } from "ts/events/update";
-	/**
-	 * Handles user input events (mouse, touch, keyboard, wheel, gestures) for the Micrio viewer.
-	 * Translates browser events into camera movements (pan, zoom), dispatches custom Micrio events,
-	 * and manages interaction states like panning, pinching, and enabled/disabled states.
-	 * Accessed via `micrio.events`.
-	 * @author Marcel Duin <marcel@micr.io>
-	 */
-	export class Events implements EventContext {
-		/** Writable Svelte store indicating if event handling is currently enabled. Set to false during tours or animations. */
-		enabled: Writable<boolean>;
-		/** Getter for the current value of the {@link enabled} store. */
-		get $enabled(): boolean;
-		/** Current pinch zoom factor relative to the start of the pinch. Undefined when not pinching. */
-		pinchFactor: number | undefined;
-		private dragHandler;
-		private pinchHandler;
-		private pointerPinchHandler;
-		private gestureHandler;
-		private wheelHandler;
-		private keyboardHandler;
-		private doubleTapHandler;
-		private updateHandler;
-		isEnabled(): boolean;
-		isPanning(): boolean;
-		isPinching(): boolean;
-		setPanning(value: boolean): void;
-		setPinching(value: boolean): void;
-		isWheeling(): boolean;
-		setWheeling(value: boolean): void;
-		isControlZoom(): boolean;
-		isTwoFingerPan(): boolean;
-		getVisible(): MicrioImage[] | undefined;
-		setCapturedPointerId(id: number | undefined): void;
-		setPinchFactor(value: number | undefined): void;
-		setPScale(value: number): void;
-		setHasUsedCtrl(value: boolean): void;
-		/**
-		 * Checks if the user is currently interacting with the map via panning, pinching, or wheeling.
-		 * @returns True if the user is actively navigating.
-		*/
-		get isNavigating(): boolean;
-		/** Hooks all necessary event listeners based on current settings. */
-		hook(): void;
-		/** Unhooks all attached event listeners. */
-		unhook(): void;
-		/** Hooks keyboard event listeners. */
-		hookKeys(): void;
-		/** Unhooks keyboard event listeners. */
-		unhookKeys(): void;
-		/** Hooks zoom-related event listeners (pinch, scroll, double-tap/click). */
-		hookZoom(): void;
-		/** Unhooks zoom-related event listeners. */
-		unhookZoom(): void;
-		/** Hooks mouse wheel/scroll event listeners. */
-		hookScroll(): void;
-		/** Unhooks mouse wheel/scroll event listeners. */
-		unhookScroll(): void;
-		/** Hooks touch pinch and macOS gesture event listeners. */
-		hookPinch(): void;
-		/** Unhooks touch pinch and macOS gesture event listeners. */
-		unhookPinch(): void;
-		/** Hooks pointer down/move/up listeners for drag panning. */
-		hookDrag(): void;
-		/** Unhooks pointer listeners for drag panning. */
-		unhookDrag(): void;
-	}
 	/**
 	 * Drag/pan event handler module.
 	 * Handles pointer down/move/up events for panning the image.
@@ -2750,16 +2608,71 @@ declare module '@micrio/client' {
 		 */
 		private click;
 	}
-	export { Events } from "ts/events/facade";
-	export { DragHandler } from "ts/events/drag";
-	export { PinchHandler } from "ts/events/pinch";
-	export { PointerPinchHandler } from "ts/events/pointer-pinch";
-	export { GestureHandler } from "ts/events/gesture";
-	export { WheelHandler } from "ts/events/wheel";
-	export { KeyboardHandler } from "ts/events/keyboard";
-	export { DoubleTapHandler } from "ts/events/doubletap";
-	export { UpdateHandler } from "ts/events/update";
-	export { type AllEvents, type EventStateVars, type EventContext, eventPassive, eventPassiveCapture, noEventPassive, cancelPrevent, } from "ts/events/shared";
+	/**
+	 * Handles user input events (mouse, touch, keyboard, wheel, gestures) for the Micrio viewer.
+	 * Translates browser events into camera movements (pan, zoom), dispatches custom Micrio events,
+	 * and manages interaction states like panning, pinching, and enabled/disabled states.
+	 * Accessed via `micrio.events`.
+	 * @author Marcel Duin <marcel@micr.io>
+	 */
+	export class Events implements EventContext {
+		/** Writable Svelte store indicating if event handling is currently enabled. Set to false during tours or animations. */
+		enabled: Writable<boolean>;
+		/** Getter for the current value of the {@link enabled} store. */
+		get $enabled(): boolean;
+		/** Current pinch zoom factor relative to the start of the pinch. Undefined when not pinching. */
+		pinchFactor: number | undefined;
+		private dragHandler;
+		private pinchHandler;
+		private pointerPinchHandler;
+		private gestureHandler;
+		private wheelHandler;
+		private keyboardHandler;
+		private doubleTapHandler;
+		isEnabled(): boolean;
+		isPanning(): boolean;
+		isPinching(): boolean;
+		setPanning(value: boolean): void;
+		setPinching(value: boolean): void;
+		isWheeling(): boolean;
+		setWheeling(value: boolean): void;
+		isControlZoom(): boolean;
+		isTwoFingerPan(): boolean;
+		getVisible(): MicrioImage[] | undefined;
+		setCapturedPointerId(id: number | undefined): void;
+		setPinchFactor(value: number | undefined): void;
+		setPScale(value: number): void;
+		setHasUsedCtrl(value: boolean): void;
+		/**
+		 * Checks if the user is currently interacting with the map via panning, pinching, or wheeling.
+		 * @returns True if the user is actively navigating.
+		*/
+		get isNavigating(): boolean;
+		/** Hooks all necessary event listeners based on current settings. */
+		hook(): void;
+		/** Unhooks all attached event listeners. */
+		unhook(): void;
+		/** Hooks keyboard event listeners. */
+		hookKeys(): void;
+		/** Unhooks keyboard event listeners. */
+		unhookKeys(): void;
+		/** Hooks zoom-related event listeners (pinch, scroll, double-tap/click). */
+		hookZoom(): void;
+		/** Unhooks zoom-related event listeners. */
+		unhookZoom(): void;
+		/** Hooks mouse wheel/scroll event listeners. */
+		hookScroll(): void;
+		/** Unhooks mouse wheel/scroll event listeners. */
+		unhookScroll(): void;
+		/** Hooks touch pinch and macOS gesture event listeners. */
+		hookPinch(): void;
+		/** Unhooks touch pinch and macOS gesture event listeners. */
+		unhookPinch(): void;
+		/** Hooks pointer down/move/up listeners for drag panning. */
+		hookDrag(): void;
+		/** Unhooks pointer listeners for drag panning. */
+		unhookDrag(): void;
+	}
 	/**
 	 * Language-related constants and utilities.
 	 */
@@ -2960,8 +2873,6 @@ declare module '@micrio/client' {
 		*/
 		constructor(micrio: HTMLMicrioElement);
 	}
-	export { i18n, langs } from "ts/i18n/strings";
-	export { locale, languageNames, rtlLanguageCodes } from "ts/i18n/locale";
 	/**
 	 * Manages the loading, playback, and WebGL integration of embedded videos
 	 * that are rendered directly onto the Micrio canvas texture (not as HTML elements).
@@ -3098,80 +3009,21 @@ declare module '@micrio/client' {
 		setVolume(volume: number): void;
 		destroy(): void;
 	}
-	export type PREDEFINED = [string, Models.ImageInfo.ImageInfo, Models.ImageData.ImageData | undefined];
-	/** Enum for identifying media type. */
-	export enum MediaType {
-		None = 0,
-		IFrame = 1,
-		Video = 2,
-		Audio = 3,
-		VideoTour = 4,
-		Micrio = 5
-	}
-	/** Enum for identifying iframe player type. */
-	export enum FrameType {
-		YouTube = 1,
-		Vimeo = 2
-	}
-	/**
-	 * Media utilities for source parsing, type detection, and player management.
-	 * @author Marcel Duin <marcel@micr.io>
-	 */
-	/** YouTube no-cookies host */
-	export const YOUTUBE_HOST = "https://www.youtube-nocookie.com";
-	/**
-	 * Parsed media source information.
-	 */
-	interface ParsedMediaSource {
-		/** The detected media type */
-		type: MediaType;
-		/** The frame type for iframe embeds (YouTube/Vimeo) */
-		frameType?: FrameType;
-		/** The normalized/processed source URL */
-		src?: string;
-		/** YouTube video ID (if applicable) */
-		youtubeId?: string;
-		/** Vimeo video ID (if applicable) */
-		vimeoId?: string;
-		/** Vimeo hash token (if applicable) */
-		vimeoToken?: string;
-		/** Cloudflare video ID (if applicable) */
-		cloudflareId?: string;
-		/** Micrio embed data [id, width?, height?, lang?] */
-		micrioEmbed?: string[];
-		/** Start time extracted from URL (seconds) */
-		startTime?: number;
-		/** Whether the source is a Cloudflare stream */
-		isCloudflare: boolean;
-		/** M3U8 URL for HLS streams */
-		hlsSrc?: string;
-	}
-	/**
-	 * Parses a media source URL and determines its type and configuration.
-	 */
-	export function parseMediaSource(src: string | undefined, tour: Models.ImageData.VideoTour | null, useNativeFrames?: boolean, currentTime?: number): ParsedMediaSource;
-	/**
-	 * Returns a shared Audio element instance for iOS.
-	 * This is a workaround for iOS audio playback restrictions where user
-	 * interaction is required per audio element.
-	 */
-	export function getIOSAudioElement(): HTMLAudioElement;
 	/**
-	 * Adapter for YouTube IFrame Player API.
+	 * Adapter for Vimeo Player API.
 	 */
-	export class YouTubePlayerAdapter implements MediaPlayerAdapter {
+	export class VimeoPlayerAdapter implements MediaPlayerAdapter {
 		private frame;
 		private config;
 		private callbacks;
-		readonly requiresTimeTick = true;
+		readonly requiresTimeTick = false;
 		private player;
 		private destroyed;
 		constructor(frame: HTMLIFrameElement, config: PlayerConfig, callbacks?: PlayerEventCallbacks);
 		/**
-		 * Loads the YouTube API and initializes the player.
+		 * Loads the Vimeo API and initializes the player.
 		 */
 		initialize(): Promise<void>;
-		private handleStateChange;
 		play(): Promise<void>;
 		pause(): void;
 		getCurrentTime(): Promise<number>;
@@ -3179,24 +3031,25 @@ declare module '@micrio/client' {
 		getDuration(): Promise<number>;
 		isPaused(): Promise<boolean>;
 		setMuted(muted: boolean): void;
-		setVolume(_volume: number): void;
+		setVolume(volume: number): void;
 		destroy(): void;
 	}
 	/**
-	 * Adapter for Vimeo Player API.
+	 * Adapter for YouTube IFrame Player API.
 	 */
-	export class VimeoPlayerAdapter implements MediaPlayerAdapter {
+	export class YouTubePlayerAdapter implements MediaPlayerAdapter {
 		private frame;
 		private config;
 		private callbacks;
-		readonly requiresTimeTick = false;
+		readonly requiresTimeTick = true;
 		private player;
 		private destroyed;
 		constructor(frame: HTMLIFrameElement, config: PlayerConfig, callbacks?: PlayerEventCallbacks);
 		/**
-		 * Loads the Vimeo API and initializes the player.
+		 * Loads the YouTube API and initializes the player.
 		 */
 		initialize(): Promise<void>;
+		private handleStateChange;
 		play(): Promise<void>;
 		pause(): void;
 		getCurrentTime(): Promise<number>;
@@ -3204,45 +3057,24 @@ declare module '@micrio/client' {
 		getDuration(): Promise<number>;
 		isPaused(): Promise<boolean>;
 		setMuted(muted: boolean): void;
-		setVolume(volume: number): void;
+		setVolume(_volume: number): void;
 		destroy(): void;
 	}
-	/**
-	 * Media player adapters module.
-	 * Provides unified interfaces for different media player types.
-	 * @author Marcel Duin <marcel@micr.io>
-	 */
-	export type { MediaPlayerAdapter, PlayerEventCallbacks, PlayerConfig } from "ts/media/types";
-	export { HTML5PlayerAdapter } from "ts/media/html5-adapter";
-	export { YouTubePlayerAdapter } from "ts/media/youtube-adapter";
-	export { VimeoPlayerAdapter } from "ts/media/vimeo-adapter";
-	export { HLSPlayerAdapter } from "ts/media/hls-adapter";
-	export { GLEmbedVideo } from "ts/media/embedvideo";
-	export { VideoTourInstance } from "ts/media/videotour";
-	export { Grid } from "ts/nav/grid";
-	export { GallerySwiper } from "ts/nav/swiper";
-	export { Engine } from "ts/render/engine";
-	export { WebGL } from "ts/render/webgl";
-	export { Canvas } from "ts/render/canvas";
-	export { PostProcessor } from "ts/render/postprocess";
-	export { archive } from "ts/render/archive";
-	export { loadTexture, runningThreads, numThreads, abortDownload } from "ts/render/textures";
-	export type { TextureBitmap } from "ts/render/textures";
-	/**
-	 * Marker clustering algorithm for calculating overlapping markers
-	 * and generating cluster marker objects.
-	 * @author Marcel Duin <marcel@micr.io>
-	 */
-	type MarkerData = Models.ImageData.Marker;
-	export type MarkerCoords = [x: number, y: number, w?: number, h?: number];
-	interface ClusterResult {
-		overlapped: number[];
-		clusterMarkers: MarkerData[];
+	export type PREDEFINED = [string, Models.ImageInfo.ImageInfo, Models.ImageData.ImageData | undefined];
+	/** Enum for identifying media type. */
+	export enum MediaType {
+		None = 0,
+		IFrame = 1,
+		Video = 2,
+		Audio = 3,
+		VideoTour = 4,
+		Micrio = 5
+	}
+	/** Enum for identifying iframe player type. */
+	export enum FrameType {
+		YouTube = 1,
+		Vimeo = 2
 	}
-	/**
-	 * Calculates which markers overlap and generates synthetic cluster markers.
-	 */
-	export function calcClusters(visibleMarkers: MarkerData[] | undefined, coords: Map<string, MarkerCoords>, r: number, isOmni: boolean): ClusterResult;
 }declare module "svelte/store" {
 	/** Callback to inform of a value updates.
 	*/