@camstack/ui-library 1.2.63 → 1.2.65

package/dist/composites/model-picker.d.ts

@@ -6,10 +6,14 @@ export type ModelOption = PipelineAddonSchema['models'][number];
  * Renders the grouped Family→Tier→Resolution→Variant selector
  * ({@link GroupedModelSelector}) when the step's models declare variant groups
  * (yolo26 / yolov9 …), else a flat `<select>` (face / plate / classifier
- * catalogs and operator-registered custom models). Custom / ungrouped ids stay
- * selectable via an "Other models" flat select alongside the grouped picker, and
- * a legacy/removed pin is surfaced with an explicit banner rather than a
- * silently mis-highlighted chip.
+ * catalogs and operator-registered custom models).
+ *
+ * D214 — the catalog and the custom/ungrouped list are MUTUALLY EXCLUSIVE
+ * views. A pinned custom model hides the grouped catalog entirely (both used
+ * to render, and the grouped picker highlighted a family that was NOT the
+ * selection); while a catalog model is pinned the custom list stays behind an
+ * explicit affordance. A legacy/removed pin is surfaced with an explicit
+ * banner rather than a silently mis-highlighted chip.
  *
  * Used by the pipeline stepper (`PipelineStep`), the agent/device step editor
  * (`AgentStepEditor`), and the benchmark — so the picker looks identical

package/dist/composites/pipeline-matrix-shared.d.ts

@@ -76,6 +76,17 @@ export type CellState = {
      * "→ label" badge on the cell.
      */
     readonly jumpTo?: string;
+    /**
+     * This model is a CLUSTER-wide choice, not a per-(node,device) one — the
+     * step writes into a shared vector index, where two encoders make
+     * similarity scores meaningless.
+     *
+     * The cell must SAY so. Rendering a cluster value in a per-node matrix
+     * with no marking invites the operator to change it expecting a per-node
+     * effect, and to read a neighbouring node's identical value as a
+     * coincidence rather than as the same single row.
+     */
+    readonly clusterWide?: boolean;
 } | {
     readonly kind: 'disabled';
     readonly overridden?: boolean;

package/dist/composites/pipeline-step.d.ts

@@ -72,4 +72,4 @@ export declare function ConfigSchemaField({ field, allFields, step, disabled, on
     step: PipelineStepDisplayConfig;
     disabled: boolean;
     onChange: (updated: PipelineStepDisplayConfig) => void;
-}): import("react").JSX.Element | null;
+}): import("react").JSX.Element;

package/dist/index.cjs

@@ -21855,10 +21855,14 @@ function GroupedModelSelector({ catalog, value, onChange, disabled }) {
 * Renders the grouped Family→Tier→Resolution→Variant selector
 * ({@link GroupedModelSelector}) when the step's models declare variant groups
 * (yolo26 / yolov9 …), else a flat `<select>` (face / plate / classifier
-* catalogs and operator-registered custom models). Custom / ungrouped ids stay
-* selectable via an "Other models" flat select alongside the grouped picker, and
-* a legacy/removed pin is surfaced with an explicit banner rather than a
-* silently mis-highlighted chip.
+* catalogs and operator-registered custom models).
+*
+* D214 — the catalog and the custom/ungrouped list are MUTUALLY EXCLUSIVE
+* views. A pinned custom model hides the grouped catalog entirely (both used
+* to render, and the grouped picker highlighted a family that was NOT the
+* selection); while a catalog model is pinned the custom list stays behind an
+* explicit affordance. A legacy/removed pin is surfaced with an explicit
+* banner rather than a silently mis-highlighted chip.
 *
 * Used by the pipeline stepper (`PipelineStep`), the agent/device step editor
 * (`AgentStepEditor`), and the benchmark — so the picker looks identical
@@ -21869,6 +21873,11 @@ function GroupedModelSelector({ catalog, value, onChange, disabled }) {
 function ModelPicker({ models, value, onChange, disabled }) {
 	const hasGroups = (0, react$1.useMemo)(() => (0, _camstack_types.buildModelVariantGroups)(models).length > 0, [models]);
 	const ungrouped = (0, react$1.useMemo)(() => models.filter((m) => m.group === void 0), [models]);
+	const customSelected = ungrouped.some((m) => m.id === value);
+	const [view, setView] = (0, react$1.useState)(customSelected ? "custom" : "catalog");
+	(0, react$1.useEffect)(() => {
+		setView(customSelected ? "custom" : "catalog");
+	}, [customSelected, value]);
 	const unresolvedBanner = value !== "" && !models.some((m) => m.id === value) && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 		className: "rounded border border-amber-500/40 bg-amber-500/10 px-2 py-1.5 text-[10px] text-amber-300",
 		children: [
@@ -21894,10 +21903,35 @@ function ModelPicker({ models, value, onChange, disabled }) {
 			children: m.name
 		}, m.id))]
 	});
+	const switchButton = (label, target) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+		type: "button",
+		disabled,
+		onClick: () => setView(target),
+		className: "text-[10px] text-primary hover:underline disabled:opacity-50",
+		children: label
+	});
 	if (!hasGroups) return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 		className: "space-y-2",
 		children: [unresolvedBanner, flatSelect(models, "— select a model —")]
 	});
+	if (view === "custom" && ungrouped.length > 0) return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		className: "space-y-2",
+		children: [
+			unresolvedBanner,
+			/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: "flex items-center justify-between",
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					className: "text-[10px] uppercase tracking-widest text-foreground-subtle",
+					children: "Custom / ungrouped model"
+				}), switchButton("Choose from catalog instead", "catalog")]
+			}),
+			flatSelect(ungrouped, "— custom / ungrouped model —"),
+			customSelected && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				className: "text-[10px] text-foreground-subtle",
+				children: "A custom model is pinned — the catalog selection is hidden while it is active."
+			})
+		]
+	});
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 		className: "space-y-3",
 		children: [
@@ -21908,10 +21942,10 @@ function ModelPicker({ models, value, onChange, disabled }) {
 				onChange,
 				disabled
 			}),
-			ungrouped.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-				className: "text-[10px] uppercase tracking-widest text-foreground-subtle mb-1",
-				children: "Other models"
-			}), flatSelect(ungrouped, "— custom / ungrouped model —")] })
+			ungrouped.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				className: "flex justify-end",
+				children: switchButton("Use a custom model…", "custom")
+			})
 		]
 	});
 }
@@ -22112,6 +22146,26 @@ function resolveSettingValue(key, step, allFields) {
 	return sibling && "default" in sibling ? sibling.default : void 0;
 }
 function ConfigSchemaField({ field, allFields, step, disabled, onChange }) {
+	const applicability = "modelApplicability" in field ? field.modelApplicability : void 0;
+	const inapplicableReason = applicability?.inapplicable?.[step.modelId];
+	const control = /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ConfigSchemaFieldControl, {
+		field,
+		allFields,
+		step,
+		disabled: disabled || inapplicableReason !== void 0,
+		modelScopedOptions: applicability?.optionsByModel?.[step.modelId],
+		onChange
+	});
+	if (inapplicableReason === void 0) return control;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		className: "space-y-1",
+		children: [control, /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			className: "text-[10px] text-amber-400/90",
+			children: ["No effect with the selected model — ", inapplicableReason]
+		})]
+	});
+}
+function ConfigSchemaFieldControl({ field, allFields, step, disabled, modelScopedOptions, onChange }) {
 	const showWhen = field.type !== "separator" && field.type !== "info" ? field.showWhen : void 0;
 	if (showWhen) {
 		const { field: condField, equals, notEquals, in: inList, notIn } = showWhen;
@@ -22137,7 +22191,7 @@ function ConfigSchemaField({ field, allFields, step, disabled, onChange }) {
 			label: field.label,
 			value: current,
 			disabled: disabled || field.disabled,
-			options: field.options,
+			options: modelScopedOptions ?? field.options,
 			onChange: handleChange
 		});
 	}
@@ -22148,7 +22202,7 @@ function ConfigSchemaField({ field, allFields, step, disabled, onChange }) {
 			label: field.label,
 			description: field.description,
 			value: current,
-			options: field.options,
+			options: modelScopedOptions ?? field.options,
 			disabled: disabled || field.disabled,
 			onChange: handleChange
 		});
@@ -44198,6 +44252,11 @@ function renderCellContent(state) {
 				className: "font-mono text-foreground truncate",
 				children: state.modelId
 			}),
+			state.clusterWide === true && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+				className: "ml-auto shrink-0 text-[8px] font-semibold uppercase text-primary",
+				title: "One value for the whole cluster — this step writes into a shared vector index",
+				children: "cluster"
+			}),
 			state.jumpTo !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 				className: "ml-auto shrink-0 text-[8px] font-semibold text-sky-500",
 				title: `runs on ${state.jumpTo}`,

package/dist/index.js

@@ -21831,10 +21831,14 @@ function GroupedModelSelector({ catalog, value, onChange, disabled }) {
 * Renders the grouped Family→Tier→Resolution→Variant selector
 * ({@link GroupedModelSelector}) when the step's models declare variant groups
 * (yolo26 / yolov9 …), else a flat `<select>` (face / plate / classifier
-* catalogs and operator-registered custom models). Custom / ungrouped ids stay
-* selectable via an "Other models" flat select alongside the grouped picker, and
-* a legacy/removed pin is surfaced with an explicit banner rather than a
-* silently mis-highlighted chip.
+* catalogs and operator-registered custom models).
+*
+* D214 — the catalog and the custom/ungrouped list are MUTUALLY EXCLUSIVE
+* views. A pinned custom model hides the grouped catalog entirely (both used
+* to render, and the grouped picker highlighted a family that was NOT the
+* selection); while a catalog model is pinned the custom list stays behind an
+* explicit affordance. A legacy/removed pin is surfaced with an explicit
+* banner rather than a silently mis-highlighted chip.
 *
 * Used by the pipeline stepper (`PipelineStep`), the agent/device step editor
 * (`AgentStepEditor`), and the benchmark — so the picker looks identical
@@ -21845,6 +21849,11 @@ function GroupedModelSelector({ catalog, value, onChange, disabled }) {
 function ModelPicker({ models, value, onChange, disabled }) {
 	const hasGroups = useMemo(() => buildModelVariantGroups(models).length > 0, [models]);
 	const ungrouped = useMemo(() => models.filter((m) => m.group === void 0), [models]);
+	const customSelected = ungrouped.some((m) => m.id === value);
+	const [view, setView] = useState(customSelected ? "custom" : "catalog");
+	useEffect(() => {
+		setView(customSelected ? "custom" : "catalog");
+	}, [customSelected, value]);
 	const unresolvedBanner = value !== "" && !models.some((m) => m.id === value) && /* @__PURE__ */ jsxs("div", {
 		className: "rounded border border-amber-500/40 bg-amber-500/10 px-2 py-1.5 text-[10px] text-amber-300",
 		children: [
@@ -21870,10 +21879,35 @@ function ModelPicker({ models, value, onChange, disabled }) {
 			children: m.name
 		}, m.id))]
 	});
+	const switchButton = (label, target) => /* @__PURE__ */ jsx("button", {
+		type: "button",
+		disabled,
+		onClick: () => setView(target),
+		className: "text-[10px] text-primary hover:underline disabled:opacity-50",
+		children: label
+	});
 	if (!hasGroups) return /* @__PURE__ */ jsxs("div", {
 		className: "space-y-2",
 		children: [unresolvedBanner, flatSelect(models, "— select a model —")]
 	});
+	if (view === "custom" && ungrouped.length > 0) return /* @__PURE__ */ jsxs("div", {
+		className: "space-y-2",
+		children: [
+			unresolvedBanner,
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex items-center justify-between",
+				children: [/* @__PURE__ */ jsx("div", {
+					className: "text-[10px] uppercase tracking-widest text-foreground-subtle",
+					children: "Custom / ungrouped model"
+				}), switchButton("Choose from catalog instead", "catalog")]
+			}),
+			flatSelect(ungrouped, "— custom / ungrouped model —"),
+			customSelected && /* @__PURE__ */ jsx("div", {
+				className: "text-[10px] text-foreground-subtle",
+				children: "A custom model is pinned — the catalog selection is hidden while it is active."
+			})
+		]
+	});
 	return /* @__PURE__ */ jsxs("div", {
 		className: "space-y-3",
 		children: [
@@ -21884,10 +21918,10 @@ function ModelPicker({ models, value, onChange, disabled }) {
 				onChange,
 				disabled
 			}),
-			ungrouped.length > 0 && /* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx("div", {
-				className: "text-[10px] uppercase tracking-widest text-foreground-subtle mb-1",
-				children: "Other models"
-			}), flatSelect(ungrouped, "— custom / ungrouped model —")] })
+			ungrouped.length > 0 && /* @__PURE__ */ jsx("div", {
+				className: "flex justify-end",
+				children: switchButton("Use a custom model…", "custom")
+			})
 		]
 	});
 }
@@ -22088,6 +22122,26 @@ function resolveSettingValue(key, step, allFields) {
 	return sibling && "default" in sibling ? sibling.default : void 0;
 }
 function ConfigSchemaField({ field, allFields, step, disabled, onChange }) {
+	const applicability = "modelApplicability" in field ? field.modelApplicability : void 0;
+	const inapplicableReason = applicability?.inapplicable?.[step.modelId];
+	const control = /* @__PURE__ */ jsx(ConfigSchemaFieldControl, {
+		field,
+		allFields,
+		step,
+		disabled: disabled || inapplicableReason !== void 0,
+		modelScopedOptions: applicability?.optionsByModel?.[step.modelId],
+		onChange
+	});
+	if (inapplicableReason === void 0) return control;
+	return /* @__PURE__ */ jsxs("div", {
+		className: "space-y-1",
+		children: [control, /* @__PURE__ */ jsxs("div", {
+			className: "text-[10px] text-amber-400/90",
+			children: ["No effect with the selected model — ", inapplicableReason]
+		})]
+	});
+}
+function ConfigSchemaFieldControl({ field, allFields, step, disabled, modelScopedOptions, onChange }) {
 	const showWhen = field.type !== "separator" && field.type !== "info" ? field.showWhen : void 0;
 	if (showWhen) {
 		const { field: condField, equals, notEquals, in: inList, notIn } = showWhen;
@@ -22113,7 +22167,7 @@ function ConfigSchemaField({ field, allFields, step, disabled, onChange }) {
 			label: field.label,
 			value: current,
 			disabled: disabled || field.disabled,
-			options: field.options,
+			options: modelScopedOptions ?? field.options,
 			onChange: handleChange
 		});
 	}
@@ -22124,7 +22178,7 @@ function ConfigSchemaField({ field, allFields, step, disabled, onChange }) {
 			label: field.label,
 			description: field.description,
 			value: current,
-			options: field.options,
+			options: modelScopedOptions ?? field.options,
 			disabled: disabled || field.disabled,
 			onChange: handleChange
 		});
@@ -44174,6 +44228,11 @@ function renderCellContent(state) {
 				className: "font-mono text-foreground truncate",
 				children: state.modelId
 			}),
+			state.clusterWide === true && /* @__PURE__ */ jsx("span", {
+				className: "ml-auto shrink-0 text-[8px] font-semibold uppercase text-primary",
+				title: "One value for the whole cluster — this step writes into a shared vector index",
+				children: "cluster"
+			}),
 			state.jumpTo !== void 0 && /* @__PURE__ */ jsxs("span", {
 				className: "ml-auto shrink-0 text-[8px] font-semibold text-sky-500",
 				title: `runs on ${state.jumpTo}`,

package/package.json

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