@taole/giftstage 0.1.16 → 0.1.18

package/README.md

@@ -181,6 +181,8 @@ Promise<GiftHandle>;
 
 - `.to(step)` / `.then(step)`
   - 追加动画步骤（两者等价）
+- `.delay(milliseconds)`
+  - 在链中插入等待，不改变位置、缩放和透明度
 - `.onComplete((gift) => void)`
   - 整条链执行完成后的回调
 - `.start(mode?)`
@@ -401,6 +403,11 @@ await gift
     opacity: 1,
     duration: 700,
   })
+  .delay(300)
+  .then({
+    opacity: 0,
+    duration: 400,
+  })
   .onComplete((g) => {
     console.log('chain complete', g.id);
   })
@@ -460,6 +467,34 @@ SVGA 文本配置会按目标 frame 自动适配字号，避免文字超出槽
 - `minFontSize?: number` / `maxFontSize?: number`：限制自适应字号范围。
 - `padding?: number`：文字纹理内边距，默认 `2`。
 - `scale?: number`：文字纹理栅格倍率，SVGA 默认 `3`，用于保持清晰度。
+- `fontStyle?: string | { font?: string; color?: string }`：字体样式，SVGA / VAP 都支持。
+
+`fontStyle` 可以直接传 canvas font 字符串：
+
+```ts
+svgaSlots: {
+  title: {
+    text: 'Hello',
+    fontStyle: 'bold 40px Arial',
+  },
+}
+```
+
+也可以传对象：
+
+```ts
+vapSlots: {
+  welcome01: {
+    text: '欢迎进入房间',
+    fontStyle: {
+      font: 'bold 40px Arial',
+      color: '#ffffff',
+    },
+  },
+}
+```
+
+对象形式目前生效字段是 `font` 和 `color`。如果同时传了外层 `color` 和 `fontStyle.color`，以 `fontStyle.color` 为准。VAP 文本如果没有传 `fontStyle`，会回退使用 VAP 配置里的 `src.fontStyle`。
 
 ### VAP / VAPX