chromonym 1.4.1 → 3.0.0

package/NOTICE.md

@@ -6,7 +6,7 @@
 **not affiliated with, endorsed by, licensed by, or certified by Pantone
 LLC**.
 
-The `pantone` colorspace in this library ships **community-derived sRGB
+The `pantone` palette in this library ships **community-derived sRGB
 approximations** of the Pantone Coated (C) color set, sourced from
 [`color_library`](https://github.com/draganradu/color_library) (MIT © Radu
 Dragan). These values:
@@ -16,21 +16,81 @@ Dragan). These values:
   exactly.
 - Are intended for on-screen reference, nearest-name identification, and
   general tooling — **not for print color specification**.
-- Use standard color codes (e.g. `185C`) as **nominative references** to
+- Use standard color codes (e.g. `185 C`) as **nominative references** to
   publicly identified Pantone colors. No endorsement or claim of accuracy
   is implied.
 
+### Accuracy envelope
+
+The approximations are closest for mid-chroma colors under a D65 / 2°
+observer. As a rough guide:
+
+- **Mid-chroma Pantones**: ΔE*00 ≲ 5 versus Pantone's own sRGB previews.
+  Usable for nearest-name identification and comparative swatch UI.
+- **Saturated edges**: ΔE*00 commonly 5–10, higher in the deep-blue and
+  blue-violet region (~2736 C through ~2746 C). `identify` will still
+  converge on a plausible neighbor, but the *which* can depend on metric
+  choice — see the "Distance metrics" section of the README.
+- **Fluorescents (801 C – 814 C)** and the **metallic series (8xxx C)**
+  are defined outside the sRGB gamut. Their sRGB approximations are
+  perceptually wrong by construction — the physical inks can't be
+  reproduced on a standard monitor. Do not use these values as a
+  reference for brand-critical matching; identify carefully or skip.
+- **Neons / warm reds** clipping against the sRGB gamut boundary (Pantone
+  Red 032 / Warm Red / Red 021 area) are approximated via hard clip.
+
+### What `identify` does *not* guarantee
+
+`identify(sampledRgba, { palette: pantone })` returns the nearest
+entry **in the shipped sRGB approximation set**. It does **not** imply
+that the physical ink bearing that Pantone code would match your sampled
+color in a print workflow, under a different light source, or on
+different paper stock. Pantone is a spectral specification; any
+color-library lookup that rounds it through sRGB loses information.
+
 If you need Pantone-certified color values, consult Pantone directly:
 <https://www.pantone.com/>.
 
+## Crayola®
+
+**Crayola®** is a registered trademark of **Crayola LLC**. Chromonym is
+**not affiliated with, endorsed by, licensed by, or certified by Crayola
+LLC**.
+
+The `crayola` palette in this library ships a **community-curated
+subset** of Crayola crayon-color names with sRGB approximations of their
+wrappers. The names are used as **nominative references** to publicly
+identified Crayola colors — there is no trademark claim, and no
+endorsement is implied. Hex values are derived from the widely-cited
+Wikipedia list of Crayola crayon colors (CC BY-SA), which itself cites
+Crayola's published approximations.
+
+### Scope
+
+The shipped set is ~85 entries — the current 64-standard box, the
+iconic fluorescent "Neon" range, and widely-recognized modern
+additions. It is not exhaustive: historical, retired, specialty-box
+(Gem Tones, Heads 'N Tails, Multicultural, etc.), and regional-variant
+colors are not included. If you need a specific Crayola color that
+isn't present, open an issue or define a BYO palette.
+
+### Accuracy
+
+- Fluorescents and neons saturate outside sRGB by design; on-screen
+  sRGB approximations are necessarily softer than the physical crayons.
+- Metallics (Silver, Gold, Copper) are flat sRGB approximations; the
+  physical crayons' reflective behavior is lost.
+- Classic hues are close enough for comparative UI / identification
+  work but should not be used as a reference for print color matching.
+
 ## X11 / X.Org
 
-The `x11` colorspace is derived from the X.Org `rgb.txt` file, which is in
+The `x11` palette is derived from the X.Org `rgb.txt` file, which is in
 the public domain.
 
 ## CSS / SVG named colors
 
-The `web` colorspace mirrors the CSS Color Module Level 4 named-color
+The `web` palette mirrors the CSS Color Module Level 4 named-color
 set, which is a public specification.
 
 ## Upstream dependencies