MetonaToast/CHANGELOG.md

Changelog

All notable changes to MetonaToast will be documented in this file.

[0.2.1] - 2026-07-25

Fixed

• auto 主题配置死值：THEMES.auto 改为合法 CSS 值（复用 light 默认值），避免 getThemeConfig('auto') 返回无意义字符串
• resolveTheme 循环逻辑：resolveTheme('auto') 始终检测系统主题，不再依赖 currentTheme 全局状态
• formatList 国际化：优先使用 Intl.ListFormat，降级到逗号拼接，支持各语言原生列表格式
• RTL 容器定位：RTL 语言自动翻转 left/right 位置，容器创建时正确适配
• _containerCache 泄露：index.ts 的 destroy() 中增加 _containerCache.clear()，与 api.ts 保持一致

Changed

• 代码去重：消除 index.ts 与 api.ts 之间 11 个方法的重复定义，统一在 api.ts 实现
• Toast 回调注入：Toast._onError / Toast._removeToast 改为 Toast.setCallbacks() 静态方法，消除隐式契约
• Stub 方法替换：api.ts 中 7 个 stub 方法替换为完整实现（init/use/destroy/getStatus/getConfig/updateConfig/resetConfig）
• ESLint 规则：新增 @typescript-eslint/no-explicit-any (warn) 和 prefer-const (warn)

Added

• beforeShow 拦截：钩子函数返回 false 可阻止 Toast 显示；配置 onBeforeShow 回调支持同样能力
• updatePosition() 方法：允许运行时移动 Toast 到不同位置容器
• remove() + removeToast() 方法：立即移除 Toast（不触发离场动画），提供无动画的快速清除 API

[0.2.0] - 2026-07-25

Changed

• TypeScript 源码重构：全部源码从 JavaScript 迁移到 TypeScript
• 删除手动维护的 types/index.d.ts，类型由源码自动生成
• core.js (1244行) 拆分为 toast.ts + api.ts + templates.ts
• 构建工具链：Babel → ts-jest，新增 @rollup/plugin-typescript
• 测试迁移至 TypeScript (tests/index.test.ts)

Added

• tsconfig.json (strict: true)
• src/types.ts 核心类型模块
• .eslintrc.json ESLint 配置
• .gitea/workflows/ci.yml CI 工作流
• CHANGELOG.md

Removed

• babel.config.js
• types/ 目录

[0.1.2] - 2026-07-24

Fixed

• 补全和修正 TypeScript 类型声明
• 全面修复、优化与增强

[0.1.1] - 2026-07-23

Changed

• 版本号重置，更新文档页面

[0.1.0] - 2026-07-22

Added

• 初始发布
• 107 种内置图标
• 11 种动画效果
• 4 种主题（light/dark/auto/warm）
• 国际化支持 (zh-CN/en-US)
• 插件系统 (keyboard/persistence/accessibility)
• 拖拽关闭、进度条、倒计时等高级特性
• TypeScript 类型声明
• 零依赖