@openviking/react 0.1.0 → 0.1.2

package/dist/components/viking-bot/interaction/index.d.ts

@@ -0,0 +1,4 @@
+export { VikingBotInteraction } from './lazy-interaction.js';
+export { DEFAULT_INTERACTION_LABELS } from './labels.js';
+export type { InteractionLabels } from './labels.js';
+export type { VikingBotInteractionAnswer, VikingBotInteractionLabels, VikingBotInteractionOption, VikingBotInteractionProps, VikingBotInteractionRenderContext, VikingBotInteractionRequest, VikingBotRepairOption, VikingBotScheduleValue, } from './types.js';

package/dist/components/viking-bot/interaction/labels.d.ts

@@ -0,0 +1,7 @@
+import type { VikingBotInteractionLabels } from './types.js';
+/** 内部完整文案类型，从公开类型派生，保证宿主可覆盖每一处文案。 */
+export type InteractionLabels = Required<Omit<VikingBotInteractionLabels, 'progress'>> & {
+    progress: (index: number, total: number) => string;
+};
+/** 内置交互区文案。Built-in interaction copy. */
+export declare const DEFAULT_INTERACTION_LABELS: InteractionLabels;

package/dist/components/viking-bot/interaction/lazy-interaction.d.ts

@@ -0,0 +1,3 @@
+import type { VikingBotInteractionProps } from './types.js';
+/** 待确认交互区。The pending-interaction area. */
+export declare function VikingBotInteraction(props: VikingBotInteractionProps): import("react").JSX.Element;

package/dist/components/viking-bot/interaction/schedule-input.d.ts

@@ -0,0 +1,13 @@
+import type { InteractionLabels } from './labels.js';
+import type { VikingBotInteractionRequest } from './types.js';
+type ScheduleRequest = Extract<VikingBotInteractionRequest, {
+    kind: 'schedule';
+}>;
+/** 定时输入。Schedule input. */
+export declare function ScheduleInput({ request, labels, disabled, onChange, }: {
+    request: ScheduleRequest;
+    labels: InteractionLabels;
+    disabled?: boolean;
+    onChange: (value: unknown) => void;
+}): import("react").JSX.Element;
+export {};

package/dist/components/viking-bot/interaction/style.css

@@ -0,0 +1,189 @@
+.ov-viking-bot__interaction {
+  box-sizing: border-box;
+  border-top: 1px solid var(--ov-viking-bot-border);
+  flex-direction: column;
+  flex: none;
+  gap: 8px;
+  padding: 12px;
+  display: flex;
+}
+
+.ov-viking-bot__interaction-header {
+  color: var(--ov-viking-bot-text-muted);
+  justify-content: space-between;
+  align-items: center;
+  gap: 8px;
+  font-size: 12px;
+  display: flex;
+}
+
+.ov-viking-bot__interaction-title {
+  color: var(--ov-viking-bot-text);
+  font-weight: 500;
+}
+
+.ov-viking-bot__interaction-progress {
+  font-variant-numeric: tabular-nums;
+}
+
+.ov-viking-bot__interaction-question {
+  margin: 0;
+  font-size: 13px;
+  line-height: 1.6;
+}
+
+.ov-viking-bot__interaction-error {
+  color: var(--ov-viking-bot-danger);
+  margin: 0;
+  font-size: 12px;
+}
+
+.ov-viking-bot__interaction-options {
+  flex-direction: column;
+  gap: 4px;
+  margin: 0;
+  padding: 0;
+  list-style: none;
+  display: flex;
+}
+
+.ov-viking-bot__interaction-option {
+  border-radius: var(--ov-viking-bot-radius);
+  cursor: pointer;
+  align-items: center;
+  gap: 6px;
+  padding: 4px 6px;
+  display: flex;
+}
+
+.ov-viking-bot__interaction-option:hover {
+  background: var(--ov-viking-bot-surface-hover);
+}
+
+.ov-viking-bot__interaction-option:focus-within {
+  outline: 2px solid var(--ov-viking-bot-focus);
+  outline-offset: 1px;
+}
+
+.ov-viking-bot__interaction {
+  --ov-viking-bot-radius: 6px;
+  --ov-viking-bot-text: var(--ov-ui-color-text-1, var(--ov-ui-text-1-default, #0b0b0f));
+  --ov-viking-bot-text-muted: var(--ov-ui-color-text-3, var(--ov-ui-text-3-default, #6e718c));
+  --ov-viking-bot-accent: var(--ov-ui-color-primary, var(--ov-ui-primary-default, #5252ff));
+  --ov-viking-bot-accent-hover: var(--ov-ui-color-primary-hover, var(--ov-ui-primary-hover-default, #7075ff));
+  --ov-viking-bot-on-accent: var(--ov-ui-color-bg-1, var(--ov-ui-bg-1-default, #fff));
+  --ov-viking-bot-border: var(--ov-ui-color-border-2, var(--ov-ui-border-2-default, #e1e4f2));
+  --ov-viking-bot-border-strong: var(--ov-ui-color-border-3, var(--ov-ui-border-3-default, #d7daea));
+  --ov-viking-bot-bg: var(--ov-ui-color-bg-1, var(--ov-ui-bg-1-default, #fff));
+  --ov-viking-bot-primary-light: var(--ov-ui-color-primary-light, var(--ov-ui-primary-light-default, #f5f7ff));
+  --ov-viking-bot-surface: var(--ov-ui-color-bg-4, var(--ov-ui-bg-4-default, #f6f7fa));
+  --ov-viking-bot-surface-hover: var(--ov-ui-color-bg-5, var(--ov-ui-bg-5-default, #f1f2f9));
+  --ov-viking-bot-focus: var(--ov-ui-color-focus, var(--ov-ui-focus-default, #5252ff));
+  --ov-viking-bot-danger: var(--ov-ui-color-status-error, var(--ov-ui-status-error-default, #c43838));
+}
+
+.ov-viking-bot__interaction-option input[type="radio"] {
+  box-sizing: border-box;
+  appearance: none;
+  border: 1px solid var(--ov-viking-bot-border-strong);
+  cursor: pointer;
+  background: none;
+  border-radius: 50%;
+  flex: none;
+  width: 14px;
+  height: 14px;
+  margin: 0;
+}
+
+.ov-viking-bot__interaction-option input[type="radio"]:checked {
+  border: 4px solid var(--ov-viking-bot-accent);
+  background: var(--ov-viking-bot-on-accent);
+}
+
+.ov-viking-bot__interaction-option input[type="radio"]:disabled {
+  cursor: not-allowed;
+  opacity: .5;
+}
+
+.ov-viking-bot__interaction-option small {
+  color: var(--ov-viking-bot-text-muted);
+  font-size: 11px;
+}
+
+.ov-viking-bot__interaction-option code {
+  background: var(--ov-viking-bot-surface);
+  border-radius: 4px;
+  padding: 0 4px;
+  font-size: 11px;
+}
+
+.ov-viking-bot__interaction-input {
+  box-sizing: border-box;
+  border: 1px solid var(--ov-viking-bot-border);
+  border-radius: var(--ov-viking-bot-radius);
+  width: 100%;
+  min-width: 0;
+  color: inherit;
+  font: inherit;
+  background: none;
+  padding: 6px 8px;
+}
+
+.ov-viking-bot__interaction-input:focus-visible {
+  outline: 2px solid var(--ov-viking-bot-focus);
+  outline-offset: -1px;
+}
+
+.ov-viking-bot__interaction-input:disabled {
+  background: var(--ov-viking-bot-surface);
+  color: var(--ov-viking-bot-text-muted);
+  cursor: not-allowed;
+}
+
+textarea.ov-viking-bot__interaction-input {
+  resize: vertical;
+  min-height: 72px;
+}
+
+.ov-viking-bot__interaction-hint {
+  color: var(--ov-viking-bot-text-muted);
+  font-size: 11px;
+}
+
+.ov-viking-bot__interaction-submit, .ov-viking-bot__interaction-cancel {
+  border: 1px solid var(--ov-viking-bot-border);
+  border-radius: var(--ov-viking-bot-radius);
+  color: var(--ov-viking-bot-text);
+  font: inherit;
+  cursor: pointer;
+  background: none;
+  align-self: flex-start;
+  padding: 4px 14px;
+  font-size: 12px;
+}
+
+.ov-viking-bot__interaction-submit {
+  border-color: var(--ov-viking-bot-accent);
+  background: var(--ov-viking-bot-accent);
+  color: var(--ov-viking-bot-on-accent);
+}
+
+.ov-viking-bot__interaction-submit:hover:not(:disabled) {
+  border-color: var(--ov-viking-bot-accent-hover);
+  background: var(--ov-viking-bot-accent-hover);
+}
+
+.ov-viking-bot__interaction-cancel:hover:not(:disabled) {
+  background: var(--ov-viking-bot-surface-hover);
+}
+
+.ov-viking-bot__interaction-submit:focus-visible, .ov-viking-bot__interaction-cancel:focus-visible {
+  outline: 2px solid var(--ov-viking-bot-focus);
+  outline-offset: 2px;
+}
+
+.ov-viking-bot__interaction-submit:disabled, .ov-viking-bot__interaction-cancel:disabled {
+  opacity: .5;
+  cursor: not-allowed;
+}
+

package/dist/components/viking-bot/interaction/types.d.ts

@@ -0,0 +1,188 @@
+import type { ReactNode } from 'react';
+/** 可选项。An option offered by a question. */
+export interface VikingBotInteractionOption {
+    /** 选项值。Option value. */
+    value: string;
+    /** 选项主文案。Primary label. */
+    label: ReactNode;
+    /** 选项下方的说明。Description shown under the label. */
+    description?: ReactNode;
+    /** 选项后附加的等宽片段，例如命令。Monospace snippet after the label. */
+    code?: string;
+}
+/** 定时值。A schedule value. */
+export type VikingBotScheduleValue = {
+    /** 不启用。Disabled. */
+    mode: 'none';
+} | {
+    /** 每天。Daily. */
+    mode: 'daily';
+    /** 时间，`HH:mm`。Time as `HH:mm`. */
+    time: string;
+} | {
+    /** 每周。Weekly. */
+    mode: 'weekly';
+    /** 时间，`HH:mm`。Time as `HH:mm`. */
+    time: string;
+    /** 星期，1 为周一。Weekday, 1 is Monday. */
+    weekday: 1 | 2 | 3 | 4 | 5 | 6 | 7;
+};
+/** 修复候选。A repair candidate. */
+export interface VikingBotRepairOption {
+    /** 候选标识。Candidate key. */
+    id: string;
+    /** 候选文案。Candidate label. */
+    label: string;
+    /** 来源说明。Source description. */
+    description?: string;
+}
+/** 自定义问题的渲染上下文。Render context for a custom question. */
+export interface VikingBotInteractionRenderContext {
+    /** 是否禁用提交。Whether submission is disabled. */
+    disabled?: boolean;
+    /** 是否正在提交。Whether a submission is in flight. */
+    submitting?: boolean;
+    /** 上报答案；由宿主转成它自己的协议。Reports an answer; the host adapts it. */
+    submit: (value: unknown) => void | Promise<void>;
+    /** 放弃本次交互。Abandons this interaction. */
+    cancel: () => void;
+}
+/**
+ * 一次待确认的交互。组件内置 `choice`、`text`、`schedule`、`repair` 四种表单；
+ * 需要树选择器、上传等宿主能力时用 `custom` 自行渲染。
+ * One pending interaction. The component ships `choice`, `text`, `schedule` and
+ * `repair`; use `custom` when the form needs host capabilities such as a tree
+ * picker or an upload.
+ */
+export type VikingBotInteractionRequest = {
+    /** 单选。Single choice. */
+    kind: 'choice';
+    /** 问题文案。Question copy. */
+    question?: ReactNode;
+    /** 选项。Options. */
+    options: readonly VikingBotInteractionOption[];
+    /** 是否提供「其他」输入项。Whether an inline "other" input is offered. */
+    allowCustomInput?: boolean | {
+        placeholder?: string;
+    };
+} | {
+    /** 文本输入。Free text. */
+    kind: 'text';
+    /** 问题文案。Question copy. */
+    question?: ReactNode;
+    /** 初始值。Initial value. */
+    initialValue?: string;
+    /** 补充说明。Extra description. */
+    description?: ReactNode;
+    /** 是否多行。Whether the input is multiline. */
+    multiline?: boolean;
+} | {
+    /** 定时。Schedule. */
+    kind: 'schedule';
+    /** 问题文案。Question copy. */
+    question?: ReactNode;
+    /** 时区。Time zone. */
+    timezone?: string;
+    /** 初始值。Initial value. */
+    initialValue: VikingBotScheduleValue;
+} | {
+    /** 从候选修复项中选择。Pick one repair candidate. */
+    kind: 'repair';
+    /** 问题文案。Question copy. */
+    question?: ReactNode;
+    /** 候选。Candidates. */
+    options: readonly VikingBotRepairOption[];
+    /** 初始选中的候选标识。Initially selected candidate key. */
+    initialValue?: string;
+} | {
+    /** 由宿主渲染。Rendered by the host. */
+    kind: 'custom';
+    /** 问题文案。Question copy. */
+    question?: ReactNode;
+    /** 渲染函数。Renderer. */
+    render: (context: VikingBotInteractionRenderContext) => ReactNode;
+};
+/** 交互答案。An interaction answer. */
+export type VikingBotInteractionAnswer = {
+    kind: 'choice';
+    value: string;
+} | {
+    kind: 'text';
+    value: string;
+} | {
+    kind: 'schedule';
+    value: VikingBotScheduleValue;
+} | {
+    kind: 'repair';
+    value: string;
+} | {
+    kind: 'custom';
+    value: unknown;
+};
+/**
+ * 交互区文案。组件内置英文默认值，宿主可按需覆盖。
+ * Copy of the interaction area. The component ships English defaults; a host
+ * overrides any field it needs.
+ */
+export interface VikingBotInteractionLabels {
+    /** 区域标题，缺省为「待确认」。Area title, "Needs your input" by default. */
+    title?: string;
+    /** 提交按钮。Submit button. */
+    submit?: string;
+    /** 取消按钮。Cancel button. */
+    cancel?: string;
+    /** 「其他」输入项文案。Label of the "other" input. */
+    other?: string;
+    /** 提交成功提示。Shown after a successful submission. */
+    submitted?: string;
+    /** 取消提示。Shown after cancelling. */
+    cancelled?: string;
+    /** 步骤进度，接收当前序号与总数。Step progress, given index and total. */
+    progress?: (index: number, total: number) => string;
+    /** 不启用定时的选项文案。Label of the "no schedule" option. */
+    scheduleNone?: string;
+    /** 每天的选项文案。Label of the daily option. */
+    scheduleDaily?: string;
+    /** 每周的选项文案。Label of the weekly option. */
+    scheduleWeekly?: string;
+    /** 时间输入的无障碍名称。Accessible name of the time input. */
+    scheduleTime?: string;
+    /** 星期选择的无障碍名称。Accessible name of the weekday select. */
+    scheduleWeekday?: string;
+    /** 星期名称，按周一至周日排列。Weekday names, Monday first. */
+    weekdays?: readonly string[];
+}
+/**
+ * 待确认交互区。宿主从自己的流里算出问题，这里只负责表单与状态；
+ * 答案通过 `onSubmit` 上报，宿主决定怎么发回去。
+ * The pending-interaction area. The host derives the question from its own
+ * stream; this renders the form and its state, and reports the answer.
+ */
+export interface VikingBotInteractionProps {
+    /** 当前问题。The current question. */
+    request: VikingBotInteractionRequest;
+    /**
+     * 问题的稳定身份；变化时重置表单状态。省略时按 `request.kind` 与序号判定。
+     * Stable identity of the question; changes reset the form state. Defaults to
+     * the request kind plus the step index.
+     */
+    requestKey?: string;
+    /** 附加到根元素的类名。Class name applied to the root element. */
+    className?: string;
+    /** 当前步骤序号，从 0 开始。Current step index, starting at 0. */
+    index?: number;
+    /** 步骤总数。Total number of steps. */
+    total?: number;
+    /** 是否禁用。Whether the form is disabled. */
+    disabled?: boolean;
+    /** 是否正在提交。Whether a submission is in flight. */
+    submitting?: boolean;
+    /** 提交失败的原因。Why the last submission failed. */
+    error?: ReactNode;
+    /** 上报答案。Reports an answer. */
+    onSubmit?: (answer: VikingBotInteractionAnswer) => void | Promise<void>;
+    /** 放弃本次交互。Abandons this interaction. */
+    onCancel?: () => void;
+    /** 可替换文案，缺省为英文。Replaceable copy; English by default. */
+    labels?: VikingBotInteractionLabels;
+}

package/dist/components/viking-bot/interaction/viking-bot-interaction.d.ts

@@ -0,0 +1,9 @@
+import type { VikingBotInteractionProps } from './types.js';
+/**
+ * 待确认交互区。表单由 Ark 的 AskHuman 渲染；需要树选择器、上传器等宿主
+ * 能力时，`custom` 直接交给宿主渲染。
+ *
+ * The pending-interaction area. Ark's AskHuman renders the form; when a question
+ * needs a tree picker or an uploader, `custom` hands rendering to the host.
+ */
+export declare function VikingBotInteractionView({ request, className, requestKey, index, total, disabled, submitting, error, onSubmit, onCancel, labels: overrides, }: VikingBotInteractionProps): import("react").JSX.Element;

package/dist/components/viking-bot/interaction.js

@@ -0,0 +1,2 @@
+export { DEFAULT_INTERACTION_LABELS } from "../../c7~0.js";
+export { VikingBotInteraction } from "../../w~0.js";

package/dist/components/viking-bot/labels.d.ts

@@ -0,0 +1,2 @@
+import type { VikingBotLabels } from './model.js';
+export declare const DEFAULT_LABELS: Required<VikingBotLabels>;

package/dist/components/viking-bot/lazy-composer.d.ts

@@ -0,0 +1,3 @@
+import type { VikingBotComposerProps, VikingBotComposerRef } from './types.js';
+/** 输入区。The composer. */
+export declare const VikingBotComposer: import("react").ForwardRefExoticComponent<VikingBotComposerProps & import("react").RefAttributes<VikingBotComposerRef>>;

package/dist/components/viking-bot/message-groups.d.ts

@@ -0,0 +1,12 @@
+import type { VikingBotMessage, VikingBotMessagePart } from './model.js';
+/** 把 `viking://` 地址从片段里抽出来，用于渲染可点击引用。 */
+export declare function collectUris(parts: readonly VikingBotMessagePart[]): string[];
+/** 把连续消息按轮次合并，便于渲染同一轮的助手步骤。 */
+export declare function groupMessages(messages: readonly VikingBotMessage[]): VikingBotMessage[];
+/** 取消息的纯文本，用于复制。Plain text of a message, used for copying. */
+export declare function messageText(message: VikingBotMessage): string;
+/** 同一执行块的片段归到一组，供折叠块使用。Groups parts of one activity block. */
+export declare function groupByActivity(parts: readonly VikingBotMessagePart[]): {
+    groupId?: string;
+    parts: VikingBotMessagePart[];
+}[];