release: v0.3.0 — 自定义动画真实生效、max超限修复、钩子系统完整化、destroy全量清理

- 自定义动画：animations.register() 注册的动画动态注入 keyframes 真实生效（此前仅存 Map 实际 fallback slide）
- max 超限：通过实例注册表真正 close() 最早的 toast（此前仅删内存记录，DOM 残留）
- 钩子收敛：beforeClose/beforeUpdate 支持返回 false 拦截；接入 click/hover/dragStart/dragEnd/animationStart/animationEnd/progressStart/progressEnd/configChange/themeChange/localeChange/beforeInit/afterInit/beforeDestroy/afterDestroy；HOOK_NAMES 移除永不触发的声明
- destroy() 全量清理：hooks、实例注册表、全部 metona-toast-* 样式标签；动画注册表真正清空
- applyThemeVariables 重复注入修复；init() 支持插件对象并复活 _destroyed；AnimationConfig 类型放宽
- VERSION 统一到 constants.ts 唯一维护；删除失效 scripts；新增 .gitattributes 统一 LF
- docs.html 补 v0.2.1 新 API 文档；CHANGELOG 更新；测试 309 用例全过

site/docs.html

@@ -71,9 +71,11 @@
   <a href="#stack">stack()</a>
 	  <a href="#action">action()</a>
   <div class="section">管理方法</div>
-	  <a href="#group">group()</a>
+  <a href="#group">group()</a>
   <a href="#dismiss">dismiss()</a>
   <a href="#clear">clear()</a>
+  <a href="#updatePosition">updatePosition()</a>
+  <a href="#remove">remove() / removeToast()</a>
   <a href="#configure">configure()</a>
   <a href="#use">use()</a>
   <a href="#destroy">destroy()</a>
@@ -87,7 +89,7 @@
 <main class="main">
 
 <h1>API 文档</h1>
-<p>MetonaToast v0.2.1 完整 API 参考。所有基础通知方法（show/success/error/warning/info/loading）支持两种调用形式，均可传入任何 <a href="#config">配置项</a> 作为可选第二参数。</p>
+<p>MetonaToast v0.3.0 完整 API 参考。所有基础通知方法（show/success/error/warning/info/loading）支持两种调用形式，均可传入任何 <a href="#config">配置项</a> 作为可选第二参数。</p>
 
 <!-- ===== 基础通知 ===== -->
 <h2 id="show">show(message, opts?)</h2>
@@ -378,6 +380,26 @@ MeToast.<span class="fn">dismiss</span>(toast.id);  <span class="cm">// 关闭
 <pre>MeToast.<span class="fn">clear</span>();                      <span class="cm">// 全部</span>
 MeToast.<span class="fn">clear</span>(<span class="s">'bottom-right'</span>); <span class="cm">// 仅右下角</span></pre>
 
+<h2 id="updatePosition">updatePosition(position)</h2>
+<p>运行时将 Toast 移动到新的位置容器。立即生效，不重新播放入场动画。</p>
+<table>
+<tr><th>参数</th><th>类型</th><th>说明</th></tr>
+<tr><td>position</td><td>string</td><td>目标位置：top-left / top-center / top-right / bottom-left / bottom-center / bottom-right</td></tr>
+</table>
+<pre><span class="kw">const</span> t = MeToast.<span class="fn">info</span>(<span class="s">'可移动的 Toast'</span>);
+t.<span class="fn">updatePosition</span>(<span class="s">'bottom-left'</span>); <span class="cm">// 移动到左下角</span></pre>
+
+<h2 id="remove">remove() / removeToast(id)</h2>
+<p>立即从 DOM 和内存中移除 Toast，<b>不触发离场动画</b>。适用于需要无动画快速清除的场景（区别于 <code>dismiss()</code> 的优雅关闭）。</p>
+<table>
+<tr><th>方法</th><th>签名</th><th>说明</th></tr>
+<tr><td>remove</td><td>toast.remove()</td><td>Toast 实例方法，立即移除自身</td></tr>
+<tr><td>removeToast</td><td>MeToast.removeToast(id)</td><td>按 id 立即移除。id 不存在时静默忽略</td></tr>
+</table>
+<pre><span class="kw">const</span> t = MeToast.<span class="fn">warning</span>(<span class="s">'临时消息'</span>);
+t.<span class="fn">remove</span>();                    <span class="cm">// 实例方法：立即移除</span>
+MeToast.<span class="fn">removeToast</span>(t.id);    <span class="cm">// 或按 id 移除（等价）</span></pre>
+
 <h2 id="configure">configure(opts)</h2>
 <p>全局配置，影响后续所有 Toast。theme 和 locale 变化会触发相应副作用（应用主题 CSS / 切换语言）。</p>
 <table>
@@ -434,12 +456,14 @@ MeToast.<span class="fn">use</span>(<span class="s">'accessibility'</span>); <sp
 	<tr><td>resetTimerOnUpdate</td><td>boolean</td><td>false</td><td>调用 update() 时重置 duration 倒计时</td></tr>
 	<tr><td>notifyWhenHidden</td><td>boolean</td><td>false</td><td>页面不可见时自动通过 Notification API 发送系统通知</td></tr>
 	<tr><td>render</td><td>function</td><td>—</td><td>自定义渲染函数 <code>(toast) => htmlString</code>，完全接管 DOM 构建</td></tr>
+	<tr><td>onBeforeShow</td><td>function</td><td>—</td><td>显示前回调 <code>(toast) => boolean | void</code>，返回 false 可阻止该 Toast 显示</td></tr>
 	<tr><td>onError</td><td>function</td><td>—</td><td>全局错误回调 <code>({ hook, source, error, toast }) => void</code>，钩子异常或定时器错误时触发</td></tr>
 </table>
 
 <h2 id="callbacks">回调函数</h2>
 <table>
 <tr><th>回调</th><th>签名</th><th>触发时机</th></tr>
+<tr><td>onBeforeShow</td><td>(toast: ToastInstance) => boolean | void</td><td>Toast DOM 创建前。返回 false 阻止显示</td></tr>
 <tr><td>onShow</td><td>(toast: ToastInstance) => void</td><td>Toast DOM 创建并播放入场动画后</td></tr>
 <tr><td>onClose</td><td>(toast: ToastInstance) => void</td><td>Toast DOM 被移除后（离场动画完成时）</td></tr>
 <tr><td>onClick</td><td>(toast: ToastInstance) => void</td><td>Toast 被点击时（closeOnClick 为 true 时还会自动关闭）</td></tr>