@camstack/ui-library 1.2.110 → 1.2.112

package/dist/composites/device-controls/container-primary.d.ts

@@ -11,6 +11,10 @@ export interface ContainerChild {
     readonly sourceInfo?: {
         readonly id: string;
     } | undefined;
+    /** `DeviceRole`, ranked above `type` when picking a container's primary. */
+    readonly role?: string | null | undefined;
+    /** Operator-facing name — used for the namesake tiebreak. */
+    readonly name?: string | undefined;
 }
 /**
  * Re-sync-stable identity of a child. Prefers the upstream-system dispatch key

package/dist/composites/device-controls/primary-child-picker.d.ts

@@ -10,7 +10,8 @@ export interface PrimaryChildPickerProps {
     /** Numeric id of the currently-resolved primary child. */
     readonly selectedId: number;
     /** Called with the picked child's re-sync/rename-stable `entityId`. */
-    readonly onSetPrimary: (childEntityId: string) => void;
+    /** Called with the picked child's `stableId` — the canonical override key. */
+    readonly onSetPrimary: (childStableId: string) => void;
     /** Disable the control while a persist is in flight. */
     readonly disabled?: boolean;
     /** Optional extra classes for the `<select>` (so a host row can size it). */

package/dist/composites/device-controls/primary-child.d.ts

@@ -15,6 +15,10 @@ export interface ChildRef {
     readonly id: number;
     readonly entityId: string;
     readonly type: string;
+    /** `DeviceRole`, ranked ABOVE `type` — see `CONTAINER_CHILD_ROLE_PRIORITY`. */
+    readonly role?: string | undefined;
+    /** Operator-facing name — used for the namesake tiebreak. */
+    readonly name?: string | undefined;
 }
 /**
  * Resolve a container's primary child: the operator's pick when it still
@@ -24,4 +28,4 @@ export interface ChildRef {
  * The shared resolver matches its canonical `stableId` key first and accepts
  * that legacy value too, so a pick stored under either keeps resolving.
  */
-export declare function resolvePrimaryChild(children: readonly ChildRef[], overrideEntityId: string | undefined): ChildRef | null;
+export declare function resolvePrimaryChild(children: readonly ChildRef[], overrideEntityId: string | undefined, containerName?: string): ChildRef | null;

package/dist/index.cjs

@@ -39656,12 +39656,14 @@ var PRIORITY = _camstack_types.CONTAINER_CHILD_PRIORITY;
 * The shared resolver matches its canonical `stableId` key first and accepts
 * that legacy value too, so a pick stored under either keeps resolving.
 */
-function resolvePrimaryChild(children, overrideEntityId) {
+function resolvePrimaryChild(children, overrideEntityId, containerName) {
 	const picked = (0, _camstack_types.resolveContainerPrimaryChild)(children.map((c) => ({
 		id: c.id,
 		stableId: c.entityId,
-		type: c.type
-	})), overrideEntityId);
+		type: c.type,
+		...c.role !== void 0 ? { role: c.role } : {},
+		...c.name !== void 0 ? { name: c.name } : {}
+	})), overrideEntityId, containerName);
 	return picked === null ? null : children.find((c) => c.id === picked.id) ?? null;
 }
 //#endregion
@@ -39680,7 +39682,9 @@ function containerChildToRef(child) {
 	return {
 		id: child.id,
 		entityId: childEntityId(child),
-		type: child.type
+		type: child.type,
+		...child.role !== void 0 && child.role !== null ? { role: child.role } : {},
+		...child.name !== void 0 ? { name: child.name } : {}
 	};
 }
 /**
@@ -39741,7 +39745,7 @@ function PrimaryChildPicker({ childrenList, selectedId, onSetPrimary, disabled,
 			const nextId = Number(e.target.value);
 			if (!Number.isFinite(nextId) || nextId === selectedId) return;
 			const picked = childrenList.find((c) => c.id === nextId);
-			if (picked !== void 0) onSetPrimary(childEntityId(picked));
+			if (picked !== void 0) onSetPrimary(picked.stableId);
 		},
 		className: className === void 0 ? BASE_SELECT_CLASS : `${BASE_SELECT_CLASS} ${className}`,
 		children: childrenList.map((c) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("option", {

package/dist/index.js

@@ -39632,12 +39632,14 @@ var PRIORITY = CONTAINER_CHILD_PRIORITY;
 * The shared resolver matches its canonical `stableId` key first and accepts
 * that legacy value too, so a pick stored under either keeps resolving.
 */
-function resolvePrimaryChild(children, overrideEntityId) {
+function resolvePrimaryChild(children, overrideEntityId, containerName) {
 	const picked = resolveContainerPrimaryChild(children.map((c) => ({
 		id: c.id,
 		stableId: c.entityId,
-		type: c.type
-	})), overrideEntityId);
+		type: c.type,
+		...c.role !== void 0 ? { role: c.role } : {},
+		...c.name !== void 0 ? { name: c.name } : {}
+	})), overrideEntityId, containerName);
 	return picked === null ? null : children.find((c) => c.id === picked.id) ?? null;
 }
 //#endregion
@@ -39656,7 +39658,9 @@ function containerChildToRef(child) {
 	return {
 		id: child.id,
 		entityId: childEntityId(child),
-		type: child.type
+		type: child.type,
+		...child.role !== void 0 && child.role !== null ? { role: child.role } : {},
+		...child.name !== void 0 ? { name: child.name } : {}
 	};
 }
 /**
@@ -39717,7 +39721,7 @@ function PrimaryChildPicker({ childrenList, selectedId, onSetPrimary, disabled,
 			const nextId = Number(e.target.value);
 			if (!Number.isFinite(nextId) || nextId === selectedId) return;
 			const picked = childrenList.find((c) => c.id === nextId);
-			if (picked !== void 0) onSetPrimary(childEntityId(picked));
+			if (picked !== void 0) onSetPrimary(picked.stableId);
 		},
 		className: className === void 0 ? BASE_SELECT_CLASS : `${BASE_SELECT_CLASS} ${className}`,
 		children: childrenList.map((c) => /* @__PURE__ */ jsxs("option", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/ui-library",
-  "version": "1.2.110",
+  "version": "1.2.112",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",