@massimo-cassandro/minimo 1.20.9 → 1.20.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@massimo-cassandro/minimo",
-  "version": "1.20.9",
+  "version": "1.20.10",
   "description": "Light css framework & utilities",
   "type": "module",
   "main": "./index.js",
@@ -43,7 +43,7 @@
     "test": "node --test \"test/**/*.test.mjs\"",
     "test sideEffects tree-shaking": "node ./test/sideEffects-tree-shaking/run-test.mjs",
     "checkJS": "npx tsc --noEmit -p jsconfig.json",
-    "checkJS ./src": "npx tsc --noEmit --allowJs --checkJs --target ES2023 --module ESNext --allowSyntheticDefaultImports --moduleResolution bundler declarations.d.ts src/**/*.js",
+    "checkJS ./src": "npx tsc --noEmit --allowJs --checkJs --target ES2023 --module ESNext --allowSyntheticDefaultImports --moduleResolution bundler declarations.d.ts types/global.d.ts src/**/*.js",
     "check outdated": "echo '*** ROOT ***' && npm outdated --omit=peer && echo '*** DEMO ***' && npm --prefix ./demo outdated && echo '*** END ***'"
   },
   "license": "MIT",

package/src/components/modal-popup/modal-popup.js

@@ -50,13 +50,13 @@ function closeDialog(el) {
  * @param {string | number | null} [params.dialogMinHeight=null] - optional dialog min-height value - if set, overrides main css custom prop
  * @param {string | number | null} [params.dialogMaxHeight=null] - optional dialog max-height value - if set, overrides main css custom prop
  * @param {string | null} [params.iframeUrl=null] - URL to load in an iframe.
- * @param {string | any[] | null} [params.content=null] - Plain text, HTML, or a domBuilder array.
+ * @param {string | DomBuilderItem[] | null} [params.content=null] - Plain text, HTML, or a domBuilder array.
  * @param {string | null} [params.ajaxUrl=null] - URL for Ajax content loading.
  * @param {((data: *, el: Element) => void) | null} [params.ajaxCallback=null] - Called with the Ajax response and the content element.
  * @param {((el: HTMLDialogElement) => void) | null} [params.closeCallback=null] - Called with the dialog element just before it is removed.
  * @param {boolean} [params.addScrollbarPadding=false] - Adds right padding to compensate for the scrollbar.
- * @param {string | any[] | null} [params.headerContent=null] - Header content: plain text, HTML, or a domBuilder array.
- * @param {string | any[] | null} [params.footerContent=null] - Footer content: plain text, HTML, or a domBuilder array.
+ * @param {string | DomBuilderItem[] | null} [params.headerContent=null] - Header content: plain text, HTML, or a domBuilder array.
+ * @param {string | DomBuilderItem[] | null} [params.footerContent=null] - Footer content: plain text, HTML, or a domBuilder array.
  * @param {HTMLElement | null} [params.triggerElement=null] - Optional element that triggered the popup; when set, `aria-haspopup`, `aria-controls` and `aria-expanded` are managed on it.
  * @returns {HTMLDialogElement} The dialog element.
  */

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

@@ -1,6 +1,4 @@
 
-/** @typedef {import('./dom-builder.js').DomBuilderItem} DomBuilderItem */
-
 // boolean attributes are omitted when their value is explicitly false;
 // declared once at module level (Set for O(1) lookup) since the list never changes between calls
 const boolAttrs = new Set([

package/types/global.d.ts

@@ -0,0 +1,11 @@
+// Global alias for domBuilder's config-object type, so JSDoc across the codebase can
+// reference `DomBuilderItem` directly instead of repeating an `import(...)` type query.
+// The canonical definition lives in dom-builder.js — this only re-exports it.
+type DomBuilderItem = import('../src/utilities/dom-builder/dom-builder.js').DomBuilderItem;
+
+// Sanitizer API (Element.setHTML / getHTML) — not yet in TypeScript's lib.dom.d.ts.
+// https://developer.mozilla.org/en-US/docs/Web/API/Element/setHTML
+interface Element {
+  setHTML?(input: string, options?: { sanitizer?: unknown }): void;
+  getHTML?(options?: { serializableShadowRoots?: boolean; shadowRoots?: ShadowRoot[] }): string;
+}