es-toolkit 1.46.1-dev.1804 → 1.46.1-dev.1805

package/dist/server/colors/_internal/parseHex.js

@@ -0,0 +1,32 @@
+//#region src/server/colors/_internal/parseHex.ts
+const BLACK = [
+	0,
+	0,
+	0
+];
+const HEX_COLOR_REGEX = /^[0-9a-fA-F]{3}$|^[0-9a-fA-F]{6}$/;
+/**
+* Parses a hex color string (e.g. "#ff0000", "#f00", "ff0000") into
+* an [r, g, b] tuple. Used by `hex()` and `bgHex()` to convert
+* user-provided hex values into RGB components for ANSI escape codes.
+*
+* Only #RGB and #RRGGBB formats are supported. #RGBA and #RRGGBBAA
+* are not accepted because ANSI terminals do not support alpha channels.
+* Returns [0, 0, 0] (black) for invalid input.
+*
+* @param hex - A hex color string, with or without the leading `#`.
+* @returns An `[r, g, b]` tuple with each component in the 0–255 range.
+*/
+function parseHex(hex) {
+	const raw = hex.startsWith("#") ? hex.slice(1) : hex;
+	if (!HEX_COLOR_REGEX.test(raw)) return BLACK;
+	const full = raw.length === 3 ? raw[0] + raw[0] + raw[1] + raw[1] + raw[2] + raw[2] : raw;
+	const colorValue = parseInt(full, 16);
+	return [
+		colorValue >> 16 & 255,
+		colorValue >> 8 & 255,
+		colorValue & 255
+	];
+}
+//#endregion
+exports.parseHex = parseHex;

package/dist/server/colors/_internal/parseHex.mjs

@@ -0,0 +1,32 @@
+//#region src/server/colors/_internal/parseHex.ts
+const BLACK = [
+	0,
+	0,
+	0
+];
+const HEX_COLOR_REGEX = /^[0-9a-fA-F]{3}$|^[0-9a-fA-F]{6}$/;
+/**
+* Parses a hex color string (e.g. "#ff0000", "#f00", "ff0000") into
+* an [r, g, b] tuple. Used by `hex()` and `bgHex()` to convert
+* user-provided hex values into RGB components for ANSI escape codes.
+*
+* Only #RGB and #RRGGBB formats are supported. #RGBA and #RRGGBBAA
+* are not accepted because ANSI terminals do not support alpha channels.
+* Returns [0, 0, 0] (black) for invalid input.
+*
+* @param hex - A hex color string, with or without the leading `#`.
+* @returns An `[r, g, b]` tuple with each component in the 0–255 range.
+*/
+function parseHex(hex) {
+	const raw = hex.startsWith("#") ? hex.slice(1) : hex;
+	if (!HEX_COLOR_REGEX.test(raw)) return BLACK;
+	const full = raw.length === 3 ? raw[0] + raw[0] + raw[1] + raw[1] + raw[2] + raw[2] : raw;
+	const colorValue = parseInt(full, 16);
+	return [
+		colorValue >> 16 & 255,
+		colorValue >> 8 & 255,
+		colorValue & 255
+	];
+}
+//#endregion
+export { parseHex };

package/dist/server/colors/_internal/wrapAnsi.js

@@ -0,0 +1,21 @@
+//#region src/server/colors/_internal/wrapAnsi.ts
+/**
+* Wraps text with ANSI open/close codes for foreground colors and modifiers.
+*
+* If `text` already contains `close` (typically from a nested style that
+* shares the same close code, e.g. `red(green('x'))` where both end with
+* `\x1b[39m`), re-opens the outer style after each occurrence so the rest
+* of the text keeps its color. For background colors use `wrapAnsiBg`
+* instead — it adds the newline handling that backgrounds need.
+*
+* @param open - The ANSI open code (e.g. `\x1b[31m`).
+* @param close - The ANSI close code (e.g. `\x1b[39m`).
+* @param text - The text to wrap.
+* @returns The wrapped text.
+*/
+function wrapAnsi(open, close, text) {
+	if (text.includes(close)) text = text.replaceAll(close, close + open);
+	return open + text + close;
+}
+//#endregion
+exports.wrapAnsi = wrapAnsi;

package/dist/server/colors/_internal/wrapAnsi.mjs

@@ -0,0 +1,21 @@
+//#region src/server/colors/_internal/wrapAnsi.ts
+/**
+* Wraps text with ANSI open/close codes for foreground colors and modifiers.
+*
+* If `text` already contains `close` (typically from a nested style that
+* shares the same close code, e.g. `red(green('x'))` where both end with
+* `\x1b[39m`), re-opens the outer style after each occurrence so the rest
+* of the text keeps its color. For background colors use `wrapAnsiBg`
+* instead — it adds the newline handling that backgrounds need.
+*
+* @param open - The ANSI open code (e.g. `\x1b[31m`).
+* @param close - The ANSI close code (e.g. `\x1b[39m`).
+* @param text - The text to wrap.
+* @returns The wrapped text.
+*/
+function wrapAnsi(open, close, text) {
+	if (text.includes(close)) text = text.replaceAll(close, close + open);
+	return open + text + close;
+}
+//#endregion
+export { wrapAnsi };

package/dist/server/colors/_internal/wrapAnsiBg.js

@@ -0,0 +1,30 @@
+//#region src/server/colors/_internal/wrapAnsiBg.ts
+/**
+* Wraps text with ANSI open/close codes for background colors.
+*
+* On top of the basic wrap, handles two cases:
+*
+* 1. **Nested style sharing the same close.** If `text` already contains
+*    `close` (e.g. `bgRed(bgGreen('x'))` where both end with `\x1b[49m`),
+*    re-opens the outer style after each occurrence so the rest keeps its
+*    color. This step runs first.
+* 2. **Multi-line text.** Terminals reset the background color at line
+*    boundaries, so the bg disappears after `\n` if not re-opened. Insert
+*    `close + open` around every newline. CRLF is treated as a single unit
+*    so the close sits outside both characters.
+*
+* Step 2 must run after step 1 — otherwise the close codes that step 2
+* inserts would also trigger step 1's re-open and leak duplicate codes.
+*
+* @param open - The ANSI background open code (e.g. `\x1b[41m`).
+* @param close - The ANSI background close code (e.g. `\x1b[49m`).
+* @param text - The text to wrap.
+* @returns The wrapped text.
+*/
+function wrapAnsiBg(open, close, text) {
+	if (text.includes(close)) text = text.replaceAll(close, close + open);
+	if (text.includes("\n")) text = text.replaceAll(/\r?\n/g, (match) => close + match + open);
+	return open + text + close;
+}
+//#endregion
+exports.wrapAnsiBg = wrapAnsiBg;

package/dist/server/colors/_internal/wrapAnsiBg.mjs

@@ -0,0 +1,30 @@
+//#region src/server/colors/_internal/wrapAnsiBg.ts
+/**
+* Wraps text with ANSI open/close codes for background colors.
+*
+* On top of the basic wrap, handles two cases:
+*
+* 1. **Nested style sharing the same close.** If `text` already contains
+*    `close` (e.g. `bgRed(bgGreen('x'))` where both end with `\x1b[49m`),
+*    re-opens the outer style after each occurrence so the rest keeps its
+*    color. This step runs first.
+* 2. **Multi-line text.** Terminals reset the background color at line
+*    boundaries, so the bg disappears after `\n` if not re-opened. Insert
+*    `close + open` around every newline. CRLF is treated as a single unit
+*    so the close sits outside both characters.
+*
+* Step 2 must run after step 1 — otherwise the close codes that step 2
+* inserts would also trigger step 1's re-open and leak duplicate codes.
+*
+* @param open - The ANSI background open code (e.g. `\x1b[41m`).
+* @param close - The ANSI background close code (e.g. `\x1b[49m`).
+* @param text - The text to wrap.
+* @returns The wrapped text.
+*/
+function wrapAnsiBg(open, close, text) {
+	if (text.includes(close)) text = text.replaceAll(close, close + open);
+	if (text.includes("\n")) text = text.replaceAll(/\r?\n/g, (match) => close + match + open);
+	return open + text + close;
+}
+//#endregion
+export { wrapAnsiBg };

package/dist/server/colors/ansi256.d.mts

@@ -0,0 +1,18 @@
+import { ColorFunction } from "./types.mjs";
+
+//#region src/server/colors/ansi256.d.ts
+/**
+ * Returns a function that wraps text with the given 8-bit (256-color) foreground.
+ *
+ * @param code - The 8-bit color code (0–255).
+ * @returns A color function that wraps text with the chosen ANSI 256 foreground.
+ *
+ * @example
+ * import { colors } from 'es-toolkit/server';
+ *
+ * const orange = colors.ansi256(208);
+ * console.log(orange('hello'));
+ */
+declare function ansi256(code: number): ColorFunction;
+//#endregion
+export { ansi256 };

package/dist/server/colors/ansi256.d.ts

@@ -0,0 +1,18 @@
+import { ColorFunction } from "./types.js";
+
+//#region src/server/colors/ansi256.d.ts
+/**
+ * Returns a function that wraps text with the given 8-bit (256-color) foreground.
+ *
+ * @param code - The 8-bit color code (0–255).
+ * @returns A color function that wraps text with the chosen ANSI 256 foreground.
+ *
+ * @example
+ * import { colors } from 'es-toolkit/server';
+ *
+ * const orange = colors.ansi256(208);
+ * console.log(orange('hello'));
+ */
+declare function ansi256(code: number): ColorFunction;
+//#endregion
+export { ansi256 };

package/dist/server/colors/ansi256.js

@@ -0,0 +1,19 @@
+const require_wrapAnsi = require("./_internal/wrapAnsi.js");
+//#region src/server/colors/ansi256.ts
+/**
+* Returns a function that wraps text with the given 8-bit (256-color) foreground.
+*
+* @param code - The 8-bit color code (0–255).
+* @returns A color function that wraps text with the chosen ANSI 256 foreground.
+*
+* @example
+* import { colors } from 'es-toolkit/server';
+*
+* const orange = colors.ansi256(208);
+* console.log(orange('hello'));
+*/
+function ansi256(code) {
+	return (text) => require_wrapAnsi.wrapAnsi(`\x1b[38;5;${code}m`, "\x1B[39m", text);
+}
+//#endregion
+exports.ansi256 = ansi256;

package/dist/server/colors/ansi256.mjs

@@ -0,0 +1,19 @@
+import { wrapAnsi } from "./_internal/wrapAnsi.mjs";
+//#region src/server/colors/ansi256.ts
+/**
+* Returns a function that wraps text with the given 8-bit (256-color) foreground.
+*
+* @param code - The 8-bit color code (0–255).
+* @returns A color function that wraps text with the chosen ANSI 256 foreground.
+*
+* @example
+* import { colors } from 'es-toolkit/server';
+*
+* const orange = colors.ansi256(208);
+* console.log(orange('hello'));
+*/
+function ansi256(code) {
+	return (text) => wrapAnsi(`\x1b[38;5;${code}m`, "\x1B[39m", text);
+}
+//#endregion
+export { ansi256 };

package/dist/server/colors/bgAnsi256.d.mts

@@ -0,0 +1,18 @@
+import { ColorFunction } from "./types.mjs";
+
+//#region src/server/colors/bgAnsi256.d.ts
+/**
+ * Returns a function that wraps text with the given 8-bit (256-color) background.
+ *
+ * @param code - The 8-bit color code (0–255).
+ * @returns A color function that wraps text with the chosen ANSI 256 background.
+ *
+ * @example
+ * import { colors } from 'es-toolkit/server';
+ *
+ * const warn = colors.bgAnsi256(208);
+ * console.log(warn('hello'));
+ */
+declare function bgAnsi256(code: number): ColorFunction;
+//#endregion
+export { bgAnsi256 };

package/dist/server/colors/bgAnsi256.d.ts

@@ -0,0 +1,18 @@
+import { ColorFunction } from "./types.js";
+
+//#region src/server/colors/bgAnsi256.d.ts
+/**
+ * Returns a function that wraps text with the given 8-bit (256-color) background.
+ *
+ * @param code - The 8-bit color code (0–255).
+ * @returns A color function that wraps text with the chosen ANSI 256 background.
+ *
+ * @example
+ * import { colors } from 'es-toolkit/server';
+ *
+ * const warn = colors.bgAnsi256(208);
+ * console.log(warn('hello'));
+ */
+declare function bgAnsi256(code: number): ColorFunction;
+//#endregion
+export { bgAnsi256 };

package/dist/server/colors/bgAnsi256.js

@@ -0,0 +1,19 @@
+const require_wrapAnsiBg = require("./_internal/wrapAnsiBg.js");
+//#region src/server/colors/bgAnsi256.ts
+/**
+* Returns a function that wraps text with the given 8-bit (256-color) background.
+*
+* @param code - The 8-bit color code (0–255).
+* @returns A color function that wraps text with the chosen ANSI 256 background.
+*
+* @example
+* import { colors } from 'es-toolkit/server';
+*
+* const warn = colors.bgAnsi256(208);
+* console.log(warn('hello'));
+*/
+function bgAnsi256(code) {
+	return (text) => require_wrapAnsiBg.wrapAnsiBg(`\x1b[48;5;${code}m`, "\x1B[49m", text);
+}
+//#endregion
+exports.bgAnsi256 = bgAnsi256;

package/dist/server/colors/bgAnsi256.mjs

@@ -0,0 +1,19 @@
+import { wrapAnsiBg } from "./_internal/wrapAnsiBg.mjs";
+//#region src/server/colors/bgAnsi256.ts
+/**
+* Returns a function that wraps text with the given 8-bit (256-color) background.
+*
+* @param code - The 8-bit color code (0–255).
+* @returns A color function that wraps text with the chosen ANSI 256 background.
+*
+* @example
+* import { colors } from 'es-toolkit/server';
+*
+* const warn = colors.bgAnsi256(208);
+* console.log(warn('hello'));
+*/
+function bgAnsi256(code) {
+	return (text) => wrapAnsiBg(`\x1b[48;5;${code}m`, "\x1B[49m", text);
+}
+//#endregion
+export { bgAnsi256 };

package/dist/server/colors/bgBlack.d.mts

@@ -0,0 +1,15 @@
+//#region src/server/colors/bgBlack.d.ts
+/**
+ * Black background. Wraps text with ANSI codes.
+ *
+ * @param text - The text to style.
+ * @returns The styled text.
+ *
+ * @example
+ * import { colors } from 'es-toolkit/server';
+ *
+ * console.log(colors.bgBlack('hello'));
+ */
+declare function bgBlack(text: string): string;
+//#endregion
+export { bgBlack };

package/dist/server/colors/bgBlack.d.ts

@@ -0,0 +1,15 @@
+//#region src/server/colors/bgBlack.d.ts
+/**
+ * Black background. Wraps text with ANSI codes.
+ *
+ * @param text - The text to style.
+ * @returns The styled text.
+ *
+ * @example
+ * import { colors } from 'es-toolkit/server';
+ *
+ * console.log(colors.bgBlack('hello'));
+ */
+declare function bgBlack(text: string): string;
+//#endregion
+export { bgBlack };

package/dist/server/colors/bgBlack.js

@@ -0,0 +1,18 @@
+const require_wrapAnsiBg = require("./_internal/wrapAnsiBg.js");
+//#region src/server/colors/bgBlack.ts
+/**
+* Black background. Wraps text with ANSI codes.
+*
+* @param text - The text to style.
+* @returns The styled text.
+*
+* @example
+* import { colors } from 'es-toolkit/server';
+*
+* console.log(colors.bgBlack('hello'));
+*/
+function bgBlack(text) {
+	return require_wrapAnsiBg.wrapAnsiBg("\x1B[40m", "\x1B[49m", text);
+}
+//#endregion
+exports.bgBlack = bgBlack;

package/dist/server/colors/bgBlack.mjs

@@ -0,0 +1,18 @@
+import { wrapAnsiBg } from "./_internal/wrapAnsiBg.mjs";
+//#region src/server/colors/bgBlack.ts
+/**
+* Black background. Wraps text with ANSI codes.
+*
+* @param text - The text to style.
+* @returns The styled text.
+*
+* @example
+* import { colors } from 'es-toolkit/server';
+*
+* console.log(colors.bgBlack('hello'));
+*/
+function bgBlack(text) {
+	return wrapAnsiBg("\x1B[40m", "\x1B[49m", text);
+}
+//#endregion
+export { bgBlack };

package/dist/server/colors/bgBlackBright.d.mts

@@ -0,0 +1,15 @@
+//#region src/server/colors/bgBlackBright.d.ts
+/**
+ * Bright black (gray) background. Wraps text with ANSI codes.
+ *
+ * @param text - The text to style.
+ * @returns The styled text.
+ *
+ * @example
+ * import { colors } from 'es-toolkit/server';
+ *
+ * console.log(colors.bgBlackBright('hello'));
+ */
+declare function bgBlackBright(text: string): string;
+//#endregion
+export { bgBlackBright };

package/dist/server/colors/bgBlackBright.d.ts

@@ -0,0 +1,15 @@
+//#region src/server/colors/bgBlackBright.d.ts
+/**
+ * Bright black (gray) background. Wraps text with ANSI codes.
+ *
+ * @param text - The text to style.
+ * @returns The styled text.
+ *
+ * @example
+ * import { colors } from 'es-toolkit/server';
+ *
+ * console.log(colors.bgBlackBright('hello'));
+ */
+declare function bgBlackBright(text: string): string;
+//#endregion
+export { bgBlackBright };

package/dist/server/colors/bgBlackBright.js

@@ -0,0 +1,18 @@
+const require_wrapAnsiBg = require("./_internal/wrapAnsiBg.js");
+//#region src/server/colors/bgBlackBright.ts
+/**
+* Bright black (gray) background. Wraps text with ANSI codes.
+*
+* @param text - The text to style.
+* @returns The styled text.
+*
+* @example
+* import { colors } from 'es-toolkit/server';
+*
+* console.log(colors.bgBlackBright('hello'));
+*/
+function bgBlackBright(text) {
+	return require_wrapAnsiBg.wrapAnsiBg("\x1B[100m", "\x1B[49m", text);
+}
+//#endregion
+exports.bgBlackBright = bgBlackBright;

package/dist/server/colors/bgBlackBright.mjs

@@ -0,0 +1,18 @@
+import { wrapAnsiBg } from "./_internal/wrapAnsiBg.mjs";
+//#region src/server/colors/bgBlackBright.ts
+/**
+* Bright black (gray) background. Wraps text with ANSI codes.
+*
+* @param text - The text to style.
+* @returns The styled text.
+*
+* @example
+* import { colors } from 'es-toolkit/server';
+*
+* console.log(colors.bgBlackBright('hello'));
+*/
+function bgBlackBright(text) {
+	return wrapAnsiBg("\x1B[100m", "\x1B[49m", text);
+}
+//#endregion
+export { bgBlackBright };

package/dist/server/colors/bgBlue.d.mts

@@ -0,0 +1,15 @@
+//#region src/server/colors/bgBlue.d.ts
+/**
+ * Blue background. Wraps text with ANSI codes.
+ *
+ * @param text - The text to style.
+ * @returns The styled text.
+ *
+ * @example
+ * import { colors } from 'es-toolkit/server';
+ *
+ * console.log(colors.bgBlue('hello'));
+ */
+declare function bgBlue(text: string): string;
+//#endregion
+export { bgBlue };

package/dist/server/colors/bgBlue.d.ts

@@ -0,0 +1,15 @@
+//#region src/server/colors/bgBlue.d.ts
+/**
+ * Blue background. Wraps text with ANSI codes.
+ *
+ * @param text - The text to style.
+ * @returns The styled text.
+ *
+ * @example
+ * import { colors } from 'es-toolkit/server';
+ *
+ * console.log(colors.bgBlue('hello'));
+ */
+declare function bgBlue(text: string): string;
+//#endregion
+export { bgBlue };

package/dist/server/colors/bgBlue.js

@@ -0,0 +1,18 @@
+const require_wrapAnsiBg = require("./_internal/wrapAnsiBg.js");
+//#region src/server/colors/bgBlue.ts
+/**
+* Blue background. Wraps text with ANSI codes.
+*
+* @param text - The text to style.
+* @returns The styled text.
+*
+* @example
+* import { colors } from 'es-toolkit/server';
+*
+* console.log(colors.bgBlue('hello'));
+*/
+function bgBlue(text) {
+	return require_wrapAnsiBg.wrapAnsiBg("\x1B[44m", "\x1B[49m", text);
+}
+//#endregion
+exports.bgBlue = bgBlue;

package/dist/server/colors/bgBlue.mjs

@@ -0,0 +1,18 @@
+import { wrapAnsiBg } from "./_internal/wrapAnsiBg.mjs";
+//#region src/server/colors/bgBlue.ts
+/**
+* Blue background. Wraps text with ANSI codes.
+*
+* @param text - The text to style.
+* @returns The styled text.
+*
+* @example
+* import { colors } from 'es-toolkit/server';
+*
+* console.log(colors.bgBlue('hello'));
+*/
+function bgBlue(text) {
+	return wrapAnsiBg("\x1B[44m", "\x1B[49m", text);
+}
+//#endregion
+export { bgBlue };

package/dist/server/colors/bgBlueBright.d.mts

@@ -0,0 +1,15 @@
+//#region src/server/colors/bgBlueBright.d.ts
+/**
+ * Bright blue background. Wraps text with ANSI codes.
+ *
+ * @param text - The text to style.
+ * @returns The styled text.
+ *
+ * @example
+ * import { colors } from 'es-toolkit/server';
+ *
+ * console.log(colors.bgBlueBright('hello'));
+ */
+declare function bgBlueBright(text: string): string;
+//#endregion
+export { bgBlueBright };

package/dist/server/colors/bgBlueBright.d.ts

@@ -0,0 +1,15 @@
+//#region src/server/colors/bgBlueBright.d.ts
+/**
+ * Bright blue background. Wraps text with ANSI codes.
+ *
+ * @param text - The text to style.
+ * @returns The styled text.
+ *
+ * @example
+ * import { colors } from 'es-toolkit/server';
+ *
+ * console.log(colors.bgBlueBright('hello'));
+ */
+declare function bgBlueBright(text: string): string;
+//#endregion
+export { bgBlueBright };

package/dist/server/colors/bgBlueBright.js

@@ -0,0 +1,18 @@
+const require_wrapAnsiBg = require("./_internal/wrapAnsiBg.js");
+//#region src/server/colors/bgBlueBright.ts
+/**
+* Bright blue background. Wraps text with ANSI codes.
+*
+* @param text - The text to style.
+* @returns The styled text.
+*
+* @example
+* import { colors } from 'es-toolkit/server';
+*
+* console.log(colors.bgBlueBright('hello'));
+*/
+function bgBlueBright(text) {
+	return require_wrapAnsiBg.wrapAnsiBg("\x1B[104m", "\x1B[49m", text);
+}
+//#endregion
+exports.bgBlueBright = bgBlueBright;

package/dist/server/colors/bgBlueBright.mjs

@@ -0,0 +1,18 @@
+import { wrapAnsiBg } from "./_internal/wrapAnsiBg.mjs";
+//#region src/server/colors/bgBlueBright.ts
+/**
+* Bright blue background. Wraps text with ANSI codes.
+*
+* @param text - The text to style.
+* @returns The styled text.
+*
+* @example
+* import { colors } from 'es-toolkit/server';
+*
+* console.log(colors.bgBlueBright('hello'));
+*/
+function bgBlueBright(text) {
+	return wrapAnsiBg("\x1B[104m", "\x1B[49m", text);
+}
+//#endregion
+export { bgBlueBright };

package/dist/server/colors/bgCyan.d.mts

@@ -0,0 +1,15 @@
+//#region src/server/colors/bgCyan.d.ts
+/**
+ * Cyan background. Wraps text with ANSI codes.
+ *
+ * @param text - The text to style.
+ * @returns The styled text.
+ *
+ * @example
+ * import { colors } from 'es-toolkit/server';
+ *
+ * console.log(colors.bgCyan('hello'));
+ */
+declare function bgCyan(text: string): string;
+//#endregion
+export { bgCyan };

package/dist/server/colors/bgCyan.d.ts

@@ -0,0 +1,15 @@
+//#region src/server/colors/bgCyan.d.ts
+/**
+ * Cyan background. Wraps text with ANSI codes.
+ *
+ * @param text - The text to style.
+ * @returns The styled text.
+ *
+ * @example
+ * import { colors } from 'es-toolkit/server';
+ *
+ * console.log(colors.bgCyan('hello'));
+ */
+declare function bgCyan(text: string): string;
+//#endregion
+export { bgCyan };