@aglyn/shared-util-tools 1.0.0-beta.143

package/src/lib/array/array-sort-by.js

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2021 Aglyn 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.
+ */ /**
+ * Sort iterable by property or index returned from callbackFn
+ * @export`
+ * @param {T[]} target
+ * @param {(item: T) => (string | number)} callbackFn
+ * @param thisArg
+ * @returns {T[]}
+ */ export function arraySortBy(target, callbackFn, thisArg) {
+    return target.slice().sort((a, b)=>{
+        const propA = callbackFn.call(thisArg, a, target) // callbackFn(a)
+        ;
+        const propB = callbackFn.call(thisArg, b, target) // prop(b)
+        ;
+        if (propA > propB) return 1;
+        if (propA < propB) return -1;
+        return 0;
+    });
+}
+export default arraySortBy;
+
+//# sourceMappingURL=array-sort-by.js.map

package/src/lib/array/array-sort-by.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/array/array-sort-by.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2021 Aglyn 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 */\n\n/**\n * Sort iterable by property or index returned from callbackFn\n * @export`\n * @param {T[]} target\n * @param {(item: T) => (string | number)} callbackFn\n * @param thisArg\n * @returns {T[]}\n */\nexport function arraySortBy<T>(\n  target: T[],\n  callbackFn: (item: T, target: T[]) => string | number,\n  thisArg?: ThisType<unknown>,\n): T[] {\n  return target.slice().sort((a, b) => {\n    const propA = callbackFn.call(thisArg, a, target) // callbackFn(a)\n    const propB = callbackFn.call(thisArg, b, target) // prop(b)\n    if (propA > propB) return 1\n    if (propA < propB) return -1\n    return 0\n  })\n}\n\nexport default arraySortBy\n"],"names":["arraySortBy","target","callbackFn","thisArg","slice","sort","a","b","propA","call","propB"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;CAOC,GACD,OAAO,SAASA,YACdC,MAAW,EACXC,UAAqD,EACrDC,OAA2B;IAE3B,OAAOF,OAAOG,KAAK,GAAGC,IAAI,CAAC,CAACC,GAAGC;QAC7B,MAAMC,QAAQN,WAAWO,IAAI,CAACN,SAASG,GAAGL,QAAQ,gBAAgB;;QAClE,MAAMS,QAAQR,WAAWO,IAAI,CAACN,SAASI,GAAGN,QAAQ,UAAU;;QAC5D,IAAIO,QAAQE,OAAO,OAAO;QAC1B,IAAIF,QAAQE,OAAO,OAAO,CAAC;QAC3B,OAAO;IACT;AACF;AAEA,eAAeV,YAAW"}

package/src/lib/array/array-update-at-index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn 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.
+ */
+export declare function arrayUpdateAtIndex<T>(array: Array<T>, index: number | any, elem: T): Array<T>;
+export default arrayUpdateAtIndex;

package/src/lib/array/array-update-at-index.js

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn 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.
+ */ export function arrayUpdateAtIndex(array, index, elem) {
+    array.splice(index, 1, elem);
+    return array;
+}
+export default arrayUpdateAtIndex;
+
+//# sourceMappingURL=array-update-at-index.js.map

package/src/lib/array/array-update-at-index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/array/array-update-at-index.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2022 Aglyn 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 */\n\n\n\nexport function arrayUpdateAtIndex<T>(\n  array: Array<T>,\n  index: number | any,\n  elem: T,\n): Array<T> {\n  array.splice(index, 1, elem)\n  return array\n}\nexport default arrayUpdateAtIndex\n"],"names":["arrayUpdateAtIndex","array","index","elem","splice"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAID,OAAO,SAASA,mBACdC,KAAe,EACfC,KAAmB,EACnBC,IAAO;IAEPF,MAAMG,MAAM,CAACF,OAAO,GAAGC;IACvB,OAAOF;AACT;AACA,eAAeD,mBAAkB"}

package/src/lib/array/array-update.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn 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.
+ */
+/**
+ * Shallow assign, copy and update with multiple arrays
+ * @param array - Base array to copy and update
+ * @param others - One or more arrays to merge
+ */
+export declare function arrayUpdate<T>(array: Array<T>, ...others: (Array<T> | Record<string, unknown>)[]): Array<T>;
+export default arrayUpdate;

package/src/lib/array/array-update.js

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn 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.
+ */ /**
+ * Shallow assign, copy and update with multiple arrays
+ * @param array - Base array to copy and update
+ * @param others - One or more arrays to merge
+ */ export function arrayUpdate(array, ...others) {
+    return Object.assign(array, ...others);
+}
+export default arrayUpdate;
+
+//# sourceMappingURL=array-update.js.map

package/src/lib/array/array-update.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/array/array-update.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2022 Aglyn 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 */\n\n/**\n * Shallow assign, copy and update with multiple arrays\n * @param array - Base array to copy and update\n * @param others - One or more arrays to merge\n */\nexport function arrayUpdate<T>(\n  array: Array<T>,\n  ...others: (Array<T> | Record<string, unknown>)[]\n): Array<T> {\n  return Object.assign(array, ...others)\n}\nexport default arrayUpdate\n"],"names":["arrayUpdate","array","others","Object","assign"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;CAIC,GACD,OAAO,SAASA,YACdC,KAAe,EACf,GAAGC,MAA8C;IAEjD,OAAOC,OAAOC,MAAM,CAACH,UAAUC;AACjC;AACA,eAAeF,YAAW"}

package/src/lib/bitwise/bitwise-has-all-attributes.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2021 Aglyn 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.
+ */
+export declare function bitwiseHasAllAttributes(value: number, attr: number): value is (typeof value | (typeof attr));
+export default bitwiseHasAllAttributes;

package/src/lib/bitwise/bitwise-has-all-attributes.js

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2021 Aglyn 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.
+ */ export function bitwiseHasAllAttributes(value, attr) {
+    return Boolean(value === (value | attr));
+}
+export default bitwiseHasAllAttributes;
+
+//# sourceMappingURL=bitwise-has-all-attributes.js.map

package/src/lib/bitwise/bitwise-has-all-attributes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/bitwise/bitwise-has-all-attributes.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2021 Aglyn 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 */\n\n\nexport function bitwiseHasAllAttributes(\n  value: number,\n  attr: number\n): value is (typeof value | (typeof attr)) {\n  return Boolean(value === (value | (attr)))\n}\nexport default bitwiseHasAllAttributes\n"],"names":["bitwiseHasAllAttributes","value","attr","Boolean"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAGD,OAAO,SAASA,wBACdC,KAAa,EACbC,IAAY;IAEZ,OAAOC,QAAQF,UAAWA,CAAAA,QAASC,IAAI;AACzC;AACA,eAAeF,wBAAuB"}

package/src/lib/bitwise/bitwise-has-attribute.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2021 Aglyn 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.
+ */
+export declare function bitwiseHasAttribute(value: number, attr: number): value is (typeof value & typeof attr);
+export default bitwiseHasAttribute;

package/src/lib/bitwise/bitwise-has-attribute.js

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2021 Aglyn 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.
+ */ export function bitwiseHasAttribute(value, attr) {
+    return Boolean(value & attr);
+}
+export default bitwiseHasAttribute;
+
+//# sourceMappingURL=bitwise-has-attribute.js.map

package/src/lib/bitwise/bitwise-has-attribute.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/bitwise/bitwise-has-attribute.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2021 Aglyn 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 */\n\n\nexport function bitwiseHasAttribute(\n  value: number,\n  attr: number,\n): value is (typeof value & typeof attr) {\n  return Boolean(value & attr)\n}\nexport default bitwiseHasAttribute\n"],"names":["bitwiseHasAttribute","value","attr","Boolean"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAGD,OAAO,SAASA,oBACdC,KAAa,EACbC,IAAY;IAEZ,OAAOC,QAAQF,QAAQC;AACzB;AACA,eAAeF,oBAAmB"}

package/src/lib/bitwise/bitwise-has-only-attributes.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn 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.
+ */
+export declare function bitwiseHasOnlyAttributes(value: number, attr: number): value is typeof attr;
+export default bitwiseHasOnlyAttributes;

package/src/lib/bitwise/bitwise-has-only-attributes.js

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn 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.
+ */ export function bitwiseHasOnlyAttributes(value, attr) {
+    return Boolean(value === attr);
+}
+export default bitwiseHasOnlyAttributes;
+
+//# sourceMappingURL=bitwise-has-only-attributes.js.map

package/src/lib/bitwise/bitwise-has-only-attributes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../libs/shared/util/tools/src/lib/bitwise/bitwise-has-only-attributes.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2022 Aglyn 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 */\n\nexport function bitwiseHasOnlyAttributes(\n  value: number,\n  attr: number,\n): value is typeof attr {\n  return Boolean(value === attr)\n}\nexport default bitwiseHasOnlyAttributes\n"],"names":["bitwiseHasOnlyAttributes","value","attr","Boolean"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,OAAO,SAASA,yBACdC,KAAa,EACbC,IAAY;IAEZ,OAAOC,QAAQF,UAAUC;AAC3B;AACA,eAAeF,yBAAwB"}

package/src/lib/contrast.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn 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.
+ */
+/**
+ * The WCAG luminance math, with no color library under it.
+ *
+ * `shared-ui-theme`'s `accessible-shade` owns the same math for the token
+ * pipeline, but it decomposes colors through MUI. The two callers here are a
+ * server-rendered email page and a console effect, and neither should have to
+ * take a theme library to answer "black text or white text on this swatch" —
+ * which is how they came to carry a copy each, and how one of the copies came
+ * to be wrong.
+ *
+ * Deliberately NOT re-exported from this library's index — reach it as
+ * `@aglyn/shared-util-tools/contrast`. The index note records why.
+ */
+/** One sRGB channel (0–255) as linear light. */
+export declare function srgbChannelToLinear(channel: number): number;
+/** WCAG relative luminance, 0 (black) to 1 (white). */
+export declare function relativeLuminanceOfRgb(red: number, green: number, blue: number): number;
+/**
+ * `#abc` / `#abcd` / `#rrggbb` / `#rrggbbaa` → channels, or null.
+ *
+ * Alpha is parsed off and discarded: these callers choose ink for a filled
+ * surface, and what the surface composites over is not knowable here.
+ */
+export declare function rgbChannelsOfHex(color: string): [red: number, green: number, blue: number] | null;
+/**
+ * The luminance at which black text and white text read equally well.
+ *
+ * Not a taste value and not 0.5. Contrast under WCAG 2.x is
+ * `(lighter + 0.05) / (darker + 0.05)`, so black on a background of
+ * luminance `L` scores `(L + 0.05) / 0.05` and white on it scores
+ * `1.05 / (L + 0.05)`. Those are equal at `L = √(0.05 × 1.05) − 0.05`,
+ * which is 0.1791.
+ *
+ * Splitting at 0.5 instead does not merely round differently, it picks the
+ * WRONG ink across the whole middle of the range: on a mid-tone brand color
+ * of luminance 0.3 it chooses white, at 3.0:1 — below the AA bar — where
+ * black would have given 7.0:1.
+ *
+ * Written as the derivation rather than as the 0.179 everyone quotes, so the
+ * value cannot drift from the rule it comes from.
+ */
+export declare const INK_SWITCH_LUMINANCE: number;
+/**
+ * Does dark ink read better than light ink on this background?
+ *
+ * `null` when the color is not a hex literal this can measure, so a caller
+ * decides its own fallback rather than being handed a guess.
+ */
+export declare function prefersDarkInk(color: string): boolean | null;

package/src/lib/contrast.js

@@ -0,0 +1,78 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn 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.
+ */ /**
+ * The WCAG luminance math, with no color library under it.
+ *
+ * `shared-ui-theme`'s `accessible-shade` owns the same math for the token
+ * pipeline, but it decomposes colors through MUI. The two callers here are a
+ * server-rendered email page and a console effect, and neither should have to
+ * take a theme library to answer "black text or white text on this swatch" —
+ * which is how they came to carry a copy each, and how one of the copies came
+ * to be wrong.
+ *
+ * Deliberately NOT re-exported from this library's index — reach it as
+ * `@aglyn/shared-util-tools/contrast`. The index note records why.
+ */ /** One sRGB channel (0–255) as linear light. */ export function srgbChannelToLinear(channel) {
+    const value = Math.min(255, Math.max(0, channel)) / 255;
+    return value <= 0.03928 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4;
+}
+/** WCAG relative luminance, 0 (black) to 1 (white). */ export function relativeLuminanceOfRgb(red, green, blue) {
+    return 0.2126 * srgbChannelToLinear(red) + 0.7152 * srgbChannelToLinear(green) + 0.0722 * srgbChannelToLinear(blue);
+}
+/**
+ * `#abc` / `#abcd` / `#rrggbb` / `#rrggbbaa` → channels, or null.
+ *
+ * Alpha is parsed off and discarded: these callers choose ink for a filled
+ * surface, and what the surface composites over is not knowable here.
+ */ export function rgbChannelsOfHex(color) {
+    const body = color.trim().replace(/^#/, '');
+    const full = body.length === 3 || body.length === 4 ? body.slice(0, 3).split('').map((character)=>character + character).join('') : body.slice(0, 6);
+    if (!/^[0-9a-f]{6}$/i.test(full)) return null;
+    return [
+        parseInt(full.slice(0, 2), 16),
+        parseInt(full.slice(2, 4), 16),
+        parseInt(full.slice(4, 6), 16)
+    ];
+}
+/**
+ * The luminance at which black text and white text read equally well.
+ *
+ * Not a taste value and not 0.5. Contrast under WCAG 2.x is
+ * `(lighter + 0.05) / (darker + 0.05)`, so black on a background of
+ * luminance `L` scores `(L + 0.05) / 0.05` and white on it scores
+ * `1.05 / (L + 0.05)`. Those are equal at `L = √(0.05 × 1.05) − 0.05`,
+ * which is 0.1791.
+ *
+ * Splitting at 0.5 instead does not merely round differently, it picks the
+ * WRONG ink across the whole middle of the range: on a mid-tone brand color
+ * of luminance 0.3 it chooses white, at 3.0:1 — below the AA bar — where
+ * black would have given 7.0:1.
+ *
+ * Written as the derivation rather than as the 0.179 everyone quotes, so the
+ * value cannot drift from the rule it comes from.
+ */ export const INK_SWITCH_LUMINANCE = Math.sqrt(1.05 * 0.05) - 0.05;
+/**
+ * Does dark ink read better than light ink on this background?
+ *
+ * `null` when the color is not a hex literal this can measure, so a caller
+ * decides its own fallback rather than being handed a guess.
+ */ export function prefersDarkInk(color) {
+    const channels = rgbChannelsOfHex(color);
+    if (!channels) return null;
+    return relativeLuminanceOfRgb(...channels) > INK_SWITCH_LUMINANCE;
+}
+
+//# sourceMappingURL=contrast.js.map

package/src/lib/contrast.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/shared/util/tools/src/lib/contrast.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn 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 */\n\n/**\n * The WCAG luminance math, with no color library under it.\n *\n * `shared-ui-theme`'s `accessible-shade` owns the same math for the token\n * pipeline, but it decomposes colors through MUI. The two callers here are a\n * server-rendered email page and a console effect, and neither should have to\n * take a theme library to answer \"black text or white text on this swatch\" —\n * which is how they came to carry a copy each, and how one of the copies came\n * to be wrong.\n *\n * Deliberately NOT re-exported from this library's index — reach it as\n * `@aglyn/shared-util-tools/contrast`. The index note records why.\n */\n\n/** One sRGB channel (0–255) as linear light. */\nexport function srgbChannelToLinear(channel: number): number {\n  const value = Math.min(255, Math.max(0, channel)) / 255\n  return value <= 0.03928 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4\n}\n\n/** WCAG relative luminance, 0 (black) to 1 (white). */\nexport function relativeLuminanceOfRgb(\n  red: number,\n  green: number,\n  blue: number,\n): number {\n  return (\n    0.2126 * srgbChannelToLinear(red) +\n    0.7152 * srgbChannelToLinear(green) +\n    0.0722 * srgbChannelToLinear(blue)\n  )\n}\n\n/**\n * `#abc` / `#abcd` / `#rrggbb` / `#rrggbbaa` → channels, or null.\n *\n * Alpha is parsed off and discarded: these callers choose ink for a filled\n * surface, and what the surface composites over is not knowable here.\n */\nexport function rgbChannelsOfHex(\n  color: string,\n): [red: number, green: number, blue: number] | null {\n  const body = color.trim().replace(/^#/, '')\n  const full =\n    body.length === 3 || body.length === 4\n      ? body\n          .slice(0, 3)\n          .split('')\n          .map((character) => character + character)\n          .join('')\n      : body.slice(0, 6)\n  if (!/^[0-9a-f]{6}$/i.test(full)) return null\n  return [\n    parseInt(full.slice(0, 2), 16),\n    parseInt(full.slice(2, 4), 16),\n    parseInt(full.slice(4, 6), 16),\n  ]\n}\n\n/**\n * The luminance at which black text and white text read equally well.\n *\n * Not a taste value and not 0.5. Contrast under WCAG 2.x is\n * `(lighter + 0.05) / (darker + 0.05)`, so black on a background of\n * luminance `L` scores `(L + 0.05) / 0.05` and white on it scores\n * `1.05 / (L + 0.05)`. Those are equal at `L = √(0.05 × 1.05) − 0.05`,\n * which is 0.1791.\n *\n * Splitting at 0.5 instead does not merely round differently, it picks the\n * WRONG ink across the whole middle of the range: on a mid-tone brand color\n * of luminance 0.3 it chooses white, at 3.0:1 — below the AA bar — where\n * black would have given 7.0:1.\n *\n * Written as the derivation rather than as the 0.179 everyone quotes, so the\n * value cannot drift from the rule it comes from.\n */\nexport const INK_SWITCH_LUMINANCE = Math.sqrt(1.05 * 0.05) - 0.05\n\n/**\n * Does dark ink read better than light ink on this background?\n *\n * `null` when the color is not a hex literal this can measure, so a caller\n * decides its own fallback rather than being handed a guess.\n */\nexport function prefersDarkInk(color: string): boolean | null {\n  const channels = rgbChannelsOfHex(color)\n  if (!channels) return null\n  return relativeLuminanceOfRgb(...channels) > INK_SWITCH_LUMINANCE\n}\n"],"names":["srgbChannelToLinear","channel","value","Math","min","max","relativeLuminanceOfRgb","red","green","blue","rgbChannelsOfHex","color","body","trim","replace","full","length","slice","split","map","character","join","test","parseInt","INK_SWITCH_LUMINANCE","sqrt","prefersDarkInk","channels"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;CAYC,GAED,8CAA8C,GAC9C,OAAO,SAASA,oBAAoBC,OAAe;IACjD,MAAMC,QAAQC,KAAKC,GAAG,CAAC,KAAKD,KAAKE,GAAG,CAAC,GAAGJ,YAAY;IACpD,OAAOC,SAAS,UAAUA,QAAQ,QAAQ,AAAC,CAAA,AAACA,CAAAA,QAAQ,KAAI,IAAK,KAAI,KAAM;AACzE;AAEA,qDAAqD,GACrD,OAAO,SAASI,uBACdC,GAAW,EACXC,KAAa,EACbC,IAAY;IAEZ,OACE,SAAST,oBAAoBO,OAC7B,SAASP,oBAAoBQ,SAC7B,SAASR,oBAAoBS;AAEjC;AAEA;;;;;CAKC,GACD,OAAO,SAASC,iBACdC,KAAa;IAEb,MAAMC,OAAOD,MAAME,IAAI,GAAGC,OAAO,CAAC,MAAM;IACxC,MAAMC,OACJH,KAAKI,MAAM,KAAK,KAAKJ,KAAKI,MAAM,KAAK,IACjCJ,KACGK,KAAK,CAAC,GAAG,GACTC,KAAK,CAAC,IACNC,GAAG,CAAC,CAACC,YAAcA,YAAYA,WAC/BC,IAAI,CAAC,MACRT,KAAKK,KAAK,CAAC,GAAG;IACpB,IAAI,CAAC,iBAAiBK,IAAI,CAACP,OAAO,OAAO;IACzC,OAAO;QACLQ,SAASR,KAAKE,KAAK,CAAC,GAAG,IAAI;QAC3BM,SAASR,KAAKE,KAAK,CAAC,GAAG,IAAI;QAC3BM,SAASR,KAAKE,KAAK,CAAC,GAAG,IAAI;KAC5B;AACH;AAEA;;;;;;;;;;;;;;;;CAgBC,GACD,OAAO,MAAMO,uBAAuBrB,KAAKsB,IAAI,CAAC,OAAO,QAAQ,KAAI;AAEjE;;;;;CAKC,GACD,OAAO,SAASC,eAAef,KAAa;IAC1C,MAAMgB,WAAWjB,iBAAiBC;IAClC,IAAI,CAACgB,UAAU,OAAO;IACtB,OAAOrB,0BAA0BqB,YAAYH;AAC/C"}

package/src/lib/copy-shallow.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn 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 copyShallow from 'lodash-es/clone.js';
+export { copyShallow };
+export default copyShallow;

package/src/lib/copy-shallow.js

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn 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 copyShallow from "lodash-es/clone.js";
+export { copyShallow };
+export default copyShallow;
+
+//# sourceMappingURL=copy-shallow.js.map

package/src/lib/copy-shallow.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/shared/util/tools/src/lib/copy-shallow.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2022 Aglyn 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 */\n\nimport copyShallow from 'lodash-es/clone.js'\n\n\nexport {copyShallow}\nexport default copyShallow\n"],"names":["copyShallow"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,OAAOA,iBAAiB,qBAAoB;AAG5C,SAAQA,WAAW,GAAC;AACpB,eAAeA,YAAW"}

package/src/lib/copy.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn 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 cloneDeep from 'lodash-es/cloneDeep.js';
+export { cloneDeep };
+export default cloneDeep;

package/src/lib/copy.js

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn 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 cloneDeep from "lodash-es/cloneDeep.js";
+export { cloneDeep };
+export default cloneDeep;
+
+//# sourceMappingURL=copy.js.map

package/src/lib/copy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/shared/util/tools/src/lib/copy.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2022 Aglyn 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 */\n\nimport cloneDeep from 'lodash-es/cloneDeep.js'\n\nexport { cloneDeep }\nexport default cloneDeep\n"],"names":["cloneDeep"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,OAAOA,eAAe,yBAAwB;AAE9C,SAASA,SAAS,GAAE;AACpB,eAAeA,UAAS"}

package/src/lib/create-chained-function.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @license
+ * Copyright 2023 Aglyn 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 type { IndexOf } from './operator/inference';
+export type ChainableFunction<T, A extends any[], R> = {
+    (this: T, ...args: A): R;
+};
+/**
+ * Safe chained function.
+ *
+ * Will only create a new function if needed,
+ * otherwise will pass back existing functions or null.
+ *
+ * @example
+ * const {onClick} = props
+ * const handleOnClick = () => {}
+ * const isOpen = false
+ * const handleClose = () => {}
+ * <element
+ *   onclick={createChainedFunction(handleOnClick, onClick, isOpen &&
+ *   handleClose)}
+ * />
+ */
+export declare function createChainedFunction<T, A extends any[], R>(functions: ChainableFunction<T, A, R>[], thisArg?: T, ...args: IndexOf<A>[]): ChainableFunction<T, A, R>;
+export default createChainedFunction;

package/src/lib/create-chained-function.js

@@ -0,0 +1,46 @@
+/**
+ * @license
+ * Copyright 2023 Aglyn 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.
+ */ /**
+ * Safe chained function.
+ *
+ * Will only create a new function if needed,
+ * otherwise will pass back existing functions or null.
+ *
+ * @example
+ * const {onClick} = props
+ * const handleOnClick = () => {}
+ * const isOpen = false
+ * const handleClose = () => {}
+ * <element
+ *   onclick={createChainedFunction(handleOnClick, onClick, isOpen &&
+ *   handleClose)}
+ * />
+ */ export function createChainedFunction(functions, thisArg = null, ...args) {
+    return functions.reduce((accumulator, fn)=>{
+        return fn == null ? accumulator : chainedFunction;
+        function chainedFunction(..._args) {
+            const mergedArgs = [
+                ..._args,
+                ...args
+            ];
+            accumulator.apply(thisArg || this, mergedArgs);
+            return fn.apply(thisArg || this, mergedArgs);
+        }
+    }, ()=>{});
+}
+export default createChainedFunction;
+
+//# sourceMappingURL=create-chained-function.js.map

package/src/lib/create-chained-function.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/shared/util/tools/src/lib/create-chained-function.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2023 Aglyn 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 */\n\nimport type { IndexOf } from './operator/inference'\n\nexport type ChainableFunction<T, A extends any[], R> = {\n  (this: T, ...args: A): R\n}\n\n/**\n * Safe chained function.\n *\n * Will only create a new function if needed,\n * otherwise will pass back existing functions or null.\n *\n * @example\n * const {onClick} = props\n * const handleOnClick = () => {}\n * const isOpen = false\n * const handleClose = () => {}\n * <element\n *   onclick={createChainedFunction(handleOnClick, onClick, isOpen &&\n *   handleClose)}\n * />\n */\nexport function createChainedFunction<T, A extends any[], R>(\n  functions: ChainableFunction<T, A, R>[],\n  thisArg: T = null,\n  ...args: IndexOf<A>[]\n): ChainableFunction<T, A, R> {\n  return functions.reduce(\n    (accumulator, fn) => {\n      return fn == null\n        ? // When received invalid fn return safe function\n          accumulator\n        : // Otherwise, build new fn and apply both\n          chainedFunction\n\n      function chainedFunction(this: T, ..._args: A): R {\n        const mergedArgs = [..._args, ...args] as A\n        accumulator.apply(thisArg || this, mergedArgs)\n        return fn.apply(thisArg || this, mergedArgs)\n      }\n    },\n    (() => {}) as ChainableFunction<T, A, R>,\n  )\n}\n\nexport default createChainedFunction\n"],"names":["createChainedFunction","functions","thisArg","args","reduce","accumulator","fn","chainedFunction","_args","mergedArgs","apply"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAQD;;;;;;;;;;;;;;;CAeC,GACD,OAAO,SAASA,sBACdC,SAAuC,EACvCC,UAAa,IAAI,EACjB,GAAGC,IAAkB;IAErB,OAAOF,UAAUG,MAAM,CACrB,CAACC,aAAaC;QACZ,OAAOA,MAAM,OAETD,cAEAE;QAEJ,SAASA,gBAAyB,GAAGC,KAAQ;YAC3C,MAAMC,aAAa;mBAAID;mBAAUL;aAAK;YACtCE,YAAYK,KAAK,CAACR,WAAW,IAAI,EAAEO;YACnC,OAAOH,GAAGI,KAAK,CAACR,WAAW,IAAI,EAAEO;QACnC;IACF,GACC,KAAO;AAEZ;AAEA,eAAeT,sBAAqB"}