@5even7/dlc-ui 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,6 +1,13 @@
-# Changelog
-
-## 0.1.0 - 2026-08-07
+# Changelog
+
+## 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`。

package/README.md

@@ -12,15 +12,16 @@ npm install @5even7/dlc-ui
 
 ## 预置列表
 
-| 类型 | 预置 | 说明 |
-| --- | --- | --- |
-| capsule | `NC-01` ORIGINAL / `NC-02` OCEAN / `NC-03` KLEIN / `NC-04` ULTRAVIOLET / `NC-05` CHROME / `NC-06` PLUS | 星云材质 |
-| progress | `NC-10` MODEL TRAINING / `NC-11` AGENT MIGRATION / `NC-12` VISUAL TRAINING | 流体进度 |
-| progress | `NC-13` TIDE | 潮汐边界（潮起潮落） |
-
-`dlc-color` 复用同一套星云渲染器，只做背景层，没有自己的预置表，直接使用上表 capsule 的 6 个预置。
-
-`preset` 可以传 id（`'ocean'`）、编号（`'NC-02'`）、名称（`'OCEAN'`）或自定义预置对象（含 `colors` 等字段）。
+| 类型 | 预置 | 说明 |
+| --- | --- | --- |
+| capsule | `初光`（NC-01）/ `沧溟`（NC-02）/ `玄夜`（NC-03）/ `紫霄`（NC-04）/ `银汉`（NC-05）/ `熔金`（NC-06） | 星云材质 |
+| progress | `星火`（NC-10）/ `迁流`（NC-11）/ `幻境`（NC-12） | 流体进度 |
+| progress | `汐潮`（NC-13） | 潮汐边界（潮起潮落） |
+
+`dlc-color` 复用同一套星云渲染器，只做背景层，没有自己的预置表，直接使用上表 capsule 的 6 个预置。
+
+`preset` 只接受上表中的文学名称（如 `'沧溟'`），大小写不敏感、首尾空格忽略；不传时使用默认预置 `初光`（胶囊/背景层）或 `星火`（进度条）。
+`colors`、`seed`、`speed` 是独立属性，传了会覆盖预置内置值；不传则用预置默认值。
 
 ## H5 使用
 
@@ -30,14 +31,14 @@ npm install @5even7/dlc-ui
 import { createCapsule, createProgressCapsule } from '@5even7/dlc-ui';
 import '@5even7/dlc-ui/style.css';
 
-const capsule = createCapsule(document.querySelector('#host-a'), {
-  preset: 'ocean',
+const capsule = createCapsule(document.querySelector('#host-a'), {
+  preset: '沧溟',
   width: '100%',
   height: 160
 });
 
-const progress = createProgressCapsule(document.querySelector('#host-b'), {
-  preset: 'tide',
+const progress = createProgressCapsule(document.querySelector('#host-b'), {
+  preset: '汐潮',
   width: 454,
   height: 104
 });
@@ -53,13 +54,13 @@ progress.on('change', ({ value, source }) => console.log(value, source));
 import { createColorBackground } from '@5even7/dlc-ui/color';
 import '@5even7/dlc-ui/color/style.css';
 
-const background = createColorBackground(document.querySelector('#bg-host'), {
-  preset: 'ocean',
+const background = createColorBackground(document.querySelector('#bg-host'), {
+  preset: '沧溟',
   quality: 'auto'
 });
 
 // 需要时再切换/暂停
-background.setPreset('klein');
+background.setPreset('玄夜');
 background.pause();
 ```
 
@@ -107,8 +108,8 @@ function onProgressChange({ value }) {
 </script>
 
 <template>
-  <CosmicCapsule preset="ocean" width="100%" height="160" @click="...">
-  <ProgressCapsule preset="tide" :width="454" :height="104" @change="onProgressChange" />
+  <CosmicCapsule preset="沧溟" width="100%" height="160" @click="...">
+  <ProgressCapsule preset="汐潮" :width="454" :height="104" @change="onProgressChange" />
 </template>
 ```
 
@@ -120,7 +121,7 @@ import '@5even7/dlc-ui/style.css';
 
 export default {
   components: { CosmicCapsule, ProgressCapsule },
-  template: '<ProgressCapsule preset="tide" :width="454" :height="104" @change="onChange" />'
+  template: '<ProgressCapsule preset="汐潮" :width="454" :height="104" @change="onChange" />'
 };
 ```
 
@@ -128,11 +129,13 @@ export default {
 
 两个组件共有的属性：`preset`、`width`、`height`（数字=px，或 `px/%/vw/vh/vmin/vmax/em/rem` 字符串）、`colors`、`quality`（`auto/low/medium/high`）、`renderer`（`auto/webgl2/canvas2d`，`canvas2d` 可强制走降级路径，便于对比观感或省电）、`respectReducedMotion`、`copy`、`cssVars`。
 
-星云胶囊专属：`seed`、`speed`、`interactive`（指针交互，默认 `true`）、`mouseColor`（颜色随鼠标旋涡，默认 `true`；关闭后不影响 click/悬浮/长按等事件）。
+星云胶囊专属：`seed`、`speed`、`mouseColor`（颜色随鼠标旋涡，默认 `true`；关闭后不影响 click/悬浮/长按等事件）。`seed`/`speed` 不传时用预置内置值，传入即覆盖。
 
 进度胶囊专属：`value`、`min`、`max`、`draggable`、`keyboard`、`edgeStyle`（`flow/tide`）。
 
-dlc-color 背景层专属（`createColorBackground(host, options)`）：`preset`、`colors`、`seed`、`speed`、`quality`、`renderer`、`mouseColor`、`respectReducedMotion`、`opacity`（0~1）、`fallbackColor`（预置底色/十六进制色/false）。它返回的控制器支持 `setPreset / setColors / setQuality / setOpacity / randomize / pause / resume / dispose` 和 `ready / presetchange / error` 事件。
+dlc-color 背景层专属（`createColorBackground(host, options)`）：`preset`、`colors`、`seed`、`speed`、`quality`、`renderer`、`mouseColor`、`respectReducedMotion`、`opacity`（0~1）、`fallbackColor`（预置底色/十六进制色/false）。它返回的控制器支持 `setPreset / setColors / setQuality / setOpacity / randomize / pause / resume / dispose` 和 `ready / presetchange / error` 事件。
+
+胶囊控制器额外支持 `setSeed(seed)` / `setSpeed(speed)` 热更新；进度控制器额外支持 `setEdgeStyle('flow' | 'tide')` 热切换边界风格。`setPreset` 只接受文学名称字符串（如 `'汐潮'`）。
 
 > 进度条是完全受控组件：组件自身不再自动增长，`value` 由使用方驱动。要自动步进，自己写定时器加值即可：
 >
@@ -174,7 +177,7 @@ dlc-color 背景层专属（`createColorBackground(host, options)`）：`preset`
 也可以在创建时传 `cssVars`：
 
 ```js
-createProgressCapsule(el, { preset: 'tide', cssVars: { '--hj-radius': '12px' } });
+createProgressCapsule(el, { preset: '汐潮', cssVars: { '--hj-radius': '12px' } });
 ```
 
 主要变量：`--hj-radius`、`--hj-bg`、`--hj-ink`、`--hj-muted`、`--hj-font`、`--hj-mono`、`--hj-copy-width`、`--hj-copy-min-width`、`--hj-copy-pad-x`、`--hj-copy-gradient`、`--hj-shadow`、`--hj-name-size`、`--hj-copy-left`、`--hj-value-right`、`--hj-copy-max-width`。

package/dist/capsule.cjs

@@ -317,7 +317,7 @@ var PALETTES = {
 var CAPSULE_PRESETS = [{
   id: 'original',
   code: 'NC-01',
-  name: 'ORIGINAL',
+  name: '初光',
   group: 'warm',
   seed: 1.7,
   speed: 0.5,
@@ -325,7 +325,7 @@ var CAPSULE_PRESETS = [{
 }, {
   id: 'ocean',
   code: 'NC-02',
-  name: 'OCEAN',
+  name: '沧溟',
   group: 'cold',
   seed: 8.2,
   speed: 0.48,
@@ -333,7 +333,7 @@ var CAPSULE_PRESETS = [{
 }, {
   id: 'klein',
   code: 'NC-03',
-  name: 'KLEIN',
+  name: '玄夜',
   group: 'cold',
   seed: 14.1,
   speed: 0.49,
@@ -341,7 +341,7 @@ var CAPSULE_PRESETS = [{
 }, {
   id: 'ultraviolet',
   code: 'NC-04',
-  name: 'ULTRAVIOLET',
+  name: '紫霄',
   group: 'cold',
   seed: 23.4,
   speed: 0.47,
@@ -349,7 +349,7 @@ var CAPSULE_PRESETS = [{
 }, {
   id: 'chrome',
   code: 'NC-05',
-  name: 'CHROME',
+  name: '银汉',
   group: 'cold',
   seed: 37.8,
   speed: 0.42,
@@ -357,7 +357,7 @@ var CAPSULE_PRESETS = [{
 }, {
   id: 'plus',
   code: 'NC-06',
-  name: 'PLUS',
+  name: '熔金',
   group: 'warm',
   seed: 51.3,
   speed: 0.5,
@@ -367,7 +367,7 @@ var CAPSULE_PRESETS = [{
 var PROGRESS_PRESETS = [{
   id: 'model-training',
   code: 'NC-10',
-  name: 'MODEL TRAINING',
+  name: '星火',
   subtitle: 'SHA 4.5 + 100 2026 TKN',
   group: 'progress',
   initialProgress: 43,
@@ -376,7 +376,7 @@ var PROGRESS_PRESETS = [{
 }, {
   id: 'agent-migration',
   code: 'NC-11',
-  name: 'AGENT MIGRATION',
+  name: '迁流',
   subtitle: 'TRANSFERRING PROTOCOL',
   group: 'progress',
   initialProgress: 33,
@@ -385,7 +385,7 @@ var PROGRESS_PRESETS = [{
 }, {
   id: 'visual-training',
   code: 'NC-12',
-  name: 'VISUAL TRAINING',
+  name: '幻境',
   subtitle: 'GENERATING POWER ++',
   group: 'progress',
   initialProgress: 58,
@@ -394,7 +394,7 @@ var PROGRESS_PRESETS = [{
 }, {
   id: 'tide',
   code: 'NC-13',
-  name: 'TIDE',
+  name: '汐潮',
   subtitle: 'MOON PULL / COAST',
   group: 'progress',
   initialProgress: 30,
@@ -403,20 +403,18 @@ var PROGRESS_PRESETS = [{
 }];
 
 [].concat(_toConsumableArray(CAPSULE_PRESETS), _toConsumableArray(PROGRESS_PRESETS));
-function validatePreset(preset) {
-  return Boolean(preset && typeof preset.id === 'string' && typeof preset.code === 'string' && typeof preset.name === 'string' && Number.isFinite(preset.seed) && Number.isFinite(preset.speed) && Array.isArray(preset.colors) && preset.colors.length === 4);
-}
+
+/**
+ * Resolve a preset by its literary name (e.g. '沧溟').
+ * Matching is case-insensitive and ignores surrounding whitespace,
+ * so '沧溟' and ' 沧溟 ' both work.
+ */
 function getPreset(kind, ref) {
   var list = CAPSULE_PRESETS ;
   if (!list) throw new Error("Unknown preset kind: ".concat(kind, " (use \"capsule\" or \"progress\")"));
-  if (ref && _typeof(ref) === 'object') {
-    var valid = validatePreset(ref) ;
-    if (!valid) throw new Error("Invalid ".concat(kind, " preset object"));
-    return ref;
-  }
   var key = String(ref).trim().toLowerCase();
   var found = list.find(function (preset) {
-    return preset.id.toLowerCase() === key || preset.code.toLowerCase() === key || preset.name.toLowerCase() === key;
+    return preset.name.toLowerCase() === key;
   });
   if (!found) throw new Error("Unknown ".concat(kind, " preset: ").concat(ref));
   return found;
@@ -429,7 +427,6 @@ var DEFAULTS = {
     quality: 'auto',
     renderer: 'auto',
     respectReducedMotion: true,
-    interactive: true,
     mouseColor: true,
     showCopy: true
   }};
@@ -836,8 +833,8 @@ function prefersReducedMotion() {
  * Mount a cosmic (nebula) capsule into `container`.
  *
  * Options: preset (id/code/name or object), width, height (number=px or
- * string with px/%/vw/vh/em/rem), colors, seed, speed, quality, interactive,
- * respectReducedMotion, copy, cssVars.
+ * string with px/%/vw/vh/em/rem), colors, seed, speed, quality,
+ * respectReducedMotion, copy, cssVars.
  */
 function createCapsule(container) {
   var _options$preset;
@@ -845,7 +842,7 @@ function createCapsule(container) {
   if (!container || typeof container.appendChild !== 'function') {
     throw new Error('createCapsule: container element is required');
   }
-  var preset = _objectSpread2({}, getPreset('capsule', (_options$preset = options.preset) !== null && _options$preset !== void 0 ? _options$preset : 'NC-01'));
+  var preset = _objectSpread2({}, getPreset('capsule', (_options$preset = options.preset) !== null && _options$preset !== void 0 ? _options$preset : '初光'));
   var merged = normalizeOptions(DEFAULTS.capsule, preset, options);
   var copy = _objectSpread2(_objectSpread2({}, COPY), merged.copy || {});
   var root = document.createElement('div');
@@ -924,18 +921,16 @@ function createCapsule(container) {
   }) : null;
   if (resizeObserver) resizeObserver.observe(root);else window.addEventListener('resize', renderer.resize);
   var visibility = createVisibilityGuard(root);
-  if (merged.interactive !== false) {
-    root.addEventListener('pointerenter', function () {
-      return emitter.emit('pointerenter', {
-        preset: _objectSpread2({}, preset)
-      });
+  root.addEventListener('pointerenter', function () {
+    return emitter.emit('pointerenter', {
+      preset: _objectSpread2({}, preset)
     });
-    root.addEventListener('pointerleave', function () {
-      return emitter.emit('pointerleave', {
-        preset: _objectSpread2({}, preset)
-      });
+  });
+  root.addEventListener('pointerleave', function () {
+    return emitter.emit('pointerleave', {
+      preset: _objectSpread2({}, preset)
     });
-  }
+  });
   root.addEventListener('click', function (event) {
     emitter.emit('click', {
       event: event,
@@ -1000,6 +995,20 @@ function createCapsule(container) {
       }));
       return this;
     },
+    setSeed: function setSeed(seed) {
+      var value = Number(seed);
+      if (!Number.isFinite(value)) return this;
+      preset.seed = value;
+      renderer.setPreset(_objectSpread2({}, preset));
+      return this;
+    },
+    setSpeed: function setSpeed(speed) {
+      var value = Number(speed);
+      if (!Number.isFinite(value)) return this;
+      preset.speed = value;
+      renderer.setPreset(_objectSpread2({}, preset));
+      return this;
+    },
     setSize: function setSize(width, height) {
       if (width !== undefined) merged.width = width;
       if (height !== undefined) merged.height = height;

package/dist/capsule.mjs

@@ -112,57 +112,40 @@ const PALETTES = {
  * Capsule 预置：仅星云材质 NC-01~NC-06（NC-07~09 aurora 已移除）。
  * 颜色引用公共色板，seed/speed 决定形态与流速。
  */
-const CAPSULE_PRESETS = [
-  { id: 'original', code: 'NC-01', name: 'ORIGINAL', group: 'warm', seed: 1.7, speed: 0.5, colors: [...PALETTES.original] },
-  { id: 'ocean', code: 'NC-02', name: 'OCEAN', group: 'cold', seed: 8.2, speed: 0.48, colors: [...PALETTES.ocean] },
-  { id: 'klein', code: 'NC-03', name: 'KLEIN', group: 'cold', seed: 14.1, speed: 0.49, colors: [...PALETTES.klein] },
-  { id: 'ultraviolet', code: 'NC-04', name: 'ULTRAVIOLET', group: 'cold', seed: 23.4, speed: 0.47, colors: [...PALETTES.ultraviolet] },
-  { id: 'chrome', code: 'NC-05', name: 'CHROME', group: 'cold', seed: 37.8, speed: 0.42, colors: [...PALETTES.chrome] },
-  { id: 'plus', code: 'NC-06', name: 'PLUS', group: 'warm', seed: 51.3, speed: 0.5, colors: [...PALETTES.plus] }
+const CAPSULE_PRESETS = [
+  { id: 'original', code: 'NC-01', name: '初光', group: 'warm', seed: 1.7, speed: 0.5, colors: [...PALETTES.original] },
+  { id: 'ocean', code: 'NC-02', name: '沧溟', group: 'cold', seed: 8.2, speed: 0.48, colors: [...PALETTES.ocean] },
+  { id: 'klein', code: 'NC-03', name: '玄夜', group: 'cold', seed: 14.1, speed: 0.49, colors: [...PALETTES.klein] },
+  { id: 'ultraviolet', code: 'NC-04', name: '紫霄', group: 'cold', seed: 23.4, speed: 0.47, colors: [...PALETTES.ultraviolet] },
+  { id: 'chrome', code: 'NC-05', name: '银汉', group: 'cold', seed: 37.8, speed: 0.42, colors: [...PALETTES.chrome] },
+  { id: 'plus', code: 'NC-06', name: '熔金', group: 'warm', seed: 51.3, speed: 0.5, colors: [...PALETTES.plus] }
 ];
 
-function validatePreset(preset) {
-  return Boolean(
-    preset &&
-    typeof preset.id === 'string' &&
-    typeof preset.code === 'string' &&
-    typeof preset.name === 'string' &&
-    Number.isFinite(preset.seed) &&
-    Number.isFinite(preset.speed) &&
-    Array.isArray(preset.colors) &&
-    preset.colors.length === 4
-  );
-}
-
-function getPreset(kind, ref) {
-  const list = CAPSULE_PRESETS ;
-  if (!list) throw new Error(`Unknown preset kind: ${kind} (use "capsule" or "progress")`);
-  if (ref && typeof ref === 'object') {
-    const valid = validatePreset(ref) ;
-    if (!valid) throw new Error(`Invalid ${kind} preset object`);
-    return ref;
-  }
-  const key = String(ref).trim().toLowerCase();
-  const found = list.find(
-    (preset) =>
-      preset.id.toLowerCase() === key ||
-      preset.code.toLowerCase() === key ||
-      preset.name.toLowerCase() === key
-  );
-  if (!found) throw new Error(`Unknown ${kind} preset: ${ref}`);
-  return found;
+/**
+ * Resolve a preset by its literary name (e.g. '沧溟').
+ * Matching is case-insensitive and ignores surrounding whitespace,
+ * so '沧溟' and ' 沧溟 ' both work.
+ */
+function getPreset(kind, ref) {
+  const list = CAPSULE_PRESETS ;
+  if (!list) throw new Error(`Unknown preset kind: ${kind} (use "capsule" or "progress")`);
+  const key = String(ref).trim().toLowerCase();
+  const found = list.find(
+    (preset) => preset.name.toLowerCase() === key
+  );
+  if (!found) throw new Error(`Unknown ${kind} preset: ${ref}`);
+  return found;
 }
 
 const DEFAULTS = {
   capsule: {
     width: '100%',
     height: 160,
-    quality: 'auto',
-    renderer: 'auto',
-    respectReducedMotion: true,
-    interactive: true,
-    mouseColor: true,
-    showCopy: true
+    quality: 'auto',
+    renderer: 'auto',
+    respectReducedMotion: true,
+    mouseColor: true,
+    showCopy: true
   }};
 
 /**
@@ -650,15 +633,15 @@ function prefersReducedMotion() {
  * Mount a cosmic (nebula) capsule into `container`.
  *
  * Options: preset (id/code/name or object), width, height (number=px or
- * string with px/%/vw/vh/em/rem), colors, seed, speed, quality, interactive,
- * respectReducedMotion, copy, cssVars.
+ * string with px/%/vw/vh/em/rem), colors, seed, speed, quality,
+ * respectReducedMotion, copy, cssVars.
  */
 function createCapsule(container, options = {}) {
   if (!container || typeof container.appendChild !== 'function') {
     throw new Error('createCapsule: container element is required');
   }
 
-  const preset = { ...getPreset('capsule', options.preset ?? 'NC-01') };
+  const preset = { ...getPreset('capsule', options.preset ?? '初光') };
   const merged = normalizeOptions(DEFAULTS.capsule, preset, options);
   const copy = { ...COPY, ...(merged.copy || {}) };
 
@@ -745,10 +728,8 @@ function createCapsule(container, options = {}) {
 
   const visibility = createVisibilityGuard(root);
 
-  if (merged.interactive !== false) {
-    root.addEventListener('pointerenter', () => emitter.emit('pointerenter', { preset: { ...preset } }));
-    root.addEventListener('pointerleave', () => emitter.emit('pointerleave', { preset: { ...preset } }));
-  }
+  root.addEventListener('pointerenter', () => emitter.emit('pointerenter', { preset: { ...preset } }));
+  root.addEventListener('pointerleave', () => emitter.emit('pointerleave', { preset: { ...preset } }));
   root.addEventListener('click', (event) => {
     emitter.emit('click', { event, preset: { ...preset } });
   });
@@ -788,12 +769,26 @@ function createCapsule(container, options = {}) {
       emitter.emit('presetchange', { preset: { ...next } });
       return this;
     },
-    setColors(colors) {
-      if (!Array.isArray(colors) || colors.length !== 4) return this;
-      preset.colors = colors;
-      renderer.setPreset({ ...preset, colors });
-      return this;
-    },
+    setColors(colors) {
+      if (!Array.isArray(colors) || colors.length !== 4) return this;
+      preset.colors = colors;
+      renderer.setPreset({ ...preset, colors });
+      return this;
+    },
+    setSeed(seed) {
+      const value = Number(seed);
+      if (!Number.isFinite(value)) return this;
+      preset.seed = value;
+      renderer.setPreset({ ...preset });
+      return this;
+    },
+    setSpeed(speed) {
+      const value = Number(speed);
+      if (!Number.isFinite(value)) return this;
+      preset.speed = value;
+      renderer.setPreset({ ...preset });
+      return this;
+    },
     setSize(width, height) {
       if (width !== undefined) merged.width = width;
       if (height !== undefined) merged.height = height;

package/dist/color.cjs

@@ -296,7 +296,7 @@ var PALETTES = {
 var CAPSULE_PRESETS = [{
   id: 'original',
   code: 'NC-01',
-  name: 'ORIGINAL',
+  name: '初光',
   group: 'warm',
   seed: 1.7,
   speed: 0.5,
@@ -304,7 +304,7 @@ var CAPSULE_PRESETS = [{
 }, {
   id: 'ocean',
   code: 'NC-02',
-  name: 'OCEAN',
+  name: '沧溟',
   group: 'cold',
   seed: 8.2,
   speed: 0.48,
@@ -312,7 +312,7 @@ var CAPSULE_PRESETS = [{
 }, {
   id: 'klein',
   code: 'NC-03',
-  name: 'KLEIN',
+  name: '玄夜',
   group: 'cold',
   seed: 14.1,
   speed: 0.49,
@@ -320,7 +320,7 @@ var CAPSULE_PRESETS = [{
 }, {
   id: 'ultraviolet',
   code: 'NC-04',
-  name: 'ULTRAVIOLET',
+  name: '紫霄',
   group: 'cold',
   seed: 23.4,
   speed: 0.47,
@@ -328,7 +328,7 @@ var CAPSULE_PRESETS = [{
 }, {
   id: 'chrome',
   code: 'NC-05',
-  name: 'CHROME',
+  name: '银汉',
   group: 'cold',
   seed: 37.8,
   speed: 0.42,
@@ -336,7 +336,7 @@ var CAPSULE_PRESETS = [{
 }, {
   id: 'plus',
   code: 'NC-06',
-  name: 'PLUS',
+  name: '熔金',
   group: 'warm',
   seed: 51.3,
   speed: 0.5,
@@ -346,7 +346,7 @@ var CAPSULE_PRESETS = [{
 var PROGRESS_PRESETS = [{
   id: 'model-training',
   code: 'NC-10',
-  name: 'MODEL TRAINING',
+  name: '星火',
   subtitle: 'SHA 4.5 + 100 2026 TKN',
   group: 'progress',
   initialProgress: 43,
@@ -355,7 +355,7 @@ var PROGRESS_PRESETS = [{
 }, {
   id: 'agent-migration',
   code: 'NC-11',
-  name: 'AGENT MIGRATION',
+  name: '迁流',
   subtitle: 'TRANSFERRING PROTOCOL',
   group: 'progress',
   initialProgress: 33,
@@ -364,7 +364,7 @@ var PROGRESS_PRESETS = [{
 }, {
   id: 'visual-training',
   code: 'NC-12',
-  name: 'VISUAL TRAINING',
+  name: '幻境',
   subtitle: 'GENERATING POWER ++',
   group: 'progress',
   initialProgress: 58,
@@ -373,7 +373,7 @@ var PROGRESS_PRESETS = [{
 }, {
   id: 'tide',
   code: 'NC-13',
-  name: 'TIDE',
+  name: '汐潮',
   subtitle: 'MOON PULL / COAST',
   group: 'progress',
   initialProgress: 30,
@@ -382,20 +382,18 @@ var PROGRESS_PRESETS = [{
 }];
 
 [].concat(_toConsumableArray(CAPSULE_PRESETS), _toConsumableArray(PROGRESS_PRESETS));
-function validatePreset(preset) {
-  return Boolean(preset && typeof preset.id === 'string' && typeof preset.code === 'string' && typeof preset.name === 'string' && Number.isFinite(preset.seed) && Number.isFinite(preset.speed) && Array.isArray(preset.colors) && preset.colors.length === 4);
-}
+
+/**
+ * Resolve a preset by its literary name (e.g. '沧溟').
+ * Matching is case-insensitive and ignores surrounding whitespace,
+ * so '沧溟' and ' 沧溟 ' both work.
+ */
 function getPreset(kind, ref) {
   var list = CAPSULE_PRESETS ;
   if (!list) throw new Error("Unknown preset kind: ".concat(kind, " (use \"capsule\" or \"progress\")"));
-  if (ref && _typeof(ref) === 'object') {
-    var valid = validatePreset(ref) ;
-    if (!valid) throw new Error("Invalid ".concat(kind, " preset object"));
-    return ref;
-  }
   var key = String(ref).trim().toLowerCase();
   var found = list.find(function (preset) {
-    return preset.id.toLowerCase() === key || preset.code.toLowerCase() === key || preset.name.toLowerCase() === key;
+    return preset.name.toLowerCase() === key;
   });
   if (!found) throw new Error("Unknown ".concat(kind, " preset: ").concat(ref));
   return found;
@@ -803,7 +801,7 @@ function createColorBackground(host) {
   if (!host || typeof host.appendChild !== 'function') {
     throw new Error('createColorBackground: host element is required');
   }
-  var preset = _objectSpread2({}, getPreset('capsule', (_options$preset = options.preset) !== null && _options$preset !== void 0 ? _options$preset : 'NC-01'));
+  var preset = _objectSpread2({}, getPreset('capsule', (_options$preset = options.preset) !== null && _options$preset !== void 0 ? _options$preset : '初光'));
   var merged = normalizeOptions({
     quality: DEFAULTS.capsule.quality,
     renderer: DEFAULTS.capsule.renderer,