@camstack/types 1.2.416 → 1.2.418

package/dist/{sleep-BErAxhul.mjs → sleep-B81gwQuR.mjs}

@@ -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 = 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 = z.enum([
 	"derived"
 ]);
 var CamStreamResolutionSchema = z.object({
-	width: z.number().int().positive(),
-	height: z.number().int().positive()
+	width: z.number().int().positive().meta(readingMeta("none")),
+	height: z.number().int().positive().meta(readingMeta("none"))
 });
 var CameraStreamSchema = z.object({
 	/** Stable, provider-assigned id unique within the (deviceId) scope. */
@@ -6003,7 +6131,7 @@ 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) {
@@ -6584,6 +6713,7 @@ var CAP_NAMES = Object.freeze([
 	"filesystem-browse",
 	"flood",
 	"gas",
+	"group-status",
 	"heating-valve",
 	"humidifier",
 	"humidity-sensor",
@@ -6714,14 +6844,6 @@ var CAP_STATE_LEAVES = Object.freeze({
 		{
 			"path": "aqi",
 			"valueType": "number"
-		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
 		}
 	],
 	"alarm-panel": [
@@ -6757,20 +6879,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 +6962,10 @@ var CAP_STATE_LEAVES = Object.freeze({
 			"path": "lastUpdated",
 			"valueType": "number"
 		},
+		{
+			"path": "volts",
+			"valueType": "number"
+		},
 		{
 			"path": "lastContactAt",
 			"valueType": "number"
@@ -7092,10 +7208,6 @@ var CAP_STATE_LEAVES = Object.freeze({
 				"datetime"
 			]
 		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
 		{
 			"path": "min",
 			"valueType": "number"
@@ -7107,19 +7219,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 +7459,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": [
 		{
@@ -7439,6 +7533,20 @@ var CAP_STATE_LEAVES = Object.freeze({
 		"path": "detected",
 		"valueType": "boolean"
 	}],
+	"group-status": [
+		{
+			"path": "included",
+			"valueType": "number"
+		},
+		{
+			"path": "excluded",
+			"valueType": "number"
+		},
+		{
+			"path": "total",
+			"valueType": "number"
+		}
+	],
 	"heating-valve": [{
 		"path": "position",
 		"valueType": "number"
@@ -7473,20 +7581,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 +7923,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 +8018,6 @@ var CAP_STATE_LEAVES = Object.freeze({
 		{
 			"path": "powerFactor",
 			"valueType": "number"
-		},
-		{
-			"path": "unit",
-			"valueType": "string"
-		},
-		{
-			"path": "precision",
-			"valueType": "number"
 		}
 	],
 	"presence": [
@@ -7966,20 +8046,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 +8360,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 +8474,6 @@ var CAP_STATE_LEAVES = Object.freeze({
 			"path": "temperature",
 			"valueType": "number"
 		},
-		{
-			"path": "temperatureUnit",
-			"valueType": "string"
-		},
 		{
 			"path": "humidity",
 			"valueType": "number"
@@ -8426,18 +8482,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"
@@ -9053,6 +9101,7 @@ function createDeviceProxy(api, binding, opts) {
 	const featureProbeInterface = { getStatus: (input) => dispatch("feature-probe", "featureProbe", "getStatus", "query", input) };
 	const floodInterface = { getStatus: (input) => dispatch("flood", "flood", "getStatus", "query", input) };
 	const gasInterface = { getStatus: (input) => dispatch("gas", "gas", "getStatus", "query", input) };
+	const groupStatusInterface = { getStatus: (input) => dispatch("group-status", "groupStatus", "getStatus", "query", input) };
 	const heatingValveInterface = { getStatus: (input) => dispatch("heating-valve", "heatingValve", "getStatus", "query", input) };
 	const humidifierInterface = {
 		setOn: (input) => dispatch("humidifier", "humidifier", "setOn", "mutation", input),
@@ -9607,6 +9656,7 @@ function createDeviceProxy(api, binding, opts) {
 			featureProbe: createSliceHandle(stateSource, binding.deviceId, "feature-probe"),
 			flood: createSliceHandle(stateSource, binding.deviceId, "flood"),
 			gas: createSliceHandle(stateSource, binding.deviceId, "gas"),
+			groupStatus: createSliceHandle(stateSource, binding.deviceId, "group-status"),
 			heatingValve: createSliceHandle(stateSource, binding.deviceId, "heating-valve"),
 			humidifier: createSliceHandle(stateSource, binding.deviceId, "humidifier"),
 			humiditySensor: createSliceHandle(stateSource, binding.deviceId, "humidity-sensor"),
@@ -9690,6 +9740,7 @@ function createDeviceProxy(api, binding, opts) {
 		...bound("feature-probe") ? { featureProbe: featureProbeInterface } : {},
 		...bound("flood") ? { flood: floodInterface } : {},
 		...bound("gas") ? { gas: gasInterface } : {},
+		...bound("group-status") ? { groupStatus: groupStatusInterface } : {},
 		...bound("heating-valve") ? { heatingValve: heatingValveInterface } : {},
 		...bound("humidifier") ? { humidifier: humidifierInterface } : {},
 		...bound("humidity-sensor") ? { humiditySensor: humiditySensorInterface } : {},
@@ -10165,4 +10216,4 @@ function sleepCancellable(ms, signal) {
 	});
 }
 //#endregion
-export { expandCapMethods as $, PEER_BYTES_CHUNK_BYTES as $n, omitTransientConfig as $r, REMOVE_LEAF as $t, HF_REPO as A, RECORD_BATCH_MAX_BYTES as An, emitReadiness as Ar, StreamSourceEntrySchema$1 as At, withoutCallerStamp as B, RECORD_SECRET_COLLECTION_PREFIX as Bn, SECRET_CLEAR as Br, entryBody as Bt, addonSliceHandleApi as C, RevConflictError as Cn, globalSecretScope as Cr, CamStreamResolutionSchema as Ct, createSliceHandle as D, asRecordsError as Dn, normalizeNodeId as Dr, ProfileRtspEntrySchema as Dt, createMirrorSource as E, UnknownRecordKindError as En, parseSecretRef as Er, FrameHandleSchema as Et, RawStateResultSchema as F, RECORD_ID_MAX_LENGTH as Fn, collectHydratedFieldValues as Fr, makeSourceBrokerId as Ft, adminUiCapability as G, createSecretsAccess as Gn, isSecretMarkerLike as Gr, RecordIndexSchema as Gt, defineCustomActions as H, RECORD_SWEEP_INTERVAL_MS as Hn, isSecretClear as Hr, assertTransactScope as Ht, deviceOpsCapability as I, RECORD_MAX_DATA_BYTES as In, dehydrateConfigField as Ir, parseProfileBrokerId as It, DEVICE_STATUS_METHOD as J, forgetKnownSecret as Jn, REDACTED_SECRET as Jr, RecordRetentionSchema as Jt, DEFAULT_RUNTIME_STATE_DURABILITY as K, MIN_SCRUBBED_LENGTH as Kn, makeSecretMarker as Kr, RecordKindDeclarationSchema as Kt, viewerUiCapability as L, RECORD_MAX_INDEXES as Ln, dehydrateSchema as Lr, selectAssignedProfileSlots as Lt, CAP_ADVANCE_FIELDS as M, RECORD_DATABASES as Mn, WELL_KNOWN_TABS as Mr, SubscribeAudioChunksInputSchema as Mt, CAP_NAMES as N, RECORD_DEFAULT_MAX_DATA_BYTES as Nn, WELL_KNOWN_TAB_MAP as Nr, SubscribeAudioChunksResultSchema as Nt, DEFAULT_TOKEN_EXPIRY as O, recordsErrorFromMessage as On, createDurableState as Or, ProfileSlotSchema as Ot, CAP_STATE_LEAVES as P, RECORD_DELETE_BATCH as Pn, collectHydratedFieldEntries as Pr, makeProfileBrokerId as Pt, event as Q, shortSecretRefHash as Qn, isSecretConfigField as Qr, defineRecordKinds as Qt, DEVICE_CHILDREN_BATCH_MAX as R, RECORD_MAX_INDEX_FIELDS as Rn, hydrateSchema as Rr, makeInMemoryRecords as Rt, invokeTrpcLeaf as S, RecordsError as Sn, formatSecretScope as Sr, CamStreamKindSchema as St, createLazyTrpcSource as T, UnindexedFilterError as Tn, normalizeSecretOwner as Tr, DecodedAudioChunkSchema as Tt, describeCustomActions as U, resolveSecretViewsIn as Un, isSecretFieldView as Ur, EntryDescriptorSchema as Ut, customAction as V, RECORD_SETTINGS_MAX_ROWS as Vn, classifySecretWrite as Vr, createRecordsAccess as Vt, deviceCustomAction as W, REVALIDATE_AFTER_MS as Wn, isSecretMarker as Wr, RecordFieldPathSchema as Wt, HISTORY_UNIT_LABELS as X, registerKnownSecret as Xn, collectSecretConfigKeys as Xr, assertValidDeclaration as Xt, HISTORY_DEFAULT_MIN_INTERVAL_MS as Y, knownSecretCount as Yn, collectKeychainStoredKeys as Yr, StoredRecordKindDeclarationSchema as Yt, PROVIDER_PIN_FIELD as Z, scrubKnownSecrets as Zn, isKeychainStoredField as Zr, declarationsOf as Zt, readErrorI18n as _, RECORDS_ERROR_CODES as _n, resolveSecretMarkers as _r, AudioStreamPickSchema as _t, asJsonArray as a, recordSecretRef as an, SHARE_VIEW_KINDS as ar, systemMethod as at, isDeviceScopedCap as b, RecordTooLargeError as bn, arrayItemFieldPath as br, CAM_PROFILE_ORDER as bt, asString as c, collectZodSecretPaths as cn, classifyStoreError as cr, readNodePin as ct, parseJsonUnknown as d, DeclarationRefusedError as dn, parseSecretStatePath as dr, ReadinessRegistry as dt, schemaDeclaresAnyField as ei, collectSecretLeaves as en, PEER_BYTES_MAX_OUTSTANDING as er, historyItemFieldPath as et, hfModelUrl as f, FilterRequiredError as fn, secretTreeFromPaths as fr, ReadinessTimeoutError as ft, ErrorI18nPayloadSchema as g, PlaintextSecretError as gn, isSecretRefOwnedBy as gr, AudioChunkFormatSchema as gt, ErrorCodeSchema as h, NoCallerError as hn, collectSecretMarkerRefs as hr, scopeKey as ht, asBoolean as i, isAudioChunkFormat as ii, recordSecretCollection as in, DATAPLANE_SECRET_HEADER as ir, resolveCapMount as it, RUNTIME_DEFAULTS as j, RECORD_CLASSES as jn, isEvent as jr, StreamSourceSchema as jt, HF_BASE_URL as k, RECORD_BATCH_MAX as kn, createEvent as kr, ProfileSlotStatusSchema as kt, parseJsonArray as l, isZodSecret as ln, normalizeAddonInitResult as lr, toNodeId as lt, CamstackError as m, InvalidRecordError as mn, KeychainWriteRefusedError as mr, readinessKey as mt, sleepCancellable as n, audioChunkBytesPerSample as ni, parseSecretPath as nn, PEER_BYTES_TICKET_TTL_MS as nr, method as nt, asJsonObject as o, secretArrayPrefixes as on, DisposerChain as or, CAP_NODE_PIN_CONTEXT_KEY as ot, BOOT_RECOVERY_BACKOFF_MS as p, ForeignSecretMarkerError as pn, secretTreeFromSchema as pr, emitDownForOwnedCaps as pt, DEVICE_SETTINGS_CONTRIBUTION_METHODS as q, clearKnownSecrets as qn, toSecretFieldView as qr, RecordKindNameSchema as qt, maskUrlCredentials as r, expandAudioChunkToF32le as ri, recordArrayItemPath as rn, PeerBytesTicketSchema as rr, optionalMethod as rt, asNumber as s, SECRET_META as sn, BaseAddon as sr, nodePin as st, sleep as t, AUDIO_CHUNK_FORMATS as ti, mapSecretLeaves as tn, PEER_BYTES_STALL_MS as tr, isDeviceConfigCap as tt, parseJsonObject as u, BatchTooLargeError as un, mergeSecretStatePaths as ur, MODEL_FORMATS as ut, userError as v, RecordNotFoundError as vn, transformSecretWrite as vr, BrokerStatsSchema as vt, createEventBusSliceSource as w, TransactRefusedError as wn, isSecretRef as wr, CameraStreamSchema as wt, createDeviceProxy as x, RecordUniqueViolationError as xn, buildSecretRef as xr, CamProfileSchema as xt, DEVICE_SCOPED_CAPS as y, RecordSecretUnavailableError as yn, SECRET_REF_SCHEME as yr, BrokerStatusSchema as yt, CALLER_STAMPED_CAPABILITIES as z, RECORD_QUERY_MAX as zn, resolveHydratedFieldValue as zr, defineEntryKind as zt };
+export { expandCapMethods as $, REVALIDATE_AFTER_MS as $n, isSecretMarker as $r, RecordFieldPathSchema as $t, HF_REPO as A, RecordUniqueViolationError as An, buildSecretRef as Ar, StreamSourceEntrySchema$1 as At, withoutCallerStamp as B, RECORD_CLASSES as Bn, isEvent as Br, QUANTITY_BASE as Bt, addonSliceHandleApi as C, InvalidRecordError as Cn, KeychainWriteRefusedError as Cr, CamStreamResolutionSchema as Ct, createSliceHandle as D, RecordNotFoundError as Dn, transformSecretWrite as Dr, ProfileRtspEntrySchema as Dt, createMirrorSource as E, RECORDS_ERROR_CODES as En, resolveSecretMarkers as Er, FrameHandleSchema as Et, RawStateResultSchema as F, UnknownRecordKindError as Fn, parseSecretRef as Fr, makeSourceBrokerId as Ft, adminUiCapability as G, RECORD_MAX_DATA_BYTES as Gn, dehydrateConfigField as Gr, isReadingQuantity as Gt, defineCustomActions as H, RECORD_DEFAULT_MAX_DATA_BYTES as Hn, WELL_KNOWN_TAB_MAP as Hr, baseUnitOf as Ht, deviceOpsCapability as I, asRecordsError as In, normalizeNodeId as Ir, parseProfileBrokerId as It, DEVICE_STATUS_METHOD as J, RECORD_QUERY_MAX as Jn, resolveHydratedFieldValue as Jr, defineEntryKind as Jt, DEFAULT_RUNTIME_STATE_DURABILITY as K, RECORD_MAX_INDEXES as Kn, dehydrateSchema as Kr, readingMeta as Kt, viewerUiCapability as L, recordsErrorFromMessage as Ln, createDurableState as Lr, selectAssignedProfileSlots as Lt, CAP_ADVANCE_FIELDS as M, RevConflictError as Mn, globalSecretScope as Mr, SubscribeAudioChunksInputSchema as Mt, CAP_NAMES as N, TransactRefusedError as Nn, isSecretRef as Nr, SubscribeAudioChunksResultSchema as Nt, DEFAULT_TOKEN_EXPIRY as O, RecordSecretUnavailableError as On, SECRET_REF_SCHEME as Or, ProfileSlotSchema as Ot, CAP_STATE_LEAVES as P, UnindexedFilterError as Pn, normalizeSecretOwner as Pr, makeProfileBrokerId as Pt, event as Q, resolveSecretViewsIn as Qn, isSecretFieldView as Qr, EntryDescriptorSchema as Qt, DEVICE_CHILDREN_BATCH_MAX as R, RECORD_BATCH_MAX as Rn, createEvent as Rr, DEFAULT_DISPLAY_PREFERENCE as Rt, invokeTrpcLeaf as S, ForeignSecretMarkerError as Sn, secretTreeFromSchema as Sr, CamStreamKindSchema as St, createLazyTrpcSource as T, PlaintextSecretError as Tn, isSecretRefOwnedBy as Tr, DecodedAudioChunkSchema as Tt, describeCustomActions as U, RECORD_DELETE_BATCH as Un, collectHydratedFieldEntries as Ur, displayUnitFor as Ut, customAction as V, RECORD_DATABASES as Vn, WELL_KNOWN_TABS as Vr, ReadingQuantitySchema as Vt, deviceCustomAction as W, RECORD_ID_MAX_LENGTH as Wn, collectHydratedFieldValues as Wr, historyUnitFor as Wt, HISTORY_UNIT_LABELS as X, RECORD_SETTINGS_MAX_ROWS as Xn, classifySecretWrite as Xr, createRecordsAccess as Xt, HISTORY_DEFAULT_MIN_INTERVAL_MS as Y, RECORD_SECRET_COLLECTION_PREFIX as Yn, SECRET_CLEAR as Yr, entryBody as Yt, PROVIDER_PIN_FIELD as Z, RECORD_SWEEP_INTERVAL_MS as Zn, isSecretClear as Zr, assertTransactScope as Zt, readErrorI18n as _, collectZodSecretPaths as _n, classifyStoreError as _r, AudioStreamPickSchema as _t, asJsonArray as a, collectSecretConfigKeys as ai, assertValidDeclaration as an, registerKnownSecret as ar, systemMethod as at, isDeviceScopedCap as b, DeclarationRefusedError as bn, parseSecretStatePath as br, CAM_PROFILE_ORDER as bt, asString as c, omitTransientConfig as ci, REMOVE_LEAF as cn, PEER_BYTES_CHUNK_BYTES as cr, readNodePin as ct, parseJsonUnknown as d, audioChunkBytesPerSample as di, parseSecretPath as dn, PEER_BYTES_TICKET_TTL_MS as dr, ReadinessRegistry as dt, isSecretMarkerLike as ei, RecordIndexSchema as en, createSecretsAccess as er, historyItemFieldPath as et, hfModelUrl as f, expandAudioChunkToF32le as fi, recordArrayItemPath as fn, PeerBytesTicketSchema as fr, ReadinessTimeoutError as ft, ErrorI18nPayloadSchema as g, SECRET_META as gn, BaseAddon as gr, AudioChunkFormatSchema as gt, ErrorCodeSchema as h, secretArrayPrefixes as hn, DisposerChain as hr, scopeKey as ht, asBoolean as i, collectKeychainStoredKeys as ii, StoredRecordKindDeclarationSchema as in, knownSecretCount as ir, resolveCapMount as it, RUNTIME_DEFAULTS as j, RecordsError as jn, formatSecretScope as jr, StreamSourceSchema as jt, HF_BASE_URL as k, RecordTooLargeError as kn, arrayItemFieldPath as kr, ProfileSlotStatusSchema as kt, parseJsonArray as l, schemaDeclaresAnyField as li, collectSecretLeaves as ln, PEER_BYTES_MAX_OUTSTANDING as lr, toNodeId as lt, CamstackError as m, recordSecretRef as mn, SHARE_VIEW_KINDS as mr, readinessKey as mt, sleepCancellable as n, toSecretFieldView as ni, RecordKindNameSchema as nn, clearKnownSecrets as nr, method as nt, asJsonObject as o, isKeychainStoredField as oi, declarationsOf as on, scrubKnownSecrets as or, CAP_NODE_PIN_CONTEXT_KEY as ot, BOOT_RECOVERY_BACKOFF_MS as p, isAudioChunkFormat as pi, recordSecretCollection as pn, DATAPLANE_SECRET_HEADER as pr, emitDownForOwnedCaps as pt, DEVICE_SETTINGS_CONTRIBUTION_METHODS as q, RECORD_MAX_INDEX_FIELDS as qn, hydrateSchema as qr, makeInMemoryRecords as qt, maskUrlCredentials as r, REDACTED_SECRET as ri, RecordRetentionSchema as rn, forgetKnownSecret as rr, optionalMethod as rt, asNumber as s, isSecretConfigField as si, defineRecordKinds as sn, shortSecretRefHash as sr, nodePin as st, sleep as t, makeSecretMarker as ti, RecordKindDeclarationSchema as tn, MIN_SCRUBBED_LENGTH as tr, isDeviceConfigCap as tt, parseJsonObject as u, AUDIO_CHUNK_FORMATS as ui, mapSecretLeaves as un, PEER_BYTES_STALL_MS as ur, MODEL_FORMATS as ut, userError as v, isZodSecret as vn, normalizeAddonInitResult as vr, BrokerStatsSchema as vt, createEventBusSliceSource as w, NoCallerError as wn, collectSecretMarkerRefs as wr, CameraStreamSchema as wt, createDeviceProxy as x, FilterRequiredError as xn, secretTreeFromPaths as xr, CamProfileSchema as xt, DEVICE_SCOPED_CAPS as y, BatchTooLargeError as yn, mergeSecretStatePaths as yr, BrokerStatusSchema as yt, CALLER_STAMPED_CAPABILITIES as z, RECORD_BATCH_MAX_BYTES as zn, emitReadiness as zr, DISPLAY_PREFERENCES as zt };

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;