@savvy-web/silk 1.3.9 → 1.3.11

package/changesets-changelog.d.cts

@@ -4799,6 +4799,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;
 };
@@ -6508,37 +6539,93 @@ 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$1<[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
@@ -6597,19 +6684,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.
    *
@@ -6623,8 +6713,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
 /**
@@ -9854,7 +9945,7 @@ declare const RequiredSectionsRule: Plugin<Root, unknown>; //#endregion
 //#region src/changesets/remark/rules/uncategorized-content.d.ts
 declare const UncategorizedContentRule: 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$1 as 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$1 as changelogFunctions, computeWorkspaceDependencyDiffs, deriveMaintenanceReason, gitMergeBase, isPureDependencyChangeset, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeGitHubTest, makeReleasePlannerTest, serializeDependencyTableToMarkdown };
 } //#endregion
 //#region src/commitlint/config/schema.d.ts
 /**

package/changesets-changelog.d.ts

@@ -4799,6 +4799,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;
 };
@@ -6508,37 +6539,93 @@ 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$1<[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
@@ -6597,19 +6684,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.
    *
@@ -6623,8 +6713,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
 /**
@@ -9854,7 +9945,7 @@ declare const RequiredSectionsRule: Plugin<Root, unknown>; //#endregion
 //#region src/changesets/remark/rules/uncategorized-content.d.ts
 declare const UncategorizedContentRule: 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$1 as 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$1 as changelogFunctions, computeWorkspaceDependencyDiffs, deriveMaintenanceReason, gitMergeBase, isPureDependencyChangeset, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeGitHubTest, makeReleasePlannerTest, serializeDependencyTableToMarkdown };
 } //#endregion
 //#region src/commitlint/config/schema.d.ts
 /**