@savvy-web/silk-effects 2.0.2 → 2.1.0

package/changesets/api/transformer.js

@@ -1,9 +1,5 @@
-import { ContributorFootnotesPlugin } from "../remark/plugins/contributor-footnotes.js";
-import { DeduplicateItemsPlugin } from "../remark/plugins/deduplicate-items.js";
-import { IssueLinkRefsPlugin } from "../remark/plugins/issue-link-refs.js";
-import { MergeSectionsPlugin } from "../remark/plugins/merge-sections.js";
-import { NormalizeFormatPlugin } from "../remark/plugins/normalize-format.js";
-import { ReorderSectionsPlugin } from "../remark/plugins/reorder-sections.js";
+import { MaintenanceNotePlugin } from "../remark/plugins/maintenance-note.js";
+import { SilkChangesetTransformPreset } from "../remark/presets.js";
 import remarkGfm from "remark-gfm";
 import remarkParse from "remark-parse";
 import remarkStringify from "remark-stringify";
@@ -24,23 +20,13 @@ import { readFileSync, writeFileSync } from "node:fs";
 * Static class for post-processing CHANGELOG.md files.
 *
 * Implements the third layer of the three-layer pipeline by running
-* six remark transform plugins in a fixed order to clean up, normalize,
-* and enhance changelog output produced by the formatter layer.
+* the {@link SilkChangesetTransformPreset} plugins (currently seven) in a
+* fixed order to clean up, normalize, and enhance changelog output produced
+* by the formatter layer.
 *
 * @remarks
-* The six plugins run in this order:
-*
-* 1. **MergeSectionsPlugin** -- merges duplicate section headings (e.g., two
-*    "Features" sections from separate changesets are combined into one)
-* 2. **ReorderSectionsPlugin** -- reorders sections by category priority
-*    (Breaking Changes first, Other last) using the {@link Categories} priority values
-* 3. **DeduplicateItemsPlugin** -- removes duplicate list items within a section
-* 4. **ContributorFootnotesPlugin** -- converts inline contributor mentions
-*    into footnote references for cleaner formatting
-* 5. **IssueLinkRefsPlugin** -- converts inline issue/PR links into markdown
-*    reference-style links collected at the bottom of the document
-* 6. **NormalizeFormatPlugin** -- applies consistent formatting (spacing,
-*    trailing newlines, heading levels)
+* See {@link SilkChangesetTransformPreset} for the ordered plugin list and
+* the rationale behind each plugin's position.
 *
 * The transformer operates on the full CHANGELOG.md content (all versions),
 * not just the latest release block. It is idempotent -- running it multiple
@@ -100,20 +86,27 @@ var ChangelogTransformer = class ChangelogTransformer {
 	/* v8 ignore next -- private constructor prevents direct instantiation */
 	constructor() {}
 	/**
-	* Transform CHANGELOG markdown content by running all six transform plugins.
+	* Transform CHANGELOG markdown content by running the
+	* {@link SilkChangesetTransformPreset} plugins.
 	*
 	* @remarks
 	* The input is parsed with `remark-parse` and `remark-gfm` (for table
-	* support), processed through all six plugins in order, and stringified
-	* back to markdown. The operation is synchronous and idempotent.
+	* support), processed through every plugin in {@link SilkChangesetTransformPreset}
+	* in order, and stringified back to markdown. The operation is synchronous
+	* and idempotent.
 	*
 	* @param content - Raw CHANGELOG markdown string (may contain multiple
 	*   version blocks, GFM tables, footnotes, and reference links)
-	* @returns The transformed markdown string with sections merged, reordered,
-	*   deduplicated, and normalized
+	* @param options - Optional transformation options, including maintenance note configuration
+	* @returns The transformed markdown string with dependency tables aggregated,
+	*   sections merged, reordered, deduplicated, and normalized
 	*/
-	static transformContent(content) {
-		const file = unified().use(remarkParse).use(remarkGfm).use(MergeSectionsPlugin).use(ReorderSectionsPlugin).use(DeduplicateItemsPlugin).use(ContributorFootnotesPlugin).use(IssueLinkRefsPlugin).use(NormalizeFormatPlugin).use(remarkStringify).processSync(content);
+	static transformContent(content, options) {
+		const processor = unified().use(remarkParse).use(remarkGfm);
+		for (const plugin of SilkChangesetTransformPreset) processor.use(plugin);
+		if (options?.maintenance) processor.use(MaintenanceNotePlugin, options.maintenance);
+		processor.use(remarkStringify);
+		const file = processor.processSync(content);
 		return String(file);
 	}
 	/**
@@ -129,10 +122,11 @@ var ChangelogTransformer = class ChangelogTransformer {
 	* when invoked without the `--dry-run` or `--check` flags.
 	*
 	* @param filePath - Absolute or relative path to the CHANGELOG.md file
+	* @param options - Optional transformation options, including maintenance note configuration
 	*/
-	static transformFile(filePath) {
+	static transformFile(filePath, options) {
 		const content = readFileSync(filePath, "utf-8");
-		writeFileSync(filePath, ChangelogTransformer.transformContent(content), "utf-8");
+		writeFileSync(filePath, ChangelogTransformer.transformContent(content, options), "utf-8");
 	}
 };
 

package/changesets/changelog/formatting.js

@@ -26,8 +26,8 @@ const ISSUE_CATEGORIES = [
 /**
 * Format a changelog entry into a markdown string with GitHub links.
 *
-* Produces a commit-link prefix (shortened to 7 characters) followed by the
-* summary text and any issue references, each rendered as GitHub links.
+* Produces the summary text followed by any issue references, each
+* rendered as GitHub links.
 *
 * @remarks
 * The output does **not** include a leading `- ` list marker — the caller
@@ -37,13 +37,11 @@ const ISSUE_CATEGORIES = [
 *
 * Output format examples:
 *
-* With commit: `[short-hash](commit-url) Summary text`
+* Without issues: `Summary text`
 *
 * With issues: `Summary text` followed by `Closes: [#1](issue-url)`
 *
-* With both: `[short-hash](commit-url) Summary text` followed by `Fixes: [#2](issue-url)`
-*
-* @param entry - The changelog entry containing commit, summary, and issue data
+* @param entry - The changelog entry containing summary and issue data
 * @param options - Must include `repo` in `owner/repo` format for link generation
 * @returns Formatted markdown string (without leading `- `)
 *
@@ -51,10 +49,6 @@ const ISSUE_CATEGORIES = [
 */
 function formatChangelogEntry(entry, options) {
 	const parts = [];
-	if (entry.commit) {
-		const shortHash = entry.commit.substring(0, 7);
-		parts.push(`[\`${shortHash}\`](https://github.com/${options.repo}/commit/${entry.commit})`);
-	}
 	parts.push(entry.summary.trim());
 	const issueLinks = [];
 	for (const { key, label } of ISSUE_CATEGORIES) {

package/changesets/changelog/getDependencyReleaseLine.js

@@ -15,11 +15,14 @@ import { Effect } from "effect";
 * handles the "Updated dependencies" section that Changesets appends
 * when a package's dependencies are bumped as part of a release.
 *
-* The output is a GFM (GitHub Flavored Markdown) table with columns:
-* `Dependency`, `Type`, `Action`, `From`, `To`. The dependency type
-* is inferred from the consuming package's `package.json` fields
-* (`dependencies`, `devDependencies`, `peerDependencies`,
-* `optionalDependencies`) via the {@link inferDependencyType} helper.
+* The output is a `### Dependencies` h3 heading followed by a GFM
+* (GitHub Flavored Markdown) table with columns: `Dependency`, `Type`,
+* `Action`, `From`, `To`. The dependency type is inferred from the
+* consuming package's `package.json` fields (`dependencies`,
+* `devDependencies`, `peerDependencies`, `optionalDependencies`) via
+* the {@link inferDependencyType} helper. Downstream, the heading is
+* consumed by `AggregateDependencyTablesPlugin`, which locates and
+* merges per-package dependency tables during changelog assembly.
 *
 * ### Dependency type inference
 *
@@ -85,7 +88,8 @@ function inferDependencyType(dep) {
 * The function maps each `ModCompWithPackage` entry to a `DependencyTableRow`,
 * inferring the dependency type from the consuming package's `package.json`,
 * then delegates to `serializeDependencyTableToMarkdown` for GFM table
-* rendering. Returns an empty string when no dependencies were updated.
+* rendering, prefixed with a `### Dependencies` heading. Returns an empty
+* string when no dependencies were updated.
 *
 * The `_changesets` and `_options` parameters are part of the Changesets API
 * contract but are not used in the table format. They are retained for
@@ -94,19 +98,19 @@ function inferDependencyType(dep) {
 * @param _changesets - Changesets that caused the dependency updates (unused in table format)
 * @param dependenciesUpdated - The list of dependencies that were updated, including old/new versions
 * @param _options - Validated configuration options (unused in table format)
-* @returns An `Effect` that resolves to a formatted markdown table string, or empty string if no dependencies were updated
+* @returns An `Effect` that resolves to a `### Dependencies` heading followed by a formatted markdown table string, or empty string if no dependencies were updated
 */
 function getDependencyReleaseLine(_changesets, dependenciesUpdated, _options) {
 	return Effect.gen(function* () {
 		if (dependenciesUpdated.length === 0) return "";
 		yield* GitHubService;
-		return serializeDependencyTableToMarkdown(dependenciesUpdated.map((dep) => ({
+		return `### Dependencies\n\n${serializeDependencyTableToMarkdown(dependenciesUpdated.map((dep) => ({
 			dependency: dep.name,
 			type: inferDependencyType(dep),
 			action: "updated",
 			from: dep.oldVersion,
 			to: dep.newVersion
-		})));
+		})))}`;
 	});
 }
 

package/changesets/changelog/getReleaseLine.js

@@ -21,7 +21,7 @@ import { Effect, Schema } from "effect";
 *
 * 1. **Section-aware changesets** — When the changeset summary contains h2
 *    headings (e.g., `## Features`, `## Bug Fixes`), each section is rendered
-*    as an h3 heading with commit-linked list items beneath it. This mode
+*    as an h3 heading with list items beneath it. This mode
 *    produces multi-line output suitable for rich changelogs.
 *
 * 2. **Flat-text changesets** — When the summary is plain text without section
@@ -31,7 +31,6 @@ import { Effect, Schema } from "effect";
 *
 * In both modes, the formatter:
 * - Fetches GitHub metadata (PR number, author) via {@link GitHubService}
-* - Generates shortened commit hash links (`[abc1234](...)`)
 * - Extracts and renders issue references (Closes, Fixes, Refs)
 * - Appends PR and user attribution when available
 *
@@ -62,7 +61,7 @@ import { Effect, Schema } from "effect";
 *    `Fixes #N`, and `Refs #N` patterns.
 * 5. **Build attribution** — Format PR link and user credit from GitHub info.
 * 6. **Section-aware output** — If sections were found, render each as an
-*    h3 heading with commit-linked list items.
+*    h3 heading with list items.
 * 7. **Flat-text fallback** — Otherwise, produce a single `- entry` line
 *    with the resolved category heading.
 *
@@ -96,14 +95,16 @@ function getReleaseLine(changeset, versionType, options) {
 			for (const section of parsed.sections) {
 				lines.push(`### ${section.category.heading}`);
 				lines.push("");
-				const commitPrefix = changeset.commit ? `[\`${changeset.commit.substring(0, 7)}\`](https://github.com/${options.repo}/commit/${changeset.commit}) ` : "";
 				if (section.content) {
 					const contentLines = section.content.split("\n");
 					const firstContentLine = contentLines[0];
 					if (firstContentLine.startsWith("- ") || firstContentLine.startsWith("* ")) {
-						lines.push(`${firstContentLine.substring(0, 2)}${commitPrefix}${firstContentLine.substring(2)}`);
+						lines.push(firstContentLine);
 						lines.push(...contentLines.slice(1));
-					} else lines.push(`- ${commitPrefix}${section.content}`);
+					} else {
+						lines.push(`- ${firstContentLine}`);
+						lines.push(...contentLines.slice(1).map((line) => line.length > 0 ? `  ${line}` : line));
+					}
 				}
 				lines.push("");
 			}
@@ -112,8 +113,7 @@ function getReleaseLine(changeset, versionType, options) {
 		return `- ${formatChangelogEntry({
 			type: resolveCommitType(commitMsg.type ?? versionType, commitMsg.scope, commitMsg.breaking).heading,
 			summary: changeset.summary,
-			issues: issueRefs,
-			...changeset.commit ? { commit: changeset.commit } : {}
+			issues: issueRefs
 		}, { repo: options.repo })}${attribution}`;
 	});
 }

package/changesets/changelog/index.js

@@ -40,7 +40,7 @@ import { Effect, Layer } from "effect";
 *    config is decoded through `ChangesetOptionsSchema`.
 * 2. **Release line formatting** — each changeset is formatted by
 *    `getReleaseLine`, which resolves GitHub metadata, parses sections,
-*    and produces structured markdown with commit links and attribution.
+*    and produces structured markdown with attribution.
 * 3. **Dependency table formatting** — bulk dependency updates are
 *    formatted by `getDependencyReleaseLine` into a markdown table.
 *

package/changesets/index.js

@@ -19,12 +19,15 @@ import { HeadingHierarchyRule } from "./remark/rules/heading-hierarchy.js";
 import { RequiredSectionsRule } from "./remark/rules/required-sections.js";
 import { UncategorizedContentRule } from "./remark/rules/uncategorized-content.js";
 import { ChangesetLinter } from "./api/linter.js";
+import { MaintenanceNotePlugin } from "./remark/plugins/maintenance-note.js";
+import { AggregateDependencyTablesPlugin } from "./remark/plugins/aggregate-dependency-tables.js";
 import { ContributorFootnotesPlugin } from "./remark/plugins/contributor-footnotes.js";
 import { DeduplicateItemsPlugin } from "./remark/plugins/deduplicate-items.js";
 import { IssueLinkRefsPlugin } from "./remark/plugins/issue-link-refs.js";
 import { MergeSectionsPlugin } from "./remark/plugins/merge-sections.js";
 import { NormalizeFormatPlugin } from "./remark/plugins/normalize-format.js";
 import { ReorderSectionsPlugin } from "./remark/plugins/reorder-sections.js";
+import { SilkChangesetPreset, SilkChangesetTransformPreset } from "./remark/presets.js";
 import { ChangelogTransformer } from "./api/transformer.js";
 import { ClassificationReasonSchema, ClassificationSchema, ConfigInspector, ConfigInspectorBase, ConfigInspectorLive, InspectedConfigSchema, ResolvedPackageScopeSchema, ResolvedVersionFileSchema, makeConfigInspectorTest } from "./services/config-inspector.js";
 import { BranchAnalysisSchema, BranchAnalyzer, BranchAnalyzerBase, BranchAnalyzerLive, BranchFileEntrySchema, FileStatusSchema, makeBranchAnalyzerTest } from "./services/branch-analyzer.js";
@@ -33,6 +36,7 @@ import { computeWorkspaceDependencyDiffs } from "./utils/dep-diff.js";
 import { gitMergeBase } from "./utils/git.js";
 import { listPublishablePackageNames } from "./utils/publishability.js";
 import { DepsRegen, DepsRegenBase, DepsRegenDefault, DepsRegenLive, isPureDependencyChangeset } from "./services/deps-regen.js";
+import { MaintenanceReasonSchema, MaintenanceTriggerSchema, deriveMaintenanceReason } from "./services/maintenance-reason.js";
 import { VersionFiles } from "./utils/version-files.js";
 import { ReleasePlanner, ReleasePlannerBase, ReleasePlannerLive, makeReleasePlannerTest } from "./services/release-planner.js";
 import { SectionCategorySchema } from "./categories/types.js";
@@ -45,8 +49,6 @@ import { HeadingHierarchyRule as HeadingHierarchyRule$1 } from "./markdownlint/r
 import { RequiredSectionsRule as RequiredSectionsRule$1 } from "./markdownlint/rules/required-sections.js";
 import { UncategorizedContentRule as UncategorizedContentRule$1 } from "./markdownlint/rules/uncategorized-content.js";
 import SilkChangesetsRules from "./markdownlint/index.js";
-import { AggregateDependencyTablesPlugin } from "./remark/plugins/aggregate-dependency-tables.js";
-import { SilkChangesetPreset, SilkChangesetTransformPreset } from "./remark/presets.js";
 
 //#region src/changesets/index.ts
 var changesets_exports = /* @__PURE__ */ __exportAll({
@@ -113,6 +115,9 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 	JsonPathSchema: () => JsonPathSchema,
 	LegacyVersionFileConfigSchema: () => LegacyVersionFileConfigSchema,
 	LegacyVersionFilesSchema: () => LegacyVersionFilesSchema,
+	MaintenanceNotePlugin: () => MaintenanceNotePlugin,
+	MaintenanceReasonSchema: () => MaintenanceReasonSchema,
+	MaintenanceTriggerSchema: () => MaintenanceTriggerSchema,
 	MarkdownLive: () => MarkdownLive,
 	MarkdownParseError: () => MarkdownParseError,
 	MarkdownParseErrorBase: () => MarkdownParseErrorBase,
@@ -159,6 +164,7 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 	VersionTypeSchema: () => VersionTypeSchema,
 	changelogFunctions: () => changelogFunctions,
 	computeWorkspaceDependencyDiffs: () => computeWorkspaceDependencyDiffs,
+	deriveMaintenanceReason: () => deriveMaintenanceReason,
 	gitMergeBase: () => gitMergeBase,
 	isPureDependencyChangeset: () => isPureDependencyChangeset,
 	listPublishablePackageNames: () => listPublishablePackageNames,
@@ -170,4 +176,4 @@ var changesets_exports = /* @__PURE__ */ __exportAll({
 });
 
 //#endregion
-export { AggregateDependencyTablesPlugin, AppliedReleaseEntrySchema, AppliedReleaseSchema, BranchAnalysisSchema, BranchAnalyzer, BranchAnalyzerBase, BranchAnalyzerLive, BranchFileEntrySchema, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogServiceBase, ChangelogTransformer, ChangesetIOError, ChangesetIOErrorBase, ChangesetLinter, ChangesetOptionsSchema, ChangesetPreviewSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ChangesetValidationErrorBase, ClassificationReasonSchema, ClassificationSchema, CommitHashSchema, ConfigInspector, ConfigInspectorBase, ConfigInspectorLive, ConfigurationError, ConfigurationErrorBase, ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyActionSchema, DependencyTable, DependencyTableFormatRule, DependencyTableRowSchema, DependencyTableSchema, DependencyTableTypeSchema, DependencyTypeSchema, DependencyUpdateSchema, DepsRegen, DepsRegenBase, DepsRegenDefault, DepsRegenLive, FileStatusSchema, GitError, GitErrorBase, GitHubApiError, GitHubApiErrorBase, GitHubInfoSchema, GitHubLive, GitHubService, GitHubServiceBase, GlobSchema, HeadingHierarchyRule, InspectedConfigSchema, IssueLinkRefsPlugin, IssueNumberSchema, JsonPathSchema, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, MarkdownLive, MarkdownParseError, MarkdownParseErrorBase, MarkdownService, MarkdownServiceBase, ContentStructureRule$1 as MarkdownlintContentStructureRule, DependencyTableFormatRule$1 as MarkdownlintDependencyTableFormatRule, HeadingHierarchyRule$1 as MarkdownlintHeadingHierarchyRule, RequiredSectionsRule$1 as MarkdownlintRequiredSectionsRule, UncategorizedContentRule$1 as MarkdownlintUncategorizedContentRule, MergeSectionsPlugin, NonEmptyString, NormalizeFormatPlugin, PackageScopeSchema, PackagesRecordSchema, PendingChangesetSchema, PositiveInteger, PreviewReleaseSchema, ReleasePlanError, ReleasePlanErrorBase, ReleasePlanner, ReleasePlannerBase, ReleasePlannerLive, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule, ResolvedPackageScopeSchema, ResolvedVersionFileSchema, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules, UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VERSION_RE, VersionFileConfigSchema, VersionFileError, VersionFileErrorBase, VersionFileUpdateRecordSchema, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionTypeSchema, changelogFunctions, changesets_exports, computeWorkspaceDependencyDiffs, gitMergeBase, isPureDependencyChangeset, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeGitHubTest, makeReleasePlannerTest, serializeDependencyTableToMarkdown };
+export { AggregateDependencyTablesPlugin, AppliedReleaseEntrySchema, AppliedReleaseSchema, BranchAnalysisSchema, BranchAnalyzer, BranchAnalyzerBase, BranchAnalyzerLive, BranchFileEntrySchema, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogServiceBase, ChangelogTransformer, ChangesetIOError, ChangesetIOErrorBase, ChangesetLinter, ChangesetOptionsSchema, ChangesetPreviewSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ChangesetValidationErrorBase, ClassificationReasonSchema, ClassificationSchema, CommitHashSchema, ConfigInspector, ConfigInspectorBase, ConfigInspectorLive, ConfigurationError, ConfigurationErrorBase, ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyActionSchema, DependencyTable, DependencyTableFormatRule, DependencyTableRowSchema, DependencyTableSchema, DependencyTableTypeSchema, DependencyTypeSchema, DependencyUpdateSchema, DepsRegen, DepsRegenBase, DepsRegenDefault, DepsRegenLive, FileStatusSchema, GitError, GitErrorBase, GitHubApiError, GitHubApiErrorBase, GitHubInfoSchema, GitHubLive, GitHubService, GitHubServiceBase, GlobSchema, HeadingHierarchyRule, InspectedConfigSchema, IssueLinkRefsPlugin, IssueNumberSchema, JsonPathSchema, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, MaintenanceNotePlugin, MaintenanceReasonSchema, MaintenanceTriggerSchema, MarkdownLive, MarkdownParseError, MarkdownParseErrorBase, MarkdownService, MarkdownServiceBase, ContentStructureRule$1 as MarkdownlintContentStructureRule, DependencyTableFormatRule$1 as MarkdownlintDependencyTableFormatRule, HeadingHierarchyRule$1 as MarkdownlintHeadingHierarchyRule, RequiredSectionsRule$1 as MarkdownlintRequiredSectionsRule, UncategorizedContentRule$1 as MarkdownlintUncategorizedContentRule, MergeSectionsPlugin, NonEmptyString, NormalizeFormatPlugin, PackageScopeSchema, PackagesRecordSchema, PendingChangesetSchema, PositiveInteger, PreviewReleaseSchema, ReleasePlanError, ReleasePlanErrorBase, ReleasePlanner, ReleasePlannerBase, ReleasePlannerLive, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule, ResolvedPackageScopeSchema, ResolvedVersionFileSchema, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules, UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VERSION_RE, VersionFileConfigSchema, VersionFileError, VersionFileErrorBase, VersionFileUpdateRecordSchema, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionTypeSchema, changelogFunctions, changesets_exports, computeWorkspaceDependencyDiffs, deriveMaintenanceReason, gitMergeBase, isPureDependencyChangeset, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeGitHubTest, makeReleasePlannerTest, serializeDependencyTableToMarkdown };

package/changesets/remark/plugins/deduplicate-items.js

@@ -7,16 +7,18 @@ const DeduplicateItemsPlugin = () => {
 		const blocks = getVersionBlocks(tree);
 		for (const block of blocks) {
 			const sections = getBlockSections(tree, block);
-			for (const section of sections) for (const node of section.contentNodes) {
-				if (node.type !== "list") continue;
-				const list = node;
+			for (const section of sections) {
 				const seen = /* @__PURE__ */ new Set();
-				list.children = list.children.filter((item) => {
-					const text = toString(item);
-					if (seen.has(text)) return false;
-					seen.add(text);
-					return true;
-				});
+				for (const node of section.contentNodes) {
+					if (node.type !== "list") continue;
+					const list = node;
+					list.children = list.children.filter((item) => {
+						const text = toString(item);
+						if (seen.has(text)) return false;
+						seen.add(text);
+						return true;
+					});
+				}
 			}
 		}
 		tree.children = tree.children.filter((node) => {

package/changesets/remark/plugins/maintenance-note.js

@@ -0,0 +1,61 @@
+import { getHeadingText, getVersionBlocks } from "../../utils/version-blocks.js";
+
+//#region src/changesets/remark/plugins/maintenance-note.ts
+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/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 src/changesets/remark/presets.ts
 /**

package/changesets/services/maintenance-reason.js

@@ -0,0 +1,66 @@
+import { ChangesetConfig } from "../../services/ChangesetConfig.js";
+import { Schema } from "effect";
+
+//#region src/changesets/services/maintenance-reason.ts
+/**
+* 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/changesets/services/release-planner.js

@@ -1,9 +1,10 @@
 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 { Context, Effect, Layer } from "effect";
-import { isAbsolute, join, relative } from "node:path";
+import { dirname, isAbsolute, join, relative } from "node:path";
 import { FileSystem } from "@effect/platform";
 import applyReleasePlan from "@changesets/apply-release-plan";
 import { read } from "@changesets/config";
@@ -114,6 +115,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
@@ -135,6 +146,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,
@@ -203,8 +215,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)
@@ -258,17 +274,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 = [];

package/index.d.ts

@@ -1,7 +1,7 @@
 import { Context, Data, Effect, Equal, Hash, Layer, Option, Schema, Stream } from "effect";
+import { Plugin } from "unified";
 import { Command, CommandExecutor, FileSystem, Path } from "@effect/platform";
 import { PackageManagerDetector, PointInTimeReadError, PointInTimeWorkspace, PublishConfig, PublishTarget, PublishabilityDetector, TopologicalSorter, WorkspaceDiscovery, WorkspaceDiscoveryError, WorkspacePackage, WorkspaceRoot, WorkspaceStateSnapshot } from "workspaces-effect";
-import { Plugin } from "unified";
 import { PlatformError } from "@effect/platform/Error";
 
 //#region \0rolldown/runtime.js
@@ -335,6 +335,37 @@ type PackageJSON = {
     registry?: string;
   };
 };
+type PackageGroup = ReadonlyArray<string>;
+type Fixed = ReadonlyArray<PackageGroup>;
+type Linked = ReadonlyArray<PackageGroup>;
+interface PrivatePackages {
+  version: boolean;
+  tag: boolean;
+}
+type Config = {
+  changelog: false | readonly [string, any];
+  commit: false | readonly [string, any];
+  fixed: Fixed;
+  linked: Linked;
+  access: AccessType;
+  baseBranch: string;
+  changedFilePatterns: readonly string[]; /** When false, Changesets won't format with Prettier */
+  prettier: boolean; /** Features enabled for Private packages */
+  privatePackages: PrivatePackages; /** The minimum bump type to trigger automatic update of internal dependencies that are part of the same release */
+  updateInternalDependencies: "patch" | "minor";
+  ignore: ReadonlyArray<string>; /** This is supposed to be used with pnpm's `link-workspace-packages: false` and Berry's `enableTransparentWorkspaces: false` */
+  bumpVersionsWithWorkspaceProtocolOnly?: boolean;
+  ___experimentalUnsafeOptions_WILL_CHANGE_IN_PATCH: Omit<Required<ExperimentalOptions>, "useCalculatedVersionForSnapshots">;
+  snapshot: {
+    useCalculatedVersion: boolean;
+    prereleaseTemplate: string | null;
+  };
+};
+type ExperimentalOptions = {
+  onlyUpdatePeerDependentsWhenOutOfRange?: boolean;
+  updateInternalDependents?: "always" | "out-of-range"; /** @deprecated Since snapshot feature is now stable, you should migrate to use "snapshot.useCalculatedVersion". */
+  useCalculatedVersionForSnapshots?: boolean;
+};
 type NewChangesetWithCommit = NewChangeset & {
   commit?: string;
 };
@@ -2056,37 +2087,95 @@ declare class ChangesetLinter {
   static validate(dir: string): LintMessage[];
 }
 //#endregion
-//#region src/changesets/api/transformer.d.ts
+//#region src/changesets/services/maintenance-reason.d.ts
 /**
- * Class-based API wrapper for changelog transformation.
+ * A group co-member whose own changesets forced this release.
  *
- * Provides a static class interface that runs all remark transform
- * plugins against CHANGELOG markdown content as the post-processing
- * layer of the three-layer pipeline.
+ * @public
+ */
+declare const MaintenanceTriggerSchema: Schema.Struct<{
+  /** Package name of the triggering co-member. */name: typeof Schema.String; /** The co-member's new version in the same release plan. */
+  version: typeof Schema.String;
+}>;
+/**
+ * A group co-member whose own changesets forced this release.
  *
- * @internal
+ * @public
+ */
+type MaintenanceTrigger = typeof MaintenanceTriggerSchema.Type;
+/**
+ * Why a package is releasing with no changesets of its own.
+ *
+ * @public
+ */
+declare 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$<Schema.Struct<{
+    /** Package name of the triggering co-member. */name: typeof Schema.String; /** The co-member's new version in the same release plan. */
+    version: typeof Schema.String;
+  }>>;
+}>;
+/**
+ * Why a package is releasing with no changesets of its own.
+ *
+ * @public
+ */
+type MaintenanceReason = typeof MaintenanceReasonSchema.Type;
+/**
+ * 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
  */
+declare function deriveMaintenanceReason(release: ComprehensiveRelease, plan: ReleasePlan, config: Config): MaintenanceReason | undefined;
+//#endregion
+//#region src/changesets/remark/plugins/maintenance-note.d.ts
+/**
+ * Options for {@link MaintenanceNotePlugin}.
+ *
+ * @public
+ */
+interface MaintenanceNoteOptions {
+  /** Version heading text to target (e.g. `"2.3.1"`). */
+  readonly version: string;
+  /** Why the package released with no changesets of its own. */
+  readonly reason: MaintenanceReason;
+}
+declare const MaintenanceNotePlugin: Plugin<[MaintenanceNoteOptions], Root>;
+//#endregion
+//#region src/changesets/api/transformer.d.ts
+/**
+ * Optional per-file behavior for {@link ChangelogTransformer}.
+ *
+ * @public
+ */
+interface TransformOptions {
+  /** Insert a Maintenance note into this version block when it ends up empty. */
+  readonly maintenance?: MaintenanceNoteOptions;
+}
 /**
  * Static class for post-processing CHANGELOG.md files.
  *
  * Implements the third layer of the three-layer pipeline by running
- * six remark transform plugins in a fixed order to clean up, normalize,
- * and enhance changelog output produced by the formatter layer.
+ * the {@link SilkChangesetTransformPreset} plugins (currently seven) in a
+ * fixed order to clean up, normalize, and enhance changelog output produced
+ * by the formatter layer.
  *
  * @remarks
- * The six plugins run in this order:
- *
- * 1. **MergeSectionsPlugin** -- merges duplicate section headings (e.g., two
- *    "Features" sections from separate changesets are combined into one)
- * 2. **ReorderSectionsPlugin** -- reorders sections by category priority
- *    (Breaking Changes first, Other last) using the {@link Categories} priority values
- * 3. **DeduplicateItemsPlugin** -- removes duplicate list items within a section
- * 4. **ContributorFootnotesPlugin** -- converts inline contributor mentions
- *    into footnote references for cleaner formatting
- * 5. **IssueLinkRefsPlugin** -- converts inline issue/PR links into markdown
- *    reference-style links collected at the bottom of the document
- * 6. **NormalizeFormatPlugin** -- applies consistent formatting (spacing,
- *    trailing newlines, heading levels)
+ * See {@link SilkChangesetTransformPreset} for the ordered plugin list and
+ * the rationale behind each plugin's position.
  *
  * The transformer operates on the full CHANGELOG.md content (all versions),
  * not just the latest release block. It is idempotent -- running it multiple
@@ -2145,19 +2234,22 @@ declare class ChangesetLinter {
 declare class ChangelogTransformer {
   private constructor();
   /**
-   * Transform CHANGELOG markdown content by running all six transform plugins.
+   * Transform CHANGELOG markdown content by running the
+   * {@link SilkChangesetTransformPreset} plugins.
    *
    * @remarks
    * The input is parsed with `remark-parse` and `remark-gfm` (for table
-   * support), processed through all six plugins in order, and stringified
-   * back to markdown. The operation is synchronous and idempotent.
+   * support), processed through every plugin in {@link SilkChangesetTransformPreset}
+   * in order, and stringified back to markdown. The operation is synchronous
+   * and idempotent.
    *
    * @param content - Raw CHANGELOG markdown string (may contain multiple
    *   version blocks, GFM tables, footnotes, and reference links)
-   * @returns The transformed markdown string with sections merged, reordered,
-   *   deduplicated, and normalized
+   * @param options - Optional transformation options, including maintenance note configuration
+   * @returns The transformed markdown string with dependency tables aggregated,
+   *   sections merged, reordered, deduplicated, and normalized
    */
-  static transformContent(content: string): string;
+  static transformContent(content: string, options?: TransformOptions): string;
   /**
    * Transform a CHANGELOG file in-place.
    *
@@ -2171,8 +2263,9 @@ declare class ChangelogTransformer {
    * when invoked without the `--dry-run` or `--check` flags.
    *
    * @param filePath - Absolute or relative path to the CHANGELOG.md file
+   * @param options - Optional transformation options, including maintenance note configuration
    */
-  static transformFile(filePath: string): void;
+  static transformFile(filePath: string, options?: TransformOptions): void;
 }
 //#endregion
 //#region src/changesets/changelog/index.d.ts
@@ -5477,7 +5570,7 @@ declare const RequiredSectionsRule: import("unified-lint-rule").Plugin<Root, unk
 //#region src/changesets/remark/rules/uncategorized-content.d.ts
 declare const UncategorizedContentRule: import("unified-lint-rule").Plugin<Root, unknown>;
 declare namespace index_d_exports {
-  export { AggregateDependencyTablesPlugin, AppliedRelease, AppliedReleaseEntrySchema, AppliedReleaseSchema, BranchAnalysis, BranchAnalysisSchema, BranchAnalyzer, BranchAnalyzerBase, BranchAnalyzerLive, BranchAnalyzerShape, BranchFileEntry, BranchFileEntrySchema, BumpType, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogServiceBase, ChangelogServiceShape, ChangelogTransformer, Changeset, ChangesetIOError, ChangesetIOErrorBase, ChangesetLinter, ChangesetOptions, ChangesetOptionsSchema, ChangesetPreview, ChangesetPreviewSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ChangesetValidationErrorBase, Classification, ClassificationReason, ClassificationReasonSchema, ClassificationSchema, CommitHashSchema, ConfigInspector, ConfigInspectorBase, ConfigInspectorLive, ConfigInspectorShape, ConfigurationError, ConfigurationErrorBase, ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyAction, DependencyActionSchema, DependencyTable, DependencyTableFormatRule, DependencyTableRow, DependencyTableRowSchema, DependencyTableSchema, DependencyTableType, DependencyTableTypeSchema, DependencyType, DependencyTypeSchema, DependencyUpdate, DependencyUpdateSchema, DepsRegen, DepsRegenBase, DepsRegenDefault, DepsRegenLive, DepsRegenOptions, DepsRegenShape, FileStatus, FileStatusSchema, GitError, GitErrorBase, GitHubApiError, GitHubApiErrorBase, GitHubCommitInfo, GitHubInfo, GitHubInfoSchema, GitHubLive, GitHubService, GitHubServiceBase, GitHubServiceShape, GlobSchema, HeadingHierarchyRule, InspectedConfig, InspectedConfigSchema, IssueLinkRefsPlugin, IssueNumberSchema, JsonPathSchema, LegacyVersionFileConfig, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, LintMessage, MarkdownLive, MarkdownParseError, MarkdownParseErrorBase, MarkdownService, MarkdownServiceBase, MarkdownServiceShape, ContentStructureRule$1 as MarkdownlintContentStructureRule, DependencyTableFormatRule$1 as MarkdownlintDependencyTableFormatRule, HeadingHierarchyRule$1 as MarkdownlintHeadingHierarchyRule, RequiredSectionsRule$1 as MarkdownlintRequiredSectionsRule, UncategorizedContentRule$1 as MarkdownlintUncategorizedContentRule, MergeSectionsPlugin, NonEmptyString, NormalizeFormatPlugin, PackageScope, PackageScopeSchema, PackagesRecordSchema, PendingChangeset, PendingChangesetSchema, PositiveInteger, PreviewRelease, PreviewReleaseSchema, RegenPlan, RegenResult, ReleasePlanError, ReleasePlanErrorBase, ReleasePlanner, ReleasePlannerBase, ReleasePlannerLive, ReleasePlannerShape, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule, ResolvedPackageScope, ResolvedPackageScopeSchema, ResolvedVersionFile, ResolvedVersionFileSchema, SectionCategory, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules, UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VERSION_RE, VersionFileConfig, VersionFileConfigSchema, VersionFileError, VersionFileErrorBase, VersionFileUpdate, VersionFileUpdateRecordSchema, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionType, VersionTypeSchema, WorkspaceDependencyDiff, WorkspaceVersion, changelogFunctions, computeWorkspaceDependencyDiffs, gitMergeBase, isPureDependencyChangeset, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeGitHubTest, makeReleasePlannerTest, serializeDependencyTableToMarkdown };
+  export { AggregateDependencyTablesPlugin, AppliedRelease, AppliedReleaseEntrySchema, AppliedReleaseSchema, BranchAnalysis, BranchAnalysisSchema, BranchAnalyzer, BranchAnalyzerBase, BranchAnalyzerLive, BranchAnalyzerShape, BranchFileEntry, BranchFileEntrySchema, BumpType, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogServiceBase, ChangelogServiceShape, ChangelogTransformer, Changeset, ChangesetIOError, ChangesetIOErrorBase, ChangesetLinter, ChangesetOptions, ChangesetOptionsSchema, ChangesetPreview, ChangesetPreviewSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ChangesetValidationErrorBase, Classification, ClassificationReason, ClassificationReasonSchema, ClassificationSchema, CommitHashSchema, ConfigInspector, ConfigInspectorBase, ConfigInspectorLive, ConfigInspectorShape, ConfigurationError, ConfigurationErrorBase, ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyAction, DependencyActionSchema, DependencyTable, DependencyTableFormatRule, DependencyTableRow, DependencyTableRowSchema, DependencyTableSchema, DependencyTableType, DependencyTableTypeSchema, DependencyType, DependencyTypeSchema, DependencyUpdate, DependencyUpdateSchema, DepsRegen, DepsRegenBase, DepsRegenDefault, DepsRegenLive, DepsRegenOptions, DepsRegenShape, FileStatus, FileStatusSchema, GitError, GitErrorBase, GitHubApiError, GitHubApiErrorBase, GitHubCommitInfo, GitHubInfo, GitHubInfoSchema, GitHubLive, GitHubService, GitHubServiceBase, GitHubServiceShape, GlobSchema, HeadingHierarchyRule, InspectedConfig, InspectedConfigSchema, IssueLinkRefsPlugin, IssueNumberSchema, JsonPathSchema, LegacyVersionFileConfig, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, LintMessage, MaintenanceNoteOptions, MaintenanceNotePlugin, MaintenanceReason, MaintenanceReasonSchema, MaintenanceTrigger, MaintenanceTriggerSchema, MarkdownLive, MarkdownParseError, MarkdownParseErrorBase, MarkdownService, MarkdownServiceBase, MarkdownServiceShape, ContentStructureRule$1 as MarkdownlintContentStructureRule, DependencyTableFormatRule$1 as MarkdownlintDependencyTableFormatRule, HeadingHierarchyRule$1 as MarkdownlintHeadingHierarchyRule, RequiredSectionsRule$1 as MarkdownlintRequiredSectionsRule, UncategorizedContentRule$1 as MarkdownlintUncategorizedContentRule, MergeSectionsPlugin, NonEmptyString, NormalizeFormatPlugin, PackageScope, PackageScopeSchema, PackagesRecordSchema, PendingChangeset, PendingChangesetSchema, PositiveInteger, PreviewRelease, PreviewReleaseSchema, RegenPlan, RegenResult, ReleasePlanError, ReleasePlanErrorBase, ReleasePlanner, ReleasePlannerBase, ReleasePlannerLive, ReleasePlannerShape, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule, ResolvedPackageScope, ResolvedPackageScopeSchema, ResolvedVersionFile, ResolvedVersionFileSchema, SectionCategory, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules, TransformOptions, UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VERSION_RE, VersionFileConfig, VersionFileConfigSchema, VersionFileError, VersionFileErrorBase, VersionFileUpdate, VersionFileUpdateRecordSchema, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionType, VersionTypeSchema, WorkspaceDependencyDiff, WorkspaceVersion, changelogFunctions, computeWorkspaceDependencyDiffs, deriveMaintenanceReason, gitMergeBase, isPureDependencyChangeset, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeGitHubTest, makeReleasePlannerTest, serializeDependencyTableToMarkdown };
 }
 //#endregion
 //#region src/commitlint/config/schema.d.ts

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/silk-effects",
-	"version": "2.0.2",
+	"version": "2.1.0",
 	"private": false,
 	"description": "Shared Effect library for Silk Suite conventions",
 	"homepage": "https://github.com/savvy-web/systems/tree/main/packages/silk-effects",