fold-ng 0.5.2 → 0.6.1

package/CHANGELOG.md

@@ -8,6 +8,123 @@ All notable changes to **fold-ng** are documented here. The format follows
 
 _Nothing yet._
 
+## [0.6.1] - 2026-07-28
+
+### Changed
+
+- **`fold-tab-panel` now owns the vertical rhythm between its children.** It was
+  a neutral `display: block` with no spacing, so stacked `fold-page-section`s (or
+  cards) inside a panel sat flush against each other — the page gap only reaches
+  the _direct_ children of `.page-body`, and a tab panel isn't one. A panel is a
+  content region, like `.page-body`, so it now lays its children out as a flex
+  column with a `gap`. The gap is the new **`--fold-panel-gap`** token — fluid
+  `16 → 24px`, deliberately one notch tighter than `--fold-page-gap` (`20 → 32px`)
+  so panel content reads as one screen rather than distinct page bands. Escape
+  hatch unchanged from `.page-body`: wrap two elements in a container to tighten
+  them (a single child gets no gap at all). Consumers that re-established this
+  spacing by hand on the panel can drop it.
+
+### Fixed
+
+- **`fold-page-layout` header no longer starves the title/description on narrow
+  screens.** The head was a permanent `space-between` row: the actions slot held
+  its intrinsic width (`flex: none`) while the text column carried `min-width: 0`,
+  so wide `[pageActions]` (e.g. two full-label buttons) squeezed the description
+  down to its longest word — one word per line, stacked vertically. Below `640px`
+  the head now stacks: title/description take the full width and the actions drop
+  onto their own row beneath. Keyed to **both** the viewport (`@media`) and an
+  ancestor container (`@container`, for the gallery's responsive preview), mirroring
+  `app-shell`. The actions slot also gained `flex-wrap` so several wide buttons
+  wrap among themselves instead of overflowing the gutter.
+
+## [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
@@ -533,7 +650,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.2...HEAD
+[unreleased]: https://github.com/hugoheynard/fold-ng/compare/v0.6.1...HEAD
+[0.6.1]: https://github.com/hugoheynard/fold-ng/releases/tag/v0.6.1
+[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