@savvy-web/silk 1.3.10 → 1.3.11

package/packages/silk-effects/dist/dev/pkg/changesets/remark/plugins/maintenance-note.cjs

@@ -0,0 +1,61 @@
+const require_version_blocks = require('../../utils/version-blocks.cjs');
+
+//#region ../silk-effects/dist/dev/pkg/changesets/remark/plugins/maintenance-note.js
+function buildNoteChildren(reason) {
+	if (reason.kind === "unspecified" || reason.triggers.length === 0) return [{
+		type: "text",
+		value: "Version-only release to keep workspace versions consistent; no changes to this package."
+	}];
+	const label = reason.kind === "fixed" ? "fixed version group" : "linked version group";
+	const children = [{
+		type: "text",
+		value: "Released in lockstep with "
+	}];
+	reason.triggers.forEach((trigger, index) => {
+		if (index > 0) children.push({
+			type: "text",
+			value: ", "
+		});
+		children.push({
+			type: "inlineCode",
+			value: `${trigger.name}@${trigger.version}`
+		});
+	});
+	children.push({
+		type: "text",
+		value: ` (${label}).`
+	});
+	return children;
+}
+const MaintenanceNotePlugin = (options) => {
+	return (tree) => {
+		const block = require_version_blocks.getVersionBlocks(tree).find((b) => require_version_blocks.getHeadingText(tree.children[b.headingIndex]) === options.version);
+		if (!block) return;
+		if (block.endIndex > block.startIndex) return;
+		const heading = {
+			type: "heading",
+			depth: 3,
+			children: [{
+				type: "text",
+				value: "Maintenance"
+			}]
+		};
+		const list = {
+			type: "list",
+			ordered: false,
+			spread: false,
+			children: [{
+				type: "listItem",
+				spread: false,
+				children: [{
+					type: "paragraph",
+					children: buildNoteChildren(options.reason)
+				}]
+			}]
+		};
+		tree.children.splice(block.startIndex, 0, heading, list);
+	};
+};
+
+//#endregion
+exports.MaintenanceNotePlugin = MaintenanceNotePlugin;

package/packages/silk-effects/dist/dev/pkg/changesets/remark/plugins/maintenance-note.js

@@ -0,0 +1,61 @@
+import { getHeadingText, getVersionBlocks } from "../../utils/version-blocks.js";
+
+//#region ../silk-effects/dist/dev/pkg/changesets/remark/plugins/maintenance-note.js
+function buildNoteChildren(reason) {
+	if (reason.kind === "unspecified" || reason.triggers.length === 0) return [{
+		type: "text",
+		value: "Version-only release to keep workspace versions consistent; no changes to this package."
+	}];
+	const label = reason.kind === "fixed" ? "fixed version group" : "linked version group";
+	const children = [{
+		type: "text",
+		value: "Released in lockstep with "
+	}];
+	reason.triggers.forEach((trigger, index) => {
+		if (index > 0) children.push({
+			type: "text",
+			value: ", "
+		});
+		children.push({
+			type: "inlineCode",
+			value: `${trigger.name}@${trigger.version}`
+		});
+	});
+	children.push({
+		type: "text",
+		value: ` (${label}).`
+	});
+	return children;
+}
+const MaintenanceNotePlugin = (options) => {
+	return (tree) => {
+		const block = getVersionBlocks(tree).find((b) => getHeadingText(tree.children[b.headingIndex]) === options.version);
+		if (!block) return;
+		if (block.endIndex > block.startIndex) return;
+		const heading = {
+			type: "heading",
+			depth: 3,
+			children: [{
+				type: "text",
+				value: "Maintenance"
+			}]
+		};
+		const list = {
+			type: "list",
+			ordered: false,
+			spread: false,
+			children: [{
+				type: "listItem",
+				spread: false,
+				children: [{
+					type: "paragraph",
+					children: buildNoteChildren(options.reason)
+				}]
+			}]
+		};
+		tree.children.splice(block.startIndex, 0, heading, list);
+	};
+};
+
+//#endregion
+export { MaintenanceNotePlugin };

package/packages/silk-effects/dist/dev/pkg/changesets/remark/presets.cjs

@@ -3,13 +3,13 @@ const require_dependency_table_format = require('./rules/dependency-table-format
 const require_heading_hierarchy = require('./rules/heading-hierarchy.cjs');
 const require_required_sections = require('./rules/required-sections.cjs');
 const require_uncategorized_content = require('./rules/uncategorized-content.cjs');
+const require_aggregate_dependency_tables = require('./plugins/aggregate-dependency-tables.cjs');
 const require_contributor_footnotes = require('./plugins/contributor-footnotes.cjs');
 const require_deduplicate_items = require('./plugins/deduplicate-items.cjs');
 const require_issue_link_refs = require('./plugins/issue-link-refs.cjs');
 const require_merge_sections = require('./plugins/merge-sections.cjs');
 const require_normalize_format = require('./plugins/normalize-format.cjs');
 const require_reorder_sections = require('./plugins/reorder-sections.cjs');
-const require_aggregate_dependency_tables = require('./plugins/aggregate-dependency-tables.cjs');
 
 //#region ../silk-effects/dist/dev/pkg/changesets/remark/presets.js
 /**

package/packages/silk-effects/dist/dev/pkg/changesets/remark/presets.js

@@ -3,13 +3,13 @@ import { DependencyTableFormatRule } from "./rules/dependency-table-format.js";
 import { HeadingHierarchyRule } from "./rules/heading-hierarchy.js";
 import { RequiredSectionsRule } from "./rules/required-sections.js";
 import { UncategorizedContentRule } from "./rules/uncategorized-content.js";
+import { AggregateDependencyTablesPlugin } from "./plugins/aggregate-dependency-tables.js";
 import { ContributorFootnotesPlugin } from "./plugins/contributor-footnotes.js";
 import { DeduplicateItemsPlugin } from "./plugins/deduplicate-items.js";
 import { IssueLinkRefsPlugin } from "./plugins/issue-link-refs.js";
 import { MergeSectionsPlugin } from "./plugins/merge-sections.js";
 import { NormalizeFormatPlugin } from "./plugins/normalize-format.js";
 import { ReorderSectionsPlugin } from "./plugins/reorder-sections.js";
-import { AggregateDependencyTablesPlugin } from "./plugins/aggregate-dependency-tables.js";
 
 //#region ../silk-effects/dist/dev/pkg/changesets/remark/presets.js
 /**

package/packages/silk-effects/dist/dev/pkg/changesets/services/maintenance-reason.cjs

@@ -0,0 +1,68 @@
+const require_ChangesetConfig = require('../../services/ChangesetConfig.cjs');
+let effect = require("effect");
+
+//#region ../silk-effects/dist/dev/pkg/changesets/services/maintenance-reason.js
+/**
+* A group co-member whose own changesets forced this release.
+*
+* @public
+*/
+const MaintenanceTriggerSchema = effect.Schema.Struct({
+	/** Package name of the triggering co-member. */
+	name: effect.Schema.String,
+	/** The co-member's new version in the same release plan. */
+	version: effect.Schema.String
+});
+/**
+* Why a package is releasing with no changesets of its own.
+*
+* @public
+*/
+const MaintenanceReasonSchema = effect.Schema.Struct({
+	/** Coupling that forced the release; `"unspecified"` when undetermined. */
+	kind: effect.Schema.Literal("fixed", "linked", "unspecified"),
+	/** Triggering co-members; empty for `"unspecified"`. */
+	triggers: effect.Schema.Array(MaintenanceTriggerSchema)
+});
+/**
+* Derive the {@link MaintenanceReason} for a release, or `undefined` when the
+* release has its own changesets (not a maintenance release).
+*
+* @param release - The release to classify.
+* @param plan - The full release plan (source of group co-members).
+* @param config - Resolved changesets config (`fixed` / `linked` groups).
+* @returns The reason, or `undefined` for releases with their own changesets.
+*
+* @remarks
+* Group entries are matched with {@link ChangesetConfig.matches} — exact names
+* and trailing `"@scope/*"` prefixes only, a subset of the micromatch globs
+* changesets accepts. A group entry using richer glob syntax (e.g. `"pkg-*"`)
+* will not match here; the release then degrades gracefully to the
+* `"unspecified"` fallback sentence instead of naming its triggers.
+*
+* @public
+*/
+function deriveMaintenanceReason(release, plan, config) {
+	if (release.changesets.length > 0) return void 0;
+	const groupKinds = [["fixed", config.fixed], ["linked", config.linked]];
+	for (const [kind, groups] of groupKinds) for (const group of groups) {
+		if (!group.some((pattern) => require_ChangesetConfig.ChangesetConfig.matches(release.name, pattern))) continue;
+		const triggers = plan.releases.filter((r) => r.name !== release.name && r.changesets.length > 0 && group.some((pattern) => require_ChangesetConfig.ChangesetConfig.matches(r.name, pattern))).map((r) => ({
+			name: r.name,
+			version: r.newVersion
+		}));
+		if (triggers.length > 0) return {
+			kind,
+			triggers
+		};
+	}
+	return {
+		kind: "unspecified",
+		triggers: []
+	};
+}
+
+//#endregion
+exports.MaintenanceReasonSchema = MaintenanceReasonSchema;
+exports.MaintenanceTriggerSchema = MaintenanceTriggerSchema;
+exports.deriveMaintenanceReason = deriveMaintenanceReason;

package/packages/silk-effects/dist/dev/pkg/changesets/services/maintenance-reason.js

@@ -0,0 +1,66 @@
+import { ChangesetConfig } from "../../services/ChangesetConfig.js";
+import { Schema } from "effect";
+
+//#region ../silk-effects/dist/dev/pkg/changesets/services/maintenance-reason.js
+/**
+* A group co-member whose own changesets forced this release.
+*
+* @public
+*/
+const MaintenanceTriggerSchema = Schema.Struct({
+	/** Package name of the triggering co-member. */
+	name: Schema.String,
+	/** The co-member's new version in the same release plan. */
+	version: Schema.String
+});
+/**
+* Why a package is releasing with no changesets of its own.
+*
+* @public
+*/
+const MaintenanceReasonSchema = Schema.Struct({
+	/** Coupling that forced the release; `"unspecified"` when undetermined. */
+	kind: Schema.Literal("fixed", "linked", "unspecified"),
+	/** Triggering co-members; empty for `"unspecified"`. */
+	triggers: Schema.Array(MaintenanceTriggerSchema)
+});
+/**
+* Derive the {@link MaintenanceReason} for a release, or `undefined` when the
+* release has its own changesets (not a maintenance release).
+*
+* @param release - The release to classify.
+* @param plan - The full release plan (source of group co-members).
+* @param config - Resolved changesets config (`fixed` / `linked` groups).
+* @returns The reason, or `undefined` for releases with their own changesets.
+*
+* @remarks
+* Group entries are matched with {@link ChangesetConfig.matches} — exact names
+* and trailing `"@scope/*"` prefixes only, a subset of the micromatch globs
+* changesets accepts. A group entry using richer glob syntax (e.g. `"pkg-*"`)
+* will not match here; the release then degrades gracefully to the
+* `"unspecified"` fallback sentence instead of naming its triggers.
+*
+* @public
+*/
+function deriveMaintenanceReason(release, plan, config) {
+	if (release.changesets.length > 0) return void 0;
+	const groupKinds = [["fixed", config.fixed], ["linked", config.linked]];
+	for (const [kind, groups] of groupKinds) for (const group of groups) {
+		if (!group.some((pattern) => ChangesetConfig.matches(release.name, pattern))) continue;
+		const triggers = plan.releases.filter((r) => r.name !== release.name && r.changesets.length > 0 && group.some((pattern) => ChangesetConfig.matches(r.name, pattern))).map((r) => ({
+			name: r.name,
+			version: r.newVersion
+		}));
+		if (triggers.length > 0) return {
+			kind,
+			triggers
+		};
+	}
+	return {
+		kind: "unspecified",
+		triggers: []
+	};
+}
+
+//#endregion
+export { MaintenanceReasonSchema, MaintenanceTriggerSchema, deriveMaintenanceReason };

package/packages/silk-effects/dist/dev/pkg/changesets/services/release-planner.cjs

@@ -1,6 +1,7 @@
 const require_errors = require('../errors.cjs');
 const require_transformer = require('../api/transformer.cjs');
 const require_config_inspector = require('./config-inspector.cjs');
+const require_maintenance_reason = require('./maintenance-reason.cjs');
 const require_version_files = require('../utils/version-files.cjs');
 const require_changesets_config_esm = require('../../../../../../../node_modules/.pnpm/@changesets_config@3.1.4/node_modules/@changesets/config/dist/changesets-config.esm.cjs');
 const require_changesets_apply_release_plan_esm = require('../../../../../../../node_modules/.pnpm/@changesets_apply-release-plan@7.1.1/node_modules/@changesets/apply-release-plan/dist/changesets-apply-release-plan.esm.cjs');
@@ -113,6 +114,16 @@ function extractVersionBlock(changelog, version) {
 	}
 	return lines.slice(start, end).join("\n").trim();
 }
+/** Maintenance reasons for every changeset-less release in the plan, keyed by package name. */
+function maintenanceReasons(plan, config) {
+	const reasons = /* @__PURE__ */ new Map();
+	for (const r of plan.releases) {
+		if (r.type === "none") continue;
+		const reason = require_maintenance_reason.deriveMaintenanceReason(r, plan, config);
+		if (reason) reasons.set(r.name, reason);
+	}
+	return reasons;
+}
 /**
 * Render a non-destructive preview by redirecting every write into a
 * scope-managed temp directory (cleaned up automatically when the scope
@@ -134,6 +145,7 @@ function previewEffect(root, fs) {
 				reason: errMsg(e)
 			})
 		});
+		const reasonByName = maintenanceReasons(plan, config);
 		const preMode = plan.preState ? plan.preState.mode : null;
 		const changesets = plan.changesets.map((cs) => ({
 			id: cs.id,
@@ -202,8 +214,12 @@ function previewEffect(root, fs) {
 			if (!dir) continue;
 			const clPath = (0, node_path.join)(dir, "CHANGELOG.md");
 			if (!(yield* fs.exists(clPath))) continue;
+			const reason = reasonByName.get(r.name);
 			yield* effect.Effect.try({
-				try: () => require_transformer.ChangelogTransformer.transformFile(clPath),
+				try: () => require_transformer.ChangelogTransformer.transformFile(clPath, reason ? { maintenance: {
+					version: r.newVersion,
+					reason
+				} } : void 0),
 				catch: (e) => new require_errors.ReleasePlanError({
 					phase: "preview",
 					reason: errMsg(e)
@@ -257,17 +273,33 @@ function applyEffect(root, dryRun, inspector, fs) {
 			newVersion: r.newVersion
 		}));
 		let touchedFiles = [];
-		if (!dryRun) touchedFiles = yield* effect.Effect.tryPromise({
-			try: async () => {
-				const touched = await require_changesets_apply_release_plan_esm.default(plan, packages, config);
-				for (const f of touched) if (f.endsWith("CHANGELOG.md")) require_transformer.ChangelogTransformer.transformFile(f);
-				return touched;
-			},
-			catch: (e) => new require_errors.ReleasePlanError({
-				phase: "apply",
-				reason: errMsg(e)
-			})
-		});
+		if (!dryRun) {
+			const reasonByName = maintenanceReasons(plan, config);
+			const versionByPkgName = new Map(plan.releases.map((r) => [r.name, r.newVersion]));
+			const nameByDir = /* @__PURE__ */ new Map();
+			for (const p of packages.packages) nameByDir.set(p.dir, p.packageJson.name);
+			if (packages.root.packageJson.name) nameByDir.set(packages.root.dir, packages.root.packageJson.name);
+			touchedFiles = yield* effect.Effect.tryPromise({
+				try: async () => {
+					const touched = await require_changesets_apply_release_plan_esm.default(plan, packages, config);
+					for (const f of touched) {
+						if (!f.endsWith("CHANGELOG.md")) continue;
+						const pkgName = nameByDir.get((0, node_path.dirname)(f));
+						const reason = pkgName ? reasonByName.get(pkgName) : void 0;
+						const newVersion = pkgName ? versionByPkgName.get(pkgName) : void 0;
+						require_transformer.ChangelogTransformer.transformFile(f, reason && newVersion ? { maintenance: {
+							version: newVersion,
+							reason
+						} } : void 0);
+					}
+					return touched;
+				},
+				catch: (e) => new require_errors.ReleasePlanError({
+					phase: "apply",
+					reason: errMsg(e)
+				})
+			});
+		}
 		const newVersionByName = new Map(plan.releases.map((r) => [r.name, r.newVersion]));
 		const inspected = yield* inspector.inspect(root).pipe(effect.Effect.catchAll((error) => effect.Effect.logWarning(`Skipping versionFiles update: ${errMsg(error)}`).pipe(effect.Effect.as(null))));
 		let versionFileUpdates = [];

package/packages/silk-effects/dist/dev/pkg/changesets/services/release-planner.js

@@ -1,6 +1,7 @@
 import { ReleasePlanError } from "../errors.js";
 import { ChangelogTransformer } from "../api/transformer.js";
 import { ConfigInspector } from "./config-inspector.js";
+import { deriveMaintenanceReason } from "./maintenance-reason.js";
 import { VersionFiles } from "../utils/version-files.js";
 import { read } from "../../../../../../../node_modules/.pnpm/@changesets_config@3.1.4/node_modules/@changesets/config/dist/changesets-config.esm.js";
 import applyReleasePlan from "../../../../../../../node_modules/.pnpm/@changesets_apply-release-plan@7.1.1/node_modules/@changesets/apply-release-plan/dist/changesets-apply-release-plan.esm.js";
@@ -8,7 +9,7 @@ import getReleasePlan from "../../../../../../../node_modules/.pnpm/@changesets_
 import { getPackages } from "../../../../../../../node_modules/.pnpm/@manypkg_get-packages@3.1.0/node_modules/@manypkg/get-packages/dist/manypkg-get-packages.js";
 import { Context, Effect, Layer } from "effect";
 import { FileSystem } from "@effect/platform";
-import { isAbsolute, join, relative } from "node:path";
+import { dirname, isAbsolute, join, relative } from "node:path";
 
 //#region ../silk-effects/dist/dev/pkg/changesets/services/release-planner.js
 /**
@@ -113,6 +114,16 @@ function extractVersionBlock(changelog, version) {
 	}
 	return lines.slice(start, end).join("\n").trim();
 }
+/** Maintenance reasons for every changeset-less release in the plan, keyed by package name. */
+function maintenanceReasons(plan, config) {
+	const reasons = /* @__PURE__ */ new Map();
+	for (const r of plan.releases) {
+		if (r.type === "none") continue;
+		const reason = deriveMaintenanceReason(r, plan, config);
+		if (reason) reasons.set(r.name, reason);
+	}
+	return reasons;
+}
 /**
 * Render a non-destructive preview by redirecting every write into a
 * scope-managed temp directory (cleaned up automatically when the scope
@@ -134,6 +145,7 @@ function previewEffect(root, fs) {
 				reason: errMsg(e)
 			})
 		});
+		const reasonByName = maintenanceReasons(plan, config);
 		const preMode = plan.preState ? plan.preState.mode : null;
 		const changesets = plan.changesets.map((cs) => ({
 			id: cs.id,
@@ -202,8 +214,12 @@ function previewEffect(root, fs) {
 			if (!dir) continue;
 			const clPath = join(dir, "CHANGELOG.md");
 			if (!(yield* fs.exists(clPath))) continue;
+			const reason = reasonByName.get(r.name);
 			yield* Effect.try({
-				try: () => ChangelogTransformer.transformFile(clPath),
+				try: () => ChangelogTransformer.transformFile(clPath, reason ? { maintenance: {
+					version: r.newVersion,
+					reason
+				} } : void 0),
 				catch: (e) => new ReleasePlanError({
 					phase: "preview",
 					reason: errMsg(e)
@@ -257,17 +273,33 @@ function applyEffect(root, dryRun, inspector, fs) {
 			newVersion: r.newVersion
 		}));
 		let touchedFiles = [];
-		if (!dryRun) touchedFiles = yield* Effect.tryPromise({
-			try: async () => {
-				const touched = await applyReleasePlan(plan, packages, config);
-				for (const f of touched) if (f.endsWith("CHANGELOG.md")) ChangelogTransformer.transformFile(f);
-				return touched;
-			},
-			catch: (e) => new ReleasePlanError({
-				phase: "apply",
-				reason: errMsg(e)
-			})
-		});
+		if (!dryRun) {
+			const reasonByName = maintenanceReasons(plan, config);
+			const versionByPkgName = new Map(plan.releases.map((r) => [r.name, r.newVersion]));
+			const nameByDir = /* @__PURE__ */ new Map();
+			for (const p of packages.packages) nameByDir.set(p.dir, p.packageJson.name);
+			if (packages.root.packageJson.name) nameByDir.set(packages.root.dir, packages.root.packageJson.name);
+			touchedFiles = yield* Effect.tryPromise({
+				try: async () => {
+					const touched = await applyReleasePlan(plan, packages, config);
+					for (const f of touched) {
+						if (!f.endsWith("CHANGELOG.md")) continue;
+						const pkgName = nameByDir.get(dirname(f));
+						const reason = pkgName ? reasonByName.get(pkgName) : void 0;
+						const newVersion = pkgName ? versionByPkgName.get(pkgName) : void 0;
+						ChangelogTransformer.transformFile(f, reason && newVersion ? { maintenance: {
+							version: newVersion,
+							reason
+						} } : void 0);
+					}
+					return touched;
+				},
+				catch: (e) => new ReleasePlanError({
+					phase: "apply",
+					reason: errMsg(e)
+				})
+			});
+		}
 		const newVersionByName = new Map(plan.releases.map((r) => [r.name, r.newVersion]));
 		const inspected = yield* inspector.inspect(root).pipe(Effect.catchAll((error) => Effect.logWarning(`Skipping versionFiles update: ${errMsg(error)}`).pipe(Effect.as(null))));
 		let versionFileUpdates = [];