import { IkasImage } from "../../../storefront-models/src";
/**
 * Returns the default source URL for an image OR video at 1080px resolution.
 *
 * Product media items (IkasProductImage) can be videos. ALWAYS check `item.isVideo`
 * and render a `<video src={getDefaultSrc(item)}>` instead of an `<img>` when it is true.
 * Never assume every media item is an image.
 *
 * @ai-category Image
 * @ai-related getThumbnailSrc, getSrc, createMediaSrcset
 *
 * @param image - The image object to generate the default source URL for.
 * @returns The CDN URL string for the image or video at 1080px size.
 *
 * @example
 * ```typescript
 * import { getDefaultSrc, createMediaSrcset } from "@ikas/bp-storefront";
 *
 * // Product images can be videos — ALWAYS branch on isVideo when mapping media:
 * {product.images.map((item, i) =>
 *   item.isVideo ? (
 *     <video key={i} src={getDefaultSrc(item)} muted playsInline preload="metadata">
 *       <track kind="captions" />
 *     </video>
 *   ) : (
 *     <img key={i} src={getDefaultSrc(item)} srcSet={createMediaSrcset(item)} alt={`Product ${i + 1}`} />
 *   )
 * )}
 * ```
 */
export declare function getDefaultSrc(image: IkasImage): string;
/**
 * Returns the thumbnail source URL for an IMAGE at 180px resolution.
 *
 * VIDEOS HAVE NO 180px THUMBNAIL and no poster URL. When `image.isVideo === true` the size is
 * IGNORED and this returns the same full-size .mp4 as `getDefaultSrc(image)` — so using it in a
 * thumbnail-sized box (swatch, cart line, order line) downloads the whole video instead of a
 * 180px webp. Nothing looks broken, which makes it a silent performance regression.
 *
 * Branch on `item.isVideo` first and only pass images here. For the video branch in a small,
 * static context render `<video src={getDefaultSrc(item)} preload="metadata" muted playsInline>`
 * with no `autoPlay`: the browser fetches only the first frame and holds it as a stand-in poster.
 *
 * @ai-category Image
 * @ai-related getDefaultSrc, getSrc, createMediaSrcset
 *
 * @param image - The image object to generate the thumbnail source URL for. Videos ignore the size.
 * @returns The CDN URL string: a 180px image, or — for `isVideo` items — the original .mp4.
 *
 * @example
 * ```typescript
 * import { getThumbnailSrc, getDefaultSrc } from "@ikas/bp-storefront";
 *
 * // Thumbnail rail — branch on isVideo per item (no autoPlay: first frame acts as the poster):
 * {product.images.map((item, i) =>
 *   item.isVideo ? (
 *     <video key={i} src={getDefaultSrc(item)} muted playsInline preload="metadata">
 *       <track kind="captions" />
 *     </video>
 *   ) : (
 *     <img key={i} src={getThumbnailSrc(item)} sizes="112px" alt={`Thumb ${i + 1}`} />
 *   )
 * )}
 * ```
 */
export declare function getThumbnailSrc(image: IkasImage): string;
/**
 * Generates the full CDN source URL for an image or video at the specified size, handling both legacy path-based and merchant-scoped ID formats.
 *
 * NOTE: For videos (`image.isVideo === true`) the `size` argument is IGNORED — the original .mp4 is always returned.
 * So `getSrc(item, 240)` and `getDefaultSrc(item)` produce the identical URL for a video. PREFER `getDefaultSrc(item)`
 * for video `src` (no size param) — do NOT pass an arbitrary size like `getSrc(item, 240)`, it is misleading.
 *
 * @ai-category Image
 * @ai-related getDefaultSrc, getThumbnailSrc, createMediaSrcset
 *
 * @param image - The image object containing the id, fileName, and isVideo flag.
 * @param size - The desired image width in pixels. Ignored for videos.
 * @returns The full CDN URL string for the image or video.
 *
 * @example
 * ```typescript
 * import { getSrc, getDefaultSrc } from "@ikas/bp-storefront";
 *
 * const src = getSrc(image, 640);
 * console.log(src); // "https://cdn.example.com/images/.../640/image.webp"
 *
 * // For a video, use getDefaultSrc (size is ignored anyway):
 * <video src={getDefaultSrc(item)} muted playsInline preload="metadata" />
 * ```
 */
export declare function getSrc(image: IkasImage, size: number): string;
/**
 * Generates a complete responsive `srcset` string for an image across all standard sizes (180–3840px).
 *
 * srcset applies to `<img>` only — video media (`item.isVideo === true`) has no srcset
 * and must be rendered with `<video src={getDefaultSrc(item)}>`. When mapping product
 * images, branch on `item.isVideo` first, then only use createMediaSrcset on the image branch.
 *
 * @ai-category Image
 * @ai-related getDefaultSrc, getThumbnailSrc, getSrc
 *
 * @param image - The image object to generate the srcset for, or null/undefined.
 * @returns A srcset string like `"url 180w, url 360w, ..."`, or an empty string if no image is provided.
 *
 * @example
 * ```typescript
 * import { createMediaSrcset, getDefaultSrc } from "@ikas/bp-storefront";
 *
 * // Product images can be videos — ALWAYS branch on isVideo when mapping media:
 * {product.images.map((item, i) =>
 *   item.isVideo ? (
 *     <video key={i} src={getDefaultSrc(item)} muted playsInline preload="metadata">
 *       <track kind="captions" />
 *     </video>
 *   ) : (
 *     <img
 *       key={i}
 *       src={getDefaultSrc(item)}
 *       srcSet={createMediaSrcset(item)}
 *       sizes="(max-width: 768px) 100vw, 50vw"
 *       alt={`Product ${i + 1}`}
 *     />
 *   )
 * )}
 * ```
 */
export declare function createMediaSrcset(image?: IkasImage | null): string;