gantri-components 2.241.0 → 2.242.0

package/dist/components/picture/picture.types.d.ts

@@ -1,16 +1,30 @@
 import { Property } from 'csstype';
-import { CSSProperties, ReactEventHandler } from 'react';
+import { AriaAttributes, CSSProperties, ImgHTMLAttributes, ReactEventHandler } from 'react';
 import { IGravity } from '@cloudinary/url-gen/qualifiers/gravity/GravityQualifier';
 import { ImageFormatType, VideoFormatType } from '@cloudinary/transformation-builder-sdk/types/types';
 import { ResolutionAwareProp } from '../../types/resolution-aware-prop.type';
 import { Color } from '../../styles';
+/**
+ * HTML/ARIA attributes the underlying `<img>` accepts as pass-throughs.
+ * These are forwarded as-is so callers can opt into native behaviour
+ * (e.g. `draggable={false}` inside a Carousel cell, `crossOrigin="anonymous"`
+ * for canvas extraction, `tabIndex` for focus management) without having to
+ * eject from `<Picture>`.
+ *
+ * Anything not in this Pick is intentionally NOT exposed to keep the API
+ * narrow — `width`, `height`, `sizes`, `srcSet`, `loading`, `fetchPriority`,
+ * `onLoad`, `onError`, `onClick` are owned by the component itself.
+ */
+export type PicturePassThroughProps = Pick<ImgHTMLAttributes<HTMLImageElement>, 'crossOrigin' | 'draggable' | 'id' | 'referrerPolicy' | 'role' | 'tabIndex' | 'title'> & AriaAttributes & {
+    [dataAttr: `data-${string}`]: string | number | boolean | undefined;
+};
 export type PictureCrop = 'scale' | 'limitFit' | 'limitFill' | 'limitPad' | 'fill' | 'fit' | 'crop' | 'pad' | 'imaggaCrop' | 'imaggaScale' | 'minimumFit' | 'minimumPad' | 'fillPad' | 'thumbnail';
 export type PictureQuality = 'auto' | 'autoBest' | 'autoEco' | 'autoGood' | 'autoLow' | 'jpegmini' | 'jpegminiBest' | 'jpegminiHigh' | 'jpegminiMedium';
 export type PictureFormat = ImageFormatType | VideoFormatType;
 export type PictureEffect = 'grayscale' | 'sepia' | 'blackwhite' | 'negate' | 'oil_paint' | 'cartoonify' | 'vignette' | 'pixelate' | string;
 export type PicturePlaceholder = 'blur' | 'color' | 'none';
 export type PictureAs = 'image' | 'video-frame';
-export interface PictureProps {
+export interface PictureProps extends PicturePassThroughProps {
     src: ResolutionAwareProp<string>;
     alt: string;
     /** Override auto-detection of how to render the asset. */