@simon_he/vue-tui 0.0.5 → 0.0.6

package/dist/index.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';
@@ -626,106 +638,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 +737,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 +751,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 +812,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<{
@@ -1152,6 +1166,8 @@ interface RenderNodeOptions {
   zIndex?: number;
   stack?: RenderStack;
   rect?: RenderRect | null;
+  dirtyRowsHint?: readonly number[];
+  priority?: TerminalSchedulerPriority;
   deps?: unknown;
   paint: (dirtyRows?: readonly number[]) => void;
 }
@@ -1272,8 +1288,9 @@ interface WheelScrollResult {
   dir: -1 | 0 | 1;
   lines: number;
 }
+type WheelDeltaMode = 'auto' | 'line' | 'pixel';
 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): 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, 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 };