@design-edito/tools 0.1.30 → 0.1.31

package/agnostic/css/index.js

@@ -1,19 +1,20 @@
 import {
   register
-} from "../../chunks/chunk-CB52KVOZ.js";
-import "../../chunks/chunk-UFKH5WD2.js";
-import "../../chunks/chunk-RLJOYG64.js";
+} from "../../chunks/chunk-CAMYGA44.js";
+import "../../chunks/chunk-FR5H2OCV.js";
 import "../../chunks/chunk-S2NMAH7K.js";
 import "../../chunks/chunk-LV2VMOWR.js";
+import "../../chunks/chunk-RLJOYG64.js";
 import {
   Random
 } from "../../chunks/chunk-S32K7POB.js";
 import "../../chunks/chunk-D3ERTRDW.js";
 import "../../chunks/chunk-75BICI4L.js";
 import "../../chunks/chunk-OGBUSUE6.js";
-import "../../chunks/chunk-2KT7AKRW.js";
-import "../../chunks/chunk-FENXVJYO.js";
-import "../../chunks/chunk-QHLQVR3E.js";
+import {
+  generateNiceColor,
+  niceColors
+} from "../../chunks/chunk-EDVNAV3G.js";
 import {
   Bem
 } from "../../chunks/chunk-KIONYWA7.js";
@@ -21,12 +22,11 @@ import {
   classNameRegex,
   isValidClassName
 } from "../../chunks/chunk-W5A2TON3.js";
+import "../../chunks/chunk-WH6BPDAC.js";
+import "../../chunks/chunk-QHLQVR3E.js";
+import "../../chunks/chunk-FENXVJYO.js";
 import "../../chunks/chunk-QXAJXTXV.js";
 import "../../chunks/chunk-HC6ZOHCS.js";
-import {
-  generateNiceColor,
-  niceColors
-} from "../../chunks/chunk-EDVNAV3G.js";
 
 // src/agnostic/css/styles-set/index.tsx
 import { Component } from "react";

package/agnostic/errors/index.js

@@ -1,8 +1,8 @@
 import {
   Errors
-} from "../../chunks/chunk-2KT7AKRW.js";
-import "../../chunks/chunk-FENXVJYO.js";
+} from "../../chunks/chunk-WH6BPDAC.js";
 import "../../chunks/chunk-QHLQVR3E.js";
+import "../../chunks/chunk-FENXVJYO.js";
 export {
   Errors
 };

package/agnostic/html/get-node-ancestors/index.d.ts

@@ -1 +1 @@
-export declare function getNodeAncestors(node: Node): Element[];
+export declare function getNodeAncestors(node: Node, traverseShadowRoots?: boolean): Node[];

package/agnostic/html/get-node-ancestors/index.js

@@ -1,6 +1,6 @@
 import {
   getNodeAncestors
-} from "../../../chunks/chunk-SQZGZ3VT.js";
+} from "../../../chunks/chunk-LUPVHC73.js";
 export {
   getNodeAncestors
 };

package/agnostic/html/index.js

@@ -4,39 +4,39 @@ import {
 import "../../chunks/chunk-BQV4DOSE.js";
 import "../../chunks/chunk-ZCPGE7H7.js";
 import "../../chunks/chunk-5GI5G45R.js";
+import {
+  getPositionInsideParent
+} from "../../chunks/chunk-VTPRO4NJ.js";
 import {
   getNodeAncestors
-} from "../../chunks/chunk-SQZGZ3VT.js";
+} from "../../chunks/chunk-LUPVHC73.js";
 import {
   insertNode
 } from "../../chunks/chunk-XA4HVHJ4.js";
-import {
-  getPositionInsideParent
-} from "../../chunks/chunk-VTPRO4NJ.js";
 import {
   Placeholders
 } from "../../chunks/chunk-VYW4IADX.js";
-import "../../chunks/chunk-GBMHGF7P.js";
 import {
   selectorToElement
-} from "../../chunks/chunk-EVOTJ7SU.js";
+} from "../../chunks/chunk-BVCWBTHQ.js";
+import "../../chunks/chunk-GBMHGF7P.js";
 import {
   stringToNodes
-} from "../../chunks/chunk-NWFX6TEY.js";
+} from "../../chunks/chunk-VKURVIRV.js";
 import {
   Sanitize
-} from "../../chunks/chunk-WABWQCFE.js";
+} from "../../chunks/chunk-C5753KUP.js";
 import "../../chunks/chunk-YDIBNEGA.js";
 import "../../chunks/chunk-E6MSDKON.js";
 import "../../chunks/chunk-MF56TTC5.js";
-import "../../chunks/chunk-CB52KVOZ.js";
-import "../../chunks/chunk-UFKH5WD2.js";
-import "../../chunks/chunk-RLJOYG64.js";
+import "../../chunks/chunk-CAMYGA44.js";
+import "../../chunks/chunk-FR5H2OCV.js";
 import "../../chunks/chunk-S2NMAH7K.js";
 import "../../chunks/chunk-LV2VMOWR.js";
-import "../../chunks/chunk-2KT7AKRW.js";
-import "../../chunks/chunk-FENXVJYO.js";
+import "../../chunks/chunk-RLJOYG64.js";
+import "../../chunks/chunk-WH6BPDAC.js";
 import "../../chunks/chunk-QHLQVR3E.js";
+import "../../chunks/chunk-FENXVJYO.js";
 import "../../chunks/chunk-QXAJXTXV.js";
 import "../../chunks/chunk-HC6ZOHCS.js";
 

package/agnostic/html/sanitize/index.js

@@ -1,14 +1,14 @@
 import {
   Sanitize
-} from "../../../chunks/chunk-WABWQCFE.js";
-import "../../../chunks/chunk-CB52KVOZ.js";
-import "../../../chunks/chunk-UFKH5WD2.js";
-import "../../../chunks/chunk-RLJOYG64.js";
+} from "../../../chunks/chunk-C5753KUP.js";
+import "../../../chunks/chunk-CAMYGA44.js";
+import "../../../chunks/chunk-FR5H2OCV.js";
 import "../../../chunks/chunk-S2NMAH7K.js";
 import "../../../chunks/chunk-LV2VMOWR.js";
-import "../../../chunks/chunk-2KT7AKRW.js";
-import "../../../chunks/chunk-FENXVJYO.js";
+import "../../../chunks/chunk-RLJOYG64.js";
+import "../../../chunks/chunk-WH6BPDAC.js";
 import "../../../chunks/chunk-QHLQVR3E.js";
+import "../../../chunks/chunk-FENXVJYO.js";
 export {
   Sanitize
 };

package/agnostic/html/selector-to-element/index.js

@@ -1,14 +1,14 @@
 import {
   selectorToElement
-} from "../../../chunks/chunk-EVOTJ7SU.js";
-import "../../../chunks/chunk-CB52KVOZ.js";
-import "../../../chunks/chunk-UFKH5WD2.js";
-import "../../../chunks/chunk-RLJOYG64.js";
+} from "../../../chunks/chunk-BVCWBTHQ.js";
+import "../../../chunks/chunk-CAMYGA44.js";
+import "../../../chunks/chunk-FR5H2OCV.js";
 import "../../../chunks/chunk-S2NMAH7K.js";
 import "../../../chunks/chunk-LV2VMOWR.js";
-import "../../../chunks/chunk-2KT7AKRW.js";
-import "../../../chunks/chunk-FENXVJYO.js";
+import "../../../chunks/chunk-RLJOYG64.js";
+import "../../../chunks/chunk-WH6BPDAC.js";
 import "../../../chunks/chunk-QHLQVR3E.js";
+import "../../../chunks/chunk-FENXVJYO.js";
 export {
   selectorToElement
 };

package/agnostic/html/string-to-nodes/index.js

@@ -1,15 +1,15 @@
 import {
   stringToNodes
-} from "../../../chunks/chunk-NWFX6TEY.js";
-import "../../../chunks/chunk-WABWQCFE.js";
-import "../../../chunks/chunk-CB52KVOZ.js";
-import "../../../chunks/chunk-UFKH5WD2.js";
-import "../../../chunks/chunk-RLJOYG64.js";
+} from "../../../chunks/chunk-VKURVIRV.js";
+import "../../../chunks/chunk-C5753KUP.js";
+import "../../../chunks/chunk-CAMYGA44.js";
+import "../../../chunks/chunk-FR5H2OCV.js";
 import "../../../chunks/chunk-S2NMAH7K.js";
 import "../../../chunks/chunk-LV2VMOWR.js";
-import "../../../chunks/chunk-2KT7AKRW.js";
-import "../../../chunks/chunk-FENXVJYO.js";
+import "../../../chunks/chunk-RLJOYG64.js";
+import "../../../chunks/chunk-WH6BPDAC.js";
 import "../../../chunks/chunk-QHLQVR3E.js";
+import "../../../chunks/chunk-FENXVJYO.js";
 export {
   stringToNodes
 };

package/agnostic/misc/cast/index.d.ts

@@ -6,4 +6,5 @@ export declare namespace Cast {
     function toArray(value: unknown): any[];
     function toNumberArr(value: unknown): number[];
     function toRecord(value: unknown): Record<string, unknown>;
+    function toError(value: unknown): Error;
 }

package/agnostic/misc/cast/index.js

@@ -1,6 +1,6 @@
 import {
   Cast
-} from "../../../chunks/chunk-4QQBKBYH.js";
+} from "../../../chunks/chunk-SNJJII7A.js";
 import "../../../chunks/chunk-QXAJXTXV.js";
 import "../../../chunks/chunk-HC6ZOHCS.js";
 export {

package/agnostic/misc/crossenv/index.js

@@ -1,9 +1,9 @@
 import {
   Crossenv
-} from "../../../chunks/chunk-UFKH5WD2.js";
-import "../../../chunks/chunk-RLJOYG64.js";
+} from "../../../chunks/chunk-FR5H2OCV.js";
 import "../../../chunks/chunk-S2NMAH7K.js";
 import "../../../chunks/chunk-LV2VMOWR.js";
+import "../../../chunks/chunk-RLJOYG64.js";
 export {
   Crossenv
 };

package/agnostic/misc/index.js

@@ -1,38 +1,38 @@
 import {
   Logs
-} from "../../chunks/chunk-G2NZXHW6.js";
+} from "../../chunks/chunk-TEB7KZWB.js";
+import "../../chunks/chunk-JWKI6G6E.js";
 import "../../chunks/chunk-L3OCRR3V.js";
 import "../../chunks/chunk-H4PP6AHP.js";
-import "../../chunks/chunk-JWKI6G6E.js";
-import {
-  getCurrentDownlink
-} from "../../chunks/chunk-7AWTHZLY.js";
 import {
   Cast
-} from "../../chunks/chunk-4QQBKBYH.js";
+} from "../../chunks/chunk-SNJJII7A.js";
 import {
   Crawler
 } from "../../chunks/chunk-YUP434IY.js";
+import {
+  getCurrentDownlink
+} from "../../chunks/chunk-7AWTHZLY.js";
 import {
   LoremIpsum
-} from "../../chunks/chunk-MUGIN5OW.js";
-import "../../chunks/chunk-4CIS3R7T.js";
+} from "../../chunks/chunk-GPWFYPER.js";
 import {
   Assert
 } from "../../chunks/chunk-W7YBGJ4H.js";
+import "../../chunks/chunk-4CIS3R7T.js";
 import "../../chunks/chunk-YS6WMSWC.js";
+import "../../chunks/chunk-RLAZR3NL.js";
 import "../../chunks/chunk-6RGDWX4A.js";
 import {
   isConstructorFunction
 } from "../../chunks/chunk-RCO57B6F.js";
 import "../../chunks/chunk-FCU6IHKD.js";
-import "../../chunks/chunk-RLAZR3NL.js";
 import {
   Crossenv
-} from "../../chunks/chunk-UFKH5WD2.js";
-import "../../chunks/chunk-RLJOYG64.js";
+} from "../../chunks/chunk-FR5H2OCV.js";
 import "../../chunks/chunk-S2NMAH7K.js";
 import "../../chunks/chunk-LV2VMOWR.js";
+import "../../chunks/chunk-RLJOYG64.js";
 import {
   Random
 } from "../../chunks/chunk-S32K7POB.js";

package/agnostic/misc/logs/index.js

@@ -1,9 +1,9 @@
 import {
   Logs
-} from "../../../chunks/chunk-G2NZXHW6.js";
+} from "../../../chunks/chunk-TEB7KZWB.js";
+import "../../../chunks/chunk-JWKI6G6E.js";
 import "../../../chunks/chunk-L3OCRR3V.js";
 import "../../../chunks/chunk-H4PP6AHP.js";
-import "../../../chunks/chunk-JWKI6G6E.js";
 export {
   Logs
 };

package/agnostic/misc/lorem-ipsum/index.js

@@ -1,11 +1,11 @@
 import {
   LoremIpsum
-} from "../../../chunks/chunk-MUGIN5OW.js";
+} from "../../../chunks/chunk-GPWFYPER.js";
 import "../../../chunks/chunk-YS6WMSWC.js";
+import "../../../chunks/chunk-RLAZR3NL.js";
 import "../../../chunks/chunk-6RGDWX4A.js";
 import "../../../chunks/chunk-RCO57B6F.js";
 import "../../../chunks/chunk-FCU6IHKD.js";
-import "../../../chunks/chunk-RLAZR3NL.js";
 import "../../../chunks/chunk-S32K7POB.js";
 import "../../../chunks/chunk-D3ERTRDW.js";
 import "../../../chunks/chunk-75BICI4L.js";

package/agnostic/numbers/index.js

@@ -1,9 +1,9 @@
-import {
-  interpolate
-} from "../../chunks/chunk-EW46EXFB.js";
 import {
   clamp
 } from "../../chunks/chunk-OSAXBA7G.js";
+import {
+  interpolate
+} from "../../chunks/chunk-BJAYUP7M.js";
 import {
   createScale,
   getHarmonic

package/agnostic/numbers/interpolate/index.d.ts

@@ -1 +1,2 @@
 export declare function interpolate(ratio: number, bound1: number, bound2: number): number;
+export declare function exterpolate(value: number, bound1: number, bound2?: number): number;

package/agnostic/numbers/interpolate/index.js

@@ -1,6 +1,8 @@
 import {
+  exterpolate,
   interpolate
-} from "../../../chunks/chunk-EW46EXFB.js";
+} from "../../../chunks/chunk-BJAYUP7M.js";
 export {
+  exterpolate,
   interpolate
 };

package/agnostic/objects/flatten-getters/index.js

@@ -1,7 +1,7 @@
 import {
   flattenGetters
-} from "../../../chunks/chunk-PO3V3I57.js";
-import "../../../chunks/chunk-4QQBKBYH.js";
+} from "../../../chunks/chunk-VFJYLXCI.js";
+import "../../../chunks/chunk-SNJJII7A.js";
 import "../../../chunks/chunk-QXAJXTXV.js";
 import "../../../chunks/chunk-HC6ZOHCS.js";
 export {

package/agnostic/objects/index.js

@@ -1,16 +1,16 @@
 import {
   flattenGetters
-} from "../../chunks/chunk-PO3V3I57.js";
+} from "../../chunks/chunk-VFJYLXCI.js";
 import {
-  Validation
-} from "../../chunks/chunk-FPEW3A27.js";
+  isNonNullObject,
+  isObject
+} from "../../chunks/chunk-HQLRJ7XW.js";
 import {
   recordFormat
 } from "../../chunks/chunk-YP64J65L.js";
 import {
-  isNonNullObject,
-  isObject
-} from "../../chunks/chunk-HQLRJ7XW.js";
+  Validation
+} from "../../chunks/chunk-FPEW3A27.js";
 import {
   Enums
 } from "../../chunks/chunk-WOAYU6LB.js";
@@ -18,7 +18,7 @@ import {
   isRecord
 } from "../../chunks/chunk-YDIBNEGA.js";
 import "../../chunks/chunk-E6MSDKON.js";
-import "../../chunks/chunk-4QQBKBYH.js";
+import "../../chunks/chunk-SNJJII7A.js";
 import "../../chunks/chunk-QXAJXTXV.js";
 import "../../chunks/chunk-HC6ZOHCS.js";
 

package/agnostic/strings/index.js

@@ -1,6 +1,3 @@
-import {
-  replaceAll
-} from "../../chunks/chunk-MF56TTC5.js";
 import {
   CharCodes
 } from "../../chunks/chunk-34U4HX4V.js";
@@ -9,12 +6,15 @@ import {
   matchesEvery,
   matchesSome
 } from "../../chunks/chunk-LQFKUNVQ.js";
+import {
+  normalizeIndent
+} from "../../chunks/chunk-JQXNEJAP.js";
 import {
   toAlphanum
 } from "../../chunks/chunk-COVPTTAD.js";
 import {
-  normalizeIndent
-} from "../../chunks/chunk-JQXNEJAP.js";
+  replaceAll
+} from "../../chunks/chunk-MF56TTC5.js";
 
 // src/agnostic/strings/index.ts
 var Strings;

package/agnostic/time/index.js

@@ -1,12 +1,12 @@
 import {
-  timeout
-} from "../../chunks/chunk-Z7ZDDBV5.js";
+  Duration
+} from "../../chunks/chunk-6NYUQXJT.js";
 import {
   Transitions
 } from "../../chunks/chunk-ENMBK6H7.js";
 import {
-  Duration
-} from "../../chunks/chunk-6NYUQXJT.js";
+  timeout
+} from "../../chunks/chunk-Z7ZDDBV5.js";
 import {
   wait
 } from "../../chunks/chunk-4CIS3R7T.js";

package/chunks/chunk-BJAYUP7M.js

@@ -0,0 +1,13 @@
+// src/agnostic/numbers/interpolate/index.ts
+function interpolate(ratio, bound1, bound2) {
+  return bound1 + ratio * (bound2 - bound1);
+}
+function exterpolate(value, bound1, bound2) {
+  if (bound2 === void 0) return value / bound1;
+  return (value - bound1) / (bound2 - bound1);
+}
+
+export {
+  interpolate,
+  exterpolate
+};

package/chunks/chunk-BVCWBTHQ.js

@@ -0,0 +1,35 @@
+import {
+  register
+} from "./chunk-CAMYGA44.js";
+
+// src/agnostic/html/selector-to-element/index.ts
+function selectorToElement(selector, documentObj) {
+  const actualDocument = documentObj ?? window.document;
+  if (actualDocument === null) throw register.getError("no-window-document-on-runtime-please-provide" /* NO_DOCUMENT_PLEASE_PROVIDE */, "The optional second parameter expects a Document object");
+  const tagRegexp = /^[A-Za-z]+/;
+  const idRegexp = /#[A-Za-z]+[\w\-\:]*/;
+  const classRegexp = /\.[A-Za-z]+[\w\-]*/;
+  const attributeRegexp = /\[[A-Za-z]+[\w\-]*(="[\w\-]+")?\]/;
+  const matchedTags = selector.match(tagRegexp) ?? [];
+  const matchedIds = selector.match(idRegexp) ?? [];
+  const matchedClasses = selector.match(classRegexp) ?? [];
+  const matchedAttrs = selector.match(attributeRegexp) ?? [];
+  const tag = matchedTags[matchedTags.length - 1] ?? "div";
+  const id = matchedIds[matchedIds.length - 1] ?? null;
+  const classes = matchedClasses.map((matchedClass) => matchedClass.replace(/^\./, ""));
+  const attributes = matchedAttrs.map((matchedAttr) => matchedAttr.replace(/^\[/, "").replace(/\]$/, "").split("="));
+  const element = actualDocument.createElement(tag);
+  if (id !== null) {
+    element.id = id;
+  }
+  element.classList.add(...classes);
+  attributes.forEach(([name, value = ""]) => {
+    if (name === void 0) return;
+    element.setAttribute(name, value);
+  });
+  return element;
+}
+
+export {
+  selectorToElement
+};

package/chunks/chunk-C5753KUP.js

@@ -0,0 +1,127 @@
+import {
+  register
+} from "./chunk-CAMYGA44.js";
+
+// src/agnostic/html/sanitize/index.ts
+var Sanitize;
+((Sanitize2) => {
+  Sanitize2.defaultOptions = { depth: 20 };
+  function sanitize(inputStr, options = Sanitize2.defaultOptions) {
+    const actualDocument = options.documentObj ?? window.document;
+    if (actualDocument === null) throw register.getError("no-window-document-on-runtime-please-provide" /* NO_DOCUMENT_PLEASE_PROVIDE */, "See documentObj in the options object");
+    const wrapperDiv = actualDocument.createElement("div");
+    const { inputFreeTransform } = options;
+    wrapperDiv.innerHTML = inputFreeTransform !== void 0 ? inputFreeTransform(inputStr) : inputStr;
+    const sanitizedWrapper = sanitizeElement(wrapperDiv, options);
+    const returned = sanitizedWrapper?.innerHTML;
+    return returned ?? "";
+  }
+  Sanitize2.sanitize = sanitize;
+  function sanitizeElement(element, options = Sanitize2.defaultOptions) {
+    const actualDocument = options.documentObj ?? window.document;
+    if (actualDocument === null) throw register.getError("no-window-document-on-runtime-please-provide" /* NO_DOCUMENT_PLEASE_PROVIDE */, "See documentObj in the options object");
+    const { tagName, attributes, childNodes } = element;
+    const {
+      allowedTags = [],
+      allowedAttributes = {},
+      forbiddenTags = [],
+      forbiddenAttributes = {},
+      depth = 20,
+      verbose = false
+    } = options;
+    if (depth <= 0) {
+      console.warn("Max depth reached");
+      return null;
+    }
+    const normalizedTagName = tagName.toLowerCase().trim();
+    const tagIsInForbidden = forbiddenTags.includes("*") || forbiddenTags.includes(normalizedTagName);
+    if (tagIsInForbidden) {
+      if (verbose === true) console.warn(tagName, "tag is forbidden");
+      return null;
+    }
+    const tagIsInAllowed = allowedTags.includes("*") || allowedTags.includes(normalizedTagName);
+    if (!tagIsInAllowed) {
+      if (verbose === true) console.warn(tagName, "tag is not allowed");
+      return null;
+    }
+    const returnedElement = actualDocument.createElement(tagName);
+    const returnedAttributes = Array.from(attributes).filter(({ name: attributeName, value: attributeValue }) => {
+      const allTagsForbiddenAttributes = forbiddenAttributes["*"] ?? [];
+      const thisTagForbiddenAttributes = forbiddenAttributes[normalizedTagName] ?? [];
+      const mergedForbiddenAttributes = [...allTagsForbiddenAttributes, ...thisTagForbiddenAttributes];
+      const isInForbidden = mergedForbiddenAttributes.some(({
+        attributeName: nameTester,
+        attributeValues: valTesters
+      }) => {
+        if (typeof nameTester === "string" && nameTester !== "*" && attributeName !== nameTester) return false;
+        if (typeof nameTester !== "string" && !nameTester.test(attributeName)) return false;
+        if (valTesters === void 0) {
+          if (verbose === true) console.warn(attributeName, "attribute on", tagName, "tag is forbidden");
+          return true;
+        }
+        if (valTesters.includes("*")) {
+          if (verbose === true) console.warn(attributeName, "attribute on", tagName, "tag is forbidden");
+          return true;
+        }
+        return valTesters.some((valTester) => {
+          if (typeof valTester === "string" && attributeValue === valTester) {
+            if (verbose === true) console.warn(attributeValue, "value for", attributeName, "attribute on", tagName, "tag is forbidden. Rule:", valTester);
+            return true;
+          }
+          if (typeof valTester !== "string" && valTester.test(attributeValue)) {
+            if (verbose === true) console.warn(attributeValue, "value for", attributeName, "attribute on", tagName, "tag is forbidden. Rule:", valTester);
+            return true;
+          }
+          return false;
+        });
+      });
+      if (isInForbidden) return false;
+      const allTagsAllowedAttributes = allowedAttributes["*"] ?? [];
+      const thisTagAllowedAttributes = allowedAttributes[normalizedTagName] ?? [];
+      const mergedAllowedAttributes = [...allTagsAllowedAttributes, ...thisTagAllowedAttributes];
+      let latestNotAllowedReason = [tagName, "has no allowed attributes"];
+      const isInAllowed = mergedAllowedAttributes.some(({
+        attributeName: nameTester,
+        attributeValues: valTesters
+      }) => {
+        if (typeof nameTester === "string" && nameTester !== "*" && attributeName !== nameTester) {
+          latestNotAllowedReason = [attributeName, "attribute on", tagName, "tag is not allowed"];
+          return false;
+        }
+        if (typeof nameTester !== "string" && !nameTester.test(attributeName)) {
+          latestNotAllowedReason = [attributeName, "attribute on", tagName, "tag is not allowed"];
+          return false;
+        }
+        if (valTesters === void 0) return true;
+        if (valTesters.includes("*")) return true;
+        return valTesters.some((valTester) => {
+          if (typeof valTester === "string" && attributeValue === valTester) return true;
+          if (typeof valTester !== "string" && valTester.test(attributeValue)) return true;
+          latestNotAllowedReason = [attributeValue, "value for", attributeName, "attribute on", tagName, "tag is not allowed"];
+          return false;
+        });
+      });
+      if (!isInAllowed) {
+        if (verbose === true) console.warn(...latestNotAllowedReason);
+        return false;
+      }
+      return true;
+    });
+    returnedAttributes.forEach(({ name, value }) => {
+      returnedElement.setAttribute(name, value);
+    });
+    const sanitizedChildNodes = Array.from(childNodes).map((node) => {
+      if (node.nodeType === Node.ELEMENT_NODE) return sanitizeElement(node, { ...options, depth: depth - 1 });
+      else if (node.nodeType === Node.TEXT_NODE) return node;
+      else if (options.keepComments === true && node.nodeType === Node.COMMENT_NODE) return node;
+      return null;
+    }).filter((elt) => elt !== null);
+    returnedElement.replaceChildren(...sanitizedChildNodes);
+    return returnedElement;
+  }
+  Sanitize2.sanitizeElement = sanitizeElement;
+})(Sanitize || (Sanitize = {}));
+
+export {
+  Sanitize
+};

package/chunks/chunk-CAMYGA44.js

@@ -0,0 +1,22 @@
+import {
+  Crossenv
+} from "./chunk-FR5H2OCV.js";
+import {
+  Errors
+} from "./chunk-WH6BPDAC.js";
+
+// src/shared/errors/index.ts
+var register = Errors.Register.from({
+  ["no-window-document-on-runtime" /* NO_DOCUMENT */]: {
+    message: `Runtime '${Crossenv.detectRuntime()}' does not provide a Document object, cannot complete.`,
+    detailsMaker: () => void 0
+  },
+  ["no-window-document-on-runtime-please-provide" /* NO_DOCUMENT_PLEASE_PROVIDE */]: {
+    message: `Please provide a Document object since none are found on runtime '${Crossenv.detectRuntime()}'`,
+    detailsMaker: (tips) => tips
+  }
+});
+
+export {
+  register
+};

package/chunks/chunk-FR5H2OCV.js

@@ -0,0 +1,21 @@
+import {
+  detectRuntime
+} from "./chunk-S2NMAH7K.js";
+import {
+  Types
+} from "./chunk-LV2VMOWR.js";
+import {
+  Window
+} from "./chunk-RLJOYG64.js";
+
+// src/agnostic/misc/crossenv/index.ts
+var Crossenv;
+((Crossenv2) => {
+  Crossenv2.detectRuntime = detectRuntime;
+  Crossenv2.Types = Types;
+  Crossenv2.Window = Window;
+})(Crossenv || (Crossenv = {}));
+
+export {
+  Crossenv
+};

package/chunks/chunk-GPWFYPER.js

@@ -0,0 +1,211 @@
+import {
+  findDuplicates
+} from "./chunk-YS6WMSWC.js";
+import {
+  make
+} from "./chunk-RLAZR3NL.js";
+import {
+  isArrayOf
+} from "./chunk-6RGDWX4A.js";
+import {
+  RANDOM_PICK_ERR_SYMBOL,
+  randomPick
+} from "./chunk-FCU6IHKD.js";
+import {
+  Random
+} from "./chunk-S32K7POB.js";
+
+// src/agnostic/arrays/index.tsx
+var Arrays;
+((Arrays2) => {
+  Arrays2.findDuplicates = findDuplicates;
+  Arrays2.isArrayOf = isArrayOf;
+  Arrays2.make = make;
+  Arrays2.RANDOM_PICK_ERR_SYMBOL = RANDOM_PICK_ERR_SYMBOL;
+  Arrays2.randomPick = randomPick;
+})(Arrays || (Arrays = {}));
+
+// src/agnostic/misc/lorem-ipsum/index.ts
+var LoremIpsum;
+((LoremIpsum2) => {
+  LoremIpsum2.words = [
+    "a",
+    "ac",
+    "accumsan",
+    "adipiscing",
+    "aenean",
+    "aliquam",
+    "aliquet",
+    "amet",
+    "ante",
+    "arcu",
+    "at",
+    "auctor",
+    "augue",
+    "bibendum",
+    "blandit",
+    "condimentum",
+    "consectetur",
+    "consequat",
+    "convallis",
+    "cras",
+    "curabitur",
+    "cursus",
+    "dapibus",
+    "diam",
+    "dictum",
+    "dictumst",
+    "dignissim",
+    "dolor",
+    "donec",
+    "dui",
+    "duis",
+    "efficitur",
+    "egestas",
+    "eget",
+    "eleifend",
+    "elementum",
+    "elit",
+    "enim",
+    "erat",
+    "eros",
+    "est",
+    "et",
+    "eu",
+    "euismod",
+    "ex",
+    "facilisis",
+    "faucibus",
+    "felis",
+    "feugiat",
+    "finibus",
+    "fringilla",
+    "fusce",
+    "gravida",
+    "habitasse",
+    "hac",
+    "hendrerit",
+    "iaculis",
+    "id",
+    "imperdiet",
+    "in",
+    "integer",
+    "interdum",
+    "ipsum",
+    "justo",
+    "lacinia",
+    "lacus",
+    "laoreet",
+    "lectus",
+    "leo",
+    "libero",
+    "ligula",
+    "lobortis",
+    "lorem",
+    "luctus",
+    "maecenas",
+    "magna",
+    "malesuada",
+    "massa",
+    "mattis",
+    "mauris",
+    "maximus",
+    "metus",
+    "mi",
+    "molestie",
+    "mollis",
+    "morbi",
+    "nam",
+    "nec",
+    "neque",
+    "nibh",
+    "nisi",
+    "nisl",
+    "non",
+    "nulla",
+    "nullam",
+    "nunc",
+    "odio",
+    "orci",
+    "ornare",
+    "pellentesque",
+    "pharetra",
+    "phasellus",
+    "placerat",
+    "platea",
+    "porta",
+    "porttitor",
+    "posuere",
+    "praesent",
+    "pulvinar",
+    "purus",
+    "quam",
+    "quis",
+    "quisque",
+    "risus",
+    "rutrum",
+    "sagittis",
+    "sapien",
+    "sed",
+    "sem",
+    "semper",
+    "sit",
+    "sodales",
+    "sollicitudin",
+    "suscipit",
+    "suspendisse",
+    "tellus",
+    "tempor",
+    "tempus",
+    "tincidunt",
+    "tortor",
+    "tristique",
+    "turpis",
+    "ultrices",
+    "ultricies",
+    "urna",
+    "ut",
+    "vehicula",
+    "vel",
+    "velit",
+    "venenatis",
+    "vestibulum",
+    "vitae",
+    "vivamus",
+    "viverra",
+    "volutpat",
+    "vulputate"
+  ];
+  LoremIpsum2.generateSentence = (wordCount) => {
+    const resultArr = [];
+    let currentWordCound = wordCount;
+    for (let i = 0; i < currentWordCound; i++) {
+      const picked = Arrays.randomPick(LoremIpsum2.words);
+      if (typeof picked === "string") resultArr.push(picked);
+      else {
+        currentWordCound += 1;
+      }
+    }
+    const [firstWord, ...otherWords] = resultArr;
+    if (firstWord === void 0) return "";
+    const capFirstLetter = firstWord?.charAt(0).toUpperCase();
+    const restOfFirstWord = firstWord?.slice(1);
+    const sentence = [
+      `${capFirstLetter}${restOfFirstWord}`,
+      ...otherWords
+    ].join(" ");
+    return `${sentence}.`;
+  };
+  LoremIpsum2.generateSentences = (sentencesCount, maxSentenceLength = 12, minSentenceLength = 4) => {
+    const sentences = [];
+    for (let i = 0; i < sentencesCount; i++) {
+      const length = Random.randomInt(maxSentenceLength, minSentenceLength) ?? 8;
+      sentences.push((0, LoremIpsum2.generateSentence)(length));
+    }
+    return sentences;
+  };
+})(LoremIpsum || (LoremIpsum = {}));
+
+export {
+  LoremIpsum
+};

package/chunks/chunk-LUPVHC73.js

@@ -0,0 +1,17 @@
+// src/agnostic/html/get-node-ancestors/index.ts
+function getNodeAncestors(node, traverseShadowRoots) {
+  const returned = [];
+  let currentNode = node;
+  while (currentNode !== null) {
+    returned.push(currentNode);
+    const parentNode = currentNode.parentNode;
+    const parentElement = currentNode.parentElement;
+    const nextNode = parentNode instanceof ShadowRoot ? traverseShadowRoots ? parentNode.host : parentElement : parentElement;
+    currentNode = nextNode;
+  }
+  return returned;
+}
+
+export {
+  getNodeAncestors
+};

package/chunks/chunk-NFUY7SLX.js

@@ -0,0 +1,211 @@
+import {
+  findDuplicates
+} from "./chunk-YS6WMSWC.js";
+import {
+  make
+} from "./chunk-RLAZR3NL.js";
+import {
+  RANDOM_PICK_ERR_SYMBOL,
+  randomPick
+} from "./chunk-FCU6IHKD.js";
+import {
+  isArrayOf
+} from "./chunk-6RGDWX4A.js";
+import {
+  Random
+} from "./chunk-S32K7POB.js";
+
+// src/agnostic/arrays/index.tsx
+var Arrays;
+((Arrays2) => {
+  Arrays2.findDuplicates = findDuplicates;
+  Arrays2.isArrayOf = isArrayOf;
+  Arrays2.make = make;
+  Arrays2.RANDOM_PICK_ERR_SYMBOL = RANDOM_PICK_ERR_SYMBOL;
+  Arrays2.randomPick = randomPick;
+})(Arrays || (Arrays = {}));
+
+// src/agnostic/misc/lorem-ipsum/index.ts
+var LoremIpsum;
+((LoremIpsum2) => {
+  LoremIpsum2.words = [
+    "a",
+    "ac",
+    "accumsan",
+    "adipiscing",
+    "aenean",
+    "aliquam",
+    "aliquet",
+    "amet",
+    "ante",
+    "arcu",
+    "at",
+    "auctor",
+    "augue",
+    "bibendum",
+    "blandit",
+    "condimentum",
+    "consectetur",
+    "consequat",
+    "convallis",
+    "cras",
+    "curabitur",
+    "cursus",
+    "dapibus",
+    "diam",
+    "dictum",
+    "dictumst",
+    "dignissim",
+    "dolor",
+    "donec",
+    "dui",
+    "duis",
+    "efficitur",
+    "egestas",
+    "eget",
+    "eleifend",
+    "elementum",
+    "elit",
+    "enim",
+    "erat",
+    "eros",
+    "est",
+    "et",
+    "eu",
+    "euismod",
+    "ex",
+    "facilisis",
+    "faucibus",
+    "felis",
+    "feugiat",
+    "finibus",
+    "fringilla",
+    "fusce",
+    "gravida",
+    "habitasse",
+    "hac",
+    "hendrerit",
+    "iaculis",
+    "id",
+    "imperdiet",
+    "in",
+    "integer",
+    "interdum",
+    "ipsum",
+    "justo",
+    "lacinia",
+    "lacus",
+    "laoreet",
+    "lectus",
+    "leo",
+    "libero",
+    "ligula",
+    "lobortis",
+    "lorem",
+    "luctus",
+    "maecenas",
+    "magna",
+    "malesuada",
+    "massa",
+    "mattis",
+    "mauris",
+    "maximus",
+    "metus",
+    "mi",
+    "molestie",
+    "mollis",
+    "morbi",
+    "nam",
+    "nec",
+    "neque",
+    "nibh",
+    "nisi",
+    "nisl",
+    "non",
+    "nulla",
+    "nullam",
+    "nunc",
+    "odio",
+    "orci",
+    "ornare",
+    "pellentesque",
+    "pharetra",
+    "phasellus",
+    "placerat",
+    "platea",
+    "porta",
+    "porttitor",
+    "posuere",
+    "praesent",
+    "pulvinar",
+    "purus",
+    "quam",
+    "quis",
+    "quisque",
+    "risus",
+    "rutrum",
+    "sagittis",
+    "sapien",
+    "sed",
+    "sem",
+    "semper",
+    "sit",
+    "sodales",
+    "sollicitudin",
+    "suscipit",
+    "suspendisse",
+    "tellus",
+    "tempor",
+    "tempus",
+    "tincidunt",
+    "tortor",
+    "tristique",
+    "turpis",
+    "ultrices",
+    "ultricies",
+    "urna",
+    "ut",
+    "vehicula",
+    "vel",
+    "velit",
+    "venenatis",
+    "vestibulum",
+    "vitae",
+    "vivamus",
+    "viverra",
+    "volutpat",
+    "vulputate"
+  ];
+  LoremIpsum2.generateSentence = (wordCount) => {
+    const resultArr = [];
+    let currentWordCound = wordCount;
+    for (let i = 0; i < currentWordCound; i++) {
+      const picked = Arrays.randomPick(LoremIpsum2.words);
+      if (typeof picked === "string") resultArr.push(picked);
+      else {
+        currentWordCound += 1;
+      }
+    }
+    const [firstWord, ...otherWords] = resultArr;
+    if (firstWord === void 0) return "";
+    const capFirstLetter = firstWord?.charAt(0).toUpperCase();
+    const restOfFirstWord = firstWord?.slice(1);
+    const sentence = [
+      `${capFirstLetter}${restOfFirstWord}`,
+      ...otherWords
+    ].join(" ");
+    return `${sentence}.`;
+  };
+  LoremIpsum2.generateSentences = (sentencesCount, maxSentenceLength = 12, minSentenceLength = 4) => {
+    const sentences = [];
+    for (let i = 0; i < sentencesCount; i++) {
+      const length = Random.randomInt(maxSentenceLength, minSentenceLength) ?? 8;
+      sentences.push((0, LoremIpsum2.generateSentence)(length));
+    }
+    return sentences;
+  };
+})(LoremIpsum || (LoremIpsum = {}));
+
+export {
+  LoremIpsum
+};

package/chunks/chunk-SNJJII7A.js

@@ -0,0 +1,65 @@
+import {
+  isFalsy
+} from "./chunk-QXAJXTXV.js";
+
+// src/agnostic/misc/cast/index.ts
+var Cast;
+((Cast2) => {
+  function toBoolean(value) {
+    if (typeof value === "boolean") return value;
+    if (typeof value === "string") {
+      if (value.toLowerCase().trim() === "true") return true;
+      return false;
+    }
+    return !isFalsy(value);
+  }
+  Cast2.toBoolean = toBoolean;
+  function toNumber(value) {
+    if (typeof value === "number") return value;
+    if (typeof value === "string") return parseFloat(value);
+    return 0;
+  }
+  Cast2.toNumber = toNumber;
+  function toString(value) {
+    if (typeof value === "string") return value;
+    return String(value);
+  }
+  Cast2.toString = toString;
+  function toNull(_value) {
+    return null;
+  }
+  Cast2.toNull = toNull;
+  function toArray(value) {
+    if (Array.isArray(value)) return value;
+    if (typeof value === "object" && value !== null) return Object.entries(value).map((key, value2) => ({ key, value: value2 }));
+    return [value];
+  }
+  Cast2.toArray = toArray;
+  function toNumberArr(value) {
+    const arrValue = toArray(value);
+    return arrValue.map((val) => toNumber(val));
+  }
+  Cast2.toNumberArr = toNumberArr;
+  function toRecord(value) {
+    const record = {};
+    try {
+      Object.keys(value).forEach((key) => {
+        record[key] = value[key];
+      });
+    } catch (err) {
+      return record;
+    }
+    return record;
+  }
+  Cast2.toRecord = toRecord;
+  function toError(value) {
+    if (value instanceof Error) return value;
+    if (typeof value === "string") return new Error(value);
+    return new Error(toString(value));
+  }
+  Cast2.toError = toError;
+})(Cast || (Cast = {}));
+
+export {
+  Cast
+};

package/chunks/chunk-VFJYLXCI.js

@@ -0,0 +1,23 @@
+import {
+  Cast
+} from "./chunk-SNJJII7A.js";
+
+// src/agnostic/objects/flatten-getters/index.ts
+function flattenGetters(obj) {
+  try {
+    const { entries, getOwnPropertyDescriptors } = Object;
+    const properties = Cast.toRecord(obj);
+    const getters = entries(getOwnPropertyDescriptors(obj)).filter(([_, desc]) => typeof desc.get === "function").map(([key]) => key);
+    const returned = { ...properties };
+    getters.forEach((getter) => {
+      returned[getter] = obj[getter];
+    });
+    return returned;
+  } catch (err) {
+    return {};
+  }
+}
+
+export {
+  flattenGetters
+};

package/chunks/chunk-VKURVIRV.js

@@ -0,0 +1,28 @@
+import {
+  Sanitize
+} from "./chunk-C5753KUP.js";
+import {
+  register
+} from "./chunk-CAMYGA44.js";
+
+// src/agnostic/html/string-to-nodes/index.ts
+function stringToNodes(dirtyStr, options) {
+  const actualDocument = options?.documentObj ?? window.document;
+  if (actualDocument === null) throw register.getError("no-window-document-on-runtime-please-provide" /* NO_DOCUMENT_PLEASE_PROVIDE */, "See documentObj in the options object");
+  const sanitizeOptions = {
+    ...options?.sanitize,
+    documentObj: options?.sanitize?.documentObj ?? options?.documentObj
+  };
+  const str = options?.sanitize !== void 0 ? Sanitize.sanitize(dirtyStr, sanitizeOptions) : dirtyStr;
+  const wrapperDiv = actualDocument.createElement("div");
+  wrapperDiv.innerHTML = str;
+  const nodes = Array.from(wrapperDiv.childNodes).filter((node) => {
+    const allowedNodeTypes = [Node.ELEMENT_NODE, Node.TEXT_NODE];
+    return allowedNodeTypes.includes(node.nodeType);
+  });
+  return nodes;
+}
+
+export {
+  stringToNodes
+};

package/node/files/index.js

@@ -1,12 +1,12 @@
-import {
-  readWrite
-} from "../../chunks/chunk-7DBNMU6N.js";
 import {
   isInDirectory
 } from "../../chunks/chunk-NRITRUZW.js";
 import {
   Subpaths
 } from "../../chunks/chunk-HGCG2J77.js";
+import {
+  readWrite
+} from "../../chunks/chunk-7DBNMU6N.js";
 import "../../chunks/chunk-LQFKUNVQ.js";
 
 // src/node/files/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@design-edito/tools",
-  "version": "0.1.30",
+  "version": "0.1.31",
   "description": "",
   "author": "Maxime Fabas",
   "license": "ISC",