@massimo-cassandro/minimo 1.28.3 → 1.28.5

package/dev-tools/starter-kit/templates/CLAUDE-frontend.md

@@ -7,7 +7,8 @@
 ## Stile di lavoro
 
 - Conferma la comprensione prima di agire su richieste ambigue
-- Il progetto usa ES modules (import/export), evitare sioluzioni che utilizzano commonJs
-- In linea di massima non proporre soluzioni che richiedano modifiche alla parte back-end, a meno che non sia esplicitamente richiesto
-- nella chat evitare neologismi come parsare, committare ecc., usare i termini corrispondi in italiano o il termine originale in inglese dove non sia possibile un equivalente in italiano
+- Il progetto usa ES modules (import/export), evitare soluzioni che utilizzano commonJs
+- In linea di massima non proporre soluzioni che richiedano modifiche alla parte back-end, se presente, a meno che non sia esplicitamente richiesto
+- nella chat evitare neologismi come parsare, committare ecc., usare i termini corrispondenti in italiano o il termine originale in inglese dove non sia possibile un equivalente in italiano. Non coniugare mai secondo le regole dell'italiano verbi di altre lingue
 - nei commenti su più righe preferire `/* ... */` piuttosto che ripetere `//` ad igni inizio riga
+- a meno che non sia esplicitamente richiesto di eseguire subito una modifica, NON ESEGUIRE MAI nulla autonomamente ma mostra sempre un piano d'azione prima di procedere

package/dev-tools/update-version/index.mjs

@@ -78,7 +78,7 @@ async function run() {
       ('v.' + params.newSemver) +
       (params.logRow.descr
         ? ' - ' + params.logRow.descr
-        : params.updateMode === 'patch'
+        : params.updateMode === 'patch' && !(params.noLogV0 && params.semverArray[0] === 0)
           ? ' - Fix / Dependencies upd'
           : '')
     );

package/package.json

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

package/src/css/buttons/status-buttons.css

@@ -1,3 +1,4 @@
+/* TODO[epic=v2] eliminare custom props --_*, tutte le props devono essere gestibili dalle props globali */
 
 /* TODO rivedere tutto */
 

package/src/css/flex.css

@@ -1,3 +1,5 @@
+/* TODO[epic=v2] unificare regole comuni flex e grid */
+
 .flex {
   display: flex;
   flex-flow: row wrap;

package/src/css/forms/forms.css

@@ -24,7 +24,7 @@
   }
 }
 
-/* single checkbozes and radios are centered */
+/* single checkboxes and radios are vertically centered */
 .form-group:not(.form-collection-fset):has(.form-check:not(.form-check-top-label)) {
   align-self: center;
   .form-check {
@@ -39,7 +39,17 @@
   color: var(--form-label-color);
 }
 
-/*  per uso label implicito, senza id e for */
+/*
+with implicit label, without id and for.
+Example:
+
+<div class="form-group">
+  <label>
+    <span class="form-label">...</span>
+    <select class="form-control">...</select>
+  </label>
+</div>
+*/
 label:has(.form-control) {
   display: block;
   width: 100%;

package/src/css/grid.css

@@ -1,4 +1,4 @@
-/* TODO unificare regole comuni flex e grid */
+/* TODO[epic=v2] unificare regole comuni flex e grid */
 
 .grid {
   --_cols: 1;

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

@@ -100,7 +100,7 @@ import { parseDomString } from './parseDomString.js';
  * @param {HTMLElement} [parent] - Parent element the structure is attached to (see `options.insertMode`).
  * @param {Object} [options={}] - Configuration options. (default: {})
  * @param {boolean} [options.emptyParent=false] - When true, the parent element is emptied before building. (default: false)
- * @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. (default: 'append')
+ * @param {'append'|'prepend'|'before'|'after'} [options.insertMode='append'] - How each root element of `structureArray` is attached to `parent`: `append` inserts it as the last child (default), `prepend` as the first child, `before`/`after` insert it as a previous/next sibling of `parent`. In every mode, `structureArray` order is preserved. Only applies to the elements produced by this call — nested `domBuilder` calls (`content`, `children`) always append. (default: 'append')
  * @param {boolean} [options.debug=false] - When true, logs `structureArray` to the console after each string item has been parsed via `parseDomString` (i.e. the elaborated array actually used to build the DOM). (default: false)
  * @returns {HTMLElement|null} The first created element, or null if nothing was created.
  */
@@ -119,12 +119,12 @@ export function domBuilder(/** @type {Array<DomBuilderItem|string|Node>} */ stru
     parent.innerHTML = '';
   }
 
-  // For the default 'append' insert mode, root-level siblings are accumulated into a
-  // DocumentFragment and attached to `parent` with a single appendChild at the end,
-  // instead of one appendChild per sibling. 'before'/'after' modes need `target` to stay
+  // For the 'append'/'prepend' insert modes, root-level siblings are accumulated into a
+  // DocumentFragment and attached to `parent` with a single appendChild/insertBefore at
+  // the end, instead of one call per sibling. 'before'/'after' modes need `target` to stay
   // the real, live parent node throughout the loop for anchor resolution (see afterAnchors
   // below), so batching is skipped for those.
-  const useFragment = !!parent && options.insertMode === 'append';
+  const useFragment = !!parent && (options.insertMode === 'append' || options.insertMode === 'prepend');
 
   /** @type {HTMLElement | DocumentFragment | null} */
   let target = useFragment ? document.createDocumentFragment() : (parent ?? null);
@@ -345,7 +345,11 @@ export function domBuilder(/** @type {Array<DomBuilderItem|string|Node>} */ stru
   }
 
   if (useFragment && parent && target) {
-    parent.appendChild(target);
+    if (options.insertMode === 'prepend') {
+      parent.insertBefore(target, parent.firstChild);
+    } else {
+      parent.appendChild(target);
+    }
   }
 
   return mainElement;