@texturehq/edges 1.19.0 → 1.19.2

package/dist/index.d.cts

@@ -1807,8 +1807,12 @@ interface CopyToClipboardProps {
      * Size of the copy button, defaults to "sm"
      */
     size?: "sm" | "md";
+    /**
+     * Position of the copy icon relative to children, defaults to "right"
+     */
+    iconPosition?: "left" | "right";
 }
-declare function CopyToClipboard({ value, children, className, size }: CopyToClipboardProps): react_jsx_runtime.JSX.Element;
+declare function CopyToClipboard({ value, children, className, size, iconPosition, }: CopyToClipboardProps): react_jsx_runtime.JSX.Element;
 
 interface AreaSeriesProps {
     data: BaseDataPoint[];
@@ -1862,10 +1866,6 @@ declare const ChartAxis: {
     Left: React__default.FC<AxisLeftProps>;
 };
 
-interface LegendItem {
-    category: string;
-    fill: string;
-}
 interface ChartBottomBarProps {
     items: LegendItem[];
     onExport: (type: ExportType) => void | Promise<void>;
@@ -1874,11 +1874,28 @@ interface ChartBottomBarProps {
     isZoomed?: boolean;
     onResetZoom?: () => void;
 }
+interface LegendItem {
+    category: string;
+    fill: string;
+}
+declare const LegendItem: React__default.FC<{
+    item: LegendItem;
+}>;
 /**
  * ChartBottomBar
  *
  * Chart footer component with legend and export functionality.
  * Displays color-coded legend items and provides export options for CSV, SVG, and PNG formats.
+ *
+ * **Smart legend display:**
+ * - Desktop (≥ 640px): Shows all legend items inline with wrapping
+ * - Mobile (< 640px): Shows "Legend (N)" button that opens a tray with all items
+ * - Legend and action buttons always stay on a single row for clean, consistent layout
+ *
+ * **Responsive behavior:**
+ * - Mobile: No padding, legend in tray, button text hidden (icon-only)
+ * - Desktop: Chart margin padding, inline legend, full button labels
+ *
  * Respects chart margins to align legend with Y-axis and export button with X-axis end.
  */
 declare const ChartBottomBar: React__default.FC<ChartBottomBarProps>;
@@ -3065,8 +3082,10 @@ interface DeviceMetaDisplayProps {
     manufacturer: string;
     /** Device model name */
     model: string;
-    /** Device type for fallback icon */
-    deviceType: DeviceType;
+    /** Device type for fallback icon (deprecated: use deviceTypeIconName instead) */
+    deviceType?: DeviceType;
+    /** Explicit device type icon name (preferred over deviceType) */
+    deviceTypeIconName?: string;
     /** URL to manufacturer logo (optional) */
     logoUrl?: string;
     /** Layout variant - stacked (vertical) or inline (horizontal) */
@@ -3130,7 +3149,7 @@ interface DeviceMetaDisplayProps {
  * />
  * ```
  */
-declare function DeviceMetaDisplay({ manufacturer, model, deviceType, logoUrl, layout, size, href, LinkComponent, linkVariant, showDeviceTypeIcon, showLogo, emphasis, isLoading, className, }: DeviceMetaDisplayProps): react_jsx_runtime.JSX.Element;
+declare function DeviceMetaDisplay({ manufacturer, model, deviceType, deviceTypeIconName, logoUrl, layout, size, href, LinkComponent, linkVariant, showDeviceTypeIcon, showLogo, emphasis, isLoading, className, }: DeviceMetaDisplayProps): react_jsx_runtime.JSX.Element;
 
 interface DeviceStateBadgeProps extends Omit<BadgeProps, "variant" | "children"> {
     /** The device state to display */
@@ -3212,8 +3231,10 @@ interface DeviceStateWithMetricProps extends Pick<DeviceStateBadgeProps, "state"
 declare function DeviceStateWithMetric({ state, stateLabel, metric, metricFormatter, secondaryState, layout, isLoading, size, shape, icon, fixedWidth, className, }: DeviceStateWithMetricProps): react_jsx_runtime.JSX.Element;
 
 interface DeviceTypeIconProps {
-    /** The device type to display */
-    deviceType: DeviceType;
+    /** The device type to display (deprecated: use iconName instead) */
+    deviceType?: DeviceType;
+    /** Explicit icon name to display (preferred over deviceType) */
+    iconName?: IconName$2;
     /** Size of the icon (preset or custom pixel size) */
     size?: number | "sm" | "md" | "lg" | "xl";
     /** Show label below the icon */
@@ -3225,20 +3246,26 @@ interface DeviceTypeIconProps {
  * DeviceTypeIcon
  *
  * Displays a consistent icon for device types across the platform.
- * Maps device types to appropriate Phosphor icons with optional labels.
+ *
+ * **Preferred usage:** Pass `iconName` explicitly (from device-config package)
+ * **Legacy usage:** Pass `deviceType` to use built-in icon mapping (deprecated)
  *
  * @example
  * ```tsx
+ * // Preferred: Explicit icon from device-config
+ * import { getDeviceTypeDisplay } from "@texturehq/device-config";
+ * const display = getDeviceTypeDisplay("battery");
+ * <DeviceTypeIcon iconName={display.icon} size="md" />
+ *
+ * // Legacy: Built-in mapping (deprecated)
  * <DeviceTypeIcon deviceType="battery" size="md" />
- * <DeviceTypeIcon deviceType="thermostat" showLabel />
- * <DeviceTypeIcon deviceType="charger" size={32} />
  * ```
  */
-declare function DeviceTypeIcon({ deviceType, size, showLabel, className, }: DeviceTypeIconProps): react_jsx_runtime.JSX.Element;
+declare function DeviceTypeIcon({ deviceType, iconName, size, showLabel, className, }: DeviceTypeIconProps): react_jsx_runtime.JSX.Element;
 
 type BaseDialogHeaderProps = {
     title?: string;
-    onClose: () => void;
+    onClose?: () => void;
     hideCloseIcon?: boolean;
     titleAlign?: "left" | "center";
     headerContent?: React__default.ReactNode;
@@ -4612,6 +4639,8 @@ interface SiteContactCardProps {
     className?: string;
     /** Additional classes for the card content (for padding control, etc.) */
     contentClassName?: string;
+    /** Whether the card should fill the full height of its container */
+    fullHeight?: boolean;
 }
 /**
  * SiteContactCard
@@ -4642,7 +4671,7 @@ interface SiteContactCardProps {
  * />
  * ```
  */
-declare function SiteContactCard({ site, contact, LinkComponent, variant, showMap, mapHeight, mapboxAccessToken, showEmail, showPhone, isLoading, className, contentClassName, }: SiteContactCardProps): react_jsx_runtime.JSX.Element;
+declare function SiteContactCard({ site, contact, LinkComponent, variant, showMap, mapHeight, mapboxAccessToken, showEmail, showPhone, isLoading, className, contentClassName, fullHeight, }: SiteContactCardProps): react_jsx_runtime.JSX.Element;
 
 interface SiteMetaDisplayProps {
     /** Street address (combined street lines) */
@@ -4857,6 +4886,8 @@ interface StatItem {
     thresholds?: StatThreshold[];
     /** Enable copy to clipboard */
     copyable?: boolean | ((value: StatValue) => string);
+    /** Position of the copy icon when copyable is enabled, defaults to "left" */
+    copyIconPosition?: "left" | "right";
     /** Optional link URL */
     href?: string;
     /** Click handler */

package/dist/index.d.ts

@@ -1807,8 +1807,12 @@ interface CopyToClipboardProps {
      * Size of the copy button, defaults to "sm"
      */
     size?: "sm" | "md";
+    /**
+     * Position of the copy icon relative to children, defaults to "right"
+     */
+    iconPosition?: "left" | "right";
 }
-declare function CopyToClipboard({ value, children, className, size }: CopyToClipboardProps): react_jsx_runtime.JSX.Element;
+declare function CopyToClipboard({ value, children, className, size, iconPosition, }: CopyToClipboardProps): react_jsx_runtime.JSX.Element;
 
 interface AreaSeriesProps {
     data: BaseDataPoint[];
@@ -1862,10 +1866,6 @@ declare const ChartAxis: {
     Left: React__default.FC<AxisLeftProps>;
 };
 
-interface LegendItem {
-    category: string;
-    fill: string;
-}
 interface ChartBottomBarProps {
     items: LegendItem[];
     onExport: (type: ExportType) => void | Promise<void>;
@@ -1874,11 +1874,28 @@ interface ChartBottomBarProps {
     isZoomed?: boolean;
     onResetZoom?: () => void;
 }
+interface LegendItem {
+    category: string;
+    fill: string;
+}
+declare const LegendItem: React__default.FC<{
+    item: LegendItem;
+}>;
 /**
  * ChartBottomBar
  *
  * Chart footer component with legend and export functionality.
  * Displays color-coded legend items and provides export options for CSV, SVG, and PNG formats.
+ *
+ * **Smart legend display:**
+ * - Desktop (≥ 640px): Shows all legend items inline with wrapping
+ * - Mobile (< 640px): Shows "Legend (N)" button that opens a tray with all items
+ * - Legend and action buttons always stay on a single row for clean, consistent layout
+ *
+ * **Responsive behavior:**
+ * - Mobile: No padding, legend in tray, button text hidden (icon-only)
+ * - Desktop: Chart margin padding, inline legend, full button labels
+ *
  * Respects chart margins to align legend with Y-axis and export button with X-axis end.
  */
 declare const ChartBottomBar: React__default.FC<ChartBottomBarProps>;
@@ -3065,8 +3082,10 @@ interface DeviceMetaDisplayProps {
     manufacturer: string;
     /** Device model name */
     model: string;
-    /** Device type for fallback icon */
-    deviceType: DeviceType;
+    /** Device type for fallback icon (deprecated: use deviceTypeIconName instead) */
+    deviceType?: DeviceType;
+    /** Explicit device type icon name (preferred over deviceType) */
+    deviceTypeIconName?: string;
     /** URL to manufacturer logo (optional) */
     logoUrl?: string;
     /** Layout variant - stacked (vertical) or inline (horizontal) */
@@ -3130,7 +3149,7 @@ interface DeviceMetaDisplayProps {
  * />
  * ```
  */
-declare function DeviceMetaDisplay({ manufacturer, model, deviceType, logoUrl, layout, size, href, LinkComponent, linkVariant, showDeviceTypeIcon, showLogo, emphasis, isLoading, className, }: DeviceMetaDisplayProps): react_jsx_runtime.JSX.Element;
+declare function DeviceMetaDisplay({ manufacturer, model, deviceType, deviceTypeIconName, logoUrl, layout, size, href, LinkComponent, linkVariant, showDeviceTypeIcon, showLogo, emphasis, isLoading, className, }: DeviceMetaDisplayProps): react_jsx_runtime.JSX.Element;
 
 interface DeviceStateBadgeProps extends Omit<BadgeProps, "variant" | "children"> {
     /** The device state to display */
@@ -3212,8 +3231,10 @@ interface DeviceStateWithMetricProps extends Pick<DeviceStateBadgeProps, "state"
 declare function DeviceStateWithMetric({ state, stateLabel, metric, metricFormatter, secondaryState, layout, isLoading, size, shape, icon, fixedWidth, className, }: DeviceStateWithMetricProps): react_jsx_runtime.JSX.Element;
 
 interface DeviceTypeIconProps {
-    /** The device type to display */
-    deviceType: DeviceType;
+    /** The device type to display (deprecated: use iconName instead) */
+    deviceType?: DeviceType;
+    /** Explicit icon name to display (preferred over deviceType) */
+    iconName?: IconName$2;
     /** Size of the icon (preset or custom pixel size) */
     size?: number | "sm" | "md" | "lg" | "xl";
     /** Show label below the icon */
@@ -3225,20 +3246,26 @@ interface DeviceTypeIconProps {
  * DeviceTypeIcon
  *
  * Displays a consistent icon for device types across the platform.
- * Maps device types to appropriate Phosphor icons with optional labels.
+ *
+ * **Preferred usage:** Pass `iconName` explicitly (from device-config package)
+ * **Legacy usage:** Pass `deviceType` to use built-in icon mapping (deprecated)
  *
  * @example
  * ```tsx
+ * // Preferred: Explicit icon from device-config
+ * import { getDeviceTypeDisplay } from "@texturehq/device-config";
+ * const display = getDeviceTypeDisplay("battery");
+ * <DeviceTypeIcon iconName={display.icon} size="md" />
+ *
+ * // Legacy: Built-in mapping (deprecated)
  * <DeviceTypeIcon deviceType="battery" size="md" />
- * <DeviceTypeIcon deviceType="thermostat" showLabel />
- * <DeviceTypeIcon deviceType="charger" size={32} />
  * ```
  */
-declare function DeviceTypeIcon({ deviceType, size, showLabel, className, }: DeviceTypeIconProps): react_jsx_runtime.JSX.Element;
+declare function DeviceTypeIcon({ deviceType, iconName, size, showLabel, className, }: DeviceTypeIconProps): react_jsx_runtime.JSX.Element;
 
 type BaseDialogHeaderProps = {
     title?: string;
-    onClose: () => void;
+    onClose?: () => void;
     hideCloseIcon?: boolean;
     titleAlign?: "left" | "center";
     headerContent?: React__default.ReactNode;
@@ -4612,6 +4639,8 @@ interface SiteContactCardProps {
     className?: string;
     /** Additional classes for the card content (for padding control, etc.) */
     contentClassName?: string;
+    /** Whether the card should fill the full height of its container */
+    fullHeight?: boolean;
 }
 /**
  * SiteContactCard
@@ -4642,7 +4671,7 @@ interface SiteContactCardProps {
  * />
  * ```
  */
-declare function SiteContactCard({ site, contact, LinkComponent, variant, showMap, mapHeight, mapboxAccessToken, showEmail, showPhone, isLoading, className, contentClassName, }: SiteContactCardProps): react_jsx_runtime.JSX.Element;
+declare function SiteContactCard({ site, contact, LinkComponent, variant, showMap, mapHeight, mapboxAccessToken, showEmail, showPhone, isLoading, className, contentClassName, fullHeight, }: SiteContactCardProps): react_jsx_runtime.JSX.Element;
 
 interface SiteMetaDisplayProps {
     /** Street address (combined street lines) */
@@ -4857,6 +4886,8 @@ interface StatItem {
     thresholds?: StatThreshold[];
     /** Enable copy to clipboard */
     copyable?: boolean | ((value: StatValue) => string);
+    /** Position of the copy icon when copyable is enabled, defaults to "left" */
+    copyIconPosition?: "left" | "right";
     /** Optional link URL */
     href?: string;
     /** Click handler */