@hamsterbase/ui 0.1.0 → 0.2.0

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.
@@ -2,7 +2,7 @@
2
2
 
3
3
  受控面板调宽手柄,组合 Divider 显示边界。放在具有定位的面板内,由调用方把 value 应用到面板宽度并处理持久化。保留 7px 拖拽热区、半像素边界与跟随指针的渐变反馈。
4
4
 
5
- 支持原生 div 展示属性和 ref;交互事件由组件管理。label 和 controls 分别提供可访问名称和受控面板 id。Home/End 调至最小/最大值;提供 defaultValue 后可双击复位。所有交互输出都限制在 min/max 范围内。调用方应保证 min ≤ value ≤ max。
5
+ 支持原生 div 展示属性和 ref;交互事件由组件管理。label 和 controls 分别提供可访问名称和受控面板 id。←/→ 按 step 移动边界,Home/End 调至最小/最大值;提供 defaultValue 后可双击复位。所有交互输出都限制在 min/max 范围内。调用方应保证 min ≤ value ≤ max。
6
6
 
7
7
  | 属性 | 类型 | 默认值 | 说明 |
8
8
  | --- | --- | --- | --- |
@@ -13,6 +13,7 @@
13
13
  | max | `number` | 必填 | 最大宽度。 |
14
14
  | onChange | `(value: number) => void` | 必填 | 宽度变化回调。 |
15
15
  | defaultValue | `number` | — | 双击复位宽度;不提供时不复位,不代表非受控初值。 |
16
+ | step | `number` | `16` | 每次按 ←/→ 移动的像素数。方向键移动的是边界:`edge='left'` 时按 → 宽度减小。 |
16
17
  | showDivider | `boolean` | `true` | 是否显示静态分隔线,隐藏时仍保留交互反馈。 |
17
18
  | inset | `number` | `0` | 手柄上下内缩像素数。 |
18
19
  | edge | `'left' \| 'right'` | `'right'` | 面板的可拖动边界;左边界向左移动时增大宽度。 |
package/docs/Toast.md ADDED
@@ -0,0 +1,60 @@
1
+ # Toast
2
+
3
+ 轻提示。包含三部分:`ToastStore` 保存状态,`Toaster` 订阅并渲染到右下角,`Toast` 是单张卡片。应用通常只创建一个 `ToastStore`,在根节点放一个 `Toaster`。
4
+
5
+ ```tsx
6
+ const toasts = new ToastStore();
7
+
8
+ <Toaster store={toasts} closeLabel="关闭" aria-label="通知" />;
9
+
10
+ toasts.show({ message: '已复制', variant: 'success' });
11
+ ```
12
+
13
+ ## ToastStore
14
+
15
+ 不依赖 React 的状态容器。
16
+
17
+ | 成员 | 类型 | 说明 |
18
+ | --- | --- | --- |
19
+ | constructor | `(options?: { max?: number })` | `max` 为同时展示的最大条数,默认 `1`;超出时移除最早的一条。 |
20
+ | show | `(options: ToastOptions) => string` | 显示一条提示并返回 id。`message`、`description`、`variant` 都相同且双方都没有 `action` 时,不新增,而是刷新已有提示的计时并强调。 |
21
+ | dismiss | `(id?: string) => void` | 立即移除指定提示;不传 id 时移除全部。 |
22
+ | subscribe | `(listener: () => void) => () => void` | 订阅变化,返回取消订阅函数。 |
23
+ | getSnapshot | `() => readonly ToastItem[]` | 当前提示列表;内容不变时引用不变。 |
24
+
25
+ ### ToastOptions
26
+
27
+ | 属性 | 类型 | 默认值 | 说明 |
28
+ | --- | --- | --- | --- |
29
+ | message | `string` | 必填 | 主文案。 |
30
+ | description | `string` | `undefined` | 补充说明,最多显示两行。 |
31
+ | variant | `'info' \| 'success' \| 'error'` | `'info'` | 图标与语义。 |
32
+ | duration | `number` | `4000`,error 为 `8000` | 自动关闭的毫秒数;`0` 表示不自动关闭。 |
33
+ | action | `{ label: ReactNode; onClick: () => void \| Promise<void> }` | `undefined` | 操作按钮,见下方 Toast 的说明。 |
34
+ | onClose | `() => void` | `undefined` | 提示被移除后调用,包括超时、手动关闭、被新提示挤掉和 `dismiss`。 |
35
+
36
+ ## Toaster
37
+
38
+ | 属性 | 类型 | 默认值 | 说明 |
39
+ | --- | --- | --- | --- |
40
+ | store | `ToastStore` | 必填 | 要渲染的状态容器。 |
41
+ | closeLabel | `string` | 必填 | 每张卡片关闭按钮的无障碍名称。 |
42
+
43
+ 没有提示时不渲染任何节点。容器为 `position: fixed`,位于右下角,`z-index` 取自 `--hub-z-toast`(默认 1500);其余属性透传到容器,可用 `style` 覆盖层级与位置(`--hub-z-toast` 是内部变量,不建议直接覆盖)。组件不使用 portal,祖先元素有 `transform` 等属性时需由应用自行挂到 `body`。
44
+
45
+ ## Toast
46
+
47
+ 单张卡片,不负责定位。直接使用时由调用方决定何时挂载和卸载。
48
+
49
+ | 属性 | 类型 | 默认值 | 说明 |
50
+ | --- | --- | --- | --- |
51
+ | message | `ReactNode` | 必填 | 主文案。error 变体以 `role="alert"` 播报,其余为 `role="status"`。 |
52
+ | description | `ReactNode` | `undefined` | 补充说明,最多显示两行。 |
53
+ | variant | `'info' \| 'success' \| 'error'` | `'info'` | 图标与语义。 |
54
+ | action | `{ label: ReactNode; onClick: () => void \| Promise<void> }` | `undefined` | 操作按钮。`onClick` 返回 Promise 时,等待期间禁用按钮并暂停计时;成功后关闭;失败(抛出异常或 Promise 被拒绝)后保持打开、恢复按钮并重新计时,异常不会被捕获,错误提示由调用方在 `onClick` 内自行处理。 |
55
+ | duration | `number` | `4000`,error 为 `8000` | 自动关闭的毫秒数;`0` 表示不自动关闭。鼠标悬停或焦点在卡片内时暂停。 |
56
+ | revision | `number` | `0` | 数值变化时重新计时并播放强调动画。 |
57
+ | closeLabel | `string` | 必填 | 关闭按钮的无障碍名称。 |
58
+ | onDismiss | `() => void` | 必填 | 退出动画结束后调用,调用方应在此时卸载组件。 |
59
+
60
+ `className`、`ref` 和其余属性落在最外层的动画容器上。
package/docs/index.md CHANGED
@@ -16,3 +16,4 @@ import '@hamsterbase/ui/styles.css';
16
16
  - [Divider](./Divider.md)
17
17
  - [IconButton](./IconButton.md)
18
18
  - [ResizeHandle](./ResizeHandle.md)
19
+ - [Toast](./Toast.md)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@hamsterbase/ui",
3
- "version": "0.1.0",
3
+ "version": "0.2.0",
4
4
  "files": [
5
5
  "dist",
6
6
  "docs",
@@ -31,6 +31,14 @@
31
31
  "peerDependencies": {
32
32
  "react": "^19.0.0"
33
33
  },
34
+ "packageManager": "pnpm@10.14.0",
35
+ "scripts": {
36
+ "dev": "pnpm --filter @hamsterbase/ui-playground exec vite --host 0.0.0.0",
37
+ "build": "vite build && tsc -p tsconfig.build.json && node scripts/finalize-build.mjs",
38
+ "check": "tsc -p tsconfig.json",
39
+ "build:playground": "pnpm --filter @hamsterbase/ui-playground exec vite build",
40
+ "prepack": "pnpm build"
41
+ },
34
42
  "dependencies": {
35
43
  "clsx": "^2.1.1",
36
44
  "lucide-react": "^1.68.0"
@@ -40,11 +48,5 @@
40
48
  "publishConfig": {
41
49
  "access": "public",
42
50
  "registry": "https://registry.npmjs.org/"
43
- },
44
- "scripts": {
45
- "dev": "pnpm --filter @hamsterbase/ui-playground exec vite --host 0.0.0.0",
46
- "build": "vite build && tsc -p tsconfig.build.json && node scripts/finalize-build.mjs",
47
- "check": "tsc -p tsconfig.json",
48
- "build:playground": "pnpm --filter @hamsterbase/ui-playground exec vite build"
49
51
  }
50
- }
52
+ }