# Changelog

รูปแบบตาม [Keep a Changelog](https://keepachangelog.com/) · semver: patch = หน้าตา/บั๊ก, minor = component/prop ใหม่, major = เปลี่ยน/ลบ props

## [0.120.0] — 2026-11-15

คำขอจาก supplychain (session upgrade 2026-11-14):

### Changed
- **rich-text ทดสอบกับ lexical 0.53** — devDependencies + showcase ขึ้น `^0.53.0` (typecheck, เทสต์, Chrome จริง: พิมพ์/ตัวหนา/ขึ้นบรรทัด/ตัวแปร/ไม่วน onChange) ไม่ต้องแก้โค้ด editor · peer คง `>=0.49.0` ไม่ปิดเพดาน (npm ล้มการติดตั้งเมื่อ optional peer อยู่นอกช่วง — แอปที่ใช้ lexical รุ่นใหม่กว่ากับงานอื่นจะติดตั้งไม่ได้) · README ระบุช่วงที่ทดสอบ 0.49–0.53
- **`PinnedLinks` บนจอสัมผัส: ไม่มีปุ่มเลิกปักหมุดซ้อนมุมทุกไอคอนแล้ว** (เดิมแสดงตลอดเพราะไม่มี hover — supplychain จอ 375px) → ซ่อนเมื่อ `pointer: coarse` · **กดค้างที่ทางลัด (นิ้ว/ปากกา) แล้วยกนิ้ว = ถามเลิกปักหมุด** (ไม่เปิดลิงก์, ไม่มีเมนูของเบราว์เซอร์; กล่องเปิดหลัง touchend และตัด click จำลองของเบราว์เซอร์ — ไม่งั้น click จำลองไปโดนปุ่มยืนยันกลางจอเอง ตรวจด้วยนิ้วจำลองใน Chrome) · ยังเลิกปักได้จากปุ่ม pin ในเมนูข้าง · เมาส์/คีย์บอร์ดเหมือนเดิม (hover/โฟกัสแล้วปุ่มโผล่)
- docs: README / agent-rules / `docs/upgrade.md` — **`@suphark/ui/data-table` ใช้ `@tanstack/react-table` v8 เท่านั้น** (v9 เปลี่ยน API ทั้งชุด; เจ้าของตัดสิน 2026-11-15 คง peer `>=8.20.0` ไม่จำกัด `^8` เพราะ npm จะล้มการติดตั้งในแอปที่มี v9 อยู่ เช่น DueBell — ย้ายเป็น v9 เป็นงานแยก)

### Fixed
- **`RichTextEditor` พิมพ์ `{{` แล้วเมนูตัวแปรไม่เด้ง** (บั๊กเดิมตั้งแต่ 0.93.0 — `useBasicTypeaheadTriggerMatch("{{")` ของ lexical ใช้ trigger เป็น character class จึงจับได้แค่ `{` ตัวเดียว) → ตัวจับของเราเอง: `{{ชื่อ` และ `{ชื่อ` เปิดเมนูทั้งคู่
- showcase: **หน้า `/guides/<slug>` บน production ตอบ 500** (deploy แก้แล้ว 2026-11-13) — ui.suphark.com ล็อกอินผ่าน Pi Auth หน้าจึง render ตอน request (ไม่ใช่ตอน build) และไฟล์ md ที่อ่านด้วย path จากตัวแปร (+ `turbopackIgnore`) ไม่ถูก trace ขึ้น server → อ่านผ่าน path ตายตัวทีละไฟล์ (`src/docs/guide-sources.ts`) แบบหน้า changelog — build แบบมี auth ยืนยัน `.nft.json` มี md ครบ 4 ไฟล์

## [0.119.0] — 2026-11-13

### Added
- **`@suphark/ui/markdown` — `Markdown`** (supplychain ขอ — เจ้าของสั่งให้คู่มือของทุกแอปอยู่บนเว็บ): แสดง markdown (GFM: ตาราง, รายการซ้อน, code, blockquote, ลิงก์) ตามรูปแบบตัวอักษรของ design system (`.ui-prose`) · ใช้ใน server component ได้ ไม่ส่ง JS · หัวข้อมี id ภาษาไทย ลิงก์ `#หัวข้อ` ได้ + `toc` สารบัญ (จอกว้างคอลัมน์ขวา, จอแคบพับไว้) · `stripTitle`, `resolveHref` · ลิงก์ภายนอกเปิดแท็บใหม่, `javascript:`/`data:` ถูกตัด · HTML ดิบเป็นข้อความเว้นแต่ `allowHtml` · ตารางกว้างเลื่อนในกรอบ (tab stop + region) · `renderMarkdown` / `MarkdownToc` / `markdownSlug` สำหรับวางเอง · ข้อความ UI ผ่าน `text` (`MARKDOWN_TEXT_TH`/`_EN`) · dependency ใหม่ `marked`
- showcase: **หน้าคู่มือ `/guides`** (เมนู "คู่มือ") — render จาก markdown ใน repo ตอน build: วิธีใช้แพ็กเกจ (README), กติกา UI สำหรับแอป, อัปรุ่นในแอป, หลักการ design system · ลิงก์ระหว่างไฟล์เปลี่ยนเป็นหน้าเว็บ · ลิงก์ "วิธีติดตั้ง" ท้ายหน้าชี้ `/guides/usage`
- showcase: หน้า component `markdown`
- docs: **`docs/upgrade.md` คู่มืออัปรุ่นในแอป** (ขั้นตอน + ตารางเรื่องที่กระทบแอปเมื่อข้ามรุ่น) แทนส่วนขั้นตอนใน `ops/upgrade-apps-0.113.md` ที่ผูกกับรุ่น · agent-rules แถว `Markdown`

### Changed
- **`selectOnFocus` เป็นค่าเริ่มต้นที่ `NumberInput` และ `FormFieldFormattedNumber`** (เจ้าของตัดสิน 2026-11-13) — คลิก/Tab เข้าช่องเลือกตัวเลขทั้งหมด พิมพ์ทับได้ · ไม่ต้องการ: `selectOnFocus={false}` · `FormFieldInput` ยังเป็น opt-in (ใช้กับข้อความทั่วไปด้วย) · เทสต์ของแอปที่วางเคอร์เซอร์แล้ว focus ช่องเพื่อพิมพ์ต่อท้ายอาจต้องปรับ
- showcase: ตัวอย่าง `form-fields` / `number-input` ไม่ต้องใส่ `selectOnFocus` แล้ว · note ของ `number-input` / `form-fields`

### Fixed
- **`Prose` / `.ui-prose`: inline code ยาวไม่มีช่องว่าง (`A/B/C`, `prop={…}`) ดันหน้าล้นแนวนอนบนมือถือ** → ตัดบรรทัดได้ (`overflow-wrap: anywhere`)

## [0.118.0] — 2026-11-13

### Added
- **`selectOnFocus` ที่ช่องตัวเลข** (supplychain ขอ — ช่องค่าเริ่มต้น 0 คลิกแล้วพิมพ์ได้ "05"/"50"): `FormFieldFormattedNumber`, `NumberInput`, `FormFieldInput` (variant ปกติ/`isNumeric`) — คลิก/แตะ/Tab เข้าช่อง = เลือกข้อความทั้งหมด พิมพ์ทับได้ทันที · คลิกครั้งแรกกัน mouseup ไม่ให้ browser ยกเลิก selection (และเลือกซ้ำหลัง react-number-format จัดเคอร์เซอร์) · คลิกในช่องที่ focus อยู่แล้ว = วางเคอร์เซอร์ตามปกติ · ค่าเริ่มต้นปิด · `onFocus`/`onMouseUp`/`onPointerDown` เดิมของแอปยังถูกเรียก — ตรวจใน Chrome จริงทั้งเมาส์, iPhone, Android
- **hook `useSelectOnFocus(enabled, handlers)`** — พฤติกรรมเดียวกันสำหรับ `<Input>` ที่แอปประกอบเอง
- showcase: `form-fields` เพิ่มช่อง "ราคาต่อหน่วย (บาท)" (`FormFieldFormattedNumber` + `selectOnFocus`), `number-input` ช่องค่าบริการใช้ `selectOnFocus`
- docs: `agent-rules.md` แถวช่องตัวเลขแนะนำ `selectOnFocus`

### Changed
- `suphark-ui-audit` กฎ `arbitrary-text`: ข้อความแนะนำเปลี่ยนเป็นสเกลมาตรฐาน `text-xs … text-2xl` (เดิมแนะนำคลาสตามบทบาท) ตามที่เจ้าของตัดสิน 2026-11-13 — ยังจับ `text-[Npx]`/`rem`/`em` เป็น error เหมือนเดิม
- docs: `agent-rules.md` — แอปใช้ `text-xs … text-2xl` เท่านั้น ห้าม `text-[Npx]` เด็ดขาด, คลาสตามบทบาทเป็นของภายในแพ็กเกจ

## [0.117.0] — 2026-11-12

supplychain ขอ (redesign หน้า /budget/[id]):

### Added
- **`AppShell` ตั้ง `--app-header-height` ที่ `<html>`** = ความสูงจริงของหัวแอป (banner + header 1–2 แถวบนมือถือ) ตามเมื่อเปลี่ยน (ResizeObserver) ทั้ง layout sidebar และ top · แถบ sticky ใต้หัวแอปใช้ `top-(--app-header-height)` ได้ตรง ๆ ไม่ต้องวัด `[data-app-header]` เอง · `header={false}` / unmount = เอาตัวแปรออก (ก่อนวัดครั้งแรกใส่ fallback เอง เช่น `top-(--app-header-height,3.5rem)`)

### Fixed
- **`DocumentHeader` บนมือถือปุ่มบีบชื่อเอกสารจนเหลือคำละบรรทัด** → กล่องชื่อกว้างอย่างน้อย 12rem (`basis-48` ไม่พอ = ปุ่มขึ้นบรรทัดใหม่) และจอ < md ปุ่มรอง (`secondaryActions`) ย้ายเข้าเมนู ⋯ ให้เอง (เดิมทำเฉพาะเมื่อ `stickyActionsOnMobile`) — สลับด้วย CSS ไม่กระพริบตอน hydrate
- **`FormFieldSelect` (variant select) ช่องเลือกไม่เต็มความกว้าง** (shadcn ตั้ง `w-fit`) ขณะที่ช่องอื่นในฟอร์มเต็ม → trigger `w-full`
- docs: `agent-rules.md` — sticky ใต้หัวแอปใช้ `--app-header-height`
- showcase: หน้า `document-header` ตัวอย่างหัวที่มีปุ่มรอง 2 ปุ่ม + เมนู โดยไม่ใช้ `stickyActionsOnMobile` (จอแคบปุ่มรองเข้าเมนู ⋯)

## [0.116.0] — 2026-11-12

แก้ตาม code review ของงาน 0.113.3–0.114.0 (เจ้าของสั่ง):

### Added
- **`data-surface="destructive"`** — container พื้นโทนแดงประกาศแล้วปุ่ม `variant="destructive"` ข้างในใช้ `--destructive-subtle-foreground` (ผ่าน AA) · `DangerZone` และ `Notice tone="danger"` ประกาศให้เอง แอปใส่ให้ container พื้นแดงของตัวเองได้ (เดิมแก้เฉพาะใน DangerZone ด้วยคลาส arbitrary)
- **ตัวแปรปรับสี toast `richColors`**: `--toast-{success,info,warning,error}-{bg,text,border}` ตั้งที่ `:root` หรือ container ใดก็ได้ (ไม่ต้องสู้ specificity กับ sonner)

### Fixed
- **`AppToaster` สี richColors เป็น inline style ทับ CSS ที่แอปปรับสี toast เองทุกกรณี** → ย้ายไปเป็นกฎใน `styles.css` ที่คลาส `app-toaster` · ไม่แทนที่ `style` ของ `components/ui/sonner.tsx` อีก (เลิกคัดลอก `--normal-*` มาไว้สองที่) · `style` ที่ส่งให้ AppToaster ส่งต่อตรง ๆ เหมือน Toaster
- **เส้นขอบ toast ค้างค่าจาก `:root`** เมื่อแอปเปลี่ยน `--success-border` ฯลฯ ใน scope อื่น (คลาสธีมที่ body, data-brand) → เก็บค่าของ token ที่ section ที่ครอบ toaster แทน alias ที่ `:root`/`.dark` (ลบ `--toast-*-border` ที่ประกาศไว้ใน 0.113.3 — ชื่อนี้กลายเป็นตัวแปรให้แอปปรับแทน)
- **`AppToaster` ไม่มี ThemeProvider อ่านธีมจาก class ของ `<html>` อย่างเดียว** → รู้จัก `data-theme="dark|light"` และธีมที่ `<body>` ด้วย · มี ThemeProvider = ไม่สร้าง MutationObserver เฝ้า DOM อีก
- **`UsageMeter compact` อ่านชื่อแถบซ้ำ** (ชื่อ meter + ข้อความ sr-only ในแถว) → span ชื่อที่ซ่อนอยู่เป็น `aria-hidden` (ยังเป็นชื่อ meter ผ่าน labelledby)
- **`ThemeProvider` สร้าง `scriptProps` ใหม่ทุก render** จน memo ของสคริปต์ next-themes ไม่ทำงาน → ค่าคงที่ / `useMemo`
- เทสต์ AppToaster คืนค่า class/attribute ของ html/body และ provider ใน `afterEach` · เทสต์ ThemeProvider คืน `window.matchMedia`
- docs: `agent-rules.md` — `data-surface="destructive"` และตัวแปร `--toast-*`

## [0.115.0] — 2026-11-12

supplychain ขอ (เจ้าของเลือก: QR ด้วย lib เล็ก, อยู่ที่ `@suphark/ui/pwa`):

### Added
- **`ChatLinkRow`** (`@suphark/ui/pwa`) — แถวตั้งค่าผูก Telegram/LINE ของผู้ใช้กับ Pi Notify คู่กับ `WebPushRow`: แถวต่อช่องทาง (`channels` ค่าเริ่มต้น Telegram แล้ว LINE) สถานะ "ผูกแล้ว · ชื่อบัญชี" + ลิงก์ "จัดการที่ Pi Notify" (`manageUrl`) / "พักไว้" (`paused`) + ปุ่มผูกใหม่ / ยังไม่ผูก + ปุ่มผูก · `onUnlink` (ไม่บังคับ) = ปุ่ม "ยกเลิกการผูก" + กล่องยืนยัน (พักไว้จากทุกแอป ไม่ลบ — ตกลงกับ Pi Notify) · กดผูก = `onCreateLink(channel)` → เปิดแท็บใหม่ + กล่องคำแนะนำ (ปุ่มเปิดแอปเมื่อแท็บโดนบล็อก, QR บนจอใหญ่, ข้อความให้พิมพ์เอง + ปุ่มคัดลอก — ค่าเริ่มต้น `/start {code}` / `ผูก Pi Notify {code}` หรือ `command`/`botName` จาก server) → โพล `getStatus` ทุก `pollInterval` (3 วิ) ทีละครั้ง ข้ามรอบเมื่อแท็บถูกซ่อน ตรวจทันทีเมื่อกลับมาที่แท็บ จนผูกสำเร็จ (toast + `onLinked`) หรือถึง `expiresAt` (ปุ่มสร้างลิงก์ใหม่) · shape ตรงกับ `createChatLinkHandlers` ของ `@suphark/notify` 0.11.0 (`getStatus`/`createLink`/`unlink`) · ข้อความ `CHAT_LINK_ROW_TEXT_TH`/`_EN` เป็น string ล้วน (ส่งจาก server component ได้) ทับบางส่วนด้วย `text`
- dependency `uqr` (MIT, ไม่มี dependency ต่อ) สร้าง QR — โหลดแบบ dynamic import เมื่อกล่อง QR แสดงเท่านั้น
- docs: `agent-rules.md` แถว "ผูก Telegram/LINE กับ Pi Notify" ในตารางใช้ตัวสำเร็จรูปก่อน
- showcase: หน้า `/components/chat-link-row` (จำลอง Pi Notify — LINE ผูกสำเร็จเองหลัง ~8 วินาที)

## [0.114.0] — 2026-11-11

Pi Notify รายงานระหว่างย้ายมา 0.113.3 + redesign คอนโซล:

### Added
- `UsageMeter showLabel` — โหมด `compact` แสดง `label` หน้าตัวเลขใต้แถบ สำหรับวางหลายแถบซ้อนกัน ("วันนี้" / "เดือนนี้") · ค่าเริ่มต้นไม่แสดงเหมือนเดิม

### Fixed
- **`UsageMeter compact` ที่ `label` เป็น ReactNode ไม่มีชื่อสำหรับโปรแกรมอ่านจอ** (เดิมใช้ `aria-label` ได้เฉพาะ string) → ชื่อผ่าน `aria-labelledby` เสมอ (compact ที่ไม่แสดง label มี span `sr-only`)
- **`ThemeProvider` เตือน "Encountered a script tag while rendering React component"** เมื่อ client render สคริปต์กันกระพริบของ next-themes เอง (React 19) → บน client ตั้ง `type="text/plain"` (สคริปต์ที่ client สร้างไม่ทำงานอยู่แล้ว) บน server ยังเป็นสคริปต์ปกติ · `scriptProps` ที่ส่งเองยังทับได้
- docs: `agent-rules.md` — ค่าคงที่ที่ server component import ห้ามอยู่ในไฟล์ `"use client"` (ได้ client reference ไม่ใช่ค่า)
- showcase: หน้า `usage-meter` ตัวอย่าง compact หลายแถบด้วย `showLabel`

## [0.113.3] — 2026-11-11

DueBell รายงานระหว่างย้ายมา 0.113.2 (วัดจากหน้าจริง):

### Fixed
- **`AppToaster` ไม่มี `ThemeProvider` แล้วธีมตามระบบแทนธีมของแอป** — แอปที่สลับธีมด้วย class `.light`/`.dark` ที่ `<html>` เอง (เช่น DueBell ผ่าน SettingsProvider) ได้ `theme="system"` จาก next-themes → ไม่มี provider อ่านธีมจาก class ของ `<html>` และตามเมื่อเปลี่ยน · มี provider ทำงานเหมือนเดิม · ส่ง `theme` เองได้เสมอ
- **`AppToaster richColors` ธีมสว่างไม่ผ่าน AA** (toast สำเร็จ 4.26:1 ด้วยสีตั้งต้นของ sonner) → ใช้ token โทนของแพ็กเกจ พื้น `*-subtle` + ตัวหนังสือ `*-subtle-foreground` + เส้นขอบ `*-border`: สว่าง 6.84–7.64:1, มืด 10.44–12.05:1 · `styles.css` เพิ่ม `--toast-success-border`/`--toast-info-border`/`--toast-warning-border` (ชื่อ `--success-border` ฯลฯ ของ sonner ชนกับ token ของแพ็กเกจ อ้างตัวเองไม่ได้) · `style` ที่ส่งให้ `AppToaster` รวมทับเฉพาะตัวแปรที่ส่ง
- **ปุ่ม `variant="destructive"` ใน `DangerZone` ธีมสว่าง 4.46:1** (พื้นจาง bg-destructive/10 ซ้อนพื้นแดงอ่อนของโซน) → ในโซนนี้ตัวหนังสือใช้ `--destructive-subtle-foreground`: สว่าง 6.70:1, มืด 9.88:1
- docs: `agent-rules.md` — ของลอยที่แอปเขียนเอง (แบนเนอร์ติดตั้ง ฯลฯ) ใช้ไม่เกิน `z-40` ไม่งั้นบังแผ่นล่างของ `sheetOnMobile` (`z-50`) · AppToaster อ่านธีมจาก `<html>` + richColors ผ่าน AA

## [0.113.2] — 2026-11-10

เจ้าของลอง 0.113.1 บนมือถือจริง (เช็กลิสต์ข้อ 1):

### Fixed
- **`SwipeableRow` ปัดขวายาว ๆ เห็นปุ่ม "ลบ"** — กลุ่มปุ่มสองฝั่งวางซ้อนอยู่ใต้แถว กลุ่มขวา (ลบ/เก็บ) วาดทีหลังจึงทับกลุ่ม "เสร็จ" ที่ขยายตามนิ้วเมื่อปัดเกินความกว้างแถวลบด้วยกลุ่มขวา → แสดงเฉพาะกลุ่มของฝั่งที่เปิด (คงไว้ระหว่างแถวเด้งกลับ) แถวปิดอยู่ = ซ่อนทั้งสองฝั่ง
- **`SwipeableRow` ปัดเร็ว ๆ แล้วแตะ "ยกเลิก" ในแผ่นยืนยันไม่ติด** — เบราว์เซอร์นับการปัดแนวนอนเร็ว ๆ เป็นการเลื่อนแบบเหวี่ยง (fling) แล้วใช้การแตะครั้งถัดไปภายใน ~1 วินาทีหยุดแรงเหวี่ยงแทนการกดปุ่ม (ปัดช้าไม่เป็น) → เมื่อตัดสินว่าเป็นการปัดแนวนอนแล้ว `touchmove` ถูก `preventDefault` (ผูกแบบ non-passive) การสัมผัสนี้เป็นของแถวทั้งหมด · การเลื่อนหน้าแนวตั้งยังเป็นของเบราว์เซอร์เหมือนเดิม
- showcase: `interact:showcase` ชุด SwipeableRow ปัดขวายาว ๆ ไม่เห็นปุ่มลบ และปัดซ้ายเร็ว ๆ แล้วแตะ "ยกเลิก" ครั้งเดียวปิด (กล่องกลางจอ + แผ่นล่าง)

## [0.113.1] — 2026-11-10

เจ้าของลองบนมือถือจริงตามเช็กลิสต์:

### Fixed
- **`SwipeableRow` ปัดครั้งเดียวข้ามไปอีกฝั่งได้** — ปัดขวา ("เสร็จ") แล้วลากนิ้วย้อนไปซ้ายมาก ๆ ในครั้งเดียว แถวเลยจุดกลางไปเปิดฝั่ง "ลบ" (เลย 40% = สั่งคำสั่งแรกของฝั่งนั้นทันที) → ล็อกฝั่งตามที่เริ่มปัด (หรือฝั่งที่เปิดอยู่) ย้อนได้แค่ถึงจุดกลาง จะเปิดอีกฝั่งต้องยกนิ้วแล้วปัดใหม่

### Changed
- **`Lightbox` บนมือถือแสดงปุ่มก่อนหน้า/ถัดไปและแถบรูปย่อ** (เดิมซ่อนบนจอ < 640px ให้ปัดแทน — ไม่รู้ว่ามีรูปอื่น และข้ามไปรูปไกล ๆ ไม่ได้) · แถบรูปย่อเลื่อนซ้ายขวาได้เมื่อรูปเยอะ (`justify-center-safe` — รูปแรก ๆ ไม่ถูกตัด) และเลื่อนรูปที่ดูอยู่เข้ามาในแถบเอง · พื้นหลังทึบขึ้น (ดำ 95% จาก 90%) หน้าด้านหลังไม่แทรกตัวนับ/รูปย่อ
- showcase: `interact:showcase` ชุด SwipeableRow ปัดขวาแล้วย้อนซ้าย และ Lightbox แตะลูกศร/รูปย่อบนมือถือ

## [0.113.0] — 2026-11-10

### Added
- **`VersionHistory` `items[].icon`** — ไอคอนแทน avatar (เช่น `FileTypeIcon`) · ไม่ส่งและไม่มี `actor` = ไอคอนประวัติ (`ActionHistory`) แทนวงตัวย่อ "?" — ระบบที่เก็บแค่ id ผู้บันทึก (Pi Files) ทุกแถวเคยเป็น "?" (คำขอจาก session Pi Files หลังย้ายมา 0.112.0)
- showcase: ตัวอย่าง `version-history` มีรุ่นที่ไม่มีชื่อผู้บันทึก

## [0.112.0] — 2026-11-10

component ที่ Pi Files ยังต้องเขียนเองหลังย้ายมา 0.111.0 (คำขอจาก session supplychain):

### Fixed
- **`PullToRefresh` แบบแคปซูลไม่ลื่น** (เจ้าของลองบนมือถือจริง — แบบวงกลมลื่นดี): มี `transition-all 150ms` ตลอด ตำแหน่งจึงไหลตามหลังนิ้วทุกครั้งที่ขยับ, ขยับรวมแค่ 18px ทั้งการดึง (ดูไม่ตามนิ้ว), โผล่กระตุกจาก opacity 0→1 และ `backdrop-blur` วาดใหม่ทุกเฟรม → ระหว่างลากไม่มี transition (เหมือนแบบวงกลม) เลื่อนลงมาจากเหนือขอบตามระยะดึง opacity ตามระยะ พื้นทึบ · transition เฉพาะตอนปล่อย/หมุน · `interact:showcase` วัดตำแหน่งระหว่างลากด้วยนิ้วจำลอง
- `DataTable variant="quiet"` ลากเลือกด้วยนิ้ว: หาแถวจากทุกชั้นใต้นิ้ว (`elementsFromPoint`) — เดิมดูแค่ชั้นบนสุด นิ้วที่ยังอยู่ในแถบคำสั่งที่ลอยด้านล่าง (กดแถวชิดขอบล่างจอ) จึงไม่เลือกแถวใต้แถบ · showcase: `interact:showcase` วางแถวกลางจอก่อนลาก (หน้าสั้นลงแล้วแถวที่ 3 หลุดจอ) + ชุดกดแถวล่างจอ

### Added
- **`AsyncCombobox`** — เลือกหนึ่งค่าโดยค้นจาก server: `search(query, signal)` (debounce `debounceMs` 250, ยกเลิกคำค้นเก่าด้วย `AbortSignal`, ผลของคำล่าสุดเท่านั้นที่แสดง), สถานะกำลังค้น/ไม่พบ (`empty` รับฟังก์ชันของคำค้น)/ค้นไม่สำเร็จ + ปุ่มลองใหม่ ประกาศผ่านช่อง `role="status"` ที่อยู่ตลอด, `minQuery`, `selectedOption` (ชื่อของค่าเดิมจาก server), รายการมี `description`/`icon` · `onValueChange(value, option)` ได้ option เต็มตัว · UiText `combobox.loading/typeToSearch/searchFailed`
- **`DataRow` `onClick`** — กดได้ทั้งแถว (ชื่อเป็นปุ่ม ขยายพื้นที่กดเต็มแถว, ปุ่มใน `actions` ยังกดแยกได้) · **`selected`** = รายการเลือกได้ (`aria-pressed`, พื้นเน้น, เครื่องหมายถูก) · `disabled`
- **`RowTableSortHeader`** — หัวคอลัมน์ของ `RowTable` ที่กดเรียงได้: `sorted` (`"asc"`/`"desc"`/`false`) + `onSort`, `aria-sort` ที่ columnheader, ลูกศรบอกทิศ (คอลัมน์อื่นโผล่ตอนชี้), `align="end"`, `hideOnMobile`
- **`VersionHistory` `actions`** — ปุ่มเพิ่มต่อรุ่น (ดาวน์โหลด, ลบรุ่น) ต่อจากปุ่มกู้คืน ซ่อนระหว่างถามยืนยันกู้คืน
- **`FileCard` + `FileGrid`** — การ์ดไฟล์/โฟลเดอร์สำหรับมุมมองแบบตาราง: รูปย่อ (โหลดไม่ขึ้นกลับเป็นไอคอนตามชนิด, `thumbnailPosition="top"` สำหรับหน้า PDF, วิดีโอมีป้ายเล่น), ชื่อ, ขนาด (`formatBytes`), `meta`, `badge`, `onOpen`/`href`, ติ๊กเลือก (`selected` + `onSelectedChange`, Ctrl/⌘+คลิกสลับเลือก), `actions` มุมขวา, `nameSlot` (ช่องเปลี่ยนชื่อ) · `FileGrid` คอลัมน์ตามความกว้างที่มี (`minItemWidth`) · UiText `fileCard`
- **`TextButton`** — ปุ่มข้อความล้วนในบรรทัด ไม่มีกรอบ/พื้น/padding (`tone` default/primary/muted, `underline` hover/always/none) แทนการแก้ `Button` ที่ทุก variant มีความสูง/padding
- showcase: หน้าใหม่ `async-combobox`, `file-card`, `text-button` · `data-list` (แถวกดได้ + รายการเลือกได้), `row-table` (หัวกดเรียง), `version-history` (ปุ่มดาวน์โหลด/ลบรุ่น)
- showcase: หน้า `/components/pull-to-refresh` — `PullToRefresh` แบบแคปซูล/วงกลม กับกล่องรายการที่เป็น root, `onRefresh` จำลองดึงข้อมูล 1.2 วินาที · `pnpm interact:showcase` ชุด `pullToRefresh` ลองด้วยนิ้วจำลอง (ดึงพอ/ดึงสั้น/กล่องไม่อยู่บนสุด/วงกลม)
- showcase: ค้นหา component บนจอแคบ (< lg) — ไอคอนค้นหาในหัวที่ติดบน (กดได้ทุกตำแหน่งที่เลื่อน) + ช่องค้นหาเต็มกว้างบนหน้า /components แทน `<select>` 170 รายการ · ใช้ `CommandPalette` ของแพ็กเกจ ค้นจากชื่อ/slug/ชื่อ export/คำอธิบายเหมือนช่องค้นหาเดสก์ท็อป
- showcase: ผลค้นหา component ไม่แสดงป้ายหมวดท้ายแถว (ยาวจนชื่อถูกตัดบนมือถือ — ยังค้นด้วยชื่อหมวดได้) · หัวบนจอแคบกว่า 640px ซ่อนป้ายเวอร์ชัน (ชื่อถูกตัดเหลือ "@s…" เมื่อมีปุ่มค้นหา + รูปผู้ใช้)
- showcase: ตัวอย่าง `PullToRefresh` ใช้ flex + gap แทน `space-y-2` (กฎ audit space-utility)

## [0.111.0] — 2026-11-09

ลองการโต้ตอบจริงใน Chrome (เมาส์จริง, นิ้วจำลองผ่าน CDP, iPhone/Android UA) ครบรายการ "ต้องลองบนเครื่องสัมผัส" — เจอบั๊กที่ jsdom/smoke ไม่จับ:

### Fixed
- **`Lightbox` ดับเบิลคลิกด้วยเมาส์ไม่ซูม** — pointerup นับแตะสองครั้ง (ซูม) แล้ว dblclick สลับอีกที (ยกเลิก) → เมาส์ใช้ dblclick อย่างเดียว · **จอสัมผัส: ซูมอยู่แล้วแตะสองครั้งออกไม่ได้** (นับแตะเฉพาะตอนไม่ซูม — ปัดลงปิดกลายเป็นเลื่อนรูปที่ซูมอยู่)
- **`EventCalendar` ยืดเวลาด้วยนิ้วคลาด 15 นาที** — เวลาจบคิดจากตำแหน่งนิ้ว ที่จับบนจอสัมผัสสูง 16px จับกลาง = ขาดไปหนึ่งช่อง → นับจากระยะที่ลาก
- **`DataTable variant="quiet"` บนมือถือ: กดค้างเข้าโหมดเลือก แถวกระโดดลง 52px ใต้นิ้ว** (หัว "เลือก N รายการ · เลือกทั้งหมด" แทรกด้านบน — นิ้วไม่อยู่บนแถวที่กดแล้ว) → เลื่อนหน้าชดเชยในเฟรมเดียวกัน (ออกจากโหมดคืนกลับ) · ช่องประกาศจำนวนที่เลือกอยู่ตลอด (เดิมโผล่มาพร้อมข้อความ — โปรแกรมอ่านจอหลายตัวไม่อ่าน)

### Added
- **`DataTableRowActions` dev เตือนเมื่อกด "แก้ไข" แล้วไม่มีกล่องขึ้นใน 1 วินาที** (`EditDialog` ไม่ส่ง `open`/`onOpenChange` ต่อ) · เอกสาร `children`/`EditDialog`: ห้ามวางกล่องในเมนู — รายการเมนูเปิด state แล้ววางกล่อง controlled นอกเมนู (รายงานจาก supplychain)
- **`suphark-ui-audit` กฎ `menu-item-trigger`** (error) — `<DialogTrigger|AlertDialogTrigger|SheetTrigger|DrawerTrigger|PopoverTrigger render={<DropdownMenuItem …/>}>` · กติกาใน `docs/agent-rules.md`
- `pnpm interact:showcase` (`scripts/interact-showcase.mjs`) — 24 การโต้ตอบจริงใน Chrome หลัง build (ไม่อยู่ใน tarball)
- **component ที่ supplychain ขอ** (แอปเขียนซ้ำเอง):
  - `ZoomControls` + `clampZoom` — ปุ่มซูมพรีวิว − / ระดับ (กด = รีเซ็ต) / + มี `min`/`max`/`step`/`resetValue`
  - `StepIndicator` — แถบขั้นตอน wizard ฝั่ง client (`onStepChange`, ย้อนได้ ข้ามหน้าไม่ได้ เว้น `allowSkipAhead`, สถานะ done/current/pending/error, แนวนอน/แนวตั้ง, จอแคบแสดงชื่อเฉพาะขั้นปัจจุบัน) — ขั้นที่เป็นหน้า URL ยังใช้ `Stepper` ของ `/next`
  - `ResourcePermissionMatrix` — สิทธิ์ของบทบาทเดียว ทรัพยากร × การกระทำ: ติ๊กทั้งแถว/คอลัมน์ (สามสถานะ), หัวติดบน + ชื่อติดซ้าย (`maxHeight`), ช่องที่ใช้ไม่ได้ (`resources[].actions`), `baseline` ไฮไลต์, `getPermissionId`, `name` input ซ่อน
  - `SearchTrigger` + `useModKeyLabel` — ปุ่มหน้าตาช่องค้นหา + Kbd (⌘/Ctrl ตามเครื่อง) · `CommandPalette` ใช้ตัวนี้แทนปุ่มของตัวเอง (หน้าตาเดิม; Kbd ซ่อนจาก screen reader)
  - `StageFilterBar` `items[].color` (จุดสีหน้าป้าย) + `tone` `info`/`warning`/`danger`/`neutral`
  - `SimpleTable selectionMode="single"` — ปุ่มเลือกกลม (radio จริง ลูกศรเลื่อนในกลุ่ม), คลิกแถวเลือกเมื่อไม่มี `onRowClick`, มือถือ quiet แตะแถวเลือก
  - `UiText`: `zoom`, `stepIndicator`, `permissionMatrix.resource/allRow/allColumn/notApplicable`
  - showcase: `zoom-controls`, `step-indicator`, `resource-permission-matrix`, `search-trigger` · `stage-filter-bar` แถบสถานะยูนิตมีจุดสี · `simple-table` ตารางเลือกแถวเดียว

## [0.110.0] — 2026-11-09

### Added
- **`PdfPreview` ตามความสามารถของเบราว์เซอร์** — iOS/iPadOS (iframe เห็นแค่หน้าแรก) มีแถบล่าง "แสดงเฉพาะหน้าแรก · เปิดทั้งเอกสาร" · ไม่มีตัวดู PDF ในตัว (`navigator.pdfViewerEnabled === false` เช่น Android Chrome) ไม่ใส่ iframe (กันดาวน์โหลดเอง) แสดงปุ่ม "เปิด PDF" แทน · prop `inlineSupport` ทับผลตรวจ · `detectPdfInlineSupport()`, type `PdfInlineSupport` · `UiText.pdfPreview`: `firstPageOnly`, `openFull`, `unsupported`, `open`
- **`EventCalendar` ยืดเวลาจบบนจอสัมผัส** — ที่จับขอบล่างสูงขึ้นและมีขีดให้เห็นบนจอสัมผัส (กล่องสูง ≥ 40px) ลากได้ทันทีไม่เลื่อนหน้า · **คีย์บอร์ด Alt+Shift+ขึ้น/ลง** ยืด/หดทีละ 15 นาที + ประกาศ (`UiText.eventCalendar.resized`)
- `ExportJobsPanel` props `error`, `onRetry` · `WebPushRow` prop `unavailableDescription` · `UiText.exportJobs`: `retry`, `announceReady`, `announceFailed`
- showcase: `pdf-preview` สลับจำลอง iOS / ไม่มีตัวดู PDF

### Fixed (จากรีวิวโค้ด 0.107–0.109)
- **`EventCalendar` ลากในมุมมองเดือน/แถวทั้งวันวางไม่ได้เมื่อตัวชี้อยู่บนแถบกิจกรรม** (รวมแถบที่กำลังลากเอง) — หาช่องวันจากทุกชั้นใต้ตัวชี้ (`elementsFromPoint`)
- **`EventCalendar` ลากแล้วเลื่อนเท่าระยะที่ลาก** — เดิมวันเริ่มไปอยู่ที่จุดวาง: จับแถบ 5 วันที่วันที่ 4 แล้ววางวันถัดไป = เลื่อน 4 วัน, ส่วนวันที่ 2 ของกิจกรรมข้ามคืนขยับนิดเดียวก็ย้าย 22:00 → 00:00 · วางที่เดิม = ไม่เรียก `onEventMove` (เดิมปัดเวลาที่ไม่ลง 15 นาทีให้เงียบ ๆ)
- **`EventCalendar` ยืดกิจกรรมข้ามคืน** — เดิมเวลาจบผิดวัน (ลากส่วนวันที่ 2 ไป 03:00 ได้ 22:15 ของวันแรก) · ที่จับอยู่เฉพาะส่วนของวันจบ
- **`EventCalendar` แอปไม่รับการย้ายจากคีย์บอร์ด** แล้วกด "ถัดไป" ปฏิทินดึงกลับไปช่วงเดิม · Alt+ลงที่ 23:50 ถอยไป 23:45, Alt+ขึ้นที่ 00:00 เรียก `onEventMove` ค่าเดิม → ชนขอบวันไม่ขยับ · Alt+ซ้ายบนกิจกรรมกันย้อนหน้าเบราว์เซอร์เสมอ
- **`EventCalendar` hydration ไม่ตรงเมื่อโซนเวลา server ≠ ผู้ใช้** (Vercel UTC, ผู้ใช้ UTC+7) — วาดกิจกรรมหลัง hydrate (ตารางวันยังวาดจาก server)
- **`EventCalendar` "+N" เมื่อไม่มีมุมมอง `day`** แค่เปลี่ยนวันที่ ดูรายการที่ซ่อนไม่ได้ → ขยายแถวสัปดาห์นั้น + ปุ่ม "ย่อ"
- `EventCalendar` วันเปลี่ยนเวลาฤดูร้อน (โซนที่มี DST) วางกิจกรรมคลาดชั่วโมง → นับนาทีตามนาฬิกา · Esc ระหว่างลาก/ยืดไม่ปิด Dialog ที่ครอบ · ถอด component กลางการลากไม่ทิ้ง listener ค้าง
- **`ExportJobsButton` คำตอบรอบเก่าที่มาช้าทับรายการใหม่** (งานที่เพิ่งลบโผล่กลับ, งานใหม่หายจนหยุด poll) → ใช้ผลของคำขอล่าสุดเท่านั้น และรอบจับเวลาไม่ซ้อนเมื่อ `load` ช้ากว่า `pollMs` · โหลดครั้งแรกล้มแสดง "ยังไม่มีงาน" → ข้อความผิดพลาด + ลองใหม่ · ลบงานสุดท้ายโฟกัสไปปุ่มปิดกล่อง · งานเสร็จ/ล้มเหลวประกาศให้ screen reader
- **`focusAfterRemove`/`focusAfterDismiss` รอปุ่มหายนานสุด 10 วินาที** (เดิมดูแค่เฟรมถัดไป — แอปที่ลบหลังรอ server โฟกัสหลุดไป body; กระทบ ExportJobs, ลองใหม่ในแถวผิดพลาดของ DataTable, Banner/Notice/SelectionBar ฯลฯ) และไม่แย่งโฟกัสถ้าผู้ใช้ย้ายไปที่อื่นแล้ว
- **`useLongPress`** (SimpleTable/DataTable กดค้าง) — ธง "เพิ่งกดค้าง" ค้างจนกลืน click จากคีย์บอร์ดครั้งถัดไป → หมดอายุ 400ms หลังยกนิ้ว · ปุ่มขวา/กลางของเมาส์ไม่นับ · กันเมนูกดค้างของ Android ระหว่างรอด้วย
- `safeFileName` ตัด emoji ครึ่งตัว (`encodeURIComponent` throw) · ตัดอักขระควบคุม, จุด/ช่องว่างท้าย · ชื่ออุปกรณ์ Windows (`CON`, `NUL` …) เติม `_`
- `PdfExportButton` ระหว่างสร้างโฟกัสหลุดไป body → โฟกัสอยู่ที่ปุ่ม (`focusableWhenDisabled`) · `PdfPreview` ช่องประกาศสถานะอยู่ตลอด (โปรแกรมอ่านจออ่าน) และเลิกหมุน "กำลังโหลด" หลัง 10 วินาทีถ้า iframe ไม่ยิง load
- `usePushSubscription` ถอนของเก่าแล้วบันทึกของใหม่ล้ม = สถานะเป็นปิด (เดิมค้าง "ต้องเปิดใหม่") · ผลตรวจตอนเปิดหน้าที่มาช้าไม่ทับสถานะหลังผู้ใช้กด · `WebPushRow` บอกเมื่อดึง key ไม่ได้

## [0.109.0] — 2026-11-09

### Added
- **`EventCalendar` ย้ายบนจอสัมผัส** — กดค้าง 350ms แล้วลาก (ขยับก่อนครบ = เลื่อนหน้าตามปกติ) ระหว่างลากหยุดเลื่อนหน้า · กันเมนูกดค้างของเบราว์เซอร์
- **`EventCalendar` ย้ายด้วยคีย์บอร์ด** — Alt+ซ้าย/ขวา = วัน, Alt+ขึ้น/ลง = สัปดาห์ (เดือน) หรือ 15 นาที (ตารางเวลา) · โฟกัสตามกิจกรรมไปที่ใหม่ (ออกนอกช่วงที่แสดง = เลื่อนช่วงไปหา) และประกาศ "ย้าย … ไป …" ให้ screen reader
- **`EventCalendar onEventResize`** — ลากขอบล่างของกิจกรรมในตารางเวลาเพื่อยืดเวลาจบ (เมาส์/ปากกา, ปัด 15 นาที, ไม่สั้นกว่า 15 นาที, Esc ยกเลิก) แสดงความยาวใหม่ระหว่างลาก
- **`EventCalendar` มุมมอง `3days` และ `2months`** (เปิดผ่าน `views`) · `UiText.eventCalendar`: `3days`, `2months`, `moved`, `resize`
- showcase: `event-calendar` เปิดทุกมุมมอง + ยืดเวลาจบ

### Fixed
- **`DataTable onReorder`/`virtualized` บน Next production** — ส่วนที่โหลดแบบ lazy ถูก render บน server แล้วสตรีมเป็นชิ้นแยก ชิ้นนั้นค้างใน DOM เป็น `<div hidden id="S:0">` (ตารางซ้ำทั้งตาราง ซ่อนอยู่) → สร้างส่วน lazy หลัง hydrate เท่านั้น server ได้ตารางปกติ (พบตอนตรวจ 0.108.0 บน ui.suphark.com)

## [0.108.0] — 2026-11-09

ตัวใหญ่ที่เหลือจาก "ทำเมื่อมีแอปขอ" (เจ้าของสั่ง "ทำทุกอย่าง") — รวมของ 0.107.0 ที่ยังไม่ได้ publish

### Added
- **`EventCalendar`** (`components/event-calendar/`) — ปฏิทินกิจกรรม 4 มุมมอง: เดือน (แถบหลายวันจัดเลน, เกิน `maxLanes` เป็น "+N" แตะแล้วไปมุมมองวัน), สัปดาห์/วัน (ตารางเวลา, แถวทั้งวันพับ/ขยาย, กิจกรรมทับเวลาแบ่งคอลัมน์, เส้นเวลาปัจจุบัน, เลื่อนไปชั่วโมงทำงาน), รายการ (ตามวัน) · `onEventClick`, `onDateClick` (วันว่าง/ช่วงเวลา 30 นาที), `onEventMove` (ลากด้วยเมาส์/ปากกา ปัด 15 นาที, Esc ยกเลิก — จอสัมผัสยังไม่รองรับ), `renderEvent`, `renderDayExtra`, `weekStartsOn`, `locale` · วันที่ `"YYYY-MM-DD"` = ทั้งวันเวลาท้องถิ่น · ยกรูปแบบจาก Pi Done / supplychain (ยังไม่มีมุมมอง 3 วัน/2 เดือน และการยืดเวลาจบ)
- **`PdfExportButton`** (ยกจาก supplychain props เดิม) — ปุ่มสร้าง PDF + เมนูตัวอย่างก่อนพิมพ์/พิมพ์/การย่อขยาย/`menuItems` · ข้อความจาก `UiText.pdfExport` ทับรายปุ่มด้วย `labels`
- **`PdfPreview`** (ยกจาก supplychain `PdfRenderedPreview`) — PDF ใน iframe + สถานะกำลังสร้าง/อัปเดต/ผิดพลาด + เปิดในแท็บใหม่ · `withPdfViewParams`, `safeFileName` (`lib/pdf.ts`)
- **`Lightbox` แสดง PDF** ด้วยตัวดูของเบราว์เซอร์ + ปุ่มเปิดในแท็บใหม่ · ปุ่มก่อนหน้า/ถัดไปแสดงบนมือถือเมื่อเป็น PDF (iframe กินการปัด)
- **`ExportJobsPanel` + `ExportJobsButton`** (ยกจาก supplychain หน้า audit) — สถานะ รอคิว/กำลังทำ/พร้อมดาวน์โหลด/ล้มเหลว/หมดอายุ (ตัวพิมพ์ใหญ่จาก Prisma ได้), ความคืบหน้า, ขนาดไฟล์, วันหมดอายุ, ลบ (โฟกัสไปงานถัดไป) · ปุ่มนับงานค้าง/พร้อม และโหลดซ้ำทุก `pollMs` ระหว่างเปิดหรือมีงานค้าง (โหลดล้มแจ้งครั้งเดียว)
- **`UiText`**: `eventCalendar`, `pdfExport`, `pdfPreview`, `exportJobs`, `lightbox.openInNewTab`
- เทสต์: `DateRangePicker` คีย์บอร์ดล้มเฉพาะเมื่อวันนี้คือวันที่ 9 ของเดือน (เทสต์ `.focus()` วันที่ 10 แต่ปฏิทินถือว่าโฟกัสวันนี้ ลูกศรขวาจึงไปวันที่ 10 พอดี) → เริ่มจากวันที่ปฏิทินโฟกัสจริง · คอมโพเนนต์ไม่เปลี่ยน
- showcase: หน้า `event-calendar`, `pdf-export-button`, `pdf-preview`, `export-jobs` · `lightbox` เปิด PDF ตัวอย่างจริง (`public/sample-quotation.pdf`)

## [0.107.0] — 2026-11-06

ชุดสุดท้ายจาก "ทำเมื่อมีแอปขอ" ที่ทำได้โดยไม่ต้องมี mockup

### Added
- **`Prose`** (จาก Pi Auth docs) — เนื้อหาแบบยาว จัดหัวข้อ รายการ ลิงก์ ตาราง โค้ด รูป จาก token ของธีม ไม่ต้องติดตั้ง `@tailwindcss/typography` · `not-prose` ไม่รับสไตล์ · ย่อทั้งก้อนด้วย `className="text-sm"` · กล่องเน้นข้อความใช้ `Notice` ที่มีอยู่
- **`DataTable getRowError` + `onRowRetry`** — ข้อผิดพลาดรายแถว: พื้นแดง + ข้อความใต้เซลล์เนื้อหาแรก + ปุ่มลองใหม่ ใช้ได้ทั้งแถวปกติ แถวลากเรียง ตารางเสมือน และรายการมือถือ
- **`useLongPress`** — hook กดค้างที่แยกจาก `DataTable` ให้แอปและ `SimpleTable` ใช้ร่วม มี `ignore` ไม่นับจุดที่เป็นปุ่ม/ช่องติ๊ก
- **`SimpleTable` กดค้างเลือกหมู่** ในรายการมือถือของ `quiet`: กดค้างเริ่มเลือก ระหว่างเลือกแตะแถว = สลับการเลือก (แทน `onRowClick`) ช่องติ๊กยังแสดงเหมือนเดิม ไม่มีลากเลือกต่อเนื่องแบบ `DataTable`
- **`DataTable` แก้ค่าในเซลล์ในแถวลากเรียง** — `meta.editable` ใช้ร่วมกับ `onReorder` ได้แล้ว (เดิมแถวลากเรียงไม่สนใจ `editable`)
- **`WebPushRow` เตือนเมื่อ subscription เก่า** — สร้างด้วย key เก่า (รับอะไรไม่ได้แล้ว): สวิตช์ปิดและขึ้น `renewDescription` · ใช้ `usePushSubscription` แทนโค้ดเดิม
- **`UiText`**: `carousel`, `messageScroller`
- showcase: หน้า `/components/prose`, `data-table-row-error`

### Changed
- **`CarouselPrevious`/`CarouselNext`/`AttachmentAction`/`MessageScrollerButton`** จาก barrel เป็นตัวห่อใน `shared/labeled-icon-buttons.tsx` ชื่อและ props เดิม: มี tooltip และชื่อปุ่มตาม `UiText` (ของเดิมอังกฤษตายตัว)
- **`WebPushRow`** — ดึง `getPublicKey` ตอนเปิดหน้าเพื่อตรวจ key (เดิมดึงตอนกดสวิตช์) · สวิตช์ปิดการใช้งานระหว่างตรวจ
- **`usePushSubscription.turnOn`** — key ไม่พร้อมตอนเปิดหน้าจะดึงใหม่ ถ้ายังไม่ได้โยน error (เดิมเงียบ) · แทน subscription เดิมแล้วแจ้ง `onUnsubscribe` ด้วย endpoint เก่า

### Fixed
- **`usePushSubscription`** — `getPublicKey` ล้มตอนเปิดหน้าเป็น unhandled rejection → จับแล้ว `available` เป็น false
- **`Banner`/`Notice`/`SelectionBar`** — ปิดแล้วโฟกัสหลุดกลับต้นหน้า → ย้ายไปตัวถัดไปตามลำดับ Tab ผ่าน `focusAfterDismiss` (`lib/focus-after-remove.ts`)

## [0.106.1] — 2026-11-06

พบตอนลองของจริงบน production หลัง publish 0.106.0

### Fixed
- **`LocaleToggle`** — ชื่อปุ่มสำหรับ screen reader เดิมเป็น "เปลี่ยนภาษา" ทับชื่อภาษาที่ตาเห็น (ไม่รู้ว่าจะเปลี่ยนไปภาษาอะไร และสั่งด้วยเสียงว่า "English" ไม่ได้) และ `lang` อยู่ที่ทั้งปุ่ม คำไทยจึงถูกอ่านด้วยเสียงอังกฤษ → ชื่อเป็น "เปลี่ยนภาษา: English" และ `lang` อยู่ที่ชื่อภาษาเท่านั้น
- **`SecretReveal`** — กด "แสดงอีกครั้ง" หรือค่าถูกซ่อนเองตอนโฟกัสอยู่ที่ปุ่มคัดลอก โฟกัสหลุดกลับต้นหน้า → ย้ายไปปุ่มแรกของเนื้อหาใหม่ · ถ้าโฟกัสอยู่นอกกล่อง ซ่อนเองโดยไม่แย่งโฟกัส

## [0.106.0] — 2026-11-06

งานชุดที่สองจาก "ทำเมื่อมีแอปขอ" (เจ้าของสั่ง 2026-11-06)

### Added
- **`BreadcrumbLabel`, `BreadcrumbLabelsProvider`** (`@suphark/ui/next`, ยกจาก Pi Config) — หน้าประกาศชื่อจริงของ segment ให้ `HeaderBreadcrumbs` (`<BreadcrumbLabel href={`/projects/${slug}`} label={project.name} />`) ไม่ต้อง query ซ้ำใน layout · `AppShell` ใส่ provider ให้เอง · ชนะ `labels` และแสดงแม้ `hideIds`
- **`HostedAuthDialog`** (ยกจาก Pi PDF) — หน้าของ Pi Auth ใน dialog ผ่าน iframe เชื่อข้อความจาก `authOrigin` เท่านั้น
- **`LocaleToggle`** (ยกจาก Pi Auth/Config) — ปุ่มสลับภาษาแบบวนรอบ ไม่ผูก next-intl: `locale`, `onChange`, `locales`, `labels`, `loading`
- **`parseUserAgent`** (ยกจาก Pi Auth) — เบราว์เซอร์/ระบบปฏิบัติการสำหรับรายการอุปกรณ์ · รู้จัก Edge บน iOS/Android เพิ่มจากของเดิม
- **`usePushSubscription`, `urlBase64ToBytes`, `subscriptionUsesKey`** (`@suphark/ui/pwa`, ยกจาก DueBell/Pi Done ที่เขียนซ้ำกัน) — สถานะ `supported`/`available`/`enabled`/`needsRenewal` + `turnOn`/`turnOff` สำหรับ UI ของแอปเอง · บันทึกที่ server ล้มเหลวถอน subscription ของเบราว์เซอร์ให้
- **`SecretReveal autoHideMs`, `hideOnTabSwitch`** — ซ่อนค่าลับเอง "แสดงอีกครั้ง" กลับมาได้
- showcase: หน้า `/components/direction`, `locale-toggle`, `hosted-auth-dialog` · `/shell/users` ใช้ `BreadcrumbLabel` · `secret-reveal` ตัวอย่างซ่อนเอง

### Fixed
- เทสต์ `lazy-drawer` ล้มเป็นบางครั้ง: สาเหตุจริงคือเทสต์ปิด/เปิดกล่องใหม่ก่อน Drawer โหลดเสร็จ (`loads` นับตอนเริ่มโหลด) ไม่ใช่เครื่องช้าอย่างที่จดไว้ใน 0.103.2 — ขยายเวลาไม่ช่วย แก้ให้รอโหลดเสร็จจริง · พฤติกรรมของแพ็กเกจไม่เปลี่ยน (เปิดอยู่ไม่สลับรูป เปิดรอบหน้าเป็นแผ่นล่าง)

## [0.105.0] — 2026-11-06

งานในรายการ "ทำเมื่อมีแอปขอ" (เจ้าของสั่ง 2026-11-06 ทำโดยไม่ต้องรอแอปขอ) — ยกจากโค้ดจริงของแอป

### Added
- **`submitOnEnter(submit)`** (ยกจาก Pi PDF 14 จุด) — `onKeyDown` ที่กด Enter แล้วบันทึกและกิน event: Enter ยืนยันคำระหว่างผสมคำ (IME) ไม่ส่งฟอร์ม, ปิด dialog แล้วเบราว์เซอร์ไม่กดปุ่มที่โฟกัสกลับไปซ้ำ, `submit` คืน `false` = ยังไม่ส่ง
- **`isTypingTarget(target)`** (Pi PDF) — `useHotkeys` ใช้ตัวเดียวกัน
- **`useDisclosure`** (DueBell) · **`useElementSize`** (Pi PDF)
- **`toastActionError(error, fallback, options?)`** (DueBell 13 จุด) — แทน `toast.error(err.message)`: ไม่แสดง `redirect()`/`notFound()` ของ Next, error ที่ดูเหมือน session หมดถาม `/auth/session` ซ้ำ หมดจริงแจ้งแล้วพาไปหน้าเข้าสู่ระบบและกลับหน้าเดิม ยังอยู่แสดง fallback แทนข้อความอังกฤษ · เน็ตล่ม/เซิร์ฟเวอร์พังไม่เด้งผู้ใช้ออก
- **`Sparkline`** (DueBell) — เส้นแนวโน้มในแถวรายการ `values` (null = เว้น), `tone`, `label` ใช้ใน server component ได้
- **`SimpleBreadcrumb`** — เส้นทางหน้าจาก array, `maxItems` ยุบตรงกลาง, `linkComponent` · UiText `breadcrumb.label`
- **`SimpleDrawer`** — แผ่นล่างปัดปิดได้ props เดียวกับ `SimpleDialog` (Drawer โหลดเมื่อใช้)
- **`SimpleHoverCard`** — การ์ดเมื่อชี้/โฟกัส แทน HoverCard 3 ชิ้น
- showcase: หน้า `/components/sparkline`, `app-utilities`, `simple-breadcrumb`, `simple-drawer`, `simple-hover-card`

### Fixed
- เทสต์โฟกัสหลังปุ่มหายไปครบ 4 จุดที่เหลือ: `UploadList`, มุมมองที่บันทึกของ `DataTable`, `ResourcePropertyFilter`, ช่องค้นหา `AppShell`

## [0.104.0] — 2026-11-05

### Added
- **`FormFieldMessage`, `ComboboxRoot` จาก `@suphark/ui`** (คำขอจาก supplychain: แอปเลิก import ลึกได้ครบ) — ชื่อใหม่ของ `FormMessage` ใน `components/ui/form` (ข้อความ error ใต้ช่องของ react-hook-form) และ `Combobox` ใน `components/ui/combobox` (root ของ primitive) ที่ export จาก barrel ไม่ได้เพราะชื่อชนกับ `FormMessage` ของ `shared/form-message` และ `Combobox` ของ `shared/combobox` · ของเดิมไม่เปลี่ยน path ลึกยังใช้ได้
- showcase: หน้า `form-fields`, `combobox` บอกชื่อทั้งสอง

## [0.103.2] — 2026-11-04

ไล่ตรวจทั้งแพ็กเกจหลัง supplychain เจอซ้ำ 2 ครั้ง (PinnedLinks, FormFieldImageUpload): ปุ่มลบ/ล้างหายไปพร้อมสิ่งที่ลบ โฟกัสหลุดไป body — ผู้ใช้คีย์บอร์ด/โปรแกรมอ่านจอกด Tab แล้วเริ่มใหม่จากบนสุดของหน้า

### Fixed
- **ปุ่มลบรายการ → โฟกัสไปรายการถัดไป** (รายการสุดท้าย → ก่อนหน้า): `ActiveFilterChips` (รวม "ล้างทั้งหมด"; ไม่เหลือชิป → ตัวควบคุมแรกของกล่องที่ครอบ), `KeyValueEditor`, `RuleBuilder` (ไม่เหลือ → ปุ่มเพิ่มเงื่อนไข), `UploadList` ปุ่มยกเลิก, ชิปตัวกรองของ `DataTable` (ไม่เหลือ → ตัวควบคุมแรกของแถบ), ปุ่มลบมุมมองของ `DataTable` (ไม่เหลือ → รายการแรกของแผง)
- **ปุ่ม X ล้างช่องกรอก → โฟกัสกลับช่องนั้น**: ช่องค้นหาของ `AppShell`, `IconPicker`, `ResourcePropertyFilter`, `DataTable` · ปุ่มล้างวันที่ของ `DatePicker`
- ยังไม่แก้ (ไม่มีเป้าหมายที่ชัด ตัวปิดหายทั้งกล่อง): ปุ่มปิด `Banner`/`Notice`, ปุ่มล้างของ `SelectionBar`
- เทสต์ `lazy-drawer` รอ Drawer 1s → 5s (หมดเวลาเมื่อเครื่องหนัก)

## [0.103.1] — 2026-11-03

### Fixed
- **`FormFieldImageUpload` ลบรูปแล้วโฟกัสไปปุ่ม "เลือกรูป"** (supplychain แจ้ง: กด "ลบรูป" แล้ว `document.activeElement` เป็น body เพราะปุ่มที่ถือโฟกัสหายไป — คีย์บอร์ด/โปรแกรมอ่านจอหลงตำแหน่ง)

## [0.103.0] — 2026-11-03

### Added
- **`FormFieldImageUpload`** — ช่องเลือกรูปเดียวในฟอร์ม (โลโก้ / รูปโปรไฟล์ / รูปสินค้า) ยกจาก supplychain (props เดิม: `control`, `name`, `urlName`, `label`, `initialImageUrl`, `disabled`, `className`; `setValue` ไม่บังคับแล้ว — ใช้ของ `Form`) · เพิ่ม `description`, `accept` (ค่าเริ่มต้น `image/*`), `maxSize` (เกินแล้วไม่รับ ขึ้นข้อความใต้ช่อง), `shape` square/circle · แก้จากของเดิม: ปุ่มเลือก/เปลี่ยน/ลบแสดงตลอด (เดิมซ่อนรอ hover — จอสัมผัสกดไม่ได้), ข้อความไทยจาก UiText `imageUpload` (เดิม "Choose Image"/"Remove Image"), ป้ายของช่องผูกกับปุ่มเลือกรูป + ชื่อปุ่ม "เปลี่ยนรูป: โลโก้", ตัวอย่างใช้ `URL.createObjectURL` และคืนหน่วยความจำเมื่อเปลี่ยน/ออก, เลือกไฟล์เดิมซ้ำได้
- showcase: หน้า `/components/form-field-image-upload`

## [0.102.1] — 2026-11-03

### Fixed
- **`useDialogs().choose()` กว้าง 28rem จริง** — 0.101.0 ใส่ `sm:max-w-md` แต่แพ้ `data-[size=default]:sm:max-w-sm` ของ AlertDialogContent (specificity สูงกว่า) กล่องยังกว้าง 24rem (วัดใน pi-done: max-width 384px) · ตอนนี้ใช้ variant เดียวกันให้ twMerge แทนที่ · ปุ่มขึ้นบรรทัดใหม่ (`sm:flex-wrap`) ใช้ได้อยู่แล้ว
- เทสต์ `faceted-filter-touch` หมดเวลาเมื่อเครื่องหนัก (รอรายการที่โหลดด้วย dynamic import 1s → 10s)

## [0.102.0] — 2026-11-03

### Added
- **`ConfirmDialog finalFocus`** (ส่งต่อ Base UI `finalFocus` ทั้งกล่องกลางจอและแผ่นล่าง) — ยืนยันแล้วปุ่มที่เปิดกล่องหายไปด้วย (ลบแถว/เลิกปักหมุด) โฟกัสหลุดไป body → ส่ง ref หรือฟังก์ชันที่คืน element ข้างเคียง (คืน `true` = ค่าเริ่มต้น)

### Fixed
- **`PinnedLinks` โฟกัสหลังเลิกปักหมุด** — เดิมหลุดไป body (คีย์บอร์ด/โปรแกรมอ่านจอหลงตำแหน่ง) ตอนนี้ไปลิงก์ถัดไป (รายการสุดท้าย → ลิงก์ก่อนหน้า) ทั้งแบบมีและไม่มีกล่องยืนยัน · ยกเลิก = กลับปุ่มเดิม
- **`AppShell` slot ที่มาจาก server component ไม่เตือนเรื่อง key** (supplychain แจ้ง: `header.banner={<Suspense><ImpersonationBannerWrapper /></Suspense>}` → "Each child in a list should have a unique key … Check the render method of SidebarShell") — element จาก RSC ฝั่ง client เป็น lazy node ถูกตรวจ key เมื่ออยู่ข้างลูกตัวอื่น · ครอบ `header.banner`, `banner` (ทั้งสอง layout), `header.breadcrumbs` และ `children` (layout top) ด้วย `Fragment` ที่มี key — แอปไม่ต้องใส่ key เอง
- เทสต์ `lazy-parts` (autocomplete) หมดเวลาเมื่อเครื่องหนัก — เวลาของเทสต์เท่ากับ `waitFor` (5s) → 15s

## [0.101.0] — 2026-11-03

ทวนโค้ด 0.100.0 (วัดใน browser เทียบกับ AppShell จริง) + sidebar ตรึง/เลิกตรึงได้ (เจ้าของสั่ง 2026-11-03)

### Added
- **`AppShell sidebarPinnable` + `sidebarDefaultPinned`** — sidebar แบบ supplychain เดิม: ปุ่มหมุดในหัว sidebar (ท้ายช่องค้นหา / ข้างชื่อแอป, จอ md ขึ้นไป) · **ตรึง** = แผงติดซ้ายดันเนื้อหา ปุ่มย่อ = หายทั้งแผง (`collapsible="offcanvas"`) · **เลิกตรึง** = ซ่อนไว้ ปุ่มเมนู/Ctrl+B เปิดเป็นแผ่นลอยทับเนื้อหา เลือกเมนู (ลิงก์) แล้วปิดเอง (Ctrl/⌘/Shift+คลิกไม่ปิด) · มือถือเป็นแผ่นเสมอ · จำใน cookie **`SIDEBAR_PINNED_COOKIE_NAME`** (`sidebar_pinned` ชื่อเดียวกับ supplychain เดิม — ผู้ใช้ไม่ต้องตั้งใหม่; อายุตาม `sidebarCookieMaxAge` หรือ 1 ปี) · UiText `sidebarPin` (ป้ายปุ่มคงที่ + `aria-pressed`, tooltip บอกผล)
- **`AppShellSkeleton sidebarHidden`** — โครงไม่มีแผง sidebar (เลิกตรึง / ย่อแบบ offcanvas)
- UiText `nav.sheetDescription`
- **`AppShellSkeleton headerActions`** (ค่าเริ่มต้น `true`) — มือถือ header 2 แถวเหมือน AppShell ที่มี `actions`/`center` (เดิม skeleton แถวเดียว 48px แต่ของจริง 85–89px → หน้าเด้งลงตอนโหลดเสร็จ) · `false` = แถวเดียว

### Fixed
- **`AppShell` layout sidebar: แถวแรกของ header บนมือถือสูง 48px คงที่** — เดิม `flex-1` ใน `flex-col` ทำให้ `h-12` ไม่มีผล แถวสูงตามปุ่ม (44px จอสัมผัส / ~32px จอแคบที่ใช้เมาส์) · header มือถือที่มีปุ่มด้านขวา 85 → 89px
- **`AppShellSkeleton` ขนาดตรงของจริงทุกแบบ** (วัดแล้ว: sidebar 56px จอกว้าง / 89px มือถือ, top 98px, แถบล่าง 57px กว้างไม่เกิน `max-w-lg`) · header ไม่หดเมื่อกรอบเตี้ย (`shrink-0`)
- **`PinnedLinks`**: ปิดกล่องยืนยันแล้วข้อความไม่กะพริบเป็น `นำ "" ออก…` ระหว่าง animation
- README: `loading.tsx` ที่ครอบ AppShell ต้องอยู่ที่ segment แม่ของ layout
- **แผ่นเมนู sidebar บนมือถือ**: หัวเรื่องสำหรับโปรแกรมอ่านจอเป็นไทยจาก UiText (`nav.main` "เมนูหลัก") — เดิม "Sidebar" / "Displays the mobile sidebar." (แก้มือ `ui/sidebar.tsx`)
- showcase: `/shell` ปุ่มสลับ "ตรึงได้" (cookie `showcase_shell_mode`) แสดง `sidebarPinnable`
- **`useDialogs().choose()` ปุ่มล้นกรอบ** (pi-done แจ้ง: "ยกเลิก / Move tasks to No Section / Delete tasks" เกินกล่อง 24rem บนจอกว้าง) — กล่องแบบเลือกกว้าง 28rem (`sm:max-w-md`) และแถวปุ่มขึ้นบรรทัดใหม่เมื่อไม่พอ (`sm:flex-wrap`) · confirm/prompt/alert ขนาดเดิม · มือถือเป็นแผ่นล่างปุ่มเรียงลงอยู่แล้ว

## [0.100.0] — 2026-11-03

คำขอจาก supplychain: ย้ายกรอบหน้า (sidebar + header) ไปใช้ `AppShell` (ผู้ใช้อนุมัติแนวทาง 2026-11-03)

### Added
- **กล่อง header ที่ตรึงบนของ `AppShell`** (ทั้ง layout sidebar และ top — ครอบ `header.banner` + `<header>`) มี `data-slot="app-header"` และ `data-app-header` — แอปวัดความสูงจริงได้ (สูงไม่คงที่: banner, 2 แถวบนมือถือ) (R1)
- **`SIDEBAR_COOKIE_NAME`, `SIDEBAR_COOKIE_MAX_AGE`, `sidebarDefaultOpen(value, fallback)`** จาก `@suphark/ui` — อยู่ในโมดูลที่ไม่มี "use client" (`lib/sidebar-cookie.ts`) layout ฝั่ง server อ่าน `cookies()` แล้วส่ง `defaultOpen` ได้ (ค่าที่ export จากโมดูล client เป็น client reference ฝั่ง server) · **`AppShell sidebarCookieMaxAge`** / `SidebarProvider cookieMaxAge` ตั้งอายุ cookie (ค่าเริ่มต้น 7 วันเหมือนเดิม) (R2)
- **`MobileTabItem action: "sidebar"`** — แท็บ "เมนู" ใน `AppShell mobileTabs` ที่เปิดแผ่นเมนู sidebar ทั้งหมด ส่งจาก server layout ได้ (ไม่ต้องมี onClick / เรียก `useSidebar()` นอก provider ไม่ได้) · `href` ของแท็บคำสั่งไม่บังคับแล้ว · layout top / วาง `MobileTabBar` เอง = ไม่แสดงแท็บนี้ (R4)
- **`PinnedLinks`** (`@suphark/ui/next`) — แถบเมนูที่ปักหมุดบน header คู่กับ `AppNav pin`: ไฮไลต์หน้าปัจจุบัน, จอแคบเหลือไอคอน + tooltip, เลื่อนแนวนอนเมื่อล้น, เลิกปักหมุดถามยืนยันก่อน (`confirmUnpin={false}` ปิด) · UiText `pinnedLinks` (ยกจาก supplychain `PinnedMenus`) (R3)
- **`AppShellSkeleton`** (`@suphark/ui/next`) — โครงตอนโหลดขนาดเท่า AppShell จริง (sidebar 16rem/3rem, header 48/56px, `layout="top"`, เว้นที่แถบล่าง) ไม่มี hook ใช้ใน server component / `loading.tsx` ได้ (R5)
- showcase: หน้า `/components/pinned-links`, `/components/app-shell-skeleton` · `/shell` ใช้ `sidebarDefaultOpen(SIDEBAR_COOKIE_NAME)` + `sidebarCookieMaxAge` 1 ปี + แท็บ "เมนู" บนมือถือ

## [0.99.2] — 2026-11-03

### Fixed
- `DataTable cellNavigation` เซลล์ตัวเลข: พิมพ์เพื่อเริ่มแก้รับเฉพาะ 0–9 — `<input type=number>` รับค่าตั้งต้นที่ยังไม่เป็นตัวเลขไม่ได้: "a" กลายเป็นค่าร่างที่มองไม่เห็นแล้ว Enter ส่ง "a" ให้ `onCommit` (แอปได้ NaN), "-" ถูกเบราว์เซอร์ล้าง ("-5" บันทึกเป็น 5) · ค่าติดลบ/ทศนิยมนำหน้า: F2 หรือ Enter แล้วพิมพ์ในช่อง
- ช่องแก้ในเซลล์ (0.99.1): ข้อความผิดพลาดยาวไม่ตัดบรรทัด และช่องมี `min-w-20` — ในคอลัมน์ขวาสุด/คอลัมน์แคบล้นกรอบเลื่อนของตาราง แถบเลื่อนแนวนอนโผล่ (ตารางเด้งอีกแบบ) · ตอนนี้กว้างไม่เกินคอลัมน์

## [0.99.1] — 2026-11-03

### Fixed
- **เซลล์แก้ไขของ DataTable ทำตารางเด้งตอนเริ่ม/จบการแก้** (เจ้าของแจ้งจากหน้า data-table): ช่องกรอกอยู่ในตารางจริง — ตาราง `table-auto` ขยายคอลัมน์ตามความกว้างของช่อง (วัดบน 0.99.0: คอลัมน์ "จำนวน" 158 → 384 px คอลัมน์อื่นหด, แถว 37 → 45 px) และวงหมุน/ข้อความผิดพลาดต่อท้ายดันอีก · ตอนนี้ช่องกรอกลอยทับเซลล์เต็มความกว้างคอลัมน์ (แบบ spreadsheet) เนื้อหาเดิมกันที่ไว้แบบมองไม่เห็น วงหมุนอยู่ในช่อง ข้อความผิดพลาดลอยเหนือช่อง — วัดแล้วคอลัมน์/แถวเท่าเดิมทุกพิกเซลทั้งช่องข้อความ ตัวเลข และตัวเลือก · ช่องเลือก (select) ในเซลล์ใช้ขนาด `sm` (28 px) เท่าช่องข้อความ

### Tests
- `commandContainsFilter`: อันดับรอง (ทุกคำอยู่แต่ไม่ขึ้นต้น = 0.5), ขาดคำ = 0, ค้นจาก `keywords`, คำค้นว่าง = 1 — ยกจากเทสต์ของ supplychain ที่ลบฝั่งแอปแล้ว (ช่องเลือก unit rate พึ่งการค้นจาก keywords) · ไม่เปลี่ยนโค้ด

## [0.99.0] — 2026-11-02

### Added
- **`DataTable cellNavigation`** — แก้ค่าในตารางแบบ spreadsheet ด้วยคีย์บอร์ด (จอกว้าง, คอลัมน์ที่มี `meta.editable`): ลูกศรเลื่อนไปเซลล์ที่แก้ได้ข้างเคียง (ข้ามคอลัมน์ที่แก้ไม่ได้), พิมพ์ = แก้โดยแทนค่าเดิม (ภาษาไทยได้), F2/Enter = แก้ค่าเดิม, Delete/Backspace = ล้างแล้วแก้ · ขณะแก้: Enter/Shift+Enter บันทึกแล้วลง/ขึ้น, Tab/Shift+Tab บันทึกแล้วไปขวา/ซ้าย, ↑/↓ ในช่องข้อความบันทึกแล้วขึ้น/ลง, Esc ยกเลิก · ช่องเลือก (select) บันทึกทันทีที่เลือก Tab/Shift+Tab ปิดช่องแล้วไปเซลล์ข้างเคียง · ค่าไม่ผ่าน `validate` ไม่ย้าย · บันทึกครั้งเดียวต่อการย้าย · สุดตารางอยู่ที่เดิม · ค่าเริ่มต้นปิด (แอปเดิมไม่เปลี่ยน)
- showcase: หน้า `/components/data-table` ตัวอย่าง "แก้แบบ spreadsheet" (วัสดุ/จำนวน/หน่วย + คอลัมน์ที่แก้ไม่ได้)

### Fixed
- เซลล์แก้ไขของ DataTable: กด Enter (บันทึก) หรือ Esc (ยกเลิก) ในช่องแล้วโฟกัสหลุดไป `<body>` — กด Tab ต่อเริ่มจากต้นหน้า · ตอนนี้โฟกัสกลับที่เซลล์เดิม (ไม่ต้องเปิด `cellNavigation`)

## [0.98.2] — 2026-11-02

แก้จากรีวิวโค้ดรอบ 0.96–0.98.1 (ประสิทธิภาพ/ขนาด/บั๊ก)

### Fixed
- ปุ่มลัด sidebar (0.98.1) จับ **Ctrl+Shift+B** (แถบบุ๊กมาร์กของ Chrome/Edge — ถูกกลืน) และ AltGr+B (ตัวอักษรที่พิมพ์หาย) — ไม่รับ Shift/Alt แล้ว · `SortableList` Ctrl+A ไม่รับ Alt เช่นกัน
- ตัวกรองของ DataTable: แตะเปิดครั้งแรกบนมือถือขณะรายการยังโหลด ถูกย้ายโฟกัสไปช่องค้นหา (แป้นพิมพ์เด้งทับรายการ) — ย้ายเฉพาะเมื่อเปิดด้วยเมาส์/คีย์บอร์ด · ตัวกรองที่ mount ไว้ก่อนตัวอื่นโหลดรายการเสร็จ เปิดแล้วโชว์วงหมุนวูบ — ใช้โมดูลที่โหลดแล้วทันที
- `useLazyDrawer`: component ที่ mount ก่อน Drawer โหลดเสร็จ (เช่นตอนจอกว้างแล้วหมุนเป็นมือถือ) render แบบจอกว้างอีกรอบก่อนได้ชิ้นส่วน — ใช้ cache ทันที
- `ResponsivePopover` แบบไม่ควบคุม (ไม่ส่ง `open`): เปิดอยู่ตอน Drawer โหลดเสร็จ/หมุนจอ → ถูกแทนด้วย Drawer ที่ปิด (picker ที่เพิ่งเปิดหายไป) — เก็บสถานะเปิดเองและตรึงแบบระหว่างเปิด
- เซลล์แก้ไขของ DataTable บนมือถือ: เริ่มแก้ก่อน Drawer โหลดเสร็จ → ช่องในเซลล์ถูกแทนด้วยแผ่นล่างกลางการพิมพ์ (โฟกัส/เคอร์เซอร์หาย) — เลือกแบบตอนเริ่มแก้แล้วตรึงไว้จนเลิกแก้ · และไม่ re-render ทุกเซลล์พร้อมกันตอน Drawer โหลดเสร็จ (เดิม 150 เซลล์ = 150 setState) — โหลดล่วงหน้าแบบไม่ subscribe (`getLoadedDrawer`)
- `ActivityFeed`: ไม่จัดกลุ่มวันก็ยังตั้ง timer เที่ยงคืน · แอปส่ง `items` array ใหม่ทุก render (ค่าเดิม) = จัดรูปวันที่ทุกแถว + render ซ้ำ + ตั้ง timer ใหม่ทุกครั้ง — เทียบด้วยเวลาของแถวแทนตัว array
- `shiftMonth` เลยช่วงปี 0000–9999 ได้คีย์ที่ `parseMonthKey` ไม่รับ ("00-1-12") แล้ว render ถัดไป throw — ไม่เลยช่วงแล้ว

## [0.98.1] — 2026-11-02

ตรวจทานรายงานสำรวจ 2026-10-30 ทุกข้อเทียบกับ CHANGELOG — เหลือจริง 1 ข้อ (S24) + ตัวเดียวกันใน SortableList

### Fixed
- ปุ่มลัด Ctrl/⌘+B หุบ/กาง sidebar (`AppShell`) ไม่ทำงานเมื่อแป้นพิมพ์เป็นภาษาไทย (`event.key` ได้ "ิ") — แก้มือใน `ui/sidebar.tsx` ให้เทียบแป้นจริงแบบเดียวกับ `useHotkeys` (S24 — 0.86.0 แก้ `useHotkeys` แต่ไม่ได้แก้ตัวนี้)
- `SortableList multiSelect`: X (เลือก/ไม่เลือก) และ Ctrl+A (เลือกทั้งหมด) ที่ที่จับไม่ทำงานเมื่อแป้นเป็นภาษาไทย
- `hotkeyKeyOf(event)` (`@suphark/ui/hooks/use-hotkeys`) — ตัวเทียบแป้นของ `useHotkeys` export ให้ปุ่มลัดที่เขียนเองใช้ร่วม (แป้นละตินใช้ `event.key`, ตัวอักษรที่ไม่ใช่ ASCII ใช้ `event.code`)

## [0.98.0] — 2026-11-02

สำรวจ D16–D25 ใหม่ (รายงาน 2026-10-30 ระบุไม่ครบ — ดึงรายการเต็มจากผลสำรวจเดิม) แล้วแก้ข้อที่ 0.87.0 ยังเหลือ · D20 (UserAvatars) และ D23 (SetupChecklist) แก้ครบแล้วตั้งแต่ 0.87.0

### Added
- `ApprovalTimeline locale` — ภาษาของวันที่/เวลา (ค่าเริ่มต้น `th-TH`) แอปสองภาษาส่งตามผู้ใช้ เหมือน `ActivityFeed locale` (D21)

### Changed
- `isMonthKey` ไม่รับปี 2400 ขึ้นไป — ค่าจาก URL ที่พิมพ์เป็นปี พ.ศ. ("2569-10") เดิมผ่านแล้วแสดงเป็น "ตุลาคม 3112" (D18)
- `CountBadge`: ค่าลบ = 0 (ไม่แสดง, `showZero` แสดง "0"), ทศนิยมปัดเป็นจำนวนเต็ม — เดิมแสดง "-3"/"1.5" (D19)
- `ProgressBar`: `value` เป็น NaN/Infinity = 0 — เดิมกลายเป็นแถบวิ่ง (ไม่ทราบค่า) เงียบ ๆ · `null` ยังเป็นไม่ทราบค่า · เอกสาร: ไม่มี `label` ต้องส่ง `aria-label` (D24)
- `ApprovalTimeline`: กลุ่มรูปผู้อนุมัติซ่อนจากโปรแกรมอ่านจอ (ชื่ออยู่ในรายการข้าง ๆ แล้ว — เดิมอ่านชื่อซ้ำสองรอบ) · ชื่อผู้อนุมัติซ้ำกันไม่เตือน key ซ้ำ (D21)
- `ActivityFeed`: ตัวย่อชื่อใน avatar ไม่ถูกอ่านนำหน้าชื่อผู้ทำ (D22)
- `PrimarySecondaryText`: คำอธิบาย props เป็นภาษาไทย (D25)

### Fixed
- `UsageMeter` ตัวเลขค่าเริ่มต้นใช้ภาษาของเครื่อง (`toLocaleString()`) — server กับ browser ภาษาอื่นได้ข้อความไม่ตรงกัน (hydration mismatch) และสร้าง formatter ใหม่ทุกครั้ง · ตอนนี้ `th-TH` ที่ cache ไว้ (D16)
- `formatBytes`: สตริงว่าง/ช่องว่างได้ "0 B" → "—" · เพิ่มหน่วย PB (เดิมเกิน TB เป็น "1,024 TB" ขึ้นไป) · `minUnit` ทำให้ค่าเล็กปัดเป็น "0 GB" → "< 0.01 GB" · ใช้ formatter ที่ cache ไว้ (D17)
- `shiftMonth`/`formatMonthKey`/`toMonthKey` ปี 0–99: `new Date(y, …)` แปลงเป็น 19xx (`shiftMonth("0099-01", -1)` ได้ "1998-12") — คิดเดือนตรง ๆ (D18)
- `ActivityFeed groupByDate`: จัดกลุ่มวันตามเขตเวลาของเครื่อง แต่เวลาในแถวแสดงเวลาไทย — นอกไทย/เครื่อง UTC หัว "วันนี้"/"เมื่อวาน" ไม่ตรงกับเวลาในแถว · ตอนนี้ใช้เวลาไทยทั้งคู่ และคำนวณใหม่ตอนข้ามเที่ยงคืน (เปิดหน้าค้างไว้ "วันนี้" ไม่ค้าง) (D22)
- `PrimarySecondaryText secondary={0}` render "0" ดิบ ๆ นอกบรรทัดรอง — ตอนนี้แสดงเป็นบรรทัดรองตามปกติ (D25)
- ตัวอย่างใน `VersionHistory` ใช้ `<ChangeDiff changes=…>` ที่ไม่มีจริง → `before`/`after` (D25)

## [0.97.1] — 2026-11-02

### Fixed
- `DataTableFacetedFilter`: เปิดตัวกรองครั้งแรกขณะรายการยังโหลด โฟกัสค้างที่กรอบ popup แทนช่องค้นหา (ต้องกด Tab ก่อนพิมพ์) — Base UI เลือกเป้าโฟกัสตอนเปิด (มีแค่วงหมุน) แล้วโฟกัสหลังรายการมาถึง · ตอนนี้รายการเฝ้าดูสั้น ๆ (ไม่เกิน 1 วินาที) แล้วย้ายไปช่องค้นหา เฉพาะกรณีเปิดระหว่างโหลด (พบตอนตรวจ 0.97.0 บน ui.suphark.com)

## [0.97.0] — 2026-11-02

ส่วนเสริมของ DataTable โหลดเมื่อต้องใช้ — P9 จากรายงานสำรวจ 2026-10-30

### Added
- `preloadDataTableFacetedFilter()` และ type `FacetedFilterOption` จาก `@suphark/ui/data-table`

### Changed
- **รายการตัวเลือกของ `DataTableFacetedFilter` (cmdk ~17 kB gz) แยกโหลด** — ปุ่มและ badge ค่าที่เลือกยังโหลดพร้อมหน้า (แถบเครื่องมือไม่กระตุก) รายการเริ่มโหลดเมื่อชี้/โฟกัสปุ่มหรือเปิด · เปิดครั้งแรกขณะยังโหลดไม่เสร็จ = วงหมุนสั้น ๆ แล้วโฟกัสย้ายไปช่องค้นหาเหมือนเดิม · โหลดแล้ว = ตัวกรองทุกตัวเปิดเห็นรายการทันที · โค้ดที่ DataTable ดึงมาตอนโหลดหน้า 111 → 90 kB gz (วัดแบบรวม dependency ทั้งหมด) — ลากเรียง (dnd-kit) และแถวเสมือนโหลดแยกอยู่แล้ว ส่วนเสริมอื่น (saved views, เซลล์แก้ไข, แผ่นตัวกรองมือถือ) รวม ~5 kB ไม่คุ้มแยก
- **เทสต์ของแอป** ที่คลิกตัวกรองแล้วตรวจรายการทันที: เพิ่ม `beforeAll(() => preloadDataTableFacetedFilter())` หรือใช้ `findBy*`

## [0.96.0] — 2026-11-02

Drawer (แผ่นล่างมือถือ) โหลดเมื่อต้องใช้ — P4 จากรายงานสำรวจ 2026-10-30

### Added
- `useLazyDrawer(enabled)` / `preloadDrawer()` / type `DrawerParts`: โหลดชิ้นส่วน Drawer ครั้งเดียวทั้งแอปเมื่อต้องใช้ (คืน null ระหว่างโหลด) — สำหรับ overlay ที่แอปสลับ Dialog ↔ แผ่นล่างเอง และสำหรับเทสต์ (`beforeAll(() => preloadDrawer())`)

### Changed
- **จอกว้างไม่โหลดโค้ด Drawer อีก** (~13 kB gz ของ Base UI Drawer + ตัวห่อ): `ConfirmDialog`, `DialogsProvider`, `FormDialog`, `ImportDialog`, `ActionMenu`, `RowActions` (`sheetOnMobile`), `ResponsivePopover` (picker วันที่ ฯลฯ) และเซลล์แก้ไขของ `DataTable` โหลด Drawer เฉพาะเมื่ออยู่บนมือถือ — เดิมทุกหน้าที่มี `DialogsProvider` ใน root layout จ่ายด้วย
- บนมือถือ render แรกเป็นแบบจอกว้าง (แบบเดียวกับตอน hydrate) แล้วเป็นแผ่นล่างเมื่อโหลดเสร็จ · เปิดค้างอยู่ตอนโหลดเสร็จ = คงแบบเดิมจนปิด (ไม่สลับรูปกลางทาง) · โหลด chunk ไม่ได้ = ใช้แบบจอกว้างต่อ (ใช้งานได้ครบ)
- **เทสต์ของแอป** ที่ mock มือถือแล้วตรวจแผ่นล่างตั้งแต่ render แรก: เพิ่ม `beforeAll(() => preloadDrawer())` หรือใช้ `findBy`/`waitFor`
- `ActionMenu`: dropdown เป็นแบบควบคุมภายใน (ใช้ state เดียวกับแผ่นล่าง) — ภายนอกเหมือนเดิม

## [0.95.0] — 2026-11-01

ระดับ 2 ที่เหลือจากรายงานสำรวจ (T18, A7, A8, S6, SectionCard แบบพับได้)

### Added
- **`--brand-dark` / `--brand-dark-foreground`** (ไม่บังคับ): สีแบรนด์ของโหมดมืด — สีที่เข้มพอบนพื้นขาวมักจางเกินบนพื้นมืด (ลิงก์ `text-primary` 3.1:1, A7) · ไม่ตั้ง = ใช้ `--brand` เดิม
- UiText `table.scrollRegion` (ชื่อกรอบเลื่อนของตารางที่ล้น)

### Changed
- `SectionCard collapsible`: หัวเป็น heading ครอบปุ่ม (`headingAs`, ค่าเริ่มต้น `h2` — แบบเดียวกับ SectionCard ปกติ) ชื่อ heading/ปุ่ม = `title` อย่างเดียว คำอธิบายและสรุปตอนหุบเป็น description · หน้าตาเดิม
- `Table` (แก้มือใน `ui/table.tsx`): ตารางกว้างเกินกรอบ = กรอบเลื่อนเป็น tab stop + `role="region"` มีชื่อ (ใช้ `aria-label` ของตาราง ถ้าไม่มี = UiText) คีย์บอร์ดเลื่อนซ้าย–ขวาได้ · ตารางที่ไม่ล้นไม่เพิ่มจุด Tab (A8) · ใช้ `ResizeObserver` — เทสต์ของแอปที่ mock เป็น `vi.fn(() => ({…}))` (new ไม่ได้) ตารางไม่พัง แค่ไม่ติดตามขนาด
- เอกสาร: สีแบรนด์ทั้งแอปให้ตั้งที่ `<body>` — เมนู/dialog/sheet ที่ portal ไปท้าย body จะได้สีด้วย (S6)

### Fixed
- **รายการมือถือแบบเสมือน (`DataTable virtualized` บนจอเล็ก) แถวว่าง/ข้ามแถวเมื่อส่วนหัวของหน้าสูง** — ไม่ได้บอก virtualizer ว่ารายการเริ่มต่ำจากบนสุดเท่าไร (`scrollMargin`) · ตอนนี้วัดเองและวัดใหม่เมื่อหัวหน้าเปลี่ยนความสูง (T18)
- showcase: หน้า `/brand` ตัวอย่างตั้ง `--brand-dark` ลิงก์โหมดมืดอ่านออก + ตัวอย่างตั้งที่ `<body>`

## [0.94.0] — 2026-11-01

ไอคอนตามความหมาย — เลือกจากความหมาย ไม่ใช่รูป (เจ้าของเห็นด้วย "ตามที่เสนอ")

### Added
- **ไอคอนตามความหมาย 33 ชื่อ** จาก `@suphark/ui/icons`: คำสั่ง `ActionAdd` (Plus) `ActionEdit` (Pencil) `ActionDelete` (Trash2) `ActionSave` `ActionClose` (X) `ActionConfirm` (Check) `ActionCopy` `ActionSearch` `ActionFilter` (ListFilter) `ActionSort` (ArrowUpDown) `ActionMore` (Ellipsis) `ActionRefresh` (RefreshCw) `ActionUndo` (RotateCcw) `ActionDownload` `ActionUpload` `ActionPrint` `ActionSend` `ActionArchive` `ActionView` `ActionHide` `ActionOpenExternal` `ActionLink` (Link2) `ActionAttach` `ActionDrag` `ActionHistory` `ActionSettings` · สถานะ `StatusSuccess` (CircleCheck) `StatusWarning` (TriangleAlert) `StatusError` (CircleAlert) `StatusInfo` `StatusLoading` (LoaderCircle) `StatusPending` (Clock) `StatusLocked` (Lock) — เป็นชื่อเรียกอื่นของไอคอน lucide (ไม่เพิ่มขนาด bundle) · รูปเลือกจากที่แอปใช้มากที่สุด · `SEMANTIC_ICON_NAMES` (ชื่อ → รูป + ความหมาย)
- `suphark-ui-audit` กฎ **`icon-variant`** (warning): ไอคอนรูปอื่นของความหมายเดียวกัน (`Trash`, `Edit`/`Edit2`/`Pen`/`PenLine`/`SquarePen`, `CirclePlus`/`PlusCircle`, `EllipsisVertical`, `RefreshCcw`, `Filter`/`Funnel`, `Link`, `Settings2`, `CheckCircle`, `Loader`) → ชื่อตามความหมาย · import หลายบรรทัด/alias ได้ · ปิดชั่วคราว `--no-icon-variant` · ตรวจโค้ดในแพ็กเกจด้วย
- showcase: หน้า `/components/semantic-icons`

### Changed
- ปุ่มสำเร็จรูปและ component ของแพ็กเกจใช้ไอคอนตามความหมาย (`AddNewButton`, `SaveButton`, `DeleteButton`, `CancelButton`, `CopyButton`, `RefreshButton`, `Notice`, `RowActions`, `ActionMenu`, `SearchInput` ฯลฯ) — รูปเดิมทั้งหมดยกเว้นต่อไปนี้
- **รูปที่เปลี่ยน** (ให้ตรงมาตรฐาน): `RefreshButton` RefreshCcw → RefreshCw · `DataTableRowActions` แก้ไข Pen → Pencil, ลบ Trash → Trash2 · ตัวกรองที่หัวคอลัมน์ DataTable Filter → ListFilter · ปุ่มเพิ่มตัวกรอง (faceted filter) CirclePlus → Plus · rich-text ลิงก์ Link → Link2, ลบแถว/คอลัมน์ Trash → Trash2
- showcase: demo simple-popover / tour ใช้ `ActionSettings` / `ActionFilter`

## [0.93.0] — 2026-11-01

ยกจาก supplychain: rich-text editor + guard กันปิด dialog ฟอร์ม (คำขอจาก session supplychain)

### Added
- **`@suphark/ui/rich-text`** (entry ใหม่): `RichTextEditor`, `FormFieldRichText`, `normalizeLinkUrl`, `VariableNode` — ช่องพิมพ์ HTML บน Lexical (ทูลบาร์ขนาดตัวอักษร/จัดรูป/จัดแนว/รายการ/ลิงก์/ตาราง/เส้นคั่น, ตัวแปร `{{…}}`) · **lexical + `@lexical/*` เป็น optional peer `>=0.49.0`** แอปที่ไม่ใช้ไม่ต้องลง · props เดิมของ supplychain (`value`, `onChange`, `placeholder`, `className`, `mode`, `onSelectVariable`, `editorRef`) + `variables`, `aria-*`, `id`
  - ต่างจากของเดิม: โหลดด้วย `React.lazy` + รอ mount (ไม่พึ่ง `next/dynamic`) · ข้อความทูลบาร์/placeholder จาก UiText `richText` (ไทย/อังกฤษ — เดิมอังกฤษตายตัว) · แทรกลิงก์/ตารางด้วยกล่องของแพ็กเกจแทน `window.prompt` · ลิงก์รับเฉพาะ https/mailto/tel (เดิมรับ `javascript:`; ไม่มี scheme = เติม `https://`) ทั้งจากกล่องและตอนวาง · ปุ่มทูลบาร์มีชื่อ/tooltip (เดิม `title`) และ `role="toolbar"` · ไม่ใช้ `prose` (แอปไม่ต้องมี @tailwindcss/typography) — สีจาก token สลับ dark ได้ · `FormFieldRichText` ช่องพิมพ์มีชื่อจากป้าย (`aria-labelledby` — contenteditable ผูก `<label for>` ไม่ได้) คลิกป้ายแล้วโฟกัส
- **`useDiscardChangesGuard({ isDirty, onDiscard, description? })`** → `{ requestClose, discardDialog }` (barrel) — กันปิด dialog ฟอร์มที่กรอกค้าง: ยังไม่กรอก = ปิดเลย, กรอกแล้ว = ถามก่อนทิ้ง · ข้อความจาก UiText `discardChanges`
- UiText กลุ่ม `richText` (59 ข้อความ) และ `discardChanges` (4) ทั้ง `UI_TEXT_TH` / `UI_TEXT_EN`
- showcase: หน้า `/components/rich-text-editor` และ `/components/discard-changes-guard`

## [0.92.0] — 2026-11-01

ไอคอนมาจาก Pi UI ที่เดียว — แอปเลิก import `lucide-react` ตรง ๆ

### Added
- **`@suphark/ui/icons` ส่งไอคอน lucide ครบทุกตัว ชื่อเดิม** (4,580 ชื่อ: `Plus`, `PlusIcon`, ชื่อเดิมอย่าง `AlertTriangle` + `type LucideIcon`/`LucideProps`/`IconNode` + `Icon`, `createLucideIcon`, `LucideProvider`) — ย้ายแอปแค่เปลี่ยน `from "lucide-react"` เป็น `from "@suphark/ui/icons"` ไม่ต้องเปลี่ยนชื่อ · สร้างด้วย `scripts/gen-lucide.mjs` (ใน `gen:icons`) — ระบุชื่อทีละตัว ไม่ส่ง `icons` (object ทั้งชุด) และ `LucideX` (ชื่อซ้ำ) · lucide รุ่นใหม่ลบ/เปลี่ยนชื่อ สคริปต์หยุดให้คงชื่อเดิมใน `KEPT_NAMES` แอปไม่ต้องตามแก้
- `suphark-ui-audit` กฎ **`lucide-import`** (warning): import จาก `lucide-react` / `lucide-react/dynamic` ตรง ๆ → `@suphark/ui/icons` / `NamedIcon` · ปิดชั่วคราว `--no-lucide` · ไม่ตรวจโค้ดในแพ็กเกจเอง
- showcase: import ไอคอนจาก `@suphark/ui/icons` ทั้งหมด (56 ไฟล์) เป็นตัวอย่างให้แอปลอก

### Changed
- **`lucide-react` ย้ายจาก peer เป็น dependency ของแพ็กเกจ** (`^1.66.0`, เดิม peer `>=1.30.0`) — แพ็กเกจเป็นเจ้าของรุ่น ทุกแอปได้ไอคอนรุ่นเดียวกัน · แอปที่ยัง import `lucide-react` เองใช้ได้ต่อจนกว่าจะย้าย (ย้ายครบแล้วลบ `lucide-react` จาก package.json ของแอปได้)
- lucide 1.46 → 1.66: ชื่อเรียกอื่นของชุดไอคอนมาตรฐานเพิ่ม 2 ชื่อ (`icon-names.ts`)

วัดผล (showcase, Next 16 Turbopack): build production ก่อน/หลังย้าย 56 ไฟล์ — JS ฝั่ง client ทุกหน้า (200 หน้า) เท่าเดิมทุก kB, ฝั่ง server ไม่ดึงไอคอนทั้งชุด · `next dev` หน้าใหม่คอมไพล์ 0.3–0.47 วินาทีเท่ากันทั้งสองแบบ → ไม่ต้องตั้ง `optimizePackageImports`

## [0.91.1] — 2026-11-01

### Added
- **`useCommandState`** export จาก `@suphark/ui` (re-export ของ cmdk ใน `ui/command.tsx` — แก้มือ) — อ่านคำที่พิมพ์ใน Command ได้โดยแอปไม่ต้องติดตั้ง cmdk เอง · ขอจาก supplychain

### Fixed
- **`FormFieldSelect variant="multiselect"` ปุ่มเปิดรายการไม่ใช่ปุ่ม**: `triggerRender={<FormControl />}` ที่ไม่มีลูก render เป็น `<div>` — ไม่มี role combobox, Base UI เตือน `nativeButton` ทุกช่อง · ตอนนี้ครอบ `MultiSelectCombobox` ด้วย `FormControl` (ส่ง id/aria ให้ปุ่ม label ผูกกับช่อง) · แจ้งจาก supplychain

## [0.91.0] — 2026-11-01

แก้ระดับ 2 จากรายงานสำรวจชุดที่สอง (AppShell บนมือถือ/แท็บเล็ต, ตาราง, การกระทำที่ซ้ำ, PWA)

### Added
- `SectionCard` **`headingAs`** (`"h2"` ค่าเริ่มต้น / `"h3"` / `"h4"` / `"div"` = แบบเดิม)
- `parseSavedViews` (อ่านมุมมองที่บันทึกของ DataTable โดยแปลงวันที่กลับเป็น Date), `registerUnsavedChanges` / `hasRegisteredUnsavedChanges` (lib/unsaved-registry — ใช้ภายใน)

### Changed
- `SectionCard` หัวการ์ดเป็น `<h2>` (เดิม div — โปรแกรมอ่านจอกระโดดหาหัวข้อไม่เจอ) หน้าตาเดิม
- `DocumentHeader stickyActionsOnMobile` / `RecordSection`: ปุ่มการกระทำ render ที่เดียวหลัง mount ตามขนาดจอ (เดิม 2 ชุดซ่อนด้วย CSS — ปุ่มลัด/id ของ `primaryAction` ที่แอปส่งมาซ้ำ) · ก่อน mount (SSR) ยังส่งทั้งสองชุดเหมือนเดิม · เทสต์ของแอปที่นับปุ่มได้ 2 ต้องเปลี่ยนเป็น 1
- AppShell (top nav + เมนูย่อย): ช่วงจอ 768–1023px เมนูย่อยเป็นช่องเลือกเต็มความกว้างเหนือเนื้อหา (เดิมเป็นคอลัมน์แคบซ้าย) — เมนูด้านข้างข้างเนื้อหาเริ่มที่ `lg`
- Sidebar บนจอสัมผัส: ปุ่มปักหมุดเห็นตลอด (เดิมจางล่องหนแต่แตะโดน = ปักหมุดโดยไม่รู้ตัว) · เมนูย่อยสูง 40px (เดิม 28px)

### Fixed
- `Tour`: คืนโฟกัสให้ปุ่มที่เปิดทัวร์เมื่อปิด (เดิมหลุดไป body) · เลื่อนหน้าไปที่เป้าซ้ำทุกครั้งที่ parent render (แอปส่ง `steps` ใหม่ทุก render)
- `useUndoableAction`: ปิดแท็บ/รีเฟรชระหว่างรอเลิกทำ — เริ่มทำจริงตั้งแต่ `beforeunload` และให้เบราว์เซอร์ถามก่อนออก (เดิมทำตอน `pagehide` ที่ request มักถูกยกเลิกพร้อมหน้า = การลบหาย)
- Service worker อัปเดต: ไม่ reload หน้าเองเมื่อมีการแก้ค้าง (ช่องกรอกที่ค่าต่างจากค่าเริ่มต้น หรือ `UnsavedChangesGuard` ที่ dirty) — เดิมกลับมาที่แท็บแล้ว reload ทับฟอร์มที่กรอกไว้
- `HeaderBreadcrumbs` บนมือถือไม่มีตัวคั่นระหว่าง segment ("OrdersPo 123")
- `Banner` ข้อความยาวบนมือถือ: ตัดเฉพาะข้อความ ลิงก์/ปุ่มการกระทำไม่หาย
- `PwaInstallCard`: iPad (iPadOS 13+ แจ้งตัวเป็น Mac) ไม่เห็นวิธีติดตั้ง
- `SimpleTable quiet` มือถือ: แตะขอบรอบช่องติ๊กเปิดแถวแทนเลือก
- DataTable: มุมมองที่บันทึกที่มีตัวกรองช่วงวันที่ใช้ไม่ได้ (วันที่กลายเป็นข้อความใน localStorage) · แถวบนมือถือที่กดค้างเพื่อเลือกหมู่ ไม่เลือกข้อความ/เด้งเมนูของ iOS
- `CalendarMonthGrid` โหมดสัปดาห์: แอปเปลี่ยนเดือนเอง (MonthStepper) แล้วแถบค้างที่วันของเดือนเก่า
- `TreeView`: โหนดที่โฟกัส/เลือกถูกลบ → Tab เข้าต้นไม้ไม่ได้ · `loadChildren` ล้มแล้วจำว่า "ไม่มีลูก" ถาวร — ยุบกลับให้เปิดใหม่ลองอีกครั้ง
- `ComparisonMatrix` หัวแถวเป็น `<th scope="row">` (เดิม `<td>`)
- `SelectionBar` ประกาศเฉพาะจำนวนที่เลือก (`role="status"`) — เดิม `aria-live` ทั้งแถบ อ่านปุ่มทุกปุ่มซ้ำทุกครั้งที่เลือกเพิ่ม
- `Lightbox`: บีบ trackpad (ctrl + wheel) ซูมทั้งหน้าแทนรูป (listener ของ React เป็น passive) · แตะสองครั้งบน Android ซูมแล้วยกเลิกกันเอง · ปุ่มก่อนหน้า/ถัดไปบนมือถือเป็น `sr-only` แทน `hidden` (โปรแกรมอ่านจอ/คีย์บอร์ดเลื่อนรูปได้ ตาเปล่ายังใช้ปัด)
- เทสต์: ตรึงวันที่ในเทสต์ปฏิทิน 2 ข้อที่ล้มเมื่อข้ามเดือน (ขึ้นกับวันที่รัน)

## [0.90.1] — 2026-10-31

### Fixed
- **`Combobox` ที่ไม่มี label ไม่มีชื่อเลย** (ถอยจาก 0.87.0): `role="combobox"` ไม่ได้ชื่อจากข้อความในปุ่ม การเลิกตั้ง aria-label ใน 0.87.0 จึงทำให้ช่องที่ไม่มี `<label>` ไม่มีชื่อ (`getByRole("combobox", { name })` หาไม่เจอ) — ตอนนี้: ส่ง `ariaLabel` = ชื่อนั้น · มี `id` (ผูก `<label htmlFor>` / FormControl) หรือ `aria-labelledby` = ชื่อจาก label ภายนอก ไม่ตั้งทับ · ไม่มีทั้งหมด = ค่าที่เลือกหรือ placeholder (แบบก่อน 0.87.0) · รับ `id`, `aria-labelledby`, `aria-describedby`, `aria-invalid` ส่งต่อให้ปุ่ม · แจ้งจาก supplychain

## [0.90.0] — 2026-10-31

คำขอชุดที่ 4 จาก supplychain (ย้าย `components/data-table` มาใช้แพ็กเกจ)

### Added
- UiText `table.noData` / `noResultsFiltered` / `noResultsFilteredHint` / `rowActionsOf`

### Changed
- **`DataTable` แบบปกติ (ไม่ใช่ quiet) แยกข้อความตอนไม่มีแถว**: ไม่มีคำค้น/ตัวกรอง = "ยังไม่มีข้อมูล" · มีคำค้นหรือตัวกรองที่ผู้ใช้ตั้ง (ไม่นับ `preservedFilterIds`) = "ไม่พบข้อมูลที่ตรงกับการค้นหา" + "ลองเปลี่ยนคำค้นหรือล้างตัวกรอง" (เดิม "ไม่พบข้อมูล" ทุกกรณี) · `emptyStateComponent` ยังทับได้ · ยกจาก supplychain `DataTableEmptyText`
- **`DataTableRowActions` ชื่อปุ่ม ⋯ ต่อแถว**: "ตัวเลือกของ {ชื่อรายการ}" (เดิม "การกระทำ" ทุกแถว — โปรแกรมอ่านจอแยกแถวไม่ได้) · ไม่มีชื่อรายการ = "การกระทำ" เหมือนเดิม · เทสต์ของแอปที่หาปุ่มด้วย "การกระทำ" ต้องเปลี่ยนเป็นชื่อนี้

### Fixed
- `FormFieldColorSelect`: ช่องที่ปิดอยู่แสดงค่าดิบ ("blue") แทนชื่อสี — ส่ง `items` และแสดงจุดสี + ชื่อเหมือนในรายการ

## [0.89.0] — 2026-10-31

คำขอชุดที่ 3 จาก supplychain (ย้าย `components/shared` มาใช้แพ็กเกจ)

### Added
- `FormFieldSelect` **`ariaLabel`** — ชื่อของช่องสำหรับโปรแกรมอ่านจอเมื่อไม่มีป้าย (`label=""` เช่นช่องหน่วยข้างช่องตัวเลข) · `label=""` ไม่ render ป้ายว่างแล้ว
- `MultiSelectCombobox` **`id`, `aria-describedby`, `aria-invalid`** ส่งต่อให้ปุ่ม — วางใน `FormControl` แล้ว label/ข้อความ error ผูกกับช่อง (มี `id` แต่ไม่ส่ง `ariaLabel` = ไม่ใช้ placeholder เป็นชื่อทับ label)

### Changed
- `MultiSelectCombobox` ตรึงกลุ่ม "ที่เลือก" ตามค่าตอนเปิดรายการ — ติ๊ก/เอาออกระหว่างเปิดแล้วตัวเลือกไม่กระโดดย้ายกลุ่มใต้เมาส์ (ช่องติ๊กยังเปลี่ยนตามค่าจริง) · ปิดแล้วเปิดใหม่จัดกลุ่มใหม่

### Fixed
- `ResourcePropertyFilter`: ช่องหน่วยแสดงรหัสหน่วย (cuid) แทนชื่อ ("cm") ตอนรายการปิด — ส่ง `items` ให้ Select · ช่องหน่วยมีชื่อสำหรับโปรแกรมอ่านจอ · ค่าว่างไม่ล็อกเป็น uncontrolled

## [0.88.0] — 2026-10-31

### Changed
- **tooltip ขึ้นบนปุ่มที่ disabled ได้แล้ว** (บอก "เหตุผลที่กดไม่ได้") — `Button` ที่มี tooltip (ระบุเองหรืออัตโนมัติของปุ่มไอคอน) และ `disabled` ใช้ `focusableWhenDisabled` ของ Base UI: `aria-disabled="true"` แทน attribute `disabled` จริง ปุ่มยังกดไม่ได้ แต่ชี้เมาส์/กด Tab ถึงแล้ว tooltip ขึ้น · หน้าตา disabled เดิม (จาง + cursor not-allowed) · **ยกเว้น `type="submit"`** ที่ยังเป็น disabled จริง (ไม่งั้นกด Enter ในฟอร์มส่งได้) · ขอจาก supplychain (เช่น "ยกเลิกสรุปเลือกก่อนเพิ่มรอบเสนอราคา")
  - เทสต์ของแอปที่เช็ค `button.disabled` / `toBeDisabled()` บนปุ่มไอคอนที่มี tooltip ต้องเปลี่ยนเป็นเช็ค `aria-disabled="true"`
- showcase: หน้า Button มีตัวอย่างปุ่ม disabled + tooltip บอกเหตุผล
- `ActionButton` ส่ง tooltip ผ่าน `Button` แทนการห่อ `Tooltip` เอง — ได้ tooltip บนปุ่ม disabled/กำลังโหลดด้วย · props เดิมทั้งหมด

## [0.87.1] — 2026-10-31

### Changed
- **`Command` ใช้ `commandContainsFilter` เป็นค่าเริ่มต้น** (ต้องมีทุกคำที่พิมพ์) — ทุกที่ที่ใช้ `<Command>` ตรง ๆ (รวม CommandPalette/CommandDialog) ได้ตัวกรองเดียวกับ Combobox/MultiSelect ใน 0.86 ไม่ใช่ fuzzy ของ cmdk ("cotto" ขึ้น "Contractor") · ส่ง `filter` เองยังทับได้ · ขอจาก supplychain (ตรงกับ `Command` ของ supplychain ที่กำลังย้ายมาใช้แพ็กเกจ) · แก้มือใน `ui/command.tsx` (จดใน CLAUDE.md)

## [0.87.0] — 2026-10-31

แก้ระดับ 2 จากรายงานสำรวจต่อ (ฟอร์ม, a11y ที่ axe ฟ้อง, ข้อความที่ไม่ผ่าน UiText) — ไม่เปลี่ยน props เดิม

### Added
- UiText: `requiredField`, `skipToContent`, `breadcrumb.home`/`back`, `chat.region`, `table.reorderBlocked`, `importDialog.moreInvalid`

### Changed
- ค่าเริ่มต้นตามภาษาของแอป (เดิมอังกฤษตายตัว): `HeaderBreadcrumbs` "Home"/"Back" → "หน้าแรก"/"ย้อนกลับ", ป้ายซ่อนช่องบังคับ " required" → "จำเป็น", `SkipLink`, `FormFieldCombobox` "Select..."/"Loading...", `FormFieldSelect` "Search..."/"No results found.", ตารางลากเรียง "Cannot reorder…" และประกาศของ dnd-kit, `ChatThread` region "Messages" — ส่ง prop เดิมยังทับได้
- `ChatThread` เลื่อนตามข้อความใหม่เป็นค่าเริ่มต้น (`autoScroll` — เดิมต้องเลื่อนเอง)
- `InfoHint` บนจอสัมผัสเป็น popover แตะเปิด/ปิด (tooltip ของ Base UI ไม่เปิดเมื่อแตะ) · เมาส์ยังเป็น tooltip
- `MultiSelectCombobox`: ปุ่ม X ของชิปและ "ล้างทั้งหมด" ไม่เป็นปุ่มซ้อนในปุ่มหลักแล้ว (โปรแกรมอ่านจอเข้าไม่ถึง) — ยังคลิก/แตะได้ พื้นที่แตะ 24px · คีย์บอร์ด: **Backspace/Delete บนช่องลบตัวที่เลือกล่าสุด** หรือเอาออกในรายการ
- ปฏิทินของ DatePicker เลื่อนได้ 1900 ถึงอีก 50 ปี (เดิม 1990–2040 — วันเกิดก่อน 1990 ต้องพิมพ์)
- `DateRangePicker`: วันที่ในปุ่มเป็นไทย พ.ศ. เหมือนบรรทัดสรุป (เดิม "Oct 30, 2026")
- หัวกลุ่มของ SubNav / IconPicker และแถวเมนู `SidebarNavItem` ไม่จางลง (`/70` `/80` คอนทราสต์ 2.96–3.6:1 → 4.5:1 ขึ้นไป)
- `CalendarMonthGrid` ตารางวันเป็น `role="group"` (เดิม `grid` ที่ไม่มีแถว — axe ฟ้อง)

### Fixed
- `Combobox` ไม่ส่ง `ariaLabel`: ชื่อของปุ่มเป็นค่าที่เลือก ทับ `<label>` ของช่อง ("บริษัท ก" แทน "ผู้ขาย") — ไม่ตั้ง aria-label เองแล้ว
- `FormFieldCombobox`: label ไม่ผูกกับช่อง (FormControl ครอบ Popover ที่ไม่มี DOM) · ผลโหลดของ `fetcherKey` เก่ามาทีหลังทับตัวเลือกใหม่ · โหลดล้มเงียบ (แค่ console) — แสดงในช่องแล้ว
- `ImportDialog`: ไฟล์ผิดแม่แบบหลายพันแถว render ทุกแถวจนแท็บค้าง (5,000 แถว ~16 วินาที) — แสดง 200 แถวแรก + "และอีก N แถว" · ปิดไม่ได้ระหว่างอ่านไฟล์/นำเข้า (เดิมปิดแล้วเปิดใหม่นำเข้าซ้ำได้)
- `Dropzone overlay`: วางไฟล์นอกกรอบ → เบราว์เซอร์เปิดไฟล์แทนหน้าเดิม · ช่องไฟล์ที่ซ่อนมีชื่อ
- `InfiniteList` หยุดโหลดเองเมื่อรายการสั้นจนเครื่องหมายท้ายยังอยู่บนจอหลังโหลดเสร็จ
- `PullToRefresh` แบบแคปซูลอยู่เยื้องซ้ายครึ่งตัว (คลาส translate ของ Tailwind v4 บวกซ้อนกับ transform)
- `RadioCards` แบบการ์ดใหญ่ไม่มีกรอบโฟกัสเมื่อใช้คีย์บอร์ด
- `UsageMeter`: ไม่มีชื่อเมื่อ `label` ไม่ใช่ข้อความ และโปรแกรมอ่านจออ่านตัวเลขดิบ (734003200) — ตอนนี้อ่าน "700 MB / 1 GB" ตาม `format`
- `ActivityFeed`/`VersionHistory`: หัววันที่เป็น `li role="presentation"` (axe: ลูกของ `<ol>` ต้องเป็น listitem)
- ช่องเลือกจำนวนแถวต่อหน้าของ DataTable ไม่มีชื่อ (axe `button-name` critical)
- `formatBytes(1048575)` = "1,024 KB" → "1 MB" · `CountBadge value={NaN}` แสดง "NaN" → ไม่แสดง · `UserAvatars max={1}` แสดง 2 ช่อง → 1 ช่อง ("+N")
- `SetupChecklist hideWhenComplete`: ทุกขั้นเป็นตัวเลือก → ซ่อนทันทีทั้งที่ยังไม่ได้ทำอะไร (นับ 0 จาก 0)

## [0.86.0] — 2026-10-30

UX/a11y จากรายงานสำรวจ (ระดับ 2 ข้อที่ผู้ใช้เจอบ่อย) + pattern ที่ supplychain ทำไว้แล้วยกเป็นของกลาง

### Added
- **`StageFilterBar`** — แถบขั้นตอนพร้อมจำนวน (ตัวเลขใหญ่ต่อขั้น + "N ค้างนาน") กดแล้วกรองรายการ ยกจาก PO Tracking ของ supplychain · UiText `stageBar`
- **`<UnsavedChangesGuard dirty />` / `useUnsavedChangesGuard`** (`@suphark/ui/next`) — เตือนก่อนปิดแท็บ/รีเฟรช และก่อนคลิกลิงก์ในแอปเมื่อแก้ค้าง ยกจาก supplychain · UiText `unsavedGuard`
- **`toDateKey(date, { timeZone })`** — วันที่ `YYYY-MM-DD` ตามเวลาไทย (ค่าเริ่มต้น) แทน `toISOString().slice(0, 10)` ที่เลื่อนวันช่วงเที่ยงคืน–7 โมงเช้า
- **`commandContainsFilter`** — ตัวกรองรายการตัวเลือกแบบ "ต้องมีทุกคำที่พิมพ์" · Combobox / MultiSelect / FormFieldSelect / FormFieldCombobox / ตัวกรองของ DataTable ใช้เป็นค่าเริ่มต้น (เดิม fuzzy ของ cmdk: "cotto" ขึ้น "Contractor", ข้อความไทยจับมั่ว)
- `localeSortingFn` (`@suphark/ui/data-table`) — DataTable เรียงข้อความไทยตามพจนานุกรมเป็นค่าเริ่มต้น (เดิมคำขึ้นต้น เ แ โ ใ ไ ไปอยู่หลัง ฮ) · ตัวเลขในข้อความเรียงตามค่า ("PO-9" ก่อน "PO-10")
- `HeaderBreadcrumbs` **`idLabel`** (แสดงรหัสระเบียนเป็นคำกลาง เช่น "รายละเอียด") และ **`hrefs`** (ลิงก์ของส่วนที่ไม่มีหน้าของตัวเอง ไม่ให้เจอ 404) — จาก supplychain
- เมนูหัวคอลัมน์ DataTable มี **"ยกเลิกการเรียง"** (UiText `table.sortClear`) — ตารางที่ลากเรียงได้เดิมเรียงคอลัมน์แล้วลากไม่ได้อีกจน reload

### Changed
- `Button` ที่มี `title` อยู่แล้วไม่ใส่ tooltip อัตโนมัติซ้อน (ขึ้นสองอัน — supplychain ใช้ `title` กับปุ่ม 553 จุด)
- คลิกตัวเลือกที่เลือกอยู่แล้วใน Combobox / FormFieldCombobox / FormFieldSelect = คงค่าเดิม (เดิมล้างค่า — ช่องบังคับกลายเป็นว่างเมื่อกดเพื่อปิดรายการ)
- `--ring` (light) L 0.704 → 0.554: ขอบโฟกัสของคีย์บอร์ดบนพื้นขาว 2.63 → 4.77:1 (ต้อง ≥ 3:1 — WCAG 1.4.11) + เทสต์คอนทราสต์
- `Notice` โทน info/success เป็น `role="status"` (เดิม `alert` ทุกโทน — อ่านแทรกทันทีทุกครั้งที่แสดง) · warning/danger ยังเป็น `alert` · ทับได้ด้วย `role`
- `initialsOf` / `Initials`: ชื่อไทยข้ามสระหน้าและคำนำหน้า — "สมชาย ใจดี" → "สจ" (เดิม "สใ"), "นาย เอกชัย ไทยดี" → "อท" · ตัวอักษรแบบรวม (emoji ZWJ) ใช้ grapheme ทั้งตัว
- `SelectionBar` แบบลอย และ `FloatingSaveButton` ยกพ้น `MobileTabBar` (เดิมทับกัน)

### Fixed
- กด Escape ใน `InlineEdit` / `SearchInput` ปิด dialog/sheet ที่ครอบอยู่ไปด้วย (โฟกัสหลุด) — ตอนนี้ยกเลิก/ล้างคำค้นอย่างเดียว
- ปุ่มลัด (`useHotkeys`) ไม่ทำงานตอนแป้นพิมพ์เป็นภาษาไทย — ใช้แป้นจริงจาก `event.code` เมื่อ `event.key` ไม่ใช่ ASCII · ปุ่มลัดตัวเดียว (เช่น `n`) ไม่ทำงานทะลุ dialog/เมนู/ทัวร์ที่เปิดอยู่ และไม่รัวตอนกดค้าง
- ค้นหาในตาราง (ผูก URL ที่ trim คำค้น) พิมพ์ "ปากกา " หยุดครู่หนึ่งแล้วช่องว่างหาย กลายเป็น "ปากกาสีแดง"
- `ActionButton responsive` บนจอเล็กไม่มีชื่อให้โปรแกรมอ่านจอ (ข้อความ `hidden`) → `max-sm:sr-only` (DeleteManyButton ใช้)
- `SaveStatus` error เป็น "ดำเนินการไม่สำเร็จ" เสมอแม้ `language="en"` หรือส่ง `text.error` เอง
- DataTable: หัวคอลัมน์มี `aria-sort` (เดิมบอกการเรียงแค่ไอคอน)
- `HeaderBreadcrumbs hideIds`: บนหน้า `/orders/123` ลิงก์ "Orders" กลายเป็นหน้าปัจจุบัน กดกลับไม่ได้ — ตัดสินหน้าปัจจุบันจาก path จริง
- AppShell (sidebar): เมนูมี `aria-current="page"` (เดิมแค่สี), เมนูหลักอยู่ใน `<nav>` landmark, ลิงก์ "ข้ามไปเนื้อหา" ข้าม header จริง (เป้าย้ายจาก `<main>` ทั้งก้อนไปที่เนื้อหาใต้ header)
- showcase: หน้า `stage-filter-bar`, `unsaved-changes-guard`

## [0.85.0] — 2026-10-30

performance จากการวัดในรายงานสำรวจ (esbuild bundle ต่อการ import หนึ่งชื่อ, gzip) — ไม่เปลี่ยน API

### Changed
- **`isCatalogIconName` / `resolveCatalogIconName` 54.2 → 3.4 kB gz**: ย้ายไป `icon-name-lookup.ts` ที่อ่านจากตารางชื่ออย่างเดียว (`icon-names.ts` สร้างโดย `gen:icons`) — zod schema ที่ใช้ร่วมกับฟอร์มฝั่ง client (เช่น DueBell) ไม่ดึงไอคอน 372 ตัวเข้า bundle อีก
- **`NamedIcon` / `getCatalogIcon` 56.4 → 43.7 kB gz**: ใช้ตาราง ชื่อ → ไอคอน (`icon-components.ts`) แทน `ICON_CATALOG` ที่มีป้ายไทย/คำค้น · `NamedIcon` ย้ายไป `named-icon.tsx` ที่ไม่มี `"use client"` — render จาก server component ได้โดยไม่ส่งชุดไอคอนไปฝั่ง client · import จาก `@suphark/ui/icons` เหมือนเดิม (icon-select ยัง re-export ไว้)
- **`useIsMobile` เป็น store เดียวทั้งแอป** (`useSyncExternalStore`): เดิมทุก component มี state + matchMedia listener ของตัวเองและ render สองรอบตอน mount (ตาราง 50 แถวที่มีเมนูแถว = 50 listener / 100 render) · mount หลัง hydrate (เปิด dialog) อ่านค่าจริงทันที ไม่กระพริบจากกล่องกลางเป็นแผ่นล่าง
- `Intl.RelativeTimeFormat` ของวันที่สัมพัทธ์ (`formatRelativeCalendarDate` — เรียกทุกเซลล์) และ formatter ของ `currentMonthKey` (ทุก render ของ MonthStepper) เก็บไว้ใช้ซ้ำ (`getRelativeTimeFormat` ใน intl-cache)

### Fixed
- **หมุนมือถือข้าม 768px ระหว่างกรอกฟอร์มในแผ่นล่าง แล้วสิ่งที่พิมพ์หาย** (O3) — `FormDialog` / `ConfirmDialog` / `ImportDialog` / `DialogsProvider` / `ResponsivePopover` ตรึงแบบ (แผ่นล่าง/กล่องกลาง) ไว้ระหว่างเปิด (`useFrozenWhileOpen`) ปิดแล้วค่อยตามจอ

### เลื่อนไปทำแยก (วัดแล้ว ต้องเปลี่ยนโครงทุกปุ่ม/ทุก overlay — ต้องลองกับแอปจริง)
- Tooltip ใน `Button`: ส่วน Root/Trigger ที่ต้อง mount กับทุกปุ่มหนัก ~34 kB gz (ส่วนเนื้อหาที่โหลดทีหลังได้ประหยัดแค่ ~10 kB) — ลดจริงต้องใช้ tooltip ร่วมตัวเดียว (detached trigger) หรือ mount เมื่อชี้ ซึ่งเสี่ยงโฟกัสคีย์บอร์ดหลุด
- Drawer แบบ lazy (−20 kB gz): trigger ของ ResponsivePopover/ActionMenu อยู่ใน Drawer — ต้องแยก trigger ออกก่อน
- cmdk → Base UI Combobox (−17 kB gz ซ้ำซ้อน Radix)

## [0.84.0] — 2026-10-30

แก้บั๊กที่ทำให้ข้อมูลผิดหรือหน้าพังจากการสำรวจ components ชุดใหญ่ (`docs/reports/audit-components-2026-10-30.md`) + บั๊กที่ supplychain แก้ไปแล้วแต่แพ็กเกจยังเป็น — ไม่มีการเปลี่ยน props เดิม ทุกข้อมีเทสต์ที่ล้มกับโค้ดเดิม

### Added
- **`text-2xs`** (10px / บรรทัด 14px) — token ขนาดตัวอักษรเล็กกว่า `text-xs` ค่าเดียวกับ supplychain (เจ้าของตัดสิน 2026-10-30: เพิ่มในแพ็กเกจแทนให้แอปเปลี่ยน 46 จุด)
- `SimpleSheet` **`size`** (`sm`/`md`/`lg`/`xl`/`full` เหมือน SimpleDialog) — แผงข้างกว้างกว่า 384px ได้
- `facetedFilterFn` (`@suphark/ui/data-table`) — ตัวกรองของคอลัมน์แบบติ๊ก DataTable ใส่ให้คอลัมน์ใน `facetedFilters` ที่ไม่มี `filterFn` เอง

### Fixed — ข้อมูลผิด
- `BulkEditDialog` เปิดผ่าน `open` ของแอป: ช่องที่ติ๊กครั้งก่อนค้างอยู่แต่ค่าในช่องว่าง → กดบันทึกเขียนค่าว่างทับทุกรายการที่เลือก · ตอนนี้ล้างทุกครั้งที่เปิด
- `PermissionMatrix` (`name`): พิมพ์ค้นหาแล้วกดบันทึก ส่งเฉพาะสิทธิ์ที่ผ่านตัวกรอง สิทธิ์อื่นถูกถอน · ตอนนี้ส่งจาก `value` ทั้งหมด (รวม id ที่ไม่อยู่ใน `groups`)
- `FormFieldRadioGroup`: ตัวเลือกที่ไม่ใช่ true/false (`daily`/`weekly`) ถูกเก็บเป็น `false` และข้อความ error ไม่แสดง · ตอนนี้เก็บค่าตามตัวเลือก (ตัวเลือก "true"/"false"/"null" ยังเป็น boolean แบบเดิม)
- `FormFieldInput isNumeric`: ค่า 0 แสดงเป็นช่องว่าง และพิมพ์ `2.50` ได้ string ที่ `z.number()` ไม่รับ · ตอนนี้ค่าในฟอร์มเป็น number เสมอ (ว่าง = undefined) ข้อความที่กำลังพิมพ์ ("2.", "2.50") คงไว้จนออกจากช่อง
- ฟอร์มแก้ไขที่ไม่มี `defaultValues` แล้ว `form.reset(data)`: Select / Checkbox / Switch / ColorSelect / RadioCards / Autocomplete ไม่แสดงค่าที่โหลดมา (Base UI ล็อกเป็น uncontrolled ตั้งแต่ render แรก)
- `FormFieldFormattedNumber` หลัง `reset`/`setValue(null)` ยังแสดงตัวเลขเดิมแต่ฟอร์มส่งค่าว่าง (NumericFormat ส่งค่าเดิมกลับมาทับตอน prop เปลี่ยน — รับเฉพาะที่ผู้ใช้พิมพ์แล้ว)
- `thaiBahtText` ปัดเศษจากค่าไบนารี: `1.005` แสดง ฿1.01 แต่ตัวหนังสือ "หนึ่งบาทถ้วน" (0.145 → 0.15 / "สิบสี่สตางค์") · ตอนนี้ปัดจากเลขทศนิยมแบบเดียวกับตัวเลข · เกิน ~9×10¹³ คืน "" แทนตัวหนังสือผิด
- `AmountSummary` / `DocumentHeader`: `-0` แสดง "-0.00", ค่าติดลบเล็ก ๆ แสดง "−0.00" สีแดง, ยอดติดลบเป็น `฿−100.00` / `฿-1,000.00` (สองตัวไม่เหมือนกัน) · ตอนนี้ตัดสินจากค่าหลังปัด และเป็น `−฿100.00` ทั้งคู่
- DataTable แบ่งหน้าฝั่ง client: แก้เซลล์ / ลากเรียง / `router.refresh()` เด้งกลับหน้า 1 · ตอนนี้กลับหน้า 1 เฉพาะเมื่อกรอง/ค้นหา/เรียง และเลื่อนไปหน้าสุดท้ายที่มีเมื่อข้อมูลลดลง
- DataTable `manualPagination` + `rowCount` (ไม่ส่ง `pageCount`): จำนวนหน้า -1 ("หน้า 3 จาก -1", กดถัดไปเข้าหน้าว่างได้) · ตารางว่างแสดง "หน้า 1 จาก 1" แทน "จาก 0"
- ตัวกรองแบบติ๊กของ DataTable: คอลัมน์ตัวเลข/boolean กรองแล้วว่างเปล่า (ค่าที่ติ๊กเป็น string) และจำนวนต่อค่าหาย
- เซลล์แก้ไขได้ (select) หลังบันทึกแสดงค่าดิบ `"b"` ค้างแทนป้าย "ปิด" · ชื่อปุ่มแก้ไขบอกชื่อคอลัมน์และป้ายของค่า
- ปุ่มลบในแถว (`DataTableRowActions`) ไม่หมุนระหว่างลบ กดซ้ำลบซ้ำได้
- ลากเรียง 2 ครั้งติดกันแล้วครั้งแรกบันทึกล้ม: ย้อนทับลำดับครั้งที่สองที่บันทึกสำเร็จ · ตอนนี้ย้อนเฉพาะเมื่อเป็นการบันทึกครั้งล่าสุด
- DataTable โหมดเสมือน: "เลือกทั้งหมด" เลือกแค่ 10 แถวแรก
- `SimpleTable` ติ๊กหัวตาราง: ล้างรายการที่เลือกไว้ในหน้าอื่น/ที่ถูกกรองออก · ตอนนี้เพิ่ม/เอาออกเฉพาะแถวที่แสดง
- `sortableOrderOf`: รายการที่กลุ่มถูกลบไปแล้วหายจากจอและจาก payload ที่บันทึก · ตอนนี้อยู่ในกลุ่ม "ไม่มีกลุ่ม"
- `ChangeDiff`: ค่า BigInt ทำให้ render พัง · ค่าลับที่ไม่เปลี่ยนขึ้น "(เปลี่ยน)" · ค่าเริ่มต้นปิดบัง `keyword`/`sortKey` ด้วย (เปลี่ยนเป็นชื่อลับจริง: secret/token/password/hash, apiKey/secretKey/accessKey…, `*_KEY`) · regex แบบ `/g` ให้ผลสลับกัน · ลำดับ key ของ object และ null↔undefined นับว่าเปลี่ยน
- `WebPushRow`: สมัครในเบราว์เซอร์สำเร็จแต่ server บันทึกล้ม → สวิตช์ขึ้น "เปิด" แต่ไม่มีแจ้งเตือน · ตอนนี้ยกเลิกในเบราว์เซอร์ด้วย, ยกเลิกแจ้ง server ก่อน และสวิตช์ตามสถานะจริงหลังล้ม
- `PhoneInput`: เบอร์บ้าน (02, 03–07) พิมพ์หลักที่ 10 ได้แต่ไม่แสดง แล้วส่งเบอร์ผิดไป · จำกัด 9 หลัก
- พิมพ์ช่วงวันที่ `1/7 - 5/8/68` (ตัวอย่างในเอกสาร) ได้ 5 ส.ค. 68 – 1 ก.ค. 69 · ฝั่งซ้ายที่ไม่ได้พิมพ์ปีใช้ปีของฝั่งขวาแล้ว

### Fixed — หน้าพัง / ปิดผิดจังหวะ
- `ActionForm` / `FormDialog`: server action throw (เน็ตหลุด) ทำให้ทั้งหน้ากลายเป็นหน้า error · ตอนนี้แสดงข้อความในฟอร์ม (`redirect()` ยังผ่าน)
- `HeaderBreadcrumbs`: path ที่มี `%` เดี่ยว (`/files/100%`) ทำให้ layout พัง (URIError)
- `OrganizationSwitcher` / `UserMenu`: สลับองค์กร/ออกจากระบบแล้ว server error → ทั้งหน้าเป็น `error.tsx` · ตอนนี้ขึ้น toast
- `FormDialog` ปิดได้ระหว่างบันทึก (Esc/คลิกนอก/ยกเลิก) → สำเร็จแล้วไม่ refresh / ล้มแล้วไม่เห็น error · ปุ่มยกเลิก/✕ ปิดใช้ระหว่างบันทึก
- `SwipeableRow` ปัดสั้นแล้วเด้งกลับ → การแตะครั้งถัดไปในแถวถูกกินทิ้ง (มือถือไม่ยิง click หลังลาก)
- `Tour` เปิดตอนเป้าหมายยังไม่ render → จำว่า "ดูแล้ว" ถาวร ผู้ใช้ไม่เคยเห็น
- `DeleteManyButton`: `redirect()` ขึ้น toast "NEXT_REDIRECT", `{ ok: false }` ไม่มีข้อความนับเป็นสำเร็จ · ใช้ตัวตีความผลกลาง (`failedResult`/`isNavigationError`)

### Fixed — หน้าตา/สี (ยืนยันบน ui.suphark.com และ axe)
- รายการตัวเลือก (Combobox / MultiSelect / FormFieldSelect / FormFieldCombobox) **ไม่กว้างเท่าปุ่ม** — `w-[--anchor-width]` ผิดไวยากรณ์ Tailwind v4 (วัดจริง: ปุ่ม 236px รายการ 163px) → `w-(--anchor-width)`
- **ทุกแถวในรายการตัวเลือกดูเหมือนถูกเลือก** (พื้น `bg-muted`) — cmdk ใส่ `data-selected="false"` ทุกแถว ส่วน `data-selected:` ของ Tailwind v4 จับแค่ว่ามี attribute → `data-[selected=true]:` ใน `ui/command.tsx` (แก้มือ — supplychain แก้ไว้แล้วใน d2197b6f)
- `Sheet` / `SimpleSheet` กว้างได้ไม่เกิน 384px แม้ส่ง `sm:max-w-2xl` (คลาส `data-[side=right]:sm:max-w-sm` specificity สูงกว่า) → ขนาดตามด้านเป็นคลาสธรรมดาใน `ui/sheet.tsx` (แก้มือ)
- ปุ่มปิดของ `Dialog` / `Sheet` อ่านออกเสียง "Close" ตายตัว → ตาม UiText (`close`: "ปิด"/"Close") ใน `ui/dialog.tsx` / `ui/sheet.tsx` (แก้มือ)
- สีโทนลบ: ปุ่ม/ป้าย `bg-destructive/10 text-destructive` คอนทราสต์ **3.99 → 4.61:1** (`--destructive` light L 0.577 → 0.535; บนพื้นขาว 4.76 → 5.53, ตัวหนังสือขาวบนพื้นแดง 5.53) · ธีมมืดผ่านอยู่แล้ว (4.70 บน card)
- ตัวหนังสือโทนเตือน `text-warning` (เหลือง) บนพื้นขาว **1.57:1** — `Stat tone="warning"` และ Stepper ขั้น "มีปัญหา" ใช้ `text-warning-muted-foreground` (8.69:1)
- `brandColor` ที่ไม่ส่ง `brandForeground`: `--primary-foreground` เป็นค่าใช้ไม่ได้ ตัวหนังสือบนปุ่มสีแบรนด์สืบทอดสีเข้ม · ตอนนี้ fallback เป็นสีขาวของ primary เดิม
- เทสต์คอนทราสต์ token (`token-contrast.test.ts`) กันสีโทนลบ/เตือนถอยกลับ

## [0.83.0] — 2026-10-29

### Added
- **`isCatalogIconName(name)`** (`@suphark/ui/icons`) — ตรวจว่าชื่อแสดงเป็นไอคอนในชุดได้ (รวมชื่อเดิมแบบ `"Home"`) ใช้ใน zod/server action: `icon: z.string().refine(isCatalogIconName)`

### Changed
- `resolveCatalogIconName` / `getCatalogIcon` ย้ายไปไฟล์ `icon-catalog-lookup.ts` ที่ไม่มี `"use client"` — เรียกจาก server ได้ (เดิมอยู่ใน icon-select.tsx ซึ่งเป็น client module: server action ที่เรียกจะ error) · import จาก `@suphark/ui/icons` เหมือนเดิม และ icon-select ยัง re-export ไว้

## [0.82.0] — 2026-10-28

ชุดไอคอนครอบคลุมตัวเลือกไอคอนของแอปเดิมทั้งหมด และอ่านชื่อที่แอปเก็บไว้แบบเดิมได้ — ย้ายมาใช้ `IconSelect`/`NamedIcon` โดยไม่ต้องแปลงข้อมูลใน DB

### Added
- ชุดไอคอน `@suphark/ui/icons` 322 → **372 ตัว** (จากการสแกนแอป 8 ตัว แบบอ่านอย่างเดียว): ไอคอนในตัวเลือกไอคอนของ DueBell (44), Pi Done (32), supplychain (63) อยู่ในชุดครบแล้ว + ไอคอนที่หลายแอปใช้เป็นสัญลักษณ์ของสิ่งของ เช่น คีย์ API, webhook, สำรองข้อมูล, แดชบอร์ด, กราฟแท่ง, แผนงาน, ข้อความ, กระดิ่งดัง/ปิดแจ้งเตือน, ปลดล็อก, ยืนยันแล้ว, รถราง, กรรไกร
- **`resolveCatalogIconName(name)`** + `ICON_ALIASES` — รับชื่อในชุด (`"house"`), ชื่อ component ของ lucide (`"House"`, `"CreditCard"`) และชื่อเดิมก่อน lucide เปลี่ยน (`"Home"`, `"AlertTriangle"`, `"alert-triangle"`, `"BarChart3"`) · `getCatalogIcon`/`NamedIcon`/`IconSelect value` ใช้ตัวนี้แล้ว — ค่าเดิมใน DB ของ DueBell/supplychain (PascalCase) และ Pi Done (kebab) แสดงรูปเดียวกับที่แอปแสดงอยู่ครบ 139 ค่า · `gen:icons` สร้างตารางชื่อจาก export ของ lucide-react และหยุดถ้าสองชื่อในชุดเป็นรูปเดียวกัน

### Docs
- หน้า design-system ตัวอย่าง `text-caption` ใช้อีเมล `@example.com` (เดิม `@company.com` — release-check ตรวจอีเมลใน tarball แล้ว)

## [0.81.0] — 2026-10-27

ตัวตรวจคุณภาพ: smoke test เปิดทุกหน้า showcase ใน Chrome, เทสต์ contrast ของชุดสี, กฎ audit ใหม่ — และแก้สิ่งที่ตัวตรวจเหล่านี้เจอ ไม่ลบ/เปลี่ยน prop

### Added
- `suphark-ui-audit` กฎใหม่ (warning): `space-utility` (`space-x-*`/`space-y-*` → flex/grid `gap-*`), `z-arbitrary` (`z-[…]` → overlay จัดลำดับเอง; ซ้อนภายใน component ใช้ `z-1`/`z-10`) · `raw-palette` เจอคู่ป้ายสีที่ทำเอง (`bg-teal-100 text-teal-800` บรรทัดเดียวกัน) แนะนำ `LabelBadge` / `paletteClasses(color)` แทน semantic token

### Fixed
- `FormattedNumber` ตั้งแค่ `maximumFractionDigits: 0` (ตัวอย่างใน doc เอง) แสดง "-" + `console.error` RangeError เพราะชนค่าเริ่มต้น `minimumFractionDigits: 2` — ตั้งฝั่งเดียวแล้วอีกฝั่งปรับตาม (`min ≤ max`) · พบด้วย smoke test
- ชุดสีป้ายกำกับ `variant="solid"` ใน light mode 5 สีไม่ถึง AA 4.5:1 (ส้ม 4.36, มรกต 3.67, เขียวหัวเป็ด 3.66, ฟ้าน้ำทะเล 3.60, ฟ้า 4.02) → `gen:palette` คำนวณ contrast จริง (OKLab → sRGB) แล้วเลื่อนเป็นเฉด 700 เมื่อเฉด 600 ไม่ผ่าน (ส้มเปลี่ยนตัวอักษรเป็นขาว) · เทสต์ `palette-contrast` ตรวจทุกสี × solid/subtle/outline × light/dark

### Changed
- เลิกใช้ `space-x/y-*` ในแพ็กเกจ (19 จุด) เป็น flex/grid `gap-*`: `FormFieldBoolean`, `FormFieldRadioGroup`, `FormFieldRadioCards`, `ErrorState`, `PageShell`, `PageSkeleton`, `DateRangePicker`, หน้า design-system · `FormItem` ที่เคยมี `space-y-3` ซ้อนกับ `gap-2` ของ FormItem (ห่างเกิน) เหลือ `gap-3` · `z-[1]`/`z-[60]` → `z-1`/`z-60`

### Docs
- `pnpm smoke:showcase` (root) — `next start` showcase ที่ build แล้ว (ปิด auth) เปิดทั้ง 191 หน้าใน Chrome ตรวจ HTTP, `pageerror`, `console.error`, resource 404 · ใน CI หลัง build
- showcase: `mobile-tab-bar` ลิงก์ชี้หน้าที่มีจริง (เดิม `/bills` … ถูก prefetch แล้ว 404 ใน console)
- showcase: หน้า `label-badge` 404 บน production (ทะเบียนชี้ demo ของ color-select แต่หน้าอ่าน source จาก `demos/<slug>.tsx`) — แยก demo ของตัวเอง + `pnpm check:demos` ตรวจทะเบียนกับไฟล์ demo ใน verify/CI

## [0.80.0] — 2026-10-27

ชุดสีมาตรฐาน 20 สี + ชุดไอคอนมาตรฐานพร้อมคำค้นไทย, BulkEditDialog, PermissionMatrix, StepForm คุมขั้นจากภายนอก, แก้ลูกศรคีย์บอร์ดใน Calendar — เพิ่มอย่างเดียว ไม่ลบ/เปลี่ยน prop เดิม

### Added
- **ชุดสีป้ายกำกับมาตรฐาน 20 สี** (`lib/palette`, token `label-*` ใน `palette.css` ที่ `styles.css` import ให้เอง) — เทา/เทาฟ้า/เทาอุ่น, แดง, กุหลาบ, ส้ม, อำพัน, เหลือง, เขียวมะนาว, เขียว, มรกต, เขียวหัวเป็ด, ฟ้าน้ำทะเล, ฟ้า, น้ำเงิน, คราม, ม่วงคราม, ม่วง, บานเย็น, ชมพู · ต่อสี 5 token (`label-<c>`, `-foreground`, `-subtle`, `-subtle-foreground`, `-border`) สลับ dark ให้เอง ตัวอักษรบนพื้นเข้มเลือกขาว/เข้มตาม contrast · `PALETTE_COLORS`, `PALETTE_BASIC` (8 สี), `PALETTE`, `paletteClasses(color)`, `paletteLabel`, `isPaletteColor` · สร้างจาก palette ของ Tailwind ด้วย `pnpm --filter @suphark/ui gen:palette`
- **`LabelBadge`** — ป้ายสีที่ผู้ใช้ตั้งเอง (หมวด/แท็ก) `variant` subtle / solid / outline / dot + `icon`
- **`ColorSelect`** — ช่องเลือกสีสำเร็จรูป (ปุ่มเม็ดสี + ชื่อ → กริดสี, แผ่นล่างบนมือถือ), `colors`, `clearable`, `name` (input ซ่อน) · `paletteColorItems()` แปลงชุดสีให้ `ColorPicker`
- **`@suphark/ui/icons`** (entry ใหม่) — `ICON_CATALOG` ไอคอนมาตรฐาน 322 ตัว 17 หมวด (ทั่วไป, การเงิน, เอกสาร, คน/องค์กร, สื่อสาร, เวลา, ขนส่ง, สถานที่, ก่อสร้าง/ช่าง, ร้านค้า, อาหาร, สุขภาพ, การศึกษา, เทคโนโลยี, สื่อ/บันเทิง, ธรรมชาติ, สถานะ) พร้อมชื่อไทย/อังกฤษ + คำค้น · **`IconSelect`** ช่องเลือกไอคอนสำเร็จรูป (ค้นหา + ปุ่มหมวด, `showLabel={false}` = ปุ่มไอคอน, `accentColor`, `clearable`, `name`) · **`NamedIcon`** / `getCatalogIcon` แสดงไอคอนจากชื่อที่เก็บไว้ · แยก entry เพราะ import ไอคอนทั้งชุด · เพิ่มไอคอนที่ `scripts/icon-catalog.txt` แล้ว `gen:icons`
- **`IconPicker`**: `categories` (ปุ่มกรองหมวดตาม `item.category`), ค้นหลายคำเรียงตามความตรง (`iconSearchScore`), ลูกศร/Home/End เลื่อนในกริด (Tab เข้าช่องเดียว — เดิม Tab ไล่ทุกไอคอน), `autoFocusSearch`
- **`BulkEditDialog`** (`@suphark/ui/next`) — แก้หลายรายการพร้อมกัน: ติ๊กช่องที่จะเปลี่ยน (ช่องที่ไม่ติ๊ก disabled จึงไม่อยู่ใน FormData), ป้าย "ค่าต่างกัน" (`mixed`), แตะช่องที่ปิดอยู่ = ติ๊กให้, `onSubmit(formData, fields)` ล้มเหลวแสดงในกล่อง สำเร็จ toast · ทำบน `FormDialog` (`sheetOnMobile`)
- **`PermissionMatrix`** — ตารางบทบาท × สิทธิ์: ติ๊กทีละช่อง / ทั้งหมวด / ทั้งคอลัมน์ (tri-state), ค้นหาสิทธิ์ (> 12 รายการ), `baseline` ไฮไลต์ช่องที่แก้ + "แก้แล้ว n จุด · คืนค่า", บทบาท `locked`, `name` = input ซ่อน `"role:permission"` · `countPermissionChanges`
- **`StepForm step`** — คุมขั้นจากภายนอก (เช่นเก็บใน URL) คู่ `onStepChange` ซึ่งยังตรวจขั้นก่อนไปต่อเหมือนเดิม
- `FormFieldColorSelect colors` — `"all"` = ชุดสี 20 สี หรือส่งรายการเอง (ค่าเริ่มต้น 8 สีเดิม)
- UiText `lang` (ชื่อสี/ไอคอนเลือกภาษาตามนี้), `colorSelect`, `iconSelect`, `bulkEdit`, `permissionMatrix` (TH/EN)

### Changed
- `lib/status-colors` (`statusColorThemes`, `getStatusColorTheme`, `getStatusColorClass`) ใช้ token ของชุดสีป้ายกำกับแทน `bg-red-200 text-red-800` … → ใช้ได้ใน dark mode และรับสีใหม่ทั้ง 20 สี (ชื่อ/type เดิมทั้งหมด พื้นอ่อนลงหนึ่งเฉด)

### Fixed
- `Calendar` ลูกศรคีย์บอร์ดไม่ย้ายโฟกัสวัน (`CalendarDayButton` ไม่ผูก `ref` กับปุ่ม) — กระทบ `DatePicker`/`DateRangePicker`/`DateTimePicker` และทุกที่ที่ใช้ Calendar · แก้ไฟล์ shadcn เป็นข้อยกเว้น (บรรทัดเดียว — ต้องคืนด้วย `git checkout` หลัง `shadcn add --overwrite`)

### Docs
- agent-rules: แถวใหม่ (สีที่ผู้ใช้เลือก, ไอคอนที่ผู้ใช้เลือก, แก้หลายรายการ, ตารางสิทธิ์) · design-system: ชุดสีป้ายกำกับ
- showcase: หน้าใหม่ `color-select`, `label-badge`, `icon-select`, `bulk-edit-dialog`, `permission-matrix` · หมายเหตุ `icon-picker`/`color-picker`/`step-form`

## [0.79.0] — 2026-10-27

ชุด B ข้อ 3–8 จากการสำรวจ 2026-10-26 ตาม mockup https://claude.ai/artifact/4vzZfeGz6ms56xaKNAXDci (ExportJobsPanel เลื่อนไปตอนย้าย supplychain) — เพิ่มอย่างเดียว

### Added
- **`UsageMeter`** + `usageLevel()` — แถบโควตา "ใช้ไป X จาก Y": เหลืองที่ 80% (`warnAt`) แดงที่ 95% (`dangerAt`) พร้อมป้ายเป็นคำ ("ใกล้เต็ม", "เหลือ 280", "เกินโควตา"), `limit={null}` = ไม่จำกัด (เส้นประ), `variant="compact"` สำหรับแถบข้าง, `role="meter"` (auth/files/pdf ทำเอง)
- **`VersionHistory`** — ประวัติรุ่นบนฐาน `ActivityFeed` (จัดกลุ่มตามวัน, avatar, `details` พับได้) + ป้าย "รุ่นปัจจุบัน" + กู้คืนที่ถามยืนยันในแถว (ไม่ซ้อน dialog) · `onRestore` throw/คืน `{ ok: false }` = toast และคงแถวยืนยัน (config/files/pdf/duebell ทำเอง)
- **`SectionCard collapsible`** / **`ListSection collapsible`** — หัวเป็นปุ่ม (`aria-expanded`), `initialOpen`, `open`/`onOpenChange`, `storageKey` จำใน localStorage, `summary` ท้ายหัวตอนหุบ (SectionCard) · ไม่ส่ง `collapsible` = เหมือนเดิมทุกอย่าง · hook `useCollapsible`
- **`AccessDenied`** — หน้าไม่มีสิทธิ์: สิทธิ์ที่ขาด (`permission`), บัญชีที่เข้าอยู่ + "สลับบัญชี" (`account`, `onSwitchAccount`), "กลับหน้าหลัก" (`homeHref`), "ขอสิทธิ์จากผู้ดูแล" เฉพาะเมื่อส่ง `requestHref` · ลิงก์ใช้ `linkComponent` จาก UiDefaultsProvider (config/files/notify/pdf ทำเอง)
- **`ExportMenu`** — เมนู Excel/CSV/PDF (หรือรูปแบบเอง) + หัว "N รายการตามตัวกรอง" + "เฉพาะแถวที่เลือก (n)" · `onExport` คืน `Response`/`Blob` แล้วดาวน์โหลดให้ พร้อม toast กำลังเตรียม/สำเร็จ/ล้มเหลว
- **`downloadResponse(res, fallbackName)`**, `downloadBlob(blob, name)`, `fileNameFromContentDisposition(header)` — ดาวน์โหลดจาก API (ชื่อไทยแบบ `filename*=UTF-8''…` ได้; Response ไม่ ok = throw ข้อความจาก server) (supplychain เขียนเอง 6 จุด)
- **`ActiveFilterChips`** — ชิป "ชื่อ: ค่า ×" + "ล้างทั้งหมด" (≥ 2 ชิป) + `summary` สำหรับหน้าที่ไม่ใช้ DataTable · จอแคบแถวเดียวเลื่อนแนวนอน
- `formatBytes` รับ `bigint` / `string` (BigInt ของ Prisma) — files/pdf มีสำเนาของตัวเองเพราะเรื่องนี้
- UiText `usage`, `versions`, `accessDenied`, `exportMenu`, `filterChips` (TH/EN)

### Fixed
- `DocumentHeader` ปุ่มลิงก์รอง (outline) ไม่มีขอบ — `buttonVariants` ต้องผ่าน `cn()` ให้ `border-border` ชนะ `border-transparent` ของฐาน (เจอตอนทำ AccessDenied) · `DeleteManyButton` ปุ่มยืนยันผ่าน `cn()` เช่นกัน

### Docs
- agent-rules: 6 แถวใหม่ในตาราง "ใช้ตัวสำเร็จรูปก่อน"
- showcase: หน้าใหม่ `usage-meter`, `version-history`, `access-denied`, `export-menu`, `active-filter-chips` · `list-section` และ `page-header` เพิ่มตัวอย่าง collapsible

## [0.78.0] — 2026-10-27

ข้อ 1–2 + ชุดชื่อ prop ร่วมจากการสำรวจ 2026-10-26 — เพิ่มอย่างเดียว ชื่อเดิมใช้ได้ทุกตัว แอปเดิมไม่ต้องแก้

### Added
- **`ActionMenu` เมนูย่อย / radio / checkbox** — `{ type: "sub", label, items }`, `{ type: "radio", label?, value, onValueChange, options }`, `{ type: "checkbox", label, checked, onCheckedChange }` (radio/checkbox กดแล้วเมนูยังเปิด) · แผ่นล่างบนมือถือ: เมนูย่อยเป็นหัวกลุ่ม + รายการ, radio/checkbox มี ✓ ท้ายแถว (pi-done ประกอบ DropdownMenuSub/RadioGroup เองราว 30 จุด)
- **`ContextActionMenu`** — เมนูคลิกขวา (กดค้างบนจอสัมผัส) จาก items ชุดเดียวกับ ActionMenu รวม confirm/toast เมื่อ action ล้มเหลว (files/pdf/pi-done ทำ ContextMenu เอง)
- **`SelectionBar` action ที่มี `items`** — ปุ่มคำสั่งหมู่ที่เปิดเมนู ("ตั้งสถานะ ▾") · `onClick` ไม่บังคับเมื่อมี items
- **`UiTextProvider locale` / `overrides`** — `locale="en"` เลือกชุดในตัว, `overrides` ทับทีละคีย์ในกลุ่ม · เป็นค่าธรรมดาจึงส่งจาก server layout ได้ (เดิมต้องห่อ client component เพราะ spread `UI_TEXT_*` ใน server ได้ค่าว่าง — 5 แอปเขียนตัวสลับเอง) · type `UiTextOverrides`
- **`UiDefaultsProvider`** (`sheetOnMobile`, `linkComponent`) + `useSheetOnMobile` / `useUiDefaults` — ตั้งค่าตั้งต้นครั้งเดียวที่ root: ActionMenu, RowActions, RowMenu, ConfirmDialog, ConfirmActionButton, FormDialog, ImportDialog, DialogsProvider, DataTableRowActions อ่าน `sheetOnMobile`; DocumentHeader/DocumentFlow อ่าน `linkComponent` (prop ที่ส่งตรงชนะ)
- ชื่อ prop ร่วม (alias — ชื่อเดิมใช้ได้):
  - `onClick` ของคำสั่ง: `Banner action`, `NotificationCenter` (action/chip/entry/`viewAll`), `RecordCard`, `RowActions` item, `SwipeableRow` action, `CommandPalette` item (เดิม `onSelect` — agent-rules บอกให้ใช้ onClick แต่แพ็กเกจเองไม่ตรง)
  - `isLoading`: `Button` (= `loading`), `ConfirmDialog` (= `pending`), `NotificationCenter` (= `busy`)
  - โทน `danger`/`neutral` (= `destructive`/`default`): `ActivityFeed`, `ProgressBar`, `SegmentedControl`, `Stat`, `CountBadge` (`neutral` = muted), `EmptyState`, `SettingsRow`
  - `empty`: `TreeView` (= `emptyState`), `ActivityFeed` (= `emptyLabel`), `Combobox`/`MultiSelectCombobox` (= `emptyText`)
- UiText `combobox.placeholder` / `combobox.searchPlaceholder`

### Fixed
- `Combobox` ค่าตั้งต้นภาษาอังกฤษ ("Select...", "Search...", "No results found.") → UiText (ไทย "เลือก...", "ค้นหา...", "ไม่พบข้อมูล") · `MultiSelectCombobox` placeholder/ค้นไม่พบอ่านจาก UiText (แอปอังกฤษได้อังกฤษ)

### Docs
- agent-rules: แถวเมนูคลิกขวา, ปุ่มคำสั่งหมู่ที่เปิดเมนู, `UiDefaultsProvider`/`UiTextProvider locale`, ชื่อ prop ร่วม
- showcase: action-menu เพิ่มตัวอย่างเมนู "มุมมอง" (radio + checkbox) และไฟล์ที่คลิกขวาได้ (เมนูย่อย "ย้ายไป") คู่ปุ่ม …

## [0.77.0] — 2026-10-27

ชุดแก้จากการสำรวจแพ็กเกจรอบ 2026-10-26 (ข้อความแปลไม่ได้, มือถือ, คีย์บอร์ด, เอกสาร) — แอปเดิมไม่ต้องแก้อะไร

### Added
- **`RowMenu` `sheetOnMobile` / `sheetTitle`** — ส่งต่อให้ `RowActions` และ `FormDialog` ของเมนู (เดิมมีใน RowActions แต่ RowMenu ไม่ส่งต่อ)
- **UiText** — `errorState` (title/description/reference/retry/home), `navigating` (toast ของ `TransitionLink`), `table.filterButton`/`resetFilters`/`sortAsc`/`sortDesc`/`hideColumn`, `combobox.moreCount`, `filter.clearAll` (มีทั้ง TH/EN)
- ตัวตรวจข้อความฝัง (`scripts/hardcoded-text.mjs`) จับข้อความที่ขึ้นบรรทัดเองระหว่างแท็ก และข้อความอังกฤษใน JSX (`findHardcodedEnglish`) — เดิมเห็นเฉพาะข้อความบรรทัดเดียวกับแท็ก

### Fixed
- ข้อความที่แปลภาษาไม่ได้ 16 จุด → UiText: `ErrorState` ("ลองใหม่"/"กลับหน้าหลัก"/"รหัสอ้างอิง:" และ title/description ตั้งต้น), ตัวกรองของ DataTable (ปุ่ม "ตัวกรอง", "ล้างตัวกรอง", "เลือกทั้งหมด", "เลือก N รายการ"), เมนูหัวคอลัมน์ "Asc/Desc/Hide" (อังกฤษ → "เรียงน้อยไปมาก/เรียงมากไปน้อย/ซ่อนคอลัมน์"), `ThemeToggle` "Light/Dark/System" (อังกฤษ → สว่าง/มืด/ตามระบบ), `MultiSelectCombobox` "+N รายการ", `ResourcePropertyFilter` "ล้าง", toast ของ `TransitionLink`, ปุ่มคัดลอกใน `FormFieldInput` ("Copy to clipboard" → `UiText.copy` + มี aria-label)
- `SimpleTable` แถวที่มี `onRowClick` กดด้วยคีย์บอร์ดได้ (Tab + Enter/Space, วงโฟกัส) ทั้งตารางและรายการมือถือ
- `FormFieldColorSelect` เติม `"use client"` (import จาก server component แล้วพัง)
- พื้นที่แตะ ≥ 44px บนจอสัมผัส: ปุ่ม … ของ `HeaderCrumbs` (จอแคบ), ปุ่ม × ของชิปตัวกรอง DataTable (+ วงโฟกัส), ปุ่ม "เลือกทั้งหมด/ล้างทั้งหมด" ของ `MultiSelectCombobox` (+ วงโฟกัส)

### Docs
- `agent-rules.md`: ตัดแถว ActivityFeed ที่ซ้ำ, setup ใช้ `<AppToaster />` + บอกวิธีครอบ `UiTextProvider`, เพิ่มแถว Stat/StatGrid, CopyButton, useDialogs, DeleteManyButton, MultiSelectCombobox, TreeView, CommandPalette, Dropzone/UploadList, ErrorState
- showcase: หน้าใหม่ 5 หน้า — `scrollable-tabs-list`, `simple-select`, `form-invalid-notice`, `page-shell`, `error-state`

## [0.76.0] — 2026-10-26

### Added
- **`NotificationCenter` `beforeList`** — slot ของแอปใต้หัว (และใต้แท็บของ `quiet`) ก่อนรายการ เช่นการ์ด "เกินกำหนด N งาน" ใต้หัว "แจ้งเตือน" · แสดงแม้ `items` ว่าง (อยู่เหนือ `empty`) · อยู่ใน `<section>` เดียวกัน ไม่มีกรอบ/ระยะเพิ่ม (ขอจาก pi-done)
- showcase: ตัวอย่าง `NotificationCenter` แบบ quiet ที่มี `Notice` ใน `beforeList` และรายการว่าง

## [0.75.0] — 2026-10-26

ข้อความตั้งต้นของปุ่มมาตรฐานเป็นภาษาไทยผ่าน UiText (เดิมฝังภาษาอังกฤษ) — แอปที่ส่ง `label`/`children` เองหรือตั้ง `UI_TEXT_EN` ไม่เปลี่ยน

### Added
- **UiText `buttons`** (addNew/createNew/saving/saved/delete/deleting/print/refresh), **`deleteMany`** (trigger/title/description/items/success ใช้ `{count}`/`{items}`), **`clipboard`** (success/failed) — มีทั้ง `UI_TEXT_TH` และ `UI_TEXT_EN` (EN = ข้อความเดิม)

### Changed
- **`AddNewButton` `CancelButton` `ConfirmButton` `SaveButton` `SubmitButton` `DeleteButton` `PrintButton` `RefreshButton` `FloatingSaveButton`** — ค่าตั้งต้นของ label/loadingLabel/createText/editText/saveText ฯลฯ อ่านจาก UiText (ไม่มี provider = "เพิ่มใหม่"/"ยกเลิก"/"ยืนยัน"/"บันทึก"/"สร้างใหม่"/"ลบ"/"พิมพ์"/"รีเฟรช"/"กำลังบันทึก..."/"บันทึกแล้ว") ตรงกับ supplychain; props ชนะเสมอ
- **`DeleteManyButton`** — ข้อความปุ่ม/กล่องยืนยัน/toast ที่ฝังอังกฤษในโค้ดย้ายไป `UiText.deleteMany` (ไทย: "ลบ (2)", "ลบ 2 รายการที่เลือก?", "ลบ 2 รายการแล้ว"); `itemDescription` ค่าตั้งต้น `UiText.deleteMany.items`
- **`useCopyToClipboard`** — toast ตั้งต้น `UiText.clipboard` ("คัดลอกแล้ว"/"คัดลอกไม่สำเร็จ") แทน "Copied to clipboard"/"Failed to copy" — มีผลกับ `FormFieldInput` แบบคัดลอกได้ด้วย
- `DataTableRowActions` ปุ่มลบในกล่องยืนยันเป็น "ลบ" ตาม `DeleteButton`
- showcase: หมายเหตุ standard-buttons ว่าข้อความตั้งต้นมาจาก UiText

## [0.74.0] — 2026-10-26

เตรียมย้าย supplychain (props ที่ supplychain ใช้อยู่แต่แพ็กเกจยังไม่มี) — เพิ่มอย่างเดียว แอปเดิมไม่เปลี่ยน

### Added
- **`PageShell` `subNav`** — เมนู/แท็บย่อยใต้หัวหน้า render พร้อมหัวหน้า นอก Suspense (แสดงทันทีระหว่างเนื้อหาโหลด)
- **DataTable `mobileView={(table) => …}`** — จอ < md แสดงการ์ด/รายการที่แอปทำเองแทนตาราง ใช้ตัวกรอง/การเรียง/การแบ่งหน้าร่วมกัน (มีค่า = ใช้แทนรายการอัตโนมัติของ `quiet`; `error` ยังแสดงตาราง)
- **DataTable `selectionBar={(table) => …}`** — แถบคำสั่งของแถวที่เลือกที่แอปทำเอง วางระหว่างตารางกับการแบ่งหน้า (ทุก variant — `selectionActions` เดิมใช้ได้เฉพาะ `quiet`)
- **DataTable `collapseFilters`** — ตัวกรองอยู่ในปุ่ม "ตัวกรอง" เสมอแม้จอกว้าง
- `UiText.table.columns` / `toggleColumns`

### Changed
- **เมนูซ่อน/แสดงคอลัมน์ของ DataTable** ใช้ชื่อจาก `columnDef.meta.label` → หัวคอลัมน์ที่เป็นข้อความ → id (เดิมแสดง id เช่น "vendor Name") · ปุ่ม "View" → "คอลัมน์", หัวเมนู "Toggle columns" → "แสดงคอลัมน์" (UiText ไทย/อังกฤษ) · ไม่ augment `ColumnMeta` ของ tanstack (ประกาศ key แล้ว meta ที่มี key อื่นของแอปจะ type error)
- `PageShell`: แถวหัวข้อ/ปุ่มตัดบรรทัดบนจอแคบ (ปุ่มลงไปใต้หัวข้อแทนการล้นจอ) เหมือน supplychain
- showcase: data-table มีตัวอย่าง `mobileView` + `collapseFilters` และคอลัมน์ใส่ `meta.label`

## [0.73.0] — 2026-10-26

### Added
- **`DocumentHeader`** — หัวหน้ารายละเอียดเอกสาร (ใบขอซื้อ, ใบสั่งซื้อ, งานประกวดราคา…): `breadcrumb` (ซ่อนบนมือถือ), `backHref` ปุ่มกลับ, `number` เลขเอกสาร (mono), `title` + `status`, `meta` ข้อมูลย่อ (`hideOnMobile` ต่อรายการ, มือถือซ้อนบรรทัด), `totals` ยอดรวม (ตัวเลข = ฿ + ทศนิยม 2 ตำแหน่ง หรือ `format` เอง, `tone` success/danger/muted), `primaryAction` + `secondaryActions` (ปุ่มรอง onClick/href รอ async + toast เมื่อพลาด) + `actions` (เมนู ⋯ ของ ActionMenu), `children` (เช่น DocumentFlow) · **`stickyActionsOnMobile`** = จอ < md ปุ่มหลักเต็มความกว้าง + ⋯ ไปอยู่แถบล่าง 44px (ปุ่มรองรวมเข้า ⋯ ให้เอง, แผ่นคำสั่งล่าง), ยกเหนือ `MobileTabBar` และเว้นที่ท้ายหน้าให้เอง (`styles.css`) · `linkComponent={Link}` สำหรับแอป Next · `headingAs`
- `UiText.documentHeader` (`back`, `more`)
- showcase: หน้าใหม่ document-header

## [0.72.1] — 2026-10-26

### Fixed
- **`formatThaiFullDate` นับวันตามเวลาไทย** — เดิมใช้ `getDate()` ตามโซนของเครื่อง → บน server (Vercel = UTC) เวลา 00:00–06:59 ของไทยแสดงเป็นวันก่อนหน้า และ server กับ browser ได้คนละวัน · ตอนนี้ค่าเริ่มต้น `Asia/Bangkok` (เหมือน `ClientDateFormatter`) ส่ง `{ timeZone }` เป็นอาร์กิวเมนต์ที่ 2 ได้ · `DatePicker` (ไม่ส่ง locale) ยังนับตามโซนของเครื่องเพราะวันที่ที่เลือกเป็นเที่ยงคืน local · กระทบ tooltip ของ `RelativeDate` ด้วย

## [0.72.0] — 2026-10-26

ชุดงานเอกสารจัดซื้อ 5 ตัวจากการสำรวจ supplychain (pattern ที่แอปประกอบเองซ้ำใน 3 feature ขึ้นไป) — ของใหม่ทั้งหมด แอปเดิมไม่เปลี่ยน

### Added
- **`ApprovalTimeline`** — ลำดับอนุมัติแนวตั้ง: สถานะต่อขั้น `done`/`current`/`rejected`/`skipped`/`pending` (จุด ✓/✕/เลขขั้น, เส้นเขียวถึงขั้นที่เสร็จ), ผู้อนุมัติหลายคน (`approvers` + ✓/✕ รายคน, UserAvatars), `policy` `"all"`/`"any"`/ReactNode, ความคืบหน้า "กำลังรอ · 1 จาก 2", `reason` ของขั้นที่ข้าม, `comment`, `at` (เวลาจบ) / `waitingSince` (รอมานานเท่าไร), `extra` (ปุ่มของผู้ใช้ปัจจุบัน), `aria-current="step"` · `density="compact"` สำหรับ popover
- **`DocumentFlow`** — โซ่เอกสารแนวนอน (PR → PO → DP → CV): ช่องละเลข + ประเภท + สถานะ, ช่อง `current` เน้น + `aria-current`, ช่องที่ยังไม่มี = เส้นประ "ยังไม่สร้าง", เลื่อนแนวนอนในกล่องตัวเอง · `linkComponent={Link}` สำหรับแอป Next (barrel ไม่พึ่ง next/link)
- **`RecordSection`** — รายการย่อยในหน้ารายละเอียด: หัวการ์ด + `CountBadge` + `description` + ปุ่มเพิ่ม (`addLabel`/`onAdd` หรือ `addButton`) + `actions`, `count === 0` + `empty` = สถานะว่างพร้อมปุ่มเพิ่มแทน children · จอ < sm ปุ่มย้ายไปท้ายการ์ดเต็มความกว้าง 44px
- **`ComparisonMatrix`** — ตารางเทียบ รายการ × ผู้เสนอราคา: คอลัมน์แรกติดซ้าย, `groupBy` หัวหมวด, `highlight` `"min"`/`"max"` เน้นค่าดีที่สุดต่อแถว (เสมอกันได้หลายช่อง, ต้องมีอย่างน้อย 2 ค่า, ผู้อ่านจอได้ยิน "(ต่ำสุด)"), `reference` + `showDiff` = % เทียบราคากลาง (ทิศที่แย่เป็นสีแดง), `total` แถวรวม — **ผู้ที่เสนอไม่ครบทุกแถวไม่ถูกเน้น/คิด % ในแถวรวม** (ป้าย "เสนอไม่ครบ") · ช่องว่าง = "—" · จอ < md เป็นรายการทีละแถวเรียงจากดีไปแย่ · แสดงผลอย่างเดียว
- **`AmountSummary`** — สรุปยอดเงิน: `lines` (ค่าติดลบใช้ − สีแดง, `kind: "subtotal"` มีเส้นคั่น, `hint`), `total` ตัวหนาเส้นคู่, `bahtText` จำนวนเงินเป็นตัวอักษร, `currency`, `format`, `variant="inline"` แถวเดียวสำหรับหัวเอกสาร · แอปคำนวณเอง
- **`thaiBahtText`** (`lib/thai`) — จำนวนเงินเป็นตัวอักษรตาม BAHTTEXT ของ Excel: เอ็ด/ยี่สิบ/ล้าน (หนึ่งล้านเอ็ด), สตางค์/ถ้วน, ติดลบ = "ลบ…", ปัดเป็นสตางค์ก่อน
- **`ImportDialog`** — นำเข้าไฟล์ 3 ขั้น: เลือกไฟล์ (Dropzone ไฟล์เดียว, `accept`, `maxBytes`, `hint`, `template` ลิงก์แม่แบบ) → ตรวจทาน (นับถูก/ผิด, ตารางแถวที่ผิดพร้อมเหตุผลและเลขแถว Excel `rowNumber`, ไม่มีแถวผิด = ตัวอย่าง `previewLimit` แถว, "ข้ามแถวที่ผิด" เมื่อ `allowPartial`) → ผลลัพธ์ (เพิ่มใหม่/อัปเดต/ข้าม + `message`) · แอปส่ง `parse(file)` (exceljs/papaparse) + `validate(row)` + `commit(rows)` — throw หรือคืน `{ error }` = อยู่หน้าตรวจทานพร้อมข้อความ · `onDone`, `sheetOnMobile` (แผ่นล่าง: แถวผิดเป็นการ์ด, ปุ่มหลักอยู่บน) · ปิดกล่อง = เริ่มใหม่
- `UiText`: `approval`, `documentFlow`, `recordSection`, `comparison`, `importDialog` (ไทย + อังกฤษ)
- showcase: หน้าใหม่ approval-timeline, record-section, comparison-matrix, amount-summary, import-dialog

## [0.71.0] — 2026-10-25

ชุด 6 ข้อตาม mockup — ของใหม่ทั้งหมด ยกเว้น **`DateRangePicker` มีช่วงด่วนเป็นค่าเริ่มต้น** (หน้าตาของแอปเดิมเปลี่ยน: ปิดด้วย `presets={false}`)

### Added
- **`ThaiIdInput`** / **`PhoneInput`** (barrel) + `lib/thai` (`isValidThaiId`, `formatThaiId`, `isValidThaiPhone`, `formatThaiPhone`, `normalizeThaiPhone`, `thaiPhoneKind`, `digitsOnly` — ไม่พึ่ง React ใช้ตรวจซ้ำบน server ได้): ใส่ขีดระหว่างพิมพ์ (X-XXXX-XXXXX-XX-X · มือถือ 081-234-5678 · กทม. 02-123-4567 · ต่างจังหวัด 053-123-456), วาง `+66…` แปลงเป็น 0, `inputMode="tel"`, ตรวจหลักสุดท้ายของเลขบัตรเมื่อครบ 13 หลัก (ไม่ฟ้องระหว่างพิมพ์), ✓ เมื่อถูกต้อง, `name` = input ซ่อนเป็นตัวเลขล้วน, `onValueChange(digits, valid)`, `error`, `hideValidation`
- **`ChangeDiff`** (barrel) — "ก่อน → หลัง" รายฟิลด์ (`<del>` แดง / `<ins>` เขียว ไม่พึ่งสีอย่างเดียว), `fields` (label + `format`), ฟิลด์ที่ไม่เปลี่ยนซ่อน (`showUnchanged`), ค่าลับ (`secretKeys` ค่าเริ่มต้น SECRET/TOKEN/PASSWORD/KEY/HASH) แสดง "•••• → •••• (เปลี่ยน)", เกิน `maxItems` (6) พับพร้อมปุ่ม "แสดงทั้งหมด (N)" · ใส่ใน `details` ของ `ActivityFeed` ได้
- **`DateRangePicker presets`** — ชิปช่วงด่วนเหนือปฏิทิน (วันนี้, 7 วันล่าสุด, 30 วันล่าสุด, เดือนนี้, เดือนก่อน, ไตรมาสนี้, ปีนี้ — `defaultRangePresets(text)`), กดแล้วเลือกและปิดทันที, ชิปที่ตรงกับช่วงปัจจุบัน `aria-pressed`, บรรทัดสรุป "1 ต.ค. – 25 ต.ค. 2026 · 25 วัน" · `presets={false}` ปิด หรือส่งรายการ `DateRangePreset[]` เอง · type `DateRangePreset`
- **`useUndoableAction`** (`@suphark/ui/hooks/use-undoable-action` + barrel) — "เลิกทำ" แทน "แน่ใจไหม?" สำหรับของที่ย้อนได้: `run(id)` ซ่อนทันที (กรองด้วย `isPending`), toast เดียวรวมหลายรายการ ("ลบ 2 รายการแล้ว") พร้อมปุ่ม "เลิกทำ" (`timeout` ค่าเริ่มต้น 6 วินาที), หมดเวลา/ปิด toast = `commit(ids)` ครั้งเดียว, ล้มเหลว (throw หรือคืน `{ ok: false, error }`) = คืนรายการ + toast ผิดพลาด, ออกจากหน้า/unmount = commit ที่ค้าง · ใช้ใน `onClick` ของ `ActionMenu`/`RowActions`/`SwipeableRow` (ยังไม่มี prop `undoable` ในตัว) · ต้องมี `Toaster`/`AppToaster`
- **`useHotkeys`** + **`ShortcutsDialog`** (barrel; hook ที่ `@suphark/ui/hooks/use-hotkeys`) — คีย์เดี่ยว (`"n"`), คอร์ด (`"mod+k"` = ⌘ บน Mac / Ctrl ที่อื่น), ลำดับ (`"g i"` ภายใน 1 วินาที), ไม่ทำงานขณะพิมพ์ในช่อง (ยกเว้น `allowInInput`), `label`/`group` ลงทะเบียนให้ `ShortcutsDialog` (เปิดด้วย `?`) แสดงตามกลุ่มด้วย `Kbd`, สวิตช์ปิดคีย์ตัวอักษรเดี่ยว (WCAG 2.1.4 — จำใน localStorage `ui:hotkeys:single-key`) · `useRegisteredHotkeys`, `setSingleKeyHotkeys`, `formatHotkey`
- **`CalendarMonthGrid onMonthChange`** — โหมดสัปดาห์เลื่อนข้ามเดือนได้ (ถึงขอบเดือนแล้วกดต่อ = เรียกพร้อม `"YYYY-MM"` แอปเปลี่ยน `month`), วันของเดือนข้างเคียงในแถบแสดงจาง ๆ · ไม่ส่ง = เลื่อนในเดือนเหมือนเดิม
- **DataTable `meta.editable` ในรายการมือถือของ quiet** — เซลล์ที่แก้ได้ในการ์ดมือถือเปิดแผ่นล่างแก้ค่าเหมือนตาราง (0.70.0 ยังไม่รองรับ)
- **`MobileTabBar` item `badgeTone`** (`"destructive"` ค่าเริ่มต้น / `"primary"` / `"muted"`) — เลือกสี badge รายแท็บ (เช่นจำนวนที่ไม่เร่งด่วนเป็นเทา) · badge มีขอบสีพื้นหลังคั่นจากไอคอน
- `UiText`: `thaiInput`, `changeDiff`, `rangePresets`, `undo`, `hotkeys` (ไทย + อังกฤษ)
- showcase: หน้าใหม่ thai-inputs, change-diff, undoable-action, shortcuts-dialog · อัปเดต date-range-picker (ช่วงด่วน), calendar-month-grid (เลื่อนข้ามเดือน), mobile-tab-bar (`badgeTone`)

## [0.70.0] — 2026-10-25

ชุดใหญ่ 12 ข้อตาม mockup (ทุกข้อเป็นของใหม่หรือ prop ใหม่แบบ opt-in — แอปเดิมไม่เปลี่ยน)

### Added
- **`SwipeableRow`** — ปัดแถวเพื่อสั่งงานบนจอสัมผัส (`pointer: coarse` เท่านั้น จอเมาส์ไม่มีการปัด): ปัดซ้าย = `endActions`, ปัดขวา = `startActions` (ปุ่มละ 72px), ปัดเกิน 40% = ทำคำสั่งแรกของฝั่งนั้น (สั่นเบา ๆ), `confirm` = แผ่นยืนยันของ ConfirmDialog · แนวนอนต้องเด่นกว่าแนวตั้ง 1.5 เท่าถึงนับเป็นการปัด (`touch-action: pan-y` เลื่อนหน้ายังเป็นของเบราว์เซอร์) · แตะนอกแถวแล้วเด้งกลับ · คำสั่งที่ซ่อนอยู่เป็น `inert`/`aria-hidden` ตอนปิด — **แถวต้องมีทางสั่งงานเดียวกันที่ไม่ใช้การปัด** (เช่น ActionMenu)
- **`ActivityFeed` ส่วนเสริม** (แทนการสร้าง Timeline ใหม่ — ActivityFeed เป็นเส้นเวลาอยู่แล้ว): `groupByDate` (หัว "วันนี้"/"เมื่อวาน"/วันที่ คำนวณหลัง mount), `details` ต่อรายการ (ขยาย/ย่อด้วยปุ่ม `aria-expanded`), `density="compact"` (จุดสีแทน avatar ระยะชิด), `isLoading` (โครงร่าง), `error` + `onRetry`
- **`KeyValueEditor`** + `parseKeyValueText` — แก้คู่ชื่อ/ค่าหลายแถว: ตรวจชื่อซ้ำ/ชื่อว่าง/`validateKey`, ค่าลับ (ชื่อมี KEY/SECRET/TOKEN/PASSWORD — ปรับด้วย `secretKeys`) เป็นช่องรหัสพร้อมปุ่มตา, `reorderable` (ปุ่มขึ้น/ลง), วางข้อความแบบ .env หลายบรรทัดลงช่องชื่อแล้วแตกเป็นแถว (ชื่อซ้ำถาม "ทับค่าเดิม/ข้ามรายการซ้ำ"), `name` = input ซ่อน JSON `{ key: value }` · จอแคบแต่ละแถวเป็นการ์ด
- **`Lightbox`** + `useLightbox` — ดูรูป/ไฟล์เต็มจอ: ลูกศร/ปัดซ้ายขวาเปลี่ยนรายการ, แตะสองครั้ง (ดับเบิลคลิก, Ctrl+ล้อ) ซูม 2.5×, บีบนิ้วซูม 1–4×, ลากเมื่อซูม, ปัดลงปิด, Esc ปิด, ปุ่มดาวน์โหลด, แถบรูปย่อบนจอกว้าง, โหลดรูปข้างเคียงล่วงหน้า · ไฟล์ที่ไม่ใช่รูปแสดงไอคอนชนิดไฟล์ + ขนาด + ดาวน์โหลด (ไม่ฝังพรีวิว PDF)
- **`LoadMore`** (ปุ่มรู้สถานะ: พร้อม/กำลังโหลด/ผิดพลาด + ลองใหม่/ครบแล้ว, "แสดง N จาก M") และ **`InfiniteList`** (โหลดต่อเองเมื่อเลื่อนถึงท้ายด้วย IntersectionObserver ได้ `autoLoad` ครั้ง ค่าเริ่มต้น 3 แล้วเหลือปุ่ม, กดเองแล้วนับใหม่; รายการที่โหลดแล้วไม่ถูกล้างเมื่อรอบถัดไปล้มเหลว)
- **DataTable มุมมองที่บันทึก** — `savedViews` + `onSavedViewsChange` (แอปเก็บเอง) หรือ `savedViewsStorageKey` (localStorage), `activeViewId`/`onActiveViewChange`: ตัวเลือก "มุมมอง: …" ต้นแถบเครื่องมือ (ทั้ง default และ quiet; มือถือเป็นแผ่นล่าง), จำตัวกรอง/คำค้น/การเรียง/คอลัมน์ที่ซ่อน/ความหนาแน่น (ไม่จำเลขหน้า), บันทึกใหม่ (ชื่อซ้ำไม่ให้บันทึก), ลบมุมมอง, แก้จากมุมมองที่เลือก = "แก้ไขแล้ว" + บันทึกทับ/คืนค่า · export `DataTableSavedView`, `DataTableViewState`, `currentViewState`, `isSameViewState` จาก `@suphark/ui/data-table`
- **DataTable ตารางเสมือน** — `virtualized` + `rowHeight` (ค่าเริ่มต้น 44 / quiet compact 36): แสดงทุกแถวที่ผ่านตัวกรอง (ซ่อนเลขหน้า) แต่สร้าง DOM เฉพาะแถวที่เห็น + กันชน 8 แถว, กล่องเลื่อนของตัวเอง (`tableContainerClassName` ค่าเริ่มต้น `max-h-[70vh]`), หัวตารางติดบน · รายการมือถือของ quiet เป็นเสมือนแบบเลื่อนทั้งหน้า (วัดความสูงแถวจริง) · ข้อจำกัด: Ctrl+F เจอเฉพาะแถวที่สร้าง, ไม่ใช้ร่วมกับ `onReorder` · dependency ใหม่ `@tanstack/react-virtual` (โหลดแยก chunk เฉพาะตารางที่เปิด)
- **DataTable แก้ค่าในเซลล์** — `columnDef.meta.editable = { type: "text" | "number" | "date" | "select", options, validate, onCommit, label }` (type `DataTableEditable`): จอกว้างคลิก/Enter แก้ในที่ (Enter/ออกจากช่อง = บันทึก, Esc = ยกเลิก), จอ < 768px เปิดแผ่นล่างที่มีช่อง 44px, ระหว่างบันทึกหมุน, สำเร็จแสดงค่าใหม่ทันทีจนข้อมูลของแอปตามทัน, ล้มเหลว (throw หรือคืน `{ error }`) = คืนค่าเดิม + ข้อความในเซลล์ + ลองใหม่ · ยังไม่รองรับในรายการมือถือของ quiet และแถวลากเรียง
- **`Banner`** + ช่อง `banner` ใน `AppShell` (ใต้ header ทั้งสอง layout) — แถบประกาศเต็มความกว้าง tone info/success/warning/danger/neutral, `title`, `action` (ลิงก์/ปุ่มท้ายข้อความ), `dismissKey` + `dismissFor` ("7d"/"12h"/"30m"/ms) จำการปิดใน localStorage (ไม่แสดงก่อนอ่านค่า กันกระพริบ), danger ปิดไม่ได้ (ค่าเริ่มต้น) และเป็น `role="alert"` · ปุ่มปิด 44px บนจอสัมผัส
- **`CalendarMonthGrid view`** — `"month"` (เดิม) / `"week"` / `"auto"` (สัปดาห์บนจอ < 768px): แถบ 7 วันสูง 44px เลื่อนสัปดาห์ภายในเดือน, `renderDayItems` = รายการของวันที่เลือกใต้แถบ, `viewToggle` ปุ่มสลับเดือน/สัปดาห์, `onViewChange`
- **`Tour`** + `useTour` + `hasSeenTour` — แนะนำทีละจุด: ช่องสว่างรอบเป้าหมาย (selector/ref/ฟังก์ชัน) บนพื้นมืด, การ์ด dialog (โฟกัสวนในการ์ด, Esc/ข้าม ปิด, ตัวนับขั้น `aria-live`) ลอยใต้/เหนือเป้าหมายบนจอกว้าง เป็นแผ่นล่างบนจอแคบ, `storageKey` จำว่าดูแล้ว, `interactive` ให้กดเป้าหมายได้, เป้าหมายหาไม่เจอ = ข้ามขั้น, กดพื้นมืดไม่ปิด
- **`Rating`** + `RatingDisplay` — radiogroup (ลูกศร/Home/End, คลิกดาวที่เลือกซ้ำ = ล้าง), `allowHalf`, `size`, `readOnly`, `name` (input ซ่อน), ดาว 44px บนจอสัมผัส, ดาวว่างเป็นเส้นขอบ (ไม่พึ่งสีอย่างเดียว), สีจาก `--rating` (ค่าเริ่มต้น `--warning`) · `RatingDisplay` อ่านออกเสียง "4.5 จาก 5 ดาว" + จำนวนรีวิว
- `UiText`: `loadMore`, `activityExtra`, `rating`, `banner`, `keyValue`, `swipe`, `lightbox`, `savedViews`, `cellEdit`, `calendarView`, `tour` (ไทย + อังกฤษ)
- showcase: หน้าใหม่ load-more, swipeable-row, lightbox, rating, key-value-editor, banner, tour · อัปเดต activity-feed, calendar-month-grid, data-table (มุมมองที่บันทึก, แก้กำหนดส่งในเซลล์, ตารางเสมือน 2,000 แถว)

## [0.69.0] — 2026-10-25

### Added
- **แท็บที่เลื่อนได้บนมือถือ**: `useScrollFade` / `ScrollFades` / `ScrollableTabsList` (barrel) — แถบที่เกินความกว้างมีเงาจาง + ลูกศรที่ขอบซึ่งยังมีเนื้อหา และ **เลื่อนแท็บที่เลือกเข้ากลางแถวเอง** (ตอน mount ทันที, ตอนเปลี่ยนแบบนุ่มนวล, เคารพ `prefers-reduced-motion`) · `ScrollableTabsList` ใช้แทน `TabsList` ใน `Tabs` ดิบ (ไฟล์ shadcn แก้ไม่ได้) · `SimpleTabs` (มีเงาอยู่แล้ว) เพิ่มลูกศร + เลื่อนเข้ากลาง, `TopTabs` เพิ่มเงา/ลูกศร/เลื่อนเข้ากลาง, `SectionNav`: จอ < sm เปลี่ยนจากตัดบรรทัด (wrap) เป็นแถวเดียวเลื่อนแนวนอน + เงา/เลื่อนเข้ากลาง (จอกว้างยังตัดบรรทัดเหมือนเดิม) — แท็บที่พอดีความกว้างไม่เปลี่ยน
- **`AppToaster`** (barrel): `Toaster` ที่ยก toast บนจอแคบพ้น `MobileTabBar` + safe-area ล่าง (`mobileOffset` จากตัวแปร `--tab-bar-height` ที่ `styles.css` ตั้ง 4rem ให้เองเมื่อหน้ามี `[data-slot="mobile-tab-bar"]` ที่จอ < md ด้วย `:has`) — ไม่มีแถบแท็บ = เหนือขอบล่างเหมือนเดิม · จอกว้างไม่เปลี่ยน · แอปสลับ `<Toaster />` เป็น `<AppToaster />` ที่ root layout (props เดียวกัน)
- **`DialogsProvider sheetOnMobile`** (opt-in, ค่าเริ่มต้น false): จอ < 768px แสดงทุกโหมด (`alert`/`confirm`/`prompt`/`choose`/`checklist`) เป็นแผ่นล่าง — ปุ่มหลักเต็มความกว้าง 48px อยู่บน ปุ่มยกเลิกล่างสุด, ตัวเลือก `choose` เป็นปุ่มเต็มกว้าง, ช่องพิมพ์ 44px, รายการ `checklist` แถว ≥ 48px, ปัดลงเพื่อยกเลิก (resolve ค่ายกเลิกเหมือนเดิม) · จอกว้างเป็นกล่องกลางจอเหมือนเดิม

## [0.68.0] — 2026-10-25

### Changed
- **พื้นที่แตะ 44px บนจอสัมผัสทั้งชุด** (`@media (pointer: coarse)` ใน `styles.css`; เมาส์/ปากกาไม่เปลี่ยนเลย): สแกนทุกหน้าเดโม (140 หน้า) บนจอ 375px แบบสัมผัสเจอ ~480 จุดที่ต่ำกว่า 44px (ปุ่ม 24–32px, ช่องกรอก 32px, ช่องติ๊ก/วิทยุ/สวิตช์ 40×32, ช่องวันในปฏิทิน 28px …) จึงยกพื้นให้ `Button` (รวมตัวเปิดที่ใช้คลาส Button เช่น combobox/popover trigger), `Input`, `SelectTrigger`, `NativeSelect`, `Toggle`/`ToggleGroupItem` (SegmentedControl), `TabsTrigger`/`TabsList`, `MenubarTrigger`, `SidebarMenuButton`, `NumberInput`, `InputGroup` (SearchInput/TimePicker/DatePicker ฯลฯ) เป็นสูง ≥ 44px · ปุ่มไอคอนล้วนกว้าง 44px ด้วย · ปุ่มลด/เพิ่มของ NumberInput และ Carousel กว้าง 44px · ช่องติ๊ก/วิทยุ/สวิตช์ขยายเฉพาะพื้นที่แตะ (ภาพเท่าเดิม) · `Calendar` ช่องวัน 44px · ปุ่มและช่องพิมพ์ใน `InputGroup` เต็มความสูงกลุ่ม (42px) · `StepForm` ขั้นตอน, `TagsInput` (กล่อง/ช่องพิมพ์/ปุ่มลบป้าย), `ColorPicker` เม็ดสี, `InfoHint` ขยายพื้นที่แตะเอง · **ปิดเป็นรายตัวด้วย `data-touch="compact"`** หรือทับด้วย `min-h-0` · แถบเครื่องมือหนาแน่นในแอปที่เขียนพื้นที่แตะเองแล้วไม่ต้องแก้ แต่ถ้าสูงน้อยกว่า 44px จะถูกดันให้สูงขึ้นบนจอสัมผัส (เจตนา) · ข้อยกเว้นที่ยอมรับ: ช่องวันของ `CalendarMonthGrid`/`MonthStepper` (7 คอลัมน์ กว้าง ~33px สูง ≥ 38px)
- `DateRangePicker` และ `DateTimePicker` ใช้ `ResponsivePopover`: จอ < 768px เป็นแผ่นล่าง (DateRangePicker แสดงเดือนเดียว — เดิมสองเดือนซ้อนกันสูงเกินจอและลอยพ้นขอบบน) · จอกว้างเหมือนเดิม (popover, 2 เดือน)
- `DatePicker` (ช่องพิมพ์ + ปฏิทิน): บนจอสัมผัสป๊อปอัปกว้างขึ้นเป็น `min(340px, 100vw-1rem)` ให้พอดีช่องวัน 44px

### Added
- `DataTableRowActions sheetOnMobile` — กล่องยืนยันการลบเป็นแผ่นล่างบนมือถือ (ผ่าน `ConfirmDialog`) · `ConfirmActionButton sheetOnMobile` · `useConfirm({ sheetOnMobile })`
- กฎกันถอย: `touch-targets-css.test.ts` ตรวจว่ากฎ 44px ยังอยู่ใน `styles.css`

## [0.67.0] — 2026-10-25

### Added
- `ConfirmDialog sheetOnMobile` (opt-in, ค่าเริ่มต้น false เหมือนเดิม — ตาม mockup): จอ < 768px แสดงเป็นแผ่นล่าง (Drawer) — ปุ่มยืนยันบน/ยกเลิกล่าง เต็มความกว้างสูง 48px (เว้นช่อง safe-area), ช่องพิมพ์ยืนยัน (`requireText`) 44px และปุ่มยืนยันกดไม่ได้จนพิมพ์ตรง, `pending` = ปุ่มหมุน (`aria-busy`) ยกเลิก/ปัดปิดไม่ได้ระหว่างรอ · จอกว้างยังเป็นกล่องกลางจอ · `ActionMenu sheetOnMobile` และ `RowActions sheetOnMobile` ส่งต่อให้ ConfirmDialog ของตัวเองเป็นแผ่นด้วย (แผ่นคำสั่งปิดก่อนแล้วแผ่นยืนยันขึ้น)
- `DataTable variant="quiet"` บนมือถือ: **ลากเลือกต่อเนื่อง** — กดค้างแถวแรก (ยังไม่ปล่อยนิ้ว) แล้วลากลง/ขึ้น เลือกทั้งช่วงจากแถวที่กดค้างถึงแถวใต้นิ้ว · ลากกลับ = แถวที่เลยมาคืนเป็นสถานะก่อนลาก (แถวที่เลือกไว้ก่อนไม่ถูกยกเลิก) · นิ้วเข้าใกล้ขอบบน/ล่างของจอ (56px) เลื่อนหน้าเอง · กันลากกลายเป็นเลื่อนหน้าด้วย `touchmove` แบบ non-passive ที่ลงทะเบียนตอนกดค้างสำเร็จ · ไม่มี prop ใหม่ (ต่อจากการกดค้างที่มี) · ทดสอบด้วย PointerEvent จำลอง ควรลองบนมือถือจริง

## [0.66.0] — 2026-10-25

### Added
- `RowActions sheetOnMobile` / `sheetTitle` (`@suphark/ui/next`, opt-in, ค่าเริ่มต้น false): แผ่นคำสั่งล่างบนมือถือเหมือน `ActionMenu` — แถว 48px, ลิงก์เป็น `<Link>` จริง, `confirm`/`action`/`onSelect` ทำงานเหมือนเดิม (แผ่นปิดก่อนแล้วจึงถามยืนยัน), ปุ่ม "…" 44px บนจอสัมผัสเมื่อเปิดโหมดนี้
- ภายใน: `shared/action-sheet.tsx` (`ActionSheet`, `ActionSheetSeparator`, `ActionSheetLabel`, `actionSheetRowClass`) ที่ `ActionMenu` และ `RowActions` ใช้ร่วมกัน — ไม่เปลี่ยนพฤติกรรมของ `ActionMenu sheetOnMobile` (0.65.0)

### Fixed
- `NotificationCenter` (ทั้ง `card` และ `quiet`) พื้นที่แตะบนจอสัมผัส (`pointer-coarse`) ต่ำกว่า 44px: ปุ่ม "ดูทั้งหมด", ปุ่มคำสั่งในแถว, ปุ่ม "…" ของเมนูแถว สูง 44px · ชิปนับที่กดได้และแท็บนับของ `quiet` มีพื้นที่แตะ ≥ 44px โดยหน้าตาไม่เปลี่ยน (วัดแล้วทั้งหมด ≥ 44px) · `RecordCard` ไม่มีปุ่มของตัวเอง ปุ่มคำสั่งที่แอปส่งเข้า `actions` เป็นหน้าที่ของแอป (ใช้ `pointer-coarse:h-11`)

## [0.65.0] — 2026-10-25

### Added
- `ActionMenu sheetOnMobile` (opt-in, ค่าเริ่มต้น false เหมือนเดิม — ตาม mockup): จอ < 768px แสดงเป็นแผ่นคำสั่งล่าง (Drawer เดียวกับ `ResponsivePopover`) — แถวสูง 48px ไอคอนชิดซ้าย, `destructive` สีแดง, ตัวคั่น/หัวกลุ่มเหมือนเดิม, `disabled` จาง, `href` เป็นลิงก์จริง, ปุ่ม "ยกเลิก" ล่างสุด (เว้นช่อง safe-area), ปัดลงเพื่อปิด · คำสั่งที่มี `confirm` ปิดแผ่นก่อนแล้วขึ้นกล่องยืนยันเดิม (ไม่ซ้อนสองชั้น) · จอกว้างยังเป็น dropdown เดิม · ปุ่ม "…" ค่าเริ่มต้นได้พื้นที่แตะ 44px บนจอสัมผัสเมื่อเปิดโหมดนี้
- `ActionMenu sheetTitle`: หัวแผ่น (เช่นชื่อแถว) — ไม่ส่ง = ไม่แสดงหัว แต่โปรแกรมอ่านจอยังได้ชื่อจาก `label`

## [0.64.0] — 2026-10-25

### Added
- `FormDialog sheetOnMobile` (opt-in, ค่าเริ่มต้น false เหมือนเดิม — ตาม mockup): จอ < 768px แสดงเป็นแผ่นล่าง (Drawer เดียวกับ `ResponsivePopover`) — ปัดลงเพื่อปิด, หัวชิดซ้าย + ปุ่ม ✕ 44px, เนื้อฟอร์มเลื่อนเอง, ปุ่ม "ยกเลิก/บันทึก" เต็มความกว้างสูง 44px ตรึงท้ายแผ่น (เว้นช่อง safe-area), หน้าจอสำเร็จ (`renderSuccess`/`revealSuccess`) ใช้ปุ่ม "เสร็จแล้ว" เต็มความกว้างเช่นกัน · จอกว้างเป็นกล่องกลางจอเหมือนเดิม · `contentClassName` ใช้กับกล่องกลางจอเท่านั้น
- `FormDialog confirmDiscard` (opt-in, ค่าเริ่มต้น false): ถาม "ทิ้งการแก้ไขที่ยังไม่บันทึก?" ก่อนปิดเมื่อค่าช่องที่มี `name` ต่างจากตอนเปิด ไม่ว่าจะปิดด้วย ยกเลิก/✕/Esc/คลิกนอกกล่อง/ปัดลง — ฟอร์มที่ยังไม่แตะปิดได้ทันที, ระหว่างกำลังส่งและหลังสำเร็จไม่ถาม · เทียบด้วยค่า FormData จึงครอบคลุม control ที่เขียน input ซ่อนตามชื่อ (Select/Checkbox/DatePicker ของแพ็กเกจ) · `UiText.formDialog.discardTitle` / `discardHint` / `keepEditing` / `discard`

## [0.63.0] — 2026-10-25

### Added
- `CommandPalette highlightMatches` (opt-in, ค่าเริ่มต้น false เหมือนเดิม — ขอโดย pi-done): เน้นคำที่พิมพ์ในชื่อรายการทั้งหน้าและ section เป็น `<mark>` ตัวหนาสีเข้มไม่มีพื้น
- `MatchText` (`@suphark/ui/next`): ตัวเน้นคำที่ตรงกับ query แบบไม่สนตัวพิมพ์ ใช้นอก palette ได้

## [0.62.0] — 2026-10-24

### Added
- `SimpleTable variant="quiet"` (opt-in, ค่าเริ่มต้น `default` เหมือนเดิม — เข้าชุดกับ `DataTable variant="quiet"`): หัวตารางเรียบ · แถวพื้นตอนชี้ · แถวที่เลือกมีแถบสีซ้าย · `StatusBadge` เป็นจุดสี · ช่องติ๊กและปุ่มท้ายแถว (คอลัมน์ที่ `key: "actions"`) โผล่เมื่อชี้/โฟกัส (จอสัมผัสเห็นตลอด)
- `SimpleTableColumn.mobile` (`QuietMobileSlot` = `title | end | sub | status | meta | hidden`): บนจอ < sm ของ `quiet` แสดงเป็นรายการแถวละ 3 บรรทัดแทนตารางเลื่อนแนวนอน (ช่องติ๊กอยู่ซ้ายรายการ พื้นที่แตะ 44px) · ไม่ใส่ slot ใดเลย = ตารางเหมือนเดิม
- `SimpleTable isLoading` (skeleton), `error` + `onRetry` (กล่องผิดพลาดแบบเดียวกับ DataTable) — ใช้ได้ทั้งสอง variant · `empty` เดิมของแอปยังใช้เหมือนเดิม
- `QuietMobileSlot` (type), ภายใน: `shared/table-states.tsx` (กล่องสถานะ/skeleton ที่ DataTable ใช้ร่วมกัน ไม่พึ่ง tanstack)

## [0.61.0] — 2026-10-24

### Added
- `DataTable` สถานะตาราง (ตาม mockup): **ผิดพลาด** — prop `error` แสดงกล่อง "โหลดรายการไม่สำเร็จ" แทนตาราง (ข้อความกลาง ไม่แสดง error ดิบ, ซ่อนเลขหน้า) + `onRetry` = ปุ่ม "ลองใหม่" (ทั้งสอง variant) · `variant="quiet"`: **ไม่พบ** — บอกคำค้น "ไม่พบรายการที่ตรงกับ …" + ปุ่ม "ล้างตัวกรองทั้งหมด"/"ล้างคำค้น" (เคารพ `preservedFilterIds`), **ว่างจริง** — `resourceName` ("ยังไม่มีใบสั่งซื้อ") + `emptyAction` (ปุ่มสร้าง; ไม่ส่ง = ไม่มีปุ่ม), **โหลด** — ตัวนับ "กำลังโหลด…" และ skeleton รายการ 3 บรรทัดบนมือถือ · กล่องสถานะกว้างไม่เกินจอบนมือถือ ปุ่มสูง 44px บนจอสัมผัส · `emptyStateComponent` ของแอปยังทับได้ทั้งหมด
- `DataTableEmptyState`, `DataTableErrorState` (ภายใน `data-table-states.tsx`), `UiText.table.loading` / `emptyTitle` / `emptyTitleOf` / `emptyHint` / `noMatch` / `noMatchQuery` / `noMatchHint` / `clearAllFilters` / `clearQuery` / `errorTitle` / `errorHint` / `retry`
- showcase: เดโม DataTable สลับสถานะ ปกติ/กำลังโหลด/ว่างจริง/ผิดพลาดได้

## [0.60.0] — 2026-10-24

### Added
- `DataTable variant="quiet"` บนมือถือ (ตาม mockup รอบ 2): **กดค้างที่แถว (500 ms) เข้าโหมดเลือกหมู่** — ช่องเลือก (คอลัมน์ `select`) ซ่อนจากสายตาจนกว่าจะเลือก (คีย์บอร์ด/โปรแกรมอ่านจอยังโฟกัสได้ตลอด), หัว "เลือก N รายการ · เลือกทั้งหมด" (`role="status"`), แตะแถวสลับการเลือก, เอาออกหมด = ออกจากโหมด, สั่นเบา ๆ ถ้าอุปกรณ์รองรับ · บรรทัดบอกใบ้ "กดค้างที่แถวเพื่อเลือกหมู่" แสดงครั้งแรกครั้งเดียว (หายเองใน 6 วินาที จำใน localStorage)
- `DataTable variant="quiet"` แผ่นตัวกรอง: ตัวกรองแบบรายการติ๊ก (`DataTableFilterSections`) หัวข้อเปิดไว้ แถวสูง 44px มีจำนวนต่อค่า (ใช้ `getFacetedUniqueValues` ของแอปถ้าส่งมา ไม่งั้นนับจากแถวที่ผ่านตัวกรองคอลัมน์อื่น) + ปุ่มล่าง "ล้าง / ดู N รายการ" แทนปุ่ม popover ต่อคอลัมน์
- `DataTable densityStorageKey` (`quiet`): จำความหนาแน่นที่ผู้ใช้เลือกใน localStorage — ไม่ส่ง = ไม่จำ; localStorage ใช้ไม่ได้ก็ทำงานต่อ
- `UiText.table.selectedCount` / `selectedPill` / `selectAll` / `longPressHint` / `clearFilters` / `showResults`

### Changed
- แคปซูลเลือกหมู่ของ `quiet` แสดง "N รายการ" (สั้นลง เพราะหัวรายการมือถือบอก "เลือก N รายการ" แล้ว)

### Fixed
- `SelectionBar` แบบลอย (`floating`/`pill`): กว้างตามเนื้อหา (`w-max`) — เดิมถูกบีบเหลือครึ่งจอจากการยึด `left-1/2` ทำให้ปุ่มตัดคำและทับกันบนมือถือ · `pill` เป็นบรรทัดเดียวเสมอ ปุ่มที่แอปส่งมาใช้สีตัวอักษรบนพื้นสีหลัก และสูง 44px บนจอสัมผัส · ปุ่มปิดแผ่นตัวกรองสูง 44px บนจอสัมผัส

## [0.59.1] — 2026-10-24

### Fixed
- `DataTable variant="quiet"` บนจอสัมผัส (`pointer-coarse`): ปุ่ม "ตัวกรอง", ช่องค้นหา, ปุ่มก่อนหน้า/ถัดไป สูง 44px · พื้นที่แตะช่องเลือกของรายการมือถือขยายเป็น 44px (แตะส่วนที่เกินช่องก็สลับการเลือก) · ปุ่มลบชิปตัวกรองมีพื้นที่แตะกว้างขึ้น · วัด contrast ข้อความรอง/สถานะแล้ว ≥ 4.5:1 ทั้งโหมดสว่างและมืด (ไม่ต้องแก้)

## [0.59.0] — 2026-10-24

### Added
- `DataTable variant="quiet"` (opt-in, ค่าเริ่มต้น `default` เหมือนเดิม — ตาม mockup "Calm toolbar, dense rows"): แถบเครื่องมือบรรทัดเดียว — ช่องค้นหา + ชิปตัวกรองที่ลบได้ + ปุ่ม "ตัวกรอง" ปุ่มเดียว (เปิดแผ่นตัวกรอง: ขวาบนเดสก์ท็อป · ล่างบนมือถือ) + ตัวนับ "N จาก M รายการ" + สลับความหนาแน่น (`defaultDensity`) + ไอคอนคอลัมน์ · หัวตารางเรียบ (ลูกศรเรียงของคอลัมน์ที่ไม่ได้เรียงโผล่เมื่อชี้) · ช่องเลือก (`[role=checkbox]`) และปุ่มท้ายแถว (`DataTableRowActions`) โผล่เมื่อชี้/โฟกัส/เลือก (จอสัมผัสเห็นตลอด) · `StatusBadge` ในตารางเป็นจุดสี · แถวที่เลือกมีแถบสีซ้าย · เลือกแล้วขึ้นแคปซูล `SelectionBar variant="pill"` (`selectionActions` ใส่ปุ่มคำสั่ง) แทนข้อความ "เลือก N จาก M แถว" · เลขหน้าย่อ "1–10 จาก 128 · ‹ 1 / 13 ›"
- มือถือ (< sm) ของ `variant="quiet"`: คอลัมน์ที่ใส่ `columnDef.meta = { mobile: "title" | "end" | "sub" | "status" | "meta" | "hidden" }` (type `DataTableMobileSlot`) แสดงเป็นรายการแถวละ 3 บรรทัด (ชื่อ + ยอด / รอง / สถานะ · meta) แทนตารางเลื่อนแนวนอน · ไม่ใส่ slot ใดเลย = ตารางเหมือนเดิม · คอลัมน์ `select` แสดงที่ซ้ายของรายการ
- `DataTablePagination variant="quiet"`, `DataTableViewOptions iconOnly`, `UiText.table.rangeOf` / `shownOf` / `density`
- `NotificationCenter headerAction` (ขอโดย pi-done): ปุ่มคำสั่งของทั้งกล่อง เช่น "อ่านทั้งหมดแล้ว" ที่หัว ข้างปุ่ม "ดูทั้งหมด" — ไม่ต้องยืม `viewAll`
- `SwitchField labelClassName` (ขอโดย pi-done): ทับสไตล์ข้อความป้าย (ค่าเริ่มต้น `text-sm`)

### Fixed
- `useIsMobile` ไม่พังเมื่อไม่มี `window.matchMedia` (jsdom/เบราว์เซอร์เก่า) — ใช้ค่าตอน mount อย่างเดียว (กระทบ `DataTableToolbar` ที่เรียก hook นี้ แอปที่เทสต์ DataTable ใน jsdom ไม่ต้อง mock matchMedia)
- showcase: `/components/data-table` ตัวอย่างใหม่ (สลับ default/quiet, เลือกแถว, ใบสั่งซื้อสมมติ)

## [0.58.0] — 2026-10-24

### Added
- `PullToRefresh variant="circle"` (`@suphark/ui/pwa`, ขอโดย pi-done — เจ้าของเลือกแบบวงกลม): วงกลม 40px ไอคอนล้วน (ลูกศร → หมุนตอนรีเฟรช) กลางแนวนอน พักที่ 16px ใต้ขอบบนของ root · เริ่มทำงานที่ 64px สูงสุด 104px แรงต้าน 0.5 · `role="status"` + ข้อความ `sr-only` จาก `text` (ปกติ `PULL_TO_REFRESH_TEXT_*`) · ค่าเริ่มต้นยัง `variant="pill"` (แคปซูลมีข้อความ) เหมือนเดิม

## [0.57.0] — 2026-10-24

ยกจาก pi-done (รอบสองของคำขอย้าย component ที่แอปทำเอง)

### Added
- `RowTable` / `RowTableHeader` / `RowTableRow` / `RowTableCell` / `RowTableActions` / `RowTableGroup` — ตาราง grid ที่หัว/แถว/แถวกลุ่มใช้คอลัมน์ชุดเดียว (`columns` + `mobileColumns` เป็น `grid-template-columns` ผ่านตัวแปร CSS) หัวซ่อนบนมือถือ ช่อง `hideOnMobile` ซ่อนบนมือถือ ปุ่มท้ายแถวโผล่ตอนชี้/โฟกัส (เห็นตลอดบนจอสัมผัส) — แทนที่ pi-done เขียนซ้ำ 4 ที่
- `ListSection` / `ListSectionHeader` — กลุ่มรายการแบบไม่มีกล่อง (หัว + จำนวน + ปุ่มขวา + เส้นบาง + แถวคั่นเส้น) = `SectionPanel plain` + `TaskGroupHeader`
- `SidebarNavItem` / `SidebarCountBadge` — แถวเมนูข้างแบบเรียบ (active = `bg-primary/10 text-primary`, ตัวเลขเป็นข้อความเทา ไม่ใช่ pill, 44px บนจอสัมผัส, `draggingOver`)
- `ProgressBar tone="auto"` — เขียวเมื่อครบ (value ≥ max) นอกนั้นสีหลัก (ครอบคลุม `ProgressBar` ของ pi-done: ใช้ `<ProgressBar value={percent} tone="auto" className="w-10" />`)
- showcase: หน้า `/components/row-table`, `/components/list-section`, `/components/sidebar-nav-item`

## [0.56.0] — 2026-10-24

### Added
- `DatePicker` `minDate` / `maxDate` (`"YYYY-MM-DD"` | Date, รวมวันนั้น) ทั้งวันเดียวและ `mode="range"` (ขอโดย DueBell แทนการกันที่ `onChange`): ปฏิทินกดวันนอกช่วงไม่ได้ · เดือน/ปีเลื่อนไปนอกช่วงไม่ได้ (ลูกศรเดือน + ตารางเลือกเดือน) · ค่าที่พิมพ์แล้วอยู่นอกช่วง = ไม่ยืนยัน (Enter/Tab/ปุ่มผล) และกล่องผลแสดงเหตุผลสีแดงแทน · ค่าที่ส่งเข้ามาเองนอกช่วงไม่ถูกแก้ ช่องขึ้น `aria-invalid` · ข้อความ `UiText.datePicker.beforeMin` / `afterMax` (`{date}` ตาม `locale` ของช่อง) แอปทับได้

## [0.55.0] — 2026-10-24

ยกจาก pi-done (รอบแรกของคำขอย้าย component ที่แอปทำเอง)

### Added
- `ResponsivePopover` / `ResponsivePopoverTrigger` / `ResponsivePopoverContent` / `ResponsivePopoverItem` / `useIsResponsiveSheet()` — Popover บนจอ ≥ 768px · แผ่นล่าง (Drawer) บนมือถือ: สูงตามเนื้อหา, `footer` ค้างล่าง, ปัดลงปิด; `useIsResponsiveSheet()` ให้ picker ขยายพื้นที่แตะ (`ResponsivePopoverItem` = 44px ในแผ่น) · `sheetContentClassName` ทับสไตล์ตัวแผ่น 
- `SwitchField` — สวิตช์ + ป้ายในตัว (คลิกป้ายสลับ, `hint` ได้, ป้ายสูง 44px บนจอสัมผัส) แทน `<label><Switch/>…</label>` ที่ต้อง biome-ignore เพราะ Switch เป็น span
- `PullToRefresh` (`@suphark/ui/pwa`) prop `onRefresh` — รีเฟรชเองได้ (แอป local-first ที่ `router.refresh()` ไปไม่ถึง) · คืน promise = หมุนจนเสร็จ ขั้นต่ำ 500ms (ไม่ส่ง = `router.refresh()` แล้วหมุน 700ms เหมือนเดิม)

### Fixed
- `PullToRefresh`: วงโผล่ใต้ขอบบนของ root (เดิมติดขอบจอ จมใต้ header ที่ sticky) และ `z-50` · เริ่มดึงได้เฉพาะเมื่อแตะ "ในส่วน root" ที่เลื่อนอยู่บนสุด — sheet/dialog ที่ portal ออกไปนอก root จึงปัดลงของตัวเองได้ ไม่ถูกแย่งไปรีเฟรชหน้า (root เป็น `<html>`/`<body>` ทำงานเหมือนเดิม)
- showcase: หน้า `/components/responsive-popover` ใหม่ · labeled-field มีตัวอย่าง `SwitchField`

## [0.54.0] — 2026-10-24

### Added
- `AccessibleCalendar` — `Calendar` ที่ลูกศร/Home/End/PageUp/PageDown เลือกวันด้วยคีย์บอร์ดได้จริง (props เหมือน `Calendar` ทุกอย่าง) · ใช้แทน `Calendar` ดิบเมื่อวางปฏิทินเอง (ปุ่มวันของ shadcn ไม่ผูก `ref` ลูกศรจึงเลื่อนได้แค่สถานะภายใน) · `FocusableDayButton` ย้ายจาก `date-picker.tsx` มาอยู่ `shared/date/accessible-calendar.tsx`

### Fixed
- `DateRangePicker` (ตัวกรอง) และ `DateTimePicker`: ปฏิทินใช้ `AccessibleCalendar` — เลือกวันด้วยคีย์บอร์ดได้จริง (เดิมโฟกัสค้างที่เดิม)
- `DateRangePicker`: ข้อความ placeholder/"ล้างช่วงวันที่" มาจาก `UiText.datePicker` (`rangePlaceholder`, ใหม่ `clearRange`) — แอปที่ไม่ส่ง `placeholder` และใช้ UiText ไทยจะเห็นข้อความไทยแทนอังกฤษ; ส่ง `placeholder` เองยังชนะเสมอ
- showcase: `/components/calendar` ใช้ `AccessibleCalendar`

## [0.53.0] — 2026-10-23

### Changed
- showcase: `/components/sortable-list` ปรับให้ตรง mockup — หัวตาราง "ตัวแปรสภาพแวดล้อม · N คีย์" + ปุ่ม ? ด้านบน, ตัวเลขจำนวนคีย์ในหัวกลุ่ม, เส้นนำแนวตั้งของคีย์ในกลุ่ม, สีตอนชี้แถว, เส้นแทรกสีหลักที่แถวที่กำลังลาก, แคปซูลเลือกหมู่อยู่ใต้ตาราง
- `DatePicker` ปรับให้ตรง mockup "Type first" (0.49.0 วาดไม่ตรง): ไอคอนปฏิทินอยู่ซ้ายของช่อง · ป้าย `Enter` อยู่ในช่องขวา (เดิมอยู่ในกล่องผล) · กล่องผลที่อ่านออก (เขียว) แยกเป็นกล่องของตัวเองเหนือการ์ดปฏิทิน · หัวปฏิทินเป็นปุ่มเดียว "ตุลาคม 2569 ▾" กดแล้วเป็นตารางเลือกเดือน/ปี (แทนเมนูเดือน + เมนูปีสองอัน) · แผ่น "ทั้งหมด" มีหัว "พิมพ์ลัดทั้งหมด · กดเพื่อเติมในช่อง" · `UiText.datePicker.allShortcuts`/`tapToFill`

## [0.52.0] — 2026-10-23

### Changed
- `variant="quiet"` ของ `RecordCard`/`NotificationCenter` ปรับให้ตรงแบบ mockup จริง (0.51.0 วาดไม่ตรง): ไอคอนอยู่ในกรอบ 36px พื้น muted สีตาม accent · `StatusBadge` ที่อยู่ในแถว quiet กลายเป็น "จุดสี + ข้อความสี" ไม่มีกรอบ/พื้นอัตโนมัติ (CSS `in-data-[variant=quiet]`, นอก quiet เหมือนเดิม) · ปุ่มรองเป็น outline (เดิม ghost) ปุ่มหลักใช้แถวเดียว

### Added
- `RecordCard`/`NotificationEntry` `highlight` (quiet: พื้น accent จาง ๆ เน้นแถวที่ต้องจัดการก่อน) และ `progress` (quiet: แถบความคืบหน้า 0–100 ใต้ยอด)
- showcase: notification-center โหมด quiet ตามแบบ — ยอดไม่มีสตางค์, แถวแรกเน้น + ปุ่มหลักตัวเดียว, แถบ 35/60 รอบ, เมนู … ทุกแถว

## [0.51.0] — 2026-10-23

### Added
- `useSortableRow().toggleSelected()` — เลือก/ไม่เลือกแถวจากช่องติ๊กในแถว (ช่องติ๊กโผล่เมื่อชี้ เหมือนที่จับ)
- `SelectionBar variant="pill"` — แคปซูลสีหลักลอยกลางล่างจอ เด่นกว่า `floating` (ใช้กับแถบเลือกหมู่ของ Sortable)
- `RecordCard variant="quiet"` (opt-in, ค่าเริ่มต้น `card` เหมือนเดิม) — แถวเรียบแบบสมุดบัญชี "Quiet ledger": ไม่มีกรอบ/พื้นสี สีของ `accent` เหลือแค่ไอคอน, ชื่อ + (สถานะ · meta) ซ้าย, ยอดเงินขวา, ปุ่มท้ายแถว — เห็นได้มากกว่าเท่าตัวในที่เท่ากัน · props เดิมทั้งหมดใช้ต่อได้ ไม่ใช่ major
- `NotificationCenter variant="quiet"` + `NotificationEntry.section` — ชิปนับเป็นแท็บขีดเส้นใต้ (ตัวเลข danger เป็นสีแดง) รายการเป็นแถว quiet ในกรอบเดียว มีหัวกลุ่มคั่นตาม `section`
- showcase: sortable-list มีช่องติ๊กโผล่เมื่อชี้ + แคปซูลเลือกหมู่ + กรอบบอกตำแหน่งเดิมตอนลาก; record-card / notification-center มีตัวอย่าง quiet (notification-center สลับ card/quiet ได้)

## [0.50.0] — 2026-10-23

### Added
- `@suphark/ui/sortable`: `DragHandle reveal` (opt-in, ค่าเริ่มต้นเหมือนเดิม) — "สงบจนกว่าจะแตะ": ซ่อนที่จับ โผล่เมื่อชี้แถว / โฟกัสในแถว / แถวถูกเลือก (จอสัมผัสเห็นตลอด, Tab ถึงที่จับได้เสมอ) · แอปใส่ `group/row` ที่แถว
- showcase: `/components/sortable-list` ใช้ `reveal` และย้ายข้อความสอนยาวไว้หลังปุ่ม ? (แผ่นลัดแป้นพิมพ์)

## [0.49.0] — 2026-10-23

### Changed

- **`DatePicker` redesign "Type first"** (ทั้งวันเดียวและ `mode="range"`; API/props/ค่าที่ส่งในฟอร์ม `name`/`defaultValue`/`required` เหมือนเดิมทุกตัว — แอปที่ใช้อยู่ไม่ต้องแก้):
  - **ช่องคือ input ที่พิมพ์ได้โดยตรง** (เดิมเป็นปุ่มที่ต้องเปิดป๊อปอัปก่อนถึงมีช่องพิมพ์ซ้อนอยู่ข้างใน) — คลิกช่อง = เลือกทั้งข้อความ พิมพ์ทับได้เลย · `<label>` ที่ครอบ/ชี้ (`LabeledField`) โฟกัสที่ช่องพิมพ์โดยตรง
  - **เห็นผลที่อ่านออกใต้ช่องทันที**: "จ. 26 ต.ค. 2569 · ในอีก 3 วัน" / ช่วง "16–23 ต.ค. 2569 · 8 วัน" (กดผลนั้นหรือ Enter เพื่อยืนยัน) — แก้ปัญหา "10/02 อ่านได้สองแบบ"; อ่านไม่ออก = "อ่านไม่ออก — ลองพิมพ์ t+3" ไม่ทิ้งค่าที่พิมพ์ทิ้งเงียบ ๆ; พิมพ์วันเดียวในช่องช่วง = ช่วงหนึ่งวัน
  - ปฏิทินเลื่อนตามข้อความที่พิมพ์และไฮไลต์วันที่อ่านได้ทันที · แถวพิมพ์ลัดบรรทัดเดียวใต้ปฏิทิน (กดเติมลงช่อง) + "ทั้งหมด ›" เปิดแผ่นตัวอย่างวิธีพิมพ์ในกล่องเดียวกัน — **เลิกปุ่ม (i) / ตารางวิธีพิมพ์ที่กินที่ / ปุ่ม "ตกลง"**
  - ปุ่ม ✕ ล้างค่าและปุ่มเปิดปฏิทินเป็น `<button>` จริง (เดิม ✕ เป็น `<span role="button">`) · วันที่สัมพัทธ์ "(พรุ่งนี้)" ยังแสดงท้ายช่องตาม `showRelative`
  - **ปฏิทินใช้ภาษา/ปีเดียวกับช่อง** (เดิมไม่ส่ง `locale` แล้วขึ้น "Oct 2026" อังกฤษ ทั้งที่ช่องแสดง พ.ศ.) · หัวคอลัมน์วันไทย 2 ตัว (อา จ อ พ พฤ ศ ส) แทนตัวเดียวที่ "อ"/"พ" กำกวม
  - คลิกวันที่ที่เลือกอยู่แล้วในปฏิทิน = ยืนยันวันนั้น (เดิมล้างค่าแบบ toggle — ล้างใช้ปุ่ม ✕)
  - `showSmartInput={false}` = ช่องอ่านอย่างเดียว กดแล้วเปิดปฏิทินอย่างเดียว (แบบเดิม ไม่มีแถบพิมพ์ลัด) · `showPresets` ยัง deprecated ไม่มีผล
  - ป๊อปอัปไม่มี animation ตอนปิด (Base UI ถอดตัวดักโฟกัส `<span tabindex=0>` ที่วางต่อท้ายช่องก็ต่อเมื่อ animation จบ ระหว่างนั้น Tab ตกไปที่มัน)
- `UiText.datePicker` เพิ่ม `cannotRead` (`{example}`), `shortcutsLabel`, `showAll`, `backToCalendar`, `openCalendar`, `dayCount` (`{count}`) — ไทย/อังกฤษในตัว

### Fixed

- **คีย์บอร์ด: ลูกศรเลือกวันในปฏิทินไม่ย้ายโฟกัสจริง** — `CalendarDayButton` ใน `components/ui/calendar.tsx` (ไฟล์ shadcn) มี effect สั่ง `ref.current?.focus()` แต่ **ไม่เคยผูก `ref` กับปุ่ม** ลูกศรจึงเลื่อนแค่สถานะภายในของ react-day-picker โฟกัสจริงค้างที่เดิม (กระทบ `Calendar` ทุกที่ รวม DatePicker แบบเดิม) · `DatePicker` แก้ที่ฝั่งตัวเองด้วย `components={{ DayButton }}` ที่ผูก ref ให้ · **`Calendar` ดิบที่แอปใช้เองยังมีบั๊กนี้** (ห้ามแก้ไฟล์ shadcn — จดใน todo)
- ป๊อปอัป DatePicker สูง ~400px ไม่พอทั้งบนและล่างแล้ว Base UI ย้ายไปวางข้างช่อง (ทับเนื้อหา) → พลิกได้เฉพาะบน↔ล่าง
- Tab ออกจากช่องที่เปิดป๊อปอัปอยู่ แล้วโฟกัสหลุดไป `body` แทนที่จะไปช่องถัดไป (ตัวดักโฟกัสของ Base UI)

### Security

- อัป `next` (devDependency ของแพ็กเกจ + showcase ui.suphark.com) เป็น `^16.4.2` — ปิดช่องโหว่ใน `next >=16.0.0 <=16.4.0`: **critical** RCE ไม่ต้องล็อกอินใน Image Optimization API เมื่อใช้ไฟล์ SVG (GHSA-2464-fhr4-w9xw) · **critical** RCE ไม่ต้องล็อกอินใน `use cache` ที่คืน typed array (GHSA-673q-mjm6-r5xr) · high DoS ใน App Router ที่ใช้ Server Actions · override `source-map-js >=1.2.2` (high DoS ที่ติดมากับ postcss) · `pnpm audit --prod --audit-level=high` สะอาด · **peerDependency `next >=15` ไม่เปลี่ยน** — แอปที่ใช้ Next 16 อัปเองเป็น `^16.4.2` (แพ็กเกจส่ง source ไม่ได้บังคับเวอร์ชัน next)

### Added

- `HeaderBreadcrumbs` (และ `AppShell` `header.breadcrumbs: { upButton }`): **`upButton`** + `upLabel` — ปุ่ม X ท้าย breadcrumb ถอยขึ้นหนึ่งระดับแบบ Vercel (ไปที่ segment ก่อนหน้า หรือ `homeHref` ถ้ามี segment เดียว · ไม่แสดงหน้าแรก) · ปิดไว้เป็นค่าเริ่มต้น แอปเดิมไม่เปลี่ยน (ขอจาก Pi Config ซึ่งทำเองใน `breadcrumbs.tsx` แล้ว) · showcase `/shell` เปิดใช้

## [0.48.0] — 2026-10-10

> ประกาศพร้อม publish แล้วแต่ยังไม่ขึ้น npm — รวมอยู่ใน 0.49.0

### Added

- showcase: หน้า `/components/web-push-row` (demo WebPushRow)
- WebPushRow (@suphark/ui/pwa): แถวตั้งค่าเปิด/ปิดการแจ้งเตือน Web Push บนเบราว์เซอร์ พร้อมจัดการ Service Worker registration, PushManager subscription, permission check, และ Feedback toast อัตโนมัติ

## [0.47.0] — 2026-10-08

### Changed

- **`@suphark/ui/sortable` รองรับโครงเดียว: หัวกลุ่มกับแถวรายการเป็นพี่น้องกัน** (`<tr>` ใน `<tbody>` เดียวกัน หรือการ์ดในลิสต์เดียวกัน) — เจ้าของเลือกให้เหลือรูปแบบเดียวเพื่อดูแลง่าย หลัง Pi Config ย้ายจากโครง "`<tbody>` ต่อกลุ่ม" มาแบบนี้แล้ว (71735f0) · **ห้ามให้ node ของกลุ่มครอบแถวรายการไว้** (เช่นแปะ `ref` ของกลุ่มที่ `<tbody>` ที่ห่อแถวคีย์) ไม่งั้นแถวลูกจะเลื่อนสองชั้นและกรอบของก้อนถูกนับซ้ำ · ถอดโค้ดที่เคยรองรับโครงนั้นออก (`insideGroup` ใน context ภายใน, การกันนับซ้ำใน `blockRect`) — ไม่มี props ใดเปลี่ยน แอปที่ทำตามตัวอย่างใน `/components/sortable-list` ไม่ต้องแก้อะไร


### Added

- type `DistributiveOmit<T, K>` / `DistributivePick<T, K>` (ขอจาก Pi Auth): `Omit` ปกติยุบ union ของ props ที่มี discriminant — `Omit<DatePickerProps, "locale">` ทำให้ `name` กลายเป็น `string | [string, string]` แยกตาม `mode` ไม่ได้อีก ตัวห่อของแอปจึงพัง · ใช้ `DistributiveOmit<DatePickerProps, "locale">` แทนได้เลย ไม่ต้อง cast (มีเทสต์ type ที่พิสูจน์แล้วว่าแดงเมื่อถอดตัวแก้)


### Fixed

- `@suphark/ui/sortable`: ลากรายการเข้ากลุ่มอื่นไปวาง "ใต้" แถวหนึ่ง ระหว่างลากอยู่ถูกที่ แต่ปล่อยแล้วกระโดดไปอยู่ "เหนือ" แถวนั้น (เจ้าของเจอในตัวอย่างโครง `<tbody>`) — ตอนข้ามกลุ่มจัดตำแหน่งก่อน/หลังไว้แล้ว แต่ตอนปล่อย `reorderItems` ย้ายไปแทนที่แถวที่ชี้ซ้ำอีกรอบ · ตอนนี้ถ้าปล่อยตอนยังชี้แถวเดิมที่ข้ามกลุ่มเข้ามา ใช้ตำแหน่งที่จัดไว้เลย
- showcase: `/components/sortable-list` **เอาตัวอย่างโครง `<tbody>` ต่อกลุ่มออก** — เจ้าของเลือกให้มีรูปแบบเดียว (หัวกลุ่ม + แถวรายการเป็น `<tr>` ใน `<tbody>` เดียวกัน) เพื่อดูแลง่าย


### Fixed

- `AuthLayout`: โลโก้แนวนอนถูกบีบในกรอบ 44×44 จนอ่านไม่ออก (Pi Auth — wordmark ของลูกค้า 315×70 เหลือสูง ~10px) · ตอนนี้ `<img>` สูง 44px กว้างตามสัดส่วน (ไม่เกิน 220px) ส่วนไอคอน/ตัวอักษร (svg, span) ยังเป็นกรอบจัตุรัสมนเหมือนเดิม — เลือกเองตามชนิดลูก แอปไม่ต้องรู้สัดส่วนรูป
- showcase: `/components/auth-layout` เพิ่มแท็บ "โลโก้แนวนอน"

## [0.45.0] — 2026-10-08

> ประกาศพร้อม publish แล้ว แต่ยังไม่ขึ้น npm — รวมอยู่ใน 0.45.1


### Added

- `RecordCard iconSize="sm" | "md"` (ขอจาก DueBell — การ์ดบิลโหมดกะทัดรัด): `sm` = กรอบ 36px (ไอคอน 16px) เยื้องรายละเอียด/แถบล่าง `ml-12` · `md` (ค่าเริ่มต้น) = 44px / `ml-14` เหมือนเดิม · ใช้คู่ `iconTile={false}` ได้เพื่อตั้งระยะเยื้องให้ตรงไอคอนของแอปเอง
- showcase: `/components/record-card` เพิ่มการ์ดแบบ `iconSize="sm"`

## [0.44.0] — 2026-10-08

> ประกาศพร้อม publish แล้ว แต่ยังไม่ขึ้น npm — รวมอยู่ใน 0.45.0


### Added

- **`Button tone`** (สเปกจาก DueBell — `ToneButton`): ปุ่มขอบโครงเดียวกัน ต่างแค่สีตามความหมายของรายการ — `income` เงินเข้า/รับเงิน · `expense` เงินออก/จ่าย · `reminder` รายการเตือน (ม่วง) · `warning` ย้อนกลับได้ (พักรายการ, รอยืนยัน) · `revert` เลิกทำ/ย้อนสถานะ (สีเดียวกับ expense) — ลบถาวรยังเป็น `variant="destructive"` · type `ButtonTone`
- token `--tone-{income,expense,reminder,warning}` / `-border` / `-hover` ทั้งสองธีม — **แอป override เป็นสีประเภทรายการของตัวเองได้** (ค่าเริ่มต้นผูกกับตระกูล success/destructive/warning + ม่วงใหม่) · วัดบนเบราว์เซอร์แล้ว: ตัวอักษร 7.1–8.4:1 (สว่าง) / 12.5–16:1 (มืด), ขอบ 3.2–3.8:1 / 3.4–4.0:1
- showcase: `/components/button` เพิ่มแถวปุ่มโทน

### Changed

- `RecordCard` กรอบไอคอน: ขอบ `color-mix(accent 25%)` (เดิม 35%) ให้ตรงสูตร `CategoryIcon` ของ DueBell (พื้น 12% / ขอบ 25%) — แอปส่งไอคอนเปล่าได้เลย

## [0.43.0] — 2026-10-08

> ประกาศพร้อม publish แล้ว แต่ยังไม่ขึ้น npm — รวมอยู่ใน 0.44.0


### Added

- **`RecordCard` — การ์ดรายการมาตรฐาน** (ยกจาก `LedgerCard` ของ DueBell ที่ใช้ 3 ที่: รายการบิล, การ์ดแค็ตตาล็อก, ศูนย์แจ้งเตือน): หัว = ไอคอน + ชื่อ/สถานะ + meta → รายละเอียด → แถบล่าง (`footerSummary` ซ้าย, `actions` ขวา) โดยรายละเอียดและแถบล่างเยื้องตรงคอลัมน์ข้อความ · `accent` รับ tone (`neutral/info/success/warning/danger` + ชื่อเดิม `default/destructive`) **หรือสี CSS ตรง ๆ** (`var(--type-income)`) → ขอบซ้าย 3px + ขอบจาง 30% + พื้นไล่สี 11% + กรอบไอคอนตามสี · ชื่อยาวตัดที่ 2 บรรทัด ไม่ดันป้ายสถานะตก · `unread`, `onSelect` (ปุ่มในแถบล่างไม่ไปโดน), `as="li"`, `titleAs` · `recordAccentColor()` · `UiText.record.details`

### Changed

- **`NotificationCenter` ประกอบจาก `RecordCard` + `StatusBadge`** (DueBell: แถวเดิมเขียนเลย์เอาต์ซ้ำกับการ์ดของแอปและเป็น private) — เพิ่มอย่างเดียว ของเดิมใช้ต่อได้:
  - แถวคือ `RecordCard` · `NotificationEntry.accent` (สี CSS สำหรับสีของประเภทรายการ เช่น รายรับ/รายจ่าย/เตือน) + `details`
  - `renderItem(item, { busy })` เรนเดอร์แถวเองได้
  - ชิปนับเป็น `StatusBadge` (ชิปทั้งระบบชุดเดียว) · tone รับ `danger`/`neutral` แบบ `StatusBadge` (`destructive`/`default` ยังได้)
  - `NotificationAction.render` ใส่ปุ่มของแอปเองได้ (เช่น `ToneButton`) · `onSelect` ไม่บังคับเมื่อใช้ `render`
  - `headingAs` / `headingClassName` (หัวข้อแบบ label ตัวเล็กของแอป)

### Fixed

- **`@suphark/ui/sortable` ลากกลุ่มแล้วกลุ่มอื่นไม่เลื่อนหลบ เมื่อแอปแปะ ref ของกลุ่มที่ `<tbody>` ทั้งก้อน** (Pi Config รายงานหลัง bump 0.42.1): ตัดสินก่อน/หลังจากกลางของสิ่งที่ลาก — ก้อน `<tbody>` สูงจนกลางไม่เคยเลยครึ่งของกลุ่มเป้าหมาย → ได้ "ที่เดิม" เสมอ · ตอนนี้ใช้ตำแหน่งเมาส์ · และแถวที่อยู่ใน node ของกลุ่มเองไม่ได้ transform ซ้ำอีกชั้น (เดิมเลื่อนสองเท่า) และไม่ถูกนับซ้ำตอนวัดขนาดก้อน
- showcase: `/components/record-card` ใหม่ · `/components/notification-center` เพิ่มรายการเตือนสีม่วง (accent สี CSS) + รายละเอียด · `/components/sortable-list` เพิ่มตัวอย่างโครง `<tbody>` ต่อกลุ่ม (แบบ Pi Config)


### Fixed

- **วันที่สัมพัทธ์นับผิด 1 วัน** (เจอตอนตรวจ 0.42.0 บน production: พิมพ์ `t+3` ได้ 10 ต.ค. ถูก แต่วงเล็บบอก "(ใน 2 วัน)") — `formatRelativeThaiDate` ใช้ `formatDistanceToNow` ซึ่งนับเวลาจาก "ตอนนี้" ถึงเที่ยงคืนของวันนั้น (บ่าย/ค่ำเหลือ ~2.4 วัน → 2) และมีคำว่า "ประมาณ 1 เดือน" · ตอนนี้นับเป็นวันปฏิทินด้วย `Intl.RelativeTimeFormat`: "ในอีก 3 วัน", "10 วันที่ผ่านมา", "เดือนหน้า", "ปีที่แล้ว" (< 31 วัน = วัน, < 12 เดือน = เดือน, ที่เหลือ = ปี) — กระทบ `DatePicker` และ `RelativeDate` · `DatePicker locale` ใช้สูตรเดียวกัน (เดิมนับเป็นวันอย่างเดียว "in 45 days")
- `formatRelativeCalendarDate(date, locale)` ใน `lib/formatters` (ใช้ร่วมกันข้างใน)


### Added

- **`DatePicker` พิมพ์ลัด** (เจ้าของขอ): `t` = วันนี้, `t+3` / `t+3d` = อีก 3 วัน, `t-2` = 2 วันก่อน, `t+2w` สัปดาห์, `t+1m` เดือน, `t+1y` ปี (`today`/`วันนี้` และหน่วยไทย วัน/สัปดาห์/เดือน/ปี ก็ได้; ปลายเดือนตัดให้อยู่ในเดือนถัดไปแบบ date-fns) · ช่วง: `t-7..t`, `t ~ t+1m`, `t ถึง t+3` — ใช้ได้กับ `parseSmartDateInput` / `parseSmartDateRange` ทุกที่ (รวม `FormFieldDate`)
- ปุ่ม (i) ท้ายช่องพิมพ์ เปิดตารางวิธีพิมพ์ในกล่องเดียวกัน (ไม่ใช่ tooltip — popup ซ้อน popup และจอสัมผัสเปิด tooltip ไม่ได้) · ข้อความจาก `UiText.datePicker.help*`

### Changed

- **เลิกปุ่มทางลัด** (วันนี้/พรุ่งนี้/+1 สัปดาห์ …) ทั้งแบบวันเดียวและช่วง — ใช้การพิมพ์ลัดแทนเพื่อลดพื้นที่ · `showPresets` ยังรับได้แต่ไม่มีผล (deprecated)
- ช่วงวันที่: **ไม่ใส่ปี = ปีปัจจุบันเสมอ** (0.41.0 ยืมปีจากฝั่งขวา)
- placeholder ช่องพิมพ์: "เช่น 15/3, t+3, t+1m" / ช่วง "เช่น 1/7-5/7, t-7..t"

## [0.41.0] — 2026-10-07

> ประกาศพร้อม publish แล้ว แต่ยังไม่ขึ้น npm — รวมอยู่ใน 0.42.0


### Added

- **`DatePicker mode="range"` — เลือกช่วงวันที่** (เจ้าของขอ): คลิกวันเริ่มแล้ววันสุดท้าย (มีบรรทัดบอก "เลือกวันสุดท้ายของช่วง" ระหว่างเลือก) หรือพิมพ์ **"1/7-5/7" = 1–5 ก.ค.** · รองรับ "1-5/7", "1/7 - 5/8/68", "1/7 ถึง 5/7", "1/7 to 5/7", "1/7–5/7" · ปีที่ไม่ได้พิมพ์ฝั่งซ้ายใช้ปีฝั่งขวา · ใส่กลับด้านแล้วสลับให้ · "1-7-2568" ยังเป็นวันเดียวเหมือนเดิม (`-` เป็นตัวคั่นช่วงเมื่อมี `/` หรือ `.`)
  - แสดงด้วย `Intl.DateTimeFormat#formatRange` ตาม `locale`: "1–5 ก.ค. 2569" / en-GB "1–5 Jul 2026"
  - ทางลัดของช่วง: วันนี้, 7/30 วันล่าสุด, เดือนนี้, เดือนที่แล้ว, 7/30 วันข้างหน้า
  - ฟอร์ม: `name={["from", "to"]}` ส่ง `YYYY-MM-DD` สองช่อง (ใช้กับ `<form method="get">` ของตัวกรองได้ตรง ๆ) + `required` · `value`/`defaultValue` = `{ from, to }` (Date หรือ "YYYY-MM-DD") · `onChange(range | null)`
- `parseSmartDateRange(input)` · types `DatePickerRange`, `DatePickerSingleProps`, `DatePickerRangeProps` (`DatePickerProps` เป็น union — ของเดิมที่ไม่ส่ง `mode` ใช้ได้เหมือนเดิม)
- `UiText.datePicker`: `rangePlaceholder`, `rangeSmartPlaceholder`, `pickEnd`, ทางลัดของช่วง
- showcase: `/components/date-picker` เพิ่มตัวอย่างช่วงวันที่


### Fixed

- `DatePicker`: ปฏิทินใน popup มีที่ว่างซ้ายขวามาก (เจ้าของแจ้ง) — กล่องกว้างตายตัว 320–340px แต่ช่องวันที่ 28px ปฏิทินจึงกว้างแค่ ~200px · ตอนนี้ช่องวันที่ 40px (กดง่ายขึ้นด้วย) และกล่องกว้างพอดีปฏิทิน 306px (commit แรกหลุด format ของ biome — แก้ในรุ่นเดียวกัน)

## [0.40.0] — 2026-10-07

> ประกาศพร้อม publish แล้ว แต่ยังไม่ขึ้น npm — รวมอยู่ใน 0.40.1


### Added

- **`DatePicker` ใช้ในฟอร์มและหลายภาษาได้** (ขอจาก Pi Auth — `<input type="date">` แสดง "10/02/2027" อ่านได้ทั้ง 2 ต.ค. และ 10 ก.พ.):
  - `locale` (BCP 47): แสดงผ่าน Intl `{ day, month: "short", year }` ทั้งในช่อง ปฏิทิน และวันที่สัมพัทธ์ — `"en-GB"` = "2 Oct 2027", `"en"` = "Oct 2, 2027", `"th"` = "2 ต.ค. 2570" · ไม่ส่ง = รูปแบบไทยเดิม
  - `name` (+ `defaultValue` แบบไม่ควบคุม, `value`/`onChange` ไม่บังคับแล้ว): ส่ง `YYYY-MM-DD` ตามวันที่ local ไปกับ FormData ของ `<form action>` · `required` ทำงานกับการตรวจของเบราว์เซอร์และตาข่ายฟอร์ม (ชื่อช่องจาก `LabeledField`)
  - `showRelative` (ค่าเริ่มต้น true) · `toDateInputValue(date)` export ให้ใช้เอง · type `DatePickerProps`
  - `UiText.datePicker` (placeholder, ทางลัด, ปุ่ม) ไทย/อังกฤษในตัว

### Changed

- `DatePicker` ย้ายไป `components/shared/date/date-picker.tsx` — ไม่ได้มาจาก shadcn CLI (registry ของ base-nova ไม่มี date-picker) แต่ยกมาจาก supplychain; `components/ui/date-picker` ยัง re-export ให้ import path เดิมใช้ได้
- ข้อความเดิมที่ฝังไว้ย้ายไป UiText: placeholder ค่าเริ่มต้นจาก "เลือกวันที่อ้างอิงราคา..." (ของ supplychain) เป็น "เลือกวันที่", ทางลัดเป็นภาษาไทย ("วันนี้", "+1 สัปดาห์" …) แทนอังกฤษปนไทย, หัวข้อ "Quick Preset" → "ทางลัด"
- สีดิบ (slate/emerald) → semantic token · ปุ่ม "ตกลง" ของช่องพิมพ์วันที่เป็น `type="button"` (เดิม submit — ส่งฟอร์มแม่ได้ถ้าไม่ได้กด Enter) · ปุ่มล้างมี `aria-label` และกดด้วยคีย์บอร์ดได้

### Fixed

- `value="YYYY-MM-DD"` อ่านเป็น UTC แล้วเลื่อนวันในโซนเวลาตะวันตก → อ่านเป็นวันที่ local
- วันที่สัมพัทธ์ ("(พรุ่งนี้)") แสดงหลัง mount — ขึ้นกับวันของเครื่องผู้ใช้ จึง hydration mismatch ได้ข้ามวัน/โซนเวลา (ค้างใน todo)
- showcase: `/components/date-picker` เพิ่มตัวอย่างในฟอร์ม server action (`name` + `locale="en-GB"` + `required`)


### Added

- **`SortableProvider freeLayout` — ชั้นบนสุดจัดได้อิสระ** (เจ้าของแจ้งว่าเดิม "ล็อก" ให้รายการไม่มีกลุ่มอยู่บนเสมอ กลุ่มอยู่ล่างเสมอ): กลุ่มกับรายการไม่มีกลุ่มสลับที่กันได้ทุกแบบ — กลุ่มขึ้นไปเหนือรายการ, รายการไปอยู่ระหว่างกลุ่ม, เอารายการออกจากกลุ่มไปวางก่อนกลุ่มไหนก็ได้ · หัวกลุ่ม: **ครึ่งบน = วางก่อนกลุ่ม, ครึ่งล่าง = เข้ากลุ่มเป็นตัวแรก** · ระหว่างลากทุกอย่างในชั้นบนสุดเลื่อนหลบเป็นก้อน (กลุ่ม = หัว + รายการ) · โซนท้ายตาราง = วางท้ายสุด · ไม่เปิด = แบบเดิม (แอปที่ยังเรนเดอร์รายการไม่มีกลุ่มก่อนไม่เปลี่ยนพฤติกรรม)
- `SortableOrder.root` (optional) + `rootEntries(order)` (ลำดับชั้นบนสุดสำหรับวนเรนเดอร์), `moveRootEntry`, `moveItemToRoot`, type `SortableRootEntry` · `sortableOrderToPayload(order).root` + `sortableOrderOf(..., { root })` สำหรับบันทึก/โหลด — `groups` / `items[UNGROUPED]` ยังตรงกับ root เสมอ (payload เดิมใช้ต่อได้)
- showcase: `/components/sortable-list` เปิด `freeLayout` และเรนเดอร์ตาม `rootEntries`

### Fixed

- (จาก 0.38.1 ที่ไม่ได้ขึ้น npm แยก) ลากรายการเข้ากลุ่มแล้ววางเป็นรายการแรกไม่ได้ — ดูด้านล่าง
- โซน "ท้ายตาราง" (`useSortableDropZone(UNGROUPED)`) ถูก collision เปลี่ยนเป้าหมายเป็นรายการไม่มีกลุ่มตัวแรก → วางแล้วไปโผล่บนสุดแทนท้ายสุด

## [0.38.1] — 2026-10-07

> ประกาศพร้อม publish แล้ว แต่ยังไม่ขึ้น npm — รวมอยู่ใน 0.39.0

### Fixed

- **`@suphark/ui/sortable` ลากรายการเข้ากลุ่มแล้ววางเป็นรายการแรกไม่ได้** (เจ้าของแจ้ง): ระหว่างลากขึ้นเป็นตัวแรกถูก แต่พอปล่อยกลับไปเป็นตัวที่สอง — ตอนชี้หัวกลุ่ม collision เลือก "รายการที่ใกล้ที่สุดที่ไม่ใช่ตัวที่ลาก" (= ตัวแรกเดิม) แล้ว `onDragEnd` ย้ายไปแทนที่ตัวนั้น · ตอนนี้ชี้หัวกลุ่ม = รายการแรกที่แสดงอยู่ **รวมตัวที่ลากเอง** · ยืนยันบน demo: ลากจากนอกกลุ่ม / จากกลุ่มอื่น / จากท้ายกลุ่มเดียวกันขึ้นหัวกลุ่ม → เป็นตัวแรกทุกกรณี, วางครึ่งล่างของแถวยังไปอยู่ "หลัง" แถวนั้นตามเดิม (ทำซ้ำบน production v0.38.0 ได้ก่อนแก้)


### Fixed

- **`@suphark/ui/sortable` ลากกลุ่มแล้วไม่เห็นอะไรขยับ** (เจ้าของแจ้ง): หัวกลุ่มมักอยู่ใน `SortableGroup` ซึ่งเป็น context ของรายการ dnd-kit จึงหากลุ่มในลำดับไม่เจอ ไม่มีแถวไหนได้ transform เลยจนปล่อย · ตอนนี้ provider คำนวณระยะเลื่อนของกลุ่มเอง และเลื่อน **ทั้งก้อน** (หัวกลุ่ม + แถวรายการ) — กลุ่มอื่นหลบเท่าความสูงทั้งก้อน, ช่องจาง ๆ ของกลุ่มที่ลากเลื่อนไปจุดวาง (ไม่มี overlay = ทั้งก้อนลอยตามเมาส์) · ที่วางของกลุ่มวัดรวมแถวรายการ ใช้ได้ทุกโครงสร้างโดยไม่ต้องแก้ call site · วัดบนหน้า demo: ลาก "ฐานข้อมูล" ลงเลย "อีเมล" → ฐานข้อมูลทั้งก้อน +134px, อีเมลทั้งก้อน −135px, ปล่อยแล้วไม่มี style ค้าง
- แถวต้นทางจางค้างหลังปล่อย (เจอกับหัวกลุ่ม): side effect ของ drop animation ใน dnd-kit จำ opacity ที่เราตั้งไว้เป็นค่าเดิมแล้วเขียนคืน — ปิด side effect นั้น (opacity คุมผ่าน style ของ React อยู่แล้ว)

### Added

- `SortableProvider multiSelect` (+ `selected`/`onSelectedChange` ถ้าจะคุมเอง): เลือกหลายรายการแล้วลากไปพร้อมกัน — ⌘/Ctrl+คลิก ทีละตัว, Shift+คลิก เป็นช่วง (เฉพาะแถวที่แสดง), คลิกเฉย ๆ ล้าง (คลิกปุ่ม/ช่องกรอกในแถวไม่นับ) · ที่จับ: `x` เลือก/ไม่เลือก, ⌘/Ctrl+A ทั้งหมด, Esc ล้าง · ลากตัวที่เลือก = ทุกตัวที่เลือกจางลงตรงที่เดิมแล้วไปรวมที่จุดวาง เรียงตามลำดับเดิม (ข้ามกลุ่มได้) · ลากตัวที่ไม่ได้เลือก = ลากตัวเดียวและล้างการเลือก
- `useSortableRow` คืน `selected` + `selectProps` (กระจายลงแถว มี `data-selected` ไว้ทำสี) · `useSortableState` คืน `selected`/`clearSelection` (ใช้คู่ `SelectionBar`)
- `renderOverlay` ได้ `SortableDrag` = `{ kind, id, ids }` (`ids` = ทุกตัวที่ลากไปด้วยกัน — ทำการ์ดซ้อน + จำนวน) · `SortableAnnouncementContext.count` + `UiText.sortable.startedMany` ("เริ่มลาก {count} รายการที่เลือกไว้")
- helper pure: `flatItems(order)`, `gatherItems(order, activeId, ids)`
- showcase: `/components/sortable-list` เปิด `multiSelect` + `SelectionBar` + การ์ดซ้อนตอนลากหลายคีย์


### Added

- **`FormInvalidNet`** (ข้อเสนอจาก Pi Auth — มี `<form action>` เขียนเอง ~60 จุด): ตาข่ายฟอร์ม invalid ระดับแอป วางครั้งเดียว ฟัง `invalid` ทั้ง document แล้วแจ้งเป็น toast ข้อความเดียวกับ `UiText.invalidForm` + พาไปช่องแรกที่โฟกัสไม่ได้ · ข้ามฟอร์มที่มีตาข่ายของตัวเอง (`FormDialog`/`ActionForm`/`useFormInvalidNotice` ใส่ `data-invalid-notice` ให้; ใส่เองที่ฟอร์มเพื่อปิดได้) · วางซ้ำหลายที่ก็ไม่ขึ้น toast ซ้อน
- `AppShell` วาง `FormInvalidNet` ให้เอง — หน้านอก AppShell (เช่น /login) วางใน root layout ใต้ `Toaster`
- `useFormInvalidNotice().formProps` มี `data-invalid-notice` แล้ว
- showcase: root layout วาง `FormInvalidNet`; `/components/action-form` มีตัวอย่าง `<form>` ดิบ

## [0.36.0] — 2026-10-07

> ประกาศพร้อม publish แล้ว แต่ยังไม่ขึ้น npm — รวมอยู่ใน 0.37.0

มาตรฐานใหม่ (ขอจาก Pi Auth): **ปุ่มที่มีงานค้างต้องหมุน และฟอร์มที่ส่งไม่ได้ต้องบอกผู้ใช้เสมอ — ห้ามเงียบ**

### Added

- `Button loading`: ไอคอนนำหน้าเปลี่ยนเป็น spinner (ไม่มีไอคอน = เติมหน้าข้อความ ความกว้างปุ่มไม่กระตุก), กดซ้ำไม่ได้, `aria-busy="true"`, ปุ่มยังรับโฟกัส (`focusableWhenDisabled` — โฟกัสไม่หลุดไป body ตอนกด) · ไม่ใส่ `loading` + `type="submit"` ภายใน `<form action={…}>` = หมุนเองจาก `useFormStatus()` (ทุกปุ่ม submit ในฟอร์มนั้น) · `loading={false}` ปิดการตรวจอัตโนมัติ
- `useFormInvalidNotice()` → `{ formProps, message, notice }`: จับ event `invalid` ของฟอร์ม รวมชื่อช่องที่ไม่ผ่านเป็นข้อความเดียว "กรุณากรอกหรือแก้ไข: ชื่อ, อีเมล" (`role="alert"`) — รวมช่องที่เบราว์เซอร์โฟกัสไม่ได้ (ซ่อนในแท็บ/ขั้นที่ปิด, input ซ่อนของ Select) ซึ่งปกติไม่มีอะไรขึ้นเลยนอกจาก console · เลื่อนไปที่ Field ของช่องแรกและโฟกัส control ที่กดได้ในนั้น · หายเองเมื่อแก้ครบ · ชื่อช่องจาก `<label>` (รวมแบบครอบของ `LabeledField`), `aria-label`, `aria-labelledby`, label ของ `Field`, placeholder, `name`
- `UiText.invalidForm` (`fields` ใช้ `{fields}`, `generic`) — ไทย/อังกฤษในตัว

### Changed

- `FormDialog` / `ActionForm`: ปุ่มส่งใช้ `loading` ระหว่างรอ action (เดิมแค่ disabled จาง ๆ) และใส่ตาข่าย `useFormInvalidNotice` ให้เอง — แอปไม่ต้องแก้อะไร

## [0.35.0] — 2026-10-07

> ประกาศพร้อม publish แล้ว แต่ยังไม่ขึ้น npm — publish 0.36.0 ทีเดียวได้ทั้งสองรุ่น

### Added

- `SortableProvider renderOverlay={(drag) => …}`: วาดการ์ดลอยตามเมาส์แบบ Trello/Todoist (portal ไป `document.body` + drop animation 200ms) แถวต้นทางเหลือเป็นช่องจาง ๆ บอกตำแหน่งที่จะวาง · `useSortableState().overlay` บอกว่ากำลังใช้ overlay
- `useSortableDropZone(groupId, { onDwell, dwellMs = 600 })`: ลากค้างเหนือโซนครบเวลาแล้วเรียก `onDwell` — ใช้เปิดโฟลเดอร์ที่ย่ออยู่ให้เอง

### Changed

- **`@suphark/ui/sortable` ลากลื่นขึ้น** (ผู้ใช้แจ้งว่าสะดุดตอนเอาเข้าโฟลเดอร์): หาเป้าหมายจากตำแหน่งเมาส์ (`pointerWithin` → `rectIntersection`) แทน `closestCenter` ทั้งตาราง, จำเป้าหมายล่าสุดกันสั่นตอนรายการย้ายข้ามกลุ่ม, ย้ายข้ามกลุ่มแทรก **ก่อนหรือหลัง** แถวเป้าหมายตามครึ่งแถว (เดิมแทรกก่อนเสมอ → ลากเข้าจากด้านล่างแล้วกระโดดข้าม), วางบนหัวโฟลเดอร์ = ขึ้นบนสุดของโฟลเดอร์ (เดิมไปท้ายกลุ่ม/ท้ายตาราง), วัดตำแหน่งใหม่ทุกครั้งที่ layout เปลี่ยน (`MeasuringStrategy.Always`) และ transition 200ms แบบ ease-out · วัดด้วย probe ลาก APP_URL ลง 222px: เดิมกระโดดไปท้ายกลุ่มแล้วไปท้ายตาราง, ตอนนี้ลงตรงใต้เมาส์และไม่เปลี่ยนเลยระหว่างค้างนิ่ง
- showcase: `/components/sortable-list` ใช้การ์ดลอย + ลากค้างเหนือโฟลเดอร์ที่ย่ออยู่แล้วเปิดให้เอง

### Docs

- README (`@suphark/ui/sortable`): วิธีตรวจว่า `id` ทำงาน — `aria-describedby` ของที่จับเป็น id ที่ส่งเข้าไปตรง ๆ ไม่มี prefix `DndDescribedBy-` (prefix มีเฉพาะตอน dnd-kit สร้างเอง) และ element คำอธิบายถูกสร้างหลัง hydrate ต้องรอ mount ก่อน query (Pi Config ยืนยันบนของจริงหลัง bump 0.34.0)

## [0.34.0] — 2026-10-06

### Fixed

- **`SortableProvider` ทำ hydration mismatch ทุกหน้าที่ SSR** (รายงานจาก Pi Config ตอนลากบนของจริง): ไม่ได้ส่ง `id` ให้ `DndContext` → dnd-kit สร้าง `aria-describedby="DndDescribedBy-N"` จากตัวนับที่เดินไม่ตรงกันระหว่าง server กับ client, React 19 ขึ้น error และ **ไม่ซ่อมให้** — attribute ค้างชี้ element ที่ไม่มีอยู่ ผู้ใช้ screen reader จึงไม่ได้ยินคำอธิบายวิธีลาก · ตอนนี้ค่าเริ่มต้นเป็น `useId()` (ตรงกันทั้งสองฝั่ง) และรับ prop **`id`** สำหรับ id ที่สื่อความหมาย — กระทบทุกแอปที่ใช้ `@suphark/ui/sortable` ใน Next.js
- `@suphark/ui/sortable`: เสียงประกาศระหว่างลากในกลุ่มเดียวกันบอกตำแหน่ง **เดิม** ซ้ำ ("ย้ายไปตำแหน่งที่ 1 จาก 2" ทั้งที่เลื่อนลงแล้ว) เพราะลำดับจริงเปลี่ยนตอนปล่อย — ตอนนี้ระหว่างลากประกาศตำแหน่งของเป้าหมาย และตอนปล่อยประกาศตำแหน่งจริงหลังย้าย (เจอระหว่างทดสอบลากด้วยคีย์บอร์ดตามที่ Pi Config ถาม; ลากด้วยคีย์บอร์ดเองทำงานถูกอยู่แล้ว)
- showcase: `/components/sortable-list` ย้ายแถว "ลากมาที่นี่เพื่อเอาออกจากกลุ่ม" ไปท้ายตาราง — เดิมโผล่เหนือกลุ่มตอนเริ่มลาก ดันแถวที่กำลังลากลง จนลากคีย์ในกลุ่มด้วยคีย์บอร์ดไม่ขยับ (README เพิ่มคำเตือนนี้ + เรื่อง `id`)

## [0.33.0] — 2026-10-06

### Fixed

- **คอนทราสต์ไม่ผ่าน WCAG AA 3 จุด** (DueBell วัดจากหน้าจริงทั้งสองธีม — ผมคำนวณจาก token ซ้ำได้ตัวเลขตรงกันทุกจุด):
  - `--info` ธีมสว่าง: `text-info` บนพื้นขาว **4.02:1** → ลดความสว่าง L 0.588 → 0.53 = **5.05:1** (ตัวหนังสือขาวบน `bg-info` ก็ขึ้นเป็น 5.05:1 เท่ากัน) — สีฟ้าเข้มขึ้นเล็กน้อย
  - `--muted-foreground` ธีมสว่าง: บนพื้น `--muted` **4.35:1** (กระทบ `CountBadge tone="muted"`, แท็บที่ไม่ได้เลือกบน `TabsList`, ป้ายนับใน `SegmentedControl` …) → L 0.554 → 0.52 = **5.02:1** (บนขาว 5.4:1) — ตัวหนังสือรองเข้มขึ้นเล็กน้อยทั้งระบบ
  - ป้ายนับ `CountBadge tone="destructive"` (รวมปุ่มแจ้งเตือนใน `AppShell`/`MobileTabBar`) ธีมมืด: ตัวหนังสือขาวบน `--destructive` **2.89:1** → token ใหม่ **`--destructive-foreground`** (สว่าง = ขาว 4.76:1, มืด = สีพื้นเข้ม **6.97:1**) — ไม่ลดความสว่างของ `--destructive` ธีมมืดเพราะ `text-destructive` บนพื้นมืดจะไม่ผ่านแทน
  - ใช้ `text-destructive-foreground` คู่ `bg-destructive` ได้ทุกที่ (ใหม่ใน `@theme`)

## [0.32.0] — 2026-10-06

> แก้บั๊กที่แอปรายงานหลัง 0.30.0 — เดิมเตรียมไว้ใน 0.31.0 แต่ 0.31.0 ถูก publish (12:53 น.) ก่อน commit ทั้งสามนี้ (12:56–13:09 น.) ตรวจ tarball แล้วไม่มี จึงออกเป็น 0.32.0

### Fixed

- **`@suphark/ui/sortable`: แถวกลุ่มไม่ได้อยู่ใน `SortableContext`** (รายงานจาก Pi Config ตอนย้าย `values-table`) — `SortableGroup` สร้าง context ให้เฉพาะรายการในกลุ่ม ส่วนแถวกลุ่มที่ลงทะเบียนด้วย `useSortableRow({ type: "group" })` ไม่มี context ไหนรับ ทำให้ลากกลุ่มแล้วไม่มีการเลื่อนแถวให้เห็นระหว่างลาก (ปล่อยแล้วลำดับยังถูก) — ตอนนี้ `SortableProvider` สร้าง `SortableContext` ชั้นนอกจาก `order.groups` ให้เอง **ไม่ต้องแก้ call site และลำดับใน context หลุดจากลำดับจริงไม่ได้**

- **`ActivityFeed relative={false}` พังทุกแถว** (รายงานจาก Pi Auth): วันที่กลายเป็น `-` และ console เต็มไปด้วย `TypeError: Invalid option` เพราะส่ง `timeStyle` ปนกับ `day`/`month`/`year` ซึ่ง `Intl.DateTimeFormat` ไม่ยอม — ต้นเหตุจริงอยู่ที่ **`ClientDateFormatter` เอา default (`day`/`month`/`year`) ไปผสมกับ options ของผู้เรียกเสมอ** ทำให้ทุกแอปที่ส่ง `dateStyle`/`timeStyle` พังเหมือนกัน; ตอนนี้ถ้าผู้เรียกใช้ `dateStyle`/`timeStyle` จะไม่ผสม default ให้ และ `ActivityFeed` เปลี่ยนไปใช้ `{ dateStyle: "medium", timeStyle: "short" }` (เทสต์ใหม่ครอบทั้งสองชั้น)

### Added

- `prepublishOnly` เรียก `scripts/release-check.mjs` ก่อน publish: working tree ต้องสะอาด, HEAD ต้องตรงกับ `origin/main` หลัง fetch และ CHANGELOG ต้องมีหัวข้อของเวอร์ชันนั้น — กันปล่อยรุ่นที่ขาด commit (เกิดมาแล้ว 3 ครั้ง: 0.17.0, 0.30.0, 0.31.0; ข้อเสนอจาก Pi Auth/Pi Config)

### Changed

- `ActivityFeed`: รับ `locale` แล้วส่งต่อให้ตัวฟอร์แมตวันที่ (ไม่ส่ง = `th-TH` เหมือนเดิม) — เดิมวันที่เป็นไทยตายตัวสำหรับทุกคน แอปสองภาษาจึงแสดงผิดเมื่อผู้ใช้เลือกอังกฤษ (รายงานจาก Pi Auth ตอนทำหน้า audit log); `emptyLabel` ค่าเริ่มต้นย้ายไปอ่านจาก `UiText.activity.empty` (คีย์ใหม่)

## [0.31.0] — 2026-10-06

> 0.30.0 ถูก publish ก่อน commit ของ `NotificationCenter` (ตรวจ tarball แล้วไม่มีไฟล์ `shared/notification-center.tsx`) จึงเลื่อนมาออกเป็น 0.31.0 — ของอื่นใน 0.30.0 อยู่ครบตามรายการข้างล่าง

### Added

- **`NotificationCenter`** — ศูนย์การแจ้งเตือน (ยกจาก DueBell `notification-modal` + `urgent-bills-widget`): ชิปนับหลายกลุ่มที่กดกรองได้ + รายการที่ต้องจัดการ พร้อมปุ่มลัดต่อรายการและเมนู "…" · ออกแบบตามข้อกำหนดที่ DueBell ให้มา — ชิปเป็น array (`counts`) ไม่ใช่ prop ตายตัว, คำสั่งเป็น array (`actions` + `menuActions`), ของโดเมนส่งเป็น node ที่แอปเตรียมแล้ว (`status`/`meta`/`footer` — ยอดเงินที่ซ่อนได้, ความคืบหน้ารอบ), **แพ็กเกจไม่ฟอร์แมตวันที่เอง** และ **ไม่ตัดรายการเอง** (จะจำกัดจำนวนให้แอป slice ก่อนแล้วส่ง `viewAll` — ตัวเลขในชิปจึงตรงกับที่ผู้ใช้เห็นเสมอ); `busy` ปิดปุ่มทุกตัวระหว่างทำคำสั่งลัด · คีย์ `UiText.notifications`

## [0.30.0] — 2026-10-05

### Added

- **ข้อความที่ผู้ใช้เห็นในแพ็กเกจเปลี่ยนภาษาได้ครบแล้ว** — เก็บข้อความไทยที่ฝังตายใน JSX อีก 34 จุดเข้า `UiText`: `DataTableToolbar` (ค้นหา/ล้าง/ตัวกรอง/คำอธิบาย/ปิด), `DataTableFacetedFilter` + `FormFieldCombobox` ("ไม่พบข้อมูล"), `MultiSelectCombobox` (ล้างทั้งหมด/ลบ/เพิ่ม), `ResourcePropertyFilter` (ทั้งแผง 14 จุด), `AppShell`/`SubNav`/`TopTabs` (เมนูหลัก/เมนูย่อย/เลือกหน้า/ไม่พบ/ล้างคำค้นหา), `ErrorState` (เซสชันหมดอายุ) — คีย์ใหม่: `UiText.combobox`, `UiText.filter`, `UiText.nav`, `UiText.sessionExpired` และ `UiText.table.{search,clearSearch,filters,filtersDescription,closeFilters,clearFilter}`
- **เทสต์กันข้อความฝังตาย** `no-hardcoded-text` (อยู่ใน `pnpm test`/CI): ไล่ JSX ของ `shared`/`app-shell`/`data-table`/`sortable` หาข้อความไทยที่ไม่มีทาง override — ยกเว้นได้แต่ต้องเขียนเหตุผลใน ALLOW; มีชุด "ปลูกการละเมิด" พิสูจน์ว่าตัวตรวจจับของจริงได้และไม่จับของที่ถูกต้อง (คอมเมนต์/JSDoc/`?? "…"`/พจนานุกรมของ component) — ไอเดียจาก Pi Config ที่เจอว่าเทสต์แบบนี้ล้มเหลวเงียบได้ง่าย
- `SegmentedControl`: `tone` ต่อตัวเลือก (`success` / `warning` / `destructive` / `info`) — ลงสีเฉพาะตัวที่ถูกเลือก ใช้กับตัวกรองที่ "ประเภท" มีความหมายทางสี เช่นรายรับ/รายจ่าย (คำขอจาก DueBell ที่ต้องใช้ไอคอนแทนไปก่อน)

### Fixed

- `MonthStepper`: ปุ่มกลางตอนอยู่เดือนปัจจุบันเคยเป็น `<Button disabled>` ซึ่ง screen reader อ่านว่า "ปุ่ม ปิดใช้งาน" ทั้งที่มันคือป้ายชื่อเดือน — ตอนนี้เรนเดอร์เป็นป้ายธรรมดาเมื่อไม่มีอะไรให้กด (รายงานจาก DueBell) และตอนกดได้ใช้ tooltip ของ `Button` แทน `title` (เลิก tooltip ซ้อนของเบราว์เซอร์)

## [0.29.0] — 2026-10-05

### Added

- `InlineEdit`: คุมโหมดแก้ไขจากข้างนอกได้ — `editing` + `onEditingChange` (controlled), `defaultEditing` และ `onCancel` (กด Esc/✕) สำหรับแอปที่เข้าโหมดแก้ไขด้วย F2 หรือเมนูคลิกขวา "เปลี่ยนชื่อ" (คำขอจาก Pi Files — เดิมต้อง `.click()` ปุ่มดินสอผ่าน DOM)
- **`@suphark/ui/sortable` — ลากจัดลำดับ 2 ระดับ (กลุ่ม + รายการในกลุ่ม)** entry ใหม่บน dnd-kit (แยกจาก barrel เหมือน `data-table`/`kanban` เพราะ dnd-kit สร้าง context ตอน import) — ยกสมองส่วนลากออกจากแอป ส่วนการเรนเดอร์แถวยังเป็นของแอป (ตาราง/การ์ด/รายการ) ตามสเปกของ Pi Config (`values-table.tsx`)
  - `SortableProvider` — sensors (เมาส์ + คีย์บอร์ด), collision ที่กันลากข้ามชนิด (กลุ่มชนได้แค่กลุ่ม, รายการชนได้แค่รายการกับที่วางของกลุ่ม), ย้ายข้ามกลุ่มระหว่างลาก, commit ตอนปล่อย และ **คืนลำดับเดิมอัตโนมัติเมื่อบันทึกล้มเหลว** (throw หรือ `{ ok: false, error }`) — ไม่มี `onCommitError` = ขึ้น toast ให้; ส่งมา = ส่ง error ดิบให้แอปจัดการเอง ไม่กลืนเงียบ
  - `SortableGroup` (ขอบเขตการเรียงของกลุ่ม), `useSortableRow({ type, id })` → `{ ref, style, handleProps, isDragging }`, `useSortableDropZone(groupId)` (แปะที่ไหนก็ได้ — หัวกลุ่ม หรือแถว placeholder ของกลุ่มที่ไม่มีหัว; กลุ่มที่ย่ออยู่ก็ยังรับการวางได้), `useSortableState()` → `{ dragging, disabled }`, `DragHandle` (ใช้ `Button` ของแพ็กเกจ จึงได้ tooltip จาก `aria-label`; ปิดการลากแล้วที่จับจางลงเอง หรือซ่อนไปเลยด้วย `hideWhenDisabled`)
  - `announcements` + `screenReaderInstructions` ส่งเป็น prop ได้ (callback ได้ `{ id, kind, groupId, index, total }` ให้แอปประกอบข้อความจากชื่อจริง) ไม่ส่ง = แม่แบบจาก `UiText.sortable`
  - helper แบบ pure ใน `lib/sortable-order`: `sortableOrderOf`, `reorderGroups`, `reorderItems`, `moveItemToGroup`, `groupOfItem`, `sameOrder`, `moveWithin`, `sortableOrderToPayload` (คืน `{ groups: string[], items: [{ groupId: string | null, itemIds }] }` — ลำดับกลุ่มกับรายการในกลุ่มครบในก้อนเดียว, `UNGROUPED` → `null`)
- `UiText.sortable` — `handle`, `instructions`, `started`, `moved`, `dropped`, `cancelled` (`{index}` / `{total}`)
- showcase: หน้า `/components/sortable-list` — ตาราง 2 ระดับ ลากเรียงกลุ่ม/คีย์/ย้ายข้ามกลุ่ม พร้อมแถว "ลากมาที่นี่เพื่อเอาออกจากกลุ่ม" ที่โผล่เฉพาะตอนลากคีย์

## [0.28.1] — 2026-10-05

### Fixed

- **`AppShell` ปุ่มย่อ/ขยายเมนูยังมี "Toggle Sidebar" อังกฤษค้างอยู่ใน `sr-only`** (รายงานจาก DueBell): `SidebarTrigger` ของ shadcn ฝังข้อความนั้นเป็น children ซึ่งแทนด้วย props ไม่ได้ (JSX children ชนะ) — 0.27.1 เปลี่ยนได้แค่ `aria-label` ตอนนี้ `AppShell` เรนเดอร์ปุ่มเองจาก `Button` ของแพ็กเกจ + `useSidebar()` จึงใช้ `UiText.toggleSidebar` ทั้งชื่อและ tooltip และไม่มีข้อความอังกฤษเหลือในปุ่ม (ยังคง `data-sidebar="trigger"` ไว้ให้ selector เดิมใช้ได้)

## [0.28.0] — 2026-10-05

### Added

- **`ActivityFeed`** — เส้นเวลา "ใครทำอะไรเมื่อไหร่" จาก array เดียว (audit log ของ Pi Auth, ประวัติงานของ Pi Done, timeline ของเอกสาร): avatar ของผู้ทำหรือไอคอน+โทนสำหรับเหตุการณ์ของระบบ, เวลาสัมพัทธ์ที่คำนวณฝั่ง client หลัง mount (ไม่ทำ hydration mismatch) และช่องใส่ปุ่ม/ป้ายท้ายแถว
- **`InlineEdit`** — แก้ค่าในที่: คลิกดินสอ → ช่องกรอก (เลือกข้อความเดิมไว้ให้พิมพ์ทับได้ทันที) → Enter/✓ บันทึก, Esc/✕ ยกเลิก พร้อม `validate`, สถานะกำลังบันทึก และ toast เมื่อล้มเหลว (ถือ `{ ok: false, error }` เป็นล้มเหลว, `redirect()` เป็นสำเร็จ) — ใช้กับค่าสั้น ๆ ที่ไม่คุ้มเปิด `FormDialog`
- **`SelectionBar`** — แถบคำสั่งหมู่ "เลือก N รายการ" + ปุ่มคำสั่ง + ปุ่มล้าง (`floating` กลางล่างจอ หรือ `inline` ในหน้า) ใช้คู่ `DataTable` หรือ `SimpleTable`; ข้อความจาก `UiText.selection`
- **`SimpleTable` เลือกหลายแถวได้** — `selected` + `onSelectedChange` เปิดช่องติ๊กหน้าแถวและหัวตาราง (เลือกบางส่วนแสดงเป็นขีด), แถวที่เลือกมีพื้นจาง; คลิกช่องติ๊กไม่ไปโดน `onRowClick`
- `SimpleTabs`: แท็บล้นความกว้างแล้วเลื่อนแนวนอนได้ (ซ่อนแถบเลื่อน) + เงาขอบบอกว่ายังมีแท็บต่อ
- `UiText` คีย์ใหม่: `edit`, `selection.{selected,clear}`, `table.{rowsPerPage,pageOf,rowsSelected,noResults,deleteTitle,deleteDescription,deleting,deleted,delete}`

### Fixed

- **`DataTable` เลิกใช้ข้อความอังกฤษตายตัว** — "Rows per page", "Page X of Y", "N of M row(s) selected", "No results.", เมนู Edit/Delete, กล่องยืนยันลบ และ toast ตอนลบ ทั้งหมดมาจาก `UiText.table` (ค่าเริ่มต้นภาษาไทย) — `resourceName` แทรกผ่าน `{resource}`

## [0.27.1] — 2026-10-05

### Added

- `Button`: ถ้า `aria-label` ไปอยู่บน element ใน `render=` (เช่น `render={<Link aria-label="…"/>}`) ก็ใช้เป็น tooltip ได้ (เดิมต้องอยู่บน `Button` เท่านั้น — รายงานจาก Pi Auth)
- เทสต์ชุดใหม่ `button-tooltip-triggers`: ยืนยันว่าปุ่มไอคอนที่ส่งเป็น `render=`/`trigger` ของ `DropdownMenuTrigger` / `PopoverTrigger` / `FormDialog` / `RowActions` ยังได้ tooltip จริง (เช็กจาก popup ที่ขึ้น ไม่ใช่ `data-slot` — `data-slot` ของปุ่มจะกลายเป็นของ trigger ชั้นนอกเสมอ ใช้ชี้วัดไม่ได้)

### Fixed

- **ตัวห่อปุ่มของแพ็กเกจเองหล่น tooltip** (รายงานจาก Pi Auth): `LinkButton`/`ActionButton`/`CopyButton`/`DeleteManyButton`/`FloatingSaveButton`/`SelectionButton`, `DataTable*`, `UserMenu`, `OrganizationSwitcher`, `FilterBar`, `Combobox`, `Dropzone`, `StepForm`, `ActionForm`, `ErrorState`, `EnvSnippet`, `DateRangePicker`, `DateTimePicker`, `FormField*`, `LanguageSwitch`, `PwaInstallCard` และตัวอย่างใน `design-system` — ทั้งหมด import `Button` จากไฟล์ shadcn ดิบ (ไม่มี tooltip) ตอนนี้ย้ายมาใช้ตัวที่ห่อ tooltip แล้ว 33 ไฟล์ (ปุ่มไอคอนอย่าง `<LinkButton aria-label="…"><KeyIcon/></LinkButton>` จึงได้ tooltip ด้วย)
- `ActionButton` / `LinkButton`: มี `tooltip` ของตัวเองอยู่แล้ว → ส่ง `tooltip={false}` ให้ `Button` ชั้นใน กันขึ้นสองชั้น (props `tooltip`/`tooltipSide` ของ `ActionButton` ยังเป็นแบบเดิมทุกประการ)
- `DataTableRowActions`: ปุ่ม "…" ใช้ `aria-label` จาก `UiText.actions` แทน `sr-only` อังกฤษ "Open menu"
- **กฎใหม่กันพลาดซ้ำ**: `pnpm check:button` (อยู่ใน `verify` และ CI) ห้ามไฟล์ในแพ็กเกจ import `Button` จาก `components/ui/button` ยกเว้นไฟล์ shadcn เองกับตัวห่อ
- **`AppShell` ปุ่มย่อ/ขยายเมนู**: ปุ่มในหัวเรื่อง (`SidebarTrigger`) ได้ tooltip เหมือนปุ่มไอคอนอื่น และแถบลาก (`SidebarRail`) เลิกใช้ `title` ของ shadcn ที่ทำ tooltip ของเบราว์เซอร์ซ้อนขึ้นมา — ทั้งคู่ใช้ป้ายภาษาไทยจาก `UiText.toggleSidebar` (คีย์ใหม่, ค่าเริ่มต้น "ย่อ/ขยายเมนู" / EN "Toggle sidebar") แทน "Toggle Sidebar" ที่ฝังอยู่ในไฟล์ shadcn (รายงานจาก Pi Files หลัง bump ^0.27.0 — แก้ที่ `app-shell.tsx` ไม่แตะ `components/ui/sidebar.tsx`)

## [0.27.0] — 2026-10-05

### Added

- **`Button`: tooltip อัตโนมัติสำหรับปุ่มไอคอน** — มาตรฐานใหม่ของทุกโครงการ (เจ้าของสั่ง 2026-10-05): ไอคอนที่ไม่มีข้อความกำกับต้องบอกได้ว่าคืออะไรเมื่อวางเมาส์ ถ้า `Button` มี `aria-label` และ children ไม่มีข้อความ (ไอคอน/`sr-only` ไม่นับ) จะห่อ `Tooltip` ให้เองจาก `aria-label` — ทำที่ `Button` ชั้นในสุดที่เดียว **call site ทุกที่ของทุกแอปได้ทันทีโดยไม่ต้องแก้โค้ด** รวมถึงปุ่มที่ส่งเข้า `render=`/`trigger` ของ `FormDialog`/`SimpleDialog`/`DropdownMenu`/`RowActions` (เคสที่ห่อ `SimpleTooltip` เองไม่ได้เพราะ trigger ส่ง ref/props ให้)
  - props ใหม่: `tooltip` (ทับข้อความ, `false` = ปิด), `tooltipSide`, `tooltipDelay` — ไม่ต้องมี `TooltipProvider` ใน tree (ใส่ได้ถ้าอยากคุม delay ร่วมกัน)
  - `SimpleTooltip` ปิด tooltip อัตโนมัติของ `Button` ที่ห่ออยู่ให้แล้ว (ไม่ขึ้นสองชั้น) — แอปที่ห่อ tooltip ด้วยกลไกอื่นใช้ `ButtonTooltipSuppress` (export ใหม่) หรือ `tooltip={false}`
  - barrel export `Button` จาก `components/shared/button/button.tsx` (ครอบ `components/ui/button.tsx` ที่ยังเป็นไฟล์ shadcn ดิบ ไม่ถูกแก้มือ); `buttonVariants` เหมือนเดิม; props อื่นและหน้าตาไม่เปลี่ยน
- `DataTablePagination`: ปุ่มเลื่อนหน้าทั้ง 4 ใช้ `aria-label` จาก `UiText` (เดิมเป็นข้อความอังกฤษตายตัวใน `sr-only`); `ThemeToggle` ใช้ `aria-label` จาก `UiText.theme.label` แทน `title` (เลิก tooltip ซ้อนของเบราว์เซอร์)
- README หัวข้อ "ปุ่มไอคอน — tooltip มาให้เอง (มาตรฐานทุกโครงการ)" + แถวใหม่ใน `docs/agent-rules.md`
- ใช้ข้อความใน `<span className="sr-only">` (รูปแบบของ shadcn) เป็น tooltip ได้เมื่อไม่มี `aria-label`
- **ปุ่มไอคอนในแพ็กเกจเองได้ tooltip ครบ**: `RowActions`, `ActionMenu`, `SimpleDialog`/`SimpleSheet` (ปุ่มปิด), `SimplePagination`, `DataTablePagination`, `DataTableToolbar`, `CommandPalette`, `ThemeToggle`/`ThemeSwitch`, `Notice`, `UploadList`, `SecretReveal`, `TimePicker`, `MonthStepper`, `RuleBuilder`, `ResourcePropertyFilter`, `AuthParts` (17 ไฟล์เปลี่ยนมา import `Button` ตัวที่มี tooltip)
- `UiText.pagination` เพิ่ม `first` / `last` (หน้าแรก/หน้าสุดท้าย)
- showcase: หน้า `/components/button` เพิ่มแถวปุ่มไอคอน (auto / `tooltip="…"` / `tooltip={false}` / trigger ของ dialog / ห่อ `SimpleTooltip`)

## [0.26.1] — 2026-10-03

แก้ตามผล audit 2026-10-03 (`docs/reports/audit-2026-10-03.md`) — ไม่เปลี่ยน props

### Fixed

- **`RuleBuilder`**: แก้ค่าในเงื่อนไขแล้ว element ถูกสร้างใหม่ทุกครั้ง (key ผูกกับ object) → ช่องที่กำลังพิมพ์หลุดโฟกัสทุกตัวอักษร — object ใหม่ที่มาแทนใช้ key เดิม
- **`RowActions` / `ConfirmActionButton` / `ActionMenu` / `StepForm` / `ChatThread`**: server action ที่ `redirect()`/`notFound()` เคยขึ้น toast "NEXT_REDIRECT" — ถือว่าสำเร็จ (Next นำทางให้แล้ว); `ActionMenu`/`StepForm`/`ChatThread` ถือ `{ ok: false, error }` เป็นล้มเหลวด้วย (ตัวช่วยใหม่ใน `lib/action-result.ts`: `errorMessage`, `failedResult`, `isNavigationError` — `@suphark/ui/next` ยัง export สองตัวแรกจาก confirm-action-button เหมือนเดิม)
- **`RowActions` + `confirm`**: เคยปิด dialog ก่อนรัน action — ตอนนี้ปุ่มยืนยันหมุนระหว่างรอ ล้มเหลวคง dialog ไว้ให้ลองใหม่ สำเร็จค่อยปิด (ตามที่ 0.25.1 ตั้งใจ)
- **`useDialogs().confirm`** รองรับ `requireText` (เดิมข้ามการพิมพ์ยืนยันไปเงียบ ๆ)
- **`DataTable` / `useDataTable`**: เลือกแถวตาม `row.id` เป็นค่าเริ่มต้น (ไม่มี id = index เหมือนเดิม) — เดิมใช้ลำดับแถว ข้อมูลเปลี่ยน/แทรกแถวแล้วแถวที่เลือกกลายเป็นแถวอื่น (`DeleteManyButton` ลบผิดรายการ); การลากเรียงเทียบ id แบบ string
- **`useDataTable` `columnFilters` (regression 0.25.1)**: เทียบด้วยค่าแต่ตั้ง state เป็นค่าจริงจาก prop — เดิม `JSON.parse` ทำให้ `Date` กลายเป็น string; ค่าที่ stringify ไม่ได้ (BigInt/วงอ้างอิง) ไม่ throw ตอน render
- **`DataTable` ช่องค้นหา**: Enter ไม่ส่งซ้ำอีกรอบหลัง 250 ms; ปุ่มล้างตัวกรองล้างข้อความที่พิมพ์ค้างด้วย
- **`NumberInput` / `TagsInput` ใน `<label>` ที่ครอบ** (`LabeledField` ไม่ใส่ `htmlFor`): คลิกข้อความ label เคยกดปุ่ม "ลด"/ลบป้ายแรก — ช่องพิมพ์อยู่ก่อนปุ่มใน DOM แล้ววางตำแหน่งด้วย CSS `order`
- `NumberInput`: ทั้งช่องเคยจางเหมือนปิดใช้งานเมื่อค่าเท่ากับ `min`/`max` (`has-disabled` จับปุ่ม −/+ ที่ปิด) — จางเฉพาะเมื่อช่องปิดจริง; `step` ที่เปลี่ยนหลัง mount ไม่ทำให้ทศนิยมถูกปฏิเสธอีก; `size="sm"` 16px บนมือถือ (iOS ไม่ซูม)
- `TagsInput`: ค่าที่ถูกปฏิเสธค้างในช่อง = ช่อง invalid (ฟอร์มไม่ส่งรายการที่ขาดค่านั้นไปเงียบ ๆ)
- `TimePicker`: ปุ่ม "ตอนนี้" ปัดตาม `roundToStep`
- **`StepForm`**: ดับเบิลคลิก "ถัดไป" ไม่ข้ามขั้นกลาง; `onSubmit` ที่จบเร็ว/sync ไม่ถูกส่งซ้ำ; ตัวควบคุม Base UI ที่ไม่ผ่าน (Select/Checkbox/Switch) โฟกัสตัวมันเอง ไม่ใช่ช่องอื่น
- **`CommandPalette`**: เช็ก Ctrl/⌘ ก่อนอ่าน `e.key` (keydown จาก autofill ไม่มี key ไม่ throw); ไม่เปิดด้วย AltGr (ctrl+alt); แป้นละตินเทียบ `e.key` (Dvorak ฯลฯ) แป้นไทยใช้ `e.code`; 2 ตัวในหน้าเดียวเปิดทีละตัว
- `ChatThread`: ข้อความที่พิมพ์ระหว่างรอส่งไม่ถูกล้างทิ้ง
- `SettingsLayout`: มือถือกด "กลับ" ขณะหัวข้อที่เปิดถูกกรองด้วยคำค้น โฟกัสไปช่องค้นหาแทนหลุดไป body
- **service worker (PWA)**: reload หลังมีเวอร์ชันใหม่เคยเกิดทุก `focusout` (ย้ายช่อง/กดบันทึก = reload กลางฟอร์ม) — รอนิ่ง 2 วินาทีหลังออกจากช่อง ยกเลิกเมื่อมีการคลิก/พิมพ์/โฟกัสใหม่
- `PullToRefresh`: ฟัง scroll แบบ capture ที่ document (root ที่ mount ทีหลัง/หน้าเลื่อนทั้ง document ใช้ได้)
- `ProviderButtons`: ลิงก์ที่ปิดอยู่ดูปิดจริงและถอด `href` (กันคลิกกลาง); `aria-busy` ทั้งสองแบบ
- `useTableSearchParams`: ค่าที่รอส่งไม่ค้างเมื่อ URL ไม่เปลี่ยน; key `__proto__` จาก URL ไม่ทับ prototype
- `MonthStepper`: JSDoc กลับมาแสดงใน editor; `DesignSystemShowcase` กระโดดข้ามแท็บรอบใหม่ได้เวลารอเต็ม
- CSS: scrollbar ทั้งหน้า (`*{scrollbar-width}`) ย้ายเข้า `@layer base` — เดิมทับ `no-scrollbar`/className ของแอปทุกที่ (เช่น คอลัมน์ TimePicker)

### Security

- **`ActionMenu` href + confirm**: นำทางผ่าน `location.assign`/`window.open` ซึ่งไม่กัน `javascript:` แบบ `<a href>` — รับเฉพาะ http(s)/path ภายใน (`lib/safe-url.ts` `safeNavigableUrl` ใช้ร่วมกับ `ClientRedirect`); ลิงก์แท็บใหม่ที่ไม่มี onClick เปิดทันทีในคลิก (ไม่โดน popup blocker)
- `check:barrel` จับ `export *` ทุกรูปแบบ (alias `@suphark/ui/...`, แพ็กเกจ, quote เดี่ยว, comment ท้ายบรรทัด) และรันใน `verify` ของแพ็กเกจ + `prepublishOnly` (publish ไม่ผ่าน CI ก็ยังถูกตรวจ); README สอนขั้นตอนที่ถูก (`fix:barrel`)
- showcase: demo ไม่มีค่าที่หน้าตาเหมือนคีย์จริง (`pk_live_`) แล้ว; หน้า time-picker บอกรูปแบบค่า DateTimePicker ที่มี offset
- tests 12 กรณี (`fixes-0-26-1.test.tsx`, RuleBuilder, service worker)

- showcase (security): `next` ^16.3.5 → ^16.3.8 — 16.3.5 มี advisory **critical** GHSA-vcvr-r3jv-pc5j (RCE ใน `next/og` ImageResponse; showcase ไม่ได้ใช้ `next/og` จึงไม่ถูกโจมตีได้จริง แต่ `pnpm audit` แจ้ง) — `pnpm audit --prod` เหลือ 0; devDependency `next` ของแพ็กเกจ bump ตาม (peer ยัง `>=15`)
- showcase (security): `@suphark/auth-client` ^0.6.1 → **^0.6.2** (แก้ dot segment ต้นทาง) — ลบตัวกรอง `?next=` ชั่วคราวใน `/auth/[...pi]` ออก; ทดสอบ `/auth/logout` 7 กรณี (`/.//`, `/..//`, `/%2e%2e//`, `/./../..//`, tab, `//`, `/brand`) ด้วย server จริงบนเครื่องแล้ว — ปลายทางไม่ออกนอกโดเมน
- showcase: `@suphark/config-client` ^0.3.0 → ^0.9.2 (CLI `pi-config pull` ตอน build บน Vercel — ข้าม 0.9.0 ที่ pull ค่าหลายบรรทัด CRLF ไม่ได้; 0.9.x บังคับ `PI_CONFIG_URL` เป็น https, ไม่ตาม redirect, timeout 30s; 0.9.2 แก้ crash exit 127 บน Windows) — ทดสอบ pull ด้วย token จาก env (แบบ Vercel) ได้ 6 คีย์; diff/--check บน Windows exit 0/1 ถูกต้อง 10 รอบไม่ crash
- showcase (security): `safeNextPath` ปฏิเสธผลที่ normalize แล้วเป็น `//host` — dot segment `/.//evil.com`, `/..//evil.com`, `/%2e%2e//evil.com` เคยผ่าน (origin ตอน parse ยังเดิม) แล้ว redirect ไป evil.com; `/auth/[...pi]` กรอง `?next=` ด้วยตัวนี้ก่อนส่งให้ handler ของ `@suphark/auth-client` 0.6.1 ที่มีช่องเดียวกัน (แก้ต้นทางใน 0.6.2 — ลบตัวกรองได้หลัง bump) — production ก่อน deploy นี้: `curl /auth/logout?next=/.//evil.com` → 303 https://evil.com/ (รายงานโดย pi-auth และ pi-config)

## [0.26.0] — 2026-10-03

ปิดงานค้างจากผลรีวิว + prop ที่ DueBell ขอ — เพิ่มอย่างเดียว

### Added

- `NumberInput`: `inputRef` (ref ของช่องที่พิมพ์ — focus เองได้) และ `autoFocus` (คำขอจาก DueBell)
- `TimePicker`: `roundToStep` — ปัดนาทีที่พิมพ์ลงตาม `minuteStep` (เช่น step 60 + พิมพ์ 14:30 → 14:00); ค่าเริ่มต้นเก็บตามที่พิมพ์เหมือนเดิม (คำขอจาก DueBell)

### Changed

- **ช่องกรอกใช้ขนาดตัวอักษรตามบทบาท `text-body`** (16px มือถือ / 15px จอกว้าง) — `Input`, `Textarea`, `SelectTrigger`, `NativeSelect` (+ `NumberInput`, `TagsInput`): เดิม `text-base md:text-sm` = 14px บนจอกว้าง เล็กกว่าข้อความรอบข้าง 1px และ `text-body` ที่แอปใส่ให้ช่องได้ผลแค่มือถือ (pi-done ต้องเติม `md:text-body` เอง 19 จุด — ลบได้แล้ว); `SelectTrigger`/`NativeSelect` เดิม 14px แม้บนมือถือ (iOS ซูมเมื่อโฟกัส) — แก้ไฟล์ shadcn 4 ไฟล์เป็นข้อยกเว้น (เพิ่มในรายการคืนไฟล์หลัง `shadcn add --overwrite` ใน CLAUDE.md); `className` ของแอปยังแทนได้ (`cn` รู้จักคลาสตามบทบาท)
- ปุ่ม `ActionButton`/`LinkButton` ที่มี tooltip ไม่สร้าง `TooltipProvider` ต่อปุ่มแล้ว (ตาราง 50 แถว = 100+ provider) — ใช้ `delay={0}` ที่ trigger แทน หน้าตา/จังหวะเหมือนเดิม
- `DesignSystemShowcase`: แท็บอื่นนอกจาก "ภาพรวม" โหลดแบบ lazy เมื่อเปิดแท็บ (เดิม import ทุกแท็บ ~1 MB) — ลิงก์ข้ามแท็บไปหัวข้อรอแท็บโหลดเสร็จก่อนเลื่อน
- ลบ dependency `cn` ที่ไม่ได้ใช้ (แอปไม่ต้องติดตั้งเพิ่ม)
- docs: agent-rules — barrel ที่ client import ห้าม re-export schema ของ zod (ค่า) ให้ export แค่ type (DueBell −18% ต่อหน้า); `ChartConfig` ใช้เฉพาะค่าที่แอปกำหนดเอง (ค่าถูกเขียนลง `<style>` ตรง ๆ)
- CI: `permissions: contents: read` (+ `pull-requests: read` ให้ gitleaks) — GITHUB_TOKEN อ่านได้อย่างเดียว; pin action ด้วย commit SHA (checkout v4.4.0, gitleaks-action v2.3.9, pnpm/action-setup v4.3.0, setup-node v4.4.0)
- showcase: `/components/[slug]` โหลด demo แบบ `next/dynamic` ต่อ slug (`src/docs/demos.tsx` + `DemoView`) — เดิมทุกหน้าโหลด demo ทั้ง 129 ตัว (~409 kB gzip ต่อหน้า เช่น `/components/badge` พก recharts)
- showcase: demo `code-block`/`secret-reveal` ใช้ค่า `example_…` แทน `sk_live_…` (ไม่ให้ secret scanner แจ้งเตือนผิด)
- showcase: `@suphark/auth-client` ^0.1.7 → **^0.6.1** (แก้ open redirect ใน `safeNextPath` ของ handler `/auth/login|callback|logout` — ทดสอบ `/auth/logout?next=/%09/evil.com` แล้วไม่ออกนอกโดเมน); breaking ระหว่างทาง (ลบ Prisma adapter, เปลี่ยนชื่อ `ACCESS_DENIED`) ไม่กระทบ showcase

## [0.25.1] — 2026-10-02

แก้ตามผลรีวิว codebase (bug / security / performance) — ไม่เปลี่ยน props

### Fixed

- **`NumberInput`**: input ซ่อนของ Base UI (ที่ส่งค่าใน FormData) ได้ `step` ไปด้วย → browser ปฏิเสธค่าทศนิยม/ค่าที่ไม่ลง step นับจาก `min` แล้ว **บล็อก submit เงียบ ๆ** (เช่น 1500.5 เมื่อ step=1, 150 เมื่อ min=0 step=100 — DueBell เจอ) → input ซ่อนใช้ `step="any"` (ปุ่ม −/+ ยังเลื่อนตาม `step`; min/max ยังตรวจ)
- **`TimePicker`**: พิมพ์ผิดรูปแบบแล้วกดส่ง ฟอร์มเคยส่งค่าเดิมไปเงียบ ๆ → ช่องเป็น invalid จริง (`setCustomValidity`, ข้อความ `UiText.time.invalid`) ฟอร์มไม่ส่งจนแก้
- **`DateTimePicker`**: แยกไฟล์ (`form/date-time-picker.tsx`); ข้อความวัน/เวลาและค่าใน input ซ่อนคำนวณหลัง hydrate (เดิม server UTC กับ browser ต่างกัน 7 ชม. = hydration mismatch เมื่อมีค่าเริ่มต้น); **`name` ส่ง `"YYYY-MM-DDTHH:mm+07:00"` (มี offset)** แทนค่าที่ไม่มีโซนเวลา → `new Date(formData.get(name))` บน server ได้เวลาที่ถูก (เดิมคลาด 7 ชม.)
- `TimeColumns`: เลื่อนเฉพาะในคอลัมน์ (เดิม `scrollIntoView` เลื่อนทั้งหน้าทุกครั้งที่เลือก)
- **`MonthStepper` / `useMonthCursor`**: "เดือนนี้" คิดตามเวลาไทย (`Asia/Bangkok`) ให้ server กับ browser ตรงกัน — เดิมช่วง 00:00–06:59 ของวันที่ 1 ทุกเดือน server (UTC) เห็นเดือนก่อน = hydration mismatch; `currentMonthKey(now?, timeZone?)` รับโซนเวลาได้ (ไม่ส่ง = เครื่องเหมือนเดิม)
- **`StepForm`**: ดับเบิลคลิกปุ่มส่ง/ถัดไปเคยเรียก `onSubmit` 2 ครั้ง หรือข้ามหน้าตรวจทาน (คลิกที่สองตกที่ปุ่ม "ส่ง" ตำแหน่งเดิม) → กันซ้ำแบบ synchronous + ไม่นับคลิกภายใน 500 ms หลังเปลี่ยนขั้น; input ซ่อนของ Base UI ผิด → โฟกัสช่องที่มองเห็นของมันเอง (เดิมโฟกัสช่องแรกของขั้น)
- **`RowActions` / `ConfirmActionButton`**: action ที่คืน `FormState` `{ ok: false, error }` (ไม่ได้ throw) เคยถูกถือว่าสำเร็จ (ปิด dialog + refresh ไม่มีข้อความ) → toast error + คง dialog ไว้ (`failedResult`)
- **`ActionMenu`**: รายการที่มี `href` + `confirm` เคยไปเลยโดยไม่ถาม → ถามก่อนแล้วค่อยไป; `onClick` ที่ throw/reject แสดง toast และคง dialog ไว้ (เดิม unhandled rejection เงียบ)
- `ChatThread`: `onSend` ล้มเหลว = toast + คงข้อความในช่องไว้ให้ลองใหม่
- `CommandPalette`: คีย์ลัดเทียบ `e.code` — แป้นภาษาไทย Ctrl+K ใช้ได้แล้ว (เดิม `e.key` = "า")
- `SettingsLayout`: มือถือกด "กลับ" แล้วคืนโฟกัสไปหัวข้อเดิม (เดิมหลุดไป body); จอกว้างไม่ย้ายโฟกัสไปหัวข้อ (เดิมย้ายแค่ครั้งแรก)
- `TagsInput`: วางหลายค่าแทรกที่ cursor ของข้อความที่พิมพ์ค้าง (เดิมทิ้งข้อความนั้น)
- `ProviderButtons`: ปุ่มที่ `pendingId` ตรงแสดง spinner และกดซ้ำไม่ได้ (รวมแบบ `href`)
- `useTicker`: subscribe คงที่ข้าม render — เดิมสมัครใหม่ทุก render ทำให้ "x นาทีที่แล้ว" ไม่อัปเดตถ้า parent render บ่อยกว่า interval
- `useTableSearchParams`: setter หลายตัวติดกัน (เช่น setFilter แล้ว setSort) ต่อจากค่าที่เพิ่งตั้ง (เดิมตัวหลังทับตัวแรก)
- `useDataTable`: sync `columnFilters` ตามค่า (เดิมตามตัวอ้างอิง → array literal ทำให้ render ซ้ำ + ทับตัวกรองที่ผู้ใช้เพิ่งเลือก)

### Security

- `ClientRedirect`: รับเฉพาะ http(s)/path — ปฏิเสธ `javascript:`/`data:` (`location.replace` ไม่มีตัวกันแบบ `<a href>`/router)
- showcase: `/login` ใช้ `safeNextPath` (`src/lib/safe-next.ts`) กัน open redirect `next=/%09/evil.com` (WHATWG URL ตัด tab → `//evil.com`); production (`VERCEL_ENV=production`) ที่ไม่มี env ของ Pi Auth หรือตั้ง `PI_AUTH_DISABLED` = build ล้ม แทนเปิดเว็บสาธารณะเงียบ ๆ — ตัว `safeNextPath` ของ `@suphark/auth-client` แก้ใน repo auth แล้ว (0.6.1 รอ publish)

### Performance

- **`DataTable`**: ส่วนลากเรียง (dnd-kit ~16 kB gzip) แยกเป็น `data-table-sortable.tsx` โหลดแบบ lazy เฉพาะเมื่อส่ง `onReorder` — เดิมทุกตารางพกไปด้วย
- **`FormFieldInput`**: variant `autocomplete` (cmdk + Radix Dialog ที่ cmdk พ่วงมา) แยกเป็น `form-field-autocomplete.tsx` โหลดแบบ lazy — เดิมทุกฟอร์มที่ใช้ช่องข้อความธรรมดาพก cmdk
- `DataTable` ช่องค้นหา: ส่งให้ตารางเมื่อหยุดพิมพ์ 250 ms (Enter = ทันที) — เดิมกรอง/เรียง/render ทุกแถว (และ `router.replace` ถ้าผูก URL) ทุกตัวอักษร
- `TimePicker` ไม่พา react-day-picker มาด้วยแล้ว (แยก `DateTimePicker`); import locale ตรงไฟล์ (`date-fns/locale/th`, `date-fns/locale/en-US`, `react-day-picker/locale/th`) — dev server ไม่ต้อง compile locale ทั้ง ~700 ไฟล์
- `PullToRefresh`: ติดตั้ง `touchmove` แบบ non-passive เฉพาะตอนจอมือถือ + หน้าอยู่บนสุด (เดิมติดตลอด → browser ต้องรอ JS ก่อนเลื่อนทุกครั้ง)
- `TreeView`: `expandedIds` แบบ controlled ไม่ทำให้ memo ของแถวคำนวณใหม่ทุก render
- showcase: หน้า number-input อธิบาย step ตามพฤติกรรมใหม่
- tests 12 กรณี (`fixes-0-25-1.test.tsx`, `lazy-parts.test.tsx` + StepForm/NumberInput ใน `inputs-0-25.test.tsx`)

## [0.25.0] — 2026-10-02

input ใหม่ตามแผนจาก shadcnstudio.com — เพิ่มอย่างเดียว

### Added

- **`NumberInput`** — ช่องตัวเลขพร้อมปุ่ม −/+ (Base UI NumberField): `min`/`max`/`step`/`largeStep` (Shift+ลูกศร), `format` (Intl เช่น ทศนิยม 2 ตำแหน่ง/สกุลเงิน), `locale` (ค่าเริ่มต้น th-TH), `prefix`/`suffix` (฿, %, ชิ้น), `hideButtons`, `size` sm|default, `name` ส่งค่าดิบใน FormData — แทน `<Input type="number">` + InputGroup + state
- **`TimePicker`** — ช่องเวลา 24 ชม. ค่า `"HH:mm"`: พิมพ์ได้เลย (`"1430"`, `"9.15"`, `"14:30 น."` → แปลงตอน blur/Enter, ผิดรูปแบบ = `aria-invalid`) หรือกดไอคอนนาฬิกาเลือกจากคอลัมน์ชั่วโมง/นาที (`minuteStep`, ปุ่ม "ตอนนี้"); `name` ส่งใน FormData
- **`DateTimePicker`** — ปฏิทิน (ภาษาไทย) + คอลัมน์เวลาในกล่องเดียว ค่า `Date | null`, `defaultTime` เมื่อเลือกวันครั้งแรก, ปุ่มล้าง; `name` ส่ง `"YYYY-MM-DDTHH:mm"` (เวลาท้องถิ่น แบบ datetime-local)
- `TimeColumns` (คอลัมน์ listbox ใช้ลูกศร/Home/End), `parseTimeInput`, `toLocalDateTimeString`, `type TimeValue`
- **`TagsInput`** — พิมพ์หลายค่าเป็นป้าย: Enter/จุลภาค (+ เว้นวรรคถ้า `splitOnSpace`) เพิ่ม, วางหลายค่าพร้อมกัน, Backspace ลบตัวสุดท้าย, ไม่รับค่าซ้ำ (`allowDuplicates`), `max`, `transform`, `validate` คืนข้อความ error (ค่าที่ไม่ผ่านคงอยู่ในช่องให้แก้), ปลอดภัยกับ IME ไทย; `name` ส่งทุกค่า → `formData.getAll(name)` — redirect URI/โดเมน/อีเมล
- **`StepForm`** — ฟอร์มหลายขั้น (wizard) จาก array `steps` (`title`, `description`, `content`, `validate(formData)`): แถบขั้นตอน (ขั้นที่ผ่านแล้วกดย้อนได้, จอแคบแสดง "ขั้นที่ x จาก y"), ปุ่มย้อนกลับ/ถัดไป/ส่ง, "ถัดไป" ตรวจ required/pattern + `validate` ของขั้นนั้น, ส่ง = ตรวจทุกขั้นอีกครั้งแล้วพากลับไปขั้นที่ผิด, input ตัวแทนที่ซ่อนของ Base UI ผิด = แสดงข้อความใต้ฟอร์ม; ทุกขั้นอยู่ใน form เดียว → `onSubmit(formData)` ได้ค่าครบ (ส่ง server action ต่อได้), throw = แสดงข้อความ, ปุ่มหมุนระหว่างรอ, โฟกัสย้ายไปหัวข้อขั้นใหม่
- `UiText` key ใหม่: `number`, `time`, `tags`, `stepForm`
- showcase: หน้า `/components/{number-input,time-picker,tags-input,step-form}` (129 หน้า); tests 11 กรณี

### Performance

- **barrel ไม่ใช้ `export *` แล้ว** (`index.ts` 66 บรรทัด, `next.ts`, `data-table.ts`, `components/data-table/index.ts` → รายชื่อ export ชัด ๆ แยก `type`; รายชื่อ export เท่าเดิมทุกตัว ตรวจด้วย TypeScript แล้ว) — วัดบน showcase (Next 16.3 Turbopack): server component ที่ import จาก `@suphark/ui` แบบ `export *` ทำให้ client component แทบทั้งแพ็กเกจ (ปฏิทิน, date-fns, cmdk, input-otp, accordion, questionnaire …) ถูกส่งไปทุกหน้า — **root layout ที่ใช้แค่ `ThemeProvider`/`Toaster` ลดจาก 988 kB (gzip 311 kB) เหลือ 61 kB (gzip 18 kB)**, หน้า `/login` 991 → 114 kB; แอปไม่ต้องแก้โค้ด แค่ bump (`optimizePackageImports` / `turbopackRemoveUnused*` ไม่ช่วย — ลองแล้ว)
- `scripts/barrel-exports.mjs`: `pnpm check:barrel` (ใน verify + CI — เจอ `export *` ใน `packages/ui/src` = ล้ม) และ `pnpm fix:barrel` (แปลงให้หลัง `shadcn add`)
- หมายเหตุ: ตัวเลข date-fns 824 kB บน bundlephobia คือทั้งไลบรารี — ใน build จริงมีเฉพาะฟังก์ชันที่ใช้ + locale ไทย/อังกฤษ

## [0.24.0] — 2026-10-02

เติมของเดิมตามที่สำรวจ shadcnstudio.com (หยิบเฉพาะ "หน้าที่" ที่ยังไม่มี ทำเป็นตัวเดียว + props) — เพิ่มอย่างเดียว ค่าเริ่มต้นหน้าตาเดิม

### Added

- **`TextareaField`** — ช่องข้อความหลายบรรทัดพร้อม `label`/`hint`/`error` + **ตัวนับตัวอักษร** เมื่อมี `maxLength` (แดงเมื่อเต็ม, screen reader อ่าน "พิมพ์แล้ว x จาก y ตัวอักษร" ผ่าน `aria-describedby`) + `minRows`/`maxRows` (Textarea ขยายตามเนื้อหาอยู่แล้ว — `maxRows` จำกัดแล้วเลื่อนใน); controlled/uncontrolled; `textareaClassName`
- **`UserAvatars`** — รูปผู้ใช้ซ้อนกัน + "+N" จาก array (`users`, `max`, `size` sm|default|lg, `label` นำหน้ารายชื่อให้ screen reader) ชี้ที่ "+N" เห็นชื่อที่เหลือ; ใช้จาก server component ได้ — แทน AvatarGroup + Avatar×N + AvatarGroupCount
- **จุดสถานะ** `status?: "online" | "away" | "busy" | "offline"` ที่ `Initials`, `UserIdentity` และรายการของ `UserAvatars` (`PresenceDot` + `type Presence` export ด้วย) ใช้ token success/warning/destructive/muted
- **`TableSkeleton`** (`rows`, `columns`, `header`), **`ListSkeleton`** (`rows`, `avatar`, `lines`), **`CardSkeleton`** (`count`, `variant` stat|content) — โครงระหว่างโหลดสำเร็จรูปสำหรับ `loading.tsx` มี `role="status"` + "กำลังโหลด…" ความกว้างสลับแบบคงที่ (ไม่ random → ไม่ hydration mismatch)
- **`Notice`**: `icon` (true = ไอคอนตามโทน หรือส่งเอง) และ `dismissible` + `onDismiss` (ปุ่ม X อ่าน `UiText.close`) — ไม่ส่ง = หน้าตาเดิม; ไฟล์เป็น `"use client"` แล้ว (ใช้จาก server component ได้เหมือนเดิม)
- **`AuthLayout`**: `size?: "sm" | "md" | "lg"` ความกว้างการ์ด (ค่าเริ่มต้น sm = เดิม) — หน้า consent/เลือกองค์กรของ Pi Auth ใช้ md (ขอจาก Pi Auth)
- `UiText` key ใหม่: `loading`, `presence`, `characterCount`
- showcase: หน้า `/components/{textarea-field,user-avatars,loading-skeletons}` (125 หน้า), demo `notice` มี icon + dismissible; tests 10 กรณี

## [0.23.0] — 2026-10-02

### Added

- `ProviderButtons`: prop `badgePlacement` — ค่าเริ่มต้น `"corner"` = badge (เช่น "ใช้ล่าสุด") เป็นป้ายเล็กทับขอบบนขวาของปุ่มแบบ Clerk "Last used" ไม่กินที่ข้อความ; `"inline"` = ท้ายข้อความแบบ 0.21.0; ปุ่มเต็มกว้าง `py-2` กันป้ายชนบรรทัดแรก — ขอจากเจ้าของผ่าน Pi Auth (0.22.0 ที่ publish ไปไม่มีส่วนนี้)

## [0.22.0] — 2026-10-02

### Added

- `ProviderButtons`: prop `text` ต่อ provider (ข้อความเต็มของปุ่มแทน "ดำเนินการต่อด้วย {label}" เช่น ชื่อ SSO ยาว "Estar (Microsoft 365)"); ปุ่มเต็มกว้าง (1 ตัว / `layout="list"`) **ขึ้นบรรทัดใหม่แทนตัดเป็น …** ; ตาราง 2 คอลัมน์ยังตัด แต่ `aria-label`/`title` เป็นข้อความเต็ม — ขอจาก Pi Auth
- showcase: demo `/components/auth-layout` ปุ่ม SSO ใช้ `text` ยาว

## [0.21.0] — 2026-10-02

ตัวสำเร็จรูปของ primitive ใหม่จาก shadcn (0.20.0) — เพิ่มอย่างเดียว

### Added

- **`ChatThread`** — หน้าแชตจาก array ข้อความ (แทน MessageScrollerProvider/MessageScroller/Viewport/Content/Item/Button + Message/MessageAvatar/MessageContent/MessageHeader/MessageFooter + Bubble/BubbleContent + Marker + InputGroup รวม 15+ ชิ้นตามตัวอย่างทางการของ shadcn): `messages: { id, from: "me" | "other", content, author?, avatar?, meta? }[]`, เลื่อนตามข้อความใหม่ (ข้อความของเรายึดเป็นจุดเลื่อน), ปุ่ม "ไปข้อความล่าสุด", `typing` (แถว "กำลังพิมพ์…" ด้วย Marker), `onSend` = มีช่องพิมพ์ (Enter ส่ง · Shift+Enter ขึ้นบรรทัด · **ไม่ส่งระหว่างประกอบคำด้วย IME** แบบที่ PDF ทำ `submitOnEnter`), คืน Promise = ปุ่มหมุนแล้วล้างช่องเมื่อสำเร็จ, `empty`, `disabled`
- **`SimpleQuestionnaire`** — แบบสอบถามทีละข้อจาก array คำถาม (แทน Questionnaire 15 ชิ้น): `{ name, title, description?, required?, multiple?, choices?: { value, label, description?, disabled? }[], input?: boolean | placeholder }`, คีย์ลัดตัวเลข/ตัวอักษร, ข้อบังคับไม่มีปุ่มข้าม, `onSubmit(values)` ได้ object (ข้อเดียว = string, หลายข้อ = string[], ข้อที่ข้ามไม่มี key) ไม่ต้องอ่าน FormData เอง
- **`AuthLayout`** — หน้าเข้าสู่ระบบ/สมัคร/ยืนยันตัวตนสำเร็จรูปแบบ Clerk (server component ได้): `logo`, `title` (h1), `description`, เนื้อ, `cardFooter` (แถบล่างการ์ดพื้นต่างสี เช่น "ยังไม่มีบัญชี? สมัคร"), `footer` (ใต้การ์ด เช่น "ยืนยันตัวตนโดย Pi Auth · ข้อกำหนด"), `actions` (มุมขวาบน ธีม/ภาษา), `variant` centered (พื้นลายจุดจาง) | split (ฝั่งซ้าย `aside` สีแบรนด์ แบบ shadcn login blocks — มือถือซ่อน), `brandColor`/`brandForeground` (สีแบรนด์ของ tenant), `fullScreen`
- **`ProviderButtons`** (Google/Microsoft/SSO: 1 ตัว = "ดำเนินการต่อด้วย …" เต็มกว้าง, 2+ ตัว = ตาราง 2 คอลัมน์, `badge` เช่น "ใช้ล่าสุด", `href` หรือ `onClick`, `pendingId` กันกดซ้ำ), **`AuthDivider`** ("หรือ"), **`PasswordInput`** (ปุ่มแสดง/ซ่อน + `aria-pressed`, `autoComplete` ค่าเริ่มต้น `current-password` ตามแนวทาง web.dev)
- showcase: หน้า `/login` เปลี่ยนเป็น `AuthLayout` (โลโก้, ปุ่ม "ดำเนินการต่อด้วย Pi Auth", แถบล่าง, "ยืนยันตัวตนโดย Pi Auth", ปุ่มธีม) + หน้า `/components/auth-layout` (ฟอร์มเต็มทั้งสองแบบ)
- `UiText` key ใหม่: `questionnaire` (ปุ่ม/ความคืบหน้า "ข้อ {current} จาก {total}"), `chat`, `auth`
- showcase: หน้า `/components/{chat-thread,simple-questionnaire,marker}` (122 หน้ารวม auth-layout); tests 7 กรณี (รวม 192)

## [0.20.1] — 2026-10-01

### Fixed

- **`confirm.requireText` ถูกทิ้งเงียบ ๆ** (รายงานจาก Pi Config): `RowActions`, `ConfirmActionButton` และ `ActionMenu` ส่งให้ `ConfirmDialog` แค่ title/description/label/destructive — ใส่ `confirm: { requireText: slug }` แล้วลบได้ด้วยคลิกเดียวทั้งที่ `ConfirmSpec` ประกาศว่ารองรับ → ส่ง `requireText` + `requireTextLabel` ต่อครบทั้งสามที่; tests 2 กรณี (รวม 185)

## [0.20.0] — 2026-10-01

ขั้น "layout" ของแผนรวม UI ทุกแอป (ดู `todo/todo.md`) — เพิ่มอย่างเดียว ไม่มี prop เดิมเปลี่ยนความหมาย

### Added

- **`MobileTabBar`** (`/next`) + **`AppShell mobileTabs`** — แถบเมนูล่างของมือถือ 3–5 แท็บ (ยกจาก DueBell `MobileNav`): ซ่อนตั้งแต่ `md`, แท็บสูง ≥ 56px, `badge` เป็น `CountBadge` บนไอคอน (รวมใน aria-label), `onClick` แทนการไปหน้า, ไฮไลต์ตาม path (`/` ตรงตัว, อื่น ๆ prefix หรือ `exact`); `icon` เป็น **element** (`<Home />`) จึงส่งจาก server layout ได้เหมือน `AppNav`; `AppShell` ทั้ง layout sidebar/top เว้นที่ใต้เนื้อหาให้เอง
- utility **`pb-safe`** (safe-area ล่างของ iPhone) และ **`pb-tab-bar`** (เว้นที่ให้พ้นแถบล่าง) ใน `styles.css`
- **`SettingsLayout`** — หน้าตั้งค่าหลายหัวข้อ (ยกจาก DueBell master-detail + PDF ค้นหาได้): จอกว้างสารบัญซ้าย sticky + เนื้อหา, มือถือรายการหัวข้อ → หน้าหัวข้อ + ปุ่ม "กลับ" (ย้ายโฟกัสไปหัวข้อให้ screen reader), `searchable` ค้น label/description/`keywords` (ไทย+อังกฤษ), `badge` ท้ายรายการ, คุมเองด้วย `value`/`onValueChange` หรือ `initialSection`
- **`FilterBar`** — แถบค้นหา + select ตัวกรองเหนือรายการ client-side (Pi Auth เขียนซ้ำ 14 หน้า): ปุ่ม "ล้างตัวกรอง" โผล่เมื่อมีค่าค้าง (เทียบกับ `allValue` ของแต่ละตัว) และตั้งกลับให้เองถ้าไม่ส่ง `onClear`; ตัวกรองแบบอื่นใส่เป็น `children` + `active`
- **`SetupChecklist`** — รายการ "ต้องตั้งอะไรให้ครบ" (ยกจาก Pi Auth `SetupSteps`): ✓ เมื่อทำแล้ว, ขั้นบังคับถัดไปถูกเน้น (`aria-current="step"`), ขั้น `optional` ไม่นับ, ครบแล้วซ่อนทั้งกล่อง (`hideWhenComplete`); `action` รับ `{ current, done }` ให้แอปส่ง `LinkButton` เอง (barrel ไม่พึ่ง next)
- **`MonthStepper`** + **`useMonthCursor`** — เลือกเดือน ‹ เดือน › กดชื่อเดือนกลับเดือนนี้, `min`/`max`, `locale` (`th-TH` = พ.ศ., `th-TH-u-ca-gregory` = ค.ศ.), `format` long|short, `formatLabel` (ยกจาก DueBell `MonthSelector`)
- **`lib/month.ts`** (barrel): `MonthKey` (`"YYYY-MM"` แบบเดียวกับ `CalendarMonthGrid`), `parseMonthKey`, `isMonthKey`, `toMonthKey`, `currentMonthKey`, `shiftMonth` (ข้ามปีให้), `compareMonth`, `formatMonthKey` — แทน `CycleMonth` ของ DueBell
- `UiText` key ใหม่ (optional ทั้งหมด มีค่าไทย/อังกฤษใน `UI_TEXT_TH`/`UI_TEXT_EN`): `month`, `setup`, `filters`, `settings`, `mobileTabs`
- **ชุด component สำเร็จรูป (Simple\*)** — ทิศทางของแพ็กเกจ: แอปเขียน component เดียว + props แทนการประกอบ primitive หลายชิ้นซ้อนกันแบบ shadcn (ดู `docs/agent-rules.md` "ใช้ตัวสำเร็จรูปก่อน"):
  - `SimpleDialog` (แทน Dialog 7 ชิ้น) / `SimpleSheet` (+ `side`) — trigger, title, description, children, `footer` (ReactNode หรือ `(close) => …`), `size`, controlled ได้; **ปุ่ม X อ่าน `UiText.close`** แก้ปัญหา "Close" แปลภาษาไม่ได้โดยไม่แตะไฟล์ shadcn
  - `SimpleTabs` (items: value/label/content/icon/badge/disabled, `variant` default|line, `fullWidth`) / `SimpleAccordion` (`multiple`, `initialOpen`)
  - `SimpleTooltip` (ห่อ element เดียว, content ว่าง = ไม่มี tooltip) / `SimplePopover` (trigger + title/description + เนื้อหา)
  - `ActionMenu` — เมนูคำสั่งจาก array: icon, shortcut, separator, label, href/external, destructive, **`confirm` เปิด `ConfirmDialog` ก่อนเรียก onClick**; trigger ไม่ส่ง = ปุ่ม …
  - `SimplePagination` + `paginationRange` — page/pageCount/onPageChange, จำนวนปุ่มคงที่, มือถือเหลือ "x / y"
  - `SimpleTable<T>` — columns (key/header/cell/align/className) + rows + getRowKey + empty + onRowClick; ค่าจาก key ตรง ๆ ถ้าไม่ส่ง cell
  - `SegmentedControl<T>` — เลือกทีละหนึ่งและต้องมีค่าเสมอ (กดตัวเดิมไม่หลุด), `count`, `icon`, `size`, `fullWidth`
  - `UiText` key ใหม่: `close`, `pagination`
- **shadcn/ui base-nova ล่าสุดทั้งชุด** (`shadcn add --all --overwrite`, CLI 4.21.0): primitive ใหม่ `bubble`, `marker`, `message`, `message-scroller`, `questionnaire`, `direction` (export ใน barrel) และ `toast` (Base UI — **ไม่อยู่ใน barrel** เพราะชื่อ `toast`/`Toaster` ชนกับ sonner ที่แพ็กเกจใช้; import จาก `@suphark/ui/components/ui/toast`); dep ใหม่ `@shadcn/react`
  - ไฟล์เดิมได้ class/ลำดับจาก upstream (ส่วนใหญ่เรียง class ใหม่) + sidebar deps ของ useEffect/useMemo ครบขึ้น
  - **คงของที่แก้ไว้เอง** (ติดมาจาก supplychain ตั้งแต่ 0.1.0 — upstream ยังไม่มี): `scroll-area.tsx` (`data-[orientation=…]` ของ Base UI — ไม่งั้นแถบเลื่อนกว้าง 0 มองไม่เห็นทั้งแอป), `slider.tsx`, `tabs.tsx` (orientation แบบเดียวกัน), `table.tsx` (prop `containerClassName`)
  - CLI รุ่นนี้เขียน `import { cn } from "cn"` — เปลี่ยนกลับเป็น `@suphark/ui/lib/utils` ทุกไฟล์ เพราะ `cn` ของแพ็กเกจรู้จักคลาสตามบทบาท (`text-body` ฯลฯ, 0.13.1) ส่วน `cn` ทั่วไปจะลบทิ้งเงียบ ๆ
  - `hooks/use-mobile.ts` (CLI เขียนทับ) เติม `"use client"` คืน; biome ปิด `noDoubleEquals` เฉพาะ `components/ui/**` (`field.tsx` ของ upstream ใช้ `==`)
- showcase: หน้า `/components/{month-stepper,filter-bar,setup-checklist,settings-layout,mobile-tab-bar,simple-dialog,simple-sheet,simple-tabs,simple-accordion,simple-tooltip,simple-popover,action-menu,simple-pagination,simple-table,segmented-control}` (118 หน้า) + `/shell` มี `mobileTabs` ให้ลองบนจอมือถือ; tests 20 กรณีเพิ่ม (รวม 183)

## [0.19.0] — 2026-09-30

ปิดรายการ "component เล็กที่ใช้ร่วม" ของแผนรวม UI ทุกแอป (ดู `todo/todo.md`) — เพิ่มอย่างเดียว ไม่มี prop เดิมเปลี่ยนความหมาย

### Added

- **`Stat` เพิ่ม `icon` / `badge` / `delta` / `tone`** + **`StatGrid`** (Pi Auth มี 17 การ์ดแบบนี้, DueBell มี DeltaBadge เอง): `delta` = `{ value, direction: "up"|"down"|"flat", tone?, hint? }` เลือกไอคอนเทรนด์และสีให้ (ขึ้น = success, ลง = destructive — ทับด้วย `tone` ได้เพราะบางตัวชี้วัด "ลง" คือดี), `icon` มีกรอบพื้นตามโทน, `tone` เปลี่ยนสีตัวเลข (`default|success|warning|destructive|info`); `StatGrid` คอลัมน์ 2|3|4 (มือถือ 1 → sm 2)
- **`SettingsRow`** / **`SwitchRow`** / **`DangerZone`** (barrel) — แถวตั้งค่า: ชื่อ+คำอธิบายซ้าย control ขวา (จอแคบตกลงมา), `htmlFor` ผูกชื่อกับ control, `tone="destructive"`; `SwitchRow` = แถว + `Switch` ที่ผูก id ให้แล้ว (คลิกชื่อแล้วสลับ) รับ props ของ `Switch` ทั้งหมด; `DangerZone` = กรอบ `border-destructive/40` + พื้น subtle + เส้นคั่นแถว (Pi Auth/Pi PDF เขียน layout นี้ซ้ำ)
- **`ConfirmDialog` / `useConfirm` `requireText`** — ต้องพิมพ์ข้อความให้ตรงก่อนปุ่มยืนยันจะกดได้ (ลบของที่กู้ไม่ได้ แบบ GitHub); `requireTextLabel` ทับข้อความเหนือช่อง, ค่าเริ่มต้นจาก `UiText.confirmTypeToConfirm`/`…Suffix` (key ใหม่); ปิดกล่องแล้วล้างสิ่งที่พิมพ์เสมอ (ยืนยันรายการถัดไปทันทีไม่ได้) — ใช้ผ่าน `confirm({ requireText: app.name, destructive: true })` ได้เลย
- **`UserIdentity`** (barrel) — avatar (`Initials` สีพื้นคงที่ต่อชื่อ) + ชื่อ + อีเมล + `badge`/`hint`, `size` sm|default, `hideAvatar`; **ไม่มีชื่อ = ใช้อีเมลเป็นบรรทัดหลัก** (ผู้ใช้ที่ยังไม่ตั้งชื่อ) — Pi Auth เขียนซ้ำ ~15 จุด
- **`CountBadge`** (barrel) — ป้ายจำนวนท้ายเมนู/แท็บ: เกิน `max` เป็น `99+`, `0` ซ่อนอัตโนมัติ (`showZero` บังคับแสดง), `tone` muted|primary|destructive
- **`SaveStatus`** (barrel, ยกจาก Pi PDF) — สถานะบันทึกอัตโนมัติบรรทัดเดียว: `saving` (spinner) / `saved` (✓ เขียว) / `error` (`role="alert"`, ข้อความของแอปหรือ `UiText.actionFailed`) / `idle` + `savedAt` = เวลาสัมพัทธ์ผ่าน `ClientDateFormatter` (อัปเดตเองหลัง mount ไม่ทำ hydration mismatch); `language`/`text`
- **`SliderField`** (barrel, ยกจาก Pi PDF) — ช่องเลื่อน + ป้ายชื่อ + ค่าปัจจุบันมุมขวา: `value`/`onValueChange` เป็น number เดี่ยว, `unit` หรือ `formatValue`, `description`, `size` sm|default, `disabled`
- **`SkipLink`** (barrel) — ลิงก์ "ข้ามไปเนื้อหา" สำหรับหน้าที่ไม่ได้ใช้ `AppShell` (Pi PDF มีของตัวเอง); `AppShell` เปลี่ยนมาใช้ตัวเดียวกันนี้ภายใน
- **`FormDialog` `revealSuccess`** — แบบ **ไม่ต้องส่งฟังก์ชัน** จึงใช้จาก **server component** ได้ (รายงานจาก Pi Auth: `renderSuccess` เป็นฟังก์ชัน ข้าม server/client boundary ไม่ได้ → `Functions cannot be passed directly to Client Components`): server action คืน `{ ok: true, data: { values: { "Signing secret": "whsec_…" } } }` แล้ว dialog แสดง `SecretReveal` ให้เอง + ปุ่ม "เสร็จแล้ว" (ไม่ปิดเอง); `successTitle` (ค่าเริ่มต้น `UiText.showOnce`), `successDescription` แทน description ของฟอร์ม — เคส "สร้างแล้วโชว์ secret ครั้งเดียว" (webhook secret / SCIM token / service account key / client secret) ซ้ำกันทุกแอป; `renderSuccess` เดิมยังใช้ได้จาก client component
- showcase: หน้า `/components/settings-row`, `/components/user-identity` + หน้า `stat` ใหม่ (ไอคอน/delta/StatGrid) — 104 หน้า; tests 9 กรณีเพิ่ม (รวม 163)

## [0.18.0] — 2026-09-30

> 0.17.0 ถูก publish ตอนที่ `LanguageSwitch` ยังไม่เข้า (commit ถัดไป) — ของชิ้นนี้จึงออกเป็น 0.18.0

### Added

- **`LanguageSwitch`** + **`LanguageMenuItems`** (barrel) — สลับภาษาที่ Pi PDF (`language-selector.tsx`) / Pi Config (`locale-toggle.tsx` + `locale-menu-items.tsx`) / Pi Auth เขียนซ้ำ; แพ็กเกจไม่รู้จัก i18n ของแอป → แอปส่ง `locales[{ value, label, hint?, flag? }]` + `value` + `onValueChange` เอง (เขียน cookie/เรียก server action/`router.refresh()` ฝั่งแอป):
  - `LanguageSwitch` (นอกเมนู เช่น header/หน้าก่อนล็อกอิน — คู่กับ `ThemeToggle`): `mode` `auto` (ค่าเริ่มต้น: ≤2 ภาษา = ปุ่มเดียววนรอบแสดงชื่อภาษาถัดไป, >2 = เมนูพร้อมธง/บรรทัดรอง) / `toggle` / `menu`, `showLabel` (menu = รหัสภาษาตัวใหญ่, false = ปุ่มไอคอน), `label` (ค่าเริ่มต้น **`UiText.language.label`** — key ใหม่), `align`, props ของ `Button` ส่งผ่านหมด; `locales` ว่าง = ไม่ render
  - `LanguageMenuItems` (ในเมนูผู้ใช้ — คู่กับ `ThemeMenuItems`): `DropdownMenuRadioGroup` + หัวกลุ่มจาก `UiText.language`, `disabled` ปิดระหว่าง pending
- `useCopyToClipboard`: `copyToClipboard(text, key?, labels?)` — ทับข้อความ toast เฉพาะครั้งนั้นได้ (ข้อสังเกตจาก Pi Config: `RevealedValues` มีข้อความต่างกันทุกปุ่ม "คัดลอกคีย์ X / ค่าของ X / ทั้งชุด N ค่า" แต่เดิม hook รับข้อความเดียวตอนสร้าง จึงต้องปิด toast แล้วเรียก `toast.success()` เอง)
- `SimpleSelect`: **`emptyValue`** — บอกว่า option ไหนหมายถึง "ไม่เลือก/ไม่มี" แล้วคอมโพเนนต์ส่ง **ค่าว่าง** ใน FormData แทน sentinel (Base UI ไม่รับ `value=""`) — เดิม `name` ใช้ได้เฉพาะเคสที่ค่าที่เลือก = ค่าที่ส่ง 1:1 แอปที่มี "ไม่มีกลุ่ม" ต้องทำ hidden input แปลงค่าเอง (รายงานจาก Pi Config `SectionSelect`: `__none__` หลุดเข้า server action); ใช้คู่ `required` ไม่ได้ (hidden input ไม่เข้า constraint validation) ให้ตรวจที่ schema
- `SearchInput`: ส่ง `aria-label` ตรง ๆ ได้แล้ว (เดิมคอมโพเนนต์เขียนทับเงียบ ๆ หลัง `{...props}` ต้องใช้ `label` เท่านั้น — รายงานจาก Pi PDF)
- showcase: หน้า `/components/language-switch` — 102 หน้า; tests 8 กรณีเพิ่ม (รวม 154)

## [0.17.0] — 2026-09-30

### Added

- **`CopyButton`** (barrel) — ปุ่มคัดลอกข้อความ: ไอคอน Copy → ✓ (`text-success`) ชั่วครู่แล้วกลับ, ใช้ `useCopyToClipboard` (มี fallback `execCommand` สำหรับ webview ที่บล็อก clipboard API) แอปไม่ต้องเขียน state เอง (Pi Auth เขียนซ้ำ 12 ไฟล์, Pi Config ใน `RevealedValues`): `value`, `children` (ไม่ส่ง = ปุ่มไอคอนล้วน), `label`/`copiedLabel` (ค่าเริ่มต้น `UiText.copy`/`copied` — เป็น aria-label เมื่อไม่มี children และเป็น `title` เสมอ), `toast` (ค่าเริ่มต้น **false** เพราะปุ่มแสดง ✓ อยู่แล้ว — ส่ง `true` หรือข้อความของแอปได้), `timeout`, `onCopied`, props อื่นของ `Button` (variant/size/className) ส่งผ่านหมด
- **`CodeBlock`** (barrel, สเปกจาก Pi Config — ของเดิมอยู่ `features/docs/code-block.tsx` ใช้ 2 ไฟล์; Pi Auth มีแบบเดียวกัน ~9 จุด) — บล็อกโค้ด/คำสั่ง: หัวแถบ `title ?? lang ?? "shell"` (mono, `title={false}` = ไม่มีหัวแถบ) + `CopyButton`, เนื้อเป็น `<pre><code>` mono เลื่อนแนวนอน; `copyText` เมื่อคัดลอกไม่เท่ากับที่แสดง (เช่นคัดลอกเฉพาะค่า token ไม่เอา `KEY=`), `copyLabel`, `showCopy`, `wrap` (ตัดบรรทัดแทนเลื่อน), `maxHeightClassName`; ไม่มี syntax highlight โดยตั้งใจ (ไม่เพิ่ม dependency)
- `SearchInput`: ใช้แบบ **uncontrolled** ได้แล้ว — ไม่ส่ง `value` = คุมค่าในตัวเองจาก `defaultValue` (ปุ่มล้าง/Escape ยังทำงาน) จึงวางใน `<form>` ที่ submit ไป server action/URL param พร้อม `name` ได้ (คำถามจาก Pi Auth: `/console/logs`, `/platform/users`); `onValueChange` ยังเรียกทุกตัวอักษรทั้งสองโหมด — **ไม่มี debounce ในตัว** (ให้แอป debounce เอง) จดไว้ใน docstring แล้ว
- showcase: หน้า `/components/copy-button`, `/components/code-block` — 101 หน้า; tests 5 กรณีเพิ่ม (รวม 146)
- test: `date-picker.test.tsx` ตั้ง timeout 20s (เปิด popup = render ปฏิทินทั้งเดือนใน jsdom ช้าเป็นครั้งคราวเกิน 5s ตอนรันทั้งชุด — ทำให้ `pnpm verify`/CI แดงสุ่ม ๆ)

## [0.16.0] — 2026-09-30

### Added

- **`SearchInput`** (barrel) — ช่องค้นหามาตรฐานที่ Pi Auth (~15 จุด) / Pi PDF (5) / DueBell (8) เขียนซ้ำ: ไอคอนแว่นขยายซ้าย, ปุ่มล้าง (X) ขวาเมื่อมีข้อความ (กดแล้ว focus กลับที่ช่อง), **Escape ล้างค่า** (`clearOnEscape`), `type="search"` แต่ซ่อนปุ่ม X ของ WebKit; controlled ล้วน `value` + `onValueChange(next)` (แอปคุม state/debounce เอง), `onClear`, `size` xs|sm|default (h-7/h-8/h-9), `label`/`clearLabel`/`placeholder` (ค่าเริ่มต้นจาก **`UiText.search`** `{ placeholder, label, clear }` — key ใหม่), `groupClassName` (กรอบ) แยกจาก `className` (ตัว `<input>`), ส่ง `ref` ถึง input ได้; props อื่นของ `<input>` ส่งผ่านหมด
- showcase: หน้า `/components/search-input`; **เมนูซ้ายของ `/components` มีช่องค้นหาแล้ว** — กรองตามชื่อ/slug/ชื่อ export/คำอธิบาย, บอกจำนวนที่พบ (`aria-live`), กด `/` ที่ไหนก็ได้เพื่อโฟกัสช่องค้นหา (ไม่ดักเมื่อกำลังพิมพ์ในช่องอื่น)

## [0.15.0] — 2026-09-30

### Added

- **`InfoHint`** (ขอจาก Pi Auth): ไอคอน (i) ท้ายหัวข้อ ที่เก็บคำอธิบายยาว ๆ ไว้ใน tooltip แทนการวาง
  เป็น `description` ใต้หัวข้อถาวร — ใช้กับคำอธิบายที่คนซึ่งรู้อยู่แล้วไม่ต้องอ่านซ้ำทุกครั้ง
  props: `children` (เนื้อหา), `label` (ชื่อที่ screen reader อ่าน — บังคับ), `side`, `className`
  trigger เป็น **ปุ่มจริง** ไม่ใช่ `<span>` จึงเปิดได้ด้วยคีย์บอร์ด (Tab) และจอสัมผัส ไม่ใช่ hover อย่างเดียว
- showcase: หน้า component `/components/info-hint`

## [0.14.0] — 2026-09-29

> **0.13.0 และ 0.13.1 ถูก publish ขึ้น npm เมื่อ 2026-09-25 จากโค้ดที่ไม่เคยเข้า git** (สเกลตัวอักษรตามบทบาท ขอจาก Pi Done) — รุ่นนี้กู้โค้ดจาก tarball 0.13.1 กลับเข้า `main` แล้ว (3-way merge กับ 0.12.0) บันทึกของสองรุ่นนั้นอยู่ข้างล่างตามที่ publish จริง

รุ่นแรกของแผนรวม UI จากทุกแอป (สำรวจ Pi Auth / DueBell / Pi PDF / Pi Config — ดู `todo/todo.md`) — เพิ่มอย่างเดียว ไม่มี prop ถูกเปลี่ยนความหมาย

### Added

- **token สีโทนใน `styles.css`**: `--info` / `--info-foreground` (`bg-info`, `text-info`) และพื้นอ่อนครบ 4 โทน `--{info|success|warning|destructive}-subtle` / `-subtle-foreground` / `-border` (`bg-info-subtle text-info-subtle-foreground border-info-border` …) สลับ dark ให้เอง — แทน `sky-*` ที่ PDF ใช้ ~20 จุด และ `--info` ที่ DueBell ตั้งเอง (ถ้าแอปตั้ง `--info` ไว้เองให้ลบออก ค่าของแพ็กเกจ = sky-600 / dark sky-400)
- `EmptyState`: `variant` (`dashed` ค่าเริ่มต้น · `card` · `plain`), `size="compact"`, `tone="destructive"`, `secondaryAction` (ขอจาก PDF ที่มีสำเนาของตัวเอง)
- `CheckboxField`: `hint` — คำอธิบายใต้ label (Config เขียน `<p>` ต่อท้ายเอง ~8 จุด)
- `SimpleSelect`: `name` + `required` — ส่งค่าใน FormData ของ server action ได้ (Config เคยใช้ hidden input เอง)
- `FormDialog`: `renderSuccess(state)` — สำเร็จแล้วแสดงผลแทนฟอร์ม (secret/token ที่ออกครั้งเดียว) พร้อมปุ่ม "เสร็จแล้ว"; Pi Auth `SecretDialog` ใช้แทนได้
- `ConfirmActionButton`: `redirectTo` — สำเร็จแล้ว `router.push` แทน refresh (Pi Auth `uninstall-button.tsx` ใช้แทนได้)
- `useCopyToClipboard({ toast, timeout })`: คืน `copiedKey` (`copyToClipboard(text, key)` — หลายปุ่มในหน้าเดียวรู้ว่าปุ่มไหนเพิ่งคัดลอก), `toast: false` หรือข้อความของแอป (แปลภาษาได้), ใช้ `copyText` ที่มี fallback; `copyToClipboard` คืน `Promise<boolean>` — ของเดิม (`isCopied`, `copyToClipboard(text)`) ใช้ได้เหมือนเดิม (Pi Auth เขียน copy เอง 12 ไฟล์)
- `formatBytes(bytes, locale, { minUnit })` — บังคับหน่วยเล็กสุด เช่น `"MB"` (PDF มีสำเนาเพราะต้องการแสดงเป็น MB)

### Changed

- `Notice` / `StatusBadge` ใช้ token โทนแทน palette ดิบ (ถอด `ui-audit-ok-file`) — สีเท่าเดิม ยกเว้นตัวอักษรของ `Notice` จาก 900→800 (dark 100→200) ให้ตรงกับ `StatusBadge`
- `FormDialog`: state ของ action อยู่ในเนื้อ dialog — ปิดแล้วเปิดใหม่ได้ฟอร์มรอบใหม่เสมอ (เดิม `keepOpen` เปิดใหม่ยังเห็นผลรอบก่อน และ state ที่มี secret จะถูกส่งเป็น `prev` ไปกับ submit ถัดไป)
- `useCopyToClipboard`: ไม่มี `navigator.clipboard` แล้วลอง fallback แทนการเตือน "Clipboard not supported"

### ตรวจแล้วไม่แก้

- hydration mismatch ของ trigger ที่ render ผ่าน Button (PDF รายงาน, ห่อ wrapper `slot-props.ts`): showcase ใช้ `render={<Button/>}` กับ Dialog/Sheet/Popover/DropdownMenu/Tooltip ไม่มี hydration error ใน dev — น่าจะมาจาก wrapper `asChild` ของ PDF เอง ให้ PDF ลองเปลี่ยนเป็น `render=` ตรง ๆ ก่อน
- ข้อความ sr-only "Close" ใน `DialogContent`/`SheetContent` ยังแปลไม่ได้ — อยู่ในไฟล์ shadcn (ห้ามแก้มือ) รอตัดสินใจ

### Fixed

- showcase: เมนู "ออกจากระบบ" ที่หัวเว็บดูเหมือนกดไม่ได้ — ออกแล้วกลับหน้าเดิม middleware ส่งไปล็อกอิน และ Pi Auth ยังมี session จึงล็อกอินกลับทันที → `UserButton afterSignOutUrl="/login"` จอดหน้าเข้าสู่ระบบ

## [0.13.1] - 2026-09-25

### Fixed

- **`cn()` ลบคลาสตามบทบาททิ้งเงียบ ๆ** (พบตอน Pi Done ย้ายไปใช้ 0.13.0): tailwind-merge รู้จักเฉพาะ
  `text-xs … text-9xl` ว่าเป็นขนาดตัวอักษร `text-body`/`text-caption` จึงถูกเดาว่าเป็น "สี" แล้วโดน
  `text-foreground/80` หรือ `text-muted-foreground` ที่อยู่ในสตริงเดียวกันลบทิ้ง — build ผ่าน ไม่มี
  error ใด ๆ แต่ตัวอักษรกลับไปใช้ขนาดที่สืบทอดมา (ชื่องานใน Pi Done ควรเป็น 16px บนมือถือ กลายเป็น
  ค่า root) ตอนนี้ `cn()` ใช้ `extendTailwindMerge` ประกาศคลาสทั้ง 6 ไว้ในกลุ่ม `font-size` จาก
  `TYPOGRAPHY_ROLES` โดยตรง เพิ่มบทบาทใหม่ในอนาคตจึงไม่ต้องแก้ที่นี่อีก

## [0.13.0] — 2026-09-25

### Added

- **สเกลตัวอักษรตามบทบาท + ตอบสนองจอ** (ขอจาก Pi Done — บนมือถืออ่านเล็กเกินไป): คลาสใหม่ `text-title-lg` `text-title` `text-subtitle` `text-body` `text-caption` `text-label` ค่าเป็น **mobile-first แล้วแน่นขึ้นบนจอ ≥ 48rem** (body 16→15px, caption 14→13px, subtitle 17→16px) — เหตุผลเดียวกับที่ iOS ใช้ body 17px ส่วน macOS ใช้ 13px: มือถือถือห่างและใช้นิ้ว เดสก์ท็อปอ่านใกล้และชี้ด้วยเมาส์
  - ทำได้โดย `@theme` ชี้ `--text-*` ไปที่ `--fs-*` แล้วเปลี่ยน `--fs-*` ใน media query — utility ยังเป็นคลาสเดียวและยังใช้ variant ได้ (`md:text-body`); **ไม่แตะ root font-size** ซึ่งจะทับค่าที่ผู้ใช้ตั้งไว้ในเบราว์เซอร์
  - `text-xs … text-2xl` ยังใช้ได้เหมือนเดิม ไม่ใช่ breaking — แต่ `text-xs` (12px) ไม่ควรเป็นขนาดเนื้อหาอีกต่อไป
  - `TYPOGRAPHY_ROLES` export จาก `@suphark/ui` เป็นแหล่งความจริงเดียวของตาราง (showcase `/design-system#tokens-typography` render จากค่านี้ ไม่เขียนซ้ำ)
- **ความสูงขั้นต่ำของรายการเมนูบนอุปกรณ์สัมผัส**: `@media (pointer: coarse)` ตั้ง `min-height: 44px` ให้ `dropdown-menu-item` / `checkbox-item` / `radio-item` / `sub-trigger` / `select-item` / `command-item` — เดิมไม่มีความสูงเลย (`py-1` ≈ 26px) ต่ำกว่าเกณฑ์ Apple 44pt / Material 48dp; ใช้ `pointer: coarse` ไม่ใช่ความกว้างจอ เพราะหน้าต่างแคบบนเดสก์ท็อปยังใช้เมาส์
- audit: กฎ `raw-text-scale` (warning, opt-in ด้วย `--semantic-text`) จับ `text-xs/text-sm/…` ที่ยังไม่ย้ายไป role class — ให้แอปทยอยย้ายทีละส่วนแล้วเปิดกฎกันถอยหลัง

### Fixed

- **`arbitrary-text` ของ audit ไม่เคยจับ `text-[0.8rem]`**: regex เดิม `\d+` ตามด้วยหน่วยทันที จึงข้ามค่าทศนิยมทั้งหมด (ทั้งใน `audit.mjs` และ `audit-tailwind-typography.mjs`) — แก้เป็น `\d*\.?\d+` แล้วพบของค้าง 15 จุดที่ผ่าน CI เขียวมาตลอด
- แทนขนาด arbitrary 12 จุดด้วย role class: `text-[0.7rem]`/`text-[0.625rem]`/`text-[0.6rem]` → `text-label` (HeaderCrumb badge, SubNav, TopTabs, IconPicker, Initials, Stepper, SecretReveal, PrimarySecondaryText, showcase site-header) และข้อความ error ของ `FormFieldInput` → `text-caption` (บนมือถือขึ้นเป็น 14px อ่านออกและพ้นเกณฑ์ iOS zoom)
  - ที่ยังเหลือคือใน `components/ui/**` (`button.tsx` `toggle.tsx` `calendar.tsx` = `text-[0.8rem]`) ซึ่งเป็นไฟล์ที่ shadcn generate — ห้ามแก้มือ รอรอบ regenerate

## [0.12.0] — 2026-09-23

### Added

- **`OrganizationSwitcher` prop `itemAction(org)`** (ขอจาก Pi Auth) — ปุ่มท้ายแถวของแต่ละองค์กรในเมนู เช่น ⚙ "ตั้งค่าองค์กร" แบบ Vercel/Clerk: แอปส่ง element ที่กดได้มาเอง (พร้อม aria-label/title) component ห่อให้และ **หยุด click/keydown ไม่ให้สลับองค์กร**; คืน `null` = แถวนั้นไม่มีปุ่ม; มี `itemAction` แล้วองค์กรเดียวก็ยังมีเมนู (เดิมยุบเป็นป้ายเฉย ๆ เมื่อไม่มี `footer`) — เดิมแอปต้องวาง "ตั้งค่าองค์กร" เป็นรายการแยกใน `footer`
- **`OrganizationSwitcher` prop `selectableActive`** (ขอจาก Pi Auth) — แถวที่ active กดได้ด้วย เรียก `onSwitch` เหมือนแถวอื่น (ค่าเริ่มต้น false = คงพฤติกรรมเดิม กดแล้วไม่ทำอะไร); สำหรับเมนูที่ "เลือก" = ไปหน้าของสิ่งนั้นไม่ใช่แค่สลับ เช่น crumb บัญชีของ Pi Auth ที่กดชื่อบัญชีแล้วเข้าคอนโซลบัญชีนั้น — ตัดรายการ "คอนโซลบัญชี" ท้ายเมนูที่ซ้ำช่องทางออกได้
- showcase: หน้า `organization-switcher` ตัวแรกใส่ ⚙ ท้ายแถว; tests 2 กรณี (รวม 130)

## [0.11.2] — 2026-09-22

### Fixed

- **`HeaderCrumbs` บนจอแคบใช้ย้อนกลับ/สลับไม่ได้** (ผู้ใช้ชี้ใน `/shell-top` มือถือ): เดิมซ่อน crumb ก่อนสุดท้ายทั้งก้อนแต่ยังเห็นตัวคั่น `/ /` และไม่มีทางเข้าถึงตัวสลับองค์กร/แอป → บน `< sm` ยุบเป็นปุ่ม `…` (aria-label `collapsedLabel` ค่าเริ่มต้น "แสดงเส้นทางทั้งหมด") เปิด `Popover` แสดง crumb ที่ซ่อนเรียงลงมา — แต่ละตัวยังเป็น switcher ของมันเอง (DropdownMenu ซ้อนใน Popover ทำงานได้ ทดสอบสลับองค์กรใน popover แล้ว); ตัวคั่นซ่อนตามตัวที่ซ่อน
- `HeaderCrumb`: `overflow-hidden` + label `min-w-0` และ wrapper ตัวสุดท้ายบังคับ `max-w-full` — ตัวสุดท้ายหดตามช่องแทนบานทับ `header.actions`; `badge` ซ่อนบนจอแคบ (`hidden sm:inline`) ให้ที่กับชื่อ
- `SubNav`: key ของกลุ่มใช้ชื่อกลุ่มแทน index (biome `noArrayIndexKey` — suppression เดิมหลุดตอน 0.11.1 จัดรูปแบบใหม่ ทำให้ `biome ci` ใน CI ไม่ผ่าน)
- showcase: `/shell-top` header actions ซ่อน LayoutSwitch + กระดิ่งบนจอแคบ (ก่อนหน้ากินที่จน crumb เหลือ 25px); tests 2 กรณี (รวม 128)

## [0.11.1] — 2026-09-22

### Changed

- showcase: เพิ่มหน้า stub ให้ลิงก์เมนู mock ที่ไม่มีหน้าจริง (`/shell-top/roles`, `/shell-top/security`, `/shell/bidding`, `/shell/orgs`) — Next prefetch เคย 404 ใน console ทุกครั้งที่เข้า `/shell`, `/shell-top`

- `SubNav` (AppShell layout top): หัวกลุ่มกับรายการเคยเป็นสี muted เท่ากันจนแยกไม่ออก (ผู้ใช้ Pi Auth ชี้ในหน้า Settings) → หัวกลุ่มเป็น `text-[0.7rem] font-semibold uppercase tracking-wider text-muted-foreground/70`, รายการที่ไม่ active เป็น `text-foreground/80` (hover `text-foreground`), กลุ่มที่ 2 ขึ้นไปมีเส้นคั่น `border-t border-border/60` + `pt-3`; active และ `<select>` บนจอแคบคงเดิม — ไม่มี prop ใหม่ (ขอจาก Pi Auth)

## [0.11.0] — 2026-09-21

### Added

- `AppShell` (layout sidebar): slot **`sidebarContentBefore`** / **`sidebarContentAfter`** วางใน `SidebarContent` ก่อน/หลังเมนู — เลื่อนไปกับเมนู (ต่างจาก `sidebarHeader` ที่ตรึงบน) ซ่อนอัตโนมัติเมื่อยุบเป็นไอคอน; สำหรับต้นไม้โฟลเดอร์ + ถังขยะ + มิเตอร์พื้นที่แบบ Google Drive (ขอจาก Pi Files — เดิมต้องยัดใน `sidebarHeader` แล้วจำกัด max-h เอง)
- showcase: `/shell` ใส่ `TreeView` + `ProgressBar` ใน `sidebarContentAfter` เป็นตัวอย่าง (`app/shell/sidebar-drive.tsx`)

## [0.10.0] — 2026-09-21

### Added

- **`SectionNav`** (`@suphark/ui/next`, สเปกจาก Pi Auth — ชิ้นสุดท้ายที่แอปยังประกอบเอง) — หัวหมวด + แถบแท็บย่อยใต้หัวข้อสำหรับ layout ของหมวดที่มีหลายหน้า (directory/access/security/integrations): `title`/`description`/`actions` ส่งต่อ `PageHeader`, `tabs[{ href? | slug?, label, exact?, badge? }]` (href หรือ `${base}/${slug}`), แต่ละแท็บเป็น `NavLink` (`-mb-px border-b-2` ไฮไลต์ `border-primary` ตาม pathname, `aria-current=page`), badge ต่อท้าย label, `navLabel` (ค่าเริ่มต้น `UiText.sectionNav.tabs` — "แท็บย่อย"/"Section tabs"), ไม่มี tabs = ไม่มี nav; ไม่มี state ใช้จาก server component ได้ (เฉพาะแถบ `<nav>` เป็น client component เล็ก ๆ เพื่ออ่าน UiText); types `SectionNavProps`, `SectionNavTab`; `UiText.sectionNav` (optional)
- showcase: หน้า `section-nav` (แท็บชี้หน้าจริงในหมวดนำทาง — Link prefetch จะไม่ 404) — 97 หน้า; tests 3 กรณี (รวม 126)

## [0.9.0] — 2026-09-21

### Added

- **`RuleBuilder<F extends string>`** (barrel, สเปกจาก Pi Files — แทน rule-builder ชั่วคราว 390 บรรทัดของกฎ storage/lifecycle) — ตัวสร้างเงื่อนไขแบบต้นไม้ AND/OR/NOT ซ้อนได้ generic ไม่ผูก schema: แอปส่ง `fields[{ key, label, operators[{ value, label }], defaultLeaf(), renderValue({ leaf, onChange, disabled }), describe?, group?, disabled?: boolean | string }]` (ตัวแก้ค่าเป็นของแอป — ToggleGroup/Input/number+หน่วย), component จัดโครง: กลุ่ม = กรอบ (root border ปกติ, ลูก border-dashed bg-muted/30) + ToggleGroup and/or + ปุ่ม "เงื่อนไข"/"กลุ่มย่อย" (ซ่อนเมื่อถึง `maxDepth` ค่าเริ่มต้น 3 รวม root; กลุ่มใหม่สลับ op จากแม่), leaf = grid `[ฟิลด์ 11rem | operator (เมื่อ >1) | ค่า | NOT]` มือถือเรียงลง (เปลี่ยนฟิลด์ → `defaultLeaf()` ของฟิลด์ใหม่), NOT = กรอบ border-destructive/40 + ป้าย "ไม่ใช่" + ปุ่ม "เอา NOT ออก" (`allowNot`), ปุ่มลบทุก item; ฟิลด์ใช้ `NativeSelect` (`label` เป็น string, `group` = optgroup, `disabled` string = title เหตุผล, ฟิลด์ที่เลือกอยู่แล้วไม่ถูกปิด), key ของ item คงที่ต่อ object (WeakMap) แก้ item หนึ่งไม่ re-mount พี่น้อง, `onChange` ต้นไม้ใหม่ทั้งก้อน immutable, `role=group` aria-label "กลุ่ม AND ระดับ n", `disabled` ทั้ง builder, `showSummary` ประโยคสรุปใต้ builder, `defaultField`, `language`/`text` (and/or/not/wrapNot/addCondition/addGroup/removeCondition/removeNot/emptyAnd/emptyOr/summary/field/operator/group()/andJoin/orJoin/notPrefix/unknownField()); data-slot `rule-builder`/`rule-group[data-op][data-depth]`/`rule-item`/`rule-leaf`/`rule-not`/`rule-builder-summary`
- types `RuleLeaf<F>`/`RuleGroup<F>`/`RuleNot<F>`/`RuleCondition<F>`/`RuleFieldDef<F>`/`RuleBuilderProps<F>`/`RuleBuilderText`; helpers **`describeCondition(cond, fields, text?, language?)`** (AND " และ ", OR " หรือ ", NOT "ไม่ใช่ …", กลุ่มย่อย >1 ข้อครอบวงเล็บ, leaf ใช้ `describe` ของฟิลด์หรือ "label operator value", ฟิลด์ไม่รู้จัก → "ฟิลด์ไม่รู้จัก: key"), `isRuleGroup`/`isRuleNot` type guards, `emptyGroup(op = "and")`
- showcase: หน้า `rule-builder` (ชุดกฎ storage ตัวอย่าง + JSON สด) — 96 หน้า; tests 4 กรณี (รวม 123)

### Fixed

- **`CommandItem` ที่ active มองไม่ออกว่าตัวไหน** (รายงานจาก Pi Done ใน dark mode): shadcn ใช้ `data-selected:bg-muted` แต่ Tailwind `data-selected:` = `[data-selected]` (มีแอตทริบิวต์) ขณะที่ cmdk ใส่ `data-selected="false"` ให้รายการอื่นด้วย → ทุกแถวได้ bg-muted เท่ากัน; `styles.css` override `[data-slot=command-item][data-selected="true"]` เป็น `color-mix(muted, foreground 8%)` (dark 14%) — ไม่แตะ `command.tsx` ของ shadcn (CommandPalette, Combobox, SearchableSelect ได้ผลด้วย)

## [0.8.0] — 2026-09-21

รอบ feedback หลังทุกแอปย้ายมา 0.7.0 ครบ 6/6 — สเปกจาก Pi Done (ColorPicker, CommandPalette client-side), Pi Mail (ActionForm), Pi Files (file explorer 4 ตัว) ทำรวดเดียว; minor ทั้งหมด ไม่เปลี่ยน API เดิม

### Added

- **`ColorPicker<T>`** + **`ColorSwatch`** (barrel) — กริดเลือกสีจากชุดที่แอปส่ง `colors[{ value, label, swatchClassName? | swatch? (CSS) }]` (แพ็กเกจไม่ bundle palette): ปุ่ม `aria-pressed` + `aria-label`/`title`, ที่เลือก = `ring-2 ring-primary ring-offset-1` + ✓ ขาว, hover scale-105, roving tabindex + ลูกศร ↑↓←→/Home/End (จำนวนคอลัมน์อ่านจาก grid จริง), `columnsClassName` (grid-cols-5), `size` sm|md (size-7/size-8), `language`/`text`; `ColorSwatch` จุดสี size-3.5 สำหรับ trigger/badge (`color` CSS หรือ class) — ไม่มี popover ในตัว แอปครอบเองแบบ IconPicker (สเปกจาก Pi Done แทน metadata-color-picker 9 จุด)
- **`CommandPalette` โหมด client-side / controlled** (ขอจาก Pi Done): `filter(query) => CommandPaletteSection[]` คำนวณฝั่งแอปทุกครั้งที่ query เปลี่ยน (เรียกแม้ query ว่าง — ใช้แสดง action/ล่าสุด, ไม่ debounce) แสดงก่อนผลจาก `search`; item ใน section รับ `onSelect()` (action ล้วน `href` ไม่บังคับแล้ว; มีทั้งคู่เรียก onSelect ก่อนแล้วไป href) + `shortcut` (ป้ายท้ายรายการ); `open`/`onOpenChange` คุมจากภายนอก, `showTrigger={false}` ซ่อนปุ่มของแพ็กเกจ, `shortcut={null}` ไม่ดักคีย์ลัด (แอปดักเอง); type `CommandPaletteSectionItem`
- **`ActionForm`** (ข้อสังเกตจาก Pi Mail): `hideSuccessMessage` ซ่อนข้อความสำเร็จเมื่อแอปแจ้งผลเอง (ใน compact ข้อความดันปุ่มตกบรรทัด — ยังแสดง error), `submitDisabled` + `submitProps` (variant/size/className ของปุ่มส่ง); **`FormState<TData>`** — `ok: true` มี `data?: TData` และ `ActionForm<TData>`/`FormDialog<TData>`/`FormAction<TData>` generic → `onSuccess(s)` ได้ `s.data` ไม่ต้อง cast (`TData` ค่าเริ่มต้น `undefined` — โค้ดเดิมไม่ต้องแก้)
- **`TreeView`** (barrel, สเปกจาก Pi Files) — ต้นไม้ทั่วไป `role=tree` ตาม WAI-ARIA (treeitem มี aria-level/expanded/selected, roving tabindex): `nodes[{ id, label, icon?, hasChildren?, children?, disabled?, badge? }]`, `selectedId`/`onSelect(id, node)`, `expandedIds`/`defaultExpandedIds`/`onExpandedChange` (controlled ได้), `loadChildren(id, node)` โหลดลูก lazy (Spinner ระหว่างโหลด, cache ในตัว, error = ลูกว่าง), `onDrop(targetId, e, node)`/`canDrop` HTML5 dnd ไฮไลต์ node (`data-drop-target`), `renderLabel(node, { expanded, selected, level })`, คีย์บอร์ด ↑↓ เลื่อน → ขยาย/เข้าไปลูกแรก ← ยุบ/กลับแม่ Home/End Enter/Space เลือก, `indent` (12px/ระดับ), `emptyState`, `label`; สีตาม token ของ Sidebar (เลือก = `bg-sidebar-accent`) — ลูกศรยุบ/ขยายไม่ใช่ button (ไม่ซ้อน focusable ใน treeitem)
- **`Dropzone`** (barrel, สเปกจาก Pi Files) — พื้นที่ลากวางไฟล์: การ์ดเดี่ยว (เส้นประ + ไอคอน + ข้อความ + ปุ่มเลือกไฟล์; คลิกการ์ด/ปุ่ม/Enter เปิด picker) หรือ `overlay` ห่อ `children` แสดงชั้น "วางไฟล์ที่นี่" เฉพาะตอนลากไฟล์เข้าหน้า (ฟัง window + กัน browser เปิดไฟล์เมื่อวางนอกโซน); `onFiles(File[])`, `multiple` (true), `accept` (นามสกุล/กลุ่ม/mime — export `matchesAccept`), `maxBytes`, `onRejected(files, "size" | "type" | "multiple")`, `disabled`, `directory` (`webkitdirectory` + วางโฟลเดอร์ไล่อ่านไฟล์ข้างในผ่าน `webkitGetAsEntry`), `hint` (ค่าเริ่มต้นแสดง maxBytes), `icon`, `language`/`text`; data-attribute `data-active`/`data-disabled`
- **`UploadList`** (barrel, สเปกจาก Pi Files) — รายการอัปโหลด `items[{ id, name, sizeBytes, progress 0–1, status queued|uploading|done|error|aborted, error?, mime? }]` พร้อม `ProgressBar` ต่อแถว (queued จาง), `FileTypeIcon`, สรุป "x/y เสร็จ"/"เสร็จทั้งหมด" (aria-live), `onCancel`/`onRetry`/`onClearDone`/`onClose`, ยุบ/ขยาย (`defaultCollapsed`), `floating` มุมล่างขวาแบบ Drive (w-80 ไม่เกินจอ), `title`, `language`/`text`; `items` ว่าง = ไม่ render
- **`FileTypeIcon`** + **`getFileKind(mime, filename)`** (barrel) — ไอคอน lucide ตามชนิดไฟล์ (folder/image/video/audio/pdf/doc/sheet/slides/zip/code/text/default) จาก mime ก่อน นามสกุลสำรอง สีตาม token (pdf destructive, sheet success, folder/slides warning, สื่อ primary), `size` px, `data-kind`; **`formatBytes(bytes, locale)`** (lib/formatters) ฐาน 1024 "1.5 KB"/"12 MB"
- showcase: หน้า `color-picker` (กริด + ครอบ Popover), `tree-view` (lazy + drop ไฟล์จริง), `dropzone` (การ์ด + overlay), `upload-list` (mock progress + ลอย), `file-type-icon`; `command-palette` เพิ่มแบบ client-side คุม open เอง; `action-form` เพิ่ม hideSuccessMessage/submitDisabled/data (SecretReveal) — 95 หน้า; tests 17 กรณีเพิ่ม (รวม 119)

## [0.7.0] — 2026-09-20

component ระดับแอปที่ Pi Auth และ Pi Done เขียนซ้ำกัน — สเปกจาก Pi Auth ออกแบบให้ทั้งสองแอปใช้ร่วม (ไม่พึ่ง i18n/auth ของแอป ทุกข้อความรับเป็น prop หรือ `UiText`)

### Added

- **`CommandPalette`** (`@suphark/ui/next`) — ค้นหาแบบ ⌘K/Ctrl+K ทั้งแอป: `pages` (หน้าในเมนูที่แอปกรองสิทธิ์แล้ว — กรองฝั่ง client ตาม label/group/href/keywords) + `search?(query) => Promise<CommandPaletteSection[]>` (server action ของแอป เรียกเมื่อ ≥ `minQuery` ตัว, debounce `debounceMs` 150, เก็บ query คู่ผล ผลล่าสุดเท่านั้นที่แสดง), `compact` (ปุ่มไอคอนใน header) หรือปุ่มเต็มกว้าง + `Kbd` (⌘K/CtrlK ตาม platform หลัง mount) สำหรับ `sidebarHeader`, `shortcut` (ค่าเริ่มต้น k), `text` (fallback `UiText.palette`), `onNavigate` (ค่าเริ่มต้น router.push + ปิด); `Command shouldFilter={false}`, `CommandEmpty` แสดง "กำลังค้นหา…" ขณะ pending; types `CommandPaletteItem`, `CommandPaletteSection`, `CommandPaletteText`
- **`OrganizationSwitcher`** (`@suphark/ui/next`) — ตัวสลับองค์กร/tenant แบบ Clerk บน `HeaderCrumb` + `DropdownMenu`: `organizations[{ id, name, slug?, logoUrl? }]`, `activeId`, `onSwitch(id)` (server action — component ทำ useTransition + `router.refresh()` ปิดได้ด้วย `refresh={false}`), `placement="header"` (HeaderCrumb ใน layout top) / `"sidebar"` (ปุ่มเต็มกว้าง + SwitcherChevron ใน `sidebarHeader`), `fallbackLabel`/`heading` (ค่าเริ่มต้น `UiText.switcher`), `hint(org)` (ค่าเริ่มต้น `/slug`), `footer` (slot ท้ายเมนู เช่น สร้างองค์กร); องค์กรเดียว = ไม่มีเมนู, active มี ✓ และกดไม่ทำอะไร, pending ปิดปุ่ม, โลโก้ `<img size-5>` หรือ Building2; types `OrganizationOption`, `OrganizationSwitcherProps`
- `UiText.palette` / `UiText.switcher` (optional, มีค่าเริ่มต้นไทย/อังกฤษ)
- **`IconPicker`** (barrel, generic `T extends string`) — เลือกไอคอนจากชุดที่แอปส่ง `icons[{ name, icon: LucideIcon, labelTh, labelEn, keywords? }]` (แพ็กเกจไม่ bundle ชุดไอคอน): ค้นหา name/labelTh/labelEn/keywords ผ่าน `useDeferredValue`, preview ไอคอน+ชื่อด้านบน, กริด `SelectionButton` (aria-pressed, title/aria-label ตาม `language` th/en), `accentColor` (inline style สี dynamic ของผู้ใช้), `heightClassName`/`columnsClassName`, `text` ทับข้อความ — สเปกจาก DueBell ให้ Pi Done (metadata icon) ใช้ร่วม
- **`SelectionButton`** (barrel) — ปุ่ม toggle `aria-pressed` + สีเน้นเมื่อเลือก (Button outline) — chip ประเภท/ตัวกรอง, ช่องใน IconPicker (ยกจาก DueBell)
- **`CalendarMonthGrid<T>`** (barrel) — ตารางเดือนเลือกวันที่แอปคุมเนื้อหาต่อวัน: `month "YYYY-MM"`, `selectedDay`, `onSelectDay(day, date)`, `itemsByDay`, `renderDay(ctx)` (คืน null = ✓ ของแพ็กเกจเมื่อ complete), `dayState(items, ctx) → { complete?, hasItems? }` → data-attribute `data-selected/today/has-items/complete/weekend` ให้ CSS ของแอปแต่ง, (data-attribute เป็น boolean มี/ไม่มี — CSS ใช้ `[data-selected]`), `weekStartsOn 0|1`, `weekdayLabels` (export `WEEKDAYS_TH`/`WEEKDAYS_EN`), `today` (ไม่ส่ง = browser หลัง mount ผ่าน `useMounted` — SSR ได้ไม่ mismatch), `dayLabel` (aria-label "วันที่ N มี M รายการ"), `legend`, `dayClassName`; ช่องว่างก่อนวันที่ 1 aspect-square; ปุ่มวัน `aria-pressed` — สเปกจาก DueBell + Pi Done
- **`ProgressBar`** (barrel) — แถบความคืบหน้าตั้ง `tone` (default/success/warning/destructive), `size` sm/md/lg, `label`, `showValue`/`format`, `trackClassName`/`indicatorClassName`/`indicatorStyle` (สี dynamic) จาก props — `Progress` ของ shadcn ต่อท้าย Track+Indicator ให้เสมอ ส่ง children เข้าไปจะได้ 2 แถบ (รายงานจาก DueBell) จึงประกอบจาก `ProgressPrimitive.Root` โดยตรง
- showcase: หน้า `icon-picker`, `selection-button`, `calendar-month-grid`, `progress-bar`; tests 6 กรณีเพิ่ม (รวม 100)
- **error รายช่องในฟอร์ม server action** (ขอจาก Pi Mail): `FormState` แบบ `ok: false` รับ `errors?: Record<string, string>`; `ActionForm` และ `FormDialog` รับ `children` เป็นฟังก์ชัน `({ state, pending, errors, fieldError }) => ReactNode` (type `FormRenderContext`) → `<LabeledField error={fieldError("email")}>` ไม่ต้องมี hook ของแอป; `FormMessage` ยังแสดง `error` รวมเหมือนเดิม
- `UserMenu`: prop `menuLabel` + `UiText.userMenu`/`signOut` (ขอจาก Pi PDF — แอปอังกฤษได้ label ไทย); `ThemeMenuItems`: prop `onThemeChange(theme)` สำหรับบันทึกธีมเป็น preference ของบัญชี + ข้อความจาก `UiText.theme`
- `LabeledField`: prop `htmlFor` — ส่งมาแล้ว label ไม่ครอบ control (ผูกด้วย id) ให้ tooling ที่ไม่คำนวณ nested label เห็น accessible name (ข้อสังเกตจาก Pi Files)
- `DataTable`: `showToolbar` / `showPagination` (ค่าเริ่มต้น true) ปิดแถบค้นหา/ตัวกรอง/View และ pagination สำหรับตารางตั้งค่าเล็ก ๆ (ขอจาก Pi Files)

### Fixed

- **`AppShell` (layout sidebar) มี `<main>` ซ้อน 2 ชั้น** (รายงานจาก DueBell): `SidebarInset` ของ shadcn เป็น `<main>` อยู่แล้ว → ใส่ `id={APP_MAIN_ID}`/`tabIndex` ที่ SidebarInset และเลิกสร้าง `<main>` ชั้นใน (เป็น `<div>`); layout top ยังมี `<main>` ตัวเดียวเหมือนเดิม
- showcase: หน้า `command-palette`, `organization-switcher`; `/shell` (sidebarHeader + ยุบเป็นไอคอน) และ `/shell-top` (crumb องค์กร) ใช้สองตัวนี้จริงแทน mock เดิม; tests 5 กรณี (คีย์ลัด toggle + กรอง keywords, search debounce/ผลล่าสุด/push+ปิด, org เดียวไม่มีเมนู, active ไม่เรียก onSwitch + refresh, fallback label)

## [0.6.1] — 2026-09-20

### Added

- **`npx suphark-ui-audit`** (`bin` ของแพ็กเกจ, `scripts/audit.mjs`) — ตรวจโค้ดแอปปลายทางตามกติกา design system ในคำสั่งเดียว: error = `window-dialog` (window.confirm/alert/prompt), `radix-state` (`data-[state=…]` ที่ Base UI ไม่มี), `arbitrary-text` (`text-[Npx]`), `base-ui-props` (สคริปต์เดิม); warning = `raw-palette` (bg-red-500 …), `important` (utility ลงท้าย `!` — เฉพาะ `--important` สำหรับโค้ดแพ็กเกจ); `--strict` ให้ warning เป็น error; ยกเว้น `// ui-audit-ok: เหตุผล` / `/* ui-audit-ok-file: เหตุผล */`; ข้าม `components/ui/**`, tests, generated; README + `docs/agent-rules.md` มีวิธีใช้ — repo นี้รัน `pnpm audit:ui` ใน `verify` และ CI (0 error 0 warning)
- `FormFieldRadioCards`: prop `aria-label` ส่งต่อไป RadioGroup เมื่อไม่แสดง `label` (ข้อสังเกตจาก Pi Auth หลังย้ายมาใช้ — ของเดิมมี aria-label)

### Changed

- ล้าง raw palette ในแพ็กเกจเป็น semantic token: labs badge ใน `AppNav` → `text-warning-muted-foreground`, `FloatingSaveButton` สำเร็จ → `bg-success`, `FormMessage` สำเร็จ → `text-success`, ดอกจัน/ข้อความ error ใน `FormField*` → `text-destructive`, ไอคอน `ThemeToggle` → `text-warning`/`text-primary`/`text-muted-foreground`, ตัวอย่างใน design-system; ที่ยังใช้ palette โดยตั้งใจและจดไว้ (`ui-audit-ok-file`): `Notice`/`StatusBadge` (โทน 50/900 คู่ dark — รอตัดสินใจ token ระดับ tone), `lib/status-colors.ts` (ชุดสีให้ผู้ใช้เลือก)

## [0.6.0] — 2026-09-20

component สำเร็จรูปสำหรับฟอร์ม server action ที่ Pi Auth ประกอบเองอยู่ (DueBell/Mail/Files ใช้ได้เหมือนกัน) — ไม่เปลี่ยน API เดิม; **รวม 0.5.2 ที่ยังไม่ได้ publish**

### Added

- **`LabeledField`** + **`CheckboxField`** (barrel) — ช่องฟอร์มสำหรับ server action ธรรมดา (ไม่ใช่ react-hook-form): label ครอบ control + `hint` หรือ `error` (ตั้ง `data-invalid`) ประกอบจาก shadcn `Field/FieldLabel/FieldDescription/FieldError`; `CheckboxField` = Checkbox + label บรรทัดเดียว ใส่ `name` แล้วส่ง "on" ใน FormData — ยกจาก Pi Auth (42 ไฟล์) คง API เดิมเป๊ะ; ใช้จาก server component ได้ (ชื่อ `LabeledField` เพราะ `Field` ชนกับ shadcn และ `FormField` ชนกับ react-hook-form)
- **`ActionForm`** (barrel — ไม่พึ่ง next) — ฟอร์ม inline คู่กับ `FormDialog`: `useActionState` + `FormMessage` + ปุ่มส่ง (ป้ายค่าเริ่มต้น `UiText.save`), ไม่ใช้ `action=` บน `<form>` จึงคงค่าที่พิมพ์เมื่อ action คืน error; props `action`, `title?`, `submitLabel?`, `compact?` (ไม่มี Card, ปุ่ม sm, จัดแนวนอน wrap สำหรับแถวตาราง), `className?`, `onSuccess?(state)`; export type **`FormAction`** จาก barrel (FormDialog ใช้ชนิดเดียวกัน)
- **`Stepper`** (`@suphark/ui/next` — ใช้ next/link) — แถบขั้นตอน wizard ทุกขั้นกดเข้าได้: `steps[{ key, href, label, status: done|todo|problem, statusLabel? }]`, `current`, `ariaLabel?`; แนวนอนเลื่อนได้บนจอแคบ แนวตั้งบน lg; วงกลม เลข/✓/⚠ + `StatusBadge` ใต้ชื่อ; `aria-current="step"`; server component ได้; types `StepperStep`, `StepStatus`
- **`FormFieldRadioCards`** (backward-compatible): ใช้ **โดยไม่มี `control`** ในฟอร์ม server action ได้ — `name` ส่งต่อไป `RadioGroup` (มี hidden input ใน FormData) + `defaultValue` (uncontrolled) หรือ `value`+`onValueChange` (controlled); **`layout="row"`** = การ์ดแนวนอน ปุ่มวิทยุจริงซ้าย ไอคอน+ชื่อบรรทัดบน คำอธิบายบรรทัดล่าง (`grid sm:grid-cols-2`, checked = `border-primary bg-primary/5`); layout `grid` เดิม จุดเลือกมุมขวาบนตอนนี้ตามสถานะจริงของปุ่มวิทยุ (CSS `peer-data-checked`) จึงถูกทั้ง controlled/uncontrolled
- showcase: หน้า `labeled-field`, `action-form`, `stepper`, `form-field-radio-cards`; tests 8 กรณี (labeled-field, action-form ส่ง FormData/คงค่า/onSuccess/compact, stepper, radio-cards FormData + row)

## [0.5.2] — 2026-09-20 (ไม่ได้ publish แยก — รวมใน 0.6.0)

รอบรีวิวประสิทธิภาพ + บั๊กที่เหลือ — ไม่เปลี่ยน props

### Fixed

- **`PullToRefresh`** (`@suphark/ui/pwa`): effect ผูก `pullDistance`/`isRefreshing` เป็น deps → ถอด/ใส่ listener 4 ตัวบน `window` ใหม่ทุก `touchmove` และ `touchend` หลุดได้ระหว่างนั้น (ดึงแล้วไม่รีเฟรช/ป้ายค้าง) — อ่านค่าผ่าน ref ลงทะเบียนครั้งเดียว
- **`ThemeToggle`** เมื่อส่ง `persistedTheme`: effect ผูก `theme` ด้วย → ผู้ใช้กดเปลี่ยนแล้วถูก set กลับเป็นค่าที่บันทึกไว้ทันที (server action ยังไม่กลับ) — sync เฉพาะเมื่อ `persistedTheme` เปลี่ยน (รวมครั้งแรก)
- **`DataTableRowActions`**: `EditDialog` ถูก mount ทุกแถวตลอดเวลา (50 แถว = 50 Dialog+ฟอร์ม และ `initialData` stale) — mount เฉพาะตอนเปิด
- **`useDataTable`**: `onGlobalFilterChange` อ่านค่าเก่าจาก closure (พิมพ์เร็วใน tick เดียวหายตัวอักษร) → อ่านจาก `table.getState()`; `getPaginationRowModel` ไม่ใส่เมื่อ `manualPagination` (server แบ่งหน้าแล้ว ไม่ตัดซ้ำ); ตัด `useMemo` ที่ไม่มีผล
- **`FormFieldCombobox`**: cache ตัวเลือก key ด้วย function identity ใน `Map` module-level → inline fetcher ทำให้โตไม่จำกัด (memory leak) และไม่เคย hit — key ที่เป็นฟังก์ชันเก็บใน `WeakMap` (ส่ง `fetcherKey` ยังดีที่สุด)

### Changed (ประสิทธิภาพ)

- **`ClientDateFormatter`**: ทุก instance เคยมี `setInterval` ของตัวเอง + render เพิ่ม 1 รอบตอน mount → ใช้ **`useTicker()`** นาฬิกากลางแชร์ timer เดียวต่อ interval + `useMounted()` (ไม่มี render เพิ่ม) + cache `Intl.DateTimeFormat`
- **`FormattedNumber`**: จาก state + 2 effects (3 renders/เซลล์) และ `new Intl.NumberFormat` ทุกครั้ง → `useMounted()` + `useMemo` + cache formatter ต่อ locale+options (ตารางหลายร้อยเซลล์เห็นผล)
- **`DataTableFacetedFilter`**: `selectedValues` Set ใหม่ทุก render ทำให้ `useMemo` เรียง options ไม่เคย hit → memo จาก `filterValue` จริง
- **`AppNav`**: กลุ่มเมนูที่กางได้เปลี่ยนจาก remount ทั้ง subtree ด้วย `key` เมื่อลูก active/ค้นหา → Collapsible แบบ controlled (`NavCollapsible`) เปิดอัตโนมัติเมื่อสถานะเปลี่ยน ผู้ใช้กาง/หุบเองได้ ไม่ mount ใหม่ มี animation
- **`RelativeDate`** ใช้ `useMounted()` กลาง

### Added

- **`useMounted()`** (barrel) — true เฉพาะฝั่ง client หลัง hydrate ผ่าน `useSyncExternalStore` (ไม่มี render เพิ่ม) — ใช้กับค่าที่ server/browser ต่างกัน (เวลา, โซนเวลา, localStorage)
- **`useTicker(intervalMs)`** (barrel) — ตัวนับที่เพิ่มทุก interval, ทุก instance แชร์ `setInterval` เดียวต่อ interval (เริ่ม/หยุดตามผู้ใช้ตัวแรก/สุดท้าย); 0 = ไม่ tick
- **`getNumberFormat` / `getDateTimeFormat`** (`@suphark/ui/lib/intl-cache`, barrel) — Intl formatter ที่ cache ต่อ locale+options
- tests: `use-ticker` (แชร์ timer/หยุดเมื่อถอดหมด), `intl-cache`

### ไม่ได้แก้ตามที่ประเมินไว้ (0.5.2)

- `DataTableToolbar` render ชุดตัวกรอง 2 ครั้ง (desktop + Sheet มือถือ): ตรวจแล้ว `SheetContent` ของ Base UI ไม่ mount ลูกเมื่อปิด ชุดใน Sheet จึงมีเฉพาะตอนเปิด — ต้นทุนจริงมีแค่ชุด desktop ที่ `hidden` บนมือถือ (ปุ่ม + trigger ไม่มี popup) ไม่คุ้มเสี่ยง hydration flash จากการ gate ด้วย `useIsMobile()`

### Added (showcase/เครื่องมือ)


- showcase: หน้า **`/changelog`** render `packages/ui/CHANGELOG.md` ตอน build (parser เล็ก ๆ ไม่เพิ่ม dep: รุ่น/หมวด Added-Changed-Fixed/รายการ/inline code-bold-link) + ลิงก์ในเมนูบน
- **`pnpm check:changelog`** (`scripts/check-changelog.mjs`) — ทุกการเปลี่ยนแปลงใน `packages/ui/src`, `package.json`, `README.md`, `apps/showcase/src` ต้องมีบรรทัดใน CHANGELOG; ตรวจ working tree ก่อน commit (อยู่ใน `pnpm verify`) และช่วง commit ใน CI (`CHANGELOG_RANGE`)

## [0.5.1] — 2026-09-20

### Fixed

- **`RelativeDate` hydration mismatch (React #418) บน production** — เดิม render "วันนี้/เมื่อวาน" บน server ด้วย "ตอนนี้" ของ server (UTC และ module ที่โหลดไว้ก่อน) ซึ่งต่างจาก browser ได้ทั้งโซนเวลาและข้ามวัน → บน Vercel หน้า `/shell` (ตารางมี RelativeDate) hydrate พังทั้งหน้าและ React render ใหม่ทั้ง tree (เห็น theme script ซ้ำ 2 ตัว) — ตอนนี้คำนวณเฉพาะฝั่ง client หลัง mount (`useSyncExternalStore` guard แบบเดียวกับ `ClientDateFormatter`) ก่อน mount แสดงไอคอน + ช่องว่างขนาดเดิม
- `RelativeDate`: เอาข้อความเฉพาะ supplychain ("วันที่อ้างอิงราคาจริง") ออกจาก tooltip → prop ใหม่ `titlePrefix` (ค่าเริ่มต้น "วันที่") และ `emptyText`; สีเป็น semantic token (`text-muted-foreground`) แทน `text-slate-*` ตามกฎ design system (className/iconClassName ทับได้เหมือนเดิม)
- showcase: launch config `showcase-prod` (:3202, `next start` หลัง build) สำหรับตรวจ production build ในเครื่อง

## [0.5.0] — 2026-09-19

ยกของที่พิสูจน์แล้วจาก Pi Done (todo/kanban) เข้าแพ็กเกจ — ไม่เปลี่ยน props เดิม

### Added

- **`DialogsProvider` + `useDialogs()`** (`@suphark/ui`): กล่องโต้ตอบแบบ promise ทั้งแอปบน AlertDialog — `alert / confirm / prompt / choose / checklist` ครอบครั้งเดียวที่ root แล้วเรียกได้ทุกที่โดยไม่ต้อง render อะไรในผู้เรียก (ต่างจาก `useConfirm()` ที่ยังอยู่เหมือนเดิม); เปิดคำขอใหม่ขณะกล่องเปิด → คำขอเดิม resolve เป็นค่ายกเลิก; `UiText` เพิ่ม optional `ok`, `alertTitle`, `promptTitle`, `chooseTitle`, `checklistTitle` (มีค่าใน `UI_TEXT_TH`/`UI_TEXT_EN`)
- **`createKanbanCollisionDetection()`** (`@suphark/ui/kanban` — entry แยกเพราะ @dnd-kit/core สร้าง context ตอน import ใช้จาก server component ไม่ได้): collision detection ของ dnd-kit สำหรับบอร์ดหลายคอลัมน์ — pointer ในช่องว่างระหว่างการ์ด/ใต้การ์ดสุดท้ายแปลงเป็น "การ์ดที่ใกล้ที่สุดในคอลัมน์" (ไม่นับการ์ดที่ลาก) แทนการรายงานคอลัมน์ซึ่งทำให้ dnd-kit ล้าง transform (การ์ดเด้งกลับ, drop ไปท้ายคอลัมน์); คอลัมน์ว่างรายงาน droppable ของรายการ; รองรับ droppable อื่นของคอลัมน์ผ่าน `resolveColumnId` (เช่น handle ลากเรียงคอลัมน์)
- **`useTrackedState()`** (`@suphark/ui`): `useState` + `getLatest()` ที่อัปเดต synchronous — mutation ติดกันใน tick เดียว (drag-drop, automation, bulk) อ่านค่าล่าสุดแทน closure ตอน render
- **`@suphark/ui/pwa`** (entry ใหม่): `PwaServiceWorkerRegistration` (ลงทะเบียน SW + เก็บ `beforeinstallprompt` + `watchServiceWorkerUpdates`: เช็คอัปเดตตอนโหลด/กลับมาที่แท็บ/ทุก 15 นาที แล้ว reload ครั้งเดียวเมื่อ worker ใหม่คุมหน้า เลื่อนขณะพิมพ์ ไม่ reload ตอนติดตั้งครั้งแรก), `PwaInstallCard` (`appName`, `text` ค่าเริ่มต้นไทย + `PWA_INSTALL_CARD_TEXT_EN`), `PullToRefresh` (มือถือ, `router.refresh()`, `PULL_TO_REFRESH_TEXT_EN`), install-prompt store; `PullToRefresh` ใช้ next/navigation จึงอยู่ entry นี้ไม่ใช่ barrel หลัก
- showcase: หน้า `dialogs`, `kanban-board` (บอร์ด 3 คอลัมน์ลากได้จริง), `pwa-install-card`

## [0.4.4] — 2026-09-19

รอบแก้บั๊กจาก code review ทั้ง codebase + audit Web Interface Guidelines — ไม่เปลี่ยน props เดิม

### Fixed

- **`DeleteManyButton`**: `AlertDialogAction` ของ Base UI เป็นปุ่มธรรมดา (ไม่ใช่ Close) → ลบสำเร็จแล้วกล่องค้างเปิด กด Delete ซ้ำได้ด้วย ids ที่ลบไปแล้ว — คุม `open` เอง ปิดหลังสำเร็จ + `table.resetRowSelection()`; ปิดไม่ได้ระหว่าง pending
- **`useDataTable`**: effect sync `initialPageSize` ทับ `pagination.pageSize` ที่ควบคุมจาก prop/URL ตอน mount (URL=50 แต่ตารางกลายเป็น 25 และตัดแถวที่ server ส่งมา) — ข้ามเมื่อ `pagination` ถูกส่งมา (controlled)
- **`FormFieldSelect`**: `onValueChange` ไม่ถูกเรียกเลยเมื่อไม่ส่ง `variant` (ค่าเริ่มต้น select)
- **`FormFieldInput isNumeric`**: แปลงเป็น number ทันทีทำให้ศูนย์ท้ายทศนิยมหายขณะพิมพ์ ("1.0" → "1" พิมพ์ 1.05 ไม่ได้) — คงเป็น string จนทศนิยมจบ
- **`ErrorState`**: hardcode `/api/auth/get-session` + `/sign-in` ของ supplychain → แอปอื่นได้ 404 แล้วถูกตีความว่า "เซสชันหมดอายุ" พร้อมลิงก์ที่ไม่มี — ตรวจเซสชันเฉพาะเมื่อส่ง prop ใหม่ `sessionCheckUrl` (และ `signInHref` ค่าเริ่มต้น `/sign-in`); response ที่ไม่ใช่ 401/ok ไม่ถือว่าหมดอายุ (supplychain ส่ง `sessionCheckUrl="/api/auth/get-session"` เมื่อย้ายมาใช้)
- **`formatRelativeThaiDate`**: `Math.abs` ทำให้วันพรุ่งนี้เป็น "เมื่อวาน" — ใช้ `differenceInCalendarDays` คงเครื่องหมาย เพิ่ม "พรุ่งนี้"; ไกลกว่านั้น date-fns บอกทิศทางเอง
- **data attribute ของ Radix ที่หลงมาบน Base UI** (ไม่เคยทำงาน): `AppNav` ลูกศรกลุ่มเมนูไม่หมุน (`data-[state=open]` → `data-open`), `FormFieldRadioCards` การ์ดที่เลือกไม่ไฮไลต์ (`peer-data-[state=checked]` → `peer-data-checked`), trigger เปิดเมนูไม่มีพื้นหลัง (`UserMenu`, `DataTableColumnHeader`, `DataTableRowActions`, `HeaderCrumb` → `data-popup-open`), แท็บ `DesignSystemShowcase` ไม่ไฮไลต์ (`data-[state=active]` → `data-active`)
- **`ConfirmActionButton` / `RowActions`**: action โยน error → เด้ง error boundary ทั้งหน้าและ dialog ค้าง — จับแล้ว `toast.error(message)` (ข้อความจาก `UiText.actionFailed` optional) คง dialog ไว้ให้ลองใหม่
- **`HeaderBreadcrumbs hideIds`**: regex `[0-9a-z]{16,}` ซ่อน segment คำธรรมดายาว ≥16 (เช่น `organizationmembers`) — ต้องมีตัวเลขปนจึงถือเป็น id
- **`RowActions` รายการ `href`** render เป็น `<Link>` จริง (Ctrl/⌘+click, คลิกกลาง, เปิดแท็บใหม่ได้) ยกเว้นมี `confirm`; **`TransitionLink`** ไม่ดัก modifier keys/คลิกกลางแล้ว
- **`RefreshButton`**: `{...props}` ทับ `isLoading` ที่รวม pending ของ `router.refresh()` เมื่อผู้เรียกส่ง `isLoading={false}`
- **cmdk value ชนกันเมื่อ label ซ้ำ** (`Combobox`, `FormFieldCombobox`, `FormFieldSelect variant="combobox"`, `FormFieldInput variant="autocomplete"`): ต่อ `value` ท้าย label ให้ระบุรายการได้ (ค้นด้วยรหัสได้ด้วย)

### Added (Web Interface Guidelines)

- **`AppShell`**: กล่องเนื้อหาเป็น `<main id="app-main" tabIndex={-1}>` (export `APP_MAIN_ID`) + skip link "ข้ามไปเนื้อหา" (มองเห็นเมื่อกด Tab ตัวแรก) ทั้ง layout sidebar และ top
- `styles.css`: `@media (prefers-reduced-motion: reduce)` ตัด animation/transition ทุก component (tw-animate, animate-spin, dialog zoom)
- `SubNav`/`TopTabs`: `focus-visible:ring-2` ให้เท่ากับ HeaderCrumb; `<select>` ของ SubNav ใส่ `text-foreground` (Windows dark mode); `ConfirmDialog` ปุ่มยืนยัน `aria-busy` ตอน pending; ข้อความ "ไม่พบ" ใช้ curly quotes
- showcase: `/login` กัน `next=//host` (protocol-relative) ; `LayoutSwitch` ป้ายเป็น `sr-only` บนจอแคบ; demo `form-fields` เพิ่มช่อง isNumeric + `onValueChange`

## [0.4.3] — 2026-09-19

### Added

- **`useConfirm()`** (barrel) — `window.confirm` แบบ promise บน ConfirmDialog สำหรับโค้ดฝั่ง client ที่ไม่ใช่ server action (ยกมาจาก DueBell ที่ย้าย window.confirm 8 จุดด้วย hook นี้): `const { confirm, confirmDialog } = useConfirm(); if (!(await confirm({ description, destructive: true }))) return;` แล้ว render `{confirmDialog}`; เรียกซ้ำขณะเปิดอยู่ → คำขอเดิม resolve(false)
- `ConfirmSpec` object รับ `destructive?` (RowActions/ConfirmActionButton ใช้เป็นตัวทับค่าเดิมของรายการ/variant)
- README: ตาราง "ยืนยันก่อนทำ — ห้ามใช้ window.confirm" (เลือก RowActions.confirm / ConfirmActionButton / useConfirm / ConfirmDialog) และหมายเหตุ Turbopack ค้าง `Package path ./styles.css is exported … but no valid target file` หลังอัปเดตแพ็กเกจ = cache ของ dev server ให้ลบ `.next`

## [0.4.2] — 2026-09-19

### Added

- **`ConfirmDialog`** (barrel) — กล่องยืนยันมาตรฐานบน `AlertDialog` ของแพ็กเกจ ใช้แทน `window.confirm` (webview/automation บางตัวปิด window.confirm ทิ้ง กดแล้วไม่เกิดอะไร และไม่เข้า design system): controlled `open`/`onOpenChange`, `title?` (ค่าเริ่มต้น `UiText.confirmTitle`), `description`, `confirmLabel?` (ค่าเริ่มต้น `UiText.confirm`), `cancelLabel?`, `destructive` (ปุ่มยืนยันสีแดง), `pending` (ปุ่มหมุน + ปิดไม่ได้ชั่วคราว), `onConfirm`; พร้อม type `ConfirmSpec` (= `string | { title?, description, confirmLabel?, cancelLabel? }`) และ `normalizeConfirm()`
- **`ConfirmActionButton`** (`@suphark/ui/next`) — ปุ่มเดี่ยว + ConfirmDialog + server action ในตัว (`confirm`, `action`, `data`, `onDone?` + props ของ ActionButton เช่น `variant`/`icon`/`permission`) รอ action เสร็จแล้ว `router.refresh()` — ใช้แทน `<form action>` + window.confirm ที่ Pi Auth มี (ชื่อไม่ใช้ `ConfirmButton` เพราะมีปุ่มธรรมดาชื่อนั้นอยู่แล้วใน standard buttons)
- `UiText.confirm` / `UiText.confirmTitle` (optional มีค่าเริ่มต้นไทย/อังกฤษ) — แอปที่ส่ง UiText เองไม่ต้องเพิ่ม
- export type `RowActionItem` (รายการที่ไม่ใช่ separator)

### Changed

- **`RowActions` / `RowMenu` prop `confirm`** เปิด `ConfirmDialog` แทน `window.confirm` (ขอจาก Pi Auth ผ่าน Pi Mail) — รับ `ConfirmSpec`: string เดิมยังใช้ได้ (= description, title/ปุ่มค่าเริ่มต้น) หรือ object กำหนด `title`/`confirmLabel`/`cancelLabel`; ปุ่มยืนยันสีแดงเมื่อ `destructive`; dropdown ปิดก่อน dialog เปิด และ dialog render นอก DropdownMenu (กัน focus trap ของ Base UI ชนกัน); กดยืนยันแล้วค่อยรัน `href`/`onSelect`/`action` ใน transition เหมือนเดิม — โค้ดเรียกเดิมไม่ต้องแก้
- ไม่มี `window.confirm` เหลือในแพ็กเกจ
- showcase: หน้า `/components/confirm-dialog` (ConfirmDialog + ConfirmActionButton) และ `/components/row-actions` ใช้ confirm แบบ object

## [0.4.1] — 2026-09-19

### Added

- **`SwitcherChevron`** (barrel) — ลูกศร ⇅ มาตรฐานท้าย trigger แบบ switcher/select: `ChevronsUpDown` ขนาด `size-3` (12px) `shrink-0 text-muted-foreground opacity-70` aria-hidden (เล็กบางแบบ Clerk) รับ `className` ทับได้ — ใช้ตัวเดียวทั้งแพ็กเกจ/แอป (`OrganizationSwitcher` ใน @suphark/auth-ui จะย้ายมาใช้ด้วย)

### Fixed

- `HeaderCrumb`: ลูกศรใหญ่ 24px ในแอปปลายทาง (Pi Auth) — เดิมใช้ `size-3.5!` ซึ่ง Tailwind ของแอปที่ scan ผ่าน `@source` ไม่ generate class แบบ `!` → svg ไม่มีขนาดจึงตกไป 24px ของ lucide; เปลี่ยนเป็น `SwitcherChevron` (ไม่ใช้ `!`)

### Changed

- ลูกศรของ `UserMenu`, `Combobox`, `MultiSelectCombobox`, `FormFieldCombobox`, `FormFieldSelect` เปลี่ยนมาใช้ `SwitcherChevron` (เดิม h-4 w-4 opacity-50 ปนกันหลายขนาด) — ทุกจุดได้ 12px จางเท่ากัน; ไอคอน sort ใน `DataTableColumnHeader` ไม่ใช่ switcher คงเดิม; `components/ui/searchable-select.tsx` เป็นไฟล์ shadcn ไม่แตะ
- นโยบาย: หลีกเลี่ยง `!` บน utility ในแพ็กเกจถ้าไม่จำเป็น (เหลือเฉพาะ `group-data-[collapsible=icon]:p-0!` ใน `AppBrand` ซึ่ง `sidebar.tsx` ของ shadcn generate class เดียวกันอยู่แล้ว)

## [0.4.0] — 2026-09-19

### Added

- **`AppShell layout="top"`** — โครงแบบ Clerk dashboard (ขอจาก Pi Auth): header 56px มีโลโก้ + **crumb switchers** คั่น `/` (`crumbs` = array หรือ component ที่ render `<HeaderCrumbs>`) + `header.actions`/`banner`/`center`; **แถบแท็บหลัก** ใต้ header จาก `nav` ชั้นแรก (active underline ตาม prefix, badge, เลื่อนแนวนอนบนมือถือ); แท็บที่มี `items` → **sub-nav ซ้าย** 224px (รองรับหัวกลุ่ม 2 ชั้น, `searchable`, มือถือเป็น select); `contentMaxWidth`, `brandColor` ใช้ได้เหมือนเดิม; breadcrumb ของหน้าปิดเป็นค่าเริ่มต้นในโหมดนี้ — โหมด `sidebar` เดิมไม่เปลี่ยน
- component ประกอบ (export จาก `@suphark/ui/next`): `HeaderCrumb` (ปุ่ม switcher: icon/label/badge/hint + ⌄ ใช้เป็น trigger ของ DropdownMenu ใดก็ได้), `HeaderCrumbs`, `TopTabs`, `SubNav`, helpers `topLevelTabs`/`isTabActive`
- showcase: `/shell-top` ตัวอย่างเต็ม (องค์กร → แอป → Production [Invite-only], แท็บ 6 ตัว, "ตั้งค่า" มี sub-nav 2 กลุ่ม)

## [0.3.3] — 2026-09-19

### Fixed

- `FormDialog`: จำกัดความสูงไว้ในจอ (`max-h-[calc(100dvh-2rem)]`) header/footer ตรึง เฉพาะเนื้อฟอร์มเลื่อน — ฟอร์มยาวไม่ล้นในหน้าต่างเตี้ย (รายงานจาก Pi Auth หน้าลงทะเบียนแอป); `contentClassName` ยังใช้กำหนดความกว้างได้เหมือนเดิม

### Added

- export type `DateRange` (react-day-picker) จาก barrel — แอปใช้กับ `DateRangePicker` ได้โดยไม่ต้องติดตั้ง react-day-picker

### Changed (showcase เท่านั้น — ไม่กระทบ API)

- หน้า **/components** แบบ ui.shadcn.com/docs/components: 74 หน้า (ทะเบียน `apps/showcase/src/docs/registry.ts` + demo ต่อไฟล์ใน `src/docs/demos/`) แต่ละหน้ามีตัวอย่างจริง/โค้ด (อ่าน source ของ demo ตอน build)/import line/หมายเหตุ/ลิงก์ shadcn+source, เมนูซ้ายตามหมวด, prev/next

- `DesignSystemShowcase` รับ prop `links?: { shell }` และตัดหัวใหญ่/badge ออก (แอปเป็นคนมีหัวเดียว); แท็บป้ายสั้น (จอแคบเลื่อนแนวนอน 1 แถว — แก้แท็บทับหัวเรื่องเพราะ `group-data-horizontal/tabs:h-8`); hero ไม่มีกรอบ + `HeroSpecimen` (component จริง + สวิตช์ --brand); CardTitle/CardDescription/หัว section ใหญ่ขึ้น 1 ขั้น; h2 ภาษาไทยอย่างเดียว; ปุ่ม "ตัวอย่างหน้าจอ" ชี้ไป `/shell`
- ช่องค้นหาในหน้า Overview ค้นได้จริง: `search-index.ts` (26 หัวข้อ) → สลับแท็บ + เลื่อนไป anchor (`id` บนทุก section หลัก) + empty state

## [0.3.2] — 2026-09-18

### Fixed

- `copyText`/`selectContents` export จาก barrel หลักด้วย (แอปใช้ทำปุ่มคัดลอกเองได้)
- `EnvSnippet`: ค่ายาว (client secret) ล้นออกนอก dialog — ตัดบรรทัดในกรอบ (`whitespace-pre-wrap break-all` + `min-w-0`) แทน scroll แนวนอน (รายงานจากหน้า Register app ของ Pi Auth)
- `EnvSnippet` / `SecretReveal`: ปุ่มคัดลอกเงียบเมื่อ `navigator.clipboard` ถูกบล็อก (webview/embedded browser เช่น browser ใน Claude desktop) — เพิ่ม `copyText()` (`@suphark/ui/lib/copy-text`) ที่ fallback ไป `execCommand("copy")`; ถ้ายังไม่ได้ EnvSnippet จะเลือกข้อความให้และบอกให้กด Ctrl+C (`UiText.copyFailed` optional)

## [0.3.1] — 2026-09-18

### Changed

- `AppShell`: slot `sidebarHeader` ซ่อนอัตโนมัติเมื่อยุบเป็นไอคอน (เดิมล้นทับเนื้อหา — รายงานจาก Pi Auth) + prop ใหม่ `sidebarHeaderCollapsed` สำหรับไอคอนแทนตอนยุบ
- `HeaderBreadcrumbs`: `labels` รับฟังก์ชัน `(segment, href) => ReactNode` ได้ (ใส่ `t()` ของ next-intl) และ map รับ ReactNode — ฟังก์ชันต้องมาจาก client component (ส่งจาก server layout จะได้ 500 "Functions cannot be passed directly to Client Components"; showcase สาธิตด้วย `breadcrumbs: <ShellBreadcrumbs />`)
- README: อธิบายว่า `ThemeMenuItems` มี group + หัวในตัว ไม่ต้องห่อเอง

## [0.3.0] — 2026-09-18

### Added

- **AppShell** (`@suphark/ui/next`) — โครงแอปกลางแทน ConsoleShell ของ Pi Auth และ main layout ของ supplychain: shadcn Sidebar (ยุบเป็นไอคอน/offcanvas/none, Sheet บนมือถือ, ⌘B, cookie `sidebar_state`), โลโก้ `AppBrand` (name/logo/subtitle/version), ค้นหาเมนู, เมนู 2 ชั้น `AppNav` (ไฮไลต์ตาม pathname, กางอัตโนมัติเมื่อลูก active, dropdown เมื่อยุบ, badge, labs, pin ผ่าน `pin` prop), slot `sidebarHeader`/`sidebarFooter`, header (SidebarTrigger + `HeaderBreadcrumbs` อัตโนมัติ + `center`/`actions`/`banner`), `brandColor` ต่อ tenant, `contentMaxWidth`
- `UserMenu` (variant `sidebar` | `header`): หัวผู้ใช้ + children (ใส่ DropdownMenuItem/ThemeMenuItems เอง) + `onSignOut`
- `HeaderBreadcrumbs` (labels/skip/hideIds/homeHref), `NavLink` (จาก Pi Auth)
- โมเดลเมนู `AppNavGroup`/`AppNavItem` (icon เป็น ReactNode — ประกาศใน server component ได้) + helpers `filterNav` (ตัดตามสิทธิ์ทุกชั้น), `searchNav`, `flattenNav`, `isNavActive` (+tests รวม 40)
- barrel หลัก export `toast` จาก sonner (แอปไม่ต้องติดตั้ง sonner เอง)
- showcase: `/shell` ตัวอย่าง layout ที่ใช้ AppShell + UserMenu + ThemeMenuItems + filterNav + cookie defaultOpen

## [0.2.0] — 2026-09-18

### Added

- entry **`@suphark/ui/data-table`** (ยกจาก supplychain `components/data-table`): `DataTable`, `DataTableColumnHeader`, `DataTableToolbar`, `DataTablePagination`, `DataTableFacetedFilter`, `DataTableDateRangeFilter`, `DataTableViewOptions`, `DataTableRowActions`, `useDataTable`, types (`DataTableProps`, `FacetedFilterConfig`) + `DeleteManyButton`, `ResourcePropertyFilter` (+helpers) — ต้องมี peer `@tanstack/react-table` (optional; แอปที่ไม่ใช้ตารางไม่ต้องติดตั้ง); ลากเรียงแถวใช้ `@dnd-kit/*` เป็น dependency ของแพ็กเกจ
- `useTableSearchParams` / `TABLE_PARAM` (state ตารางใน URL) ที่ `@suphark/ui/next`
- tests: data-table, data-table-faceted-filter, resource-property-filter (รวม 34)
- exports `./package.json`, `./components/data-table`
- showcase: การ์ด DataTable จริงในแท็บ Data Display; code recipe ใช้ import path ของแพ็กเกจ
- `apps/showcase/vercel.json` + `docs/ops/deploy-vercel.md`

## [0.1.1] — 2026-09-18

### Added

- `NativeSelect` / `NativeSelectOption` (shadcn `native-select` — `<select>` ธรรมดาสำหรับฟอร์ม server action/FormData) ตามที่ Pi Auth ใช้ 17 ไฟล์
- dependency `cn` (^0.3.0) — shadcn CLI รุ่นใหม่สร้างไฟล์ที่ `import { cn } from "cn"` แทน `lib/utils`; ทั้งสองทางใช้ได้ ไฟล์เดิม 59 ตัวยังใช้ `@suphark/ui/lib/utils`

### Changed

- ตัด `__tests__`/`*.test.*` ออกจาก tarball (`files` ใน package.json) — test ยังอยู่ใน repo

### Notes

- `ThemeToggle` props `persistedTheme` / `onThemeChange` เป็น optional อยู่แล้ว — ไม่ส่ง = ใช้ next-themes อย่างเดียว (ใช้แทน ThemeToggle ของ @pi/ui ได้โดยไม่ต้องเปลี่ยน call site)

## [0.1.0] — 2026-09-18

รุ่นแรก — ยกจาก `supplychainnextjs-1` (source of truth) + ชุด generic จาก Pi Auth `@pi/ui`

### Added

- **shadcn/ui base-nova 59 primitives** (`components/ui/*`) + tests (combobox, date-picker, slider, tabs)
- **token/ฟอนต์** `styles.css`: slate + success/warning/sidebar/chart, radius, scrollbar, Noto Sans Thai Looped, dark variant
- **shared/button**: AddNew, Save, Submit, Cancel, Confirm, Delete, FloatingSave, Print, ActionButton (base)
- **shared/form** (react-hook-form): FormFieldInput/Select/Combobox/Date/Boolean/RadioGroup/RadioCards/ColorSelect/FormattedNumber, SimpleSelect
- **shared**: Combobox, MultiSelectCombobox, DateRangePicker, FormattedNumber, PrimarySecondaryText, ClientDateFormatter, ErrorState, PageSkeleton, ClientRedirect
- **จาก Pi Auth**: FormDialog, FormMessage/FormState, NameIdFields/toIdentifier (+test), StatusBadge/statusTone, RowMenu, RowActions, SecretReveal, EnvSnippet/randomSecret, Notice, EmptyState, EmptyRow, DataList/DataRow, Stat, DescriptionList, PageHeader, SectionCard, Initials/initialsOf, UiText (TH/EN provider)
- **theme** บน next-themes: ThemeProvider, ThemeToggle (เมนู 3 ตัวเลือก), ThemeSwitch (ปุ่มเดี่ยว), ThemeMenuItems (ใส่ใน DropdownMenu), useTheme
- **lib**: `cn`, `formatThaiFullDate`/`formatRelativeThaiDate`, status-colors, `UiPermissionProvider`/`usePermission` (แอป inject ตัวตรวจสิทธิ์เอง)
- **hooks**: `useIsMobile`, `useCopyToClipboard`
- **สีแบรนด์ต่อ tenant**: rule `[style*="--brand"], [data-brand]` ใน `styles.css` ให้ตั้ง `--brand`/`--brand-foreground` บน wrapper แล้ว primary/ring/sidebar-primary ตาม (แก้ตามบั๊ก @pi/ui `4cd39d8` ที่ `--primary: var(--brand)` บน :root ไม่สืบทอดไปยัง wrapper)
- entry `@suphark/ui/next` สำหรับ component ที่ใช้ next/navigation (LinkButton, RefreshButton, TransitionLink, PageBreadcrumb, PageShell, FormDialog, RowActions, RowMenu)
- showcase `components/design-system/*` (8 sections) + `docs/design-system.md`
- audit scripts `scripts/audit-base-ui-props.mjs`, `scripts/audit-tailwind-typography.mjs` (รับ path เป็น argument ให้แอปปลายทางใช้ได้)

### Changed (เทียบต้นทาง)

- `NameIdFields` เขียนใหม่บน `ui/field.tsx` (Field/FieldLabel/FieldDescription) แทน `pi/Field`
- `ActionButton`/`LinkButton` ใช้ `usePermission` จาก `lib/permission` (context) แทน `@/lib/auth`
- `FormattedNumber` รับ `DecimalLike` (`{ toString(): string }`) แทน `Prisma.Decimal`
- `FormFieldInput` แยก `CopyableInput` เพื่อไม่เรียก hook ในเงื่อนไข
- `ui/form.tsx`, `hooks/use-mobile.ts` เพิ่ม `"use client"` (จำเป็นเมื่อ import ผ่าน barrel จาก server component)
- `ui/date-picker.tsx` แก้ `parts[0] ?? ""` ให้ผ่าน `noUncheckedIndexedAccess` ของแอปปลายทาง

### Not included (รุ่นถัดไป)

- data-table (tanstack) + DeleteManyButton, sidebar/app shell, rich-text-editor (lexical), form-field-image-upload, pdf-export/print, rate, view-tracker, icon-picker, resource-property-filter
