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

package/src/ansi/supports-color.ts

@@ -1,207 +0,0 @@
-// Terminal color support detection.
-// Ported from `supports-color` (MIT, Sindre Sorhus & Josh Junon).
-import { isatty } from "node:tty";
-
-import { isWindows } from "#/env.ts";
-
-export type ColorSupportLevel = 0 | 1 | 2 | 3;
-
-export type ColorSupport = {
-  readonly level: ColorSupportLevel;
-  readonly hasBasic: boolean;
-  readonly has256: boolean;
-  readonly has16m: boolean;
-};
-
-export type ColorInfo = ColorSupport | false;
-
-function hasFlag(flag: string, argv: readonly string[] = process.argv): boolean {
-  const prefix = flag.startsWith("-") ? "" : flag.length === 1 ? "-" : "--";
-  const position = argv.indexOf(prefix + flag);
-  const terminatorPosition = argv.indexOf("--");
-  return position !== -1 && (terminatorPosition === -1 || position < terminatorPosition);
-}
-
-const { env } = process;
-
-let flagForceColor: number | undefined;
-if (
-  hasFlag("no-color") ||
-  hasFlag("no-colors") ||
-  hasFlag("color=false") ||
-  hasFlag("color=never")
-) {
-  flagForceColor = 0;
-} else if (
-  hasFlag("color") ||
-  hasFlag("colors") ||
-  hasFlag("color=true") ||
-  hasFlag("color=always")
-) {
-  flagForceColor = 1;
-}
-
-function envForceColor(): number | undefined {
-  if (!("FORCE_COLOR" in env)) {
-    return;
-  }
-
-  if (env["FORCE_COLOR"] === "true") {
-    return 1;
-  }
-
-  if (env["FORCE_COLOR"] === "false") {
-    return 0;
-  }
-
-  return env["FORCE_COLOR"]!.length === 0
-    ? 1
-    : Math.min(Number.parseInt(env["FORCE_COLOR"]!, 10), 3);
-}
-
-function translateLevel(level: number): ColorInfo {
-  if (level === 0) {
-    return false;
-  }
-
-  return {
-    level: level as ColorSupportLevel,
-    hasBasic: true,
-    has256: level >= 2,
-    has16m: level >= 3,
-  };
-}
-
-type Options = {
-  readonly streamIsTTY?: boolean;
-  readonly sniffFlags?: boolean;
-};
-
-// eslint-disable-next-line complexity
-function supportsColorLevel(
-  haveStream: boolean,
-  { streamIsTTY, sniffFlags = true }: Options = {},
-): number {
-  const noFlagForceColor = envForceColor();
-  if (noFlagForceColor !== undefined) {
-    flagForceColor = noFlagForceColor;
-  }
-
-  const forceColor = sniffFlags ? flagForceColor : noFlagForceColor;
-
-  if (forceColor === 0) {
-    return 0;
-  }
-
-  if (sniffFlags) {
-    if (hasFlag("color=16m") || hasFlag("color=full") || hasFlag("color=truecolor")) {
-      return 3;
-    }
-
-    if (hasFlag("color=256")) {
-      return 2;
-    }
-  }
-
-  // Check for Azure DevOps pipelines. Has to be above the `!streamIsTTY` check.
-  if ("TF_BUILD" in env && "AGENT_NAME" in env) {
-    return 1;
-  }
-
-  if (haveStream && !streamIsTTY && forceColor === undefined) {
-    return 0;
-  }
-
-  const min = forceColor ?? 0;
-
-  if (env["TERM"] === "dumb") {
-    return min;
-  }
-
-  if (isWindows) {
-    // Node 22 requires Windows 10 1809+ (build 17763), which supports TrueColor.
-    return 3;
-  }
-
-  if ("CI" in env) {
-    if (["GITHUB_ACTIONS", "GITEA_ACTIONS", "CIRCLECI"].some((key) => key in env)) {
-      return 3;
-    }
-
-    if (
-      ["TRAVIS", "APPVEYOR", "GITLAB_CI", "BUILDKITE", "DRONE"].some((sign) => sign in env) ||
-      env["CI_NAME"] === "codeship"
-    ) {
-      return 1;
-    }
-
-    return min;
-  }
-
-  if ("TEAMCITY_VERSION" in env) {
-    return /^(9\.(0*[1-9]\d*)\.|\d{2,}\.)/.test(env["TEAMCITY_VERSION"]!) ? 1 : 0;
-  }
-
-  if (env["COLORTERM"] === "truecolor") {
-    return 3;
-  }
-
-  if (env["TERM"] === "xterm-kitty") {
-    return 3;
-  }
-
-  if (env["TERM"] === "xterm-ghostty") {
-    return 3;
-  }
-
-  if (env["TERM"] === "wezterm") {
-    return 3;
-  }
-
-  if ("TERM_PROGRAM" in env) {
-    const version = Number.parseInt((env["TERM_PROGRAM_VERSION"] ?? "").split(".")[0]!, 10);
-
-    switch (env["TERM_PROGRAM"]) {
-      case "iTerm.app": {
-        return version >= 3 ? 3 : 2;
-      }
-
-      case "Apple_Terminal": {
-        return 2;
-      }
-
-      default:
-    }
-  }
-
-  if (/-256(color)?$/i.test(env["TERM"] ?? "")) {
-    return 2;
-  }
-
-  if (/^screen|^xterm|^vt100|^vt220|^rxvt|color|ansi|cygwin|linux/i.test(env["TERM"] ?? "")) {
-    return 1;
-  }
-
-  if ("COLORTERM" in env) {
-    return 1;
-  }
-
-  return min;
-}
-
-export function createSupportsColor(
-  stream: { isTTY?: boolean } | undefined,
-  options: Options = {},
-): ColorInfo {
-  const level = supportsColorLevel(Boolean(stream), {
-    streamIsTTY: Boolean(stream?.isTTY),
-    ...options,
-  });
-
-  return translateLevel(level);
-}
-
-export const supportsColor = {
-  stdout: createSupportsColor({ isTTY: isatty(1) }),
-  stderr: createSupportsColor({ isTTY: isatty(2) }),
-};

package/src/colorize.ts

@@ -1,60 +0,0 @@
-import { chalk, type ForegroundColorName, type BackgroundColorName } from "#/ansi/chalk.ts";
-
-type ColorType = "foreground" | "background";
-
-const rgbRegex = /^rgb\(\s?(\d+),\s?(\d+),\s?(\d+)\s?\)$/;
-const ansiRegex = /^ansi256\(\s?(\d+)\s?\)$/;
-
-const isNamedColor = (color: string): color is ForegroundColorName => {
-  return color in chalk;
-};
-
-export const colorize = (str: string, color: string | undefined, type: ColorType): string => {
-  if (!color) {
-    return str;
-  }
-
-  if (isNamedColor(color)) {
-    if (type === "foreground") {
-      return chalk[color](str);
-    }
-
-    const methodName = `bg${color[0]!.toUpperCase() + color.slice(1)}` as BackgroundColorName;
-
-    return chalk[methodName](str);
-  }
-
-  if (color.startsWith("#")) {
-    return type === "foreground" ? chalk.hex(color)(str) : chalk.bgHex(color)(str);
-  }
-
-  if (color.startsWith("ansi256")) {
-    const matches = ansiRegex.exec(color);
-
-    if (!matches) {
-      return str;
-    }
-
-    const value = Number(matches[1]);
-
-    return type === "foreground" ? chalk.ansi256(value)(str) : chalk.bgAnsi256(value)(str);
-  }
-
-  if (color.startsWith("rgb")) {
-    const matches = rgbRegex.exec(color);
-
-    if (!matches) {
-      return str;
-    }
-
-    const firstValue = Number(matches[1]);
-    const secondValue = Number(matches[2]);
-    const thirdValue = Number(matches[3]);
-
-    return type === "foreground"
-      ? chalk.rgb(firstValue, secondValue, thirdValue)(str)
-      : chalk.bgRgb(firstValue, secondValue, thirdValue)(str);
-  }
-
-  return str;
-};

package/src/log-update.ts

@@ -1,370 +0,0 @@
-import { cliCursor } from "#/ansi/cursor.ts";
-import { ansiEscapes } from "#/ansi/escapes.ts";
-import {
-  type CursorPosition,
-  cursorPositionChanged,
-  buildCursorSuffix,
-  buildCursorOnlySequence,
-  buildReturnToBottomPrefix,
-  hideCursorEscape,
-} from "#/cursor-position.ts";
-
-export type { CursorPosition } from "#/cursor-position.ts";
-
-export type LogUpdate = {
-  clear: () => void;
-  done: () => void;
-  reset: () => void;
-  sync: (str: string) => void;
-  setCursorPosition: (position: CursorPosition | undefined) => void;
-  isCursorDirty: () => boolean;
-  willRender: (str: string) => boolean;
-  (str: string): boolean;
-};
-
-// Count visible lines in a string, ignoring the trailing empty element
-// that `split('\n')` produces when the string ends with '\n'.
-const visibleLineCount = (lines: string[], str: string): number =>
-  str.endsWith("\n") ? lines.length - 1 : lines.length;
-
-const createStandard = (stream: NodeJS.WritableStream, { showCursor = false } = {}): LogUpdate => {
-  let previousLineCount = 0;
-  let previousOutput = "";
-  let hasHiddenCursor = false;
-  let cursorPosition: CursorPosition | undefined;
-  let cursorDirty = false;
-  let previousCursorPosition: CursorPosition | undefined;
-  let cursorWasShown = false;
-
-  const getActiveCursor = () => (cursorDirty ? cursorPosition : undefined);
-  const hasChanges = (str: string, activeCursor: CursorPosition | undefined): boolean => {
-    const cursorChanged = cursorPositionChanged(activeCursor, previousCursorPosition);
-    return str !== previousOutput || cursorChanged;
-  };
-
-  const render = (str: string) => {
-    if (!showCursor && !hasHiddenCursor) {
-      cliCursor.hide(stream);
-      hasHiddenCursor = true;
-    }
-
-    // Only use cursor if setCursorPosition was called since last render.
-    // This ensures stale positions don't persist after component unmount.
-    const activeCursor = getActiveCursor();
-    cursorDirty = false;
-    const cursorChanged = cursorPositionChanged(activeCursor, previousCursorPosition);
-
-    if (!hasChanges(str, activeCursor)) {
-      return false;
-    }
-
-    const lines = str.split("\n");
-    const cursorSuffix = buildCursorSuffix(lines.length - 1, activeCursor);
-
-    if (str === previousOutput && cursorChanged) {
-      stream.write(
-        buildCursorOnlySequence({
-          cursorWasShown,
-          previousLineCount,
-          previousCursorPosition,
-          cursorPosition: activeCursor,
-        }),
-      );
-    } else {
-      previousOutput = str;
-      const returnPrefix = buildReturnToBottomPrefix(
-        cursorWasShown,
-        previousLineCount,
-        previousCursorPosition,
-      );
-      stream.write(returnPrefix + ansiEscapes.eraseLines(previousLineCount) + str + cursorSuffix);
-      previousLineCount = lines.length;
-    }
-
-    previousCursorPosition = activeCursor ? { ...activeCursor } : undefined;
-    cursorWasShown = activeCursor !== undefined;
-    return true;
-  };
-
-  render.clear = () => {
-    const prefix = buildReturnToBottomPrefix(
-      cursorWasShown,
-      previousLineCount,
-      previousCursorPosition,
-    );
-    stream.write(prefix + ansiEscapes.eraseLines(previousLineCount));
-    previousOutput = "";
-    previousLineCount = 0;
-    previousCursorPosition = undefined;
-    cursorWasShown = false;
-  };
-
-  render.done = () => {
-    previousOutput = "";
-    previousLineCount = 0;
-    previousCursorPosition = undefined;
-    cursorWasShown = false;
-
-    if (!showCursor) {
-      cliCursor.show(stream);
-      hasHiddenCursor = false;
-    }
-  };
-
-  render.reset = () => {
-    previousOutput = "";
-    previousLineCount = 0;
-    previousCursorPosition = undefined;
-    cursorWasShown = false;
-  };
-
-  render.sync = (str: string) => {
-    const activeCursor = cursorDirty ? cursorPosition : undefined;
-    cursorDirty = false;
-
-    const lines = str.split("\n");
-    previousOutput = str;
-    previousLineCount = lines.length;
-
-    if (!activeCursor && cursorWasShown) {
-      stream.write(hideCursorEscape);
-    }
-
-    if (activeCursor) {
-      stream.write(buildCursorSuffix(lines.length - 1, activeCursor));
-    }
-
-    previousCursorPosition = activeCursor ? { ...activeCursor } : undefined;
-    cursorWasShown = activeCursor !== undefined;
-  };
-
-  render.setCursorPosition = (position: CursorPosition | undefined) => {
-    cursorPosition = position;
-    cursorDirty = true;
-  };
-
-  render.isCursorDirty = () => cursorDirty;
-  render.willRender = (str: string) => hasChanges(str, getActiveCursor());
-
-  return render;
-};
-
-const createIncremental = (
-  stream: NodeJS.WritableStream,
-  { showCursor = false } = {},
-): LogUpdate => {
-  let previousLines: string[] = [];
-  let previousOutput = "";
-  let hasHiddenCursor = false;
-  let cursorPosition: CursorPosition | undefined;
-  let cursorDirty = false;
-  let previousCursorPosition: CursorPosition | undefined;
-  let cursorWasShown = false;
-
-  const getActiveCursor = () => (cursorDirty ? cursorPosition : undefined);
-  const hasChanges = (str: string, activeCursor: CursorPosition | undefined): boolean => {
-    const cursorChanged = cursorPositionChanged(activeCursor, previousCursorPosition);
-    return str !== previousOutput || cursorChanged;
-  };
-
-  const render = (str: string) => {
-    if (!showCursor && !hasHiddenCursor) {
-      cliCursor.hide(stream);
-      hasHiddenCursor = true;
-    }
-
-    // Only use cursor if setCursorPosition was called since last render.
-    // This ensures stale positions don't persist after component unmount.
-    const activeCursor = getActiveCursor();
-    cursorDirty = false;
-    const cursorChanged = cursorPositionChanged(activeCursor, previousCursorPosition);
-
-    if (!hasChanges(str, activeCursor)) {
-      return false;
-    }
-
-    const nextLines = str.split("\n");
-    const visibleCount = visibleLineCount(nextLines, str);
-    const previousVisible = visibleLineCount(previousLines, previousOutput);
-
-    if (str === previousOutput && cursorChanged) {
-      stream.write(
-        buildCursorOnlySequence({
-          cursorWasShown,
-          previousLineCount: previousLines.length,
-          previousCursorPosition,
-          cursorPosition: activeCursor,
-        }),
-      );
-      previousCursorPosition = activeCursor ? { ...activeCursor } : undefined;
-      cursorWasShown = activeCursor !== undefined;
-      return true;
-    }
-
-    const returnPrefix = buildReturnToBottomPrefix(
-      cursorWasShown,
-      previousLines.length,
-      previousCursorPosition,
-    );
-
-    if (str === "\n" || previousOutput.length === 0) {
-      const cursorSuffix = buildCursorSuffix(nextLines.length - 1, activeCursor);
-      stream.write(
-        returnPrefix + ansiEscapes.eraseLines(previousLines.length) + str + cursorSuffix,
-      );
-      cursorWasShown = activeCursor !== undefined;
-      previousCursorPosition = activeCursor ? { ...activeCursor } : undefined;
-      previousOutput = str;
-      previousLines = nextLines;
-      return true;
-    }
-
-    // A frame that grew may need rows past the bottom margin. The
-    // incremental walk moves over unchanged lines with cursorNextLine,
-    // which clamps at the bottom margin instead of scrolling (only a
-    // line feed scrolls), so a grown frame that reaches the bottom
-    // desynchronizes the tracked cursor position from the terminal.
-    // Rewrite the whole frame instead — every line is emitted with a
-    // newline, which scrolls correctly at the bottom.
-    if (visibleCount > previousVisible) {
-      const cursorSuffix = buildCursorSuffix(visibleCount, activeCursor);
-      stream.write(
-        returnPrefix + ansiEscapes.eraseLines(previousLines.length) + str + cursorSuffix,
-      );
-      cursorWasShown = activeCursor !== undefined;
-      previousCursorPosition = activeCursor ? { ...activeCursor } : undefined;
-      previousOutput = str;
-      previousLines = nextLines;
-      return true;
-    }
-
-    const hasTrailingNewline = str.endsWith("\n");
-
-    // We aggregate all chunks for incremental rendering into a buffer, and then write them to stdout at the end.
-    const buffer: string[] = [];
-
-    buffer.push(returnPrefix);
-
-    // Clear extra lines if the current content's line count is lower than the previous.
-    if (visibleCount < previousVisible) {
-      const previousHadTrailingNewline = previousOutput.endsWith("\n");
-      const extraSlot = previousHadTrailingNewline ? 1 : 0;
-      buffer.push(
-        ansiEscapes.eraseLines(previousVisible - visibleCount + extraSlot),
-        ansiEscapes.cursorUp(visibleCount),
-      );
-    } else {
-      buffer.push(ansiEscapes.cursorUp(previousLines.length - 1));
-    }
-
-    for (let i = 0; i < visibleCount; i++) {
-      const isLastLine = i === visibleCount - 1;
-
-      // We do not write lines if the contents are the same. This prevents flickering during renders.
-      if (nextLines[i] === previousLines[i]) {
-        // Don't move past the last line when there's no trailing newline,
-        // otherwise the cursor overshoots the rendered block.
-        if (!isLastLine || hasTrailingNewline) {
-          buffer.push(ansiEscapes.cursorNextLine);
-        }
-
-        continue;
-      }
-
-      buffer.push(
-        ansiEscapes.cursorTo(0) +
-          nextLines[i] +
-          ansiEscapes.eraseEndLine +
-          // Don't append newline after the last line when the input
-          // has no trailing newline (fullscreen mode).
-          (isLastLine && !hasTrailingNewline ? "" : "\n"),
-      );
-    }
-
-    const cursorSuffix = buildCursorSuffix(nextLines.length - 1, activeCursor);
-    buffer.push(cursorSuffix);
-
-    stream.write(buffer.join(""));
-
-    cursorWasShown = activeCursor !== undefined;
-    previousCursorPosition = activeCursor ? { ...activeCursor } : undefined;
-    previousOutput = str;
-    previousLines = nextLines;
-    return true;
-  };
-
-  render.clear = () => {
-    const prefix = buildReturnToBottomPrefix(
-      cursorWasShown,
-      previousLines.length,
-      previousCursorPosition,
-    );
-    stream.write(prefix + ansiEscapes.eraseLines(previousLines.length));
-    previousOutput = "";
-    previousLines = [];
-    previousCursorPosition = undefined;
-    cursorWasShown = false;
-  };
-
-  render.done = () => {
-    previousOutput = "";
-    previousLines = [];
-    previousCursorPosition = undefined;
-    cursorWasShown = false;
-
-    if (!showCursor) {
-      cliCursor.show(stream);
-      hasHiddenCursor = false;
-    }
-  };
-
-  render.reset = () => {
-    previousOutput = "";
-    previousLines = [];
-    previousCursorPosition = undefined;
-    cursorWasShown = false;
-  };
-
-  render.sync = (str: string) => {
-    const activeCursor = cursorDirty ? cursorPosition : undefined;
-    cursorDirty = false;
-
-    const lines = str.split("\n");
-    previousOutput = str;
-    previousLines = lines;
-
-    if (!activeCursor && cursorWasShown) {
-      stream.write(hideCursorEscape);
-    }
-
-    if (activeCursor) {
-      stream.write(buildCursorSuffix(lines.length - 1, activeCursor));
-    }
-
-    previousCursorPosition = activeCursor ? { ...activeCursor } : undefined;
-    cursorWasShown = activeCursor !== undefined;
-  };
-
-  render.setCursorPosition = (position: CursorPosition | undefined) => {
-    cursorPosition = position;
-    cursorDirty = true;
-  };
-
-  render.isCursorDirty = () => cursorDirty;
-  render.willRender = (str: string) => hasChanges(str, getActiveCursor());
-
-  return render;
-};
-
-const create = (
-  stream: NodeJS.WritableStream,
-  { showCursor = false, incremental = false } = {},
-): LogUpdate => {
-  if (incremental) {
-    return createIncremental(stream, { showCursor });
-  }
-
-  return createStandard(stream, { showCursor });
-};
-
-export const logUpdate = { create };