@design-edito/tools 0.1.20 → 0.1.22

package/chunks/chunk-3UURICGY.js

@@ -0,0 +1,211 @@
+import {
+  Random
+} from "./chunk-R6KCN6CK.js";
+import {
+  isArrayOf
+} from "./chunk-6RGDWX4A.js";
+import {
+  findDuplicates
+} from "./chunk-YS6WMSWC.js";
+import {
+  RANDOM_PICK_ERR_SYMBOL,
+  randomPick
+} from "./chunk-FCU6IHKD.js";
+import {
+  make
+} from "./chunk-RLAZR3NL.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-3X6RXJBR.js

@@ -0,0 +1,37 @@
+import {
+  Cast
+} from "./chunk-QO64L4KB.js";
+import {
+  Crossenv
+} from "./chunk-3LVR6KZH.js";
+import {
+  Utils
+} from "./chunk-YEBOL67V.js";
+
+// src/agnostic/html/hyper-json/transformers/ref/index.ts
+var ref = (callerTagName, ...args) => {
+  return Utils.toNamedTransformer(callerTagName, (_, callerTree) => {
+    const [refPathStrRaw] = args;
+    const { Text } = Crossenv.getWindow();
+    if (typeof refPathStrRaw !== "string" && !(refPathStrRaw instanceof Text)) return Utils.makeTransformerError({
+      message: "PathString must be of type string or Text",
+      input: refPathStrRaw !== void 0 ? refPathStrRaw : "<undefined>"
+    });
+    const refPathStr = Cast.toString(refPathStrRaw);
+    const refPath = Utils.pathStringToPath(Cast.toString(refPathStrRaw));
+    const foundTree = callerTree.resolve(refPath);
+    if (foundTree === void 0) return Utils.makeTransformerError({
+      message: "Referenced value has not been found",
+      input: refPathStr
+    });
+    const evaluated = foundTree.evaluate();
+    return {
+      action: "MERGE",
+      value: evaluated
+    };
+  });
+};
+
+export {
+  ref
+};

package/chunks/{chunk-DQNJQBC6.js → chunk-4CIS3R7T.js}

@@ -1,4 +1,4 @@
-// src/agnostic/async/wait/index.ts
+// src/agnostic/time/wait/index.ts
 async function wait(durationMs) {
   return new Promise((resolve) => {
     setTimeout(() => resolve(true), durationMs);

package/chunks/chunk-4F7ZVE7T.js

@@ -0,0 +1,332 @@
+import {
+  Types
+} from "./chunk-3KQRMKQJ.js";
+import {
+  Serialize
+} from "./chunk-DRNK3RLE.js";
+import {
+  Cast
+} from "./chunk-AMS3FB24.js";
+import {
+  Crossenv
+} from "./chunk-3LVR6KZH.js";
+import {
+  isRecord
+} from "./chunk-YDIBNEGA.js";
+
+// src/agnostic/html/hyper-json/tree/index.ts
+var getWindow = Crossenv.getWindow;
+var isElement = (node) => node.nodeType === getWindow().Node.ELEMENT_NODE;
+var isText = (node) => node.nodeType === getWindow().Node.TEXT_NODE;
+var Tree = class _Tree {
+  node;
+  name;
+  parent;
+  root;
+  isRoot;
+  path;
+  pathString;
+  tagName;
+  attributes;
+  subtrees = /* @__PURE__ */ new Map();
+  children;
+  type;
+  generators;
+  constructor(node, generatorsOrParent, pathFromParent) {
+    this.resolve = this.resolve.bind(this);
+    this.getGenerator = this.getGenerator.bind(this);
+    this.initValue = this.initValue.bind(this);
+    this.mergeValues = this.mergeValues.bind(this);
+    this.getInnerValue = this.getInnerValue.bind(this);
+    this.wrapInnerValue = this.wrapInnerValue.bind(this);
+    this.setCache = this.setCache.bind(this);
+    this.getPerfCounters = this.getPerfCounters.bind(this);
+    this.printPerfCounters = this.printPerfCounters.bind(this);
+    this.pushToEvalCallStack = this.pushToEvalCallStack.bind(this);
+    this.flushEvalCallStack = this.flushEvalCallStack.bind(this);
+    this.evaluate = this.evaluate.bind(this);
+    let parent;
+    let generators;
+    if (pathFromParent === void 0) {
+      parent = null;
+      generators = generatorsOrParent;
+    } else {
+      parent = generatorsOrParent;
+      generators = /* @__PURE__ */ new Map();
+    }
+    this.node = node;
+    this.name = this.node instanceof getWindow().Element ? this.node.getAttribute("_name") : null;
+    this.parent = parent;
+    this.root = this.parent === null ? this : this.parent.root;
+    this.isRoot = this.root === this;
+    this.generators = this.isRoot ? generators : this.root.generators;
+    if (this.parent === null) this.path = [];
+    else if (pathFromParent === void 0) {
+      this.path = [...this.parent.path, 0];
+    } else {
+      this.path = [...this.parent.path, pathFromParent];
+    }
+    this.pathString = `/${this.path.join("/")}`;
+    this.tagName = node instanceof getWindow().Element ? node.tagName.toLowerCase() : null;
+    this.attributes = isElement(node) ? Array.from(node.attributes) : null;
+    const { childNodes } = node;
+    let positionnedChildrenCount = 0;
+    const mutableSubtrees = /* @__PURE__ */ new Map();
+    Array.from(childNodes).filter((node2, _, nodes) => {
+      if (isElement(node2)) return true;
+      if (isText(node2)) {
+        const hasContent = (node2.textContent ?? "").trim() !== "";
+        if (hasContent) return true;
+        if (nodes.some((n) => n instanceof getWindow().Element)) return false;
+        return true;
+      }
+      return false;
+    }).forEach((childNode) => {
+      if (childNode instanceof getWindow().Text) {
+        mutableSubtrees.set(
+          positionnedChildrenCount,
+          new _Tree(childNode, this, positionnedChildrenCount)
+        );
+        positionnedChildrenCount += 1;
+      } else {
+        const propertyName = childNode.getAttribute("_name");
+        if (propertyName === null) {
+          mutableSubtrees.set(
+            positionnedChildrenCount,
+            new _Tree(childNode, this, positionnedChildrenCount)
+          );
+          positionnedChildrenCount += 1;
+        } else {
+          mutableSubtrees.set(
+            propertyName,
+            new _Tree(childNode, this, propertyName)
+          );
+        }
+      }
+    });
+    this.subtrees = mutableSubtrees;
+    this.children = Array.from(this.subtrees.values());
+    if (this.tagName === null) {
+      this.type = "text";
+    } else if (this.tagName === Types.TyperTagName.NULL) {
+      this.type = "null";
+    } else if (this.tagName === Types.TyperTagName.BOOLEAN) {
+      this.type = "boolean";
+    } else if (this.tagName === Types.TyperTagName.NUMBER) {
+      this.type = "number";
+    } else if (this.tagName === Types.TyperTagName.STRING) {
+      this.type = "string";
+    } else if (this.tagName === Types.TyperTagName.TEXT) {
+      this.type = "text";
+    } else if (this.tagName === Types.TyperTagName.NODELIST) {
+      this.type = "nodelist";
+    } else if (this.tagName === Types.TyperTagName.ARRAY) {
+      this.type = "array";
+    } else if (this.tagName === Types.TyperTagName.RECORD) {
+      this.type = "record";
+    } else if (this.getGenerator(this.tagName) !== void 0) {
+      this.type = "transformer";
+    } else {
+      this.type = "element";
+    }
+  }
+  resolve = function(path) {
+    let currentTree = this.root;
+    for (const chunk of path) {
+      const { subtrees } = currentTree;
+      const foundSubtree = subtrees.get(chunk);
+      if (foundSubtree === void 0) return void 0;
+      currentTree = foundSubtree;
+    }
+    return currentTree;
+  };
+  getGenerator(name) {
+    return this.generators.get(name);
+  }
+  initValue() {
+    const { type } = this;
+    let currentValue;
+    if (type === "null") {
+      currentValue = null;
+    } else if (type === "boolean") {
+      currentValue = false;
+    } else if (type === "number") {
+      currentValue = 0;
+    } else if (type === "string") {
+      currentValue = "";
+    } else if (type === "text") {
+      currentValue = this.node.textContent;
+    } else if (type === "element") {
+      currentValue = getWindow().document.createDocumentFragment().childNodes;
+    } else if (type === "nodelist") {
+      currentValue = getWindow().document.createDocumentFragment().childNodes;
+    } else if (type === "array") {
+      currentValue = [];
+    } else if (type === "record") {
+      currentValue = {};
+    } else if (type === "transformer") {
+      currentValue = [];
+    } else {
+      currentValue = null;
+    }
+    return currentValue;
+  }
+  mergeValues(currentValue, incomingValue, mergeKey) {
+    const { Element, Text, NodeList, document } = getWindow();
+    if (typeof incomingValue === "function") {
+      const evaluated = incomingValue(currentValue, { resolver: this.resolve });
+      if (evaluated.action === null) return currentValue;
+      if (evaluated.action === "REPLACE") return evaluated.value;
+      return this.mergeValues(currentValue, evaluated.value, mergeKey);
+    }
+    if (Array.isArray(currentValue)) {
+      if (typeof mergeKey === "string") return currentValue;
+      return [...currentValue, incomingValue];
+    }
+    if (currentValue === null || typeof currentValue === "boolean" || typeof currentValue === "number" || typeof currentValue === "string" || typeof currentValue === "function" || currentValue instanceof Text || currentValue instanceof Element) {
+      if (incomingValue === null || typeof incomingValue === "boolean" || typeof incomingValue === "number" || typeof incomingValue === "string" || Array.isArray(incomingValue) || isRecord(incomingValue)) {
+        return incomingValue;
+      }
+      const frag = document.createDocumentFragment();
+      if (currentValue instanceof Element || currentValue instanceof Text) frag.append(currentValue.cloneNode(true));
+      else frag.append(`${currentValue}`);
+      if (incomingValue instanceof Element || incomingValue instanceof Text) {
+        frag.append(incomingValue.cloneNode(true));
+        return frag.childNodes;
+      }
+      frag.append(...Array.from(incomingValue).map((e) => e.cloneNode(true)));
+      return frag.childNodes;
+    }
+    if (currentValue instanceof NodeList) {
+      if (incomingValue instanceof Element || incomingValue instanceof Text) {
+        const frag = document.createDocumentFragment();
+        frag.append(...Array.from(currentValue).map((e) => e.cloneNode(true)), incomingValue);
+        return frag.childNodes;
+      }
+      if (incomingValue instanceof NodeList) {
+        const frag = document.createDocumentFragment();
+        frag.append(
+          ...Array.from(currentValue).map((e) => e.cloneNode(true)),
+          ...Array.from(incomingValue).map((e) => e.cloneNode(true))
+        );
+        return frag.childNodes;
+      }
+      if (incomingValue === null || typeof incomingValue === "string" || typeof incomingValue === "number" || typeof incomingValue === "boolean") {
+        const frag = document.createDocumentFragment();
+        frag.append(...Array.from(currentValue).map((e) => e.cloneNode(true)), `${incomingValue}`);
+        return frag.childNodes;
+      }
+      if (Array.isArray(incomingValue)) return [
+        ...Array.from(currentValue),
+        ...incomingValue
+      ];
+      return { ...incomingValue };
+    }
+    if (typeof mergeKey === "number") return currentValue;
+    return {
+      ...currentValue,
+      [mergeKey]: incomingValue
+    };
+  }
+  getInnerValue(initialValue) {
+    const { subtrees } = this;
+    const innerValue = Array.from(subtrees.entries()).reduce((currentValue, [subpath, subtree]) => this.mergeValues(
+      currentValue,
+      subtree.evaluate(),
+      subpath
+    ), initialValue);
+    return innerValue;
+  }
+  wrapInnerValue(innerValue) {
+    const { type } = this;
+    if (type === "transformer") {
+      const transformerName = this.tagName;
+      if (transformerName === null) return innerValue;
+      const generator = this.getGenerator(transformerName);
+      if (generator === void 0) return innerValue;
+      const transformer = Array.isArray(innerValue) ? generator(...innerValue) : generator(innerValue);
+      return transformer;
+    }
+    if (type === "null") return Cast.toNull();
+    if (type === "boolean") return Cast.toBoolean(innerValue);
+    if (type === "number") return Cast.toNumber(innerValue);
+    if (type === "string") return Cast.toString(innerValue);
+    if (type === "array") return Cast.toArray(innerValue);
+    if (type === "record") return Cast.toRecord(innerValue);
+    if (type === "text") return Cast.toText(innerValue);
+    if (type === "element") return Cast.toElement(innerValue);
+    if (type === "nodelist") return Cast.toNodeList(innerValue);
+    return Cast.toNull();
+  }
+  cache = void 0;
+  setCache(value) {
+    this.cache = Serialize.serialize(value);
+  }
+  perfCounters = {
+    computed: 0,
+    computeTime: 0,
+    computeTimeAvg: 0,
+    cached: 0,
+    cacheTime: 0,
+    cacheTimeAvg: 0,
+    totalTime: 0
+  };
+  getPerfCounters() {
+    const { subtrees } = this;
+    const subCounters = [];
+    subCounters.push([this.pathString, this.perfCounters]);
+    subtrees.forEach((subtree) => subCounters.push(...subtree.getPerfCounters()));
+    return subCounters;
+  }
+  printPerfCounters() {
+    const perfCounters = this.getPerfCounters().sort((a, b) => b[1].totalTime - a[1].totalTime).map((e) => ({
+      path: e[0],
+      totalMs: e[1].totalTime,
+      computeMs: e[1].computeTime,
+      cacheMs: e[1].cacheTime,
+      ops: `${e[1].computed}/${e[1].cached}`
+    }));
+    console.table(perfCounters);
+  }
+  callstack = [];
+  pushToEvalCallStack(path) {
+    this.callstack.push(path);
+    this.parent?.pushToEvalCallStack(path);
+  }
+  flushEvalCallStack() {
+    this.callstack.length = 0;
+  }
+  evaluate() {
+    const start = Date.now();
+    const circularPatternDetected = this.callstack.some((p) => p.startsWith(this.pathString));
+    if (circularPatternDetected) throw new Error(`Circular reference pattern detected @ ${this.pathString}`);
+    this.pushToEvalCallStack(this.pathString);
+    const { perfCounters, cache } = this;
+    if (cache !== void 0) {
+      const deserialized = Serialize.deserialize(cache);
+      const end2 = Date.now();
+      const time2 = end2 - start;
+      perfCounters.cached++;
+      perfCounters.cacheTime += time2;
+      perfCounters.cacheTimeAvg = perfCounters.cacheTime / perfCounters.cached;
+      perfCounters.totalTime = perfCounters.computeTime + perfCounters.cacheTime;
+      return deserialized;
+    }
+    const init = this.initValue();
+    const inner = this.getInnerValue(init);
+    const wrapped = this.wrapInnerValue(inner);
+    this.setCache(wrapped);
+    const end = Date.now();
+    const time = end - start;
+    perfCounters.computed++;
+    perfCounters.computeTime += time;
+    perfCounters.computeTimeAvg = perfCounters.computeTime / perfCounters.computed;
+    perfCounters.totalTime = perfCounters.computeTime + perfCounters.cacheTime;
+    this.flushEvalCallStack();
+    return wrapped;
+  }
+};
+
+export {
+  Tree
+};

package/chunks/chunk-4GUDL44X.js

@@ -0,0 +1,13 @@
+// src/agnostic/misc/crossenv/get-window/index.ts
+async function getWindow() {
+  if (window !== void 0) return window;
+  else {
+    const { JSDOM } = await import("jsdom");
+    const dom = new JSDOM("<!DOCTYPE html><html><body></body></html>");
+    return dom.window;
+  }
+}
+
+export {
+  getWindow
+};

package/chunks/chunk-4RDW62CU.js

@@ -0,0 +1,36 @@
+import {
+  Cast
+} from "./chunk-QO64L4KB.js";
+import {
+  Crossenv
+} from "./chunk-3LVR6KZH.js";
+import {
+  Utils
+} from "./chunk-YEBOL67V.js";
+
+// src/agnostic/html/hyper-json/transformers/toRef/index.ts
+var toRef = (callerTagName) => {
+  return Utils.toNamedTransformer(callerTagName, (currentValue, callerTree) => {
+    const { Text } = Crossenv.getWindow();
+    if (typeof currentValue !== "string" && !(currentValue instanceof Text)) return Utils.makeTransformerError({
+      message: "Current value must be string or Text",
+      input: currentValue
+    });
+    const refPathStr = Cast.toString(currentValue);
+    const refPath = Utils.pathStringToPath(refPathStr);
+    const foundTree = callerTree.resolve(refPath);
+    if (foundTree === void 0) return Utils.makeTransformerError({
+      message: "Referenced value has not been found",
+      input: refPathStr
+    });
+    const evaluated = foundTree.evaluate();
+    return {
+      action: "REPLACE",
+      value: evaluated
+    };
+  });
+};
+
+export {
+  toRef
+};