@d3plus/color 3.0.15 → 3.1.0

package/umd/d3plus-color.min.js

@@ -1,74 +1,72 @@
 /*
-  @d3plus/color v3.0.15
+  @d3plus/color v3.0.16
   Color functions that extent the ability of d3-color.
   Copyright (c) 2026 D3plus - https://d3plus.org
   @license MIT
 */
-(o=>{"function"==typeof define&&define.amd?define(o):o()})(function(){if("undefined"!=typeof window){try{if("undefined"==typeof SVGElement||Boolean(SVGElement.prototype.innerHTML))return}catch(o){return}function n(o){switch(o.nodeType){case 1:var e=o,r="";return r+="<"+e.tagName,e.hasAttributes()&&[].forEach.call(e.attributes,function(o){r+=" "+o.name+'="'+o.value+'"'}),r+=">",e.hasChildNodes()&&[].forEach.call(e.childNodes,function(o){r+=n(o)}),r+="</"+e.tagName+">";case 3:return o.textContent.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;");case 8:return"\x3c!--"+o.nodeValue+"--\x3e"}}Object.defineProperty(SVGElement.prototype,"innerHTML",{get:function(){var e="";return[].forEach.call(this.childNodes,function(o){e+=n(o)}),e},set:function(o){for(;this.firstChild;)this.removeChild(this.firstChild);try{var e=new DOMParser,r=(e.async=!1,"<svg xmlns='http://www.w3.org/2000/svg' xmlns:xlink='http://www.w3.org/1999/xlink'>"+o+"</svg>"),n=e.parseFromString(r,"text/xml").documentElement;[].forEach.call(n.childNodes,function(o){this.appendChild(this.ownerDocument.importNode(o,!0))}.bind(this))}catch(o){throw new Error("Error parsing markup string")}}}),Object.defineProperty(SVGElement.prototype,"innerSVG",{get:function(){return this.innerHTML},set:function(o){this.innerHTML=o}})}}),((o,e)=>{"object"==typeof exports&&"undefined"!=typeof module?e(exports,require("d3-color"),require("d3-scale"),require("open-color/open-color.js")):"function"==typeof define&&define.amd?define("@d3plus/color",["exports","d3-color","d3-scale","open-color/open-color.js"],e):e((o="undefined"!=typeof globalThis?globalThis:o||self).d3plus={},o.d3Color,o.d3Scale,o.pkg)})(this,function(o,i,e,r){r=r.theme;
+!function(o,l){"object"==typeof exports&&"undefined"!=typeof module?l(exports,require("d3-color"),require("d3-scale"),require("open-color/open-color.js")):"function"==typeof define&&define.amd?define("@d3plus/color",["exports","d3-color","d3-scale","open-color/open-color.js"],l):l((o="undefined"!=typeof globalThis?globalThis:o||self).d3plus={},o.d3Color,o.d3Scale,o.pkg)}(this,function(o,l,r,s){"use strict";
 /**
-      @namespace {Object} colorDefaults
-      @desc A set of default color values used when assigning colors based on data.
-  */let n={dark:r.colors.gray[700],light:r.colors.gray[50],missing:r.colors.gray[400],off:r.colors.red[900],on:r.colors.green[900],scale:e.scaleOrdinal().range([r.colors.indigo[900],r.colors.yellow[600],r.colors.red[900],r.colors.green[900],r.colors.orange[600],r.colors.grape[900],r.colors.cyan[600],r.colors.pink[600],r.colors.lime[600],r.colors.blue[300],r.colors.pink[300],r.colors.lime[300],r.colors.violet[300],r.colors.cyan[100],r.colors.orange[100],r.colors.green[100],r.colors.grape[100],r.colors.red[100]])};
+      Adds two colors together.
+      @param c1 The first color, a valid CSS color string.
+      @param c2 The second color, also a valid CSS color string.
+      @param o1 Value from 0 to 1 of the first color's opacity.
+      @param o2 Value from 0 to 1 of the first color's opacity.
+  */const{theme:e}=s,n={dark:e.colors.gray[700],light:e.colors.gray[50],missing:e.colors.gray[400],off:e.colors.red[900],on:e.colors.green[900],scale:r.scaleOrdinal().range([e.colors.indigo[900],e.colors.yellow[600],e.colors.red[900],e.colors.green[900],e.colors.orange[600],e.colors.grape[900],e.colors.cyan[600],e.colors.pink[600],e.colors.lime[600],e.colors.blue[300],e.colors.pink[300],e.colors.lime[300],e.colors.violet[300],e.colors.cyan[100],e.colors.orange[100],e.colors.green[100],e.colors.grape[100],e.colors.red[100]])};
 /**
-      Returns a color based on a key, whether it is present in a user supplied object or in the default object.
-      @returns {String}
-      @private
-  */function t(o,e={}){return o in e?e[o]:o in n?n[o]:n.missing}
+   * A set of default color values used when assigning colors based on data.
+   *
+   * @defaultValue
+   * ```
+   * {
+   *   dark: "#495057",
+   *   light: "#f8f9fa",
+   *   missing: "#ced4da",
+   *   off: "#c92a2a",
+   *   on: "#2b8a3e",
+   *   scale: d3.scaleOrdinal().range([
+   *     "#364fc7", "#fab005", "#c92a2a",
+   *     "#2b8a3e", "#fd7e14", "#862e9c",
+   *     "#15aabf", "#e64980", "#82c91e",
+   *     "#74c0fc", "#faa2c1", "#c0eb75",
+   *     "#b197fc", "#c5f6fa", "#ffe8cc",
+   *     "#d3f9d8", "#f3d9fa", "#ffe3e3"
+   *   ])
+   * }
+   * ```
+   */o.colorAdd=function(o,r,s=1,e=1){const n=l.hsl(o),c=l.hsl(r);let t=Math.abs(c.h*e-n.h*s);t>180&&(t-=360);let i=(Math.min(n.h,c.h)+t/2)%360;const a=n.l+(c.l*e-n.l*s)/2,g=n.s+(c.s*e-n.s*s)/2;return i<0&&(i+=360),l.hsl(`hsl(${i},${100*g}%,${100*a}%)`).toString()},o.colorAssign=
 /**
-      @function colorAssign
-      @desc Assigns a color to a value using a predefined set of defaults.
-      @param {String} c A valid CSS color string.
-      @param {Object} [u = defaults] An object containing overrides of the default colors.
-      @returns {String}
-  */o.colorAdd=
-/**
-      @function colorAdd
-      @desc Adds two colors together.
-      @param {String} c1 The first color, a valid CSS color string.
-      @param {String} c2 The second color, also a valid CSS color string.
-      @param {String} [o1 = 1] Value from 0 to 1 of the first color's opacity.
-      @param {String} [o2 = 1] Value from 0 to 1 of the first color's opacity.
-      @returns {String}
-  */function(o,e,r=1,n=1){o=i.hsl(o),e=i.hsl(e);let t=Math.abs(e.h*n-o.h*r),l=(180<t&&(t-=360),(Math.min(o.h,e.h)+t/2)%360);var s=o.l+(e.l*n-o.l*r)/2,e=o.s+(e.s*n-o.s*r)/2;
-// a = o1 + (o2 - o1) / 2;
-return l<0&&(l+=360),i.hsl(`hsl(${l},${100*e}%,${100*s}%)`).toString();
-// return hsl(`hsl(${h},${s * 100}%,${l * 100}%,${a})`).toString();
-},o.colorAssign=function(o,e={}){
+      Assigns a color to a value using a predefined set of defaults.
+      @param c A valid CSS color string.
+      @param u An object containing overrides of the default colors.
+  */
+function(o,r={}){
 // If the value is null or undefined, set to grey.
-return 0<=[null,void 0].indexOf(o)?t("missing",e):!0===o?t("on",e):!1===o?t("off",e):
+return[null,void 0].indexOf(o)>=0?r.missing||n.missing:!0===o?r.on||n.on:!1===o?r.off||n.off:
 // If the value is not a valid color string, use the color scale.
-i.color(o)?o.toString():t("scale",e)(o)}
+l.color(o)?o:(r.scale||n.scale)(o)}
 /**
-      @function colorContrast
-      @desc A set of default color values used when assigning colors based on data.
-      @param {String} c A valid CSS color string.
-      @param {Object} [u = defaults] An object containing overrides of the default colors.
-      @returns {String}
-  */,o.colorContrast=function(o,e={}){return t(128<=(299*(o=i.rgb(o)).r+587*o.g+114*o.b)/1e3?"dark":"light",e)}
+      A set of default color values used when assigning colors based on data.
+      @param c A valid CSS color string.
+      @param u An object containing overrides of the default colors.
+  */,o.colorContrast=function(o,r={}){const s=l.rgb(o);return(299*s.r+587*s.g+114*s.b)/1e3>=128?r.dark||n.dark:r.light||n.light}
 /**
-      @function colorLegible
-      @desc Darkens a color so that it will appear legible on a white background.
-      @param {String} c A valid CSS color string.
-      @returns {String}
-  */,o.colorDefaults=n,o.colorLegible=function(o){return.45<(o=i.hsl(o)).l&&(.8<o.s&&(o.s=.8),o.l=.45),o.toString()}
+      Darkens a color so that it will appear legible on a white background.
+      @param c A valid CSS color string.
+  */,o.colorDefaults=n,o.colorLegible=function(o){const r=l.hsl(o);return r.l>.45&&(r.s>.8&&(r.s=.8),r.l=.45),r.toString()}
 /**
-      @function colorLighter
-      @desc Similar to d3.color.brighter, except that this also reduces saturation so that colors don't appear neon.
-      @param {String} c A valid CSS color string.
-      @param {String} [i = 0.5] A value from 0 to 1 dictating the strength of the function.
-      @returns {String}
-  */,o.colorLighter=function(o,e=.5){return e*=1-(o=i.hsl(o)).l,o.l+=e,o.s-=e,o.toString()}
+      Similar to d3.color.brighter, except that this also reduces saturation so that colors don't appear neon.
+      @param c A valid CSS color string.
+      @param i Strength of the lightening effect, from 0 to 1.
+  */,o.colorLighter=function(o,r=.5){const s=l.hsl(o);return r*=1-s.l,s.l+=r,s.s-=r,s.toString()}
 /**
-      @function colorSubtract
-      @desc Subtracts one color from another.
-      @param {String} c1 The base color, a valid CSS color string.
-      @param {String} c2 The color to remove from the base color, also a valid CSS color string.
-      @param {String} [o1 = 1] Value from 0 to 1 of the first color's opacity.
-      @param {String} [o2 = 1] Value from 0 to 1 of the first color's opacity.
-      @returns {String}
-  */,o.colorSubtract=function(o,e,r=1,n=1){o=i.hsl(o);let t=(e=i.hsl(e)).h*n-o.h*r,l=(180<Math.abs(t)&&(t-=360),(o.h-t)%360);var s=o.l-(e.l*n-o.l*r)/2,e=o.s-(e.s*n-o.s*r)/2;
+      Subtracts one color from another.
+      @param c1 The base color, a valid CSS color string.
+      @param c2 The color to remove from the base color, also a valid CSS color string.
+      @param o1 Value from 0 to 1 of the first color's opacity.
+      @param o2 Value from 0 to 1 of the first color's opacity.
+  */,o.colorSubtract=function(o,r,s=1,e=1){const n=l.hsl(o),c=l.hsl(r);let t=c.h*e-n.h*s;Math.abs(t)>180&&(t-=360);let i=(n.h-t)%360;const a=n.l-(c.l*e-n.l*s)/2,g=n.s-(c.s*e-n.s*s)/2;
 // a = o1 - (o2 - o1) / 2;
-return l<0&&(l+=360),i.hsl(`hsl(${l},${100*e}%,${100*s}%)`).toString();
+return i<0&&(i+=360),l.hsl(`hsl(${i},${100*g}%,${100*a}%)`).toString();
 // return hsl(`hsl(${h},${s * 100}%,${l * 100}%,${a})`).toString();
 }});
 //# sourceMappingURL=d3plus-color.js.map