@openviking/react 0.1.1 → 0.1.3

package/dist/modules/task-center/columns.d.ts

@@ -1,129 +0,0 @@
-import type { ReactNode } from 'react';
-/**
- * 编译目标的定时规则，与原生接口的 `update_schedule` 同形：每日或每周的固定
- * 时刻（北京时间）。
- * The schedule rule of a compile target, matching the native
- * `update_schedule`: a daily or weekly clock time in Beijing time.
- */
-export type TaskCenterCompileSchedule = {
-    frequency: 'daily';
-    hour: number;
-    minute: number;
-} | {
-    frequency: 'weekly';
-    /** 1 为周一，7 为周日。1 is Monday, 7 is Sunday. */
-    weekday: number;
-    hour: number;
-    minute: number;
-};
-/**
- * 数据源导入任务的一行，来自 `/api/v1/watches`。
- * One data-source import task, from `/api/v1/watches`.
- */
-export interface TaskCenterImportRow {
-    /** 行唯一标识，对应 watch 的 task id。Unique row key, the watch task id. */
-    id: string;
-    /** 资源名称。Resource name. */
-    name: string;
-    /** 数据来源类型，例如飞书文档、代码仓库。Source type, for example a Feishu doc or a Git repository. */
-    sourceLabel: string;
-    /** 原始地址，例如 Git 仓库链接。Original address, for example the Git URL. */
-    sourceUrl?: string;
-    /** 导入后的 OpenViking 路径。The OpenViking path after import. */
-    openVikingPath: string;
-    /** 定时同步状态文案，例如「每 1 天」「未开启」。Schedule status copy, for example "every day" or "off". */
-    scheduleLabel: string;
-    /** 定时同步是否开启。Whether scheduled sync is on. */
-    scheduleEnabled: boolean;
-    /**
-     * 当前的同步间隔，单位分钟。未开启时省略。对应原生 watch 的
-     * `watch_interval`。
-     *
-     * The current sync interval in minutes, omitted when scheduling is off. It
-     * matches the native watch's `watch_interval`.
-     */
-    scheduleIntervalMinutes?: number;
-    /** 最近一次执行时间，毫秒时间戳。Last execution time in milliseconds. */
-    lastExecutionTime?: number;
-    /** 任务创建时间，毫秒时间戳。Creation time in milliseconds. */
-    createdAt?: number;
-}
-/**
- * 知识编译任务的一行，来自编译目标列表。
- * One knowledge-compile task, from the compile target list.
- */
-export interface TaskCenterCompileRow {
-    /** 行唯一标识，对应编译目标 URI。Unique row key, the compile target URI. */
-    id: string;
-    /** 目录名称。Directory name. */
-    name: string;
-    /** 编译目标的完整 URI。Full URI of the compile target. */
-    toUri: string;
-    /** 状态文案，例如「执行中」「空闲」「未初始化」。Status copy, for example "running", "idle" or "not initialized". */
-    statusLabel: string;
-    /** 冲突文件数。Number of conflicting files. */
-    conflictFileCount: number;
-    /** 任务类型，例如首次编译或定时编译。Task type, for example initial or scheduled compile. */
-    taskType: string;
-    /** 定时更新状态文案，例如「每日 09:30（北京时间）」「未开启」。Schedule copy. */
-    scheduleLabel: string;
-    /** 定时更新是否开启。Whether scheduled updates are on. */
-    scheduleEnabled: boolean;
-    /**
-     * 当前的定时规则。未开启时省略。与原生编译目标的 `update_schedule` 同形，
-     * 宿主改完直接回传即可。
-     *
-     * The current schedule rule, omitted when scheduling is off. It matches the
-     * native compile target's `update_schedule`, so a host can pass it straight
-     * back after an edit.
-     */
-    schedule?: TaskCenterCompileSchedule;
-    /** 内容最近更新时间，毫秒时间戳。Last content update in milliseconds. */
-    updatedAt?: number;
-    /** 任务创建时间，毫秒时间戳。Creation time in milliseconds. */
-    createdAt?: number;
-}
-/** 数据源导入任务的内置列。Built-in columns of the import task list. */
-export type TaskCenterImportColumnKey = 'name' | 'schedule' | 'source' | 'lastExecution' | 'createdAt' | 'path';
-/** 知识编译任务的内置列。Built-in columns of the compile task list. */
-export type TaskCenterCompileColumnKey = 'name' | 'status' | 'conflicts' | 'taskType' | 'schedule' | 'updatedAt' | 'createdAt' | 'path';
-/**
- * 一列的配置。省略 `columns` 时使用该列表的全部内置列与默认顺序。
- *
- * A column configuration. Omitting `columns` uses every built-in column of that
- * list in its default order.
- */
-export interface TaskCenterColumn<TRow> {
-    /**
-     * 列标识。内置列用该列表的列 key，自定义列用任意字符串。
-     * Column key. A built-in column uses a key of that list; a custom column uses
-     * any string.
-     */
-    key: string;
-    /**
-     * 覆盖表头文案。省略时使用内置文案或 `labels`。
-     * Header override. Omission uses the built-in copy or `labels`.
-     */
-    title?: ReactNode;
-    /** 列宽，单位像素。Column width in pixels. */
-    width?: number;
-    /** 单元格对齐方式。Cell alignment. */
-    align?: 'left' | 'center' | 'right';
-    /**
-     * 覆盖单元格内容。内置列省略时使用默认渲染；自定义列必须提供。
-     * Cell content override. A built-in column falls back to its default
-     * rendering; a custom column must provide it.
-     */
-    render?: (row: TRow) => ReactNode;
-}
-/**
- * 各页签的列配置。只传需要调整的页签，另一个页签保持默认。
- * Column configuration per tab. Pass only the tab you adjust; the other keeps
- * its default.
- */
-export interface TaskCenterColumns {
-    import?: readonly TaskCenterColumn<TaskCenterImportRow>[];
-    compile?: readonly TaskCenterColumn<TaskCenterCompileRow>[];
-}
-/** 任意一行的联合类型，供打开任务等回调使用。 */
-export type TaskCenterRow = TaskCenterImportRow | TaskCenterCompileRow;

package/dist/modules/task-center/index.d.ts

@@ -1 +0,0 @@
-export * from './task-center.js';

package/dist/modules/task-center/style.css

@@ -1,29 +0,0 @@
-.ov-module-placeholder {
-  box-sizing: border-box;
-  border: 1px dashed var(--ov-ui-border, currentColor);
-  border-radius: var(--ov-ui-radius, 6px);
-  min-width: 0;
-  min-height: 160px;
-  color: inherit;
-  font: inherit;
-  text-align: center;
-  overflow-wrap: anywhere;
-  flex-direction: column;
-  justify-content: center;
-  align-items: center;
-  gap: 8px;
-  padding: 24px;
-  display: flex;
-}
-
-.ov-module-placeholder__title {
-  margin: 0;
-}
-
-.ov-module-placeholder__description {
-  color: var(--ov-ui-text-muted, color-mix(in srgb, currentColor 75%, transparent));
-  margin: 0;
-}
-
-
-

package/dist/modules/task-center/task-center.d.ts

@@ -1,4 +0,0 @@
-import type { TaskCenterProps } from './types.js';
-export type { TaskCenterColumn, TaskCenterColumns, TaskCenterCompileColumnKey, TaskCenterCompileRow, TaskCenterCompileSchedule, TaskCenterImportColumnKey, TaskCenterImportRow, TaskCenterLabels, TaskCenterProps, TaskCenterRow, TaskCenterScope, TaskCenterSlots, TaskCenterTab, } from './types.js';
-/** 占位组件：渲染一个带模块名的空容器，真实实现随模块 Hook 与组合视图迁入。 */
-export declare function TaskCenter({ className, style, labels }: TaskCenterProps): import("react").JSX.Element;

package/dist/modules/task-center/types.d.ts

@@ -1,168 +0,0 @@
-import type { OvRequestOptions } from '../../client/index.js';
-import type { HTMLAttributes, ReactNode } from 'react';
-import type { TaskCenterColumns, TaskCenterCompileRow, TaskCenterCompileSchedule, TaskCenterImportRow } from './columns.js';
-/**
- * 任务管理的页签。数据源导入对应定时同步的 watch，知识编译对应编译目标。
- * Tabs of the task center. Data-source import covers scheduled watches; knowledge
- * compile covers compile targets.
- */
-export type TaskCenterTab = 'import' | 'compile';
-/**
- * 页签的可见范围。「其他成员」只在能查看账号下全部任务时出现，由模块从当前
- * 身份判断，不需要宿主传开关。
- *
- * Visibility scope of a tab. "Others" appears only when the current identity can
- * see every task in the account; the module decides that from the current
- * identity, so the host passes no switch.
- */
-export type TaskCenterScope = 'mine' | 'others';
-/** 任务中心模块的插槽。Slots of the task center module. */
-export interface TaskCenterSlots {
-    /**
-     * 列表上方的工具栏，例如新建任务、搜索。筛选在表头由模块提供。
-     * Toolbar above the list, for example a create action or search. The module
-     * provides filtering in the table header.
-     */
-    toolbar?: ReactNode;
-    /**
-     * 空态内容，例如引导导入资源的入口。
-     * Empty state, for example an entry that starts importing resources.
-     */
-    emptyState?: ReactNode;
-}
-/** 任务中心模块的可替换文案。Replaceable copy of the task center module. */
-export interface TaskCenterLabels {
-    /**
-     * 占位说明。缺省为 `Placeholder. Functionality is not available yet.`。
-     * Placeholder description. Defaults to "Placeholder. Functionality is not
-     * available yet.".
-     */
-    description?: string;
-    /** 区域标题。Area title. */
-    title?: string;
-    /** 数据源导入页签名称。Label of the import tab. */
-    importTab?: string;
-    /** 知识编译页签名称。Label of the compile tab. */
-    compileTab?: string;
-    /** 「我的任务」范围名称。Label of the "my tasks" scope. */
-    mineScope?: string;
-    /** 「其他成员任务」范围名称。Label of the "others' tasks" scope. */
-    othersScope?: string;
-    /** 没有任务时的提示。Message shown when there are no tasks. */
-    empty?: string;
-    /** 加载失败提示。Load failure message. */
-    error?: string;
-    /** 重试按钮文案。Retry button label. */
-    retry?: string;
-    /** 定时同步列的表头。Header of the scheduled-sync column. */
-    scheduleColumn?: string;
-    /** 定时同步开启状态文案。Copy for an enabled schedule. */
-    scheduleEnabled?: string;
-    /** 定时同步关闭状态文案。Copy for a disabled schedule. */
-    scheduleDisabled?: string;
-    /** 编辑定时周期的按钮文案。Label of the control that edits a schedule. */
-    editSchedule?: string;
-    /** 定时保存失败时的提示。Message shown when saving a schedule fails. */
-    saveFailed?: string;
-}
-/**
- * 任务中心模块的属性。
- *
- * 模块自己通过 Hook 取数，props 里没有任务数据：宿主给配置、受控状态、回调、
- * 列配置、插槽与文案。两个页签各有自己的数据源与列，页签内筛选由模块维护。
- *
- * 能查看「其他成员任务」取决于当前身份，模块自行判断，宿主不需要传权限开关。
- *
- * Props of the task center module.
- *
- * The module loads its own data through a Hook, so no prop carries tasks: the
- * host supplies configuration, controlled state, callbacks, column
- * configuration, slots and copy. Each tab has its own data source and columns,
- * and the module maintains filtering inside a tab.
- *
- * Whether "others' tasks" is available depends on the current identity; the
- * module decides that itself, so the host passes no permission switch.
- */
-export interface TaskCenterProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onSelect' | 'children'> {
-    /**
-     * 受控的当前页签。传入时由宿主决定页签，模块只上报切换意图。
-     * The controlled tab. When given, the host owns the tab and the module only
-     * reports switch intent.
-     */
-    tab?: TaskCenterTab;
-    /**
-     * 非受控时的初始页签，缺省为 `import`。
-     * Initial tab when uncontrolled; defaults to `import`.
-     */
-    defaultTab?: TaskCenterTab;
-    /**
-     * 受控的页签可见范围。传入时由宿主决定范围，模块只上报切换意图。
-     * The controlled scope. When given, the host owns it and the module only
-     * reports switch intent.
-     */
-    scope?: TaskCenterScope;
-    /**
-     * 非受控时的初始范围，缺省为 `mine`。
-     * Initial scope when uncontrolled; defaults to `mine`.
-     */
-    defaultScope?: TaskCenterScope;
-    /**
-     * 列配置。省略时两个页签都用各自的内置列与默认顺序。
-     * Column configuration. Omission uses each tab's built-in columns in their
-     * default order.
-     */
-    columns?: TaskCenterColumns;
-    /**
-     * 页签变化后触发。
-     * Called after the tab changes.
-     */
-    onTabChange?: (tab: TaskCenterTab) => void;
-    /**
-     * 可见范围变化后触发。
-     * Called after the scope changes.
-     */
-    onScopeChange?: (scope: TaskCenterScope) => void;
-    /**
-     * 打开资源时触发，例如点击导入任务的目标路径。任务详情由模块内部以抽屉展示，
-     * 不需要宿主参与。
-     * Called when a resource is opened, for example the target path of an import
-     * task. Task details are shown by the module in a drawer, so the host takes no
-     * part in that.
-     */
-    onOpenResource?: (uri: string) => void;
-    /**
-     * 导入任务的同步间隔保存。返回的 Promise 成功即视为已写入，模块随后重新取数；
-     * 失败时保留编辑内容并展示错误，错误文案取 `labels.saveFailed`。
-     *
-     * Saving the sync interval of an import task. A resolved Promise means the
-     * write succeeded and the module reloads; a rejection keeps the edit and shows
-     * the error from `labels.saveFailed`.
-     */
-    onSaveScheduleInterval?: (row: TaskCenterImportRow, intervalMinutes: number) => Promise<void>;
-    /**
-     * 编译目标的定时规则保存。参数与原生 `update_schedule` 同形，宿主可直接转发。
-     * 成功与失败的处理同 {@link onSaveScheduleInterval}。
-     *
-     * Saving the schedule of a compile target. The argument matches the native
-     * `update_schedule`, so a host can forward it as-is. Success and failure are
-     * handled the same way as {@link onSaveScheduleInterval}.
-     */
-    onSaveCompileSchedule?: (row: TaskCenterCompileRow, schedule: TaskCenterCompileSchedule | null) => Promise<void>;
-    /**
-     * 插槽，见 {@link TaskCenterSlots}。
-     * Slots, see {@link TaskCenterSlots}.
-     */
-    slots?: TaskCenterSlots;
-    /**
-     * 可替换文案，缺省为英文。
-     * Replaceable copy; English by default.
-     */
-    labels?: TaskCenterLabels;
-    /**
-     * 请求配置覆盖，逐字段覆盖最近的 Provider。
-     * Request configuration override, applied field by field over the nearest
-     * Provider.
-     */
-    requestOptions?: OvRequestOptions;
-}
-export type { TaskCenterColumn, TaskCenterColumns, TaskCenterCompileColumnKey, TaskCenterCompileRow, TaskCenterCompileSchedule, TaskCenterImportColumnKey, TaskCenterImportRow, TaskCenterRow, } from './columns.js';

package/dist/modules/task-center.js

@@ -1 +0,0 @@
-export { TaskCenter } from "../i~0.js";