@camstack/types 1.2.416 → 1.2.417

package/dist/index.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-BPQ2ZyaI.js");
+const require_sleep = require("./sleep-gtskVoMw.js");
 const require_event_category = require("./event-category-DXZ3f9Q5.js");
 const require_composition = require("./composition-DsmkwP9-.js");
 const require_node_color = require("./node-color.js");
@@ -12398,6 +12398,17 @@ function unwrapSchema(schema) {
 	while (s instanceof zod.z.ZodNullable || s instanceof zod.z.ZodOptional || s instanceof zod.z.ZodDefault) s = s.unwrap();
 	return s;
 }
+function isMetaBag(value) {
+	return typeof value === "object" && value !== null;
+}
+function metaQuantity(schema) {
+	const bag = zod.z.globalRegistry.get(schema);
+	if (isMetaBag(bag) && require_sleep.isReadingQuantity(bag.quantity)) return bag.quantity;
+}
+/** Quantity declared with `readingMeta` on the field or on the unwrapped leaf. */
+function quantityOfField(schema) {
+	return metaQuantity(schema) ?? metaQuantity(unwrapSchema(schema));
+}
 function leafKind(schema) {
 	const s = unwrapSchema(schema);
 	if (s instanceof zod.z.ZodEnum) return {
@@ -12426,11 +12437,15 @@ function enumerateSchemaFields(schema, prefix = "") {
 			continue;
 		}
 		const leaf = leafKind(field);
-		if (leaf) out.push({
-			path,
-			kind: leaf.kind,
-			...leaf.enumValues ? { enumValues: leaf.enumValues } : {}
-		});
+		if (leaf) {
+			const quantity = quantityOfField(field);
+			out.push({
+				path,
+				kind: leaf.kind,
+				...leaf.enumValues ? { enumValues: leaf.enumValues } : {},
+				...quantity !== void 0 ? { quantity } : {}
+			});
+		}
 	}
 	return out;
 }
@@ -12491,7 +12506,7 @@ function requiredTopLevelKeys(schema) {
 /**
 * The proper prefixes of `path` whose schema accepts `undefined`: a required
 * leaf under one of them is required only once something writes that parent
-* (`remaining.unit` is required only when `remaining` is present).
+* (`remaining.kind` is required only when `remaining` is present).
 */
 function optionalAncestors(schema, path) {
 	const segments = path.split(".");
@@ -12608,7 +12623,8 @@ var CompositionProblemCodeSchema = zod.z.enum([
 	"item-field-reserved",
 	"target-missing",
 	"target-unreadable",
-	"not-replaceable"
+	"not-replaceable",
+	"native-capability-replace"
 ]);
 /** One refusal, named (D391). `path` points into the composition, e.g. `features[0].fields.celsius`. */
 var CompositionProblemSchema = zod.z.object({
@@ -12674,9 +12690,11 @@ function compositionFieldKey(plan) {
 	return `${plan.cap}.${path}`;
 }
 /**
-* 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 = zod.z.enum([
 	"new",
@@ -13510,6 +13528,9 @@ function isNativeCap(target, cap) {
 	const owner = target.nativeCaps.get(cap);
 	return owner !== void 0 && owner !== "composer";
 }
+function isPlanProblem(value) {
+	return "code" in value;
+}
 /** The target read, or the refusal that replaces the whole plan when it could not be (D391). */
 function planTargetOf(composition, target) {
 	if (composition.target.kind === "new") return {
@@ -13525,26 +13546,59 @@ function planTargetOf(composition, target) {
 		found: target
 	};
 }
-function featureTargetOf(target, cap) {
+var NATIVE_REPLACE_KEPT = new Set([
+	"not-composable",
+	"unknown-capability",
+	"reserved-variant"
+]);
+/** A native override is refused, unless the cap cannot be composed at all — that reason stays. */
+function nativeReplaceOrBlock(refusal, probed) {
+	const kept = probed.problems.filter((item) => NATIVE_REPLACE_KEPT.has(item.code));
+	if (kept.length > 0) return {
+		problems: kept,
+		fields: [],
+		features: [],
+		events: []
+	};
+	return refused(refusal);
+}
+function featureTargetOf(target, cap, at) {
 	if (target.kind === "new") return {
 		mode: "new",
 		deviceType: target.type
 	};
+	if (isNativeCap(target.found, cap)) return problem("native-capability-replace", at, `native-capability-replace: stored override replaces native capability \`${cap}\` on device ${target.found.deviceId} — refused (D944)`);
 	return {
-		mode: isNativeCap(target.found, cap) ? "replace" : "add",
+		mode: "add",
 		deviceType: target.found.type
 	};
 }
 /**
 * The static plan. `target` describes an EXISTING target device (one read);
-* it is ignored for a new one. On an existing target each feature REPLACES a
-* cap the device has natively, else ADDS it (D663).
+* it is ignored for a new one. On an existing target each feature ADDS a cap
+* the device lacks. A feature that would replace a native capability is
+* refused by name (D944). A new device is unchanged.
 */
 function planComposition(composition, lookupCap, target) {
 	const planTarget = planTargetOf(composition, target);
 	if ("code" in planTarget) return refused(planTarget);
 	const results = composition.features.map((feature, index) => {
-		const result = feature.kind === "passthrough" ? refused(problem("reserved-variant", `features[${index}]`, `whole-capability passthrough of \`${feature.cap}\` arrives in slice 3`)) : planFeature(feature, index, featureTargetOf(planTarget, feature.cap), lookupCap);
+		const at = `features[${index}]`;
+		if (feature.kind === "passthrough") return refused(problem("reserved-variant", at, `whole-capability passthrough of \`${feature.cap}\` arrives in slice 3`));
+		const featureTarget = featureTargetOf(planTarget, feature.cap, at);
+		if (isPlanProblem(featureTarget)) {
+			if (!require_composition.compositionFeatureEnabled(feature) || planTarget.kind !== "existing") return {
+				problems: [],
+				fields: [],
+				features: [],
+				events: []
+			};
+			return nativeReplaceOrBlock(featureTarget, planFeature(feature, index, {
+				mode: "add",
+				deviceType: planTarget.found.type
+			}, lookupCap));
+		}
+		const result = planFeature(feature, index, featureTarget, lookupCap);
 		return require_composition.compositionFeatureEnabled(feature) ? result : {
 			problems: result.problems,
 			fields: [],
@@ -13685,7 +13739,11 @@ function cycleProblems(composition, ctx, fields, self) {
 function validateComposition(composition, ctx) {
 	const plan = planComposition(composition, ctx.lookupCap, ctx.target ?? void 0);
 	const self = candidateSelf(composition, ctx, plan);
-	const cycles = cycleProblems(composition, ctx, plan.fields, self);
+	const refusedFeatures = plan.problems.filter((item) => item.code === "native-capability-replace").map((item) => item.path);
+	const cycles = cycleProblems(composition, ctx, plan.fields, self).filter((item) => {
+		if (refusedFeatures.some((at) => item.path === at || item.path.startsWith(`${at}.`))) return false;
+		return refusedFeatures.length === 0 || item.path !== "features";
+	});
 	const problems = [
 		...plan.problems,
 		...sourceProblems(plan.fields, ctx, self),
@@ -16432,12 +16490,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`
@@ -16451,6 +16509,14 @@ var SourceInfoSchema = zod.z.object({
 	/** Immutable upstream identifier when available (HA `unique_id`, … ).
 	*  Used to detect rename when `id` changes. */
 	uniqueId: zod.z.string().optional(),
+	/** Quantity of a polymorphic reading, written once at adopt (D944). */
+	quantity: require_sleep.ReadingQuantitySchema.optional(),
+	/** Date / time / datetime shape of a string reading, written once at adopt. */
+	dateTimeShape: zod.z.enum([
+		"date",
+		"time",
+		"datetime"
+	]).optional(),
 	/** Provider-specific extras that don't fit the structured slots.
 	*  Whitelist what goes here per provider — do NOT dump entire HA
 	*  attribute blobs (would explode the meta JSON column). */
@@ -16535,9 +16601,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;
 }
 /**
@@ -37969,7 +38064,8 @@ var deviceManagerCapability = {
 					"enum"
 				]),
 				enumValues: zod.z.array(zod.z.string()).optional(),
-				item: zod.z.boolean().optional()
+				item: zod.z.boolean().optional(),
+				quantity: require_sleep.ReadingQuantitySchema.optional()
 			})).readonly(),
 			itemArray: zod.z.object({
 				path: zod.z.string(),
@@ -44293,8 +44389,8 @@ var MaskPolygonShapeSchema = zod.z.object({
 /** Boolean cell grid — row-major, length === gridWidth*gridHeight. */
 var MaskGridShapeSchema = zod.z.object({
 	kind: zod.z.literal("grid"),
-	gridWidth: zod.z.number(),
-	gridHeight: zod.z.number(),
+	gridWidth: zod.z.number().meta(require_sleep.readingMeta("none")),
+	gridHeight: zod.z.number().meta(require_sleep.readingMeta("none")),
 	cells: zod.z.array(zod.z.boolean())
 });
 /** Directed line / tripwire — an ordered list of normalized points (≥2). */
@@ -60558,27 +60654,17 @@ var addonsCapability = {
 */
 var AirQualitySensorStatusSchema = zod.z.object({
 	/** Carbon dioxide concentration in ppm. */
-	co2Ppm: zod.z.number().min(0).optional(),
+	co2Ppm: zod.z.number().min(0).optional().meta(require_sleep.readingMeta("concentration-volume")),
 	/** Total volatile organic compounds in ppb. */
-	vocPpb: zod.z.number().min(0).optional(),
+	vocPpb: zod.z.number().min(0).optional().meta(require_sleep.readingMeta("concentration-ppb")),
 	/** Particulate matter ≤ 2.5 μm in µg/m³. */
-	pm25: zod.z.number().min(0).optional(),
+	pm25: zod.z.number().min(0).optional().meta(require_sleep.readingMeta("concentration-mass")),
 	/** Particulate matter ≤ 10 μm in µg/m³. */
-	pm10: zod.z.number().min(0).optional(),
+	pm10: zod.z.number().min(0).optional().meta(require_sleep.readingMeta("concentration-mass")),
 	/** Composite AQI value (typically 0..500). */
-	aqi: zod.z.number().optional(),
+	aqi: zod.z.number().optional().meta(require_sleep.readingMeta("index")),
 	/** Ms epoch when the slice was last updated. */
-	lastFetchedAt: zod.z.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: zod.z.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: zod.z.number().int().min(0).max(10).optional()
+	lastFetchedAt: zod.z.number()
 });
 var airQualitySensorCapability = {
 	name: "air-quality-sensor",
@@ -60615,12 +60701,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: {
@@ -60640,22 +60726,13 @@ var airQualitySensorCapability = {
 * entries with `device_class: illuminance`.
 */
 var AmbientLightSensorStatusSchema = zod.z.object({
-	/** Current illuminance in lux (lx). */
-	lux: zod.z.number().min(0).meta({
-		unit: "lx",
+	/** Current illuminance in lux (lx). `null` when the sample was refused (D393). */
+	lux: zod.z.number().min(0).nullable().meta(require_sleep.readingMeta("illuminance", {
+		precision: 0,
 		label: "Illuminance"
-	}),
+	})),
 	/** Ms epoch when the slice was last updated. */
-	lastFetchedAt: zod.z.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: zod.z.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: zod.z.number().int().min(0).max(10).optional()
+	lastFetchedAt: zod.z.number()
 });
 var ambientLightSensorCapability = {
 	name: "ambient-light-sensor",
@@ -60687,12 +60764,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"]
 };
 //#endregion
 //#region src/capabilities/audio-metrics.cap.ts
@@ -60934,10 +61006,7 @@ var BatteryStatusSchema = zod.z.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: zod.z.number().min(0).max(100).nullable().meta({
-		unit: "%",
-		label: "Charge"
-	}),
+	percentage: zod.z.number().min(0).max(100).nullable().meta(require_sleep.readingMeta("percentage", { label: "Charge" })),
 	/**
 	* Charging source. `'dc'` covers wall/USB adapters; `'solar'` is
 	* Reolink-specific for the Solar Panel 2 accessory (will become
@@ -60964,7 +61033,14 @@ var BatteryStatusSchema = zod.z.object({
 	*/
 	sleeping: zod.z.boolean().meta({ label: "Sleeping" }),
 	/** Ms epoch of the last observation. Lets consumers reason about freshness. */
-	lastUpdated: zod.z.number(),
+	lastUpdated: zod.z.number().meta(require_sleep.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: zod.z.number().nullable().optional().meta(require_sleep.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
@@ -61016,7 +61092,6 @@ var BATTERY_DEVICE_TYPES = [
 /** Generic Customize target for the percentage reading (D936). */
 var batteryCustomize = {
 	version: 1,
-	advanced: "derive",
 	targets: [{
 		id: "percentage",
 		cardinality: "scalar",
@@ -61025,7 +61100,7 @@ var batteryCustomize = {
 			stateField: "percentage"
 		},
 		deviceTypes: BATTERY_DEVICE_TYPES,
-		apply: "add-or-replace",
+		apply: "add",
 		path: "percentage",
 		sources: [{
 			kind: "field",
@@ -61146,10 +61221,16 @@ onStatusChanged: { data: zod.z.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. */
@@ -61198,12 +61279,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"]
 };
 //#endregion
 //#region src/capabilities/brightness.cap.ts
@@ -61221,7 +61297,7 @@ var binaryCapability = {
 */
 var BrightnessStatusSchema = zod.z.object({
 	/** Current level as 0..100 inclusive. Firmware-reported. */
-	percentage: zod.z.number().min(0).max(100),
+	percentage: zod.z.number().min(0).max(100).meta(require_sleep.readingMeta("percentage")),
 	/** Ms epoch of the last operator-driven change. Useful for UI freshness. */
 	lastChangedAt: zod.z.number()
 });
@@ -61820,21 +61896,21 @@ var ClimateControlStatusSchema = zod.z.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: zod.z.number().nullable(),
+	target: zod.z.number().nullable().meta(require_sleep.readingMeta("temperature")),
 	/** Upper bound of the dual setpoint in Celsius. Populated only
 	*  in `heat_cool` mode. */
-	targetHigh: zod.z.number().nullable(),
+	targetHigh: zod.z.number().nullable().meta(require_sleep.readingMeta("temperature")),
 	/** Lower bound of the dual setpoint in Celsius. Populated only
 	*  in `heat_cool` mode. */
-	targetLow: zod.z.number().nullable(),
+	targetLow: zod.z.number().nullable().meta(require_sleep.readingMeta("temperature")),
 	/** Target relative humidity (0..100). Null when the device has no
 	*  humidity control. */
-	targetHumidity: zod.z.number().min(0).max(100).nullable(),
+	targetHumidity: zod.z.number().min(0).max(100).nullable().meta(require_sleep.readingMeta("humidity")),
 	/** Current measured temperature in Celsius. Read-only — pushed by
 	*  the device's internal sensor. */
-	currentTemp: zod.z.number().nullable(),
+	currentTemp: zod.z.number().nullable().meta(require_sleep.readingMeta("temperature")),
 	/** Current measured relative humidity (0..100). Read-only. */
-	currentHumidity: zod.z.number().min(0).max(100).nullable(),
+	currentHumidity: zod.z.number().min(0).max(100).nullable().meta(require_sleep.readingMeta("humidity")),
 	/** Vertical louver swing on/off. Null when the device has no vertical
 	*  swing surface (gate with `DeviceFeature.ClimateSwingVertical`). */
 	swingVertical: zod.z.boolean().nullable(),
@@ -61842,11 +61918,11 @@ var ClimateControlStatusSchema = zod.z.object({
 	*  horizontal swing surface (gate with `DeviceFeature.ClimateSwingHorizontal`). */
 	swingHorizontal: zod.z.boolean().nullable(),
 	/** Lowest setpoint the device accepts, Celsius. Absent / null = not reported. */
-	minTemp: zod.z.number().nullable().optional(),
+	minTemp: zod.z.number().nullable().optional().meta(require_sleep.readingMeta("temperature")),
 	/** Highest setpoint the device accepts, Celsius. Absent / null = not reported. */
-	maxTemp: zod.z.number().nullable().optional(),
+	maxTemp: zod.z.number().nullable().optional().meta(require_sleep.readingMeta("temperature")),
 	/** Setpoint granularity, Celsius (0.5, 1). Absent / null = not reported. */
-	tempStep: zod.z.number().positive().nullable().optional(),
+	tempStep: zod.z.number().positive().nullable().optional().meta(require_sleep.readingMeta("temperature")),
 	/** Ms epoch when the slice was last updated (push or command). */
 	lastFetchedAt: zod.z.number()
 });
@@ -61990,17 +62066,17 @@ var climateControlCapability = {
 * modes to expose in the picker without a slice fetch.
 */
 var RgbTripletSchema = zod.z.object({
-	r: zod.z.number().int().min(0).max(255),
-	g: zod.z.number().int().min(0).max(255),
-	b: zod.z.number().int().min(0).max(255)
+	r: zod.z.number().int().min(0).max(255).meta(require_sleep.readingMeta("none")),
+	g: zod.z.number().int().min(0).max(255).meta(require_sleep.readingMeta("none")),
+	b: zod.z.number().int().min(0).max(255).meta(require_sleep.readingMeta("none"))
 });
 var HsvTripletSchema = zod.z.object({
 	/** Hue in degrees, 0..360. */
-	h: zod.z.number().min(0).max(360),
+	h: zod.z.number().min(0).max(360).meta(require_sleep.readingMeta("none")),
 	/** Saturation as 0..100 inclusive. */
-	s: zod.z.number().min(0).max(100),
+	s: zod.z.number().min(0).max(100).meta(require_sleep.readingMeta("none")),
 	/** Value/brightness as 0..100 inclusive. */
-	v: zod.z.number().min(0).max(100)
+	v: zod.z.number().min(0).max(100).meta(require_sleep.readingMeta("none"))
 });
 var ColorInputSchema = zod.z.discriminatedUnion("mode", [
 	zod.z.object({
@@ -62029,7 +62105,7 @@ var ColorStatusSchema = zod.z.object({
 	/** Populated when `mode === 'hsv'`. */
 	hsv: HsvTripletSchema.optional(),
 	/** Populated when `mode === 'mired'`. */
-	mireds: zod.z.number().int().optional(),
+	mireds: zod.z.number().int().optional().meta(require_sleep.readingMeta("colour-temperature")),
 	/** Ms epoch of the last operator-driven change. */
 	lastChangedAt: zod.z.number()
 });
@@ -62311,18 +62387,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 = zod.z.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 = zod.z.enum(["duration", "count"]);
+/** Remaining life. `value` null = unknown (D393). Duration is seconds. */
 var ConsumableRemainingSchema = zod.z.object({
-	value: zod.z.number().min(0).nullable(),
-	unit: ConsumableRemainingUnitSchema
+	value: zod.z.number().min(0).nullable().meta(require_sleep.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`
@@ -62335,7 +62405,7 @@ var ConsumableItemSchema = zod.z.object({
 	/** Display name. */
 	label: zod.z.string().min(1),
 	/** Remaining life % (`wear`) or fill % (`supply`, `waste`) when known (0..100). */
-	level: zod.z.number().min(0).max(100).nullable(),
+	level: zod.z.number().min(0).max(100).nullable().meta(require_sleep.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`. */
@@ -62417,8 +62487,8 @@ var consumablesCustomize = {
 					transforms: [{ kind: "identity" }]
 				}],
 				literals: [{
-					path: "remaining.unit",
-					values: [...ConsumableRemainingUnitSchema.options]
+					path: "remaining.kind",
+					values: [...ConsumableRemainingKindSchema.options]
 				}]
 			},
 			{
@@ -62547,7 +62617,6 @@ reset: require_sleep.method(zod.z.object({
 				},
 				"remaining.value": {
 					kind: "gauge",
-					unitFrom: "remaining.unit",
 					deadband: 1,
 					displayName: "Remaining"
 				}
@@ -62650,49 +62719,26 @@ var ControlKindSchema = zod.z.enum([
 * (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 = zod.z.object({
 	kind: ControlKindSchema,
 	/** 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: zod.z.union([zod.z.number(), zod.z.string()]),
+	value: zod.z.union([zod.z.number().meta(require_sleep.readingMeta("device")), zod.z.string()]),
 	/** Acceptable values when `kind === 'select'`. Empty for other kinds. */
 	options: zod.z.array(zod.z.string()),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: zod.z.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: zod.z.string().optional(),
-	/** Minimum allowed value. Populated live from HA `attributes.min`.
-	*  Meaningful for `kind === 'numeric'`; absent for other kinds. */
-	min: zod.z.number().optional(),
-	/** Maximum allowed value. Populated live from HA `attributes.max`.
-	*  Meaningful for `kind === 'numeric'`; absent for other kinds. */
-	max: zod.z.number().optional(),
-	/** Step increment. Populated live from HA `attributes.step`.
-	*  Meaningful for `kind === 'numeric'`; absent for other kinds. */
-	step: zod.z.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: zod.z.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: zod.z.enum([
-		"date",
-		"time",
-		"datetime"
-	]).optional()
+	/** Minimum allowed value, in the device quantity's base unit. */
+	min: zod.z.number().optional().meta(require_sleep.readingMeta("device")),
+	/** Maximum allowed value, in the device quantity's base unit. */
+	max: zod.z.number().optional().meta(require_sleep.readingMeta("device")),
+	/** Step increment, in the device quantity's base unit. */
+	step: zod.z.number().optional().meta(require_sleep.readingMeta("device"))
 });
 var ControlSetValueInputSchema = zod.z.discriminatedUnion("kind", [
 	zod.z.object({
@@ -62782,9 +62828,9 @@ var CoverStatusSchema = zod.z.object({
 	state: CoverStateSchema,
 	/** 0 = fully closed, 100 = fully open. Null when the device has
 	*  no intermediate position surface. */
-	position: zod.z.number().min(0).max(100).nullable(),
+	position: zod.z.number().min(0).max(100).nullable().meta(require_sleep.readingMeta("percentage")),
 	/** 0 = closed slats, 100 = open slats. Null when no tilt support. */
-	tiltPosition: zod.z.number().min(0).max(100).nullable(),
+	tiltPosition: zod.z.number().min(0).max(100).nullable().meta(require_sleep.readingMeta("percentage")),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: zod.z.number()
 });
@@ -62889,9 +62935,9 @@ var NormalizedRangeSchema$1 = zod.z.object({
 var DayNightStatusSchema = zod.z.object({
 	mode: DayNightModeSchema,
 	/** IR-cut trigger sensitivity, NORMALIZED 0–100 (higher = switches to night sooner). */
-	sensitivity: zod.z.number().optional(),
+	sensitivity: zod.z.number().optional().meta(require_sleep.readingMeta("none")),
 	/** Delay before the IR-cut filter flips, in seconds. */
-	switchDelaySec: zod.z.number().optional(),
+	switchDelaySec: zod.z.number().optional().meta(require_sleep.readingMeta("duration")),
 	lastFetchedAt: zod.z.number()
 });
 /**
@@ -63124,11 +63170,11 @@ var DishwasherStatusSchema = zod.z.object({
 	/** Feature keys of the programs the appliance currently offers — drives the UI selector. */
 	availablePrograms: zod.z.array(zod.z.string()),
 	/** Seconds remaining on the active cycle, or null when not running / not known. */
-	remainingSeconds: zod.z.number().int().nonnegative().nullable(),
+	remainingSeconds: zod.z.number().int().nonnegative().nullable().meta(require_sleep.readingMeta("duration")),
 	/** Seconds the delayed start is set to (time until the cycle starts), or null. */
-	delayedStartSeconds: zod.z.number().int().nonnegative().nullable(),
+	delayedStartSeconds: zod.z.number().int().nonnegative().nullable().meta(require_sleep.readingMeta("duration")),
 	/** Cycle completion 0..100, or null when not applicable. */
-	progressPercent: zod.z.number().min(0).max(100).nullable(),
+	progressPercent: zod.z.number().min(0).max(100).nullable().meta(require_sleep.readingMeta("percentage")),
 	/** True when the door is reported open; null when the door state is not known. */
 	doorOpen: zod.z.boolean().nullable(),
 	/** True when the door is latched (locked) during a cycle; null when not reported. */
@@ -63152,7 +63198,7 @@ var DishwasherStatusSchema = zod.z.object({
 	/** True while the machine-care (descaling / cleaning-program) reminder is raised; false when clear; null when not reported. */
 	machineCareDue: zod.z.boolean().nullable(),
 	/** Program runs left before the machine-care reminder is due; null when the appliance does not say. */
-	machineCareRemainingRuns: zod.z.number().int().nonnegative().nullable(),
+	machineCareRemainingRuns: zod.z.number().int().nonnegative().nullable().meta(require_sleep.readingMeta("count")),
 	/** Option states: null when the appliance does not expose the option or has not said. */
 	halfLoad: zod.z.boolean().nullable(),
 	hygienePlus: zod.z.boolean().nullable(),
@@ -63167,7 +63213,7 @@ var DishwasherStatusSchema = zod.z.object({
 	/** Feature keys of the events currently raised (salt low, rinse aid low, program finished, …). */
 	activeEvents: zod.z.array(zod.z.string()),
 	/** Numeric error code when the appliance reports one; null otherwise. */
-	errorCode: zod.z.number().nullable(),
+	errorCode: zod.z.number().nullable().meta(require_sleep.readingMeta("none")),
 	/** Name of the raised alert-level event while the appliance is in error; null otherwise. */
 	errorLabel: zod.z.string().nullable(),
 	/** Ms epoch of the last value received from the appliance; 0 = never. */
@@ -63402,7 +63448,7 @@ var DoorbellStatusSchema = zod.z.object({
 	/** Ms epoch of the last press. null = never observed since this provider started. */
 	lastPressedAt: zod.z.number().nullable(),
 	/** Counter since provider start. Resets on reboot. Useful for metrics/debug. */
-	pressCountSinceStart: zod.z.number()
+	pressCountSinceStart: zod.z.number().meta(require_sleep.readingMeta("count"))
 });
 var DoorbellPressEventSchema = zod.z.object({
 	deviceId: zod.z.number(),
@@ -63487,12 +63533,11 @@ var EnumSensorDateTimeFormatSchema = zod.z.enum([
 var EnumSensorStatusSchema = zod.z.object({
 	value: zod.z.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: zod.z.boolean().optional(),
 	/** Ms epoch when the slice was last updated. */
 	lastFetchedAt: zod.z.number()
 });
@@ -63519,11 +63564,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. */
@@ -63545,13 +63590,13 @@ var EventFireSchema = zod.z.object({
 	deviceId: zod.z.number(),
 	eventType: zod.z.string(),
 	data: zod.z.record(zod.z.string(), zod.z.unknown()).nullable(),
-	timestamp: zod.z.number(),
-	seq: zod.z.number()
+	timestamp: zod.z.number().meta(require_sleep.readingMeta("none")),
+	seq: zod.z.number().meta(require_sleep.readingMeta("count"))
 });
 var EventEmitterStatusSchema = zod.z.object({
 	eventTypes: zod.z.array(zod.z.string()),
 	lastEvent: EventFireSchema.nullable(),
-	eventCountSinceStart: zod.z.number()
+	eventCountSinceStart: zod.z.number().meta(require_sleep.readingMeta("count"))
 });
 var eventEmitterCapability = {
 	name: "event-emitter",
@@ -64008,10 +64053,10 @@ var FanDirectionSchema = zod.z.enum(["forward", "reverse"]);
 var FanControlStatusSchema = zod.z.object({
 	/** Active speed as 0..100 inclusive. Null when the device has no
 	*  speed surface (single-speed fan). */
-	percentage: zod.z.number().min(0).max(100).nullable(),
+	percentage: zod.z.number().min(0).max(100).nullable().meta(require_sleep.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: zod.z.number().positive().optional(),
+	percentageStep: zod.z.number().positive().optional().meta(require_sleep.readingMeta("percentage")),
 	/** Active preset mode (`auto` / `quiet` / `turbo` / vendor-specific)
 	*  — empty string when no preset is active or supported. */
 	preset: zod.z.string(),
@@ -64134,7 +64179,7 @@ var FeatureProbeStatusSchema = zod.z.object({
 	/** Camera/firmware model string. `null` when the firmware doesn't expose it. */
 	model: zod.z.string().nullable(),
 	/** Channel count for NVR/Hub devices; `1` for standalone cameras; `null` pre-probe. */
-	channelCount: zod.z.number().nullable(),
+	channelCount: zod.z.number().nullable().meta(require_sleep.readingMeta("count")),
 	/**
 	* Ms epoch of the last SUCCESSFUL probe. `0` before the first probe
 	* completes — drivers' `getAccessoryChildren()` should treat zero as
@@ -64265,7 +64310,7 @@ var gasCapability = {
 //#region src/capabilities/heating-valve.cap.ts
 var HeatingValveStatusSchema = zod.z.object({
 	/** Radiator valve opening 0 (closed) .. 100 (open). Null = not yet known. */
-	position: zod.z.number().min(0).max(100).nullable(),
+	position: zod.z.number().min(0).max(100).nullable().meta(require_sleep.readingMeta("percentage")),
 	/** Ms epoch when the slice was last updated (push or poll). */
 	lastFetchedAt: zod.z.number()
 });
@@ -64310,9 +64355,9 @@ var HumidifierStatusSchema = zod.z.object({
 	/** Whether the humidifier is currently on. */
 	on: zod.z.boolean(),
 	/** Current measured relative humidity (0..100). Null when not reported. */
-	currentHumidity: zod.z.number().min(0).max(100).nullable(),
+	currentHumidity: zod.z.number().min(0).max(100).nullable().meta(require_sleep.readingMeta("humidity")),
 	/** Target relative humidity (0..100). Null when no setpoint surface. */
-	targetHumidity: zod.z.number().min(0).max(100).nullable(),
+	targetHumidity: zod.z.number().min(0).max(100).nullable().meta(require_sleep.readingMeta("humidity")),
 	/** Active mode (`auto` / `normal` / `baby` / vendor). Null when the
 	*  device has no mode surface. */
 	mode: zod.z.string().nullable(),
@@ -64322,9 +64367,9 @@ var HumidifierStatusSchema = zod.z.object({
 	*  `idle` / `off`). Null when the device doesn't report it. */
 	action: zod.z.string().nullable(),
 	/** HA `min_humidity` attribute. Null → UI uses 0. */
-	minHumidity: zod.z.number().nullable(),
+	minHumidity: zod.z.number().nullable().meta(require_sleep.readingMeta("humidity")),
 	/** HA `max_humidity` attribute. Null → UI uses 100. */
-	maxHumidity: zod.z.number().nullable(),
+	maxHumidity: zod.z.number().nullable().meta(require_sleep.readingMeta("humidity")),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: zod.z.number()
 });
@@ -64396,22 +64441,13 @@ var humidifierCapability = {
 * `sourceInfo`.
 */
 var HumiditySensorStatusSchema = zod.z.object({
-	/** Current relative humidity, 0..100. */
-	percent: zod.z.number().min(0).max(100).meta({
-		unit: "%",
+	/** Current relative humidity, 0..100. `null` when the sample was refused (D393). */
+	percent: zod.z.number().min(0).max(100).nullable().meta(require_sleep.readingMeta("humidity", {
+		precision: 0,
 		label: "Humidity"
-	}),
+	})),
 	/** Ms epoch when the slice was last updated. */
-	lastFetchedAt: zod.z.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: zod.z.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: zod.z.number().int().min(0).max(10).optional()
+	lastFetchedAt: zod.z.number()
 });
 var humiditySensorCapability = {
 	name: "humidity-sensor",
@@ -64442,12 +64478,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"]
 };
 //#endregion
 //#region src/capabilities/image.cap.ts
@@ -64470,7 +64501,7 @@ var ImageStatusSchema = zod.z.object({
 	*  entity exposes no `entity_picture` (yet). */
 	url: zod.z.string().nullable(),
 	/** Ms epoch of the upstream last-updated timestamp. Null at cold-start. */
-	lastUpdated: zod.z.number().nullable()
+	lastUpdated: zod.z.number().nullable().meta(require_sleep.readingMeta("none"))
 });
 var imageCapability = {
 	name: "image",
@@ -64560,19 +64591,19 @@ var NormalizedRangeSchema = zod.z.object({
 */
 var ImageSettingsStatusSchema = zod.z.object({
 	/** Normalized 0–100. */
-	brightness: zod.z.number().optional(),
+	brightness: zod.z.number().optional().meta(require_sleep.readingMeta("none")),
 	/** Normalized 0–100. */
-	contrast: zod.z.number().optional(),
+	contrast: zod.z.number().optional().meta(require_sleep.readingMeta("none")),
 	/** Normalized 0–100. */
-	saturation: zod.z.number().optional(),
+	saturation: zod.z.number().optional().meta(require_sleep.readingMeta("none")),
 	/** Normalized 0–100. */
-	sharpness: zod.z.number().optional(),
+	sharpness: zod.z.number().optional().meta(require_sleep.readingMeta("none")),
 	mirror: zod.z.boolean().optional(),
 	flip: zod.z.boolean().optional(),
 	rotate: ImageRotateSchema.optional(),
 	whiteBalance: WhiteBalanceModeSchema.optional(),
 	/** Manual white-balance warmth, NORMALIZED 0–100. Meaningful only when `whiteBalance === 'manual'`. */
-	warmth: zod.z.number().optional(),
+	warmth: zod.z.number().optional().meta(require_sleep.readingMeta("none")),
 	exposureMode: ExposureModeSchema.optional(),
 	backlightMode: BacklightModeSchema.optional(),
 	lastFetchedAt: zod.z.number()
@@ -64873,10 +64904,10 @@ var IntercomAbilitySchema = zod.z.object({
 	/** Codecs accepted by firmware, in preference order. Driver-authored strings. */
 	codecs: zod.z.array(zod.z.string()),
 	/** Sample rate (Hz) the firmware expects. Reolink typical: 16000. */
-	sampleRate: zod.z.number(),
+	sampleRate: zod.z.number().meta(require_sleep.readingMeta("none")),
 	duplex: zod.z.enum(["half", "full"]),
 	/** Max in-flight audio backlog before drop (ms). Server uses this to bound latency. */
-	maxBacklogMs: zod.z.number()
+	maxBacklogMs: zod.z.number().meta(require_sleep.readingMeta("duration-ms"))
 });
 var IntercomStatusSchema = zod.z.object({
 	/** True while a talk session is open. */
@@ -65105,13 +65136,13 @@ var LawnMowerControlStatusSchema = zod.z.object({
 	activity: LawnMowerActivitySchema,
 	/** 0..100 battery percentage. Null when the device has no battery
 	*  reading. */
-	batteryLevel: zod.z.number().min(0).max(100).nullable(),
+	batteryLevel: zod.z.number().min(0).max(100).nullable().meta(require_sleep.readingMeta("percentage")),
 	/** 0..100 mowing-completion percentage of the current task, or null when no
 	*  task is active / progress is unavailable. */
-	progressPercent: zod.z.number().min(0).max(100).nullable(),
+	progressPercent: zod.z.number().min(0).max(100).nullable().meta(require_sleep.readingMeta("percentage")),
 	/** Current device/event code (dynamic — mostly status, sometimes an error),
 	*  or null when unknown. */
-	currentCode: zod.z.number().nullable(),
+	currentCode: zod.z.number().nullable().meta(require_sleep.readingMeta("none")),
 	/** Human label for {@link currentCode}, or null when undecodable. */
 	currentCodeLabel: zod.z.string().nullable(),
 	/** Severity of {@link currentCode}. `error` (and often `warning`) warrants UI
@@ -65841,7 +65872,7 @@ var MediaPlayerStatusSchema = zod.z.object({
 	state: MediaPlayerStateSchema,
 	/** Volume as 0..100 inclusive. Null when the device has no volume
 	*  surface. Pair with `DeviceFeature.MediaPlayerVolume`. */
-	volumeLevel: zod.z.number().min(0).max(100).nullable(),
+	volumeLevel: zod.z.number().min(0).max(100).nullable().meta(require_sleep.readingMeta("percentage")),
 	/** Mute toggle distinct from volume=0. Null when no mute surface.
 	*  Pair with `DeviceFeature.MediaPlayerMute`. */
 	isMuted: zod.z.boolean().nullable(),
@@ -65854,10 +65885,10 @@ var MediaPlayerStatusSchema = zod.z.object({
 	currentMedia: MediaInfoSchema.nullable(),
 	/** Current playback position in ms. Null when not seekable or
 	*  nothing is playing. Pair with `DeviceFeature.MediaPlayerSeek`. */
-	positionMs: zod.z.number().int().nonnegative().nullable(),
+	positionMs: zod.z.number().int().nonnegative().nullable().meta(require_sleep.readingMeta("duration-ms")),
 	/** Total duration of the current media in ms. Null when unknown
 	*  (live stream) or nothing is playing. */
-	durationMs: zod.z.number().int().nonnegative().nullable(),
+	durationMs: zod.z.number().int().nonnegative().nullable().meta(require_sleep.readingMeta("duration-ms")),
 	/** Shuffle toggle. Null when no shuffle surface.
 	*  Pair with `DeviceFeature.MediaPlayerShuffle`. */
 	shuffle: zod.z.boolean().nullable(),
@@ -66237,7 +66268,7 @@ var motionCustomize = {
 			eventName: "onMotionChanged"
 		},
 		deviceTypes: [require_err_msg.DeviceType.Camera],
-		apply: "replace",
+		apply: "add",
 		applyAuthority: {
 			kind: "camera-sensors",
 			timeoutField: "motionCooldownMs"
@@ -66334,7 +66365,7 @@ var MotionStatusSchema = zod.z.object({
 	* it, every provider seeded it at boot, and every session left it
 	* `detected: true` after its detach.
 	*/
-	autoClearAfterMs: zod.z.number().nullable()
+	autoClearAfterMs: zod.z.number().nullable().meta(require_sleep.readingMeta("duration-ms"))
 });
 /**
 * Payload of `motion.onMotionChanged` event + the corresponding bus
@@ -66520,7 +66551,7 @@ var MotionZoneRegionSchema = zod.z.object({
 *  the grid region(s). */
 var MotionZoneStatusSchema = zod.z.object({
 	enabled: zod.z.boolean(),
-	sensitivity: zod.z.number(),
+	sensitivity: zod.z.number().meta(require_sleep.readingMeta("none")),
 	/** Grid region(s). Today exactly one `grid` shape. */
 	regions: zod.z.array(MotionZoneRegionSchema),
 	lastFetchedAt: zod.z.number()
@@ -67036,7 +67067,7 @@ var NavigationStatusSchema = zod.z.object({
 	following: zod.z.boolean(),
 	flash: zod.z.boolean(),
 	lightMode: NavigationLightModeSchema,
-	lightLevel: zod.z.number().min(40).max(100),
+	lightLevel: zod.z.number().min(40).max(100).meta(require_sleep.readingMeta("none")),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: zod.z.number()
 });
@@ -67187,13 +67218,13 @@ var NetworkLinkStatusSchema = zod.z.object({
 	* one whose reading has not landed must not be drawn at 0 %. Consumers
 	* SKIP a null rather than coerce it.
 	*/
-	signalPercent: zod.z.number().min(0).max(100).nullable(),
+	signalPercent: zod.z.number().min(0).max(100).nullable().meta(require_sleep.readingMeta("percentage")),
 	/** Raw received signal strength in dBm, when the firmware reports one. */
-	rssiDbm: zod.z.number().optional(),
+	rssiDbm: zod.z.number().optional().meta(require_sleep.readingMeta("signal-level")),
 	/** Network name of a wireless link, when the firmware reports it. */
 	ssid: zod.z.string().optional(),
 	/** Ms epoch of the last observation. Lets consumers reason about freshness. */
-	lastUpdated: zod.z.number()
+	lastUpdated: zod.z.number().meta(require_sleep.readingMeta("none"))
 });
 /** The slice a provider seeds before its first read: nothing is known yet. */
 var NETWORK_LINK_UNKNOWN = {
@@ -67669,7 +67700,7 @@ var NotifierStatusSchema = zod.z.object({
 	lastError: zod.z.string().nullable(),
 	/** Number of deliveries currently buffered server-side (rate-limited
 	*  notifiers may queue). 0 when the provider sends synchronously. */
-	queueDepth: zod.z.number().int().nonnegative(),
+	queueDepth: zod.z.number().int().nonnegative().meta(require_sleep.readingMeta("count")),
 	/** Per-feature capability matrix — authoritative source for the
 	*  compose-form field gating. */
 	supports: NotifierSupportsSchema
@@ -67763,11 +67794,9 @@ onSent: { data: zod.z.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`,
@@ -67776,15 +67805,8 @@ onSent: { data: zod.z.object({
 * numeric values land here.
 */
 var NumericSensorStatusSchema = zod.z.object({
-	value: zod.z.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: zod.z.string().optional(),
-	/** Suggested decimal places for numeric display.
-	*  Populated live from the upstream source when provided.
-	*  Falls back to auto-formatting when absent. */
-	precision: zod.z.number().int().min(0).max(10).optional(),
+	/** Reading in the device quantity's base unit. `null` when refused (D393). */
+	value: zod.z.number().nullable().meta(require_sleep.readingMeta("device")),
 	/** Ms epoch when the slice was last updated. */
 	lastFetchedAt: zod.z.number()
 });
@@ -67808,11 +67830,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
@@ -68269,23 +68291,26 @@ var PetFeederStatusSchema = zod.z.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: zod.z.number().nullable(),
+	foodLevel: zod.z.number().nullable().meta(require_sleep.readingMeta("none")),
 	/** Hopper-1 food level (grams) on dual-hopper feeders; null on
 	*  single-hopper models. */
-	food1: zod.z.number().nullable(),
+	food1: zod.z.number().nullable().meta(require_sleep.readingMeta("none")),
 	/** Hopper-2 food level (grams) on dual-hopper feeders; null on
 	*  single-hopper models. */
-	food2: zod.z.number().nullable(),
+	food2: zod.z.number().nullable().meta(require_sleep.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: zod.z.boolean(),
 	/** Battery charge 0..100 (%). Null on mains-powered models or when the
 	*  device has no battery reading. */
-	batteryPower: zod.z.number().min(0).max(100).nullable(),
-	/** Days of desiccant life remaining. Null when the model has no
-	*  desiccant sensor. */
-	desiccantLeftDays: zod.z.number().nullable(),
+	batteryPower: zod.z.number().min(0).max(100).nullable().meta(require_sleep.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: zod.z.number().nullable().meta(require_sleep.readingMeta("duration")),
 	/** True while a feed is in progress. */
 	feeding: zod.z.boolean(),
 	/** Decoded connectivity / power status (HA petkit device-status enum).
@@ -68296,7 +68321,7 @@ var PetFeederStatusSchema = zod.z.object({
 	*  with `errorCode` for consumers that want the raw integer. */
 	error: zod.z.string().nullable(),
 	/** Raw device error code (0 / null = no error). */
-	errorCode: zod.z.number().nullable(),
+	errorCode: zod.z.number().nullable().meta(require_sleep.readingMeta("none")),
 	/** True for D4S/D4SH dual-hopper hardware — gates the per-hopper UI. */
 	isDualHopper: zod.z.boolean(),
 	/** Child-lock (manual-lock) setting — buttons on the unit are disabled. */
@@ -68306,7 +68331,7 @@ var PetFeederStatusSchema = zod.z.object({
 	/** Play a chime when dispensing. */
 	feedSound: zod.z.boolean(),
 	/** Speaker / prompt volume level (device-scaled integer). */
-	volume: zod.z.number(),
+	volume: zod.z.number().meta(require_sleep.readingMeta("none")),
 	/** Ms epoch when the slice was last refreshed from the cloud. */
 	lastFetchedAt: zod.z.number()
 });
@@ -68425,7 +68450,7 @@ var petFeederCapability = {
 		},
 		desiccantLeftDays: {
 			kind: "gauge",
-			unit: "days"
+			unit: "s"
 		}
 	} }
 };
@@ -69631,36 +69656,19 @@ var platformProbeCapability = {
 */
 var PowerMeterStatusSchema = zod.z.object({
 	/** Instantaneous power draw in watts. */
-	watts: zod.z.number().optional().meta({
-		unit: "W",
-		label: "Power"
-	}),
+	watts: zod.z.number().optional().meta(require_sleep.readingMeta("power", { label: "Power" })),
 	/** Cumulative energy in kilowatt-hours since the meter was reset. */
-	kwhTotal: zod.z.number().optional().meta({
-		unit: "kWh",
-		label: "Energy"
-	}),
+	kwhTotal: zod.z.number().optional().meta(require_sleep.readingMeta("energy", { label: "Energy" })),
 	/** Voltage in volts. */
-	volts: zod.z.number().optional(),
+	volts: zod.z.number().optional().meta(require_sleep.readingMeta("voltage")),
 	/** Current in amperes. */
-	amps: zod.z.number().optional(),
-	/** Apparent power in volt-amperes (W × power-factor reciprocal). */
-	va: zod.z.number().optional(),
+	amps: zod.z.number().optional().meta(require_sleep.readingMeta("current")),
+	/** Apparent power in volt-amperes. */
+	va: zod.z.number().optional().meta(require_sleep.readingMeta("apparent-power")),
 	/** Power factor (0..1) if reported. */
-	powerFactor: zod.z.number().min(0).max(1).optional(),
+	powerFactor: zod.z.number().min(0).max(1).optional().meta(require_sleep.readingMeta("ratio")),
 	/** Ms epoch when the slice was last updated. */
-	lastFetchedAt: zod.z.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: zod.z.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: zod.z.number().int().min(0).max(10).optional()
+	lastFetchedAt: zod.z.number()
 });
 var powerMeterCapability = {
 	name: "power-meter",
@@ -69724,12 +69732,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"]
 };
 //#endregion
 //#region src/capabilities/presence.cap.ts
@@ -69751,11 +69754,11 @@ var powerMeterCapability = {
 */
 var GpsLocationSchema = zod.z.object({
 	/** Latitude in decimal degrees, -90..90. */
-	latitude: zod.z.number().min(-90).max(90),
+	latitude: zod.z.number().min(-90).max(90).meta(require_sleep.readingMeta("angle")),
 	/** Longitude in decimal degrees, -180..180. */
-	longitude: zod.z.number().min(-180).max(180),
+	longitude: zod.z.number().min(-180).max(180).meta(require_sleep.readingMeta("angle")),
 	/** Reported accuracy in meters (lower = better). */
-	accuracyMeters: zod.z.number().nonnegative()
+	accuracyMeters: zod.z.number().nonnegative().meta(require_sleep.readingMeta("length"))
 });
 var PresenceStatusSchema = zod.z.object({
 	/** `home` / `not_home` / any user-defined zone name. */
@@ -69767,7 +69770,7 @@ var PresenceStatusSchema = zod.z.object({
 	gps: GpsLocationSchema.nullable(),
 	/** Optional battery level of the tracking device (0..100). Null
 	*  when not reported. */
-	batteryPercent: zod.z.number().min(0).max(100).nullable(),
+	batteryPercent: zod.z.number().min(0).max(100).nullable().meta(require_sleep.readingMeta("percentage")),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: zod.z.number()
 });
@@ -69819,19 +69822,10 @@ var presenceCapability = {
 * `sourceInfo`.
 */
 var PressureSensorStatusSchema = zod.z.object({
-	/** Current pressure in hPa. */
-	hpa: zod.z.number(),
+	/** Current pressure in hPa. `null` when the sample was refused (D393). */
+	hpa: zod.z.number().nullable().meta(require_sleep.readingMeta("pressure", { precision: 0 })),
 	/** Ms epoch when the slice was last updated. */
-	lastFetchedAt: zod.z.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: zod.z.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: zod.z.number().int().min(0).max(10).optional()
+	lastFetchedAt: zod.z.number()
 });
 var pressureSensorCapability = {
 	name: "pressure-sensor",
@@ -70398,8 +70392,8 @@ var ptzCapability = {
 var AutotrackTargetTypeSchema = zod.z.string().describe("Vendor target string (people/vehicle/pet); empty = camera default");
 var PtzAutotrackSettingsSchema = zod.z.object({
 	targetType: AutotrackTargetTypeSchema,
-	stopDelaySeconds: zod.z.number().int().min(0).max(300),
-	disappearDelaySeconds: zod.z.number().int().min(0).max(300)
+	stopDelaySeconds: zod.z.number().int().min(0).max(300).meta(require_sleep.readingMeta("duration")),
+	disappearDelaySeconds: zod.z.number().int().min(0).max(300).meta(require_sleep.readingMeta("duration"))
 });
 /**
 * One option the camera advertises as a valid `targetType`. Drivers
@@ -70566,7 +70560,7 @@ var RunningStateStatusSchema = zod.z.object({
 	/** null = unknown — never coerced to false (D393). */
 	running: zod.z.boolean().nullable(),
 	/** Epoch ms the current boolean began; null while `running` is null. */
-	since: zod.z.number().nullable(),
+	since: zod.z.number().nullable().meta(require_sleep.readingMeta("none")),
 	source: RunningStateSourceSchema.meta({ label: "Source" }),
 	phase: zod.z.string().nullable(),
 	/** null until a reading has been published (D393). */
@@ -70581,7 +70575,6 @@ var RUNNING_DEVICE_TYPES = Object.values(require_err_msg.DeviceType);
 /** Generic Customize target for the running boolean (D936). */
 var runningCustomize = {
 	version: 1,
-	advanced: "derive",
 	targets: [{
 		id: "running",
 		cardinality: "scalar",
@@ -70601,7 +70594,7 @@ var runningCustomize = {
 			require_err_msg.DeviceType.Thermostat,
 			require_err_msg.DeviceType.PetFeeder
 		],
-		apply: "add-or-replace",
+		apply: "add",
 		path: "running",
 		sources: [
 			{
@@ -72449,9 +72442,9 @@ var RecordTriggerSchema = zod.z.enum([
 */
 var RecordWindowSchema = zod.z.object({
 	trigger: RecordTriggerSchema,
-	day: zod.z.number().int().min(0).max(6),
-	startMinute: zod.z.number().int().min(0).max(1439),
-	endMinute: zod.z.number().int().min(1).max(1440)
+	day: zod.z.number().int().min(0).max(6).meta(require_sleep.readingMeta("none")),
+	startMinute: zod.z.number().int().min(0).max(1439).meta(require_sleep.readingMeta("none")),
+	endMinute: zod.z.number().int().min(1).max(1440).meta(require_sleep.readingMeta("none"))
 });
 /** Status of one physical volume, as the camera itself describes it. */
 var OnboardStorageVolumeSchema = zod.z.object({
@@ -72550,10 +72543,10 @@ var RecordingOnboardStatusSchema = zod.z.object({
 	/** Master "record to the card at all" switch. */
 	enabled: zod.z.boolean().nullable(),
 	overwriteWhenFull: zod.z.boolean().nullable(),
-	preRecordSec: zod.z.number().nullable(),
-	postRecordSec: zod.z.number().nullable(),
+	preRecordSec: zod.z.number().nullable().meta(require_sleep.readingMeta("duration")),
+	postRecordSec: zod.z.number().nullable().meta(require_sleep.readingMeta("duration")),
 	/** Length of one recorded file, in minutes. */
-	segmentMinutes: zod.z.number().nullable(),
+	segmentMinutes: zod.z.number().nullable().meta(require_sleep.readingMeta("none")),
 	/** The primary track's weekly windows, flattened. */
 	windows: zod.z.array(RecordWindowSchema),
 	/**
@@ -72569,7 +72562,7 @@ var RecordingOnboardStatusSchema = zod.z.object({
 	* provider reporting a non-zero count also reports the schedule as not
 	* writable.
 	*/
-	unreadableWindows: zod.z.number(),
+	unreadableWindows: zod.z.number().meta(require_sleep.readingMeta("count")),
 	/**
 	* The camera is scheduled to record and has NO usable storage.
 	*
@@ -73741,7 +73734,7 @@ var CamStreamDescriptorSchema = zod.z.object({
 	url: zod.z.string().optional(),
 	codec: zod.z.string().optional(),
 	resolution: require_sleep.CamStreamResolutionSchema.optional(),
-	fps: zod.z.number().positive().optional(),
+	fps: zod.z.number().positive().optional().meta(require_sleep.readingMeta("rate")),
 	label: zod.z.string().optional(),
 	/** Device-level features (e.g. `battery-operated`) — drives broker policy. */
 	deviceFeatures: zod.z.array(zod.z.string()).optional(),
@@ -73830,18 +73823,18 @@ var StreamProfileSchema = zod.z.enum([
 ]);
 /** The current encoding config of one stream profile. */
 var StreamProfileConfigSchema = zod.z.object({
-	width: zod.z.number(),
-	height: zod.z.number(),
+	width: zod.z.number().meta(require_sleep.readingMeta("none")),
+	height: zod.z.number().meta(require_sleep.readingMeta("none")),
 	codec: zod.z.enum(["h264", "h265"]),
-	framerate: zod.z.number(),
-	bitrate: zod.z.number(),
+	framerate: zod.z.number().meta(require_sleep.readingMeta("rate")),
+	bitrate: zod.z.number().meta(require_sleep.readingMeta("bitrate")),
 	bitrateMode: zod.z.enum(["vbr", "cbr"]).optional(),
 	encoderProfile: zod.z.enum([
 		"high",
 		"main",
 		"baseline"
 	]).optional(),
-	gop: zod.z.number().optional(),
+	gop: zod.z.number().optional().meta(require_sleep.readingMeta("none")),
 	/**
 	* Whether THIS profile currently carries an audio track. READ-ONLY here.
 	*
@@ -74323,12 +74316,7 @@ var switchCapability = {
 			label: "On",
 			kind: "boolean"
 		}
-	}] },
-	customize: {
-		version: 1,
-		advanced: "derive",
-		targets: []
-	}
+	}] }
 };
 //#endregion
 //#region src/system/server-name.ts
@@ -75076,35 +75064,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 = zod.z.object({
-	/** Current temperature in Celsius. */
-	celsius: zod.z.number().meta({
-		unit: "°C",
+	/** Current temperature in Celsius. `null` when the sample was refused (D393). */
+	celsius: zod.z.number().nullable().meta(require_sleep.readingMeta("temperature", {
+		precision: 1,
 		label: "Temperature"
-	}),
+	})),
 	/** Ms epoch when the slice was last updated (push or poll). */
-	lastFetchedAt: zod.z.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: zod.z.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: zod.z.number().int().min(0).max(10).optional()
+	lastFetchedAt: zod.z.number()
 });
 var temperatureSensorCapability = {
 	name: "temperature-sensor",
@@ -75135,12 +75109,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"]
 };
 //#endregion
 //#region src/capabilities/toast.cap.ts
@@ -75494,16 +75463,16 @@ var VacuumControlStatusSchema = zod.z.object({
 	state: VacuumStateSchema,
 	/** 0..100 battery percentage. Null when the device has no battery
 	*  reading. */
-	batteryLevel: zod.z.number().min(0).max(100).nullable(),
+	batteryLevel: zod.z.number().min(0).max(100).nullable().meta(require_sleep.readingMeta("percentage")),
 	/** Current fan-speed token (provider-verbatim). Null when unknown or
 	*  the vacuum has no speed control. */
 	fanSpeed: zod.z.string().nullable(),
 	/** Speed tokens the hardware accepts — drives the UI selector. */
 	availableFanSpeeds: zod.z.array(zod.z.string()),
 	/** 0..100 cleaning-completion percentage of the current task, or null. */
-	progressPercent: zod.z.number().min(0).max(100).nullable(),
+	progressPercent: zod.z.number().min(0).max(100).nullable().meta(require_sleep.readingMeta("percentage")),
 	/** Current error code (0 / null = no error). */
-	errorCode: zod.z.number().nullable(),
+	errorCode: zod.z.number().nullable().meta(require_sleep.readingMeta("none")),
 	/** Human label for {@link errorCode}, or null when none / undecodable. */
 	errorLabel: zod.z.string().nullable(),
 	/** Ms epoch when the slice was last updated. */
@@ -75601,7 +75570,7 @@ var ValveStatusSchema = zod.z.object({
 	state: ValveStateSchema,
 	/** 0 = fully closed, 100 = fully open. Null when the device has no
 	*  intermediate position surface. */
-	position: zod.z.number().min(0).max(100).nullable(),
+	position: zod.z.number().min(0).max(100).nullable().meta(require_sleep.readingMeta("percentage")),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: zod.z.number()
 });
@@ -75713,9 +75682,9 @@ var vibrationCapability = {
 */
 var WaterHeaterStatusSchema = zod.z.object({
 	/** Current measured temperature. Null when not reported. */
-	currentTemp: zod.z.number().nullable(),
+	currentTemp: zod.z.number().nullable().meta(require_sleep.readingMeta("temperature")),
 	/** Target temperature setpoint. Null when no setpoint surface. */
-	targetTemp: zod.z.number().nullable(),
+	targetTemp: zod.z.number().nullable().meta(require_sleep.readingMeta("temperature")),
 	/** Active operation mode = HA `state` (`eco` / `electric` / `gas` /
 	*  `heat_pump` / `high_demand` / `performance` / `off`). Null when the
 	*  device reports an unknown state. */
@@ -75726,9 +75695,9 @@ var WaterHeaterStatusSchema = zod.z.object({
 	*  has no away surface. */
 	away: zod.z.boolean().nullable(),
 	/** HA `min_temp` attribute. Null when not reported. */
-	minTemp: zod.z.number().nullable(),
+	minTemp: zod.z.number().nullable().meta(require_sleep.readingMeta("temperature")),
 	/** HA `max_temp` attribute. Null when not reported. */
-	maxTemp: zod.z.number().nullable(),
+	maxTemp: zod.z.number().nullable().meta(require_sleep.readingMeta("temperature")),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: zod.z.number()
 });
@@ -75815,25 +75784,18 @@ var waterHeaterCapability = {
 * Forecast deferred — current conditions only for v1.
 */
 var WeatherStatusSchema = zod.z.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: zod.z.string().nullable(),
-	/** Current temperature in the reported unit. Null when not provided. */
-	temperature: zod.z.number().nullable(),
-	/** Temperature unit string (e.g. `°C` / `°F`). Null when not provided. */
-	temperatureUnit: zod.z.string().nullable(),
+	/** Current temperature in Celsius. Null when not provided or refused. */
+	temperature: zod.z.number().nullable().meta(require_sleep.readingMeta("temperature", { precision: 1 })),
 	/** Relative humidity (0..100). Null when not provided. */
-	humidity: zod.z.number().min(0).max(100).nullable(),
-	/** Barometric pressure in the reported unit. Null when not provided. */
-	pressure: zod.z.number().nullable(),
-	/** Pressure unit string (e.g. `hPa` / `inHg`). Null when not provided. */
-	pressureUnit: zod.z.string().nullable(),
-	/** Wind speed in the reported unit. Null when not provided. */
-	windSpeed: zod.z.number().nullable(),
-	/** Wind-speed unit string (e.g. `km/h` / `mph`). Null when not provided. */
-	windSpeedUnit: zod.z.string().nullable(),
+	humidity: zod.z.number().min(0).max(100).nullable().meta(require_sleep.readingMeta("humidity")),
+	/** Barometric pressure in hPa. Null when not provided or refused. */
+	pressure: zod.z.number().nullable().meta(require_sleep.readingMeta("pressure")),
+	/** Wind speed in metres per second. Null when not provided or refused. */
+	windSpeed: zod.z.number().nullable().meta(require_sleep.readingMeta("speed")),
 	/** Wind bearing in degrees (0..360, meteorological). Null when not provided. */
-	windBearing: zod.z.number().nullable(),
+	windBearing: zod.z.number().nullable().meta(require_sleep.readingMeta("angle")),
 	/** Ms epoch when the slice was last updated. */
 	lastFetchedAt: zod.z.number()
 });
@@ -75861,12 +75823,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: {
@@ -75876,12 +75838,12 @@ var weatherCapability = {
 		},
 		pressure: {
 			kind: "gauge",
-			unitFrom: "pressureUnit",
+			unit: "hPa",
 			deadband: .5
 		},
 		windSpeed: {
 			kind: "gauge",
-			unitFrom: "windSpeedUnit",
+			unit: "m/s",
 			deadband: .5
 		}
 	} }
@@ -77320,6 +77282,11 @@ var UNIT_TABLE = {
 		factor: 1609.344,
 		offset: 0
 	},
+	"m²": {
+		dimension: "area",
+		factor: 1,
+		offset: 0
+	},
 	lx: {
 		dimension: "illuminance",
 		factor: 1,
@@ -77424,6 +77391,121 @@ var UNIT_TABLE = {
 		dimension: "percentage",
 		factor: 1,
 		offset: 0
+	},
+	L: {
+		dimension: "volume",
+		factor: 1,
+		offset: 0
+	},
+	mL: {
+		dimension: "volume",
+		factor: .001,
+		offset: 0
+	},
+	gal: {
+		dimension: "volume",
+		factor: 3.785411784,
+		offset: 0
+	},
+	s: {
+		dimension: "duration",
+		factor: 1,
+		offset: 0
+	},
+	ms: {
+		dimension: "duration",
+		factor: .001,
+		offset: 0
+	},
+	min: {
+		dimension: "duration",
+		factor: 60,
+		offset: 0
+	},
+	h: {
+		dimension: "duration",
+		factor: 3600,
+		offset: 0
+	},
+	d: {
+		dimension: "duration",
+		factor: 86400,
+		offset: 0
+	},
+	B: {
+		dimension: "information",
+		factor: 1,
+		offset: 0
+	},
+	KiB: {
+		dimension: "information",
+		factor: 1024,
+		offset: 0
+	},
+	MiB: {
+		dimension: "information",
+		factor: 1024 ** 2,
+		offset: 0
+	},
+	GiB: {
+		dimension: "information",
+		factor: 1024 ** 3,
+		offset: 0
+	},
+	TiB: {
+		dimension: "information",
+		factor: 1024 ** 4,
+		offset: 0
+	},
+	kB: {
+		dimension: "information",
+		factor: 1e3,
+		offset: 0
+	},
+	MB: {
+		dimension: "information",
+		factor: 1e6,
+		offset: 0
+	},
+	GB: {
+		dimension: "information",
+		factor: 1e9,
+		offset: 0
+	},
+	"°": {
+		dimension: "angle",
+		factor: 1,
+		offset: 0
+	},
+	dBFS: {
+		dimension: "sound-level",
+		factor: 1,
+		offset: 0
+	},
+	dBm: {
+		dimension: "signal-level",
+		factor: 1,
+		offset: 0
+	},
+	mired: {
+		dimension: "colour-temperature",
+		factor: 1,
+		offset: 0
+	},
+	kbps: {
+		dimension: "bitrate",
+		factor: 1,
+		offset: 0
+	},
+	Mbps: {
+		dimension: "bitrate",
+		factor: 1e3,
+		offset: 0
+	},
+	fps: {
+		dimension: "rate",
+		factor: 1,
+		offset: 0
 	}
 };
 //#endregion
@@ -77514,6 +77596,17 @@ function canConvertUnit(from, to) {
 * Every known unit spelling in a dimension (table insertion order — canonical
 * unit first). Powers the UI's same-dimension unit picker.
 */
+/**
+* Convert a difference, not a reading. Affine units (°F) shift an absolute
+* value by their offset; a step of 1°F is 5/9°C, so the offset is cancelled.
+*/
+function tryConvertDelta(value, from, to) {
+	if (from === to) return value;
+	const origin = tryConvertUnit(0, from, to);
+	const shifted = tryConvertUnit(value, from, to);
+	if (origin === void 0 || shifted === void 0) return void 0;
+	return shifted - origin;
+}
 function unitsForDimension(dimension) {
 	const out = [];
 	for (const [unit, spec] of Object.entries(UNIT_TABLE)) if (spec.dimension === dimension) out.push(unit);
@@ -77817,9 +77910,9 @@ function feederCustomizationExample(sources) {
 						expr: "number(d)",
 						bindings: days
 					},
-					"remaining.unit": {
+					"remaining.kind": {
 						kind: "expression",
-						expr: "\"days\"",
+						expr: "\"duration\"",
 						bindings: {}
 					},
 					status: {
@@ -78085,19 +78178,9 @@ function convertUnitTargets(from) {
 //#region src/generated/customize-catalog.ts
 /**
 * Customize catalog, projected from every `*.cap.ts` `customize` block.
-* 11 caps. Field keys are `runtimeState` paths. No Zod.
+* 5 caps. Field keys are `runtimeState` paths. No Zod.
 */
 var CAP_CUSTOMIZE_CATALOG = {
-	"ambient-light-sensor": {
-		version: 1,
-		targets: [],
-		advancedParameters: [{
-			path: "lux",
-			kind: "number",
-			label: "Illuminance",
-			unit: "lx"
-		}]
-	},
 	"battery": {
 		version: 1,
 		targets: [{
@@ -78112,7 +78195,7 @@ var CAP_CUSTOMIZE_CATALOG = {
 				require_err_msg.DeviceType.Container,
 				require_err_msg.DeviceType.Thermostat
 			],
-			apply: "add-or-replace",
+			apply: "add",
 			vocabularyCap: "battery",
 			vocabularyStateField: "percentage",
 			sources: [{
@@ -78151,38 +78234,6 @@ var CAP_CUSTOMIZE_CATALOG = {
 					when: "add"
 				}
 			]
-		}],
-		advancedParameters: [
-			{
-				path: "binary",
-				kind: "boolean",
-				label: "Binary indicator"
-			},
-			{
-				path: "charging",
-				kind: "enum",
-				label: "Charging source",
-				enumValues: [
-					"dc",
-					"solar",
-					"none",
-					"unknown"
-				]
-			},
-			{
-				path: "sleeping",
-				kind: "boolean",
-				label: "Sleeping"
-			}
-		]
-	},
-	"binary": {
-		version: 1,
-		targets: [],
-		advancedParameters: [{
-			path: "on",
-			kind: "boolean",
-			label: "On"
 		}]
 	},
 	"consumables": {
@@ -78260,12 +78311,8 @@ var CAP_CUSTOMIZE_CATALOG = {
 						transforms: [{ kind: "identity" }]
 					}],
 					literals: [{
-						path: "remaining.unit",
-						values: [
-							"days",
-							"hours",
-							"cycles"
-						]
+						path: "remaining.kind",
+						values: ["duration", "count"]
 					}]
 				},
 				{
@@ -78323,8 +78370,7 @@ var CAP_CUSTOMIZE_CATALOG = {
 				path: "lastFetchedAt",
 				when: "add"
 			}]
-		}],
-		advancedParameters: []
+		}]
 	},
 	"doorbell": {
 		version: 1,
@@ -78356,17 +78402,6 @@ var CAP_CUSTOMIZE_CATALOG = {
 			counterPath: "pressCountSinceStart",
 			highWater: "composer-advance",
 			debounceMs: 2e3
-		}],
-		advancedParameters: []
-	},
-	"humidity-sensor": {
-		version: 1,
-		targets: [],
-		advancedParameters: [{
-			path: "percent",
-			kind: "number",
-			label: "Humidity",
-			unit: "%"
 		}]
 	},
 	"motion": {
@@ -78375,7 +78410,7 @@ var CAP_CUSTOMIZE_CATALOG = {
 			id: "detected",
 			cardinality: "event",
 			deviceTypes: [require_err_msg.DeviceType.Camera],
-			apply: "replace",
+			apply: "add",
 			vocabularyCap: "motion",
 			vocabularyEvent: "onMotionChanged",
 			sources: [{
@@ -78404,22 +78439,6 @@ var CAP_CUSTOMIZE_CATALOG = {
 				"confirm",
 				"replace"
 			]
-		}],
-		advancedParameters: []
-	},
-	"power-meter": {
-		version: 1,
-		targets: [],
-		advancedParameters: [{
-			path: "kwhTotal",
-			kind: "number",
-			label: "Energy",
-			unit: "kWh"
-		}, {
-			path: "watts",
-			kind: "number",
-			label: "Power",
-			unit: "W"
 		}]
 	},
 	"running-state": {
@@ -78439,7 +78458,7 @@ var CAP_CUSTOMIZE_CATALOG = {
 				require_err_msg.DeviceType.Thermostat,
 				require_err_msg.DeviceType.PetFeeder
 			],
-			apply: "add-or-replace",
+			apply: "add",
 			vocabularyCap: "running-state",
 			vocabularyStateField: "running",
 			sources: [
@@ -78502,29 +78521,26 @@ var CAP_CUSTOMIZE_CATALOG = {
 					sourceChangedAt: "prefer"
 				}
 			]
-		}],
-		advancedParameters: []
-	},
-	"switch": {
-		version: 1,
-		targets: [],
-		advancedParameters: [{
-			path: "on",
-			kind: "boolean",
-			label: "On"
-		}]
-	},
-	"temperature-sensor": {
-		version: 1,
-		targets: [],
-		advancedParameters: [{
-			path: "celsius",
-			kind: "number",
-			label: "Temperature",
-			unit: "°C"
 		}]
 	}
 };
+/**
+* Unit meta on runtime-state fields. The composed-device row reads this;
+* it is not an override list (D944).
+*/
+var CAP_RUNTIME_FIELD_UNITS = {
+	"ambient-light-sensor": { lux: "lx" },
+	"battery": {
+		percentage: "%",
+		volts: "V"
+	},
+	"humidity-sensor": { percent: "%" },
+	"power-meter": {
+		watts: "W",
+		kwhTotal: "kWh"
+	},
+	"temperature-sensor": { celsius: "°C" }
+};
 //#endregion
 //#region src/composition/customize/field-source.ts
 function fromRead(source, cap, fieldPath) {
@@ -96145,7 +96161,6 @@ var SENSOR_CAP_VOCABULARY = {
 			field: "value",
 			quantity: t("the reading", "il valore"),
 			label: t("Reading", "Valore"),
-			unitField: "unit",
 			icon: "gauge"
 		}]
 	},
@@ -96281,7 +96296,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"
 			},
 			{
@@ -96297,7 +96312,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"
 			},
 			{
@@ -96305,7 +96320,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"
 			}
 		]
@@ -102838,7 +102853,7 @@ var BucketAccumulator = class {
 //#region src/generated/history-catalog.ts
 /**
 * Cap history catalog, projected from every `*.cap.ts` `history` block.
-* 41 caps with series (74 series), 30 caps answered `'none'`.
+* 41 caps with series (75 series), 30 caps answered `'none'`.
 * Field keys are `runtimeState` paths (`a.b` into fixed objects only).
 */
 var HISTORY_CATALOG = {
@@ -102855,12 +102870,12 @@ var HISTORY_CATALOG = {
 		},
 		"pm25": {
 			kind: "gauge",
-			unit: "ug/m3",
+			unit: "µg/m³",
 			deadband: 1
 		},
 		"pm10": {
 			kind: "gauge",
-			unit: "ug/m3",
+			unit: "µg/m³",
 			deadband: 1
 		},
 		"aqi": {
@@ -102890,10 +102905,16 @@ var HISTORY_CATALOG = {
 		deadbandPct: 10,
 		minIntervalMs: 6e4
 	} },
-	"battery": { "percentage": {
-		kind: "gauge",
-		unit: "%"
-	} },
+	"battery": {
+		"percentage": {
+			kind: "gauge",
+			unit: "%"
+		},
+		"volts": {
+			kind: "gauge",
+			unit: "V"
+		}
+	},
 	"binary": { "on": { kind: "boolean" } },
 	"brightness": { "percentage": {
 		kind: "gauge",
@@ -102977,7 +102998,7 @@ var HISTORY_CATALOG = {
 	},
 	"enum-sensor": { "value": {
 		kind: "enum",
-		skipWhenSet: "format"
+		skipWhenSet: "timestamp"
 	} },
 	"fan-control": {
 		"percentage": {
@@ -103050,7 +103071,6 @@ var HISTORY_CATALOG = {
 	},
 	"numeric-sensor": { "value": {
 		kind: "gauge",
-		unitFrom: "unit",
 		minIntervalMs: 3e4
 	} },
 	"pet-feeder": {
@@ -103064,7 +103084,7 @@ var HISTORY_CATALOG = {
 		},
 		"desiccantLeftDays": {
 			kind: "gauge",
-			unit: "days"
+			unit: "s"
 		}
 	},
 	"power-meter": {
@@ -103168,7 +103188,7 @@ var HISTORY_CATALOG = {
 	"weather": {
 		"temperature": {
 			kind: "gauge",
-			unitFrom: "temperatureUnit",
+			unit: "°C",
 			deadband: .2
 		},
 		"humidity": {
@@ -103178,12 +103198,12 @@ var HISTORY_CATALOG = {
 		},
 		"pressure": {
 			kind: "gauge",
-			unitFrom: "pressureUnit",
+			unit: "hPa",
 			deadband: .5
 		},
 		"windSpeed": {
 			kind: "gauge",
-			unitFrom: "windSpeedUnit",
+			unit: "m/s",
 			deadband: .5
 		}
 	}
@@ -103217,7 +103237,6 @@ var HISTORY_ITEM_CATALOG = { "consumables": {
 		},
 		"remaining.value": {
 			kind: "gauge",
-			unitFrom: "remaining.unit",
 			deadband: 1,
 			displayName: "Remaining"
 		}
@@ -103261,6 +103280,14 @@ function historyFieldsFor(capName) {
 	return HISTORY_CATALOG[capName] ?? {};
 }
 //#endregion
+//#region src/capabilities/runtime-field-unit.ts
+/**
+* The unit a composed-device field row offers convert-unit from (D941, D944).
+*/
+function runtimeFieldUnit(cap, path) {
+	return CAP_RUNTIME_FIELD_UNITS[cap]?.[path];
+}
+//#endregion
 //#region src/composition/customize/override-draft.ts
 /**
 * A saved Customize assignment (D936). The schema is the type: callers use
@@ -112817,6 +112844,227 @@ var DEVICE_TYPE_INFO = { ["camera"]: {
 	icon: "camera"
 } };
 //#endregion
+//#region src/units/threshold.ts
+/**
+* Move a threshold between the unit the operator sees and the stored base.
+* A failed conversion leaves the number unchanged — the recipe stays serialisable.
+*/
+function thresholdToBase(value, displayUnit, baseUnit) {
+	if (!Number.isFinite(value) || displayUnit === baseUnit) return value;
+	return tryConvertUnit(value, displayUnit, baseUnit) ?? value;
+}
+function thresholdToDisplay(value, baseUnit, displayUnit) {
+	if (!Number.isFinite(value) || baseUnit === displayUnit) return value;
+	return tryConvertUnit(value, baseUnit, displayUnit) ?? value;
+}
+//#endregion
+//#region src/units/format-reading.ts
+/**
+* Render a stored base-unit reading (D944 §4). The preference defaults to
+* metric. An operator override is applied by the caller via `convertUnit`
+* before this, or by passing the already-chosen display unit through
+* `resolveSensorDisplay` — this function is the quantity → string step.
+*/
+var DURATION_STEPS = [
+	{
+		value: 86400,
+		unit: "d"
+	},
+	{
+		value: 3600,
+		unit: "h"
+	},
+	{
+		value: 60,
+		unit: "min"
+	}
+];
+var INFO_STEPS = [
+	{
+		factor: 1024 ** 4,
+		unit: "TiB"
+	},
+	{
+		factor: 1024 ** 3,
+		unit: "GiB"
+	},
+	{
+		factor: 1024 ** 2,
+		unit: "MiB"
+	},
+	{
+		factor: 1024,
+		unit: "KiB"
+	}
+];
+function formatMagnitude(value, precision) {
+	if (!Number.isFinite(value)) return "";
+	if (precision !== void 0) return value.toFixed(precision);
+	return Number.isInteger(value) ? String(value) : value.toFixed(1);
+}
+function scaleDuration(seconds) {
+	const abs = Math.abs(seconds);
+	for (const step of DURATION_STEPS) if (abs >= step.value) return {
+		value: seconds / step.value,
+		unit: step.unit
+	};
+	return {
+		value: seconds,
+		unit: "s"
+	};
+}
+function scaleInformation(bytes) {
+	const abs = Math.abs(bytes);
+	for (const step of INFO_STEPS) if (abs >= step.factor) return {
+		value: bytes / step.factor,
+		unit: step.unit
+	};
+	return {
+		value: bytes,
+		unit: "B"
+	};
+}
+function resolvedQuantity(input) {
+	if (input.quantity === "device") return input.deviceQuantity ?? "none";
+	return input.quantity;
+}
+function formatReading(input) {
+	const quantity = resolvedQuantity(input);
+	const precision = input.precision;
+	if (!Number.isFinite(input.value)) return {
+		text: "",
+		unit: "",
+		value: input.value
+	};
+	if (quantity === "duration" || quantity === "duration-ms") {
+		const scaled = scaleDuration(quantity === "duration-ms" ? input.value / 1e3 : input.value);
+		return {
+			text: formatMagnitude(scaled.value, precision),
+			unit: scaled.unit,
+			value: scaled.value
+		};
+	}
+	if (quantity === "information") {
+		const scaled = scaleInformation(input.value);
+		return {
+			text: formatMagnitude(scaled.value, precision),
+			unit: scaled.unit,
+			value: scaled.value
+		};
+	}
+	const preference = input.preference ?? "metric";
+	const base = require_sleep.baseUnitOf(quantity);
+	const display = require_sleep.displayUnitFor(quantity, preference);
+	if (base === void 0 || display === void 0) return {
+		text: formatMagnitude(input.value, precision),
+		unit: "",
+		value: input.value
+	};
+	const converted = tryConvertUnit(input.value, base, display);
+	if (converted === void 0) return {
+		text: formatMagnitude(input.value, precision),
+		unit: base,
+		value: input.value
+	};
+	return {
+		text: formatMagnitude(converted, precision),
+		unit: display,
+		value: converted
+	};
+}
+//#endregion
+//#region src/units/ingest-reading.ts
+/**
+* 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 = require_sleep.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
+	};
+}
+//#endregion
 //#region src/util/location-match.ts
 /**
 * Pure fuzzy matcher for adoption location import. Normalized
@@ -114443,6 +114691,7 @@ exports.CAP_CUSTOMIZE_CATALOG = CAP_CUSTOMIZE_CATALOG;
 exports.CAP_NAMES_WITH_STATUS = CAP_NAMES_WITH_STATUS;
 exports.CAP_NODE_PIN_CONTEXT_KEY = require_sleep.CAP_NODE_PIN_CONTEXT_KEY;
 exports.CAP_PROVIDER_KIND_MAP = CAP_PROVIDER_KIND_MAP;
+exports.CAP_RUNTIME_FIELD_UNITS = CAP_RUNTIME_FIELD_UNITS;
 exports.CAP_VOCABULARY = CAP_VOCABULARY;
 exports.CAP_VOCABULARY_BY_NAME = CAP_VOCABULARY_BY_NAME;
 exports.CATALOG_LANGS = CATALOG_LANGS;
@@ -114641,8 +114890,8 @@ exports.ConsumableFormSchema = ConsumableFormSchema;
 exports.ConsumableItemSchema = ConsumableItemSchema;
 exports.ConsumableKindSchema = ConsumableKindSchema;
 exports.ConsumableLevelSchema = ConsumableLevelSchema;
+exports.ConsumableRemainingKindSchema = ConsumableRemainingKindSchema;
 exports.ConsumableRemainingSchema = ConsumableRemainingSchema;
-exports.ConsumableRemainingUnitSchema = ConsumableRemainingUnitSchema;
 exports.ConsumableStatusSchema = ConsumableStatusSchema;
 exports.ConsumablesStatusSchema = ConsumablesStatusSchema;
 exports.ContactStatusSchema = ContactStatusSchema;
@@ -114688,6 +114937,7 @@ exports.DEFAULT_CLUSTER_STEP_SETTINGS = DEFAULT_CLUSTER_STEP_SETTINGS;
 exports.DEFAULT_CORE_BLOCK_ENTRY = DEFAULT_CORE_BLOCK_ENTRY;
 exports.DEFAULT_DECODER_HWACCEL_CONFIG = DEFAULT_DECODER_HWACCEL_CONFIG;
 exports.DEFAULT_DETAIL_CROP_CONVENTION = DEFAULT_DETAIL_CROP_CONVENTION;
+exports.DEFAULT_DISPLAY_PREFERENCE = require_sleep.DEFAULT_DISPLAY_PREFERENCE;
 exports.DEFAULT_EVENTS_BAND_BUFFER_SEC = DEFAULT_EVENTS_BAND_BUFFER_SEC;
 exports.DEFAULT_EVENT_COLOR = DEFAULT_EVENT_COLOR;
 exports.DEFAULT_FEATURES = DEFAULT_FEATURES;
@@ -114746,6 +114996,7 @@ exports.DEVICE_TOMBSTONE_RETENTION_MS = DEVICE_TOMBSTONE_RETENTION_MS;
 exports.DEVICE_TYPE_CONTROL_KIND = DEVICE_TYPE_CONTROL_KIND;
 exports.DEVICE_TYPE_DO_CAPS = DEVICE_TYPE_DO_CAPS;
 exports.DEVICE_TYPE_INFO = DEVICE_TYPE_INFO;
+exports.DISPLAY_PREFERENCES = require_sleep.DISPLAY_PREFERENCES;
 exports.DISPLAY_PRESETS = DISPLAY_PRESETS;
 exports.DOORBELL_RISE_DEBOUNCE_MS = DOORBELL_RISE_DEBOUNCE_MS;
 exports.DataStoreDatabaseSchema = DataStoreDatabaseSchema;
@@ -115676,6 +115927,7 @@ exports.PtzPositionSchema = PtzPositionSchema;
 exports.PtzPresetFunctionSchema = PtzPresetFunctionSchema;
 exports.PtzPresetSchema = PtzPresetSchema;
 exports.PtzStatusSchema = PtzStatusSchema;
+exports.QUANTITY_BASE = require_sleep.QUANTITY_BASE;
 exports.QueryFilterSchema = QueryFilterSchema;
 exports.RATE_CONTROL_RELAXED = RATE_CONTROL_RELAXED;
 exports.RATE_CONTROL_TIGHT = RATE_CONTROL_TIGHT;
@@ -115754,6 +116006,7 @@ exports.ReadSegmentBytesResultSchema = ReadSegmentBytesResultSchema;
 exports.ReadWindowBytesResultSchema = ReadWindowBytesResultSchema;
 exports.ReadinessRegistry = require_sleep.ReadinessRegistry;
 exports.ReadinessTimeoutError = require_sleep.ReadinessTimeoutError;
+exports.ReadingQuantitySchema = require_sleep.ReadingQuantitySchema;
 exports.RebuildObjectEmbeddingsRefusalSchema = RebuildObjectEmbeddingsRefusalSchema;
 exports.RecentTracksPageSchema = RecentTracksPageSchema;
 exports.RecentTracksQueryInput = RecentTracksQueryInput;
@@ -116320,6 +116573,7 @@ exports.autoAssignProfiles = autoAssignProfiles;
 exports.automationControlCapability = automationControlCapability;
 exports.backupCapability = backupCapability;
 exports.bareAddonId = bareAddonId;
+exports.baseUnitOf = require_sleep.baseUnitOf;
 exports.batteryCapability = batteryCapability;
 exports.bestLocationMatch = bestLocationMatch;
 exports.binaryCapability = binaryCapability;
@@ -116539,6 +116793,7 @@ exports.diffStepSettings = diffStepSettings;
 exports.disarmRoseMemory = require_composition.disarmRoseMemory;
 exports.dishwasherCapability = dishwasherCapability;
 exports.displayPaletteCapability = displayPaletteCapability;
+exports.displayUnitFor = require_sleep.displayUnitFor;
 exports.doActionSelectValue = doActionSelectValue;
 exports.dominantClipLabels = dominantClipLabels;
 exports.doorbellCapability = doorbellCapability;
@@ -116625,6 +116880,7 @@ exports.formatMediaOwnerKey = formatMediaOwnerKey;
 exports.formatMinutes = formatMinutes;
 exports.formatPaletteViolations = formatPaletteViolations;
 exports.formatParkedFor = formatParkedFor;
+exports.formatReading = formatReading;
 exports.formatSecretScope = require_sleep.formatSecretScope;
 exports.formulaProblem = formulaProblem;
 exports.freshResults = freshResults;
@@ -116649,6 +116905,7 @@ exports.heatingValveCapability = heatingValveCapability;
 exports.hfModelUrl = require_sleep.hfModelUrl;
 exports.historyFieldsFor = historyFieldsFor;
 exports.historyItemFieldPath = require_sleep.historyItemFieldPath;
+exports.historyUnitFor = require_sleep.historyUnitFor;
 exports.htmlToText = htmlToText;
 exports.hubAddressHostname = hubAddressHostname;
 exports.hubMotionNativeProvider = hubMotionNativeProvider;
@@ -116663,6 +116920,7 @@ exports.imageModesForKind = imageModesForKind;
 exports.imageSettingsCapability = imageSettingsCapability;
 exports.inferExpressionKinds = inferExpressionKinds;
 exports.inferModelProvider = inferModelProvider;
+exports.ingestReading = ingestReading;
 exports.initialPoolMemoryState = initialPoolMemoryState;
 exports.integrationsCapability = integrationsCapability;
 exports.intercomCapability = intercomCapability;
@@ -116717,6 +116975,7 @@ exports.isOauthLandingReason = isOauthLandingReason;
 exports.isObjectInput = isObjectInput;
 exports.isOccupancyRule = isOccupancyRule;
 exports.isOwnerOnlyEventCategory = require_event_category.isOwnerOnlyEventCategory;
+exports.isReadingQuantity = require_sleep.isReadingQuantity;
 exports.isRemovedModelId = isRemovedModelId;
 exports.isRestoredCap = isRestoredCap;
 exports.isRetiredClearKey = isRetiredClearKey;
@@ -116947,6 +117206,7 @@ exports.ptzAutotrackCapability = ptzAutotrackCapability;
 exports.ptzCapability = ptzCapability;
 exports.publicEventCategories = require_event_category.publicEventCategories;
 exports.pythonScriptForBackend = pythonScriptForBackend;
+exports.quantityFromUnit = quantityFromUnit;
 exports.rankStreams = rankStreams;
 exports.readClusterStepModels = readClusterStepModels;
 exports.readClusterStepSettings = readClusterStepSettings;
@@ -116965,6 +117225,7 @@ exports.readRecoveryRecipeForSteps = readRecoveryRecipeForSteps;
 exports.readTimelapseGeneratedAt = readTimelapseGeneratedAt;
 exports.readUseRootModel = readUseRootModel;
 exports.readinessKey = require_sleep.readinessKey;
+exports.readingMeta = require_sleep.readingMeta;
 exports.rebootCapability = rebootCapability;
 exports.recommendNode = recommendNode;
 exports.reconcileBlockDevices = reconcileBlockDevices;
@@ -117065,6 +117326,7 @@ exports.runningFromMediaPlayer = runningFromMediaPlayer;
 exports.runningFromVacuumState = runningFromVacuumState;
 exports.runningStateCapability = runningStateCapability;
 exports.runtimeDevices = runtimeDevices;
+exports.runtimeFieldUnit = runtimeFieldUnit;
 exports.runtimeStatePolicyFor = runtimeStatePolicyFor;
 exports.sameDoFamily = sameDoFamily;
 exports.sameRead = sameRead;
@@ -117184,6 +117446,8 @@ exports.templateVarSystemEventApplies = templateVarSystemEventApplies;
 exports.templateVarsFor = templateVarsFor;
 exports.terminalSessionCapability = terminalSessionCapability;
 exports.textToHtml = textToHtml;
+exports.thresholdToBase = thresholdToBase;
+exports.thresholdToDisplay = thresholdToDisplay;
 exports.timeOfDayToMinutes = timeOfDayToMinutes;
 exports.toAppLinkHubOrigin = toAppLinkHubOrigin;
 exports.toDeviceSummary = toDeviceSummary;
@@ -117199,6 +117463,7 @@ exports.trainingCapability = trainingCapability;
 exports.trainingProviderCapability = trainingProviderCapability;
 exports.transcodeBody = transcodeBody;
 exports.transformSecretWrite = require_sleep.transformSecretWrite;
+exports.tryConvertDelta = tryConvertDelta;
 exports.tryConvertUnit = tryConvertUnit;
 exports.turnProviderCapability = turnProviderCapability;
 exports.unitCompanionField = unitCompanionField;