@alchemy.run/sigil 0.0.0-alpha.4 → 0.0.0-alpha.6

package/dist/ansi.d.ts

@@ -1,17 +1,96 @@
-import { _ as rgbToAnsi256, a as StylePair, c as backgroundColorNames, d as foregroundColorNames, f as hexToAnsi, g as rgbToAnsi, h as modifierNames, i as StyleName, l as codes, m as hexToRgb, n as ForegroundColorName, o as ansi256ToAnsi, p as hexToAnsi256, r as ModifierName, s as background, t as BackgroundColorName, u as foreground, v as styles } from "./sgr-CMfEpjSk.js";
-//#region src/ansi/supports-color.d.ts
-type ColorSupportLevel = 0 | 1 | 2 | 3;
-type ColorSupport = {
-  readonly level: ColorSupportLevel;
-  readonly hasBasic: boolean;
-  readonly has256: boolean;
-  readonly has16m: boolean;
+import { i as ColorSupportLevel, n as ColorInfo } from "./detect-Bh4yGP6w.js";
+import { A as exitAlternativeScreen, C as enableBracketedPaste, D as eraseLines, E as eraseLine, F as popKittyKeyboard, I as pushKittyKeyboard, L as resetCursorColor, M as link, N as pasteEnd, O as eraseScreen, P as pasteStart, S as disableBracketedPaste, T as eraseEndLine, _ as cursorNextLine, a as CursorShape, b as cursorTo, c as OSC, d as bsu, f as clearTerminal, g as cursorLeft, h as cursorHide, i as CSI, j as kittyQuery, k as esu, l as ST, m as cursorDown, n as C1_CSI, o as DEL, p as cursorColor, r as C1_ST, s as ESC, t as BEL, u as ansiEscapes, v as cursorShape, w as enterAlternativeScreen, x as cursorUp, y as cursorShow } from "./escapes-CB_6CWOE.js";
+import { a as queryClipboard, c as setTerminalProgress, d as tmuxPassthrough, i as notify, l as setWindowTitle, n as TerminalProgressState, o as setClipboard, r as clearClipboard, s as setPointerShape, t as ClipboardSelection, u as setWorkingDirectory } from "./osc-Cn0fw77g.js";
+import { _ as tokenize, a as StyledChar, c as diffAnsiCodes, d as getLinkStartCode, f as isIntensityCode, g as styledCharsToString, h as styledCharsFromTokens, i as ControlToken, l as endCodesSet, m as reduceAnsiCodesIncremental, n as AnsiToken, o as Token, p as reduceAnsiCodes, r as CharToken, s as ansiCodesToString, t as AnsiCode, u as getEndCode, v as undoAnsiCodes } from "./tokenize-Dx1y_l5H.js";
+//#region src/ansi/sgr.d.ts
+type StylePair = {
+  readonly open: string;
+  readonly close: string;
 };
-type ColorInfo = ColorSupport | false;
-declare const supportsColor: {
-  stdout: ColorInfo;
-  stderr: ColorInfo;
+declare const modifierCodes: {
+  readonly reset: readonly [0, 0];
+  readonly bold: readonly [1, 22];
+  readonly dim: readonly [2, 22];
+  readonly italic: readonly [3, 23];
+  readonly underline: readonly [4, 24];
+  readonly overline: readonly [53, 55];
+  readonly inverse: readonly [7, 27];
+  readonly hidden: readonly [8, 28];
+  readonly strikethrough: readonly [9, 29];
 };
+declare const colorCodes: {
+  readonly black: readonly [30, 39];
+  readonly red: readonly [31, 39];
+  readonly green: readonly [32, 39];
+  readonly yellow: readonly [33, 39];
+  readonly blue: readonly [34, 39];
+  readonly magenta: readonly [35, 39];
+  readonly cyan: readonly [36, 39];
+  readonly white: readonly [37, 39];
+  readonly blackBright: readonly [90, 39];
+  readonly gray: readonly [90, 39];
+  readonly grey: readonly [90, 39];
+  readonly redBright: readonly [91, 39];
+  readonly greenBright: readonly [92, 39];
+  readonly yellowBright: readonly [93, 39];
+  readonly blueBright: readonly [94, 39];
+  readonly magentaBright: readonly [95, 39];
+  readonly cyanBright: readonly [96, 39];
+  readonly whiteBright: readonly [97, 39];
+};
+declare const bgColorCodes: {
+  readonly bgBlack: readonly [40, 49];
+  readonly bgRed: readonly [41, 49];
+  readonly bgGreen: readonly [42, 49];
+  readonly bgYellow: readonly [43, 49];
+  readonly bgBlue: readonly [44, 49];
+  readonly bgMagenta: readonly [45, 49];
+  readonly bgCyan: readonly [46, 49];
+  readonly bgWhite: readonly [47, 49];
+  readonly bgBlackBright: readonly [100, 49];
+  readonly bgGray: readonly [100, 49];
+  readonly bgGrey: readonly [100, 49];
+  readonly bgRedBright: readonly [101, 49];
+  readonly bgGreenBright: readonly [102, 49];
+  readonly bgYellowBright: readonly [103, 49];
+  readonly bgBlueBright: readonly [104, 49];
+  readonly bgMagentaBright: readonly [105, 49];
+  readonly bgCyanBright: readonly [106, 49];
+  readonly bgWhiteBright: readonly [107, 49];
+};
+type ModifierName = keyof typeof modifierCodes;
+type ForegroundColorName = keyof typeof colorCodes;
+type BackgroundColorName = keyof typeof bgColorCodes;
+type StyleName = ModifierName | ForegroundColorName | BackgroundColorName;
+declare const modifierNames: ModifierName[];
+declare const foregroundColorNames: ForegroundColorName[];
+declare const backgroundColorNames: BackgroundColorName[];
+/**
+Named SGR styles as `{open, close}` escape sequence pairs.
+*/
+declare const styles: Record<StyleName, StylePair>;
+/**
+Raw SGR code numbers: open code → close code.
+*/
+declare const codes: ReadonlyMap<number, number>;
+declare const foreground: {
+  close: string;
+  ansi: (code: number) => string;
+  ansi256: (code: number) => string;
+  ansi16m: (red: number, green: number, blue: number) => string;
+};
+declare const background: {
+  close: string;
+  ansi: (code: number) => string;
+  ansi256: (code: number) => string;
+  ansi16m: (red: number, green: number, blue: number) => string;
+};
+declare const rgbToAnsi256: (red: number, green: number, blue: number) => number;
+declare const hexToRgb: (hex: string) => [number, number, number];
+declare const hexToAnsi256: (hex: string) => number;
+declare const ansi256ToAnsi: (code: number) => number;
+declare const rgbToAnsi: (red: number, green: number, blue: number) => number;
+declare const hexToAnsi: (hex: string) => number;
 //#endregion
 //#region src/ansi/chalk.d.ts
 type StyleFunction = (text: string) => string;
@@ -26,70 +105,38 @@ type Chalk = NamedStyles & {
   bgAnsi256: (code: number) => StyleFunction;
 };
 declare const chalk: Chalk;
+declare const supportsColor: ColorInfo;
 //#endregion
-//#region src/ansi/escapes.d.ts
-declare const ESC = "";
-declare const BEL = "";
-declare const DEL = "";
-/** Control Sequence Introducer. */
-declare const CSI = "[";
-/** Operating System Command. */
-declare const OSC = "]";
-/** String Terminator. */
-declare const ST = "\\";
-/** Single-byte C1 forms of CSI and ST. */
-declare const C1_CSI = "›";
-declare const C1_ST = "œ";
-declare const cursorTo: (x: number, y?: number) => string;
-declare const cursorUp: (count?: number) => string;
-declare const cursorDown: (count?: number) => string;
-declare const cursorLeft: string;
-declare const cursorNextLine: string;
-declare const eraseEndLine: string;
-declare const eraseLine: string;
-declare const eraseScreen: string;
-declare const eraseLines: (count: number) => string;
-declare const clearTerminal = "";
-declare const enterAlternativeScreen: string;
-declare const exitAlternativeScreen: string;
-declare const cursorShow: string;
-declare const cursorHide: string;
-declare const enableBracketedPaste: string;
-declare const disableBracketedPaste: string;
-declare const pasteStart: string;
-declare const pasteEnd: string;
-declare const bsu: string;
-declare const esu: string;
-declare const kittyQuery: string;
-declare const pushKittyKeyboard: (flags: number) => string;
-declare const popKittyKeyboard: string;
-declare const link: (text: string, url: string) => string;
-declare const ansiEscapes: {
-  cursorTo: typeof cursorTo;
-  cursorUp: typeof cursorUp;
-  cursorDown: typeof cursorDown;
-  cursorLeft: string;
-  cursorNextLine: string;
-  eraseEndLine: string;
-  eraseLine: string;
-  eraseScreen: string;
-  eraseLines: typeof eraseLines;
-  clearTerminal: string;
-  enterAlternativeScreen: string;
-  exitAlternativeScreen: string;
-  cursorShow: string;
-  cursorHide: string;
-  enableBracketedPaste: string;
-  disableBracketedPaste: string;
-  pasteStart: string;
-  pasteEnd: string;
-  bsu: string;
-  esu: string;
-  kittyQuery: string;
-  pushKittyKeyboard: typeof pushKittyKeyboard;
-  popKittyKeyboard: string;
-  link: typeof link;
+//#region src/ansi/hyperlink.d.ts
+type HyperlinkOptions = {
+  /**
+      When the terminal does not support OSC 8 hyperlinks, append the URL in
+      parentheses after the text so it stays reachable. Set to `false` to
+      return the text alone.
+  
+      @default true
+      */
+  fallback?: boolean;
+  /**
+      The stream the text will be written to, for support detection.
+  
+      @default process.stdout
+      */
+  stream?: {
+    isTTY?: boolean;
+  };
 };
+/**
+Wraps text in a clickable OSC 8 hyperlink when the terminal supports it,
+falling back to `text (url)`.
+
+```ts
+import { hyperlink } from "@alchemy.run/sigil/ansi";
+
+console.log(hyperlink("Documentation", "https://example.com"));
+```
+*/
+declare const hyperlink: (text: string, url: string, { fallback, stream }?: HyperlinkOptions) => string;
 //#endregion
 //#region src/ansi/cursor.d.ts
 type CursorStream = {
@@ -167,60 +214,4 @@ type WrapOptions = {
 };
 declare function wrapAnsi(string: string, columns: number, options?: WrapOptions): string;
 //#endregion
-//#region src/ansi/tokenize.d.ts
-/**
-An ANSI code paired with the code that ends its effect.
-*/
-type AnsiCode = {
-  readonly code: string;
-  readonly endCode: string;
-};
-type AnsiToken = AnsiCode & {
-  readonly type: "ansi";
-};
-type ControlToken = {
-  readonly type: "control";
-  readonly code: string;
-};
-type CharToken = {
-  readonly type: "char";
-  readonly value: string;
-  readonly fullWidth: boolean;
-};
-type Token = AnsiToken | ControlToken | CharToken;
-type StyledChar = CharToken & {
-  readonly styles: AnsiCode[];
-};
-declare const endCodesSet: Set<string>;
-declare function getLinkStartCode(url: string, params?: Record<string, string>): string;
-declare function getEndCode(code: string): string;
-declare function ansiCodesToString(codes: readonly AnsiCode[]): string;
-/**
-Check if a code is an intensity code (bold or dim) — these share the end code
-`22m` but can coexist.
-*/
-declare function isIntensityCode(code: AnsiCode): boolean;
-declare function tokenize(string: string, endChar?: number): Token[];
-/**
-Reduces the given array of ANSI codes to the minimum necessary to render with
-the same style.
-*/
-declare function reduceAnsiCodes(codes: readonly AnsiCode[]): AnsiCode[];
-/**
-Like {@link reduceAnsiCodes}, but assumes that `codes` is already reduced.
-Further reductions are only done for the items in `newCodes`.
-*/
-declare function reduceAnsiCodesIncremental(codes: readonly AnsiCode[], newCodes: readonly AnsiCode[]): AnsiCode[];
-/**
-Returns the combination of ANSI codes needed to undo the given ANSI codes.
-*/
-declare function undoAnsiCodes(codes: readonly AnsiCode[]): AnsiCode[];
-/**
-Returns the minimum amount of ANSI codes necessary to get from the compound
-style `from` to `to`. Both are expected to be reduced.
-*/
-declare function diffAnsiCodes(from: readonly AnsiCode[], to: readonly AnsiCode[]): AnsiCode[];
-declare function styledCharsFromTokens(tokens: readonly Token[]): StyledChar[];
-declare function styledCharsToString(chars: readonly StyledChar[]): string;
-//#endregion
-export { AnsiCode, AnsiToken, BEL, BackgroundColorName, C1_CSI, C1_ST, CSI, CharToken, ControlToken, DEL, ESC, EastAsianWidthType, ForegroundColorName, ModifierName, OSC, ST, StyleName, StylePair, StyledChar, Token, ambiguousMaximumCodePoint, ambiguousMinimalCodePoint, ambiguousRanges, ansi256ToAnsi, ansiCodesToString, ansiEscapes, background, backgroundColorNames, bsu, chalk, clearTerminal, cliCursor, codes, cursorDown, cursorHide, cursorLeft, cursorNextLine, cursorShow, cursorTo, cursorUp, diffAnsiCodes, disableBracketedPaste, eastAsianWidth, eastAsianWidthType, enableBracketedPaste, endCodesSet, enterAlternativeScreen, eraseEndLine, eraseLine, eraseLines, eraseScreen, esu, exitAlternativeScreen, foreground, foregroundColorNames, fullwidthMaximumCodePoint, fullwidthMinimalCodePoint, fullwidthRanges, getCategory, getEndCode, getLinkStartCode, halfwidthMaximumCodePoint, halfwidthMinimalCodePoint, halfwidthRanges, hexToAnsi, hexToAnsi256, hexToRgb, isAmbiguous, isFullWidth, isFullwidthCodePoint, isFullwidthGrapheme, isIntensityCode, isWide, isWideNotCJKTNotEmoji, kittyQuery, link, modifierNames, narrowMaximumCodePoint, narrowMinimalCodePoint, narrowRanges, pasteEnd, pasteStart, popKittyKeyboard, pushKittyKeyboard, reduceAnsiCodes, reduceAnsiCodesIncremental, rgbToAnsi, rgbToAnsi256, sliceAnsi, stringWidth, stripAnsi, styledCharsFromTokens, styledCharsToString, styles, supportsColor, tokenize, cliTruncate as truncateAnsi, undoAnsiCodes, wideMaximumCodePoint, wideMinimalCodePoint, wideRanges, widestLine, wrapAnsi };
+export { AnsiCode, AnsiToken, BEL, BackgroundColorName, C1_CSI, C1_ST, CSI, CharToken, ClipboardSelection, ControlToken, CursorShape, DEL, ESC, EastAsianWidthType, ForegroundColorName, ModifierName, OSC, ST, StyleName, StylePair, StyledChar, TerminalProgressState, Token, ambiguousMaximumCodePoint, ambiguousMinimalCodePoint, ambiguousRanges, ansi256ToAnsi, ansiCodesToString, ansiEscapes, background, backgroundColorNames, bsu, chalk, clearClipboard, clearTerminal, cliCursor, codes, cursorColor, cursorDown, cursorHide, cursorLeft, cursorNextLine, cursorShape, cursorShow, cursorTo, cursorUp, diffAnsiCodes, disableBracketedPaste, eastAsianWidth, eastAsianWidthType, enableBracketedPaste, endCodesSet, enterAlternativeScreen, eraseEndLine, eraseLine, eraseLines, eraseScreen, esu, exitAlternativeScreen, foreground, foregroundColorNames, fullwidthMaximumCodePoint, fullwidthMinimalCodePoint, fullwidthRanges, getCategory, getEndCode, getLinkStartCode, halfwidthMaximumCodePoint, halfwidthMinimalCodePoint, halfwidthRanges, hexToAnsi, hexToAnsi256, hexToRgb, hyperlink, isAmbiguous, isFullWidth, isFullwidthCodePoint, isFullwidthGrapheme, isIntensityCode, isWide, isWideNotCJKTNotEmoji, kittyQuery, link, modifierNames, narrowMaximumCodePoint, narrowMinimalCodePoint, narrowRanges, notify, pasteEnd, pasteStart, popKittyKeyboard, pushKittyKeyboard, queryClipboard, reduceAnsiCodes, reduceAnsiCodesIncremental, resetCursorColor, rgbToAnsi, rgbToAnsi256, setClipboard, setPointerShape, setTerminalProgress, setWindowTitle, setWorkingDirectory, sliceAnsi, stringWidth, stripAnsi, styledCharsFromTokens, styledCharsToString, styles, supportsColor, tmuxPassthrough, tokenize, cliTruncate as truncateAnsi, undoAnsiCodes, wideMaximumCodePoint, wideMinimalCodePoint, wideRanges, widestLine, wrapAnsi };

package/dist/ansi.js

@@ -1,7 +1,87 @@
-import { $ as wideRanges, A as ambiguousMaximumCodePoint, At as cursorUp, B as halfwidthMinimalCodePoint, Bt as kittyQuery, Ct as clearTerminal, D as wrapAnsi, Dt as cursorNextLine, Et as cursorLeft, F as fullwidthMaximumCodePoint, Ft as eraseLine, G as isFullwidthGrapheme, Gt as pushKittyKeyboard, H as isAmbiguous, Ht as pasteEnd, I as fullwidthMinimalCodePoint, It as eraseLines, J as narrowMaximumCodePoint, K as isWide, L as fullwidthRanges, Lt as eraseScreen, M as ambiguousRanges, Mt as enableBracketedPaste, N as eastAsianWidth, Nt as enterAlternativeScreen, O as stringWidth, Ot as cursorShow, P as eastAsianWidthType, Pt as eraseEndLine, Q as wideMinimalCodePoint, R as getCategory, Rt as esu, St as bsu, Tt as cursorHide, U as isFullWidth, Ut as pasteStart, V as halfwidthRanges, Vt as link, W as isFullwidthCodePoint, Wt as popKittyKeyboard, X as narrowRanges, Y as narrowMinimalCodePoint, Z as wideMaximumCodePoint, _ as chalk, _t as DEL, a as endCodesSet, at as foregroundColorNames, bt as ST, c as isIntensityCode, ct as hexToRgb, d as styledCharsFromTokens, dt as rgbToAnsi256, et as ansi256ToAnsi, f as styledCharsToString, ft as styles, gt as CSI, ht as C1_ST, i as diffAnsiCodes, it as foreground, j as ambiguousMinimalCodePoint, jt as disableBracketedPaste, k as widestLine, kt as cursorTo, l as reduceAnsiCodes, lt as modifierNames, m as undoAnsiCodes, mt as C1_CSI, n as sliceAnsi, nt as backgroundColorNames, o as getEndCode, ot as hexToAnsi, p as tokenize, pt as BEL, q as isWideNotCJKTNotEmoji, r as ansiCodesToString, rt as codes, s as getLinkStartCode, st as hexToAnsi256, t as cliTruncate, tt as background, u as reduceAnsiCodesIncremental, ut as rgbToAnsi, v as supportsColor, vt as ESC, wt as cursorDown, xt as ansiEscapes, y as cliCursor, yt as OSC, z as halfwidthMaximumCodePoint, zt as exitAlternativeScreen } from "./truncate-Cr6xVFMa.js";
-import { stripVTControlCharacters } from "node:util";
-//#region src/ansi/strip.ts
-const colonSgrRegex = /(?:\u001B\[|\u009B)[\d;]*:[\d;:]*m/g;
-const stripAnsi = (input) => stripVTControlCharacters(input.replaceAll(colonSgrRegex, ""));
+import { A as cursorShape, B as eraseScreen, C as bsu, D as cursorHide, E as cursorDown, F as enableBracketedPaste, G as pasteEnd, H as exitAlternativeScreen, I as enterAlternativeScreen, J as pushKittyKeyboard, K as pasteStart, L as eraseEndLine, M as cursorTo, N as cursorUp, O as cursorLeft, P as disableBracketedPaste, R as eraseLine, S as ansiEscapes, T as cursorColor, U as kittyQuery, V as esu, W as link, Y as resetCursorColor, _ as CSI, a as foreground, b as OSC, c as hexToAnsi256, d as rgbToAnsi, f as rgbToAnsi256, g as C1_ST, h as C1_CSI, i as codes, j as cursorShow, k as cursorNextLine, l as hexToRgb, m as BEL, n as background, o as foregroundColorNames, p as styles, q as popKittyKeyboard, r as backgroundColorNames, s as hexToAnsi, t as ansi256ToAnsi, u as modifierNames, v as DEL, w as clearTerminal, x as ST, y as ESC, z as eraseLines } from "./sgr-BhwaWAJB.js";
+import { A as isFullwidthCodePoint, C as fullwidthRanges, D as halfwidthRanges, E as halfwidthMinimalCodePoint, F as narrowMinimalCodePoint, I as narrowRanges, L as wideMaximumCodePoint, M as isWide, N as isWideNotCJKTNotEmoji, O as isAmbiguous, P as narrowMaximumCodePoint, R as wideMinimalCodePoint, S as fullwidthMinimalCodePoint, T as halfwidthMaximumCodePoint, _ as ambiguousMinimalCodePoint, a as getLinkStartCode, b as eastAsianWidthType, c as reduceAnsiCodesIncremental, d as tokenize, f as undoAnsiCodes, g as ambiguousMaximumCodePoint, i as getEndCode, j as isFullwidthGrapheme, k as isFullWidth, l as styledCharsFromTokens, n as diffAnsiCodes, o as isIntensityCode, r as endCodesSet, s as reduceAnsiCodes, t as ansiCodesToString, u as styledCharsToString, v as ambiguousRanges, w as getCategory, x as fullwidthMaximumCodePoint, y as eastAsianWidth, z as wideRanges } from "./tokenize-AjqbvtiT.js";
+import { n as widestLine, t as stringWidth } from "./string-width-CijQwpIk.js";
+import { n as sliceAnsi, r as wrapAnsi, t as cliTruncate } from "./truncate-D31fhU6i.js";
+import { i as detectHyperlinkSupport, t as createSupportsColor } from "./detect-BuTXtY6e.js";
+import { a as setPointerShape, c as setWorkingDirectory, i as setClipboard, l as tmuxPassthrough, n as notify, o as setTerminalProgress, r as queryClipboard, s as setWindowTitle, t as clearClipboard, u as cliCursor } from "./osc-CCH7xDoS.js";
+import { t as stripAnsi } from "./strip-BvU4toXG.js";
+import { isatty } from "node:tty";
+//#region src/ansi/chalk.ts
+const stdoutColor = createSupportsColor({ isTTY: isatty(1) });
+const levelMapping = [
+	"ansi",
+	"ansi",
+	"ansi256",
+	"ansi16m"
+];
+const state = { level: stdoutColor ? stdoutColor.level : 0 };
+const applyStyle = (open, close, text) => {
+	if (state.level <= 0 || !text) return text;
+	let string = text;
+	if (string.includes("\x1B")) string = string.replaceAll(close, close + open);
+	if (string.includes("\n")) string = string.replaceAll(/\r?\n/g, `${close}$&${open}`);
+	return open + string + close;
+};
+const styleFunction = (open, close) => {
+	return (text) => applyStyle(open, close, text);
+};
+const foregroundOpen = (model, args) => {
+	return colorOpen(model, args, foreground, rgbToAnsi256, rgbToAnsi);
+};
+const backgroundOpen = (model, args) => {
+	return colorOpen(model, args, background, rgbToAnsi256, rgbToAnsi);
+};
+const colorOpen = (model, args, space, toAnsi256, toAnsi) => {
+	const rgb = typeof args[0] === "string" ? hexToRgb(args[0]) : args;
+	if (model === "ansi16m") return space.ansi16m(...rgb);
+	if (model === "ansi256") return space.ansi256(toAnsi256(...rgb));
+	return space.ansi(toAnsi(...rgb));
+};
+const named = {};
+for (const name of [
+	...modifierNames,
+	...foregroundColorNames,
+	...backgroundColorNames
+]) named[name] = styleFunction(styles[name].open, styles[name].close);
+const chalk = {
+	...named,
+	get level() {
+		return state.level;
+	},
+	set level(level) {
+		state.level = level;
+	},
+	hex: (color) => styleFunction(foregroundOpen(levelMapping[state.level], [color]), foreground.close),
+	bgHex: (color) => styleFunction(backgroundOpen(levelMapping[state.level], [color]), background.close),
+	rgb: (red, green, blue) => styleFunction(foregroundOpen(levelMapping[state.level], [
+		red,
+		green,
+		blue
+	]), foreground.close),
+	bgRgb: (red, green, blue) => styleFunction(backgroundOpen(levelMapping[state.level], [
+		red,
+		green,
+		blue
+	]), background.close),
+	ansi256: (code) => styleFunction(foreground.ansi256(code), foreground.close),
+	bgAnsi256: (code) => styleFunction(background.ansi256(code), background.close)
+};
+const supportsColor = stdoutColor;
 //#endregion
-export { BEL, C1_CSI, C1_ST, CSI, DEL, ESC, OSC, ST, ambiguousMaximumCodePoint, ambiguousMinimalCodePoint, ambiguousRanges, ansi256ToAnsi, ansiCodesToString, ansiEscapes, background, backgroundColorNames, bsu, chalk, clearTerminal, cliCursor, codes, cursorDown, cursorHide, cursorLeft, cursorNextLine, cursorShow, cursorTo, cursorUp, diffAnsiCodes, disableBracketedPaste, eastAsianWidth, eastAsianWidthType, enableBracketedPaste, endCodesSet, enterAlternativeScreen, eraseEndLine, eraseLine, eraseLines, eraseScreen, esu, exitAlternativeScreen, foreground, foregroundColorNames, fullwidthMaximumCodePoint, fullwidthMinimalCodePoint, fullwidthRanges, getCategory, getEndCode, getLinkStartCode, halfwidthMaximumCodePoint, halfwidthMinimalCodePoint, halfwidthRanges, hexToAnsi, hexToAnsi256, hexToRgb, isAmbiguous, isFullWidth, isFullwidthCodePoint, isFullwidthGrapheme, isIntensityCode, isWide, isWideNotCJKTNotEmoji, kittyQuery, link, modifierNames, narrowMaximumCodePoint, narrowMinimalCodePoint, narrowRanges, pasteEnd, pasteStart, popKittyKeyboard, pushKittyKeyboard, reduceAnsiCodes, reduceAnsiCodesIncremental, rgbToAnsi, rgbToAnsi256, sliceAnsi, stringWidth, stripAnsi, styledCharsFromTokens, styledCharsToString, styles, supportsColor, tokenize, cliTruncate as truncateAnsi, undoAnsiCodes, wideMaximumCodePoint, wideMinimalCodePoint, wideRanges, widestLine, wrapAnsi };
+//#region src/ansi/hyperlink.ts
+/**
+Wraps text in a clickable OSC 8 hyperlink when the terminal supports it,
+falling back to `text (url)`.
+
+```ts
+import { hyperlink } from "@alchemy.run/sigil/ansi";
+
+console.log(hyperlink("Documentation", "https://example.com"));
+```
+*/
+const hyperlink = (text, url, { fallback = true, stream = process.stdout } = {}) => {
+	if (detectHyperlinkSupport(stream)) return link(text, url);
+	return fallback ? `${text} (${url})` : text;
+};
+//#endregion
+export { BEL, C1_CSI, C1_ST, CSI, DEL, ESC, OSC, ST, ambiguousMaximumCodePoint, ambiguousMinimalCodePoint, ambiguousRanges, ansi256ToAnsi, ansiCodesToString, ansiEscapes, background, backgroundColorNames, bsu, chalk, clearClipboard, clearTerminal, cliCursor, codes, cursorColor, cursorDown, cursorHide, cursorLeft, cursorNextLine, cursorShape, cursorShow, cursorTo, cursorUp, diffAnsiCodes, disableBracketedPaste, eastAsianWidth, eastAsianWidthType, enableBracketedPaste, endCodesSet, enterAlternativeScreen, eraseEndLine, eraseLine, eraseLines, eraseScreen, esu, exitAlternativeScreen, foreground, foregroundColorNames, fullwidthMaximumCodePoint, fullwidthMinimalCodePoint, fullwidthRanges, getCategory, getEndCode, getLinkStartCode, halfwidthMaximumCodePoint, halfwidthMinimalCodePoint, halfwidthRanges, hexToAnsi, hexToAnsi256, hexToRgb, hyperlink, isAmbiguous, isFullWidth, isFullwidthCodePoint, isFullwidthGrapheme, isIntensityCode, isWide, isWideNotCJKTNotEmoji, kittyQuery, link, modifierNames, narrowMaximumCodePoint, narrowMinimalCodePoint, narrowRanges, notify, pasteEnd, pasteStart, popKittyKeyboard, pushKittyKeyboard, queryClipboard, reduceAnsiCodes, reduceAnsiCodesIncremental, resetCursorColor, rgbToAnsi, rgbToAnsi256, setClipboard, setPointerShape, setTerminalProgress, setWindowTitle, setWorkingDirectory, sliceAnsi, stringWidth, stripAnsi, styledCharsFromTokens, styledCharsToString, styles, supportsColor, tmuxPassthrough, tokenize, cliTruncate as truncateAnsi, undoAnsiCodes, wideMaximumCodePoint, wideMinimalCodePoint, wideRanges, widestLine, wrapAnsi };

package/dist/capabilities.d.ts

@@ -0,0 +1,5 @@
+import { a as Multiplexer, c as TerminalAppearance, d as detectCapabilities, f as detectColorLevel, h as detectUnicodeSupport, i as ColorSupportLevel, l as TerminalIdentity, m as detectTerminal, n as ColorInfo, o as PixelGeometry, p as detectHyperlinkSupport, r as ColorSupport, s as RgbColor, t as Capabilities, u as createSupportsColor } from "./detect-Bh4yGP6w.js";
+import { a as getTerminalQuery, i as applyTerminalQuery, n as TerminalQueryOptions, o as queryTerminal, r as TerminalQueryResult, s as refreshTerminalQuery, t as PixelSize } from "./query-vaIeGOkH.js";
+import { n as capabilities, r as getCapabilities, t as CapabilitiesStore } from "./store-CgrG9K4y.js";
+import { i as resolveColorProfile, n as ColorState, r as colorState, t as ColorPolicy } from "./color-policy-BMzMwV7Q.js";
+export { type Capabilities, type CapabilitiesStore, type ColorInfo, type ColorPolicy, type ColorState, type ColorSupport, type ColorSupportLevel, type Multiplexer, type PixelGeometry, type PixelSize, type RgbColor, type TerminalAppearance, type TerminalIdentity, type TerminalQueryOptions, type TerminalQueryResult, applyTerminalQuery, capabilities, colorState, createSupportsColor, detectCapabilities, detectColorLevel, detectHyperlinkSupport, detectTerminal, detectUnicodeSupport, getCapabilities, getTerminalQuery, queryTerminal, refreshTerminalQuery, resolveColorProfile };

package/dist/capabilities.js

@@ -0,0 +1,3 @@
+import { a as detectTerminal, i as detectHyperlinkSupport, n as detectCapabilities, o as detectUnicodeSupport, r as detectColorLevel, t as createSupportsColor } from "./detect-BuTXtY6e.js";
+import { d as queryTerminal, f as refreshTerminalQuery, i as getCapabilities, l as getTerminalQuery, n as resolveColorProfile, r as capabilities, s as applyTerminalQuery, t as colorState } from "./color-policy-SVj1pYTA.js";
+export { applyTerminalQuery, capabilities, colorState, createSupportsColor, detectCapabilities, detectColorLevel, detectHyperlinkSupport, detectTerminal, detectUnicodeSupport, getCapabilities, getTerminalQuery, queryTerminal, refreshTerminalQuery, resolveColorProfile };

package/dist/cell-_ZVhbfl0.js

@@ -0,0 +1,44 @@
+//#region src/screen/cell.ts
+/**
+Bit flags for terminal text attributes. Multiple attributes may be combined.
+*/
+const cellAttributes = {
+	none: 0,
+	bold: 1,
+	faint: 2,
+	italic: 4,
+	blink: 8,
+	rapidBlink: 16,
+	inverse: 32,
+	hidden: 64,
+	strikethrough: 128
+};
+const emptyCellStyle = {
+	underline: "none",
+	attributes: cellAttributes.none
+};
+const emptyCell = {
+	grapheme: " ",
+	width: 1,
+	style: emptyCellStyle
+};
+const createCell = (grapheme, width, style = emptyCellStyle, hyperlink, reset) => {
+	if (grapheme.length === 0) throw new Error("A cell must contain one grapheme cluster");
+	if (!Number.isInteger(width) || width < 1) throw new Error("A cell width must be a positive integer");
+	return {
+		grapheme,
+		width,
+		style,
+		...hyperlink ? { hyperlink } : {},
+		...reset ? { reset } : {}
+	};
+};
+const cellsEqual = (left, right) => {
+	if (left === right) return true;
+	if (!left || !right || left.grapheme !== right.grapheme || left.width !== right.width) return false;
+	const leftStyle = left.style;
+	const rightStyle = right.style;
+	return leftStyle.attributes === rightStyle.attributes && leftStyle.underline === rightStyle.underline && JSON.stringify(leftStyle.foreground) === JSON.stringify(rightStyle.foreground) && JSON.stringify(leftStyle.background) === JSON.stringify(rightStyle.background) && JSON.stringify(leftStyle.underlineColor) === JSON.stringify(rightStyle.underlineColor) && JSON.stringify(left.hyperlink) === JSON.stringify(right.hyperlink);
+};
+//#endregion
+export { emptyCellStyle as a, emptyCell as i, cellsEqual as n, createCell as r, cellAttributes as t };

package/dist/color-CkbalRqK.js

@@ -0,0 +1,2 @@
+import "./sample-Cqw1bjUL.js";
+export {};

package/dist/color-policy-BMzMwV7Q.d.ts

@@ -0,0 +1,22 @@
+import { i as ColorSupportLevel } from "./detect-Bh4yGP6w.js";
+import { t as ColorProfile } from "./color-profile-u0Nhe9Nv.js";
+//#region src/capabilities/color-policy.d.ts
+/** A user-selected output policy. `auto` follows the target stream. */
+type ColorPolicy = "auto" | ColorProfile;
+/** The three distinct inputs and result of terminal color negotiation. */
+type ColorState = {
+  /** The stream/terminal fact after environment and query detection. */
+  readonly detected: ColorProfile;
+  /** The application's policy for this render instance. */
+  readonly policy: ColorPolicy;
+  /** The profile the serializer must actually emit. */
+  readonly effective: ColorProfile;
+};
+declare function resolveColorProfile(detectedLevel: ColorSupportLevel, policy?: ColorPolicy): ColorProfile;
+declare function colorState(capabilities: {
+  readonly color: {
+    readonly level: ColorSupportLevel;
+  };
+}, policy?: ColorPolicy): ColorState;
+//#endregion
+export { resolveColorProfile as i, ColorState as n, colorState as r, ColorPolicy as t };