@bpfdev/oly-ui 1.0.13 → 1.0.14

package/dist/index.d.mts

@@ -445,6 +445,11 @@ type QueueTimeBreakdownCustomization = {
         elevation?: number;
         /** Merged into the outer shell `CardContent` (padding, gaps). */
         cardContentSx?: SxProps$1<Theme$1>;
+        /**
+         * Merged onto the inner content `Stack` (wraps the columns). Defaults to `{ mb: 4 }` — override
+         * (e.g. `{ mb: 0 }`) to remove the bottom margin below the columns.
+         */
+        contentStackSx?: SxProps$1<Theme$1>;
     };
     periodFilter?: TimePeriodFilterTheme;
     header?: {
@@ -498,6 +503,13 @@ type QueueTimeBreakdownCustomization = {
         chartHeightPx?: number;
     };
     areaChart?: {
+        /**
+         * Opt-in: fill the available card height instead of the fixed `stackHeightPx`/`chartHeightPx`.
+         * Use when the card stretches to match a taller sibling column so the chart grows to fill it
+         * (no empty space above/below). Requires the parent `CardContent` to be a flex column.
+         * @default false (keeps the fixed-height behaviour — existing consumers are unaffected)
+         */
+        fillHeight?: boolean;
         stackHeightPx?: number;
         chartHeightPx?: number;
         margin?: {
@@ -540,6 +552,11 @@ type QueueTimeBreakdownDonutProps = {
     chartFilter: QueueTimeChartFilter;
     averageData: number[];
     LabelName: string;
+    /**
+     * Slice labels aligned by index with `averageData`. Supports any number of buckets — the donut
+     * renders one slice per value; values without a matching label fall back to `Bucket N`.
+     * Defaults to {@link DEFAULT_LABELS} (four queue-time buckets) when omitted.
+     */
     labels?: readonly string[];
     renderTooltip?: (context: QueueTimeBreakdownDonutTooltipRenderContext) => ReactNode;
 };
@@ -605,6 +622,21 @@ type QueueTimeBreakdownProps = {
     Donut_data: number[];
     /** Optional second donut; defaults to Donut_data for both sides. */
     donutYesterdayData?: number[];
+    /**
+     * Labels for the donut slices, aligned by index with `Donut_data` / `donutYesterdayData`.
+     * Required when the donut has more (or fewer) than the legacy four buckets — otherwise extra
+     * slices are dropped. Defaults to the donut's built-in labels when omitted.
+     */
+    donutLabels?: string[];
+    /**
+     * Real area-chart series (e.g. queue-time trend by bucket). Passing this (**even an empty array**)
+     * switches the area chart into real-data mode: it renders your series, or an empty state when there
+     * is no data — it never falls back to the built-in sample trend. Leave `undefined` to keep the
+     * sample data (demos). Pair with `areaXAxis` for matching category labels.
+     */
+    areaSeries?: QueueTimeAreaSeriesPoint[];
+    /** X-axis category labels for `areaSeries`. In real-data mode an empty/missing axis renders the empty state. */
+    areaXAxis?: string[];
     total_visitor_today?: number;
     overall_visitor_per_hour?: number;
     overall_visitor_per_min?: number;
@@ -2606,6 +2638,15 @@ type BillingCounterAnalyticsCustomization = {
         gridStrokeDasharray?: string;
         margin?: BillingCounterChartMargin;
         xAxisTickFill?: string;
+        /**
+         * Rotation angle (degrees) for X-axis tick labels.
+         * `0` = horizontal (default), negative values slant labels (e.g. `-35`).
+         */
+        xAxisTickAngle?: number;
+        /** Inline SVG style for X-axis tick text (typography/spacing). */
+        xAxisTickStyle?: Record<string, string | number>;
+        /** Reserved vertical space for the X-axis (Recharts `XAxis.height`). Default: `40`. */
+        xAxisHeight?: number;
         yAxisTickFill?: string;
         yAxisWidth?: number;
         tooltip?: BillingCounterAnalyticsTooltipTheme;
@@ -2708,7 +2749,7 @@ declare function generateMockPerformanceData(): QueueTimeBreakdownBarRow[];
 /**
  * Queue time breakdown dashboard widget: stacked bars, queue buckets, donut comparison, area chart (Recharts).
  */
-declare function QueueTimeBreakdown({ data, Donut_data, donutYesterdayData, headerImageSrc, headlineTotal, headlineSubtitle, dataComparisonTitle, queueBucketLegend, title, infoPopover, headlineInfoPopover, renderAreaTooltip, renderDonutTooltip, renderStackedBarTooltip, customization, }: QueueTimeBreakdownProps): React$1.ReactElement;
+declare function QueueTimeBreakdown({ data, Donut_data, donutYesterdayData, donutLabels, areaSeries, areaXAxis, headerImageSrc, headlineTotal, headlineSubtitle, dataComparisonTitle, queueBucketLegend, title, infoPopover, headlineInfoPopover, renderAreaTooltip, renderDonutTooltip, renderStackedBarTooltip, customization, }: QueueTimeBreakdownProps): React$1.ReactElement;
 
 /** Default ordered palette for the 4 stacked buckets (light → dark). */
 declare const STACKED_COMPARISON_DEFAULT_STACK_COLORS: readonly ["#CFE0FB", "#7FB1F0", "#3D7CDF", "#1E2A5E"];
@@ -3310,6 +3351,14 @@ type FootFallHeatMapKpiStripPresentation = {
     trackInsetPx?: number;
     /** Track background behind segments. */
     trackBackgroundColor?: string;
+    /**
+     * When **true**, child rows whose `overallData.count` is `0` are still included in the
+     * ranked bar list (rendered with a 0-width fill so only **`trackBackgroundColor`** shows).
+     * Default **false** keeps the historical "hide rows with no visitors" behavior — consumers
+     * who want zero-visitor child tiles to remain visible (e.g. lifestyle store-performance
+     * heat-maps) opt in by setting this to `true`.
+     */
+    includeZeroValueRows?: boolean;
     /** Merged onto the outer KPI panel (container under the breadcrumb). Applied after built-in layout styles. */
     kpiContainerSx?: SxProps$1<Theme$1>;
     /** Merged onto the summary KPI cards row `Stack` (direction, spacing, wrap). */

package/dist/index.d.ts

@@ -445,6 +445,11 @@ type QueueTimeBreakdownCustomization = {
         elevation?: number;
         /** Merged into the outer shell `CardContent` (padding, gaps). */
         cardContentSx?: SxProps$1<Theme$1>;
+        /**
+         * Merged onto the inner content `Stack` (wraps the columns). Defaults to `{ mb: 4 }` — override
+         * (e.g. `{ mb: 0 }`) to remove the bottom margin below the columns.
+         */
+        contentStackSx?: SxProps$1<Theme$1>;
     };
     periodFilter?: TimePeriodFilterTheme;
     header?: {
@@ -498,6 +503,13 @@ type QueueTimeBreakdownCustomization = {
         chartHeightPx?: number;
     };
     areaChart?: {
+        /**
+         * Opt-in: fill the available card height instead of the fixed `stackHeightPx`/`chartHeightPx`.
+         * Use when the card stretches to match a taller sibling column so the chart grows to fill it
+         * (no empty space above/below). Requires the parent `CardContent` to be a flex column.
+         * @default false (keeps the fixed-height behaviour — existing consumers are unaffected)
+         */
+        fillHeight?: boolean;
         stackHeightPx?: number;
         chartHeightPx?: number;
         margin?: {
@@ -540,6 +552,11 @@ type QueueTimeBreakdownDonutProps = {
     chartFilter: QueueTimeChartFilter;
     averageData: number[];
     LabelName: string;
+    /**
+     * Slice labels aligned by index with `averageData`. Supports any number of buckets — the donut
+     * renders one slice per value; values without a matching label fall back to `Bucket N`.
+     * Defaults to {@link DEFAULT_LABELS} (four queue-time buckets) when omitted.
+     */
     labels?: readonly string[];
     renderTooltip?: (context: QueueTimeBreakdownDonutTooltipRenderContext) => ReactNode;
 };
@@ -605,6 +622,21 @@ type QueueTimeBreakdownProps = {
     Donut_data: number[];
     /** Optional second donut; defaults to Donut_data for both sides. */
     donutYesterdayData?: number[];
+    /**
+     * Labels for the donut slices, aligned by index with `Donut_data` / `donutYesterdayData`.
+     * Required when the donut has more (or fewer) than the legacy four buckets — otherwise extra
+     * slices are dropped. Defaults to the donut's built-in labels when omitted.
+     */
+    donutLabels?: string[];
+    /**
+     * Real area-chart series (e.g. queue-time trend by bucket). Passing this (**even an empty array**)
+     * switches the area chart into real-data mode: it renders your series, or an empty state when there
+     * is no data — it never falls back to the built-in sample trend. Leave `undefined` to keep the
+     * sample data (demos). Pair with `areaXAxis` for matching category labels.
+     */
+    areaSeries?: QueueTimeAreaSeriesPoint[];
+    /** X-axis category labels for `areaSeries`. In real-data mode an empty/missing axis renders the empty state. */
+    areaXAxis?: string[];
     total_visitor_today?: number;
     overall_visitor_per_hour?: number;
     overall_visitor_per_min?: number;
@@ -2606,6 +2638,15 @@ type BillingCounterAnalyticsCustomization = {
         gridStrokeDasharray?: string;
         margin?: BillingCounterChartMargin;
         xAxisTickFill?: string;
+        /**
+         * Rotation angle (degrees) for X-axis tick labels.
+         * `0` = horizontal (default), negative values slant labels (e.g. `-35`).
+         */
+        xAxisTickAngle?: number;
+        /** Inline SVG style for X-axis tick text (typography/spacing). */
+        xAxisTickStyle?: Record<string, string | number>;
+        /** Reserved vertical space for the X-axis (Recharts `XAxis.height`). Default: `40`. */
+        xAxisHeight?: number;
         yAxisTickFill?: string;
         yAxisWidth?: number;
         tooltip?: BillingCounterAnalyticsTooltipTheme;
@@ -2708,7 +2749,7 @@ declare function generateMockPerformanceData(): QueueTimeBreakdownBarRow[];
 /**
  * Queue time breakdown dashboard widget: stacked bars, queue buckets, donut comparison, area chart (Recharts).
  */
-declare function QueueTimeBreakdown({ data, Donut_data, donutYesterdayData, headerImageSrc, headlineTotal, headlineSubtitle, dataComparisonTitle, queueBucketLegend, title, infoPopover, headlineInfoPopover, renderAreaTooltip, renderDonutTooltip, renderStackedBarTooltip, customization, }: QueueTimeBreakdownProps): React$1.ReactElement;
+declare function QueueTimeBreakdown({ data, Donut_data, donutYesterdayData, donutLabels, areaSeries, areaXAxis, headerImageSrc, headlineTotal, headlineSubtitle, dataComparisonTitle, queueBucketLegend, title, infoPopover, headlineInfoPopover, renderAreaTooltip, renderDonutTooltip, renderStackedBarTooltip, customization, }: QueueTimeBreakdownProps): React$1.ReactElement;
 
 /** Default ordered palette for the 4 stacked buckets (light → dark). */
 declare const STACKED_COMPARISON_DEFAULT_STACK_COLORS: readonly ["#CFE0FB", "#7FB1F0", "#3D7CDF", "#1E2A5E"];
@@ -3310,6 +3351,14 @@ type FootFallHeatMapKpiStripPresentation = {
     trackInsetPx?: number;
     /** Track background behind segments. */
     trackBackgroundColor?: string;
+    /**
+     * When **true**, child rows whose `overallData.count` is `0` are still included in the
+     * ranked bar list (rendered with a 0-width fill so only **`trackBackgroundColor`** shows).
+     * Default **false** keeps the historical "hide rows with no visitors" behavior — consumers
+     * who want zero-visitor child tiles to remain visible (e.g. lifestyle store-performance
+     * heat-maps) opt in by setting this to `true`.
+     */
+    includeZeroValueRows?: boolean;
     /** Merged onto the outer KPI panel (container under the breadcrumb). Applied after built-in layout styles. */
     kpiContainerSx?: SxProps$1<Theme$1>;
     /** Merged onto the summary KPI cards row `Stack` (direction, spacing, wrap). */