@pieai/swimmer-ui-kit 3.2.0 → 3.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +10 -1
- package/README.md +1 -1
- package/dist/{GameStageTile-BtBb8NEw.js → GameStageTile-BdG3tMV-.js} +220 -173
- package/dist/index.js +337 -301
- package/dist/preview.js +65 -65
- package/dist/styles.css +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -5,7 +5,16 @@ Format: [Keep a Changelog](https://keepachangelog.com); versioning: semver.
|
|
|
5
5
|
|
|
6
6
|
## Unreleased
|
|
7
7
|
|
|
8
|
-
## 3.2.
|
|
8
|
+
## 3.2.1 — 本地候选，待发布到 npm latest
|
|
9
|
+
|
|
10
|
+
- 修正服务端渲染时 `GameHelpCard` 与 `GameTooltip` 的崩溃。当 Server Component 构造好触发器（例如 `GameIconButton href=…`）并作为子元素传入时，子元素可能以惰性元素到达；3.2.0 读取它的 `props` 会报 `Cannot read properties of undefined (reading 'ref')`，页面的服务端渲染与生产预渲染都会失败。现在这类子元素放在一个不占布局的 `game-ui-trigger-slot` 中，挂载后把 `aria-expanded` 与 `aria-controls`（卡片）或 `aria-describedby`（提示）加到第一个可聚焦元素上，卸载时移除。悬停、焦点、Escape，以及触摸“第一次点按只打开、第二次才执行”的规则不变；内层链接不会因第一次触摸而跳转。在客户端组件中构造的触发器保留原始元素，DOM 与行为与 3.2.0 相同。
|
|
11
|
+
- 惰性触发器会在挂载时打印一条 `console.warn`，建议改在客户端组件中构造；每个组件只打印一次，不按构建模式关闭，因为发布后的库无法看到使用方的构建模式。
|
|
12
|
+
- `GameTooltip` 此前不会崩溃，但惰性触发器读不到 `aria-describedby`；现在补上。
|
|
13
|
+
- `GameHelpCard` 的一到三个主题页签在 340 像素卡片内保持一行，中文 `懒人包 / 设定图 / 选角单` 与英文 `Starter pack / Sheet / Cast` 在浅色、深色与任一页签选中时都不截断。页签的一行规则只写一次，由 `GameTabs` 的样式统一提供；`GameAccountMenu` 的等宽页签与 3.2.0 外观相同。
|
|
14
|
+
- 新增两个页签故事（中文与英文）、页签一行的浏览器测试、惰性触发器的单元与浏览器测试，以及真实 Next 消费检查中的服务端触发器用例。该用例在 3.2.0 候选上复现了上述构建失败。
|
|
15
|
+
- 公开名字与参数不变，没有删除或改名。版本号改为 3.2.1。
|
|
16
|
+
|
|
17
|
+
## 3.2.0 — 2026-10-10（已发布到 npm latest）
|
|
9
18
|
|
|
10
19
|
- 新增 `GameHelpCard`：帮助的第二级。悬停（经过 `openDelay`，默认 200 毫秒）、键盘聚焦或点按后打开一张小卡片，含一个标题、一到三行正文（`\n` 换行）、可选的循环短演示和“完整指南”链接；一到四个主题时用页签切换。卡片的可访问名称由 `label` 提供，触发器获得 `aria-expanded` 与 `aria-controls`。
|
|
11
20
|
- 行为：鼠标指针可移入卡片切换页签或点击链接，离开约 150 毫秒后关闭；键盘 Tab 进入卡片，Escape 关闭并回到触发器，焦点不被抢走；触摸的第一次点按只打开卡片、阻止触发器动作，第二次点按才执行，点击卡片外关闭。
|
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Swimmer 的共享 React UI：普通控件是平面水滴，主线 CTA 是潮汐液体。支持六套风格与独立明暗，表单、焦点、键盘和编辑内容仍由原生 DOM 承接。它不拥有产品数据、模型调用、账号验证或支付。
|
|
4
4
|
|
|
5
|
-
**3.0.0 与 3.
|
|
5
|
+
**3.0.0、3.1.0 与 3.2.0 已发布到 npm latest（3.2.0 于 2026-10-10 发布，新增 GameHelpCard）。3.2.1 为本地候选（修正 GameHelpCard 与 GameTooltip 的服务端触发器，页签一行），待发布到 npm latest；发布前 latest 为 3.2.0。** 3.0.0-rc.1 与 rc.3 已发布到 npm next。现有产品继续锁定精确版本；主动升级先读[迁移表](docs/reference/migration-3.0.md)，发布证据见[当前工作](docs/reference/execution/current-work.md)。本仓库不自动升级任何产品。
|
|
6
6
|
|
|
7
7
|
## 安装与最小使用
|
|
8
8
|
|