etudes 32.3.0 → 32.5.0

package/build/hooks/useImageLoader.d.ts

@@ -1,20 +1,4 @@
-/**
- * Type describing the parameters of {@link useImageLoader}.
- */
-export type UseImageLoaderParams = {
-    /**
-     * `src` attribute of the image.
-     */
-    src: string;
-    /**
-     * `srcSet` attribute of the image.
-     */
-    srcSet?: string;
-    /**
-     * `sizes` attribute of the image.
-     */
-    sizes?: string;
-};
+import { ImageSource } from '../types/ImageSource.js';
 /**
  * Type describing the options of {@link useImageLoader}.
  */
@@ -41,7 +25,13 @@ export type UseImageLoaderOptions = {
 /**
  * Hook for preloading an image.
  *
- * @param params See {@link UseImageLoaderParams}.
+ * @param source Either a string URL or a tuple of the form `[src,
+ *               ImageSource]`, where `src` is a fallback image URL and
+ *               `ImageSource` provides additional information for responsive
+ *               images. If a tuple is provided, the `src` will be used as the
+ *               `src` attribute of the `<img>` element, while the properties of
+ *               `ImageSource` will be used to set the `sizes` and `srcSet`
+ *               attributes.
  * @param options See {@link UseImageLoaderOptions}.
  */
-export declare function useImageLoader({ sizes, src, srcSet }: UseImageLoaderParams, { onError, onLoad, onLoadStart }?: UseImageLoaderOptions): void;
+export declare function useImageLoader(source: [string, Omit<ImageSource, 'media' | 'type'>] | string, { onError, onLoad, onLoadStart }?: UseImageLoaderOptions): void;

package/build/hooks/useImageSize.d.ts

@@ -1,9 +1,6 @@
 import { Size } from 'spase';
-import { UseImageLoaderOptions, UseImageLoaderParams } from './useImageLoader.js';
-/**
- * Type describing the parameters of {@link useImageSize}.
- */
-export type UseImageSizeParams = UseImageLoaderParams;
+import { ImageSource } from '../types/ImageSource.js';
+import { UseImageLoaderOptions } from './useImageLoader.js';
 /**
  * Type describing the options of {@link useImageSize}.
  */
@@ -17,10 +14,16 @@ export type UseImageSizeOptions = {
 /**
  * Hook for retrieving the size of an image.
  *
- * @param params See {@link UseImageSizeParams}.
+ * @param source Either a string URL or a tuple of the form `[src,
+ *               ImageSource]`, where `src` is a fallback image URL and
+ *               `ImageSource` provides additional information for responsive
+ *               images. If a tuple is provided, the `src` will be used as the
+ *               `src` attribute of the `<img>` element, while the properties of
+ *               `ImageSource` will be used to set the `sizes` and `srcSet`
+ *               attributes.
  * @param options See {@link UseImageSizeOptions}.
  *
  * @returns The actual size of the image if loading was successful, `undefined`
  *          otherwise.
  */
-export declare function useImageSize({ sizes, src, srcSet, }: UseImageSizeParams, { preservesSizeBetweenLoads, onError, onLoad, onLoadStart, }?: UseImageSizeOptions): Size.Size | undefined;
+export declare function useImageSize(source: [string, Omit<ImageSource, 'media' | 'type'>] | string, { preservesSizeBetweenLoads, onError, onLoad, onLoadStart, }?: UseImageSizeOptions): Size.Size | undefined;

package/build/hooks/useRightClick.d.ts

@@ -0,0 +1,24 @@
+import { RefObject } from 'react';
+type Target = HTMLElement | null | RefObject<HTMLElement> | RefObject<HTMLElement | null> | RefObject<HTMLElement | undefined> | undefined;
+type Options = {
+    isEnabled?: boolean;
+};
+/**
+ * Hook for overriding the browser-default right click context menu action on
+ * the window.
+ *
+ * @param action The function to invoke instead.
+ * @param options See {@link Options}.
+ */
+export declare function useRightClick(action: () => void, options?: Options): void;
+/**
+ * Hook for overriding the browser-default right click context menu action for
+ * an element.
+ *
+ * @param targetRef The target to override. If undefined, the window will be
+ *                  used.
+ * @param action The function to invoke instead.
+ * @param options See {@link Options}.
+ */
+export declare function useRightClick(targetRef: Target, action?: () => void, options?: Options): void;
+export {};

package/build/index.d.ts

@@ -32,6 +32,7 @@ export * from './hooks/useMouseLeave.js';
 export * from './hooks/useOS.js';
 export * from './hooks/usePrevious.js';
 export * from './hooks/useRect.js';
+export * from './hooks/useRightClick.js';
 export * from './hooks/useScrollPositionObserver.js';
 export * from './hooks/useSessionCache.js';
 export * from './hooks/useSize.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "etudes",
-  "version": "32.3.0",
+  "version": "32.5.0",
   "description": "A study of headless React components",
   "type": "module",
   "sideEffects": false,
@@ -47,29 +47,29 @@
     "@eslint/js": "^10.0.1",
     "@semantic-release/git": "^10.0.1",
     "@stylistic/eslint-plugin": "^5.10.0",
-    "@tailwindcss/vite": "^4.3.0",
+    "@tailwindcss/vite": "^4.3.1",
     "@testing-library/react": "^16.3.2",
     "@testing-library/user-event": "^14.6.1",
-    "@types/node": "^25.9.1",
-    "@types/react": "^19.2.16",
+    "@types/node": "^25.9.3",
+    "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react": "^6.0.2",
-    "@vitest/coverage-v8": "^4.1.8",
+    "@vitest/coverage-v8": "^4.1.9",
     "concurrently": "^10.0.3",
-    "eslint": "^10.4.1",
-    "eslint-plugin-perfectionist": "^5.9.0",
-    "happy-dom": "^20.9.0",
+    "eslint": "^10.5.0",
+    "eslint-plugin-perfectionist": "^5.9.1",
+    "happy-dom": "^20.10.5",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
     "rimraf": "^6.1.3",
-    "semantic-release": "^25.0.3",
-    "tailwindcss": "^4.3.0",
+    "semantic-release": "^25.0.5",
+    "tailwindcss": "^4.3.1",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.60.1",
+    "typescript-eslint": "^8.61.1",
     "vite": "^8.0.16",
     "vite-plugin-dts": "^5.0.2",
     "vite-plugin-svgr": "^5.2.0",
-    "vitest": "^4.1.8",
+    "vitest": "^4.1.9",
     "wait-on": "^9.0.10"
   },
   "dependencies": {