@linxiraos/pi-tui 1.4.6 → 1.4.7
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 +194 -195
- package/README.md +34 -34
- package/dist/types/app-keybindings.d.ts +15 -0
- package/dist/types/apps/session-picker.d.ts +5 -0
- package/dist/types/charts/chart-plan.d.ts +9 -7
- package/dist/types/chat/assistant-message.d.ts +15 -3
- package/dist/types/chat/bash-execution.d.ts +2 -0
- package/dist/types/chat/display-preferences.d.ts +2 -0
- package/dist/types/chat/extension-types.d.ts +31 -0
- package/dist/types/chat/reply-write.d.ts +48 -0
- package/dist/types/chat/table-chart.d.ts +4 -3
- package/dist/types/chat/tool-execution.d.ts +1 -2
- package/dist/types/chat/transcript-outline.d.ts +7 -0
- package/dist/types/chat/transcript-render-helpers.d.ts +2 -0
- package/dist/types/chrome/index.d.ts +1 -0
- package/dist/types/chrome/transcript-notice.d.ts +35 -0
- package/dist/types/chrome/transcript-status.d.ts +20 -8
- package/dist/types/components/editor.d.ts +8 -0
- package/dist/types/components/markdown.d.ts +7 -0
- package/dist/types/native/blobs.d.ts +2 -1
- package/dist/types/native/picker.d.ts +4 -4
- package/dist/types/overlays/annotation-overlay.d.ts +7 -1
- package/dist/types/overlays/annotation-types.d.ts +28 -0
- package/dist/types/overlays/login-dialog.d.ts +5 -1
- package/dist/types/overlays/model-browser.d.ts +10 -1
- package/dist/types/overlays/oauth-selector.d.ts +23 -0
- package/dist/types/overlays/plan-review-overlay.d.ts +2 -0
- package/dist/types/overlays/rewind-selector.d.ts +1 -1
- package/dist/types/overlays/session-selector.d.ts +22 -2
- package/dist/types/prompt/composer.d.ts +43 -0
- package/dist/types/prompt/interactive-context-helpers.d.ts +10 -3
- package/dist/types/render/extension-links.d.ts +65 -0
- package/dist/types/render/hyperlink.d.ts +25 -7
- package/dist/types/render/index.d.ts +1 -0
- package/dist/types/setup/scenes/glyph.d.ts +1 -1
- package/dist/types/setup/scenes/model.d.ts +1 -1
- package/dist/types/setup/scenes/outro.d.ts +5 -4
- package/dist/types/setup/scenes/sign-in.d.ts +13 -8
- package/dist/types/setup/scenes/types.d.ts +16 -1
- package/dist/types/setup/startup-splash.d.ts +1 -1
- package/dist/types/setup/wizard-overlay.d.ts +11 -7
- package/dist/types/setup/wizard.d.ts +5 -1
- package/dist/types/status-line/component.d.ts +1 -1
- package/dist/types/status-line/context-usage.d.ts +28 -6
- package/dist/types/status-line/host.d.ts +6 -2
- package/dist/types/theme/theme.d.ts +0 -23
- package/dist/types/tools/bash-interactive.d.ts +6 -0
- package/dist/types/tools/bash.d.ts +2 -0
- package/dist/types/tools/default-renderer.d.ts +6 -4
- package/dist/types/tools/irc.d.ts +6 -0
- package/dist/types/tools/json-tree.d.ts +23 -4
- package/dist/types/tools/lsp.d.ts +2 -0
- package/dist/types/tools/mcp.d.ts +6 -5
- package/dist/types/tools/native-view.d.ts +1 -1
- package/dist/types/tools/renderer.d.ts +2 -0
- package/dist/types/tools/streaming-output.d.ts +11 -0
- package/dist/types/tools/task.d.ts +9 -1
- package/dist/types/tools/url-scheme-host.d.ts +17 -0
- package/dist/types/tools/yield.d.ts +1 -1
- package/dist/types/tui.d.ts +7 -2
- package/package.json +10 -14
- package/src/app-keybindings.d.ts +15 -0
- package/src/app-keybindings.ts +15 -0
- package/src/apps/session-picker.ts +7 -0
- package/src/charts/chart-plan.d.ts +9 -7
- package/src/charts/chart-plan.ts +20 -50
- package/src/chat/advisor-message.ts +2 -0
- package/src/chat/assistant-message.d.ts +15 -3
- package/src/chat/assistant-message.ts +137 -19
- package/src/chat/background-tan-message.ts +4 -0
- package/src/chat/bash-execution.d.ts +2 -0
- package/src/chat/bash-execution.ts +6 -0
- package/src/chat/chat-transcript-builder.ts +58 -28
- package/src/chat/compaction-summary-message.ts +2 -1
- package/src/chat/display-preferences.d.ts +2 -0
- package/src/chat/display-preferences.ts +3 -0
- package/src/chat/extension-types.d.ts +31 -0
- package/src/chat/extension-types.ts +34 -0
- package/src/chat/reply-write.d.ts +48 -0
- package/src/chat/reply-write.ts +127 -0
- package/src/chat/table-chart.d.ts +4 -3
- package/src/chat/table-chart.ts +10 -4
- package/src/chat/tool-execution.d.ts +1 -2
- package/src/chat/tool-execution.ts +20 -13
- package/src/chat/transcript-outline.d.ts +7 -0
- package/src/chat/transcript-outline.ts +27 -0
- package/src/chat/transcript-render-helpers.d.ts +2 -0
- package/src/chat/transcript-render-helpers.ts +66 -24
- package/src/chrome/index.ts +1 -0
- package/src/chrome/transcript-notice.d.ts +35 -0
- package/src/chrome/transcript-notice.ts +83 -0
- package/src/chrome/transcript-status.d.ts +20 -8
- package/src/chrome/transcript-status.ts +29 -29
- package/src/components/editor.d.ts +8 -0
- package/src/components/editor.ts +10 -1
- package/src/components/markdown.d.ts +7 -0
- package/src/components/markdown.ts +116 -6
- package/src/hotkeys-markdown.ts +1 -0
- package/src/native/backend.ts +5 -66
- package/src/native/blobs.d.ts +2 -1
- package/src/native/blobs.ts +3 -2
- package/src/native/picker.d.ts +4 -4
- package/src/native/picker.ts +4 -4
- package/src/overlays/advisor-config.ts +1 -10
- package/src/overlays/annotation-overlay.ts +125 -37
- package/src/overlays/annotation-types.ts +24 -0
- package/src/overlays/hook-selector.ts +2 -2
- package/src/overlays/login-dialog.ts +31 -5
- package/src/overlays/mcp-add-wizard.ts +1 -1
- package/src/overlays/model-browser.ts +37 -0
- package/src/overlays/model-hub.ts +1 -7
- package/src/overlays/model-picker.ts +1 -10
- package/src/overlays/oauth-selector.ts +44 -6
- package/src/overlays/plan-review-overlay.ts +13 -2
- package/src/overlays/rewind-selector.ts +29 -12
- package/src/overlays/session-selector.ts +313 -42
- package/src/overlays/usage-dashboard.ts +5 -12
- package/src/prompt/composer.ts +216 -1
- package/src/prompt/custom-editor.ts +6 -1
- package/src/prompt/emoji-autocomplete.ts +0 -2
- package/src/prompt/interactive-context-helpers.ts +29 -4
- package/src/render/extension-links.d.ts +65 -0
- package/src/render/extension-links.ts +214 -0
- package/src/render/hyperlink.d.ts +25 -7
- package/src/render/hyperlink.ts +65 -9
- package/src/render/index.d.ts +1 -0
- package/src/render/index.ts +1 -0
- package/src/setup/scenes/composer.ts +2 -0
- package/src/setup/scenes/glyph.ts +3 -1
- package/src/setup/scenes/model.ts +192 -29
- package/src/setup/scenes/outro.ts +33 -15
- package/src/setup/scenes/sign-in.ts +196 -400
- package/src/setup/scenes/theme.ts +2 -0
- package/src/setup/scenes/types.ts +18 -1
- package/src/setup/startup-splash.ts +8 -7
- package/src/setup/wizard-overlay.ts +164 -35
- package/src/setup/wizard.ts +11 -2
- package/src/status-line/component.ts +4 -10
- package/src/status-line/context-usage.ts +72 -21
- package/src/status-line/host.ts +6 -2
- package/src/terminal.ts +24 -2
- package/src/theme/defaults.json +1 -0
- package/src/theme/loader.ts +1 -1
- package/src/theme/theme.d.ts +0 -23
- package/src/theme/theme.ts +2 -75
- package/src/tools/bash-interactive.d.ts +49 -0
- package/src/tools/bash-interactive.ts +6 -1
- package/src/tools/bash.d.ts +2 -0
- package/src/tools/bash.ts +2 -0
- package/src/tools/default-renderer.d.ts +6 -4
- package/src/tools/default-renderer.ts +9 -6
- package/src/tools/eval.ts +14 -4
- package/src/tools/irc.d.ts +6 -0
- package/src/tools/irc.ts +6 -0
- package/src/tools/job-widget.ts +13 -1
- package/src/tools/json-tree.d.ts +23 -4
- package/src/tools/json-tree.ts +132 -42
- package/src/tools/lsp.d.ts +2 -0
- package/src/tools/lsp.ts +36 -15
- package/src/tools/mcp.d.ts +6 -5
- package/src/tools/mcp.ts +20 -12
- package/src/tools/native-view.d.ts +1 -1
- package/src/tools/native-view.ts +1 -1
- package/src/tools/renderer.d.ts +2 -0
- package/src/tools/renderer.ts +2 -0
- package/src/tools/streaming-output.d.ts +11 -0
- package/src/tools/streaming-output.ts +41 -0
- package/src/tools/task.d.ts +9 -1
- package/src/tools/task.ts +59 -16
- package/src/tools/url-scheme-host.d.ts +17 -0
- package/src/tools/url-scheme-host.ts +21 -0
- package/src/tools/yield.d.ts +1 -1
- package/src/tools/yield.ts +18 -9
- package/src/tui.d.ts +7 -2
- package/src/tui.ts +43 -15
- package/dist/types/theme/defaults/index.d.ts +0 -10289
- package/src/theme/defaults/alabaster.json +0 -103
- package/src/theme/defaults/amethyst.json +0 -106
- package/src/theme/defaults/anthracite.json +0 -103
- package/src/theme/defaults/basalt.json +0 -101
- package/src/theme/defaults/birch.json +0 -105
- package/src/theme/defaults/dark-abyss.json +0 -101
- package/src/theme/defaults/dark-arctic.json +0 -114
- package/src/theme/defaults/dark-aurora.json +0 -105
- package/src/theme/defaults/dark-catppuccin.json +0 -117
- package/src/theme/defaults/dark-cavern.json +0 -101
- package/src/theme/defaults/dark-celestial.json +0 -116
- package/src/theme/defaults/dark-copper.json +0 -105
- package/src/theme/defaults/dark-cosmos.json +0 -100
- package/src/theme/defaults/dark-cyberpunk.json +0 -112
- package/src/theme/defaults/dark-dracula.json +0 -108
- package/src/theme/defaults/dark-eclipse.json +0 -101
- package/src/theme/defaults/dark-ember.json +0 -105
- package/src/theme/defaults/dark-equinox.json +0 -100
- package/src/theme/defaults/dark-forest.json +0 -106
- package/src/theme/defaults/dark-github.json +0 -115
- package/src/theme/defaults/dark-gruvbox.json +0 -122
- package/src/theme/defaults/dark-lavender.json +0 -105
- package/src/theme/defaults/dark-lunar.json +0 -99
- package/src/theme/defaults/dark-midnight.json +0 -105
- package/src/theme/defaults/dark-monochrome.json +0 -104
- package/src/theme/defaults/dark-monokai.json +0 -108
- package/src/theme/defaults/dark-nebula.json +0 -100
- package/src/theme/defaults/dark-neon-noir.json +0 -110
- package/src/theme/defaults/dark-nord.json +0 -108
- package/src/theme/defaults/dark-ocean.json +0 -111
- package/src/theme/defaults/dark-one.json +0 -110
- package/src/theme/defaults/dark-poimandres.json +0 -125
- package/src/theme/defaults/dark-rainforest.json +0 -101
- package/src/theme/defaults/dark-reef.json +0 -101
- package/src/theme/defaults/dark-retro.json +0 -102
- package/src/theme/defaults/dark-rose-pine.json +0 -106
- package/src/theme/defaults/dark-sakura.json +0 -105
- package/src/theme/defaults/dark-slate.json +0 -105
- package/src/theme/defaults/dark-solarized.json +0 -107
- package/src/theme/defaults/dark-solstice.json +0 -100
- package/src/theme/defaults/dark-starfall.json +0 -101
- package/src/theme/defaults/dark-sunset.json +0 -109
- package/src/theme/defaults/dark-swamp.json +0 -100
- package/src/theme/defaults/dark-synthwave.json +0 -113
- package/src/theme/defaults/dark-taiga.json +0 -101
- package/src/theme/defaults/dark-terminal.json +0 -105
- package/src/theme/defaults/dark-tokyo-night.json +0 -111
- package/src/theme/defaults/dark-tundra.json +0 -101
- package/src/theme/defaults/dark-twilight.json +0 -101
- package/src/theme/defaults/dark-volcanic.json +0 -101
- package/src/theme/defaults/graphite.json +0 -102
- package/src/theme/defaults/index.d.ts +0 -10289
- package/src/theme/defaults/index.ts +0 -203
- package/src/theme/defaults/light-arctic.json +0 -117
- package/src/theme/defaults/light-aurora-day.json +0 -101
- package/src/theme/defaults/light-canyon.json +0 -101
- package/src/theme/defaults/light-catppuccin.json +0 -116
- package/src/theme/defaults/light-cirrus.json +0 -100
- package/src/theme/defaults/light-coral.json +0 -105
- package/src/theme/defaults/light-cyberpunk.json +0 -106
- package/src/theme/defaults/light-dawn.json +0 -100
- package/src/theme/defaults/light-dunes.json +0 -101
- package/src/theme/defaults/light-eucalyptus.json +0 -105
- package/src/theme/defaults/light-forest.json +0 -110
- package/src/theme/defaults/light-frost.json +0 -105
- package/src/theme/defaults/light-github.json +0 -125
- package/src/theme/defaults/light-glacier.json +0 -101
- package/src/theme/defaults/light-gruvbox.json +0 -118
- package/src/theme/defaults/light-haze.json +0 -100
- package/src/theme/defaults/light-honeycomb.json +0 -105
- package/src/theme/defaults/light-lagoon.json +0 -101
- package/src/theme/defaults/light-lavender.json +0 -105
- package/src/theme/defaults/light-meadow.json +0 -101
- package/src/theme/defaults/light-mint.json +0 -105
- package/src/theme/defaults/light-monochrome.json +0 -111
- package/src/theme/defaults/light-ocean.json +0 -109
- package/src/theme/defaults/light-one.json +0 -109
- package/src/theme/defaults/light-opal.json +0 -101
- package/src/theme/defaults/light-orchard.json +0 -101
- package/src/theme/defaults/light-paper.json +0 -105
- package/src/theme/defaults/light-poimandres.json +0 -125
- package/src/theme/defaults/light-prism.json +0 -100
- package/src/theme/defaults/light-retro.json +0 -108
- package/src/theme/defaults/light-sand.json +0 -105
- package/src/theme/defaults/light-savanna.json +0 -101
- package/src/theme/defaults/light-solarized.json +0 -112
- package/src/theme/defaults/light-soleil.json +0 -100
- package/src/theme/defaults/light-sunset.json +0 -109
- package/src/theme/defaults/light-synthwave.json +0 -108
- package/src/theme/defaults/light-tokyo-night.json +0 -121
- package/src/theme/defaults/light-wetland.json +0 -101
- package/src/theme/defaults/light-zenith.json +0 -99
- package/src/theme/defaults/limestone.json +0 -104
- package/src/theme/defaults/mahogany.json +0 -107
- package/src/theme/defaults/marble.json +0 -103
- package/src/theme/defaults/obsidian.json +0 -101
- package/src/theme/defaults/onyx.json +0 -101
- package/src/theme/defaults/pearl.json +0 -103
- package/src/theme/defaults/porcelain.json +0 -101
- package/src/theme/defaults/quartz.json +0 -106
- package/src/theme/defaults/sandstone.json +0 -105
- package/src/theme/defaults/titanium.json +0 -100
|
@@ -0,0 +1,214 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Links whose scheme an extension registered (`pi.registerLinkScheme`). Markdown draws them
|
|
3
|
+
* without the ` (url)` suffix. In a plain terminal the rendered row carries an OSC 8 marker with the
|
|
4
|
+
* URL so a click's cell or a hint tag can be traced back to it ({@link extensionLinkLabels}); the TUI
|
|
5
|
+
* strips that marker from every row it writes ({@link stripExtensionLinkMarkers}), so the terminal
|
|
6
|
+
* never receives the link as a hyperlink it could open.
|
|
7
|
+
*/
|
|
8
|
+
import { isNativeRendering, onNativeRenderingChange } from "../native/state";
|
|
9
|
+
import { TERMINAL } from "../terminal-capabilities";
|
|
10
|
+
import { visibleWidth } from "../utils";
|
|
11
|
+
|
|
12
|
+
let schemes: ReadonlySet<string> = new Set();
|
|
13
|
+
let version = 0;
|
|
14
|
+
let pickingProvider: (() => boolean) | undefined;
|
|
15
|
+
// Tern's native view routes its own link clicks, so markers are drawn only for a plain terminal.
|
|
16
|
+
onNativeRenderingChange(() => {
|
|
17
|
+
version++;
|
|
18
|
+
});
|
|
19
|
+
|
|
20
|
+
/** One OSC 8 sequence (BEL or ST terminated); group 1 is its params, group 2 its URI (empty for a close). */
|
|
21
|
+
const OSC8_PATTERN = /\x1b\]8;([^;\x07\x1b]*);([^\x07\x1b]*)(?:\x07|\x1b\\)/g;
|
|
22
|
+
|
|
23
|
+
/**
|
|
24
|
+
* The OSC 8 params tagging omp's own markers, so they are stripped from terminal output even after
|
|
25
|
+
* their scheme is no longer registered. Each drawn link gets its own `-<n>` suffix, derived from the
|
|
26
|
+
* link itself so every render of the same text draws the same bytes; a label wrapped across rows
|
|
27
|
+
* repeats its marker, suffix included, on every row.
|
|
28
|
+
*/
|
|
29
|
+
const MARKER_ID = "id=omp-extension-link";
|
|
30
|
+
const MARKER_PARAMS_PATTERN = /^id=omp-extension-link(?:-\d+)?$/;
|
|
31
|
+
const MARKER_OPEN = `\x1b]8;${MARKER_ID}`;
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* Set the registered schemes (lowercase, without `:`). Bumps {@link extensionLinksVersion} on any
|
|
35
|
+
* change so cached markdown renders are redrawn.
|
|
36
|
+
*/
|
|
37
|
+
export function setExtensionLinks(next: Iterable<string>): void {
|
|
38
|
+
const nextSchemes = new Set(next);
|
|
39
|
+
if (nextSchemes.size === schemes.size && [...nextSchemes].every(s => schemes.has(s))) return;
|
|
40
|
+
schemes = nextSchemes;
|
|
41
|
+
version++;
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/** Changes whenever the scheme set changes; part of the markdown render cache key. */
|
|
45
|
+
export function extensionLinksVersion(): number {
|
|
46
|
+
return version;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/**
|
|
50
|
+
* Whether activating a registered-scheme link (a click or a hint tag) reaches its extension: a
|
|
51
|
+
* scheme is registered and the terminal is plain.
|
|
52
|
+
*/
|
|
53
|
+
export function extensionLinksRouted(): boolean {
|
|
54
|
+
return schemes.size > 0 && !isNativeRendering();
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
/**
|
|
58
|
+
* Set by the interactive product: whether the user has a way to pick a link drawn now (a bound
|
|
59
|
+
* hint key, mouse clicks). `undefined` when nothing in this process can pick one.
|
|
60
|
+
*/
|
|
61
|
+
export function setExtensionLinkPicking(provider: (() => boolean) | undefined): void {
|
|
62
|
+
pickingProvider = provider;
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/**
|
|
66
|
+
* Whether a registered-scheme link drawn now can be activated: links are routed and the product
|
|
67
|
+
* offers a way to pick them. Process-wide, so a UI-less extension runner (a subagent's, whose
|
|
68
|
+
* transcript the user may focus) answers like the interactive one.
|
|
69
|
+
*/
|
|
70
|
+
export function extensionLinkClicksAvailable(): boolean {
|
|
71
|
+
return extensionLinksRouted() && pickingProvider?.() === true;
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
/** The registered scheme `href` uses, or `undefined` for every other link. */
|
|
75
|
+
export function extensionLinkScheme(href: string): string | undefined {
|
|
76
|
+
if (schemes.size === 0) return undefined;
|
|
77
|
+
const colon = href.indexOf(":");
|
|
78
|
+
if (colon <= 0) return undefined;
|
|
79
|
+
const scheme = href.slice(0, colon).toLowerCase();
|
|
80
|
+
return schemes.has(scheme) ? scheme : undefined;
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
/** Dotted underline (`4:4`) where the terminal draws styled underlines, else the plain one. */
|
|
84
|
+
const UNDERLINE = TERMINAL.styledUnderlines
|
|
85
|
+
? { on: "\x1b[4:4m", off: "\x1b[4:0m" }
|
|
86
|
+
: { on: "\x1b[4m", off: "\x1b[24m" };
|
|
87
|
+
|
|
88
|
+
/** An SGR sequence; group 1 is its params. */
|
|
89
|
+
const SGR_PATTERN = /\x1b\[([0-9:;]*)m/g;
|
|
90
|
+
|
|
91
|
+
/** Whether an SGR with these params turns underlining off: a full reset, `24` or `4:0`. */
|
|
92
|
+
function endsUnderline(params: string): boolean {
|
|
93
|
+
const codes = params.split(";");
|
|
94
|
+
for (let index = 0; index < codes.length; index++) {
|
|
95
|
+
const code = codes[index]!;
|
|
96
|
+
if (code === "" || code === "0" || code === "24" || code === "4:0") return true;
|
|
97
|
+
// Skip a color's arguments: `38;5;n` / `38;2;r;g;b` (also 48 and 58), whose `0`s are no reset.
|
|
98
|
+
if (code === "38" || code === "48" || code === "58") {
|
|
99
|
+
const mode = codes[index + 1];
|
|
100
|
+
index += mode === "5" ? 2 : mode === "2" ? 4 : 0;
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
return false;
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
/**
|
|
107
|
+
* Draw an extension link's label: dotted-underlined (plain underline where the terminal has no
|
|
108
|
+
* styled underlines, re-applied after any style reset inside it) and wrapped in the OSC 8 marker
|
|
109
|
+
* {@link extensionLinkLabels} reads back in a plain terminal; as given in Tern's native view. Never
|
|
110
|
+
* followed by a ` (url)` suffix. `key` tells apart links of one URL drawn near each other; it must
|
|
111
|
+
* not change between renders of the same text, or rows rendered twice stop matching.
|
|
112
|
+
*/
|
|
113
|
+
export function formatExtensionLink(label: string, href: string, key: string): string {
|
|
114
|
+
if (isNativeRendering()) return label;
|
|
115
|
+
const safe = href.replaceAll("\x1b", "").replaceAll("\x07", "");
|
|
116
|
+
if (!safe) return label;
|
|
117
|
+
const body = label.replace(SGR_PATTERN, (sequence, params: string) =>
|
|
118
|
+
endsUnderline(params) ? sequence + UNDERLINE.on : sequence,
|
|
119
|
+
);
|
|
120
|
+
const id = Bun.hash.crc32(`${safe}\0${key}`);
|
|
121
|
+
return `${MARKER_OPEN}-${id};${safe}\x07${UNDERLINE.on}${body}${UNDERLINE.off}\x1b]8;;\x07`;
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
/** Hint tag letters, home row first. */
|
|
125
|
+
const LINK_HINT_ALPHABET = "asdfghjklqwertyuiopzxcvbnm";
|
|
126
|
+
|
|
127
|
+
/**
|
|
128
|
+
* Tags for `count` links in keyboard link-hint mode: single letters while they suffice, otherwise
|
|
129
|
+
* two letters each, so no tag is a prefix of another. At most the alphabet squared (676) are made;
|
|
130
|
+
* links past that stay untagged.
|
|
131
|
+
*/
|
|
132
|
+
export function linkHintTags(count: number): string[] {
|
|
133
|
+
if (count <= LINK_HINT_ALPHABET.length) return LINK_HINT_ALPHABET.slice(0, Math.max(0, count)).split("");
|
|
134
|
+
const tags: string[] = [];
|
|
135
|
+
for (const first of LINK_HINT_ALPHABET) {
|
|
136
|
+
for (const second of LINK_HINT_ALPHABET) {
|
|
137
|
+
if (tags.length === count) return tags;
|
|
138
|
+
tags.push(`${first}${second}`);
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
return tags;
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
/**
|
|
145
|
+
* `line` without omp's extension-link markers (the OSC 8 open and close around each label), for
|
|
146
|
+
* terminal output. Every other hyperlink is kept as is.
|
|
147
|
+
*/
|
|
148
|
+
export function stripExtensionLinkMarkers(line: string): string {
|
|
149
|
+
if (!line.includes(MARKER_OPEN)) return line;
|
|
150
|
+
let inside = false;
|
|
151
|
+
return line.replace(OSC8_PATTERN, (sequence: string, params: string, uri: string) => {
|
|
152
|
+
if (uri === "") {
|
|
153
|
+
const closesOwn = inside;
|
|
154
|
+
inside = false;
|
|
155
|
+
return closesOwn ? "" : sequence;
|
|
156
|
+
}
|
|
157
|
+
inside = MARKER_PARAMS_PATTERN.test(params);
|
|
158
|
+
return inside ? "" : sequence;
|
|
159
|
+
});
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
/** One extension link label drawn on a rendered row (before {@link stripExtensionLinkMarkers}). */
|
|
163
|
+
export interface ExtensionLinkLabel {
|
|
164
|
+
readonly url: string;
|
|
165
|
+
/**
|
|
166
|
+
* The marker's params, unique to each drawn link and repeated on every row a wrapped label
|
|
167
|
+
* spans, so a row's parts of one label can be told from an adjacent label of the same URL.
|
|
168
|
+
*/
|
|
169
|
+
readonly id: string;
|
|
170
|
+
/** First 0-based cell the label covers. */
|
|
171
|
+
readonly start: number;
|
|
172
|
+
/** Cell just past the label. */
|
|
173
|
+
readonly end: number;
|
|
174
|
+
/** Whether only blank cells follow the label on its row, so a wrapped label may go on below. */
|
|
175
|
+
readonly endsRow: boolean;
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
/**
|
|
179
|
+
* The extension link labels drawn on a rendered row, left to right. Only omp's own markers with a
|
|
180
|
+
* registered scheme match, so ordinary hyperlinks (even of a registered scheme) and rows drawn for
|
|
181
|
+
* a scheme that is no longer registered never do.
|
|
182
|
+
*/
|
|
183
|
+
export function extensionLinkLabels(line: string): ExtensionLinkLabel[] {
|
|
184
|
+
if (schemes.size === 0 || !line.includes(MARKER_OPEN)) return [];
|
|
185
|
+
const labels: ExtensionLinkLabel[] = [];
|
|
186
|
+
let x = 0;
|
|
187
|
+
let cursor = 0;
|
|
188
|
+
/** Code-unit index where the last pushed label's text ends. */
|
|
189
|
+
let lastClose = 0;
|
|
190
|
+
let open: { url: string; id: string; start: number } | undefined;
|
|
191
|
+
for (const match of line.matchAll(OSC8_PATTERN)) {
|
|
192
|
+
x += visibleWidth(line.slice(cursor, match.index));
|
|
193
|
+
if (open && x > open.start) {
|
|
194
|
+
labels.push({ ...open, end: x, endsRow: false });
|
|
195
|
+
lastClose = match.index;
|
|
196
|
+
}
|
|
197
|
+
open = undefined;
|
|
198
|
+
const params = match[1]!;
|
|
199
|
+
const uri = match[2]!;
|
|
200
|
+
cursor = match.index + match[0].length;
|
|
201
|
+
if (uri && MARKER_PARAMS_PATTERN.test(params) && extensionLinkScheme(uri)) {
|
|
202
|
+
open = { url: uri, id: params, start: x };
|
|
203
|
+
}
|
|
204
|
+
}
|
|
205
|
+
x += visibleWidth(line.slice(cursor));
|
|
206
|
+
if (open && x > open.start) {
|
|
207
|
+
labels.push({ ...open, end: x, endsRow: true });
|
|
208
|
+
} else {
|
|
209
|
+
const last = labels.at(-1);
|
|
210
|
+
if (last && Bun.stripANSI(line.slice(lastClose)).trim() === "")
|
|
211
|
+
labels[labels.length - 1] = { ...last, endsRow: true };
|
|
212
|
+
}
|
|
213
|
+
return labels;
|
|
214
|
+
}
|
|
@@ -1,14 +1,31 @@
|
|
|
1
1
|
import type { TspSpan } from "@linxiraos/pi-wire";
|
|
2
2
|
import { type TerminalId } from "../terminal-capabilities";
|
|
3
|
+
export interface FileLinkConfig {
|
|
4
|
+
scheme?: string;
|
|
5
|
+
host?: string;
|
|
6
|
+
}
|
|
7
|
+
interface FileUriOptions {
|
|
8
|
+
line?: number;
|
|
9
|
+
col?: number;
|
|
10
|
+
/** Native image open actions need a local file URL rather than a desktop handler. */
|
|
11
|
+
local?: boolean;
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
* Resolve the remote file-link configuration once at host startup. Passing an
|
|
15
|
+
* explicit object lets SDK hosts and tests configure links without changing the
|
|
16
|
+
* process environment; an empty object restores ordinary file links. An invalid
|
|
17
|
+
* scheme or host logs a warning and keeps ordinary links.
|
|
18
|
+
*/
|
|
19
|
+
export declare function applyFileLinkSetting(config?: FileLinkConfig): void;
|
|
3
20
|
/**
|
|
4
|
-
* A
|
|
21
|
+
* A file-link target for `filePath`, or `undefined` when Node cannot encode it.
|
|
5
22
|
*
|
|
6
23
|
* Node rejects a malformed UNC target (a UNC path escaped twice by its author,
|
|
7
24
|
* e.g. `\\\wsl.localhost\…`) with `ERR_INVALID_ARG_VALUE: Empty UNC servername`.
|
|
8
25
|
* A stored session keeps whatever a tool call recorded, so a transcript must
|
|
9
26
|
* render such a path without a link rather than throw while it rebuilds.
|
|
10
27
|
*/
|
|
11
|
-
export declare function tryFileUri(filePath: string): string | undefined;
|
|
28
|
+
export declare function tryFileUri(filePath: string, opts?: FileUriOptions): string | undefined;
|
|
12
29
|
/**
|
|
13
30
|
* Build the OSC 8 target for a file path on `terminalId`.
|
|
14
31
|
*
|
|
@@ -23,7 +40,8 @@ export declare function tryFileUri(filePath: string): string | undefined;
|
|
|
23
40
|
* The VS Code family instead navigates the documented
|
|
24
41
|
* `vscode://file/<path>:<line>:<col>` form. Everywhere else the plain `file:`
|
|
25
42
|
* URI is right, with the location left in the visible text — terminals that
|
|
26
|
-
* parse a `path:line:col` suffix resolve that on their own.
|
|
43
|
+
* parse a `path:line:col` suffix resolve that on their own. A configured custom
|
|
44
|
+
* handler takes precedence and receives optional `line`/`col` query parameters.
|
|
27
45
|
*
|
|
28
46
|
* Returns `undefined` when `filePath` cannot be encoded — a malformed UNC
|
|
29
47
|
* target on the `file:` branch, or a lone surrogate on the `vscode://` branch.
|
|
@@ -85,9 +103,8 @@ export declare function urlLinkSpan(target: string, displayText: string, s?: str
|
|
|
85
103
|
/** Whether native link spans and nodes may carry an `href`: everything but an explicit `off` policy. */
|
|
86
104
|
export declare function isNativeLinkEnabled(): boolean;
|
|
87
105
|
/**
|
|
88
|
-
* A native link span to a filesystem path
|
|
89
|
-
*
|
|
90
|
-
* text). Honours an explicit `off` policy.
|
|
106
|
+
* A native link span to a filesystem path using the configured file-link
|
|
107
|
+
* target. Honours an explicit `off` policy.
|
|
91
108
|
*/
|
|
92
109
|
export declare function fileLinkSpan(filePath: string, displayText: string, s?: string): TspSpan;
|
|
93
110
|
/**
|
|
@@ -101,9 +118,10 @@ export declare function fileLinkSpan(filePath: string, displayText: string, s?:
|
|
|
101
118
|
*
|
|
102
119
|
* @param filePath - Filesystem path
|
|
103
120
|
* @param displayText - Text to render as the hyperlink anchor (may contain ANSI codes)
|
|
104
|
-
* @param opts - Optional line/col position
|
|
121
|
+
* @param opts - Optional line/col position (custom handlers use query params; VS Code uses a path suffix)
|
|
105
122
|
*/
|
|
106
123
|
export declare function fileHyperlink(filePath: string, displayText: string, opts?: {
|
|
107
124
|
line?: number;
|
|
108
125
|
col?: number;
|
|
109
126
|
}): string;
|
|
127
|
+
export {};
|
package/src/render/hyperlink.ts
CHANGED
|
@@ -5,7 +5,9 @@
|
|
|
5
5
|
* sequences when the active terminal supports hyperlinks and the user setting
|
|
6
6
|
* permits it. Falls back to plain text when disabled.
|
|
7
7
|
*/
|
|
8
|
+
import * as os from "node:os";
|
|
8
9
|
import * as url from "node:url";
|
|
10
|
+
import { logger } from "@linxiraos/pi-utils";
|
|
9
11
|
import type { TspSpan } from "@linxiraos/pi-wire";
|
|
10
12
|
import { span } from "../native/describe";
|
|
11
13
|
import { setTerminalHyperlinks, TERMINAL, type TerminalId } from "../terminal-capabilities";
|
|
@@ -24,6 +26,52 @@ const DETECTED_TERMINAL_HYPERLINKS = TERMINAL.hyperlinks;
|
|
|
24
26
|
type HyperlinkMode = "off" | "auto" | "always";
|
|
25
27
|
let hyperlinkMode: HyperlinkMode = "auto";
|
|
26
28
|
|
|
29
|
+
export interface FileLinkConfig {
|
|
30
|
+
scheme?: string;
|
|
31
|
+
host?: string;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
interface FileUriOptions {
|
|
35
|
+
line?: number;
|
|
36
|
+
col?: number;
|
|
37
|
+
/** Native image open actions need a local file URL rather than a desktop handler. */
|
|
38
|
+
local?: boolean;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
let fileLinkTarget: { scheme: string; host: string } | undefined;
|
|
42
|
+
|
|
43
|
+
/** URI scheme syntax (RFC 3986 §3.1), matched after lowercasing. */
|
|
44
|
+
const FILE_LINK_SCHEME = /^[a-z][a-z0-9+.-]*$/;
|
|
45
|
+
/** A bare host name with an optional port: no userinfo, path, query, or whitespace that would reshape the URI. */
|
|
46
|
+
const FILE_LINK_HOST = /^[A-Za-z0-9._-]+(?::\d{1,5})?$/;
|
|
47
|
+
|
|
48
|
+
/**
|
|
49
|
+
* Resolve the remote file-link configuration once at host startup. Passing an
|
|
50
|
+
* explicit object lets SDK hosts and tests configure links without changing the
|
|
51
|
+
* process environment; an empty object restores ordinary file links. An invalid
|
|
52
|
+
* scheme or host logs a warning and keeps ordinary links.
|
|
53
|
+
*/
|
|
54
|
+
export function applyFileLinkSetting(
|
|
55
|
+
config: FileLinkConfig = {
|
|
56
|
+
scheme: Bun.env.ZETA_LINK_SCHEME,
|
|
57
|
+
host: Bun.env.ZETA_LINK_HOST,
|
|
58
|
+
},
|
|
59
|
+
): void {
|
|
60
|
+
fileLinkTarget = undefined;
|
|
61
|
+
if (!config.scheme) return;
|
|
62
|
+
const scheme = config.scheme.toLowerCase();
|
|
63
|
+
if (!FILE_LINK_SCHEME.test(scheme)) {
|
|
64
|
+
logger.warn("Invalid ZETA_LINK_SCHEME; using ordinary file links", { scheme: config.scheme });
|
|
65
|
+
return;
|
|
66
|
+
}
|
|
67
|
+
const host = config.host || os.hostname();
|
|
68
|
+
if (!FILE_LINK_HOST.test(host)) {
|
|
69
|
+
logger.warn("Invalid ZETA_LINK_HOST; using ordinary file links", { host });
|
|
70
|
+
return;
|
|
71
|
+
}
|
|
72
|
+
fileLinkTarget = { scheme, host };
|
|
73
|
+
}
|
|
74
|
+
|
|
27
75
|
/** Stable 8-char hex ID derived from a URI — hints terminals to coalesce identical adjacent links. */
|
|
28
76
|
function buildLinkId(uri: string): string {
|
|
29
77
|
let h = 0;
|
|
@@ -35,16 +83,24 @@ function buildLinkId(uri: string): string {
|
|
|
35
83
|
}
|
|
36
84
|
|
|
37
85
|
/**
|
|
38
|
-
* A
|
|
86
|
+
* A file-link target for `filePath`, or `undefined` when Node cannot encode it.
|
|
39
87
|
*
|
|
40
88
|
* Node rejects a malformed UNC target (a UNC path escaped twice by its author,
|
|
41
89
|
* e.g. `\\\wsl.localhost\…`) with `ERR_INVALID_ARG_VALUE: Empty UNC servername`.
|
|
42
90
|
* A stored session keeps whatever a tool call recorded, so a transcript must
|
|
43
91
|
* render such a path without a link rather than throw while it rebuilds.
|
|
44
92
|
*/
|
|
45
|
-
export function tryFileUri(filePath: string): string | undefined {
|
|
93
|
+
export function tryFileUri(filePath: string, opts?: FileUriOptions): string | undefined {
|
|
46
94
|
try {
|
|
47
|
-
|
|
95
|
+
const fileUrl = url.pathToFileURL(filePath);
|
|
96
|
+
if (!fileLinkTarget || opts?.local) return fileUrl.href;
|
|
97
|
+
// Preserve UNC servers so the handler can reconstruct the network path.
|
|
98
|
+
const targetPath = fileUrl.host ? `//${fileUrl.host}${fileUrl.pathname}` : fileUrl.pathname;
|
|
99
|
+
const position = new URLSearchParams();
|
|
100
|
+
if (opts?.line !== undefined) position.set("line", String(opts.line));
|
|
101
|
+
if (opts?.col !== undefined) position.set("col", String(opts.col));
|
|
102
|
+
const query = position.size ? `?${position}` : "";
|
|
103
|
+
return `${fileLinkTarget.scheme}://${fileLinkTarget.host}${targetPath}${query}`;
|
|
48
104
|
} catch {
|
|
49
105
|
return undefined;
|
|
50
106
|
}
|
|
@@ -64,7 +120,8 @@ export function tryFileUri(filePath: string): string | undefined {
|
|
|
64
120
|
* The VS Code family instead navigates the documented
|
|
65
121
|
* `vscode://file/<path>:<line>:<col>` form. Everywhere else the plain `file:`
|
|
66
122
|
* URI is right, with the location left in the visible text — terminals that
|
|
67
|
-
* parse a `path:line:col` suffix resolve that on their own.
|
|
123
|
+
* parse a `path:line:col` suffix resolve that on their own. A configured custom
|
|
124
|
+
* handler takes precedence and receives optional `line`/`col` query parameters.
|
|
68
125
|
*
|
|
69
126
|
* Returns `undefined` when `filePath` cannot be encoded — a malformed UNC
|
|
70
127
|
* target on the `file:` branch, or a lone surrogate on the `vscode://` branch.
|
|
@@ -74,7 +131,7 @@ export function fileUriForTerminal(
|
|
|
74
131
|
opts: { line?: number; col?: number } | undefined,
|
|
75
132
|
terminalId: TerminalId,
|
|
76
133
|
): string | undefined {
|
|
77
|
-
if (terminalId !== "vscode") return tryFileUri(filePath);
|
|
134
|
+
if (fileLinkTarget || terminalId !== "vscode") return tryFileUri(filePath, opts);
|
|
78
135
|
// vscode:// takes a filesystem path with forward slashes. Encode each
|
|
79
136
|
// segment independently so separators and a Windows drive colon stay
|
|
80
137
|
// structural while reserved bytes in file names cannot become URI syntax.
|
|
@@ -222,9 +279,8 @@ export function isNativeLinkEnabled(): boolean {
|
|
|
222
279
|
}
|
|
223
280
|
|
|
224
281
|
/**
|
|
225
|
-
* A native link span to a filesystem path
|
|
226
|
-
*
|
|
227
|
-
* text). Honours an explicit `off` policy.
|
|
282
|
+
* A native link span to a filesystem path using the configured file-link
|
|
283
|
+
* target. Honours an explicit `off` policy.
|
|
228
284
|
*/
|
|
229
285
|
export function fileLinkSpan(filePath: string, displayText: string, s = "path"): TspSpan {
|
|
230
286
|
if (hyperlinkMode === "off") return span(displayText, s);
|
|
@@ -244,7 +300,7 @@ export function fileLinkSpan(filePath: string, displayText: string, s = "path"):
|
|
|
244
300
|
*
|
|
245
301
|
* @param filePath - Filesystem path
|
|
246
302
|
* @param displayText - Text to render as the hyperlink anchor (may contain ANSI codes)
|
|
247
|
-
* @param opts - Optional line/col position
|
|
303
|
+
* @param opts - Optional line/col position (custom handlers use query params; VS Code uses a path suffix)
|
|
248
304
|
*/
|
|
249
305
|
export function fileHyperlink(filePath: string, displayText: string, opts?: { line?: number; col?: number }): string {
|
|
250
306
|
const uri = fileUriForTerminal(filePath, opts, TERMINAL.id);
|
package/src/render/index.d.ts
CHANGED
package/src/render/index.ts
CHANGED
|
@@ -155,6 +155,8 @@ class ComposerSceneController implements SetupSceneController {
|
|
|
155
155
|
export const composerSetupScene: SetupScene = {
|
|
156
156
|
id: "composer-shape",
|
|
157
157
|
title: "Choose composer shape",
|
|
158
|
+
step: "Composer",
|
|
158
159
|
minVersion: 2,
|
|
160
|
+
ansiOnly: true,
|
|
159
161
|
mount: host => new ComposerSceneController(host),
|
|
160
162
|
};
|
|
@@ -142,7 +142,7 @@ class GlyphSceneController implements SetupSceneController {
|
|
|
142
142
|
|
|
143
143
|
/**
|
|
144
144
|
* Preview and persist the terminal glyph preset. Skipped once the Glyph
|
|
145
|
-
* Protocol handshake confirmed the terminal renders
|
|
145
|
+
* Protocol handshake confirmed the terminal renders Zeta's bundled icons: every
|
|
146
146
|
* row renders cleanly there, and the default `unicode` preset already upgrades
|
|
147
147
|
* to nerd at runtime while staying safe on terminals without the protocol.
|
|
148
148
|
*/
|
|
@@ -151,7 +151,9 @@ export const glyphSetupScene: SetupScene = {
|
|
|
151
151
|
get title(): string {
|
|
152
152
|
return tuiText("setupGlyphTitle", "Choose glyph mode");
|
|
153
153
|
},
|
|
154
|
+
step: "Symbols",
|
|
154
155
|
minVersion: 1,
|
|
156
|
+
ansiOnly: true,
|
|
155
157
|
shouldRun: () => !TERMINAL.glyphProtocol,
|
|
156
158
|
mount: host => new GlyphSceneController(host),
|
|
157
159
|
};
|