@texturehq/edges 1.1.0 → 1.2.0

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { I as Icon, B as BaseDataPoint, Y as YFormatType, T as TooltipData, a as IconName$2 } from './server-DkP8PI1p.js';
-export { A as ActionItem, c as ActionMenu, b as ActionMenuProps, e as AppShell, d as AppShellProps, g as Avatar, f as AvatarProps, i as Badge, h as BadgeProps, k as Card, C as CardProps, j as CardVariant, V as ChartContext, X as ChartMargin, o as CodeEditor, l as CodeEditorProps, m as CodeLanguage, n as CodeTheme, p as DateField, D as DateFieldProps, q as FileUpload, F as FileUploadProps, H as Heading, t as InteractiveMap, s as InteractiveMapProps, L as Loader, r as Logo, u as MAPBOX_THEMES, M as MapPoint, x as Meter, w as MeterProps, y as RichTextEditor, R as RichTextEditorProps, E as SegmentOption, G as SegmentedControl, z as SegmentedControlProps, N as SideNav, J as SideNavItem, K as SideNavProps, v as StaticMap, S as StaticMapProps, O as TextLink, U as TooltipSeries, Q as TopNav, P as TopNavProps, a1 as YFormatSettings, a2 as clearColorCache, a3 as createCategoryColorMap, Z as createXScale, _ as createYScale, $ as defaultMargin, a4 as getContrastingTextColor, a5 as getDefaultChartColor, a6 as getDefaultColors, a7 as getResolvedColor, a8 as getThemeCategoricalColors, a0 as getYFormatSettings, a9 as isLightColor, W as useChartContext } from './server-DkP8PI1p.js';
+import { I as Icon, B as BaseDataPoint, Y as YFormatType, T as TooltipData, a as IconName$2 } from './server-C1hypeJ9.js';
+export { A as ActionItem, c as ActionMenu, b as ActionMenuProps, e as AppShell, d as AppShellProps, g as Avatar, f as AvatarProps, i as Badge, h as BadgeProps, k as Card, C as CardProps, j as CardVariant, V as ChartContext, X as ChartMargin, o as CodeEditor, l as CodeEditorProps, m as CodeLanguage, n as CodeTheme, p as DateField, D as DateFieldProps, q as FileUpload, F as FileUploadProps, H as Heading, t as InteractiveMap, s as InteractiveMapProps, L as Loader, r as Logo, u as MAPBOX_THEMES, M as MapPoint, x as Meter, w as MeterProps, y as RichTextEditor, R as RichTextEditorProps, E as SegmentOption, G as SegmentedControl, z as SegmentedControlProps, N as SideNav, J as SideNavItem, K as SideNavProps, v as StaticMap, S as StaticMapProps, O as TextLink, U as TooltipSeries, Q as TopNav, P as TopNavProps, a1 as YFormatSettings, a2 as clearColorCache, a3 as createCategoryColorMap, Z as createXScale, _ as createYScale, $ as defaultMargin, a4 as getContrastingTextColor, a5 as getDefaultChartColor, a6 as getDefaultColors, a7 as getResolvedColor, a8 as getThemeCategoricalColors, a0 as getYFormatSettings, a9 as isLightColor, W as useChartContext } from './server-C1hypeJ9.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React$1 from 'react';
 import React__default, { ComponentProps, ReactNode, ComponentType, Component, ErrorInfo } from 'react';
-import { Key, ValidationResult, BreadcrumbProps, BreadcrumbsProps, ButtonProps as ButtonProps$1, DateValue, CalendarProps as CalendarProps$1, CheckboxProps as CheckboxProps$1, CheckboxRenderProps, CheckboxGroupProps as CheckboxGroupProps$1, DateRangePickerProps as DateRangePickerProps$1, DialogProps, TextProps, FormProps, ListBoxProps as ListBoxProps$1, ListBoxItemProps, NumberFieldProps as NumberFieldProps$1, PopoverProps as PopoverProps$1, ProgressBarProps as ProgressBarProps$1, RadioProps, RadioGroupProps as RadioGroupProps$1, RangeCalendarProps as RangeCalendarProps$1, SelectProps as SelectProps$1, SwitchProps as SwitchProps$1, TabProps as TabProps$1, TabListProps, TabPanelProps, TabsProps as TabsProps$1, TextFieldProps as TextFieldProps$1, TimeFieldProps as TimeFieldProps$1, TimeValue, TooltipProps as TooltipProps$1 } from 'react-aria-components';
+import { Key, ValidationResult, BreadcrumbProps, BreadcrumbsProps, ButtonProps as ButtonProps$1, DateValue, CalendarProps as CalendarProps$1, CheckboxProps as CheckboxProps$1, CheckboxRenderProps, CheckboxGroupProps as CheckboxGroupProps$1, DateRangePickerProps as DateRangePickerProps$1, DialogProps, TextProps, FormProps, ListBoxProps as ListBoxProps$1, ListBoxItemProps, NumberFieldProps as NumberFieldProps$1, PopoverProps as PopoverProps$1, ProgressBarProps as ProgressBarProps$1, RadioProps, RadioGroupProps as RadioGroupProps$1, RangeCalendarProps as RangeCalendarProps$1, SelectProps as SelectProps$1, SwitchProps as SwitchProps$1, TabProps as TabProps$1, TabListProps as TabListProps$1, TabPanelProps, TabsProps as TabsProps$2, TextFieldProps as TextFieldProps$1, TimeFieldProps as TimeFieldProps$1, TimeValue, TooltipProps as TooltipProps$1 } from 'react-aria-components';
 export { BreadcrumbProps, BreadcrumbsProps } from 'react-aria-components';
 import { ScaleTime, ScaleLinear } from 'd3-scale';
 import '@phosphor-icons/react';
@@ -86,6 +86,34 @@ interface EnergyFormat extends BaseFormat {
     autoScale?: boolean;
     decimals?: number;
 }
+type PowerUnit = "W" | "kW" | "MW" | "GW";
+interface PowerFormat extends BaseFormat {
+    type: "power";
+    unit?: PowerUnit;
+    autoScale?: boolean;
+    decimals?: number;
+}
+type VoltageUnit = "mV" | "V" | "kV";
+interface VoltageFormat extends BaseFormat {
+    type: "voltage";
+    unit?: VoltageUnit;
+    autoScale?: boolean;
+    decimals?: number;
+}
+type CurrentUnit = "mA" | "A" | "kA";
+interface CurrentFormat extends BaseFormat {
+    type: "current";
+    unit?: CurrentUnit;
+    autoScale?: boolean;
+    decimals?: number;
+}
+type ResistanceUnit = "mΩ" | "Ω" | "kΩ" | "MΩ";
+interface ResistanceFormat extends BaseFormat {
+    type: "resistance";
+    unit?: ResistanceUnit;
+    autoScale?: boolean;
+    decimals?: number;
+}
 type TemperatureUnit = "C" | "F" | "K";
 type TemperatureUnitString = "CELSIUS" | "FAHRENHEIT" | "KELVIN";
 interface TemperatureFormat extends BaseFormat {
@@ -111,7 +139,7 @@ interface CustomFormat extends BaseFormat {
     formatter: FormatterFunction;
     options?: Record<string, unknown>;
 }
-type FieldFormat = TextFormat | NumberFormat | CurrencyFormat | DateFormat | BooleanFormat | EnergyFormat | TemperatureFormat | DistanceFormat | PhoneFormat | CustomFormat;
+type FieldFormat = TextFormat | NumberFormat | CurrencyFormat | DateFormat | BooleanFormat | EnergyFormat | PowerFormat | VoltageFormat | CurrentFormat | ResistanceFormat | TemperatureFormat | DistanceFormat | PhoneFormat | CustomFormat;
 
 /**
  * Boolean formatting utilities
@@ -150,16 +178,120 @@ declare const parseBoolean: (value: FieldValue) => boolean | null;
  */
 declare const formatBoolean: (value: FieldValue, format: BooleanFormat) => FormattedValue;
 
+/**
+ * Centralized formatting utility for UI components
+ * Used by Kpi, StatList, and other data display components
+ */
+
+/**
+ * Common formatter type used by data display components
+ * Can be either a custom function or a FieldFormat object
+ */
+type ComponentFormatter = ((value: FieldValue) => React__default.ReactNode) | FieldFormat;
+/**
+ * Options for formatting values in components
+ */
+interface ComponentFormatOptions {
+    /** The value to format */
+    value: FieldValue;
+    /** The formatter to apply */
+    formatter?: ComponentFormatter;
+    /** CSS class for null/empty values */
+    emptyClassName?: string;
+    /** Text to show for null/empty values */
+    emptyText?: React__default.ReactNode;
+}
+/**
+ * Format a value for display in a component
+ * Centralizes the logic used by Kpi, StatList, and similar components
+ *
+ * @example
+ * ```tsx
+ * // In a component
+ * const formatted = formatComponentValue({
+ *   value: 1500,
+ *   formatter: { type: "power" }
+ * });
+ * // Returns: "1.5 kW"
+ * ```
+ */
+declare function formatComponentValue({ value, formatter, emptyClassName, emptyText, }: ComponentFormatOptions): React__default.ReactNode;
+/**
+ * Hook for using the component formatter
+ * Provides memoization for better performance
+ *
+ * @example
+ * ```tsx
+ * function MyComponent({ value, formatter }) {
+ *   const format = useComponentFormatter(formatter);
+ *   const formatted = format(value);
+ *   return <span>{formatted}</span>;
+ * }
+ * ```
+ */
+declare function useComponentFormatter(formatter?: ComponentFormatter, emptyClassName?: string, emptyText?: React__default.ReactNode): (value: FieldValue) => React__default.ReactNode;
+
+/**
+ * Electrical current formatting utilities (flow of electric charge)
+ */
+
+/**
+ * Format as milliamps
+ */
+declare const toMilliamps: (value: number | null | undefined, decimals?: number) => string | null;
+/**
+ * Format as amperes
+ */
+declare const toAmps: (value: number | null | undefined, decimals?: number) => string | null;
+/**
+ * Format as kiloamps (rarely used but included for completeness)
+ */
+declare const toKiloamps: (value: number | null | undefined, decimals?: number) => string | null;
+/**
+ * Auto-scale current to the most appropriate unit
+ */
+declare const autoScaleCurrent: (value: number | null | undefined, decimals?: number) => string | null;
+/**
+ * Format current according to CurrentFormat specification
+ */
+declare const formatCurrent: (value: FieldValue, format: CurrentFormat) => FormattedValue;
+declare const toMA: (value: number | null | undefined, decimals?: number) => string | null;
+declare const toA: (value: number | null | undefined, decimals?: number) => string | null;
+declare const toKA: (value: number | null | undefined, decimals?: number) => string | null;
+
 /**
  * Date formatting utilities using Luxon
  */
 
 /**
- * Format date to string with various options
+ * Format date to a localized string with optional time and timezone.
+ *
+ * @param value - Date value (string, Date object, or timestamp)
+ * @param showTime - Whether to include time in the output (default: false)
+ * @param timezone - Optional timezone for display (e.g., "America/New_York")
+ * @returns Formatted date string or null
+ *
+ * @example
+ * ```typescript
+ * toDateString(new Date()); // "12/25/2023"
+ * toDateString(new Date(), true); // "12/25/2023, 3:30 PM"
+ * toDateString("2023-12-25T15:30:00Z", true, "America/New_York"); // "12/25/2023, 10:30 AM"
+ * ```
  */
 declare const toDateString: (value: string | Date | number | null | undefined, showTime?: boolean, timezone?: string) => string | null;
 /**
- * Format date to relative time (e.g., "2 hours ago")
+ * Format date to relative time (e.g., "2 hours ago", "in 3 days").
+ * Automatically chooses the most appropriate unit.
+ *
+ * @param value - Date value (string, Date object, or timestamp)
+ * @returns Relative time string or null
+ *
+ * @example
+ * ```typescript
+ * toRelativeTime(new Date(Date.now() - 3600000)); // "1 hour ago"
+ * toRelativeTime(new Date(Date.now() + 86400000)); // "in 1 day"
+ * toRelativeTime(new Date()); // "now"
+ * ```
  */
 declare const toRelativeTime: (value: string | Date | number | null | undefined) => string | null;
 /**
@@ -261,7 +393,9 @@ declare const autoScaleDistance: (value: number | null | undefined, metric?: boo
 declare const formatDistance: (value: FieldValue, format: DistanceFormat) => FormattedValue;
 
 /**
- * Energy, power, and electrical formatting utilities
+ * Energy formatting utilities (stored or consumed energy)
+ * For power (rate of energy), use power.ts
+ * For electrical units (voltage, current), use voltage.ts and current.ts
  */
 
 /**
@@ -284,50 +418,10 @@ declare const toGWh: (value: number | null | undefined, decimals?: number) => st
  * Auto-scale energy to the most appropriate unit
  */
 declare const autoScaleEnergy: (value: number | null | undefined, decimals?: number) => string | null;
-/**
- * Format as Watts
- */
-declare const toWatts: (value: number | null | undefined) => string | null;
-/**
- * Format as kilowatts
- */
-declare const tokW: (value: number | null | undefined, decimals?: number) => string | null;
-/**
- * Format as megawatts
- */
-declare const toMW: (value: number | null | undefined, decimals?: number) => string | null;
-/**
- * Auto-scale power to the most appropriate unit
- */
-declare const autoScalePower: (value: number | null | undefined, decimals?: number) => string | null;
 /**
  * Format energy according to EnergyFormat specification
  */
 declare const formatEnergy: (value: FieldValue, format: EnergyFormat) => FormattedValue;
-/**
- * Electrical units - Amperage
- */
-declare const toAmps: (value: number | null | undefined, decimals?: number) => string | null;
-/**
- * Electrical units - Voltage
- */
-declare const toVolts: (value: number | null | undefined) => string | null;
-/**
- * Electrical units - Millivolts
- */
-declare const toMillivolts: (value: number | null | undefined) => string | null;
-/**
- * Electrical units - Kilovolts
- */
-declare const toKilovolts: (value: number | null | undefined, decimals?: number) => string | null;
-/**
- * Electrical units - Ohms (resistance)
- */
-declare const toOhms: (value: number | null | undefined, decimals?: number) => string | null;
-/**
- * Electrical units - Milliohms
- */
-declare const toMilliohms: (value: number | null | undefined, decimals?: number) => string | null;
 
 /**
  * Number and currency formatting utilities
@@ -395,6 +489,39 @@ declare const formatPhoneNumber: (phone: string | null | undefined) => string |
  */
 declare const formatPhone: (value: FieldValue, format: PhoneFormat) => FormattedValue;
 
+/**
+ * Power formatting utilities (rate of energy transfer)
+ */
+
+/**
+ * Format as Watts
+ */
+declare const toWatts: (value: number | null | undefined, decimals?: number) => string | null;
+/**
+ * Format as kilowatts
+ */
+declare const toKilowatts: (value: number | null | undefined, decimals?: number) => string | null;
+/**
+ * Format as megawatts
+ */
+declare const toMegawatts: (value: number | null | undefined, decimals?: number) => string | null;
+/**
+ * Format as gigawatts
+ */
+declare const toGigawatts: (value: number | null | undefined, decimals?: number) => string | null;
+/**
+ * Auto-scale power to the most appropriate unit
+ */
+declare const autoScalePower: (value: number | null | undefined, decimals?: number) => string | null;
+/**
+ * Format power according to PowerFormat specification
+ */
+declare const formatPower: (value: FieldValue, format: PowerFormat) => FormattedValue;
+declare const toW: (value: number | null | undefined, decimals?: number) => string | null;
+declare const toKW: (value: number | null | undefined, decimals?: number) => string | null;
+declare const toMW: (value: number | null | undefined, decimals?: number) => string | null;
+declare const toGW: (value: number | null | undefined, decimals?: number) => string | null;
+
 /**
  * FormatRegistry - A singleton pattern for managing formatters
  * Allows registration and retrieval of formatting functions by key
@@ -439,6 +566,35 @@ declare class FormatRegistryClass {
 }
 declare const FormatRegistry: FormatRegistryClass;
 
+/**
+ * Electrical resistance formatting utilities
+ */
+
+/**
+ * Format as milliohms
+ */
+declare const toMilliohms: (value: number | null | undefined, decimals?: number) => string | null;
+/**
+ * Format as ohms
+ */
+declare const toOhms: (value: number | null | undefined, decimals?: number) => string | null;
+/**
+ * Format as kilohms
+ */
+declare const toKilohms: (value: number | null | undefined, decimals?: number) => string | null;
+/**
+ * Format as megohms
+ */
+declare const toMegohms: (value: number | null | undefined, decimals?: number) => string | null;
+/**
+ * Auto-scale resistance to the most appropriate unit
+ */
+declare const autoScaleResistance: (value: number | null | undefined, decimals?: number) => string | null;
+/**
+ * Format resistance according to ResistanceFormat specification
+ */
+declare const formatResistance: (value: FieldValue, format: ResistanceFormat) => FormattedValue;
+
 /**
  * Temperature formatting utilities
  */
@@ -505,11 +661,32 @@ declare const toUpperCase: (text: string | null | undefined) => string;
  */
 declare const toLowerCase: (text: string | null | undefined) => string;
 /**
- * Convert text to sentence case
+ * Convert text to sentence case (first letter capitalized, rest lowercase).
+ *
+ * @param text - Text to convert
+ * @returns Sentence-cased text
+ *
+ * @example
+ * ```typescript
+ * toSentenceCase("HELLO WORLD"); // "Hello world"
+ * toSentenceCase("hello world"); // "Hello world"
+ * ```
  */
 declare const toSentenceCase: (text: string | null | undefined) => string;
 /**
- * Convert text to title case
+ * Convert text to title case with proper handling of articles and prepositions.
+ * Capitalizes the first letter of each word except common articles/prepositions
+ * (unless they're the first word).
+ *
+ * @param text - Text to convert
+ * @returns Title-cased text
+ *
+ * @example
+ * ```typescript
+ * toTitleCase("the quick brown fox"); // "The Quick Brown Fox"
+ * toTitleCase("war and peace"); // "War and Peace"
+ * toTitleCase("to be or not to be"); // "To Be or Not to Be"
+ * ```
  */
 declare const toTitleCase: (text: string | null | undefined) => string;
 /**
@@ -553,6 +730,34 @@ declare const toSecret: (value: string | null | undefined) => string;
  */
 declare const formatText: (value: FieldValue, format: TextFormat) => FormattedValue;
 
+/**
+ * Voltage formatting utilities (electrical potential)
+ */
+
+/**
+ * Format as millivolts
+ */
+declare const toMillivolts: (value: number | null | undefined, decimals?: number) => string | null;
+/**
+ * Format as volts
+ */
+declare const toVolts: (value: number | null | undefined, decimals?: number) => string | null;
+/**
+ * Format as kilovolts
+ */
+declare const toKilovolts: (value: number | null | undefined, decimals?: number) => string | null;
+/**
+ * Auto-scale voltage to the most appropriate unit
+ */
+declare const autoScaleVoltage: (value: number | null | undefined, decimals?: number) => string | null;
+/**
+ * Format voltage according to VoltageFormat specification
+ */
+declare const formatVoltage: (value: FieldValue, format: VoltageFormat) => FormattedValue;
+declare const toMV: (value: number | null | undefined, decimals?: number) => string | null;
+declare const toV: (value: number | null | undefined, decimals?: number) => string | null;
+declare const toKV: (value: number | null | undefined, decimals?: number) => string | null;
+
 /**
  * Comprehensive formatting utilities for the Edges design system
  *
@@ -822,6 +1027,12 @@ interface AreaSeriesProps {
     label?: string;
     categoryColors?: Record<string, string>;
 }
+/**
+ * AreaSeries
+ *
+ * Chart component for rendering area charts with gradient fill.
+ * Displays data as a filled area with optional line path, supporting animations and custom colors.
+ */
 declare const AreaSeries: React__default.FC<AreaSeriesProps>;
 
 interface BarSeriesProps {
@@ -831,6 +1042,12 @@ interface BarSeriesProps {
     opacity?: number;
     categoryColors?: Record<string, string>;
 }
+/**
+ * BarSeries
+ *
+ * Chart component for rendering bar/column charts.
+ * Displays data as vertical bars with customizable colors, opacity, and category-based coloring.
+ */
 declare const BarSeries: React__default.FC<BarSeriesProps>;
 
 interface AxisBottomProps {
@@ -843,6 +1060,12 @@ interface AxisLeftProps {
     scale: ScaleLinear<number, number>;
     yFormatType: YFormatType;
 }
+/**
+ * ChartAxis
+ *
+ * Chart axis components for rendering X and Y axes.
+ * Provides formatted bottom (time) and left (numeric) axes with customizable tick formatting.
+ */
 declare const ChartAxis: {
     Bottom: React__default.FC<AxisBottomProps>;
     Left: React__default.FC<AxisLeftProps>;
@@ -862,7 +1085,30 @@ interface ChartExportMetadata {
     timestamp?: boolean;
 }
 /**
- * Main export function that handles all export types
+ * Main export function that handles all chart export types.
+ * Supports CSV, SVG, and PNG formats with automatic filename generation.
+ *
+ * @param type - Export format: "csv", "svg", or "png"
+ * @param datasets - Chart data as single array or array of arrays for multi-series
+ * @param metadata - Export metadata including labels and filename options
+ * @param svgRef - Reference to the chart's SVG element
+ * @returns Promise that resolves when export is complete
+ *
+ * @example
+ * ```typescript
+ * // Export single series as CSV
+ * await exportChart("csv", data, {
+ *   xLabel: "Date",
+ *   yLabel: "Value",
+ *   filename: "sales-data"
+ * }, svgRef);
+ *
+ * // Export multi-series chart as PNG
+ * await exportChart("png", [series1, series2], {
+ *   seriesLabels: ["Revenue", "Profit"],
+ *   timestamp: false
+ * }, svgRef);
+ * ```
  */
 declare function exportChart(type: ExportType, datasets: BaseDataPoint[][] | BaseDataPoint[], metadata: ChartExportMetadata | undefined, svgRef: React__default.RefObject<SVGSVGElement>): Promise<void>;
 /**
@@ -882,6 +1128,12 @@ interface ChartBottomBarProps {
     items: LegendItem[];
     onExport: (type: ExportType) => void | Promise<void>;
 }
+/**
+ * ChartBottomBar
+ *
+ * Chart footer component with legend and export functionality.
+ * Displays color-coded legend items and provides export options for CSV, SVG, and PNG formats.
+ */
 declare const ChartBottomBar: React__default.FC<ChartBottomBarProps>;
 
 interface ChartContainerProps {
@@ -891,12 +1143,24 @@ interface ChartContainerProps {
     yFormatType?: YFormatType;
     isLoading?: boolean;
 }
+/**
+ * ChartContainer
+ *
+ * Main chart wrapper component that provides context and layout for chart visualizations.
+ * Handles scaling, tooltips, axes, and data management for area, line, and bar charts.
+ */
 declare const ChartContainer: React__default.FC<Omit<ChartContainerProps, "parentWidth" | "parentHeight">>;
 
 interface ChartTooltipProps {
     data: TooltipData | null;
     formatType: YFormatType;
 }
+/**
+ * ChartTooltip
+ *
+ * Interactive tooltip component for charts.
+ * Displays formatted data values at hover position with automatic positioning and animations.
+ */
 declare const ChartTooltip: React__default.FC<ChartTooltipProps>;
 
 interface LineSeriesProps {
@@ -908,6 +1172,12 @@ interface LineSeriesProps {
     strokeDasharray?: string;
     categoryColors?: Record<string, string>;
 }
+/**
+ * LineSeries
+ *
+ * Chart component for rendering line charts.
+ * Displays data as a continuous line with customizable stroke width, color, and dash patterns.
+ */
 declare const LineSeries: React__default.FC<LineSeriesProps>;
 
 type SortDirection = "asc" | "desc";
@@ -981,6 +1251,9 @@ interface DataTableProps<T> {
     "aria-label"?: string;
 }
 
+/**
+ * Action configuration for ActionCell
+ */
 interface Action<T = any> {
     id: string;
     label?: string;
@@ -995,6 +1268,12 @@ interface ActionCellProps<T = any> extends CellComponentProps<T> {
     align?: "left" | "center" | "right";
     size?: "sm" | "md" | "lg";
 }
+/**
+ * ActionCell
+ *
+ * DataTable cell component for rendering action buttons within table rows.
+ * Supports multiple actions with icons, labels, and conditional visibility/disabled states.
+ */
 declare function ActionCell<T = any>({ row, context, actions, align, size, }: ActionCellProps<T>): react_jsx_runtime.JSX.Element | null;
 
 interface BooleanCellProps<T = any> extends CellComponentProps<T> {
@@ -1007,6 +1286,12 @@ interface BooleanCellProps<T = any> extends CellComponentProps<T> {
     align?: "left" | "center" | "right";
     emphasis?: CellEmphasis;
 }
+/**
+ * BooleanCell
+ *
+ * DataTable cell component for displaying boolean values.
+ * Supports multiple display formats including icons, text, or badges with customizable true/false representations.
+ */
 declare function BooleanCell<T = any>({ value, context, format, trueText, falseText, trueIcon, falseIcon, showFalse, align, emphasis, }: BooleanCellProps<T>): react_jsx_runtime.JSX.Element | null;
 
 /**
@@ -1065,6 +1350,12 @@ interface DateCellProps<T = any> extends CellComponentProps<T> {
     href?: string | ((row: T) => string);
     linkBehavior?: LinkBehavior;
 }
+/**
+ * DateCell
+ *
+ * DataTable cell component for displaying date and time values.
+ * Supports multiple formats including relative time, with optional linking capabilities.
+ */
 declare function DateCell<T = any>({ value, row, context, format, customFormat, emptyText, align, emphasis, href, linkBehavior, }: DateCellProps<T>): react_jsx_runtime.JSX.Element;
 
 interface NumberCellProps<T = any> extends CellComponentProps<T> {
@@ -1080,6 +1371,12 @@ interface NumberCellProps<T = any> extends CellComponentProps<T> {
     showPositiveSign?: boolean;
     colorCode?: boolean;
 }
+/**
+ * NumberCell
+ *
+ * DataTable cell component for displaying numeric values.
+ * Supports currency, percentage, and compact formatting with optional color coding for positive/negative values.
+ */
 declare function NumberCell<T = any>({ value, row, context, format, decimals, prefix, suffix, emptyText, align, emphasis, href, linkBehavior, showPositiveSign, colorCode, }: NumberCellProps<T>): react_jsx_runtime.JSX.Element;
 
 interface SelectCellProps<T = any> extends CellComponentProps<T> {
@@ -1088,6 +1385,12 @@ interface SelectCellProps<T = any> extends CellComponentProps<T> {
     isDisabled?: boolean | ((row: T) => boolean);
     align?: "left" | "center" | "right";
 }
+/**
+ * SelectCell
+ *
+ * DataTable cell component for row selection.
+ * Renders a checkbox that allows users to select individual rows in the table.
+ */
 declare function SelectCell<T = any>({ row, context, isSelected, onSelect, isDisabled, align, }: SelectCellProps<T>): react_jsx_runtime.JSX.Element;
 
 interface TextCellProps<T = any> extends CellComponentProps<T> {
@@ -1100,8 +1403,20 @@ interface TextCellProps<T = any> extends CellComponentProps<T> {
     truncate?: boolean;
     align?: "left" | "center" | "right";
 }
+/**
+ * TextCell
+ *
+ * DataTable cell component for displaying text content.
+ * Supports prefixes, suffixes, truncation, and optional linking with customizable emphasis levels.
+ */
 declare function TextCell<T = any>({ value, row, context, prefix, suffix, emptyText, href, linkBehavior, emphasis, truncate, align, }: TextCellProps<T>): react_jsx_runtime.JSX.Element;
 
+/**
+ * DataTable
+ *
+ * Advanced table component with sorting, filtering, pagination, and mobile-responsive views.
+ * Supports custom cell renderers, column configurations, and multiple display densities.
+ */
 declare function DataTable<T extends Record<string, unknown>>({ columns, data, className, density, width, height, maxHeight, layout, mobileRenderer, customMobileRowRender, mobileBreakpoint, isLoading, loadingRowCount, stickyHeader, onRowClick, getRowId, hideHeader, onSort, "aria-label": ariaLabel, }: DataTableProps<T>): react_jsx_runtime.JSX.Element;
 
 interface MobileRowProps<T> {
@@ -1204,12 +1519,18 @@ interface State {
     hasError: boolean;
     error?: Error;
 }
+/**
+ * ErrorBoundary
+ *
+ * React error boundary component for graceful error handling.
+ * Catches JavaScript errors in child components and displays a fallback UI with retry option.
+ */
 declare class ErrorBoundary extends Component<Props, State> {
     state: State;
     static getDerivedStateFromError(error: Error): State;
     componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
     private handleRetry;
-    render(): string | number | boolean | react_jsx_runtime.JSX.Element | Iterable<ReactNode> | null | undefined;
+    render(): string | number | boolean | Iterable<ReactNode> | react_jsx_runtime.JSX.Element | null | undefined;
 }
 
 interface InputStyleProps {
@@ -1498,6 +1819,7 @@ declare namespace Grid {
 }
 declare function GridItem({ span, className, children, }: GridItemProps): react_jsx_runtime.JSX.Element;
 
+type KpiFormatter = ComponentFormatter;
 /**
  * Kpi Component — Single metric display
  *
@@ -1527,10 +1849,8 @@ interface KpiProps {
     label: React__default.ReactNode;
     /** Primary value - number for auto-formatting or string for custom display */
     value: number | string;
-    /** Unit suffix (e.g., "kW", "%", "$") */
-    unit?: string;
-    /** Intl.NumberFormat options for numeric values */
-    format?: Intl.NumberFormatOptions;
+    /** Formatter using the unified formatting system */
+    formatter?: KpiFormatter;
     /** Change since prior period */
     delta?: number;
     /** Description of delta period (e.g., "vs last 7d") */
@@ -1567,7 +1887,7 @@ interface KpiProps {
     /** Custom trend renderer */
     renderTrend?: (points?: TrendPoint[]) => React__default.ReactNode;
 }
-declare function Kpi({ label, value, unit, format, delta, deltaPeriodLabel, deltaIntent, trend, status, helpText, size, orientation, loading, empty, error, onClick, className, renderValue, renderDelta, renderTrend, }: KpiProps): react_jsx_runtime.JSX.Element;
+declare function Kpi({ label, value, formatter, delta, deltaPeriodLabel, deltaIntent, trend, status, helpText, size, orientation, loading, empty, error, onClick, className, renderValue, renderDelta, renderTrend, }: KpiProps): react_jsx_runtime.JSX.Element;
 
 /**
  * KpiGroup Component — Layout container for multiple KPIs
@@ -1847,19 +2167,20 @@ type PageFiltersProps = {
     ariaLabel?: string;
 };
 declare function Filters({ children, className, ariaLabel }: PageFiltersProps): react_jsx_runtime.JSX.Element;
-type Tab$1 = {
+type PageLayoutTab = {
     id: string;
     label: React$1.ReactNode;
     disabled?: boolean;
 };
-type TabsProps = {
-    tabs: Tab$1[];
+type TabsProps$1 = {
+    tabs: PageLayoutTab[];
     value?: string;
     defaultValue?: string;
     onChange?: (id: string) => void;
     className?: string;
+    children?: React$1.ReactNode;
 };
-declare function Tabs$1({ tabs, value, defaultValue, onChange, className }: TabsProps): react_jsx_runtime.JSX.Element;
+declare function Tabs$1({ tabs, value, defaultValue, onChange, className, children }: TabsProps$1): react_jsx_runtime.JSX.Element;
 type PageContentProps = {
     children: React$1.ReactNode;
     className?: string;
@@ -2067,6 +2388,12 @@ interface SkeletonProps {
     className?: string;
     "data-testid"?: string;
 }
+/**
+ * Skeleton
+ *
+ * Loading placeholder component that mimics content structure.
+ * Supports various shapes, animations, and responsive configurations for skeleton screens.
+ */
 declare const Skeleton: React__default.FC<SkeletonProps>;
 
 interface SliderProps {
@@ -2139,44 +2466,16 @@ declare function Main({ className, children }: SplitPanePanelProps): react_jsx_r
 declare function Aside({ className, children }: SplitPanePanelProps): react_jsx_runtime.JSX.Element;
 
 /**
- * StatList Component — Compact key-value statistics display
- *
- * Display a list of labeled statistics with formatting, status indicators,
- * and optional actions. Perfect for detail panels, inspectors, and spec sheets.
+ * StatList — Compact key-value statistics display
  *
- * Usage:
- * ```tsx
- * <StatList
- *   items={[
- *     { id: "voltage", label: "Voltage", value: 241, unit: "V" },
- *     { id: "status", label: "Status", value: "Online", tone: "success" },
- *     { id: "updated", label: "Last Update", value: new Date() }
- *   ]}
- * />
- * ```
+ * Displays formatted statistics with status indicators and optional copy functionality.
+ * Uses the unified formatting system for consistent data presentation.
  */
 type StatTone = "neutral" | "success" | "warning" | "error" | "info";
 type StatAlign = "start" | "end";
 type StatLayout = "one-column" | "two-column";
-type StatValue = string | number | boolean | Date | null | undefined;
-type StatFormatter = ((value: StatValue) => React__default.ReactNode) | {
-    type: "number";
-    options?: Intl.NumberFormatOptions;
-    unit?: string;
-} | {
-    type: "date";
-    options?: Intl.DateTimeFormatOptions;
-} | {
-    type: "duration";
-    base?: "seconds" | "ms";
-} | {
-    type: "bool";
-    trueLabel?: string;
-    falseLabel?: string;
-} | {
-    type: "string";
-    transform?: "uppercase" | "lowercase" | "capitalize";
-};
+type StatValue = FieldValue;
+type StatFormatter = ComponentFormatter;
 interface StatThreshold {
     when: (value: StatValue) => boolean;
     tone: StatTone;
@@ -2190,8 +2489,6 @@ interface StatItem {
     value: StatValue;
     /** Custom formatter for the value */
     formatter?: StatFormatter;
-    /** Unit to append to formatted value */
-    unit?: string;
     /** Additional metadata below value */
     meta?: React__default.ReactNode;
     /** Explicit tone/status color */
@@ -2232,30 +2529,42 @@ interface StatListProps {
     error?: string | React__default.ReactNode;
     /** Additional CSS classes */
     className?: string;
-    /** Copy callback */
-    onCopy?: (text: string, id: string) => void;
 }
-declare function StatList({ items, layout, dense, valueAlign, showDividers, skeleton, empty, error, className, onCopy, }: StatListProps): react_jsx_runtime.JSX.Element;
+declare function StatList({ items, layout, dense, valueAlign, showDividers, skeleton, empty, error, className, }: StatListProps): react_jsx_runtime.JSX.Element;
 
 interface SwitchProps extends Omit<SwitchProps$1, "children"> {
     children: React__default.ReactNode;
 }
+/**
+ * Switch
+ *
+ * Toggle switch component for binary on/off states.
+ * Provides an accessible alternative to checkboxes for settings and preferences.
+ */
 declare function Switch({ children, ...props }: SwitchProps): react_jsx_runtime.JSX.Element;
 
+type TabVariant = "default" | "accent";
 type TabProps = TabProps$1 & {
     isSelected?: boolean;
     id?: string;
 };
+type TabsProps = TabsProps$2 & {
+    variant?: TabVariant;
+};
+type TabListProps<T extends object> = TabListProps$1<T> & {
+    variant?: TabVariant;
+};
 /**
  * Tabs
  *
  * Tabbed interface with styled tabs and panels.
+ * @param variant - "default" for gray styling, "accent" for brand color styling
  */
-declare function Tabs(props: TabsProps$1): react_jsx_runtime.JSX.Element;
+declare function Tabs({ variant, ...props }: TabsProps): react_jsx_runtime.JSX.Element;
 /**
  * TabList container.
  */
-declare function TabList<T extends object>(props: TabListProps<T>): react_jsx_runtime.JSX.Element;
+declare function TabList<T extends object>({ variant, ...props }: TabListProps<T>): react_jsx_runtime.JSX.Element;
 /**
  * Tab trigger element.
  */
@@ -2312,6 +2621,12 @@ interface TextAreaWithChipsProps extends Omit<React__default.TextareaHTMLAttribu
     chipVariant?: "default" | "primary" | "secondary";
     chipSize?: Size;
 }
+/**
+ * TextAreaWithChips
+ *
+ * Enhanced textarea component with chip/tag support.
+ * Enables rich text input with embedded chips for mentions, tags, or structured data entry.
+ */
 declare function TextAreaWithChips({ label, description, errorMessage, size, tooltip, required, transparent, isInvalid, isDisabled, className, validationResult, value, onChange, chips, onChipsChange, triggerPattern, onTriggerDetected, onTriggerDismissed, renderChip, chipVariant, chipSize, ...props }: TextAreaWithChipsProps): react_jsx_runtime.JSX.Element;
 
 /**
@@ -2408,4 +2723,4 @@ interface ColorModeProviderProps {
 }
 declare const ColorModeProvider: React.FC<ColorModeProviderProps>;
 
-export { type Action, ActionCell, type ActionCellProps, AreaSeries, AutoMobileRenderer, Autocomplete, BarSeries, BaseDataPoint, type BaseFormat, type BaseInputProps, type BaseProps, BooleanCell, type BooleanCellProps, type BooleanFormat, Breadcrumb, type BreadcrumbItem, Breadcrumbs, Button, Calendar, CardMobileRenderer, type CellAlignment, type CellComponent, type CellComponentProps, type CellContext, type CellEmphasis, ChartAxis, ChartBottomBar, ChartContainer, type ChartExportMetadata, ChartTooltip, Checkbox, CheckboxGroup, Chip, ClearButton, ColorModeProvider, type Column, CopyToClipboard, type CurrencyFormat, type CustomFormat, DataTable, type DataTableProps, DateCell, type DateCellProps, type DateFormat, type DateFormatStyle, DateRangePicker, Description, type DescriptionProps, Dialog, DialogHeader, type DistanceFormat, type DistanceUnit, Drawer, type EnergyFormat, type EnergyUnit, ErrorBoundary, type ExportType, FieldError, type FieldErrorProps, type FieldFormat, FieldGroup, type FieldGroupProps, type FieldValue, Form, FormatRegistry, type FormattedValue, type FormatterFunction, Grid, type GridAlign, type GridCols, type GridFlow, type GridGap, type GridItemProps, type GridJustify, type GridProps, type GridSpan, Icon, Input, type InputProps, type InputStyleProps, InputWrapper, Kpi, KpiGroup, type KpiGroupAlign, type KpiGroupCols, type KpiGroupGap, type KpiGroupProps, type KpiOrientation, type KpiProps, type KpiSize, type KpiStatus, Label, type LabelProps, LineSeries, type LinkBehavior, ListBox, ListBoxItem, type MobileBreakpoint, type MobileConfig, type MobileRenderer, Notice, NoticeContainer, type NoticeContainerProps, type NoticeOptions, type NoticeProps, NoticeProvider, type NoticeProviderProps, type NoticeVariant, NumberCell, type NumberCellProps, NumberField, type NumberFormat, type PageActionsProps, type PageAsideProps, type PageContentProps, type PageFiltersProps, type PageHeaderProps, PageLayout, type PageLayoutProps, type PhoneFormat, PlaceSearch, Popover, ProgressBar, Radio, RadioGroup, RangeCalendar, type ResponsiveValue, SKELETON_SIZES, Section, type SectionProps, type SectionSpacing, type SectionVariant, Select, SelectCell, type SelectCellProps, Skeleton, Slider, type SortConfig, type SortDirection, SplitPane, type SplitPaneOrientation, type SplitPanePanelProps, type SplitPaneProps, type StatAlign, type StatFormatter, type StatItem, type StatLayout, StatList, type StatListProps, type StatThreshold, type StatTone, type StatValue, Switch, Tab, TabList, TabPanel, type TableDensity, type TableLayout, type TableWidth, Tabs, type TabsProps, type TemperatureFormat, type TemperatureUnit, type TemperatureUnitString, TextArea, TextAreaWithChips, TextCell, type TextCellProps, TextField, type TextFormat, type TextTransform, type TextTruncatePosition, TimeField, ToggleButton, Tooltip, TooltipData, type TrendPoint, YFormatType, autoScaleDistance, autoScaleEnergy, autoScalePower, camelCaseToWords, capitalize, celsiusToFahrenheit, celsiusToKelvin, centimetersToInches, createFormat, enumToSentenceCase, exportChart, fahrenheitToCelsius, fahrenheitToKelvin, feetToMeters, feetToMiles, formatBoolean, formatCurrency, formatDate, formatDistance, formatEmptyValue, formatEnergy, formatFieldValue, formatInternationalPhone, formatNumber, formatPhone, formatPhoneNumber, formatTemperature, formatText, formatUSPhone, getBadgeClasses, getBooleanBadgeVariant, getCellAlignmentClasses, getCellContainerClasses, getCellTextClasses, getDateParts, getExportFormatName, getFieldGroupStyles, getInputBackgroundStyles, getInputBaseStyles, getInputStateStyles, getNumericColorClasses, getSkeletonSize, inchesToCentimeters, isExportSupported, isNil, kelvinToCelsius, kelvinToFahrenheit, kilometersToMiles, metersToFeet, metersToMiles, metersToYards, milesToFeet, milesToKilometers, milesToMeters, parseBoolean, resolveValue, snakeCaseToWords, temperatureStringToSymbol, toActiveInactive, toAmps, toBoolean, toCelsius, toCentimeters, toCheckmark, toCompactNumber, toCurrency, toCustomDateFormat, toDateString, toEnabledDisabled, toFahrenheit, toFeet, toFloat, toFormattedNumber, toFullDateTime, toGWh, toISOString, toInches, toInteger, toKelvin, toKilometers, toKilovolts, toLowerCase, toMW, toMWh, toMeters, toMiles, toMillimeters, toMilliohms, toMillivolts, toNauticalMiles, toOhms, toOnOff, toPercentage, toRelativeTime, toScientificNotation, toSecret, toSentenceCase, toTemperature, toTitleCase, toTrueFalse, toUpperCase, toVolts, toWatts, toWh, toYards, tokW, tokWh, truncateEnd, truncateMiddle, truncateStart, ucFirst, useColorMode, useDebounce, useInputFocus, useLocalStorage, useNotice, yardsToMeters };
+export { type Action, ActionCell, type ActionCellProps, AreaSeries, AutoMobileRenderer, Autocomplete, BarSeries, BaseDataPoint, type BaseFormat, type BaseInputProps, type BaseProps, BooleanCell, type BooleanCellProps, type BooleanFormat, Breadcrumb, type BreadcrumbItem, Breadcrumbs, Button, Calendar, CardMobileRenderer, type CellAlignment, type CellComponent, type CellComponentProps, type CellContext, type CellEmphasis, ChartAxis, ChartBottomBar, ChartContainer, type ChartExportMetadata, ChartTooltip, Checkbox, CheckboxGroup, Chip, ClearButton, ColorModeProvider, type Column, type ComponentFormatOptions, type ComponentFormatter, CopyToClipboard, type CurrencyFormat, type CurrentFormat, type CurrentUnit, type CustomFormat, DataTable, type DataTableProps, DateCell, type DateCellProps, type DateFormat, type DateFormatStyle, DateRangePicker, Description, type DescriptionProps, Dialog, DialogHeader, type DistanceFormat, type DistanceUnit, Drawer, type EnergyFormat, type EnergyUnit, ErrorBoundary, type ExportType, FieldError, type FieldErrorProps, type FieldFormat, FieldGroup, type FieldGroupProps, type FieldValue, Form, FormatRegistry, type FormattedValue, type FormatterFunction, Grid, type GridAlign, type GridCols, type GridFlow, type GridGap, type GridItemProps, type GridJustify, type GridProps, type GridSpan, Icon, Input, type InputProps, type InputStyleProps, InputWrapper, Kpi, KpiGroup, type KpiGroupAlign, type KpiGroupCols, type KpiGroupGap, type KpiGroupProps, type KpiOrientation, type KpiProps, type KpiSize, type KpiStatus, Label, type LabelProps, LineSeries, type LinkBehavior, ListBox, ListBoxItem, type MobileBreakpoint, type MobileConfig, type MobileRenderer, Notice, NoticeContainer, type NoticeContainerProps, type NoticeOptions, type NoticeProps, NoticeProvider, type NoticeProviderProps, type NoticeVariant, NumberCell, type NumberCellProps, NumberField, type NumberFormat, type PageActionsProps, type PageAsideProps, type PageContentProps, type PageFiltersProps, type PageHeaderProps, PageLayout, type PageLayoutProps, type PhoneFormat, PlaceSearch, Popover, type PowerFormat, type PowerUnit, ProgressBar, Radio, RadioGroup, RangeCalendar, type ResistanceFormat, type ResistanceUnit, type ResponsiveValue, SKELETON_SIZES, Section, type SectionProps, type SectionSpacing, type SectionVariant, Select, SelectCell, type SelectCellProps, Skeleton, Slider, type SortConfig, type SortDirection, SplitPane, type SplitPaneOrientation, type SplitPanePanelProps, type SplitPaneProps, type StatAlign, type StatFormatter, type StatItem, type StatLayout, StatList, type StatListProps, type StatThreshold, type StatTone, type StatValue, Switch, Tab, TabList, TabPanel, type TableDensity, type TableLayout, type TableWidth, Tabs, type TabsProps$1 as TabsProps, type TemperatureFormat, type TemperatureUnit, type TemperatureUnitString, TextArea, TextAreaWithChips, TextCell, type TextCellProps, TextField, type TextFormat, type TextTransform, type TextTruncatePosition, TimeField, ToggleButton, Tooltip, TooltipData, type TrendPoint, type VoltageFormat, type VoltageUnit, YFormatType, autoScaleCurrent, autoScaleDistance, autoScaleEnergy, autoScalePower, autoScaleResistance, autoScaleVoltage, camelCaseToWords, capitalize, celsiusToFahrenheit, celsiusToKelvin, centimetersToInches, createFormat, enumToSentenceCase, exportChart, fahrenheitToCelsius, fahrenheitToKelvin, feetToMeters, feetToMiles, formatBoolean, formatComponentValue, formatCurrency, formatCurrent, formatDate, formatDistance, formatEmptyValue, formatEnergy, formatFieldValue, formatInternationalPhone, formatNumber, formatPhone, formatPhoneNumber, formatPower, formatResistance, formatTemperature, formatText, formatUSPhone, formatVoltage, getBadgeClasses, getBooleanBadgeVariant, getCellAlignmentClasses, getCellContainerClasses, getCellTextClasses, getDateParts, getExportFormatName, getFieldGroupStyles, getInputBackgroundStyles, getInputBaseStyles, getInputStateStyles, getNumericColorClasses, getSkeletonSize, inchesToCentimeters, isExportSupported, isNil, kelvinToCelsius, kelvinToFahrenheit, kilometersToMiles, metersToFeet, metersToMiles, metersToYards, milesToFeet, milesToKilometers, milesToMeters, parseBoolean, resolveValue, snakeCaseToWords, temperatureStringToSymbol, toA, toActiveInactive, toAmps, toBoolean, toCelsius, toCentimeters, toCheckmark, toCompactNumber, toCurrency, toCustomDateFormat, toDateString, toEnabledDisabled, toFahrenheit, toFeet, toFloat, toFormattedNumber, toFullDateTime, toGW, toGWh, toGigawatts, toISOString, toInches, toInteger, toKA, toKV, toKW, toKelvin, toKiloamps, toKilohms, toKilometers, toKilovolts, toKilowatts, toLowerCase, toMA, toMV, toMW, toMWh, toMegawatts, toMegohms, toMeters, toMiles, toMilliamps, toMillimeters, toMilliohms, toMillivolts, toNauticalMiles, toOhms, toOnOff, toPercentage, toRelativeTime, toScientificNotation, toSecret, toSentenceCase, toTemperature, toTitleCase, toTrueFalse, toUpperCase, toV, toVolts, toW, toWatts, toWh, toYards, tokWh, truncateEnd, truncateMiddle, truncateStart, ucFirst, useColorMode, useComponentFormatter, useDebounce, useInputFocus, useLocalStorage, useNotice, yardsToMeters };