@hxdhxd/harmony-flow-ui 0.3.0 → 0.4.0

package/README.md

@@ -12,6 +12,14 @@
 - 组合与模板：六个组合模式、三个现有模板、源码预览及完整模板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)。
@@ -159,7 +167,7 @@ npm start
 
 ## 发布状态与下一步
 
-正式 npm 包名为 `@hxdhxd/harmony-flow-ui`，本次发布版本为 `0.3.0`。后续建议在每次发布前更新版本号、运行完整质量门，并在 GitHub 创建对应 Release 或维护变更日志。
+正式 npm 包名为 `@hxdhxd/harmony-flow-ui`，本次发布版本为 `0.4.0`。后续建议在每次发布前更新版本号、运行完整质量门，并在 GitHub 创建对应 Release 或维护变更日志。
 
 本项目采用 [MIT License](./LICENSE)，允许免费用于个人和商业项目；再分发时须保留原许可证和版权声明。
 
@@ -324,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 安装包，普通组件页面不会下载这些资源。同页增强实例需使用统一主题；完整能力和边界见上方接入说明。