@pnpm/releasing.versioning 1100.1.0 → 1100.1.2

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @pnpm/releasing.versioning
 
+## 1100.1.2
+
+### Patch Changes
+
+- Updated dependencies:
+  - @pnpm/workspace.project-manifest-reader@1100.0.17
+
+## 1100.1.1
+
+### Patch Changes
+
+- Updated dependencies:
+  - @pnpm/workspace.project-manifest-reader@1100.0.16
+
 ## 1100.1.0
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnpm/releasing.versioning",
-  "version": "1100.1.0",
+  "version": "1100.1.2",
   "description": "Native workspace release management: change intents, release-plan assembly, and changelog writing",
   "keywords": [
     "pnpm",
@@ -29,7 +29,7 @@
   "dependencies": {
     "@pnpm/error": "1100.0.1",
     "@pnpm/types": "1101.4.0",
-    "@pnpm/workspace.project-manifest-reader": "1100.0.15",
+    "@pnpm/workspace.project-manifest-reader": "1100.0.17",
     "@pnpm/workspace.spec-parser": "1100.0.0",
     "human-id": "^4.2.0",
     "semver": "^7.8.4",
@@ -37,7 +37,7 @@
   },
   "devDependencies": {
     "@jest/globals": "30.4.1",
-    "@pnpm/releasing.versioning": "1100.1.0",
+    "@pnpm/releasing.versioning": "1100.1.2",
     "@types/semver": "7.7.1",
     "tempy": "3.0.0"
   },

package/lib/applyReleasePlan.d.ts

@@ -1,35 +0,0 @@
-import type { VersioningChangelogStorage, VersioningSettings } from '@pnpm/types';
-import { type ReleasePlan, type WorkspaceProject } from './assembleReleasePlan.js';
-import type { ChangeIntent } from './intents.js';
-/**
- * Registry storage is the default: no CHANGELOG.md is committed; a release's
- * section is parked (see {@link writePendingChangelog}) and packed into the
- * published tarball. `repository` opts back into committed changelogs.
- */
-export declare function changelogStorage(versioning?: VersioningSettings): VersioningChangelogStorage;
-export interface ApplyReleasePlanOptions {
-    workspaceDir: string;
-    projects: WorkspaceProject[];
-    /**
-     * All intent files currently in the workspace, used to decide which files
-     * are fully consumed after this run and can be deleted.
-     */
-    allIntents: ChangeIntent[];
-    versioning?: VersioningSettings;
-    /**
-     * In `registry` changelog storage, the gate that lets a ledgered release's
-     * intents be garbage-collected: it must resolve `true` only once the
-     * registry has published `${name}@${version}` and that tarball's
-     * CHANGELOG.md already contains `section`. Without it, registry-mode
-     * releases keep their intents (the repository is still their only prose).
-     * Ignored in `repository` storage, where the committed changelog already
-     * holds the prose and the ledger alone gates deletion.
-     */
-    verifyPublished?: (name: string, version: string, section: string) => Promise<boolean>;
-}
-export interface AppliedRelease {
-    name: string;
-    currentVersion: string;
-    newVersion: string;
-}
-export declare function applyReleasePlan(plan: ReleasePlan, opts: ApplyReleasePlanOptions): Promise<AppliedRelease[]>;

package/lib/applyReleasePlan.js

@@ -1,115 +0,0 @@
-import fs from 'node:fs/promises';
-import { readProjectManifest } from '@pnpm/workspace.project-manifest-reader';
-import { indexProjectRefs } from './assembleReleasePlan.js';
-import { composeChangelogSection, prependChangelogSection } from './changelog.js';
-import { appendToLedger, buildConsumptionIndex } from './ledger.js';
-import { listPendingChangelogs, readPendingChangelog, removePendingChangelog, writePendingChangelog } from './pendingChangelog.js';
-/**
- * Registry storage is the default: no CHANGELOG.md is committed; a release's
- * section is parked (see {@link writePendingChangelog}) and packed into the
- * published tarball. `repository` opts back into committed changelogs.
- */
-export function changelogStorage(versioning) {
-    return versioning?.changelog?.storage ?? 'registry';
-}
-export async function applyReleasePlan(plan, opts) {
-    const storage = changelogStorage(opts.versioning);
-    const applied = await Promise.all(plan.releases.map(async (release) => {
-        const { manifest, writeProjectManifest } = await readProjectManifest(release.rootDir);
-        manifest.version = release.newVersion;
-        await writeProjectManifest(manifest);
-        return {
-            name: release.name,
-            currentVersion: release.currentVersion,
-            newVersion: release.newVersion,
-        };
-    }));
-    // In `repository` storage the section is committed to CHANGELOG.md now. In
-    // `registry` storage nothing is committed to the package; the section is
-    // parked until publish, when it is packed into the tarball.
-    await Promise.all(plan.releases.map(async (release) => {
-        const section = composeChangelogSection(release);
-        if (storage === 'repository') {
-            await prependChangelogSection(release.rootDir, release.name, section);
-        }
-        else {
-            await writePendingChangelog(opts.workspaceDir, release.name, release.newVersion, section);
-        }
-    }));
-    const newEntries = {};
-    for (const release of plan.releases) {
-        if (release.intents.length === 0)
-            continue;
-        newEntries[`${release.name}@${release.newVersion}`] = {
-            dir: release.dir,
-            intents: release.intents.map((intent) => intent.id).sort(),
-        };
-    }
-    const ledger = await appendToLedger(opts.workspaceDir, newEntries);
-    // An intent file is deletable once every project it names has a consumed
-    // ledger entry for it, with one exemption: while a project is still on a
-    // lane, entries against prerelease versions alone keep the file alive — its
-    // prose is still needed to compose the stable changelog section at
-    // graduation. Declined (`none`) entries demand no release and never block
-    // deletion. References here were already validated by the plan assembly,
-    // so an unresolvable one just keeps its file around.
-    //
-    // In `registry` storage the ledger alone does not authorize deletion: the
-    // repository is the only copy of the prose until the release is published,
-    // so an entry counts as consumed only once the registry confirms its version
-    // carries the composed section.
-    const refs = indexProjectRefs(opts.projects, opts.workspaceDir);
-    const consumedLedger = storage === 'repository'
-        ? ledger
-        : await confirmPublished(ledger, opts);
-    const consumptionOf = buildConsumptionIndex(consumedLedger, refs.nameToDirs);
-    const laneDirs = new Set();
-    for (const ref of Object.keys(opts.versioning?.lanes ?? {})) {
-        for (const dir of refs.refToDirs(ref)) {
-            laneDirs.add(dir);
-        }
-    }
-    const deletable = opts.allIntents.filter((intent) => Object.entries(intent.releases).every(([ref, bumpType]) => {
-        if (bumpType === 'none')
-            return true;
-        const dirs = refs.refToDirs(ref);
-        if (dirs.length !== 1)
-            return false;
-        const consumption = consumptionOf(dirs[0]);
-        return consumption.allIds.has(intent.id) &&
-            !(laneDirs.has(dirs[0]) && consumption.prereleaseOnlyIds.has(intent.id));
-    }));
-    await Promise.all(deletable.map(async (intent) => fs.rm(intent.filePath)));
-    return applied;
-}
-/**
- * Confirms the parked sections whose releases the registry reports published
- * with that section, deletes those section files (their prose now lives in the
- * published tarball), and returns the subset of `ledger` those confirmations
- * cover — the consumed ledger that gates intent deletion. Driven by the parked
- * files rather than the ledger, so a dependency-propagated release (which has a
- * section but no consumed intents, hence no ledger entry) still gets its
- * section collected. Every parked file belongs to an as-yet-unpublished
- * release, so the confirmation cost is bounded by the release backlog, not by
- * history.
- */
-async function confirmPublished(ledger, opts) {
-    const { verifyPublished } = opts;
-    const confirmed = Object.create(null);
-    if (verifyPublished == null)
-        return confirmed;
-    const pending = await listPendingChangelogs(opts.workspaceDir);
-    await Promise.all(pending.map(async ({ name, version }) => {
-        const section = await readPendingChangelog(opts.workspaceDir, name, version);
-        if (section == null)
-            return;
-        if (!(await verifyPublished(name, version, section)))
-            return;
-        const key = `${name}@${version}`;
-        if (ledger[key] != null)
-            confirmed[key] = ledger[key];
-        await removePendingChangelog(opts.workspaceDir, name, version);
-    }));
-    return confirmed;
-}
-//# sourceMappingURL=applyReleasePlan.js.map

package/lib/assembleReleasePlan.d.ts

@@ -1,91 +0,0 @@
-import type { ProjectManifest, VersioningSettings } from '@pnpm/types';
-import type { ChangeIntent, ReleaseBumpType } from './intents.js';
-import { type Ledger } from './ledger.js';
-export interface WorkspaceProject {
-    rootDir: string;
-    manifest: ProjectManifest;
-}
-export type ReleaseCause = 'intent' | 'dependencies' | 'fixed' | 'epic';
-export interface DependencyUpdate {
-    name: string;
-    newVersion: string;
-}
-export interface PlannedRelease {
-    name: string;
-    /** Workspace-relative project directory — the engine's unit of identity. */
-    dir: string;
-    rootDir: string;
-    currentVersion: string;
-    newVersion: string;
-    bumpType: ReleaseBumpType;
-    /**
-     * The intent files this release consumes for this package: the pending ones,
-     * plus — when the release graduates the package off a lane — the
-     * ones the ledger recorded against the lane's prerelease versions.
-     */
-    intents: ChangeIntent[];
-    dependencyUpdates: DependencyUpdate[];
-    causes: ReleaseCause[];
-}
-export interface ReleasePlan {
-    releases: PlannedRelease[];
-}
-export interface AssembleReleasePlanOptions {
-    workspaceDir: string;
-    projects: WorkspaceProject[];
-    intents: ChangeIntent[];
-    ledger: Ledger;
-    versioning?: VersioningSettings;
-    /**
-     * Workspace-relative directories of the projects selected with --filter.
-     * The plan is narrowed to the selected packages' portion of the pending
-     * work, expanded with their fixed-group companions and range-invalidated
-     * dependents.
-     */
-    filter?: Set<string>;
-    /**
-     * When set, every planned release gets the version `0.0.0-<suffix>` instead
-     * of the computed one, matching snapshot releases.
-     */
-    snapshotSuffix?: string;
-    /**
-     * Enforce that every internal production dependency uses the `workspace:`
-     * protocol — a prerequisite for actually releasing. The release path
-     * (`pnpm version -r`) sets this; read-only callers (`pnpm change status`)
-     * leave it off so a diagnostic never fails on an unmigrated dependency.
-     */
-    enforceWorkspaceProtocol?: boolean;
-}
-/**
- * Whether a package reference is a workspace-relative directory path rather
- * than a package name — the additive extension to the changesets format,
- * needed only when workspace projects share a published name.
- */
-export declare function isDirRef(ref: string): boolean;
-/**
- * Resolves package references — bare names, or `./`-prefixed
- * workspace-relative directories — against the workspace. Names are aliases:
- * one that matches several projects cannot identify any of them and callers
- * must treat it as an error, never a silent pick.
- */
-export interface ProjectRefIndex {
-    /** The directories a reference resolves to: `[]` unknown, 2+ ambiguous. */
-    refToDirs: (ref: string) => string[];
-    nameToDirs: (name: string) => string[];
-}
-export declare function indexProjectRefs(projects: ReadonlyArray<{
-    rootDir: string;
-    manifest: {
-        name?: string;
-    };
-}>, workspaceDir: string): ProjectRefIndex;
-/** The workspace-relative directory of a project, in canonical spelling. */
-export declare function toProjectDir(workspaceDir: string, rootDir: string): string;
-export declare function assembleReleasePlan(opts: AssembleReleasePlanOptions): ReleasePlan;
-/**
- * The range that pnpm materializes for a workspace: spec at pack time, given
- * the dependency's version at the dependent's previous release. Dependent
- * propagation republishes the dependent whenever the dependency's new version
- * falls outside this range.
- */
-export declare function materializeWorkspaceRange(spec: string, depCurrentVersion: string): string | null;