@tulex-cli/tulex-code 0.1.1

package/dist/src/ui/utils/osc8.test.js

@@ -0,0 +1,494 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { HYPERLINK_ENV_KEYS, isSafeOscScheme, labelMayDeceive, osc8Close, osc8Hyperlink, osc8Open, sanitizeForOsc, supportsHyperlinks, trimTrailingUrlPunctuation, } from './osc8.js';
+const ESC = '\x1b';
+const BEL = '\x07';
+function clearHyperlinkEnv() {
+    for (const key of HYPERLINK_ENV_KEYS) {
+        delete process.env[key];
+    }
+}
+describe('osc8 helpers', () => {
+    const savedEnv = { ...process.env };
+    const savedIsTTY = process.stdout.isTTY;
+    const savedPlatform = process.platform;
+    beforeEach(() => {
+        // Start every test from a known baseline. supportsHyperlinks() has no
+        // memoization so a fresh env is enough.
+        process.env = { ...savedEnv };
+        clearHyperlinkEnv();
+        // Reset platform too so a prior test that flipped to win32 can't leak.
+        Object.defineProperty(process, 'platform', {
+            configurable: true,
+            value: savedPlatform,
+        });
+        // Symmetric isTTY reset — the early describes (sanitizer, scheme, trim)
+        // don't call setTTY() themselves, so without this they would inherit
+        // whatever the previous test left behind.
+        Object.defineProperty(process.stdout, 'isTTY', {
+            configurable: true,
+            value: savedIsTTY,
+        });
+    });
+    afterEach(() => {
+        process.env = { ...savedEnv };
+        Object.defineProperty(process.stdout, 'isTTY', {
+            configurable: true,
+            value: savedIsTTY,
+        });
+        Object.defineProperty(process, 'platform', {
+            configurable: true,
+            value: savedPlatform,
+        });
+    });
+    describe('sanitizeForOsc', () => {
+        it('strips C0 control bytes and DEL', () => {
+            expect(sanitizeForOsc('a\x00b\x07c\x1bd\x7fe')).toBe('abcde');
+        });
+        it('strips C1 control bytes (\\x80-\\x9f)', () => {
+            // \x9c is 8-bit ST and \x9d is 8-bit OSC — terminals that honor C1
+            // controls treat these as sequence boundaries, so they must not
+            // survive inside an OSC 8 target.
+            expect(sanitizeForOsc('a\x80b\x9cc\x9dd\x9fe')).toBe('abcde');
+        });
+        it('strips Unicode bidi controls (label spoofing)', () => {
+            // U+202E (RLO) in a link label would visually reverse the trailing
+            // bytes, letting `safe.com` render as a different host even though
+            // the OSC target is sanitized.
+            expect(sanitizeForOsc('safe.com\u202emoc.live')).toBe('safe.commoc.live');
+            // Every bidi control covered by the regex.
+            expect(sanitizeForOsc('a\u200eb\u200fc\u202ad\u202be\u202cf\u202dg\u202eh\u2066i\u2067j\u2068k\u2069l')).toBe('abcdefghijkl');
+        });
+        it('strips line / paragraph separators (envelope fracture)', () => {
+            // U+2028 / U+2029 are treated as line breaks inside an OSC payload
+            // by some terminals, fracturing the envelope.
+            expect(sanitizeForOsc('a\u2028b\u2029c')).toBe('abc');
+        });
+        it('keeps printable ASCII and unicode intact', () => {
+            expect(sanitizeForOsc('https://example.com/路径?q=v')).toBe('https://example.com/路径?q=v');
+        });
+    });
+    describe('osc8Hyperlink', () => {
+        it('emits the canonical OSC 8 envelope with BEL terminators', () => {
+            expect(osc8Hyperlink('https://example.com', 'click me')).toBe(`${ESC}]8;;https://example.com${BEL}click me${ESC}]8;;${BEL}`);
+        });
+        it('defaults the label to the url', () => {
+            expect(osc8Hyperlink('https://example.com')).toBe(`${ESC}]8;;https://example.com${BEL}https://example.com${ESC}]8;;${BEL}`);
+        });
+        it('strips embedded escapes so they cannot break out of the envelope', () => {
+            const malicious = `https://example.com${BEL}${ESC}]8;;evil${BEL}`;
+            const out = osc8Hyperlink(malicious, `lbl${ESC}[31m`);
+            // Exactly two ESC and two BEL bytes — the envelope's own terminators.
+            // eslint-disable-next-line no-control-regex
+            expect((out.match(/\x1b/g) ?? []).length).toBe(2);
+            // eslint-disable-next-line no-control-regex
+            expect((out.match(/\x07/g) ?? []).length).toBe(2);
+            expect(out).toContain('https://example.com]8;;evil');
+            expect(out).toContain('lbl[31m');
+        });
+        it('produces an envelope that composes from osc8Open + osc8Close', () => {
+            expect(osc8Open('https://x.test') + 'label' + osc8Close()).toBe(osc8Hyperlink('https://x.test', 'label'));
+        });
+    });
+    describe('isSafeOscScheme', () => {
+        it.each([
+            'http://example.com',
+            'https://example.com/path',
+            'HTTPS://example.com', // case-insensitive scheme
+            'mailto:user@example.com',
+            'ftp://example.com/file',
+            'ftps://example.com',
+            'sftp://host/path',
+            'ssh://host',
+        ])('allows %s', (url) => {
+            expect(isSafeOscScheme(url)).toBe(true);
+        });
+        it.each([
+            'javascript:alert(1)',
+            'JavaScript:alert(1)',
+            'data:text/html;base64,PHNjcmlwdD4=',
+            'vbscript:msgbox(1)',
+            'file:///etc/passwd',
+            'chrome://settings',
+            'about:blank',
+            // Relative / fragment / empty — no scheme at all.
+            '',
+            '#anchor',
+            '/relative/path',
+            './doc.html',
+            'just text',
+        ])('rejects %s', (url) => {
+            expect(isSafeOscScheme(url)).toBe(false);
+        });
+    });
+    describe('labelMayDeceive', () => {
+        it('flags labels containing a different URL than the target', () => {
+            // The classic spoof: label looks like one host, target is another.
+            expect(labelMayDeceive('https://google.com', 'https://attacker.com')).toBe(true);
+            expect(labelMayDeceive('Visit https://safe.com now', 'https://evil.com/x')).toBe(true);
+            // Scheme-only label still trips the heuristic — defensively
+            // permissive: a bare `mailto:` label that doesn't equal the URL is
+            // suspicious enough to keep the `(url)` suffix visible.
+            expect(labelMayDeceive('mailto:friend', 'mailto:other')).toBe(true);
+        });
+        it('does NOT flag when the label equals the target', () => {
+            const url = 'https://example.com/x';
+            expect(labelMayDeceive(url, url)).toBe(false);
+        });
+        it('flags bare-host labels whose host differs from the target', () => {
+            // The single most common click-deception shape in markdown — and one
+            // a careful attacker would prefer over a full `https://…` label,
+            // since it looks more natural. Must NOT escape the heuristic.
+            expect(labelMayDeceive('google.com', 'https://attacker.com')).toBe(true);
+            expect(labelMayDeceive('paypal.com', 'https://phish.example.org/login')).toBe(true);
+            // Punycode IDN attack — label `google.com`, target is the lookalike
+            // punycode host. Label host does not equal target host → flag.
+            expect(labelMayDeceive('google.com', 'https://xn--googl-fsa.com')).toBe(true);
+        });
+        it('does NOT flag bare-host labels that match the target', () => {
+            // Honest rendering: label is the same host the URL points to.
+            expect(labelMayDeceive('google.com', 'https://google.com/page')).toBe(false);
+            expect(labelMayDeceive('docs.example.com', 'https://docs.example.com/x')).toBe(false);
+        });
+        it('flags IPv4 literal labels whose host differs from the target', () => {
+            // `[1.1.1.1](https://attacker.com)` — common shape (Cloudflare DNS,
+            // Google DNS) the model might emit. Same click-deception class as a
+            // bare hostname but the alphabetic-TLD regex skips it, so a separate
+            // dotted-quad rule has to catch it.
+            expect(labelMayDeceive('1.1.1.1', 'https://attacker.com')).toBe(true);
+            expect(labelMayDeceive('192.168.1.1', 'https://evil.com')).toBe(true);
+            expect(labelMayDeceive('Click 8.8.8.8 here', 'https://evil.com')).toBe(true);
+        });
+        it('does NOT flag IPv4 literal labels that match the target', () => {
+            expect(labelMayDeceive('1.1.1.1', 'https://1.1.1.1/dns')).toBe(false);
+        });
+        it('does NOT flag email-style labels matching the mailto target', () => {
+            // `new URL('mailto:x@y').hostname` is empty; the implementation has to
+            // pull the host from after the `@` or every mailto link with a
+            // bare-email label would be falsely flagged.
+            expect(labelMayDeceive('support@example.com', 'mailto:support@example.com')).toBe(false);
+            // …but a mismatched mailto domain IS deceptive.
+            expect(labelMayDeceive('support@example.com', 'mailto:abuse@evil.com')).toBe(true);
+        });
+        it('flags same-host different-path labels', () => {
+            // `[https://google.com/safe](https://google.com/evil)` — same host but
+            // the label hides which path. The `://` pattern fires here and the
+            // user sees the real path in the `(url)` suffix.
+            expect(labelMayDeceive('https://google.com/safe', 'https://google.com/evil')).toBe(true);
+        });
+        it('does NOT flag plain-text or numeric labels', () => {
+            expect(labelMayDeceive('click here', 'https://example.com')).toBe(false);
+            expect(labelMayDeceive('docs', 'https://example.com')).toBe(false);
+            expect(labelMayDeceive('', 'https://example.com')).toBe(false);
+            // Version strings like `v1.2.3` are not host-like (last segment is
+            // digits, not alphabetic) so they don't trip the heuristic.
+            expect(labelMayDeceive('v1.2.3', 'https://example.com')).toBe(false);
+        });
+    });
+    describe('trimTrailingUrlPunctuation', () => {
+        it.each([
+            ['https://example.com.', 'https://example.com'],
+            ['https://example.com,', 'https://example.com'],
+            ['https://example.com!', 'https://example.com'],
+            ['https://example.com?q=1)', 'https://example.com?q=1'],
+            ['https://example.com:::', 'https://example.com'],
+            ['https://example.com).', 'https://example.com'],
+        ])('trims sentence punctuation: %s -> %s', (input, expected) => {
+            expect(trimTrailingUrlPunctuation(input)).toBe(expected);
+        });
+        it('preserves a trailing close-paren when balanced inside the URL', () => {
+            const url = 'https://en.wikipedia.org/wiki/Foo_(bar)';
+            expect(trimTrailingUrlPunctuation(url)).toBe(url);
+        });
+        it('trims a trailing `>` (CommonMark autolink delimiter)', () => {
+            expect(trimTrailingUrlPunctuation('https://example.com>')).toBe('https://example.com');
+        });
+        it('trims an unbalanced trailing close-paren', () => {
+            expect(trimTrailingUrlPunctuation('https://example.com/x)')).toBe('https://example.com/x');
+        });
+        it('returns the input unchanged when there is no trailing punctuation', () => {
+            expect(trimTrailingUrlPunctuation('https://example.com/x')).toBe('https://example.com/x');
+        });
+    });
+    describe('supportsHyperlinks', () => {
+        function setTTY(value) {
+            Object.defineProperty(process.stdout, 'isTTY', {
+                configurable: true,
+                value,
+            });
+        }
+        function setPlatform(value) {
+            Object.defineProperty(process, 'platform', {
+                configurable: true,
+                value,
+            });
+        }
+        it('returns false when stdout is not a TTY', () => {
+            setTTY(false);
+            process.env['TERM_PROGRAM'] = 'iTerm.app';
+            process.env['TERM_PROGRAM_VERSION'] = '3.5.0';
+            expect(supportsHyperlinks()).toBe(false);
+        });
+        it('returns false when NO_COLOR is set', () => {
+            setTTY(true);
+            process.env['TERM_PROGRAM'] = 'iTerm.app';
+            process.env['TERM_PROGRAM_VERSION'] = '3.5.0';
+            process.env['NO_COLOR'] = '1';
+            expect(supportsHyperlinks()).toBe(false);
+        });
+        it('returns false when FORCE_COLOR=0', () => {
+            setTTY(true);
+            process.env['TERM_PROGRAM'] = 'iTerm.app';
+            process.env['TERM_PROGRAM_VERSION'] = '3.5.0';
+            process.env['FORCE_COLOR'] = '0';
+            expect(supportsHyperlinks()).toBe(false);
+        });
+        it('returns false in CI', () => {
+            setTTY(true);
+            process.env['CI'] = 'true';
+            process.env['TERM_PROGRAM'] = 'iTerm.app';
+            process.env['TERM_PROGRAM_VERSION'] = '3.5.0';
+            expect(supportsHyperlinks()).toBe(false);
+        });
+        it('returns false inside tmux even on a capable terminal', () => {
+            setTTY(true);
+            process.env['TMUX'] = '/tmp/tmux-1000/default,1,0';
+            process.env['TERM_PROGRAM'] = 'iTerm.app';
+            process.env['TERM_PROGRAM_VERSION'] = '3.5.0';
+            expect(supportsHyperlinks()).toBe(false);
+        });
+        it('returns false inside GNU screen', () => {
+            setTTY(true);
+            process.env['STY'] = '1234.host';
+            process.env['WT_SESSION'] = '00000000-0000-0000-0000-000000000000';
+            expect(supportsHyperlinks()).toBe(false);
+        });
+        it('lets a detected TERM_PROGRAM win even on win32', () => {
+            setTTY(true);
+            setPlatform('win32');
+            process.env['TERM_PROGRAM'] = 'vscode';
+            process.env['TERM_PROGRAM_VERSION'] = '1.80.0';
+            expect(supportsHyperlinks()).toBe(true);
+        });
+        it('returns false on bare win32 (no detected terminal)', () => {
+            setTTY(true);
+            setPlatform('win32');
+            delete process.env['TERM_PROGRAM'];
+            expect(supportsHyperlinks()).toBe(false);
+        });
+        it('returns true for Windows Terminal even on win32', () => {
+            setTTY(true);
+            setPlatform('win32');
+            process.env['WT_SESSION'] = '00000000-0000-0000-0000-000000000000';
+            expect(supportsHyperlinks()).toBe(true);
+        });
+        describe('version-gated TERM_PROGRAMs', () => {
+            it('iTerm.app >= 3.1 is enabled, < 3.1 is not', () => {
+                setTTY(true);
+                process.env['TERM_PROGRAM'] = 'iTerm.app';
+                process.env['TERM_PROGRAM_VERSION'] = '3.5.0';
+                expect(supportsHyperlinks()).toBe(true);
+                process.env['TERM_PROGRAM_VERSION'] = '3.1.0';
+                expect(supportsHyperlinks()).toBe(true);
+                process.env['TERM_PROGRAM_VERSION'] = '3.0.15';
+                expect(supportsHyperlinks()).toBe(false);
+                process.env['TERM_PROGRAM_VERSION'] = '2.9.20140903';
+                expect(supportsHyperlinks()).toBe(false);
+            });
+            it('vscode >= 1.72 is enabled, < 1.72 is not', () => {
+                setTTY(true);
+                process.env['TERM_PROGRAM'] = 'vscode';
+                process.env['TERM_PROGRAM_VERSION'] = '1.72.0';
+                expect(supportsHyperlinks()).toBe(true);
+                process.env['TERM_PROGRAM_VERSION'] = '1.71.2';
+                expect(supportsHyperlinks()).toBe(false);
+            });
+            it('WezTerm requires the dated build >= 20200620', () => {
+                setTTY(true);
+                process.env['TERM_PROGRAM'] = 'WezTerm';
+                process.env['TERM_PROGRAM_VERSION'] = '20200620-000000';
+                expect(supportsHyperlinks()).toBe(true);
+                process.env['TERM_PROGRAM_VERSION'] = '20191123-000000';
+                expect(supportsHyperlinks()).toBe(false);
+            });
+        });
+        it('VTE 0.50.0 is blocked due to known segfault; >= 0.50 otherwise enabled', () => {
+            setTTY(true);
+            process.env['VTE_VERSION'] = '0.50.0';
+            expect(supportsHyperlinks()).toBe(false);
+            process.env['VTE_VERSION'] = '0.52.0';
+            expect(supportsHyperlinks()).toBe(true);
+            process.env['VTE_VERSION'] = '0.48.0';
+            expect(supportsHyperlinks()).toBe(false);
+        });
+        it('VTE 0.50.0 reported in packed form (5000) is also blocked', () => {
+            // VTE historically reports VTE_VERSION as a packed integer; the
+            // string-compare path would miss this case and let the segfault fire.
+            setTTY(true);
+            process.env['VTE_VERSION'] = '5000';
+            expect(supportsHyperlinks()).toBe(false);
+            process.env['VTE_VERSION'] = '5002';
+            expect(supportsHyperlinks()).toBe(true);
+        });
+        it('Kitty is enabled via KITTY_WINDOW_ID or TERM=xterm-kitty', () => {
+            setTTY(true);
+            process.env['KITTY_WINDOW_ID'] = '1';
+            expect(supportsHyperlinks()).toBe(true);
+            delete process.env['KITTY_WINDOW_ID'];
+            process.env['TERM'] = 'xterm-kitty';
+            expect(supportsHyperlinks()).toBe(true);
+        });
+        it('Ghostty is enabled via GHOSTTY_RESOURCES_DIR or TERM=xterm-ghostty', () => {
+            setTTY(true);
+            process.env['GHOSTTY_RESOURCES_DIR'] = '/path';
+            expect(supportsHyperlinks()).toBe(true);
+        });
+        it('Konsole ≥ 21.04 is enabled via KONSOLE_VERSION', () => {
+            setTTY(true);
+            process.env['KONSOLE_VERSION'] = '230400';
+            expect(supportsHyperlinks()).toBe(true);
+            process.env['KONSOLE_VERSION'] = '210400';
+            expect(supportsHyperlinks()).toBe(true);
+        });
+        it('Konsole < 21.04 falls through (no OSC 8 in 20.x)', () => {
+            // KONSOLE_VERSION is set by every Konsole release, including ones
+            // that pre-date OSC 8 support. Without a version gate those older
+            // sessions would receive escape bytes they can't render.
+            setTTY(true);
+            process.env['KONSOLE_VERSION'] = '201200'; // Konsole 20.12
+            expect(supportsHyperlinks()).toBe(false);
+            process.env['KONSOLE_VERSION'] = '210399'; // one patch below the gate
+            expect(supportsHyperlinks()).toBe(false);
+        });
+        it('Alacritty is enabled via TERM=alacritty', () => {
+            setTTY(true);
+            process.env['TERM'] = 'alacritty';
+            expect(supportsHyperlinks()).toBe(true);
+        });
+        it('Alacritty fallback: ALACRITTY_LOG/WINDOW_ID/SOCKET when terminfo missing', () => {
+            setTTY(true);
+            // Simulate Alacritty falling back to TERM=xterm-256color because the
+            // alacritty terminfo isn't installed on this host.
+            process.env['TERM'] = 'xterm-256color';
+            process.env['ALACRITTY_LOG'] = '/tmp/Alacritty-12345.log';
+            expect(supportsHyperlinks()).toBe(true);
+            delete process.env['ALACRITTY_LOG'];
+            process.env['ALACRITTY_WINDOW_ID'] = '12345';
+            expect(supportsHyperlinks()).toBe(true);
+            delete process.env['ALACRITTY_WINDOW_ID'];
+            process.env['ALACRITTY_SOCKET'] = '/tmp/alacritty.sock';
+            expect(supportsHyperlinks()).toBe(true);
+        });
+        it('JetBrains JediTerm is enabled via TERMINAL_EMULATOR', () => {
+            setTTY(true);
+            process.env['TERMINAL_EMULATOR'] = 'JetBrains-JediTerm';
+            expect(supportsHyperlinks()).toBe(true);
+        });
+        it('Warp Terminal is intentionally NOT auto-detected (no OSC 8 support yet)', () => {
+            // Warp's current rendering engine doesn't honor OSC 8 — it prints the
+            // envelope as visible garbage. Falls through to the final return false
+            // until Warp ships support. Users on a Warp build that does support
+            // OSC 8 can opt in via FORCE_HYPERLINK=1.
+            setTTY(true);
+            process.env['TERM_PROGRAM'] = 'WarpTerminal';
+            expect(supportsHyperlinks()).toBe(false);
+            process.env['FORCE_HYPERLINK'] = '1';
+            expect(supportsHyperlinks()).toBe(true);
+        });
+        it('mintty ≥ 3.3 is enabled, < 3.3 is not, missing version refuses', () => {
+            // Older mintty builds (still shipping in some Git-for-Windows distros
+            // and dev environments like Laragon) print raw OSC 8 escape bytes as
+            // visible garbage instead of ignoring them — see issue #4420. mintty
+            // has set TERM_PROGRAM_VERSION since 2.7 (2017), so a missing version
+            // implies an ancient build and we refuse.
+            setTTY(true);
+            process.env['TERM_PROGRAM'] = 'mintty';
+            process.env['TERM_PROGRAM_VERSION'] = '4.0.0';
+            expect(supportsHyperlinks()).toBe(true);
+            process.env['TERM_PROGRAM_VERSION'] = '3.7.1';
+            expect(supportsHyperlinks()).toBe(true);
+            process.env['TERM_PROGRAM_VERSION'] = '3.3.0';
+            expect(supportsHyperlinks()).toBe(true);
+            process.env['TERM_PROGRAM_VERSION'] = '3.2.9';
+            expect(supportsHyperlinks()).toBe(false);
+            process.env['TERM_PROGRAM_VERSION'] = '3.1.0';
+            expect(supportsHyperlinks()).toBe(false);
+            process.env['TERM_PROGRAM_VERSION'] = '2.9.8';
+            expect(supportsHyperlinks()).toBe(false);
+            process.env['TERM_PROGRAM_VERSION'] = '';
+            expect(supportsHyperlinks()).toBe(false);
+            delete process.env['TERM_PROGRAM_VERSION'];
+            expect(supportsHyperlinks()).toBe(false);
+            // Users on mintty 3.1–3.2 who know their build's OSC 8 implementation
+            // works can opt back in via FORCE_HYPERLINK=1 — same escape hatch the
+            // Warp and Hyper tests above assert. Pin the contract so a future
+            // refactor that reorders early-exit checks can't silently break it.
+            process.env['TERM_PROGRAM_VERSION'] = '3.2.9';
+            process.env['FORCE_HYPERLINK'] = '1';
+            expect(supportsHyperlinks()).toBe(true);
+        });
+        it('Hyper is intentionally not auto-detected (requires FORCE_HYPERLINK)', () => {
+            setTTY(true);
+            process.env['TERM_PROGRAM'] = 'Hyper';
+            expect(supportsHyperlinks()).toBe(false);
+            process.env['FORCE_HYPERLINK'] = '1';
+            expect(supportsHyperlinks()).toBe(true);
+        });
+        it('Apple Terminal is not auto-detected (no OSC 8 support)', () => {
+            setTTY(true);
+            process.env['TERM_PROGRAM'] = 'Apple_Terminal';
+            process.env['TERM_PROGRAM_VERSION'] = '447';
+            expect(supportsHyperlinks()).toBe(false);
+        });
+        it('honors FORCE_HYPERLINK=1 inside tmux on a TTY', () => {
+            setTTY(true);
+            process.env['TMUX'] = '/tmp/x,1,0';
+            process.env['FORCE_HYPERLINK'] = '1';
+            expect(supportsHyperlinks()).toBe(true);
+        });
+        it('FORCE_HYPERLINK=1 does NOT override non-TTY suppression', () => {
+            // A user with `FORCE_HYPERLINK=1` in their shell profile (to enable
+            // OSC 8 inside tmux interactively) must still get a clean pipe when
+            // running `qwen | cat` — escape bytes never go into a file/pipe.
+            setTTY(false);
+            process.env['FORCE_HYPERLINK'] = '1';
+            expect(supportsHyperlinks()).toBe(false);
+        });
+        it('FORCE_HYPERLINK=0 disables even on capable terminals', () => {
+            setTTY(true);
+            process.env['TERM_PROGRAM'] = 'iTerm.app';
+            process.env['TERM_PROGRAM_VERSION'] = '3.5.0';
+            process.env['FORCE_HYPERLINK'] = '0';
+            expect(supportsHyperlinks()).toBe(false);
+        });
+        it('hard opt-outs (NO_COLOR/QWEN_DISABLE_HYPERLINKS) win over FORCE_HYPERLINK', () => {
+            setTTY(true);
+            process.env['FORCE_HYPERLINK'] = '1';
+            process.env['NO_COLOR'] = '1';
+            expect(supportsHyperlinks()).toBe(false);
+            delete process.env['NO_COLOR'];
+            process.env['QWEN_DISABLE_HYPERLINKS'] = '1';
+            expect(supportsHyperlinks()).toBe(false);
+        });
+        it('returns false for an unknown terminal even on a TTY', () => {
+            setTTY(true);
+            process.env['TERM'] = 'dumb';
+            expect(supportsHyperlinks()).toBe(false);
+        });
+        it('accepts a stream argument so non-stdout writers can be probed', () => {
+            const fakeStream = { isTTY: true };
+            process.env['WT_SESSION'] = '00000000-0000-0000-0000-000000000000';
+            Object.defineProperty(process.stdout, 'isTTY', {
+                configurable: true,
+                value: false,
+            });
+            expect(supportsHyperlinks(fakeStream)).toBe(true);
+            expect(supportsHyperlinks(process.stdout)).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=osc8.test.js.map

package/dist/src/ui/utils/osc8.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"osc8.test.js","sourceRoot":"","sources":["../../../../src/ui/utils/osc8.test.ts"],"names":[],"mappings":"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"}

package/dist/src/ui/utils/platformConstants.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Terminal Platform Constants
+ *
+ * This file contains terminal-related constants used throughout the application,
+ * specifically for handling keyboard inputs and terminal protocols.
+ */
+/**
+ * Kitty keyboard protocol sequences for enhanced keyboard input.
+ * @see https://sw.kovidgoyal.net/kitty/keyboard-protocol/
+ */
+export declare const KITTY_CTRL_C = "[99;5u";
+/**
+ * Kitty keyboard protocol keycodes
+ */
+export declare const KITTY_KEYCODE_ENTER = 13;
+export declare const KITTY_KEYCODE_NUMPAD_ENTER = 57414;
+export declare const KITTY_KEYCODE_TAB = 9;
+export declare const KITTY_KEYCODE_BACKSPACE = 127;
+/**
+ * Kitty modifier decoding constants
+ *
+ * In Kitty/Ghostty, the modifier parameter is encoded as (1 + bitmask).
+ * Some terminals also set bit 7 (i.e., add 128) when reporting event types.
+ */
+export declare const KITTY_MODIFIER_BASE = 1;
+export declare const KITTY_MODIFIER_EVENT_TYPES_OFFSET = 128;
+/**
+ * Modifier bit flags for Kitty/Xterm-style parameters.
+ *
+ * Per spec, the modifiers parameter encodes (1 + bitmask) where:
+ * - 1: no modifiers
+ * - bit 0 (1): Shift
+ * - bit 1 (2): Alt/Option (reported as "alt" in spec; we map to meta)
+ * - bit 2 (4): Ctrl
+ *
+ * Some terminals add 128 to the entire modifiers field when reporting event types.
+ * See: https://sw.kovidgoyal.net/kitty/keyboard-protocol/#modifiers
+ */
+export declare const MODIFIER_SHIFT_BIT = 1;
+export declare const MODIFIER_ALT_BIT = 2;
+export declare const MODIFIER_CTRL_BIT = 4;
+/**
+ * Timing constants for terminal interactions
+ */
+export declare const CTRL_EXIT_PROMPT_DURATION_MS = 1000;
+/**
+ * VS Code terminal integration constants
+ */
+export declare const VSCODE_SHIFT_ENTER_SEQUENCE = "\\\r\n";
+/**
+ * Backslash + Enter detection window in milliseconds.
+ * Used to detect Shift+Enter pattern where backslash
+ * is followed by Enter within this timeframe.
+ */
+export declare const BACKSLASH_ENTER_DETECTION_WINDOW_MS = 5;
+/**
+ * Maximum expected length of a Kitty keyboard protocol sequence.
+ * Format: ESC [ <keycode> ; <modifiers> u/~
+ * Example: \x1b[13;2u (Shift+Enter) = 8 chars
+ * Longest reasonable: \x1b[127;15~ = 11 chars (Del with all modifiers)
+ * We use 12 to provide a small buffer.
+ */
+export declare const MAX_KITTY_SEQUENCE_LENGTH = 32;
+/**
+ * Character codes for common escape sequences
+ */
+export declare const CHAR_CODE_ESC = 27;
+export declare const CHAR_CODE_LEFT_BRACKET = 91;
+export declare const CHAR_CODE_1 = 49;
+export declare const CHAR_CODE_2 = 50;