@massimo-cassandro/minimo 1.9.0 → 1.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@massimo-cassandro/minimo",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "Light css framework & utilities",
   "type": "module",
   "main": "./index.js",

package/src/components/unsplash-page/fetch-unsplash-data.js

@@ -59,7 +59,7 @@ export async function fetchUnsplashData(settings) {
           width              : data.width,
           height             : data.height,
           // description        : data.description,
-          // location           : data.location.name,
+          // location           : data.location?.name,
           alt_description    : data.alt_description,
           date               : data.created_at,
           base_url           : data.urls.raw,
@@ -68,7 +68,7 @@ export async function fetchUnsplashData(settings) {
           author_profile     : data.user.links.html,
           blur_hash          : data.blur_hash,
           image_description  : (() => {
-            let location = data.location.name,
+            let location = data.location?.name,
               description = data.description?? data.alt_description;
             if(data.description && location) {
               location = (new RegExp(location, 'i')).test(description)? null : location;

package/src/utilities/dom-builder/dom-builder.js

@@ -64,18 +64,23 @@ import { parseDomString } from './parseDomString.js';
  *
  * @function domBuilder
  * @param {Array<DomBuilderItem|string>} [structureArray=[]] - Configuration array. Accepts strings (shorthand per `parseDomString`) and/or configuration objects.
- * @param {HTMLElement} [parent] - Parent element to append the structure to.
+ * @param {HTMLElement} [parent] - Parent element the structure is attached to (see `options.insertMode`).
  * @param {Object} [options={}] - Configuration options.
  * @param {boolean} [options.emptyParent=false] - When true, the parent element is emptied before building.
+ * @param {'append'|'before'|'after'} [options.insertMode='append'] - How each root element of `structureArray` is attached to `parent`: `append` inserts it as a child (default), `before`/`after` insert it as a previous/next sibling of `parent`, preserving `structureArray` order. Only applies to the elements produced by this call — nested `domBuilder` calls (`content`, `children`) always append.
  * @returns {HTMLElement|null} The first created element, or null if nothing was created.
  */
 export function domBuilder(structureArray = [], parent, options = {}) {
 
   options = {
     emptyParent: false,
+    insertMode: 'append',
     ...options
   };
 
+  /** @type {Map<HTMLElement, HTMLElement>} tracks, for `insertMode: 'after'`, the last inserted sibling per parent node */
+  const afterAnchors = new Map();
+
   /** @type {HTMLElement | null} */
   let mainElement = null;
   /** @type {HTMLElement} */
@@ -166,7 +171,7 @@ export function domBuilder(structureArray = [], parent, options = {}) {
 
       if (safeItem.children != null && !Array.isArray(safeItem.children)) {
         // eslint-disable-next-line no-console
-        console.error('Error: `item.children` must be an array → ' + safeItem.children);
+        console.error('[domBuilder]: `item.children` must be an array → ' + safeItem.children);
       }
       if (safeItem.children && Array.isArray(safeItem.children)) {
         domBuilder(safeItem.children, el, {emptyParent: false});
@@ -177,7 +182,17 @@ export function domBuilder(structureArray = [], parent, options = {}) {
       }
 
       if (parent) {
-        parent.appendChild(el);
+        if (options.insertMode === 'before') {
+          parent.parentNode?.insertBefore(el, parent);
+
+        } else if (options.insertMode === 'after') {
+          const anchor = afterAnchors.get(parent) ?? parent;
+          anchor.parentNode?.insertBefore(el, anchor.nextSibling);
+          afterAnchors.set(parent, el);
+
+        } else {
+          parent.appendChild(el);
+        }
       }
 
       // TODO callbacks that act on the element's children may not run when no parent is set