@nanahoshi/mona-ui

中文文档
0.23.0发布于 2026/11/02TypeScriptES Module构建来源已验证

A very light Angular UI framework

原始使用文档
文档目录10 节
  1. Features
  2. Documentation
  3. Quick Start
  4. Installation
  5. Setup Internationalization
  6. Development
  7. Building the Library
  8. Running Tests
  9. i18n & RTL Quality Audit
  10. License

Mona UI

A modern, high-performance, accessible UI component library built for Angular and styled with Tailwind CSS.


Features

  • Signal-Based State & Reactive Architecture: First-class Angular Signals architecture for fine-grained reactivity.
  • Standalone Components: Designed exclusively with modern Angular standalone components.
  • Comprehensive Internationalization (i18n): Zero-config English defaults with full runtime locale switching, typed message namespaces, and message override precedence.
  • RTL-Ready: Fully prepared for right-to-left layout direction with CSS Logical Properties and CDK-driven directionality.
  • High-Grade Accessibility (a11y): Strict adherence to WCAG AA minimums, dynamic ARIA attributes, and zero AXE violations.
  • 40+ Rich Components: Data grids, interactive charts, calendar/pickers, rich text editor, scroll view, dialogs, dropdowns, and more.

Documentation


Quick Start

Installation

npm install @nanahoshi/mona-ui

Setup Internationalization

Mona UI works out-of-the-box in English without configuration. To provide a customized locale or configure runtime language switching, import provideMonaI18n:

import { ApplicationConfig } from '@angular/core';
import { provideMonaI18n } from '@nanahoshi/mona-ui/i18n';

export const appConfig: ApplicationConfig = {
    providers: [
        provideMonaI18n()
    ]
};

For complete details on localization, locale switching, and RTL support, refer to the i18n & RTL Guide.


Development

Building the Library

npm run build:metadata
npm run build:prod

Running Tests

# Run unit tests for the component library
npm run test:lib

# Run unit tests for the tester app
npm run test:app

i18n & RTL Quality Audit

Mona UI includes an automated AST-based scanner to verify that no hard-coded English text, static ARIA labels, or physical CSS properties are introduced:

npm run audit:i18n-rtl:strict

License

MIT

版本与发布记录

@nanahoshi/mona-ui 共发布 44 个版本,首次发布于 2026/07/10;过去 12 个月发布了 44 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.23.0latest2026/11/021 天前
0.22.12026/10/031 个月前
0.22.02026/10/031 个月前
0.21.02026/10/021 个月前
0.20.12026/09/171 个月前
0.20.02026/09/161 个月前

关于 @nanahoshi/mona-ui 的常见问题

@nanahoshi/mona-ui 是什么?

一个非常轻量级的Angular UI框架

如何安装 @nanahoshi/mona-ui?

在项目目录运行 npm install @nanahoshi/mona-ui,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:rxjs(^7.8.2)、@tiptap/pm(^3.26.1)、@angular/cdk(>=22.0.0 <24.0.0)、@tiptap/core(^3.26.1)、@angular/core(>=22.0.0 <24.0.0)、@angular/forms(>=22.0.0 <24.0.0)、@angular/common(>=22.0.0 <24.0.0)、@angular/router(>=22.0.0 <24.0.0)、@angular/compiler(>=22.0.0 <24.0.0)、@tiptap/starter-kit(^3.26.1)、@tiptap/extension-link(^3.26.1)、@tiptap/extension-color(^3.26.1)、@tiptap/extension-image(^3.26.1)、@tiptap/extension-table(^3.26.1)、@angular/platform-browser(>=22.0.0 <24.0.0)、@tiptap/extension-highlight(^3.26.1)、@tiptap/extension-subscript(^3.26.1)、@tiptap/extension-table-row(^3.26.1)、@tiptap/extension-task-item(^3.26.1)、@tiptap/extension-task-list(^3.26.1)、@tiptap/extension-underline(^3.26.1)、@tiptap/extension-table-cell(^3.26.1)、@tiptap/extension-text-align(^3.26.1)、@tiptap/extension-text-style(^3.26.1)、@tiptap/extension-font-family(^3.26.1)、@tiptap/extension-superscript(^3.26.1)、@tiptap/extension-table-header(^3.26.1)、@angular/platform-browser-dynamic(>=22.0.0 <24.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@nanahoshi/mona-ui 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@nanahoshi/mona-ui 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@nanahoshi/mona-ui 可以商用吗?

@nanahoshi/mona-ui 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@nanahoshi/mona-ui 还在维护吗?

最新版本 0.23.0 发布于 2026/11/02(1 天前);至今共发布 44 个版本,其中过去 12 个月发布了 44 个;首次发布于 2026/07/10。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。