@xiaoso/dsh-workflow-lite 0.0.0-stage → 0.1.0

package/lib/types/client/ui/RunNav.d.ts

@@ -0,0 +1,22 @@
+/**
+ * dsh-workflow-lite — 实例顶栏最右（右栏开关右边）的「在看什么」：图标就是右栏里正在看的那个东西的图标（同色），
+ * 概览是固定的概览图标；右栏收着时没有在看的东西，图标块不上色。点开按分类列出这次执行的节点
+ * （概览 / 步骤 / 资源 / 输入），能搜，点一项就切过去（右栏收着就打开）。
+ *
+ * @module @xiaoso/dsh-workflow-lite/client/ui/RunNav
+ */
+import type { GraphAnalysis } from '../../shared/graph.ts';
+import type { RunState } from '../../shared/runState.ts';
+import type { WorkflowDocument } from '../../shared/types.ts';
+import type { T } from '../i18n.ts';
+import { type Selection } from '../model/editor.ts';
+export declare function RunNav(props: {
+    t: T;
+    doc: WorkflowDocument;
+    analysis: GraphAnalysis;
+    state: RunState | null;
+    selection: Selection;
+    /** 右栏收着：没有在看的东西，图标块不上色（不像是开着的）。 */
+    idle: boolean;
+    onPick(selection: Selection): void;
+}): React.JSX.Element;

package/lib/types/client/ui/RunNodeState.d.ts

@@ -0,0 +1,42 @@
+/**
+ * dsh-workflow-lite — 实例视图里一个步骤的运行状态：状态、轮次、判定、摘要、失败原因（都能改，改动进草稿），
+ * 以及谁做的、什么时候开始结束。
+ *
+ * @module @xiaoso/dsh-workflow-lite/client/ui/RunNodeState
+ */
+import { type NodeStatus, type RunState, type StateEdit } from '../../shared/runState.ts';
+import type { Desktop } from '../app/desktop.ts';
+import type { Run } from '../app/useRuns.ts';
+import type { LocaleKey, T } from '../i18n.ts';
+import { type IconName } from './Icon.tsx';
+/** 步骤状态的一句话说明（悬停提示）。 */
+export declare function nodeHint(status: NodeStatus): LocaleKey;
+export declare const NODE_ICON: Record<NodeStatus, IconName>;
+export declare function isEdited(draft: readonly StateEdit[], path: readonly string[]): boolean;
+/** 改了还没保存的字段：标题旁一个小圆点。 */
+export declare function EditedDot(props: {
+    on: boolean;
+}): React.JSX.Element | null;
+/** 状态小标（只读）：用到它的步骤、上下游里每一行行尾的那个。 */
+export declare function StatusChip(props: {
+    t: T;
+    status: NodeStatus | undefined;
+}): React.JSX.Element | null;
+/** 状态、轮次、判定、摘要、失败原因。 */
+export declare function StepStatus(props: {
+    t: T;
+    current: Run;
+    id: string;
+    node: RunState['nodes'][string];
+    verdicts: readonly string[] | undefined;
+    onRerun(): void;
+    /** 摘要、失败原因的弹窗：标题与图标块。 */
+    name: string;
+    badge: React.ReactNode;
+    desktop: Desktop | undefined;
+}): React.JSX.Element;
+/** 谁做的、什么时候开始、什么时候结束；都没有就不画。 */
+export declare function StepFacts(props: {
+    t: T;
+    node: RunState['nodes'][string] | undefined;
+}): React.JSX.Element | null;

package/lib/types/client/ui/RunOverview.d.ts

@@ -0,0 +1,27 @@
+/**
+ * dsh-workflow-lite — 实例视图右栏什么都没选时的概览：总状态与进度、执行位置、说明、基本信息、时间线；
+ * 不记运行状态的实例只讲清楚为什么看不到进度。
+ *
+ * @module @xiaoso/dsh-workflow-lite/client/ui/RunOverview
+ */
+import type { RunCursor } from '../../shared/runCursor.ts';
+import { type InstanceSummary, type RunState } from '../../shared/runState.ts';
+import type { WorkflowDocument } from '../../shared/types.ts';
+import type { Run } from '../app/useRuns.ts';
+import type { T } from '../i18n.ts';
+/** 不记运行状态的实例：右栏只讲清楚为什么看不到进度，再列几样基本信息。 */
+export declare function Untracked(props: {
+    t: T;
+    summary: InstanceSummary;
+    snapshot: WorkflowDocument;
+}): React.JSX.Element;
+export declare function Overview(props: {
+    t: T;
+    current: Run;
+    snapshot: WorkflowDocument;
+    state: RunState;
+    cursor: RunCursor | null;
+    summary: InstanceSummary | undefined;
+    labelOf(id: string): string;
+    onSelect(id: string | null): void;
+}): React.JSX.Element;

package/lib/types/client/ui/RunPosition.d.ts

@@ -0,0 +1,24 @@
+/**
+ * dsh-workflow-lite — 实例总览里的「执行位置」：正在执行、最后执行、下一步各是哪几步。
+ *
+ * 和画布卡片右上角的小标是同一份结论（`shared/runCursor.ts`，模型 `resume` 拿到的也是它）：
+ * 循环里转到第几轮、从哪一步回来的，一眼能看出来。点一行到那一步。
+ * 「指定」可以改下一步：勾选的步骤进草稿（状态里的 `next`），存下后模型照它接着做。
+ *
+ * @module @xiaoso/dsh-workflow-lite/client/ui/RunPosition
+ */
+import type { RunCursor } from '../../shared/runCursor.ts';
+import type { RunState } from '../../shared/runState.ts';
+import type { WorkflowDocument } from '../../shared/types.ts';
+import type { T } from '../i18n.ts';
+export declare function RunPosition(props: {
+    t: T;
+    snapshot: WorkflowDocument;
+    state: RunState;
+    cursor: RunCursor;
+    /** 指定下一步在草稿里改过（标题旁挂小圆点）。 */
+    pinEdited: boolean;
+    /** 改指定的下一步（`null` = 取消指定，回到按流转推）。 */
+    onPin(ids: string[] | null): void;
+    onSelect(id: string): void;
+}): React.JSX.Element;

package/lib/types/client/ui/RunResource.d.ts

@@ -0,0 +1,40 @@
+/**
+ * dsh-workflow-lite — 实例视图右栏：选中一张资源卡。
+ *
+ * 右栏只放缩略信息，细节都在点开之后的详情框里：
+ * - 描述（最多三行）；
+ * - **内容**：每项一行——图标、名字，下面一行是它此刻的样子（文件：生成没有 · 大小 · 修改时间；
+ *   文件夹：在不在 · 修改时间；网址：路径；Skill：一句话说明；自定义：字数）；有说明的挂一个「说明」小签
+ *   （和模板里一样，全文在悬停提示与查看框里）。行尾是「查看」和
+ *   「打开」（文件 / 文件夹交给系统程序，网址在浏览器里开）；点这一行也是查看。
+ *   查看按种类不同：文件读正文（{@link FileViewer}），文件夹列里面有什么，网址、自定义文字显示全文，
+ *   Skill 读 SKILL.md；每种都把这一项的说明放在正文前。
+ * - **用到它的步骤**：谁产出、谁更新、谁读，带各自的运行状态，点一下跳过去。
+ *
+ * @module @xiaoso/dsh-workflow-lite/client/ui/RunResource
+ */
+import type { RunState } from '../../shared/runState.ts';
+import type { ResourceNode, WorkflowDocument } from '../../shared/types.ts';
+import type { Desktop } from '../app/desktop.ts';
+import type { HostAccess } from '../app/host.ts';
+import { type FileTarget } from '../app/useRunFile.ts';
+import type { T } from '../i18n.ts';
+import type { WorkflowLiteRpc } from '../rpc.ts';
+export declare function RunResourceDetail(props: {
+    t: T;
+    rpc: WorkflowLiteRpc;
+    instance: string;
+    host: HostAccess;
+    snapshot: WorkflowDocument;
+    resource: ResourceNode;
+    /** 每一项在不在（不是路径的项为 `null`）。 */
+    made: readonly (boolean | null)[];
+    state: RunState | null;
+    /** 状态文件的修改时间：变了就重读文件信息（模型写完文件通常也会更新状态）。 */
+    version: number;
+    desktop: Desktop | undefined;
+    onSelectStep(id: string): void;
+    onFocusFile(id: string | null): void;
+    onView(target: FileTarget, title: string, note: string | undefined): void;
+    onError(text: string): void;
+}): React.JSX.Element;

package/lib/types/client/ui/RunStatusMenu.d.ts

@@ -0,0 +1,28 @@
+/**
+ * dsh-workflow-lite — 实例视图里点步骤卡上的状态小标弹出的小菜单：改状态（有条件出边的改成完成时先问判定）、
+ * 指定为下一步、重跑这一步。
+ *
+ * @module @xiaoso/dsh-workflow-lite/client/ui/RunStatusMenu
+ */
+import { type NodeStatus } from '../../shared/runState.ts';
+import type { T } from '../i18n.ts';
+export declare function StatusMenu(props: {
+    t: T;
+    at: {
+        x: number;
+        y: number;
+    };
+    node: {
+        status: NodeStatus;
+        verdict?: string;
+    };
+    step: 'status' | 'verdict';
+    verdicts: readonly string[];
+    onStatus(status: NodeStatus): void;
+    onVerdict(verdict: string): void;
+    onRerun(): void;
+    /** 这一步在不在用户指定的下一步里。 */
+    pinned: boolean;
+    onPin(): void;
+    onClose(): void;
+}): React.JSX.Element;

package/lib/types/client/ui/RunStep.d.ts

@@ -0,0 +1,45 @@
+/**
+ * dsh-workflow-lite — 实例视图右栏：选中一个步骤。
+ *
+ * 和模板里选中步骤看到的是同一套东西，只是都换成只读、带上本次运行的样子：
+ * - 描述（最多三行）；
+ * - 运行状态（能改，见 `RunNodeState.tsx`）；
+ * - **提示词**：只露四行，点开看全文（可复制）；
+ * - **用户输入**：问了什么、这次怎么答的，点一下看那道题；
+ * - **产出 / 读取**：它写哪些、读哪些资源（`RunFiles.tsx`）；
+ * - **连接**：上游、下游，和模板里同一种行（`LinkRow.tsx`），多了对面那一步的状态，箭头绿的是本次
+ *   经过的线；点一行看那条线（线的两端再点一下就到对面那一步）。
+ *
+ * @module @xiaoso/dsh-workflow-lite/client/ui/RunStep
+ */
+import type { GraphAnalysis } from '../../shared/graph.ts';
+import type { RunState } from '../../shared/runState.ts';
+import type { InputAnswer, StepNode, WorkflowDocument } from '../../shared/types.ts';
+import type { Desktop } from '../app/desktop.ts';
+import type { Run } from '../app/useRuns.ts';
+import type { T } from '../i18n.ts';
+export declare function RunStepDetail(props: {
+    t: T;
+    current: Run;
+    snapshot: WorkflowDocument;
+    analysis: GraphAnalysis;
+    step: StepNode;
+    state: RunState | null;
+    /** 图里刚加、还没保存的步骤：没有运行状态可看。 */
+    fresh?: boolean;
+    /** 这次走过的线；不记进度时为 `null`。 */
+    taken: ReadonlySet<string> | null;
+    verdicts: readonly string[] | undefined;
+    answers: Readonly<Record<string, InputAnswer>> | undefined;
+    made: Readonly<Record<string, readonly (boolean | null)[]>>;
+    desktop: Desktop | undefined;
+    onRerun(): void;
+    onSelectNode(id: string): void;
+    onSelectEdge(id: string): void;
+    onFocusFile(id: string | null): void;
+    onViewPath(path: string): void;
+    /** 改这一步的提示词（改的是这次执行的图，进草稿）。 */
+    onEditPrompt(prompt: string): void;
+    /** 一次编辑结束（弹窗关上）：断开撤销合并。 */
+    onSeal(): void;
+}): React.JSX.Element;

package/lib/types/client/ui/RunTopBar.d.ts

@@ -0,0 +1,42 @@
+/**
+ * dsh-workflow-lite — 实例视图的顶栏：实例与工作流的下拉、总状态与进度；撤销重做、整理、检查结果
+ * （和模板编辑的顶栏同一组）；打开模板、复制状态文件路径、「在看什么」与右栏开关。
+ * 状态小标与下拉里「本会话的实例」那一段，工作流中心与模板编辑的顶栏也用。
+ *
+ * @module @xiaoso/dsh-workflow-lite/client/ui/RunTopBar
+ */
+import { type InstanceSummary, type RunState, type RunStatus } from '../../shared/runState.ts';
+import type { ValidationProblem } from '../../shared/types.ts';
+import type { RunHistory } from '../app/useRunHistory.ts';
+import type { Runs } from '../app/useRuns.ts';
+import type { LocaleKey, T } from '../i18n.ts';
+import type { RunViewProps } from './RunView.tsx';
+export declare const RUN_STATUS_TEXT: Record<RunStatus, LocaleKey>;
+/** 实例的状态小标。 */
+export declare function RunStatusBadge(props: {
+    t: T;
+    status: RunStatus | undefined;
+    problem?: 'missing' | 'invalid' | undefined;
+    /** 这个实例不记运行状态（没有状态文件）。 */
+    untracked?: boolean;
+}): React.JSX.Element;
+export declare function RunTopBar(props: RunViewProps & {
+    summary: InstanceSummary | undefined;
+    state: RunState | null;
+    /** 右栏开关右边「在看什么」的切换（顶栏最右）。 */
+    nav: React.ReactNode;
+    onTogglePanel(): void;
+    /** 图和状态排成一条的撤销 / 重做。 */
+    history: RunHistory;
+    /** 这张图的检查结果（和模板同一套规则）；图还没读回来是 `null`。 */
+    problems: readonly ValidationProblem[] | null;
+    onTidy(): void;
+    onLocate(nodeId: string): void;
+}): React.JSX.Element;
+/** 下拉里「本会话的实例」那一段。没有实例就什么都不画。 */
+export declare function RunMenuSection(props: {
+    t: T;
+    runs: Runs;
+    activeId: string | null;
+    onOpenRun(id: string): void;
+}): React.JSX.Element | null;

package/lib/types/client/ui/RunView.d.ts

@@ -0,0 +1,43 @@
+/**
+ * dsh-workflow-lite — 工作流实例视图。
+ *
+ * 和模板是同一张图、同一套画布：每张步骤卡挂上运行状态，走过的线亮、没走过的淡。
+ * 状态和图都能改，而且要顺手——卡片上的状态小标一点就改状态，右栏就地改字段；图和模板里一样拖、连、加、删，
+ * 右栏切到「编辑」就是模板的属性面板。改动先攒成草稿（「已改 x 处」），确认后一次写进实例
+ * （图的快照、状态文件），并以后台通知的形式告诉模型。执行过的步骤不能从图里删（改成「跳过」）。
+ *
+ * 顶栏和模板一样有撤销重做、整理、检查结果：撤销把图的改动和状态的改动排成一条（`useRunHistory`），
+ * 检查和模板是同一套规则。
+ *
+ * @module @xiaoso/dsh-workflow-lite/client/ui/RunView
+ */
+import type { NodeData, TemplateEntry, WorkflowEntry } from '../../shared/types.ts';
+import type { Desktop } from '../app/desktop.ts';
+import { type Runs } from '../app/useRuns.ts';
+import type { T } from '../i18n.ts';
+import type { WorkflowLiteRpc } from '../rpc.ts';
+export interface RunViewProps {
+    t: T;
+    rpc: WorkflowLiteRpc;
+    session: string | undefined;
+    id: string;
+    runs: Runs;
+    workflows: readonly WorkflowEntry[];
+    /** 「我的步骤」（就地添加菜单里列出来）。 */
+    templates: readonly TemplateEntry[];
+    /** 读一个「我的步骤」的内容；读不到回 `null`。 */
+    loadTemplate(name: string): Promise<NodeData | null>;
+    /** 把一个步骤存成「我的步骤」。 */
+    onSaveTemplate(name: string, data: NodeData): Promise<boolean>;
+    narrow: boolean;
+    inspectorW: number;
+    /** 右栏开着没有（点画布空白处收起，顶栏的开关再打开）。 */
+    panelOpen: boolean;
+    onPanel(open: boolean): void;
+    onOpenRun(id: string): void;
+    onOpenTemplate(name: string): void;
+    onOpenHub(): void;
+    /** 用系统程序打开产出文件；宿主没有桌面能力时不给。 */
+    desktop?: Desktop;
+}
+export declare function RunView(props: RunViewProps): React.JSX.Element;

package/lib/types/client/ui/SettingsDialog.d.ts

@@ -0,0 +1,25 @@
+/**
+ * dsh-workflow-lite — 「工作流设置」对话框：整张工作流的全局配置，都会编译进派发计划。
+ *
+ * 三块（画在 `SettingsFields.tsx`），一项一行，不堆说明——细节收在各自的「?」里：
+ * - **执行方式**：自动 / 串行 / 主 agent + 子代理 / Agent 团队（四张卡），下面一行**复用执行者**：
+ *   同一步骤再次执行时交回上次的子代理或队员、每次新建，或不规定；串行时用不上。
+ * - **执行时**：**设定目标**（缺省开，开始前用 `create_goal` 设成会话目标）与**记录运行状态**两个开关。
+ * - **产出根目录**：每个步骤的产出文件编译时都拼在它下面；说明里的拼接示例跟着输入实时变，
+ *   拼接与标准化走 `shared/outputPaths.ts`（和编译器同一份）。保存成默认值 = 不写这个键。
+ *
+ * 「完成」时一次交出去（一次改动 = 一条撤销步）。
+ *
+ * @module @xiaoso/dsh-workflow-lite/client/ui/SettingsDialog
+ */
+import type { WorkflowSettings } from '../../shared/types.ts';
+import type { T } from '../i18n.ts';
+export declare function SettingsDialog(props: {
+    t: T;
+    name: string;
+    settings: WorkflowSettings | undefined;
+    /** 预览用的示例产出（图里第一个产出文件；没有就是 `plan.md`）。 */
+    sample: string;
+    onSave(settings: WorkflowSettings | undefined): void;
+    onClose(): void;
+}): React.JSX.Element;

package/lib/types/client/ui/SettingsFields.d.ts

@@ -0,0 +1,37 @@
+/**
+ * dsh-workflow-lite — 「工作流设置」对话框里的三块：执行方式（四张卡 + 复用执行者）、
+ * 执行时（设定目标、记录运行状态两个开关）、产出根目录。状态都在对话框里，这里只画。
+ *
+ * @module @xiaoso/dsh-workflow-lite/client/ui/SettingsFields
+ */
+import { checkOutputRoot } from '../../shared/outputPaths.ts';
+import { type ExecutionMode, type ReusePolicy } from '../../shared/types.ts';
+import type { T } from '../i18n.ts';
+export declare function ModeGroup(props: {
+    t: T;
+    mode: ExecutionMode;
+    reuse: ReusePolicy;
+    onMode(mode: ExecutionMode): void;
+    onReuse(reuse: ReusePolicy): void;
+}): React.JSX.Element;
+export declare function DuringGroup(props: {
+    t: T;
+    setGoal: boolean;
+    runState: boolean;
+    onSetGoal(on: boolean): void;
+    onRunState(on: boolean): void;
+}): React.JSX.Element;
+/** 根目录现在的样子：问题、标准化后的写法、是不是默认值（保存时据此决定写不写）。 */
+export declare function rootStatus(root: string): {
+    problem: ReturnType<typeof checkOutputRoot>;
+    normalized: string | undefined;
+    isDefault: boolean;
+};
+export declare function RootGroup(props: {
+    t: T;
+    root: string;
+    /** 说明里拼接示例用的产出（图里第一个产出文件；没有就是 `plan.md`）。 */
+    sample: string;
+    inputRef: React.RefObject<HTMLInputElement>;
+    onChange(root: string): void;
+}): React.JSX.Element;

package/lib/types/client/ui/SkillPicker.d.ts

@@ -0,0 +1,25 @@
+/**
+ * dsh-workflow-lite — 「选择 Skill」：从会话里的 agent 能用的 skill 里挑。
+ *
+ * 一行一个 skill：左边是勾选区（勾选框、名字、一句话说明），点它选上 / 取消；右边是来源小签和
+ * 一只「眼睛」，点它看 SKILL.md（{@link SkillPreview}，那里也能直接选上）。可以勾好几个一起加，
+ * 已经在这个资源里的标成「已添加」。列不出来（没接上 skill 服务、一个都没有）时给一个「手写名字」
+ * 的出口（`onManual`），平时不占地方。
+ * `single`：编辑一项时换它的 skill——点一行就选定、直接关掉。
+ *
+ * @module @xiaoso/dsh-workflow-lite/client/ui/SkillPicker
+ */
+import type { HostAccess } from '../app/host.ts';
+import type { T } from '../i18n.ts';
+export declare function SkillPicker(props: {
+    t: T;
+    host: HostAccess;
+    /** 资源里已经有的 skill。 */
+    existing: readonly string[];
+    /** 只选一个：点一行就交出去。 */
+    single?: boolean;
+    /** 列不出来时「手写一个名字」；不给就没有这个出口。 */
+    onManual?: () => void;
+    onPick(names: string[]): void;
+    onClose(): void;
+}): React.JSX.Element;

package/lib/types/client/ui/SkillPreview.d.ts

@@ -0,0 +1,27 @@
+/**
+ * dsh-workflow-lite — 看一个 skill 的 SKILL.md。
+ *
+ * 框子是 {@link DocViewer}：正文默认排版、可切源码；标题行能复制路径、用其他程序打开
+ * SKILL.md 或在文件管理器里显示它所在的文件夹（插件运行时注册的 skill 没有文件，这两样不出现）。
+ * 正文前是它的一句话说明和「什么时候用」。从选择框里点开时，底部带一个「选上 / 用这个」。
+ *
+ * @module @xiaoso/dsh-workflow-lite/client/ui/SkillPreview
+ */
+import type { HostAccess } from '../app/host.ts';
+import type { T } from '../i18n.ts';
+import { type IconName } from './Icon.tsx';
+/** 底部的那个按钮（不给就没有底部）。 */
+export interface SkillPreviewAction {
+    label: string;
+    icon: IconName;
+    primary: boolean;
+    disabled?: boolean;
+    onClick(): void;
+}
+export declare function SkillPreview(props: {
+    t: T;
+    host: HostAccess;
+    name: string;
+    action?: SkillPreviewAction;
+    onClose(): void;
+}): React.JSX.Element;

package/lib/types/client/ui/StepMark.d.ts

@@ -0,0 +1,16 @@
+/**
+ * dsh-workflow-lite — 步骤的图标块：卡片、面板、步骤库、连接清单里认一个步骤的那个小色块。
+ *
+ * 样子取自步骤自己的 `data.icon` / `data.color`，没存的按 id 猜（`shared/appearance.ts`）。
+ *
+ * @module @xiaoso/dsh-workflow-lite/client/ui/StepMark
+ */
+import { type Appearance } from '../../shared/appearance.ts';
+import type { NodeData } from '../../shared/types.ts';
+/** 一个步骤的样子。 */
+export declare function lookOf(id: string, data: Pick<NodeData, 'icon' | 'color'> | undefined): Appearance;
+export declare function StepMark(props: {
+    look: Appearance;
+    size?: number;
+    className?: string;
+}): React.JSX.Element;

package/lib/types/client/ui/StepPanel.d.ts

@@ -0,0 +1,26 @@
+/**
+ * dsh-workflow-lite — 步骤库条目的详情（右侧面板）：点一下库里的条目就在这里看它。
+ *
+ * - **常用步骤**是内置的：只读展示提示词与产出，不能改。能做的只有"添加到画布"和
+ *   "复制为我的步骤"（复制出来的那份就可以随便改了）。连接这类只对画布上的步骤有意义的
+ *   东西，这里不出现。
+ * - **我的步骤**就是 `templates/nodes/<ID>.json`：可以改 ID、名称、描述、提示词、产出，
+ *   显式保存（Ctrl+S 也行），也可以删除。离开时还有没保存的改动，就顺手保存一次——
+ *   改了一半一点别处就丢，比"多保存了一次"糟糕得多。
+ *
+ * @module @xiaoso/dsh-workflow-lite/client/ui/StepPanel
+ */
+import type { NodeData } from '../../shared/types.ts';
+import type { Workflow } from '../app/useWorkflow.ts';
+import type { T } from '../i18n.ts';
+import { type LibraryFocus, type StepSource } from '../model/library.ts';
+export interface StepPanelProps {
+    t: T;
+    wf: Workflow;
+    focus: LibraryFocus;
+    onFocus(focus: LibraryFocus | null): void;
+    onAddToCanvas(source: StepSource): void;
+    /** 把一份内容带去新建「我的步骤」（复制内置步骤用）。 */
+    onCopyToMine(seed: NodeData, name: string): void;
+}
+export declare function StepPanel(props: StepPanelProps): React.JSX.Element | null;

package/lib/types/client/ui/ThemePicker.d.ts

@@ -0,0 +1,13 @@
+/**
+ * dsh-workflow-lite — 工作流中心「设置」页的「外观」：亮色、暗色各挑一套配色主题。
+ *
+ * 点一下马上换，不进下面的保存条（只是看起来的样子，记在浏览器里，见 app/theme.ts）。
+ * 每张小卡是那套主题的缩略：画布底、一条侧栏、两张卡和连着它们的线、选中的那张描强调色。
+ * 亮、暗两行里，此刻正用着的那一行标「正在用」。
+ *
+ * @module @xiaoso/dsh-workflow-lite/client/ui/ThemePicker
+ */
+import type { T } from '../i18n.ts';
+export declare function ThemePicker(props: {
+    t: T;
+}): React.JSX.Element;

package/lib/types/client/ui/TipLayer.d.ts

@@ -0,0 +1,17 @@
+/**
+ * dsh-workflow-lite — 悬停提示：整个视图共用一个浮层。
+ *
+ * 元素上写 `data-tip="…"` 就有提示，不用包组件、也不用加类名（不用原生 `title`：
+ * 浏览器自带的提示样子、延迟都和插件对不上）。
+ *
+ * - 浮层挂在视图根上：不被滚动区、对话框裁掉；画布缩放时字号也不跟着变。
+ * - 悬停一会儿或键盘聚焦才出来；刚收起一个又指向下一个时立刻出来，扫一排按钮不用每个都等。
+ * - 默认在元素正下方居中，下面放不下翻到上方，左右夹在视图里；长文字折行，`\n` 换行。
+ * - 按下指针、滚动、滚轮、Esc 都收起；按过的那个元素在指针离开前不再弹，点完按钮不挡视线。
+ * - `data-tip` 变了（比如「复制路径」→「已复制」）跟着换字；元素没了就收起。
+ *
+ * @module @xiaoso/dsh-workflow-lite/client/ui/TipLayer
+ */
+export declare function TipLayer(props: {
+    root: HTMLElement | null;
+}): React.ReactNode;

package/lib/types/client/ui/TopBar.d.ts

@@ -0,0 +1,32 @@
+/**
+ * dsh-workflow-lite — 顶栏：左边是"我在哪张工作流、存好了没有"，右边是撤销重做、整理、
+ * 工作流设置、检查结果，以及「预览 / 执行」组。
+ *
+ * 低频的文件操作（新建、改名、删除、重新加载）都收在工作流名字的下拉里（{@link WorkflowSwitcher}），
+ * 顶栏上常驻的只有高频动作。
+ *
+ * @module @xiaoso/dsh-workflow-lite/client/ui/TopBar
+ */
+import type { Runs } from '../app/useRuns.ts';
+import type { Workflow } from '../app/useWorkflow.ts';
+import type { T } from '../i18n.ts';
+import { type LaunchProps } from './Launch.tsx';
+export interface TopBarProps {
+    t: T;
+    wf: Workflow;
+    libraryOpen: boolean;
+    onToggleLibrary(): void;
+    onTidy(): void;
+    onLocate(nodeId: string): void;
+    onPreview(): void;
+    /** 「执行」那一半要的东西。 */
+    launch: Pick<LaunchProps, 'blocked' | 'starting' | 'session' | 'rows' | 'canCreate' | 'onRun'>;
+    onSettings(): void;
+    /** 打开这张工作流的版本。 */
+    onVersions(): void;
+    /** 本会话的工作流实例（下拉里「本会话的实例」那一段）。 */
+    runs: Runs;
+    onOpenRun(id: string): void;
+    onOpenHub(): void;
+}
+export declare function TopBar(props: TopBarProps): React.JSX.Element;

package/lib/types/client/ui/VersionList.d.ts

@@ -0,0 +1,19 @@
+/**
+ * dsh-workflow-lite — 一个工作流的版本：上面「说明 + 存为版本」，下面版本列表（新的在前）。
+ *
+ * 编辑页的「版本」对话框与工作流中心的「工作流」页共用。存的、比的都是磁盘上那份
+ * （编辑页正开着这张时先把改动写下去，见 {@link useVersions}）。
+ * 现在的内容和某个版本一样时，存的按钮按住，旁边说「现在的内容就是 v3」。
+ *
+ * @module @xiaoso/dsh-workflow-lite/client/ui/VersionList
+ */
+import type { T } from '../i18n.ts';
+import type { WorkflowLiteRpc } from '../rpc.ts';
+export declare function VersionList(props: {
+    t: T;
+    rpc: WorkflowLiteRpc;
+    name: string;
+    before?: () => Promise<boolean>;
+    onRestored?: () => void;
+    onChanged?: () => void;
+}): React.JSX.Element;

package/lib/types/client/ui/VersionRow.d.ts

@@ -0,0 +1,19 @@
+/**
+ * dsh-workflow-lite — 版本列表的一行：「v3 · 说明 · 时间 · 步骤数 · 当前」。
+ *
+ * - 点这一行展开「切到这一版会有哪些变化」（和磁盘上现在的内容比）；
+ * - 「切换 / 编辑说明 / 删除」平时藏着，悬停或键盘移进来时浮在右端（和 `WorkflowRow` 一个做法）；
+ * - 切换、删除都要再确认一次，确认卡浮在按钮旁边；编辑说明就在这一行原地换成输入框。
+ *
+ * @module @xiaoso/dsh-workflow-lite/client/ui/VersionRow
+ */
+import type { VersionEntry } from '../../shared/types.ts';
+import type { Versions } from '../app/useVersions.ts';
+import type { T } from '../i18n.ts';
+export declare function VersionRow(props: {
+    t: T;
+    entry: VersionEntry;
+    versions: Versions;
+    /** 和现在内容一样的那个版本号（切换的确认卡据此说"切回来不丢"）。 */
+    currentN: number | null;
+}): React.JSX.Element;

package/lib/types/client/ui/VersionsDialog.d.ts

@@ -0,0 +1,18 @@
+/**
+ * dsh-workflow-lite — 编辑页的「版本」对话框：正开着的这张工作流的版本（内容见 {@link VersionList}）。
+ *
+ * 动手之前先把还没写下去的改动存掉（版本存的是磁盘上那份）；切换写回之后按磁盘重新加载画布。
+ *
+ * @module @xiaoso/dsh-workflow-lite/client/ui/VersionsDialog
+ */
+import type { T } from '../i18n.ts';
+import type { WorkflowLiteRpc } from '../rpc.ts';
+export declare function VersionsDialog(props: {
+    t: T;
+    rpc: WorkflowLiteRpc;
+    name: string;
+    flush(): Promise<boolean>;
+    onRestored(): void;
+    onChanged(): void;
+    onClose(): void;
+}): React.JSX.Element;

package/lib/types/client/ui/WorkflowRow.d.ts

@@ -0,0 +1,32 @@
+/**
+ * dsh-workflow-lite — 工作流下拉里的一行：点名字打开；改名、删除就在这一行上，不用先切过去。
+ *
+ * - 「改名 / 删除」两个小按钮平时藏着，悬停或键盘移到这一行时浮在右端，和步骤数换着显示
+ *   （同一个位置淡入淡出，名字不挪）；触屏没有悬停，一直显示。
+ * - 改名在原行换成输入框，高度不变：回车或点开确认，Esc 取消。
+ * - 删除的确认卡挂在这一行的删除按钮上（由下拉统一管，见 `WorkflowSwitcher`）。
+ *
+ * @module @xiaoso/dsh-workflow-lite/client/ui/WorkflowRow
+ */
+import type { WorkflowEntry } from '../../shared/types.ts';
+import type { T } from '../i18n.ts';
+export interface WorkflowRowProps {
+    t: T;
+    entry: WorkflowEntry;
+    /** 正开着的这张。 */
+    active: boolean;
+    editing: boolean;
+    /** 这一行的确认卡开着：按钮保持显示。 */
+    busy: boolean;
+    /** 删除按钮的 ref：确认卡挂在它上面（只有确认卡指着这一行时才给）。 */
+    deleteRef: React.RefObject<HTMLButtonElement> | undefined;
+    onOpen(): void;
+    onEdit(): void;
+    /** 提交新名字；回 `false` = 名字不行，留在输入框里。 */
+    onRename(value: string): Promise<boolean>;
+    onCancelEdit(): void;
+    onDelete(): void;
+}
+export declare function WorkflowRow(props: WorkflowRowProps): React.JSX.Element;
+/** 删除确认卡上补的那句：正开着的要说编辑页会空出来，有版本的要说版本一起没。 */
+export declare function deleteDesc(t: T, entry: WorkflowEntry, open: boolean): string;