@camstack/types 1.2.416 → 1.2.418

package/dist/capabilities/numeric-sensor.cap.d.ts

@@ -6,11 +6,9 @@ import { DeviceType } from '../device/device-type.js';
  * 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`,
@@ -19,9 +17,7 @@ import { DeviceType } from '../device/device-type.js';
  * numeric values land here.
  */
 export declare const NumericSensorStatusSchema: z.ZodObject<{
-    value: z.ZodNumber;
-    unit: z.ZodOptional<z.ZodString>;
-    precision: z.ZodOptional<z.ZodNumber>;
+    value: z.ZodNullable<z.ZodNumber>;
     lastFetchedAt: z.ZodNumber;
 }, z.core.$strip>;
 export type NumericSensorStatus = z.infer<typeof NumericSensorStatusSchema>;
@@ -34,17 +30,13 @@ export declare const numericSensorCapability: {
     readonly methods: {};
     readonly status: {
         readonly schema: z.ZodObject<{
-            value: z.ZodNumber;
-            unit: z.ZodOptional<z.ZodString>;
-            precision: z.ZodOptional<z.ZodNumber>;
+            value: z.ZodNullable<z.ZodNumber>;
             lastFetchedAt: z.ZodNumber;
         }, z.core.$strip>;
         readonly kind: 'push';
     };
     readonly runtimeState: z.ZodObject<{
-        value: z.ZodNumber;
-        unit: z.ZodOptional<z.ZodString>;
-        precision: z.ZodOptional<z.ZodNumber>;
+        value: z.ZodNullable<z.ZodNumber>;
         lastFetchedAt: z.ZodNumber;
     }, z.core.$strip>;
     /**
@@ -55,13 +47,13 @@ export declare const numericSensorCapability: {
      */
     readonly 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.
      */
     readonly history: {
         readonly fields: {
             readonly value: {
                 readonly kind: 'gauge';
-                readonly unitFrom: 'unit';
                 readonly minIntervalMs: 30000;
             };
         };

package/dist/capabilities/pet-feeder.cap.d.ts

@@ -209,7 +209,7 @@ export declare const petFeederCapability: {
             };
             readonly desiccantLeftDays: {
                 readonly kind: 'gauge';
-                readonly unit: 'days';
+                readonly unit: 's';
             };
         };
     };

package/dist/capabilities/power-meter.cap.d.ts

@@ -24,8 +24,6 @@ export declare const PowerMeterStatusSchema: z.ZodObject<{
     va: z.ZodOptional<z.ZodNumber>;
     powerFactor: z.ZodOptional<z.ZodNumber>;
     lastFetchedAt: z.ZodNumber;
-    unit: z.ZodOptional<z.ZodString>;
-    precision: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type PowerMeterStatus = z.infer<typeof PowerMeterStatusSchema>;
 export declare const powerMeterCapability: {
@@ -44,8 +42,6 @@ export declare const powerMeterCapability: {
             va: z.ZodOptional<z.ZodNumber>;
             powerFactor: z.ZodOptional<z.ZodNumber>;
             lastFetchedAt: z.ZodNumber;
-            unit: z.ZodOptional<z.ZodString>;
-            precision: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>;
         readonly kind: 'push';
     };
@@ -57,8 +53,6 @@ export declare const powerMeterCapability: {
         va: z.ZodOptional<z.ZodNumber>;
         powerFactor: z.ZodOptional<z.ZodNumber>;
         lastFetchedAt: z.ZodNumber;
-        unit: z.ZodOptional<z.ZodString>;
-        precision: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     /**
      * Runtime-state durability: **restored** — as `numeric-sensor`; `kwhTotal` is an accumulator whose restored value is the baseline.
@@ -113,10 +107,5 @@ export declare const powerMeterCapability: {
     /** Clock fields: written, but excluded from the compare that decides
      *  whether persisting is worth a SQLite commit. */
     readonly volatileStateFields: readonly ["lastFetchedAt"];
-    readonly customize: {
-        readonly version: 1;
-        readonly advanced: 'derive';
-        readonly targets: readonly [];
-    };
 };
 export type IPowerMeterProvider = InferProvider<typeof powerMeterCapability>;

package/dist/capabilities/pressure-sensor.cap.d.ts

@@ -10,10 +10,8 @@ import { DeviceType } from '../device/device-type.js';
  * `sourceInfo`.
  */
 export declare const PressureSensorStatusSchema: z.ZodObject<{
-    hpa: z.ZodNumber;
+    hpa: z.ZodNullable<z.ZodNumber>;
     lastFetchedAt: z.ZodNumber;
-    unit: z.ZodOptional<z.ZodString>;
-    precision: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type PressureSensorStatus = z.infer<typeof PressureSensorStatusSchema>;
 export declare const pressureSensorCapability: {
@@ -25,18 +23,14 @@ export declare const pressureSensorCapability: {
     readonly methods: {};
     readonly status: {
         readonly schema: z.ZodObject<{
-            hpa: z.ZodNumber;
+            hpa: z.ZodNullable<z.ZodNumber>;
             lastFetchedAt: z.ZodNumber;
-            unit: z.ZodOptional<z.ZodString>;
-            precision: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>;
         readonly kind: 'push';
     };
     readonly runtimeState: z.ZodObject<{
-        hpa: z.ZodNumber;
+        hpa: z.ZodNullable<z.ZodNumber>;
         lastFetchedAt: z.ZodNumber;
-        unit: z.ZodOptional<z.ZodString>;
-        precision: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     /**
      * Runtime-state durability: **restored** — as `numeric-sensor`.

package/dist/capabilities/running-state.cap.d.ts

@@ -74,7 +74,6 @@ export declare const runningStateCapability: {
     readonly volatileStateFields: readonly ["lastFetchedAt"];
     readonly customize: {
         readonly version: 1;
-        readonly advanced: 'derive';
         readonly targets: readonly [{
             readonly id: 'running';
             readonly cardinality: 'scalar';
@@ -83,7 +82,7 @@ export declare const runningStateCapability: {
                 readonly stateField: 'running';
             };
             readonly deviceTypes: readonly [DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer, DeviceType.WaterHeater, DeviceType.Humidifier, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.PetFeeder];
-            readonly apply: 'add-or-replace';
+            readonly apply: 'add';
             readonly path: 'running';
             readonly sources: readonly [{
                 readonly kind: 'switch';

package/dist/capabilities/runtime-field-unit.d.ts

@@ -0,0 +1 @@
+export declare function runtimeFieldUnit(cap: string, path: string): string | undefined;

package/dist/capabilities/runtime-field-units.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Unit meta on a runtime-state field (D941 convert-unit). Not an override list.
+ * The lookup of the generated map lives in `runtime-field-unit.ts` so codegen
+ * can import this walker without loading the file it is about to rewrite.
+ */
+import { z } from 'zod';
+/** Top-level runtime paths that declare a unit. */
+export declare function runtimeFieldUnits(schema: z.ZodType): Readonly<Record<string, string>>;

package/dist/capabilities/switch.cap.d.ts

@@ -82,10 +82,5 @@ export declare const switchCapability: {
             };
         }];
     };
-    readonly customize: {
-        readonly version: 1;
-        readonly advanced: 'derive';
-        readonly targets: readonly [];
-    };
 };
 export type ISwitchProvider = InferProvider<typeof switchCapability>;

package/dist/capabilities/temperature-sensor.cap.d.ts

@@ -6,22 +6,16 @@ import { DeviceType } from '../device/device-type.js';
  * 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.
  */
 export declare const TemperatureSensorStatusSchema: z.ZodObject<{
-    celsius: z.ZodNumber;
+    celsius: z.ZodNullable<z.ZodNumber>;
     lastFetchedAt: z.ZodNumber;
-    unit: z.ZodOptional<z.ZodString>;
-    precision: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type TemperatureSensorStatus = z.infer<typeof TemperatureSensorStatusSchema>;
 export declare const temperatureSensorCapability: {
@@ -33,18 +27,14 @@ export declare const temperatureSensorCapability: {
     readonly methods: {};
     readonly status: {
         readonly schema: z.ZodObject<{
-            celsius: z.ZodNumber;
+            celsius: z.ZodNullable<z.ZodNumber>;
             lastFetchedAt: z.ZodNumber;
-            unit: z.ZodOptional<z.ZodString>;
-            precision: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>;
         readonly kind: 'push';
     };
     readonly runtimeState: z.ZodObject<{
-        celsius: z.ZodNumber;
+        celsius: z.ZodNullable<z.ZodNumber>;
         lastFetchedAt: z.ZodNumber;
-        unit: z.ZodOptional<z.ZodString>;
-        precision: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     /**
      * Runtime-state durability: **restored** — as `numeric-sensor` (69 of 125 writes were the clock alone).
@@ -68,10 +58,5 @@ export declare const temperatureSensorCapability: {
     /** Clock fields: written, but excluded from the compare that decides
      *  whether persisting is worth a SQLite commit. */
     readonly volatileStateFields: readonly ["lastFetchedAt"];
-    readonly customize: {
-        readonly version: 1;
-        readonly advanced: 'derive';
-        readonly targets: readonly [];
-    };
 };
 export type ITemperatureSensorProvider = InferProvider<typeof temperatureSensorCapability>;

package/dist/capabilities/weather.cap.d.ts

@@ -23,12 +23,9 @@ import { DeviceType } from '../device/device-type.js';
 export declare const WeatherStatusSchema: z.ZodObject<{
     condition: z.ZodNullable<z.ZodString>;
     temperature: z.ZodNullable<z.ZodNumber>;
-    temperatureUnit: z.ZodNullable<z.ZodString>;
     humidity: z.ZodNullable<z.ZodNumber>;
     pressure: z.ZodNullable<z.ZodNumber>;
-    pressureUnit: z.ZodNullable<z.ZodString>;
     windSpeed: z.ZodNullable<z.ZodNumber>;
-    windSpeedUnit: z.ZodNullable<z.ZodString>;
     windBearing: z.ZodNullable<z.ZodNumber>;
     lastFetchedAt: z.ZodNumber;
 }, z.core.$strip>;
@@ -44,12 +41,9 @@ export declare const weatherCapability: {
         readonly schema: z.ZodObject<{
             condition: z.ZodNullable<z.ZodString>;
             temperature: z.ZodNullable<z.ZodNumber>;
-            temperatureUnit: z.ZodNullable<z.ZodString>;
             humidity: z.ZodNullable<z.ZodNumber>;
             pressure: z.ZodNullable<z.ZodNumber>;
-            pressureUnit: z.ZodNullable<z.ZodString>;
             windSpeed: z.ZodNullable<z.ZodNumber>;
-            windSpeedUnit: z.ZodNullable<z.ZodString>;
             windBearing: z.ZodNullable<z.ZodNumber>;
             lastFetchedAt: z.ZodNumber;
         }, z.core.$strip>;
@@ -62,12 +56,9 @@ export declare const weatherCapability: {
     readonly runtimeState: z.ZodObject<{
         condition: z.ZodNullable<z.ZodString>;
         temperature: z.ZodNullable<z.ZodNumber>;
-        temperatureUnit: z.ZodNullable<z.ZodString>;
         humidity: z.ZodNullable<z.ZodNumber>;
         pressure: z.ZodNullable<z.ZodNumber>;
-        pressureUnit: z.ZodNullable<z.ZodString>;
         windSpeed: z.ZodNullable<z.ZodNumber>;
-        windSpeedUnit: z.ZodNullable<z.ZodString>;
         windBearing: z.ZodNullable<z.ZodNumber>;
         lastFetchedAt: z.ZodNumber;
     }, z.core.$strip>;
@@ -79,13 +70,13 @@ export declare const weatherCapability: {
      */
     readonly durability: 'session';
     /**
-     * History (D850): recorded series. Units follow the sibling `*Unit` fields.
+     * History (D850): recorded series. Numbers are the quantity base (D944).
      */
     readonly history: {
         readonly fields: {
             readonly temperature: {
                 readonly kind: 'gauge';
-                readonly unitFrom: 'temperatureUnit';
+                readonly unit: '°C';
                 readonly deadband: 0.2;
             };
             readonly humidity: {
@@ -95,12 +86,12 @@ export declare const weatherCapability: {
             };
             readonly pressure: {
                 readonly kind: 'gauge';
-                readonly unitFrom: 'pressureUnit';
+                readonly unit: 'hPa';
                 readonly deadband: 0.5;
             };
             readonly windSpeed: {
                 readonly kind: 'gauge';
-                readonly unitFrom: 'windSpeedUnit';
+                readonly unit: 'm/s';
                 readonly deadband: 0.5;
             };
         };

package/dist/client.d.ts

@@ -14,4 +14,5 @@
  * value this entry does not export — a missing name here is `undefined` at
  * runtime, not a build error.
  */
-export { APPLE_SA_TO_MACRO, AUDIO_MACRO_LABELS, AlarmArmModeSchema, CLIP_BROKER_PACED_RATES, COCO_TO_MACRO, CamProfileSchema, ICON_CATEGORIES, ICON_ENTRIES, ICON_KEYS, ICON_VIEWER_MODULES, IconKeySchema, LOCATION_ICON_FALLBACK, DEFINITIVE_DEVICE_REFUSALS, DEVICE_CERT_RENEW_WINDOW_DAYS, DEVICE_DEFINITIVE_REFUSALS_BEFORE_DELETE, DEVICE_REFRESH_REFUSAL_PREFIX, DEVICE_CERT_SIGNATURE, DEVICE_SIGNATURE_MESSAGE_VERSION, DEFAULT_TIMELAPSE_PREVIEW_TEXT, DeviceType, EVENTFUL_CAP_NAMES, EVENT_KIND_BY_CAP, EVENT_TAXONOMY, MACRO_LABELS, NC_ALARM_DELAY_MAX_SEC, NC_ALARM_SENSORS_MAX, NC_ALARM_SYSTEM_EVENT_KINDS, NC_ALARM_TRIGGERED_MAX_SEC, NC_BATTERY_CONSUMABLE_SYSTEM_EVENT_KINDS, NC_CAMERA_SCOPE_CAP_NAME, NC_CONSUMABLE_LOW_PERCENT_DEFAULT, NC_CONSUMABLE_LOW_PERCENT_MAX, NC_GROUPING_DEFAULT_SEC, NC_GROUPING_MAX_SEC, NC_GROUPING_MIN_SEC, NC_RULE_EDITOR_SECTION_ORDER, NC_RULE_KIND_SPECS, NC_SENSOR_TRANSITION_UNSUPPORTED_REASON, NC_SYSTEM_EVENT_FAMILY_FILTERS, NC_SYSTEM_EVENT_CLASS_SPECS, NC_SYSTEM_EVENT_KIND_GROUP_SPECS, NC_SYSTEM_EVENT_SUMMARY_FAMILIES, NC_TEMPLATE_HELD_BACK_SYSTEM_EVENT_KINDS, NC_TEMPLATE_VARS, NcAlarmConfigSchema, NcAlarmSensorsSchema, NcAlarmSettingsPatchSchema, NcHistoryEntrySchema, NcRuleLastRunsSchema, NodeDirectorySchema, RECORDING_EXPORT_MAX_READ_BYTES, RETRAIN_REVIEW_ADJUSTED_IOU, RETRAIN_REVIEW_MATCH_IOU, RETRAIN_REVIEW_STATUSES, RETRAIN_REVISION_CONFLICT, SystemMirror, TIMELAPSE_DENSE_FLOOR_SEC, TimelapseRuleSchema, YAMNET_TO_MACRO, alarmDeviceBlocksArming, alarmDeviceSecureOnArm, alarmPatchLanded, canonicalIconKey, buildDeviceEnrollmentLink, buildDeviceSignatureMessage, deviceRefusalFromMessage, isDefinitiveDeviceRefusal, classifyRetrainReview, conditionVisibleForKind, createSystemProxy, droppedConditionsForKind, iconCategoryLabel, iconEntry, iconsInCategory, isIconKey, isHeldBackTemplateVar, isSystemRuleKind, kindsForDiscriminator, locationIconKey, knownValues, nodePickerItems, parseDeviceEnrollmentLink, packagePickerItems, pickerForCondition, pickerForRuleClasses, parseRetrainRevisionConflict, resolveIconKey, resolveModeDelays, retrainBoxIou, retrainRevisionConflictMessage, ruleDeviceCompatCapNames, ruleEditorSectionsForKind, ruleGroupingApplies, ruleKindOf, ruleKindSpec, ruleSeedForSection, searchIcons, sensorTransitionNeverFires, sensorTransitionOffered, stateLabel, summarizeReview, systemEventClassesFor, systemEventClassKinds, systemEventDeliveryProblems, systemEventFilterAppliesToAnyKind, systemEventKindsOfFamily, systemFamilyOfKind, templateCarriesSummary, templateVarDeliveryApplies, templateVarKindApplies, templateVarSystemEventApplies, buildSubjectPath, isDrawableSubjectPath, projectSubjectPath, subjectPathSampleFromBox, subjectPathSvgPoints, expandSystemEventClasses, withSystemEventClasses, } from './index.js';
+export { APPLE_SA_TO_MACRO, AUDIO_MACRO_LABELS, AlarmArmModeSchema, CLIP_BROKER_PACED_RATES, COCO_TO_MACRO, CamProfileSchema, ICON_CATEGORIES, ICON_ENTRIES, ICON_KEYS, ICON_VIEWER_MODULES, IconKeySchema, LOCATION_ICON_FALLBACK, DEFINITIVE_DEVICE_REFUSALS, DEVICE_CERT_RENEW_WINDOW_DAYS, DEVICE_DEFINITIVE_REFUSALS_BEFORE_DELETE, DEVICE_REFRESH_REFUSAL_PREFIX, DEVICE_CERT_SIGNATURE, DEVICE_SIGNATURE_MESSAGE_VERSION, DEFAULT_TIMELAPSE_PREVIEW_TEXT, DeviceType, EVENTFUL_CAP_NAMES, EVENT_KIND_BY_CAP, EVENT_TAXONOMY, MACRO_LABELS, NC_ALARM_DELAY_MAX_SEC, NC_ALARM_SENSORS_MAX, NC_ALARM_SYSTEM_EVENT_KINDS, NC_ALARM_TRIGGERED_MAX_SEC, NC_BATTERY_CONSUMABLE_SYSTEM_EVENT_KINDS, NC_CAMERA_SCOPE_CAP_NAME, NC_CONSUMABLE_LOW_PERCENT_DEFAULT, NC_CONSUMABLE_LOW_PERCENT_MAX, NC_GROUPING_DEFAULT_SEC, NC_GROUPING_MAX_SEC, NC_GROUPING_MIN_SEC, NC_RULE_EDITOR_SECTION_ORDER, NC_RULE_KIND_SPECS, NC_SENSOR_TRANSITION_UNSUPPORTED_REASON, NC_SYSTEM_EVENT_FAMILY_FILTERS, NC_SYSTEM_EVENT_CLASS_SPECS, NC_SYSTEM_EVENT_KIND_GROUP_SPECS, NC_SYSTEM_EVENT_SUMMARY_FAMILIES, NC_TEMPLATE_HELD_BACK_SYSTEM_EVENT_KINDS, NC_TEMPLATE_VARS, NcAlarmConfigSchema, NcAlarmSensorsSchema, NcAlarmSettingsPatchSchema, NcHistoryEntrySchema, NcRuleLastRunsSchema, NodeDirectorySchema, RECORDING_EXPORT_MAX_READ_BYTES, RETRAIN_REVIEW_ADJUSTED_IOU, RETRAIN_REVIEW_MATCH_IOU, RETRAIN_REVIEW_STATUSES, RETRAIN_REVISION_CONFLICT, SystemMirror, TIMELAPSE_DENSE_FLOOR_SEC, TimelapseRuleSchema, YAMNET_TO_MACRO, alarmDeviceBlocksArming, alarmDeviceSecureOnArm, alarmPatchLanded, canonicalIconKey, buildDeviceEnrollmentLink, buildDeviceSignatureMessage, deviceRefusalFromMessage, isDefinitiveDeviceRefusal, classifyRetrainReview, conditionVisibleForKind, createSystemProxy, droppedConditionsForKind, iconCategoryLabel, iconEntry, iconsInCategory, isIconKey, isHeldBackTemplateVar, isSystemRuleKind, kindsForDiscriminator, locationIconKey, knownValues, nodePickerItems, parseDeviceEnrollmentLink, packagePickerItems, pickerForCondition, pickerForRuleClasses, parseRetrainRevisionConflict, resolveIconKey, resolveModeDelays, retrainBoxIou, retrainRevisionConflictMessage, ruleDeviceCompatCapNames, ruleEditorSectionsForKind, ruleGroupingApplies, ruleKindOf, ruleKindSpec, ruleSeedForSection, searchIcons, sensorTransitionNeverFires, sensorTransitionOffered, stateLabel, summarizeReview, systemEventClassesFor, systemEventClassKinds, systemEventDeliveryProblems, systemEventFilterAppliesToAnyKind, systemEventKindsOfFamily, systemFamilyOfKind, templateCarriesSummary, templateVarDeliveryApplies, templateVarKindApplies, templateVarSystemEventApplies, buildSubjectPath, isDrawableSubjectPath, projectSubjectPath, subjectPathSampleFromBox, subjectPathSvgPoints, expandSystemEventClasses, withSystemEventClasses, bundledCamstack, paintHex, paletteResultSchema, } from './index.js';
+export type { PaletteReady, PaletteResult, PaletteEntryId, PalettePresetId } from './index.js';

package/dist/client.js

@@ -306,6 +306,52 @@ function parseRetrainRevisionConflict(message) {
 		expectedRevision: Number(match[2])
 	};
 }
+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"
+];
+zod.z.enum(READING_QUANTITIES);
+new Set(READING_QUANTITIES);
+function readingMeta(quantity, extras) {
+	return {
+		quantity,
+		...extras?.precision !== void 0 ? { precision: extras.precision } : {},
+		...extras?.label !== void 0 ? { label: extras.label } : {}
+	};
+}
 //#endregion
 //#region src/capabilities/schemas/streaming-shared.ts
 /** Shared Zod schemas used across streaming capabilities. */
@@ -325,8 +371,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"))
 });
 zod.z.object({
 	/** Stable, provider-assigned id unique within the (deviceId) scope. */
@@ -22171,7 +22217,7 @@ var paletteUnknownSchema = zod.z.object({
 	status: zod.z.literal("unknown"),
 	reason: zod.z.string()
 });
-zod.z.discriminatedUnion("status", [paletteReadySchema, paletteUnknownSchema]);
+var paletteResultSchema = zod.z.discriminatedUnion("status", [paletteReadySchema, paletteUnknownSchema]);
 zod.z.union([zod.z.object({ presetId: zod.z.string() }), zod.z.object({
 	presetId: zod.z.string(),
 	overrides: zod.z.record(zod.z.string(), paletteSwatchSchema)
@@ -22518,8 +22564,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(readingMeta("none")),
+	gridHeight: zod.z.number().meta(readingMeta("none")),
 	cells: zod.z.array(zod.z.boolean())
 });
 /** Directed line / tripwire — an ordered list of normalized points (≥2). */
@@ -26622,6 +26668,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),
@@ -27176,6 +27223,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"),
@@ -27259,6 +27307,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 } : {},
@@ -32225,6 +32274,7 @@ exports.alarmPatchLanded = alarmPatchLanded;
 exports.buildDeviceEnrollmentLink = buildDeviceEnrollmentLink;
 exports.buildDeviceSignatureMessage = buildDeviceSignatureMessage;
 exports.buildSubjectPath = buildSubjectPath;
+exports.bundledCamstack = bundledCamstack;
 exports.canonicalIconKey = canonicalIconKey;
 exports.classifyRetrainReview = classifyRetrainReview;
 exports.conditionVisibleForKind = conditionVisibleForKind;
@@ -32245,6 +32295,8 @@ exports.knownValues = knownValues;
 exports.locationIconKey = locationIconKey;
 exports.nodePickerItems = nodePickerItems;
 exports.packagePickerItems = packagePickerItems;
+exports.paintHex = paintHex;
+exports.paletteResultSchema = paletteResultSchema;
 exports.parseDeviceEnrollmentLink = parseDeviceEnrollmentLink;
 exports.parseRetrainRevisionConflict = parseRetrainRevisionConflict;
 exports.pickerForCondition = pickerForCondition;

package/dist/client.mjs

@@ -305,6 +305,52 @@ function parseRetrainRevisionConflict(message) {
 		expectedRevision: Number(match[2])
 	};
 }
+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"
+];
+z.enum(READING_QUANTITIES);
+new Set(READING_QUANTITIES);
+function readingMeta(quantity, extras) {
+	return {
+		quantity,
+		...extras?.precision !== void 0 ? { precision: extras.precision } : {},
+		...extras?.label !== void 0 ? { label: extras.label } : {}
+	};
+}
 //#endregion
 //#region src/capabilities/schemas/streaming-shared.ts
 /** Shared Zod schemas used across streaming capabilities. */
@@ -324,8 +370,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"))
 });
 z.object({
 	/** Stable, provider-assigned id unique within the (deviceId) scope. */
@@ -22170,7 +22216,7 @@ var paletteUnknownSchema = z.object({
 	status: z.literal("unknown"),
 	reason: z.string()
 });
-z.discriminatedUnion("status", [paletteReadySchema, paletteUnknownSchema]);
+var paletteResultSchema = z.discriminatedUnion("status", [paletteReadySchema, paletteUnknownSchema]);
 z.union([z.object({ presetId: z.string() }), z.object({
 	presetId: z.string(),
 	overrides: z.record(z.string(), paletteSwatchSchema)
@@ -22517,8 +22563,8 @@ var MaskPolygonShapeSchema = z.object({
 /** Boolean cell grid — row-major, length === gridWidth*gridHeight. */
 var MaskGridShapeSchema = z.object({
 	kind: z.literal("grid"),
-	gridWidth: z.number(),
-	gridHeight: z.number(),
+	gridWidth: z.number().meta(readingMeta("none")),
+	gridHeight: z.number().meta(readingMeta("none")),
 	cells: z.array(z.boolean())
 });
 /** Directed line / tripwire — an ordered list of normalized points (≥2). */
@@ -26621,6 +26667,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),
@@ -27175,6 +27222,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"),
@@ -27258,6 +27306,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 } : {},
@@ -32159,4 +32208,4 @@ var TimelapseRuleSchema = TimelapseRuleInputSchema.extend({
 	updatedAt: z.number()
 });
 //#endregion
-export { APPLE_SA_TO_MACRO, AUDIO_MACRO_LABELS, AlarmArmModeSchema, CLIP_BROKER_PACED_RATES, COCO_TO_MACRO, CamProfileSchema, DEFAULT_TIMELAPSE_PREVIEW_TEXT, DEFINITIVE_DEVICE_REFUSALS, DEVICE_CERT_RENEW_WINDOW_DAYS, DEVICE_CERT_SIGNATURE, DEVICE_DEFINITIVE_REFUSALS_BEFORE_DELETE, DEVICE_REFRESH_REFUSAL_PREFIX, DEVICE_SIGNATURE_MESSAGE_VERSION, DeviceType, EVENTFUL_CAP_NAMES, EVENT_KIND_BY_CAP, EVENT_TAXONOMY, ICON_CATEGORIES, ICON_ENTRIES, ICON_KEYS, ICON_VIEWER_MODULES, IconKeySchema, LOCATION_ICON_FALLBACK, MACRO_LABELS, NC_ALARM_DELAY_MAX_SEC, NC_ALARM_SENSORS_MAX, NC_ALARM_SYSTEM_EVENT_KINDS, NC_ALARM_TRIGGERED_MAX_SEC, NC_BATTERY_CONSUMABLE_SYSTEM_EVENT_KINDS, NC_CAMERA_SCOPE_CAP_NAME, NC_CONSUMABLE_LOW_PERCENT_DEFAULT, NC_CONSUMABLE_LOW_PERCENT_MAX, NC_GROUPING_DEFAULT_SEC, NC_GROUPING_MAX_SEC, NC_GROUPING_MIN_SEC, NC_RULE_EDITOR_SECTION_ORDER, NC_RULE_KIND_SPECS, NC_SENSOR_TRANSITION_UNSUPPORTED_REASON, NC_SYSTEM_EVENT_CLASS_SPECS, NC_SYSTEM_EVENT_FAMILY_FILTERS, NC_SYSTEM_EVENT_KIND_GROUP_SPECS, NC_SYSTEM_EVENT_SUMMARY_FAMILIES, NC_TEMPLATE_HELD_BACK_SYSTEM_EVENT_KINDS, NC_TEMPLATE_VARS, NcAlarmConfigSchema, NcAlarmSensorsSchema, NcAlarmSettingsPatchSchema, NcHistoryEntrySchema, NcRuleLastRunsSchema, NodeDirectorySchema, RECORDING_EXPORT_MAX_READ_BYTES, RETRAIN_REVIEW_ADJUSTED_IOU, RETRAIN_REVIEW_MATCH_IOU, RETRAIN_REVIEW_STATUSES, RETRAIN_REVISION_CONFLICT, SystemMirror, TIMELAPSE_DENSE_FLOOR_SEC, TimelapseRuleSchema, YAMNET_TO_MACRO, alarmDeviceBlocksArming, alarmDeviceSecureOnArm, alarmPatchLanded, buildDeviceEnrollmentLink, buildDeviceSignatureMessage, buildSubjectPath, canonicalIconKey, classifyRetrainReview, conditionVisibleForKind, createSystemProxy, deviceRefusalFromMessage, droppedConditionsForKind, expandSystemEventClasses, iconCategoryLabel, iconEntry, iconsInCategory, isDefinitiveDeviceRefusal, isDrawableSubjectPath, isHeldBackTemplateVar, isIconKey, isSystemRuleKind, kindsForDiscriminator, knownValues, locationIconKey, nodePickerItems, packagePickerItems, parseDeviceEnrollmentLink, parseRetrainRevisionConflict, pickerForCondition, pickerForRuleClasses, projectSubjectPath, resolveIconKey, resolveModeDelays, retrainBoxIou, retrainRevisionConflictMessage, ruleDeviceCompatCapNames, ruleEditorSectionsForKind, ruleGroupingApplies, ruleKindOf, ruleKindSpec, ruleSeedForSection, searchIcons, sensorTransitionNeverFires, sensorTransitionOffered, stateLabel, subjectPathSampleFromBox, subjectPathSvgPoints, summarizeReview, systemEventClassKinds, systemEventClassesFor, systemEventDeliveryProblems, systemEventFilterAppliesToAnyKind, systemEventKindsOfFamily, systemFamilyOfKind, templateCarriesSummary, templateVarDeliveryApplies, templateVarKindApplies, templateVarSystemEventApplies, withSystemEventClasses };
+export { APPLE_SA_TO_MACRO, AUDIO_MACRO_LABELS, AlarmArmModeSchema, CLIP_BROKER_PACED_RATES, COCO_TO_MACRO, CamProfileSchema, DEFAULT_TIMELAPSE_PREVIEW_TEXT, DEFINITIVE_DEVICE_REFUSALS, DEVICE_CERT_RENEW_WINDOW_DAYS, DEVICE_CERT_SIGNATURE, DEVICE_DEFINITIVE_REFUSALS_BEFORE_DELETE, DEVICE_REFRESH_REFUSAL_PREFIX, DEVICE_SIGNATURE_MESSAGE_VERSION, DeviceType, EVENTFUL_CAP_NAMES, EVENT_KIND_BY_CAP, EVENT_TAXONOMY, ICON_CATEGORIES, ICON_ENTRIES, ICON_KEYS, ICON_VIEWER_MODULES, IconKeySchema, LOCATION_ICON_FALLBACK, MACRO_LABELS, NC_ALARM_DELAY_MAX_SEC, NC_ALARM_SENSORS_MAX, NC_ALARM_SYSTEM_EVENT_KINDS, NC_ALARM_TRIGGERED_MAX_SEC, NC_BATTERY_CONSUMABLE_SYSTEM_EVENT_KINDS, NC_CAMERA_SCOPE_CAP_NAME, NC_CONSUMABLE_LOW_PERCENT_DEFAULT, NC_CONSUMABLE_LOW_PERCENT_MAX, NC_GROUPING_DEFAULT_SEC, NC_GROUPING_MAX_SEC, NC_GROUPING_MIN_SEC, NC_RULE_EDITOR_SECTION_ORDER, NC_RULE_KIND_SPECS, NC_SENSOR_TRANSITION_UNSUPPORTED_REASON, NC_SYSTEM_EVENT_CLASS_SPECS, NC_SYSTEM_EVENT_FAMILY_FILTERS, NC_SYSTEM_EVENT_KIND_GROUP_SPECS, NC_SYSTEM_EVENT_SUMMARY_FAMILIES, NC_TEMPLATE_HELD_BACK_SYSTEM_EVENT_KINDS, NC_TEMPLATE_VARS, NcAlarmConfigSchema, NcAlarmSensorsSchema, NcAlarmSettingsPatchSchema, NcHistoryEntrySchema, NcRuleLastRunsSchema, NodeDirectorySchema, RECORDING_EXPORT_MAX_READ_BYTES, RETRAIN_REVIEW_ADJUSTED_IOU, RETRAIN_REVIEW_MATCH_IOU, RETRAIN_REVIEW_STATUSES, RETRAIN_REVISION_CONFLICT, SystemMirror, TIMELAPSE_DENSE_FLOOR_SEC, TimelapseRuleSchema, YAMNET_TO_MACRO, alarmDeviceBlocksArming, alarmDeviceSecureOnArm, alarmPatchLanded, buildDeviceEnrollmentLink, buildDeviceSignatureMessage, buildSubjectPath, bundledCamstack, canonicalIconKey, classifyRetrainReview, conditionVisibleForKind, createSystemProxy, deviceRefusalFromMessage, droppedConditionsForKind, expandSystemEventClasses, iconCategoryLabel, iconEntry, iconsInCategory, isDefinitiveDeviceRefusal, isDrawableSubjectPath, isHeldBackTemplateVar, isIconKey, isSystemRuleKind, kindsForDiscriminator, knownValues, locationIconKey, nodePickerItems, packagePickerItems, paintHex, paletteResultSchema, parseDeviceEnrollmentLink, parseRetrainRevisionConflict, pickerForCondition, pickerForRuleClasses, projectSubjectPath, resolveIconKey, resolveModeDelays, retrainBoxIou, retrainRevisionConflictMessage, ruleDeviceCompatCapNames, ruleEditorSectionsForKind, ruleGroupingApplies, ruleKindOf, ruleKindSpec, ruleSeedForSection, searchIcons, sensorTransitionNeverFires, sensorTransitionOffered, stateLabel, subjectPathSampleFromBox, subjectPathSvgPoints, summarizeReview, systemEventClassKinds, systemEventClassesFor, systemEventDeliveryProblems, systemEventFilterAppliesToAnyKind, systemEventKindsOfFamily, systemFamilyOfKind, templateCarriesSummary, templateVarDeliveryApplies, templateVarKindApplies, templateVarSystemEventApplies, withSystemEventClasses };