@5even7/dlc-ui 0.2.17 → 0.2.19

package/CHANGELOG.md

@@ -1,123 +1,147 @@
-# Changelog
-
-> **发版规则**：默认每次发布只递增补丁号（0.x.y → 0.x.(y+1)，即 +0.01）；除非手动明确指定新版本号，否则不升次版本。
-
-## 0.2.17 - 2026-08-15
-- Miao表情包优化展示，表情包拆分模块变更部分颜色属性
-
-## 0.2.16 - 2026-08-15
-- Miao表情包新增非等比填充模式，文档解释补充完善
-
-## 0.2.15 - 2026-08-14
-- 首个表情家族为 `type="miao"`，内置 23 个完整 Lottie 动作；素材生成阶段仍会校验并排除没有图层的空动画。
-
-## 0.2.14 - 2026-08-14
-- 新增dlc-emo表情包组件
-
-## 0.2.13 - 2026-08-14
-
-- 新增第四类组件 `dlc-emo`：H5 `createEmo()`、Vue 2 / Vue 3 `DlcEmo`，并提供独立 `@5even7/dlc-ui/emo` 与样式入口。
-- Emo 支持主色 / 辅助色、非正方形尺寸、contain / cover、0.1~4 倍速、循环、自动播放、正倒播、暂停、帧片段、透明度、背景色、SVG / Canvas 渲染器、无障碍名称与减少动态偏好。
-- 性能与兼容：SVG / Canvas 分别按需加载无表达式的 Lottie light 播放器，未创建 Emo 时不执行播放器代码，避免影响前三类组件与 SSR 导入。
-- 补齐 Emo 类型声明、默认值、控制器方法、生命周期事件和素材生成测试；素材没有稳定器官语义，因此未提供无法可靠生效的左眼 / 右眼等伪 API。
-- Progress 新增内置预置 `森息`（NC-14）：包含植物实验室色板、独立流体运动参数和参考图集配置，可直接使用 `preset="森息"`。
-- H5、Vue 2、Vue 3 示例将“植物实验室”改为由内置预置驱动，并在默认预置列表中展示 NC-14。
-- 文档明确 Capsule 的 `click` / `dblclick` 保持原生 H5 语义：双击会先伴随两次 `click`，组件不延迟或吞掉单击事件。
-
-## 0.2.11 - 2026-08-09
-
-- 修复：`--hj-text-bg` / `--hj-text-pad` 两个 cssVars 此前只在文档声明、组件 CSS 未引用，传了不生效；现在 Capsule / Progress 文字区容器真正支持背景与内边距变量（默认仍为透明 / 0，无视觉回归）。
-- 修复：Progress WebGL 路径下参考图集以全权重覆盖用户 `colors`，导致改主色 / 高光几乎无可见反馈；图集改为只提供亮度结构，颜色始终由 `colors`（底色 / 主色 / 辅色 / 高光）决定，Canvas2D 降级路径本就生效。
-- 文档：README / examples 修正过时描述（移除已废弃的键盘控制、自动加载文案；胶囊示例从"9 组"改为 6 组；示例页旧名 Cosmic Capsules 统一为 DLC）；`--hj-text-min-width` 默认值说明与实现一致（`textRatio` 生效时组件强制归零）。
-- 类型：`ProgressPreset` 移除运行时不存在的 `loadRate` 字段；`CapsuleController` 补 `setMouseColor()`；`ProgressController` 补 `setShowValue()`，与运行时控制器对齐。
-- 示例：examples 属性 / 方法说明补齐 `setMouseColor` / `setShowValue`，同步移除键盘 / 自动加载残留描述。
-
-## 0.2.10 - 2026-08-09
-
-- 修复：Vue wrapper 的插槽中转容器（`.hj-vue-slot-text` / `.hj-vue-slot-color`）此前带 `height: 100%`，插槽内容被搬进文字区/颜色区后，空壳仍会以宿主高度各撑出一个空块，把 Capsule / Progress 组件根整体往下推约 2×组件高度；改为 `display: none`，彻底脱离布局（对插槽搬运无影响）。
-
-## 0.2.9 - 2026-08-09
-
-- 修复：`/vue2`、`/vue3` 的 CJS 构建丢失默认导出（`require(...).default` 为 undefined，webpack/CommonJS 下 `import X from` 会拿到命名空间对象而不是组件）；legacy 入口现在转发默认导出，并带 `__esModule` 标记。
-- 对称补齐 Vue 组件实例方法：胶囊新增 `setMouseColor()`，进度条新增 `setShowValue()`（此前只有 Color 暴露了同类方法）。
-
-## 0.2.8 - 2026-08-09
-
-- 最终命名确认：官方组件导出为 `DlcCapsule / DlcProgress / DlcColor`（无中划线），模板中仍可直接写 `<dlc-capsule>` 等 kebab 写法（Vue 自动映射）；移除字符串形式的导出名，兼容 Vite/esbuild。
-
-## 0.2.7 - 2026-08-09
-
-- 修复：0.2.6 发布包未包含 mouseColor / showValue 热切换（watch 仍走重建），本轮真正启用 `setMouseColor()` / `setShowValue()`，开关不再重建组件、不丢插槽内容。
-- 组件更名：`CosmicCapsule → DlcCapsule`、`ProgressCapsule → DlcProgress`、`ColorBackground → DlcColor`（旧名保留为兼容别名，标记 deprecated；模板里也可写 `<dlc-capsule>` 等）。
-
-## 0.2.6 - 2026-08-09
-
-- 修复：Vue wrapper 重建组件时因“插槽容器搬移”导致组件树损坏（子组件丢失、mouseColor 开关无效）的问题；插槽改回搬子节点。
-- 胶囊 `mouseColor` 改为热切换（新增控制器 `setMouseColor()`，不再重建组件）；进度条 `showValue` 改为热切换（新增 `setShowValue()`，数字元素始终存在、按需隐藏）。
-
-## 0.2.5 - 2026-08-08
-
-- 修复：胶囊 `textRatio` 小于 164px（历史 `--hj-copy-min-width` 默认）时文字区不跟随缩小的 bug；现在 `textRatio` 是文字区宽度的唯一权威值，0~100 全范围生效。
-
-## 0.2.4 - 2026-08-08
-
-- 移除 Progress `keyboard` 属性与键盘控制（拖动/受控 value 已覆盖主要场景）。
-- 兼容性修复：legacy/IE11 路径补齐 `Array.prototype.find`、`String.prototype.endsWith`、`String.prototype.padStart` 缺失导致的崩溃（源码层也改为 ES5 写法）。
-- 控制器暴露值改为实时 getter（`textRatio` / `cssVars` / `opacity` / `fallbackColor` / `mouseColor`），热更新后读取不再过期，Vue 重建时状态继承更准确。
-- `setSize` 先校验再赋值，非法尺寸不再污染内部状态或抛进 Vue 更新流程。
-- `setRange` 与创建时的 `min/max` 在 min>max 时自动交换。
-- 结构属性连续变化时，重建后补一次插槽搬运（B3）。
-- Canvas2D 降级的 `randomize()` 额外随机相位，变化更明显；README 注明降级路径 `mouseColor` 不生效。
-
-## 0.2.3 - 2026-08-08
-
-- 修复：Vue wrapper 重建组件（如 showValue 开关）后插槽内容丢失的问题（插槽容器改为整体搬入文字区/颜色区）。
-- 修复：进度条点击后无法直接使用键盘方向键的问题（拖动开始时自动聚焦）。
-- 修复：胶囊 `textRatio=0` 时文字区仍因最小宽度 164px 占位的问题，现 0 即完全隐藏。
-- 新增 Progress `readonly` 属性：与 disabled 行为一致但不置灰（`aria-readonly`）。
-
-## 0.2.2 - 2026-08-08
-
-- 修复：Progress 的 `setLabel()` 对 const 变量重新赋值，导致打包产物被 esbuild 拒绝、文档站无法构建的问题；label 热更新恢复正常。
-
-## 0.2.1 - 2026-08-08
-
-- 移除 `copy` / `showCopy` 属性：文字区内容改由插槽提供（Vue 默认插槽；H5/工厂用 `text` 选项），并新增颜色区插槽（Vue `#color`；H5/工厂用 `colorContent` 选项）。
-- 新增 `textRatio` 属性（0~100，单位 %）：控制文字区宽度占比，胶囊默认 39、进度条默认 54；写入统一变量 `--hj-text-width`，旧 `--hj-copy-*` 变量保留为兼容别名。
-- 新增进度条 `showValue` 属性（默认 true）：控制右侧百分比数字显示。
-- 插槽容器默认透明且只做几何定位：不传插槽即为纯画面；组件不再对插槽内容施加文字样式。
-- 移除进度条右下角 DRAG 提示（`dragLabel` 相关配置一并删除）。
-- 文字区容器应用 `--hj-text-radius` 并裁剪内容（默认 0，无影响）。
-- 新增控制器方法：`setText(content)` / `setColorContent(content)` / `setTextRatio(ratio)`（胶囊与进度条）。
-- `ready` / `error` 改为创建后异步触发（先创建、后监听也能收到）；Progress 补齐 WebGL 降级时的 `error` 事件。
-- `randomize()` 会把新 seed 同步回 `preset.seed`；Canvas2D 降级路径的 `seed` / `speed` 现在真实生效。
-- 新增 `setCssVars(vars)` / `setLabel(label)`（胶囊与进度条）、进度条 `setValueSuffix(suffix)`；Vue 组件实例暴露与 H5 对称的插槽/CSS 变量方法。
-- Progress 新增 `disabled`（禁用拖动/键盘、aria-disabled、置灰）、`label`、`valueSuffix`；Capsule 补 `role="img"` 并支持 `label`。
-- `min` / `max` 水线归一化到 `[min, max]`，键盘步进按范围百分比（方向键 ±2%、PageUp/PageDown ±10%），右侧数字仍显示原始 value。
-- 拖动进度时 `change` 按 rAF 合并为一帧一次，避免高频重渲染。
-- Vue 结构属性变化重建实例时会继承运行时状态（seed/speed/colors/textRatio/cssVars/value 等）。
-- 新增官方 Vue 组件 `ColorBackground`；Color 控制器补齐 `setSeed` / `setSpeed` / `setFallbackColor` / `setMouseColor`。
-- Vue wrapper 的 `id` / `data-*` / `title` 等普通属性会落到组件内部根节点；`class` / `style` 留在外层宿主并写入文档。
-- `colors` 支持更通用的写法：`#rgb` / `#rrggbb` / CSS 命名色（`red`、`green`…）/ `rgb()` / `rgba()`，统一归一化为小写 6 位十六进制；`rgba()` 的 alpha 忽略（透明请用 `opacity`），新增公共工具 `normalizeColor(color)`。
-- 文档补全插槽 CSS 约定与 cssVars 完整变量表。
-
-## 0.2.0 - 2026-08-08
-
-- `preset` 简化为只接受文学名称字符串：胶囊 `初光 / 沧溟 / 玄夜 / 紫霄 / 银汉 / 熔金`，进度 `星火 / 迁流 / 幻境 / 汐潮`；不再支持编号、id、名称三选一或自定义预置对象。
-- `colors` / `seed` / `speed` 改为独立属性，传入即覆盖预置内置值，不传用预置默认；新增胶囊控制器 `setSeed()` / `setSpeed()`。
-- 移除 `interactive` 属性（指针扭曲效果统一由 `mouseColor` 控制，组件事件始终派发）。
-- 新增进度控制器 `setEdgeStyle('flow' | 'tide')` 热切换边界风格。
-
-## 0.1.0 - 2026-08-07
-
-- 从 画境观屿 演示项目抽出框架无关组件核心：`createCapsule` / `createProgressCapsule`。
-- 包名正式改为 `@5even7/dlc-ui`，入口：根入口、`/capsule`、`/progress`、`/color`、`/vue3`、`/vue2`，样式入口 `style.css` / 各组件 `style.css`。
-- 目录重构为组件独立文件夹：`src/dlc-capsule`、`src/dlc-progress`、`src/dlc-color`，共享预置/配色/默认值/文案集中在 `src/config/`，渲染与公共逻辑在 `src/core/`。
-- 删除 NC-07～NC-09 柔光流带（aurora）及对应 shader，胶囊仅保留 NC-01～NC-06 星云材质。
-- 新增 `dlc-color`：复用同一星云渲染器做背景层（`createColorBackground`），与 Capsule 效果一致，支持 z-index 层级变量。
-- 新增 `NC-13 TIDE` 潮汐进度预置（`edgeStyle: 'tide'`），原有进度数据冻结不变。
-- 尺寸支持数字（px）与 `px/%/vw/vh/vmin/vmax/em/rem` 字符串；默认值集中在 `src/config/defaults.js`。
-- 文案集中在 `src/config/copy.js`，可按实例覆盖。
-- 事件系统开放：`on/off` 接受任意事件名；Vue wrapper 转发 `$emit`。
-- 性能：WebGL2 激活时跳过隐藏的 Canvas2D 每帧绘制；组件级可见性（IntersectionObserver + 页面可见性）；质量档位。
-- 构建：Rollup 产出现代 ESM + legacy CJS/UMD（ES5 + polyfill），现代浏览器零影响。
+# Changelog
+
+> **发版规则**：默认每次发布只递增补丁号（0.x.y → 0.x.(y+1)，即 +0.01）；除非手动明确指定新版本号，否则不升次版本。
+
+## 0.2.19 - 2026-08-17
+- 新增dlc-avatar-creator 创建头像组件
+
+## 0.2.18 - 2026-08-15
+- 新增第二个表情家族 `type="grok"`：纯 SVG Path Morph 动态角色（非 Lottie），内置 13 个语义状态（情绪 / Agent 状态 / 生命周期）、8 种身体形态、随机表情池与眨眼节奏、身体动作动画（bounce / tilt / scan / turn / pulse / glitch）、pointer 视线跟随交互。
+- `createEmo` / `DlcEmo` 新增 `type`、`shape`、`interactive` 选项与 `setShape()` / `setInteractive()` 方法；`partColors` 对 grok 支持 `body` / `eyes` 两部位。TypeScript 改为判别联合（`MiaoEmoOptions` / `GrokEmoOptions`）。
+- 架构重构：`emo.js` 收敛为公共 Facade，Miao（Lottie）与 Grok（SVG Morph）各自独立 Renderer；结构属性变更重建渲染器，行为属性变更实时转发；Grok 数据全部本地打包、离线可用。
+- 新增 `getEmoType()` API 与 `EMO_CATEGORIES` 新分组；新增 THIRD_PARTY_NOTICES.md（LaoA-GrokBot MIT 声明）并加入 npm 发布文件列表。
+- 修复（经外部 AI 代码审查验证）：
+  - 修复 Grok 表情节奏被 `speed` 重复缩放（速度平方）的问题，`speed` 现在只生效一次。
+  - 修复共享 rAF Scheduler 全部暂停后 Grok `play()` / 页面重新可见无法唤醒动画循环的问题。
+  - Grok 眼睛现在由与身体形态同步的 `clipPath` 裁剪（对齐原版实现），`setShape()` 会同步更新裁剪路径，clipPath id 按实例唯一。
+  - Grok `fit`（contain / cover / fill）现在真正生效：svg 按 fit 映射 `preserveAspectRatio`（meet / slice / none）。
+  - Grok 的 `renderer` 对外恒为 `'svg'`，miao→grok→miao 往返时 miao 的 renderer 偏好（canvas/svg）不再丢失。
+  - `setName()` 改为事务式：非法名称在销毁旧动画前即抛错，原动画保持挂载。
+  - 修正 THIRD_PARTY_NOTICES.md 中的来源仓库与版权信息；版本号同步为 0.2.18。
+- Grok 状态展示体系：新增 `GROK_STATE_META`（category / label / description / source 元数据）与派生列表 `GROK_NAMES` / `GROK_CATEGORIES`，以及 `getGrokStateMeta()` / `getGrokNamesFor()` 查询函数；13 个公开 name 全部保留，分类（情绪 / Agent 状态 / 生命周期）不影响公开 API。新增 `createEmoPreviewCard()` 轻量卡片预览控制器：默认静态，hover / focus 时临时播放约 2.8 秒，离开 / 移出视口 / 系统减少动态时立即暂停，避免多卡片同时长驻动画。Docs 的 Grok 区块改为不分类、平铺全部状态 + 动态预览卡片，并补充 Grok name = 动态状态模组 的说明。
+- Grok 状态精简：按「静态首帧同一张脸只保留一个代表」归并，移除 26 个重复/近重复状态，公开 name 从 39 精简为 13（保留 `idle / sleeping / loading / thinking / listening / searching / working / happy / surprised / angry / sad / confused / receiving`）。
+- 移除「推荐」体系：`recommended` 元数据字段与 `GROK_RECOMMENDED_NAMES` 删除，Docs 默认展示全部状态。
+- 13 个状态的名称与描述不再照搬上游，改为按 25 组表情几何逐帧核对后重写（如 `idle 待机→平静`、`loading 加载→缓冲中`、`listening 倾听→聆听`、`working 工作→专注`、`confused 困惑→疑惑`、`searching 搜索→寻找`、`sleeping 睡眠→睡觉`），描述贴合实际眼神与动效。
+- Capsule `pointerenter` / `pointerleave` 事件负载补齐 `event`，与文档 `{ event, preset }` 一致。
+- Vue wrapper 补齐 Capsule `setSeed()` / `setSpeed()` 与 Progress `setEdgeStyle()`，与 H5 控制器及文档方法表对齐。
+- 文档一致性：README `change.source` 更正为 `drag / keyboard / prop`；Grok 分类与 `GROK_CATEGORIES` 对齐；修正历史版本中“移除 Progress keyboard 控制”的过时说明（当前版本保留 `keyboard`，默认开启）；削除从未被消费的 `--dlc-emo-play-state` CSS 变量。
+
+## 0.2.17 - 2026-08-15
+- Miao表情包优化展示，表情包拆分模块变更部分颜色属性
+
+## 0.2.16 - 2026-08-15
+- Miao表情包新增非等比填充模式，文档解释补充完善
+
+## 0.2.15 - 2026-08-14
+- 首个表情家族为 `type="miao"`，内置 23 个完整 Lottie 动作；素材生成阶段仍会校验并排除没有图层的空动画。
+
+## 0.2.14 - 2026-08-14
+- 新增dlc-emo表情包组件
+
+## 0.2.13 - 2026-08-14
+
+- 新增第四类组件 `dlc-emo`：H5 `createEmo()`、Vue 2 / Vue 3 `DlcEmo`，并提供独立 `@5even7/dlc-ui/emo` 与样式入口。
+- Emo 支持主色 / 辅助色、非正方形尺寸、contain / cover、0.1~4 倍速、循环、自动播放、正倒播、暂停、帧片段、透明度、背景色、SVG / Canvas 渲染器、无障碍名称与减少动态偏好。
+- 性能与兼容：SVG / Canvas 分别按需加载无表达式的 Lottie light 播放器，未创建 Emo 时不执行播放器代码，避免影响前三类组件与 SSR 导入。
+- 补齐 Emo 类型声明、默认值、控制器方法、生命周期事件和素材生成测试；素材没有稳定器官语义，因此未提供无法可靠生效的左眼 / 右眼等伪 API。
+- Progress 新增内置预置 `森息`（NC-14）：包含植物实验室色板、独立流体运动参数和参考图集配置，可直接使用 `preset="森息"`。
+- H5、Vue 2、Vue 3 示例将“植物实验室”改为由内置预置驱动，并在默认预置列表中展示 NC-14。
+- 文档明确 Capsule 的 `click` / `dblclick` 保持原生 H5 语义：双击会先伴随两次 `click`，组件不延迟或吞掉单击事件。
+
+## 0.2.11 - 2026-08-09
+
+- 修复：`--hj-text-bg` / `--hj-text-pad` 两个 cssVars 此前只在文档声明、组件 CSS 未引用，传了不生效；现在 Capsule / Progress 文字区容器真正支持背景与内边距变量（默认仍为透明 / 0，无视觉回归）。
+- 修复：Progress WebGL 路径下参考图集以全权重覆盖用户 `colors`，导致改主色 / 高光几乎无可见反馈；图集改为只提供亮度结构，颜色始终由 `colors`（底色 / 主色 / 辅色 / 高光）决定，Canvas2D 降级路径本就生效。
+- 文档：README / examples 修正过时描述（移除已废弃的键盘控制、自动加载文案；胶囊示例从"9 组"改为 6 组；示例页旧名 Cosmic Capsules 统一为 DLC）；`--hj-text-min-width` 默认值说明与实现一致（`textRatio` 生效时组件强制归零）。
+- 类型：`ProgressPreset` 移除运行时不存在的 `loadRate` 字段；`CapsuleController` 补 `setMouseColor()`；`ProgressController` 补 `setShowValue()`，与运行时控制器对齐。
+- 示例：examples 属性 / 方法说明补齐 `setMouseColor` / `setShowValue`，同步移除键盘 / 自动加载残留描述。
+
+## 0.2.10 - 2026-08-09
+
+- 修复：Vue wrapper 的插槽中转容器（`.hj-vue-slot-text` / `.hj-vue-slot-color`）此前带 `height: 100%`，插槽内容被搬进文字区/颜色区后，空壳仍会以宿主高度各撑出一个空块，把 Capsule / Progress 组件根整体往下推约 2×组件高度；改为 `display: none`，彻底脱离布局（对插槽搬运无影响）。
+
+## 0.2.9 - 2026-08-09
+
+- 修复：`/vue2`、`/vue3` 的 CJS 构建丢失默认导出（`require(...).default` 为 undefined，webpack/CommonJS 下 `import X from` 会拿到命名空间对象而不是组件）；legacy 入口现在转发默认导出，并带 `__esModule` 标记。
+- 对称补齐 Vue 组件实例方法：胶囊新增 `setMouseColor()`，进度条新增 `setShowValue()`（此前只有 Color 暴露了同类方法）。
+
+## 0.2.8 - 2026-08-09
+
+- 最终命名确认：官方组件导出为 `DlcCapsule / DlcProgress / DlcColor`（无中划线），模板中仍可直接写 `<dlc-capsule>` 等 kebab 写法（Vue 自动映射）；移除字符串形式的导出名，兼容 Vite/esbuild。
+
+## 0.2.7 - 2026-08-09
+
+- 修复：0.2.6 发布包未包含 mouseColor / showValue 热切换（watch 仍走重建），本轮真正启用 `setMouseColor()` / `setShowValue()`，开关不再重建组件、不丢插槽内容。
+- 组件更名：`CosmicCapsule → DlcCapsule`、`ProgressCapsule → DlcProgress`、`ColorBackground → DlcColor`（旧名保留为兼容别名，标记 deprecated；模板里也可写 `<dlc-capsule>` 等）。
+
+## 0.2.6 - 2026-08-09
+
+- 修复：Vue wrapper 重建组件时因“插槽容器搬移”导致组件树损坏（子组件丢失、mouseColor 开关无效）的问题；插槽改回搬子节点。
+- 胶囊 `mouseColor` 改为热切换（新增控制器 `setMouseColor()`，不再重建组件）；进度条 `showValue` 改为热切换（新增 `setShowValue()`，数字元素始终存在、按需隐藏）。
+
+## 0.2.5 - 2026-08-08
+
+- 修复：胶囊 `textRatio` 小于 164px（历史 `--hj-copy-min-width` 默认）时文字区不跟随缩小的 bug；现在 `textRatio` 是文字区宽度的唯一权威值，0~100 全范围生效。
+
+## 0.2.4 - 2026-08-08
+
+- 移除 Progress `keyboard` 属性与键盘控制（拖动/受控 value 已覆盖主要场景）。
+- 兼容性修复：legacy/IE11 路径补齐 `Array.prototype.find`、`String.prototype.endsWith`、`String.prototype.padStart` 缺失导致的崩溃（源码层也改为 ES5 写法）。
+- 控制器暴露值改为实时 getter（`textRatio` / `cssVars` / `opacity` / `fallbackColor` / `mouseColor`），热更新后读取不再过期，Vue 重建时状态继承更准确。
+- `setSize` 先校验再赋值，非法尺寸不再污染内部状态或抛进 Vue 更新流程。
+- `setRange` 与创建时的 `min/max` 在 min>max 时自动交换。
+- 结构属性连续变化时，重建后补一次插槽搬运（B3）。
+- Canvas2D 降级的 `randomize()` 额外随机相位，变化更明显；README 注明降级路径 `mouseColor` 不生效。
+
+## 0.2.3 - 2026-08-08
+
+- 修复：Vue wrapper 重建组件（如 showValue 开关）后插槽内容丢失的问题（插槽容器改为整体搬入文字区/颜色区）。
+- 修复：进度条点击后无法直接使用键盘方向键的问题（拖动开始时自动聚焦）。
+- 修复：胶囊 `textRatio=0` 时文字区仍因最小宽度 164px 占位的问题，现 0 即完全隐藏。
+- 新增 Progress `readonly` 属性：与 disabled 行为一致但不置灰（`aria-readonly`）。
+
+## 0.2.2 - 2026-08-08
+
+- 修复：Progress 的 `setLabel()` 对 const 变量重新赋值，导致打包产物被 esbuild 拒绝、文档站无法构建的问题；label 热更新恢复正常。
+
+## 0.2.1 - 2026-08-08
+
+- 移除 `copy` / `showCopy` 属性：文字区内容改由插槽提供（Vue 默认插槽；H5/工厂用 `text` 选项），并新增颜色区插槽（Vue `#color`；H5/工厂用 `colorContent` 选项）。
+- 新增 `textRatio` 属性（0~100，单位 %）：控制文字区宽度占比，胶囊默认 39、进度条默认 54；写入统一变量 `--hj-text-width`，旧 `--hj-copy-*` 变量保留为兼容别名。
+- 新增进度条 `showValue` 属性（默认 true）：控制右侧百分比数字显示。
+- 插槽容器默认透明且只做几何定位：不传插槽即为纯画面；组件不再对插槽内容施加文字样式。
+- 移除进度条右下角 DRAG 提示（`dragLabel` 相关配置一并删除）。
+- 文字区容器应用 `--hj-text-radius` 并裁剪内容（默认 0，无影响）。
+- 新增控制器方法：`setText(content)` / `setColorContent(content)` / `setTextRatio(ratio)`（胶囊与进度条）。
+- `ready` / `error` 改为创建后异步触发（先创建、后监听也能收到）；Progress 补齐 WebGL 降级时的 `error` 事件。
+- `randomize()` 会把新 seed 同步回 `preset.seed`；Canvas2D 降级路径的 `seed` / `speed` 现在真实生效。
+- 新增 `setCssVars(vars)` / `setLabel(label)`（胶囊与进度条）、进度条 `setValueSuffix(suffix)`；Vue 组件实例暴露与 H5 对称的插槽/CSS 变量方法。
+- Progress 新增 `disabled`（禁用拖动/键盘、aria-disabled、置灰）、`label`、`valueSuffix`；Capsule 补 `role="img"` 并支持 `label`。
+- `min` / `max` 水线归一化到 `[min, max]`，键盘步进按范围百分比（方向键 ±2%、PageUp/PageDown ±10%），右侧数字仍显示原始 value。
+- 拖动进度时 `change` 按 rAF 合并为一帧一次，避免高频重渲染。
+- Vue 结构属性变化重建实例时会继承运行时状态（seed/speed/colors/textRatio/cssVars/value 等）。
+- 新增官方 Vue 组件 `ColorBackground`；Color 控制器补齐 `setSeed` / `setSpeed` / `setFallbackColor` / `setMouseColor`。
+- Vue wrapper 的 `id` / `data-*` / `title` 等普通属性会落到组件内部根节点；`class` / `style` 留在外层宿主并写入文档。
+- `colors` 支持更通用的写法：`#rgb` / `#rrggbb` / CSS 命名色（`red`、`green`…）/ `rgb()` / `rgba()`，统一归一化为小写 6 位十六进制；`rgba()` 的 alpha 忽略（透明请用 `opacity`），新增公共工具 `normalizeColor(color)`。
+- 文档补全插槽 CSS 约定与 cssVars 完整变量表。
+
+## 0.2.0 - 2026-08-08
+
+- `preset` 简化为只接受文学名称字符串：胶囊 `初光 / 沧溟 / 玄夜 / 紫霄 / 银汉 / 熔金`，进度 `星火 / 迁流 / 幻境 / 汐潮`；不再支持编号、id、名称三选一或自定义预置对象。
+- `colors` / `seed` / `speed` 改为独立属性，传入即覆盖预置内置值，不传用预置默认；新增胶囊控制器 `setSeed()` / `setSpeed()`。
+- 移除 `interactive` 属性（指针扭曲效果统一由 `mouseColor` 控制，组件事件始终派发）。
+- 新增进度控制器 `setEdgeStyle('flow' | 'tide')` 热切换边界风格。
+
+## 0.1.0 - 2026-08-07
+
+- 从 画境观屿 演示项目抽出框架无关组件核心：`createCapsule` / `createProgressCapsule`。
+- 包名正式改为 `@5even7/dlc-ui`，入口：根入口、`/capsule`、`/progress`、`/color`、`/vue3`、`/vue2`，样式入口 `style.css` / 各组件 `style.css`。
+- 目录重构为组件独立文件夹：`src/dlc-capsule`、`src/dlc-progress`、`src/dlc-color`，共享预置/配色/默认值/文案集中在 `src/config/`，渲染与公共逻辑在 `src/core/`。
+- 删除 NC-07～NC-09 柔光流带（aurora）及对应 shader，胶囊仅保留 NC-01～NC-06 星云材质。
+- 新增 `dlc-color`：复用同一星云渲染器做背景层（`createColorBackground`），与 Capsule 效果一致，支持 z-index 层级变量。
+- 新增 `NC-13 TIDE` 潮汐进度预置（`edgeStyle: 'tide'`），原有进度数据冻结不变。
+- 尺寸支持数字（px）与 `px/%/vw/vh/vmin/vmax/em/rem` 字符串；默认值集中在 `src/config/defaults.js`。
+- 文案集中在 `src/config/copy.js`，可按实例覆盖。
+- 事件系统开放：`on/off` 接受任意事件名；Vue wrapper 转发 `$emit`。
+- 性能：WebGL2 激活时跳过隐藏的 Canvas2D 每帧绘制；组件级可见性（IntersectionObserver + 页面可见性）；质量档位。
+- 构建：Rollup 产出现代 ESM + legacy CJS/UMD（ES5 + polyfill），现代浏览器零影响。

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 yizhe21803
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 yizhe21803
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.