# operations

Workspace-wide operations: cascade bumps, batch updates, dependency-reference rewriting, and validation.

The exports fall into three families:

- The cascade-bump family ([`PlannedBump`](https://www.hyperfrontend.dev/docs/libraries/versioning/workspace/operations/#api-PlannedBump), [`BumpReason`](https://www.hyperfrontend.dev/docs/libraries/versioning/workspace/operations/#api-BumpReason), [`CascadeBumpOptions`](https://www.hyperfrontend.dev/docs/libraries/versioning/workspace/operations/#api-CascadeBumpOptions), [`CascadeBumpResult`](https://www.hyperfrontend.dev/docs/libraries/versioning/workspace/operations/#api-CascadeBumpResult), [`DirectBumpInput`](https://www.hyperfrontend.dev/docs/libraries/versioning/workspace/operations/#api-DirectBumpInput)) plans the propagation of a version bump through a monorepo's internal-dependency graph, so that bumping a base package automatically schedules dependent packages with the right [`BumpReason`](https://www.hyperfrontend.dev/docs/libraries/versioning/workspace/operations/#api-BumpReason).
- The batch-update family ([`applyBumps`](https://www.hyperfrontend.dev/docs/libraries/versioning/workspace/operations/#api-applyBumps), [`updatePackageVersionInTree`](https://www.hyperfrontend.dev/docs/libraries/versioning/workspace/operations/#api-updatePackageVersionInTree), [`updateDependencyReferencesInTree`](https://www.hyperfrontend.dev/docs/libraries/versioning/workspace/operations/#api-updateDependencyReferencesInTree), [`summarizeBatchUpdate`](https://www.hyperfrontend.dev/docs/libraries/versioning/workspace/operations/#api-summarizeBatchUpdate), plus [`BatchUpdateResult`](https://www.hyperfrontend.dev/docs/libraries/versioning/workspace/operations/#api-BatchUpdateResult), [`UpdatedPackage`](https://www.hyperfrontend.dev/docs/libraries/versioning/workspace/operations/#api-UpdatedPackage), [`FailedUpdate`](https://www.hyperfrontend.dev/docs/libraries/versioning/workspace/operations/#api-FailedUpdate), [`BatchUpdateOptions`](https://www.hyperfrontend.dev/docs/libraries/versioning/workspace/operations/#api-BatchUpdateOptions), [`DEFAULT_BATCH_UPDATE_OPTIONS`](https://www.hyperfrontend.dev/docs/libraries/versioning/workspace/operations/#api-DEFAULT_BATCH_UPDATE_OPTIONS)) carries out the planned bumps across `package.json` files in one transactional pass.
- The validation family ([`ValidationResult`](https://www.hyperfrontend.dev/docs/libraries/versioning/workspace/operations/#api-ValidationResult), [`ValidationReport`](https://www.hyperfrontend.dev/docs/libraries/versioning/workspace/operations/#api-ValidationReport), [`ValidationCheckResult`](https://www.hyperfrontend.dev/docs/libraries/versioning/workspace/operations/#api-ValidationCheckResult)) verifies that a planned set of changes is internally consistent before any file is written.

---

Canonical page: https://www.hyperfrontend.dev/docs/libraries/versioning/workspace/operations/
This file: https://www.hyperfrontend.dev/docs/libraries/versioning/workspace/operations.md
Documentation index: https://www.hyperfrontend.dev/llms.txt