@chenzy-design/svelte 0.3.0 → 0.4.1

package/dist/anchor/Anchor.svelte.d.ts

@@ -1,24 +1,47 @@
-import type { AnchorLink } from './types.js';
+export { ANCHOR_COLLECTOR_KEY, ANCHOR_CONTEXT_KEY } from './context.js';
+import type { Snippet } from 'svelte';
+import type { AnchorShowTooltip, AnchorRailTheme, AnchorSize } from './types.js';
+import { type Placement } from '@chenzy-design/core';
 interface Props {
-    links?: AnchorLink[];
-    value?: string;
-    defaultValue?: string;
+    /** 滚动时动态展示下一级锚点（对齐 Semi）；默认 false（全展开）。 */
+    autoCollapse?: boolean;
+    /** 根类名（对齐 Semi className；本库惯例用 class）。 */
+    class?: string;
+    /** 默认高亮锚点 href（对齐 Semi defaultAnchor，1.20.0）。 */
+    defaultAnchor?: string;
+    /** 指定滚动容器（对齐 Semi getContainer）；缺省 window。 */
+    getContainer?: () => HTMLElement | Window | null;
+    /** 组件 max-height，超出显示滚动条（对齐 Semi）；数字转 px。 */
+    maxHeight?: string | number;
+    /** 组件 max-width，超出 ellipsis（对齐 Semi）；数字转 px。 */
+    maxWidth?: string | number;
+    /** 滚动内容距容器顶部达到偏移量时触发 Link 切换（对齐 Semi）。 */
     offsetTop?: number;
-    bounds?: number;
-    showInk?: boolean;
+    /** Tooltip 显示位置（对齐 Semi position）；仅 showTooltip 时生效。 */
+    position?: Placement;
+    /** 滑轨主题：primary（默认）/ tertiary / muted（对齐 Semi railTheme）。 */
+    railTheme?: AnchorRailTheme;
+    /** 是否开启滚动动画（对齐 Semi scrollMotion）；默认 false。reduced-motion 强制即时。 */
     scrollMotion?: boolean;
-    /** position:sticky 吸顶 */
-    affix?: boolean;
-    /** 激活变更时写 location.hash */
-    updateHash?: boolean;
-    /** 点击滚动的独立偏移（缺省继承 offsetTop） */
+    /**
+     * 文字缩略时是否显示 Tooltip 及配置（对齐 Semi showTooltip）。
+     * boolean | { type: 'tooltip' | 'popover'; opts }；true 等价 { type: 'tooltip' }。
+     */
+    showTooltip?: AnchorShowTooltip;
+    /** 锚点尺寸：small / default（默认，对齐 Semi size）。 */
+    size?: AnchorSize;
+    /** 根节点自定义内联样式（对齐 Semi style）。 */
+    style?: string;
+    /** 锚点滚动时距顶部偏移量（对齐 Semi targetOffset，1.9.0）；缺省继承 offsetTop 语义为 0。 */
     targetOffset?: number;
-    /** 自定义滚动容器；缺省监听/滚动 window */
-    getContainer?: () => HTMLElement | null;
-    /** 水平模式：链接横排，ink 走底部下划线 */
-    horizontal?: boolean;
-    onChange?: (key: string) => void;
-    ariaLabel?: string;
+    /** 改变锚点回调（对齐 Semi：currentLink/previousLink 为 href 字符串）。 */
+    onChange?: (currentLink: string, previousLink: string) => void;
+    /** 点击锚点回调（对齐 Semi：event + currentLink href 字符串）。 */
+    onClick?: (event: MouseEvent, currentLink: string) => void;
+    /** 根 nav aria-label（对齐 Semi aria-label）；缺省走 locale。 */
+    'aria-label'?: string;
+    /** 组合式子项（<Anchor.Link>）。 */
+    children?: Snippet;
 }
 declare const Anchor: import("svelte").Component<Props, {}, "">;
 type Anchor = ReturnType<typeof Anchor>;

package/dist/anchor/Anchor.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Anchor.svelte.d.ts","sourceRoot":"","sources":["../../src/anchor/Anchor.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK3C,UAAU,KAAK;IACb,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,yBAAyB;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,YAAY,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IACxC,2BAA2B;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAqOH,QAAA,MAAM,MAAM,2CAAwC,CAAC;AACrD,KAAK,MAAM,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC;AACxC,eAAe,MAAM,CAAC"}
+{"version":3,"file":"Anchor.svelte.d.ts","sourceRoot":"","sources":["../../src/anchor/Anchor.svelte.ts"],"names":[],"mappings":"AAGE,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAG1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EAER,iBAAiB,EAEjB,eAAe,EACf,UAAU,EACX,MAAM,YAAY,CAAC;AACtB,OAAO,EAIH,KAAK,SAAS,EACf,MAAM,qBAAqB,CAAC;AAU7B,UAAU,KAAK;IACb,2CAA2C;IAC3C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC;IACjD,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,mEAAmE;IACnE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,6CAA6C;IAC7C,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/D,oDAAoD;IACpD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAkWH,QAAA,MAAM,MAAM,2CAAwC,CAAC;AACrD,KAAK,MAAM,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC;AACxC,eAAe,MAAM,CAAC"}

package/dist/anchor/AnchorLink.svelte

@@ -0,0 +1,226 @@
+<!--
+  Anchor.Link — 锚点链接（严格对齐 Semi Anchor.Link / link.tsx）。
+  组合式：向父级收集器注册 href 描述符（供 Anchor 做 scroll-spy / childMap），
+  并自渲染 DOM（对齐 Semi link.tsx render）：
+    div.cd-anchor-link[role=listitem]
+      div.cd-anchor-link-title[role=link tabindex][.-active][.-disabled]
+        {title | showTooltip 时 Text ellipsis 承载}
+      renderChildren（嵌套 Anchor.Link；autoCollapse 时按激活路径条件渲染）
+
+  安全（对齐 Nav）：init 同步注册进【普通数组】childLinks；挂载后【异步】bump 一次，
+  脱离挂载 effect 同步栈，避免 Svelte5 读写自循环（effect_update_depth_exceeded）。
+-->
+<script lang="ts">
+  import type { Snippet } from 'svelte';
+  import { onMount, setContext } from 'svelte';
+  import {
+    getAnchorCollector,
+    getAnchorContext,
+    ANCHOR_COLLECTOR_KEY,
+    type AnchorCollector,
+  } from './context.js';
+  import type { AnchorLinkNode } from './types.js';
+  import Text from '../typography/Text.svelte';
+  import Tooltip from '../tooltip/Tooltip.svelte';
+  import Popover from '../popover/Popover.svelte';
+  import { parsePlacement } from '@chenzy-design/core';
+
+  interface Props {
+    /** 跳转的链接（对齐 Semi href），形如 '#section-1'；同时作为唯一 key。 */
+    href: string;
+    /** 文字内容（对齐 Semi title）。 */
+    title: string;
+    /** 禁用，不响应点击跳转（对齐 Semi disabled，1.20.0）。 */
+    disabled?: boolean;
+    /** 类名（对齐 Semi className；本库惯例用 class）。 */
+    class?: string;
+    /** 样式（对齐 Semi style）。 */
+    style?: string;
+    /** 内嵌的 Anchor.Link（形成嵌套树）。 */
+    children?: Snippet;
+  }
+
+  let {
+    href,
+    title,
+    disabled = false,
+    class: className,
+    style,
+    children,
+  }: Props = $props();
+
+  const parent = getAnchorCollector();
+  const ctx = getAnchorContext();
+
+  // 自身描述符：children 为普通数组，承接子链接注册。
+  const childLinks: AnchorLinkNode[] = [];
+  // 声明式项「声明时读取一次」语义（对齐 Semi）；静态读取，state_referenced_locally 预期无害。
+  // svelte-ignore state_referenced_locally
+  const selfDescriptor: AnchorLinkNode = {
+    href,
+    title,
+    disabled,
+    children: childLinks,
+    ...(className !== undefined ? { className } : {}),
+    ...(style !== undefined ? { style } : {}),
+  };
+
+  // 当前嵌套层级（顶层为 1，对齐 Semi level）。
+  const level = parent?.level ?? 1;
+
+  if (parent) parent.add(selfDescriptor);
+
+  // 向 children 提供收集器：add 写入 childLinks；bump 上抛；level+1。
+  const childCollector: AnchorCollector = {
+    add: (link: AnchorLinkNode) => {
+      childLinks.push(link);
+      return link;
+    },
+    bump: () => parent?.bump(),
+    level: level + 1,
+  };
+  setContext(ANCHOR_COLLECTOR_KEY, childCollector);
+
+  onMount(() => parent?.bump());
+
+  // --- 渲染态（读共享上下文，保持反应性）---
+  const active = $derived(ctx?.getActiveHref() === href);
+  const tip = $derived(ctx?.getTooltip() ?? null);
+  const size = $derived(ctx?.getSize() ?? 'default');
+  const position = $derived(ctx?.getPosition());
+  const tabindex = $derived(ctx?.getLinkTabindex(href, disabled) ?? -1);
+
+  // autoCollapse：children 仅在「本链接激活」或「激活链接是其后代」时渲染（对齐 Semi renderChildren）。
+  const showChildren = $derived.by(() => {
+    if (!ctx?.getAutoCollapse()) return true;
+    const activeHref = ctx.getActiveHref();
+    return activeHref === href || ctx.getChildMap()[href]?.has(activeHref) === true;
+  });
+
+  // Popover 用 side+align；Tooltip 用整串 position。
+  const tooltipProps = $derived<Record<string, unknown>>(
+    position ? { position } : {},
+  );
+  const popoverProps = $derived.by<Record<string, unknown>>(() => {
+    if (!position) return {};
+    const { side, align } = parsePlacement(position);
+    return { position: side, align };
+  });
+
+  // 缩进（对齐 Semi paddingLeft: 8 * level）。
+  const indentStyle = $derived(`padding-inline-start:${8 * level}px`);
+
+  let titleNode = $state<HTMLElement | null>(null);
+  // 注册标题 DOM 供 Anchor 定位滑轨条（激活链接 offsetTop）。
+  $effect(() => {
+    ctx?.registerTitleNode(href, titleNode);
+    return () => ctx?.registerTitleNode(href, null);
+  });
+</script>
+
+<div class="cd-anchor-link {className ?? ''}" {style} role="listitem">
+  <div
+    bind:this={titleNode}
+    role="link"
+    tabindex={tabindex}
+    data-anchor-href={href}
+    class="cd-anchor-link-title"
+    class:cd-anchor-link-title-active={active}
+    class:cd-anchor-link-title-disabled={disabled}
+    style={indentStyle}
+    aria-current={active ? 'location' : undefined}
+    aria-disabled={disabled ? 'true' : undefined}
+    title={!tip && typeof title === 'string' ? title : undefined}
+    onclick={(e) => ctx?.onLinkClick(e, href)}
+    onkeydown={(e) => ctx?.onLinkKeydown(e, href)}
+    onfocus={() => ctx?.onLinkFocus(href)}
+  >
+    {#if tip}
+      {#if tip.type === 'popover'}
+        <Popover content={title} {...tip.opts} {...popoverProps}>
+          <Text
+            size={size === 'default' ? 'normal' : 'small'}
+            type="tertiary"
+            ellipsis
+            class="cd-anchor-link-tooltip"
+          >
+            {title}
+          </Text>
+        </Popover>
+      {:else}
+        <Tooltip content={title} {...tip.opts} {...tooltipProps}>
+          <Text
+            size={size === 'default' ? 'normal' : 'small'}
+            type="tertiary"
+            ellipsis
+            class="cd-anchor-link-tooltip"
+          >
+            {title}
+          </Text>
+        </Tooltip>
+      {/if}
+    {:else}
+      {title}
+    {/if}
+  </div>
+  {#if children && showChildren}
+    <div role="list">{@render children()}</div>
+  {/if}
+</div>
+
+<style>
+  .cd-anchor-link {
+    position: relative;
+  }
+  .cd-anchor-link-title {
+    cursor: pointer;
+    color: var(--cd-color-anchor-title-text-default);
+    padding-top: var(--cd-spacing-anchor-link-title-paddingtop);
+    padding-bottom: var(--cd-spacing-anchor-link-title-paddingbottom);
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+    border-radius: var(--cd-width-anchor-outline-border-radius);
+    background: var(--cd-color-anchor-title-bg-default);
+    /* 对齐 Semi anchor/animation.scss：文字色过渡 + scale 缩放（默认 none 档，主题/DSM 可开启）。
+       token 值本身即完整 scale(x,y)（对齐 Semi --semi-transform_scale-none: scale(1,1)），
+       故直接 transform: var()，不再外层包 scale()（Semi 原文 scale(scale(1,1)) 为无效 CSS，此处修复对齐）。 */
+    transition: color var(--cd-transition-duration-anchor-title-text)
+      var(--cd-transition-function-anchor-title-text)
+      var(--cd-transition-delay-anchor-title-text);
+    transform: var(--cd-transform-scale-anchor-title-text);
+  }
+  .cd-anchor-link-title:hover {
+    color: var(--cd-color-anchor-title-text-hover);
+  }
+  .cd-anchor-link-title-active {
+    color: var(--cd-color-anchor-title-text-active);
+    background: var(--cd-color-anchor-title-bg-active);
+  }
+  .cd-anchor-link-title-active:hover {
+    color: var(--cd-color-anchor-title-active-text-hover);
+  }
+  .cd-anchor-link-title:focus-visible {
+    outline: var(--cd-width-anchor-outline) solid
+      var(--cd-color-anchor-title-outline-focus);
+    outline-offset: var(--cd-width-anchor-outlineoffset);
+  }
+  .cd-anchor-link-title-disabled,
+  .cd-anchor-link-title-disabled:hover {
+    color: var(--cd-color-anchor-title-text-disabled);
+    cursor: not-allowed;
+  }
+  /* showTooltip 承载文字（对齐 Semi .semi-anchor-link-tooltip）：继承默认色，覆盖 Text 默认。 */
+  .cd-anchor-link :global(.cd-anchor-link-tooltip) {
+    cursor: pointer;
+    color: var(--cd-color-anchor-title-text-default);
+  }
+  .cd-anchor-link-title-active :global(.cd-anchor-link-tooltip) {
+    color: var(--cd-color-anchor-title-text-active);
+  }
+  @media (prefers-reduced-motion: reduce) {
+    .cd-anchor-link-title {
+      transition: none;
+    }
+  }
+</style>

package/dist/anchor/AnchorLink.svelte.d.ts

@@ -0,0 +1,19 @@
+import type { Snippet } from 'svelte';
+interface Props {
+    /** 跳转的链接（对齐 Semi href），形如 '#section-1'；同时作为唯一 key。 */
+    href: string;
+    /** 文字内容（对齐 Semi title）。 */
+    title: string;
+    /** 禁用，不响应点击跳转（对齐 Semi disabled，1.20.0）。 */
+    disabled?: boolean;
+    /** 类名（对齐 Semi className；本库惯例用 class）。 */
+    class?: string;
+    /** 样式（对齐 Semi style）。 */
+    style?: string;
+    /** 内嵌的 Anchor.Link（形成嵌套树）。 */
+    children?: Snippet;
+}
+declare const AnchorLink: import("svelte").Component<Props, {}, "">;
+type AnchorLink = ReturnType<typeof AnchorLink>;
+export default AnchorLink;
+//# sourceMappingURL=AnchorLink.svelte.d.ts.map

package/dist/anchor/AnchorLink.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnchorLink.svelte.d.ts","sourceRoot":"","sources":["../../src/anchor/AnchorLink.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAepC,UAAU,KAAK;IACb,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAwHH,QAAA,MAAM,UAAU,2CAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}

package/dist/anchor/context.d.ts

@@ -0,0 +1,43 @@
+import type { AnchorLinkNode, AnchorShowTooltip, AnchorSize } from './types.js';
+import type { Placement } from '@chenzy-design/core';
+/** 子项挂载注册收集器：把描述符按声明顺序收进当前层级普通数组树。 */
+export interface AnchorCollector {
+    /** 把子链接描述符按声明顺序 push 进当前层级，返回该描述符（供分支取其 children）。 */
+    add: (link: AnchorLinkNode) => AnchorLinkNode;
+    /** 挂载后异步触发一次 Anchor 重建（合并多次为一次）。 */
+    bump: () => void;
+    /** 当前嵌套层级（顶层为 1，对齐 Semi level）。 */
+    level: number;
+}
+/** Anchor → Link 的共享反应态与回调（对齐 Semi AnchorContext）。 */
+export interface AnchorContext {
+    /** 当前激活链接 href（getter 保持反应性）。 */
+    getActiveHref: () => string;
+    /** showTooltip 归一化配置（null=不装浮层）。 */
+    getTooltip: () => import('./types.js').AnchorTooltipConfig | null;
+    /** 浮层弹出位置（12 方位）；仅 showTooltip 开启时生效。 */
+    getPosition: () => Placement | undefined;
+    /** 尺寸（影响文字大小/浮层字号）。 */
+    getSize: () => AnchorSize;
+    /** autoCollapse：滚动时仅展开激活路径的子级。 */
+    getAutoCollapse: () => boolean;
+    /** childMap：每个 href → 其所有后代 href 集合（判定激活路径）。 */
+    getChildMap: () => Record<string, Set<string>>;
+    /** 点击链接（e.preventDefault 之后触发，滚动 + setActive + notify）。 */
+    onLinkClick: (e: MouseEvent, href: string) => void;
+    /** 键盘：方向键 roving / Home-End / Space 激活。 */
+    onLinkKeydown: (e: KeyboardEvent, href: string) => void;
+    /** 链接聚焦：更新 roving 焦点 href。 */
+    onLinkFocus: (href: string) => void;
+    /** 计算某链接 tabindex（roving 单停靠点）。 */
+    getLinkTabindex: (href: string, disabled?: boolean) => 0 | -1;
+    /** 注册链接标题 DOM 节点（激活时据其 offsetTop 定位滑轨条）。 */
+    registerTitleNode: (href: string, node: HTMLElement | null) => void;
+    /** raw showTooltip（用于零开销早退判定）。 */
+    getShowTooltip: () => AnchorShowTooltip;
+}
+export declare const ANCHOR_COLLECTOR_KEY: unique symbol;
+export declare const ANCHOR_CONTEXT_KEY: unique symbol;
+export declare function getAnchorCollector(): AnchorCollector | undefined;
+export declare function getAnchorContext(): AnchorContext | undefined;
+//# sourceMappingURL=context.d.ts.map

package/dist/anchor/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/anchor/context.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,GAAG,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,cAAc,CAAC;IAC9C,oCAAoC;IACpC,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,sDAAsD;AACtD,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,aAAa,EAAE,MAAM,MAAM,CAAC;IAC5B,oCAAoC;IACpC,UAAU,EAAE,MAAM,OAAO,YAAY,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAClE,yCAAyC;IACzC,WAAW,EAAE,MAAM,SAAS,GAAG,SAAS,CAAC;IACzC,uBAAuB;IACvB,OAAO,EAAE,MAAM,UAAU,CAAC;IAC1B,kCAAkC;IAClC,eAAe,EAAE,MAAM,OAAO,CAAC;IAC/B,gDAAgD;IAChD,WAAW,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/C,2DAA2D;IAC3D,WAAW,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,2CAA2C;IAC3C,aAAa,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxD,8BAA8B;IAC9B,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,mCAAmC;IACnC,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9D,4CAA4C;IAC5C,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IACpE,kCAAkC;IAClC,cAAc,EAAE,MAAM,iBAAiB,CAAC;CACzC;AAED,eAAO,MAAM,oBAAoB,eAAgC,CAAC;AAClE,eAAO,MAAM,kBAAkB,eAA8B,CAAC;AAE9D,wBAAgB,kBAAkB,IAAI,eAAe,GAAG,SAAS,CAIhE;AAED,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,SAAS,CAI5D"}

package/dist/anchor/context.js

@@ -0,0 +1,26 @@
+/**
+ * Anchor 组合式子项上下文（<Anchor.Link>，对齐 Semi anchor-context）。
+ *
+ * Semi 是 children + <Anchor.Link> 组合式，links 是内部 state 非公开 prop。
+ * 本库同构：<Anchor.Link> 挂载时向父级注册 href 描述符（构成嵌套树），并读取共享
+ * 反应态（activeHref/showTooltip/position/size/autoCollapse/childMap）自渲染 DOM。
+ *
+ * 安全约束（对齐 Nav，见记忆 svelte5-child-register-state-array-loop）：
+ * - 子链接注册写入的 children 是【普通数组】（非 $state），子项 init 同步 push，
+ *   不在 effect 里写 $state。
+ * - 触发 Anchor 重建 links 的反应量是单独一个 $state revision，子项挂载后【异步】
+ *   bump 一次，脱离挂载 effect 同步栈，避免读写自循环（effect_update_depth_exceeded）。
+ */
+import { getContext, hasContext } from 'svelte';
+export const ANCHOR_COLLECTOR_KEY = Symbol('cd-anchor-collector');
+export const ANCHOR_CONTEXT_KEY = Symbol('cd-anchor-context');
+export function getAnchorCollector() {
+    return hasContext(ANCHOR_COLLECTOR_KEY)
+        ? getContext(ANCHOR_COLLECTOR_KEY)
+        : undefined;
+}
+export function getAnchorContext() {
+    return hasContext(ANCHOR_CONTEXT_KEY)
+        ? getContext(ANCHOR_CONTEXT_KEY)
+        : undefined;
+}

package/dist/anchor/index.d.ts

@@ -1,4 +1,13 @@
-export { default as Anchor } from './Anchor.svelte';
+import AnchorRoot from './Anchor.svelte';
+import AnchorLinkComponent from './AnchorLink.svelte';
+/**
+ * 命名空间聚合导出：启用 <Anchor.Link />（照 Nav 写法，保留 typeof 类型）。
+ * 显式类型标注避免泄漏组件 Props 类型错误。
+ * 组合式 API（对齐 Semi）：children + <Anchor.Link>，无 links 数组公开 prop。
+ */
+export declare const Anchor: typeof AnchorRoot & {
+    Link: typeof AnchorLinkComponent;
+};
 export { meta as anchorMeta } from './meta.js';
-export type { AnchorLink } from './types.js';
+export type { AnchorShowTooltip, AnchorTooltipConfig, AnchorRailTheme, AnchorSize, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/anchor/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/anchor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/anchor/index.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,iBAAiB,CAAC;AACzC,OAAO,mBAAmB,MAAM,qBAAqB,CAAC;AAEtD;;;;GAIG;AACH,eAAO,MAAM,MAAM,EAAE,OAAO,UAAU,GAAG;IACvC,IAAI,EAAE,OAAO,mBAAmB,CAAC;CAGjC,CAAC;AAEH,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/anchor/index.js

@@ -1,2 +1,11 @@
-export { default as Anchor } from './Anchor.svelte';
+import AnchorRoot from './Anchor.svelte';
+import AnchorLinkComponent from './AnchorLink.svelte';
+/**
+ * 命名空间聚合导出：启用 <Anchor.Link />（照 Nav 写法，保留 typeof 类型）。
+ * 显式类型标注避免泄漏组件 Props 类型错误。
+ * 组合式 API（对齐 Semi）：children + <Anchor.Link>，无 links 数组公开 prop。
+ */
+export const Anchor = Object.assign(AnchorRoot, {
+    Link: AnchorLinkComponent,
+});
 export { meta as anchorMeta } from './meta.js';

package/dist/anchor/meta.d.ts

@@ -1,84 +1,133 @@
 /**
  * Machine-readable component metadata for AI/docs consumption.
  * See specs/00-foundation/ai-friendly.spec.md.
+ * 严格对齐 Semi Anchor：组合式 API（children + <Anchor.Link>），无 links 数组 prop。
  */
 export declare const meta: {
     readonly name: "Anchor";
     readonly category: "navigation";
-    readonly description: "锚点导航，垂直/水平链接列表。支持 scroll-spy 激活高亮、点击平滑滚动、ink 边框指示、自定义滚动容器、多级嵌套链接树，受控/非受控。";
+    readonly description: "锚点导航，垂直链接列表。组合式 API：children + <Anchor.Link>（对齐 Semi，无 links 数组 prop）。支持 scroll-spy 激活高亮、点击平滑滚动、滑轨条随激活项定位、自定义滚动容器、多级嵌套、文字缩略 Tooltip、autoCollapse 动态展开。";
     readonly props: readonly [{
-        readonly name: "links";
-        readonly type: "AnchorLink[]";
-        readonly default: "[]";
-        readonly desc: "锚点链接数据；link.children 形成多级嵌套树，渲染逐级缩进，父子皆参与滚动高亮（无 children 即平铺）";
+        readonly name: "autoCollapse";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "滚动时动态展示下一级锚点（对齐 Semi）；默认全展开";
     }, {
-        readonly name: "value";
+        readonly name: "class";
         readonly type: "string";
         readonly default: "undefined";
-        readonly desc: "受控当前激活 key";
+        readonly desc: "根类名（对齐 Semi className）";
     }, {
-        readonly name: "defaultValue";
+        readonly name: "defaultAnchor";
         readonly type: "string";
-        readonly default: "undefined";
+        readonly default: "''";
+        readonly desc: "默认高亮锚点 href（对齐 Semi defaultAnchor 1.20.0）";
+    }, {
+        readonly name: "getContainer";
+        readonly type: "() => HTMLElement | Window | null";
+        readonly default: "window";
+        readonly desc: "指定滚动容器（对齐 Semi）；缺省 window";
+    }, {
+        readonly name: "maxHeight";
+        readonly type: "string | number";
+        readonly default: "'750px'";
+        readonly desc: "组件 max-height，超出滚动（数字转 px，对齐 Semi）";
+    }, {
+        readonly name: "maxWidth";
+        readonly type: "string | number";
+        readonly default: "'200px'";
+        readonly desc: "组件 max-width，超出 ellipsis（数字转 px，对齐 Semi）";
     }, {
         readonly name: "offsetTop";
         readonly type: "number";
         readonly default: "0";
-        readonly desc: "滚动判定/定位偏移";
+        readonly desc: "滚动偏移触发 Link 切换（对齐 Semi）";
     }, {
-        readonly name: "bounds";
-        readonly type: "number";
-        readonly default: "5";
-        readonly desc: "激活判定边界容差";
+        readonly name: "position";
+        readonly type: "Placement";
+        readonly default: "undefined";
+        readonly desc: "Tooltip 显示位置；仅 showTooltip 时生效（对齐 Semi）";
     }, {
-        readonly name: "showInk";
-        readonly type: "boolean";
-        readonly default: "true";
-        readonly desc: "是否显示 ink 边框";
+        readonly name: "railTheme";
+        readonly type: "'primary' | 'tertiary' | 'muted'";
+        readonly default: "'primary'";
+        readonly desc: "滑轨主题色（对齐 Semi）；muted 隐藏滑轨";
     }, {
         readonly name: "scrollMotion";
         readonly type: "boolean";
-        readonly default: "true";
-        readonly desc: "点击是否平滑滚动（reduced-motion 下强制即时）";
-    }, {
-        readonly name: "affix";
-        readonly type: "boolean";
         readonly default: "false";
-        readonly desc: "position:sticky 吸顶";
+        readonly desc: "是否开启滚动动画（对齐 Semi）；reduced-motion 下强制即时";
     }, {
-        readonly name: "updateHash";
-        readonly type: "boolean";
+        readonly name: "showTooltip";
+        readonly type: "boolean | { type: 'tooltip' | 'popover'; opts?: Record<string, unknown> }";
         readonly default: "false";
-        readonly desc: "激活变更时写 location.hash";
+        readonly desc: "文字缩略时显示 Tooltip 及配置（对齐 Semi 2.36.0 object 形式）";
     }, {
-        readonly name: "targetOffset";
-        readonly type: "number";
-        readonly default: "offsetTop";
-        readonly desc: "点击滚动独立偏移";
+        readonly name: "size";
+        readonly type: "'small' | 'default'";
+        readonly default: "'default'";
+        readonly desc: "锚点尺寸（对齐 Semi）";
     }, {
-        readonly name: "getContainer";
-        readonly type: "() => HTMLElement | null";
+        readonly name: "style";
+        readonly type: "string";
         readonly default: "undefined";
-        readonly desc: "自定义滚动容器（缺省 window）";
+        readonly desc: "根节点自定义内联样式（对齐 Semi）";
     }, {
-        readonly name: "horizontal";
-        readonly type: "boolean";
-        readonly default: "false";
-        readonly desc: "水平模式，ink 走底部下划线";
+        readonly name: "targetOffset";
+        readonly type: "number";
+        readonly default: "0";
+        readonly desc: "锚点滚动时距顶部偏移量（对齐 Semi 1.9.0）";
     }, {
         readonly name: "onChange";
-        readonly type: "(key: string) => void";
+        readonly type: "(currentLink: string, previousLink: string) => void";
         readonly default: "undefined";
+        readonly desc: "改变锚点回调（对齐 Semi：href 字符串）";
     }, {
-        readonly name: "ariaLabel";
+        readonly name: "onClick";
+        readonly type: "(event: MouseEvent, currentLink: string) => void";
+        readonly default: "undefined";
+        readonly desc: "点击锚点回调（对齐 Semi：event + href 字符串）";
+    }, {
+        readonly name: "aria-label";
         readonly type: "string";
         readonly default: "undefined";
+        readonly desc: "根 nav aria-label（缺省走 locale）";
+    }];
+    readonly subComponents: readonly [{
+        readonly name: "Anchor.Link";
+        readonly description: "锚点链接（对齐 Semi Anchor.Link）。无 children 为叶子，有 children 为分支（嵌套树）。组合式，非数组。";
+        readonly props: readonly [{
+            readonly name: "href";
+            readonly type: "string";
+            readonly default: "—";
+            readonly desc: "跳转链接，形如 '#section-1'（对齐 Semi）";
+        }, {
+            readonly name: "title";
+            readonly type: "string";
+            readonly default: "—";
+            readonly desc: "文字内容（对齐 Semi）";
+        }, {
+            readonly name: "disabled";
+            readonly type: "boolean";
+            readonly default: "false";
+            readonly desc: "禁用，不响应点击跳转（对齐 Semi 1.20.0）";
+        }, {
+            readonly name: "class";
+            readonly type: "string";
+            readonly default: "undefined";
+            readonly desc: "类名（对齐 Semi className）";
+        }, {
+            readonly name: "style";
+            readonly type: "string";
+            readonly default: "undefined";
+            readonly desc: "样式（对齐 Semi）";
+        }];
     }];
     readonly a11y: {
         readonly role: "navigation";
-        readonly keyboard: readonly ["Tab", "Enter"];
-        readonly notes: readonly ["nav[aria-label] 包裹原生 a 链接列表", "激活链接 aria-current=true", "键盘交互为原生锚链接行为", "scroll-spy 命令式监听 scroll（getContainer 时监听容器），rAF 节流，reduced-motion 下点击即时定位", "horizontal 水平模式仅改布局/ink 方向，激活态与键盘交互不变", "多级嵌套用嵌套 ul/li 表达层级树，子链接逐级缩进；扁平化树参与 scroll-spy，父子链接均可聚焦/跳转/高亮"];
+        readonly keyboard: readonly ["Tab", "ArrowUp", "ArrowDown", "Home", "End", "Space"];
+        readonly notes: readonly ["nav[role=navigation][aria-label] 包裹链接列表；链接 role=link，激活链接 aria-current=location", "键盘：Tab 进入链接列表（roving，单一 Tab 停靠点）；↑/↓ 移动焦点；Home/End 跳首/末；Space 激活并滚动", "disabled 链接 aria-disabled=true 且从 roving 序列移除", "scroll-spy 命令式监听 scroll（getContainer 时监听容器），rAF 节流，reduced-motion 下点击即时定位", "滑轨条据激活链接标题 offsetTop 绝对定位（对齐 Semi _setActiveSlide）", "多级嵌套用嵌套 Anchor.Link 表达层级树；扁平化树参与 scroll-spy，父子链接均可聚焦/跳转/高亮"];
     };
-    readonly tokens: readonly ["--cd-anchor-link-color", "--cd-anchor-link-color-active", "--cd-anchor-link-padding", "--cd-anchor-indent", "--cd-anchor-rail-color", "--cd-anchor-ink-color", "--cd-anchor-ink-width", "--cd-focus-ring", "--cd-border-radius-small", "--cd-motion-*"];
+    readonly tokens: readonly ["--cd-color-anchor-slide-default-bg-default", "--cd-color-anchor-slide-primary-bg-active", "--cd-color-anchor-slide-tertiary-bg-active", "--cd-color-anchor-slide-muted-bg-active", "--cd-color-anchor-title-text-default", "--cd-color-anchor-title-text-hover", "--cd-color-anchor-title-active-text-hover", "--cd-color-anchor-title-text-active", "--cd-color-anchor-title-text-disabled", "--cd-color-anchor-title-bg-default", "--cd-color-anchor-title-bg-active", "--cd-color-anchor-title-outline-focus", "--cd-spacing-anchor-slide-left", "--cd-spacing-anchor-slide-top", "--cd-spacing-anchor-slide-default-y", "--cd-spacing-anchor-slide-small-y", "--cd-spacing-anchor-link-title-paddingtop", "--cd-spacing-anchor-link-title-paddingbottom", "--cd-width-anchor-slide-default", "--cd-height-anchor-slide-default", "--cd-height-anchor-slide-small", "--cd-radius-anchor-slide", "--cd-width-anchor-outline", "--cd-width-anchor-outlineoffset", "--cd-width-anchor-outline-border-radius", "--cd-transition-duration-anchor-title-text", "--cd-transition-function-anchor-title-text", "--cd-transition-delay-anchor-title-text", "--cd-transform-scale-anchor-title-text", "--cd-font-size-regular", "--cd-font-size-small"];
 };
 //# sourceMappingURL=meta.d.ts.map

package/dist/anchor/meta.d.ts.map

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