@camstack/ui-library 1.2.174 → 1.2.176

package/dist/composites/cap-settings/camera-grid-layout.d.ts

@@ -21,6 +21,18 @@ export interface GridLayoutCell {
     /** Where it lands, normalized against the CANVAS. */
     readonly cell: GridNormalizedRect;
 }
+/**
+ * Which profiles this grid can compose, and which sources stop it.
+ *
+ * Read-only in the editor. The operator does not choose what is on offer — the
+ * source cameras do, by what they have assigned — and a checkbox that pretended
+ * otherwise would publish a composition with a hole in it.
+ */
+export interface GridProfileOffer {
+    readonly profile: 'high' | 'mid' | 'low';
+    readonly offered: boolean;
+    readonly missingSources: readonly number[];
+}
 export interface GridLayoutView {
     readonly instanceId: string;
     readonly deviceId: number;
@@ -29,6 +41,7 @@ export interface GridLayoutView {
     readonly height: number;
     readonly fps: number;
     readonly cells: readonly GridLayoutCell[];
+    readonly profiles: readonly GridProfileOffer[];
 }
 /**
  * What a read of the grid can be.
@@ -39,7 +52,14 @@ export interface GridLayoutView {
  * which is exactly the failure D315 exists to stop.
  */
 export type GridLayoutReadOutcome = GridLayoutView | null | 'unreadable';
-/** Parse the `getGridForDevice` reply. See {@link GridLayoutReadOutcome}. */
+/**
+ * Parse the `camera-grid-layout.getLayout` reply. See {@link GridLayoutReadOutcome}.
+ *
+ * The cap answers the view itself, or `null` — there is no envelope. It used to
+ * come back as `{ grid }` from `addons.custom`, which was the mechanism the
+ * widget reached the addon through before the geometry had a capability of its
+ * own; the widget now asks THE CAMERA and the envelope went with the bridge.
+ */
 export declare function parseGridView(raw: unknown): GridLayoutReadOutcome;
 /**
  * Keep a rectangle inside the unit square.

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

@@ -1549,10 +1549,10 @@ export declare const usePtzGetHomePreset: typeof trpc.ptz.getHomePreset.useQuery
 export declare const usePtzSetHomePreset: typeof trpc.ptz.setHomePreset.useMutation;
 /** Generated alias around `trpc.ptz.captureHomeHere.useMutation`. */
 export declare const usePtzCaptureHomeHere: typeof trpc.ptz.captureHomeHere.useMutation;
-/** Generated alias around `trpc.ptz.getHomeReturnSeconds.useQuery`. */
-export declare const usePtzGetHomeReturnSeconds: typeof trpc.ptz.getHomeReturnSeconds.useQuery;
-/** Generated alias around `trpc.ptz.setHomeReturnSeconds.useMutation`. */
-export declare const usePtzSetHomeReturnSeconds: typeof trpc.ptz.setHomeReturnSeconds.useMutation;
+/** Generated alias around `trpc.ptz.getHomeReturn.useQuery`. */
+export declare const usePtzGetHomeReturn: typeof trpc.ptz.getHomeReturn.useQuery;
+/** Generated alias around `trpc.ptz.setHomeReturn.useMutation`. */
+export declare const usePtzSetHomeReturn: typeof trpc.ptz.setHomeReturn.useMutation;
 /** Generated alias around `trpc.ptz.getPosition.useQuery`. */
 export declare const usePtzGetPosition: typeof trpc.ptz.getPosition.useQuery;
 /** Generated alias around `trpc.ptz.setAutofocus.useMutation`. */

package/dist/hooks/use-ptz.d.ts

@@ -5,6 +5,11 @@ import { UseDeviceProxyTrpc } from './use-device-proxy';
  * cap so the cap surface stays speed-vector-shaped.
  */
 export type PTZDirection = 'up' | 'down' | 'left' | 'right' | 'up-left' | 'up-right' | 'down-left' | 'down-right';
+/** The camera's idle-return behaviour: whether, and after how long. */
+interface PTZHomeReturn {
+    readonly enabled: boolean;
+    readonly seconds: number;
+}
 /** Which preset `goHome` targets on this camera, and who decided it. */
 interface PTZHomePreset {
     readonly presetId: string | null;
@@ -82,9 +87,13 @@ export interface UsePTZResult {
      * not a preset can accept.
      */
     readonly captureHomeHere: () => Promise<void>;
-    /** Idle seconds before the camera returns home by itself; `null` = no timer. */
-    readonly homeReturnSeconds: number | null;
-    readonly setHomeReturnSeconds: (seconds: number) => Promise<void>;
+    /**
+     * Whether the camera returns home by itself when left idle, and after how
+     * long. `null` = it has no such behaviour. The two are ONE fact on the
+     * camera and are read and written together.
+     */
+    readonly homeReturn: PTZHomeReturn | null;
+    readonly setHomeReturn: (enabled: boolean, seconds: number) => Promise<void>;
     /** Jump to a named preset. */
     readonly goToPreset: (presetId: string) => Promise<void>;
     /**