@camstack/ui-library 1.2.344 → 1.2.345

package/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.345] - 2026-10-28
+
+### Changed
+
+- The device selector shows which addon and integration provides each device
+- The climate control keeps the set temperature steady when it gains decimals, and the preset menu has no inner border
+- Scrolling inside a dialog stays inside the dialog and no longer reaches the page behind it
+- ⌘F / Ctrl+F jumps to the page's search field instead of the browser's find (new useHotkey / HotkeyProvider registry)
+
 ## [1.2.344] - 2026-10-28
 
 ### Changed

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

@@ -1,4 +1,4 @@
-import type { JSX } from "react";
+import { type JSX } from "react";
 import { type DataTableFacet, type DataTableFilterState } from "./data-table-filter";
 /** One facet group as the bar draws it. */
 export interface DataTableFilterBarGroup {

package/dist/composites/device-controls/climate-panel.d.ts

@@ -3,6 +3,15 @@ import type { ControlPanelProps } from "./types.js";
 import type { ClimateControlStatus, HvacMode } from "@camstack/types";
 /** Step size for target ± buttons; defaults to 1 °C when unset or invalid. */
 export declare function resolveClimateTempStep(tempStep: number | null | undefined): number;
+/**
+* Character count of the longest set-temperature the device can show, derived
+* from its range and step (5-30 step 0.5 reserves "30.5" = 4). The big target
+* number reserves this width so the − / + buttons do not move when the value
+* gains decimals or loses a digit.
+*/
+export declare function climateTargetWidthChars(display: Pick<ClimateControlStatus, "tempStep" | "minTemp" | "maxTemp">): number;
+/** `min-w-[Nch]` + right alignment for the big target number. */
+export declare function climateTargetWidthClass(display: Pick<ClimateControlStatus, "tempStep" | "minTemp" | "maxTemp">): string;
 export declare function nextClimateTarget(current: number, deltaSteps: number, display: Pick<ClimateControlStatus, "tempStep" | "minTemp" | "maxTemp">): number;
 /**
 * Exhaustive colour map — one entry per HvacMode. Build will fail if a

package/dist/composites/device-picker/device-provider-label.d.ts

@@ -0,0 +1,22 @@
+/** "Home Assistant (Casa)", or "Home Assistant" without an instance name. */
+export declare function formatProviderLabel(addonName: string, integrationName: string | null | undefined): string;
+export interface ProviderFleetRow {
+	readonly id: number;
+	readonly addonId: string;
+	readonly integrationId?: string | undefined;
+}
+export interface ProviderAddonRow {
+	readonly id: string;
+	readonly name: string | undefined;
+}
+export interface ProviderIntegrationRow {
+	readonly id: string;
+	readonly name: string;
+}
+/** `deviceId → provider label`; a device whose addon is unknown is absent. */
+export declare function providerLabelsOf(fleet: readonly ProviderFleetRow[], addons: readonly ProviderAddonRow[], integrations: readonly ProviderIntegrationRow[]): ReadonlyMap<number, string>;
+/**
+* The labels for every device in the fleet; empty until the reads answer (a
+* failed read draws no provider line — it is a hint, never a gate).
+*/
+export declare function useDeviceProviderLabels(enabled: boolean): ReadonlyMap<number, string>;

package/dist/hotkeys/combo.d.ts

@@ -0,0 +1,24 @@
+/** Keys a combo may name. Extend this union to support a new key. */
+export type HotkeyKey = "a" | "b" | "c" | "d" | "e" | "f" | "g" | "h" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "q" | "r" | "s" | "t" | "u" | "v" | "w" | "x" | "y" | "z" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "escape" | "enter" | "/" | "?";
+/** `mod` is Command on macOS and Ctrl everywhere else. */
+export type HotkeyModifier = "mod" | "shift" | "alt";
+/** `f`, `mod+f`, `mod+shift+k` — typed, so a typo does not compile. */
+export type HotkeyCombo = HotkeyKey | `${HotkeyModifier}+${HotkeyKey}` | `${HotkeyModifier}+${HotkeyModifier}+${HotkeyKey}`;
+export type HotkeyPlatform = "mac" | "other";
+export interface ParsedCombo {
+	readonly mod: boolean;
+	readonly shift: boolean;
+	readonly alt: boolean;
+	readonly key: string;
+}
+/** The slice of a `KeyboardEvent` the matcher reads. */
+export interface KeyEventLike {
+	readonly key: string;
+	readonly metaKey: boolean;
+	readonly ctrlKey: boolean;
+	readonly altKey: boolean;
+	readonly shiftKey: boolean;
+}
+export declare function parseCombo(combo: HotkeyCombo): ParsedCombo;
+export declare function detectPlatform(): HotkeyPlatform;
+export declare function matchesCombo(event: KeyEventLike, combo: HotkeyCombo, platform: HotkeyPlatform): boolean;

package/dist/hotkeys/hotkey-provider.d.ts

@@ -0,0 +1,37 @@
+import { type JSX, type ReactNode } from "react";
+import { type HotkeyCombo, type HotkeyPlatform } from "./combo";
+/** Returning `false` declines the event: nothing is prevented and the next binding is tried. */
+export type HotkeyHandler = (event: KeyboardEvent) => void | boolean;
+export interface UseHotkeyOptions {
+	/** Defaults to the enclosing `HotkeyScope`, else the page. */
+	readonly scope?: string;
+	readonly enabled?: boolean;
+	/** Default true — only when the handler did not decline. */
+	readonly preventDefault?: boolean;
+	/** Fire while typing in a field. Default: only combos that carry `mod`. */
+	readonly allowInInput?: boolean;
+}
+export declare const PAGE_SCOPE = "page";
+/** Asked last, after the page: a global handler that yields to whatever the page registers. */
+export declare const FALLBACK_SCOPE = "fallback";
+export interface HotkeyProviderProps {
+	readonly children: ReactNode;
+	/** Override platform detection (tests). */
+	readonly platform?: HotkeyPlatform;
+}
+export declare function HotkeyProvider({ children, platform }: HotkeyProviderProps): JSX.Element;
+/**
+* Bind a combo for the life of the component. Without a `HotkeyProvider` above
+* it does nothing, so the browser keeps its own shortcut.
+*/
+export declare function useHotkey(combo: HotkeyCombo, handler: HotkeyHandler, options?: UseHotkeyOptions): void;
+export interface HotkeyScopeProps {
+	readonly id: string;
+	readonly children: ReactNode;
+	/** Default true. Turn off while the surface is closed. */
+	readonly enabled?: boolean;
+	/** Shadows every scope under it, the page included. Default false. */
+	readonly modal?: boolean;
+}
+/** Bindings made below this component belong to `id`; while enabled it is the topmost scope. */
+export declare function HotkeyScope({ id, children, enabled, modal }: HotkeyScopeProps): JSX.Element;

package/dist/hotkeys/index.d.ts

@@ -0,0 +1,6 @@
+export type { HotkeyCombo, HotkeyKey, HotkeyModifier, HotkeyPlatform, KeyEventLike } from "./combo";
+export { detectPlatform, matchesCombo, parseCombo } from "./combo";
+export type { HotkeyHandler, HotkeyProviderProps, HotkeyScopeProps, UseHotkeyOptions } from "./hotkey-provider";
+export { FALLBACK_SCOPE, HotkeyProvider, HotkeyScope, useHotkey } from "./hotkey-provider";
+export type { UseSearchFieldHotkeyOptions } from "./use-search-field-hotkey";
+export { useSearchFieldHotkey } from "./use-search-field-hotkey";

package/dist/hotkeys/use-search-field-hotkey.d.ts

@@ -0,0 +1,13 @@
+import { type RefObject } from "react";
+export interface UseSearchFieldHotkeyOptions {
+	/** Pass false to leave the browser's find alone for this field. Default true. */
+	readonly enabled?: boolean;
+	/** Only the app-level search passes `FALLBACK_SCOPE`: it yields to any field on the page. */
+	readonly scope?: string;
+}
+/**
+* Register a search field: ⌘F / Ctrl+F and ⌘K / Ctrl+K focus and select it.
+* A field that is hidden or disabled declines, so the browser's find still runs.
+* The library's search inputs call this themselves.
+*/
+export declare function useSearchFieldHotkey(ref: RefObject<HTMLInputElement | null>, options?: UseSearchFieldHotkeyOptions): void;