@micrio/client 6.0.11 → 6.0.13

package/micrio.min.d.ts

@@ -778,8 +778,11 @@ declare module '@micrio/client' {
 		readonly images: MicrioImage[];
 		/** Array of {@link MicrioImage} instances currently visible in the grid layout. */
 		current: MicrioImage[];
-		/** If true, the HTML grid overlay remains visible and interactive even when an image is focused. */
-		clickable: boolean;
+		/** If truthy, the HTML grid overlay remains visible and interactive when an image is focused.
+		 * `'focus'` expands the image to full view, `'zoom'` zooms the main camera to the image's viewport. */
+		clickable: 'focus' | 'zoom' | false;
+		/** Pan/zoom behavior: `'cells'` operates on the individual cell under the cursor, `'grid'` on the main container. */
+		panZoom: 'cells' | 'grid';
 		/** Writable Svelte store holding the currently focused {@link MicrioImage} instance, or undefined if in grid view. */
 		readonly focussed: Writable<MicrioImage | undefined>;
 		/** Getter for the current value of the {@link focussed} store. */
@@ -796,12 +799,17 @@ declare module '@micrio/client' {
 		aniDurationOut: number;
 		/** Delay (seconds) between individual image transitions for 'delayed' effects. */
 		transitionDelay: number;
+		/** If true, keyboard arrow navigation is active and should bypass the default key handler. */
+		static handlingKeys: boolean;
 		/**
 		 * The Grid constructor. Initializes the grid based on image settings.
 		 * @param micrio The main HTMLMicrioElement instance.
 		 * @param image The MicrioImage instance acting as the virtual container for the grid.
 		*/
 		constructor(micrio: HTMLMicrioElement, image: MicrioImage);
+		private _clickDown;
+		private _clickStart;
+		private _clickEnd;
 		/**
 		 * Sets the grid layout based on an input string or array of image definitions.
 		 * This is the main method for changing the grid's content and appearance.
@@ -889,7 +897,9 @@ declare module '@micrio/client' {
 		 * @returns Promise when the transition is completed
 		*/
 		enlarge(idx: number, width: number, height?: number): Promise<MicrioImage[]>;
-		/** Get the relative in-grid viewport of the image */
+		/** Returns the grid image under the given screen coordinates (clientX, clientY).
+		 *  If the current image is a focused grid child, returns it directly. */
+		getImageAt(clientX: number, clientY: number): MicrioImage | undefined;
 		getRelativeView(image: MicrioImage, view: Models.Camera.ViewRect): Models.Camera.ViewRect;
 	}
 	/**
@@ -1296,12 +1306,17 @@ declare module '@micrio/client' {
 				};
 				/** UI customizations */
 				ui?: Partial<UserInterfaceSettings>;
-				/** Grid: can click individual grid images */
-				gridClickable?: boolean;
-				/** Grid: transition duration, in seconds */
-				gridTransitionDuration?: number;
-				/** Grid: transition duration going back, in seconds */
-				gridTransitionDurationOut?: number;
+				/** Grid display and interaction settings */
+				grid?: {
+					/** Click behavior for grid images: `'focus'` expands to full view, `'zoom'` zooms to the image's viewport */
+					clickable?: 'focus' | 'zoom';
+					/** Pan/zoom behavior: `'cells'` operates on the individual cell under the cursor, `'grid'` operates on the main grid container */
+					panZoom?: 'cells' | 'grid';
+					/** Transition duration for grid animations, in seconds */
+					transitionDuration?: number;
+					/** Transition duration when going back, in seconds */
+					transitionDurationOut?: number;
+				};
 				/** ADVANCED: A fragment shader for WebGL postprocessing
 				 * This shader MUST have and use:
 				 * uniform sampler2D u_image; // the render buffer texture
@@ -1318,7 +1333,7 @@ declare module '@micrio/client' {
 				/** Archive layer offset */
 				archiveLayerOffset?: number;
 				/** Gallery sorting */
-				sort?: ('name' | '-name' | 'created' | '-created');
+				sort?: ('name' | '-name' | 'created' | '-created' | 'random');
 				/** Gallery type */
 				type?: ('swipe' | 'swipe-full' | 'switch' | 'omni' | 'grid');
 				/** The gallery opening image ID */
@@ -2099,7 +2114,7 @@ declare module '@micrio/client' {
 			/** The album UX type */
 			type: ('swipe' | 'switch' | 'grid');
 			/** The album image sorting */
-			sort?: ('name' | '-name' | 'created' | '-created');
+			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 */
@@ -3039,6 +3054,7 @@ declare module '@micrio/client' {
 		gridInfoData: {
 			images: Models.ImageInfo.ImageInfo[];
 		} | undefined;
+		private sortArchiveImages;
 		/** Getter for the current language code. */
 		get lang(): string;
 		/** Setter for the current language code. Triggers language change logic. */