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

package/dist/index.d.cts

@@ -1,6 +1,24 @@
 //#region src/types.d.ts
-type AcMode = 'cold' | 'hot';
-interface AcState {
+export type AcMode = 'cold' | 'hot';
+/**
+ * Sound mode: `normal` plays everything, `sleep` lowers the volume,
+ * `mute` silences the air conditioner.
+ */
+export type AcSoundMode = 'normal' | 'sleep' | 'mute';
+/**
+ * Temperature range a device supports. Real devices (e.g. Home Assistant
+ * climate entities) report their own range and step.
+ */
+export interface AcLimits {
+  min: number;
+  max: number;
+  step: number;
+}
+/**
+ * Visual tone of the unit: idle when off, otherwise follows the mode.
+ */
+export type AcTone = 'idle' | 'cool' | 'heat';
+export interface AcState {
   /**
    * Whether the air conditioner is powered on.
    */
@@ -13,72 +31,136 @@ interface AcState {
    * Target temperature in Celsius.
    */
   temperature: number;
+  /**
+   * Sound mode. States saved before this field existed fall back to `normal`.
+   */
+  sound: AcSoundMode;
 }
-type AcAction = {
-  type: 'increment' | 'decrement' | 'toggleStatus';
+export type AcAction = {
+  type: 'increment' | 'decrement' | 'toggleStatus' | 'cycleSound';
 } | {
   type: 'status';
   status: AcState['status'];
 } | {
   type: 'mode';
   mode: AcState['mode'];
+} | {
+  type: 'sound';
+  sound: AcState['sound'];
 } | {
   type: 'update';
   payload: Partial<AcState>;
 };
-type AcNotificationSeverity = 'success' | 'error' | 'info';
-interface AcNotification {
+export type AcNotificationSeverity = 'success' | 'error' | 'info';
+export interface AcNotification {
   message: string;
   severity: AcNotificationSeverity;
 }
-interface AcChangeEvent {
+export interface AcChangeEvent {
   action: AcAction;
   previousState: AcState;
   state: AcState;
   notification?: AcNotification;
 }
-type AcStoreListener = (event: AcChangeEvent) => void;
-interface AcStorage {
+export type AcStoreListener = (event: AcChangeEvent) => void;
+export interface AcStorage {
   getItem: (key: string) => string | null;
   setItem: (key: string, value: string) => void;
   removeItem?: (key: string) => void;
 }
-interface CreateAirConditionerStoreOptions {
+export interface CreateAirConditionerStoreOptions {
   initialState?: Partial<AcState>;
+  /**
+   * Device temperature limits. Defaults to 16–31 °C with a step of 1.
+   */
+  limits?: AcLimits;
   storage?: AcStorage | null;
   storageKey?: string;
   onNotify?: (notification: AcNotification, event: AcChangeEvent) => void;
 }
-interface AirConditionerStore {
+export interface AirConditionerStore {
   getState: () => AcState;
   dispatch: (action: AcAction) => AcChangeEvent;
   subscribe: (listener: AcStoreListener) => () => void;
 }
-interface AcAudioElement {
+/**
+ * The subset of `HTMLAudioElement` the audio controller uses. The optional
+ * members let it pause, loop and set volume when they exist.
+ */
+export interface AcAudioElement {
   currentTime: number;
   load: () => void;
   play: () => Promise<unknown> | unknown;
+  pause?: () => void;
+  volume?: number;
+  muted?: boolean;
+  loop?: boolean;
+  /** Used to fetch the file for Web Audio playback. */
+  src?: string;
+  currentSrc?: string;
 }
-interface AcAudioElements {
+export interface AcAudioElements {
   start: AcAudioElement | null;
   work: AcAudioElement | null;
   beep?: AcAudioElement | null;
 }
-interface AcAudioController {
+export interface AcAudioController {
   beep: () => void;
   toggleStatusAudio: (previousStatus: boolean) => void;
+  /**
+   * Change the volume of everything, including sounds already playing.
+   */
+  setSoundMode: (mode: AcSoundMode) => void;
   dispose: () => void;
 }
+export interface CreateAcAudioControllerOptions {
+  /**
+   * Initial sound mode.
+   * @default 'normal'
+   */
+  soundMode?: AcSoundMode;
+  /**
+   * Play through the Web Audio API for a gapless loop and smooth fades.
+   * Falls back to the `<audio>` elements when the API is missing or the
+   * files cannot be fetched (for example across origins without CORS).
+   * @default true
+   */
+  webAudio?: boolean;
+  /**
+   * Create the `AudioContext`. Defaults to `new AudioContext()`.
+   */
+  createAudioContext?: () => AudioContext;
+  /**
+   * Fetch an audio file. Defaults to `fetch(url)`.
+   */
+  loadAudioData?: (url: string) => Promise<ArrayBuffer>;
+  /**
+   * Random source for the fan's quiet / busy cycle. Defaults to `Math.random`.
+   */
+  random?: () => number;
+}
 //#endregion
 //#region src/audio.d.ts
-declare function createAcAudioController(elements: AcAudioElements): AcAudioController;
+/**
+ * 空调音效：按键「嘀」声、开机启动声与持续的风声。
+ *
+ * 默认通过 Web Audio API 播放：风声无缝循环，开关机淡入淡出，运行一段时间后
+ * 风声变小、并不定时随压缩机发力起伏。环境不支持或音频无法获取时退回
+ * `<audio>` 元素。
+ *
+ * 需在用户交互（点击遥控器）里首次调用，浏览器才允许发声。
+ *
+ * @param elements 三个音频元素；Web Audio 会从它们的 `src` 获取音频
+ * @param options 声音模式与可替换的环境依赖
+ */
+export declare function createAcAudioController(elements: AcAudioElements, options?: CreateAcAudioControllerOptions): AcAudioController;
 //#endregion
 //#region src/constants.d.ts
-declare const acStorageKey = "ac:state";
+export declare const acStorageKey = "ac:state";
 /**
  * 各模式对应的显示图标（供各框架视图层复用）。
  */
-declare const acModeIcons: Record<AcMode, string>;
+export declare const acModeIcons: Record<AcMode, string>;
 /**
  * 默认音频资源文件名（不含扩展名）。
  *
@@ -86,20 +168,55 @@ declare const acModeIcons: Record<AcMode, string>;
  * - `start` 空调启动声
  * - `work` 持续工作（出风）声
  */
-declare const acAudioFileNames: {
+export 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: {
+export declare const minTemperature = 16;
+export declare const maxTemperature = 31;
+export declare const defaultAcLimits: AcLimits;
+export declare const recommendedColdTemperature = 26;
+export declare const recommendedHotTemperature = 20;
+export declare const defaultAcState: AcState;
+/**
+ * 遥控器「声音」键依次切换的顺序。
+ */
+export declare const acSoundModes: readonly AcSoundMode[];
+export declare const acSoundModeLabels: Record<AcSoundMode, string>;
+/**
+ * 各声音模式的总音量（0–1）。
+ */
+export declare const acSoundVolumes: Record<AcSoundMode, number>;
+export declare function isAcSoundMode(value: unknown): value is AcSoundMode;
+/**
+ * 声音键的下一个模式：标准 → 睡眠 → 静音 → 标准。
+ */
+export declare function nextAcSoundMode(mode: AcSoundMode | undefined): AcSoundMode;
+/**
+ * 音效时序。时长单位为毫秒，`*Level` 是风声相对音量（0–1）。
+ */
+export declare const soundTimings: {
+  /** 开机后多久接上持续的风声（启动声约 9 秒） */
   readonly startDelayMs: 8000;
-  readonly noiseStartTime: 2;
-  readonly noiseDuration: 56;
+  /** 风声循环首尾的交叉淡化时长 */
+  readonly loopCrossfadeMs: 1500;
+  /** 关机时声音淡出时长 */
+  readonly stopFadeMs: 600;
+  /** 开机运行多久后室温达标、风声降下来 */
+  readonly settleAfterMs: 90000;
+  /** 风声降下来的渐变时长 */
+  readonly settleRampMs: 20000;
+  /** 达标后的安静风声 */
+  readonly settleLevel: 0.5;
+  /** 室温回升、压缩机重新发力时的风声 */
+  readonly surgeLevel: 0.85;
+  /** 两次发力之间安静运行的时长范围 */
+  readonly quietDurationMs: readonly [180000, 360000];
+  /** 每次发力持续的时长范围 */
+  readonly surgeDurationMs: readonly [60000, 120000];
+  /** 发力 / 回落的渐变时长 */
+  readonly surgeRampMs: 10000;
 };
 /**
  * 根据基础路径解析出三个音频文件的完整 URL。
@@ -109,26 +226,297 @@ declare const soundTimings: {
  * @param baseUrl 音频目录，如 `/assets/audio`
  * @param ext 文件扩展名，默认 `m4a`
  */
-declare function resolveAcAudioAssets(baseUrl?: string, ext?: string): {
+export declare function resolveAcAudioAssets(baseUrl?: string, ext?: string): {
   beep: string;
   start: string;
   work: string;
 };
 //#endregion
+//#region src/layout.d.ts
+/**
+ * 机身的设计尺寸（px），约 3:1，接近真实壁挂机（如 800–900mm × 280–300mm）的比例。
+ * 窄容器下按比例整体缩放，保持「长款」外观不被压扁。
+ *
+ * - `compact`：Vue / React 组件库 / Web Component 使用的 360 × 128 机身
+ * - `wide`：React 主站使用的 600 × 200 机身
+ */
+export declare const acShellSize: {
+  readonly compact: {
+    readonly width: 360;
+    readonly height: 128;
+  };
+  readonly wide: {
+    readonly width: 600;
+    readonly height: 200;
+  };
+};
+/**
+ * 根据可用宽度计算机身缩放比例：只缩小、不放大。
+ */
+export declare function getAcScale(availableWidth: number, designWidth: number): number;
+/**
+ * 监听容器宽度变化并回调缩放比例。
+ *
+ * 不支持 `ResizeObserver` 的环境（如 SSR）直接返回空的清理函数，保持 1 倍显示。
+ *
+ * @param target 被测量宽度的容器（不要传被缩放的元素本身）
+ * @param designWidth 机身的设计宽度
+ * @param onScale 比例变化时的回调
+ * @returns 停止监听的清理函数
+ */
+export declare function observeAcScale(target: Element, designWidth: number, onScale: (scale: number) => void): () => void;
+/** 指针跟随倾斜的最大角度（deg） */
+export declare const acMaxTilt = 4;
+/**
+ * 指针在元素上移动时回调轻微的 3D 倾斜角度（`rotateX` / `rotateY`，单位 deg），离开时回到 0。
+ *
+ * 仅在有悬停能力的精细指针（鼠标 / 触控板）上启用；`prefers-reduced-motion: reduce`、
+ * 触屏或 SSR 下直接返回空的清理函数。
+ *
+ * @returns 停止监听的清理函数
+ */
+export declare function observeAcTilt(target: HTMLElement, onTilt: (rotateX: number, rotateY: number) => void, maxTilt?: number): () => void;
+//#endregion
+//#region src/motion.d.ts
+/**
+ * 动效 token：各框架视图层共用的时长与缓动曲线。
+ *
+ * 样式里统一通过 CSS 变量（`--acw-motion-*`）引用，
+ * 需要在 JS 里计时的地方（如 React 过渡组件）直接读取 `acMotion`。
+ */
+export declare const acMotion: {
+  readonly duration: {
+    /** 按下反馈 */
+    readonly instant: 90;
+    /** 悬停、指示灯、图标 */
+    readonly fast: 160;
+    /** 显示屏、数字切换、提示 */
+    readonly base: 240;
+    /** 导风板、出风淡入淡出 */
+    readonly slow: 420;
+    /** 出风气流单次循环 */
+    readonly flow: 1800;
+  };
+  readonly easing: {
+    /** 常规状态切换 */
+    readonly standard: "cubic-bezier(0.2, 0, 0, 1)";
+    /** 进入：快起慢停 */
+    readonly enter: "cubic-bezier(0, 0, 0, 1)";
+    /** 退出：慢起快走 */
+    readonly exit: "cubic-bezier(0.3, 0, 1, 1)";
+    /** 轻微回弹（按钮松开、图标弹出） */
+    readonly spring: "cubic-bezier(0.34, 1.56, 0.64, 1)";
+  };
+};
+export type AcMotionDuration = keyof typeof acMotion.duration;
+export type AcMotionEasing = keyof typeof acMotion.easing;
+/**
+ * `prefers-reduced-motion: reduce` 时使用的时长：
+ * 保留短促的淡入淡出（不涉及位移），去掉较长的过渡；循环动画由各样式表自行关闭。
+ */
+export declare const acReducedMotionDuration: Record<AcMotionDuration, number>;
+export declare const acReducedMotionQuery = "(prefers-reduced-motion: reduce)";
+/**
+ * 当前环境是否要求减少动效（SSR / 无 matchMedia 时返回 `false`）。
+ */
+export declare function prefersReducedMotion(): boolean;
+/**
+ * 生成动效 CSS 变量声明（含 reduced-motion 覆盖），供 Shadow DOM 注入或样式表同步使用。
+ *
+ * @param selector 变量挂载的选择器，如 `:root`、`:host`
+ */
+export declare function renderAcMotionCssVars(selector?: string): 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;
+/**
+ * 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
+ */
+export declare function normalizeAcState(state: Partial<AcState> | undefined, limits?: AcLimits): AcState;
+/**
+ * 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
+ */
+export declare function clampTemperature(temperature: number, limits?: AcLimits): number;
+/**
+ * Apply an action to the state.
+ *
+ * @param state - Current state
+ * @param action - Action to apply
+ * @param limits - Device limits; increments use `limits.step`
+ */
+export declare function acReducer(state: AcState, action: AcAction, limits?: AcLimits): AcState;
+export declare function getRecommendedTemperatureMessage(mode: AcState['mode'], temperature: number): string;
+export declare function getSoundModeMessage(sound: AcState['sound']): string;
+/**
+ * Visual tone for a state: `idle` when off, otherwise `cool` or `heat`.
+ *
+ * @param state - Current state
+ */
+export declare function acTone(state: Pick<AcState, 'status' | 'mode'>): AcTone;
+export declare function getAcActionNotification(previousState: AcState, nextState: AcState, action: AcAction, limits?: AcLimits): 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;
+export declare function readAcState(storage: AcStorage | null | undefined, storageKey: string): AcState;
+export declare function writeAcState(storage: AcStorage | null | undefined, storageKey: string, state: AcState): void;
+export declare function createMemoryStorage(initialValue?: Record<string, string>): AcStorage;
+export declare function getBrowserStorage(): AcStorage | null;
 //#endregion
 //#region src/store.d.ts
-declare function createAirConditionerStore(options?: CreateAirConditionerStoreOptions): AirConditionerStore;
+export declare function createAirConditionerStore(options?: CreateAirConditionerStoreOptions): AirConditionerStore;
+//#endregion
+//#region src/thermal/types.d.ts
+/**
+ * Heat levels shared by the browser Compute Pressure API and macOS
+ * `ProcessInfo.ThermalState`, so web and native hosts speak the same language.
+ */
+export type HeatLevel = 'nominal' | 'fair' | 'serious' | 'critical';
+export interface HeatReading {
+  level: HeatLevel;
+  /** Real temperature, only when the source can measure one */
+  celsius?: number;
+  /** Identifier of the source that produced the reading */
+  source: string;
+  /** Epoch milliseconds */
+  at: number;
+}
+/**
+ * Something that reports how hot a computer is.
+ */
+export interface HeatSource {
+  id: string;
+  /** Whether the current environment can provide readings */
+  isSupported: () => boolean;
+  /**
+   * Start delivering readings.
+   *
+   * @returns A function that stops the source
+   */
+  start: (listener: (reading: HeatReading) => void) => () => void;
+}
+/**
+ * What the virtual air conditioner should do for a heat level.
+ */
+export interface CoolingPlan {
+  status: true;
+  mode: 'cold';
+  temperature: number;
+  /** 0–1, drives airflow intensity */
+  airflow: number;
+}
+//#endregion
+//#region src/thermal/levels.d.ts
+export declare const heatLevels: readonly HeatLevel[];
+/** Default Celsius thresholds for fair, serious and critical. */
+export declare const defaultHeatThresholds: readonly [number, number, number];
+/**
+ * @param level - A heat level
+ * @returns Its rank from 0 (nominal) to 3 (critical)
+ */
+export declare function heatLevelRank(level: HeatLevel): number;
+export declare function isHeatLevel(value: unknown): value is HeatLevel;
+/**
+ * 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
+ */
+export declare function celsiusToHeatLevel(celsius: number, thresholds?: readonly [number, number, number], previous?: HeatLevel, hysteresis?: number): HeatLevel;
+/**
+ * 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
+ */
+export declare function createHeatGovernor(options?: {
+  dwellMs?: number;
+}): (reading: HeatReading) => HeatLevel;
 //#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 };
+//#region src/thermal/plan.d.ts
+/**
+ * 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
+ */
+export declare function planCooling(level: HeatLevel, limits?: AcLimits): CoolingPlan | null;
+//#endregion
+//#region src/thermal/pressure.d.ts
+export interface ComputePressureSourceOptions {
+  /** Requested sample interval; browsers may deliver less often */
+  sampleIntervalMs?: number;
+  /** Called when observing fails, e.g. blocked by permissions policy */
+  onError?: (error: unknown) => void;
+}
+/**
+ * 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
+ */
+export declare function createComputePressureSource(options?: ComputePressureSourceOptions): HeatSource;
+//#endregion
+//#region src/ui.d.ts
+/**
+ * 各框架视图层共用的界面数据：遥控器图标与能效标签的点阵布局。
+ * 保证 Vue / React / Web Component 渲染出完全一致的空调外观。
+ */
+/**
+ * 遥控器按钮图标（24 × 24 viewBox 的 SVG path）。
+ */
+export declare const acIconPaths: {
+  readonly 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";
+  readonly 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";
+  readonly 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";
+  readonly increase: "m12 8l6 8H6z";
+  readonly decrease: "m12 16l-6-8h12z";
+  readonly 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";
+  readonly 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";
+  readonly 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";
+};
+export type AcIconName = keyof typeof acIconPaths;
+/**
+ * 声音键在各声音模式下显示的图标。
+ */
+export declare const acSoundIcons: Record<AcSoundMode, AcIconName>;
+/**
+ * 一行「黑点 / 白点」文字占位，模拟能效标签上的细密文字。
+ */
+export interface AcDotRow {
+  num: number;
+  /** 点的直径（px） */
+  size: number;
+  /** 水平外边距（px） */
+  mx: number;
+  /** 垂直外边距（px） */
+  my: number;
+  color: string;
+}
+/**
+ * 能效标签的点阵与等级条布局。
+ */
+export declare const acEnergyLabel: {
+  top: AcDotRow[];
+  detail: AcDotRow[];
+  footer: AcDotRow;
+  levels: {
+    background: string;
+    width: string;
+  }[];
+};
+//#endregion