@camstack/types 1.2.419 → 1.2.421

package/dist/{composition-re1aezX9.js → composition-B3Hkb6v7.js}

@@ -1,4 +1,4 @@
-const require_err_msg = require("./err-msg-BhVbr0NX.js");
+const require_err_msg = require("./err-msg-U7lLUMNz.js");
 let zod = require("zod");
 let node_crypto = require("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: require_err_msg.DeviceType.Washer,
+	dryer: require_err_msg.DeviceType.Dryer,
+	dishwasher: require_err_msg.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: [require_err_msg.DeviceType.Sensor, require_err_msg.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 = zod.z.object({
 	/** Actuator groups only. Readings leave this unset. */
 	active: ActiveCriterionSchema.optional()
 });
-var HelperSpecSchema = zod.z.discriminatedUnion("kind", [GroupHelperSpecSchema]);
+var ApplianceHelperSpecSchema = zod.z.object({
+	kind: zod.z.literal("appliance"),
+	templateId: zod.z.literal(APPLIANCE_TEMPLATE_ID),
+	appliance: zod.z.enum(APPLIANCE_KINDS),
+	thresholdWatts: zod.z.number().positive(),
+	startDwellMs: zod.z.number().int().nonnegative(),
+	stopDwellMs: zod.z.number().int().nonnegative(),
+	member: HelperMemberSchema
+});
+var HelperSpecSchema = zod.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
 /**
@@ -2509,6 +2594,24 @@ Object.defineProperty(exports, "AGGREGATE_REDUCERS", {
 		return AGGREGATE_REDUCERS;
 	}
 });
+Object.defineProperty(exports, "APPLIANCE_DEFAULTS", {
+	enumerable: true,
+	get: function() {
+		return APPLIANCE_DEFAULTS;
+	}
+});
+Object.defineProperty(exports, "APPLIANCE_KINDS", {
+	enumerable: true,
+	get: function() {
+		return APPLIANCE_KINDS;
+	}
+});
+Object.defineProperty(exports, "APPLIANCE_TEMPLATE_ID", {
+	enumerable: true,
+	get: function() {
+		return APPLIANCE_TEMPLATE_ID;
+	}
+});
 Object.defineProperty(exports, "AUDIO_PRESETS", {
 	enumerable: true,
 	get: function() {
@@ -2527,6 +2630,12 @@ Object.defineProperty(exports, "AggregateReducerSchema", {
 		return AggregateReducerSchema;
 	}
 });
+Object.defineProperty(exports, "ApplianceHelperSpecSchema", {
+	enumerable: true,
+	get: function() {
+		return ApplianceHelperSpecSchema;
+	}
+});
 Object.defineProperty(exports, "BINARY_AGGREGATES", {
 	enumerable: true,
 	get: function() {
@@ -2869,6 +2978,12 @@ Object.defineProperty(exports, "SOURCE_DEVICE_TYPES", {
 		return SOURCE_DEVICE_TYPES;
 	}
 });
+Object.defineProperty(exports, "applianceDeviceType", {
+	enumerable: true,
+	get: function() {
+		return applianceDeviceType;
+	}
+});
 Object.defineProperty(exports, "audioPlanFromEncodeProfile", {
 	enumerable: true,
 	get: function() {
@@ -3067,12 +3182,24 @@ Object.defineProperty(exports, "getFfmpegDownloadUrl", {
 		return getFfmpegDownloadUrl;
 	}
 });
+Object.defineProperty(exports, "helperMembers", {
+	enumerable: true,
+	get: function() {
+		return helperMembers;
+	}
+});
 Object.defineProperty(exports, "invocationFromEncodeProfile", {
 	enumerable: true,
 	get: function() {
 		return invocationFromEncodeProfile;
 	}
 });
+Object.defineProperty(exports, "isApplianceKind", {
+	enumerable: true,
+	get: function() {
+		return isApplianceKind;
+	}
+});
 Object.defineProperty(exports, "isSoftwareDecode", {
 	enumerable: true,
 	get: function() {
@@ -3127,6 +3254,12 @@ Object.defineProperty(exports, "sliceChangedAt", {
 		return sliceChangedAt;
 	}
 });
+Object.defineProperty(exports, "sourcePickForAppliance", {
+	enumerable: true,
+	get: function() {
+		return sourcePickForAppliance;
+	}
+});
 Object.defineProperty(exports, "toExpressionValue", {
 	enumerable: true,
 	get: function() {

package/dist/device/appliance-export.d.ts

@@ -0,0 +1,25 @@
+/**
+ * How a washer, dryer or dishwasher leaves CamStack.
+ *
+ * Home Assistant has no laundry domain: the device is offered, and what
+ * travels is its power reading. The others have a laundry type that this
+ * export cannot honour yet, so they are named and withheld.
+ */
+import { DeviceType } from './device-type.js';
+export type PlugApplianceType = DeviceType.Washer | DeviceType.Dryer | DeviceType.Dishwasher;
+export declare const PLUG_APPLIANCE_TYPES: readonly PlugApplianceType[];
+export interface ApplianceExported {
+    readonly exported: true;
+    /** What the other ecosystem actually receives. */
+    readonly as: string;
+}
+export interface ApplianceNotExported {
+    readonly exported: false;
+    readonly reason: string;
+}
+export type ApplianceExportDecision = ApplianceExported | ApplianceNotExported;
+export type ApplianceExportEcosystem = 'ha' | 'homekit' | 'alexa' | 'google' | 'matter';
+export declare const APPLIANCE_EXPORT: Readonly<Record<ApplianceExportEcosystem, Readonly<Record<PlugApplianceType, ApplianceExportDecision>>>>;
+export declare function isPlugApplianceType(deviceType: string): deviceType is PlugApplianceType;
+/** The decision for this ecosystem, or null when the type is not an appliance. */
+export declare function applianceExport(ecosystem: ApplianceExportEcosystem, deviceType: string): ApplianceExportDecision | null;

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

@@ -238,6 +238,12 @@ export interface VocabStateWording {
     readonly quantity?: L10n;
     readonly icon?: VocabIcon;
 }
+/** Re-wording of one declared event for a kind of device. */
+export interface VocabEventWording {
+    readonly label?: L10n;
+    readonly phrase?: L10n;
+    readonly icon?: VocabIcon;
+}
 /** Wording that differs for a device type or role (a switch that is a siren). */
 export interface VocabWording<C extends VocabCapName> {
     /** Keyed by action id. */
@@ -245,6 +251,9 @@ export interface VocabWording<C extends VocabCapName> {
     readonly state?: {
         readonly [F in CapStatusField<C>]?: VocabStateWording;
     };
+    readonly events?: {
+        readonly [E in CapEventName<C>]?: VocabEventWording;
+    };
 }
 /** Overrides, keyed in the same map: a role beats a type. */
 export interface VocabOverrides<C extends VocabCapName> {
@@ -378,6 +387,7 @@ export type LooseVocabStateTrigger = LooseBooleanStateTrigger | LooseNumericStat
 export interface LooseVocabWording {
     readonly actions?: Readonly<Record<string, VocabActionWording>>;
     readonly state?: Readonly<Record<string, VocabStateWording | undefined>>;
+    readonly events?: Readonly<Record<string, VocabEventWording | undefined>>;
 }
 /** Overrides as a consumer reads them. */
 export interface LooseVocabOverrides {

package/dist/device/device-type.d.ts

@@ -91,8 +91,14 @@ export declare enum 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. */
-    Dishwasher = "dishwasher"
+     *  Sources: native Bosch Home Connect, reusable by similar integrations.
+     *  A plug-built dishwasher carries running-state and power instead. */
+    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. */
+    Washer = "washer",
+    /** Tumble dryer. Same plug-built running surface as {@link Washer}. */
+    Dryer = "dryer"
 }
 export declare enum DeviceFeature {
     BatteryOperated = "battery-operated",

package/dist/{err-msg-BXKzRBwg.mjs → err-msg-DIorGYeC.mjs}

@@ -92,8 +92,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;
 }({});
 var DeviceFeature = /* @__PURE__ */ function(DeviceFeature) {

package/dist/{err-msg-BhVbr0NX.js → err-msg-U7lLUMNz.js}

@@ -92,8 +92,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;
 }({});
 var DeviceFeature = /* @__PURE__ */ function(DeviceFeature) {

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

@@ -56,7 +56,7 @@ export declare const CAP_CUSTOMIZE_CATALOG: {
         readonly targets: readonly [{
             readonly id: 'items';
             readonly cardinality: 'keyedArray';
-            readonly deviceTypes: readonly [DeviceType.Camera, DeviceType.Hub, DeviceType.Light, DeviceType.Siren, DeviceType.Switch, DeviceType.Sensor, DeviceType.Thermostat, DeviceType.Climate, DeviceType.Button, DeviceType.EventEmitter, DeviceType.Update, DeviceType.Generic, DeviceType.Notifier, DeviceType.Script, DeviceType.Automation, DeviceType.Lock, DeviceType.Cover, DeviceType.Valve, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.Dishwasher];
+            readonly deviceTypes: readonly [DeviceType.Camera, DeviceType.Hub, DeviceType.Light, DeviceType.Siren, DeviceType.Switch, DeviceType.Sensor, DeviceType.Thermostat, DeviceType.Climate, DeviceType.Button, DeviceType.EventEmitter, DeviceType.Update, DeviceType.Generic, DeviceType.Notifier, DeviceType.Script, DeviceType.Automation, DeviceType.Lock, DeviceType.Cover, DeviceType.Valve, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Dryer];
             readonly apply: 'add';
             readonly vocabularyCap: 'consumables';
             readonly sources: readonly [];
@@ -211,7 +211,7 @@ export declare const CAP_CUSTOMIZE_CATALOG: {
         readonly targets: readonly [{
             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 deviceTypes: readonly [DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer, DeviceType.WaterHeater, DeviceType.Humidifier, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.PetFeeder];
             readonly apply: 'add';
             readonly vocabularyCap: 'running-state';
             readonly vocabularyStateField: 'running';

package/dist/index.d.ts

@@ -217,6 +217,7 @@ export { DeviceRuntimeState } from './device/device-runtime-state.js';
 export type { SliceEventBus, SliceHandle, SliceHandleApi, SliceHandleSource, } from './device/device-state-handle.js';
 export { createEventBusSliceSource, createLazyTrpcSource, createMirrorSource, createSliceHandle, } from './device/device-state-handle.js';
 export { ChargingStatus, DeviceFeature, DeviceRole, DeviceType } from './device/device-type.js';
+export { APPLIANCE_EXPORT, type ApplianceExportDecision, type ApplianceExportEcosystem, type ApplianceExported, type ApplianceNotExported, type PlugApplianceType, PLUG_APPLIANCE_TYPES, applianceExport, isPlugApplianceType, } from './device/appliance-export.js';
 export type { IBatteryOperated, IDoorbellButton, INativeSnapshot, IPanTiltZoom, IRebootable, ITwoWayAudio, } from './device/features.js';
 export type { IconCategoryId, IconEntry, IconHit, IconKey, } from './device/icon-catalog.js';
 export { ICON_CATALOG_SOURCE, ICON_CATEGORIES, ICON_ENTRIES, ICON_KEYS, ICON_VIEWER_MODULES, IconKeySchema, canonicalIconKey, iconCategoryLabel, iconEntry, iconsInCategory, isIconKey, resolveIconKey, searchIcons, } from './device/icon-catalog.js';