@camstack/ui-library 1.1.17 → 1.1.18

package/dist/composites/device-item/children-accordion.d.ts

@@ -6,6 +6,9 @@ interface ChildrenAccordionProps {
     readonly accessoryChildren: readonly DeviceItemDevice[];
     readonly adoptedChildren: readonly DeviceItemDevice[];
     readonly onNavigate: (id: number) => void;
+    /** Parent row's name — used to strip the redundant baked-in prefix from each
+     *  child's DISPLAY name (the underlying `child.name` is untouched). */
+    readonly parentName: string;
 }
-export declare function ChildrenAccordion({ trpc, accessoryChildren, adoptedChildren, onNavigate, }: ChildrenAccordionProps): ReactNode;
+export declare function ChildrenAccordion({ trpc, accessoryChildren, adoptedChildren, onNavigate, parentName, }: ChildrenAccordionProps): ReactNode;
 export {};

package/dist/composites/device-item/helpers.d.ts

@@ -1,6 +1,6 @@
-import { ReactNode } from 'react';
+import { ChildLayout, DeviceDisplayOverride, SourceInfo } from '@camstack/types';
 import { LucideIcon } from 'lucide-react';
-import { SourceInfo, ChildLayout } from '@camstack/types';
+import { ReactNode } from 'react';
 import { UseDeviceProxyTrpc } from '../../hooks/use-device-proxy';
 /**
  * Mirror of the canonical `DeviceInfo` wire shape (see
@@ -30,10 +30,16 @@ export interface DeviceItemDevice {
     /** Upstream-system identity (dispatch key + system tag + optional uniqueId).
      *  Flows from `DeviceInfo.sourceInfo` via structural cast / parse;
      *  optional so rows from providers that pre-date SourceInfo still work.
-     *  Does NOT carry rendering hints (unit, precision) — those live in the
-     *  cap STATUS SLICE for generic numeric-sensor, or are canonical constants
-     *  in ROLE_DESCRIPTOR for typed sensor roles. */
+     *  Live rendering hints (unit, precision) come from the cap STATUS SLICE for
+     *  generic numeric-sensor, or canonical constants in ROLE_DESCRIPTOR for typed
+     *  roles; an operator's per-device customization rides `display` (below). */
     readonly sourceInfo?: SourceInfo;
+    /** Operator-authored per-device display override (icon/label/unit/precision/
+     *  hidden). Mirrors `DeviceInfo.display` so the wire row passes through. The
+     *  renderers resolve it via `resolveSensorDisplay` (unit/precision, render-time
+     *  conversion) + `displayRoleLabel` / `deviceLeadIcon` (label/icon); `hidden`
+     *  filters the row out of list surfaces. Absent ⇒ role/slice defaults. */
+    readonly display?: DeviceDisplayOverride;
     /** Soft-link to another device id. For a CONTAINER device this is the
      *  LEGACY picker-chosen primary child (numeric id); the row/hero resolve the
      *  primary child via `resolveContainerPrimary(children, linkDeviceId)`.
@@ -194,6 +200,22 @@ export interface VariantDefaults {
 }
 export declare function resolveFlags(props: DeviceItemProps): VariantDefaults;
 export declare function deviceLeadIcon(device: DeviceItemDevice): LucideIcon;
+/**
+ * Role label for a device row, honouring an operator's per-device `display.label`
+ * override (falls back to the `DEVICE_ROLE_META` label). NOT the device name —
+ * this is the small secondary role caption on accessory/sensor rows.
+ */
+export declare function displayRoleLabel(device: DeviceItemDevice): string;
+export declare function stripParentNamePrefix(name: string, parentName: string): string;
+/**
+ * Display name for a child device rendered UNDER its container/parent row.
+ * Precedence: an operator's explicit per-device `display.label` wins over the
+ * auto-strip (mirrors {@link displayRoleLabel}); otherwise the parent-name
+ * prefix is stripped via {@link stripParentNamePrefix}. Shared by the
+ * device-detail children list AND the devices list-table so both surfaces
+ * render the bare child label identically.
+ */
+export declare function childListName(child: Pick<DeviceItemDevice, 'name' | 'display'>, parentName: string): string;
 /**
  * Icon for each `DeviceFeature` advertised on a device row. Used by
  * the features popover (`<DeviceItemFeatures>`) to render compact

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

@@ -1,9 +1,9 @@
 import { ReactNode } from 'react';
 import { DeviceItemProps } from './helpers';
-export type { DeviceItemDevice, DeviceItemParent, DeviceItemKind, DeviceItemVariant, DeviceItemView, DeviceItemProps, } from './helpers';
-export { deriveDeviceKind } from './helpers';
+export type { ChildLayoutSection, GroupedChildren } from './child-layout';
+export { groupChildrenByLayout } from './child-layout';
 export { ChildSectionAccordion } from './child-section-accordion';
 export { ContainerChildrenProvider, useContainerChildren } from './container-children-context';
-export { groupChildrenByLayout } from './child-layout';
-export type { GroupedChildren, ChildLayoutSection } from './child-layout';
+export type { DeviceItemDevice, DeviceItemKind, DeviceItemParent, DeviceItemProps, DeviceItemVariant, DeviceItemView, } from './helpers';
+export { childListName, deriveDeviceKind, stripParentNamePrefix } from './helpers';
 export declare function DeviceItem(props: DeviceItemProps): ReactNode;

package/dist/composites/device-list/group.d.ts

@@ -22,4 +22,13 @@ export interface GroupedDevices {
     readonly topLevel: readonly DeviceItemDevice[];
     readonly accessoriesByParent: ReadonlyMap<number, readonly DeviceItemDevice[]>;
 }
-export declare function groupTopLevelAndAccessories(devices: readonly DeviceItemDevice[]): GroupedDevices;
+/** Options for `groupTopLevelAndAccessories`. */
+export interface GroupDevicesOptions {
+    /** Include devices carrying an operator `display.hidden` override. Default
+     *  false — hidden devices are omitted from BOTH top-level and accessory
+     *  lists. NOTE: distinct from the HA `accessories` cap `hiddenChildIds`
+     *  mechanism (container-scoped, provider-persisted) — this is the device-level
+     *  `display.hidden` flag. A future "show hidden" toggle flips this one prop. */
+    readonly includeHidden?: boolean;
+}
+export declare function groupTopLevelAndAccessories(devices: readonly DeviceItemDevice[], options?: GroupDevicesOptions): GroupedDevices;

package/dist/composites/device-meta.d.ts

@@ -35,4 +35,15 @@ export declare function deviceRoleMeta(role: DeviceRole): DeviceRoleMeta;
 export declare function deviceTypeMetaOf(type: string): DeviceTypeMeta;
 /** Runtime-string-safe role lookup; unknown roles fall back to `GenericSensor`. */
 export declare function deviceRoleMetaOf(role: string): DeviceRoleMeta;
+/**
+ * Icons an operator may pick for a per-device `display.icon` override, keyed by
+ * a stable kebab-case name. Built ONLY from the lucide icons already imported by
+ * this module — no new imports, no dynamic indexing — so it stays bundle-size
+ * neutral and the picker offers a curated, sensor-relevant set. Unknown keys
+ * resolve to `undefined` (caller keeps the role/type default).
+ */
+export declare const DISPLAY_ICON_REGISTRY: Readonly<Record<string, LucideIcon>>;
+/** Resolve a `display.icon` name to a lucide component, or `undefined` when the
+ *  name is not in the curated `DISPLAY_ICON_REGISTRY`. */
+export declare function resolveDisplayIcon(name: string): LucideIcon | undefined;
 export declare function allDeviceTypeFilterOptions(): readonly MultiSelectOption[];

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

@@ -399,6 +399,12 @@ export declare const useDeviceManagerSetPrimaryChildEntityId: typeof trpc.device
 export declare const useDeviceManagerSetChildLayout: typeof trpc.deviceManager.setChildLayout.useMutation;
 /** Generated alias around `trpc.deviceManager.setDeviceLinks.useMutation`. */
 export declare const useDeviceManagerSetDeviceLinks: typeof trpc.deviceManager.setDeviceLinks.useMutation;
+/** Generated alias around `trpc.deviceManager.setDisplay.useMutation`. */
+export declare const useDeviceManagerSetDisplay: typeof trpc.deviceManager.setDisplay.useMutation;
+/** Generated alias around `trpc.deviceManager.getRoleDisplayDefaults.useQuery`. */
+export declare const useDeviceManagerGetRoleDisplayDefaults: typeof trpc.deviceManager.getRoleDisplayDefaults.useQuery;
+/** Generated alias around `trpc.deviceManager.setRoleDisplayDefaults.useMutation`. */
+export declare const useDeviceManagerSetRoleDisplayDefaults: typeof trpc.deviceManager.setRoleDisplayDefaults.useMutation;
 /** Generated alias around `trpc.deviceManager.getWireableFields.useQuery`. */
 export declare const useDeviceManagerGetWireableFields: typeof trpc.deviceManager.getWireableFields.useQuery;
 /** Generated alias around `trpc.deviceManager.setRole.useMutation`. */