@plumeai/plugin-sdk 0.0.0-stage → 0.1.3

package/dist/client/ui/src/primitives/MarkNumber.d.ts

@@ -0,0 +1,12 @@
+import type { HTMLAttributes } from "react";
+/**
+ * 一枚圆形序号：把两处说的同一件东西对上号。
+ *
+ * 正文里划线的那段字末尾挂一枚，审批卡上那条评论前面挂同一个数——人看到卡上的「2」，回到正文里
+ * 找的就是那枚「2」，不用再读一遍引文去认。实心强调色、白字、等宽数字：两位数也不变形，深浅两套底色上
+ * 都看得清。
+ */
+export declare function MarkNumber({ n, className, ...rest }: {
+    n: number;
+    className?: string;
+} & Omit<HTMLAttributes<HTMLSpanElement>, "children">): import("react").JSX.Element;

package/dist/client/ui/src/primitives/RowDeleteButton.d.ts

@@ -0,0 +1,6 @@
+/** 动作的位置一直占着，包括只有悬停或键盘焦点才让它露出来的时候。 */
+export declare function RowDeleteButton({ label, onClick, pending }: {
+    label: string;
+    onClick: () => void;
+    pending?: boolean;
+}): import("react").JSX.Element;

package/dist/client/ui/src/primitives/Skeleton.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 形状像还没到的那样东西的占位。
+ *
+ * 用处不是在等的时候找点事看——而是内容落地时页面已经是对的形状，什么都不跳。转圈或一行「读取中…」
+ * 说的是「等等」，它一消失，底下的一切就重新排一遍；这些占位占的是真实的行和卡片将要占的同一些盒子。
+ *
+ * 只给*第一次*加载用。一旦有东西可显示，显示它本身胜过显示它的草图——真实内容背后的重新校验
+ * 不能动那些内容。
+ */
+/**
+ * 一次加载是否已经久到值得画占位。
+ *
+ * 只出现两帧的骨架是一次闪烁，闪烁读起来是故障而不是进度——缓存热的时候一个列表 59ms 就填满了，
+ * 其中占位只待了 32ms。阈值以下什么都不显示，这是对一次没人察觉的等待最诚实的描绘。
+ */
+export declare function useSlowLoad(loading: boolean, delay?: number): boolean;
+/** 一块暗色的块。`width` 是任意 CSS 长度，一排这样的块看起来能像字而不是像条。 */
+export declare function SkeletonBar({ width, height, className }: {
+    width: string;
+    height?: number;
+    className?: string;
+}): import("react").JSX.Element;
+/**
+ * 一格卡片，和目录自己的两栏排版一致。
+ *
+ * `label` 是告诉读屏的话，代替那些对它毫无意义的形状。
+ */
+export declare function SkeletonGrid({ count, label }: {
+    count?: number;
+    label?: string;
+}): import("react").JSX.Element;
+/** 一摞设置行，和它们代替的那个列表一致。 */
+export declare function SkeletonList({ count, label }: {
+    count?: number;
+    label?: string;
+}): import("react").JSX.Element;

package/dist/client/ui/src/primitives/TabStrip.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 一排标签，一个滑块滑到选中的那个。
+ *
+ * card / elevated 那一对放在浅色主题下读起来是反的（见 `controls.css` 里 `.plume-tabs` 上面那段）。
+ * 这是通用的那个：任意多个标签，每个和自己的文字一样宽，有计数时计数跟在文字旁边。
+ *
+ * 切换如果是两块底色在一帧里换位，新旧两个标签之间什么都没走，眼睛得去找变化而不是跟着它。滑块会走，
+ * 走这一下说明这些是同一条上的几个位置，而不是几个分开的按钮。
+ *
+ * 滑块是量出来的，不是算出来的——文字宽度各不相同，计数从 9 变 10 会让其中一个变宽。在 layout effect
+ * 里量，第一帧画出来时它已经在位；条或某个标签尺寸变了（字体到了、计数变了）再量。第一次放置不做动画：
+ * `data-ready` 把过渡压住，直到滑块已经在某个位置上过，这样它不会从角落飞进来。
+ */
+import { type ReactNode } from "react";
+export interface TabStripItem<T extends string> {
+    id: T;
+    label: string;
+    /** 跟在文字后面，比文字淡。不传或 `undefined` 什么都不画。 */
+    count?: number;
+    icon?: ReactNode;
+}
+export declare function TabStrip<T extends string>({ items, value, onChange, label, className, }: {
+    items: readonly TabStripItem<T>[];
+    value: T;
+    onChange: (value: T) => void;
+    /** 标签列表的无障碍名。 */
+    label: string;
+    className?: string;
+}): import("react").JSX.Element;

package/dist/client/ui/src/primitives/Text.d.ts

@@ -0,0 +1,341 @@
+/**
+ * 字号档位，做成组件。
+ *
+ * 档位本身在 `theme.css` 里，每一档带着自己的行高和字距，都由用户设的那一个字号推出来。这个文件只说
+ * 哪一档配哪个字重——缺的正是这个搭配。
+ *
+ * 只靠字号区分层级、档与档只差半个像素的话（一行 12.5，下面那行 12，再下面 11.5），半个像素没有人
+ * 看得出。读起来不是三个层级，而是一个层级排得不讲究。
+ *
+ * 所以每一档在下面配一次字重。标题更大*也*更重，说明更小*也*更淡，层级同时在两个轴上分开，而不是在
+ * 一个轴的零头上。`weight` 仍然可以覆盖，给一行要强调又不改字号的情况——但默认值应该对得足够常，
+ * 很少需要去动它。
+ */
+declare const SIZES: {
+    /** 页面标题——一屏一个。 */
+    readonly display: "text-display";
+    /** 一屏里大分区的标题。 */
+    readonly heading: "text-heading";
+    /** 小节和卡片的标题。 */
+    readonly title: "text-title";
+    /** 正文：消息、描述，一句一句读的东西。 */
+    readonly body: "text-body";
+    /** 控件、行、表格单元——界面的工作字号。 */
+    readonly label: "text-label";
+    /** 标签下面的次要细节。 */
+    readonly detail: "text-detail";
+    /** 时间戳、计数、角标。 */
+    readonly caption: "text-caption";
+};
+declare const TONES: {
+    readonly default: "text-ink";
+    readonly muted: "text-ink-muted";
+    readonly faint: "text-ink-faint";
+    readonly danger: "text-danger";
+    readonly accent: "text-accent";
+};
+declare const WEIGHTS: {
+    readonly normal: "";
+    readonly medium: "font-medium";
+    readonly semibold: "font-semibold";
+};
+/** 一段文字：`size` 选字号档位（每档带着自己的行高、字距和默认字重），`tone` 选颜色。 */
+export declare function Text({ size, tone, weight, as, mono, numeric, className, children, ...rest }: {
+    size?: keyof typeof SIZES;
+    tone?: keyof typeof TONES;
+    /** 覆盖这一档平时的字重。 */
+    weight?: keyof typeof WEIGHTS;
+    /** 渲染成什么元素。默认 `span`，能放进一句话里。 */
+    as?: "span" | "p" | "div" | "h1" | "h2" | "h3" | "label" | "code";
+    /** 等宽字体，给正文里引用的标识符和路径。 */
+    mono?: boolean;
+    /**
+     * 等宽数字。
+     *
+     * 给原地变化的数——token 数、计时、diff 统计。比例数字每跳一下字就左右挪，读起来是闪烁。
+     */
+    numeric?: boolean;
+    className?: string;
+    children?: React.ReactNode;
+} & React.HTMLAttributes<HTMLElement>): import("react").DetailedReactHTMLElement<{
+    dangerouslySetInnerHTML?: {
+        __html: string | TrustedHTML;
+    } | undefined;
+    onCopy?: import("react").ClipboardEventHandler<HTMLElement> | undefined;
+    onCopyCapture?: import("react").ClipboardEventHandler<HTMLElement> | undefined;
+    onCut?: import("react").ClipboardEventHandler<HTMLElement> | undefined;
+    onCutCapture?: import("react").ClipboardEventHandler<HTMLElement> | undefined;
+    onPaste?: import("react").ClipboardEventHandler<HTMLElement> | undefined;
+    onPasteCapture?: import("react").ClipboardEventHandler<HTMLElement> | undefined;
+    onCompositionEnd?: import("react").CompositionEventHandler<HTMLElement> | undefined;
+    onCompositionEndCapture?: import("react").CompositionEventHandler<HTMLElement> | undefined;
+    onCompositionStart?: import("react").CompositionEventHandler<HTMLElement> | undefined;
+    onCompositionStartCapture?: import("react").CompositionEventHandler<HTMLElement> | undefined;
+    onCompositionUpdate?: import("react").CompositionEventHandler<HTMLElement> | undefined;
+    onCompositionUpdateCapture?: import("react").CompositionEventHandler<HTMLElement> | undefined;
+    onFocus?: import("react").FocusEventHandler<HTMLElement> | undefined;
+    onFocusCapture?: import("react").FocusEventHandler<HTMLElement> | undefined;
+    onBlur?: import("react").FocusEventHandler<HTMLElement> | undefined;
+    onBlurCapture?: import("react").FocusEventHandler<HTMLElement> | undefined;
+    onChange?: import("react").ChangeEventHandler<HTMLElement, Element> | undefined;
+    onChangeCapture?: import("react").ChangeEventHandler<HTMLElement, Element> | undefined;
+    onBeforeInput?: import("react").InputEventHandler<HTMLElement> | undefined;
+    onBeforeInputCapture?: import("react").InputEventHandler<HTMLElement> | undefined;
+    onInput?: import("react").InputEventHandler<HTMLElement> | undefined;
+    onInputCapture?: import("react").InputEventHandler<HTMLElement> | undefined;
+    onReset?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onResetCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onSubmit?: import("react").SubmitEventHandler<HTMLElement> | undefined;
+    onSubmitCapture?: import("react").SubmitEventHandler<HTMLElement> | undefined;
+    onInvalid?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onInvalidCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onLoad?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onLoadCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onError?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onErrorCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onKeyDown?: import("react").KeyboardEventHandler<HTMLElement> | undefined;
+    onKeyDownCapture?: import("react").KeyboardEventHandler<HTMLElement> | undefined;
+    onKeyPress?: import("react").KeyboardEventHandler<HTMLElement> | undefined;
+    onKeyPressCapture?: import("react").KeyboardEventHandler<HTMLElement> | undefined;
+    onKeyUp?: import("react").KeyboardEventHandler<HTMLElement> | undefined;
+    onKeyUpCapture?: import("react").KeyboardEventHandler<HTMLElement> | undefined;
+    onAbort?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onAbortCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onCanPlay?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onCanPlayCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onCanPlayThrough?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onCanPlayThroughCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onDurationChange?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onDurationChangeCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onEmptied?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onEmptiedCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onEncrypted?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onEncryptedCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onEnded?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onEndedCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onLoadedData?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onLoadedDataCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onLoadedMetadata?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onLoadedMetadataCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onLoadStart?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onLoadStartCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onPause?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onPauseCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onPlay?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onPlayCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onPlaying?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onPlayingCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onProgress?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onProgressCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onRateChange?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onRateChangeCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onSeeked?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onSeekedCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onSeeking?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onSeekingCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onStalled?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onStalledCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onSuspend?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onSuspendCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onTimeUpdate?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onTimeUpdateCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onVolumeChange?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onVolumeChangeCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onWaiting?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onWaitingCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onAuxClick?: import("react").MouseEventHandler<HTMLElement> | undefined;
+    onAuxClickCapture?: import("react").MouseEventHandler<HTMLElement> | undefined;
+    onClick?: import("react").MouseEventHandler<HTMLElement> | undefined;
+    onClickCapture?: import("react").MouseEventHandler<HTMLElement> | undefined;
+    onContextMenu?: import("react").MouseEventHandler<HTMLElement> | undefined;
+    onContextMenuCapture?: import("react").MouseEventHandler<HTMLElement> | undefined;
+    onDoubleClick?: import("react").MouseEventHandler<HTMLElement> | undefined;
+    onDoubleClickCapture?: import("react").MouseEventHandler<HTMLElement> | undefined;
+    onDrag?: import("react").DragEventHandler<HTMLElement> | undefined;
+    onDragCapture?: import("react").DragEventHandler<HTMLElement> | undefined;
+    onDragEnd?: import("react").DragEventHandler<HTMLElement> | undefined;
+    onDragEndCapture?: import("react").DragEventHandler<HTMLElement> | undefined;
+    onDragEnter?: import("react").DragEventHandler<HTMLElement> | undefined;
+    onDragEnterCapture?: import("react").DragEventHandler<HTMLElement> | undefined;
+    onDragExit?: import("react").DragEventHandler<HTMLElement> | undefined;
+    onDragExitCapture?: import("react").DragEventHandler<HTMLElement> | undefined;
+    onDragLeave?: import("react").DragEventHandler<HTMLElement> | undefined;
+    onDragLeaveCapture?: import("react").DragEventHandler<HTMLElement> | undefined;
+    onDragOver?: import("react").DragEventHandler<HTMLElement> | undefined;
+    onDragOverCapture?: import("react").DragEventHandler<HTMLElement> | undefined;
+    onDragStart?: import("react").DragEventHandler<HTMLElement> | undefined;
+    onDragStartCapture?: import("react").DragEventHandler<HTMLElement> | undefined;
+    onDrop?: import("react").DragEventHandler<HTMLElement> | undefined;
+    onDropCapture?: import("react").DragEventHandler<HTMLElement> | undefined;
+    onMouseDown?: import("react").MouseEventHandler<HTMLElement> | undefined;
+    onMouseDownCapture?: import("react").MouseEventHandler<HTMLElement> | undefined;
+    onMouseEnter?: import("react").MouseEventHandler<HTMLElement> | undefined;
+    onMouseLeave?: import("react").MouseEventHandler<HTMLElement> | undefined;
+    onMouseMove?: import("react").MouseEventHandler<HTMLElement> | undefined;
+    onMouseMoveCapture?: import("react").MouseEventHandler<HTMLElement> | undefined;
+    onMouseOut?: import("react").MouseEventHandler<HTMLElement> | undefined;
+    onMouseOutCapture?: import("react").MouseEventHandler<HTMLElement> | undefined;
+    onMouseOver?: import("react").MouseEventHandler<HTMLElement> | undefined;
+    onMouseOverCapture?: import("react").MouseEventHandler<HTMLElement> | undefined;
+    onMouseUp?: import("react").MouseEventHandler<HTMLElement> | undefined;
+    onMouseUpCapture?: import("react").MouseEventHandler<HTMLElement> | undefined;
+    onSelect?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onSelectCapture?: import("react").ReactEventHandler<HTMLElement> | undefined;
+    onTouchCancel?: import("react").TouchEventHandler<HTMLElement> | undefined;
+    onTouchCancelCapture?: import("react").TouchEventHandler<HTMLElement> | undefined;
+    onTouchEnd?: import("react").TouchEventHandler<HTMLElement> | undefined;
+    onTouchEndCapture?: import("react").TouchEventHandler<HTMLElement> | undefined;
+    onTouchMove?: import("react").TouchEventHandler<HTMLElement> | undefined;
+    onTouchMoveCapture?: import("react").TouchEventHandler<HTMLElement> | undefined;
+    onTouchStart?: import("react").TouchEventHandler<HTMLElement> | undefined;
+    onTouchStartCapture?: import("react").TouchEventHandler<HTMLElement> | undefined;
+    onPointerDown?: import("react").PointerEventHandler<HTMLElement> | undefined;
+    onPointerDownCapture?: import("react").PointerEventHandler<HTMLElement> | undefined;
+    onPointerMove?: import("react").PointerEventHandler<HTMLElement> | undefined;
+    onPointerMoveCapture?: import("react").PointerEventHandler<HTMLElement> | undefined;
+    onPointerUp?: import("react").PointerEventHandler<HTMLElement> | undefined;
+    onPointerUpCapture?: import("react").PointerEventHandler<HTMLElement> | undefined;
+    onPointerCancel?: import("react").PointerEventHandler<HTMLElement> | undefined;
+    onPointerCancelCapture?: import("react").PointerEventHandler<HTMLElement> | undefined;
+    onPointerEnter?: import("react").PointerEventHandler<HTMLElement> | undefined;
+    onPointerLeave?: import("react").PointerEventHandler<HTMLElement> | undefined;
+    onPointerOver?: import("react").PointerEventHandler<HTMLElement> | undefined;
+    onPointerOverCapture?: import("react").PointerEventHandler<HTMLElement> | undefined;
+    onPointerOut?: import("react").PointerEventHandler<HTMLElement> | undefined;
+    onPointerOutCapture?: import("react").PointerEventHandler<HTMLElement> | undefined;
+    onGotPointerCapture?: import("react").PointerEventHandler<HTMLElement> | undefined;
+    onGotPointerCaptureCapture?: import("react").PointerEventHandler<HTMLElement> | undefined;
+    onLostPointerCapture?: import("react").PointerEventHandler<HTMLElement> | undefined;
+    onLostPointerCaptureCapture?: import("react").PointerEventHandler<HTMLElement> | undefined;
+    onScroll?: import("react").UIEventHandler<HTMLElement> | undefined;
+    onScrollCapture?: import("react").UIEventHandler<HTMLElement> | undefined;
+    onScrollEnd?: import("react").UIEventHandler<HTMLElement> | undefined;
+    onScrollEndCapture?: import("react").UIEventHandler<HTMLElement> | undefined;
+    onWheel?: import("react").WheelEventHandler<HTMLElement> | undefined;
+    onWheelCapture?: import("react").WheelEventHandler<HTMLElement> | undefined;
+    onAnimationStart?: import("react").AnimationEventHandler<HTMLElement> | undefined;
+    onAnimationStartCapture?: import("react").AnimationEventHandler<HTMLElement> | undefined;
+    onAnimationEnd?: import("react").AnimationEventHandler<HTMLElement> | undefined;
+    onAnimationEndCapture?: import("react").AnimationEventHandler<HTMLElement> | undefined;
+    onAnimationIteration?: import("react").AnimationEventHandler<HTMLElement> | undefined;
+    onAnimationIterationCapture?: import("react").AnimationEventHandler<HTMLElement> | undefined;
+    onToggle?: import("react").ToggleEventHandler<HTMLElement> | undefined;
+    onBeforeToggle?: import("react").ToggleEventHandler<HTMLElement> | undefined;
+    onTransitionCancel?: import("react").TransitionEventHandler<HTMLElement> | undefined;
+    onTransitionCancelCapture?: import("react").TransitionEventHandler<HTMLElement> | undefined;
+    onTransitionEnd?: import("react").TransitionEventHandler<HTMLElement> | undefined;
+    onTransitionEndCapture?: import("react").TransitionEventHandler<HTMLElement> | undefined;
+    onTransitionRun?: import("react").TransitionEventHandler<HTMLElement> | undefined;
+    onTransitionRunCapture?: import("react").TransitionEventHandler<HTMLElement> | undefined;
+    onTransitionStart?: import("react").TransitionEventHandler<HTMLElement> | undefined;
+    onTransitionStartCapture?: import("react").TransitionEventHandler<HTMLElement> | undefined;
+    "aria-activedescendant"?: string | undefined;
+    "aria-atomic"?: ("false" | "true" | boolean) | undefined;
+    "aria-autocomplete"?: "none" | "inline" | "list" | "both" | undefined;
+    "aria-braillelabel"?: string | undefined;
+    "aria-brailleroledescription"?: string | undefined;
+    "aria-busy"?: ("false" | "true" | boolean) | undefined;
+    "aria-checked"?: boolean | "false" | "mixed" | "true" | undefined;
+    "aria-colcount"?: number | undefined;
+    "aria-colindex"?: number | undefined;
+    "aria-colindextext"?: string | undefined;
+    "aria-colspan"?: number | undefined;
+    "aria-controls"?: string | undefined;
+    "aria-current"?: boolean | "false" | "true" | "page" | "step" | "location" | "date" | "time" | undefined;
+    "aria-describedby"?: string | undefined;
+    "aria-description"?: string | undefined;
+    "aria-details"?: string | undefined;
+    "aria-disabled"?: ("false" | "true" | boolean) | undefined;
+    "aria-dropeffect"?: "none" | "copy" | "execute" | "link" | "move" | "popup" | undefined;
+    "aria-errormessage"?: string | undefined;
+    "aria-expanded"?: ("false" | "true" | boolean) | undefined;
+    "aria-flowto"?: string | undefined;
+    "aria-grabbed"?: ("false" | "true" | boolean) | undefined;
+    "aria-haspopup"?: boolean | "false" | "true" | "menu" | "listbox" | "tree" | "grid" | "dialog" | undefined;
+    "aria-hidden"?: ("false" | "true" | boolean) | undefined;
+    "aria-invalid"?: boolean | "false" | "true" | "grammar" | "spelling" | undefined;
+    "aria-keyshortcuts"?: string | undefined;
+    "aria-label"?: string | undefined;
+    "aria-labelledby"?: string | undefined;
+    "aria-level"?: number | undefined;
+    "aria-live"?: "off" | "assertive" | "polite" | undefined;
+    "aria-modal"?: ("false" | "true" | boolean) | undefined;
+    "aria-multiline"?: ("false" | "true" | boolean) | undefined;
+    "aria-multiselectable"?: ("false" | "true" | boolean) | undefined;
+    "aria-orientation"?: "horizontal" | "vertical" | undefined;
+    "aria-owns"?: string | undefined;
+    "aria-placeholder"?: string | undefined;
+    "aria-posinset"?: number | undefined;
+    "aria-pressed"?: boolean | "false" | "mixed" | "true" | undefined;
+    "aria-readonly"?: ("false" | "true" | boolean) | undefined;
+    "aria-relevant"?: "additions" | "additions removals" | "additions text" | "all" | "removals" | "removals additions" | "removals text" | "text" | "text additions" | "text removals" | undefined;
+    "aria-required"?: ("false" | "true" | boolean) | undefined;
+    "aria-roledescription"?: string | undefined;
+    "aria-rowcount"?: number | undefined;
+    "aria-rowindex"?: number | undefined;
+    "aria-rowindextext"?: string | undefined;
+    "aria-rowspan"?: number | undefined;
+    "aria-selected"?: ("false" | "true" | boolean) | undefined;
+    "aria-setsize"?: number | undefined;
+    "aria-sort"?: "none" | "ascending" | "descending" | "other" | undefined;
+    "aria-valuemax"?: number | undefined;
+    "aria-valuemin"?: number | undefined;
+    "aria-valuenow"?: number | undefined;
+    "aria-valuetext"?: string | undefined;
+    defaultChecked?: boolean | undefined;
+    defaultValue?: string | number | readonly string[] | undefined;
+    suppressContentEditableWarning?: boolean | undefined;
+    suppressHydrationWarning?: boolean | undefined;
+    accessKey?: string | undefined;
+    autoCapitalize?: "off" | "none" | "on" | "sentences" | "words" | "characters" | undefined | (string & {});
+    autoFocus?: boolean | undefined;
+    contentEditable?: ("false" | "true" | boolean) | "inherit" | "plaintext-only" | undefined;
+    contextMenu?: string | undefined;
+    dir?: string | undefined;
+    draggable?: ("false" | "true" | boolean) | undefined;
+    enterKeyHint?: "enter" | "done" | "go" | "next" | "previous" | "search" | "send" | undefined;
+    hidden?: boolean | undefined;
+    id?: string | undefined;
+    lang?: string | undefined;
+    nonce?: string | undefined;
+    slot?: string | undefined;
+    spellCheck?: ("false" | "true" | boolean) | undefined;
+    style?: import("react").CSSProperties | undefined;
+    tabIndex?: number | undefined;
+    title?: string | undefined;
+    translate?: "yes" | "no" | undefined;
+    radioGroup?: string | undefined;
+    role?: import("react").AriaRole | undefined;
+    about?: string | undefined;
+    content?: string | undefined;
+    datatype?: string | undefined;
+    inlist?: any;
+    prefix?: string | undefined;
+    property?: string | undefined;
+    rel?: string | undefined;
+    resource?: string | undefined;
+    rev?: string | undefined;
+    typeof?: string | undefined;
+    vocab?: string | undefined;
+    autoCorrect?: string | undefined;
+    autoSave?: string | undefined;
+    color?: string | undefined;
+    itemProp?: string | undefined;
+    itemScope?: boolean | undefined;
+    itemType?: string | undefined;
+    itemID?: string | undefined;
+    itemRef?: string | undefined;
+    results?: number | undefined;
+    security?: string | undefined;
+    unselectable?: "on" | "off" | undefined;
+    popover?: "" | "auto" | "manual" | "hint" | undefined;
+    popoverTargetAction?: "toggle" | "show" | "hide" | undefined;
+    popoverTarget?: string | undefined;
+    inert?: boolean | undefined;
+    inputMode?: "none" | "text" | "tel" | "url" | "email" | "numeric" | "decimal" | "search" | undefined;
+    is?: string | undefined;
+    exportparts?: string | undefined;
+    part?: string | undefined;
+    className: string;
+}, HTMLElement>;
+export {};

package/dist/client/ui/src/primitives/TimeAgo.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 一段会自己跟上的时长。
+ *
+ * 14:02 写进 DOM 的「刚刚」到 14:40 还是「刚刚」——要是没有东西在屏幕上待那么久，这算公平。一个自己会
+ * 刷新的列表改变了这一点：行在底下更新，旁边的时长却不动，一行里唯一纯粹取决于时钟的部分成了唯一错的部分。
+ *
+ * 所有实例共用一个定时器，放在模块作用域里，只在有东西挂着时运行。一拍只重渲染这些标签——行本身按数据
+ * 记忆化，数据没变——所以让六十个时长保持准确，代价是每分钟六十个文本节点。
+ */
+export declare function TimeAgo({ iso, className }: {
+    iso: string;
+    className?: string;
+}): import("react").JSX.Element;

package/dist/client/ui/src/primitives/useCountUp.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 一个走到新值、而不是直接到达新值的数。
+ *
+ * token 数不是一下一下跳的——是一块一块落的。用量按消息上报，于是总数停着不动，然后一下子跳几万，
+ * 格式化到一位小数之后，读起来像在两个不相干的数之间闪。数怎么都是对的；缺的是「第二个数是从第一个来的」
+ * 这种感觉。
+ *
+ * 所以插值的是*显示*，值本身不插。这里不对上报的数做任何取整或平滑——目标永远是真实的数，也永远会到达。
+ * 唯一编出来的是两个数之间的那段路。
+ *
+ * 有意不做成通用的动画工具。它给一步一步到达、又想看起来连续的读数用；会变的文字用 `RollingText`，
+ * 真的每秒跳一次的值直接渲染就好。
+ */
+export declare function useCountUp(target: number, ms?: number, options?: {
+    /**
+     * 变小时是否也走过去，而不是直接设上。
+     *
+     * 默认关，这里要紧的正是默认值：一轮之内累计数只会增长，往*下*数会显示读数从未有过的值。只在一种
+     * 情形下打开：下降和上升一样真实——同一个数按不同的时段重算，90 天 → 7 天是一个真的更小的数，
+     * 两者之间的走动正说明这两个读数是同一样东西。
+     */
+    bidirectional?: boolean;
+}): number;

package/dist/client/ui/src/row/FlowRow.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 一轮对话的过程行：思考、一段工具活、收起的过程，共用的那个骨架。
+ *
+ * 模型先想，然后动手，最后才说话。这几种行是同一件事的几个阶段，读者是连着看的，所以必须长得像同一种东西：
+ * 三个行高、三个间距、三种「正在跑」的说法连着排下来，每隔几行眼睛就要重新认一次这是什么。
+ *
+ * 只管骨架：一个前置图标、一段装不下就化开的摘要、一个可选的尾部，最后是展开箭头。展开与否、里面画什么是各自的事。
+ * 图标和箭头分居两端：图标说「这一行是什么」，箭头说「点开还是收起」。
+ *
+ * 「正在跑」只有一种说法：摘要上扫过一道光（`.plume-glide`）。不再有第二个转圈的东西陪着它。
+ */
+import { type ReactNode } from "react";
+export declare function FlowRow({ icon, title, summary, trailing, trailFrom, running, open, onToggle, label, danger, ...rest }: {
+    /** 前置图标，常驻。它说的是这一行是什么，不参与展开、收起。 */
+    icon: ReactNode;
+    /** 这一行是什么（「自动压缩」）。不参与化开：装不下时先让出地方的永远该是摘要。 */
+    title?: ReactNode;
+    /** 这一行做了什么。长了两头化开、鼠标放上去自己读出来；运行中它是唯一带动效的东西。 */
+    summary?: ReactNode;
+    /** 靠右的附注，比如改动行数。 */
+    trailing?: ReactNode;
+    /** 挂上时附注从这个宽度缓过来，见 `FlowTrail`。 */
+    trailFrom?: number | undefined;
+    running?: boolean;
+    /** 省略即为不可展开：不可展开的行没有箭头，也没有指针手势。 */
+    open?: boolean | undefined;
+    onToggle?: (() => void) | undefined;
+    label?: string;
+    /** 整行红字：这一行说的是一次失败（压缩失败）。 */
+    danger?: boolean;
+} & Record<`data-${string}`, string | undefined>): import("react").JSX.Element;

package/dist/client/ui/src/row/HoverRow.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 列表行的统一外壳：标题撑满整行，图标浮在上面，悬停时渐隐给图标让位。
+ *
+ * 会话、项目、git 的行都用它。预留一格 `pr-14` 就是一道空槽；76px 的浮层列是同一个洞换了个名字。
+ * 悬停只认 `group/row` 和 `[data-plume-hover-row]` 这两个钥匙；每种行各起一个 `group/session`
+ * 之类的名字，正是置顶、归档图标不再亮起来的原因。
+ */
+import { type ComponentPropsWithoutRef, type ReactNode } from "react";
+/**
+ * 控件条量好之前先写进 `--plume-row-controls` 的兜底值。
+ *
+ * 每个点击区约 21px（`p-1` 加 12.5 的图标）。左边 6px 对应右边的 `pr-1.5`，第一个图标的内距和
+ * 最后一个一样。两个按钮的槽给 58px 时比置顶图标多出 17px——那就是多让出去的一段。
+ */
+export declare function hoverSlot(actions: 1 | 2 | 3): string;
+export declare function HoverRow({ controls, className, style, children, ...rest }: ComponentPropsWithoutRef<"div"> & {
+    controls: string;
+}): import("react").JSX.Element;
+/** 行首的图标列：每一行 git 都是同一个 12px 的框，工作树不额外缩进。 */
+export declare function HoverRowMark({ className, children }: {
+    className?: string;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** 按内容收缩的浮层。绝不做成定宽的一列：那样会把空着的框也画出来。 */
+export declare function HoverRowReveal({ className, children }: {
+    className?: string;
+    children: ReactNode;
+}): import("react").JSX.Element;

package/dist/client/ui/src/scroll/BackToLatest.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 回到底部的路，只在确实有路可回时才给。
+ *
+ * 往上翻过的转录，除了一路拖回去，没有别的办法到最新那条消息——而一轮还在输出时，「一路」的终点
+ * 还在往下走。所以给一个按钮，浮在输入框正上方、最后一条消息该在的位置。
+ *
+ * 不管显不显示它都挂着。按需挂载的话，它会以满不透明度直接出现在最终位置，看上去和布局抖了一下一样。
+ *
+ * 出现和离开不是镜像。出现时稍微往上升一点，因为它是从转录底部来的，也指向那里。离开时原地不动、
+ * 直接化掉：它离开是因为你**已经到了**底部，滚动结束时一个按钮往下掉，读起来像最后又往下冲了一下
+ * ——正是这个按钮要替你省掉的那一跳，被它当成谢幕动作做了一遍。
+ *
+ * `pointer-events` 跟着可见性走——看不见却还吞掉转录上点击的按钮，比没有按钮更糟。
+ */
+export declare function BackToLatest({ show, unread, onClick }: {
+    show: boolean;
+    unread: number;
+    onClick: () => void;
+}): import("react").JSX.Element;

package/dist/client/ui/src/scroll/OverlayScrollbar.d.ts

@@ -0,0 +1,9 @@
+export declare function OverlayScrollbar({ viewport, orientation, placement, }: {
+    viewport: React.RefObject<HTMLElement | null>;
+    orientation: "vertical" | "horizontal";
+    /**
+     * `sticky`：轨道排在视口后面，粘在外面那个竖向滚动面的底部，落在内容在末尾预留的一条 10px 上。
+     * 视口溢出期间带着 `data-hscroll="on"`，好让它的样式预留那一条——滑块不能盖住最后一行。只用于横向。
+     */
+    placement?: "overlay" | "sticky";
+}): import("react").JSX.Element | null;

package/dist/client/ui/src/scroll/ScrollText.d.ts

@@ -0,0 +1,24 @@
+import { type ReactNode } from "react";
+/**
+ * 一行字，到边上渐隐而不是以省略号结尾，所在的行被悬停时自己读出来。
+ *
+ * 省略号只报告标题被截了，不说截掉的是什么——每个以「帮我梳理这个项目的整体架构」开头的会话都缩成
+ * 同一行没法用的字。渐隐说的是同一件事，但更安静，悬停滚动则真正回答了那个问题。
+ *
+ * 滚动只朝一个方向、连续地走。左右来回扫读起来像这一行在抽搐，而不是字在被读：眼睛得一次次重新
+ * 找到开头。第一份后面跟着一份隐藏的副本，单向才能无缝循环——原文离开时，副本正好落在它开始的位置。
+ *
+ * 只有字真的读不全时才动：已经装得下的行，指针划过时不能抖。父级行带着 `plume-scroll`，悬停规则
+ * 认的就是它。
+ */
+export declare function ScrollText({ text, className, textClassName, }: {
+    text: ReactNode;
+    className?: string;
+    /**
+     * 加在装字形的那几个 span 上——正文和它循环用的副本——不加在盒子上。
+     *
+     * 给那些透过字本身画出来的效果用（`background-clip: text`、运行中的流光）。加在盒子上的话，它按
+     * 盒子自己那一层的字形裁剪，而跑马灯的 transform 把轨道抬进了单独的一层：悬停时整行变成空白。
+     */
+    textClassName?: string;
+}): import("react").JSX.Element;