@camstack/ui-library 1.2.256 → 1.2.258

package/dist/composites/notification-targets-options.d.ts

@@ -1,10 +1,13 @@
-import { OptionSelectOption } from './option-select/option-select-model';
+/**
+* Pure mapping helpers for notification-target OptionSelect options.
+*/
+import type { OptionSelectOption } from "./option-select/option-select-model";
 export type NotificationTargetOption = {
-    readonly id: string;
-    readonly name: string;
-    readonly enabled: boolean;
-    readonly kind?: string;
-    readonly addonId?: string;
+	readonly id: string;
+	readonly name: string;
+	readonly enabled: boolean;
+	readonly kind?: string;
+	readonly addonId?: string;
 };
 export declare function targetsToOptions(targets: readonly NotificationTargetOption[], kindIconUrls: ReadonlyMap<string, string>, noteIds: ReadonlySet<string> | undefined, noteLabel: string): readonly OptionSelectOption[];
 export declare function buildKindIconMap(rows: unknown): ReadonlyMap<string, string>;

package/dist/composites/option-select/OptionSelect.d.ts

@@ -1,30 +1,31 @@
-import { OptionSelectOption } from './option-select-model';
+import { type JSX } from "react";
+import type { OptionSelectOption } from "./option-select-model";
 type OptionSelectSharedProps = {
-    readonly options: readonly OptionSelectOption[];
-    readonly placeholder?: string;
-    readonly searchable?: boolean;
-    readonly disabled?: boolean;
-    readonly emptyMessage?: string;
-    readonly creatable?: boolean;
-    readonly createLabel?: string;
-    readonly onCreateRequest?: (draft: string) => void;
-    readonly label?: string;
-    readonly description?: string;
-    readonly testId?: string;
-    readonly optionTestIdPrefix?: string;
-    readonly listboxId?: string;
+	readonly options: readonly OptionSelectOption[];
+	readonly placeholder?: string;
+	readonly searchable?: boolean;
+	readonly disabled?: boolean;
+	readonly emptyMessage?: string;
+	readonly creatable?: boolean;
+	readonly createLabel?: string;
+	readonly onCreateRequest?: (draft: string) => void;
+	readonly label?: string;
+	readonly description?: string;
+	readonly testId?: string;
+	readonly optionTestIdPrefix?: string;
+	readonly listboxId?: string;
 };
 export type OptionSelectSingleProps = OptionSelectSharedProps & {
-    readonly mode: 'single';
-    readonly value: string;
-    readonly onChange: (next: string) => void;
+	readonly mode: "single";
+	readonly value: string;
+	readonly onChange: (next: string) => void;
 };
 export type OptionSelectMultiProps = OptionSelectSharedProps & {
-    readonly mode: 'multi';
-    readonly value: readonly string[];
-    readonly onChange: (next: string[]) => void;
-    readonly maxItems?: number;
+	readonly mode: "multi";
+	readonly value: readonly string[];
+	readonly onChange: (next: string[]) => void;
+	readonly maxItems?: number;
 };
 export type OptionSelectProps = OptionSelectSingleProps | OptionSelectMultiProps;
-export declare function OptionSelect(props: OptionSelectProps): import("react").JSX.Element;
+export declare function OptionSelect(props: OptionSelectProps): JSX.Element | null;
 export {};

package/dist/composites/option-select/index.d.ts

@@ -1,4 +1,4 @@
-export type { OptionSelectOption } from './option-select-model';
-export { OPTION_SELECT_SEARCH_MIN_OPTIONS, catalogHasDraft, draftFromQuery, filterOptions, optionSearchText, partitionSelected, resolveSearchable, shouldShowAddNewFooter, shouldShowUseQueryRow, } from './option-select-model';
-export type { OptionSelectMultiProps, OptionSelectProps, OptionSelectSingleProps, } from './OptionSelect';
-export { OptionSelect } from './OptionSelect';
+export type { OptionSelectOption } from "./option-select-model";
+export { OPTION_SELECT_SEARCH_MIN_OPTIONS, catalogHasDraft, draftFromQuery, filterOptions, optionSearchText, partitionSelected, resolveSearchable, shouldShowAddNewFooter, shouldShowUseQueryRow } from "./option-select-model";
+export type { OptionSelectMultiProps, OptionSelectProps, OptionSelectSingleProps } from "./OptionSelect";
+export { OptionSelect } from "./OptionSelect";

package/dist/composites/option-select/option-select-model.d.ts

@@ -1,56 +1,56 @@
 /**
- * Pure filter/partition helpers for OptionSelect.
- *
- * Search is a case-insensitive substring match folded over each option's
- * `value`, `label`, and `description`. Multi-token queries require every
- * token to match (AND).
- */
+* Pure filter/partition helpers for OptionSelect.
+*
+* Search is a case-insensitive substring match folded over each option's
+* `value`, `label`, and `description`. Multi-token queries require every
+* token to match (AND).
+*/
 export type OptionSelectOption = {
-    value: string;
-    label: string;
-    description?: string;
-    iconUrl?: string;
-    iconId?: string;
-    disabled?: boolean;
-    badge?: string;
+	value: string;
+	label: string;
+	description?: string;
+	iconUrl?: string;
+	iconId?: string;
+	disabled?: boolean;
+	badge?: string;
 };
 /** Number of options at/above which search is enabled by default (unless creatable). */
 export declare const OPTION_SELECT_SEARCH_MIN_OPTIONS = 8;
 /** Fold an option into a single lower-cased haystack (value + label + description). */
 export declare function optionSearchText(opt: OptionSelectOption): string;
 /**
- * Filter options by a free-text query. An empty / whitespace-only query
- * returns every option (identity, preserving order).
- */
+* Filter options by a free-text query. An empty / whitespace-only query
+* returns every option (identity, preserving order).
+*/
 export declare function filterOptions(options: readonly OptionSelectOption[], query: string): readonly OptionSelectOption[];
 /**
- * Split options into the currently-selected set (in selection order) and the
- * rest. Selected values with no matching option are surfaced as synthetic
- * options whose label falls back to the raw value.
- */
+* Split options into the currently-selected set (in selection order) and the
+* rest. Selected values with no matching option are surfaced as synthetic
+* options whose label falls back to the raw value.
+*/
 export declare function partitionSelected(options: readonly OptionSelectOption[], selected: readonly string[]): {
-    readonly selectedOptions: readonly OptionSelectOption[];
-    readonly unselected: readonly OptionSelectOption[];
+	readonly selectedOptions: readonly OptionSelectOption[];
+	readonly unselected: readonly OptionSelectOption[];
 };
 export declare function resolveSearchable(optionCount: number, creatable: boolean, searchable: boolean | undefined): boolean;
 /** Trimmed non-empty draft from the search box, or null when absent. */
 export declare function draftFromQuery(query: string): string | null;
 /**
- * True when an existing catalog option already represents this draft (value or
- * label, case-insensitive). Used to hide the “Use «query»” row when redundant.
- */
+* True when an existing catalog option already represents this draft (value or
+* label, case-insensitive). Used to hide the “Use «query»” row when redundant.
+*/
 export declare function catalogHasDraft(options: readonly OptionSelectOption[], draft: string): boolean;
 /**
- * Show the footer “Add new…” action only when creatable AND the caller
- * provided `onCreateRequest` (e.g. open a dedicated create dialog).
- *
- * Without that hook the footer was a no-op (it only focused the search box),
- * which read as “Add new is broken”. Free-form create already works via the
- * “Use «query»” row once the operator types — no footer needed.
- */
+* Show the footer “Add new…” action only when creatable AND the caller
+* provided `onCreateRequest` (e.g. open a dedicated create dialog).
+*
+* Without that hook the footer was a no-op (it only focused the search box),
+* which read as “Add new is broken”. Free-form create already works via the
+* “Use «query»” row once the operator types — no footer needed.
+*/
 export declare function shouldShowAddNewFooter(creatable: boolean, hasCreateRequest: boolean): boolean;
 /**
- * Show the “Use «query»” commit row: creatable, a non-empty draft, and no
- * catalog option that already matches the draft.
- */
+* Show the “Use «query»” commit row: creatable, a non-empty draft, and no
+* catalog option that already matches the draft.
+*/
 export declare function shouldShowUseQueryRow(creatable: boolean, query: string, options: readonly OptionSelectOption[]): boolean;

package/dist/composites/page-header.d.ts

@@ -1,8 +1,8 @@
-import { ReactNode } from 'react';
+import { type ReactNode, type JSX } from "react";
 export interface PageHeaderProps {
-    title: string;
-    subtitle?: string;
-    actions?: ReactNode;
-    className?: string;
+	title: string;
+	subtitle?: string;
+	actions?: ReactNode;
+	className?: string;
 }
-export declare function PageHeader({ title, subtitle, actions, className }: PageHeaderProps): import("react").JSX.Element;
+export declare function PageHeader({ title, subtitle, actions, className }: PageHeaderProps): JSX.Element;

package/dist/composites/peer-connection-config.d.ts

@@ -1,13 +1,13 @@
 /**
- * The player's `RTCConfiguration`, in one place for every connect path.
- *
- * The player never forces `iceTransportPolicy: 'relay'` on its own (werift's
- * relay forward is unreliable across two real TURN servers, and relay would
- * defeat the direct LAN/Tailscale path). The policy exists for the WebRTC
- * diagnostics only, which run the SAME player once with `all` and once with
- * `relay` to tell a reachable relay path from a dead one. Absent, the key is
- * not set at all, so a production connect is byte-for-byte what it was.
- */
+* The player's `RTCConfiguration`, in one place for every connect path.
+*
+* The player never forces `iceTransportPolicy: 'relay'` on its own (werift's
+* relay forward is unreliable across two real TURN servers, and relay would
+* defeat the direct LAN/Tailscale path). The policy exists for the WebRTC
+* diagnostics only, which run the SAME player once with `all` and once with
+* `relay` to tell a reachable relay path from a dead one. Absent, the key is
+* not set at all, so a production connect is byte-for-byte what it was.
+*/
 /** Public STUN kept as a fallback beside whatever the hub's TURN provider returns. */
 export declare const FALLBACK_STUN_SERVER: RTCIceServer;
 export declare function buildPeerConnectionConfig(iceServers: readonly RTCIceServer[] | undefined, iceTransportPolicy: RTCIceTransportPolicy | undefined): RTCConfiguration;

package/dist/composites/phase-icon.d.ts

@@ -1,5 +1,12 @@
-import { LucideProps } from 'lucide-react';
+/**
+* PhaseIcon — renders the correct lucide icon for a CameraPhase.
+*
+* Wraps the PHASE_CONFIG icon name → component resolution so consumers
+* don't need to maintain their own icon switch/map.
+*/
+import { type LucideProps } from "lucide-react";
+import { type JSX } from "react";
 export interface PhaseIconProps extends LucideProps {
-    readonly phase: string;
+	readonly phase: string;
 }
-export declare function PhaseIcon({ phase, ...props }: PhaseIconProps): import("react").JSX.Element;
+export declare function PhaseIcon({ phase, ...props }: PhaseIconProps): JSX.Element;

package/dist/composites/pipeline-builder.d.ts

@@ -1,15 +1,23 @@
-import { PipelineSchema } from '@camstack/types';
-import { PipelineStepDisplayConfig } from './pipeline-step';
+/**
+* PipelineBuilder — orchestrates the pipeline step tree.
+*
+* Renders the step tree from schema with nested children and placeholder steps
+* for disabled addons, all driven by API schema. There are no saved pipeline
+* templates (D759): the tree is the caller's state.
+*/
+import { type JSX } from "react";
+import type { PipelineSchema } from "@camstack/types";
+import type { PipelineStepDisplayConfig } from "./pipeline-step";
 export interface PipelineBuilderProps {
-    readonly schema: PipelineSchema;
-    readonly steps: readonly PipelineStepDisplayConfig[];
-    readonly onChange: (steps: readonly PipelineStepDisplayConfig[]) => void;
-    readonly readOnly?: boolean;
-    /** Addon IDs to exclude from the pipeline (e.g. 'motion-detection' for benchmark) */
-    readonly excludeAddons?: readonly string[];
-    /** Only show enabled steps (hide disabled addons and placeholders) */
-    readonly showOnlyEnabled?: boolean;
-    /** Show "Slot: ..." labels above step groups (default: false) */
-    readonly showSlotLabels?: boolean;
+	readonly schema: PipelineSchema;
+	readonly steps: readonly PipelineStepDisplayConfig[];
+	readonly onChange: (steps: readonly PipelineStepDisplayConfig[]) => void;
+	readonly readOnly?: boolean;
+	/** Addon IDs to exclude from the pipeline (e.g. 'motion-detection' for benchmark) */
+	readonly excludeAddons?: readonly string[];
+	/** Only show enabled steps (hide disabled addons and placeholders) */
+	readonly showOnlyEnabled?: boolean;
+	/** Show "Slot: ..." labels above step groups (default: false) */
+	readonly showSlotLabels?: boolean;
 }
-export declare function PipelineBuilder({ schema, steps, onChange, readOnly, excludeAddons, showOnlyEnabled, showSlotLabels, }: PipelineBuilderProps): import("react").JSX.Element;
+export declare function PipelineBuilder({ schema, steps, onChange, readOnly, excludeAddons, showOnlyEnabled, showSlotLabels }: PipelineBuilderProps): JSX.Element;

package/dist/composites/pipeline-matrix-shared.d.ts

@@ -1,190 +1,199 @@
-import { ReactNode } from 'react';
-import { PipelineSlot } from '@camstack/types';
-import { StepTreeNode } from './step-tree';
+/**
+* pipeline-matrix-shared — the presentation primitives shared by every
+* steps×nodes matrix surface (the cluster `PipelineTreeMatrix` and the
+* per-camera `DeviceStepMatrix`). Extracted so the two matrices render an
+* IDENTICAL cell/label/track vocabulary and can never drift apart.
+*
+* Nothing here holds state or talks to a store — pure display + one pure
+* layout-decision helper (`shouldUseSingleNode`).
+*/
+import { type ReactNode, type JSX } from "react";
+import type { PipelineSlot } from "@camstack/types";
+import type { StepTreeNode } from "./step-tree";
 export interface AgentColumn {
-    readonly agentNodeId: string;
-    readonly engineLabel: string;
-    /**
-     * When set, this column is a per-device sub-column of its node — one enabled
-     * inference accelerator (C7.4). MULTIPLE `AgentColumn`s with the SAME
-     * `agentNodeId` and distinct `deviceKey` expand a node into device columns.
-     * A column with `deviceKey` undefined is a plain per-node column (today's
-     * behaviour — rendered identically).
-     */
-    readonly deviceKey?: string;
-    /** Short human label for the device sub-column header (e.g. "Intel NPU"). */
-    readonly deviceLabel?: string;
-    /** The node's display name for the group header (defaults to `agentNodeId`). */
-    readonly nodeLabel?: string;
-    /** A third header line — the model this accelerator elects for detection. */
-    readonly detail?: string;
-    /** The accelerator is switched off: shown, marked, and never a dispatch target. */
-    readonly disabled?: boolean;
+	readonly agentNodeId: string;
+	readonly engineLabel: string;
+	/**
+	* When set, this column is a per-device sub-column of its node — one enabled
+	* inference accelerator (C7.4). MULTIPLE `AgentColumn`s with the SAME
+	* `agentNodeId` and distinct `deviceKey` expand a node into device columns.
+	* A column with `deviceKey` undefined is a plain per-node column (today's
+	* behaviour — rendered identically).
+	*/
+	readonly deviceKey?: string;
+	/** Short human label for the device sub-column header (e.g. "Intel NPU"). */
+	readonly deviceLabel?: string;
+	/** The node's display name for the group header (defaults to `agentNodeId`). */
+	readonly nodeLabel?: string;
+	/** A third header line — the model this accelerator elects for detection. */
+	readonly detail?: string;
+	/** The accelerator is switched off: shown, marked, and never a dispatch target. */
+	readonly disabled?: boolean;
 }
 /**
- * Stable column identity. Plain per-node columns key by `agentNodeId` (so the
- * rendered `key` is byte-identical to the pre-C7.4 matrix); device sub-columns
- * disambiguate with their `deviceKey`. MUST be used everywhere a React `key`,
- * selection compare, or column identity is derived.
- */
+* Stable column identity. Plain per-node columns key by `agentNodeId` (so the
+* rendered `key` is byte-identical to the pre-C7.4 matrix); device sub-columns
+* disambiguate with their `deviceKey`. MUST be used everywhere a React `key`,
+* selection compare, or column identity is derived.
+*/
 export declare function agentColumnKey(a: AgentColumnIdentity): string;
 /** Minimal identity shape shared by `AgentColumn` and `MatrixSelectedCell`. */
 export interface AgentColumnIdentity {
-    readonly agentNodeId: string;
-    readonly deviceKey?: string;
+	readonly agentNodeId: string;
+	readonly deviceKey?: string;
 }
 /**
- * The currently-selected cell, identified by step addon + column identity.
- * A plain per-node selection carries no `deviceKey` (so existing consumers pass
- * their `{ addonId, agentNodeId }` state unchanged); a per-device selection adds
- * the `deviceKey` of the picked sub-column.
- */
+* The currently-selected cell, identified by step addon + column identity.
+* A plain per-node selection carries no `deviceKey` (so existing consumers pass
+* their `{ addonId, agentNodeId }` state unchanged); a per-device selection adds
+* the `deviceKey` of the picked sub-column.
+*/
 export interface MatrixSelectedCell {
-    readonly addonId: string;
-    readonly agentNodeId: string;
-    readonly deviceKey?: string;
+	readonly addonId: string;
+	readonly agentNodeId: string;
+	readonly deviceKey?: string;
 }
 /**
- * A node's header super-cell: one node grouping ONE or MORE consecutive
- * `AgentColumn`s (device sub-columns) that share its `agentNodeId`.
- *   - `grouped: false` — a single plain column (no `deviceKey`): the header
- *     renders EXACTLY the pre-C7.4 single node header (node name + engineLabel).
- *   - `grouped: true`  — 2+ device sub-columns: a node super-label spanning the
- *     sub-columns, with a per-device sub-label row beneath.
- */
+* A node's header super-cell: one node grouping ONE or MORE consecutive
+* `AgentColumn`s (device sub-columns) that share its `agentNodeId`.
+*   - `grouped: false` — a single plain column (no `deviceKey`): the header
+*     renders EXACTLY the pre-C7.4 single node header (node name + engineLabel).
+*   - `grouped: true`  — 2+ device sub-columns: a node super-label spanning the
+*     sub-columns, with a per-device sub-label row beneath.
+*/
 export interface AgentColumnGroup {
-    readonly agentNodeId: string;
-    readonly engineLabel: string;
-    readonly columns: readonly AgentColumn[];
-    readonly grouped: boolean;
+	readonly agentNodeId: string;
+	readonly engineLabel: string;
+	readonly columns: readonly AgentColumn[];
+	readonly grouped: boolean;
 }
 /**
- * Coalesce CONSECUTIVE columns that share an `agentNodeId` into node groups.
- * Order-preserving: the flat column order is untouched, so body cells still map
- * 1:1 to `agents`. A run of length 1 is a plain (ungrouped) node header.
- */
+* Coalesce CONSECUTIVE columns that share an `agentNodeId` into node groups.
+* Order-preserving: the flat column order is untouched, so body cells still map
+* 1:1 to `agents`. A run of length 1 is a plain (ungrouped) node header.
+*/
 export declare function groupAgentColumns(agents: readonly AgentColumn[]): readonly AgentColumnGroup[];
 /**
- * A single (step, node) cell's rendered state.
- *   - `enabled`  — the node runs a model for this step (chip + optional `ovr`).
- *   - `disabled` — cluster-default off (used by the per-node matrix only).
- *   - `skip`     — #33: gated ON for the camera but this node has no compatible
- *                  model — a visible amber status, never silent.
- *   - `na`       — not applicable on this node.
- */
+* A single (step, node) cell's rendered state.
+*   - `enabled`  — the node runs a model for this step (chip + optional `ovr`).
+*   - `disabled` — cluster-default off (used by the per-node matrix only).
+*   - `skip`     — #33: gated ON for the camera but this node has no compatible
+*                  model — a visible amber status, never silent.
+*   - `na`       — not applicable on this node.
+*/
 export type CellState = {
-    readonly kind: 'enabled';
-    readonly modelId: string;
-    readonly overridden?: boolean;
-    /**
-     * Step-tree device jump (phase 1): a short label of the OTHER same-node
-     * device this step runs on (operator manual override). Renders a subtle
-     * "→ label" badge on the cell.
-     */
-    readonly jumpTo?: string;
-    /**
-     * This model is a CLUSTER-wide choice, not a per-(node,device) one — the
-     * step writes into a shared vector index, where two encoders make
-     * similarity scores meaningless.
-     *
-     * The cell must SAY so. Rendering a cluster value in a per-node matrix
-     * with no marking invites the operator to change it expecting a per-node
-     * effect, and to read a neighbouring node's identical value as a
-     * coincidence rather than as the same single row.
-     */
-    readonly clusterWide?: boolean;
-    /**
-     * The root model whose output IS this step's result here (D730) — the
-     * step's "Use the root model" flag is on and the root supplies it, so the
-     * step's own model does not run. Renders a "root" chip: an enabled cell
-     * whose model is not the one answering must say so.
-     */
-    readonly suppliedByRoot?: string;
+	readonly kind: "enabled";
+	readonly modelId: string;
+	readonly overridden?: boolean;
+	/**
+	* Step-tree device jump (phase 1): a short label of the OTHER same-node
+	* device this step runs on (operator manual override). Renders a subtle
+	* "→ label" badge on the cell.
+	*/
+	readonly jumpTo?: string;
+	/**
+	* This model is a CLUSTER-wide choice, not a per-(node,device) one — the
+	* step writes into a shared vector index, where two encoders make
+	* similarity scores meaningless.
+	*
+	* The cell must SAY so. Rendering a cluster value in a per-node matrix
+	* with no marking invites the operator to change it expecting a per-node
+	* effect, and to read a neighbouring node's identical value as a
+	* coincidence rather than as the same single row.
+	*/
+	readonly clusterWide?: boolean;
+	/**
+	* The root model whose output IS this step's result here (D730) — the
+	* step's "Use the root model" flag is on and the root supplies it, so the
+	* step's own model does not run. Renders a "root" chip: an enabled cell
+	* whose model is not the one answering must say so.
+	*/
+	readonly suppliedByRoot?: string;
 } | {
-    readonly kind: 'disabled';
-    readonly overridden?: boolean;
+	readonly kind: "disabled";
+	readonly overridden?: boolean;
 } | {
-    readonly kind: 'na';
+	readonly kind: "na";
 } | {
-    readonly kind: 'skip';
-    /**
-     * Step-tree device jump (phase 1): this device's format can't run the
-     * step, but it AUTO-jumps to this labelled same-node device — renders a
-     * subtle "→ label" badge in place of the "⚠ skip" degrade marker.
-     */
-    readonly jumpTo?: string;
+	readonly kind: "skip";
+	/**
+	* Step-tree device jump (phase 1): this device's format can't run the
+	* step, but it AUTO-jumps to this labelled same-node device — renders a
+	* subtle "→ label" badge in place of the "⚠ skip" degrade marker.
+	*/
+	readonly jumpTo?: string;
 };
 /**
- * Fixed column geometry (rem). Both matrices use CSS-grid STATIC track widths
- * so a cell's content (a status chip, a long model id) can never resize a
- * column or shift its neighbours — content truncates WITHIN the fixed track.
- * This kills the "table dances when the last column's status changes" jitter.
- */
+* Fixed column geometry (rem). Both matrices use CSS-grid STATIC track widths
+* so a cell's content (a status chip, a long model id) can never resize a
+* column or shift its neighbours — content truncates WITHIN the fixed track.
+* This kills the "table dances when the last column's status changes" jitter.
+*/
 export declare const AGENT_COL_REM = 13;
 export declare const REM_PX = 16;
 export declare const AGENT_COL_PX: number;
 export interface FlatRow {
-    readonly node: StepTreeNode;
-    readonly depth: number;
+	readonly node: StepTreeNode;
+	readonly depth: number;
 }
 export declare function flattenTree(nodes: readonly StepTreeNode[]): readonly FlatRow[];
 /**
- * Layout decision for the responsive A↔B switch. Pure so it can be unit-tested
- * in isolation from the DOM. An unmeasured container (`width <= 0`) always
- * defaults to the wide matrix so there is no first-paint flash into the
- * fallback.
- *
- * Two regimes, because the sticky step column occludes the scroll area on a
- * narrow viewport:
- *   - MULTI-node (`nodeCount >= 2`): fall back when the container can't show the
- *     step column plus at least TWO node columns side by side — the fallback
- *     picks ONE node.
- *   - SINGLE node expanded into `columnCount` device sub-columns (the per-node
- *     BASE matrix): the wide grid pins a `sticky left-0` step column (`stepColPx`
- *     wide); on a phone that column covers nearly the whole viewport, so the
- *     horizontal-scroll area behind it shows only slivers of each device column
- *     and no column can be brought fully into view. Fall back to the FLUID
- *     single-node layout whenever all `columnCount` device columns can't sit
- *     beside the step column without scrolling. `columnCount` defaults to
- *     `nodeCount` (one column per node) for the multi-node consumers.
- */
+* Layout decision for the responsive A↔B switch. Pure so it can be unit-tested
+* in isolation from the DOM. An unmeasured container (`width <= 0`) always
+* defaults to the wide matrix so there is no first-paint flash into the
+* fallback.
+*
+* Two regimes, because the sticky step column occludes the scroll area on a
+* narrow viewport:
+*   - MULTI-node (`nodeCount >= 2`): fall back when the container can't show the
+*     step column plus at least TWO node columns side by side — the fallback
+*     picks ONE node.
+*   - SINGLE node expanded into `columnCount` device sub-columns (the per-node
+*     BASE matrix): the wide grid pins a `sticky left-0` step column (`stepColPx`
+*     wide); on a phone that column covers nearly the whole viewport, so the
+*     horizontal-scroll area behind it shows only slivers of each device column
+*     and no column can be brought fully into view. Fall back to the FLUID
+*     single-node layout whenever all `columnCount` device columns can't sit
+*     beside the step column without scrolling. `columnCount` defaults to
+*     `nodeCount` (one column per node) for the multi-node consumers.
+*/
 export declare function shouldUseSingleNode(width: number, nodeCount: number, stepColPx: number, agentColPx?: number, columnCount?: number): boolean;
 export declare function SlotHeading({ slot }: {
-    readonly slot: PipelineSlot;
-}): import("react").JSX.Element;
-export declare function ClassChips({ inputs, outputs, }: {
-    readonly inputs: readonly string[];
-    readonly outputs: readonly string[];
-}): import("react").JSX.Element | null;
+	readonly slot: PipelineSlot;
+}): JSX.Element | null;
+export declare function ClassChips({ inputs, outputs }: {
+	readonly inputs: readonly string[];
+	readonly outputs: readonly string[];
+}): JSX.Element | null;
 /**
- * Grouped node header (C7.4): a node super-label spanning its device
- * sub-columns, with a per-device sub-label row beneath. Rendered ONLY for a
- * node expanded into 2+ device sub-columns; a single plain column keeps each
- * matrix's own byte-identical single-header markup. The spanning cell uses
- * `gridColumn: span N` so it aligns to its N body columns; the inner flex row
- * gives each device its own equal-width, padded sub-label slot.
- *
- * The node super-label carries ONLY the node id — NOT a single engine/format
- * subtitle. When device sub-columns have differing formats (e.g. Coral `tflite`
- * beside two OpenVINO devices), one node-level format label is a lie taken from
- * the first column; each device's real format is shown per sub-column instead
- * ("Coral Edge TPU · tflite").
- */
+* Grouped node header (C7.4): a node super-label spanning its device
+* sub-columns, with a per-device sub-label row beneath. Rendered ONLY for a
+* node expanded into 2+ device sub-columns; a single plain column keeps each
+* matrix's own byte-identical single-header markup. The spanning cell uses
+* `gridColumn: span N` so it aligns to its N body columns; the inner flex row
+* gives each device its own equal-width, padded sub-label slot.
+*
+* The node super-label carries ONLY the node id — NOT a single engine/format
+* subtitle. When device sub-columns have differing formats (e.g. Coral `tflite`
+* beside two OpenVINO devices), one node-level format label is a lie taken from
+* the first column; each device's real format is shown per sub-column instead
+* ("Coral Edge TPU · tflite").
+*/
 /** The per-accelerator lines of a column header: name, format, model, off. */
 export declare function AgentColumnLines({ column }: {
-    readonly column: AgentColumn;
-}): import("react").JSX.Element;
+	readonly column: AgentColumn;
+}): JSX.Element | null;
 export declare function GroupedAgentHeader({ group }: {
-    readonly group: AgentColumnGroup;
-}): import("react").JSX.Element;
+	readonly group: AgentColumnGroup;
+}): JSX.Element | null;
 /** Step label (slot heading + addon name + class chips), shared by both views. */
 export declare function StepLabel({ node }: {
-    readonly node: StepTreeNode;
-}): import("react").JSX.Element;
+	readonly node: StepTreeNode;
+}): JSX.Element | null;
 /**
- * Cell content. Width-stable: the status dot is `shrink-0` (reserved space) and
- * the model id truncates inside a `min-w-0` flex row, so a longer model id never
- * widens the cell — it ellipsises instead.
- */
+* Cell content. Width-stable: the status dot is `shrink-0` (reserved space) and
+* the model id truncates inside a `min-w-0` flex row, so a longer model id never
+* widens the cell — it ellipsises instead.
+*/
 export declare function renderCellContent(state: CellState): ReactNode;
 export declare function cellButtonClass(state: CellState, isSelected: boolean, extra?: string): string;