@camstack/ui-library 1.2.257 → 1.2.258

package/dist/composites/hls-quality.d.ts

@@ -1,35 +1,35 @@
 /**
- * Pure helpers for the HLS playback quality selector.
- *
- * Intentionally decoupled from hls.js types so this module can be
- * imported and tested without a DOM or MSE environment.
- */
+* Pure helpers for the HLS playback quality selector.
+*
+* Intentionally decoupled from hls.js types so this module can be
+* imported and tested without a DOM or MSE environment.
+*/
 export interface QualityOption {
-    readonly value: number;
-    readonly label: string;
+	readonly value: number;
+	readonly label: string;
 }
 export interface HlsLevelInfo {
-    readonly height?: number;
-    readonly bitrate?: number;
-    readonly name?: string;
+	readonly height?: number;
+	readonly bitrate?: number;
+	readonly name?: string;
 }
 /**
- * Build a human-readable label for a single HLS level.
- *
- * Priority:
- * 1. `name` (non-empty) → verbatim. The recorder stamps the master variant
- *    NAME with the recording profile (high/mid/low), and the VOD selector must
- *    match the live stream-profile selector's labels — the profile name wins
- *    over resolution/bitrate.
- * 2. `height` (> 0) → e.g. "1080p"
- * 3. `bitrate` (> 0) → e.g. "2500 kbps"
- * 4. Fallback → "Level N" (1-based)
- */
+* Build a human-readable label for a single HLS level.
+*
+* Priority:
+* 1. `name` (non-empty) → verbatim. The recorder stamps the master variant
+*    NAME with the recording profile (high/mid/low), and the VOD selector must
+*    match the live stream-profile selector's labels — the profile name wins
+*    over resolution/bitrate.
+* 2. `height` (> 0) → e.g. "1080p"
+* 3. `bitrate` (> 0) → e.g. "2500 kbps"
+* 4. Fallback → "Level N" (1-based)
+*/
 export declare function levelLabel(level: HlsLevelInfo, index: number): string;
 /**
- * Build the full list of quality options for the selector overlay.
- *
- * Always starts with the Auto entry (`value: -1`), followed by one
- * entry per available HLS level in manifest order.
- */
+* Build the full list of quality options for the selector overlay.
+*
+* Always starts with the Auto entry (`value: -1`), followed by one
+* entry per available HLS level in manifest order.
+*/
 export declare function qualityOptions(levels: readonly HlsLevelInfo[]): QualityOption[];

package/dist/composites/hls-video.d.ts

@@ -1,41 +1,64 @@
-import { QualityOption } from './hls-quality';
+/**
+* HlsVideo — reusable HLS (VOD) `<video>` for recorded playback.
+*
+* The recorder serves SELF-CONTAINED per-segment fMP4 (each `.m4s` carries
+* its own ftyp+moov) with reset timestamps and NO EXT-X-MAP. hls.js handles
+* that shape; NATIVE Safari HLS rejects it (loads the first frame then stalls
+* building the timeline → "could not load"). So hls.js is PREFERRED and native
+* is a last-resort fallback only.
+*
+* The playback URL is served through the hub data-plane reverse-proxy
+* (`/addon/<addonId>/...`) — same origin/cert as the admin-ui (no mixed
+* content). The route is admin-gated: hls.js sends the stored admin Bearer via
+* `xhrSetup`, and `withCredentials` lets the same-origin session cookie ride
+* too (so the native fallback, which can't set a header, still authenticates).
+*
+* Data-agnostic: the caller fetches the manifest URL + supplies the auth token
+* (ui-library never reaches into localStorage).
+*
+* Quality state is LIFTED to the caller via `onQualityOptions` / `selectedLevel`
+* so the parent (StreamPanel) can render the selector in the header alongside
+* the live stream selector, at the same position and with the same styling.
+*/
+import { type JSX } from "react";
+import { type QualityOption } from "./hls-quality";
 export interface HlsVideoProps {
-    /** Media URL (typically relative, through the hub data-plane) — an HLS
-     *  master `.m3u8`, or a progressive `.mp4` when {@link format} says so. */
-    readonly url: string;
-    /**
-     * What {@link url} is. Absent means `hls` — every existing caller is
-     * unchanged by construction.
-     *
-     * `mp4` is the NATIVE-CLIP path (D549 22): a vendor addon fetched the
-     * camera's own file, muxed it once with `+faststart` and serves it with
-     * `Range`, so a plain `<video src>` seeks natively and hls.js is not
-     * involved at all — handing it an MP4 would have it parse the file as a
-     * manifest and fail. **Nothing is appended to the URL**: the hub's
-     * `/addon/<id>/<prefix>` proxy takes the same-origin session cookie, which
-     * is what the native-Safari branch below already relies on, so the URL is
-     * never a credential.
-     */
-    readonly format?: 'hls' | 'mp4';
-    /** Bearer token for the admin-gated data-plane route (optional). */
-    readonly authToken?: string | null;
-    /** Poster painted until the first frame decodes (optional). */
-    readonly posterUrl?: string;
-    /** Auto-play once the manifest is parsed (default: true). */
-    readonly autoPlay?: boolean;
-    readonly className?: string;
-    /**
-     * Called on MANIFEST_PARSED (and reset to `[]` on a new URL) with the
-     * full list of quality options (`qualityOptions(hls.levels)`). The caller
-     * renders the selector; this component owns only the hls instance.
-     * Emits `[]` when the manifest has ≤1 real level (no selector needed).
-     */
-    readonly onQualityOptions?: (options: readonly QualityOption[]) => void;
-    /**
-     * The level index to apply to `hls.currentLevel`. `-1` = Auto/ABR
-     * (default). When this prop changes, the component sets `hls.currentLevel`
-     * immediately. Has no effect in the native HLS fallback path.
-     */
-    readonly selectedLevel?: number;
+	/** Media URL (typically relative, through the hub data-plane) — an HLS
+	*  master `.m3u8`, or a progressive `.mp4` when {@link format} says so. */
+	readonly url: string;
+	/**
+	* What {@link url} is. Absent means `hls` — every existing caller is
+	* unchanged by construction.
+	*
+	* `mp4` is the NATIVE-CLIP path (D549 22): a vendor addon fetched the
+	* camera's own file, muxed it once with `+faststart` and serves it with
+	* `Range`, so a plain `<video src>` seeks natively and hls.js is not
+	* involved at all — handing it an MP4 would have it parse the file as a
+	* manifest and fail. **Nothing is appended to the URL**: the hub's
+	* `/addon/<id>/<prefix>` proxy takes the same-origin session cookie, which
+	* is what the native-Safari branch below already relies on, so the URL is
+	* never a credential.
+	*/
+	readonly format?: "hls" | "mp4";
+	/** Bearer token for the admin-gated data-plane route (optional). */
+	readonly authToken?: string | null;
+	/** Poster painted until the first frame decodes (optional). */
+	readonly posterUrl?: string;
+	/** Auto-play once the manifest is parsed (default: true). */
+	readonly autoPlay?: boolean;
+	readonly className?: string;
+	/**
+	* Called on MANIFEST_PARSED (and reset to `[]` on a new URL) with the
+	* full list of quality options (`qualityOptions(hls.levels)`). The caller
+	* renders the selector; this component owns only the hls instance.
+	* Emits `[]` when the manifest has ≤1 real level (no selector needed).
+	*/
+	readonly onQualityOptions?: (options: readonly QualityOption[]) => void;
+	/**
+	* The level index to apply to `hls.currentLevel`. `-1` = Auto/ABR
+	* (default). When this prop changes, the component sets `hls.currentLevel`
+	* immediately. Has no effect in the native HLS fallback path.
+	*/
+	readonly selectedLevel?: number;
 }
-export declare function HlsVideo({ url, format, authToken, posterUrl, autoPlay, className, onQualityOptions, selectedLevel, }: HlsVideoProps): import("react").JSX.Element;
+export declare function HlsVideo({ url, format, authToken, posterUrl, autoPlay, className, onQualityOptions, selectedLevel }: HlsVideoProps): JSX.Element;

package/dist/composites/hover-zoom-image.d.ts

@@ -1,18 +1,37 @@
-import { ReactNode } from 'react';
+/**
+* <HoverZoomImage> — a small thumbnail that expands into a floating
+* enlarged preview on hover/focus.
+*
+* One responsibility: render a compact thumbnail (image when `src` is
+* present, a muted `ImageOff` placeholder box when null) and, while the
+* thumbnail is hovered or focused, portal a larger preview to
+* `document.body` positioned with FLIP-ON-COLLISION:
+*   - the position is computed from the thumbnail's `getBoundingClientRect`;
+*   - placed ABOVE the thumbnail unless there is insufficient space (then
+*     below); left-clamped to the viewport;
+*   - `position:fixed`, `pointer-events:none`, `z-[9999]`.
+*
+* The portal is what lets this work inside the device grid, whose overflow
+* ancestors would otherwise clip a normally-positioned popover.
+*
+* Reused by BOTH the Image DeviceType inline control (signed image url) and
+* the camera-snapshot cell in device rows (snapshot blob/object url).
+*/
+import { type ReactNode } from "react";
 export interface HoverZoomImageProps {
-    /** Image URL (signed url for Image entities; snapshot object url for cameras). Null → placeholder. */
-    readonly src: string | null;
-    /** Accessible alt / default preview caption (e.g. the device name). */
-    readonly alt: string;
-    /** Optional small label under the enlarged preview. Defaults to `alt`. */
-    readonly caption?: string;
-    /** Text shown in the enlarged preview (and implied by the thumbnail's empty state) when there is no image. */
-    readonly placeholder?: string;
-    /** Sizing override for the thumbnail box. Defaults to a compact `h-7 w-7 rounded`. */
-    readonly thumbClassName?: string;
-    /** Enlarged-preview width in px. */
-    readonly expandedWidth?: number;
-    /** Enlarged-preview height in px (drives the flip-on-collision math). */
-    readonly expandedHeight?: number;
+	/** Image URL (signed url for Image entities; snapshot object url for cameras). Null → placeholder. */
+	readonly src: string | null;
+	/** Accessible alt / default preview caption (e.g. the device name). */
+	readonly alt: string;
+	/** Optional small label under the enlarged preview. Defaults to `alt`. */
+	readonly caption?: string;
+	/** Text shown in the enlarged preview (and implied by the thumbnail's empty state) when there is no image. */
+	readonly placeholder?: string;
+	/** Sizing override for the thumbnail box. Defaults to a compact `h-7 w-7 rounded`. */
+	readonly thumbClassName?: string;
+	/** Enlarged-preview width in px. */
+	readonly expandedWidth?: number;
+	/** Enlarged-preview height in px (drives the flip-on-collision math). */
+	readonly expandedHeight?: number;
 }
-export declare function HoverZoomImage({ src, alt, caption, placeholder, thumbClassName, expandedWidth, expandedHeight, }: HoverZoomImageProps): ReactNode;
+export declare function HoverZoomImage({ src, alt, caption, placeholder, thumbClassName, expandedWidth, expandedHeight }: HoverZoomImageProps): ReactNode;

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

@@ -1,55 +1,91 @@
-import { DisplayIconGroup } from '@camstack/types';
-import { LucideIcon } from 'lucide-react';
+/**
+* icon-picker — the ONE control for choosing an icon, wherever admin-ui asks.
+*
+* There were two: a device one over `DISPLAY_ICON_REGISTRY` and a room one
+* over `LOCATION_ICON_IDS`, identical apart from the vocabulary they walked.
+* That was tolerable while the device set was 56 glyphs in a flat grid. It is
+* not at 157: a picker that only lets the operator HUNT is a picker they stop
+* using, and the two copies were already drifting — only one of them had an
+* i18n'd label.
+*
+* So the vocabulary, the grouping and the search all come from
+* `@camstack/types`' `display-icon-vocabulary`, which is the same module the
+* viewer's sheet searches. What is left here is the web half: a popover, a
+* grid, and a text field.
+*
+* ## What it does NOT own
+*
+* - **The glyphs.** `resolveGlyph` is a prop, because this package's table is
+*   `lucide-react` and the viewer's is `lucide-react-native`. A key this build
+*   cannot draw is SKIPPED rather than rendered as a hole — an empty tile
+*   reads as a rendering bug, not as a missing choice.
+* - **The words.** Every string is a prop. This package has no i18n (one file
+*   in it imports react-i18next, and that is the exception), and a control
+*   that reached for a translation would force it on every consumer.
+* - **The write.** `onPick` is called and that is all; whether it is a form
+*   value or an immediate mutation is the caller's business, as it already was
+*   in both pickers this replaces.
+*
+* ## The clear tile is never filtered away
+*
+* The "inherit" / "no icon" choice sits above the sections and ignores the
+* search. A query that hid it would strand the operator on a glyph they picked
+* by accident with no way back to the default — the one action a picker must
+* always offer.
+*/
+import { type DisplayIconGroup } from "@camstack/types";
+import type { LucideIcon } from "lucide-react";
+import { type JSX } from "react";
 /** The strings this control shows. All of them, so nothing is hardcoded. */
 export interface IconPickerLabels {
-    /** The trigger button's accessible name, e.g. "Change the icon of Kitchen". */
-    readonly trigger: string;
-    /** The popover's accessible name. */
-    readonly panel: string;
-    /** The backdrop button's accessible name. */
-    readonly close: string;
-    readonly searchPlaceholder: string;
-    /** The tile that clears the pick — "No icon", "Inherit from the role", … */
-    readonly clear: string;
-    /** Shown in place of the grid when the query matches nothing. */
-    readonly noMatches: string;
-    /** One per group, keyed by group id. */
-    readonly groups: Readonly<Record<DisplayIconGroup, string>>;
+	/** The trigger button's accessible name, e.g. "Change the icon of Kitchen". */
+	readonly trigger: string;
+	/** The popover's accessible name. */
+	readonly panel: string;
+	/** The backdrop button's accessible name. */
+	readonly close: string;
+	readonly searchPlaceholder: string;
+	/** The tile that clears the pick — "No icon", "Inherit from the role", … */
+	readonly clear: string;
+	/** Shown in place of the grid when the query matches nothing. */
+	readonly noMatches: string;
+	/** One per group, keyed by group id. */
+	readonly groups: Readonly<Record<DisplayIconGroup, string>>;
 }
 export interface IconPickerProps {
-    /** The chosen key, or `null` for "nothing chosen". */
-    readonly value: string | null;
-    /** `null` clears the choice. */
-    readonly onPick: (key: string | null) => void | Promise<void>;
-    /**
-     * The glyph for a key, or `undefined` when this build cannot draw it. The
-     * caller's table, never a lookup this component makes.
-     */
-    readonly resolveGlyph: (key: string) => LucideIcon | undefined;
-    /** What the trigger draws when `value` is null or undrawable. */
-    readonly fallbackGlyph: LucideIcon;
-    /**
-     * The glyph on the clear tile. Defaults to {@link fallbackGlyph}, which is
-     * right when clearing means "inherit" and the tile should show what will be
-     * inherited. A picker where clearing means "none at all" passes its own.
-     */
-    readonly clearGlyph?: LucideIcon;
-    /**
-     * A human name for a key, for the tile's title and accessible name. The key
-     * itself when absent — which is honest, since the key IS what gets stored.
-     */
-    readonly labelFor?: (key: string) => string | undefined;
-    readonly labels: IconPickerLabels;
-    /**
-     * Restrict the vocabulary to these keys — the room picker offers only
-     * `LOCATION_ICON_IDS`. Absent means the whole vocabulary.
-     */
-    readonly only?: readonly string[];
-    /**
-     * Extra searchable words per key, for a caller that has translations this
-     * package cannot see. Scored exactly like a synonym.
-     */
-    readonly extraWords?: ReadonlyMap<string, readonly string[]>;
-    readonly disabled?: boolean;
+	/** The chosen key, or `null` for "nothing chosen". */
+	readonly value: string | null;
+	/** `null` clears the choice. */
+	readonly onPick: (key: string | null) => void | Promise<void>;
+	/**
+	* The glyph for a key, or `undefined` when this build cannot draw it. The
+	* caller's table, never a lookup this component makes.
+	*/
+	readonly resolveGlyph: (key: string) => LucideIcon | undefined;
+	/** What the trigger draws when `value` is null or undrawable. */
+	readonly fallbackGlyph: LucideIcon;
+	/**
+	* The glyph on the clear tile. Defaults to {@link fallbackGlyph}, which is
+	* right when clearing means "inherit" and the tile should show what will be
+	* inherited. A picker where clearing means "none at all" passes its own.
+	*/
+	readonly clearGlyph?: LucideIcon;
+	/**
+	* A human name for a key, for the tile's title and accessible name. The key
+	* itself when absent — which is honest, since the key IS what gets stored.
+	*/
+	readonly labelFor?: (key: string) => string | undefined;
+	readonly labels: IconPickerLabels;
+	/**
+	* Restrict the vocabulary to these keys — the room picker offers only
+	* `LOCATION_ICON_IDS`. Absent means the whole vocabulary.
+	*/
+	readonly only?: readonly string[];
+	/**
+	* Extra searchable words per key, for a caller that has translations this
+	* package cannot see. Scored exactly like a synonym.
+	*/
+	readonly extraWords?: ReadonlyMap<string, readonly string[]>;
+	readonly disabled?: boolean;
 }
-export declare function IconPicker({ value, onPick, resolveGlyph, fallbackGlyph, labels, only, extraWords, clearGlyph, labelFor, disabled, }: IconPickerProps): import("react").JSX.Element;
+export declare function IconPicker({ value, onPick, resolveGlyph, fallbackGlyph, labels, only, extraWords, clearGlyph, labelFor, disabled }: IconPickerProps): JSX.Element | null;

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

@@ -1,25 +1,26 @@
+import { type JSX } from "react";
 /**
- * ImageSelector — chip-style picker for reference media + upload button.
- * Despite the historical name it's media-agnostic: pass `accept` to
- * filter the file picker (defaults to `image/*`). Used by both the
- * Image Tester and the Audio Tester so the two tabs share the exact
- * same selection UI.
- */
+* ImageSelector — chip-style picker for reference media + upload button.
+* Despite the historical name it's media-agnostic: pass `accept` to
+* filter the file picker (defaults to `image/*`). Used by both the
+* Image Tester and the Audio Tester so the two tabs share the exact
+* same selection UI.
+*/
 export interface ReferenceImage {
-    readonly id?: string;
-    readonly filename: string;
-    readonly sizeKB?: number;
+	readonly id?: string;
+	readonly filename: string;
+	readonly sizeKB?: number;
 }
 export interface ImageSelectorProps {
-    readonly images: readonly ReferenceImage[];
-    readonly selectedFilename: string;
-    readonly uploadedName?: string;
-    readonly onSelect: (filename: string) => void;
-    readonly onUpload: (base64: string, filename: string, dataUrl: string) => void;
-    readonly className?: string;
-    /** File picker `accept` value. Default: `image/*`. */
-    readonly accept?: string;
-    /** Override the upload button label. Default: `Upload...`. */
-    readonly uploadLabel?: string;
+	readonly images: readonly ReferenceImage[];
+	readonly selectedFilename: string;
+	readonly uploadedName?: string;
+	readonly onSelect: (filename: string) => void;
+	readonly onUpload: (base64: string, filename: string, dataUrl: string) => void;
+	readonly className?: string;
+	/** File picker `accept` value. Default: `image/*`. */
+	readonly accept?: string;
+	/** Override the upload button label. Default: `Upload...`. */
+	readonly uploadLabel?: string;
 }
-export declare function ImageSelector({ images, selectedFilename, uploadedName, onSelect, onUpload, className, accept, uploadLabel, }: ImageSelectorProps): import("react").JSX.Element;
+export declare function ImageSelector({ images, selectedFilename, uploadedName, onSelect, onUpload, className, accept, uploadLabel }: ImageSelectorProps): JSX.Element;