@iris-ui-kit/react 0.2.0 → 0.2.2

package/dist/index.d.cts

@@ -661,6 +661,7 @@ declare function IrisCarousel({ children, index: indexProp, defaultIndex, onInde
 
 type IrisStatisticSize = 'sm' | 'md' | 'lg';
 type IrisStatisticTrend = 'up' | 'down' | 'neutral';
+type IrisStatisticTone = 'success' | 'danger' | 'neutral';
 interface IrisStatisticProps {
     label?: React.ReactNode;
     value: React.ReactNode;
@@ -673,6 +674,11 @@ interface IrisStatisticProps {
     trend?: IrisStatisticTrend;
     /** Trend magnitude text (e.g. "12%"). */
     trendValue?: React.ReactNode;
+    /**
+     * Override the trend arrow color (defaults to direction semantics:
+     * up=success, down=danger). Use for cost/risk KPIs where "up" is bad.
+     */
+    trendTone?: IrisStatisticTone;
     size?: IrisStatisticSize;
     style?: React.CSSProperties;
     className?: string;
@@ -685,7 +691,7 @@ interface IrisStatisticProps {
  *
  * React port of {@link import('@iris-ui-kit/vue').IrisStatistic}.
  */
-declare function IrisStatistic({ label, value, prefix, suffix, description, trend, trendValue, size, style, className, ...rest }: IrisStatisticProps): React.ReactElement;
+declare function IrisStatistic({ label, value, prefix, suffix, description, trend, trendTone, trendValue, size, style, className, ...rest }: IrisStatisticProps): React.ReactElement;
 
 type IrisDescriptionsLayout = 'horizontal' | 'vertical';
 interface IrisDescriptionsItem {
@@ -1264,6 +1270,11 @@ interface IrisGaugeProps {
     /** Diameter in px. */
     size?: number;
     strokeWidth?: number;
+    /**
+     * Semantic status — drives the stroke color. Explicit by design (honesty
+     * preserved): for threshold-based decision support, derive it yourself,
+     * e.g. `status={value > 80 ? 'danger' : value > 60 ? 'warning' : 'success'}`.
+     */
     status?: IrisGaugeStatus;
     showValue?: boolean;
     /** Custom center label given the value and rounded percent. */
@@ -2450,6 +2461,8 @@ interface IrisTableProps<Row extends Record<string, unknown> = Record<string, un
     loadingState?: ReactNode;
     /** Custom error-state node. */
     errorState?: ReactNode;
+    /** Fired by the built-in Retry button in the error state row. */
+    onRetry?: () => void;
     style?: CSSProperties;
     className?: string;
 }
@@ -2461,7 +2474,7 @@ interface IrisTableProps<Row extends Record<string, unknown> = Record<string, un
  *
  * Sortable columns cycle `none → asc → desc → none` on click.
  */
-declare function IrisTable<Row extends Record<string, unknown>>({ columns, data, rowKey, selectable, selection: selectionProp, defaultSelection, onSelectionChange, sort: sortProp, defaultSort, onSortChange, striped, bordered, resizableColumns, columnWidths: columnWidthsProp, defaultColumnWidths, onColumnWidthsChange, onRowClick, onCellEdit, renderDetail, rowExpandable, defaultExpandedRowKeys, onExpandedRowsChange, getSubRows, keyboardNavigation, cellRange, virtualScroll, columnVirtualization, emptyState, loading, error, loadingState, errorState, style, className, ...rest }: IrisTableProps<Row>): React.ReactElement;
+declare function IrisTable<Row extends Record<string, unknown>>({ columns, data, rowKey, selectable, selection: selectionProp, defaultSelection, onSelectionChange, sort: sortProp, defaultSort, onSortChange, striped, bordered, resizableColumns, columnWidths: columnWidthsProp, defaultColumnWidths, onColumnWidthsChange, onRowClick, onCellEdit, renderDetail, rowExpandable, defaultExpandedRowKeys, onExpandedRowsChange, getSubRows, keyboardNavigation, cellRange, virtualScroll, columnVirtualization, emptyState, loading, error, loadingState, errorState, onRetry, style, className, ...rest }: IrisTableProps<Row>): React.ReactElement;
 
 /**
  * Serialize rows as a CSV string per RFC 4180. Column order determines field

package/dist/index.d.ts

@@ -661,6 +661,7 @@ declare function IrisCarousel({ children, index: indexProp, defaultIndex, onInde
 
 type IrisStatisticSize = 'sm' | 'md' | 'lg';
 type IrisStatisticTrend = 'up' | 'down' | 'neutral';
+type IrisStatisticTone = 'success' | 'danger' | 'neutral';
 interface IrisStatisticProps {
     label?: React.ReactNode;
     value: React.ReactNode;
@@ -673,6 +674,11 @@ interface IrisStatisticProps {
     trend?: IrisStatisticTrend;
     /** Trend magnitude text (e.g. "12%"). */
     trendValue?: React.ReactNode;
+    /**
+     * Override the trend arrow color (defaults to direction semantics:
+     * up=success, down=danger). Use for cost/risk KPIs where "up" is bad.
+     */
+    trendTone?: IrisStatisticTone;
     size?: IrisStatisticSize;
     style?: React.CSSProperties;
     className?: string;
@@ -685,7 +691,7 @@ interface IrisStatisticProps {
  *
  * React port of {@link import('@iris-ui-kit/vue').IrisStatistic}.
  */
-declare function IrisStatistic({ label, value, prefix, suffix, description, trend, trendValue, size, style, className, ...rest }: IrisStatisticProps): React.ReactElement;
+declare function IrisStatistic({ label, value, prefix, suffix, description, trend, trendTone, trendValue, size, style, className, ...rest }: IrisStatisticProps): React.ReactElement;
 
 type IrisDescriptionsLayout = 'horizontal' | 'vertical';
 interface IrisDescriptionsItem {
@@ -1264,6 +1270,11 @@ interface IrisGaugeProps {
     /** Diameter in px. */
     size?: number;
     strokeWidth?: number;
+    /**
+     * Semantic status — drives the stroke color. Explicit by design (honesty
+     * preserved): for threshold-based decision support, derive it yourself,
+     * e.g. `status={value > 80 ? 'danger' : value > 60 ? 'warning' : 'success'}`.
+     */
     status?: IrisGaugeStatus;
     showValue?: boolean;
     /** Custom center label given the value and rounded percent. */
@@ -2450,6 +2461,8 @@ interface IrisTableProps<Row extends Record<string, unknown> = Record<string, un
     loadingState?: ReactNode;
     /** Custom error-state node. */
     errorState?: ReactNode;
+    /** Fired by the built-in Retry button in the error state row. */
+    onRetry?: () => void;
     style?: CSSProperties;
     className?: string;
 }
@@ -2461,7 +2474,7 @@ interface IrisTableProps<Row extends Record<string, unknown> = Record<string, un
  *
  * Sortable columns cycle `none → asc → desc → none` on click.
  */
-declare function IrisTable<Row extends Record<string, unknown>>({ columns, data, rowKey, selectable, selection: selectionProp, defaultSelection, onSelectionChange, sort: sortProp, defaultSort, onSortChange, striped, bordered, resizableColumns, columnWidths: columnWidthsProp, defaultColumnWidths, onColumnWidthsChange, onRowClick, onCellEdit, renderDetail, rowExpandable, defaultExpandedRowKeys, onExpandedRowsChange, getSubRows, keyboardNavigation, cellRange, virtualScroll, columnVirtualization, emptyState, loading, error, loadingState, errorState, style, className, ...rest }: IrisTableProps<Row>): React.ReactElement;
+declare function IrisTable<Row extends Record<string, unknown>>({ columns, data, rowKey, selectable, selection: selectionProp, defaultSelection, onSelectionChange, sort: sortProp, defaultSort, onSortChange, striped, bordered, resizableColumns, columnWidths: columnWidthsProp, defaultColumnWidths, onColumnWidthsChange, onRowClick, onCellEdit, renderDetail, rowExpandable, defaultExpandedRowKeys, onExpandedRowsChange, getSubRows, keyboardNavigation, cellRange, virtualScroll, columnVirtualization, emptyState, loading, error, loadingState, errorState, onRetry, style, className, ...rest }: IrisTableProps<Row>): React.ReactElement;
 
 /**
  * Serialize rows as a CSV string per RFC 4180. Column order determines field