@openviking/react 0.1.3 → 0.1.5

package/dist/components/directory-tour/style.css

@@ -0,0 +1,237 @@
+.ov-directory-tour, .ov-agent-connect, .ov-console, .ov-divider, .ov-file-browser-entries, .ov-drawer, .ov-file-browser, .ov-file-preview, .ov-file-tree, .ov-module-placeholder, .ov-popover, .ov-scope-switcher, .ov-tooltip, .ov-tui, .ov-viking-bot, .ov-viking-bot__popover, .ov-viking-bot__reference-picker--mention, .ov-viking-bot__interaction {
+  --ov-ui-tour-shadow-default: 0 15px 35px #0000000d, 0 5px 15px #0000000d;
+  --ov-ui-tour-highlight-default: #5252ff14;
+  --ov-ui-primary-default: #5252ff;
+  --ov-ui-primary-hover-default: #7075ff;
+  --ov-ui-primary-active-default: #3833d2;
+  --ov-ui-primary-disabled-default: #acb4ff;
+  --ov-ui-text-on-primary-default: #fff;
+  --ov-ui-primary-light-default: #f5f7ff;
+  --ov-ui-connect-glow-warm-default: #ff952b0a;
+  --ov-ui-connect-glow-pink-default: #fb4fbc0f;
+  --ov-ui-connect-glow-pink-soft-default: #fb4fbc0a;
+  --ov-ui-on-primary-default: #fff;
+  --ov-ui-text-1-default: #0b0b0f;
+  --ov-ui-text-2-default: #3f3f51;
+  --ov-ui-text-3-default: #6e718c;
+  --ov-ui-text-description-default: #0006;
+  --ov-ui-text-disabled-default: #a5a7bb;
+  --ov-ui-border-1-default: #f0f2fa;
+  --ov-ui-border-2-default: #e1e4f2;
+  --ov-ui-border-3-default: #d7daea;
+  --ov-ui-bg-1-default: #fff;
+  --ov-ui-bg-3-default: #f7f8fd;
+  --ov-ui-bg-4-default: #f6f7fa;
+  --ov-ui-bg-5-default: #f1f2f9;
+  --ov-ui-code-bg-default: #fbfbfc;
+  --ov-ui-status-success-default: #1f9d55;
+  --ov-ui-shadow-default: #0f172a;
+  --ov-ui-shadow-control-default: #0000000d;
+  --ov-ui-focus-default: #5252ff;
+  --ov-ui-fill-hover-default: #f1f2f9;
+  --ov-ui-status-error-default: #c43838;
+  --ov-ui-warning-default: #b26a00;
+  --ov-ui-warning-light-default: #fff0b3;
+  --ov-ui-overlay-default: #0006;
+  --ov-ui-tooltip-bg-default: #1f2329;
+  --ov-ui-tooltip-text-default: #fff;
+}
+
+.dark .ov-directory-tour, .dark .ov-agent-connect, .dark .ov-console, .dark .ov-divider, .dark .ov-file-browser-entries, .dark .ov-drawer, .dark .ov-file-browser, .dark .ov-file-preview, .dark .ov-file-tree, .dark .ov-module-placeholder, .dark .ov-popover, .dark .ov-scope-switcher, .dark .ov-tooltip, .dark .ov-tui, .dark .ov-viking-bot, .dark .ov-viking-bot__popover, .dark .ov-viking-bot__reference-picker--mention, .dark .ov-viking-bot__interaction {
+  --ov-ui-primary-default: #5f5fff;
+  --ov-ui-primary-hover-default: #7075ff;
+  --ov-ui-primary-active-default: #4242ba;
+  --ov-ui-primary-light-default: #1a1632;
+  --ov-ui-connect-glow-warm-default: #ff952b05;
+  --ov-ui-connect-glow-pink-default: #fb4fbc08;
+  --ov-ui-connect-glow-pink-soft-default: #fb4fbc05;
+  --ov-ui-text-1-default: #c7ccd6;
+  --ov-ui-text-2-default: #9da3af;
+  --ov-ui-text-3-default: #737a87;
+  --ov-ui-text-description-default: #fff6;
+  --ov-ui-text-disabled-default: #42464e;
+  --ov-ui-border-1-default: #23252a;
+  --ov-ui-border-2-default: #2e3138;
+  --ov-ui-border-3-default: #3a3d45;
+  --ov-ui-bg-1-default: #131416;
+  --ov-ui-bg-3-default: #1b1d21;
+  --ov-ui-bg-4-default: #202227;
+  --ov-ui-bg-5-default: #23252a;
+  --ov-ui-focus-default: #5f5fff;
+  --ov-ui-fill-hover-default: #23252a;
+  --ov-ui-status-error-default: #ff9595;
+  --ov-ui-warning-default: #e0a04a;
+  --ov-ui-warning-light-default: #3a2f14;
+  --ov-ui-tooltip-bg-default: #2a2d33;
+  --ov-ui-overlay-default: #000000a3;
+  --ov-ui-tooltip-text-default: #f0f1f3;
+}
+
+.dark .ov-viking-bot {
+  --ov-ui-code-bg-default: var(--ov-ui-bg-3-default);
+}
+
+.ov-agent-connect {
+  --ov-ui-connect-card-default: #fbfbfc;
+  --ov-ui-connect-tabs-default: #f7f7f9;
+  --ov-ui-connect-selected-default: #f3f4f7;
+  --ov-ui-connect-border-default: #edeef2;
+  --ov-ui-connect-outline-default: #e1e3ea;
+  --ov-ui-connect-muted-default: #787c91;
+  --ov-ui-connect-notice-default: #2e2984;
+}
+
+.dark .ov-agent-connect {
+  --ov-ui-connect-card-default: var(--ov-ui-bg-3-default);
+  --ov-ui-connect-tabs-default: var(--ov-ui-bg-3-default);
+  --ov-ui-connect-selected-default: var(--ov-ui-bg-4-default);
+  --ov-ui-connect-border-default: var(--ov-ui-border-1-default);
+  --ov-ui-connect-outline-default: var(--ov-ui-border-2-default);
+  --ov-ui-connect-muted-default: var(--ov-ui-text-3-default);
+  --ov-ui-connect-notice-default: var(--ov-ui-text-2-default);
+}
+
+.ov-directory-tour {
+  --ov-ui-directory-tour-primary: var(--ov-ui-color-primary, var(--ov-ui-primary-default));
+  --ov-ui-directory-tour-background: var(--ov-ui-color-bg-1, var(--ov-ui-bg-1-default));
+  --ov-ui-directory-tour-text: var(--ov-ui-color-text-1, var(--ov-ui-text-1-default));
+  --ov-ui-directory-tour-secondary: var(--ov-ui-color-text-2, var(--ov-ui-text-2-default));
+  --ov-ui-directory-tour-muted: var(--ov-ui-color-text-3, var(--ov-ui-text-3-default));
+  --ov-ui-directory-tour-border: var(--ov-ui-color-border-3, var(--ov-ui-border-3-default));
+  width: 270px;
+  max-width: calc(100vw - 16px);
+  max-height: calc(100dvh - 16px);
+  color: var(--ov-ui-directory-tour-text);
+  box-sizing: border-box;
+  background: none;
+  border: 0;
+  margin: 0;
+  padding: 0;
+  font-family: inherit;
+  position: fixed;
+  inset: auto;
+  overflow: visible;
+}
+
+.ov-directory-tour *, .ov-directory-tour :before, .ov-directory-tour :after {
+  box-sizing: border-box;
+}
+
+.ov-directory-tour__card {
+  border: .5px solid var(--ov-ui-directory-tour-border);
+  background: var(--ov-ui-directory-tour-background);
+  box-shadow: var(--ov-ui-color-tour-shadow, var(--ov-ui-tour-shadow-default));
+  border-radius: 8px;
+  flex-direction: column;
+  gap: 12px;
+  max-height: calc(100dvh - 16px);
+  padding: 16px;
+  display: flex;
+  position: relative;
+  overflow: auto;
+}
+
+.ov-directory-tour__title {
+  overflow-wrap: anywhere;
+  margin: 0;
+  padding-right: 16px;
+  font-size: 14px;
+  font-weight: 500;
+  line-height: 22px;
+}
+
+.ov-directory-tour__description {
+  color: var(--ov-ui-directory-tour-secondary);
+  overflow-wrap: anywhere;
+  margin-top: -8px;
+  font-size: 12px;
+  line-height: 20px;
+}
+
+.ov-directory-tour__illustration {
+  background: var(--ov-ui-color-bg-3, var(--ov-ui-bg-3-default));
+  border-radius: 8px;
+  flex-shrink: 0;
+  justify-content: center;
+  align-items: center;
+  height: 72px;
+  display: flex;
+  overflow: hidden;
+}
+
+.ov-directory-tour__illustration img {
+  object-fit: contain;
+  max-width: 100%;
+  max-height: 100%;
+}
+
+.ov-directory-tour__actions {
+  align-items: center;
+  gap: 8px;
+  display: flex;
+}
+
+.ov-directory-tour__progress {
+  color: var(--ov-ui-directory-tour-muted);
+  flex: 1;
+  font-size: 12px;
+  line-height: 20px;
+}
+
+.ov-directory-tour button {
+  cursor: pointer;
+  font: inherit;
+  border: 1px solid var(--ov-ui-directory-tour-border);
+  background: var(--ov-ui-directory-tour-background);
+  color: var(--ov-ui-directory-tour-text);
+  border-radius: 6px;
+  padding: 3px 10px;
+  font-size: 13px;
+  line-height: 22px;
+}
+
+.ov-directory-tour button:hover {
+  background: var(--ov-ui-color-bg-3, var(--ov-ui-bg-3-default));
+}
+
+.ov-directory-tour button:focus-visible {
+  outline: 2px solid var(--ov-ui-directory-tour-primary);
+  outline-offset: 2px;
+}
+
+.ov-directory-tour button:disabled {
+  cursor: wait;
+  opacity: .5;
+}
+
+.ov-directory-tour .ov-directory-tour__primary {
+  background: var(--ov-ui-directory-tour-primary);
+  color: var(--ov-ui-color-on-primary, var(--ov-ui-auth-on-primary-default));
+  border: 0;
+}
+
+.ov-directory-tour .ov-directory-tour__primary:hover {
+  background: var(--ov-ui-color-primary-hover, var(--ov-ui-primary-hover-default));
+}
+
+.ov-directory-tour .ov-directory-tour__close {
+  color: var(--ov-ui-directory-tour-muted);
+  background: none;
+  border: 0;
+  padding: 2px 6px;
+  font-size: 18px;
+  position: absolute;
+  top: 2px;
+  right: 4px;
+}
+
+.ov-directory-tour__highlight {
+  pointer-events: none;
+  border: 1px solid var(--ov-ui-directory-tour-primary);
+  background: var(--ov-ui-color-tour-highlight, var(--ov-ui-tour-highlight-default));
+  border-radius: 4px;
+  position: fixed;
+}
+
+
+

package/dist/components/directory-tour/types.d.ts

@@ -0,0 +1,43 @@
+import type { CSSProperties, ReactNode } from 'react';
+import type { Locale } from '../../shared/locale.js';
+export type DirectoryTourTarget = 'userMemories' | 'userSessions' | 'userResources' | 'sharedResources' | 'userExperiences' | 'userPeers';
+export interface DirectoryTourStep {
+    id: string;
+    target: string;
+    title: ReactNode;
+    description: ReactNode;
+    illustration?: ReactNode;
+    nextLabel?: string;
+}
+export interface DirectoryTourResult {
+    skippedStepIds: readonly string[];
+}
+export interface DirectoryTourLabels {
+    close?: string;
+    next?: string;
+    done?: string;
+    locating?: string;
+    unavailable?: string;
+    retry?: string;
+    skip?: string;
+    progress?: (current: number, total: number) => string;
+}
+export interface DirectoryTourProps {
+    open: boolean;
+    steps: readonly DirectoryTourStep[];
+    /** Inherits the nearest language scope, otherwise en-US. */
+    locale?: Locale;
+    currentStep?: number;
+    defaultStep?: number;
+    placement?: 'right' | 'left';
+    locateTimeout?: number;
+    className?: string;
+    style?: CSSProperties;
+    /** Host loads/expands the path and resolves only after the row is rendered.
+     * Must respect cancellation. No network or business DTO belongs to the tour. */
+    locateTarget?: (target: string, signal: AbortSignal) => Promise<HTMLElement | null>;
+    onStepChange?: (index: number) => void;
+    onClose?: () => void;
+    onComplete?: (result: DirectoryTourResult) => void;
+    labels?: DirectoryTourLabels;
+}

package/dist/components/directory-tour/use-tour-anchor.d.ts

@@ -0,0 +1,5 @@
+import type { DirectoryTourProps } from './types.js';
+export declare function useTourAnchor(target: string, locateTarget: DirectoryTourProps['locateTarget'], timeout: number, attempt: number): {
+    anchor: HTMLElement | null;
+    failed: boolean;
+};

package/dist/components/directory-tour/use-tour-position.d.ts

@@ -0,0 +1,12 @@
+interface Position {
+    top: number;
+    left: number;
+    targetTop: number;
+    targetLeft: number;
+    targetWidth: number;
+    targetHeight: number;
+    visible: boolean;
+    missing: boolean;
+}
+export declare function useTourPosition(anchor: HTMLElement | null, surface: HTMLDivElement | null, placement: 'right' | 'left'): Position | undefined;
+export {};

package/dist/components/directory-tour.js

@@ -0,0 +1,40 @@
+const openVikingDirectoryTourSteps = [
+    {
+        id: 'memories',
+        target: 'userMemories',
+        title: 'User memories (memories)',
+        description: 'Long-term memories extracted from conversations: your identity, preferences and decisions.'
+    },
+    {
+        id: 'sessions',
+        target: 'userSessions',
+        title: 'Conversations (sessions)',
+        description: 'Conversations and task records. Return to the original context to understand an Agent’s decisions.'
+    },
+    {
+        id: 'personal-resources',
+        target: 'userResources',
+        title: 'Personal resources (resources)',
+        description: 'Documents, notes and knowledge you import for your own use.'
+    },
+    {
+        id: 'shared-resources',
+        target: 'sharedResources',
+        title: 'Team resources (resources)',
+        description: 'Shared documents, conventions and past projects available to the team.'
+    },
+    {
+        id: 'experiences',
+        target: 'userExperiences',
+        title: 'Agent experiences (experiences)',
+        description: 'Successful tasks become reusable experience for similar problems.'
+    },
+    {
+        id: 'peers',
+        target: 'userPeers',
+        title: 'Object memories (peers)',
+        description: 'Memories specific to a repository, Agent or colleague stay separate. General preferences belong in memories.'
+    }
+];
+export { DirectoryTour } from "../e~0.js";
+export { openVikingDirectoryTourSteps };

package/dist/components/file-browser-entries/file-browser-entries.d.ts

@@ -3,12 +3,12 @@ export type { FileBrowserEntriesLabels, FileBrowserEntriesProps, } from './types
 /**
  * 文件浏览入口条：连接 Agent 与导入资源。
  *
- * 两项都省略回调时不渲染任何东西，入口条因此整块消失——宿主既没接连接也没接
- * 导入时，留一条空白底色只会让人以为还有内容没加载出来。
+ * 传入 agentConnect 时内置右侧接入抽屉，回调仍可单独用于宿主自定义接入。
+ * 没有可见入口时不渲染入口条，导入入口支持宿主包装默认按钮。
  *
  * The file browser entry row: connect an agent, import resources.
  *
- * With both callbacks omitted nothing renders and the row disappears entirely —
- * leaving an empty tinted strip would suggest something failed to load.
+ * agentConnect enables the right-side drawer; callbacks also support host-owned flows.
+ * Nothing renders without visible entries; hosts can wrap the default import button.
  */
-export declare function FileBrowserEntries({ onConnectAgent, onImportResources, labels, className, ...rest }: FileBrowserEntriesProps): import("react").JSX.Element | null;
+export declare function FileBrowserEntries({ locale: localeProp, agentConnect, onConnectAgent, onImportResources, renderImportResources, labels, className, ...rest }: FileBrowserEntriesProps): import("react").JSX.Element | null;

package/dist/components/file-browser-entries/labels.d.ts

@@ -0,0 +1,3 @@
+import type { FileBrowserEntriesLabels } from './types.js';
+import { type Locale } from '../../shared/locale.js';
+export declare function resolveFileBrowserEntriesLabels(locale: Locale, labels?: FileBrowserEntriesLabels): Required<FileBrowserEntriesLabels>;

package/dist/components/file-browser-entries/locales/en-US.d.ts

@@ -0,0 +1,6 @@
+declare const messages: {
+    close: string;
+    connectAgent: string;
+    importResources: string;
+};
+export default messages;

package/dist/components/file-browser-entries/locales/zh-CN.d.ts

@@ -0,0 +1,6 @@
+declare const messages: {
+    close: string;
+    connectAgent: string;
+    importResources: string;
+};
+export default messages;