@cdx-ui/components 0.2.3 → 0.2.5

package/docs/resources/release-notes/0.0.1-beta.141/content.md

@@ -0,0 +1,63 @@
+# 0.0.1-beta.141 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.141)
+
+Date and time pickers join Forge UI with DatePicker, DateRangePicker, DateTimePicker, MonthPicker, and a new @cdx-ui/formatters package.
+
+This release ships a full date and time component family for scheduling, filtering,
+and form flows, backed by a new `@cdx-ui/formatters` package with locale-aware date
+utilities and branded wire-format types.
+
+## What's new
+
+**[DatePicker](https://design.candescent.com/docs/components/date-picker/content.md)** — Single-date selection pairs an editable
+**[DateField](https://design.candescent.com/docs/components/date-field/content.md)** with a calendar overlay. Compose
+`DatePicker.Popover`, `DatePicker.Dialog`, or `DatePicker.BottomSheet` for the
+surface, or render `DatePicker.Standalone` inline. Supports `minValue`/`maxValue`,
+locale-aware formatting, `PickerTrigger` with `asChild` for custom triggers such as
+`IconButton` or `Chip`, and dismisses the overlay automatically after a day is
+selected ([#448](https://github.com/dfh-candescent-ui/ui-component-framework/pull/448)).
+
+**[DateRangePicker](https://design.candescent.com/docs/components/date-range-picker/content.md)** — Range selection wires start
+and end **[DateField](https://design.candescent.com/docs/components/date-field/content.md)** inputs to a
+**[RangeCalendar](https://design.candescent.com/docs/components/range-calendar/content.md)**. Controlled state uses
+`value`/`defaultValue`/`onValueChange` with a `DateRangeValue` type. The same
+Popover, Dialog, BottomSheet, and Standalone surfaces are available as on
+DatePicker ([#448](https://github.com/dfh-candescent-ui/ui-component-framework/pull/448)).
+
+**[DateTimePicker](https://design.candescent.com/docs/components/date-time-picker/content.md)** — Combines date and time
+selection with **[DateTimeField](https://design.candescent.com/docs/components/date-time-field/content.md)** segments and a
+**[DateTimeList](https://design.candescent.com/docs/components/date-time-list/content.md)** scrollable picker. Set
+`granularity` to `'hour'`, `'minute'`, or `'second'`; field segments match the
+chosen granularity, and `minValue`/`maxValue` bounds apply to both the field and
+list ([#448](https://github.com/dfh-candescent-ui/ui-component-framework/pull/448)).
+
+**[MonthPicker](https://design.candescent.com/docs/components/month-picker/content.md)** — Month-and-year selection uses
+**[MonthCalendar](https://design.candescent.com/docs/components/month-calendar/content.md)** with `minValue`/`maxValue`
+bounds. Available as Popover, Dialog, BottomSheet, or Standalone, with the same
+custom-trigger pattern as the other pickers
+([#448](https://github.com/dfh-candescent-ui/ui-component-framework/pull/448)).
+
+**[Calendar](https://design.candescent.com/docs/components/calendar/content.md)** — Standalone day grid for inline date
+selection, with optional `minValue`/`maxValue` constraints. Each instance scopes
+selection state independently, so multiple calendars on one screen do not share
+selected dates ([#448](https://github.com/dfh-candescent-ui/ui-component-framework/pull/448)).
+
+**@cdx-ui/formatters** — New package exporting branded `DateId`, `MonthId`, and
+`DateTimeId` types with validating smart constructors, display formatters, segment
+builders, and range helpers. Includes Hermes-safe fallbacks when
+`Intl.RelativeTimeFormat` or `formatToParts` is unavailable. Build values at your
+app boundary with the constructors:
+
+```tsx
+import { dateId, monthId } from '@cdx-ui/formatters';
+
+const today = dateId('2026-08-11');
+const month = monthId('2026-08');
+```
+
+([#448](https://github.com/dfh-candescent-ui/ui-component-framework/pull/448))
+
+**[Select](https://design.candescent.com/docs/components/select/content.md)** and **[Dialog](https://design.candescent.com/docs/components/dialog/content.md)** —
+Overlay components now use `isOpen` instead of `open` for controlled open state,
+matching the picker family. Select and DatePicker overlays also render correctly on
+web when used inside Vite-based apps
+([#448](https://github.com/dfh-candescent-ui/ui-component-framework/pull/448)).

package/docs/resources/release-notes/0.0.1-beta.142/content.md

@@ -0,0 +1,7 @@
+# 0.0.1-beta.142 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.142)
+
+Checkbox and Radio keyboard navigation on web keeps tab order through disabled items and focuses the selected radio.
+
+## Bug fixes
+
+**[Checkbox](https://design.candescent.com/docs/components/checkbox/content.md)** and **[Radio](https://design.candescent.com/docs/components/radio/content.md)** — Web keyboard navigation keeps correct tab order through disabled options and moves focus to the active radio in a group ([#463](https://github.com/dfh-candescent-ui/ui-component-framework/pull/463)).

package/docs/resources/release-notes/0.0.1-beta.143/content.md

@@ -0,0 +1,12 @@
+# 0.0.1-beta.143 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.143)
+
+ProgressCircle adds a circular progress indicator with determinate values, indeterminate loading, and small or large sizes.
+
+## What's new
+
+**[ProgressCircle](https://design.candescent.com/docs/components/progress-circle/content.md)** — Adds a circular progress
+indicator for compact loading and completion feedback. Compose `ProgressCircle` with
+`ProgressCircle.Indicator` to draw the ring; pass a numeric `value` for determinate
+progress or `value={null}` for an indeterminate spinner. Choose `size` (`large` or
+`small`) and `color` (`default` or `inherit` to follow surrounding text color) on the
+root, with the indicator inheriting both unless overridden ([#476](https://github.com/dfh-candescent-ui/ui-component-framework/pull/476)).

package/docs/resources/release-notes/0.0.1-beta.144/content.md

@@ -0,0 +1,7 @@
+# 0.0.1-beta.144 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.144)
+
+Checkbox isReadOnly now renders with correct read-only styling so the control displays its state without allowing interaction.
+
+## Bug fixes
+
+**[Checkbox](https://design.candescent.com/docs/components/checkbox/content.md)** — The `isReadOnly` prop now renders with correct read-only styling and behavior, so checked and unchecked states display without allowing interaction ([#441](https://github.com/dfh-candescent-ui/ui-component-framework/pull/441)).

package/docs/resources/release-notes/0.0.1-beta.145/content.md

@@ -0,0 +1,7 @@
+# 0.0.1-beta.145 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.145)
+
+Adds Tooltip for short contextual hints with hover, focus, and click triggers, placement control, and an optional arrow on web and native.
+
+## What's new
+
+**[Tooltip](https://design.candescent.com/docs/components/tooltip/content.md)** — Adds a compound component for short contextual hints anchored to a trigger element. Compose `Tooltip.Trigger` with the interactive element and `Tooltip.Content` for the overlay body; include `Tooltip.Arrow` when you want a directional pointer. Set `trigger` to `hover` (default), `focus`, or `click`; use `placement` to position the tooltip and `enterDelay` / `leaveDelay` to control show and hide timing. On web, hover opens on hover and focus; on native, hover and focus map to long press ([#474](https://github.com/dfh-candescent-ui/ui-component-framework/pull/474)).

package/docs/resources/release-notes/0.0.1-beta.147/content.md

@@ -0,0 +1,10 @@
+# 0.0.1-beta.147 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.147)
+
+Design token values update for poise, prestige, and pulse presets — review theme overrides if you customize specific tokens.
+
+## What's new
+
+**Design tokens** — Token values in the poise, prestige, and pulse presets update from
+the design system source, and the token-to-CSS-variable mapping reflects the new values.
+Review your theme if you override specific token values
+([#484](https://github.com/dfh-candescent-ui/ui-component-framework/pull/484)).

package/docs/resources/release-notes/0.0.1-beta.149/content.md

@@ -0,0 +1,10 @@
+# 0.0.1-beta.149 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.149)
+
+Sparkle custom icon joins @cdx-ui/icons with outlined and filled variants.
+
+## What's new
+
+**Sparkle** — Adds a custom Sparkle icon to `@cdx-ui/icons` with
+outlined and filled variants. Import `Sparkle` like any other Forge icon and pass
+`filled` for the solid variant, or wrap it with `Icon` from `@cdx-ui/components` for
+Tailwind sizing and color ([#489](https://github.com/dfh-candescent-ui/ui-component-framework/pull/489)).

package/docs/resources/release-notes/0.0.1-beta.150/content.md

@@ -0,0 +1,13 @@
+# 0.0.1-beta.150 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.150)
+
+Dialog and Alert render above Bottom Sheet overlays, fixing stacked modal layering.
+
+This release fixes overlay stacking when Dialog or Alert shares the screen with Bottom Sheet, and adds ProgressCircle documentation on the docs site.
+
+## Bug fixes
+
+**[Dialog](https://design.candescent.com/docs/components/dialog/content.md)** and **[Alert](https://design.candescent.com/docs/components/alert/content.md)** — Always render above Bottom Sheet overlays so confirmation and alert dialogs stay visible when a sheet is open ([#498](https://github.com/dfh-candescent-ui/ui-component-framework/pull/498)).
+
+## Documentation
+
+**[ProgressCircle](https://design.candescent.com/docs/components/progress-circle/content.md)** — New docs page with Basic, Values, Sizes, Colors, and Indeterminate demos, plus TSDoc for inherited `color` and `size` props ([#492](https://github.com/dfh-candescent-ui/ui-component-framework/pull/492)).

package/docs/resources/release-notes/0.0.1-beta.152/content.md

@@ -0,0 +1,7 @@
+# 0.0.1-beta.152 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.152)
+
+Radio draws the focus ring on the indicator only, suppressing the browser default outline around the entire control.
+
+## Bug fixes
+
+**[Radio](https://design.candescent.com/docs/components/radio/content.md)** — Suppresses the browser's default focus-visible outline on the root control so the focus ring appears on the indicator only, matching Checkbox ([#509](https://github.com/dfh-candescent-ui/ui-component-framework/pull/509)).

package/docs/resources/release-notes/0.0.1-beta.154/content.md

@@ -0,0 +1,15 @@
+# 0.0.1-beta.154 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.154)
+
+Adds @cdx-ui/native for Expo font loading and Metro config; useForgeFonts and withForgeMetroConfig move out of @cdx-ui/styles and @cdx-ui/components.
+
+## What's new
+
+**@cdx-ui/native** — Introduces a dedicated native platform package for Expo and Metro integration. Import `useForgeFonts` from `@cdx-ui/native/fonts` instead of `@cdx-ui/styles`, and `withForgeMetroConfig` from `@cdx-ui/native/metro` instead of `@cdx-ui/components`. The package exposes only these two subpaths — there is no root export — so web hosts never pull Expo or font binaries by accident. `@cdx-ui/styles` no longer ships font loading or its `expo-font` peer; add `@cdx-ui/native` and install `expo-font` when you load preset fonts. The deprecated `useCdxFonts` and `withCdxMetroConfig` aliases are removed ([#508](https://github.com/dfh-candescent-ui/ui-component-framework/pull/508)).
+
+```tsx
+import { useForgeFonts } from '@cdx-ui/native/fonts';
+```
+
+```js
+const { withForgeMetroConfig } = require('@cdx-ui/native/metro');
+```

package/docs/resources/release-notes/0.0.1-beta.156/content.md

@@ -0,0 +1,7 @@
+# 0.0.1-beta.156 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.156)
+
+BottomSheet now scrolls correctly on Android when content includes a VirtualizedList.
+
+## Bug fixes
+
+**[BottomSheet](https://design.candescent.com/docs/components/bottom-sheet/content.md)** — Scrolling inside a bottom sheet on Android works again when the sheet content uses a VirtualizedList ([#519](https://github.com/dfh-candescent-ui/ui-component-framework/pull/519)).

package/docs/resources/release-notes/0.0.1-beta.158/content.md

@@ -0,0 +1,9 @@
+# 0.0.1-beta.158 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.158)
+
+Theme overrides resolve DTCG token-reference aliases at runtime, and Theme Editor preserves custom override fields on round-trip.
+
+## What's new
+
+**@cdx-ui/styles** — Per-mode entries in `ThemeOverride.overrides` accept DTCG token-reference aliases such as `{color.brand.700}` in addition to literal values. `applyThemeOverride` resolves aliases against palette-generated primitives at runtime and writes concrete CSS variable values, which keeps overrides working on native where nested `var()` references in variable values are not supported. Explicit overrides still win over generated palette values on collision.
+
+**Theme Editor** — When you pass an existing `ThemeOverride` as `initialValue`, the editor preserves custom `inputs`, per-mode `overrides`, and any `$extensions` keys it does not manage, so hand-authored or imported overrides round-trip through the UI without being stripped. The editor also emits `basePrimary` alongside `brandPrimary` when a base color is set ([#299](https://github.com/dfh-candescent-ui/ui-component-framework/pull/299)).

package/docs/resources/release-notes/0.0.1-beta.159/content.md

@@ -0,0 +1,11 @@
+# 0.0.1-beta.159 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.159)
+
+Palette generation uses OKLCH with designer contrast ratios; theme override types and getting-started guidance are updated.
+
+This release improves how Forge UI generates brand and accent color scales and clarifies how to structure custom theme overrides when you white-label an FI brand.
+
+## What's new
+
+**@cdx-ui/styles palette generation** — Generated brand and accent scales now use OKLCH interpolation through Leonardo Color, with smoothing disabled and designer-calibrated contrast ratios applied at each step. Saturated seed colors keep better hue fidelity across the scale, so programmatic palettes stay closer to what designers expect. Review generated scales if you derive themes from a custom brand color ([#544](https://github.com/dfh-candescent-ui/ui-component-framework/pull/544)).
+
+**Theme overrides** — `@cdx-ui/styles` theme override types and the getting-started developers guide now reflect the current custom override strategy: which token groups you can override, how aliasing works, and how overrides compose at runtime. Align new `ThemeOverride` JSON with the updated type definitions before applying presets or shipping FI-specific themes ([#542](https://github.com/dfh-candescent-ui/ui-component-framework/pull/542)).

package/docs/resources/release-notes/0.0.1-beta.160/content.md

@@ -0,0 +1,7 @@
+# 0.0.1-beta.160 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.160)
+
+Menu adds anchored overlay lists for actions and selections, with checkbox, radio, and placement options.
+
+## What's new
+
+**[Menu](https://design.candescent.com/docs/components/menu/content.md)** — Presents actions or selectable options in an anchored overlay or a standalone list surface. Compose `Menu.Trigger`, `Menu.Popup`, and `Menu.Content` for dropdown-style menus; use `Menu.Item` for one-off commands, `Menu.CheckboxItem` for independent toggles that keep the menu open, and `Menu.RadioGroup` with `Menu.RadioItem` for exclusive choices whose selection persists across opens. Set `placement` to control popup position (including `auto` variants that flip at viewport edges), and use `asChild` on the trigger or items to open a menu from a custom pressable or render richer item layouts. Reach for it anywhere customers pick an account action, filter, or sort order from a compact control ([#512](https://github.com/dfh-candescent-ui/ui-component-framework/pull/512)).

package/docs/resources/release-notes/0.0.1-beta.161/content.md

@@ -0,0 +1,7 @@
+# 0.0.1-beta.161 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.161)
+
+Style Dictionary updates to v5 for a security fix in @cdx-ui/styles token generation.
+
+## Dependencies
+
+**@cdx-ui/styles** — Upgrades the Style Dictionary token build tool to v5, addressing a security vulnerability in the previous major version ([#480](https://github.com/dfh-candescent-ui/ui-component-framework/pull/480)).

package/docs/resources/release-notes/0.0.1-beta.163/content.md

@@ -0,0 +1,7 @@
+# 0.0.1-beta.163 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.163)
+
+Button hover and pressed states now use the correct surface design tokens.
+
+## Bug fixes
+
+**[Button](https://design.candescent.com/docs/components/button/content.md)** — Hover and pressed states use the correct surface design tokens across solid, outline, and ghost variants.

package/docs/resources/release-notes/0.0.1-beta.164/content.md

@@ -0,0 +1,9 @@
+# 0.0.1-beta.164 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.164)
+
+The deprecated Button strong variant is removed; replace it with solid before upgrading.
+
+## Breaking changes
+
+**[Button](https://design.candescent.com/docs/components/button/content.md)** — The deprecated `strong` variant is removed. Replace
+`variant="strong"` with `variant="solid"` everywhere it appears. The `ButtonVariantStrong`
+type export is also removed ([#523](https://github.com/dfh-candescent-ui/ui-component-framework/pull/523)).

package/docs/resources/release-notes/0.0.1-beta.166/content.md

@@ -0,0 +1,17 @@
+# 0.0.1-beta.166 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.166)
+
+Theme overrides expand through a catalog-driven model in @cdx-ui/styles, with Theme Editor persistence fixes and a Chip font token correction.
+
+This release expands theme overrides through a catalog-driven model in `@cdx-ui/styles`, aligns the Theme Editor with that catalog, and fixes Chip label typography plus preset selection persistence.
+
+## What's new
+
+**@cdx-ui/styles** — Theme override expansion is now catalog-driven. Exports such as `overrideCatalogs`, `overrideRuntimeData`, and `overrideRuntimeMap` expose the shared preset, target, and runtime data that power `expandThemeOverride()` and `parseThemeOverride()`. Consumers and the Theme Editor resolve the same FI intent through this single expansion path ([#570](https://github.com/dfh-candescent-ui/ui-component-framework/pull/570)).
+
+**Theme Editor** — Customization controls are generated from the `@cdx-ui/styles` override catalog instead of editor-local definitions, keeping the editor aligned with package-supported override surfaces ([#570](https://github.com/dfh-candescent-ui/ui-component-framework/pull/570)).
+
+## Bug fixes
+
+**[Chip](https://design.candescent.com/docs/components/chip/content.md)** — Label text uses the correct typography font token ([#570](https://github.com/dfh-candescent-ui/ui-component-framework/pull/570)).
+
+**Theme Editor** — Preset-default selections reset when you switch presets ([#570](https://github.com/dfh-candescent-ui/ui-component-framework/pull/570)).

package/docs/resources/release-notes/0.0.1-beta.167/content.md

@@ -0,0 +1,7 @@
+# 0.0.1-beta.167 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.167)
+
+Select.Content adds placement, offset, and crossOffset props to reposition dropdown overlays, with improved anchored overlay positioning near viewport edges.
+
+## What's new
+
+**[Select](https://design.candescent.com/docs/components/select/content.md)** — `Select.Content` accepts `placement`, `offset`, and `crossOffset` props so you can reposition the dropdown overlay relative to its trigger. Flip-shift collision detection and trigger-width matching behave as before. Anchored overlay positioning also improves for **[Menu](https://design.candescent.com/docs/components/menu/content.md)** and other constrained overlays near viewport edges, keeping popups attached to their triggers instead of overlapping them ([#563](https://github.com/dfh-candescent-ui/ui-component-framework/pull/563)).

package/docs/resources/release-notes/0.0.1-beta.168/content.md

@@ -0,0 +1,7 @@
+# 0.0.1-beta.168 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.168)
+
+ProgressSegmented removes the deprecated total prop; use segments to set the segment count.
+
+## Breaking changes
+
+**[ProgressSegmented](https://design.candescent.com/docs/components/progress-segmented/content.md)** — The deprecated `total` prop is removed. Use `segments` to set the number of segments instead. Replace any `total={n}` usage with `segments={n}` before upgrading ([#539](https://github.com/dfh-candescent-ui/ui-component-framework/pull/539)).

package/docs/resources/release-notes/0.0.1-beta.169/content.md

@@ -0,0 +1,7 @@
+# 0.0.1-beta.169 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.169)
+
+@cdx-ui/styles adds MUI and CDS CSS bridges and a ./theming entry point so Forge UI and MUI can share FI theme overrides.
+
+## What's new
+
+**@cdx-ui/styles** — The package now ships CSS bridge stylesheets and runtime APIs for running Forge UI alongside MUI 6+ or `@cds/theme` with shared FI theme overrides. Import `@cdx-ui/styles/mui.css` or `@cdx-ui/styles/cds.css` to map Forge semantic tokens onto MUI CSS variables, and use `expandThemeOverride` with `toMuiThemeOptions` and `MUI_SEMANTIC_MAPPINGS` to derive MUI theme options from a `ThemeOverride` payload. A new `@cdx-ui/styles/theming` subpath exposes the same override APIs with a platform-conditioned `applyThemeOverride`. The parser now honors `SUPPORTED_OVERRIDE_SCHEMA_VERSIONS`, synchronizes MUI bridge runtime colors with live overrides, and preserves optional CDS relative-color channel mappings ([#574](https://github.com/dfh-candescent-ui/ui-component-framework/pull/574)).

package/docs/resources/release-notes/0.0.1-beta.171/content.md

@@ -0,0 +1,16 @@
+# 0.0.1-beta.171 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.171)
+
+Slider supports two-thumb range selection with array value, per-thumb labels, and vertical orientation.
+
+## What's new
+
+**[Slider](https://design.candescent.com/docs/components/slider/content.md)** — Select a numeric interval with two draggable thumbs. Pass an array to `value` or `defaultValue` and handle updates through `onChange`. Set an explicit `index` on each `Slider.Thumb` (`0` and `1`) and give each thumb a distinct `accessibilityLabel` so screen readers can tell minimum from maximum. Range mode works in both horizontal and vertical orientations, and step marks fill between the two thumb values.
+
+```tsx
+<Slider value={[20, 80]} onChange={setRange}>
+  <Slider.Thumb index={0} accessibilityLabel="Minimum price" />
+  <Slider.Thumb index={1} accessibilityLabel="Maximum price" />
+</Slider>
+```
+
+Reach for range sliders when users need to filter or configure a bounded interval — price ranges, date windows, or any min/max pair ([#517](https://github.com/dfh-candescent-ui/ui-component-framework/pull/517)).

package/docs/resources/release-notes/0.0.1-beta.172/content.md

@@ -0,0 +1,24 @@
+# 0.0.1-beta.172 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.172)
+
+Adds Accordion for expandable single- or multi-select disclosure sections with compound trigger and content slots.
+
+## What's new
+
+**Accordion** — Show and hide related content in stacked sections. Set `type` to `"single"` for one open item at a time or `"multiple"` for independent toggles, and control expansion with `value`, `defaultValue`, and `onValueChange`. Each `Accordion.Item` needs a stable `value`; compose the trigger with `Accordion.Trigger`, `Accordion.Label`, `Accordion.Title`, and `Accordion.Description`, and place revealed content in `Accordion.Content`. Use `fullBleed` and `showSeparator` on items to match your layout, and pass `asChild` to `Accordion.Trigger` when the trigger should be a custom pressable.
+
+```tsx
+<Accordion type="single" collapsible defaultValue="shipping" aria-label="Policies">
+  <Accordion.Item value="shipping">
+    <Accordion.Trigger>
+      <Accordion.Label>
+        <Accordion.Title>Shipping policy</Accordion.Title>
+      </Accordion.Label>
+    </Accordion.Trigger>
+    <Accordion.Content>
+      <Text>Free shipping on orders over $50.</Text>
+    </Accordion.Content>
+  </Accordion.Item>
+</Accordion>
+```
+
+Reach for Accordion in FAQs, settings groups, and any flow where users scan headings and expand only what they need ([#558](https://github.com/dfh-candescent-ui/ui-component-framework/pull/558)).

package/docs/resources/release-notes/0.0.1-beta.173/content.md

@@ -0,0 +1,15 @@
+# 0.0.1-beta.173 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.173)
+
+Theme editor adopts Forge UI instead of MUI, Select shares Menu surface behavior, and ForgeDesignProvider no longer loops on safe-area updates.
+
+This release rebuilds `@cdx-ui/theme-editor` on Forge UI, aligns **[Select](https://design.candescent.com/docs/components/select/content.md)** dropdown presentation with **[Menu](https://design.candescent.com/docs/components/menu/content.md)**, and fixes an infinite re-render in `ForgeDesignProvider` on web.
+
+## What's new
+
+**@cdx-ui/theme-editor** — The theme editor UI is now built with Forge UI components instead of MUI. If you embed the editor in a Forge UI app, you no longer need MUI alongside it for the editor controls to render ([#579](https://github.com/dfh-candescent-ui/ui-component-framework/pull/579)).
+
+**[Select](https://design.candescent.com/docs/components/select/content.md)** — Dropdown behavior merges into the **[Menu](https://design.candescent.com/docs/components/menu/content.md)** surface, so open-state visuals and interaction patterns align with Menu across your app ([#579](https://github.com/dfh-candescent-ui/ui-component-framework/pull/579)).
+
+## Bug fixes
+
+**ForgeDesignProvider** — Stabilizes safe-area inset updates and ignores equivalent inset objects so web resize listeners no longer trigger an unbounded render loop ([#579](https://github.com/dfh-candescent-ui/ui-component-framework/pull/579)).

package/docs/resources/release-notes/0.0.1-beta.174/content.md

@@ -0,0 +1,7 @@
+# 0.0.1-beta.174 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.174)
+
+Icons and checkbox selection groups no longer trigger web accessibility console warnings.
+
+## Bug fixes
+
+**Icons**, **[Checkbox](https://design.candescent.com/docs/components/checkbox/content.md)**, and **[Bottom Sheet](https://design.candescent.com/docs/components/bottom-sheet/content.md)** — `createForgeIcon` now sets platform-appropriate accessibility props, and checkbox selection groups expose accessible names, so decorative icons and grouped checkboxes no longer emit web accessibility console warnings ([#585](https://github.com/dfh-candescent-ui/ui-component-framework/pull/585)).

package/docs/resources/release-notes/0.0.1-beta.176/content.md

@@ -0,0 +1,32 @@
+# 0.0.1-beta.176 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.176)
+
+Finalizes Accordion composition with a single Content slot and fixes Form web data-attribute warnings and Accordion focus rings.
+
+This release finalizes the **[Accordion](https://design.candescent.com/docs/components/accordion/content.md)** composition API, fixes focus-ring clipping on accordion items, and stops invalid DOM prop warnings when using **[Form](https://design.candescent.com/docs/components/form/content.md)** on web.
+
+## What's new
+
+**[Accordion](https://design.candescent.com/docs/components/accordion/content.md)** — Replaces the separate `Accordion.Panel` and `Accordion.Body` slots with a single `Accordion.Content` region and aligns state, layout, and composition props with other compound components. Compose each item with `Accordion.Trigger`, `Accordion.Label`, and `Accordion.Title`, add context with `Accordion.Description`, `Accordion.LeadingSlot`, and `Accordion.Meta`, and place revealed content in `Accordion.Content`. Set `type` to `"single"` or `"multiple"`, control expansion with `value`, `defaultValue`, and `onValueChange`, and use `fullBleed` on items when the accordion sits inside an already-padded surface.
+
+```tsx
+<Accordion type="single" collapsible defaultValue="shipping" aria-label="Policies">
+  <Accordion.Item value="shipping">
+    <Accordion.Trigger>
+      <Accordion.Label>
+        <Accordion.Title>Shipping policy</Accordion.Title>
+      </Accordion.Label>
+    </Accordion.Trigger>
+    <Accordion.Content>
+      <Text>Free shipping on orders over $50.</Text>
+    </Accordion.Content>
+  </Accordion.Item>
+</Accordion>
+```
+
+Reach for Accordion in FAQs, settings groups, and any flow where users scan headings and expand only what they need ([#589](https://github.com/dfh-candescent-ui/ui-component-framework/pull/589)).
+
+## Bug fixes
+
+**[Accordion](https://design.candescent.com/docs/components/accordion/content.md)** — Focus rings no longer clip at item boundaries ([#589](https://github.com/dfh-candescent-ui/ui-component-framework/pull/589)).
+
+**[Form](https://design.candescent.com/docs/components/form/content.md)** — Translates React Native Web data attributes before they reach the host `<form>` element, so invalid DOM prop warnings no longer appear on web ([#589](https://github.com/dfh-candescent-ui/ui-component-framework/pull/589)).

package/docs/resources/release-notes/0.0.1-beta.179/content.md

@@ -0,0 +1,11 @@
+# 0.0.1-beta.179 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.179)
+
+Theme customization now uses explicit ThemeOverride inputs, selections, and token overrides instead of bundled preset themes.
+
+## What's new
+
+**@cdx-ui/styles** — Bundled theme presets are replaced by the `ThemeOverride` model. Declare generative inputs, semantic selections, and optional per-token overrides; `applyThemeOverride` and `expandThemeOverride` expand that intent against the base theme and write sparse runtime CSS variables. Target adapters such as `toUniwindMaps` and `toMuiThemeOptions` consume the expanded result. Migrate any integration that applied a preset name to a persisted `ThemeOverride` document ([#593](https://github.com/dfh-candescent-ui/ui-component-framework/pull/593)).
+
+**@cdx-ui/theme-editor** — The editor authors complete `ThemeOverride` JSON through generative controls instead of selecting a preset theme. `onChange` debounces the override document for persistence, and `initialValue` rehydrates a saved override for editing ([#593](https://github.com/dfh-candescent-ui/ui-component-framework/pull/593)).
+
+**useForgeFonts** (`@cdx-ui/native`) — Display font loading follows the catalog from `@cdx-ui/styles`, keeping loaded families aligned with the display font your override selects ([#593](https://github.com/dfh-candescent-ui/ui-component-framework/pull/593)).

package/docs/resources/release-notes/0.0.1-beta.182/content.md

@@ -0,0 +1,13 @@
+# 0.0.1-beta.182 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.182)
+
+CurrencyInput now accepts returnKeyType to control the keyboard return key on mobile.
+
+This release adds `returnKeyType` to **[CurrencyInput](https://design.candescent.com/docs/components/currency-input/content.md)** and reorganizes the docs site navigation for blocks, patterns, foundations, and tokens.
+
+## What's new
+
+**[CurrencyInput](https://design.candescent.com/docs/components/currency-input/content.md)** — Accepts a `returnKeyType` prop so you can set the keyboard return key label and behavior on mobile—for example, `done` on the last field in a form or `next` when tabbing between amount inputs. Pass the same values supported by React Native `TextInput` ([#616](https://github.com/dfh-candescent-ui/ui-component-framework/pull/616)).
+
+## Documentation
+
+**Docs site navigation** — Reorganizes blocks, patterns, foundations, and token guides under a clearer information architecture ([#614](https://github.com/dfh-candescent-ui/ui-component-framework/pull/614)).

package/docs/resources/release-notes/0.0.1-beta.185/content.md

@@ -0,0 +1,7 @@
+# 0.0.1-beta.185 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.185)
+
+New Table compound component for presenting tabular data with header, body, footer, and cell sub-components on web and native.
+
+## What's new
+
+**[Table](https://design.candescent.com/docs/components/table/content.md)** — A presentational compound component for displaying tabular data with consistent Forge styling on web and native. Compose `Table.Caption`, `Table.Header`, `Table.Body`, and `Table.Footer` with `Table.Row`, `Table.Head`, and `Table.Cell` sub-slots. On web it renders semantic table markup inside a horizontally scrollable wrapper; on native it uses a flex layout with accessible row and cell roles. Set `fullBleed` on the root when the table should align flush with its container. Sorting, filtering, and pagination stay in your app — pair with a headless table library when you need interactive data-table behavior ([#604](https://github.com/dfh-candescent-ui/ui-component-framework/pull/604)).

package/docs/resources/release-notes/0.0.1-beta.187/content.md

@@ -0,0 +1,27 @@
+# 0.0.1-beta.187 (https://design.candescent.com/docs/resources/release-notes/0.0.1-beta.187)
+
+Adds @cdx-ui/data-grid for web tabular data, plus Table and TablePagination components for data-heavy screens.
+
+This release introduces the web **DataGrid** package and adds **[Table](https://design.candescent.com/docs/components/table/content.md)** and **[TablePagination](https://design.candescent.com/docs/components/table-pagination/content.md)** for building data-heavy screens in Forge UI.
+
+## What's new
+
+**[DataGrid](https://design.candescent.com/docs/components/data-grid/content.md)** — New `@cdx-ui/data-grid` package for web apps. It exposes a MUI Community–shaped `rows` / `columns` API with sorting, filtering, row selection, loading skeleton rows, sticky headers, and toolbar actions. Control pagination with `paginationModel` and optional `pageSizeOptions`. Install alongside `@cdx-ui/components`:
+
+```tsx
+import { DataGrid, type GridColDef } from '@cdx-ui/data-grid';
+```
+
+([#603](https://github.com/dfh-candescent-ui/ui-component-framework/pull/603)).
+
+**[Table](https://design.candescent.com/docs/components/table/content.md)** — Compound table for presenting row and column data on web and native. Compose `Table.Root`, `Table.Header`, `Table.Body`, `Table.Row`, and `Table.Cell`. Cells accept a logical `align` prop (`start`, `center`, `end`) that maps to platform-appropriate alignment ([#603](https://github.com/dfh-candescent-ui/ui-component-framework/pull/603)).
+
+**[TablePagination](https://design.candescent.com/docs/components/table-pagination/content.md)** — Footer pagination for tables and grids. Compose page navigation, a row-count label, and a page-size selector with sub-components such as `TablePagination.Root`, `TablePagination.Page`, and `TablePagination.PageSize`. DataGrid wires this in automatically when you pass `paginationModel` ([#603](https://github.com/dfh-candescent-ui/ui-component-framework/pull/603)).
+
+**[Chip](https://design.candescent.com/docs/components/chip/content.md)** — Styling updates for chips rendered in table and grid rich cell layouts ([#603](https://github.com/dfh-candescent-ui/ui-component-framework/pull/603)).
+
+## Dependencies
+
+**@cdx-ui/\* packages** — All published packages release at `0.0.1-beta.187`. Upgrade every `@cdx-ui/*` dependency in your app to this version together.
+
+**@cdx-ui/data-grid** — The new DataGrid package is available at `0.0.1-beta.187`. Add it to web apps that render tabular data with Forge UI.

package/docs/resources/release-notes/0.1.1/content.md

@@ -0,0 +1,23 @@
+# 0.1.1 (https://design.candescent.com/docs/resources/release-notes/0.1.1)
+
+Forge UI moves from 0.0.1-beta.188 to 0.1.1 on the 0.x line; update every @cdx-ui/* package to the new version together.
+
+This release moves Forge UI to the 0.1.1 release line, updates **[InsuranceDisclosure](https://design.candescent.com/docs/components/insurance-disclosure/content.md)** styling and accessibility for custom logos, and fixes iOS Safari focus zoom on form fields.
+
+## What's new
+
+**Versioning** — Forge UI moves from `0.0.1-beta.188` to `0.1.1` on the normal 0.x release line. All `@cdx-ui/*` package versions remain synchronized. Update every installed `@cdx-ui/*` package to `0.1.1` together ([#620](https://github.com/dfh-candescent-ui/ui-component-framework/pull/620)).
+
+**[InsuranceDisclosure](https://design.candescent.com/docs/components/insurance-disclosure/content.md)** — Styling aligns with the current design spec for framed and logo-only layouts. When you pass a custom `logoSource`, you must also supply `logoAccessibilityLabel` so the logo remains accessible ([#608](https://github.com/dfh-candescent-ui/ui-component-framework/pull/608)).
+
+## Bug fixes
+
+**[Input](https://design.candescent.com/docs/components/input/content.md)** — Web text renders at 16px on viewports below 600px so iOS Safari no longer zooms when the field receives focus ([#497](https://github.com/dfh-candescent-ui/ui-component-framework/pull/497)).
+
+**[Select](https://design.candescent.com/docs/components/select/content.md)** — Web value text renders at 16px on viewports below 600px to match Input and Textarea and prevent iOS Safari focus zoom ([#497](https://github.com/dfh-candescent-ui/ui-component-framework/pull/497)).
+
+**[Textarea](https://design.candescent.com/docs/components/textarea/content.md)** — Web text renders at 16px on viewports below 600px so iOS Safari no longer zooms when the field receives focus ([#497](https://github.com/dfh-candescent-ui/ui-component-framework/pull/497)).
+
+## Dependencies
+
+**@cdx-ui/\* packages** — All published packages release at `0.1.1`. Upgrade every `@cdx-ui/*` dependency in your app to this version together.

package/docs/resources/release-notes/0.1.2/content.md

@@ -0,0 +1,7 @@
+# 0.1.2 (https://design.candescent.com/docs/resources/release-notes/0.1.2)
+
+Radio supports a read-only state for showing a selected option without allowing changes.
+
+## What's new
+
+**[Radio](https://design.candescent.com/docs/components/radio/content.md)** — Radio and `Radio.Group` accept a `readOnly` prop so you can display the current selection without letting users change it. Use it in review screens, confirmation flows, or anywhere a choice is visible but not editable. Read-only radios keep their selected appearance and skip pointer interaction while remaining in the accessibility tree ([#631](https://github.com/dfh-candescent-ui/ui-component-framework/pull/631)).

package/docs/resources/release-notes/0.1.4/content.md

@@ -0,0 +1,19 @@
+# 0.1.4 (https://design.candescent.com/docs/resources/release-notes/0.1.4)
+
+Per-face font utilities are removed on web—use typography composites with font-weight. Adds Drawer, Menu filter rows, Avatar variants, and banking icons.
+
+This release fixes how font tokens resolve on web, ships a new Drawer overlay, and extends Menu, Avatar, and the icon set for banking UIs.
+
+## Breaking changes
+
+**Font tokens on web** — Per-face font family utilities (`font-sans-medium`, `font-body-semibold`, `font-display-bold`, and their `-italic` variants) no longer generate CSS. They only set `font-family`, and on the browser path those face names did not match registered families, so text fell back to the default serif or ignored weight. Use composite typography utilities for the family and standard weight utilities for emphasis, for example `body-md font-medium` instead of `font-sans-medium`. The underlying `--font-*-medium` CSS variables are unchanged, so `[font-family:var(--font-sans-medium)]` still works when you genuinely need a face family. **`useForgeFonts`** from `@cdx-ui/native` is native-only and a no-op on web; browser apps must register fonts themselves (see **Fonts on web** in the developer getting-started guide). `@cdx-ui/styles` adds `forgeWebFontSpec`, `buildWebFontProviderUrl`, and `loadForgeWebFonts` so web registration stays aligned with the token pipeline ([#656](https://github.com/dfh-candescent-ui/ui-component-framework/pull/656)).
+
+## What's new
+
+**[Drawer](https://design.candescent.com/docs/components/drawer/content.md)** — A compound overlay for secondary flows, filters, and navigation that slides in from any edge. Compose `Drawer`, `Drawer.Content`, `Drawer.Header`, `Drawer.Title`, `Drawer.Description`, `Drawer.Footer`, and `Drawer.Close`; pick side and size props on the root. `Drawer.Header` lays out a leading slot, a text column, and a close control (a default close renders unless you pass `close={null}` or a custom node) ([#644](https://github.com/dfh-candescent-ui/ui-component-framework/pull/644)).
+
+**[Menu](https://design.candescent.com/docs/components/menu/content.md)** — Filter and action menus can place leading controls and trailing actions on each row via `Menu.GroupHeader`, `Menu.ItemControl`, `Menu.ItemCount`, and `Menu.ItemAction`. Tab focus stays inside overlay menus that include header actions, and pointer deselect no longer leaves a selected background on unchecked checkbox rows (keyboard focus still uses the focus-visible fill). The unused `size` prop is removed from Menu; **[Select](https://design.candescent.com/docs/components/select/content.md)** keeps its own `size` for option padding ([#655](https://github.com/dfh-candescent-ui/ui-component-framework/pull/655)).
+
+**[Avatar](https://design.candescent.com/docs/components/avatar/content.md)** — `color`, `variant`, and `shape` props align with design for initials, icons, and photos in circle or rounded forms. **[Chip](https://design.candescent.com/docs/components/chip/content.md)** respects the avatar shape when an avatar is embedded ([#661](https://github.com/dfh-candescent-ui/ui-component-framework/pull/661)).
+
+**@cdx-ui/icons** — The custom icon set from the Figma library (excluding logos) is complete, with banking, cash, deposit, passport, and related glyphs in outlined and filled styles ([#642](https://github.com/dfh-candescent-ui/ui-component-framework/pull/642)).

package/docs/resources/release-notes/0.1.5/content.md

@@ -0,0 +1,7 @@
+# 0.1.5 (https://design.candescent.com/docs/resources/release-notes/0.1.5)
+
+Figma Code Connect templates now cover Switch, progress, tabs, tiles, dates, toasts, sliders, and other components for Dev Mode snippets.
+
+## What's new
+
+**Figma Code Connect** — `@cdx-ui/components` ships Code Connect mappings for components that previously had no Dev Mode snippet, so design and engineering see Forge UI imports and props that match the library. New templates cover **Switch**, **ProgressBar**, **ProgressCircle**, **Tabs** and **Tabs.Tab** (with **SegmentedControl** mapped to the solid tabs variant), the **Tile** compound family, **Image**, **Carousel**, **Skeleton**, the **Slider** family, **Tooltip**, **Toast** (including button and close slots, with `toast.show()` config when Figma props map cleanly), **CurrencyInput**, calendar surfaces (**Calendar**, **MonthCalendar**, **RangeCalendar**), **DateField**, **DateTimeField**, **DatePicker**, **DateRangePicker**, **Checkbox.Group** with **Field** wrappers, and **VirtualizedList** (for **FlatList** in Figma). Publish or refresh Code Connect from your Figma library when you upgrade so Dev Mode stays aligned with 0.1.5 ([#678](https://github.com/dfh-candescent/forge-design-system/pull/678)).

package/docs/resources/release-notes/0.1.6/content.md

@@ -0,0 +1,7 @@
+# 0.1.6 (https://design.candescent.com/docs/resources/release-notes/0.1.6)
+
+Adds ToggleButton and ToggleButtonGroup for persistent pressed states and single- or multi-select toolbar controls on web and native.
+
+## What's new
+
+**[Toggle Button](https://design.candescent.com/docs/components/toggle-button/content.md)** — `@cdx-ui/components` exports a compound **ToggleButton** for actions that stay pressed after selection, with **ToggleButton.Label**, **ToggleButton.Icon** (`position="leading"` or `"trailing"`), and **ToggleButtonGroup** for grouped choices. Use a group with `type="single"` for one selection at a time (radio-like) or `type="multiple"` for several pressed buttons; drive selection with `value` and `onValueChange`, or control an individual toggle with `isSelected` and `onSelectedChange`. Attached groups render as a segmented control (`isAttached`, default `true`); set `orientation="vertical"` for stacked layouts with arrow-key navigation in document order. Icon-only toggles need `accessibilityLabel`; selected toggles use the filled icon variant. Sizing and variants align with **Button** ([#667](https://github.com/dfh-candescent/forge-design-system/pull/667)).

package/docs/resources/release-notes/0.2.0/content.md

@@ -0,0 +1,31 @@
+# 0.2.0 (https://design.candescent.com/docs/resources/release-notes/0.2.0)
+
+Native font embedding and per-face utilities removed; adds color picker family, semantic Text/Icon colors, and ToggleButton.Group compound API.
+
+This release reshapes how fonts register on native, removes several deprecated APIs, and adds a full color-picker toolkit plus semantic coloring on **[Text](https://design.candescent.com/docs/components/text/content.md)** and **[Icon](https://design.candescent.com/docs/components/icon/content.md)**.
+
+## Breaking changes
+
+**Font tokens and native embedding** — Font tokens now name one family per role (`sans`, `mono`, `display`, `body`); weight and style are separate on every platform. The per-face CSS variables and utilities (`font-sans-medium`, `font-display-bold-italic`, and similar) are removed. Replace them with the role family (`font-sans`, `font-display`, …) plus `font-medium`, `font-semibold`, `font-bold`, and `italic`. Theme overrides that targeted per-face tokens should set only the role family. On native, `@cdx-ui/native` ships an Expo config plugin that embeds the Forge font catalog at build time: add `"@cdx-ui/native"` to `expo.plugins` in `app.json`, run `npx expo prebuild` or a new dev/EAS build (Expo Go cannot load the embedded fonts), and remove any `useForgeFonts` call and loading gate—the hook is deprecated and resolves immediately without loading faces ([#450](https://github.com/dfh-candescent/forge-design-system/pull/450)).
+
+**`ToggleButtonGroup` export** — `ToggleButtonGroup` is no longer exported from `@cdx-ui/components`. Use **`ToggleButton.Group`** instead; `ToggleButtonGroupProps` remains exported as a type ([#763](https://github.com/dfh-candescent/forge-design-system/pull/763)).
+
+**`CdxIcon` aliases** — `createCdxIcon`, `CdxIcon`, and `CdxIconProps` are removed from `@cdx-ui/icons`. Replace them with `createForgeIcon`, `ForgeIcon`, and `ForgeIconProps` ([#750](https://github.com/dfh-candescent/forge-design-system/pull/750)).
+
+**Text and Icon `color` prop** — **[Text](https://design.candescent.com/docs/components/text/content.md)** and **[Icon](https://design.candescent.com/docs/components/icon/content.md)** accept a typed `color` prop (`primary`, `secondary`, `tertiary`, `action`, `danger`, `warning`, `success`, `info`) mapped to design tokens. Slot sub-components that already set their own label or icon color (for example inside **[Button](https://design.candescent.com/docs/components/button/content.md)** or **[Alert](https://design.candescent.com/docs/components/alert/content.md)**) no longer accept `color` on those slots—pass `color` on the leaf **Text** or **Icon** instead, or rely on the parent’s default ([#753](https://github.com/dfh-candescent/forge-design-system/pull/753)).
+
+## What's new
+
+**Color picker family** — `@cdx-ui/primitives` and `@cdx-ui/components` ship a coordinated set for choosing colors in forms and theme tools. **[ColorPicker](https://design.candescent.com/docs/components/color-picker/content.md)** composes a trigger with popover content; **[ColorArea](https://design.candescent.com/docs/components/color-area/content.md)** and **[ColorSlider](https://design.candescent.com/docs/components/color-slider/content.md)** adjust two-dimensional and one-dimensional channels; **[ColorField](https://design.candescent.com/docs/components/color-field/content.md)** edits a color as text; **[ColorSwatch](https://design.candescent.com/docs/components/color-swatch/content.md)** shows a swatch, and **[ColorSwatchPicker](https://design.candescent.com/docs/components/color-swatch-picker/content.md)** offers a grid of choices. Primitives expose the behavioral roots; styled compounds add Forge tokens and layout. Use **`ColorPicker`** when you need a compact control with a popover, or compose **ColorArea** and **ColorSlider** directly for custom layouts ([#736](https://github.com/dfh-candescent/forge-design-system/pull/736)).
+
+**[Text](https://design.candescent.com/docs/components/text/content.md)** — `weight` (`normal`, `medium`, `semibold`, `bold`) and `italic` props map to the registered body family on web and native, so emphasis no longer requires per-face utility classes. Nested **Text** inherits `color`, `size`, and `weight` from an ancestor text context unless you override them explicitly ([#450](https://github.com/dfh-candescent/forge-design-system/pull/450)).
+
+**[Toast](https://design.candescent.com/docs/components/toast/content.md)** — Toast surfaces use semantic background and foreground tokens aligned to Figma. On web, pointer events pass through the toast viewport so underlying controls stay clickable while toasts are visible ([#759](https://github.com/dfh-candescent/forge-design-system/pull/759)).
+
+**[Toggle Button](https://design.candescent.com/docs/components/toggle-button/content.md)** — Grouped toggles use **`ToggleButton.Group`** on the compound, consistent with **`Radio.Group`**. Props and behavior match the former standalone group component ([#763](https://github.com/dfh-candescent/forge-design-system/pull/763)).
+
+## Bug fixes
+
+**[Text](https://design.candescent.com/docs/components/text/content.md)** — Nested **Text** follows React Native’s text-ancestor context, so copy inside **[Heading](https://design.candescent.com/docs/components/heading/content.md)**, **Button.Label**, **Alert.Description**, and other text parents inherits typography correctly; a **Text** inside a **View** inside **Text** gets defaults on native where **View** resets the context. Size-only nesting keeps the parent weight instead of resetting to normal ([#758](https://github.com/dfh-candescent/forge-design-system/pull/758)).
+
+**[Icon](https://design.candescent.com/docs/components/icon/content.md)** — A raw hex or other non-semantic `color` value again tints the SVG (with a one-time development warning), restoring behavior for icon slots that spread props into **Icon** ([#758](https://github.com/dfh-candescent/forge-design-system/pull/758)).