@cahyo-dimas/freeday 3.9.2 → 3.9.4

package/CHANGELOG.md

@@ -9,6 +9,66 @@ benar. Perubahan seperti itu ditulis di bawah `### Changed: BREAKING (types)`
 lama → tipe baru, dan cara menyempitkannya — bukan di bawah `### Added`, betapapun aditifnya dari
 sisi kit.
 
+## [3.9.4] - 2026-10-26
+
+**Sembilan dari lima puluh enam, dan empat puluh delapan sisanya ranjau.** Tiga rilis berturut-turut
+menambal transisi yang tersangkut di bawah Reduce Motion satu per satu: scrim drawer di 3.9.2, yang
+spesifisitasnya salah dan diperbaiki di 3.9.3, lalu centang checkbox yang dilaporkan dari perangkat
+yang sama. Yang ketiga itu lolos dari penjaga 3.9.3 karena penjaga itu hanya memeriksa transisi yang
+menyentuh `pointer-events`, dan centang checkbox tidak menyentuhnya: ia cuma `transform: scale(0)`
+menjadi `scale(1)`. Inputnya benar-benar tercentang selama ini; centangnya yang tidak pernah
+digambar.
+
+Hitungannya yang menghentikan pola menambal: kit mentransisikan sesuatu di 56 selektor dan
+menetralkan 9.
+
+### Fixed
+- **Setiap transisi dinetralkan di bawah `prefers-reduced-motion`** (`#090`), satu aturan di
+  `src/base.css` alih-alih daftar yang dipelihara tangan. WebKit menjepit durasi transisi ke
+  0.000001s ketika setelan itu menyala, dan pada durasi itu transisinya tidak pernah berjalan:
+  propertinya tersangkut di nilai awal. Akibatnya bukan "kurang halus" melainkan keadaan yang salah
+  di layar.
+- **`transition:none`, bukan durasi mungil.** Reset aksesibilitas yang beredar luas memakai
+  `transition-duration: 0.01ms` supaya `transitionend` tetap menyala, dan durasi mungil itu persis
+  bentuk yang menyangkut di WebKit; reset itu akan memperburuk cacat ini. Satu-satunya yang pernah
+  menunggu `transitionend` di kit ini adalah toast, dan ia sudah punya cadangan
+  `setTimeout(finish, 400)`.
+- **Animasi sengaja tidak disentuh.** Kit memasangnya lewat `prefers-reduced-motion: no-preference`,
+  jadi ia opt-in dan sudah mati di sana, sementara `.fdy-spinner` dan `.fdy-progress` punya
+  perlakuan bernuansa sendiri yang memang harus bertahan.
+- **Penjaganya menuntut aturan menyeluruhnya ada**, dan menolak bentuk durasi-mungil. Dua penjaga
+  sebelumnya hijau untuk kit yang masih punya ranjau; yang ini tidak bisa, sebab ia tidak
+  mendaftar selektor.
+
+## [3.9.3] - 2026-10-26
+
+**Perbaikan 3.9.2 tidak pernah bisa bekerja, dan penjaganya hijau untuknya.** Penetralan
+`prefers-reduced-motion` yang dikirim kemarin memakai `.fdy-app__backdrop`, spesifisitas `(0,1,0)`,
+sementara keadaan terbukanya `.fdy-app--nav-open .fdy-app__backdrop` adalah `(0,2,0)` dan juga
+mendeklarasikan transisi. Jadi penetralannya menang saat drawer tertutup dan kalah saat drawer
+terbuka, yaitu satu-satunya saat ia penting. Yang menanam bomnya 3.9.1 sendiri: ia yang menambahkan
+`transition` ke aturan keadaan terbuka.
+
+Diukur dengan reduced motion diemulasi, bukan disimpulkan: tertutup melaporkan `none`, terbuka
+melaporkan `opacity 1e-06s cubic-bezier(0.2, 0, 0, 1), visibility 1e-06s linear`.
+
+### Fixed
+- **Keempat selektor yang mendeklarasikan transisi backdrop dinetralkan, bukan yang paling lemah**
+  (`#089`). `.fdy-app__backdrop`, keadaan terbukanya, dan kedua padanannya di mode overlay.
+- **Penjaganya menuntut selektor yang SAMA PERSIS**, bukan nama elemennya. Versi pertama hanya
+  memeriksa apakah nama itu muncul di suatu tempat di dalam blok reduced-motion, dan itulah
+  sebabnya ia hijau untuk perbaikan yang mati. Sekarang spesifisitasnya terjaga oleh konstruksi,
+  dan merahnya dibuktikan dengan mengembalikan bentuk 3.9.2: ia menyebut ketiga selektor yang
+  hilang dengan nama.
+
+### Catatan: kelas bug ini dapat direproduksi di laptop
+Sepanjang penyelidikan ini dicatat bahwa hanya perangkat sungguhan yang dapat menemukannya. Untuk
+yang satu ini itu tidak benar. Chrome ikut menjepit durasi transisi ke `1e-06s` di bawah
+`emulateMedia({ reducedMotion: 'reduce' })`, jadi cacat spesifisitasnya terukur di mesin mana pun.
+Yang tetap tidak dapat direproduksi di Chromium adalah akibatnya, yakni properti yang tersangkut di
+nilai awal; tetapi kontrak yang mencegahnya, `transition` wajib `none` di kedua keadaan, dapat
+diperiksa di mana saja.
+
 ## [3.9.2] - 2026-10-26
 
 **Satu setelan aksesibilitas, dan sebuah scrim yang tak terlihat tetapi tetap menangkap tap.**

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-v3.9.2-0078d4?style=flat-square)](https://github.com/cahyo-dimas/freeday-ui-kit/tree/v3.9.2)
+[![Release](https://img.shields.io/badge/release-v3.9.4-0078d4?style=flat-square)](https://github.com/cahyo-dimas/freeday-ui-kit/tree/v3.9.4)
 
 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-v3.9.2-0078d4?style=flat-square)](https://github.com/cahyo-dimas/freeday-ui-kit/tree/v3.9.2)
+[![Release](https://img.shields.io/badge/release-v3.9.4-0078d4?style=flat-square)](https://github.com/cahyo-dimas/freeday-ui-kit/tree/v3.9.4)
 
 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/dist/freeday.bundle.css

@@ -1217,6 +1217,32 @@ a { color: var(--color-primary-strong); }
   *, *::before, *::after { animation-duration: .001ms !important; transition-duration: .001ms !important; }
 }
 
+/* ===========================================================================
+ * Reduce Motion: SETIAP transisi dinetralkan, bukan daftar yang dipelihara tangan.
+ *
+ * WebKit menjepit durasi transisi ke 0.000001s ketika setelan itu menyala, dan pada durasi itu
+ * transisinya tidak pernah berjalan: propertinya tersangkut di nilai AWAL, selamanya. Akibatnya
+ * bukan "kurang halus" melainkan keadaan yang salah di layar. Terukur di iPhone 7 tiga kali:
+ * scrim drawer yang tinggal gelap sambil tetap menangkap tap, dan centang checkbox yang tak
+ * pernah digambar padahal inputnya benar-benar tercentang.
+ *
+ * Sebelum aturan ini, kit menetralkan sembilan selektor dari lima puluh enam yang mentransisikan
+ * sesuatu. Empat puluh delapan sisanya ranjau yang menunggu, dan tiga sudah meledak di tangan satu
+ * pemilik app. Menambal yang keempat adalah cara kita sampai di sini.
+ *
+ * `transition: none`, BUKAN `transition-duration: 0.01ms` yang biasa beredar sebagai reset
+ * aksesibilitas: durasi mungil itu persis bentuk yang menyangkut di WebKit. Satu-satunya yang
+ * pernah menunggu `transitionend` di kit ini adalah toast, dan ia sudah punya cadangan
+ * `setTimeout(finish, 400)` untuk kasus event itu tak pernah datang.
+ *
+ * ANIMASI sengaja tidak disentuh: kit memasangnya lewat `prefers-reduced-motion: no-preference`,
+ * jadi ia opt-in dan sudah mati di sini, sementara `--spinner` dan `--progress` punya perlakuan
+ * bernuansa sendiri yang memang harus bertahan.
+ * ======================================================================== */
+@media (prefers-reduced-motion:reduce){
+  *,*::before,*::after{transition:none !important;}
+}
+
 /* Freeday. Accordion (native <details>/<summary>, zero-JS) */
 /* position:relative, containing block for out-of-flow panel content (see base.css). NOT redundant
    with the panel's reveal animation: that animation gives the panel a transform (which happens to
@@ -1416,7 +1442,19 @@ a { color: var(--color-primary-strong); }
  * Scrim yang tak terlihat tetapi menangkap tap, jadi ketukan pertama pengguna hilang dan ketukan
  * kedua yang bekerja. Setelan yang sama dimatikan, deret yang sama berjalan 0.87 lalu 1.00.
  * Sidebar sudah dinetralkan sejak lama; backdrop terlewat, dan ia yang menggerbangi interaksi. */
-@media (prefers-reduced-motion:reduce){.fdy-app__sidebar{transition:none;}.fdy-app__backdrop{transition:none;}}
+@media (prefers-reduced-motion:reduce){
+  .fdy-app__sidebar{transition:none;}
+  /* KEEMPAT selektor yang mendeklarasikan transisi backdrop, bukan hanya yang paling lemah.
+     `.fdy-app__backdrop` sendirian berspesifisitas (0,1,0) dan kalah dari keadaan terbukanya,
+     `.fdy-app--nav-open .fdy-app__backdrop` (0,2,0), sehingga penetralan ini diam-diam tidak
+     berlaku justru pada saat drawer terbuka, yaitu satu-satunya saat ia penting. Diukur dengan
+     reduced motion diemulasi: tertutup melaporkan `none`, terbuka melaporkan
+     `opacity 1e-06s, visibility 1e-06s`. */
+  .fdy-app__backdrop,
+  .fdy-app--nav-open .fdy-app__backdrop,
+  .fdy-app--nav-overlay .fdy-app__backdrop,
+  .fdy-app--nav-overlay.fdy-app--nav-open .fdy-app__backdrop{transition:none;}
+}
 
 /* Freeday. App bar (standalone top bar: brand · actions · spacer).
  * Distinct from .fdy-app__topbar (which is bound to the shell grid). Use anywhere;

package/dist/freeday.css

@@ -40,6 +40,32 @@ a { color: var(--color-primary-strong); }
   *, *::before, *::after { animation-duration: .001ms !important; transition-duration: .001ms !important; }
 }
 
+/* ===========================================================================
+ * Reduce Motion: SETIAP transisi dinetralkan, bukan daftar yang dipelihara tangan.
+ *
+ * WebKit menjepit durasi transisi ke 0.000001s ketika setelan itu menyala, dan pada durasi itu
+ * transisinya tidak pernah berjalan: propertinya tersangkut di nilai AWAL, selamanya. Akibatnya
+ * bukan "kurang halus" melainkan keadaan yang salah di layar. Terukur di iPhone 7 tiga kali:
+ * scrim drawer yang tinggal gelap sambil tetap menangkap tap, dan centang checkbox yang tak
+ * pernah digambar padahal inputnya benar-benar tercentang.
+ *
+ * Sebelum aturan ini, kit menetralkan sembilan selektor dari lima puluh enam yang mentransisikan
+ * sesuatu. Empat puluh delapan sisanya ranjau yang menunggu, dan tiga sudah meledak di tangan satu
+ * pemilik app. Menambal yang keempat adalah cara kita sampai di sini.
+ *
+ * `transition: none`, BUKAN `transition-duration: 0.01ms` yang biasa beredar sebagai reset
+ * aksesibilitas: durasi mungil itu persis bentuk yang menyangkut di WebKit. Satu-satunya yang
+ * pernah menunggu `transitionend` di kit ini adalah toast, dan ia sudah punya cadangan
+ * `setTimeout(finish, 400)` untuk kasus event itu tak pernah datang.
+ *
+ * ANIMASI sengaja tidak disentuh: kit memasangnya lewat `prefers-reduced-motion: no-preference`,
+ * jadi ia opt-in dan sudah mati di sini, sementara `--spinner` dan `--progress` punya perlakuan
+ * bernuansa sendiri yang memang harus bertahan.
+ * ======================================================================== */
+@media (prefers-reduced-motion:reduce){
+  *,*::before,*::after{transition:none !important;}
+}
+
 /* Freeday. Accordion (native <details>/<summary>, zero-JS) */
 /* position:relative, containing block for out-of-flow panel content (see base.css). NOT redundant
    with the panel's reveal animation: that animation gives the panel a transform (which happens to
@@ -239,7 +265,19 @@ a { color: var(--color-primary-strong); }
  * Scrim yang tak terlihat tetapi menangkap tap, jadi ketukan pertama pengguna hilang dan ketukan
  * kedua yang bekerja. Setelan yang sama dimatikan, deret yang sama berjalan 0.87 lalu 1.00.
  * Sidebar sudah dinetralkan sejak lama; backdrop terlewat, dan ia yang menggerbangi interaksi. */
-@media (prefers-reduced-motion:reduce){.fdy-app__sidebar{transition:none;}.fdy-app__backdrop{transition:none;}}
+@media (prefers-reduced-motion:reduce){
+  .fdy-app__sidebar{transition:none;}
+  /* KEEMPAT selektor yang mendeklarasikan transisi backdrop, bukan hanya yang paling lemah.
+     `.fdy-app__backdrop` sendirian berspesifisitas (0,1,0) dan kalah dari keadaan terbukanya,
+     `.fdy-app--nav-open .fdy-app__backdrop` (0,2,0), sehingga penetralan ini diam-diam tidak
+     berlaku justru pada saat drawer terbuka, yaitu satu-satunya saat ia penting. Diukur dengan
+     reduced motion diemulasi: tertutup melaporkan `none`, terbuka melaporkan
+     `opacity 1e-06s, visibility 1e-06s`. */
+  .fdy-app__backdrop,
+  .fdy-app--nav-open .fdy-app__backdrop,
+  .fdy-app--nav-overlay .fdy-app__backdrop,
+  .fdy-app--nav-overlay.fdy-app--nav-open .fdy-app__backdrop{transition:none;}
+}
 
 /* Freeday. App bar (standalone top bar: brand · actions · spacer).
  * Distinct from .fdy-app__topbar (which is bound to the shell grid). Use anywhere;

package/docs/getting-started.md

@@ -191,7 +191,7 @@ live docs also have a copy button per component.
 ```bash
 npm i @cahyo-dimas/freeday
 ```
-Lands in `package.json` as `"@cahyo-dimas/freeday": "^3.9.2"` (public npm package). `dist/` is
+Lands in `package.json` as `"@cahyo-dimas/freeday": "^3.9.4"` (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": "3.9.2",
+  "version": "3.9.4",
   "description": "Freeday: token-driven, framework-agnostic UI KIT (design source-of-truth).",
   "type": "module",
   "license": "MIT",

package/src/base.css

@@ -38,3 +38,29 @@ a { color: var(--color-primary-strong); }
 @media (prefers-reduced-motion: reduce) {
   *, *::before, *::after { animation-duration: .001ms !important; transition-duration: .001ms !important; }
 }
+
+/* ===========================================================================
+ * Reduce Motion: SETIAP transisi dinetralkan, bukan daftar yang dipelihara tangan.
+ *
+ * WebKit menjepit durasi transisi ke 0.000001s ketika setelan itu menyala, dan pada durasi itu
+ * transisinya tidak pernah berjalan: propertinya tersangkut di nilai AWAL, selamanya. Akibatnya
+ * bukan "kurang halus" melainkan keadaan yang salah di layar. Terukur di iPhone 7 tiga kali:
+ * scrim drawer yang tinggal gelap sambil tetap menangkap tap, dan centang checkbox yang tak
+ * pernah digambar padahal inputnya benar-benar tercentang.
+ *
+ * Sebelum aturan ini, kit menetralkan sembilan selektor dari lima puluh enam yang mentransisikan
+ * sesuatu. Empat puluh delapan sisanya ranjau yang menunggu, dan tiga sudah meledak di tangan satu
+ * pemilik app. Menambal yang keempat adalah cara kita sampai di sini.
+ *
+ * `transition: none`, BUKAN `transition-duration: 0.01ms` yang biasa beredar sebagai reset
+ * aksesibilitas: durasi mungil itu persis bentuk yang menyangkut di WebKit. Satu-satunya yang
+ * pernah menunggu `transitionend` di kit ini adalah toast, dan ia sudah punya cadangan
+ * `setTimeout(finish, 400)` untuk kasus event itu tak pernah datang.
+ *
+ * ANIMASI sengaja tidak disentuh: kit memasangnya lewat `prefers-reduced-motion: no-preference`,
+ * jadi ia opt-in dan sudah mati di sini, sementara `--spinner` dan `--progress` punya perlakuan
+ * bernuansa sendiri yang memang harus bertahan.
+ * ======================================================================== */
+@media (prefers-reduced-motion:reduce){
+  *,*::before,*::after{transition:none !important;}
+}

package/src/components/app-shell.css

@@ -160,4 +160,16 @@
  * Scrim yang tak terlihat tetapi menangkap tap, jadi ketukan pertama pengguna hilang dan ketukan
  * kedua yang bekerja. Setelan yang sama dimatikan, deret yang sama berjalan 0.87 lalu 1.00.
  * Sidebar sudah dinetralkan sejak lama; backdrop terlewat, dan ia yang menggerbangi interaksi. */
-@media (prefers-reduced-motion:reduce){.fdy-app__sidebar{transition:none;}.fdy-app__backdrop{transition:none;}}
+@media (prefers-reduced-motion:reduce){
+  .fdy-app__sidebar{transition:none;}
+  /* KEEMPAT selektor yang mendeklarasikan transisi backdrop, bukan hanya yang paling lemah.
+     `.fdy-app__backdrop` sendirian berspesifisitas (0,1,0) dan kalah dari keadaan terbukanya,
+     `.fdy-app--nav-open .fdy-app__backdrop` (0,2,0), sehingga penetralan ini diam-diam tidak
+     berlaku justru pada saat drawer terbuka, yaitu satu-satunya saat ia penting. Diukur dengan
+     reduced motion diemulasi: tertutup melaporkan `none`, terbuka melaporkan
+     `opacity 1e-06s, visibility 1e-06s`. */
+  .fdy-app__backdrop,
+  .fdy-app--nav-open .fdy-app__backdrop,
+  .fdy-app--nav-overlay .fdy-app__backdrop,
+  .fdy-app--nav-overlay.fdy-app--nav-open .fdy-app__backdrop{transition:none;}
+}