@bobfrankston/colorlib 0.1.0 → 0.1.2

package/.gitattributes

@@ -0,0 +1,5 @@
+* text=auto eol=lf
+*.ts text eol=lf
+*.js text eol=lf
+*.json text eol=lf
+*.md text eol=lf

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/colorlib",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Color conversion library for RGB, HSL, HSB, HSBK and Kelvin",
   "type": "module",
   "main": "index.js",
@@ -13,9 +13,18 @@
   },
   "scripts": {
     "build": "tsc",
-    "watch": "tsc -w"
+    "watch": "tsc -w",
+    "preversion": "npm run build",
+    "postversion": "git push && git push --tags && npm publish",
+    "release": "git add -A && git diff-index --quiet HEAD || git commit -m 'Build for release' && npm version patch"
   },
-  "keywords": ["color", "hsl", "hsb", "rgb", "kelvin"],
+  "keywords": [
+    "color",
+    "hsl",
+    "hsb",
+    "rgb",
+    "kelvin"
+  ],
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -26,6 +35,6 @@
   },
   "devDependencies": {
     "@types/color-convert": "^2.0.4",
-    "@types/node": "latest"
+    "@types/node": "^25.0.6"
   }
 }

package/convert.ts

@@ -1,111 +0,0 @@
-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.ts

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

package/parse.ts

@@ -1,95 +0,0 @@
-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

@@ -1,20 +0,0 @@
-{
-  "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.ts

@@ -1,90 +0,0 @@
-/**
- * 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;
-}