termark 2.0.0 → 3.0.0

package/README.md

@@ -1,259 +1,180 @@
-# ![Termark](https://static.q-file.com/projects/termark/termark.svg)
-
-Termark is a basic library to format console output to the standard non-browser terminal.
-
-## Features & Highlights
-
-- Zero dependencies
-- [ESM & CJS compatible](#esm--cjs-compatibility)
-- [NO_COLOR](https://no-color.org/)-friendly
-- [Default and named imports]
-- [Basic ANSI styling](#basic-ansi-styling) (`dim`, `bold`, `italic`, …)
-- [4-bit](#4-bit-colours) ($2^4 = 16$) colours (`red`, `cyan`, `blueBright`, …)
-- [8-bit](#8-bit-colours) ($2^8 = 256$) colours (`ansi256()`)
-- [24-bit](#24-bit-colours) ($2^{24} = 16777216$; `truecolor`) colours (`rgb()`)
-- [Gradients](#gradients) (`gradient()`)
-- Built-in [terminal logging methods](#built-in-terminal-logging-methods) (`success()`, `info()`, `warn()`, `error()`)
-- [Template strings](#template-strings) & [nested styles](#nested-styles) (``` green`Success: File ${cyan`plans.txt`} created successfully!` ```)
-- [Colour-detection utilities](#colour-detection-utilities) (`areColorsEnabled`, `is8bitEnabled`, `is24bitEnabled`)
-- [Usage as an object or as a class](#class-v-object)
-
-## Installation
-
-```bash
-npm install termark
-```
-
-## ESM & CJS compatibility
-
-Termark is compatible with both ECMAScript modules (`import`/`export` syntax), and CommonJS:
-
-```js
-// CJS:
-const termark = require('termark');
-
-// ESM:
-import termark from 'termark';
-```
-
-## Default & named imports
-
-Termark offers both a default import that has access to all properties and methods, or you can import each one individually:
-
-```ts
-// Default import:
-import termark from 'termark';
-
-termark.info('This is the default import, where all properties and methods are accessible.');
-
-// Named imports:
-import { success, inverse } from 'termark';
-
-success(
-    inverse('This text with a green background is achieved with named imports!')
-)
-```
-
-## Usage
-
-Here's a quick reference for every feature Termark provides:
-
-```ts
-import termark from 'termark';
-
-console.log(
-    termark.red('This is red text.'),
-    termark.bgGreen('This text has a green background.'),
-    termark.cyan`There's support for template strings as well`,
-    termark.ansi256('text', 33)('This single function handles text and background colour!'),
-    termark.rgb('background', 42, 122, 255)('This is some dark blue text'),
-    termark.gradient('text', [[53, 72, 172], [200, 230, 121]])('Gradients are also possible.'),
-    termark.areColorsEnabled,
-    termark.is8bitEnabled,
-    termark.is24bitEnabled
-);
-```
-
-### Basic ANSI styling
-
-```ts
-import termark from 'termark';
-
-termark.reset('...');
-termark.bold('...');
-termark.dim('...');
-termark.italic('...');
-termark.underline('...');
-termark.blink('...');
-termark.inverse('...');
-termark.overline('...');
-termark.hidden('...');
-termark.strike('...');
-```
-
-### 4-bit colours
-
-```ts
-import termark from 'termark';
-
-termark.black('...');
-termark.red('...');
-termark.green('...');
-termark.yellow('...');
-termark.blue('...');
-termark.magenta('...');
-termark.white('...');
-
-termark.blackBright('...');
-termark.redBright('...');
-termark.greenBright('...');
-termark.yellowBright('...');
-termark.blueBright('...');
-termark.magentaBright('...');
-termark.whiteBright('...');
-
-termark.bgBlack('...');
-termark.bgRed('...');
-termark.bgGreen('...');
-termark.bgYellow('...');
-termark.bgBlue('...');
-termark.bgMagenta('...');
-termark.bgWhite('...');
-
-termark.bgBlackBright('...');
-termark.bgRedBright('...');
-termark.bgGreenBright('...');
-termark.bgYellowBright('...');
-termark.bgBlueBright('...');
-termark.bgMagentaBright('...');
-termark.bgWhiteBright('...');
-```
-
-### 8-bit colours
-
-```ts
-import termark from 'termark';
-
-termark.ansi256('text', 33)('...');
-termark.ansi256('background', 200)('...');
-```
-
-### 24-bit colours
-
-```ts
-import termark from 'termark';
-
-// You can specify your RGB values as an array:
-termark.rgb('text', [182, 22, 234])('...');
-termark.rgb('background', [200, 0, 184])('...');
-
-// ...or as a simple list of three values:
-termark.rgb('text', 182, 22, 234)('...');
-termark.rgb('background', 200, 0, 184)('...');
-
-
-// This method is compatible with `color-convert`:
-import convert from 'color-convert';
-
-termark.rgb('text', convert.hex.rgb('008330'))('...');
-```
-
-### Gradients
-
-**Please note that gradients do not support nested styling.**
-
-```ts
-import termark from 'termark';
-
-termark.gradient('text', [[200, 123, 0], [0, 255, 255], [177, 209, 10]])('...');
-termark.gradient('background', [[123, 75, 204], [255, 255, 255], [0, 44, 55]])('...');
-```
-
-### Built-in terminal logging methods
-
-```ts
-import termark from 'termark';
-
-termark.success('...'); // Logs some message in green as an info message.
-termark.info('...'); // Logs some message in blue as an info message.
-termark.warning('...'); // Logs some message in yellow as a warning.
-termark.error('...'); // Logs some message in red as an error.
-
-// These also support prefixes for branding purposes:
-
-const brandPrefix = termark.blue('Example') + termark.blackBright(' - ');
-
-termark.error('File not found', brandPrefix);
-```
-
-### Template strings
-
-```ts
-import termark from 'termark';
-
-// Instead of using this:
-termark.blue('...');
-
-// ...you can use this:
-termark.blue`...`;
-```
-
-### Nested styles
-
-```ts
-import termark from 'termark';
-
-termark.blue(
-    'This is some blue text ' +
-    termark.yellow('That becomes yellow,') +
-    ' that becomes blue again.'
-);
-```
-
-### Colour-detection utilities
-
-```ts
-import termark from 'termark';
-
-termark.areColorsEnabled; // Check whether terminal colours are enabled.
-termark.is8bitEnabled; // Check whether 8-bit (256) colours are enabled.
-termark.is24bitEnabled; // Check whether 24-bit (truecolor) colours are enabled.
-```
-
-### Class v. Object
-
-You can use Termark by importing the object, or you can import the class:
-
-```ts
-import { Termark } from 'termark';
-
-const termark = new Termark(); // This is the same as importing the `termark` object.
-termark.success('Termark is working!');
-
-// Alternatively, you could do this:
-Termark.init.success('This work, too!');
-```
-
-`Termark.init` enables using the `Termark` class as the default `termark` object.
-
-## Licence
-
-Termark's code is licenced under the [Apache licence version 2](https://www.apache.org/licenses/LICENSE-2.0).  
-The full licence text is present in these source files.
-In addition, this snippet of text is present at the top of all files:
-
-```txt
-Copyright 2025 Q
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
-    http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
-```
+<div align="center">
+    <img alt="Termark" src="logo.webp" title="Termark logo" />
+</div>
+
+Termark is a basic library to format console output to the standard non-browser terminal.
+
+<!-- TOC -->
+
+- [Features](#features)
+- [Usage](#usage)
+    - [Installation](#installation)
+    - [ESM & CJS compatibility](#esm--cjs-compatibility)
+    - [Basic usage](#basic-usage)
+- [Licence](#licence)
+  <!-- TOC -->
+
+## Features
+
+- **Familiar syntax** (`fmt.bold.brightRed.bgBlue("...")`)
+- **ESM & CJS compatibility**
+- [**NO_COLOR**](https://no-color.org/)-friendly
+- [**FORCE_COLOR**](https://force-color.org/)-friendly
+- **`truecolor` support** including gradients
+- **Automatic colour-support detection** with **step-wise fallback** (truecolor → 8-bit → 4-bit → plain text)
+- **Extensible** via `extend`; includes **built-in support** for `css-color-names` via `fromColObject`
+- **Runtime-agnostic** (currently supported: Node, Bun, Deno)
+
+## Usage
+
+### Installation
+
+Termark can be installed via any package manager that can interact with the NPM registry:
+
+```bash
+# NPM
+npm i termark
+
+# PNPM
+pnpm add termark
+
+# Deno
+deno add npm:termark
+
+# Bun
+bun add termark
+```
+
+### ESM & CJS compatibility
+
+Termark is compatible with ECMAScript modules (`import`/`export` syntax) and CommonJS:
+
+```js
+// CJS:
+const { fmt } = require("termark");
+
+// ESM:
+import { fmt } from "termark";
+```
+
+### Basic usage
+
+All exports of Termark are named exports, with the primary tool being `fmt` ("format"):
+
+```ts
+import { fmt } from "termark";
+
+// Basic chaining syntax
+console.log(fmt.blue.bold("Text"));
+
+// Nesting style
+console.log(fmt.bold.red(`Error: This ${fmt.brightCyan("file")} is corrupted!`));
+```
+
+### Advanced colouring
+
+Termark features methods like `hex` and `rgb` as well as the powerful `gradient` for advanced, versatile colouring. All of these methods feature `bg*` variants.
+
+```ts
+import { fmt } from "termark";
+
+// Hex and RGB colour-mapping
+console.log(fmt.hex("#80b3ff").text("Light blue text"));
+console.log(fmt.rgb([0, 255, 128]).text("Light green text"));
+
+// Gradients (supports hex string/RGB tuple arrays)
+const sunset = ["#ff5e62", "#f96"];
+console.log(fmt.gradient(sunset).text("Beautiful terminal gradient"));
+
+// Background variants (`bgHex`, `bgRgb`, `bgGradient`)
+console.log(fmt.bgHex("#222").white("..."));
+```
+
+Termark also features the ability to use singular 8-bit colour codes to style outputs with `fg` and `bg`.
+
+```ts
+import { fmt } from "termark";
+
+console.log(fmt.fg(57).text("..."));
+```
+
+**Note:** The `.text()` method is designed for `hex`, `rgb`, `gradient`, and `fg` when they are the last in the chain or when no other styling is needed. However, technically _all_ styling chains can be terminated by `.text()`, e.g., `fmt.bold.red.text("...")`. `.text()` exists to eliminate the need to write `hex("#338cd1")("Coloured text")`, which is still an option, but it's not elegant.
+
+### Layout utilities
+
+Termark features a powerful `box` method which lets you encase your text in a, well, box.
+
+```ts
+import { fmt, box } from "termark";
+
+const myBox = box(fmt.bold.brightGreen("Deployment successful!"), {
+    kind: "rounded",
+    padding: 2, // Vertical padding only increases every four units.
+    margin: 3, // Vertical margin only increases every four units.
+    style: fmt.hex("#ffa500"), // Orange border
+});
+
+console.log(myBox);
+```
+
+### Extensibility
+
+**Note:** All extensions of Termark must be called as the last one in a given chain, and a string must be passed.
+
+#### via `extend`
+
+With the `extend` function, any kind of method can be created as an extension of Termark, such as shortcuts to styles.
+
+```ts
+import { extend, ansiUpperCase } from "termark";
+
+const myLib = extend((base) => ({
+    // Formatting extensions
+    shout: (str) => base.red.bold(ansiUpperCase(str)),
+    // Colouring extensions
+    orange: (str) => base.hex("#ffa500").text(str),
+}));
+
+console.log(myLib.shout("This text is in red bold and all-caps"));
+```
+
+**Note:** When transforming text such as making it upper-case, use `transformPreserveAnsi` or a function derived from it (such as `ansiUpperCase` in the above example) if you plan to nest styles. Keep in mind that transformations apply to nested styles, too; for `shout` above, all nested text will be upper-case too by default.
+
+#### via `fromColObject`
+
+The `fromColObject` function enables mapping mass colour dictionaries into styling methods. Excellent for packages like [`css-color-names`](https://github.com/bahamas10/css-color-names) or [`color-names`](https://github.com/meodai/color-names) (the latter with some additional work).
+
+```ts
+import { fromColObject } from "termark";
+import cssColours from "css-color-names";
+
+const extendedWithCss = fromColObject(cssColours);
+```
+
+By default, background styling methods aren't created. To do that, simply pass `true` for the second parameter.
+
+```ts
+import { fromColObject } from "termark";
+import cssColours from "css-color-names";
+
+const withBg = fromColObject(cssColours, true);
+```
+
+### Hyperlinks
+
+Hyperlinks are achieved by Termark with the help of [OSC 8](https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda). Currently, it is non-standard, and may not be supported in every terminal.
+
+```ts
+import { fmt } from "termark";
+
+const link = fmt.link("https://q-file.com");
+const linkWithText = fmt.link("https://q-file.com", "Website");
+
+const styled = fmt.hex("#a7f").link("https://q-file.com", "Website");
+```
+
+`link` must be called as the last element in the chain.
+
+## Licence
+
+Termark's code is licenced under the [Apache licence version 2](https://www.apache.org/licenses/LICENSE-2.0).

package/README.npm.md

@@ -0,0 +1,57 @@
+<!-- NPM README file -->
+
+# Termark
+
+A basic library to format console output to the standard non-browser terminal.
+
+> _For full documentation, see [the repository](https://codeberg.org/Genesis_Software/termark)._
+
+## Usage
+
+### ESM & CJS compatibility
+
+Termark is compatible with both ESM and CJS:
+
+```js
+// CJS:
+const { fmt } = require("termark");
+
+// ESM:
+import { fmt } from "termark";
+```
+
+### Basic example
+
+Most features of Termark are found in the `fmt` ("format") export:
+
+```js
+import { fmt } from "termark";
+
+console.log(fmt.bold.blue("..."));
+```
+
+### Extensions
+
+Termark can be extended with custom methods via `extend`:
+
+```js
+import { extend } from "termark";
+
+const myLib = extend((base) => ({
+    orange: (str) => base.hex("#ffa500").text(str),
+}));
+```
+
+**Note:** When modifying strings (e.g., `toUpperCase`), writing `str.toUpperCase` will make nesting not work. Instead, use `transformPreserveAnsi` or a function derived from it such as `ansiUpperCase` to transform strings so that nesting will work. Keep in mind that string transformations apply to nested strings as well.
+
+```js
+import { extend, ansiUpperCase } from "termark";
+
+const myLib = extend((base) => ({
+    shout: (str) => base.red.bold(ansiUpperCase(str)),
+}));
+```
+
+## Licence
+
+Termark's code is licenced under the [Apache licence version 2](https://www.apache.org/licenses/LICENSE-2.0).

package/dist/__internal/conversion.cjs

@@ -0,0 +1 @@
+const e=require(`./util.cjs`);function t(t){let n=e.hexColourRegex.exec(t);if(!n)return[255,255,255];let r=n[1].replace(/^#/,``),i=3^r.length?r:r.split(``).map(e=>e+e).join(``),a=parseInt(i,16);return[a>>16&255,a>>8&255,a&255]}function n([e,t,n]){return e^t||t^n?16+36*Math.round(e/51)+6*Math.round(t/51)+Math.round(n/51):e<8?16:e>248?231:Math.round((e-8)*24/247)+232}function r(e){if(e<8)return 30+e;if(e<16)return 82+e;let t,n,r;if(e<232){let i=e-16,a=i%36;t=(i/36|0)/5,n=(a/6|0)/5,r=a%6/5}else t=n=r=((e-232)*10+8)/255;let i=Math.max(t,n,r)*2,a=Math.round(t),o=Math.round(n)<<1,s=Math.round(r)<<2,c=2^i?0:60;return 30+(s|o|a)+c}exports.ansi256To4bit=r,exports.hexToRgb=t,exports.rgbToAnsi256=n;

package/dist/__internal/conversion.mjs

@@ -0,0 +1 @@
+import{hexColourRegex as e}from"./util.mjs";function t(t){let n=e.exec(t);if(!n)return[255,255,255];let r=n[1].replace(/^#/,``),i=3^r.length?r:r.split(``).map(e=>e+e).join(``),a=parseInt(i,16);return[a>>16&255,a>>8&255,a&255]}function n([e,t,n]){return e^t||t^n?16+36*Math.round(e/51)+6*Math.round(t/51)+Math.round(n/51):e<8?16:e>248?231:Math.round((e-8)*24/247)+232}function r(e){if(e<8)return 30+e;if(e<16)return 82+e;let t,n,r;if(e<232){let i=e-16,a=i%36;t=(i/36|0)/5,n=(a/6|0)/5,r=a%6/5}else t=n=r=((e-232)*10+8)/255;let i=Math.max(t,n,r)*2,a=Math.round(t),o=Math.round(n)<<1,s=Math.round(r)<<2,c=2^i?0:60;return 30+(s|o|a)+c}export{r as ansi256To4bit,t as hexToRgb,n as rgbToAnsi256};

package/dist/__internal/env.cjs

@@ -0,0 +1 @@
+function e(e){if(typeof globalThis.process?.env==`object`)return globalThis.process.env[e];if(typeof globalThis.Deno?.env?.get==`function`)try{return globalThis.Deno.env.get(e)}catch{return}}function t(){if(globalThis.process?.stdout?.isTTY)return!0;if(typeof globalThis.Deno?.stdout?.isTerminal==`function`)try{return globalThis.Deno.stdout?.isTerminal()}catch{return!1}return!1}function n(){let t=e(`NO_COLOR`)||e(`NODE_DISABLE_COLORS`);return t!==void 0&&t!==``}function r(){if(n())return 0;let r=e(`FORCE_COLOR`);if(r!==void 0)return r===`0`?0:r===`1`?1:r===`2`?2:r===`3`?3:1;if(!t())return e(`CI`)&&(e(`GITHUB_ACTIONS`)||e(`GITLAB_CI`))?1:0;let i=e(`TERM`);if(i===`dumb`)return 0;let a=e(`COLORTERM`);return a===`truecolor`||a===`24bit`||e(`TERM_PROGRAM`)===`vscode`?3:i&&/-256(color)?$/i.test(i)||e(`TERM_PROGRAM`)===`Apple_Terminal`?2:(i&&/color|ansi|cygwin|linux/i.test(i),1)}exports.getColourLevel=r,exports.hasNoColour=n;

package/dist/__internal/env.d.mts

@@ -0,0 +1,21 @@
+import { ColourLevel } from "../types.mjs";
+
+//#region src/__internal/env.d.ts
+/**
+* Check whether `NO_COLOR` is an existing environment variable with any value that is not an empty string, thereby
+* disabling colours from being printed.
+*
+* This also checks the existence of the `NODE_DISABLE_COLORS` environment variable, behaving the same way if it
+* exists and not an empty string.
+*
+* @see https://no-color.org
+*/
+declare function hasNoColour(): boolean;
+/**
+* Get the colour level of the terminal environment.
+*
+* @returns {@linkcode ColourLevel}
+*/
+declare function getColourLevel(): ColourLevel;
+//#endregion
+export { getColourLevel, hasNoColour };

package/dist/__internal/env.mjs

@@ -0,0 +1 @@
+function e(e){if(typeof globalThis.process?.env==`object`)return globalThis.process.env[e];if(typeof globalThis.Deno?.env?.get==`function`)try{return globalThis.Deno.env.get(e)}catch{return}}function t(){if(globalThis.process?.stdout?.isTTY)return!0;if(typeof globalThis.Deno?.stdout?.isTerminal==`function`)try{return globalThis.Deno.stdout?.isTerminal()}catch{return!1}return!1}function n(){let t=e(`NO_COLOR`)||e(`NODE_DISABLE_COLORS`);return t!==void 0&&t!==``}function r(){if(n())return 0;let r=e(`FORCE_COLOR`);if(r!==void 0)return r===`0`?0:r===`1`?1:r===`2`?2:r===`3`?3:1;if(!t())return e(`CI`)&&(e(`GITHUB_ACTIONS`)||e(`GITLAB_CI`))?1:0;let i=e(`TERM`);if(i===`dumb`)return 0;let a=e(`COLORTERM`);return a===`truecolor`||a===`24bit`||e(`TERM_PROGRAM`)===`vscode`?3:i&&/-256(color)?$/i.test(i)||e(`TERM_PROGRAM`)===`Apple_Terminal`?2:(i&&/color|ansi|cygwin|linux/i.test(i),1)}export{r as getColourLevel,n as hasNoColour};

package/dist/__internal/format.cjs

@@ -0,0 +1 @@
+function e(e){return`\x1b[${e}m`}function t(e,t,n){return e.indexOf(n)===-1?`${t}${e}${n}`:`${t}${e.replaceAll(n,n+t)}${n}`}exports.formatForNesting=t,exports.toFormatter=e;

package/dist/__internal/format.mjs

@@ -0,0 +1 @@
+function e(e){return`\x1b[${e}m`}function t(e,t,n){return e.indexOf(n)===-1?`${t}${e}${n}`:`${t}${e.replaceAll(n,n+t)}${n}`}export{t as formatForNesting,e as toFormatter};

package/dist/__internal/impl.cjs

@@ -0,0 +1 @@
+const e=require(`./format.cjs`),t=require(`./env.cjs`),n=require(`./styling.cjs`);var r=class n{constructor(e=[],t){this.$styles=[],this.$styles=e,t&&(this.$pending=t)}apply(t){return this.$styles.reduce((t,n)=>typeof n==`function`?n(t):e.formatForNesting(t,n.open.charCodeAt(0)===27?n.open:e.toFormatter(n.open),n.close.charCodeAt(0)===27?n.close:e.toFormatter(n.close)),t)}call(e){if(typeof e!=`string`)throw TypeError(`[Termark :: TypeError] Styling can be applied to strings only`);return(this.$pending??(e=>e))(this.apply(e))}get terminator(){let e=this.$pending??(e=>e);return t=>e(this.apply(t))}get link(){return t.hasNoColour()?(e,t)=>t===e?e:`${t} (${e})`:(e,t)=>{let n=`\x1B]8;;`,r=`${n}${e}\\${t||e}${n}\\`;return this.apply(r)}}add(e){return new n(this.$pending?[...this.$styles,this.$pending,e]:[...this.$styles,e])}setPending(e){return this.$pending?new n([...this.$styles,this.$pending],e):new n(this.$styles,e)}};function i(e,t={}){return new Proxy(t=>e.call(t),{get(r,a){if(a in n.BUILT_INS){let[r,o]=n.BUILT_INS[a],s={open:String(r),close:String(o)};return i(e.add(s),t)}if(a===`fg`)return t=>i(e.setPending(n.$ansi256(t,`fg`)));if(a===`bg`)return t=>i(e.setPending(n.$ansi256(t,`bg`)));if(a===`hex`)return r=>i(e.setPending(n.$hex(r,`fg`)),t);if(a===`rgb`)return r=>i(e.setPending(n.$rgb(r,`fg`)),t);if(a===`gradient`)return(...r)=>i(e.setPending(n.$gradient(r,`fg`)),t);if(a===`bgHex`)return r=>i(e.setPending(n.$hex(r,`bg`)),t);if(a===`bgRgb`)return r=>i(e.setPending(n.$rgb(r,`bg`)),t);if(a===`bgGradient`)return(...r)=>i(e.setPending(n.$gradient(r,`bg`)),t);if(a===`link`)return e.link;if(a in t)return i(e.add(t[a]),t);if(a===`text`)return e.terminator;throw Error(`[Termark :: Error] Unknown style ${a}`)},apply(t,n,r){return e.call(r[0])}})}exports.TermarkImpl=r,exports.createProxy=i;

package/dist/__internal/impl.mjs

@@ -0,0 +1 @@
+import{formatForNesting as e,toFormatter as t}from"./format.mjs";import{hasNoColour as n}from"./env.mjs";import{$ansi256 as r,$gradient as i,$hex as a,$rgb as o,BUILT_INS as s}from"./styling.mjs";var c=class r{constructor(e=[],t){this.$styles=[],this.$styles=e,t&&(this.$pending=t)}apply(n){return this.$styles.reduce((n,r)=>typeof r==`function`?r(n):e(n,r.open.charCodeAt(0)===27?r.open:t(r.open),r.close.charCodeAt(0)===27?r.close:t(r.close)),n)}call(e){if(typeof e!=`string`)throw TypeError(`[Termark :: TypeError] Styling can be applied to strings only`);return(this.$pending??(e=>e))(this.apply(e))}get terminator(){let e=this.$pending??(e=>e);return t=>e(this.apply(t))}get link(){return n()?(e,t)=>t===e?e:`${t} (${e})`:(e,t)=>{let n=`\x1B]8;;`,r=`${n}${e}\\${t||e}${n}\\`;return this.apply(r)}}add(e){return new r(this.$pending?[...this.$styles,this.$pending,e]:[...this.$styles,e])}setPending(e){return this.$pending?new r([...this.$styles,this.$pending],e):new r(this.$styles,e)}};function l(e,t={}){return new Proxy(t=>e.call(t),{get(n,c){if(c in s){let[n,r]=s[c],i={open:String(n),close:String(r)};return l(e.add(i),t)}if(c===`fg`)return t=>l(e.setPending(r(t,`fg`)));if(c===`bg`)return t=>l(e.setPending(r(t,`bg`)));if(c===`hex`)return n=>l(e.setPending(a(n,`fg`)),t);if(c===`rgb`)return n=>l(e.setPending(o(n,`fg`)),t);if(c===`gradient`)return(...n)=>l(e.setPending(i(n,`fg`)),t);if(c===`bgHex`)return n=>l(e.setPending(a(n,`bg`)),t);if(c===`bgRgb`)return n=>l(e.setPending(o(n,`bg`)),t);if(c===`bgGradient`)return(...n)=>l(e.setPending(i(n,`bg`)),t);if(c===`link`)return e.link;if(c in t)return l(e.add(t[c]),t);if(c===`text`)return e.terminator;throw Error(`[Termark :: Error] Unknown style ${c}`)},apply(t,n,r){return e.call(r[0])}})}export{c as TermarkImpl,l as createProxy};

package/dist/__internal/styling.cjs

@@ -0,0 +1 @@
+const e=require(`./format.cjs`),t=require(`./env.cjs`),n=require(`./util.cjs`),r=require(`./conversion.cjs`),i={reset:[0,0],bold:[1,22],dim:[2,22],italic:[3,23],underline:[4,24],blink:[5,25],inverse:[7,27],overline:[53,55],hidden:[8,28],strike:[9,29],black:[30,39],red:[31,39],green:[32,39],yellow:[33,39],blue:[34,39],magenta:[35,39],cyan:[36,39],white:[37,39],bgBlack:[40,49],bgRed:[41,49],bgGreen:[42,49],bgYellow:[43,49],bgBlue:[44,49],bgMagenta:[45,49],bgCyan:[46,49],bgWhite:[47,49],brightBlack:[90,39],grey:[90,39],gray:[90,39],brightRed:[91,39],brightGreen:[92,39],brightYellow:[93,39],brightBlue:[94,39],brightMagenta:[95,39],brightCyan:[96,39],brightWhite:[97,39],bgBrightBlack:[100,49],bgGrey:[100,49],bgGray:[100,49],bgBrightRed:[101,49],bgBrightGreen:[102,49],bgBrightYellow:[103,49],bgBrightBlue:[104,49],bgBrightMagenta:[105,49],bgBrightCyan:[106,49],bgBrightWhite:[107,49]},a={sharp:{tl:`┌`,tr:`┐`,bl:`└`,br:`┘`,h:`─`,v:`│`},rounded:{tl:`╭`,tr:`╮`,bl:`╰`,br:`╯`,h:`─`,v:`│`},double:{tl:`╔`,tr:`╗`,bl:`╚`,br:`╝`,h:`═`,v:`║`},heavy:{tl:`┏`,tr:`┓`,bl:`┗`,br:`┛`,h:`━`,v:`┃`},dashed:{tl:`┌`,tr:`┐`,bl:`└`,br:`┘`,h:`⹀`,v:`╎`},dotted:{tl:`┌`,tr:`┐`,bl:`└`,br:`┘`,h:`╌`,v:`┊`},ascii:{tl:`+`,tr:`+`,bl:`+`,br:`+`,h:`-`,v:`|`}};function o(n,i){let a;if(t.getColourLevel()===3){let t=n.join(`;`);a=e.toFormatter(i===`fg`?`38;2;${t}`:`48;2;${t}`)}else if(t.getColourLevel()===2){let t=r.rgbToAnsi256(n);a=e.toFormatter(i===`fg`?`38;5;${t}`:`48;5;${t}`)}else{let t=r.ansi256To4bit(r.rgbToAnsi256(n));a=e.toFormatter(i===`fg`?t:t+10)}return a}function s(r,i){if(t.hasNoColour()||t.getColourLevel()===0)return e=>e;let a=o(r.map(e=>n.clamp(e,0,255)),i),s=e.toFormatter(i===`fg`?39:49);return t=>e.formatForNesting(t,a,s)}function c(e,t){return n.hexColourRegex.test(e)?s(r.hexToRgb(e),t):e=>e}function l(i,a){return t.hasNoColour()||t.getColourLevel()===0||i.length===0?e=>e:i.length===1?i.every(e=>typeof e==`string`)?c(i[0],a):s(i[0],a):t=>{let s=i.every(e=>typeof e==`string`)?i.map(e=>r.hexToRgb(e)):i,c=s.length,l=Math.min(t.length/(c-1)),u=``,d=e.toFormatter(a===`fg`?39:49);for(let e=0;e<t.length;e++){let r=Math.min(Math.floor(e/l),c-2),i=e%l/l,f=s[r],p=s[r+1],[m,h,g]=n.interpolate(f,p,i),_=o([m,h,g],a);u+=`${_}${t[e]}${d}`}return u}}function u(i,a){if(t.hasNoColour()||t.getColourLevel()===0)return e=>e;let o=n.clamp(i,0,255),s;if(t.getColourLevel()>=2)s=e.toFormatter(a===`fg`?`38;5;${o}`:`48;5;${o}`);else{let t=r.ansi256To4bit(o);s=e.toFormatter(a===`fg`?t:t+10)}let c=e.toFormatter(a===`fg`?39:49);return t=>e.formatForNesting(t,s,c)}exports.$ansi256=u,exports.$gradient=l,exports.$hex=c,exports.$rgb=s,exports.BOX_BORDERS=a,exports.BUILT_INS=i;