@jdcpuwiz/homelab-ui 0.7.0 → 0.7.1

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.
Files changed (3) hide show
  1. package/README.md +12 -3
  2. package/globals.css +13 -4
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -37,11 +37,20 @@ BuildPlan #57 — shipped in **0.7.0**). The size line is the hard boundary.
37
37
  The `--hl-font-*` vars in `@jdcpuwiz/homelab-ui/globals.css`:
38
38
 
39
39
  ```css
40
- --hl-font-sans: var(--font-poppins), "Poppins", system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
41
- --hl-font-display: var(--font-orbitron), "Orbitron", var(--hl-font-sans);
42
- --hl-font-mono: var(--font-jetbrains-mono), "JetBrains Mono", ui-monospace, "SF Mono", Menlo, Consolas, monospace;
40
+ --hl-font-sans: var(--font-poppins, "Poppins"), system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
41
+ --hl-font-display: var(--font-orbitron, "Orbitron"), var(--hl-font-sans);
42
+ --hl-font-mono: var(--font-jetbrains-mono, "JetBrains Mono"), ui-monospace, "SF Mono", Menlo, Consolas, monospace;
43
43
  ```
44
44
 
45
+ The literal face name is `var()`'s own fallback argument, not just the next
46
+ comma item — a bare `var(--font-poppins), "Poppins", …` looks equivalent but
47
+ isn't: an unresolved `var()` with no inline fallback invalidates the whole
48
+ declaration (CSS custom-properties spec), so an app that never sets
49
+ `--font-poppins` (any Vite/@fontsource consumer) would silently lose the
50
+ entire chain and render the browser's default serif instead of falling
51
+ through to "Poppins". Fixed in 0.7.1 after it surfaced building BuildPlan
52
+ #57's own reference render.
53
+
45
54
  Each var references the app's `next/font` variable first, then the literal face
46
55
  name (covers `@fontsource` / a system-installed face), then the platform
47
56
  fallback — so text is readable even mid-load and an un-migrated app degrades to
package/globals.css CHANGED
@@ -82,11 +82,20 @@
82
82
  family name (covers @fontsource / a system-installed face), then the
83
83
  platform fallback — so text is always readable even mid-load, and an app
84
84
  that hasn't been migrated yet degrades to the system stack rather than
85
- to nothing. */
86
- --hl-font-sans: var(--font-poppins), "Poppins", system-ui, -apple-system,
85
+ to nothing.
86
+
87
+ The literal name MUST be var()'s own fallback argument, not just the
88
+ next comma-separated item — `var(--font-poppins), "Poppins", …` looks
89
+ equivalent but isn't: per the CSS custom-properties spec, an unresolved
90
+ var() with no inline fallback invalidates the ENTIRE declaration (not
91
+ just that token), so a consumer that never sets --font-poppins (every
92
+ Vite/@fontsource app — no next/font means that var is never declared)
93
+ silently loses the whole chain and renders the browser's default serif.
94
+ Caught 2026-07-26 building BuildPlan #57's own reference render. */
95
+ --hl-font-sans: var(--font-poppins, "Poppins"), system-ui, -apple-system,
87
96
  "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
88
- --hl-font-display: var(--font-orbitron), "Orbitron", var(--hl-font-sans);
89
- --hl-font-mono: var(--font-jetbrains-mono), "JetBrains Mono", ui-monospace,
97
+ --hl-font-display: var(--font-orbitron, "Orbitron"), var(--hl-font-sans);
98
+ --hl-font-mono: var(--font-jetbrains-mono, "JetBrains Mono"), ui-monospace,
90
99
  "SF Mono", SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace;
91
100
  }
92
101
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@jdcpuwiz/homelab-ui",
3
- "version": "0.7.0",
3
+ "version": "0.7.1",
4
4
  "description": "Shared dark-theme UI primitives for the JdCpuWiz homelab \u2014 Sidebar, Button, Modal, PageHeader, TagChips, plus the canonical Tailwind preset, CSS vars, and the sanctioned three-face typography (Poppins / Orbitron / JetBrains Mono) on one flat #f0f1f4 text color.",
5
5
  "license": "MIT",
6
6
  "author": "Wiz <shad@deckerzoo.com>",