@camstack/ui-library 1.2.226 → 1.2.228

package/dist/composites/device-item/quick-detail-action.d.ts

@@ -0,0 +1,6 @@
+import { ReactNode } from 'react';
+export interface DeviceQuickDetailActionProps {
+    readonly deviceId: number;
+    readonly className?: string;
+}
+export declare function DeviceQuickDetailAction({ deviceId, className, }: DeviceQuickDetailActionProps): ReactNode;

package/dist/composites/device-list/generic-mode.d.ts

@@ -65,6 +65,11 @@ export interface DeviceListGenericProps<T> {
     readonly filterOptions?: readonly MultiSelectOption[];
     /** Label for the type multi-select trigger. Default 'Type'. */
     readonly filterLabel?: string;
+    /**
+     * Initial type-filter selection. Empty (default) = no filter. Used once at
+     * mount — later changes to this prop are ignored (local state owns it).
+     */
+    readonly initialTypeFilters?: readonly string[];
     readonly isLoading?: boolean;
     readonly searchPlaceholder?: string;
     readonly emptyLabel?: string;

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

@@ -6,7 +6,9 @@ export interface SelectedChipProps {
     /** A selection the hub no longer has — drawn in warning colour. */
     readonly warning?: boolean;
     readonly iconId?: string;
+    /** Brand / raster icon URL (e.g. notifier kind icon). */
+    readonly iconUrl?: string;
     readonly testId?: string;
 }
 /** One selected entry as a removable chip. */
-export declare function SelectedChip({ label, onRemove, warning, iconId, testId, }: SelectedChipProps): import("react").JSX.Element;
+export declare function SelectedChip({ label, onRemove, warning, iconId, iconUrl, testId, }: SelectedChipProps): import("react").JSX.Element;

package/dist/composites/index.d.ts

@@ -79,6 +79,8 @@ export { DeviceBatchToolbar } from './device-list/batch-toolbar';
 export * from './device-meta';
 export * from './icon-picker';
 export { DeviceMultiSelectField, DeviceSelectField } from './device-select-field';
+export type { NotificationTargetOption, NotificationTargetSelectFieldProps, NotificationTargetsFieldProps, } from './notification-targets-field';
+export { ConfigNotificationTargetMultiSelectFieldView, ConfigNotificationTargetSelectFieldView, NotificationTargetSelectField, NotificationTargetsField, } from './notification-targets-field';
 export type { DeviceSelectCandidate } from './device-select-filter';
 export { deviceMatchesFilter, deviceOptionLabel, devicesToOptions, filterDeviceOptions, selectedDeviceOptions, } from './device-select-filter';
 export type { DeviceSelectorTab, SelectorDevice } from './device-selector-picker';
@@ -170,6 +172,8 @@ export * from './version-badge';
 export * from './widget-panel.js';
 export type { WidgetSlotProps } from './widget-slot';
 export { WidgetSlot } from './widget-slot';
+export type { OptionSelectMultiProps, OptionSelectOption, OptionSelectProps, OptionSelectSingleProps, } from './option-select/index.js';
+export { OptionSelect, OPTION_SELECT_SEARCH_MIN_OPTIONS, catalogHasDraft, draftFromQuery, filterOptions as filterOptionSelectOptions, optionSearchText as optionSelectSearchText, partitionSelected as partitionOptionSelectSelected, resolveSearchable as resolveOptionSelectSearchable, shouldShowAddNewFooter, shouldShowUseQueryRow, } from './option-select/index.js';
 export * from './device-picker/index.js';
 export * from './unit-picker/index.js';
 export * from './placeholder-field/index.js';

package/dist/composites/notification-targets-field.d.ts

@@ -0,0 +1,66 @@
+import { ConfigNotificationTargetMultiSelectField, ConfigNotificationTargetSelectField } from '@camstack/types';
+import { TranslationFn } from './config-form-builder';
+import { NotificationTargetOption } from './notification-targets-options';
+export type { NotificationTargetOption } from './notification-targets-options';
+export interface NotificationTargetsFieldProps {
+    readonly targets: readonly NotificationTargetOption[];
+    readonly value: readonly string[];
+    readonly onChange: (next: string[]) => void;
+    readonly disabled?: boolean;
+    /** Cap on how many targets may be selected. */
+    readonly maxItems?: number;
+    /** Per-target test id is `<prefix>-<id>`. Default `notification-target`. */
+    readonly testIdPrefix?: string;
+    /** What an empty catalog says. */
+    readonly emptyMessage?: string;
+    /** Target ids that carry an extra note badge (e.g. already covered by a rule). */
+    readonly noteIds?: ReadonlySet<string>;
+    /** Label on the note badge. Default `note`. */
+    readonly noteLabel?: string;
+    readonly label?: string;
+    readonly description?: string;
+    /** Kind brand icons keyed as `addonId:kind`. */
+    readonly kindIconUrls?: ReadonlyMap<string, string>;
+}
+export interface NotificationTargetSelectFieldProps {
+    readonly targets: readonly NotificationTargetOption[];
+    readonly value: string;
+    readonly onChange: (next: string) => void;
+    readonly disabled?: boolean;
+    readonly emptyMessage?: string;
+    readonly placeholder?: string;
+    readonly testId?: string;
+    readonly label?: string;
+    readonly description?: string;
+    readonly kindIconUrls?: ReadonlyMap<string, string>;
+}
+/**
+ * Multi-select of delivery targets (NC Summaries / Timelapses / Rules shape).
+ */
+export declare function NotificationTargetsField({ targets, value, onChange, disabled, maxItems, testIdPrefix, emptyMessage, noteIds, noteLabel, label, description, kindIconUrls: kindIconUrlsProp, }: NotificationTargetsFieldProps): import("react").JSX.Element;
+/**
+ * Single-select of one delivery target (Calendar events / script settings).
+ */
+export declare function NotificationTargetSelectField({ targets, value, onChange, disabled, emptyMessage, placeholder, testId, label, description, kindIconUrls: kindIconUrlsProp, }: NotificationTargetSelectFieldProps): import("react").JSX.Element;
+/**
+ * ConfigUISchema `notification-target-multiselect` — fetches listTargets and
+ * stores a `string[]` of target ids.
+ */
+export declare function ConfigNotificationTargetMultiSelectFieldView({ field, value, onChange, disabled, translationFn, }: {
+    readonly field: ConfigNotificationTargetMultiSelectField;
+    readonly value: unknown;
+    readonly onChange: (v: unknown) => void;
+    readonly disabled?: boolean;
+    readonly translationFn?: TranslationFn;
+}): import("react").JSX.Element;
+/**
+ * ConfigUISchema `notification-target-select` — fetches listTargets and stores
+ * one target id string.
+ */
+export declare function ConfigNotificationTargetSelectFieldView({ field, value, onChange, disabled, translationFn, }: {
+    readonly field: ConfigNotificationTargetSelectField;
+    readonly value: unknown;
+    readonly onChange: (v: unknown) => void;
+    readonly disabled?: boolean;
+    readonly translationFn?: TranslationFn;
+}): import("react").JSX.Element;

package/dist/composites/notification-targets-options.d.ts

@@ -0,0 +1,11 @@
+import { OptionSelectOption } from './option-select/option-select-model';
+export type NotificationTargetOption = {
+    readonly id: string;
+    readonly name: string;
+    readonly enabled: boolean;
+    readonly kind?: string;
+    readonly addonId?: string;
+};
+export declare function targetsToOptions(targets: readonly NotificationTargetOption[], kindIconUrls: ReadonlyMap<string, string>, noteIds: ReadonlySet<string> | undefined, noteLabel: string): readonly OptionSelectOption[];
+export declare function buildKindIconMap(rows: unknown): ReadonlyMap<string, string>;
+export declare function toTargetOptions(rows: unknown): readonly NotificationTargetOption[];

package/dist/composites/option-select/OptionSelect.d.ts

@@ -0,0 +1,30 @@
+import { OptionSelectOption } from './option-select-model';
+type OptionSelectSharedProps = {
+    readonly options: readonly OptionSelectOption[];
+    readonly placeholder?: string;
+    readonly searchable?: boolean;
+    readonly disabled?: boolean;
+    readonly emptyMessage?: string;
+    readonly creatable?: boolean;
+    readonly createLabel?: string;
+    readonly onCreateRequest?: (draft: string) => void;
+    readonly label?: string;
+    readonly description?: string;
+    readonly testId?: string;
+    readonly optionTestIdPrefix?: string;
+    readonly listboxId?: string;
+};
+export type OptionSelectSingleProps = OptionSelectSharedProps & {
+    readonly mode: 'single';
+    readonly value: string;
+    readonly onChange: (next: string) => void;
+};
+export type OptionSelectMultiProps = OptionSelectSharedProps & {
+    readonly mode: 'multi';
+    readonly value: readonly string[];
+    readonly onChange: (next: string[]) => void;
+    readonly maxItems?: number;
+};
+export type OptionSelectProps = OptionSelectSingleProps | OptionSelectMultiProps;
+export declare function OptionSelect(props: OptionSelectProps): import("react").JSX.Element;
+export {};

package/dist/composites/option-select/index.d.ts

@@ -0,0 +1,4 @@
+export type { OptionSelectOption } from './option-select-model';
+export { OPTION_SELECT_SEARCH_MIN_OPTIONS, catalogHasDraft, draftFromQuery, filterOptions, optionSearchText, partitionSelected, resolveSearchable, shouldShowAddNewFooter, shouldShowUseQueryRow, } from './option-select-model';
+export type { OptionSelectMultiProps, OptionSelectProps, OptionSelectSingleProps, } from './OptionSelect';
+export { OptionSelect } from './OptionSelect';

package/dist/composites/option-select/option-select-model.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Pure filter/partition helpers for OptionSelect.
+ *
+ * Search is a case-insensitive substring match folded over each option's
+ * `value`, `label`, and `description`. Multi-token queries require every
+ * token to match (AND).
+ */
+export type OptionSelectOption = {
+    value: string;
+    label: string;
+    description?: string;
+    iconUrl?: string;
+    iconId?: string;
+    disabled?: boolean;
+    badge?: string;
+};
+/** Number of options at/above which search is enabled by default (unless creatable). */
+export declare const OPTION_SELECT_SEARCH_MIN_OPTIONS = 8;
+/** Fold an option into a single lower-cased haystack (value + label + description). */
+export declare function optionSearchText(opt: OptionSelectOption): string;
+/**
+ * Filter options by a free-text query. An empty / whitespace-only query
+ * returns every option (identity, preserving order).
+ */
+export declare function filterOptions(options: readonly OptionSelectOption[], query: string): readonly OptionSelectOption[];
+/**
+ * Split options into the currently-selected set (in selection order) and the
+ * rest. Selected values with no matching option are surfaced as synthetic
+ * options whose label falls back to the raw value.
+ */
+export declare function partitionSelected(options: readonly OptionSelectOption[], selected: readonly string[]): {
+    readonly selectedOptions: readonly OptionSelectOption[];
+    readonly unselected: readonly OptionSelectOption[];
+};
+export declare function resolveSearchable(optionCount: number, creatable: boolean, searchable: boolean | undefined): boolean;
+/** Trimmed non-empty draft from the search box, or null when absent. */
+export declare function draftFromQuery(query: string): string | null;
+/**
+ * True when an existing catalog option already represents this draft (value or
+ * label, case-insensitive). Used to hide the “Use «query»” row when redundant.
+ */
+export declare function catalogHasDraft(options: readonly OptionSelectOption[], draft: string): boolean;
+/**
+ * Show the footer “Add new…” action only when creatable AND the caller
+ * provided `onCreateRequest` (e.g. open a dedicated create dialog).
+ *
+ * Without that hook the footer was a no-op (it only focused the search box),
+ * which read as “Add new is broken”. Free-form create already works via the
+ * “Use «query»” row once the operator types — no footer needed.
+ */
+export declare function shouldShowAddNewFooter(creatable: boolean, hasCreateRequest: boolean): boolean;
+/**
+ * Show the “Use «query»” commit row: creatable, a non-empty draft, and no
+ * catalog option that already matches the draft.
+ */
+export declare function shouldShowUseQueryRow(creatable: boolean, query: string, options: readonly OptionSelectOption[]): boolean;

package/dist/contexts/device-quick-detail.d.ts

@@ -0,0 +1,9 @@
+import { ReactNode } from 'react';
+export type DeviceQuickDetailOpen = (deviceId: number) => void;
+export interface DeviceQuickDetailProviderProps {
+    readonly open: DeviceQuickDetailOpen;
+    readonly children: ReactNode;
+}
+export declare function DeviceQuickDetailProvider({ open, children, }: DeviceQuickDetailProviderProps): ReactNode;
+/** The host's open callback, or null when no provider is mounted. */
+export declare function useDeviceQuickDetailOpen(): DeviceQuickDetailOpen | null;

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

@@ -243,8 +243,10 @@ export declare const useButtonPress: typeof trpc.button.press.useMutation;
 export declare const useCalendarsListCalendars: typeof trpc.calendars.listCalendars.useQuery;
 /** Generated alias around `trpc.calendars.listEvents.useQuery`. */
 export declare const useCalendarsListEvents: typeof trpc.calendars.listEvents.useQuery;
-/** Generated alias around `trpc.calendars.importFromHomeAssistant.useMutation`. */
-export declare const useCalendarsImportFromHomeAssistant: typeof trpc.calendars.importFromHomeAssistant.useMutation;
+/** Generated alias around `trpc.calendars.getPreferences.useQuery`. */
+export declare const useCalendarsGetPreferences: typeof trpc.calendars.getPreferences.useQuery;
+/** Generated alias around `trpc.calendars.setCalendarPreference.useMutation`. */
+export declare const useCalendarsSetCalendarPreference: typeof trpc.calendars.setCalendarPreference.useMutation;
 /** Generated alias around `trpc.cameraCredentials.getCredentials.useQuery`. */
 export declare const useCameraCredentialsGetCredentials: typeof trpc.cameraCredentials.getCredentials.useQuery;
 /** Generated alias around `trpc.cameraCredentials.getStatus.useQuery`. */
@@ -331,6 +333,10 @@ export declare const useCoreBlocksSetEnabled: typeof trpc.coreBlocks.setEnabled.
 export declare const useCoreBlocksRestart: typeof trpc.coreBlocks.restart.useMutation;
 /** Generated alias around `trpc.coreBlocks.compile.useMutation`. */
 export declare const useCoreBlocksCompile: typeof trpc.coreBlocks.compile.useMutation;
+/** Generated alias around `trpc.coreBlocks.getBlockSettings.useQuery`. */
+export declare const useCoreBlocksGetBlockSettings: typeof trpc.coreBlocks.getBlockSettings.useQuery;
+/** Generated alias around `trpc.coreBlocks.updateBlockSettings.useMutation`. */
+export declare const useCoreBlocksUpdateBlockSettings: typeof trpc.coreBlocks.updateBlockSettings.useMutation;
 /** Generated alias around `trpc.coreBlocks.getTypeDefs.useQuery`. */
 export declare const useCoreBlocksGetTypeDefs: typeof trpc.coreBlocks.getTypeDefs.useQuery;
 /** Generated alias around `trpc.coreBlocks.createComposition.useMutation`. */
@@ -1071,8 +1077,12 @@ export declare const useNodesExecuteQuery: typeof trpc.nodes.executeQuery.useMut
 export declare const useNotificationOutputListTargetKinds: typeof trpc.notificationOutput.listTargetKinds.useQuery;
 /** Generated alias around `trpc.notificationOutput.listTargets.useQuery`. */
 export declare const useNotificationOutputListTargets: typeof trpc.notificationOutput.listTargets.useQuery;
+/** Generated alias around `trpc.notificationOutput.getTarget.useQuery`. */
+export declare const useNotificationOutputGetTarget: typeof trpc.notificationOutput.getTarget.useQuery;
 /** Generated alias around `trpc.notificationOutput.discoverTargets.useQuery`. */
 export declare const useNotificationOutputDiscoverTargets: typeof trpc.notificationOutput.discoverTargets.useQuery;
+/** Generated alias around `trpc.notificationOutput.probeTargetConfig.useMutation`. */
+export declare const useNotificationOutputProbeTargetConfig: typeof trpc.notificationOutput.probeTargetConfig.useMutation;
 /** Generated alias around `trpc.notificationOutput.send.useMutation`. */
 export declare const useNotificationOutputSend: typeof trpc.notificationOutput.send.useMutation;
 /** Generated alias around `trpc.notificationOutput.testTarget.useMutation`. */
@@ -1095,6 +1105,16 @@ export declare const useNotificationRulesUpdateRule: typeof trpc.notificationRul
 export declare const useNotificationRulesDeleteRule: typeof trpc.notificationRules.deleteRule.useMutation;
 /** Generated alias around `trpc.notificationRules.setRuleEnabled.useMutation`. */
 export declare const useNotificationRulesSetRuleEnabled: typeof trpc.notificationRules.setRuleEnabled.useMutation;
+/** Generated alias around `trpc.notificationRules.listSequences.useQuery`. */
+export declare const useNotificationRulesListSequences: typeof trpc.notificationRules.listSequences.useQuery;
+/** Generated alias around `trpc.notificationRules.getSequence.useQuery`. */
+export declare const useNotificationRulesGetSequence: typeof trpc.notificationRules.getSequence.useQuery;
+/** Generated alias around `trpc.notificationRules.createSequence.useMutation`. */
+export declare const useNotificationRulesCreateSequence: typeof trpc.notificationRules.createSequence.useMutation;
+/** Generated alias around `trpc.notificationRules.updateSequence.useMutation`. */
+export declare const useNotificationRulesUpdateSequence: typeof trpc.notificationRules.updateSequence.useMutation;
+/** Generated alias around `trpc.notificationRules.deleteSequence.useMutation`. */
+export declare const useNotificationRulesDeleteSequence: typeof trpc.notificationRules.deleteSequence.useMutation;
 /** Generated alias around `trpc.notificationRules.getClipRetentionAsks.useQuery`. */
 export declare const useNotificationRulesGetClipRetentionAsks: typeof trpc.notificationRules.getClipRetentionAsks.useQuery;
 /** Generated alias around `trpc.notificationRules.listDeviceMutes.useQuery`. */

package/dist/hooks/index.d.ts

@@ -1,3 +1,4 @@
+export { useUrlQueryParam } from './use-url-query';
 export type { ClusterNode, ClusterTopologyNode, ClusterTopologyResult, } from './use-cluster-nodes';
 export { useClusterNodes, useClusterTopology } from './use-cluster-nodes';
 export { useDebouncedString } from './use-debounced-string';

package/dist/hooks/use-url-query.d.ts

@@ -0,0 +1,5 @@
+/**
+ * One query param as React state. `null` means absent.
+ * Changing it replaces the URL without a navigation.
+ */
+export declare function useUrlQueryParam(key: string): readonly [string | null, (next: string | null) => void];