@hxdhxd/harmony-flow-ui 0.2.0 → 0.4.0

package/README.md

@@ -4,7 +4,7 @@
 
 ## 组件工作区布局改造（2026-09-03）
 
-展示站现采用顶部产品导航、九类组件导航、159组件卡片/列表浏览、全局搜索、收藏与最近访问。组件详情保持原URL，提供本页目录、真实预览与基于文档Props的属性控制。复杂对象和回调沿用可运行示例，浮层开关由示例触发器管理。
+展示站现采用顶部产品导航、九类组件导航、166组件卡片/列表浏览、全局搜索、收藏与最近访问。组件详情保持原URL，提供本页目录、真实预览与基于文档Props的属性控制。复杂对象和回调沿用可运行示例，浮层开关由示例触发器管理。
 
 - 本地预览：`npm run build:demo` 后运行 `npm run serve`，访问 `http://127.0.0.1:6633`。
 - 构建产物：`build/workspace-<构建时间>`；`demo-dist` 为兼容运行入口，旧产物先归档到 `laji`。
@@ -12,9 +12,25 @@
 - 组合与模板：六个组合模式、三个现有模板、源码预览及完整模板ZIP。
 - [改造执行与验收](./plan/frontend/component-workspace-20260903/04-执行与验收.md)
 
+## 0.4.0 版本
+
+新增可选 Monaco 编辑器入口，支持语法高亮、补全、诊断、查找、格式化和按文件保留撤销记录；完善文件浏览与文件预览 UI。增强资源及 Worker 同源按需加载，移动端或加载失败使用轻量模式。原主入口和 CodeEditor 接口保持兼容。发布状态见 [0.4.0 发布记录](./plan/release/0.4.0.md)。
+
+```sh
+npm install @hxdhxd/harmony-flow-ui@0.4.0
+```
+
+## 0.3.0 版本
+
+新增任务进度、返回顶部、层级侧栏、长页面导航、底部导航、下拉刷新和移动内容导航；完善文件树 UI、键盘导航、受控展开与文件搜索示例。保留已有公开 API。发布状态见 [0.3.0 发布记录](./plan/release/0.3.0.md)。
+
+```sh
+npm install @hxdhxd/harmony-flow-ui@0.3.0
+```
+
 ## 0.2.0 版本
 
-前十批交互组件和组件工作区统一纳入0.2.0，保留0.1.2公开API。发布记录见[0.2.0](./plan/release/0.2.0.md)。
+2026-09-08：前十批交互组件和组件工作区已发布为npm 0.2.0，并同步GitHub main，保留0.1.2公开API。发布记录见[0.2.0](./plan/release/0.2.0.md)。
 
 ```sh
 npm install @hxdhxd/harmony-flow-ui@0.2.0
@@ -22,11 +38,17 @@ npm install @hxdhxd/harmony-flow-ui@0.2.0
 
 ## 项目概览
 
-- 当前工作区含 159 个可用组件（0.2.0新增共 22 个交互组件，另增强原有看板），覆盖基础控件、表单、导航、数据展示、反馈、布局、协作、调度与 AI 交互场景
+- 当前工作区含 166 个可用组件，覆盖基础控件、表单、导航、数据展示、反馈、布局、协作、调度与 AI 交互场景
 - React + TypeScript 实现，同时输出 ESM、CommonJS、类型声明和独立样式文件
 - 内置组件展厅、成品场景、交互示例、Props 文档与无障碍说明
 - 支持主题 Token、界面密度以及桌面、平板和移动视口预览
-- 统一质量门覆盖类型检查、构建、166 项公开 API、164 条展示路由、浏览器交互和视觉回归
+- 统一质量门覆盖类型检查、构建、173 项公开 API、171 条展示路由、浏览器交互和视觉回归
+
+## 第十一批：任务进度（2026-09-10）
+
+新增泛型 `TaskProgress`：统一呈现后台任务的分阶段进度、结果返回、取消与失败重试。`run` 通过 `report` 更新阶段和百分比，通过 `AbortSignal` 响应取消；`taskKey` 切换会隔离旧任务的迟到结果。
+
+预览 `/components/taskprogress`；专项构建与验收入口见[第十一批执行与验收](./plan/development/douyin-20260910-11/执行与验收.md)。
 
 ## 第十批：乐观更新（2026-09-07，纳入0.2.0）
 
@@ -145,7 +167,7 @@ npm start
 
 ## 发布状态与下一步
 
-正式 npm 包名为 `@hxdhxd/harmony-flow-ui`，当前版本为 `0.1.1`。后续建议在每次发布前更新版本号、运行完整质量门，并在 GitHub 创建对应 Release 或维护变更日志。
+正式 npm 包名为 `@hxdhxd/harmony-flow-ui`，本次发布版本为 `0.4.0`。后续建议在每次发布前更新版本号、运行完整质量门，并在 GitHub 创建对应 Release 或维护变更日志。
 
 本项目采用 [MIT License](./LICENSE)，允许免费用于个人和商业项目；再分发时须保留原许可证和版权声明。
 
@@ -310,3 +332,19 @@ npm view @hxdhxd/harmony-flow-ui version --registry=https://registry.npmjs.org/
 新增 `ReadingProgress` 阅读进度，支持整页与独立滚动容器，自动响应内容与尺寸变化。表示滚动位置，不记录已读或业务完成度；不可滚动内容显示100%，未挂载目标显示0%。沿用现有主题，无新依赖。
 
 无删除构建：`node test/build-douyin-batch8.mjs`；行为与旧组件像素回归：`python test/verify-douyin-batch8.py`。记录见 `plan/development/douyin-20260905-08/执行与验收.md`。
+
+## Monaco 可选增强编辑器（0.4.0）
+
+新增独立 `@hxdhxd/harmony-flow-ui/monaco` 入口，展示站代码页默认使用 Monaco。原 `CodeEditor` 和主入口兼容保留。运行时与 Worker 按需同源加载，移动端和加载失败自动使用轻量输入。使用方式、资源复制、主题与撤销边界见 [接入说明](plan/frontend/monaco-20260923/接入说明.md)。
+
+
+```tsx
+import { MonacoCodeEditor } from '@hxdhxd/harmony-flow-ui/monaco';
+import '@hxdhxd/harmony-flow-ui/style.css';
+import '@hxdhxd/harmony-flow-ui/monaco/style.css';
+
+<MonacoCodeEditor path="main.ts" language="typescript"
+  value={code} onChange={setCode} assetsUrl="/monaco/" />
+```
+
+将包内 `dist/monaco-assets/` 全部复制到站点 `/monaco/`，包括 chunks、fonts、Worker、CSS 和许可证；支持通过 assetsUrl 设置其他同源目录。无需使用方额外安装 monaco-editor。预置资源会增大 npm 安装包，普通组件页面不会下载这些资源。同页增强实例需使用统一主题；完整能力和边界见上方接入说明。