@chenzy-design/svelte 0.3.1 → 0.4.1

package/dist/back-top/BackTop.svelte

@@ -1,117 +1,67 @@
 <!--
-  BackTop — 回到顶部悬浮按钮。
-  支持：自定义 target 滚动容器 / window + 阈值显隐 + 受控 visible + 平滑缓动回顶
-        + announceOnArrive 到顶播报 + 三尺寸。
-
-  ⚠️ 死循环红线：
-    - 滚动监听用 $effect 内命令式 addEventListener('scroll', ..., {passive:true})
-      + rAF 节流，cleanup 时 removeEventListener + cancelAnimationFrame；target 变化时重绑。
-    - autoVisible 仅在 scroll 回调（非 render 期）写入本地 $state。
-    - render 期只读派生的 visible（受控值或 autoVisible），绝不读 scrollTop 几何。
-    - 受控 visible：仅读 prop + 触发 onVisibleChange 回调，绝不回写。
-    - 回顶动画亦为命令式 rAF 循环；卸载时在 $effect cleanup 中 cancel。
+  BackTop — 回到顶部悬浮按钮（严格对齐 Semi backtop/index.tsx + foundation.ts）。
+
+  Semi 契约（index.tsx BackTopProps，共 7 prop）：
+    target / visibilityHeight(400) / duration(450) / onClick / style / className / children。
+  DOM：仅在 visible 时渲染 `<div class="semi-backtop" style onClick>{children || <IconButton theme="light" icon={<IconChevronUp/>}/>}</div>`，
+       不可见时返回 null（非 opacity 切换）。圆形按钮观感来自 IconButton(theme="light")，
+       BackTop 自身 scss 只有 position/right/bottom/z/cursor/text-align/overflow（3 变量：z=10、right=100px、bottom=50px）。
+
+  ⚠️ 死循环红线（对齐 Semi foundation 的命令式监听 + rAF）：
+    - 滚动监听用 $effect 内命令式 addEventListener('scroll', ..., {passive:true}) + rAF 节流，
+      cleanup 时 removeEventListener + cancelAnimationFrame；target 变化时重绑。
+    - visible 仅在 scroll 回调（非 render 期）写入本地 $state；render 期只读，绝不读 scrollTop 几何。
+    - 回顶动画为命令式 rAF 循环；卸载时在 $effect cleanup 中 cancel。
 -->
 <script lang="ts">
   import type { Snippet } from 'svelte';
   import { isAboveThreshold, scrollPositionAt } from '@chenzy-design/core';
+  import { IconChevronUp } from '@chenzy-design/icons';
+  import IconButton from '../iconbutton/IconButton.svelte';
   import { useLocale } from '../locale-provider/index.js';
 
-  type Size = 'small' | 'default' | 'large';
-
   interface Props {
-    /**
-     * 监听并回顶的滚动容器。返回 HTMLElement | CSS 选择器字符串 | null。
-     * 不传或返回 null/window 时监听 window（默认行为，向后兼容）。
-     */
-    target?: () => HTMLElement | string | Window | null;
-    /**
-     * 受控显隐：传入时由外部决定按钮显隐（内部阈值判定仅用于触发 onVisibleChange）；
-     * 不传则内部按 visibilityHeight 阈值自动显隐。
-     */
-    visible?: boolean;
-    /** 回到顶部后用 ARIA live region 播报（文案经 locale BackTop.arrived）。 */
-    announceOnArrive?: boolean;
-    /** 滚动超过此高度(px)显示按钮 */
+    /** 返回需要监听其滚动事件的元素对应 DOM 元素的函数。默认 () => window（对齐 Semi）。 */
+    target?: () => HTMLElement | Window | null;
+    /** 出现 BackTop 需要达到的滚动高度(px)（对齐 Semi，默认 400）。 */
     visibilityHeight?: number;
-    /** 回顶动画时长(ms)，0 表示瞬时 */
+    /** 滚动到顶部的时间(ms)（对齐 Semi，默认 450）。 */
     duration?: number;
-    /** 距底偏移，number → px */
-    bottom?: number | string;
-    /** 距 inline-end 偏移，number → px */
-    right?: number | string;
-    size?: Size;
-    ariaLabel?: string;
-    /** 替换图标（保留圆形按钮外壳） */
-    icon?: Snippet<[{ size: Size }]>;
-    /** 完全自定义按钮内容 */
-    children?: Snippet<[{ visible: boolean }]>;
+    /** 点击事件的回调函数。 */
     onClick?: (e: MouseEvent) => void;
-    onVisibleChange?: (info: { visible: boolean }) => void;
-    onScrollEnd?: () => void;
+    /** 自定义按钮内容（对齐 Semi children，替换默认 IconButton）。 */
+    children?: Snippet;
+    /** 根节点内联样式（对齐 Semi style）。 */
+    style?: string;
+    /** 根节点类名（对齐 Semi className）。 */
     class?: string;
   }
 
   let {
     target,
-    visible: controlledVisible,
-    announceOnArrive = false,
     visibilityHeight = 400,
     duration = 450,
-    bottom = 40,
-    right = 40,
-    size = 'default',
-    ariaLabel,
-    icon,
-    children,
     onClick,
-    onVisibleChange,
-    onScrollEnd,
+    children,
+    style = '',
     class: className = '',
   }: Props = $props();
 
   const loc = useLocale();
 
-  // 本地响应式状态：仅由命令式 scroll 回调写入，render 期只读（非受控时驱动显隐）。
-  let autoVisible = $state(false);
-
-  // 派生显隐（红线 #2 纯函数）：受控时取 prop，否则取内部阈值态。render 期只读。
-  const visible = $derived(controlledVisible ?? autoVisible);
-
-  // 到顶播报文案（live region 命令式写入，初始为空）。
-  let announceText = $state('');
-
-  // 偏移样式：number → px。
-  const bottomPx = $derived(typeof bottom === 'number' ? `${bottom}px` : bottom);
-  const rightPx = $derived(typeof right === 'number' ? `${right}px` : right);
-
-  /**
-   * 把 target 原始返回值规整为「滚动元素 | window」。null 视为 window；
-   * 选择器字符串经 querySelector 解析，解析失败回退 window。
-   */
-  function normalizeScroller(raw: HTMLElement | string | Window | null | undefined): HTMLElement | Window {
-    if (raw == null || raw === window) return window;
-    if (typeof raw === 'string') {
-      if (typeof document === 'undefined') return window;
-      return (document.querySelector<HTMLElement>(raw)) ?? window;
-    }
-    return raw;
-  }
+  // 本地响应式状态：仅由命令式 scroll 回调写入，render 期只读（驱动显隐）。
+  let visible = $state(false);
 
   /**
-   * 响应式解析的滚动容器：在 $derived 内调用 target?.()，使其依赖被追踪——
-   * target 通常 `() => someBoundEl`，bind:this 在挂载后才赋值，借此让监听 $effect
-   * 在元素就绪后重新求值并重绑（红线 #3）。无 target 时恒为 window。
+   * 响应式解析滚动容器：在 $derived 内调用 target?.()，使其依赖被追踪——
+   * target 通常 `() => someBoundEl`，bind:this 挂载后才赋值，借此让监听 $effect
+   * 在元素就绪后重新求值并重绑。无 target 时恒为 window（对齐 Semi getDefaultTarget）。
    */
-  const scroller = $derived(normalizeScroller(target?.()));
-
-  /** scrollToTop 等命令式路径用：即时解析（不依赖响应式快照）。 */
-  function resolveScroller(): HTMLElement | Window {
-    return normalizeScroller(target?.());
-  }
+  const scroller = $derived<HTMLElement | Window>(target?.() ?? window);
 
   /** 读取某滚动容器当前 scrollTop（window 走 scrollY）。命令式，仅回调期调用。 */
-  function getScrollTop(scroller: HTMLElement | Window): number {
-    return scroller === window ? window.scrollY : (scroller as HTMLElement).scrollTop;
+  function getScrollTop(node: HTMLElement | Window): number {
+    return node === window ? window.scrollY : (node as HTMLElement).scrollTop;
   }
 
   // 减弱动效偏好（命令式读取，仅 client）。
@@ -120,24 +70,18 @@
     window.matchMedia?.('(prefers-reduced-motion: reduce)').matches === true;
 
   // 滚动监听（命令式 + rAF 节流 + cleanup）。$effect 仅 client 运行，SSR 安全。
-  // 依赖 scroller（含 target 求值）/ visibilityHeight：变化时 cleanup 旧绑定并重绑（红线 #3）。
+  // 依赖 scroller（含 target 求值）/ visibilityHeight：变化时 cleanup 旧绑定并重绑。
   $effect(() => {
-    const node = scroller; // 响应式：容器(或 window)变化时重绑
-    const threshold = visibilityHeight; // 追踪阈值
+    const node = scroller;
+    const threshold = visibilityHeight;
     let rafId = 0;
 
     function onScroll() {
-      if (rafId) return; // rAF 节流
+      if (rafId) return;
       rafId = requestAnimationFrame(() => {
         rafId = 0;
-        // scrollTop 读取发生在回调中（非 render 期）。
         const top = getScrollTop(node);
-        const next = isAboveThreshold(top, threshold);
-        // 内部阈值态：受控时不驱动 render，但仍维护以触发 onVisibleChange。
-        if (next !== autoVisible) {
-          autoVisible = next;
-          onVisibleChange?.({ visible: next });
-        }
+        visible = isAboveThreshold(top, threshold);
       });
     }
 
@@ -151,164 +95,70 @@
 
   // 回顶动画的 rAF 句柄（组件级，供卸载 cleanup 取消）。
   let scrollRaf = 0;
-
-  $effect(() => {
-    // 仅注册卸载时取消未完成的回顶动画。
-    return () => {
-      if (scrollRaf) cancelAnimationFrame(scrollRaf);
-    };
+  $effect(() => () => {
+    if (scrollRaf) cancelAnimationFrame(scrollRaf);
   });
 
   /** 把容器/window 滚到指定 y（命令式）。 */
-  function scrollToY(scroller: HTMLElement | Window, y: number) {
-    if (scroller === window) window.scrollTo(0, y);
-    else (scroller as HTMLElement).scrollTop = y;
-  }
-
-  /** 到顶后写入 live region 播报（announceOnArrive 开启时）。先清空确保重复可重播。 */
-  function announceArrived() {
-    if (!announceOnArrive) return;
-    announceText = '';
-    // 微任务后再写入，确保 DOM 先清空再赋值，触发 AT 重新播报。
-    queueMicrotask(() => {
-      announceText = loc().t('BackTop.arrived');
-    });
-  }
-
-  function finishScroll() {
-    scrollRaf = 0;
-    onScrollEnd?.();
-    announceArrived();
+  function scrollToY(node: HTMLElement | Window, y: number) {
+    if (node === window) window.scrollTo(0, y);
+    else (node as HTMLElement).scrollTop = y;
   }
 
-  function scrollToTop(e: MouseEvent) {
+  /** 点击回顶：对齐 Semi onClick → setScrollTop(0) + notifyClick。 */
+  function handleClick(e: MouseEvent) {
     onClick?.(e);
-    const scroller = resolveScroller();
-    const from = getScrollTop(scroller);
+    const node = target?.() ?? window;
+    const from = getScrollTop(node);
     if (duration <= 0 || reduced) {
-      scrollToY(scroller, 0);
-      finishScroll();
+      scrollToY(node, 0);
       return;
     }
     if (scrollRaf) cancelAnimationFrame(scrollRaf);
     const start = performance.now();
     const step = (now: number) => {
       const elapsed = now - start;
-      scrollToY(scroller, scrollPositionAt(from, elapsed, duration));
-      if (elapsed < duration) {
-        scrollRaf = requestAnimationFrame(step);
-      } else {
-        finishScroll();
-      }
+      scrollToY(node, scrollPositionAt(from, elapsed, duration));
+      if (elapsed < duration) scrollRaf = requestAnimationFrame(step);
+      else scrollRaf = 0;
     };
     scrollRaf = requestAnimationFrame(step);
   }
 </script>
 
-<button
-  type="button"
-  class="cd-backtop cd-backtop--{size} {className}"
-  class:cd-backtop--visible={visible}
-  aria-label={ariaLabel ?? loc().t('BackTop.ariaLabel')}
-  aria-hidden={!visible}
-  tabindex={visible ? 0 : -1}
-  style="--cd-backtop-offset-bottom:{bottomPx}; --cd-backtop-offset-inline-end:{rightPx}"
-  onclick={scrollToTop}
->
-  {#if children}
-    {@render children({ visible })}
-  {:else if icon}
-    {@render icon({ size })}
-  {:else}
-    <svg class="cd-backtop__icon" viewBox="0 0 24 24" aria-hidden="true">
-      <path
-        fill="none"
-        stroke="currentColor"
-        stroke-width="2"
-        stroke-linecap="round"
-        stroke-linejoin="round"
-        d="M12 19V5M5 12l7-7 7 7"
-      />
-    </svg>
-  {/if}
-</button>
-
-{#if announceOnArrive}
-  <!-- 到顶播报 live region：视觉隐藏，仅供辅助技术读取（红线 #2：render 期只读 $state）。 -->
-  <div class="cd-sr-only" role="status" aria-live="polite" aria-atomic="true">
-    {announceText}
+{#if visible}
+  <!--
+    对齐 Semi：仅 visible 时渲染 div.semi-backtop（不可见时不在 DOM）。
+    Semi 外层 div 只是可点击容器（无 role/tabindex），真实按钮语义/键盘可聚焦由内部
+    IconButton(theme="light") 承担——避免 div[role=button] 再套 button 的嵌套交互问题。
+    自定义 children 时外层同为可点击容器（对齐 Semi）。
+  -->
+  <!-- svelte-ignore a11y_click_events_have_key_events -->
+  <!-- svelte-ignore a11y_no_static_element_interactions -->
+  <div class="cd-back-top {className}" {style} onclick={handleClick}>
+    {#if children}
+      {@render children()}
+    {:else}
+      <IconButton theme="light" ariaLabel={loc().t('BackTop.ariaLabel')} icon={defaultIcon} />
+    {/if}
   </div>
 {/if}
 
+{#snippet defaultIcon()}
+  <IconChevronUp />
+{/snippet}
+
 <style>
-  .cd-backtop {
+  /* 严格对齐 Semi semi-foundation/backtop/backtop.scss：仅定位/层级/光标/居中/裁剪。
+     圆形按钮观感由内部 IconButton(theme="light") 提供，BackTop 自身无视觉 token。 */
+  .cd-back-top {
     position: fixed;
-    inset-block-end: var(--cd-backtop-offset-bottom, 40px);
-    inset-inline-end: var(--cd-backtop-offset-inline-end, 40px);
-    inline-size: var(--cd-backtop-size);
-    block-size: var(--cd-backtop-size);
-    display: inline-flex;
-    align-items: center;
-    justify-content: center;
-    padding: 0;
-    border: 1px solid transparent;
-    border-radius: var(--cd-backtop-radius);
-    background: var(--cd-backtop-bg);
-    color: var(--cd-backtop-color);
-    box-shadow: var(--cd-backtop-shadow);
-    cursor: pointer;
+    box-sizing: border-box;
+    inset-inline-end: var(--cd-backtop-right);
+    inset-block-end: var(--cd-backtop-bottom);
     z-index: var(--cd-backtop-z);
-    /* 隐藏态（默认） */
-    opacity: 0;
-    visibility: hidden;
-    pointer-events: none;
-    transform: translateY(8px);
-    transition:
-      opacity var(--cd-backtop-motion-duration) ease,
-      transform var(--cd-backtop-motion-duration) ease,
-      visibility var(--cd-backtop-motion-duration) ease;
-  }
-
-  .cd-backtop--visible {
-    opacity: 1;
-    visibility: visible;
-    pointer-events: auto;
-    transform: translateY(0);
-  }
-
-  .cd-backtop--small {
-    inline-size: var(--cd-backtop-size-small);
-    block-size: var(--cd-backtop-size-small);
-  }
-
-  .cd-backtop--large {
-    inline-size: var(--cd-backtop-size-large);
-    block-size: var(--cd-backtop-size-large);
-  }
-
-  .cd-backtop:hover {
-    background: var(--cd-backtop-bg-hover);
-  }
-
-  .cd-backtop:active {
-    background: var(--cd-backtop-bg-active);
-  }
-
-  .cd-backtop:focus-visible {
-    outline: 2px solid var(--cd-backtop-focus-ring);
-    outline-offset: 2px;
-  }
-
-  .cd-backtop__icon {
-    inline-size: 50%;
-    block-size: 50%;
-  }
-
-  /* 到顶播报 live region 复用 tokens.css 全局 .cd-sr-only：视觉隐藏但 AT 可读。 */
-
-  @media (prefers-reduced-motion: reduce) {
-    .cd-backtop {
-      transition: none;
-    }
+    cursor: pointer;
+    text-align: center;
+    overflow: hidden;
   }
 </style>

package/dist/back-top/BackTop.svelte.d.ts

@@ -1,41 +1,18 @@
 import type { Snippet } from 'svelte';
-type Size = 'small' | 'default' | 'large';
 interface Props {
-    /**
-     * 监听并回顶的滚动容器。返回 HTMLElement | CSS 选择器字符串 | null。
-     * 不传或返回 null/window 时监听 window（默认行为，向后兼容）。
-     */
-    target?: () => HTMLElement | string | Window | null;
-    /**
-     * 受控显隐：传入时由外部决定按钮显隐（内部阈值判定仅用于触发 onVisibleChange）；
-     * 不传则内部按 visibilityHeight 阈值自动显隐。
-     */
-    visible?: boolean;
-    /** 回到顶部后用 ARIA live region 播报（文案经 locale BackTop.arrived）。 */
-    announceOnArrive?: boolean;
-    /** 滚动超过此高度(px)显示按钮 */
+    /** 返回需要监听其滚动事件的元素对应 DOM 元素的函数。默认 () => window（对齐 Semi）。 */
+    target?: () => HTMLElement | Window | null;
+    /** 出现 BackTop 需要达到的滚动高度(px)（对齐 Semi，默认 400）。 */
     visibilityHeight?: number;
-    /** 回顶动画时长(ms)，0 表示瞬时 */
+    /** 滚动到顶部的时间(ms)（对齐 Semi，默认 450）。 */
     duration?: number;
-    /** 距底偏移，number → px */
-    bottom?: number | string;
-    /** 距 inline-end 偏移，number → px */
-    right?: number | string;
-    size?: Size;
-    ariaLabel?: string;
-    /** 替换图标（保留圆形按钮外壳） */
-    icon?: Snippet<[{
-        size: Size;
-    }]>;
-    /** 完全自定义按钮内容 */
-    children?: Snippet<[{
-        visible: boolean;
-    }]>;
+    /** 点击事件的回调函数。 */
     onClick?: (e: MouseEvent) => void;
-    onVisibleChange?: (info: {
-        visible: boolean;
-    }) => void;
-    onScrollEnd?: () => void;
+    /** 自定义按钮内容（对齐 Semi children，替换默认 IconButton）。 */
+    children?: Snippet;
+    /** 根节点内联样式（对齐 Semi style）。 */
+    style?: string;
+    /** 根节点类名（对齐 Semi className）。 */
     class?: string;
 }
 declare const BackTop: import("svelte").Component<Props, {}, "">;

package/dist/back-top/BackTop.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BackTop.svelte.d.ts","sourceRoot":"","sources":["../../src/back-top/BackTop.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAKpC,KAAK,IAAI,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAE1C,UAAU,KAAK;IACb;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACpD;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,sBAAsB;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,CAAC,CAAC;IACjC,gBAAgB;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC,CAAC;IAC3C,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;IAClC,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IACvD,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA0LH,QAAA,MAAM,OAAO,2CAAwC,CAAC;AACtD,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;AAC1C,eAAe,OAAO,CAAC"}
+{"version":3,"file":"BackTop.svelte.d.ts","sourceRoot":"","sources":["../../src/back-top/BackTop.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAOpC,UAAU,KAAK;IACb,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3C,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB;IACjB,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;IAClC,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAwHH,QAAA,MAAM,OAAO,2CAAwC,CAAC;AACtD,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;AAC1C,eAAe,OAAO,CAAC"}

package/dist/back-top/meta.d.ts

@@ -1,118 +1,69 @@
 /**
  * Machine-readable component metadata for AI/docs consumption.
- * BackTop — see specs/components/other/BackTop.spec.md
+ * BackTop — 严格对齐 Semi backtop/index.tsx（BackTopProps 7 prop）。
  */
 export declare const meta: {
     readonly name: "BackTop";
-    readonly category: "other";
-    readonly description: "回到顶部悬浮按钮：滚动超阈值显隐 + 平滑缓动(easeInOutCubic)回顶，三尺寸(small/default/large)，原生 button 支持 Enter/Space，prefers-reduced-motion 下瞬时回顶，RTL 友好(inset-inline-end)。默认监听 window 滚动，可经 target 指定自定义滚动容器；支持受控 visible 与 announceOnArrive 到顶 ARIA live 播报。";
+    readonly category: "navigation";
+    readonly description: "回到顶部悬浮按钮：滚动超过 visibilityHeight(默认 400px) 时显现、点击平滑缓动(easeInOutCubic, duration 默认 450ms)滚回顶部；默认监听 window，可经 target 指定自定义滚动容器；默认渲染 IconButton(theme=\"light\") + IconChevronUp，可用 children 完全自定义。严格对齐 Semi。";
     readonly exports: readonly ["BackTop"];
     readonly props: readonly [{
         readonly name: "target";
-        readonly type: "() => HTMLElement | string | Window | null";
-        readonly default: "undefined";
-        readonly desc: "监听并回顶的滚动容器，返回元素/CSS 选择器/window；不传监听 window";
-    }, {
-        readonly name: "visible";
-        readonly type: "boolean";
-        readonly default: "undefined";
-        readonly desc: "受控显隐：传入则由外部控制按钮显隐（仅读不回写），不传按 visibilityHeight 自动";
-    }, {
-        readonly name: "announceOnArrive";
-        readonly type: "boolean";
-        readonly default: "false";
-        readonly desc: "回到顶部后经 ARIA live region 播报（文案取 locale BackTop.arrived）";
+        readonly type: "() => HTMLElement | Window | null";
+        readonly default: "() => window";
+        readonly desc: "返回需要监听其滚动事件的元素对应 DOM 元素的函数（对齐 Semi）";
     }, {
         readonly name: "visibilityHeight";
         readonly type: "number";
         readonly default: "400";
-        readonly desc: "滚动超过此高度(px)显示按钮";
+        readonly desc: "出现 BackTop 需要达到的滚动高度(px)";
     }, {
         readonly name: "duration";
         readonly type: "number";
         readonly default: "450";
-        readonly desc: "回顶动画时长(ms)，0 瞬时";
-    }, {
-        readonly name: "bottom";
-        readonly type: "number|string";
-        readonly default: "40";
-        readonly desc: "距底偏移，number→px";
-    }, {
-        readonly name: "right";
-        readonly type: "number|string";
-        readonly default: "40";
-        readonly desc: "距 inline-end 偏移，number→px";
-    }, {
-        readonly name: "size";
-        readonly type: "'small'|'default'|'large'";
-        readonly default: "'default'";
-    }, {
-        readonly name: "ariaLabel";
-        readonly type: "string";
-        readonly default: "'回到顶部'";
-        readonly desc: "无障碍标签";
-    }, {
-        readonly name: "icon";
-        readonly type: "Snippet<[{ size }]>";
-        readonly default: "undefined";
-        readonly desc: "替换图标(保留圆形按钮外壳)";
-    }, {
-        readonly name: "children";
-        readonly type: "Snippet<[{ visible }]>";
-        readonly default: "undefined";
-        readonly desc: "完全自定义按钮内容";
+        readonly desc: "滚动到顶部的时间(ms)";
     }, {
         readonly name: "onClick";
         readonly type: "(e: MouseEvent) => void";
         readonly default: "undefined";
+        readonly desc: "点击事件的回调函数";
     }, {
-        readonly name: "onVisibleChange";
-        readonly type: "(info: { visible: boolean }) => void";
+        readonly name: "children";
+        readonly type: "Snippet";
         readonly default: "undefined";
-        readonly desc: "显隐切换通知";
+        readonly desc: "自定义按钮内容（替换默认 IconButton）";
     }, {
-        readonly name: "onScrollEnd";
-        readonly type: "() => void";
-        readonly default: "undefined";
-        readonly desc: "回顶动画结束通知";
+        readonly name: "style";
+        readonly type: "string";
+        readonly default: "''";
+        readonly desc: "根节点内联样式";
     }, {
         readonly name: "class";
         readonly type: "string";
         readonly default: "''";
+        readonly desc: "根节点类名";
     }];
     readonly events: readonly [{
         readonly name: "onClick";
         readonly desc: "按钮点击";
-    }, {
-        readonly name: "onVisibleChange";
-        readonly desc: "显隐切换";
-    }, {
-        readonly name: "onScrollEnd";
-        readonly desc: "回顶动画结束";
     }];
     readonly slots: readonly [{
         readonly name: "children";
-        readonly desc: "完全自定义按钮内容，入参 { visible }";
-    }, {
-        readonly name: "icon";
-        readonly desc: "替换默认图标，入参 { size }，保留圆形按钮外壳";
+        readonly desc: "自定义按钮内容，替换默认 IconButton";
     }];
     readonly a11y: {
         readonly hasRole: true;
         readonly focusable: true;
-        readonly note: "原生 button 自带 button role + Enter/Space 触发；aria-label 文本；隐藏态 aria-hidden=true + tabindex=-1 移出 Tab 序与 a11y 树；focus-visible 焦点环。";
+        readonly note: "对齐 Semi：外层 div.cd-back-top 为可点击容器，真实按钮语义/键盘可聚焦/可访问名（locale BackTop.ariaLabel）由内部 IconButton(theme=\"light\") 承担；不可见时不在 DOM。";
     };
-    readonly tokens: readonly ["--cd-backtop-size", "--cd-backtop-size-small", "--cd-backtop-size-large", "--cd-backtop-bg", "--cd-backtop-bg-hover", "--cd-backtop-bg-active", "--cd-backtop-color", "--cd-backtop-border", "--cd-backtop-shadow", "--cd-backtop-radius", "--cd-backtop-z", "--cd-backtop-focus-ring", "--cd-backtop-motion-duration"];
+    readonly tokens: readonly ["--cd-backtop-z", "--cd-backtop-right", "--cd-backtop-bottom"];
     readonly responsive: false;
     readonly examples: readonly [{
-        readonly title: "基础";
+        readonly title: "基本用法";
         readonly code: "<BackTop />";
     }, {
-        readonly title: "小尺寸";
-        readonly code: "<BackTop size=\"small\" />";
-    }, {
-        readonly title: "自定义偏移";
-        readonly code: "<BackTop bottom={80} right={24} />";
+        readonly title: "自定义样式";
+        readonly code: "<BackTop style=\"...\">{icon}</BackTop>";
     }];
 };
 //# sourceMappingURL=meta.d.ts.map

package/dist/back-top/meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/back-top/meta.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuGP,CAAC"}
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/back-top/meta.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2CP,CAAC"}