{"_id":"@aryams/colorname-js","name":"@aryams/colorname-js","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@aryams/colorname-js","version":"1.0.0","description":"Give any HEX, RGB, or HSL color a human name — with family, shade, mood, and closest CSS color","main":"./dist/color-namer.umd.js","module":"./dist/color-namer.es.js","exports":{".":{"import":"./dist/color-namer.es.js","require":"./dist/color-namer.umd.js"}},"scripts":{"dev":"vite","build":"vite build","prepublishOnly":"npm run build"},"keywords":["color","colour","namer","hex","rgb","hsl","palette","design"],"author":{"name":"Arya M S","email":"ssevikamanas@gmail.com"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/ssevi/color-namer.git"},"devDependencies":{"vite":"^5.0.0"},"_id":"@aryams/colorname-js@1.0.0","bugs":{"url":"https://github.com/ssevi/color-namer/issues"},"homepage":"https://github.com/ssevi/color-namer#readme","_nodeVersion":"24.9.0","_npmVersion":"11.6.0","dist":{"integrity":"sha512-TTqNHv9jIVpBcflaIbOKGm4x66j5QVRp7gVWi2xwYSUtwRUDwal7PrJ+tf5/pqHWG3WzTZmmeVB8wUUvNGyTpQ==","shasum":"dac89440af759bb50d075f50bfa16e12407c1c07","tarball":"https://registry.npmjs.org/@aryams/colorname-js/-/colorname-js-1.0.0.tgz","fileCount":4,"unpackedSize":27849,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIEDHvfjZMXSqC1no0auMIb6WwrwxyjPGE4+i77XI0QybAiBa8r/ZxF/n8gKsNCEaKB8R0a3xesVFbO95W8wYdTXrFQ=="}]},"_npmUser":{"name":"aryams","email":"ssevikamanas@gmail.com"},"directories":{},"maintainers":[{"name":"aryams","email":"ssevikamanas@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/colorname-js_1.0.0_1772388906519_0.9565486095743336"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-01T18:15:06.435Z","1.0.0":"2026-03-01T18:15:06.661Z","modified":"2026-03-01T18:15:06.869Z"},"maintainers":[{"name":"aryams","email":"ssevikamanas@gmail.com"}],"description":"Give any HEX, RGB, or HSL color a human name — with family, shade, mood, and closest CSS color","homepage":"https://github.com/ssevi/color-namer#readme","keywords":["color","colour","namer","hex","rgb","hsl","palette","design"],"repository":{"type":"git","url":"git+https://github.com/ssevi/color-namer.git"},"author":{"name":"Arya M S","email":"ssevikamanas@gmail.com"},"bugs":{"url":"https://github.com/ssevi/color-namer/issues"},"license":"MIT","readme":"# color-namer\n\nGive any HEX, RGB, or HSL color a human name. Returns the color name, family, shade, mood tags, and closest CSS color — zero dependencies.\n\n---\n\n## Installation\n\n```bash\nnpm install color-namer\n```\n\n---\n\n## Usage\n\n```js\nimport { ColorNamer } from 'color-namer';\n\nconst namer = new ColorNamer();\n\nnamer.name('#FF5733');\nnamer.name('rgb(255, 87, 51)');\nnamer.name('hsl(14, 100%, 60%)');\n```\n\n### Result\n\n```js\n{\n  name:    'Tomato Red',\n  family:  'Red',\n  shade:   'vivid',\n  moods:   ['passionate', 'warm', 'energetic'],\n  css:     'orangered',\n  hex:     '#ff5733',\n  rgb:     { r: 255, g: 87, b: 51 },\n  hsl:     { h: 14, s: 100, l: 60 },\n  closest: {\n    curated: { name: 'Tomato Red',  hex: '#FF6347', distance: 12 },\n    css:     { name: 'orangered',   hex: '#FF4500', distance: 18 },\n  }\n}\n```\n\n---\n\n## API\n\n### `namer.name(input)` → ColorResult\nName a single color.\n\n### `namer.nameAll(inputs[])` → ColorResult[]\nName multiple colors at once.\n\n### `namer.palette(family)` → { name, hex }[]\nGet all curated colors in a family.\n```js\nnamer.palette('Blue')  // → [{ name: 'Sky Blue', hex: '#87CEEB' }, ...]\n```\n\n### `namer.byMood(mood)` → { name, hex, moods }[]\nGet colors matching a mood tag.\n```js\nnamer.byMood('calm')       // → soft blues, grays\nnamer.byMood('energetic')  // → vivid reds, oranges\n```\n\n### `namer.isSimilar(colorA, colorB, threshold?)` → boolean\nCheck if two colors are visually similar.\n```js\nnamer.isSimilar('#FF0000', '#FF1111')        // → true\nnamer.isSimilar('#FF0000', '#0000FF')        // → false\nnamer.isSimilar('#FF0000', '#FF3333', 50)    // custom threshold\n```\n\n---\n\n## Utilities (tree-shakeable)\n\n```js\nimport { getFamily, getShade, getMood, rgbToHsl, parseColor } from 'color-namer';\n```\n\n---\n\n## Color Families\nRed · Orange · Yellow · Yellow-Green · Green · Teal · Cyan · Blue · Indigo · Violet · Pink · Rose · Gray · White · Black\n\n## Mood Tags\ncalm · neutral · energetic · vibrant · warm · passionate · creative · natural · fresh · balanced · trustworthy · serene · imaginative · luxurious · romantic · airy · mysterious · cheerful\n\n---\n\n## License\nMIT\n","readmeFilename":"README.md","_rev":"1-574658c35c9c08db6c8373f8f6737291"}