import { IkasOrderLineItem, IkasOrderLineItemOptionValue } from "../../../../../../storefront-models/src";
/**
 * Extracts the file name from an order line item option value's URL path.
 *
 * @ai-category LineItemOption, OrderLineItem
 * @ai-related downloadFile
 *
 * @param value - The order line item option value containing a file URL in its value property.
 * @returns The decoded file name extracted from the URL, or an empty string if decoding fails.
 *
 * @example
 * ```typescript
 * import { getOrderLineOptionFileName } from "@ikas/bp-storefront";
 * const fileName = getOrderLineOptionFileName(optionValue);
 * console.log(fileName); // "uploaded-image.png"
 * ```
 */
export declare function getOrderLineOptionFileName(value: IkasOrderLineItemOptionValue): string;
/**
 * Downloads a file associated with an order line item option value by fetching a temporary download URL and triggering a browser download.
 *
 * @ai-category LineItemOption, OrderLineItem
 * @ai-related getOrderLineOptionFileName
 *
 * @param value - The order line item option value containing the file URL to download.
 * @returns The download URL string if successful, or undefined if the download fails.
 *
 * @example
 * ```typescript
 * import { downloadFile } from "@ikas/bp-storefront";
 * const url = await downloadFile(optionValue);
 * if (url) {
 *   console.log("File downloaded successfully");
 * }
 * ```
 */
export declare function downloadFile(value: IkasOrderLineItemOptionValue): Promise<string | undefined>;
/**
 * Returns the formatted currency string for an order line item option value's price, handling both ratio-based and flat pricing.
 *
 * @ai-category LineItemOption, OrderLineItem, Pricing
 * @ai-related getOrderLineOptionFileName, downloadFile
 *
 * @param item - The order line item used to calculate ratio-based prices.
 * @param value - The order line item option value whose price to format.
 * @returns A locale-formatted currency string representing the option value price (e.g. "$5.00").
 *
 * @example
 * ```typescript
 * import { getOrderLineItemOptionValueFormattedPrice } from "@ikas/bp-storefront";
 * const formattedPrice = getOrderLineItemOptionValueFormattedPrice(lineItem, optionValue);
 * // "$5.00"
 * ```
 */
export declare function getOrderLineItemOptionValueFormattedPrice(item: IkasOrderLineItem, value: IkasOrderLineItemOptionValue): string;