fold-ng 0.5.1 → 0.6.0

package/CHANGELOG.md

@@ -8,6 +8,122 @@ All notable changes to **fold-ng** are documented here. The format follows
 
 _Nothing yet._
 
+## [0.6.0] - 2026-07-28
+
+### Added
+
+- **Larger spacing tokens: `--fold-space-{2xl,3xl,4xl,5xl}`** (24 · 32 · 40 ·
+  48px) — the 4px-grid scale extended upward for section padding, page gaps and
+  hero bands (it capped at `xl` 20px). Catalogued (`FoldSpaceToken`) + contract-
+  tested. A new `pnpm run lint:spacing` gate **fails** on any bare raw-px
+  `padding`/`margin`/`gap` under `src/components` (var() theming defaults and
+  ≤2px hairlines excepted); wired into pre-push + CI, alongside the now-enforced
+  `api:check`.
+- **`fold-icon` gains a `tone` input** (`primary` · `secondary` · `muted` ·
+  `faded`) — a semantic tint for the icon. Unset (default) keeps the current
+  behaviour: the icon inherits `currentColor`, matching its context. Set it to
+  override, so a consumer tints an icon through the primitive's own input instead
+  of reaching in with a colour class. Exposes the `FoldIconTone` type.
+- **Two new UI icons: `archive` and `filter`** — stroke glyphs (`currentColor`),
+  the primitives a back-office table toolbar reaches for. Note the existing
+  `more-vertical` already covers the "kebab" ⋮ menu trigger.
+- **Public-API surface guard** (`scripts/gen-api-surface.ts` +
+  `API-SURFACE.md` + `api-surface.spec.ts`, scripts `api:surface` / `api:check`).
+  Snapshots every exported symbol and every `input`/`model`/`output` of every
+  exported class; the spec fails when the live surface drifts. This catches the
+  binding breaks a consumer's plain `tsc` cannot see — Angular templates aren't
+  type-checked by `tsc` — forcing an intentional CHANGELOG entry + bump.
+
+### Fixed
+
+- **`fold-tab-panel` now defaults to `display: block`** (was the custom-element
+  default `inline`). An inline panel wrapping block content broke height
+  propagation inside a bounded, scrolling `fold-page-layout` — a tall tabbed page
+  (e.g. a form split across tabs) stopped scrolling. The `[hidden]` state is
+  re-asserted so inactive panels still collapse.
+
+### Changed
+
+- **BREAKING — `fold-menu`: `expanded` defaults to `undefined` (unset) and now
+  follows `collapsible`.** `<fold-menu collapsible>` boots **expanded** (you
+  added a way to collapse, so open is the natural start) and a bare `<fold-menu>`
+  boots the icon rail — no `[(expanded)]` needed for the common case. A bound
+  value still wins. The model type widened to `boolean | undefined`, so a
+  two-way `[(expanded)]="sig"` needs `sig: WritableSignal<boolean | undefined>`
+  (or drop the binding and lean on the default). Fixes the DX trap where
+  `collapsible` booted collapsed (dev-rule 5.2.4).
+- **BREAKING — `fold-tabs`: `activeKey` is now a two-way `model`; the `tabChange`
+  output is removed.** Migrate `[activeKey]="k()" (tabChange)="k.set($event)"` →
+  `[(activeKey)]="k"` (or keep one-way `[activeKey]` and listen to the model's
+  built-in `(activeKeyChange)`). One source of selection, no twin output (dev-rule
+  4.12).
+- **BREAKING — `fold-view-nav`: `activeKey` is now a two-way `model`; the
+  `activeChange` output is removed.** Same migration as `fold-tabs`
+  (`[(activeKey)]`, or `(activeKeyChange)`). Link items are unaffected (their
+  active state comes from the router).
+- **BREAKING — `fold-data-table`: `selected` is now a two-way `model`; the
+  `selectionChange` output is removed.** Migrate `[selected]="s()"
+(selectionChange)="onSel($event)"` → `[(selected)]="s"` (or one-way `[selected]`
+  - `(selectedChange)`). The change payload is now `ReadonlySet<string | number>`
+    (was `Set`) — widen your handler's parameter type.
+- **Spacing rhythm fully tokenised** — every bare raw-px `padding`/`margin`/`gap`
+  in `src/components` (136 declarations) now resolves through a `--fold-space-*`
+  token. Exact-grid values are renamed 1:1 (no visual change); off-grid drift
+  (6/10/14/18/26…) is snapped to the nearest step (max ±2px). Computed pixels are
+  unchanged except for the snapped off-grid handful. Themeable component defaults
+  keep their px inside `var(--fold-<component>-*, …)` fallbacks.
+- **`fold-paginator`: `pageSize` is now optional** — when omitted it defaults to
+  the first of `pageSizeOptions`, so the common case needs only `currentPage` +
+  `totalItems`. Non-breaking (a passed `pageSize` behaves as before).
+- **`fold-page-section`: `title` now renders a real `<h2>`** — a genuine section
+  heading under the page's `<h1>`, replacing the decorative `fold-element-title`
+  eyebrow. `headingLevel` still drives `aria-level` (a native `<h2>` at the
+  default 2). New `[sectionHeader]` slot projects a bespoke header (e.g. a
+  `fold-element-title` with an icon tile) _instead of_ `title`, and a new
+  `iconTone` input (forwarded to `fold-icon`'s `tone`; defaults to `secondary`)
+  tints the leading icon. The section's vertical rhythm (head↔body gap + the
+  `stack` body's item gap) is now a single token, `--fold-page-section-gap`
+  (default the `lg` space). Visual change to every section header.
+- **`fold-page-layout` gutter & gap defaults are now fluid.** They gain a real
+  home in `:root` (they were fixed inline fallbacks of `32px`):
+  `--fold-page-gutter: clamp(1rem, 4vw, 2rem)` (16→32px) and
+  `--fold-page-gap: clamp(1.25rem, 3vw, 2rem)` (20→32px) — the gutter scales more
+  than the gap (horizontal room is tighter on small screens). Override on any
+  ancestor (or the element) to retune; set `--fold-page-gutter: 32px` to restore
+  the old fixed value. Requires `fold-ng/tokens.css` (components fall back to
+  `32px` without it).
+- **`pnpm release` now regenerates the demo's generated changelog** after
+  stamping `CHANGELOG.md`, so the gallery no longer shows a just-cut version
+  under "Unreleased" in local dev (Pages already regenerated on deploy).
+
+## [0.5.2] - 2026-07-27
+
+### Added
+
+- **`fold-listbox` gains a `selectionChange: T` output** — fires when the user
+  picks an option, carrying the chosen value and **never `null`**. Use it for
+  the common "do X on selection" case to skip the `T | null` narrowing that
+  `[(value)]` / `valueChange` force on every handler. Clearing the value (the ×
+  affordance) does not fire it — observe `value` / `valueChange` for that.
+- **`fold-range-slider` gains a `rangeChange: FoldRangeValue` output** — the same
+  ergonomics for ranges: fires on a thumb drag with the resolved `{ min, max }`,
+  never `undefined`.
+
+### Changed
+
+- **`fold-card` `separators` / `raisedBands` accept a boolean shorthand.** On top
+  of the `FoldCardBandChrome` enum (`none`/`header`/`footer`/`both`), a bare
+  attribute (`<fold-card separators>`) or `[separators]="true"` now means `both`,
+  and `false` means `none` — the idiomatic Angular boolean-attribute ergonomics,
+  while the enum stays for per-band control. Exposes `foldCardBandChrome` (the
+  coercion fn) and `FoldCardBandChromeInput`.
+- **`pnpm release` gates the full suite (incl. `test:e2e`) locally before
+  tagging.** Release tags are protected/immutable, so a tag pushed for a build
+  that then fails CI burns that version number (how `0.5.0` was lost). The
+  release script now runs `lint · tsc · strictTemplates · vitest · test:e2e`
+  (installing Chromium first) up front — a red build aborts with nothing bumped
+  or tagged.
+
 ## [0.5.1] - 2026-07-27
 
 First published 0.5.x — same tree as the (unpublished, e2e-gated) v0.5.0 tag with the release e2e locator scoped to the first control.
@@ -505,7 +621,9 @@ design-token stylesheet.
   `currentColor`; `prefers-reduced-motion` + `forced-colors` are respected;
   strings localise via inputs / providers (`provideFoldPanelLabels`).
 
-[unreleased]: https://github.com/hugoheynard/fold-ng/compare/v0.5.1...HEAD
+[unreleased]: https://github.com/hugoheynard/fold-ng/compare/v0.6.0...HEAD
+[0.6.0]: https://github.com/hugoheynard/fold-ng/releases/tag/v0.6.0
+[0.5.2]: https://github.com/hugoheynard/fold-ng/releases/tag/v0.5.2
 [0.5.1]: https://github.com/hugoheynard/fold-ng/releases/tag/v0.5.1
 [0.5.0]: https://github.com/hugoheynard/fold-ng/releases/tag/v0.5.0
 [0.4.0]: https://github.com/hugoheynard/fold-ng/releases/tag/v0.4.0