treeloom 0.0.0-stage → 2.0.0

package/dist/domItem/query/getChildrenFromAttribute.d.ts

@@ -0,0 +1,13 @@
+import type { DomItem } from '../types';
+/**
+ * A selector function for retrieving existing child domGeneral.DomItems from the given parent item.
+ * This function will check all the children starting from item, and scan the attributes
+ * property for matches. The returned array contains children matching from all levels.
+ * WARNING: This calls a recursive function.
+ * @param attr - Provide the attribute name to be searched
+ * @param value - The attribute value to be compared
+ * @param item - The DomItem which may have child items matching the attribute
+ * criteria
+ */
+declare const getChildrenFromAttribute: (attr: string, value: unknown, item?: DomItem) => DomItem[];
+export default getChildrenFromAttribute;

package/dist/domItem/query/getChildrenFromAttribute.js

@@ -0,0 +1,28 @@
+"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 documentItem_1 = __importDefault(require("../objects/documentItem"));
+const gatherChildItems_1 = __importDefault(require("./gatherChildItems"));
+const getChildTest_1 = __importDefault(require("./getChildTest"));
+/**
+ * A selector function for retrieving existing child domGeneral.DomItems from the given parent item.
+ * This function will check all the children starting from item, and scan the attributes
+ * property for matches. The returned array contains children matching from all levels.
+ * WARNING: This calls a recursive function.
+ * @param attr - Provide the attribute name to be searched
+ * @param value - The attribute value to be compared
+ * @param item - The DomItem which may have child items matching the attribute
+ * criteria
+ */
+const getChildrenFromAttribute = (attr, value, item = (0, documentItem_1.default)().body) => (0, gatherChildItems_1.default)(item, (0, getChildTest_1.default)(attr, value));
+exports.default = getChildrenFromAttribute;

package/dist/domItem/query/getChildrenFromAttribute.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 documentItem_1=__importDefault(require("../objects/documentItem")),gatherChildItems_1=__importDefault(require("./gatherChildItems")),getChildTest_1=__importDefault(require("./getChildTest")),getChildrenFromAttribute=(e,t,r=(0,documentItem_1.default)().body)=>(0,gatherChildItems_1.default)(r,(0,getChildTest_1.default)(e,t));exports.default=getChildrenFromAttribute;

package/dist/domItem/query/getItemByElement.d.ts

@@ -0,0 +1,11 @@
+import type { DomItem } from '../types';
+/**
+ * Find the item (item itself, or one of its descendants) whose element is the one given, or null when none match.
+ * Only searches item and its own subtree: an event's target is always the item a listener is attached to, or one of
+ * its descendants (that is what bubbling means), so there is never a reason to search outside it.
+ * WARNING: This is a recursive function.
+ * @param item - The DomItem (and its subtree) to search.
+ * @param element - The real element to match against each item's element.
+ */
+declare const getItemByElement: (item: DomItem, element: EventTarget | null) => DomItem | null;
+export default getItemByElement;

package/dist/domItem/query/getItemByElement.js

@@ -0,0 +1,29 @@
+"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
+});
+/**
+ * Find the item (item itself, or one of its descendants) whose element is the one given, or null when none match.
+ * Only searches item and its own subtree: an event's target is always the item a listener is attached to, or one of
+ * its descendants (that is what bubbling means), so there is never a reason to search outside it.
+ * WARNING: This is a recursive function.
+ * @param item - The DomItem (and its subtree) to search.
+ * @param element - The real element to match against each item's element.
+ */
+const getItemByElement = (item, element) => {
+  if (item.element === element) {
+    return item;
+  }
+  for (const child of item.children) {
+    const found = getItemByElement(child, element);
+    if (found) {
+      return found;
+    }
+  }
+  return null;
+};
+exports.default = getItemByElement;

package/dist/domItem/query/getItemByElement.min.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});const getItemByElement=(e,t)=>{if(e.element===t)return e;for(const n of e.children){const e=getItemByElement(n,t);if(e)return e}return null};exports.default=getItemByElement;

package/dist/domItem/query/getParentsByClass.d.ts

@@ -0,0 +1,12 @@
+import type { DomItem } from '../types';
+/**
+ * Helper for getting all domGeneral.DomItems going up from item's parent, each one carrying the given class, among
+ * possibly several space-separated classes on that item - the same membership check as the real DOM's
+ * classList.contains, not an exact match of the whole className attribute string (which getParentsFromAttribute
+ * does, and which would miss a parent that also carries other classes).
+ * WARNING: This is a recursive function.
+ * @param className - The one class being searched for
+ * @param item - The DomItem which may have parent items carrying the class
+ */
+declare const getParentsByClass: (className: string, item?: DomItem) => DomItem[];
+export default getParentsByClass;

package/dist/domItem/query/getParentsByClass.js

@@ -0,0 +1,40 @@
+"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/. */
+require("core-js/modules/es.array.includes.js");
+var __importDefault = void 0 && (void 0).__importDefault || function (mod) {
+  return mod && mod.__esModule ? mod : {
+    "default": mod
+  };
+};
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+const documentItem_1 = __importDefault(require("../objects/documentItem"));
+const si_funciona_1 = __importDefault(require("si-funciona"));
+/**
+ * Helper for getting all domGeneral.DomItems going up from item's parent, each one carrying the given class, among
+ * possibly several space-separated classes on that item - the same membership check as the real DOM's
+ * classList.contains, not an exact match of the whole className attribute string (which getParentsFromAttribute
+ * does, and which would miss a parent that also carries other classes).
+ * WARNING: This is a recursive function.
+ * @param className - The one class being searched for
+ * @param item - The DomItem which may have parent items carrying the class
+ */
+const getParentsByClass = (className, item = (0, documentItem_1.default)().body) => {
+  if (item.parentItem === null) {
+    if (item.nodeName === '#document') {
+      throw new Error('Root parent item must be an empty object, null reference found.');
+    }
+    throw new Error('Detached child, missing parentItem reference. Use empty object if this is the root item.');
+  }
+  if (si_funciona_1.default.emptyObject(item.parentItem)) {
+    return [];
+  }
+  const parent = item.parentItem;
+  const carriesClass = (parent.attributes.className ?? '').split(' ').includes(className);
+  return carriesClass ? getParentsByClass(className, parent).concat([parent]) : getParentsByClass(className, parent);
+};
+exports.default = getParentsByClass;

package/dist/domItem/query/getParentsByClass.min.js

@@ -0,0 +1 @@
+"use strict";require("core-js/modules/es.array.includes.js");var __importDefault=function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const documentItem_1=__importDefault(require("../objects/documentItem")),si_funciona_1=__importDefault(require("si-funciona")),getParentsByClass=(e,t=(0,documentItem_1.default)().body)=>{if(null===t.parentItem){if("#document"===t.nodeName)throw new Error("Root parent item must be an empty object, null reference found.");throw new Error("Detached child, missing parentItem reference. Use empty object if this is the root item.")}if(si_funciona_1.default.emptyObject(t.parentItem))return[];const r=t.parentItem;return(r.attributes.className??"").split(" ").includes(e)?getParentsByClass(e,r).concat([r]):getParentsByClass(e,r)};exports.default=getParentsByClass;

package/dist/domItem/query/getParentsByName.d.ts

@@ -0,0 +1,9 @@
+import type { DomItem } from '../types';
+/**
+ * Helper for getting all domGeneral.DomItems starting at child and having specified name attribute
+ * @param name - The name to search for
+ * @param item - The DomItem which may have parent items matching the
+ * attribute criteria
+ */
+declare const getParentsByName: (name: string, item?: DomItem) => DomItem[];
+export default getParentsByName;

package/dist/domItem/query/getParentsByName.js

@@ -0,0 +1,23 @@
+"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 getParentsFromAttribute_1 = __importDefault(require("./getParentsFromAttribute"));
+/**
+ * Helper for getting all domGeneral.DomItems starting at child and having specified name attribute
+ * @param name - The name to search for
+ * @param item - The DomItem which may have parent items matching the
+ * attribute criteria
+ */
+const getParentsByName = si_funciona_1.default.curry(getParentsFromAttribute_1.default)('name');
+exports.default = getParentsByName;

package/dist/domItem/query/getParentsByName.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")),getParentsFromAttribute_1=__importDefault(require("./getParentsFromAttribute")),getParentsByName=si_funciona_1.default.curry(getParentsFromAttribute_1.default)("name");exports.default=getParentsByName;

package/dist/domItem/query/getParentsByTagName.d.ts

@@ -0,0 +1,9 @@
+import type { DomItem } from '../types';
+/**
+ * Helper for getting all domGeneral.DomItems starting at child and having specified nodeName
+ * @param nodeName - The nodeName to search for
+ * @param item - The DomItem which may have parent items matching the
+ * attribute criteria
+ */
+declare const getParentsByTagName: (nodeName: string, item?: DomItem) => DomItem[];
+export default getParentsByTagName;

package/dist/domItem/query/getParentsByTagName.js

@@ -0,0 +1,23 @@
+"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 getParentsFromAttribute_1 = __importDefault(require("./getParentsFromAttribute"));
+/**
+ * Helper for getting all domGeneral.DomItems starting at child and having specified nodeName
+ * @param nodeName - The nodeName to search for
+ * @param item - The DomItem which may have parent items matching the
+ * attribute criteria
+ */
+const getParentsByTagName = si_funciona_1.default.curry(getParentsFromAttribute_1.default)('nodeName');
+exports.default = getParentsByTagName;

package/dist/domItem/query/getParentsByTagName.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")),getParentsFromAttribute_1=__importDefault(require("./getParentsFromAttribute")),getParentsByTagName=si_funciona_1.default.curry(getParentsFromAttribute_1.default)("nodeName");exports.default=getParentsByTagName;

package/dist/domItem/query/getParentsFromAttribute.d.ts

@@ -0,0 +1,13 @@
+import type { DomItem } from '../types';
+/**
+ * A selector function for retrieving existing child domGeneral.DomItems from the given parent item.
+ * This function will check all the children starting from item, and scan the attributes
+ * property for matches. The return array contains children matching from all levels.
+ * WARNING: This is a recursive function.
+ * @param attr - Provide the attribute name to be searched
+ * @param value - The attribute value to be compared
+ * @param item - The DomItem which may have parent items matching the
+ * attribute criteria
+ */
+declare const getParentsFromAttribute: (attr: string, value: unknown, item?: DomItem) => DomItem[];
+export default getParentsFromAttribute;

package/dist/domItem/query/getParentsFromAttribute.js

@@ -0,0 +1,39 @@
+"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 documentItem_1 = __importDefault(require("../objects/documentItem"));
+const si_funciona_1 = __importDefault(require("si-funciona"));
+/**
+ * A selector function for retrieving existing child domGeneral.DomItems from the given parent item.
+ * This function will check all the children starting from item, and scan the attributes
+ * property for matches. The return array contains children matching from all levels.
+ * WARNING: This is a recursive function.
+ * @param attr - Provide the attribute name to be searched
+ * @param value - The attribute value to be compared
+ * @param item - The DomItem which may have parent items matching the
+ * attribute criteria
+ */
+const getParentsFromAttribute = (attr, value, item = (0, documentItem_1.default)().body) => {
+  if (item.parentItem === null) {
+    if (item.nodeName === '#document') {
+      throw new Error('Root parent item must be an empty object, null reference found.');
+    }
+    throw new Error('Detached child, missing parentItem reference. Use empty object if this is the root item.');
+  }
+  if (si_funciona_1.default.emptyObject(item.parentItem)) {
+    return [];
+  }
+  const parent = item.parentItem;
+  return (parent.attributes[attr] || item[attr] || false) === value ? getParentsFromAttribute(attr, value, parent).concat([parent]) : getParentsFromAttribute(attr, value, parent);
+};
+exports.default = getParentsFromAttribute;

package/dist/domItem/query/getParentsFromAttribute.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 documentItem_1=__importDefault(require("../objects/documentItem")),si_funciona_1=__importDefault(require("si-funciona")),getParentsFromAttribute=(e,t,r=(0,documentItem_1.default)().body)=>{if(null===r.parentItem){if("#document"===r.nodeName)throw new Error("Root parent item must be an empty object, null reference found.");throw new Error("Detached child, missing parentItem reference. Use empty object if this is the root item.")}if(si_funciona_1.default.emptyObject(r.parentItem))return[];const n=r.parentItem;return(n.attributes[e]||r[e]||!1)===t?getParentsFromAttribute(e,t,n).concat([n]):getParentsFromAttribute(e,t,n)};exports.default=getParentsFromAttribute;

package/dist/domItem/traits/defineTrait.d.ts

@@ -0,0 +1,10 @@
+import type { TraitDefinition } from '../types';
+/**
+ * Describe a trait so treeloom knows what it is at runtime: the properties it puts on an item (so they can be left out
+ * of json when they only make sense where the item lives), and the defaults a new item gets. Types are added
+ * separately, by merging into TraitRegistry.
+ * @param name - The name of the trait, prefixed by the package which defines it: matrix.row
+ * @param definition - The properties the trait puts on an item, whether they are serializable and the defaults.
+ */
+declare const defineTrait: (name: string, definition: TraitDefinition) => TraitDefinition;
+export default defineTrait;

package/dist/domItem/traits/defineTrait.js

@@ -0,0 +1,26 @@
+"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 definitions_1 = __importDefault(require("./definitions"));
+/**
+ * Describe a trait so treeloom knows what it is at runtime: the properties it puts on an item (so they can be left out
+ * of json when they only make sense where the item lives), and the defaults a new item gets. Types are added
+ * separately, by merging into TraitRegistry.
+ * @param name - The name of the trait, prefixed by the package which defines it: matrix.row
+ * @param definition - The properties the trait puts on an item, whether they are serializable and the defaults.
+ */
+const defineTrait = (name, definition) => {
+  definitions_1.default.set(name, definition);
+  return definition;
+};
+exports.default = defineTrait;

package/dist/domItem/traits/defineTrait.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 definitions_1=__importDefault(require("./definitions")),defineTrait=(e,t)=>(definitions_1.default.set(e,t),t);exports.default=defineTrait;

package/dist/domItem/traits/definitions.d.ts

@@ -0,0 +1,7 @@
+import type { TraitDefinition } from '../types';
+/**
+ * What each trait is at runtime, by name. render is the one treeloom brings; other libraries add theirs with
+ * defineTrait.
+ */
+declare const definitions: Map<string, TraitDefinition>;
+export default definitions;

package/dist/domItem/traits/definitions.js

@@ -0,0 +1,20 @@
+"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
+});
+/**
+ * What each trait is at runtime, by name. render is the one treeloom brings; other libraries add theirs with
+ * defineTrait.
+ */
+const definitions = new Map([['render', {
+  keys: ['element', 'activeListeners'],
+  serializable: false,
+  defaults: () => ({
+    element: null
+  })
+}]]);
+exports.default = definitions;

package/dist/domItem/traits/definitions.min.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});const definitions=new Map([["render",{keys:["element","activeListeners"],serializable:!1,defaults:()=>({element:null})}]]);exports.default=definitions;

package/dist/domItem/traits/getNonSerializableKeys.d.ts

@@ -0,0 +1,9 @@
+import type { CoreItem } from '../types';
+/**
+ * The properties an item has only because of its traits, and which do not belong in json (the element of the render
+ * trait, for one).
+ * @param item - The item to look at.
+ * @private
+ */
+declare const getNonSerializableKeys: (item: CoreItem) => string[];
+export default getNonSerializableKeys;

package/dist/domItem/traits/getNonSerializableKeys.js

@@ -0,0 +1,25 @@
+"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 definitions_1 = __importDefault(require("./definitions"));
+/**
+ * The properties an item has only because of its traits, and which do not belong in json (the element of the render
+ * trait, for one).
+ * @param item - The item to look at.
+ * @private
+ */
+const getNonSerializableKeys = item => Object.keys(item.has ?? {}).flatMap(trait => {
+  const definition = definitions_1.default.get(trait);
+  return definition && definition.serializable === false ? definition.keys : [];
+});
+exports.default = getNonSerializableKeys;

package/dist/domItem/traits/getNonSerializableKeys.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 definitions_1=__importDefault(require("./definitions")),getNonSerializableKeys=e=>Object.keys(e.has??{}).flatMap(e=>{const t=definitions_1.default.get(e);return t&&!1===t.serializable?t.keys:[]});exports.default=getNonSerializableKeys;

package/dist/domItem/traits/getTraitDefinition.d.ts

@@ -0,0 +1,7 @@
+import type { TraitDefinition } from '../types';
+/**
+ * The runtime definition of a trait, if it was defined.
+ * @param name - The name of the trait.
+ */
+declare const getTraitDefinition: (name: string) => TraitDefinition | undefined;
+export default getTraitDefinition;

package/dist/domItem/traits/getTraitDefinition.js

@@ -0,0 +1,20 @@
+"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 definitions_1 = __importDefault(require("./definitions"));
+/**
+ * The runtime definition of a trait, if it was defined.
+ * @param name - The name of the trait.
+ */
+const getTraitDefinition = name => definitions_1.default.get(name);
+exports.default = getTraitDefinition;

package/dist/domItem/traits/getTraitDefinition.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 definitions_1=__importDefault(require("./definitions")),getTraitDefinition=e=>definitions_1.default.get(e);exports.default=getTraitDefinition;

package/dist/domItem/traits/hasTrait.d.ts

@@ -0,0 +1,8 @@
+import type { CoreItem, TraitName, WithTraits } from '../types';
+/**
+ * Whether an item has a trait. It is also a type guard: after the check the trait's data is typed on the item.
+ * @param item - The item to check.
+ * @param trait - The name of the trait.
+ */
+declare const hasTrait: <Trait extends TraitName>(item: CoreItem, trait: Trait) => item is CoreItem & WithTraits<Trait>;
+export default hasTrait;

package/dist/domItem/traits/hasTrait.js

@@ -0,0 +1,15 @@
+"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
+});
+/**
+ * Whether an item has a trait. It is also a type guard: after the check the trait's data is typed on the item.
+ * @param item - The item to check.
+ * @param trait - The name of the trait.
+ */
+const hasTrait = (item, trait) => (item.has ?? {})[trait] === true;
+exports.default = hasTrait;

package/dist/domItem/traits/hasTrait.min.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});const hasTrait=(e,t)=>!0===(e.has??{})[t];exports.default=hasTrait;

package/dist/domItem/traits/hasTraits.d.ts

@@ -0,0 +1,9 @@
+import type { CoreItem, TraitName, WithTraits } from '../types';
+/**
+ * Whether an item has all of these traits. It is also a type guard: after the check the data of every one of the traits
+ * is typed on the item.
+ * @param item - The item to check.
+ * @param traits - The names of the traits.
+ */
+declare const hasTraits: <Trait extends TraitName>(item: CoreItem, ...traits: Trait[]) => item is CoreItem & WithTraits<Trait>;
+export default hasTraits;

package/dist/domItem/traits/hasTraits.js

@@ -0,0 +1,16 @@
+"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
+});
+/**
+ * Whether an item has all of these traits. It is also a type guard: after the check the data of every one of the traits
+ * is typed on the item.
+ * @param item - The item to check.
+ * @param traits - The names of the traits.
+ */
+const hasTraits = (item, ...traits) => traits.every(trait => (item.has ?? {})[trait] === true);
+exports.default = hasTraits;

package/dist/domItem/traits/hasTraits.min.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});const hasTraits=(e,...s)=>s.every(s=>!0===(e.has??{})[s]);exports.default=hasTraits;

package/dist/domItem/traits/isDomItem.d.ts

@@ -0,0 +1,8 @@
+import type { CoreItem, DomItem } from '../types';
+/**
+ * Whether an item, and every item below it, has the render trait: the tree treeloom's render and sync functions work
+ * on. hasTrait only checks the one item, so use this where a tree comes from somewhere else. It is also a type guard.
+ * @param item - The item at the top of the tree to check.
+ */
+declare const isDomItem: (item: CoreItem) => item is DomItem;
+export default isDomItem;

package/dist/domItem/traits/isDomItem.js

@@ -0,0 +1,21 @@
+"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 hasTrait_1 = __importDefault(require("./hasTrait"));
+/**
+ * Whether an item, and every item below it, has the render trait: the tree treeloom's render and sync functions work
+ * on. hasTrait only checks the one item, so use this where a tree comes from somewhere else. It is also a type guard.
+ * @param item - The item at the top of the tree to check.
+ */
+const isDomItem = item => (0, hasTrait_1.default)(item, 'render') && item.children.every(isDomItem);
+exports.default = isDomItem;

package/dist/domItem/traits/isDomItem.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 hasTrait_1=__importDefault(require("./hasTrait")),isDomItem=e=>(0,hasTrait_1.default)(e,"render")&&e.children.every(isDomItem);exports.default=isDomItem;

package/dist/domItem/traits/withTrait.d.ts

@@ -0,0 +1,11 @@
+import type { CoreItem, TraitName, TraitRegistry, WithTraits } from '../types';
+/**
+ * Give an item a trait: the trait's defaults and the given data are put on the item (the same object, not a copy), and
+ * it is added to the item's has map.
+ * @param item - The item which gains the trait.
+ * @param trait - The name of the trait.
+ * @param data - The data the trait puts on the item.
+ * @returns The same item, now with the trait.
+ */
+declare const withTrait: <Item extends CoreItem, Trait extends TraitName>(item: Item, trait: Trait, data: TraitRegistry[Trait]) => Item & WithTraits<Trait>;
+export default withTrait;

package/dist/domItem/traits/withTrait.js

@@ -0,0 +1,30 @@
+"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 definitions_1 = __importDefault(require("./definitions"));
+/**
+ * Give an item a trait: the trait's defaults and the given data are put on the item (the same object, not a copy), and
+ * it is added to the item's has map.
+ * @param item - The item which gains the trait.
+ * @param trait - The name of the trait.
+ * @param data - The data the trait puts on the item.
+ * @returns The same item, now with the trait.
+ */
+const withTrait = (item, trait, data) => {
+  Object.assign(item, definitions_1.default.get(trait)?.defaults?.(), data);
+  item.has = Object.assign(item.has ?? {}, {
+    [trait]: true
+  });
+  return item;
+};
+exports.default = withTrait;

package/dist/domItem/traits/withTrait.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 definitions_1=__importDefault(require("./definitions")),withTrait=(e,t,i)=>(Object.assign(e,definitions_1.default.get(t)?.defaults?.(),i),e.has=Object.assign(e.has??{},{[t]:!0}),e);exports.default=withTrait;

package/dist/domItem/tree/appendChild.d.ts

@@ -0,0 +1,8 @@
+import type { DomItem } from '../types';
+/**
+ * Append a child to the end of given parent's children list.
+ * @param parent - The parent that will receive the child.
+ * @param child - The new child to attach to the parent.
+ */
+declare const appendChild: (parent: DomItem, child: DomItem) => DomItem;
+export default appendChild;

package/dist/domItem/tree/appendChild.js

@@ -0,0 +1,19 @@
+"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
+});
+/**
+ * Append a child to the end of given parent's children list.
+ * @param parent - The parent that will receive the child.
+ * @param child - The new child to attach to the parent.
+ */
+const appendChild = (parent, child) => {
+  parent.children.push(child);
+  child.parentItem = parent;
+  return parent;
+};
+exports.default = appendChild;

package/dist/domItem/tree/appendChild.min.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});const appendChild=(e,t)=>(e.children.push(t),t.parentItem=e,e);exports.default=appendChild;