@camstack/ui-library 1.2.256 → 1.2.258

package/dist/composites/device-item/header.d.ts

@@ -1,34 +1,56 @@
-import { ReactNode } from 'react';
-import { DeviceItemDevice, DeviceItemParent, DeviceItemVariant, VariantDefaults } from './helpers';
 /**
- * How the name behaves when it does not fit.
- *   - `truncate` — one line, ellipsis, the header shrinks with its container.
- *   - `scroll`   — one line, FULL text below `md`; the enclosing column is
- *                  uncapped there, so the name widens it and the table scrolls.
- */
-export type DeviceNameOverflow = 'truncate' | 'scroll';
+* <DeviceItemHeader> — the leftmost segment of the row: chevron
+* (when accordion enabled + has children), lead icon, name + meta-line
+* (`#id · stableId-tail`), parent badge.
+*
+* Two layout modes:
+*   - default (horizontal): `flex: 1; min-w-0` — eats every leftover
+*     horizontal pixel; name truncates with ellipsis when the row gets
+*     narrow. Used by table view + minimal in-panel lists.
+*   - `stacked=true`: name is the visual anchor of a vertical card. No
+*     truncation, two-line clamp so longer names wrap instead of
+*     collapsing into "Videocamera vera…". Typography is larger /
+*     heavier so the name dominates the secondary metadata that sits
+*     below it.
+*
+* …plus one orthogonal switch, `nameOverflow`. `'truncate'` (default) is the
+* behaviour above — a card is a width-bounded box with nowhere to scroll to.
+* `'scroll'` is passed by the TABLE row: below `md` the name loses its
+* ellipsis, sizes its own (uncapped) column, and the table's
+* `overflow-x-auto` wrapper carries the overflow. See
+* `NAME_COLUMN_TRUNCATE_BREAKPOINT` in device-list/columns.
+*/
+import { type ReactNode } from "react";
+import type { DeviceItemDevice, DeviceItemParent, DeviceItemVariant, VariantDefaults } from "./helpers";
+/**
+* How the name behaves when it does not fit.
+*   - `truncate` — one line, ellipsis, the header shrinks with its container.
+*   - `scroll`   — one line, FULL text below `md`; the enclosing column is
+*                  uncapped there, so the name widens it and the table scrolls.
+*/
+export type DeviceNameOverflow = "truncate" | "scroll";
 export interface DeviceItemHeaderProps {
-    readonly device: DeviceItemDevice;
-    readonly variant: DeviceItemVariant;
-    readonly flags: VariantDefaults;
-    readonly parent: DeviceItemParent | null;
-    readonly integrationIcon: ReactNode | null;
-    readonly hasChildren: boolean;
-    readonly expanded: boolean;
-    readonly onToggleExpand: () => void;
-    readonly onNavigateToParent: (id: number) => void;
-    /**
-     * Vertical-card layout. When true, the name is rendered as the card's
-     * primary anchor: bigger font, heavier weight, line-clamp-2 instead of
-     * single-line truncation, and the inline integrationIcon flips above
-     * the name as a small lead-line so the name's full width is name-only.
-     */
-    readonly stacked?: boolean;
-    /**
-     * Overflow policy for the name (and the two secondary lines under it).
-     * Defaults to `'truncate'` — the card layouts are width-bounded boxes and
-     * have nowhere to scroll to. The table row passes `'scroll'`.
-     */
-    readonly nameOverflow?: DeviceNameOverflow;
+	readonly device: DeviceItemDevice;
+	readonly variant: DeviceItemVariant;
+	readonly flags: VariantDefaults;
+	readonly parent: DeviceItemParent | null;
+	readonly integrationIcon: ReactNode | null;
+	readonly hasChildren: boolean;
+	readonly expanded: boolean;
+	readonly onToggleExpand: () => void;
+	readonly onNavigateToParent: (id: number) => void;
+	/**
+	* Vertical-card layout. When true, the name is rendered as the card's
+	* primary anchor: bigger font, heavier weight, line-clamp-2 instead of
+	* single-line truncation, and the inline integrationIcon flips above
+	* the name as a small lead-line so the name's full width is name-only.
+	*/
+	readonly stacked?: boolean;
+	/**
+	* Overflow policy for the name (and the two secondary lines under it).
+	* Defaults to `'truncate'` — the card layouts are width-bounded boxes and
+	* have nowhere to scroll to. The table row passes `'scroll'`.
+	*/
+	readonly nameOverflow?: DeviceNameOverflow;
 }
-export declare function DeviceItemHeader({ device, variant, flags, parent, integrationIcon, hasChildren, expanded, onToggleExpand, onNavigateToParent, stacked, nameOverflow, }: DeviceItemHeaderProps): ReactNode;
+export declare function DeviceItemHeader({ device, variant, flags, parent, integrationIcon, hasChildren, expanded, onToggleExpand, onNavigateToParent, stacked, nameOverflow }: DeviceItemHeaderProps): ReactNode;