Files
Netcatty/components/terminal/runtime/terminalLinkHandler.ts
T
陈大猫andCodex b6bff4df6b feat(browser): browse host services from terminal side panels (#3701)
* Codex worktree snapshot: startup-cleanup

Co-authored-by: Codex

* fix(browser): close malformed proxy connections without a reply

* feat(browser): embed host browsing in terminal side panels

* style(browser): blend compact browser chrome into terminal panels

* feat(browser): open terminal links internally with a system browser preference

* fix(browser): retain the first terminal link during panel mount replay

* fix(browser): release contexts when their split pane closes

* style(browser): remove the downloads panel shadow

* fix(browser): ignore late downloads after panel closure

* fix(browser): mount browser content on terminal auto-open

* fix(browser): preserve empty-vault recovery with bookmarks

* fix(browser): expose actions for supported terminal types

* fix(browser): retain open requests before the panel mounts

* fix(browser): align vault actions with supported hosts

* fix(browser): share download controls across host contexts

* fix(browser): keep vault browser requests on visible sessions

* fix(browser): release contexts after workspace detach

* fix(browser): enforce WebRTC routing on page contents

* fix(browser): skip unsupported sessions in open requests

* style(browser): encode glyphs in ASCII-safe source
2026-10-17 02:26:36 +08:00

73 lines
2.0 KiB
TypeScript

export type TerminalLinkClickEvent = Pick<
MouseEvent,
"altKey" | "ctrlKey" | "metaKey" | "shiftKey"
>;
export type TerminalLinkHandlerOptions = {
canActivate: (event: TerminalLinkClickEvent) => boolean;
openExternalAvailable: () => boolean;
openExternal: (uri: string) => Promise<void>;
openInternal?: (uri: string) => Promise<void> | void;
useInternal?: () => boolean;
confirmOscLink: (uri: string) => boolean;
openWindow?: (uri: string) => unknown;
onError?: (error: unknown) => void;
warn?: (...args: unknown[]) => void;
};
export type TerminalLinkHandler = {
activate: (event: TerminalLinkClickEvent, uri: string) => void;
activateOsc: (event: TerminalLinkClickEvent, uri: string) => void;
open: (uri: string) => Promise<void>;
};
export function createTerminalLinkHandler(
options: TerminalLinkHandlerOptions,
): TerminalLinkHandler {
const warn = options.warn ?? console.warn;
const open = async (uri: string): Promise<void> => {
if (!/^https?:\/\//iu.test(String(uri || ""))) {
warn("[XTerm] Refusing to open non-http(s) link:", uri);
return;
}
try {
if (options.openInternal && (options.useInternal?.() ?? true)) {
await options.openInternal(uri);
return;
}
if (options.openExternalAvailable()) {
await options.openExternal(uri);
return;
}
(options.openWindow ?? ((url) => window.open(
url,
"_blank",
"noopener,noreferrer",
)))(uri);
} catch (error) {
warn("[XTerm] Failed to open terminal link:", error);
options.onError?.(error);
}
};
return {
activate(event, uri) {
if (!options.canActivate(event)) return;
void open(uri);
},
activateOsc(event, uri) {
if (!options.canActivate(event)) return;
if (!/^https?:\/\//iu.test(String(uri || ""))) {
warn("[XTerm] Refusing to open non-http(s) link:", uri);
return;
}
if (!options.confirmOscLink(uri)) return;
void open(uri);
},
open,
};
}