Initial Commit

packages/media/image/colour-convert-cieluv/README.md

@@ -0,0 +1,32 @@
+# @suaveplan/colour-convert-cieluv - CIELUV, xyY, LMS, and Bradford chromatic adaptation for professional colour workflows
+
+CIELUV, xyY, LMS, and Bradford chromatic adaptation conversions. This plugin provides colour-space transforms between RGB, CIELUV, xyY, and LMS cone-response space, including Bradford adaptation across 11 standard illuminants (A, B, C, D50/55/65/75, E, F2/F7/F11).
+
+<!-- begin:auto-docs -->
+## Documentation tree
+
+- [colour-convert-cieluv](./src/colour-convert-cieluv/colour-convert-cieluv.md) — `colour-convert-cieluv.ts` extends the CIE colour family with CIELUV, xyY chromaticity, LMS cone response, and Bradford…
+  - [colour-convert-cieluv](./src/colour-convert-cieluv/colour-convert-cieluv.md) — `colour-convert-cieluv.ts` extends the CIE colour family with CIELUV, xyY chromaticity, LMS cone response, and Bradford…
+<!-- end:auto-docs -->
+
+## Installation
+
+```bash
+bun add @suaveplan/colour-convert-cieluv
+```
+
+## Quick Start
+
+```ts
+import { rgbToLuv, bradfordAdapt } from "@suaveplan/colour-convert-cieluv";
+
+const luv = rgbToLuv({ r: 128, g: 64, b: 32 });
+console.log(luv); // { l: ~32.9, u: ~40.6, v: ~37.8 }
+
+const d50 = bradfordAdapt({ x: 50, y: 50, z: 50 }, "D65", "D50");
+console.log(d50); // { x: ~52.9, y: ~50, z: ~37.7 }
+```
+
+## Modules
+
+- [`src/colour-convert-cieluv/colour-convert-cieluv.md`](./src/colour-convert-cieluv/colour-convert-cieluv.md) — CIELUV, xyY, LMS, and Bradford adaptation implementation