{"_id":"@art-suite/art-core-terminal-colors","_rev":"5-742f65f29b0cef0aef4d1bc4801a5e37","name":"@art-suite/art-core-terminal-colors","dist-tags":{"latest":"0.1.4"},"versions":{"0.1.0":{"name":"@art-suite/art-core-terminal-colors","version":"0.1.0","author":{"name":"Shane Brinkman-Davis Delamore"},"license":"ISC","_id":"@art-suite/art-core-terminal-colors@0.1.0","maintainers":[{"name":"shanebdavis","email":"shanebdavis@gmail.com"}],"homepage":"https://github.com/art-suite/art-suite-foundations","bugs":{"url":"https://github.com/art-suite/art-suite-foundations/issues"},"dist":{"shasum":"e845f983bc127785e7d4d7b3e946d17ed5475f78","tarball":"https://registry.npmjs.org/@art-suite/art-core-terminal-colors/-/art-core-terminal-colors-0.1.0.tgz","fileCount":18,"integrity":"sha512-CW2z3jPdag+qvLpYCSS706NEIwvEvuwu8ZTbIvJLBjYPz9uTINIAcQYuq0/F4uiVIFXag7p0aqDZlauhNJOxDw==","signatures":[{"sig":"MEUCIEMqWXRv7AMeY8O7XTPppugXznhfpi5kRJDhZ1rstemcAiEArHcrpJunixk6pxwEISqrKVxSOE7CuEJJCc8ACdVi9DM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":14537},"jest":{"verbose":true,"testEnvironment":"node","collectCoverageFrom":["build/**/*.js","!build/test/**/*.js"],"testPathIgnorePatterns":["/node_modules/","<rootDir>/test"],"coveragePathIgnorePatterns":["/index.js$","/namespace.js$"]},"main":"./build","watch":{"build":{"quiet":false,"patterns":["source"],"extensions":["caf","coffee"]}},"gitHead":"c832662a1fe44225f05cf4730dd514a79741a467","scripts":{"nn":"nn build/* ","test":"jest","build":"rsync -av --exclude='*.caf' ./source/ ./build/\ncaf -m -c source -o build\nnpm run nn","clean":"rm -rf build/*","test-watch":"jest --watch","build-clean":"# BUILD CLEAN START\n#   - building into: build-temp\n#\nrm -rf ./__build-old__\nrsync -av --exclude='*.caf' ./source/ ./build-temp/\ncaf -m -c source -o build-temp\nnpm run nn\n\nnn build-temp/*\n\n# BUILD CLEAN FINIALIZING\n#  - replace old build in:   build\n#  - with new build from:    build-temp\n#\nmv build __build-old__\nmv build-temp build\nrm -rf ./__build-old__","build-watch":"nodemon -e js,ts,jsx,tsx,caf,coffee,json -w \"source/**\" -x npm run build"},"_npmUser":{"name":"shanebdavis","email":"shanebdavis@gmail.com"},"repository":{"url":"git+https://github.com/art-suite/art-suite-foundations.git","type":"git"},"_npmVersion":"10.9.0","description":"The Standard Library for JavaScript that aught to be.","directories":{},"_nodeVersion":"22.12.0","dependencies":{"caffeine-script-runtime":"^1.14.0","neptune-namespaces-runtime":"^3.2.14"},"_hasShrinkwrap":false,"devDependencies":{"mocha":"^7.2.0","art-testbench":"^3.2.17","art-build-configurator":"^1.30.4","@art-suite/standard-package-builder":"^1.2.7"},"_npmOperationalInternal":{"tmp":"tmp/art-core-terminal-colors_0.1.0_1746741356237_0.4753176041945988","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@art-suite/art-core-terminal-colors","version":"0.1.1","author":{"name":"Shane Brinkman-Davis Delamore"},"license":"ISC","_id":"@art-suite/art-core-terminal-colors@0.1.1","maintainers":[{"name":"shanebdavis","email":"shanebdavis@gmail.com"}],"homepage":"https://github.com/art-suite/art-suite-foundations","bugs":{"url":"https://github.com/art-suite/art-suite-foundations/issues"},"dist":{"shasum":"bb3950554d9ae92a13810cf1f53de7c9913a8c82","tarball":"https://registry.npmjs.org/@art-suite/art-core-terminal-colors/-/art-core-terminal-colors-0.1.1.tgz","fileCount":18,"integrity":"sha512-fEFEjv1us6DpR1bEzzOzRj8VnjEF5WjDCChWYwDJeQljjdLJBJG2Wn2Dg7raC2EN5UGd4vCc6jQ+nX/6BLIOsQ==","signatures":[{"sig":"MEQCIBqt8/+bz0nh93FeSgUr38jPqw24BfRgzR6IX+bogMKZAiBiR6vqlGGMTbV/v2CS96197JkqiUVqdGYmhrDlTis0Nw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":14641},"jest":{"verbose":true,"testEnvironment":"node","collectCoverageFrom":["build/**/*.js","!build/test/**/*.js"],"testPathIgnorePatterns":["/node_modules/","<rootDir>/test"],"coveragePathIgnorePatterns":["/index.js$","/namespace.js$"]},"main":"./build","watch":{"build":{"quiet":false,"patterns":["source"],"extensions":["caf","coffee"]}},"exports":{".":{"import":"./index.mjs","require":"./build/index.js"}},"gitHead":"bedd81435373af9778e14146163a6077d4fdcc81","scripts":{"nn":"nn build/* ","test":"jest","build":"rsync -av --exclude='*.caf' ./source/ ./build/\ncaf -m -c source -o build\nnpm run nn","clean":"rm -rf build/*","test-watch":"jest --watch","build-clean":"# BUILD CLEAN START\n#   - building into: build-temp\n#\nrm -rf ./__build-old__\nrsync -av --exclude='*.caf' ./source/ ./build-temp/\ncaf -m -c source -o build-temp\nnpm run nn\n\nnn build-temp/*\n\n# BUILD CLEAN FINIALIZING\n#  - replace old build in:   build\n#  - with new build from:    build-temp\n#\nmv build __build-old__\nmv build-temp build\nrm -rf ./__build-old__","build-watch":"nodemon -e js,ts,jsx,tsx,caf,coffee,json -w \"source/**\" -x npm run build"},"_npmUser":{"name":"shanebdavis","email":"shanebdavis@gmail.com"},"repository":{"url":"git+https://github.com/art-suite/art-suite-foundations.git","type":"git"},"_npmVersion":"10.9.0","description":"The Standard Library for JavaScript that aught to be.","directories":{},"_nodeVersion":"22.12.0","dependencies":{"caffeine-script-runtime":"^1.14.0","neptune-namespaces-runtime":"^3.2.14"},"_hasShrinkwrap":false,"devDependencies":{"mocha":"^7.2.0","art-testbench":"^3.2.17","art-build-configurator":"^1.30.4","@art-suite/standard-package-builder":"^1.2.7"},"_npmOperationalInternal":{"tmp":"tmp/art-core-terminal-colors_0.1.1_1746783864037_0.5159483563659983","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@art-suite/art-core-terminal-colors","version":"0.1.2","author":{"name":"Shane Brinkman-Davis Delamore"},"license":"ISC","_id":"@art-suite/art-core-terminal-colors@0.1.2","maintainers":[{"name":"shanebdavis","email":"shanebdavis@gmail.com"}],"homepage":"https://github.com/art-suite/art-suite-foundations","bugs":{"url":"https://github.com/art-suite/art-suite-foundations/issues"},"dist":{"shasum":"a59adcfa263d025d0f9ac243ff14416af1fd3dcd","tarball":"https://registry.npmjs.org/@art-suite/art-core-terminal-colors/-/art-core-terminal-colors-0.1.2.tgz","fileCount":18,"integrity":"sha512-ejrd2J5WgbjiwJkiuHxBjzm6CpN06yB5EUY1u7ichaUEaFOqHqbaaiZ+Y9uX+O8JTChJI2lbDOnuwOxqSceP1g==","signatures":[{"sig":"MEUCIDV2y0SD4od+jbu2JP0gOgrIR6aAiWFezS3QAqFSmPPHAiEA8ZuRUm/GjC0WtXUDDulNDbldIT7ICNIcq1n7XUO68jE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":14641},"jest":{"verbose":true,"testEnvironment":"node","collectCoverageFrom":["build/**/*.js","!build/test/**/*.js"],"testPathIgnorePatterns":["/node_modules/","<rootDir>/test"],"coveragePathIgnorePatterns":["/index.js$","/namespace.js$"]},"main":"./build","watch":{"build":{"quiet":false,"patterns":["source"],"extensions":["caf","coffee"]}},"exports":{".":{"import":"./index.mjs","require":"./build/index.js"}},"gitHead":"a94165479e2a1bce1798e54eabcb679c47599240","scripts":{"nn":"nn build/* ","test":"jest","build":"rsync -av --exclude='*.caf' ./source/ ./build/\ncaf -m -c source -o build\nnpm run nn","clean":"rm -rf build/*","test-watch":"jest --watch","build-clean":"# BUILD CLEAN START\n#   - building into: build-temp\n#\nrm -rf ./__build-old__\nrsync -av --exclude='*.caf' ./source/ ./build-temp/\ncaf -m -c source -o build-temp\nnpm run nn\n\nnn build-temp/*\n\n# BUILD CLEAN FINIALIZING\n#  - replace old build in:   build\n#  - with new build from:    build-temp\n#\nmv build __build-old__\nmv build-temp build\nrm -rf ./__build-old__","build-watch":"nodemon -e js,ts,jsx,tsx,caf,coffee,json -w \"source/**\" -x npm run build"},"_npmUser":{"name":"shanebdavis","email":"shanebdavis@gmail.com"},"repository":{"url":"git+https://github.com/art-suite/art-suite-foundations.git","type":"git"},"_npmVersion":"10.9.0","description":"The Standard Library for JavaScript that aught to be.","directories":{},"_nodeVersion":"22.12.0","dependencies":{"caffeine-script-runtime":"^1.14.0","neptune-namespaces-runtime":"^3.2.14"},"_hasShrinkwrap":false,"devDependencies":{"mocha":"^7.2.0","art-testbench":"^3.2.17","art-build-configurator":"^1.30.4","@art-suite/standard-package-builder":"^1.2.7"},"_npmOperationalInternal":{"tmp":"tmp/art-core-terminal-colors_0.1.2_1746786913378_0.43852257456285093","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@art-suite/art-core-terminal-colors","version":"0.1.3","author":{"name":"Shane Brinkman-Davis Delamore"},"license":"ISC","_id":"@art-suite/art-core-terminal-colors@0.1.3","maintainers":[{"name":"shanebdavis","email":"shanebdavis@gmail.com"}],"homepage":"https://github.com/art-suite/art-suite-foundations","bugs":{"url":"https://github.com/art-suite/art-suite-foundations/issues"},"dist":{"shasum":"6f459f9bef13905fe890867215cdc936b2e13bb2","tarball":"https://registry.npmjs.org/@art-suite/art-core-terminal-colors/-/art-core-terminal-colors-0.1.3.tgz","fileCount":18,"integrity":"sha512-QuiTNvjpjqpOKYgRKODyMbDjdXj+vW3SUCAtj2CrGwnknnE7BM7d2ToH/FprmFFRlpqNaKRyA8x6R+Hs86eQHA==","signatures":[{"sig":"MEQCIBSH20sftHwS40DoK97OI+iKtvJJFUIoDLqgCZorBIX8AiA27nut4hz3B7fjouE8QEarumhpGICAO9azruJ/Pt08lA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":14672},"jest":{"verbose":true,"testEnvironment":"node","collectCoverageFrom":["build/**/*.js","!build/test/**/*.js"],"testPathIgnorePatterns":["/node_modules/","<rootDir>/test"],"coveragePathIgnorePatterns":["/index.js$","/namespace.js$"]},"main":"./build","watch":{"build":{"quiet":false,"patterns":["source"],"extensions":["caf","coffee"]}},"exports":{".":{"types":"./index.d.ts","import":"./index.mjs","require":"./build/index.js"}},"gitHead":"a94165479e2a1bce1798e54eabcb679c47599240","scripts":{"nn":"nn build/* ","test":"jest","build":"rsync -av --exclude='*.caf' ./source/ ./build/\ncaf -m -c source -o build\nnpm run nn","clean":"rm -rf build/*","test-watch":"jest --watch","build-clean":"# BUILD CLEAN START\n#   - building into: build-temp\n#\nrm -rf ./__build-old__\nrsync -av --exclude='*.caf' ./source/ ./build-temp/\ncaf -m -c source -o build-temp\nnpm run nn\n\nnn build-temp/*\n\n# BUILD CLEAN FINIALIZING\n#  - replace old build in:   build\n#  - with new build from:    build-temp\n#\nmv build __build-old__\nmv build-temp build\nrm -rf ./__build-old__","build-watch":"nodemon -e js,ts,jsx,tsx,caf,coffee,json -w \"source/**\" -x npm run build"},"_npmUser":{"name":"shanebdavis","email":"shanebdavis@gmail.com"},"repository":{"url":"git+https://github.com/art-suite/art-suite-foundations.git","type":"git"},"_npmVersion":"10.9.0","description":"The Standard Library for JavaScript that aught to be.","directories":{},"_nodeVersion":"22.12.0","dependencies":{"caffeine-script-runtime":"^1.14.0","neptune-namespaces-runtime":"^3.2.14"},"_hasShrinkwrap":false,"devDependencies":{"mocha":"^7.2.0","art-testbench":"^3.2.17","art-build-configurator":"^1.30.4","@art-suite/standard-package-builder":"^1.2.7"},"_npmOperationalInternal":{"tmp":"tmp/art-core-terminal-colors_0.1.3_1746787422175_0.3059622279437335","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"author":{"name":"Shane Brinkman-Davis Delamore"},"bugs":{"url":"https://github.com/art-suite/art-suite-foundations/issues"},"dependencies":{"caffeine-script-runtime":"^1.14.0","neptune-namespaces-runtime":"^3.2.15"},"description":"The Standard Library for JavaScript that aught to be.","devDependencies":{"@art-suite/standard-package-builder":"^1.2.8","art-build-configurator":"^1.30.5","art-testbench":"^3.2.18","mocha":"^7.2.0"},"exports":{".":{"import":"./index.mjs","require":"./build/index.js","types":"./index.d.ts"}},"homepage":"https://github.com/art-suite/art-suite-foundations","jest":{"collectCoverageFrom":["build/**/*.js","!build/test/**/*.js"],"coveragePathIgnorePatterns":["/index.js$","/namespace.js$"],"testEnvironment":"node","testPathIgnorePatterns":["/node_modules/","<rootDir>/test"],"verbose":true},"license":"ISC","main":"./build","name":"@art-suite/art-core-terminal-colors","repository":{"type":"git","url":"git+https://github.com/art-suite/art-suite-foundations.git"},"scripts":{"build":"rsync -av --exclude='*.caf' ./source/ ./build/\ncaf -m -c source -o build\nnpm run nn","build-clean":"# BUILD CLEAN START\n#   - building into: build-temp\n#\nrm -rf ./__build-old__\nrsync -av --exclude='*.caf' ./source/ ./build-temp/\ncaf -m -c source -o build-temp\nnpm run nn\n\nnn build-temp/*\n\n# BUILD CLEAN FINIALIZING\n#  - replace old build in:   build\n#  - with new build from:    build-temp\n#\nmv build __build-old__\nmv build-temp build\nrm -rf ./__build-old__","build-watch":"nodemon -e js,ts,jsx,tsx,caf,coffee,json -w \"source/**\" -x npm run build","clean":"rm -rf build/*","nn":"nn build/* ","test":"jest","test-watch":"jest --watch"},"version":"0.1.4","watch":{"build":{"extensions":["caf","coffee"],"patterns":["source"],"quiet":false}},"gitHead":"3140bf828cabdf379d7c25fc877c26c1608c2409","_id":"@art-suite/art-core-terminal-colors@0.1.4","_nodeVersion":"24.10.0","_npmVersion":"11.6.1","dist":{"integrity":"sha512-jLNN5vM7lQNNTwipbd9Tol3wvu8K/IZfR/xxiQvKB3qewRE1Dt4DDKZMlG7k6o/sfP+f8t/uAeXJ6tDjpobSbA==","shasum":"4ac5a774ee95ecade5bad39f35663e78b670756c","tarball":"https://registry.npmjs.org/@art-suite/art-core-terminal-colors/-/art-core-terminal-colors-0.1.4.tgz","fileCount":18,"unpackedSize":14672,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIBtx5IiAOWQfrYcwoH4zl0JFooqBbLk31VntS+6bGoBhAiAzOd/gdUVM1YUnFWlct+ctreBCp7z03GShWZOfsuwj+Q=="}]},"_npmUser":{"name":"shanebdavis","email":"shanebdavis@gmail.com"},"directories":{},"maintainers":[{"name":"shanebdavis","email":"shanebdavis@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/art-core-terminal-colors_0.1.4_1762507601491_0.43397902932473764"},"_hasShrinkwrap":false}},"time":{"created":"2025-05-08T21:55:56.173Z","modified":"2025-11-07T09:26:42.230Z","0.1.0":"2025-05-08T21:55:56.419Z","0.1.1":"2025-05-09T09:44:24.192Z","0.1.2":"2025-05-09T10:35:13.544Z","0.1.3":"2025-05-09T10:43:42.369Z","0.1.4":"2025-11-07T09:26:41.675Z"},"bugs":{"url":"https://github.com/art-suite/art-suite-foundations/issues"},"author":{"name":"Shane Brinkman-Davis Delamore"},"license":"ISC","homepage":"https://github.com/art-suite/art-suite-foundations","repository":{"type":"git","url":"git+https://github.com/art-suite/art-suite-foundations.git"},"description":"The Standard Library for JavaScript that aught to be.","maintainers":[{"name":"shanebdavis","email":"shanebdavis@gmail.com"}],"readme":"# @art-suite/art-core-terminal-colors\n\nA lightweight and efficient library for adding colors and styles to your terminal/console output using ANSI escape codes. Provides a simple API for common text styling needs.\n\n## Features\n\n- Apply various text styles: bold, dim, italic, underline, inverse, hidden, strikethrough.\n- Set foreground text colors: black, red, green, yellow, blue, magenta, cyan, white, grey, and their bright counterparts.\n- Set background text colors: bgBlack, bgRed, ..., bgWhiteBright.\n- Utilities for working with ANSI codes: `ansiRegex` to match codes, `stripAnsi` to remove them, and `ansiSafeStringLength` to get visual length.\n- Chainable API (typically, color functions return the modified string, often allowing chaining).\n- TypeScript definitions for complete type safety.\n\n## Installation\n\n```bash\nnpm install @art-suite/art-core-terminal-colors\n```\n\n## API Overview\n\nAll styling functions take a string as input and return a new string with the appropriate ANSI escape codes applied.\n\n### ANSI Utilities\n\n- **`ansiRegex: RegExp`**: A regular expression to match ANSI escape codes.\n- **`stripAnsi(str: string): string`**: Removes all ANSI escape codes from a string.\n- **`ansiSafeStringLength(str: string): number`**: Calculates the visual length of a string, ignoring ANSI escape codes.\n\n### Style Modifiers\n\n- **`reset(str: string): string`**: Resets all current styling.\n- **`bold(str: string): string`**: Makes text bold.\n- **`dim(str: string): string`**: Makes text dim (decreased intensity).\n- **`italic(str: string): string`**: Makes text italic.\n- **`underline(str: string): string`**: Underlines text.\n- **`inverse(str: string): string`**: Inverts foreground and background colors.\n- **`hidden(str: string): string`**: Makes text hidden (invisible).\n- **`strikethrough(str: string): string`**: Applies strikethrough to text.\n\n### Foreground Colors\n\n- `black(str: string): string`\n- `red(str: string): string`\n- `green(str: string): string`\n- `yellow(str: string): string`\n- `blue(str: string): string`\n- `magenta(str: string): string`\n- `cyan(str: string): string`\n- `white(str: string): string`\n- `grey(str: string): string` (or `gray`)\n\n#### Bright Foreground Colors\n\n- `redBright(str: string): string`\n- `greenBright(str: string): string`\n- `yellowBright(str: string): string`\n- `blueBright(str: string): string`\n- `magentaBright(str: string): string`\n- `cyanBright(str: string): string`\n- `whiteBright(str: string): string`\n\n### Background Colors\n\n- `bgBlack(str: string): string`\n- `bgRed(str: string): string`\n- `bgGreen(str: string): string`\n- `bgYellow(str: string): string`\n- `bgBlue(str: string): string`\n- `bgMagenta(str: string): string`\n- `bgCyan(str: string): string`\n- `bgWhite(str: string): string`\n- `bgGrey(str: string): string` (or `bgGray`)\n\n#### Bright Background Colors\n\n- `bgRedBright(str: string): string`\n- `bgGreenBright(str: string): string`\n- `bgYellowBright(str: string): string`\n- `bgBlueBright(str: string): string`\n- `bgMagentaBright(str: string): string`\n- `bgCyanBright(str: string): string`\n- `bgWhiteBright(str: string): string`\n\n## Examples\n\n```typescript\nimport {\n  red,\n  bold,\n  bgYellow,\n  italic,\n  stripAnsi,\n  ansiSafeStringLength,\n} from \"@art-suite/art-core-terminal-colors\";\n\nconst greeting = \"Hello, World!\";\n\n// Simple coloring\nconsole.log(red(greeting));\n\n// Chained styling (assuming functions can be chained or nested)\n// Example: bold(red(greeting)) or specific chaining API if provided\nconsole.log(bold(red(\"This is bold red text!\")));\nconsole.log(italic(bgYellow(blue(\"Blue text on yellow, italicized.\"))));\n\n// ANSI Utilities\nconst coloredText = red(bold(\"Important Message\"));\nconsole.log(coloredText); // Shows colored text\nconsole.log(stripAnsi(coloredText)); // \"Important Message\"\nconsole.log(ansiSafeStringLength(coloredText)); // 17 (length of \"Important Message\")\nconsole.log(coloredText.length); // Actual string length including ANSI codes (much longer)\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}