@pnpm/workspace.workspace-manifest-reader 1100.0.9 → 1100.1.1

package/CHANGELOG.md

@@ -0,0 +1,312 @@
+# @pnpm/workspace.read-manifest
+
+## 1100.1.1
+
+### Patch Changes
+
+- Updated dependencies:
+  - @pnpm/types@1101.5.0
+
+## 1100.1.0
+
+### Minor Changes
+
+- Added `versioning.epics` to `pnpm-workspace.yaml`. An epic ties a group of member packages to a lead package, constraining every member's major version to a band derived from the lead's major: while the lead is on major `M`, members live in `M*100 … M*100+99`. Members move independently inside the band (patch, minor, and a `major` intent that stays in-band); a bump that would carry a member past the band ceiling is rejected until the lead advances its own major. When a release plan takes the lead to a new stable major, every member re-bases to the band floor in the same plan. Membership is matched with pnpm's package selectors — name globs, `./`-prefixed directory globs, and `!`-prefixed negations.
+
+- Added native workspace release management [#12952](https://github.com/pnpm/pnpm/issues/12952): the new `pnpm change` command records change intents as changesets-compatible `.changeset/*.md` files (`pnpm change status` shows the pending release plan), and the bare `pnpm version -r` consumes them — bumping versions across the workspace with dependent propagation through `workspace:` ranges, fixed groups, a `maxBump` cap, `--filter` narrowing, and `--dry-run` — writing changelogs, and recording consumed intents in a committed ledger that keeps cherry-picks and merge-backs between release branches safe. Packages can be moved onto per-package release lanes with the new `pnpm lane <name> --filter <pkg>` command and back with `pnpm lane main --filter <pkg>` (`pnpm lane` shows the membership), releasing `X.Y.Z-lane.N` prereleases from the same runs that release stable versions of the packages on the main lane. Configuration lives under the new `versioning` key of `pnpm-workspace.yaml` (`fixed`, `ignore`, `maxBump`, `lanes`, `changelog`). When two workspace projects publish the same name, intent files, `versioning.lanes`, and `versioning.fixed`/`ignore` may reference a project by its workspace-relative directory path (e.g. `"./pnpm/npm/pnpm"`) — the one additive extension to the changesets format, applied automatically by `pnpm change`.
+
+  Release changelogs default to `registry` storage (`versioning.changelog.storage`): no `CHANGELOG.md` is committed. Each release's section is composed at publish time and packed into the published tarball on top of the previously published version's changelog, and the consumed change intents are garbage-collected by a later `pnpm version -r` only once the registry confirms the version is published with its section. Set `versioning.changelog.storage: repository` to keep committed `CHANGELOG.md` files instead.
+
+### Patch Changes
+
+- Updated dependencies:
+  - @pnpm/types@1101.4.0
+
+## 1100.0.9
+
+### Patch Changes
+
+- Updated dependencies [852d537]
+  - @pnpm/error@1100.0.1
+
+## 1100.0.8
+
+### Patch Changes
+
+- Updated dependencies [681b593]
+  - @pnpm/types@1101.3.2
+
+## 1100.0.7
+
+### Patch Changes
+
+- Updated dependencies [bf1b731]
+  - @pnpm/types@1101.3.1
+
+## 1100.0.6
+
+### Patch Changes
+
+- Updated dependencies [a017bf3]
+  - @pnpm/types@1101.3.0
+
+## 1100.0.5
+
+### Patch Changes
+
+- Updated dependencies [35d2355]
+  - @pnpm/types@1101.2.0
+
+## 1100.0.4
+
+### Patch Changes
+
+- Updated dependencies [64afc92]
+  - @pnpm/types@1101.1.1
+
+## 1100.0.3
+
+### Patch Changes
+
+- Updated dependencies [b61e268]
+  - @pnpm/types@1101.1.0
+
+## 1100.0.2
+
+### Patch Changes
+
+- f543b77: Reject `null` named catalogs in workspace manifests with `InvalidWorkspaceManifestError` instead of crashing with a raw `TypeError`.
+
+## 1100.0.1
+
+### Patch Changes
+
+- Updated dependencies [ff28085]
+  - @pnpm/types@1101.0.0
+
+## 1001.0.0
+
+### Major Changes
+
+- 491a84f: This package is now pure ESM.
+- 7d2fd48: Node.js v18, 19, 20, and 21 support discontinued.
+
+### Minor Changes
+
+- 075aa99: Add support for a global YAML config file named `config.yaml`.
+
+  Now configurations are divided into 2 categories:
+
+  - Registry and auth settings which can be stored in INI files such as global `rc` and local `.npmrc`.
+  - pnpm-specific settings which can only be loaded from YAML files such as global `config.yaml` and local `pnpm-workspace.yaml`.
+
+- 2b14c74: The `validateWorkspaceManifest` function is now exported and can be used to validate whether a workspace manifest object's schema is correct.
+
+### Patch Changes
+
+- Updated dependencies [c55c614]
+- Updated dependencies [76718b3]
+- Updated dependencies [a8f016c]
+- Updated dependencies [cc1b8e3]
+- Updated dependencies [491a84f]
+- Updated dependencies [075aa99]
+- Updated dependencies [7d2fd48]
+- Updated dependencies [efb48dc]
+- Updated dependencies [50fbeca]
+- Updated dependencies [cb367b9]
+- Updated dependencies [7b1c189]
+- Updated dependencies [8ffb1a7]
+- Updated dependencies [05fb1ae]
+- Updated dependencies [71de2b3]
+- Updated dependencies [10bc391]
+- Updated dependencies [831f574]
+- Updated dependencies [2df8b71]
+- Updated dependencies [15549a9]
+- Updated dependencies [cc7c0d2]
+- Updated dependencies [efb48dc]
+  - @pnpm/constants@1002.0.0
+  - @pnpm/types@1001.0.0
+  - @pnpm/error@1001.0.0
+
+## 1000.2.5
+
+### Patch Changes
+
+- Updated dependencies [7c1382f]
+- Updated dependencies [dee39ec]
+  - @pnpm/types@1000.9.0
+
+## 1000.2.4
+
+### Patch Changes
+
+- Updated dependencies [6365bc4]
+  - @pnpm/constants@1001.3.1
+  - @pnpm/error@1000.0.5
+
+## 1000.2.3
+
+### Patch Changes
+
+- Updated dependencies [e792927]
+  - @pnpm/types@1000.8.0
+
+## 1000.2.2
+
+### Patch Changes
+
+- Updated dependencies [d1edf73]
+- Updated dependencies [86b33e9]
+  - @pnpm/constants@1001.3.0
+  - @pnpm/error@1000.0.4
+
+## 1000.2.1
+
+### Patch Changes
+
+- Updated dependencies [1a07b8f]
+- Updated dependencies [1a07b8f]
+  - @pnpm/types@1000.7.0
+  - @pnpm/constants@1001.2.0
+  - @pnpm/error@1000.0.3
+
+## 1000.2.0
+
+### Minor Changes
+
+- c8341cc: Added two new CLI options (`--save-catalog` and `--save-catalog-name=<name>`) to `pnpm add` to save new dependencies as catalog entries. `catalog:` or `catalog:<name>` will be added to `package.json` and the package specifier will be added to the `catalogs` or `catalog[<name>]` object in `pnpm-workspace.yaml` [#9425](https://github.com/pnpm/pnpm/issues/9425).
+
+## 1000.1.5
+
+### Patch Changes
+
+- Updated dependencies [5ec7255]
+  - @pnpm/types@1000.6.0
+
+## 1000.1.4
+
+### Patch Changes
+
+- Updated dependencies [5b73df1]
+  - @pnpm/types@1000.5.0
+
+## 1000.1.3
+
+### Patch Changes
+
+- Updated dependencies [750ae7d]
+  - @pnpm/types@1000.4.0
+
+## 1000.1.2
+
+### Patch Changes
+
+- Updated dependencies [5f7be64]
+- Updated dependencies [5f7be64]
+  - @pnpm/types@1000.3.0
+
+## 1000.1.1
+
+### Patch Changes
+
+- Updated dependencies [a5e4965]
+  - @pnpm/types@1000.2.1
+
+## 1000.1.0
+
+### Minor Changes
+
+- 8fcc221: Extend WorkspaceManifest with PnpmSettings.
+- 8fcc221: The `packages` field in `pnpm-workspace.yaml` became optional.
+
+### Patch Changes
+
+- Updated dependencies [8fcc221]
+  - @pnpm/types@1000.2.0
+
+## 1000.0.2
+
+### Patch Changes
+
+- Updated dependencies [9a44e6c]
+  - @pnpm/constants@1001.1.0
+  - @pnpm/error@1000.0.2
+
+## 1000.0.1
+
+### Patch Changes
+
+- Updated dependencies [d2e83b0]
+- Updated dependencies [a76da0c]
+  - @pnpm/constants@1001.0.0
+  - @pnpm/error@1000.0.1
+
+## 2.2.2
+
+### Patch Changes
+
+- Updated dependencies [19d5b51]
+- Updated dependencies [8108680]
+- Updated dependencies [c4f5231]
+  - @pnpm/constants@10.0.0
+  - @pnpm/error@6.0.3
+
+## 2.2.1
+
+### Patch Changes
+
+- Updated dependencies [83681da]
+  - @pnpm/constants@9.0.0
+  - @pnpm/error@6.0.2
+
+## 2.2.0
+
+### Minor Changes
+
+- 9c63679: The `readWorkspaceManifest` function now parses and validates [pnpm catalogs](https://github.com/pnpm/rfcs/pull/1) configs if present.
+
+## 2.1.0
+
+### Minor Changes
+
+- 5d1ed94: The type definition for the `packages` field of the `WorkspaceManifest` is now non-null. The `readWorkspaceManifest` function expects this field to be present and throws an error otherwise.
+
+## 2.0.1
+
+### Patch Changes
+
+- Updated dependencies [a7aef51]
+  - @pnpm/error@6.0.1
+
+## 2.0.0
+
+### Major Changes
+
+- 43cdd87: Node.js v16 support dropped. Use at least Node.js v18.12.
+
+### Patch Changes
+
+- Updated dependencies [3ded840]
+- Updated dependencies [c692f80]
+- Updated dependencies [43cdd87]
+- Updated dependencies [d381a60]
+  - @pnpm/error@6.0.0
+  - @pnpm/constants@8.0.0
+
+## 1.0.2
+
+### Patch Changes
+
+- e8926e920: Minor refactors to improve the type safety of the workspace manifest validation logic in the `readWorkspaceManifest` function.
+
+## 1.0.1
+
+### Patch Changes
+
+- e2a0c7272: Don't fail on an empty `pnpm-workspace.yaml` file [#7307](https://github.com/pnpm/pnpm/issues/7307).
+
+## 1.0.0
+
+### Major Changes
+
+- 3f7e65e10: Initial release.

package/lib/index.js

@@ -4,6 +4,7 @@ import { WORKSPACE_MANIFEST_FILENAME } from '@pnpm/constants';
 import { readYamlFile } from 'read-yaml-file';
 import { assertValidWorkspaceManifestCatalog, assertValidWorkspaceManifestCatalogs, } from './catalogs.js';
 import { InvalidWorkspaceManifestError } from './errors/InvalidWorkspaceManifestError.js';
+import { assertValidWorkspaceManifestVersioning } from './versioning.js';
 export async function readWorkspaceManifest(dir, cfgFileName = WORKSPACE_MANIFEST_FILENAME) {
     const manifest = await readManifestRaw(dir, cfgFileName);
     validateWorkspaceManifest(manifest);
@@ -40,6 +41,7 @@ export function validateWorkspaceManifest(manifest) {
     assertValidWorkspaceManifestPackages(manifest);
     assertValidWorkspaceManifestCatalog(manifest);
     assertValidWorkspaceManifestCatalogs(manifest);
+    assertValidWorkspaceManifestVersioning(manifest);
     checkWorkspaceManifestAssignability(manifest);
 }
 function assertValidWorkspaceManifestPackages(manifest) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnpm/workspace.workspace-manifest-reader",
-  "version": "1100.0.9",
+  "version": "1100.1.1",
   "description": "Reads a workspace manifest file",
   "keywords": [
     "pnpm",
@@ -27,14 +27,14 @@
     "!*.map"
   ],
   "dependencies": {
-    "read-yaml-file": "^3.0.0",
+    "@pnpm/constants": "1100.0.0",
     "@pnpm/error": "1100.0.1",
-    "@pnpm/types": "1101.3.2",
-    "@pnpm/constants": "1100.0.0"
+    "@pnpm/types": "1101.5.0",
+    "read-yaml-file": "^3.0.0"
   },
   "devDependencies": {
     "@jest/globals": "30.4.1",
-    "@pnpm/workspace.workspace-manifest-reader": "1100.0.9"
+    "@pnpm/workspace.workspace-manifest-reader": "1100.1.1"
   },
   "engines": {
     "node": ">=22.13"

package/lib/catalogs.d.ts

@@ -1,18 +0,0 @@
-export interface WorkspaceNamedCatalogs {
-    [catalogName: string]: WorkspaceCatalog;
-}
-export interface WorkspaceCatalog {
-    [dependencyName: string]: string;
-}
-export declare function assertValidWorkspaceManifestCatalog(manifest: {
-    packages?: readonly string[];
-    catalog?: unknown;
-}): asserts manifest is {
-    catalog?: WorkspaceCatalog;
-};
-export declare function assertValidWorkspaceManifestCatalogs(manifest: {
-    packages?: readonly string[];
-    catalogs?: unknown;
-}): asserts manifest is {
-    catalogs?: WorkspaceNamedCatalogs;
-};

package/lib/catalogs.js

@@ -1,45 +0,0 @@
-import { InvalidWorkspaceManifestError } from './errors/InvalidWorkspaceManifestError.js';
-export function assertValidWorkspaceManifestCatalog(manifest) {
-    if (manifest.catalog == null) {
-        return;
-    }
-    if (Array.isArray(manifest.catalog)) {
-        throw new InvalidWorkspaceManifestError('Expected catalog field to be an object, but found - array');
-    }
-    if (typeof manifest.catalog !== 'object') {
-        throw new InvalidWorkspaceManifestError(`Expected catalog field to be an object, but found - ${typeof manifest.catalog}`);
-    }
-    for (const [alias, specifier] of Object.entries(manifest.catalog)) {
-        if (typeof specifier !== 'string') {
-            throw new InvalidWorkspaceManifestError(`Invalid catalog entry for ${alias}. Expected string, but found: ${typeof specifier}`);
-        }
-    }
-}
-export function assertValidWorkspaceManifestCatalogs(manifest) {
-    if (manifest.catalogs == null) {
-        return;
-    }
-    if (Array.isArray(manifest.catalogs)) {
-        throw new InvalidWorkspaceManifestError('Expected catalogs field to be an object, but found - array');
-    }
-    if (typeof manifest.catalogs !== 'object') {
-        throw new InvalidWorkspaceManifestError(`Expected catalogs field to be an object, but found - ${typeof manifest.catalogs}`);
-    }
-    for (const [catalogName, catalog] of Object.entries(manifest.catalogs)) {
-        if (Array.isArray(catalog)) {
-            throw new InvalidWorkspaceManifestError(`Expected named catalog ${catalogName} to be an object, but found - array`);
-        }
-        if (catalog === null) {
-            throw new InvalidWorkspaceManifestError(`Expected named catalog ${catalogName} to be an object, but found - null`);
-        }
-        if (typeof catalog !== 'object') {
-            throw new InvalidWorkspaceManifestError(`Expected named catalog ${catalogName} to be an object, but found - ${typeof catalog}`);
-        }
-        for (const [alias, specifier] of Object.entries(catalog)) {
-            if (typeof specifier !== 'string') {
-                throw new InvalidWorkspaceManifestError(`Catalog '${catalogName}' has invalid entry '${alias}'. Expected string specifier, but found: ${typeof specifier}`);
-            }
-        }
-    }
-}
-//# sourceMappingURL=catalogs.js.map

package/lib/errors/InvalidWorkspaceManifestError.d.ts

@@ -1,4 +0,0 @@
-import { PnpmError } from '@pnpm/error';
-export declare class InvalidWorkspaceManifestError extends PnpmError {
-    constructor(message: string);
-}

package/lib/errors/InvalidWorkspaceManifestError.js

@@ -1,7 +0,0 @@
-import { PnpmError } from '@pnpm/error';
-export class InvalidWorkspaceManifestError extends PnpmError {
-    constructor(message) {
-        super('INVALID_WORKSPACE_CONFIGURATION', message);
-    }
-}
-//# sourceMappingURL=InvalidWorkspaceManifestError.js.map

package/lib/index.d.ts

@@ -1,20 +0,0 @@
-import { type GLOBAL_CONFIG_YAML_FILENAME, WORKSPACE_MANIFEST_FILENAME } from '@pnpm/constants';
-import type { PnpmSettings } from '@pnpm/types';
-import { type WorkspaceCatalog, type WorkspaceNamedCatalogs } from './catalogs.js';
-export type ConfigFileName = typeof GLOBAL_CONFIG_YAML_FILENAME | typeof WORKSPACE_MANIFEST_FILENAME;
-export interface WorkspaceManifest extends PnpmSettings {
-    packages: string[];
-    /**
-     * The default catalog. Package manifests may refer to dependencies in this
-     * definition through the `catalog:default` specifier or the `catalog:`
-     * shorthand.
-     */
-    catalog?: WorkspaceCatalog;
-    /**
-     * A dictionary of named catalogs. Package manifests may refer to dependencies
-     * in this definition through the `catalog:<name>` specifier.
-     */
-    catalogs?: WorkspaceNamedCatalogs;
-}
-export declare function readWorkspaceManifest(dir: string, cfgFileName?: ConfigFileName): Promise<WorkspaceManifest | undefined>;
-export declare function validateWorkspaceManifest(manifest: unknown): asserts manifest is WorkspaceManifest | undefined;