bun.sh/src/fmt.zig

const std = @import("std");
const bun = @import("root").bun;
const Output = bun.Output;
const strings = bun.strings;
const string = bun.string;
const js_lexer = bun.js_lexer;
const ComptimeStringMap = bun.ComptimeStringMap;
const fmt = std.fmt;
const Environment = bun.Environment;

pub usingnamespace std.fmt;

const SharedTempBuffer = [32 * 1024]u8;
fn getSharedBuffer() []u8 {
    return std.mem.asBytes(shared_temp_buffer_ptr orelse brk: {
        shared_temp_buffer_ptr = bun.default_allocator.create(SharedTempBuffer) catch unreachable;
        break :brk shared_temp_buffer_ptr.?;
    });
}
threadlocal var shared_temp_buffer_ptr: ?*SharedTempBuffer = null;

pub fn formatUTF16Type(comptime Slice: type, slice_: Slice, writer: anytype) !void {
    var chunk = getSharedBuffer();

    // Defensively ensure recursion doesn't cause the buffer to be overwritten in-place
    shared_temp_buffer_ptr = null;
    defer {
        if (shared_temp_buffer_ptr) |existing| {
            if (existing != chunk.ptr) {
                bun.default_allocator.destroy(@as(*SharedTempBuffer, @ptrCast(chunk.ptr)));
            }
        } else {
            shared_temp_buffer_ptr = @ptrCast(chunk.ptr);
        }
    }

    var slice = slice_;

    while (slice.len > 0) {
        const result = strings.copyUTF16IntoUTF8(chunk, Slice, slice, true);
        if (result.read == 0 or result.written == 0)
            break;
        try writer.writeAll(chunk[0..result.written]);
        slice = slice[result.read..];
    }
}

pub fn formatUTF16TypeEscapeBackslashes(comptime Slice: type, slice_: Slice, writer: anytype) !void {
    var chunk = getSharedBuffer();

    // Defensively ensure recursion doesn't cause the buffer to be overwritten in-place
    shared_temp_buffer_ptr = null;
    defer {
        if (shared_temp_buffer_ptr) |existing| {
            if (existing != chunk.ptr) {
                bun.default_allocator.destroy(@as(*SharedTempBuffer, @ptrCast(chunk.ptr)));
            }
        } else {
            shared_temp_buffer_ptr = @ptrCast(chunk.ptr);
        }
    }

    var slice = slice_;

    while (slice.len > 0) {
        const result = strings.copyUTF16IntoUTF8(chunk, Slice, slice, true);
        if (result.read == 0 or result.written == 0)
            break;

        const to_write = chunk[0..result.written];
        var ptr = to_write;
        while (strings.indexOfChar(ptr, '\\')) |i| {
            try writer.writeAll(ptr[0 .. i + 1]);
            try writer.writeAll("\\");
            ptr = ptr[i + 1 ..];
        }
        try writer.writeAll(ptr);
        slice = slice[result.read..];
    }
}

pub fn formatUTF16(slice_: []align(1) const u16, writer: anytype) !void {
    return formatUTF16Type([]align(1) const u16, slice_, writer);
}

pub const FormatUTF16 = struct {
    buf: []const u16,
    escape_backslashes: bool = false,
    pub fn format(self: @This(), comptime _: []const u8, _: anytype, writer: anytype) !void {
        if (self.escape_backslashes) {
            try formatUTF16TypeEscapeBackslashes([]const u16, self.buf, writer);
        } else {
            try formatUTF16Type([]const u16, self.buf, writer);
        }
    }
};

pub const FormatUTF8 = struct {
    buf: []const u8,
    escape_backslashes: bool = false,
    pub fn format(self: @This(), comptime _: []const u8, _: anytype, writer: anytype) !void {
        if (self.escape_backslashes) {
            var ptr = self.buf;
            while (strings.indexOfChar(ptr, '\\')) |i| {
                try writer.writeAll(ptr[0 .. i + 1]);
                try writer.writeAll("\\");
                ptr = ptr[i + 1 ..];
            }
            try writer.writeAll(ptr);
        } else {
            try writer.writeAll(self.buf);
        }
    }
};

pub const PathFormatOptions = struct {
    escape_backslashes: bool = false,
};

pub fn fmtUTF16(buf: []const u16) FormatUTF16 {
    return FormatUTF16{ .buf = buf };
}

pub const FormatOSPath = if (Environment.isWindows) FormatUTF16 else FormatUTF8;

pub fn fmtOSPath(buf: bun.OSPathSlice, options: PathFormatOptions) FormatOSPath {
    return FormatOSPath{
        .buf = buf,
        .escape_backslashes = options.escape_backslashes,
    };
}

pub fn fmtPath(
    comptime T: type,
    path: []const T,
    options: PathFormatOptions,
) if (T == u8) FormatUTF8 else FormatUTF16 {
    if (T == u8) {
        return FormatUTF8{
            .buf = path,
            .escape_backslashes = options.escape_backslashes,
        };
    }

    return FormatUTF16{
        .buf = path,
        .escape_backslashes = options.escape_backslashes,
    };
}

pub fn formatLatin1(slice_: []const u8, writer: anytype) !void {
    var chunk = getSharedBuffer();
    var slice = slice_;

    // Defensively ensure recursion doesn't cause the buffer to be overwritten in-place
    shared_temp_buffer_ptr = null;
    defer {
        if (shared_temp_buffer_ptr) |existing| {
            if (existing != chunk.ptr) {
                bun.default_allocator.destroy(@as(*SharedTempBuffer, @ptrCast(chunk.ptr)));
            }
        } else {
            shared_temp_buffer_ptr = @ptrCast(chunk.ptr);
        }
    }

    while (strings.firstNonASCII(slice)) |i| {
        if (i > 0) {
            try writer.writeAll(slice[0..i]);
            slice = slice[i..];
        }
        const result = strings.copyLatin1IntoUTF8(chunk, @TypeOf(slice), slice[0..@min(chunk.len, slice.len)]);
        if (result.read == 0 or result.written == 0)
            break;
        try writer.writeAll(chunk[0..result.written]);
        slice = slice[result.read..];
    }

    if (slice.len > 0)
        try writer.writeAll(slice); // write the remaining bytes
}

pub const URLFormatter = struct {
    proto: Proto = .http,
    hostname: ?string = null,
    port: ?u16 = null,

    const Proto = enum {
        http,
        https,
        unix,
    };

    pub fn format(this: URLFormatter, comptime _: []const u8, _: std.fmt.FormatOptions, writer: anytype) !void {
        try writer.print("{s}://", .{switch (this.proto) {
            .http => "http",
            .https => "https",
            .unix => "unix",
        }});

        if (this.hostname) |hostname| {
            const needs_brackets = hostname[0] != '[' and strings.isIPV6Address(hostname);
            if (needs_brackets) {
                try writer.print("[{s}]", .{hostname});
            } else {
                try writer.writeAll(hostname);
            }
        } else {
            try writer.writeAll("localhost");
        }

        if (this.proto == .unix) {
            return;
        }

        const is_port_optional = this.port == null or (this.proto == .https and this.port == 443) or
            (this.proto == .http and this.port == 80);
        if (is_port_optional) {
            try writer.writeAll("/");
        } else {
            try writer.print(":{d}/", .{this.port.?});
        }
    }
};

pub const HostFormatter = struct {
    host: string,
    port: ?u16 = null,
    is_https: bool = false,

    pub fn format(formatter: HostFormatter, comptime _: []const u8, _: std.fmt.FormatOptions, writer: anytype) !void {
        if (strings.indexOfChar(formatter.host, ':') != null) {
            try writer.writeAll(formatter.host);
            return;
        }

        try writer.writeAll(formatter.host);

        const is_port_optional = formatter.port == null or (formatter.is_https and formatter.port == 443) or
            (!formatter.is_https and formatter.port == 80);
        if (!is_port_optional) {
            try writer.print(":{d}", .{formatter.port.?});
            return;
        }
    }
};

/// Format a string to an ECMAScript identifier.
/// Unlike the string_mutable.zig version, this always allocate/copy
pub fn fmtIdentifier(name: string) FormatValidIdentifier {
    return FormatValidIdentifier{ .name = name };
}

/// Format a string to an ECMAScript identifier.
/// Different implementation than string_mutable because string_mutable may avoid allocating
/// This will always allocate
pub const FormatValidIdentifier = struct {
    name: string,
    pub fn format(self: FormatValidIdentifier, comptime _: []const u8, _: std.fmt.FormatOptions, writer: anytype) !void {
        var iterator = strings.CodepointIterator.init(self.name);
        var cursor = strings.CodepointIterator.Cursor{};

        var has_needed_gap = false;
        var needs_gap = false;
        var start_i: usize = 0;

        if (!iterator.next(&cursor)) {
            try writer.writeAll("_");
            return;
        }

        // Common case: no gap necessary. No allocation necessary.
        needs_gap = !js_lexer.isIdentifierStart(cursor.c);
        if (!needs_gap) {
            // Are there any non-alphanumeric chars at all?
            while (iterator.next(&cursor)) {
                if (!js_lexer.isIdentifierContinue(cursor.c) or cursor.width > 1) {
                    needs_gap = true;
                    start_i = cursor.i;
                    break;
                }
            }
        }

        if (needs_gap) {
            needs_gap = false;
            if (start_i > 0) try writer.writeAll(self.name[0..start_i]);
            var slice = self.name[start_i..];
            iterator = strings.CodepointIterator.init(slice);
            cursor = strings.CodepointIterator.Cursor{};

            while (iterator.next(&cursor)) {
                if (js_lexer.isIdentifierContinue(cursor.c) and cursor.width == 1) {
                    if (needs_gap) {
                        try writer.writeAll("_");
                        needs_gap = false;
                        has_needed_gap = true;
                    }
                    try writer.writeAll(slice[cursor.i .. cursor.i + @as(u32, cursor.width)]);
                } else if (!needs_gap) {
                    needs_gap = true;
                    // skip the code point, replace it with a single _
                }
            }

            // If it ends with an emoji
            if (needs_gap) {
                try writer.writeAll("_");
                needs_gap = false;
                has_needed_gap = true;
            }

            return;
        }

        try writer.writeAll(self.name);
    }
};

// Formats a string to be safe to output in a Github action.
// - Encodes "\n" as "%0A" to support multi-line strings.
//   https://github.com/actions/toolkit/issues/193#issuecomment-605394935
// - Strips ANSI output as it will appear malformed.
pub fn githubActionWriter(writer: anytype, self: string) !void {
    var offset: usize = 0;
    const end = @as(u32, @truncate(self.len));
    while (offset < end) {
        if (strings.indexOfNewlineOrNonASCIIOrANSI(self, @as(u32, @truncate(offset)))) |i| {
            const byte = self[i];
            if (byte > 0x7F) {
                offset += @max(strings.wtf8ByteSequenceLength(byte), 1);
                continue;
            }
            if (i > 0) {
                try writer.writeAll(self[offset..i]);
            }
            var n: usize = 1;
            if (byte == '\n') {
                try writer.writeAll("%0A");
            } else if (i + 1 < end) {
                const next = self[i + 1];
                if (byte == '\r' and next == '\n') {
                    n += 1;
                    try writer.writeAll("%0A");
                } else if (byte == '\x1b' and next == '[') {
                    n += 1;
                    if (i + 2 < end) {
                        const remain = self[(i + 2)..@min(i + 5, end)];
                        if (strings.indexOfChar(remain, 'm')) |j| {
                            n += j + 1;
                        }
                    }
                }
            }
            offset = i + n;
        } else {
            try writer.writeAll(self[offset..end]);
            break;
        }
    }
}

pub const GithubActionFormatter = struct {
    text: string,

    pub fn format(this: GithubActionFormatter, comptime _: []const u8, _: std.fmt.FormatOptions, writer: anytype) !void {
        try githubActionWriter(writer, this.text);
    }
};

pub fn githubAction(self: string) strings.GithubActionFormatter {
    return GithubActionFormatter{
        .text = self,
    };
}

pub fn quotedWriter(writer: anytype, self: string) !void {
    const remain = self;
    if (strings.containsNewlineOrNonASCIIOrQuote(remain)) {
        try bun.js_printer.writeJSONString(self, @TypeOf(writer), writer, strings.Encoding.utf8);
    } else {
        try writer.writeAll("\"");
        try writer.writeAll(self);
        try writer.writeAll("\"");
    }
}

pub const QuotedFormatter = struct {
    text: []const u8,

    pub fn format(this: QuotedFormatter, comptime _: []const u8, _: std.fmt.FormatOptions, writer: anytype) !void {
        try quotedWriter(writer, this.text);
    }
};

pub fn fmtJavaScript(text: []const u8, enable_ansi_colors: bool) QuickAndDirtyJavaScriptSyntaxHighlighter {
    return QuickAndDirtyJavaScriptSyntaxHighlighter{
        .text = text,
        .enable_colors = enable_ansi_colors,
    };
}

pub const QuickAndDirtyJavaScriptSyntaxHighlighter = struct {
    text: []const u8,
    enable_colors: bool = false,
    limited: bool = true,

    const ColorCode = enum {
        magenta,
        blue,
        orange,
        red,
        pink,

        pub fn color(this: ColorCode) []const u8 {
            return switch (this) {
                .magenta => "\x1b[35m",
                .blue => "\x1b[34m",
                .orange => "\x1b[33m",
                .red => "\x1b[31m",
                // light pink
                .pink => "\x1b[38;5;206m",
            };
        }
    };

    pub const Keyword = enum {
        abstract,
        as,
        @"async",
        @"await",
        case,
        @"catch",
        class,
        @"const",
        @"continue",
        debugger,
        default,
        delete,
        do,
        @"else",
        @"enum",
        @"export",
        extends,
        false,
        finally,
        @"for",
        function,
        @"if",
        implements,
        import,
        in,
        instanceof,
        interface,
        let,
        new,
        null,
        package,
        private,
        protected,
        public,
        @"return",
        static,
        super,
        @"switch",
        this,
        throw,
        @"break",
        true,
        @"try",
        type,
        typeof,
        @"var",
        void,
        @"while",
        with,
        yield,
        string,
        number,
        boolean,
        symbol,
        any,
        object,
        unknown,
        never,
        namespace,
        declare,
        readonly,
        undefined,

        pub fn colorCode(this: Keyword) ColorCode {
            return switch (this) {
                Keyword.abstract => ColorCode.blue,
                Keyword.as => ColorCode.blue,
                Keyword.@"async" => ColorCode.magenta,
                Keyword.@"await" => ColorCode.magenta,
                Keyword.case => ColorCode.magenta,
                Keyword.@"catch" => ColorCode.magenta,
                Keyword.class => ColorCode.magenta,
                Keyword.@"const" => ColorCode.magenta,
                Keyword.@"continue" => ColorCode.magenta,
                Keyword.debugger => ColorCode.magenta,
                Keyword.default => ColorCode.magenta,
                Keyword.delete => ColorCode.red,
                Keyword.do => ColorCode.magenta,
                Keyword.@"else" => ColorCode.magenta,
                Keyword.@"break" => ColorCode.magenta,
                Keyword.undefined => ColorCode.orange,
                Keyword.@"enum" => ColorCode.blue,
                Keyword.@"export" => ColorCode.magenta,
                Keyword.extends => ColorCode.magenta,
                Keyword.false => ColorCode.orange,
                Keyword.finally => ColorCode.magenta,
                Keyword.@"for" => ColorCode.magenta,
                Keyword.function => ColorCode.magenta,
                Keyword.@"if" => ColorCode.magenta,
                Keyword.implements => ColorCode.blue,
                Keyword.import => ColorCode.magenta,
                Keyword.in => ColorCode.magenta,
                Keyword.instanceof => ColorCode.magenta,
                Keyword.interface => ColorCode.blue,
                Keyword.let => ColorCode.magenta,
                Keyword.new => ColorCode.magenta,
                Keyword.null => ColorCode.orange,
                Keyword.package => ColorCode.magenta,
                Keyword.private => ColorCode.blue,
                Keyword.protected => ColorCode.blue,
                Keyword.public => ColorCode.blue,
                Keyword.@"return" => ColorCode.magenta,
                Keyword.static => ColorCode.magenta,
                Keyword.super => ColorCode.magenta,
                Keyword.@"switch" => ColorCode.magenta,
                Keyword.this => ColorCode.orange,
                Keyword.throw => ColorCode.magenta,
                Keyword.true => ColorCode.orange,
                Keyword.@"try" => ColorCode.magenta,
                Keyword.type => ColorCode.blue,
                Keyword.typeof => ColorCode.magenta,
                Keyword.@"var" => ColorCode.magenta,
                Keyword.void => ColorCode.magenta,
                Keyword.@"while" => ColorCode.magenta,
                Keyword.with => ColorCode.magenta,
                Keyword.yield => ColorCode.magenta,
                Keyword.string => ColorCode.blue,
                Keyword.number => ColorCode.blue,
                Keyword.boolean => ColorCode.blue,
                Keyword.symbol => ColorCode.blue,
                Keyword.any => ColorCode.blue,
                Keyword.object => ColorCode.blue,
                Keyword.unknown => ColorCode.blue,
                Keyword.never => ColorCode.blue,
                Keyword.namespace => ColorCode.blue,
                Keyword.declare => ColorCode.blue,
                Keyword.readonly => ColorCode.blue,
            };
        }
    };

    pub const Keywords = ComptimeStringMap(Keyword, .{
        .{ "abstract", Keyword.abstract },
        .{ "any", Keyword.any },
        .{ "as", Keyword.as },
        .{ "async", Keyword.@"async" },
        .{ "await", Keyword.@"await" },
        .{ "boolean", Keyword.boolean },
        .{ "break", Keyword.@"break" },
        .{ "case", Keyword.case },
        .{ "catch", Keyword.@"catch" },
        .{ "class", Keyword.class },
        .{ "const", Keyword.@"const" },
        .{ "continue", Keyword.@"continue" },
        .{ "debugger", Keyword.debugger },
        .{ "declare", Keyword.declare },
        .{ "default", Keyword.default },
        .{ "delete", Keyword.delete },
        .{ "do", Keyword.do },
        .{ "else", Keyword.@"else" },
        .{ "enum", Keyword.@"enum" },
        .{ "export", Keyword.@"export" },
        .{ "extends", Keyword.extends },
        .{ "false", Keyword.false },
        .{ "finally", Keyword.finally },
        .{ "for", Keyword.@"for" },
        .{ "function", Keyword.function },
        .{ "if", Keyword.@"if" },
        .{ "implements", Keyword.implements },
        .{ "import", Keyword.import },
        .{ "in", Keyword.in },
        .{ "instanceof", Keyword.instanceof },
        .{ "interface", Keyword.interface },
        .{ "let", Keyword.let },
        .{ "namespace", Keyword.namespace },
        .{ "never", Keyword.never },
        .{ "new", Keyword.new },
        .{ "null", Keyword.null },
        .{ "number", Keyword.number },
        .{ "object", Keyword.object },
        .{ "package", Keyword.package },
        .{ "private", Keyword.private },
        .{ "protected", Keyword.protected },
        .{ "public", Keyword.public },
        .{ "readonly", Keyword.readonly },
        .{ "return", Keyword.@"return" },
        .{ "static", Keyword.static },
        .{ "string", Keyword.string },
        .{ "super", Keyword.super },
        .{ "switch", Keyword.@"switch" },
        .{ "symbol", Keyword.symbol },
        .{ "this", Keyword.this },
        .{ "throw", Keyword.throw },
        .{ "true", Keyword.true },
        .{ "try", Keyword.@"try" },
        .{ "type", Keyword.type },
        .{ "typeof", Keyword.typeof },
        .{ "undefined", Keyword.undefined },
        .{ "unknown", Keyword.unknown },
        .{ "var", Keyword.@"var" },
        .{ "void", Keyword.void },
        .{ "while", Keyword.@"while" },
        .{ "with", Keyword.with },
        .{ "yield", Keyword.yield },
    });

    pub fn format(this: @This(), comptime _: []const u8, _: fmt.FormatOptions, writer: anytype) !void {
        const text = this.text;

        if (this.limited) {
            if (!this.enable_colors or text.len > 2048 or text.len == 0 or !strings.isAllASCII(text)) {
                try writer.writeAll(text);
                return;
            }
        }

        var remain = text;
        var prev_keyword: ?Keyword = null;

        outer: while (remain.len > 0) {
            if (js_lexer.isIdentifierStart(remain[0])) {
                var i: usize = 1;

                while (i < remain.len and js_lexer.isIdentifierContinue(remain[i])) {
                    i += 1;
                }

                if (Keywords.get(remain[0..i])) |keyword| {
                    if (keyword != .as)
                        prev_keyword = keyword;
                    const code = keyword.colorCode();
                    try writer.print(Output.prettyFmt("<r>{s}{s}<r>", true), .{ code.color(), remain[0..i] });
                } else {
                    write: {
                        if (prev_keyword) |prev| {
                            switch (prev) {
                                .new => {
                                    prev_keyword = null;

                                    if (i < remain.len and remain[i] == '(') {
                                        try writer.print(Output.prettyFmt("<r><b>{s}<r>", true), .{remain[0..i]});
                                        break :write;
                                    }
                                },
                                .abstract, .namespace, .declare, .type, .interface => {
                                    try writer.print(Output.prettyFmt("<r><b><blue>{s}<r>", true), .{remain[0..i]});
                                    prev_keyword = null;
                                    break :write;
                                },
                                .import => {
                                    if (strings.eqlComptime(remain[0..i], "from")) {
                                        const code = ColorCode.magenta;
                                        try writer.print(Output.prettyFmt("<r>{s}{s}<r>", true), .{ code.color(), remain[0..i] });
                                        prev_keyword = null;

                                        break :write;
                                    }
                                },
                                else => {},
                            }
                        }

                        try writer.writeAll(remain[0..i]);
                    }
                }
                remain = remain[i..];
            } else {
                switch (remain[0]) {
                    '0'...'9' => {
                        prev_keyword = null;
                        var i: usize = 1;
                        if (remain.len > 1 and remain[0] == '0' and remain[1] == 'x') {
                            i += 1;
                            while (i < remain.len and switch (remain[i]) {
                                '0'...'9', 'a'...'f', 'A'...'F' => true,
                                else => false,
                            }) {
                                i += 1;
                            }
                        } else {
                            while (i < remain.len and switch (remain[i]) {
                                '0'...'9', '.', 'e', 'E', 'x', 'X', 'b', 'B', 'o', 'O' => true,
                                else => false,
                            }) {
                                i += 1;
                            }
                        }

                        try writer.print(Output.prettyFmt("<r><yellow>{s}<r>", true), .{remain[0..i]});
                        remain = remain[i..];
                    },
                    inline '`', '"', '\'' => |char| {
                        prev_keyword = null;

                        var i: usize = 1;
                        while (i < remain.len and remain[i] != char) {
                            if (comptime char == '`') {
                                if (remain[i] == '$' and i + 1 < remain.len and remain[i + 1] == '{') {
                                    const curly_start = i;
                                    i += 2;

                                    while (i < remain.len and remain[i] != '}') {
                                        if (remain[i] == '\\') {
                                            i += 1;
                                        }
                                        i += 1;
                                    }

                                    try writer.print(Output.prettyFmt("<r><green>{s}<r>", true), .{remain[0..curly_start]});
                                    try writer.writeAll("${");
                                    const curly_remain = QuickAndDirtyJavaScriptSyntaxHighlighter{
                                        .text = remain[curly_start + 2 .. i],
                                        .enable_colors = this.enable_colors,
                                        .limited = false,
                                    };

                                    if (curly_remain.text.len > 0) {
                                        try curly_remain.format("", .{}, writer);
                                    }

                                    if (i < remain.len and remain[i] == '}') {
                                        i += 1;
                                    }
                                    try writer.writeAll("}");
                                    remain = remain[i..];
                                    i = 0;
                                    if (remain.len > 0 and remain[0] == char) {
                                        try writer.writeAll(Output.prettyFmt("<r><green>`<r>", true));
                                        remain = remain[1..];
                                        continue :outer;
                                    }
                                    continue;
                                }
                            }

                            if (i + 1 < remain.len and remain[i] == '\\') {
                                i += 1;
                            }

                            i += 1;
                        }

                        // Include the trailing quote, if any
                        i += @as(usize, @intFromBool(i > 1 and i < remain.len and remain[i] == char));

                        try writer.print(Output.prettyFmt("<r><green>{s}<r>", true), .{remain[0..i]});
                        remain = remain[i..];
                    },
                    '/' => {
                        prev_keyword = null;
                        var i: usize = 1;

                        // the start of a line comment
                        if (i < remain.len and remain[i] == '/') {
                            while (i < remain.len and remain[i] != '\n') {
                                i += 1;
                            }

                            const remain_to_print = remain[0..i];
                            if (i < remain.len and remain[i] == '\n') {
                                i += 1;
                            }

                            if (i < remain.len and remain[i] == '\r') {
                                i += 1;
                            }

                            try writer.print(Output.prettyFmt("<r><d>{s}<r>", true), .{remain_to_print});
                            remain = remain[i..];
                            continue;
                        }

                        as_multiline_comment: {
                            if (i < remain.len and remain[i] == '*') {
                                i += 1;

                                while (i + 2 < remain.len and !strings.eqlComptime(remain[i..][0..2], "*/")) {
                                    i += 1;
                                }

                                if (i + 2 < remain.len and strings.eqlComptime(remain[i..][0..2], "*/")) {
                                    i += 2;
                                } else {
                                    i = 1;
                                    break :as_multiline_comment;
                                }

                                try writer.print(Output.prettyFmt("<r><d>{s}<r>", true), .{remain[0..i]});
                                remain = remain[i..];
                                continue;
                            }
                        }

                        try writer.writeAll(remain[0..i]);
                        remain = remain[i..];
                    },
                    '}', '{' => {
                        // support potentially highlighting "from" in an import statement
                        if ((prev_keyword orelse Keyword.@"continue") != .import) {
                            prev_keyword = null;
                        }

                        try writer.writeAll(remain[0..1]);
                        remain = remain[1..];
                    },
                    '[', ']' => {
                        prev_keyword = null;
                        try writer.writeAll(remain[0..1]);
                        remain = remain[1..];
                    },
                    ';' => {
                        prev_keyword = null;
                        try writer.print(Output.prettyFmt("<r><d>;<r>", true), .{});
                        remain = remain[1..];
                    },
                    '.' => {
                        prev_keyword = null;
                        var i: usize = 1;
                        if (remain.len > 1 and (js_lexer.isIdentifierStart(remain[1]) or remain[1] == '#')) {
                            i = 2;

                            while (i < remain.len and js_lexer.isIdentifierContinue(remain[i])) {
                                i += 1;
                            }

                            if (i < remain.len and (remain[i] == '(')) {
                                try writer.print(Output.prettyFmt("<r><i><b>{s}<r>", true), .{remain[0..i]});
                                remain = remain[i..];
                                continue;
                            }
                            i = 1;
                        }

                        try writer.writeAll(remain[0..1]);
                        remain = remain[1..];
                    },

                    '<' => {
                        var i: usize = 1;

                        // JSX
                        jsx: {
                            if (remain.len > 1 and remain[0] == '/') {
                                i = 2;
                            }
                            prev_keyword = null;

                            while (i < remain.len and js_lexer.isIdentifierContinue(remain[i])) {
                                i += 1;
                            } else {
                                i = 1;
                                break :jsx;
                            }

                            while (i < remain.len and remain[i] != '>') {
                                i += 1;

                                if (i < remain.len and remain[i] == '<') {
                                    i = 1;
                                    break :jsx;
                                }
                            }

                            if (i < remain.len and remain[i] == '>') {
                                i += 1;
                                try writer.print(Output.prettyFmt("<r><cyan>{s}<r>", true), .{remain[0..i]});
                                remain = remain[i..];
                                continue;
                            }

                            i = 1;
                        }

                        try writer.print(Output.prettyFmt("<r>{s}<r>", true), .{remain[0..i]});
                        remain = remain[i..];
                    },

                    else => {
                        try writer.writeAll(remain[0..1]);
                        remain = remain[1..];
                    },
                }
            }
        }
    }
};

pub fn quote(self: string) bun.fmt.QuotedFormatter {
    return bun.fmt.QuotedFormatter{
        .text = self,
    };
}

pub fn EnumTagListFormatter(comptime Enum: type, comptime Separator: @Type(.EnumLiteral)) type {
    return struct {
        pretty: bool = true,
        const output = brk: {
            var text: []const u8 = "";
            const names = std.meta.fieldNames(Enum);
            for (names, 0..) |name, i| {
                if (Separator == .list) {
                    if (i > 0) {
                        if (i + 1 == names.len) {
                            text = text ++ ", or ";
                        } else {
                            text = text ++ ", ";
                        }
                    }

                    text = text ++ "\"" ++ name ++ "\"";
                } else if (Separator == .dash) {
                    text = text ++ "\n-  " ++ name;
                } else {
                    @compileError("Unknown separator type: must be .dash or .list");
                }
            }
            break :brk text;
        };
        pub fn format(_: @This(), comptime _: []const u8, _: fmt.FormatOptions, writer: anytype) !void {
            try writer.writeAll(output);
        }
    };
}

pub fn enumTagList(comptime Enum: type, comptime separator: @Type(.EnumLiteral)) EnumTagListFormatter(Enum, separator) {
    return EnumTagListFormatter(Enum, separator){};
}

pub fn formatIp(address: std.net.Address, into: []u8) ![]u8 {
    // std.net.Address.format includes `:<port>` and square brackets (IPv6)
    //  while Node does neither.  This uses format then strips these to bring
    //  the result into conformance with Node.
    var result = try std.fmt.bufPrint(into, "{}", .{address});

    // Strip `:<port>`
    if (std.mem.lastIndexOfScalar(u8, result, ':')) |colon| {
        result = result[0..colon];
    }
    // Strip brackets
    if (result[0] == '[' and result[result.len - 1] == ']') {
        result = result[1 .. result.len - 1];
    }
    return result;
}

// https://lemire.me/blog/2021/06/03/computing-the-number-of-digits-of-an-integer-even-faster/
pub fn fastDigitCount(x: u64) u64 {
    if (x == 0) {
        return 1;
    }

    const table = [_]u64{
        4294967296,
        8589934582,
        8589934582,
        8589934582,
        12884901788,
        12884901788,
        12884901788,
        17179868184,
        17179868184,
        17179868184,
        21474826480,
        21474826480,
        21474826480,
        21474826480,
        25769703776,
        25769703776,
        25769703776,
        30063771072,
        30063771072,
        30063771072,
        34349738368,
        34349738368,
        34349738368,
        34349738368,
        38554705664,
        38554705664,
        38554705664,
        41949672960,
        41949672960,
        41949672960,
        42949672960,
        42949672960,
    };
    return x + table[std.math.log2(x)] >> 32;
}

pub const SizeFormatter = struct {
    value: usize = 0,
    pub fn format(self: SizeFormatter, comptime _: []const u8, opts: fmt.FormatOptions, writer: anytype) !void {
        const math = std.math;
        const value = self.value;
        if (value == 0) {
            return writer.writeAll("0 KB");
        }

        if (value < 512) {
            try fmt.formatInt(self.value, 10, .lower, opts, writer);
            return writer.writeAll(" bytes");
        }

        const mags_si = " KMGTPEZY";
        const log2 = math.log2(value);
        const magnitude = @min(log2 / comptime math.log2(1000), mags_si.len - 1);
        const new_value = math.lossyCast(f64, value) / math.pow(f64, 1000, math.lossyCast(f64, magnitude));
        const suffix = mags_si[magnitude];

        if (suffix == ' ') {
            try fmt.formatFloatDecimal(new_value / 1000.0, .{ .precision = 2 }, writer);
            return writer.writeAll(" KB");
        } else {
            try fmt.formatFloatDecimal(new_value, .{ .precision = if (std.math.approxEqAbs(f64, new_value, @trunc(new_value), 0.100)) @as(usize, 1) else @as(usize, 2) }, writer);
        }
        return writer.writeAll(&[_]u8{ ' ', suffix, 'B' });
    }
};

pub fn size(value: anytype) SizeFormatter {
    return switch (@TypeOf(value)) {
        f64, f32, f128 => SizeFormatter{
            .value = @as(u64, @intFromFloat(value)),
        },
        else => SizeFormatter{ .value = @as(u64, @intCast(value)) },
    };
}

const lower_hex_table = [_]u8{
    '0',
    '1',
    '2',
    '3',
    '4',
    '5',
    '6',
    '7',
    '8',
    '9',
    'a',
    'b',
    'c',
    'd',
    'e',
    'f',
};
const upper_hex_table = [_]u8{
    '0',
    '1',
    '2',
    '3',
    '4',
    '5',
    '6',
    '7',
    '8',
    '9',
    'A',
    'B',
    'C',
    'D',
    'E',
    'F',
};
pub fn HexIntFormatter(comptime Int: type, comptime lower: bool) type {
    return struct {
        value: Int,

        const table = if (lower) lower_hex_table else upper_hex_table;

        const BufType = [@bitSizeOf(Int) / 4]u8;

        fn getOutBuf(value: Int) BufType {
            var buf: BufType = undefined;
            inline for (&buf, 0..) |*c, i| {
                // value relative to the current nibble
                c.* = table[@as(u8, @as(u4, @truncate(value >> comptime ((buf.len - i - 1) * 4)))) & 0xF];
            }
            return buf;
        }

        pub fn format(self: @This(), comptime _: []const u8, _: fmt.FormatOptions, writer: anytype) !void {
            const value = self.value;
            try writer.writeAll(&getOutBuf(value));
        }
    };
}

pub fn HexInt(comptime Int: type, comptime lower: std.fmt.Case, value: Int) HexIntFormatter(Int, lower == .lower) {
    const Formatter = HexIntFormatter(Int, lower == .lower);
    return Formatter{ .value = value };
}

pub fn hexIntLower(value: anytype) HexIntFormatter(@TypeOf(value), true) {
    const Formatter = HexIntFormatter(@TypeOf(value), true);
    return Formatter{ .value = value };
}

pub fn hexIntUpper(value: anytype) HexIntFormatter(@TypeOf(value), false) {
    const Formatter = HexIntFormatter(@TypeOf(value), false);
    return Formatter{ .value = value };
}

const FormatDurationData = struct {
    ns: u64,
    negative: bool = false,
};

/// This is copied from std.fmt.formatDuration, except it will only print one decimal instead of three
fn formatDurationOneDecimal(data: FormatDurationData, comptime _: []const u8, opts: std.fmt.FormatOptions, writer: anytype) !void {
    // worst case: "-XXXyXXwXXdXXhXXmXX.XXXs".len = 24
    var buf: [24]u8 = undefined;
    var fbs = std.io.fixedBufferStream(&buf);
    var buf_writer = fbs.writer();
    if (data.negative) {
        buf_writer.writeByte('-') catch unreachable;
    }

    var ns_remaining = data.ns;
    inline for (.{
        .{ .ns = 365 * std.time.ns_per_day, .sep = 'y' },
        .{ .ns = std.time.ns_per_week, .sep = 'w' },
        .{ .ns = std.time.ns_per_day, .sep = 'd' },
        .{ .ns = std.time.ns_per_hour, .sep = 'h' },
        .{ .ns = std.time.ns_per_min, .sep = 'm' },
    }) |unit| {
        if (ns_remaining >= unit.ns) {
            const units = ns_remaining / unit.ns;
            std.fmt.formatInt(units, 10, .lower, .{}, buf_writer) catch unreachable;
            buf_writer.writeByte(unit.sep) catch unreachable;
            ns_remaining -= units * unit.ns;
            if (ns_remaining == 0)
                return std.fmt.formatBuf(fbs.getWritten(), opts, writer);
        }
    }

    inline for (.{
        .{ .ns = std.time.ns_per_s, .sep = "s" },
        .{ .ns = std.time.ns_per_ms, .sep = "ms" },
        .{ .ns = std.time.ns_per_us, .sep = "us" },
    }) |unit| {
        const kunits = ns_remaining * 1000 / unit.ns;
        if (kunits >= 1000) {
            std.fmt.formatInt(kunits / 1000, 10, .lower, .{}, buf_writer) catch unreachable;
            const frac = @divFloor(kunits % 1000, 100);
            if (frac > 0) {
                var decimal_buf = [_]u8{ '.', 0 };
                _ = std.fmt.formatIntBuf(decimal_buf[1..], frac, 10, .lower, .{ .fill = '0', .width = 1 });
                buf_writer.writeAll(&decimal_buf) catch unreachable;
            }
            buf_writer.writeAll(unit.sep) catch unreachable;
            return std.fmt.formatBuf(fbs.getWritten(), opts, writer);
        }
    }

    std.fmt.formatInt(ns_remaining, 10, .lower, .{}, buf_writer) catch unreachable;
    buf_writer.writeAll("ns") catch unreachable;
    return std.fmt.formatBuf(fbs.getWritten(), opts, writer);
}

/// Return a Formatter for number of nanoseconds according to its magnitude:
/// [#y][#w][#d][#h][#m]#[.###][n|u|m]s
pub fn fmtDurationOneDecimal(ns: u64) std.fmt.Formatter(formatDurationOneDecimal) {
    return .{ .data = FormatDurationData{ .ns = ns } };
}
// };