@linxiraos/pi-tui 1.4.10 → 1.4.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +34 -237
- package/README.md +4 -1
- package/THIRD-PARTY-NOTICES.txt +99 -0
- package/dist/types/apps/shell-visualizer.d.ts +24 -0
- package/dist/types/autocomplete.d.ts +20 -0
- package/dist/types/chat/cache-invalidation-marker.d.ts +15 -7
- package/dist/types/chat/chat-transcript-builder.d.ts +5 -3
- package/dist/types/chat/display-preferences.d.ts +2 -0
- package/dist/types/chat/extension-types.d.ts +72 -1
- package/dist/types/chat/image-loading.d.ts +2 -2
- package/dist/types/chat/messages.d.ts +2 -3
- package/dist/types/chat/read-tool-group.d.ts +15 -2
- package/dist/types/chat/skill-message.d.ts +1 -0
- package/dist/types/chat/spotlight.d.ts +203 -0
- package/dist/types/chat/tool-execution.d.ts +26 -5
- package/dist/types/chat/transcript-actions.d.ts +11 -0
- package/dist/types/chat/transcript-browser.d.ts +9 -0
- package/dist/types/chat/transcript-presentation.d.ts +164 -0
- package/dist/types/chat/ttsr-notification.d.ts +2 -0
- package/dist/types/chrome/message-frame.d.ts +2 -0
- package/dist/types/chrome/transcript-container.d.ts +27 -6
- package/dist/types/components/loader.d.ts +0 -2
- package/dist/types/components/markdown.d.ts +11 -1
- package/dist/types/components/settings-list.d.ts +12 -2
- package/dist/types/frame-rate.d.ts +18 -0
- package/dist/types/index.d.ts +3 -0
- package/dist/types/keybinding-matchers.d.ts +4 -1
- package/dist/types/kitty-graphics.d.ts +1 -1
- package/dist/types/motion-effects.d.ts +10 -0
- package/dist/types/native/encode.d.ts +2 -0
- package/dist/types/native/measure.d.ts +10 -0
- package/dist/types/native/overlay.d.ts +1 -1
- package/dist/types/native/quiet.d.ts +5 -0
- package/dist/types/native/reconcile.d.ts +6 -1
- package/dist/types/native/spans.d.ts +6 -0
- package/dist/types/native/state.d.ts +4 -0
- package/dist/types/overlays/agent-hub.d.ts +6 -0
- package/dist/types/overlays/link-browser.d.ts +55 -0
- package/dist/types/overlays/running-subagent-badge.d.ts +1 -4
- package/dist/types/overlays/settings-selector.d.ts +1 -1
- package/dist/types/overlays/snapcompact-shape-preview.d.ts +1 -1
- package/dist/types/overlays/spotlight-sheet.d.ts +36 -0
- package/dist/types/prompt/composer-attachments.d.ts +5 -2
- package/dist/types/prompt/composer-cache.d.ts +7 -2
- package/dist/types/prompt/composer.d.ts +6 -11
- package/dist/types/prompt/custom-editor.d.ts +8 -2
- package/dist/types/prompt/gradient-highlight.d.ts +2 -2
- package/dist/types/prompt/magic-keywords.d.ts +2 -0
- package/dist/types/prompt/model-mention-autocomplete.d.ts +9 -7
- package/dist/types/prompt/model-mention-syntax.d.ts +6 -0
- package/dist/types/prompt/prompt-action-autocomplete.d.ts +2 -1
- package/dist/types/prompt/welcome.d.ts +19 -0
- package/dist/types/render/extension-links.d.ts +0 -6
- package/dist/types/render/index.d.ts +1 -0
- package/dist/types/render/link-hints.d.ts +78 -0
- package/dist/types/render/render-utils.d.ts +0 -2
- package/dist/types/setup/scenes/types.d.ts +8 -0
- package/dist/types/setup/scenes/updates.d.ts +6 -0
- package/dist/types/setup/wizard.d.ts +7 -2
- package/dist/types/spinner-clock.d.ts +34 -0
- package/dist/types/status-line/component.d.ts +8 -4
- package/dist/types/status-line/host.d.ts +62 -0
- package/dist/types/status-line/index.d.ts +1 -0
- package/dist/types/status-line/prompt-cache.d.ts +14 -0
- package/dist/types/status-line/schema.d.ts +1 -1
- package/dist/types/status-line/startup.d.ts +6 -0
- package/dist/types/status-line/types.d.ts +8 -21
- package/dist/types/theme/schema.d.ts +28 -1
- package/dist/types/theme/symbols.d.ts +1 -1
- package/dist/types/theme/theme-class.d.ts +12 -2
- package/dist/types/theme/theme.d.ts +1 -1
- package/dist/types/theme/tui-adapters.d.ts +7 -0
- package/dist/types/thinking.d.ts +12 -0
- package/dist/types/tools/ask.d.ts +1 -1
- package/dist/types/tools/bash.d.ts +21 -0
- package/dist/types/tools/find.d.ts +9 -1
- package/dist/types/tools/grep.d.ts +2 -1
- package/dist/types/tools/grouped-file-output.d.ts +17 -0
- package/dist/types/tools/job-widget.d.ts +2 -2
- package/dist/types/tools/lsp.d.ts +4 -2
- package/dist/types/tools/native-view.d.ts +4 -0
- package/dist/types/tools/renderer.d.ts +9 -1
- package/dist/types/tools/shell-trace.d.ts +10 -0
- package/dist/types/tools/shell-viz-render.d.ts +6 -0
- package/dist/types/tools/shell-viz.d.ts +16 -0
- package/dist/types/tools/wait.d.ts +2 -2
- package/dist/types/tools/web-search-types.d.ts +1 -0
- package/dist/types/tools/write.d.ts +2 -0
- package/dist/types/tui.d.ts +15 -1
- package/package.json +15 -11
- package/src/apps/shell-visualizer.d.ts +24 -0
- package/src/apps/shell-visualizer.ts +167 -0
- package/src/autocomplete.d.ts +20 -0
- package/src/autocomplete.ts +14 -0
- package/src/chat/assistant-message.ts +11 -6
- package/src/chat/cache-invalidation-marker.d.ts +15 -7
- package/src/chat/cache-invalidation-marker.ts +18 -9
- package/src/chat/chat-transcript-builder.d.ts +5 -3
- package/src/chat/chat-transcript-builder.ts +16 -12
- package/src/chat/display-preferences.d.ts +2 -0
- package/src/chat/display-preferences.ts +3 -0
- package/src/chat/extension-types.d.ts +72 -1
- package/src/chat/extension-types.ts +74 -1
- package/src/chat/image-loading.d.ts +2 -2
- package/src/chat/image-loading.ts +2 -2
- package/src/chat/messages.d.ts +2 -3
- package/src/chat/messages.ts +3 -8
- package/src/chat/read-tool-group.d.ts +15 -2
- package/src/chat/read-tool-group.ts +201 -41
- package/src/chat/skill-message.d.ts +1 -0
- package/src/chat/skill-message.ts +4 -0
- package/src/chat/spotlight.d.ts +203 -0
- package/src/chat/spotlight.ts +460 -0
- package/src/chat/tool-execution.d.ts +26 -5
- package/src/chat/tool-execution.ts +360 -38
- package/src/chat/transcript-actions.d.ts +11 -0
- package/src/chat/transcript-actions.ts +13 -1
- package/src/chat/transcript-browser.d.ts +9 -0
- package/src/chat/transcript-browser.ts +18 -0
- package/src/chat/transcript-presentation.d.ts +164 -0
- package/src/chat/transcript-presentation.ts +642 -0
- package/src/chat/ttsr-notification.d.ts +25 -0
- package/src/chat/ttsr-notification.ts +5 -0
- package/src/chrome/message-frame.d.ts +2 -0
- package/src/chrome/message-frame.ts +7 -0
- package/src/chrome/message-notice.d.ts +58 -0
- package/src/chrome/transcript-container.d.ts +27 -6
- package/src/chrome/transcript-container.ts +317 -66
- package/src/components/editor.ts +25 -1
- package/src/components/loader.d.ts +0 -2
- package/src/components/loader.ts +30 -18
- package/src/components/markdown.d.ts +11 -1
- package/src/components/markdown.ts +41 -16
- package/src/components/settings-list.d.ts +12 -2
- package/src/components/settings-list.ts +29 -13
- package/src/frame-rate.d.ts +18 -0
- package/src/frame-rate.ts +36 -0
- package/src/hotkeys-markdown.ts +4 -1
- package/src/index.d.ts +3 -0
- package/src/index.ts +3 -0
- package/src/keybinding-matchers.d.ts +4 -1
- package/src/keybinding-matchers.ts +13 -12
- package/src/kitty-graphics.d.ts +1 -1
- package/src/kitty-graphics.ts +3 -2
- package/src/motion-effects.d.ts +10 -0
- package/src/motion-effects.ts +27 -0
- package/src/native/backend.ts +66 -7
- package/src/native/encode.d.ts +2 -0
- package/src/native/encode.ts +2 -0
- package/src/native/measure.d.ts +10 -0
- package/src/native/measure.ts +185 -0
- package/src/native/overlay.d.ts +1 -1
- package/src/native/overlay.ts +1 -1
- package/src/native/quiet.d.ts +5 -0
- package/src/native/quiet.ts +105 -0
- package/src/native/reconcile.d.ts +6 -1
- package/src/native/reconcile.ts +16 -10
- package/src/native/spans.d.ts +6 -0
- package/src/native/spans.ts +40 -0
- package/src/native/state.d.ts +4 -0
- package/src/native/state.ts +18 -0
- package/src/overlays/agent-hub.ts +15 -2
- package/src/overlays/ask-dialog.ts +1 -0
- package/src/overlays/btw-history-panel.ts +73 -6
- package/src/overlays/link-browser.ts +295 -0
- package/src/overlays/running-subagent-badge.ts +2 -9
- package/src/overlays/settings-defs.ts +2 -1
- package/src/overlays/settings-selector.ts +18 -4
- package/src/overlays/snapcompact-shape-preview.ts +1 -1
- package/src/overlays/spotlight-sheet.ts +478 -0
- package/src/overlays/usage-dashboard.ts +6 -5
- package/src/prompt/composer-attachments.d.ts +5 -2
- package/src/prompt/composer-attachments.ts +6 -6
- package/src/prompt/composer-cache.ts +17 -16
- package/src/prompt/composer.ts +30 -123
- package/src/prompt/custom-editor.ts +17 -13
- package/src/prompt/gradient-highlight.d.ts +2 -2
- package/src/prompt/gradient-highlight.ts +5 -4
- package/src/prompt/magic-keywords.d.ts +2 -0
- package/src/prompt/magic-keywords.ts +4 -1
- package/src/prompt/model-mention-autocomplete.ts +73 -20
- package/src/prompt/model-mention-syntax.d.ts +6 -0
- package/src/prompt/model-mention-syntax.ts +9 -0
- package/src/prompt/prompt-action-autocomplete.ts +49 -33
- package/src/prompt/tips.txt +1 -0
- package/src/prompt/welcome.ts +104 -2
- package/src/render/extension-links.d.ts +0 -6
- package/src/render/extension-links.ts +0 -20
- package/src/render/index.d.ts +1 -0
- package/src/render/index.ts +1 -0
- package/src/render/link-hints.d.ts +78 -0
- package/src/render/link-hints.ts +299 -0
- package/src/render/render-utils.d.ts +0 -2
- package/src/render/render-utils.ts +0 -5
- package/src/setup/scenes/glyph.ts +1 -1
- package/src/setup/scenes/types.ts +8 -0
- package/src/setup/scenes/updates.ts +116 -0
- package/src/setup/wizard.ts +19 -8
- package/src/spinner-clock.d.ts +34 -0
- package/src/spinner-clock.ts +79 -0
- package/src/status-line/component.ts +145 -53
- package/src/status-line/host.ts +51 -0
- package/src/status-line/index.ts +1 -0
- package/src/status-line/presets.ts +3 -1
- package/src/status-line/prompt-cache.ts +154 -0
- package/src/status-line/schema.ts +1 -1
- package/src/status-line/segments.ts +33 -22
- package/src/status-line/startup.ts +23 -5
- package/src/status-line/types.ts +8 -22
- package/src/stdin-buffer.ts +89 -46
- package/src/terminal-capabilities.ts +3 -3
- package/src/terminal.ts +1 -8
- package/src/theme/loader.ts +3 -2
- package/src/theme/schema-validation.ts +1 -1
- package/src/theme/schema.d.ts +28 -1
- package/src/theme/schema.ts +30 -1
- package/src/theme/symbols.d.ts +1 -1
- package/src/theme/symbols.ts +15 -3
- package/src/theme/theme-class.d.ts +12 -2
- package/src/theme/theme-class.ts +23 -0
- package/src/theme/theme-schema.json +1 -1
- package/src/theme/theme.d.ts +1 -1
- package/src/theme/theme.ts +3 -7
- package/src/theme/tui-adapters.d.ts +7 -0
- package/src/theme/tui-adapters.ts +33 -1
- package/src/thinking.d.ts +12 -0
- package/src/thinking.ts +31 -0
- package/src/tools/ask.d.ts +1 -1
- package/src/tools/ask.ts +99 -38
- package/src/tools/ast-edit.ts +51 -32
- package/src/tools/ast-grep.ts +31 -19
- package/src/tools/bash.d.ts +21 -0
- package/src/tools/bash.ts +166 -24
- package/src/tools/find.d.ts +9 -1
- package/src/tools/find.ts +23 -2
- package/src/tools/grep.d.ts +2 -1
- package/src/tools/grep.ts +52 -36
- package/src/tools/grouped-file-output.d.ts +17 -0
- package/src/tools/grouped-file-output.ts +20 -2
- package/src/tools/job-widget.d.ts +2 -2
- package/src/tools/job-widget.ts +2 -2
- package/src/tools/lsp.d.ts +4 -2
- package/src/tools/lsp.ts +537 -642
- package/src/tools/native-view.d.ts +4 -0
- package/src/tools/native-view.ts +8 -2
- package/src/tools/renderer.d.ts +9 -1
- package/src/tools/renderer.ts +9 -1
- package/src/tools/shell-trace.d.ts +10 -0
- package/src/tools/shell-trace.ts +80 -0
- package/src/tools/shell-viz-render.d.ts +6 -0
- package/src/tools/shell-viz-render.ts +156 -0
- package/src/tools/shell-viz.d.ts +16 -0
- package/src/tools/shell-viz.ts +181 -0
- package/src/tools/streaming-output.ts +18 -8
- package/src/tools/task.ts +1 -1
- package/src/tools/wait.d.ts +2 -2
- package/src/tools/wait.ts +39 -34
- package/src/tools/web-search-types.d.ts +1 -0
- package/src/tools/web-search-types.ts +1 -0
- package/src/tools/write.d.ts +2 -0
- package/src/tools/write.ts +2 -0
- package/src/tui.d.ts +15 -1
- package/src/tui.ts +63 -6
- package/src/windows-input-mode.ts +7 -1
- package/dist/types/chat/collab-prompt-message.d.ts +0 -14
- package/dist/types/chrome/collab-qrcode.d.ts +0 -35
- package/src/chat/collab-prompt-message.d.ts +0 -14
- package/src/chat/collab-prompt-message.ts +0 -46
- package/src/chrome/collab-qrcode.ts +0 -99
|
@@ -1,7 +1,10 @@
|
|
|
1
1
|
import type { AssistantMessage } from "@linxiraos/pi-ai";
|
|
2
|
+
import type { TspText } from "@linxiraos/pi-wire";
|
|
2
3
|
import type { Component, TUI } from "../tui.js";
|
|
3
4
|
import type { Theme } from "../theme/theme.js";
|
|
4
|
-
import type {
|
|
5
|
+
import type { TodoItem } from "../tools/todo.js";
|
|
6
|
+
import type { BashExecutionMessage, CustomMessage, HookMessage, PythonExecutionMessage } from "./messages.js";
|
|
7
|
+
import type { NotificationRule } from "./ttsr-notification.js";
|
|
5
8
|
export type ExtensionUiComponent = Component & {
|
|
6
9
|
dispose?(): void;
|
|
7
10
|
};
|
|
@@ -48,6 +51,74 @@ export interface AssistantTextRendering {
|
|
|
48
51
|
/** Index in the full reply's `content` of this component's first block; a segment after a tool call starts past it. */
|
|
49
52
|
contentOffset: number;
|
|
50
53
|
}
|
|
54
|
+
/**
|
|
55
|
+
* One transcript block a {@link TranscriptPresenter} decides the display of. Later omp versions
|
|
56
|
+
* add block types; answer `undefined` for a `type` you do not know.
|
|
57
|
+
*
|
|
58
|
+
* - `toolCall`: a model tool call, `id` its `toolCallId`. `result` arrives with the call's first
|
|
59
|
+
* result frame; `isPartial` stays true while the call still streams progress.
|
|
60
|
+
* - `message`: a session message drawn as its own block, `id` the decimal `message.timestamp`
|
|
61
|
+
* (shared by messages recorded in the same millisecond).
|
|
62
|
+
* `custom` messages with `customType` `"advisor"`, `"skill-prompt"`, `"lsp-late-diagnostic"`,
|
|
63
|
+
* `"async-result"` or `"launch-completion"`, and `!`/`$` runs (`bashExecution`,
|
|
64
|
+
* `pythonExecution`). A `!`/`$` run still going has a provisional message and id; it is asked
|
|
65
|
+
* again with the recorded message once the session records the run. In Tern, late diagnostics
|
|
66
|
+
* an edit/write card takes are drawn with that card instead, so an `"lsp-late-diagnostic"`
|
|
67
|
+
* block appears only for the files no card took.
|
|
68
|
+
* - `event`: a TTSR rule hit or an incomplete-todo reminder, shaped like the extension event of
|
|
69
|
+
* the same `type`. These exist only in the session that raised them; `id` is unique per process.
|
|
70
|
+
*
|
|
71
|
+
* Read-only, and not a copy: `args`, `result`'s `content` and `details`, `message` and `event`
|
|
72
|
+
* are the live objects omp draws the block from, often the session's own message data. Never
|
|
73
|
+
* mutate them: the change would reach the block and possibly the session.
|
|
74
|
+
*/
|
|
75
|
+
export type TranscriptBlock = {
|
|
76
|
+
readonly type: "toolCall";
|
|
77
|
+
readonly id: string;
|
|
78
|
+
readonly toolName: string;
|
|
79
|
+
readonly args: unknown;
|
|
80
|
+
readonly result?: {
|
|
81
|
+
readonly content: readonly unknown[];
|
|
82
|
+
readonly details?: unknown;
|
|
83
|
+
};
|
|
84
|
+
readonly isError: boolean;
|
|
85
|
+
readonly isPartial: boolean;
|
|
86
|
+
} | {
|
|
87
|
+
readonly type: "message";
|
|
88
|
+
readonly id: string;
|
|
89
|
+
readonly message: CustomMessage | BashExecutionMessage | PythonExecutionMessage;
|
|
90
|
+
} | {
|
|
91
|
+
readonly type: "event";
|
|
92
|
+
readonly id: string;
|
|
93
|
+
readonly event: {
|
|
94
|
+
readonly type: "ttsr_triggered";
|
|
95
|
+
readonly rules: readonly NotificationRule[];
|
|
96
|
+
} | {
|
|
97
|
+
readonly type: "todo_reminder";
|
|
98
|
+
readonly todos: readonly TodoItem[];
|
|
99
|
+
readonly attempt: number;
|
|
100
|
+
readonly maxAttempts: number;
|
|
101
|
+
};
|
|
102
|
+
};
|
|
103
|
+
/**
|
|
104
|
+
* How a transcript block is drawn: `undefined` defers to the next presenter (and, after the
|
|
105
|
+
* last, to `"full"`); `"full"` is omp's own card; `"hidden"` draws nothing, as hidden tool
|
|
106
|
+
* activity does; `"compact"` is one row from omp's own summary. `{ compact: { label, rows } }`
|
|
107
|
+
* replaces that row's text with `label` and adds one row per `rows` entry below it. Spans use the
|
|
108
|
+
* semantic tokens and theme colour names of {@link TspText}.
|
|
109
|
+
*/
|
|
110
|
+
export type TranscriptPresentation = undefined | "full" | "hidden" | "compact" | {
|
|
111
|
+
readonly compact: {
|
|
112
|
+
readonly label?: TspText;
|
|
113
|
+
readonly rows?: readonly TspText[];
|
|
114
|
+
};
|
|
115
|
+
};
|
|
116
|
+
/**
|
|
117
|
+
* Display-only choice of how one transcript block is drawn. Presenters are asked in extension
|
|
118
|
+
* load order; the first answer other than `undefined` wins. A block the user expanded is always
|
|
119
|
+
* drawn in full.
|
|
120
|
+
*/
|
|
121
|
+
export type TranscriptPresenter = (block: TranscriptBlock) => TranscriptPresentation;
|
|
51
122
|
export interface HookMessageRenderOptions {
|
|
52
123
|
/** Whether the view is expanded */
|
|
53
124
|
expanded: boolean;
|
|
@@ -5,12 +5,12 @@ export declare const SUPPORTED_INPUT_IMAGE_MIME_TYPES: Set<string>;
|
|
|
5
5
|
* Ollama and its local-backend family decode image input through llama.cpp /
|
|
6
6
|
* `stb_image`, which is compiled without WebP support, so a WebP upload fails
|
|
7
7
|
* with an opaque HTTP 400. Detect those models so the resize pipeline encodes
|
|
8
|
-
* to PNG/JPEG instead — the automatic equivalent of `
|
|
8
|
+
* to PNG/JPEG instead — the automatic equivalent of `ZETA_NO_WEBP=1`.
|
|
9
9
|
*/
|
|
10
10
|
export declare function modelLacksWebpSupport(model: Pick<Model, "provider" | "api" | "imageInputDecoder"> | undefined): boolean;
|
|
11
11
|
/**
|
|
12
12
|
* `true` when `model` cannot decode WebP, otherwise `undefined` so the
|
|
13
|
-
* `
|
|
13
|
+
* `ZETA_NO_WEBP` env fallback in {@link resizeImage} still applies. Feed straight
|
|
14
14
|
* into {@link ImageResizeOptions.excludeWebP}.
|
|
15
15
|
*/
|
|
16
16
|
export declare function webpExclusionForModel(model: Pick<Model, "provider" | "api"> | undefined): true | undefined;
|
|
@@ -12,7 +12,6 @@ declare module "@linxiraos/pi-agent-core" {
|
|
|
12
12
|
fileMention: FileMentionMessage;
|
|
13
13
|
}
|
|
14
14
|
}
|
|
15
|
-
export { COLLAB_PROMPT_MESSAGE_TYPE, type CollabPromptDetails } from "@linxiraos/pi-wire";
|
|
16
15
|
export type { BranchSummaryMessage, CompactionSummaryMessage } from "@linxiraos/pi-agent-core/compaction/messages";
|
|
17
16
|
export declare const SKILL_PROMPT_MESSAGE_TYPE = "skill-prompt";
|
|
18
17
|
export declare const LSP_LATE_DIAGNOSTIC_MESSAGE_TYPE = "lsp-late-diagnostic";
|
|
@@ -169,8 +168,8 @@ export interface FileMentionMessage {
|
|
|
169
168
|
export declare function isUserInvokedSkillPrompt(message: CustomMessage): boolean;
|
|
170
169
|
/**
|
|
171
170
|
* True for a custom message that initiates a user-attributed turn: a directly
|
|
172
|
-
* invoked `/skill:` prompt
|
|
173
|
-
*
|
|
171
|
+
* invoked `/skill:` prompt. Agent redirects, reminders, and auto-continues are
|
|
172
|
+
* not turn starts.
|
|
174
173
|
*/
|
|
175
174
|
export declare function isUserTurnInitiator(message: CustomMessage): boolean;
|
|
176
175
|
/** Advisor note severities, weakest first; ranks severity thresholds such as `advisor.continueSeverity`. */
|
|
@@ -21,12 +21,21 @@ export declare function readArgsCollapseIntoGroup(args: unknown): boolean;
|
|
|
21
21
|
export declare function groupedReadUsageCallIds(message: AssistantMessage): string[] | undefined;
|
|
22
22
|
type ReadToolGroupOptions = {
|
|
23
23
|
showContentPreview?: boolean;
|
|
24
|
+
/** Ask the extension transcript presenters; false for a replayed transcript (overlays). Default: true. */
|
|
25
|
+
transcriptPresenters?: boolean;
|
|
24
26
|
};
|
|
25
27
|
export declare class ReadToolGroupComponent extends Container implements ToolExecutionHandle {
|
|
26
28
|
#private;
|
|
27
29
|
constructor(options?: ReadToolGroupOptions);
|
|
30
|
+
/**
|
|
31
|
+
* Reads a presenter leaves full draw as the group, at the first full read's place; a compact
|
|
32
|
+
* read is a row of its own; hidden draws nothing.
|
|
33
|
+
*/
|
|
28
34
|
render(width: number): readonly string[];
|
|
35
|
+
refreshTranscriptPresentation(ids?: ReadonlySet<string>): boolean;
|
|
29
36
|
isTranscriptBlockFinalized(): boolean;
|
|
37
|
+
/** Compact only while every read it draws is a compact row. */
|
|
38
|
+
isTranscriptBlockCompact(): boolean;
|
|
30
39
|
finalize(): void;
|
|
31
40
|
/**
|
|
32
41
|
* Force the group terminal even if an entry never received its result (the
|
|
@@ -63,11 +72,14 @@ export declare class ReadToolGroupComponent extends Container implements ToolExe
|
|
|
63
72
|
setExecutionStarted(_toolCallId?: string): void;
|
|
64
73
|
setExpanded(expanded: boolean): void;
|
|
65
74
|
setToolActivityVisible(visible: boolean): void;
|
|
75
|
+
/** The reads' Spotlight notices, in order: blocks of their own right after the group's card. */
|
|
76
|
+
nativeTrailers(): readonly Component[];
|
|
66
77
|
getComponent(): Component;
|
|
67
78
|
/**
|
|
68
79
|
* Mirrors the terminal's toggles: the `tool` head (the group's root) is
|
|
69
80
|
* `Ctrl+O`'s expansion; a fallback preview card collapses on its own
|
|
70
|
-
* (`setExpanded` resets those).
|
|
81
|
+
* (`setExpanded` resets those). A compact read's row (`c<id>`) opens that
|
|
82
|
+
* read; the full rows beside compact ones (`full`) open and close their reads.
|
|
71
83
|
*/
|
|
72
84
|
handleNativeEvent(event: NativeUiEvent): void;
|
|
73
85
|
/**
|
|
@@ -75,7 +87,8 @@ export declare class ReadToolGroupComponent extends Container implements ToolExe
|
|
|
75
87
|
* the fallback: a bare `card` (role `zeta.tool.read`) with `Read <path>` or
|
|
76
88
|
* `Read (N)` in the head, a `list` of path items (status tone, link,
|
|
77
89
|
* correction and conflict detail, nested usage) and a clamped preview per
|
|
78
|
-
* read when content previews are on.
|
|
90
|
+
* read when content previews are on. Compact reads become rows of their
|
|
91
|
+
* own (keyed `c<toolCallId>`) beside that group.
|
|
79
92
|
*/
|
|
80
93
|
describe(cx?: DescribeContext): NativeNode;
|
|
81
94
|
}
|
|
@@ -18,6 +18,7 @@ export declare class SkillMessageComponent extends Container {
|
|
|
18
18
|
#private;
|
|
19
19
|
constructor(message: CustomMessage<SkillPromptDetails>, imageLinks?: readonly (string | undefined)[]);
|
|
20
20
|
setExpanded(expanded: boolean): void;
|
|
21
|
+
isExpanded(): boolean;
|
|
21
22
|
handleNativeEvent(event: NativeUiEvent): void;
|
|
22
23
|
/**
|
|
23
24
|
* A user-toned card (role `zeta.skill`): the skill chip (linked to its
|
|
@@ -0,0 +1,203 @@
|
|
|
1
|
+
import type { TspPropNode, TspTone } from "@linxiraos/pi-wire";
|
|
2
|
+
import type { NativeNode, NativeUiEvent } from "../native/node.js";
|
|
3
|
+
import type { Component } from "../tui.js";
|
|
4
|
+
/** Original lines a result's heat and the sheet cover; later lines are shown in neither. */
|
|
5
|
+
export declare const SPOTLIGHT_VIEW_LINES = 5000;
|
|
6
|
+
/** The original of a result whose text shaping changed. */
|
|
7
|
+
export interface SpotlightOriginal {
|
|
8
|
+
/** Session artifact holding the original text (`artifact://N`). */
|
|
9
|
+
url: string;
|
|
10
|
+
/** Its line count. */
|
|
11
|
+
lines: number;
|
|
12
|
+
/** Line number of its first line: a `read` window's first file line, else 1. */
|
|
13
|
+
start: number;
|
|
14
|
+
/** The file a `read` showed (picks the sheet's grammar). */
|
|
15
|
+
path?: string;
|
|
16
|
+
/**
|
|
17
|
+
* One character per original line, from its first (at most {@link SPOTLIGHT_VIEW_LINES}): Spotlight's score as
|
|
18
|
+
* `0`–`9` relative to the result's hottest line, `-` for a line it never scored. Lines past the end are unscored.
|
|
19
|
+
*/
|
|
20
|
+
heat: string;
|
|
21
|
+
/** Runs of original lines the model was shown verbatim, `[first, last]` 1-based positions in the original. */
|
|
22
|
+
kept: [number, number][];
|
|
23
|
+
/**
|
|
24
|
+
* One {@link SpotlightReason} character per original line, over the span {@link heat} covers: why shaping showed or
|
|
25
|
+
* hid the line. Absent on traces written before it.
|
|
26
|
+
*/
|
|
27
|
+
why?: string;
|
|
28
|
+
/** How the step that cut by rank chose its lines; absent when no step ranked them. */
|
|
29
|
+
rank?: SpotlightRank;
|
|
30
|
+
/**
|
|
31
|
+
* One entry per line of the text the model saw (of a held-out result: the text it would have seen): the original
|
|
32
|
+
* line it shows (1-based position in the original), the `[first, last]` run a marker stands for, or null for a line
|
|
33
|
+
* of its own (a shaping note).
|
|
34
|
+
*/
|
|
35
|
+
map?: (number | [number, number] | null)[];
|
|
36
|
+
/** A held-out result's would-be text, the cut the model was not shown (`artifact://N`). */
|
|
37
|
+
shapedUrl?: string;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* Why shaping showed or hid one original line ({@link SpotlightOriginal.why}). Shown: `a` won on its score, `s`
|
|
41
|
+
* structure kept regardless of score (head and tail lines, signatures, headings, table headers), `n` named by the
|
|
42
|
+
* intent or the conversation, `c` context (a neighbour of a chosen line, or a lone gap filled). Hidden: `b` ranked
|
|
43
|
+
* below the cutoff or past the budget, `r` seen in an earlier call, `f` folded by structure (an outline body, a doc
|
|
44
|
+
* section, test-run noise, dump rows). `-` unknown.
|
|
45
|
+
*/
|
|
46
|
+
export type SpotlightReason = "a" | "s" | "n" | "c" | "b" | "r" | "f" | "-";
|
|
47
|
+
/** Whether a {@link SpotlightReason} shows the line. */
|
|
48
|
+
export declare function reasonShows(reason: SpotlightReason): boolean;
|
|
49
|
+
/** The reason for original line `i` (0-based), or undefined past the trace or without one. */
|
|
50
|
+
export declare function reasonAt(why: string | undefined, i: number): SpotlightReason | undefined;
|
|
51
|
+
/**
|
|
52
|
+
* The ranking of the step that cut by rank ({@link SpotlightOriginal.rank}): a line's score is the sum of its parts,
|
|
53
|
+
* and the step kept the best lines while its budget lasted.
|
|
54
|
+
*/
|
|
55
|
+
export interface SpotlightRank {
|
|
56
|
+
/**
|
|
57
|
+
* The parts a score adds up, in order, each in [0, 1] (shaping writes one; older traces may carry two, the ranks of
|
|
58
|
+
* `Spotlight` and of `word overlap`).
|
|
59
|
+
*/
|
|
60
|
+
parts: string[];
|
|
61
|
+
/** The highest score a line can reach. */
|
|
62
|
+
max: number;
|
|
63
|
+
/** Per part, its value on every original line over the span {@link SpotlightOriginal.heat} covers ({@link encodeRankPart}). */
|
|
64
|
+
values: string[];
|
|
65
|
+
/** The lowest score the step kept on rank. */
|
|
66
|
+
cutoff: number;
|
|
67
|
+
/** Characters the step could show, and how many it showed; absent for a step with no character budget. */
|
|
68
|
+
budget?: number;
|
|
69
|
+
used?: number;
|
|
70
|
+
/** The last line kept on rank (1-based position in the original) and the characters it cost. */
|
|
71
|
+
last?: {
|
|
72
|
+
line: number;
|
|
73
|
+
chars: number;
|
|
74
|
+
};
|
|
75
|
+
}
|
|
76
|
+
/** One {@link SpotlightRank.values} entry: two base-36 digits per line, each value relative to `max`. */
|
|
77
|
+
export declare function encodeRankPart(values: readonly number[], max: number): string;
|
|
78
|
+
/** The value of original line `i` (0-based) in an {@link encodeRankPart} string; 0 past its end. */
|
|
79
|
+
export declare function rankPartAt(encoded: string, i: number, max: number): number;
|
|
80
|
+
/**
|
|
81
|
+
* What a result's Spotlight requests sent besides the output lines they ranked (`POST /v1/spotlight`): the agent's
|
|
82
|
+
* state at the call, the command that produced the output, the question its lines were ranked under, and the model.
|
|
83
|
+
*/
|
|
84
|
+
export interface SpotlightRequestParams {
|
|
85
|
+
/** The user's first message of the session. */
|
|
86
|
+
task: string;
|
|
87
|
+
/** Up to three earlier bash commands of the session, oldest first. */
|
|
88
|
+
commands: string[];
|
|
89
|
+
/** The agent's text before the call. */
|
|
90
|
+
said: string;
|
|
91
|
+
/** The call's intent argument. */
|
|
92
|
+
intent: string;
|
|
93
|
+
/** The command, code or `read <path>` that produced the output. */
|
|
94
|
+
source: string;
|
|
95
|
+
/** The probe the lines were ranked under: Spotlight scores each line's relevance to the agent's current call. */
|
|
96
|
+
probe: string;
|
|
97
|
+
model: string;
|
|
98
|
+
thinking: string;
|
|
99
|
+
}
|
|
100
|
+
/** `details.spotlight`: one tool result as shaping left it. */
|
|
101
|
+
export interface SpotlightDetails {
|
|
102
|
+
tool: string;
|
|
103
|
+
/** The shaping steps that ran (`outline`, `window`, …; `none` for a passthrough). */
|
|
104
|
+
steps: string[];
|
|
105
|
+
inChars: number;
|
|
106
|
+
outChars: number;
|
|
107
|
+
/** o200k tokens of the original and of the text the model saw. */
|
|
108
|
+
inTokens: number;
|
|
109
|
+
outTokens: number;
|
|
110
|
+
/**
|
|
111
|
+
* Size of the plain (unshaped) result for the same call (a spilled output's capped text, a read's page), notices
|
|
112
|
+
* included. Absent on traces written before pi recorded it.
|
|
113
|
+
*/
|
|
114
|
+
plainChars?: number;
|
|
115
|
+
plainTokens?: number;
|
|
116
|
+
/**
|
|
117
|
+
* `plainTokens - outTokens` for a changed (or held-out) result, else 0: negative for a column-cap cut longer than
|
|
118
|
+
* the preview it replaced. On older traces `inTokens - outTokens`.
|
|
119
|
+
*/
|
|
120
|
+
savedTokens: number;
|
|
121
|
+
/** The score-free coin skipped Spotlight: the result was shaped by the no-score rules. Absent otherwise. */
|
|
122
|
+
scoreFree?: boolean;
|
|
123
|
+
/**
|
|
124
|
+
* The cut saved too few tokens against the plain result to apply, so the model got the plain text (`steps` ends
|
|
125
|
+
* with `plain-cap`, the out sizes are the plain text's): the would-be cut's size. Absent otherwise.
|
|
126
|
+
*/
|
|
127
|
+
cappedChars?: number;
|
|
128
|
+
cappedTokens?: number;
|
|
129
|
+
/**
|
|
130
|
+
* Shaping would have changed the text, but the result was held out at random: the model saw the plain result. The
|
|
131
|
+
* sizes, steps and {@link original} describe the would-be cut. Absent otherwise.
|
|
132
|
+
*/
|
|
133
|
+
holdout?: boolean;
|
|
134
|
+
/**
|
|
135
|
+
* Transcripts from before the edit gate was removed: the gate kept a read pi guessed the agent would edit whole, and
|
|
136
|
+
* the model got the plain page. Like {@link holdout}, the sizes, steps and {@link original} describe the would-be
|
|
137
|
+
* cut, but `savedTokens` is 0. pi no longer writes it.
|
|
138
|
+
*/
|
|
139
|
+
gated?: boolean;
|
|
140
|
+
/** Present only when shaping changed the text, or would have ({@link holdout}, {@link gated}). */
|
|
141
|
+
original?: SpotlightOriginal;
|
|
142
|
+
/** Present with {@link original} when Spotlight ranked the result's lines. */
|
|
143
|
+
request?: SpotlightRequestParams;
|
|
144
|
+
}
|
|
145
|
+
/**
|
|
146
|
+
* Tokens the shaped text saves against the plain result (negative: it costs more), or against the original on
|
|
147
|
+
* traces without {@link SpotlightDetails.plainTokens}.
|
|
148
|
+
*/
|
|
149
|
+
export declare function spotlightSaving(spotlight: SpotlightDetails): number;
|
|
150
|
+
/** The trace a result's details carry, or undefined when the experiment did not shape it. */
|
|
151
|
+
export declare function spotlightDetails(details: unknown): SpotlightDetails | undefined;
|
|
152
|
+
/** The {@link SpotlightOriginal.heat} of per-line scores: each relative to the best, in ten steps. */
|
|
153
|
+
export declare function encodeHeat(scores: readonly (number | null)[]): string;
|
|
154
|
+
/** The heat of original line `i` (0-based) in [0, 1], or undefined when Spotlight never scored it. */
|
|
155
|
+
export declare function heatAt(heat: string, i: number): number | undefined;
|
|
156
|
+
/** {@link SpotlightOriginal.kept} of a per-line kept mask. */
|
|
157
|
+
export declare function keptRanges(kept: readonly boolean[]): [number, number][];
|
|
158
|
+
/** Whether original line `i` (0-based) scored hot: a heat digit of {@link HOT_DIGIT} or more. */
|
|
159
|
+
export declare function spotlightHot(heat: string, i: number): boolean;
|
|
160
|
+
/**
|
|
161
|
+
* The tone the sheet and the notice give original line `i` (0-based): why shaping showed it (`accent` score,
|
|
162
|
+
* `neutral` structure, `user` named, `info` context), `error` for a hidden line that scored hot; undefined for any
|
|
163
|
+
* other hidden line and for a line without a reason.
|
|
164
|
+
*/
|
|
165
|
+
export declare function spotlightTone(original: SpotlightOriginal, i: number): TspTone | undefined;
|
|
166
|
+
/**
|
|
167
|
+
* The hover card of a changed result's notice: its heat as at most {@link NOTICE_BARS} bars (each the hottest of its
|
|
168
|
+
* lines, tinted by the most notable reason among them), then how many lines the model was shown, or of a held-out
|
|
169
|
+
* result would have been.
|
|
170
|
+
*/
|
|
171
|
+
export declare function spotlightNoticeCard(original: SpotlightOriginal, heldOut?: boolean): TspPropNode;
|
|
172
|
+
/**
|
|
173
|
+
* The notice row under one tool card (role `zeta.tool.spotlight`, key `spotlight:<toolCallId>`): muted for a
|
|
174
|
+
* passthrough (its star alone, named by its tooltip) and for a held-out result, accent for a changed result
|
|
175
|
+
* ({@link noticeSpans}). One with an original (changed or held out) has a hover card charting its heat
|
|
176
|
+
* ({@link spotlightNoticeCard}) and a click that opens its sheet through the host's transcript actions. A native
|
|
177
|
+
* transcript block of its own, placed right after its card ({@link Component.nativeTrailers}), so it shows while the
|
|
178
|
+
* card is collapsed; nothing in the terminal rows.
|
|
179
|
+
*/
|
|
180
|
+
export declare class SpotlightNotice implements Component {
|
|
181
|
+
#private;
|
|
182
|
+
constructor(toolCallId: string, spotlight: SpotlightDetails, reduced: string);
|
|
183
|
+
update(spotlight: SpotlightDetails, reduced: string): void;
|
|
184
|
+
/** Hidden with its card (tool activity hidden). */
|
|
185
|
+
setHidden(hidden: boolean): void;
|
|
186
|
+
describe(): NativeNode;
|
|
187
|
+
/** Never mounted in the terminal rows. */
|
|
188
|
+
render(): readonly string[];
|
|
189
|
+
invalidate(): void;
|
|
190
|
+
handleNativeEvent(event: NativeUiEvent): void;
|
|
191
|
+
}
|
|
192
|
+
/** The notices of one transcript block's calls, in the order the calls first reported a trace. */
|
|
193
|
+
export declare class SpotlightNotices {
|
|
194
|
+
#private;
|
|
195
|
+
/** Records call `toolCallId`'s final result; true when a notice appeared or went. */
|
|
196
|
+
set(toolCallId: string, details: unknown, reduced: string): boolean;
|
|
197
|
+
setHidden(hidden: boolean): void;
|
|
198
|
+
/**
|
|
199
|
+
* The notice blocks, the same array while none came or went; `shown` drops the notices of calls a
|
|
200
|
+
* transcript presenter hides (a fresh array then).
|
|
201
|
+
*/
|
|
202
|
+
list(shown?: (toolCallId: string) => boolean): readonly Component[];
|
|
203
|
+
}
|
|
@@ -11,11 +11,18 @@ export interface ToolExecutionUi {
|
|
|
11
11
|
requestComponentRender(component: Component): void;
|
|
12
12
|
resetDisplay(): void;
|
|
13
13
|
imageBudget?: TUI["imageBudget"];
|
|
14
|
+
showOverlay?: TUI["showOverlay"];
|
|
15
|
+
setFocus?: TUI["setFocus"];
|
|
16
|
+
terminal?: {
|
|
17
|
+
readonly rows: number;
|
|
18
|
+
};
|
|
14
19
|
}
|
|
15
20
|
export interface ToolExecutionOptions {
|
|
16
21
|
showImages?: boolean;
|
|
17
22
|
/** Allow the name-keyed renderer registry only when the active tool is the built-in implementation. */
|
|
18
23
|
useBuiltInRenderer?: boolean;
|
|
24
|
+
/** Ask the extension transcript presenters; false for a replayed transcript (overlays). Default: true. */
|
|
25
|
+
transcriptPresenters?: boolean;
|
|
19
26
|
}
|
|
20
27
|
/** A tool result or progress frame as a card shows it. */
|
|
21
28
|
export interface ToolResultFrame {
|
|
@@ -59,21 +66,25 @@ export declare function isSettledJobFrame(details: unknown): boolean;
|
|
|
59
66
|
* a cancelled one keeps the output it got to and seals the card as cancelled.
|
|
60
67
|
*/
|
|
61
68
|
export declare function settleWithJobFrame(component: ToolExecutionHandle, frame: ToolResultFrame, toolCallId: string): void;
|
|
62
|
-
/** Phase-locked spinner glyph index shared by every live tool block so parallel
|
|
63
|
-
* spinners advance in lockstep instead of each tracking its own start time. */
|
|
64
|
-
export declare function sharedSpinnerFrame(frameCount: number, now?: number): number;
|
|
65
69
|
/** Stop the shared spinner ticker and drop every registered live block.
|
|
66
70
|
* Called on interactive-mode teardown so a stray live block cannot keep the
|
|
67
|
-
* process-wide
|
|
71
|
+
* process-wide spinner timer alive past shutdown (lingering event-loop
|
|
68
72
|
* handles pin the process; cf. `postmortem.quit`). Test files that assert on
|
|
69
73
|
* ticker arming also use this to start from a clean slate. */
|
|
70
74
|
export declare function stopSharedSpinnerTicker(): void;
|
|
75
|
+
/** Whether the shared spinner ticker has a tick armed. Test seam: other timers on a fake clock
|
|
76
|
+
* (collab relay heartbeats) make a raw timer count ambiguous. */
|
|
77
|
+
export declare function sharedSpinnerTickerArmed(): boolean;
|
|
71
78
|
/**
|
|
72
79
|
* Component that renders a tool call with its result (updateable)
|
|
73
80
|
*/
|
|
74
81
|
export declare class ToolExecutionComponent extends Container {
|
|
75
82
|
#private;
|
|
76
83
|
constructor(toolName: string, args: unknown, options: ToolExecutionOptions | undefined, tool: AgentTool | undefined, ui: ToolExecutionUi, _cwd?: string, toolCallId?: string);
|
|
84
|
+
/** Handle exactly the shared native action vocabulary; inspector uses this same controller. */
|
|
85
|
+
shellVizAction(action: string): void;
|
|
86
|
+
/** Open the focused inspector without intercepting composer input while it is closed. */
|
|
87
|
+
openShellVisualizer(): void;
|
|
77
88
|
updateArgs(args: unknown, _toolCallId?: string): void;
|
|
78
89
|
/**
|
|
79
90
|
* Signal that args are complete (tool is about to execute).
|
|
@@ -146,6 +157,16 @@ export declare class ToolExecutionComponent extends Container {
|
|
|
146
157
|
setExpanded(expanded: boolean): void;
|
|
147
158
|
/** Mirrors the card collapsed or expanded in the terminal, so `Ctrl+O` and native toggles share one state. */
|
|
148
159
|
handleNativeEvent(event: NativeUiEvent): void;
|
|
160
|
+
/**
|
|
161
|
+
* Blocks of their own right after the card: the result's Spotlight notice (visible while it is
|
|
162
|
+
* collapsed), and late diagnostics the card absorbed while a presenter compacts or hides it, so
|
|
163
|
+
* they stay visible.
|
|
164
|
+
*/
|
|
165
|
+
nativeTrailers(): readonly Component[];
|
|
166
|
+
refreshTranscriptPresentation(ids?: ReadonlySet<string>): boolean;
|
|
167
|
+
/** The streamed call's id changed (or an empty one was filled in): presenters see, and refresh by, the new one. */
|
|
168
|
+
renameToolCallId(toolCallId: string): void;
|
|
169
|
+
isTranscriptBlockCompact(): boolean;
|
|
149
170
|
/** Whether this call targets `filePath` (the late-diagnostics router matches with it). */
|
|
150
171
|
matchesPath(filePath: string): boolean;
|
|
151
172
|
/**
|
|
@@ -163,7 +184,7 @@ export declare class ToolExecutionComponent extends Container {
|
|
|
163
184
|
* `elapsed` timer in the head and terminal-local collapse clamped to the
|
|
164
185
|
* view's preview. Renderers without describe hooks (and extension tools
|
|
165
186
|
* with only render hooks) get the generic card. Hidden tool activity stays
|
|
166
|
-
* mounted so toggling it is one prop change.
|
|
187
|
+
* mounted so toggling it is one prop change; a presenter's answer applies on top.
|
|
167
188
|
*/
|
|
168
189
|
describe(cx?: DescribeContext): NativeNode;
|
|
169
190
|
/** Apply the transcript allocator's current viewport reservation. */
|
|
@@ -4,6 +4,7 @@
|
|
|
4
4
|
* the interactive host registers the one handler that runs omp's existing
|
|
5
5
|
* commands for them, so a click and the key binding take the same path.
|
|
6
6
|
*/
|
|
7
|
+
import type { SpotlightDetails } from "./spotlight.js";
|
|
7
8
|
export type TranscriptAction =
|
|
8
9
|
/** Retry the last failed turn (`app.retry`). */
|
|
9
10
|
{
|
|
@@ -26,6 +27,16 @@ export type TranscriptAction =
|
|
|
26
27
|
| {
|
|
27
28
|
readonly act: "copy";
|
|
28
29
|
readonly text: string;
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* Open the Spotlight sheet of a shaped tool result: its original beside `reduced`, the text the model saw (a
|
|
33
|
+
* held-out result's sheet shows the would-be text its trace's `shapedUrl` names instead).
|
|
34
|
+
*/
|
|
35
|
+
| {
|
|
36
|
+
readonly act: "spotlight";
|
|
37
|
+
readonly toolCallId: string;
|
|
38
|
+
readonly spotlight: SpotlightDetails;
|
|
39
|
+
readonly reduced: string;
|
|
29
40
|
};
|
|
30
41
|
type Handler = (action: TranscriptAction) => void;
|
|
31
42
|
/** Register (or clear, with `undefined`) the host's handler. */
|
|
@@ -79,8 +79,17 @@ export declare class TranscriptBrowser implements Component {
|
|
|
79
79
|
handleScrollKey(data: string): boolean;
|
|
80
80
|
scrollToTop(): void;
|
|
81
81
|
scrollToBottom(): void;
|
|
82
|
+
/** Whether the view shows the first body row. */
|
|
83
|
+
get atTop(): boolean;
|
|
84
|
+
/** One past the last logical body row in view. */
|
|
85
|
+
get visibleEnd(): number;
|
|
82
86
|
/** Whether an anchor identity has successfully been applied to the viewport. */
|
|
83
87
|
hasAnchored(id: string): boolean;
|
|
88
|
+
/**
|
|
89
|
+
* What to add to a body row of the last frame to get its logical body row, as
|
|
90
|
+
* {@link toContentPoint} maps it; it follows the scroll, so a content row keeps its sum.
|
|
91
|
+
*/
|
|
92
|
+
get frameRowOffset(): number;
|
|
84
93
|
/**
|
|
85
94
|
* Translate a 0-based frame mouse point into the logical, scrolled body.
|
|
86
95
|
* Returns undefined for borders, header/footer rows, and unpainted body rows.
|