@openviking/react 0.1.2 → 0.1.4

package/dist/modules/console/command-messages.d.ts

@@ -0,0 +1,19 @@
+import type { TuiRecord } from '../../components/tui/index.js';
+import type { Locale } from '../../shared/locale.js';
+import { resolveConsoleLocale } from './labels.js';
+export interface ConsoleMessage {
+    code: keyof ReturnType<typeof resolveConsoleLocale>['messages'];
+    value?: string;
+    usage?: string;
+}
+/** Internal metadata is formatted by the Hook and never exposed in its records. */
+export type ConsoleRecord = TuiRecord & {
+    localMessage?: ConsoleMessage;
+};
+export declare function formatConsoleMessage(message: ConsoleMessage, locale: Locale): string;
+export declare class ConsoleCommandError extends Error implements ConsoleMessage {
+    readonly code: ConsoleMessage['code'];
+    readonly value?: string | undefined;
+    readonly usage?: string | undefined;
+    constructor(code: ConsoleMessage['code'], value?: string | undefined, usage?: string | undefined, locale?: Locale);
+}

package/dist/modules/console/command-parser.d.ts

@@ -0,0 +1,15 @@
+interface CommandToken {
+    value: string;
+    literal: boolean;
+}
+/** Parses arguments as data; never invokes a shell. */
+export declare function tokenize(input: string): CommandToken[];
+export interface Argument {
+    name: string;
+    kind?: 'uri' | 'integer' | 'boolean';
+    optional?: boolean;
+    choices?: readonly string[];
+    min?: number;
+}
+export declare function parseArguments(tokens: readonly CommandToken[], positional: readonly Argument[], flags?: readonly Argument[]): Record<string, string | number | boolean>;
+export {};

package/dist/modules/console/command-specs.d.ts

@@ -0,0 +1,15 @@
+import type enUS from './locales/en-US.js';
+import type { OvRequestSpec } from '../../client/types.js';
+import type { TuiSkeletonKind } from '../../components/tui/index.js';
+import type { Argument } from './command-parser.js';
+type Values = Record<string, string | number | boolean>;
+export interface CommandSpec {
+    name: keyof typeof enUS.commands;
+    positional?: readonly Argument[];
+    flags?: readonly Argument[];
+    skeleton?: TuiSkeletonKind;
+    request?: (values: Values) => OvRequestSpec;
+}
+/** One catalogue drives validation, execution, completion and help. */
+export declare const COMMAND_SPECS: readonly CommandSpec[];
+export {};

package/dist/modules/console/commands.d.ts

@@ -0,0 +1,6 @@
+import type { OvClient, OvRequestOptions } from '../../client/types.js';
+import type { TuiCommandDefinition, TuiRecordContent } from '../../components/tui/index.js';
+import type { Locale } from '../../shared/locale.js';
+export declare function consoleCommands(locale: Locale): readonly TuiCommandDefinition[];
+export declare function createCommandHelp(locale: Locale): TuiRecordContent;
+export declare function executeCommand(input: string, client: OvClient, options: OvRequestOptions, locale: Locale): Promise<TuiRecordContent>;

package/dist/modules/console/console-history.d.ts

@@ -0,0 +1,10 @@
+import type { Locale } from '../../shared/locale.js';
+import type { TuiRecord } from '../../components/tui/index.js';
+import type { consoleLabels } from './labels.js';
+export declare function ConsoleHistory({ records, isExecuting, locale, labels, onRecall, }: {
+    records: readonly TuiRecord[];
+    isExecuting: boolean;
+    locale: Locale;
+    labels: ReturnType<typeof consoleLabels>;
+    onRecall: (command: string) => void;
+}): import("react").JSX.Element;

package/dist/modules/console/console-toolbar.d.ts

@@ -0,0 +1,18 @@
+import type { Locale } from '../../shared/locale.js';
+import type { ReactNode } from 'react';
+import type { TuiRecord } from '../../components/tui/index.js';
+import type { ConsoleMode } from './types.js';
+import type { consoleLabels } from './labels.js';
+export declare function ConsoleToolbar({ mode, panelId, locale, labels, records, isExecuting, onModeChange, onClear, onRecall, children, conversationActions, }: {
+    mode: ConsoleMode;
+    panelId: string;
+    locale: Locale;
+    labels: ReturnType<typeof consoleLabels>;
+    records: readonly TuiRecord[];
+    isExecuting: boolean;
+    onModeChange: (mode: ConsoleMode) => void;
+    onClear: () => void;
+    onRecall: (command: string) => void;
+    children?: ReactNode;
+    conversationActions?: ReactNode;
+}): import("react").JSX.Element;

package/dist/modules/console/console.d.ts

@@ -1,4 +1,2 @@
 import type { ConsoleProps } from './types.js';
-export type { ConsoleLabels, ConsoleMode, ConsoleProps, ConsoleSlots, } from './types.js';
-/** 占位组件：渲染一个带模块名的空容器，真实实现随模块 Hook 与组合视图迁入。 */
-export declare function Console({ className, style, labels }: ConsoleProps): import("react").JSX.Element;
+export declare function Console({ mode, defaultMode, locale, quickCommands, scopeKey, requestOptions, onModeChange, onOpenUri, conversation, slots, labels: overrides, className, ...rest }: ConsoleProps): import("react").JSX.Element;

package/dist/modules/console/controller.d.ts

@@ -0,0 +1,17 @@
+import type { Locale } from '../../shared/locale.js';
+import { type ConsoleRecord } from './command-messages.js';
+import type { OvClient, OvRequestOptions } from '../../client/types.js';
+import type { ConsoleState } from './types.js';
+export declare function createConsoleController(client: OvClient, options?: OvRequestOptions): {
+    subscribe: (listener: () => void) => () => void;
+    getSnapshot: () => Omit<ConsoleState, "records"> & {
+        records: readonly ConsoleRecord[];
+    };
+    start(): () => void;
+    execute: (input?: string, locale?: Locale) => Promise<void>;
+    cancel: () => void | undefined;
+    clear: () => void;
+    setCommand: (command: string) => void;
+    setConversationDraft: (conversationDraft: string) => void;
+    retry: (locale: Locale) => Promise<void>;
+};

package/dist/modules/console/index.d.ts

@@ -1 +1,3 @@
 export * from './console.js';
+export { useConsole } from './use-console.js';
+export type { ConsoleLabels, ConsoleMode, ConsoleOptions, ConsoleResult, ConsoleState, ConsoleProps, ConsoleSlots, } from './types.js';

package/dist/modules/console/labels.d.ts

@@ -0,0 +1,61 @@
+import { type Locale } from '../../shared/locale.js';
+import type { ConsoleLabels } from './types.js';
+export declare function resolveConsoleLocale(locale: Locale): {
+    labels: {
+        conversation: string;
+        command: string;
+        mode: string;
+        description: string;
+        clear: string;
+        history: string;
+        emptyHistory: string;
+    };
+    commands: {
+        grep: string;
+        glob: string;
+        help: string;
+        clear: string;
+        health: string;
+        status: string;
+        ls: string;
+        tree: string;
+        stat: string;
+        read: string;
+        abstract: string;
+        overview: string;
+        find: string;
+        search: string;
+        mkdir: string;
+        cp: string;
+        mv: string;
+        rm: string;
+        write: string;
+        'task list': string;
+        'task status': string;
+        'task cancel': string;
+    };
+    availableCommands: string;
+    messages: {
+        cancelled: () => string;
+        unknownCommand: () => string;
+        shellSyntax: () => string;
+        unclosedQuote: () => string;
+        unexpectedArgument: (value: string) => string;
+        duplicateArgument: (value: string) => string;
+        missingValue: (value: string) => string;
+        expectedUri: (value: string) => string;
+        invalidArgument: (value: string) => string;
+        missingArgument: (value: string) => string;
+    };
+};
+export declare function consoleLabels(locale: Locale, overrides?: ConsoleLabels): {
+    conversation: string;
+    command: string;
+    mode: string;
+    description: string;
+    clear: string;
+    history: string;
+    emptyHistory: string;
+    tui: import("../../components/tui/types.js").TuiLabels;
+    vikingBot: import("../../components/viking-bot/model.js").VikingBotLabels;
+};

package/dist/modules/console/locales/en-US.d.ts

@@ -0,0 +1,49 @@
+declare const messages: {
+    labels: {
+        conversation: string;
+        command: string;
+        mode: string;
+        description: string;
+        clear: string;
+        history: string;
+        emptyHistory: string;
+    };
+    commands: {
+        grep: string;
+        glob: string;
+        help: string;
+        clear: string;
+        health: string;
+        status: string;
+        ls: string;
+        tree: string;
+        stat: string;
+        read: string;
+        abstract: string;
+        overview: string;
+        find: string;
+        search: string;
+        mkdir: string;
+        cp: string;
+        mv: string;
+        rm: string;
+        write: string;
+        'task list': string;
+        'task status': string;
+        'task cancel': string;
+    };
+    availableCommands: string;
+    messages: {
+        cancelled: () => string;
+        unknownCommand: () => string;
+        shellSyntax: () => string;
+        unclosedQuote: () => string;
+        unexpectedArgument: (value: string) => string;
+        duplicateArgument: (value: string) => string;
+        missingValue: (value: string) => string;
+        expectedUri: (value: string) => string;
+        invalidArgument: (value: string) => string;
+        missingArgument: (value: string) => string;
+    };
+};
+export default messages;

package/dist/modules/console/locales/zh-CN.d.ts

@@ -0,0 +1,3 @@
+import type enUS from './en-US.js';
+declare const messages: typeof enUS;
+export default messages;

package/dist/modules/console/localize-records.d.ts

@@ -0,0 +1,11 @@
+import type { Locale } from '../../shared/locale.js';
+import { type ConsoleRecord } from './command-messages.js';
+/** Format library notices without changing server output or execution state. */
+export declare function localizeConsoleRecords(records: readonly ConsoleRecord[], locale: Locale): {
+    id: string;
+    command: string;
+    status: import("../../components/tui/types.js").TuiRecordStatus;
+    content?: import("../../components/tui/types.js").TuiRecordContent;
+    createdAt?: string;
+    createdAtMs?: number;
+}[];

package/dist/modules/console/results.d.ts

@@ -0,0 +1,2 @@
+import type { TuiRecordContent } from '../../components/tui/index.js';
+export declare function formatResult(name: string, data: unknown, values: Record<string, string | number | boolean>): TuiRecordContent;