@oakoliver/lipgloss 1.0.0

package/LICENSE

@@ -0,0 +1,24 @@
+MIT License
+
+Copyright (c) 2025 Antonio Oliveira
+
+Based on Lip Gloss by Charmbracelet, Inc., licensed under MIT.
+Original: https://github.com/charmbracelet/lipgloss
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,259 @@
+# lipgloss
+
+CSS-like terminal styling for JavaScript. Zero dependencies, multi-runtime (Node.js, Bun, Deno).
+
+Ported from [charmbracelet/lipgloss](https://github.com/charmbracelet/lipgloss) (Go) to TypeScript.
+
+## Install
+
+```bash
+npm install @oakoliver/lipgloss
+# or
+bun add @oakoliver/lipgloss
+# or
+deno add npm:@oakoliver/lipgloss
+```
+
+## Quick Start
+
+```ts
+import { newStyle, normalBorder, roundedBorder, Center } from '@oakoliver/lipgloss';
+
+// Create a style
+const style = newStyle()
+  .bold(true)
+  .foreground('#FF6B6B')
+  .background('#2D2D2D')
+  .padding(1, 2)
+  .border(roundedBorder())
+  .borderForeground('#FF6B6B')
+  .width(40)
+  .align(Center);
+
+console.log(style.render('Hello, Lipgloss!'));
+```
+
+## Features
+
+- **Fluent, immutable API** — every setter returns a new `Style` (safe to share and compose)
+- **CSS-like box model** — padding, margin, border, width, height, alignment
+- **10 built-in border styles** — normal, rounded, block, thick, double, hidden, ASCII, markdown, and more
+- **Full ANSI color support** — basic 16, 256-color palette, and 24-bit RGB
+- **Text attributes** — bold, italic, underline (5 styles), strikethrough, reverse, blink, faint
+- **Layout utilities** — `joinHorizontal`, `joinVertical`, `place`, `placeHorizontal`, `placeVertical`
+- **Color utilities** — `complementary`, `darken`, `lighten`, `isDarkColor`, `lightDark`, `alpha`
+- **Zero dependencies** — pure TypeScript, works everywhere
+- **TypeScript-first** — full type declarations included
+
+## API
+
+### Style
+
+```ts
+import { newStyle, Style } from '@oakoliver/lipgloss';
+
+const s = newStyle();
+```
+
+Every setter returns a new `Style` instance (immutable):
+
+```ts
+const base = newStyle().foreground('#7D56F4');
+const title = base.bold(true).padding(0, 1);
+const body = base.faint(true);
+```
+
+#### Text Attributes
+
+```ts
+s.bold(true)
+s.italic(true)
+s.underline(true)
+s.underlineStyle('curly')  // 'none' | 'single' | 'double' | 'curly' | 'dotted' | 'dashed'
+s.strikethrough(true)
+s.reverse(true)
+s.blink(true)
+s.faint(true)
+```
+
+#### Colors
+
+```ts
+// Hex (#RGB or #RRGGBB)
+s.foreground('#ff0000')
+s.background('#2D2D2D')
+s.underlineColor('#00ff00')
+
+// ANSI basic (0-15)
+import { Red, BrightCyan } from '@oakoliver/lipgloss';
+s.foreground(Red)
+
+// ANSI 256 (16-255)
+s.foreground(196)
+
+// RGB object
+s.foreground({ r: 255, g: 107, b: 107 })
+```
+
+#### Dimensions
+
+```ts
+s.width(40)       // fixed width (content wraps/pads to fit)
+s.height(5)       // fixed height
+s.maxWidth(80)    // truncate lines exceeding this
+s.maxHeight(24)   // truncate output exceeding this many lines
+```
+
+#### Alignment
+
+```ts
+import { Left, Center, Right, Top, Bottom } from '@oakoliver/lipgloss';
+
+s.align(Center)             // horizontal only
+s.align(Center, Bottom)     // horizontal and vertical
+s.alignHorizontal(Right)
+s.alignVertical(Top)
+```
+
+#### Padding & Margin (CSS shorthand)
+
+```ts
+s.padding(1)          // all sides
+s.padding(1, 2)       // vertical, horizontal
+s.padding(1, 2, 3, 4) // top, right, bottom, left
+s.paddingTop(1)
+s.paddingLeft(2)
+
+s.margin(1, 2)
+s.marginBackground('#333')  // color the margin area
+```
+
+#### Borders
+
+```ts
+import {
+  normalBorder, roundedBorder, blockBorder, thickBorder,
+  doubleBorder, hiddenBorder, asciiBorder, markdownBorder,
+  outerHalfBlockBorder, innerHalfBlockBorder,
+} from '@oakoliver/lipgloss';
+
+s.border(roundedBorder())                    // all sides
+s.border(normalBorder(), true, false)        // top+bottom only
+s.border(normalBorder(), true, true, true, true)  // explicit all
+
+s.borderForeground('#FF6B6B')               // all sides same color
+s.borderForeground('#f00', '#0f0', '#00f', '#ff0')  // CSS shorthand
+s.borderBackground('#2D2D2D')
+```
+
+#### Other
+
+```ts
+s.inline(true)           // strip newlines
+s.tabWidth(2)            // tab stop width (default 4, -1 to preserve tabs)
+s.transform(s => s.toUpperCase())
+s.hyperlink('https://example.com')
+s.setString('prefix')    // prepend when rendering
+s.colorWhitespace(true)  // apply bg color to padding spaces
+s.underlineSpaces(true)
+s.strikethroughSpaces(true)
+```
+
+#### Rendering
+
+```ts
+const output = style.render('Hello, World!');
+console.log(output);
+
+// render() joins multiple args with space
+style.render('Hello,', 'World!');
+
+// toString() renders the setString value
+const s = newStyle().setString('Hello').bold(true);
+console.log(`${s}`);  // bold "Hello"
+```
+
+#### Inherit
+
+Copy style properties from another style (padding/margin excluded):
+
+```ts
+const parent = newStyle().bold(true).foreground('#FF6B6B');
+const child = newStyle().italic(true).inherit(parent);
+// child is now bold + italic + #FF6B6B foreground
+```
+
+#### Getters
+
+Every property has a corresponding getter:
+
+```ts
+s.getBold()                // boolean
+s.getForeground()          // Color | null
+s.getWidth()               // number
+s.getPadding()             // { top, right, bottom, left }
+s.getHorizontalFrameSize() // margin + border + padding (horizontal)
+s.getFrameSize()           // { x, y }
+```
+
+### Layout
+
+```ts
+import {
+  joinHorizontal, joinVertical,
+  place, placeHorizontal, placeVertical,
+  Top, Bottom, Center, Left, Right,
+} from '@oakoliver/lipgloss';
+
+// Join blocks side by side (vertical alignment)
+joinHorizontal(Top, blockA, blockB, blockC);
+joinHorizontal(Center, blockA, blockB);
+
+// Stack blocks vertically (horizontal alignment)
+joinVertical(Left, blockA, blockB);
+joinVertical(Center, blockA, blockB);
+
+// Place content in an unstyled box
+place(80, 24, Center, Center, 'Hello');
+placeHorizontal(80, Center, 'Hello');
+placeVertical(24, Center, 'Hello');
+```
+
+### Color Utilities
+
+```ts
+import {
+  parseColor, colorToRGB, isDarkColor,
+  lightDark, complementary, darken, lighten, alpha,
+} from '@oakoliver/lipgloss';
+
+isDarkColor('#1a1a2e')     // true
+isDarkColor('#ffffff')     // false
+
+const pick = lightDark(isDarkColor('#1a1a2e'));
+pick('#333', '#eee')       // returns '#eee' (dark background → use light color)
+
+complementary('#ff0000')   // ~cyan
+darken('#ff6b6b', 0.3)    // 30% darker
+lighten('#333333', 0.2)   // 20% lighter
+alpha('#ff0000', 0.5)     // { r: 128, g: 0, b: 0 }
+```
+
+### ANSI Utilities
+
+```ts
+import { stripAnsi, stringWidth, truncate, styled, SGR } from '@oakoliver/lipgloss';
+
+stripAnsi('\x1b[1mHello\x1b[0m')  // 'Hello'
+stringWidth('\x1b[1mHello\x1b[0m') // 5 (ignores ANSI, handles CJK)
+truncate(longString, 40)           // truncate to 40 visible chars
+styled('Hi', { bold: true, fg: { type: 'rgb', value: 0, r: 255, g: 0, b: 0 } })
+```
+
+## Attribution
+
+This is a TypeScript port of [charmbracelet/lipgloss](https://github.com/charmbracelet/lipgloss), originally written in Go by [Charmbracelet, Inc.](https://charm.sh). Licensed under MIT.
+
+## License
+
+MIT

package/dist/ansi.d.ts

@@ -0,0 +1,82 @@
+/**
+ * ANSI escape code utilities for terminal styling.
+ * Pure TypeScript implementation — no dependencies.
+ */
+/** SGR (Select Graphic Rendition) codes */
+export declare const SGR: {
+    readonly reset: "\u001B[0m";
+    readonly bold: "\u001B[1m";
+    readonly faint: "\u001B[2m";
+    readonly italic: "\u001B[3m";
+    readonly underline: "\u001B[4m";
+    readonly blink: "\u001B[5m";
+    readonly reverse: "\u001B[7m";
+    readonly strikethrough: "\u001B[9m";
+    readonly underlineNone: "\u001B[24m";
+    readonly underlineSingle: "\u001B[4m";
+    readonly underlineDouble: "\u001B[4:2m";
+    readonly underlineCurly: "\u001B[4:3m";
+    readonly underlineDotted: "\u001B[4:4m";
+    readonly underlineDashed: "\u001B[4:5m";
+    readonly resetBold: "\u001B[22m";
+    readonly resetItalic: "\u001B[23m";
+    readonly resetUnderline: "\u001B[24m";
+    readonly resetBlink: "\u001B[25m";
+    readonly resetReverse: "\u001B[27m";
+    readonly resetStrikethrough: "\u001B[29m";
+};
+/** Set foreground color using ANSI basic (0-7), bright (8-15), 256, or RGB */
+export declare function fgColor(r: number, g: number, b: number): string;
+export declare function fgAnsi256(n: number): string;
+export declare function fgBasic(n: number): string;
+/** Set background color using ANSI basic (0-7), bright (8-15), 256, or RGB */
+export declare function bgColor(r: number, g: number, b: number): string;
+export declare function bgAnsi256(n: number): string;
+export declare function bgBasic(n: number): string;
+/** Set underline color (not universally supported) */
+export declare function ulColor(r: number, g: number, b: number): string;
+export declare function ulAnsi256(n: number): string;
+/** OSC hyperlink escape sequences */
+export declare function setHyperlink(url: string, params?: string): string;
+export declare function resetHyperlink(): string;
+export declare function stripAnsi(str: string): string;
+/**
+ * Measure the visible (printable) width of a string, ignoring ANSI codes.
+ * This is a simplified implementation that handles common cases.
+ * For full Unicode width support, a proper East Asian Width implementation
+ * would be needed, but this covers the vast majority of use cases.
+ */
+export declare function stringWidth(str: string): number;
+/**
+ * Truncate a string to a maximum visible width, stripping ANSI codes as needed.
+ */
+export declare function truncate(str: string, maxWidth: number): string;
+/**
+ * Build an ANSI styled string by wrapping content in SGR sequences.
+ */
+export interface AnsiStyleOptions {
+    bold?: boolean;
+    faint?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    underlineStyle?: UnderlineStyle;
+    blink?: boolean;
+    reverse?: boolean;
+    strikethrough?: boolean;
+    fg?: ColorValue | null;
+    bg?: ColorValue | null;
+    ul?: ColorValue | null;
+}
+export type UnderlineStyle = 'none' | 'single' | 'double' | 'curly' | 'dotted' | 'dashed';
+export interface ColorValue {
+    type: 'basic' | 'ansi256' | 'rgb';
+    value: number;
+    r?: number;
+    g?: number;
+    b?: number;
+}
+/**
+ * Apply ANSI styling to a string.
+ */
+export declare function styled(str: string, opts: AnsiStyleOptions): string;
+//# sourceMappingURL=ansi.d.ts.map

package/dist/ansi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi.d.ts","sourceRoot":"","sources":["../src/ansi.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,2CAA2C;AAC3C,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;CA0BN,CAAC;AAEX,8EAA8E;AAC9E,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGzC;AAED,8EAA8E;AAC9E,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGzC;AAED,sDAAsD;AACtD,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,qCAAqC;AACrC,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAGjE;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAQD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAuC/C;AAkBD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAsC9D;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,EAAE,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACvB,EAAE,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACvB,EAAE,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE1F,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,KAAK,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAoClE"}

package/dist/border.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Border definitions and built-in border styles.
+ */
+/** Border character set */
+export interface Border {
+    top: string;
+    bottom: string;
+    left: string;
+    right: string;
+    topLeft: string;
+    topRight: string;
+    bottomLeft: string;
+    bottomRight: string;
+    middleLeft: string;
+    middleRight: string;
+    middle: string;
+    middleTop: string;
+    middleBottom: string;
+}
+/** No border */
+export declare const noBorder: Border;
+/** Standard border with 90-degree corners */
+export declare function normalBorder(): Border;
+/** Rounded corners */
+export declare function roundedBorder(): Border;
+/** Full block border */
+export declare function blockBorder(): Border;
+/** Outer half-block border */
+export declare function outerHalfBlockBorder(): Border;
+/** Inner half-block border */
+export declare function innerHalfBlockBorder(): Border;
+/** Thick border */
+export declare function thickBorder(): Border;
+/** Double-line border */
+export declare function doubleBorder(): Border;
+/** Hidden border (spaces) — maintains layout without visible borders */
+export declare function hiddenBorder(): Border;
+/** Markdown-style table border */
+export declare function markdownBorder(): Border;
+/** ASCII border using +, -, | characters */
+export declare function asciiBorder(): Border;
+/** Get the max rune width of a border edge string */
+export declare function maxRuneWidth(str: string): number;
+/** Get the size of the top edge of the border */
+export declare function getTopSize(b: Border): number;
+/** Get the size of the right edge of the border */
+export declare function getRightSize(b: Border): number;
+/** Get the size of the bottom edge of the border */
+export declare function getBottomSize(b: Border): number;
+/** Get the size of the left edge of the border */
+export declare function getLeftSize(b: Border): number;
+/** Check if a border is the "no border" (all empty strings) */
+export declare function isNoBorder(b: Border): boolean;
+//# sourceMappingURL=border.d.ts.map

package/dist/border.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"border.d.ts","sourceRoot":"","sources":["../src/border.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,2BAA2B;AAC3B,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAWD,gBAAgB;AAChB,eAAO,MAAM,QAAQ,EAAE,MAAmB,CAAC;AAE3C,6CAA6C;AAC7C,wBAAgB,YAAY,IAAI,MAAM,CAMrC;AAED,sBAAsB;AACtB,wBAAgB,aAAa,IAAI,MAAM,CAMtC;AAED,wBAAwB;AACxB,wBAAgB,WAAW,IAAI,MAAM,CAMpC;AAED,8BAA8B;AAC9B,wBAAgB,oBAAoB,IAAI,MAAM,CAK7C;AAED,8BAA8B;AAC9B,wBAAgB,oBAAoB,IAAI,MAAM,CAK7C;AAED,mBAAmB;AACnB,wBAAgB,WAAW,IAAI,MAAM,CAMpC;AAED,yBAAyB;AACzB,wBAAgB,YAAY,IAAI,MAAM,CAMrC;AAED,wEAAwE;AACxE,wBAAgB,YAAY,IAAI,MAAM,CAMrC;AAED,kCAAkC;AAClC,wBAAgB,cAAc,IAAI,MAAM,CAMvC;AAED,4CAA4C;AAC5C,wBAAgB,WAAW,IAAI,MAAM,CAMpC;AAED,qDAAqD;AACrD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQhD;AAWD,iDAAiD;AACjD,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,mDAAmD;AACnD,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,kDAAkD;AAClD,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,+DAA+D;AAC/D,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAG7C"}

package/dist/color.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Color types and utilities for terminal styling.
+ */
+import type { ColorValue } from './ansi.js';
+/**
+ * Represents no color — terminal default.
+ */
+export declare const NO_COLOR: unique symbol;
+export type NoColor = typeof NO_COLOR;
+/**
+ * RGB color representation.
+ */
+export interface RGBColor {
+    r: number;
+    g: number;
+    b: number;
+}
+/**
+ * A color that can be used in styling.
+ * - null/undefined/NO_COLOR = no color (terminal default)
+ * - number 0-15 = ANSI basic color
+ * - number 16-255 = ANSI 256 color
+ * - string "#RRGGBB" or "#RGB" = hex color
+ * - RGBColor = explicit RGB
+ */
+export type Color = string | number | RGBColor | NoColor | null | undefined;
+/** ANSI basic color constants (0-15) */
+export declare const Black = 0;
+export declare const Red = 1;
+export declare const Green = 2;
+export declare const Yellow = 3;
+export declare const Blue = 4;
+export declare const Magenta = 5;
+export declare const Cyan = 6;
+export declare const White = 7;
+export declare const BrightBlack = 8;
+export declare const BrightRed = 9;
+export declare const BrightGreen = 10;
+export declare const BrightYellow = 11;
+export declare const BrightBlue = 12;
+export declare const BrightMagenta = 13;
+export declare const BrightCyan = 14;
+export declare const BrightWhite = 15;
+/**
+ * Parse a color specification into an internal ColorValue.
+ * Returns null for "no color".
+ */
+export declare function parseColor(c: Color): ColorValue | null;
+/**
+ * Parse a hex color string (#RGB or #RRGGBB) into RGB values.
+ */
+export declare function parseHex(hex: string): RGBColor | null;
+/**
+ * Convert any Color to RGB values (approximation for ANSI colors).
+ */
+export declare function colorToRGB(c: Color): RGBColor | null;
+/**
+ * Convert ANSI 256 color index to approximate RGB.
+ */
+export declare function ansi256ToRGB(index: number): RGBColor;
+/**
+ * Determine if a color is "dark" based on luminance.
+ */
+export declare function isDarkColor(c: Color): boolean;
+/**
+ * LightDark returns a function that picks a color based on background darkness.
+ */
+export declare function lightDark(isDark: boolean): (light: Color, dark: Color) => Color;
+/**
+ * Returns the complementary color (180 degrees on the color wheel).
+ */
+export declare function complementary(c: Color): Color;
+/**
+ * Darken a color by a percentage (0-1).
+ */
+export declare function darken(c: Color, percent: number): Color;
+/**
+ * Lighten a color by a percentage (0-1).
+ */
+export declare function lighten(c: Color, percent: number): Color;
+/**
+ * Adjust alpha (0 = transparent, 1 = opaque). Returns an RGBColor
+ * (terminal colors don't truly support alpha, but useful for blending).
+ */
+export declare function alpha(c: Color, a: number): RGBColor | null;
+//# sourceMappingURL=color.d.ts.map

package/dist/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../src/color.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,OAAO,MAA0B,CAAC;AACzD,MAAM,MAAM,OAAO,GAAG,OAAO,QAAQ,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAE5E,wCAAwC;AACxC,eAAO,MAAM,KAAK,IAAI,CAAC;AACvB,eAAO,MAAM,GAAG,IAAI,CAAC;AACrB,eAAO,MAAM,KAAK,IAAI,CAAC;AACvB,eAAO,MAAM,MAAM,IAAI,CAAC;AACxB,eAAO,MAAM,IAAI,IAAI,CAAC;AACtB,eAAO,MAAM,OAAO,IAAI,CAAC;AACzB,eAAO,MAAM,IAAI,IAAI,CAAC;AACtB,eAAO,MAAM,KAAK,IAAI,CAAC;AACvB,eAAO,MAAM,WAAW,IAAI,CAAC;AAC7B,eAAO,MAAM,SAAS,IAAI,CAAC;AAC3B,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,eAAO,MAAM,YAAY,KAAK,CAAC;AAC/B,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,WAAW,KAAK,CAAC;AAE9B;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,IAAI,CAqCtD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAoBrD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,IAAI,CAOpD;AAsBD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAmBpD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,CAQ7C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,KAAK,KAAK,CAE/E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,GAAG,KAAK,CAS7C;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CASvD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CASxD;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAS1D"}