haze-ui 1.22.0 → 1.23.0

package/dist/types/tokens/oklch.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Pure OKLCH / OKLab color math. Zero dependencies.
+ *
+ * Conversion matrices and transfer functions follow Björn Ottosson's OKLab
+ * reference implementation (https://bottosson.github.io/posts/oklab/):
+ * sRGB gamma encode/decode, the linear-RGB→LMS matrix, the cube/cbrt
+ * non-linearity, and the LMS'→OKLab matrix (plus its inverse).
+ */
+export type Oklch = {
+    l: number;
+    c: number;
+    h: number;
+    alpha?: number;
+};
+/**
+ * Reduce chroma until the color fits the sRGB gamut, preserving lightness and
+ * hue exactly (unlike an 8-bit hex round-trip, which quantizes all channels).
+ */
+export declare function clampChroma(color: Oklch): Oklch;
+/** Parse `#rgb`, `#rgba`, `#rrggbb` or `#rrggbbaa` into OKLCH. */
+export declare function parseHex(hex: string): Oklch;
+/**
+ * Parse an `oklch(l c h)` or `oklch(l c h / a)` string. Lightness/chroma may
+ * be given as percentages (`62.8%`), hue as degrees (`30deg`); the `none`
+ * keyword is accepted for any channel.
+ */
+export declare function parseOklch(input: string): Oklch;
+/** Convert OKLCH to an sRGB hex string, gamut-clamped via chroma reduction. */
+export declare function oklchToHex(color: Oklch): string;
+/** Format as a CSS `oklch()` string: l/c to 3 decimals, h to 1 decimal. */
+export declare function formatOklch(color: Oklch): string;
+/** WCAG 2.x contrast ratio via sRGB relative luminance. */
+export declare function wcagContrast(a: Oklch, b: Oklch): number;
+/** Perceptual distance: Euclidean distance in OKLab space. */
+export declare function deltaE(a: Oklch, b: Oklch): number;

package/dist/types/tokens/palette.d.ts

@@ -0,0 +1,28 @@
+/**
+ * OKLCH-derived color palette — the single source of truth for haze-ui color
+ * tokens.
+ *
+ * Primitive 12-step scales are seeded from the hex values of the previous
+ * hand-tuned token system, so every semantic base color lands within ΔE ≤ 1.0
+ * of its predecessor. Semantic tokens alias primitive steps; interaction
+ * states (hover / active / subtle / focus-ring / border-hover) are emitted as
+ * CSS relative-color formulas so consumer overrides of a base color propagate
+ * to its derived states at runtime.
+ */
+import type { Oklch } from './oklch';
+export type Mode = 'light' | 'dark';
+export type Family = 'gray' | 'blue' | 'green' | 'amber' | 'red';
+export type PrimitiveScales = Record<Mode, Record<Family, readonly string[]>>;
+export type SemanticColorToken = {
+    /** CSS custom property name, e.g. '--haze-color-primary'. */
+    name: string;
+    /** Human-readable label for the docs registry. */
+    label: string;
+    /** Emitted CSS value per mode: a primitive alias or a relative-color formula. */
+    css: Record<Mode, string>;
+    /** Concrete computed value per mode (formula math applied to the aliased base). */
+    resolved: Record<Mode, Oklch>;
+};
+declare const PRIMITIVES: PrimitiveScales;
+declare const SEMANTIC_COLOR_TOKENS: readonly SemanticColorToken[];
+export { PRIMITIVES, SEMANTIC_COLOR_TOKENS };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "haze-ui",
-  "version": "1.22.0",
+  "version": "1.23.0",
   "type": "module",
   "description": "A React UI component library powered by react-use-control and Linaria",
   "main": "./dist/index.js",
@@ -89,6 +89,7 @@
     "@testing-library/jest-dom": "^7.0.1",
     "@testing-library/react": "^16.3.3",
     "@testing-library/user-event": "^14.6.6",
+    "@types/culori": "^4.0.1",
     "@types/jest-axe": "^3.5.9",
     "@types/node": "^26.4.0",
     "@types/ramda": "^0.32.0",
@@ -102,6 +103,7 @@
     "babel-plugin-transform-jsx-condition": "^0.1.3",
     "commitizen": "^4.3.2",
     "core-js": "^3.50.0",
+    "culori": "^4.0.2",
     "date-fns": "^4.4.0",
     "eslint": "^10.9.1",
     "eslint-plugin-compat": "^7.0.2",