klun-ui 0.1.16 → 0.1.19

package/CHANGELOG.md

@@ -5,6 +5,73 @@ All notable changes to **klun-ui** are documented here. The format follows
 [Semantic Versioning](https://semver.org/) (pre-1.0: minor/patch bumps may carry
 small breaking changes).
 
+## [0.1.19] — 2026-07-11
+
+### Added
+- **`PageHeader` (navigation) — the standard header band for detail/secondary
+  pages.** Breadcrumb + back arrow, a `title` with inline `tags` (StatusBadge /
+  CrossRefBadge / severity Chip) and a `subtitle`, right-aligned `extra` actions,
+  and an optional docked sub-nav (`tabs` / `activeTab` / `onTabChange`, backed by
+  the library's own `Tabs`). `sticky` pins it to a scrolling page. Composes
+  `Button` (back) and `Tabs` rather than re-implementing them.
+- **`CrossRefBadge` (data-display) — the `#123` / `!42` / commit cross-reference
+  atom.** A `Chip`-based token that reveals a hover card (title · status ·
+  assignee · updated time) on hover **and** keyboard focus (Popover is
+  click-only), with `Esc`/blur dismissal. `preview` accepts a structured object,
+  an arbitrary node, or a `() => Promise<…>` lazy loader (Skeleton placeholder).
+  `kind` (`artifact`/`pr`/`commit`/`doc`/`wiki`) drives the leading icon; supports
+  `href`/`onClick`, `resolved` (strike-through), and `disabled`.
+- **`DiffViewer` (data-display) — side-by-side / unified code diff.** Accepts
+  structured `hunks` or a raw unified `patch` (parsed by the exported
+  `parsePatch`); add/remove tinting, dual line-number gutters, `collapsible`
+  body, and inline-comment anchors (`comments` keyed by `` `${side}:${lineNo}` ``
+  + `onAddComment`). Complements `CodeViewer`, which stays a single-column
+  read-only block. `dark` (opt-in) forces a dark surface; the default follows the
+  page theme.
+
+### Changed
+- **`StatusBadge` now reaches the full semantic palette.** `StatusTone` gains
+  `feature` (purple), `verified` (sky), `stable` (teal), `away` (yellow) and
+  `highlighted` (pink), and the built-in vocabulary registers ALM / issue-tracker
+  workflow states (`new`, `in-progress`, `in-review`, `verified`, `released`,
+  `blocked`, `reopened`, `merged`, …). No change to `Badge`.
+  - **Breaking (minor, pre-1.0):** the `verified` status now maps to the new
+    `verified`/sky tone instead of `ok`/green — existing `verified` badges change
+    from green to sky blue. Pass `tone="ok"` to keep the old green.
+
+## [0.1.18] — 2026-06-29
+
+### Fixed
+- **`Popover` panel no longer gets clipped by scrolling/`overflow:hidden` ancestors.**
+  Same treatment as the select family in 0.1.17: the panel now renders in a
+  `document.body` portal, positioned with `fixed` coordinates anchored to the
+  trigger. It follows the trigger on scroll/resize, flips above when there's no
+  room below, is clamped to the viewport, and sits above overlays (z-index 1150)
+  — so a popover inside an `overflow:hidden` card (e.g. the admin ticket "view"
+  dropdown) opens fully instead of being cut off. Outside-click now treats the
+  portaled panel as inside. The `trigger`/`align`/`width`/`children` API is
+  unchanged; this also fixes the date pickers (`DatePicker`/`DateRangePicker`/
+  `DateTimePicker`), emoji picker and filter bars built on `Popover`.
+
+## [0.1.17] — 2026-06-28
+
+### Fixed
+- **Select dropdowns no longer get clipped by scrolling/`overflow:hidden` ancestors.**
+  The custom select family (`Select`, `CompactSelect`, `CompactSelectForInput`,
+  `InlineSelect`) now renders its listbox in a `document.body` portal, positioned
+  with `fixed` coordinates anchored to the trigger. It follows the trigger on
+  scroll/resize, flips above when there's no room below, is clamped to the
+  viewport, and sits above overlays (drawers/modals) — so a select inside a
+  horizontally-scrolling table or an `overflow:hidden` card opens fully instead
+  of being cut off. `TimePicker` keeps its in-flow listbox unchanged.
+  `useSelect`'s outside-click now treats the portaled panel as inside.
+
+### Build
+- `scripts/build-css.mjs` now derives the repo root from its own location and
+  uses esbuild's Node API instead of spawning `npx esbuild`, so `pnpm build`
+  works on Windows (and any machine) — previously it had a hardcoded absolute
+  path and failed to spawn `npx`.
+
 ## [0.1.15] — 2026-06-23
 
 ### Added