@5even7/dlc-ui 0.2.10 → 0.2.12

package/CHANGELOG.md

@@ -1,7 +1,15 @@
-# Changelog
-
+# Changelog
+
 > **发版规则**：默认每次发布只递增补丁号（0.x.y → 0.x.(y+1)，即 +0.01）；除非手动明确指定新版本号，否则不升次版本。
 
+## 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`，彻底脱离布局（对插槽搬运无影响）。
@@ -51,43 +59,43 @@
 - 修复：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），现代浏览器零影响。
+
+- 移除 `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.