@plumeai/plugin-sdk 0.0.0-stage → 0.1.2

package/dist/client/ui/src/image/screenshot-geometry.d.ts

@@ -0,0 +1,112 @@
+/**
+ * 选区在哪、它的手柄在哪、工具条能放在哪。
+ *
+ * 和浮层分开，是因为这些全是不带 React 的算术——所以能测，而那些容易错得很隐蔽的规矩（手柄报的是你没按的
+ * 那个角、拖动把矩形翻成负的、工具条跑出屏幕）正是值得测、而不是靠点来点去发现的。
+ */
+export interface Rect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface Point {
+    x: number;
+    y: number;
+}
+/**
+ * 八个方向，按 CSS 光标的叫法命名。
+ *
+ * 角在前，这样顺着这张表做的命中测试在角和边重叠的地方优先认角——它们总是重叠，而指针瞄的就是角。
+ */
+export declare const HANDLES: readonly ["nw", "ne", "se", "sw", "n", "e", "s", "w"];
+export type Handle = (typeof HANDLES)[number];
+/** 每个手柄该显示的光标：它的名字加上 CSS 要的后缀。 */
+export declare const HANDLE_CURSOR: Record<Handle, string>;
+/** 手柄在哪，表示为选区边上的一个点。 */
+export declare function handlePoint(rect: Rect, handle: Handle): Point;
+/**
+ * 指针在哪个手柄上，没有就是 null。
+ *
+ * `tolerance` 是屏幕像素的半径，而不是手柄画出来的大小：目标得比记号大，理由和滚动条一样——八个像素见方
+ * 的一块，手落不准。
+ */
+export declare function hitHandle(rect: Rect, at: Point, tolerance: number): Handle | null;
+/** 点是否在选区里——在里面按下是移动，而不是重新拖一个。 */
+export declare function insideRect(rect: Rect, at: Point): boolean;
+/** 由两个角得到矩形，两个角哪个在前都行。 */
+export declare function rectFromPoints(a: Point, b: Point): Rect;
+/**
+ * 把一个手柄拖到某点之后的选区。
+ *
+ * 写成「挪动这个手柄管的那几条边，再规范化」，所以拖过对边时矩形会翻过来，而不是得到负的宽度——这是人在
+ * 其他任何地方改大小时预期的样子，`rectFromPoints` 本来就是这么写的。
+ */
+export declare function resizeRect(rect: Rect, handle: Handle, to: Point): Rect;
+/** 选区平移一段，保持完整、保持在屏幕里。 */
+export declare function moveRect(rect: Rect, dx: number, dy: number, within: {
+    width: number;
+    height: number;
+}): Rect;
+/** 选区裁到屏幕以内，给拉过了边的改大小用。 */
+export declare function clampRect(rect: Rect, within: {
+    width: number;
+    height: number;
+}): Rect;
+/**
+ * 工具条放在哪：选区下方，和它的左边对齐。
+ *
+ * 左对齐，因为第一个控件是最常按的，也因为从选区起点开始的工具条读起来属于它——把工具条右对齐到一个比它
+ * 窄的选区，会把控件推离它们作用的东西。
+ *
+ * 下面放不下就翻到上面，并且沿着边滑动而不是挂出去。这两样都很平常；不平常的是一块矮屏幕最底下的选区，
+ * 两边都放不下——那时它放进选区里面、贴着底，那是唯一剩下的地方。
+ */
+/**
+ * 工具条放在哪，以及最后落在选区的哪一侧。
+ *
+ * 这一侧不是装饰：工具条打开的任何东西——比如粗细和颜色的气泡——都得**背着**选区开，不然就盖住了正要标注
+ * 的东西。只有这个函数的调用方知道是哪个方向，所以把它返回出去，而不是让下游去猜。
+ */
+export interface ToolbarPlacement extends Point {
+    /** `over` 表示两侧都放不下，工具条压在选区上面。 */
+    side: "below" | "above" | "over";
+}
+export declare function toolbarPosition(rect: Rect, viewport: {
+    width: number;
+    height: number;
+}, toolbar: {
+    width: number;
+    height: number;
+}, 
+/**
+ * 工具条打开的气泡有多高，如果它会打开一个的话。
+ *
+ * 以前放工具条时当它是唯一要放得下的东西，而粗细颜色气泡开在比工具条**更远**离选区的地方——所以一个
+ * 拉到屏幕底部的选区，把工具条放进了最后一条放得下的地方，气泡就落在那下面，整个到了屏幕外。能看见的
+ * 只有底边上一排像素。
+ *
+ * 两侧都把它算进这一摞里：只有工具条**和**它打开的东西都落在屏幕上，这一侧才算放得下。
+ */
+bubble?: {
+    height: number;
+}): ToolbarPlacement;
+/**
+ * 被手拖动的工具条允许停在哪。
+ *
+ * 上面的自动摆放几乎总是对的，只在它看不见的那种情况下错：工具条盖住了正要标注的那部分图。所以它能被挪开，
+ * 挪过之后还作数的只剩这一条——它得始终够得着。
+ *
+ * `bubbleHeight` 是它上方留出的空间，因为只要工具条不贴着屏幕顶，属性气泡就往上开。不留的话，拖到紧贴顶边，
+ * 气泡开到屏幕外，手里那个工具的粗细和颜色就够不着了。
+ *
+ * 两个界限冲突时低的那个赢，这发生在比工具条加边距还矮的视口里。出了底边还能救回来——工具条还在拖它的
+ * 指针底下；出了顶边就救不回来了，屏幕上方没有地方能把它拖回来。
+ */
+export declare function clampToolbar(at: Point, toolbar: {
+    width: number;
+    height: number;
+}, viewport: {
+    width: number;
+    height: number;
+}, bubbleHeight?: number): Point;

package/dist/client/ui/src/image/useBarDrag.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 一条浮着的标注工具栏，量它多大、按住能拖走。看图器（`useMovableBar`）和截图浮层
+ * （`useToolbarPlacement`）各有各的落点规矩，量和拖是同一套，从前各写一份。
+ *
+ * 「按住才拖、空隙处按下就拖」的手势在 `AnnotateToolbar` 里，这里只接它的 `onGrab`。
+ */
+import type { Point } from "./screenshot-geometry.ts";
+export interface BarSize {
+    width: number;
+    height: number;
+    /**
+     * 它最窄时有多宽。选中一个形状时它会多出一颗按钮；按当前宽度居中的话，每选中、取消一次整排就往旁边
+     * 滑 20pt——画完一个框，正要按的下一个工具挪了位置。按最窄的居中，它只往右长。
+     */
+    narrowest: number;
+}
+/**
+ * `clamp`：拖到的位置怎么夹回屏幕里，按此刻量到的尺寸（还没量到时是 null）。每一帧都读最新的那个，
+ * 窗口大小变了也作数。
+ */
+export declare function useBarDrag(clamp: (at: Point, size: BarSize | null) => Point, initial?: Point | null): {
+    size: BarSize | null;
+    manual: Point | null;
+    dragging: boolean;
+    measure: (el: HTMLDivElement | null) => void;
+    startDrag: (grab: {
+        from: Point;
+        origin: Point;
+    }) => void;
+    reset: () => void;
+};

package/dist/client/ui/src/image/useMovableBar.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 看图器里那条标注工具栏摆在哪：默认贴着窗口底边居中，按住能拖走，拖到哪记到哪。
+ *
+ * 截图浮层那条有自己的一套（`useToolbarPlacement`），它跟着选区走；这里没有选区，只有一张居中的图
+ * 和一扇窗。共用的是：夹在窗口里的那条规矩（`clampToolbar`），量它多大、拖到哪（`useBarDrag`）。
+ *
+ * 从前这一条钉死在窗口底边，理由是「没有别处可去」。可它要躲的从来不是窗口，是图：在图的下半部
+ * 写字、画框时，工具栏和它上面那排粗细颜色正好压在要标的地方，挪不开就只能放大了绕着画。
+ */
+import { type Point } from "./screenshot-geometry.ts";
+export interface MovableBar {
+    /** 画在哪，窗口坐标；还没量到时是 null。 */
+    at: Point | null;
+    /** 外框的位置样式：量到之前由 CSS 居中，之后按像素摆。 */
+    style: React.CSSProperties;
+    /** 正在被拖：位置不加缓动，光标也这么说。 */
+    dragging: boolean;
+    /** 挂在装着工具栏的那个元素上的 ref 回调。 */
+    measure: (el: HTMLDivElement | null) => void;
+    /** 一下按住变成拖动时，`AnnotateToolbar` 调它。 */
+    startDrag: (grab: {
+        from: Point;
+        origin: Point;
+    }) => void;
+}
+export declare function useMovableBar(avoid: React.RefObject<HTMLElement | null>): MovableBar;

package/dist/client/ui/src/image/useToolbarPlacement.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 截图工具条画在哪，以及被拖到哪。
+ *
+ * 从截图浮层里拆出来的。那个组件有 17 个 `useState`，这五个（两个 state、两个 ref、一个派生位置）只服务
+ * 一件事，彼此之间的来往比它们和别处的来往多得多——所以它们是一组，而剩下那个组件里再也看不到「工具条
+ * 现在多宽」这种东西。
+ *
+ * 对外只有五样：画在哪、正在拖吗、怎么量、怎么开始拖、怎么归位。工具条自己的尺寸、手动位置、
+ * 那个 `ResizeObserver`，调用方一个都不需要知道。
+ */
+import { type Point, type Rect } from "./screenshot-geometry.ts";
+/** 工具条最终落在哪，以及气泡该往哪一边开。只有下面那个接口用，所以不导出。 */
+type ToolbarAt = (Point & {
+    side: "above" | "below" | "over";
+}) | null;
+export interface ToolbarPlacement {
+    /** 画在哪。`null` 表示还没有选区，也就没有工具条。 */
+    at: ToolbarAt;
+    /** 正在被拖动——调用方拿它改光标。 */
+    dragging: boolean;
+    /** 挂在工具条那个元素上的 ref 回调。 */
+    measure: (el: HTMLDivElement | null) => void;
+    /** 按住把手时调用，带上按下的点和当时工具条的位置。 */
+    startDrag: (grab: {
+        from: Point;
+        origin: Point;
+    }) => void;
+    /** 新一轮截图开始时调用：忘掉用户上一轮把它拖到了哪。 */
+    reset: () => void;
+}
+/**
+ * `bounds` 可以是 null。
+ *
+ * 组件在拿到第一帧数据之前就早返回了，而 hook 必须在那之前调用——所以这里收一个可能还不存在的
+ * 屏幕尺寸。它为 null 时 `selection` 必然也是 null（没有截图就没有选区），下面那两处算位置的
+ * 地方都走不到。
+ */
+export declare function useToolbarPlacement(selection: Rect | null, bounds: {
+    width: number;
+    height: number;
+} | null): ToolbarPlacement;
+export {};

package/dist/client/ui/src/index.d.ts

@@ -0,0 +1,140 @@
+/**
+ * 基础组件。产品界面和插件共用，渲染进程经 import map 把同一份实例给插件。
+ * 卡片外框、代码块、diff 视图在这个文件里；其余的通用组件按目录分：
+ * primitives（按钮、标签条……）、inputs（输入框、选择框）、overlay（弹层、对话框、菜单、悬停提示）、
+ * scroll、layout、motion、avatar，以及 lib 里它们共用的函数。图标走 `@plume/ui/icons`。
+ * 类名都来自 @plume/styles 和 @plume/styles/ui.css，插件用这些组件不用自己带样式。
+ */
+import { type ReactNode } from "react";
+export { I18nProvider, useI18n } from "./i18n/context.tsx";
+export { formatList } from "./i18n/list.ts";
+export { LOCALE_OPTIONS, type UiLocale } from "./i18n/locales.ts";
+export type { MessageKey, ResolvedUiLocale } from "./i18n/messages/index.ts";
+export { activeLocale, translate } from "./i18n/translate.ts";
+export * from "./avatar/AgentAvatar.tsx";
+export * from "./avatar/AvatarPile.tsx";
+export * from "./avatar/AvatarStack.tsx";
+export * from "./avatar/art.ts";
+export * from "./fileIcon.tsx";
+export * from "./hooks/useCopied.ts";
+export * from "./hooks/useLiveRefresh.ts";
+export * from "./hooks/useNarrow.ts";
+export * from "./inputs/ComposerToggle.tsx";
+export * from "./inputs/DateRangeField.tsx";
+export * from "./inputs/NativeField.tsx";
+export * from "./inputs/pickers.tsx";
+export * from "./inputs/SearchField.tsx";
+export * from "./inputs/Segmented.tsx";
+export * from "./inputs/Select.tsx";
+export * from "./inputs/TextArea.tsx";
+export * from "./inputs/ShortcutRecorder.tsx";
+export * from "./inputs/Toggle.tsx";
+export * from "./inputs/WorktreeToggle.tsx";
+export * from "./inputs/day-range.ts";
+export * from "./inputs/useFieldFade.ts";
+export * from "./keyboard.ts";
+export * from "./layout/ApprovalFrame.tsx";
+export * from "./layout/Collapse.tsx";
+export * from "./layout/CopyMark.tsx";
+export * from "./layout/Disclosure.tsx";
+export * from "./layout/ErrorBoundary.tsx";
+export * from "./layout/PageTopRow.tsx";
+export * from "./layout/PanelEmpty.tsx";
+export * from "./layout/ResizeHandle.tsx";
+export * from "./layout/Settings.tsx";
+export * from "./layout/RetainedViews.tsx";
+export * from "./layout/Splitter.tsx";
+export * from "./lib/agent-avatar.ts";
+export * from "./lib/code/font-stack.ts";
+export * from "./lib/code/themes.ts";
+export * from "./lib/date-format.ts";
+export * from "./lib/dispatches.ts";
+export * from "./lib/hour-style.ts";
+export * from "./lib/number-draft.ts";
+export * from "./lib/relative-time.ts";
+export * from "./lib/tiling.ts";
+export * from "./lib/typing.ts";
+export * from "./motion/RollWords.tsx";
+export * from "./motion/RollingText.tsx";
+export * from "./motion/TypedText.tsx";
+export * from "./motion/freeze.ts";
+export * from "./motion/held.ts";
+export * from "./motion/loaders.tsx";
+export * from "./motion/reduced.ts";
+export * from "./motion/ticked.ts";
+export * from "./motion/ticker.ts";
+export * from "./motion/tokens.ts";
+export * from "./motion/useNow.ts";
+export * from "./overlay/Confirm.tsx";
+export * from "./overlay/ContextMenu.tsx";
+export * from "./overlay/Dialog.tsx";
+export * from "./overlay/Menu.tsx";
+export * from "./overlay/Overlay.tsx";
+export * from "./overlay/Popover.tsx";
+export * from "./overlay/Tooltip.tsx";
+export * from "./overlay/chrome-top.ts";
+export * from "./overlay/hover-layers.ts";
+export * from "./overlay/portal.ts";
+export * from "./overlay/scrims.ts";
+export * from "./overlay/tooltip-attribute.ts";
+export * from "./primitives/Button.tsx";
+export * from "./primitives/Caret.tsx";
+export * from "./primitives/ChoiceMark.tsx";
+export * from "./primitives/ClosableTab.tsx";
+export * from "./primitives/CountUp.tsx";
+export * from "./primitives/GitHubMark.tsx";
+export * from "./primitives/IconButton.tsx";
+export * from "./primitives/MarkNumber.tsx";
+export * from "./primitives/RowDeleteButton.tsx";
+export * from "./primitives/Skeleton.tsx";
+export * from "./primitives/TabStrip.tsx";
+export * from "./primitives/Text.tsx";
+export * from "./primitives/TimeAgo.tsx";
+export * from "./primitives/useCountUp.ts";
+export * from "./row/FlowRow.tsx";
+export * from "./row/HoverRow.tsx";
+export * from "./scroll/BackToLatest.tsx";
+export * from "./scroll/OverlayScrollbar.tsx";
+export * from "./scroll/ScrollText.tsx";
+export * from "./scroll/Scroller.tsx";
+export * from "./scroll/Sideways.tsx";
+export * from "./scroll/fade.ts";
+export * from "./scroll/follow.ts";
+export * from "./scroll/measure-batch.ts";
+export * from "./scroll/memory.ts";
+export * from "./scroll/signature.ts";
+export * from "./scroll/useFollowBottom.ts";
+export * from "./scroll/useSideways.ts";
+export { clampZoom, wheelZoomFactor, ZOOM_MAX, ZOOM_MIN, ZOOM_STEP, zoomAt, type Shape, type Tool } from "./image/annotate.ts";
+export { COLOURS, useAnnotator, type Annotator, type AnnotatorOptions, type RawPixels } from "./image/Annotator.tsx";
+export { AnnotateCanvas, STAGE_FIT } from "./image/AnnotateCanvas.tsx";
+export { AnnotateToolbar } from "./image/AnnotateToolbar.tsx";
+export { clampRect, clampToolbar, HANDLE_CURSOR, HANDLES, handlePoint, hitHandle, insideRect, moveRect, rectFromPoints, resizeRect, toolbarPosition, type Handle, type Point, type Rect, } from "./image/screenshot-geometry.ts";
+export { useBarDrag, type BarSize } from "./image/useBarDrag.ts";
+export { useMovableBar, type MovableBar } from "./image/useMovableBar.ts";
+export { useToolbarPlacement, type ToolbarPlacement } from "./image/useToolbarPlacement.ts";
+export interface CardProps {
+    title: ReactNode;
+    /** 标题右边的简短说明，单行，超出省略。 */
+    subtitle?: ReactNode;
+    /** 右上角的状态文字。 */
+    status?: ReactNode;
+    tone?: "default" | "error" | "warning";
+    children?: ReactNode;
+}
+export declare function Card({ title, subtitle, status, tone, children }: CardProps): import("react").JSX.Element;
+export declare function CodeBlock({ children }: {
+    children: string;
+}): import("react").JSX.Element;
+type DiffLine = {
+    kind: "same" | "add" | "remove";
+    text: string;
+};
+/** 按行比较。用 LCS，够看小段改动；大文件的 diff 不在这里做。 */
+export declare function diffLines(before: string, after: string): DiffLine[];
+export declare function DiffView({ before, after }: {
+    before: string;
+    after: string;
+}): import("react").JSX.Element;
+export * from "./inputs/ColorField.tsx";
+export * from "./inputs/Slider.tsx";

package/dist/client/ui/src/inputs/ColorField.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 那枚色块。里面的输入框是色块的一部分（底色就是它编辑的颜色），不是一个单独的输入框，所以不用 Input 的外观。
+ */
+export declare function ColorField({ value, onChange, label, readOnly, }: {
+    value: string;
+    onChange: (value: string) => void;
+    label: string;
+    readOnly?: boolean;
+}): import("react").JSX.Element;

package/dist/client/ui/src/inputs/ComposerToggle.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 输入框工具栏里一个有开、关两态的模式开关（工作树、计划模式）。
+ *
+ * 关着时是一颗淡色图标，常驻，免得这一排因为一个模式时有时无地跳宽度；开着时才带字、换成强调色——它改变的是
+ * 下一轮能做什么，开着却看不出来，人会奇怪 agent 为什么不照常做事。
+ *
+ * 开和关是同一颗按钮、同一个左内边距：左右 6px 让关着时正好是控件边长的方块，一点图标不横跳，颜色也能过渡。
+ */
+import type { ReactNode } from "react";
+export declare function ComposerToggle({ on, onChange, icon, label, tip, size, ...data }: {
+    on: boolean;
+    onChange: (on: boolean) => void;
+    /** 16px 的图标，颜色跟着文字走。 */
+    icon: ReactNode;
+    /** 开着时图标旁边的字。 */
+    label: string;
+    /** 悬停提示和无障碍名：说点了会怎样。 */
+    tip: string;
+    /** `sm` 放在 `Button size="sm"` 旁边：26px；主输入框的控件跟着 `--plume-composer-control`。 */
+    size?: "composer" | "sm";
+} & {
+    [key: `data-${string}`]: string | undefined;
+}): import("react").JSX.Element;

package/dist/client/ui/src/inputs/DateRangeField.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 选一段日子。
+ *
+ * 一个字段加一张浮出来的月历，和界面里每个下拉用的是同一套东西：`plume-field` 的触发器、
+ * `Popover` 的定位、翻转、层级和 120ms 的进出。自己写一张浮层意味着自己再答一遍「窗口底部放不下
+ * 怎么办」「Escape 关不关」「关的时候要不要动画」——那三个问题这里已经有答案了。
+ *
+ * **没有一条分隔线。** 层次靠留白和字色分：快捷那一排是药丸，月历是网格，两者之间是 10px 的气。
+ * 一张 240px 宽的卡片上画两条横线，得到的是三个盒子叠在一起，而不是一张卡片。
+ *
+ * 选中的那一段是**一条**，不是几个圆点：中间的日子铺一层淡底连起来，两端压在上面。这样「从哪天
+ * 到哪天」是看出来的，不用去读两个日期再在脑子里减一下。
+ */
+import { type DayRange } from "./day-range.ts";
+/** 字段上印的那一行：一段日子、一个开头、或者「全部时间」。 */
+export declare function rangeLabel(range: DayRange): string;
+export declare function DateRangeField({ value, onChange, earliest, today, ariaLabel, }: {
+    value: DayRange;
+    onChange: (range: DayRange) => void;
+    /** 最早有记录的那天。比它更早的日子画出来但点不动——那儿本来就没有东西可删。 */
+    earliest?: string | null;
+    /** 注入的「今天」，让测试不必等到明天才跑得一样。 */
+    today?: Date;
+    ariaLabel?: string;
+}): import("react").JSX.Element;

package/dist/client/ui/src/inputs/NativeField.d.ts

@@ -0,0 +1,5 @@
+import { type ComponentPropsWithRef } from "react";
+/** 不带样式的原生控件：布局、ref、选区和撤销历史都留在调用方手里。 */
+export declare function Input(props: ComponentPropsWithRef<"input">): import("react").JSX.Element;
+/** 同 `Input`，多行。要带框、滚动条和渐隐的多行框用 `TextArea`。 */
+export declare function Textarea(props: ComponentPropsWithRef<"textarea">): import("react").JSX.Element;

package/dist/client/ui/src/inputs/SearchField.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 搜索框。
+ *
+ * 侧栏的会话搜索、审阅面板的文件筛选、文件树的筛选共用这一个。各写各的话，每个都有自己的高度、
+ * 自己的描边、自己对放大镜在框里还是框旁的看法——一个只有一个答案的问题，得到三个答案。
+ *
+ * 两种尺寸，因为两种场合确实不同：独占一行的框（`comfortable`），和塞进面板标题行、周围的行都很矮
+ * 的框（`compact`）。
+ */
+export declare function SearchField({ value, onChange, placeholder, size, autoFocus, onEscape, onEnter, className, }: {
+    value: string;
+    onChange: (next: string) => void;
+    placeholder?: string;
+    size?: "compact" | "comfortable";
+    autoFocus?: boolean;
+    /** Esc 先清空，已经空了才关闭，筛选框要的就是这样。 */
+    onEscape?: () => void;
+    /** 输入法组字结束后的 Enter——上屏候选词的那个 Enter 不算。 */
+    onEnter?: () => void;
+    className?: string;
+}): import("react").JSX.Element;

package/dist/client/ui/src/inputs/Segmented.d.ts

@@ -0,0 +1,23 @@
+import { type ReactNode } from "react";
+/**
+ * 一排互斥的选项，选中的那个下面垫着一块会滑过去的底。
+ *
+ * 一块共用的底从这里滑到那里，滑动本身就说明这几个选项是同一排里的几个位置，不是几个开关。
+ * 位置是量出来的，不按等分算：中英混排的标签不一样宽。量在 layout effect 里，赶在这一帧画出来之前——晚一帧的话，
+ * 第一次渲染就能看见那块底从左上角飞过来。
+ *
+ * 圆角外框 8px、滑块和每一格 6px：内衬 2px，两道圆弧才同心。
+ */
+export declare function Segmented<T extends string>({ value, onChange, options, }: {
+    value: T;
+    onChange: (value: T) => void;
+    /**
+     * 给了 `icon` 这一格就画成图标，`label` 变成它的提示和无障碍名字。
+     * `label` 无论如何都要给：只有图标、没有名字的控件，读屏读不出，别人也猜不着。
+     */
+    options: {
+        value: T;
+        label: string;
+        icon?: ReactNode;
+    }[];
+}): import("react").JSX.Element;

package/dist/client/ui/src/inputs/Select.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 从一张单子里选一个：`Select` 填满表单的一行，`InlineSelect` 放在一项设置的末尾或面板的标题行里。
+ *
+ * 放在基础组件里而不是设置页里：设置以外的地方（任务板、卡片上的调整项、模型画出来的界面卡片）也要用它。
+ */
+export declare function Select<T extends string>(props: {
+    value: T;
+    onChange: (value: T) => void;
+    options: {
+        value: T;
+        label: string;
+        detail?: string;
+        icon?: React.ReactNode;
+    }[];
+    ariaLabel?: string;
+}): import("react").JSX.Element;
+/** 设置行里用的紧凑行内下拉，像「Zed ˅」那样只有字和箭头。 */
+export declare function InlineSelect<T extends string>(props: {
+    value: T;
+    onChange: (value: T) => void;
+    options: {
+        value: T;
+        label: string;
+        detail?: string;
+        icon?: React.ReactNode;
+    }[];
+    ariaLabel?: string;
+    quiet?: boolean;
+    set?: boolean;
+    /** 给面板标题行而不是设置行——见 `Dropdown` 的 `size`。 */
+    compact?: boolean;
+}): import("react").JSX.Element;

package/dist/client/ui/src/inputs/ShortcutRecorder.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 录一组快捷键：点一下进入录制，按下的那组键就是值（Electron accelerator 的写法）。Esc 放弃，⌫ / Delete 清空。
+ */
+export declare function ShortcutRecorder({ value, onChange, placeholder }: {
+    value?: string;
+    onChange: (shortcut: string) => void;
+    placeholder?: string;
+}): import("react").JSX.Element;

package/dist/client/ui/src/inputs/Slider.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 轨道和把手自己画的滑块。原生 range 叠在最上面、完全透明，拖动、点轨道跳过去、方向键都是浏览器自己的，
+ * 画出来的部分只跟着 value 走。
+ */
+export declare function Slider({ value, onChange, min, max, step, label, width, }: {
+    value: number;
+    onChange: (value: number) => void;
+    min?: number;
+    max?: number;
+    step?: number;
+    label: string;
+    width?: number | string;
+}): import("react").JSX.Element;

package/dist/client/ui/src/inputs/TextArea.d.ts

@@ -0,0 +1,30 @@
+import { type ComponentPropsWithoutRef } from "react";
+/**
+ * 写很多字的地方，一种写法。
+ *
+ * 各处的多行输入框各写各的类名串，会长出好几种圆角、内衬和底色——而它们要人做的是同一件事。
+ * 样子由 `.plume-textarea-shell` / `.plume-textarea` 出（见 `@plume/styles` 的 `ui/controls.css`），
+ * 调用方只说高度和位置。
+ *
+ * 三样东西是一起来的，缺一件那个框就回到从前：
+ *
+ * - **边界在外壳上**。虚化收的是元素画出的一切，描边和字同在一个元素上，滚到顶时框的上下边会跟
+ *   着字一起淡掉，像破了个口子。
+ * - **滑块是自己画的**。原生滚动条在全局被关掉了（见 `OverlayScrollbar` 的开头），不补一个，一
+ *   篇长草稿滚起来没有任何东西说它有多长。
+ * - **两头化开**。硬切的半行字读起来像渲染坏了，见 `useFieldFade`。
+ *
+ * 主输入框、消息编辑框这类框里还站着别的东西（工具栏、附件条、那排按钮）的不走这里，外壳是各自的。
+ * 共享的是同一个 `useFieldFade` 和同一条遮罩。
+ */
+export declare function TextArea({ value, onChange, shell, className, fieldRef, resizable, ...rest }: {
+    value: string;
+    onChange: (value: string) => void;
+    /** 外壳上的额外类。高度、外边距、宽度——和这个框在页面上待在哪儿有关的事，调用方说了算。 */
+    shell?: string;
+    /** 字那一层的额外类：等宽、字号、`h-[180px]` 这类只跟可写区域有关的。 */
+    className?: string;
+    fieldRef?: React.RefObject<HTMLTextAreaElement | null>;
+    /** 能不能用鼠标拉高。只给写长文的地方，比如一份系统提示词。 */
+    resizable?: boolean;
+} & Omit<ComponentPropsWithoutRef<"textarea">, "value" | "onChange" | "className" | "ref">): import("react").JSX.Element;

package/dist/client/ui/src/inputs/Toggle.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 所有布尔设置用的开关。轨道两种状态都跟着主题和强调色；圆点用 `.plume-knob`，和外观页的滑块同一种处理：
+ * 白底加细边和阴影，浅色轨道上也看得见，暗色下压暗一点不刺眼。
+ */
+export declare function Toggle({ checked, onChange, ariaLabel, disabled, }: {
+    checked: boolean;
+    onChange: (checked: boolean) => void;
+    ariaLabel?: string;
+    disabled?: boolean;
+}): import("react").JSX.Element;

package/dist/client/ui/src/inputs/WorktreeToggle.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 这次对话在它自己的工作树里，还是就在项目本身里。
+ *
+ * 每次对话各自选，在发出第一条消息之前——只有这一刻选择才有意义，跑过的对话事后没法搬进一份副本。
+ * 起始值由用它的地方给（建议卡片从模型说的 `edits_in_parallel` 起步）；没有「新会话默认开」的设置，开不开每一次由人定。
+ *
+ * 是项目和分支旁边的一个开关，不是菜单：答案只有两个，一眼都看得见——只有标志，或者标志加上它的名字、
+ * 用强调色，和计划模式开关说同一件事的方式一样。分叉图标是侧栏标在有工作树的对话上的那个，不是旁边
+ * 分支标记的那个。
+ *
+ * 放在基础组件里而不是某个功能里，因为有两处要问这个问题——主输入框，问正在写的这次对话；建议的
+ * 对话卡片，问它要开始的那一次。
+ */
+export declare function WorktreeToggle({ on, onChange, size, }: {
+    on: boolean;
+    onChange: (on: boolean) => void;
+    /** `sm` 放在 `Button size="sm"` 旁边，比如建议卡片上：26px，主输入框的控件是 28px。 */
+    size?: "composer" | "sm";
+}): import("react").JSX.Element;

package/dist/client/ui/src/inputs/day-range.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 一段日子，以及画出一个月需要的那点算术。
+ *
+ * 全部按**本地**日期算（`dayKey`），按日统计的地方都该用同一个口径。这不是随手选的：一次
+ * 23:00 的对话属于你过的那一天，换成 UTC 它会跑到第二天去，于是日历上圈出来的那一段和页面上
+ * 的数字对不上——而这两样东西正是给同一个人看的。
+ *
+ * 纯函数单独放，因为这里每一条都有一个说不清就会错的边界：月初那几格属于上个月、选反了的两头、
+ * 跨年的「上一个月」。这些用几行断言问清楚，比在一个画了四十二个格子的组件里翻出来便宜得多。
+ */
+/** 一段日子，两头都含当天。null 表示那一头不设限。 */
+export interface DayRange {
+    from: string | null;
+    to: string | null;
+}
+/** 本地日期键 `YYYY-MM-DD`。刻意不是 ISO/UTC——见文件开头。 */
+export declare function dayKey(date: Date): string;
+/** 把日期键读回本地当天的零点。读不出来给 null，调用方当作「没设」。 */
+export declare function parseDay(key: string | null | undefined): Date | null;
+/** 同一个月里的第一天。用来做月历的锚，也用来比较「是不是同一个月」。 */
+export declare function monthStart(date: Date): Date;
+/**
+ * 往前或往后几个月。
+ *
+ * 走 `new Date(年, 月 + n, 1)` 而不是 `setMonth`：后者在当前是 31 号时会溢出到下个月（3 月 31
+ * 日往前一个月得到 3 月 3 日），而这里永远从 1 号起算，没有这个问题。跨年也由它自己处理。
+ */
+export declare function addMonths(date: Date, n: number): Date;
+/**
+ * 画一个月要的六行七列。
+ *
+ * 固定六行，哪怕这个月五行就排得下——行数随月份变，面板的高度就会跟着跳，翻个月整张卡片弹一下。
+ * 头尾补的是真实的上下月日期，不是空格：它们照样可选，因为「8 月 31 日到 9 月 2 日」是一段人会
+ * 真的想选的日子，而它横跨两个月。
+ *
+ * `weekStart` 是一周从星期几开始（0 = 周日）。中文习惯从周一起，所以调用处传 1。
+ */
+export declare function monthGrid(month: Date, weekStart?: number): Date[][];
+/** 这一天落在这段里吗。两头都含当天，空的那头不设限。 */
+export declare function inRange(day: string, range: DayRange): boolean;
+/** 两头都有，而且这一天严格在中间——中间那几格是连起来的一条，两端另画。 */
+export declare function isInterior(day: string, range: DayRange): boolean;
+/**
+ * 点了一天之后，这段日子变成什么。
+ *
+ * 三种情形，而第三种是大多数日历弄拧的那一种：
+ *
+ *   还没开头，或者上一段已经选完 → 这一天是新的开头，结尾清空（开始重新选一段）
+ *   有开头没结尾，点的日子不比开头早 → 这一天是结尾，一段选完
+ *   有开头没结尾，点的日子比开头早 → **改开头**，不是选出一段倒着的日子
+ *
+ * 最后那条是关键：人想把范围往前扩的时候，做的动作就是点一个更早的日子。把它读成「结尾在开头
+ * 前面」得到的是一段空范围，而且没有任何提示说刚才发生了什么。
+ */
+export declare function pickDay(range: DayRange, day: string): DayRange;
+/** 这段日子有几天，两头都算。哪一头空着都数不出来。 */
+export declare function rangeLength(range: DayRange): number | null;