# loose-rgb

> Normalizes RGB color data types to a certain format

Latest version **1.0.7** (published 2021-06-09) · MIT license · 0 weekly downloads

## Install

```sh
npm install loose-rgb
pnpm add loose-rgb
yarn add loose-rgb
bun add loose-rgb
```

## Health

**Score 30/100 (F)** — status: abandoned.

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.7 |
| Published | 2021-06-09 |
| First published | 2020-07-11 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=6.0.0 |
| Dependencies | 1 |
| Unpacked size | 62 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 4 |
| Author | Evelyn Hathaway |
| Maintainers | evelynhathaway |
| Keywords | rgb, rgba, covert, color, css, hex |

## Links

- npm: https://www.npmjs.com/package/loose-rgb
- Repository: https://github.com/evelynhathaway/loose-rgb
- Homepage: https://github.com/evelynhathaway/loose-rgb#readme
- Issues: https://github.com/evelynhathaway/loose-rgb/issues
- npm.io page: https://npm.io/package/loose-rgb

## Dependencies (1)

- [ts-essentials](https://npm.io/package/ts-essentials.md) ^7.0.1

## Alternatives

- [postcss-color-hex-alpha](https://npm.io/package/postcss-color-hex-alpha.md) — 6.4M weekly downloads
- [randomcolor](https://npm.io/package/randomcolor.md) — 348.0K weekly downloads
- [bows](https://npm.io/package/bows.md) — 1.3K weekly downloads
- [ep_prefer_color_scheme](https://npm.io/package/ep_prefer_color_scheme.md) — 260 weekly downloads
- [coc-yank](https://npm.io/package/coc-yank.md) — 61 weekly downloads

## Recent versions

- 1.0.7 (latest) — 2021-06-09
- 2.0.0-beta.1 (beta) — 2021-05-21
- 1.0.6 — 2021-05-18
- 1.0.5 — 2021-05-18
- 1.0.4 — 2021-05-17
- 1.0.3 — 2021-05-17
- 1.0.2 — 2020-07-19
- 1.0.1 — 2020-07-11
- 1.0.0 — 2020-07-11

## README

<div align="center">

<img alt="Icon" width="128" height="128" align="center" src=".github/icon.png"/>

# Loose RGB

**Normalizes RGB color data types to a certain format**

[![npm version](https://badgen.net/npm/v/loose-rgb?icon=npm)](https://www.npmjs.com/package/loose-rgb)
[![check status](https://badgen.net/github/checks/evelynhathaway/loose-rgb/main?icon=github)](https://github.com/evelynhathaway/loose-rgb/actions)
[![minified + gzip bundle size](https://badgen.net/bundlephobia/minzip/loose-rgb)](https://bundlephobia.com/result?p=loose-rgb)
[![license: MIT](https://badgen.net/badge/license/MIT/blue)](/LICENSE)

</div>

## Description

Working with different color libraries gets cumbersome when they use different RGB value formats. Now you can [`normalize`](#normalize) the outputs and [`convert`](#convert) your inputs.

## Features

- Normalize any RGB format to `{r, g, b, [a]}`
- Convert `{r, g, b, [a]}` to any RGB format
- RGBA support
- Hex support

## Installation

```bash
npm install loose-rgb
```

## Usage

```js
import looseRGB from "loose-rgb";

// Convert any type to `{r, g, b, [a]}`
looseRGB.normalize({red: 1, green: 2, blue: 3}) // ? {r: 1, g: 2, b: 3}
looseRGB.normalize("FFBB00AA") // ? {r: 255, g: 187, b: 0, a: 0.66796875}

// Convert `{r, g, b, [a]}` to any type
looseRGB.convert.toCSSValue({r: 255, g: 187, b: 0, a: 0.66796875}) // ? rgba(255, 187, 0, 0.66796875)
looseRGB.convert.toUpperKeys({r: 1, g: 2, b: 3}) // ? {R: 1, G: 2, B: 3}

// Composing the above methods
import {convert, normalize} from "loose-rgb";

const anyToHex = (rgba) => convert.toHex(normalize(rgba));
anyToHex([1, 2, 3, 0.4]) // ? #01020366
```

### Normalize

`looseRGB.normalize(color: RGBUnkown)`

Input any color value as `color` (see [`convert`](#convert)).

### Convert

`looseRGB.convert[to{ColorType}](color: RGBLowerKeys)`

Input an `{r, g, b, [a]}` color to get a reformatted value. See [supported formats](#supported-formats) for methods.

#### Supported Formats

- **`.toLowerKeys()`**
	- `{r: 1, g: 2, b: 3}`
	- `{r: 1, g: 2, b: 3, a: 0.4}`
- **`.toUpperKeys()`**
	- `{R: 1, G: 2, B: 3}`
	- `{R: 1, G: 2, B: 3, A: 0.4}`
- **`.toFullKeys()`**
	- `{red: 1, green: 2, blue: 3}`
	- `{red: 1, green: 2, blue: 3, alpha: 0.4}`
- **`.toArray()`**
	- `[1, 2, 3]`
	- `[1, 2, 3, 0.4]`
- **`.toCSSValue()` —** Supports with and without spacing between commas, leading zero on decimal
	- `"rgb(0, 213, 34)"`
	- `"rgba(0, 213, 34,.12)"`
- **`.toHex()` —** Supports with and without pound, case insensitive, with shorthand
	- `"#fff"`
	- `"#000000"`
	- `"#FFBB00AA"`
	- `"123"`
	- `"FFFF"`

## License

Copyright Evelyn Hathaway, [MIT License](/LICENSE)

---
_Source: https://npm.io/package/loose-rgb · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._