@yunlefun-home/air-conditioner-core 0.3.0 → 0.4.0

package/dist/index.js

@@ -32,7 +32,13 @@ const defaultAcState = {
 	mode: "cold",
 	status: false,
 	temperature: 26,
-	sound: "normal"
+	temperatures: {
+		cold: 26,
+		hot: 26
+	},
+	sound: "normal",
+	swing: false,
+	fan: "auto"
 };
 /**
 * 遥控器「声音」键依次切换的顺序。
@@ -42,6 +48,13 @@ const acSoundModes = [
 	"sleep",
 	"mute"
 ];
+/**
+* 各模式的中文名称（遥控器小屏与按键提示共用）。
+*/
+const acModeLabels = {
+	cold: "制冷",
+	hot: "制热"
+};
 const acSoundModeLabels = {
 	normal: "标准",
 	sleep: "睡眠",
@@ -55,6 +68,48 @@ const acSoundVolumes = {
 	sleep: .3,
 	mute: 0
 };
+/**
+* 遥控器「风速」键依次切换的顺序。
+*/
+const acFanSpeeds = [
+	"auto",
+	"low",
+	"medium",
+	"high"
+];
+const acFanSpeedLabels = {
+	auto: "自动",
+	low: "低风",
+	medium: "中风",
+	high: "高风"
+};
+/**
+* 小屏上点亮的风速格数（1–3）。自动风速由空调自己决定，显示为 0 并另加「自动」标记。
+*/
+const acFanBars = {
+	auto: 0,
+	low: 1,
+	medium: 2,
+	high: 3
+};
+/**
+* 固定风速下风声的相对音量（0–1）；自动风速沿用开机后的「达标 / 发力」循环。
+*/
+const acFanSoundLevels = {
+	low: .45,
+	medium: .7,
+	high: 1
+};
+function isAcFanSpeed(value) {
+	return acFanSpeeds.includes(value);
+}
+/**
+* 风速键的下一档：自动 → 低 → 中 → 高 → 自动。
+*/
+function nextAcFanSpeed(fan) {
+	const index = Math.max(acFanSpeeds.indexOf(fan), 0);
+	return acFanSpeeds[(index + 1) % acFanSpeeds.length];
+}
 function isAcSoundMode(value) {
 	return acSoundModes.includes(value);
 }
@@ -126,6 +181,25 @@ function createDefaultAudioContext() {
 	return AudioContextConstructor ? new AudioContextConstructor() : null;
 }
 /**
+* 合成一声很轻的「嗒」：音高快速下滑的正弦波，短促起音、指数衰减，像水珠落在窗台上。
+*/
+function playDrip(context, output) {
+	const start = context.currentTime;
+	const oscillator = context.createOscillator();
+	const gain = context.createGain();
+	oscillator.type = "sine";
+	oscillator.frequency.setValueAtTime(1500, start);
+	oscillator.frequency.exponentialRampToValueAtTime(520, start + .07);
+	gain.gain.setValueAtTime(1e-4, start);
+	gain.gain.exponentialRampToValueAtTime(.12, start + .004);
+	gain.gain.exponentialRampToValueAtTime(1e-4, start + .16);
+	oscillator.connect(gain);
+	gain.connect(output);
+	oscillator.start(start);
+	oscillator.stop(start + .18);
+	oscillator.onended = () => gain.disconnect();
+}
+/**
 * 等功率淡入 / 淡出曲线，噪声类声音交叉淡化时中段不会变小。
 */
 function fadeCurve(direction) {
@@ -164,6 +238,11 @@ function stopElement(element) {
 function createAcAudioController(elements, options = {}) {
 	const random = options.random ?? Math.random;
 	let soundMode = options.soundMode ?? "normal";
+	let fanSpeed = options.fanSpeed ?? "auto";
+	/** 开机后风声循环已经接上（启动声结束） */
+	let fanRunning = false;
+	/** 每次重启「达标 / 发力」循环自增，丢弃旧循环的回调 */
+	let fanCycle = 0;
 	/** undefined：尚未尝试；null：不可用 */
 	let engine;
 	let run;
@@ -298,20 +377,32 @@ function createAcAudioController(elements, options = {}) {
 			gain.linearRampToValueAtTime(level, now + rampMs / 1e3);
 		} else tweenFallbackFan(level, rampMs);
 	}
+	/** 风声循环刚接上时的音量：自动风速从满音量开始，固定风速保持各自的音量。 */
+	function initialFanLevel() {
+		return fanSpeed === "auto" ? 1 : acFanSoundLevels[fanSpeed];
+	}
 	/**
-	* 室温达标后风声变小；之后不定时随压缩机发力变大，再回落。
+	* 自动风速：室温达标后风声变小；之后不定时随压缩机发力变大，再回落。
+	* 固定风速不走这个循环。
 	*/
 	function startFanCycle() {
+		fanRunning = true;
+		const cycle = ++fanCycle;
+		if (fanSpeed !== "auto") return;
+		const current = () => cycle === fanCycle && fanSpeed === "auto";
 		const quiet = () => {
 			later(() => {
+				if (!current()) return;
 				setFanLevel(soundTimings.surgeLevel, soundTimings.surgeRampMs);
 				later(() => {
+					if (!current()) return;
 					setFanLevel(soundTimings.settleLevel, soundTimings.surgeRampMs);
 					quiet();
 				}, randomBetween(soundTimings.surgeDurationMs, random));
 			}, randomBetween(soundTimings.quietDurationMs, random));
 		};
 		later(() => {
+			if (!current()) return;
 			setFanLevel(soundTimings.settleLevel, soundTimings.settleRampMs);
 			quiet();
 		}, soundTimings.settleAfterMs);
@@ -320,6 +411,7 @@ function createAcAudioController(elements, options = {}) {
 		const output = web.context.createGain();
 		output.connect(web.master);
 		const fan = web.context.createGain();
+		fan.gain.value = initialFanLevel();
 		fan.connect(output);
 		const target = {
 			output,
@@ -360,7 +452,7 @@ function createAcAudioController(elements, options = {}) {
 			applyElementVolume(work, 0);
 			if (work.loop !== void 0) work.loop = true;
 			playElement(work);
-			tweenFallbackFan(1, soundTimings.loopCrossfadeMs);
+			tweenFallbackFan(initialFanLevel(), soundTimings.loopCrossfadeMs);
 			startFanCycle();
 		}, soundTimings.startDelayMs);
 	}
@@ -371,6 +463,8 @@ function createAcAudioController(elements, options = {}) {
 	}
 	function powerOn() {
 		const id = ++session;
+		fanRunning = false;
+		fanCycle++;
 		clearTimers();
 		cancelFallbackTween();
 		stopWeb(0);
@@ -389,6 +483,8 @@ function createAcAudioController(elements, options = {}) {
 	}
 	function powerOff() {
 		session++;
+		fanRunning = false;
+		fanCycle++;
 		clearTimers();
 		stopWeb(soundTimings.stopFadeMs);
 		stopFallback(soundTimings.stopFadeMs);
@@ -407,6 +503,13 @@ function createAcAudioController(elements, options = {}) {
 			applyElementVolume(elements.beep);
 			playElement(elements.beep);
 		},
+		drip() {
+			if (soundMode !== "normal") return;
+			const web = ensureEngine();
+			if (!web || typeof web.context.createOscillator !== "function") return;
+			resume(web);
+			playDrip(web.context, web.master);
+		},
 		toggleStatusAudio(previousStatus) {
 			if (previousStatus) powerOff();
 			else powerOn();
@@ -418,6 +521,21 @@ function createAcAudioController(elements, options = {}) {
 			applyElementVolume(elements.start);
 			applyElementVolume(elements.work, fallbackFanLevel);
 		},
+		setFanSpeed(fan) {
+			if (fan === fanSpeed) return;
+			fanSpeed = fan;
+			if (!fanRunning) {
+				if (run) run.fan.gain.value = initialFanLevel();
+				return;
+			}
+			if (fan === "auto") {
+				setFanLevel(1, soundTimings.loopCrossfadeMs);
+				startFanCycle();
+			} else {
+				fanCycle++;
+				setFanLevel(acFanSoundLevels[fan], soundTimings.loopCrossfadeMs);
+			}
+		},
 		dispose() {
 			session++;
 			clearTimers();
@@ -430,6 +548,54 @@ function createAcAudioController(elements, options = {}) {
 	};
 }
 //#endregion
+//#region src/condensation.ts
+/** 风速越大，雾气越浓、冷凝水越快 */
+const fanFactor = {
+	auto: .8,
+	low: .55,
+	medium: .8,
+	high: 1
+};
+/** 高于这个设定温度不滴水：冷凝水不该常见，只在开得很冷时偶尔出现 */
+const acDripMaxTemperature = 22;
+/** 最冷（16 °C）与 {@link acDripMaxTemperature} 时，两滴水之间的间隔（ms） */
+const acDripIntervalRange = [9e3, 18e3];
+/**
+* 出风口雾气的浓度（#70），0–1：只在制冷开机时出现，设定温度越低、风越大越浓。
+*
+* 视图把它写进 CSS 变量 `--acw-mist`，3D 等其他渲染器也可以按它控制粒子数量。
+*/
+function getAcMist(state) {
+	if (!state.status || state.mode !== "cold") return 0;
+	const cold = .2 + .8 * (31 - state.temperature) / 15;
+	const mist = Math.min(1, Math.max(.2, cold)) * fanFactor[state.fan ?? "auto"];
+	return Math.round(mist * 100) / 100;
+}
+/**
+* 冷凝水滴落的间隔（#21，ms）：只在制冷开机、设定温度不高于 {@link acDripMaxTemperature} 时滴水，
+* 越冷越频繁，高风再快一些；不滴水时返回 `undefined`。
+*
+* 视图把它写进 CSS 变量 `--acw-drip-cycle`，水珠在出风口边缘慢慢聚起再落下，开机后要等一整个间隔才滴第一滴。
+*/
+function getAcDripInterval(state) {
+	if (!state.status || state.mode !== "cold" || state.temperature > 22) return void 0;
+	const [fastest, slowest] = acDripIntervalRange;
+	const progress = (state.temperature - 16) / 6;
+	const interval = fastest + (slowest - fastest) * Math.min(1, Math.max(0, progress));
+	return Math.round(interval * (state.fan === "high" ? .8 : 1));
+}
+/**
+* 视图要写到空调根元素上的雾气 / 滴水样式变量与属性。
+*/
+function getAcCondensationStyle(state) {
+	const interval = getAcDripInterval(state);
+	return {
+		mist: getAcMist(state),
+		dripCycle: interval === void 0 ? void 0 : `${interval}ms`,
+		drip: interval === void 0 ? "off" : "on"
+	};
+}
+//#endregion
 //#region src/motion.ts
 /**
 * 动效 token：各框架视图层共用的时长与缓动曲线。
@@ -448,7 +614,9 @@ const acMotion = {
 		/** 导风板、出风淡入淡出 */
 		slow: 420,
 		/** 出风气流单次循环 */
-		flow: 1800
+		flow: 1800,
+		/** 扫风：左右摆动一个来回 */
+		swing: 5200
 	},
 	easing: {
 		/** 常规状态切换 */
@@ -470,7 +638,8 @@ const acReducedMotionDuration = {
 	fast: 80,
 	base: 120,
 	slow: 120,
-	flow: 0
+	flow: 0,
+	swing: 0
 };
 const acReducedMotionQuery = "(prefers-reduced-motion: reduce)";
 /**
@@ -592,6 +761,124 @@ function observeAcTilt(target, onTilt, maxTilt = 4) {
 	};
 }
 //#endregion
+//#region src/model.ts
+const acForms = ["wall", "tower"];
+const acFormLabels = {
+	wall: "挂机",
+	tower: "柜机"
+};
+/** 网页用的模型文件名（站点的 `public/models/` 下） */
+const acModelFiles = {
+	wall: "CuteAC.glb",
+	tower: "CuteACTower.glb"
+};
+/** 渲染器要控制的命名节点，两种形态相同 */
+const acModelParts = {
+	/** 导风板：挂机是一整块，柜机是一组百叶（子节点） */
+	louver: "Louver",
+	/** 0.25 × 0.1、UV 为 0–1 的平面，贴温度画面 */
+	display: "Display",
+	/** 指示灯 */
+	led: "Led"
+};
+const acLouverMotion = {
+	wall: {
+		pivot: "node",
+		openAngle: 40
+	},
+	tower: {
+		pivot: "children",
+		openAngle: 30
+	}
+};
+const acAirflowAnchors = {
+	wall: {
+		offset: [
+			0,
+			-.1,
+			.05
+		],
+		extent: 1.5,
+		direction: "down"
+	},
+	tower: {
+		offset: [
+			.24,
+			0,
+			.08
+		],
+		extent: .5,
+		direction: "side"
+	}
+};
+/** 指示灯与显示窗的颜色：开机时是模式色，关机是灰色（与 `ACPalette` 一致） */
+const acModelColors = {
+	cold: "#5aa9ff",
+	hot: "#ff9f5a",
+	off: "#8e97aa"
+};
+function getAcLedColor(state) {
+	return state.status ? acModelColors[state.mode] : acModelColors.off;
+}
+function isAcForm(value) {
+	return value === "wall" || value === "tower";
+}
+//#endregion
+//#region src/press.ts
+/**
+* 让按键支持长按连续触发，和真的遥控器一样：按下立即触发一次，按住一会儿后连续触发并逐渐加速，
+* 松开、移出或取消时停止。键盘的 Enter / 空格仍走 `click`，每按一次触发一次。
+*
+* @param element 按键
+* @param fire 每次触发时调用
+* @param options 节奏与停止条件
+* @returns 解除绑定的清理函数
+*/
+function bindAcPressRepeat(element, fire, options = {}) {
+	const { delay = 500, interval = 200, minInterval = 100, value } = options;
+	let timer;
+	let wait = interval;
+	let last;
+	const stop = () => {
+		clearTimeout(timer);
+		timer = void 0;
+	};
+	const tick = () => {
+		if (value && value() === last) return stop();
+		last = value?.();
+		fire();
+		wait = Math.max(minInterval, wait * .85);
+		timer = setTimeout(tick, wait);
+	};
+	const onPointerDown = (event) => {
+		if (event.button !== 0) return;
+		stop();
+		last = value?.();
+		fire();
+		wait = interval;
+		timer = setTimeout(tick, delay);
+	};
+	const onClick = (event) => {
+		if (event.detail === 0) fire();
+	};
+	const onContextMenu = (event) => event.preventDefault();
+	element.addEventListener("pointerdown", onPointerDown);
+	element.addEventListener("pointerup", stop);
+	element.addEventListener("pointerleave", stop);
+	element.addEventListener("pointercancel", stop);
+	element.addEventListener("click", onClick);
+	element.addEventListener("contextmenu", onContextMenu);
+	return () => {
+		stop();
+		element.removeEventListener("pointerdown", onPointerDown);
+		element.removeEventListener("pointerup", stop);
+		element.removeEventListener("pointerleave", stop);
+		element.removeEventListener("pointercancel", stop);
+		element.removeEventListener("click", onClick);
+		element.removeEventListener("contextmenu", onContextMenu);
+	};
+}
+//#endregion
 //#region src/reducer.ts
 /**
 * Merge a partial state over the defaults and clamp its temperature.
@@ -600,11 +887,38 @@ function observeAcTilt(target, onTilt, maxTilt = 4) {
 * @param limits - Device limits; omit to keep the default 16–31 °C range
 */
 function normalizeAcState(state, limits) {
+	const mode = state?.mode === "hot" ? "hot" : "cold";
+	const temperature = clampTemperature(state?.temperature ?? defaultAcState.temperature, limits);
+	const remembered = (other) => {
+		const value = state?.temperatures?.[other];
+		return typeof value === "number" && Number.isFinite(value) ? clampTemperature(value, limits) : temperature;
+	};
 	return {
 		...defaultAcState,
 		...state,
-		temperature: clampTemperature(state?.temperature ?? defaultAcState.temperature, limits),
-		sound: isAcSoundMode(state?.sound) ? state.sound : defaultAcState.sound
+		mode,
+		temperature,
+		temperatures: {
+			cold: mode === "cold" ? temperature : remembered("cold"),
+			hot: mode === "hot" ? temperature : remembered("hot")
+		},
+		sound: isAcSoundMode(state?.sound) ? state.sound : defaultAcState.sound,
+		swing: typeof state?.swing === "boolean" ? state.swing : defaultAcState.swing,
+		fan: isAcFanSpeed(state?.fan) ? state.fan : "auto"
+	};
+}
+/** Set the current mode's temperature, keeping `temperatures` in step. */
+function withTemperature(state, temperature) {
+	const temperatures = {
+		cold: temperature,
+		hot: temperature,
+		...state.temperatures
+	};
+	temperatures[state.mode] = temperature;
+	return {
+		...state,
+		temperature,
+		temperatures
 	};
 }
 /**
@@ -630,14 +944,8 @@ function clampTemperature(temperature, limits) {
 function acReducer(state, action, limits) {
 	const step = limits?.step ?? defaultAcLimits.step;
 	switch (action.type) {
-		case "increment": return {
-			...state,
-			temperature: clampTemperature(state.temperature + step, limits)
-		};
-		case "decrement": return {
-			...state,
-			temperature: clampTemperature(state.temperature - step, limits)
-		};
+		case "increment": return withTemperature(state, clampTemperature(state.temperature + step, limits));
+		case "decrement": return withTemperature(state, clampTemperature(state.temperature - step, limits));
 		case "toggleStatus": return {
 			...state,
 			status: !state.status
@@ -646,10 +954,26 @@ function acReducer(state, action, limits) {
 			...state,
 			status: action.status
 		};
-		case "mode": return {
-			...state,
-			mode: action.mode
-		};
+		case "mode": {
+			const status = state.status || action.powerOn === true;
+			if (action.mode === state.mode) return status === state.status ? state : {
+				...state,
+				status
+			};
+			const temperatures = {
+				cold: state.temperature,
+				hot: state.temperature,
+				...state.temperatures,
+				[state.mode]: state.temperature
+			};
+			return {
+				...state,
+				status,
+				mode: action.mode,
+				temperature: clampTemperature(temperatures[action.mode] ?? state.temperature, limits),
+				temperatures
+			};
+		}
 		case "sound": return {
 			...state,
 			sound: isAcSoundMode(action.sound) ? action.sound : state.sound
@@ -658,6 +982,22 @@ function acReducer(state, action, limits) {
 			...state,
 			sound: nextAcSoundMode(state.sound)
 		};
+		case "toggleSwing": return {
+			...state,
+			swing: !state.swing
+		};
+		case "swing": return {
+			...state,
+			swing: action.swing === true
+		};
+		case "fan": return {
+			...state,
+			fan: isAcFanSpeed(action.fan) ? action.fan : state.fan
+		};
+		case "cycleFan": return {
+			...state,
+			fan: nextAcFanSpeed(state.fan)
+		};
 		case "update": return normalizeAcState({
 			...state,
 			...action.payload
@@ -665,6 +1005,32 @@ function acReducer(state, action, limits) {
 		default: throw new Error("Unexpected Ac Action");
 	}
 }
+/**
+* 节能建议的短文案（显示在小纸条上）与补充说明。
+*/
+function getEnergyTip(mode, temperature) {
+	return mode === "cold" ? {
+		message: `制冷调到 ${temperature}°C 以上更省电`,
+		detail: "少开一度，为节能减排出一份力"
+	} : {
+		message: `制热调到 ${temperature}°C 以下更省电`,
+		detail: "少开一度，为节能减排出一份力"
+	};
+}
+/**
+* 创建一个提示「呈现器」：每个视图实例一个，记住提示过的节能建议，避免重复打扰。
+*/
+function createAcNotificationPresenter() {
+	let lastTip;
+	return (notification, state) => {
+		if (notification.kind === "limit") return "shake";
+		if (notification.kind === "setting") return "announce";
+		const key = `${state.mode}:${state.temperature}`;
+		if (key === lastTip) return "skip";
+		lastTip = key;
+		return "note";
+	};
+}
 function getRecommendedTemperatureMessage(mode, temperature) {
 	return `建议将空调的制${mode === "cold" ? "冷" : "热"}温度调至 ${temperature} 度以${mode === "cold" ? "上" : "下"}，为节能减排贡献一份力量！`;
 }
@@ -675,6 +1041,12 @@ function getSoundModeMessage(sound) {
 		mute: "空调不再发出任何声音"
 	}[sound]}`;
 }
+function getFanSpeedMessage(fan) {
+	return fan === "auto" ? "风速：自动，由空调根据室温调节" : `风速：${acFanSpeedLabels[fan]}`;
+}
+function getSwingMessage(swing) {
+	return swing ? "扫风已开启：导风板上下摆动，出风左右扫" : "扫风已关闭：导风板停在当前位置";
+}
 /**
 * Visual tone for a state: `idle` when off, otherwise `cool` or `heat`.
 *
@@ -687,23 +1059,38 @@ function acTone(state) {
 function getAcActionNotification(previousState, nextState, action, limits = defaultAcLimits) {
 	if (action.type === "increment" && previousState.temperature >= limits.max) return {
 		message: "已经是最大温度啦！",
-		severity: "error"
+		severity: "error",
+		kind: "limit"
 	};
 	if (action.type === "decrement" && previousState.temperature <= limits.min) return {
 		message: "已经是最小温度啦！",
-		severity: "error"
+		severity: "error",
+		kind: "limit"
 	};
 	if ((action.type === "sound" || action.type === "cycleSound") && nextState.sound !== previousState.sound) return {
 		message: getSoundModeMessage(nextState.sound),
-		severity: "info"
+		severity: "info",
+		kind: "setting"
 	};
-	if (action.type === "mode" && nextState.mode === "cold" && previousState.temperature < 26) return {
-		message: getRecommendedTemperatureMessage("cold", 26),
-		severity: "success"
+	if ((action.type === "fan" || action.type === "cycleFan") && nextState.fan && nextState.fan !== previousState.fan) return {
+		message: getFanSpeedMessage(nextState.fan),
+		severity: "info",
+		kind: "setting"
 	};
-	if (action.type === "mode" && nextState.mode === "hot" && previousState.temperature > 20) return {
-		message: getRecommendedTemperatureMessage("hot", 20),
-		severity: "success"
+	if ((action.type === "swing" || action.type === "toggleSwing") && nextState.swing !== previousState.swing) return {
+		message: getSwingMessage(nextState.swing),
+		severity: "info",
+		kind: "setting"
+	};
+	if (action.type === "mode" && nextState.mode === "cold" && nextState.temperature < 26) return {
+		...getEnergyTip("cold", 26),
+		severity: "success",
+		kind: "tip"
+	};
+	if (action.type === "mode" && nextState.mode === "hot" && nextState.temperature > 20) return {
+		...getEnergyTip("hot", 20),
+		severity: "success",
+		kind: "tip"
 	};
 }
 //#endregion
@@ -928,24 +1315,41 @@ function createComputePressureSource(options = {}) {
 	};
 }
 //#endregion
-//#region src/ui.ts
+//#region src/icons.ts
 /**
-* 各框架视图层共用的界面数据：遥控器图标与能效标签的点阵布局。
-* 保证 Vue / React / Web Component 渲染出完全一致的空调外观。
-*/
-/**
-* 遥控器按钮图标（24 × 24 viewBox 的 SVG path）。
+* 遥控器按钮与提示图标（24 × 24 viewBox 的 SVG path），全部来自 Material Design
+* Icons，和站点通过 UnoCSS presetIcons 使用的 i-mdi-* 是同一套。
 */
 const acIconPaths = {
-	cold: "m22 11h-4.17l3.24-3.24l-1.41-1.42L15 11h-2V9l4.66-4.66l-1.42-1.41L13 6.17V2h-2v4.17L7.76 2.93L6.34 4.34L11 9v2H9L4.34 6.34L2.93 7.76L6.17 11H2v2h4.17l-3.24 3.24l1.41 1.42L9 13h2v2l-4.66 4.66l1.42 1.41L11 17.83V22h2v-4.17l3.24 3.24l1.42-1.41L13 15v-2h2l4.66 4.66l1.41-1.42L17.83 13H22z",
-	power: "M13 3h-2v10h2zm4.83 2.17l-1.42 1.42A6.92 6.92 0 0 1 19 12a7 7 0 0 1-14 0a6.92 6.92 0 0 1 2.58-5.42L6.17 5.17A9 9 0 1 0 21 12a8.94 8.94 0 0 0-3.17-6.83",
-	hot: "M12 7a5 5 0 1 0 5 5a5 5 0 0 0-5-5m0-5a1 1 0 0 0-1 1v2a1 1 0 0 0 2 0V3a1 1 0 0 0-1-1m0 17a1 1 0 0 0-1 1v2a1 1 0 0 0 2 0v-2a1 1 0 0 0-1-1M5.64 6.05L4.22 4.64a1 1 0 0 0-1.41 1.41l1.41 1.42a1 1 0 0 0 1.42 0a1 1 0 0 0 0-1.42M21 11h-2a1 1 0 0 0 0 2h2a1 1 0 0 0 0-2M5 12a1 1 0 0 0-1-1H2a1 1 0 0 0 0 2h2a1 1 0 0 0 1-1m13.36-5.95a1 1 0 0 0 .7-.29l1.42-1.42a1 1 0 1 0-1.41-1.41l-1.42 1.41a1 1 0 0 0 0 1.42a1 1 0 0 0 .71.29m0 11.9a1 1 0 0 0-1.42 1.41l1.42 1.42a1 1 0 0 0 1.41 0a1 1 0 0 0 0-1.41ZM5.64 17.95l-1.42 1.42a1 1 0 0 0 0 1.41a1 1 0 0 0 1.41 0l1.42-1.42a1 1 0 0 0-1.41-1.41",
-	increase: "m12 8l6 8H6z",
-	decrease: "m12 16l-6-8h12z",
-	soundNormal: "M3 10v4c0 .55.45 1 1 1h3l3.29 3.29c.63.63 1.71.18 1.71-.71V6.41c0-.89-1.08-1.34-1.71-.71L7 9H4c-.55 0-1 .45-1 1m13.5 2A4.5 4.5 0 0 0 14 7.97v8.05c1.48-.73 2.5-2.25 2.5-4.02M14 4.45v.2c0 .38.25.71.6.85C17.18 6.53 19 9.06 19 12s-1.82 5.47-4.4 6.5c-.36.14-.6.47-.6.85v.2c0 .63.63 1.07 1.21.85C18.6 19.11 21 15.84 21 12s-2.4-7.11-5.79-8.4c-.58-.23-1.21.22-1.21.85",
-	soundSleep: "M11.65 3.46c.27-.71-.36-1.45-1.12-1.34c-5.52.8-9.47 6.07-8.34 11.88c.78 4.02 4.09 7.21 8.14 7.87c3.74.61 7.16-.87 9.32-3.44c.48-.57.19-1.48-.55-1.62c-6.02-1.15-9.68-7.54-7.45-13.35",
-	soundMute: "M3.63 3.63a.996.996 0 0 0 0 1.41L7.29 8.7L7 9H4c-.55 0-1 .45-1 1v4c0 .55.45 1 1 1h3l3.29 3.29c.63.63 1.71.18 1.71-.71v-4.17l4.18 4.18c-.49.37-1.02.68-1.6.91c-.36.15-.58.53-.58.92c0 .72.73 1.18 1.39.91c.8-.33 1.55-.77 2.22-1.31l1.34 1.34a.996.996 0 1 0 1.41-1.41L5.05 3.63c-.39-.39-1.02-.39-1.42 0M19 12c0 .82-.15 1.61-.41 2.34l1.53 1.53c.56-1.17.88-2.48.88-3.87c0-3.83-2.4-7.11-5.78-8.4c-.59-.23-1.22.23-1.22.86v.19c0 .38.25.71.61.85C17.18 6.54 19 9.06 19 12m-8.71-6.29l-.17.17L12 7.76V6.41c0-.89-1.08-1.33-1.71-.7M16.5 12A4.5 4.5 0 0 0 14 7.97v1.79l2.48 2.48c.01-.08.02-.16.02-.24"
+	/** mdi:snowflake */
+	cold: "m20.79 13.95l-2.33.62l-2-1.13v-2.88l2-1.13l2.33.62l.52-1.93l-1.77-.47l.46-1.77l-1.93-.52l-.62 2.33l-2 1.13L13 7.38V5.12l1.71-1.71L13.29 2L12 3.29L10.71 2L9.29 3.41L11 5.12v2.26L8.5 8.82l-2-1.13l-.58-2.33L4 5.88l.47 1.77l-1.77.47l.52 1.93l2.33-.62l2 1.13v2.89l-2 1.13l-2.33-.62l-.52 1.93l1.77.47L4 18.12l1.93.52l.62-2.33l2-1.13L11 16.62v2.26l-1.71 1.71L10.71 22L12 20.71L13.29 22l1.41-1.41l-1.7-1.71v-2.26l2.5-1.45l2 1.13l.62 2.33l1.88-.51l-.47-1.77l1.77-.47zM9.5 10.56L12 9.11l2.5 1.45v2.88L12 14.89l-2.5-1.45z",
+	/** mdi:white-balance-sunny */
+	hot: "m3.55 19.09l1.41 1.41l1.8-1.79l-1.42-1.42M12 6c-3.31 0-6 2.69-6 6s2.69 6 6 6s6-2.69 6-6c0-3.32-2.69-6-6-6m8 7h3v-2h-3m-2.76 7.71l1.8 1.79l1.41-1.41l-1.79-1.8M20.45 5l-1.41-1.4l-1.8 1.79l1.42 1.42M13 1h-2v3h2M6.76 5.39L4.96 3.6L3.55 5l1.79 1.81zM1 13h3v-2H1m12 9h-2v3h2",
+	/** mdi:power */
+	power: "m16.56 5.44l-1.45 1.45A5.97 5.97 0 0 1 18 12a6 6 0 0 1-6 6a6 6 0 0 1-6-6c0-2.17 1.16-4.06 2.88-5.12L7.44 5.44A7.96 7.96 0 0 0 4 12a8 8 0 0 0 8 8a8 8 0 0 0 8-8c0-2.72-1.36-5.12-3.44-6.56M13 3h-2v10h2",
+	/** mdi:plus */
+	plus: "M19 13h-6v6h-2v-6H5v-2h6V5h2v6h6z",
+	/** mdi:minus */
+	minus: "M19 13H5v-2h14z",
+	/** mdi:menu-up */
+	increase: "m7 15l5-5l5 5z",
+	/** mdi:menu-down */
+	decrease: "m7 10l5 5l5-5z",
+	/** mdi:fan */
+	fan: "M12 11a1 1 0 0 0-1 1a1 1 0 0 0 1 1a1 1 0 0 0 1-1a1 1 0 0 0-1-1m.5-9c4.5 0 4.61 3.57 2.25 4.75c-.99.49-1.43 1.54-1.62 2.47c.48.2.9.51 1.22.91c3.7-2 7.68-1.21 7.68 2.37c0 4.5-3.57 4.6-4.75 2.23c-.5-.99-1.56-1.43-2.49-1.62c-.2.48-.51.89-.91 1.23c1.99 3.69 1.2 7.66-2.38 7.66c-4.5 0-4.59-3.58-2.23-4.76c.98-.49 1.42-1.53 1.62-2.45c-.49-.2-.92-.52-1.24-.92C5.96 15.85 2 15.07 2 11.5C2 7 5.56 6.89 6.74 9.26c.5.99 1.55 1.42 2.48 1.61c.19-.48.51-.9.92-1.22C8.15 5.96 8.94 2 12.5 2",
+	/** mdi:arrow-oscillating */
+	swing: "M6 14h3l-4 4l-4-4h3c0-2.7 1.7-7.4 7-7.9v2c-3.4.5-5 3.8-5 5.9m14 0c0-2.7-1.7-7.4-7-7.9v2c3.4.6 5 3.8 5 5.9h-3l4 4l4-4z",
+	/** mdi:volume-high */
+	soundNormal: "M14 3.23v2.06c2.89.86 5 3.54 5 6.71s-2.11 5.84-5 6.7v2.07c4-.91 7-4.49 7-8.77s-3-7.86-7-8.77M16.5 12c0-1.77-1-3.29-2.5-4.03V16c1.5-.71 2.5-2.24 2.5-4M3 9v6h4l5 5V4L7 9z",
+	/** mdi:weather-night */
+	soundSleep: "m17.75 4.09l-2.53 1.94l.91 3.06l-2.63-1.81l-2.63 1.81l.91-3.06l-2.53-1.94L12.44 4l1.06-3l1.06 3zm3.5 6.91l-1.64 1.25l.59 1.98l-1.7-1.17l-1.7 1.17l.59-1.98L15.75 11l2.06-.05L18.5 9l.69 1.95zm-2.28 4.95c.83-.08 1.72 1.1 1.19 1.85c-.32.45-.66.87-1.08 1.27C15.17 23 8.84 23 4.94 19.07c-3.91-3.9-3.91-10.24 0-14.14c.4-.4.82-.76 1.27-1.08c.75-.53 1.93.36 1.85 1.19c-.27 2.86.69 5.83 2.89 8.02a9.96 9.96 0 0 0 8.02 2.89m-1.64 2.02a12.08 12.08 0 0 1-7.8-3.47c-2.17-2.19-3.33-5-3.49-7.82c-2.81 3.14-2.7 7.96.31 10.98c3.02 3.01 7.84 3.12 10.98.31",
+	/** mdi:volume-off */
+	soundMute: "M12 4L9.91 6.09L12 8.18M4.27 3L3 4.27L7.73 9H3v6h4l5 5v-6.73l4.25 4.26c-.67.51-1.42.93-2.25 1.17v2.07c1.38-.32 2.63-.95 3.68-1.81L19.73 21L21 19.73l-9-9M19 12c0 .94-.2 1.82-.54 2.64l1.51 1.51A8.9 8.9 0 0 0 21 12c0-4.28-3-7.86-7-8.77v2.06c2.89.86 5 3.54 5 6.71m-2.5 0c0-1.77-1-3.29-2.5-4.03v2.21l2.45 2.45c.05-.2.05-.42.05-.63",
+	/** mdi:leaf */
+	leaf: "M17 8C8 10 5.9 16.17 3.82 21.34l1.89.66l.95-2.3c.48.17.98.3 1.34.3C19 20 22 3 22 3c-1 2-8 2.25-13 3.25S2 11.5 2 13.5s1.75 3.75 1.75 3.75C7 8 17 8 17 8"
 };
+//#endregion
+//#region src/ui.ts
 /**
 * 声音键在各声音模式下显示的图标。
 */
@@ -955,13 +1359,42 @@ const acSoundIcons = {
 	mute: "soundMute"
 };
 /**
-* 能效标签的点阵与等级条布局。
+* 遥控器小屏的读屏文字与各按键的悬停提示，保证各框架文案一致。
+*/
+function getAcRemoteText(state) {
+	const swing = `扫风：${state.swing ? "开" : "关"}`;
+	const sound = `声音：${acSoundModeLabels[state.sound]}`;
+	const fan = `风速：${acFanSpeedLabels[state.fan ?? "auto"]}`;
+	return {
+		display: `${state.status ? "运行" : "待机"}，${acModeLabels[state.mode]} ${state.temperature}°C，${fan}，${swing}，${sound}`,
+		power: `电源：${state.status ? "开" : "关"}`,
+		mode: acModeLabels,
+		fan,
+		swing,
+		sound
+	};
+}
+/**
+* 能效标签的点阵与等级条布局：蓝白背景的「中国能效标识」，带能效信息码
+* （二维码），样式依据《房间空气调节器能源效率标识实施规则》（CEL 010—2019）。
+*
+* 等级按现行 GB 21455-2019 分 5 级，1 级最高。GB 21455 的修订版征求意见稿
+* （2026 年 5 月）拟改为 3 级、以全年动态能源消耗效率（DAPF）分级；正式发布并
+* 实施后，再更新 `grades`、`standard` 与 `levels`。
+*
+* - `top`：标识名称（白点），右侧是能效信息码
+* - 等级区：首行是 1 级绿色条和指示箭头，`levels` 是 2–5 级
+* - `detail`：生产者、型号、APF 等参数（黑点）
+* - `footer`：依据的国家标准编号（白点）
 */
 const acEnergyLabel = {
+	grade: 1,
+	grades: 5,
+	standard: "GB 21455-2019",
 	top: [{
-		num: 6,
+		num: 4,
 		size: 4,
-		mx: 2,
+		mx: 1.5,
 		my: 0,
 		color: "white"
 	}],
@@ -1001,7 +1434,7 @@ const acEnergyLabel = {
 			width: "50%"
 		},
 		{
-			background: "#ffc107",
+			background: "#fdd835",
 			width: "60%"
 		},
 		{
@@ -1014,5 +1447,11 @@ const acEnergyLabel = {
 		}
 	]
 };
+/**
+* 能效标签的读屏文字。
+*/
+function getAcEnergyLabelText() {
+	return `中国能效标识：能效等级 ${acEnergyLabel.grade} 级（共 ${acEnergyLabel.grades} 级），依据 ${acEnergyLabel.standard}`;
+}
 //#endregion
-export { acAudioFileNames, acEnergyLabel, acIconPaths, acMaxTilt, acModeIcons, acMotion, acReducedMotionDuration, acReducedMotionQuery, acReducer, acShellSize, acSoundIcons, acSoundModeLabels, acSoundModes, acSoundVolumes, acStorageKey, acTone, celsiusToHeatLevel, clampTemperature, createAcAudioController, createAirConditionerStore, createComputePressureSource, createHeatGovernor, createMemoryStorage, defaultAcLimits, defaultAcState, defaultHeatThresholds, getAcActionNotification, getAcScale, getBrowserStorage, getRecommendedTemperatureMessage, getSoundModeMessage, heatLevelRank, heatLevels, isAcSoundMode, isHeatLevel, maxTemperature, minTemperature, nextAcSoundMode, normalizeAcState, observeAcScale, observeAcTilt, planCooling, prefersReducedMotion, readAcState, recommendedColdTemperature, recommendedHotTemperature, renderAcMotionCssVars, resolveAcAudioAssets, soundTimings, writeAcState };
+export { acAirflowAnchors, acAudioFileNames, acDripIntervalRange, acDripMaxTemperature, acEnergyLabel, acFanBars, acFanSoundLevels, acFanSpeedLabels, acFanSpeeds, acFormLabels, acForms, acIconPaths, acLouverMotion, acMaxTilt, acModeIcons, acModeLabels, acModelColors, acModelFiles, acModelParts, acMotion, acReducedMotionDuration, acReducedMotionQuery, acReducer, acShellSize, acSoundIcons, acSoundModeLabels, acSoundModes, acSoundVolumes, acStorageKey, acTone, bindAcPressRepeat, celsiusToHeatLevel, clampTemperature, createAcAudioController, createAcNotificationPresenter, createAirConditionerStore, createComputePressureSource, createHeatGovernor, createMemoryStorage, defaultAcLimits, defaultAcState, defaultHeatThresholds, getAcActionNotification, getAcCondensationStyle, getAcDripInterval, getAcEnergyLabelText, getAcLedColor, getAcMist, getAcRemoteText, getAcScale, getBrowserStorage, getEnergyTip, getFanSpeedMessage, getRecommendedTemperatureMessage, getSoundModeMessage, getSwingMessage, heatLevelRank, heatLevels, isAcFanSpeed, isAcForm, isAcSoundMode, isHeatLevel, maxTemperature, minTemperature, nextAcFanSpeed, nextAcSoundMode, normalizeAcState, observeAcScale, observeAcTilt, planCooling, prefersReducedMotion, readAcState, recommendedColdTemperature, recommendedHotTemperature, renderAcMotionCssVars, resolveAcAudioAssets, soundTimings, writeAcState };