myio-js-library 0.1.161 → 0.1.163

package/dist/index.d.cts

@@ -34,6 +34,12 @@ declare function fmtPerc$1(value: number): string;
  */
 declare function formatNumberReadable(value: unknown, locale?: string, minimumFractionDigits?: number, maximumFractionDigits?: number): string;
 
+/**
+ * Simple water value formatting (same as MAIN controller)
+ * @param value - The water volume value in cubic meters
+ * @returns Formatted water volume string with m³ unit
+ */
+declare function formatWater(value: number): string;
 /**
  * Formats water volume in cubic meters (M³) using Brazilian locale formatting
  * @param value - The water volume value in cubic meters
@@ -75,6 +81,29 @@ declare function formatAllInSameWaterUnit(values: number[]): {
     unit: string;
 };
 
+/**
+ * Time and duration formatting utilities
+ * Extracted from MAIN controller for reuse across widgets
+ */
+/**
+ * Converts a timestamp to a relative time string (e.g., "há 5 minutos").
+ * @param timestamp - The timestamp in milliseconds.
+ * @returns The formatted relative time string.
+ */
+declare function formatRelativeTime(timestamp: number): string;
+/**
+ * Formats duration in milliseconds to a readable string (e.g., "2d 5h", "3h 20m", "45s")
+ * @param ms - Duration in milliseconds
+ * @returns Formatted duration string
+ */
+declare function formatarDuracao(ms: number): string;
+/**
+ * Alias for formatarDuracao using English naming convention
+ * @param ms - Duration in milliseconds
+ * @returns Formatted duration string
+ */
+declare const formatDuration: typeof formatarDuracao;
+
 /**
  * Formats a date to YYYY-MM-DD format
  * @param date - The date to format (Date object, timestamp, or date string)
@@ -308,6 +337,19 @@ declare function getValueByDatakeyLegacy(dataList: any[], dataSourceNameTarget:
  * @returns The value found, or undefined if not found
  */
 declare function findValue(data: any, keyOrPath: string, legacyDataKey?: string): any;
+/**
+ * Find a value in an array of objects by key/dataType (RFC-0091 compatible)
+ * Supports both ThingsBoard format {dataType, value} and generic {key, value}
+ * @param values - Array of objects with key/value or dataType/value properties
+ * @param key - Key or dataType to search for
+ * @param defaultValue - Default value if not found (defaults to null)
+ * @returns The found value or defaultValue
+ */
+declare function findValueWithDefault<T = any>(values: Array<{
+    key?: string;
+    dataType?: string;
+    value: any;
+}> | any, key: string, defaultValue?: T | null): T | null;
 
 /**
  * Maps device status to connection status
@@ -318,6 +360,12 @@ declare function findValue(data: any, keyOrPath: string, legacyDataKey?: string)
  * @returns {string} The connection status (connected or offline)
  */
 declare function mapDeviceToConnectionStatus(deviceStatus: string): string;
+/**
+ * Maps raw connection status string to normalized status
+ * @param {string} rawStatus - Raw status from ThingsBoard (e.g., 'ONLINE', 'ok', 'running', 'waiting', 'offline')
+ * @returns {'online' | 'waiting' | 'offline'} - Normalized status
+ */
+declare function mapConnectionStatus(rawStatus: string): "online" | "waiting" | "offline";
 /**
  * Maps device status to a simplified card status
  * Used for styling and visual representation
@@ -2116,7 +2164,7 @@ declare function clampTemperature(value: number | string, range?: ClampRange): n
 /**
  * Calculates statistics from temperature data
  */
-declare function calculateStats(data: TemperatureTelemetry[], clampRange?: ClampRange): TemperatureStats;
+declare function calculateStats$1(data: TemperatureTelemetry[], clampRange?: ClampRange): TemperatureStats;
 /**
  * Interpolates temperature data to fill gaps with 30-minute intervals
  * Uses 'repeat-last' strategy: if no reading in interval, repeats last known temperature
@@ -2283,4 +2331,916 @@ interface TemperatureSettingsInstance {
  */
 declare function openTemperatureSettingsModal(params: TemperatureSettingsParams): TemperatureSettingsInstance;
 
-export { CHART_COLORS, type ClampRange, ConnectionStatusType, type CreateDateRangePickerOptions, type CreateInputDateRangePickerInsideDIVParams, DEFAULT_CLAMP_RANGE, type DateRangeControl, type DateRangeInputController, type DateRangeResult, type DemandModalInstance, type DemandModalParams, type DemandModalPdfConfig, type DemandModalStyles, DeviceStatusType, type EnergyModalContext, type EnergyModalError, type EnergyModalI18n, type EnergyModalStyleOverrides, type MyIOAuthConfig, type MyIOAuthInstance, MyIOChartModal, MyIODraggableCard, MyIOSelectionStore, MyIOSelectionStoreClass, MyIOToast, type OpenDashboardPopupEnergyOptions, type OpenDashboardPopupSettingsParams, type OpenDashboardPopupWaterTankOptions, type PersistResult, type RealTimeTelemetryInstance, type RealTimeTelemetryParams, type SettingsError, type SettingsEvent, type StoreRow, type TbScope, type TelemetryFetcher, type TemperatureComparisonModalInstance, type TemperatureComparisonModalParams, type TemperatureDevice, type TemperatureGranularity, type TemperatureModalInstance, type TemperatureModalParams, type TemperatureSettingsInstance, type TemperatureSettingsParams, type TemperatureStats, type TemperatureTelemetry, type ThingsboardCustomerAttrsConfig, type TimedValue, type WaterRow, type WaterTankDataPoint, type WaterTankModalContext, type WaterTankModalError, type WaterTankModalI18n, type WaterTankModalStyleOverrides, type WaterTankTelemetryData, addDetectionContext, addNamespace, aggregateByDay, averageByDay, buildListItemsThingsboardByUniqueDatasource, buildMyioIngestionAuth, buildWaterReportCSV, buildWaterStoresCSV, calcDeltaPercent, calculateDeviceStatus, calculateDeviceStatusWithRanges, calculateStats, clampTemperature, classify, classifyWaterLabel, classifyWaterLabels, clearAllAuthCaches, connectionStatusIcons, createDateRangePicker, createInputDateRangePickerInsideDIV, decodePayload, decodePayloadBase64Xor, detectDeviceType, determineInterval, deviceStatusIcons, exportTemperatureCSV, exportToCSV, exportToCSVAll, extractMyIOCredentials, fetchTemperatureData, fetchThingsboardCustomerAttrsFromStorage, fetchThingsboardCustomerServerScopeAttrs, findValue, fmtPerc$1 as fmtPerc, fmtPerc as fmtPercLegacy, formatAllInSameUnit, formatAllInSameWaterUnit, formatDateForInput, formatDateToYMD, formatDateWithTimezoneOffset, formatEnergy, formatNumberReadable, formatTankHeadFromCm, formatTemperature, formatWaterByGroup, formatWaterVolumeM3, getAuthCacheStats, getAvailableContexts, getConnectionStatusIcon, getDateRangeArray, getDeviceStatusIcon, getDeviceStatusInfo, getSaoPauloISOString, getSaoPauloISOStringFixed, getValueByDatakey, getValueByDatakeyLegacy, getWaterCategories, groupByDay, interpolateTemperature, isDeviceOffline, isValidConnectionStatus, isValidDeviceStatus, isWaterCategory, mapDeviceStatusToCardStatus, mapDeviceToConnectionStatus, normalizeRecipients, numbers, openDashboardPopup, openDashboardPopupAllReport, openDashboardPopupEnergy, openDashboardPopupReport, openDashboardPopupSettings, openDashboardPopupWaterTank, openDemandModal, openGoalsPanel, openRealTimeTelemetryModal, openTemperatureComparisonModal, openTemperatureModal, openTemperatureSettingsModal, parseInputDateToDate, renderCardComponent$2 as renderCardComponent, renderCardComponent$1 as renderCardComponentEnhanced, renderCardComponentHeadOffice, renderCardComponentLegacy, renderCardComponentV2, renderCardComponent as renderCardComponentV5, renderCardComponentV5 as renderCardV5, shouldFlashIcon, strings, timeWindowFromInputYMD, toCSV, toFixedSafe, waterDeviceStatusIcons };
+/**
+ * MyIO Modal Header Component
+ *
+ * A reusable header component for modals with:
+ * - Title with optional icon (domain-specific)
+ * - Export button with format options (CSV, XLS, PDF)
+ * - Theme toggle (light/dark)
+ * - Maximize/restore button
+ * - Close button
+ *
+ * @example
+ * ```typescript
+ * import { createModalHeader } from 'myio-js-library';
+ *
+ * const header = createModalHeader({
+ *   id: 'my-modal',
+ *   title: 'My Modal Title',
+ *   icon: '📊',
+ *   theme: 'light',
+ *   isMaximized: false,
+ *   exportFormats: ['csv', 'xls', 'pdf'],
+ *   onExport: (format) => console.log('Export:', format),
+ *   onThemeToggle: (theme) => console.log('Theme:', theme),
+ *   onMaximize: (maximized) => console.log('Maximized:', maximized),
+ *   onClose: () => console.log('Close clicked'),
+ * });
+ *
+ * container.innerHTML = header.render();
+ * header.attachListeners();
+ * ```
+ */
+type ModalTheme = 'light' | 'dark';
+type ExportFormat$1 = 'csv' | 'xls' | 'pdf';
+interface ModalHeaderConfig {
+    /** Unique ID prefix for the modal elements */
+    id: string;
+    /** Modal title text */
+    title: string;
+    /** Optional icon (emoji or text) to display before title */
+    icon?: string;
+    /** Current theme */
+    theme?: ModalTheme;
+    /** Whether the modal is currently maximized */
+    isMaximized?: boolean;
+    /** Header background color (default: #3e1a7d - MyIO purple) */
+    backgroundColor?: string;
+    /** Header text color (default: white) */
+    textColor?: string;
+    /** Show theme toggle button (default: true) */
+    showThemeToggle?: boolean;
+    /** Show maximize button (default: true) */
+    showMaximize?: boolean;
+    /** Show close button (default: true) */
+    showClose?: boolean;
+    /** Border radius when not maximized (default: '10px 10px 0 0') */
+    borderRadius?: string;
+    /** Available export formats (shows dropdown if multiple) */
+    exportFormats?: ExportFormat$1[];
+    /** Callback when export is clicked with format */
+    onExport?: (format: ExportFormat$1) => void;
+    /** Callback when theme is toggled */
+    onThemeToggle?: (theme: ModalTheme) => void;
+    /** Callback when maximize/restore is clicked */
+    onMaximize?: (isMaximized: boolean) => void;
+    /** Callback when close is clicked */
+    onClose?: () => void;
+}
+interface ModalHeaderInstance {
+    /** Renders the header HTML */
+    render: () => string;
+    /** Attaches event listeners (call after adding to DOM) */
+    attachListeners: () => void;
+    /** Updates the header state */
+    update: (updates: Partial<Pick<ModalHeaderConfig, 'theme' | 'isMaximized' | 'title'>>) => void;
+    /** Gets the current state */
+    getState: () => {
+        theme: ModalTheme;
+        isMaximized: boolean;
+    };
+    /** Removes event listeners */
+    destroy: () => void;
+}
+/**
+ * Creates a modal header instance
+ */
+declare function createModalHeader(config: ModalHeaderConfig): ModalHeaderInstance;
+/**
+ * Returns CSS styles for the modal header component
+ * Can be injected into page or used in CSS-in-JS
+ */
+declare function getModalHeaderStyles(): string;
+
+/**
+ * RFC-0098: View Consumption Over 7 Days Component
+ * Type definitions for the reusable consumption chart component
+ */
+/**
+ * Supported chart domains
+ */
+type ChartDomain = 'energy' | 'water' | 'gas' | 'temperature' | string;
+/**
+ * Theme modes
+ */
+type ThemeMode = 'light' | 'dark';
+/**
+ * Chart visualization types
+ */
+type ChartType = 'line' | 'bar';
+/**
+ * Visualization modes
+ */
+type VizMode = 'total' | 'separate';
+/**
+ * Ideal range configuration for shaded area on chart
+ * Used to highlight acceptable/target ranges for any domain
+ */
+interface IdealRangeConfig {
+    /** Minimum value of the ideal range */
+    min: number;
+    /** Maximum value of the ideal range */
+    max: number;
+    /** Color for the shaded area (with alpha for transparency) */
+    color?: string;
+    /** Border color for the range box */
+    borderColor?: string;
+    /** Optional label to display */
+    label?: string;
+    /** Whether to show the range (default: true when min/max are set) */
+    enabled?: boolean;
+}
+/**
+ * Temperature reference line configuration
+ */
+interface TemperatureReferenceLine {
+    /** Value for the reference line */
+    value: number;
+    /** Label for the reference line */
+    label: string;
+    /** Line color */
+    color: string;
+    /** Line style: 'solid', 'dashed', 'dotted' */
+    lineStyle?: 'solid' | 'dashed' | 'dotted';
+    /** Line width (default: 2) */
+    lineWidth?: number;
+    /** Fill area above or below the line */
+    fillArea?: 'above' | 'below' | 'none';
+    /** Fill color (with alpha) */
+    fillColor?: string;
+}
+/**
+ * Temperature-specific configuration
+ */
+interface TemperatureConfig {
+    /** Minimum temperature reference line */
+    minThreshold?: TemperatureReferenceLine;
+    /** Maximum temperature reference line */
+    maxThreshold?: TemperatureReferenceLine;
+    /** Ideal range (shows shaded area between min and max) */
+    idealRange?: {
+        min: number;
+        max: number;
+        color: string;
+        label?: string;
+    };
+    /** Clamp values outside this range for display */
+    clampRange?: {
+        min: number;
+        max: number;
+    };
+    /** Show temperature unit in Y-axis (default: true) */
+    showUnitInAxis?: boolean;
+}
+/**
+ * Color configuration for the chart
+ */
+interface Consumption7DaysColors {
+    /** Primary line/bar color */
+    primary: string;
+    /** Background fill color (for line charts) */
+    background: string;
+    /** Optional gradient colors [start, end] */
+    gradient?: [string, string];
+    /** Optional border color */
+    borderColor?: string;
+    /** Optional point colors for line charts */
+    pointBackground?: string;
+    pointBorder?: string;
+    /** Colors for per-shopping datasets (separate mode) */
+    shoppingColors?: string[];
+}
+/**
+ * Single data point for consumption
+ */
+interface ConsumptionDataPoint {
+    /** ISO date string or formatted label */
+    date: string;
+    /** Consumption value in base unit */
+    value: number;
+    /** Optional custom label override */
+    label?: string;
+}
+/**
+ * Data point with shopping information (for per-shopping mode)
+ */
+interface ShoppingDataPoint extends ConsumptionDataPoint {
+    /** Shopping identifier */
+    shoppingId: string;
+    /** Shopping display name */
+    shoppingName: string;
+}
+/**
+ * Structured data for the 7-day consumption chart
+ */
+interface Consumption7DaysData {
+    /** Array of date labels for X-axis */
+    labels: string[];
+    /** Array of total consumption values per day */
+    dailyTotals: number[];
+    /** Optional per-shopping data: { shoppingId: [values per day...] } */
+    shoppingData?: Record<string, number[]>;
+    /** Optional shopping name mapping: { shoppingId: displayName } */
+    shoppingNames?: Record<string, string>;
+    /** Timestamp when data was fetched (for cache validation) */
+    fetchTimestamp?: number;
+    /** Customer IDs used to fetch this data (for cache validation) */
+    customerIds?: string[];
+}
+/**
+ * Configuration options for creating the consumption chart
+ */
+interface Consumption7DaysConfig {
+    /** Domain identifier (energy, water, etc.) - used for logging */
+    domain: ChartDomain;
+    /** Canvas element ID to render the chart */
+    containerId: string;
+    /** Base unit for display (kWh, m³, etc.) */
+    unit: string;
+    /**
+     * Data fetching function - must return structured data
+     * @param period - Number of days to fetch
+     * @returns Promise resolving to consumption data
+     */
+    fetchData: (period: number) => Promise<Consumption7DaysData>;
+    /** Large unit for values above threshold (MWh, etc.) - null to disable */
+    unitLarge?: string | null;
+    /** Threshold value to switch to large unit (1000 for kWh->MWh) */
+    thresholdForLargeUnit?: number | null;
+    /** Decimal places for value display */
+    decimalPlaces?: number;
+    /** Color configuration */
+    colors?: Consumption7DaysColors;
+    /** Chart title (optional, usually in container header) */
+    title?: string;
+    /** Show legend below chart */
+    showLegend?: boolean;
+    /** Line tension for smooth curves (0-1, default: 0.4) */
+    lineTension?: number;
+    /** Point radius for line charts (default: 4) */
+    pointRadius?: number;
+    /** Border width for lines/bars (default: 2) */
+    borderWidth?: number;
+    /** Fill area under line chart (default: true) */
+    fill?: boolean;
+    /** Theme mode: 'light' or 'dark' (default: 'light') */
+    theme?: ThemeMode;
+    /** Default period in days (default: 7) */
+    defaultPeriod?: number;
+    /** Default chart type (default: 'line') */
+    defaultChartType?: ChartType;
+    /** Default visualization mode (default: 'total') */
+    defaultVizMode?: VizMode;
+    /** Cache TTL in milliseconds (default: 300000 = 5 min) */
+    cacheTTL?: number;
+    /** Auto-refresh interval in milliseconds (null to disable) */
+    autoRefreshInterval?: number | null;
+    /** Called when data is successfully loaded */
+    onDataLoaded?: (data: Consumption7DaysData) => void;
+    /** Called when an error occurs */
+    onError?: (error: Error) => void;
+    /** Called before rendering (can modify data) */
+    onBeforeRender?: (data: Consumption7DaysData) => Consumption7DaysData;
+    /** Called after chart is rendered */
+    onAfterRender?: (chartInstance: any) => void;
+    /**
+     * Called when settings button is clicked
+     * Use this to open a custom settings modal (e.g., with createDateRangePicker)
+     * If not provided, no settings button functionality is added
+     */
+    onSettingsClick?: () => void;
+    /**
+     * Called when maximize button is clicked
+     * Use this to open fullscreen mode
+     * If not provided, no maximize button functionality is added
+     */
+    onMaximizeClick?: () => void;
+    /**
+     * Called when export CSV button is clicked
+     * If not provided, uses default export behavior
+     */
+    onExportCSV?: (data: Consumption7DaysData) => void;
+    /**
+     * Enable CSV export functionality (default: true)
+     */
+    enableExport?: boolean;
+    /**
+     * ID of the export button element to attach click handler
+     */
+    exportButtonId?: string;
+    /**
+     * Custom filename for CSV export (without extension)
+     * Default: '{domain}-consumption-{date}'
+     */
+    exportFilename?: string;
+    /**
+     * Ideal range configuration for displaying a shaded area on the chart.
+     * Shows acceptable/target range for the metric.
+     *
+     * For temperature: typically comes from customer attributes (minTemperature, maxTemperature)
+     * For energy/water/gas: optional, can be set via settings modal
+     *
+     * @example
+     * ```typescript
+     * // Temperature with customer-defined range
+     * idealRange: {
+     *   min: 20,  // minTemperature from customer
+     *   max: 24,  // maxTemperature from customer
+     *   color: 'rgba(34, 197, 94, 0.15)',
+     *   label: 'Faixa Ideal'
+     * }
+     *
+     * // Energy with target consumption
+     * idealRange: {
+     *   min: 0,
+     *   max: 500,  // kWh target
+     *   color: 'rgba(37, 99, 235, 0.1)',
+     *   label: 'Meta de Consumo'
+     * }
+     * ```
+     */
+    idealRange?: IdealRangeConfig;
+    /**
+     * Temperature-specific configuration
+     * Only applies when domain is 'temperature'
+     */
+    temperatureConfig?: TemperatureConfig;
+    /**
+     * ThingsBoard widget container for proper DOM querying
+     * When provided, uses $container.querySelector() instead of document.getElementById()
+     */
+    $container?: {
+        [key: number]: HTMLElement;
+    } | null;
+    /**
+     * ID of the settings button element to attach click handler
+     * Used with onSettingsClick callback
+     */
+    settingsButtonId?: string;
+    /**
+     * ID of the maximize button element to attach click handler
+     * Used with onMaximizeClick callback
+     */
+    maximizeButtonId?: string;
+    /**
+     * ID of the chart title element to update dynamically
+     */
+    titleElementId?: string;
+}
+/**
+ * Public API returned by createConsumption7DaysChart()
+ */
+interface Consumption7DaysInstance {
+    /**
+     * Render the chart (fetches data and creates Chart.js instance)
+     */
+    render: () => Promise<void>;
+    /**
+     * Update chart with new or existing data
+     * @param data - Optional new data; uses cached data if not provided
+     */
+    update: (data?: Consumption7DaysData) => Promise<void>;
+    /**
+     * Change chart type (line/bar)
+     * @param type - New chart type
+     */
+    setChartType: (type: ChartType) => void;
+    /**
+     * Change visualization mode (total/separate)
+     * @param mode - New visualization mode
+     */
+    setVizMode: (mode: VizMode) => void;
+    /**
+     * Change the period and re-fetch data
+     * @param days - New period in days
+     */
+    setPeriod: (days: number) => Promise<void>;
+    /**
+     * Refresh data from source
+     * @param forceRefresh - Bypass cache if true
+     */
+    refresh: (forceRefresh?: boolean) => Promise<void>;
+    /**
+     * Destroy the chart instance and clean up resources
+     */
+    destroy: () => void;
+    /**
+     * Get the underlying Chart.js instance
+     */
+    getChartInstance: () => any | null;
+    /**
+     * Get currently cached data
+     */
+    getCachedData: () => Consumption7DaysData | null;
+    /**
+     * Get current configuration state
+     */
+    getState: () => {
+        period: number;
+        chartType: ChartType;
+        vizMode: VizMode;
+        theme: ThemeMode;
+        isRendered: boolean;
+    };
+    /**
+     * Export current data to CSV file
+     * @param filename - Optional custom filename (without extension)
+     */
+    exportCSV: (filename?: string) => void;
+    /**
+     * Set theme mode
+     * @param theme - 'light' or 'dark'
+     */
+    setTheme: (theme: ThemeMode) => void;
+    /**
+     * Set or update the ideal range
+     * Pass null to remove the ideal range
+     * @param range - Ideal range configuration or null to clear
+     */
+    setIdealRange: (range: IdealRangeConfig | null) => void;
+    /**
+     * Get the current ideal range configuration
+     */
+    getIdealRange: () => IdealRangeConfig | null;
+}
+/**
+ * Default color schemes for common domains
+ */
+declare const DEFAULT_COLORS: Record<string, Consumption7DaysColors>;
+/**
+ * Theme color configurations
+ */
+interface ThemeColors {
+    /** Chart background color */
+    chartBackground: string;
+    /** Text color */
+    text: string;
+    /** Muted text color */
+    textMuted: string;
+    /** Grid line color */
+    grid: string;
+    /** Border color */
+    border: string;
+    /** Tooltip background */
+    tooltipBackground: string;
+    /** Tooltip text */
+    tooltipText: string;
+}
+/**
+ * Default theme colors for light and dark modes
+ */
+declare const THEME_COLORS: Record<ThemeMode, ThemeColors>;
+/**
+ * Default configuration values
+ */
+declare const DEFAULT_CONFIG: {
+    defaultPeriod: number;
+    defaultChartType: ChartType;
+    defaultVizMode: VizMode;
+    defaultTheme: ThemeMode;
+    cacheTTL: number;
+    decimalPlaces: number;
+    lineTension: number;
+    pointRadius: number;
+    borderWidth: number;
+    fill: boolean;
+    showLegend: boolean;
+    enableExport: boolean;
+};
+
+/**
+ * RFC-0098: View Consumption Over 7 Days Component
+ * Factory function to create a reusable consumption chart
+ *
+ * @example
+ * ```typescript
+ * import { createConsumption7DaysChart } from 'myio-js-library';
+ *
+ * const chart = createConsumption7DaysChart({
+ *   domain: 'energy',
+ *   containerId: 'lineChart',
+ *   unit: 'kWh',
+ *   unitLarge: 'MWh',
+ *   thresholdForLargeUnit: 1000,
+ *   fetchData: async (period) => fetchEnergyData(period),
+ * });
+ *
+ * await chart.render();
+ * ```
+ */
+
+/**
+ * Creates a consumption chart instance with the given configuration
+ *
+ * @param config - Chart configuration options
+ * @returns Chart instance with public API
+ */
+declare function createConsumption7DaysChart(config: Consumption7DaysConfig): Consumption7DaysInstance;
+
+/**
+ * RFC-0098: Consumption Modal with MyIO Header
+ *
+ * Creates a fullscreen modal for the consumption chart using the standard
+ * MyIO header with theme toggle, maximize, export and close buttons.
+ *
+ * @example
+ * ```typescript
+ * import { createConsumptionModal } from 'myio-js-library';
+ *
+ * const modal = createConsumptionModal({
+ *   domain: 'energy',
+ *   title: 'Consumo de Energia',
+ *   unit: 'kWh',
+ *   fetchData: async (period) => fetchEnergyData(period),
+ *   onClose: () => console.log('Modal closed'),
+ * });
+ *
+ * await modal.open();
+ * ```
+ */
+
+interface ConsumptionModalConfig extends Omit<Consumption7DaysConfig, 'containerId'> {
+    /** Modal title */
+    title?: string;
+    /** Initial theme */
+    theme?: ThemeMode;
+    /** Callback when modal closes */
+    onClose?: () => void;
+    /** Container to append modal (default: document.body) */
+    container?: HTMLElement;
+    /** Export formats available (default: ['csv']) */
+    exportFormats?: ExportFormat$1[];
+    /** Custom export handler (receives format, default uses built-in CSV export) */
+    onExport?: (format: ExportFormat$1) => void;
+}
+interface ConsumptionModalInstance {
+    /** Opens the modal */
+    open: () => Promise<void>;
+    /** Closes the modal */
+    close: () => void;
+    /** Gets the chart instance */
+    getChart: () => ReturnType<typeof createConsumption7DaysChart> | null;
+    /** Destroys the modal and chart */
+    destroy: () => void;
+}
+/**
+ * Creates a consumption modal with the standard MyIO header
+ */
+declare function createConsumptionModal(config: ConsumptionModalConfig): ConsumptionModalInstance;
+
+/**
+ * RFC-0098: Consumption Chart Widget
+ *
+ * Creates an inline chart widget that injects all HTML structure into a container.
+ * Unlike createConsumptionModal (which creates a modal overlay), this component
+ * renders directly into a specified container element.
+ *
+ * @example
+ * ```typescript
+ * import { createConsumptionChartWidget } from 'myio-js-library';
+ *
+ * const widget = createConsumptionChartWidget({
+ *   domain: 'energy',
+ *   containerId: 'energy-chart-container',
+ *   title: 'Consumo dos últimos 7 dias',
+ *   unit: 'kWh',
+ *   fetchData: async (period) => fetchEnergyData(period),
+ * });
+ *
+ * await widget.render();
+ * ```
+ */
+
+interface ConsumptionWidgetConfig extends Omit<Consumption7DaysConfig, 'containerId'> {
+    /** ID of the container element where the widget will be rendered */
+    containerId: string;
+    /** Widget title (default: "Consumo dos últimos X dias") */
+    title?: string;
+    /** Show settings button (default: true) */
+    showSettingsButton?: boolean;
+    /** Show maximize button (default: true) */
+    showMaximizeButton?: boolean;
+    /** Show viz mode tabs (default: true) */
+    showVizModeTabs?: boolean;
+    /** Show chart type tabs (default: true) */
+    showChartTypeTabs?: boolean;
+    /** Chart height in pixels or CSS value (default: 300) */
+    chartHeight?: number | string;
+    /** Callback when settings button is clicked */
+    onSettingsClick?: () => void;
+    /** Callback when maximize button is clicked */
+    onMaximizeClick?: () => void;
+    /** Custom CSS class for the widget container */
+    className?: string;
+}
+interface ConsumptionWidgetInstance {
+    /** Renders the widget into the container */
+    render: () => Promise<void>;
+    /** Refreshes the chart data */
+    refresh: (forceRefresh?: boolean) => Promise<void>;
+    /** Sets the chart type */
+    setChartType: (type: ChartType) => void;
+    /** Sets the visualization mode */
+    setVizMode: (mode: VizMode) => void;
+    /** Sets the theme */
+    setTheme: (theme: ThemeMode) => void;
+    /** Sets the period in days */
+    setPeriod: (days: number) => Promise<void>;
+    /** Sets the ideal range */
+    setIdealRange: (range: IdealRangeConfig | null) => void;
+    /** Gets the internal chart instance */
+    getChart: () => ReturnType<typeof createConsumption7DaysChart> | null;
+    /** Gets the cached data */
+    getCachedData: () => Consumption7DaysData | null;
+    /** Exports data to CSV */
+    exportCSV: (filename?: string) => void;
+    /** Destroys the widget */
+    destroy: () => void;
+}
+declare function createConsumptionChartWidget(config: ConsumptionWidgetConfig): ConsumptionWidgetInstance;
+
+/**
+ * RFC-0101: Export Data Smart Component Types
+ *
+ * Type definitions for the export data component system.
+ */
+/** Domain types for data classification */
+type ExportDomain = 'energy' | 'water' | 'temperature';
+/** Supported export file formats */
+type ExportFormat = 'pdf' | 'xlsx' | 'csv';
+/** Export type determining data structure */
+type ExportType = 'one-device' | 'comparison' | 'one-customer' | 'group-of-customer';
+/** Custom color palette for exports */
+interface ExportColorsPallet {
+    /** Primary brand color (default: MyIO purple #3e1a7d) */
+    primary?: string;
+    /** Secondary color for accents */
+    secondary?: string;
+    /** Accent color for highlights */
+    accent?: string;
+    /** Background color */
+    background?: string;
+    /** Text color */
+    text?: string;
+    /** Chart colors array */
+    chartColors?: string[];
+}
+/** Configuration options for buildTemplateExport */
+interface BuildTemplateExportParams {
+    /** Data domain (energy, water, temperature) */
+    domain: ExportDomain;
+    /** Output format (pdf, xlsx, csv) */
+    formatExport: ExportFormat;
+    /** Type of export data structure */
+    typeExport: ExportType;
+    /** Optional custom color palette */
+    colorsPallet?: ExportColorsPallet;
+    /** Locale for number/date formatting (default: 'pt-BR') */
+    locale?: string;
+    /** Include chart in export (PDF only) */
+    includeChart?: boolean;
+    /** Include statistics (min, max, avg) */
+    includeStats?: boolean;
+    /** Custom header text */
+    headerText?: string;
+    /** Custom footer text */
+    footerText?: string;
+}
+/** Generated export configuration template */
+interface ExportConfigTemplate {
+    /** Domain configuration */
+    domain: ExportDomain;
+    /** Format configuration */
+    formatExport: ExportFormat;
+    /** Export type */
+    typeExport: ExportType;
+    /** Resolved color palette */
+    colors: Required<ExportColorsPallet>;
+    /** Locale setting */
+    locale: string;
+    /** Chart inclusion flag */
+    includeChart: boolean;
+    /** Stats inclusion flag */
+    includeStats: boolean;
+    /** Header text */
+    headerText: string;
+    /** Footer text */
+    footerText: string;
+    /** Domain-specific icon */
+    domainIcon: string;
+    /** Domain label (localized) */
+    domainLabel: string;
+    /** Unit for the domain */
+    domainUnit: string;
+}
+/** Single data point with timestamp and value */
+interface ExportDataPoint {
+    /** Timestamp of the measurement */
+    timestamp: Date | string | number;
+    /** Measured value */
+    value: number;
+    /** Optional unit override */
+    unit?: string;
+}
+/** Device information for export */
+interface ExportDeviceInfo {
+    /** Device identifier (e.g., '113CD') */
+    identifier?: string;
+    /** Device label (display name) */
+    label?: string;
+    /** Device name (fallback if no label) */
+    name: string;
+    /** Device icon (optional) */
+    icon?: string;
+}
+/** Customer/Shopping information */
+interface ExportCustomerInfo {
+    /** Customer name */
+    customerName?: string;
+    /** Shopping/location name */
+    shoppingName?: string;
+    /** Customer logo URL (for PDF) */
+    logoUrl?: string;
+}
+/** Complete data structure for export */
+interface ExportData {
+    /** Device information */
+    device: ExportDeviceInfo;
+    /** Customer information */
+    customer?: ExportCustomerInfo;
+    /** Data points array */
+    data: ExportDataPoint[];
+    /** Period start date */
+    periodStart?: Date | string;
+    /** Period end date */
+    periodEnd?: Date | string;
+}
+/** Data structure for comparison exports */
+interface ExportComparisonData {
+    /** Array of devices with their data */
+    devices: Array<ExportData>;
+    /** Customer information */
+    customer?: ExportCustomerInfo;
+    /** Period start date */
+    periodStart?: Date | string;
+    /** Period end date */
+    periodEnd?: Date | string;
+}
+/** Data structure for customer exports */
+interface ExportCustomerData {
+    /** Customer information */
+    customer: ExportCustomerInfo;
+    /** Array of devices with their data */
+    devices: Array<ExportData>;
+    /** Period start date */
+    periodStart?: Date | string;
+    /** Period end date */
+    periodEnd?: Date | string;
+}
+/** Data structure for group of customers exports */
+interface ExportGroupData {
+    /** Group name */
+    groupName: string;
+    /** Array of customers with their data */
+    customers: Array<ExportCustomerData>;
+    /** Period start date */
+    periodStart?: Date | string;
+    /** Period end date */
+    periodEnd?: Date | string;
+}
+/** Union type for all export data types */
+type ExportDataInput = ExportData | ExportComparisonData | ExportCustomerData | ExportGroupData;
+/** Calculated statistics for a data series */
+interface ExportStats {
+    /** Minimum value in the period */
+    min: number;
+    /** Maximum value in the period */
+    max: number;
+    /** Average value in the period */
+    average: number;
+    /** Sum of all values */
+    sum: number;
+    /** Number of data points */
+    count: number;
+}
+/** Export result with file information */
+interface ExportResult {
+    /** Whether export was successful */
+    success: boolean;
+    /** Generated filename */
+    filename: string;
+    /** File blob (for download) */
+    blob?: Blob;
+    /** Data URL (for preview) */
+    dataUrl?: string;
+    /** Error message if failed */
+    error?: string;
+}
+/** Export instance returned by myioExportData */
+interface ExportDataInstance {
+    /** Execute the export and get result */
+    export: () => Promise<ExportResult>;
+    /** Download the exported file */
+    download: () => Promise<void>;
+    /** Get preview data URL (PDF only) */
+    preview: () => Promise<string | null>;
+    /** Get calculated statistics */
+    getStats: () => ExportStats;
+    /** Get generated filename */
+    getFilename: () => string;
+}
+/** Progress callback for large exports */
+type ExportProgressCallback = (progress: number, message: string) => void;
+/** Options for the export function */
+interface ExportOptions {
+    /** Progress callback */
+    onProgress?: ExportProgressCallback;
+    /** Auto-download after export */
+    autoDownload?: boolean;
+}
+
+/**
+ * RFC-0101: Export Data Smart Component
+ *
+ * A two-part smart component system for exporting device data
+ * in multiple formats (PDF, XLS, CSV) across different domains
+ * (temperature, water, energy).
+ *
+ * @example
+ * ```typescript
+ * import { buildTemplateExport, myioExportData } from 'myio-js-library';
+ *
+ * // 1. Create configuration template
+ * const config = buildTemplateExport({
+ *   domain: 'energy',
+ *   formatExport: 'pdf',
+ *   typeExport: 'one-device',
+ * });
+ *
+ * // 2. Export data
+ * const exporter = myioExportData(data, config);
+ * await exporter.download();
+ * ```
+ */
+
+/**
+ * Generates filename based on export config and data
+ */
+declare function generateFilename(data: ExportDataInput, config: ExportConfigTemplate): string;
+/**
+ * Calculates statistics from data points
+ */
+declare function calculateStats(dataPoints: ExportDataPoint[]): ExportStats;
+/**
+ * Creates an export configuration template
+ *
+ * @param params - Configuration parameters
+ * @returns Export configuration template
+ *
+ * @example
+ * ```typescript
+ * const config = buildTemplateExport({
+ *   domain: 'energy',
+ *   formatExport: 'pdf',
+ *   typeExport: 'one-device',
+ *   colorsPallet: { primary: '#ff0000' },
+ * });
+ * ```
+ */
+declare function buildTemplateExport(params: BuildTemplateExportParams): ExportConfigTemplate;
+/**
+ * Creates an export instance with the provided data and configuration
+ *
+ * @param data - Data to export
+ * @param config - Export configuration template
+ * @param options - Optional export options
+ * @returns Export data instance
+ *
+ * @example
+ * ```typescript
+ * const exporter = myioExportData(deviceData, config);
+ * await exporter.download();
+ * ```
+ */
+declare function myioExportData(data: ExportDataInput, config: ExportConfigTemplate, options?: ExportOptions): ExportDataInstance;
+/** Default colors for exports */
+declare const EXPORT_DEFAULT_COLORS: Required<ExportColorsPallet>;
+/** Domain icons */
+declare const EXPORT_DOMAIN_ICONS: Record<ExportDomain, string>;
+/** Domain labels */
+declare const EXPORT_DOMAIN_LABELS: Record<ExportDomain, string>;
+/** Domain units */
+declare const EXPORT_DOMAIN_UNITS: Record<ExportDomain, string>;
+
+export { type BuildTemplateExportParams, CHART_COLORS, DEFAULT_COLORS as CONSUMPTION_CHART_COLORS, DEFAULT_CONFIG as CONSUMPTION_CHART_DEFAULTS, THEME_COLORS as CONSUMPTION_THEME_COLORS, type ChartDomain, type ClampRange, ConnectionStatusType, type Consumption7DaysColors, type Consumption7DaysConfig, type Consumption7DaysData, type Consumption7DaysInstance, type ChartType as ConsumptionChartType, type ConsumptionDataPoint, type IdealRangeConfig as ConsumptionIdealRangeConfig, type ConsumptionModalConfig, type ConsumptionModalInstance, type TemperatureConfig as ConsumptionTemperatureConfig, type TemperatureReferenceLine as ConsumptionTemperatureReferenceLine, type ThemeColors as ConsumptionThemeColors, type ThemeMode as ConsumptionThemeMode, type VizMode as ConsumptionVizMode, type ConsumptionWidgetConfig, type ConsumptionWidgetInstance, type CreateDateRangePickerOptions, type CreateInputDateRangePickerInsideDIVParams, DEFAULT_CLAMP_RANGE, type DateRangeControl, type DateRangeInputController, type DateRangeResult, type DemandModalInstance, type DemandModalParams, type DemandModalPdfConfig, type DemandModalStyles, DeviceStatusType, EXPORT_DEFAULT_COLORS, EXPORT_DOMAIN_ICONS, EXPORT_DOMAIN_LABELS, EXPORT_DOMAIN_UNITS, type EnergyModalContext, type EnergyModalError, type EnergyModalI18n, type EnergyModalStyleOverrides, type ExportColorsPallet, type ExportComparisonData, type ExportConfigTemplate, type ExportCustomerData, type ExportCustomerInfo, type ExportData, type ExportDataInput, type ExportDataInstance, type ExportDataPoint, type ExportDeviceInfo, type ExportDomain, type ExportFormat, type ExportGroupData, type ExportOptions, type ExportProgressCallback, type ExportResult, type ExportStats, type ExportType, type ExportFormat$1 as ModalExportFormat, type ModalHeaderConfig, type ModalHeaderInstance, type ModalTheme, type MyIOAuthConfig, type MyIOAuthInstance, MyIOChartModal, MyIODraggableCard, MyIOSelectionStore, MyIOSelectionStoreClass, MyIOToast, type OpenDashboardPopupEnergyOptions, type OpenDashboardPopupSettingsParams, type OpenDashboardPopupWaterTankOptions, type PersistResult, type RealTimeTelemetryInstance, type RealTimeTelemetryParams, type SettingsError, type SettingsEvent, type ShoppingDataPoint, type StoreRow, type TbScope, type TelemetryFetcher, type TemperatureComparisonModalInstance, type TemperatureComparisonModalParams, type TemperatureDevice, type TemperatureGranularity, type TemperatureModalInstance, type TemperatureModalParams, type TemperatureSettingsInstance, type TemperatureSettingsParams, type TemperatureStats, type TemperatureTelemetry, type ThingsboardCustomerAttrsConfig, type TimedValue, type WaterRow, type WaterTankDataPoint, type WaterTankModalContext, type WaterTankModalError, type WaterTankModalI18n, type WaterTankModalStyleOverrides, type WaterTankTelemetryData, addDetectionContext, addNamespace, aggregateByDay, averageByDay, buildListItemsThingsboardByUniqueDatasource, buildMyioIngestionAuth, buildTemplateExport, buildWaterReportCSV, buildWaterStoresCSV, calcDeltaPercent, calculateDeviceStatus, calculateDeviceStatusWithRanges, calculateStats as calculateExportStats, calculateStats$1 as calculateStats, clampTemperature, classify, classifyWaterLabel, classifyWaterLabels, clearAllAuthCaches, connectionStatusIcons, createConsumption7DaysChart, createConsumptionChartWidget, createConsumptionModal, createDateRangePicker, createInputDateRangePickerInsideDIV, createModalHeader, decodePayload, decodePayloadBase64Xor, detectDeviceType, determineInterval, deviceStatusIcons, exportTemperatureCSV, exportToCSV, exportToCSVAll, extractMyIOCredentials, fetchTemperatureData, fetchThingsboardCustomerAttrsFromStorage, fetchThingsboardCustomerServerScopeAttrs, findValue, findValueWithDefault, fmtPerc$1 as fmtPerc, fmtPerc as fmtPercLegacy, formatAllInSameUnit, formatAllInSameWaterUnit, formatDateForInput, formatDateToYMD, formatDateWithTimezoneOffset, formatDuration, formatEnergy, formatNumberReadable, formatRelativeTime, formatTankHeadFromCm, formatTemperature, formatWater, formatWaterByGroup, formatWaterVolumeM3, formatarDuracao, generateFilename as generateExportFilename, getAuthCacheStats, getAvailableContexts, getConnectionStatusIcon, getDateRangeArray, getDeviceStatusIcon, getDeviceStatusInfo, getModalHeaderStyles, getSaoPauloISOString, getSaoPauloISOStringFixed, getValueByDatakey, getValueByDatakeyLegacy, getWaterCategories, groupByDay, interpolateTemperature, isDeviceOffline, isValidConnectionStatus, isValidDeviceStatus, isWaterCategory, mapConnectionStatus, mapDeviceStatusToCardStatus, mapDeviceToConnectionStatus, myioExportData, normalizeRecipients, numbers, openDashboardPopup, openDashboardPopupAllReport, openDashboardPopupEnergy, openDashboardPopupReport, openDashboardPopupSettings, openDashboardPopupWaterTank, openDemandModal, openGoalsPanel, openRealTimeTelemetryModal, openTemperatureComparisonModal, openTemperatureModal, openTemperatureSettingsModal, parseInputDateToDate, renderCardComponent$2 as renderCardComponent, renderCardComponent$1 as renderCardComponentEnhanced, renderCardComponentHeadOffice, renderCardComponentLegacy, renderCardComponentV2, renderCardComponent as renderCardComponentV5, renderCardComponentV5 as renderCardV5, shouldFlashIcon, strings, timeWindowFromInputYMD, toCSV, toFixedSafe, waterDeviceStatusIcons };