yuyeon 0.3.1-rc.6 → 0.3.2-rc.1

package/lib/util/anchor.js

@@ -0,0 +1,53 @@
+const includes = (array, item) => array.includes(item);
+const block = ['top', 'bottom'];
+const inline = ['start', 'end', 'left', 'right'];
+/** Parse a raw anchor string into an object */
+export function parseAnchor(anchor, isRtl) {
+  let [side, align] = anchor.split(' ');
+  if (!align) {
+    align = includes(block, side) ? 'start' : includes(inline, side) ? 'top' : 'center';
+  }
+  return {
+    side: toPhysical(side, isRtl),
+    align: toPhysical(align, isRtl)
+  };
+}
+export function toPhysical(str, isRtl) {
+  if (str === 'start') return isRtl ? 'right' : 'left';
+  if (str === 'end') return isRtl ? 'left' : 'right';
+  return str;
+}
+export function flipSide(anchor) {
+  return {
+    side: {
+      center: 'center',
+      top: 'bottom',
+      bottom: 'top',
+      left: 'right',
+      right: 'left'
+    }[anchor.side],
+    align: anchor.align
+  };
+}
+export function flipAlign(anchor) {
+  return {
+    side: anchor.side,
+    align: {
+      center: 'center',
+      top: 'bottom',
+      bottom: 'top',
+      left: 'right',
+      right: 'left'
+    }[anchor.align]
+  };
+}
+export function flipCorner(anchor) {
+  return {
+    side: anchor.align,
+    align: anchor.side
+  };
+}
+export function getAxis(anchor) {
+  return includes(block, anchor.side) ? 'y' : 'x';
+}
+//# sourceMappingURL=anchor.js.map

package/lib/util/anchor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor.js","names":["includes","array","item","block","inline","parseAnchor","anchor","isRtl","side","align","split","toPhysical","str","flipSide","center","top","bottom","left","right","flipAlign","flipCorner","getAxis"],"sources":["../../src/util/anchor.ts"],"sourcesContent":["const includes = <T, A extends T>(\r\n  array: ReadonlyArray<A>,\r\n  item: T,\r\n): item is A => array.includes(item as A);\r\n\r\nconst block = ['top', 'bottom'] as const;\r\nconst inline = ['start', 'end', 'left', 'right'] as const;\r\ntype Tblock = (typeof block)[number];\r\ntype Tinline = (typeof inline)[number];\r\nexport type Anchor =\r\n  | Tblock\r\n  | Tinline\r\n  | 'center'\r\n  | 'center center'\r\n  | `${Tblock} ${Tinline | 'center'}`\r\n  | `${Tinline} ${Tblock | 'center'}`;\r\nexport type ParsedAnchor =\r\n  | { side: 'center'; align: 'center' }\r\n  | { side: Tblock; align: 'left' | 'right' | 'center' }\r\n  | { side: 'left' | 'right'; align: Tblock | 'center' };\r\n\r\n/** Parse a raw anchor string into an object */\r\nexport function parseAnchor(anchor: Anchor, isRtl: boolean) {\r\n  let [side, align] = anchor.split(' ') as [\r\n    Tblock | Tinline | 'center',\r\n    Tblock | Tinline | 'center' | undefined,\r\n  ];\r\n  if (!align) {\r\n    align = includes(block, side)\r\n      ? 'start'\r\n      : includes(inline, side)\r\n        ? 'top'\r\n        : 'center';\r\n  }\r\n\r\n  return {\r\n    side: toPhysical(side, isRtl),\r\n    align: toPhysical(align, isRtl),\r\n  } as ParsedAnchor;\r\n}\r\n\r\nexport function toPhysical(str: 'center' | Tblock | Tinline, isRtl: boolean) {\r\n  if (str === 'start') return isRtl ? 'right' : 'left';\r\n  if (str === 'end') return isRtl ? 'left' : 'right';\r\n  return str;\r\n}\r\n\r\nexport function flipSide(anchor: ParsedAnchor) {\r\n  return {\r\n    side: {\r\n      center: 'center',\r\n      top: 'bottom',\r\n      bottom: 'top',\r\n      left: 'right',\r\n      right: 'left',\r\n    }[anchor.side],\r\n    align: anchor.align,\r\n  } as ParsedAnchor;\r\n}\r\n\r\nexport function flipAlign(anchor: ParsedAnchor) {\r\n  return {\r\n    side: anchor.side,\r\n    align: {\r\n      center: 'center',\r\n      top: 'bottom',\r\n      bottom: 'top',\r\n      left: 'right',\r\n      right: 'left',\r\n    }[anchor.align],\r\n  } as ParsedAnchor;\r\n}\r\n\r\nexport function flipCorner(anchor: ParsedAnchor) {\r\n  return {\r\n    side: anchor.align,\r\n    align: anchor.side,\r\n  } as ParsedAnchor;\r\n}\r\n\r\nexport function getAxis(anchor: ParsedAnchor) {\r\n  return includes(block, anchor.side) ? 'y' : 'x';\r\n}\r\n"],"mappings":"AAAA,MAAMA,QAAQ,GAAGA,CACfC,KAAuB,EACvBC,IAAO,KACOD,KAAK,CAACD,QAAQ,CAACE,IAAS,CAAC;AAEzC,MAAMC,KAAK,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAU;AACxC,MAAMC,MAAM,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAU;AAezD;AACA,OAAO,SAASC,WAAWA,CAACC,MAAc,EAAEC,KAAc,EAAE;EAC1D,IAAI,CAACC,IAAI,EAAEC,KAAK,CAAC,GAAGH,MAAM,CAACI,KAAK,CAAC,GAAG,CAGnC;EACD,IAAI,CAACD,KAAK,EAAE;IACVA,KAAK,GAAGT,QAAQ,CAACG,KAAK,EAAEK,IAAI,CAAC,GACzB,OAAO,GACPR,QAAQ,CAACI,MAAM,EAAEI,IAAI,CAAC,GACpB,KAAK,GACL,QAAQ;EAChB;EAEA,OAAO;IACLA,IAAI,EAAEG,UAAU,CAACH,IAAI,EAAED,KAAK,CAAC;IAC7BE,KAAK,EAAEE,UAAU,CAACF,KAAK,EAAEF,KAAK;EAChC,CAAC;AACH;AAEA,OAAO,SAASI,UAAUA,CAACC,GAAgC,EAAEL,KAAc,EAAE;EAC3E,IAAIK,GAAG,KAAK,OAAO,EAAE,OAAOL,KAAK,GAAG,OAAO,GAAG,MAAM;EACpD,IAAIK,GAAG,KAAK,KAAK,EAAE,OAAOL,KAAK,GAAG,MAAM,GAAG,OAAO;EAClD,OAAOK,GAAG;AACZ;AAEA,OAAO,SAASC,QAAQA,CAACP,MAAoB,EAAE;EAC7C,OAAO;IACLE,IAAI,EAAE;MACJM,MAAM,EAAE,QAAQ;MAChBC,GAAG,EAAE,QAAQ;MACbC,MAAM,EAAE,KAAK;MACbC,IAAI,EAAE,OAAO;MACbC,KAAK,EAAE;IACT,CAAC,CAACZ,MAAM,CAACE,IAAI,CAAC;IACdC,KAAK,EAAEH,MAAM,CAACG;EAChB,CAAC;AACH;AAEA,OAAO,SAASU,SAASA,CAACb,MAAoB,EAAE;EAC9C,OAAO;IACLE,IAAI,EAAEF,MAAM,CAACE,IAAI;IACjBC,KAAK,EAAE;MACLK,MAAM,EAAE,QAAQ;MAChBC,GAAG,EAAE,QAAQ;MACbC,MAAM,EAAE,KAAK;MACbC,IAAI,EAAE,OAAO;MACbC,KAAK,EAAE;IACT,CAAC,CAACZ,MAAM,CAACG,KAAK;EAChB,CAAC;AACH;AAEA,OAAO,SAASW,UAAUA,CAACd,MAAoB,EAAE;EAC/C,OAAO;IACLE,IAAI,EAAEF,MAAM,CAACG,KAAK;IAClBA,KAAK,EAAEH,MAAM,CAACE;EAChB,CAAC;AACH;AAEA,OAAO,SAASa,OAAOA,CAACf,MAAoB,EAAE;EAC5C,OAAON,QAAQ,CAACG,KAAK,EAAEG,MAAM,CAACE,IAAI,CAAC,GAAG,GAAG,GAAG,GAAG;AACjD"}

package/lib/util/array.js

@@ -0,0 +1,13 @@
+export function differenceBetween(inspect, exclude) {
+  const ret = [];
+  for (const target of exclude) {
+    if (!inspect.includes(target)) {
+      ret.push(target);
+    }
+  }
+  return ret;
+}
+export function wrapInArray(arrOrNot) {
+  return Array.isArray(arrOrNot) ? arrOrNot : [arrOrNot];
+}
+//# sourceMappingURL=array.js.map

package/lib/util/array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.js","names":["differenceBetween","inspect","exclude","ret","target","includes","push","wrapInArray","arrOrNot","Array","isArray"],"sources":["../../src/util/array.ts"],"sourcesContent":["export function differenceBetween(inspect: any[], exclude: any[]) {\n  const ret = [];\n  for (const target of exclude) {\n    if (!inspect.includes(target)) {\n      ret.push(target);\n    }\n  }\n  return ret;\n}\n\nexport function wrapInArray(arrOrNot: any | any[]) {\n  return Array.isArray(arrOrNot) ? arrOrNot : [arrOrNot];\n}\n"],"mappings":"AAAA,OAAO,SAASA,iBAAiBA,CAACC,OAAc,EAAEC,OAAc,EAAE;EAChE,MAAMC,GAAG,GAAG,EAAE;EACd,KAAK,MAAMC,MAAM,IAAIF,OAAO,EAAE;IAC5B,IAAI,CAACD,OAAO,CAACI,QAAQ,CAACD,MAAM,CAAC,EAAE;MAC7BD,GAAG,CAACG,IAAI,CAACF,MAAM,CAAC;IAClB;EACF;EACA,OAAOD,GAAG;AACZ;AAEA,OAAO,SAASI,WAAWA,CAACC,QAAqB,EAAE;EACjD,OAAOC,KAAK,CAACC,OAAO,CAACF,QAAQ,CAAC,GAAGA,QAAQ,GAAG,CAACA,QAAQ,CAAC;AACxD"}

package/lib/util/collection.js

@@ -0,0 +1,10 @@
+export function getFlatChildren(children) {
+  let childrenKey = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'children';
+  return children.map(child => {
+    if (child[childrenKey]) {
+      return [child, ...getFlatChildren(child[childrenKey])];
+    }
+    return [child];
+  });
+}
+//# sourceMappingURL=collection.js.map

package/lib/util/collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.js","names":["getFlatChildren","children","childrenKey","arguments","length","undefined","map","child"],"sources":["../../src/util/collection.ts"],"sourcesContent":["export function getFlatChildren(\r\n  children: any[],\r\n  childrenKey = 'children',\r\n): any[] {\r\n  return children.map((child) => {\r\n    if (child[childrenKey]) {\r\n      return [child, ...getFlatChildren(child[childrenKey])];\r\n    }\r\n    return [child];\r\n  });\r\n}\r\n"],"mappings":"AAAA,OAAO,SAASA,eAAeA,CAC7BC,QAAe,EAER;EAAA,IADPC,WAAW,GAAAC,SAAA,CAAAC,MAAA,QAAAD,SAAA,QAAAE,SAAA,GAAAF,SAAA,MAAG,UAAU;EAExB,OAAOF,QAAQ,CAACK,GAAG,CAAEC,KAAK,IAAK;IAC7B,IAAIA,KAAK,CAACL,WAAW,CAAC,EAAE;MACtB,OAAO,CAACK,KAAK,EAAE,GAAGP,eAAe,CAACO,KAAK,CAACL,WAAW,CAAC,CAAC,CAAC;IACxD;IACA,OAAO,CAACK,KAAK,CAAC;EAChB,CAAC,CAAC;AACJ"}

package/lib/util/color/apca.js

@@ -0,0 +1,201 @@
+///////////////////////////////////////////////////////////////////////////////
+/** @preserve
+ /////    SAPC APCA - Advanced Perceptual Contrast Algorithm
+ /////           Beta 0.1.9 W3 • contrast function only
+ /////           DIST: W3 • Revision date: July 3, 2022
+ /////    Function to parse color values and determine Lc contrast
+ /////    Copyright © 2019-2022 by Andrew Somers. All Rights Reserved.
+ /////    LICENSE: W3 LICENSE
+ /////    CONTACT: Please use the ISSUES or DISCUSSIONS tab at:
+ /////    https://github.com/Myndex/SAPC-APCA/
+ /////
+ ///////////////////////////////////////////////////////////////////////////////
+ /////
+ /////    MINIMAL IMPORTS:
+ /////      import { APCAcontrast, sRGBtoY, displayP3toY,
+/////               calcAPCA, fontLookupAPCA } from 'apca-w3';
+ /////      import { colorParsley } from 'colorparsley';
+ /////
+ /////    FORWARD CONTRAST USAGE:
+ /////      Lc = APCAcontrast( sRGBtoY( TEXTcolor ) , sRGBtoY( BACKGNDcolor ) );
+ /////    Where the colors are sent as an rgba array [255,255,255,1]
+ /////
+ /////    Retrieving an array of font sizes for the contrast:
+ /////      fontArray = fontLookupAPCA(Lc);
+ /////
+ /////    Live Demonstrator at https://www.myndex.com/APCA/
+ // */
+///////////////////////////////////////////////////////////////////////////////
+
+/////  Module Scope Object Containing Constants  /////
+/////   APCA   0.0.98G - 4g - W3 Compatible Constants
+
+/////  𝒦 SA98G  ///////////////////////////////////
+const SA98G = {
+  mainTRC: 2.4,
+  // 2.4 exponent for emulating actual monitor perception
+
+  // For reverseAPCA
+  get mainTRCencode() {
+    return 1 / this.mainTRC;
+  },
+  // sRGB coefficients
+  sRco: 0.2126729,
+  sGco: 0.7151522,
+  sBco: 0.072175,
+  // G-4g constants for use with 2.4 exponent
+  normBG: 0.56,
+  normTXT: 0.57,
+  revTXT: 0.62,
+  revBG: 0.65,
+  // G-4g Clamps and Scalers
+  blkThrs: 0.022,
+  blkClmp: 1.414,
+  scaleBoW: 1.14,
+  scaleWoB: 1.14,
+  loBoWoffset: 0.027,
+  loWoBoffset: 0.027,
+  deltaYmin: 0.0005,
+  loClip: 0.1,
+  ///// MAGIC NUMBERS for UNCLAMP, for use with 0.022 & 1.414 /////
+  // Magic Numbers for reverseAPCA
+  mFactor: 1.9468554433171,
+  get mFactInv() {
+    return 1 / this.mFactor;
+  },
+  mOffsetIn: 0.0387393816571401,
+  mExpAdj: 0.283343396420869,
+  get mExp() {
+    return this.mExpAdj / this.blkClmp;
+  },
+  mOffsetOut: 0.312865795870758
+};
+
+//////////////////////////////////////////////////////////////////////////////
+//////////  LUMINANCE CONVERTERS  |//////////////////////////////////////////
+
+//////////  ƒ  sRGBtoY()  //////////////////////////////////////////////////
+export function sRGBtoY() {
+  let rgb = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [0, 0, 0];
+  // send sRGB 8bpc (0xFFFFFF) or string
+
+  // NOTE: Currently expects 0-255
+
+  /////   APCA   0.0.98G - 4g - W3 Compatible Constants   ////////////////////
+  /*
+  const mainTRC = 2.4; // 2.4 exponent emulates actual monitor perception
+   const sRco = 0.2126729,
+        sGco = 0.7151522,
+        sBco = 0.0721750; // sRGB coefficients
+        */
+  // Future:
+  // 0.2126478133913640	0.7151791475336150	0.0721730390750208
+  // Derived from:
+  // xW	yW	K	xR	yR	xG	yG	xB	yB
+  // 0.312720	0.329030	6504	0.640	0.330	0.300	0.600	0.150	0.060
+
+  // linearize r, g, or b then apply coefficients
+  // and sum then return the resulting luminance
+
+  function simpleExp(chan) {
+    return Math.pow(chan / 255.0, SA98G.mainTRC);
+  }
+  return SA98G.sRco * simpleExp(rgb[0]) + SA98G.sGco * simpleExp(rgb[1]) + SA98G.sBco * simpleExp(rgb[2]);
+}
+export function APCAcontrast(txtY, bgY) {
+  let places = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : -1;
+  // send linear Y (luminance) for text and background.
+  // txtY and bgY must be between 0.0-1.0
+  // IMPORTANT: Do not swap, polarity is important.
+
+  const icp = [0.0, 1.1]; // input range clamp / input error check
+
+  if (isNaN(txtY) || isNaN(bgY) || Math.min(txtY, bgY) < icp[0] || Math.max(txtY, bgY) > icp[1]) {
+    return 0.0; // return zero on error
+    // return 'error'; // optional string return for error
+  }
+
+  //////////   SAPC LOCAL VARS   /////////////////////////////////////////
+
+  let SAPC = 0.0; // For raw SAPC values
+  let outputContrast = 0.0; // For weighted final values
+  let polCat = 'BoW'; // Alternate Polarity Indicator. N normal R reverse
+
+  // TUTORIAL
+
+  // Use Y for text and BG, and soft clamp black,
+  // return 0 for very close luminances, determine
+  // polarity, and calculate SAPC raw contrast
+  // Then scale for easy to remember levels.
+
+  // Note that reverse contrast (white text on black)
+  // intentionally returns a negative number
+  // Proper polarity is important!
+
+  //////////   BLACK SOFT CLAMP   ////////////////////////////////////////
+
+  // Soft clamps Y for either color if it is near black.
+  txtY = txtY > SA98G.blkThrs ? txtY : txtY + Math.pow(SA98G.blkThrs - txtY, SA98G.blkClmp);
+  bgY = bgY > SA98G.blkThrs ? bgY : bgY + Math.pow(SA98G.blkThrs - bgY, SA98G.blkClmp);
+
+  ///// Return 0 Early for extremely low ∆Y
+  if (Math.abs(bgY - txtY) < SA98G.deltaYmin) {
+    return 0.0;
+  }
+
+  //////////   APCA/SAPC CONTRAST - LOW CLIP (W3 LICENSE)  ///////////////
+
+  if (bgY > txtY) {
+    // For normal polarity, black text on white (BoW)
+
+    // Calculate the SAPC contrast value and scale
+    SAPC = (Math.pow(bgY, SA98G.normBG) - Math.pow(txtY, SA98G.normTXT)) * SA98G.scaleBoW;
+
+    // Low Contrast smooth rollout to prevent polarity reversal
+    // and also a low-clip for very low contrasts
+    outputContrast = SAPC < SA98G.loClip ? 0.0 : SAPC - SA98G.loBoWoffset;
+  } else {
+    // For reverse polarity, light text on dark (WoB)
+    // WoB should always return negative value.
+    polCat = 'WoB';
+    SAPC = (Math.pow(bgY, SA98G.revBG) - Math.pow(txtY, SA98G.revTXT)) * SA98G.scaleWoB;
+    outputContrast = SAPC > -SA98G.loClip ? 0.0 : SAPC + SA98G.loWoBoffset;
+  }
+
+  // return Lc (lightness contrast) as a signed numeric value
+  // Round to the nearest whole number as string is optional.
+  // Rounded can be a signed INT as output will be within ± 127
+  // places = -1 returns signed float, 1 or more set that many places
+  // 0 returns rounded string, uses BoW or WoB instead of minus sign
+
+  if (places < 0) {
+    // Default (-1) number out, all others are strings
+    return outputContrast * 100.0;
+  } else if (places == 0) {
+    return Math.round(Math.abs(outputContrast) * 100.0) + '<sub>' + polCat + '</sub>';
+  } else if (Number.isInteger(places)) {
+    return (outputContrast * 100.0).toFixed(places);
+  } else {
+    return 0.0;
+  }
+}
+
+// send rgba array for text/icon, rgb for background.
+// Only foreground allows alpha of 0.0 to 1.0
+// This blends using gamma encoded space (standard)
+// rounded 0-255 or set round=false for number 0.0-255.0
+export function alphaBlend() {
+  let rgbaFG = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [0, 0, 0, 1.0];
+  let rgbBG = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [0, 0, 0];
+  let round = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : true;
+  rgbaFG[3] = Math.max(Math.min(rgbaFG[3], 1.0), 0.0); // clamp alpha 0-1
+  let compBlend = 1.0 - rgbaFG[3];
+  let rgbOut = [0, 0, 0, 1, true]; // or just use rgbBG to retain other elements?
+
+  for (let i = 0; i < 3; i++) {
+    rgbOut[i] = rgbBG[i] * compBlend + rgbaFG[i] * rgbaFG[3];
+    if (round) rgbOut[i] = Math.min(Math.round(rgbOut[i]), 255);
+  }
+  return rgbOut;
+}
+//# sourceMappingURL=apca.js.map

package/lib/util/color/apca.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apca.js","names":["SA98G","mainTRC","mainTRCencode","sRco","sGco","sBco","normBG","normTXT","revTXT","revBG","blkThrs","blkClmp","scaleBoW","scaleWoB","loBoWoffset","loWoBoffset","deltaYmin","loClip","mFactor","mFactInv","mOffsetIn","mExpAdj","mExp","mOffsetOut","sRGBtoY","rgb","arguments","length","undefined","simpleExp","chan","Math","pow","APCAcontrast","txtY","bgY","places","icp","isNaN","min","max","SAPC","outputContrast","polCat","abs","round","Number","isInteger","toFixed","alphaBlend","rgbaFG","rgbBG","compBlend","rgbOut","i"],"sources":["../../../src/util/color/apca.ts"],"sourcesContent":["///////////////////////////////////////////////////////////////////////////////\n/** @preserve\n /////    SAPC APCA - Advanced Perceptual Contrast Algorithm\n /////           Beta 0.1.9 W3 • contrast function only\n /////           DIST: W3 • Revision date: July 3, 2022\n /////    Function to parse color values and determine Lc contrast\n /////    Copyright © 2019-2022 by Andrew Somers. All Rights Reserved.\n /////    LICENSE: W3 LICENSE\n /////    CONTACT: Please use the ISSUES or DISCUSSIONS tab at:\n /////    https://github.com/Myndex/SAPC-APCA/\n /////\n ///////////////////////////////////////////////////////////////////////////////\n /////\n /////    MINIMAL IMPORTS:\n /////      import { APCAcontrast, sRGBtoY, displayP3toY,\n/////               calcAPCA, fontLookupAPCA } from 'apca-w3';\n /////      import { colorParsley } from 'colorparsley';\n /////\n /////    FORWARD CONTRAST USAGE:\n /////      Lc = APCAcontrast( sRGBtoY( TEXTcolor ) , sRGBtoY( BACKGNDcolor ) );\n /////    Where the colors are sent as an rgba array [255,255,255,1]\n /////\n /////    Retrieving an array of font sizes for the contrast:\n /////      fontArray = fontLookupAPCA(Lc);\n /////\n /////    Live Demonstrator at https://www.myndex.com/APCA/\n // */\n///////////////////////////////////////////////////////////////////////////////\n\n/////  Module Scope Object Containing Constants  /////\n/////   APCA   0.0.98G - 4g - W3 Compatible Constants\n\n/////  𝒦 SA98G  ///////////////////////////////////\nconst SA98G = {\n  mainTRC: 2.4, // 2.4 exponent for emulating actual monitor perception\n\n  // For reverseAPCA\n  get mainTRCencode() {\n    return 1 / this.mainTRC;\n  },\n\n  // sRGB coefficients\n  sRco: 0.2126729,\n  sGco: 0.7151522,\n  sBco: 0.072175,\n\n  // G-4g constants for use with 2.4 exponent\n  normBG: 0.56,\n  normTXT: 0.57,\n  revTXT: 0.62,\n  revBG: 0.65,\n\n  // G-4g Clamps and Scalers\n  blkThrs: 0.022,\n  blkClmp: 1.414,\n  scaleBoW: 1.14,\n  scaleWoB: 1.14,\n  loBoWoffset: 0.027,\n  loWoBoffset: 0.027,\n  deltaYmin: 0.0005,\n  loClip: 0.1,\n\n  ///// MAGIC NUMBERS for UNCLAMP, for use with 0.022 & 1.414 /////\n  // Magic Numbers for reverseAPCA\n  mFactor: 1.9468554433171,\n  get mFactInv() {\n    return 1 / this.mFactor;\n  },\n  mOffsetIn: 0.0387393816571401,\n  mExpAdj: 0.283343396420869,\n  get mExp() {\n    return this.mExpAdj / this.blkClmp;\n  },\n  mOffsetOut: 0.312865795870758,\n};\n\n//////////////////////////////////////////////////////////////////////////////\n//////////  LUMINANCE CONVERTERS  |//////////////////////////////////////////\n\n//////////  ƒ  sRGBtoY()  //////////////////////////////////////////////////\nexport function sRGBtoY(rgb = [0, 0, 0]) {\n  // send sRGB 8bpc (0xFFFFFF) or string\n\n  // NOTE: Currently expects 0-255\n\n  /////   APCA   0.0.98G - 4g - W3 Compatible Constants   ////////////////////\n  /*\n  const mainTRC = 2.4; // 2.4 exponent emulates actual monitor perception\n\n  const sRco = 0.2126729,\n        sGco = 0.7151522,\n        sBco = 0.0721750; // sRGB coefficients\n        */\n  // Future:\n  // 0.2126478133913640\t0.7151791475336150\t0.0721730390750208\n  // Derived from:\n  // xW\tyW\tK\txR\tyR\txG\tyG\txB\tyB\n  // 0.312720\t0.329030\t6504\t0.640\t0.330\t0.300\t0.600\t0.150\t0.060\n\n  // linearize r, g, or b then apply coefficients\n  // and sum then return the resulting luminance\n\n  function simpleExp(chan: number) {\n    return Math.pow(chan / 255.0, SA98G.mainTRC);\n  }\n\n  return (\n    SA98G.sRco * simpleExp(rgb[0]) +\n    SA98G.sGco * simpleExp(rgb[1]) +\n    SA98G.sBco * simpleExp(rgb[2])\n  );\n}\n\nexport function APCAcontrast(txtY: number, bgY: number, places = -1) {\n  // send linear Y (luminance) for text and background.\n  // txtY and bgY must be between 0.0-1.0\n  // IMPORTANT: Do not swap, polarity is important.\n\n  const icp = [0.0, 1.1]; // input range clamp / input error check\n\n  if (\n    isNaN(txtY) ||\n    isNaN(bgY) ||\n    Math.min(txtY, bgY) < icp[0] ||\n    Math.max(txtY, bgY) > icp[1]\n  ) {\n    return 0.0; // return zero on error\n    // return 'error'; // optional string return for error\n  }\n\n  //////////   SAPC LOCAL VARS   /////////////////////////////////////////\n\n  let SAPC = 0.0; // For raw SAPC values\n  let outputContrast = 0.0; // For weighted final values\n  let polCat = 'BoW'; // Alternate Polarity Indicator. N normal R reverse\n\n  // TUTORIAL\n\n  // Use Y for text and BG, and soft clamp black,\n  // return 0 for very close luminances, determine\n  // polarity, and calculate SAPC raw contrast\n  // Then scale for easy to remember levels.\n\n  // Note that reverse contrast (white text on black)\n  // intentionally returns a negative number\n  // Proper polarity is important!\n\n  //////////   BLACK SOFT CLAMP   ////////////////////////////////////////\n\n  // Soft clamps Y for either color if it is near black.\n  txtY =\n    txtY > SA98G.blkThrs\n      ? txtY\n      : txtY + Math.pow(SA98G.blkThrs - txtY, SA98G.blkClmp);\n  bgY =\n    bgY > SA98G.blkThrs\n      ? bgY\n      : bgY + Math.pow(SA98G.blkThrs - bgY, SA98G.blkClmp);\n\n  ///// Return 0 Early for extremely low ∆Y\n  if (Math.abs(bgY - txtY) < SA98G.deltaYmin) {\n    return 0.0;\n  }\n\n  //////////   APCA/SAPC CONTRAST - LOW CLIP (W3 LICENSE)  ///////////////\n\n  if (bgY > txtY) {\n    // For normal polarity, black text on white (BoW)\n\n    // Calculate the SAPC contrast value and scale\n    SAPC =\n      (Math.pow(bgY, SA98G.normBG) - Math.pow(txtY, SA98G.normTXT)) *\n      SA98G.scaleBoW;\n\n    // Low Contrast smooth rollout to prevent polarity reversal\n    // and also a low-clip for very low contrasts\n    outputContrast = SAPC < SA98G.loClip ? 0.0 : SAPC - SA98G.loBoWoffset;\n  } else {\n    // For reverse polarity, light text on dark (WoB)\n    // WoB should always return negative value.\n    polCat = 'WoB';\n\n    SAPC =\n      (Math.pow(bgY, SA98G.revBG) - Math.pow(txtY, SA98G.revTXT)) *\n      SA98G.scaleWoB;\n\n    outputContrast = SAPC > -SA98G.loClip ? 0.0 : SAPC + SA98G.loWoBoffset;\n  }\n\n  // return Lc (lightness contrast) as a signed numeric value\n  // Round to the nearest whole number as string is optional.\n  // Rounded can be a signed INT as output will be within ± 127\n  // places = -1 returns signed float, 1 or more set that many places\n  // 0 returns rounded string, uses BoW or WoB instead of minus sign\n\n  if (places < 0) {\n    // Default (-1) number out, all others are strings\n    return outputContrast * 100.0;\n  } else if (places == 0) {\n    return (\n      Math.round(Math.abs(outputContrast) * 100.0) + '<sub>' + polCat + '</sub>'\n    );\n  } else if (Number.isInteger(places)) {\n    return (outputContrast * 100.0).toFixed(places);\n  } else {\n    return 0.0;\n  }\n}\n\n// send rgba array for text/icon, rgb for background.\n// Only foreground allows alpha of 0.0 to 1.0\n// This blends using gamma encoded space (standard)\n// rounded 0-255 or set round=false for number 0.0-255.0\nexport function alphaBlend(\n  rgbaFG = [0, 0, 0, 1.0],\n  rgbBG = [0, 0, 0],\n  round = true,\n) {\n  rgbaFG[3] = Math.max(Math.min(rgbaFG[3], 1.0), 0.0); // clamp alpha 0-1\n  let compBlend = 1.0 - rgbaFG[3];\n  let rgbOut = [0, 0, 0, 1, true]; // or just use rgbBG to retain other elements?\n\n  for (let i = 0; i < 3; i++) {\n    rgbOut[i] = rgbBG[i] * compBlend + rgbaFG[i] * rgbaFG[3];\n    if (round) rgbOut[i] = Math.min(Math.round(rgbOut[i] as number), 255);\n  }\n  return rgbOut;\n}\n"],"mappings":"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"}

package/lib/util/color/const.js

@@ -0,0 +1,6 @@
+export const RGBA_REGEX = /rgb(a?)\((?<v>.*)\)/;
+export const HEX_COLOR_REGEX = /^#([A-Fa-f0-9]{3}|[A-Fa-f0-9]{6}|[A-Fa-f0-9]{8})$/;
+export const SRGB_TO_XYZ = [[0.41233895, 0.35762064, 0.18051042], [0.2126, 0.7152, 0.0722], [0.01932141, 0.11916382, 0.95034478]];
+export const XYZ_TO_SRGB = [[3.2413774792388685, -1.5376652402851851, -0.49885366846268053], [-0.9691452513005321, 1.8758853451067872, 0.04156585616912061], [0.05562093689691305, -0.20395524564742123, 1.0571799111220335]];
+export const WHITE_POINT_D65 = [95.047, 100.0, 108.883];
+//# sourceMappingURL=const.js.map

package/lib/util/color/const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"const.js","names":["RGBA_REGEX","HEX_COLOR_REGEX","SRGB_TO_XYZ","XYZ_TO_SRGB","WHITE_POINT_D65"],"sources":["../../../src/util/color/const.ts"],"sourcesContent":["export const RGBA_REGEX = /rgb(a?)\\((?<v>.*)\\)/;\r\nexport const HEX_COLOR_REGEX = /^#([A-Fa-f0-9]{3}|[A-Fa-f0-9]{6}|[A-Fa-f0-9]{8})$/;\r\n\r\nexport const SRGB_TO_XYZ = [\r\n  [0.41233895, 0.35762064, 0.18051042],\r\n  [0.2126, 0.7152, 0.0722],\r\n  [0.01932141, 0.11916382, 0.95034478],\r\n];\r\n\r\nexport const XYZ_TO_SRGB = [\r\n  [\r\n    3.2413774792388685,\r\n    -1.5376652402851851,\r\n    -0.49885366846268053,\r\n  ],\r\n  [\r\n    -0.9691452513005321,\r\n    1.8758853451067872,\r\n    0.04156585616912061,\r\n  ],\r\n  [\r\n    0.05562093689691305,\r\n    -0.20395524564742123,\r\n    1.0571799111220335,\r\n  ],\r\n];\r\n\r\nexport const WHITE_POINT_D65 = [95.047, 100.0, 108.883];\r\n"],"mappings":"AAAA,OAAO,MAAMA,UAAU,GAAG,qBAAqB;AAC/C,OAAO,MAAMC,eAAe,GAAG,mDAAmD;AAElF,OAAO,MAAMC,WAAW,GAAG,CACzB,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,EACpC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACxB,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,CACrC;AAED,OAAO,MAAMC,WAAW,GAAG,CACzB,CACE,kBAAkB,EAClB,CAAC,kBAAkB,EACnB,CAAC,mBAAmB,CACrB,EACD,CACE,CAAC,kBAAkB,EACnB,kBAAkB,EAClB,mBAAmB,CACpB,EACD,CACE,mBAAmB,EACnB,CAAC,mBAAmB,EACpB,kBAAkB,CACnB,CACF;AAED,OAAO,MAAMC,eAAe,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC"}

package/lib/util/color/contrast/contrast.js

@@ -0,0 +1,149 @@
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { lstarFromY, yFromLstar } from "../conversion.js";
+import { clampDouble } from "../utils/math-utils.js";
+/**
+ * Utility methods for calculating contrast given two colors, or calculating a
+ * color given one color and a contrast ratio.
+ *
+ * Contrast ratio is calculated using XYZ's Y. When linearized to match human
+ * perception, Y becomes HCT's tone and L*a*b*'s' L*. Informally, this is the
+ * lightness of a color.
+ *
+ * Methods refer to tone, T in the the HCT color space.
+ * Tone is equivalent to L* in the L*a*b* color space, or L in the LCH color
+ * space.
+ */
+export class Contrast {
+  /**
+   * Returns a contrast ratio, which ranges from 1 to 21.
+   *
+   * @param toneA Tone between 0 and 100. Values outside will be clamped.
+   * @param toneB Tone between 0 and 100. Values outside will be clamped.
+   */
+  static ratioOfTones(toneA, toneB) {
+    toneA = clampDouble(0.0, 100.0, toneA);
+    toneB = clampDouble(0.0, 100.0, toneB);
+    return Contrast.ratioOfYs(yFromLstar(toneA), yFromLstar(toneB));
+  }
+  static ratioOfYs(y1, y2) {
+    const lighter = y1 > y2 ? y1 : y2;
+    const darker = lighter === y2 ? y1 : y2;
+    return (lighter + 5.0) / (darker + 5.0);
+  }
+
+  /**
+   * Returns a tone >= tone parameter that ensures ratio parameter.
+   * Return value is between 0 and 100.
+   * Returns -1 if ratio cannot be achieved with tone parameter.
+   *
+   * @param tone Tone return value must contrast with.
+   * Range is 0 to 100. Invalid values will result in -1 being returned.
+   * @param ratio Contrast ratio of return value and tone.
+   * Range is 1 to 21, invalid values have undefined behavior.
+   */
+  static lighter(tone, ratio) {
+    if (tone < 0.0 || tone > 100.0) {
+      return -1.0;
+    }
+    const darkY = yFromLstar(tone);
+    const lightY = ratio * (darkY + 5.0) - 5.0;
+    const realContrast = Contrast.ratioOfYs(lightY, darkY);
+    const delta = Math.abs(realContrast - ratio);
+    if (realContrast < ratio && delta > 0.04) {
+      return -1;
+    }
+
+    // Ensure gamut mapping, which requires a 'range' on tone, will still result
+    // the correct ratio by darkening slightly.
+    const returnValue = lstarFromY(lightY) + 0.4;
+    if (returnValue < 0 || returnValue > 100) {
+      return -1;
+    }
+    return returnValue;
+  }
+
+  /**
+   * Returns a tone <= tone parameter that ensures ratio parameter.
+   * Return value is between 0 and 100.
+   * Returns -1 if ratio cannot be achieved with tone parameter.
+   *
+   * @param tone Tone return value must contrast with.
+   * Range is 0 to 100. Invalid values will result in -1 being returned.
+   * @param ratio Contrast ratio of return value and tone.
+   * Range is 1 to 21, invalid values have undefined behavior.
+   */
+  static darker(tone, ratio) {
+    if (tone < 0.0 || tone > 100.0) {
+      return -1.0;
+    }
+    const lightY = yFromLstar(tone);
+    const darkY = (lightY + 5.0) / ratio - 5.0;
+    const realContrast = Contrast.ratioOfYs(lightY, darkY);
+    const delta = Math.abs(realContrast - ratio);
+    if (realContrast < ratio && delta > 0.04) {
+      return -1;
+    }
+
+    // Ensure gamut mapping, which requires a 'range' on tone, will still result
+    // the correct ratio by darkening slightly.
+    const returnValue = lstarFromY(darkY) - 0.4;
+    if (returnValue < 0 || returnValue > 100) {
+      return -1;
+    }
+    return returnValue;
+  }
+
+  /**
+   * Returns a tone >= tone parameter that ensures ratio parameter.
+   * Return value is between 0 and 100.
+   * Returns 100 if ratio cannot be achieved with tone parameter.
+   *
+   * This method is unsafe because the returned value is guaranteed to be in
+   * bounds for tone, i.e. between 0 and 100. However, that value may not reach
+   * the ratio with tone. For example, there is no color lighter than T100.
+   *
+   * @param tone Tone return value must contrast with.
+   * Range is 0 to 100. Invalid values will result in 100 being returned.
+   * @param ratio Desired contrast ratio of return value and tone parameter.
+   * Range is 1 to 21, invalid values have undefined behavior.
+   */
+  static lighterUnsafe(tone, ratio) {
+    const lighterSafe = Contrast.lighter(tone, ratio);
+    return lighterSafe < 0.0 ? 100.0 : lighterSafe;
+  }
+
+  /**
+   * Returns a tone >= tone parameter that ensures ratio parameter.
+   * Return value is between 0 and 100.
+   * Returns 100 if ratio cannot be achieved with tone parameter.
+   *
+   * This method is unsafe because the returned value is guaranteed to be in
+   * bounds for tone, i.e. between 0 and 100. However, that value may not reach
+   * the [ratio with [tone]. For example, there is no color darker than T0.
+   *
+   * @param tone Tone return value must contrast with.
+   * Range is 0 to 100. Invalid values will result in 0 being returned.
+   * @param ratio Desired contrast ratio of return value and tone parameter.
+   * Range is 1 to 21, invalid values have undefined behavior.
+   */
+  static darkerUnsafe(tone, ratio) {
+    const darkerSafe = Contrast.darker(tone, ratio);
+    return darkerSafe < 0.0 ? 0.0 : darkerSafe;
+  }
+}
+//# sourceMappingURL=contrast.js.map

package/lib/util/color/contrast/contrast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.js","names":["lstarFromY","yFromLstar","clampDouble","Contrast","ratioOfTones","toneA","toneB","ratioOfYs","y1","y2","lighter","darker","tone","ratio","darkY","lightY","realContrast","delta","Math","abs","returnValue","lighterUnsafe","lighterSafe","darkerUnsafe","darkerSafe"],"sources":["../../../../src/util/color/contrast/contrast.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2022 Google LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *      http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { lstarFromY, yFromLstar } from '../conversion';\nimport { clampDouble } from '../utils/math-utils';\n\n/**\n * Utility methods for calculating contrast given two colors, or calculating a\n * color given one color and a contrast ratio.\n *\n * Contrast ratio is calculated using XYZ's Y. When linearized to match human\n * perception, Y becomes HCT's tone and L*a*b*'s' L*. Informally, this is the\n * lightness of a color.\n *\n * Methods refer to tone, T in the the HCT color space.\n * Tone is equivalent to L* in the L*a*b* color space, or L in the LCH color\n * space.\n */\nexport class Contrast {\n  /**\n   * Returns a contrast ratio, which ranges from 1 to 21.\n   *\n   * @param toneA Tone between 0 and 100. Values outside will be clamped.\n   * @param toneB Tone between 0 and 100. Values outside will be clamped.\n   */\n  static ratioOfTones(toneA: number, toneB: number): number {\n    toneA = clampDouble(0.0, 100.0, toneA);\n    toneB = clampDouble(0.0, 100.0, toneB);\n    return Contrast.ratioOfYs(yFromLstar(toneA), yFromLstar(toneB));\n  }\n\n  static ratioOfYs(y1: number, y2: number): number {\n    const lighter = y1 > y2 ? y1 : y2;\n    const darker = lighter === y2 ? y1 : y2;\n    return (lighter + 5.0) / (darker + 5.0);\n  }\n\n  /**\n   * Returns a tone >= tone parameter that ensures ratio parameter.\n   * Return value is between 0 and 100.\n   * Returns -1 if ratio cannot be achieved with tone parameter.\n   *\n   * @param tone Tone return value must contrast with.\n   * Range is 0 to 100. Invalid values will result in -1 being returned.\n   * @param ratio Contrast ratio of return value and tone.\n   * Range is 1 to 21, invalid values have undefined behavior.\n   */\n  static lighter(tone: number, ratio: number): number {\n    if (tone < 0.0 || tone > 100.0) {\n      return -1.0;\n    }\n\n    const darkY = yFromLstar(tone);\n    const lightY = ratio * (darkY + 5.0) - 5.0;\n    const realContrast = Contrast.ratioOfYs(lightY, darkY);\n    const delta = Math.abs(realContrast - ratio);\n    if (realContrast < ratio && delta > 0.04) {\n      return -1;\n    }\n\n    // Ensure gamut mapping, which requires a 'range' on tone, will still result\n    // the correct ratio by darkening slightly.\n    const returnValue = lstarFromY(lightY) + 0.4;\n    if (returnValue < 0 || returnValue > 100) {\n      return -1;\n    }\n    return returnValue;\n  }\n\n  /**\n   * Returns a tone <= tone parameter that ensures ratio parameter.\n   * Return value is between 0 and 100.\n   * Returns -1 if ratio cannot be achieved with tone parameter.\n   *\n   * @param tone Tone return value must contrast with.\n   * Range is 0 to 100. Invalid values will result in -1 being returned.\n   * @param ratio Contrast ratio of return value and tone.\n   * Range is 1 to 21, invalid values have undefined behavior.\n   */\n  static darker(tone: number, ratio: number): number {\n    if (tone < 0.0 || tone > 100.0) {\n      return -1.0;\n    }\n\n    const lightY = yFromLstar(tone);\n    const darkY = (lightY + 5.0) / ratio - 5.0;\n    const realContrast = Contrast.ratioOfYs(lightY, darkY);\n\n    const delta = Math.abs(realContrast - ratio);\n    if (realContrast < ratio && delta > 0.04) {\n      return -1;\n    }\n\n    // Ensure gamut mapping, which requires a 'range' on tone, will still result\n    // the correct ratio by darkening slightly.\n    const returnValue = lstarFromY(darkY) - 0.4;\n    if (returnValue < 0 || returnValue > 100) {\n      return -1;\n    }\n    return returnValue;\n  }\n\n  /**\n   * Returns a tone >= tone parameter that ensures ratio parameter.\n   * Return value is between 0 and 100.\n   * Returns 100 if ratio cannot be achieved with tone parameter.\n   *\n   * This method is unsafe because the returned value is guaranteed to be in\n   * bounds for tone, i.e. between 0 and 100. However, that value may not reach\n   * the ratio with tone. For example, there is no color lighter than T100.\n   *\n   * @param tone Tone return value must contrast with.\n   * Range is 0 to 100. Invalid values will result in 100 being returned.\n   * @param ratio Desired contrast ratio of return value and tone parameter.\n   * Range is 1 to 21, invalid values have undefined behavior.\n   */\n  static lighterUnsafe(tone: number, ratio: number): number {\n    const lighterSafe = Contrast.lighter(tone, ratio);\n    return lighterSafe < 0.0 ? 100.0 : lighterSafe;\n  }\n\n  /**\n   * Returns a tone >= tone parameter that ensures ratio parameter.\n   * Return value is between 0 and 100.\n   * Returns 100 if ratio cannot be achieved with tone parameter.\n   *\n   * This method is unsafe because the returned value is guaranteed to be in\n   * bounds for tone, i.e. between 0 and 100. However, that value may not reach\n   * the [ratio with [tone]. For example, there is no color darker than T0.\n   *\n   * @param tone Tone return value must contrast with.\n   * Range is 0 to 100. Invalid values will result in 0 being returned.\n   * @param ratio Desired contrast ratio of return value and tone parameter.\n   * Range is 1 to 21, invalid values have undefined behavior.\n   */\n  static darkerUnsafe(tone: number, ratio: number): number {\n    const darkerSafe = Contrast.darker(tone, ratio);\n    return darkerSafe < 0.0 ? 0.0 : darkerSafe;\n  }\n}\n"],"mappings":"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"}