colorette - npm Package Compare versions

Comparing version 1.4.0 to 2.0.0

index.d.ts

@@ -1,49 +0,93 @@
-interface Style {
-  (string: string): string
-}
+declare module "colorette" {
+  type Color = (text: string | number) => string
 
-export const options: {
-  enabled: boolean
+  interface Colorette {
+    reset: Color
+    bold: Color
+    dim: Color
+    italic: Color
+    underline: Color
+    inverse: Color
+    hidden: Color
+    strikethrough: Color
+    black: Color
+    red: Color
+    green: Color
+    yellow: Color
+    blue: Color
+    magenta: Color
+    cyan: Color
+    white: Color
+    gray: Color
+    bgBlack: Color
+    bgRed: Color
+    bgGreen: Color
+    bgYellow: Color
+    bgBlue: Color
+    bgMagenta: Color
+    bgCyan: Color
+    bgWhite: Color
+    blackBright: Color
+    redBright: Color
+    greenBright: Color
+    yellowBright: Color
+    blueBright: Color
+    magentaBright: Color
+    cyanBright: Color
+    whiteBright: Color
+    bgBlackBright: Color
+    bgRedBright: Color
+    bgGreenBright: Color
+    bgYellowBright: Color
+    bgBlueBright: Color
+    bgMagentaBright: Color
+    bgCyanBright: Color
+    bgWhiteBright: Color
+  }
+
+  const reset: Color
+  const bold: Color
+  const dim: Color
+  const italic: Color
+  const underline: Color
+  const inverse: Color
+  const hidden: Color
+  const strikethrough: Color
+  const black: Color
+  const red: Color
+  const green: Color
+  const yellow: Color
+  const blue: Color
+  const magenta: Color
+  const cyan: Color
+  const white: Color
+  const gray: Color
+  const bgBlack: Color
+  const bgRed: Color
+  const bgGreen: Color
+  const bgYellow: Color
+  const bgBlue: Color
+  const bgMagenta: Color
+  const bgCyan: Color
+  const bgWhite: Color
+  const blackBright: Color
+  const redBright: Color
+  const greenBright: Color
+  const yellowBright: Color
+  const blueBright: Color
+  const magentaBright: Color
+  const cyanBright: Color
+  const whiteBright: Color
+  const bgBlackBright: Color
+  const bgRedBright: Color
+  const bgGreenBright: Color
+  const bgYellowBright: Color
+  const bgBlueBright: Color
+  const bgMagentaBright: Color
+  const bgCyanBright: Color
+  const bgWhiteBright: Color
+
+  const isColorSupported: boolean
+
+  function createColors(options: { useColor: boolean }): Colorette
 }
-
-export const reset: Style
-export const bold: Style
-export const dim: Style
-export const italic: Style
-export const underline: Style
-export const inverse: Style
-export const hidden: Style
-export const strikethrough: Style
-export const black: Style
-export const red: Style
-export const green: Style
-export const yellow: Style
-export const blue: Style
-export const magenta: Style
-export const cyan: Style
-export const white: Style
-export const gray: Style
-export const bgBlack: Style
-export const bgRed: Style
-export const bgGreen: Style
-export const bgYellow: Style
-export const bgBlue: Style
-export const bgMagenta: Style
-export const bgCyan: Style
-export const bgWhite: Style
-export const blackBright: Style
-export const redBright: Style
-export const greenBright: Style
-export const yellowBright: Style
-export const blueBright: Style
-export const magentaBright: Style
-export const cyanBright: Style
-export const whiteBright: Style
-export const bgBlackBright: Style
-export const bgRedBright: Style
-export const bgGreenBright: Style
-export const bgYellowBright: Style
-export const bgBlueBright: Style
-export const bgMagentaBright: Style
-export const bgCyanBright: Style
-export const bgWhiteBright: Style

index.js

@@ -16,16 +16,14 @@ import * as tty from "tty"
 
-let enabled =
+export const isColorSupported =
   !isDisabled && (isForced || isWindows || isCompatibleTerminal || isCI)
 
 const raw = (open, close, searchRegex, replaceValue) => (s) =>
-  enabled
-    ? open +
-      (~(s += "").indexOf(close, 4) // skip opening \x1b[
-        ? s.replace(searchRegex, replaceValue)
-        : s) +
-      close
-    : s
+  open +
+  (~(s += "").indexOf(close, 4) // skip opening \x1b[
+    ? s.replace(searchRegex, replaceValue)
+    : s) +
+  close
 
-const init = (open, close) => {
-  return raw(
+const init = (open, close) =>
+  raw(
     `\x1b[${open}m`,
@@ -36,9 +34,3 @@ `\x1b[${close}m`,
   )
-}
 
-export const options = Object.defineProperty({}, "enabled", {
-  get: () => enabled,
-  set: (value) => (enabled = value),
-})
-
 export const reset = init(0, 0)
@@ -85,1 +77,52 @@ export const bold = raw("\x1b[1m", "\x1b[22m", /\x1b\[22m/g, "\x1b[22m\x1b[1m")
 export const bgWhiteBright = init(107, 49)
+
+const none = (any) => any
+
+export const createColors = ({ useColor = isColorSupported } = {}) => ({
+  ...Object.entries({
+    reset,
+    bold,
+    dim,
+    italic,
+    underline,
+    inverse,
+    hidden,
+    strikethrough,
+    black,
+    red,
+    green,
+    yellow,
+    blue,
+    magenta,
+    cyan,
+    white,
+    gray,
+    bgBlack,
+    bgRed,
+    bgGreen,
+    bgYellow,
+    bgBlue,
+    bgMagenta,
+    bgCyan,
+    bgWhite,
+    blackBright,
+    redBright,
+    greenBright,
+    yellowBright,
+    blueBright,
+    magentaBright,
+    cyanBright,
+    whiteBright,
+    bgBlackBright,
+    bgRedBright,
+    bgGreenBright,
+    bgYellowBright,
+    bgBlueBright,
+    bgMagentaBright,
+    bgCyanBright,
+    bgWhiteBright,
+  }).reduce((colorMap, [key, color]) => ({
+    ...colorMap,
+    [key]: useColor ? color : none,
+  })),
+})

package.json

 {
   "name": "colorette",
-  "version": "1.4.0",
+  "version": "2.0.0",
   "type": "module",
@@ -8,3 +8,3 @@ "main": "index.cjs",
   "types": "index.d.ts",
-  "description": "Easily set the text color and style in the terminal.",
+  "description": "Easily set your terminal text color & styles.",
   "repository": "jorgebucaran/colorette",
@@ -31,3 +31,3 @@ "license": "MIT",
     "test": "c8 twist tests/*.js",
-    "build": "node -e \"fs.writeFileSync('index.cjs', fs.readFileSync('index.js', 'utf8').replace(/export const /g, 'exports.').replace(/import \\* as ([^ ]+) from \\\"(.+)\\\"/, 'const \\$1 = require(\\\"\\$2\\\")'), 'utf8')\"",
+    "build": "npx rollup --interop=esModule --no-esModule --format cjs --input index.js --file index.cjs",
     "deploy": "npm test && git commit --all --message $tag && git tag --sign $tag --message $tag && git push && git push --tags",
@@ -34,0 +34,0 @@ "release": "tag=$npm_package_version npm run deploy && npm publish --access public",

README.md

 # Colorette
 
-> Easily set the text color and style in the terminal.
+> Easily set your terminal text color & styles.
 
@@ -8,3 +8,3 @@ - No wonky prototype method-chain API.
 - Up to [2x faster](#benchmarks) than alternatives.
-- [`NO_COLOR`](https://no-color.org) friendly. 👌
+- [`NO_COLOR`](https://no-color.org) friendly. ✅
 
@@ -40,6 +40,10 @@ Here's the first example to get you started.
 
-Feeling adventurous? Try the [pipeline operator](https://github.com/tc39/proposal-pipeline-operator).
+Need to dynamically override color detection? You can do that too.
 
 ```js
-console.log("Da ba dee da ba daa" |> blue |> bold)
+import { createColors } from "colorette"
+
+const { blue } = createColors({ useColor: false })
+
+console.log(blue("Blue? Nope, nah"))
 ```
@@ -55,30 +59,33 @@
 
-### `<style>(string)`
+### `blue(text)`
 
-See [supported styles](#supported-styles).
+> See all [supported colors](#supported-colors).
 
 ```js
-import { blue } from "colorette"
-
 blue("I'm blue") //=> \x1b[34mI'm blue\x1b[39m
 ```
 
-### `options.enabled`
+### `isColorSupported`
 
-Colorette automatically detects if your terminal can display color, but you can toggle color as needed.
+`true` if your terminal supports color or `false` otherwise. Used internally and handled for you, but exposed for convenience.
 
+### `createColors({ useColor })`
+
+Create a reusable instance of Colorette. Color support is automatically detected, but you can override it by setting the `useColor` boolean property.
+
 ```js
-import { options } from "colorette"
+import { createColors } from "colorette"
 
-options.enabled = false
+const { blue } = createColors({ useColor: false })
 ```
 
-You can also force the use of color globally by setting `FORCE_COLOR=` or `NO_COLOR=` from the CLI.
+## Environment
 
+You can override automatic color detection from the CLI too via `NO_COLOR=` or `FORCE_COLOR=`.
+
 ```console
-$ FORCE_COLOR= node example.js >log
-$ NO_COLOR= node example.js
+$ FORCE_COLOR= node example.js | ./consumer.js
 ```
 
-## Supported styles
+## Supported colors
 
@@ -97,3 +104,3 @@ | Colors  | Background Colors | Bright Colors | Bright Background Colors | Modifiers         |
 
-## Benchmarks
+## [Benchmarks](https://github.com/jorgebucaran/colorette/actions/workflows/bench.yml)
 
@@ -100,0 +107,0 @@ ```console

New alerts

License Policy Violation

License

This package is not allowed per your license policy. Review the package's license to ensure compliance.

Found 1 instance in 1 package

Major refactor

Supply chain risk

Package has recently undergone a major refactor. It may be unstable or indicate significant internal changes. Use caution when updating to versions that include significant changes.

Found 1 instance in 1 package

Fixed alerts

License Policy Violation

License

This package is not allowed per your license policy. Review the package's license to ensure compliance.

Found 1 instance in 1 package

Improved metrics

Total package byte prevSize

14838

increased by31.12%

Lines of code

363

increased by88.08%

Number of lines in readme file

110

increased by6.8%

Worsened metrics

Number of medium supply chain risk alerts

1

increased byInfinity%

No dependency changes