@eagami/ui 5.28.0 → 5.30.0

package/README.md

@@ -126,6 +126,17 @@ Every component adheres to WCAG 2.2 Level AA and follows the matching [WAI-ARIA
 
 The library is SSR-safe and renders on the server (Angular Universal / `@angular/ssr`) without reaching for `window` or `document`. Browser-only work (focus management, the native `<dialog>`, overlay positioning, resize/intersection observers) is deferred to the client via `afterNextRender` and `isPlatformBrowser` guards, so prerendering, streaming SSR, and hydration work with no extra configuration.
 
+## Testing
+
+jsdom implements `<dialog>` without `showModal()` or `close()`, so a unit test that creates a component holding an open `<ea-dialog>` or `<ea-drawer>` throws before the spec body runs. The `@eagami/ui/testing` entry point ships a shim that fills in the missing methods; it patches only what the runtime lacks, so it is a no-op in real browsers. Call it once from your test setup file:
+
+```ts
+// test-setup.ts
+import { installNativeDialogShim } from '@eagami/ui/testing';
+
+installNativeDialogShim();
+```
+
 ## Framework integration
 
 `@eagami/ui` is Angular-only, but its design tokens are framework-agnostic. Self-contained copy-and-paste guides and a machine-readable token export are published with the docs and kept in sync with the token source on every release:

package/fesm2022/eagami-ui-testing.mjs

@@ -0,0 +1,42 @@
+/**
+ * Fills in the native `<dialog>` methods jsdom leaves unimplemented, so a spec
+ * can create a component that opens an `ea-dialog` or `ea-drawer` without the
+ * test runner throwing on `showModal()` or `close()`. Call once from the test
+ * setup file. Only missing methods are patched, so a runtime that implements
+ * the element keeps its own behavior.
+ */
+function installNativeDialogShim() {
+    if (typeof HTMLDialogElement === 'undefined') {
+        return;
+    }
+    const proto = HTMLDialogElement.prototype;
+    if (typeof proto.show !== 'function') {
+        proto.show = function () {
+            this.open = true;
+        };
+    }
+    if (typeof proto.showModal !== 'function') {
+        proto.showModal = function () {
+            this.open = true;
+        };
+    }
+    if (typeof proto.close !== 'function') {
+        proto.close = function (returnValue) {
+            if (!this.open) {
+                return;
+            }
+            if (returnValue !== undefined) {
+                this.returnValue = returnValue;
+            }
+            this.open = false;
+            this.dispatchEvent(new Event('close'));
+        };
+    }
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { installNativeDialogShim };
+//# sourceMappingURL=eagami-ui-testing.mjs.map

package/fesm2022/eagami-ui-testing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"eagami-ui-testing.mjs","sources":["../../../testing/src/native-dialog.ts","../../../testing/src/eagami-ui-testing.ts"],"sourcesContent":["/**\n * Fills in the native `<dialog>` methods jsdom leaves unimplemented, so a spec\n * can create a component that opens an `ea-dialog` or `ea-drawer` without the\n * test runner throwing on `showModal()` or `close()`. Call once from the test\n * setup file. Only missing methods are patched, so a runtime that implements\n * the element keeps its own behavior.\n */\nexport function installNativeDialogShim(): void {\n  if (typeof HTMLDialogElement === 'undefined') {\n    return;\n  }\n  const proto = HTMLDialogElement.prototype;\n  if (typeof proto.show !== 'function') {\n    proto.show = function (this: HTMLDialogElement): void {\n      this.open = true;\n    };\n  }\n  if (typeof proto.showModal !== 'function') {\n    proto.showModal = function (this: HTMLDialogElement): void {\n      this.open = true;\n    };\n  }\n  if (typeof proto.close !== 'function') {\n    proto.close = function (this: HTMLDialogElement, returnValue?: string): void {\n      if (!this.open) {\n        return;\n      }\n      if (returnValue !== undefined) {\n        this.returnValue = returnValue;\n      }\n      this.open = false;\n      this.dispatchEvent(new Event('close'));\n    };\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"AAAA;;;;;;AAMG;SACa,uBAAuB,GAAA;AACrC,IAAA,IAAI,OAAO,iBAAiB,KAAK,WAAW,EAAE;QAC5C;IACF;AACA,IAAA,MAAM,KAAK,GAAG,iBAAiB,CAAC,SAAS;AACzC,IAAA,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE;QACpC,KAAK,CAAC,IAAI,GAAG,YAAA;AACX,YAAA,IAAI,CAAC,IAAI,GAAG,IAAI;AAClB,QAAA,CAAC;IACH;AACA,IAAA,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,UAAU,EAAE;QACzC,KAAK,CAAC,SAAS,GAAG,YAAA;AAChB,YAAA,IAAI,CAAC,IAAI,GAAG,IAAI;AAClB,QAAA,CAAC;IACH;AACA,IAAA,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU,EAAE;AACrC,QAAA,KAAK,CAAC,KAAK,GAAG,UAAmC,WAAoB,EAAA;AACnE,YAAA,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;gBACd;YACF;AACA,YAAA,IAAI,WAAW,KAAK,SAAS,EAAE;AAC7B,gBAAA,IAAI,CAAC,WAAW,GAAG,WAAW;YAChC;AACA,YAAA,IAAI,CAAC,IAAI,GAAG,KAAK;YACjB,IAAI,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;AACxC,QAAA,CAAC;IACH;AACF;;AClCA;;AAEG;;;;"}