@simon_he/vue-tui 0.0.5 → 0.0.7

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import * as vue15 from "vue";
-import * as vue16 from "vue";
+import * as vue12 from "vue";
+import * as vue13 from "vue";
 import { App, Component as Component$1, ComputedRef, InjectionKey, Ref, VNode } from "vue";
 
 //#region src/core/render-plane.d.ts
@@ -39,9 +39,16 @@ type TerminalSize = Readonly<{
   cols: number;
   rows: number;
 }>;
+type TerminalScrollOperation = Readonly<{
+  startY: number;
+  endY: number;
+  delta: number;
+}>;
 type TerminalCommitEvent = Readonly<{
   dirtyRows: readonly number[] | null;
   planes: TerminalRenderPlanes | null;
+  sync?: boolean;
+  scrollOperations?: readonly TerminalScrollOperation[] | null;
 }>;
 type TerminalResizeEvent = Readonly<{
   cols: number;
@@ -70,6 +77,7 @@ interface Terminal {
   batch: <T>(fn: () => T) => T;
   commit: (meta?: {
     planes?: TerminalRenderPlanes | null;
+    sync?: boolean;
   }) => readonly number[] | null;
   on: <K extends keyof TerminalEventMap>(event: K, cb: (payload: TerminalEventMap[K]) => void) => () => void;
   dispose: () => void;
@@ -79,6 +87,10 @@ interface Terminal {
   getRow: (y: number) => readonly Cell[];
   setScrollbackLimit: (limit: number) => void;
   getScrollbackLines: (count?: number) => readonly string[];
+  /** Register fingerprint function for SoA pre-computation on the composite buffer. */
+  setFingerprintFn: (fn: (ch: string, style: Style) => number) => void;
+  /** Get pre-computed fingerprints for a composite buffer row (null if not enabled). */
+  getRowFingerprints: (y: number) => Uint32Array | null;
 } //#endregion
 //#region src/core/ansi/colors.d.ts
 type TerminalColorMode = 'ansi8' | 'ansi16' | 'ansi256' | 'truecolor';
@@ -341,6 +353,7 @@ type TerminalEventRecord = Readonly<{
 //#endregion
 //#region src/cli/input.d.ts
 type Stdin = NodeJS.ReadStream;
+type KeyboardProtocol = 'auto' | 'kitty' | 'xterm' | 'off';
 type StdinDriver = Readonly<{
   dispose: () => void;
 }>;
@@ -348,7 +361,9 @@ declare function createStdinDriver(options: Readonly<{
   dispatch: (event: TerminalEventRecord) => boolean | void;
   stdin?: Stdin;
   stdout?: NodeJS.WriteStream;
+  env?: Readonly<Record<string, unknown>>;
   enableMouse?: boolean;
+  keyboardProtocol?: KeyboardProtocol;
   /**
    * Enable "any-motion" mouse tracking (xterm DECSET ?1003).
    * This is required for hover interactions in the CLI, but can increase event volume.
@@ -473,6 +488,11 @@ interface DomRenderer {
   readonly metrics: CellMetrics;
   dispose: () => void;
   refresh: () => void;
+  setPlaneOffset: (plane: TerminalRenderPlane, offsetPx: number) => void;
+  setPlaneViewport: (plane: TerminalRenderPlane, viewport: Readonly<{
+    topPx: number;
+    heightPx: number;
+  }> | null) => void;
 }
 declare function createDomRenderer(terminal: Terminal, container: HTMLElement): DomRenderer;
 
@@ -626,106 +646,6 @@ declare function createEventManager(container: HTMLElement, metrics: CellMetrics
   onFocusChange?: (prev: string | null, next: string | null) => void;
 }>): EventManager;
 
-//#endregion
-//#region src/vue/components/input/host.d.ts
-type ResolveTInputPathInfo = Readonly<{
-  workspace: string;
-  input: string;
-  preserveBackslash?: boolean;
-  homeDir?: string;
-}>;
-type TInputHostAdapter = Readonly<{
-  isTerminalLike?: boolean;
-  resolvePath?: (info: ResolveTInputPathInfo) => string;
-  pathToHref?: (pathLike: string) => string | undefined;
-  readClipboardText?: () => Promise<string>;
-  writeClipboardText?: (text: string) => Promise<boolean>;
-  showToast?: (message: string) => void;
-}>;
-
-//#endregion
-//#region src/vue/components/input/plugins/types.d.ts
-type PromptSuggestion = Readonly<{
-  value: string;
-  insert?: string;
-  label?: string;
-  detail?: string;
-  keywords?: readonly string[];
-  mentionValue?: string;
-  mentionBehavior?: 'collect' | 'inline';
-  onSelect?: (info: Readonly<{
-    value: string;
-    query: string;
-  }>) => void | boolean;
-}>;
-type TInputPluginContext = Readonly<{
-  getProps: () => Readonly<{
-    zIndex: number;
-    style?: Style;
-    promptSuggestions: readonly PromptSuggestion[];
-    promptTrigger: string;
-    promptTriggers?: readonly string[];
-    promptMaxItems: number;
-    promptAlign: 'input' | 'center';
-    promptSelectedStyle?: Style;
-    mentionTrigger: string;
-    mentionWorkspace: string;
-    mentionMode: PathPickMode;
-    mentionShowHidden: boolean;
-    mentionSuggestions: readonly PromptSuggestion[];
-    mentionMaxItems: number;
-    collectMentions: boolean;
-    mentions: readonly string[];
-    skillTrigger?: string;
-    skillSuggestions?: readonly PromptSuggestion[];
-  }>;
-  emit: (event: string, ...args: any[]) => void;
-  terminal: Terminal;
-  scheduler: Readonly<{
-    invalidate: () => void;
-  }>;
-  defaultStyle: Ref<Style>;
-  render: Readonly<{
-    rootStack: any;
-    createStack: (parent: any, z: number) => any;
-  }>;
-  visible: Ref<boolean>;
-  rawAbsRect: ComputedRef<Rect>;
-  eventZ: ComputedRef<number>;
-  focused: Ref<boolean>;
-  cursor: Ref<number>;
-  getValue: () => string;
-  insertText: (text: string) => void;
-  pushUndoSnapshot: (nextValue: string) => void;
-  applyEdit: (nextValue: string, nextCursor: number) => void;
-  registerKeydownInterceptor: (fn: (e: TerminalKeyboardEvent) => boolean) => void;
-  registerTextFilter: (fn: (info: Readonly<{
-    text: string;
-    value: string;
-    cursor: number;
-    selection: null | Readonly<{
-      start: number;
-      end: number;
-    }>;
-  }>) => string) => void;
-  registerChipStyleProvider: (provider: Readonly<{
-    getStyle: (baseStyle: Style, chip: Readonly<{
-      kind: 'multiline' | 'mention';
-      absPath?: string;
-    }>) => Style | null | undefined;
-    version: Ref<number>;
-  }> | null) => void;
-  registerHostAdapter: (adapter: TInputHostAdapter | null) => void;
-  resolvePath: (input: string, opts?: Readonly<{
-    preserveBackslash?: boolean;
-  }>) => string;
-  mentionToken: string;
-}>;
-type TInputPlugin = Readonly<{
-  name: string;
-  install: (ctx: TInputPluginContext) => void;
-}>;
-
 //#endregion
 //#region src/observability/trace.d.ts
 type TraceRecord = Readonly<{
@@ -825,6 +745,8 @@ type RenderNode = Readonly<{
 type RenderManager = Readonly<{
   rootStack: RenderStack;
   createStack: (parent: RenderStack, zIndex: number) => RenderStack;
+  invalidatePlane: (plane: TerminalRenderPlane) => void;
+  scrollPlane: (plane: TerminalRenderPlane, startY: number, endY: number, delta: number) => void;
   register: (node: {
     stack: RenderStack;
     plane?: TerminalRenderPlane;
@@ -837,6 +759,7 @@ type RenderManager = Readonly<{
     plane: TerminalRenderPlane;
     zIndex: number;
     rect: RenderRect | null;
+    dirtyRowsHint: readonly number[];
     paint: (dirtyRows?: readonly number[]) => void;
   }>) => void;
   unregister: (id: string) => void;
@@ -897,6 +820,105 @@ type TerminalContext = Readonly<{
 }>;
 declare const TInputPluginsContextKey: InjectionKey<Readonly<Ref<readonly TInputPlugin[]>>>;
 
+//#endregion
+//#region src/vue/components/input/host.d.ts
+type ResolveTInputPathInfo = Readonly<{
+  workspace: string;
+  input: string;
+  preserveBackslash?: boolean;
+  homeDir?: string;
+}>;
+type TInputHostAdapter = Readonly<{
+  isTerminalLike?: boolean;
+  resolvePath?: (info: ResolveTInputPathInfo) => string;
+  pathToHref?: (pathLike: string) => string | undefined;
+  readClipboardText?: () => Promise<string>;
+  writeClipboardText?: (text: string) => Promise<boolean>;
+  showToast?: (message: string) => void;
+}>;
+
+//#endregion
+//#region src/vue/components/input/plugins/types.d.ts
+type PromptSuggestion = Readonly<{
+  value: string;
+  insert?: string;
+  label?: string;
+  detail?: string;
+  keywords?: readonly string[];
+  mentionValue?: string;
+  mentionBehavior?: 'collect' | 'inline';
+  onSelect?: (info: Readonly<{
+    value: string;
+    query: string;
+  }>) => void | boolean;
+}>;
+type TInputPluginContext = Readonly<{
+  getProps: () => Readonly<{
+    zIndex: number;
+    style?: Style;
+    promptSuggestions: readonly PromptSuggestion[];
+    promptTrigger: string;
+    promptTriggers?: readonly string[];
+    promptMaxItems: number;
+    promptAlign: 'input' | 'center';
+    promptSelectedStyle?: Style;
+    mentionTrigger: string;
+    mentionWorkspace: string;
+    mentionMode: PathPickMode;
+    mentionShowHidden: boolean;
+    mentionSuggestions: readonly PromptSuggestion[];
+    mentionMaxItems: number;
+    collectMentions: boolean;
+    mentions: readonly string[];
+    skillTrigger?: string;
+    skillSuggestions?: readonly PromptSuggestion[];
+  }>;
+  emit: (event: string, ...args: any[]) => void;
+  terminal: Terminal;
+  scheduler: TerminalScheduler;
+  defaultStyle: Ref<Style>;
+  render: Readonly<{
+    rootStack: any;
+    createStack: (parent: any, z: number) => any;
+    invalidatePlane: (plane: TerminalRenderPlane) => void;
+  }>;
+  visible: Ref<boolean>;
+  rawAbsRect: ComputedRef<Rect>;
+  eventZ: ComputedRef<number>;
+  focused: Ref<boolean>;
+  cursor: Ref<number>;
+  getValue: () => string;
+  insertText: (text: string) => void;
+  pushUndoSnapshot: (nextValue: string) => void;
+  applyEdit: (nextValue: string, nextCursor: number) => void;
+  registerKeydownInterceptor: (fn: (e: TerminalKeyboardEvent) => boolean) => void;
+  registerTextFilter: (fn: (info: Readonly<{
+    text: string;
+    value: string;
+    cursor: number;
+    selection: null | Readonly<{
+      start: number;
+      end: number;
+    }>;
+  }>) => string) => void;
+  registerChipStyleProvider: (provider: Readonly<{
+    getStyle: (baseStyle: Style, chip: Readonly<{
+      kind: 'multiline' | 'mention';
+      absPath?: string;
+    }>) => Style | null | undefined;
+    version: Ref<number>;
+  }> | null) => void;
+  registerHostAdapter: (adapter: TInputHostAdapter | null) => void;
+  resolvePath: (input: string, opts?: Readonly<{
+    preserveBackslash?: boolean;
+  }>) => string;
+  mentionToken: string;
+}>;
+type TInputPlugin = Readonly<{
+  name: string;
+  install: (ctx: TInputPluginContext) => void;
+}>;
+
 //#endregion
 //#region src/create-terminal-app.d.ts
 type TerminalApp = Readonly<{
@@ -925,6 +947,51 @@ type CreateTerminalAppOptions = Readonly<{
 }>;
 declare function createTerminalApp(options: CreateTerminalAppOptions): TerminalApp;
 
+//#endregion
+//#region src/observability/cli-latency.d.ts
+type StageEvent = Readonly<Record<string, unknown>> & {
+  type?: unknown;
+  key?: unknown;
+  code?: unknown;
+};
+type CliLatencyProfiler = Readonly<{
+  enabled: true;
+  recordRawInput: (info?: Readonly<{
+    bytes?: number;
+  }>) => void;
+  recordStdinDispatch: (event: StageEvent, info?: Readonly<{
+    parser?: string | null;
+  }>) => void;
+  recordEventDispatchStart: (event: StageEvent) => void;
+  recordEventDispatchEnd: (event: StageEvent, info: Readonly<{
+    defaultPrevented: boolean;
+  }>) => void;
+  recordSchedulerInvalidate: (info?: Readonly<{
+    priority?: string | null;
+    plane?: string | null;
+  }>) => void;
+  recordFlushStart: (info?: Readonly<{
+    sync?: boolean;
+    activePlanes?: readonly string[] | null;
+  }>) => void;
+  recordFlushEnd: () => void;
+  recordCommit: (info?: Readonly<{
+    sync?: boolean;
+    dirtyRows?: readonly number[] | null;
+    planes?: readonly string[] | null;
+  }>) => void;
+  recordStdoutQueued: (delayMs: number) => void;
+  recordStdoutRenderStart: () => void;
+  recordStdoutNoOutput: () => void;
+  recordStdoutWrite: (info: Readonly<{
+    durationMs: number;
+    bytes: number;
+    mode: string;
+  }>) => void;
+  markOperation: (operation: string) => void;
+}>;
+declare function getCliLatencyProfiler(): CliLatencyProfiler | null;
+
 //#endregion
 //#region src/renderer/cli/stdout-metrics.d.ts
 type StdoutRendererWriteMode = 'stream' | 'sync' | 'chunked';
@@ -1152,6 +1219,8 @@ interface RenderNodeOptions {
   zIndex?: number;
   stack?: RenderStack;
   rect?: RenderRect | null;
+  dirtyRowsHint?: readonly number[];
+  priority?: TerminalSchedulerPriority;
   deps?: unknown;
   paint: (dirtyRows?: readonly number[]) => void;
 }
@@ -1220,14 +1289,14 @@ type TerminalRouteLocationRaw = string | Readonly<{
 type NavigationGuardReturn = void | boolean | TerminalRouteLocationRaw;
 type NavigationGuard = (to: TerminalRoute, from: TerminalRoute | null) => NavigationGuardReturn | Promise<NavigationGuardReturn>;
 type TerminalRouter = Readonly<{
-  currentRoute: vue15.Ref<TerminalRoute>;
+  currentRoute: vue12.Ref<TerminalRoute>;
   push: (to: TerminalRouteLocationRaw) => Promise<void>;
   replace: (to: TerminalRouteLocationRaw) => Promise<void>;
   back: () => Promise<void>;
   beforeEach: (guard: NavigationGuard) => () => void;
   beforeResolve: (guard: NavigationGuard) => () => void;
   afterEach: (guard: (to: TerminalRoute, from: TerminalRoute | null) => void) => () => void;
-  install: (app: vue16.App) => void;
+  install: (app: vue13.App) => void;
 }>;
 
 //#endregion
@@ -1266,14 +1335,19 @@ interface WheelScrollState {
   lastAt: number;
   lastEdgeDir: number;
   lastEdgeAt: number;
+  lastLineUnitDir: number;
 }
 interface WheelScrollResult {
   nextTop: number;
   dir: -1 | 0 | 1;
   lines: number;
 }
+type WheelDeltaMode = 'auto' | 'line' | 'pixel';
+interface WheelScrollOptions {
+  disableAcceleration?: boolean;
+}
 declare function createWheelScrollState(): WheelScrollState;
-declare function applyWheelScroll(state: WheelScrollState, deltaY: number, scrollTop: number, maxTop: number, now?: number): WheelScrollResult;
+declare function applyWheelScroll(state: WheelScrollState, deltaY: number, scrollTop: number, maxTop: number, now?: number, deltaMode?: WheelDeltaMode, options?: WheelScrollOptions): WheelScrollResult;
 
 //#endregion
-export { ANSI16_COLORS, ANSI256_COLORS, ANSI8_COLORS, AnsiColorName, BufferSnapshot, Cell, CellMetrics, CliEventManager, ClipboardApi, CreateTerminalAppOptions, DomRenderer, EventManager, FsDirEntry, FsEntryKind, FsStat, LayoutContext, MentionPathProvider, MentionSuggestionProvider, PathPickMode, PathPickerProvider, PathSuggestion, PromptMentionPluginOptions, PromptSuggestion, RafApi, Rect, Runtime, RuntimeEnv, SGR_RESET, StdinDriver, StdoutRenderer, StdoutRendererMetrics, Style, SuggestPathsResult, TAnchor, TBox, TDebugOverlay, TDialog, TERMINAL_RENDER_PLANES, TFlow, TInput, TInputBox, TInputHostAdapter, TInputPlugin, TInputPluginContext, TInputPluginsContextKey, TJsonEditor, TList, TMultilineModal, TPathPicker, TRenderLayer, TRenderPlane, TRouterView, TSelect, TText, TTransition, TView, Terminal, TerminalApp, TerminalBaseEvent, TerminalColorCapability, TerminalColorLevel, TerminalColorMode, TerminalCommitEvent, TerminalContext, TerminalDebugNode, TerminalEventHandlerMap, TerminalEventMap, TerminalEventRecord, TerminalEventType, TerminalInputEvent, TerminalKeyboardEvent, TerminalNode, TerminalPointerEvent, TerminalProvider, TerminalRenderPlane, TerminalRenderPlanes, TerminalResizeEvent, TerminalRoute, TerminalRouteLocationRaw, TerminalRouteRecord, TerminalRouter, TerminalRuntime, TerminalRuntimeHandle, TerminalScheduler, TerminalSchedulerInvalidateOptions, TimerApi, TraceRecord, TraceStore, ansiColors, ansiStyles, applyWheelScroll, charCellWidth, clearTextCaches, createCliEventManager, createDefaultTInputHostAdapter, createDomRenderer, createEventManager, createNodeMentionPathProvider, createNodePathPickerProvider, createPromptMentionPlugin, createRuntime, createStdinDriver, createStdoutRenderer, createTInputHostPlugin, createTerminal, createTerminalApp, createTerminalRouter, createTextRestrictionPlugin, createTraceStore, createWheelScrollState, defaultTInputHostPlugin, detectTerminalColorCapability, formatInlineCellLine, getStdoutRendererMetrics, lintJsonText, normalizeNewlines, padEndByCells, parseAnsiSgr, readEventLog, resolveUserPath, rgbToAnsi256, sanitizeInlineText, sanitizeTextBlock, sliceByCells, sliceByCellsRange, spaces, suggestPaths, textCellWidth, truecolorBgOpen, truecolorFgOpen, useLayout, useRenderNode, useRoute, useRouter, useTerminal, useTerminalNode, useTerminalRuntime, useVisibility, wrapByCells, writeEventLog, writeSnapshot };
+export { ANSI16_COLORS, ANSI256_COLORS, ANSI8_COLORS, AnsiColorName, BufferSnapshot, Cell, CellMetrics, CliEventManager, ClipboardApi, CreateTerminalAppOptions, DomRenderer, EventManager, FsDirEntry, FsEntryKind, FsStat, LayoutContext, MentionPathProvider, MentionSuggestionProvider, PathPickMode, PathPickerProvider, PathSuggestion, PromptMentionPluginOptions, PromptSuggestion, RafApi, Rect, Runtime, RuntimeEnv, SGR_RESET, StdinDriver, StdoutRenderer, StdoutRendererMetrics, Style, SuggestPathsResult, TAnchor, TBox, TDebugOverlay, TDialog, TERMINAL_RENDER_PLANES, TFlow, TInput, TInputBox, TInputHostAdapter, TInputPlugin, TInputPluginContext, TInputPluginsContextKey, TJsonEditor, TList, TMultilineModal, TPathPicker, TRenderLayer, TRenderPlane, TRouterView, TSelect, TText, TTransition, TView, Terminal, TerminalApp, TerminalBaseEvent, TerminalColorCapability, TerminalColorLevel, TerminalColorMode, TerminalCommitEvent, TerminalContext, TerminalDebugNode, TerminalEventHandlerMap, TerminalEventMap, TerminalEventRecord, TerminalEventType, TerminalInputEvent, TerminalKeyboardEvent, TerminalNode, TerminalPointerEvent, TerminalProvider, TerminalRenderPlane, TerminalRenderPlanes, TerminalResizeEvent, TerminalRoute, TerminalRouteLocationRaw, TerminalRouteRecord, TerminalRouter, TerminalRuntime, TerminalRuntimeHandle, TerminalScheduler, TerminalSchedulerInvalidateOptions, TerminalScrollOperation, TimerApi, TraceRecord, TraceStore, ansiColors, ansiStyles, applyWheelScroll, charCellWidth, clearTextCaches, createCliEventManager, createDefaultTInputHostAdapter, createDomRenderer, createEventManager, createNodeMentionPathProvider, createNodePathPickerProvider, createPromptMentionPlugin, createRuntime, createStdinDriver, createStdoutRenderer, createTInputHostPlugin, createTerminal, createTerminalApp, createTerminalRouter, createTextRestrictionPlugin, createTraceStore, createWheelScrollState, defaultTInputHostPlugin, detectTerminalColorCapability, formatInlineCellLine, getCliLatencyProfiler, getStdoutRendererMetrics, lintJsonText, normalizeNewlines, padEndByCells, parseAnsiSgr, readEventLog, resolveUserPath, rgbToAnsi256, sanitizeInlineText, sanitizeTextBlock, sliceByCells, sliceByCellsRange, spaces, suggestPaths, textCellWidth, truecolorBgOpen, truecolorFgOpen, useLayout, useRenderNode, useRoute, useRouter, useTerminal, useTerminalNode, useTerminalRuntime, useVisibility, wrapByCells, writeEventLog, writeSnapshot };