@ultimat3/ui 28.0.0 → 29.1.0

package/CLAUDE.md

@@ -71,7 +71,7 @@ Tier 4. Imports `@ultimat3/core`, `i18n`, `money`, `time` — **not `schema`**,
 | `src/theme/ambient-slot.ts` | the module-scope slot holding the reader `useUi()` falls back to on the server — imports nothing, so a browser chunk pays nothing for it |
 | `src/theme/ambient.ts` | the server's reader (`ambientUiContext`: request locale, zone, direction, translator), registered at import; `index.ts` imports it bare, and the `browser` field maps it to `ambient.browser.ts`, which answers the defaults and registers nothing |
 | `src/error-registry.ts` | the `registerErrorCodes()` call, alone, so `errors.ts` is pure and the barrel's re-export of it costs a chunk nothing |
-| `src/components/` | 67 components, `PascalCase.tsx` (component convention overrides the repo's kebab-case) |
+| `src/components/` | See [CATALOG.md](CATALOG.md)'s generated header for the component inventory and total; `PascalCase.tsx` (component convention overrides the repo's kebab-case) |
 | `src/icons/glyphs/` | GENERATED: 1767 per-icon modules, `@ultimat3/ui/icons/<name>` → `icon<Name>` |
 | `src/icons/build-icons.ts` | the generator + the pinned `LUCIDE_VERSION`; `LICENSE.lucide` is upstream's ISC text |
 | `src/theme/brand.ts` | `defineTheme()` — the ONE brand-override seam; there is no SCSS `@use ... with ()` path. Merges a preset under the overrides, measures, emits at every level `theme.scss` does |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/ui",
-  "version": "28.0.0",
+  "version": "29.1.0",
   "description": "SolidJS design system: semantic design tokens, dark/RTL-ready SCSS modules, a11y primitives",
   "license": "MIT",
   "type": "module",
@@ -39,7 +39,7 @@
     "LICENSE"
   ],
   "engines": {
-    "bun": ">=1.4.3"
+    "bun": ">=1.4.4"
   },
   "scripts": {
     "typecheck": "tsc --noEmit -p tsconfig.json",
@@ -48,10 +48,10 @@
     "icons": "bun run src/icons/build-icons.ts"
   },
   "dependencies": {
-    "@ultimat3/core": "28.0.0",
-    "@ultimat3/i18n": "28.0.0",
-    "@ultimat3/money": "28.0.0",
-    "@ultimat3/time": "28.0.0"
+    "@ultimat3/core": "29.1.0",
+    "@ultimat3/i18n": "29.1.0",
+    "@ultimat3/money": "29.1.0",
+    "@ultimat3/time": "29.1.0"
   },
   "peerDependencies": {
     "solid-js": "^1.9.0"

package/src/global.scss

@@ -30,11 +30,17 @@
 // The client router's route-presented modal (`@ultimat3/render`'s `NAVIGATION_MODAL_ATTRIBUTE`, a
 // route declaring `navigation: 'modal'`): a native <dialog> holding the page's `<main>`, styled as
 // `Dialog` is. Global because no component renders it — the router does, and `render` cannot
-// import `ui` (one tier) — so the name is held equal by render's `navigation-modal-style.test.ts`.
-// `:where()`: an app restyles it without out-shouting a selector.
+// import `ui` (one tier) — so the names are held equal by render's `navigation-modal-style.test.ts`.
+// `:where()`: an app restyles it without out-shouting a selector. Opened as a top-layer popover
+// (`show()` + `showPopover()`, never `showModal()`, whose inert document recalculates the style of
+// every element beneath), so it is placed here as `showModal()` would have placed it.
 :where(dialog[data-x-modal]) {
+  position: fixed;
+  inset: 0;
   inline-size: min(100% - #{t.space(8)}, 40rem);
+  block-size: fit-content;
   max-block-size: min(88dvh, 60rem);
+  margin: auto;
   padding: t.space(5);
   border: 1px solid t.role('line');
   border-radius: t.radius(lg);
@@ -51,6 +57,87 @@
   }
 }
 
+// The frame's close button (`NAVIGATION_MODAL_CLOSE_ATTRIBUTE`): after the content in the DOM, at
+// the dialog's top corner on screen. Its name is its `aria-label`; the cross is drawn, not written.
+:where([data-x-modal-close]) {
+  position: absolute;
+  inset-block-start: t.space(3);
+  inset-inline-end: t.space(3);
+  inline-size: t.space(8);
+  block-size: t.space(8);
+  padding: 0;
+  border: 0;
+  border-radius: t.radius(md);
+  background: transparent;
+  color: t.role('fg-muted');
+  cursor: pointer;
+
+  &::before,
+  &::after {
+    content: '';
+    position: absolute;
+    inset-block-start: 50%;
+    inset-inline-start: 25%;
+    inline-size: 50%;
+    block-size: t.rem(2px);
+    border-radius: t.radius(full);
+    background: currentcolor;
+    rotate: 45deg;
+  }
+
+  &::after {
+    rotate: -45deg;
+  }
+
+  &:hover {
+    background: t.role('bg-soft');
+    color: t.role('fg');
+  }
+}
+
+// The modal's own heading clears the close button.
+:where([data-x-modal-body] > :is(h1, h2):first-child) {
+  padding-inline-end: t.space(8);
+}
+
+// The body while the modal's document is on its way (`aria-busy`): a skeleton the size of a short
+// form, built from surface roles as `Skeleton` is, so the dialog does not jump far when it fills.
+:where([data-x-modal-skeleton]) {
+  display: grid;
+  gap: t.space(3);
+  min-block-size: 12rem;
+
+  &::before,
+  &::after {
+    content: '';
+    display: block;
+    border-radius: t.radius(md);
+    background: linear-gradient(
+        90deg,
+        t.role('bg-soft') 25%,
+        t.role('line') 37%,
+        t.role('bg-soft') 63%
+      )
+      0 0 / 200% 100%;
+    animation: ultimate-modal-shimmer calc(#{t.duration(slower)} * 2) linear infinite;
+  }
+
+  &::before {
+    inline-size: 60%;
+    block-size: t.space(6);
+  }
+
+  &::after {
+    block-size: 8rem;
+  }
+}
+
+@keyframes ultimate-modal-shimmer {
+  to {
+    background-position: -200% 0;
+  }
+}
+
 @keyframes ultimate-modal-in {
   from {
     opacity: 0;

package/src/tokens/reset.scss

@@ -135,6 +135,13 @@ html:has(dialog:modal) {
   overflow: hidden;
 }
 
+// The router's route-presented modal is a top-layer popover, never `:modal` (`global.scss` says
+// why), so it locks the scroll by its own name. A child combinator from <body>: the one place the
+// router appends it, so the `:has()` is answered without walking the page.
+:where(html:has(> body > dialog[data-x-modal][open])) {
+  overflow: hidden;
+}
+
 // The live region `announce()` (`../a11y.ts`) appends to <body>, hidden from here rather than
 // through `element.style`: a style a script applies at runtime is not among the inline styles the
 // CSP the framework itself sends has hashed, so it logged a `style-src` violation on every page