@camstack/ui-library 1.2.256 → 1.2.258

package/dist/composites/step-inspector/step-detail-dock.d.ts

@@ -1,33 +1,49 @@
-import { ReactNode, RefObject } from 'react';
+/**
+* StepDetailDock — where a step's settings open from the step matrix
+* (D757): docked to the page's scroll container, never inside the scrolling
+* content.
+*
+* Desktop: a side panel `position: fixed` over the RIGHT edge of the nearest
+* scroll container (its top, bottom and right are measured from that box), so
+* it stays where it is while the matrix scrolls under it, and its header and
+* save bar are always on screen. It overlays — it never reserves width, so the
+* matrix does not reflow (the slide-over before D756 reserved 360 px, the
+* matrix re-measured into a single-node layout, and the clicked cell slid
+* under the panel). The matrix uses {@link STEP_DOCK_WIDTH_PX} to scroll the
+* selected column clear of it.
+*
+* Phone: a full-screen `Dialog` sheet.
+*/
+import { type ReactNode, type RefObject, type JSX } from "react";
 /** Width of the desktop dock — what the matrix keeps clear of it. */
 export declare const STEP_DOCK_WIDTH_PX = 432;
 /** The dock's viewport box, from its scroll container's box. */
 export declare function dockBox(input: {
-    readonly scroller: {
-        readonly top: number;
-        readonly bottom: number;
-        readonly right: number;
-    };
-    readonly viewportWidth: number;
-    readonly widthPx: number;
+	readonly scroller: {
+		readonly top: number;
+		readonly bottom: number;
+		readonly right: number;
+	};
+	readonly viewportWidth: number;
+	readonly widthPx: number;
 }): {
-    readonly top: number;
-    readonly height: number;
-    readonly right: number;
-    readonly width: number;
+	readonly top: number;
+	readonly height: number;
+	readonly right: number;
+	readonly width: number;
 };
 export interface StepDetailDockProps {
-    readonly open: boolean;
-    /** An element inside the page's scroll container (the matrix) — the dock measures from it. */
-    readonly anchor: RefObject<HTMLElement | null>;
-    /** The phone sheet was dismissed (Escape, back). */
-    readonly onClose: () => void;
-    /** Accessible name of the dock region. */
-    readonly label: string;
-    readonly children: ReactNode;
+	readonly open: boolean;
+	/** An element inside the page's scroll container (the matrix) — the dock measures from it. */
+	readonly anchor: RefObject<HTMLElement | null>;
+	/** The phone sheet was dismissed (Escape, back). */
+	readonly onClose: () => void;
+	/** Accessible name of the dock region. */
+	readonly label: string;
+	readonly children: ReactNode;
 }
-export declare function StepDetailDock({ open, anchor, onClose, label, children }: StepDetailDockProps): import("react").JSX.Element | null;
+export declare function StepDetailDock({ open, anchor, onClose, label, children }: StepDetailDockProps): JSX.Element | null;
 /** "‹ Steps" — the phone sheet's way back to the matrix. */
 export declare function BackToStepsButton({ onClick }: {
-    readonly onClick: () => void;
-}): import("react").JSX.Element;
+	readonly onClick: () => void;
+}): JSX.Element | null;

package/dist/composites/step-inspector/step-inspector-panel.d.ts

@@ -1,32 +1,38 @@
-import { ReactNode } from 'react';
+/**
+* StepInspectorPanel — the detail pane of the step inspector: a pinned header
+* (the clicked step and accelerator, the gate), ONE scrolling body, and a
+* pinned save bar (with the "applies to" choice, when there is one). Nothing in it depends on the page's scroll position — the slide-over
+* it replaced was anchored to the matrix block and scrolled away with it.
+*/
+import { type ReactNode, type ForwardRefExoticComponent, type RefAttributes } from "react";
 export interface SaveBarState {
-    readonly dirtyCount: number;
-    readonly saving: boolean;
-    /** The last save's outcome, cleared by the next edit. */
-    readonly status: 'saved' | 'error' | null;
-    readonly error?: string;
-    readonly onSave: () => void;
-    readonly onDiscard: () => void;
-    /**
-     * A control that decides WHAT Save writes, drawn on its own row right above
-     * the buttons — on a camera, "Applies to: this accelerator / all
-     * accelerators". Next to Save, so it is read at the moment of saving.
-     */
-    readonly scope?: ReactNode;
+	readonly dirtyCount: number;
+	readonly saving: boolean;
+	/** The last save's outcome, cleared by the next edit. */
+	readonly status: "saved" | "error" | null;
+	readonly error?: string;
+	readonly onSave: () => void;
+	readonly onDiscard: () => void;
+	/**
+	* A control that decides WHAT Save writes, drawn on its own row right above
+	* the buttons — on a camera, "Applies to: this accelerator / all
+	* accelerators". Next to Save, so it is read at the moment of saving.
+	*/
+	readonly scope?: ReactNode;
 }
 export interface StepInspectorPanelProps {
-    readonly title: string;
-    readonly subtitle?: ReactNode;
-    /** Right of the title (the gate). */
-    readonly headerActions?: ReactNode;
-    /** Under the title. */
-    readonly headerExtra?: ReactNode;
-    /** Left of the title (the phone's "‹ Steps"). */
-    readonly leading?: ReactNode;
-    readonly saveBar?: SaveBarState;
-    /** Escape inside the panel — the host returns focus to the step list. */
-    readonly onEscape?: () => void;
-    readonly children: ReactNode;
-    readonly className?: string;
+	readonly title: string;
+	readonly subtitle?: ReactNode;
+	/** Right of the title (the gate). */
+	readonly headerActions?: ReactNode;
+	/** Under the title. */
+	readonly headerExtra?: ReactNode;
+	/** Left of the title (the phone's "‹ Steps"). */
+	readonly leading?: ReactNode;
+	readonly saveBar?: SaveBarState;
+	/** Escape inside the panel — the host returns focus to the step list. */
+	readonly onEscape?: () => void;
+	readonly children: ReactNode;
+	readonly className?: string;
 }
-export declare const StepInspectorPanel: import('react').ForwardRefExoticComponent<StepInspectorPanelProps & import('react').RefAttributes<HTMLHeadingElement>>;
+export declare const StepInspectorPanel: ForwardRefExoticComponent<StepInspectorPanelProps & RefAttributes<HTMLHeadingElement>>;

package/dist/composites/step-inspector/step-model-row.d.ts

@@ -1,27 +1,32 @@
-import { ReactNode } from 'react';
-import { PipelineAddonSchema } from '@camstack/types';
+/**
+* StepModelRow — the model ONE accelerator runs for a step, where that answer
+* comes from (this camera / the node / the hardware default), and a picker
+* that opens in place. A model is per accelerator by nature: formats differ.
+*/
+import { type ReactNode, type JSX } from "react";
+import type { PipelineAddonSchema } from "@camstack/types";
 /** Where the row's model is decided. */
-export type ModelRowSource = 'camera' | 'node' | 'default' | 'cluster';
+export type ModelRowSource = "camera" | "node" | "default" | "cluster";
 export interface StepModelRowProps {
-    readonly label: string;
-    readonly format: string;
-    /** The model this accelerator runs (`undefined` = nothing runs here). */
-    readonly modelId: string | undefined;
-    readonly source: ModelRowSource;
-    readonly sourceLabel: string;
-    readonly models: PipelineAddonSchema['models'];
-    readonly defaultModelId?: string;
-    readonly expanded: boolean;
-    readonly onToggle: () => void;
-    readonly onChangeModel: (modelId: string) => void;
-    /** Present only when the edited layer pins a model here. */
-    readonly onReset?: () => void;
-    readonly resetLabel?: string;
-    /** Why the step does not run its own model here (no build, root-supplied, jump). */
-    readonly note?: ReactNode;
-    /** Extra control shown with the picker ("Run on"). */
-    readonly extra?: ReactNode;
-    readonly changed?: boolean;
-    readonly disabled?: boolean;
+	readonly label: string;
+	readonly format: string;
+	/** The model this accelerator runs (`undefined` = nothing runs here). */
+	readonly modelId: string | undefined;
+	readonly source: ModelRowSource;
+	readonly sourceLabel: string;
+	readonly models: PipelineAddonSchema["models"];
+	readonly defaultModelId?: string;
+	readonly expanded: boolean;
+	readonly onToggle: () => void;
+	readonly onChangeModel: (modelId: string) => void;
+	/** Present only when the edited layer pins a model here. */
+	readonly onReset?: () => void;
+	readonly resetLabel?: string;
+	/** Why the step does not run its own model here (no build, root-supplied, jump). */
+	readonly note?: ReactNode;
+	/** Extra control shown with the picker ("Run on"). */
+	readonly extra?: ReactNode;
+	readonly changed?: boolean;
+	readonly disabled?: boolean;
 }
-export declare function StepModelRow({ label, format, modelId, source, sourceLabel, models, defaultModelId, expanded, onToggle, onChangeModel, onReset, resetLabel, note, extra, changed, disabled, }: StepModelRowProps): import("react").JSX.Element;
+export declare function StepModelRow({ label, format, modelId, source, sourceLabel, models, defaultModelId, expanded, onToggle, onChangeModel, onReset, resetLabel, note, extra, changed, disabled }: StepModelRowProps): JSX.Element;

package/dist/composites/step-inspector/step-search.d.ts

@@ -1,18 +1,18 @@
 /**
- * The step matrix's filter (`/`): a step matches by its name, or by any of its
- * field labels — so a question about a knob ("face size", "person") finds the
- * step that owns it, and says which field it matched.
- */
+* The step matrix's filter (`/`): a step matches by its name, or by any of its
+* field labels — so a question about a knob ("face size", "person") finds the
+* step that owns it, and says which field it matched.
+*/
 export interface StepSearchRow {
-    readonly addonId: string;
-    readonly name: string;
-    /** Every field label of the step, cluster-owned ones included. */
-    readonly fieldLabels: readonly string[];
+	readonly addonId: string;
+	readonly name: string;
+	/** Every field label of the step, cluster-owned ones included. */
+	readonly fieldLabels: readonly string[];
 }
 export interface StepSearchHit {
-    readonly addonId: string;
-    /** The field label the query matched; absent for a name match. */
-    readonly matchedField?: string;
+	readonly addonId: string;
+	/** The field label the query matched; absent for a name match. */
+	readonly matchedField?: string;
 }
 /** Steps matching `query` (all tokens in the name, or all in one field label). Empty query = all. */
 export declare function searchSteps(rows: readonly StepSearchRow[], query: string): readonly StepSearchHit[];

package/dist/composites/step-timings.d.ts

@@ -1,9 +1,10 @@
+import { type JSX } from "react";
 /**
- * StepTimings — displays pipeline execution timings per step.
- */
+* StepTimings — displays pipeline execution timings per step.
+*/
 export interface StepTimingsProps {
-    readonly timings: Readonly<Record<string, number>>;
-    readonly totalMs?: number;
-    readonly className?: string;
+	readonly timings: Readonly<Record<string, number>>;
+	readonly totalMs?: number;
+	readonly className?: string;
 }
-export declare function StepTimings({ timings, totalMs, className }: StepTimingsProps): import("react").JSX.Element | null;
+export declare function StepTimings({ timings, totalMs, className }: StepTimingsProps): JSX.Element | null;

package/dist/composites/step-tree.d.ts

@@ -1,16 +1,21 @@
-import { PipelineSchema, PipelineSlot } from '@camstack/types';
+/**
+* The detection step TREE of a pipeline catalog — which step feeds which —
+* built once from the executor's schema and shared by the step inspector's
+* list and its Compare matrix.
+*/
+import type { PipelineSchema, PipelineSlot } from "@camstack/types";
 export interface StepTreeNode {
-    readonly addonId: string;
-    readonly addonName: string;
-    readonly slot: PipelineSlot;
-    readonly inputClasses: readonly string[];
-    readonly outputClasses: readonly string[];
-    readonly children: readonly StepTreeNode[];
+	readonly addonId: string;
+	readonly addonName: string;
+	readonly slot: PipelineSlot;
+	readonly inputClasses: readonly string[];
+	readonly outputClasses: readonly string[];
+	readonly children: readonly StepTreeNode[];
 }
 /**
- * Helper: build a StepTreeNode[] from a `PipelineSchema` by chaining on
- * `inputClasses` ⇔ `outputClasses` compatibility. Mirrors the orchestrator
- * resolver's `buildTreeFromAddons` logic but yields names only (display
- * layer). Addons in the audio-classifier slot become separate roots.
- */
+* Helper: build a StepTreeNode[] from a `PipelineSchema` by chaining on
+* `inputClasses` ⇔ `outputClasses` compatibility. Mirrors the orchestrator
+* resolver's `buildTreeFromAddons` logic but yields names only (display
+* layer). Addons in the audio-classifier slot become separate roots.
+*/
 export declare function buildStepTreeFromSchema(schema: PipelineSchema): readonly StepTreeNode[];

package/dist/composites/stream-broker-selector.d.ts

@@ -1,10 +1,31 @@
-import { ReactElement } from 'react';
+/**
+* StreamBrokerSelector — reusable per-device "preferred stream" picker.
+*
+* Renders a single `<Select>` with options sourced from the device's
+* camera-streams cap (`getRtspEntries`). The first option is always
+* "Auto (best available)"; remaining options are one per enabled
+* RTSP restream entry, labelled by stream profile (`High` / `Mid` /
+* `Low` …) and tagged with codec + resolution when the broker reports
+* them.
+*
+* Used by addon-built panels that don't flow through the form-builder
+* `ConfigUISchema` aggregator (the cap-driven aggregator already
+* embeds an equivalent `select` field with server-resolved options —
+* the addons return the same list inline). Reach for this composite
+* when you need an out-of-form selector in a bespoke React tree (e.g.
+* an addon's wizard page, a debug panel, etc.).
+*
+* Loading / empty / error states all render a degraded select rather
+* than vanishing — the operator can always pick `Auto` even if the
+* device's broker is currently unreachable.
+*/
+import { type ReactElement } from "react";
 export interface StreamBrokerSelectorProps {
-    readonly deviceId: number;
-    readonly value: 'auto' | string;
-    readonly onChange: (next: 'auto' | string) => void;
-    readonly disabled?: boolean;
-    readonly label?: string;
-    readonly className?: string;
+	readonly deviceId: number;
+	readonly value: "auto" | string;
+	readonly onChange: (next: "auto" | string) => void;
+	readonly disabled?: boolean;
+	readonly label?: string;
+	readonly className?: string;
 }
-export declare function StreamBrokerSelector({ deviceId, value, onChange, disabled, label, className, }: StreamBrokerSelectorProps): ReactElement;
+export declare function StreamBrokerSelector({ deviceId, value, onChange, disabled, label, className }: StreamBrokerSelectorProps): ReactElement;

package/dist/composites/stream-debug/stream-debug-overlay.d.ts

@@ -1,44 +1,44 @@
-import { ReactNode } from 'react';
-import { WebrtcSessionDebug } from '@camstack/types';
-import { WebrtcDebugStats } from './webrtc-debug-stats.js';
+import { type ReactNode } from "react";
+import type { WebrtcSessionDebug } from "@camstack/types";
+import { type WebrtcDebugStats } from "./webrtc-debug-stats.js";
 /**
- * The stream-debug overlay: the CLIENT's transport measurements next to what
- * the SERVER decided, over the live picture.
- *
- * Three things about this surface are requirements, not styling:
- *
- *  1. It must be legible over a FROZEN picture. The panel is opaque, not a
- *     wash — a translucent overlay on a stuck bright frame is unreadable
- *     exactly when it is needed.
- *  2. Every number says WHEN it was measured. Two independent clocks feed
- *     this (a 1 s `getStats()` poll and a 1 s server poll) and either can
- *     stop. A stale poll that looks live is how a debug tool lies.
- *  3. An UNKNOWN value renders as `—`, and a measured zero renders as `0`
- *     (D393). In a tool whose whole job is telling a stalled decoder from a
- *     stalled transport, "nobody measured" and "measured nothing" are
- *     opposite conclusions.
- *  4. It must not cover the picture, or the operator turns it off and the tool
- *     is worth nothing. So it is a one-line PILL by default — the verdict and
- *     the three numbers that carry it — and the full panel only when asked.
- *     Collapsed it is small enough to live alongside the app's own overlays
- *     (the audio meter, the box layer), which the operator positions freely
- *     and which this used to sit on top of.
- *
- * Density follows from the same rule: a cumulative counter and its window
- * share ONE row (`12345 +30`), because two rows saying almost the same thing
- * is how a panel grows until it covers the video it is describing.
- */
+* The stream-debug overlay: the CLIENT's transport measurements next to what
+* the SERVER decided, over the live picture.
+*
+* Three things about this surface are requirements, not styling:
+*
+*  1. It must be legible over a FROZEN picture. The panel is opaque, not a
+*     wash — a translucent overlay on a stuck bright frame is unreadable
+*     exactly when it is needed.
+*  2. Every number says WHEN it was measured. Two independent clocks feed
+*     this (a 1 s `getStats()` poll and a 1 s server poll) and either can
+*     stop. A stale poll that looks live is how a debug tool lies.
+*  3. An UNKNOWN value renders as `—`, and a measured zero renders as `0`
+*     (D393). In a tool whose whole job is telling a stalled decoder from a
+*     stalled transport, "nobody measured" and "measured nothing" are
+*     opposite conclusions.
+*  4. It must not cover the picture, or the operator turns it off and the tool
+*     is worth nothing. So it is a one-line PILL by default — the verdict and
+*     the three numbers that carry it — and the full panel only when asked.
+*     Collapsed it is small enough to live alongside the app's own overlays
+*     (the audio meter, the box layer), which the operator positions freely
+*     and which this used to sit on top of.
+*
+* Density follows from the same rule: a cumulative counter and its window
+* share ONE row (`12345 +30`), because two rows saying almost the same thing
+* is how a panel grows until it covers the video it is describing.
+*/
 export interface StreamDebugOverlayProps {
-    /** The client half. Null before the first successful poll. */
-    readonly stats: WebrtcDebugStats | null;
-    /** The server half. Null when not wired, or before the first answer. */
-    readonly server: WebrtcSessionDebug | null;
-    /** Why the last server poll produced nothing. Shown verbatim. */
-    readonly serverError: string | null;
-    /** Whether a server poll is wired at all (vs. simply not configured). */
-    readonly serverWired: boolean;
-    /** Ticking clock, so the ages re-render between polls. */
-    readonly now: number;
-    readonly sessionId: string | null;
+	/** The client half. Null before the first successful poll. */
+	readonly stats: WebrtcDebugStats | null;
+	/** The server half. Null when not wired, or before the first answer. */
+	readonly server: WebrtcSessionDebug | null;
+	/** Why the last server poll produced nothing. Shown verbatim. */
+	readonly serverError: string | null;
+	/** Whether a server poll is wired at all (vs. simply not configured). */
+	readonly serverWired: boolean;
+	/** Ticking clock, so the ages re-render between polls. */
+	readonly now: number;
+	readonly sessionId: string | null;
 }
 export declare function StreamDebugOverlay(props: StreamDebugOverlayProps): ReactNode;