@savvy-web/silk 2.0.0 → 2.1.0

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

@@ -1,134 +0,0 @@
-const require_index = require('../changelog/index.cjs');
-
-//#region ../silk-effects/dist/dev/pkg/changesets/api/changelog.js
-/**
-* Class-based API wrapper for changelog formatting.
-*
-* Provides a static class interface that delegates to the underlying
-* Changesets API-compatible default export.
-*
-* @internal
-*/
-/**
-* Static class wrapper for changelog formatting operations.
-*
-* Delegates to the Changesets-compatible `getReleaseLine` and
-* `getDependencyReleaseLine` functions. Internally, these use the
-* {@link ChangelogService} Effect service layer, which coordinates
-* the {@link GitHubService} (for commit/PR metadata) and
-* {@link MarkdownService} (for AST manipulation) to produce
-* structured changelog entries.
-*
-* @remarks
-* This class provides the same formatting capabilities as the
-* `\@savvy-web/changesets/changelog` subpath export, but through a
-* class-based API rather than the Changesets default-export convention.
-* The underlying formatter parses conventional commit prefixes from the
-* changeset summary to determine the section category (via
-* {@link Categories}), resolves GitHub metadata (authors, PR links,
-* commit hashes), and produces markdown output grouped by category.
-*
-* The `options` parameter must include a `repo` field in `"owner/repo"`
-* format (e.g., `"savvy-web/changesets"`) so that GitHub links can be
-* constructed. Additional options are defined by {@link ChangesetOptionsSchema}.
-*
-* @example Formatting a single changeset release line
-* ```typescript
-* import { Changelog } from "\@savvy-web/changesets";
-*
-* const changeset = {
-*   id: "brave-pandas-learn",
-*   summary: "feat: add token refresh endpoint",
-*   releases: [{ name: "\@savvy-web/auth", type: "minor" as const }],
-*   commit: "abc1234567890abcdef1234567890abcdef123456",
-* };
-*
-* const line: string = await Changelog.formatReleaseLine(changeset, "minor", {
-*   repo: "savvy-web/auth",
-* });
-* // line contains a markdown bullet under the "Features" section heading
-* ```
-*
-* @example Formatting dependency update lines
-* ```typescript
-* import { Changelog } from "\@savvy-web/changesets";
-*
-* const changesets = [
-*   {
-*     id: "cool-dogs-fly",
-*     summary: "chore(deps): update effect to 3.20.0",
-*     releases: [{ name: "\@savvy-web/core", type: "patch" as const }],
-*     commit: "def4567890abcdef1234567890abcdef456789ab",
-*   },
-* ];
-*
-* const dependenciesUpdated = [
-*   {
-*     name: "\@savvy-web/utils",
-*     type: "patch" as const,
-*     oldVersion: "1.2.0",
-*     newVersion: "1.2.1",
-*     changesets: ["cool-dogs-fly"],
-*     packageJson: { name: "\@savvy-web/utils", version: "1.2.1" },
-*   },
-* ];
-*
-* const depLines: string = await Changelog.formatDependencyReleaseLine(
-*   changesets,
-*   dependenciesUpdated,
-*   { repo: "savvy-web/core" },
-* );
-* // depLines contains a markdown table of dependency changes
-* ```
-*
-* @see {@link ChangelogService} for the underlying Effect service
-* @see {@link Categories} for how commit types map to section headings
-* @see {@link ChangesetOptionsSchema} for the full options schema
-*
-* @public
-*/
-var Changelog = class {
-	/* v8 ignore next -- private constructor prevents direct instantiation */
-	constructor() {}
-	/**
-	* Format a single changeset into a changelog release line.
-	*
-	* @remarks
-	* Parses the changeset summary for a conventional commit prefix
-	* (e.g., `"feat: ..."`, `"fix!: ..."`), resolves the corresponding
-	* {@link SectionCategory}, and produces a markdown bullet item with
-	* optional GitHub metadata (author, PR link, commit hash).
-	*
-	* @param changeset - The changeset to format, including its `id`, `summary`,
-	*   `releases` array, and optional `commit` hash
-	* @param versionType - The semantic version bump type (`"major"`, `"minor"`, or `"patch"`)
-	* @param options - Configuration object; must include `repo` in `"owner/repo"` format.
-	*   Pass `null` to use defaults (no GitHub link resolution).
-	* @returns A promise resolving to the formatted markdown string
-	*/
-	static async formatReleaseLine(changeset, versionType, options) {
-		return require_index.default.getReleaseLine(changeset, versionType, options);
-	}
-	/**
-	* Format dependency update release lines into a markdown table.
-	*
-	* @remarks
-	* Generates a structured dependency table showing package names,
-	* version transitions, and dependency types. The table is placed
-	* under the "Dependencies" section heading in the changelog.
-	*
-	* @param changesets - The changesets that triggered the dependency updates
-	* @param dependenciesUpdated - Array of updated dependencies with their
-	*   old/new versions and package metadata
-	* @param options - Configuration object; must include `repo` in `"owner/repo"` format.
-	*   Pass `null` to use defaults.
-	* @returns A promise resolving to the formatted markdown string containing
-	*   the dependency update table
-	*/
-	static async formatDependencyReleaseLine(changesets, dependenciesUpdated, options) {
-		return require_index.default.getDependencyReleaseLine(changesets, dependenciesUpdated, options);
-	}
-};
-
-//#endregion
-exports.Changelog = Changelog;

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

@@ -1,134 +0,0 @@
-import changelogFunctions from "../changelog/index.js";
-
-//#region ../silk-effects/dist/dev/pkg/changesets/api/changelog.js
-/**
-* Class-based API wrapper for changelog formatting.
-*
-* Provides a static class interface that delegates to the underlying
-* Changesets API-compatible default export.
-*
-* @internal
-*/
-/**
-* Static class wrapper for changelog formatting operations.
-*
-* Delegates to the Changesets-compatible `getReleaseLine` and
-* `getDependencyReleaseLine` functions. Internally, these use the
-* {@link ChangelogService} Effect service layer, which coordinates
-* the {@link GitHubService} (for commit/PR metadata) and
-* {@link MarkdownService} (for AST manipulation) to produce
-* structured changelog entries.
-*
-* @remarks
-* This class provides the same formatting capabilities as the
-* `\@savvy-web/changesets/changelog` subpath export, but through a
-* class-based API rather than the Changesets default-export convention.
-* The underlying formatter parses conventional commit prefixes from the
-* changeset summary to determine the section category (via
-* {@link Categories}), resolves GitHub metadata (authors, PR links,
-* commit hashes), and produces markdown output grouped by category.
-*
-* The `options` parameter must include a `repo` field in `"owner/repo"`
-* format (e.g., `"savvy-web/changesets"`) so that GitHub links can be
-* constructed. Additional options are defined by {@link ChangesetOptionsSchema}.
-*
-* @example Formatting a single changeset release line
-* ```typescript
-* import { Changelog } from "\@savvy-web/changesets";
-*
-* const changeset = {
-*   id: "brave-pandas-learn",
-*   summary: "feat: add token refresh endpoint",
-*   releases: [{ name: "\@savvy-web/auth", type: "minor" as const }],
-*   commit: "abc1234567890abcdef1234567890abcdef123456",
-* };
-*
-* const line: string = await Changelog.formatReleaseLine(changeset, "minor", {
-*   repo: "savvy-web/auth",
-* });
-* // line contains a markdown bullet under the "Features" section heading
-* ```
-*
-* @example Formatting dependency update lines
-* ```typescript
-* import { Changelog } from "\@savvy-web/changesets";
-*
-* const changesets = [
-*   {
-*     id: "cool-dogs-fly",
-*     summary: "chore(deps): update effect to 3.20.0",
-*     releases: [{ name: "\@savvy-web/core", type: "patch" as const }],
-*     commit: "def4567890abcdef1234567890abcdef456789ab",
-*   },
-* ];
-*
-* const dependenciesUpdated = [
-*   {
-*     name: "\@savvy-web/utils",
-*     type: "patch" as const,
-*     oldVersion: "1.2.0",
-*     newVersion: "1.2.1",
-*     changesets: ["cool-dogs-fly"],
-*     packageJson: { name: "\@savvy-web/utils", version: "1.2.1" },
-*   },
-* ];
-*
-* const depLines: string = await Changelog.formatDependencyReleaseLine(
-*   changesets,
-*   dependenciesUpdated,
-*   { repo: "savvy-web/core" },
-* );
-* // depLines contains a markdown table of dependency changes
-* ```
-*
-* @see {@link ChangelogService} for the underlying Effect service
-* @see {@link Categories} for how commit types map to section headings
-* @see {@link ChangesetOptionsSchema} for the full options schema
-*
-* @public
-*/
-var Changelog = class {
-	/* v8 ignore next -- private constructor prevents direct instantiation */
-	constructor() {}
-	/**
-	* Format a single changeset into a changelog release line.
-	*
-	* @remarks
-	* Parses the changeset summary for a conventional commit prefix
-	* (e.g., `"feat: ..."`, `"fix!: ..."`), resolves the corresponding
-	* {@link SectionCategory}, and produces a markdown bullet item with
-	* optional GitHub metadata (author, PR link, commit hash).
-	*
-	* @param changeset - The changeset to format, including its `id`, `summary`,
-	*   `releases` array, and optional `commit` hash
-	* @param versionType - The semantic version bump type (`"major"`, `"minor"`, or `"patch"`)
-	* @param options - Configuration object; must include `repo` in `"owner/repo"` format.
-	*   Pass `null` to use defaults (no GitHub link resolution).
-	* @returns A promise resolving to the formatted markdown string
-	*/
-	static async formatReleaseLine(changeset, versionType, options) {
-		return changelogFunctions.getReleaseLine(changeset, versionType, options);
-	}
-	/**
-	* Format dependency update release lines into a markdown table.
-	*
-	* @remarks
-	* Generates a structured dependency table showing package names,
-	* version transitions, and dependency types. The table is placed
-	* under the "Dependencies" section heading in the changelog.
-	*
-	* @param changesets - The changesets that triggered the dependency updates
-	* @param dependenciesUpdated - Array of updated dependencies with their
-	*   old/new versions and package metadata
-	* @param options - Configuration object; must include `repo` in `"owner/repo"` format.
-	*   Pass `null` to use defaults.
-	* @returns A promise resolving to the formatted markdown string containing
-	*   the dependency update table
-	*/
-	static async formatDependencyReleaseLine(changesets, dependenciesUpdated, options) {
-		return changelogFunctions.getDependencyReleaseLine(changesets, dependenciesUpdated, options);
-	}
-};
-
-//#endregion
-export { Changelog };

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

@@ -1,163 +0,0 @@
-const require_dependency_table = require('../utils/dependency-table.cjs');
-
-//#region ../silk-effects/dist/dev/pkg/changesets/api/dependency-table.js
-/**
-* Static class for dependency table manipulation.
-*
-* Wraps the internal utility functions that operate on dependency tables --
-* the structured markdown tables that appear in the "Dependencies" section
-* of changelogs. Each row in a dependency table represents a single package
-* change with its name, type, action, and version transition.
-*
-* @remarks
-* The typical workflow for processing dependency tables is:
-*
-* 1. **Parse** an mdast `Table` node into typed {@link DependencyTableRow} objects
-* 2. **Collapse** duplicate rows (same package updated multiple times) into single entries
-* 3. **Sort** rows by dependency type, then alphabetically by package name
-* 4. **Serialize** back to an mdast `Table` node or directly to a markdown string
-*
-* The {@link DependencyTable.aggregate} method combines the collapse and sort
-* steps into a single call, which is the most common usage pattern.
-*
-* Each {@link DependencyTableRow} is validated by the {@link DependencyTableRowSchema}
-* Effect Schema at system boundaries, ensuring that dependency names, types,
-* actions, and version strings conform to expected formats.
-*
-* @example Parse, aggregate, and serialize a dependency table
-* ```typescript
-* import { DependencyTable } from "\@savvy-web/changesets";
-* import type { DependencyTableRow } from "\@savvy-web/changesets";
-* import type { Table } from "mdast";
-*
-* // Given an mdast Table node from a parsed CHANGELOG
-* declare const tableNode: Table;
-*
-* // Parse into typed rows
-* const rows: DependencyTableRow[] = DependencyTable.parse(tableNode);
-*
-* // Collapse duplicates and sort by type, then name
-* const aggregated: DependencyTableRow[] = DependencyTable.aggregate(rows);
-*
-* // Serialize back to an mdast Table node for further AST manipulation
-* const outputNode: Table = DependencyTable.serialize(aggregated);
-*
-* // Or serialize directly to a markdown string
-* const markdown: string = DependencyTable.toMarkdown(aggregated);
-* ```
-*
-* @example Step-by-step collapse and sort
-* ```typescript
-* import { DependencyTable } from "\@savvy-web/changesets";
-* import type { DependencyTableRow } from "\@savvy-web/changesets";
-*
-* declare const rows: DependencyTableRow[];
-*
-* // Collapse duplicate entries (same package appears multiple times)
-* const collapsed: DependencyTableRow[] = DependencyTable.collapse(rows);
-*
-* // Sort by dependency type, then alphabetically by name
-* const sorted: DependencyTableRow[] = DependencyTable.sort(collapsed);
-* ```
-*
-* @see {@link DependencyTableRow} for the row shape (dependency, type, action, from, to)
-* @see {@link DependencyTableRowSchema} for the Effect Schema that validates row data
-* @see {@link DependencyTableSchema} for the non-empty array schema
-*
-* @public
-*/
-var DependencyTable = class {
-	/* v8 ignore next -- private constructor prevents direct instantiation */
-	constructor() {}
-	/**
-	* Parse an mdast `Table` node into typed dependency table rows.
-	*
-	* @remarks
-	* Extracts the text content from each table cell and maps it to the
-	* corresponding {@link DependencyTableRow} fields. The first row is
-	* treated as the header and skipped. Rows that do not have the expected
-	* number of columns are ignored.
-	*
-	* @param tableNode - An mdast `Table` node from a parsed markdown AST
-	* @returns Array of {@link DependencyTableRow} objects, one per data row
-	*/
-	static parse(tableNode) {
-		return require_dependency_table.parseDependencyTable(tableNode);
-	}
-	/**
-	* Serialize typed dependency table rows into an mdast `Table` node.
-	*
-	* @remarks
-	* Produces a well-formed mdast `Table` with a header row
-	* (`Dependency | Type | Action | From | To`) followed by one data row
-	* per input entry. The resulting node can be inserted into a remark AST
-	* for further processing or stringification.
-	*
-	* @param rows - Array of {@link DependencyTableRow} objects to serialize
-	* @returns An mdast `Table` node ready for AST insertion
-	*/
-	static serialize(rows) {
-		return require_dependency_table.serializeDependencyTable(rows);
-	}
-	/**
-	* Serialize typed dependency table rows directly to a markdown string.
-	*
-	* @remarks
-	* Convenience method that combines {@link DependencyTable.serialize} with
-	* remark stringification. Produces a GFM-compatible markdown table string.
-	*
-	* @param rows - Array of {@link DependencyTableRow} objects to render
-	* @returns A markdown string containing the formatted table
-	*/
-	static toMarkdown(rows) {
-		return require_dependency_table.serializeDependencyTableToMarkdown(rows);
-	}
-	/**
-	* Collapse duplicate dependency rows into single entries.
-	*
-	* @remarks
-	* When a package appears in multiple rows (e.g., updated in separate
-	* changesets), this method merges them by keeping the earliest `from`
-	* version and the latest `to` version, producing a single row that
-	* represents the net change.
-	*
-	* @param rows - Array of {@link DependencyTableRow} objects, possibly with duplicates
-	* @returns A new array with duplicate packages collapsed into single rows
-	*/
-	static collapse(rows) {
-		return require_dependency_table.collapseDependencyRows(rows);
-	}
-	/**
-	* Sort dependency rows by action, type, and package name.
-	*
-	* @remarks
-	* Applies a three-level stable sort:
-	* 1. **Action** — `removed` first, then `updated`, then `added`
-	* 2. **Type** — alphabetically (e.g., `config` before `dependency`)
-	* 3. **Dependency name** — alphabetically within each action+type group
-	*
-	* @param rows - Array of {@link DependencyTableRow} objects to sort
-	* @returns A new array sorted by action, type, then name
-	*/
-	static sort(rows) {
-		return require_dependency_table.sortDependencyRows(rows);
-	}
-	/**
-	* Collapse duplicate rows and then sort the result.
-	*
-	* @remarks
-	* Equivalent to calling {@link DependencyTable.collapse} followed by
-	* {@link DependencyTable.sort}. This is the recommended method for
-	* preparing dependency table data for final output, as it produces
-	* a clean, deduplicated, and consistently ordered table.
-	*
-	* @param rows - Array of {@link DependencyTableRow} objects to aggregate
-	* @returns A new array with duplicates collapsed and rows sorted
-	*/
-	static aggregate(rows) {
-		return require_dependency_table.sortDependencyRows(require_dependency_table.collapseDependencyRows(rows));
-	}
-};
-
-//#endregion
-exports.DependencyTable = DependencyTable;

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

@@ -1,163 +0,0 @@
-import { collapseDependencyRows, parseDependencyTable, serializeDependencyTable, serializeDependencyTableToMarkdown, sortDependencyRows } from "../utils/dependency-table.js";
-
-//#region ../silk-effects/dist/dev/pkg/changesets/api/dependency-table.js
-/**
-* Static class for dependency table manipulation.
-*
-* Wraps the internal utility functions that operate on dependency tables --
-* the structured markdown tables that appear in the "Dependencies" section
-* of changelogs. Each row in a dependency table represents a single package
-* change with its name, type, action, and version transition.
-*
-* @remarks
-* The typical workflow for processing dependency tables is:
-*
-* 1. **Parse** an mdast `Table` node into typed {@link DependencyTableRow} objects
-* 2. **Collapse** duplicate rows (same package updated multiple times) into single entries
-* 3. **Sort** rows by dependency type, then alphabetically by package name
-* 4. **Serialize** back to an mdast `Table` node or directly to a markdown string
-*
-* The {@link DependencyTable.aggregate} method combines the collapse and sort
-* steps into a single call, which is the most common usage pattern.
-*
-* Each {@link DependencyTableRow} is validated by the {@link DependencyTableRowSchema}
-* Effect Schema at system boundaries, ensuring that dependency names, types,
-* actions, and version strings conform to expected formats.
-*
-* @example Parse, aggregate, and serialize a dependency table
-* ```typescript
-* import { DependencyTable } from "\@savvy-web/changesets";
-* import type { DependencyTableRow } from "\@savvy-web/changesets";
-* import type { Table } from "mdast";
-*
-* // Given an mdast Table node from a parsed CHANGELOG
-* declare const tableNode: Table;
-*
-* // Parse into typed rows
-* const rows: DependencyTableRow[] = DependencyTable.parse(tableNode);
-*
-* // Collapse duplicates and sort by type, then name
-* const aggregated: DependencyTableRow[] = DependencyTable.aggregate(rows);
-*
-* // Serialize back to an mdast Table node for further AST manipulation
-* const outputNode: Table = DependencyTable.serialize(aggregated);
-*
-* // Or serialize directly to a markdown string
-* const markdown: string = DependencyTable.toMarkdown(aggregated);
-* ```
-*
-* @example Step-by-step collapse and sort
-* ```typescript
-* import { DependencyTable } from "\@savvy-web/changesets";
-* import type { DependencyTableRow } from "\@savvy-web/changesets";
-*
-* declare const rows: DependencyTableRow[];
-*
-* // Collapse duplicate entries (same package appears multiple times)
-* const collapsed: DependencyTableRow[] = DependencyTable.collapse(rows);
-*
-* // Sort by dependency type, then alphabetically by name
-* const sorted: DependencyTableRow[] = DependencyTable.sort(collapsed);
-* ```
-*
-* @see {@link DependencyTableRow} for the row shape (dependency, type, action, from, to)
-* @see {@link DependencyTableRowSchema} for the Effect Schema that validates row data
-* @see {@link DependencyTableSchema} for the non-empty array schema
-*
-* @public
-*/
-var DependencyTable = class {
-	/* v8 ignore next -- private constructor prevents direct instantiation */
-	constructor() {}
-	/**
-	* Parse an mdast `Table` node into typed dependency table rows.
-	*
-	* @remarks
-	* Extracts the text content from each table cell and maps it to the
-	* corresponding {@link DependencyTableRow} fields. The first row is
-	* treated as the header and skipped. Rows that do not have the expected
-	* number of columns are ignored.
-	*
-	* @param tableNode - An mdast `Table` node from a parsed markdown AST
-	* @returns Array of {@link DependencyTableRow} objects, one per data row
-	*/
-	static parse(tableNode) {
-		return parseDependencyTable(tableNode);
-	}
-	/**
-	* Serialize typed dependency table rows into an mdast `Table` node.
-	*
-	* @remarks
-	* Produces a well-formed mdast `Table` with a header row
-	* (`Dependency | Type | Action | From | To`) followed by one data row
-	* per input entry. The resulting node can be inserted into a remark AST
-	* for further processing or stringification.
-	*
-	* @param rows - Array of {@link DependencyTableRow} objects to serialize
-	* @returns An mdast `Table` node ready for AST insertion
-	*/
-	static serialize(rows) {
-		return serializeDependencyTable(rows);
-	}
-	/**
-	* Serialize typed dependency table rows directly to a markdown string.
-	*
-	* @remarks
-	* Convenience method that combines {@link DependencyTable.serialize} with
-	* remark stringification. Produces a GFM-compatible markdown table string.
-	*
-	* @param rows - Array of {@link DependencyTableRow} objects to render
-	* @returns A markdown string containing the formatted table
-	*/
-	static toMarkdown(rows) {
-		return serializeDependencyTableToMarkdown(rows);
-	}
-	/**
-	* Collapse duplicate dependency rows into single entries.
-	*
-	* @remarks
-	* When a package appears in multiple rows (e.g., updated in separate
-	* changesets), this method merges them by keeping the earliest `from`
-	* version and the latest `to` version, producing a single row that
-	* represents the net change.
-	*
-	* @param rows - Array of {@link DependencyTableRow} objects, possibly with duplicates
-	* @returns A new array with duplicate packages collapsed into single rows
-	*/
-	static collapse(rows) {
-		return collapseDependencyRows(rows);
-	}
-	/**
-	* Sort dependency rows by action, type, and package name.
-	*
-	* @remarks
-	* Applies a three-level stable sort:
-	* 1. **Action** — `removed` first, then `updated`, then `added`
-	* 2. **Type** — alphabetically (e.g., `config` before `dependency`)
-	* 3. **Dependency name** — alphabetically within each action+type group
-	*
-	* @param rows - Array of {@link DependencyTableRow} objects to sort
-	* @returns A new array sorted by action, type, then name
-	*/
-	static sort(rows) {
-		return sortDependencyRows(rows);
-	}
-	/**
-	* Collapse duplicate rows and then sort the result.
-	*
-	* @remarks
-	* Equivalent to calling {@link DependencyTable.collapse} followed by
-	* {@link DependencyTable.sort}. This is the recommended method for
-	* preparing dependency table data for final output, as it produces
-	* a clean, deduplicated, and consistently ordered table.
-	*
-	* @param rows - Array of {@link DependencyTableRow} objects to aggregate
-	* @returns A new array with duplicates collapsed and rows sorted
-	*/
-	static aggregate(rows) {
-		return sortDependencyRows(collapseDependencyRows(rows));
-	}
-};
-
-//#endregion
-export { DependencyTable };