@nokecy/qc-ui 1.1.73 → 1.1.75

package/dist/esm/readPretty/selectValue.js

@@ -0,0 +1,53 @@
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+import { isValidElement } from 'react';
+
+/** 提取选择项的标量编码，兼容嵌套 labelInValue；保留编码 0 和显式空字符串选项。@author nokecy */
+export function selectCode(value) {
+  var depth = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
+  if (typeof value === 'string') return value;
+  if (typeof value === 'number') return Number.isFinite(value) ? value : undefined;
+  if (!value || _typeof(value) !== 'object' || depth >= 8 || /*#__PURE__*/isValidElement(value)) return undefined;
+  return selectCode(value.value, depth + 1);
+}
+
+/** 标签只输出可渲染内容；选择项对象取名称后再回落编码，避免 React 对象子节点异常。@author nokecy */
+export function selectLabel(value) {
+  var _selectLabel;
+  var depth = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
+  if (value == null || typeof value === 'boolean' || depth >= 8) return undefined;
+  if (typeof value === 'string' || typeof value === 'number' || /*#__PURE__*/isValidElement(value)) return value;
+  if (Array.isArray(value)) return value.map(function (item) {
+    return selectLabel(item, depth + 1);
+  });
+  if (_typeof(value) !== 'object') return undefined;
+  var item = value;
+  return (_selectLabel = selectLabel(item.label, depth + 1)) !== null && _selectLabel !== void 0 ? _selectLabel : selectLabel(item.value, depth + 1);
+}
+
+/** 单选、多选与阅读态共用同一值形状；名称缺省时保留组件按选项查名称的行为。@author nokecy */
+export function normalizeSelectValue(value, labelInValue) {
+  var _selectLabel2;
+  if (Array.isArray(value)) return value.map(function (item) {
+    return normalizeSelectValue(item, labelInValue);
+  }).filter(function (item) {
+    return item !== undefined;
+  });
+  var code = selectCode(value);
+  if (code === undefined) return undefined;
+  if (!labelInValue) return code;
+  if (!value || _typeof(value) !== 'object') return {
+    value: code
+  };
+  var item = value;
+  var label = (_selectLabel2 = selectLabel(item.label)) !== null && _selectLabel2 !== void 0 ? _selectLabel2 : _typeof(item.value) === 'object' ? selectLabel(item.value) : undefined;
+  return _objectSpread({
+    value: code
+  }, label !== undefined ? {
+    label: label
+  } : {});
+}

package/dist/esm/readPretty/values.d.ts

@@ -0,0 +1,4 @@
+/** 阅读态选择项展开，保留分组内选项及自定义字段名。@author nokecy */
+export declare function flattenOptions(options?: any[], fieldNames?: any): any[];
+/** 保留0和空选项标签；有 labelInValue 时优先使用已加载的名称。@author nokecy */
+export declare function selectedLabels(value: any, options: any[], labelInValue?: boolean): any;

package/dist/esm/readPretty/values.js

@@ -0,0 +1,43 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+import { normalizeSelectValue, selectLabel } from "./selectValue";
+
+/** 阅读态选择项展开，保留分组内选项及自定义字段名。@author nokecy */
+export function flattenOptions() {
+  var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
+  var fieldNames = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  var _ref = fieldNames || {},
+    _ref$label = _ref.label,
+    label = _ref$label === void 0 ? 'label' : _ref$label,
+    _ref$value = _ref.value,
+    value = _ref$value === void 0 ? 'value' : _ref$value,
+    _ref$options = _ref.options,
+    children = _ref$options === void 0 ? 'options' : _ref$options;
+  return options.flatMap(function (option) {
+    return _typeof(option) === 'object' && option !== null ? option[children] ? flattenOptions(option[children], fieldNames) : [{
+      value: option[value],
+      label: option[label]
+    }] : [{
+      value: option,
+      label: option
+    }];
+  });
+}
+
+/** 保留0和空选项标签；有 labelInValue 时优先使用已加载的名称。@author nokecy */
+export function selectedLabels(value, options, labelInValue) {
+  if (value == null || value === '' || Array.isArray(value) && !value.length) return '—';
+  var normalized = labelInValue ? normalizeSelectValue(value, true) : value;
+  var values = Array.isArray(normalized) ? normalized : normalized == null ? [] : [normalized];
+  if (!values.length) return '—';
+  var labels = values.map(function (item) {
+    var _ref2, _selectLabel, _options$find, _item$label;
+    var raw = labelInValue ? item.value : item;
+    return (_ref2 = (_selectLabel = selectLabel((_options$find = options.find(function (option) {
+      return option.value === raw;
+    })) === null || _options$find === void 0 ? void 0 : _options$find.label)) !== null && _selectLabel !== void 0 ? _selectLabel : selectLabel(labelInValue ? (_item$label = item.label) !== null && _item$label !== void 0 ? _item$label : raw : raw)) !== null && _ref2 !== void 0 ? _ref2 : '—';
+  });
+  // 选项标签可以是React节点，交由调用组件按顺序渲染。
+  return labels.flatMap(function (label, index) {
+    return index ? ['、', label] : [label];
+  });
+}

package/dist/esm/toolBar/index.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
 import './index.less';
+/** 详情、表单共用工具栏：按实际操作元素统一留出间距，宽度不足时换行。@author nokecy */
 declare const ToolBar: (props: any) => React.JSX.Element;
 export default ToolBar;

package/dist/esm/toolBar/index.js

@@ -1,28 +1,61 @@
-var _excluded = ["children", "className", "extra", "style", "renderContent", "getTargetContainer"];
+var _excluded = ["children", "className", "extra", "identity", "banner", "style", "renderContent", "getTargetContainer"];
 function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
 function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
-import React from 'react';
-import { Affix, Space } from 'antd';
+import React, { useCallback, useRef } from 'react';
+import { Affix, theme } from 'antd';
 import "./index.less";
+
+/** 详情、表单共用工具栏：按实际操作元素统一留出间距，宽度不足时换行。@author nokecy */
 var ToolBar = function ToolBar(props) {
   var children = props.children,
     className = props.className,
     extra = props.extra,
+    identity = props.identity,
+    banner = props.banner,
     style = props.style,
     renderContent = props.renderContent,
     getTargetContainer = props.getTargetContainer,
     restProps = _objectWithoutProperties(props, _excluded);
+  var _theme$useToken = theme.useToken(),
+    token = _theme$useToken.token; // 单据操作栏跟随宿主主题。@author nokecy
+  var barRef = useRef(null);
+  // @author nokecy：KeepAlive 内容区独立滚动，吸顶应相对其视口，避免定位到应用顶栏下面。
+  var defaultTarget = useCallback(function () {
+    var _barRef$current$paren, _barRef$current;
+    var parent = (_barRef$current$paren = (_barRef$current = barRef.current) === null || _barRef$current === void 0 ? void 0 : _barRef$current.parentElement) !== null && _barRef$current$paren !== void 0 ? _barRef$current$paren : null;
+    while (parent) {
+      if (/auto|scroll/.test(getComputedStyle(parent).overflowY)) return parent;
+      parent = parent.parentElement;
+    }
+    return window;
+  }, []);
   return /*#__PURE__*/React.createElement(Affix, {
     offsetTop: 2,
     style: style,
     offsetBottom: 2,
-    target: getTargetContainer
+    target: getTargetContainer || defaultTarget
   }, /*#__PURE__*/React.createElement("div", {
-    className: "antd-tool-bar"
-  }, /*#__PURE__*/React.createElement("div", {
-    className: "antd-tool-bar-left".trim()
-  }, /*#__PURE__*/React.createElement(Space, null, extra)), /*#__PURE__*/React.createElement("div", {
-    className: "antd-tool-bar-right".trim()
-  }, /*#__PURE__*/React.createElement(Space, null, children))));
+    ref: barRef,
+    className: "antd-tool-bar",
+    style: {
+      backgroundColor: token.colorBgContainer,
+      color: token.colorText,
+      borderBlockStartColor: token.colorBorderSecondary,
+      gap: token.marginXS,
+      paddingBlock: token.paddingXXS
+    }
+  }, banner && /*#__PURE__*/React.createElement("div", {
+    className: "antd-tool-bar-banner"
+  }, banner), /*#__PURE__*/React.createElement("div", {
+    className: "antd-tool-bar-left",
+    style: {
+      gap: token.marginXS
+    }
+  }, extra, identity), /*#__PURE__*/React.createElement("div", {
+    className: "antd-tool-bar-right",
+    style: {
+      gap: token.marginXS
+    }
+  }, children)));
 };
 export default ToolBar;

package/dist/esm/toolBar/index.less

@@ -1,25 +1,43 @@
 .antd-tool-bar {
 	display: flex;
+	flex-wrap: wrap;
 	align-items: center;
 	box-sizing: border-box;
 	width: 100%;
-	color: rgba(0, 0, 0, 0.88);
 	line-height: 40px;
-	background-color: rgba(255, 255, 255);
-	-webkit-backdrop-filter: blur(8px);
+	backdrop-filter: blur(8px);
 	backdrop-filter: blur(8px);
 	transition: all 0.2s ease 0s;
 	inset-inline-end: 0;
 	padding-inline: 16px;
 	padding-block: 0;
-	border-block-start: 1px solid rgba(5, 5, 5, 0.06);
+	// 颜色由组件读取主题 token；子区域继承正文色。
+	border-block-start: 1px solid;
+}
+
+.antd-tool-bar-banner {
+	flex: 1 0 100%;
+	min-width: 0;
+	line-height: normal;
 }
 
 .antd-tool-bar-left {
-	flex: 1;
-	color: rgba(0, 0, 0, 0.88);
+	flex: 1 0 auto;
+	color: inherit;
+}
+
+.antd-tool-bar-right {
+	margin-inline-start: auto;
+	justify-content: flex-end;
+    color: inherit;
 }
 
+/* 直接排列组件输出的按钮，React Fragment 内的按钮也获得相同间距。@author nokecy */
+.antd-tool-bar-left,
 .antd-tool-bar-right {
-    color: rgba(0, 0, 0, 0.88);
+	display: flex;
+	flex-wrap: wrap;
+	align-items: center;
+	min-width: 0;
+	max-width: 100%;
 }

package/dist/esm/utils/businessDecimal.d.ts

@@ -0,0 +1,11 @@
+import Decimal from 'decimal.js';
+/** 业务值保留十进制文本，运算使用十进制库；整型标识和时间不经过此入口。@author nokecy */
+export declare const BusinessDecimal: typeof Decimal;
+export type DecimalValue = string | number | Decimal | null | undefined;
+export declare const decimal: (value: DecimalValue) => Decimal;
+export declare const decimalText: (value: DecimalValue) => string;
+export declare const nonNegativeDecimal: (value: DecimalValue) => string;
+export declare const roundDecimal: (value: DecimalValue, places: number) => string;
+export declare const sumDecimals: (values: DecimalValue[]) => string;
+/** 指定取位规则显示，千分位直接处理文本，不转换为 JavaScript number。@author nokecy */
+export declare const formatDecimal: (value: DecimalValue, places?: number, minimumPlaces?: number) => string;

package/dist/esm/utils/businessDecimal.js

@@ -0,0 +1,47 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import Decimal from 'decimal.js';
+
+/** 业务值保留十进制文本，运算使用十进制库；整型标识和时间不经过此入口。@author nokecy */
+export var BusinessDecimal = Decimal.clone({
+  precision: 64,
+  rounding: Decimal.ROUND_HALF_UP,
+  toExpNeg: -64,
+  toExpPos: 64
+});
+export var decimal = function decimal(value) {
+  return new BusinessDecimal(value == null || value === '' ? '0' : value);
+};
+export var decimalText = function decimalText(value) {
+  return decimal(value).toFixed();
+};
+export var nonNegativeDecimal = function nonNegativeDecimal(value) {
+  return BusinessDecimal.max(0, decimal(value)).toFixed();
+};
+export var roundDecimal = function roundDecimal(value, places) {
+  return decimal(value).toDecimalPlaces(places).toFixed();
+};
+export var sumDecimals = function sumDecimals(values) {
+  return values.reduce(function (sum, value) {
+    return sum.plus(decimal(value));
+  }, decimal('0')).toFixed();
+};
+
+/** 指定取位规则显示，千分位直接处理文本，不转换为 JavaScript number。@author nokecy */
+export var formatDecimal = function formatDecimal(value) {
+  var places = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 6;
+  var minimumPlaces = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 0;
+  if (value == null || value === '') return '';
+  var _decimal$toFixed$spli = decimal(value).toFixed(places).split('.'),
+    _decimal$toFixed$spli2 = _slicedToArray(_decimal$toFixed$spli, 2),
+    integer = _decimal$toFixed$spli2[0],
+    _decimal$toFixed$spli3 = _decimal$toFixed$spli2[1],
+    fraction = _decimal$toFixed$spli3 === void 0 ? '' : _decimal$toFixed$spli3;
+  while (fraction.length > minimumPlaces && fraction.endsWith('0')) fraction = fraction.slice(0, -1);
+  integer = integer.replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+  return fraction ? "".concat(integer, ".").concat(fraction) : integer;
+};

package/dist/esm/utils/contrast.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 对比度计算与「够读的主色」派生。
+ *
+ * 背景：品牌绿 #00b96b 落在白底上只有 2.58:1，而正文文字要 4.5:1、非文本要 3:1（WCAG 2.1）。
+ * antd 从它派生的最深一档 colorPrimaryActive 也只有 3.90:1——够非文本，够不到文字。
+ * 所以菜单选中态、行内操作按钮这些「用主色写字」的地方，靠 antd 自带档位解决不了。
+ *
+ * 这里按色相不变、只压明度的方式派生出刚好达标的一档：绿还是那个绿，但读得清。
+ * 写成纯函数而不是写死一个色值，是因为四个客户各有各的主色，写死就只对信诚成立。
+ *
+ * 验收方法沿用登录页复核那套：实测计算，不看源码想当然。
+ *
+ * @author nokecy
+ */
+/** hex -> [r, g, b]，每项 0~255。 */
+export declare function toRgb(hex: string): [number, number, number];
+/** WCAG 相对亮度。 */
+export declare function relativeLuminance(hex: string): number;
+/** WCAG 对比度，1 ~ 21。 */
+export declare function contrastRatio(a: string, b: string): number;
+/** hex -> [h(0~360), s(0~1), l(0~1)]。 */
+export declare function toHsl(hex: string): [number, number, number];
+/** [h, s, l] -> hex。 */
+export declare function fromHsl(h: number, s: number, l: number): string;
+/**
+ * 压暗到刚好满足对比度要求的一档，色相与饱和度保持不变。
+ *
+ * @param hex     起始色（通常是品牌主色）
+ * @param against 要压在什么底色上，默认白底
+ * @param min     目标对比度，正文 4.5、非文本 3
+ */
+export declare function darkenUntilContrast(hex: string, { against, min }?: {
+    against?: string | undefined;
+    min?: number | undefined;
+}): string;
+/** 深色表面上的文字保持色相，提亮至正文对比度。@author nokecy */
+export declare function lightenUntilContrast(hex: string, { against, min }?: {
+    against?: string | undefined;
+    min?: number | undefined;
+}): string;

package/dist/esm/utils/contrast.js

@@ -0,0 +1,141 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+/**
+ * 对比度计算与「够读的主色」派生。
+ *
+ * 背景：品牌绿 #00b96b 落在白底上只有 2.58:1，而正文文字要 4.5:1、非文本要 3:1（WCAG 2.1）。
+ * antd 从它派生的最深一档 colorPrimaryActive 也只有 3.90:1——够非文本，够不到文字。
+ * 所以菜单选中态、行内操作按钮这些「用主色写字」的地方，靠 antd 自带档位解决不了。
+ *
+ * 这里按色相不变、只压明度的方式派生出刚好达标的一档：绿还是那个绿，但读得清。
+ * 写成纯函数而不是写死一个色值，是因为四个客户各有各的主色，写死就只对信诚成立。
+ *
+ * 验收方法沿用登录页复核那套：实测计算，不看源码想当然。
+ *
+ * @author nokecy
+ */
+
+var WHITE = '#ffffff';
+var expand = function expand(hex) {
+  var raw = hex.replace('#', '');
+  return raw.length === 3 ? raw.split('').map(function (c) {
+    return c + c;
+  }).join('') : raw;
+};
+
+/** hex -> [r, g, b]，每项 0~255。 */
+export function toRgb(hex) {
+  var value = parseInt(expand(hex), 16);
+  return [value >> 16 & 255, value >> 8 & 255, value & 255];
+}
+var channelLuminance = function channelLuminance(channel) {
+  var v = channel / 255;
+  return v <= 0.03928 ? v / 12.92 : Math.pow((v + 0.055) / 1.055, 2.4);
+};
+
+/** WCAG 相对亮度。 */
+export function relativeLuminance(hex) {
+  var _toRgb = toRgb(hex),
+    _toRgb2 = _slicedToArray(_toRgb, 3),
+    r = _toRgb2[0],
+    g = _toRgb2[1],
+    b = _toRgb2[2];
+  return 0.2126 * channelLuminance(r) + 0.7152 * channelLuminance(g) + 0.0722 * channelLuminance(b);
+}
+
+/** WCAG 对比度，1 ~ 21。 */
+export function contrastRatio(a, b) {
+  var _sort = [relativeLuminance(a), relativeLuminance(b)].sort(function (x, y) {
+      return y - x;
+    }),
+    _sort2 = _slicedToArray(_sort, 2),
+    lighter = _sort2[0],
+    darker = _sort2[1];
+  return (lighter + 0.05) / (darker + 0.05);
+}
+
+/** hex -> [h(0~360), s(0~1), l(0~1)]。 */
+export function toHsl(hex) {
+  var _ref = toRgb(hex).map(function (v) {
+      return v / 255;
+    }),
+    _ref2 = _slicedToArray(_ref, 3),
+    r = _ref2[0],
+    g = _ref2[1],
+    b = _ref2[2];
+  var max = Math.max(r, g, b);
+  var min = Math.min(r, g, b);
+  var l = (max + min) / 2;
+  var d = max - min;
+  if (d === 0) return [0, 0, l];
+  var s = d / (1 - Math.abs(2 * l - 1));
+  var h;
+  if (max === r) h = 60 * ((g - b) / d % 6);else if (max === g) h = 60 * ((b - r) / d + 2);else h = 60 * ((r - g) / d + 4);
+  return [(h + 360) % 360, s, l];
+}
+
+/** [h, s, l] -> hex。 */
+export function fromHsl(h, s, l) {
+  var c = (1 - Math.abs(2 * l - 1)) * s;
+  var x = c * (1 - Math.abs(h / 60 % 2 - 1));
+  var m = l - c / 2;
+  var table = [[c, x, 0], [x, c, 0], [0, c, x], [0, x, c], [x, 0, c], [c, 0, x]];
+  var _table$Math$min = _slicedToArray(table[Math.min(5, Math.floor((h % 360 + 360) % 360 / 60))], 3),
+    r = _table$Math$min[0],
+    g = _table$Math$min[1],
+    b = _table$Math$min[2];
+  var toHex = function toHex(v) {
+    return Math.round((v + m) * 255).toString(16).padStart(2, '0');
+  };
+  return "#".concat(toHex(r)).concat(toHex(g)).concat(toHex(b));
+}
+
+/**
+ * 压暗到刚好满足对比度要求的一档，色相与饱和度保持不变。
+ *
+ * @param hex     起始色（通常是品牌主色）
+ * @param against 要压在什么底色上，默认白底
+ * @param min     目标对比度，正文 4.5、非文本 3
+ */
+export function darkenUntilContrast(hex) {
+  var _ref3 = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {},
+    _ref3$against = _ref3.against,
+    against = _ref3$against === void 0 ? WHITE : _ref3$against,
+    _ref3$min = _ref3.min,
+    min = _ref3$min === void 0 ? 4.5 : _ref3$min;
+  var _toHsl = toHsl(hex),
+    _toHsl2 = _slicedToArray(_toHsl, 3),
+    h = _toHsl2[0],
+    s = _toHsl2[1],
+    l = _toHsl2[2];
+  if (contrastRatio(hex, against) >= min) return hex;
+  for (var step = 1; step <= 100; step++) {
+    var candidate = fromHsl(h, s, Math.max(0, l - step / 100));
+    if (contrastRatio(candidate, against) >= min) return candidate;
+  }
+  return '#000000';
+}
+
+/** 深色表面上的文字保持色相，提亮至正文对比度。@author nokecy */
+export function lightenUntilContrast(hex) {
+  var _ref4 = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {},
+    _ref4$against = _ref4.against,
+    against = _ref4$against === void 0 ? '#141414' : _ref4$against,
+    _ref4$min = _ref4.min,
+    min = _ref4$min === void 0 ? 4.5 : _ref4$min;
+  var _toHsl3 = toHsl(hex),
+    _toHsl4 = _slicedToArray(_toHsl3, 3),
+    h = _toHsl4[0],
+    s = _toHsl4[1],
+    l = _toHsl4[2];
+  if (contrastRatio(hex, against) >= min) return hex;
+  for (var step = 1; step <= 100; step++) {
+    var candidate = fromHsl(h, s, Math.min(1, l + step / 100));
+    if (contrastRatio(candidate, against) >= min) return candidate;
+  }
+  return '#ffffff';
+}