@icen.ai/ui 0.5.0 → 0.8.1

package/dist/behaviors/tag-input.mjs

@@ -1,30 +1,54 @@
+// src/behaviors/events.ts
+function emitIcen(source, type, detail) {
+  return source.dispatchEvent(
+    new CustomEvent(type, { detail, bubbles: true, composed: true, cancelable: true })
+  );
+}
+
 // src/behaviors/tag-input.ts
 function setup(wrap) {
   const el = wrap;
-  if (el.__icenTagInit) return;
+  if (el.__icenTagInit) return void 0;
   el.__icenTagInit = true;
   const fieldEl = wrap.querySelector(".tag-input-field");
-  if (!fieldEl) return;
+  if (!fieldEl) return void 0;
   const field = fieldEl;
   const maxAttr = wrap.getAttribute("data-max");
   const max = maxAttr ? Number(maxAttr) || Infinity : Infinity;
   const placeholder = field.placeholder;
+  let alive = true;
+  let isComposing = false;
+  const onCompositionStart = () => {
+    isComposing = true;
+  };
+  const onCompositionEnd = () => {
+    isComposing = false;
+  };
   let tags = (wrap.getAttribute("data-tags") ?? "").split(",").map((s) => s.trim()).filter(Boolean);
+  const autoLabel = !wrap.hasAttribute("aria-label");
   function sync() {
     wrap.setAttribute("data-tags", tags.join(","));
     wrap.classList.toggle("is-max", tags.length >= max);
     field.placeholder = tags.length === 0 ? placeholder : "";
-    if (!wrap.hasAttribute("aria-label")) {
-      wrap.setAttribute("aria-label", `\u6807\u7B7E\u8F93\u5165\uFF0C\u5171 ${tags.length} \u4E2A`);
-    }
+    if (autoLabel) wrap.setAttribute("aria-label", `\u6807\u7B7E\u8F93\u5165\uFF0C\u5171 ${tags.length} \u4E2A`);
   }
   function emit() {
-    wrap.dispatchEvent(new CustomEvent("icen:tags-change", {
-      bubbles: true,
-      detail: { tags: [...tags] }
-    }));
+    if (!alive) return;
+    emitIcen(wrap, "icen:tags-change", { tags: [...tags] });
+  }
+  let shakeTimer = null;
+  function shake() {
+    el.classList.remove("is-shake");
+    void el.offsetWidth;
+    el.classList.add("is-shake");
+    if (shakeTimer) clearTimeout(shakeTimer);
+    shakeTimer = setTimeout(() => {
+      el.classList.remove("is-shake");
+      shakeTimer = null;
+    }, 320);
   }
   function remove(index) {
+    if (!alive) return;
     tags.splice(index, 1);
     render();
     emit();
@@ -50,11 +74,13 @@ function setup(wrap) {
     sync();
   }
   function commit() {
+    if (!alive) return;
     const v = field.value.trim();
     if (!v) return;
     if (tags.length >= max) return;
     if (tags.includes(v)) {
       field.value = "";
+      shake();
       return;
     }
     tags.push(v);
@@ -62,23 +88,46 @@ function setup(wrap) {
     render();
     emit();
   }
-  field.addEventListener("keydown", (ev) => {
+  const onKeyDown = (ev) => {
+    if (isComposing || ev.isComposing) return;
     if (ev.key === "Enter" || ev.key === ",") {
       ev.preventDefault();
       commit();
     } else if (ev.key === "Backspace" && !field.value && tags.length > 0) {
       remove(tags.length - 1);
     }
-  });
+  };
+  field.addEventListener("compositionstart", onCompositionStart);
+  field.addEventListener("compositionend", onCompositionEnd);
+  field.addEventListener("keydown", onKeyDown);
   field.addEventListener("blur", commit);
   render();
+  return () => {
+    alive = false;
+    if (shakeTimer) clearTimeout(shakeTimer);
+    field.removeEventListener("compositionstart", onCompositionStart);
+    field.removeEventListener("compositionend", onCompositionEnd);
+    field.removeEventListener("keydown", onKeyDown);
+    field.removeEventListener("blur", commit);
+    el.__icenTagInit = false;
+  };
 }
-function initTagInput(root = document) {
-  if (typeof document === "undefined") return;
-  const containers = [];
-  if (root instanceof HTMLElement && root.matches(".tag-input[data-tags]")) containers.push(root);
-  containers.push(...Array.from(root.querySelectorAll(".tag-input[data-tags]")));
-  for (const c of containers) setup(c);
+function initTagInput(root) {
+  const cleanups = [];
+  if (typeof document !== "undefined") {
+    const scope = root ?? document;
+    const containers = [];
+    if (scope instanceof HTMLElement && scope.matches(".tag-input")) containers.push(scope);
+    containers.push(...Array.from(scope.querySelectorAll(".tag-input")));
+    for (const c of containers) {
+      const cleanup = setup(c);
+      if (cleanup) cleanups.push(cleanup);
+    }
+  }
+  return () => {
+    for (const fn of cleanups) fn();
+    cleanups.length = 0;
+  };
 }
 export {
   initTagInput

package/dist/behaviors/theme.d.mts

@@ -0,0 +1,36 @@
+interface ThemeState {
+    preset: string;
+    dark: boolean;
+    style: string;
+}
+declare const PRESETS: readonly ["clay", "piano", "art", "vangogh", "ink", "retro"];
+declare const STYLES: readonly ["modern", "retro", "terminal"];
+declare const STORAGE_KEY = "icen.ui.theme";
+/**
+ * 注册宿主自建预设（宿主先在自家 CSS 写好 `.<name>` 与 `.<name>.dark` 完整 token 面，
+ * 仿照 colors.css 现有 6 套）。名字须命中 /^[a-z][a-z0-9-]{1,20}$/ 且不与
+ * dark / style-* 保留字冲突；注册只影响 listThemePresets() 枚举（UI 切换器用），
+ * 不注册的自建预设同样可以 setTheme（校验同样放行）。返回是否接受注册。
+ */
+declare function registerThemePreset(name: string): boolean;
+/** 全部可用预设名：内置 6 套 + 已注册的自建预设（UI 切换器枚举用，顺序稳定）。 */
+declare function listThemePresets(): string[];
+/** 默认主题：clay + 跟随系统明暗 + modern。SSR 下返回离线兜底值。 */
+declare function getDefaultTheme(): ThemeState;
+/** 读 localStorage 中的持久化主题；缺失或坏数据回退默认。 */
+declare function getTheme(): ThemeState;
+/** 把主题应用到 <html> 并在状态实际变化时派发 icen:theme-change（见私有 apply）。 */
+declare function applyTheme(t: ThemeState): void;
+/** 合并当前主题与 patch，应用并持久化，返回新态。patch 中的非法枚举值回退默认。 */
+declare function setTheme(patch: Partial<ThemeState>): ThemeState;
+/** 切换明暗，返回新态。 */
+declare function toggleDark(): ThemeState;
+/** 只切风格 profile（modern / retro / terminal；非法值回退 modern），返回新态。 */
+declare function setStyle(style: string): ThemeState;
+/** 页面加载早期调用：读持久化主题并应用，防闪烁。
+ *  无持久化偏好时，自动跟随系统的 prefers-color-scheme 变化（实时）；
+ *  一旦用户显式 setTheme / toggleDark，跟随停止（持久化优先）。
+ *  重复调用幂等（系统监听不会重复挂）。 */
+declare function initTheme(): ThemeState;
+
+export { PRESETS, STORAGE_KEY, STYLES, type ThemeState, applyTheme, getDefaultTheme, getTheme, initTheme, listThemePresets, registerThemePreset, setStyle, setTheme, toggleDark };

package/dist/behaviors/theme.mjs

@@ -1,11 +1,32 @@
+// src/behaviors/events.ts
+function emitIcen(source, type, detail) {
+  return source.dispatchEvent(
+    new CustomEvent(type, { detail, bubbles: true, composed: true, cancelable: true })
+  );
+}
+
 // src/behaviors/theme.ts
 var PRESETS = ["clay", "piano", "art", "vangogh", "ink", "retro"];
 var STYLES = ["modern", "retro", "terminal"];
 var STORAGE_KEY = "icen.ui.theme";
+var PRESET_NAME_RE = /^[a-z][a-z0-9-]{1,20}$/;
+var RESERVED_PRESET_NAMES = /* @__PURE__ */ new Set(["dark", ...STYLES.map((s) => `style-${s}`)]);
+var customPresets = /* @__PURE__ */ new Set();
 var FALLBACK = { preset: "clay", dark: false, style: "modern" };
 function isBrowser() {
   return typeof document !== "undefined";
 }
+function isValidPreset(name) {
+  return PRESETS.includes(name) || PRESET_NAME_RE.test(name) && !RESERVED_PRESET_NAMES.has(name);
+}
+function registerThemePreset(name) {
+  if (!PRESET_NAME_RE.test(name) || RESERVED_PRESET_NAMES.has(name)) return false;
+  customPresets.add(name);
+  return true;
+}
+function listThemePresets() {
+  return [...PRESETS, ...customPresets];
+}
 function getDefaultTheme() {
   if (!isBrowser() || typeof window.matchMedia !== "function") {
     return { ...FALLBACK };
@@ -19,7 +40,8 @@ function getDefaultTheme() {
 function isThemeState(v) {
   if (typeof v !== "object" || v === null) return false;
   const t = v;
-  return typeof t.preset === "string" && PRESETS.includes(t.preset) && typeof t.dark === "boolean" && typeof t.style === "string" && STYLES.includes(t.style);
+  return typeof t.preset === "string" && /* 持久化路径与 setTheme 同一开放白名单：自建预设跨刷新存活 */
+  isValidPreset(t.preset) && typeof t.dark === "boolean" && typeof t.style === "string" && STYLES.includes(t.style);
 }
 function getTheme() {
   if (!isBrowser()) return getDefaultTheme();
@@ -33,24 +55,40 @@ function getTheme() {
     return getDefaultTheme();
   }
 }
-function applyTheme(t) {
+var lastApplied = null;
+function apply(t) {
   if (!isBrowser()) return;
   const cls = document.documentElement.classList;
+  if (lastApplied && !PRESETS.includes(lastApplied.preset)) {
+    cls.remove(lastApplied.preset);
+  }
   for (const p of PRESETS) cls.remove(p);
   for (const s of STYLES) cls.remove(`style-${s}`);
   cls.remove("dark");
   cls.add(t.preset);
   if (t.dark) cls.add("dark");
   cls.add(`style-${t.style}`);
+  const changed = lastApplied !== null && (lastApplied.preset !== t.preset || lastApplied.dark !== t.dark || lastApplied.style !== t.style);
+  lastApplied = { ...t };
+  if (changed) {
+    emitIcen(document.documentElement, "icen:theme-change", {
+      preset: t.preset,
+      dark: t.dark,
+      style: t.style
+    });
+  }
+}
+function applyTheme(t) {
+  apply(t);
 }
 function setTheme(patch) {
   const merged = { ...getTheme(), ...patch };
   const next = {
-    preset: PRESETS.includes(merged.preset) ? merged.preset : FALLBACK.preset,
+    preset: isValidPreset(merged.preset) ? merged.preset : FALLBACK.preset,
     dark: merged.dark === true,
     style: STYLES.includes(merged.style) ? merged.style : FALLBACK.style
   };
-  applyTheme(next);
+  apply(next);
   if (isBrowser()) {
     try {
       window.localStorage.setItem(STORAGE_KEY, JSON.stringify(next));
@@ -62,10 +100,15 @@ function setTheme(patch) {
 function toggleDark() {
   return setTheme({ dark: !getTheme().dark });
 }
+function setStyle(style) {
+  return setTheme({ style });
+}
+var systemListenerAttached = false;
 function initTheme() {
   const t = getTheme();
   applyTheme(t);
-  if (isBrowser() && typeof window.matchMedia === "function" && !hasPersistedPreference()) {
+  if (isBrowser() && typeof window.matchMedia === "function" && !systemListenerAttached && !hasPersistedPreference()) {
+    systemListenerAttached = true;
     let lastDark = t.dark;
     try {
       const mql = window.matchMedia("(prefers-color-scheme: dark)");
@@ -101,6 +144,9 @@ export {
   getDefaultTheme,
   getTheme,
   initTheme,
+  listThemePresets,
+  registerThemePreset,
+  setStyle,
   setTheme,
   toggleDark
 };

package/dist/behaviors/toast.d.mts

@@ -0,0 +1,48 @@
+type ToastKind = 'ok' | 'err' | 'warn' | 'info' | 'success' | 'error';
+interface ToastOptions {
+    /** 保留时长（毫秒），默认 2600；带 action 时默认 6000 */
+    ms?: number;
+    /** 配合 action：可撤销 / 重试 / 查看等 */
+    actionLabel?: string;
+    /** action 触发回调；返回 false 阻止 toast 关闭 */
+    onAction?: () => void | Promise<void> | boolean;
+    /** 内联 SVG 字符串图标（消毒后渲染为 .toast-icon）；非 <svg> 开头或解析失败静默忽略 */
+    icon?: string;
+    /** 显示右上角关闭按钮（.toast-close，点击即关闭本条），默认 false */
+    closable?: boolean;
+    /** 显示底部超时进度条（.toast-progress，动画时长 = 本条保留时长），默认 false */
+    progress?: boolean;
+}
+/** 单条 toast 句柄：dismiss() 立即关闭本条（幂等，可重复调用）。 */
+interface ToastHandle {
+    dismiss(): void;
+}
+interface ToastConfig {
+    /** 同屏最大堆叠，默认 5；超出从最早的开始移除 */
+    maxStack?: number;
+}
+interface ToastFn {
+    (message: string, kind?: ToastKind, ms?: number): ToastHandle;
+    /** success 语义（.toast--success），规范词表入口 */
+    success(message: string, ms?: number): ToastHandle;
+    /**
+     * success 语义（.toast--success）。
+     * @deprecated 词表统一：改用 toast.success()，本别名下个大版本删除。
+     */
+    ok(message: string, ms?: number): ToastHandle;
+    /** error 语义（.toast--error），规范词表入口 */
+    error(message: string, ms?: number): ToastHandle;
+    /**
+     * error 语义（.toast--error）。
+     * @deprecated 词表统一：改用 toast.error()，本别名下个大版本删除。
+     */
+    err(message: string, ms?: number): ToastHandle;
+    warn(message: string, ms?: number): ToastHandle;
+    info(message: string, ms?: number): ToastHandle;
+    action(message: string, actionLabel: string, onAction: () => void, ms?: number): ToastHandle;
+    dismiss(): void;
+    config(opts: ToastConfig): void;
+}
+declare const toast: ToastFn;
+
+export { type ToastConfig, type ToastHandle, type ToastKind, type ToastOptions, toast };

package/dist/behaviors/toast.mjs

@@ -16,30 +16,85 @@ function ensureContainer() {
   document.body.appendChild(el);
   return el;
 }
+var KIND_CLASS = {
+  ok: "toast--success",
+  success: "toast--success",
+  err: "toast--error",
+  error: "toast--error",
+  warn: "toast--warning",
+  info: "toast--info"
+};
+var CLOSE_SVG = '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M18 6 6 18"/><path d="m6 6 12 12"/></svg>';
+function stripUnsafeSvg(el) {
+  for (const attr of Array.from(el.attributes)) {
+    if (attr.name.toLowerCase().startsWith("on")) el.removeAttribute(attr.name);
+  }
+  for (const child of Array.from(el.children)) {
+    const tag = child.tagName.toLowerCase();
+    if (tag === "script" || tag === "foreignobject") child.remove();
+    else stripUnsafeSvg(child);
+  }
+}
+function sanitizeSvgIcon(source) {
+  if (!source.trimStart().startsWith("<svg")) return null;
+  try {
+    const doc = new DOMParser().parseFromString(source, "image/svg+xml");
+    const svg = doc.documentElement;
+    if (!svg || svg.tagName.toLowerCase() !== "svg") return null;
+    stripUnsafeSvg(svg);
+    return document.importNode(svg, true);
+  } catch {
+    return null;
+  }
+}
+var closeSvgCache = null;
+function closeSvg() {
+  closeSvgCache ??= sanitizeSvgIcon(CLOSE_SVG);
+  return closeSvgCache ? closeSvgCache.cloneNode(true) : null;
+}
+function scheduleRemove(el) {
+  el.classList.add("is-leaving");
+  let done = false;
+  const finish = () => {
+    if (done) return;
+    done = true;
+    el.remove();
+  };
+  el.addEventListener("transitionend", finish, { once: true });
+  window.setTimeout(finish, 400);
+}
 function trimStack(container) {
   for (; ; ) {
     const items = Array.from(container.querySelectorAll(":scope > .toast"));
     if (items.length <= maxStack) return;
     const oldest = items[0];
     if (!oldest) return;
-    oldest.classList.add("leaving");
-    let done = false;
-    const finish = () => {
-      if (done) return;
-      done = true;
+    if (oldest.classList.contains("is-leaving")) {
       oldest.remove();
-    };
-    oldest.addEventListener("transitionend", finish, { once: true });
-    window.setTimeout(finish, 400);
+      continue;
+    }
+    scheduleRemove(oldest);
+    return;
   }
 }
 function show(message, kind = "info", opts = {}) {
-  if (!isBrowser()) return;
-  const { ms, actionLabel, onAction } = opts;
+  if (!isBrowser()) return { dismiss() {
+  } };
+  const { ms, actionLabel, onAction, icon, closable, progress } = opts;
   const container = ensureContainer();
   const el = document.createElement("div");
-  el.className = kind === "info" ? "toast" : `toast ${kind}`;
-  el.setAttribute("role", kind === "err" ? "alert" : "status");
+  el.className = `toast ${KIND_CLASS[kind]}`;
+  el.setAttribute("role", kind === "err" || kind === "error" ? "alert" : "status");
+  if (icon) {
+    const svg = sanitizeSvgIcon(icon);
+    if (svg) {
+      const iconWrap = document.createElement("span");
+      iconWrap.className = "toast-icon";
+      iconWrap.setAttribute("aria-hidden", "true");
+      iconWrap.appendChild(svg);
+      el.appendChild(iconWrap);
+    }
+  }
   const msgNode = document.createElement("span");
   msgNode.className = "toast-msg";
   msgNode.textContent = message;
@@ -52,24 +107,39 @@ function show(message, kind = "info", opts = {}) {
     actionBtn.textContent = actionLabel;
     el.appendChild(actionBtn);
   }
-  container.appendChild(el);
-  trimStack(container);
+  const duration = ms ?? (actionLabel ? ACTION_MS : DEFAULT_MS);
+  let timer = 0;
   let removed = false;
   const remove = () => {
     if (removed) return;
     removed = true;
-    el.classList.add("leaving");
-    let done = false;
-    const finish = () => {
-      if (done) return;
-      done = true;
-      el.remove();
-    };
-    el.addEventListener("transitionend", finish, { once: true });
-    window.setTimeout(finish, 400);
+    if (timer) window.clearTimeout(timer);
+    scheduleRemove(el);
   };
-  const duration = ms ?? (actionLabel ? ACTION_MS : DEFAULT_MS);
-  const timer = window.setTimeout(remove, duration);
+  if (closable) {
+    const closeBtn = document.createElement("button");
+    closeBtn.type = "button";
+    closeBtn.className = "toast-close";
+    closeBtn.setAttribute("aria-label", "\u5173\u95ED");
+    const svg = closeSvg();
+    if (svg) closeBtn.appendChild(svg);
+    else closeBtn.textContent = "\xD7";
+    closeBtn.addEventListener("click", remove);
+    el.appendChild(closeBtn);
+  }
+  if (progress) {
+    const bar = document.createElement("div");
+    bar.className = "toast-progress";
+    bar.setAttribute("aria-hidden", "true");
+    const fill = document.createElement("div");
+    fill.className = "toast-progress-fill";
+    fill.style.animationDuration = `${duration}ms`;
+    bar.appendChild(fill);
+    el.appendChild(bar);
+  }
+  container.appendChild(el);
+  trimStack(container);
+  timer = window.setTimeout(remove, duration);
   if (actionBtn && onAction) {
     actionBtn.addEventListener("click", () => {
       window.clearTimeout(timer);
@@ -78,11 +148,14 @@ function show(message, kind = "info", opts = {}) {
       remove();
     });
   }
+  return { dismiss: remove };
 }
 var toast = Object.assign(
   (message, kind = "info", ms) => show(message, kind, { ms }),
   {
+    success: (message, ms) => show(message, "success", { ms }),
     ok: (message, ms) => show(message, "ok", { ms }),
+    error: (message, ms) => show(message, "error", { ms }),
     err: (message, ms) => show(message, "err", { ms }),
     warn: (message, ms) => show(message, "warn", { ms }),
     info: (message, ms) => show(message, "info", { ms }),

package/dist/behaviors/tree.d.mts

@@ -0,0 +1,7 @@
+/**
+ * 为 root 下每棵 .tree 初始化（root 自身是 .tree 也算）。
+ * 返回销毁函数：移除本次挂上的容器监听并复位幂等标记（销毁后可重新 init）。SSR 下返回 no-op。
+ */
+declare function initTree(root?: ParentNode): () => void;
+
+export { initTree };

package/dist/behaviors/tree.mjs

@@ -1,12 +1,19 @@
+// src/behaviors/events.ts
+function emitIcen(source, type, detail) {
+  return source.dispatchEvent(
+    new CustomEvent(type, { detail, bubbles: true, composed: true, cancelable: true })
+  );
+}
+
 // src/behaviors/tree.ts
 function setup(tree) {
   const el = tree;
-  if (el.__icenTreeInit) return;
+  if (el.__icenTreeInit) return void 0;
   el.__icenTreeInit = true;
   tree.querySelectorAll(".tree-node").forEach((node) => {
     if (!node.hasAttribute("tabindex")) node.tabIndex = 0;
   });
-  tree.addEventListener("click", (ev) => {
+  const onClick = (ev) => {
     const target = ev.target;
     if (!(target instanceof Element)) return;
     const node = target.closest(".tree-node");
@@ -28,6 +35,7 @@ function setup(tree) {
         toggle?.classList.add("is-collapsed");
         toggle?.setAttribute("aria-expanded", "false");
       }
+      emitIcen(tree, "icen:tree-toggle", { node: li, open: !collapsed });
       return;
     }
     if (childUl) return;
@@ -37,12 +45,9 @@ function setup(tree) {
     });
     node.classList.add("is-selected");
     node.setAttribute("aria-selected", "true");
-    tree.dispatchEvent(new CustomEvent("icen:tree-select", {
-      bubbles: true,
-      detail: { node }
-    }));
-  });
-  tree.addEventListener("keydown", (ev) => {
+    emitIcen(tree, "icen:tree-select", { node });
+  };
+  const onKeyDown = (ev) => {
     const kev = ev;
     const target = kev.target;
     if (!(target instanceof Element)) return;
@@ -71,6 +76,7 @@ function setup(tree) {
           childUl.removeAttribute("hidden");
           node.querySelector(".tree-toggle")?.setAttribute("aria-expanded", "true");
           node.querySelector(".tree-toggle")?.classList.remove("is-collapsed");
+          if (li) emitIcen(tree, "icen:tree-toggle", { node: li, open: true });
         }
         break;
       }
@@ -82,18 +88,36 @@ function setup(tree) {
           childUl.setAttribute("hidden", "");
           node.querySelector(".tree-toggle")?.setAttribute("aria-expanded", "false");
           node.querySelector(".tree-toggle")?.classList.add("is-collapsed");
+          if (li) emitIcen(tree, "icen:tree-toggle", { node: li, open: false });
         }
         break;
       }
     }
-  });
+  };
+  tree.addEventListener("click", onClick);
+  tree.addEventListener("keydown", onKeyDown);
+  return () => {
+    tree.removeEventListener("click", onClick);
+    tree.removeEventListener("keydown", onKeyDown);
+    el.__icenTreeInit = false;
+  };
 }
-function initTree(root = document) {
-  if (typeof document === "undefined") return;
-  const trees = [];
-  if (root instanceof Element && root.matches(".tree")) trees.push(root);
-  trees.push(...Array.from(root.querySelectorAll(".tree")));
-  for (const t of trees) setup(t);
+function initTree(root) {
+  const cleanups = [];
+  if (typeof document !== "undefined") {
+    const scope = root ?? document;
+    const trees = [];
+    if (scope instanceof Element && scope.matches(".tree")) trees.push(scope);
+    trees.push(...Array.from(scope.querySelectorAll(".tree")));
+    for (const t of trees) {
+      const cleanup = setup(t);
+      if (cleanup) cleanups.push(cleanup);
+    }
+  }
+  return () => {
+    for (const fn of cleanups) fn();
+    cleanups.length = 0;
+  };
 }
 export {
   initTree

package/dist/behaviors/upload.d.mts

@@ -0,0 +1,4 @@
+/** 为 root 下每个 .upload 容器初始化（root 自身是 .upload 也算）。 */
+declare function initUpload(root?: ParentNode): void;
+
+export { initUpload };