# @univerjs-pro/pivot-cache

> Language fallback: requested `zh-CN`; content is `en-US`.

- Human documentation: [https://docs.univer.ai/zh-CN/reference/packages/plugins/univerjs-pro/pivot-cache](https://docs.univer.ai/zh-CN/reference/packages/plugins/univerjs-pro/pivot-cache)

- Agent Markdown: [https://docs.univer.ai/zh-CN/reference/packages/plugins/univerjs-pro/pivot-cache.md](https://docs.univer.ai/zh-CN/reference/packages/plugins/univerjs-pro/pivot-cache.md)

- Requested language: `zh-CN`

- Content language: `en-US`

- Documentation version: `1.0.0`

- Source: [packages/plugins/univerjs-pro/pivot-cache.mdx](https://github.com/dream-num/documentation/blob/dev/content/reference/packages/plugins/univerjs-pro/pivot-cache.mdx)

---

Shared Pivot Cache references, provider contracts, and registry used by PivotTables and PivotCharts. This is a library, not a plugin to register.

Host integrations register a provider with `IPivotCacheProviderRegistry`. Consumers acquire a disposable cache handle and subscribe to its `changed$` observable. Dispose the handle when its consumer is removed; releasing it does not remove another report's cache reference.

`Unit`, `Embedded`, and `Resource` identify reference formats. A registered provider must implement resolution; a reference kind alone does not provide loading or persistence. This package owns no chart, drawing, or UI state and has no stylesheet, locales, or Facade entry.

For application integration, use [`@univerjs-pro/sheets-pivot-chart`](https://docs.univer.ai/zh-CN/reference/packages/plugins/univerjs-pro/sheets-pivot-chart.md).