@almadar/ui 4.51.14 → 4.51.16

package/dist/components/molecules/DateRangePicker.d.ts

@@ -0,0 +1,56 @@
+/**
+ * DateRangePicker Molecule Component
+ *
+ * Two date inputs plus an optional preset row. Emits `{ from, to }` ISO
+ * strings on the event bus whenever the range changes. Falls back to a
+ * standard callback for direct consumers.
+ *
+ * Bus contract: caller passes `event` prop with a string key; the molecule
+ * emits `UI:{event}` with `{ from, to }` as the payload — mirrors the
+ * FilterGroup / MapView / DataGrid pattern.
+ */
+import React from 'react';
+import type { EventEmit } from '@almadar/core';
+export interface DateRangePickerPreset {
+    /** Display label (e.g. "Last 30 days"). */
+    label: string;
+    /** Stable key used for highlighting the active preset. */
+    value: string;
+    /** Returns `{ from, to }` as ISO date strings (YYYY-MM-DD). */
+    range: () => {
+        from: string;
+        to: string;
+    };
+}
+export interface DateRangePickerProps {
+    /** Controlled `from` (ISO date YYYY-MM-DD). */
+    from?: string;
+    /** Controlled `to` (ISO date YYYY-MM-DD). */
+    to?: string;
+    /**
+     * Event name emitted as `UI:{event}` with payload `{ from, to }`.
+     * Optional — when omitted, only the `onChange` callback fires.
+     */
+    event?: EventEmit<{
+        from: string;
+        to: string;
+    }>;
+    /** Callback fired alongside the bus emit. */
+    onChange?: (range: {
+        from: string;
+        to: string;
+    }) => void;
+    /**
+     * Preset shortcuts. Defaults to the standard finance set
+     * (Last 7d / Last 30d / This Month / This Quarter / YTD).
+     * Pass an empty array to hide presets entirely.
+     */
+    presets?: DateRangePickerPreset[];
+    /** From-input label. */
+    fromLabel?: string;
+    /** To-input label. */
+    toLabel?: string;
+    /** Additional CSS classes. */
+    className?: string;
+}
+export declare const DateRangePicker: React.FC<DateRangePickerProps>;

package/dist/components/molecules/FilterGroup.d.ts

@@ -16,10 +16,10 @@ import React from "react";
 export interface FilterDefinition {
     field: string;
     label: string;
-    /** Filter type - 'date' renders a date picker, 'date-range'/'daterange' renders two date pickers */
-    filterType?: "select" | "toggle" | "checkbox" | "date" | "daterange" | "date-range";
+    /** Filter type - 'text' free-text input, 'date' renders a date picker, 'date-range'/'daterange' renders two date pickers */
+    filterType?: "text" | "select" | "toggle" | "checkbox" | "date" | "daterange" | "date-range";
     /** Alias for filterType (schema compatibility) */
-    type?: "select" | "toggle" | "checkbox" | "date" | "daterange" | "date-range";
+    type?: "text" | "select" | "toggle" | "checkbox" | "date" | "daterange" | "date-range";
     /** Options for select/toggle filters */
     options?: readonly string[];
 }

package/dist/components/molecules/StatDisplay.d.ts

@@ -15,8 +15,16 @@ export interface StatDisplayProps {
     max?: number;
     /** Optional progress target. >0 renders a progress bar at value/target. */
     target?: number;
-    /** Signed delta vs previous period. >0 renders ↑ green, <0 renders ↓ red, 0 hides. */
+    /** Signed delta vs previous period. >0 renders ↑ green, <0 renders ↓ red, 0 hides. Polarity reversal via `trendPolarity`. */
     trend?: number;
+    /** Controls whether `trend > 0` is "good" (default) or "bad". `lower-is-better` inverts the color logic. */
+    trendPolarity?: 'higher-is-better' | 'lower-is-better';
+    /** When `'percent'`, renders trend with a `%` suffix (e.g. `↓ 3.3%`); default is `'absolute'`. */
+    trendFormat?: 'absolute' | 'percent';
+    /** Optional inline sparkline data appended to the trend row. Length < 2 renders nothing. */
+    sparklineData?: readonly number[];
+    /** Event name emitted as `UI:{clickEvent}` with `{ metricLabel }` when the card is clicked. */
+    clickEvent?: string;
     /** Prefix prepended to the formatted value (e.g. "≈ "). */
     prefix?: string;
     /** Suffix appended to the formatted value (e.g. " /mo", " ms"). */

package/dist/components/molecules/index.d.ts

@@ -39,6 +39,7 @@ export { RepeatableFormSection, type RepeatableFormSectionProps, type Repeatable
 export { ViolationAlert, type ViolationAlertProps, type ViolationRecord } from './ViolationAlert';
 export { FormSectionHeader, type FormSectionHeaderProps } from './FormSectionHeader';
 export { FlipCard, type FlipCardProps } from './FlipCard';
+export { DateRangePicker, type DateRangePickerProps, type DateRangePickerPreset } from './DateRangePicker';
 export { DateRangeSelector, type DateRangeSelectorProps, type DateRangeSelectorOption } from './DateRangeSelector';
 export { ChartLegend, type ChartLegendProps, type ChartLegendItem } from './ChartLegend';
 export { LineChart, type LineChartProps, type ChartDataPoint } from './LineChart';

package/dist/components/organisms/Chart.d.ts

@@ -1,26 +1,39 @@
 /**
  * Chart Organism Component
  *
- * A data visualization component supporting bar, line, pie, and area chart types.
- * Composes atoms and molecules for layout, uses CSS variables for theming.
+ * Data visualization. Supports bar / line / pie / area / donut / scatter /
+ * histogram chart types. Renders multi-series natively for bar / line / area
+ * via the `series` prop. Pie / donut consume the first series only. Scatter
+ * plots raw {x,y} points; histogram renders pre-binned data as gap-less bars.
  *
- * Orbital Component Interface Compliance:
- * - Entity binding with auto-fetch when entity is a string
- * - Event emission via useEventBus (UI:* events)
- * - isLoading and error state props
- * - className for external styling
+ * Bus integration:
+ *  - top-level `actions[].event` → `UI:{event}` on click (existing behavior)
+ *  - per-data-point `drillEvent` → `UI:{drillEvent}` with `{ label, value, seriesLabel? }`
+ *
+ * Time axis: when `timeAxis: true`, ISO date labels are formatted via Intl
+ * (e.g. "Mar 2026"). Positioning remains evenly spaced (real time-scale
+ * alignment is deliberately deferred).
  */
 import React from "react";
-export type ChartType = "bar" | "line" | "pie" | "area" | "donut";
+export type ChartType = "bar" | "line" | "pie" | "area" | "donut" | "scatter" | "histogram";
+export type ChartStackMode = "none" | "stack" | "normalize";
 export interface ChartDataPoint {
     label: string;
     value: number;
     color?: string;
 }
+export interface ChartScatterPoint {
+    x: number;
+    y: number;
+    label?: string;
+    size?: number;
+    color?: string;
+}
 export interface ChartSeries {
     name: string;
     data: readonly ChartDataPoint[];
     color?: string;
+    dashed?: boolean;
 }
 export interface ChartAction {
     label: string;
@@ -35,18 +48,25 @@ export interface ChartProps {
     subtitle?: string;
     /** Chart type */
     chartType?: ChartType;
-    /** Data series */
+    /** Multi-series data */
     series?: readonly ChartSeries[];
-    /** Simple data (single series shorthand) */
-    /** Simple data (single series shorthand) */
+    /** Simple single-series shorthand (bar/line/pie/area/donut/histogram) */
     data?: readonly ChartDataPoint[];
+    /** Raw {x,y} points for scatter */
+    scatterData?: readonly ChartScatterPoint[];
     /** Chart height in px */
     height?: number;
     /** Show legend */
     showLegend?: boolean;
     /** Show values on chart */
     showValues?: boolean;
-    /** Actions for chart interactions */
+    /** Stack mode for bar / area */
+    stack?: ChartStackMode;
+    /** Format X-axis labels as time (ISO date in → "Mar 2026"-style label out) */
+    timeAxis?: boolean;
+    /** Event name emitted as `UI:{drillEvent}` with `{ label, value, seriesLabel? }` on data-point click */
+    drillEvent?: string;
+    /** Top-level chart actions (export, refresh, etc.) */
     actions?: readonly ChartAction[];
     /** Entity name for schema-driven auto-fetch */
     entity?: string;