将 victory-core 从 37.x 升级到 38.x

根据 TypeScript 类型自动比较 victory-core 37.4.1 与 38.0.0 的公开 API。签名变化表示可能存在不兼容变更，并非确定结论。

概要

已删除的导入路径	0
已删除的导出	0
已修改的签名	10
已删除的类或接口成员	0
已修改的类或接口成员	5
新增弃用	0
要求变化（engines、peer 依赖）	1
新增导出	1

已删除的导出

未发现。

已修改的签名

export	之前	之后
`victory-core · Text`	`(props: TextProps): JSX.Element`	`(props: TextProps): React.JSX.Element`
`victory-core · TSpan`	`(props: VictoryCommonPrimitiveProps): JSX.Element`	`(props: VictoryCommonPrimitiveProps): React.JSX.Element`
`victory-core · ClipPath`	`(props: ClipPathProps): JSX.Element`	`(props: ClipPathProps): React.JSX.Element`
`victory-core · PortalProvider`	`({ children }: PortalProviderProps): JSX.Element`	`({ children }: PortalProviderProps): React.JSX.Element`
`victory-core · AnimationEasing`	`"linear" \| "back" \| "backIn" \| "backOut" \| "backInOut" \| "bounce" \| "bounceIn" \| "bounceOut" \| "bounceInOut" \| "circle" \| "circleIn" \| "circleOut" \| "circleInOut" \| "linearIn" \| "linearOut" \| "linearInOut" \| "cubic" \| "cubicIn" \| "cubicOut" \| "cubicInOut" \| "elastic" \| "elasticIn" \| "elasticOut" \| "elasticInOut" \| "exp" \| "expIn" \| "expOut" \| "expInOut" \| "poly" \| "polyIn" \| "polyOut" \| "polyInOut" \| "quad" \| "quadIn" \| "quadOut" \| "quadInOut" \| "sin" \| "sinIn" \| "sinOut" \| "sinInOut"`	`"back" \| "backIn" \| "backOut" \| "backInOut" \| "bounce" \| "bounceIn" \| "bounceOut" \| "bounceInOut" \| "circle" \| "circleIn" \| "circleOut" \| "circleInOut" \| "linear" \| "linearIn" \| "linearOut" \| "linearInOut" \| "cubic" \| "cubicIn" \| "cubicOut" \| "cubicInOut" \| "elastic" \| "elasticIn" \| "elasticOut" \| "elasticInOut" \| "exp" \| "expIn" \| "expOut" \| "expInOut" \| "poly" \| "polyIn" \| "polyOut" \| "polyInOut" \| "quad" \| "quadIn" \| "quadOut" \| "quadInOut" \| "sin" \| "sinIn" \| "sinOut" \| "sinInOut"`
`victory-core · VictoryContainer`	`(initialProps: VictoryContainerProps): JSX.Element`	`(initialProps: VictoryContainerProps): React.JSX.Element`
`victory-core · PaddingOrCallback`	`number \| VictoryPaddingCallback \| BlockProps`	`number \| BlockProps \| VictoryPaddingCallback`
`victory-core · useVictoryContainer`	<TProps extends VictoryContainerProps>(initialProps: TProps): { className: string; portalComponent: JSX.Element; portalZIndex: number; responsive: boolean; role: string; } & TProps & { titleId: string; descId: string; dimensions: { width: string; height: string; } \| { width: number \| undefined; height: number \| undefined; }; viewBox: string \| undefined; preserveAspectRatio: string \| undefined; ariaLabelledBy: string \| undefined; ariaDescribedBy: string \| undefined; userProps: Record<string, string>; localContainerRef: React.RefObject<HTMLDivElement>; }	<TProps extends VictoryContainerProps>(initialProps: TProps): { className: string; portalComponent: React.JSX.Element; portalZIndex: number; responsive: boolean; role: string; } & TProps & { titleId: string; descId: string; dimensions: { width: string; height: string; } \| { width: number \| undefined; height: number \| undefined; }; viewBox: string \| undefined; preserveAspectRatio: string \| undefined; ariaLabelledBy: string \| undefined; ariaDescribedBy: string \| undefined; userProps: Record<string, string>; localContainerRef: React.RefObject<HTMLDivElement>; }
`victory-core · OrientationOrCallback`	`VictoryOrientationCallback \| OrientationTypes`	`OrientationTypes \| VictoryOrientationCallback`
`victory-core · VictoryAccessibleGroup`	`({ desc, children, tabIndex, className, ...props }: VictoryAccessibleGroupProps): JSX.Element`	`({ desc, children, tabIndex, className, ...props }: VictoryAccessibleGroupProps): React.JSX.Element`

已删除的类或接口成员

未发现。

已修改的类或接口成员

member	之前	之后
`VictoryLabelProps.text`	`StringOrNumberOrCallback \| string[] \| undefined`	`string[] \| StringOrNumberOrCallback \| undefined`
`VictoryLabelProps.lineHeight`	`StringOrNumberOrCallback \| (string \| number)[] \| undefined`	`(string \| number)[] \| StringOrNumberOrCallback \| undefined`
`VictoryTransition.render`	`(): JSX.Element`	`(): React.JSX.Element`
`VictoryClipContainer.static defaultProps`	`{ circleComponent: JSX.Element; rectComponent: JSX.Element; clipPathComponent: JSX.Element; groupComponent: JSX.Element; }`	`{ circleComponent: React.JSX.Element; rectComponent: React.JSX.Element; clipPathComponent: React.JSX.Element; groupComponent: React.JSX.Element; }`
`EventPropTypeInterface.eventHandlers`	`{ [key: string]: ((event: React.SyntheticEvent<any>, props?: any) => EventCallbackInterface<TTarget, TEventKey>) \| ((event: React.SyntheticEvent<any>, props?: any) => EventCallbackInterface<TTarget, TEventKey>[]) \| ((event: React.SyntheticEvent<any>, props?: any) => void); }`	`{ [key: string]: ((event: React$1.SyntheticEvent<any>, props?: any) => EventCallbackInterface<TTarget, TEventKey>) \| ((event: React$1.SyntheticEvent<any>, props?: any) => EventCallbackInterface<TTarget, TEventKey>[]) \| ((event: React$1.SyntheticEvent<any>, props?: any) => void); }`

新增弃用

未发现。

要求变化（engines、peer 依赖）

	之前	之后
`peerDependencies.react`	`>=16.6.0`	`>=18`

新增导出 (1)

import	export	kind
`victory-core`	`ComponentEvent`	interface

这些版本之间的 changelog

软件包作者发布的文本，按原样显示。

38.0.0

### Major Changes

- [#3138](https://github.com/FormidableLabs/victory/pull/3138) [`b7ebc3e`](https://github.com/FormidableLabs/victory/commit/b7ebc3e316d05740f11d4e8b8072d420db6ccfad) - Require React 18 or later: the `react` peer dependency is now `>=18` (was `>=16.6.0`). If you're on React 16 or 17, stay on Victory 37.x until you upgrade React.

- [#3107](https://github.com/FormidableLabs/victory/pull/3107) [`4c436bd`](https://github.com/FormidableLabs/victory/commit/4c436bd47b835e795e96bc205cdf9c590fe92ddb) - Remove the UMD bundles (`dist/<package>.js` and `dist/<package>.min.js`). To use Victory in the browser without a build step, import it as ESM from a CDN with an import map; see [Using Victory in the browser](https://commerce.nearform.com/open-source/victory/docs/introduction/browser).

- [#3108](https://github.com/FormidableLabs/victory/pull/3108) [`8f16467`](https://github.com/FormidableLabs/victory/commit/8f1646767d6059d764541118284cf71cc1da5c95) - Packages are now built with tsdown and published from `dist/`, with an `exports` map:
  
  - ESM is `dist/*.mjs` and CommonJS is `dist/*.cjs`, with matching `.d.mts`/`.d.cts` types. `main`, `module` and `types` still point at them for older tooling.
  - Only the package root (and `package.json`) can be imported. Deep imports into `lib/`, `es/` or `src/` no longer resolve; import from the package root instead (for example `import { Helpers } from "victory-core"`).
  - The output targets ES2022 and is no longer down-leveled further. If you support older browsers, transpile `node_modules` in your bundler.
  - `src/` is no longer published.

### Patch Changes

- [#3108](https://github.com/FormidableLabs/victory/pull/3108) [`8f16467`](https://github.com/FormidableLabs/victory/commit/8f1646767d6059d764541118284cf71cc1da5c95) - Export the `ComponentEvent` type. Component declarations that use it (such as `componentEvents` on `VictoryArea`) now reference `victory-core` instead of an internal path.

- [#3115](https://github.com/FormidableLabs/victory/pull/3115) [`1864919`](https://github.com/FormidableLabs/victory/commit/18649193d7c8d42a8f5f58ade9c63288af68a7f8) - Fix `VictoryLabel`'s default `fontFamily`: an invisible soft hyphen inside `'Seravek'` meant that font never matched. Remove the unused `lodash` dependency from `victory-canvas`, `victory-histogram` and `victory-scatter`.

- [#3123](https://github.com/FormidableLabs/victory/pull/3123) [`4261e04`](https://github.com/FormidableLabs/victory/commit/4261e0453733d19154dc0700f14c03e8e0aad539) - Stop the primitives (`Circle`, `Line`, `Path`, `Rect`, `Text`, `TSpan`) from writing Victory props such as `standalone`, `polar`, `theme` and `stringMap` to the DOM. `VictoryChart`, `VictoryGroup` and `VictoryStack` inject these into every child, so a primitive placed directly in a chart triggered React warnings like "Received `false` for a non-boolean attribute `standalone`" ([#3118](https://github.com/FormidableLabs/victory/issues/3118)).

- [#3132](https

把这些数据交给你的 AI 智能体

Vigia 是免费的 MCP 服务器：你的编程智能体在写代码之前就能检查版本、不兼容变更和安全漏洞。无需注册，无需 API 密钥。

claude mcp add --transport http vigia https://vigia.coredls.cloud/mcp

添加到 Cursor 添加到 VS Code ★ 在 GitHub 上加星

任何其他 MCP 客户端

{ "mcpServers": { "vigia": { "url": "https://vigia.coredls.cloud/mcp" } } }

智能体技能（SKILL.md）：告诉智能体何时使用 Vigia · 用于拉取请求的 GitHub Action

常见问题

将 victory-core 从 37 升级到 38 有哪些不兼容变更？

在 victory-core 37.4.1 与 38.0.0 之间，Vigia 发现 0 个已删除的导出、10 个已修改的签名，以及 5 个已删除或修改的类或接口成员。

victory-core 38 中弃用了哪些内容？

victory-core 38.0.0 中有 0 个导出或成员新被标记为弃用。

供智能体使用

GET https://vigia.coredls.cloud/v1/packages/npm/victory-core/upgrade?from=37.4.1&to=38.0.0