How ultramusso/univer works
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 Feature plugins · workbook.ts Content models · drag-render.controller.ts Sheet dragging · univer.ts Univer entry
Components 31
Application integration
- Univer entry
packages/core/src/univer.ts - Facade APIs
packages/core/src/facade - Feature plugins
packages
Core runtime
- Content models
packages/core/src/sheets/workbook.ts - Command system
packages/core/src/services/command/command.service.ts - Formula calculation
packages/engine-formula/src/services/formula/function-list/engineering.ts
Spreadsheet editing
- Sheets editing
packages/sheets/src/controllers/merge-cell.controller.ts - Formula updates
packages/sheets-formula/src/controllers/update-formula.controller.ts - Filtering
packages/sheets-filter/src/controllers/sheets-filter.controller.ts - Find and replace
packages/sheets-find-replace/src/controllers/sheet-find-replace.controller.ts - Sheet dragging
packages/sheets-ui/src/controllers/drag-render.controller.ts - Drag manager
packages/sheets-ui/src/services/drag-manager.service.ts - Sheet drawings
packages/sheets-drawing/src/controllers/sheet-drawing-transform-affected.controller.ts - Floating sheet content
packages/sheets-drawing-ui/src/services/canvas-float-dom-manager.service.ts
Document editing
- Docs editing
packages/docs-ui - Paragraph rendering
packages/docs-ui/src/controllers/render-controllers/doc-paragraph-placeholder.render-controller.ts - Paragraph menus
packages/docs-ui/src/services/doc-paragraph-menu.service.ts - Document popups
packages/docs-ui/src/services/doc-popup-manager.service.ts - Document drawings
packages/docs-drawing-ui/src/controllers/render-controllers/doc-drawing-transform-update.controller.ts
Rendering and interaction
- Render engine
packages/engine-render/src/engine.ts - Render scene
packages/engine-render/src/scene.ts - Sheet skeleton
packages/sheets-ui/src/services/sheet-skeleton-manager.service.ts - Sheet selection
packages/sheets-ui/src/services/selection/base-selection-render.service.ts - Document selection
packages/docs-ui/src/services/selection/doc-selection-render.service.ts - Text range conversion
packages/docs-ui/src/services/selection/convert-text-range.ts - Text range geometry
packages/docs-ui/src/services/selection/text-range.ts - Document layout interaction
packages/docs-ui/src/services/doc-layout-interaction.service.ts - Document events
packages/docs-ui/src/services/doc-event-manager.service.ts - Embedded content
packages/docs-ui/src/services/doc-embed-integration.service.ts - Sheet hover manager
packages/sheets-ui/src/services/hover-manager.service.ts
Other components
- Host application
Connections 14
- 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
packages/sheets/src/controllers/merge-cell.controller.ts - Feature plugins → Docs editing: provides Docs
packages/docs-ui/src/controllers/render-controllers/doc-paragraph-placeholder.render-controller.ts - Sheet dragging → Drag manager: dispatches drag events
packages/sheets-ui/src/controllers/drag-render.controller.ts - Sheet dragging → Sheet skeleton: observes skeleton changes
packages/sheets-ui/src/controllers/drag-render.controller.ts - Render engine → Render scene: uses scene
packages/engine-render/src/engine.ts - Sheet skeleton → Sheet hover manager: supports hover calculations
- Host application → Content models: processes headlessly