@camstack/ui-library 1.1.41 → 1.1.43

package/dist/composites/camera-stream-player.d.ts

@@ -168,7 +168,7 @@ export interface CameraStreamPlayerProps {
      * Main/High (incl. 4K) source pass through with NO transcode — the only
      * path that lets iOS decode High. The caller closes over the target.
      */
-    handleOffer?: (sdpOffer: string, sessionId?: string) => Promise<ClientOfferResult>;
+    handleOffer?: (sdpOffer: string, sessionId?: string, hints?: ClientStreamHints) => Promise<ClientOfferResult>;
     /**
      * Fetch the browser-side ICE servers (STUN + TURN) for client-offer mode.
      * Called BEFORE the offer is built so a remote/CGNAT viewer can gather a
@@ -205,7 +205,7 @@ export interface CameraStreamPlayerProps {
      * the server-chosen downgrade target instead. Required (alongside
      * `getSessionState`) for adaptive re-offer to run.
      */
-    reoffer?: (sessionId: string, sdpOffer: string, target: PlayerWebrtcTarget) => Promise<ClientOfferResult>;
+    reoffer?: (sessionId: string, sdpOffer: string, target: PlayerWebrtcTarget, hints?: ClientStreamHints) => Promise<ClientOfferResult>;
     /**
      * Optional poster image (snapshot data-URL) shown by the <video> before
      * the FIRST-EVER frame is decoded. Only a cold-start fallback — once a

package/dist/composites/detection-colors.d.ts

@@ -1,15 +1,14 @@
 /**
- * Detection class colors — single source of truth.
- *
- * Used by: DetectionCanvas (UI), result-annotator (server-side SVG),
- * admin-ui event viewer, and any other place that visualizes detections.
+ * Fixed colors for known detection classes — derived from the taxonomy
+ * (every detection/motion kind) plus the UI-only face/plate classes. Kept as
+ * a named export for back-compat with existing consumers.
  */
-/** Fixed colors for known detection classes */
 export declare const CLASS_COLORS: Readonly<Record<string, string>>;
 /** Primary/default color when nothing else matches */
-export declare const DEFAULT_COLOR = "#f59e42";
+export declare const DEFAULT_COLOR = "#22ff55";
 /**
  * Get the color for a detection class name.
- * Returns a fixed color for known classes, or a deterministic hash-based color for unknown ones.
+ * Resolves: custom override → taxonomy/UI-only fixed color → deterministic
+ * hash-based color for unknown classes.
  */
 export declare function getClassColor(className: string, customColors?: Readonly<Record<string, string>>): string;

package/dist/composites/device-select-field.d.ts

@@ -0,0 +1,16 @@
+import { ConfigDeviceSelectField, ConfigDeviceMultiSelectField } from '@camstack/types';
+import { TranslationFn } from './config-form-builder';
+export declare function DeviceSelectField({ field, value, onChange, disabled, translationFn, }: {
+    field: ConfigDeviceSelectField;
+    value: unknown;
+    onChange: (v: unknown) => void;
+    disabled?: boolean;
+    translationFn?: TranslationFn;
+}): import("react").JSX.Element;
+export declare function DeviceMultiSelectField({ field, value, onChange, disabled, translationFn, }: {
+    field: ConfigDeviceMultiSelectField;
+    value: unknown;
+    onChange: (v: unknown) => void;
+    disabled?: boolean;
+    translationFn?: TranslationFn;
+}): import("react").JSX.Element;

package/dist/composites/device-select-filter.d.ts

@@ -0,0 +1,53 @@
+import { ConfigOption, DeviceSelectFilter } from '@camstack/types';
+/**
+ * Pure, render-free helpers backing the `device-select` / `device-multiselect`
+ * form fields. The field declares only a {@link DeviceSelectFilter}; the
+ * renderer fetches EVERY system device via `deviceManager.listAll` and narrows
+ * the list CLIENT-SIDE with these functions — there is no server-computed
+ * option list.
+ *
+ * Kept separate from the React component so the match/label/search logic is
+ * unit-testable without mounting a tree or mocking tRPC.
+ */
+/**
+ * The minimal projection of a `deviceManager.listAll` row these helpers read.
+ * A structural subset of `DeviceInfo` so a stubbed device (in a test) or the
+ * full wire shape both satisfy it.
+ */
+export interface DeviceSelectCandidate {
+    readonly id: number;
+    readonly type: string;
+    readonly name: string;
+    readonly location?: string | null;
+    readonly features?: readonly string[];
+}
+/**
+ * Does a device satisfy the filter?
+ *
+ * Union match: with an empty/absent filter every device passes; otherwise the
+ * device passes when ANY provided clause matches — its `features` intersect
+ * `caps`, OR its `type` is in `types`. `excludeDeviceId` is subtracted last
+ * (it always drops the device regardless of the other clauses).
+ */
+export declare function deviceMatchesFilter(device: DeviceSelectCandidate, filter?: DeviceSelectFilter): boolean;
+/** Human label for a device option: `Name (Location)` when a location is set. */
+export declare function deviceOptionLabel(device: DeviceSelectCandidate): string;
+/**
+ * Filter a device list and project it into sorted `{ value, label }` options
+ * (value = the device id as a string). Sorted case-insensitively by label so
+ * the picker order is stable.
+ */
+export declare function devicesToOptions(devices: readonly DeviceSelectCandidate[], filter?: DeviceSelectFilter): ConfigOption[];
+/**
+ * Free-text option filter — case-insensitive AND over whitespace tokens, each
+ * matched against the option's `value` + `label` (so a device is found by name,
+ * id, or location). An empty query returns every option in order.
+ */
+export declare function filterDeviceOptions(options: readonly ConfigOption[], query: string): ConfigOption[];
+/**
+ * Resolve the currently-selected values into options IN SELECTION ORDER (so
+ * chips stay stable while searching). A selected value with no matching option
+ * becomes a synthetic `{ value, label: value }` — a stale id still shows as a
+ * removable chip rather than silently vanishing.
+ */
+export declare function selectedDeviceOptions(options: readonly ConfigOption[], selected: readonly string[]): ConfigOption[];

package/dist/composites/event-kind-visuals.d.ts

@@ -0,0 +1,26 @@
+import { LucideIcon } from 'lucide-react';
+import { EventKindDescriptor } from '@camstack/types';
+import { TranslationFn } from './config-form-builder';
+/**
+ * `iconId` → lucide component. Built ONLY from statically-imported icons
+ * (bundle-safe). Unknown ids resolve to the neutral `Tag` fallback.
+ */
+export declare const EVENT_KIND_ICONS: Readonly<Record<string, LucideIcon>>;
+/** Resolve an `iconId` to a lucide component (falls back to `Tag`). */
+export declare function resolveEventKindIcon(iconId: string): LucideIcon;
+/**
+ * Translated label for an event kind — `t(labelKey)` when a translation
+ * exists, else the English `label` fallback. Robust to a missing key: an
+ * i18n backend that echoes the key unchanged (react-i18next default) is
+ * treated as "no translation" and the fallback label is returned, so the UI
+ * never renders a raw `eventKind.*` key.
+ */
+export declare function eventKindLabel(descriptor: Pick<EventKindDescriptor, 'labelKey' | 'label'>, t?: TranslationFn): string;
+export interface EventKindGlyphProps {
+    readonly iconId: string;
+    readonly size?: number;
+    readonly color?: string;
+    readonly className?: string;
+}
+/** Small convenience component: renders the lucide glyph for an `iconId`. */
+export declare function EventKindGlyph({ iconId, size, color, className }: EventKindGlyphProps): import('react').FunctionComponentElement<Omit<import('lucide-react').LucideProps, "ref"> & import('react').RefAttributes<SVGSVGElement>>;

package/dist/composites/index.d.ts

@@ -40,6 +40,8 @@ export type { PipelineRuntimeOption } from './pipeline-runtime-selector';
 export { PipelineBuilder } from './pipeline-builder';
 export type { PipelineBuilderProps } from './pipeline-builder';
 export { CLASS_COLORS, DEFAULT_COLOR, getClassColor } from './detection-colors';
+export { EVENT_KIND_ICONS, resolveEventKindIcon, eventKindLabel, EventKindGlyph, } from './event-kind-visuals';
+export type { EventKindGlyphProps } from './event-kind-visuals';
 export { DetectionCanvas } from './detection-canvas';
 export type { Detection, DetectionCanvasProps } from './detection-canvas';
 export { DetectionResultTree } from './detection-result-tree';
@@ -56,6 +58,9 @@ export type { MountAddonPageOptions } from './mount-addon-page';
 export { ConfigFormBuilder } from './config-form-builder';
 export type { TranslationFn } from './config-form-builder';
 export { ConfigFormField, NodeSelectField, NodeMultiSelectField, isFieldVisible, } from './config-form-field';
+export { DeviceSelectField, DeviceMultiSelectField } from './device-select-field';
+export { deviceMatchesFilter, deviceOptionLabel, devicesToOptions, filterDeviceOptions, selectedDeviceOptions, } from './device-select-filter';
+export type { DeviceSelectCandidate } from './device-select-filter';
 export { TimezoneSelector, TIMEZONES, findTimezone } from './timezone-selector';
 export type { TimezoneSelectorProps, Timezone, TimezoneDstRule, Weekday } from './timezone-selector';
 export { AddonGlobalSettingsForm } from './addon-global-settings-form';

package/dist/generated/system-hooks.d.ts

@@ -43,8 +43,6 @@ export declare const useAddonsListFrameworkPackages: typeof trpc.addons.listFram
 export declare const useAddonsListCapabilityProviders: typeof trpc.addons.listCapabilityProviders.useQuery;
 /** Generated alias around `trpc.addons.setCapabilityProviderEnabled.useMutation`. */
 export declare const useAddonsSetCapabilityProviderEnabled: typeof trpc.addons.setCapabilityProviderEnabled.useMutation;
-/** Generated alias around `trpc.addons.updateFrameworkPackage.useMutation`. */
-export declare const useAddonsUpdateFrameworkPackage: typeof trpc.addons.updateFrameworkPackage.useMutation;
 /** Generated alias around `trpc.addons.getVersions.useQuery`. */
 export declare const useAddonsGetVersions: typeof trpc.addons.getVersions.useQuery;
 /** Generated alias around `trpc.addons.restartAddon.useMutation`. */

package/dist/hooks/use-device-webrtc.d.ts

@@ -65,6 +65,7 @@ export interface UseDeviceWebrtcTrpc {
             target: WebrtcTarget;
             sdpOffer: string;
             sessionId?: string;
+            hints?: ClientStreamHints;
         }, {
             sessionId: string;
             sdpAnswer: string;
@@ -160,7 +161,7 @@ export interface DeviceWebrtcResult {
      * H.264 decode caps in the offer, so a Main/High (incl. 4K) source passes
      * through with no transcode — the only path that lets iOS decode High.
      */
-    readonly handleOffer: (target: WebrtcTarget, sdpOffer: string, sessionId?: string) => Promise<ClientOfferResult>;
+    readonly handleOffer: (target: WebrtcTarget, sdpOffer: string, sessionId?: string, hints?: ClientStreamHints) => Promise<ClientOfferResult>;
     /**
      * Fetch the browser-side ICE servers (STUN + TURN from the `turn-provider`
      * cap). Needed for client-offer mode, where the PeerConnection must be