# 版本发布

> 查看 chroma-panel React 颜色选择器的更新日志，找到每个稳定版本，试用 canary 版本，并了解哪些改动算作破坏性变更。

Source: https://chroma-panel.jscrate.dev/zh/react/overview/releases
Last updated: 2026-09-21

chroma-panel 最新的版本排在最前面。先通过发布说明确认改了什么，再按对应版本的升级命令操作。

- **1.0.1** (2026-09-20, latest): https://github.com/re-sohail/chroma-panel/releases/tag/v1.0.1
  - Added detailed change-event information.
  - Improved accessibility, documentation, and package optimization.
  - Fixed minor issues found during final v1 testing.
- **1.0.0** (2026-09-20): https://github.com/re-sohail/chroma-panel/releases/tag/1.0.0
  - Added OKLCH, OKLab, Lab, LCH, sRGB and Display P3 support.
  - Added color conversion, serialization, gamut detection and gamut mapping.
  - Added an accessible linear/radial gradient editor.
  - Added perceptual OKLab/OKLCH gradient interpolation.
  - Added source-aware `onValueChange` and `onValueCommit` events.
  - Added alpha-aware contrast calculation and accessible-color suggestions.
  - Added CSS, SCSS, Tailwind and design-token exports.
  - Added clipboard image pasting.
- **0.2.0** (2026-09-20): https://github.com/re-sohail/chroma-panel/releases/tag/0.2.0
  - Documented exact image pixel picking and zoom preview.
  - Documented keyboard image selection.
  - Added image file-size and dimension safety limits.
  - Documented the new copy-color button and `showCopyButton` prop.
  - Updated the generated API reference.
  - Updated the landing-page image feature description.
- **0.1.4** (2026-09-20): https://github.com/re-sohail/chroma-panel/releases/tag/v0.1.4
  - Fixed the large gap below the palette search field.
  - Improved the palette search results layout.
  - Corrected the package size information across the website.
- **0.1.3** (2026-09-16): https://github.com/re-sohail/chroma-panel/releases/tag/v0.1.3
  - Updated the documentation with clearer and more accurate information.
  - Updated the images to improve visual quality and consistency.
- **0.1.2** (2026-09-16): https://github.com/re-sohail/chroma-panel/releases/tag/v0.1.2
  - Replaced “colour” with “color”.
  - Fixed small UI glitches and styling inconsistencies.
  - Improved overall stability and user experience.
- **0.1.1** (2026-09-14): https://github.com/re-sohail/chroma-panel/releases/tag/v0.1.1
  - Consistent spelling across the UI and docs.
  - Installing from a git URL now builds correctly.
- **0.1.0** (2026-09-14): https://github.com/re-sohail/chroma-panel/releases/tag/v0.1.0
  - Five ways to pick: wheel, sliders, palettes, pencils, image.
  - Keeps your exact color. No lost hue.
  - Works as a form input. Keyboard accessible.
  - No dependencies. Typed. ESM and CommonJS.

## Canary 版本

预发布版本以 `next` 标签发布，没有主动选择的人永远不会装到它们。要安装的话，请按名称指定：

```bash
npm install chroma-panel@next
```

这些版本在上面的时间线中带有 **Pre-release** 标记，而且永远不会被标为 **Latest**。请把它们当作预览版：canary 版本中的 API 在进入稳定版之前仍可能变化。

## 版本规则

本包遵循语义化版本。以下任何一项出现破坏性变更，都会发布主版本：

- [组件](https://chroma-panel.jscrate.dev/zh/react/components/color-input)部分文档中列出的 props
- 任意[入口](https://chroma-panel.jscrate.dev/zh/react/utils/entry-points)的导出内容
- `--cp-*` [CSS 自定义属性](https://chroma-panel.jscrate.dev/zh/react/handbook/theming)和 `data-cp-*` [属性](https://chroma-panel.jscrate.dev/zh/react/overview/accessibility#data-attributes)

API 参考中没有列出的内部类名不属于公开接口，可能在补丁版本中改动。

### 稳定版本

chroma-panel 于 2026 年 9 月 21 日发布 1.0。从现在起，有文档的 API 都遵循上面所说的主版本、次版本和补丁版本约定。如果你想获得修复和新功能，又不想自动引入破坏性变更，请锁定主版本范围。

```bash
npm install chroma-panel@^1.0.0
```

## 升级

```bash
npm install chroma-panel@latest
```

## 完整的发布说明

上面的时间线只列出每个版本的重点。完整的发布说明，包括每一次提交和每一位贡献者，都在 GitHub 上。

- [更新日志](https://github.com/re-sohail/chroma-panel/blob/main/CHANGELOG.md)：所有版本，集中在一个文件里
- [Releases](https://github.com/re-sohail/chroma-panel/releases)：GitHub 上的同一份说明，附带对应的标签
- [对比任意两个版本](https://github.com/re-sohail/chroma-panel/compare)
- npm 上的[所有已发布版本](https://www.npmjs.com/package/chroma-panel?activeTab=versions)