@tallyrelease/core 0.5.0-beta.56 → 0.5.0-beta.60

package/dist/facts.js

@@ -212,7 +212,12 @@ export const rangeFacts = (workspace, git, opts) => {
         const changes = [];
         for (const { plugin, source, ctx: sourceCtx } of intents) {
             // eslint-disable-next-line no-await-in-loop -- hooks run sequentially in config order
-            const collected = await runHook(plugin, "intent", () => source.collect(sourceCtx, { from, to: head, commits }));
+            const collected = await runHook(plugin, "intent", () => source.collect(sourceCtx, {
+                from,
+                to: head,
+                commits,
+                units: workspace.units,
+            }));
             warnUnknown(plugin, collected);
             changes.push(...collected);
         }

package/dist/model/plan-types.d.ts

@@ -16,6 +16,10 @@ export interface PlanChange {
     via?: string;
     /** Release-As value of this commit for the unit. */
     releaseAs?: string;
+    /** Units the change names; set with `files`. */
+    units?: string[];
+    /** Files consumed once every unit named by the changes with them releases. */
+    files?: string[];
 }
 export interface UnitPlan {
     id: string;

package/dist/plan.js

@@ -36,6 +36,9 @@ const planChanges = (intent) => (intent?.changes ?? []).map(({ change, via }) =>
         ...(change.pr === undefined ? {} : { pr: change.pr }),
         ...(via === undefined ? {} : { via }),
         ...(releaseAs === undefined ? {} : { releaseAs }),
+        ...(change.files === undefined
+            ? {}
+            : { units: [...(change.units ?? [])], files: [...change.files] }),
     };
 });
 /**

package/dist/plugin.d.ts

@@ -191,6 +191,8 @@ export interface IntentSource<O = unknown> {
         from: string | null;
         to: string;
         commits: readonly RawCommit[];
+        /** All units of the workspace. */
+        units: readonly Unit[];
     }) => MaybePromise<Change[]>;
 }
 /** A `Release-As` value; `unit` is set by the qualified form `<unit>@<version>`. */
@@ -213,6 +215,11 @@ export interface Change {
     releaseAs?: ReleaseAsValue[];
     pr?: number;
     date?: string;
+    /**
+     * Files consumed when the change is released: deleted in the release
+     * commit that releases every unit named by the changes with the file.
+     */
+    files?: string[];
 }
 /** Throws `E_PLUGIN_API` or `E_PLUGIN_NAME` for an unsupported plugin. */
 export declare const assertPlugin: (plugin: {

package/dist/version-files.d.ts

@@ -15,7 +15,8 @@ export declare const versionFileClaims: (workspace: Workspace) => Promise<Readon
  * Files of a release of `items` (stable `next`): plugin version files,
  * templates, markers and `<root>/CHANGELOG.md` per unit, read through `fs`; the
  * owning plugin's `changelog` hook may replace a unit's section. Returns
- * only files whose content changes, and each unit's changelog section;
+ * only files whose content changes, the consumed files of changes whose
+ * named units all release in `items`, and each unit's changelog section;
  * checks claims first. Templates skip first releases and warn
  * `W_VERSION_FILE_NO_MATCH` without any match, markers warn
  * `W_MARKER_NO_MATCH`; a missing version file is
@@ -30,6 +31,8 @@ export declare const releaseFiles: (workspace: Workspace, plan: Plan, opts: {
     date: string;
 }) => Promise<{
     files: Map<string, string>;
+    /** Files consumed by released changes, deleted by the release. */
+    deletes: Set<string>;
     /** Changelog section of each unit, by unit id. */
     sections: Map<string, string>;
     warnings: Warning[];

package/dist/version-files.js

@@ -259,6 +259,24 @@ const changelogStep = async (staged, step) => {
     }
     return section;
 };
+/**
+ * Readable files of the plan's changes where every unit named by a change
+ * with the file is in `released`; `written` files are kept.
+ */
+const consumedFiles = (plan, released, { fs, written }) => {
+    const named = new Map();
+    for (const { files = [], units = [] } of plan.units.flatMap((u) => u.changes)) {
+        for (const path of files) {
+            named.set(path, [...(named.get(path) ?? []), ...units]);
+        }
+    }
+    return new Set([...named]
+        .filter(([path, units]) => units.length > 0 &&
+        units.every((id) => released.has(id)) &&
+        !written.has(path) &&
+        fs.read(path) !== undefined)
+        .map(([path]) => path));
+};
 /** Checks template files and patterns (`E_CONFIG`); runs no plugin hook. */
 export const validateTemplates = (workspace) => {
     for (const [id, templates] of workspace.release.templates) {
@@ -310,7 +328,8 @@ export const versionFileClaims = async (workspace) => {
  * Files of a release of `items` (stable `next`): plugin version files,
  * templates, markers and `<root>/CHANGELOG.md` per unit, read through `fs`; the
  * owning plugin's `changelog` hook may replace a unit's section. Returns
- * only files whose content changes, and each unit's changelog section;
+ * only files whose content changes, the consumed files of changes whose
+ * named units all release in `items`, and each unit's changelog section;
  * checks claims first. Templates skip first releases and warn
  * `W_VERSION_FILE_NO_MATCH` without any match, markers warn
  * `W_MARKER_NO_MATCH`; a missing version file is
@@ -371,6 +390,10 @@ export const releaseFiles = async (workspace, plan, opts) => {
     }
     return {
         files: new Map([...files].filter(([path, c]) => fs.read(path) !== c)),
+        deletes: consumedFiles(plan, new Set(versions.keys()), {
+            fs,
+            written: files,
+        }),
         sections,
         warnings,
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tallyrelease/core",
-  "version": "0.5.0-beta.56",
+  "version": "0.5.0-beta.60",
   "description": "Pure planning core of tallyrelease",
   "repository": {
     "type": "git",