@camstack/ui-library 0.1.57 → 0.2.0

package/dist/composites/provider-badge.d.ts

@@ -4,4 +4,4 @@ export interface ProviderBadgeProps {
     showLabel?: boolean;
     className?: string;
 }
-export declare function ProviderBadge({ provider, showLabel, className, }: ProviderBadgeProps): import("react/jsx-runtime").JSX.Element;
+export declare function ProviderBadge({ provider, showLabel, className }: ProviderBadgeProps): import("react").JSX.Element;

package/dist/composites/ptz-overlay.d.ts

@@ -17,4 +17,4 @@ export interface PTZOverlayProps {
     readonly showHome?: boolean;
     readonly className?: string;
 }
-export declare function PTZOverlay({ controls, mode, showPresets, showZoom, showHome, className, }: PTZOverlayProps): import("react/jsx-runtime").JSX.Element;
+export declare function PTZOverlay({ controls, mode, showPresets, showZoom, showHome, className, }: PTZOverlayProps): import("react").JSX.Element;

package/dist/composites/qr-code.d.ts

@@ -9,4 +9,4 @@ export interface QrCodeProps {
     /** Accessible label for the generated QR. */
     readonly alt?: string;
 }
-export declare function QrCode({ value, size, className, alt }: QrCodeProps): ReactElement | null;
+export declare function QrCode({ value, size, className, alt, }: QrCodeProps): ReactElement | null;

package/dist/composites/response-log.d.ts

@@ -6,4 +6,4 @@ export interface ResponseLogProps {
 /**
  * Expandable log box showing the raw JSON response from a pipeline run.
  */
-export declare function ResponseLog({ data, label, className }: ResponseLogProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function ResponseLog({ data, label, className }: ResponseLogProps): import("react").JSX.Element | null;

package/dist/composites/scope-picker.d.ts

@@ -14,7 +14,7 @@ interface ScopePickerProps {
     /** Optional empty-state CTA when `value.length === 0`. */
     readonly emptyHint?: ReactNode;
 }
-export declare function ScopePicker({ value, onChange, clampToParent, emptyHint }: ScopePickerProps): React.ReactElement;
+export declare function ScopePicker({ value, onChange, clampToParent, emptyHint, }: ScopePickerProps): React.ReactElement;
 /**
  * Validation helper. The wire schema (`TokenScopeSchema`) requires every
  * scope to carry a non-empty target/targets and `access.length >= 1`.

package/dist/composites/slide-over-panel.d.ts

@@ -8,4 +8,4 @@ export interface SlideOverPanelProps {
     readonly children: ReactNode;
     readonly widthClass?: string;
 }
-export declare function SlideOverPanel({ open, onClose, title, subtitle, footer, children, widthClass, }: SlideOverPanelProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function SlideOverPanel({ open, onClose, title, subtitle, footer, children, widthClass, }: SlideOverPanelProps): import("react").JSX.Element | null;

package/dist/composites/snapshot-button.d.ts

@@ -21,5 +21,5 @@ export interface SnapshotButtonProps {
     readonly size?: 'sm' | 'md';
     readonly className?: string;
 }
-export declare function SnapshotButton({ trpc, deviceId, deviceName, size, className, }: SnapshotButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare function SnapshotButton({ trpc, deviceId, deviceName, size, className, }: SnapshotButtonProps): import("react").JSX.Element;
 export {};

package/dist/composites/stat-card.d.ts

@@ -7,4 +7,4 @@ export interface StatCardProps {
     };
     className?: string;
 }
-export declare function StatCard({ value, label, trend, className }: StatCardProps): import("react/jsx-runtime").JSX.Element;
+export declare function StatCard({ value, label, trend, className }: StatCardProps): import("react").JSX.Element;

package/dist/composites/state-values-stream.d.ts

@@ -23,4 +23,4 @@ export interface StateValuesStreamProps {
     readonly onClose?: () => void;
     readonly className?: string;
 }
-export declare function StateValuesStream({ deviceId, defaultCaps, maxHeight, onClose, className, }: StateValuesStreamProps): import("react/jsx-runtime").JSX.Element;
+export declare function StateValuesStream({ deviceId, defaultCaps, maxHeight, onClose, className, }: StateValuesStreamProps): import("react").JSX.Element;

package/dist/composites/status-badge.d.ts

@@ -6,5 +6,5 @@ export interface StatusBadgeProps {
     size?: 'sm' | 'md';
     className?: string;
 }
-export declare function StatusBadge({ status, showDot, showLabel, size, className, }: StatusBadgeProps): import("react/jsx-runtime").JSX.Element;
+export declare function StatusBadge({ status, showDot, showLabel, size, className, }: StatusBadgeProps): import("react").JSX.Element;
 export {};

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

@@ -6,4 +6,4 @@ export interface StepTimingsProps {
     readonly totalMs?: number;
     readonly className?: string;
 }
-export declare function StepTimings({ timings, totalMs, className }: StepTimingsProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function StepTimings({ timings, totalMs, className }: StepTimingsProps): import("react").JSX.Element | null;

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

@@ -18,7 +18,7 @@ export interface StepTreeMasterProps {
     }[]>>;
     readonly className?: string;
 }
-export declare function StepTreeMaster({ tree, selectedAddonId, onSelect, agentDots, className, }: StepTreeMasterProps): import("react/jsx-runtime").JSX.Element;
+export declare function StepTreeMaster({ tree, selectedAddonId, onSelect, agentDots, className, }: StepTreeMasterProps): import("react").JSX.Element;
 /**
  * Helper: build a StepTreeNode[] from a `PipelineSchema` by chaining on
  * `inputClasses` ⇔ `outputClasses` compatibility. Mirrors the orchestrator

package/dist/composites/stream-panel.d.ts

@@ -1,16 +1,16 @@
 import { ReactNode } from 'react';
-import { SignalingResult, ClientOfferResult, ClientStreamHints } from './camera-stream-player';
+import { CamProfile } from '@camstack/types';
+import { SignalingResult, ClientOfferResult, ClientStreamHints, SessionSignalingState } from './camera-stream-player';
 import { DeviceDetections } from '../hooks/use-device-detections';
 /**
- * Discriminated WebRTC target — same shape as the backend cap. Kept
- * locally on the StreamChoice so consumers don't need to import from
- * `@camstack/types` to render a panel.
+ * Discriminated WebRTC target — same shape as the backend cap. The
+ * `profile` tier uses the canonical `CamProfile` enum.
  */
 export type StreamChoiceTarget = {
     readonly kind: 'adaptive';
 } | {
     readonly kind: 'profile';
-    readonly profile: 'high' | 'mid' | 'low';
+    readonly profile: CamProfile;
 } | {
     readonly kind: 'cam-stream';
     readonly camStreamId: string;
@@ -42,16 +42,16 @@ export interface StreamStats {
     readonly uptimeMs: number;
 }
 export interface StreamPanelProps {
-    readonly serverUrl: string;
-    readonly createSession: (target: StreamChoiceTarget, hints?: ClientStreamHints) => Promise<SignalingResult>;
-    readonly sendAnswer: (sessionId: string, sdpAnswer: string) => Promise<void>;
+    readonly serverUrl?: string;
+    readonly createSession?: (target: StreamChoiceTarget, hints?: ClientStreamHints) => Promise<SignalingResult>;
+    readonly sendAnswer?: (sessionId: string, sdpAnswer: string) => Promise<void>;
     /**
      * Client-offer signaling — PREFERRED over `createSession` for browsers.
      * Closes over the selected target; the player builds the offer and this
      * posts it. Lets iOS pass H.264 High/Main (incl. 4K) through untouched.
      * Optional so non-browser callers (benchmark) can stay on server-offer.
      */
-    readonly handleOffer?: (target: StreamChoiceTarget, sdpOffer: string) => Promise<ClientOfferResult>;
+    readonly handleOffer?: (target: StreamChoiceTarget, sdpOffer: string, sessionId?: string) => Promise<ClientOfferResult>;
     /** Browser-side ICE servers (STUN + TURN) for client-offer mode. */
     readonly getIceServers?: () => Promise<readonly RTCIceServer[] | undefined>;
     /** Trickle ICE — push a client candidate to the server (sessionId-scoped). */
@@ -62,6 +62,34 @@ export interface StreamPanelProps {
         done: boolean;
     }>;
     readonly closeSession?: (sessionId: string) => Promise<void>;
+    /**
+     * Poll a session's live signaling state (client-offer mode). A non-null
+     * `pendingRenegotiation` after an adaptive tier switch makes the player
+     * transparently re-offer on the same session. Optional — omit to disable
+     * adaptive re-offer (steady-state behaviour is unchanged).
+     */
+    readonly getSessionState?: (sessionId: string) => Promise<SessionSignalingState>;
+    /**
+     * When set, the panel switches to VOD mode: it renders an `HlsVideo`
+     * over this master `.m3u8` URL INSTEAD of the live WebRTC player, and
+     * the live signaling props are ignored. Lets the same hero player show
+     * recordings/clips (driven by the Recording tab) without a second
+     * player. Clearing it returns the panel to live mode.
+     */
+    readonly playbackUrl?: string;
+    /** Bearer token for the admin-gated data-plane playback route (optional). */
+    readonly playbackAuthToken?: string | null;
+    /**
+     * Short label for the clip/window being played — shown in the header in
+     * place of the stream selector while in VOD mode.
+     */
+    readonly playbackLabel?: string;
+    /**
+     * Invoked when the operator clicks the (re-purposed) play/stop button
+     * while in VOD mode. The caller clears its playback request to return
+     * the panel to the live stream.
+     */
+    readonly onExitPlayback?: () => void;
     /** Available streams. If omitted or single entry, no dropdown shown. */
     readonly streams?: readonly StreamChoice[];
     /** Currently active StreamChoice id. Defaults to first stream. */
@@ -90,6 +118,13 @@ export interface StreamPanelProps {
     readonly showPlayStop?: boolean;
     /** Snapshot source URL (data: URI). Only used when showPlayStop=true. */
     readonly snapshotSrc?: string | null;
+    /**
+     * Optional poster (snapshot data-URL) painted by the live `<video>` until
+     * its FIRST frame decodes — a cold-start fallback only. Independent of
+     * `snapshotSrc` (which is the play/stop preview). Caller-supplied; when
+     * omitted the video simply starts black until the first frame.
+     */
+    readonly posterUrl?: string;
     /** Whether snapshot is currently loading */
     readonly snapshotLoading?: boolean;
     /** Callback to refresh snapshot */
@@ -156,4 +191,4 @@ export interface StreamPanelProps {
     readonly chromeless?: boolean;
     readonly className?: string;
 }
-export declare function StreamPanel({ serverUrl, createSession, sendAnswer, handleOffer, getIceServers, addIceCandidate, getIceCandidates, closeSession, streams, activeStreamId: controlledStreamId, onStreamChange, deviceName, phase, pipelineMetrics, detections, defaultShowDetections, defaultShowMotion, streamStats, autoPlay, showPlayStop, snapshotSrc, snapshotLoading, onRefreshSnapshot, showStreamStats, children, extraOverlay, ptzAvailable, ptzShown, ptzOverlay, onPtzToggle, intercomAvailable, intercomShown, onIntercomToggle, chromeless, className, }: StreamPanelProps): import("react/jsx-runtime").JSX.Element;
+export declare function StreamPanel({ serverUrl, createSession, sendAnswer, handleOffer, getIceServers, addIceCandidate, getIceCandidates, closeSession, getSessionState, playbackUrl, playbackAuthToken, onExitPlayback, posterUrl, streams, activeStreamId: controlledStreamId, onStreamChange, deviceName, phase, pipelineMetrics, detections, defaultShowDetections, defaultShowMotion, streamStats, autoPlay, showPlayStop, snapshotSrc, snapshotLoading, onRefreshSnapshot, showStreamStats, children, extraOverlay, ptzAvailable, ptzShown, ptzOverlay, onPtzToggle, intercomAvailable, intercomShown, onIntercomToggle, chromeless, className, }: StreamPanelProps): import("react").JSX.Element;

package/dist/composites/timezone-selector.d.ts

@@ -0,0 +1,18 @@
+import { TIMEZONES, findTimezone, Timezone, TimezoneDstRule, Weekday } from '@camstack/types';
+export { TIMEZONES, findTimezone };
+export type { Timezone, TimezoneDstRule, Weekday };
+export interface TimezoneSelectorProps {
+    /** Currently selected IANA id (e.g. 'Europe/Rome'). */
+    readonly value: string;
+    /** Fired with the newly chosen IANA id. */
+    readonly onChange: (id: string) => void;
+    readonly disabled?: boolean;
+}
+/**
+ * Friendly timezone picker. Renders a native `<select>` grouped by
+ * region via `<optgroup>`, sourced from the curated `TIMEZONES`
+ * catalogue. The selected value is the IANA id; DST is implied by the
+ * chosen zone (each option carries its standard offset + DST rule),
+ * so there is no separate DST control.
+ */
+export declare function TimezoneSelector({ value, onChange, disabled }: TimezoneSelectorProps): import("react").JSX.Element;

package/dist/composites/version-badge.d.ts

@@ -11,7 +11,7 @@ export interface SemanticBadgeProps {
  * General-purpose badge with semantic color variants.
  * Solid background with dark text for maximum contrast.
  */
-export declare function SemanticBadge({ children, variant, mono, className }: SemanticBadgeProps): import("react/jsx-runtime").JSX.Element;
+export declare function SemanticBadge({ children, variant, mono, className, }: SemanticBadgeProps): React.JSX.Element;
 export interface VersionBadgeProps {
     version: string;
     preRelease?: boolean;
@@ -21,4 +21,4 @@ export interface VersionBadgeProps {
  * Version badge — auto-detects pre-release versions.
  * Stable = success (green), Pre-release = warning (amber).
  */
-export declare function VersionBadge({ version, preRelease, className }: VersionBadgeProps): import("react/jsx-runtime").JSX.Element;
+export declare function VersionBadge({ version, preRelease, className }: VersionBadgeProps): React.JSX.Element;

package/dist/composites/widget-panel.d.ts

@@ -0,0 +1,28 @@
+import { ReactNode } from 'react';
+interface WidgetPanelProps {
+    /** Header title — rendered uppercase, letter-spaced, foreground. */
+    readonly title: string;
+    /** Optional leading icon node (size it `h-3.5 w-3.5` for alignment). */
+    readonly icon?: ReactNode;
+    /** Optional right-aligned header slot (timestamp, live badge, …). Ignored
+     *  when `collapsible` is set — the chevron takes that slot. */
+    readonly headerRight?: ReactNode;
+    /** Render the header as a toggle that shows/hides the body. */
+    readonly collapsible?: boolean;
+    /** Initial open state for a collapsible panel (default open). */
+    readonly defaultOpen?: boolean;
+    /** Body padding/utility override (default `p-3`). */
+    readonly bodyClassName?: string;
+    readonly children: ReactNode;
+}
+export declare function WidgetPanel({ title, icon, headerRight, collapsible, defaultOpen, bodyClassName, children, }: WidgetPanelProps): import("react").JSX.Element;
+interface WidgetMetricCardProps {
+    readonly label: string;
+    readonly icon?: ReactNode;
+    /** The metric value (text or node). */
+    readonly children: ReactNode;
+    /** Optional sub-line under the value (e.g. "3 segment ranges"). */
+    readonly footer?: ReactNode;
+}
+export declare function WidgetMetricCard({ label, icon, children, footer }: WidgetMetricCardProps): import("react").JSX.Element;
+export {};

package/dist/contexts/custom-field-renderers.d.ts

@@ -17,7 +17,7 @@ export interface CustomFieldRenderersProviderProps {
     readonly renderers: CustomFieldRendererMap;
     readonly children: ReactNode;
 }
-export declare function CustomFieldRenderersProvider({ renderers, children, }: CustomFieldRenderersProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function CustomFieldRenderersProvider({ renderers, children, }: CustomFieldRenderersProviderProps): import("react").JSX.Element;
 /**
  * Look up a registered renderer by `field.type`. Returns null when no
  * renderer is registered — caller falls back to its built-in handling

package/dist/contexts/device-context.d.ts

@@ -13,7 +13,7 @@ export interface DeviceContextProviderProps {
     readonly device?: DeviceSnapshot;
     readonly children: ReactNode;
 }
-export declare function DeviceContextProvider({ deviceId, device, children }: DeviceContextProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function DeviceContextProvider({ deviceId, device, children }: DeviceContextProviderProps): import("react").JSX.Element;
 /** @returns the device id of the current page subtree, or null if outside any provider. */
 export declare function useDeviceId(): number | null;
 /** @returns the cached device snapshot, or null when no snapshot is provided. */

package/dist/contexts/player-overlays.d.ts

@@ -33,7 +33,7 @@ export interface PlayerToolbarButton {
 export interface PlayerOverlaysProviderProps {
     readonly children: ReactNode;
 }
-export declare function PlayerOverlaysProvider({ children }: PlayerOverlaysProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function PlayerOverlaysProvider({ children }: PlayerOverlaysProviderProps): import("react").JSX.Element;
 /** Snapshot of registered layers ordered by `order` (asc, ties resolved
  *  by insertion order of the underlying Map). Returns `[]` outside a
  *  provider. */

package/dist/contexts/system-context.d.ts

@@ -4,7 +4,7 @@ export interface SystemProviderProps {
     readonly system: System;
     readonly children: ReactNode;
 }
-export declare function SystemProvider({ system, children }: SystemProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function SystemProvider({ system, children }: SystemProviderProps): import("react").JSX.Element;
 /**
  * Read the active `System` instance from the surrounding `<SystemProvider>`.
  * Throws when no provider is mounted — every hook in this directory

package/dist/contexts/vod-playback.d.ts

@@ -0,0 +1,17 @@
+import { ReactNode } from 'react';
+export interface VodPlaybackRequest {
+    /** Master `.m3u8` URL through the hub data-plane (relative). */
+    readonly url: string;
+    /** Short human label shown in the hero while playing (e.g. a timestamp). */
+    readonly label?: string;
+}
+export interface VodPlaybackContextValue {
+    readonly request: VodPlaybackRequest | null;
+    readonly play: (request: VodPlaybackRequest) => void;
+    readonly clear: () => void;
+}
+export declare function VodPlaybackProvider({ children }: {
+    readonly children: ReactNode;
+}): import("react").JSX.Element;
+/** @returns the VOD playback controller (inert no-op outside a provider). */
+export declare function useVodPlayback(): VodPlaybackContextValue;

package/dist/contexts/widget-registry.d.ts

@@ -91,7 +91,7 @@ export declare function loadRemoteBundle(remoteName: string, exposedModule: stri
 export interface WidgetRegistryProviderProps {
     readonly children: ReactNode;
 }
-export declare function WidgetRegistryProvider({ children }: WidgetRegistryProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function WidgetRegistryProvider({ children }: WidgetRegistryProviderProps): import("react").JSX.Element;
 /**
  * Returns the registered widget component, `null` while loading, or
  * `undefined` if unknown.

package/dist/contexts/zone-editing.d.ts

@@ -51,7 +51,7 @@ interface ZoneEditingContextValue extends ZoneEditingState, ZoneEditingActions {
 export interface ZoneEditingProviderProps {
     readonly children: ReactNode;
 }
-export declare function ZoneEditingProvider({ children }: ZoneEditingProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function ZoneEditingProvider({ children }: ZoneEditingProviderProps): import("react").JSX.Element;
 /** Read + drive the zone-editing state. Returns `null` outside a
  *  provider so callers that mount in pages without zones (e.g. a
  *  shared hero on a non-camera device) can no-op gracefully. */