release: v0.2.1 — bug修复、代码去重、功能增强、覆盖率88.57%

This commit is contained in:
2026-07-25 13:01:59 +08:00
parent cca2675fb4
commit bc1128bd1f
23 changed files with 1703 additions and 320 deletions
+7 -230
View File
@@ -1,27 +1,26 @@
/**
* MetonaToast — 轻量级Toast通知库
* @module metona-toast
* @version 0.2.0
* @version 0.2.1
* @author thzxx
* @license MIT
*/
import { meToast } from './api.js';
import { Toast } from './toast.js';
import { Toast, _containerCache } from './toast.js';
import { animationUtils } from './animations.js';
import { themeUtils } from './themes.js';
import { i18nUtils } from './i18n.js';
import { pluginUtils, presetPlugins } from './plugins.js';
import { DEFAULTS } from './constants.js';
import type { MeToast, ToastConfig, InitOptions, StatusInfo, ToastInstance, ToastOptions, Plugin } from './types.js';
import type { ToastInstance } from './types.js';
// 版本信息
const VERSION = '0.2.0';
const VERSION = '0.2.1';
/**
* 主对象增强
* 增强的 MeToast 对象 — 在 meToast 基础上注入子模块
*/
const enhancedMeToast: MeToast = {
const enhancedMeToast = {
...meToast,
version: VERSION,
@@ -31,228 +30,6 @@ const enhancedMeToast: MeToast = {
i18n: i18nUtils,
plugins: pluginUtils,
presetPlugins,
/**
* 安装插件
*/
use(plugin: string | Record<string, unknown>, options: Record<string, unknown> = {}): MeToast {
if (typeof plugin === 'string') {
const preset = presetPlugins[plugin];
if (!preset) {
console.warn(`Preset plugin "${plugin}" not found`);
return this;
}
this.plugins.register(plugin, { ...preset, ...options });
// 连接插件钩子
if (plugin === 'accessibility') {
Toast.on('afterShow', (toast: ToastInstance) => {
if (typeof preset.announce === 'function') preset.announce(toast);
});
}
if (plugin === 'persistence') {
const saved = typeof preset.install === 'function' ? preset.install(pluginUtils as unknown as import('./types.js').PluginManager) : null;
if (saved) this.configure(saved as Partial<ToastConfig>);
Toast.on('afterClose', () => {
if (typeof (preset as Record<string, unknown>).save === 'function') {
(preset as Record<string, (c: unknown) => void>).save(this.getConfig());
}
});
}
} else if (plugin && typeof plugin === 'object') {
const name = (plugin as Record<string, string>).name || 'custom';
this.plugins.register(name, { ...plugin, ...options } as unknown as Plugin);
}
return this;
},
/**
* 初始化
*/
init(options: InitOptions = {}): MeToast {
if (options.config) {
this.configure(options.config);
}
if (options.theme) {
this.themes.switchTheme(options.theme);
}
if (options.locale) {
this.i18n.switchLocale(options.locale);
}
if (options.plugins && Array.isArray(options.plugins)) {
options.plugins.forEach((p) => {
this.use(p as string);
});
}
return this;
},
/**
* 销毁
*/
destroy(): void {
if (this._destroyed) return;
this._destroyed = true;
this.dismiss();
if (this.plugins && typeof (this.plugins as unknown as Record<string, unknown>).destroy === 'function') {
(this.plugins as unknown as Record<string, () => void>).destroy();
}
if (this.themes) {
if (typeof this.themes.clearThemeListeners === 'function') {
this.themes.clearThemeListeners();
}
if (typeof this.themes.unwatchSystemTheme === 'function') {
this.themes.unwatchSystemTheme();
}
}
if (this.i18n && typeof this.i18n.clearLocaleListeners === 'function') {
this.i18n.clearLocaleListeners();
}
if (this.animations && typeof this.animations.cancelAll === 'function') {
this.animations.cancelAll();
}
if (typeof document !== 'undefined') {
const containers = document.querySelectorAll('.met-container');
containers.forEach((c) => { if (c.parentNode) c.parentNode.removeChild(c); });
const style = document.getElementById('metona-toast-styles');
if (style && style.parentNode) style.parentNode.removeChild(style);
}
this._toasts.clear();
},
/**
* 获取状态
*/
getStatus(): StatusInfo {
return {
version: VERSION,
toasts: this._toasts.size,
theme: this.themes?.getCurrentTheme?.() || 'auto',
locale: this.i18n?.getCurrentLocale?.() || 'zh-CN',
plugins: this.plugins?.getNames?.() || [],
animations: this.animations?.getActiveCount?.() || 0,
};
},
/**
* 获取配置
*/
getConfig(): ToastConfig {
return { ...this._config };
},
/**
* 更新配置
*/
updateConfig(config: Partial<ToastConfig>): MeToast {
if (config && typeof config === 'object') {
Object.assign(this._config, config);
}
return this;
},
/**
* 重置配置
*/
resetConfig(): MeToast {
const keys = Object.keys(this._config);
keys.forEach(k => delete (this._config as Record<string, unknown>)[k]);
Object.assign(this._config, DEFAULTS);
return this;
},
/**
* 获取Toast列表
*/
getToasts(): ToastInstance[] {
return Array.from(this._toasts.values());
},
/**
* 检查是否有Toast
*/
hasToasts(): boolean {
return this._toasts.size > 0;
},
/**
* 获取Toast
*/
getToast(id: string): ToastInstance | null {
if (!id) return null;
return this._toasts.get(id) || null;
},
/**
* 关闭所有Toast
*/
closeAll(): void {
this._toasts.forEach((t) => t.close());
},
/**
* 清除所有Toast
*/
clearAll(): void {
this._toasts.forEach((t) => t.close());
},
/**
* 暂停所有Toast
*/
pauseAll(): void {
this._toasts.forEach((t) => t._pause());
},
/**
* 恢复所有Toast
*/
resumeAll(): void {
this._toasts.forEach((t) => t._resume());
},
/**
* 更新所有Toast
*/
updateAll(partial: Partial<ToastOptions>): void {
if (partial && typeof partial === 'object') {
this._toasts.forEach((t) => t.update(partial));
}
},
/**
* 查找Toast
*/
findToasts(predicate: (toast: ToastInstance) => boolean): ToastInstance[] {
if (typeof predicate !== 'function') return [];
return Array.from(this._toasts.values()).filter(predicate);
},
/**
* 按类型查找Toast
*/
findByType(type: string): ToastInstance[] {
return this.findToasts((t) => t.type === type);
},
/**
* 按位置查找Toast
*/
findByPosition(position: string): ToastInstance[] {
return this.findToasts((t) => t.config.position === position);
},
};
// 初始化主题和国际化
@@ -287,7 +64,7 @@ if (typeof window !== 'undefined') {
};
Toast.on('afterShow', (toast: ToastInstance) => {
const config = toast.config as ToastConfig;
const config = toast.config;
if (config.notifyWhenHidden) {
((enhancedMeToast as unknown as Record<string, (t: ToastInstance) => void>)._notify)(toast);
}