@camstack/ui-library 1.2.46 → 1.2.48

package/dist/composites/data-table.d.ts

@@ -41,5 +41,21 @@ export interface DataTableProps<T> {
      * card list at any column count.
      */
     readonly mobileMode?: TableMobileMode;
+    /**
+     * Tailwind `max-h-*` class capping the table. The rows then scroll INSIDE
+     * this container and the column header is pinned to its top; the page around
+     * it does not move. Absent (default) = the table is as tall as its rows and
+     * the page scrolls. Use {@link TABLE_SCROLL_MAX_H} unless a surface has a
+     * reason of its own.
+     */
+    readonly maxBodyHeight?: string;
 }
-export declare function DataTable<T>({ columns, rows, rowKey, onRowClick, minWidthPx, emptyMessage, className, bordered, rowClassName, mobileMode, }: DataTableProps<T>): import("react").JSX.Element | null;
+/**
+ * The default cap for an internally-scrolling table.
+ *
+ * `60vh` leaves the page header, its filters and its actions on screen at
+ * every viewport while still showing ~10 rows — and it is a fraction, so it
+ * does not need a breakpoint of its own.
+ */
+export declare const TABLE_SCROLL_MAX_H: "max-h-[60vh]";
+export declare function DataTable<T>({ columns, rows, rowKey, onRowClick, minWidthPx, emptyMessage, className, bordered, rowClassName, mobileMode, maxBodyHeight, }: DataTableProps<T>): import("react").JSX.Element | null;

package/dist/composites/device-selector-picker.d.ts

@@ -0,0 +1,37 @@
+import { DeviceType, DeviceSelector } from '@camstack/types';
+/** The device fields this picker reads. */
+export interface SelectorDevice {
+    readonly id: number;
+    readonly name: string;
+    readonly type: DeviceType;
+    readonly location: string | null;
+    readonly parentDeviceId: number | null;
+}
+export type DeviceSelectorTab = 'all' | 'types' | 'locations' | 'ids';
+interface DeviceSelectorPickerProps {
+    readonly value: DeviceSelector;
+    readonly onChange: (next: DeviceSelector) => void;
+    /**
+     * `includeLinked` lives next to the selector because it changes what the
+     * selector REACHES, not what it selects. Omit both to hide the toggle
+     * (the raw picker renders it per row instead).
+     */
+    readonly includeLinked?: boolean;
+    readonly onIncludeLinkedChange?: (next: boolean) => void;
+    /**
+     * Ids the CALLER may delegate. `null` = unclamped (admin). A clamped
+     * picker hides devices outside the set from the Chosen tab and reports the
+     * counts it can actually see.
+     */
+    readonly clampToDeviceIds?: readonly number[] | null;
+    /** Compact spacing for the raw picker's inline row. */
+    readonly dense?: boolean;
+}
+/** Human label for a `DeviceType` — 'lawn-mower' → 'Lawn mower'. */
+export declare function deviceTypeLabel(type: string): string;
+/** Which tab a selector belongs to. */
+export declare function tabForSelector(selector: DeviceSelector): DeviceSelectorTab;
+export declare function DeviceSelectorPicker({ value, onChange, includeLinked, onIncludeLinkedChange, clampToDeviceIds, dense, }: DeviceSelectorPickerProps): React.ReactElement;
+/** Summary line for a selector — used by the raw picker's collapsed row. */
+export declare function describeDeviceSelector(selector: DeviceSelector): string;
+export {};

package/dist/composites/index.d.ts

@@ -135,6 +135,8 @@ export { WidgetSlot } from './widget-slot';
 export type { WidgetSlotProps } from './widget-slot';
 export { ScopePicker, validateScopes } from './scope-picker';
 export type { ScopeAccess } from './scope-picker';
+export { DeviceSelectorPicker, describeDeviceSelector, deviceTypeLabel, tabForSelector, } from './device-selector-picker';
+export type { DeviceSelectorTab, SelectorDevice } from './device-selector-picker';
 export { PtzPanel } from './cap-settings/PtzPanel';
 export { ConsumablesPanel } from './cap-settings/ConsumablesPanel';
 export { AutotrackSection } from './cap-settings/AutotrackSection';

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

@@ -17,9 +17,14 @@ interface ScopePickerProps {
 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`.
- * Use this before passing the picker output to a mutate call so the
+ * scope to carry a usable target and `access.length >= 1`; a v3 device
+ * selector additionally requires a non-empty list for every kind except
+ * `all`. Use this before passing the picker output to a mutate call so the
  * user sees a clean inline error instead of a tRPC ZodError.
+ *
+ * An EMPTY selector list is rejected rather than silently treated as "all":
+ * the schema's `.min(1)` would reject it server-side anyway, and the failure
+ * mode of guessing wrong here is granting the whole fleet.
  */
 export declare function validateScopes(scopes: readonly TokenScope[]): string | null;
 export {};