# dream-num/univer · Reposen Release & Migration Intelligence

> Adds chart sheets and removes root worker exports. Update worker script subpaths. Migration: Moderate.

## Metadata
- **Repository URL**: https://github.com/dream-num/univer
- **Primary Package**: `@univerjs/core` (NPM)
- **Categories**: `UI_PRIMITIVES`, `ECOSYSTEM`, `AI_TOOLS`
- **Latest Version**: `v1.5.0`
- **Semantic Status**: `BREAKING`
- **Bundle Size Impact (unavailable)**: `Size Unavailable`
- **Atom Ingestion Feed**: https://github.com/dream-num/univer/releases.atom

## The Human Context (Plain-English Pitch)
Univer is an open-source, full-stack collaborative office suite engine for web applications. It allows developers to embed Excel-like spreadsheets, rich documents, and interactive presentation boards directly into custom software architectures. By providing out-of-the-box layout, rendering, and calculation engines, it eliminates the immense difficulty of building complex canvas-based editing tools from scratch.

## Stage 1 Executive Summary ([Core Change] + [Required Action] + [Migration Effort])
Adds chart sheets and removes root worker exports. Update worker script subpaths. Migration: Moderate.

## Breaking Changes & Required Actions
- [BREAKING] Removed deprecated root Worker exports across packages; entry scripts must now import from dedicated `/worker` subpaths (e.g., `@univerjs/rpc/worker`, `@univerjs/sheets-formula/worker`, `@univerjs/engine-render/worker`).
- [BREAKING] Removed `injectRatexFonts`; font injection is now automated, and `DocsLatexRenderService` must be imported from `@univerjs-pro/docs-latex`.
- [BREAKING] Renamed drawing UI types: replaced `IDrawingObjectListItem`, `IDrawingObjectListPanelLabels`, and `IDrawingObjectListPanelProps` with `IObjectListPanelItem`, `IObjectListPanelLabels`, and `IObjectListPanelBaseProps`.
- [BREAKING] Removed direct exports of `CELL_INVERTED_INDEX_CACHE` and `FORMULA_REF_TO_ARRAY_CACHE` from `@univerjs/engine-formula`, shifting cache ownership directly to formula engine instances.
- Added dedicated chart sheets via `workbook.insertChartSheet()` and introduced stacked line charts with configurable per-series error bars.
- Implemented Board layout automation using `planLayout()` and `applyLayoutPlan()`, alongside LaTeX rendering via `@univerjs-pro/boards-latex-ui`.
- Optimized formula calculation memory consumption in JavaScript and native engines by caching repeat criteria and range lookups.
- Introduced Sheets interaction settings on `UniverSheetsUIPlugin` to toggle `selectionAnimation`, `enableFillHandle`, and `warnBeforeDragOverwrite`.

## Migration Snippet
```ts
// Before (v1.4.x)
import { UniverRPCWorkerThreadPlugin } from '@univerjs/rpc';
import { UniverRemoteSheetsFormulaPlugin } from '@univerjs/sheets-formula';

// After (v1.5.0)
import { UniverRPCWorkerThreadPlugin } from '@univerjs/rpc/worker';
import { UniverRemoteSheetsFormulaPlugin } from '@univerjs/sheets-formula/worker';
```

## Ecosystem Compatibility Matrix & Graph Warnings
- **TypeScript >=5.0** [`COMPATIBLE`]: Exports updated type definitions replacing deprecated drawing and formula engine interface symbols.
- **Node.js >=18** [`COMPATIBLE`]: Compatible with standard Node.js runtimes using `@univerjs/rpc-node/worker` entry points.
- **React >=18.0.0** [`COMPATIBLE`]: Canvas DOM layer floating service maintains standard React synthetic event forwarding.

## Zero-Noise Release Timeline
- **v1.5.0** (2026-11-14) [BREAKING]: Adds chart sheets and removes root worker exports. Update worker script subpaths. Migration: Moderate.

## Upgrade & Migration Q&A (GEO Direct Answers)
### Is dream-num/univer v1.5.0 safe to upgrade in production?
dream-num/univer v1.5.0 is classified as BREAKING (MINOR release). Adds chart sheets and removes root worker exports. Update worker script subpaths. Migration: Moderate.

### What breaking changes or compatibility risks exist in dream-num/univer v1.5.0?
Removed deprecated root Worker exports across packages; entry scripts must now import from dedicated `/worker` subpaths (e.g., `@univerjs/rpc/worker`, `@univerjs/sheets-formula/worker`, `@univerjs/engine-render/worker`). Removed `injectRatexFonts`; font injection is now automated, and `DocsLatexRenderService` must be imported from `@univerjs-pro/docs-latex`. Renamed drawing UI types: replaced `IDrawingObjectListItem`, `IDrawingObjectListPanelLabels`, and `IDrawingObjectListPanelProps` with `IObjectListPanelItem`, `IObjectListPanelLabels`, and `IObjectListPanelBaseProps`. Removed direct exports of `CELL_INVERTED_INDEX_CACHE` and `FORMULA_REF_TO_ARRAY_CACHE` from `@univerjs/engine-formula`, shifting cache ownership directly to formula engine instances.

### What is the bundle size impact of @univerjs/core v1.5.0?
Measured bundle size telemetry is currently unavailable for @univerjs/core v1.5.0; verify build output locally before deploying.

### How do I upgrade @univerjs/core to v1.5.0?
Upgrade @univerjs/core to v1.5.0 by running "npm install @univerjs/core@1.5.0" and applying the migration steps: // Before (v1.4.x) import { UniverRPCWorkerThreadPlugin } from '@univerjs/rpc'; import { UniverRemoteSheetsFormulaPlugin } from '@univerjs/sheets-formula'; // After (v1.5.0) import { UniverRPCWorkerThreadPlugin } from '@univerjs/rpc/worker'; import { UniverRemoteSheetsFormulaPlugin } from '@univerjs/sheets-formula/worker';
