@zeyos/zx 5.3.0 → 5.4.0
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.
- package/CHANGELOG.md +45 -0
- package/README.md +26 -0
- package/dist/zx.css +121 -64
- package/dist/zx.min.css +1 -1
- package/docs/llms.md +199 -10
- package/docs/llms.txt +19 -1
- package/package.json +1 -1
- package/src/components/message/message.css +6 -2
- package/styles/tokens/dark.css +28 -0
- package/styles/tokens/semantic.css +101 -59
package/docs/llms.md
CHANGED
|
@@ -3,7 +3,9 @@
|
|
|
3
3
|
> Xenon is a dependency-free design system for browser applications; Zx is its product-agnostic
|
|
4
4
|
> vanilla-JavaScript implementation. ES2022 modules, WAI-ARIA-accessible native controls, semantic `--zx-*` design
|
|
5
5
|
> tokens (light/dark, one token-driven geometry), and lifecycle-safe components. Zero runtime dependencies.
|
|
6
|
-
> This file is the single, complete reference a coding agent needs to build UI with Zx
|
|
6
|
+
> This file is the single, complete reference a coding agent needs to build UI with Zx. Read
|
|
7
|
+
> "Choosing what to build with" first: it maps every screen to a layout to start from, every job to
|
|
8
|
+
> its component, and lists the theme settings to decide. Each
|
|
7
9
|
> component below is wrapped in `<!-- doc:<name> -->` markers so tools can extract a single
|
|
8
10
|
> component's section (`website/docs.html` renders them as each component's Reference tab).
|
|
9
11
|
|
|
@@ -47,6 +49,178 @@ const t = new Table(target, options);
|
|
|
47
49
|
- Styles: load `/assets/zx.css` once.
|
|
48
50
|
- Build bundles with `npm run build` (esbuild). No build is needed to develop against `src/`.
|
|
49
51
|
|
|
52
|
+
## Choosing what to build with
|
|
53
|
+
|
|
54
|
+
Three decisions come before any code: which **layout** the screen is, which **component** does
|
|
55
|
+
each job, and which **theme settings** the application pins. The library already answers most of
|
|
56
|
+
them. A screen that invents its own shell, table, menu, or colour is the exception to justify,
|
|
57
|
+
never the default — it costs the accessibility, keyboard map, theming, and print behaviour the
|
|
58
|
+
standard parts already have.
|
|
59
|
+
|
|
60
|
+
### Start from a layout, not a blank page
|
|
61
|
+
|
|
62
|
+
Every layout in the gallery (<https://zx.zeyos.com/layouts>, `layouts.html#<id>` opens one,
|
|
63
|
+
`layout.html#<id>` shows it alone) is a complete, working screen on one shared application shell,
|
|
64
|
+
and its source is public: `https://zx.zeyos.com/layouts/<id>.layout.js` with `<id>.layout.css`
|
|
65
|
+
(in the repository, `website/layouts/`). Open the closest one, keep its anatomy — the columns,
|
|
66
|
+
the pane headers, the toolbar, the drawers, the states, the keyboard map — and change the data,
|
|
67
|
+
the fields, and the copy.
|
|
68
|
+
|
|
69
|
+
The helpers a layout imports are public too, and meant to be copied beside application code
|
|
70
|
+
(they are documentation-site modules, not package exports; import them relatively):
|
|
71
|
+
|
|
72
|
+
- `layouts/kit.js` + `kit.css` — the shell: `.shell` and its columns, `paneHeader()`,
|
|
73
|
+
`propList()`, `.list-row`, `.surface`, `suiteNav()` (module strip + module menu, with a
|
|
74
|
+
`workspace` switcher), `adaptiveShell()` (every column stays reachable at any width),
|
|
75
|
+
`shortcuts()` and `shortcutSheet()` (`?`), `toast()`, `loadChartJs()`.
|
|
76
|
+
- `layouts/overview.js` + `overview.css` — `createOverview()`: one toolbar over one record set
|
|
77
|
+
shown as table, list, cards, gallery, or board; search; filters as editable chips with a Filters
|
|
78
|
+
drawer; a View settings drawer; grouping, sorting, paging, selection and bulk actions; a base
|
|
79
|
+
filter for tabs and scopes; split empty states. The record collection, CRM, and issue tracker
|
|
80
|
+
are all this one composition.
|
|
81
|
+
|
|
82
|
+
Which layout a screen is:
|
|
83
|
+
|
|
84
|
+
| The screen | Start from | Not from |
|
|
85
|
+
| --- | --- | --- |
|
|
86
|
+
| A list of records of one type (companies, tickets, orders, files) | **Record collection** (`record-collection`) — the toolbar, chips, drawers and pager come with it | a bare `Table` under a heading |
|
|
87
|
+
| A list beside the record being edited | **Master–detail** (`master-detail`) | two unrelated panes |
|
|
88
|
+
| One record on its own page | **Record page** (`record-page`) | a form |
|
|
89
|
+
| Figures, charts, a period switch | **Dashboard** (`dashboard`) | cards of big numbers |
|
|
90
|
+
| Settings in sections | **Settings workspace** (`settings-workspace`) | one long form |
|
|
91
|
+
| Creating something in steps | **Record wizard** (`record-wizard`, vertical steps) or **Checkout wizard** (`checkout-wizard`, horizontal) | tabs |
|
|
92
|
+
| Conversations, triage | **Inbox** (`inbox`) or the **Mail** template | — |
|
|
93
|
+
| An assistant | **Agent chat** (`agent-chat`, one run with tools and approvals) or the **AI chat** template | a chat bubble list |
|
|
94
|
+
| Empty, loading, error, offline, confirmation | **System states** (`system-states`) — every screen needs these; copy them | ad-hoc messages |
|
|
95
|
+
| A whole application | the closest **template** below; they share one shell | a new shell |
|
|
96
|
+
|
|
97
|
+
Templates — complete applications with navigation, lists, records, and editors together:
|
|
98
|
+
|
|
99
|
+
| id | Screen | Use it for |
|
|
100
|
+
| --- | --- | --- |
|
|
101
|
+
| `mail` | Mail | a keyboard-first inbox: split streams, one-key triage, snooze, inline reply |
|
|
102
|
+
| `issue-tracker` | Issue tracker | work items grouped by status or on a board, chips, sub-items, activity, properties edited in place |
|
|
103
|
+
| `wiki` | Knowledge base | nested pages in spaces, a reading column with a live outline, comments, Markdown editing |
|
|
104
|
+
| `ai-chat` | AI chat | chat with an assistant: tool steps, sources, artifacts with versions, per-chat settings |
|
|
105
|
+
| `agent-workspace` | Agent workspace | a team of agents: roster with presence, plans and logs, approvals, a palette, a terminal |
|
|
106
|
+
| `invoice-editor` | Invoice editor | a document edited beside its live page, totals per rate, a send step that locks it |
|
|
107
|
+
| `item-inventory` | Item & inventory | one master-data record: levels per location, linked documents, tabbed settings, a log |
|
|
108
|
+
| `workflows` | Workflows | recurring processes as step flows: built, run, measured |
|
|
109
|
+
| `infrastructure` | Infrastructure | monitoring: health, alerts, traffic, drill-down to the unit |
|
|
110
|
+
| `crm` | CRM | companies, people, deals: editable collections with saved views, record pages, a stage board |
|
|
111
|
+
|
|
112
|
+
Patterns — single screens that recur in every application:
|
|
113
|
+
|
|
114
|
+
| id | Screen | What it shows |
|
|
115
|
+
| --- | --- | --- |
|
|
116
|
+
| `master-detail` | Master–detail | a filterable list beside the record being edited; save, revert, unsaved-change checks |
|
|
117
|
+
| `record-collection` | Record collection | one record type as table, list, cards, gallery, and board under one toolbar; filter chips and drawers |
|
|
118
|
+
| `dashboard` | Dashboard | figures, a chart, tabbed detail, one period switch redrawing all of it |
|
|
119
|
+
| `inbox` | Inbox | three panes: folders, conversations, the open thread with a reply |
|
|
120
|
+
| `record-page` | Record page | one record: summary header, tabs for lines, files and history, editable details |
|
|
121
|
+
| `agent-chat` | Agent chat | one agent run: plan, tool calls, an approval that holds it, a streamed answer with sources |
|
|
122
|
+
| `record-wizard` | Record wizard | creation in validated vertical steps with a running total and a review |
|
|
123
|
+
| `checkout-wizard` | Checkout wizard | a focused horizontal flow beside a live summary |
|
|
124
|
+
| `settings-workspace` | Settings workspace | personal settings in sections, saved together |
|
|
125
|
+
| `system-states` | System states | every empty, loading, error, and confirmation state, with an offline switch |
|
|
126
|
+
| `zeyos-invoices` | ZeyOS invoices | a table and a form generated from the ZeyOS schema, beside the ZeyOS module navigation |
|
|
127
|
+
|
|
128
|
+
Every application shares one shell: `AppSidebar` (or `ModuleBar` for the module level) with
|
|
129
|
+
`AccountMenu`, a `WorkspaceSwitcher` where users have several workspaces, a `Launcher` as the
|
|
130
|
+
command palette, `?` for the shortcut sheet, and `data-zx-theme` honoured throughout. Do not design
|
|
131
|
+
a second navigation.
|
|
132
|
+
|
|
133
|
+
### The component for the job
|
|
134
|
+
|
|
135
|
+
| Job | Use | Rather than |
|
|
136
|
+
| --- | --- | --- |
|
|
137
|
+
| Records the user scans, sorts, selects | `Table`; `TableView` when the same records also appear as cards or a board | a styled `<table>`, a list of `<div>`s |
|
|
138
|
+
| Records as cards or a gallery | `CardView` (`keyboard: 'roving'`, `groupBy`, `collapsibleGroups`) | `Card`s in a CSS grid |
|
|
139
|
+
| Records by stage, dragged between columns | `KanbanView` | — |
|
|
140
|
+
| One record set, several presentations, one state | `RecordView` family + `ListToolbar` + `ViewSettings` + `Pagination` — `createOverview()` wires them | three components with three states |
|
|
141
|
+
| The bar above a record view | `ListToolbar` (search, live count, view switch, badged tools) | a row of buttons |
|
|
142
|
+
| Sorting outside a header | `SortControl` | two selects |
|
|
143
|
+
| Paging | `Pagination` (`paginationRange()` for the numbers) | — |
|
|
144
|
+
| Filters, quick and client-side | `DataFilter` | — |
|
|
145
|
+
| Filters typed from a server's field metadata | `FilterPanel` (`mode: 'draft'|'live'`) | — |
|
|
146
|
+
| Filters the user composes, nested, serialisable | `Filter` (an AST; `parseFilterAst()`/`stringifyFilterAst()`) | — |
|
|
147
|
+
| A spreadsheet-like editable grid (lines, positions) | `Grid` (`Grid.BillingItems()`) | `Table` with `editMode` — that is for occasional cell edits |
|
|
148
|
+
| A tree | `TreeView` (one column) or `Finder` (Miller columns) | nested `<ul>`s |
|
|
149
|
+
| Events over time | `Calendar` (agenda, day, week, month, year) | — |
|
|
150
|
+
| One number with context | `StatTile` (delta, sparkline, loading) | a card with a big figure |
|
|
151
|
+
| A chart | `Chart` with `ChartJsAdapter` (Chart.js injected, never bundled) | — |
|
|
152
|
+
| A linked record inline | `EntityRef` | a link |
|
|
153
|
+
| Files | `FileItem` / `FileList`; uploading: `FieldUpload` | — |
|
|
154
|
+
| History, comments, a feed | `ActivityItem` / `ActivityList` | — |
|
|
155
|
+
| Choose one of many | `Select` (`filter: 'local'` or async for long lists; `Select.entity()` for records; `Select.priority()` / `Select.status()` presets); native radios for a handful of visible options | a custom dropdown |
|
|
156
|
+
| Choose many | `TagPicker` (identity, colour, icons), `Checklist` (a plain list) | — |
|
|
157
|
+
| On or off | `Toggle` (takes effect at once), `CheckButton` (a mode in a toolbar), a native checkbox inside a form | — |
|
|
158
|
+
| Search | `Search` | an input with an icon |
|
|
159
|
+
| Number, date, time, range | `NumberField`, `Datebox` / `DateTimeBox`, `Timebox`, `DateRangeBox`, `Slider`, `Rating` | plain inputs |
|
|
160
|
+
| A form | `Form` → `Fieldset` → `Field` (the type registry); `Questionnaire` for one question at a time | hand-laid inputs |
|
|
161
|
+
| Structured text, code | `CodeEditor` | a textarea |
|
|
162
|
+
| Repeating values | `ValueList`, `MultiValueEditor` | — |
|
|
163
|
+
| Confirm, alert, prompt | `Dialog.confirm()` / `Dialog.alert()` / `Dialog.prompt()` (Promises) | `window.confirm` |
|
|
164
|
+
| A task in a window | `Dialog` (header, footer, buttons); `Modal` is the bare surface | — |
|
|
165
|
+
| Edit without leaving the list | `Sheet` (`side: 'end'`); drill-down: `SheetStack`; a persistent pane: `Dock` | a dialog |
|
|
166
|
+
| Transient status | `Message.success()` / `.info()` / `.warning()` / `.error()` (toasts); inline `Message` for a region | an alert bar built by hand |
|
|
167
|
+
| Actions on a thing | `MenuButton`; `ContextMenu` (right-click and Shift+F10; one instance per table via `selector`) | a floating `<div>` |
|
|
168
|
+
| Anchored content, hints | `Dropdown`; `tooltip()` / `describe()` | `title` attributes alone |
|
|
169
|
+
| A row of actions | `Toolbar` (overflow menu, one Tab stop) | a flex row of buttons |
|
|
170
|
+
| Navigation | `AppSidebar` (tree, sections, `layout: 'modules'`), `ModuleBar`, `NavigationBar`, `Tabbox` (in-page), `Breadcrumb` (where am I), `Stepper` (a sequence) | — |
|
|
171
|
+
| Commands by keyboard | `Launcher` | — |
|
|
172
|
+
| Account and workspace | `AccountMenu`, `WorkspaceSwitcher` | — |
|
|
173
|
+
| Grouping content | `Card`, `Panel` (actions in the header or footer), `Groupbox`, `MasterPanel`, `SplitView`, `stack()` / `grid()` / `aspect()` | ad-hoc wrappers |
|
|
174
|
+
| Identity and status marks | `Avatar`, `AppIcon`, `badge()` (`kind` says how it is doing, `tone` what it is) | coloured spans |
|
|
175
|
+
| Nothing yet, loading, failed | `emptyState()`, `skeleton()` / `skeletonText()` / `skeletonTable()`, `InlineLoading`, `spinner()`, `ProgressBar` | a blank area |
|
|
176
|
+
| Ambient colour behind a hero, a login, a launcher | `Aurora` | CSS gradients |
|
|
177
|
+
| Icons | `icon(name)` — the bundled set or Font Awesome, whichever the application opted into | inline SVG |
|
|
178
|
+
|
|
179
|
+
### Theming decisions
|
|
180
|
+
|
|
181
|
+
Decide these once per application, in this order, and express each as the attribute or token
|
|
182
|
+
the library already reads — never as component CSS:
|
|
183
|
+
|
|
184
|
+
1. **Theme** — `data-zx-theme="auto"` unless the product pins `light` or `dark`. Both must work; a
|
|
185
|
+
region may differ from the page.
|
|
186
|
+
2. **Accent** — a preset (`data-zx-preset="zx|zeyos|ocean|violet|rose|slate"`) or a five-stop
|
|
187
|
+
`--zx-accent-300…700` ramp built in the theme studio (<https://zx.zeyos.com/theme.html>), which
|
|
188
|
+
exports the CSS. Never a one-off colour on a button.
|
|
189
|
+
3. **Geometry** — the rhythm is three tokens on `:root` (or on a dense region): `--zx-space-unit`,
|
|
190
|
+
`--zx-control-height`, `--zx-radius`. Dense data tools sit around 3.5px / 28px; comfortable
|
|
191
|
+
products around 4.5px / 32–34px. Never a per-component size.
|
|
192
|
+
4. **Material** — how surfaces answer light, exported from the studio as token overrides (there
|
|
193
|
+
is no attribute). `Glass` (the default: a thin lit pane), `Deep glass` (a thick one), `Frost`
|
|
194
|
+
(milk glass for reading surfaces), `Smoke` (tinted glass that darkens the scene; dark-first
|
|
195
|
+
products), `Paper`, `Satin` and `Enamel` (opaque: matte, brushed or glazed; no blur, so they
|
|
196
|
+
render cheaply and never depend on what is behind them), or `Flat`. `Aurora` supplies the light glass responds to. Reduced-transparency,
|
|
197
|
+
high-contrast, forced-colour and unsupported-filter environments fall back to solid surfaces on
|
|
198
|
+
their own.
|
|
199
|
+
5. **Motion** — `data-zx-motion="reduced"` is the only switch; own transitions use `--zx-dur-*`,
|
|
200
|
+
`--zx-ease`, `--zx-ease-spring`, `--zx-ease-drawer`.
|
|
201
|
+
6. **Colour roles** — `--zx-color-tone-*` for categories (tags, modules, avatars),
|
|
202
|
+
`--zx-color-danger|warning|success|info` for status, `--zx-color-bg-current` for "you are here"
|
|
203
|
+
and `--zx-color-bg-selected` for "what you picked", `--zx-color-bg-chrome` for navigation and
|
|
204
|
+
inspector columns. A module's colour is its `tone` on `ModuleBar`.
|
|
205
|
+
7. **Type** — `--zx-font-sans`, `--zx-font-mono`, `--zx-text-md` (the control size); the steps
|
|
206
|
+
follow.
|
|
207
|
+
8. **Fields** — `data-zx-fields="quiet"` on property panels (no border or fill until hovered or
|
|
208
|
+
focused).
|
|
209
|
+
9. **Print** — works without work; keep status badges, hide chrome. Nothing to add.
|
|
210
|
+
10. **Markup-first pages** — `defineElements()` for `<zx-*>` custom elements where templates are
|
|
211
|
+
authored as HTML.
|
|
212
|
+
|
|
213
|
+
### Never
|
|
214
|
+
|
|
215
|
+
- No raw colours (`#hex`, `rgb()`, named), no tier-1 tokens (`--zx-gray-*`, `--zx-emerald-*`,
|
|
216
|
+
`--zx-tone-*`), no hard-coded sizes the geometry tokens cover.
|
|
217
|
+
- No application CSS on component internals (`.zx-<component>__<part>` selectors); override a
|
|
218
|
+
token, or use a published hook.
|
|
219
|
+
- No hand-built dropdowns, menus, dialogs, tooltips, tables, date pickers, or toasts.
|
|
220
|
+
- No `innerHTML` with data; `h()` and text nodes.
|
|
221
|
+
- No state classes; state is ARIA and `data-state`, which the stylesheets already match.
|
|
222
|
+
- No second shell, second navigation, or second keyboard convention inside one application.
|
|
223
|
+
|
|
50
224
|
## Theming
|
|
51
225
|
|
|
52
226
|
Load `zx.css`, then set the theme on any ancestor (usually `<html>`):
|
|
@@ -90,16 +264,31 @@ Keep the 600 stop at 4.5:1 or better against white and the 400 stop at 4.5:1 aga
|
|
|
90
264
|
|
|
91
265
|
The theme studio treats those stable IDs as complete recipes: selecting a preset also changes its
|
|
92
266
|
spacing unit, neutral tint, radius, control height, base text size, font stack, and material strength.
|
|
93
|
-
Its **Material** control is CSS-first
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
267
|
+
Its **Material** control is CSS-first: eight materials, each a set of token overrides (there is no
|
|
268
|
+
attribute), composed from six per-theme *ingredients* the stylesheet declares —
|
|
269
|
+
`--zx-color-glass-rim` and `-ring` (the lit top edge and the hairline inner ring), `-lift` (white
|
|
270
|
+
laid on a pane from its top edge, which makes it read as lit rather than tinted), `-shade` (the
|
|
271
|
+
pane's own body: a veil over the scene, white in light and black in dark, that bounds what the
|
|
272
|
+
scene can do to text contrast), `-edge` (the cut outer line a pane needs against a dark scene) and
|
|
273
|
+
`-tint` (smoked glass) — plus `--zx-glass-grain`, a faint grey tooth. One recipe therefore
|
|
274
|
+
serves light and dark alike. **Glass**, the stylesheet default, is a thin lit pane: its light sits
|
|
275
|
+
on the edge, never as a wash on its face, and the filter saturates so colour behind survives the
|
|
276
|
+
blur. **Deep glass** is a thick pane — a double rim with an inner glow, one narrow specular band,
|
|
277
|
+
more refraction, a fine grain. **Frost** is milk glass: heavy diffusion, almost no reflection, text
|
|
278
|
+
as on paper. **Smoke** is tinted glass that darkens what is behind it (sunglass glass in dark).
|
|
279
|
+
**Paper** is opaque and matte, depth from a contact shadow and a modest cast; **Satin** is opaque
|
|
280
|
+
and brushed, a soft sheen across raised surfaces and a bright rim on controls; **Enamel** is an
|
|
281
|
+
opaque body under a glossy coat, a narrow highlight along the top edge and a darker foot, for
|
|
282
|
+
terminals and consoles where text backing must be certain. None of the three filters anything,
|
|
283
|
+
so they render cheaply and survive every fallback unchanged. **Flat** is the opaque semantic
|
|
284
|
+
surfaces. Aurora is
|
|
285
|
+
the independent ambient canvas layer; material is how surfaces respond to that light. The shared
|
|
286
|
+
recipe applies to AppIcons, ordinary controls, persistent chrome, raised cards, and every transient
|
|
287
|
+
overlay: Dropdown, ContextMenu, MenuButton, AccountMenu, AppRail flyouts, Select, TagPicker, date
|
|
288
|
+
pickers, tooltips, column menus, and toasts use `--zx-color-overlay-surface`; Launcher, Modal,
|
|
289
|
+
Dialog, and overlay Sheets use the calmer `--zx-color-overlay-panel`. The modal backdrop is a
|
|
100
290
|
separate material token so it does not erase the light the panel should refract. A docked Sheet is
|
|
101
|
-
layout rather than an overlay and becomes opaque, as do dense data surfaces.
|
|
102
|
-
progressively raise translucency, blur, highlights, and elevation; reduced-transparency,
|
|
291
|
+
layout rather than an overlay and becomes opaque, as do dense data surfaces. Reduced-transparency,
|
|
103
292
|
increased-contrast, forced-colour, and unsupported-filter environments restore solid surfaces.
|
|
104
293
|
Top-layer components remain DOM children of their nearest Zx theme scope, so a theme or material
|
|
105
294
|
set on an application region continues to inherit through its menus, dialogs, tooltips, and toasts.
|
package/docs/llms.txt
CHANGED
|
@@ -18,6 +18,24 @@ exports and as `window.zx.*`.
|
|
|
18
18
|
- [API reference](llms.md): per-component constructor options, methods, and events for all public components plus the core helpers.
|
|
19
19
|
- [Changelog](../CHANGELOG.md): what changed in each release, including behaviour changes an upgrade has to account for.
|
|
20
20
|
|
|
21
|
+
## Start here: choosing
|
|
22
|
+
- Start every screen from the closest **layout**, never from a blank page. Gallery:
|
|
23
|
+
https://zx.zeyos.com/layouts (`layouts.html#<id>` opens one); source
|
|
24
|
+
`https://zx.zeyos.com/layouts/<id>.layout.js` + `<id>.layout.css`; the shell helpers
|
|
25
|
+
`layouts/kit.js` + `kit.css`, and `layouts/overview.js` + `overview.css` (`createOverview()`,
|
|
26
|
+
the toolbar-chips-drawers-pager composition every record screen uses). They are site modules,
|
|
27
|
+
not package exports: copy them beside the application.
|
|
28
|
+
- Templates (complete applications on one shell): `mail`, `issue-tracker`, `wiki`, `ai-chat`,
|
|
29
|
+
`agent-workspace`, `invoice-editor`, `item-inventory`, `workflows`, `infrastructure`, `crm`.
|
|
30
|
+
Patterns (single screens): `master-detail`, `record-collection` (any list of records),
|
|
31
|
+
`dashboard`, `inbox`, `record-page`, `agent-chat`, `record-wizard`, `checkout-wizard`,
|
|
32
|
+
`settings-workspace`, `system-states` (every empty, loading, error, and confirmation state),
|
|
33
|
+
`zeyos-invoices`.
|
|
34
|
+
- The agent reference's **"Choosing what to build with"** section maps each screen to its layout
|
|
35
|
+
and each job to its component, lists the theming decisions (theme, accent preset, geometry
|
|
36
|
+
tokens, material, motion, colour roles), and what never to build by hand. Read it before
|
|
37
|
+
building anything.
|
|
38
|
+
|
|
21
39
|
## Components
|
|
22
40
|
- Inputs: `button()`, `buttonGroup()`, `badge()`/`badgeGroup()`, `CheckButton`,
|
|
23
41
|
`Toggle`, `Search`,
|
|
@@ -60,7 +78,7 @@ exports and as `window.zx.*`.
|
|
|
60
78
|
- 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).
|
|
61
79
|
|
|
62
80
|
## Theming
|
|
63
|
-
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
|
|
81
|
+
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 the CSS-first material: Glass (the default, a thin lit pane), Deep glass, Frost (milk glass), Smoke (tinted), Paper, Satin and Enamel (opaque, no blur), or Flat — each a token-override recipe composed from the theme's glass ingredients (`--zx-color-glass-rim/-ring/-lift/-shade/-edge/-tint`). 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.
|
|
64
82
|
|
|
65
83
|
## Talking to ZeyOS
|
|
66
84
|
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
CHANGED
|
@@ -78,7 +78,11 @@
|
|
|
78
78
|
.zx-message__toast {
|
|
79
79
|
border-color: color-mix(in srgb, var(--zx-message-kind) 28%, var(--zx-color-overlay-border));
|
|
80
80
|
background-color: var(--zx-color-overlay-surface);
|
|
81
|
-
|
|
81
|
+
/* The status tint is composed here, not in the token: a token resolves where it is declared,
|
|
82
|
+
so a tint written into it at the theme root would be the info colour for every kind. */
|
|
83
|
+
background-image: radial-gradient(120% 160% at 0% 0%,
|
|
84
|
+
color-mix(in srgb, var(--zx-message-kind) 16%, transparent), transparent 62%),
|
|
85
|
+
var(--zx-overlay-toast-image);
|
|
82
86
|
background-clip: padding-box;
|
|
83
87
|
-webkit-backdrop-filter: var(--zx-glass-filter-overlay);
|
|
84
88
|
backdrop-filter: var(--zx-glass-filter-overlay);
|
|
@@ -87,7 +91,7 @@
|
|
|
87
91
|
}
|
|
88
92
|
}
|
|
89
93
|
|
|
90
|
-
@media (prefers-reduced-transparency: reduce) {
|
|
94
|
+
@media (prefers-reduced-transparency: reduce), (prefers-contrast: more) {
|
|
91
95
|
.zx-message__toast {
|
|
92
96
|
border-color: var(--zx-color-border);
|
|
93
97
|
background: var(--zx-message-fallback-bg);
|
package/styles/tokens/dark.css
CHANGED
|
@@ -35,6 +35,20 @@
|
|
|
35
35
|
--zx-color-bg-backdrop: color-mix(in srgb, var(--zx-gray-950) 75%, transparent);
|
|
36
36
|
--zx-color-overlay-base: color-mix(in srgb, var(--zx-gray-800) 60%, var(--zx-gray-700));
|
|
37
37
|
--zx-color-overlay-backdrop: color-mix(in srgb, var(--zx-gray-950) 38%, transparent);
|
|
38
|
+
/* The pane ingredients, restated for a dark scene: a quieter rim and ring, a thin lift, a shade
|
|
39
|
+
that darkens what is behind the pane so text on it keeps its contrast, a cut outer edge, and a
|
|
40
|
+
deep smoked tint. */
|
|
41
|
+
--zx-color-glass-border: color-mix(in srgb, var(--zx-gray-0) 14%, transparent);
|
|
42
|
+
--zx-color-glass-rim: color-mix(in srgb, var(--zx-gray-0) 24%, transparent);
|
|
43
|
+
--zx-color-glass-ring: color-mix(in srgb, var(--zx-gray-0) 7%, transparent);
|
|
44
|
+
--zx-color-glass-lift: color-mix(in srgb, var(--zx-gray-0) 10%, transparent);
|
|
45
|
+
--zx-color-glass-shade: color-mix(in srgb, var(--zx-gray-950) 20%, transparent);
|
|
46
|
+
--zx-color-glass-edge: color-mix(in srgb, var(--zx-gray-950) 45%, transparent);
|
|
47
|
+
--zx-color-glass-tint: color-mix(in srgb, var(--zx-gray-950) 38%, transparent);
|
|
48
|
+
--zx-color-glass-control: color-mix(in srgb, var(--zx-gray-0) 7%, transparent);
|
|
49
|
+
--zx-color-glass-control-hover: color-mix(in srgb, var(--zx-gray-0) 12%, transparent);
|
|
50
|
+
--zx-glass-control-shadow: inset 0 1px 0 color-mix(in srgb, var(--zx-gray-0) 14%, transparent), 0 1px 2px color-mix(in srgb, var(--zx-gray-950) 30%, transparent);
|
|
51
|
+
--zx-glass-chrome-shadow: inset -1px 0 0 color-mix(in srgb, var(--zx-gray-0) 6%, transparent), inset 0 1px 0 color-mix(in srgb, var(--zx-gray-0) 10%, transparent);
|
|
38
52
|
--zx-color-border: color-mix(in srgb, var(--zx-gray-0) 9%, transparent);
|
|
39
53
|
--zx-color-border-subtle: color-mix(in srgb, var(--zx-gray-0) 6%, transparent);
|
|
40
54
|
--zx-color-border-strong: color-mix(in srgb, var(--zx-gray-0) 24%, transparent);
|
|
@@ -113,6 +127,20 @@
|
|
|
113
127
|
--zx-color-bg-backdrop: color-mix(in srgb, var(--zx-gray-950) 75%, transparent);
|
|
114
128
|
--zx-color-overlay-base: color-mix(in srgb, var(--zx-gray-800) 60%, var(--zx-gray-700));
|
|
115
129
|
--zx-color-overlay-backdrop: color-mix(in srgb, var(--zx-gray-950) 38%, transparent);
|
|
130
|
+
/* The pane ingredients, restated for a dark scene: a quieter rim and ring, a thin lift, a shade
|
|
131
|
+
that darkens what is behind the pane so text on it keeps its contrast, a cut outer edge, and a
|
|
132
|
+
deep smoked tint. */
|
|
133
|
+
--zx-color-glass-border: color-mix(in srgb, var(--zx-gray-0) 14%, transparent);
|
|
134
|
+
--zx-color-glass-rim: color-mix(in srgb, var(--zx-gray-0) 24%, transparent);
|
|
135
|
+
--zx-color-glass-ring: color-mix(in srgb, var(--zx-gray-0) 7%, transparent);
|
|
136
|
+
--zx-color-glass-lift: color-mix(in srgb, var(--zx-gray-0) 10%, transparent);
|
|
137
|
+
--zx-color-glass-shade: color-mix(in srgb, var(--zx-gray-950) 20%, transparent);
|
|
138
|
+
--zx-color-glass-edge: color-mix(in srgb, var(--zx-gray-950) 45%, transparent);
|
|
139
|
+
--zx-color-glass-tint: color-mix(in srgb, var(--zx-gray-950) 38%, transparent);
|
|
140
|
+
--zx-color-glass-control: color-mix(in srgb, var(--zx-gray-0) 7%, transparent);
|
|
141
|
+
--zx-color-glass-control-hover: color-mix(in srgb, var(--zx-gray-0) 12%, transparent);
|
|
142
|
+
--zx-glass-control-shadow: inset 0 1px 0 color-mix(in srgb, var(--zx-gray-0) 14%, transparent), 0 1px 2px color-mix(in srgb, var(--zx-gray-950) 30%, transparent);
|
|
143
|
+
--zx-glass-chrome-shadow: inset -1px 0 0 color-mix(in srgb, var(--zx-gray-0) 6%, transparent), inset 0 1px 0 color-mix(in srgb, var(--zx-gray-0) 10%, transparent);
|
|
116
144
|
--zx-color-border: color-mix(in srgb, var(--zx-gray-0) 9%, transparent);
|
|
117
145
|
--zx-color-border-subtle: color-mix(in srgb, var(--zx-gray-0) 6%, transparent);
|
|
118
146
|
--zx-color-border-strong: color-mix(in srgb, var(--zx-gray-0) 24%, transparent);
|
|
@@ -37,16 +37,23 @@
|
|
|
37
37
|
--zx-app-icon-halo-size: 14px;
|
|
38
38
|
--zx-app-icon-halo-strength: 22%;
|
|
39
39
|
--zx-overlay-specular-strength: 48%;
|
|
40
|
-
--zx-glass-blur:
|
|
41
|
-
--zx-glass-saturation:
|
|
40
|
+
--zx-glass-blur: 10px;
|
|
41
|
+
--zx-glass-saturation: 140%;
|
|
42
42
|
--zx-glass-color-strength: 82%;
|
|
43
|
-
/* Material filters are roles, not component recipes. Aurora remains a separate canvas layer.
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
--zx-glass-filter-
|
|
48
|
-
--zx-glass-filter-
|
|
49
|
-
--zx-glass-filter-
|
|
43
|
+
/* Material filters are roles, not component recipes. Aurora remains a separate canvas layer.
|
|
44
|
+
Saturation keeps the colour behind a pane alive through the blur; the pane's own lightness is
|
|
45
|
+
a colour role (the lift and shade ingredients below), so the filters are the same in both
|
|
46
|
+
themes. */
|
|
47
|
+
--zx-glass-filter-icon: blur(6px) saturate(135%);
|
|
48
|
+
--zx-glass-filter-control: blur(8px) saturate(130%);
|
|
49
|
+
--zx-glass-filter-raised: blur(14px) saturate(145%);
|
|
50
|
+
--zx-glass-filter-chrome: blur(16px) saturate(140%);
|
|
51
|
+
--zx-glass-filter-overlay: blur(20px) saturate(165%);
|
|
52
|
+
--zx-glass-filter-panel: blur(24px) saturate(150%);
|
|
53
|
+
/* A fine grey tooth for frosted and paper surfaces: mid-grey noise in sRGB at 3% alpha, one
|
|
54
|
+
octave, no colour. It is a texture, not a dither: too faint to hide banding, faint enough not
|
|
55
|
+
to veil a dark pane. */
|
|
56
|
+
--zx-glass-grain: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='180' height='180'%3E%3Cfilter id='n' color-interpolation-filters='sRGB'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.85' numOctaves='1' stitchTiles='stitch'/%3E%3CfeColorMatrix values='0 0 0 0 0.5 0 0 0 0 0.5 0 0 0 0 0.5 0 0 0 0.03 0'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23n)'/%3E%3C/svg%3E");
|
|
50
57
|
}
|
|
51
58
|
|
|
52
59
|
/* The light theme — colours only. */
|
|
@@ -138,12 +145,26 @@
|
|
|
138
145
|
shadow and a wide soft one, clearly higher than a resting card and lower than an overlay. */
|
|
139
146
|
--zx-drag-shadow: 0 2px 4px -1px color-mix(in srgb, var(--zx-gray-950) 10%, transparent),
|
|
140
147
|
0 12px 28px -6px color-mix(in srgb, var(--zx-gray-950) 22%, transparent);
|
|
141
|
-
--zx-color-glass-border: color-mix(in srgb, var(--zx-gray-0)
|
|
148
|
+
--zx-color-glass-border: color-mix(in srgb, var(--zx-gray-0) 70%, transparent);
|
|
149
|
+
/* AppIcon's rim and specular read these two; the pane ingredients below are separate. */
|
|
142
150
|
--zx-color-glass-highlight: color-mix(in srgb, var(--zx-gray-0) 24%, transparent);
|
|
143
151
|
--zx-color-glass-highlight-strong: color-mix(in srgb, var(--zx-gray-0) 38%, transparent);
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
152
|
+
/* A pane of glass, in six ingredients the material recipes compose and the dark theme restates:
|
|
153
|
+
the lit top edge (rim) and the hairline inner ring; the lift — white laid on the pane from
|
|
154
|
+
the top edge, which is what makes it read as lit rather than tinted; the shade — the pane's
|
|
155
|
+
own body, a veil over the scene that bounds text contrast; the cut outer edge a pane needs
|
|
156
|
+
against a dark scene (nothing in light); and the tint of smoked glass. */
|
|
157
|
+
--zx-color-glass-rim: color-mix(in srgb, var(--zx-gray-0) 95%, transparent);
|
|
158
|
+
--zx-color-glass-ring: color-mix(in srgb, var(--zx-gray-0) 45%, transparent);
|
|
159
|
+
--zx-color-glass-lift: color-mix(in srgb, var(--zx-gray-0) 62%, transparent);
|
|
160
|
+
/* The shade is the pane's own body: a flat veil painted over the base colour and under the
|
|
161
|
+
lift, which bounds what the scene can do to text contrast. White in light, black in dark. */
|
|
162
|
+
--zx-color-glass-shade: color-mix(in srgb, var(--zx-gray-0) 22%, transparent);
|
|
163
|
+
--zx-color-glass-edge: transparent;
|
|
164
|
+
--zx-color-glass-tint: color-mix(in srgb, var(--zx-gray-950) 12%, transparent);
|
|
165
|
+
--zx-color-overlay-backdrop: color-mix(in srgb, var(--zx-gray-950) 22%, transparent);
|
|
166
|
+
--zx-glass-control-shadow: inset 0 1px 0 color-mix(in srgb, var(--zx-gray-0) 80%, transparent), 0 1px 2px color-mix(in srgb, var(--zx-gray-950) 6%, transparent);
|
|
167
|
+
--zx-glass-chrome-shadow: inset -1px 0 0 color-mix(in srgb, var(--zx-gray-0) 60%, transparent), inset 0 1px 0 color-mix(in srgb, var(--zx-gray-0) 80%, transparent);
|
|
147
168
|
--zx-header-bg: var(--zx-gray-900);
|
|
148
169
|
--zx-header-text: var(--zx-gray-50);
|
|
149
170
|
}
|
|
@@ -181,41 +202,69 @@
|
|
|
181
202
|
--zx-focus-ring: 0 0 0 3px color-mix(in srgb, var(--zx-color-ring) 45%, transparent);
|
|
182
203
|
--zx-color-app-icon-depth: color-mix(in srgb, var(--zx-color-app-icon-shade) 26%, transparent);
|
|
183
204
|
--zx-app-icon-rim-base: var(--zx-color-glass-highlight);
|
|
184
|
-
--zx-color-glass-surface: color-mix(in srgb, var(--zx-color-bg-raised)
|
|
205
|
+
--zx-color-glass-surface: color-mix(in srgb, var(--zx-color-bg-raised) 58%, transparent);
|
|
185
206
|
/* Persistent application chrome is quieter and more opaque than a raised feature card. */
|
|
186
|
-
--zx-color-glass-chrome: color-mix(in srgb, var(--zx-color-bg-surface)
|
|
187
|
-
--zx-color-glass-control: color-mix(in srgb, var(--zx-color-bg-control)
|
|
188
|
-
--zx-color-glass-control-hover: color-mix(in srgb, var(--zx-color-bg-hover)
|
|
189
|
-
/* Overlay glass is
|
|
190
|
-
|
|
191
|
-
|
|
207
|
+
--zx-color-glass-chrome: color-mix(in srgb, var(--zx-color-bg-surface) 76%, transparent);
|
|
208
|
+
--zx-color-glass-control: color-mix(in srgb, var(--zx-color-bg-control) 66%, transparent);
|
|
209
|
+
--zx-color-glass-control-hover: color-mix(in srgb, var(--zx-color-bg-hover) 60%, var(--zx-color-glass-surface));
|
|
210
|
+
/* Overlay glass is a thin neutral base, the shade (the pane's body) painted over it, a short
|
|
211
|
+
lift from the top edge, a faint accent caustic at the far corner, and the backdrop behind
|
|
212
|
+
modal panels.
|
|
213
|
+
The pane's light sits on its edge — the rim and ring in the shadows — never as a wash on its
|
|
214
|
+
face.
|
|
215
|
+
Keeping the roles separate makes the material visibly react to Aurora/content without baking
|
|
216
|
+
decoration into each component. */
|
|
192
217
|
--zx-color-overlay-base: var(--zx-color-bg-raised);
|
|
193
|
-
--zx-color-overlay-surface: color-mix(in srgb, var(--zx-color-overlay-base)
|
|
194
|
-
--zx-color-overlay-panel: color-mix(in srgb, var(--zx-color-overlay-base)
|
|
195
|
-
--zx-color-overlay-border: color-mix(in srgb, var(--zx-color-text)
|
|
218
|
+
--zx-color-overlay-surface: color-mix(in srgb, var(--zx-color-overlay-base) 58%, transparent);
|
|
219
|
+
--zx-color-overlay-panel: color-mix(in srgb, var(--zx-color-overlay-base) 64%, transparent);
|
|
220
|
+
--zx-color-overlay-border: color-mix(in srgb, var(--zx-color-text) 12%, transparent);
|
|
196
221
|
--zx-color-overlay-hover: color-mix(in srgb, var(--zx-color-text) 8%, transparent);
|
|
197
222
|
--zx-color-overlay-selected: color-mix(in srgb, var(--zx-color-accent) 18%, transparent);
|
|
198
223
|
--zx-color-overlay-divider: color-mix(in srgb, var(--zx-color-text) 11%, transparent);
|
|
199
224
|
--zx-color-overlay-scrim: color-mix(in srgb, var(--zx-color-overlay-base) 28%, transparent);
|
|
200
|
-
--zx-overlay-surface-image: linear-gradient(
|
|
201
|
-
color-mix(in srgb, var(--zx-color-glass-
|
|
202
|
-
color-mix(in srgb, var(--zx-color-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
--zx-overlay-toast-image:
|
|
206
|
-
|
|
207
|
-
var(--zx-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
transparent 58%), radial-gradient(100% 70% at 100% 0%,
|
|
211
|
-
color-mix(in srgb, var(--zx-color-accent) 5%, transparent), transparent 64%),
|
|
212
|
-
linear-gradient(180deg, color-mix(in srgb, var(--zx-color-glass-highlight) 16%, transparent) 0%,
|
|
213
|
-
transparent 28%);
|
|
225
|
+
--zx-overlay-surface-image: linear-gradient(180deg, var(--zx-color-glass-lift) 0%,
|
|
226
|
+
color-mix(in srgb, var(--zx-color-glass-lift) 15%, transparent) 18%, transparent 45%),
|
|
227
|
+
radial-gradient(120% 70% at 100% 100%, color-mix(in srgb, var(--zx-color-accent) 4%, transparent), transparent 62%),
|
|
228
|
+
linear-gradient(var(--zx-color-glass-shade), var(--zx-color-glass-shade));
|
|
229
|
+
/* A toast adds its status tint itself, over this, so the kind set on the element reaches it. */
|
|
230
|
+
--zx-overlay-toast-image: var(--zx-overlay-surface-image);
|
|
231
|
+
--zx-overlay-panel-image: linear-gradient(180deg, var(--zx-color-glass-lift) 0%,
|
|
232
|
+
color-mix(in srgb, var(--zx-color-glass-lift) 15%, transparent) 16%, transparent 40%),
|
|
233
|
+
radial-gradient(90% 60% at 100% 100%, color-mix(in srgb, var(--zx-color-accent) 4%, transparent), transparent 60%),
|
|
234
|
+
linear-gradient(var(--zx-color-glass-shade), var(--zx-color-glass-shade));
|
|
214
235
|
--zx-app-icon-shadow: inset 0 1px 0 color-mix(in srgb, var(--zx-gray-0) 14%, transparent), inset 0 -1px 0 color-mix(in srgb, var(--zx-gray-950) 28%, transparent), 0 2px 6px color-mix(in srgb, var(--zx-color-app-icon-shade) 24%, transparent);
|
|
215
236
|
--zx-app-icon-shadow-hover: inset 0 1px 0 color-mix(in srgb, var(--zx-gray-0) 20%, transparent), inset 0 -1px 0 color-mix(in srgb, var(--zx-gray-950) 32%, transparent), 0 4px 10px color-mix(in srgb, var(--zx-color-app-icon-shade) 30%, transparent);
|
|
216
|
-
--zx-glass-raised-shadow: inset 0 1px 0 color-mix(in srgb, var(--zx-
|
|
217
|
-
--zx-glass-overlay-shadow: inset 0 1px 0 color-
|
|
218
|
-
--zx-glass-panel-shadow: inset 0 1px 0 color-mix(in srgb, var(--zx-color-glass-
|
|
237
|
+
--zx-glass-raised-shadow: inset 0 1px 0 var(--zx-color-glass-rim), inset 0 0 0 1px color-mix(in srgb, var(--zx-color-glass-ring) 90%, transparent), 0 0 0 1px var(--zx-color-glass-edge), 0 1px 2px color-mix(in srgb, var(--zx-gray-950) 5%, transparent), 0 10px 28px -10px color-mix(in srgb, var(--zx-gray-950) 14%, transparent);
|
|
238
|
+
--zx-glass-overlay-shadow: inset 0 1px 0 var(--zx-color-glass-rim), inset 0 0 0 1px var(--zx-color-glass-ring), 0 0 0 1px var(--zx-color-glass-edge), 0 1px 2px color-mix(in srgb, var(--zx-gray-950) 6%, transparent), var(--zx-overlay-shadow);
|
|
239
|
+
--zx-glass-panel-shadow: inset 0 1px 0 var(--zx-color-glass-rim), inset 0 0 0 1px color-mix(in srgb, var(--zx-color-glass-ring) 90%, transparent), 0 0 0 1px var(--zx-color-glass-edge), 0 2px 4px color-mix(in srgb, var(--zx-gray-950) 6%, transparent), var(--zx-overlay-shadow);
|
|
240
|
+
}
|
|
241
|
+
|
|
242
|
+
/* Browsers without backdrop filtering get an intentionally opaque material instead of a washed
|
|
243
|
+
translucent colour. This is a capability fallback, independent of user preference fallbacks,
|
|
244
|
+
and it comes first so that a preference below still wins where both apply. */
|
|
245
|
+
@supports not ((backdrop-filter: blur(1px)) or (-webkit-backdrop-filter: blur(1px))) {
|
|
246
|
+
:root,
|
|
247
|
+
.zx-scope,
|
|
248
|
+
[data-zx-theme],
|
|
249
|
+
[data-zx-preset] {
|
|
250
|
+
--zx-color-glass-surface: var(--zx-color-bg-raised) !important;
|
|
251
|
+
--zx-color-glass-chrome: var(--zx-color-bg-surface) !important;
|
|
252
|
+
--zx-color-glass-control: var(--zx-color-bg-control) !important;
|
|
253
|
+
--zx-color-glass-control-hover: var(--zx-color-bg-hover) !important;
|
|
254
|
+
--zx-color-overlay-surface: var(--zx-color-bg-raised) !important;
|
|
255
|
+
--zx-color-overlay-panel: var(--zx-color-bg-raised) !important;
|
|
256
|
+
--zx-color-overlay-backdrop: var(--zx-color-bg-backdrop) !important;
|
|
257
|
+
--zx-overlay-specular-strength: 0% !important;
|
|
258
|
+
--zx-overlay-surface-image: none !important;
|
|
259
|
+
--zx-overlay-toast-image: none !important;
|
|
260
|
+
--zx-overlay-panel-image: none !important;
|
|
261
|
+
--zx-glass-filter-icon: none !important;
|
|
262
|
+
--zx-glass-filter-control: none !important;
|
|
263
|
+
--zx-glass-filter-raised: none !important;
|
|
264
|
+
--zx-glass-filter-chrome: none !important;
|
|
265
|
+
--zx-glass-filter-overlay: none !important;
|
|
266
|
+
--zx-glass-filter-panel: none !important;
|
|
267
|
+
}
|
|
219
268
|
}
|
|
220
269
|
|
|
221
270
|
/* Preferences are resolved at the token seam so every material consumer, including application
|
|
@@ -240,6 +289,12 @@
|
|
|
240
289
|
--zx-overlay-surface-image: none !important;
|
|
241
290
|
--zx-overlay-toast-image: none !important;
|
|
242
291
|
--zx-overlay-panel-image: none !important;
|
|
292
|
+
--zx-color-glass-rim: transparent !important;
|
|
293
|
+
--zx-color-glass-ring: transparent !important;
|
|
294
|
+
--zx-color-glass-lift: transparent !important;
|
|
295
|
+
--zx-color-glass-shade: transparent !important;
|
|
296
|
+
--zx-color-glass-edge: transparent !important;
|
|
297
|
+
--zx-color-glass-tint: var(--zx-color-bg-raised) !important;
|
|
243
298
|
--zx-app-icon-core-strength: 68% !important;
|
|
244
299
|
--zx-app-icon-rim-strength: 62% !important;
|
|
245
300
|
--zx-app-icon-bloom-strength: 0% !important;
|
|
@@ -274,6 +329,12 @@
|
|
|
274
329
|
--zx-color-overlay-selected: Highlight !important;
|
|
275
330
|
--zx-color-overlay-divider: CanvasText !important;
|
|
276
331
|
--zx-color-overlay-scrim: Canvas !important;
|
|
332
|
+
--zx-color-glass-rim: transparent !important;
|
|
333
|
+
--zx-color-glass-ring: transparent !important;
|
|
334
|
+
--zx-color-glass-lift: transparent !important;
|
|
335
|
+
--zx-color-glass-shade: transparent !important;
|
|
336
|
+
--zx-color-glass-edge: transparent !important;
|
|
337
|
+
--zx-color-glass-tint: Canvas !important;
|
|
277
338
|
--zx-overlay-specular-strength: 0% !important;
|
|
278
339
|
--zx-overlay-surface-image: none !important;
|
|
279
340
|
--zx-overlay-toast-image: none !important;
|
|
@@ -287,22 +348,3 @@
|
|
|
287
348
|
--zx-glass-panel-shadow: none !important;
|
|
288
349
|
}
|
|
289
350
|
}
|
|
290
|
-
|
|
291
|
-
/* Browsers without backdrop filtering get an intentionally opaque material instead of a washed
|
|
292
|
-
translucent colour. This is a capability fallback, independent of user preference fallbacks. */
|
|
293
|
-
@supports not ((backdrop-filter: blur(1px)) or (-webkit-backdrop-filter: blur(1px))) {
|
|
294
|
-
:root,
|
|
295
|
-
.zx-scope,
|
|
296
|
-
[data-zx-theme],
|
|
297
|
-
[data-zx-preset] {
|
|
298
|
-
--zx-color-overlay-surface: var(--zx-color-bg-raised) !important;
|
|
299
|
-
--zx-color-overlay-panel: var(--zx-color-bg-raised) !important;
|
|
300
|
-
--zx-color-overlay-backdrop: var(--zx-color-bg-backdrop) !important;
|
|
301
|
-
--zx-overlay-specular-strength: 0% !important;
|
|
302
|
-
--zx-overlay-surface-image: none !important;
|
|
303
|
-
--zx-overlay-toast-image: none !important;
|
|
304
|
-
--zx-overlay-panel-image: none !important;
|
|
305
|
-
--zx-glass-filter-overlay: none !important;
|
|
306
|
-
--zx-glass-filter-panel: none !important;
|
|
307
|
-
}
|
|
308
|
-
}
|