npm - @skirbi/sugar - Versions diffs - 0.0.15 → 0.0.17 - Mend

@skirbi/sugar 0.0.15 → 0.0.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/Changes CHANGED Viewed

@@ -1,5 +1,16 @@
 Revision history for @skirbi/sugar
+0.0.17       2026-04-20 02:34:38Z
+  * Fakedom, not fakedomE
+0.0.16       2026-04-20 02:29:48Z
+  * Introduce fakedom.mjs, can be imported as @skirbi/sugar/fakedom
+    It's used by testing.mjs and soon also in @skirbi/bolbe so it doesn't need
+    tap. Testing.mjs still exports the same API, so no breakage is expected
+    (well, the testsuite confirmed it, soo, pretty sure actually).
 0.0.15       2026-04-18 18:38:19Z

package/lib/fakedom.mjs ADDED Viewed

@@ -0,0 +1,88 @@
+// SPDX-FileCopyrightText: 2025, 2026 Wesley Schwengle <wesleys@opperschaap.net>
+//
+// SPDX-License-Identifier: MIT
+import { JSDOM } from 'jsdom';
+import { fileURLToPath, pathToFileURL } from 'url';
+import path from 'path';
+/**
+ * Initialize a jsdom-based DOM environment for component testing.
+ *
+ * This function:
+ * - Creates a new JSDOM instance
+ * - Exposes common DOM globals on `global`
+ * - Optionally imports one or more modules after the DOM is ready
+ *
+ * It is intended for use in test files before mounting custom elements.
+ *
+ * @param {string} [html='<!doctype html><html><body></body></html>']
+ *   Initial HTML document to load into jsdom.
+ *
+ * @param {...string} modulePaths
+ *   Relative paths (from project root) to modules that should be imported
+ *   after the DOM environment is initialized.
+ *
+ * @returns {Promise<void>}
+ */
+export async function setupDomForTesting(
+  html = '<!doctype html><html><body></body></html>',
+  ...modulePaths
+) {
+  const dom = new JSDOM(html);
+  // Expose minimal DOM globals required for custom elements.
+  global.DocumentFragment = dom.window.DocumentFragment;
+  global.HTMLElement = dom.window.HTMLElement;
+  global.HTMLTemplateElement = dom.window.HTMLTemplateElement;
+  global.Node = dom.window.Node;
+  global.customElements = dom.window.customElements;
+  global.document = dom.window.document;
+  global.window = dom.window;
+  global.MutationObserver = dom.window.MutationObserver;
+  const projectRoot = process.cwd();
+  // Import modules after DOM is ready.
+  for (const relPath of modulePaths) {
+    const absURL = pathToFileURL(path.resolve(projectRoot, relPath));
+    await import(absURL.href);
+  }
+}
+/**
+ * Wait for the DOM lifecycle to settle.
+ *
+ * Resolves after one microtask and one macrotask tick.
+ *
+ * Useful in tests to ensure:
+ * - customElements upgrades have completed
+ * - connectedCallback has run
+ * - DOM mutations triggered by innerHTML have flushed
+ *
+ * @param {number} [times=1] - Number of ticks to wait.
+ * @returns {Promise<void>}
+ */
+export async function tick(times = 1) {
+  for (let i = 0; i < times; i++) {
+    await Promise.resolve(); // microtask
+    await new Promise(r => setTimeout(r, 0)); // macrotask
+  }
+}
+/**
+ * Simulate a morph-style DOM replacement (e.g. Livewire / morphdom).
+ *
+ * Replaces the element's innerHTML and waits for lifecycle hooks
+ * and custom element upgrades to complete.
+ *
+ * Intended for testing idempotent connectedCallback behavior.
+ *
+ * @param {Element} el - The container element to replace content in.
+ * @param {string} html - The HTML string to inject.
+ * @returns {Promise<void>}
+ */
+export async function morphReplace(el, html) {
+  el.innerHTML = html;
+  await tick();
+}

package/lib/index.mjs CHANGED Viewed

@@ -2,7 +2,7 @@
 //
 // SPDX-License-Identifier: MIT
-const VERSION = "0.0.15";
+const VERSION = "0.0.17";
 export { HTMLElementSugar } from './htmlelement.mjs';
 export { HTMLElementSugarInput } from './htmlelement-input.mjs';

package/lib/testing.mjs CHANGED Viewed

@@ -2,54 +2,9 @@
 //
 // SPDX-License-Identifier: MIT
-import { JSDOM } from 'jsdom';
-import { fileURLToPath, pathToFileURL } from 'url';
-import t from 'tap';
-import path from 'path';
-/**
- * Initialize a jsdom-based DOM environment for component testing.
- *
- * This function:
- * - Creates a new JSDOM instance
- * - Exposes common DOM globals on `global`
- * - Optionally imports one or more modules after the DOM is ready
- *
- * It is intended for use in test files before mounting custom elements.
- *
- * @param {string} [html='<!doctype html><html><body></body></html>']
- *   Initial HTML document to load into jsdom.
- *
- * @param {...string} modulePaths
- *   Relative paths (from project root) to modules that should be imported
- *   after the DOM environment is initialized.
- *
- * @returns {Promise<void>}
- */
-export async function setupDomForTesting(
-  html = '<!doctype html><html><body></body></html>',
-  ...modulePaths
-) {
-  const dom = new JSDOM(html);
-  // Expose minimal DOM globals required for custom elements.
-  global.DocumentFragment = dom.window.DocumentFragment;
-  global.HTMLElement = dom.window.HTMLElement;
-  global.HTMLTemplateElement = dom.window.HTMLTemplateElement;
-  global.Node = dom.window.Node;
-  global.customElements = dom.window.customElements;
-  global.document = dom.window.document;
-  global.window = dom.window;
-  global.MutationObserver = dom.window.MutationObserver;
-  const projectRoot = process.cwd();
-  // Import modules after DOM is ready.
-  for (const relPath of modulePaths) {
-    const absURL = pathToFileURL(path.resolve(projectRoot, relPath));
-    await import(absURL.href);
-  }
-}
+export { tick, morphReplace, setupDomForTesting, } from './fakedom.mjs';
+import t from 'tap';
 /**
  * Test a component's example contract.
@@ -153,40 +108,3 @@ function stripWhitespaceTextNodes(node) {
   }
   return node;
 }
-/**
- * Wait for the DOM lifecycle to settle.
- *
- * Resolves after one microtask and one macrotask tick.
- *
- * Useful in tests to ensure:
- * - customElements upgrades have completed
- * - connectedCallback has run
- * - DOM mutations triggered by innerHTML have flushed
- *
- * @param {number} [times=1] - Number of ticks to wait.
- * @returns {Promise<void>}
- */
-export async function tick(times = 1) {
-  for (let i = 0; i < times; i++) {
-    await Promise.resolve(); // microtask
-    await new Promise(r => setTimeout(r, 0)); // macrotask
-  }
-}
-/**
- * Simulate a morph-style DOM replacement (e.g. Livewire / morphdom).
- *
- * Replaces the element's innerHTML and waits for lifecycle hooks
- * and custom element upgrades to complete.
- *
- * Intended for testing idempotent connectedCallback behavior.
- *
- * @param {Element} el - The container element to replace content in.
- * @param {string} html - The HTML string to inject.
- * @returns {Promise<void>}
- */
-export async function morphReplace(el, html) {
-  el.innerHTML = html;
-  await tick();
-}

package/package.json CHANGED Viewed

@@ -20,6 +20,7 @@
     "./aliases": "./lib/aliases.mjs",
     "./aliases-register": "./lib/aliases-register.mjs",
     "./boolean": "./lib/boolean.mjs",
+    "./fakedom": "./lib/fakedom.mjs",
     "./htmlelement": "./lib/htmlelement.mjs",
     "./htmlelement-input": "./lib/htmlelement-input.mjs",
     "./htmlelement-select": "./lib/htmlelement-select.mjs",
@@ -50,5 +51,5 @@
   },
   "sideEffects": false,
   "type": "module",
-  "version": "0.0.15"
+  "version": "0.0.17"
 }