@eagami/ui 5.29.0 → 5.30.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eagami/ui",
-  "version": "5.29.0",
+  "version": "5.30.1",
   "description": "Lightweight, accessible, themeable Angular UI component library and icon set built on CSS custom properties",
   "author": "Michal Wiraszka <michal@eagami.com>",
   "license": "MIT",
@@ -48,6 +48,10 @@
     ".": {
       "types": "./types/eagami-ui.d.ts",
       "default": "./fesm2022/eagami-ui.mjs"
+    },
+    "./testing": {
+      "types": "./types/eagami-ui-testing.d.ts",
+      "default": "./fesm2022/eagami-ui-testing.mjs"
     }
   },
   "type": "module",
@@ -56,6 +60,7 @@
     "types",
     "src/styles",
     "schematics",
+    "testing",
     "README.md"
   ],
   "schematics": "./schematics/collection.json"

package/testing/package.json

@@ -0,0 +1,4 @@
+{
+  "module": "../fesm2022/eagami-ui-testing.mjs",
+  "typings": "../types/eagami-ui-testing.d.ts"
+}

package/types/eagami-ui-testing.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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.
+ */
+declare function installNativeDialogShim(): void;
+
+export { installNativeDialogShim };

package/types/eagami-ui.d.ts

@@ -1843,6 +1843,17 @@ type DialogWidth = EaWidth;
  * for browser-managed focus trapping, supports backdrop and Escape dismissal,
  * and exposes `header`, default, and `footer` content slots. The `open` state
  * is a two-way `model()` binding.
+ *
+ * The header is a row that lays its slot content out against the built-in
+ * close button, and it applies the h4 type scale to that content, so a heading
+ * element projected into it should carry `font: inherit`. Panel chrome is
+ * tunable per dialog via `--ea-dialog-inset`, `--ea-dialog-radius`,
+ * `--ea-dialog-max-height`, `--ea-dialog-header-padding`,
+ * `--ea-dialog-body-padding`, and `--ea-dialog-status-padding`; an
+ * edge-to-edge media surface zeroes the inset, radius, and paddings.
+ *
+ * Specs running under jsdom need `installNativeDialogShim()` from
+ * `@eagami/ui/testing` before opening one.
  */
 declare class DialogComponent implements AfterContentChecked {
     private readonly dialogEl;
@@ -1941,6 +1952,9 @@ type DrawerAnimation = 'none' | 'linear' | 'eased';
  * Escape dismissal, and exposes `header`, default, and `footer` content
  * slots. The `open` state is a two-way `model()` binding. In `push` mode it
  * opens non-modally and reflows the page content aside instead of overlaying it.
+ *
+ * Specs running under jsdom need `installNativeDialogShim()` from
+ * `@eagami/ui/testing` before opening one.
  */
 declare class DrawerComponent implements AfterContentChecked {
     private readonly drawerEl;
@@ -3810,8 +3824,8 @@ type TagTooltip = 'above' | 'below' | 'none';
  * accessible name of that button is configurable via `removeLabel` and
  * otherwise falls back to the active locale's translation.
  *
- * The projected label is capped by `maxWidth` (or the `--ea-tag-max-width`
- * custom property) and ellipsizes rather than widening the chip, revealing its
+ * When capped by `maxWidth` (or the `--ea-tag-max-width` custom property),
+ * the projected label ellipsizes rather than widening the chip, revealing its
  * full text in a tooltip while it is clipped.
  */
 declare class TagComponent {