@camstack/ui-library 1.2.113 → 1.2.115

package/dist/composites/device-select-filter.d.ts

@@ -20,6 +20,12 @@ export interface DeviceSelectCandidate {
     readonly name: string;
     readonly location?: string | null;
     readonly features?: readonly string[];
+    /** Name of the container this device lives in, when it has one. */
+    readonly parentName?: string | null;
+}
+/** A picker option that still knows where its device is. */
+export interface DeviceOption extends ConfigOption {
+    readonly location: string | null;
 }
 /**
  * Does a device satisfy the filter?
@@ -37,13 +43,35 @@ export declare function deviceOptionLabel(device: DeviceSelectCandidate): string
  * (value = the device id as a string). Sorted case-insensitively by label so
  * the picker order is stable.
  */
-export declare function devicesToOptions(devices: readonly DeviceSelectCandidate[], filter?: DeviceSelectFilter): ConfigOption[];
+/** `Location · type · in Container` — the parts a name alone does not say. */
+export declare function deviceOptionDescription(device: DeviceSelectCandidate): string;
+export declare function devicesToOptions(devices: readonly DeviceSelectCandidate[], filter?: DeviceSelectFilter): DeviceOption[];
+export interface DeviceFacets {
+    readonly locations: readonly string[];
+    readonly types: readonly string[];
+}
+/** The distinct locations and types on offer — the chips above the search. */
+export declare function deviceFacets(devices: readonly DeviceSelectCandidate[]): DeviceFacets;
+/** Each facet is a SET of chosen values: any of them matches, none = all. */
+export interface FacetSelection {
+    readonly locations: readonly string[];
+    readonly types: readonly string[];
+}
+export declare const NO_FACETS: FacetSelection;
+/** Every facet with a choice must match one of its values. */
+export declare function matchesFacets(device: DeviceSelectCandidate, facets: FacetSelection): boolean;
+export interface SuggestedPartition<T extends DeviceOption> {
+    readonly suggested: readonly T[];
+    readonly others: readonly T[];
+}
+/** The devices sharing `location` come first — suggested, never pre-linked. */
+export declare function partitionSuggested<T extends DeviceOption>(options: readonly T[], location: string | null | undefined): SuggestedPartition<T>;
 /**
  * Free-text option filter — case-insensitive AND over whitespace tokens, each
  * matched against the option's `value` + `label` (so a device is found by name,
  * id, or location). An empty query returns every option in order.
  */
-export declare function filterDeviceOptions(options: readonly ConfigOption[], query: string): ConfigOption[];
+export declare function filterDeviceOptions<T extends ConfigOption>(options: readonly T[], query: string): T[];
 /**
  * Resolve the currently-selected values into options IN SELECTION ORDER (so
  * chips stay stable while searching). A selected value with no matching option