@camstack/ui-library 1.2.237 → 1.2.239

package/dist/composites/model-bound-slider.d.ts

@@ -0,0 +1,28 @@
+import { ConfigField, ConfigNumberField, ConfigSliderField } from '@camstack/types';
+/** A numeric field this control can render. */
+export type ModelBoundNumericField = ConfigSliderField | ConfigNumberField;
+export interface ModelBoundSliderProps {
+    readonly field: ModelBoundNumericField;
+    /** The model the edited row runs — pinned, or its effective default. */
+    readonly modelId: string;
+    readonly settings: Readonly<Record<string, unknown>> | undefined;
+    readonly disabled: boolean;
+    readonly onChangeSettings: (next: Record<string, unknown>) => void;
+}
+export declare function ModelBoundSlider({ field, modelId, settings, disabled, onChangeSettings, }: ModelBoundSliderProps): import("react").JSX.Element;
+/** The keys of the model-bound fields of a schema, groups flattened. */
+export declare function modelBoundKeysOf(fields: readonly ConfigField[]): string[];
+export interface ResetModelDefaultsButtonProps {
+    readonly fields: readonly ConfigField[];
+    /** The model the edited row runs — pinned, or its effective default. */
+    readonly modelId: string;
+    readonly settings: Readonly<Record<string, unknown>> | undefined;
+    readonly disabled?: boolean;
+    readonly onReset: (next: Record<string, unknown>) => void;
+}
+/**
+ * "Reset thresholds to model defaults" — every model-bound override in force
+ * for `modelId`, cleared in ONE settings change (one save). Rendered only when
+ * there is something to reset. An override stored for another model is kept.
+ */
+export declare function ResetModelDefaultsButton({ fields, modelId, settings, disabled, onReset, }: ResetModelDefaultsButtonProps): import("react").JSX.Element | null;

package/dist/index.cjs

@@ -28752,18 +28752,31 @@ function GroupedModelSelector({ catalog, value, onChange, disabled }) {
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 		className: "space-y-3",
 		children: [
-			families.length > 1 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-				className: "text-[10px] uppercase tracking-wide text-foreground-subtle mb-1.5",
-				children: "Family"
-			}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-				className: "flex flex-wrap gap-1.5",
-				children: families.map((f) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Chip, {
-					active: f.family === family.family,
-					disabled,
-					onClick: () => onChange(f.tiers[0]?.baseModelId ?? ""),
-					children: f.label
-				}, f.family))
-			})] }),
+			families.length > 1 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", { children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: "text-[10px] uppercase tracking-wide text-foreground-subtle mb-1.5",
+					children: "Family"
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					className: "flex flex-wrap gap-1.5",
+					children: families.map((f) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Chip, {
+						active: f.family === family.family,
+						disabled,
+						...f.hint !== void 0 ? { title: f.hint } : {},
+						onClick: () => onChange(f.tiers[0]?.baseModelId ?? ""),
+						children: f.label
+					}, f.family))
+				}),
+				family.hint !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
+					className: "mt-1 text-[10px] text-foreground-subtle",
+					"data-testid": "model-family-hint",
+					children: [
+						family.label,
+						": ",
+						family.hint
+					]
+				})
+			] }),
 			family.tiers.length > 1 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
 				className: "text-[10px] uppercase tracking-wide text-foreground-subtle mb-1.5",
 				children: [family.label, " — size"]
@@ -28957,6 +28970,106 @@ function ModelPicker({ models, value, onChange, disabled, defaultModelId }) {
 	});
 }
 //#endregion
+//#region src/composites/model-bound-slider.tsx
+var SOURCE_LABEL = {
+	override: "Override for this model",
+	"model-default": "Model default",
+	"global-default": "Default — not tuned for this model"
+};
+function formatNumber(value, scale) {
+	return (scale !== void 0 ? value / scale : value).toFixed(2).replace(/\.?0+$/, "");
+}
+function ModelBoundSlider({ field, modelId, settings, disabled, onChangeSettings }) {
+	const modelDefault = field.modelApplicability?.defaultByModel?.[modelId];
+	const state = (0, _camstack_types.resolveModelBoundSetting)(settings, field.key, modelId.length > 0 ? modelId : void 0, modelDefault, field.default);
+	const fallback = typeof field.default === "number" ? field.default : field.min ?? 0;
+	const current = typeof state.value === "number" ? state.value : fallback;
+	const scale = field.type === "slider" ? field.displayScale : void 0;
+	const unit = "unit" in field ? field.unit : void 0;
+	const stale = state.inapplicableOverride;
+	const hasStoredValue = settings?.[field.key] !== void 0;
+	const handleChange = (value) => {
+		onChangeSettings(modelId.length > 0 ? (0, _camstack_types.writeModelBoundSetting)(settings, field.key, value, modelId) : {
+			...settings,
+			[field.key]: value
+		});
+	};
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", { children: [
+		/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			className: "flex items-center justify-between mb-1",
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+				className: "text-[10px] font-medium text-foreground-subtle uppercase tracking-wide",
+				children: field.label
+			}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+				className: "text-xs font-medium text-foreground tabular-nums",
+				children: [formatNumber(current, scale), unit ? ` ${unit}` : ""]
+			})]
+		}),
+		field.description && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+			className: "text-[10px] text-foreground-subtle/60 mb-1.5",
+			children: field.description
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+			type: "range",
+			min: field.min ?? 0,
+			max: field.max ?? 1,
+			step: field.step ?? .01,
+			value: current,
+			disabled: disabled || field.disabled,
+			onChange: (e) => handleChange(Number(e.target.value)),
+			className: "w-full accent-primary h-1.5"
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			className: "mt-1 flex items-center justify-between gap-2 text-[10px]",
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+				"data-testid": "model-bound-source",
+				className: state.source === "override" ? "text-primary font-medium" : "text-foreground-subtle",
+				children: SOURCE_LABEL[state.source]
+			}), hasStoredValue && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+				type: "button",
+				disabled,
+				className: "text-foreground-subtle hover:text-foreground disabled:opacity-50",
+				onClick: () => onChangeSettings((0, _camstack_types.clearModelBoundSetting)(settings, field.key)),
+				children: "Reset to model default"
+			})]
+		}),
+		stale !== void 0 && typeof stale.value === "number" && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("p", {
+			className: "mt-1 text-[10px] text-amber-400/90",
+			children: [
+				"The override ",
+				formatNumber(stale.value, scale),
+				" was set for ",
+				stale.modelId,
+				" and does not apply to this model."
+			]
+		})
+	] });
+}
+/** The keys of the model-bound fields of a schema, groups flattened. */
+function modelBoundKeysOf(fields) {
+	return fields.flatMap((field) => {
+		if (field.type === "group") return modelBoundKeysOf(field.fields);
+		return "key" in field && "bindsToModel" in field && field.bindsToModel === true ? [field.key] : [];
+	});
+}
+/**
+* "Reset thresholds to model defaults" — every model-bound override in force
+* for `modelId`, cleared in ONE settings change (one save). Rendered only when
+* there is something to reset. An override stored for another model is kept.
+*/
+function ResetModelDefaultsButton({ fields, modelId, settings, disabled, onReset }) {
+	const keys = modelBoundKeysOf(fields);
+	const model = modelId.length > 0 ? modelId : void 0;
+	if (keys.length === 0 || !(0, _camstack_types.hasModelBoundOverrides)(settings, keys, model)) return null;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+		type: "button",
+		disabled,
+		className: "text-[10px] text-primary hover:underline disabled:opacity-50",
+		onClick: () => onReset((0, _camstack_types.clearModelBoundOverrides)(settings, keys, model)),
+		children: "Reset thresholds to model defaults"
+	});
+}
+//#endregion
 //#region src/composites/pipeline-step.tsx
 /**
 * PipelineStep — single step card in the pipeline builder.
@@ -29214,6 +29327,16 @@ function ConfigSchemaFieldControl({ field, allFields, step, disabled, modelScope
 			onChange: handleChange
 		});
 	}
+	if ((field.type === "slider" || field.type === "number") && field.bindsToModel === true) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ModelBoundSlider, {
+		field,
+		modelId: step.modelId,
+		settings: step.settings,
+		disabled,
+		onChangeSettings: (settings) => onChange({
+			...step,
+			settings
+		})
+	});
 	if (field.type === "slider" || field.type === "number") {
 		const raw = step.settings?.[field.key];
 		const fallback = typeof field.default === "number" ? field.default : field.min ?? 0;
@@ -29400,6 +29523,7 @@ function supplyNotes(supply) {
 		if (supply.stepId === "package-detection") return [...notes, "The root model's own package boxes become the package result at this step's threshold; this step's zone-crop view is not used, so small parcels the full-frame model misses stay missed."];
 		return [...notes, "This step's class list decides which of the root's labels become the fine class; a switched-off class stays at its macro."];
 	}
+	if (supply.kind === "mask") return ["Masks come from the root model: each detection carries the root's own instance mask, so this step's model does not run. A root mask follows the model's mask grid (a quarter of its input), coarser than this step's own per-crop mask."];
 	if (supply.stepId === "face-detection") return ["Face boxes come from the root model. Each is re-found by this step's face detector in a square around it before recognition, so only a face it finds is recognised; a box with no face in it is dropped."];
 	return ["Plate boxes come from the root model and the plate reader reads them. The crop margin around a root plate box has not been measured for this model yet."];
 }
@@ -29471,7 +29595,19 @@ function ClusterSettingsHint({ addonId }) {
 		children: "Admission knobs for this step live in Pipeline → Cluster → Settings → Enrichment models. They apply to every camera — a per-device copy would fill the shared index from two policies."
 	});
 }
-function buildDisplayStep(addon, cfg) {
+/**
+* The model the step's settings are read and written for — what a model-bound
+* field (D738) binds to. While the ROOT supplies the step's fine label (D741),
+* that is the root model: the step's threshold then gates the root's label, on
+* the root's score scale. Otherwise the step's own model: its pin, else the
+* model the row really runs (`effectiveModelId` — the device's hardware-aware
+* default when unpinned), else the step's flat catalog default.
+*/
+function settingsModelIdFor(addon, cfg, effectiveModelId, rootModel) {
+	if (rootModel !== void 0 && rootSourceState(addon.id, cfg.settings, rootModel)?.effective) return rootModel.modelId;
+	return cfg.modelId ?? effectiveModelId ?? addon.defaultModelId;
+}
+function buildDisplayStep(addon, cfg, modelId) {
 	return {
 		addonId: addon.id,
 		addonName: addon.name,
@@ -29479,7 +29615,7 @@ function buildDisplayStep(addon, cfg) {
 		inputClasses: [...addon.inputClasses],
 		outputClasses: [...addon.outputClasses],
 		enabled: cfg.enabled,
-		modelId: cfg.modelId ?? addon.defaultModelId,
+		modelId,
 		children: [],
 		settings: { ...cfg.settings }
 	};
@@ -29544,13 +29680,21 @@ function AgentModeEditor({ addon, agentDefault, modelsForFormat, engineFormat, e
 			})] }),
 			localSchema.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "pt-2 border-t border-border/50 space-y-3",
-				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-					className: "text-[10px] uppercase tracking-widest text-foreground-subtle",
-					children: "Settings"
+				children: [/* @__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: "Settings"
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ResetModelDefaultsButton, {
+						fields: localSchema,
+						modelId: settingsModelIdFor(addon, agentDefault, effectiveModelId, rootModel),
+						settings: agentDefault.settings,
+						onReset: (settings) => update({ settings })
+					})]
 				}), localSchema.map((field) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ConfigSchemaField, {
 					field,
 					allFields: localSchema,
-					step: buildDisplayStep(addon, agentDefault),
+					step: buildDisplayStep(addon, agentDefault, settingsModelIdFor(addon, agentDefault, effectiveModelId, rootModel)),
 					disabled: false,
 					onChange: (next) => update({ settings: { ...next.settings } })
 				}, field.key))]
@@ -29646,11 +29790,19 @@ function DeviceModeEditor({ addon, agentDefault, agentNodeId, currentPatch, mode
 							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 								className: "text-[10px] uppercase tracking-widest text-foreground-subtle",
 								children: "Settings"
-							}), settingsOverridden ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-								type: "button",
-								className: "text-[10px] text-foreground-subtle hover:text-foreground",
-								onClick: () => setSettings(void 0),
-								children: "Clear"
+							}), settingsOverridden ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+								className: "flex items-center gap-3",
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ResetModelDefaultsButton, {
+									fields: localSchema,
+									modelId: settingsModelIdFor(addon, effective, inheritedModelId, rootModel),
+									settings: currentPatch?.settings,
+									onReset: (settings) => setSettings(settings)
+								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+									type: "button",
+									className: "text-[10px] text-foreground-subtle hover:text-foreground",
+									onClick: () => setSettings(void 0),
+									children: "Clear"
+								})]
 							}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
 								type: "button",
 								className: "text-[10px] text-primary hover:underline",
@@ -29661,7 +29813,7 @@ function DeviceModeEditor({ addon, agentDefault, agentNodeId, currentPatch, mode
 						localSchema.map((field) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ConfigSchemaField, {
 							field,
 							allFields: localSchema,
-							step: buildDisplayStep(addon, effective),
+							step: buildDisplayStep(addon, effective, settingsModelIdFor(addon, effective, inheritedModelId, rootModel)),
 							disabled: !settingsOverridden,
 							onChange: (next) => setSettings({ ...next.settings })
 						}, field.key)),

package/dist/index.js

@@ -13,7 +13,7 @@ import * as __mfHostReactDOMClient from "react-dom/client";
 import { createRoot } from "react-dom/client";
 import * as __mfHostTrpcClient from "@trpc/client";
 import { createTRPCClient, createWSClient, httpLink, splitLink, wsLink } from "@trpc/client";
-import { ALL_CAPABILITY_DEFINITIONS, CAM_PROFILE_ORDER, CLIP_STILL_DISPOSITION_HEADER, CLIP_STILL_REASON_CODE_HEADER, CLIP_STILL_REASON_HEADER, CONTAINER_CHILD_PRIORITY, DEFAULT_EVENTS_BAND_BUFFER_SEC, DEFAULT_EVENT_COLOR, DEVICE_TYPE_CONTROL_KIND, DISPLAY_ICON_GROUPS, DeviceExportStatusSchema, DeviceFeature, DeviceRole, DeviceType, EVENT_TAXONOMY, EXTENSION_SLOTS, EXTENSION_SLOT_IDS, EventCategory, ExposedDeviceSchema, FIRST_LEVEL_MACRO_CLASSES, KNOWN_CAP_NAMES, MAX_SENSOR_TRIGGER_DEVICES, MODEL_PROVIDER_IDS, NAVIGATION_LIGHT_LEVEL_MAX, NAVIGATION_LIGHT_LEVEL_MIN, PET_FEEDER_MANUAL_FEED_MAX, PET_FEEDER_MANUAL_FEED_MIN, RECORDING_AUDIO_TRIGGER_OFFERED_DBFS, RECORDING_SOURCE_CAMSTACK_ADDON, RecordingConfigSchema, RecordingStatusSchema, SOURCE_CAP_ACTIVE_FIELD, STATIONARY_OVERLAY_STYLE, TIMEZONES, USE_ROOT_MODEL_SETTING_KEY, buildModelVariantGroups, canConvertUnit, clusterStepSettingFieldsFor, createDeviceProxy, createLazyTrpcSource, createSliceHandle, deriveRecordingMode, describeModelVariant, findTimezone, formatParkedFor, isRootSuppliableStepId, normalizeUnit, publicEventCategories, resolveContainerPrimaryChild, resolveDeviceControlKind, resolveRecordingProfiles, resolveRootSupply, resolveVariantModelId, resolveViewableDeviceIds, searchDisplayIcons, selectAssignedProfileSlots, tryConvertUnit, unitsForDimension } from "@camstack/types";
+import { ALL_CAPABILITY_DEFINITIONS, CAM_PROFILE_ORDER, CLIP_STILL_DISPOSITION_HEADER, CLIP_STILL_REASON_CODE_HEADER, CLIP_STILL_REASON_HEADER, CONTAINER_CHILD_PRIORITY, DEFAULT_EVENTS_BAND_BUFFER_SEC, DEFAULT_EVENT_COLOR, DEVICE_TYPE_CONTROL_KIND, DISPLAY_ICON_GROUPS, DeviceExportStatusSchema, DeviceFeature, DeviceRole, DeviceType, EVENT_TAXONOMY, EXTENSION_SLOTS, EXTENSION_SLOT_IDS, EventCategory, ExposedDeviceSchema, FIRST_LEVEL_MACRO_CLASSES, KNOWN_CAP_NAMES, MAX_SENSOR_TRIGGER_DEVICES, MODEL_PROVIDER_IDS, NAVIGATION_LIGHT_LEVEL_MAX, NAVIGATION_LIGHT_LEVEL_MIN, PET_FEEDER_MANUAL_FEED_MAX, PET_FEEDER_MANUAL_FEED_MIN, RECORDING_AUDIO_TRIGGER_OFFERED_DBFS, RECORDING_SOURCE_CAMSTACK_ADDON, RecordingConfigSchema, RecordingStatusSchema, SOURCE_CAP_ACTIVE_FIELD, STATIONARY_OVERLAY_STYLE, TIMEZONES, USE_ROOT_MODEL_SETTING_KEY, buildModelVariantGroups, canConvertUnit, clearModelBoundOverrides, clearModelBoundSetting, clusterStepSettingFieldsFor, createDeviceProxy, createLazyTrpcSource, createSliceHandle, deriveRecordingMode, describeModelVariant, findTimezone, formatParkedFor, hasModelBoundOverrides, isRootSuppliableStepId, normalizeUnit, publicEventCategories, resolveContainerPrimaryChild, resolveDeviceControlKind, resolveModelBoundSetting, resolveRecordingProfiles, resolveRootSupply, resolveVariantModelId, resolveViewableDeviceIds, searchDisplayIcons, selectAssignedProfileSlots, tryConvertUnit, unitsForDimension, writeModelBoundSetting } from "@camstack/types";
 import { createSystem } from "@camstack/sdk";
 import { z } from "zod";
 //#region ../../node_modules/lucide-react/dist/esm/shared/src/utils/mergeClasses.js
@@ -28728,18 +28728,31 @@ function GroupedModelSelector({ catalog, value, onChange, disabled }) {
 	return /* @__PURE__ */ jsxs("div", {
 		className: "space-y-3",
 		children: [
-			families.length > 1 && /* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx("p", {
-				className: "text-[10px] uppercase tracking-wide text-foreground-subtle mb-1.5",
-				children: "Family"
-			}), /* @__PURE__ */ jsx("div", {
-				className: "flex flex-wrap gap-1.5",
-				children: families.map((f) => /* @__PURE__ */ jsx(Chip, {
-					active: f.family === family.family,
-					disabled,
-					onClick: () => onChange(f.tiers[0]?.baseModelId ?? ""),
-					children: f.label
-				}, f.family))
-			})] }),
+			families.length > 1 && /* @__PURE__ */ jsxs("div", { children: [
+				/* @__PURE__ */ jsx("p", {
+					className: "text-[10px] uppercase tracking-wide text-foreground-subtle mb-1.5",
+					children: "Family"
+				}),
+				/* @__PURE__ */ jsx("div", {
+					className: "flex flex-wrap gap-1.5",
+					children: families.map((f) => /* @__PURE__ */ jsx(Chip, {
+						active: f.family === family.family,
+						disabled,
+						...f.hint !== void 0 ? { title: f.hint } : {},
+						onClick: () => onChange(f.tiers[0]?.baseModelId ?? ""),
+						children: f.label
+					}, f.family))
+				}),
+				family.hint !== void 0 && /* @__PURE__ */ jsxs("p", {
+					className: "mt-1 text-[10px] text-foreground-subtle",
+					"data-testid": "model-family-hint",
+					children: [
+						family.label,
+						": ",
+						family.hint
+					]
+				})
+			] }),
 			family.tiers.length > 1 && /* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsxs("p", {
 				className: "text-[10px] uppercase tracking-wide text-foreground-subtle mb-1.5",
 				children: [family.label, " — size"]
@@ -28933,6 +28946,106 @@ function ModelPicker({ models, value, onChange, disabled, defaultModelId }) {
 	});
 }
 //#endregion
+//#region src/composites/model-bound-slider.tsx
+var SOURCE_LABEL = {
+	override: "Override for this model",
+	"model-default": "Model default",
+	"global-default": "Default — not tuned for this model"
+};
+function formatNumber(value, scale) {
+	return (scale !== void 0 ? value / scale : value).toFixed(2).replace(/\.?0+$/, "");
+}
+function ModelBoundSlider({ field, modelId, settings, disabled, onChangeSettings }) {
+	const modelDefault = field.modelApplicability?.defaultByModel?.[modelId];
+	const state = resolveModelBoundSetting(settings, field.key, modelId.length > 0 ? modelId : void 0, modelDefault, field.default);
+	const fallback = typeof field.default === "number" ? field.default : field.min ?? 0;
+	const current = typeof state.value === "number" ? state.value : fallback;
+	const scale = field.type === "slider" ? field.displayScale : void 0;
+	const unit = "unit" in field ? field.unit : void 0;
+	const stale = state.inapplicableOverride;
+	const hasStoredValue = settings?.[field.key] !== void 0;
+	const handleChange = (value) => {
+		onChangeSettings(modelId.length > 0 ? writeModelBoundSetting(settings, field.key, value, modelId) : {
+			...settings,
+			[field.key]: value
+		});
+	};
+	return /* @__PURE__ */ jsxs("div", { children: [
+		/* @__PURE__ */ jsxs("div", {
+			className: "flex items-center justify-between mb-1",
+			children: [/* @__PURE__ */ jsx("span", {
+				className: "text-[10px] font-medium text-foreground-subtle uppercase tracking-wide",
+				children: field.label
+			}), /* @__PURE__ */ jsxs("span", {
+				className: "text-xs font-medium text-foreground tabular-nums",
+				children: [formatNumber(current, scale), unit ? ` ${unit}` : ""]
+			})]
+		}),
+		field.description && /* @__PURE__ */ jsx("p", {
+			className: "text-[10px] text-foreground-subtle/60 mb-1.5",
+			children: field.description
+		}),
+		/* @__PURE__ */ jsx("input", {
+			type: "range",
+			min: field.min ?? 0,
+			max: field.max ?? 1,
+			step: field.step ?? .01,
+			value: current,
+			disabled: disabled || field.disabled,
+			onChange: (e) => handleChange(Number(e.target.value)),
+			className: "w-full accent-primary h-1.5"
+		}),
+		/* @__PURE__ */ jsxs("div", {
+			className: "mt-1 flex items-center justify-between gap-2 text-[10px]",
+			children: [/* @__PURE__ */ jsx("span", {
+				"data-testid": "model-bound-source",
+				className: state.source === "override" ? "text-primary font-medium" : "text-foreground-subtle",
+				children: SOURCE_LABEL[state.source]
+			}), hasStoredValue && /* @__PURE__ */ jsx("button", {
+				type: "button",
+				disabled,
+				className: "text-foreground-subtle hover:text-foreground disabled:opacity-50",
+				onClick: () => onChangeSettings(clearModelBoundSetting(settings, field.key)),
+				children: "Reset to model default"
+			})]
+		}),
+		stale !== void 0 && typeof stale.value === "number" && /* @__PURE__ */ jsxs("p", {
+			className: "mt-1 text-[10px] text-amber-400/90",
+			children: [
+				"The override ",
+				formatNumber(stale.value, scale),
+				" was set for ",
+				stale.modelId,
+				" and does not apply to this model."
+			]
+		})
+	] });
+}
+/** The keys of the model-bound fields of a schema, groups flattened. */
+function modelBoundKeysOf(fields) {
+	return fields.flatMap((field) => {
+		if (field.type === "group") return modelBoundKeysOf(field.fields);
+		return "key" in field && "bindsToModel" in field && field.bindsToModel === true ? [field.key] : [];
+	});
+}
+/**
+* "Reset thresholds to model defaults" — every model-bound override in force
+* for `modelId`, cleared in ONE settings change (one save). Rendered only when
+* there is something to reset. An override stored for another model is kept.
+*/
+function ResetModelDefaultsButton({ fields, modelId, settings, disabled, onReset }) {
+	const keys = modelBoundKeysOf(fields);
+	const model = modelId.length > 0 ? modelId : void 0;
+	if (keys.length === 0 || !hasModelBoundOverrides(settings, keys, model)) return null;
+	return /* @__PURE__ */ jsx("button", {
+		type: "button",
+		disabled,
+		className: "text-[10px] text-primary hover:underline disabled:opacity-50",
+		onClick: () => onReset(clearModelBoundOverrides(settings, keys, model)),
+		children: "Reset thresholds to model defaults"
+	});
+}
+//#endregion
 //#region src/composites/pipeline-step.tsx
 /**
 * PipelineStep — single step card in the pipeline builder.
@@ -29190,6 +29303,16 @@ function ConfigSchemaFieldControl({ field, allFields, step, disabled, modelScope
 			onChange: handleChange
 		});
 	}
+	if ((field.type === "slider" || field.type === "number") && field.bindsToModel === true) return /* @__PURE__ */ jsx(ModelBoundSlider, {
+		field,
+		modelId: step.modelId,
+		settings: step.settings,
+		disabled,
+		onChangeSettings: (settings) => onChange({
+			...step,
+			settings
+		})
+	});
 	if (field.type === "slider" || field.type === "number") {
 		const raw = step.settings?.[field.key];
 		const fallback = typeof field.default === "number" ? field.default : field.min ?? 0;
@@ -29376,6 +29499,7 @@ function supplyNotes(supply) {
 		if (supply.stepId === "package-detection") return [...notes, "The root model's own package boxes become the package result at this step's threshold; this step's zone-crop view is not used, so small parcels the full-frame model misses stay missed."];
 		return [...notes, "This step's class list decides which of the root's labels become the fine class; a switched-off class stays at its macro."];
 	}
+	if (supply.kind === "mask") return ["Masks come from the root model: each detection carries the root's own instance mask, so this step's model does not run. A root mask follows the model's mask grid (a quarter of its input), coarser than this step's own per-crop mask."];
 	if (supply.stepId === "face-detection") return ["Face boxes come from the root model. Each is re-found by this step's face detector in a square around it before recognition, so only a face it finds is recognised; a box with no face in it is dropped."];
 	return ["Plate boxes come from the root model and the plate reader reads them. The crop margin around a root plate box has not been measured for this model yet."];
 }
@@ -29447,7 +29571,19 @@ function ClusterSettingsHint({ addonId }) {
 		children: "Admission knobs for this step live in Pipeline → Cluster → Settings → Enrichment models. They apply to every camera — a per-device copy would fill the shared index from two policies."
 	});
 }
-function buildDisplayStep(addon, cfg) {
+/**
+* The model the step's settings are read and written for — what a model-bound
+* field (D738) binds to. While the ROOT supplies the step's fine label (D741),
+* that is the root model: the step's threshold then gates the root's label, on
+* the root's score scale. Otherwise the step's own model: its pin, else the
+* model the row really runs (`effectiveModelId` — the device's hardware-aware
+* default when unpinned), else the step's flat catalog default.
+*/
+function settingsModelIdFor(addon, cfg, effectiveModelId, rootModel) {
+	if (rootModel !== void 0 && rootSourceState(addon.id, cfg.settings, rootModel)?.effective) return rootModel.modelId;
+	return cfg.modelId ?? effectiveModelId ?? addon.defaultModelId;
+}
+function buildDisplayStep(addon, cfg, modelId) {
 	return {
 		addonId: addon.id,
 		addonName: addon.name,
@@ -29455,7 +29591,7 @@ function buildDisplayStep(addon, cfg) {
 		inputClasses: [...addon.inputClasses],
 		outputClasses: [...addon.outputClasses],
 		enabled: cfg.enabled,
-		modelId: cfg.modelId ?? addon.defaultModelId,
+		modelId,
 		children: [],
 		settings: { ...cfg.settings }
 	};
@@ -29520,13 +29656,21 @@ function AgentModeEditor({ addon, agentDefault, modelsForFormat, engineFormat, e
 			})] }),
 			localSchema.length > 0 && /* @__PURE__ */ jsxs("div", {
 				className: "pt-2 border-t border-border/50 space-y-3",
-				children: [/* @__PURE__ */ jsx("div", {
-					className: "text-[10px] uppercase tracking-widest text-foreground-subtle",
-					children: "Settings"
+				children: [/* @__PURE__ */ jsxs("div", {
+					className: "flex items-center justify-between",
+					children: [/* @__PURE__ */ jsx("div", {
+						className: "text-[10px] uppercase tracking-widest text-foreground-subtle",
+						children: "Settings"
+					}), /* @__PURE__ */ jsx(ResetModelDefaultsButton, {
+						fields: localSchema,
+						modelId: settingsModelIdFor(addon, agentDefault, effectiveModelId, rootModel),
+						settings: agentDefault.settings,
+						onReset: (settings) => update({ settings })
+					})]
 				}), localSchema.map((field) => /* @__PURE__ */ jsx(ConfigSchemaField, {
 					field,
 					allFields: localSchema,
-					step: buildDisplayStep(addon, agentDefault),
+					step: buildDisplayStep(addon, agentDefault, settingsModelIdFor(addon, agentDefault, effectiveModelId, rootModel)),
 					disabled: false,
 					onChange: (next) => update({ settings: { ...next.settings } })
 				}, field.key))]
@@ -29622,11 +29766,19 @@ function DeviceModeEditor({ addon, agentDefault, agentNodeId, currentPatch, mode
 							children: [/* @__PURE__ */ jsx("div", {
 								className: "text-[10px] uppercase tracking-widest text-foreground-subtle",
 								children: "Settings"
-							}), settingsOverridden ? /* @__PURE__ */ jsx("button", {
-								type: "button",
-								className: "text-[10px] text-foreground-subtle hover:text-foreground",
-								onClick: () => setSettings(void 0),
-								children: "Clear"
+							}), settingsOverridden ? /* @__PURE__ */ jsxs("div", {
+								className: "flex items-center gap-3",
+								children: [/* @__PURE__ */ jsx(ResetModelDefaultsButton, {
+									fields: localSchema,
+									modelId: settingsModelIdFor(addon, effective, inheritedModelId, rootModel),
+									settings: currentPatch?.settings,
+									onReset: (settings) => setSettings(settings)
+								}), /* @__PURE__ */ jsx("button", {
+									type: "button",
+									className: "text-[10px] text-foreground-subtle hover:text-foreground",
+									onClick: () => setSettings(void 0),
+									children: "Clear"
+								})]
 							}) : /* @__PURE__ */ jsx("button", {
 								type: "button",
 								className: "text-[10px] text-primary hover:underline",
@@ -29637,7 +29789,7 @@ function DeviceModeEditor({ addon, agentDefault, agentNodeId, currentPatch, mode
 						localSchema.map((field) => /* @__PURE__ */ jsx(ConfigSchemaField, {
 							field,
 							allFields: localSchema,
-							step: buildDisplayStep(addon, effective),
+							step: buildDisplayStep(addon, effective, settingsModelIdFor(addon, effective, inheritedModelId, rootModel)),
 							disabled: !settingsOverridden,
 							onChange: (next) => setSettings({ ...next.settings })
 						}, field.key)),

package/package.json

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