@5even7/dlc-ui 0.2.5 → 0.2.7

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 > **发版规则**：默认每次发布只递增补丁号（0.x.y → 0.x.(y+1)，即 +0.01）；除非手动明确指定新版本号，否则不升次版本。
 
+## 0.2.7 - 2026-08-09
+
+- 修复：0.2.6 发布包未包含 mouseColor / showValue 热切换（watch 仍走重建），本轮真正启用 `setMouseColor()` / `setShowValue()`，开关不再重建组件、不丢插槽内容。
+- 组件更名：`CosmicCapsule → dlc-capsule`、`ProgressCapsule → dlc-progress`、`ColorBackground → dlc-color`（旧名保留为兼容别名，标记 deprecated）。
+
+## 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 全范围生效。

package/README.md

@@ -109,7 +109,7 @@ background.pause();
 
 ```vue
 <script setup>
-import { CosmicCapsule, ProgressCapsule, ColorBackground } from '@5even7/dlc-ui/vue3';
+import { DlcCapsule, DlcProgress, DlcColor } from '@5even7/dlc-ui/vue3';
 import '@5even7/dlc-ui/style.css';
 
 function onProgressChange({ value }) {
@@ -118,35 +118,35 @@ function onProgressChange({ value }) {
 </script>
 
 <template>
-  <CosmicCapsule preset="沧溟" width="100%" height="160" :text-ratio="45" @click="...">
+  <dlc-capsule preset="沧溟" width="100%" height="160" :text-ratio="45" @click="...">
     <span class="cap-code">NC-02</span>
     <span class="cap-name">沧溟</span>
     <template #color><span class="cap-chip">DLC</span></template>
-  </CosmicCapsule>
+  </dlc-capsule>
 
-  <ProgressCapsule preset="汐潮" :width="454" :height="104" @change="onProgressChange">
+  <dlc-progress preset="汐潮" :width="454" :height="104" @change="onProgressChange">
     <span class="prog-name">画境观屿</span>
-  </ProgressCapsule>
+  </dlc-progress>
 
-  <ColorBackground preset="沧溟" style="height: 200px">
+  <dlc-color preset="沧溟" style="height: 200px">
     这段内容显示在星云背景上方
-  </ColorBackground>
+  </dlc-color>
 </template>
 ```
 
 ## Vue2
 
 ```js
-import { CosmicCapsule, ProgressCapsule } from '@5even7/dlc-ui/vue2';
+import { DlcCapsule, DlcProgress } from '@5even7/dlc-ui/vue2';
 import '@5even7/dlc-ui/style.css';
 
 export default {
-  components: { CosmicCapsule, ProgressCapsule },
+  components: { DlcCapsule, DlcProgress },
   template: `
-    <ProgressCapsule preset="汐潮" :width="454" :height="104" @change="onChange">
+    <dlc-progress preset="汐潮" :width="454" :height="104" @change="onChange">
       <span class="prog-name">画境观屿</span>
       <template v-slot:color><span>自定义颜色区内容</span></template>
-    </ProgressCapsule>
+    </dlc-progress>
   `
 };
 ```
@@ -161,7 +161,7 @@ export default {
 
 插槽内容属性（H5/工厂）：`text`、`colorContent`，支持 HTML 字符串或 DOM 节点（数组）；Vue 组件请用默认插槽 / `#color` 插槽。**注意：字符串走 innerHTML，不要传入不可信/用户直接输入的内容（XSS 风险）。**
 
-dlc-color 背景层（`createColorBackground(host, options)`）：`preset`、`colors`、`seed`、`speed`、`quality`、`renderer`、`mouseColor`、`respectReducedMotion`、`opacity`（0~1）、`fallbackColor`（预置底色 / 十六进制色 / false）。控制器支持 `setPreset / setColors / setSeed / setSpeed / setQuality / setOpacity / setFallbackColor / setMouseColor / randomize / pause / resume / dispose` 和 `ready / presetchange / error` 事件。Vue 里可用官方组件 `ColorBackground`（从 `@5even7/dlc-ui/vue2` 或 `/vue3` 导入），它的默认插槽内容会显示在背景层上方。
+dlc-color 背景层（`createColorBackground(host, options)`）：`preset`、`colors`、`seed`、`speed`、`quality`、`renderer`、`mouseColor`、`respectReducedMotion`、`opacity`（0~1）、`fallbackColor`（预置底色 / 十六进制色 / false）。控制器支持 `setPreset / setColors / setSeed / setSpeed / setQuality / setOpacity / setFallbackColor / setMouseColor / randomize / pause / resume / dispose` 和 `ready / presetchange / error` 事件。Vue 里可用官方组件 `dlc-color`（从 `@5even7/dlc-ui/vue2` 或 `/vue3` 导入），它的默认插槽内容会显示在背景层上方。
 
 胶囊控制器额外支持 `setSeed(seed)` / `setSpeed(speed)` / `setText(content)` / `setColorContent(content)` / `setTextRatio(ratio)` / `setCssVars(vars)` / `setLabel(label)` 热更新；进度控制器额外支持 `setEdgeStyle('flow' | 'tide')` / `setValueSuffix(suffix)` 和同样的插槽热更新方法。`setPreset` 只接受文学名称字符串（如 `'汐潮'`）。Vue 组件实例也暴露 `setText` / `setColorContent` / `setTextRatio` / `setCssVars` / `setLabel`（进度另有 `setValueSuffix`），与 H5 控制器对称。
 
@@ -221,10 +221,7 @@ createProgressCapsule(el, {
 | `--hj-font` / `--hj-mono` | 字体令牌（可被插槽内容引用） | Inter / 等宽栈 |
 | `--hj-shadow` | 根节点阴影 | 柔和阴影 |
 | `--hj-value-right` | 进度数字右侧距离（仅进度条） | `30px` |
-| `--dlc-color-opacity` | 色层透明度（dlc-color） | `1` |
-| `--dlc-color-bg` | 色层兜底背景（dlc-color） | 预置底色 |
-| `--dlc-color-layer-z` | 色层 z-index（dlc-color） | `-1` |
-| `--dlc-color-content-z` | 宿主内容参考 z-index（dlc-color，由用户使用） | `1` |
+| `--dlc-color-layer-z` | 色层 z-index（dlc-color，宿主 CSS 可覆盖） | `-1` |
 
 兼容别名（deprecated，只兜底）：`--hj-copy-width`、`--hj-copy-min-width`、`--hj-copy-pad-x`、`--hj-copy-left`、`--hj-copy-max-width`、`--hj-progress-copy-pad`、`--hj-progress-copy-bg`。
 

package/dist/capsule.cjs

@@ -1328,6 +1328,11 @@ function createCapsule(container) {
       updateAria();
       return this;
     },
+    setMouseColor: function setMouseColor(value) {
+      merged.mouseColor = value !== false;
+      if (typeof renderer.setMouseColor === 'function') renderer.setMouseColor(merged.mouseColor);
+      return this;
+    },
     setSize: function setSize(width, height) {
       if (width !== undefined) {
         parseSize(width); // 非法尺寸直接抛错前先校验，避免污染内部状态

package/dist/capsule.mjs

@@ -1090,6 +1090,11 @@ function createCapsule(container, options = {}) {
       updateAria();
       return this;
     },
+    setMouseColor(value) {
+      merged.mouseColor = value !== false;
+      if (typeof renderer.setMouseColor === 'function') renderer.setMouseColor(merged.mouseColor);
+      return this;
+    },
     setSize(width, height) {
       if (width !== undefined) {
         parseSize(width); // 非法尺寸直接抛错前先校验，避免污染内部状态

package/dist/index.cjs

@@ -1374,6 +1374,11 @@ function createCapsule(container) {
       updateAria();
       return this;
     },
+    setMouseColor: function setMouseColor(value) {
+      merged.mouseColor = value !== false;
+      if (typeof renderer.setMouseColor === 'function') renderer.setMouseColor(merged.mouseColor);
+      return this;
+    },
     setSize: function setSize(width, height) {
       if (width !== undefined) {
         parseSize(width); // 非法尺寸直接抛错前先校验，避免污染内部状态
@@ -2006,6 +2011,12 @@ var ProgressCapsuleController = /*#__PURE__*/function () {
       this.root.setAttribute('aria-valuetext', "".concat(rounded).concat(this.valueSuffix));
       return this;
     }
+  }, {
+    key: "setShowValue",
+    value: function setShowValue(show) {
+      if (this.valueElement) this.valueElement.hidden = show === false;
+      return this;
+    }
   }, {
     key: "resizeCanvas",
     value: function resizeCanvas() {
@@ -2530,15 +2541,14 @@ function createProgressCapsule(container) {
   visualLayer.className = 'hj-progress-visual';
   fillContent(textLayer, options.text);
   fillContent(visualLayer, options.colorContent);
-  var valueElement = merged.showValue === false ? null : document.createElement('div');
-  if (valueElement) {
-    valueElement.className = 'hj-progress-value';
-    valueElement.setAttribute('aria-hidden', 'true');
-  }
+  var valueElement = document.createElement('div');
+  valueElement.className = 'hj-progress-value';
+  valueElement.setAttribute('aria-hidden', 'true');
+  valueElement.hidden = merged.showValue === false;
   root.appendChild(canvas);
   root.appendChild(textLayer);
   root.appendChild(visualLayer);
-  if (valueElement) root.appendChild(valueElement);
+  root.appendChild(valueElement);
   container.appendChild(root);
   var emitter = createEmitter();
   var paused = merged.respectReducedMotion && prefersReducedMotion$1();
@@ -2711,6 +2721,10 @@ function createProgressCapsule(container) {
       controller.setValueSuffix(suffix);
       return this;
     },
+    setShowValue: function setShowValue(show) {
+      controller.setShowValue(show);
+      return this;
+    },
     setColors: function setColors(colors) {
       var next = Array.isArray(colors) ? colors.map(normalizeColor) : [];
       if (next.length !== 4 || next.some(function (color) {

package/dist/index.mjs

@@ -1181,6 +1181,11 @@ function createCapsule(container, options = {}) {
       updateAria();
       return this;
     },
+    setMouseColor(value) {
+      merged.mouseColor = value !== false;
+      if (typeof renderer.setMouseColor === 'function') renderer.setMouseColor(merged.mouseColor);
+      return this;
+    },
     setSize(width, height) {
       if (width !== undefined) {
         parseSize(width); // 非法尺寸直接抛错前先校验，避免污染内部状态
@@ -1980,6 +1985,11 @@ class ProgressCapsuleController {
     this.root.setAttribute('aria-valuetext', `${rounded}${this.valueSuffix}`);
     return this;
   }
+
+  setShowValue(show) {
+    if (this.valueElement) this.valueElement.hidden = show === false;
+    return this;
+  }
 
   resizeCanvas() {
     const bounds = this.root.getBoundingClientRect();
@@ -2474,16 +2484,15 @@ function createProgressCapsule(container, options = {}) {
   fillContent(textLayer, options.text);
   fillContent(visualLayer, options.colorContent);
 
-  const valueElement = merged.showValue === false ? null : document.createElement('div');
-  if (valueElement) {
-    valueElement.className = 'hj-progress-value';
-    valueElement.setAttribute('aria-hidden', 'true');
-  }
+  const valueElement = document.createElement('div');
+  valueElement.className = 'hj-progress-value';
+  valueElement.setAttribute('aria-hidden', 'true');
+  valueElement.hidden = merged.showValue === false;
 
   root.appendChild(canvas);
   root.appendChild(textLayer);
   root.appendChild(visualLayer);
-  if (valueElement) root.appendChild(valueElement);
+  root.appendChild(valueElement);
   container.appendChild(root);
 
   const emitter = createEmitter();
@@ -2639,6 +2648,10 @@ function createProgressCapsule(container, options = {}) {
       controller.setValueSuffix(suffix);
       return this;
     },
+    setShowValue(show) {
+      controller.setShowValue(show);
+      return this;
+    },
     setColors(colors) {
       const next = Array.isArray(colors) ? colors.map(normalizeColor) : [];
       if (next.length !== 4 || next.some((color) => !color)) return this;

package/dist/index.umd.js

@@ -1378,6 +1378,11 @@
         updateAria();
         return this;
       },
+      setMouseColor: function setMouseColor(value) {
+        merged.mouseColor = value !== false;
+        if (typeof renderer.setMouseColor === 'function') renderer.setMouseColor(merged.mouseColor);
+        return this;
+      },
       setSize: function setSize(width, height) {
         if (width !== undefined) {
           parseSize(width); // 非法尺寸直接抛错前先校验，避免污染内部状态
@@ -2010,6 +2015,12 @@
         this.root.setAttribute('aria-valuetext', "".concat(rounded).concat(this.valueSuffix));
         return this;
       }
+    }, {
+      key: "setShowValue",
+      value: function setShowValue(show) {
+        if (this.valueElement) this.valueElement.hidden = show === false;
+        return this;
+      }
     }, {
       key: "resizeCanvas",
       value: function resizeCanvas() {
@@ -2534,15 +2545,14 @@
     visualLayer.className = 'hj-progress-visual';
     fillContent(textLayer, options.text);
     fillContent(visualLayer, options.colorContent);
-    var valueElement = merged.showValue === false ? null : document.createElement('div');
-    if (valueElement) {
-      valueElement.className = 'hj-progress-value';
-      valueElement.setAttribute('aria-hidden', 'true');
-    }
+    var valueElement = document.createElement('div');
+    valueElement.className = 'hj-progress-value';
+    valueElement.setAttribute('aria-hidden', 'true');
+    valueElement.hidden = merged.showValue === false;
     root.appendChild(canvas);
     root.appendChild(textLayer);
     root.appendChild(visualLayer);
-    if (valueElement) root.appendChild(valueElement);
+    root.appendChild(valueElement);
     container.appendChild(root);
     var emitter = createEmitter();
     var paused = merged.respectReducedMotion && prefersReducedMotion$1();
@@ -2715,6 +2725,10 @@
         controller.setValueSuffix(suffix);
         return this;
       },
+      setShowValue: function setShowValue(show) {
+        controller.setShowValue(show);
+        return this;
+      },
       setColors: function setColors(colors) {
         var next = Array.isArray(colors) ? colors.map(normalizeColor) : [];
         if (next.length !== 4 || next.some(function (color) {