@savvy-web/changesets 0.4.2 → 0.5.0

package/cjs/remark.d.cts

@@ -1,7 +1,54 @@
 /**
- * Consolidated remark plugins for changeset validation and CHANGELOG transformation.
+ * \@savvy-web/changesets/remark
  *
- * Re-exports all lint rules and transform plugins from a single entry point.
+ * Remark plugins for changeset validation and CHANGELOG transformation.
+ *
+ * This entry point re-exports all lint rules, transform plugins, and presets
+ * from a single import path. The exports are organized into three groups:
+ *
+ * **Lint rules** validate changeset markdown structure before changelog generation:
+ * - {@link HeadingHierarchyRule} (CSH001) -- heading depth and ordering
+ * - {@link RequiredSectionsRule} (CSH002) -- recognized section headings
+ * - {@link ContentStructureRule} (CSH003) -- non-empty sections, code fences, list items
+ * - {@link UncategorizedContentRule} (CSH004) -- content before the first heading
+ * - {@link DependencyTableFormatRule} (CSH005) -- dependency table schema compliance
+ *
+ * **Transform plugins** normalize and clean up generated CHANGELOG markdown:
+ * - {@link AggregateDependencyTablesPlugin} -- merge duplicate dependency sections
+ * - {@link MergeSectionsPlugin} -- merge duplicate h3 section headings
+ * - {@link ReorderSectionsPlugin} -- sort sections by category priority
+ * - {@link DeduplicateItemsPlugin} -- remove duplicate list items
+ * - {@link ContributorFootnotesPlugin} -- aggregate contributor attributions
+ * - {@link IssueLinkRefsPlugin} -- convert inline issue links to reference-style
+ * - {@link NormalizeFormatPlugin} -- remove empty sections and lists
+ *
+ * **Presets** bundle related rules or plugins for convenient consumption:
+ * - {@link SilkChangesetPreset} -- all five lint rules
+ * - {@link SilkChangesetTransformPreset} -- all seven transform plugins in execution order
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   SilkChangesetPreset,
+ *   SilkChangesetTransformPreset,
+ * } from "\@savvy-web/changesets/remark";
+ * import remarkParse from "remark-parse";
+ * import remarkStringify from "remark-stringify";
+ * import { unified } from "unified";
+ *
+ * // Lint a changeset file
+ * const linter = unified().use(remarkParse);
+ * for (const rule of SilkChangesetPreset) {
+ *   linter.use(rule);
+ * }
+ *
+ * // Transform a CHANGELOG
+ * const transformer = unified().use(remarkParse);
+ * for (const plugin of SilkChangesetTransformPreset) {
+ *   transformer.use(plugin);
+ * }
+ * transformer.use(remarkStringify);
+ * ```
  *
  * @packageDocumentation
  */
@@ -10,46 +57,24 @@ import { Plugin } from 'unified';
 import { Plugin as Plugin_2 } from 'unified-lint-rule';
 import { Root } from 'mdast';
 
+export declare const AggregateDependencyTablesPlugin: Plugin<[], Root>;
+
 export declare const ContentStructureRule: Plugin_2<Root, unknown>;
 
-/**
- * Extract inline contributor attributions and aggregate them into
- * a summary paragraph at the end of each version block.
- */
 export declare const ContributorFootnotesPlugin: Plugin<[], Root>;
 
-/**
- * Remove duplicate list items within each h3 section.
- *
- * Items are compared by their plain text content. If a list becomes
- * empty after deduplication, it is removed from the tree.
- */
 export declare const DeduplicateItemsPlugin: Plugin<[], Root>;
 
+export declare const DependencyTableFormatRule: Plugin_2<Root, unknown>;
+
 export declare const HeadingHierarchyRule: Plugin_2<Root, unknown>;
 
-/**
- * Convert inline issue links to reference-style links with definitions
- * at the end of each version block.
- */
 export declare const IssueLinkRefsPlugin: Plugin<[], Root>;
 
-/**
- * Merge duplicate h3 sections within each version block.
- *
- * Groups sections by heading text (case-insensitive via `fromHeading`),
- * keeps the first occurrence, and splices content from duplicates into it.
- */
 export declare const MergeSectionsPlugin: Plugin<[], Root>;
 
-/**
- * Remove empty sections and empty lists from the document.
- */
 export declare const NormalizeFormatPlugin: Plugin<[], Root>;
 
-/**
- * Reorder h3 sections within each version block by category priority.
- */
 export declare const ReorderSectionsPlugin: Plugin<[], Root>;
 
 export declare const RequiredSectionsRule: Plugin_2<Root, unknown>;
@@ -57,37 +82,81 @@ export declare const RequiredSectionsRule: Plugin_2<Root, unknown>;
 /**
  * Preset combining all changeset lint rules for convenient consumption.
  *
+ * @remarks
+ * Includes the following rules in order:
+ *
+ * 1. {@link HeadingHierarchyRule} (CSH001) -- no h1, no depth skips
+ * 2. {@link RequiredSectionsRule} (CSH002) -- h2 headings must match a known category
+ * 3. {@link ContentStructureRule} (CSH003) -- non-empty sections, code fence languages, non-empty list items
+ * 4. {@link UncategorizedContentRule} (CSH004) -- no content before the first h2 heading
+ * 5. {@link DependencyTableFormatRule} (CSH005) -- dependency table column/value validation
+ *
+ * Rule execution order is not significant for lint rules; all rules run
+ * independently over the same AST and report warnings to the virtual file.
+ *
  * @example
  * ```typescript
  * import { SilkChangesetPreset } from "\@savvy-web/changesets/remark";
  * import remarkParse from "remark-parse";
  * import { unified } from "unified";
+ * import { read } from "to-vfile";
  *
  * const processor = unified().use(remarkParse);
  * for (const rule of SilkChangesetPreset) {
  *   processor.use(rule);
  * }
+ *
+ * const file = await read("changeset.md");
+ * const result = await processor.process(file);
+ * console.log(result.messages); // lint warnings
  * ```
  *
+ * @see {@link SilkChangesetTransformPreset} for the corresponding transform preset
+ *
  * @public
  */
-export declare const SilkChangesetPreset: readonly [Plugin_2<Root, unknown>, Plugin_2<Root, unknown>, Plugin_2<Root, unknown>, Plugin_2<Root, unknown>];
+export declare const SilkChangesetPreset: readonly [Plugin_2<Root, unknown>, Plugin_2<Root, unknown>, Plugin_2<Root, unknown>, Plugin_2<Root, unknown>, Plugin_2<Root, unknown>];
 
 /**
  * Ordered array of all transform plugins in the correct execution order.
  *
  * @remarks
- * Plugin ordering is significant:
- * 1. `MergeSectionsPlugin` -- merge duplicate h3 headings (must run before reorder)
- * 2. `ReorderSectionsPlugin` -- sort sections by category priority
- * 3. `DeduplicateItemsPlugin` -- remove duplicate list items
- * 4. `ContributorFootnotesPlugin` -- aggregate contributor attributions
- * 5. `IssueLinkRefsPlugin` -- convert inline issue links to reference-style
- * 6. `NormalizeFormatPlugin` -- final cleanup (remove empty sections/lists)
+ * Plugin ordering is significant -- each plugin may depend on the output of
+ * earlier plugins in the pipeline:
+ *
+ * 1. {@link AggregateDependencyTablesPlugin} -- merge duplicate dependency sections (must run first so downstream plugins see a single Dependencies section)
+ * 2. {@link MergeSectionsPlugin} -- merge duplicate h3 headings (must run before reorder so that priority is computed on consolidated sections)
+ * 3. {@link ReorderSectionsPlugin} -- sort sections by category priority (Breaking Changes first, Other last)
+ * 4. {@link DeduplicateItemsPlugin} -- remove duplicate list items within each section
+ * 5. {@link ContributorFootnotesPlugin} -- extract inline `Thanks \@user!` attributions and aggregate them into a summary paragraph per version block
+ * 6. {@link IssueLinkRefsPlugin} -- convert inline `[#N](url)` links to reference-style `[#N]` with definitions at the end of each version block
+ * 7. {@link NormalizeFormatPlugin} -- final cleanup removing empty sections and empty lists
+ *
+ * @example
+ * ```typescript
+ * import { SilkChangesetTransformPreset } from "\@savvy-web/changesets/remark";
+ * import remarkGfm from "remark-gfm";
+ * import remarkParse from "remark-parse";
+ * import remarkStringify from "remark-stringify";
+ * import { unified } from "unified";
+ * import { read } from "to-vfile";
+ *
+ * const processor = unified().use(remarkParse).use(remarkGfm);
+ * for (const plugin of SilkChangesetTransformPreset) {
+ *   processor.use(plugin);
+ * }
+ * processor.use(remarkStringify);
+ *
+ * const file = await read("CHANGELOG.md");
+ * const result = await processor.process(file);
+ * console.log(String(result));
+ * ```
+ *
+ * @see {@link SilkChangesetPreset} for the corresponding lint preset
  *
  * @public
  */
-export declare const SilkChangesetTransformPreset: readonly [Plugin<[], Root>, Plugin<[], Root>, Plugin<[], Root>, Plugin<[], Root>, Plugin<[], Root>, Plugin<[], Root>];
+export declare const SilkChangesetTransformPreset: readonly [Plugin<[], Root>, Plugin<[], Root>, Plugin<[], Root>, Plugin<[], Root>, Plugin<[], Root>, Plugin<[], Root>, Plugin<[], Root>];
 
 export declare const UncategorizedContentRule: Plugin_2<Root, unknown>;
 

package/esm/160.js

@@ -1,6 +1,7 @@
 import { getInfo } from "@changesets/get-github-info";
-import { Layer, unified, Schema, remark_stringify, Effect, GitHubApiError, VersionFilesSchema, remark_gfm, ConfigurationError, Context, remark_parse } from "./795.js";
-import { external_mdast_util_to_string_toString } from "./689.js";
+import { Layer, unified, Schema, external_mdast_util_to_string_toString, remark_stringify, Effect, remark_gfm, Context } from "./855.js";
+import { GitHubApiError, VersionFilesSchema, ConfigurationError, remark_parse } from "./725.js";
+import { PositiveInteger, serializeDependencyTableToMarkdown } from "./891.js";
 import { resolveCommitType, fromHeading } from "./60.js";
 const REPO_PATTERN = /^[a-zA-Z0-9._-]+\/[a-zA-Z0-9._-]+$/;
 const RepoSchema = Schema.String.pipe(Schema.pattern(REPO_PATTERN, {
@@ -87,44 +88,44 @@ const MarkdownLive = Layer.succeed(MarkdownService, {
     parse: (content)=>Effect.sync(()=>parseMarkdown(content)),
     stringify: (tree)=>Effect.sync(()=>stringifyMarkdown(tree))
 });
-function logWarning(message, ...args) {
-    if ("u" > typeof process && process.env.VITEST) return;
-    if ("u" > typeof process && "true" === process.env.GITHUB_ACTIONS) {
-        const text = args.length > 0 ? `${message} ${args.join(" ")}` : message;
-        console.warn(`::warning::${text}`);
-    } else console.warn(message, ...args);
+const FIELD_MAP = [
+    [
+        "dependencies",
+        "dependency"
+    ],
+    [
+        "devDependencies",
+        "devDependency"
+    ],
+    [
+        "peerDependencies",
+        "peerDependency"
+    ],
+    [
+        "optionalDependencies",
+        "optionalDependency"
+    ]
+];
+function inferDependencyType(dep) {
+    const pkg = dep.packageJson;
+    for (const [field, type] of FIELD_MAP){
+        const section = pkg[field];
+        if ("object" == typeof section && null !== section && dep.name in section) return type;
+    }
+    return "dependency";
 }
-function getDependencyReleaseLine(changesets, dependenciesUpdated, options) {
+function getDependencyReleaseLine(_changesets, dependenciesUpdated, _options) {
     return Effect.gen(function*() {
         if (0 === dependenciesUpdated.length) return "";
-        const github = yield* GitHubService;
-        let apiFailures = 0;
-        const totalWithCommit = changesets.filter((cs)=>cs.commit).length;
-        const commitLinks = yield* Effect.forEach(changesets, (cs)=>{
-            const commit = cs.commit;
-            if (!commit) return Effect.succeed(null);
-            return github.getInfo({
-                commit,
-                repo: options.repo
-            }).pipe(Effect.map((info)=>info.links.commit), Effect.catchAll((error)=>{
-                apiFailures++;
-                logWarning(`Failed to fetch GitHub info for commit ${commit}:`, String(error));
-                return Effect.succeed(`[\`${commit.substring(0, 7)}\`](https://github.com/${options.repo}/commit/${commit})`);
+        yield* GitHubService;
+        const rows = dependenciesUpdated.map((dep)=>({
+                dependency: dep.name,
+                type: inferDependencyType(dep),
+                action: "updated",
+                from: dep.oldVersion,
+                to: dep.newVersion
             }));
-        }, {
-            concurrency: 10
-        });
-        if (apiFailures > 0) {
-            const successRate = ((totalWithCommit - apiFailures) / totalWithCommit * 100).toFixed(1);
-            logWarning(`GitHub API calls completed with ${apiFailures}/${totalWithCommit} failures (${successRate}% success rate)`);
-        }
-        const validLinks = commitLinks.filter(Boolean);
-        const changesetLink = validLinks.length > 0 ? `- Updated dependencies [${validLinks.join(", ")}]:` : "- Updated dependencies:";
-        const updatedDependenciesList = dependenciesUpdated.map((dep)=>`  - ${dep.name}@${dep.newVersion}`);
-        return [
-            changesetLink,
-            ...updatedDependenciesList
-        ].join("\n");
+        return serializeDependencyTableToMarkdown(rows);
     });
 }
 const MARKDOWN_LINK_PATTERN = /\[([^\]]+)\]\(([^)]+)\)/;
@@ -132,8 +133,6 @@ function extractUrlFromMarkdown(linkOrUrl) {
     const match = MARKDOWN_LINK_PATTERN.exec(linkOrUrl);
     return match ? match[2] : linkOrUrl;
 }
-const NonEmptyString = Schema.String.pipe(Schema.minLength(1));
-const PositiveInteger = Schema.Number.pipe(Schema.int(), Schema.positive());
 function isValidUrl(value) {
     try {
         new URL(value);
@@ -202,6 +201,13 @@ function parseIssueReferences(commitMessage) {
         refs: extractIssueNumbers(REFS_ISSUE_PATTERN, commitMessage)
     };
 }
+function logWarning(message, ...args) {
+    if ("u" > typeof process && process.env.VITEST) return;
+    if ("u" > typeof process && "true" === process.env.GITHUB_ACTIONS) {
+        const text = args.length > 0 ? `${message} ${args.join(" ")}` : message;
+        console.warn(`::warning::${text}`);
+    } else console.warn(message, ...args);
+}
 function parseChangesetSections(summary) {
     const tree = parseMarkdown(summary);
     const h2Indices = [];
@@ -368,4 +374,4 @@ const changelogFunctions = {
 };
 const changelog = changelogFunctions;
 export default changelog;
-export { ChangesetOptionsSchema, GitHubInfoSchema, GitHubLive, GitHubService, GitHubServiceBase, IssueNumberSchema, MarkdownLive, MarkdownService, MarkdownServiceBase, NonEmptyString, PositiveInteger, RepoSchema, UrlOrMarkdownLinkSchema, UsernameSchema, makeGitHubTest };
+export { ChangesetOptionsSchema, GitHubInfoSchema, GitHubLive, GitHubService, GitHubServiceBase, IssueNumberSchema, MarkdownLive, MarkdownService, MarkdownServiceBase, RepoSchema, UrlOrMarkdownLinkSchema, UsernameSchema, makeGitHubTest };

package/esm/260.js

@@ -3,6 +3,7 @@ const RULE_DOCS = {
     CSH001: `${DOCS_BASE}/CSH001.md`,
     CSH002: `${DOCS_BASE}/CSH002.md`,
     CSH003: `${DOCS_BASE}/CSH003.md`,
-    CSH004: `${DOCS_BASE}/CSH004.md`
+    CSH004: `${DOCS_BASE}/CSH004.md`,
+    CSH005: `${DOCS_BASE}/CSH005.md`
 };
 export { RULE_DOCS };

package/esm/273.js

@@ -1,6 +1,7 @@
 import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
 import { join, relative, resolve } from "node:path";
-import { unified, remark_gfm, remark_stringify, remark_parse } from "./795.js";
+import { remark_parse } from "./725.js";
+import { unified, remark_stringify, remark_gfm } from "./855.js";
 import { UncategorizedContentRule, MergeSectionsPlugin, DeduplicateItemsPlugin, IssueLinkRefsPlugin, ContentStructureRule, HeadingHierarchyRule, NormalizeFormatPlugin, ReorderSectionsPlugin, ContributorFootnotesPlugin, RequiredSectionsRule } from "./622.js";
 function stripFrontmatter(content) {
     return content.replace(/^---\n[\s\S]*?\n---\n?/, "");

package/esm/622.js

@@ -1,6 +1,6 @@
 import { lintRule } from "unified-lint-rule";
 import { SKIP, visit } from "unist-util-visit";
-import { external_mdast_util_to_string_toString } from "./689.js";
+import { external_mdast_util_to_string_toString } from "./855.js";
 import { RULE_DOCS } from "./260.js";
 import { isValidHeading, fromHeading, allHeadings } from "./60.js";
 const ContentStructureRule = lintRule("remark-lint:changeset-content-structure", (tree, file)=>{
@@ -348,4 +348,4 @@ const ReorderSectionsPlugin = ()=>(tree)=>{
             tree.children.splice(block.startIndex, blockLength, ...newChildren);
         }
     };
-export { ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, HeadingHierarchyRule, IssueLinkRefsPlugin, MergeSectionsPlugin, NormalizeFormatPlugin, ReorderSectionsPlugin, RequiredSectionsRule, UncategorizedContentRule };
+export { ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, HeadingHierarchyRule, IssueLinkRefsPlugin, MergeSectionsPlugin, NormalizeFormatPlugin, ReorderSectionsPlugin, RequiredSectionsRule, UncategorizedContentRule, getBlockSections, getHeadingText, getVersionBlocks, lintRule, visit };

package/esm/{795.js → 725.js}

@@ -1,4 +1,4 @@
-import { Context, Data, Effect, Layer, Schema } from "effect";
+import { Data, Schema } from "./855.js";
 const ChangesetValidationErrorBase = Data.TaggedError("ChangesetValidationError");
 class ChangesetValidationError extends ChangesetValidationErrorBase {
     get message() {
@@ -49,8 +49,5 @@ const VersionFileConfigSchema = Schema.Struct({
     paths: Schema.optional(Schema.Array(JsonPathSchema))
 });
 const VersionFilesSchema = Schema.Array(VersionFileConfigSchema);
-export { default as remark_gfm } from "remark-gfm";
 export { default as remark_parse } from "remark-parse";
-export { default as remark_stringify } from "remark-stringify";
-export { unified } from "unified";
-export { ChangesetValidationError, ChangesetValidationErrorBase, ConfigurationError, ConfigurationErrorBase, Context, Data, Effect, GitHubApiError, GitHubApiErrorBase, JsonPathSchema, Layer, MarkdownParseError, MarkdownParseErrorBase, Schema, VersionFileConfigSchema, VersionFileError, VersionFileErrorBase, VersionFilesSchema };
+export { ChangesetValidationError, ChangesetValidationErrorBase, ConfigurationError, ConfigurationErrorBase, GitHubApiError, GitHubApiErrorBase, JsonPathSchema, MarkdownParseError, MarkdownParseErrorBase, VersionFileConfigSchema, VersionFileError, VersionFileErrorBase, VersionFilesSchema };

package/esm/855.js

@@ -0,0 +1,5 @@
+export { Context, Data, Effect, Layer, Schema } from "effect";
+export { default as remark_gfm } from "remark-gfm";
+export { default as remark_stringify } from "remark-stringify";
+export { unified } from "unified";
+export { toString as external_mdast_util_to_string_toString } from "mdast-util-to-string";

package/esm/891.js

@@ -0,0 +1,147 @@
+import { external_mdast_util_to_string_toString, unified, Schema, remark_gfm, remark_stringify } from "./855.js";
+const NonEmptyString = Schema.String.pipe(Schema.minLength(1));
+const PositiveInteger = Schema.Number.pipe(Schema.int(), Schema.positive());
+const DependencyActionSchema = Schema.Literal("added", "updated", "removed");
+const DependencyTableTypeSchema = Schema.Literal("dependency", "devDependency", "peerDependency", "optionalDependency", "workspace", "config");
+const VersionOrEmptySchema = Schema.String.pipe(Schema.pattern(/^(\u2014|[~^]?\d+\.\d+\.\d+(?:[-+.][\w.+-]*)?)$/));
+const DependencyTableRowSchema = Schema.Struct({
+    dependency: NonEmptyString,
+    type: DependencyTableTypeSchema,
+    action: DependencyActionSchema,
+    from: VersionOrEmptySchema,
+    to: VersionOrEmptySchema
+});
+const DependencyTableSchema = Schema.Array(DependencyTableRowSchema).pipe(Schema.minItems(1));
+const COLUMN_HEADERS = [
+    "Dependency",
+    "Type",
+    "Action",
+    "From",
+    "To"
+];
+const COLUMN_KEYS = [
+    "dependency",
+    "type",
+    "action",
+    "from",
+    "to"
+];
+const decode = Schema.decodeUnknownSync(DependencyTableRowSchema);
+function parseDependencyTable(table) {
+    const rows = table.children;
+    if (rows.length < 2) throw new Error("Dependency table must have at least one data row");
+    const headerRow = rows[0];
+    const headers = headerRow.children.map((cell)=>external_mdast_util_to_string_toString(cell).trim().toLowerCase());
+    const expected = COLUMN_HEADERS.map((h)=>h.toLowerCase());
+    if (headers.length !== expected.length || !headers.every((h, i)=>h === expected[i])) throw new Error(`Table must have columns: ${COLUMN_HEADERS.join(", ")}. Got: ${headers.join(", ")}`);
+    const result = [];
+    for(let i = 1; i < rows.length; i++){
+        const cells = rows[i].children;
+        const raw = {};
+        for(let c = 0; c < COLUMN_KEYS.length; c++)raw[COLUMN_KEYS[c]] = external_mdast_util_to_string_toString(cells[c]).trim();
+        result.push(decode(raw));
+    }
+    return result;
+}
+function makeCell(text) {
+    return {
+        type: "tableCell",
+        children: [
+            {
+                type: "text",
+                value: text
+            }
+        ]
+    };
+}
+function makeRow(texts) {
+    return {
+        type: "tableRow",
+        children: texts.map(makeCell)
+    };
+}
+function serializeDependencyTable(rows) {
+    const headerRow = makeRow([
+        ...COLUMN_HEADERS
+    ]);
+    const dataRows = rows.map((row)=>makeRow(COLUMN_KEYS.map((key)=>row[key])));
+    return {
+        type: "table",
+        children: [
+            headerRow,
+            ...dataRows
+        ]
+    };
+}
+function serializeDependencyTableToMarkdown(rows) {
+    const table = serializeDependencyTable(rows);
+    const tree = {
+        type: "root",
+        children: [
+            table
+        ]
+    };
+    return unified().use(remark_gfm).use(remark_stringify).stringify(tree).trim();
+}
+const ACTION_ORDER = {
+    removed: 0,
+    updated: 1,
+    added: 2
+};
+function collapseDependencyRows(rows) {
+    const groups = new Map();
+    for (const row of rows){
+        const key = `${row.dependency}\0${row.type}`;
+        const existing = groups.get(key);
+        if (!existing) {
+            groups.set(key, {
+                ...row
+            });
+            continue;
+        }
+        const merged = collapseTwo(existing, row);
+        if (null === merged) groups.delete(key);
+        else groups.set(key, merged);
+    }
+    return [
+        ...groups.values()
+    ];
+}
+function collapseTwo(first, second) {
+    const a = first.action;
+    const b = second.action;
+    if ("updated" === a && "updated" === b) return {
+        ...first,
+        to: second.to
+    };
+    if ("added" === a && "updated" === b) return {
+        ...first,
+        to: second.to
+    };
+    if ("added" === a && "removed" === b) return null;
+    if ("updated" === a && "removed" === b) return {
+        ...first,
+        action: "removed",
+        to: "\u2014"
+    };
+    if ("removed" === a && "added" === b) return {
+        ...first,
+        action: "updated",
+        to: second.to
+    };
+    return {
+        ...second
+    };
+}
+function sortDependencyRows(rows) {
+    return [
+        ...rows
+    ].sort((a, b)=>{
+        const actionDiff = (ACTION_ORDER[a.action] ?? 99) - (ACTION_ORDER[b.action] ?? 99);
+        if (0 !== actionDiff) return actionDiff;
+        const typeDiff = a.type.localeCompare(b.type);
+        if (0 !== typeDiff) return typeDiff;
+        return a.dependency.localeCompare(b.dependency);
+    });
+}
+export { DependencyActionSchema, DependencyTableRowSchema, DependencyTableSchema, DependencyTableTypeSchema, NonEmptyString, PositiveInteger, VersionOrEmptySchema, collapseDependencyRows, parseDependencyTable, serializeDependencyTable, serializeDependencyTableToMarkdown, sortDependencyRows };

package/esm/bin/savvy-changesets.js

@@ -6,7 +6,8 @@ import { applyEdits, modify, parse } from "jsonc-parser";
 import { findProjectRoot, getWorkspaceInfos } from "workspace-tools";
 import { globSync } from "tinyglobby";
 import { readFileSync, ChangelogTransformer, ChangesetLinter, resolve, existsSync, relative, mkdirSync, writeFileSync, join } from "../273.js";
-import { VersionFilesSchema, Schema, VersionFileError, Data, Effect } from "../795.js";
+import { Effect, Schema, Data } from "../855.js";
+import { VersionFileError, VersionFilesSchema } from "../725.js";
 const dirArg = Args.directory({
     name: "dir"
 }).pipe(Args.withDefault(".changeset"));
@@ -49,7 +50,8 @@ const RULE_NAMES = [
     "changeset-heading-hierarchy",
     "changeset-required-sections",
     "changeset-content-structure",
-    "changeset-uncategorized-content"
+    "changeset-uncategorized-content",
+    "changeset-dependency-table-format"
 ];
 const DEFAULT_CONFIG = {
     $schema: "https://unpkg.com/@changesets/config@3.1.1/schema.json",
@@ -785,7 +787,7 @@ const rootCommand = Command.make("savvy-changesets").pipe(Command.withSubcommand
 ]));
 const cli = Command.run(rootCommand, {
     name: "savvy-changesets",
-    version: "0.4.2"
+    version: "0.5.0"
 });
 function runCli() {
     const main = Effect.suspend(()=>cli(process.argv)).pipe(Effect.provide(NodeContext.layer));

package/esm/changelog.d.ts

@@ -1,8 +1,22 @@
 /**
- * Changesets API changelog formatter.
+ * Changesets API changelog formatter — `\@savvy-web/changesets/changelog`
  *
- * This module exports the `ChangelogFunctions` required by the Changesets API.
- * Configure in `.changeset/config.json`:
+ * This module is the default export consumed by the Changesets CLI via the
+ * `changelog` field in `.changeset/config.json`. It implements the
+ * `ChangelogFunctions` interface from `\@changesets/types`, wiring the
+ * Effect-based formatting pipeline into the async API that Changesets expects.
+ *
+ * @remarks
+ * The module composes two Effect programs — {@link getReleaseLine} and
+ * {@link getDependencyReleaseLine} — and runs each through
+ * `Effect.runPromise` with a merged layer of {@link GitHubLive} (for commit
+ * metadata) and {@link MarkdownLive} (for mdast parsing). Options are
+ * validated at the boundary via `validateChangesetOptions` before being
+ * passed to the formatters.
+ *
+ * ### Configuration
+ *
+ * Add the following to your `.changeset/config.json`:
  *
  * ```json
  * {
@@ -10,11 +24,46 @@
  * }
  * ```
  *
+ * The `repo` option is **required** and must be in `owner/repo` format.
+ *
+ * ### Pipeline
+ *
+ * 1. **Options validation** — the raw `options` object from the Changesets
+ *    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.
+ * 3. **Dependency table formatting** — bulk dependency updates are
+ *    formatted by `getDependencyReleaseLine` into a markdown table.
+ *
+ * @example Configuring in `.changeset/config.json`
+ * ```json
+ * {
+ *   "$schema": "https://unpkg.com/\@changesets/config\@3.1.1/schema.json",
+ *   "changelog": ["\@savvy-web/changesets/changelog", { "repo": "savvy-web/my-package" }],
+ *   "commit": false,
+ *   "access": "public"
+ * }
+ * ```
+ *
+ * @see {@link getReleaseLine} in `./getReleaseLine.ts` for individual changeset formatting
+ * @see {@link getDependencyReleaseLine} in `./getDependencyReleaseLine.ts` for dependency table formatting
+ *
  * @packageDocumentation
  */
 
 import { ChangelogFunctions } from '@changesets/types';
 
+/**
+ * Changesets API `ChangelogFunctions` implementation.
+ *
+ * This object satisfies the `ChangelogFunctions` contract from
+ * `\@changesets/types`. Each method validates options, runs the
+ * corresponding Effect program with the merged service layer, and
+ * returns a `Promise<string>`.
+ *
+ * @internal
+ */
 declare const changelogFunctions: ChangelogFunctions;
 export default changelogFunctions;