MoUI 是一个多平台 MoonBit GUI 框架，用于构建具有共享平台无关应用逻辑的声明式 UI 应用。支持 Windows/macOS/Linux/Android/iOS/HarmonyOS。原生宿主核心拥有窗口、事件、服务和生命周期，然后通过平台渲染器提供程序包接收具体的渲染器。

文件	最后提交记录	最后更新时间
.agents	feat: remove osc2026-guide submodule from .gitmodules	10 天前
.github	feat: establish ecosystem compatibility governance	10 天前
.zcode	Enhance GPU context management and logging for HarmonyOS and Android - Abandon GPU context before unreferencing to prevent blocking submits during teardown on HarmonyOS. - Ensure EGL window surface geometry and usage flags are set before creation to avoid rendering issues. - Adjust surface origin handling to match Metal/Vulkan workers for consistent rendering. - Improve logging for lifecycle events and service probe interactions in Android and HarmonyOS. - Streamline accessibility tree parsing for HarmonyOS to accommodate differences from Android. - Implement continuous log streaming for both Android and HarmonyOS to capture high-frequency events. - Refactor screenshot handling for HarmonyOS to support JPEG format and conversion to PNG.	1 个月前
benchmarks	Refactor popover and sheet handling to use unified presentation model - Renamed to in multiple files to standardize naming. - Removed implementation and replaced it with for managing sheets. - Introduced , , and related enums to encapsulate presentation logic. - Updated tests and layout contexts to accommodate new presentation structure. - Adjusted API surface classifications and budgets to reflect changes in presentation handling.	8 天前
checks	fix: update line count for runtime facade in API surface report	1 天前
docs	feat(rich_text_cache): implement memoization for editor hot paths and enhance height calculations	1 天前
examples	docs: bump window package version to 0.5.4-0.1.7	3 天前
memories	fix(windows): scope MSVC C11 mode to WGPU routes instead of the shared CL default cl rejects /std:c11 on the same command line as /std:c++20 (D8016), so the unconditional /std:c11 in msvc_env.ps1's CL broke every Skia-route build compiling moui_skia's /std:c++20 C++ stubs. The build/package helpers already gate Enable-MsvcGlobalC11ModeForCOnlyStubs on WGPU usage; restore that design by removing /std:c11 from the shared CL and document the WGPU opt-in flow.	3 天前
moui	feat(macos): add optional frame clock to MacosHostAppOptions and HostRuntimeDriver	2 天前
moui_3d	docs: bump window package version to 0.5.4-0.1.7	3 天前
moui_3d_physics	Refactor popover and sheet handling to use unified presentation model - Renamed to in multiple files to standardize naming. - Removed implementation and replaced it with for managing sheets. - Introduced , , and related enums to encapsulate presentation logic. - Updated tests and layout contexts to accommodate new presentation structure. - Adjusted API surface classifications and budgets to reflect changes in presentation handling.	8 天前
moui_3d_physics_rapier	feat: add tests for rapier adapter and improve web renderer functionality - Implement tests for the rapier adapter to verify gravity integration and collision detection with fixed ground. - Enhance the web renderer by introducing a binary mesh drawing function and updating resource management. - Update the version of the moui_3d and moui_3d_wgpu_renderer modules to 0.1.10. - Introduce a new module for moui_3d_xr, providing OpenXR and WebXR contracts. - Refactor vertex buffer handling in the native 3D renderer to optimize resource uploads. - Add support for resource residency updates in the web GPU imports.	11 天前
moui_3d_web_renderer	Refactor popover and sheet handling to use unified presentation model - Renamed to in multiple files to standardize naming. - Removed implementation and replaced it with for managing sheets. - Introduced , , and related enums to encapsulate presentation logic. - Updated tests and layout contexts to accommodate new presentation structure. - Adjusted API surface classifications and budgets to reflect changes in presentation handling.	8 天前
moui_3d_wgpu_renderer	Refactor popover and sheet handling to use unified presentation model - Renamed to in multiple files to standardize naming. - Removed implementation and replaced it with for managing sheets. - Introduced , , and related enums to encapsulate presentation logic. - Updated tests and layout contexts to accommodate new presentation structure. - Adjusted API surface classifications and budgets to reflect changes in presentation handling.	8 天前
moui_3d_xr	Refactor popover and sheet handling to use unified presentation model - Renamed to in multiple files to standardize naming. - Removed implementation and replaced it with for managing sheets. - Introduced , , and related enums to encapsulate presentation logic. - Updated tests and layout contexts to accommodate new presentation structure. - Adjusted API surface classifications and budgets to reflect changes in presentation handling.	8 天前
moui_agent	Refactor popover and sheet handling to use unified presentation model - Renamed to in multiple files to standardize naming. - Removed implementation and replaced it with for managing sheets. - Introduced , , and related enums to encapsulate presentation logic. - Updated tests and layout contexts to accommodate new presentation structure. - Adjusted API surface classifications and budgets to reflect changes in presentation handling.	8 天前
moui_agent_mcp	Refactor popover and sheet handling to use unified presentation model - Renamed to in multiple files to standardize naming. - Removed implementation and replaced it with for managing sheets. - Introduced , , and related enums to encapsulate presentation logic. - Updated tests and layout contexts to accommodate new presentation structure. - Adjusted API surface classifications and budgets to reflect changes in presentation handling.	8 天前
moui_cli	fix: update StringBuilder initialization to use default constructor in multiple files	8 天前
moui_devtools	Refactor popover and sheet handling to use unified presentation model - Renamed to in multiple files to standardize naming. - Removed implementation and replaced it with for managing sheets. - Introduced , , and related enums to encapsulate presentation logic. - Updated tests and layout contexts to accommodate new presentation structure. - Adjusted API surface classifications and budgets to reflect changes in presentation handling.	8 天前
moui_i18n	Add localization support for Simplified Chinese - Updated visuals.mbt to include locale parameter in hero_demo_panel, hero_source_panel, and hero_counter_panel functions for localized text rendering. - Modified website_app_wbtest.mbt to include tests for localized English and Simplified Chinese homepage sections. - Enhanced docs-catalog.json with localized entries for Simplified Chinese, including titles and summaries for various documentation sections. - Updated moon.mod to import the new moui_i18n module for internationalization support. - Adjusted main.mbt to apply locale settings in the web application runtime. - Expanded sitemap.xml to include localized routes for Simplified Chinese.	1 个月前
moui_richtext	feat(rich_text_cache): implement memoization for editor hot paths and enhance height calculations	1 天前
moui_skia	docs: bump window package version to 0.5.4-0.1.7	3 天前
moui_skia_renderer	test(moui_skia_renderer): make emoji fallback tests host-capability aware	3 天前
moui_sun	chore: bump remaining modules to 0.1.10 and fix CI version pins - bump moui_sun, moui_sun_renderer, moui_agent, moui_agent_mcp, moui_devtools, moui_richtext, moui_theme to 0.1.10 - update all workspace moon.mod pins from 0.1.9 to 0.1.10 for moui, moui_skia, moui_sun, renderers, addons and 3d modules - update benchmarks, examples, website, tools_product, moui_tests to match catalog versions (fixes validate_release_module_closures) - update scripts/external-consumer-ci.mjs headVersion to 0.1.10 (fixes package missing wzzc-dev-moui-0.1.9.zip) - update moui_cli default dependency version and generator tests to 0.1.10 and reformat with moon fmt - update docs/development.md and README snippets to 0.1.10 - format deepseek_harness_desktop submodule (bb935e8) and bump superproject gitlink Fixes MoUI CI PR profile gate and external consumer failures after 0.1.9 -> 0.1.10 upgrade.	10 天前
moui_sun_renderer	Refactor popover and sheet handling to use unified presentation model - Renamed to in multiple files to standardize naming. - Removed implementation and replaced it with for managing sheets. - Introduced , , and related enums to encapsulate presentation logic. - Updated tests and layout contexts to accommodate new presentation structure. - Adjusted API surface classifications and budgets to reflect changes in presentation handling.	8 天前
moui_tests	Refactor popover and sheet handling to use unified presentation model - Renamed to in multiple files to standardize naming. - Removed implementation and replaced it with for managing sheets. - Introduced , , and related enums to encapsulate presentation logic. - Updated tests and layout contexts to accommodate new presentation structure. - Adjusted API surface classifications and budgets to reflect changes in presentation handling.	8 天前
moui_theme	Refactor popover and sheet handling to use unified presentation model - Renamed to in multiple files to standardize naming. - Removed implementation and replaced it with for managing sheets. - Introduced , , and related enums to encapsulate presentation logic. - Updated tests and layout contexts to accommodate new presentation structure. - Adjusted API surface classifications and budgets to reflect changes in presentation handling.	8 天前
moui_web_renderer	Refactor popover and sheet handling to use unified presentation model - Renamed to in multiple files to standardize naming. - Removed implementation and replaced it with for managing sheets. - Introduced , , and related enums to encapsulate presentation logic. - Updated tests and layout contexts to accommodate new presentation structure. - Adjusted API surface classifications and budgets to reflect changes in presentation handling.	8 天前
moui_webview	docs: bump window package version to 0.5.4-0.1.7	3 天前
moui_wgpu_renderer	fix: update maxLines for WGPU renderer and adjust line budget constraints	5 天前
resource	feat: Enhance component catalog and welcome page with new features and branding assets - Updated the description in the component catalog to reflect the new live bouncing-ball canvas feature. - Refactored checkbox group demo to utilize model state for selected items. - Introduced a new bouncing-ball canvas component in the welcome demo, driven by an animated canvas paint clock. - Added a new checkbox group selection state to the ComponentGalleryModel for managing checkbox selections. - Implemented drag gesture state persistence in the view tree to enhance user interaction. - Adjusted slider control to accurately reflect rendered frame dimensions during drag events. - Improved scroll container clipping to align with the rendered frame size. - Added comprehensive branding assets including logos, mascots, and a brand board with usage guidelines.	1 个月前
scripts	docs: update Windows prerequisites and environment setup for C11 atomics support	3 天前
skills	docs: bump window package version to 0.5.4-0.1.7	3 天前
smoke	feat(accessibility): Enhance accessibility features and validation scripts - Added semantic IDs to nodes in the web semantics DOM manager for better accessibility tracking. - Introduced a new script `validate-accessibility-foundation.mjs` for validating accessibility manifests and work packages. - Created `web-accessibility-probe.sh` to run accessibility probes in a headless Chrome environment. - Updated smoke tests to include new accessibility validation gates for screen-reader evidence and native accessibility client evidence. - Adjusted budgets in various MBT files to accommodate new accessibility features and ensure compliance with updated requirements. - Updated submodule reference for the window project.	12 天前
tools	fix: update maxLines for WGPU renderer and adjust line budget constraints	5 天前
tools_product	Refactor popover and sheet handling to use unified presentation model - Renamed to in multiple files to standardize naming. - Removed implementation and replaced it with for managing sheets. - Introduced , , and related enums to encapsulate presentation logic. - Updated tests and layout contexts to accommodate new presentation structure. - Adjusted API surface classifications and budgets to reflect changes in presentation handling.	8 天前
website	Refactor popover and sheet handling to use unified presentation model - Renamed to in multiple files to standardize naming. - Removed implementation and replaced it with for managing sheets. - Introduced , , and related enums to encapsulate presentation logic. - Updated tests and layout contexts to accommodate new presentation structure. - Adjusted API surface classifications and budgets to reflect changes in presentation handling.	8 天前
window @b33c9f0a	chore: update subproject commit reference for window	3 天前
.gitattributes	Add shell runtime manifest validation and update documentation - Introduced a new package for validating shell runtime manifests in `tools/moui/validate_shell_runtime_manifest/moon.pkg`. - Added comprehensive tests for validating shell runtime manifests in `tools/moui/validate_shell_runtime_manifest/validate_shell_runtime_manifest_wbtest.mbt`. - Updated documentation references in `website/docs-catalog.json` to reflect changes from "Mobile Mainline Roadmap" to "Shell Mainline Roadmap" and "Mobile Runtime ABI v1" to "Embedding API v1". - Modified sitemap entries in `website/web_wasm/sitemap.xml` to align with the updated documentation paths. (cherry picked from commit ff6303bd0728b7b1623482890ba6746e67317d50)	1 个月前
.gitignore	feat: update module versions to 0.1.10 and clean up .gitignore	10 天前
.gitmodules	chore: make examples/deepseek_harness_desktop a submodule Convert tracked directory to git submodule pointing to https://github.com/moui-mbt/deepseek-harness-desktop.git (branch main, fc7ded3). The standalone history was extracted via git subtree split -P examples/deepseek_harness_desktop and now lives in moui-mbt/deepseek-harness-desktop; the superproject keeps the same path as a gitlink so moon.work member ./examples/deepseek_harness_desktop continues to resolve. moon test examples/deepseek_harness_desktop/app --target native still passes (23 tests).	10 天前
.moonbit-toolchain	fix: update StringBuilder initialization to use default constructor across multiple files	8 天前
AGENTS.md	Add Linux RISC-V64 support and cross-build scripts - Introduced a new plan for supporting Linux RISC-V64, including goals and acceptance criteria in `docs/plans/active/linux-riscv64-support.md`. - Created `scripts/linux-riscv64-cross-build.sh` to facilitate cross-building the canonical Linux Skia Showcase and running offscreen Skia renderer/text smokes. - Developed `scripts/prepare-linux-riscv64-sysroot.sh` for preparing the locked Ubuntu RISC-V64 glibc sysroot. - Implemented `scripts/test-linux-riscv64-cross-build.sh` for self-testing the cross-build helper with various scenarios. - Added validation tests for the RISC-V64 architecture variant in `tools/moui/validate_platform_matrix/model_wbtest.mbt`.	23 天前
CODE_OF_CONDUCT.md	docs: add community and contribution guidelines	2 个月前
CONTRIBUTING.md	refactor: converge backend and render packages	28 天前
GOVERNANCE.md	refactor: budget constraints and guidance consistency checks - Updated budget constraints for the runtime facade, backend host, and render packages to reflect new limits on lines and public lines. - Adjusted the validation tests to align with the new budget constraints for the runtime facade. - Introduced a new function to define top-level guidance files and updated the guidance surface files accordingly. - Added tests to ensure the top-level public documentation files are included in the forbidden guidance scan. - Revised the maintenance baseline budgets, reducing maximum counts for various packages and adjusting line budgets for specific files to improve consistency and maintainability.	1 个月前
LICENSE	feat: add Apache License 2.0 to the repository	3 个月前
README.md	fix: promote Linux to committed product class and update related documentation	3 天前
README.zh-CN.md	fix: promote Linux to committed product class and update related documentation	3 天前
SECURITY.md	refactor: converge backend and render packages	28 天前
THIRD_PARTY.md	docs: update Gitlink link and add THIRD_PARTY.md	1 个月前
gradlew	feat: add mobile runtime manifest validation and testing scripts - Introduced `test-validate-mobile-runtime-manifest.mjs` for testing mobile runtime manifest validation. - Created `validate-mobile-runtime-manifest.mjs` to validate mobile runtime manifests against defined schemas. - Updated documentation to reflect new build scripts for mobile applications. - Added new mobile runtime smoke gates for both Counter and Component Gallery apps on Android and iOS. - Enhanced line budget configurations for maintenance baseline validation. - Implemented new MoonBit tool for validating mobile runtime manifests with comprehensive test cases.	1 个月前
moon.work	feat(perf): enforce application performance budgets	10 天前

MoUI

多平台 MoonBit 声明式 GUI 框架 — 使用共享的平台无关应用逻辑构建声明式 UI 应用

简体中文 | English

快速开始 · 项目结构 · 运行示例 · 文档 · 贡献

MoUI 是一个多平台 MoonBit GUI 框架，用于构建声明式 UI 应用，共享平台无关的应用逻辑。原生宿主核心拥有窗口、事件、服务和生命周期，再通过平台渲染器提供方包（renderer provider packages）接入具体的渲染器。

欢迎贡献 — 请参阅 CONTRIBUTING.md。

当前主线为原生 Skia 光栅化 + Web wasm-gc + window/web + 浏览器 WebGPU host imports 路径。原生 WGPU 仍作为实验性诊断路径保留，等待 MoonBit WGPU 生态进一步成熟。

支持平台（产品形态）

平台	形态	说明
macOS	committed	产品主线（L0–L3 证据完备）
Web	committed	产品主线（wasm-gc + WebGPU）
Windows	committed	产品主线（L0–L3 证据完备）
Linux	committed	产品主线（L0–L3 证据完备）
Android	experimental	Window 托管路径可编译；暂无可用性/产品承诺
iOS	experimental	同 Android
HarmonyOS	experimental	同上；已签名真机的完整 smoke 仍待补齐

移动端不是“仅胶水代码”，也不是产品级已承诺形态，而是 experimental：代码可编译、宿主模拟测试可通过，但在提供真机匹配证据前，不对开发/演示可用性或产品承诺做保证。详见平台就绪声明。

运行时管线是显式的：

View[Msg] -> ElementTree -> LayoutTree -> RenderTree -> DrawCommand -> renderer

项目结构

moui/core/ 拥有平台无关的契约、不透明 View、类型化事件、Program、Effect、Subscription、几何、绘制、语义，以及被类型化 View[Msg] 包装的、与消息无关的公共 ViewNode 扩展协议。
moui/views/ 拥有公共视图构造器和具体控件行为，以 @core.ViewNode 值实现，并通过 @core.View::from_node 构造，不新增 core 枚举变体。
moui/runtime/ 对外暴露应用/宿主 AppRuntime 构造入口，并拥有运行时状态、树/布局/绘制、事件分发、程序消息排空、effect 任务、subscription 生命周期和诊断。
moui/views/ 为应用代码返回面向应用的 @moui.View[Msg] 值。
moui/backend/ 定义共享宿主契约；平台后端将窗口与输入事件归一化为 Event。
moui/backend/<platform>/ 仅拥有中立宿主；应用在组合根（composition root）中选择 moui_skia_renderer 或其他渲染器提供方。
moui/render/ 提供渲染器门面，原生 Skia 光栅、WebGPU 适配器以及实验性原生 WGPU 实现分别位于 moui_skia_renderer/、moui_web_renderer/ 和 moui_wgpu_renderer/。
moui_theme/ 是可选的附加 workspace 成员，提供带源码映射的 Material、Carbon、Primer、Fluent 主题预览，以及首个自研的 Smartisan 风格 Sickle 拟物/扁平混合主题。
examples/*/app/ 包含共享的应用逻辑，平台子包为轻量入口。
website/ 为 MoUI 官网与 Web 演示站点。

截图

快速开始

选择与你的目标匹配的路径。

Playground 在线体验

打开浏览器 Playground，无需安装原生工具链即可在线编辑和运行引导示例。这是最短的学习 view/update 模型与验证 Web 行为的路径。

独立项目

安装独立 CLI，然后在仓库外生成新项目：

moon install wzzc-dev/moui_cli/cmd/moui
moui new my_app
# 更小的骨架： moui new my_app --template hello
cd my_app
moon update
moon check
moon run macos_skia --target native   # 或在对应宿主上使用 windows_skia / linux_skia

moui new 会创建共享应用逻辑 + Web 与当前桌面端入口。如需 Android、iOS 或 HarmonyOS，请显式添加 --platform；移动端项目使用 wzzc-dev/window 模板，并将生命周期、surface 与输入保留在平台事件循环中。详见快速上手。

本仓库开发

当你需要修改 MoUI 本身或运行完整功能示例时，使用此路径：

git clone --recurse-submodules https://github.com/wzzc-dev/MoUI.git
cd MoUI
sh scripts/ci-moon-update.sh
sh scripts/check.sh --profile pr
moon test examples/showcase/app --target native
moon test examples/markdown_editor/app --target native

国内用户也可通过 GitCode 镜像获取代码：

git clone https://gitcode.com/wzzc/MoUI.git

Showcase 与 Markdown Editor 是主要的扫描与交互示例，其平台入口列于运行示例。

框架安装细节（包括可选子模块与 window/ 本地源码工作流）见 Development。

默认的 daily 基线覆盖核心框架、维护基线棘轮、Web wasm-gc、原生 Skia 主线契约、Showcase 与 Markdown Editor。Design Systems 为附加诊断覆盖；当改动 moui_theme 或 examples/design_systems 时请运行 sh scripts/check.sh --profile theme。

当前宿主的后端/提供方检查：

sh scripts/check.sh --profile platform

面向发布的截图与基准交接：

node scripts/conformance-capture-scaffold.mjs --mode golden
node scripts/conformance-capture-scaffold.mjs --mode benchmark

这些命令会在 artifacts/ 下生成本地脚手架清单与日志；发布说明应引用相关的 CI 运行、已上传产物或 smoke 日志，而非提交生成产物。artifacts/ 已被忽略，请将其作为本地或 CI 证据保留。

运行示例

精选示例 — showcase、markdown_editor、mo_workbench 和 excel — 在 examples/<name>/app 中共享应用逻辑，并暴露轻量平台入口。Showcase 拥有 web_wasm、桌面端渲染器专属入口，以及 android_window_hosted、ios_window_hosted 和 harmonyos_window_hosted 移动端入口。

如需在移动端尝试 Showcase，请按对应平台的安装、构建与运行说明操作： Android、iOS 或 HarmonyOS。标准示例通过 moui build 使用匹配的 wzzc-dev/window 平台模板。

Windows 前置条件： 在构建或运行任何 Windows 原生入口（windows_skia，或 windows_wgpu 诊断路线）前，请在 PowerShell 会话中初始化 MSVC 工具链：
.\scripts\windows\msvc_env.ps1
该脚本会为原生 Skia 链接步骤配置 MSVC 环境，并提供共享的 C11 atomics 基础选项（/experimental:c11atomics）。在 Windows 上执行 moon run ... --target native 之前，每个 shell 需运行一次。windows_wgpu 诊断路线的 wgpu_mbt C stub（<stdatomic.h>）还需要 C11 模式（/std:c11）：Windows 构建/打包辅助脚本会对 WGPU 包自动启用；直接 moon run 时请先点源脚本并调用 Enable-MsvcGlobalC11ModeForCOnlyStubs（共享默认的 /std:c11 会与 moui_skia 的 /std:c++20 Skia stub 选项冲突）。

Showcase

横跨桌面、移动与 Web 的统一 Components、Patterns、Platform 与 Diagnostics 工作区。源码位于 examples/showcase/app，平台入口保持轻量。

# Web (wasm-gc)
moon build examples/showcase/web_wasm --target wasm-gc

# macOS Skia
moon run examples/showcase/macos_skia --target native

# Windows Skia（先在 PowerShell 中运行 msvc_env.ps1）
.\scripts\windows\msvc_env.ps1
moon run examples/showcase/windows_skia --target native

# Linux Skia
moon run examples/showcase/linux_skia --target native

Markdown Editor

所见即所得的类 Typora Markdown 编辑器。源码位于 examples/markdown_editor/app，保留的 macOS/Web 入口保持轻量。

# Web (wasm-gc)
moon build examples/markdown_editor/web_wasm --target wasm-gc

# macOS Skia
moon run examples/markdown_editor/macos_skia --target native

Mo Workbench

以原生 Skia 为先的桌面端 Agent 内部产品。当前仅接入 macos_skia；Linux/Windows/Web 入口已预留。bobzhang/openseek 依赖从 mooncakes.io 解析（在 examples/mo_workbench/moon.mod 中已 pin）；无需子模块或 workspace 成员覆盖。

moon run examples/mo_workbench/macos_skia --target native

Excel Viewer

基于 MoonBit Excel（bobzhang/mbtexcel）文件的渲染器，使用 MoUI 数据表组件。共享应用逻辑位于 examples/excel/app，保留 macos_skia 入口。

# macOS Skia
moon run examples/excel/macos_skia --target native

精选示例的应用包聚焦测试：

moon test examples/markdown_editor/app --target native
moon test examples/mo_workbench/app --target native
moon test examples/showcase/app --target native
moon test examples/excel/app --target native

包形态与平台覆盖详见 Showcase、Examples、Markdown Editor、Mo Workbench 与 Showcases。

文档

源码文档位于 docs/。网站预览通过 node scripts/sync-website-docs.mjs 将这些 Markdown 文件复制到 website/web_wasm/docs/。

贡献

MoUI 由单一维护者借助 AI 协助维护，对外部贡献持开放态度。Pull Request 是变更的主要入口。

贡献指南 — 环境搭建、包边界、PR 要求、DCO
治理 — 决策机制、RFC 流程、维护者角色、项目交接
安全策略 — 漏洞上报与支持范围
行为准则

许可证

Apache-2.0。详见 LICENSE。

第三方依赖与归属说明汇总于 THIRD_PARTY.md。

项目介绍

https://wzzc-dev.github.io/MoUI/

Apache-2.0 JavaScript 2.12 K提交数moonbit wgpu skia harmonyos 原生跨端gui框架 ios