@camstack/addon-osd-manager 0.1.169 → 0.1.171

package/dist/index.js

@@ -10635,11 +10635,11 @@ var ModelVariantGroupSchema = object({
 	/** Quantization axis. Omit ⇒ the fp32 base build. */
 	precision: _enum(["fp32", "int8"]).optional(),
 	/**
-	* Speed-optimization axis. Omit ⇒ the standard build. `fast` marks a
-	* latency-optimized export (e.g. ReLU-activation variant) — the slot the
-	* future performance variants plug into.
+	* Training / latency-variant axis. Omit ⇒ the standard build. `test` marks
+	* an alternate training of the same family (Scrypted `relu_test`); chip
+	* label is "Test".
 	*/
-	optimization: _enum(["standard", "fast"]).optional(),
+	optimization: _enum(["standard", "test"]).optional(),
 	/**
 	* Input-resolution axis (square input side, px). Omit ⇒ the family's native
 	* resolution (640 for yolo26). Reduced-input builds (320 / 256) are a big,
@@ -10662,9 +10662,10 @@ var ModelProviderIdSchema = _enum([
 * are per upstream. A persisted custom-model row written when this field was a
 * string still parses — the string is lifted into `{ weights }`.
 *
-* Every licence surface (the admin "Models and licenses" page,
-* `THIRD_PARTY_MODELS.md`, the Hugging Face model table) is GENERATED from
-* these records by `scripts/gen-model-licenses.ts` (D661).
+* Every machine licence surface (`THIRD_PARTY_MODELS.md`, the Hugging Face
+* model table) is GENERATED from these records by
+* `scripts/gen-model-licenses.ts` (D661). Operator-facing docs live in
+* `camstack/docs` → `/docs/detection/models`.
 */
 var ModelLicenseSchema = preprocess((value) => typeof value === "string" ? { weights: value } : value, object({
 	/** SPDX id of the WEIGHTS' terms, a `LicenseRef-*` for non-SPDX terms, or `UNKNOWN`. */
@@ -19767,7 +19768,7 @@ var modelDistributorCapability = {
 	mode: "singleton",
 	internal: true,
 	methods: { distributeModel: method(object({
-		nodeId: string(),
+		targetNodeId: string(),
 		modelId: string(),
 		format: _enum(MODEL_FORMATS),
 		entry: ModelCatalogEntrySchema
@@ -24562,39 +24563,19 @@ Object.freeze(Object.fromEntries([{
 	label: "Face recognition model",
 	defaultModelId: "auraface-r100",
 	indexName: "the enrolled face gallery",
-	options: [
-		{
-			id: "auraface-r100",
-			label: "AuraFace R100"
-		},
-		{
-			id: "arcface-r100",
-			label: "ArcFace (ResNet34)"
-		},
-		{
-			id: "inception-resnet-v1",
-			label: "Inception ResNet V1"
-		}
-	]
+	options: [{
+		id: "auraface-r100",
+		label: "AuraFace R100"
+	}]
 }, {
 	stepId: "clip-embedding",
 	label: "Semantic search model",
-	defaultModelId: "mobileclip-s1",
+	defaultModelId: "siglip2-b16-224",
 	indexName: "the object semantic-search index",
-	options: [
-		{
-			id: "mobileclip-s1",
-			label: "MobileCLIP S1"
-		},
-		{
-			id: "mobileclip-s2",
-			label: "MobileCLIP S2"
-		},
-		{
-			id: "siglip2-b16-224",
-			label: "SigLIP2 B/16 (Apache-2.0)"
-		}
-	]
+	options: [{
+		id: "siglip2-b16-224",
+		label: "SigLIP2 B/16 (Apache-2.0)"
+	}]
 }].map((s) => [s.stepId, s.defaultModelId])));
 var CLUSTER_STEP_SETTING_FIELDS = [{
 	stepId: "face-embedding",
@@ -39768,7 +39749,13 @@ var OsdStatusSchema = object({ overlays: array(object({
 	*/
 	availablePositions: array(OsdPositionEnum).readonly(),
 	/** Firmware does not allow editing the `text` field (e.g. timestamp). */
-	readOnly: boolean().optional()
+	readOnly: boolean().optional(),
+	/**
+	* Firmware text ceiling for this overlay. Absent = no known limit.
+	* The OSD manager truncates here on every write — never stores its own
+	* copy on the binding.
+	*/
+	maxCharacters: number().int().positive().optional()
 })).readonly() });
 var OsdOverlayPatchSchema = object({
 	enabled: boolean().optional(),
@@ -39865,7 +39852,9 @@ var OsdTemplateBindingSchema = object({
 	valuePath: string().min(1).max(64),
 	/** Convert TO this unit at render (`tryConvertUnit`). Absent = source unit. */
 	displayUnit: string().max(16).optional(),
-	maxDecimals: number().int().min(0).max(4).default(1)
+	maxDecimals: number().int().min(0).max(4).default(1),
+	/** Raw value → display text (same shape as slot binding). Empty string hides. */
+	valueMap: record(string(), string()).optional()
 });
 /**
 * A named template: bindings (alias → leaf field) + a parser that
@@ -39915,18 +39904,11 @@ var OsdSlotBindingSchema = object({
 	source: OsdSourceSchema,
 	/** `${value}` and `${unit}` are substituted; every occurrence. */
 	template: string().max(96).default("${value}"),
-	/** Truncate with an ellipsis past this length. Absent = no limit. */
-	maxCharacters: number().int().min(4).max(64).optional(),
 	/**
 	* Decimal places for a numeric value. `0` yields an integer — the
 	* documented workaround for firmwares that reject `.` in overlay text.
 	*/
 	maxDecimals: number().int().min(0).max(4).default(1),
-	/**
-	* Appended via `${unit}` when no unit conversion produces a label.
-	* Prefer `source.displayUnit` for converted device-state values.
-	*/
-	unitLabel: string().max(8).optional(),
 	/** Raw value → display text, e.g. `{"true":"MOTION","false":""}`. */
 	valueMap: record(string(), string()).optional(),
 	/** Time windows in which the slot is shown. Absent = always. */
@@ -39935,9 +39917,7 @@ var OsdSlotBindingSchema = object({
 	* Display gate, in the notification centre's condition vocabulary.
 	* Only the keys reported by `getConditionSupport` are accepted.
 	*/
-	conditions: NcConditionsSchema.optional(),
-	/** Rendered when the gate is closed or the value unreadable. Empty = hide. */
-	fallbackText: string().max(64).default("")
+	conditions: NcConditionsSchema.optional()
 });
 /** One camera slot, as the operator sees it: firmware truth + our binding. */
 var OsdSlotViewSchema = object({
@@ -58194,6 +58174,8 @@ var STATE_SUMMARY_VARS = [
 	[...RULE_TEXT],
 	[...RULE_TEXT],
 	[...RULE_TEXT],
+	[...RULE_TEXT],
+	[...RULE_TEXT],
 	...STATE_SUMMARY_VARS
 ];
 new Set([
@@ -58986,8 +58968,8 @@ function applyTemplate(template, value, unit) {
 /** The whole formatting chain: raw value → the text to burn into the slot. */
 function formatSlotText(raw, binding, options = {}) {
 	const value = displayValue(options.displayRaw ?? raw, binding);
-	const unit = options.unit ?? binding.unitLabel ?? "";
-	return limitText(applyTemplate(binding.template, value, unit).trim(), binding.maxCharacters);
+	const unit = options.unit ?? "";
+	return limitText(applyTemplate(binding.template, value, unit).trim(), options.maxCharacters);
 }
 //#endregion
 //#region src/state-leaves.ts
@@ -59252,6 +59234,12 @@ function resolveBindingLive(binding, facts) {
 	if (slice === void 0) return { reason: `device ${deviceId} publishes no "${binding.capName}" state` };
 	const raw = readStatePath(slice, binding.valuePath);
 	if (raw === void 0) return { reason: `"${binding.capName}.${binding.valuePath}" is absent on device ${deviceId}` };
+	const mapped = binding.valueMap?.[String(raw)];
+	if (mapped !== void 0) return {
+		value: mapped,
+		unit: "",
+		formatted: applyTemplateTokenKind(mapped, "", "full")
+	};
 	let value;
 	let unit = "";
 	if (typeof raw === "number") {
@@ -59324,7 +59312,7 @@ function resolveSource(binding, cameraDeviceId, facts) {
 		return { value: {
 			raw,
 			displayRaw: converted.value,
-			unit: converted.unit || binding.unitLabel
+			...converted.unit !== void 0 && converted.unit !== "" ? { unit: converted.unit } : {}
 		} };
 	}
 	return { value: { raw } };
@@ -59335,7 +59323,7 @@ function resolveSource(binding, cameraDeviceId, facts) {
 * write — a slot rewritten every tick is one firmware round-trip per tick
 * per slot, for a string that did not move.
 */
-function renderSlot(slotId, binding, cameraDeviceId, facts, previousText) {
+function renderSlot(slotId, binding, cameraDeviceId, facts, previousText, maxCharacters) {
 	if (binding === null) return {
 		slotId,
 		outcome: "unbound",
@@ -59348,7 +59336,6 @@ function renderSlot(slotId, binding, cameraDeviceId, facts, previousText) {
 		text: "",
 		reason: "binding is switched off"
 	};
-	const fallback = limitText(binding.fallbackText, binding.maxCharacters);
 	const gate = evaluateGate({
 		cameraDeviceId,
 		atMs: facts.atMs,
@@ -59356,14 +59343,14 @@ function renderSlot(slotId, binding, cameraDeviceId, facts, previousText) {
 		conditions: binding.conditions,
 		deviceState: facts.deviceState
 	});
-	if (!gate.open) return settle(slotId, fallback, previousText, "gated", `condition "${gate.failedCondition}"`);
+	if (!gate.open) return settle(slotId, "", previousText, "gated", `condition "${gate.failedCondition}"`);
 	const resolved = resolveSource(binding, cameraDeviceId, facts);
-	if ("reason" in resolved) return settle(slotId, fallback, previousText, "unreadable", resolved.reason);
-	if (resolved.value.preformatted !== void 0 && binding.source.kind === "template") return settle(slotId, limitText(resolved.value.preformatted.trim(), binding.maxCharacters), previousText, "written");
-	const unit = resolved.value.unit ?? binding.unitLabel;
+	if ("reason" in resolved) return settle(slotId, "", previousText, "unreadable", resolved.reason);
+	if (resolved.value.preformatted !== void 0 && binding.source.kind === "template") return settle(slotId, limitText(resolved.value.preformatted.trim(), maxCharacters), previousText, "written");
 	return settle(slotId, formatSlotText(resolved.value.raw, binding, {
 		...resolved.value.displayRaw !== void 0 ? { displayRaw: resolved.value.displayRaw } : {},
-		...unit !== void 0 ? { unit } : {}
+		...resolved.value.unit !== void 0 ? { unit: resolved.value.unit } : {},
+		...maxCharacters !== void 0 ? { maxCharacters } : {}
 	}), previousText, "written");
 }
 function settle(slotId, text, previousText, outcome, reason) {
@@ -59882,7 +59869,7 @@ var OsdManager = class {
 	previewSlot = async ({ deviceId, slotId, binding }) => {
 		if (binding !== void 0) assertSupportedConditions(binding.conditions);
 		const effective = binding ?? (await this.readBindings(deviceId))[slotId] ?? null;
-		return renderSlot(slotId, effective, deviceId, await this.collectFacts(deviceId, effective === null ? {} : { [slotId]: effective }), void 0);
+		return renderSlot(slotId, effective, deviceId, await this.collectFacts(deviceId, effective === null ? {} : { [slotId]: effective }), void 0, await this.maxCharactersForSlot(deviceId, slotId));
 	};
 	renderDevice = async ({ deviceId }) => {
 		return { results: [...await this.renderDeviceInternal(deviceId, null)] };
@@ -59917,17 +59904,24 @@ var OsdManager = class {
 			});
 		}
 	}
+	/** Firmware text ceiling for one overlay, from the live `osd` status. */
+	async maxCharactersForSlot(deviceId, slotId) {
+		return (await this.deps.readOsdStatus(deviceId))?.overlays.find((o) => o.id === slotId)?.maxCharacters;
+	}
 	/** Render (and write) `onlySlots`, or every bound slot when `null`. */
 	async renderDeviceInternal(deviceId, onlySlots) {
 		const bindings = await this.readBindings(deviceId);
 		const slotIds = onlySlots ?? Object.keys(bindings);
 		if (slotIds.length === 0) return [];
 		const facts = await this.collectFacts(deviceId, bindings);
+		const status = await this.deps.readOsdStatus(deviceId);
+		const maxBySlot = /* @__PURE__ */ new Map();
+		for (const overlay of status?.overlays ?? []) if (overlay.maxCharacters !== void 0) maxBySlot.set(overlay.id, overlay.maxCharacters);
 		const results = [];
 		for (const slotId of slotIds) {
 			const binding = bindings[slotId] ?? null;
 			const key = cacheKey(deviceId, slotId);
-			const result = renderSlot(slotId, binding, deviceId, facts, this.lastWritten.get(key));
+			const result = renderSlot(slotId, binding, deviceId, facts, this.lastWritten.get(key), maxBySlot.get(slotId));
 			results.push(result);
 			if (result.outcome === "unchanged") continue;
 			if (result.outcome === "unbound" || result.outcome === "disabled") continue;

package/dist/index.mjs

@@ -10631,11 +10631,11 @@ var ModelVariantGroupSchema = object({
 	/** Quantization axis. Omit ⇒ the fp32 base build. */
 	precision: _enum(["fp32", "int8"]).optional(),
 	/**
-	* Speed-optimization axis. Omit ⇒ the standard build. `fast` marks a
-	* latency-optimized export (e.g. ReLU-activation variant) — the slot the
-	* future performance variants plug into.
+	* Training / latency-variant axis. Omit ⇒ the standard build. `test` marks
+	* an alternate training of the same family (Scrypted `relu_test`); chip
+	* label is "Test".
 	*/
-	optimization: _enum(["standard", "fast"]).optional(),
+	optimization: _enum(["standard", "test"]).optional(),
 	/**
 	* Input-resolution axis (square input side, px). Omit ⇒ the family's native
 	* resolution (640 for yolo26). Reduced-input builds (320 / 256) are a big,
@@ -10658,9 +10658,10 @@ var ModelProviderIdSchema = _enum([
 * are per upstream. A persisted custom-model row written when this field was a
 * string still parses — the string is lifted into `{ weights }`.
 *
-* Every licence surface (the admin "Models and licenses" page,
-* `THIRD_PARTY_MODELS.md`, the Hugging Face model table) is GENERATED from
-* these records by `scripts/gen-model-licenses.ts` (D661).
+* Every machine licence surface (`THIRD_PARTY_MODELS.md`, the Hugging Face
+* model table) is GENERATED from these records by
+* `scripts/gen-model-licenses.ts` (D661). Operator-facing docs live in
+* `camstack/docs` → `/docs/detection/models`.
 */
 var ModelLicenseSchema = preprocess((value) => typeof value === "string" ? { weights: value } : value, object({
 	/** SPDX id of the WEIGHTS' terms, a `LicenseRef-*` for non-SPDX terms, or `UNKNOWN`. */
@@ -19763,7 +19764,7 @@ var modelDistributorCapability = {
 	mode: "singleton",
 	internal: true,
 	methods: { distributeModel: method(object({
-		nodeId: string(),
+		targetNodeId: string(),
 		modelId: string(),
 		format: _enum(MODEL_FORMATS),
 		entry: ModelCatalogEntrySchema
@@ -24558,39 +24559,19 @@ Object.freeze(Object.fromEntries([{
 	label: "Face recognition model",
 	defaultModelId: "auraface-r100",
 	indexName: "the enrolled face gallery",
-	options: [
-		{
-			id: "auraface-r100",
-			label: "AuraFace R100"
-		},
-		{
-			id: "arcface-r100",
-			label: "ArcFace (ResNet34)"
-		},
-		{
-			id: "inception-resnet-v1",
-			label: "Inception ResNet V1"
-		}
-	]
+	options: [{
+		id: "auraface-r100",
+		label: "AuraFace R100"
+	}]
 }, {
 	stepId: "clip-embedding",
 	label: "Semantic search model",
-	defaultModelId: "mobileclip-s1",
+	defaultModelId: "siglip2-b16-224",
 	indexName: "the object semantic-search index",
-	options: [
-		{
-			id: "mobileclip-s1",
-			label: "MobileCLIP S1"
-		},
-		{
-			id: "mobileclip-s2",
-			label: "MobileCLIP S2"
-		},
-		{
-			id: "siglip2-b16-224",
-			label: "SigLIP2 B/16 (Apache-2.0)"
-		}
-	]
+	options: [{
+		id: "siglip2-b16-224",
+		label: "SigLIP2 B/16 (Apache-2.0)"
+	}]
 }].map((s) => [s.stepId, s.defaultModelId])));
 var CLUSTER_STEP_SETTING_FIELDS = [{
 	stepId: "face-embedding",
@@ -39764,7 +39745,13 @@ var OsdStatusSchema = object({ overlays: array(object({
 	*/
 	availablePositions: array(OsdPositionEnum).readonly(),
 	/** Firmware does not allow editing the `text` field (e.g. timestamp). */
-	readOnly: boolean().optional()
+	readOnly: boolean().optional(),
+	/**
+	* Firmware text ceiling for this overlay. Absent = no known limit.
+	* The OSD manager truncates here on every write — never stores its own
+	* copy on the binding.
+	*/
+	maxCharacters: number().int().positive().optional()
 })).readonly() });
 var OsdOverlayPatchSchema = object({
 	enabled: boolean().optional(),
@@ -39861,7 +39848,9 @@ var OsdTemplateBindingSchema = object({
 	valuePath: string().min(1).max(64),
 	/** Convert TO this unit at render (`tryConvertUnit`). Absent = source unit. */
 	displayUnit: string().max(16).optional(),
-	maxDecimals: number().int().min(0).max(4).default(1)
+	maxDecimals: number().int().min(0).max(4).default(1),
+	/** Raw value → display text (same shape as slot binding). Empty string hides. */
+	valueMap: record(string(), string()).optional()
 });
 /**
 * A named template: bindings (alias → leaf field) + a parser that
@@ -39911,18 +39900,11 @@ var OsdSlotBindingSchema = object({
 	source: OsdSourceSchema,
 	/** `${value}` and `${unit}` are substituted; every occurrence. */
 	template: string().max(96).default("${value}"),
-	/** Truncate with an ellipsis past this length. Absent = no limit. */
-	maxCharacters: number().int().min(4).max(64).optional(),
 	/**
 	* Decimal places for a numeric value. `0` yields an integer — the
 	* documented workaround for firmwares that reject `.` in overlay text.
 	*/
 	maxDecimals: number().int().min(0).max(4).default(1),
-	/**
-	* Appended via `${unit}` when no unit conversion produces a label.
-	* Prefer `source.displayUnit` for converted device-state values.
-	*/
-	unitLabel: string().max(8).optional(),
 	/** Raw value → display text, e.g. `{"true":"MOTION","false":""}`. */
 	valueMap: record(string(), string()).optional(),
 	/** Time windows in which the slot is shown. Absent = always. */
@@ -39931,9 +39913,7 @@ var OsdSlotBindingSchema = object({
 	* Display gate, in the notification centre's condition vocabulary.
 	* Only the keys reported by `getConditionSupport` are accepted.
 	*/
-	conditions: NcConditionsSchema.optional(),
-	/** Rendered when the gate is closed or the value unreadable. Empty = hide. */
-	fallbackText: string().max(64).default("")
+	conditions: NcConditionsSchema.optional()
 });
 /** One camera slot, as the operator sees it: firmware truth + our binding. */
 var OsdSlotViewSchema = object({
@@ -58190,6 +58170,8 @@ var STATE_SUMMARY_VARS = [
 	[...RULE_TEXT],
 	[...RULE_TEXT],
 	[...RULE_TEXT],
+	[...RULE_TEXT],
+	[...RULE_TEXT],
 	...STATE_SUMMARY_VARS
 ];
 new Set([
@@ -58982,8 +58964,8 @@ function applyTemplate(template, value, unit) {
 /** The whole formatting chain: raw value → the text to burn into the slot. */
 function formatSlotText(raw, binding, options = {}) {
 	const value = displayValue(options.displayRaw ?? raw, binding);
-	const unit = options.unit ?? binding.unitLabel ?? "";
-	return limitText(applyTemplate(binding.template, value, unit).trim(), binding.maxCharacters);
+	const unit = options.unit ?? "";
+	return limitText(applyTemplate(binding.template, value, unit).trim(), options.maxCharacters);
 }
 //#endregion
 //#region src/state-leaves.ts
@@ -59248,6 +59230,12 @@ function resolveBindingLive(binding, facts) {
 	if (slice === void 0) return { reason: `device ${deviceId} publishes no "${binding.capName}" state` };
 	const raw = readStatePath(slice, binding.valuePath);
 	if (raw === void 0) return { reason: `"${binding.capName}.${binding.valuePath}" is absent on device ${deviceId}` };
+	const mapped = binding.valueMap?.[String(raw)];
+	if (mapped !== void 0) return {
+		value: mapped,
+		unit: "",
+		formatted: applyTemplateTokenKind(mapped, "", "full")
+	};
 	let value;
 	let unit = "";
 	if (typeof raw === "number") {
@@ -59320,7 +59308,7 @@ function resolveSource(binding, cameraDeviceId, facts) {
 		return { value: {
 			raw,
 			displayRaw: converted.value,
-			unit: converted.unit || binding.unitLabel
+			...converted.unit !== void 0 && converted.unit !== "" ? { unit: converted.unit } : {}
 		} };
 	}
 	return { value: { raw } };
@@ -59331,7 +59319,7 @@ function resolveSource(binding, cameraDeviceId, facts) {
 * write — a slot rewritten every tick is one firmware round-trip per tick
 * per slot, for a string that did not move.
 */
-function renderSlot(slotId, binding, cameraDeviceId, facts, previousText) {
+function renderSlot(slotId, binding, cameraDeviceId, facts, previousText, maxCharacters) {
 	if (binding === null) return {
 		slotId,
 		outcome: "unbound",
@@ -59344,7 +59332,6 @@ function renderSlot(slotId, binding, cameraDeviceId, facts, previousText) {
 		text: "",
 		reason: "binding is switched off"
 	};
-	const fallback = limitText(binding.fallbackText, binding.maxCharacters);
 	const gate = evaluateGate({
 		cameraDeviceId,
 		atMs: facts.atMs,
@@ -59352,14 +59339,14 @@ function renderSlot(slotId, binding, cameraDeviceId, facts, previousText) {
 		conditions: binding.conditions,
 		deviceState: facts.deviceState
 	});
-	if (!gate.open) return settle(slotId, fallback, previousText, "gated", `condition "${gate.failedCondition}"`);
+	if (!gate.open) return settle(slotId, "", previousText, "gated", `condition "${gate.failedCondition}"`);
 	const resolved = resolveSource(binding, cameraDeviceId, facts);
-	if ("reason" in resolved) return settle(slotId, fallback, previousText, "unreadable", resolved.reason);
-	if (resolved.value.preformatted !== void 0 && binding.source.kind === "template") return settle(slotId, limitText(resolved.value.preformatted.trim(), binding.maxCharacters), previousText, "written");
-	const unit = resolved.value.unit ?? binding.unitLabel;
+	if ("reason" in resolved) return settle(slotId, "", previousText, "unreadable", resolved.reason);
+	if (resolved.value.preformatted !== void 0 && binding.source.kind === "template") return settle(slotId, limitText(resolved.value.preformatted.trim(), maxCharacters), previousText, "written");
 	return settle(slotId, formatSlotText(resolved.value.raw, binding, {
 		...resolved.value.displayRaw !== void 0 ? { displayRaw: resolved.value.displayRaw } : {},
-		...unit !== void 0 ? { unit } : {}
+		...resolved.value.unit !== void 0 ? { unit: resolved.value.unit } : {},
+		...maxCharacters !== void 0 ? { maxCharacters } : {}
 	}), previousText, "written");
 }
 function settle(slotId, text, previousText, outcome, reason) {
@@ -59878,7 +59865,7 @@ var OsdManager = class {
 	previewSlot = async ({ deviceId, slotId, binding }) => {
 		if (binding !== void 0) assertSupportedConditions(binding.conditions);
 		const effective = binding ?? (await this.readBindings(deviceId))[slotId] ?? null;
-		return renderSlot(slotId, effective, deviceId, await this.collectFacts(deviceId, effective === null ? {} : { [slotId]: effective }), void 0);
+		return renderSlot(slotId, effective, deviceId, await this.collectFacts(deviceId, effective === null ? {} : { [slotId]: effective }), void 0, await this.maxCharactersForSlot(deviceId, slotId));
 	};
 	renderDevice = async ({ deviceId }) => {
 		return { results: [...await this.renderDeviceInternal(deviceId, null)] };
@@ -59913,17 +59900,24 @@ var OsdManager = class {
 			});
 		}
 	}
+	/** Firmware text ceiling for one overlay, from the live `osd` status. */
+	async maxCharactersForSlot(deviceId, slotId) {
+		return (await this.deps.readOsdStatus(deviceId))?.overlays.find((o) => o.id === slotId)?.maxCharacters;
+	}
 	/** Render (and write) `onlySlots`, or every bound slot when `null`. */
 	async renderDeviceInternal(deviceId, onlySlots) {
 		const bindings = await this.readBindings(deviceId);
 		const slotIds = onlySlots ?? Object.keys(bindings);
 		if (slotIds.length === 0) return [];
 		const facts = await this.collectFacts(deviceId, bindings);
+		const status = await this.deps.readOsdStatus(deviceId);
+		const maxBySlot = /* @__PURE__ */ new Map();
+		for (const overlay of status?.overlays ?? []) if (overlay.maxCharacters !== void 0) maxBySlot.set(overlay.id, overlay.maxCharacters);
 		const results = [];
 		for (const slotId of slotIds) {
 			const binding = bindings[slotId] ?? null;
 			const key = cacheKey(deviceId, slotId);
-			const result = renderSlot(slotId, binding, deviceId, facts, this.lastWritten.get(key));
+			const result = renderSlot(slotId, binding, deviceId, facts, this.lastWritten.get(key), maxBySlot.get(slotId));
 			results.push(result);
 			if (result.outcome === "unchanged") continue;
 			if (result.outcome === "unbound" || result.outcome === "disabled") continue;

package/dist/{player-overlays-DBi0aH1E.mjs → player-overlays-Bwe6_9ow.mjs}

@@ -1,5 +1,5 @@
 import { b as e, g as t, l as n, u as r } from "./_virtual_mf___mfe_internal__addon_osd_manager_page__loadShare__react__loadShare__.js-C5jUMd7X.mjs";
-import { c as i, s as a } from "./responsive-BoQdxzOM.mjs";
+import { c as i, s as a } from "./responsive-eWIsQGEg.mjs";
 import { n as o, r as s, t as c } from "./_virtual_mf___mfe_internal__addon_osd_manager_page__loadShare__react_mf_1_jsx_mf_2_runtime__loadShare__.js-DalfdIDw.mjs";
 var l = i("chevron-down", [["path", {
 	d: "m6 9 6 6 6-6",

package/dist/remoteEntry.js

@@ -1,2 +1,2 @@
-import { n as e, t } from "./virtual_mf-REMOTE_ENTRY_ID___mfe_internal__addon_osd_manager_page__remoteEntry_js-T0PnCKpV.mjs";
+import { n as e, t } from "./virtual_mf-REMOTE_ENTRY_ID___mfe_internal__addon_osd_manager_page__remoteEntry_js-D-Cxu36Z.mjs";
 export { t as get, e as init };

package/dist/{responsive-BoQdxzOM.mjs → responsive-eWIsQGEg.mjs}

@@ -1,6 +1,6 @@
 import { _ as e, b as t, c as n, g as r, l as i, m as a, n as o, r as s, t as c, u as l } from "./_virtual_mf___mfe_internal__addon_osd_manager_page__loadShare__react__loadShare__.js-C5jUMd7X.mjs";
 import "./_virtual_mf___mfe_internal__addon_osd_manager_page__loadShare__react_mf_1_jsx_mf_2_runtime__loadShare__.js-DalfdIDw.mjs";
-import { i as u } from "./_virtual_mf___mfe_internal__addon_osd_manager_page__loadShare___mf_0_camstack_mf_1_types__loadShare__.js-B4GSezZ1.mjs";
+import { i as u } from "./_virtual_mf___mfe_internal__addon_osd_manager_page__loadShare___mf_0_camstack_mf_1_types__loadShare__.js-Bszex2Bz.mjs";
 //#region ../../node_modules/lucide-react/dist/esm/shared/src/utils/mergeClasses.js
 t();
 var d = (...e) => e.filter((e, t, n) => !!e && e.trim() !== "" && n.indexOf(e) === t).join(" ").trim(), f = (e) => e.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase(), p = (e) => e.replace(/^([A-Z])|[\s-_]+(\w)/g, (e, t, n) => n ? n.toUpperCase() : t.toLowerCase()), m = (e) => {

package/dist/{scene-monitor-copy-CwfDunLo.mjs → scene-monitor-copy-BDpWrVsR.mjs}

@@ -1,5 +1,5 @@
 import { b as e, c as t, g as n, m as r } from "./_virtual_mf___mfe_internal__addon_osd_manager_page__loadShare__react__loadShare__.js-C5jUMd7X.mjs";
-import { c as i } from "./responsive-BoQdxzOM.mjs";
+import { c as i } from "./responsive-eWIsQGEg.mjs";
 var a = i("camera", [["path", {
 	d: "M13.997 4a2 2 0 0 1 1.76 1.05l.486.9A2 2 0 0 0 18.003 7H20a2 2 0 0 1 2 2v9a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V9a2 2 0 0 1 2-2h1.997a2 2 0 0 0 1.759-1.048l.489-.904A2 2 0 0 1 10.004 4z",
 	key: "18u6gg"

package/dist/{square-C-adTToZ.mjs → square-CzU7Lokp.mjs}

@@ -1,4 +1,4 @@
-import { c as e } from "./responsive-BoQdxzOM.mjs";
+import { c as e } from "./responsive-eWIsQGEg.mjs";
 var t = e("eye-off", [
 	["path", {
 		d: "M10.733 5.076a10.744 10.744 0 0 1 11.205 6.575 1 1 0 0 1 0 .696 10.747 10.747 0 0 1-1.444 2.49",

package/dist/{trash-2-DJjBuL5Q.mjs → trash-2-DLk6p3tf.mjs}

@@ -1,4 +1,4 @@
-import { c as e } from "./responsive-BoQdxzOM.mjs";
+import { c as e } from "./responsive-eWIsQGEg.mjs";
 var t = e("trash-2", [
 	["path", {
 		d: "M10 11v6",

package/dist/{virtual_mf-REMOTE_ENTRY_ID___mfe_internal__addon_osd_manager_page__remoteEntry_js-T0PnCKpV.mjs → virtual_mf-REMOTE_ENTRY_ID___mfe_internal__addon_osd_manager_page__remoteEntry_js-D-Cxu36Z.mjs}

@@ -2753,7 +2753,7 @@ async function rr(e) {
 	}
 }
 async function ir() {
-	return tr ||= rr(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_osd_manager_page-CW_hXAxF.mjs")).catch((e) => {
+	return tr ||= rr(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_osd_manager_page-Cf3xN1-E.mjs")).catch((e) => {
 		throw tr = void 0, e;
 	}), tr;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-osd-manager",
-  "version": "0.1.169",
+  "version": "0.1.171",
   "description": "Binds camera on-screen-display slots to live state and recognitions",
   "keywords": [
     "camstack",