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

package/dist/index.cjs

@@ -22,17 +22,129 @@ const acAudioFileNames = {
 };
 const minTemperature = 16;
 const maxTemperature = 31;
+const defaultAcLimits = {
+	min: 16,
+	max: 31,
+	step: 1
+};
 const recommendedColdTemperature = 26;
 const recommendedHotTemperature = 20;
 const defaultAcState = {
 	mode: "cold",
 	status: false,
-	temperature: 26
+	temperature: 26,
+	temperatures: {
+		cold: 26,
+		hot: 26
+	},
+	sound: "normal",
+	swing: false,
+	fan: "auto"
+};
+/**
+* 遥控器「声音」键依次切换的顺序。
+*/
+const acSoundModes = [
+	"normal",
+	"sleep",
+	"mute"
+];
+/**
+* 各模式的中文名称（遥控器小屏与按键提示共用）。
+*/
+const acModeLabels = {
+	cold: "制冷",
+	hot: "制热"
+};
+const acSoundModeLabels = {
+	normal: "标准",
+	sleep: "睡眠",
+	mute: "静音"
+};
+/**
+* 各声音模式的总音量（0–1）。
+*/
+const acSoundVolumes = {
+	normal: 1,
+	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);
+}
+/**
+* 声音键的下一个模式：标准 → 睡眠 → 静音 → 标准。
+*/
+function nextAcSoundMode(mode) {
+	const index = Math.max(acSoundModes.indexOf(mode), 0);
+	return acSoundModes[(index + 1) % acSoundModes.length];
+}
+/**
+* 音效时序。时长单位为毫秒，`*Level` 是风声相对音量（0–1）。
+*/
 const soundTimings = {
+	/** 开机后多久接上持续的风声（启动声约 9 秒） */
 	startDelayMs: 8e3,
-	noiseStartTime: 2,
-	noiseDuration: 56
+	/** 风声循环首尾的交叉淡化时长 */
+	loopCrossfadeMs: 1500,
+	/** 关机时声音淡出时长 */
+	stopFadeMs: 600,
+	/** 开机运行多久后室温达标、风声降下来 */
+	settleAfterMs: 9e4,
+	/** 风声降下来的渐变时长 */
+	settleRampMs: 2e4,
+	/** 达标后的安静风声 */
+	settleLevel: .5,
+	/** 室温回升、压缩机重新发力时的风声 */
+	surgeLevel: .85,
+	/** 两次发力之间安静运行的时长范围 */
+	quietDurationMs: [18e4, 36e4],
+	/** 每次发力持续的时长范围 */
+	surgeDurationMs: [6e4, 12e4],
+	/** 发力 / 回落的渐变时长 */
+	surgeRampMs: 1e4
 };
 /**
 * 根据基础路径解析出三个音频文件的完整 URL。
@@ -52,79 +164,789 @@ function resolveAcAudioAssets(baseUrl = "/assets/audio", ext = "m4a") {
 }
 //#endregion
 //#region src/audio.ts
-function createAcAudioController(elements) {
-	let playStartSoundTimeoutId;
-	let playWorkSoundTimeoutId;
-	let playWorkSoundIntervalId;
-	function clearWorkTimers() {
-		if (playStartSoundTimeoutId) clearTimeout(playStartSoundTimeoutId);
-		if (playWorkSoundTimeoutId) clearTimeout(playWorkSoundTimeoutId);
-		if (playWorkSoundIntervalId) clearInterval(playWorkSoundIntervalId);
-		playStartSoundTimeoutId = void 0;
-		playWorkSoundTimeoutId = void 0;
-		playWorkSoundIntervalId = void 0;
+/** Web Audio 资源迟迟没加载好时，本次开机先用 `<audio>` 播放 */
+const readyTimeoutMs = 1500;
+const fallbackTweenStepMs = 100;
+const curveLength = 64;
+function sourceUrl(element) {
+	return element?.currentSrc || element?.src || "";
+}
+async function fetchAudioData(url) {
+	const response = await fetch(url);
+	if (!response.ok) throw new Error(`Failed to load ${url}: ${response.status}`);
+	return response.arrayBuffer();
+}
+function createDefaultAudioContext() {
+	const scope = globalThis;
+	const AudioContextConstructor = scope.AudioContext ?? scope.webkitAudioContext;
+	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) {
+	const curve = new Float32Array(curveLength);
+	for (let i = 0; i < curveLength; i++) {
+		const phase = i / 63 * Math.PI / 2;
+		curve[i] = direction === "in" ? Math.sin(phase) : Math.cos(phase);
+	}
+	return curve;
+}
+function randomBetween(range, random) {
+	return range[0] + (range[1] - range[0]) * random();
+}
+function playElement(element) {
+	if (!element) return;
+	element.load();
+	Promise.resolve(element.play()).catch(() => {});
+}
+function stopElement(element) {
+	if (!element) return;
+	if (element.pause) element.pause();
+	else element.load();
+}
+/**
+* 空调音效：按键「嘀」声、开机启动声与持续的风声。
+*
+* 默认通过 Web Audio API 播放：风声无缝循环，开关机淡入淡出，运行一段时间后
+* 风声变小、并不定时随压缩机发力起伏。环境不支持或音频无法获取时退回
+* `<audio>` 元素。
+*
+* 需在用户交互（点击遥控器）里首次调用，浏览器才允许发声。
+*
+* @param elements 三个音频元素；Web Audio 会从它们的 `src` 获取音频
+* @param options 声音模式与可替换的环境依赖
+*/
+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;
+	/** 每次开关机自增，丢弃过期的异步回调 */
+	let session = 0;
+	const timers = /* @__PURE__ */ new Set();
+	/** `<audio>` 播放时的风声相对音量 */
+	let fallbackFanLevel = 1;
+	let fallbackTween;
+	function later(callback, delayMs) {
+		const timer = setTimeout(() => {
+			timers.delete(timer);
+			callback();
+		}, delayMs);
+		timers.add(timer);
+	}
+	function clearTimers() {
+		timers.forEach((timer) => clearTimeout(timer));
+		timers.clear();
+	}
+	function volume() {
+		return acSoundVolumes[soundMode];
+	}
+	function applyElementVolume(element, level = 1) {
+		if (!element) return;
+		if (element.volume !== void 0) element.volume = Math.min(1, Math.max(0, volume() * level));
+		if (element.muted !== void 0) element.muted = soundMode === "mute";
+	}
+	function cancelFallbackTween() {
+		if (fallbackTween) clearInterval(fallbackTween);
+		fallbackTween = void 0;
+	}
+	function tweenFallbackFan(target, durationMs, onDone) {
+		cancelFallbackTween();
+		const from = fallbackFanLevel;
+		const steps = Math.max(1, Math.round(durationMs / fallbackTweenStepMs));
+		let step = 0;
+		fallbackTween = setInterval(() => {
+			step++;
+			fallbackFanLevel = from + (target - from) * (step / steps);
+			applyElementVolume(elements.work, fallbackFanLevel);
+			if (step >= steps) {
+				cancelFallbackTween();
+				onDone?.();
+			}
+		}, fallbackTweenStepMs);
 	}
-	function play(audio) {
-		if (!audio) return;
-		audio.load();
-		audio.play();
+	function ensureEngine() {
+		if (engine !== void 0) return engine;
+		engine = createEngine();
+		return engine;
 	}
-	function playWorkSound() {
-		if (!elements.work) return;
-		play(elements.work);
-		playWorkSoundTimeoutId = setTimeout(() => {
-			playWorkSoundIntervalId = setInterval(() => {
-				if (elements.work) elements.work.currentTime = soundTimings.noiseStartTime;
-			}, soundTimings.noiseDuration * 1e3);
-		}, soundTimings.noiseStartTime * 1e3);
+	function createEngine() {
+		if (options.webAudio === false) return null;
+		let context;
+		try {
+			context = (options.createAudioContext ?? createDefaultAudioContext)();
+		} catch {
+			return null;
+		}
+		if (!context) return null;
+		const master = context.createGain();
+		master.gain.value = volume();
+		master.connect(context.destination);
+		const buffers = {};
+		const load = options.loadAudioData ?? fetchAudioData;
+		const decode = async (name) => {
+			const url = sourceUrl(elements[name]);
+			if (!url) return;
+			try {
+				buffers[name] = await context.decodeAudioData(await load(url));
+			} catch {}
+		};
+		const ready = Promise.all([
+			"beep",
+			"start",
+			"work"
+		].map(decode)).then(() => Boolean(buffers.start && buffers.work));
+		return {
+			context,
+			master,
+			buffers,
+			ready
+		};
+	}
+	function resume(web) {
+		if (web.context.state === "suspended") Promise.resolve(web.context.resume()).catch(() => {});
+	}
+	function waitReady(web) {
+		return Promise.race([web.ready, new Promise((resolve) => setTimeout(resolve, readyTimeoutMs, false))]);
+	}
+	function playBuffer(web, buffer, destination, when) {
+		const source = web.context.createBufferSource();
+		source.buffer = buffer;
+		source.connect(destination);
+		source.start(when);
+		return source;
+	}
+	function track(target, source, cleanup) {
+		target.sources.add(source);
+		source.onended = () => {
+			target.sources.delete(source);
+			source.disconnect();
+			cleanup?.();
+		};
+	}
+	/**
+	* 排一段风声，并在它结束前交叉淡化接上下一段。
+	*/
+	function loopFan(web, target, when) {
+		const buffer = web.buffers.work;
+		const crossfade = Math.min(soundTimings.loopCrossfadeMs / 1e3, buffer.duration / 2);
+		const gain = web.context.createGain();
+		gain.gain.value = 0;
+		gain.gain.setValueCurveAtTime(fadeCurve("in"), when, crossfade);
+		gain.gain.setValueCurveAtTime(fadeCurve("out"), when + buffer.duration - crossfade, crossfade);
+		gain.connect(target.fan);
+		const source = playBuffer(web, buffer, gain, when);
+		source.stop(when + buffer.duration);
+		track(target, source, () => gain.disconnect());
+		const next = when + buffer.duration - crossfade;
+		later(() => {
+			if (run === target) loopFan(web, target, next);
+		}, Math.max(0, (next - web.context.currentTime - 1) * 1e3));
+	}
+	function setFanLevel(level, rampMs) {
+		if (run && engine) {
+			const gain = run.fan.gain;
+			const now = engine.context.currentTime;
+			gain.cancelScheduledValues(now);
+			gain.setValueAtTime(gain.value, now);
+			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);
+	}
+	function startWeb(web) {
+		const output = web.context.createGain();
+		output.connect(web.master);
+		const fan = web.context.createGain();
+		fan.gain.value = initialFanLevel();
+		fan.connect(output);
+		const target = {
+			output,
+			fan,
+			sources: /* @__PURE__ */ new Set()
+		};
+		run = target;
+		const now = web.context.currentTime;
+		track(target, playBuffer(web, web.buffers.start, output, now));
+		loopFan(web, target, now + soundTimings.startDelayMs / 1e3);
+		later(startFanCycle, soundTimings.startDelayMs);
+	}
+	function stopWeb(fadeMs) {
+		const target = run;
+		run = void 0;
+		if (!target || !engine) return;
+		const now = engine.context.currentTime;
+		const end = now + fadeMs / 1e3;
+		const gain = target.output.gain;
+		gain.cancelScheduledValues(now);
+		gain.setValueAtTime(gain.value, now);
+		gain.linearRampToValueAtTime(0, end);
+		target.sources.forEach((source) => {
+			try {
+				source.stop(end);
+			} catch {}
+		});
+		setTimeout(() => target.output.disconnect(), fadeMs + 100);
 	}
-	function playStartSound() {
-		play(elements.start);
-		playStartSoundTimeoutId = setTimeout(() => {
-			playWorkSound();
+	function startFallback() {
+		const { start, work } = elements;
+		stopElement(work);
+		applyElementVolume(start);
+		playElement(start);
+		later(() => {
+			if (!work) return;
+			fallbackFanLevel = 0;
+			applyElementVolume(work, 0);
+			if (work.loop !== void 0) work.loop = true;
+			playElement(work);
+			tweenFallbackFan(initialFanLevel(), soundTimings.loopCrossfadeMs);
+			startFanCycle();
 		}, soundTimings.startDelayMs);
 	}
+	function stopFallback(fadeMs) {
+		stopElement(elements.start);
+		if (fadeMs > 0) tweenFallbackFan(0, fadeMs, () => stopElement(elements.work));
+		else stopElement(elements.work);
+	}
+	function powerOn() {
+		const id = ++session;
+		fanRunning = false;
+		fanCycle++;
+		clearTimers();
+		cancelFallbackTween();
+		stopWeb(0);
+		stopFallback(0);
+		const web = ensureEngine();
+		if (!web) {
+			startFallback();
+			return;
+		}
+		resume(web);
+		waitReady(web).then((ok) => {
+			if (id !== session) return;
+			if (ok) startWeb(web);
+			else startFallback();
+		});
+	}
+	function powerOff() {
+		session++;
+		fanRunning = false;
+		fanCycle++;
+		clearTimers();
+		stopWeb(soundTimings.stopFadeMs);
+		stopFallback(soundTimings.stopFadeMs);
+	}
 	return {
 		beep() {
-			play(elements.beep);
+			if (soundMode === "mute") return;
+			const web = ensureEngine();
+			if (web) {
+				resume(web);
+				if (web.buffers.beep) {
+					playBuffer(web, web.buffers.beep, web.master, web.context.currentTime);
+					return;
+				}
+			}
+			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) {
-				clearWorkTimers();
-				if (elements.start) elements.start.load();
-				if (elements.work) elements.work.currentTime = soundTimings.noiseStartTime + soundTimings.noiseDuration;
+			if (previousStatus) powerOff();
+			else powerOn();
+		},
+		setSoundMode(mode) {
+			soundMode = mode;
+			if (engine) engine.master.gain.setTargetAtTime(volume(), engine.context.currentTime, .08);
+			applyElementVolume(elements.beep);
+			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 {
-				clearWorkTimers();
-				playStartSound();
+				fanCycle++;
+				setFanLevel(acFanSoundLevels[fan], soundTimings.loopCrossfadeMs);
 			}
 		},
 		dispose() {
-			clearWorkTimers();
+			session++;
+			clearTimers();
+			cancelFallbackTween();
+			stopWeb(0);
+			stopFallback(0);
+			if (engine && !options.createAudioContext) Promise.resolve(engine.context.close()).catch(() => {});
+			engine = null;
 		}
 	};
 }
 //#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：各框架视图层共用的时长与缓动曲线。
+*
+* 样式里统一通过 CSS 变量（`--acw-motion-*`）引用，
+* 需要在 JS 里计时的地方（如 React 过渡组件）直接读取 `acMotion`。
+*/
+const acMotion = {
+	duration: {
+		/** 按下反馈 */
+		instant: 90,
+		/** 悬停、指示灯、图标 */
+		fast: 160,
+		/** 显示屏、数字切换、提示 */
+		base: 240,
+		/** 导风板、出风淡入淡出 */
+		slow: 420,
+		/** 出风气流单次循环 */
+		flow: 1800,
+		/** 扫风：左右摆动一个来回 */
+		swing: 5200
+	},
+	easing: {
+		/** 常规状态切换 */
+		standard: "cubic-bezier(0.2, 0, 0, 1)",
+		/** 进入：快起慢停 */
+		enter: "cubic-bezier(0, 0, 0, 1)",
+		/** 退出：慢起快走 */
+		exit: "cubic-bezier(0.3, 0, 1, 1)",
+		/** 轻微回弹（按钮松开、图标弹出） */
+		spring: "cubic-bezier(0.34, 1.56, 0.64, 1)"
+	}
+};
+/**
+* `prefers-reduced-motion: reduce` 时使用的时长：
+* 保留短促的淡入淡出（不涉及位移），去掉较长的过渡；循环动画由各样式表自行关闭。
+*/
+const acReducedMotionDuration = {
+	instant: 0,
+	fast: 80,
+	base: 120,
+	slow: 120,
+	flow: 0,
+	swing: 0
+};
+const acReducedMotionQuery = "(prefers-reduced-motion: reduce)";
+/**
+* 当前环境是否要求减少动效（SSR / 无 matchMedia 时返回 `false`）。
+*/
+function prefersReducedMotion() {
+	return typeof globalThis.matchMedia === "function" && globalThis.matchMedia("(prefers-reduced-motion: reduce)").matches;
+}
+function declarations(durations, withEasing, indent) {
+	const lines = Object.keys(durations).map((key) => `${indent}--acw-motion-duration-${key}: ${durations[key]}ms;`);
+	if (withEasing) for (const key of Object.keys(acMotion.easing)) lines.push(`${indent}--acw-motion-ease-${key}: ${acMotion.easing[key]};`);
+	return lines.join("\n");
+}
+/**
+* 生成动效 CSS 变量声明（含 reduced-motion 覆盖），供 Shadow DOM 注入或样式表同步使用。
+*
+* @param selector 变量挂载的选择器，如 `:root`、`:host`
+*/
+function renderAcMotionCssVars(selector = ":root") {
+	return [
+		`${selector} {`,
+		declarations(acMotion.duration, true, "  "),
+		"}",
+		"",
+		`@media ${acReducedMotionQuery} {`,
+		`  ${selector} {`,
+		declarations(acReducedMotionDuration, false, "    "),
+		"  }",
+		"}"
+	].join("\n");
+}
+//#endregion
+//#region src/layout.ts
+/**
+* 机身的设计尺寸（px），约 3:1，接近真实壁挂机（如 800–900mm × 280–300mm）的比例。
+* 窄容器下按比例整体缩放，保持「长款」外观不被压扁。
+*
+* - `compact`：Vue / React 组件库 / Web Component 使用的 360 × 128 机身
+* - `wide`：React 主站使用的 600 × 200 机身
+*/
+const acShellSize = {
+	compact: {
+		width: 360,
+		height: 128
+	},
+	wide: {
+		width: 600,
+		height: 200
+	}
+};
+/**
+* 根据可用宽度计算机身缩放比例：只缩小、不放大。
+*/
+function getAcScale(availableWidth, designWidth) {
+	if (!(availableWidth > 0) || !(designWidth > 0)) return 1;
+	return Math.min(1, availableWidth / designWidth);
+}
+/**
+* 监听容器宽度变化并回调缩放比例。
+*
+* 不支持 `ResizeObserver` 的环境（如 SSR）直接返回空的清理函数，保持 1 倍显示。
+*
+* @param target 被测量宽度的容器（不要传被缩放的元素本身）
+* @param designWidth 机身的设计宽度
+* @param onScale 比例变化时的回调
+* @returns 停止监听的清理函数
+*/
+function observeAcScale(target, designWidth, onScale) {
+	if (typeof ResizeObserver === "undefined") return () => {};
+	let current;
+	const update = (width) => {
+		const scale = getAcScale(width, designWidth);
+		if (scale !== current) {
+			current = scale;
+			onScale(scale);
+		}
+	};
+	update(target.getBoundingClientRect().width);
+	const observer = new ResizeObserver((entries) => {
+		for (const entry of entries) update(entry.contentRect.width);
+	});
+	observer.observe(target);
+	return () => observer.disconnect();
+}
+/** 指针跟随倾斜的最大角度（deg） */
+const acMaxTilt = 4;
+const finePointerQuery = "(hover: hover) and (pointer: fine)";
+/**
+* 指针在元素上移动时回调轻微的 3D 倾斜角度（`rotateX` / `rotateY`，单位 deg），离开时回到 0。
+*
+* 仅在有悬停能力的精细指针（鼠标 / 触控板）上启用；`prefers-reduced-motion: reduce`、
+* 触屏或 SSR 下直接返回空的清理函数。
+*
+* @returns 停止监听的清理函数
+*/
+function observeAcTilt(target, onTilt, maxTilt = 4) {
+	const matchMedia = globalThis.matchMedia;
+	if (typeof matchMedia !== "function" || !matchMedia(finePointerQuery).matches || matchMedia("(prefers-reduced-motion: reduce)").matches) return () => {};
+	let frame = 0;
+	const schedule = (rotateX, rotateY) => {
+		cancelAnimationFrame(frame);
+		frame = requestAnimationFrame(() => onTilt(rotateX, rotateY));
+	};
+	const onMove = (event) => {
+		const rect = target.getBoundingClientRect();
+		if (!rect.width || !rect.height) return;
+		const x = (event.clientX - rect.left) / rect.width - .5;
+		const y = (event.clientY - rect.top) / rect.height - .5;
+		const round = (value) => Math.round(value * 100) / 100;
+		schedule(round(-y * 2 * maxTilt), round(x * 2 * maxTilt));
+	};
+	const onLeave = () => schedule(0, 0);
+	target.addEventListener("pointermove", onMove);
+	target.addEventListener("pointerleave", onLeave);
+	return () => {
+		cancelAnimationFrame(frame);
+		target.removeEventListener("pointermove", onMove);
+		target.removeEventListener("pointerleave", onLeave);
+	};
+}
+//#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
-function normalizeAcState(state) {
+/**
+* Merge a partial state over the defaults and clamp its temperature.
+*
+* @param state - Partial or stored state
+* @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)
+		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"
 	};
 }
-function clampTemperature(temperature) {
-	return Math.min(31, Math.max(16, temperature));
+/** 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
+	};
+}
+/**
+* Clamp a temperature into range. When `limits` are given the value also
+* snaps to the device step, measured from `limits.min`.
+*
+* @param temperature - Requested temperature in Celsius
+* @param limits - Device limits; omit to clamp to 16–31 °C without snapping
+*/
+function clampTemperature(temperature, limits) {
+	if (!limits) return Math.min(31, Math.max(16, temperature));
+	const { min, max, step } = limits;
+	const snapped = step > 0 ? Math.round((temperature - min) / step) * step + min : temperature;
+	return Number(Math.min(max, Math.max(min, snapped)).toFixed(4));
 }
-function acReducer(state, action) {
+/**
+* Apply an action to the state.
+*
+* @param state - Current state
+* @param action - Action to apply
+* @param limits - Device limits; increments use `limits.step`
+*/
+function acReducer(state, action, limits) {
+	const step = limits?.step ?? defaultAcLimits.step;
 	switch (action.type) {
-		case "increment": return {
-			...state,
-			temperature: clampTemperature(state.temperature + 1)
-		};
-		case "decrement": return {
-			...state,
-			temperature: clampTemperature(state.temperature - 1)
-		};
+		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
@@ -133,36 +955,143 @@ function acReducer(state, action) {
 			...state,
 			status: action.status
 		};
-		case "mode": return {
+		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
+		};
+		case "cycleSound": return {
+			...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,
-			mode: action.mode
+			fan: nextAcFanSpeed(state.fan)
 		};
 		case "update": return normalizeAcState({
 			...state,
 			...action.payload
-		});
+		}, 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" ? "上" : "下"}，为节能减排贡献一份力量！`;
 }
-function getAcActionNotification(previousState, nextState, action) {
-	if (action.type === "increment" && previousState.temperature >= 31) return {
+function getSoundModeMessage(sound) {
+	return `${acSoundModeLabels[sound]}模式：${{
+		normal: "风声和按键音恢复正常",
+		sleep: "风声和按键音都调小了，晚安",
+		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`.
+*
+* @param state - Current state
+*/
+function acTone(state) {
+	if (!state.status) return "idle";
+	return state.mode === "hot" ? "heat" : "cool";
+}
+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 <= 16) return {
+	if (action.type === "decrement" && previousState.temperature <= limits.min) return {
 		message: "已经是最小温度啦！",
-		severity: "error"
+		severity: "error",
+		kind: "limit"
 	};
-	if (action.type === "mode" && nextState.mode === "cold" && previousState.temperature < 26) return {
-		message: getRecommendedTemperatureMessage("cold", 26),
-		severity: "success"
+	if ((action.type === "sound" || action.type === "cycleSound") && nextState.sound !== previousState.sound) return {
+		message: getSoundModeMessage(nextState.sound),
+		severity: "info",
+		kind: "setting"
 	};
-	if (action.type === "mode" && nextState.mode === "hot" && previousState.temperature > 20) return {
-		message: getRecommendedTemperatureMessage("hot", 20),
-		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 === "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
@@ -211,11 +1140,12 @@ function createAirConditionerStore(options = {}) {
 	const storageKey = options.storageKey ?? "ac:state";
 	const storage = options.storage === void 0 ? getBrowserStorage() : options.storage;
 	const persistedState = readAcState(storage, storageKey);
+	const limits = options.limits;
 	let state = normalizeAcState({
 		...defaultAcState,
 		...persistedState,
 		...options.initialState
-	});
+	}, limits);
 	const listeners = /* @__PURE__ */ new Set();
 	return {
 		getState() {
@@ -223,8 +1153,8 @@ function createAirConditionerStore(options = {}) {
 		},
 		dispatch(action) {
 			const previousState = state;
-			const nextState = acReducer(state, action);
-			const notification = getAcActionNotification(previousState, nextState, action);
+			const nextState = acReducer(state, action, limits);
+			const notification = getAcActionNotification(previousState, nextState, action, limits);
 			const event = {
 				action,
 				previousState,
@@ -246,24 +1176,360 @@ function createAirConditionerStore(options = {}) {
 	};
 }
 //#endregion
+//#region src/thermal/levels.ts
+const heatLevels = [
+	"nominal",
+	"fair",
+	"serious",
+	"critical"
+];
+/** Default Celsius thresholds for fair, serious and critical. */
+const defaultHeatThresholds = [
+	60,
+	75,
+	90
+];
+/**
+* @param level - A heat level
+* @returns Its rank from 0 (nominal) to 3 (critical)
+*/
+function heatLevelRank(level) {
+	return heatLevels.indexOf(level);
+}
+function isHeatLevel(value) {
+	return heatLevels.includes(value);
+}
+/**
+* Convert a temperature to a heat level. With a previous level, the value
+* must fall `hysteresis` degrees below a threshold before dropping a level,
+* which keeps readings near a threshold from flickering.
+*
+* @param celsius - Measured temperature
+* @param thresholds - Lower bounds for fair, serious and critical
+* @param previous - Level from the previous reading
+* @param hysteresis - Degrees required below a threshold to step down
+*/
+function celsiusToHeatLevel(celsius, thresholds = defaultHeatThresholds, previous, hysteresis = 5) {
+	const raw = thresholds.filter((threshold) => celsius >= threshold).length;
+	if (previous === void 0) return heatLevels[raw];
+	const held = thresholds.filter((threshold) => celsius >= threshold - hysteresis).length;
+	return heatLevels[Math.max(raw, Math.min(heatLevelRank(previous), held))];
+}
+/**
+* Create a filter that raises the level immediately but only lowers it after
+* lower readings persist for `dwellMs`, measured with `reading.at`.
+*
+* @param options - Governor options
+* @param options.dwellMs - Time a lower level must persist; defaults to 30 seconds
+* @returns A function that maps each reading to the settled level
+*/
+function createHeatGovernor(options = {}) {
+	const dwellMs = options.dwellMs ?? 3e4;
+	let current;
+	let lowerSince;
+	return (reading) => {
+		if (current === void 0 || heatLevelRank(reading.level) >= heatLevelRank(current)) {
+			current = reading.level;
+			lowerSince = void 0;
+			return current;
+		}
+		lowerSince ??= reading.at;
+		if (reading.at - lowerSince >= dwellMs) {
+			current = reading.level;
+			lowerSince = void 0;
+		}
+		return current;
+	};
+}
+//#endregion
+//#region src/thermal/plan.ts
+const coolingByLevel = {
+	fair: {
+		temperature: 26,
+		airflow: .4
+	},
+	serious: {
+		temperature: 24,
+		airflow: .7
+	},
+	critical: {
+		temperature: 22,
+		airflow: 1
+	}
+};
+/**
+* Decide how the virtual air conditioner should respond to a heat level.
+*
+* @param level - Settled heat level
+* @param limits - Device limits used to clamp the target temperature
+* @returns A cooling plan, or `null` at `nominal` so the user keeps control
+*/
+function planCooling(level, limits) {
+	if (level === "nominal") return null;
+	const { temperature, airflow } = coolingByLevel[level];
+	return {
+		status: true,
+		mode: "cold",
+		temperature: clampTemperature(temperature, limits),
+		airflow
+	};
+}
+//#endregion
+//#region src/thermal/pressure.ts
+function getPressureObserver() {
+	return globalThis.PressureObserver;
+}
+/**
+* Heat source backed by the browser Compute Pressure API. It reports CPU
+* load levels, not temperatures; browsers expose no CPU temperature.
+*
+* Supported in Chromium-based browsers on secure origins. The API is only
+* touched when the source is started.
+*
+* @param options - Sampling and error handling options
+*/
+function createComputePressureSource(options = {}) {
+	return {
+		id: "compute-pressure",
+		isSupported: () => typeof getPressureObserver() === "function",
+		start(listener) {
+			const Observer = getPressureObserver();
+			if (!Observer) return () => {};
+			let stopped = false;
+			const observer = new Observer((records) => {
+				const record = records.at(-1);
+				if (stopped || !record || !isHeatLevel(record.state)) return;
+				listener({
+					level: record.state,
+					source: "compute-pressure",
+					at: Date.now()
+				});
+			});
+			observer.observe("cpu", { sampleInterval: options.sampleIntervalMs ?? 2e3 }).catch((error) => {
+				if (!stopped) options.onError?.(error);
+			});
+			return () => {
+				stopped = true;
+				observer.disconnect();
+			};
+		}
+	};
+}
+//#endregion
+//#region src/icons.ts
+/**
+* 遥控器按钮与提示图标（24 × 24 viewBox 的 SVG path），全部来自 Material Design
+* Icons，和站点通过 UnoCSS presetIcons 使用的 i-mdi-* 是同一套。
+*/
+const acIconPaths = {
+	/** 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
+/**
+* 声音键在各声音模式下显示的图标。
+*/
+const acSoundIcons = {
+	normal: "soundNormal",
+	sleep: "soundSleep",
+	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: 4,
+		size: 4,
+		mx: 1.5,
+		my: 0,
+		color: "white"
+	}],
+	detail: [
+		{
+			num: 11,
+			size: 2,
+			mx: .8,
+			my: 2,
+			color: "black"
+		},
+		{
+			num: 9,
+			size: 1.5,
+			mx: .8,
+			my: 2,
+			color: "black"
+		},
+		{
+			num: 10,
+			size: 1.2,
+			mx: .8,
+			my: 0,
+			color: "black"
+		}
+	],
+	footer: {
+		num: 8,
+		size: 2,
+		mx: .8,
+		my: 0,
+		color: "white"
+	},
+	levels: [
+		{
+			background: "lightgreen",
+			width: "50%"
+		},
+		{
+			background: "#fdd835",
+			width: "60%"
+		},
+		{
+			background: "orange",
+			width: "70%"
+		},
+		{
+			background: "red",
+			width: "80%"
+		}
+	]
+};
+/**
+* 能效标签的读屏文字。
+*/
+function getAcEnergyLabelText() {
+	return `中国能效标识：能效等级 ${acEnergyLabel.grade} 级（共 ${acEnergyLabel.grades} 级），依据 ${acEnergyLabel.standard}`;
+}
+//#endregion
+exports.acAirflowAnchors = acAirflowAnchors;
 exports.acAudioFileNames = acAudioFileNames;
+exports.acDripIntervalRange = acDripIntervalRange;
+exports.acDripMaxTemperature = acDripMaxTemperature;
+exports.acEnergyLabel = acEnergyLabel;
+exports.acFanBars = acFanBars;
+exports.acFanSoundLevels = acFanSoundLevels;
+exports.acFanSpeedLabels = acFanSpeedLabels;
+exports.acFanSpeeds = acFanSpeeds;
+exports.acFormLabels = acFormLabels;
+exports.acForms = acForms;
+exports.acIconPaths = acIconPaths;
+exports.acLouverMotion = acLouverMotion;
+exports.acMaxTilt = acMaxTilt;
 exports.acModeIcons = acModeIcons;
+exports.acModeLabels = acModeLabels;
+exports.acModelColors = acModelColors;
+exports.acModelFiles = acModelFiles;
+exports.acModelParts = acModelParts;
+exports.acMotion = acMotion;
+exports.acReducedMotionDuration = acReducedMotionDuration;
+exports.acReducedMotionQuery = acReducedMotionQuery;
 exports.acReducer = acReducer;
+exports.acShellSize = acShellSize;
+exports.acSoundIcons = acSoundIcons;
+exports.acSoundModeLabels = acSoundModeLabels;
+exports.acSoundModes = acSoundModes;
+exports.acSoundVolumes = acSoundVolumes;
 exports.acStorageKey = acStorageKey;
+exports.acTone = acTone;
+exports.bindAcPressRepeat = bindAcPressRepeat;
+exports.celsiusToHeatLevel = celsiusToHeatLevel;
 exports.clampTemperature = clampTemperature;
 exports.createAcAudioController = createAcAudioController;
+exports.createAcNotificationPresenter = createAcNotificationPresenter;
 exports.createAirConditionerStore = createAirConditionerStore;
+exports.createComputePressureSource = createComputePressureSource;
+exports.createHeatGovernor = createHeatGovernor;
 exports.createMemoryStorage = createMemoryStorage;
+exports.defaultAcLimits = defaultAcLimits;
 exports.defaultAcState = defaultAcState;
+exports.defaultHeatThresholds = defaultHeatThresholds;
 exports.getAcActionNotification = getAcActionNotification;
+exports.getAcCondensationStyle = getAcCondensationStyle;
+exports.getAcDripInterval = getAcDripInterval;
+exports.getAcEnergyLabelText = getAcEnergyLabelText;
+exports.getAcLedColor = getAcLedColor;
+exports.getAcMist = getAcMist;
+exports.getAcRemoteText = getAcRemoteText;
+exports.getAcScale = getAcScale;
 exports.getBrowserStorage = getBrowserStorage;
+exports.getEnergyTip = getEnergyTip;
+exports.getFanSpeedMessage = getFanSpeedMessage;
 exports.getRecommendedTemperatureMessage = getRecommendedTemperatureMessage;
+exports.getSoundModeMessage = getSoundModeMessage;
+exports.getSwingMessage = getSwingMessage;
+exports.heatLevelRank = heatLevelRank;
+exports.heatLevels = heatLevels;
+exports.isAcFanSpeed = isAcFanSpeed;
+exports.isAcForm = isAcForm;
+exports.isAcSoundMode = isAcSoundMode;
+exports.isHeatLevel = isHeatLevel;
 exports.maxTemperature = maxTemperature;
 exports.minTemperature = minTemperature;
+exports.nextAcFanSpeed = nextAcFanSpeed;
+exports.nextAcSoundMode = nextAcSoundMode;
 exports.normalizeAcState = normalizeAcState;
+exports.observeAcScale = observeAcScale;
+exports.observeAcTilt = observeAcTilt;
+exports.planCooling = planCooling;
+exports.prefersReducedMotion = prefersReducedMotion;
 exports.readAcState = readAcState;
 exports.recommendedColdTemperature = recommendedColdTemperature;
 exports.recommendedHotTemperature = recommendedHotTemperature;
+exports.renderAcMotionCssVars = renderAcMotionCssVars;
 exports.resolveAcAudioAssets = resolveAcAudioAssets;
 exports.soundTimings = soundTimings;
 exports.writeAcState = writeAcState;