@camstack/ui-library 1.2.321 → 1.2.323

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

@@ -1,14 +1,24 @@
 /**
-* 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.
+* Detection class colours — the bundled display palette (D939).
+*
+* A mounted {@link DisplayPaletteProvider} paints the cluster's effective
+* palette instead. There is no second hex table here.
+*/
+import { type PaletteReady } from "@camstack/types";
+/**
+* Fixed colours for known classes, from the bundled CamStack preset.
+* Kept for callers that read the map directly.
 */
 export declare const CLASS_COLORS: Readonly<Record<string, string>>;
-/** Primary/default color when nothing else matches */
+/** Primary colour when nothing else matches — the first bundled fallback. */
 export declare const DEFAULT_COLOR: string;
+export interface PalettePaintSource {
+	readonly swatches: PaletteReady["swatches"];
+	readonly fallbacks: PaletteReady["fallbacks"];
+}
 /**
-* Get the color for a detection class name.
-* Resolves: custom override → taxonomy/UI-only fixed color → deterministic
-* hash-based color for unknown classes.
+* Colour for a detection class. Custom overrides win, then the palette
+* (the bundled preset when none is passed). Unknown classes hash into
+* the palette's fallbacks.
 */
-export declare function getClassColor(className: string, customColors?: Readonly<Record<string, string>>): string;
+export declare function getClassColor(className: string, customColors?: Readonly<Record<string, string>>, palette?: PalettePaintSource): string;

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

@@ -38,9 +38,11 @@
 */
 import { type JSX } from "react";
 import type { PickerFleetView } from "./device-fleet-view";
-import { type PickerGroup, type PickerId, type PickerItem } from "./device-picker-model";
+import { type PickerGroup, type PickerGroupBy, type PickerId, type PickerItem } from "./device-picker-model";
 import { type DeviceListState } from "./device-selection";
 import { type PickerNoun } from "./device-selection-rows";
+/** One device, or the checklist every rule editor uses. */
+export type DevicePickerSelection = "single" | "multiple";
 export interface DevicePickerProps<Id extends PickerId = number> {
 	/** The devices the list DRAWS — the caller's answered list, `[]` otherwise. */
 	readonly devices: readonly PickerItem<Id>[];
@@ -50,6 +52,16 @@ export interface DevicePickerProps<Id extends PickerId = number> {
 	readonly fleet?: PickerFleetView<Id>;
 	readonly value: readonly Id[];
 	readonly onChange: (next: Id[]) => void;
+	/**
+	* `single`: one radio, no All/Clear, no "N selected". Choosing a row
+	* replaces `value` with that id. Default is the checklist.
+	*/
+	readonly selection?: DevicePickerSelection;
+	/**
+	* Group this list by zone, location or none. Absent uses the remembered
+	* choice. A value here does not change that choice.
+	*/
+	readonly groupBy?: PickerGroupBy;
 	/** Empty selection means EVERY device: say so, and warn when it widens. */
 	readonly emptyMeansAll?: boolean;
 	/** Whether the saved rule had devices — the widening warning survives a remount. */
@@ -79,4 +91,4 @@ export interface DevicePickerProps<Id extends PickerId = number> {
 	/** The line under a locked device. Default "Already added". */
 	readonly lockedNote?: string;
 }
-export declare function DevicePicker<Id extends PickerId = number>({ devices: devicesIn, listState, fleet, value, onChange, emptyMeansAll, savedHadDevices, noun, groupTitle: groupTitleProp, emptyLabel, annotate, disabled, testId, showAll, lockedIds, lockedNote: lockedNoteProp }: DevicePickerProps<Id>): JSX.Element;
+export declare function DevicePicker<Id extends PickerId = number>({ devices: devicesIn, listState, fleet, value, onChange, selection, groupBy: pinnedGroupBy, emptyMeansAll, savedHadDevices, noun, groupTitle: groupTitleProp, emptyLabel, annotate, disabled, testId, showAll, lockedIds, lockedNote: lockedNoteProp }: DevicePickerProps<Id>): JSX.Element;

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

@@ -1,4 +1,4 @@
-export { DevicePicker, type DevicePickerProps } from "./DevicePicker.js";
+export { DevicePicker, type DevicePickerProps, type DevicePickerSelection } from "./DevicePicker.js";
 export { DeviceFilterBar, typeLabel, type DeviceFilterBarGrouping, type DeviceFilterBarProps } from "./device-filter-bar.js";
 export { fleetViewOf, type DeviceFleetView, type PickerFleetView } from "./device-fleet-view.js";
 export { DEVICE_PICKER_GROUP_STORAGE_KEY, readStoredGroupBy, writeStoredGroupBy, useStoredGroupBy, usePickerSiteZones, type StoredGroupBy } from "./device-picker-grouping.js";

package/dist/composites/display-palette-context.d.ts

@@ -0,0 +1,26 @@
+/**
+* The cluster palette, when a host has read `display-palette` (D939).
+* No provider, a pending read, or an unknown store all paint the bundled
+* CamStack preset. Only `ready` replaces it. Callers that must say the
+* store was unreadable read {@link useDisplayPaletteView}.
+*/
+import { type ReactNode } from "react";
+import { type PaletteReady } from "@camstack/types";
+export type DisplayPaletteView = {
+	readonly status: "absent";
+} | {
+	readonly status: "pending";
+} | {
+	readonly status: "unknown";
+	readonly reason: string;
+} | {
+	readonly status: "ready";
+	readonly palette: PaletteReady;
+};
+export interface DisplayPaletteProviderProps {
+	readonly value: DisplayPaletteView;
+	readonly children: ReactNode;
+}
+export declare function DisplayPaletteProvider({ value, children }: DisplayPaletteProviderProps): ReactNode;
+export declare function useDisplayPaletteView(): DisplayPaletteView;
+export declare function useClassPainter(): (className: string, customColors?: Readonly<Record<string, string>>) => string;

package/dist/composites/index.d.ts

@@ -98,6 +98,7 @@ export { ariaSortForColumn, nextSortDirection, nextTableSort, sortRowsByColumn }
 export type { Detection, DetectionCanvasProps } from "./detection-canvas";
 export { DetectionCanvas } from "./detection-canvas";
 export { CLASS_COLORS, DEFAULT_COLOR, getClassColor } from "./detection-colors";
+export { DisplayPaletteProvider, useClassPainter, useDisplayPaletteView, type DisplayPaletteProviderProps, type DisplayPaletteView } from "./display-palette-context";
 export type { DetectionOverlayProps } from "./detection-overlay";
 export { DetectionOverlay } from "./detection-overlay";
 export type { DetectionResultTreeProps } from "./detection-result-tree";

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

@@ -781,6 +781,12 @@ export declare const useDishwasherSetOption: typeof trpc.dishwasher.setOption.us
 export declare const useDishwasherGetOptions: typeof trpc.dishwasher.getOptions.useQuery;
 /** Generated alias around `trpc.dishwasher.getStatus.useQuery`. */
 export declare const useDishwasherGetStatus: typeof trpc.dishwasher.getStatus.useQuery;
+/** Generated alias around `trpc.displayPalette.getPalette.useQuery`. */
+export declare const useDisplayPaletteGetPalette: typeof trpc.displayPalette.getPalette.useQuery;
+/** Generated alias around `trpc.displayPalette.listPresets.useQuery`. */
+export declare const useDisplayPaletteListPresets: typeof trpc.displayPalette.listPresets.useQuery;
+/** Generated alias around `trpc.displayPalette.setPalette.useMutation`. */
+export declare const useDisplayPaletteSetPalette: typeof trpc.displayPalette.setPalette.useMutation;
 /** Generated alias around `trpc.doorbell.getStatus.useQuery`. */
 export declare const useDoorbellGetStatus: typeof trpc.doorbell.getStatus.useQuery;
 /** Generated alias around `trpc.enumSensor.getStatus.useQuery`. */