@design-edito/tools 0.1.44 → 0.1.45

package/chunks/chunk-SBAY4ZKE.js

@@ -0,0 +1,211 @@
+import {
+  Random
+} from "./chunk-OVG5RGI3.js";
+import {
+  findDuplicates
+} from "./chunk-YS6WMSWC.js";
+import {
+  isArrayOf
+} from "./chunk-6RGDWX4A.js";
+import {
+  make
+} from "./chunk-RLAZR3NL.js";
+import {
+  randomPick,
+  randomPickMany
+} from "./chunk-AQBJ6HNB.js";
+
+// src/agnostic/arrays/index.tsx
+var Arrays;
+((Arrays2) => {
+  Arrays2.findDuplicates = findDuplicates;
+  Arrays2.isArrayOf = isArrayOf;
+  Arrays2.make = make;
+  Arrays2.randomPick = randomPick;
+  Arrays2.randomPickMany = randomPickMany;
+})(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-SKBOSWM2.js

@@ -0,0 +1,35 @@
+import {
+  register
+} from "./chunk-TIER4TF4.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-TIER4TF4.js

@@ -0,0 +1,26 @@
+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
+  },
+  ["impossible-to-pick-in-array" /* IMPOSSIBLE_TO_PICK_IN_ARRAY */]: {
+    message: "Impossible to pick",
+    detailsMaker: (array) => array.length === 0 ? "Array cannot be empty" : "Too many exclusions"
+  }
+});
+
+export {
+  register
+};

package/chunks/chunk-XB3EGDBI.js

@@ -0,0 +1,127 @@
+import {
+  register
+} from "./chunk-TIER4TF4.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
+};