@bobfrankston/colorlib 0.1.0

package/convert.d.ts

@@ -0,0 +1,26 @@
+import { RGB, HSL, HSB, HSBK, HSBK16 } from './types.js';
+/** RGB to HSL */
+export declare function rgbToHsl(rgb: RGB): HSL;
+/** HSL to RGB */
+export declare function hslToRgb(hsl: HSL): RGB;
+/** RGB to HSB (HSV) */
+export declare function rgbToHsb(rgb: RGB): HSB;
+/** HSB (HSV) to RGB */
+export declare function hsbToRgb(hsb: HSB): RGB;
+/** HSL to HSB */
+export declare function hslToHsb(hsl: HSL): HSB;
+/** HSB to HSL */
+export declare function hsbToHsl(hsb: HSB): HSL;
+/** HSB to HSBK with optional kelvin */
+export declare function hsbToHsbk(hsb: HSB, kelvin?: number): HSBK;
+/** RGB to HSBK */
+export declare function rgbToHsbk(rgb: RGB, kelvin?: number): HSBK;
+/** HSL to HSBK */
+export declare function hslToHsbk(hsl: HSL, kelvin?: number): HSBK;
+/** Approximate RGB for a color temperature (for white light preview) */
+export declare function kelvinToRgb(kelvin: number): RGB;
+/** HSBK to 16-bit scaled format */
+export declare function hsbkTo16(hsbk: HSBK): HSBK16;
+/** 16-bit scaled format to HSBK */
+export declare function hsbk16ToHsbk(hsbk16: HSBK16): HSBK;
+//# sourceMappingURL=convert.d.ts.map

package/convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["convert.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAWzD,iBAAiB;AACjB,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAGtC;AAED,iBAAiB;AACjB,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAGtC;AAED,uBAAuB;AACvB,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAGtC;AAED,uBAAuB;AACvB,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAGtC;AAED,iBAAiB;AACjB,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAGtC;AAED,iBAAiB;AACjB,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAGtC;AAED,uCAAuC;AACvC,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,GAAE,MAAuB,GAAG,IAAI,CAOzE;AAED,kBAAkB;AAClB,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,GAAE,MAAuB,GAAG,IAAI,CAGzE;AAED,kBAAkB;AAClB,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,GAAE,MAAuB,GAAG,IAAI,CAGzE;AAED,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAmB/C;AAED,mCAAmC;AACnC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAO3C;AAED,mCAAmC;AACnC,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAOjD"}

package/convert.js

@@ -0,0 +1,96 @@
+import convert from 'color-convert';
+const DEFAULT_KELVIN = 3500;
+const MIN_KELVIN = 1500;
+const MAX_KELVIN = 9000;
+/** Clamp value to range */
+function clamp(v, min, max) {
+    return Math.max(min, Math.min(max, v));
+}
+/** RGB to HSL */
+export function rgbToHsl(rgb) {
+    const [h, s, l] = convert.rgb.hsl([rgb.r, rgb.g, rgb.b]);
+    return { h, s, l };
+}
+/** HSL to RGB */
+export function hslToRgb(hsl) {
+    const [r, g, b] = convert.hsl.rgb([hsl.h, hsl.s, hsl.l]);
+    return { r, g, b };
+}
+/** RGB to HSB (HSV) */
+export function rgbToHsb(rgb) {
+    const [h, s, v] = convert.rgb.hsv([rgb.r, rgb.g, rgb.b]);
+    return { h, s, b: v };
+}
+/** HSB (HSV) to RGB */
+export function hsbToRgb(hsb) {
+    const [r, g, b] = convert.hsv.rgb([hsb.h, hsb.s, hsb.b]);
+    return { r, g, b };
+}
+/** HSL to HSB */
+export function hslToHsb(hsl) {
+    const rgb = hslToRgb(hsl);
+    return rgbToHsb(rgb);
+}
+/** HSB to HSL */
+export function hsbToHsl(hsb) {
+    const rgb = hsbToRgb(hsb);
+    return rgbToHsl(rgb);
+}
+/** HSB to HSBK with optional kelvin */
+export function hsbToHsbk(hsb, kelvin = DEFAULT_KELVIN) {
+    return {
+        h: hsb.h,
+        s: hsb.s,
+        b: hsb.b,
+        k: clamp(kelvin, MIN_KELVIN, MAX_KELVIN)
+    };
+}
+/** RGB to HSBK */
+export function rgbToHsbk(rgb, kelvin = DEFAULT_KELVIN) {
+    const hsb = rgbToHsb(rgb);
+    return hsbToHsbk(hsb, kelvin);
+}
+/** HSL to HSBK */
+export function hslToHsbk(hsl, kelvin = DEFAULT_KELVIN) {
+    const hsb = hslToHsb(hsl);
+    return hsbToHsbk(hsb, kelvin);
+}
+/** Approximate RGB for a color temperature (for white light preview) */
+export function kelvinToRgb(kelvin) {
+    const k = clamp(kelvin, 1000, 40000) / 100;
+    let r, g, b;
+    if (k <= 66) {
+        r = 255;
+        g = 99.4708025861 * Math.log(k) - 161.1195681661;
+        b = k <= 19 ? 0 : 138.5177312231 * Math.log(k - 10) - 305.0447927307;
+    }
+    else {
+        r = 329.698727446 * Math.pow(k - 60, -0.1332047592);
+        g = 288.1221695283 * Math.pow(k - 60, -0.0755148492);
+        b = 255;
+    }
+    return {
+        r: Math.round(clamp(r, 0, 255)),
+        g: Math.round(clamp(g, 0, 255)),
+        b: Math.round(clamp(b, 0, 255))
+    };
+}
+/** HSBK to 16-bit scaled format */
+export function hsbkTo16(hsbk) {
+    return {
+        h: Math.round((hsbk.h / 360) * 0xFFFF),
+        s: Math.round((hsbk.s / 100) * 0xFFFF),
+        b: Math.round((hsbk.b / 100) * 0xFFFF),
+        k: clamp(Math.round(hsbk.k), MIN_KELVIN, MAX_KELVIN)
+    };
+}
+/** 16-bit scaled format to HSBK */
+export function hsbk16ToHsbk(hsbk16) {
+    return {
+        h: (hsbk16.h / 0xFFFF) * 360,
+        s: (hsbk16.s / 0xFFFF) * 100,
+        b: (hsbk16.b / 0xFFFF) * 100,
+        k: hsbk16.k
+    };
+}
+//# sourceMappingURL=convert.js.map

package/convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["convert.ts"],"names":[],"mappings":"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"}

package/convert.ts

@@ -0,0 +1,111 @@
+import convert from 'color-convert';
+import { RGB, HSL, HSB, HSBK, HSBK16 } from './types.js';
+
+const DEFAULT_KELVIN = 3500;
+const MIN_KELVIN = 1500;
+const MAX_KELVIN = 9000;
+
+/** Clamp value to range */
+function clamp(v: number, min: number, max: number): number {
+    return Math.max(min, Math.min(max, v));
+}
+
+/** RGB to HSL */
+export function rgbToHsl(rgb: RGB): HSL {
+    const [h, s, l] = convert.rgb.hsl([rgb.r, rgb.g, rgb.b]);
+    return { h, s, l };
+}
+
+/** HSL to RGB */
+export function hslToRgb(hsl: HSL): RGB {
+    const [r, g, b] = convert.hsl.rgb([hsl.h, hsl.s, hsl.l]);
+    return { r, g, b };
+}
+
+/** RGB to HSB (HSV) */
+export function rgbToHsb(rgb: RGB): HSB {
+    const [h, s, v] = convert.rgb.hsv([rgb.r, rgb.g, rgb.b]);
+    return { h, s, b: v };
+}
+
+/** HSB (HSV) to RGB */
+export function hsbToRgb(hsb: HSB): RGB {
+    const [r, g, b] = convert.hsv.rgb([hsb.h, hsb.s, hsb.b]);
+    return { r, g, b };
+}
+
+/** HSL to HSB */
+export function hslToHsb(hsl: HSL): HSB {
+    const rgb = hslToRgb(hsl);
+    return rgbToHsb(rgb);
+}
+
+/** HSB to HSL */
+export function hsbToHsl(hsb: HSB): HSL {
+    const rgb = hsbToRgb(hsb);
+    return rgbToHsl(rgb);
+}
+
+/** HSB to HSBK with optional kelvin */
+export function hsbToHsbk(hsb: HSB, kelvin: number = DEFAULT_KELVIN): HSBK {
+    return {
+        h: hsb.h,
+        s: hsb.s,
+        b: hsb.b,
+        k: clamp(kelvin, MIN_KELVIN, MAX_KELVIN)
+    };
+}
+
+/** RGB to HSBK */
+export function rgbToHsbk(rgb: RGB, kelvin: number = DEFAULT_KELVIN): HSBK {
+    const hsb = rgbToHsb(rgb);
+    return hsbToHsbk(hsb, kelvin);
+}
+
+/** HSL to HSBK */
+export function hslToHsbk(hsl: HSL, kelvin: number = DEFAULT_KELVIN): HSBK {
+    const hsb = hslToHsb(hsl);
+    return hsbToHsbk(hsb, kelvin);
+}
+
+/** Approximate RGB for a color temperature (for white light preview) */
+export function kelvinToRgb(kelvin: number): RGB {
+    const k = clamp(kelvin, 1000, 40000) / 100;
+    let r: number, g: number, b: number;
+
+    if (k <= 66) {
+        r = 255;
+        g = 99.4708025861 * Math.log(k) - 161.1195681661;
+        b = k <= 19 ? 0 : 138.5177312231 * Math.log(k - 10) - 305.0447927307;
+    } else {
+        r = 329.698727446 * Math.pow(k - 60, -0.1332047592);
+        g = 288.1221695283 * Math.pow(k - 60, -0.0755148492);
+        b = 255;
+    }
+
+    return {
+        r: Math.round(clamp(r, 0, 255)),
+        g: Math.round(clamp(g, 0, 255)),
+        b: Math.round(clamp(b, 0, 255))
+    };
+}
+
+/** HSBK to 16-bit scaled format */
+export function hsbkTo16(hsbk: HSBK): HSBK16 {
+    return {
+        h: Math.round((hsbk.h / 360) * 0xFFFF),
+        s: Math.round((hsbk.s / 100) * 0xFFFF),
+        b: Math.round((hsbk.b / 100) * 0xFFFF),
+        k: clamp(Math.round(hsbk.k), MIN_KELVIN, MAX_KELVIN)
+    };
+}
+
+/** 16-bit scaled format to HSBK */
+export function hsbk16ToHsbk(hsbk16: HSBK16): HSBK {
+    return {
+        h: (hsbk16.h / 0xFFFF) * 360,
+        s: (hsbk16.s / 0xFFFF) * 100,
+        b: (hsbk16.b / 0xFFFF) * 100,
+        k: hsbk16.k
+    };
+}

package/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types.js';
+export * from './convert.js';
+export { parseColor } from './parse.js';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/index.js

@@ -0,0 +1,4 @@
+export * from './types.js';
+export * from './convert.js';
+export { parseColor } from './parse.js';
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/index.ts

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './convert.js';
+export { parseColor } from './parse.js';

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@bobfrankston/colorlib",
+  "version": "0.1.0",
+  "description": "Color conversion library for RGB, HSL, HSB, HSBK and Kelvin",
+  "type": "module",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc -w"
+  },
+  "keywords": ["color", "hsl", "hsb", "rgb", "kelvin"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/BobFrankston/colorlib.git"
+  },
+  "dependencies": {
+    "color-convert": "^2.0.1"
+  },
+  "devDependencies": {
+    "@types/color-convert": "^2.0.4",
+    "@types/node": "latest"
+  }
+}

package/parse.d.ts

@@ -0,0 +1,13 @@
+import { HSBK, ColorInput } from './types.js';
+/**
+ * Parse flexible color input to HSBK
+ * Auto-detects type from input:
+ * - string: "#ff0000", "rgb(255,0,0)", "hsl(0,100%,50%)", "red"
+ * - number: Kelvin temperature (1500-9000) -> white at that temp
+ * - {r,g,b}: RGB object
+ * - {h,s,l}: HSL object
+ * - {h,s,b}: HSB object
+ * - {h,s,b,k}: HSBK object (passthrough)
+ */
+export declare function parseColor(input: ColorInput, defaultKelvin?: number): HSBK;
+//# sourceMappingURL=parse.d.ts.map

package/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["parse.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,IAAI,EAAE,UAAU,EAA+B,MAAM,YAAY,CAAC;AAoD1F;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,aAAa,GAAE,MAAuB,GAAG,IAAI,CA+B1F"}

package/parse.js

@@ -0,0 +1,94 @@
+import convert from 'color-convert';
+import { isRGB, isHSL, isHSB, isHSBK } from './types.js';
+import { rgbToHsbk, hslToHsbk, hsbToHsbk } from './convert.js';
+const DEFAULT_KELVIN = 3500;
+const MIN_KELVIN = 1500;
+const MAX_KELVIN = 9000;
+/** Parse hex color string */
+function parseHex(hex) {
+    const clean = hex.replace(/^#/, '');
+    const expanded = clean.length === 3
+        ? clean.split('').map(c => c + c).join('')
+        : clean;
+    const num = parseInt(expanded, 16);
+    return {
+        r: (num >> 16) & 255,
+        g: (num >> 8) & 255,
+        b: num & 255
+    };
+}
+/** Parse rgb(r, g, b) string */
+function parseRgbString(str) {
+    const match = str.match(/rgb\s*\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*\)/i);
+    if (!match)
+        throw new Error(`Invalid rgb string: ${str}`);
+    return {
+        r: parseInt(match[1], 10),
+        g: parseInt(match[2], 10),
+        b: parseInt(match[3], 10)
+    };
+}
+/** Parse hsl(h, s%, l%) string */
+function parseHslString(str) {
+    const match = str.match(/hsl\s*\(\s*(\d+)\s*,\s*(\d+)%?\s*,\s*(\d+)%?\s*\)/i);
+    if (!match)
+        throw new Error(`Invalid hsl string: ${str}`);
+    return {
+        h: parseInt(match[1], 10),
+        s: parseInt(match[2], 10),
+        l: parseInt(match[3], 10)
+    };
+}
+/** Parse named color using color-convert */
+function parseNamed(name) {
+    try {
+        const rgb = convert.keyword.rgb(name);
+        if (rgb)
+            return { r: rgb[0], g: rgb[1], b: rgb[2] };
+    }
+    catch (e) { }
+    throw new Error(`Unknown color name: ${name}`);
+}
+/**
+ * Parse flexible color input to HSBK
+ * Auto-detects type from input:
+ * - string: "#ff0000", "rgb(255,0,0)", "hsl(0,100%,50%)", "red"
+ * - number: Kelvin temperature (1500-9000) -> white at that temp
+ * - {r,g,b}: RGB object
+ * - {h,s,l}: HSL object
+ * - {h,s,b}: HSB object
+ * - {h,s,b,k}: HSBK object (passthrough)
+ */
+export function parseColor(input, defaultKelvin = DEFAULT_KELVIN) {
+    if (typeof input === 'number') {
+        if (input >= MIN_KELVIN && input <= MAX_KELVIN) {
+            return { h: 0, s: 0, b: 100, k: input }; /** white at kelvin */
+        }
+        throw new Error(`Kelvin must be ${MIN_KELVIN}-${MAX_KELVIN}, got ${input}`);
+    }
+    if (typeof input === 'string') {
+        const str = input.trim().toLowerCase();
+        if (str.startsWith('#') || /^[0-9a-f]{3,6}$/i.test(str)) {
+            return rgbToHsbk(parseHex(str), defaultKelvin);
+        }
+        if (str.startsWith('rgb(')) {
+            return rgbToHsbk(parseRgbString(str), defaultKelvin);
+        }
+        if (str.startsWith('hsl(')) {
+            return hslToHsbk(parseHslString(str), defaultKelvin);
+        }
+        return rgbToHsbk(parseNamed(str), defaultKelvin);
+    }
+    if (typeof input === 'object') {
+        if (isHSBK(input))
+            return input;
+        if (isHSB(input))
+            return hsbToHsbk(input, defaultKelvin);
+        if (isHSL(input))
+            return hslToHsbk(input, defaultKelvin);
+        if (isRGB(input))
+            return rgbToHsbk(input, defaultKelvin);
+    }
+    throw new Error(`Cannot parse color: ${JSON.stringify(input)}`);
+}
+//# sourceMappingURL=parse.js.map

package/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["parse.ts"],"names":[],"mappings":"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"}

package/parse.ts

@@ -0,0 +1,95 @@
+import convert from 'color-convert';
+import { RGB, HSL, HSB, HSBK, ColorInput, isRGB, isHSL, isHSB, isHSBK } from './types.js';
+import { rgbToHsbk, hslToHsbk, hsbToHsbk } from './convert.js';
+
+const DEFAULT_KELVIN = 3500;
+const MIN_KELVIN = 1500;
+const MAX_KELVIN = 9000;
+
+/** Parse hex color string */
+function parseHex(hex: string): RGB {
+    const clean = hex.replace(/^#/, '');
+    const expanded = clean.length === 3
+        ? clean.split('').map(c => c + c).join('')
+        : clean;
+    const num = parseInt(expanded, 16);
+    return {
+        r: (num >> 16) & 255,
+        g: (num >> 8) & 255,
+        b: num & 255
+    };
+}
+
+/** Parse rgb(r, g, b) string */
+function parseRgbString(str: string): RGB {
+    const match = str.match(/rgb\s*\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*\)/i);
+    if (!match) throw new Error(`Invalid rgb string: ${str}`);
+    return {
+        r: parseInt(match[1], 10),
+        g: parseInt(match[2], 10),
+        b: parseInt(match[3], 10)
+    };
+}
+
+/** Parse hsl(h, s%, l%) string */
+function parseHslString(str: string): HSL {
+    const match = str.match(/hsl\s*\(\s*(\d+)\s*,\s*(\d+)%?\s*,\s*(\d+)%?\s*\)/i);
+    if (!match) throw new Error(`Invalid hsl string: ${str}`);
+    return {
+        h: parseInt(match[1], 10),
+        s: parseInt(match[2], 10),
+        l: parseInt(match[3], 10)
+    };
+}
+
+/** Parse named color using color-convert */
+function parseNamed(name: string): RGB {
+    try {
+        const rgb = convert.keyword.rgb(name as any);
+        if (rgb) return { r: rgb[0], g: rgb[1], b: rgb[2] };
+    } catch (e: any) { }
+    throw new Error(`Unknown color name: ${name}`);
+}
+
+/**
+ * Parse flexible color input to HSBK
+ * Auto-detects type from input:
+ * - string: "#ff0000", "rgb(255,0,0)", "hsl(0,100%,50%)", "red"
+ * - number: Kelvin temperature (1500-9000) -> white at that temp
+ * - {r,g,b}: RGB object
+ * - {h,s,l}: HSL object
+ * - {h,s,b}: HSB object
+ * - {h,s,b,k}: HSBK object (passthrough)
+ */
+export function parseColor(input: ColorInput, defaultKelvin: number = DEFAULT_KELVIN): HSBK {
+    if (typeof input === 'number') {
+        if (input >= MIN_KELVIN && input <= MAX_KELVIN) {
+            return { h: 0, s: 0, b: 100, k: input };  /** white at kelvin */
+        }
+        throw new Error(`Kelvin must be ${MIN_KELVIN}-${MAX_KELVIN}, got ${input}`);
+    }
+
+    if (typeof input === 'string') {
+        const str = input.trim().toLowerCase();
+
+        if (str.startsWith('#') || /^[0-9a-f]{3,6}$/i.test(str)) {
+            return rgbToHsbk(parseHex(str), defaultKelvin);
+        }
+        if (str.startsWith('rgb(')) {
+            return rgbToHsbk(parseRgbString(str), defaultKelvin);
+        }
+        if (str.startsWith('hsl(')) {
+            return hslToHsbk(parseHslString(str), defaultKelvin);
+        }
+        return rgbToHsbk(parseNamed(str), defaultKelvin);
+    }
+
+    if (typeof input === 'object') {
+        if (isHSBK(input)) return input;
+        if (isHSB(input)) return hsbToHsbk(input, defaultKelvin);
+        if (isHSL(input)) return hslToHsbk(input, defaultKelvin);
+        if (isRGB(input)) return rgbToHsbk(input, defaultKelvin);
+    }
+
+    throw new Error(`Cannot parse color: ${JSON.stringify(input)}`);
+}

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "esnext",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "strict": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "strictNullChecks": false,
+    "noImplicitAny": true,
+    "noImplicitThis": true,
+    "newLine": "lf"
+  },
+  "exclude": ["node_modules", "cruft", ".git", "tests", "prev"]
+}

package/types.d.ts

@@ -0,0 +1,74 @@
+/**
+ * RGB color (0-255 per channel)
+ */
+export interface RGB {
+    /** Red channel (0-255) */
+    r: number;
+    /** Green channel (0-255) */
+    g: number;
+    /** Blue channel (0-255) */
+    b: number;
+}
+/**
+ * HSL color (Hue, Saturation, Lightness)
+ */
+export interface HSL {
+    /** Hue (0-360 degrees) */
+    h: number;
+    /** Saturation (0-100%) */
+    s: number;
+    /** Lightness (0-100%) */
+    l: number;
+}
+/**
+ * HSB/HSV color (Hue, Saturation, Brightness/Value)
+ */
+export interface HSB {
+    /** Hue (0-360 degrees) */
+    h: number;
+    /** Saturation (0-100%) */
+    s: number;
+    /** Brightness/Value (0-100%) */
+    b: number;
+}
+/**
+ * HSBK color with Kelvin temperature (used by LIFX and similar)
+ */
+export interface HSBK {
+    /** Hue (0-360 degrees) */
+    h: number;
+    /** Saturation (0-100%) */
+    s: number;
+    /** Brightness (0-100%) */
+    b: number;
+    /** Color temperature in Kelvin (1500-9000, warm to cool) */
+    k: number;
+}
+/**
+ * 16-bit scaled HSBK for wire protocols.
+ * h/s/b are 0-0xFFFF, k remains 1500-9000.
+ */
+export interface HSBK16 {
+    /** Hue (0-0xFFFF maps to 0-360°) */
+    h: number;
+    /** Saturation (0-0xFFFF maps to 0-100%) */
+    s: number;
+    /** Brightness (0-0xFFFF maps to 0-100%) */
+    b: number;
+    /** Color temperature in Kelvin (1500-9000) */
+    k: number;
+}
+/**
+ * Flexible color input for parseColor().
+ * Accepts: "#ff0000", "rgb(255,0,0)", "red", {r,g,b}, {h,s,l}, {h,s,b}, {h,s,b,k}, or Kelvin number
+ */
+export type ColorInput = string | number | RGB | HSL | HSB | HSBK;
+/** Type guard: check if object is RGB */
+export declare function isRGB(c: object): c is RGB;
+/** Type guard: check if object is HSL */
+export declare function isHSL(c: object): c is HSL;
+/** Type guard: check if object is HSB (without kelvin) */
+export declare function isHSB(c: object): c is HSB;
+/** Type guard: check if object is HSBK (with kelvin) */
+export declare function isHSBK(c: object): c is HSBK;
+//# sourceMappingURL=types.d.ts.map

package/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,GAAG;IAChB,0BAA0B;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,4BAA4B;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,2BAA2B;IAC3B,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,GAAG;IAChB,0BAA0B;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,0BAA0B;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,yBAAyB;IACzB,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,GAAG;IAChB,0BAA0B;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,0BAA0B;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,gCAAgC;IAChC,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACjB,0BAA0B;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,0BAA0B;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,0BAA0B;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,4DAA4D;IAC5D,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACnB,oCAAoC;IACpC,CAAC,EAAE,MAAM,CAAC;IACV,2CAA2C;IAC3C,CAAC,EAAE,MAAM,CAAC;IACV,2CAA2C;IAC3C,CAAC,EAAE,MAAM,CAAC;IACV,8CAA8C;IAC9C,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;AAElE,yCAAyC;AACzC,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,GAAG,CAEzC;AAED,yCAAyC;AACzC,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,GAAG,CAEzC;AAED,0DAA0D;AAC1D,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,GAAG,CAEzC;AAED,wDAAwD;AACxD,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,IAAI,IAAI,CAE3C"}

package/types.js

@@ -0,0 +1,17 @@
+/** Type guard: check if object is RGB */
+export function isRGB(c) {
+    return 'r' in c && 'g' in c && 'b' in c && !('h' in c);
+}
+/** Type guard: check if object is HSL */
+export function isHSL(c) {
+    return 'h' in c && 's' in c && 'l' in c;
+}
+/** Type guard: check if object is HSB (without kelvin) */
+export function isHSB(c) {
+    return 'h' in c && 's' in c && 'b' in c && !('k' in c);
+}
+/** Type guard: check if object is HSBK (with kelvin) */
+export function isHSBK(c) {
+    return 'h' in c && 's' in c && 'b' in c && 'k' in c;
+}
+//# sourceMappingURL=types.js.map

package/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"AAuEA,yCAAyC;AACzC,MAAM,UAAU,KAAK,CAAC,CAAS;IAC3B,OAAO,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,KAAK,CAAC,CAAS;IAC3B,OAAO,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,KAAK,CAAC,CAAS;IAC3B,OAAO,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,MAAM,CAAC,CAAS;IAC5B,OAAO,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AACxD,CAAC"}

package/types.ts

@@ -0,0 +1,90 @@
+/**
+ * RGB color (0-255 per channel)
+ */
+export interface RGB {
+    /** Red channel (0-255) */
+    r: number;
+    /** Green channel (0-255) */
+    g: number;
+    /** Blue channel (0-255) */
+    b: number;
+}
+
+/**
+ * HSL color (Hue, Saturation, Lightness)
+ */
+export interface HSL {
+    /** Hue (0-360 degrees) */
+    h: number;
+    /** Saturation (0-100%) */
+    s: number;
+    /** Lightness (0-100%) */
+    l: number;
+}
+
+/**
+ * HSB/HSV color (Hue, Saturation, Brightness/Value)
+ */
+export interface HSB {
+    /** Hue (0-360 degrees) */
+    h: number;
+    /** Saturation (0-100%) */
+    s: number;
+    /** Brightness/Value (0-100%) */
+    b: number;
+}
+
+/**
+ * HSBK color with Kelvin temperature (used by LIFX and similar)
+ */
+export interface HSBK {
+    /** Hue (0-360 degrees) */
+    h: number;
+    /** Saturation (0-100%) */
+    s: number;
+    /** Brightness (0-100%) */
+    b: number;
+    /** Color temperature in Kelvin (1500-9000, warm to cool) */
+    k: number;
+}
+
+/**
+ * 16-bit scaled HSBK for wire protocols.
+ * h/s/b are 0-0xFFFF, k remains 1500-9000.
+ */
+export interface HSBK16 {
+    /** Hue (0-0xFFFF maps to 0-360°) */
+    h: number;
+    /** Saturation (0-0xFFFF maps to 0-100%) */
+    s: number;
+    /** Brightness (0-0xFFFF maps to 0-100%) */
+    b: number;
+    /** Color temperature in Kelvin (1500-9000) */
+    k: number;
+}
+
+/**
+ * Flexible color input for parseColor().
+ * Accepts: "#ff0000", "rgb(255,0,0)", "red", {r,g,b}, {h,s,l}, {h,s,b}, {h,s,b,k}, or Kelvin number
+ */
+export type ColorInput = string | number | RGB | HSL | HSB | HSBK;
+
+/** Type guard: check if object is RGB */
+export function isRGB(c: object): c is RGB {
+    return 'r' in c && 'g' in c && 'b' in c && !('h' in c);
+}
+
+/** Type guard: check if object is HSL */
+export function isHSL(c: object): c is HSL {
+    return 'h' in c && 's' in c && 'l' in c;
+}
+
+/** Type guard: check if object is HSB (without kelvin) */
+export function isHSB(c: object): c is HSB {
+    return 'h' in c && 's' in c && 'b' in c && !('k' in c);
+}
+
+/** Type guard: check if object is HSBK (with kelvin) */
+export function isHSBK(c: object): c is HSBK {
+    return 'h' in c && 's' in c && 'b' in c && 'k' in c;
+}