treeloom 0.0.0-stage → 2.0.0

package/dist/diff/domItemChanges.js

@@ -0,0 +1,154 @@
+"use strict";
+
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+var __importDefault = void 0 && (void 0).__importDefault || function (mod) {
+  return mod && mod.__esModule ? mod : {
+    "default": mod
+  };
+};
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+const si_funciona_1 = __importDefault(require("si-funciona"));
+const elementHasAttribute_1 = __importDefault(require("./elementHasAttribute"));
+const createChangeList_1 = __importDefault(require("./createChangeList"));
+/**
+ * Given some config, provide a function to testing attribute and key existence in that config.
+ * @param element
+ */
+const checkAttribute = element => (attr, key) => {
+  if (typeof attr === 'object') {
+    const styles = attr;
+    const elementStyle = () => element.style;
+    const styleDiff = (0, elementHasAttribute_1.default)(element, key, attr);
+    if (Array.isArray(styleDiff) && styleDiff.length === 1 && styleDiff[0].result[0] === 0 && elementStyle()[styleDiff[0].value] === styles[styleDiff[0].value]) {
+      return 0;
+    }
+    // Check new, removed, or changed styles
+    return si_funciona_1.default.filterObject(styleDiff, arrayDiff => arrayDiff.result[0] !== 0 || elementStyle()[arrayDiff.value] !== styles[arrayDiff.value]);
+  }
+  if (key === 'class') {
+    const classDiff = (0, elementHasAttribute_1.default)(element, key, attr);
+    if (Array.isArray(classDiff) && classDiff.length === 1 && classDiff[0].result[0] === 0) {
+      return 0;
+    }
+    return si_funciona_1.default.filterObject(classDiff, arrayDiff => arrayDiff.result[0] !== 0);
+  }
+  return (0, elementHasAttribute_1.default)(element, key, attr);
+};
+/**
+ * Updates all the keys to be kabob-case
+ * @param attributesToSet
+ */
+const kabobCaseAttributes = attributesToSet => si_funciona_1.default.reduceObject(attributesToSet, (attributes, value, name) => {
+  let attrValue = attributesToSet[name] ?? value;
+  if (si_funciona_1.default.isObject(attrValue)) {
+    attrValue = kabobCaseAttributes(attrValue);
+  }
+  const kabobKey = name === 'className' ? 'class' : si_funciona_1.default.kabobCase(name);
+  attributes[kabobKey] = attrValue;
+  return attributes;
+}, {});
+/**
+ * Find the name an attribute was given on the item from its kabob-case name: innerHTML is compared as inner-html, and
+ * camelCase cannot turn that back into innerHTML.
+ * @private
+ */
+const attributeName = (attributes, kabobKey) => Object.keys(attributes).find(name => (name === 'className' ? 'class' : si_funciona_1.default.kabobCase(name)) === kabobKey) ?? si_funciona_1.default.camelCase(kabobKey);
+/**
+ * Given a domGeneral.DomItem as domItem, this function will return the changes to be applied
+ * to the stored element property.
+ * @param domItem - The DomItem having changes to be applied to its element
+ */
+const domItemChanges = domItem => {
+  const changeList = (0, createChangeList_1.default)();
+  if (!domItem.element) {
+    changeList.added.nodeName = domItem.nodeName.toLowerCase();
+  }
+  if (domItem.element && domItem.element.nodeName.toLowerCase() !== domItem.nodeName.toLowerCase()) {
+    // This should trigger new element creation
+    changeList.removed.nodeName = domItem.element.nodeName.toLowerCase();
+    changeList.added.nodeName = domItem.nodeName.toLowerCase();
+  }
+  if (domItem.nodeValue !== null) {
+    if (!si_funciona_1.default.emptyObject(domItem.attributes)) {
+      changeList.added = changeList.appendChanges('added', si_funciona_1.default.dotNotate(domItem.attributes));
+    }
+    if (!domItem.element) {
+      changeList.added.nodeValue = domItem.nodeValue;
+      return changeList;
+    }
+    changeList.removed.nodeValue = domItem.element.nodeValue;
+    if (domItem.element.nodeValue !== domItem.nodeValue) {
+      changeList.added.nodeValue = domItem.nodeValue;
+    }
+    return changeList;
+  }
+  const domItemAttributes = kabobCaseAttributes(domItem.attributes);
+  const diffMap = si_funciona_1.default.mapObject(domItemAttributes, (attr, key) => checkAttribute(domItem.element)(attr, key));
+  return si_funciona_1.default.reduceObject(diffMap, (changed, result, key) => {
+    const isArray = Array.isArray(result);
+    if (!isArray && !result) {
+      // Skip if the attribute is not changed (false and not an array)
+      return changed;
+    }
+    if (!isArray && key === 'class') {
+      // Full class name string set
+      changed.added.className = domItem.attributes.className;
+      return changed;
+    }
+    if (!isArray) {
+      // Not an array, simply set the attribute as added
+      const name = attributeName(domItem.attributes, key);
+      // A property of the element (innerHTML) is set by its own name, anything else as an attribute (aria-label)
+      const element = domItem.element;
+      changed.added[element && name in element && name !== 'form' ? name : key] = domItem.attributes[name];
+      return changed;
+    }
+    if (key !== 'class' && key !== 'style') {
+      // Is an array, but not class or style; we don't know what this is, so we skip it.
+      return changed;
+    }
+    if (key === 'class') {
+      changed.removed = result.reduce((removed, results) => {
+        if (results.result[0] === -1) {
+          removed[`class.${results.keys[1]}`] = results.value;
+        }
+        return removed;
+      }, changed.removed);
+      changed.added = result.reduce((added, results) => {
+        if (results.result[0] === 1) {
+          added[`class.${results.keys[0]}`] = results.value;
+        }
+        return added;
+      }, changed.added);
+      return changed;
+    }
+    const elementStyle = () => domItem.element.style;
+    changed.removed = result.reduce((removed, results) => {
+      if (!domItem.element) {
+        return removed;
+      }
+      if (results.result[0] === -1) {
+        removed[`style.${results.value}`] = elementStyle()[results.value];
+      }
+      if (results.result[0] === 0 && elementStyle()[results.value] !== domItemAttributes.style[results.value]) {
+        removed[`style.${results.value}`] = elementStyle()[results.value];
+      }
+      return removed;
+    }, changed.removed);
+    changed.added = result.reduce((added, results) => {
+      if (results.result[0] === 1) {
+        added[`style.${results.value}`] = domItemAttributes.style[results.value];
+      }
+      if (results.result[0] === 0 && elementStyle()[results.value] !== domItemAttributes.style[results.value]) {
+        added[`style.${results.value}`] = domItemAttributes.style[results.value];
+      }
+      return added;
+    }, changed.added);
+    return changed;
+  }, changeList);
+};
+exports.default = domItemChanges;

package/dist/diff/domItemChanges.min.js

@@ -0,0 +1 @@
+"use strict";var __importDefault=function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const si_funciona_1=__importDefault(require("si-funciona")),elementHasAttribute_1=__importDefault(require("./elementHasAttribute")),createChangeList_1=__importDefault(require("./createChangeList")),checkAttribute=e=>(t,a)=>{if("object"==typeof t){const u=t,s=()=>e.style,l=(0,elementHasAttribute_1.default)(e,a,t);return Array.isArray(l)&&1===l.length&&0===l[0].result[0]&&s()[l[0].value]===u[l[0].value]?0:si_funciona_1.default.filterObject(l,e=>0!==e.result[0]||s()[e.value]!==u[e.value])}if("class"===a){const u=(0,elementHasAttribute_1.default)(e,a,t);return Array.isArray(u)&&1===u.length&&0===u[0].result[0]?0:si_funciona_1.default.filterObject(u,e=>0!==e.result[0])}return(0,elementHasAttribute_1.default)(e,a,t)},kabobCaseAttributes=e=>si_funciona_1.default.reduceObject(e,(t,a,u)=>{let s=e[u]??a;si_funciona_1.default.isObject(s)&&(s=kabobCaseAttributes(s));return t["className"===u?"class":si_funciona_1.default.kabobCase(u)]=s,t},{}),attributeName=(e,t)=>Object.keys(e).find(e=>("className"===e?"class":si_funciona_1.default.kabobCase(e))===t)??si_funciona_1.default.camelCase(t),domItemChanges=e=>{const t=(0,createChangeList_1.default)();if(e.element||(t.added.nodeName=e.nodeName.toLowerCase()),e.element&&e.element.nodeName.toLowerCase()!==e.nodeName.toLowerCase()&&(t.removed.nodeName=e.element.nodeName.toLowerCase(),t.added.nodeName=e.nodeName.toLowerCase()),null!==e.nodeValue)return si_funciona_1.default.emptyObject(e.attributes)||(t.added=t.appendChanges("added",si_funciona_1.default.dotNotate(e.attributes))),e.element?(t.removed.nodeValue=e.element.nodeValue,e.element.nodeValue!==e.nodeValue&&(t.added.nodeValue=e.nodeValue),t):(t.added.nodeValue=e.nodeValue,t);const a=kabobCaseAttributes(e.attributes),u=si_funciona_1.default.mapObject(a,(t,a)=>checkAttribute(e.element)(t,a));return si_funciona_1.default.reduceObject(u,(t,u,s)=>{const l=Array.isArray(u);if(!l&&!u)return t;if(!l&&"class"===s)return t.added.className=e.attributes.className,t;if(!l){const a=attributeName(e.attributes,s),u=e.element;return t.added[u&&a in u&&"form"!==a?a:s]=e.attributes[a],t}if("class"!==s&&"style"!==s)return t;if("class"===s)return t.removed=u.reduce((e,t)=>(-1===t.result[0]&&(e[`class.${t.keys[1]}`]=t.value),e),t.removed),t.added=u.reduce((e,t)=>(1===t.result[0]&&(e[`class.${t.keys[0]}`]=t.value),e),t.added),t;const r=()=>e.element.style;return t.removed=u.reduce((t,u)=>e.element?(-1===u.result[0]&&(t[`style.${u.value}`]=r()[u.value]),0===u.result[0]&&r()[u.value]!==a.style[u.value]&&(t[`style.${u.value}`]=r()[u.value]),t):t,t.removed),t.added=u.reduce((e,t)=>(1===t.result[0]&&(e[`style.${t.value}`]=a.style[t.value]),0===t.result[0]&&r()[t.value]!==a.style[t.value]&&(e[`style.${t.value}`]=a.style[t.value]),e),t.added),t},t)};exports.default=domItemChanges;

package/dist/diff/domItemHasAttribute.d.ts

@@ -0,0 +1,11 @@
+import type { DomItem } from '../domItem/types';
+import type { AttributeComparison } from './types';
+/**
+ * Check if the provided DomItem has the provided attributes.
+ * Returns a boolean, or an array of 1 / 0 / -1 based on the comparison status.
+ * @param domItem - Receive the DomItem to be assessed
+ * @param key - The attribute name to search for
+ * @param attr - The expected value of the attribute to compare against
+ */
+declare const domItemHasAttribute: (domItem: DomItem, key: string, attr: unknown) => AttributeComparison;
+export default domItemHasAttribute;

package/dist/diff/domItemHasAttribute.js

@@ -0,0 +1,63 @@
+"use strict";
+
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+var __importDefault = void 0 && (void 0).__importDefault || function (mod) {
+  return mod && mod.__esModule ? mod : {
+    "default": mod
+  };
+};
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+const si_funciona_1 = __importDefault(require("si-funciona"));
+const getAssignedStyles_1 = __importDefault(require("./getAssignedStyles"));
+/**
+ * For attributes which are objects or multi-part strings -1 = remove attribute, 0 = no change, 1 = add attribute
+ * @param domItem
+ * @param attr
+ */
+const checkStyles = (domItem, attr = {}) => {
+  const assignedStyles = domItem.attributes.style ?? {};
+  if (si_funciona_1.default.emptyObject(assignedStyles)) {
+    return 1;
+  }
+  return si_funciona_1.default.compareArrays(Object.keys((0, getAssignedStyles_1.default)(attr)).map(si_funciona_1.default.camelCase), Object.keys(assignedStyles));
+};
+/**
+ * For attributes which are objects or multipart strings -1 = remove attribute, 0 = no change, 1 = add attribute
+ * @param domItem
+ * @param attr
+ */
+const checkClasses = (domItem, attr = '') => {
+  const assignedClasses = domItem.attributes.className ?? '';
+  if (!assignedClasses.length) {
+    return 1;
+  }
+  return si_funciona_1.default.compareArrays(attr.split(' '), assignedClasses.split(' '));
+};
+/**
+ * Check if the provided DomItem has the provided attributes.
+ * Returns a boolean, or an array of 1 / 0 / -1 based on the comparison status.
+ * @param domItem - Receive the DomItem to be assessed
+ * @param key - The attribute name to search for
+ * @param attr - The expected value of the attribute to compare against
+ */
+const domItemHasAttribute = (domItem, key, attr) => {
+  if (key === 'style') {
+    return checkStyles(domItem, attr);
+  }
+  if (key === 'className') {
+    return checkClasses(domItem, attr);
+  }
+  const camelKey = si_funciona_1.default.camelCase(key);
+  if (typeof domItem.attributes[camelKey] === 'undefined') {
+    return 1;
+  }
+  if (domItem.attributes[camelKey] === attr) {
+    return 0;
+  }
+  return 1;
+};
+exports.default = domItemHasAttribute;

package/dist/diff/domItemHasAttribute.min.js

@@ -0,0 +1 @@
+"use strict";var __importDefault=function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const si_funciona_1=__importDefault(require("si-funciona")),getAssignedStyles_1=__importDefault(require("./getAssignedStyles")),checkStyles=(e,t={})=>{const s=e.attributes.style??{};return si_funciona_1.default.emptyObject(s)?1:si_funciona_1.default.compareArrays(Object.keys((0,getAssignedStyles_1.default)(t)).map(si_funciona_1.default.camelCase),Object.keys(s))},checkClasses=(e,t="")=>{const s=e.attributes.className??"";return s.length?si_funciona_1.default.compareArrays(t.split(" "),s.split(" ")):1},domItemHasAttribute=(e,t,s)=>{if("style"===t)return checkStyles(e,s);if("className"===t)return checkClasses(e,s);const a=si_funciona_1.default.camelCase(t);return void 0===e.attributes[a]?1:e.attributes[a]===s?0:1};exports.default=domItemHasAttribute;

package/dist/diff/elementChanges.d.ts

@@ -0,0 +1,10 @@
+import type { DomItem } from '../domItem/types';
+import type { ChangeList } from './types';
+/**
+ * Given a domGeneral.DomItem as config, this function will return the changes from the element
+ * to be applied to the domItem.
+ * @param domItem - The DomItem having the element which changes to be applied to the config
+ * element
+ */
+declare const elementChanges: (domItem: DomItem) => ChangeList;
+export default elementChanges;

package/dist/diff/elementChanges.js

@@ -0,0 +1,151 @@
+"use strict";
+
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+var __importDefault = void 0 && (void 0).__importDefault || function (mod) {
+  return mod && mod.__esModule ? mod : {
+    "default": mod
+  };
+};
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+const si_funciona_1 = __importDefault(require("si-funciona"));
+const domItemHasAttribute_1 = __importDefault(require("./domItemHasAttribute"));
+const createChangeList_1 = __importDefault(require("./createChangeList"));
+/**
+ * Given some config, provide a function to testing attribute and key existence in that config.
+ * @param domItem
+ */
+const checkAttribute = domItem => (attr, key) => {
+  if (key === 'className') {
+    const diff = (0, domItemHasAttribute_1.default)(domItem, key, attr);
+    if (Array.isArray(diff) && diff.length === 1 && diff[0].result[0] === 0) {
+      return 0;
+    }
+    return si_funciona_1.default.filterObject(diff, arrayDiff => arrayDiff.result[0] !== 0);
+  }
+  if (key === 'style') {
+    const diff = (0, domItemHasAttribute_1.default)(domItem, key, attr);
+    const styles = attr;
+    const itemStyle = () => domItem.attributes.style;
+    if (Array.isArray(diff) && diff.length === 1 && diff[0].result[0] === 0 && itemStyle()[diff[0].value] === styles[diff[0].value]) {
+      return 0;
+    }
+    return si_funciona_1.default.filterObject(diff, arrayDiff => arrayDiff.result[0] !== 0 || itemStyle()[arrayDiff.value] !== styles[arrayDiff.value]);
+  }
+  return (0, domItemHasAttribute_1.default)(domItem, key, attr);
+};
+/**
+ * Updates all the keys to be camelCase
+ * @param domItem
+ */
+const camelCaseAttributes = domItem => domItem.element ? si_funciona_1.default.reduceObject(domItem.element.attributes, (attributes, attr) => {
+  if (!attr.name) {
+    return attributes;
+  }
+  const camelKey = attr.name === 'class' ? 'className' : si_funciona_1.default.camelCase(attr.name);
+  const attributeValue = domItem.element[attr.name] ?? attr.value;
+  if (typeof attributeValue === 'undefined') {
+    return attributes;
+  }
+  attributes[camelKey] = attributeValue;
+  return attributes;
+}, {}) : {};
+/**
+ * Given a domGeneral.DomItem as config, this function will return the changes from the element
+ * to be applied to the domItem.
+ * @param domItem - The DomItem having the element which changes to be applied to the config
+ * element
+ */
+const elementChanges = domItem => {
+  const changeList = (0, createChangeList_1.default)();
+  if (!domItem.element) {
+    changeList.removed.nodeName = domItem.nodeName.toLowerCase();
+  }
+  if (domItem.element && domItem.element.nodeName.toLowerCase() !== domItem.nodeName.toLowerCase()) {
+    changeList.removed.nodeName = domItem.nodeName.toLowerCase();
+    changeList.added.nodeName = domItem.element.nodeName.toLowerCase();
+  }
+  if (!domItem.element && domItem.nodeValue !== null) {
+    changeList.removed.nodeValue = domItem.nodeValue;
+    if (!si_funciona_1.default.emptyObject(domItem.attributes)) {
+      changeList.removed = changeList.appendChanges('removed', si_funciona_1.default.dotNotate({
+        attributes: domItem.attributes
+      }));
+    }
+    return changeList;
+  }
+  if (domItem.element && !(domItem.element instanceof Element)) {
+    if (domItem.element.nodeValue !== domItem.nodeValue) {
+      changeList.added.nodeValue = domItem.element.nodeValue;
+    }
+    if (!si_funciona_1.default.emptyObject(domItem.attributes)) {
+      changeList.removed = changeList.appendChanges('removed', si_funciona_1.default.dotNotate({
+        attributes: domItem.attributes
+      }));
+    }
+    return changeList;
+  }
+  if (!(domItem.element && domItem.element.hasAttributes()) && !si_funciona_1.default.emptyObject(domItem.attributes)) {
+    changeList.removed = changeList.appendChanges('removed', si_funciona_1.default.dotNotate({
+      attributes: domItem.attributes
+    }));
+    return changeList;
+  }
+  const elementAttributes = camelCaseAttributes(domItem);
+  const diffMap = si_funciona_1.default.mapObject(elementAttributes, (attr, key) => checkAttribute(domItem)(attr, key));
+  return si_funciona_1.default.reduceObject(diffMap, (changed, result, key) => {
+    const isArray = Array.isArray(result);
+    if (!isArray && !result) {
+      // Skip if the attribute is not changed (false and not an array)
+      return changed;
+    }
+    if (!isArray) {
+      // Not an array, simply set the attribute as added
+      changed.added[`attributes.${key}`] = domItem.element[key] ?? domItem.element.getAttribute(si_funciona_1.default.kabobCase(key));
+      return changed;
+    }
+    if (key !== 'className' && key !== 'style') {
+      // Is an array, but not class or style; we don't know what this is, so we skip it.
+      return changed;
+    }
+    if (key === 'className') {
+      changed.removed = result.reduce((removed, results) => {
+        if (results.result[0] === -1) {
+          removed[`attributes.className.${results.keys[1]}`] = results.value;
+        }
+        return removed;
+      }, changed.removed);
+      changed.added = result.reduce((added, results) => {
+        if (results.result[0] === 1) {
+          added[`attributes.className.${results.keys[0]}`] = results.value;
+        }
+        return added;
+      }, changed.added);
+      return changed;
+    }
+    const itemStyle = () => domItem.attributes.style;
+    changed.removed = result.reduce((removed, results) => {
+      if (results.result[0] === -1) {
+        removed[`attributes.style.${results.value}`] = itemStyle()[results.value];
+      }
+      if (results.result[0] === 0 && itemStyle()[results.value] !== elementAttributes.style[results.value]) {
+        removed[`attributes.style.${results.value}`] = itemStyle()[results.value];
+      }
+      return removed;
+    }, changed.removed);
+    changed.added = result.reduce((added, results) => {
+      if (results.result[0] === 1) {
+        added[`attributes.style.${results.value}`] = elementAttributes.style[results.value];
+      }
+      if (results.result[0] === 0 && itemStyle()[results.value] !== elementAttributes.style[results.value]) {
+        added[`attributes.style.${results.value}`] = elementAttributes.style[results.value];
+      }
+      return added;
+    }, changed.added);
+    return changed;
+  }, changeList);
+};
+exports.default = elementChanges;

package/dist/diff/elementChanges.min.js

@@ -0,0 +1 @@
+"use strict";var __importDefault=function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const si_funciona_1=__importDefault(require("si-funciona")),domItemHasAttribute_1=__importDefault(require("./domItemHasAttribute")),createChangeList_1=__importDefault(require("./createChangeList")),checkAttribute=e=>(t,a)=>{if("className"===a){const u=(0,domItemHasAttribute_1.default)(e,a,t);return Array.isArray(u)&&1===u.length&&0===u[0].result[0]?0:si_funciona_1.default.filterObject(u,e=>0!==e.result[0])}if("style"===a){const u=(0,domItemHasAttribute_1.default)(e,a,t),r=t,s=()=>e.attributes.style;return Array.isArray(u)&&1===u.length&&0===u[0].result[0]&&s()[u[0].value]===r[u[0].value]?0:si_funciona_1.default.filterObject(u,e=>0!==e.result[0]||s()[e.value]!==r[e.value])}return(0,domItemHasAttribute_1.default)(e,a,t)},camelCaseAttributes=e=>e.element?si_funciona_1.default.reduceObject(e.element.attributes,(t,a)=>{if(!a.name)return t;const u="class"===a.name?"className":si_funciona_1.default.camelCase(a.name),r=e.element[a.name]??a.value;return void 0===r||(t[u]=r),t},{}):{},elementChanges=e=>{const t=(0,createChangeList_1.default)();if(e.element||(t.removed.nodeName=e.nodeName.toLowerCase()),e.element&&e.element.nodeName.toLowerCase()!==e.nodeName.toLowerCase()&&(t.removed.nodeName=e.nodeName.toLowerCase(),t.added.nodeName=e.element.nodeName.toLowerCase()),!e.element&&null!==e.nodeValue)return t.removed.nodeValue=e.nodeValue,si_funciona_1.default.emptyObject(e.attributes)||(t.removed=t.appendChanges("removed",si_funciona_1.default.dotNotate({attributes:e.attributes}))),t;if(e.element&&!(e.element instanceof Element))return e.element.nodeValue!==e.nodeValue&&(t.added.nodeValue=e.element.nodeValue),si_funciona_1.default.emptyObject(e.attributes)||(t.removed=t.appendChanges("removed",si_funciona_1.default.dotNotate({attributes:e.attributes}))),t;if(!(e.element&&e.element.hasAttributes()||si_funciona_1.default.emptyObject(e.attributes)))return t.removed=t.appendChanges("removed",si_funciona_1.default.dotNotate({attributes:e.attributes})),t;const a=camelCaseAttributes(e),u=si_funciona_1.default.mapObject(a,(t,a)=>checkAttribute(e)(t,a));return si_funciona_1.default.reduceObject(u,(t,u,r)=>{const s=Array.isArray(u);if(!s&&!u)return t;if(!s)return t.added[`attributes.${r}`]=e.element[r]??e.element.getAttribute(si_funciona_1.default.kabobCase(r)),t;if("className"!==r&&"style"!==r)return t;if("className"===r)return t.removed=u.reduce((e,t)=>(-1===t.result[0]&&(e[`attributes.className.${t.keys[1]}`]=t.value),e),t.removed),t.added=u.reduce((e,t)=>(1===t.result[0]&&(e[`attributes.className.${t.keys[0]}`]=t.value),e),t.added),t;const n=()=>e.attributes.style;return t.removed=u.reduce((e,t)=>(-1===t.result[0]&&(e[`attributes.style.${t.value}`]=n()[t.value]),0===t.result[0]&&n()[t.value]!==a.style[t.value]&&(e[`attributes.style.${t.value}`]=n()[t.value]),e),t.removed),t.added=u.reduce((e,t)=>(1===t.result[0]&&(e[`attributes.style.${t.value}`]=a.style[t.value]),0===t.result[0]&&n()[t.value]!==a.style[t.value]&&(e[`attributes.style.${t.value}`]=a.style[t.value]),e),t.added),t},t)};exports.default=elementChanges;

package/dist/diff/elementHasAttribute.d.ts

@@ -0,0 +1,10 @@
+import type { AttributeComparison } from './types';
+/**
+ * Check if the provided Element has the provided attributes.
+ * Returns a boolean, or an array of 1 / 0 / -1 based on the comparison status.
+ * @param element - Receive the element to be assessed
+ * @param key - The attribute name to search for
+ * @param attr - The expected value of the attribute to compare against
+ */
+declare const elementHasAttribute: (element: HTMLElement | null | undefined, key: string, attr: unknown) => AttributeComparison;
+export default elementHasAttribute;

package/dist/diff/elementHasAttribute.js

@@ -0,0 +1,70 @@
+"use strict";
+
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+var __importDefault = void 0 && (void 0).__importDefault || function (mod) {
+  return mod && mod.__esModule ? mod : {
+    "default": mod
+  };
+};
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+const getAssignedStyles_1 = __importDefault(require("./getAssignedStyles"));
+const si_funciona_1 = __importDefault(require("si-funciona"));
+/**
+ * For attributes which are objects or multi-part strings -1 = remove attribute, 0 = no change, 1 = add attribute
+ * @param element
+ * @param attr
+ */
+const checkStyles = (element, attr = {}) => {
+  const assignedStyles = (0, getAssignedStyles_1.default)(element.style) ?? {};
+  if (si_funciona_1.default.emptyObject(assignedStyles)) {
+    return 1;
+  }
+  return si_funciona_1.default.compareArrays(Object.keys(attr).map(si_funciona_1.default.kabobCase), Object.keys(assignedStyles));
+};
+/**
+ * For attributes which are objects or multi-part strings -1 = remove attribute, 0 = no change, 1 = add attribute
+ * @param element
+ * @param attr
+ */
+const checkClasses = (element, attr = '') => {
+  if (typeof attr !== 'string') {
+    // Somehow an empty object got in here one time
+    attr = '';
+  }
+  const assignedClasses = Array.from(element.classList);
+  if (!assignedClasses.length) {
+    return 1;
+  }
+  return si_funciona_1.default.compareArrays(attr.split(' '), assignedClasses);
+};
+/**
+ * Check if the provided Element has the provided attributes.
+ * Returns a boolean, or an array of 1 / 0 / -1 based on the comparison status.
+ * @param element - Receive the element to be assessed
+ * @param key - The attribute name to search for
+ * @param attr - The expected value of the attribute to compare against
+ */
+const elementHasAttribute = (element, key, attr) => {
+  if (!element) {
+    return 1;
+  }
+  if (key === 'style') {
+    return checkStyles(element, attr);
+  }
+  if (key === 'class') {
+    return checkClasses(element, attr);
+  }
+  const kabobKey = si_funciona_1.default.kabobCase(key);
+  if (!element.hasAttribute(kabobKey)) {
+    return 1;
+  }
+  if (element.getAttribute(kabobKey) === attr) {
+    return 0;
+  }
+  return 1;
+};
+exports.default = elementHasAttribute;

package/dist/diff/elementHasAttribute.min.js

@@ -0,0 +1 @@
+"use strict";var __importDefault=function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const getAssignedStyles_1=__importDefault(require("./getAssignedStyles")),si_funciona_1=__importDefault(require("si-funciona")),checkStyles=(e,t={})=>{const s=(0,getAssignedStyles_1.default)(e.style)??{};return si_funciona_1.default.emptyObject(s)?1:si_funciona_1.default.compareArrays(Object.keys(t).map(si_funciona_1.default.kabobCase),Object.keys(s))},checkClasses=(e,t="")=>{"string"!=typeof t&&(t="");const s=Array.from(e.classList);return s.length?si_funciona_1.default.compareArrays(t.split(" "),s):1},elementHasAttribute=(e,t,s)=>{if(!e)return 1;if("style"===t)return checkStyles(e,s);if("class"===t)return checkClasses(e,s);const r=si_funciona_1.default.kabobCase(t);return e.hasAttribute(r)&&e.getAttribute(r)===s?0:1};exports.default=elementHasAttribute;

package/dist/diff/getAssignedStyles.d.ts

@@ -0,0 +1,9 @@
+import type { StyleValues } from '../domItem/types';
+/**
+ * Get all the styles which have been assigned to this element. Assigned styles are indicated as numeric-key
+ * properties with a value indicating the string-key property which has been assigned. The string-key properties
+ * have the assigned values.
+ * @param elementStyles
+ */
+declare const getAssignedStyles: (elementStyles: CSSStyleDeclaration | StyleValues) => StyleValues;
+export default getAssignedStyles;

package/dist/diff/getAssignedStyles.js

@@ -0,0 +1,22 @@
+"use strict";
+
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+var __importDefault = void 0 && (void 0).__importDefault || function (mod) {
+  return mod && mod.__esModule ? mod : {
+    "default": mod
+  };
+};
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+const si_funciona_1 = __importDefault(require("si-funciona"));
+/**
+ * Get all the styles which have been assigned to this element. Assigned styles are indicated as numeric-key
+ * properties with a value indicating the string-key property which has been assigned. The string-key properties
+ * have the assigned values.
+ * @param elementStyles
+ */
+const getAssignedStyles = elementStyles => si_funciona_1.default.reduceObject(elementStyles, (styles, attr, key) => Number.isNaN(Number(key)) ? styles : si_funciona_1.default.setValue(attr, elementStyles[attr], styles), {});
+exports.default = getAssignedStyles;

package/dist/diff/getAssignedStyles.min.js

@@ -0,0 +1 @@
+"use strict";var __importDefault=function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const si_funciona_1=__importDefault(require("si-funciona")),getAssignedStyles=e=>si_funciona_1.default.reduceObject(e,(t,u,s)=>Number.isNaN(Number(s))?t:si_funciona_1.default.setValue(u,e[u],t),{});exports.default=getAssignedStyles;

package/dist/diff/index.d.ts

@@ -0,0 +1,9 @@
+declare const _default: {
+    createChangeList: ({ removed, added }?: Partial<Pick<import("./types").ChangeList, "removed" | "added">>) => import("./types").ChangeList;
+    domItemChanges: (domItem: import("../domItem/types").DomItem) => import("./types").ChangeList;
+    domItemHasAttribute: (domItem: import("../domItem/types").DomItem, key: string, attr: unknown) => import("./types").AttributeComparison;
+    elementChanges: (domItem: import("../domItem/types").DomItem) => import("./types").ChangeList;
+    elementHasAttribute: (element: HTMLElement | null | undefined, key: string, attr: unknown) => import("./types").AttributeComparison;
+    getAssignedStyles: (elementStyles: CSSStyleDeclaration | import("../domItem/types").StyleValues) => import("../domItem/types").StyleValues;
+};
+export default _default;

package/dist/diff/index.js

@@ -0,0 +1,27 @@
+"use strict";
+
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+var __importDefault = void 0 && (void 0).__importDefault || function (mod) {
+  return mod && mod.__esModule ? mod : {
+    "default": mod
+  };
+};
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+const createChangeList_1 = __importDefault(require("./createChangeList"));
+const domItemChanges_1 = __importDefault(require("./domItemChanges"));
+const domItemHasAttribute_1 = __importDefault(require("./domItemHasAttribute"));
+const elementChanges_1 = __importDefault(require("./elementChanges"));
+const elementHasAttribute_1 = __importDefault(require("./elementHasAttribute"));
+const getAssignedStyles_1 = __importDefault(require("./getAssignedStyles"));
+exports.default = {
+  createChangeList: createChangeList_1.default,
+  domItemChanges: domItemChanges_1.default,
+  domItemHasAttribute: domItemHasAttribute_1.default,
+  elementChanges: elementChanges_1.default,
+  elementHasAttribute: elementHasAttribute_1.default,
+  getAssignedStyles: getAssignedStyles_1.default
+};

package/dist/diff/index.min.js

@@ -0,0 +1 @@
+"use strict";var __importDefault=function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const createChangeList_1=__importDefault(require("./createChangeList")),domItemChanges_1=__importDefault(require("./domItemChanges")),domItemHasAttribute_1=__importDefault(require("./domItemHasAttribute")),elementChanges_1=__importDefault(require("./elementChanges")),elementHasAttribute_1=__importDefault(require("./elementHasAttribute")),getAssignedStyles_1=__importDefault(require("./getAssignedStyles"));exports.default={createChangeList:createChangeList_1.default,domItemChanges:domItemChanges_1.default,domItemHasAttribute:domItemHasAttribute_1.default,elementChanges:elementChanges_1.default,elementHasAttribute:elementHasAttribute_1.default,getAssignedStyles:getAssignedStyles_1.default};

package/dist/diff/types.d.ts

@@ -0,0 +1,17 @@
+import type { compareArrayResultMap } from 'si-funciona/dist/helpers/arrays/compareArrays';
+/** An object whose keys are dot notated paths (attributes.style.color) and whose values are what is at that path. */
+export type DotNotated = Record<string, any>;
+/** Which of the two lists a change is appended to. */
+export type ChangeType = 'added' | 'removed';
+/** What has to be added and removed to make one side match the other. */
+export type ChangeList = {
+    removed: DotNotated;
+    added: DotNotated;
+    /** Merge more changes into the removed or added list, and return the merged list. */
+    appendChanges: (changeType: ChangeType, changes: DotNotated) => DotNotated;
+};
+/**
+ * The outcome of comparing one attribute: 0 when it is the same, 1 when it is missing or different, or - for the
+ * multi-part attributes (style, class) - the list of what each part of it looks like (see compareArrays).
+ */
+export type AttributeComparison = 0 | 1 | compareArrayResultMap;

package/dist/diff/types.js

@@ -0,0 +1,8 @@
+"use strict";
+
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/dist/diff/types.min.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});

package/dist/domItem/index.d.ts

@@ -0,0 +1,34 @@
+declare const _default: {
+    addDomItemProperties: (item: import("./types").DomItemConfig) => import("./types").DomItem;
+    appendChild: (parent: import("./types").DomItem, child: import("./types").DomItem) => import("./types").DomItem;
+    createCoreItem: (item?: import("./types").DomItemConfig) => import("./types").CoreItem;
+    createDomItem: (item?: import("./types").DomItemConfig) => import("./types").DomItem;
+    defineTrait: (name: string, definition: import("./types").TraitDefinition) => import("./types").TraitDefinition;
+    documentDomItem: (listeners?: Record<string, import("../events/types").ListenerFunction>, rootItem?: import("./types").DomItemRoot) => import("./types").DomItemRoot;
+    getDocumentItem: () => import("./types").DomItemRoot;
+    gatherChildItems: (item: import("./types").DomItem, test: import("./types").ChildTest) => import("./types").DomItem[];
+    getChildrenByClass: (className: string, item?: import("./types").DomItem) => import("./types").DomItem[];
+    getChildrenByName: (name: string, item?: import("./types").DomItem) => import("./types").DomItem[];
+    getChildrenFromAttribute: (attr: string, value: unknown, item?: import("./types").DomItem) => import("./types").DomItem[];
+    getChildTest: (attr: string, value: unknown) => import("./types").ChildTest;
+    getItemByElement: (item: import("./types").DomItem, element: EventTarget | null) => import("./types").DomItem | null;
+    getItemById: (root: import("./types").DomItemRoot, id: number) => import("./types").DomItem;
+    getItemByPath: (root: import("./types").DomItem, path: import("./types").ItemPath) => import("./types").DomItem;
+    getItemPath: (item: import("./types").DomItem) => import("./types").ItemPath;
+    getParentsByClass: (className: string, item?: import("./types").DomItem) => import("./types").DomItem[];
+    getParentsByName: (name: string, item?: import("./types").DomItem) => import("./types").DomItem[];
+    getParentsByTagName: (nodeName: string, item?: import("./types").DomItem) => import("./types").DomItem[];
+    getParentsFromAttribute: (attr: string, value: unknown, item?: import("./types").DomItem) => import("./types").DomItem[];
+    getTopParentItem: (item: import("./types").DomItem) => import("./types").DomItemRoot;
+    getTraitDefinition: (name: string) => import("./types").TraitDefinition | undefined;
+    hasTrait: <Trait extends import("./types").TraitName>(item: import("./types").CoreItem, trait: Trait) => item is import("./types").CoreItem & import("./types").WithTraits<Trait>;
+    hasTraits: <Trait extends import("./types").TraitName>(item: import("./types").CoreItem, ...traits: Trait[]) => item is import("./types").CoreItem & import("./types").WithTraits<Trait>;
+    initChildren: () => import("./types").DomItem[];
+    initRoot: (children?: import("./types").DomItem[], listeners?: Record<string, import("../events/types").ListenerFunction>) => import("./types").DomItemRoot;
+    insertChild: (parent: import("./types").DomItem, child: import("./types").DomItem, index: number) => import("./types").DomItem;
+    isDomItem: (item: import("./types").CoreItem) => item is import("./types").DomItem;
+    removeChild: (parent: import("./types").DomItem, child: import("./types").DomItem) => import("./types").DomItem[];
+    setParentItemReferences: (item: import("./types").DomItem) => import("./types").DomItem;
+    withTrait: <Item extends import("./types").CoreItem, Trait extends import("./types").TraitName>(item: Item, trait: Trait, data: import("./types").TraitRegistry[Trait]) => Item & import("./types").WithTraits<Trait>;
+};
+export default _default;