npm - @cahyo-dimas/freeday - Versions diffs - 1.30.0 → 1.31.0 - Mend

@cahyo-dimas/freeday 1.30.0 → 1.31.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.

Files changed (9) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -3,6 +3,35 @@
 Semua perubahan penting dicatat di sini. Format longgar mengikuti
 [Keep a Changelog](https://keepachangelog.com/); tiap versi = git tag.
+## [1.31.0] — 2026-08-18
+Improvement note 002: density was a one-way door.
+### Added
+- **`[data-density="comfortable"]` is now a real rule.** The kit shipped only the `compact` block,
+  and its own comment promised per-subtree density — true in one direction only. These are
+  inheriting custom properties, so once `<html>` is compact *every* subtree is compact and a
+  `comfortable` wrapper matched nothing at all. An app that is dense overall (a back office where
+  most screens are data grids) could not opt its shared chrome back out: measured against a sibling
+  product, the logo sat 12px from the edge instead of 16 and the avatar 12 instead of 20 — four
+  pixels in two places, from `--space-4` and `--control-h`, which reads as sloppiness rather than as
+  a token. The workaround, restating the five defaults on a local class, is exactly the copy that
+  goes stale when the kit retunes a step.
+  Note the kit's own README has been telling people to write `data-density="comfortable"` on `<html>`
+  since long before a rule existed for it — harmless there, because it matched the defaults by
+  accident, and broken the moment anyone needed it on a wrapper.
+### Notes on the shape of the fix
+- The five values are **derived from the tokens' own defaults** at build time, not written out a
+  second time. Same key set by construction, so a token that gains a `$compact` value automatically
+  gains its way back out, and a retuned default can never leave the two blocks disagreeing. The
+  report's hand-written block was correct in all five values — this only removes the chance for it
+  to stop being correct.
+### Added — guards
+- `test/build.test.mjs` asserts the two density blocks cover the *same* tokens, that every
+  comfortable value equals the `:root` default, and that none of them equals its compact counterpart
+  (a block that resets nothing is as green as one that works).
+- `browser/theme.mjs` measures it in a real engine: a compact root, a `comfortable` island that
+  returns to a 40px control and `--space-4: 1rem`, and a `compact` island nested back inside that —
+  because the point of the rule is the box that comes out, not the declaration going in.
 ## [1.30.0] — 2026-08-18
 Note 008 (adopting 1.29.0) plus a direct design report: *"the input border looks too dark next to the
 card and button-group borders."*

package/COMPONENTS.md CHANGED Viewed

@@ -232,7 +232,8 @@ utility variant that has to agree with the shell must use `nav`; using `md` leav
 Density: `data-density="compact"` works on `<html>` **or any wrapper** — the selector is a bare
 `[data-density="compact"]` over inheriting custom properties, so one screen can be dense while the
-rest of the app is not.
+rest of the app is not. `data-density="comfortable"` is a real rule too, so the reverse also works:
+a compact root with one region opted back out (shared chrome that must match a sibling product).
 ---

package/README.id.md CHANGED Viewed

@@ -5,7 +5,7 @@
 > **Lebih banyak _free day_ buat dev — UI kit-nya sudah siap pakai.**
 [![Live docs](https://img.shields.io/badge/docs-live-2050d8?style=flat-square)](https://cahyo-dimas.github.io/freeday-ui-kit/)
-[![Release](https://img.shields.io/badge/release-v1.30.0-0078d4?style=flat-square)](https://github.com/cahyo-dimas/freeday-ui-kit/tree/v1.30.0)
+[![Release](https://img.shields.io/badge/release-v1.31.0-0078d4?style=flat-square)](https://github.com/cahyo-dimas/freeday-ui-kit/tree/v1.31.0)
 UI KIT yang token-driven & framework-agnostic — satu sumber kebenaran untuk warna, tipografi,
 spasi, dan komponen. Blueprint: `docs/superpowers/specs/2026-07-21-freeday-ui-kit-design.md`.

package/README.md CHANGED Viewed

@@ -5,7 +5,7 @@
 > **More free days for devs — the UI kit is ready to use.**
 [![Live docs](https://img.shields.io/badge/docs-live-2050d8?style=flat-square)](https://cahyo-dimas.github.io/freeday-ui-kit/)
-[![Release](https://img.shields.io/badge/release-v1.30.0-0078d4?style=flat-square)](https://github.com/cahyo-dimas/freeday-ui-kit/tree/v1.30.0)
+[![Release](https://img.shields.io/badge/release-v1.31.0-0078d4?style=flat-square)](https://github.com/cahyo-dimas/freeday-ui-kit/tree/v1.31.0)
 A token-driven, framework-agnostic UI kit — one source of truth for color, typography,
 spacing, and components. Blueprint: `docs/superpowers/specs/2026-07-21-freeday-ui-kit-design.md`.

package/USAGE.md CHANGED Viewed

@@ -130,6 +130,13 @@ container, a single `<section>`. An app whose two list screens are dense and who
 are not should scope it per screen rather than densifying everything. Set it at one level per screen,
 never per component.
+**And it goes both ways.** `data-density="comfortable"` is a real rule, not just the absence of
+`compact`, so an app that is dense *at the root* can opt one region back out — a header, a toolbar,
+a footer shared with a sibling product that has to line up pixel for pixel. Inheritance only runs
+downhill; without that rule a compact root left every subtree compact and a `comfortable` wrapper
+changed nothing. Do not restate the five values by hand: that copy goes stale the moment the kit
+retunes a step.
 ## 6b. Navigation: one component, two orientations — and never a tab role
 A navigation link is an `<a class="fdy-nav__item">` marked **`aria-current="page"`**. That does not

package/dist/freeday.bundle.css CHANGED Viewed

@@ -368,6 +368,18 @@
   --space-6: 1.25rem;
   --control-h: 2rem;
 }
+/* ...and the way back out. Inheritance only runs downhill: once the root is compact every subtree is
+ * compact, and before this rule existed a data-density="comfortable" wrapper matched nothing — so the
+ * comment above was true in one direction only. An app that is dense overall and carries one region
+ * of shared chrome (a header, a toolbar, a footer shared with a sibling product) had to restate the
+ * defaults by hand, which is exactly the local copy that goes stale when the kit retunes them. */
+[data-density="comfortable"] {
+  --space-3: 0.75rem;
+  --space-4: 1rem;
+  --space-5: 1.25rem;
+  --space-6: 1.5rem;
+  --control-h: 2.5rem;
+}
 /* Freeday components — GENERATED by tokens/build.mjs. Do not edit by hand. */
 /* Freeday base layer — reset ringan + default via token */

package/dist/freeday.tokens.css CHANGED Viewed

@@ -367,3 +367,15 @@
   --space-6: 1.25rem;
   --control-h: 2rem;
 }
+/* ...and the way back out. Inheritance only runs downhill: once the root is compact every subtree is
+ * compact, and before this rule existed a data-density="comfortable" wrapper matched nothing — so the
+ * comment above was true in one direction only. An app that is dense overall and carries one region
+ * of shared chrome (a header, a toolbar, a footer shared with a sibling product) had to restate the
+ * defaults by hand, which is exactly the local copy that goes stale when the kit retunes them. */
+[data-density="comfortable"] {
+  --space-3: 0.75rem;
+  --space-4: 1rem;
+  --space-5: 1.25rem;
+  --space-6: 1.5rem;
+  --control-h: 2.5rem;
+}

package/docs/getting-started.md CHANGED Viewed

@@ -184,7 +184,7 @@ live docs also have a copy button per component.
 ```bash
 npm i @cahyo-dimas/freeday
 ```
-Lands in `package.json` as `"@cahyo-dimas/freeday": "^1.30.0"` (public npm package). `dist/` is
+Lands in `package.json` as `"@cahyo-dimas/freeday": "^1.31.0"` (public npm package). `dist/` is
 committed and published → no build step; `npm ci` runs without auth.
 ### 2. Import the CSS + enhancers **once** in your entry (`src/main.ts`)

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@cahyo-dimas/freeday",
-  "version": "1.30.0",
+  "version": "1.31.0",
   "description": "Freeday — token-driven, framework-agnostic UI KIT (design source-of-truth).",
   "type": "module",
   "license": "MIT",