@camstack/types 1.2.419 → 1.2.421

package/dist/client.js

@@ -699,8 +699,14 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
 	DeviceType["PetFeeder"] = "pet-feeder";
 	/** Built-in dishwasher — program lifecycle, door / remote-start gates,
 	*  salt and rinse-aid levels. Installed with the `dishwasher` cap.
-	*  Sources: native Bosch Home Connect, reusable by similar integrations. */
+	*  Sources: native Bosch Home Connect, reusable by similar integrations.
+	*  A plug-built dishwasher carries running-state and power instead. */
 	DeviceType["Dishwasher"] = "dishwasher";
+	/** Washing machine. A plug-built one is running while its power stays
+	*  above a threshold. No program cap — that surface is the dishwasher's. */
+	DeviceType["Washer"] = "washer";
+	/** Tumble dryer. Same plug-built running surface as {@link Washer}. */
+	DeviceType["Dryer"] = "dryer";
 	return DeviceType;
 }({});
 zod.z.enum(["new-session", "step-up"]);
@@ -26236,6 +26242,164 @@ method(zod.z.object({
 	auth: "protected"
 });
 //#endregion
+//#region src/device/container-primary-child.ts
+/**
+* WHICH child a container stands for — one definition, for every consumer.
+*
+* A CONTAINER device has no controllable surface of its own: it groups entity
+* children (a Gree air-conditioner grouping a climate child plus light, x-fan
+* and health switches). Everything that has to show or act on a container has
+* to answer the same question — which child IS the container — and until now
+* three places answered it separately:
+*
+*   - `ui-library/device-controls/primary-child.ts`   (admin-ui rendering)
+*   - `addon-provider-homeassistant` PARENT_TYPE_PRIORITY (adoption)
+*   - the viewer's own `container-primary.ts`         (linked-devices panel)
+*
+* Each carried the same list and a comment asking the others to stay in sync.
+* This is that list, in the one package all of them already depend on.
+*
+* `ui-library` and the server's linked-devices expansion IMPORT it. Two
+* consumers cannot, and keep a checked copy instead: the viewer resolves
+* `@camstack/types` from its own `node_modules` (an installed release, where a
+* newly added export simply is not there), and the Home Assistant provider
+* expresses the same precedence over the `DeviceType` enum because it answers
+* a different question from the same ordering. `scripts/check-container-
+* priority-in-sync.ts` fails the build when either drifts — the comment that
+* used to ask for this could not.
+*
+* The rule has two halves and the ORDER matters: an operator's explicit pick
+* wins outright, and only in its absence does type priority decide. The pick is
+* keyed on the child's re-sync-stable `entityId`, not its numeric id, so it
+* survives a re-sync that reallocates ids.
+*/
+/**
+* Type priority, most→least "primary". An actuator (climate / lock / cover / …)
+* outranks a bare `switch` so a container's defining child wins over its
+* auxiliary switches. Unknown or absent types sort after every entry.
+*
+* NB: `siren` deliberately sits BELOW `switch` — it is a switch-family
+* actuator, and a camera's siren must not out-rank the thing the container is.
+*
+* These strings are matched against a child's `DeviceType` VALUE, so they must
+* equal the enum's string values.
+*/
+var CONTAINER_CHILD_PRIORITY = [
+	"media-player",
+	"alarm-panel",
+	"thermostat",
+	"climate",
+	"humidifier",
+	"water-heater",
+	"lock",
+	"cover",
+	"valve",
+	"fan",
+	"vacuum",
+	"lawn-mower",
+	"washer",
+	"dryer",
+	"dishwasher",
+	"light",
+	"switch",
+	"siren",
+	"button",
+	"control",
+	"notifier",
+	"script",
+	"automation",
+	"update",
+	"presence",
+	"weather",
+	"image",
+	"sensor"
+];
+/**
+* Roles that say what a container IS, most→least defining. Consulted BEFORE
+* type priority, because `DeviceType` cannot tell them apart: Home Assistant
+* maps a door contact, a battery level, a temperature reading and a "last seen"
+* timestamp all to `DeviceType.Sensor`. Measured on container 4127 — children
+* `battery-sensor`, `temperature-sensor`, `datetime-sensor`, `contact-sensor`
+* and a role-less `button` — the type list ranked `button` above `sensor` and
+* the container stood for its "Identifica" button instead of the door contact
+* it is named after.
+*
+* Only STATE-DEFINING roles belong here. A diagnostic reading (battery,
+* temperature, humidity, signal, last-seen) is never what a container is, so
+* they are deliberately absent and fall through to type priority.
+*/
+var CONTAINER_CHILD_ROLE_PRIORITY = [
+	"contact-sensor",
+	"motion-sensor",
+	"occupancy-sensor",
+	"smoke-sensor",
+	"co-sensor",
+	"gas-sensor",
+	"leak-sensor",
+	"vibration-sensor",
+	"tamper-sensor",
+	"sound-sensor"
+];
+/**
+* NOT in the list, deliberately: `binary-sensor` and `binary-helper`. They are
+* GENERIC — they say "this reports a boolean", not what the container is — and
+* ranking them above type priority is a live regression, not a hypothetical:
+* container 1837 holds a real `lock` (features `['lock-open']`) alongside a
+* child named "Actuator" whose only role is `binary-sensor`, and the generic
+* role beat the lock. A role earns a place here by naming a SUBJECT (a contact,
+* a leak, smoke), never by naming a datatype.
+*/
+function roleRank(role) {
+	if (role === void 0) return CONTAINER_CHILD_ROLE_PRIORITY.length;
+	const i = CONTAINER_CHILD_ROLE_PRIORITY.indexOf(role);
+	return i === -1 ? CONTAINER_CHILD_ROLE_PRIORITY.length : i;
+}
+function rank(type) {
+	const i = CONTAINER_CHILD_PRIORITY.indexOf(type);
+	return i === -1 ? CONTAINER_CHILD_PRIORITY.length : i;
+}
+/**
+* The child a container stands for: the operator's pick when it still exists,
+* else the highest-priority type. `null` for a childless container — a caller
+* must decide what an empty container means for it, rather than being handed a
+* child that is not there.
+*/
+/**
+* Two names for the same thing, compared the way an integration writes them.
+*
+* An exact case-insensitive match was not enough, and the failure was total
+* rather than marginal. An ESPHome shutter arrives as a container named
+* `Tapparella-Kitchen` whose children include the COVER, named `Tapparella
+* kitchen`, and a device-presence entity carrying the slug verbatim,
+* `tapparella-kitchen`. The slug matched the container exactly and the cover
+* did not, so the namesake tie-break handed the container to a connectivity
+* indicator — and the viewer's accessory panel, which correctly shows only
+* children with an actuating control, then rendered NOTHING. The operator saw
+* no shutters at all on kitchen, studio and both porch cameras (2026-09-22).
+*
+* `Markise` was the control case that proved the mechanism: there the cover
+* really is called exactly like its container, so it won and appeared.
+*
+* Separators are therefore normalised — `-`, `_` and whitespace are the same
+* character for this comparison, and runs of them collapse. The two candidates
+* then tie on the namesake and the decision falls through to `rank(type)`,
+* where `cover` is eighth and a `presence` entity is not listed at all. The
+* criterion keeps doing its job for a container whose child IS the namesake;
+* it stops being decided by which integration used a hyphen.
+*/
+function sameName(childName, containerName) {
+	const flatten = (v) => v.toLowerCase().replace(/[-_\s]+/g, " ").trim();
+	return flatten(childName) === flatten(containerName);
+}
+function resolveContainerPrimaryChild(children, overrideEntityId, containerName) {
+	if (overrideEntityId !== void 0 && overrideEntityId !== null) {
+		const picked = children.find((c) => c.stableId === overrideEntityId) ?? children.find((c) => c.entityId !== void 0 && c.entityId === overrideEntityId);
+		if (picked !== void 0) return picked;
+	}
+	const namesake = (c) => containerName !== void 0 && containerName.length > 0 && c.name !== void 0 && sameName(c.name, containerName) ? 0 : 1;
+	return [...children].toSorted((a, b) => roleRank(a.role) - roleRank(b.role) || namesake(a) - namesake(b) || rank(a.type) - rank(b.type))[0] ?? null;
+}
+//#endregion
 //#region src/device/device-state-handle.ts
 var DEVICE_STATE_EVENT_CATEGORY = "device.state-changed";
 /**
@@ -32331,6 +32495,7 @@ exports.parseRetrainRevisionConflict = parseRetrainRevisionConflict;
 exports.pickerForCondition = pickerForCondition;
 exports.pickerForRuleClasses = pickerForRuleClasses;
 exports.projectSubjectPath = projectSubjectPath;
+exports.resolveContainerPrimaryChild = resolveContainerPrimaryChild;
 exports.resolveIconKey = resolveIconKey;
 exports.resolveModeDelays = resolveModeDelays;
 exports.retrainBoxIou = retrainBoxIou;

package/dist/client.mjs

@@ -698,8 +698,14 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
 	DeviceType["PetFeeder"] = "pet-feeder";
 	/** Built-in dishwasher — program lifecycle, door / remote-start gates,
 	*  salt and rinse-aid levels. Installed with the `dishwasher` cap.
-	*  Sources: native Bosch Home Connect, reusable by similar integrations. */
+	*  Sources: native Bosch Home Connect, reusable by similar integrations.
+	*  A plug-built dishwasher carries running-state and power instead. */
 	DeviceType["Dishwasher"] = "dishwasher";
+	/** Washing machine. A plug-built one is running while its power stays
+	*  above a threshold. No program cap — that surface is the dishwasher's. */
+	DeviceType["Washer"] = "washer";
+	/** Tumble dryer. Same plug-built running surface as {@link Washer}. */
+	DeviceType["Dryer"] = "dryer";
 	return DeviceType;
 }({});
 z.enum(["new-session", "step-up"]);
@@ -26235,6 +26241,164 @@ method(z.object({
 	auth: "protected"
 });
 //#endregion
+//#region src/device/container-primary-child.ts
+/**
+* WHICH child a container stands for — one definition, for every consumer.
+*
+* A CONTAINER device has no controllable surface of its own: it groups entity
+* children (a Gree air-conditioner grouping a climate child plus light, x-fan
+* and health switches). Everything that has to show or act on a container has
+* to answer the same question — which child IS the container — and until now
+* three places answered it separately:
+*
+*   - `ui-library/device-controls/primary-child.ts`   (admin-ui rendering)
+*   - `addon-provider-homeassistant` PARENT_TYPE_PRIORITY (adoption)
+*   - the viewer's own `container-primary.ts`         (linked-devices panel)
+*
+* Each carried the same list and a comment asking the others to stay in sync.
+* This is that list, in the one package all of them already depend on.
+*
+* `ui-library` and the server's linked-devices expansion IMPORT it. Two
+* consumers cannot, and keep a checked copy instead: the viewer resolves
+* `@camstack/types` from its own `node_modules` (an installed release, where a
+* newly added export simply is not there), and the Home Assistant provider
+* expresses the same precedence over the `DeviceType` enum because it answers
+* a different question from the same ordering. `scripts/check-container-
+* priority-in-sync.ts` fails the build when either drifts — the comment that
+* used to ask for this could not.
+*
+* The rule has two halves and the ORDER matters: an operator's explicit pick
+* wins outright, and only in its absence does type priority decide. The pick is
+* keyed on the child's re-sync-stable `entityId`, not its numeric id, so it
+* survives a re-sync that reallocates ids.
+*/
+/**
+* Type priority, most→least "primary". An actuator (climate / lock / cover / …)
+* outranks a bare `switch` so a container's defining child wins over its
+* auxiliary switches. Unknown or absent types sort after every entry.
+*
+* NB: `siren` deliberately sits BELOW `switch` — it is a switch-family
+* actuator, and a camera's siren must not out-rank the thing the container is.
+*
+* These strings are matched against a child's `DeviceType` VALUE, so they must
+* equal the enum's string values.
+*/
+var CONTAINER_CHILD_PRIORITY = [
+	"media-player",
+	"alarm-panel",
+	"thermostat",
+	"climate",
+	"humidifier",
+	"water-heater",
+	"lock",
+	"cover",
+	"valve",
+	"fan",
+	"vacuum",
+	"lawn-mower",
+	"washer",
+	"dryer",
+	"dishwasher",
+	"light",
+	"switch",
+	"siren",
+	"button",
+	"control",
+	"notifier",
+	"script",
+	"automation",
+	"update",
+	"presence",
+	"weather",
+	"image",
+	"sensor"
+];
+/**
+* Roles that say what a container IS, most→least defining. Consulted BEFORE
+* type priority, because `DeviceType` cannot tell them apart: Home Assistant
+* maps a door contact, a battery level, a temperature reading and a "last seen"
+* timestamp all to `DeviceType.Sensor`. Measured on container 4127 — children
+* `battery-sensor`, `temperature-sensor`, `datetime-sensor`, `contact-sensor`
+* and a role-less `button` — the type list ranked `button` above `sensor` and
+* the container stood for its "Identifica" button instead of the door contact
+* it is named after.
+*
+* Only STATE-DEFINING roles belong here. A diagnostic reading (battery,
+* temperature, humidity, signal, last-seen) is never what a container is, so
+* they are deliberately absent and fall through to type priority.
+*/
+var CONTAINER_CHILD_ROLE_PRIORITY = [
+	"contact-sensor",
+	"motion-sensor",
+	"occupancy-sensor",
+	"smoke-sensor",
+	"co-sensor",
+	"gas-sensor",
+	"leak-sensor",
+	"vibration-sensor",
+	"tamper-sensor",
+	"sound-sensor"
+];
+/**
+* NOT in the list, deliberately: `binary-sensor` and `binary-helper`. They are
+* GENERIC — they say "this reports a boolean", not what the container is — and
+* ranking them above type priority is a live regression, not a hypothetical:
+* container 1837 holds a real `lock` (features `['lock-open']`) alongside a
+* child named "Actuator" whose only role is `binary-sensor`, and the generic
+* role beat the lock. A role earns a place here by naming a SUBJECT (a contact,
+* a leak, smoke), never by naming a datatype.
+*/
+function roleRank(role) {
+	if (role === void 0) return CONTAINER_CHILD_ROLE_PRIORITY.length;
+	const i = CONTAINER_CHILD_ROLE_PRIORITY.indexOf(role);
+	return i === -1 ? CONTAINER_CHILD_ROLE_PRIORITY.length : i;
+}
+function rank(type) {
+	const i = CONTAINER_CHILD_PRIORITY.indexOf(type);
+	return i === -1 ? CONTAINER_CHILD_PRIORITY.length : i;
+}
+/**
+* The child a container stands for: the operator's pick when it still exists,
+* else the highest-priority type. `null` for a childless container — a caller
+* must decide what an empty container means for it, rather than being handed a
+* child that is not there.
+*/
+/**
+* Two names for the same thing, compared the way an integration writes them.
+*
+* An exact case-insensitive match was not enough, and the failure was total
+* rather than marginal. An ESPHome shutter arrives as a container named
+* `Tapparella-Kitchen` whose children include the COVER, named `Tapparella
+* kitchen`, and a device-presence entity carrying the slug verbatim,
+* `tapparella-kitchen`. The slug matched the container exactly and the cover
+* did not, so the namesake tie-break handed the container to a connectivity
+* indicator — and the viewer's accessory panel, which correctly shows only
+* children with an actuating control, then rendered NOTHING. The operator saw
+* no shutters at all on kitchen, studio and both porch cameras (2026-09-22).
+*
+* `Markise` was the control case that proved the mechanism: there the cover
+* really is called exactly like its container, so it won and appeared.
+*
+* Separators are therefore normalised — `-`, `_` and whitespace are the same
+* character for this comparison, and runs of them collapse. The two candidates
+* then tie on the namesake and the decision falls through to `rank(type)`,
+* where `cover` is eighth and a `presence` entity is not listed at all. The
+* criterion keeps doing its job for a container whose child IS the namesake;
+* it stops being decided by which integration used a hyphen.
+*/
+function sameName(childName, containerName) {
+	const flatten = (v) => v.toLowerCase().replace(/[-_\s]+/g, " ").trim();
+	return flatten(childName) === flatten(containerName);
+}
+function resolveContainerPrimaryChild(children, overrideEntityId, containerName) {
+	if (overrideEntityId !== void 0 && overrideEntityId !== null) {
+		const picked = children.find((c) => c.stableId === overrideEntityId) ?? children.find((c) => c.entityId !== void 0 && c.entityId === overrideEntityId);
+		if (picked !== void 0) return picked;
+	}
+	const namesake = (c) => containerName !== void 0 && containerName.length > 0 && c.name !== void 0 && sameName(c.name, containerName) ? 0 : 1;
+	return [...children].toSorted((a, b) => roleRank(a.role) - roleRank(b.role) || namesake(a) - namesake(b) || rank(a.type) - rank(b.type))[0] ?? null;
+}
+//#endregion
 //#region src/device/device-state-handle.ts
 var DEVICE_STATE_EVENT_CATEGORY = "device.state-changed";
 /**
@@ -32237,4 +32401,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, 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 };
+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, resolveContainerPrimaryChild, 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.d.ts

@@ -776,6 +776,18 @@ export declare const CompositionSchema: z.ZodObject<{
         aggregate: typeof import("./index.js").AggregateReducerSchema;
         members: z.ZodArray<typeof import("./index.js").HelperMemberSchema>;
         active: z.ZodOptional<typeof import("./index.js").ActiveCriterionSchema>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<'appliance'>;
+        templateId: z.ZodLiteral<typeof import("./index.js").APPLIANCE_TEMPLATE_ID>;
+        appliance: z.ZodEnum<{
+            washer: 'washer';
+            dryer: 'dryer';
+            dishwasher: 'dishwasher';
+        }>;
+        thresholdWatts: z.ZodNumber;
+        startDwellMs: z.ZodNumber;
+        stopDwellMs: z.ZodNumber;
+        member: typeof import("./index.js").HelperMemberSchema;
     }, z.core.$strip>], "kind">>;
 }, z.core.$strip>;
 export type Composition = z.infer<typeof CompositionSchema>;

package/dist/composition/helpers/appliance.d.ts

@@ -0,0 +1,28 @@
+/**
+ * One power reading becomes a washer, dryer or dishwasher (D944 helper).
+ *
+ * Standby of the control board is under 5 W; a motor or a heater is far
+ * above that, so 5 W is the line. A door lock or a short pump spike is not
+ * a cycle, so running starts only after 30 s above the line.
+ *
+ * A wash, dry or dishwasher pause (soak, heat-wait, heater off between
+ * bursts) lasts several minutes. Ending the cycle on the first dip would
+ * report "finished" in the middle of the program, so the stop dwell is
+ * 10 minutes on every type. The number is stored per type so one machine
+ * can move later without moving the others.
+ */
+import { DeviceType } from '../../device/device-type.js';
+import type { SourcePickRequest } from './source-pick.js';
+export declare const APPLIANCE_TEMPLATE_ID: 'appliance';
+export declare const APPLIANCE_KINDS: readonly ['washer', 'dryer', 'dishwasher'];
+export type ApplianceKind = (typeof APPLIANCE_KINDS)[number];
+export interface ApplianceDefaults {
+    readonly thresholdWatts: number;
+    readonly startDwellMs: number;
+    readonly stopDwellMs: number;
+}
+export declare const APPLIANCE_DEFAULTS: Readonly<Record<ApplianceKind, ApplianceDefaults>>;
+export declare function applianceDeviceType(kind: ApplianceKind): DeviceType;
+export declare function isApplianceKind(value: string): value is ApplianceKind;
+/** The member step: one watts reading, from a sensor or from the plug itself. */
+export declare function sourcePickForAppliance(): SourcePickRequest;

package/dist/composition/helpers/compile.d.ts

@@ -15,7 +15,7 @@ export interface HelperRefused {
     readonly problems: readonly CompositionProblem[];
 }
 export type HelperCompileResult = HelperCompiled | HelperRefused;
-/** Compile a group template to a new-device composition. Refusals are named. */
+/** Compile a helper template to a new-device composition. Refusals are named. */
 export declare function compileHelper(spec: HelperSpec): HelperCompileResult;
 /** The built body, ignoring `helper`, so a save can demand one writer. */
 export declare function sameHelperBody(stored: Composition, compiled: Composition): boolean;

package/dist/composition/helpers/index.d.ts

@@ -1,7 +1,8 @@
 export { FAN_OUT_CONCURRENCY, LIGHT_SHARED_CAPS, type FanOutCall, type FanOutFailed, type FanOutMember, type FanOutMemberResult, type FanOutOk, type LightSharedCap, activeForReducer, fanOutTargets, reducerForActive, runFanOut, sharedColorModes, sharedLightCaps, } from './actuator.js';
 export { type AggregateCounts, type AggregateEmpty, type AggregateOutcome, type AggregatePublish, type AggregateReadResult, type AggregateUnavailable, type AggregateValue, type EvaluateAggregateInput, evaluateAggregate, } from './aggregate.js';
+export { APPLIANCE_DEFAULTS, APPLIANCE_KINDS, APPLIANCE_TEMPLATE_ID, type ApplianceDefaults, type ApplianceKind, applianceDeviceType, isApplianceKind, sourcePickForAppliance, } from './appliance.js';
 export { type GroupTemplate, type HelperAccept, type HelperCompanion, GROUP_TEMPLATES, groupTemplate, } from './catalog.js';
 export { type HelperCompileResult, type HelperCompiled, type HelperRefused, compileHelper, sameHelperBody, templateDeviceType, } from './compile.js';
 export { type HelperMemberFact, helperSaveProblems, } from './save.js';
 export { type SourcePick, type SourcePickAccept, type SourcePickHistory, type SourcePickRequest, sourcePickForTemplate, } from './source-pick.js';
-export { ACTIVE_CRITERIA, AGGREGATE_REDUCERS, ActiveCriterionSchema, AggregateReducerSchema, BINARY_AGGREGATES, GROUP_TEMPLATE_IDS, GroupHelperSpecSchema, GroupTemplateIdSchema, HelperMemberSchema, HelperSpecSchema, MAX_HELPER_MEMBERS, NUMERIC_AGGREGATES, type ActiveCriterion, type AggregateReducer, type BinaryAggregate, type GroupHelperSpec, type GroupTemplateId, type HelperMember, type HelperSpec, type NumericAggregate, } from './spec.js';
+export { ACTIVE_CRITERIA, AGGREGATE_REDUCERS, ActiveCriterionSchema, AggregateReducerSchema, BINARY_AGGREGATES, GROUP_TEMPLATE_IDS, ApplianceHelperSpecSchema, GroupHelperSpecSchema, GroupTemplateIdSchema, HelperMemberSchema, HelperSpecSchema, MAX_HELPER_MEMBERS, helperMembers, NUMERIC_AGGREGATES, type ActiveCriterion, type AggregateReducer, type BinaryAggregate, type ApplianceHelperSpec, type GroupHelperSpec, type GroupTemplateId, type HelperMember, type HelperSpec, type NumericAggregate, } from './spec.js';

package/dist/composition/helpers/save.d.ts

@@ -2,7 +2,7 @@
  * Save-time checks a pure compile cannot make: the compiled features must be
  * this spec's, and members that report a quantity must share one (D944 §4).
  */
-import type { DeviceType } from '../../device/device-type.js';
+import { DeviceType } from '../../device/device-type.js';
 import type { ReadingQuantity } from '../../units/quantity.js';
 import { type Composition } from '../composition.js';
 import type { CompositionProblem } from '../composition-report.js';

package/dist/composition/helpers/spec.d.ts

@@ -3,6 +3,7 @@
  * features are a projection; the editor never edits the expression.
  */
 import { z } from 'zod';
+import { APPLIANCE_TEMPLATE_ID } from './appliance.js';
 import { CompositionSourceRefSchema } from '../source-ref.js';
 /** A group may name more members than an expression call (the 16-arg cap). */
 export declare const MAX_HELPER_MEMBERS: number;
@@ -39,5 +40,24 @@ export declare const GroupHelperSpecSchema: z.ZodObject<{
     active: z.ZodOptional<typeof ActiveCriterionSchema>;
 }>;
 export type GroupHelperSpec = z.infer<typeof GroupHelperSpecSchema>;
-export declare const HelperSpecSchema: z.ZodDiscriminatedUnion<[typeof GroupHelperSpecSchema], 'kind'>;
+export declare const ApplianceHelperSpecSchema: z.ZodObject<{
+    kind: z.ZodLiteral<'appliance'>;
+    templateId: z.ZodLiteral<typeof APPLIANCE_TEMPLATE_ID>;
+    appliance: z.ZodEnum<{
+        washer: 'washer';
+        dryer: 'dryer';
+        dishwasher: 'dishwasher';
+    }>;
+    thresholdWatts: z.ZodNumber;
+    startDwellMs: z.ZodNumber;
+    stopDwellMs: z.ZodNumber;
+    member: typeof HelperMemberSchema;
+}>;
+export type ApplianceHelperSpec = z.infer<typeof ApplianceHelperSpecSchema>;
+export declare const HelperSpecSchema: z.ZodDiscriminatedUnion<[
+    typeof GroupHelperSpecSchema,
+    typeof ApplianceHelperSpecSchema
+], 'kind'>;
 export type HelperSpec = z.infer<typeof HelperSpecSchema>;
+/** Every member a helper reads. An appliance has one. */
+export declare function helperMembers(spec: HelperSpec): readonly HelperMember[];

package/dist/{composition-OhpuespA.mjs → composition-B2rw5L29.mjs}

@@ -1,4 +1,4 @@
-import { a as DeviceType, i as DeviceRole } from "./err-msg-BXKzRBwg.mjs";
+import { a as DeviceType, i as DeviceRole } from "./err-msg-DIorGYeC.mjs";
 import { z } from "zod";
 import { createHash } from "node:crypto";
 //#region src/ffmpeg/invocation.ts
@@ -2160,6 +2160,78 @@ function evaluateExpressionSource(expr, bindingValues, now, opts) {
 	}
 }
 //#endregion
+//#region src/composition/helpers/appliance.ts
+/**
+* One power reading becomes a washer, dryer or dishwasher (D944 helper).
+*
+* Standby of the control board is under 5 W; a motor or a heater is far
+* above that, so 5 W is the line. A door lock or a short pump spike is not
+* a cycle, so running starts only after 30 s above the line.
+*
+* A wash, dry or dishwasher pause (soak, heat-wait, heater off between
+* bursts) lasts several minutes. Ending the cycle on the first dip would
+* report "finished" in the middle of the program, so the stop dwell is
+* 10 minutes on every type. The number is stored per type so one machine
+* can move later without moving the others.
+*/
+var APPLIANCE_TEMPLATE_ID = "appliance";
+var APPLIANCE_KINDS = [
+	"washer",
+	"dryer",
+	"dishwasher"
+];
+var START_DWELL_MS = 3e4;
+var STOP_DWELL_MS = 6e5;
+var THRESHOLD_WATTS = 5;
+var APPLIANCE_DEFAULTS = {
+	washer: {
+		thresholdWatts: THRESHOLD_WATTS,
+		startDwellMs: START_DWELL_MS,
+		stopDwellMs: STOP_DWELL_MS
+	},
+	dryer: {
+		thresholdWatts: THRESHOLD_WATTS,
+		startDwellMs: START_DWELL_MS,
+		stopDwellMs: STOP_DWELL_MS
+	},
+	dishwasher: {
+		thresholdWatts: THRESHOLD_WATTS,
+		startDwellMs: START_DWELL_MS,
+		stopDwellMs: STOP_DWELL_MS
+	}
+};
+var DEVICE_TYPE = {
+	washer: DeviceType.Washer,
+	dryer: DeviceType.Dryer,
+	dishwasher: DeviceType.Dishwasher
+};
+function applianceDeviceType(kind) {
+	return DEVICE_TYPE[kind];
+}
+function isApplianceKind(value) {
+	return APPLIANCE_KINDS.some((kind) => kind === value);
+}
+/** The member step: one watts reading, from a sensor or from the plug itself. */
+function sourcePickForAppliance() {
+	return {
+		purpose: "reading",
+		multiple: false,
+		max: 1,
+		deviceTypes: [DeviceType.Sensor, DeviceType.Switch],
+		accept: [{
+			cap: "power-meter",
+			fieldPath: "watts",
+			valueKind: "number"
+		}],
+		history: {
+			required: false,
+			minRetentionMs: null
+		},
+		mustBindCaps: [],
+		exclude: []
+	};
+}
+//#endregion
 //#region src/composition/source-ref.ts
 /**
 * A composition source identity: `(addonId, stableId)`, never a numeric device
@@ -2237,7 +2309,20 @@ var GroupHelperSpecSchema = z.object({
 	/** Actuator groups only. Readings leave this unset. */
 	active: ActiveCriterionSchema.optional()
 });
-var HelperSpecSchema = z.discriminatedUnion("kind", [GroupHelperSpecSchema]);
+var ApplianceHelperSpecSchema = z.object({
+	kind: z.literal("appliance"),
+	templateId: z.literal(APPLIANCE_TEMPLATE_ID),
+	appliance: z.enum(APPLIANCE_KINDS),
+	thresholdWatts: z.number().positive(),
+	startDwellMs: z.number().int().nonnegative(),
+	stopDwellMs: z.number().int().nonnegative(),
+	member: HelperMemberSchema
+});
+var HelperSpecSchema = z.discriminatedUnion("kind", [GroupHelperSpecSchema, ApplianceHelperSpecSchema]);
+/** Every member a helper reads. An appliance has one. */
+function helperMembers(spec) {
+	return spec.kind === "group" ? spec.members : [spec.member];
+}
 //#endregion
 //#region src/composition/composition.ts
 /**
@@ -2497,4 +2582,4 @@ function featureSources(feature) {
 	return featureFieldEntries(feature).map((e) => e.source);
 }
 //#endregion
-export { createStatefulExpressionMemory as $, pickVideoEncoder as $t, compositionFeatureEnabled as A, SOURCE_DEVICE_TYPES as At, ActiveCriterionSchema as B, getFfmpegArtifact as Bt, CompositionTargetSchema as C, isStatefulBuiltin as Ct, MAX_COMPOSITION_ITEMS as D, SOURCE_CAPS as Dt, MAX_COMPOSITION_FIELDS_PER_FEATURE as E, DEFAULT_FIRST_SIGHTING_FRESHNESS_MS as Et, featureFieldEntries as F, sliceChangedAt as Ft, GroupTemplateIdSchema as G, audioPlanFromEncodeProfile as Gt, BINARY_AGGREGATES as H, canonicalHash as Ht, featureSources as I, FFMPEG_PATH_ENV as It, MAX_HELPER_MEMBERS as J, buildInputArgs as Jt, HelperMemberSchema as K, buildAudioArgs as Kt, fieldReads as L, chooseFfmpegBinary as Lt, compositionReadKey as M, evaluateSensorLevelEdge as Mt, compositionSliceKey as N, isSourceCap as Nt, composedDeviceRef as O, SOURCE_CAP_ACTIVE_FIELD as Ot, compositionSourceKey as P, sliceActiveValue as Pt, cloneStatefulExpressionMemory as Q, logBannerArgs as Qt, ACTIVE_CRITERIA as R, ffmpegBinaryName as Rt, CompositionSchema as S, evaluateRose as St, MAX_COMPOSITION_FEATURES as T, ExpressionParseError as Tt, GROUP_TEMPLATE_IDS as U, Fmp4BoxSplitter as Ut, AggregateReducerSchema as V, getFfmpegDownloadUrl as Vt, GroupHelperSpecSchema as W, AUDIO_PRESETS as Wt, CompositionSourceRefSchema as X, invocationFromEncodeProfile as Xt, NUMERIC_AGGREGATES as Y, buildVideoArgs as Yt, EXPRESSION_INJECTED_NOW as Z, isSoftwareDecode as Zt, CompositionFromSourceSchema as _, RESERVED_BINDING_NAMES as _t, CUSTOMIZATION_BLOCK_NAME_PREFIX as a, evaluateAst as at, CompositionNewTargetSchema as b, disarmRoseMemory as bt, CompositionCodeSourceSchema as c, parseExpression as ct, CompositionExpressionSourceSchema as d, EXPRESSION_IDENTIFIER_RE as dt, resolveStreamMaps as en, evaluateExpressionSource as et, CompositionFeatureSchema as f, MAX_EXPRESSION_AST_NODES as ft, CompositionForwardCommandSchema as g, MAX_EXPRESSION_SOURCE_LENGTH as gt, CompositionFieldsFeatureSchema as h, MAX_EXPRESSION_EVAL_STEPS as ht, COMPOSITION_ITEM_KEY_RE as i, createExpressionScope as it, compositionItemFieldPath as j, evaluateSensorEdge as jt, composedDeviceStableId as k, SOURCE_CAP_CHANGED_AT_FIELD as kt, CompositionCommandTargetSchema as l, tokenize as lt, CompositionFieldSourceSchema as m, MAX_EXPRESSION_CALL_ARGS as mt, COMPOSER_ADDON_ID as n, toExpressionValue as nt, CompositionAggregateSourceSchema as o, compileExpression as ot, CompositionFieldReadSchema as p, MAX_EXPRESSION_BINDINGS as pt, HelperSpecSchema as q, buildFfmpegArgs as qt, COMPOSITION_ITEM_ARRAY_PATH as r, validateExpressionSource as rt, CompositionBindingSchema as s, compileExpressionSafe as st, COMPOSED_DEVICE_STABLE_ID_PREFIX as t, evaluateStatefulExpressionCall as tt, CompositionExistingTargetSchema as u, EXPRESSION_COMPILE_CACHE_CAPACITY as ut, CompositionItemEntrySchema as v, EXPRESSION_BUILTINS as vt, MAX_COMPOSITION_CODE_LENGTH as w, ExpressionEvalError as wt, CompositionPassthroughFeatureSchema as x, evaluateCount as xt, CompositionLiteralBindingSchema as y, EXPRESSION_BUILTIN_NAMES as yt, AGGREGATE_REDUCERS as z, FFMPEG_RELEASE as zt };
+export { APPLIANCE_DEFAULTS as $, audioPlanFromEncodeProfile as $t, compositionFeatureEnabled as A, evaluateRose as At, ActiveCriterionSchema as B, evaluateSensorLevelEdge as Bt, CompositionTargetSchema as C, MAX_EXPRESSION_EVAL_STEPS as Ct, MAX_COMPOSITION_ITEMS as D, EXPRESSION_BUILTIN_NAMES as Dt, MAX_COMPOSITION_FIELDS_PER_FEATURE as E, EXPRESSION_BUILTINS as Et, featureFieldEntries as F, SOURCE_CAPS as Ft, GroupHelperSpecSchema as G, chooseFfmpegBinary as Gt, ApplianceHelperSpecSchema as H, sliceActiveValue as Ht, featureSources as I, SOURCE_CAP_ACTIVE_FIELD as It, HelperSpecSchema as J, getFfmpegArtifact as Jt, GroupTemplateIdSchema as K, ffmpegBinaryName as Kt, fieldReads as L, SOURCE_CAP_CHANGED_AT_FIELD as Lt, compositionReadKey as M, ExpressionEvalError as Mt, compositionSliceKey as N, ExpressionParseError as Nt, composedDeviceRef as O, disarmRoseMemory as Ot, compositionSourceKey as P, DEFAULT_FIRST_SIGHTING_FRESHNESS_MS as Pt, CompositionSourceRefSchema as Q, AUDIO_PRESETS as Qt, ACTIVE_CRITERIA as R, SOURCE_DEVICE_TYPES as Rt, CompositionSchema as S, MAX_EXPRESSION_CALL_ARGS as St, MAX_COMPOSITION_FEATURES as T, RESERVED_BINDING_NAMES as Tt, BINARY_AGGREGATES as U, sliceChangedAt as Ut, AggregateReducerSchema as V, isSourceCap as Vt, GROUP_TEMPLATE_IDS as W, FFMPEG_PATH_ENV as Wt, NUMERIC_AGGREGATES as X, canonicalHash as Xt, MAX_HELPER_MEMBERS as Y, getFfmpegDownloadUrl as Yt, helperMembers as Z, Fmp4BoxSplitter as Zt, CompositionFromSourceSchema as _, tokenize as _t, CUSTOMIZATION_BLOCK_NAME_PREFIX as a, isSoftwareDecode as an, EXPRESSION_INJECTED_NOW as at, CompositionNewTargetSchema as b, MAX_EXPRESSION_AST_NODES as bt, CompositionCodeSourceSchema as c, resolveStreamMaps as cn, evaluateExpressionSource as ct, CompositionExpressionSourceSchema as d, validateExpressionSource as dt, buildAudioArgs as en, APPLIANCE_KINDS as et, CompositionFeatureSchema as f, createExpressionScope as ft, CompositionForwardCommandSchema as g, parseExpression as gt, CompositionFieldsFeatureSchema as h, compileExpressionSafe as ht, COMPOSITION_ITEM_KEY_RE as i, invocationFromEncodeProfile as in, sourcePickForAppliance as it, compositionItemFieldPath as j, isStatefulBuiltin as jt, composedDeviceStableId as k, evaluateCount as kt, CompositionCommandTargetSchema as l, evaluateStatefulExpressionCall as lt, CompositionFieldSourceSchema as m, compileExpression as mt, COMPOSER_ADDON_ID as n, buildInputArgs as nn, applianceDeviceType as nt, CompositionAggregateSourceSchema as o, logBannerArgs as on, cloneStatefulExpressionMemory as ot, CompositionFieldReadSchema as p, evaluateAst as pt, HelperMemberSchema as q, FFMPEG_RELEASE as qt, COMPOSITION_ITEM_ARRAY_PATH as r, buildVideoArgs as rn, isApplianceKind as rt, CompositionBindingSchema as s, pickVideoEncoder as sn, createStatefulExpressionMemory as st, COMPOSED_DEVICE_STABLE_ID_PREFIX as t, buildFfmpegArgs as tn, APPLIANCE_TEMPLATE_ID as tt, CompositionExistingTargetSchema as u, toExpressionValue as ut, CompositionItemEntrySchema as v, EXPRESSION_COMPILE_CACHE_CAPACITY as vt, MAX_COMPOSITION_CODE_LENGTH as w, MAX_EXPRESSION_SOURCE_LENGTH as wt, CompositionPassthroughFeatureSchema as x, MAX_EXPRESSION_BINDINGS as xt, CompositionLiteralBindingSchema as y, EXPRESSION_IDENTIFIER_RE as yt, AGGREGATE_REDUCERS as z, evaluateSensorEdge as zt };