@micrio/client 5.4.32 → 5.5.1

package/micrio.min.d.ts

@@ -4,7 +4,7 @@ declare module '@micrio/client' {
 	 * Defines the current version of the Micrio library.
 	 * This constant is used internally and exposed statically via `HTMLMicrioElement.VERSION`.
 	 */
-	export const VERSION = "5.4.32";
+	export const VERSION = "5.5.1";
 	/**
 	 * Loads an image texture asynchronously. Adds the request to the queue
 	 * and returns a Promise that resolves with the TextureBitmap or rejects on error.
@@ -36,6 +36,21 @@ declare module '@micrio/client' {
 		Vimeo = 2
 	}
 	export { isLegacyViews };
+	/**
+	 * 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];
+	export interface ClusterResult {
+		overlapped: number[];
+		clusterMarkers: MarkerData[];
+	}
+	/**
+	 * Calculates which markers overlap and generates synthetic cluster markers.
+	 */
+	export function calcClusters(visibleMarkers: MarkerData[] | undefined, coords: Map<string, MarkerCoords>, r: number, isOmni: boolean): ClusterResult;
 	/**
 	 * Media utilities for source parsing, type detection, and player management.
 	 * @author Marcel Duin <marcel@micr.io>
@@ -104,14 +119,10 @@ declare module '@micrio/client' {
 	export { loadSerialTour } from "ts/utils/tour";
 	export { getIdVal, idIsV5 } from "ts/utils/id";
 	export { getSpaceVector } from "ts/utils/space";
-	export { hasNativeHLS, parseMediaSource, getIOSAudioElement, YOUTUBE_HOST } from "ts/utils/media";
+	export { calcClusters } from "ts/utils/clustering";
+	export type { MarkerCoords, ClusterResult } from "ts/utils/clustering";
+	export { hasNativeHLS, parseMediaSource, getIOSAudioElement, getAudioSrc, getMarkerCulture, getMenuCulture, YOUTUBE_HOST } from "ts/utils/media";
 	export type { ParsedMediaSource } from "ts/utils/media";
-	/**
-	 * Global utility functions used throughout the Micrio application.
-	 * This file re-exports all utilities from the modular utils/ directory.
-	 * @author Marcel Duin <marcel@micr.io>
-	 */
-	export * from "ts/utils/index";
 	/**
 	 * Defines various enums used throughout the Micrio application,
 	 * primarily for standardizing action types and option values.
@@ -768,35 +779,20 @@ declare module '@micrio/client' {
 		set(input?: string | MicrioImage[] | ({
 			image: MicrioImage;
 		} & Models.Grid.GridImageOptions)[], opts?: {
-			/** If true, does not add the previous layout to the history stack. */
 			noHistory?: boolean;
-			/** If true, keeps the HTML grid element in the DOM (used internally). */
 			keepGrid?: boolean;
-			/** If true, arranges images in a single horizontal row. */
 			horizontal?: boolean;
-			/** Overrides the default animation duration for the main grid view transition. */
 			duration?: number;
-			/** If provided, animates the main grid view to this viewport rectangle. */
 			view?: Models.Camera.View;
-			/** If true, skips the main grid camera animation. */
 			noCamAni?: boolean;
-			/** If true, forces area animation even for images not currently visible. */
 			forceAreaAni?: boolean;
-			/** If true, does not unfocus the currently focused image when setting a new layout. */
 			noBlur?: boolean;
-			/** If true, skips the fade-in animation for new images. */
 			noFade?: boolean;
-			/** Specifies the transition animation type (e.g., 'crossfade', 'slide-left', 'behind-delayed'). */
 			transition?: Models.Grid.GridSetTransition;
-			/** If true, forces animation even if duration is 0. */
 			forceAni?: boolean;
-			/** If true, limits individual image views to cover their grid cell. */
 			coverLimit?: boolean;
-			/** If true, sets the initial view of images to cover their grid cell (but doesn't enforce limit). */
 			cover?: boolean;
-			/** Scale factor (0-1) applied to each grid cell (creates margins). */
 			scale?: number;
-			/** Overrides the automatic calculation of grid columns. */
 			columns?: number;
 		}): Promise<MicrioImage[]>;
 		/**
@@ -810,7 +806,7 @@ declare module '@micrio/client' {
 		 * @returns The grid encoded string for this image.
 		*/
 		getString: (i: Models.ImageInfo.ImageInfo, opts?: Models.Grid.GridImageOptions) => string;
-		/** Fade out unused images in the grid
+		/** Fade out unused images in the grid and clean up their button references.
 		 * @param images The images to hide
 		*/
 		private removeImages;
@@ -908,6 +904,40 @@ declare module '@micrio/client' {
 		 */
 		private setProgress;
 	}
+	/**
+	 * Lightweight inline SVG icon definitions, replacing @fortawesome/free-solid-svg-icons + svelte-fa.
+	 * Each icon is a tuple: [width, height, svgPath].
+	 * @author Marcel Duin <marcel@micr.io>
+	 */
+	export type MicrioIcon = [width: number, height: number, path: string];
+	export const icons: {
+		readonly arrowDown: [384, 512, "M169.4 502.6c12.5 12.5 32.8 12.5 45.3 0l160-160c12.5-12.5 12.5-32.8 0-45.3s-32.8-12.5-45.3 0L224 402.7 224 32c0-17.7-14.3-32-32-32s-32 14.3-32 32l0 370.7-105.4-105.4c-12.5-12.5-32.8-12.5-45.3 0s-12.5 32.8 0 45.3l160 160z"];
+		readonly arrowLeft: [512, 512, "M9.4 233.4c-12.5 12.5-12.5 32.8 0 45.3l160 160c12.5 12.5 32.8 12.5 45.3 0s12.5-32.8 0-45.3L109.3 288 480 288c17.7 0 32-14.3 32-32s-14.3-32-32-32l-370.7 0 105.4-105.4c12.5-12.5 12.5-32.8 0-45.3s-32.8-12.5-45.3 0l-160 160z"];
+		readonly arrowRight: [512, 512, "M502.6 278.6c12.5-12.5 12.5-32.8 0-45.3l-160-160c-12.5-12.5-32.8-12.5-45.3 0s-12.5 32.8 0 45.3L402.7 224 32 224c-17.7 0-32 14.3-32 32s14.3 32 32 32l370.7 0-105.4 105.4c-12.5 12.5-12.5 32.8 0 45.3s32.8 12.5 45.3 0l160-160z"];
+		readonly arrowUp: [384, 512, "M214.6 9.4c-12.5-12.5-32.8-12.5-45.3 0l-160 160c-12.5 12.5-12.5 32.8 0 45.3s32.8 12.5 45.3 0L160 109.3 160 480c0 17.7 14.3 32 32 32s32-14.3 32-32l0-370.7 105.4 105.4c12.5 12.5 32.8 12.5 45.3 0s12.5-32.8 0-45.3l-160-160z"];
+		readonly bars: [448, 512, "M0 96C0 78.3 14.3 64 32 64l384 0c17.7 0 32 14.3 32 32s-14.3 32-32 32L32 128C14.3 128 0 113.7 0 96zM0 256c0-17.7 14.3-32 32-32l384 0c17.7 0 32 14.3 32 32s-14.3 32-32 32L32 288c-17.7 0-32-14.3-32-32zM448 416c0 17.7-14.3 32-32 32L32 448c-17.7 0-32-14.3-32-32s14.3-32 32-32l384 0c17.7 0 32 14.3 32 32z"];
+		readonly chevronDown: [448, 512, "M201.4 406.6c12.5 12.5 32.8 12.5 45.3 0l192-192c12.5-12.5 12.5-32.8 0-45.3s-32.8-12.5-45.3 0L224 338.7 54.6 169.4c-12.5-12.5-32.8-12.5-45.3 0s-12.5 32.8 0 45.3l192 192z"];
+		readonly circleExclamation: [512, 512, "M256 512a256 256 0 1 1 0-512 256 256 0 1 1 0 512zm0-192a32 32 0 1 0 0 64 32 32 0 1 0 0-64zm0-192c-18.2 0-32.7 15.5-31.4 33.7l7.4 104c.9 12.6 11.4 22.3 23.9 22.3 12.6 0 23-9.7 23.9-22.3l7.4-104c1.3-18.2-13.1-33.7-31.4-33.7z"];
+		readonly closedCaptioning: [512, 512, "M0 128C0 92.7 28.7 64 64 64l384 0c35.3 0 64 28.7 64 64l0 256c0 35.3-28.7 64-64 64L64 448c-35.3 0-64-28.7-64-64L0 128zm152 80l32 0c4.4 0 8 3.6 8 8 0 13.3 10.7 24 24 24s24-10.7 24-24c0-30.9-25.1-56-56-56l-32 0c-30.9 0-56 25.1-56 56l0 80c0 30.9 25.1 56 56 56l32 0c30.9 0 56-25.1 56-56 0-13.3-10.7-24-24-24s-24 10.7-24 24c0 4.4-3.6 8-8 8l-32 0c-4.4 0-8-3.6-8-8l0-80c0-4.4 3.6-8 8-8zm168 8c0-4.4 3.6-8 8-8l32 0c4.4 0 8 3.6 8 8 0 13.3 10.7 24 24 24s24-10.7 24-24c0-30.9-25.1-56-56-56l-32 0c-30.9 0-56 25.1-56 56l0 80c0 30.9 25.1 56 56 56l32 0c30.9 0 56-25.1 56-56 0-13.3-10.7-24-24-24s-24 10.7-24 24c0 4.4-3.6 8-8 8l-32 0c-4.4 0-8-3.6-8-8l0-80z"];
+		readonly compress: [448, 512, "M160 64c0-17.7-14.3-32-32-32S96 46.3 96 64l0 64-64 0c-17.7 0-32 14.3-32 32s14.3 32 32 32l96 0c17.7 0 32-14.3 32-32l0-96zM32 320c-17.7 0-32 14.3-32 32s14.3 32 32 32l64 0 0 64c0 17.7 14.3 32 32 32s32-14.3 32-32l0-96c0-17.7-14.3-32-32-32l-96 0zM352 64c0-17.7-14.3-32-32-32s-32 14.3-32 32l0 96c0 17.7 14.3 32 32 32l96 0c17.7 0 32-14.3 32-32s-14.3-32-32-32l-64 0 0-64zM320 320c-17.7 0-32 14.3-32 32l0 96c0 17.7 14.3 32 32 32s32-14.3 32-32l0-64 64 0c17.7 0 32-14.3 32-32s-14.3-32-32-32l-96 0z"];
+		readonly ellipsisVertical: [128, 512, "M64 144a56 56 0 1 1 0-112 56 56 0 1 1 0 112zm0 224c30.9 0 56 25.1 56 56s-25.1 56-56 56-56-25.1-56-56 25.1-56 56-56zm56-112c0 30.9-25.1 56-56 56s-56-25.1-56-56 25.1-56 56-56 56 25.1 56 56z"];
+		readonly expand: [448, 512, "M32 32C14.3 32 0 46.3 0 64l0 96c0 17.7 14.3 32 32 32s32-14.3 32-32l0-64 64 0c17.7 0 32-14.3 32-32s-14.3-32-32-32L32 32zM64 352c0-17.7-14.3-32-32-32S0 334.3 0 352l0 96c0 17.7 14.3 32 32 32l96 0c17.7 0 32-14.3 32-32s-14.3-32-32-32l-64 0 0-64zM320 32c-17.7 0-32 14.3-32 32s14.3 32 32 32l64 0 0 64c0 17.7 14.3 32 32 32s32-14.3 32-32l0-96c0-17.7-14.3-32-32-32l-96 0zM448 352c0-17.7-14.3-32-32-32s-32 14.3-32 32l0 64-64 0c-17.7 0-32 14.3-32 32s14.3 32 32 32l96 0c17.7 0 32-14.3 32-32l0-96z"];
+		readonly externalLink: [512, 512, "M320 0c-17.7 0-32 14.3-32 32s14.3 32 32 32l82.7 0-201.4 201.4c-12.5 12.5-12.5 32.8 0 45.3s32.8 12.5 45.3 0L448 109.3 448 192c0 17.7 14.3 32 32 32s32-14.3 32-32l0-160c0-17.7-14.3-32-32-32L320 0zM80 96C35.8 96 0 131.8 0 176L0 432c0 44.2 35.8 80 80 80l256 0c44.2 0 80-35.8 80-80l0-80c0-17.7-14.3-32-32-32s-32 14.3-32 32l0 80c0 8.8-7.2 16-16 16L80 448c-8.8 0-16-7.2-16-16l0-256c0-8.8 7.2-16 16-16l80 0c17.7 0 32-14.3 32-32s-14.3-32-32-32L80 96z"];
+		readonly globe: [512, 512, "M351.9 280l-190.9 0c2.9 64.5 17.2 123.9 37.5 167.4 11.4 24.5 23.7 41.8 35.1 52.4 11.2 10.5 18.9 12.2 22.9 12.2s11.7-1.7 22.9-12.2c11.4-10.6 23.7-28 35.1-52.4 20.3-43.5 34.6-102.9 37.5-167.4zM160.9 232l190.9 0C349 167.5 334.7 108.1 314.4 64.6 303 40.2 290.7 22.8 279.3 12.2 268.1 1.7 260.4 0 256.4 0s-11.7 1.7-22.9 12.2c-11.4 10.6-23.7 28-35.1 52.4-20.3 43.5-34.6 102.9-37.5 167.4zm-48 0C116.4 146.4 138.5 66.9 170.8 14.7 78.7 47.3 10.9 131.2 1.5 232l111.4 0zM1.5 280c9.4 100.8 77.2 184.7 169.3 217.3-32.3-52.2-54.4-131.7-57.9-217.3L1.5 280zm398.4 0c-3.5 85.6-25.6 165.1-57.9 217.3 92.1-32.7 159.9-116.5 169.3-217.3l-111.4 0zm111.4-48C501.9 131.2 434.1 47.3 342 14.7 374.3 66.9 396.4 146.4 399.9 232l111.4 0z"];
+		readonly image: [448, 512, "M64 32C28.7 32 0 60.7 0 96L0 416c0 35.3 28.7 64 64 64l320 0c35.3 0 64-28.7 64-64l0-320c0-35.3-28.7-64-64-64L64 32zm64 80a48 48 0 1 1 0 96 48 48 0 1 1 0-96zM272 224c8.4 0 16.1 4.4 20.5 11.5l88 144c4.5 7.4 4.7 16.7 .5 24.3S368.7 416 360 416L88 416c-8.9 0-17.2-5-21.3-12.9s-3.5-17.5 1.6-24.8l56-80c4.5-6.4 11.8-10.2 19.7-10.2s15.2 3.8 19.7 10.2l26.4 37.8 61.4-100.5c4.4-7.1 12.1-11.5 20.5-11.5z"];
+		readonly layerGroup: [512, 512, "M232.5 5.2c14.9-6.9 32.1-6.9 47 0l218.6 101c8.5 3.9 13.9 12.4 13.9 21.8s-5.4 17.9-13.9 21.8l-218.6 101c-14.9 6.9-32.1 6.9-47 0L13.9 149.8C5.4 145.8 0 137.3 0 128s5.4-17.9 13.9-21.8L232.5 5.2zM48.1 218.4l164.3 75.9c27.7 12.8 59.6 12.8 87.3 0l164.3-75.9 34.1 15.8c8.5 3.9 13.9 12.4 13.9 21.8s-5.4 17.9-13.9 21.8l-218.6 101c-14.9 6.9-32.1 6.9-47 0L13.9 277.8C5.4 273.8 0 265.3 0 256s5.4-17.9 13.9-21.8l34.1-15.8zM13.9 362.2l34.1-15.8 164.3 75.9c27.7 12.8 59.6 12.8 87.3 0l164.3-75.9 34.1 15.8c8.5 3.9 13.9 12.4 13.9 21.8s-5.4 17.9-13.9 21.8l-218.6 101c-14.9 6.9-32.1 6.9-47 0L13.9 405.8C5.4 401.8 0 393.3 0 384s5.4-17.9 13.9-21.8z"];
+		readonly link: [576, 512, "M419.5 96c-16.6 0-32.7 4.5-46.8 12.7-15.8-16-34.2-29.4-54.5-39.5 28.2-24 64.1-37.2 101.3-37.2 86.4 0 156.5 70 156.5 156.5 0 41.5-16.5 81.3-45.8 110.6l-71.1 71.1c-29.3 29.3-69.1 45.8-110.6 45.8-86.4 0-156.5-70-156.5-156.5 0-1.5 0-3 .1-4.5 .5-17.7 15.2-31.6 32.9-31.1s31.6 15.2 31.1 32.9c0 .9 0 1.8 0 2.6 0 51.1 41.4 92.5 92.5 92.5 24.5 0 48-9.7 65.4-27.1l71.1-71.1c17.3-17.3 27.1-40.9 27.1-65.4 0-51.1-41.4-92.5-92.5-92.5zM275.2 173.3c-1.9-.8-3.8-1.9-5.5-3.1-12.6-6.5-27-10.2-42.1-10.2-24.5 0-48 9.7-65.4 27.1L91.1 258.2c-17.3 17.3-27.1 40.9-27.1 65.4 0 51.1 41.4 92.5 92.5 92.5 16.5 0 32.6-4.4 46.7-12.6 15.8 16 34.2 29.4 54.6 39.5-28.2 23.9-64 37.2-101.3 37.2-86.4 0-156.5-70-156.5-156.5 0-41.5 16.5-81.3 45.8-110.6l71.1-71.1c29.3-29.3 69.1-45.8 110.6-45.8 86.6 0 156.5 70.6 156.5 156.9 0 1.3 0 2.6 0 3.9-.4 17.7-15.1 31.6-32.8 31.2s-31.6-15.1-31.2-32.8c0-.8 0-1.5 0-2.3 0-33.7-18-63.3-44.8-79.6z"];
+		readonly minus: [448, 512, "M0 256c0-17.7 14.3-32 32-32l384 0c17.7 0 32 14.3 32 32s-14.3 32-32 32L32 288c-17.7 0-32-14.3-32-32z"];
+		readonly pause: [384, 512, "M48 32C21.5 32 0 53.5 0 80L0 432c0 26.5 21.5 48 48 48l64 0c26.5 0 48-21.5 48-48l0-352c0-26.5-21.5-48-48-48L48 32zm224 0c-26.5 0-48 21.5-48 48l0 352c0 26.5 21.5 48 48 48l64 0c26.5 0 48-21.5 48-48l0-352c0-26.5-21.5-48-48-48l-64 0z"];
+		readonly play: [448, 512, "M91.2 36.9c-12.4-6.8-27.4-6.5-39.6 .7S32 57.9 32 72l0 368c0 14.1 7.5 27.2 19.6 34.4s27.2 7.5 39.6 .7l336-184c12.8-7 20.8-20.5 20.8-35.1s-8-28.1-20.8-35.1l-336-184z"];
+		readonly playCircle: [512, 512, "M0 256a256 256 0 1 1 512 0 256 256 0 1 1 -512 0zM188.3 147.1c-7.6 4.2-12.3 12.3-12.3 20.9l0 176c0 8.7 4.7 16.7 12.3 20.9s16.8 4.1 24.3-.5l144-88c7.1-4.4 11.5-12.1 11.5-20.5s-4.4-16.1-11.5-20.5l-144-88c-7.4-4.5-16.7-4.7-24.3-.5z"];
+		readonly plus: [448, 512, "M256 64c0-17.7-14.3-32-32-32s-32 14.3-32 32l0 160-160 0c-17.7 0-32 14.3-32 32s14.3 32 32 32l160 0 0 160c0 17.7 14.3 32 32 32s32-14.3 32-32l0-160 160 0c17.7 0 32-14.3 32-32s-14.3-32-32-32l-160 0 0-160z"];
+		readonly share: [512, 512, "M307.8 18.4c-12 5-19.8 16.6-19.8 29.6l0 80-112 0c-97.2 0-176 78.8-176 176 0 113.3 81.5 163.9 100.2 174.1 2.5 1.4 5.3 1.9 8.1 1.9 10.9 0 19.7-8.9 19.7-19.7 0-7.5-4.3-14.4-9.8-19.5-9.4-8.8-22.2-26.4-22.2-56.7 0-53 43-96 96-96l96 0 0 80c0 12.9 7.8 24.6 19.8 29.6s25.7 2.2 34.9-6.9l160-160c12.5-12.5 12.5-32.8 0-45.3l-160-160c-9.2-9.2-22.9-11.9-34.9-6.9z"];
+		readonly video: [576, 512, "M96 64c-35.3 0-64 28.7-64 64l0 256c0 35.3 28.7 64 64 64l256 0c35.3 0 64-28.7 64-64l0-256c0-35.3-28.7-64-64-64L96 64zM464 336l73.5 58.8c4.2 3.4 9.4 5.2 14.8 5.2 13.1 0 23.7-10.6 23.7-23.7l0-240.6c0-13.1-10.6-23.7-23.7-23.7-5.4 0-10.6 1.8-14.8 5.2L464 176 464 336z"];
+		readonly volumeHigh: [640, 512, "M533.6 32.5c-10.3-8.4-25.4-6.8-33.8 3.5s-6.8 25.4 3.5 33.8C557.5 113.8 592 180.8 592 256s-34.5 142.2-88.7 186.3c-10.3 8.4-11.8 23.5-3.5 33.8s23.5 11.8 33.8 3.5C598.5 426.7 640 346.2 640 256S598.5 85.2 533.6 32.5zM473.1 107c-10.3-8.4-25.4-6.8-33.8 3.5s-6.8 25.4 3.5 33.8C475.3 170.7 496 210.9 496 256s-20.7 85.3-53.2 111.8c-10.3 8.4-11.8 23.5-3.5 33.8s23.5 11.8 33.8 3.5c43.2-35.2 70.9-88.9 70.9-149s-27.7-113.8-70.9-149zm-60.5 74.5c-10.3-8.4-25.4-6.8-33.8 3.5s-6.8 25.4 3.5 33.8C393.1 227.6 400 241 400 256s-6.9 28.4-17.7 37.3c-10.3 8.4-11.8 23.5-3.5 33.8s23.5 11.8 33.8 3.5C434.1 312.9 448 286.1 448 256s-13.9-56.9-35.4-74.5zM80 352l48 0 134.1 119.2c6.4 5.7 14.6 8.8 23.1 8.8 19.2 0 34.8-15.6 34.8-34.8l0-378.4c0-19.2-15.6-34.8-34.8-34.8-8.5 0-16.7 3.1-23.1 8.8L128 160 80 160c-26.5 0-48 21.5-48 48l0 96c0 26.5 21.5 48 48 48z"];
+		readonly volumeXmark: [576, 512, "M48 352l48 0 134.1 119.2c6.4 5.7 14.6 8.8 23.1 8.8 19.2 0 34.8-15.6 34.8-34.8l0-378.4c0-19.2-15.6-34.8-34.8-34.8-8.5 0-16.7 3.1-23.1 8.8L96 160 48 160c-26.5 0-48 21.5-48 48l0 96c0 26.5 21.5 48 48 48zM367 175c-9.4 9.4-9.4 24.6 0 33.9l47 47-47 47c-9.4 9.4-9.4 24.6 0 33.9s24.6 9.4 33.9 0l47-47 47 47c9.4 9.4 24.6 9.4 33.9 0s9.4-24.6 0-33.9l-47-47 47-47c9.4-9.4 9.4-24.6 0-33.9s-24.6-9.4-33.9 0l-47 47-47-47c-9.4-9.4-24.6-9.4-33.9 0z"];
+		readonly xmark: [384, 512, "M55.1 73.4c-12.5-12.5-32.8-12.5-45.3 0s-12.5 32.8 0 45.3L147.2 256 9.9 393.4c-12.5 12.5-12.5 32.8 0 45.3s32.8 12.5 45.3 0L192.5 301.3 329.9 438.6c12.5 12.5 32.8 12.5 45.3 0s12.5-32.8 0-45.3L237.8 256 375.1 118.6c12.5-12.5 12.5-32.8 0-45.3s-32.8-12.5-45.3 0L192.5 210.7 55.1 73.4z"];
+	};
 	/**
 	 * # Micrio JSON data model
 	 *
@@ -923,6 +953,10 @@ declare module '@micrio/client' {
 	 *
 	 */
 	export namespace Models {
+		/** Language-keyed localization map. */
+		type I18n<T> = {
+			[lang: string]: T;
+		};
 		type RevisionType = {
 			[key: string]: number;
 		};
@@ -1207,7 +1241,8 @@ declare module '@micrio/client' {
 				_360?: {
 					/** A 360 video object */
 					video?: Assets.Video;
-					/** Y rotation true north correction */
+					/** @deprecated Use `Spaces.SpaceImage.rotationY` (radians). Normalized
+					 *  [0,1] image-X offset, 0.5 = identity. Still honoured for back-compat. */
 					trueNorth?: number;
 					/** 2D embed X rotation in 360 */
 					rotX?: number;
@@ -1457,9 +1492,7 @@ declare module '@micrio/client' {
 				/** V5+: Save revision */
 				revision?: RevisionType;
 				/** Localized image details */
-				i18n?: {
-					[key: string]: ImageDetailsCultureData;
-				};
+				i18n?: I18n<ImageDetailsCultureData>;
 				/** Markers */
 				markers?: ImageData.Marker[];
 				/** Marker tours */
@@ -1518,9 +1551,7 @@ declare module '@micrio/client' {
 				x: number;
 				/** The relative marker Y coordinate [0-1] */
 				y: number;
-				i18n?: {
-					[key: string]: MarkerCultureData;
-				};
+				i18n?: I18n<MarkerCultureData>;
 				/** Omni-objects: radius from center */
 				radius?: number;
 				/** Rotation is concave: it's on the back of a front-rounded shape */
@@ -1536,11 +1567,11 @@ declare module '@micrio/client' {
 				/** Content type, for displaying */
 				type?: ('default' | 'image' | 'audio' | 'video' | 'media' | 'link' | 'waypoint' | 'cluster');
 				/** Popup type */
-				popupType: ('popup' | 'popover' | 'none' | 'micrioLink');
+				popupType?: ('popup' | 'popover' | 'none' | 'micrioLink');
 				/** If type is area, this HTML embed will be used for the marker */
 				clickableArea?: Models.ImageData.Embed;
 				/** Custom marker tags which will be also used as classnames on the marker elements */
-				tags: string[];
+				tags?: string[];
 				/** Autoplay the audio asset when the marker is opened */
 				audioAutoPlay?: boolean;
 				/** Autoplay video embed when the marker is opened */
@@ -1673,9 +1704,7 @@ declare module '@micrio/client' {
 				/** The tour id */
 				id: string;
 				/** Localized tour culture data */
-				i18n?: {
-					[key: string]: TourCultureData;
-				};
+				i18n?: I18n<TourCultureData>;
 				/** Auto-minimize controls while playing and idle */
 				minimize?: boolean;
 				/** Cannot close this tour */
@@ -1712,9 +1741,7 @@ declare module '@micrio/client' {
 			 */
 			type VideoTour = Tour & {
 				/** Localized videotour culture data */
-				i18n?: {
-					[key: string]: VideoTourCultureData;
-				};
+				i18n?: I18n<VideoTourCultureData>;
 				/** Don't hide the markers when running */
 				keepMarkers?: boolean;
 				/** Don't disable user navigation when running */
@@ -1819,9 +1846,7 @@ declare module '@micrio/client' {
 				/** The menu ID */
 				id: string;
 				/** Localized culture data */
-				i18n?: {
-					[key: string]: MenuCultureData;
-				};
+				i18n?: I18n<MenuCultureData>;
 				/** Child menu elements */
 				children?: Menu[];
 				/** Open this marker when clicking menu */
@@ -1887,12 +1912,10 @@ declare module '@micrio/client' {
 				/** Used DeepZoom format */
 				isDeepZoom?: boolean;
 				/** V5+: Translatable description */
-				i18n?: {
-					[key: string]: {
-						title?: string;
-						description?: string;
-					};
-				};
+				i18n?: I18n<{
+					title?: string;
+					description?: string;
+				}>;
 			};
 			type Video = BaseAsset & {
 				/** The video width */
@@ -1931,7 +1954,7 @@ declare module '@micrio/client' {
 				y: number;
 				/** Z position of 360 image in zone */
 				z: number;
-				/** RotationY => .trueNorth */
+				/** Y-axis sphere rotation in radians (aligns linked 360 images). */
 				rotationY: number;
 			}
 			interface Space {
@@ -2070,20 +2093,22 @@ declare module '@micrio/client' {
 			hooked?: boolean;
 		}
 		namespace Camera {
-			/** A viewport rectangle [x0,y0,x1,y1] */
-			type ViewRect = number[] | Float64Array;
-			/** An area definition [x0,y0,width,height] */
-			type View = number[] | Float64Array;
+			/** A numeric array or Float64Array used for camera geometry. */
+			type CameraArray = number[] | Float64Array;
+			/** A viewport rectangle `[x0, y0, x1, y1]` (corners). */
+			export type ViewRect = CameraArray;
+			/** An area definition `[x0, y0, width, height]` (origin + size). */
+			export type View = CameraArray;
 			/** Coordinate tuple, [x, y, scale] */
-			type Coords = [number, number, number?] | Float64Array;
+			export type Coords = [number, number, number?] | Float64Array;
 			/** A 360 vector for use in Spaces */
-			type Vector = {
+			export type Vector = {
 				direction: number;
 				distanceX: number;
 				distanceY: number;
 			};
-			type TimingFunction = ('ease' | 'ease-in' | 'ease-out' | 'linear');
-			interface AnimationOptions {
+			export type TimingFunction = ('ease' | 'ease-in' | 'ease-out' | 'linear');
+			export interface AnimationOptions {
 				/** Animation duration in ms */
 				duration?: number;
 				/** Limit the viewport to fill the screen */
@@ -2093,6 +2118,7 @@ declare module '@micrio/client' {
 				/** Transition timing function */
 				timingFunction?: TimingFunction;
 			}
+			export {};
 		}
 		namespace Embeds {
 			interface EmbedOptions {
@@ -2372,6 +2398,41 @@ declare module '@micrio/client' {
 		/** Disposes WebGL resources used by the PostProcessor. */
 		dispose(): void;
 	}
+	/**
+	 * Manages the HTML `<canvas>` element used for WebGL rendering,
+	 * handles resizing, and provides viewport information.
+	 * Accessed via `micrio.canvas`.
+	 */
+	export class Canvas {
+		private micrio;
+		/** The main WebGL rendering `<canvas>` element. */
+		readonly element: HTMLCanvasElement;
+		/** Object containing current viewport dimensions, position, and ratios. */
+		readonly viewport: Models.Canvas.ViewRect;
+		/** Writable Svelte store indicating if the client is likely a mobile device. */
+		readonly isMobile: Writable<boolean>;
+		/** Getter for the current value of the {@link isMobile} store. */
+		get $isMobile(): boolean;
+		/**
+		 * Creates a Canvas controller instance.
+		 * @param micrio The main HTMLMicrioElement instance.
+		 */
+		constructor(micrio: HTMLMicrioElement);
+		/**
+		 * Gets the appropriate device pixel ratio for rendering.
+		 * Clamped between 1 and 2, disabled on iOS and if `noRetina` setting is true.
+		 * @param s Optional image settings object to check for `noRetina`.
+		 * @returns The calculated device pixel ratio.
+		 */
+		getRatio: (s?: Partial<Models.ImageInfo.Settings>) => number;
+		/**
+		 * Sets virtual offset margins in the Wasm controller.
+		 * This likely affects how viewports are calculated or limited.
+		 * @param width The horizontal offset margin in pixels.
+		 * @param height The vertical offset margin in pixels.
+		*/
+		setMargins(width: number, height: number): void;
+	}
 	/** Type alias for common event types handled. */
 	export type AllEvents = WheelEvent | MouseEvent | TouchEvent;
 	/** Internal state variables used by the Events controller. */
@@ -2405,8 +2466,6 @@ declare module '@micrio/client' {
 			stack: string[];
 		};
 	};
-	/** Flag indicating if passive event listeners are supported (assumed true). */
-	export const supportsPassive = true;
 	/** Event listener options for passive listeners. */
 	export const eventPassive: AddEventListenerOptions;
 	/** Event listener options for passive, capturing listeners. */
@@ -2472,6 +2531,101 @@ 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.
@@ -2502,6 +2656,13 @@ declare module '@micrio/client' {
 		 * @param noDispatch If true, suppresses the 'panend' event.
 		 */
 		stop(e?: PointerEvent, noKinetic?: boolean, noDispatch?: boolean): void;
+		/**
+		 * Handles `pointercancel` (e.g. when the browser hijacks the touch for
+		 * its own scrolling/zooming because the gesture started on an element
+		 * without `touch-action: none`). Cleans up panning state without
+		 * triggering kinetic motion or a regular `panend`.
+		 */
+		private cancel;
 	}
 	/**
 	 * Touch pinch event handler module (iOS).
@@ -2654,34 +2815,7 @@ declare module '@micrio/client' {
 		 */
 		private click;
 	}
-	/**
-	 * 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 { Events } from "ts/events/facade";
 	export { DragHandler } from "ts/events/drag";
 	export { PinchHandler } from "ts/events/pinch";
 	export { PointerPinchHandler } from "ts/events/pointer-pinch";
@@ -2689,110 +2823,8 @@ declare module '@micrio/client' {
 	export { WheelHandler } from "ts/events/wheel";
 	export { KeyboardHandler } from "ts/events/keyboard";
 	export { DoubleTapHandler } from "ts/events/doubletap";
-	export { UpdateHandler, UpdateEvents } from "ts/events/update";
-	export { type AllEvents, type EventStateVars, type EventContext, supportsPassive, eventPassive, eventPassiveCapture, noEventPassive, cancelPrevent, } from "ts/events/shared";
-	export { UpdateEvents } from "ts/events/index";
-	/**
-	 * 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;
-	}
-	/**
-	 * Manages the HTML `<canvas>` element used for WebGL rendering,
-	 * handles resizing, and provides viewport information.
-	 * Accessed via `micrio.canvas`.
-	 */
-	export class Canvas {
-		private micrio;
-		/** The main WebGL rendering `<canvas>` element. */
-		readonly element: HTMLCanvasElement;
-		/** Object containing current viewport dimensions, position, and ratios. */
-		readonly viewport: Models.Canvas.ViewRect;
-		/** Writable Svelte store indicating if the client is likely a mobile device. */
-		readonly isMobile: Writable<boolean>;
-		/** Getter for the current value of the {@link isMobile} store. */
-		get $isMobile(): boolean;
-		/**
-		 * Creates a Canvas controller instance.
-		 * @param micrio The main HTMLMicrioElement instance.
-		 */
-		constructor(micrio: HTMLMicrioElement);
-		/**
-		 * Gets the appropriate device pixel ratio for rendering.
-		 * Clamped between 1 and 2, disabled on iOS and if `noRetina` setting is true.
-		 * @param s Optional image settings object to check for `noRetina`.
-		 * @returns The calculated device pixel ratio.
-		 */
-		getRatio: (s?: Partial<Models.ImageInfo.Settings>) => number;
-		/**
-		 * Sets virtual offset margins in the Wasm controller.
-		 * This likely affects how viewports are calculated or limited.
-		 * @param width The horizontal offset margin in pixels.
-		 * @param height The vertical offset margin in pixels.
-		*/
-		setMargins(width: number, height: number): void;
-	}
+	export { UpdateHandler } from "ts/events/update";
+	export { type AllEvents, type EventStateVars, type EventContext, eventPassive, eventPassiveCapture, noEventPassive, cancelPrevent, } from "ts/events/shared";
 	/**
 	 * Language-related constants and utilities.
 	 */
@@ -2811,7 +2843,7 @@ declare module '@micrio/client' {
 	 * languageNames?.of('nl'); // Output might be "Dutch" (depending on browser locale)
 	 * ```
 	 */
-	export const languageNames: Intl.DisplayNames;
+	export const languageNames: Intl.DisplayNames | undefined;
 	/**
 	 * An array of language codes that are typically written Right-to-Left (RTL).
 	 * Used by the `HTMLMicrioElement` to set the `dir="rtl"` attribute when an RTL language is selected.
@@ -2994,6 +3026,8 @@ 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).
@@ -3189,6 +3223,18 @@ declare module '@micrio/client' {
 	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 { Router } from "ts/nav/router";
+	export { Grid } from "ts/nav/grid";
+	export { GallerySwiper } from "ts/nav/swiper";
+	export { Wasm } from "ts/render/wasm";
+	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";
 }declare module "svelte/store" {
 	/** Callback to inform of a value updates.
 	*/