@camstack/types 1.2.416 → 1.2.417

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). */
@@ -32225,6 +32271,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 +32292,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). */
@@ -32159,4 +32205,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 };

package/dist/composition/composition-report.d.ts

@@ -12,6 +12,7 @@ export declare const CompositionProblemCodeSchema: z.ZodEnum<{
     "kind-mismatch": "kind-mismatch";
     "may-be-null": "may-be-null";
     "missing-field": "missing-field";
+    "native-capability-replace": "native-capability-replace";
     "nested-field": "nested-field";
     "not-composable": "not-composable";
     "not-item-array": "not-item-array";
@@ -39,6 +40,7 @@ export declare const CompositionProblemSchema: z.ZodObject<{
         "kind-mismatch": "kind-mismatch";
         "may-be-null": "may-be-null";
         "missing-field": "missing-field";
+        "native-capability-replace": "native-capability-replace";
         "nested-field": "nested-field";
         "not-composable": "not-composable";
         "not-item-array": "not-item-array";
@@ -166,9 +168,11 @@ export type CompositionFieldPlan = z.infer<typeof CompositionFieldPlanSchema>;
 /** The key every record map, log line and graph node uses for a planned field. Two items' `status` are two keys. */
 export declare function compositionFieldKey(plan: Pick<CompositionFieldPlan, 'cap' | 'path' | 'item'>): string;
 /**
- * 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.
  */
 export declare const CompositionFeatureModeSchema: z.ZodEnum<{
     add: "add";
@@ -198,6 +202,7 @@ export declare const CompositionValidationSchema: z.ZodObject<{
             "kind-mismatch": "kind-mismatch";
             "may-be-null": "may-be-null";
             "missing-field": "missing-field";
+            "native-capability-replace": "native-capability-replace";
             "nested-field": "nested-field";
             "not-composable": "not-composable";
             "not-item-array": "not-item-array";

package/dist/composition/state-fields.d.ts

@@ -20,6 +20,6 @@ export declare function requiredTopLevelKeys(schema: z.ZodType): readonly string
 /**
  * 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).
  */
 export declare function optionalAncestors(schema: z.ZodType, path: string): readonly string[];

package/dist/composition/validate-composition.d.ts

@@ -67,8 +67,9 @@ export type { CompositionPlanResult } from './plan-result.js';
 export declare const PENDING_BLOCK_ID = "(unsaved)";
 /**
  * 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.
  */
 export declare function planComposition(composition: Composition, lookupCap: CapabilityLookup, target?: CompositionTargetDescription): CompositionPlanResult;
 export declare function compositionSourceRefs(composition: Composition): readonly CompositionSourceRef[];

package/dist/device/cap-vocabulary/types.d.ts

@@ -179,9 +179,9 @@ export interface NumericStateTrigger<C extends VocabCapName> {
     /** The quantity WITH its article, as it reads in a sentence ("the temperature" / "la temperatura"). */
     readonly quantity: L10n;
     readonly label: L10n;
-    /** Display unit; omit when the device states it (see `unitField`). */
+    /** Display unit. The stored number is the quantity base; this is the label. */
     readonly unit?: string;
-    /** A status field carrying the device's own unit (`numeric-sensor.unit`). */
+    /** @deprecated D944 removed slice unit siblings. Kept so old rows still parse. */
     readonly unitField?: CapStatusField<C>;
     readonly icon: VocabIcon;
 }

package/dist/device/schema-fields.d.ts

@@ -1,8 +1,11 @@
 import { z } from 'zod';
+import { type ReadingQuantity } from '../units/quantity.js';
 export interface WireableField {
     readonly path: string;
     readonly kind: 'string' | 'number' | 'boolean' | 'enum';
     readonly enumValues?: readonly string[];
+    /** Quantity of a numeric reading, when the schema declares one. */
+    readonly quantity?: ReadingQuantity;
     /** True when `path` is relative to ONE item of an item-array cap (see
      *  `CapabilityStatusItemArray`) — a link targeting it must carry a
      *  `target.itemKey`. Absent/false for plain status fields. */

package/dist/device/source-info.d.ts

@@ -17,12 +17,12 @@ import { z } from 'zod';
  *      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`
@@ -32,6 +32,12 @@ export declare const SourceInfoSchema: z.ZodObject<{
     id: z.ZodString;
     system: z.ZodString;
     uniqueId: z.ZodOptional<z.ZodString>;
+    quantity: z.ZodOptional<z.ZodType<"angle" | "apparent-power" | "area" | "bitrate" | "colour-temperature" | "concentration-mass" | "concentration-ppb" | "concentration-volume" | "count" | "current" | "device" | "duration" | "duration-ms" | "energy" | "humidity" | "illuminance" | "index" | "information" | "irradiance" | "length" | "mass" | "none" | "percentage" | "power" | "precipitation" | "precipitation-rate" | "pressure" | "rate" | "ratio" | "signal-level" | "sound-level" | "speed" | "temperature" | "voltage" | "volume", unknown, z.core.$ZodTypeInternals<"angle" | "apparent-power" | "area" | "bitrate" | "colour-temperature" | "concentration-mass" | "concentration-ppb" | "concentration-volume" | "count" | "current" | "device" | "duration" | "duration-ms" | "energy" | "humidity" | "illuminance" | "index" | "information" | "irradiance" | "length" | "mass" | "none" | "percentage" | "power" | "precipitation" | "precipitation-rate" | "pressure" | "rate" | "ratio" | "signal-level" | "sound-level" | "speed" | "temperature" | "voltage" | "volume", unknown>>>;
+    dateTimeShape: z.ZodOptional<z.ZodEnum<{
+        date: "date";
+        datetime: "datetime";
+        time: "time";
+    }>>;
     raw: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
 export type SourceInfo = z.infer<typeof SourceInfoSchema>;

package/dist/generated/addon-cap-facts.d.ts

@@ -5,7 +5,7 @@
  * `ALL_CAPABILITY_DEFINITIONS` (the whole Zod schema graph, ~+100 MB heap per
  * runner). See docs/decisions/adr-0028.md.
  *
- * Coverage: 1 advance-derived caps, 74 caps with 367 state leaves.
+ * Coverage: 1 advance-derived caps, 74 caps with 348 state leaves.
  */
 /** A bindable scalar in a capability's runtime state. */
 export interface CapStateLeaf {

package/dist/generated/customize-catalog.d.ts

@@ -1,26 +1,16 @@
 import { DeviceType } from '../device/device-type.js';
 /**
  * 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.
  */
 export declare const CAP_CUSTOMIZE_CATALOG: {
-    readonly 'ambient-light-sensor': {
-        readonly version: 1;
-        readonly targets: readonly [];
-        readonly advancedParameters: readonly [{
-            readonly path: 'lux';
-            readonly kind: 'number';
-            readonly label: 'Illuminance';
-            readonly unit: 'lx';
-        }];
-    };
     readonly battery: {
         readonly version: 1;
         readonly targets: readonly [{
             readonly id: 'percentage';
             readonly cardinality: 'scalar';
             readonly deviceTypes: readonly [DeviceType.Camera, DeviceType.Sensor, DeviceType.Button, DeviceType.Switch, DeviceType.PetFeeder, DeviceType.Container, DeviceType.Thermostat];
-            readonly apply: 'add-or-replace';
+            readonly apply: 'add';
             readonly vocabularyCap: 'battery';
             readonly vocabularyStateField: 'percentage';
             readonly sources: readonly [{
@@ -60,29 +50,6 @@ export declare const CAP_CUSTOMIZE_CATALOG: {
                 readonly when: 'add';
             }];
         }];
-        readonly advancedParameters: readonly [{
-            readonly path: 'binary';
-            readonly kind: 'boolean';
-            readonly label: 'Binary indicator';
-        }, {
-            readonly path: 'charging';
-            readonly kind: 'enum';
-            readonly label: 'Charging source';
-            readonly enumValues: readonly ["dc", "solar", "none", "unknown"];
-        }, {
-            readonly path: 'sleeping';
-            readonly kind: 'boolean';
-            readonly label: 'Sleeping';
-        }];
-    };
-    readonly binary: {
-        readonly version: 1;
-        readonly targets: readonly [];
-        readonly advancedParameters: readonly [{
-            readonly path: 'on';
-            readonly kind: 'boolean';
-            readonly label: 'On';
-        }];
     };
     readonly consumables: {
         readonly version: 1;
@@ -130,8 +97,8 @@ export declare const CAP_CUSTOMIZE_CATALOG: {
                     }];
                 }];
                 readonly literals: readonly [{
-                    readonly path: 'remaining.unit';
-                    readonly values: readonly ["days", "hours", "cycles"];
+                    readonly path: 'remaining.kind';
+                    readonly values: readonly ["duration", "count"];
                 }];
             }, {
                 readonly path: 'status';
@@ -167,7 +134,6 @@ export declare const CAP_CUSTOMIZE_CATALOG: {
                 readonly when: 'add';
             }];
         }];
-        readonly advancedParameters: readonly [];
     };
     readonly doorbell: {
         readonly version: 1;
@@ -204,17 +170,6 @@ export declare const CAP_CUSTOMIZE_CATALOG: {
             readonly highWater: 'composer-advance';
             readonly debounceMs: 2000;
         }];
-        readonly advancedParameters: readonly [];
-    };
-    readonly 'humidity-sensor': {
-        readonly version: 1;
-        readonly targets: readonly [];
-        readonly advancedParameters: readonly [{
-            readonly path: 'percent';
-            readonly kind: 'number';
-            readonly label: 'Humidity';
-            readonly unit: '%';
-        }];
     };
     readonly motion: {
         readonly version: 1;
@@ -222,7 +177,7 @@ export declare const CAP_CUSTOMIZE_CATALOG: {
             readonly id: 'detected';
             readonly cardinality: 'event';
             readonly deviceTypes: readonly [DeviceType.Camera];
-            readonly apply: 'replace';
+            readonly apply: 'add';
             readonly vocabularyCap: 'motion';
             readonly vocabularyEvent: 'onMotionChanged';
             readonly sources: readonly [{
@@ -250,22 +205,6 @@ export declare const CAP_CUSTOMIZE_CATALOG: {
             readonly timeoutMs: 30000;
             readonly sourceModes: readonly ["in-addition", "confirm", "replace"];
         }];
-        readonly advancedParameters: readonly [];
-    };
-    readonly 'power-meter': {
-        readonly version: 1;
-        readonly targets: readonly [];
-        readonly advancedParameters: readonly [{
-            readonly path: 'kwhTotal';
-            readonly kind: 'number';
-            readonly label: 'Energy';
-            readonly unit: 'kWh';
-        }, {
-            readonly path: 'watts';
-            readonly kind: 'number';
-            readonly label: 'Power';
-            readonly unit: 'W';
-        }];
     };
     readonly 'running-state': {
         readonly version: 1;
@@ -273,7 +212,7 @@ export declare const CAP_CUSTOMIZE_CATALOG: {
             readonly id: 'running';
             readonly cardinality: 'scalar';
             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 vocabularyCap: 'running-state';
             readonly vocabularyStateField: 'running';
             readonly sources: readonly [{
@@ -334,25 +273,10 @@ export declare const CAP_CUSTOMIZE_CATALOG: {
                 readonly sourceChangedAt: 'prefer';
             }];
         }];
-        readonly advancedParameters: readonly [];
-    };
-    readonly switch: {
-        readonly version: 1;
-        readonly targets: readonly [];
-        readonly advancedParameters: readonly [{
-            readonly path: 'on';
-            readonly kind: 'boolean';
-            readonly label: 'On';
-        }];
-    };
-    readonly 'temperature-sensor': {
-        readonly version: 1;
-        readonly targets: readonly [];
-        readonly advancedParameters: readonly [{
-            readonly path: 'celsius';
-            readonly kind: 'number';
-            readonly label: 'Temperature';
-            readonly unit: '°C';
-        }];
     };
 };
+/**
+ * Unit meta on runtime-state fields. The composed-device row reads this;
+ * it is not an override list (D944).
+ */
+export declare const CAP_RUNTIME_FIELD_UNITS: Readonly<Record<string, Readonly<Record<string, string>>>>;

package/dist/generated/history-catalog.d.ts

@@ -1,7 +1,7 @@
 import type { CapabilityHistoryField, CapabilityHistoryItems } from '../capabilities/capability-definition.js';
 /**
  * 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).
  */
 export declare const HISTORY_CATALOG: Readonly<Record<string, Readonly<Record<string, CapabilityHistoryField>>>>;