@yunlefun-home/air-conditioner-core 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 YunYouJun 云游君 <me@yunyoujun.cn>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,24 @@
+# @yunlefun-home/air-conditioner-core
+
+Framework-agnostic state, reducer, persistence, audio, and notification helpers for [Yun Air Conditioner](https://ac.yunyoujun.cn/).
+
+## Install
+
+```bash
+pnpm add @yunlefun-home/air-conditioner-core
+```
+
+## Usage
+
+```ts
+import { createAirConditionerStore } from '@yunlefun-home/air-conditioner-core'
+
+const store = createAirConditionerStore()
+store.dispatch({ type: 'status', status: true })
+store.dispatch({ type: 'mode', mode: 'cold' })
+store.dispatch({ type: 'update', payload: { temperature: 26 } })
+```
+
+## License
+
+[MIT](https://github.com/YunYouJun/air-conditioner/blob/dev/LICENSE)

package/dist/index.cjs

@@ -0,0 +1,269 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/constants.ts
+const acStorageKey = "ac:state";
+/**
+* 各模式对应的显示图标（供各框架视图层复用）。
+*/
+const acModeIcons = {
+	cold: "❄️",
+	hot: "☀️"
+};
+/**
+* 默认音频资源文件名（不含扩展名）。
+*
+* - `beep` 按键「嘀」声
+* - `start` 空调启动声
+* - `work` 持续工作（出风）声
+*/
+const acAudioFileNames = {
+	beep: "di",
+	start: "ac-work",
+	work: "air-extractor-fan"
+};
+const minTemperature = 16;
+const maxTemperature = 31;
+const recommendedColdTemperature = 26;
+const recommendedHotTemperature = 20;
+const defaultAcState = {
+	mode: "cold",
+	status: false,
+	temperature: 26
+};
+const soundTimings = {
+	startDelayMs: 8e3,
+	noiseStartTime: 2,
+	noiseDuration: 56
+};
+/**
+* 根据基础路径解析出三个音频文件的完整 URL。
+*
+* 纯字符串拼接，可在任意环境（含 SSR）调用。
+*
+* @param baseUrl 音频目录，如 `/assets/audio`
+* @param ext 文件扩展名，默认 `m4a`
+*/
+function resolveAcAudioAssets(baseUrl = "/assets/audio", ext = "m4a") {
+	const base = baseUrl.replace(/\/$/, "");
+	return {
+		beep: `${base}/${acAudioFileNames.beep}.${ext}`,
+		start: `${base}/${acAudioFileNames.start}.${ext}`,
+		work: `${base}/${acAudioFileNames.work}.${ext}`
+	};
+}
+//#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;
+	}
+	function play(audio) {
+		if (!audio) return;
+		audio.load();
+		audio.play();
+	}
+	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 playStartSound() {
+		play(elements.start);
+		playStartSoundTimeoutId = setTimeout(() => {
+			playWorkSound();
+		}, soundTimings.startDelayMs);
+	}
+	return {
+		beep() {
+			play(elements.beep);
+		},
+		toggleStatusAudio(previousStatus) {
+			if (previousStatus) {
+				clearWorkTimers();
+				if (elements.start) elements.start.load();
+				if (elements.work) elements.work.currentTime = soundTimings.noiseStartTime + soundTimings.noiseDuration;
+			} else {
+				clearWorkTimers();
+				playStartSound();
+			}
+		},
+		dispose() {
+			clearWorkTimers();
+		}
+	};
+}
+//#endregion
+//#region src/reducer.ts
+function normalizeAcState(state) {
+	return {
+		...defaultAcState,
+		...state,
+		temperature: clampTemperature(state?.temperature ?? defaultAcState.temperature)
+	};
+}
+function clampTemperature(temperature) {
+	return Math.min(31, Math.max(16, temperature));
+}
+function acReducer(state, action) {
+	switch (action.type) {
+		case "increment": return {
+			...state,
+			temperature: clampTemperature(state.temperature + 1)
+		};
+		case "decrement": return {
+			...state,
+			temperature: clampTemperature(state.temperature - 1)
+		};
+		case "toggleStatus": return {
+			...state,
+			status: !state.status
+		};
+		case "status": return {
+			...state,
+			status: action.status
+		};
+		case "mode": return {
+			...state,
+			mode: action.mode
+		};
+		case "update": return normalizeAcState({
+			...state,
+			...action.payload
+		});
+		default: throw new Error("Unexpected Ac Action");
+	}
+}
+function getRecommendedTemperatureMessage(mode, temperature) {
+	return `建议将空调的制${mode === "cold" ? "冷" : "热"}温度调至 ${temperature} 度以${mode === "cold" ? "上" : "下"}，为节能减排贡献一份力量！`;
+}
+function getAcActionNotification(previousState, nextState, action) {
+	if (action.type === "increment" && previousState.temperature >= 31) return {
+		message: "已经是最大温度啦！",
+		severity: "error"
+	};
+	if (action.type === "decrement" && previousState.temperature <= 16) return {
+		message: "已经是最小温度啦！",
+		severity: "error"
+	};
+	if (action.type === "mode" && nextState.mode === "cold" && previousState.temperature < 26) return {
+		message: getRecommendedTemperatureMessage("cold", 26),
+		severity: "success"
+	};
+	if (action.type === "mode" && nextState.mode === "hot" && previousState.temperature > 20) return {
+		message: getRecommendedTemperatureMessage("hot", 20),
+		severity: "success"
+	};
+}
+//#endregion
+//#region src/storage.ts
+function readAcState(storage, storageKey) {
+	if (!storage) return defaultAcState;
+	try {
+		const raw = storage.getItem(storageKey);
+		if (!raw) return defaultAcState;
+		return normalizeAcState(JSON.parse(raw));
+	} catch {
+		return defaultAcState;
+	}
+}
+function writeAcState(storage, storageKey, state) {
+	if (!storage) return;
+	try {
+		storage.setItem(storageKey, JSON.stringify(state));
+	} catch {}
+}
+function createMemoryStorage(initialValue) {
+	const values = new Map(Object.entries(initialValue ?? {}));
+	return {
+		getItem(key) {
+			return values.get(key) ?? null;
+		},
+		setItem(key, value) {
+			values.set(key, value);
+		},
+		removeItem(key) {
+			values.delete(key);
+		}
+	};
+}
+function getBrowserStorage() {
+	if (typeof window === "undefined") return null;
+	try {
+		return window.localStorage;
+	} catch {
+		return null;
+	}
+}
+//#endregion
+//#region src/store.ts
+function createAirConditionerStore(options = {}) {
+	const storageKey = options.storageKey ?? "ac:state";
+	const storage = options.storage === void 0 ? getBrowserStorage() : options.storage;
+	const persistedState = readAcState(storage, storageKey);
+	let state = normalizeAcState({
+		...defaultAcState,
+		...persistedState,
+		...options.initialState
+	});
+	const listeners = /* @__PURE__ */ new Set();
+	return {
+		getState() {
+			return state;
+		},
+		dispatch(action) {
+			const previousState = state;
+			const nextState = acReducer(state, action);
+			const notification = getAcActionNotification(previousState, nextState, action);
+			const event = {
+				action,
+				previousState,
+				state: nextState,
+				notification
+			};
+			state = nextState;
+			writeAcState(storage, storageKey, nextState);
+			listeners.forEach((listener) => listener(event));
+			if (notification) options.onNotify?.(notification, event);
+			return event;
+		},
+		subscribe(listener) {
+			listeners.add(listener);
+			return () => {
+				listeners.delete(listener);
+			};
+		}
+	};
+}
+//#endregion
+exports.acAudioFileNames = acAudioFileNames;
+exports.acModeIcons = acModeIcons;
+exports.acReducer = acReducer;
+exports.acStorageKey = acStorageKey;
+exports.clampTemperature = clampTemperature;
+exports.createAcAudioController = createAcAudioController;
+exports.createAirConditionerStore = createAirConditionerStore;
+exports.createMemoryStorage = createMemoryStorage;
+exports.defaultAcState = defaultAcState;
+exports.getAcActionNotification = getAcActionNotification;
+exports.getBrowserStorage = getBrowserStorage;
+exports.getRecommendedTemperatureMessage = getRecommendedTemperatureMessage;
+exports.maxTemperature = maxTemperature;
+exports.minTemperature = minTemperature;
+exports.normalizeAcState = normalizeAcState;
+exports.readAcState = readAcState;
+exports.recommendedColdTemperature = recommendedColdTemperature;
+exports.recommendedHotTemperature = recommendedHotTemperature;
+exports.resolveAcAudioAssets = resolveAcAudioAssets;
+exports.soundTimings = soundTimings;
+exports.writeAcState = writeAcState;

package/dist/index.d.cts

@@ -0,0 +1,134 @@
+//#region src/types.d.ts
+type AcMode = 'cold' | 'hot';
+interface AcState {
+  /**
+   * Whether the air conditioner is powered on.
+   */
+  status: boolean;
+  /**
+   * Current work mode.
+   */
+  mode: AcMode;
+  /**
+   * Target temperature in Celsius.
+   */
+  temperature: number;
+}
+type AcAction = {
+  type: 'increment' | 'decrement' | 'toggleStatus';
+} | {
+  type: 'status';
+  status: AcState['status'];
+} | {
+  type: 'mode';
+  mode: AcState['mode'];
+} | {
+  type: 'update';
+  payload: Partial<AcState>;
+};
+type AcNotificationSeverity = 'success' | 'error' | 'info';
+interface AcNotification {
+  message: string;
+  severity: AcNotificationSeverity;
+}
+interface AcChangeEvent {
+  action: AcAction;
+  previousState: AcState;
+  state: AcState;
+  notification?: AcNotification;
+}
+type AcStoreListener = (event: AcChangeEvent) => void;
+interface AcStorage {
+  getItem: (key: string) => string | null;
+  setItem: (key: string, value: string) => void;
+  removeItem?: (key: string) => void;
+}
+interface CreateAirConditionerStoreOptions {
+  initialState?: Partial<AcState>;
+  storage?: AcStorage | null;
+  storageKey?: string;
+  onNotify?: (notification: AcNotification, event: AcChangeEvent) => void;
+}
+interface AirConditionerStore {
+  getState: () => AcState;
+  dispatch: (action: AcAction) => AcChangeEvent;
+  subscribe: (listener: AcStoreListener) => () => void;
+}
+interface AcAudioElement {
+  currentTime: number;
+  load: () => void;
+  play: () => Promise<unknown> | unknown;
+}
+interface AcAudioElements {
+  start: AcAudioElement | null;
+  work: AcAudioElement | null;
+  beep?: AcAudioElement | null;
+}
+interface AcAudioController {
+  beep: () => void;
+  toggleStatusAudio: (previousStatus: boolean) => void;
+  dispose: () => void;
+}
+//#endregion
+//#region src/audio.d.ts
+declare function createAcAudioController(elements: AcAudioElements): AcAudioController;
+//#endregion
+//#region src/constants.d.ts
+declare const acStorageKey = "ac:state";
+/**
+ * 各模式对应的显示图标（供各框架视图层复用）。
+ */
+declare const acModeIcons: Record<AcMode, string>;
+/**
+ * 默认音频资源文件名（不含扩展名）。
+ *
+ * - `beep` 按键「嘀」声
+ * - `start` 空调启动声
+ * - `work` 持续工作（出风）声
+ */
+declare const acAudioFileNames: {
+  readonly beep: "di";
+  readonly start: "ac-work";
+  readonly work: "air-extractor-fan";
+};
+declare const minTemperature = 16;
+declare const maxTemperature = 31;
+declare const recommendedColdTemperature = 26;
+declare const recommendedHotTemperature = 20;
+declare const defaultAcState: AcState;
+declare const soundTimings: {
+  readonly startDelayMs: 8000;
+  readonly noiseStartTime: 2;
+  readonly noiseDuration: 56;
+};
+/**
+ * 根据基础路径解析出三个音频文件的完整 URL。
+ *
+ * 纯字符串拼接，可在任意环境（含 SSR）调用。
+ *
+ * @param baseUrl 音频目录，如 `/assets/audio`
+ * @param ext 文件扩展名，默认 `m4a`
+ */
+declare function resolveAcAudioAssets(baseUrl?: string, ext?: string): {
+  beep: string;
+  start: string;
+  work: string;
+};
+//#endregion
+//#region src/reducer.d.ts
+declare function normalizeAcState(state: Partial<AcState> | undefined): AcState;
+declare function clampTemperature(temperature: number): number;
+declare function acReducer(state: AcState, action: AcAction): AcState;
+declare function getRecommendedTemperatureMessage(mode: AcState['mode'], temperature: number): string;
+declare function getAcActionNotification(previousState: AcState, nextState: AcState, action: AcAction): AcNotification | undefined;
+//#endregion
+//#region src/storage.d.ts
+declare function readAcState(storage: AcStorage | null | undefined, storageKey: string): AcState;
+declare function writeAcState(storage: AcStorage | null | undefined, storageKey: string, state: AcState): void;
+declare function createMemoryStorage(initialValue?: Record<string, string>): AcStorage;
+declare function getBrowserStorage(): AcStorage | null;
+//#endregion
+//#region src/store.d.ts
+declare function createAirConditionerStore(options?: CreateAirConditionerStoreOptions): AirConditionerStore;
+//#endregion
+export { AcAction, AcAudioController, AcAudioElement, AcAudioElements, AcChangeEvent, AcMode, AcNotification, AcNotificationSeverity, AcState, AcStorage, AcStoreListener, AirConditionerStore, CreateAirConditionerStoreOptions, acAudioFileNames, acModeIcons, acReducer, acStorageKey, clampTemperature, createAcAudioController, createAirConditionerStore, createMemoryStorage, defaultAcState, getAcActionNotification, getBrowserStorage, getRecommendedTemperatureMessage, maxTemperature, minTemperature, normalizeAcState, readAcState, recommendedColdTemperature, recommendedHotTemperature, resolveAcAudioAssets, soundTimings, writeAcState };

package/dist/index.d.ts

@@ -0,0 +1,134 @@
+//#region src/types.d.ts
+type AcMode = 'cold' | 'hot';
+interface AcState {
+  /**
+   * Whether the air conditioner is powered on.
+   */
+  status: boolean;
+  /**
+   * Current work mode.
+   */
+  mode: AcMode;
+  /**
+   * Target temperature in Celsius.
+   */
+  temperature: number;
+}
+type AcAction = {
+  type: 'increment' | 'decrement' | 'toggleStatus';
+} | {
+  type: 'status';
+  status: AcState['status'];
+} | {
+  type: 'mode';
+  mode: AcState['mode'];
+} | {
+  type: 'update';
+  payload: Partial<AcState>;
+};
+type AcNotificationSeverity = 'success' | 'error' | 'info';
+interface AcNotification {
+  message: string;
+  severity: AcNotificationSeverity;
+}
+interface AcChangeEvent {
+  action: AcAction;
+  previousState: AcState;
+  state: AcState;
+  notification?: AcNotification;
+}
+type AcStoreListener = (event: AcChangeEvent) => void;
+interface AcStorage {
+  getItem: (key: string) => string | null;
+  setItem: (key: string, value: string) => void;
+  removeItem?: (key: string) => void;
+}
+interface CreateAirConditionerStoreOptions {
+  initialState?: Partial<AcState>;
+  storage?: AcStorage | null;
+  storageKey?: string;
+  onNotify?: (notification: AcNotification, event: AcChangeEvent) => void;
+}
+interface AirConditionerStore {
+  getState: () => AcState;
+  dispatch: (action: AcAction) => AcChangeEvent;
+  subscribe: (listener: AcStoreListener) => () => void;
+}
+interface AcAudioElement {
+  currentTime: number;
+  load: () => void;
+  play: () => Promise<unknown> | unknown;
+}
+interface AcAudioElements {
+  start: AcAudioElement | null;
+  work: AcAudioElement | null;
+  beep?: AcAudioElement | null;
+}
+interface AcAudioController {
+  beep: () => void;
+  toggleStatusAudio: (previousStatus: boolean) => void;
+  dispose: () => void;
+}
+//#endregion
+//#region src/audio.d.ts
+declare function createAcAudioController(elements: AcAudioElements): AcAudioController;
+//#endregion
+//#region src/constants.d.ts
+declare const acStorageKey = "ac:state";
+/**
+ * 各模式对应的显示图标（供各框架视图层复用）。
+ */
+declare const acModeIcons: Record<AcMode, string>;
+/**
+ * 默认音频资源文件名（不含扩展名）。
+ *
+ * - `beep` 按键「嘀」声
+ * - `start` 空调启动声
+ * - `work` 持续工作（出风）声
+ */
+declare const acAudioFileNames: {
+  readonly beep: "di";
+  readonly start: "ac-work";
+  readonly work: "air-extractor-fan";
+};
+declare const minTemperature = 16;
+declare const maxTemperature = 31;
+declare const recommendedColdTemperature = 26;
+declare const recommendedHotTemperature = 20;
+declare const defaultAcState: AcState;
+declare const soundTimings: {
+  readonly startDelayMs: 8000;
+  readonly noiseStartTime: 2;
+  readonly noiseDuration: 56;
+};
+/**
+ * 根据基础路径解析出三个音频文件的完整 URL。
+ *
+ * 纯字符串拼接，可在任意环境（含 SSR）调用。
+ *
+ * @param baseUrl 音频目录，如 `/assets/audio`
+ * @param ext 文件扩展名，默认 `m4a`
+ */
+declare function resolveAcAudioAssets(baseUrl?: string, ext?: string): {
+  beep: string;
+  start: string;
+  work: string;
+};
+//#endregion
+//#region src/reducer.d.ts
+declare function normalizeAcState(state: Partial<AcState> | undefined): AcState;
+declare function clampTemperature(temperature: number): number;
+declare function acReducer(state: AcState, action: AcAction): AcState;
+declare function getRecommendedTemperatureMessage(mode: AcState['mode'], temperature: number): string;
+declare function getAcActionNotification(previousState: AcState, nextState: AcState, action: AcAction): AcNotification | undefined;
+//#endregion
+//#region src/storage.d.ts
+declare function readAcState(storage: AcStorage | null | undefined, storageKey: string): AcState;
+declare function writeAcState(storage: AcStorage | null | undefined, storageKey: string, state: AcState): void;
+declare function createMemoryStorage(initialValue?: Record<string, string>): AcStorage;
+declare function getBrowserStorage(): AcStorage | null;
+//#endregion
+//#region src/store.d.ts
+declare function createAirConditionerStore(options?: CreateAirConditionerStoreOptions): AirConditionerStore;
+//#endregion
+export { AcAction, AcAudioController, AcAudioElement, AcAudioElements, AcChangeEvent, AcMode, AcNotification, AcNotificationSeverity, AcState, AcStorage, AcStoreListener, AirConditionerStore, CreateAirConditionerStoreOptions, acAudioFileNames, acModeIcons, acReducer, acStorageKey, clampTemperature, createAcAudioController, createAirConditionerStore, createMemoryStorage, defaultAcState, getAcActionNotification, getBrowserStorage, getRecommendedTemperatureMessage, maxTemperature, minTemperature, normalizeAcState, readAcState, recommendedColdTemperature, recommendedHotTemperature, resolveAcAudioAssets, soundTimings, writeAcState };

package/dist/index.js

@@ -0,0 +1,248 @@
+//#region src/constants.ts
+const acStorageKey = "ac:state";
+/**
+* 各模式对应的显示图标（供各框架视图层复用）。
+*/
+const acModeIcons = {
+	cold: "❄️",
+	hot: "☀️"
+};
+/**
+* 默认音频资源文件名（不含扩展名）。
+*
+* - `beep` 按键「嘀」声
+* - `start` 空调启动声
+* - `work` 持续工作（出风）声
+*/
+const acAudioFileNames = {
+	beep: "di",
+	start: "ac-work",
+	work: "air-extractor-fan"
+};
+const minTemperature = 16;
+const maxTemperature = 31;
+const recommendedColdTemperature = 26;
+const recommendedHotTemperature = 20;
+const defaultAcState = {
+	mode: "cold",
+	status: false,
+	temperature: 26
+};
+const soundTimings = {
+	startDelayMs: 8e3,
+	noiseStartTime: 2,
+	noiseDuration: 56
+};
+/**
+* 根据基础路径解析出三个音频文件的完整 URL。
+*
+* 纯字符串拼接，可在任意环境（含 SSR）调用。
+*
+* @param baseUrl 音频目录，如 `/assets/audio`
+* @param ext 文件扩展名，默认 `m4a`
+*/
+function resolveAcAudioAssets(baseUrl = "/assets/audio", ext = "m4a") {
+	const base = baseUrl.replace(/\/$/, "");
+	return {
+		beep: `${base}/${acAudioFileNames.beep}.${ext}`,
+		start: `${base}/${acAudioFileNames.start}.${ext}`,
+		work: `${base}/${acAudioFileNames.work}.${ext}`
+	};
+}
+//#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;
+	}
+	function play(audio) {
+		if (!audio) return;
+		audio.load();
+		audio.play();
+	}
+	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 playStartSound() {
+		play(elements.start);
+		playStartSoundTimeoutId = setTimeout(() => {
+			playWorkSound();
+		}, soundTimings.startDelayMs);
+	}
+	return {
+		beep() {
+			play(elements.beep);
+		},
+		toggleStatusAudio(previousStatus) {
+			if (previousStatus) {
+				clearWorkTimers();
+				if (elements.start) elements.start.load();
+				if (elements.work) elements.work.currentTime = soundTimings.noiseStartTime + soundTimings.noiseDuration;
+			} else {
+				clearWorkTimers();
+				playStartSound();
+			}
+		},
+		dispose() {
+			clearWorkTimers();
+		}
+	};
+}
+//#endregion
+//#region src/reducer.ts
+function normalizeAcState(state) {
+	return {
+		...defaultAcState,
+		...state,
+		temperature: clampTemperature(state?.temperature ?? defaultAcState.temperature)
+	};
+}
+function clampTemperature(temperature) {
+	return Math.min(31, Math.max(16, temperature));
+}
+function acReducer(state, action) {
+	switch (action.type) {
+		case "increment": return {
+			...state,
+			temperature: clampTemperature(state.temperature + 1)
+		};
+		case "decrement": return {
+			...state,
+			temperature: clampTemperature(state.temperature - 1)
+		};
+		case "toggleStatus": return {
+			...state,
+			status: !state.status
+		};
+		case "status": return {
+			...state,
+			status: action.status
+		};
+		case "mode": return {
+			...state,
+			mode: action.mode
+		};
+		case "update": return normalizeAcState({
+			...state,
+			...action.payload
+		});
+		default: throw new Error("Unexpected Ac Action");
+	}
+}
+function getRecommendedTemperatureMessage(mode, temperature) {
+	return `建议将空调的制${mode === "cold" ? "冷" : "热"}温度调至 ${temperature} 度以${mode === "cold" ? "上" : "下"}，为节能减排贡献一份力量！`;
+}
+function getAcActionNotification(previousState, nextState, action) {
+	if (action.type === "increment" && previousState.temperature >= 31) return {
+		message: "已经是最大温度啦！",
+		severity: "error"
+	};
+	if (action.type === "decrement" && previousState.temperature <= 16) return {
+		message: "已经是最小温度啦！",
+		severity: "error"
+	};
+	if (action.type === "mode" && nextState.mode === "cold" && previousState.temperature < 26) return {
+		message: getRecommendedTemperatureMessage("cold", 26),
+		severity: "success"
+	};
+	if (action.type === "mode" && nextState.mode === "hot" && previousState.temperature > 20) return {
+		message: getRecommendedTemperatureMessage("hot", 20),
+		severity: "success"
+	};
+}
+//#endregion
+//#region src/storage.ts
+function readAcState(storage, storageKey) {
+	if (!storage) return defaultAcState;
+	try {
+		const raw = storage.getItem(storageKey);
+		if (!raw) return defaultAcState;
+		return normalizeAcState(JSON.parse(raw));
+	} catch {
+		return defaultAcState;
+	}
+}
+function writeAcState(storage, storageKey, state) {
+	if (!storage) return;
+	try {
+		storage.setItem(storageKey, JSON.stringify(state));
+	} catch {}
+}
+function createMemoryStorage(initialValue) {
+	const values = new Map(Object.entries(initialValue ?? {}));
+	return {
+		getItem(key) {
+			return values.get(key) ?? null;
+		},
+		setItem(key, value) {
+			values.set(key, value);
+		},
+		removeItem(key) {
+			values.delete(key);
+		}
+	};
+}
+function getBrowserStorage() {
+	if (typeof window === "undefined") return null;
+	try {
+		return window.localStorage;
+	} catch {
+		return null;
+	}
+}
+//#endregion
+//#region src/store.ts
+function createAirConditionerStore(options = {}) {
+	const storageKey = options.storageKey ?? "ac:state";
+	const storage = options.storage === void 0 ? getBrowserStorage() : options.storage;
+	const persistedState = readAcState(storage, storageKey);
+	let state = normalizeAcState({
+		...defaultAcState,
+		...persistedState,
+		...options.initialState
+	});
+	const listeners = /* @__PURE__ */ new Set();
+	return {
+		getState() {
+			return state;
+		},
+		dispatch(action) {
+			const previousState = state;
+			const nextState = acReducer(state, action);
+			const notification = getAcActionNotification(previousState, nextState, action);
+			const event = {
+				action,
+				previousState,
+				state: nextState,
+				notification
+			};
+			state = nextState;
+			writeAcState(storage, storageKey, nextState);
+			listeners.forEach((listener) => listener(event));
+			if (notification) options.onNotify?.(notification, event);
+			return event;
+		},
+		subscribe(listener) {
+			listeners.add(listener);
+			return () => {
+				listeners.delete(listener);
+			};
+		}
+	};
+}
+//#endregion
+export { acAudioFileNames, acModeIcons, acReducer, acStorageKey, clampTemperature, createAcAudioController, createAirConditionerStore, createMemoryStorage, defaultAcState, getAcActionNotification, getBrowserStorage, getRecommendedTemperatureMessage, maxTemperature, minTemperature, normalizeAcState, readAcState, recommendedColdTemperature, recommendedHotTemperature, resolveAcAudioAssets, soundTimings, writeAcState };

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@yunlefun-home/air-conditioner-core",
+  "type": "module",
+  "version": "0.2.0",
+  "description": "Framework-agnostic air conditioner state and runtime helpers.",
+  "author": {
+    "url": "https://www.yunyoujun.cn",
+    "email": "me@yunyoujun.cn",
+    "name": "YunYouJun"
+  },
+  "license": "MIT",
+  "homepage": "https://ac.yunyoujun.cn/",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/YunYouJun/air-conditioner"
+  },
+  "keywords": [
+    "air-conditioner",
+    "smart-home",
+    "state-machine",
+    "typescript"
+  ],
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "tsdown": "^0.22.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}