color-name-list 13.13.1 → 13.15.0

package/docs/usage-csharp.md

@@ -0,0 +1,38 @@
+# C# Usage
+
+C# support is provided by
+[vycdev/ColorNamesSharp](https://github.com/vycdev/ColorNamesSharp).
+The library is available as a
+[NuGet package](https://www.nuget.org/packages/ColorNamesSharp).
+
+## Creating the instance
+
+```csharp
+ColorNames colorNames = new ColorNamesBuilder()
+  .Add("Best Blue", "#3299fe") // Add your own custom colors
+  .LoadDefault() // Load the default color list
+  .AddFromCsv("path/to/your/colorlist.csv") // Add a custom color list from a csv file
+  .Build(); // Get a new ColorNames instance that includes all the colors you've added
+```
+
+## Getting a fitting color name
+
+```csharp
+NamedColor customNamedColor = new("Custom Named Color", 50, 153, 254);
+
+// You can directly get the name of the color as a string
+string colorNameFromHex = colorNames.FindClosestColorName("#facfea"); // Classic Rose
+string colorNameFromRgb = colorNames.FindClosestColorName(224, 224, 255); // Stoic White
+string colorNameFromNamedColor = colorNames.FindClosestColorName(customNamedColor); // Best Blue
+
+// Or similarly you can get the NamedColor object
+NamedColor namedColorFromHex = colorNames.FindClosestColorName("#facfea"); // Classic Rose
+NamedColor namedColorFromRgb = colorNames.FindClosestColorName(224, 224, 255); // Stoic White
+NamedColor namedColorFromNamedColor = colorNames.FindClosestColorName(customNamedColor); // Best Blue
+
+// Or a random color
+NamedColor randomColor = colorNames.GetRandomNamedColor();
+```
+
+See the upstream project for more details and updates:
+[vycdev/ColorNamesSharp](https://github.com/vycdev/ColorNamesSharp)

package/docs/usage-java-kotlin.md

@@ -0,0 +1,58 @@
+# Java / Kotlin Usage
+
+Java/Kotlin support is provided by
+[UwUAroze/Color-Names](https://github.com/UwUAroze/Color-Names).
+
+## Gradle (Kotlin DSL)
+
+```kts
+repositories {
+  maven("https://jitpack.io")
+}
+
+dependencies {
+  implementation("me.aroze:color-names:1.0.4")
+}
+```
+
+## Maven
+
+```xml
+<repository>
+  <id>jitpack.io</id>
+  <url>https://jitpack.io</url>
+</repository>
+
+<dependency>
+  <groupId>me.aroze</groupId>
+  <artifactId>color-names</artifactId>
+  <version>1.0.4</version>
+</dependency>
+```
+
+## Closest Named Color (Java)
+
+```java
+public ColorNames colorNames = new ColorNameBuilder()
+  .loadDefaults()
+  .build();
+
+String fromHex = colorNames.getName("#facfea"); // "Classic Rose"
+String fromRGB = colorNames.getName(224, 224, 255); // "Stoic White"
+String fromColor = colorNames.getName(new Color(255, 219, 240)); // "Silky Pink"
+```
+
+## Closest Named Color (Kotlin)
+
+```kt
+val colorNames = ColorNameBuilder()
+  .loadDefaults()
+  .build()
+
+val fromHex = colorNames.getName("#facfea") // "Classic Rose"
+val fromRGB = colorNames.getName(224, 224, 255) // "Stoic White"
+val fromColor = colorNames.getName(Color(255, 219, 240)) // "Silky Pink"
+```
+
+See the upstream project for more details and updates:
+[UwUAroze/Color-Names](https://github.com/UwUAroze/Color-Names)

package/docs/usage-js.md

@@ -0,0 +1,81 @@
+# JavaScript / TypeScript Usage
+
+This guide shows how to use the color list from JavaScript and
+TypeScript projects. It covers ESM and CommonJS usage and finding the
+closest named color.
+
+## Install
+
+```sh
+npm install color-name-list
+```
+
+## Data Shape
+
+```ts
+type ColorName = { name: string; hex: string };
+```
+
+## ESM (Node/Browser Bundlers)
+
+```js
+import { colornames } from 'color-name-list';
+
+const white = colornames.find((c) => c.hex === '#ffffff');
+console.log(white.name); // => white
+
+const eigengrau = colornames.find((c) => c.name === 'Eigengrau');
+console.log(eigengrau?.hex); // => #16161d
+```
+
+## CommonJS (require)
+
+```js
+// When required, the package returns the array of color objects directly
+const colornames = require('color-name-list');
+
+const white = colornames.find((c) => c.hex === '#ffffff');
+console.log(white.name); // => white
+```
+
+## Find the Closest Named Color
+
+With 16,777,216 possible RGB colors, you may want to use a helper like
+`nearest-color` or `ClosestVector`.
+
+```js
+import nearestColor from 'nearest-color';
+import { colornames } from 'color-name-list';
+
+// nearestColor expects an object { name => hex }
+const colors = colornames.reduce((o, { name, hex }) => Object.assign(o, { [name]: hex }), {});
+const nearest = nearestColor.from(colors);
+
+// Get closest named color
+nearest('#f1c1d1'); // => Fairy Tale
+```
+
+Note: For better visual accuracy, consider DeltaE or using CIECAM02
+instead of raw RGB distance:
+
+- [DeltaE](https://github.com/zschuessler/DeltaE)
+- [CIECAM02](https://github.com/baskerville/ciecam02)
+
+## Subsets and Performance Tips
+
+- Best-of subset (smaller list):
+  - ESM: `import { colornames as bestof } from 'color-name-list/bestof'`
+  - UMD: `https://unpkg.com/color-name-list/dist/colornames.bestof.umd.js`
+- Short subset (< 13 characters, best-of filtered): `dist/colornames.short.*`
+- For browsers, prefer the public API for payload-sensitive scenarios:
+  [Color Name API](https://github.com/meodai/color-name-api)
+
+## CDN (Reproducible)
+
+- Latest: `https://unpkg.com/color-name-list/dist/colornames.min.json`
+- Pinned: `https://unpkg.com/color-name-list@<version>/dist/colornames.min.json`
+
+## Types
+
+The package ships ESM. For TypeScript projects, you can declare the data
+shape as shown above or infer it directly from usage.

package/docs/usage-rust.md

@@ -0,0 +1,51 @@
+# Rust Usage
+
+Rust support is provided by
+[philocalyst/color-names](https://github.com/philocalyst/color-names).
+Add it with:
+
+```sh
+cargo add colorsnamed
+```
+
+## Choosing colors
+
+```rust
+use colorsnamed;
+
+let black = colorsnamed::Basic::Black;
+let teal = colorsnamed::Basic::Teal;
+let another = colorsnamed::Xkcd::Tea;
+```
+
+## Getting colors
+
+```rust
+use colorsnamed;
+
+// Get the relevant hex code
+let red = colorsnamed::Basic::Red;
+let hex = red.hex();
+
+// Figure out if there is a matching color for a hex code!
+let ex: colorsnamed::Basic = hex.try_into().unwrap();
+```
+
+## Converting colors
+
+```rust
+use colorsnamed;
+use colors;
+use rgb::Rgb;
+
+// Convert to the representation of your colorspace of choice.
+let correct_color = red.color::<colors::Srgb>();
+
+let red = colorsnamed::Basic::Red;
+
+// Get the RGB representation
+let rgb: Rgb = red.rgb();
+```
+
+See the upstream project for more details and updates:
+[philocalyst/color-names](https://github.com/philocalyst/color-names)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "color-name-list",
-  "version": "13.13.1",
+  "version": "13.15.0",
   "description": "long list of color names",
   "main": "dist/colornames.json",
   "browser": "dist/colornames.umd.js",

package/src/colornames.csv

@@ -9239,6 +9239,7 @@ Fall Mood,#c2ac9b,
 Fall River,#f59344,
 Fall Straw,#fee3c5,
 Fallen Blossoms,#edb2c4,x
+Fallen Canopy,#b85824,x
 Fallen Leaves,#917347,
 Fallen Petals,#f2e0da,x
 Fallen Rock,#8b8072,
@@ -15752,7 +15753,7 @@ Magic Spell,#544f66,
 Magic Wand,#c3d9e4,
 Magic Whale,#17034a,
 Magical,#c1ceda,
-Magical Malachite,#22cc88,
+Magical Malachite,#22cc88,x
 Magical Mauve,#baa3a9,
 Magical Melon,#e9e9d0,
 Magical Merlin,#3d8ed0,x
@@ -16383,6 +16384,7 @@ Mellow Flower,#f1dfe9,
 Mellow Glow,#ffcfad,
 Mellow Green,#d5d593,
 Mellow Mango,#cc4400,x
+Mellow Marrow,#e8c2b4,x
 Mellow Mauve,#9c6579,
 Mellow Melon,#ee2266,x
 Mellow Mint,#ddedbd,x