@camstack/addon-provider-homeassistant 1.2.625 → 1.2.627

package/dist/{dist-oNUlRdur.js → dist-CRwUHjY7.js}

@@ -5567,7 +5567,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-BErAxhul.mjs
+//#region ../types/dist/sleep-B81gwQuR.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -8309,6 +8309,102 @@ function defineEntryKind(name, spec) {
 	if (defined === void 0) throw new DeclarationRefusedError(`entry kind "${name}" was not built`);
 	return defined;
 }
+var READING_QUANTITIES = [
+	"temperature",
+	"pressure",
+	"speed",
+	"precipitation",
+	"precipitation-rate",
+	"length",
+	"area",
+	"illuminance",
+	"irradiance",
+	"power",
+	"energy",
+	"voltage",
+	"current",
+	"apparent-power",
+	"humidity",
+	"percentage",
+	"concentration-volume",
+	"concentration-mass",
+	"concentration-ppb",
+	"volume",
+	"duration",
+	"duration-ms",
+	"information",
+	"sound-level",
+	"signal-level",
+	"colour-temperature",
+	"angle",
+	"bitrate",
+	"rate",
+	"mass",
+	"index",
+	"ratio",
+	"count",
+	"none",
+	"device"
+];
+var ReadingQuantitySchema = _enum(READING_QUANTITIES);
+var QUANTITY_SET = new Set(READING_QUANTITIES);
+function isReadingQuantity(value) {
+	return typeof value === "string" && QUANTITY_SET.has(value);
+}
+/**
+* Stored unit symbol for a quantity. `none` means the number is dimensionless
+* (or an index / ratio / count). `device` means the cap has no single unit.
+*/
+var QUANTITY_BASE = {
+	temperature: "°C",
+	pressure: "hPa",
+	speed: "m/s",
+	precipitation: "mm",
+	"precipitation-rate": "mm/h",
+	length: "m",
+	area: "m²",
+	illuminance: "lx",
+	irradiance: "W/m²",
+	power: "W",
+	energy: "kWh",
+	voltage: "V",
+	current: "A",
+	"apparent-power": "VA",
+	humidity: "%",
+	percentage: "%",
+	"concentration-volume": "ppm",
+	"concentration-mass": "µg/m³",
+	"concentration-ppb": "ppb",
+	volume: "L",
+	duration: "s",
+	"duration-ms": "ms",
+	information: "B",
+	"sound-level": "dBFS",
+	"signal-level": "dBm",
+	"colour-temperature": "mired",
+	angle: "°",
+	bitrate: "kbps",
+	rate: "fps",
+	mass: "kg",
+	index: "none",
+	ratio: "none",
+	count: "none",
+	none: "none",
+	device: "device"
+};
+/** The stored unit, or `undefined` when the quantity has no unit symbol. */
+function baseUnitOf(quantity) {
+	const symbol = QUANTITY_BASE[quantity];
+	if (symbol === "none" || symbol === "device") return void 0;
+	return symbol;
+}
+function readingMeta(quantity, extras) {
+	return {
+		quantity,
+		...extras?.precision !== void 0 ? { precision: extras.precision } : {},
+		...extras?.label !== void 0 ? { label: extras.label } : {}
+	};
+}
 /** Shared Zod schemas used across streaming capabilities. */
 var CamProfileSchema = _enum([
 	"high",
@@ -8336,8 +8432,8 @@ var CamStreamKindSchema = _enum([
 	"derived"
 ]);
 var CamStreamResolutionSchema = object({
-	width: number().int().positive(),
-	height: number().int().positive()
+	width: number().int().positive().meta(readingMeta("none")),
+	height: number().int().positive().meta(readingMeta("none"))
 });
 var CameraStreamSchema = object({
 	/** Stable, provider-assigned id unique within the (deviceId) scope. */
@@ -8914,6 +9010,7 @@ var CAP_NAMES = Object.freeze([
 	"filesystem-browse",
 	"flood",
 	"gas",
+	"group-status",
 	"heating-valve",
 	"humidifier",
 	"humidity-sensor",
@@ -9043,14 +9140,6 @@ Object.freeze({
 		{
 			"path": "aqi",
 			"valueType": "number"
-		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
 		}
 	],
 	"alarm-panel": [
@@ -9086,20 +9175,10 @@ Object.freeze({
 			"valueType": "boolean"
 		}
 	],
-	"ambient-light-sensor": [
-		{
-			"path": "lux",
-			"valueType": "number"
-		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
-		}
-	],
+	"ambient-light-sensor": [{
+		"path": "lux",
+		"valueType": "number"
+	}],
 	"audio-metrics": [
 		{
 			"path": "ts",
@@ -9179,6 +9258,10 @@ Object.freeze({
 			"path": "lastUpdated",
 			"valueType": "number"
 		},
+		{
+			"path": "volts",
+			"valueType": "number"
+		},
 		{
 			"path": "lastContactAt",
 			"valueType": "number"
@@ -9421,10 +9504,6 @@ Object.freeze({
 				"datetime"
 			]
 		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
 		{
 			"path": "min",
 			"valueType": "number"
@@ -9436,19 +9515,6 @@ Object.freeze({
 		{
 			"path": "step",
 			"valueType": "number"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
-		},
-		{
-			"path": "format",
-			"valueType": "enum",
-			"enumValues": [
-				"date",
-				"time",
-				"datetime"
-			]
 		}
 	],
 	"cover": [
@@ -9689,13 +9755,8 @@ Object.freeze({
 		"path": "value",
 		"valueType": "string"
 	}, {
-		"path": "format",
-		"valueType": "enum",
-		"enumValues": [
-			"date",
-			"time",
-			"datetime"
-		]
+		"path": "timestamp",
+		"valueType": "boolean"
 	}],
 	"event-emitter": [
 		{
@@ -9768,6 +9829,20 @@ Object.freeze({
 		"path": "detected",
 		"valueType": "boolean"
 	}],
+	"group-status": [
+		{
+			"path": "included",
+			"valueType": "number"
+		},
+		{
+			"path": "excluded",
+			"valueType": "number"
+		},
+		{
+			"path": "total",
+			"valueType": "number"
+		}
+	],
 	"heating-valve": [{
 		"path": "position",
 		"valueType": "number"
@@ -9802,20 +9877,10 @@ Object.freeze({
 			"valueType": "number"
 		}
 	],
-	"humidity-sensor": [
-		{
-			"path": "percent",
-			"valueType": "number"
-		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
-		}
-	],
+	"humidity-sensor": [{
+		"path": "percent",
+		"valueType": "number"
+	}],
 	"image": [{
 		"path": "url",
 		"valueType": "string"
@@ -10154,20 +10219,10 @@ Object.freeze({
 			"valueType": "boolean"
 		}
 	],
-	"numeric-sensor": [
-		{
-			"path": "value",
-			"valueType": "number"
-		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
-		}
-	],
+	"numeric-sensor": [{
+		"path": "value",
+		"valueType": "number"
+	}],
 	"pet-feeder": [
 		{
 			"path": "foodLevel",
@@ -10259,14 +10314,6 @@ Object.freeze({
 		{
 			"path": "powerFactor",
 			"valueType": "number"
-		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
 		}
 	],
 	"presence": [
@@ -10295,20 +10342,10 @@ Object.freeze({
 			"valueType": "number"
 		}
 	],
-	"pressure-sensor": [
-		{
-			"path": "hpa",
-			"valueType": "number"
-		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
-		}
-	],
+	"pressure-sensor": [{
+		"path": "hpa",
+		"valueType": "number"
+	}],
 	"privacy-mask": [{
 		"path": "enabled",
 		"valueType": "boolean"
@@ -10619,20 +10656,10 @@ Object.freeze({
 		"path": "tampered",
 		"valueType": "boolean"
 	}],
-	"temperature-sensor": [
-		{
-			"path": "celsius",
-			"valueType": "number"
-		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
-		}
-	],
+	"temperature-sensor": [{
+		"path": "celsius",
+		"valueType": "number"
+	}],
 	"update": [
 		{
 			"path": "currentVersion",
@@ -10743,10 +10770,6 @@ Object.freeze({
 			"path": "temperature",
 			"valueType": "number"
 		},
-		{
-			"path": "temperatureUnit",
-			"valueType": "string"
-		},
 		{
 			"path": "humidity",
 			"valueType": "number"
@@ -10755,18 +10778,10 @@ Object.freeze({
 			"path": "pressure",
 			"valueType": "number"
 		},
-		{
-			"path": "pressureUnit",
-			"valueType": "string"
-		},
 		{
 			"path": "windSpeed",
 			"valueType": "number"
 		},
-		{
-			"path": "windSpeedUnit",
-			"valueType": "string"
-		},
 		{
 			"path": "windBearing",
 			"valueType": "number"
@@ -11169,7 +11184,7 @@ function errMsg(err) {
 	return String(err);
 }
 //#endregion
-//#region ../types/dist/composition-kEl9mevu.mjs
+//#region ../types/dist/composition-B85l9j1M.mjs
 /**
 * The ffmpeg build every CamStack node downloads, per platform and arch.
 *
@@ -11924,15 +11939,67 @@ function validateExpressionSource(src) {
 	}
 	return null;
 }
-/** A composed device's stableId is this prefix plus the block id. */
-var COMPOSED_DEVICE_STABLE_ID_PREFIX = "composed-";
-/** Longest snippet a `code` source may carry (slice 4). */
-var MAX_COMPOSITION_CODE_LENGTH = 2e4;
+/**
+* A composition source identity: `(addonId, stableId)`, never a numeric device
+* id. Split out so helper schemas can name it without a cycle through
+* `composition.ts` (D659).
+*/
 var CompositionSourceRefSchema = object({
 	/** The owning addon; `stableId` is unique only within it. */
 	addonId: string().min(1),
 	stableId: string().min(1)
 });
+var GROUP_TEMPLATE_IDS = [
+	"temperature",
+	"humidity",
+	"pressure",
+	"illuminance",
+	"power",
+	"energy",
+	"battery",
+	"numeric",
+	"motion",
+	"contact",
+	"leak",
+	"smoke",
+	"occupancy",
+	"binary"
+];
+var NUMERIC_AGGREGATES = [
+	"mean",
+	"median",
+	"min",
+	"max",
+	"sum"
+];
+var BINARY_AGGREGATES = ["any", "all"];
+var AGGREGATE_REDUCERS = [
+	"mean",
+	"median",
+	"min",
+	"max",
+	"sum",
+	"any",
+	"all"
+];
+var GroupTemplateIdSchema = _enum(GROUP_TEMPLATE_IDS);
+var AggregateReducerSchema = _enum(AGGREGATE_REDUCERS);
+/** One member. The field is stored so occupancy can name motion or binary. */
+var HelperMemberSchema = object({
+	source: CompositionSourceRefSchema,
+	cap: string().min(1),
+	fieldPath: string().min(1)
+});
+var HelperSpecSchema = discriminatedUnion("kind", [object({
+	kind: literal("group"),
+	templateId: GroupTemplateIdSchema,
+	aggregate: AggregateReducerSchema,
+	members: array(HelperMemberSchema).min(1).max(64)
+})]);
+/** A composed device's stableId is this prefix plus the block id. */
+var COMPOSED_DEVICE_STABLE_ID_PREFIX = "composed-";
+/** Longest snippet a `code` source may carry (slice 4). */
+var MAX_COMPOSITION_CODE_LENGTH = 2e4;
 /** One field of one capability of one source device. */
 var CompositionFieldReadSchema = object({
 	source: CompositionSourceRefSchema,
@@ -11976,7 +12043,33 @@ var CompositionCodeSourceSchema = object({
 var CompositionFieldSourceSchema = discriminatedUnion("kind", [
 	CompositionFromSourceSchema,
 	CompositionExpressionSourceSchema,
-	CompositionCodeSourceSchema
+	CompositionCodeSourceSchema,
+	object({
+		kind: literal("aggregate"),
+		reducer: _enum([
+			"mean",
+			"median",
+			"min",
+			"max",
+			"sum",
+			"any",
+			"all"
+		]),
+		reads: array(CompositionFieldReadSchema).min(1).max(64),
+		/** `value` is the reading; the others are the member counts. */
+		publish: _enum([
+			"value",
+			"included",
+			"excluded",
+			"total"
+		]),
+		/** What a `value` publish does when nobody is included. Counts ignore this. */
+		empty: _enum([
+			"null",
+			"omit",
+			"offline"
+		])
+	})
 ]);
 var CompositionCommandTargetSchema = discriminatedUnion("kind", [object({
 	kind: literal("forward"),
@@ -12022,7 +12115,13 @@ var CompositionSchema = object({
 		kind: literal("existing"),
 		device: CompositionSourceRefSchema
 	})]),
-	features: array(CompositionFeatureSchema).min(1).max(16)
+	features: array(CompositionFeatureSchema).min(1).max(16),
+	/**
+	* Present when the block is a helper template. Absent on a free
+	* composition (the room example, device 4603). The editor reads this,
+	* never the compiled features.
+	*/
+	helper: HelperSpecSchema.optional()
 }).superRefine((composition, ctx) => {
 	const seen = /* @__PURE__ */ new Set();
 	composition.features.forEach((feature, index) => {
@@ -18442,7 +18541,11 @@ var CompositionProblemSchema = object({
 		"item-field-reserved",
 		"target-missing",
 		"target-unreadable",
-		"not-replaceable"
+		"not-replaceable",
+		"native-capability-replace",
+		"mixed-quantity",
+		"helper-mismatch",
+		"member-constraint"
 	]),
 	path: string(),
 	message: string()
@@ -18463,7 +18566,8 @@ var CompositionUnavailableModeSchema = _enum([
 	"null",
 	"offline",
 	"unknown",
-	"release"
+	"release",
+	"omit"
 ]);
 /**
 * `derived` reads a source · `clock` reads only `now`, recomputed when a sibling
@@ -18500,9 +18604,11 @@ var CompositionFieldPlanSchema = object({
 	reads: array(CompositionFieldReadSchema)
 });
 /**
-* What a feature does to its target (D663): `new` builds a capability on a new
-* device; on an existing device it `add`s a capability the device lacks, or
-* `replace`s named fields of one it has natively.
+* What a feature does to its target (D663, D944): `new` builds a capability on a
+* new device; on an existing device it `add`s a capability the device lacks.
+* Replacing a capability the device already serves is refused
+* (`native-capability-replace`), not planned. `replace` remains on the claim
+* wire for a claim the hub already holds.
 */
 var CompositionFeatureModeSchema = _enum([
 	"new",
@@ -18675,6 +18781,235 @@ Object.freeze({
 		result: ["number", "null"]
 	}
 });
+/**
+* One catalog row per base reading a group helper can build (D944 §3).
+* Data, not a form default written into the block.
+*/
+var NOW = {
+	fieldPath: "lastFetchedAt",
+	expr: "now"
+};
+var CHANGED = {
+	fieldPath: "lastChangedAt",
+	expr: "now"
+};
+function numeric(input) {
+	return {
+		...input,
+		family: "numeric",
+		deviceType: DeviceType.Sensor,
+		memberDeviceType: DeviceType.Sensor,
+		baseUnit: baseUnitOf(input.quantity),
+		aggregates: NUMERIC_AGGREGATES,
+		accept: [{
+			cap: input.outputCap,
+			fieldPath: input.outputField
+		}]
+	};
+}
+function binary(input) {
+	return {
+		...input,
+		family: "binary",
+		deviceType: DeviceType.Sensor,
+		memberDeviceType: DeviceType.Sensor,
+		quantity: "none",
+		baseUnit: void 0,
+		aggregates: BINARY_AGGREGATES,
+		empty: "offline"
+	};
+}
+var GROUP_TEMPLATES = [
+	numeric({
+		id: "temperature",
+		summary: "Mean, median, min, max or sum of temperatures. Offline and unknown members are left out, never read as 0 °C.",
+		role: DeviceRole.TemperatureSensor,
+		outputCap: "temperature-sensor",
+		outputField: "celsius",
+		quantity: "temperature",
+		defaultAggregate: "mean",
+		empty: "null",
+		companions: [NOW]
+	}),
+	numeric({
+		id: "humidity",
+		summary: "Humidity in percent. Offline and unknown members are left out, never read as 0 %.",
+		role: DeviceRole.HumiditySensor,
+		outputCap: "humidity-sensor",
+		outputField: "percent",
+		quantity: "humidity",
+		defaultAggregate: "mean",
+		empty: "null",
+		companions: [NOW]
+	}),
+	numeric({
+		id: "pressure",
+		summary: "Pressure in hectopascals. Offline and unknown members are left out, never read as 0 hPa.",
+		role: DeviceRole.PressureSensor,
+		outputCap: "pressure-sensor",
+		outputField: "hpa",
+		quantity: "pressure",
+		defaultAggregate: "mean",
+		empty: "null",
+		companions: [NOW]
+	}),
+	numeric({
+		id: "illuminance",
+		summary: "Illuminance in lux. Offline and unknown members are left out, never read as 0 lx.",
+		role: DeviceRole.AmbientLightSensor,
+		outputCap: "ambient-light-sensor",
+		outputField: "lux",
+		quantity: "illuminance",
+		defaultAggregate: "mean",
+		empty: "null",
+		companions: [NOW]
+	}),
+	numeric({
+		id: "power",
+		summary: "Power in watts, summed by default. Nobody reporting omits the key rather than writing 0 W.",
+		role: DeviceRole.PowerSensor,
+		outputCap: "power-meter",
+		outputField: "watts",
+		quantity: "power",
+		defaultAggregate: "sum",
+		empty: "omit",
+		companions: [NOW]
+	}),
+	numeric({
+		id: "energy",
+		summary: "Energy in kilowatt-hours, summed by default. Nobody reporting omits the key rather than writing 0 kWh.",
+		role: DeviceRole.EnergySensor,
+		outputCap: "power-meter",
+		outputField: "kwhTotal",
+		quantity: "energy",
+		defaultAggregate: "sum",
+		empty: "omit",
+		companions: [NOW]
+	}),
+	numeric({
+		id: "battery",
+		summary: "Battery charge in percent. Offline and unknown members are left out, never read as 0 %.",
+		role: DeviceRole.BatterySensor,
+		outputCap: "battery",
+		outputField: "percentage",
+		quantity: "percentage",
+		defaultAggregate: "mean",
+		empty: "null",
+		companions: [
+			{
+				fieldPath: "charging",
+				expr: "\"unknown\""
+			},
+			{
+				fieldPath: "sleeping",
+				expr: "false"
+			},
+			{
+				fieldPath: "lastUpdated",
+				expr: "now"
+			}
+		]
+	}),
+	numeric({
+		id: "numeric",
+		summary: "A numeric reading in the members’ shared quantity. Mixed quantities are refused. Nobody reporting publishes null, not 0.",
+		role: DeviceRole.NumericSensor,
+		outputCap: "numeric-sensor",
+		outputField: "value",
+		quantity: "device",
+		defaultAggregate: "mean",
+		empty: "null",
+		companions: [NOW]
+	}),
+	binary({
+		id: "motion",
+		summary: "Any or all motion. Offline and unknown members are left out, never read as off. Nobody reporting takes the device offline.",
+		role: DeviceRole.MotionSensor,
+		outputCap: "motion",
+		outputField: "detected",
+		defaultAggregate: "any",
+		accept: [{
+			cap: "motion",
+			fieldPath: "detected"
+		}],
+		companions: [{
+			fieldPath: "lastDetectedAt",
+			expr: "null"
+		}, {
+			fieldPath: "autoClearAfterMs",
+			expr: "null"
+		}]
+	}),
+	binary({
+		id: "contact",
+		summary: "Any or all open contacts. Offline and unknown members are left out, never read as closed.",
+		role: DeviceRole.ContactSensor,
+		outputCap: "contact",
+		outputField: "entryOpen",
+		defaultAggregate: "any",
+		accept: [{
+			cap: "contact",
+			fieldPath: "entryOpen"
+		}],
+		companions: [CHANGED]
+	}),
+	binary({
+		id: "leak",
+		summary: "Any or all leak detections. Offline and unknown members are left out, never read as dry.",
+		role: DeviceRole.LeakSensor,
+		outputCap: "flood",
+		outputField: "flooded",
+		defaultAggregate: "any",
+		accept: [{
+			cap: "flood",
+			fieldPath: "flooded"
+		}],
+		companions: [CHANGED]
+	}),
+	binary({
+		id: "smoke",
+		summary: "Any or all smoke detections. Offline and unknown members are left out, never read as clear.",
+		role: DeviceRole.SmokeSensor,
+		outputCap: "smoke",
+		outputField: "detected",
+		defaultAggregate: "any",
+		accept: [{
+			cap: "smoke",
+			fieldPath: "detected"
+		}],
+		companions: [CHANGED]
+	}),
+	binary({
+		id: "occupancy",
+		summary: "Any or all of motion or binary sensors, published as a binary. Presence zones are not aggregated. Nobody reporting is offline, not off.",
+		role: DeviceRole.BinarySensor,
+		outputCap: "binary",
+		outputField: "on",
+		defaultAggregate: "any",
+		accept: [{
+			cap: "motion",
+			fieldPath: "detected"
+		}, {
+			cap: "binary",
+			fieldPath: "on"
+		}],
+		companions: [CHANGED]
+	}),
+	binary({
+		id: "binary",
+		summary: "Any or all generic binary sensors. Offline and unknown members are left out, never read as off.",
+		role: DeviceRole.BinarySensor,
+		outputCap: "binary",
+		outputField: "on",
+		defaultAggregate: "any",
+		accept: [{
+			cap: "binary",
+			fieldPath: "on"
+		}],
+		companions: [CHANGED]
+	})
+];
+new Map(GROUP_TEMPLATES.map((template) => [template.id, template]));
 `${COMPOSED_DEVICE_STABLE_ID_PREFIX}`;
 /**
 * What a composition may BUILD on a device type (G2, D676): the caps a new
@@ -20535,12 +20870,12 @@ function parseAdminBase(baseUrl) {
 *      providers detect renames by matching `uniqueId` and patch `id`
 *      in-place so dispatch keeps working.
 *
-* **Rendering metadata is NOT stored here.** Display fields (`unit`,
-* `precision`) live in the cap STATUS SLICE so they flow live with every
-* state push and are the single source of truth. The `device_class` tag is
-* an HA-specific input that is consumed at the discovery boundary
-* (`ha-domain-mapping`) to derive the CamStack `DeviceRole`; it is never
-* stored after that point.
+* **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`
@@ -20554,6 +20889,14 @@ var SourceInfoSchema = object({
 	/** Immutable upstream identifier when available (HA `unique_id`, … ).
 	*  Used to detect rename when `id` changes. */
 	uniqueId: string().optional(),
+	/** Quantity of a polymorphic reading, written once at adopt (D944). */
+	quantity: ReadingQuantitySchema.optional(),
+	/** Date / time / datetime shape of a string reading, written once at adopt. */
+	dateTimeShape: _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). */
@@ -20638,9 +20981,38 @@ function normalizeUnit(raw) {
 	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;
 }
 /**
@@ -41745,7 +42117,8 @@ method(object({
 			"enum"
 		]),
 		enumValues: array(string()).optional(),
-		item: boolean().optional()
+		item: boolean().optional(),
+		quantity: ReadingQuantitySchema.optional()
 	})).readonly(),
 	itemArray: object({
 		path: string(),
@@ -45611,8 +45984,8 @@ var MaskPolygonShapeSchema = object({
 /** Boolean cell grid — row-major, length === gridWidth*gridHeight. */
 var MaskGridShapeSchema = object({
 	kind: literal("grid"),
-	gridWidth: number(),
-	gridHeight: number(),
+	gridWidth: number().meta(readingMeta("none")),
+	gridHeight: number().meta(readingMeta("none")),
 	cells: array(boolean())
 });
 discriminatedUnion("kind", [
@@ -57180,27 +57553,17 @@ method(object({ nodeId: string().optional() }).optional(), array(AddonListItemSc
 */
 var AirQualitySensorStatusSchema = object({
 	/** Carbon dioxide concentration in ppm. */
-	co2Ppm: number().min(0).optional(),
+	co2Ppm: number().min(0).optional().meta(readingMeta("concentration-volume")),
 	/** Total volatile organic compounds in ppb. */
-	vocPpb: number().min(0).optional(),
+	vocPpb: number().min(0).optional().meta(readingMeta("concentration-ppb")),
 	/** Particulate matter ≤ 2.5 μm in µg/m³. */
-	pm25: number().min(0).optional(),
+	pm25: number().min(0).optional().meta(readingMeta("concentration-mass")),
 	/** Particulate matter ≤ 10 μm in µg/m³. */
-	pm10: number().min(0).optional(),
+	pm10: number().min(0).optional().meta(readingMeta("concentration-mass")),
 	/** Composite AQI value (typically 0..500). */
-	aqi: number().optional(),
+	aqi: number().optional().meta(readingMeta("index")),
 	/** Ms epoch when the slice was last updated. */
-	lastFetchedAt: number(),
-	/** Live display unit of the single metric this slice carries (e.g. HA
-	*  `attributes.unit_of_measurement` → 'ppm' / 'ppb' / 'µg/m³'). Each
-	*  upstream `sensor.*` entity surfaces ONE device_class, so one unit
-	*  per slice is unambiguous. */
-	unit: string().optional(),
-	/** Suggested decimal places for numeric display.
-	*  Populated live from the upstream source when provided (e.g. HA
-	*  `attributes.suggested_display_precision`). Falls back to
-	*  auto-formatting when absent. */
-	precision: number().int().min(0).max(10).optional()
+	lastFetchedAt: number()
 });
 var airQualitySensorCapability = {
 	name: "air-quality-sensor",
@@ -57237,12 +57600,12 @@ var airQualitySensorCapability = {
 		},
 		pm25: {
 			kind: "gauge",
-			unit: "ug/m3",
+			unit: "µg/m³",
 			deadband: 1
 		},
 		pm10: {
 			kind: "gauge",
-			unit: "ug/m3",
+			unit: "µg/m³",
 			deadband: 1
 		},
 		aqi: {
@@ -57260,22 +57623,13 @@ var airQualitySensorCapability = {
 * entries with `device_class: illuminance`.
 */
 var AmbientLightSensorStatusSchema = object({
-	/** Current illuminance in lux (lx). */
-	lux: number().min(0).meta({
-		unit: "lx",
+	/** Current illuminance in lux (lx). `null` when the sample was refused (D393). */
+	lux: number().min(0).nullable().meta(readingMeta("illuminance", {
+		precision: 0,
 		label: "Illuminance"
-	}),
+	})),
 	/** Ms epoch when the slice was last updated. */
-	lastFetchedAt: number(),
-	/** Live display unit from the upstream source (e.g. HA
-	*  `attributes.unit_of_measurement`). The UI prefers this over the
-	*  role's canonical unit. Absent → fall back to the canonical unit. */
-	unit: string().optional(),
-	/** Suggested decimal places for numeric display.
-	*  Populated live from the upstream source when provided (e.g. HA
-	*  `attributes.suggested_display_precision`). Falls back to
-	*  auto-formatting when absent. */
-	precision: number().int().min(0).max(10).optional()
+	lastFetchedAt: number()
 });
 var ambientLightSensorCapability = {
 	name: "ambient-light-sensor",
@@ -57307,12 +57661,7 @@ var ambientLightSensorCapability = {
 	} } },
 	/** Clock fields: written, but excluded from the compare that decides
 	*  whether persisting is worth a SQLite commit. */
-	volatileStateFields: ["lastFetchedAt"],
-	customize: {
-		version: 1,
-		advanced: "derive",
-		targets: []
-	}
+	volatileStateFields: ["lastFetchedAt"]
 };
 /**
 * Per-class audio metrics aggregated over a sliding window.
@@ -57539,10 +57888,7 @@ var BatteryStatusSchema = object({
 	* Consumers must SKIP a null rather than coerce it — `battery-band` already
 	* declines to band a non-finite reading, which is the correct shape.
 	*/
-	percentage: number().min(0).max(100).nullable().meta({
-		unit: "%",
-		label: "Charge"
-	}),
+	percentage: number().min(0).max(100).nullable().meta(readingMeta("percentage", { label: "Charge" })),
 	/**
 	* Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
 	* Reolink-specific for the Solar Panel 2 accessory (will become
@@ -57569,7 +57915,14 @@ var BatteryStatusSchema = object({
 	*/
 	sleeping: boolean().meta({ label: "Sleeping" }),
 	/** Ms epoch of the last observation. Lets consumers reason about freshness. */
-	lastUpdated: number(),
+	lastUpdated: number().meta(readingMeta("none")),
+	/**
+	* Battery voltage in volts, for a cell the firmware reports as voltage
+	* rather than a percentage (Ecowitt capacitor packs). Absent on cameras
+	* that only report charge. A second reading on this cap, not a second
+	* `numeric-sensor` on the same device.
+	*/
+	volts: number().nullable().optional().meta(readingMeta("voltage", { label: "Voltage" })),
 	/**
 	* Ms epoch of the last time the device PROVED it was reachable — a
 	* completed firmware round-trip, an observed wake, or an inbound push
@@ -57621,7 +57974,6 @@ var BATTERY_DEVICE_TYPES = [
 /** Generic Customize target for the percentage reading (D936). */
 var batteryCustomize = {
 	version: 1,
-	advanced: "derive",
 	targets: [{
 		id: "percentage",
 		cardinality: "scalar",
@@ -57630,7 +57982,7 @@ var batteryCustomize = {
 			stateField: "percentage"
 		},
 		deviceTypes: BATTERY_DEVICE_TYPES,
-		apply: "add-or-replace",
+		apply: "add",
 		path: "percentage",
 		sources: [{
 			kind: "field",
@@ -57751,10 +58103,16 @@ onStatusChanged: { data: object({
 	/**
 	* History (D850): recorded series. The generic capture replaces the `battery` series of `pipeline-analytics:stats-5m`.
 	*/
-	history: { fields: { percentage: {
-		kind: "gauge",
-		unit: "%"
-	} } },
+	history: { fields: {
+		percentage: {
+			kind: "gauge",
+			unit: "%"
+		},
+		volts: {
+			kind: "gauge",
+			unit: "V"
+		}
+	} },
 	customize: batteryCustomize,
 	/** Clock fields: written, but excluded from the compare that decides
 	*  whether persisting is worth a SQLite commit. */
@@ -57801,12 +58159,7 @@ var binaryCapability = {
 	history: { fields: { on: { kind: "boolean" } } },
 	/** Clock fields: written, but excluded from the compare that decides
 	*  whether persisting is worth a SQLite commit. */
-	volatileStateFields: ["lastChangedAt"],
-	customize: {
-		version: 1,
-		advanced: "derive",
-		targets: []
-	}
+	volatileStateFields: ["lastChangedAt"]
 };
 /**
 * Dimmable-light brightness control. Co-exists with `switch` on the
@@ -57822,7 +58175,7 @@ var binaryCapability = {
 */
 var BrightnessStatusSchema = object({
 	/** Current level as 0..100 inclusive. Firmware-reported. */
-	percentage: number().min(0).max(100),
+	percentage: number().min(0).max(100).meta(readingMeta("percentage")),
 	/** Ms epoch of the last operator-driven change. Useful for UI freshness. */
 	lastChangedAt: number()
 });
@@ -58303,21 +58656,21 @@ var ClimateControlStatusSchema = object({
 	/** Single setpoint in Celsius. Used by single-target modes
 	*  (heat / cool / dry). Null when the device is in a range mode
 	*  (`heat_cool`) or has no setpoint at all (`fan_only`/`off`). */
-	target: number().nullable(),
+	target: number().nullable().meta(readingMeta("temperature")),
 	/** Upper bound of the dual setpoint in Celsius. Populated only
 	*  in `heat_cool` mode. */
-	targetHigh: number().nullable(),
+	targetHigh: number().nullable().meta(readingMeta("temperature")),
 	/** Lower bound of the dual setpoint in Celsius. Populated only
 	*  in `heat_cool` mode. */
-	targetLow: number().nullable(),
+	targetLow: number().nullable().meta(readingMeta("temperature")),
 	/** Target relative humidity (0..100). Null when the device has no
 	*  humidity control. */
-	targetHumidity: number().min(0).max(100).nullable(),
+	targetHumidity: number().min(0).max(100).nullable().meta(readingMeta("humidity")),
 	/** Current measured temperature in Celsius. Read-only — pushed by
 	*  the device's internal sensor. */
-	currentTemp: number().nullable(),
+	currentTemp: number().nullable().meta(readingMeta("temperature")),
 	/** Current measured relative humidity (0..100). Read-only. */
-	currentHumidity: number().min(0).max(100).nullable(),
+	currentHumidity: number().min(0).max(100).nullable().meta(readingMeta("humidity")),
 	/** Vertical louver swing on/off. Null when the device has no vertical
 	*  swing surface (gate with `DeviceFeature.ClimateSwingVertical`). */
 	swingVertical: boolean().nullable(),
@@ -58325,11 +58678,11 @@ var ClimateControlStatusSchema = object({
 	*  horizontal swing surface (gate with `DeviceFeature.ClimateSwingHorizontal`). */
 	swingHorizontal: boolean().nullable(),
 	/** Lowest setpoint the device accepts, Celsius. Absent / null = not reported. */
-	minTemp: number().nullable().optional(),
+	minTemp: number().nullable().optional().meta(readingMeta("temperature")),
 	/** Highest setpoint the device accepts, Celsius. Absent / null = not reported. */
-	maxTemp: number().nullable().optional(),
+	maxTemp: number().nullable().optional().meta(readingMeta("temperature")),
 	/** Setpoint granularity, Celsius (0.5, 1). Absent / null = not reported. */
-	tempStep: number().positive().nullable().optional(),
+	tempStep: number().positive().nullable().optional().meta(readingMeta("temperature")),
 	/** Ms epoch when the slice was last updated (push or command). */
 	lastFetchedAt: number()
 });
@@ -58471,17 +58824,17 @@ var climateControlCapability = {
 * modes to expose in the picker without a slice fetch.
 */
 var RgbTripletSchema = object({
-	r: number().int().min(0).max(255),
-	g: number().int().min(0).max(255),
-	b: number().int().min(0).max(255)
+	r: number().int().min(0).max(255).meta(readingMeta("none")),
+	g: number().int().min(0).max(255).meta(readingMeta("none")),
+	b: number().int().min(0).max(255).meta(readingMeta("none"))
 });
 var HsvTripletSchema = object({
 	/** Hue in degrees, 0..360. */
-	h: number().min(0).max(360),
+	h: number().min(0).max(360).meta(readingMeta("none")),
 	/** Saturation as 0..100 inclusive. */
-	s: number().min(0).max(100),
+	s: number().min(0).max(100).meta(readingMeta("none")),
 	/** Value/brightness as 0..100 inclusive. */
-	v: number().min(0).max(100)
+	v: number().min(0).max(100).meta(readingMeta("none"))
 });
 var ColorInputSchema = discriminatedUnion("mode", [
 	object({
@@ -58510,7 +58863,7 @@ var ColorStatusSchema = object({
 	/** Populated when `mode === 'hsv'`. */
 	hsv: HsvTripletSchema.optional(),
 	/** Populated when `mode === 'mired'`. */
-	mireds: number().int().optional(),
+	mireds: number().int().optional().meta(readingMeta("colour-temperature")),
 	/** Ms epoch of the last operator-driven change. */
 	lastChangedAt: number()
 });
@@ -58719,18 +59072,12 @@ var FORM_OF_KIND = {
 function consumableFormOf(item) {
 	return item.form ?? FORM_OF_KIND[consumableKindOf(item)];
 }
-/** Units a remaining-life counter is reported in. Closed: the panel renders
-*  each. */
-var ConsumableRemainingUnitSchema = _enum([
-	"days",
-	"hours",
-	"cycles"
-]);
-/** Remaining life as a COUNT, not a percentage (the PetKit desiccant reports
-*  days). `value` null = unknown (D393). */
+/** Whether `remaining.value` is a duration in seconds or a dimensionless count. */
+var ConsumableRemainingKindSchema = _enum(["duration", "count"]);
+/** Remaining life. `value` null = unknown (D393). Duration is seconds. */
 var ConsumableRemainingSchema = object({
-	value: number().min(0).nullable(),
-	unit: ConsumableRemainingUnitSchema
+	value: number().min(0).nullable().meta(readingMeta("device")),
+	kind: ConsumableRemainingKindSchema
 });
 /** A single consumable item. Either a continuous `level` (remaining
 *  life %, or fill % for a `supply` / `waste` item) or a discrete `status`
@@ -58743,7 +59090,7 @@ var ConsumableItemSchema = object({
 	/** Display name. */
 	label: string().min(1),
 	/** Remaining life % (`wear`) or fill % (`supply`, `waste`) when known (0..100). */
-	level: number().min(0).max(100).nullable(),
+	level: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** The provider's discrete verdict when known (binary mode). */
 	status: ConsumableStatusSchema.nullable(),
 	/** What the item is — decides whether low or full is bad. Absent = `wear`. */
@@ -58825,8 +59172,8 @@ var consumablesCustomize = {
 					transforms: [{ kind: "identity" }]
 				}],
 				literals: [{
-					path: "remaining.unit",
-					values: [...ConsumableRemainingUnitSchema.options]
+					path: "remaining.kind",
+					values: [...ConsumableRemainingKindSchema.options]
 				}]
 			},
 			{
@@ -58955,7 +59302,6 @@ reset: method(object({
 				},
 				"remaining.value": {
 					kind: "gauge",
-					unitFrom: "remaining.unit",
 					deadband: 1,
 					displayName: "Remaining"
 				}
@@ -59025,10 +59371,9 @@ var contactCapability = {
 * (empty array for the other kinds). It lives in the slice because
 * HA `select.*` entities may update their options at runtime.
 *
-* The `unit`/`min`/`max`/`step` fields are meaningful for
-* `kind === 'numeric'` and are absent (undefined) for all other
-* kinds. They are populated live from HA attributes on each state
-* push — consistent with `options` and the sensor-unit approach.
+* Numeric `min` / `max` / `step` live in the slice and share the device
+* quantity (`SourceInfo.quantity`, D944). Display precision is a read-time
+* preference. A datetime control's shape is `SourceInfo.dateTimeShape`.
 */
 var ControlStatusSchema = object({
 	kind: _enum([
@@ -59040,39 +59385,17 @@ var ControlStatusSchema = object({
 	/** Current value. Numeric kind → number; select/text/datetime → string.
 	*  Datetime values are ISO 8601 strings (full timestamp, date-only,
 	*  or time-only — HA accepts all three forms). */
-	value: union([number(), string()]),
+	value: union([number().meta(readingMeta("device")), string()]),
 	/** Acceptable values when `kind === 'select'`. Empty for other kinds. */
 	options: array(string()),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number(),
-	/** Display unit-of-measurement (e.g. '°C', '%', 'lx').
-	*  Populated live from HA `attributes.unit_of_measurement` on each push.
-	*  Meaningful for `kind === 'numeric'`; absent for other kinds. */
-	unit: string().optional(),
-	/** Minimum allowed value. Populated live from HA `attributes.min`.
-	*  Meaningful for `kind === 'numeric'`; absent for other kinds. */
-	min: number().optional(),
-	/** Maximum allowed value. Populated live from HA `attributes.max`.
-	*  Meaningful for `kind === 'numeric'`; absent for other kinds. */
-	max: number().optional(),
-	/** Step increment. Populated live from HA `attributes.step`.
-	*  Meaningful for `kind === 'numeric'`; absent for other kinds. */
-	step: number().optional(),
-	/** Suggested decimal places for numeric display. Populated live from HA
-	*  `attributes.suggested_display_precision`, or derived from `step` when the
-	*  HA attribute is absent. Meaningful for `kind === 'numeric'`; absent for
-	*  other kinds. Falls back to auto-formatting when absent. */
-	precision: number().int().min(0).max(10).optional(),
-	/** Date-picker granularity for `kind === 'datetime'`. 'date' → date-only,
-	*  'time' → time-only, 'datetime' → full timestamp. Absent for other kinds
-	*  (UI defaults to 'datetime'). Derived live from the device's HA domain
-	*  (date.* / time.* / datetime.*) or, for input_datetime, from the entity's
-	*  `has_date`/`has_time` attributes on each push. */
-	format: _enum([
-		"date",
-		"time",
-		"datetime"
-	]).optional()
+	/** Minimum allowed value, in the device quantity's base unit. */
+	min: number().optional().meta(readingMeta("device")),
+	/** Maximum allowed value, in the device quantity's base unit. */
+	max: number().optional().meta(readingMeta("device")),
+	/** Step increment, in the device quantity's base unit. */
+	step: number().optional().meta(readingMeta("device"))
 });
 var ControlSetValueInputSchema = discriminatedUnion("kind", [
 	object({
@@ -59138,9 +59461,9 @@ var CoverStatusSchema = object({
 	]),
 	/** 0 = fully closed, 100 = fully open. Null when the device has
 	*  no intermediate position surface. */
-	position: number().min(0).max(100).nullable(),
+	position: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** 0 = closed slats, 100 = open slats. Null when no tilt support. */
-	tiltPosition: number().min(0).max(100).nullable(),
+	tiltPosition: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number()
 });
@@ -59243,9 +59566,9 @@ var NormalizedRangeSchema$1 = object({
 var DayNightStatusSchema = object({
 	mode: DayNightModeSchema,
 	/** IR-cut trigger sensitivity, NORMALIZED 0–100 (higher = switches to night sooner). */
-	sensitivity: number().optional(),
+	sensitivity: number().optional().meta(readingMeta("none")),
 	/** Delay before the IR-cut filter flips, in seconds. */
-	switchDelaySec: number().optional(),
+	switchDelaySec: number().optional().meta(readingMeta("duration")),
 	lastFetchedAt: number()
 });
 /**
@@ -59463,11 +59786,11 @@ var DishwasherStatusSchema = object({
 	/** Feature keys of the programs the appliance currently offers — drives the UI selector. */
 	availablePrograms: array(string()),
 	/** Seconds remaining on the active cycle, or null when not running / not known. */
-	remainingSeconds: number().int().nonnegative().nullable(),
+	remainingSeconds: number().int().nonnegative().nullable().meta(readingMeta("duration")),
 	/** Seconds the delayed start is set to (time until the cycle starts), or null. */
-	delayedStartSeconds: number().int().nonnegative().nullable(),
+	delayedStartSeconds: number().int().nonnegative().nullable().meta(readingMeta("duration")),
 	/** Cycle completion 0..100, or null when not applicable. */
-	progressPercent: number().min(0).max(100).nullable(),
+	progressPercent: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** True when the door is reported open; null when the door state is not known. */
 	doorOpen: boolean().nullable(),
 	/** True when the door is latched (locked) during a cycle; null when not reported. */
@@ -59491,7 +59814,7 @@ var DishwasherStatusSchema = object({
 	/** True while the machine-care (descaling / cleaning-program) reminder is raised; false when clear; null when not reported. */
 	machineCareDue: boolean().nullable(),
 	/** Program runs left before the machine-care reminder is due; null when the appliance does not say. */
-	machineCareRemainingRuns: number().int().nonnegative().nullable(),
+	machineCareRemainingRuns: number().int().nonnegative().nullable().meta(readingMeta("count")),
 	/** Option states: null when the appliance does not expose the option or has not said. */
 	halfLoad: boolean().nullable(),
 	hygienePlus: boolean().nullable(),
@@ -59506,7 +59829,7 @@ var DishwasherStatusSchema = object({
 	/** Feature keys of the events currently raised (salt low, rinse aid low, program finished, …). */
 	activeEvents: array(string()),
 	/** Numeric error code when the appliance reports one; null otherwise. */
-	errorCode: number().nullable(),
+	errorCode: number().nullable().meta(readingMeta("none")),
 	/** Name of the raised alert-level event while the appliance is in error; null otherwise. */
 	errorLabel: string().nullable(),
 	/** Ms epoch of the last value received from the appliance; 0 = never. */
@@ -59737,7 +60060,7 @@ var DoorbellStatusSchema = object({
 	/** Ms epoch of the last press. null = never observed since this provider started. */
 	lastPressedAt: number().nullable(),
 	/** Counter since provider start. Resets on reboot. Useful for metrics/debug. */
-	pressCountSinceStart: number()
+	pressCountSinceStart: number().meta(readingMeta("count"))
 });
 var DoorbellPressEventSchema = object({
 	deviceId: number(),
@@ -59820,12 +60143,11 @@ var EnumSensorDateTimeFormatSchema = _enum([
 var EnumSensorStatusSchema = object({
 	value: string(),
 	/**
-	* Set for `DateTimeSensor`-role sensors so the UI renders the ISO `value`
-	* as a locale date/time/datetime; absent for plain enum sensors. HA
-	* `device_class=timestamp` → `'datetime'`, `device_class=date` → `'date'`,
-	* a time-only sensor → `'time'`.
+	* Set when `value` is a timestamp rather than an enum state, so history
+	* does not learn ISO strings as states. The display shape (date / time /
+	* datetime) lives on `SourceInfo.dateTimeShape`, written once at adopt.
 	*/
-	format: EnumSensorDateTimeFormatSchema.optional(),
+	timestamp: boolean().optional(),
 	/** Ms epoch when the slice was last updated. */
 	lastFetchedAt: number()
 });
@@ -59852,11 +60174,11 @@ var enumSensorCapability = {
 	* History (D850): the value as an `enum` series (an appliance's program or
 	* operation state, an HVAC action). The option set is per device, so the
 	* value list is LEARNED as values are first seen (bounded). A sensor with a
-	* `format` carries a timestamp, not a state, and is not recorded.
+	* `timestamp` carries a clock, not a state, and is not recorded.
 	*/
 	history: { fields: { value: {
 		kind: "enum",
-		skipWhenSet: "format"
+		skipWhenSet: "timestamp"
 	} } },
 	/** Clock fields: written, but excluded from the compare that decides
 	*  whether persisting is worth a SQLite commit. */
@@ -59876,13 +60198,13 @@ var EventFireSchema = object({
 	deviceId: number(),
 	eventType: string(),
 	data: record(string(), unknown()).nullable(),
-	timestamp: number(),
-	seq: number()
+	timestamp: number().meta(readingMeta("none")),
+	seq: number().meta(readingMeta("count"))
 });
 var EventEmitterStatusSchema = object({
 	eventTypes: array(string()),
 	lastEvent: EventFireSchema.nullable(),
-	eventCountSinceStart: number()
+	eventCountSinceStart: number().meta(readingMeta("count"))
 });
 var eventEmitterCapability = {
 	name: "event-emitter",
@@ -60295,10 +60617,10 @@ var FanDirectionSchema = _enum(["forward", "reverse"]);
 var FanControlStatusSchema = object({
 	/** Active speed as 0..100 inclusive. Null when the device has no
 	*  speed surface (single-speed fan). */
-	percentage: number().min(0).max(100).nullable(),
+	percentage: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** Speed granularity the device accepts (HA `percentage_step`, e.g. 25 for
 	*  a 4-speed fan). Absent when unknown — the UI then falls back to step 1. */
-	percentageStep: number().positive().optional(),
+	percentageStep: number().positive().optional().meta(readingMeta("percentage")),
 	/** Active preset mode (`auto` / `quiet` / `turbo` / vendor-specific)
 	*  — empty string when no preset is active or supported. */
 	preset: string(),
@@ -60419,7 +60741,7 @@ var FeatureProbeStatusSchema = object({
 	/** Camera/firmware model string. `null` when the firmware doesn't expose it. */
 	model: string().nullable(),
 	/** Channel count for NVR/Hub devices; `1` for standalone cameras; `null` pre-probe. */
-	channelCount: number().nullable(),
+	channelCount: number().nullable().meta(readingMeta("count")),
 	/**
 	* Ms epoch of the last SUCCESSFUL probe. `0` before the first probe
 	* completes — drivers' `getAccessoryChildren()` should treat zero as
@@ -60542,9 +60864,54 @@ var gasCapability = {
 	*  whether persisting is worth a SQLite commit. */
 	volatileStateFields: ["lastChangedAt"]
 };
+/**
+* How many members of a helper group answered (D944). Counts are integers,
+* not measurements: zero included is a real count, never a stand-in reading.
+* The reading itself stays on the output capability. History is none — the
+* series that later statistics read is the output cap's own history block.
+*/
+var GroupStatusSchema = object({
+	/** Members whose current value entered the aggregate. */
+	included: number().int().nonnegative().meta(readingMeta("count", {
+		precision: 0,
+		label: "Reporting"
+	})),
+	/** Members left out: offline, unknown, or not a finite reading (D393). */
+	excluded: number().int().nonnegative().meta(readingMeta("count", {
+		precision: 0,
+		label: "Excluded"
+	})),
+	/** `included` + `excluded`. */
+	total: number().int().nonnegative().meta(readingMeta("count", {
+		precision: 0,
+		label: "Members"
+	}))
+});
+var groupStatusCapability = {
+	name: "group-status",
+	scope: "device",
+	deviceNative: true,
+	mode: "singleton",
+	deviceTypes: [DeviceType.Sensor],
+	methods: {},
+	status: {
+		schema: GroupStatusSchema,
+		kind: "push"
+	},
+	runtimeState: GroupStatusSchema,
+	/**
+	* Runtime-state durability: **session** — recomputed from members on the
+	* next source event; a restored count would outlive the readings it named.
+	*
+	* See `RuntimeStateDurability`. Enforced by
+	* `scripts/check-runtime-state-durability.ts`.
+	*/
+	durability: "session",
+	history: "none"
+};
 var HeatingValveStatusSchema = object({
 	/** Radiator valve opening 0 (closed) .. 100 (open). Null = not yet known. */
-	position: number().min(0).max(100).nullable(),
+	position: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** Ms epoch when the slice was last updated (push or poll). */
 	lastFetchedAt: number()
 });
@@ -60587,9 +60954,9 @@ var HumidifierStatusSchema = object({
 	/** Whether the humidifier is currently on. */
 	on: boolean(),
 	/** Current measured relative humidity (0..100). Null when not reported. */
-	currentHumidity: number().min(0).max(100).nullable(),
+	currentHumidity: number().min(0).max(100).nullable().meta(readingMeta("humidity")),
 	/** Target relative humidity (0..100). Null when no setpoint surface. */
-	targetHumidity: number().min(0).max(100).nullable(),
+	targetHumidity: number().min(0).max(100).nullable().meta(readingMeta("humidity")),
 	/** Active mode (`auto` / `normal` / `baby` / vendor). Null when the
 	*  device has no mode surface. */
 	mode: string().nullable(),
@@ -60599,9 +60966,9 @@ var HumidifierStatusSchema = object({
 	*  `idle` / `off`). Null when the device doesn't report it. */
 	action: string().nullable(),
 	/** HA `min_humidity` attribute. Null → UI uses 0. */
-	minHumidity: number().nullable(),
+	minHumidity: number().nullable().meta(readingMeta("humidity")),
 	/** HA `max_humidity` attribute. Null → UI uses 100. */
-	maxHumidity: number().nullable(),
+	maxHumidity: number().nullable().meta(readingMeta("humidity")),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number()
 });
@@ -60671,22 +61038,13 @@ var humidifierCapability = {
 * `sourceInfo`.
 */
 var HumiditySensorStatusSchema = object({
-	/** Current relative humidity, 0..100. */
-	percent: number().min(0).max(100).meta({
-		unit: "%",
+	/** Current relative humidity, 0..100. `null` when the sample was refused (D393). */
+	percent: number().min(0).max(100).nullable().meta(readingMeta("humidity", {
+		precision: 0,
 		label: "Humidity"
-	}),
+	})),
 	/** Ms epoch when the slice was last updated. */
-	lastFetchedAt: number(),
-	/** Live display unit from the upstream source (e.g. HA
-	*  `attributes.unit_of_measurement`). The UI prefers this over the
-	*  role's canonical unit. Absent → fall back to the canonical unit. */
-	unit: string().optional(),
-	/** Suggested decimal places for numeric display.
-	*  Populated live from the upstream source when provided (e.g. HA
-	*  `attributes.suggested_display_precision`). Falls back to
-	*  auto-formatting when absent. */
-	precision: number().int().min(0).max(10).optional()
+	lastFetchedAt: number()
 });
 var humiditySensorCapability = {
 	name: "humidity-sensor",
@@ -60717,12 +61075,7 @@ var humiditySensorCapability = {
 	} } },
 	/** Clock fields: written, but excluded from the compare that decides
 	*  whether persisting is worth a SQLite commit. */
-	volatileStateFields: ["lastFetchedAt"],
-	customize: {
-		version: 1,
-		advanced: "derive",
-		targets: []
-	}
+	volatileStateFields: ["lastFetchedAt"]
 };
 /**
 * Image display cap. Models a single still image exposed by an integration —
@@ -60743,7 +61096,7 @@ var ImageStatusSchema = object({
 	*  entity exposes no `entity_picture` (yet). */
 	url: string().nullable(),
 	/** Ms epoch of the upstream last-updated timestamp. Null at cold-start. */
-	lastUpdated: number().nullable()
+	lastUpdated: number().nullable().meta(readingMeta("none"))
 });
 var imageCapability = {
 	name: "image",
@@ -60831,19 +61184,19 @@ var NormalizedRangeSchema = object({
 */
 var ImageSettingsStatusSchema = object({
 	/** Normalized 0–100. */
-	brightness: number().optional(),
+	brightness: number().optional().meta(readingMeta("none")),
 	/** Normalized 0–100. */
-	contrast: number().optional(),
+	contrast: number().optional().meta(readingMeta("none")),
 	/** Normalized 0–100. */
-	saturation: number().optional(),
+	saturation: number().optional().meta(readingMeta("none")),
 	/** Normalized 0–100. */
-	sharpness: number().optional(),
+	sharpness: number().optional().meta(readingMeta("none")),
 	mirror: boolean().optional(),
 	flip: boolean().optional(),
 	rotate: ImageRotateSchema.optional(),
 	whiteBalance: WhiteBalanceModeSchema.optional(),
 	/** Manual white-balance warmth, NORMALIZED 0–100. Meaningful only when `whiteBalance === 'manual'`. */
-	warmth: number().optional(),
+	warmth: number().optional().meta(readingMeta("none")),
 	exposureMode: ExposureModeSchema.optional(),
 	backlightMode: BacklightModeSchema.optional(),
 	lastFetchedAt: number()
@@ -61122,10 +61475,10 @@ var IntercomAbilitySchema = object({
 	/** Codecs accepted by firmware, in preference order. Driver-authored strings. */
 	codecs: array(string()),
 	/** Sample rate (Hz) the firmware expects. Reolink typical: 16000. */
-	sampleRate: number(),
+	sampleRate: number().meta(readingMeta("none")),
 	duplex: _enum(["half", "full"]),
 	/** Max in-flight audio backlog before drop (ms). Server uses this to bound latency. */
-	maxBacklogMs: number()
+	maxBacklogMs: number().meta(readingMeta("duration-ms"))
 });
 var IntercomStatusSchema = object({
 	/** True while a talk session is open. */
@@ -61352,13 +61705,13 @@ var LawnMowerControlStatusSchema = object({
 	activity: LawnMowerActivitySchema,
 	/** 0..100 battery percentage. Null when the device has no battery
 	*  reading. */
-	batteryLevel: number().min(0).max(100).nullable(),
+	batteryLevel: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** 0..100 mowing-completion percentage of the current task, or null when no
 	*  task is active / progress is unavailable. */
-	progressPercent: number().min(0).max(100).nullable(),
+	progressPercent: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** Current device/event code (dynamic — mostly status, sometimes an error),
 	*  or null when unknown. */
-	currentCode: number().nullable(),
+	currentCode: number().nullable().meta(readingMeta("none")),
 	/** Human label for {@link currentCode}, or null when undecodable. */
 	currentCodeLabel: string().nullable(),
 	/** Severity of {@link currentCode}. `error` (and often `warning`) warrants UI
@@ -61891,7 +62244,7 @@ var MediaPlayerStatusSchema = object({
 	state: MediaPlayerStateSchema,
 	/** Volume as 0..100 inclusive. Null when the device has no volume
 	*  surface. Pair with `DeviceFeature.MediaPlayerVolume`. */
-	volumeLevel: number().min(0).max(100).nullable(),
+	volumeLevel: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** Mute toggle distinct from volume=0. Null when no mute surface.
 	*  Pair with `DeviceFeature.MediaPlayerMute`. */
 	isMuted: boolean().nullable(),
@@ -61904,10 +62257,10 @@ var MediaPlayerStatusSchema = object({
 	currentMedia: MediaInfoSchema.nullable(),
 	/** Current playback position in ms. Null when not seekable or
 	*  nothing is playing. Pair with `DeviceFeature.MediaPlayerSeek`. */
-	positionMs: number().int().nonnegative().nullable(),
+	positionMs: number().int().nonnegative().nullable().meta(readingMeta("duration-ms")),
 	/** Total duration of the current media in ms. Null when unknown
 	*  (live stream) or nothing is playing. */
-	durationMs: number().int().nonnegative().nullable(),
+	durationMs: number().int().nonnegative().nullable().meta(readingMeta("duration-ms")),
 	/** Shuffle toggle. Null when no shuffle surface.
 	*  Pair with `DeviceFeature.MediaPlayerShuffle`. */
 	shuffle: boolean().nullable(),
@@ -62216,7 +62569,7 @@ var motionCustomize = {
 			eventName: "onMotionChanged"
 		},
 		deviceTypes: [DeviceType.Camera],
-		apply: "replace",
+		apply: "add",
 		applyAuthority: {
 			kind: "camera-sensors",
 			timeoutField: "motionCooldownMs"
@@ -62288,7 +62641,7 @@ var MotionStatusSchema = object({
 	* it, every provider seeded it at boot, and every session left it
 	* `detected: true` after its detach.
 	*/
-	autoClearAfterMs: number().nullable()
+	autoClearAfterMs: number().nullable().meta(readingMeta("duration-ms"))
 });
 /**
 * Payload of `motion.onMotionChanged` event + the corresponding bus
@@ -62325,12 +62678,18 @@ var motionCapability = {
 	methods: { 
 	/**
 	* Pull the current motion state synchronously. Convenience shortcut
-	* for consumers that don't need the full status object; equivalent
-	* to `getStatus()?.detected ?? false`. Will likely be folded into
-	* `getStatus` once the auto-injected status surface lands in every
-	* consumer.
+	* for consumers that don't need the full status object. A composed
+	* group answers from its slice (D944): unknown throws, it is not off.
 	*/
 isDetected: method(object({ deviceId: number() }), boolean()) },
+	/**
+	* A composed motion group serves `isDetected` from `detected` (D944).
+	* Without this the cap stays uncomposable (`has-commands`).
+	*/
+	composedMethods: { isDetected: {
+		kind: "slice",
+		field: "detected"
+	} },
 	events: { 
 	/**
 	* Fires every time the runner transitions a camera between
@@ -62470,7 +62829,7 @@ var MotionZoneRegionSchema = object({
 *  the grid region(s). */
 var MotionZoneStatusSchema = object({
 	enabled: boolean(),
-	sensitivity: number(),
+	sensitivity: number().meta(readingMeta("none")),
 	/** Grid region(s). Today exactly one `grid` shape. */
 	regions: array(MotionZoneRegionSchema),
 	lastFetchedAt: number()
@@ -62840,7 +63199,7 @@ var NavigationStatusSchema = object({
 	following: boolean(),
 	flash: boolean(),
 	lightMode: NavigationLightModeSchema,
-	lightLevel: number().min(40).max(100),
+	lightLevel: number().min(40).max(100).meta(readingMeta("none")),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number()
 });
@@ -62974,13 +63333,13 @@ var NetworkLinkStatusSchema = object({
 	* one whose reading has not landed must not be drawn at 0 %. Consumers
 	* SKIP a null rather than coerce it.
 	*/
-	signalPercent: number().min(0).max(100).nullable(),
+	signalPercent: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** Raw received signal strength in dBm, when the firmware reports one. */
-	rssiDbm: number().optional(),
+	rssiDbm: number().optional().meta(readingMeta("signal-level")),
 	/** Network name of a wireless link, when the firmware reports it. */
 	ssid: string().optional(),
 	/** Ms epoch of the last observation. Lets consumers reason about freshness. */
-	lastUpdated: number()
+	lastUpdated: number().meta(readingMeta("none"))
 });
 var networkLinkCapability = {
 	name: "network-link",
@@ -63365,7 +63724,7 @@ var NotifierStatusSchema = object({
 	lastError: string().nullable(),
 	/** Number of deliveries currently buffered server-side (rate-limited
 	*  notifiers may queue). 0 when the provider sends synchronously. */
-	queueDepth: number().int().nonnegative(),
+	queueDepth: number().int().nonnegative().meta(readingMeta("count")),
 	/** Per-feature capability matrix — authoritative source for the
 	*  compose-form field gating. */
 	supports: NotifierSupportsSchema
@@ -63457,11 +63816,9 @@ onSent: { data: object({
 * cap fits (HA `sensor` whose `device_class` we don't have a typed cap
 * for: water flow, distance, weight, frequency, signal strength, …).
 *
-* The `unit` and `precision` fields carry the live display metadata that
-* the upstream source provides with each state push (HA
-* `attributes.unit_of_measurement` / `attributes.suggested_display_precision`).
-* The UI reads them directly from the slice — they are the single source
-* of truth for generic numeric rendering and do NOT live on `sourceInfo`.
+* The quantity is not on this slice. It is chosen when the device is
+* adopted and stored once on `SourceInfo.quantity` (D944). `value` is in
+* that quantity's base unit. `null` is a refused sample (D393).
 *
 * Prefer the typed alternatives (`temperature-sensor`, `humidity-sensor`,
 * `ambient-light-sensor`, `pressure-sensor`, `power-meter`,
@@ -63470,15 +63827,8 @@ onSent: { data: object({
 * numeric values land here.
 */
 var NumericSensorStatusSchema = object({
-	value: number(),
-	/** Display unit-of-measurement (e.g. 'dBm', 's', 'rpm', 'steps').
-	*  Populated live from the upstream source on each state push.
-	*  Absent for unitless sensors. */
-	unit: string().optional(),
-	/** Suggested decimal places for numeric display.
-	*  Populated live from the upstream source when provided.
-	*  Falls back to auto-formatting when absent. */
-	precision: number().int().min(0).max(10).optional(),
+	/** Reading in the device quantity's base unit. `null` when refused (D393). */
+	value: number().nullable().meta(readingMeta("device")),
 	/** Ms epoch when the slice was last updated. */
 	lastFetchedAt: number()
 });
@@ -63502,11 +63852,11 @@ var numericSensorCapability = {
 	*/
 	durability: "restored",
 	/**
-	* History (D850): recorded series. The unit is per device, read from the sibling `unit` field.
+	* History (D850): recorded series. The unit is the device quantity's base,
+	* resolved when the series is read — the cap has no single unit.
 	*/
 	history: { fields: { value: {
 		kind: "gauge",
-		unitFrom: "unit",
 		minIntervalMs: 3e4
 	} } },
 	/** Clock fields: written, but excluded from the compare that decides
@@ -63798,23 +64148,26 @@ var PetFeederStatusSchema = object({
 	/** Food currently in the bowl (grams). Null when the device has not
 	*  reported a reading yet. On dual-hopper models this is the combined
 	*  bowl reading; per-hopper levels live in `food1`/`food2`. */
-	foodLevel: number().nullable(),
+	foodLevel: number().nullable().meta(readingMeta("none")),
 	/** Hopper-1 food level (grams) on dual-hopper feeders; null on
 	*  single-hopper models. */
-	food1: number().nullable(),
+	food1: number().nullable().meta(readingMeta("none")),
 	/** Hopper-2 food level (grams) on dual-hopper feeders; null on
 	*  single-hopper models. */
-	food2: number().nullable(),
+	food2: number().nullable().meta(readingMeta("none")),
 	/** Derived low-food flag — mirrors the HA `food_level` binary_sensor
 	*  (`device_class: problem`, on = low). True when the bowl is empty /
 	*  below the feeder's low threshold. */
 	lowFood: boolean(),
 	/** Battery charge 0..100 (%). Null on mains-powered models or when the
 	*  device has no battery reading. */
-	batteryPower: number().min(0).max(100).nullable(),
-	/** Days of desiccant life remaining. Null when the model has no
-	*  desiccant sensor. */
-	desiccantLeftDays: number().nullable(),
+	batteryPower: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
+	/**
+	* Desiccant life remaining, stored in seconds (duration base, D944).
+	* Providers convert from the days the feeder reports. Null when the
+	* model has no desiccant sensor.
+	*/
+	desiccantLeftDays: number().nullable().meta(readingMeta("duration")),
 	/** True while a feed is in progress. */
 	feeding: boolean(),
 	/** Decoded connectivity / power status (HA petkit device-status enum).
@@ -63825,7 +64178,7 @@ var PetFeederStatusSchema = object({
 	*  with `errorCode` for consumers that want the raw integer. */
 	error: string().nullable(),
 	/** Raw device error code (0 / null = no error). */
-	errorCode: number().nullable(),
+	errorCode: number().nullable().meta(readingMeta("none")),
 	/** True for D4S/D4SH dual-hopper hardware — gates the per-hopper UI. */
 	isDualHopper: boolean(),
 	/** Child-lock (manual-lock) setting — buttons on the unit are disabled. */
@@ -63835,7 +64188,7 @@ var PetFeederStatusSchema = object({
 	/** Play a chime when dispensing. */
 	feedSound: boolean(),
 	/** Speaker / prompt volume level (device-scaled integer). */
-	volume: number(),
+	volume: number().meta(readingMeta("none")),
 	/** Ms epoch when the slice was last refreshed from the cloud. */
 	lastFetchedAt: number()
 });
@@ -63954,7 +64307,7 @@ var petFeederCapability = {
 		},
 		desiccantLeftDays: {
 			kind: "gauge",
-			unit: "days"
+			unit: "s"
 		}
 	} }
 };
@@ -64355,36 +64708,19 @@ method(_void(), PlatformCapabilitiesSchema), method(_void(), HardwareInfoSchema)
 */
 var PowerMeterStatusSchema = object({
 	/** Instantaneous power draw in watts. */
-	watts: number().optional().meta({
-		unit: "W",
-		label: "Power"
-	}),
+	watts: number().optional().meta(readingMeta("power", { label: "Power" })),
 	/** Cumulative energy in kilowatt-hours since the meter was reset. */
-	kwhTotal: number().optional().meta({
-		unit: "kWh",
-		label: "Energy"
-	}),
+	kwhTotal: number().optional().meta(readingMeta("energy", { label: "Energy" })),
 	/** Voltage in volts. */
-	volts: number().optional(),
+	volts: number().optional().meta(readingMeta("voltage")),
 	/** Current in amperes. */
-	amps: number().optional(),
-	/** Apparent power in volt-amperes (W × power-factor reciprocal). */
-	va: number().optional(),
+	amps: number().optional().meta(readingMeta("current")),
+	/** Apparent power in volt-amperes. */
+	va: number().optional().meta(readingMeta("apparent-power")),
 	/** Power factor (0..1) if reported. */
-	powerFactor: number().min(0).max(1).optional(),
+	powerFactor: number().min(0).max(1).optional().meta(readingMeta("ratio")),
 	/** Ms epoch when the slice was last updated. */
-	lastFetchedAt: number(),
-	/** Live display unit of the single metric this slice carries (e.g. HA
-	*  `attributes.unit_of_measurement` → 'V' / 'A' / 'W' / 'kW' / 'kWh').
-	*  Each upstream `sensor.*` entity surfaces ONE device_class, so one
-	*  unit per slice is unambiguous. The UI prefers this over the role's
-	*  canonical unit so a 'kW' / 'Wh' feed renders verbatim. */
-	unit: string().optional(),
-	/** Suggested decimal places for numeric display.
-	*  Populated live from the upstream source when provided (e.g. HA
-	*  `attributes.suggested_display_precision`). Falls back to
-	*  auto-formatting when absent. */
-	precision: number().int().min(0).max(10).optional()
+	lastFetchedAt: number()
 });
 var powerMeterCapability = {
 	name: "power-meter",
@@ -64448,12 +64784,7 @@ var powerMeterCapability = {
 	} },
 	/** Clock fields: written, but excluded from the compare that decides
 	*  whether persisting is worth a SQLite commit. */
-	volatileStateFields: ["lastFetchedAt"],
-	customize: {
-		version: 1,
-		advanced: "derive",
-		targets: []
-	}
+	volatileStateFields: ["lastFetchedAt"]
 };
 /**
 * Presence cap. Models HA `person.*` and `device_tracker.*` entities
@@ -64473,11 +64804,11 @@ var powerMeterCapability = {
 */
 var GpsLocationSchema = object({
 	/** Latitude in decimal degrees, -90..90. */
-	latitude: number().min(-90).max(90),
+	latitude: number().min(-90).max(90).meta(readingMeta("angle")),
 	/** Longitude in decimal degrees, -180..180. */
-	longitude: number().min(-180).max(180),
+	longitude: number().min(-180).max(180).meta(readingMeta("angle")),
 	/** Reported accuracy in meters (lower = better). */
-	accuracyMeters: number().nonnegative()
+	accuracyMeters: number().nonnegative().meta(readingMeta("length"))
 });
 var PresenceStatusSchema = object({
 	/** `home` / `not_home` / any user-defined zone name. */
@@ -64489,7 +64820,7 @@ var PresenceStatusSchema = object({
 	gps: GpsLocationSchema.nullable(),
 	/** Optional battery level of the tracking device (0..100). Null
 	*  when not reported. */
-	batteryPercent: number().min(0).max(100).nullable(),
+	batteryPercent: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number()
 });
@@ -64539,19 +64870,10 @@ var presenceCapability = {
 * `sourceInfo`.
 */
 var PressureSensorStatusSchema = object({
-	/** Current pressure in hPa. */
-	hpa: number(),
+	/** Current pressure in hPa. `null` when the sample was refused (D393). */
+	hpa: number().nullable().meta(readingMeta("pressure", { precision: 0 })),
 	/** Ms epoch when the slice was last updated. */
-	lastFetchedAt: number(),
-	/** Live display unit from the upstream source (e.g. HA
-	*  `attributes.unit_of_measurement`). The UI prefers this over the
-	*  role's canonical unit. Absent → fall back to the canonical unit. */
-	unit: string().optional(),
-	/** Suggested decimal places for numeric display.
-	*  Populated live from the upstream source when provided (e.g. HA
-	*  `attributes.suggested_display_precision`). Falls back to
-	*  auto-formatting when absent. */
-	precision: number().int().min(0).max(10).optional()
+	lastFetchedAt: number()
 });
 var pressureSensorCapability = {
 	name: "pressure-sensor",
@@ -64965,8 +65287,8 @@ DeviceType.Camera, method(PtzMoveCommandSchema.extend({ deviceId: number() }), _
 }), _void(), { kind: "mutation" });
 var PtzAutotrackSettingsSchema = object({
 	targetType: string().describe("Vendor target string (people/vehicle/pet); empty = camera default"),
-	stopDelaySeconds: number().int().min(0).max(300),
-	disappearDelaySeconds: number().int().min(0).max(300)
+	stopDelaySeconds: number().int().min(0).max(300).meta(readingMeta("duration")),
+	disappearDelaySeconds: number().int().min(0).max(300).meta(readingMeta("duration"))
 });
 /**
 * One option the camera advertises as a valid `targetType`. Drivers
@@ -65128,7 +65450,7 @@ var RunningStateStatusSchema = object({
 	/** null = unknown — never coerced to false (D393). */
 	running: boolean().nullable(),
 	/** Epoch ms the current boolean began; null while `running` is null. */
-	since: number().nullable(),
+	since: number().nullable().meta(readingMeta("none")),
 	source: RunningStateSourceSchema.meta({ label: "Source" }),
 	phase: string().nullable(),
 	/** null until a reading has been published (D393). */
@@ -65143,7 +65465,6 @@ var RUNNING_DEVICE_TYPES = Object.values(DeviceType);
 /** Generic Customize target for the running boolean (D936). */
 var runningCustomize = {
 	version: 1,
-	advanced: "derive",
 	targets: [{
 		id: "running",
 		cardinality: "scalar",
@@ -65163,7 +65484,7 @@ var runningCustomize = {
 			DeviceType.Thermostat,
 			DeviceType.PetFeeder
 		],
-		apply: "add-or-replace",
+		apply: "add",
 		path: "running",
 		sources: [
 			{
@@ -66427,9 +66748,9 @@ var RecordTriggerSchema = _enum([
 */
 var RecordWindowSchema = object({
 	trigger: RecordTriggerSchema,
-	day: number().int().min(0).max(6),
-	startMinute: number().int().min(0).max(1439),
-	endMinute: number().int().min(1).max(1440)
+	day: number().int().min(0).max(6).meta(readingMeta("none")),
+	startMinute: number().int().min(0).max(1439).meta(readingMeta("none")),
+	endMinute: number().int().min(1).max(1440).meta(readingMeta("none"))
 });
 /** Status of one physical volume, as the camera itself describes it. */
 var OnboardStorageVolumeSchema = object({
@@ -66505,10 +66826,10 @@ var RecordingOnboardStatusSchema = object({
 	/** Master "record to the card at all" switch. */
 	enabled: boolean().nullable(),
 	overwriteWhenFull: boolean().nullable(),
-	preRecordSec: number().nullable(),
-	postRecordSec: number().nullable(),
+	preRecordSec: number().nullable().meta(readingMeta("duration")),
+	postRecordSec: number().nullable().meta(readingMeta("duration")),
 	/** Length of one recorded file, in minutes. */
-	segmentMinutes: number().nullable(),
+	segmentMinutes: number().nullable().meta(readingMeta("none")),
 	/** The primary track's weekly windows, flattened. */
 	windows: array(RecordWindowSchema),
 	/**
@@ -66524,7 +66845,7 @@ var RecordingOnboardStatusSchema = object({
 	* provider reporting a non-zero count also reports the schedule as not
 	* writable.
 	*/
-	unreadableWindows: number(),
+	unreadableWindows: number().meta(readingMeta("count")),
 	/**
 	* The camera is scheduled to record and has NO usable storage.
 	*
@@ -67369,7 +67690,7 @@ var CamStreamDescriptorSchema = object({
 	url: string().optional(),
 	codec: string().optional(),
 	resolution: CamStreamResolutionSchema.optional(),
-	fps: number().positive().optional(),
+	fps: number().positive().optional().meta(readingMeta("rate")),
 	label: string().optional(),
 	/** Device-level features (e.g. `battery-operated`) — drives broker policy. */
 	deviceFeatures: array(string()).optional(),
@@ -67456,18 +67777,18 @@ var StreamProfileSchema = _enum([
 ]);
 /** The current encoding config of one stream profile. */
 var StreamProfileConfigSchema = object({
-	width: number(),
-	height: number(),
+	width: number().meta(readingMeta("none")),
+	height: number().meta(readingMeta("none")),
 	codec: _enum(["h264", "h265"]),
-	framerate: number(),
-	bitrate: number(),
+	framerate: number().meta(readingMeta("rate")),
+	bitrate: number().meta(readingMeta("bitrate")),
 	bitrateMode: _enum(["vbr", "cbr"]).optional(),
 	encoderProfile: _enum([
 		"high",
 		"main",
 		"baseline"
 	]).optional(),
-	gop: number().optional(),
+	gop: number().optional().meta(readingMeta("none")),
 	/**
 	* Whether THIS profile currently carries an audio track. READ-ONLY here.
 	*
@@ -67688,12 +68009,7 @@ var switchCapability = {
 			label: "On",
 			kind: "boolean"
 		}
-	}] },
-	customize: {
-		version: 1,
-		advanced: "derive",
-		targets: []
-	}
+	}] }
 };
 /** C0 controls, DEL and the C1 range: none of them belongs in a name. */
 function hasControlCharacter(value) {
@@ -68276,35 +68592,21 @@ var tamperCapability = {
 * entries with `device_class: temperature` and any future native
 * thermometer.
 *
-* Unit normalisation: providers convert to Celsius before storing.
-* The slice value is always Celsius so cross-cap aggregators
-* (climate-control's `currentTemp`, energy analytics) can compose
-* without per-source unit fixups. The canonical display unit (`°C`) is
-* a descriptor constant in the UI (ROLE_DESCRIPTOR), not stored in
-* `sourceInfo`.
+* The number is Celsius (D944). Providers convert on ingest. A failed
+* conversion is `null`, never a guess. Display unit is a read-time preference.
 *
 * Status `lastFetchedAt` lets staleness-aware consumers detect a
 * frozen feed (provider hung) distinct from a "temperature hasn't
 * changed" steady state.
 */
 var TemperatureSensorStatusSchema = object({
-	/** Current temperature in Celsius. */
-	celsius: number().meta({
-		unit: "°C",
+	/** Current temperature in Celsius. `null` when the sample was refused (D393). */
+	celsius: number().nullable().meta(readingMeta("temperature", {
+		precision: 1,
 		label: "Temperature"
-	}),
+	})),
 	/** Ms epoch when the slice was last updated (push or poll). */
-	lastFetchedAt: number(),
-	/** Live display unit from the upstream source (e.g. HA
-	*  `attributes.unit_of_measurement`). The UI prefers this over the
-	*  role's canonical unit, so a Fahrenheit feed renders '°F' not '°C'.
-	*  Absent → the UI falls back to the role's canonical unit. */
-	unit: string().optional(),
-	/** Suggested decimal places for numeric display.
-	*  Populated live from the upstream source when provided (e.g. HA
-	*  `attributes.suggested_display_precision`). Falls back to
-	*  auto-formatting when absent. */
-	precision: number().int().min(0).max(10).optional()
+	lastFetchedAt: number()
 });
 var temperatureSensorCapability = {
 	name: "temperature-sensor",
@@ -68335,12 +68637,7 @@ var temperatureSensorCapability = {
 	} } },
 	/** Clock fields: written, but excluded from the compare that decides
 	*  whether persisting is worth a SQLite commit. */
-	volatileStateFields: ["lastFetchedAt"],
-	customize: {
-		version: 1,
-		advanced: "derive",
-		targets: []
-	}
+	volatileStateFields: ["lastFetchedAt"]
 };
 /**
 * toast — system-scoped singleton capability that streams toast
@@ -68623,16 +68920,16 @@ var VacuumControlStatusSchema = object({
 	]),
 	/** 0..100 battery percentage. Null when the device has no battery
 	*  reading. */
-	batteryLevel: number().min(0).max(100).nullable(),
+	batteryLevel: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** Current fan-speed token (provider-verbatim). Null when unknown or
 	*  the vacuum has no speed control. */
 	fanSpeed: string().nullable(),
 	/** Speed tokens the hardware accepts — drives the UI selector. */
 	availableFanSpeeds: array(string()),
 	/** 0..100 cleaning-completion percentage of the current task, or null. */
-	progressPercent: number().min(0).max(100).nullable(),
+	progressPercent: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** Current error code (0 / null = no error). */
-	errorCode: number().nullable(),
+	errorCode: number().nullable().meta(readingMeta("none")),
 	/** Human label for {@link errorCode}, or null when none / undecodable. */
 	errorLabel: string().nullable(),
 	/** Ms epoch when the slice was last updated. */
@@ -68710,7 +69007,7 @@ var ValveStatusSchema = object({
 	]),
 	/** 0 = fully closed, 100 = fully open. Null when the device has no
 	*  intermediate position surface. */
-	position: number().min(0).max(100).nullable(),
+	position: number().min(0).max(100).nullable().meta(readingMeta("percentage")),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number()
 });
@@ -68818,9 +69115,9 @@ var vibrationCapability = {
 */
 var WaterHeaterStatusSchema = object({
 	/** Current measured temperature. Null when not reported. */
-	currentTemp: number().nullable(),
+	currentTemp: number().nullable().meta(readingMeta("temperature")),
 	/** Target temperature setpoint. Null when no setpoint surface. */
-	targetTemp: number().nullable(),
+	targetTemp: number().nullable().meta(readingMeta("temperature")),
 	/** Active operation mode = HA `state` (`eco` / `electric` / `gas` /
 	*  `heat_pump` / `high_demand` / `performance` / `off`). Null when the
 	*  device reports an unknown state. */
@@ -68831,9 +69128,9 @@ var WaterHeaterStatusSchema = object({
 	*  has no away surface. */
 	away: boolean().nullable(),
 	/** HA `min_temp` attribute. Null when not reported. */
-	minTemp: number().nullable(),
+	minTemp: number().nullable().meta(readingMeta("temperature")),
 	/** HA `max_temp` attribute. Null when not reported. */
-	maxTemp: number().nullable(),
+	maxTemp: number().nullable().meta(readingMeta("temperature")),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number()
 });
@@ -68918,25 +69215,18 @@ var waterHeaterCapability = {
 * Forecast deferred — current conditions only for v1.
 */
 var WeatherStatusSchema = object({
-	/** Verbatim HA condition state (`sunny`, `cloudy`, `rainy`, …). Null
-	*  when no condition has been reported yet. */
+	/** Verbatim condition state (`sunny`, `cloudy`, `rainy`, …). Null when none yet. */
 	condition: string().nullable(),
-	/** Current temperature in the reported unit. Null when not provided. */
-	temperature: number().nullable(),
-	/** Temperature unit string (e.g. `°C` / `°F`). Null when not provided. */
-	temperatureUnit: string().nullable(),
+	/** Current temperature in Celsius. Null when not provided or refused. */
+	temperature: number().nullable().meta(readingMeta("temperature", { precision: 1 })),
 	/** Relative humidity (0..100). Null when not provided. */
-	humidity: number().min(0).max(100).nullable(),
-	/** Barometric pressure in the reported unit. Null when not provided. */
-	pressure: number().nullable(),
-	/** Pressure unit string (e.g. `hPa` / `inHg`). Null when not provided. */
-	pressureUnit: string().nullable(),
-	/** Wind speed in the reported unit. Null when not provided. */
-	windSpeed: number().nullable(),
-	/** Wind-speed unit string (e.g. `km/h` / `mph`). Null when not provided. */
-	windSpeedUnit: string().nullable(),
+	humidity: number().min(0).max(100).nullable().meta(readingMeta("humidity")),
+	/** Barometric pressure in hPa. Null when not provided or refused. */
+	pressure: number().nullable().meta(readingMeta("pressure")),
+	/** Wind speed in metres per second. Null when not provided or refused. */
+	windSpeed: number().nullable().meta(readingMeta("speed")),
 	/** Wind bearing in degrees (0..360, meteorological). Null when not provided. */
-	windBearing: number().nullable(),
+	windBearing: number().nullable().meta(readingMeta("angle")),
 	/** Ms epoch when the slice was last updated. */
 	lastFetchedAt: number()
 });
@@ -68964,12 +69254,12 @@ var weatherCapability = {
 	*/
 	durability: "session",
 	/**
-	* History (D850): recorded series. Units follow the sibling `*Unit` fields.
+	* History (D850): recorded series. Numbers are the quantity base (D944).
 	*/
 	history: { fields: {
 		temperature: {
 			kind: "gauge",
-			unitFrom: "temperatureUnit",
+			unit: "°C",
 			deadband: .2
 		},
 		humidity: {
@@ -68979,12 +69269,12 @@ var weatherCapability = {
 		},
 		pressure: {
 			kind: "gauge",
-			unitFrom: "pressureUnit",
+			unit: "hPa",
 			deadband: .5
 		},
 		windSpeed: {
 			kind: "gauge",
-			unitFrom: "windSpeedUnit",
+			unit: "m/s",
 			deadband: .5
 		}
 	} }
@@ -69922,6 +70212,404 @@ function runningFromMediaPlayer(state, previous, fetchedAt, transitionAt) {
 	if (state === "paused") return nativeSlice(false, "paused", previous, transitionAtMs, fetchedAt, null);
 	return nativeSlice(false, state, previous, transitionAtMs, fetchedAt, null);
 }
+/**
+* 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
+	}
+};
+/** 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;
+}
+/**
+* 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);
+}
+/**
+* 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;
+}
 SOURCE_CAPS.filter((cap) => cap !== "switch" && cap !== "motion");
 DeviceType.Camera, DeviceType.Sensor, DeviceType.Button, DeviceType.Switch, DeviceType.PetFeeder, DeviceType.Container, DeviceType.Thermostat, DeviceType.Camera, DeviceType.Hub, DeviceType.Light, DeviceType.Siren, DeviceType.Switch, DeviceType.Sensor, DeviceType.Thermostat, DeviceType.Climate, DeviceType.Button, DeviceType.EventEmitter, DeviceType.Update, DeviceType.Generic, DeviceType.Notifier, DeviceType.Script, DeviceType.Automation, DeviceType.Lock, DeviceType.Cover, DeviceType.Valve, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.Dishwasher, DeviceType.Camera, DeviceType.Camera, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer, DeviceType.WaterHeater, DeviceType.Humidifier, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.PetFeeder;
 String.raw`rose\(active(\d+), changed(\d+), (\d+(?:\.\d+)?)\)`;
@@ -70252,6 +70940,7 @@ var DEVICE_LOCAL_STATE_CAPS = {
 	featureProbe: featureProbeCapability,
 	flood: floodCapability,
 	gas: gasCapability,
+	groupStatus: groupStatusCapability,
 	heatingValve: heatingValveCapability,
 	humidifier: humidifierCapability,
 	humiditySensor: humiditySensorCapability,
@@ -74736,6 +75425,13 @@ Object.freeze({
 		access: "view",
 		role: "viewer"
 	},
+	"groupStatus.getStatus": {
+		capName: "group-status",
+		capScope: "device",
+		addonId: null,
+		access: "view",
+		role: "viewer"
+	},
 	"heatingValve.getStatus": {
 		capName: "heating-valve",
 		capScope: "device",
@@ -84558,6 +85254,33 @@ var SENSOR_CAP_VOCABULARY = {
 			icon: "flame"
 		}]
 	},
+	"group-status": {
+		scope: "device",
+		noun: t("Group", "Gruppo"),
+		state: [
+			{
+				kind: "numeric",
+				field: "included",
+				quantity: t("the members reporting", "i membri che rispondono"),
+				label: t("Reporting", "Rispondono"),
+				icon: "users"
+			},
+			{
+				kind: "numeric",
+				field: "excluded",
+				quantity: t("the members left out", "i membri esclusi"),
+				label: t("Excluded", "Esclusi"),
+				icon: "users"
+			},
+			{
+				kind: "numeric",
+				field: "total",
+				quantity: t("the member count", "il numero di membri"),
+				label: t("Members", "Membri"),
+				icon: "sigma"
+			}
+		]
+	},
 	"humidity-sensor": {
 		scope: "device",
 		noun: t("Humidity", "Umidità"),
@@ -84591,7 +85314,6 @@ var SENSOR_CAP_VOCABULARY = {
 			field: "value",
 			quantity: t("the reading", "il valore"),
 			label: t("Reading", "Valore"),
-			unitField: "unit",
 			icon: "gauge"
 		}]
 	},
@@ -84727,7 +85449,7 @@ var SENSOR_CAP_VOCABULARY = {
 				field: "temperature",
 				quantity: t("the outdoor temperature", "la temperatura esterna"),
 				label: t("Temperature", "Temperatura"),
-				unitField: "temperatureUnit",
+				unit: "°C",
 				icon: "thermometer"
 			},
 			{
@@ -84743,7 +85465,7 @@ var SENSOR_CAP_VOCABULARY = {
 				field: "windSpeed",
 				quantity: t("the wind speed", "la velocità del vento"),
 				label: t("Wind", "Vento"),
-				unitField: "windSpeedUnit",
+				unit: "m/s",
 				icon: "wind"
 			},
 			{
@@ -84751,7 +85473,7 @@ var SENSOR_CAP_VOCABULARY = {
 				field: "pressure",
 				quantity: t("the air pressure", "la pressione atmosferica"),
 				label: t("Pressure", "Pressione"),
-				unitField: "pressureUnit",
+				unit: "hPa",
 				icon: "gauge"
 			}
 		]
@@ -86024,6 +86746,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"groupStatus.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"heatingValve.getStatus": [{
 		name: "deviceId",
 		form: "single",
@@ -89324,6 +90051,96 @@ DEFAULT_NATIVE_LEASE_SETTINGS.tileBudgetMb;
 DEFAULT_NATIVE_LEASE_SETTINGS.sceneBudgetMb;
 DEFAULT_NATIVE_LEASE_SETTINGS.admission;
 /**
+* Convert an upstream number into the stored base of its quantity (D944 §4).
+* An unknown unit or a unit from another dimension is a refusal: the caller
+* logs it and publishes null (D393). This function never guesses.
+*/
+var DIMENSION_QUANTITY = {
+	temperature: "temperature",
+	pressure: "pressure",
+	speed: "speed",
+	"precipitation-rate": "precipitation-rate",
+	length: "length",
+	area: "area",
+	illuminance: "illuminance",
+	irradiance: "irradiance",
+	power: "power",
+	"apparent-power": "apparent-power",
+	energy: "energy",
+	voltage: "voltage",
+	current: "current",
+	"concentration-volume": "concentration-volume",
+	"concentration-mass": "concentration-mass",
+	mass: "mass",
+	percentage: "percentage",
+	volume: "volume",
+	duration: "duration",
+	information: "information",
+	angle: "angle",
+	"sound-level": "sound-level",
+	"signal-level": "signal-level",
+	"colour-temperature": "colour-temperature",
+	bitrate: "bitrate",
+	rate: "rate"
+};
+/**
+* Quantity implied by a unit symbol. `ppb` and `ms` are the two symbols
+* whose stored base is not the dimension's canonical unit. `mm` is length;
+* precipitation is chosen by the caller (a device class), not by the symbol.
+*/
+function quantityFromUnit(rawUnit) {
+	const unit = normalizeUnit(rawUnit);
+	if (unit === void 0) return void 0;
+	if (unit === "ppb") return "concentration-ppb";
+	if (unit === "ms") return "duration-ms";
+	const dimension = unitDimension(unit);
+	if (dimension === void 0) return void 0;
+	return DIMENSION_QUANTITY[dimension];
+}
+function ingestReading(input) {
+	if (!Number.isFinite(input.value)) return {
+		ok: false,
+		reason: "non-finite"
+	};
+	if (input.quantity === "device") return {
+		ok: false,
+		reason: "unknown-unit"
+	};
+	const raw = input.rawUnit?.trim();
+	if (raw === void 0 || raw.length === 0) return {
+		ok: true,
+		value: input.value
+	};
+	const unit = normalizeUnit(raw);
+	if (unit === void 0) return {
+		ok: false,
+		reason: "unknown-unit"
+	};
+	const base = baseUnitOf(input.quantity);
+	if (base === void 0) {
+		if (unitDimension(unit) !== void 0) return {
+			ok: false,
+			reason: "cross-dimension"
+		};
+		return {
+			ok: false,
+			reason: "unknown-unit"
+		};
+	}
+	const converted = tryConvertUnit(input.value, unit, base);
+	if (converted === void 0) return unitDimension(unit) === void 0 ? {
+		ok: false,
+		reason: "unknown-unit"
+	} : {
+		ok: false,
+		reason: "cross-dimension"
+	};
+	return {
+		ok: true,
+		value: converted
+	};
+}
+/**
 * Pure fuzzy matcher for adoption location import. Normalized
 * case-insensitive Levenshtein similarity, used to reuse an existing
 * CamStack location when an imported source location (e.g. an HA area) is
@@ -89552,6 +90369,12 @@ Object.defineProperty(exports, "automationControlCapability", {
 		return automationControlCapability;
 	}
 });
+Object.defineProperty(exports, "baseUnitOf", {
+	enumerable: true,
+	get: function() {
+		return baseUnitOf;
+	}
+});
 Object.defineProperty(exports, "batteryCapability", {
 	enumerable: true,
 	get: function() {
@@ -89768,6 +90591,18 @@ Object.defineProperty(exports, "imageCapability", {
 		return imageCapability;
 	}
 });
+Object.defineProperty(exports, "ingestReading", {
+	enumerable: true,
+	get: function() {
+		return ingestReading;
+	}
+});
+Object.defineProperty(exports, "isReadingQuantity", {
+	enumerable: true,
+	get: function() {
+		return isReadingQuantity;
+	}
+});
 Object.defineProperty(exports, "lawnMowerControlCapability", {
 	enumerable: true,
 	get: function() {
@@ -89876,6 +90711,12 @@ Object.defineProperty(exports, "pressureSensorCapability", {
 		return pressureSensorCapability;
 	}
 });
+Object.defineProperty(exports, "quantityFromUnit", {
+	enumerable: true,
+	get: function() {
+		return quantityFromUnit;
+	}
+});
 Object.defineProperty(exports, "record", {
 	enumerable: true,
 	get: function() {
@@ -89942,6 +90783,18 @@ Object.defineProperty(exports, "temperatureSensorCapability", {
 		return temperatureSensorCapability;
 	}
 });
+Object.defineProperty(exports, "tryConvertDelta", {
+	enumerable: true,
+	get: function() {
+		return tryConvertDelta;
+	}
+});
+Object.defineProperty(exports, "tryConvertUnit", {
+	enumerable: true,
+	get: function() {
+		return tryConvertUnit;
+	}
+});
 Object.defineProperty(exports, "union", {
 	enumerable: true,
 	get: function() {