@camstack/types 1.2.416 → 1.2.417

package/dist/{sleep-BPQ2ZyaI.js → sleep-gtskVoMw.js}

@@ -5112,6 +5112,134 @@ function makeInMemoryRecords(owner = "spec", options = {}) {
 		}
 	};
 }
+var READING_QUANTITIES = [
+	"temperature",
+	"pressure",
+	"speed",
+	"precipitation",
+	"precipitation-rate",
+	"length",
+	"area",
+	"illuminance",
+	"irradiance",
+	"power",
+	"energy",
+	"voltage",
+	"current",
+	"apparent-power",
+	"humidity",
+	"percentage",
+	"concentration-volume",
+	"concentration-mass",
+	"concentration-ppb",
+	"volume",
+	"duration",
+	"duration-ms",
+	"information",
+	"sound-level",
+	"signal-level",
+	"colour-temperature",
+	"angle",
+	"bitrate",
+	"rate",
+	"mass",
+	"index",
+	"ratio",
+	"count",
+	"none",
+	"device"
+];
+var ReadingQuantitySchema = zod.z.enum(READING_QUANTITIES);
+var QUANTITY_SET = new Set(READING_QUANTITIES);
+function isReadingQuantity(value) {
+	return typeof value === "string" && QUANTITY_SET.has(value);
+}
+/**
+* Stored unit symbol for a quantity. `none` means the number is dimensionless
+* (or an index / ratio / count). `device` means the cap has no single unit.
+*/
+var QUANTITY_BASE = {
+	temperature: "°C",
+	pressure: "hPa",
+	speed: "m/s",
+	precipitation: "mm",
+	"precipitation-rate": "mm/h",
+	length: "m",
+	area: "m²",
+	illuminance: "lx",
+	irradiance: "W/m²",
+	power: "W",
+	energy: "kWh",
+	voltage: "V",
+	current: "A",
+	"apparent-power": "VA",
+	humidity: "%",
+	percentage: "%",
+	"concentration-volume": "ppm",
+	"concentration-mass": "µg/m³",
+	"concentration-ppb": "ppb",
+	volume: "L",
+	duration: "s",
+	"duration-ms": "ms",
+	information: "B",
+	"sound-level": "dBFS",
+	"signal-level": "dBm",
+	"colour-temperature": "mired",
+	angle: "°",
+	bitrate: "kbps",
+	rate: "fps",
+	mass: "kg",
+	index: "none",
+	ratio: "none",
+	count: "none",
+	none: "none",
+	device: "device"
+};
+/** The stored unit, or `undefined` when the quantity has no unit symbol. */
+function baseUnitOf(quantity) {
+	const symbol = QUANTITY_BASE[quantity];
+	if (symbol === "none" || symbol === "device") return void 0;
+	return symbol;
+}
+/**
+* History catalog label for a quantity. Index and ratio keep the labels the
+* series already used (`count`, `ratio`). A polymorphic reading has no
+* single label.
+*/
+function historyUnitFor(quantity) {
+	if (quantity === "index" || quantity === "count") return "count";
+	if (quantity === "ratio") return "ratio";
+	return baseUnitOf(quantity);
+}
+function readingMeta(quantity, extras) {
+	return {
+		quantity,
+		...extras?.precision !== void 0 ? { precision: extras.precision } : {},
+		...extras?.label !== void 0 ? { label: extras.label } : {}
+	};
+}
+/** Imperial display symbol when it differs from the stored base. */
+var IMPERIAL_DISPLAY = {
+	temperature: "°F",
+	pressure: "inHg",
+	speed: "mph",
+	precipitation: "in",
+	"precipitation-rate": "in/h",
+	length: "ft",
+	volume: "gal"
+};
+var DISPLAY_PREFERENCES = ["metric", "imperial"];
+var DEFAULT_DISPLAY_PREFERENCE = "metric";
+/** Display symbol for a preference. Duration and information are scaled by the formatter. */
+function displayUnitFor(quantity, preference) {
+	const base = baseUnitOf(quantity);
+	if (base === void 0) return void 0;
+	if (preference === "imperial") {
+		const imperial = IMPERIAL_DISPLAY[quantity];
+		if (imperial !== void 0) return imperial;
+	}
+	return base;
+}
 //#endregion
 //#region src/capabilities/schemas/streaming-shared.ts
 /** Shared Zod schemas used across streaming capabilities. */
@@ -5147,8 +5275,8 @@ var CamStreamKindSchema = zod.z.enum([
 	"derived"
 ]);
 var CamStreamResolutionSchema = zod.z.object({
-	width: zod.z.number().int().positive(),
-	height: zod.z.number().int().positive()
+	width: zod.z.number().int().positive().meta(readingMeta("none")),
+	height: zod.z.number().int().positive().meta(readingMeta("none"))
 });
 var CameraStreamSchema = zod.z.object({
 	/** Stable, provider-assigned id unique within the (deviceId) scope. */
@@ -6003,7 +6131,7 @@ zod.z.object({
 });
 /** The default applied to a `runtimeState` cap that declares no `durability`. */
 var DEFAULT_RUNTIME_STATE_DURABILITY = "session";
-/** Display label per {@link HistoryUnit} (only `'ug/m3'` differs from its id). */
+/** Display label per {@link HistoryUnit}. */
 var HISTORY_UNIT_LABELS = {
 	"%": "%",
 	dBFS: "dBFS",
@@ -6017,7 +6145,7 @@ var HISTORY_UNIT_LABELS = {
 	lx: "lx",
 	ppm: "ppm",
 	ppb: "ppb",
-	"ug/m3": "µg/m³",
+	"µg/m³": "µg/m³",
 	hPa: "hPa",
 	count: "count",
 	ratio: "ratio",
@@ -6026,7 +6154,8 @@ var HISTORY_UNIT_LABELS = {
 	days: "days",
 	bytes: "bytes",
 	kbps: "kbps",
-	fps: "fps"
+	fps: "fps",
+	"m/s": "m/s"
 };
 /** The catalog field path of an item field: `<itemsPath>[].<field>` (`items[].level`). */
 function historyItemFieldPath(itemsPath, field) {
@@ -6714,14 +6843,6 @@ var CAP_STATE_LEAVES = Object.freeze({
 		{
 			"path": "aqi",
 			"valueType": "number"
-		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
 		}
 	],
 	"alarm-panel": [
@@ -6757,20 +6878,10 @@ var CAP_STATE_LEAVES = Object.freeze({
 			"valueType": "boolean"
 		}
 	],
-	"ambient-light-sensor": [
-		{
-			"path": "lux",
-			"valueType": "number"
-		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
-		}
-	],
+	"ambient-light-sensor": [{
+		"path": "lux",
+		"valueType": "number"
+	}],
 	"audio-metrics": [
 		{
 			"path": "ts",
@@ -6850,6 +6961,10 @@ var CAP_STATE_LEAVES = Object.freeze({
 			"path": "lastUpdated",
 			"valueType": "number"
 		},
+		{
+			"path": "volts",
+			"valueType": "number"
+		},
 		{
 			"path": "lastContactAt",
 			"valueType": "number"
@@ -7092,10 +7207,6 @@ var CAP_STATE_LEAVES = Object.freeze({
 				"datetime"
 			]
 		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
 		{
 			"path": "min",
 			"valueType": "number"
@@ -7107,19 +7218,6 @@ var CAP_STATE_LEAVES = Object.freeze({
 		{
 			"path": "step",
 			"valueType": "number"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
-		},
-		{
-			"path": "format",
-			"valueType": "enum",
-			"enumValues": [
-				"date",
-				"time",
-				"datetime"
-			]
 		}
 	],
 	"cover": [
@@ -7360,13 +7458,8 @@ var CAP_STATE_LEAVES = Object.freeze({
 		"path": "value",
 		"valueType": "string"
 	}, {
-		"path": "format",
-		"valueType": "enum",
-		"enumValues": [
-			"date",
-			"time",
-			"datetime"
-		]
+		"path": "timestamp",
+		"valueType": "boolean"
 	}],
 	"event-emitter": [
 		{
@@ -7473,20 +7566,10 @@ var CAP_STATE_LEAVES = Object.freeze({
 			"valueType": "number"
 		}
 	],
-	"humidity-sensor": [
-		{
-			"path": "percent",
-			"valueType": "number"
-		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
-		}
-	],
+	"humidity-sensor": [{
+		"path": "percent",
+		"valueType": "number"
+	}],
 	"image": [{
 		"path": "url",
 		"valueType": "string"
@@ -7825,20 +7908,10 @@ var CAP_STATE_LEAVES = Object.freeze({
 			"valueType": "boolean"
 		}
 	],
-	"numeric-sensor": [
-		{
-			"path": "value",
-			"valueType": "number"
-		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
-		}
-	],
+	"numeric-sensor": [{
+		"path": "value",
+		"valueType": "number"
+	}],
 	"pet-feeder": [
 		{
 			"path": "foodLevel",
@@ -7930,14 +8003,6 @@ var CAP_STATE_LEAVES = Object.freeze({
 		{
 			"path": "powerFactor",
 			"valueType": "number"
-		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
 		}
 	],
 	"presence": [
@@ -7966,20 +8031,10 @@ var CAP_STATE_LEAVES = Object.freeze({
 			"valueType": "number"
 		}
 	],
-	"pressure-sensor": [
-		{
-			"path": "hpa",
-			"valueType": "number"
-		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
-		}
-	],
+	"pressure-sensor": [{
+		"path": "hpa",
+		"valueType": "number"
+	}],
 	"privacy-mask": [{
 		"path": "enabled",
 		"valueType": "boolean"
@@ -8290,20 +8345,10 @@ var CAP_STATE_LEAVES = Object.freeze({
 		"path": "tampered",
 		"valueType": "boolean"
 	}],
-	"temperature-sensor": [
-		{
-			"path": "celsius",
-			"valueType": "number"
-		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
-		}
-	],
+	"temperature-sensor": [{
+		"path": "celsius",
+		"valueType": "number"
+	}],
 	"update": [
 		{
 			"path": "currentVersion",
@@ -8414,10 +8459,6 @@ var CAP_STATE_LEAVES = Object.freeze({
 			"path": "temperature",
 			"valueType": "number"
 		},
-		{
-			"path": "temperatureUnit",
-			"valueType": "string"
-		},
 		{
 			"path": "humidity",
 			"valueType": "number"
@@ -8426,18 +8467,10 @@ var CAP_STATE_LEAVES = Object.freeze({
 			"path": "pressure",
 			"valueType": "number"
 		},
-		{
-			"path": "pressureUnit",
-			"valueType": "string"
-		},
 		{
 			"path": "windSpeed",
 			"valueType": "number"
 		},
-		{
-			"path": "windSpeedUnit",
-			"valueType": "string"
-		},
 		{
 			"path": "windBearing",
 			"valueType": "number"
@@ -10285,6 +10318,12 @@ Object.defineProperty(exports, "DATAPLANE_SECRET_HEADER", {
 		return DATAPLANE_SECRET_HEADER;
 	}
 });
+Object.defineProperty(exports, "DEFAULT_DISPLAY_PREFERENCE", {
+	enumerable: true,
+	get: function() {
+		return DEFAULT_DISPLAY_PREFERENCE;
+	}
+});
 Object.defineProperty(exports, "DEFAULT_RUNTIME_STATE_DURABILITY", {
 	enumerable: true,
 	get: function() {
@@ -10321,6 +10360,12 @@ Object.defineProperty(exports, "DEVICE_STATUS_METHOD", {
 		return DEVICE_STATUS_METHOD;
 	}
 });
+Object.defineProperty(exports, "DISPLAY_PREFERENCES", {
+	enumerable: true,
+	get: function() {
+		return DISPLAY_PREFERENCES;
+	}
+});
 Object.defineProperty(exports, "DeclarationRefusedError", {
 	enumerable: true,
 	get: function() {
@@ -10489,6 +10534,12 @@ Object.defineProperty(exports, "ProfileSlotStatusSchema", {
 		return ProfileSlotStatusSchema;
 	}
 });
+Object.defineProperty(exports, "QUANTITY_BASE", {
+	enumerable: true,
+	get: function() {
+		return QUANTITY_BASE;
+	}
+});
 Object.defineProperty(exports, "RECORDS_ERROR_CODES", {
 	enumerable: true,
 	get: function() {
@@ -10621,6 +10672,12 @@ Object.defineProperty(exports, "ReadinessTimeoutError", {
 		return ReadinessTimeoutError;
 	}
 });
+Object.defineProperty(exports, "ReadingQuantitySchema", {
+	enumerable: true,
+	get: function() {
+		return ReadingQuantitySchema;
+	}
+});
 Object.defineProperty(exports, "RecordFieldPathSchema", {
 	enumerable: true,
 	get: function() {
@@ -10843,6 +10900,12 @@ Object.defineProperty(exports, "audioChunkBytesPerSample", {
 		return audioChunkBytesPerSample;
 	}
 });
+Object.defineProperty(exports, "baseUnitOf", {
+	enumerable: true,
+	get: function() {
+		return baseUnitOf;
+	}
+});
 Object.defineProperty(exports, "buildSecretRef", {
 	enumerable: true,
 	get: function() {
@@ -11023,6 +11086,12 @@ Object.defineProperty(exports, "deviceOpsCapability", {
 		return deviceOpsCapability;
 	}
 });
+Object.defineProperty(exports, "displayUnitFor", {
+	enumerable: true,
+	get: function() {
+		return displayUnitFor;
+	}
+});
 Object.defineProperty(exports, "emitDownForOwnedCaps", {
 	enumerable: true,
 	get: function() {
@@ -11089,6 +11158,12 @@ Object.defineProperty(exports, "historyItemFieldPath", {
 		return historyItemFieldPath;
 	}
 });
+Object.defineProperty(exports, "historyUnitFor", {
+	enumerable: true,
+	get: function() {
+		return historyUnitFor;
+	}
+});
 Object.defineProperty(exports, "hydrateSchema", {
 	enumerable: true,
 	get: function() {
@@ -11131,6 +11206,12 @@ Object.defineProperty(exports, "isKeychainStoredField", {
 		return isKeychainStoredField;
 	}
 });
+Object.defineProperty(exports, "isReadingQuantity", {
+	enumerable: true,
+	get: function() {
+		return isReadingQuantity;
+	}
+});
 Object.defineProperty(exports, "isSecretClear", {
 	enumerable: true,
 	get: function() {
@@ -11329,6 +11410,12 @@ Object.defineProperty(exports, "readinessKey", {
 		return readinessKey;
 	}
 });
+Object.defineProperty(exports, "readingMeta", {
+	enumerable: true,
+	get: function() {
+		return readingMeta;
+	}
+});
 Object.defineProperty(exports, "recordArrayItemPath", {
 	enumerable: true,
 	get: function() {

package/dist/units/convert.d.ts

@@ -46,4 +46,9 @@ export declare function canConvertUnit(from: string, to: string): boolean;
  * 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.
+ */
+export declare function tryConvertDelta(value: number, from: string, to: string): number | undefined;
 export declare function unitsForDimension(dimension: UnitDimension): readonly string[];

package/dist/units/format-reading.d.ts

@@ -0,0 +1,15 @@
+import { type DisplayPreference, type ReadingQuantity } from './quantity.js';
+export interface FormatReadingInput {
+    readonly value: number;
+    readonly quantity: ReadingQuantity;
+    readonly preference?: DisplayPreference;
+    readonly precision?: number;
+    /** Concrete quantity when `quantity` is `device`. */
+    readonly deviceQuantity?: ReadingQuantity;
+}
+export interface FormattedReading {
+    readonly text: string;
+    readonly unit: string;
+    readonly value: number;
+}
+export declare function formatReading(input: FormatReadingInput): FormattedReading;

package/dist/units/index.d.ts

@@ -4,5 +4,12 @@
  */
 export { UNIT_TABLE } from './unit-table.js';
 export type { UnitDimension, UnitSpec, KnownUnit } from './unit-table.js';
-export { UnitConversionError, unitDimension, convertUnit, tryConvertUnit, canConvertUnit, unitsForDimension, } from './convert.js';
+export { UnitConversionError, unitDimension, convertUnit, tryConvertUnit, tryConvertDelta, canConvertUnit, unitsForDimension, } from './convert.js';
 export type { UnitConversionReason } from './convert.js';
+export { DEFAULT_DISPLAY_PREFERENCE, DISPLAY_PREFERENCES, QUANTITY_BASE, ReadingQuantitySchema, baseUnitOf, displayUnitFor, historyUnitFor, isReadingQuantity, readingMeta, } from './quantity.js';
+export type { DisplayPreference, ReadingMeta, ReadingQuantity } from './quantity.js';
+export { thresholdToBase, thresholdToDisplay } from './threshold.js';
+export { formatReading } from './format-reading.js';
+export type { FormatReadingInput, FormattedReading } from './format-reading.js';
+export { ingestReading, quantityFromUnit } from './ingest-reading.js';
+export type { IngestReadingInput, IngestReadingResult, IngestRefusal } from './ingest-reading.js';

package/dist/units/ingest-reading.d.ts

@@ -0,0 +1,21 @@
+import { type ReadingQuantity } from './quantity.js';
+export type IngestRefusal = 'non-finite' | 'unknown-unit' | 'cross-dimension';
+export interface IngestReadingInput {
+    readonly value: number;
+    readonly rawUnit: string | undefined;
+    readonly quantity: ReadingQuantity;
+}
+export type IngestReadingResult = {
+    readonly ok: true;
+    readonly value: number;
+} | {
+    readonly ok: false;
+    readonly reason: IngestRefusal;
+};
+/**
+ * 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.
+ */
+export declare function quantityFromUnit(rawUnit: string | undefined): ReadingQuantity | undefined;
+export declare function ingestReading(input: IngestReadingInput): IngestReadingResult;

package/dist/units/quantity.d.ts

@@ -0,0 +1,47 @@
+/**
+ * A numeric reading is stored in the base unit of its quantity (D944 §4).
+ * The base symbol lives here — never as a sibling field on the device slice.
+ *
+ * `energy` is stored in kWh even though `UNIT_TABLE`'s linear origin is Wh:
+ * history, Matter and the field name already count kilowatt-hours.
+ * `concentration-ppb` is separate so VOC parts-per-billion are not divided
+ * by 1000 into ppm. `device` is a polymorphic reading (numeric-sensor,
+ * numeric control): the quantity is chosen once, on the device, at adopt.
+ */
+import { z } from 'zod';
+declare const READING_QUANTITY_VALUES: readonly ['temperature', 'pressure', 'speed', 'precipitation', 'precipitation-rate', 'length', 'area', 'illuminance', 'irradiance', 'power', 'energy', 'voltage', 'current', 'apparent-power', 'humidity', 'percentage', 'concentration-volume', 'concentration-mass', 'concentration-ppb', 'volume', 'duration', 'duration-ms', 'information', 'sound-level', 'signal-level', 'colour-temperature', 'angle', 'bitrate', 'rate', 'mass', 'index', 'ratio', 'count', 'none', 'device'];
+export declare const READING_QUANTITIES: typeof READING_QUANTITY_VALUES;
+export type ReadingQuantity = (typeof READING_QUANTITIES)[number];
+export declare const ReadingQuantitySchema: z.ZodType<ReadingQuantity>;
+export declare function isReadingQuantity(value: unknown): value is ReadingQuantity;
+/**
+ * Stored unit symbol for a quantity. `none` means the number is dimensionless
+ * (or an index / ratio / count). `device` means the cap has no single unit.
+ */
+export declare const QUANTITY_BASE: Readonly<Record<ReadingQuantity, string>>;
+/** The stored unit, or `undefined` when the quantity has no unit symbol. */
+export declare function baseUnitOf(quantity: ReadingQuantity): string | undefined;
+/**
+ * History catalog label for a quantity. Index and ratio keep the labels the
+ * series already used (`count`, `ratio`). A polymorphic reading has no
+ * single label.
+ */
+export declare function historyUnitFor(quantity: ReadingQuantity): string | undefined;
+/** Zod `.meta()` bag for a numeric reading. Precision is a display hint. */
+export type ReadingMeta = {
+    readonly [key: string]: unknown;
+    readonly quantity: ReadingQuantity;
+    readonly precision?: number;
+    readonly label?: string;
+};
+export declare function readingMeta(quantity: ReadingQuantity, extras?: {
+    readonly precision?: number;
+    readonly label?: string;
+}): ReadingMeta;
+declare const DISPLAY_PREFERENCE_VALUES: readonly ['metric', 'imperial'];
+export declare const DISPLAY_PREFERENCES: typeof DISPLAY_PREFERENCE_VALUES;
+export type DisplayPreference = (typeof DISPLAY_PREFERENCES)[number];
+export declare const DEFAULT_DISPLAY_PREFERENCE: DisplayPreference;
+/** Display symbol for a preference. Duration and information are scaled by the formatter. */
+export declare function displayUnitFor(quantity: ReadingQuantity, preference: DisplayPreference): string | undefined;
+export {};

package/dist/units/threshold.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Move a threshold between the unit the operator sees and the stored base.
+ * A failed conversion leaves the number unchanged — the recipe stays serialisable.
+ */
+export declare function thresholdToBase(value: number, displayUnit: string, baseUnit: string): number;
+export declare function thresholdToDisplay(value: number, baseUnit: string, displayUnit: string): number;