@oakoliver/lipgloss 1.0.0

package/dist/layout.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Layout utilities: JoinHorizontal, JoinVertical, Place, PlaceHorizontal, PlaceVertical.
+ * Ported from charmbracelet/lipgloss join.go and position.go.
+ */
+import type { Position } from './style.js';
+/**
+ * Horizontally join multi-line strings along a vertical axis.
+ * `pos` is the vertical alignment: 0 = top, 0.5 = center, 1 = bottom.
+ */
+export declare function joinHorizontal(pos: Position, ...strs: string[]): string;
+/**
+ * Vertically join multi-line strings along a horizontal axis.
+ * `pos` is the horizontal alignment: 0 = left, 0.5 = center, 1 = right.
+ */
+export declare function joinVertical(pos: Position, ...strs: string[]): string;
+/**
+ * Place a string in an unstyled box of given width and height.
+ */
+export declare function place(width: number, height: number, hPos: Position, vPos: Position, str: string): string;
+/**
+ * Place a string horizontally in an unstyled block of given width.
+ */
+export declare function placeHorizontal(width: number, pos: Position, str: string): string;
+/**
+ * Place a string vertically in an unstyled block of given height.
+ */
+export declare function placeVertical(height: number, pos: Position, str: string): string;
+//# sourceMappingURL=layout.d.ts.map

package/dist/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../src/layout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAO3C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAuDvE;AAMD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAwCrE;AAMD;;GAEG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAExG;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CA0BjF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAmChF"}

package/dist/style.d.ts

@@ -0,0 +1,247 @@
+/**
+ * Style — the core of lipgloss. Immutable fluent builder for terminal styling.
+ * Every setter returns a new Style instance (value-type semantics).
+ */
+import type { UnderlineStyle } from './ansi.js';
+import type { Color } from './color.js';
+import type { Border } from './border.js';
+/** 0.0 = top/left, 0.5 = center, 1.0 = bottom/right */
+export type Position = number;
+export declare const Top: Position;
+export declare const Bottom: Position;
+export declare const Center: Position;
+export declare const Left: Position;
+export declare const Right: Position;
+/** Split string into lines and find the widest line's visible width. */
+export declare function getLines(s: string): {
+    lines: string[];
+    widest: number;
+};
+/** Get first character of a string as a string (for corners). */
+export declare function getFirstRune(s: string): string;
+export declare class Style {
+    private _set;
+    private _value;
+    private _bold;
+    private _italic;
+    private _strikethrough;
+    private _reverse;
+    private _blink;
+    private _faint;
+    private _underlineSpaces;
+    private _strikethroughSpaces;
+    private _colorWhitespace;
+    private _underlineStyle;
+    private _fg;
+    private _bg;
+    private _ulColor;
+    private _width;
+    private _height;
+    private _maxWidth;
+    private _maxHeight;
+    private _alignH;
+    private _alignV;
+    private _paddingTop;
+    private _paddingRight;
+    private _paddingBottom;
+    private _paddingLeft;
+    private _marginTop;
+    private _marginRight;
+    private _marginBottom;
+    private _marginLeft;
+    private _marginBg;
+    private _borderStyle;
+    private _borderTop;
+    private _borderRight;
+    private _borderBottom;
+    private _borderLeft;
+    private _borderTopFg;
+    private _borderRightFg;
+    private _borderBottomFg;
+    private _borderLeftFg;
+    private _borderTopBg;
+    private _borderRightBg;
+    private _borderBottomBg;
+    private _borderLeftBg;
+    private _inline;
+    private _tabWidth;
+    private _transform;
+    private _link;
+    private _linkParams;
+    private _paddingChar;
+    /** Clone this style into a new instance. */
+    private _clone;
+    setString(...strs: string[]): Style;
+    bold(v: boolean): Style;
+    italic(v: boolean): Style;
+    strikethrough(v: boolean): Style;
+    reverse(v: boolean): Style;
+    blink(v: boolean): Style;
+    faint(v: boolean): Style;
+    underline(v: boolean): Style;
+    underlineStyle(u: UnderlineStyle): Style;
+    foreground(c: Color): Style;
+    background(c: Color): Style;
+    underlineColor(c: Color): Style;
+    width(n: number): Style;
+    height(n: number): Style;
+    maxWidth(n: number): Style;
+    maxHeight(n: number): Style;
+    align(...pos: Position[]): Style;
+    alignHorizontal(p: Position): Style;
+    alignVertical(p: Position): Style;
+    padding(...args: number[]): Style;
+    paddingTop(n: number): Style;
+    paddingRight(n: number): Style;
+    paddingBottom(n: number): Style;
+    paddingLeft(n: number): Style;
+    margin(...args: number[]): Style;
+    marginTop(n: number): Style;
+    marginRight(n: number): Style;
+    marginBottom(n: number): Style;
+    marginLeft(n: number): Style;
+    marginBackground(c: Color): Style;
+    border(b: Border, ...sides: boolean[]): Style;
+    borderStyle(b: Border): Style;
+    borderTop(v: boolean): Style;
+    borderRight(v: boolean): Style;
+    borderBottom(v: boolean): Style;
+    borderLeft(v: boolean): Style;
+    borderForeground(...colors: Color[]): Style;
+    borderTopForeground(c: Color): Style;
+    borderRightForeground(c: Color): Style;
+    borderBottomForeground(c: Color): Style;
+    borderLeftForeground(c: Color): Style;
+    borderBackground(...colors: Color[]): Style;
+    borderTopBackground(c: Color): Style;
+    borderRightBackground(c: Color): Style;
+    borderBottomBackground(c: Color): Style;
+    borderLeftBackground(c: Color): Style;
+    inline(v: boolean): Style;
+    tabWidth(n: number): Style;
+    transform(fn: (s: string) => string): Style;
+    hyperlink(url: string, params?: string): Style;
+    underlineSpaces(v: boolean): Style;
+    strikethroughSpaces(v: boolean): Style;
+    colorWhitespace(v: boolean): Style;
+    paddingChar(ch: string): Style;
+    copy(): Style;
+    unsetBold(): Style;
+    unsetItalic(): Style;
+    unsetUnderline(): Style;
+    unsetUnderlineSpaces(): Style;
+    unsetStrikethrough(): Style;
+    unsetStrikethroughSpaces(): Style;
+    unsetReverse(): Style;
+    unsetBlink(): Style;
+    unsetFaint(): Style;
+    unsetInline(): Style;
+    unsetForeground(): Style;
+    unsetBackground(): Style;
+    unsetUnderlineColor(): Style;
+    unsetWidth(): Style;
+    unsetHeight(): Style;
+    unsetMaxWidth(): Style;
+    unsetMaxHeight(): Style;
+    unsetPaddingTop(): Style;
+    unsetPaddingRight(): Style;
+    unsetPaddingBottom(): Style;
+    unsetPaddingLeft(): Style;
+    unsetPaddingChar(): Style;
+    unsetMarginTop(): Style;
+    unsetMarginRight(): Style;
+    unsetMarginBottom(): Style;
+    unsetMarginLeft(): Style;
+    unsetBorderTop(): Style;
+    unsetBorderRight(): Style;
+    unsetBorderBottom(): Style;
+    unsetBorderLeft(): Style;
+    unsetBorderStyle(): Style;
+    unsetTabWidth(): Style;
+    unsetTransform(): Style;
+    unsetHyperlink(): Style;
+    unsetColorWhitespace(): Style;
+    getBold(): boolean;
+    getItalic(): boolean;
+    getUnderline(): boolean;
+    getUnderlineStyle(): UnderlineStyle;
+    getStrikethrough(): boolean;
+    getReverse(): boolean;
+    getBlink(): boolean;
+    getFaint(): boolean;
+    getForeground(): Color;
+    getBackground(): Color;
+    getUnderlineColor(): Color;
+    getWidth(): number;
+    getHeight(): number;
+    getMaxWidth(): number;
+    getMaxHeight(): number;
+    getAlignHorizontal(): Position;
+    getAlignVertical(): Position;
+    getInline(): boolean;
+    getTabWidth(): number;
+    getUnderlineSpaces(): boolean;
+    getStrikethroughSpaces(): boolean;
+    getColorWhitespace(): boolean;
+    getTransform(): ((s: string) => string) | null;
+    getPaddingChar(): string;
+    getHyperlink(): {
+        link: string;
+        params: string;
+    };
+    getPadding(): {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    getPaddingTop(): number;
+    getPaddingRight(): number;
+    getPaddingBottom(): number;
+    getPaddingLeft(): number;
+    getHorizontalPadding(): number;
+    getVerticalPadding(): number;
+    getMargin(): {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    getMarginTop(): number;
+    getMarginRight(): number;
+    getMarginBottom(): number;
+    getMarginLeft(): number;
+    getHorizontalMargins(): number;
+    getVerticalMargins(): number;
+    getBorderStyle(): Border;
+    getBorderTop(): boolean;
+    getBorderRight(): boolean;
+    getBorderBottom(): boolean;
+    getBorderLeft(): boolean;
+    /** True when border style is set but no individual side bools are set. */
+    private _isBorderStyleSetWithoutSides;
+    getBorderTopSize(): number;
+    getBorderRightSize(): number;
+    getBorderBottomSize(): number;
+    getBorderLeftSize(): number;
+    getHorizontalBorderSize(): number;
+    getVerticalBorderSize(): number;
+    getHorizontalFrameSize(): number;
+    getVerticalFrameSize(): number;
+    getFrameSize(): {
+        x: number;
+        y: number;
+    };
+    /** Copy explicitly-set values from `other` that are NOT set on this style. Margins/padding are not inherited. */
+    inherit(other: Style): Style;
+    private _keyToField;
+    /** Render the style applied to the given strings (joined with space). */
+    render(...strs: string[]): string;
+    private _maybeConvertTabs;
+    private _applyBorder;
+    private _applyMargins;
+    toString(): string;
+}
+/** Create a new empty Style. */
+export declare function newStyle(): Style;
+//# sourceMappingURL=style.d.ts.map

package/dist/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../src/style.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@oakoliver/lipgloss",
+  "version": "1.0.0",
+  "description": "CSS-like terminal styling for JavaScript. Zero dependencies, multi-runtime (Node.js, Bun, Deno). Fluent API for colors, borders, padding, margins, alignment, and layout.",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "npm run build:esm && npm run build:cjs && npm run build:types",
+    "build:esm": "esbuild src/index.ts --bundle --format=esm --outfile=dist/index.js --platform=node",
+    "build:cjs": "esbuild src/index.ts --bundle --format=cjs --outfile=dist/index.cjs --platform=node",
+    "build:types": "tsc --declaration --emitDeclarationOnly --outDir dist",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "lipgloss",
+    "terminal",
+    "styling",
+    "ansi",
+    "tui",
+    "css",
+    "colors",
+    "borders",
+    "padding",
+    "margins",
+    "layout",
+    "charmbracelet",
+    "nodejs",
+    "bun",
+    "deno",
+    "typescript",
+    "zero-dependencies",
+    "multi-runtime"
+  ],
+  "author": "Antonio Oliveira <antonio@oakoliver.com> (https://oakoliver.com)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/oakoliver/lipgloss.git"
+  },
+  "homepage": "https://github.com/oakoliver/lipgloss#readme",
+  "bugs": {
+    "url": "https://github.com/oakoliver/lipgloss/issues"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "esbuild": "^0.27.4",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/ansi.ts

@@ -0,0 +1,292 @@
+/**
+ * ANSI escape code utilities for terminal styling.
+ * Pure TypeScript implementation — no dependencies.
+ */
+
+// CSI (Control Sequence Introducer)
+const ESC = '\x1b';
+const CSI = `${ESC}[`;
+
+/** SGR (Select Graphic Rendition) codes */
+export const SGR = {
+  reset: `${CSI}0m`,
+
+  bold: `${CSI}1m`,
+  faint: `${CSI}2m`,
+  italic: `${CSI}3m`,
+  underline: `${CSI}4m`,
+  blink: `${CSI}5m`,
+  reverse: `${CSI}7m`,
+  strikethrough: `${CSI}9m`,
+
+  // Underline styles (not universally supported)
+  underlineNone: `${CSI}24m`,
+  underlineSingle: `${CSI}4m`,
+  underlineDouble: `${CSI}4:2m`,
+  underlineCurly: `${CSI}4:3m`,
+  underlineDotted: `${CSI}4:4m`,
+  underlineDashed: `${CSI}4:5m`,
+
+  // Reset specific attributes
+  resetBold: `${CSI}22m`,
+  resetItalic: `${CSI}23m`,
+  resetUnderline: `${CSI}24m`,
+  resetBlink: `${CSI}25m`,
+  resetReverse: `${CSI}27m`,
+  resetStrikethrough: `${CSI}29m`,
+} as const;
+
+/** Set foreground color using ANSI basic (0-7), bright (8-15), 256, or RGB */
+export function fgColor(r: number, g: number, b: number): string {
+  return `${CSI}38;2;${r};${g};${b}m`;
+}
+
+export function fgAnsi256(n: number): string {
+  return `${CSI}38;5;${n}m`;
+}
+
+export function fgBasic(n: number): string {
+  if (n < 8) return `${CSI}${30 + n}m`;
+  return `${CSI}${90 + (n - 8)}m`;
+}
+
+/** Set background color using ANSI basic (0-7), bright (8-15), 256, or RGB */
+export function bgColor(r: number, g: number, b: number): string {
+  return `${CSI}48;2;${r};${g};${b}m`;
+}
+
+export function bgAnsi256(n: number): string {
+  return `${CSI}48;5;${n}m`;
+}
+
+export function bgBasic(n: number): string {
+  if (n < 8) return `${CSI}${40 + n}m`;
+  return `${CSI}${100 + (n - 8)}m`;
+}
+
+/** Set underline color (not universally supported) */
+export function ulColor(r: number, g: number, b: number): string {
+  return `${CSI}58;2;${r};${g};${b}m`;
+}
+
+export function ulAnsi256(n: number): string {
+  return `${CSI}58;5;${n}m`;
+}
+
+/** OSC hyperlink escape sequences */
+export function setHyperlink(url: string, params?: string): string {
+  const p = params ? params : '';
+  return `${ESC}]8;${p};${url}${ESC}\\`;
+}
+
+export function resetHyperlink(): string {
+  return `${ESC}]8;;${ESC}\\`;
+}
+
+/**
+ * Strip all ANSI escape sequences from a string.
+ */
+// eslint-disable-next-line no-control-regex
+const ANSI_REGEX = /[\x1b\x9b][[()#;?]*(?:[0-9]{1,4}(?:[;:][0-9]{0,4})*)?[0-9A-ORZcf-nqry=><~]|\x1b\]8;[^\x1b]*\x1b\\/g;
+
+export function stripAnsi(str: string): string {
+  return str.replace(ANSI_REGEX, '');
+}
+
+/**
+ * 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 function stringWidth(str: string): number {
+  const stripped = stripAnsi(str);
+  let width = 0;
+  for (let i = 0; i < stripped.length; i++) {
+    const code = stripped.charCodeAt(i);
+    // Skip combining characters (rough heuristic)
+    if (code >= 0x0300 && code <= 0x036f) continue;
+    if (code >= 0x1ab0 && code <= 0x1aff) continue;
+    if (code >= 0x1dc0 && code <= 0x1dff) continue;
+    if (code >= 0x20d0 && code <= 0x20ff) continue;
+    if (code >= 0xfe20 && code <= 0xfe2f) continue;
+
+    // Handle surrogate pairs for full Unicode
+    if (code >= 0xd800 && code <= 0xdbff) {
+      const next = stripped.charCodeAt(i + 1);
+      if (next >= 0xdc00 && next <= 0xdfff) {
+        const cp = (code - 0xd800) * 0x400 + (next - 0xdc00) + 0x10000;
+        // CJK Unified Ideographs Extension B+
+        if (cp >= 0x20000 && cp <= 0x3ffff) {
+          width += 2;
+        } else {
+          width += 1;
+        }
+        i++; // skip low surrogate
+        continue;
+      }
+    }
+
+    // East Asian Full-width and Wide characters
+    if (isFullWidth(code)) {
+      width += 2;
+    } else if (code === 0x09) {
+      // Tab — we handle this at a higher level
+      width += 4;
+    } else {
+      width += 1;
+    }
+  }
+  return width;
+}
+
+/** Check if a Unicode code point is full-width */
+function isFullWidth(code: number): boolean {
+  return (
+    (code >= 0x1100 && code <= 0x115f) || // Hangul Jamo
+    (code >= 0x2e80 && code <= 0x303e) || // CJK Radicals, Kangxi, Ideographic Description
+    (code >= 0x3040 && code <= 0x33bf) || // Hiragana, Katakana, Bopomofo, etc.
+    (code >= 0x3400 && code <= 0x4dbf) || // CJK Unified Ideographs Extension A
+    (code >= 0x4e00 && code <= 0xa4cf) || // CJK Unified Ideographs, Yi
+    (code >= 0xac00 && code <= 0xd7a3) || // Hangul Syllables
+    (code >= 0xf900 && code <= 0xfaff) || // CJK Compatibility Ideographs
+    (code >= 0xfe30 && code <= 0xfe6f) || // CJK Compatibility Forms, Small Form Variants
+    (code >= 0xff01 && code <= 0xff60) || // Fullwidth Forms
+    (code >= 0xffe0 && code <= 0xffe6)    // Fullwidth Signs
+  );
+}
+
+/**
+ * Truncate a string to a maximum visible width, stripping ANSI codes as needed.
+ */
+export function truncate(str: string, maxWidth: number): string {
+  if (maxWidth <= 0) return '';
+  if (stringWidth(str) <= maxWidth) return str;
+
+  let width = 0;
+  let result = '';
+  let inEscape = false;
+  let escapeSeq = '';
+
+  for (let i = 0; i < str.length; i++) {
+    const ch = str[i];
+
+    if (inEscape) {
+      escapeSeq += ch;
+      // Check for end of escape sequence
+      if (/[A-Za-z~]/.test(ch) || (escapeSeq.startsWith('\x1b]') && ch === '\\' && escapeSeq[escapeSeq.length - 2] === '\x1b')) {
+        result += escapeSeq;
+        inEscape = false;
+        escapeSeq = '';
+      }
+      continue;
+    }
+
+    if (ch === '\x1b' || ch === '\x9b') {
+      inEscape = true;
+      escapeSeq = ch;
+      continue;
+    }
+
+    const code = ch.charCodeAt(0);
+    const charWidth = isFullWidth(code) ? 2 : 1;
+
+    if (width + charWidth > maxWidth) break;
+    width += charWidth;
+    result += ch;
+  }
+
+  return result;
+}
+
+/**
+ * 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; // for basic (0-15) and ansi256 (0-255)
+  r?: number;
+  g?: number;
+  b?: number;
+}
+
+/**
+ * Apply ANSI styling to a string.
+ */
+export function styled(str: string, opts: AnsiStyleOptions): string {
+  let prefix = '';
+  let suffix = '';
+
+  if (opts.bold) { prefix += SGR.bold; }
+  if (opts.faint) { prefix += SGR.faint; }
+  if (opts.italic) { prefix += SGR.italic; }
+  if (opts.underline || (opts.underlineStyle && opts.underlineStyle !== 'none')) {
+    const style = opts.underlineStyle || 'single';
+    switch (style) {
+      case 'single': prefix += SGR.underlineSingle; break;
+      case 'double': prefix += SGR.underlineDouble; break;
+      case 'curly': prefix += SGR.underlineCurly; break;
+      case 'dotted': prefix += SGR.underlineDotted; break;
+      case 'dashed': prefix += SGR.underlineDashed; break;
+    }
+  }
+  if (opts.blink) { prefix += SGR.blink; }
+  if (opts.reverse) { prefix += SGR.reverse; }
+  if (opts.strikethrough) { prefix += SGR.strikethrough; }
+
+  if (opts.fg) {
+    prefix += colorToFg(opts.fg);
+  }
+  if (opts.bg) {
+    prefix += colorToBg(opts.bg);
+  }
+  if (opts.ul) {
+    prefix += colorToUl(opts.ul);
+  }
+
+  if (prefix) {
+    suffix = SGR.reset;
+  }
+
+  return prefix + str + suffix;
+}
+
+function colorToFg(c: ColorValue): string {
+  switch (c.type) {
+    case 'basic': return fgBasic(c.value);
+    case 'ansi256': return fgAnsi256(c.value);
+    case 'rgb': return fgColor(c.r!, c.g!, c.b!);
+  }
+}
+
+function colorToBg(c: ColorValue): string {
+  switch (c.type) {
+    case 'basic': return bgBasic(c.value);
+    case 'ansi256': return bgAnsi256(c.value);
+    case 'rgb': return bgColor(c.r!, c.g!, c.b!);
+  }
+}
+
+function colorToUl(c: ColorValue): string {
+  switch (c.type) {
+    case 'basic': return ulAnsi256(c.value); // underline color uses 256 encoding for basic too
+    case 'ansi256': return ulAnsi256(c.value);
+    case 'rgb': return ulColor(c.r!, c.g!, c.b!);
+  }
+}