randmarcomps 1.329.0 → 1.331.0

package/dist/randmarcomps.d.ts

@@ -396,6 +396,67 @@ export declare function ExploreManufacturers({ appID, manufPath, withBot }: {
     withBot: boolean;
 }): JSX.Element;
 
+/**
+ * A card component to display an external product with a responsive layout.
+ * It shows a compact view with badges on mobile and a detailed grid on desktop.
+ * Includes a skeleton loader state for asynchronous data fetching.
+ */
+export declare function ExternalProductCard({ product, viewProductLink }: ExternalProductCardProps): JSX.Element;
+
+declare interface ExternalProductCardProps {
+    product?: Product;
+    viewProductLink?: string;
+}
+
+/**
+ * Formats a number as Canadian dollars (CAD) for an English (Canada) locale.
+ *
+ * @param amount The numerical value of the money.
+ * @returns A string representing the formatted currency value (e.g., "$1,234.56").
+ *
+ * @example
+ * formatMoney(4321.99); // "$4,231.99"
+ * formatMoney(500);     // "$500.00"
+ * formatMoney(0.75);    // "$0.75"
+ */
+export declare const formatMoney: (amount: number, options?: Intl.NumberFormatOptions) => string;
+
+/**
+ * Formats a number according to English (Canada) conventions.
+ * Uses a period for the decimal and a space for the thousands separator.
+ *
+ * @param value The number to format.
+ * @returns A string representing the formatted number.
+ *
+ * @example
+ * formatNumber(1234567.89); // "1 234 567.89"
+ * formatNumber(1234);      // "1234"
+ * formatNumber(123.45);    // "123.45"
+ */
+export declare const formatNumber: (value: number, options?: Intl.NumberFormatOptions) => string;
+
+/**
+ * Formats a date represented as an integer in YYYYMMDD format into a 'YYYY-MM-DD' string.
+ * This utility is designed to handle numeric date representations commonly found in backend or legacy systems.
+ * It gracefully handles null or undefined inputs and includes a fallback for unexpected formats.
+ *
+ * @param {number | null | undefined} dateInt - The date to format, represented as a YYYYMMDD integer (e.g., 20250619).
+ * @returns {string} The formatted date string 'YYYY-MM-DD', an em dash '—' for null/undefined inputs, or the original number as a string if it's not 8 digits long.
+ *
+ * @example
+ * // returns "2025-06-19"
+ * formatYYYYMMDDIntToDateString(20250619);
+ *
+ * @example
+ * // returns "—"
+ * formatYYYYMMDDIntToDateString(null);
+ *
+ * @example
+ * // returns "202301" (as a fallback)
+ * formatYYYYMMDDIntToDateString(202301);
+ */
+export declare const formatYYYYMMDDIntToDateString: (dateInt?: number | null) => string;
+
 export declare const GeminiApiKeyProvider: ({ apiKey, children, }: {
     apiKey?: string | null;
     children: ReactNode;