@cahyo-dimas/freeday 1.32.0 → 1.32.1

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 Semua perubahan penting dicatat di sini. Format longgar mengikuti
 [Keep a Changelog](https://keepachangelog.com/); tiap versi = git tag.
 
+## [1.32.1] — 2026-08-18
+Docs only. Asked by a consumer: *"if I upgrade, will the agent in my project know what it gained?"*
+The answer was no, and two reasons why.
+### Fixed
+- **`docs/agent-onboarding.md` never mentioned the changelog.** It is the file a consuming agent
+  reads first, and it listed everything in the package except the one file that says what changed
+  between the version the project had and the one it now has. It now points at
+  `node_modules/@cahyo-dimas/freeday/CHANGELOG.md` explicitly, plus a short *reach for this instead
+  of hand-rolling that* table covering the last nine releases — the additions most likely to replace
+  something an app already worked around.
+- **Three classes existed only in shorthand** in `COMPONENTS.md` — `.fdy-label--required`,
+  `.fdy-cal__month` and `.fdy-cal__grid--months` were written as `(+--required)` and `__month`, so
+  the full name appeared **zero** times and a grep for the class found nothing. The drift guard
+  cannot see this either: it verifies fully-written names and skips shorthand by design, so a class
+  introduced only in shorthand is invisible to both the reader and the test.
+
 ## [1.32.0] — 2026-08-18
 Improvement note 004, both halves: a calendar you could not steer, and a check mark that talked.
 ### Added

package/COMPONENTS.md

@@ -307,7 +307,7 @@ native control, otherwise a `<div>` + explicitly associated label.
 </fieldset>
 ```
 
-**`--required` marks the label, not the accessibility tree.** The control already carries
+**`.fdy-label--required` marks the label, not the accessibility tree.** The control already carries
 `required`; the asterisk is painted through `::after` with CSS alt text, so a screen reader never
 reads "star" after the label — something a `<span>` you have to remember to mark `aria-hidden`
 cannot guarantee.
@@ -517,7 +517,8 @@ Input-styled trigger + calendar popover. Needs `freeday-datepicker.js`. **Author
   get `data-role="from"` / `"to"`; separator `.fdy-daterange__sep`. The end can't precede the start.
   **Typed wrapper: `<FdyDateRange>`** (Vue/React/Blazor) — use it in those stacks.
 **Getting to a distant month.** The title is a **button**: press it and the day grid becomes a
-12-cell month grid for the current year, where the arrows step **years** instead of months. Pick a
+12-cell month grid (`.fdy-cal__grid--months` of `.fdy-cal__month`) for the current year, where the
+arrows step **years** instead of months. Pick a
 month and you are back on days — choosing a month is navigation, so nothing is committed until a day
 is selected. From August 2026 to March 2022 that is 7 clicks; walking month by month is 53.
 

package/README.id.md

@@ -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.32.0-0078d4?style=flat-square)](https://github.com/cahyo-dimas/freeday-ui-kit/tree/v1.32.0)
+[![Release](https://img.shields.io/badge/release-v1.32.1-0078d4?style=flat-square)](https://github.com/cahyo-dimas/freeday-ui-kit/tree/v1.32.1)
 
 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

@@ -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.32.0-0078d4?style=flat-square)](https://github.com/cahyo-dimas/freeday-ui-kit/tree/v1.32.0)
+[![Release](https://img.shields.io/badge/release-v1.32.1-0078d4?style=flat-square)](https://github.com/cahyo-dimas/freeday-ui-kit/tree/v1.32.1)
 
 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/docs/agent-onboarding.md

@@ -91,6 +91,7 @@ Blazor). Then verify the agent can actually read those files — an agent that c
 | `docs/integrations.md` | How to bridge third-party libraries (validation, charts, dates, i18n…). |
 | `docs/reference-screen.html` | A full screen assembled from the shell down. Open it in a browser. |
 | `docs/agent-onboarding.md` | This file. |
+| `CHANGELOG.md` | **What changed between the version this project had and the one it has now** — read it after every upgrade; each entry says what broke, what is new, and why. |
 | `dist/` | Built CSS + enhancers. **`freeday.bundle.css` = tokens + components** (what `@cahyo-dimas/freeday/css` resolves to); `freeday.css` is components **only**, `freeday.tokens.css` tokens only — linking `freeday.css` alone leaves every `var(--…)` unresolved. Plus `freeday-*.js` and the `.d.ts` files. |
 | `src/components/*.css` | The authoritative source for every class, when a doc is ambiguous. |
 | `tokens/tokens.json` | Every token in W3C DTCG format — machine-readable. |
@@ -101,6 +102,28 @@ The live docs (with an interactive playground) are at
 apps under `examples/` (Vue, React, Blazor) that are **not** in the npm tarball — is at
 <https://github.com/cahyo-dimas/freeday-ui-kit>.
 
+### After an upgrade, read the changelog first
+
+`npm i @cahyo-dimas/freeday@latest` does not tell you what you gained. Read
+`node_modules/@cahyo-dimas/freeday/CHANGELOG.md` down to the version this project was on before —
+it is written for exactly this moment, and it is the difference between adopting a new affordance
+and re-implementing it locally.
+
+Recent additions most likely to replace something an app hand-rolled (all detailed in
+`COMPONENTS.md`):
+
+| Reach for | Instead of |
+|---|---|
+| `.fdy-btn--stretch` | a hand-rolled overlay to make a card or list row clickable |
+| `[data-fdy-number]` | a bare `<input type="number">` with the browser's own spin buttons |
+| `clearable` on `FdyCfl` / `FdyDatepicker` | a value that can be set but never unset |
+| `row.waiting(label)` on an upload row | a second status line saying the server is still working |
+| `.fdy-label--required` | a `<span>` asterisk you have to remember to `aria-hidden` |
+| `.fdy-text-warning` / `-danger` / `-success` | a caption class on a line that should stand out |
+| `.fdy-icon` | your own `width:1em;height:1em` rule, once per project |
+| `data-density="comfortable"` | restating the default spacing tokens on a wrapper |
+| the calendar's month grid (press the title) | clicking "previous month" thirty times |
+
 ## 3. Starting a new screen
 
 The order matters; skipping to components is what produces flat, identical-card screens.

package/docs/getting-started.md

@@ -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.32.0"` (public npm package). `dist/` is
+Lands in `package.json` as `"@cahyo-dimas/freeday": "^1.32.1"` (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

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