@savvy-web/silk 1.3.10 → 2.0.0

package/changesets-markdownlint.d.cts

@@ -4748,7 +4748,9 @@ declare class Categories {
    */
   static isValidHeading(heading: string): boolean;
 } //#endregion
-//#region ../../node_modules/.pnpm/@changesets+types@6.1.0/node_modules/@changesets/types/dist/declarations/src/index.d.ts
+//#region ../../node_modules/.pnpm/@changesets+types@7.0.0-next.6/node_modules/@changesets/types/dist/index.d.mts
+//#region src/index.d.ts
+type MaybePromise<T> = T | Promise<T>;
 type VersionType$1 = "major" | "minor" | "patch" | "none";
 type AccessType = "public" | "restricted";
 type Release = {
@@ -4797,8 +4799,43 @@ type PackageJSON = {
     access?: AccessType;
     directory?: string;
     registry?: string;
+    [registry: `${string}: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, null | Record<string, unknown>];
+  commit: false | readonly [string, null | Record<string, unknown>];
+  fixed: Fixed;
+  linked: Linked;
+  access: AccessType;
+  baseBranch: string;
+  changedFilePatterns: readonly string[];
+  /**
+   * The formatter to use to format changesets and changelogs. Set `false` to disable formatting.
+   * The default value of `"auto"` will auto-detect the formatter based on the project's configuration files.
+   */
+  format: "auto" | "prettier" | "oxfmt" | "deno" | "dprint" | false; /** 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: Required<ExperimentalOptions>;
+  snapshot: {
+    useCalculatedVersion: boolean;
+    prereleaseTemplate: string | null;
+  };
+};
+type ExperimentalOptions = {
+  onlyUpdatePeerDependentsWhenOutOfRange?: boolean;
+  updateInternalDependents?: "always" | "out-of-range";
+};
 type NewChangesetWithCommit = NewChangeset & {
   commit?: string;
 };
@@ -4806,8 +4843,8 @@ type ModCompWithPackage = ComprehensiveRelease & {
   packageJson: PackageJSON;
   dir: string;
 };
-type GetReleaseLine = (changeset: NewChangesetWithCommit, type: VersionType$1, changelogOpts: null | Record<string, any>) => Promise<string>;
-type GetDependencyReleaseLine = (changesets: NewChangesetWithCommit[], dependenciesUpdated: ModCompWithPackage[], changelogOpts: any) => Promise<string>;
+type GetReleaseLine = (changeset: NewChangesetWithCommit, type: VersionType$1, changelogOpts: null | Record<string, unknown>) => MaybePromise<string>;
+type GetDependencyReleaseLine = (changesets: NewChangesetWithCommit[], dependenciesUpdated: ModCompWithPackage[], changelogOpts: null | Record<string, unknown>) => MaybePromise<string>;
 type ChangelogFunctions = {
   getReleaseLine: GetReleaseLine;
   getDependencyReleaseLine: GetDependencyReleaseLine;
@@ -4815,9 +4852,6 @@ type ChangelogFunctions = {
 type PreState = {
   mode: "pre" | "exit";
   tag: string;
-  initialVersions: {
-    [pkgName: string]: string;
-  };
   changesets: string[];
 }; //#endregion
 //#region src/changesets/api/changelog.d.ts
@@ -6508,37 +6542,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
+/**
+ * A group co-member whose own changesets forced this release.
+ *
+ * @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;
+}>;
 /**
- * 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
+ */
+type MaintenanceTrigger = typeof MaintenanceTriggerSchema.Type;
+/**
+ * Why a package is releasing with no changesets of its own.
  *
- * @internal
+ * @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 +6687,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 +6716,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
 /**
@@ -7052,7 +7146,7 @@ declare class ChangesetConfigError extends ChangesetConfigError_base<{
 } //#endregion
 //#region src/schemas/VersioningSchemas.d.ts
 /**
- * Standard changesets configuration matching the `@changesets/config@3.1.1` spec.
+ * Standard changesets configuration matching the `@changesets/config@4.0.0-next.6` spec.
  *
  * @remarks
  * Represents the parsed `.changeset/config.json` file. All fields are optional
@@ -8278,6 +8372,13 @@ interface ReleasePlannerShape {
   /** Natively apply the release (destructive unless `dryRun`). */
   readonly apply: (root: string, options?: {
     readonly dryRun?: boolean;
+    /**
+     * Map configured changelog ids to absolute module paths. When set,
+     * `config.changelog[0]` must be a key of this map (rewritten before the
+     * engine call; unmapped ids fail) and the engine's `format` integration
+     * is disabled — callers in no-`node_modules` contexts own formatting.
+     */
+    readonly changelogModules?: Readonly<Record<string, string>>;
   }) => Effect.Effect<AppliedRelease, ReleasePlanError>;
 }
 /**
@@ -9854,7 +9955,7 @@ declare const RequiredSectionsRule$2: Plugin<Root, unknown>; //#endregion
 //#region src/changesets/remark/rules/uncategorized-content.d.ts
 declare const UncategorizedContentRule$2: 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$2 as ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyAction, DependencyActionSchema, DependencyTable, DependencyTableFormatRule$2 as 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$2 as 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$2 as RequiredSectionsRule, ResolvedPackageScope, ResolvedPackageScopeSchema, ResolvedVersionFile, ResolvedVersionFileSchema, SectionCategory, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules$1 as SilkChangesetsRules, UncategorizedContentRule$2 as 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$2 as ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyAction, DependencyActionSchema, DependencyTable, DependencyTableFormatRule$2 as 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$2 as 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$2 as RequiredSectionsRule, ResolvedPackageScope, ResolvedPackageScopeSchema, ResolvedVersionFile, ResolvedVersionFileSchema, SectionCategory, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules$1 as SilkChangesetsRules, TransformOptions, UncategorizedContentRule$2 as 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/changesets-markdownlint.d.ts

@@ -4748,7 +4748,9 @@ declare class Categories {
    */
   static isValidHeading(heading: string): boolean;
 } //#endregion
-//#region ../../node_modules/.pnpm/@changesets+types@6.1.0/node_modules/@changesets/types/dist/declarations/src/index.d.ts
+//#region ../../node_modules/.pnpm/@changesets+types@7.0.0-next.6/node_modules/@changesets/types/dist/index.d.mts
+//#region src/index.d.ts
+type MaybePromise<T> = T | Promise<T>;
 type VersionType$1 = "major" | "minor" | "patch" | "none";
 type AccessType = "public" | "restricted";
 type Release = {
@@ -4797,8 +4799,43 @@ type PackageJSON = {
     access?: AccessType;
     directory?: string;
     registry?: string;
+    [registry: `${string}: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, null | Record<string, unknown>];
+  commit: false | readonly [string, null | Record<string, unknown>];
+  fixed: Fixed;
+  linked: Linked;
+  access: AccessType;
+  baseBranch: string;
+  changedFilePatterns: readonly string[];
+  /**
+   * The formatter to use to format changesets and changelogs. Set `false` to disable formatting.
+   * The default value of `"auto"` will auto-detect the formatter based on the project's configuration files.
+   */
+  format: "auto" | "prettier" | "oxfmt" | "deno" | "dprint" | false; /** 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: Required<ExperimentalOptions>;
+  snapshot: {
+    useCalculatedVersion: boolean;
+    prereleaseTemplate: string | null;
+  };
+};
+type ExperimentalOptions = {
+  onlyUpdatePeerDependentsWhenOutOfRange?: boolean;
+  updateInternalDependents?: "always" | "out-of-range";
+};
 type NewChangesetWithCommit = NewChangeset & {
   commit?: string;
 };
@@ -4806,8 +4843,8 @@ type ModCompWithPackage = ComprehensiveRelease & {
   packageJson: PackageJSON;
   dir: string;
 };
-type GetReleaseLine = (changeset: NewChangesetWithCommit, type: VersionType$1, changelogOpts: null | Record<string, any>) => Promise<string>;
-type GetDependencyReleaseLine = (changesets: NewChangesetWithCommit[], dependenciesUpdated: ModCompWithPackage[], changelogOpts: any) => Promise<string>;
+type GetReleaseLine = (changeset: NewChangesetWithCommit, type: VersionType$1, changelogOpts: null | Record<string, unknown>) => MaybePromise<string>;
+type GetDependencyReleaseLine = (changesets: NewChangesetWithCommit[], dependenciesUpdated: ModCompWithPackage[], changelogOpts: null | Record<string, unknown>) => MaybePromise<string>;
 type ChangelogFunctions = {
   getReleaseLine: GetReleaseLine;
   getDependencyReleaseLine: GetDependencyReleaseLine;
@@ -4815,9 +4852,6 @@ type ChangelogFunctions = {
 type PreState = {
   mode: "pre" | "exit";
   tag: string;
-  initialVersions: {
-    [pkgName: string]: string;
-  };
   changesets: string[];
 }; //#endregion
 //#region src/changesets/api/changelog.d.ts
@@ -6508,37 +6542,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
+/**
+ * A group co-member whose own changesets forced this release.
+ *
+ * @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;
+}>;
 /**
- * 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
+ */
+type MaintenanceTrigger = typeof MaintenanceTriggerSchema.Type;
+/**
+ * Why a package is releasing with no changesets of its own.
  *
- * @internal
+ * @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 +6687,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 +6716,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
 /**
@@ -7052,7 +7146,7 @@ declare class ChangesetConfigError extends ChangesetConfigError_base<{
 } //#endregion
 //#region src/schemas/VersioningSchemas.d.ts
 /**
- * Standard changesets configuration matching the `@changesets/config@3.1.1` spec.
+ * Standard changesets configuration matching the `@changesets/config@4.0.0-next.6` spec.
  *
  * @remarks
  * Represents the parsed `.changeset/config.json` file. All fields are optional
@@ -8278,6 +8372,13 @@ interface ReleasePlannerShape {
   /** Natively apply the release (destructive unless `dryRun`). */
   readonly apply: (root: string, options?: {
     readonly dryRun?: boolean;
+    /**
+     * Map configured changelog ids to absolute module paths. When set,
+     * `config.changelog[0]` must be a key of this map (rewritten before the
+     * engine call; unmapped ids fail) and the engine's `format` integration
+     * is disabled — callers in no-`node_modules` contexts own formatting.
+     */
+    readonly changelogModules?: Readonly<Record<string, string>>;
   }) => Effect.Effect<AppliedRelease, ReleasePlanError>;
 }
 /**
@@ -9854,7 +9955,7 @@ declare const RequiredSectionsRule$2: Plugin<Root, unknown>; //#endregion
 //#region src/changesets/remark/rules/uncategorized-content.d.ts
 declare const UncategorizedContentRule$2: 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$2 as ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyAction, DependencyActionSchema, DependencyTable, DependencyTableFormatRule$2 as 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$2 as 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$2 as RequiredSectionsRule, ResolvedPackageScope, ResolvedPackageScopeSchema, ResolvedVersionFile, ResolvedVersionFileSchema, SectionCategory, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules$1 as SilkChangesetsRules, UncategorizedContentRule$2 as 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$2 as ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyAction, DependencyActionSchema, DependencyTable, DependencyTableFormatRule$2 as 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$2 as 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$2 as RequiredSectionsRule, ResolvedPackageScope, ResolvedPackageScopeSchema, ResolvedVersionFile, ResolvedVersionFileSchema, SectionCategory, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules$1 as SilkChangesetsRules, TransformOptions, UncategorizedContentRule$2 as 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",
-	"version": "1.3.10",
+	"version": "2.0.0",
 	"private": false,
 	"description": "The single Silk Suite dev-tooling package — changeset, commitlint, lint, and biome conventions",
 	"homepage": "https://github.com/savvy-web/systems/tree/main/packages/silk",
@@ -66,25 +66,25 @@
 	},
 	"dependencies": {
 		"@effect/platform": "^0.96.2",
-		"@savvy-web/silk-effects": "2.0.2",
+		"@savvy-web/silk-effects": "3.0.0",
 		"effect": "^3.21.4",
 		"semver": "^7.8.5"
 	},
 	"peerDependencies": {
 		"@biomejs/biome": "~2.5.0",
-		"@changesets/cli": "^2.31.0",
-		"@commitlint/cli": "^21.1.0",
-		"@commitlint/config-conventional": "^21.1.0",
-		"@savvy-web/cli": "1.4.2",
-		"@savvy-web/mcp": "1.6.2",
-		"@types/node": "^26.0.0",
+		"@changesets/cli": "^3.0.0-next.8",
+		"@commitlint/cli": "^21.2.0",
+		"@commitlint/config-conventional": "^21.2.0",
+		"@savvy-web/cli": "1.4.4",
+		"@savvy-web/mcp": "1.6.4",
+		"@types/node": "^26.1.0",
 		"@typescript/native-preview": "^7.0.0-dev.20260612.1",
-		"commitizen": "^4.3.0",
+		"commitizen": "^4.3.2",
 		"husky": "^9.1.7",
-		"lint-staged": "^17.0.7",
-		"markdownlint-cli2": "^0.22.1",
+		"lint-staged": "^17.0.8",
+		"markdownlint-cli2": "^0.23.0",
 		"markdownlint-cli2-formatter-codequality": "^0.0.7",
-		"turbo": "^2.10.0",
+		"turbo": "^2.10.2",
 		"typescript": "^6.0.0"
 	},
 	"peerDependenciesMeta": {

package/packages/silk-effects/dist/dev/pkg/changesets/api/changelog.cjs

@@ -106,7 +106,7 @@ var Changelog = class {
 	*   Pass `null` to use defaults (no GitHub link resolution).
 	* @returns A promise resolving to the formatted markdown string
 	*/
-	static formatReleaseLine(changeset, versionType, options) {
+	static async formatReleaseLine(changeset, versionType, options) {
 		return require_index.default.getReleaseLine(changeset, versionType, options);
 	}
 	/**
@@ -125,7 +125,7 @@ var Changelog = class {
 	* @returns A promise resolving to the formatted markdown string containing
 	*   the dependency update table
 	*/
-	static formatDependencyReleaseLine(changesets, dependenciesUpdated, options) {
+	static async formatDependencyReleaseLine(changesets, dependenciesUpdated, options) {
 		return require_index.default.getDependencyReleaseLine(changesets, dependenciesUpdated, options);
 	}
 };

package/packages/silk-effects/dist/dev/pkg/changesets/api/changelog.js

@@ -106,7 +106,7 @@ var Changelog = class {
 	*   Pass `null` to use defaults (no GitHub link resolution).
 	* @returns A promise resolving to the formatted markdown string
 	*/
-	static formatReleaseLine(changeset, versionType, options) {
+	static async formatReleaseLine(changeset, versionType, options) {
 		return changelogFunctions.getReleaseLine(changeset, versionType, options);
 	}
 	/**
@@ -125,7 +125,7 @@ var Changelog = class {
 	* @returns A promise resolving to the formatted markdown string containing
 	*   the dependency update table
 	*/
-	static formatDependencyReleaseLine(changesets, dependenciesUpdated, options) {
+	static async formatDependencyReleaseLine(changesets, dependenciesUpdated, options) {
 		return changelogFunctions.getDependencyReleaseLine(changesets, dependenciesUpdated, options);
 	}
 };