@zeyos/zx 4.3.4 → 5.0.0

package/docs/llms.txt

@@ -2,8 +2,8 @@
 
 > Xenon is a dependency-free design system for browser applications; Zx is its product-agnostic
 > vanilla-JavaScript implementation. ES2022 modules, WAI-ARIA-accessible native
-> controls, semantic `--zx-*` design tokens with light/dark/density theming, and lifecycle-safe
-> components. Source modules run directly in the browser; a build step emits ESM, IIFE-global,
+> controls, semantic `--zx-*` design tokens with light/dark theming and one token-driven geometry,
+> and lifecycle-safe components. Source modules run directly in the browser; a build step emits ESM, IIFE-global,
 > ZeyOS binding, and CSS bundles. Zero runtime dependencies.
 
 Instantiate every component as `new Component(target, options)` where `target` is an Element, a
@@ -26,16 +26,22 @@ exports and as `window.zx.*`.
   `copyButton()`/`CopyInput`, `DatePicker`, `MonthPicker`, `TimePicker`,
   `Datebox`/`DateTimeBox`, `DateRangePicker`/`DateRangeBox`, `Timebox`.
 - Overlays: `Message` (toasts/inline/progress), `Modal`, `Dialog` (+ `alert`/`confirm`/`prompt` Promises), `Sheet` (edge-anchored Dialog; `side`, `modal: true|'trap-focus'|false`, `backdrop`, `snap` detents, swipe-to-dismiss), `SheetStack` (drill-down; `stack`/`cascade`), `Dropdown`, `MenuButton`, `ContextMenu` (right-click; `selector` for per-row menus), `Tooltip`/`tooltip()`/`describe()`.
-- Data: `Table` (sortable, selectable, sticky header, opt-in inline cell/row editing, row reorder,
+- Data: `EntityRef` (dense linked/static identity), `FileItem`/`FileList` (durable and transient
+  file presentation), `ActivityItem`/`ActivityList` (chronological entries and grouped feeds),
+  `Table` (sortable, selectable, sticky header, opt-in inline cell/row editing, row reorder,
   column visibility), shared `RecordView` state through `TableView`, `CardView`, and `KanbanView`,
   `Grid` with single-click editing and `Grid.BillingItems()`, engine-neutral
   `Chart` with injected `ChartJsAdapter`, `Calendar` (agenda/day/week/month/year, pointer/keyboard
   drag and resize, `optimistic: true|false`), backend-neutral nested `Filter`, simple client-side
-  `DataFilter`, `Pagination` (+ pure `paginationRange()`), `TreeView` (APG tree),
-  `Finder` (Miller columns).
-- Forms: `Form`, `Fieldset`, `Questionnaire` (guided one-question-at-a-time flow with branching), `Field` (type registry), `ValueList`, `MultiValueEditor`, `FieldUpload`.
+  `DataFilter`, `FilterPanel` (typed filter form built from a server's own field metadata;
+  `mode: 'draft'|'live'`, `serialize`), `ListToolbar` (search, live result count, view switch, and
+  tools whose badge is part of the accessible name), `Pagination` (+ pure `paginationRange()`),
+  `SortControl` (searchable field selector with a direction toggle, one atomic `{id,dir}`),
+  `TreeView` (APG tree), `Finder` (Miller columns).
+- Forms: `Form`, `Fieldset`, `Questionnaire` (guided one-question-at-a-time flow with branching), `Field` (type registry), `CodeEditor` (structured text in a native textarea; never executes or injects the value), `ValueList`, `MultiValueEditor`, `FieldUpload`.
 - Layout: `stack()`/`grid()`/`aspect()` (spacing, an intrinsically reflowing grid, a fixed-ratio
-  box), `Groupbox`, `Card` (media/title link/actions/footer), `AppIcon` (generic tile geometry;
+  box), `Groupbox`, `Card` (media/title link/actions/footer), `StatTile`/`statTile()` (labelled
+  metric with optional delta, sparkline, and loading state), `AppIcon` (generic tile geometry;
   circular `zeyosAppIcon()` application presets and compact `moduleChip()` identities),
   `Aurora` (one- to four-colour ambient
   canvas light; shared material roles govern chrome and overlays), `Avatar`, `Panel` (header/footer action
@@ -50,7 +56,7 @@ exports and as `window.zx.*`.
 - Helpers: `formatNumber`/`formatCurrency`/`formatPercent`/`formatFileSize`/`formatRelativeTime` (locale-aware, cached `Intl`), `debounce`/`throttle`, `groupBy`/`sortBy`/`uniqueBy`, `escapeRegExp`/`highlightMatch`, `storage()` (namespaced JSON, degrades to memory), `toCsv`/`downloadBlob`/`copyToClipboard`, `truncate()`/`isTruncated()` (line clamp with the full value on hover).
 
 ## Theming
-Load `zx.css` once; set `data-zx-theme` (`light`|`dark`|`auto`) and `data-zx-density` (`cozy`|`compact`) on any ancestor. Define a product theme by overriding semantic `--zx-color-*` / `--zx-control-*` tokens under `[data-zx-theme="name"]`. The theme studio controls accent, neutral tint, density, font, type size, radius, control height, and CSS-first glass material. Compact menus, pickers, tooltips, column menus, and toasts share responsive compact glass; Launcher, Modal, Dialog, and floating Sheets share a calmer reading panel. Both preserve scoped theme inheritance and refract Aurora/page content; docked Sheets and dense data surfaces remain opaque. Never use tier-1 palette tokens or raw color literals in application CSS.
+Load `zx.css` once; set `data-zx-theme` (`light`|`dark`|`auto`) on any ancestor. There is one geometry: spacing steps are multiples of `--zx-space-unit` (4px), radius steps are fractions of `--zx-radius` (4px: 2/3/4/6px), and controls are `--zx-control-height` (30px) tall — override those to tighten or loosen an application. Define a product theme by overriding semantic `--zx-color-*` / `--zx-control-*` tokens under `[data-zx-theme="name"]`. The theme studio controls accent, neutral tint, spacing, font, type size, radius, control height, and CSS-first glass material. Compact menus, pickers, tooltips, column menus, and toasts share responsive compact glass; Launcher, Modal, Dialog, and floating Sheets share a calmer reading panel. Both preserve scoped theme inheritance and refract Aurora/page content; docked Sheets and dense data surfaces remain opaque. Never use tier-1 palette tokens or raw color literals in application CSS.
 
 ## Talking to ZeyOS
 Use the dedicated ZeyOS client library **`@zeyos/client`** (`npm install @zeyos/client`) for ZeyOS business data: `createZeyosClient({ platform, auth })`, typed `client.api.list/get/create/update<Resource>` over the full OpenAPI surface, and `normalizeListResult`. Zx accepts the client by injection and does not bundle it. See the `website/layouts/zeyos-invoices.layout.js` layout for a Zx-components-on-@zeyos/client reference. Zx also ships a minimal `Http`/`zeyosService` for ad-hoc in-app `remotecall`, but `@zeyos/client` is the recommended default.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeyos/zx",
-  "version": "4.3.4",
+  "version": "5.0.0",
   "description": "Dependency-free JavaScript implementation of the Xenon Design System.",
   "type": "module",
   "license": "MIT",

package/src/components/account-menu/account-menu.css

@@ -3,26 +3,50 @@
   min-inline-size: 0;
 }
 
-.zx-account-menu__trigger {
+/*
+ * The trigger is a flat row, not a button. MenuButton makes it a `.zx-btn.zx-menu-button`, and
+ * both of those stylesheets load after this one — `menu-button.css` centres it as an inline-flex
+ * pill and `button.css` gives it a border, a glass fill, a backdrop blur and a shadow. Every rule
+ * here is scoped under the root so it out-specifies them instead of depending on load order, and
+ * takes back each property they set rather than only the ones that were visible at the time.
+ */
+.zx-account-menu .zx-account-menu__trigger {
   display: grid;
   grid-template-columns: auto minmax(0, 1fr) auto;
   align-items: center;
-  gap: var(--zx-space-3);
+  justify-content: stretch;
+  gap: var(--zx-space-2);
   inline-size: 100%;
   min-block-size: calc(var(--zx-control-height) + var(--zx-space-2));
-  border-color: transparent;
+  border: 0;
+  border-radius: var(--zx-radius-md);
   background: transparent;
-  padding: var(--zx-space-2);
+  -webkit-backdrop-filter: none;
+  backdrop-filter: none;
+  box-shadow: none;
+  padding: var(--zx-space-1) var(--zx-space-2);
   color: inherit;
+  font-weight: var(--zx-weight-medium);
+  line-height: 1.3;
   text-align: start;
 }
 
-.zx-account-menu__trigger:hover,
-.zx-account-menu__trigger:focus-visible,
-.zx-account-menu__trigger[aria-expanded="true"] {
+.zx-account-menu .zx-account-menu__trigger:is(:hover, [aria-expanded="true"]):not(:disabled) {
   background: var(--zx-color-bg-hover);
 }
 
+.zx-account-menu .zx-account-menu__trigger:active:not(:disabled) {
+  background: var(--zx-color-bg-current);
+}
+
+.zx-account-menu .zx-account-menu__trigger:focus-visible {
+  box-shadow: var(--zx-focus-ring);
+}
+
+.zx-account-menu__chevron {
+  color: var(--zx-color-text-subtle);
+}
+
 .zx-account-menu__identity {
   display: grid;
   min-inline-size: 0;
@@ -36,8 +60,8 @@
   white-space: nowrap;
 }
 
-.zx-account-menu__name { font-weight: 650; }
-.zx-account-menu__secondary { color: var(--zx-color-text-muted); font-size: var(--zx-text-xs); }
+.zx-account-menu__name { font-weight: var(--zx-weight-semibold); }
+.zx-account-menu__secondary { color: var(--zx-color-text-muted); font-size: var(--zx-text-xs); font-weight: 400; }
 .zx-account-menu__chevron { display: inline-flex; }
 
 .zx-account-menu[data-compact="true"] {
@@ -48,6 +72,7 @@
   display: inline-grid;
   grid-template-columns: auto;
   inline-size: auto;
+  padding: var(--zx-space-1);
 }
 
 .zx-account-menu[data-compact="true"] .zx-account-menu__identity,
@@ -61,7 +86,7 @@
   gap: 2px;
   margin: calc(-1 * var(--zx-space-1)) calc(-1 * var(--zx-space-1)) var(--zx-space-1);
   border-block-end: 1px solid var(--zx-color-overlay-divider);
-  padding: var(--zx-space-3);
+  padding: var(--zx-space-2) var(--zx-space-3);
 }
 
 .zx-account-menu__panel-identity span {

package/src/components/activity-item/activity-item.css

@@ -0,0 +1,137 @@
+.zx-activity-item {
+  inline-size: 100%;
+  min-inline-size: 0;
+  color: var(--zx-color-text);
+  list-style: none;
+  container-type: inline-size;
+}
+
+.zx-activity-item__article {
+  display: grid;
+  grid-template-columns: auto minmax(0, 1fr);
+  gap: var(--zx-space-3);
+  min-inline-size: 0;
+  padding-block: var(--zx-space-4);
+}
+
+.zx-activity-item__avatar {
+  position: relative;
+  z-index: 1;
+  display: flex;
+  align-items: start;
+}
+
+.zx-activity-item__main {
+  display: grid;
+  gap: var(--zx-space-2);
+  min-inline-size: 0;
+}
+
+.zx-activity-item__header {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: baseline;
+  justify-content: space-between;
+  gap: var(--zx-space-1) var(--zx-space-3);
+  min-inline-size: 0;
+}
+
+.zx-activity-item__heading {
+  display: flex;
+  flex-wrap: wrap;
+  gap: var(--zx-space-1);
+  min-inline-size: 0;
+  margin: 0;
+  font-size: var(--zx-text-md);
+  line-height: 1.45;
+  overflow-wrap: anywhere;
+}
+
+.zx-activity-item__actor {
+  font-weight: var(--zx-weight-semibold);
+}
+
+.zx-activity-item__title {
+  font-weight: 400;
+}
+
+/*
+ * The auto inline-start margin takes the header's free space before `justify-content` can
+ * distribute it, so the badge and the timestamp stay together on the trailing edge instead of
+ * being spread across the row as a third column.
+ */
+.zx-activity-item__state {
+  flex: none;
+  margin-inline-start: auto;
+  align-self: center;
+}
+
+.zx-activity-item__time {
+  flex: none;
+  color: var(--zx-color-text-muted);
+  font-size: var(--zx-text-xs);
+  white-space: nowrap;
+}
+
+.zx-activity-item__body {
+  min-inline-size: 0;
+  color: var(--zx-color-text);
+  line-height: 1.55;
+  overflow-wrap: anywhere;
+}
+
+.zx-activity-item__metadata {
+  display: flex;
+  flex-wrap: wrap;
+  gap: var(--zx-space-1) var(--zx-space-3);
+  margin: 0;
+  padding: 0;
+  color: var(--zx-color-text-muted);
+  font-size: var(--zx-text-sm);
+  list-style: none;
+}
+
+.zx-activity-item__metadata-item {
+  min-inline-size: 0;
+  overflow-wrap: anywhere;
+}
+
+.zx-activity-item__metadata-item:not(:last-child)::after {
+  content: "\00b7";
+  margin-inline-start: var(--zx-space-3);
+  color: var(--zx-color-text-placeholder);
+}
+
+.zx-activity-item__attachments {
+  display: grid;
+  gap: var(--zx-space-2);
+  min-inline-size: 0;
+}
+
+.zx-activity-item__attachments-item {
+  min-inline-size: 0;
+}
+
+.zx-activity-item__actions {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: var(--zx-space-1);
+}
+
+.zx-activity-item__action {
+  text-decoration: none;
+}
+
+@container (max-width: 30rem) {
+  .zx-activity-item__header {
+    display: grid;
+    justify-content: stretch;
+  }
+
+  /* Stacked, the header is one column, so the badge reads as its own line at the start edge. */
+  .zx-activity-item__state {
+    margin-inline-start: 0;
+    justify-self: start;
+  }
+}