@camstack/types 1.2.446 → 1.2.448

package/dist/index.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-UXDHn-oJ.js");
+const require_sleep = require("./sleep-BSPhInRm.js");
 const require_event_category = require("./event-category-E17zaHjN.js");
 const require_composition = require("./composition-CO6Sak-s.js");
 const require_node_color = require("./node-color.js");
@@ -8060,6 +8060,791 @@ var ExpressionSourceSchema = zod.z.object({
 	});
 });
 //#endregion
+//#region src/device/schema-fields.ts
+/** Unwrap ZodNullable / ZodOptional / ZodDefault wrappers to reach the inner type.
+*  Zod v4 exposes `.unwrap()` on all three wrapper classes. */
+function unwrapSchema(schema) {
+	let s = schema;
+	while (s instanceof zod.z.ZodNullable || s instanceof zod.z.ZodOptional || s instanceof zod.z.ZodDefault) s = s.unwrap();
+	return s;
+}
+function isMetaBag(value) {
+	return typeof value === "object" && value !== null;
+}
+function metaQuantity(schema) {
+	const bag = zod.z.globalRegistry.get(schema);
+	if (isMetaBag(bag) && require_sleep.isReadingQuantity(bag.quantity)) return bag.quantity;
+}
+/** Quantity declared with `readingMeta` on the field or on the unwrapped leaf. */
+function quantityOfField(schema) {
+	return metaQuantity(schema) ?? metaQuantity(unwrapSchema(schema));
+}
+function leafKind(schema) {
+	const s = unwrapSchema(schema);
+	if (s instanceof zod.z.ZodEnum) return {
+		kind: "enum",
+		enumValues: s.options
+	};
+	if (s instanceof zod.z.ZodNumber) return { kind: "number" };
+	if (s instanceof zod.z.ZodString) return { kind: "string" };
+	if (s instanceof zod.z.ZodBoolean) return { kind: "boolean" };
+	return null;
+}
+/** Walk a cap status schema into flat wireable leaf fields (dotted paths).
+*  Recurses into nested ZodObject (unwrapping nullable/optional/default first),
+*  so fields with null live values are still offered. Arrays / unknown shapes
+*  are skipped — never throws. */
+function enumerateSchemaFields(schema, prefix = "") {
+	const root = unwrapSchema(schema);
+	if (!(root instanceof zod.z.ZodObject)) return [];
+	const out = [];
+	const shape = root.shape;
+	for (const [key, field] of Object.entries(shape)) {
+		const path = prefix ? `${prefix}.${key}` : key;
+		const inner = unwrapSchema(field);
+		if (inner instanceof zod.z.ZodObject) {
+			out.push(...enumerateSchemaFields(inner, path));
+			continue;
+		}
+		const leaf = leafKind(field);
+		if (leaf) {
+			const quantity = quantityOfField(field);
+			out.push({
+				path,
+				kind: leaf.kind,
+				...leaf.enumValues ? { enumValues: leaf.enumValues } : {},
+				...quantity !== void 0 ? { quantity } : {}
+			});
+		}
+	}
+	return out;
+}
+/** Enumerate the per-item wireable fields of an item-array cap (see
+*  `CapabilityStatusItemArray`): the item schema's leaf fields, minus the
+*  `keyField` (the key comes from the link's `itemKey`, never from a wired
+*  source), each tagged `item: true` so the authoring UI collects an
+*  `itemKey` alongside the field. Never throws. */
+function enumerateItemArrayFields(itemArray) {
+	return enumerateSchemaFields(itemArray.itemSchema).filter((f) => f.path !== itemArray.keyField).map((f) => ({
+		...f,
+		item: true
+	}));
+}
+//#endregion
+//#region src/device/source-info.ts
+/**
+* Identity envelope for a device's upstream-system metadata.
+*
+* Two jobs:
+*
+*   1. **Dispatch key.** `id` is the natural identifier the SOURCE system
+*      uses to address this device (HA `entity_id`, Reolink MAC, ONVIF
+*      WS-Discovery endpoint UUID, …). Provider code keeps a
+*      `Map<sourceInfo.id, IDevice>` to route inbound push events in O(1)
+*      without round-tripping through `stableId` / `id` mappings.
+*
+*   2. **Stability bridge.** `uniqueId` is the *immutable* upstream id when
+*      one exists (HA `entity.unique_id`, Reolink MAC again — same as `id`
+*      for vendors where MAC is the natural key). For systems where the
+*      live dispatch key can be renamed (HA `entity_id` can be edited),
+*      providers detect renames by matching `uniqueId` and patch `id`
+*      in-place so dispatch keeps working.
+*
+* **Display unit and precision are NOT stored here.** They are a read-time
+* preference (D944). A polymorphic reading stores its `quantity` here once,
+* at adopt, and a date/time value stores `dateTimeShape` the same way —
+* neither is repeated on each sample. The `device_class` tag is an
+* HA-specific input consumed at the discovery boundary (`ha-domain-mapping`)
+* to derive the CamStack `DeviceRole`; it is never stored after that point.
+*
+* The `raw` escape hatch carries provider-specific attributes that don't
+* fit the structured slots (HA `attributes` whitelist, Reolink `deviceCache`
+* details, …). Providers control what lands here.
+*/
+var SourceInfoSchema = zod.z.object({
+	/** Live dispatch key — mutable when the source system allows rename. */
+	id: zod.z.string(),
+	/** Source system tag — e.g. 'homeassistant' | 'reolink' | 'onvif'. */
+	system: zod.z.string(),
+	/** Immutable upstream identifier when available (HA `unique_id`, … ).
+	*  Used to detect rename when `id` changes. */
+	uniqueId: zod.z.string().optional(),
+	/** Quantity of a polymorphic reading, written once at adopt (D944). */
+	quantity: require_sleep.ReadingQuantitySchema.optional(),
+	/** Date / time / datetime shape of a string reading, written once at adopt. */
+	dateTimeShape: zod.z.enum([
+		"date",
+		"time",
+		"datetime"
+	]).optional(),
+	/** Provider-specific extras that don't fit the structured slots.
+	*  Whitelist what goes here per provider — do NOT dump entire HA
+	*  attribute blobs (would explode the meta JSON column). */
+	raw: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
+});
+/**
+* Build the synthetic SourceInfo every existing provider falls back to
+* when no upstream value has been persisted. Keeps non-migrated providers
+* (Reolink / Hikvision / ONVIF / RTSP) functional without code
+* changes — `id` reuses the CamStack stableId, `system` reuses the addon
+* id. Real upstream identity replaces this once a provider migrates and
+* calls `updateSourceInfo()` with concrete values.
+*/
+function synthesizeSourceInfo(input) {
+	return {
+		id: input.stableId,
+		system: input.addonId
+	};
+}
+/**
+* Shallow-merge a partial patch over a prior SourceInfo. `undefined`
+* patch values are ignored (no field clobber); to clear a field
+* explicitly, providers omit it from the patch and rebuild from scratch
+* via `updateSourceInfo({})` cycles — uncommon enough that we don't
+* bother with a `null`-means-delete sentinel.
+*
+* The `raw` field is also shallow-merged: passing `raw: { foo: 1 }`
+* merges over existing `raw` keys instead of replacing the whole bag.
+*/
+function mergeSourceInfo(prev, patch) {
+	const next = { ...prev };
+	for (const [k, v] of Object.entries(patch)) {
+		if (v === void 0) continue;
+		if (k === "raw" && typeof v === "object" && v !== null) {
+			next.raw = {
+				...prev.raw,
+				...v
+			};
+			continue;
+		}
+		next[k] = v;
+	}
+	return next;
+}
+/**
+* Coerce common unit-of-measurement string variants to a canonical form
+* so the UI's display templates can rely on stable strings. Pure
+* passthrough for unknown units — kept conservative on purpose, the goal
+* is to normalise the long tail of HA `unit_of_measurement` values that
+* have multiple historical spellings (`'°C'` vs `'C'` vs `'celsius'`).
+*
+* Extend the map as we encounter real-world data. Returning the raw
+* input for unknown values is intentional: providers should never
+* lose information silently here.
+*/
+function normalizeUnit(raw) {
+	if (raw == null) return void 0;
+	const trimmed = raw.trim();
+	if (trimmed === "") return void 0;
+	const lower = trimmed.toLowerCase();
+	if (lower === "°c" || lower === "c" || lower === "celsius") return "°C";
+	if (lower === "°f" || lower === "f" || lower === "fahrenheit") return "°F";
+	if (lower === "k" || lower === "kelvin") return "K";
+	if (lower === "%" || lower === "percent" || lower === "percentage") return "%";
+	if (lower === "lx" || lower === "lux") return "lx";
+	if (lower === "hpa" || lower === "hectopascal") return "hPa";
+	if (lower === "kpa") return "kPa";
+	if (lower === "pa") return "Pa";
+	if (lower === "mbar" || lower === "millibar") return "mbar";
+	if (lower === "w" || lower === "watt") return "W";
+	if (lower === "kw" || lower === "kilowatt") return "kW";
+	if (lower === "wh" || lower === "watt-hour") return "Wh";
+	if (lower === "kwh" || lower === "kilowatt-hour") return "kWh";
+	if (lower === "v" || lower === "volt") return "V";
+	if (lower === "a" || lower === "amp" || lower === "ampere") return "A";
+	if (lower === "ma" || lower === "milliampere") return "mA";
+	if (lower === "va") return "VA";
+	if (lower === "ppm") return "ppm";
+	if (lower === "ppb") return "ppb";
+	if (lower === "µg/m³" || lower === "ug/m3" || lower === "µg/m3") return "µg/m³";
+	if (lower === "km/h" || lower === "kph") return "km/h";
+	if (lower === "mph") return "mph";
+	if (lower === "m/s") return "m/s";
+	if (lower === "m") return "m";
+	if (lower === "m²" || lower === "m2") return "m²";
+	if (lower === "mm") return "mm";
+	if (lower === "cm") return "cm";
+	if (lower === "km") return "km";
+	if (lower === "in" || lower === "inch" || lower === "inches") return "in";
+	if (lower === "ft" || lower === "foot" || lower === "feet") return "ft";
+	if (lower === "kg") return "kg";
+	if (lower === "g") return "g";
+	if (lower === "l" || lower === "liter" || lower === "litre" || lower === "liters" || lower === "litres") return "L";
+	if (lower === "ml") return "mL";
+	if (lower === "gal" || lower === "gallon" || lower === "gallons") return "gal";
+	if (lower === "s" || lower === "sec" || lower === "second" || lower === "seconds") return "s";
+	if (lower === "ms") return "ms";
+	if (lower === "min" || lower === "minute" || lower === "minutes") return "min";
+	if (lower === "h" || lower === "hr" || lower === "hour" || lower === "hours") return "h";
+	if (lower === "d" || lower === "day" || lower === "days") return "d";
+	if (lower === "b" || lower === "byte" || lower === "bytes") return "B";
+	if (lower === "kib") return "KiB";
+	if (lower === "mib") return "MiB";
+	if (lower === "gib") return "GiB";
+	if (lower === "tib") return "TiB";
+	if (lower === "kb") return "kB";
+	if (lower === "mb") return "MB";
+	if (lower === "gb") return "GB";
+	if (lower === "dbm") return "dBm";
+	if (lower === "dbfs") return "dBFS";
+	if (lower === "inhg") return "inHg";
+	if (lower === "mm/h") return "mm/h";
+	if (lower === "w/m²" || lower === "w/m2") return "W/m²";
+	if (lower === "°" || lower === "deg" || lower === "degree" || lower === "degrees") return "°";
+	if (lower === "kbps") return "kbps";
+	if (lower === "fps") return "fps";
+	return trimmed;
+}
+/**
+* Key under which `SourceInfo` lives inside `DeviceMeta.metadata`. The
+* blob is a free-form `Record<string, unknown>` shared with hardware-
+* identity fields (`manufacturer`, `model`, `firmware`, …); SourceInfo
+* lives under a single nested key to keep it composable with those.
+*/
+var SOURCE_INFO_METADATA_KEY = "sourceInfo";
+/**
+* Extract a SourceInfo from a `DeviceMeta.metadata` blob, validating
+* with Zod. Returns `null` when the blob is missing or the nested
+* `sourceInfo` key fails validation — callers fall back to the
+* synthetic default in that case (see `synthesizeSourceInfo`).
+*/
+function extractSourceInfoFromMetadata(metadata) {
+	if (!metadata) return null;
+	const raw = metadata[SOURCE_INFO_METADATA_KEY];
+	if (!raw) return null;
+	const parsed = SourceInfoSchema.safeParse(raw);
+	if (!parsed.success) return null;
+	return parsed.data;
+}
+//#endregion
+//#region src/units/unit-table.ts
+/**
+* Frozen unit → spec table. `•` in the doc marks each dimension's canonical
+* unit (`factor: 1, offset: 0`). °F derives from `°C = (°F − 32) × 5/9` ⇒
+* `factor = 5/9`, `offset = -160/9` (kept as exact expressions, not rounded
+* decimals). K derives from `°C = K − 273.15`.
+*/
+var UNIT_TABLE = {
+	"°C": {
+		dimension: "temperature",
+		factor: 1,
+		offset: 0
+	},
+	"°F": {
+		dimension: "temperature",
+		factor: 5 / 9,
+		offset: -160 / 9
+	},
+	K: {
+		dimension: "temperature",
+		factor: 1,
+		offset: -273.15
+	},
+	hPa: {
+		dimension: "pressure",
+		factor: 1,
+		offset: 0
+	},
+	kPa: {
+		dimension: "pressure",
+		factor: 10,
+		offset: 0
+	},
+	Pa: {
+		dimension: "pressure",
+		factor: .01,
+		offset: 0
+	},
+	mbar: {
+		dimension: "pressure",
+		factor: 1,
+		offset: 0
+	},
+	bar: {
+		dimension: "pressure",
+		factor: 1e3,
+		offset: 0
+	},
+	inHg: {
+		dimension: "pressure",
+		factor: 33.8639,
+		offset: 0
+	},
+	mmHg: {
+		dimension: "pressure",
+		factor: 1.33322,
+		offset: 0
+	},
+	psi: {
+		dimension: "pressure",
+		factor: 68.9476,
+		offset: 0
+	},
+	"m/s": {
+		dimension: "speed",
+		factor: 1,
+		offset: 0
+	},
+	"km/h": {
+		dimension: "speed",
+		factor: 1 / 3.6,
+		offset: 0
+	},
+	mph: {
+		dimension: "speed",
+		factor: .44704,
+		offset: 0
+	},
+	kn: {
+		dimension: "speed",
+		factor: .514444,
+		offset: 0
+	},
+	"mm/h": {
+		dimension: "precipitation-rate",
+		factor: 1,
+		offset: 0
+	},
+	"in/h": {
+		dimension: "precipitation-rate",
+		factor: 25.4,
+		offset: 0
+	},
+	m: {
+		dimension: "length",
+		factor: 1,
+		offset: 0
+	},
+	mm: {
+		dimension: "length",
+		factor: .001,
+		offset: 0
+	},
+	cm: {
+		dimension: "length",
+		factor: .01,
+		offset: 0
+	},
+	km: {
+		dimension: "length",
+		factor: 1e3,
+		offset: 0
+	},
+	in: {
+		dimension: "length",
+		factor: .0254,
+		offset: 0
+	},
+	ft: {
+		dimension: "length",
+		factor: .3048,
+		offset: 0
+	},
+	mi: {
+		dimension: "length",
+		factor: 1609.344,
+		offset: 0
+	},
+	"m²": {
+		dimension: "area",
+		factor: 1,
+		offset: 0
+	},
+	lx: {
+		dimension: "illuminance",
+		factor: 1,
+		offset: 0
+	},
+	"W/m²": {
+		dimension: "irradiance",
+		factor: 1,
+		offset: 0
+	},
+	W: {
+		dimension: "power",
+		factor: 1,
+		offset: 0
+	},
+	kW: {
+		dimension: "power",
+		factor: 1e3,
+		offset: 0
+	},
+	VA: {
+		dimension: "apparent-power",
+		factor: 1,
+		offset: 0
+	},
+	Wh: {
+		dimension: "energy",
+		factor: 1,
+		offset: 0
+	},
+	kWh: {
+		dimension: "energy",
+		factor: 1e3,
+		offset: 0
+	},
+	MWh: {
+		dimension: "energy",
+		factor: 1e6,
+		offset: 0
+	},
+	V: {
+		dimension: "voltage",
+		factor: 1,
+		offset: 0
+	},
+	mV: {
+		dimension: "voltage",
+		factor: .001,
+		offset: 0
+	},
+	A: {
+		dimension: "current",
+		factor: 1,
+		offset: 0
+	},
+	mA: {
+		dimension: "current",
+		factor: .001,
+		offset: 0
+	},
+	ppm: {
+		dimension: "concentration-volume",
+		factor: 1,
+		offset: 0
+	},
+	ppb: {
+		dimension: "concentration-volume",
+		factor: .001,
+		offset: 0
+	},
+	"µg/m³": {
+		dimension: "concentration-mass",
+		factor: 1,
+		offset: 0
+	},
+	"mg/m³": {
+		dimension: "concentration-mass",
+		factor: 1e3,
+		offset: 0
+	},
+	kg: {
+		dimension: "mass",
+		factor: 1,
+		offset: 0
+	},
+	g: {
+		dimension: "mass",
+		factor: .001,
+		offset: 0
+	},
+	lb: {
+		dimension: "mass",
+		factor: .453592,
+		offset: 0
+	},
+	oz: {
+		dimension: "mass",
+		factor: .0283495,
+		offset: 0
+	},
+	"%": {
+		dimension: "percentage",
+		factor: 1,
+		offset: 0
+	},
+	L: {
+		dimension: "volume",
+		factor: 1,
+		offset: 0
+	},
+	mL: {
+		dimension: "volume",
+		factor: .001,
+		offset: 0
+	},
+	gal: {
+		dimension: "volume",
+		factor: 3.785411784,
+		offset: 0
+	},
+	s: {
+		dimension: "duration",
+		factor: 1,
+		offset: 0
+	},
+	ms: {
+		dimension: "duration",
+		factor: .001,
+		offset: 0
+	},
+	min: {
+		dimension: "duration",
+		factor: 60,
+		offset: 0
+	},
+	h: {
+		dimension: "duration",
+		factor: 3600,
+		offset: 0
+	},
+	d: {
+		dimension: "duration",
+		factor: 86400,
+		offset: 0
+	},
+	B: {
+		dimension: "information",
+		factor: 1,
+		offset: 0
+	},
+	KiB: {
+		dimension: "information",
+		factor: 1024,
+		offset: 0
+	},
+	MiB: {
+		dimension: "information",
+		factor: 1024 ** 2,
+		offset: 0
+	},
+	GiB: {
+		dimension: "information",
+		factor: 1024 ** 3,
+		offset: 0
+	},
+	TiB: {
+		dimension: "information",
+		factor: 1024 ** 4,
+		offset: 0
+	},
+	kB: {
+		dimension: "information",
+		factor: 1e3,
+		offset: 0
+	},
+	MB: {
+		dimension: "information",
+		factor: 1e6,
+		offset: 0
+	},
+	GB: {
+		dimension: "information",
+		factor: 1e9,
+		offset: 0
+	},
+	"°": {
+		dimension: "angle",
+		factor: 1,
+		offset: 0
+	},
+	dBFS: {
+		dimension: "sound-level",
+		factor: 1,
+		offset: 0
+	},
+	dBm: {
+		dimension: "signal-level",
+		factor: 1,
+		offset: 0
+	},
+	mired: {
+		dimension: "colour-temperature",
+		factor: 1,
+		offset: 0
+	},
+	kbps: {
+		dimension: "bitrate",
+		factor: 1,
+		offset: 0
+	},
+	Mbps: {
+		dimension: "bitrate",
+		factor: 1e3,
+		offset: 0
+	},
+	fps: {
+		dimension: "rate",
+		factor: 1,
+		offset: 0
+	}
+};
+//#endregion
+//#region src/units/convert.ts
+/**
+* Pure unit-conversion API over `UNIT_TABLE`. No dependencies, no side effects.
+*
+* Conversion is refused (throws `UnitConversionError`, or returns `undefined`
+* from the `try*` variant) whenever a unit is unknown or the two units belong
+* to different dimensions — cross-dimension conversion is deliberately
+* impossible so a render override can never make the value and its unit label
+* disagree.
+*
+* Callers pass units through `normalizeUnit` (`../device/source-info.ts`) BEFORE
+* calling here — the table keys only canonical spellings.
+*/
+/** Thrown by `convertUnit` when a conversion is refused. Carries the offending
+*  units + a machine-readable `reason` for callers that branch on the cause. */
+var UnitConversionError = class extends Error {
+	from;
+	to;
+	reason;
+	constructor(from, to, reason) {
+		super(`[units] cannot convert '${from}' → '${to}': ${reason}`);
+		this.name = "UnitConversionError";
+		this.from = from;
+		this.to = to;
+		this.reason = reason;
+	}
+};
+/** Resolve a unit's `UnitSpec`, or `undefined` when the spelling is unknown. */
+function specFor(unit) {
+	return Object.hasOwn(UNIT_TABLE, unit) ? UNIT_TABLE[unit] : void 0;
+}
+/** The dimension a unit belongs to, or `undefined` for an unknown unit. */
+function unitDimension(unit) {
+	return specFor(unit)?.dimension;
+}
+/** Value in `spec`'s unit → its dimension's canonical unit. */
+function toCanonical(value, spec) {
+	return value * spec.factor + spec.offset;
+}
+/** Canonical-unit value → the unit described by `spec`. */
+function fromCanonical(canonical, spec) {
+	return (canonical - spec.offset) / spec.factor;
+}
+/**
+* Convert `value` from unit `from` to unit `to`. Identity when `from === to`.
+* Throws `UnitConversionError` when either unit is unknown or the units belong
+* to different dimensions.
+*/
+function convertUnit(value, from, to) {
+	if (from === to) return value;
+	const fromSpec = specFor(from);
+	if (!fromSpec) throw new UnitConversionError(from, to, "unknown-from");
+	const toSpec = specFor(to);
+	if (!toSpec) throw new UnitConversionError(from, to, "unknown-to");
+	if (fromSpec.dimension !== toSpec.dimension) throw new UnitConversionError(from, to, "cross-dimension");
+	return fromCanonical(toCanonical(value, fromSpec), toSpec);
+}
+/**
+* Graceful variant for the render path: returns the converted value, or
+* `undefined` when the conversion is refused (unknown unit / cross-dimension).
+* Never throws — a render caller falls back to the raw value + source unit.
+*/
+function tryConvertUnit(value, from, to) {
+	if (from === to) return value;
+	const fromSpec = specFor(from);
+	if (!fromSpec) return void 0;
+	const toSpec = specFor(to);
+	if (!toSpec) return void 0;
+	if (fromSpec.dimension !== toSpec.dimension) return void 0;
+	return fromCanonical(toCanonical(value, fromSpec), toSpec);
+}
+/**
+* Whether `value` can be converted between `from` and `to` (same dimension,
+* both known). Cheap boolean probe for the UI's same-dimension unit picker and
+* the resolver's convertibility branch — compute ONCE so a unit label and its
+* value math can never disagree.
+*/
+function canConvertUnit(from, to) {
+	if (from === to) return true;
+	const fromDim = unitDimension(from);
+	if (fromDim === void 0) return false;
+	return fromDim === unitDimension(to);
+}
+/**
+* Every known unit spelling in a dimension (table insertion order — canonical
+* unit first). Powers the UI's same-dimension unit picker.
+*/
+/**
+* Convert a difference, not a reading. Affine units (°F) shift an absolute
+* value by their offset; a step of 1°F is 5/9°C, so the offset is cancelled.
+*/
+function tryConvertDelta(value, from, to) {
+	if (from === to) return value;
+	const origin = tryConvertUnit(0, from, to);
+	const shifted = tryConvertUnit(value, from, to);
+	if (origin === void 0 || shifted === void 0) return void 0;
+	return shifted - origin;
+}
+function unitsForDimension(dimension) {
+	const out = [];
+	for (const [unit, spec] of Object.entries(UNIT_TABLE)) if (spec.dimension === dimension) out.push(unit);
+	return out;
+}
+//#endregion
+//#region src/units/quantity-input.ts
+/**
+* A number a person types for a physical quantity — the input side of the
+* value + unit contract (D972).
+*
+* Readings are stored in the base unit of their quantity (D944); a cap method
+* param is stored in the unit its input schema DECLARES (`paramMeta`). The
+* wire pair {@link QuantityValue} says "this number is expressed in this
+* unit"; {@link convertQuantityInput} brings it to the stored unit and refuses,
+* with a typed {@link QuantityUnitError}, a unit that cannot be that quantity.
+*/
+/** A unit that cannot be applied to the number it was given with. */
+var QuantityUnitError = class extends Error {
+	code;
+	constructor(code, message) {
+		super(`[${code}] ${message}`);
+		this.name = "QuantityUnitError";
+		this.code = code;
+	}
+};
+/** The wire pair: `value` is expressed in `unit`. */
+var QuantityValueSchema = zod.z.object({
+	value: zod.z.number(),
+	unit: zod.z.string().min(1)
+});
+function isQuantityValue(candidate) {
+	return QuantityValueSchema.safeParse(candidate).success;
+}
+/**
+* `value` expressed in `unit`, brought to `target`. Throws
+* {@link QuantityUnitError} for a non-finite value, an unknown unit or a unit
+* of another dimension — never guesses.
+*/
+function convertQuantityInput(input) {
+	if (!Number.isFinite(input.value)) throw new QuantityUnitError("non-finite", `${String(input.value)} is not a finite number`);
+	const unit = normalizeUnit(input.unit);
+	if (unit === void 0 || unitDimension(unit) === void 0) throw new QuantityUnitError("unknown-unit", `unknown unit "${input.unit}"`);
+	const converted = tryConvertUnit(input.value, unit, input.target);
+	if (converted === void 0) throw new QuantityUnitError("cross-dimension", `"${input.unit}" is not a unit of ${input.target}'s quantity`);
+	return Number(converted.toPrecision(12));
+}
+/**
+* Zod `.meta()` bag for a cap METHOD param that is a physical quantity — the
+* input-side twin of `readingMeta`. The value is carried in `unit` (a gram
+* portion stays in grams); the unit must belong to the quantity, checked once
+* when the cap is declared.
+*/
+function paramMeta(declared) {
+	const base = require_sleep.baseUnitOf(declared.quantity);
+	if (base === void 0) throw new QuantityUnitError("unknown-unit", `quantity "${declared.quantity}" has no unit`);
+	if (tryConvertUnit(1, declared.unit, base) === void 0) throw new QuantityUnitError("cross-dimension", `"${declared.unit}" is not a unit of ${declared.quantity}`);
+	return {
+		quantity: declared.quantity,
+		unit: declared.unit
+	};
+}
+var ParamMetaBagSchema = zod.z.object({
+	quantity: require_sleep.ReadingQuantitySchema,
+	unit: zod.z.string().min(1)
+});
+function metaOf(schema) {
+	const parsed = ParamMetaBagSchema.safeParse(zod.z.globalRegistry.get(schema));
+	return parsed.success ? parsed.data : void 0;
+}
+/** The `paramMeta` on a method input field (or its unwrapped leaf), if any. */
+function paramMetaOf(field) {
+	return metaOf(field) ?? metaOf(unwrapSchema(field));
+}
+//#endregion
 //#region src/automation/recipe.ts
 /**
 * The automation RECIPE — what a visually-authored automation is, before it
@@ -8121,8 +8906,10 @@ var AutomationConditionLeafSchema = zod.z.object({
 		zod.z.string(),
 		zod.z.number(),
 		zod.z.boolean(),
-		zod.z.array(zod.z.union([zod.z.string(), zod.z.number()]))
-	])
+		zod.z.array(zod.z.union([zod.z.string(), zod.z.number()])),
+		QuantityValueSchema
+	]),
+	unit: zod.z.string().min(1).optional()
 });
 var AutomationConditionStationaryPresentSchema = zod.z.object({
 	kind: zod.z.literal("stationary-present"),
@@ -8275,7 +9062,13 @@ var AutomationCapStepSchema = zod.z.object({
 	/** Values may carry `{{vars.x}}` slots, or be exactly `{ $var: 'name' }`, which
 	*  SUBSTITUTE and do not evaluate (§3.2.3). Anything beyond substitution is
 	*  the expression leaf. */
-	args: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
+	args: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
+	/**
+	* The unit the person picked per arg (display only). `args` always hold the
+	* value in the unit the method's input DECLARES (`paramMeta`); on a write an
+	* arg may be a {@link QuantityValue}, which the save boundary converts.
+	*/
+	argUnits: zod.z.record(zod.z.string(), zod.z.string().min(1)).optional()
 });
 /**
 * The steps an internal Action may contain: cap and wait, and nothing that can
@@ -9855,6 +10648,14 @@ function evalNode(cond, path, reader, now, out) {
 				expected: toTraceValue(cond.value),
 				observed: toTraceValue(observed)
 			};
+			if (isQuantityValue(cond.value)) {
+				out.push({
+					...base,
+					outcome: "fail",
+					reason: `${cond.fieldPath} expected value's unit was never converted → fail`
+				});
+				return false;
+			}
 			if (observed === void 0) {
 				out.push({
 					...base,
@@ -10705,6 +11506,242 @@ function buildActionSteps(steps, vars, deps) {
 	});
 }
 //#endregion
+//#region src/units/quantity-units.ts
+/**
+* Which units a person may pick for a number of a given quantity. The
+* quantity's stored base unit comes first (D944), then every other unit of the
+* same dimension in table order. A quantity with no unit (`none`, `count`,
+* `index`, `ratio`, `device`) offers nothing: the number is just a number.
+*/
+/** The unit a reading of `quantity` is stored in, or `undefined` when it has none. */
+function baseUnitForQuantity(quantity) {
+	return require_sleep.baseUnitOf(quantity);
+}
+/**
+* The units a person can enter a number of `quantity` in — base unit first.
+* Empty when the quantity carries no unit.
+*/
+function unitsForQuantity(quantity) {
+	const base = baseUnitForQuantity(quantity);
+	if (base === void 0) return [];
+	const dimension = unitDimension(base);
+	if (dimension === void 0) return [base];
+	return [base, ...unitsForDimension(dimension).filter((unit) => unit !== base)];
+}
+//#endregion
+//#region src/automation/normalize-units.ts
+/** A bare number accepted as a base unit — the save succeeded, say so. */
+var UnitWarningSchema = zod.z.object({
+	/** Where in the saved record, e.g. `conditions.children.0` or `steps.2.args.grams`. */
+	path: zod.z.string(),
+	deviceId: zod.z.number().int().optional(),
+	field: zod.z.string(),
+	value: zod.z.number(),
+	assumedUnit: zod.z.string(),
+	message: zod.z.string()
+});
+function objectInput(schema) {
+	const inner = unwrapSchema(schema);
+	return inner instanceof zod.z.ZodObject ? inner : void 0;
+}
+/** A resolver over capability definitions (the generated registry, or a fake). */
+function capUnitResolver(defs) {
+	const byName = new Map(defs.map((def) => [def.name, def]));
+	return {
+		fieldQuantity(cap, fieldPath) {
+			const status = byName.get(cap)?.status;
+			if (status === void 0) return void 0;
+			return [...enumerateSchemaFields(status.schema), ...status.itemArray === void 0 ? [] : enumerateItemArrayFields(status.itemArray)].find((f) => f.path === fieldPath)?.quantity;
+		},
+		paramMeta(cap, method, arg) {
+			const input = byName.get(cap)?.methods[method]?.input;
+			if (input === void 0) return void 0;
+			const field = objectInput(input)?.shape[arg];
+			return field === void 0 ? void 0 : paramMetaOf(field);
+		}
+	};
+}
+function pickedUnit(raw) {
+	return normalizeUnit(raw) ?? raw;
+}
+function hasUnitChoice(quantity) {
+	return unitsForQuantity(quantity).length > 1;
+}
+function bareWarning(input) {
+	return {
+		...input,
+		message: `${input.field}: the bare number ${input.value} was taken as ${input.assumedUnit} — send { value, unit } to state the unit`
+	};
+}
+function checkPickedUnit(unit, target) {
+	convertQuantityInput({
+		value: 1,
+		unit,
+		target
+	});
+}
+function normalizeLeaf(leaf, resolver, path) {
+	const quantity = resolver.fieldQuantity(leaf.cap, leaf.fieldPath);
+	const base = quantity === void 0 ? void 0 : baseUnitForQuantity(quantity);
+	const wantsUnit = isQuantityValue(leaf.value) || leaf.unit !== void 0;
+	if (base === void 0 || quantity === void 0) {
+		if (wantsUnit) throw new QuantityUnitError("no-quantity", `${leaf.cap}.${leaf.fieldPath} is not a quantity — it takes no unit`);
+		return {
+			leaf,
+			warnings: []
+		};
+	}
+	if (isQuantityValue(leaf.value)) {
+		const converted = convertQuantityInput({
+			value: leaf.value.value,
+			unit: leaf.value.unit,
+			target: base
+		});
+		return {
+			leaf: {
+				...leaf,
+				value: converted,
+				unit: pickedUnit(leaf.value.unit)
+			},
+			warnings: []
+		};
+	}
+	if (typeof leaf.value !== "number") return {
+		leaf,
+		warnings: []
+	};
+	if (leaf.unit !== void 0) {
+		checkPickedUnit(leaf.unit, base);
+		return {
+			leaf,
+			warnings: []
+		};
+	}
+	if (!hasUnitChoice(quantity)) return {
+		leaf,
+		warnings: []
+	};
+	return {
+		leaf,
+		warnings: [bareWarning({
+			path,
+			deviceId: leaf.deviceId,
+			field: leaf.fieldPath,
+			value: leaf.value,
+			assumedUnit: base
+		})]
+	};
+}
+/** Normalise every leaf of a condition tree. Throws {@link QuantityUnitError}. */
+function normalizeConditionUnits(condition, resolver, path = "conditions") {
+	switch (condition.kind) {
+		case "condition": {
+			const { leaf, warnings } = normalizeLeaf(condition, resolver, path);
+			return {
+				value: leaf,
+				warnings
+			};
+		}
+		case "not": {
+			const inner = normalizeConditionUnits(condition.child, resolver, `${path}.child`);
+			return {
+				value: {
+					...condition,
+					child: inner.value
+				},
+				warnings: inner.warnings
+			};
+		}
+		case "all":
+		case "any": {
+			const children = condition.children.map((child, i) => normalizeConditionUnits(child, resolver, `${path}.children.${i}`));
+			return {
+				value: {
+					...condition,
+					children: children.map((c) => c.value)
+				},
+				warnings: children.flatMap((c) => c.warnings)
+			};
+		}
+		default: return {
+			value: condition,
+			warnings: []
+		};
+	}
+}
+function normalizeCapStep(step, resolver, path) {
+	const deviceId = typeof step.deviceId === "number" ? step.deviceId : void 0;
+	const args = { ...step.args };
+	const argUnits = { ...step.argUnits };
+	const warnings = [];
+	for (const [arg, picked] of Object.entries(step.argUnits ?? {})) {
+		const meta = resolver.paramMeta(step.cap, step.method, arg);
+		if (meta === void 0) throw new QuantityUnitError("no-quantity", `${step.cap}.${step.method}(${arg}) is not a quantity — it takes no unit`);
+		checkPickedUnit(picked, meta.unit);
+	}
+	for (const [arg, given] of Object.entries(step.args ?? {})) {
+		const meta = resolver.paramMeta(step.cap, step.method, arg);
+		if (meta === void 0) continue;
+		if (isQuantityValue(given)) {
+			args[arg] = convertQuantityInput({
+				value: given.value,
+				unit: given.unit,
+				target: meta.unit
+			});
+			argUnits[arg] = pickedUnit(given.unit);
+		} else if (typeof given === "number" && argUnits[arg] === void 0 && hasUnitChoice(meta.quantity)) warnings.push(bareWarning({
+			path: `${path}.args.${arg}`,
+			...deviceId === void 0 ? {} : { deviceId },
+			field: arg,
+			value: given,
+			assumedUnit: meta.unit
+		}));
+	}
+	const { argUnits: _dropped, ...rest } = step;
+	return {
+		value: {
+			...rest,
+			...step.args === void 0 ? {} : { args },
+			...Object.keys(argUnits).length > 0 ? { argUnits } : {}
+		},
+		warnings
+	};
+}
+/**
+* Normalise the cap steps of an action list (an internal Action's steps, or a
+* recipe's actions). Other step kinds pass through. Throws {@link QuantityUnitError}.
+*/
+function normalizeActionUnits(actions, resolver, path = "steps") {
+	const out = [];
+	const warnings = [];
+	actions.forEach((action, i) => {
+		if (action.kind !== "cap") {
+			out.push(action);
+			return;
+		}
+		const normalized = normalizeCapStep(action, resolver, `${path}.${i}`);
+		out.push(normalized.value);
+		warnings.push(...normalized.warnings);
+	});
+	return {
+		value: out,
+		warnings
+	};
+}
+/** Normalise a whole recipe: its condition tree and its actions. */
+function normalizeRecipeUnits(recipe, resolver) {
+	const conditions = recipe.conditions === void 0 ? void 0 : normalizeConditionUnits(recipe.conditions, resolver, "conditions");
+	const actions = normalizeActionUnits(recipe.actions, resolver, "actions");
+	return {
+		value: {
+			...recipe,
+			...conditions === void 0 ? {} : { conditions: conditions.value },
+			actions: actions.value
+		},
+		warnings: [...conditions?.warnings ?? [], ...actions.warnings]
+	};
+}
+//#endregion
 //#region src/capabilities/notification-output.cap.ts
 /**
 * notification-output — canonical, capability-gated notification delivery.
@@ -15199,77 +16236,6 @@ function kebabToCamel(s) {
 	return s.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
 }
 //#endregion
-//#region src/device/schema-fields.ts
-/** Unwrap ZodNullable / ZodOptional / ZodDefault wrappers to reach the inner type.
-*  Zod v4 exposes `.unwrap()` on all three wrapper classes. */
-function unwrapSchema(schema) {
-	let s = schema;
-	while (s instanceof zod.z.ZodNullable || s instanceof zod.z.ZodOptional || s instanceof zod.z.ZodDefault) s = s.unwrap();
-	return s;
-}
-function isMetaBag(value) {
-	return typeof value === "object" && value !== null;
-}
-function metaQuantity(schema) {
-	const bag = zod.z.globalRegistry.get(schema);
-	if (isMetaBag(bag) && require_sleep.isReadingQuantity(bag.quantity)) return bag.quantity;
-}
-/** Quantity declared with `readingMeta` on the field or on the unwrapped leaf. */
-function quantityOfField(schema) {
-	return metaQuantity(schema) ?? metaQuantity(unwrapSchema(schema));
-}
-function leafKind(schema) {
-	const s = unwrapSchema(schema);
-	if (s instanceof zod.z.ZodEnum) return {
-		kind: "enum",
-		enumValues: s.options
-	};
-	if (s instanceof zod.z.ZodNumber) return { kind: "number" };
-	if (s instanceof zod.z.ZodString) return { kind: "string" };
-	if (s instanceof zod.z.ZodBoolean) return { kind: "boolean" };
-	return null;
-}
-/** Walk a cap status schema into flat wireable leaf fields (dotted paths).
-*  Recurses into nested ZodObject (unwrapping nullable/optional/default first),
-*  so fields with null live values are still offered. Arrays / unknown shapes
-*  are skipped — never throws. */
-function enumerateSchemaFields(schema, prefix = "") {
-	const root = unwrapSchema(schema);
-	if (!(root instanceof zod.z.ZodObject)) return [];
-	const out = [];
-	const shape = root.shape;
-	for (const [key, field] of Object.entries(shape)) {
-		const path = prefix ? `${prefix}.${key}` : key;
-		const inner = unwrapSchema(field);
-		if (inner instanceof zod.z.ZodObject) {
-			out.push(...enumerateSchemaFields(inner, path));
-			continue;
-		}
-		const leaf = leafKind(field);
-		if (leaf) {
-			const quantity = quantityOfField(field);
-			out.push({
-				path,
-				kind: leaf.kind,
-				...leaf.enumValues ? { enumValues: leaf.enumValues } : {},
-				...quantity !== void 0 ? { quantity } : {}
-			});
-		}
-	}
-	return out;
-}
-/** Enumerate the per-item wireable fields of an item-array cap (see
-*  `CapabilityStatusItemArray`): the item schema's leaf fields, minus the
-*  `keyField` (the key comes from the link's `itemKey`, never from a wired
-*  source), each tagged `item: true` so the authoring UI collects an
-*  `itemKey` alongside the field. Never throws. */
-function enumerateItemArrayFields(itemArray) {
-	return enumerateSchemaFields(itemArray.itemSchema).filter((f) => f.path !== itemArray.keyField).map((f) => ({
-		...f,
-		item: true
-	}));
-}
-//#endregion
 //#region src/composition/state-fields.ts
 /**
 * What a capability's state field IS: kind, nullability, whether required. The
@@ -21163,192 +22129,6 @@ function parseAdminBase(baseUrl) {
 	};
 }
 //#endregion
-//#region src/device/source-info.ts
-/**
-* Identity envelope for a device's upstream-system metadata.
-*
-* Two jobs:
-*
-*   1. **Dispatch key.** `id` is the natural identifier the SOURCE system
-*      uses to address this device (HA `entity_id`, Reolink MAC, ONVIF
-*      WS-Discovery endpoint UUID, …). Provider code keeps a
-*      `Map<sourceInfo.id, IDevice>` to route inbound push events in O(1)
-*      without round-tripping through `stableId` / `id` mappings.
-*
-*   2. **Stability bridge.** `uniqueId` is the *immutable* upstream id when
-*      one exists (HA `entity.unique_id`, Reolink MAC again — same as `id`
-*      for vendors where MAC is the natural key). For systems where the
-*      live dispatch key can be renamed (HA `entity_id` can be edited),
-*      providers detect renames by matching `uniqueId` and patch `id`
-*      in-place so dispatch keeps working.
-*
-* **Display unit and precision are NOT stored here.** They are a read-time
-* preference (D944). A polymorphic reading stores its `quantity` here once,
-* at adopt, and a date/time value stores `dateTimeShape` the same way —
-* neither is repeated on each sample. The `device_class` tag is an
-* HA-specific input consumed at the discovery boundary (`ha-domain-mapping`)
-* to derive the CamStack `DeviceRole`; it is never stored after that point.
-*
-* The `raw` escape hatch carries provider-specific attributes that don't
-* fit the structured slots (HA `attributes` whitelist, Reolink `deviceCache`
-* details, …). Providers control what lands here.
-*/
-var SourceInfoSchema = zod.z.object({
-	/** Live dispatch key — mutable when the source system allows rename. */
-	id: zod.z.string(),
-	/** Source system tag — e.g. 'homeassistant' | 'reolink' | 'onvif'. */
-	system: zod.z.string(),
-	/** Immutable upstream identifier when available (HA `unique_id`, … ).
-	*  Used to detect rename when `id` changes. */
-	uniqueId: zod.z.string().optional(),
-	/** Quantity of a polymorphic reading, written once at adopt (D944). */
-	quantity: require_sleep.ReadingQuantitySchema.optional(),
-	/** Date / time / datetime shape of a string reading, written once at adopt. */
-	dateTimeShape: zod.z.enum([
-		"date",
-		"time",
-		"datetime"
-	]).optional(),
-	/** Provider-specific extras that don't fit the structured slots.
-	*  Whitelist what goes here per provider — do NOT dump entire HA
-	*  attribute blobs (would explode the meta JSON column). */
-	raw: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
-});
-/**
-* Build the synthetic SourceInfo every existing provider falls back to
-* when no upstream value has been persisted. Keeps non-migrated providers
-* (Reolink / Hikvision / ONVIF / RTSP) functional without code
-* changes — `id` reuses the CamStack stableId, `system` reuses the addon
-* id. Real upstream identity replaces this once a provider migrates and
-* calls `updateSourceInfo()` with concrete values.
-*/
-function synthesizeSourceInfo(input) {
-	return {
-		id: input.stableId,
-		system: input.addonId
-	};
-}
-/**
-* Shallow-merge a partial patch over a prior SourceInfo. `undefined`
-* patch values are ignored (no field clobber); to clear a field
-* explicitly, providers omit it from the patch and rebuild from scratch
-* via `updateSourceInfo({})` cycles — uncommon enough that we don't
-* bother with a `null`-means-delete sentinel.
-*
-* The `raw` field is also shallow-merged: passing `raw: { foo: 1 }`
-* merges over existing `raw` keys instead of replacing the whole bag.
-*/
-function mergeSourceInfo(prev, patch) {
-	const next = { ...prev };
-	for (const [k, v] of Object.entries(patch)) {
-		if (v === void 0) continue;
-		if (k === "raw" && typeof v === "object" && v !== null) {
-			next.raw = {
-				...prev.raw,
-				...v
-			};
-			continue;
-		}
-		next[k] = v;
-	}
-	return next;
-}
-/**
-* Coerce common unit-of-measurement string variants to a canonical form
-* so the UI's display templates can rely on stable strings. Pure
-* passthrough for unknown units — kept conservative on purpose, the goal
-* is to normalise the long tail of HA `unit_of_measurement` values that
-* have multiple historical spellings (`'°C'` vs `'C'` vs `'celsius'`).
-*
-* Extend the map as we encounter real-world data. Returning the raw
-* input for unknown values is intentional: providers should never
-* lose information silently here.
-*/
-function normalizeUnit(raw) {
-	if (raw == null) return void 0;
-	const trimmed = raw.trim();
-	if (trimmed === "") return void 0;
-	const lower = trimmed.toLowerCase();
-	if (lower === "°c" || lower === "c" || lower === "celsius") return "°C";
-	if (lower === "°f" || lower === "f" || lower === "fahrenheit") return "°F";
-	if (lower === "k" || lower === "kelvin") return "K";
-	if (lower === "%" || lower === "percent" || lower === "percentage") return "%";
-	if (lower === "lx" || lower === "lux") return "lx";
-	if (lower === "hpa" || lower === "hectopascal") return "hPa";
-	if (lower === "kpa") return "kPa";
-	if (lower === "pa") return "Pa";
-	if (lower === "mbar" || lower === "millibar") return "mbar";
-	if (lower === "w" || lower === "watt") return "W";
-	if (lower === "kw" || lower === "kilowatt") return "kW";
-	if (lower === "wh" || lower === "watt-hour") return "Wh";
-	if (lower === "kwh" || lower === "kilowatt-hour") return "kWh";
-	if (lower === "v" || lower === "volt") return "V";
-	if (lower === "a" || lower === "amp" || lower === "ampere") return "A";
-	if (lower === "ma" || lower === "milliampere") return "mA";
-	if (lower === "va") return "VA";
-	if (lower === "ppm") return "ppm";
-	if (lower === "ppb") return "ppb";
-	if (lower === "µg/m³" || lower === "ug/m3" || lower === "µg/m3") return "µg/m³";
-	if (lower === "km/h" || lower === "kph") return "km/h";
-	if (lower === "mph") return "mph";
-	if (lower === "m/s") return "m/s";
-	if (lower === "m") return "m";
-	if (lower === "m²" || lower === "m2") return "m²";
-	if (lower === "mm") return "mm";
-	if (lower === "cm") return "cm";
-	if (lower === "km") return "km";
-	if (lower === "in" || lower === "inch" || lower === "inches") return "in";
-	if (lower === "ft" || lower === "foot" || lower === "feet") return "ft";
-	if (lower === "kg") return "kg";
-	if (lower === "g") return "g";
-	if (lower === "l" || lower === "liter" || lower === "litre" || lower === "liters" || lower === "litres") return "L";
-	if (lower === "ml") return "mL";
-	if (lower === "gal" || lower === "gallon" || lower === "gallons") return "gal";
-	if (lower === "s" || lower === "sec" || lower === "second" || lower === "seconds") return "s";
-	if (lower === "ms") return "ms";
-	if (lower === "min" || lower === "minute" || lower === "minutes") return "min";
-	if (lower === "h" || lower === "hr" || lower === "hour" || lower === "hours") return "h";
-	if (lower === "d" || lower === "day" || lower === "days") return "d";
-	if (lower === "b" || lower === "byte" || lower === "bytes") return "B";
-	if (lower === "kib") return "KiB";
-	if (lower === "mib") return "MiB";
-	if (lower === "gib") return "GiB";
-	if (lower === "tib") return "TiB";
-	if (lower === "kb") return "kB";
-	if (lower === "mb") return "MB";
-	if (lower === "gb") return "GB";
-	if (lower === "dbm") return "dBm";
-	if (lower === "dbfs") return "dBFS";
-	if (lower === "inhg") return "inHg";
-	if (lower === "mm/h") return "mm/h";
-	if (lower === "w/m²" || lower === "w/m2") return "W/m²";
-	if (lower === "°" || lower === "deg" || lower === "degree" || lower === "degrees") return "°";
-	if (lower === "kbps") return "kbps";
-	if (lower === "fps") return "fps";
-	return trimmed;
-}
-/**
-* Key under which `SourceInfo` lives inside `DeviceMeta.metadata`. The
-* blob is a free-form `Record<string, unknown>` shared with hardware-
-* identity fields (`manufacturer`, `model`, `firmware`, …); SourceInfo
-* lives under a single nested key to keep it composable with those.
-*/
-var SOURCE_INFO_METADATA_KEY = "sourceInfo";
-/**
-* Extract a SourceInfo from a `DeviceMeta.metadata` blob, validating
-* with Zod. Returns `null` when the blob is missing or the nested
-* `sourceInfo` key fails validation — callers fall back to the
-* synthetic default in that case (see `synthesizeSourceInfo`).
-*/
-function extractSourceInfoFromMetadata(metadata) {
-	if (!metadata) return null;
-	const raw = metadata[SOURCE_INFO_METADATA_KEY];
-	if (!raw) return null;
-	const parsed = SourceInfoSchema.safeParse(raw);
-	if (!parsed.success) return null;
-	return parsed.data;
-}
-//#endregion
 //#region src/capabilities/device-discovery.cap.ts
 /**
 * device-discovery — device-scoped capability for parents that host /
@@ -65158,15 +65938,29 @@ var actionsCapability = {
 			auth: "admin"
 		}),
 		getTraces: require_sleep.method(ActionIdInput, zod.z.object({ traces: zod.z.array(AutomationRunTraceSchema) }), { auth: "admin" }),
-		/** Internal actions only. A read-only (addon) entry is refused with `[read-only]`. */
-		create: require_sleep.method(zod.z.object({ action: ActionInputSchema }), zod.z.object({ action: ActionEntrySchema }), {
+		/**
+		* Internal actions only; a read-only (addon) entry is refused with `[read-only]`.
+		* Create an internal action. A cap step arg that is a physical quantity may
+		* be sent as `{ value, unit }` ("value expressed in unit"); the server
+		* converts it to the unit the method's input declares, stores the bare
+		* number plus the picked unit in `argUnits`, and refuses a unit of another
+		* dimension (`[invalid-steps]`). A bare number is taken as the declared
+		* unit and answered as a `warnings` entry (D972).
+		*/
+		create: require_sleep.method(zod.z.object({ action: ActionInputSchema }), zod.z.object({
+			action: ActionEntrySchema,
+			warnings: zod.z.array(UnitWarningSchema).optional()
+		}), {
 			kind: "mutation",
 			auth: "admin"
 		}),
 		update: require_sleep.method(zod.z.object({
 			actionId: zod.z.string().min(1),
 			action: ActionInputSchema.partial()
-		}), zod.z.object({ action: ActionEntrySchema }), {
+		}), zod.z.object({
+			action: ActionEntrySchema,
+			warnings: zod.z.array(UnitWarningSchema).optional()
+		}), {
 			kind: "mutation",
 			auth: "admin"
 		}),
@@ -65813,6 +66607,39 @@ var EMPTY_REMOTE_ASSUMED_STATE = {
 	muted: null
 };
 var MAX_LAYOUT_SPAN = 24;
+var MAX_LAYOUT_GROUPS = 50;
+/**
+* Closed vocabularies the UI knows how to DRAW (D973). A layout names a shape,
+* a tone or a frame; it never carries a style. An addon that contributes a
+* component picks from these lists — it ships no UI code.
+*/
+var REMOTE_BUTTON_SHAPES = [
+	"rect",
+	"rounded",
+	"round",
+	"pill"
+];
+var RemoteButtonShapeSchema = zod.z.enum(REMOTE_BUTTON_SHAPES);
+var REMOTE_BUTTON_TONES = [
+	"neutral",
+	"accent",
+	"danger",
+	"red",
+	"green",
+	"yellow",
+	"blue"
+];
+var RemoteButtonToneSchema = zod.z.enum(REMOTE_BUTTON_TONES);
+var REMOTE_GROUP_FRAMES = [
+	"none",
+	"panel",
+	"divider",
+	"dpad",
+	"rocker-v",
+	"rocker-h",
+	"keypad"
+];
+var RemoteGroupFrameSchema = zod.z.enum(REMOTE_GROUP_FRAMES);
 var RemoteLayoutButtonSchema = zod.z.object({
 	id: zod.z.string().min(1).max(40),
 	/** 0-based grid position. */
@@ -65822,12 +66649,94 @@ var RemoteLayoutButtonSchema = zod.z.object({
 	colSpan: zod.z.number().int().min(1).max(24),
 	icon: zod.z.string().min(1).max(60).optional(),
 	label: zod.z.string().min(1).max(40).optional(),
-	role: RemoteRoleSchema
+	role: RemoteRoleSchema,
+	/** Absent = the plain rendering every layout had before shapes existed. */
+	shape: RemoteButtonShapeSchema.optional(),
+	tone: RemoteButtonToneSchema.optional(),
+	/** The group this button belongs to; it must lie inside that group's rectangle. */
+	groupId: zod.z.string().min(1).max(40).optional()
 });
+/**
+* A rectangle of the grid that moves as ONE thing and is drawn with a frame: a
+* titled panel, a section divider, a D-pad ring. `componentId` names the palette
+* entry it came from (informational: the layout is self-contained).
+*/
+var RemoteLayoutGroupSchema = zod.z.object({
+	id: zod.z.string().min(1).max(40),
+	componentId: zod.z.string().min(1).max(80),
+	frame: RemoteGroupFrameSchema,
+	row: zod.z.number().int().min(0).max(24),
+	col: zod.z.number().int().min(0).max(24),
+	rowSpan: zod.z.number().int().min(1).max(24),
+	colSpan: zod.z.number().int().min(1).max(24),
+	title: zod.z.string().min(1).max(40).optional()
+});
+function rectsOverlap(a, b) {
+	return a.row < b.row + b.rowSpan && b.row < a.row + a.rowSpan && a.col < b.col + b.colSpan && b.col < a.col + a.colSpan;
+}
+function rectContains(outer, inner) {
+	return inner.row >= outer.row && inner.col >= outer.col && inner.row + inner.rowSpan <= outer.row + outer.rowSpan && inner.col + inner.colSpan <= outer.col + outer.colSpan;
+}
+/**
+* The group rules of a layout: inside the grid, no two groups overlap, a
+* member lies inside its group, a divider holds nothing, and a button that is
+* not a member never sits inside someone else's rectangle (a group moves as
+* one thing, so a stray key under it would be left behind).
+*/
+function refineGroups(grid, ctx) {
+	const groups = grid.groups ?? [];
+	const byId = /* @__PURE__ */ new Map();
+	const fail = (message, path) => {
+		ctx.addIssue({
+			code: "custom",
+			message,
+			path
+		});
+	};
+	groups.forEach((group, index) => {
+		if (byId.has(group.id)) fail(`group id "${group.id}" is used twice`, [
+			"groups",
+			index,
+			"id"
+		]);
+		byId.set(group.id, group);
+		if (group.row + group.rowSpan > grid.rows || group.col + group.colSpan > grid.columns) fail(`group "${group.id}" leaves the grid`, ["groups", index]);
+		for (let other = 0; other < index; other += 1) {
+			const earlier = groups[other];
+			if (earlier !== void 0 && rectsOverlap(earlier, group)) {
+				fail(`groups "${earlier.id}" and "${group.id}" overlap`, ["groups", index]);
+				return;
+			}
+		}
+	});
+	grid.buttons.forEach((button, index) => {
+		if (button.groupId !== void 0) {
+			const group = byId.get(button.groupId);
+			if (group === void 0) {
+				fail(`button "${button.id}" names the unknown group "${button.groupId}"`, [
+					"buttons",
+					index,
+					"groupId"
+				]);
+				return;
+			}
+			if (group.frame === "divider") fail(`a divider group ("${group.id}") holds no buttons`, [
+				"buttons",
+				index,
+				"groupId"
+			]);
+			if (!rectContains(group, button)) fail(`button "${button.id}" lies outside its group "${group.id}"`, ["buttons", index]);
+			return;
+		}
+		const foreign = groups.find((group) => rectsOverlap(group, button));
+		if (foreign !== void 0) fail(`button "${button.id}" lies inside group "${foreign.id}" but is not a member`, ["buttons", index]);
+	});
+}
 var RemoteLayoutPayloadSchema = zod.z.object({
 	columns: zod.z.number().int().min(1).max(24),
 	rows: zod.z.number().int().min(1).max(24),
-	buttons: zod.z.array(RemoteLayoutButtonSchema).max(200)
+	buttons: zod.z.array(RemoteLayoutButtonSchema).max(200),
+	groups: zod.z.array(RemoteLayoutGroupSchema).max(50).optional()
 }).superRefine((grid, ctx) => {
 	const ids = /* @__PURE__ */ new Set();
 	const taken = /* @__PURE__ */ new Map();
@@ -65864,6 +66773,7 @@ var RemoteLayoutPayloadSchema = zod.z.object({
 			taken.set(cell, button.id);
 		}
 	});
+	refineGroups(grid, ctx);
 });
 //#endregion
 //#region src/capabilities/remote.cap.ts
@@ -66093,6 +67003,121 @@ var templateCapability = {
 	}
 };
 //#endregion
+//#region src/remote/remote-components.ts
+/**
+* A remote layout COMPONENT (D973): a reusable, named chunk of a remote — a
+* D-pad, a keypad, a section divider — offered in the template editor's
+* "Add component" palette. Pure data: the buttons are placed RELATIVE to the
+* component, and the frame, shape and tone are names from the closed
+* vocabularies the UI draws. An addon contributes components through the
+* `remote-layout-components` cap and ships no UI code.
+*/
+var REMOTE_COMPONENT_CATEGORIES = [
+	"power",
+	"navigation",
+	"volume",
+	"numbers",
+	"media",
+	"colour",
+	"apps",
+	"layout"
+];
+var RemoteComponentCategorySchema = zod.z.enum(REMOTE_COMPONENT_CATEGORIES);
+var MAX_COMPONENT_BUTTONS = 40;
+/** `<namespace>:<name>`, both lowercase slugs — `core:dpad`, `<addonId>:<name>`. */
+var COMPONENT_ID_RE = /^[a-z0-9][a-z0-9_.-]*:[a-z0-9][a-z0-9_-]*$/;
+var RemoteComponentButtonSchema = zod.z.object({
+	/** Joined to the instance id when the component is inserted. */
+	idSuffix: zod.z.string().regex(/^[a-z0-9][a-z0-9_-]{0,19}$/, { message: "a short lowercase slug" }),
+	row: zod.z.number().int().min(0).max(24),
+	col: zod.z.number().int().min(0).max(24),
+	rowSpan: zod.z.number().int().min(1).max(24),
+	colSpan: zod.z.number().int().min(1).max(24),
+	role: RemoteRoleSchema,
+	icon: zod.z.string().min(1).max(60).optional(),
+	label: zod.z.string().min(1).max(40).optional(),
+	shape: RemoteButtonShapeSchema.optional(),
+	tone: RemoteButtonToneSchema.optional()
+});
+var RemoteLayoutComponentSchema = zod.z.object({
+	id: zod.z.string().max(80).regex(COMPONENT_ID_RE, { message: "<namespace>:<name>, lowercase" }),
+	name: zod.z.string().min(1).max(60),
+	nameI18n: zod.z.object({
+		en: zod.z.string().min(1).max(60),
+		it: zod.z.string().min(1).max(60)
+	}).optional(),
+	/** A display icon key, resolved by the UI like a button icon. */
+	icon: zod.z.string().min(1).max(60),
+	category: RemoteComponentCategorySchema,
+	size: zod.z.object({
+		rows: zod.z.number().int().min(1).max(24),
+		cols: zod.z.number().int().min(1).max(24)
+	}),
+	/** The frame drawn around the whole component, or null for loose buttons. */
+	group: zod.z.object({
+		frame: RemoteGroupFrameSchema,
+		title: zod.z.string().min(1).max(40).optional()
+	}).nullable(),
+	buttons: zod.z.array(RemoteComponentButtonSchema).max(40)
+}).superRefine((component, ctx) => {
+	const suffixes = /* @__PURE__ */ new Set();
+	component.buttons.forEach((button, index) => {
+		if (suffixes.has(button.idSuffix)) ctx.addIssue({
+			code: "custom",
+			message: `button "${button.idSuffix}" is listed twice`,
+			path: [
+				"buttons",
+				index,
+				"idSuffix"
+			]
+		});
+		suffixes.add(button.idSuffix);
+		if (button.row + button.rowSpan > component.size.rows || button.col + button.colSpan > component.size.cols) {
+			ctx.addIssue({
+				code: "custom",
+				message: `button "${button.idSuffix}" leaves the component`,
+				path: ["buttons", index]
+			});
+			return;
+		}
+		for (let other = 0; other < index; other += 1) {
+			const earlier = component.buttons[other];
+			if (earlier !== void 0 && rectsOverlap(earlier, button)) {
+				ctx.addIssue({
+					code: "custom",
+					message: `buttons "${earlier.idSuffix}" and "${button.idSuffix}" overlap`,
+					path: ["buttons", index]
+				});
+				return;
+			}
+		}
+	});
+	if (component.group?.frame === "divider" && component.buttons.length > 0) ctx.addIssue({
+		code: "custom",
+		message: "a divider component holds no buttons",
+		path: ["buttons"]
+	});
+});
+//#endregion
+//#region src/capabilities/remote-layout-components.cap.ts
+/**
+* remote-layout-components — the palette of the remote template editor's "Add
+* component" (D973). A provider DECLARES components as data (buttons placed
+* relative to the component, a frame, shapes and tones from closed
+* vocabularies the UI draws); it ships no UI code.
+*
+* Collection: `listComponents` returns an array, so the generated mount
+* concat-fans it across every enabled provider. The core-blocks builtin
+* provides the built-in set (`core:*`); an addon adds its own under
+* `<addonId>:<name>`. The caller dedupes by id, built-ins first.
+*/
+var remoteLayoutComponentsCapability = {
+	name: "remote-layout-components",
+	scope: "system",
+	mode: "collection",
+	methods: { listComponents: require_sleep.method(zod.z.object({}), zod.z.array(RemoteLayoutComponentSchema), { auth: "protected" }) }
+};
+//#endregion
 //#region src/capabilities/button.cap.ts
 /**
 * button — device-scoped capability for HA `button.*` / `input_button.*`
@@ -73343,6 +74368,14 @@ var PetFeederDeviceStatusSchema = zod.z.enum([
 	"on_batteries"
 ]);
 var gramsPortion = zod.z.number().int().min(4).max(200);
+/** A portion REQUESTED of the feeder is a mass the method takes in GRAMS (the
+*  hardware's own unit). The bounds are grams; a caller entering another unit
+*  converts to grams first (`paramMeta`, D972). The STATUS fields above stay
+*  plain grams — they are not readings in the kilogram base. */
+var gramsParam = gramsPortion.meta(paramMeta({
+	quantity: "mass",
+	unit: "g"
+}));
 var PetFeederStatusSchema = zod.z.object({
 	/** Food in the TANK (hopper), as the feeder's own sensor reports it
 	*  (`state.food`). A coarse level code, not grams — `0` is empty. The
@@ -73431,9 +74464,9 @@ var petFeederCapability = {
 		*/
 		feed: require_sleep.method(zod.z.object({
 			deviceId: zod.z.number().int().nonnegative(),
-			grams: gramsPortion.optional(),
-			hopper1: gramsPortion.optional(),
-			hopper2: gramsPortion.optional()
+			grams: gramsParam.optional(),
+			hopper1: gramsParam.optional(),
+			hopper2: gramsParam.optional()
 		}), zod.z.void(), {
 			kind: "mutation",
 			auth: "protected"
@@ -82154,6 +83187,430 @@ var PIPELINE_OWNER_CAPABILITY_NAMES = [
 	"pipeline-runner"
 ];
 //#endregion
+//#region src/remote/remote-layout-ops.ts
+var LAYOUT_EDIT_REFUSALS = [
+	"outside",
+	"overlap",
+	"unknown-group",
+	"too-many"
+];
+var refuse = (reason) => ({
+	ok: false,
+	reason
+});
+function withGroups(layout, groups) {
+	const { groups: _previous, ...rest } = layout;
+	return groups.length === 0 ? rest : {
+		...rest,
+		groups: [...groups]
+	};
+}
+function fitsGrid(layout, rect) {
+	return rect.row >= 0 && rect.col >= 0 && rect.row + rect.rowSpan <= layout.rows && rect.col + rect.colSpan <= layout.columns;
+}
+/** The columns a component must be scaled by to span the whole grid width, or null when it does not divide. */
+function fillWidthScale(layout, component) {
+	const factor = layout.columns / component.size.cols;
+	return Number.isInteger(factor) && factor >= 1 ? factor : null;
+}
+function titleOf(title) {
+	return title === void 0 ? {} : { title };
+}
+function slug$1(value) {
+	return (value.includes(":") ? value.slice(value.indexOf(":") + 1) : value).replace(/[^a-z0-9_-]/g, "-").slice(0, 16);
+}
+function uniqueId(base, taken) {
+	if (!taken.has(base)) return base;
+	for (let n = 2;; n += 1) {
+		const candidate = `${base}-${n}`;
+		if (!taken.has(candidate)) return candidate;
+	}
+}
+function freePrefix(base, placed, taken) {
+	for (let n = 1;; n += 1) {
+		const candidate = n === 1 ? base : `${base}-${n}`;
+		if (!placed.some((p) => taken.has(`${candidate}-${p.spec.idSuffix}`))) return candidate;
+	}
+}
+/**
+* Put `component` on the layout with its top-left cell at `at`. A component
+* with a group becomes one group whose rectangle is the whole component and
+* whose members are its buttons; one without is a set of loose buttons. The
+* grid does not grow: a component that does not fit is refused `outside`, one
+* that would sit on an existing key or group `overlap`.
+*/
+function insertComponent(layout, component, at, options = {}) {
+	const rowScale = options.scale?.rows ?? 1;
+	const colScale = options.scale?.cols ?? 1;
+	const bounds = {
+		row: at.row,
+		col: at.col,
+		rowSpan: component.size.rows * rowScale,
+		colSpan: component.size.cols * colScale
+	};
+	if (!fitsGrid(layout, bounds)) return refuse("outside");
+	const specs = [...component.buttons, ...options.extras ?? []];
+	const placed = specs.map((spec) => ({
+		spec,
+		rect: {
+			row: at.row + spec.row * rowScale,
+			col: at.col + spec.col * colScale,
+			rowSpan: spec.rowSpan * rowScale,
+			colSpan: spec.colSpan * colScale
+		}
+	}));
+	const groups = layout.groups ?? [];
+	if ((component.group === null ? placed.map((p) => p.rect) : [bounds]).some((rect) => layout.buttons.some((b) => rectsOverlap(b, rect)) || groups.some((g) => rectsOverlap(g, rect)))) return refuse("overlap");
+	if (layout.buttons.length + specs.length > 200 || groups.length + (component.group === null ? 0 : 1) > 50) return refuse("too-many");
+	const base = slug$1(component.id);
+	const takenButtons = new Set(layout.buttons.map((b) => b.id));
+	const takenGroups = new Set(groups.map((g) => g.id));
+	const groupId = component.group === null ? null : uniqueId(base, takenGroups);
+	const prefix = groupId ?? freePrefix(base, placed, takenButtons);
+	const buttons = placed.map(({ spec, rect }) => ({
+		id: `${prefix}-${spec.idSuffix}`,
+		...rect,
+		role: spec.role,
+		...spec.icon === void 0 ? {} : { icon: spec.icon },
+		...spec.label === void 0 ? {} : { label: spec.label },
+		...spec.shape === void 0 ? {} : { shape: spec.shape },
+		...spec.tone === void 0 ? {} : { tone: spec.tone },
+		...groupId === null ? {} : { groupId }
+	}));
+	const group = component.group === null || groupId === null ? [] : [{
+		id: groupId,
+		componentId: component.id,
+		frame: component.group.frame,
+		...bounds,
+		...titleOf(options.title ?? component.group.title)
+	}];
+	return {
+		ok: true,
+		layout: withGroups({
+			...layout,
+			buttons: [...layout.buttons, ...buttons]
+		}, [...groups, ...group]),
+		groupId,
+		buttonIds: buttons.map((b) => b.id)
+	};
+}
+/** Move a group and every member by the same offset, atomically. */
+function moveGroup(layout, groupId, to) {
+	const groups = layout.groups ?? [];
+	const group = groups.find((g) => g.id === groupId);
+	if (group === void 0) return refuse("unknown-group");
+	const moved = {
+		...group,
+		row: to.row,
+		col: to.col
+	};
+	if (!fitsGrid(layout, moved)) return refuse("outside");
+	const dRow = to.row - group.row;
+	const dCol = to.col - group.col;
+	const isMember = (b) => b.groupId === groupId;
+	if (groups.some((g) => g.id !== groupId && rectsOverlap(g, moved)) || layout.buttons.some((b) => !isMember(b) && rectsOverlap(b, moved))) return refuse("overlap");
+	return {
+		ok: true,
+		layout: {
+			...layout,
+			buttons: layout.buttons.map((b) => isMember(b) ? {
+				...b,
+				row: b.row + dRow,
+				col: b.col + dCol
+			} : b),
+			groups: groups.map((g) => g.id === groupId ? moved : g)
+		}
+	};
+}
+/**
+* Delete a group. With `keepButtons` its members stay where they are as loose
+* keys; without, they go with it.
+*/
+function removeGroup(layout, groupId, options) {
+	const groups = layout.groups ?? [];
+	if (!groups.some((g) => g.id === groupId)) return refuse("unknown-group");
+	const buttons = options.keepButtons ? layout.buttons.map((b) => {
+		if (b.groupId !== groupId) return b;
+		const { groupId: _gone, ...rest } = b;
+		return rest;
+	}) : layout.buttons.filter((b) => b.groupId !== groupId);
+	return {
+		ok: true,
+		layout: withGroups({
+			...layout,
+			buttons
+		}, groups.filter((g) => g.id !== groupId))
+	};
+}
+/** Dissolve a group, keeping its buttons in place. */
+function ungroup(layout, groupId) {
+	return removeGroup(layout, groupId, { keepButtons: true });
+}
+//#endregion
+//#region src/remote/remote-builtin-components.ts
+var btn = (idSuffix, row, col, init) => ({
+	idSuffix,
+	row,
+	col,
+	rowSpan: 1,
+	colSpan: 1,
+	...init
+});
+function rocker(id, name, it, frame, title, buttons, size) {
+	return {
+		id,
+		name,
+		nameI18n: {
+			en: name,
+			it
+		},
+		icon: frame === "rocker-v" ? "chevrons-up-down" : "chevrons-left-right",
+		category: id.includes("channel") || id.includes("volume") ? "volume" : "navigation",
+		size,
+		group: title === null ? { frame } : {
+			frame,
+			title
+		},
+		buttons
+	};
+}
+var BUILTIN_REMOTE_COMPONENTS = [
+	{
+		id: "core:power",
+		name: "Power",
+		nameI18n: {
+			en: "Power",
+			it: "Accensione"
+		},
+		icon: "power",
+		category: "power",
+		size: {
+			rows: 1,
+			cols: 1
+		},
+		group: null,
+		buttons: [btn("power", 0, 0, {
+			role: "power",
+			shape: "round",
+			tone: "danger"
+		})]
+	},
+	{
+		id: "core:dpad",
+		name: "D-pad with OK",
+		nameI18n: {
+			en: "D-pad with OK",
+			it: "Croce direzionale con OK"
+		},
+		icon: "gamepad-2",
+		category: "navigation",
+		size: {
+			rows: 3,
+			cols: 3
+		},
+		group: { frame: "dpad" },
+		buttons: [
+			btn("up", 0, 1, { role: "up" }),
+			btn("left", 1, 0, { role: "left" }),
+			btn("ok", 1, 1, {
+				role: "ok",
+				shape: "round",
+				tone: "accent"
+			}),
+			btn("right", 1, 2, { role: "right" }),
+			btn("down", 2, 1, { role: "down" })
+		]
+	},
+	rocker("core:rocker-volume-v", "Volume rocker", "Bilanciere volume", "rocker-v", "VOL", [btn("up", 0, 0, {
+		role: "volume_up",
+		shape: "pill"
+	}), btn("down", 1, 0, {
+		role: "volume_down",
+		shape: "pill"
+	})], {
+		rows: 2,
+		cols: 1
+	}),
+	rocker("core:rocker-channel-v", "Channel rocker", "Bilanciere canali", "rocker-v", "CH", [btn("up", 0, 0, {
+		role: "channel_up",
+		shape: "pill"
+	}), btn("down", 1, 0, {
+		role: "channel_down",
+		shape: "pill"
+	})], {
+		rows: 2,
+		cols: 1
+	}),
+	rocker("core:rocker-h", "Minus / plus rocker", "Bilanciere meno / più", "rocker-h", null, [btn("minus", 0, 0, {
+		role: "custom:minus",
+		label: "−",
+		shape: "pill"
+	}), btn("plus", 0, 1, {
+		role: "custom:plus",
+		label: "+",
+		shape: "pill"
+	})], {
+		rows: 1,
+		cols: 2
+	}),
+	{
+		id: "core:keypad",
+		name: "Numeric keypad",
+		nameI18n: {
+			en: "Numeric keypad",
+			it: "Tastierino numerico"
+		},
+		icon: "grid-3x3",
+		category: "numbers",
+		size: {
+			rows: 4,
+			cols: 3
+		},
+		group: { frame: "keypad" },
+		buttons: [...Array.from({ length: 9 }, (_, i) => btn(`d${i + 1}`, Math.floor(i / 3), i % 3, { role: `digit_${i + 1}` })), btn("d0", 3, 1, { role: "digit_0" })]
+	},
+	{
+		id: "core:colour-keys",
+		name: "Colour keys",
+		nameI18n: {
+			en: "Colour keys",
+			it: "Tasti colorati"
+		},
+		icon: "palette",
+		category: "colour",
+		size: {
+			rows: 1,
+			cols: 4
+		},
+		group: null,
+		buttons: [
+			btn("red", 0, 0, {
+				role: "custom:color_red",
+				tone: "red"
+			}),
+			btn("green", 0, 1, {
+				role: "custom:color_green",
+				tone: "green"
+			}),
+			btn("yellow", 0, 2, {
+				role: "custom:color_yellow",
+				tone: "yellow"
+			}),
+			btn("blue", 0, 3, {
+				role: "custom:color_blue",
+				tone: "blue"
+			})
+		]
+	},
+	{
+		id: "core:media-transport",
+		name: "Media transport",
+		nameI18n: {
+			en: "Media transport",
+			it: "Controlli multimediali"
+		},
+		icon: "play",
+		category: "media",
+		size: {
+			rows: 1,
+			cols: 5
+		},
+		group: null,
+		buttons: [
+			btn("rewind", 0, 0, { role: "rewind" }),
+			btn("play", 0, 1, { role: "play" }),
+			btn("pause", 0, 2, { role: "pause" }),
+			btn("forward", 0, 3, { role: "fast_forward" }),
+			btn("stop", 0, 4, { role: "stop" })
+		]
+	},
+	{
+		id: "core:apps-row",
+		name: "App row",
+		nameI18n: {
+			en: "App row",
+			it: "Riga di app"
+		},
+		icon: "app-window",
+		category: "apps",
+		size: {
+			rows: 1,
+			cols: 4
+		},
+		group: null,
+		buttons: [
+			1,
+			2,
+			3,
+			4
+		].map((n) => btn(`app${n}`, 0, n - 1, { role: `custom:app_slot_${n}` }))
+	},
+	{
+		id: "core:back-home-menu",
+		name: "Back, Home, Menu",
+		nameI18n: {
+			en: "Back, Home, Menu",
+			it: "Indietro, Home, Menu"
+		},
+		icon: "house",
+		category: "navigation",
+		size: {
+			rows: 1,
+			cols: 3
+		},
+		group: null,
+		buttons: [
+			btn("back", 0, 0, { role: "back" }),
+			btn("home", 0, 1, { role: "home" }),
+			btn("menu", 0, 2, { role: "menu" })
+		]
+	},
+	{
+		id: "core:section-divider",
+		name: "Section divider",
+		nameI18n: {
+			en: "Section divider",
+			it: "Divisore di sezione"
+		},
+		icon: "separator-horizontal",
+		category: "layout",
+		size: {
+			rows: 1,
+			cols: 1
+		},
+		group: {
+			frame: "divider",
+			title: "Section"
+		},
+		buttons: []
+	},
+	{
+		id: "core:panel",
+		name: "Titled panel",
+		nameI18n: {
+			en: "Titled panel",
+			it: "Pannello con titolo"
+		},
+		icon: "panel-top",
+		category: "layout",
+		size: {
+			rows: 2,
+			cols: 3
+		},
+		group: {
+			frame: "panel",
+			title: "Panel"
+		},
+		buttons: []
+	}
+];
+/** A built-in component by id (the presets compose from these). */
+function builtinRemoteComponent(id) {
+	const found = BUILTIN_REMOTE_COMPONENTS.find((component) => component.id === id);
+	if (found === void 0) throw new Error(`no built-in remote component "${id}"`);
+	return found;
+}
+//#endregion
 //#region src/ir/ir-error.ts
 var IrCodecError = class extends Error {
 	code;
@@ -82891,465 +84348,6 @@ function numericAccept() {
 	return historyAccept("statistic").filter((field) => field.valueKind === "number");
 }
 //#endregion
-//#region src/units/unit-table.ts
-/**
-* Frozen unit → spec table. `•` in the doc marks each dimension's canonical
-* unit (`factor: 1, offset: 0`). °F derives from `°C = (°F − 32) × 5/9` ⇒
-* `factor = 5/9`, `offset = -160/9` (kept as exact expressions, not rounded
-* decimals). K derives from `°C = K − 273.15`.
-*/
-var UNIT_TABLE = {
-	"°C": {
-		dimension: "temperature",
-		factor: 1,
-		offset: 0
-	},
-	"°F": {
-		dimension: "temperature",
-		factor: 5 / 9,
-		offset: -160 / 9
-	},
-	K: {
-		dimension: "temperature",
-		factor: 1,
-		offset: -273.15
-	},
-	hPa: {
-		dimension: "pressure",
-		factor: 1,
-		offset: 0
-	},
-	kPa: {
-		dimension: "pressure",
-		factor: 10,
-		offset: 0
-	},
-	Pa: {
-		dimension: "pressure",
-		factor: .01,
-		offset: 0
-	},
-	mbar: {
-		dimension: "pressure",
-		factor: 1,
-		offset: 0
-	},
-	bar: {
-		dimension: "pressure",
-		factor: 1e3,
-		offset: 0
-	},
-	inHg: {
-		dimension: "pressure",
-		factor: 33.8639,
-		offset: 0
-	},
-	mmHg: {
-		dimension: "pressure",
-		factor: 1.33322,
-		offset: 0
-	},
-	psi: {
-		dimension: "pressure",
-		factor: 68.9476,
-		offset: 0
-	},
-	"m/s": {
-		dimension: "speed",
-		factor: 1,
-		offset: 0
-	},
-	"km/h": {
-		dimension: "speed",
-		factor: 1 / 3.6,
-		offset: 0
-	},
-	mph: {
-		dimension: "speed",
-		factor: .44704,
-		offset: 0
-	},
-	kn: {
-		dimension: "speed",
-		factor: .514444,
-		offset: 0
-	},
-	"mm/h": {
-		dimension: "precipitation-rate",
-		factor: 1,
-		offset: 0
-	},
-	"in/h": {
-		dimension: "precipitation-rate",
-		factor: 25.4,
-		offset: 0
-	},
-	m: {
-		dimension: "length",
-		factor: 1,
-		offset: 0
-	},
-	mm: {
-		dimension: "length",
-		factor: .001,
-		offset: 0
-	},
-	cm: {
-		dimension: "length",
-		factor: .01,
-		offset: 0
-	},
-	km: {
-		dimension: "length",
-		factor: 1e3,
-		offset: 0
-	},
-	in: {
-		dimension: "length",
-		factor: .0254,
-		offset: 0
-	},
-	ft: {
-		dimension: "length",
-		factor: .3048,
-		offset: 0
-	},
-	mi: {
-		dimension: "length",
-		factor: 1609.344,
-		offset: 0
-	},
-	"m²": {
-		dimension: "area",
-		factor: 1,
-		offset: 0
-	},
-	lx: {
-		dimension: "illuminance",
-		factor: 1,
-		offset: 0
-	},
-	"W/m²": {
-		dimension: "irradiance",
-		factor: 1,
-		offset: 0
-	},
-	W: {
-		dimension: "power",
-		factor: 1,
-		offset: 0
-	},
-	kW: {
-		dimension: "power",
-		factor: 1e3,
-		offset: 0
-	},
-	VA: {
-		dimension: "apparent-power",
-		factor: 1,
-		offset: 0
-	},
-	Wh: {
-		dimension: "energy",
-		factor: 1,
-		offset: 0
-	},
-	kWh: {
-		dimension: "energy",
-		factor: 1e3,
-		offset: 0
-	},
-	MWh: {
-		dimension: "energy",
-		factor: 1e6,
-		offset: 0
-	},
-	V: {
-		dimension: "voltage",
-		factor: 1,
-		offset: 0
-	},
-	mV: {
-		dimension: "voltage",
-		factor: .001,
-		offset: 0
-	},
-	A: {
-		dimension: "current",
-		factor: 1,
-		offset: 0
-	},
-	mA: {
-		dimension: "current",
-		factor: .001,
-		offset: 0
-	},
-	ppm: {
-		dimension: "concentration-volume",
-		factor: 1,
-		offset: 0
-	},
-	ppb: {
-		dimension: "concentration-volume",
-		factor: .001,
-		offset: 0
-	},
-	"µg/m³": {
-		dimension: "concentration-mass",
-		factor: 1,
-		offset: 0
-	},
-	"mg/m³": {
-		dimension: "concentration-mass",
-		factor: 1e3,
-		offset: 0
-	},
-	kg: {
-		dimension: "mass",
-		factor: 1,
-		offset: 0
-	},
-	g: {
-		dimension: "mass",
-		factor: .001,
-		offset: 0
-	},
-	lb: {
-		dimension: "mass",
-		factor: .453592,
-		offset: 0
-	},
-	oz: {
-		dimension: "mass",
-		factor: .0283495,
-		offset: 0
-	},
-	"%": {
-		dimension: "percentage",
-		factor: 1,
-		offset: 0
-	},
-	L: {
-		dimension: "volume",
-		factor: 1,
-		offset: 0
-	},
-	mL: {
-		dimension: "volume",
-		factor: .001,
-		offset: 0
-	},
-	gal: {
-		dimension: "volume",
-		factor: 3.785411784,
-		offset: 0
-	},
-	s: {
-		dimension: "duration",
-		factor: 1,
-		offset: 0
-	},
-	ms: {
-		dimension: "duration",
-		factor: .001,
-		offset: 0
-	},
-	min: {
-		dimension: "duration",
-		factor: 60,
-		offset: 0
-	},
-	h: {
-		dimension: "duration",
-		factor: 3600,
-		offset: 0
-	},
-	d: {
-		dimension: "duration",
-		factor: 86400,
-		offset: 0
-	},
-	B: {
-		dimension: "information",
-		factor: 1,
-		offset: 0
-	},
-	KiB: {
-		dimension: "information",
-		factor: 1024,
-		offset: 0
-	},
-	MiB: {
-		dimension: "information",
-		factor: 1024 ** 2,
-		offset: 0
-	},
-	GiB: {
-		dimension: "information",
-		factor: 1024 ** 3,
-		offset: 0
-	},
-	TiB: {
-		dimension: "information",
-		factor: 1024 ** 4,
-		offset: 0
-	},
-	kB: {
-		dimension: "information",
-		factor: 1e3,
-		offset: 0
-	},
-	MB: {
-		dimension: "information",
-		factor: 1e6,
-		offset: 0
-	},
-	GB: {
-		dimension: "information",
-		factor: 1e9,
-		offset: 0
-	},
-	"°": {
-		dimension: "angle",
-		factor: 1,
-		offset: 0
-	},
-	dBFS: {
-		dimension: "sound-level",
-		factor: 1,
-		offset: 0
-	},
-	dBm: {
-		dimension: "signal-level",
-		factor: 1,
-		offset: 0
-	},
-	mired: {
-		dimension: "colour-temperature",
-		factor: 1,
-		offset: 0
-	},
-	kbps: {
-		dimension: "bitrate",
-		factor: 1,
-		offset: 0
-	},
-	Mbps: {
-		dimension: "bitrate",
-		factor: 1e3,
-		offset: 0
-	},
-	fps: {
-		dimension: "rate",
-		factor: 1,
-		offset: 0
-	}
-};
-//#endregion
-//#region src/units/convert.ts
-/**
-* Pure unit-conversion API over `UNIT_TABLE`. No dependencies, no side effects.
-*
-* Conversion is refused (throws `UnitConversionError`, or returns `undefined`
-* from the `try*` variant) whenever a unit is unknown or the two units belong
-* to different dimensions — cross-dimension conversion is deliberately
-* impossible so a render override can never make the value and its unit label
-* disagree.
-*
-* Callers pass units through `normalizeUnit` (`../device/source-info.ts`) BEFORE
-* calling here — the table keys only canonical spellings.
-*/
-/** Thrown by `convertUnit` when a conversion is refused. Carries the offending
-*  units + a machine-readable `reason` for callers that branch on the cause. */
-var UnitConversionError = class extends Error {
-	from;
-	to;
-	reason;
-	constructor(from, to, reason) {
-		super(`[units] cannot convert '${from}' → '${to}': ${reason}`);
-		this.name = "UnitConversionError";
-		this.from = from;
-		this.to = to;
-		this.reason = reason;
-	}
-};
-/** Resolve a unit's `UnitSpec`, or `undefined` when the spelling is unknown. */
-function specFor(unit) {
-	return Object.hasOwn(UNIT_TABLE, unit) ? UNIT_TABLE[unit] : void 0;
-}
-/** The dimension a unit belongs to, or `undefined` for an unknown unit. */
-function unitDimension(unit) {
-	return specFor(unit)?.dimension;
-}
-/** Value in `spec`'s unit → its dimension's canonical unit. */
-function toCanonical(value, spec) {
-	return value * spec.factor + spec.offset;
-}
-/** Canonical-unit value → the unit described by `spec`. */
-function fromCanonical(canonical, spec) {
-	return (canonical - spec.offset) / spec.factor;
-}
-/**
-* Convert `value` from unit `from` to unit `to`. Identity when `from === to`.
-* Throws `UnitConversionError` when either unit is unknown or the units belong
-* to different dimensions.
-*/
-function convertUnit(value, from, to) {
-	if (from === to) return value;
-	const fromSpec = specFor(from);
-	if (!fromSpec) throw new UnitConversionError(from, to, "unknown-from");
-	const toSpec = specFor(to);
-	if (!toSpec) throw new UnitConversionError(from, to, "unknown-to");
-	if (fromSpec.dimension !== toSpec.dimension) throw new UnitConversionError(from, to, "cross-dimension");
-	return fromCanonical(toCanonical(value, fromSpec), toSpec);
-}
-/**
-* Graceful variant for the render path: returns the converted value, or
-* `undefined` when the conversion is refused (unknown unit / cross-dimension).
-* Never throws — a render caller falls back to the raw value + source unit.
-*/
-function tryConvertUnit(value, from, to) {
-	if (from === to) return value;
-	const fromSpec = specFor(from);
-	if (!fromSpec) return void 0;
-	const toSpec = specFor(to);
-	if (!toSpec) return void 0;
-	if (fromSpec.dimension !== toSpec.dimension) return void 0;
-	return fromCanonical(toCanonical(value, fromSpec), toSpec);
-}
-/**
-* Whether `value` can be converted between `from` and `to` (same dimension,
-* both known). Cheap boolean probe for the UI's same-dimension unit picker and
-* the resolver's convertibility branch — compute ONCE so a unit label and its
-* value math can never disagree.
-*/
-function canConvertUnit(from, to) {
-	if (from === to) return true;
-	const fromDim = unitDimension(from);
-	if (fromDim === void 0) return false;
-	return fromDim === unitDimension(to);
-}
-/**
-* Every known unit spelling in a dimension (table insertion order — canonical
-* unit first). Powers the UI's same-dimension unit picker.
-*/
-/**
-* Convert a difference, not a reading. Affine units (°F) shift an absolute
-* value by their offset; a step of 1°F is 5/9°C, so the offset is cancelled.
-*/
-function tryConvertDelta(value, from, to) {
-	if (from === to) return value;
-	const origin = tryConvertUnit(0, from, to);
-	const shifted = tryConvertUnit(value, from, to);
-	if (origin === void 0 || shifted === void 0) return void 0;
-	return shifted - origin;
-}
-function unitsForDimension(dimension) {
-	const out = [];
-	for (const [unit, spec] of Object.entries(UNIT_TABLE)) if (spec.dimension === dimension) out.push(unit);
-	return out;
-}
-//#endregion
 //#region src/composition/evaluate-field.ts
 /**
 * One composed field, evaluated from what its sources say NOW (D659).
@@ -96616,6 +97614,13 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		access: "create",
 		role: "admin"
 	},
+	"remoteLayoutComponents.listComponents": {
+		capName: "remote-layout-components",
+		capScope: "system",
+		addonId: null,
+		access: "view",
+		role: "admin"
+	},
 	"runningState.getStatus": {
 		capName: "running-state",
 		capScope: "device",
@@ -98979,6 +99984,7 @@ var KNOWN_CAP_NAMES = [
 	"recording-signal",
 	"records",
 	"remote",
+	"remote-layout-components",
 	"running-state",
 	"scene-monitor",
 	"script-runner",
@@ -99199,6 +100205,7 @@ var SYSTEM_CAP_NAMES = [
 	"recording-export",
 	"records",
 	"remote",
+	"remote-layout-components",
 	"server-management",
 	"settings-store",
 	"smtp-provider",
@@ -101058,7 +102065,8 @@ var APPLIANCE_CAP_VOCABULARY = {
 						min: 4,
 						max: 200,
 						step: 1,
-						unit: "g"
+						unit: "g",
+						quantity: "mass"
 					},
 					optional: true
 				}]
@@ -101077,7 +102085,8 @@ var APPLIANCE_CAP_VOCABULARY = {
 						min: 4,
 						max: 200,
 						step: 1,
-						unit: "g"
+						unit: "g",
+						quantity: "mass"
 					},
 					optional: true
 				}, {
@@ -101088,7 +102097,8 @@ var APPLIANCE_CAP_VOCABULARY = {
 						min: 4,
 						max: 200,
 						step: 1,
-						unit: "g"
+						unit: "g",
+						quantity: "mass"
 					},
 					optional: true
 				}]
@@ -103194,6 +104204,7 @@ var SYSTEM_CAP_VOCABULARY = {
 	"recording-export": system("recording exports — requested from the timeline, not an automation step"),
 	records: system(INTERNAL),
 	remote: system("the per-device remote setup — authored in the Customize remote editor, sent through the remote UI"),
+	"remote-layout-components": system("the palette of the remote template editor — read-only data, never actuated"),
 	"server-management": system(CLUSTER),
 	"settings-store": system(INTERNAL),
 	"smtp-provider": system(INTERNAL),
@@ -105181,6 +106192,7 @@ var CAPABILITY_NAMES = {
 	recordingSignal: "recording-signal",
 	records: "records",
 	remote: "remote",
+	remoteLayoutComponents: "remote-layout-components",
 	runningState: "running-state",
 	sceneMonitor: "scene-monitor",
 	scriptRunner: "script-runner",
@@ -105820,6 +106832,10 @@ var CAPABILITY_ROUTER_KEYS = [
 		key: "remote",
 		name: "remote"
 	},
+	{
+		key: "remoteLayoutComponents",
+		name: "remote-layout-components"
+	},
 	{
 		key: "runningState",
 		name: "running-state"
@@ -106155,6 +107171,7 @@ var ALL_CAPABILITY_DEFINITIONS = [
 	recordingSignalCapability,
 	recordsCapability,
 	remoteCapability,
+	remoteLayoutComponentsCapability,
 	runningStateCapability,
 	sceneMonitorCapability,
 	scriptRunnerCapability,
@@ -110945,6 +111962,7 @@ function createSystemProxy(api) {
 			sendCommand: (input) => dispatch("remote", "sendCommand", "mutation", input),
 			sendMediaCommand: (input) => dispatch("remote", "sendMediaCommand", "mutation", input)
 		},
+		remoteLayoutComponents: { listComponents: (input) => dispatch("remoteLayoutComponents", "listComponents", "query", input) },
 		serverManagement: {
 			getServerPackageStatus: (input) => dispatch("serverManagement", "getServerPackageStatus", "query", input),
 			checkServerUpdate: (input) => dispatch("serverManagement", "checkServerUpdate", "mutation", input),
@@ -115180,8 +116198,6 @@ var NC_TEMPLATE_VARS = [
 * delete it from here then, and the served catalog names it again.
 */
 var NC_TEMPLATE_HELD_BACK_SYSTEM_EVENT_KINDS = [
-	"node-restarting",
-	"node-updating",
 	"alert-critical",
 	"alert-error",
 	"alert-critical-resolved",
@@ -122025,6 +123041,7 @@ exports.BENCH_ROOT_STEP_ID = BENCH_ROOT_STEP_ID;
 exports.BINARY_AGGREGATES = require_composition.BINARY_AGGREGATES;
 exports.BIRTH_DECISION_DEFAULT_LIMIT = BIRTH_DECISION_DEFAULT_LIMIT;
 exports.BOOT_RECOVERY_BACKOFF_MS = require_sleep.BOOT_RECOVERY_BACKOFF_MS;
+exports.BUILTIN_REMOTE_COMPONENTS = BUILTIN_REMOTE_COMPONENTS;
 exports.BUILTIN_RESULT_KINDS = BUILTIN_RESULT_KINDS;
 exports.BackgroundRunRegistry = BackgroundRunRegistry;
 exports.BacklightModeSchema = BacklightModeSchema;
@@ -122753,6 +123770,7 @@ exports.KeychainWriteRefusedError = require_sleep.KeychainWriteRefusedError;
 exports.LABEL_SUPPLY_MACRO = LABEL_SUPPLY_MACRO;
 exports.LABEL_SUPPLY_STEP_IDS = LABEL_SUPPLY_STEP_IDS;
 exports.LABEL_SUPPLY_VOCABULARIES = LABEL_SUPPLY_VOCABULARIES;
+exports.LAYOUT_EDIT_REFUSALS = LAYOUT_EDIT_REFUSALS;
 exports.LEGACY_READ_ONLY_CONFIG_KEY = LEGACY_READ_ONLY_CONFIG_KEY;
 exports.LIGHT_SHARED_CAPS = LIGHT_SHARED_CAPS;
 exports.LINKED_DEVICES_SLOT = LINKED_DEVICES_SLOT;
@@ -122859,6 +123877,7 @@ exports.MAX_BIRTH_LATENCY_PROXY_MS = MAX_BIRTH_LATENCY_PROXY_MS;
 exports.MAX_CAMERA_SENSORS = MAX_CAMERA_SENSORS;
 exports.MAX_CLIP_EVENT_IDS = MAX_CLIP_EVENT_IDS;
 exports.MAX_CLIP_LABELS = MAX_CLIP_LABELS;
+exports.MAX_COMPONENT_BUTTONS = MAX_COMPONENT_BUTTONS;
 exports.MAX_COMPOSITION_CODE_LENGTH = require_composition.MAX_COMPOSITION_CODE_LENGTH;
 exports.MAX_COMPOSITION_FEATURES = require_composition.MAX_COMPOSITION_FEATURES;
 exports.MAX_COMPOSITION_FIELDS_PER_FEATURE = require_composition.MAX_COMPOSITION_FIELDS_PER_FEATURE;
@@ -122872,6 +123891,7 @@ exports.MAX_EXPRESSION_EVAL_STEPS = require_composition.MAX_EXPRESSION_EVAL_STEP
 exports.MAX_EXPRESSION_SOURCE_LENGTH = require_composition.MAX_EXPRESSION_SOURCE_LENGTH;
 exports.MAX_HELPER_MEMBERS = require_composition.MAX_HELPER_MEMBERS;
 exports.MAX_KEYS = MAX_KEYS;
+exports.MAX_LAYOUT_GROUPS = MAX_LAYOUT_GROUPS;
 exports.MAX_LAYOUT_SPAN = MAX_LAYOUT_SPAN;
 exports.MAX_REASONS_PER_KEY = MAX_REASONS_PER_KEY;
 exports.MAX_REMOTE_BINDINGS = MAX_REMOTE_BINDINGS;
@@ -123395,6 +124415,8 @@ exports.PtzPresetFunctionSchema = PtzPresetFunctionSchema;
 exports.PtzPresetSchema = PtzPresetSchema;
 exports.PtzStatusSchema = PtzStatusSchema;
 exports.QUANTITY_BASE = require_sleep.QUANTITY_BASE;
+exports.QuantityUnitError = QuantityUnitError;
+exports.QuantityValueSchema = QuantityValueSchema;
 exports.QueryFilterSchema = QueryFilterSchema;
 exports.RATE_CONTROL_RELAXED = RATE_CONTROL_RELAXED;
 exports.RATE_CONTROL_TIGHT = RATE_CONTROL_TIGHT;
@@ -123438,8 +124460,12 @@ exports.RECOVERY_VIEW_PX = RECOVERY_VIEW_PX;
 exports.REDACTED_SECRET = require_sleep.REDACTED_SECRET;
 exports.REFERENCE_COMPUTE = REFERENCE_COMPUTE;
 exports.REFERENCE_MATCH_FRACTION = REFERENCE_MATCH_FRACTION;
+exports.REMOTE_BUTTON_SHAPES = REMOTE_BUTTON_SHAPES;
+exports.REMOTE_BUTTON_TONES = REMOTE_BUTTON_TONES;
+exports.REMOTE_COMPONENT_CATEGORIES = REMOTE_COMPONENT_CATEGORIES;
 exports.REMOTE_CONFIG_REFUSALS = REMOTE_CONFIG_REFUSALS;
 exports.REMOTE_CUSTOM_ROLE_PREFIX = REMOTE_CUSTOM_ROLE_PREFIX;
+exports.REMOTE_GROUP_FRAMES = REMOTE_GROUP_FRAMES;
 exports.REMOTE_KNOWN_ROLES = REMOTE_KNOWN_ROLES;
 exports.REMOTE_MAX_REPEAT = REMOTE_MAX_REPEAT;
 exports.REMOTE_MEDIA_COMMANDS = REMOTE_MEDIA_COMMANDS;
@@ -123558,10 +124584,17 @@ exports.RemoteAssumedStateSchema = RemoteAssumedStateSchema;
 exports.RemoteBindingActionSchema = RemoteBindingActionSchema;
 exports.RemoteBindingSchema = RemoteBindingSchema;
 exports.RemoteBoundCommandSchema = RemoteBoundCommandSchema;
+exports.RemoteButtonShapeSchema = RemoteButtonShapeSchema;
+exports.RemoteButtonToneSchema = RemoteButtonToneSchema;
 exports.RemoteCommandListSchema = RemoteCommandListSchema;
+exports.RemoteComponentButtonSchema = RemoteComponentButtonSchema;
+exports.RemoteComponentCategorySchema = RemoteComponentCategorySchema;
 exports.RemoteConfigSchema = RemoteConfigSchema;
 exports.RemoteCustomButtonSchema = RemoteCustomButtonSchema;
+exports.RemoteGroupFrameSchema = RemoteGroupFrameSchema;
 exports.RemoteLayoutButtonSchema = RemoteLayoutButtonSchema;
+exports.RemoteLayoutComponentSchema = RemoteLayoutComponentSchema;
+exports.RemoteLayoutGroupSchema = RemoteLayoutGroupSchema;
 exports.RemoteLayoutPayloadSchema = RemoteLayoutPayloadSchema;
 exports.RemoteMediaCommandResultSchema = RemoteMediaCommandResultSchema;
 exports.RemoteMediaCommandSchema = RemoteMediaCommandSchema;
@@ -123937,6 +124970,7 @@ exports.UninstallNodeOutcomeSchema = UninstallNodeOutcomeSchema;
 exports.UninstallNodeResultSchema = UninstallNodeResultSchema;
 exports.UninstallPackageResultSchema = UninstallPackageResultSchema;
 exports.UnitConversionError = UnitConversionError;
+exports.UnitWarningSchema = UnitWarningSchema;
 exports.UnknownRecordKindError = require_sleep.UnknownRecordKindError;
 exports.UnreleasedClaimSchema = UnreleasedClaimSchema;
 exports.UnstampedEventMediaCountSchema = UnstampedEventMediaCountSchema;
@@ -124100,6 +125134,7 @@ exports.autoAssignProfiles = autoAssignProfiles;
 exports.automationControlCapability = automationControlCapability;
 exports.backupCapability = backupCapability;
 exports.bareAddonId = bareAddonId;
+exports.baseUnitForQuantity = baseUnitForQuantity;
 exports.baseUnitOf = require_sleep.baseUnitOf;
 exports.batteryCapability = batteryCapability;
 exports.bestLocationMatch = bestLocationMatch;
@@ -124131,6 +125166,7 @@ exports.buildTriggerTrace = buildTriggerTrace;
 exports.buildVideoArgs = require_composition.buildVideoArgs;
 exports.buildViewerLink = buildViewerLink;
 exports.builtCapabilityBlockers = builtCapabilityBlockers;
+exports.builtinRemoteComponent = builtinRemoteComponent;
 exports.bundledCamstack = bundledCamstack;
 exports.buttonCapability = buttonCapability;
 exports.calendarEventLocalSpan = calendarEventLocalSpan;
@@ -124148,6 +125184,7 @@ exports.canConvertUnit = canConvertUnit;
 exports.canonicalEgressPlan = canonicalEgressPlan;
 exports.canonicalIconKey = canonicalIconKey;
 exports.canonicalizeAppCallback = canonicalizeAppCallback;
+exports.capUnitResolver = capUnitResolver;
 exports.capabilityScopesOf = capabilityScopesOf;
 exports.capacityForModel = capacityForModel;
 exports.capacitySessionsOf = capacitySessionsOf;
@@ -124230,6 +125267,7 @@ exports.contactCapability = contactCapability;
 exports.containingParentIndex = containingParentIndex;
 exports.controlCapability = controlCapability;
 exports.convertPresetFeature = convertPresetFeature;
+exports.convertQuantityInput = convertQuantityInput;
 exports.convertUnit = convertUnit;
 exports.convertUnitTargets = convertUnitTargets;
 exports.coralUsableUnits = coralUsableUnits;
@@ -124418,6 +125456,7 @@ exports.fieldReads = require_composition.fieldReads;
 exports.fieldUnitKeys = fieldUnitKeys;
 exports.fieldsPinnedAtValueBelow = fieldsPinnedAtValueBelow;
 exports.filesystemBrowseCapability = filesystemBrowseCapability;
+exports.fillWidthScale = fillWidthScale;
 exports.findCandidateCycles = findCandidateCycles;
 exports.findCompositionCycles = findCompositionCycles;
 exports.findTimezone = findTimezone;
@@ -124482,6 +125521,7 @@ exports.inferExpressionKinds = inferExpressionKinds;
 exports.inferModelProvider = inferModelProvider;
 exports.ingestReading = ingestReading;
 exports.initialPoolMemoryState = initialPoolMemoryState;
+exports.insertComponent = insertComponent;
 exports.integralCadenceMs = require_composition.integralCadenceMs;
 exports.integralDraft = integralDraft;
 exports.integrateReading = require_composition.integrateReading;
@@ -124545,6 +125585,7 @@ exports.isObjectInput = isObjectInput;
 exports.isOccupancyRule = isOccupancyRule;
 exports.isOwnerOnlyEventCategory = require_event_category.isOwnerOnlyEventCategory;
 exports.isPlugApplianceType = isPlugApplianceType;
+exports.isQuantityValue = isQuantityValue;
 exports.isReadingQuantity = require_sleep.isReadingQuantity;
 exports.isRemoteCustomKey = isRemoteCustomKey;
 exports.isRemoteKnownRole = isRemoteKnownRole;
@@ -124660,6 +125701,7 @@ exports.motionDetectionCapability = motionDetectionCapability;
 exports.motionSourceLabel = motionSourceLabel;
 exports.motionTriggerCapability = motionTriggerCapability;
 exports.motionZonesCapability = motionZonesCapability;
+exports.moveGroup = moveGroup;
 exports.mqttBrokerCapability = mqttBrokerCapability;
 exports.nativeObjectDetectionCapability = nativeObjectDetectionCapability;
 exports.navigationCapability = navigationCapability;
@@ -124675,12 +125717,15 @@ exports.nodePickerItems = nodePickerItems;
 exports.nodePin = require_sleep.nodePin;
 exports.nodeRemovalHookCapability = nodeRemovalHookCapability;
 exports.nodesCapability = nodesCapability;
+exports.normalizeActionUnits = normalizeActionUnits;
 exports.normalizeAddonInitResult = require_sleep.normalizeAddonInitResult;
 exports.normalizeAudioLabel = normalizeAudioLabel;
+exports.normalizeConditionUnits = normalizeConditionUnits;
 exports.normalizeCoreBlockWrite = normalizeCoreBlockWrite;
 exports.normalizeNcMediaPolicy = normalizeNcMediaPolicy;
 exports.normalizeNodeId = require_sleep.normalizeNodeId;
 exports.normalizeOrigin = normalizeOrigin;
+exports.normalizeRecipeUnits = normalizeRecipeUnits;
 exports.normalizeSecretOwner = require_sleep.normalizeSecretOwner;
 exports.normalizeTokenScopes = normalizeTokenScopes;
 exports.normalizeUnit = normalizeUnit;
@@ -124712,6 +125757,8 @@ exports.paletteFromStored = paletteFromStored;
 exports.paletteLegend = paletteLegend;
 exports.paletteResultSchema = paletteResultSchema;
 exports.paletteSwatchSchema = paletteSwatchSchema;
+exports.paramMeta = paramMeta;
+exports.paramMetaOf = paramMetaOf;
 exports.parseAcceleratorFactsJson = parseAcceleratorFactsJson;
 exports.parseAdminBase = parseAdminBase;
 exports.parseAlertEpisodePayload = parseAlertEpisodePayload;
@@ -124833,12 +125880,16 @@ exports.recordingOnboardCapability = recordingOnboardCapability;
 exports.recordingSignalCapability = recordingSignalCapability;
 exports.recordsCapability = recordsCapability;
 exports.recordsErrorFromMessage = require_sleep.recordsErrorFromMessage;
+exports.rectContains = rectContains;
+exports.rectsOverlap = rectsOverlap;
 exports.rectsToCells = rectsToCells;
 exports.reducePoints = reducePoints;
 exports.reducerForActive = reducerForActive;
 exports.registerKnownSecret = require_sleep.registerKnownSecret;
 exports.remapCropDetections = remapCropDetections;
 exports.remoteCapability = remoteCapability;
+exports.remoteLayoutComponentsCapability = remoteLayoutComponentsCapability;
+exports.removeGroup = removeGroup;
 exports.removeScalarTarget = removeScalarTarget;
 exports.renameAlarmProfile = renameAlarmProfile;
 exports.renderVocabPhrase = renderVocabPhrase;
@@ -125094,9 +126145,11 @@ exports.transformSecretWrite = require_sleep.transformSecretWrite;
 exports.tryConvertDelta = tryConvertDelta;
 exports.tryConvertUnit = tryConvertUnit;
 exports.turnProviderCapability = turnProviderCapability;
+exports.ungroup = ungroup;
 exports.unitCompanionField = unitCompanionField;
 exports.unitDimension = unitDimension;
 exports.unitsForDimension = unitsForDimension;
+exports.unitsForQuantity = unitsForQuantity;
 exports.unreachableExtensionSlotRow = unreachableExtensionSlotRow;
 exports.unwrapSchema = unwrapSchema;
 exports.updateCapability = updateCapability;