@camstack/addon-provider-bosch 0.1.51 → 0.1.52

package/dist/{bosch-instances-CYBnIcHg.js → bosch-instances-LWbVnsaD.js}

@@ -802,7 +802,7 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	return EventCategory;
 }({});
 //#endregion
-//#region ../types/dist/composed-stable-id-DFNyOFzz.mjs
+//#region ../types/dist/composed-stable-id-CPp3votu.mjs
 /**
 import { errMsg } from '@camstack/types'
 * Extract a human-readable message from an unknown error value.
@@ -821,12 +821,12 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
 	DeviceType["Siren"] = "siren";
 	DeviceType["Switch"] = "switch";
 	DeviceType["Sensor"] = "sensor";
-	DeviceType["Thermostat"] = "thermostat";
-	/** Air-conditioner / heat-pump climate device (HVAC) — shares the
-	*  `climate-control` cap surface with `Thermostat` but renders a
-	*  dedicated AC-appropriate control UI (mode chips, fan speed,
-	*  independent vertical/horizontal swing). Sources: native Gree, and
-	*  reusable by other AC integrations. */
+	/** Every climate device: an air conditioner, a room thermostat, a radiator
+	*  valve, a floor-heating zone, a heat-pump circuit. They share one set of
+	*  controls (`climate-control`), so they are one type; WHICH kind of climate
+	*  device it is is its {@link DeviceRole} (`climate-*`), which the UI and the
+	*  exports branch on. The retired `thermostat` type is read as this one
+	*  (`canonicalStoredDeviceType`). */
 	DeviceType["Climate"] = "climate";
 	DeviceType["Button"] = "button";
 	/** Generic stateless event emitter — carries a device's EXACT declared
@@ -917,10 +917,6 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
 	/** 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";
-	/** A dumb plug-in stove or heater: a switch (and, with a meter, a power
-	*  reading) that only runs while the plug is on. Built from a smart plug;
-	*  the `timed-run` cap switches it off again after a chosen time. */
-	DeviceType["Heater"] = "heater";
 	/** Tumble dryer. Same plug-built running surface as {@link Washer}. */
 	DeviceType["Dryer"] = "dryer";
 	/** The physical bridge box of a vendor ecosystem (Velux KLF-200, and later
@@ -1140,6 +1136,27 @@ var DeviceRole = /* @__PURE__ */ function(DeviceRole) {
 	/** A smart plug: a `switch` whose source says it is an outlet (HA
 	*  `device_class: outlet`). The Alexa export shows it as a SMARTPLUG. */
 	DeviceRole["Outlet"] = "outlet";
+	/** A dumb plug-in stove or heater behind a switch: it runs only while the
+	*  switch is on. Offered `timed-run`, which switches it off again after a
+	*  chosen time. */
+	DeviceRole["SwitchHeater"] = "switch-heater";
+	/** A plain fan behind a switch (a smart plug powering it): drawn as a fan,
+	*  with the switch's on/off only. Speed or oscillation appear only when the
+	*  device also has a fan cap (D1033). */
+	DeviceRole["SwitchFan"] = "switch-fan";
+	/** Air conditioner / split unit: cooling, fan speed, louvres. */
+	DeviceRole["ClimateAc"] = "climate-ac";
+	/** Room thermostat: a setpoint and a room temperature. The default. */
+	DeviceRole["ClimateThermostat"] = "climate-thermostat";
+	/** Floor-heating zone actuator. */
+	DeviceRole["ClimateFloor"] = "climate-floor";
+	/** Radiator valve (thermostatic radiator head). */
+	DeviceRole["ClimateRadiator"] = "climate-radiator";
+	/** A heater with its own thermostat (stove, convector). */
+	DeviceRole["ClimateHeater"] = "climate-heater";
+	/** One heating/cooling circuit of a heat pump: a water loop with comfort /
+	*  eco setpoints and a heat/cool mode, no room sensor. */
+	DeviceRole["ClimateHeatPumpCircuit"] = "climate-heat-pump-circuit";
 	/** Generic motion / occupancy / moving event source. Distinct from
 	*  the camera accessory PirSensor role: that one is a camera child;
 	*  this is a standalone HA / 3rd-party motion sensor. */
@@ -6027,7 +6044,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-D_NpiLFP.mjs
+//#region ../types/dist/sleep-Bn346wCJ.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -11804,6 +11821,50 @@ var ACTUATOR_CAP_VOCABULARY = {
 					value: false
 				},
 				args: { oscillating: false }
+			},
+			{
+				id: "fan.horizontalOscillateOn",
+				method: "setOscillationAxis",
+				label: t("Horizontal oscillation on", "Oscillazione orizzontale attiva"),
+				phrase: t("Start the horizontal oscillation of {device}", "Attiva l’oscillazione orizzontale di {device}"),
+				icon: "move-horizontal",
+				args: {
+					axis: "horizontal",
+					oscillating: true
+				}
+			},
+			{
+				id: "fan.horizontalOscillateOff",
+				method: "setOscillationAxis",
+				label: t("Horizontal oscillation off", "Oscillazione orizzontale spenta"),
+				phrase: t("Stop the horizontal oscillation of {device}", "Ferma l’oscillazione orizzontale di {device}"),
+				icon: "move-horizontal",
+				args: {
+					axis: "horizontal",
+					oscillating: false
+				}
+			},
+			{
+				id: "fan.verticalOscillateOn",
+				method: "setOscillationAxis",
+				label: t("Vertical oscillation on", "Oscillazione verticale attiva"),
+				phrase: t("Start the vertical oscillation of {device}", "Attiva l’oscillazione verticale di {device}"),
+				icon: "move-vertical",
+				args: {
+					axis: "vertical",
+					oscillating: true
+				}
+			},
+			{
+				id: "fan.verticalOscillateOff",
+				method: "setOscillationAxis",
+				label: t("Vertical oscillation off", "Oscillazione verticale spenta"),
+				phrase: t("Stop the vertical oscillation of {device}", "Ferma l’oscillazione verticale di {device}"),
+				icon: "move-vertical",
+				args: {
+					axis: "vertical",
+					oscillating: false
+				}
 			}
 		],
 		state: [{
@@ -17444,7 +17505,7 @@ Object.freeze({
 	}
 });
 //#endregion
-//#region ../types/dist/implemented-methods-M5aguGon.mjs
+//#region ../types/dist/implemented-methods-5YMDeE3f.mjs
 /**
 * The ffmpeg build every CamStack node downloads, per platform and arch.
 *
@@ -44153,6 +44214,13 @@ var AutomationConditionOperatorSchema = _enum([
 	"in"
 ]);
 /**
+* The stable name of an event leaf. A path (`when.0.1`) moves when a row is
+* reordered; the id does not, so a `triggered-by` leaf keeps pointing at the
+* same row. Optional: a leaf nothing refers to needs none.
+*/
+var EVENT_LEAF_ID_RE = /^[A-Za-z0-9_-]{1,40}$/;
+var eventLeafId = { id: string().regex(EVENT_LEAF_ID_RE).optional() };
+/**
 * D8 compliance, and it is the reason a "becomes" leaf is not merely an event
 * subscription: it evaluates against the **state mirror**, which is reconciled,
 * and an event only WAKES the evaluation. A dropped event therefore DELAYS a
@@ -44160,6 +44228,7 @@ var AutomationConditionOperatorSchema = _enum([
 */
 var DeviceBecomesLeafSchema = object({
 	kind: literal("device-becomes"),
+	...eventLeafId,
 	deviceId: number$1().int().nonnegative(),
 	cap: string().min(1),
 	fieldPath: string().min(1),
@@ -44212,6 +44281,7 @@ var DeviceBecomesLeafSchema = object({
 });
 var DeviceEventLeafSchema = object({
 	kind: literal("device-event"),
+	...eventLeafId,
 	/** An `EventCategory` value. */
 	category: string().min(1),
 	deviceId: number$1().int().nonnegative().optional()
@@ -44224,18 +44294,24 @@ var DeviceEventLeafSchema = object({
 */
 var ScheduleLeafSchema = object({
 	kind: literal("schedule"),
+	...eventLeafId,
 	at: TimeSpecSchema.optional(),
 	days: array(WeekdayKeySchema).min(1).max(7).optional(),
 	/** @deprecated legacy cron — new schedules use `at`. */
 	cron: string().min(1).max(120).optional()
 }).refine((leaf) => leaf.at === void 0 !== (leaf.cron === void 0), { message: "a schedule names exactly one of `at` (a time spec) and `cron` (legacy)" }).refine((leaf) => leaf.days === void 0 || leaf.at !== void 0, { message: "`days` goes with `at`; a cron expression carries its own days" });
-var ManualLeafSchema = object({ kind: literal("manual") });
+var ManualLeafSchema = object({
+	kind: literal("manual"),
+	...eventLeafId
+});
 var IntervalLeafSchema = object({
 	kind: literal("interval"),
+	...eventLeafId,
 	minutes: number$1().int().min(1).max(1440)
 });
 var DetectionLeafSchema = object({
 	kind: literal("detection"),
+	...eventLeafId,
 	/** One macro class each, optionally narrowed by a label; a track of any listed subject fires. */
 	subjects: array(DetectionSubjectSchema).min(1),
 	deviceIds: array(number$1().int().nonnegative()).min(1),
@@ -44246,6 +44322,7 @@ var DetectionLeafSchema = object({
 });
 var StationaryLeafSchema = object({
 	kind: literal("stationary"),
+	...eventLeafId,
 	deviceIds: array(number$1().int().nonnegative()).min(1),
 	subjects: array(StationarySubjectSchema).min(1).optional(),
 	zones: array(string().min(1)).min(1).optional(),
@@ -44291,6 +44368,41 @@ var StationaryPresentLeafSchema = object({
 	minCount: number$1().int().positive().optional()
 });
 /**
+* True while the site-local clock is inside a daily window and/or on one of
+* the named days. `days` names the local day a window STARTS on, so
+* 22:00-06:00 on weekdays is still inside at 01:00 Saturday. A one-date spec
+* (`kind: 'date'`) is refused: only a clock time or a sun event makes a window
+* that repeats every day.
+*/
+var TimeIsLeafSchema = object({
+	kind: literal("time-is"),
+	between: object({
+		from: TimeSpecSchema,
+		to: TimeSpecSchema
+	}).optional(),
+	days: array(WeekdayKeySchema).min(1).max(7).optional()
+}).superRefine((leaf, ctx) => {
+	if (leaf.between === void 0 && leaf.days === void 0) ctx.addIssue({
+		code: "custom",
+		message: "a time-is leaf needs a between window, days, or both"
+	});
+	for (const end of ["from", "to"]) if (leaf.between?.[end].kind === "date") ctx.addIssue({
+		code: "custom",
+		message: "a one-date time cannot bound a daily window: use a clock time or a sun event",
+		path: ["between", end]
+	});
+});
+/**
+* True for the run that one of the named event leaves started. It reads the
+* run, not a device: in the tree it is judged against the leaf that fired, in
+* a step guard against the trigger the run carries. A run no event leaf
+* started (a state-only tree becoming true) is false.
+*/
+var TriggeredByLeafSchema = object({
+	kind: literal("triggered-by"),
+	leafIds: array(string().regex(EVENT_LEAF_ID_RE)).min(1).max(20)
+});
+/**
 * The escape hatch: the bounded expression engine over named device bindings.
 * Declared as a plain object so a discriminated union can read `kind`; the
 * author-time validation is the SAME function `ExpressionSourceSchema` runs.
@@ -44336,7 +44448,9 @@ var AutomationWhenSchema = lazy(() => discriminatedUnion("kind", [
 	StationaryLeafSchema,
 	DeviceIsLeafSchema,
 	StationaryPresentLeafSchema,
-	ExpressionLeafSchema
+	ExpressionLeafSchema,
+	TimeIsLeafSchema,
+	TriggeredByLeafSchema
 ]));
 var EVENT_KINDS = new Set([
 	"device-becomes",
@@ -44390,6 +44504,28 @@ function hasEventLeaves(node) {
 	});
 	return found;
 }
+/** The event leaves of the tree that carry an id, in tree order. */
+function identifiedEventLeaves(when) {
+	const found = [];
+	forEachLeaf(when, (leaf, path) => {
+		if (isEventLeaf(leaf) && leaf.id !== void 0) found.push({
+			id: leaf.id,
+			path,
+			leaf
+		});
+	});
+	return found;
+}
+/** Does the tree hold a `triggered-by` leaf? */
+function hasTriggeredByLeaves(when) {
+	let found = false;
+	forEachLeaf(when, (leaf) => {
+		if (leaf.kind === "triggered-by") found = true;
+	});
+	return found;
+}
+/** Why a `triggered-by` leaf is refused outside an automation: there is no trigger row to name. */
+var TRIGGERED_BY_NEEDS_AUTOMATION = "\"triggered by\" reads which trigger started an automation — an action or a scheduler has no trigger rows, so it could never be true here";
 function hasEmptyContainer(node) {
 	if (isLeaf(node)) return false;
 	if (node.kind === "not") return hasEmptyContainer(node.child);
@@ -44448,6 +44584,11 @@ function validateWhenTree(when) {
 	if (depth > 4) return `the rules nest ${depth} levels deep — the limit is 4. "not (any of …)" is the same as "all of (not …)", which is one level shallower`;
 	const leaves = countWhenLeaves(when);
 	if (leaves > 32) return `the rules use ${leaves} rows — the limit is 32`;
+	const seen = /* @__PURE__ */ new Set();
+	for (const entry of identifiedEventLeaves(when)) {
+		if (seen.has(entry.id)) return `two trigger rows share the id "${entry.id}" — an id names one row`;
+		seen.add(entry.id);
+	}
 	const need = eventNeed(when, "when", false);
 	if ("error" in need) return need.error;
 	const [first, second] = need.paths;
@@ -44738,7 +44879,18 @@ var GuardedCapStepSchema = AutomationCapStepBaseSchema.extend(stepGuardShape).re
 	message: "a domain target needs the vocabulary action it applies to (actionId)",
 	path: ["actionId"]
 }).refine((step) => step.else === void 0 || step.if !== void 0, elseNeedsIf);
-var ActionStepSchema = discriminatedUnion("kind", [GuardedWaitStepSchema, GuardedCapStepSchema]);
+/**
+* A step of a STANDALONE list (an action, a scheduler point, a preset): the
+* same two step kinds an automation runs, minus a guard that reads the
+* automation's trigger, which such a list does not have.
+*/
+var ActionStepSchema = discriminatedUnion("kind", [GuardedWaitStepSchema, GuardedCapStepSchema]).superRefine((step, ctx) => {
+	if (step.if !== void 0 && hasTriggeredByLeaves(step.if)) ctx.addIssue({
+		code: "custom",
+		message: TRIGGERED_BY_NEEDS_AUTOMATION,
+		path: ["if"]
+	});
+});
 var AutomationActionSchema = discriminatedUnion("kind", [
 	GuardedWaitStepSchema,
 	GuardedCapStepSchema,
@@ -44835,6 +44987,11 @@ var STATIONARY_DESCRIPTIONS = {
 	phase: "appeared or departed",
 	entryId: "the stopped object"
 };
+var BECOMES_DESCRIPTIONS = {
+	deviceId: "the device that changed",
+	from: "the value before the change, empty when it is not known",
+	to: "the value it changed to"
+};
 function describe$1(descriptions) {
 	return Object.entries(descriptions).map(([name, description]) => ({
 		name,
@@ -44843,6 +45000,10 @@ function describe$1(descriptions) {
 }
 describe$1(DETECTION_DESCRIPTIONS);
 describe$1(STATIONARY_DESCRIPTIONS);
+describe$1(BECOMES_DESCRIPTIONS).map((v) => v.name === "deviceId" ? {
+	...v,
+	hintKey: "becomesDeviceId"
+} : v);
 new Set(Object.values(COCO_TO_MACRO.mapping));
 /**
 * Schedulers (D983) — an entity that performs actions over the day.
@@ -44867,6 +45028,13 @@ var SchedulerStateTreeSchema = AutomationWhenSchema.superRefine((when, ctx) => {
 		});
 		return;
 	}
+	if (hasTriggeredByLeaves(when)) {
+		ctx.addIssue({
+			code: "custom",
+			message: TRIGGERED_BY_NEEDS_AUTOMATION
+		});
+		return;
+	}
 	const problem = validateWhenTree(when);
 	if (problem !== null) ctx.addIssue({
 		code: "custom",
@@ -45087,6 +45255,8 @@ var AutomationConditionTraceNodeSchema = object({
 		"device-is",
 		"expression",
 		"stationary-present",
+		"time-is",
+		"triggered-by",
 		"device-becomes",
 		"device-event",
 		"schedule",
@@ -45420,7 +45590,7 @@ object({
 	*  is irrelevant; the array is treated as a set by consumers. */
 	hiddenChildIds: array(number$1()).readonly()
 });
-DeviceType.Camera, DeviceType.Switch, DeviceType.Light, DeviceType.Sensor, DeviceType.Thermostat, DeviceType.Cover, DeviceType.Lock, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Generic, method(object({
+DeviceType.Camera, DeviceType.Switch, DeviceType.Light, DeviceType.Sensor, DeviceType.Climate, DeviceType.Cover, DeviceType.Lock, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Generic, method(object({
 	deviceId: number$1().int().nonnegative(),
 	childDeviceId: number$1().int().nonnegative(),
 	hidden: boolean()
@@ -47718,7 +47888,7 @@ var BATTERY_DEVICE_TYPES = [
 	DeviceType.Switch,
 	DeviceType.PetFeeder,
 	DeviceType.Container,
-	DeviceType.Thermostat,
+	DeviceType.Climate,
 	DeviceType.EventEmitter
 ];
 /** Generic Customize target for the percentage reading (D936). */
@@ -49481,7 +49651,14 @@ var climateControlCapability = {
 	scope: "device",
 	deviceNative: true,
 	mode: "singleton",
-	deviceTypes: [DeviceType.Thermostat, DeviceType.Climate],
+	deviceTypes: [DeviceType.Climate],
+	power: {
+		kind: "mode",
+		field: "mode",
+		offValue: "off",
+		set: "setMode",
+		lastField: "lastActiveMode"
+	},
 	methods: {
 		setMode: method(object({
 			deviceId: number$1().int().nonnegative(),
@@ -49866,6 +50043,7 @@ var CompositionProblemSchema = object({
 		"nested-field",
 		"missing-field",
 		"kind-mismatch",
+		"source-kind-mismatch",
 		"may-be-null",
 		"source-missing",
 		"source-unreadable",
@@ -49887,7 +50065,8 @@ var CompositionProblemSchema = object({
 		"command-method-unknown",
 		"command-source-unknown",
 		"command-input-unknown",
-		"command-input-missing"
+		"command-input-missing",
+		"power-source-is-actuator"
 	]),
 	path: string(),
 	message: string()
@@ -50925,6 +51104,13 @@ var mediaPlayerCapability = {
 	deviceNative: true,
 	mode: "singleton",
 	deviceTypes: [DeviceType.MediaPlayer],
+	power: {
+		kind: "methods",
+		field: "state",
+		offValues: ["off", "standby"],
+		on: "turnOn",
+		off: "turnOff"
+	},
 	methods: {
 		turnOn: optionalMethod(deviceOnly, _void(), {
 			kind: "mutation",
@@ -51055,7 +51241,7 @@ var mediaPlayerCapability = {
 		isMuted: { kind: "boolean" }
 	} }
 };
-DeviceType.Camera, DeviceType.Sensor, DeviceType.Button, DeviceType.Switch, DeviceType.PetFeeder, DeviceType.Container, DeviceType.Thermostat, DeviceType.EventEmitter, 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.PetFountain, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Heater, DeviceType.Dryer, DeviceType.Gateway, DeviceType.HeatPump, DeviceType.Camera, DeviceType.Fan, DeviceType.Lock, DeviceType.Camera, DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.PetFeeder, DeviceType.Heater, DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.PetFeeder, DeviceType.Heater, DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.PetFeeder, DeviceType.Heater, DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.PetFeeder, DeviceType.Heater, DeviceType.Gateway, DeviceType.Camera, DeviceType.Sensor, DeviceType.MediaPlayer, DeviceType.Vacuum, DeviceType.Generic, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.PetFountain, DeviceType.Fan, DeviceType.Humidifier, DeviceType.Climate, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer, DeviceType.WaterHeater, DeviceType.Humidifier, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.PetFeeder, DeviceType.Heater, DeviceType.MediaPlayer;
+DeviceType.Camera, DeviceType.Sensor, DeviceType.Button, DeviceType.Switch, DeviceType.PetFeeder, DeviceType.Container, DeviceType.Climate, DeviceType.EventEmitter, DeviceType.Camera, DeviceType.Hub, DeviceType.Light, DeviceType.Siren, DeviceType.Switch, DeviceType.Sensor, 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.PetFountain, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Dryer, DeviceType.Gateway, DeviceType.HeatPump, DeviceType.Camera, DeviceType.Fan, DeviceType.Fan, DeviceType.Fan, DeviceType.Fan, DeviceType.Fan, DeviceType.Fan, DeviceType.Fan, DeviceType.Fan, DeviceType.Fan, DeviceType.Fan, DeviceType.Lock, DeviceType.Camera, DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Climate, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.PetFeeder, DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Climate, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.PetFeeder, DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Climate, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.PetFeeder, DeviceType.Switch, DeviceType.Light, DeviceType.Fan, DeviceType.Climate, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.PetFeeder, DeviceType.Gateway, DeviceType.Camera, DeviceType.Sensor, DeviceType.MediaPlayer, DeviceType.Vacuum, DeviceType.Generic, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.PetFountain, DeviceType.Fan, DeviceType.Humidifier, DeviceType.Climate, DeviceType.WaterHeater, DeviceType.MediaPlayer, DeviceType.Washer, DeviceType.Dryer, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer, DeviceType.WaterHeater, DeviceType.Humidifier, DeviceType.Fan, DeviceType.Climate, DeviceType.PetFeeder, DeviceType.MediaPlayer;
 var NUMBER = {
 	kind: "fixed",
 	result: ["number"]
@@ -51138,7 +51324,7 @@ function numeric(input) {
 		}, ...alsoFrom === void 0 ? [] : [alsoFrom.accept]]
 	};
 }
-var CLIMATE_DEVICES = [DeviceType.Thermostat, DeviceType.Climate];
+var CLIMATE_DEVICES = [DeviceType.Climate];
 function binary(input) {
 	return {
 		...input,
@@ -51460,8 +51646,8 @@ var GROUP_TEMPLATES = [
 	actuator({
 		id: "climate",
 		summary: "Running when at least one thermostat or air conditioner is not off, or only when all of them are. Target temperature and fan are offered only when every device has them. A device that reports nothing is left out, never read as off.",
-		deviceType: DeviceType.Thermostat,
-		memberDeviceTypes: [DeviceType.Thermostat, DeviceType.Climate],
+		deviceType: DeviceType.Climate,
+		memberDeviceTypes: [DeviceType.Climate],
 		outputCap: "group-active",
 		outputField: "active",
 		member: {
@@ -51504,6 +51690,118 @@ function actuator(input) {
 new Map(GROUP_TEMPLATES.map((template) => [template.id, template]));
 DeviceFeature.LightColorRgb, DeviceFeature.LightColorHsv, DeviceFeature.LightColorMired;
 DeviceType.Camera;
+var PowerSourceRefusalReasonSchema = _enum([
+	"no-power-source",
+	"switch-missing",
+	"switch-offline",
+	"switch-unknown",
+	"restart-in-progress",
+	"switch-call-failed",
+	"switch-is-actuator"
+]);
+var PowerSourceActionResultSchema = discriminatedUnion("accepted", [object({ accepted: literal(true) }), object({
+	accepted: literal(false),
+	reason: PowerSourceRefusalReasonSchema,
+	/** One line for the operator, naming the switch. */
+	message: string()
+})]);
+var PowerSourceInfoSchema = object({
+	/** False when the device has no power source linked; the rest is then empty. */
+	linked: boolean(),
+	switchDeviceId: number$1().nullable(),
+	switchName: string().nullable(),
+	/** The switch's on/off state, or null when it is unknown. Never false for unknown (D393). */
+	switchOn: boolean().nullable(),
+	switchOnline: boolean().nullable(),
+	restartInProgress: boolean(),
+	offSeconds: number$1().int()
+});
+/** The composed slice: the switch state the link mirrors, plus the stored off time. */
+var PowerSourceStateSchema = object({
+	/** Null while the switch has not reported: unknown is never `false` (D393). */
+	switchOn: boolean().nullable(),
+	offSeconds: number$1().int(),
+	lastFetchedAt: number$1()
+});
+var POWER_SOURCE_DEVICE_TYPES = [
+	DeviceType.Gateway,
+	DeviceType.Camera,
+	DeviceType.Sensor,
+	DeviceType.MediaPlayer,
+	DeviceType.Vacuum,
+	DeviceType.Generic,
+	DeviceType.Washer,
+	DeviceType.Dryer,
+	DeviceType.Dishwasher,
+	DeviceType.PetFountain,
+	DeviceType.Fan,
+	DeviceType.Humidifier,
+	DeviceType.Climate,
+	DeviceType.WaterHeater
+];
+var powerSourceCustomize = {
+	version: 1,
+	targets: [{
+		id: "switch",
+		cardinality: "scalar",
+		vocabulary: {
+			cap: "power-source",
+			stateField: "switchOn"
+		},
+		deviceTypes: POWER_SOURCE_DEVICE_TYPES,
+		apply: "add",
+		path: "switchOn",
+		sources: [{
+			kind: "switch",
+			transforms: [{ kind: "identity" }]
+		}],
+		companions: [{
+			kind: "constant",
+			path: "offSeconds",
+			value: 10,
+			when: "add",
+			formerValues: [0]
+		}, {
+			kind: "clock",
+			path: "lastFetchedAt",
+			when: "always"
+		}],
+		sourceReport: { status: "assignment-status" }
+	}]
+};
+var deviceInput$2 = object({ deviceId: number$1().int().nonnegative() });
+var powerSourceCapability = {
+	name: "power-source",
+	scope: "device",
+	mode: "singleton",
+	deviceTypes: POWER_SOURCE_DEVICE_TYPES,
+	methods: {
+		getStatus: systemMethod(deviceInput$2, PowerSourceInfoSchema, { auth: "protected" }),
+		powerOn: systemMethod(deviceInput$2, PowerSourceActionResultSchema, {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		powerOff: systemMethod(deviceInput$2, PowerSourceActionResultSchema, {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		forceRestart: systemMethod(deviceInput$2, PowerSourceActionResultSchema, {
+			kind: "mutation",
+			auth: "protected"
+		})
+	},
+	runtimeState: PowerSourceStateSchema,
+	customize: powerSourceCustomize,
+	/**
+	* Runtime-state durability: **session** — mirrored from the linked switch on
+	* its next report; a restored value would outlive the reading it names.
+	*
+	* See `RuntimeStateDurability`. Enforced by
+	* `scripts/check-runtime-state-durability.ts`.
+	*/
+	durability: "session",
+	history: "none"
+};
 `${COMPOSED_DEVICE_STABLE_ID_PREFIX}`;
 /**
 * What a composition may BUILD on a device type (G2, D676): the caps a new
@@ -54038,8 +54336,14 @@ method(object({
 			"string",
 			"number",
 			"boolean",
-			"enum"
+			"enum",
+			"union"
 		]),
+		unionMembers: array(_enum([
+			"string",
+			"number",
+			"boolean"
+		])).optional(),
 		enumValues: array(string()).optional(),
 		item: boolean().optional(),
 		quantity: ReadingQuantitySchema.optional()
@@ -56667,8 +56971,85 @@ method(_void(), array(FailureContributionSchema).readonly());
 *   - `FanPreset` — preset selector
 *   - `FanDirection` — direction toggle (ceiling fans)
 *   - `FanOscillating` — oscillation toggle
+*
+* Per-axis oscillation (`oscillationAxes`, `setOscillationAxis`, D1034): an air
+* circulator sweeps horizontally and vertically, each axis with its own
+* switch, fixed angle, sweep bounds and limits. A provider may report them
+* natively; otherwise the OPERATOR links sibling devices to each field in
+* Customize (a `replace` over the fields listed in `overridable` — nothing is
+* linked or inferred by itself), and a write to a linked field is forwarded to
+* its source. `oscillating` stays the single summary flag: when axes exist it
+* means "any axis oscillates" (`anyAxisOscillating`).
 */
 var FanDirectionSchema = _enum(["forward", "reverse"]);
+var FAN_OSCILLATION_AXES = ["horizontal", "vertical"];
+var FanOscillationAxisNameSchema = _enum(FAN_OSCILLATION_AXES);
+var FanOscillationAxisFieldSchema = _enum([
+	"oscillating",
+	"angle",
+	"sweepFrom",
+	"sweepTo"
+]);
+/** The limits of one axis, read from the source that serves its angle. */
+var FAN_OSCILLATION_AXIS_LIMITS = [
+	"min",
+	"max",
+	"step"
+];
+/**
+* One oscillation axis. Every reading the device has not reported is `null`,
+* never `0` (D393): `0°` is a real position. Each leaf defaults to `null`, so
+* a slice that names only the leaves it knows (a Customize link of one field)
+* is still a whole axis.
+*/
+var FanOscillationAxisSchema = object({
+	/** Whether the axis sweeps. */
+	oscillating: boolean().nullable().default(null),
+	/** The fixed position (degrees) the axis holds when it does not sweep. */
+	angle: number$1().nullable().default(null),
+	/** The sweep bounds (degrees): left → right, bottom → top. */
+	sweepFrom: number$1().nullable().default(null),
+	sweepTo: number$1().nullable().default(null),
+	/** The angles the axis accepts. Null when the device states none. */
+	min: number$1().nullable().default(null),
+	max: number$1().nullable().default(null),
+	step: number$1().nullable().default(null)
+});
+/** Both axes; an axis the device does not have is `null`. */
+var FanOscillationAxesSchema = object({
+	horizontal: FanOscillationAxisSchema.nullable().default(null),
+	vertical: FanOscillationAxisSchema.nullable().default(null)
+});
+var FanOscillationAxisRefusalSchema = _enum([
+	"nothing-to-set",
+	"axis-not-linked",
+	"out-of-range",
+	"source-gone",
+	"source-unknown",
+	"source-call-failed"
+]);
+var FanOscillationAxisResultSchema = discriminatedUnion("status", [object({ status: literal("applied") }), object({
+	status: literal("refused"),
+	reason: FanOscillationAxisRefusalSchema,
+	/** The field at fault, when one is. */
+	field: FanOscillationAxisFieldSchema.optional(),
+	/** One line for the operator, naming the axis, the field and the source. */
+	detail: string(),
+	/** Fields that DID land before the refusal (writes run in order, stop at the first failure). */
+	applied: array(FanOscillationAxisFieldSchema)
+})]);
+var SetOscillationAxisInputSchema = object({
+	deviceId: number$1().int().nonnegative(),
+	axis: FanOscillationAxisNameSchema,
+	oscillating: boolean().optional(),
+	angle: number$1().optional(),
+	sweepFrom: number$1().optional(),
+	sweepTo: number$1().optional()
+});
+/** The state path of one axis field: `oscillationAxes.<axis>.<field>`. */
+function fanAxisPath(axis, field) {
+	return `oscillationAxes.${axis}.${field}`;
+}
 var FanControlStatusSchema = object({
 	/** Active speed as 0..100 inclusive. Null when the device has no
 	*  speed surface (single-speed fan). */
@@ -56687,9 +57068,102 @@ var FanControlStatusSchema = object({
 	/** Oscillation toggle. Null when the device has no oscillation
 	*  surface. */
 	oscillating: boolean().nullable(),
+	/**
+	* Per-axis oscillation (air circulators). Absent when the device has no
+	* per-axis surface and nothing is linked in Customize.
+	*/
+	oscillationAxes: FanOscillationAxesSchema.optional(),
 	/** Ms epoch when the slice was last updated. */
 	lastChangedAt: number$1()
 });
+var FAN_CUSTOMIZE_DEVICE_TYPES = [DeviceType.Fan];
+/** The Customize section the axis targets are listed under. */
+var AXES_SECTION = "oscillation-axes";
+function axisOscillatingTarget(axis) {
+	return {
+		id: `${axis}-oscillating`,
+		cardinality: "scalar",
+		vocabulary: {
+			cap: "fan-control",
+			stateField: "oscillating"
+		},
+		deviceTypes: FAN_CUSTOMIZE_DEVICE_TYPES,
+		apply: "replace",
+		section: AXES_SECTION,
+		path: fanAxisPath(axis, "oscillating"),
+		sources: [{
+			kind: "switch",
+			transforms: [{ kind: "identity" }]
+		}],
+		sourceReport: { status: "assignment-status" }
+	};
+}
+/**
+* A numeric axis field. The `angle` link also carries the axis limits, read
+* from the SAME linked control's own range (`min`/`max`/`step`), so the limits
+* are the source's, never guessed.
+*/
+function axisNumericTarget(axis, field) {
+	const base = {
+		id: `${axis}-${field}`,
+		cardinality: "scalar",
+		vocabulary: { cap: "fan-control" },
+		deviceTypes: FAN_CUSTOMIZE_DEVICE_TYPES,
+		apply: "replace",
+		section: AXES_SECTION,
+		path: fanAxisPath(axis, field),
+		sources: [{
+			kind: "numeric",
+			transforms: [{ kind: "identity" }]
+		}],
+		sourceReport: { status: "assignment-status" }
+	};
+	if (field !== "angle") return base;
+	return {
+		...base,
+		companions: FAN_OSCILLATION_AXIS_LIMITS.map((limit) => ({
+			kind: "source-field",
+			path: fanAxisPath(axis, limit),
+			field: limit
+		}))
+	};
+}
+var AXIS_TARGETS = FAN_OSCILLATION_AXES.flatMap((axis) => [
+	axisOscillatingTarget(axis),
+	axisNumericTarget(axis, "angle"),
+	axisNumericTarget(axis, "sweepFrom"),
+	axisNumericTarget(axis, "sweepTo")
+]);
+/** A select (an enum control) the operator links to the fan's `preset`. */
+var PRESET_TARGET = {
+	id: "preset",
+	cardinality: "scalar",
+	vocabulary: { cap: "fan-control" },
+	deviceTypes: FAN_CUSTOMIZE_DEVICE_TYPES,
+	apply: "replace",
+	path: "preset",
+	sources: [{
+		kind: "field",
+		valueKinds: ["string"],
+		transforms: [{ kind: "identity" }]
+	}],
+	sourceReport: { status: "assignment-status" }
+};
+var FAN_CONTROL_TARGETS = [...AXIS_TARGETS, PRESET_TARGET];
+/**
+* Customize (D1034): the fan already serves `fan-control` natively, so every
+* target is a `replace` over a field listed in `overridable` — the axis leaves
+* and `preset`, nothing else. Nothing is pre-linked: the operator picks each
+* source (D356).
+*/
+var fanControlCustomize = {
+	version: 1,
+	overridable: FAN_CONTROL_TARGETS.map((target) => ({
+		path: target.path,
+		by: target.id
+	})),
+	targets: FAN_CONTROL_TARGETS
+};
 var fanControlCapability = {
 	name: "fan-control",
 	scope: "device",
@@ -56724,6 +57198,18 @@ var fanControlCapability = {
 		}), _void(), {
 			kind: "mutation",
 			auth: "protected"
+		}),
+		/**
+		* Sets one oscillation axis: its switch, fixed angle and/or sweep bounds.
+		* Fields left out are untouched. A field linked in Customize is forwarded
+		* to its linked source (D1034); otherwise the native provider serves it;
+		* neither → `axis-not-linked`. Ranges are checked against the axis limits
+		* before anything is written; writes run in order and stop at the first
+		* failure, which the result names.
+		*/
+		setOscillationAxis: optionalMethod(SetOscillationAxisInputSchema, FanOscillationAxisResultSchema, {
+			kind: "mutation",
+			auth: "protected"
 		})
 	},
 	status: {
@@ -56735,6 +57221,7 @@ var fanControlCapability = {
 	* sliders read `speed` for live updates.
 	*/
 	runtimeState: FanControlStatusSchema,
+	customize: fanControlCustomize,
 	/**
 	* Runtime-state durability: **session** — as `brightness`.
 	*
@@ -56754,16 +57241,33 @@ var fanControlCapability = {
 		oscillating: { kind: "boolean" }
 	} }
 };
+/** One axis as a preset wants it; an absent field is left as it is. */
+var FanPresetAxisSchema = object({
+	oscillating: boolean().optional(),
+	angle: number$1().optional(),
+	sweepFrom: number$1().optional(),
+	sweepTo: number$1().optional()
+});
+/** The fan-control state a preset sets; an absent field is left as it is. */
+var FanPresetStateSchema = object({
+	speed: number$1().min(0).max(100).optional(),
+	/** The fan's own preset mode (or the linked select's option). */
+	preset: string().min(1).optional(),
+	direction: FanDirectionSchema.optional(),
+	oscillationAxes: object({
+		horizontal: FanPresetAxisSchema.optional(),
+		vertical: FanPresetAxisSchema.optional()
+	}).optional()
+});
 var FanPresetSchema = object({
 	/** Stable key; never reused after a delete within one device's list. */
 	id: string().min(1).max(64),
 	/** What the operator and a voice assistant call it. */
 	name: string().trim().min(1).max(40),
-	steps: array(ActionStepSchema).min(1).max(20)
+	state: FanPresetStateSchema
 });
 var FanPresetsRefusalSchema = _enum([
-	"not-sibling",
-	"bad-target",
+	"empty-state",
 	"duplicate-name",
 	"duplicate-id",
 	"too-many",
@@ -56775,72 +57279,55 @@ var FanPresetsSetResultSchema = discriminatedUnion("status", [object({
 }), object({
 	status: literal("refused"),
 	reason: FanPresetsRefusalSchema,
-	/** Names the preset and step at fault. */
+	/** Names the preset at fault. */
 	detail: string()
 })]);
-var FanPresetStepResultSchema = object({
-	index: number$1().int().nonnegative(),
+var FanPresetFieldResultSchema = object({
+	/** The state path: `speed`, `preset`, `direction`, `oscillationAxes.horizontal.angle`. */
+	field: string(),
 	outcome: _enum([
 		"applied",
 		"failed",
 		"not-run",
 		"refused"
 	]),
-	deviceId: number$1().int().nonnegative().optional(),
-	cap: string().optional(),
-	method: string().optional(),
 	/** The cause, for every outcome but `applied`. */
 	message: string().optional()
 });
 var FanPresetApplyResultSchema = object({
-	/** `applied`: every step ran. `partial`: some ran, one failed. `refused`: nothing ran. */
+	/** `applied`: every field landed. `partial`: some did, one did not. `refused`: nothing ran. */
 	status: _enum([
 		"applied",
 		"partial",
 		"refused"
 	]),
-	steps: array(FanPresetStepResultSchema)
+	fields: array(FanPresetFieldResultSchema)
 });
 var FanCaptureFieldSchema = _enum([
 	"speed",
-	"oscillating",
 	"direction",
-	"preset"
+	"preset",
+	"oscillationAxes"
 ]);
-var FanCaptureOmissionSchema = object({
-	/** A fan field (`speed`) or `step <n>` for a sibling step. */
-	what: string(),
-	/** Why no value was taken: unknown reading (never stored as 0, D393), or a step that cannot be read. */
-	reason: string()
-});
-var FanCaptureItemSchema = object({
-	group: _enum([
-		"fan",
-		"oscillation",
-		"angles"
-	]),
-	/** What the step sets, in the operator's words (a device name, a fan field). */
-	label: string()
-});
 var FanPresetCaptureResultSchema = object({
-	/** The steps filled from the device's current values; NOT saved. */
-	steps: array(ActionStepSchema),
-	/** One entry per step, same order: its review group and label. */
-	items: array(FanCaptureItemSchema),
-	omitted: array(FanCaptureOmissionSchema)
+	/** The fan's CURRENT fan-control state, as a preset; NOT saved. */
+	state: FanPresetStateSchema,
+	omitted: array(object({
+		/** A state path (`speed`, `oscillationAxes.vertical.angle`). */
+		what: string(),
+		/** Why no value was taken: an unknown reading is never stored as 0 (D393). */
+		reason: string()
+	}))
 });
-var deviceInput$2 = object({ deviceId: number$1().int().nonnegative() });
+var deviceInput$1 = object({ deviceId: number$1().int().nonnegative() });
 DeviceType.Fan;
-method(deviceInput$2, array(FanPresetSchema), { auth: "protected" }), method(deviceInput$2.extend({ presets: array(FanPresetSchema).max(12) }), FanPresetsSetResultSchema, {
+method(deviceInput$1, array(FanPresetSchema), { auth: "protected" }), method(deviceInput$1.extend({ presets: array(FanPresetSchema).max(12) }), FanPresetsSetResultSchema, {
 	kind: "mutation",
 	auth: "admin"
-}), method(deviceInput$2.extend({ presetId: string().min(1) }), FanPresetApplyResultSchema, {
+}), method(deviceInput$1.extend({ presetId: string().min(1) }), FanPresetApplyResultSchema, {
 	kind: "mutation",
 	auth: "protected"
-}), method(deviceInput$2.extend({
-	fields: array(FanCaptureFieldSchema).optional(),
-	steps: array(ActionStepSchema).max(20).default([])
-}), FanPresetCaptureResultSchema, { auth: "protected" });
+}), method(deviceInput$1.extend({ fields: array(FanCaptureFieldSchema).optional() }), FanPresetCaptureResultSchema, { auth: "protected" });
 /**
 * Per-device feature/identity probe slice. Holds the runtime-resolved
 * truth about what a device CAN do — which the kernel uses to:
@@ -57052,8 +57539,7 @@ var groupActiveCapability = {
 		DeviceType.Valve,
 		DeviceType.Lock,
 		DeviceType.MediaPlayer,
-		DeviceType.Climate,
-		DeviceType.Thermostat
+		DeviceType.Climate
 	],
 	methods: {},
 	status: {
@@ -57095,7 +57581,6 @@ var groupCommandsCapability = {
 		DeviceType.Valve,
 		DeviceType.Lock,
 		DeviceType.MediaPlayer,
-		DeviceType.Thermostat,
 		DeviceType.Climate
 	],
 	methods: {},
@@ -57151,7 +57636,6 @@ var groupStatusCapability = {
 		DeviceType.Valve,
 		DeviceType.Lock,
 		DeviceType.MediaPlayer,
-		DeviceType.Thermostat,
 		DeviceType.Climate
 	],
 	methods: {},
@@ -57507,7 +57991,7 @@ var heatingValveCapability = {
 	scope: "device",
 	deviceNative: true,
 	mode: "singleton",
-	deviceTypes: [DeviceType.Thermostat],
+	deviceTypes: [DeviceType.Climate],
 	methods: {},
 	status: {
 		schema: HeatingValveStatusSchema,
@@ -57537,13 +58021,18 @@ var heatingValveCapability = {
 * retried in a loop - D49); a future one is re-armed.
 *
 * What a device may be run for, and for how long at most, is per device type
-* ({@link TIMED_RUN_LIMITS}): the maximum is a safety bound, not a preference,
+* and role ({@link timedRunLimitOf}): the maximum is a safety bound, not a preference,
 * so a request above it is REFUSED with a typed reason, never clamped.
 */
 var TimedRunUnitSchema = _enum(["s", "min"]);
 _enum(["switch", "pet-fountain"]);
-DeviceType.Heater, DeviceType.PetFountain;
-var TIMED_RUN_DEVICE_TYPES = [DeviceType.Heater, DeviceType.PetFountain];
+/**
+* The device types `timed-run` may be offered on. A `switch` is narrowed by
+* role ({@link TIMED_RUN_DEVICE_ROLES}): only a plug-in heater runs on a timer.
+*/
+var TIMED_RUN_DEVICE_TYPES = [DeviceType.Switch, DeviceType.PetFountain];
+/** The roles that make a device of these types timed-run-able (D1033). */
+var TIMED_RUN_DEVICE_ROLES = { [DeviceType.Switch]: [DeviceRole.SwitchHeater] };
 /** One duration, as the one-tap run asks for it. */
 var TimedRunQuickRunSchema = object({
 	duration: number$1().positive().finite(),
@@ -57593,6 +58082,7 @@ var timedRunCapability = {
 	kind: "wrapper",
 	defaultActive: true,
 	deviceTypes: TIMED_RUN_DEVICE_TYPES,
+	deviceRoles: TIMED_RUN_DEVICE_ROLES,
 	deviceConfig: { ui: {
 		kind: "derived-form",
 		builderId: "timed-run",
@@ -57753,8 +58243,8 @@ var HeroSceneSchema = object({
 	/** 0..1: volume, cover position, cycle progress. */
 	level: number$1().min(0).max(1).nullable()
 });
-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.HeatPump, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.PetFountain, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Heater, DeviceType.Dryer, DeviceType.Gateway;
-DeviceRole.Siren, DeviceRole.Floodlight, DeviceRole.Spotlight, DeviceRole.PirSensor, DeviceRole.Chime, DeviceRole.Autotrack, DeviceRole.Nightvision, DeviceRole.PrivacyMask, DeviceRole.Doorbell, DeviceRole.CoverBlind, DeviceRole.CoverShutter, DeviceRole.CoverAwning, DeviceRole.CoverCurtain, DeviceRole.CoverGarage, DeviceRole.CoverGate, DeviceRole.CoverDoor, DeviceRole.CoverWindow, DeviceRole.BinaryHelper, DeviceRole.Outlet, DeviceRole.MotionSensor, DeviceRole.ContactSensor, DeviceRole.LeakSensor, DeviceRole.SmokeSensor, DeviceRole.COSensor, DeviceRole.GasSensor, DeviceRole.TamperSensor, DeviceRole.VibrationSensor, DeviceRole.ConnectivitySensor, DeviceRole.SoundSensor, DeviceRole.BinarySensor, DeviceRole.TemperatureSensor, DeviceRole.HumiditySensor, DeviceRole.AmbientLightSensor, DeviceRole.PressureSensor, DeviceRole.WindSensor, DeviceRole.RainSensor, DeviceRole.UvSensor, DeviceRole.SolarRadiationSensor, DeviceRole.SoilMoistureSensor, DeviceRole.PowerSensor, DeviceRole.EnergySensor, DeviceRole.VoltageSensor, DeviceRole.CurrentSensor, DeviceRole.AirQualitySensor, DeviceRole.BatterySensor, DeviceRole.NumericSensor, DeviceRole.EnumSensor, DeviceRole.DateTimeSensor, DeviceRole.GenericSensor, DeviceRole.NumericControl, DeviceRole.SelectControl, DeviceRole.TextControl, DeviceRole.DateTimeControl, DeviceRole.MobilePushNotifier, DeviceRole.MessagingNotifier, DeviceRole.EmailNotifier, DeviceRole.GenericNotifier, DeviceRole.IrTransmitter;
+DeviceType.Camera, DeviceType.Hub, DeviceType.Light, DeviceType.Siren, DeviceType.Switch, DeviceType.Sensor, 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.HeatPump, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.PetFountain, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Dryer, DeviceType.Gateway;
+DeviceRole.Siren, DeviceRole.Floodlight, DeviceRole.Spotlight, DeviceRole.PirSensor, DeviceRole.Chime, DeviceRole.Autotrack, DeviceRole.Nightvision, DeviceRole.PrivacyMask, DeviceRole.Doorbell, DeviceRole.CoverBlind, DeviceRole.CoverShutter, DeviceRole.CoverAwning, DeviceRole.CoverCurtain, DeviceRole.CoverGarage, DeviceRole.CoverGate, DeviceRole.CoverDoor, DeviceRole.CoverWindow, DeviceRole.BinaryHelper, DeviceRole.Outlet, DeviceRole.SwitchHeater, DeviceRole.SwitchFan, DeviceRole.ClimateAc, DeviceRole.ClimateThermostat, DeviceRole.ClimateFloor, DeviceRole.ClimateRadiator, DeviceRole.ClimateHeater, DeviceRole.ClimateHeatPumpCircuit, DeviceRole.MotionSensor, DeviceRole.ContactSensor, DeviceRole.LeakSensor, DeviceRole.SmokeSensor, DeviceRole.COSensor, DeviceRole.GasSensor, DeviceRole.TamperSensor, DeviceRole.VibrationSensor, DeviceRole.ConnectivitySensor, DeviceRole.SoundSensor, DeviceRole.BinarySensor, DeviceRole.TemperatureSensor, DeviceRole.HumiditySensor, DeviceRole.AmbientLightSensor, DeviceRole.PressureSensor, DeviceRole.WindSensor, DeviceRole.RainSensor, DeviceRole.UvSensor, DeviceRole.SolarRadiationSensor, DeviceRole.SoilMoistureSensor, DeviceRole.PowerSensor, DeviceRole.EnergySensor, DeviceRole.VoltageSensor, DeviceRole.CurrentSensor, DeviceRole.AirQualitySensor, DeviceRole.BatterySensor, DeviceRole.NumericSensor, DeviceRole.EnumSensor, DeviceRole.DateTimeSensor, DeviceRole.GenericSensor, DeviceRole.NumericControl, DeviceRole.SelectControl, DeviceRole.TextControl, DeviceRole.DateTimeControl, DeviceRole.MobilePushNotifier, DeviceRole.MessagingNotifier, DeviceRole.EmailNotifier, DeviceRole.GenericNotifier, DeviceRole.IrTransmitter;
 /** A string in both languages, as the cap vocabulary writes it (D920): no `t()` in the model. */
 var HeroTextSchema = object({
 	en: string(),
@@ -58139,8 +58629,8 @@ var HeroRowModelSchema = object({
 	extras: array(HeroControlSchema).max(2).optional(),
 	trailing: HeroFactSchema.nullable()
 });
-DeviceType.Climate, DeviceType.Thermostat;
-DeviceType.Climate, DeviceType.Thermostat, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer;
+DeviceType.Climate;
+DeviceType.Climate, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer;
 /**
 * hero-layout — what a device's hero says (D1023). Read-only: the FIXED
 * layouts live in `@camstack/types` and nothing here stores or edits one.
@@ -58172,7 +58662,10 @@ method(heroInput, HeroModelSchema.nullable(), {
 }), method(rowModelsInput, array(HeroRowModelSchema.nullable()), {
 	auth: "protected",
 	role: "viewer"
-}), method(object({ deviceType: string() }), HeroLayoutRowsSchema, {
+}), method(object({
+	deviceType: string(),
+	role: string().nullable().optional()
+}), HeroLayoutRowsSchema, {
 	auth: "protected",
 	role: "viewer"
 });
@@ -58219,6 +58712,11 @@ var humidifierCapability = {
 	deviceNative: true,
 	mode: "singleton",
 	deviceTypes: [DeviceType.Humidifier],
+	power: {
+		kind: "field",
+		field: "on",
+		set: "setOn"
+	},
 	methods: {
 		setOn: method(object({
 			deviceId: number$1().int().nonnegative(),
@@ -58292,7 +58790,7 @@ var humiditySensorCapability = {
 	scope: "device",
 	deviceNative: true,
 	mode: "singleton",
-	deviceTypes: [DeviceType.Sensor, DeviceType.Thermostat],
+	deviceTypes: [DeviceType.Sensor, DeviceType.Climate],
 	methods: {},
 	status: {
 		schema: HumiditySensorStatusSchema,
@@ -71964,6 +72462,11 @@ var petFountainCapability = {
 	deviceNative: true,
 	mode: "singleton",
 	deviceTypes: [DeviceType.PetFountain],
+	power: {
+		kind: "field",
+		field: "pumpRunning",
+		set: "setPump"
+	},
 	methods: { 
 	/** Start or stop the pump. */
 setPump: method(object({
@@ -73539,7 +74042,6 @@ var POWER_METER_DEVICE_TYPES = [
 	DeviceType.Light,
 	DeviceType.Fan,
 	DeviceType.Climate,
-	DeviceType.Thermostat,
 	DeviceType.Humidifier,
 	DeviceType.WaterHeater,
 	DeviceType.MediaPlayer,
@@ -73548,8 +74050,7 @@ var POWER_METER_DEVICE_TYPES = [
 	DeviceType.Dishwasher,
 	DeviceType.Vacuum,
 	DeviceType.LawnMower,
-	DeviceType.PetFeeder,
-	DeviceType.Heater
+	DeviceType.PetFeeder
 ];
 /** Everything but a bare `Sensor`: a sensor that takes its reading from another sensor adds nothing. */
 var POWER_METER_CUSTOMIZE_DEVICE_TYPES = POWER_METER_DEVICE_TYPES.filter((type) => type !== DeviceType.Sensor);
@@ -73662,117 +74163,6 @@ var powerMeterCapability = {
 	volatileStateFields: ["lastFetchedAt"],
 	customize: powerMeterCustomize
 };
-var PowerSourceRefusalReasonSchema = _enum([
-	"no-power-source",
-	"switch-missing",
-	"switch-offline",
-	"switch-unknown",
-	"restart-in-progress",
-	"switch-call-failed"
-]);
-var PowerSourceActionResultSchema = discriminatedUnion("accepted", [object({ accepted: literal(true) }), object({
-	accepted: literal(false),
-	reason: PowerSourceRefusalReasonSchema,
-	/** One line for the operator, naming the switch. */
-	message: string()
-})]);
-var PowerSourceInfoSchema = object({
-	/** False when the device has no power source linked; the rest is then empty. */
-	linked: boolean(),
-	switchDeviceId: number$1().nullable(),
-	switchName: string().nullable(),
-	/** The switch's on/off state, or null when it is unknown. Never false for unknown (D393). */
-	switchOn: boolean().nullable(),
-	switchOnline: boolean().nullable(),
-	restartInProgress: boolean(),
-	offSeconds: number$1().int()
-});
-/** The composed slice: the switch state the link mirrors, plus the stored off time. */
-var PowerSourceStateSchema = object({
-	/** Null while the switch has not reported: unknown is never `false` (D393). */
-	switchOn: boolean().nullable(),
-	offSeconds: number$1().int(),
-	lastFetchedAt: number$1()
-});
-var POWER_SOURCE_DEVICE_TYPES = [
-	DeviceType.Gateway,
-	DeviceType.Camera,
-	DeviceType.Sensor,
-	DeviceType.MediaPlayer,
-	DeviceType.Vacuum,
-	DeviceType.Generic,
-	DeviceType.Washer,
-	DeviceType.Dryer,
-	DeviceType.Dishwasher,
-	DeviceType.PetFountain,
-	DeviceType.Fan,
-	DeviceType.Humidifier,
-	DeviceType.Climate,
-	DeviceType.WaterHeater
-];
-var powerSourceCustomize = {
-	version: 1,
-	targets: [{
-		id: "switch",
-		cardinality: "scalar",
-		vocabulary: {
-			cap: "power-source",
-			stateField: "switchOn"
-		},
-		deviceTypes: POWER_SOURCE_DEVICE_TYPES,
-		apply: "add",
-		path: "switchOn",
-		sources: [{
-			kind: "switch",
-			transforms: [{ kind: "identity" }]
-		}],
-		companions: [{
-			kind: "constant",
-			path: "offSeconds",
-			value: 10,
-			when: "add",
-			formerValues: [0]
-		}, {
-			kind: "clock",
-			path: "lastFetchedAt",
-			when: "always"
-		}],
-		sourceReport: { status: "assignment-status" }
-	}]
-};
-var deviceInput$1 = object({ deviceId: number$1().int().nonnegative() });
-var powerSourceCapability = {
-	name: "power-source",
-	scope: "device",
-	mode: "singleton",
-	deviceTypes: POWER_SOURCE_DEVICE_TYPES,
-	methods: {
-		getStatus: systemMethod(deviceInput$1, PowerSourceInfoSchema, { auth: "protected" }),
-		powerOn: systemMethod(deviceInput$1, PowerSourceActionResultSchema, {
-			kind: "mutation",
-			auth: "protected"
-		}),
-		powerOff: systemMethod(deviceInput$1, PowerSourceActionResultSchema, {
-			kind: "mutation",
-			auth: "protected"
-		}),
-		forceRestart: systemMethod(deviceInput$1, PowerSourceActionResultSchema, {
-			kind: "mutation",
-			auth: "protected"
-		})
-	},
-	runtimeState: PowerSourceStateSchema,
-	customize: powerSourceCustomize,
-	/**
-	* Runtime-state durability: **session** — mirrored from the linked switch on
-	* its next report; a restored value would outlive the reading it names.
-	*
-	* See `RuntimeStateDurability`. Enforced by
-	* `scripts/check-runtime-state-durability.ts`.
-	*/
-	durability: "session",
-	history: "none"
-};
 /**
 * Presence cap. Models HA `person.*` and `device_tracker.*` entities
 * on `DeviceType.Presence`. Read-only — no setters: presence is
@@ -77247,9 +77637,7 @@ var RUNNING_CUSTOMIZE_DEVICE_TYPES = [
 	DeviceType.Humidifier,
 	DeviceType.Fan,
 	DeviceType.Climate,
-	DeviceType.Thermostat,
-	DeviceType.PetFeeder,
-	DeviceType.Heater
+	DeviceType.PetFeeder
 ];
 var runningStateCapability = {
 	name: "running-state",
@@ -79337,8 +79725,7 @@ var switchCapability = {
 		DeviceType.Switch,
 		DeviceType.Siren,
 		DeviceType.Light,
-		DeviceType.Fan,
-		DeviceType.Heater
+		DeviceType.Fan
 	],
 	methods: { setState: method(object({
 		deviceId: number$1(),
@@ -80032,7 +80419,7 @@ var temperatureSensorCapability = {
 	scope: "device",
 	deviceNative: true,
 	mode: "singleton",
-	deviceTypes: [DeviceType.Sensor, DeviceType.Thermostat],
+	deviceTypes: [DeviceType.Sensor, DeviceType.Climate],
 	methods: {},
 	status: {
 		schema: TemperatureSensorStatusSchema,
@@ -81679,6 +82066,13 @@ var waterHeaterCapability = {
 	deviceNative: true,
 	mode: "singleton",
 	deviceTypes: [DeviceType.WaterHeater],
+	power: {
+		kind: "mode",
+		field: "operationMode",
+		offValue: "off",
+		set: "setOperationMode",
+		lastField: "lastActiveMode"
+	},
 	methods: {
 		setTargetTemp: method(object({
 			deviceId: number$1().int().nonnegative(),
@@ -84370,15 +84764,16 @@ var BaseDeviceProvider = class extends BaseAddon {
 		});
 		const meta = await this.ctx.api.deviceManager.loadMeta.query({ deviceId: id });
 		if (meta === null) throw new Error(`${this.providerName}: no persisted meta for "${stableId}" (id ${id}) — cannot reload`);
-		const deviceType = Object.values(DeviceType).find((t) => t === meta.type);
-		const Class = deviceType !== void 0 ? this.deviceClasses[deviceType] : void 0;
+		const Class = this.deviceClassForRow({
+			type: meta.type,
+			stableId
+		});
 		if (!Class) throw new Error(`${this.providerName}: no device class for type "${meta.type}" — "${stableId}" is an accessory child; reload its parent instead`);
 		await devices.create(stableId, Class, {}, meta.parentDeviceId ?? null);
 		const rows = await this.ctx.api.deviceManager.listPersistedByAddon.query({ addonId: this.addonId });
 		for (const row of rows) {
 			if (row.parentDeviceId !== id) continue;
-			const childType = Object.values(DeviceType).find((t) => t === row.type);
-			const ChildClass = childType !== void 0 ? this.deviceClasses[childType] : void 0;
+			const ChildClass = this.deviceClassForRow(row);
 			if (!ChildClass) continue;
 			try {
 				await devices.create(row.stableId, ChildClass, {}, id);
@@ -84405,6 +84800,16 @@ var BaseDeviceProvider = class extends BaseAddon {
 		return { deviceId: id };
 	}
 	/**
+	* The class a PERSISTED row is rebuilt with. Default: by type, from
+	* `deviceClasses`. A provider whose distinct devices share one type (D1033:
+	* a radiator valve and a room climate are both `climate`) overrides this
+	* and tells them apart by the row's stable id or config.
+	*/
+	deviceClassForRow(row) {
+		const type = Object.values(DeviceType).find((t) => t === row.type);
+		return type !== void 0 ? this.deviceClasses[type] : void 0;
+	}
+	/**
 	* Restore devices from persisted state. Two-pass:
 	*
 	* 1. **Top-level pass** — invokes `kernel.devices.create()` for every
@@ -84465,7 +84870,7 @@ var BaseDeviceProvider = class extends BaseAddon {
 				restored.add(saved.id);
 				return;
 			}
-			const Class = this.deviceClasses[saved.type];
+			const Class = this.deviceClassForRow(saved);
 			if (!Class) throw new Error(`no device class registered for type "${saved.type}"`);
 			if (saved.parentDeviceId !== null && !restored.has(saved.parentDeviceId)) throw new Error(`parent device ${saved.parentDeviceId} not restored`);
 			await this.healSavedConfig(saved, savedDevices);
@@ -84482,7 +84887,7 @@ var BaseDeviceProvider = class extends BaseAddon {
 		};
 		const topLevel = savedDevices.filter((saved) => saved.parentDeviceId === null);
 		const restoreOne = async (saved) => {
-			if (!this.deviceClasses[saved.type]) {
+			if (!this.deviceClassForRow(saved)) {
 				this.ctx.logger.warn("No device class registered for restored type — skipping", {
 					tags: {
 						deviceId: saved.id,
@@ -84521,7 +84926,7 @@ var BaseDeviceProvider = class extends BaseAddon {
 		const failedTopLevelIds = new Set(failures.map((failure) => failure.saved.id));
 		const childRows = savedDevices.filter((s) => s.parentDeviceId !== null);
 		for (const saved of childRows) {
-			if (!this.deviceClasses[saved.type]) continue;
+			if (!this.deviceClassForRow(saved)) continue;
 			if (saved.parentDeviceId === null) continue;
 			if (restored.has(saved.parentDeviceId)) {
 				try {
@@ -84575,7 +84980,9 @@ var BaseDeviceProvider = class extends BaseAddon {
 	}
 };
 DeviceType.HeatPump;
-DeviceType.Cover, DeviceType.Valve, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.HeatPump, DeviceType.Camera, DeviceType.Hub, DeviceType.Switch, DeviceType.Siren, DeviceType.Light, DeviceType.Fan, DeviceType.Sensor, DeviceType.Thermostat, DeviceType.Climate, DeviceType.Button, DeviceType.EventEmitter, DeviceType.Update, DeviceType.Generic, DeviceType.Notifier, DeviceType.Script, DeviceType.Automation, DeviceType.Lock, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.PetFountain, DeviceType.Heater, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Dryer, DeviceType.Gateway;
+DeviceType.Climate;
+DeviceRole.ClimateThermostat, DeviceRole.ClimateAc, DeviceRole.ClimateRadiator, DeviceRole.ClimateFloor, DeviceRole.ClimateHeater, DeviceRole.ClimateHeatPumpCircuit;
+DeviceType.Cover, DeviceType.Valve, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.HeatPump, DeviceType.Camera, DeviceType.Hub, DeviceType.Switch, DeviceType.Siren, DeviceType.Light, DeviceType.Fan, DeviceType.Sensor, DeviceType.Climate, DeviceType.Button, DeviceType.EventEmitter, DeviceType.Update, DeviceType.Generic, DeviceType.Notifier, DeviceType.Script, DeviceType.Automation, DeviceType.Lock, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.PetFountain, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Dryer, DeviceType.Gateway;
 new Set(Object.values(DeviceType));
 /** Parses the raw slice with the cap's own schema; `undefined` when it does not parse. */
 function contribution(cap, schema, build) {
@@ -86581,7 +86988,7 @@ var HEAT_PUMP_FAMILY_CONTRIBUTIONS = { "heat-pump-status": contribution("heat-pu
 	...Object.values(CLIMATE_FAMILY_CONTRIBUTIONS),
 	...Object.values(HEAT_PUMP_FAMILY_CONTRIBUTIONS)
 ];
-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.HeatPump, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.PetFountain, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Heater, DeviceType.Dryer, DeviceType.Gateway;
+DeviceType.Camera, DeviceType.Hub, DeviceType.Light, DeviceType.Siren, DeviceType.Switch, DeviceType.Sensor, 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.HeatPump, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.PetFountain, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Dryer, DeviceType.Gateway;
 /**
 * Who looks like what (D1023). One look per {@link DeviceType}, refined by a
 * {@link DeviceRole} where the role changes how the device reads (a leak
@@ -87225,9 +87632,9 @@ lookOf({
 	idle: INFO,
 	standby: MUTED
 });
-DeviceType.Climate, DeviceType.Thermostat;
-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.HeatPump, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.PetFountain, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Heater, DeviceType.Dryer, DeviceType.Gateway;
-DeviceRole.Siren, DeviceRole.Floodlight, DeviceRole.Spotlight, DeviceRole.PirSensor, DeviceRole.Chime, DeviceRole.Autotrack, DeviceRole.Nightvision, DeviceRole.PrivacyMask, DeviceRole.Doorbell, DeviceRole.CoverBlind, DeviceRole.CoverShutter, DeviceRole.CoverAwning, DeviceRole.CoverCurtain, DeviceRole.CoverGarage, DeviceRole.CoverGate, DeviceRole.CoverDoor, DeviceRole.CoverWindow, DeviceRole.BinaryHelper, DeviceRole.Outlet, DeviceRole.MotionSensor, DeviceRole.ContactSensor, DeviceRole.LeakSensor, DeviceRole.SmokeSensor, DeviceRole.COSensor, DeviceRole.GasSensor, DeviceRole.TamperSensor, DeviceRole.VibrationSensor, DeviceRole.ConnectivitySensor, DeviceRole.SoundSensor, DeviceRole.BinarySensor, DeviceRole.TemperatureSensor, DeviceRole.HumiditySensor, DeviceRole.AmbientLightSensor, DeviceRole.PressureSensor, DeviceRole.WindSensor, DeviceRole.RainSensor, DeviceRole.UvSensor, DeviceRole.SolarRadiationSensor, DeviceRole.SoilMoistureSensor, DeviceRole.PowerSensor, DeviceRole.EnergySensor, DeviceRole.VoltageSensor, DeviceRole.CurrentSensor, DeviceRole.AirQualitySensor, DeviceRole.BatterySensor, DeviceRole.NumericSensor, DeviceRole.EnumSensor, DeviceRole.DateTimeSensor, DeviceRole.GenericSensor, DeviceRole.NumericControl, DeviceRole.SelectControl, DeviceRole.TextControl, DeviceRole.DateTimeControl, DeviceRole.MobilePushNotifier, DeviceRole.MessagingNotifier, DeviceRole.EmailNotifier, DeviceRole.GenericNotifier, DeviceRole.IrTransmitter;
+DeviceType.Climate;
+DeviceType.Camera, DeviceType.Hub, DeviceType.Light, DeviceType.Siren, DeviceType.Switch, DeviceType.Sensor, 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.HeatPump, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.PetFountain, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Dryer, DeviceType.Gateway;
+DeviceRole.Siren, DeviceRole.Floodlight, DeviceRole.Spotlight, DeviceRole.PirSensor, DeviceRole.Chime, DeviceRole.Autotrack, DeviceRole.Nightvision, DeviceRole.PrivacyMask, DeviceRole.Doorbell, DeviceRole.CoverBlind, DeviceRole.CoverShutter, DeviceRole.CoverAwning, DeviceRole.CoverCurtain, DeviceRole.CoverGarage, DeviceRole.CoverGate, DeviceRole.CoverDoor, DeviceRole.CoverWindow, DeviceRole.BinaryHelper, DeviceRole.Outlet, DeviceRole.SwitchHeater, DeviceRole.SwitchFan, DeviceRole.ClimateAc, DeviceRole.ClimateThermostat, DeviceRole.ClimateFloor, DeviceRole.ClimateRadiator, DeviceRole.ClimateHeater, DeviceRole.ClimateHeatPumpCircuit, DeviceRole.MotionSensor, DeviceRole.ContactSensor, DeviceRole.LeakSensor, DeviceRole.SmokeSensor, DeviceRole.COSensor, DeviceRole.GasSensor, DeviceRole.TamperSensor, DeviceRole.VibrationSensor, DeviceRole.ConnectivitySensor, DeviceRole.SoundSensor, DeviceRole.BinarySensor, DeviceRole.TemperatureSensor, DeviceRole.HumiditySensor, DeviceRole.AmbientLightSensor, DeviceRole.PressureSensor, DeviceRole.WindSensor, DeviceRole.RainSensor, DeviceRole.UvSensor, DeviceRole.SolarRadiationSensor, DeviceRole.SoilMoistureSensor, DeviceRole.PowerSensor, DeviceRole.EnergySensor, DeviceRole.VoltageSensor, DeviceRole.CurrentSensor, DeviceRole.AirQualitySensor, DeviceRole.BatterySensor, DeviceRole.NumericSensor, DeviceRole.EnumSensor, DeviceRole.DateTimeSensor, DeviceRole.GenericSensor, DeviceRole.NumericControl, DeviceRole.SelectControl, DeviceRole.TextControl, DeviceRole.DateTimeControl, DeviceRole.MobilePushNotifier, DeviceRole.MessagingNotifier, DeviceRole.EmailNotifier, DeviceRole.GenericNotifier, DeviceRole.IrTransmitter;
 Object.freeze({
 	"accessories.getStatus": {
 		capName: "accessories",
@@ -90624,6 +91031,13 @@ Object.freeze({
 		access: "create",
 		role: "viewer"
 	},
+	"fanControl.setOscillationAxis": {
+		capName: "fan-control",
+		capScope: "device",
+		addonId: null,
+		access: "create",
+		role: "viewer"
+	},
 	"fanControl.setPercentage": {
 		capName: "fan-control",
 		capScope: "device",
@@ -97645,7 +98059,7 @@ function projectAction(cap, action) {
 	};
 }
 Object.entries(CAP_VOCABULARY_BY_NAME).flatMap(([cap, entry]) => entry.scope === "device" ? (entry.actions ?? []).map((a) => projectAction(cap, a)) : []);
-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.HeatPump, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.PetFountain, DeviceType.Heater, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Dryer, DeviceType.Gateway;
+DeviceType.Camera, DeviceType.Hub, DeviceType.Light, DeviceType.Siren, DeviceType.Switch, DeviceType.Sensor, 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.HeatPump, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.PetFountain, DeviceType.Dishwasher, DeviceType.Washer, DeviceType.Dryer, DeviceType.Gateway;
 DeviceFeature.BatteryOperated;
 function bound(cap, methods = [], authority = "reported") {
 	return {
@@ -97704,6 +98118,149 @@ function offered(received) {
 	};
 }
 offered(HA_AS), withheld(HOMEKIT_REASON), withheld(ALEXA_REASON), withheld(GOOGLE_REASON), withheld(MATTER_REASON);
+var PowerSwitchRefusedError = class extends Error {
+	reason;
+	constructor(reason, message) {
+		super(message);
+		this.name = "PowerSwitchRefusedError";
+		this.reason = reason;
+	}
+};
+/** `true` / `false` from the owner slice, `null` when the hinted field is
+*  absent or not of the hinted shape. */
+function powerOnFromSlice(hint, slice) {
+	const value = slice?.[hint.field];
+	switch (hint.kind) {
+		case "field": return typeof value === "boolean" ? value : null;
+		case "methods": return typeof value === "string" ? !hint.offValues.includes(value) : null;
+		case "mode": return typeof value === "string" ? value !== hint.offValue : null;
+	}
+}
+function ownerMethod(owner, name, capName) {
+	const fn = Reflect.get(owner, name);
+	if (typeof fn !== "function") throw new PowerSwitchRefusedError("owner-method-missing", `${capName} provider does not serve '${name}', which its power hint names`);
+	return async (input) => fn.call(owner, input);
+}
+async function lastNonOffMode(host, capName, hint) {
+	const isMode = (v) => typeof v === "string" && v.length > 0 && v !== hint.offValue;
+	const fromHub = (await host.readHubSlice(capName).catch(() => null))?.[hint.lastField];
+	if (isMode(fromHub)) return fromHub;
+	const local = host.runtimeState.getCapState(capName)?.[hint.lastField];
+	return isMode(local) ? local : null;
+}
+async function applyPower(host, capName, hint, owner, on) {
+	const deviceId = host.deviceId;
+	switch (hint.kind) {
+		case "field":
+			await ownerMethod(owner, hint.set, capName)({
+				deviceId,
+				on
+			});
+			return;
+		case "methods":
+			await ownerMethod(owner, on ? hint.on : hint.off, capName)({ deviceId });
+			return;
+		case "mode": {
+			const set = ownerMethod(owner, hint.set, capName);
+			if (!on) {
+				await set({
+					deviceId,
+					mode: hint.offValue
+				});
+				return;
+			}
+			const mode = await lastNonOffMode(host, capName, hint);
+			if (mode === null) throw new PowerSwitchRefusedError("no-last-mode", `device ${deviceId}: ${capName} has no last non-off mode to restore; pick a mode instead`);
+			await set({
+				deviceId,
+				mode
+			});
+			return;
+		}
+	}
+}
+function hintedMethods(hint) {
+	return hint.kind === "methods" ? [hint.on, hint.off] : [hint.set];
+}
+/** Whether `owner` serves every method its cap's power hint names. A media
+*  player whose `turnOn` / `turnOff` are not served has no power, so no switch. */
+function powerServedBy(hint, owner) {
+	if (hint === void 0) return false;
+	return hintedMethods(hint).every((name) => typeof Reflect.get(owner, name) === "function");
+}
+/** Builds the `switch` provider and starts the slice projection. Exported
+*  for the specs; providers call `registerPowerSwitch`. */
+function buildPowerSwitch(host, cap, owner) {
+	const hint = cap.power;
+	if (hint === void 0) throw new Error(`capability '${cap.name}' has no power hint: it has no switch to project`);
+	const read = () => powerOnFromSlice(hint, host.runtimeState.getCapState(cap.name));
+	const project = () => {
+		const on = read();
+		const current = host.runtimeState.getCapState(switchCapability.name);
+		if (current !== void 0 && current["on"] === on) return;
+		const next = {
+			on,
+			lastChangedAt: Date.now()
+		};
+		host.runtimeState.setCapState(switchCapability.name, next);
+	};
+	const stop = host.runtimeState.subscribeCap(cap.name, project);
+	if (host.runtimeState.getCapState(cap.name) !== void 0) project();
+	return {
+		provider: {
+			getStatus: async () => {
+				const current = host.runtimeState.getCapState(switchCapability.name);
+				const lastChangedAt = typeof current?.["lastChangedAt"] === "number" ? current["lastChangedAt"] : 0;
+				return {
+					on: read(),
+					lastChangedAt
+				};
+			},
+			setState: async ({ on }) => applyPower(host, cap.name, hint, owner, on)
+		},
+		dispose: stop
+	};
+}
+/**
+* Registers `switch` for a device whose `cap` carries a `power` hint, built
+* from `owner` (the provider the device registered for `cap`). Call it right
+* after `registerNativeCap(cap, owner)`.
+*/
+function registerPowerSwitch(device, cap, owner) {
+	const deviceId = device.ctx.id;
+	if (cap.power !== void 0 && !powerServedBy(cap.power, owner)) {
+		device.ctx.logger.debug("power switch: owner serves no power control, no switch registered", {
+			tags: { deviceId },
+			meta: { capName: cap.name }
+		});
+		return () => {};
+	}
+	const host = {
+		deviceId,
+		runtimeState: device.runtimeState,
+		registerNativeCap: (c, p) => device.ctx.registerNativeCap(c, p),
+		readHubSlice: async (capName) => {
+			try {
+				return await device.ctx.api.deviceState.getCapSlice.query({
+					deviceId,
+					capName
+				});
+			} catch (err) {
+				device.ctx.logger.warn("power switch: hub slice read failed", {
+					tags: { deviceId },
+					meta: {
+						capName,
+						error: err instanceof Error ? err.message : String(err)
+					}
+				});
+				return null;
+			}
+		}
+	};
+	const built = buildPowerSwitch(host, cap, owner);
+	host.registerNativeCap(switchCapability, built.provider);
+	return built.dispose;
+}
 Object.freeze({
 	"accessories.getStatus": [{
 		name: "deviceId",
@@ -98697,6 +99254,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"fanControl.setOscillationAxis": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"fanControl.setPercentage": [{
 		name: "deviceId",
 		form: "single",
@@ -102584,6 +103146,12 @@ Object.defineProperty(exports, "record", {
 		return record;
 	}
 });
+Object.defineProperty(exports, "registerPowerSwitch", {
+	enumerable: true,
+	get: function() {
+		return registerPowerSwitch;
+	}
+});
 Object.defineProperty(exports, "rowsDepsOver", {
 	enumerable: true,
 	get: function() {