@williamthorsen/release-kit 15.0.3 → 16.1.0

package/dist/esm/sync-labels/resolveLabels.js

@@ -6,23 +6,23 @@ export function resolveLabels(config) {
         const groupList = caseVariantGroups.map((group) => group.map((name) => `'${name}'`).join(' and ')).join('; ');
         throw new Error(`Keys in 'labels' differ only in case, which GitHub treats as the same label: ${groupList}. Keep one entry per label.`);
     }
-    const resolved = new Map();
+    const resolvedLabels = new Map();
     const presetNames = config.extends ?? [];
     for (const presetName of presetNames) {
         for (const label of loadPreset(presetName)) {
-            resolved.set(toLabelKey(label.name), label);
+            resolvedLabels.set(getLabelKey(label.name), label);
         }
     }
     for (const [name, spec] of labelEntries) {
-        const key = toLabelKey(name);
+        const key = getLabelKey(name);
         if (spec === null) {
-            if (!resolved.has(key)) {
+            if (!resolvedLabels.has(key)) {
                 throw new Error(`Label '${name}' is set to null (remove), but the presets in 'extends' don't define it. Fix the name or delete the entry.`);
             }
-            resolved.delete(key);
+            resolvedLabels.delete(key);
         }
         else {
-            resolved.set(key, {
+            resolvedLabels.set(key, {
                 name,
                 color: spec.color,
                 ...(spec.description !== undefined && { description: spec.description }),
@@ -31,7 +31,7 @@ export function resolveLabels(config) {
             });
         }
     }
-    const labels = sortLabels(resolved.values().toArray());
+    const labels = sortLabels(resolvedLabels.values().toArray());
     const aliasCollisions = findAliasCollisions(labels);
     if (aliasCollisions.length > 0) {
         throw new Error(`Aliases must name labels that are not declared and must not repeat, or the sync merges one label into another and deletes it: ${aliasCollisions.join('; ')}.`);
@@ -39,13 +39,13 @@ export function resolveLabels(config) {
     return labels;
 }
 function findAliasCollisions(labels) {
-    const labelNamesByKey = new Map(labels.map((label) => [toLabelKey(label.name), label.name]));
+    const labelNamesByKey = new Map(labels.map((label) => [getLabelKey(label.name), label.name]));
     const aliasOwnersByKey = new Map();
     const collisions = [];
     for (const label of labels) {
         const aliases = label.aliases ?? [];
         for (const alias of aliases) {
-            const key = toLabelKey(alias);
+            const key = getLabelKey(alias);
             const namedLabel = labelNamesByKey.get(key);
             const earlierOwner = aliasOwnersByKey.get(key);
             if (namedLabel !== undefined) {
@@ -62,14 +62,14 @@ function findAliasCollisions(labels) {
     return collisions;
 }
 function findCaseVariantGroups(names) {
-    return Map.groupBy(names, toLabelKey)
+    return Map.groupBy(names, getLabelKey)
         .values()
         .filter((group) => group.length > 1)
         .toArray();
 }
+function getLabelKey(name) {
+    return name.toLowerCase();
+}
 function sortLabels(labels) {
     return labels.toSorted((a, b) => a.name.localeCompare(b.name));
 }
-function toLabelKey(name) {
-    return name.toLowerCase();
-}

package/dist/esm/sync-labels/templates.d.ts

@@ -15,5 +15,5 @@ export declare function buildScopeLabels(workspacePaths: string[], retiredNames?
  * `.config/release-kit.config.ts`.
  */
 export declare function renderRepoLabelsBlock(scopeLabels: LabelDefinition[]): string;
-/** Generates a new `.config/release-kit.config.ts` containing the `repoLabels` block. */
-export declare function repoLabelsConfigScript(scopeLabels: LabelDefinition[]): string;
+/** Renders a new `.config/release-kit.config.ts` containing the `repoLabels` block. */
+export declare function renderRepoLabelsConfigScript(scopeLabels: LabelDefinition[]): string;

package/dist/esm/sync-labels/templates.js

@@ -33,7 +33,7 @@ export function renderRepoLabelsBlock(scopeLabels) {
 ${labelsBlock}
   },`;
 }
-export function repoLabelsConfigScript(scopeLabels) {
+export function renderRepoLabelsConfigScript(scopeLabels) {
     return `import { defineConfig } from '@williamthorsen/release-kit/config';
 
 export default defineConfig({

package/dist/esm/tagCommand.js

@@ -2,13 +2,13 @@ import { parseArgsOrExit, reportError } from '@williamthorsen/nmr-core';
 import { describeError } from '@williamthorsen/toolbelt.errors';
 import { createTags } from "./createTags.js";
 const tagFlagSchema = {
-    dryRun: { long: '--dry-run', type: 'boolean' },
-    noGitChecks: { long: '--no-git-checks', type: 'boolean' },
+    isDryRun: { long: '--dry-run', type: 'boolean' },
+    shouldSkipGitChecks: { long: '--no-git-checks', type: 'boolean' },
 };
 export function tagCommand(argv, styles) {
-    const { dryRun, noGitChecks } = parseArgsOrExit(argv, tagFlagSchema).flags;
+    const { isDryRun, shouldSkipGitChecks } = parseArgsOrExit(argv, tagFlagSchema).flags;
     try {
-        createTags({ dryRun, noGitChecks, style: styles.stdout });
+        createTags({ isDryRun, shouldSkipGitChecks, style: styles.stdout });
     }
     catch (error) {
         reportError(describeError(error));

package/dist/esm/topologicalSort.d.ts

@@ -6,7 +6,7 @@ import type { ReleaseEntry } from './propagateBumps.js';
  * Uses Kahn's algorithm. Targets not in the release set are excluded. If the graph has
  * cycles, the remaining nodes are appended in arbitrary order and reported via `cyclicIds`.
  */
-export declare function topologicalSort(releaseSet: Map<string, ReleaseEntry>, graph: DependencyGraph): {
-    sorted: string[];
+export declare function sortTopologically(releaseSet: Map<string, ReleaseEntry>, graph: DependencyGraph): {
+    sortedIds: string[];
     cyclicIds: string[];
 };

package/dist/esm/topologicalSort.js

@@ -1,7 +1,7 @@
-export function topologicalSort(releaseSet, graph) {
+export function sortTopologically(releaseSet, graph) {
     const releaseIds = new Set(releaseSet.keys());
     if (releaseIds.size === 0) {
-        return { sorted: [], cyclicIds: [] };
+        return { sortedIds: [], cyclicIds: [] };
     }
     const inDegree = new Map();
     const forwardEdges = new Map();
@@ -31,13 +31,13 @@ export function topologicalSort(releaseSet, graph) {
             queue.push(id);
         }
     }
-    const sorted = [];
+    const sortedIds = [];
     while (queue.length > 0) {
         const id = queue.shift();
         if (id === undefined) {
             break;
         }
-        sorted.push(id);
+        sortedIds.push(id);
         const dependents = forwardEdges.get(id) ?? [];
         for (const dependent of dependents) {
             const newDegree = (inDegree.get(dependent) ?? 1) - 1;
@@ -47,14 +47,14 @@ export function topologicalSort(releaseSet, graph) {
             }
         }
     }
-    const sortedSet = new Set(sorted);
+    const sortedSet = new Set(sortedIds);
     const cyclicIds = [];
     for (const id of releaseIds) {
         if (sortedSet.has(id)) {
             continue;
         }
-        sorted.push(id);
+        sortedIds.push(id);
         cyclicIds.push(id);
     }
-    return { sorted, cyclicIds };
+    return { sortedIds, cyclicIds };
 }

package/dist/esm/types.d.ts

@@ -70,7 +70,7 @@ export interface ChangelogMarkdownConfig {
      * How many of the newest versioned sections `CHANGELOG.md` keeps; older sections go to per-major archive files
      * under `changelogs/`. When omitted, `CHANGELOG.md` keeps every section.
      */
-    keepVersions?: number;
+    keptVersionCount?: number;
 }
 /**
  * Editorial override for changelog items, keyed in the override file by `<hash>` (every item of the commit) or
@@ -245,7 +245,7 @@ export interface ReleasedPackageResult extends PackageResultFields, ReleaseField
     /** Present when propagation alone set the bump, the package's own commits having called for none. */
     propagatedOnly?: true;
     /** Present when the package was written via `--set-version`; the explicit version that was applied. */
-    setVersion?: string;
+    versionOverride?: string;
 }
 /** Result of a package target that skips: the diagnostic fields and a human-readable `skipReason`. */
 export interface SkippedPackageResult extends PackageResultFields {
@@ -280,7 +280,7 @@ export interface ReleasedDirectoryResult extends DirectoryResultFields, ReleaseF
     /** Raw commits of the directory's unreleased window. */
     commits: Commit[];
     /** Present when the directory was written via `--set-version`; the explicit version that was applied. */
-    setVersion?: string;
+    versionOverride?: string;
 }
 /** Result of a directory target that skips: the diagnostic fields and a human-readable `skipReason`. */
 export interface SkippedDirectoryResult extends DirectoryResultFields {

package/dist/esm/validateAllChangelogOverrides.js

@@ -89,8 +89,8 @@ function prefixWithFilePath(filePath, message) {
 }
 function processProjectScope(args) {
     const { projectFilePath, projectMap, projectItems, errors, globalMatchedRootKeys } = args;
-    const applied = applyChangelogOverrides(makeValidationEntries(projectItems), projectMap);
-    for (const message of applied.errors) {
+    const appliedResult = applyChangelogOverrides(makeValidationEntries(projectItems), projectMap);
+    for (const message of appliedResult.errors) {
         errors.push(prefixWithFilePath(projectFilePath, message));
     }
     const positionsByHash = indexItemPositions(projectItems);
@@ -105,19 +105,19 @@ function processWorkspaceScope(args) {
     const { filePath, items, map } = workspace;
     const validationEntries = makeValidationEntries(items);
     const positionsByHash = indexItemPositions(items);
-    const workspaceApplied = applyChangelogOverrides(validationEntries, map);
-    for (const message of workspaceApplied.errors) {
+    const workspaceAppliedResult = applyChangelogOverrides(validationEntries, map);
+    for (const message of workspaceAppliedResult.errors) {
         errors.push(prefixWithFilePath(filePath, message));
     }
     if (projectFilePath !== undefined && projectMap.size > 0) {
         const projectMinusShadowed = filterShadowedKeys(projectMap, map);
-        const projectApplied = applyChangelogOverrides(validationEntries, projectMinusShadowed);
-        for (const message of projectApplied.errors) {
+        const projectAppliedResult = applyChangelogOverrides(validationEntries, projectMinusShadowed);
+        for (const message of projectAppliedResult.errors) {
             errors.push(prefixWithFilePath(projectFilePath, message));
         }
-        const perFileErrors = new Set([...workspaceApplied.errors, ...projectApplied.errors]);
-        const composedApplied = applyChangelogOverrides(validationEntries, composeOverrides(projectMap, map));
-        for (const message of composedApplied.errors) {
+        const perFileErrors = new Set([...workspaceAppliedResult.errors, ...projectAppliedResult.errors]);
+        const composedAppliedResult = applyChangelogOverrides(validationEntries, composeOverrides(projectMap, map));
+        for (const message of composedAppliedResult.errors) {
             if (!perFileErrors.has(message)) {
                 errors.push(prefixWithFilePath(filePath, message));
             }

package/dist/esm/validateConfig.d.ts

@@ -3,7 +3,7 @@ import { type ReleaseKitConfig } from './configSchema.js';
  * Validates a raw config object loaded from `.config/release-kit.config.ts`. Returns `{}` with the errors for a config
  * that fails the schema parse, and runs the cross-field checks on one that passes.
  */
-export declare function validateConfig(raw: unknown): {
+export declare function validateConfig(rawConfig: unknown): {
     config: ReleaseKitConfig;
     errors: string[];
     warnings: string[];

package/dist/esm/validateConfig.js

@@ -1,15 +1,18 @@
 import { releaseKitConfigSchema } from "./configSchema.js";
 import { isRecord } from "./typeGuards.js";
-export function validateConfig(raw) {
-    if (!isRecord(raw)) {
+export function validateConfig(rawConfig) {
+    if (!isRecord(rawConfig)) {
         return { config: {}, errors: ['Config must be an object'], warnings: [] };
     }
-    const { cleaned, deprecationErrors } = preprocessDeprecatedKeys(raw);
-    const parseResult = releaseKitConfigSchema.safeParse(cleaned);
+    const { cleanedInput, deprecationErrors } = preprocessDeprecatedKeys(rawConfig);
+    const parseResult = releaseKitConfigSchema.safeParse(cleanedInput);
     if (!parseResult.success) {
         return {
             config: {},
-            errors: [...deprecationErrors, ...parseResult.error.issues.flatMap((issue) => formatZodIssue(issue, cleaned))],
+            errors: [
+                ...deprecationErrors,
+                ...parseResult.error.issues.flatMap((issue) => formatZodIssue(issue, cleanedInput)),
+            ],
             warnings: [],
         };
     }
@@ -26,40 +29,47 @@ export function validateConfig(raw) {
     }
     return { config, errors, warnings };
 }
-function preprocessDeprecatedKeys(raw) {
-    if (!isRecord(raw))
-        return { cleaned: raw, deprecationErrors: [] };
+function preprocessDeprecatedKeys(rawConfig) {
+    if (!isRecord(rawConfig))
+        return { cleanedInput: rawConfig, deprecationErrors: [] };
     const errors = [];
-    const cleaned = { ...raw };
-    if (Object.hasOwn(cleaned, 'cliffConfigPath')) {
+    const cleanedInput = { ...rawConfig };
+    if (Object.hasOwn(cleanedInput, 'cliffConfigPath')) {
         errors.push('cliffConfigPath is no longer supported. release-kit reads changelog history from git directly and does not use any external config file. Remove this field from the config, and delete the file that it names.');
-        delete cleaned['cliffConfigPath'];
+        delete cleanedInput['cliffConfigPath'];
     }
-    if (isRecord(cleaned['releaseNotes']) && Object.hasOwn(cleaned['releaseNotes'], 'shouldCreateGithubRelease')) {
+    if (isRecord(cleanedInput['releaseNotes']) &&
+        Object.hasOwn(cleanedInput['releaseNotes'], 'shouldCreateGithubRelease')) {
         errors.push('releaseNotes.shouldCreateGithubRelease is no longer supported. Adoption is now signaled by installing the create-github-release workflow, which `release-kit init` scaffolds. Remove this field from the config.');
-        const releaseNotesCopy = { ...cleaned['releaseNotes'] };
+        const releaseNotesCopy = { ...cleanedInput['releaseNotes'] };
         delete releaseNotesCopy['shouldCreateGithubRelease'];
-        cleaned['releaseNotes'] = releaseNotesCopy;
-    }
-    if (Array.isArray(cleaned['workspaces'])) {
-        cleaned['workspaces'] = cleaned['workspaces'].map((ws, i) => {
-            if (!isRecord(ws))
-                return ws;
-            const wsCopy = { ...ws };
-            if (Object.hasOwn(wsCopy, 'tagPrefix')) {
-                const dir = typeof wsCopy['dir'] === 'string' && wsCopy['dir'] !== '' ? wsCopy['dir'] : '<dir>';
-                errors.push(`workspaces[${i}]: 'tagPrefix' is no longer supported; remove it to use the default '${dir}-v'`);
-                delete wsCopy['tagPrefix'];
+        cleanedInput['releaseNotes'] = releaseNotesCopy;
+    }
+    if (isRecord(cleanedInput['changelogMarkdown']) && Object.hasOwn(cleanedInput['changelogMarkdown'], 'keepVersions')) {
+        errors.push('changelogMarkdown.keepVersions has been renamed. Rename it to changelogMarkdown.keptVersionCount in the config.');
+        const changelogMarkdownCopy = { ...cleanedInput['changelogMarkdown'] };
+        delete changelogMarkdownCopy['keepVersions'];
+        cleanedInput['changelogMarkdown'] = changelogMarkdownCopy;
+    }
+    if (Array.isArray(cleanedInput['workspaces'])) {
+        cleanedInput['workspaces'] = cleanedInput['workspaces'].map((workspace, index) => {
+            if (!isRecord(workspace))
+                return workspace;
+            const workspaceCopy = { ...workspace };
+            if (Object.hasOwn(workspaceCopy, 'tagPrefix')) {
+                const dir = typeof workspaceCopy['dir'] === 'string' && workspaceCopy['dir'] !== '' ? workspaceCopy['dir'] : '<dir>';
+                errors.push(`workspaces[${index}]: 'tagPrefix' is no longer supported; remove it to use the default '${dir}-v'`);
+                delete workspaceCopy['tagPrefix'];
             }
-            if (Object.hasOwn(wsCopy, 'legacyTagPrefixes')) {
-                errors.push(`workspaces[${i}]: 'legacyTagPrefixes' is no longer supported; use 'legacyIdentities: [{ name, tagPrefix }, ...]' instead`);
-                delete wsCopy['legacyTagPrefixes'];
+            if (Object.hasOwn(workspaceCopy, 'legacyTagPrefixes')) {
+                errors.push(`workspaces[${index}]: 'legacyTagPrefixes' is no longer supported; use 'legacyIdentities: [{ name, tagPrefix }, ...]' instead`);
+                delete workspaceCopy['legacyTagPrefixes'];
             }
-            return wsCopy;
+            return workspaceCopy;
         });
     }
-    if (isRecord(cleaned['releases'])) {
-        const releasesCopy = { ...cleaned['releases'] };
+    if (isRecord(cleanedInput['releases'])) {
+        const releasesCopy = { ...cleanedInput['releases'] };
         for (const [name, entry] of Object.entries(releasesCopy)) {
             if (!isRecord(entry) || !Object.hasOwn(entry, 'paths'))
                 continue;
@@ -68,9 +78,9 @@ function preprocessDeprecatedKeys(raw) {
             delete entryCopy['paths'];
             releasesCopy[name] = entryCopy;
         }
-        cleaned['releases'] = releasesCopy;
+        cleanedInput['releases'] = releasesCopy;
     }
-    return { cleaned, deprecationErrors: errors };
+    return { cleanedInput, deprecationErrors: errors };
 }
 function formatZodIssue(issue, input) {
     if (issue.code === 'invalid_union' && issue.path.length === 2 && issue.path[0] === 'releases') {
@@ -92,42 +102,42 @@ function customizeMessage(issue) {
 }
 const RELEASE_ENTRY_SHAPES = 'must be false, { path, tagPrefix?, legacyIdentities? }, or { includes, tagPrefix? }';
 function renderPath(path) {
-    let rendered = '';
+    let renderedPath = '';
     for (const segment of path) {
         if (typeof segment === 'number') {
-            rendered += `[${segment}]`;
+            renderedPath += `[${segment}]`;
         }
-        else if (rendered === '') {
-            rendered += String(segment);
+        else if (renderedPath === '') {
+            renderedPath += String(segment);
         }
         else {
-            rendered += `.${String(segment)}`;
+            renderedPath += `.${String(segment)}`;
         }
     }
-    return rendered;
+    return renderedPath;
 }
 function detectLegacyIdentityDuplicates(config, errors) {
     for (const { label, legacyIdentities } of listLegacyIdentityDeclarations(config)) {
-        const seen = new Set();
+        const seenKeys = new Set();
         for (const [entryIndex, identity] of legacyIdentities.entries()) {
             const key = `${identity.name}\0${identity.tagPrefix}`;
-            if (seen.has(key)) {
+            if (seenKeys.has(key)) {
                 errors.push(`${label}.legacyIdentities[${entryIndex}]: duplicate identity (name='${identity.name}', tagPrefix='${identity.tagPrefix}')`);
             }
-            seen.add(key);
+            seenKeys.add(key);
         }
     }
 }
 function detectRetiredPackageDuplicates(config, errors) {
     if (config.retiredPackages === undefined)
         return;
-    const seen = new Set();
-    for (const [index, retired] of config.retiredPackages.entries()) {
-        const key = `${retired.name}\0${retired.tagPrefix}`;
-        if (seen.has(key)) {
-            errors.push(`retiredPackages[${index}]: duplicate package (name='${retired.name}', tagPrefix='${retired.tagPrefix}')`);
+    const seenKeys = new Set();
+    for (const [index, retiredPackage] of config.retiredPackages.entries()) {
+        const key = `${retiredPackage.name}\0${retiredPackage.tagPrefix}`;
+        if (seenKeys.has(key)) {
+            errors.push(`retiredPackages[${index}]: duplicate package (name='${retiredPackage.name}', tagPrefix='${retiredPackage.tagPrefix}')`);
         }
-        seen.add(key);
+        seenKeys.add(key);
     }
 }
 function detectRetiredVsLegacyCollisions(config, errors) {
@@ -141,10 +151,10 @@ function detectRetiredVsLegacyCollisions(config, errors) {
             }
         }
     }
-    for (const [index, retired] of config.retiredPackages.entries()) {
-        const collidingOwner = legacyPrefixToOwner.get(retired.tagPrefix);
+    for (const [index, retiredPackage] of config.retiredPackages.entries()) {
+        const collidingOwner = legacyPrefixToOwner.get(retiredPackage.tagPrefix);
         if (collidingOwner !== undefined) {
-            errors.push(`retiredPackages[${index}]: tagPrefix '${retired.tagPrefix}' collides with a declared legacyIdentities[].tagPrefix on ${collidingOwner}`);
+            errors.push(`retiredPackages[${index}]: tagPrefix '${retiredPackage.tagPrefix}' collides with a declared legacyIdentities[].tagPrefix on ${collidingOwner}`);
         }
     }
 }

package/dist/esm/validateOverridesCommand.js

@@ -11,7 +11,7 @@ const SYNTHETIC_VALIDATE_TAG = 'validate-only';
 export async function validateOverridesCommand(styles, configPath, dependencies = {}) {
     const discover = dependencies.discoverWorkspaces ?? discoverWorkspaces;
     const load = dependencies.loadValidatedConfig ?? (() => loadValidatedConfig(configPath));
-    const buildEntries = dependencies.buildEntries ?? defaultBuildEntries;
+    const buildEntries = dependencies.buildEntries ?? buildEntriesByDefault;
     const validate = dependencies.validate ?? validateAllChangelogOverrides;
     const configResult = await load();
     if (configResult.status === 'invalid') {
@@ -66,7 +66,7 @@ function formatSummaryLine(errorCount, warningCount) {
 function pluralize(count, noun) {
     return count === 1 ? `${count} ${noun}` : `${count} ${noun}s`;
 }
-function defaultBuildEntries(config, options) {
+function buildEntriesByDefault(config, options) {
     return buildChangelogEntries(config, SYNTHETIC_VALIDATE_TAG, options).entries;
 }
 function flattenEntriesToItems(entries) {

package/docs/changelogs.md

@@ -2,7 +2,7 @@
 
 What a published tarball includes, what each `.meta/changelog.json` item contains, how `CHANGELOG.md` archives older versions, which commits appear in a changelog, how a merge commit's change-record block becomes items, and how release notes are written into a README.
 
-npm doesn't include either `CHANGELOG.md` or `.meta/changelog.json` in a published tarball on its own. npm stopped including `CHANGELOG` automatically in npm 7, so a package that declares a `files` field publishes a changelog only when that field names `CHANGELOG.md` and `.meta/changelog.json`. release-kit's readyup kit reports a publishable workspace whose `files` field omits either, and, when [`changelogMarkdown.keepVersions`](#archived-versions) is set, one whose `files` field omits `changelogs/`.
+npm doesn't include either `CHANGELOG.md` or `.meta/changelog.json` in a published tarball on its own. npm stopped including `CHANGELOG` automatically in npm 7, so a package that declares a `files` field publishes a changelog only when that field names `CHANGELOG.md` and `.meta/changelog.json`. release-kit's readyup kit reports a publishable workspace whose `files` field omits either, and, when [`changelogMarkdown.keptVersionCount`](#archived-versions) is set, one whose `files` field omits `changelogs/`.
 
 ## `changelog.json` item schema
 
@@ -43,19 +43,19 @@ The label match is exact: `migration:` and `**Migration:**` are not recognized.
 
 ## Archived versions
 
-`changelogMarkdown.keepVersions` bounds `CHANGELOG.md`, which otherwise grows by one section per release. `.meta/changelog.json` is not affected: It contains every version whatever the option says.
+`changelogMarkdown.keptVersionCount` bounds `CHANGELOG.md`, which otherwise grows by one section per release. `.meta/changelog.json` is not affected: It contains every version whatever the option says.
 
 ```typescript
 export default defineConfig({
-  changelogMarkdown: { keepVersions: 20 },
+  changelogMarkdown: { keptVersionCount: 20 },
 });
 ```
 
 With the option set, `prepare` writes each changelog as follows:
 
-- **`CHANGELOG.md`** contains the newest `keepVersions` sections, counting [hand-written sections](#existing-changelogmd-sections), and a paragraph below its header that links to each archive file.
+- **`CHANGELOG.md`** contains as many of the newest sections as `keptVersionCount` names, counting [hand-written sections](#existing-changelogmd-sections), and a paragraph below its header that links to each archive file.
 - **`changelogs/CHANGELOG-v{major}.md`**, beside `CHANGELOG.md`, contains every older section of that major version, newest first, under the same header and footer. `0.x` versions share `CHANGELOG-v0.md`, and a prerelease belongs to its major.
-- **An archive file that the render no longer produces**, after `keepVersions` is raised or the option is removed: `prepare` deletes it and renders its sections in `CHANGELOG.md` again. Every section is therefore in exactly one file.
+- **An archive file that the render no longer produces**, after `keptVersionCount` is raised or the option is removed: `prepare` deletes it and renders its sections in `CHANGELOG.md` again. Every section is therefore in exactly one file.
 
 `prepare` regenerates the archive files on every release of the target, so an override applies to an archived version as it does to any other. A target that does not release keeps its unbounded `CHANGELOG.md` until its next release. The prepare report lists each archive file that it writes and each that it removes.
 

package/docs/configuration.md

@@ -16,21 +16,22 @@ The two paths differ in what an absent file means. An absent default path means
 
 ## `ReleaseKitConfig` reference
 
-| Field               | Type                                        | Description                                                                                                                                                                                                                                                                              |
-| ------------------- | ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `releases`          | `Record<string, ReleaseEntry>`              | Names, excludes, or composes release targets; see [`releases`](#releases). Can't be combined with `workspaces` or `project`                                                                                                                                                              |
-| `workspaces`        | `WorkspaceOverride[]`                       | Override or exclude discovered workspaces (matched by `dir`)                                                                                                                                                                                                                             |
-| `formatCommand`     | `string`                                    | Shell command to run after changelog generation; modified file paths are appended as arguments                                                                                                                                                                                           |
-| `versionPatterns`   | `VersionPatterns`                           | Rules for which commit types trigger major/minor bumps                                                                                                                                                                                                                                   |
-| `scopeAliases`      | `Record<string, string>`                    | Maps shorthand scope names to canonical names in commit titles and in change-record entry `scopes`, which [route items to workspaces](changelogs.md#routing-to-workspaces). A renamed workspace directory or [release target](#releases) needs an entry from its old name to its new one |
-| `workTypes`         | `Record<string, WorkTypeConfig>`            | Work type definitions, merged with defaults by key                                                                                                                                                                                                                                       |
-| `breakingPolicies`  | `Record<string, 'forbidden' \| 'optional'>` | Per-type `!`-policy lookup. Defaults to `DEFAULT_BREAKING_POLICIES`. Replaces the default entirely when provided. Set to `{}` to disable enforcement                                                                                                                                     |
-| `retiredPackages`   | `RetiredPackage[]`                          | Packages that once lived in this repo but have been extracted or removed; suppresses undeclared-tag-prefix warnings                                                                                                                                                                      |
-| `project`           | `ProjectConfig`                             | Opt-in project-level release block. Declaring `project: {}` (even empty) enables a project-release stage in `prepare`                                                                                                                                                                    |
-| `repoLabels`        | `RepoLabelsConfig`                          | Declares the repository's label registry for `sync-labels`; see [Label configuration](labels.md#label-configuration)                                                                                                                                                                     |
-| `changelogJson`     | `ChangelogJsonConfig`                       | Controls `.meta/changelog.json`: `enabled` (default `true`), `outputPath` (default `'.meta/changelog.json'`), and `devOnlySections`; see [Custom work types](work-types.md#custom-work-types)                                                                                            |
-| `changelogMarkdown` | `ChangelogMarkdownConfig`                   | `keepVersions` (an integer, at least 1) bounds `CHANGELOG.md` to that many of the newest versions and moves the rest into per-major archive files; omitted, `CHANGELOG.md` renders every version. See [Archived versions](changelogs.md#archived-versions)                               |
-| `releaseNotes`      | `ReleaseNotesConfig`                        | `shouldInjectIntoReadme` (default `false`) injects release notes into each package's README while it publishes; see [Release-notes injection](changelogs.md#release-notes-injection)                                                                                                     |
+| Field                 | Type                                        | Description                                                                                                                                                                                                                                                                              |
+| --------------------- | ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `releases`            | `Record<string, ReleaseEntry>`              | Names, excludes, or composes release targets; see [`releases`](#releases). Can't be combined with `workspaces` or `project`                                                                                                                                                              |
+| `workspaces`          | `WorkspaceOverride[]`                       | Override or exclude discovered workspaces (matched by `dir`)                                                                                                                                                                                                                             |
+| `devExportConditions` | `string[]`                                  | Export conditions that resolve only inside the repo, such as one that points at unpublished source; the [tarball check](releasing.md#packages-whose-tarball-would-lack-a-manifest-file) does not require their targets in the tarball. `source` is exempt without being listed           |
+| `formatCommand`       | `string`                                    | Shell command to run after changelog generation; modified file paths are appended as arguments                                                                                                                                                                                           |
+| `versionPatterns`     | `VersionPatterns`                           | Rules for which commit types trigger major/minor bumps                                                                                                                                                                                                                                   |
+| `scopeAliases`        | `Record<string, string>`                    | Maps shorthand scope names to canonical names in commit titles and in change-record entry `scopes`, which [route items to workspaces](changelogs.md#routing-to-workspaces). A renamed workspace directory or [release target](#releases) needs an entry from its old name to its new one |
+| `workTypes`           | `Record<string, WorkTypeConfig>`            | Work type definitions, merged with defaults by key                                                                                                                                                                                                                                       |
+| `breakingPolicies`    | `Record<string, 'forbidden' \| 'optional'>` | Per-type `!`-policy lookup. Defaults to `DEFAULT_BREAKING_POLICIES`. Replaces the default entirely when provided. Set to `{}` to disable enforcement                                                                                                                                     |
+| `retiredPackages`     | `RetiredPackage[]`                          | Packages that once lived in this repo but have been extracted or removed; suppresses undeclared-tag-prefix warnings                                                                                                                                                                      |
+| `project`             | `ProjectConfig`                             | Opt-in project-level release block. Declaring `project: {}` (even empty) enables a project-release stage in `prepare`                                                                                                                                                                    |
+| `repoLabels`          | `RepoLabelsConfig`                          | Declares the repository's label registry for `sync-labels`; see [Label configuration](labels.md#label-configuration)                                                                                                                                                                     |
+| `changelogJson`       | `ChangelogJsonConfig`                       | Controls `.meta/changelog.json`: `enabled` (default `true`), `outputPath` (default `'.meta/changelog.json'`), and `devOnlySections`; see [Custom work types](work-types.md#custom-work-types)                                                                                            |
+| `changelogMarkdown`   | `ChangelogMarkdownConfig`                   | `keptVersionCount` (an integer, at least 1) bounds `CHANGELOG.md` to that many of the newest versions and moves the rest into per-major archive files; omitted, `CHANGELOG.md` renders every version. See [Archived versions](changelogs.md#archived-versions)                           |
+| `releaseNotes`        | `ReleaseNotesConfig`                        | `shouldInjectIntoReadme` (default `false`) injects release notes into each package's README while it publishes; see [Release-notes injection](changelogs.md#release-notes-injection)                                                                                                     |
 
 All fields are optional.
 

package/docs/publishing.md

@@ -23,6 +23,10 @@ Example warning when an explicit tag is unpublishable:
 Skipping basic-v1.0.0 (packages/basic): package.json#private is true.
 ```
 
+### Tarball check
+
+Before it publishes any package, and in a dry run as well, `publish` packs every publishable package from a clean checkout of HEAD and refuses when a tarball lacks a file that its manifest names. It is the same check that `prepare` runs; see [Packages whose tarball would lack a manifest file](releasing.md#packages-whose-tarball-would-lack-a-manifest-file).
+
 ## `release-kit create-github-release`
 
 Creates GitHub Releases from `changelog.json` for tags on HEAD. Independent of `npm publish`: Invoking this command creates Releases for publishable packages whether or not they were published to a registry. Private workspaces are skipped, and a project tag gets a Release (see [Publishability filter](#publishability-filter)).

package/docs/releasing.md

@@ -63,6 +63,12 @@ release-kit prepare --bump=minor
 
 Before it writes any file, and in a dry run as well, `prepare` asks npm about each publishable package that the release includes, querying the registry that the package's `publishConfig.registry` names when it sets one. OIDC trusted publishing can't publish a package's first version, so `prepare` refuses to release a package that npm doesn't list, and names each one with its fix: Run `npm publish --access public` from the package's directory once, then register the package as a trusted publisher. The `npm-auto-publish` [readiness kit](readiness-checks.md) prints the `npm trust` command. `prepare` also refuses when it can't look a package up, such as when the registry is unreachable, and reports npm's error for that package.
 
+### Packages whose tarball would lack a manifest file
+
+Before it writes any file, and in a dry run as well, `prepare` packs each publishable package that the release includes as the publish workflow would: It clones HEAD into a temporary directory, runs the package manager's frozen install there, runs the package's `prepublishOnly` script when it declares one, and packs the package. Build output in the working tree therefore does not count, and the check adds the time of one install and one build to every release. `prepare` refuses the release when a tarball lacks a file named by the package's `main`, `types`, `bin`, or `exports`, and names each package with each missing path and the manifest field that names it. The usual fix is to build the files in the package's publish lifecycle, such as in a `prepack` script. A failed install or build in the clean checkout also refuses the release, with the failing step's output.
+
+A target under the `source` export condition is exempt, and so is a target under a condition listed in [`devExportConditions`](configuration.md#releasekitconfig-reference), which declares the conditions that resolve only inside the repo. [`publish`](publishing.md#tarball-check) runs the same check before it publishes any package.
+
 ### Previewing release notes with `--with-release-notes`
 
 `--with-release-notes` writes two versioned files per workspace after each workspace's `changelog.json` is produced:

package/docs/work-types.md

@@ -51,7 +51,7 @@ Each work-type has a `breakingPolicy` value:
 
 A `BREAKING CHANGE:` body footer on a `forbidden`-policy type triggers the same warning path as the prefix `!` does: A type that cannot be breaking is parsed as non-breaking whichever surface has the signal. The warning is all that a footer triggers; it doesn't raise a bump (see [`🚨 **Breaking:**` bullet marker](#-breaking-bullet-marker)).
 
-The release-prepare orchestrator (`releasePrepareTargets`) applies `DEFAULT_BREAKING_POLICIES` automatically. Violations in the titles and change-record entries of each workspace's or project's unreleased window are collected onto the corresponding result's `policyViolations` field, on a skipped result as on a released one, and rendered under the section in the prepare report:
+The release-prepare orchestrator (`prepareReleaseTargets`) applies `DEFAULT_BREAKING_POLICIES` automatically. Violations in the titles and change-record entries of each workspace's or project's unreleased window are collected onto the corresponding result's `policyViolations` field, on a skipped result as on a released one, and rendered under the section in the prepare report:
 
 ```
 arrays

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@williamthorsen/release-kit",
-  "version": "15.0.3",
+  "version": "16.1.0",
   "description": "Version-bumping and changelog-generation toolkit for release workflows",
   "keywords": [
     "changelog",
@@ -63,7 +63,7 @@
     "@types/semver": "7.8.0",
     "@williamthorsen/toolbelt.filesystem": "0.10.0",
     "@williamthorsen/toolbelt.testing": "0.8.0",
-    "@williamthorsen/toolbelt.vitest": "0.13.0",
+    "@williamthorsen/toolbelt.vitest": "0.13.1",
     "actionlint": "2.0.6",
     "esbuild": "0.28.2",
     "readyup": "0.44.0",

package/presets/labels/common.yaml

@@ -9,6 +9,9 @@
 - name: bug
   color: d73a4a
   description: "Something isn't working"
+- name: content
+  color: 0e8a16
+  description: Consumer-facing material, such as copy, images, or displayed data, rather than functionality
 - name: operational
   color: '000000'
   description: Actions outside the codebase