# @univerjs/sheets-formula

> Sheet formula services and calculation integration for Univer Sheets.

Latest version **1.4.0** (published 2026-11-07) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @univerjs/sheets-formula
pnpm add @univerjs/sheets-formula
yarn add @univerjs/sheets-formula
bun add @univerjs/sheets-formula
```

## Health

**Score 80/100 (A)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score; popular repo.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 1.4.0 |
| Published | 2026-11-07 |
| First published | 2023-12-05 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 5 |
| Unpacked size | 672.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 22699 |
| Author | DreamNum Co., Ltd. <developer@univer.ai> |
| Maintainers | jikkai, wbfsa, mengshukeji |
| Keywords | univer, sheets, formula, calculation, plugin |

## Links

- npm: https://www.npmjs.com/package/@univerjs/sheets-formula
- Repository: https://github.com/dream-num/univer
- Homepage: https://univer.ai
- Issues: https://github.com/dream-num/univer/issues
- Funding: https://opencollective.com/univer
- npm.io page: https://npm.io/package/@univerjs/sheets-formula

## Dependencies (5)

- [@univerjs/rpc](https://npm.io/package/@univerjs/rpc.md) 1.4.0
- [@univerjs/core](https://npm.io/package/@univerjs/core.md) 1.4.0
- [@univerjs/docs](https://npm.io/package/@univerjs/docs.md) 1.4.0
- [@univerjs/sheets](https://npm.io/package/@univerjs/sheets.md) 1.4.0
- [@univerjs/engine-formula](https://npm.io/package/@univerjs/engine-formula.md) 1.4.0

## Alternatives

- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads

## Recent versions

- 1.4.0 (latest) — 2026-11-07
- 1.0.0-rc.0 (rc) — 2026-09-10
- 1.0.0-beta.2 (beta) — 2026-08-22
- 1.0.0-insiders.20260813-7c9aa50 (insiders) — 2026-08-13
- 1.0.0-alpha.8 (alpha) — 2026-07-29
- 0.12.4-experimental.20251211-e01e32a (experimental) — 2025-12-11
- 0.12.3-nightly.202512060617 (nightly) — 2025-12-06
- 1.3.1 — 2026-10-30
- 1.3.0 — 2026-10-29
- 1.2.0 — 2026-10-22
- 1.1.0 — 2026-10-17
- 1.0.4 — 2026-10-10
- 1.0.3 — 2026-09-29
- 1.0.2 — 2026-09-24
- 1.0.1 — 2026-09-24
- … 721 more at https://npm.io/package/@univerjs/sheets-formula/versions

## README

# @univerjs/sheets-formula

[![npm version](https://img.shields.io/npm/v/@univerjs/sheets-formula?style=flat-square)](https://npmjs.com/package/@univerjs/sheets-formula)
[![license](https://img.shields.io/npm/l/@univerjs/sheets-formula?style=flat-square)](https://npmjs.com/package/@univerjs/sheets-formula)
[![downloads](https://img.shields.io/npm/dm/@univerjs/sheets-formula?style=flat-square)](https://npmjs.com/package/@univerjs/sheets-formula)

`@univerjs/sheets-formula` connects the formula engine to Univer Sheets, including formula data services, dependency handling, and sheet-aware calculation.

## Package Overview

| Package | UMD global | CSS | Locales | Facade entry |
| --- | --- | :---: | :---: | :---: |
| `@univerjs/sheets-formula` | `UniverSheetsFormula` | No | Yes | Yes |

## Installation

```sh
pnpm add @univerjs/sheets-formula
# or
npm install @univerjs/sheets-formula
```

Keep all `@univerjs/*` packages on the same version.

## Usage

```ts
import EnUS from '@univerjs/sheets-formula/locale/en-US';
import { UniverSheetsFormulaPlugin } from '@univerjs/sheets-formula';

univer.registerPlugin(UniverSheetsFormulaPlugin);

// Merge EnUS into your Univer locale map when this package contributes UI text.
```

Exported plugin classes:

- `UniverSheetsFormulaPlugin`
- `UniverRemoteSheetsFormulaPlugin`

## Integration Notes

Register this package with `@univerjs/engine-formula` and `@univerjs/sheets` before adding formula UI packages.

## Resources

- [Documentation](https://docs.univer.ai)
- [NPM package](https://npmjs.com/package/@univerjs/sheets-formula)
- [GitHub repository](https://github.com/dream-num/univer)

---
_Source: https://npm.io/package/@univerjs/sheets-formula · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._