@zvk/themes 0.1.2 → 0.1.3
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 +7 -0
- package/README.md +14 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
# @zvk/themes Changelog
|
|
2
2
|
|
|
3
|
+
## [0.1.3](https://github.com/brandon-schabel/zvk/compare/themes-v0.1.2...themes-v0.1.3) (2026-06-25)
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
### Features
|
|
7
|
+
|
|
8
|
+
* improve out-of-box DX and UI components ([#24](https://github.com/brandon-schabel/zvk/issues/24)) ([b01272a](https://github.com/brandon-schabel/zvk/commit/b01272a2b35099f5e1fa1dea5883687a0fb4c2e6))
|
|
9
|
+
|
|
3
10
|
## [0.1.2](https://github.com/brandon-schabel/zvk/compare/themes-v0.1.1...themes-v0.1.2) (2026-06-20)
|
|
4
11
|
|
|
5
12
|
|
package/README.md
CHANGED
|
@@ -12,6 +12,8 @@ import "@zvk/graphs/styles.css";
|
|
|
12
12
|
|
|
13
13
|
`@zvk/themes` has no runtime dependencies and no React entry point. The root package exports typed preset metadata, attribute names, mode names, and the CSS variable contract. `@zvk/themes/styles.css` provides preset CSS variables for existing ZVK styles.
|
|
14
14
|
|
|
15
|
+
Presets only set color and control semantics. They do not load fonts, establish layout rhythm, set the root scope, or build app hierarchy. Use app CSS, `@zvk/ui`, and composite layout primitives for those decisions.
|
|
16
|
+
|
|
15
17
|
## Presets
|
|
16
18
|
|
|
17
19
|
The package includes eleven preset IDs:
|
|
@@ -36,11 +38,22 @@ Each preset supports the existing UI mode axis through `data-zvk-ui-theme="light
|
|
|
36
38
|
</div>
|
|
37
39
|
```
|
|
38
40
|
|
|
41
|
+
### Preset pairings
|
|
42
|
+
|
|
43
|
+
Use the preset as the color starting point, then pair it with the density, font, and shell recipe that matches the app:
|
|
44
|
+
|
|
45
|
+
| Preset | Good for | Pair with |
|
|
46
|
+
| --- | --- | --- |
|
|
47
|
+
| `graphite` | Dense admin/dev tools | compact density and an app workspace shell |
|
|
48
|
+
| `teal` | Calm productivity apps | a local-first workspace recipe |
|
|
49
|
+
| `sky` | Reporting/dashboard apps | summary metrics and a table frame |
|
|
50
|
+
| `glass` | Modern focused workspaces | a material-aware app shell |
|
|
51
|
+
|
|
39
52
|
## Styling
|
|
40
53
|
|
|
41
54
|
Load `@zvk/themes/styles.css` after `@zvk/ui/styles.css` and before composite, chart, and graph package styles. The preset stylesheet overrides the `--zvk-ui-*` color and control variables that those packages already consume.
|
|
42
55
|
|
|
43
|
-
`@zvk/themes` is intentionally scoped to color and control semantics only. Typography, spacing, density, radius, motion, and stack variables remain owned by `@zvk/ui
|
|
56
|
+
`@zvk/themes` is intentionally scoped to color and control semantics only. Typography, spacing, density, radius, motion, and stack variables remain owned by `@zvk/ui` and app-level font or layout CSS.
|
|
44
57
|
|
|
45
58
|
When theme attributes are scoped to a subtree (for example a page section), downstream package CSS should read `--zvk-ui-*` from that local scope so package components and aliases resolve correctly.
|
|
46
59
|
|