@lightdash/common 0.2269.5 → 0.2270.0

package/dist/cjs/utils/colors.d.ts

@@ -18,4 +18,13 @@ export declare const cleanColorArray: (colors: string[]) => string[];
  * @returns 'white' or 'black' depending on which has better contrast
  */
 export declare const getReadableTextColor: (backgroundColor: string) => string;
+/**
+ * Adjusts a color to ensure it has sufficient contrast against a background color
+ * Keeps the color as close to the original as possible while meeting WCAG AA standards
+ * @param foregroundColor Color to adjust (hex, rgb, rgba, named colors, etc.)
+ * @param backgroundColor Background color to contrast against
+ * @param targetContrast Target contrast ratio (default: 4.5 for WCAG AA)
+ * @returns Adjusted color as hex string, or original if already readable
+ */
+export declare const getReadableColor: (foregroundColor: string, backgroundColor: string, targetContrast?: number) => string;
 //# sourceMappingURL=colors.d.ts.map

package/dist/cjs/utils/colors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../../src/utils/colors.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,cAAc,UAAW,MAAM,KAAG,OACR,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,WAAY,MAAM,EAAE,KAAG,MAAM,EACT,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,eAAe,WAAY,MAAM,EAAE,KAAG,MAAM,EACkB,CAAC;AAE5E;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,oBAAqB,MAAM,KAAG,MAS9D,CAAC"}
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../../src/utils/colors.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,cAAc,UAAW,MAAM,KAAG,OACR,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,WAAY,MAAM,EAAE,KAAG,MAAM,EACT,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,eAAe,WAAY,MAAM,EAAE,KAAG,MAAM,EACkB,CAAC;AAE5E;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,oBAAqB,MAAM,KAAG,MAS9D,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,oBACR,MAAM,mBACN,MAAM,mBACP,MAAM,KACvB,MA2DF,CAAC"}

package/dist/cjs/utils/colors.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getReadableTextColor = exports.cleanColorArray = exports.getInvalidHexColors = exports.isHexCodeColor = void 0;
+exports.getReadableColor = exports.getReadableTextColor = exports.cleanColorArray = exports.getInvalidHexColors = exports.isHexCodeColor = void 0;
 const tslib_1 = require("tslib");
 const colorjs_io_1 = tslib_1.__importDefault(require("colorjs.io"));
 const IS_HEX_CODE_COLOR_REGEX = /^#([a-fA-F0-9]{3}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$/;
@@ -38,4 +38,59 @@ const getReadableTextColor = (backgroundColor) => {
     }
 };
 exports.getReadableTextColor = getReadableTextColor;
+/**
+ * Adjusts a color to ensure it has sufficient contrast against a background color
+ * Keeps the color as close to the original as possible while meeting WCAG AA standards
+ * @param foregroundColor Color to adjust (hex, rgb, rgba, named colors, etc.)
+ * @param backgroundColor Background color to contrast against
+ * @param targetContrast Target contrast ratio (default: 4.5 for WCAG AA)
+ * @returns Adjusted color as hex string, or original if already readable
+ */
+const getReadableColor = (foregroundColor, backgroundColor, targetContrast = 4.5) => {
+    try {
+        const fg = new colorjs_io_1.default(foregroundColor);
+        const bg = new colorjs_io_1.default(backgroundColor);
+        const currentContrast = Math.abs(fg.contrast(bg, 'WCAG21'));
+        if (currentContrast >= targetContrast) {
+            return foregroundColor;
+        }
+        const fgLCH = fg.to('lch');
+        const originalLightness = fgLCH.l;
+        let bestColor = fg;
+        let bestDelta = Infinity;
+        // Try lightening
+        for (let lightness = originalLightness; lightness <= 100; lightness += 5) {
+            const testColor = fgLCH.clone();
+            testColor.l = lightness;
+            const contrast = Math.abs(testColor.contrast(bg, 'WCAG21'));
+            if (contrast >= targetContrast) {
+                const delta = Math.abs(lightness - originalLightness);
+                if (delta < bestDelta) {
+                    bestColor = testColor;
+                    bestDelta = delta;
+                }
+                break;
+            }
+        }
+        // Try darkening
+        for (let lightness = originalLightness; lightness >= 0; lightness -= 5) {
+            const testColor = fgLCH.clone();
+            testColor.l = lightness;
+            const contrast = Math.abs(testColor.contrast(bg, 'WCAG21'));
+            if (contrast >= targetContrast) {
+                const delta = Math.abs(lightness - originalLightness);
+                if (delta < bestDelta) {
+                    bestColor = testColor;
+                    bestDelta = delta;
+                }
+                break;
+            }
+        }
+        return bestColor.to('srgb').toString({ format: 'hex' });
+    }
+    catch (e) {
+        return foregroundColor;
+    }
+};
+exports.getReadableColor = getReadableColor;
 //# sourceMappingURL=colors.js.map

package/dist/cjs/utils/colors.js.map

@@ -1 +1 @@
-{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../../src/utils/colors.ts"],"names":[],"mappings":";;;;AAAA,oEAA+B;AAE/B,MAAM,uBAAuB,GACzB,mDAAmD,CAAC;AAEjD,MAAM,cAAc,GAAG,CAAC,KAAa,EAAW,EAAE,CACrD,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAD3B,QAAA,cAAc,kBACa;AAExC;;;;GAIG;AACI,MAAM,mBAAmB,GAAG,CAAC,MAAgB,EAAY,EAAE,CAC9D,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAA,sBAAc,EAAC,KAAK,CAAC,CAAC,CAAC;AADxC,QAAA,mBAAmB,uBACqB;AAErD;;;;GAIG;AACI,MAAM,eAAe,GAAG,CAAC,MAAgB,EAAY,EAAE,CAC1D,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAD/D,QAAA,eAAe,mBACgD;AAE5E;;;;;GAKG;AACI,MAAM,oBAAoB,GAAG,CAAC,eAAuB,EAAU,EAAE;IACpE,IAAI,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,oBAAK,CAAC,YAAY,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC;QACvE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,oBAAK,CAAC,YAAY,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC;QACvE,OAAO,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IACjD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,+CAA+C;QAC/C,OAAO,OAAO,CAAC;IACnB,CAAC;AACL,CAAC,CAAC;AATW,QAAA,oBAAoB,wBAS/B"}
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../../src/utils/colors.ts"],"names":[],"mappings":";;;;AAAA,oEAA+B;AAE/B,MAAM,uBAAuB,GACzB,mDAAmD,CAAC;AAEjD,MAAM,cAAc,GAAG,CAAC,KAAa,EAAW,EAAE,CACrD,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAD3B,QAAA,cAAc,kBACa;AAExC;;;;GAIG;AACI,MAAM,mBAAmB,GAAG,CAAC,MAAgB,EAAY,EAAE,CAC9D,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAA,sBAAc,EAAC,KAAK,CAAC,CAAC,CAAC;AADxC,QAAA,mBAAmB,uBACqB;AAErD;;;;GAIG;AACI,MAAM,eAAe,GAAG,CAAC,MAAgB,EAAY,EAAE,CAC1D,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAD/D,QAAA,eAAe,mBACgD;AAE5E;;;;;GAKG;AACI,MAAM,oBAAoB,GAAG,CAAC,eAAuB,EAAU,EAAE;IACpE,IAAI,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,oBAAK,CAAC,YAAY,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC;QACvE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,oBAAK,CAAC,YAAY,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC;QACvE,OAAO,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IACjD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,+CAA+C;QAC/C,OAAO,OAAO,CAAC;IACnB,CAAC;AACL,CAAC,CAAC;AATW,QAAA,oBAAoB,wBAS/B;AAEF;;;;;;;GAOG;AACI,MAAM,gBAAgB,GAAG,CAC5B,eAAuB,EACvB,eAAuB,EACvB,iBAAyB,GAAG,EACtB,EAAE;IACR,IAAI,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,oBAAK,CAAC,eAAe,CAAC,CAAC;QACtC,MAAM,EAAE,GAAG,IAAI,oBAAK,CAAC,eAAe,CAAC,CAAC;QAEtC,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC5D,IAAI,eAAe,IAAI,cAAc,EAAE,CAAC;YACpC,OAAO,eAAe,CAAC;QAC3B,CAAC;QAED,MAAM,KAAK,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QAC3B,MAAM,iBAAiB,GAAG,KAAK,CAAC,CAAC,CAAC;QAElC,IAAI,SAAS,GAAG,EAAE,CAAC;QACnB,IAAI,SAAS,GAAG,QAAQ,CAAC;QAEzB,iBAAiB;QACjB,KACI,IAAI,SAAS,GAAG,iBAAiB,EACjC,SAAS,IAAI,GAAG,EAChB,SAAS,IAAI,CAAC,EAChB,CAAC;YACC,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;YAChC,SAAS,CAAC,CAAC,GAAG,SAAS,CAAC;YACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;YAE5D,IAAI,QAAQ,IAAI,cAAc,EAAE,CAAC;gBAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,iBAAiB,CAAC,CAAC;gBACtD,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;oBACpB,SAAS,GAAG,SAAS,CAAC;oBACtB,SAAS,GAAG,KAAK,CAAC;gBACtB,CAAC;gBACD,MAAM;YACV,CAAC;QACL,CAAC;QAED,gBAAgB;QAChB,KACI,IAAI,SAAS,GAAG,iBAAiB,EACjC,SAAS,IAAI,CAAC,EACd,SAAS,IAAI,CAAC,EAChB,CAAC;YACC,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;YAChC,SAAS,CAAC,CAAC,GAAG,SAAS,CAAC;YACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;YAE5D,IAAI,QAAQ,IAAI,cAAc,EAAE,CAAC;gBAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,iBAAiB,CAAC,CAAC;gBACtD,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;oBACpB,SAAS,GAAG,SAAS,CAAC;oBACtB,SAAS,GAAG,KAAK,CAAC;gBACtB,CAAC;gBACD,MAAM;YACV,CAAC;QACL,CAAC;QACD,OAAO,SAAS,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5D,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,OAAO,eAAe,CAAC;IAC3B,CAAC;AACL,CAAC,CAAC;AA/DW,QAAA,gBAAgB,oBA+D3B"}

package/dist/cjs/visualizations/helpers/styles/referenceLineStyles.d.ts

@@ -1,7 +1,9 @@
 /**
  * Get reference line styling
+ * @param lineColor Optional custom color for the line
+ * @param backgroundColor Background color to ensure contrast against (required for color adjustment)
  */
-export declare const getReferenceLineStyle: (lineColor?: string) => {
+export declare const getReferenceLineStyle: (lineColor?: string, backgroundColor?: string) => {
     emphasis: {
         disabled: boolean;
     };

package/dist/cjs/visualizations/helpers/styles/referenceLineStyles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"referenceLineStyles.d.ts","sourceRoot":"","sources":["../../../../../src/visualizations/helpers/styles/referenceLineStyles.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,qBAAqB,eAAgB,MAAM;;;;;;;;;;;;;4BAgBxB;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE;;;;;;;;;;CAkBzE,CAAC"}
+{"version":3,"file":"referenceLineStyles.d.ts","sourceRoot":"","sources":["../../../../../src/visualizations/helpers/styles/referenceLineStyles.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,eAClB,MAAM,oBACA,MAAM;;;;;;;;;;;;;4BAqBI;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE;;;;;;;;;;CAkBzE,CAAC"}

package/dist/cjs/visualizations/helpers/styles/referenceLineStyles.js

@@ -1,18 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getReferenceLineStyle = void 0;
+const colors_1 = require("../../../utils/colors");
 const themeColors_1 = require("./themeColors");
 /**
  * Get reference line styling
+ * @param lineColor Optional custom color for the line
+ * @param backgroundColor Background color to ensure contrast against (required for color adjustment)
  */
-const getReferenceLineStyle = (lineColor) => {
+const getReferenceLineStyle = (lineColor, backgroundColor) => {
     const defaultLineColor = lineColor || themeColors_1.GRAY_9;
+    // Adjust color for visibility if background color is provided
+    const adjustedLineColor = backgroundColor
+        ? (0, colors_1.getReadableColor)(defaultLineColor, backgroundColor)
+        : defaultLineColor;
     return {
         emphasis: {
             disabled: true,
         },
         lineStyle: {
-            color: defaultLineColor,
+            color: adjustedLineColor,
             type: [2, 3], // Dotted: 2px dash, 3px gap
             width: 2,
         },
@@ -28,10 +35,10 @@ const getReferenceLineStyle = (lineColor) => {
                     ? `${text.substring(0, maxChars)}...`
                     : text;
             },
-            backgroundColor: themeColors_1.GRAY_7,
-            color: themeColors_1.WHITE,
+            backgroundColor: adjustedLineColor,
+            color: (0, colors_1.getReadableTextColor)(adjustedLineColor),
             borderWidth: 1,
-            borderColor: themeColors_1.GRAY_8,
+            borderColor: adjustedLineColor,
             padding: [2, 4],
             borderRadius: 4,
             fontSize: 11,

package/dist/cjs/visualizations/helpers/styles/referenceLineStyles.js.map

@@ -1 +1 @@
-{"version":3,"file":"referenceLineStyles.js","sourceRoot":"","sources":["../../../../../src/visualizations/helpers/styles/referenceLineStyles.ts"],"names":[],"mappings":";;;AAAA,+CAA8D;AAE9D;;GAEG;AACI,MAAM,qBAAqB,GAAG,CAAC,SAAkB,EAAE,EAAE;IACxD,MAAM,gBAAgB,GAAG,SAAS,IAAI,oBAAM,CAAC;IAE7C,OAAO;QACH,QAAQ,EAAE;YACN,QAAQ,EAAE,IAAI;SACjB;QACD,SAAS,EAAE;YACP,KAAK,EAAE,gBAAgB;YACvB,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAU,EAAE,4BAA4B;YACnD,KAAK,EAAE,CAAC;SACX;QACD,KAAK,EAAE;YACH,IAAI,EAAE,IAAI;YACV,QAAQ,EAAE,OAAgB,EAAE,0DAA0D;YACtF,QAAQ,EAAE,CAAC,CAAC,EAAE,gDAAgD;YAC9D,SAAS,EAAE,CAAC,MAAkD,EAAE,EAAE;gBAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;gBACvD,gFAAgF;gBAChF,MAAM,QAAQ,GAAG,EAAE,CAAC;gBACpB,OAAO,IAAI,CAAC,MAAM,GAAG,QAAQ;oBACzB,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK;oBACrC,CAAC,CAAC,IAAI,CAAC;YACf,CAAC;YACD,eAAe,EAAE,oBAAM;YACvB,KAAK,EAAE,mBAAK;YACZ,WAAW,EAAE,CAAC;YACd,WAAW,EAAE,oBAAM;YACnB,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACf,YAAY,EAAE,CAAC;YACf,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,GAAG;SAClB;KACJ,CAAC;AACN,CAAC,CAAC;AAlCW,QAAA,qBAAqB,yBAkChC"}
+{"version":3,"file":"referenceLineStyles.js","sourceRoot":"","sources":["../../../../../src/visualizations/helpers/styles/referenceLineStyles.ts"],"names":[],"mappings":";;;AAAA,kDAA+E;AAC/E,+CAAuC;AAEvC;;;;GAIG;AACI,MAAM,qBAAqB,GAAG,CACjC,SAAkB,EAClB,eAAwB,EAC1B,EAAE;IACA,MAAM,gBAAgB,GAAG,SAAS,IAAI,oBAAM,CAAC;IAC7C,8DAA8D;IAC9D,MAAM,iBAAiB,GAAG,eAAe;QACrC,CAAC,CAAC,IAAA,yBAAgB,EAAC,gBAAgB,EAAE,eAAe,CAAC;QACrD,CAAC,CAAC,gBAAgB,CAAC;IAEvB,OAAO;QACH,QAAQ,EAAE;YACN,QAAQ,EAAE,IAAI;SACjB;QACD,SAAS,EAAE;YACP,KAAK,EAAE,iBAAiB;YACxB,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAU,EAAE,4BAA4B;YACnD,KAAK,EAAE,CAAC;SACX;QACD,KAAK,EAAE;YACH,IAAI,EAAE,IAAI;YACV,QAAQ,EAAE,OAAgB,EAAE,0DAA0D;YACtF,QAAQ,EAAE,CAAC,CAAC,EAAE,gDAAgD;YAC9D,SAAS,EAAE,CAAC,MAAkD,EAAE,EAAE;gBAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;gBACvD,gFAAgF;gBAChF,MAAM,QAAQ,GAAG,EAAE,CAAC;gBACpB,OAAO,IAAI,CAAC,MAAM,GAAG,QAAQ;oBACzB,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK;oBACrC,CAAC,CAAC,IAAI,CAAC;YACf,CAAC;YACD,eAAe,EAAE,iBAAiB;YAClC,KAAK,EAAE,IAAA,6BAAoB,EAAC,iBAAiB,CAAC;YAC9C,WAAW,EAAE,CAAC;YACd,WAAW,EAAE,iBAAiB;YAC9B,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACf,YAAY,EAAE,CAAC;YACf,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,GAAG;SAClB;KACJ,CAAC;AACN,CAAC,CAAC;AAzCW,QAAA,qBAAqB,yBAyChC"}