weimo-ui-stats 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 jiaowenjun
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,175 @@
-# Temporary Holding Version
+# weimo-ui-stats
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> 你的坚持,看得见 —— 为笔记与打卡而生。
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
+[![React 19](https://img.shields.io/badge/React-19-61dafb.svg)](https://react.dev)
+[![在线演示](https://img.shields.io/badge/%E5%9C%A8%E7%BA%BF%E6%BC%94%E7%A4%BA-GitHub%20Pages-2ea44f.svg)](https://jiaowenjun.github.io/weimo-ui-stats/)
+
+**[🚀 打开在线演示,亲手点点看 →](https://jiaowenjun.github.io/weimo-ui-stats/)**
+
+如果你在做笔记应用、写作工具、习惯打卡,需要一块像 GitHub 贡献图那样「一眼看出最近写了多少」的概览区,`weimo-ui-stats` 就是为你准备的:
+
+- **`Heatmap` 日期热力图** —— 把「日期 → 条数」渲染成按周排列的 13 周活动方格,带月份标签、今日环、选中态与悬浮提示;
+- **`HeatColor` 热力色阶** —— 热力图的 5 级背景色阶,既是展示用的色卡组件,也是 `--color-heat-0..4` token 的归属地;
+- **`StatGroup` 统计组** —— 把「128 篇笔记 / 1.2 万字 / 36 天」这样的指标横排成一组大数字小标签。
+
+组件基于 React 19 构建,视觉语言(主题 token、悬浮提示)来自 [weimo-ui-core](https://github.com/jiaowenjun/weimo-ui-core) 设计系统,深浅色主题自动适配。
+
+## ✨ 特性
+
+- **固定视窗,稳定布局** —— 热力图始终展示截至本周的 13 个 ISO 周(周一起始),不随数据多少抖动
+- **自动分级** —— 按条数映射 0–4 级热力:无记录 / 1 条 / 2–3 条 / 4–5 条 / 6 条及以上
+- **今日与选中双态** —— 今日单元格带内描边环,`activeDate` 对应的单元格带外描边,两者可叠加
+- **悬浮提示 + 键盘可达** —— 每个单元格是原生按钮,附带 `aria-label` 与 Tooltip,聚焦态有清晰 outline
+- **headless 模型可单独使用** —— 单元格、列、月份标签的构建函数全部导出,可脱离组件自行渲染
+- **按需引入** —— 显式子路径导出、tree-shaking 友好,组件结构样式随导入自动加载,只需在应用入口引入一次主题 token
+
+## 📦 安装
+
+```bash
+pnpm add weimo-ui-stats weimo-ui-core @base-ui/react react react-dom
+```
+
+- `weimo-ui-stats@0.1.x` 搭配 `weimo-ui-core@0.1.x` 使用;`Heatmap` 的悬浮提示来自 core 的 Tooltip,因此需要 core 的对等依赖 `@base-ui/react`。
+- 包根不提供 `.` 导出,所有组件通过显式子路径引入。
+
+在应用入口加载一次主题 token(组件自身的结构样式与热力色 token 会随导入自动加载,无需手动引入):
+
+```ts
+import 'weimo-ui-core/styles/tokens.css'
+```
+
+## 🚀 快速上手
+
+### 渲染日期热力图
+
+```tsx
+import { useState } from 'react'
+import { Heatmap, type HeatmapDailyCount } from 'weimo-ui-stats/components/heatmap'
+
+const dailyCounts: HeatmapDailyCount[] = [
+  { date: '2026-10-20', count: 2 },
+  { date: '2026-10-22', count: 6 },
+  { date: '2026-10-24', count: 1 },
+]
+
+export function ActivityOverview() {
+  const [activeDate, setActiveDate] = useState('2026-10-22')
+
+  return (
+    <Heatmap
+      activeDate={activeDate}
+      dailyCounts={dailyCounts}
+      onDateSelect={(date) => setActiveDate(date)}
+    />
+  )
+}
+```
+
+### 渲染统计组
+
+```tsx
+import { StatGroup } from 'weimo-ui-stats/components/stat-group'
+
+<StatGroup
+  aria-label="笔记统计"
+  items={[
+    { key: 'notes', value: '128', label: '笔记' },
+    { key: 'words', value: '1.2', label: '万字' },
+    { key: 'days', value: '36', label: '天' },
+  ]}
+/>
+```
+
+### 展示热力色阶
+
+```tsx
+import { HeatColor } from 'weimo-ui-stats/components/heat-color'
+
+// 默认展示 0–4 全部 5 级;也可以只传需要的级别
+<HeatColor levels={[1, 2, 3, 4]} />
+```
+
+## 📖 组件 API
+
+### `<Heatmap />`
+
+| 属性 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| `dailyCounts` | `HeatmapDailyCount[]` | `[]` | 日期活动数据,`{ date: 'YYYY-MM-DD', count }`;负数按 0 处理 |
+| `activeDate` | `string` | `''` | 当前选中的日期键,对应单元格带外描边 |
+| `onDateSelect` | `(date: string, cell: HeatmapCell) => void` | — | 点击单元格时回调 |
+| `ariaLabel` | `string` | `'日期热力图'` | 容器的无障碍名称(替代原生 `aria-label`) |
+
+其余原生 `div` 属性(`className`、`role` 等)均可透传;`role` 缺省为 `group`。今日日期由组件内部按本地时间计算,不接受外部传入。
+
+`components/heatmap` 入口同时导出 headless 模型:
+
+| 导出 | 说明 |
+| --- | --- |
+| `formatHeatmapDateKey(date)` | 把 `Date` 格式化为 `YYYY-MM-DD` 本地日期键 |
+| `getHeatmapLevel(count)` | 条数 → `0 \| 1 \| 2 \| 3 \| 4` 热力级别 |
+| `buildHeatmapCells(dailyCounts, today?, activeDate?)` | 生成 91 个按日排序的 `HeatmapCell` |
+| `buildHeatmapColumns(cells)` | 按 7 天一列切分为 13 个 `HeatmapColumn` |
+| `buildHeatmapMonthLabels(cells)` | 找出每月 1 日所在列,生成 `HeatmapMonthLabel` |
+| `HeatmapCell` / `HeatmapColumn` / `HeatmapDailyCount` / `HeatmapLevel` / `HeatmapMonthLabel` | 对应类型 |
+
+### `<HeatColor />`
+
+| 属性 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| `levels` | `HeatColorLevel[]` | `[0, 1, 2, 3, 4]` | 要展示的色阶级别 |
+| `getLevelLabel` | `(level) => string` | 内置中文文案 | 每个色块的无障碍名称 |
+| `ariaLabel` | `string` | `'热力图颜色色阶'` | 容器的无障碍名称(替代原生 `aria-label`) |
+
+`components/heat-color` 入口同时导出色阶元数据:
+
+| 导出 | 说明 |
+| --- | --- |
+| `heatColorMap` | 每级的 `label`、`token`、亮/暗 `value`、`className`、`description` |
+| `heatColorLevels` | `[0, 1, 2, 3, 4]` |
+| `getHeatColorClassName(level)` | 取对应的 `heat-color--N` 工具类名 |
+| `getHeatColorToken(level)` | 取对应的 `--color-heat-N` token 名 |
+
+### `<StatGroup />`
+
+| 属性 | 类型 | 默认值 | 说明 |
+| --- | --- | --- | --- |
+| `items` | `StatGroupItem[]` | `[]` | 指标列表,`{ key?, value, label }`,`value` 与 `label` 均可为任意 `ReactNode` |
+| `children` | `ReactNode` | — | 追加在指标之后的自定义内容 |
+
+其余原生 `div` 属性均可透传;`role` 缺省为 `group`。
+
+### 样式入口
+
+组件会随导入自动加载各自的样式;若需单独引入(例如在非 React 场景复用 token),可使用:
+
+| 入口 | 内容 |
+| --- | --- |
+| `styles/heat-color.css` | `--color-heat-0..4` token 与 `.heat-color` 色阶样式 |
+| `styles/heatmap.css` | `--color-heatmap-today-ring` token 与 `.heatmap` 网格样式 |
+| `styles/stat-group.css` | `.stat-group` 布局样式 |
+
+## 🧩 生态
+
+`weimo-ui-stats` 是 weimo-ui 组件家族的一员,唯一的 UI 依赖是 [weimo-ui-core](https://github.com/jiaowenjun/weimo-ui-core) —— 它提供主题 token、悬浮提示与 `cn` 工具。`Heatmap` 与 `StatGroup` 互不依赖,可单独引入。
+
+## 🛠️ 本地开发
+
+<details>
+<summary>展开查看仓库脚本</summary>
+
+```bash
+pnpm install
+pnpm verify    # 类型检查 + 测试 + 打包校验 + 文档站构建
+pnpm site:dev  # 本地启动文档站
+```
+
+文档站位于 `site/`,推送 `main` 后由 GitHub Actions 自动构建部署到 GitHub Pages。
+
+</details>
+
+## 许可证
+
+[MIT](./LICENSE)

package/dist/components/heatmap/heat-color.css

@@ -0,0 +1,58 @@
+/* 热力图背景色 token:随热力图色阶模块归属 stats,亮值进 :root、暗值进 .dark,
+   与 heat-color.tsx 的 heatColorMap 值保持镜像。 */
+:root {
+  --color-heat-0: hsl(0 0% 94%);
+  --color-heat-1: hsl(18 62% 89%);
+  --color-heat-2: hsl(18 62% 78%);
+  --color-heat-3: hsl(18 62% 65%);
+  --color-heat-4: hsl(18 62% 52%);
+}
+
+.dark {
+  --color-heat-0: hsl(0 0% 19%);
+  --color-heat-1: hsl(23 31% 22%);
+  --color-heat-2: hsl(23 42% 32%);
+  --color-heat-3: hsl(23 50% 44%);
+  --color-heat-4: hsl(23 68% 56%);
+}
+
+@layer components {
+  .heat-color {
+    --heat-color-size: 15px;
+    --heat-color-gap: 4px;
+    --heat-color-radius: var(--radius-xs);
+
+    display: inline-flex;
+    align-items: center;
+    gap: var(--heat-color-gap);
+  }
+
+  .heat-color__swatch {
+    display: block;
+    width: var(--heat-color-size);
+    height: var(--heat-color-size);
+    border-radius: var(--heat-color-radius);
+  }
+}
+
+@layer utilities {
+  .heat-color--0 {
+    background: var(--color-heat-0);
+  }
+
+  .heat-color--1 {
+    background: var(--color-heat-1);
+  }
+
+  .heat-color--2 {
+    background: var(--color-heat-2);
+  }
+
+  .heat-color--3 {
+    background: var(--color-heat-3);
+  }
+
+  .heat-color--4 {
+    background: var(--color-heat-4);
+  }
+}

package/dist/components/heatmap/heat-color.d.css.ts

@@ -0,0 +1 @@
+export {}

package/dist/components/heatmap/heat-color.d.ts

@@ -0,0 +1,65 @@
+import type { HTMLAttributes } from 'react';
+import './heat-color.css';
+export type HeatColorLevel = 0 | 1 | 2 | 3 | 4;
+export declare const heatColorMap: {
+    0: {
+        label: string;
+        token: string;
+        value: {
+            light: string;
+            dark: string;
+        };
+        className: string;
+        description: string;
+    };
+    1: {
+        label: string;
+        token: string;
+        value: {
+            light: string;
+            dark: string;
+        };
+        className: string;
+        description: string;
+    };
+    2: {
+        label: string;
+        token: string;
+        value: {
+            light: string;
+            dark: string;
+        };
+        className: string;
+        description: string;
+    };
+    3: {
+        label: string;
+        token: string;
+        value: {
+            light: string;
+            dark: string;
+        };
+        className: string;
+        description: string;
+    };
+    4: {
+        label: string;
+        token: string;
+        value: {
+            light: string;
+            dark: string;
+        };
+        className: string;
+        description: string;
+    };
+};
+export declare const heatColorLevels: HeatColorLevel[];
+export type HeatColorProps = Omit<HTMLAttributes<HTMLDivElement>, 'aria-label'> & {
+    levels?: HeatColorLevel[];
+    ariaLabel?: string;
+    getLevelLabel?: (level: HeatColorLevel) => string;
+};
+export declare function getHeatColorClassName(level: HeatColorLevel): string;
+export declare function getHeatColorToken(level: HeatColorLevel): string;
+export declare function HeatColor({ ariaLabel, className, getLevelLabel, levels, role, ...props }: HeatColorProps): import("react").JSX.Element;
+//# sourceMappingURL=heat-color.d.ts.map

package/dist/components/heatmap/heat-color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heat-color.d.ts","sourceRoot":"","sources":["../../../src/components/heatmap/heat-color.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAI3C,OAAO,kBAAkB,CAAA;AAEzB,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAE9C,eAAO,MAAM,YAAY;;QAErB,KAAK;QACL,KAAK;QACL,KAAK;YACH,KAAK;YACL,IAAI;;QAEN,SAAS;QACT,WAAW;;;QAGX,KAAK;QACL,KAAK;QACL,KAAK;YACH,KAAK;YACL,IAAI;;QAEN,SAAS;QACT,WAAW;;;QAGX,KAAK;QACL,KAAK;QACL,KAAK;YACH,KAAK;YACL,IAAI;;QAEN,SAAS;QACT,WAAW;;;QAGX,KAAK;QACL,KAAK;QACL,KAAK;YACH,KAAK;YACL,IAAI;;QAEN,SAAS;QACT,WAAW;;;QAGX,KAAK;QACL,KAAK;QACL,KAAK;YACH,KAAK;YACL,IAAI;;QAEN,SAAS;QACT,WAAW;;CAWb,CAAA;AAEF,eAAO,MAAM,eAAe,EAAsB,cAAc,EAAE,CAAA;AAYlE,MAAM,MAAM,cAAc,GAAG,IAAI,CAC/B,cAAc,CAAC,cAAc,CAAC,EAC9B,YAAY,CACb,GAAG;IACF,MAAM,CAAC,EAAE,cAAc,EAAE,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,MAAM,CAAA;CAClD,CAAA;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,UAE1D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,UAEtD;AAED,wBAAgB,SAAS,CAAC,EACxB,SAAqB,EACrB,SAAS,EACT,aAAuC,EACvC,MAAsB,EACtB,IAAI,EACJ,GAAG,KAAK,EACT,EAAE,cAAc,+BAmBhB"}

package/dist/components/heatmap/heat-color.js

@@ -0,0 +1,73 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { cn } from 'weimo-ui-core/lib/utils';
+import './heat-color.css';
+export const heatColorMap = {
+    0: {
+        label: '0 级',
+        token: '--color-heat-0',
+        value: {
+            light: 'hsl(0 0% 94%)',
+            dark: 'hsl(0 0% 19%)',
+        },
+        className: 'heat-color--0',
+        description: '无记录或最低热力的基础色阶。',
+    },
+    1: {
+        label: '1 级',
+        token: '--color-heat-1',
+        value: {
+            light: 'hsl(18 62% 89%)',
+            dark: 'hsl(23 31% 22%)',
+        },
+        className: 'heat-color--1',
+        description: '轻量活动或低热力状态。',
+    },
+    2: {
+        label: '2 级',
+        token: '--color-heat-2',
+        value: {
+            light: 'hsl(18 62% 78%)',
+            dark: 'hsl(23 42% 32%)',
+        },
+        className: 'heat-color--2',
+        description: '中低热力状态。',
+    },
+    3: {
+        label: '3 级',
+        token: '--color-heat-3',
+        value: {
+            light: 'hsl(18 62% 65%)',
+            dark: 'hsl(23 50% 44%)',
+        },
+        className: 'heat-color--3',
+        description: '中高热力状态。',
+    },
+    4: {
+        label: '4 级',
+        token: '--color-heat-4',
+        value: {
+            light: 'hsl(18 62% 52%)',
+            dark: 'hsl(23 68% 56%)',
+        },
+        className: 'heat-color--4',
+        description: '最高热力状态。',
+    },
+};
+export const heatColorLevels = [0, 1, 2, 3, 4];
+const defaultLevels = [...heatColorLevels];
+function formatDefaultLevelLabel(level) {
+    if (level === 0) {
+        return '0 级，无记录';
+    }
+    return `${level} 级热力`;
+}
+export function getHeatColorClassName(level) {
+    return heatColorMap[level].className;
+}
+export function getHeatColorToken(level) {
+    return heatColorMap[level].token;
+}
+export function HeatColor({ ariaLabel = '热力图颜色色阶', className, getLevelLabel = formatDefaultLevelLabel, levels = defaultLevels, role, ...props }) {
+    return (_jsx("div", { ...props, "aria-label": ariaLabel, className: cn('heat-color', className), role: role ?? 'group', children: levels.map((level) => (_jsx("span", { "aria-label": getLevelLabel(level), className: cn('heat-color__swatch', getHeatColorClassName(level)), "data-level": level, role: "img" }, level))) }));
+}
+//# sourceMappingURL=heat-color.js.map

package/dist/components/heatmap/heat-color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heat-color.js","sourceRoot":"","sources":["../../../src/components/heatmap/heat-color.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,EAAE,EAAE,MAAM,yBAAyB,CAAA;AAE5C,OAAO,kBAAkB,CAAA;AAIzB,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,CAAC,EAAE;QACD,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,gBAAgB;QACvB,KAAK,EAAE;YACL,KAAK,EAAE,eAAe;YACtB,IAAI,EAAE,eAAe;SACtB;QACD,SAAS,EAAE,eAAe;QAC1B,WAAW,EAAE,gBAAgB;KAC9B;IACD,CAAC,EAAE;QACD,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,gBAAgB;QACvB,KAAK,EAAE;YACL,KAAK,EAAE,iBAAiB;YACxB,IAAI,EAAE,iBAAiB;SACxB;QACD,SAAS,EAAE,eAAe;QAC1B,WAAW,EAAE,aAAa;KAC3B;IACD,CAAC,EAAE;QACD,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,gBAAgB;QACvB,KAAK,EAAE;YACL,KAAK,EAAE,iBAAiB;YACxB,IAAI,EAAE,iBAAiB;SACxB;QACD,SAAS,EAAE,eAAe;QAC1B,WAAW,EAAE,SAAS;KACvB;IACD,CAAC,EAAE;QACD,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,gBAAgB;QACvB,KAAK,EAAE;YACL,KAAK,EAAE,iBAAiB;YACxB,IAAI,EAAE,iBAAiB;SACxB;QACD,SAAS,EAAE,eAAe;QAC1B,WAAW,EAAE,SAAS;KACvB;IACD,CAAC,EAAE;QACD,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,gBAAgB;QACvB,KAAK,EAAE;YACL,KAAK,EAAE,iBAAiB;YACxB,IAAI,EAAE,iBAAiB;SACxB;QACD,SAAS,EAAE,eAAe;QAC1B,WAAW,EAAE,SAAS;KACvB;CAUD,CAAA;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAqB,CAAA;AAElE,MAAM,aAAa,GAAqB,CAAC,GAAG,eAAe,CAAC,CAAA;AAE5D,SAAS,uBAAuB,CAAC,KAAqB;IACpD,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,OAAO,GAAG,KAAK,MAAM,CAAA;AACvB,CAAC;AAWD,MAAM,UAAU,qBAAqB,CAAC,KAAqB;IACzD,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,SAAS,CAAA;AACtC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAqB;IACrD,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,KAAK,CAAA;AAClC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,EACxB,SAAS,GAAG,SAAS,EACrB,SAAS,EACT,aAAa,GAAG,uBAAuB,EACvC,MAAM,GAAG,aAAa,EACtB,IAAI,EACJ,GAAG,KAAK,EACO;IACf,OAAO,CACL,iBACM,KAAK,gBACG,SAAS,EACrB,SAAS,EAAE,EAAE,CAAC,YAAY,EAAE,SAAS,CAAC,EACtC,IAAI,EAAE,IAAI,IAAI,OAAO,YAEpB,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CACrB,6BACc,aAAa,CAAC,KAAK,CAAC,EAChC,SAAS,EAAE,EAAE,CAAC,oBAAoB,EAAE,qBAAqB,CAAC,KAAK,CAAC,CAAC,gBACrD,KAAK,EAEjB,IAAI,EAAC,KAAK,IADL,KAAK,CAEV,CACH,CAAC,GACE,CACP,CAAA;AACH,CAAC"}

package/dist/components/heatmap/heatmap-model.d.ts

@@ -0,0 +1,26 @@
+export type HeatmapDailyCount = {
+    date: string;
+    count: number;
+};
+export type HeatmapLevel = 0 | 1 | 2 | 3 | 4;
+export type HeatmapCell = {
+    date: string;
+    count: number;
+    level: HeatmapLevel;
+    isToday: boolean;
+    isActive: boolean;
+};
+export type HeatmapColumn = {
+    cells: HeatmapCell[];
+    index: number;
+};
+export type HeatmapMonthLabel = {
+    name: string;
+    columnIndex: number;
+};
+export declare function formatHeatmapDateKey(date: Date): string;
+export declare function getHeatmapLevel(count: number): HeatmapLevel;
+export declare function buildHeatmapCells(dailyCounts: HeatmapDailyCount[], today?: string, activeDate?: string): HeatmapCell[];
+export declare function buildHeatmapColumns(cells: HeatmapCell[]): HeatmapColumn[];
+export declare function buildHeatmapMonthLabels(cells: HeatmapCell[]): HeatmapMonthLabel[];
+//# sourceMappingURL=heatmap-model.d.ts.map

package/dist/components/heatmap/heatmap-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heatmap-model.d.ts","sourceRoot":"","sources":["../../../src/components/heatmap/heatmap-model.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAE5C,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,YAAY,CAAA;IACnB,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,WAAW,EAAE,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAsBD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,UAM9C;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAO3D;AAED,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,iBAAiB,EAAE,EAChC,KAAK,SAAmC,EACxC,UAAU,SAAK,iBA8BhB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,mBAWvD;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,WAAW,EAAE,uBAsB3D"}

package/dist/components/heatmap/heatmap-model.js

@@ -0,0 +1,82 @@
+const visibleWeekCount = 13;
+const daysPerWeek = 7;
+function parseDateKey(dateKey) {
+    const [year, month, day] = dateKey.split('-').map(Number);
+    return new Date(year, month - 1, day);
+}
+function startOfIsoWeek(date) {
+    const current = new Date(date);
+    const day = current.getDay();
+    const diff = day === 0 ? -6 : 1 - day;
+    current.setDate(current.getDate() + diff);
+    current.setHours(0, 0, 0, 0);
+    return current;
+}
+export function formatHeatmapDateKey(date) {
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, '0');
+    const day = String(date.getDate()).padStart(2, '0');
+    return `${year}-${month}-${day}`;
+}
+export function getHeatmapLevel(count) {
+    if (count <= 0)
+        return 0;
+    if (count === 1)
+        return 1;
+    if (count <= 3)
+        return 2;
+    if (count <= 5)
+        return 3;
+    return 4;
+}
+export function buildHeatmapCells(dailyCounts, today = formatHeatmapDateKey(new Date()), activeDate = '') {
+    const todayDate = parseDateKey(today);
+    const endWeekStart = startOfIsoWeek(todayDate);
+    const startDate = new Date(endWeekStart);
+    startDate.setDate(endWeekStart.getDate() - (visibleWeekCount - 1) * daysPerWeek);
+    const countsByDate = new Map(dailyCounts.map((entry) => [entry.date, Math.max(0, entry.count)]));
+    const cells = [];
+    const cursor = new Date(startDate);
+    for (let index = 0; index < visibleWeekCount * daysPerWeek; index += 1) {
+        const date = formatHeatmapDateKey(cursor);
+        const count = countsByDate.get(date) ?? 0;
+        cells.push({
+            date,
+            count,
+            level: getHeatmapLevel(count),
+            isToday: date === today,
+            isActive: date === activeDate,
+        });
+        cursor.setDate(cursor.getDate() + 1);
+    }
+    return cells;
+}
+export function buildHeatmapColumns(cells) {
+    const columns = [];
+    for (let index = 0; index < cells.length; index += daysPerWeek) {
+        columns.push({
+            cells: cells.slice(index, index + daysPerWeek),
+            index: columns.length,
+        });
+    }
+    return columns;
+}
+export function buildHeatmapMonthLabels(cells) {
+    const labels = [];
+    for (let index = 0; index < cells.length; index += daysPerWeek) {
+        const column = cells.slice(index, index + daysPerWeek);
+        const monthStart = column.find((cell) => {
+            const day = Number(cell.date.split('-')[2]);
+            return day === 1;
+        });
+        if (monthStart) {
+            const month = Number(monthStart.date.split('-')[1]);
+            labels.push({
+                name: `${month}月`,
+                columnIndex: index / daysPerWeek,
+            });
+        }
+    }
+    return labels;
+}
+//# sourceMappingURL=heatmap-model.js.map

package/dist/components/heatmap/heatmap-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heatmap-model.js","sourceRoot":"","sources":["../../../src/components/heatmap/heatmap-model.ts"],"names":[],"mappings":"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"}

package/dist/components/heatmap/heatmap.css

@@ -0,0 +1,100 @@
+/* 今日环描边色 token:随 Heatmap 组件归属 stats,亮值进 :root、暗值进 .dark,
+   供 .heatmap__cell--today 的 inset 描边消费。 */
+:root {
+  --color-heatmap-today-ring: hsl(18.1 71.9% 46.1% / 0.55);
+}
+
+.dark {
+  --color-heatmap-today-ring: hsl(0 0% 100% / 0.38);
+}
+
+@layer components {
+  .heatmap {
+    --heatmap-cell-size: 15px;
+    --heatmap-gap: 4px;
+    --heatmap-cell-radius: var(--radius-xs);
+  }
+
+  .heatmap {
+    display: flex;
+    width: 100%;
+    justify-content: center;
+    padding: 12px 16px;
+  }
+
+  .heatmap__grid {
+    display: flex;
+    flex-direction: row;
+  }
+
+  .heatmap__column {
+    display: flex;
+    width: var(--heatmap-cell-size);
+    flex-direction: column;
+    margin-right: var(--heatmap-gap);
+  }
+
+  .heatmap__column:last-child {
+    margin-right: 0;
+  }
+
+  .heatmap__cell {
+    width: var(--heatmap-cell-size);
+    height: var(--heatmap-cell-size);
+    margin: 0 0 var(--heatmap-gap);
+    padding: 0;
+    border: 0;
+    border-radius: var(--heatmap-cell-radius);
+    background: var(--color-border);
+    cursor: pointer;
+    transition:
+      opacity 160ms ease,
+      transform 160ms ease;
+  }
+
+  .heatmap__cell:hover {
+    opacity: 0.82;
+  }
+
+  .heatmap__cell:focus-visible {
+    outline: 2px solid var(--color-text-primary);
+    outline-offset: 2px;
+  }
+
+  .heatmap__cell--active {
+    box-shadow: 0 0 0 1.5px var(--color-text-primary);
+  }
+
+  .heatmap__cell--today {
+    box-shadow: inset 0 0 0 1px var(--color-heatmap-today-ring);
+  }
+
+  .heatmap__cell--today.heatmap__cell--active {
+    box-shadow:
+      inset 0 0 0 1px var(--color-heatmap-today-ring),
+      0 0 0 1.5px var(--color-text-primary);
+  }
+
+  .heatmap__month,
+  .heatmap__month-spacer {
+    height: var(--heatmap-cell-size);
+    margin-top: var(--heatmap-gap);
+    line-height: var(--heatmap-cell-size);
+  }
+
+  .heatmap__month {
+    overflow: visible;
+    color: var(--color-text-placeholder);
+    font-size: var(--font-size-2xs);
+    white-space: nowrap;
+  }
+
+  .heatmap__month-spacer {
+    pointer-events: none;
+  }
+}
+
+button.heatmap__cell {
+  color: inherit;
+  font: inherit;
+}

package/dist/components/heatmap/heatmap.d.css.ts

@@ -0,0 +1 @@
+export {}

package/dist/components/heatmap/heatmap.d.ts

@@ -0,0 +1,13 @@
+import type { HTMLAttributes } from 'react';
+import { type HeatmapCell, type HeatmapDailyCount } from './heatmap-model';
+import './heatmap.css';
+export type { HeatmapCell, HeatmapDailyCount } from './heatmap-model';
+export type HeatmapProps = Omit<HTMLAttributes<HTMLDivElement>, 'onSelect' | 'aria-label'> & {
+    dailyCounts?: HeatmapDailyCount[];
+    activeDate?: string;
+    ariaLabel?: string;
+    onDateSelect?: (date: string, cell: HeatmapCell) => void;
+};
+export declare function formatHeatmapTooltip(cell: Pick<HeatmapCell, 'count' | 'date'>): string;
+export declare function Heatmap({ activeDate, ariaLabel, className, dailyCounts, onDateSelect, role, ...props }: HeatmapProps): import("react").JSX.Element;
+//# sourceMappingURL=heatmap.d.ts.map

package/dist/components/heatmap/heatmap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heatmap.d.ts","sourceRoot":"","sources":["../../../src/components/heatmap/heatmap.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAU3C,OAAO,EAKL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAA;AAExB,OAAO,eAAe,CAAA;AAEtB,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAErE,MAAM,MAAM,YAAY,GAAG,IAAI,CAC7B,cAAc,CAAC,cAAc,CAAC,EAC9B,UAAU,GAAG,YAAY,CAC1B,GAAG;IACF,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAA;IACjC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,IAAI,CAAA;CACzD,CAAA;AAQD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,CAAC,UAO1C;AAED,wBAAgB,OAAO,CAAC,EACtB,UAAe,EACf,SAAmB,EACnB,SAAS,EACT,WAAgB,EAChB,YAAY,EACZ,IAAI,EACJ,GAAG,KAAK,EACT,EAAE,YAAY,+BA+Dd"}

package/dist/components/heatmap/heatmap.js

@@ -0,0 +1,30 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Tooltip, TooltipPopup, TooltipProvider, TooltipTrigger, } from 'weimo-ui-core/components/coss/tooltip';
+import { cn } from 'weimo-ui-core/lib/utils';
+import { getHeatColorClassName } from './heat-color';
+import { buildHeatmapCells, buildHeatmapColumns, buildHeatmapMonthLabels, formatHeatmapDateKey, } from './heatmap-model';
+import './heatmap.css';
+function formatCellAriaLabel(cell) {
+    const countLabel = `${cell.count} 条记录`;
+    return `${cell.date}，${countLabel}`;
+}
+export function formatHeatmapTooltip(cell) {
+    if (cell.count <= 0) {
+        return cell.date;
+    }
+    return `${cell.date}，${cell.count} 条记录`;
+}
+export function Heatmap({ activeDate = '', ariaLabel = '日期热力图', className, dailyCounts = [], onDateSelect, role, ...props }) {
+    const today = formatHeatmapDateKey(new Date());
+    const cells = buildHeatmapCells(dailyCounts, today, activeDate);
+    const columns = buildHeatmapColumns(cells);
+    const monthLabels = new Map(buildHeatmapMonthLabels(cells).map((label) => [
+        label.columnIndex,
+        label.name,
+    ]));
+    return (_jsx("div", { ...props, "aria-label": ariaLabel, className: cn('heatmap', className), role: role ?? 'group', children: _jsx("div", { className: "heatmap__grid", children: _jsx(TooltipProvider, { delay: 180, children: columns.map((column) => {
+                    const monthLabel = monthLabels.get(column.index);
+                    return (_jsxs("div", { className: "heatmap__column", children: [column.cells.map((cell) => (_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { render: _jsx("button", { "aria-label": formatCellAriaLabel(cell), className: cn('heatmap__cell', getHeatColorClassName(cell.level), cell.isActive && 'heatmap__cell--active', cell.isToday && 'heatmap__cell--today'), "data-count": cell.count, "data-date": cell.date, "data-level": cell.level, onClick: () => onDateSelect?.(cell.date, cell), type: "button" }) }), _jsx(TooltipPopup, { children: formatHeatmapTooltip(cell) })] }, cell.date))), monthLabel ? (_jsx("span", { className: "heatmap__month", children: monthLabel })) : (_jsx("span", { "aria-hidden": "true", className: "heatmap__month-spacer" }))] }, column.index));
+                }) }) }) }));
+}
+//# sourceMappingURL=heatmap.js.map

package/dist/components/heatmap/heatmap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heatmap.js","sourceRoot":"","sources":["../../../src/components/heatmap/heatmap.tsx"],"names":[],"mappings":"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"}

package/dist/components/heatmap/index.d.ts

@@ -0,0 +1,3 @@
+export { Heatmap, type HeatmapProps, } from './heatmap';
+export { buildHeatmapCells, buildHeatmapColumns, buildHeatmapMonthLabels, formatHeatmapDateKey, getHeatmapLevel, type HeatmapCell, type HeatmapColumn, type HeatmapDailyCount, type HeatmapLevel, type HeatmapMonthLabel, } from './heatmap-model';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/heatmap/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/heatmap/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,KAAK,YAAY,GAClB,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAA"}

package/dist/components/heatmap/index.js

@@ -0,0 +1,3 @@
+export { Heatmap, } from './heatmap';
+export { buildHeatmapCells, buildHeatmapColumns, buildHeatmapMonthLabels, formatHeatmapDateKey, getHeatmapLevel, } from './heatmap-model';
+//# sourceMappingURL=index.js.map

package/dist/components/heatmap/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/heatmap/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,GAER,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,GAMhB,MAAM,iBAAiB,CAAA"}

package/dist/components/stat-group/stat-group.css

@@ -0,0 +1,35 @@
+@layer components {
+  .stat-group {
+    display: flex;
+    width: 100%;
+    max-width: 243px;
+    flex-direction: row;
+    justify-content: space-between;
+    gap: 16px;
+    margin: 0 auto 12px;
+  }
+
+  .stat-group__item {
+    display: flex;
+    flex: 0 1 auto;
+    min-width: 0;
+    flex-direction: column;
+    align-items: flex-start;
+  }
+
+  .stat-group__value {
+    color: var(--color-text-secondary);
+    font-size: var(--font-size-stat);
+    font-weight: 600;
+    line-height: 1;
+    letter-spacing: -0.05em;
+  }
+
+  .stat-group__label {
+    margin-top: 8px;
+    margin-left: 1px;
+    color: var(--color-text-placeholder);
+    font-size: var(--font-size-sm);
+    line-height: 1;
+  }
+}

package/dist/components/stat-group/stat-group.d.css.ts

@@ -0,0 +1 @@
+export {}

package/dist/components/stat-group/stat-group.d.ts

@@ -0,0 +1,12 @@
+import type { ComponentPropsWithoutRef, ReactNode } from 'react';
+import './stat-group.css';
+export type StatGroupItem = {
+    key?: string;
+    value: ReactNode;
+    label: ReactNode;
+};
+export type StatGroupProps = ComponentPropsWithoutRef<'div'> & {
+    items?: StatGroupItem[];
+};
+export declare function StatGroup({ children, className, items, role, ...props }: StatGroupProps): import("react").JSX.Element;
+//# sourceMappingURL=stat-group.d.ts.map

package/dist/components/stat-group/stat-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stat-group.d.ts","sourceRoot":"","sources":["../../../src/components/stat-group/stat-group.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAIhE,OAAO,kBAAkB,CAAA;AAEzB,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,SAAS,CAAA;IAChB,KAAK,EAAE,SAAS,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,wBAAwB,CAAC,KAAK,CAAC,GAAG;IAC7D,KAAK,CAAC,EAAE,aAAa,EAAE,CAAA;CACxB,CAAA;AAED,wBAAgB,SAAS,CAAC,EACxB,QAAQ,EACR,SAAS,EACT,KAAU,EACV,IAAI,EACJ,GAAG,KAAK,EACT,EAAE,cAAc,+BAYhB"}

package/dist/components/stat-group/stat-group.js

@@ -0,0 +1,7 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from 'weimo-ui-core/lib/utils';
+import './stat-group.css';
+export function StatGroup({ children, className, items = [], role, ...props }) {
+    return (_jsxs("div", { className: cn('stat-group', className), role: role ?? 'group', ...props, children: [items.map((item, index) => (_jsxs("div", { className: "stat-group__item", children: [_jsx("span", { className: "stat-group__value", children: item.value }), _jsx("span", { className: "stat-group__label", children: item.label })] }, item.key ?? index))), children] }));
+}
+//# sourceMappingURL=stat-group.js.map

package/dist/components/stat-group/stat-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stat-group.js","sourceRoot":"","sources":["../../../src/components/stat-group/stat-group.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,EAAE,EAAE,MAAM,yBAAyB,CAAA;AAE5C,OAAO,kBAAkB,CAAA;AAYzB,MAAM,UAAU,SAAS,CAAC,EACxB,QAAQ,EACR,SAAS,EACT,KAAK,GAAG,EAAE,EACV,IAAI,EACJ,GAAG,KAAK,EACO;IACf,OAAO,CACL,eAAK,SAAS,EAAE,EAAE,CAAC,YAAY,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,OAAO,KAAM,KAAK,aAC1E,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAC1B,eAAK,SAAS,EAAC,kBAAkB,aAC/B,eAAM,SAAS,EAAC,mBAAmB,YAAE,IAAI,CAAC,KAAK,GAAQ,EACvD,eAAM,SAAS,EAAC,mBAAmB,YAAE,IAAI,CAAC,KAAK,GAAQ,KAFlB,IAAI,CAAC,GAAG,IAAI,KAAK,CAGlD,CACP,CAAC,EACD,QAAQ,IACL,CACP,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,81 @@
 {
   "name": "weimo-ui-stats",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "private": false,
+  "version": "0.1.0",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jiaowenjun/weimo-ui-stats.git"
+  },
+  "packageManager": "pnpm@12.4.2",
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    "./components/heat-color": {
+      "types": "./dist/components/heatmap/heat-color.d.ts",
+      "import": "./dist/components/heatmap/heat-color.js"
+    },
+    "./components/heatmap": {
+      "types": "./dist/components/heatmap/index.d.ts",
+      "import": "./dist/components/heatmap/index.js"
+    },
+    "./components/stat-group": {
+      "types": "./dist/components/stat-group/stat-group.d.ts",
+      "import": "./dist/components/stat-group/stat-group.js"
+    },
+    "./styles/heat-color.css": {
+      "types": "./dist/components/heatmap/heat-color.d.css.ts",
+      "default": "./dist/components/heatmap/heat-color.css"
+    },
+    "./styles/heatmap.css": {
+      "types": "./dist/components/heatmap/heatmap.d.css.ts",
+      "default": "./dist/components/heatmap/heatmap.css"
+    },
+    "./styles/stat-group.css": {
+      "types": "./dist/components/stat-group/stat-group.d.css.ts",
+      "default": "./dist/components/stat-group/stat-group.css"
+    }
+  },
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "pnpm clean && tsc -p tsconfig.build.json && node scripts/copy-css.mjs",
+    "site:dev": "pnpm build && pnpm --dir site dev",
+    "site:build": "pnpm build && pnpm --dir site build",
+    "site:preview": "pnpm --dir site preview",
+    "typecheck": "tsc -p tsconfig.json --noEmit --pretty false",
+    "test:typecheck": "pnpm typecheck",
+    "test": "vitest run",
+    "check:package": "pnpm build && publint && attw --pack . --profile esm-only --ignore-rules internal-resolution-error",
+    "test:site-template": "node scripts/site-template-contract.mjs",
+    "verify": "pnpm typecheck && pnpm test && pnpm test:site-template && pnpm check:package && pnpm --dir site build",
+    "prepack": "pnpm build"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "weimo-ui-core": "~0.2.0"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.5",
+    "@base-ui/react": "1.9.0",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "publint": "^0.3.25",
+    "react": "19.3.0",
+    "react-dom": "19.3.0",
+    "rimraf": "^6.1.3",
+    "typescript": "~7.0.2",
+    "vitest": "^5.0.3",
+    "weimo-ui-core": "~0.2.1"
+  }
+}