# ultramusso/univer architecture

> Architecture diagram of the GitHub repository ultramusso/univer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ultramusso/univer
- Repository: https://github.com/ultramusso/univer

## Overview

Univer is an Office SDK for embedding spreadsheet and document editing, calculation, and rendering in an application. The documented workflow is to compose plugins into an editor, let users edit content, and expose that content through Facade APIs; the same models and commands also support headless processing. The graph preserves major Sheets and Docs capabilities and the central rendering and interaction modules identified in the source index. Some subsystem paths are unsampled, so their relationships are shown only where the README or excerpts support them.

Main entry points: [`packages`](https://github.com/ultramusso/univer/tree/dev/packages) (Feature plugins), [`packages/core/src/sheets/workbook.ts`](https://github.com/ultramusso/univer/blob/dev/packages/core/src/sheets/workbook.ts) (Content models), [`packages/sheets-ui/src/controllers/drag-render.controller.ts`](https://github.com/ultramusso/univer/blob/dev/packages/sheets-ui/src/controllers/drag-render.controller.ts) (Sheet dragging), [`packages/core/src/univer.ts`](https://github.com/ultramusso/univer/blob/dev/packages/core/src/univer.ts) (Univer entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_integration["Application integration"]
  node_entry["Univer entry<br/>[univer.ts]"]
  node_facade["Facade APIs"]
  node_plugins["Feature plugins"]
end

subgraph group_core["Core runtime"]
  node_models["Content models<br/>[workbook.ts]"]
  node_commands["Command system<br/>[command.service.ts]"]
  node_formula["Formula calculation<br/>[engineering.ts]"]
end

subgraph group_sheets["Spreadsheet editing"]
  node_sheets["Sheets editing"]
  node_formula_updates["Formula updates"]
  node_filter["Filtering"]
  node_find_replace["Find and replace"]
  node_sheet_drag["Sheet dragging"]
  node_drag_manager["Drag manager"]
  node_sheet_drawings["Sheet drawings"]
  node_sheet_float_dom["Floating sheet content"]
end

subgraph group_docs["Document editing"]
  node_docs["Docs editing"]
  node_doc_paragraph["Paragraph rendering"]
  node_doc_menu["Paragraph menus"]
  node_doc_popup["Document popups"]
  node_doc_drawings["Document drawings"]
end

subgraph group_render["Rendering and interaction"]
  node_render_engine["Render engine<br/>[engine.ts]"]
  node_render_scene["Render scene<br/>[scene.ts]"]
  node_sheet_skeleton["Sheet skeleton"]
  node_sheet_selection["Sheet selection"]
  node_doc_selection["Document selection"]
  node_doc_range["Text range conversion"]
  node_doc_text_range["Text range geometry<br/>[text-range.ts]"]
  node_doc_layout["Document layout interaction"]
  node_doc_events["Document events"]
  node_doc_embed["Embedded content"]
  node_sheet_hover["Sheet hover manager"]
end

node_application(("Host application"))

node_application -->|"embeds"| node_entry
node_entry -->|"composes"| node_plugins
node_plugins -->|"edit content"| node_models
node_plugins -->|"use commands"| node_commands
node_application -->|"connects through"| node_facade
node_models -->|"supports calculation"| node_formula
node_models -->|"renders content"| node_render_engine
node_plugins -->|"provides Sheets"| node_sheets
node_plugins -->|"provides Docs"| node_docs
node_sheet_drag -->|"dispatches drag events"| node_drag_manager
node_sheet_drag -->|"observes skeleton changes"| node_sheet_skeleton
node_render_engine -->|"uses scene"| node_render_scene
node_sheet_skeleton -.->|"supports hover calculations"| node_sheet_hover
node_application -->|"processes headlessly"| node_models

click node_entry "https://github.com/ultramusso/univer/blob/dev/packages/core/src/univer.ts"
click node_facade "https://github.com/ultramusso/univer/tree/dev/packages/core/src/facade"
click node_plugins "https://github.com/ultramusso/univer/tree/dev/packages"
click node_models "https://github.com/ultramusso/univer/blob/dev/packages/core/src/sheets/workbook.ts"
click node_commands "https://github.com/ultramusso/univer/blob/dev/packages/core/src/services/command/command.service.ts"
click node_formula "https://github.com/ultramusso/univer/blob/dev/packages/engine-formula/src/services/formula/function-list/engineering.ts"
click node_sheets "https://github.com/ultramusso/univer/blob/dev/packages/sheets/src/controllers/merge-cell.controller.ts"
click node_formula_updates "https://github.com/ultramusso/univer/blob/dev/packages/sheets-formula/src/controllers/update-formula.controller.ts"
click node_filter "https://github.com/ultramusso/univer/blob/dev/packages/sheets-filter/src/controllers/sheets-filter.controller.ts"
click node_find_replace "https://github.com/ultramusso/univer/blob/dev/packages/sheets-find-replace/src/controllers/sheet-find-replace.controller.ts"
click node_sheet_drag "https://github.com/ultramusso/univer/blob/dev/packages/sheets-ui/src/controllers/drag-render.controller.ts"
click node_drag_manager "https://github.com/ultramusso/univer/blob/dev/packages/sheets-ui/src/services/drag-manager.service.ts"
click node_sheet_drawings "https://github.com/ultramusso/univer/blob/dev/packages/sheets-drawing/src/controllers/sheet-drawing-transform-affected.controller.ts"
click node_sheet_float_dom "https://github.com/ultramusso/univer/blob/dev/packages/sheets-drawing-ui/src/services/canvas-float-dom-manager.service.ts"
click node_docs "https://github.com/ultramusso/univer/tree/dev/packages/docs-ui"
click node_doc_paragraph "https://github.com/ultramusso/univer/blob/dev/packages/docs-ui/src/controllers/render-controllers/doc-paragraph-placeholder.render-controller.ts"
click node_doc_menu "https://github.com/ultramusso/univer/blob/dev/packages/docs-ui/src/services/doc-paragraph-menu.service.ts"
click node_doc_popup "https://github.com/ultramusso/univer/blob/dev/packages/docs-ui/src/services/doc-popup-manager.service.ts"
click node_doc_drawings "https://github.com/ultramusso/univer/blob/dev/packages/docs-drawing-ui/src/controllers/render-controllers/doc-drawing-transform-update.controller.ts"
click node_render_engine "https://github.com/ultramusso/univer/blob/dev/packages/engine-render/src/engine.ts"
click node_render_scene "https://github.com/ultramusso/univer/blob/dev/packages/engine-render/src/scene.ts"
click node_sheet_skeleton "https://github.com/ultramusso/univer/blob/dev/packages/sheets-ui/src/services/sheet-skeleton-manager.service.ts"
click node_sheet_selection "https://github.com/ultramusso/univer/blob/dev/packages/sheets-ui/src/services/selection/base-selection-render.service.ts"
click node_doc_selection "https://github.com/ultramusso/univer/blob/dev/packages/docs-ui/src/services/selection/doc-selection-render.service.ts"
click node_doc_range "https://github.com/ultramusso/univer/blob/dev/packages/docs-ui/src/services/selection/convert-text-range.ts"
click node_doc_text_range "https://github.com/ultramusso/univer/blob/dev/packages/docs-ui/src/services/selection/text-range.ts"
click node_doc_layout "https://github.com/ultramusso/univer/blob/dev/packages/docs-ui/src/services/doc-layout-interaction.service.ts"
click node_doc_events "https://github.com/ultramusso/univer/blob/dev/packages/docs-ui/src/services/doc-event-manager.service.ts"
click node_doc_embed "https://github.com/ultramusso/univer/blob/dev/packages/docs-ui/src/services/doc-embed-integration.service.ts"
click node_sheet_hover "https://github.com/ultramusso/univer/blob/dev/packages/sheets-ui/src/services/hover-manager.service.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_facade,node_plugins toneBlue
class node_models,node_commands,node_formula toneAmber
class node_sheets,node_formula_updates,node_filter,node_find_replace,node_sheet_drag,node_drag_manager,node_sheet_drawings,node_sheet_float_dom toneMint
class node_docs,node_doc_paragraph,node_doc_menu,node_doc_popup,node_doc_drawings toneRose
class node_render_engine,node_render_scene,node_sheet_skeleton,node_sheet_selection,node_doc_selection,node_doc_range,node_doc_text_range,node_doc_layout,node_doc_events,node_doc_embed,node_sheet_hover,node_application toneIndigo
```

## Components

### Application integration

- [Univer entry](https://github.com/ultramusso/univer/blob/dev/packages/core/src/univer.ts): `packages/core/src/univer.ts`
- [Facade APIs](https://github.com/ultramusso/univer/tree/dev/packages/core/src/facade): `packages/core/src/facade`
- [Feature plugins](https://github.com/ultramusso/univer/tree/dev/packages): `packages`

### Core runtime

- [Content models](https://github.com/ultramusso/univer/blob/dev/packages/core/src/sheets/workbook.ts): `packages/core/src/sheets/workbook.ts`
- [Command system](https://github.com/ultramusso/univer/blob/dev/packages/core/src/services/command/command.service.ts): `packages/core/src/services/command/command.service.ts`
- [Formula calculation](https://github.com/ultramusso/univer/blob/dev/packages/engine-formula/src/services/formula/function-list/engineering.ts): `packages/engine-formula/src/services/formula/function-list/engineering.ts`

### Spreadsheet editing

- [Sheets editing](https://github.com/ultramusso/univer/blob/dev/packages/sheets/src/controllers/merge-cell.controller.ts): `packages/sheets/src/controllers/merge-cell.controller.ts`
- [Formula updates](https://github.com/ultramusso/univer/blob/dev/packages/sheets-formula/src/controllers/update-formula.controller.ts): `packages/sheets-formula/src/controllers/update-formula.controller.ts`
- [Filtering](https://github.com/ultramusso/univer/blob/dev/packages/sheets-filter/src/controllers/sheets-filter.controller.ts): `packages/sheets-filter/src/controllers/sheets-filter.controller.ts`
- [Find and replace](https://github.com/ultramusso/univer/blob/dev/packages/sheets-find-replace/src/controllers/sheet-find-replace.controller.ts): `packages/sheets-find-replace/src/controllers/sheet-find-replace.controller.ts`
- [Sheet dragging](https://github.com/ultramusso/univer/blob/dev/packages/sheets-ui/src/controllers/drag-render.controller.ts): `packages/sheets-ui/src/controllers/drag-render.controller.ts`
- [Drag manager](https://github.com/ultramusso/univer/blob/dev/packages/sheets-ui/src/services/drag-manager.service.ts): `packages/sheets-ui/src/services/drag-manager.service.ts`
- [Sheet drawings](https://github.com/ultramusso/univer/blob/dev/packages/sheets-drawing/src/controllers/sheet-drawing-transform-affected.controller.ts): `packages/sheets-drawing/src/controllers/sheet-drawing-transform-affected.controller.ts`
- [Floating sheet content](https://github.com/ultramusso/univer/blob/dev/packages/sheets-drawing-ui/src/services/canvas-float-dom-manager.service.ts): `packages/sheets-drawing-ui/src/services/canvas-float-dom-manager.service.ts`

### Document editing

- [Docs editing](https://github.com/ultramusso/univer/tree/dev/packages/docs-ui): `packages/docs-ui`
- [Paragraph rendering](https://github.com/ultramusso/univer/blob/dev/packages/docs-ui/src/controllers/render-controllers/doc-paragraph-placeholder.render-controller.ts): `packages/docs-ui/src/controllers/render-controllers/doc-paragraph-placeholder.render-controller.ts`
- [Paragraph menus](https://github.com/ultramusso/univer/blob/dev/packages/docs-ui/src/services/doc-paragraph-menu.service.ts): `packages/docs-ui/src/services/doc-paragraph-menu.service.ts`
- [Document popups](https://github.com/ultramusso/univer/blob/dev/packages/docs-ui/src/services/doc-popup-manager.service.ts): `packages/docs-ui/src/services/doc-popup-manager.service.ts`
- [Document drawings](https://github.com/ultramusso/univer/blob/dev/packages/docs-drawing-ui/src/controllers/render-controllers/doc-drawing-transform-update.controller.ts): `packages/docs-drawing-ui/src/controllers/render-controllers/doc-drawing-transform-update.controller.ts`

### Rendering and interaction

- [Render engine](https://github.com/ultramusso/univer/blob/dev/packages/engine-render/src/engine.ts): `packages/engine-render/src/engine.ts`
- [Render scene](https://github.com/ultramusso/univer/blob/dev/packages/engine-render/src/scene.ts): `packages/engine-render/src/scene.ts`
- [Sheet skeleton](https://github.com/ultramusso/univer/blob/dev/packages/sheets-ui/src/services/sheet-skeleton-manager.service.ts): `packages/sheets-ui/src/services/sheet-skeleton-manager.service.ts`
- [Sheet selection](https://github.com/ultramusso/univer/blob/dev/packages/sheets-ui/src/services/selection/base-selection-render.service.ts): `packages/sheets-ui/src/services/selection/base-selection-render.service.ts`
- [Document selection](https://github.com/ultramusso/univer/blob/dev/packages/docs-ui/src/services/selection/doc-selection-render.service.ts): `packages/docs-ui/src/services/selection/doc-selection-render.service.ts`
- [Text range conversion](https://github.com/ultramusso/univer/blob/dev/packages/docs-ui/src/services/selection/convert-text-range.ts): `packages/docs-ui/src/services/selection/convert-text-range.ts`
- [Text range geometry](https://github.com/ultramusso/univer/blob/dev/packages/docs-ui/src/services/selection/text-range.ts): `packages/docs-ui/src/services/selection/text-range.ts`
- [Document layout interaction](https://github.com/ultramusso/univer/blob/dev/packages/docs-ui/src/services/doc-layout-interaction.service.ts): `packages/docs-ui/src/services/doc-layout-interaction.service.ts`
- [Document events](https://github.com/ultramusso/univer/blob/dev/packages/docs-ui/src/services/doc-event-manager.service.ts): `packages/docs-ui/src/services/doc-event-manager.service.ts`
- [Embedded content](https://github.com/ultramusso/univer/blob/dev/packages/docs-ui/src/services/doc-embed-integration.service.ts): `packages/docs-ui/src/services/doc-embed-integration.service.ts`
- [Sheet hover manager](https://github.com/ultramusso/univer/blob/dev/packages/sheets-ui/src/services/hover-manager.service.ts): `packages/sheets-ui/src/services/hover-manager.service.ts`

### Other components

- **Host application**

## Connections

- Host application → Univer entry: embeds
- Univer entry → Feature plugins: composes
- Feature plugins → Content models: edit content
- Feature plugins → Command system: use commands
- Host application → Facade APIs: connects through
- Content models → Formula calculation: supports calculation
- Content models → Render engine: renders content
- Feature plugins → Sheets editing: provides Sheets (evidence: `packages/sheets/src/controllers/merge-cell.controller.ts`)
- Feature plugins → Docs editing: provides Docs (evidence: `packages/docs-ui/src/controllers/render-controllers/doc-paragraph-placeholder.render-controller.ts`)
- Sheet dragging → Drag manager: dispatches drag events (evidence: `packages/sheets-ui/src/controllers/drag-render.controller.ts`)
- Sheet dragging → Sheet skeleton: observes skeleton changes (evidence: `packages/sheets-ui/src/controllers/drag-render.controller.ts`)
- Render engine → Render scene: uses scene (evidence: `packages/engine-render/src/engine.ts`)
- Sheet skeleton → Sheet hover manager: supports hover calculations
- Host application → Content models: processes headlessly
