@nuskin/react-mysite-elements 1.5.0 → 1.6.0-ui-fixes.1

package/dist/common/shopping-dashboard/utils/dateFormat.d.ts

@@ -0,0 +1,23 @@
+import type { DateRangeOption } from '../types.d';
+export declare function formatDateRangeLabel(dateRange: DateRangeOption): string;
+export declare function formatShortDate(date: Date): string;
+export declare function formatAxisDate(dateStr: string): string;
+export declare function formatDisplayDate(dateStr: string): string;
+export declare function formatDateRange(start: string, end: string): string;
+export declare function formatISODate(date: Date): string;
+/**
+ * Extract and format the date range from an array of data objects.
+ * Handles various date field names: 'date', 'Date', 'dateTime', etc.
+ * Falls back to calculating from dateRange option if no date data is available.
+ * @param data Array of objects with date information
+ * @param fallbackLabel Fallback label if no dates found
+ * @returns Formatted date range string (e.g., "May 30 - Aug 27")
+ */
+export declare function getActualDateRange(data: unknown[], fallbackLabel?: string): string;
+/**
+ * Calculate and format the date range based on a DateRangeOption.
+ * Used for components without time-series data (e.g., TopProducts, TopCategories)
+ * @param dateRangeOption The selected date range option
+ * @returns Formatted date range string (e.g., "Aug 28 - Sep 27" for last30days)
+ */
+export declare function calculateDateRangeFromOption(dateRangeOption: DateRangeOption): string;

package/dist/common/shopping-dashboard/utils/excelExport.d.ts

@@ -0,0 +1,14 @@
+export type ExcelCellValue = string | number | boolean | Date | null | undefined;
+export interface ExcelExportColumn<TItem> {
+    readonly header: string;
+    readonly value: (item: TItem) => ExcelCellValue;
+}
+export interface ExcelExportOptions<TItem> {
+    readonly rows: readonly TItem[];
+    readonly columns: readonly ExcelExportColumn<TItem>[];
+    readonly fileName: string;
+    readonly sheetName: string;
+}
+export declare function normalizeExcelFileName(fileName: string): string;
+export declare function normalizeExcelSheetName(sheetName: string): string;
+export declare function exportRowsToExcel<TItem>({ rows, columns, fileName, sheetName, }: ExcelExportOptions<TItem>): Promise<void>;

package/dist/common/shopping-dashboard/utils/marketOptions.d.ts

@@ -0,0 +1,4 @@
+import type { MarketFilterOption } from '../types.d';
+export declare function buildDefaultMarketOptions(): MarketFilterOption[];
+export declare function resolveMarketOptions(markets: ReadonlyArray<MarketFilterOption> | undefined): ReadonlyArray<MarketFilterOption>;
+export declare function useMarketOptions(markets: ReadonlyArray<MarketFilterOption> | undefined): ReadonlyArray<MarketFilterOption>;

package/dist/common/shopping-dashboard/utils/productOfferExport.d.ts

@@ -0,0 +1,4 @@
+import type { OrderHistory, TopPerformingOffer, TopProduct } from '../types.d';
+export declare function exportTopProducts(rows: readonly TopProduct[]): Promise<void>;
+export declare function exportTopPerformingOffers(offers: readonly TopPerformingOffer[]): Promise<void>;
+export declare function exportConversionRate(orders: readonly OrderHistory[]): Promise<void>;

package/dist/common/shopping-dashboard/utils/trendUtils.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import type { TrendDirection } from '../shared/types';
+export declare function parseTrendPercent(value?: string): number | null;
+export declare function resolveTrendDirection(value?: string): TrendDirection;
+export declare function calculateWeightedRevenueTrend<T>(items: readonly T[], getRevenue: (item: T) => number, getTrend: (item: T) => string | undefined): {
+    direction: TrendDirection;
+    formatted: string;
+};
+export declare function getTrendDirectionLabel(direction: TrendDirection): string;
+export declare function getTrendIcon(direction: TrendDirection): React.ReactNode;
+export declare function getTrendColor(direction: TrendDirection): string;
+export interface PieChartLabelProps {
+    cx: number;
+    cy: number;
+    midAngle: number;
+    innerRadius: number;
+    outerRadius: number;
+    percentage: number;
+}
+export declare function renderPieChartLabel(props: PieChartLabelProps, options?: {
+    fontSize?: string;
+    fontWeight?: string;
+}): React.ReactNode;