@cdx-ui/components 0.3.5 → 0.3.7

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

@@ -0,0 +1,29 @@
+# 0.3.6 (https://design.candescent.com/docs/resources/release-notes/0.3.6)
+
+Adds SystemAlert, bar, line, and pie charts on a shared MUI X-shaped API, Stepper, and a fix for tabs scroll controls.
+
+This release ships SystemAlert, bar, line, and pie charts on a shared MUI X-shaped contract, Stepper, and a fix for tabs scroll controls.
+
+## What's new
+
+**[SystemAlert](https://design.candescent.com/docs/components/system-alert/content.md)** — A full-bleed banner on a strong semantic surface for app-wide warnings and status messages. Set `color` to match severity, compose `SystemAlert.Icon`, `SystemAlert.Description`, and trailing actions or `SystemAlert.Close`, and use `isOpen` with `onOpenChange` for controlled enter and exit motion. `hasSafeAreaInset` extends the banner behind the status bar; pair it with `useSystemAlertStatusBarStyle` so status-bar glyphs stay readable on the banner’s on-strong text ([#866](https://github.com/dfh-candescent/forge-design-system/pull/866)).
+
+**[BarChart](https://design.candescent.com/docs/components/bar-chart/content.md)**, **[LineChart](https://design.candescent.com/docs/components/line-chart/content.md)**, and **[PieChart](https://design.candescent.com/docs/components/pie-chart/content.md)** — Cross-platform charts that follow an MUI X Charts–shaped API: pass a `dataset`, define `series` with `dataKey`, and configure `xAxis` and `yAxis` arrays. Bar charts support stacking, waterfall, and overlay series; line charts support curves, areas, and markers; pie charts support donut radii and slice formatters. Selection uses `selectedItem` and `onSelectedItemChange`; tooltips, locale formatters, and `palette` (`auto` or `categorical`) resolve through the shared chart kit ([#867](https://github.com/dfh-candescent/forge-design-system/pull/867)).
+
+**[Stepper](https://design.candescent.com/docs/components/stepper/content.md)** — Shows progress through a linear or non-linear sequence with vertical or horizontal layout. Use `orientation`, `labelPlacement` (`end` or `bottom` on horizontal steppers), and `onStepChange` with `isLinear` to let users jump to completed or allowed steps. Compound parts include `Stepper.Step`, `Stepper.StepLabel`, `Stepper.StepContent`, and optional custom indicators ([#839](https://github.com/dfh-candescent/forge-design-system/pull/839)).
+
+## Bug fixes
+
+**[Tabs](https://design.candescent.com/docs/components/tabs/content.md)** — The trailing scroll control stays hidden when the tab list is already scrolled to the end ([#892](https://github.com/dfh-candescent/forge-design-system/pull/892)).
+
+## Dependencies
+
+Upgrade every installed `@cdx-ui/*` package to `0.3.6` together when you adopt this release.
+
+## Documentation
+
+Insights pattern category with chart and table insight examples ([#889](https://github.com/dfh-candescent/forge-design-system/pull/889)).
+
+Bar and line chart color demos use horizontal scrolling tabs ([#887](https://github.com/dfh-candescent/forge-design-system/pull/887)).
+
+LLM markdown and text artifacts on the docs site are served as UTF-8 in production ([#890](https://github.com/dfh-candescent/forge-design-system/pull/890)).

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

@@ -8,6 +8,8 @@ Notes are generated from the release commit itself, so the versions and commit r
 each entry are exact. Releases that contained nothing but backlog or dependency bookkeeping
 are omitted.
 
+- [0.3.6](https://design.candescent.com/docs/resources/release-notes/0.3.6/content.md) — 2026-10-23 — Adds SystemAlert, bar, line, and pie charts on a shared MUI X-shaped API, Stepper, and a fix for tabs scroll controls.
+- [0.3.5](https://design.candescent.com/docs/resources/release-notes/0.3.5/content.md) — 2026-10-21 — Selected subtle Chip labels stay visible on Android when the variant changes from outline to subtle.
 - [0.3.4](https://design.candescent.com/docs/resources/release-notes/0.3.4/content.md) — 2026-10-20 — Select adds multiple selection, in-list search, and a native bottom sheet; Input gains a subtle variant for fields inside popups and sheets.
 - [0.3.3](https://design.candescent.com/docs/resources/release-notes/0.3.3/content.md) — 2026-10-15 — Insight and InsightStack add dismissible summary cards with status colors, optional AI styling, and stacked depth for insight feeds.
 - [0.3.2](https://design.candescent.com/docs/resources/release-notes/0.3.2/content.md) — 2026-10-13 — CurrencyInput adds an outline variant for bordered amount fields; BottomSheet opens reliably in optimized web production builds.

package/docs/resources/skills/content.md

@@ -0,0 +1,66 @@
+# Agent skills (https://design.candescent.com/docs/resources/skills)
+
+Forge UI agent skills give AI coding assistants such as Claude Code and Cursor the context they need to build with `@cdx-ui/*` packages. Agents learn to compose components as they ship instead of restyling them to match a mockup, which breaks FI theming and dark mode.
+
+With the skills installed, you can ask your agent things like:
+
+- "Build the account settings screen from this Figma link."
+- "Add Forge UI to this Expo app."
+- "Upgrade our `@cdx-ui` packages to the latest release."
+- "Review this pull request for Forge UI style overrides."
+
+## Install
+
+Install every Forge UI skill from this site with the [`skills`](https://github.com/vercel-labs/skills) CLI. It works with Claude Code, Cursor, Codex and other agents that support the [Agent Skills](https://agentskills.io) format:
+
+```bash
+npx skills add https://design.candescent.com
+```
+
+Skills install into the current project by default. Add `-g` to install them for every project, `-a <agent>` to pick the agent, or `--skill <name>` to install one skill. Run `npx skills add https://design.candescent.com --list` to see what is available without installing anything.
+
+Candescent teams can install the skills as a Claude Code plugin from the Forge Design System team marketplace:
+
+```bash
+claude plugin marketplace add dfh-candescent/design-system-team-marketplace
+claude plugin install forge-ui@fds-team-marketplace
+```
+
+The marketplace is a private Candescent repository. FI teams and other partners use the skills CLI.
+
+Candescent teams can install the skills as a Cursor plugin. Once an admin has imported the Forge Design System team marketplace, open **Customize**, find the FDS marketplace and install **Forge UI**. The plugin is opt-in.
+
+The Cursor plugin also adds a guardrail rule that applies to `.tsx` and `.jsx` files. It lists the hard bans and points the agent at the core skill.
+
+## Usage
+
+Agents load a skill automatically when your request matches its description, so most of the time you just ask. You can also invoke a skill by name, for example `/forge-ui` in Claude Code.
+
+| Skill              | Use it to                                                                                                                                                                                       |
+| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `forge-ui`         | Build or change UI with Forge UI: pick components, implement a Figma design, and style through props                                                                                            |
+| `forge-ui-setup`   | Wire Forge UI into a host app (Metro or Vite, CSS entry, fonts, providers) or a library package                                                                                                 |
+| `forge-ui-upgrade` | Move every `@cdx-ui/*` package to a new release, apply its migrations, and drop patches it made unnecessary                                                                                     |
+| `forge-ui-review`  | Audit a repo, directory, diff or pull request and report findings by impact level. Read-only unless you ask it to fix (`--fix`; never commits) or to comment (`--comment`; posts one PR review) |
+
+## How it works
+
+1. **Version-matched docs first.** Newer `@cdx-ui/components` releases ship this site's docs in a `docs/` folder. The skills search its `llms.txt` and read each page's `content.md` from `node_modules`, so the agent works from the docs for the version you have installed.
+2. **Installed types win.** The agent confirms every component, prop, variant and part in the installed `@cdx-ui/*` types before writing code. When the types and the skills disagree, it follows the types.
+3. **This site as a fallback.** For releases without a `docs/` folder, before the first install, and for newer release notes, the skills read the markdown version of this site.
+4. **Rules, then a self-check.** The core skill applies the [styling rules](https://design.candescent.com/docs/getting-started/developers/styling/content.md): appearance comes from props, `className` is placement only, and colors are semantic tokens. Before it finishes, the agent checks its own output against them.
+5. **Gaps are flagged, not patched.** When the design needs something Forge UI doesn't ship, the agent uses the closest shipped option, leaves a `TODO(forge-ui)` comment and tells you what's missing.
+
+The skills reference only the installed packages and this site, never Forge UI's source code, so they work in any consumer repository.
+
+## Requirements
+
+The skills require `@cdx-ui` 0.2.0 or later, the release that added the `color` prop to `Text` and `Icon` and the `weight` and `italic` props to `Text`. On older releases, the skills suggest `forge-ui-upgrade` before writing code instead of teaching class-based workarounds.
+
+## Updating
+
+Run `npx skills update` to pull the latest skills from this site. Claude Code and Cursor plugins update through their marketplace.
+
+## Without the skills
+
+Every page on this site is also available as markdown: add `/content.md` to the page URL. `/llms.txt` indexes every page that way, and `/llms-full.txt` holds them all in one file. If your agent doesn't support skills, point its instructions file at the [styling page](https://design.candescent.com/docs/getting-started/developers/styling/content.md#for-ai-coding-agents) instead.