@eui/mcp 1.0.3

package/dist/version/changelog-file-utils.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Changelog File Utilities
+ *
+ * Provides functions for reading, parsing, and updating CHANGELOG.md files.
+ * Ensures idempotent operations and proper version section ordering.
+ */
+export interface ChangelogSection {
+    version: string;
+    date: string;
+    content: string;
+}
+export interface ChangelogEntry {
+    version: string;
+    date: string;
+    features?: string[];
+    fixes?: string[];
+    breaking?: string[];
+    other?: string[];
+}
+/**
+ * Parses a CHANGELOG.md file into structured sections.
+ *
+ * @param changelogContent - The raw content of CHANGELOG.md
+ * @returns Array of changelog sections, ordered from newest to oldest
+ */
+export declare function parseChangelog(changelogContent: string): ChangelogSection[];
+/**
+ * Formats a changelog entry as markdown.
+ *
+ * @param entry - The changelog entry to format
+ * @returns Formatted markdown string
+ */
+export declare function formatChangelogEntry(entry: ChangelogEntry): string;
+/**
+ * Adds a new version section to an existing changelog.
+ *
+ * This operation is idempotent:
+ * - If the version already exists, the changelog is returned unchanged
+ * - New sections are always placed at the top (after the title)
+ * - All existing sections are preserved in their original order
+ *
+ * @param existingChangelog - The current changelog content
+ * @param newEntry - The new changelog entry to add
+ * @returns Updated changelog content with the new entry at the top
+ */
+export declare function addChangelogEntry(existingChangelog: string, newEntry: ChangelogEntry): string;
+/**
+ * Creates a new changelog with an initial entry.
+ *
+ * @param entry - The initial changelog entry
+ * @returns New changelog content with title and entry
+ */
+export declare function createChangelog(entry: ChangelogEntry): string;
+/**
+ * Extracts all version numbers from a changelog.
+ *
+ * @param changelogContent - The changelog content to parse
+ * @returns Array of version strings, ordered from newest to oldest
+ */
+export declare function extractVersions(changelogContent: string): string[];
+/**
+ * Checks if a version exists in the changelog.
+ *
+ * @param changelogContent - The changelog content to check
+ * @param version - The version to look for
+ * @returns true if the version exists, false otherwise
+ */
+export declare function hasVersion(changelogContent: string, version: string): boolean;
+//# sourceMappingURL=changelog-file-utils.d.ts.map

package/dist/version/changelog-file-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog-file-utils.d.ts","sourceRoot":"","sources":["../../src/version/changelog-file-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,gBAAgB,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAmC3E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAgDlE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,iBAAiB,EAAE,MAAM,EACzB,QAAQ,EAAE,cAAc,GACvB,MAAM,CAkCR;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAI7D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,EAAE,CAGlE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAG7E"}

package/dist/version/changelog-file-utils.js

@@ -0,0 +1,161 @@
+/**
+ * Changelog File Utilities
+ *
+ * Provides functions for reading, parsing, and updating CHANGELOG.md files.
+ * Ensures idempotent operations and proper version section ordering.
+ */
+/**
+ * Parses a CHANGELOG.md file into structured sections.
+ *
+ * @param changelogContent - The raw content of CHANGELOG.md
+ * @returns Array of changelog sections, ordered from newest to oldest
+ */
+export function parseChangelog(changelogContent) {
+    const sections = [];
+    // Split by version headers (## [version] - date or ## version - date)
+    const versionHeaderRegex = /^## \[?(\d+\.\d+\.\d+)\]?\s*-\s*(.+)$/gm;
+    let match;
+    const matches = [];
+    while ((match = versionHeaderRegex.exec(changelogContent)) !== null) {
+        matches.push({
+            version: match[1],
+            date: match[2],
+            index: match.index,
+        });
+    }
+    // Extract content for each section
+    for (let i = 0; i < matches.length; i++) {
+        const current = matches[i];
+        const next = matches[i + 1];
+        const startIndex = current.index;
+        const endIndex = next ? next.index : changelogContent.length;
+        const sectionContent = changelogContent.substring(startIndex, endIndex).trim();
+        sections.push({
+            version: current.version,
+            date: current.date,
+            content: sectionContent,
+        });
+    }
+    return sections;
+}
+/**
+ * Formats a changelog entry as markdown.
+ *
+ * @param entry - The changelog entry to format
+ * @returns Formatted markdown string
+ */
+export function formatChangelogEntry(entry) {
+    const lines = [];
+    // Header
+    lines.push(`## [${entry.version}] - ${entry.date}`);
+    lines.push('');
+    // Features
+    if (entry.features && entry.features.length > 0) {
+        lines.push('### Features');
+        lines.push('');
+        entry.features.forEach(feature => {
+            lines.push(`- ${feature}`);
+        });
+        lines.push('');
+    }
+    // Bug Fixes
+    if (entry.fixes && entry.fixes.length > 0) {
+        lines.push('### Bug Fixes');
+        lines.push('');
+        entry.fixes.forEach(fix => {
+            lines.push(`- ${fix}`);
+        });
+        lines.push('');
+    }
+    // Breaking Changes
+    if (entry.breaking && entry.breaking.length > 0) {
+        lines.push('### Breaking Changes');
+        lines.push('');
+        entry.breaking.forEach(breaking => {
+            lines.push(`- ${breaking}`);
+        });
+        lines.push('');
+    }
+    // Other changes
+    if (entry.other && entry.other.length > 0) {
+        lines.push('### Other Changes');
+        lines.push('');
+        entry.other.forEach(other => {
+            lines.push(`- ${other}`);
+        });
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Adds a new version section to an existing changelog.
+ *
+ * This operation is idempotent:
+ * - If the version already exists, the changelog is returned unchanged
+ * - New sections are always placed at the top (after the title)
+ * - All existing sections are preserved in their original order
+ *
+ * @param existingChangelog - The current changelog content
+ * @param newEntry - The new changelog entry to add
+ * @returns Updated changelog content with the new entry at the top
+ */
+export function addChangelogEntry(existingChangelog, newEntry) {
+    // Parse existing changelog
+    const existingSections = parseChangelog(existingChangelog);
+    // Check if version already exists (idempotence)
+    const versionExists = existingSections.some(section => section.version === newEntry.version);
+    if (versionExists) {
+        // Return unchanged if version already exists
+        return existingChangelog;
+    }
+    // Format the new entry
+    const newEntryContent = formatChangelogEntry(newEntry);
+    // Find the title line (# Changelog or similar)
+    const titleRegex = /^#\s+.+$/m;
+    const titleMatch = existingChangelog.match(titleRegex);
+    if (titleMatch && titleMatch.index !== undefined) {
+        // Insert after title
+        const titleEndIndex = titleMatch.index + titleMatch[0].length;
+        const before = existingChangelog.substring(0, titleEndIndex);
+        const after = existingChangelog.substring(titleEndIndex);
+        // Add new entry with proper spacing
+        return `${before}\n\n${newEntryContent}\n${after.trimStart()}`;
+    }
+    else {
+        // No title found, prepend to the beginning
+        return `${newEntryContent}\n\n${existingChangelog}`;
+    }
+}
+/**
+ * Creates a new changelog with an initial entry.
+ *
+ * @param entry - The initial changelog entry
+ * @returns New changelog content with title and entry
+ */
+export function createChangelog(entry) {
+    const title = '# Changelog\n\n';
+    const entryContent = formatChangelogEntry(entry);
+    return title + entryContent;
+}
+/**
+ * Extracts all version numbers from a changelog.
+ *
+ * @param changelogContent - The changelog content to parse
+ * @returns Array of version strings, ordered from newest to oldest
+ */
+export function extractVersions(changelogContent) {
+    const sections = parseChangelog(changelogContent);
+    return sections.map(section => section.version);
+}
+/**
+ * Checks if a version exists in the changelog.
+ *
+ * @param changelogContent - The changelog content to check
+ * @param version - The version to look for
+ * @returns true if the version exists, false otherwise
+ */
+export function hasVersion(changelogContent, version) {
+    const versions = extractVersions(changelogContent);
+    return versions.includes(version);
+}
+//# sourceMappingURL=changelog-file-utils.js.map

package/dist/version/changelog-file-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog-file-utils.js","sourceRoot":"","sources":["../../src/version/changelog-file-utils.ts"],"names":[],"mappings":"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"}

package/dist/version/changelog-utils.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Changelog Utilities
+ *
+ * Provides functions for parsing conventional commits and grouping them by type.
+ * Follows the Conventional Commits specification (conventionalcommits.org).
+ */
+/**
+ * Represents a parsed conventional commit
+ */
+export interface ConventionalCommit {
+    type: string;
+    scope?: string;
+    message: string;
+    breaking: boolean;
+    raw: string;
+}
+/**
+ * Represents grouped commits by type
+ */
+export interface GroupedCommits {
+    [type: string]: ConventionalCommit[];
+}
+/**
+ * Standard commit types used in conventional commits
+ */
+export declare const COMMIT_TYPES: readonly ["feat", "fix", "docs", "style", "refactor", "perf", "test", "build", "ci", "chore", "revert"];
+/**
+ * Parses a conventional commit message.
+ *
+ * Format: type(scope): message
+ * or: type: message
+ *
+ * Breaking changes are indicated by:
+ * - BREAKING CHANGE: in the commit body
+ * - ! after type/scope: type!: message or type(scope)!: message
+ *
+ * @param commitMessage - The commit message to parse
+ * @returns Parsed conventional commit object, or null if not a valid conventional commit
+ */
+export declare function parseConventionalCommit(commitMessage: string): ConventionalCommit | null;
+/**
+ * Groups an array of conventional commits by their type.
+ *
+ * Commits are grouped into sections based on their type prefix:
+ * - feat: Features
+ * - fix: Bug Fixes
+ * - docs: Documentation
+ * - etc.
+ *
+ * @param commits - Array of commit messages to group
+ * @returns Object with commit types as keys and arrays of commits as values
+ */
+export declare function groupCommitsByType(commits: string[]): GroupedCommits;
+/**
+ * Checks if a commit message follows the conventional commit format.
+ *
+ * @param commitMessage - The commit message to validate
+ * @returns true if the message follows conventional commit format, false otherwise
+ */
+export declare function isConventionalCommit(commitMessage: string): boolean;
+/**
+ * Gets all unique commit types from an array of commits.
+ *
+ * @param commits - Array of commit messages
+ * @returns Array of unique commit types found
+ */
+export declare function getCommitTypes(commits: string[]): string[];
+/**
+ * Filters commits by type.
+ *
+ * @param commits - Array of commit messages
+ * @param type - The commit type to filter by (e.g., 'feat', 'fix')
+ * @returns Array of commits matching the specified type
+ */
+export declare function filterCommitsByType(commits: string[], type: string): ConventionalCommit[];
+/**
+ * Result of a dry run changelog generation
+ */
+export interface DryRunChangelogResult {
+    version: string;
+    date: string;
+    commits: GroupedCommits;
+    preview: string;
+    isDryRun: true;
+}
+/**
+ * Generates a changelog preview without writing to files.
+ *
+ * This function is used in dry run mode to preview changelog content.
+ *
+ * @param version - The version for this changelog entry
+ * @param commits - Array of commit messages since last release
+ * @returns Dry run result with changelog preview
+ *
+ * Validates: Requirements 15.3
+ */
+export declare function generateDryRunChangelog(version: string, commits: string[]): DryRunChangelogResult;
+//# sourceMappingURL=changelog-utils.d.ts.map

package/dist/version/changelog-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog-utils.d.ts","sourceRoot":"","sources":["../../src/version/changelog-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAAC;CACtC;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,yGAYf,CAAC;AAEX;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAsCxF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,cAAc,CAkBpE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAW1D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAWzF;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,cAAc,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,IAAI,CAAC;CAChB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EAAE,GAChB,qBAAqB,CAwDvB"}

package/dist/version/changelog-utils.js

@@ -0,0 +1,198 @@
+/**
+ * Changelog Utilities
+ *
+ * Provides functions for parsing conventional commits and grouping them by type.
+ * Follows the Conventional Commits specification (conventionalcommits.org).
+ */
+import { isDryRunEnabled, logDryRunAction } from './dry-run-utils.js';
+/**
+ * Standard commit types used in conventional commits
+ */
+export const COMMIT_TYPES = [
+    'feat',
+    'fix',
+    'docs',
+    'style',
+    'refactor',
+    'perf',
+    'test',
+    'build',
+    'ci',
+    'chore',
+    'revert',
+];
+/**
+ * Parses a conventional commit message.
+ *
+ * Format: type(scope): message
+ * or: type: message
+ *
+ * Breaking changes are indicated by:
+ * - BREAKING CHANGE: in the commit body
+ * - ! after type/scope: type!: message or type(scope)!: message
+ *
+ * @param commitMessage - The commit message to parse
+ * @returns Parsed conventional commit object, or null if not a valid conventional commit
+ */
+export function parseConventionalCommit(commitMessage) {
+    if (!commitMessage || typeof commitMessage !== 'string') {
+        return null;
+    }
+    // Split into header and body
+    const lines = commitMessage.split('\n');
+    const header = lines[0];
+    const body = lines.slice(1).join('\n');
+    // Check for BREAKING CHANGE in body
+    const hasBreakingInBody = body.includes('BREAKING CHANGE:') || body.includes('BREAKING-CHANGE:');
+    // Regex to match conventional commit header
+    // Matches: type(scope)!: message or type!: message or type(scope): message or type: message
+    // Note: Type must be lowercase (no 'i' flag) per conventional commits spec
+    // The regex requires at least one space after colon, then captures everything after that first space
+    const conventionalCommitRegex = /^([a-z]+)(?:\(([^)]+)\))?(!)?:\s(.*)$/;
+    const match = header.match(conventionalCommitRegex);
+    if (!match) {
+        return null;
+    }
+    const [, type, scope, breakingMarker, message] = match;
+    // Message must not be empty (after the required space)
+    if (!message || message.length === 0) {
+        return null;
+    }
+    return {
+        type: type,
+        scope: scope || undefined,
+        message: message,
+        breaking: !!breakingMarker || hasBreakingInBody,
+        raw: commitMessage,
+    };
+}
+/**
+ * Groups an array of conventional commits by their type.
+ *
+ * Commits are grouped into sections based on their type prefix:
+ * - feat: Features
+ * - fix: Bug Fixes
+ * - docs: Documentation
+ * - etc.
+ *
+ * @param commits - Array of commit messages to group
+ * @returns Object with commit types as keys and arrays of commits as values
+ */
+export function groupCommitsByType(commits) {
+    const grouped = {};
+    for (const commit of commits) {
+        const parsed = parseConventionalCommit(commit);
+        if (parsed) {
+            const type = parsed.type;
+            if (!grouped[type]) {
+                grouped[type] = [];
+            }
+            grouped[type].push(parsed);
+        }
+    }
+    return grouped;
+}
+/**
+ * Checks if a commit message follows the conventional commit format.
+ *
+ * @param commitMessage - The commit message to validate
+ * @returns true if the message follows conventional commit format, false otherwise
+ */
+export function isConventionalCommit(commitMessage) {
+    return parseConventionalCommit(commitMessage) !== null;
+}
+/**
+ * Gets all unique commit types from an array of commits.
+ *
+ * @param commits - Array of commit messages
+ * @returns Array of unique commit types found
+ */
+export function getCommitTypes(commits) {
+    const types = new Set();
+    for (const commit of commits) {
+        const parsed = parseConventionalCommit(commit);
+        if (parsed) {
+            types.add(parsed.type);
+        }
+    }
+    return Array.from(types).sort();
+}
+/**
+ * Filters commits by type.
+ *
+ * @param commits - Array of commit messages
+ * @param type - The commit type to filter by (e.g., 'feat', 'fix')
+ * @returns Array of commits matching the specified type
+ */
+export function filterCommitsByType(commits, type) {
+    const filtered = [];
+    for (const commit of commits) {
+        const parsed = parseConventionalCommit(commit);
+        if (parsed && parsed.type === type.toLowerCase()) {
+            filtered.push(parsed);
+        }
+    }
+    return filtered;
+}
+/**
+ * Generates a changelog preview without writing to files.
+ *
+ * This function is used in dry run mode to preview changelog content.
+ *
+ * @param version - The version for this changelog entry
+ * @param commits - Array of commit messages since last release
+ * @returns Dry run result with changelog preview
+ *
+ * Validates: Requirements 15.3
+ */
+export function generateDryRunChangelog(version, commits) {
+    const grouped = groupCommitsByType(commits);
+    const date = new Date().toISOString().split('T')[0];
+    // Generate markdown preview
+    let preview = `## ${version} (${date})\n\n`;
+    // Add breaking changes first if any
+    const breakingChanges = [];
+    for (const type in grouped) {
+        breakingChanges.push(...grouped[type].filter(c => c.breaking));
+    }
+    if (breakingChanges.length > 0) {
+        preview += '### ⚠ BREAKING CHANGES\n\n';
+        for (const commit of breakingChanges) {
+            const scope = commit.scope ? `**${commit.scope}**: ` : '';
+            preview += `* ${scope}${commit.message}\n`;
+        }
+        preview += '\n';
+    }
+    // Add features
+    if (grouped['feat']) {
+        preview += '### Features\n\n';
+        for (const commit of grouped['feat']) {
+            const scope = commit.scope ? `**${commit.scope}**: ` : '';
+            preview += `* ${scope}${commit.message}\n`;
+        }
+        preview += '\n';
+    }
+    // Add bug fixes
+    if (grouped['fix']) {
+        preview += '### Bug Fixes\n\n';
+        for (const commit of grouped['fix']) {
+            const scope = commit.scope ? `**${commit.scope}**: ` : '';
+            preview += `* ${scope}${commit.message}\n`;
+        }
+        preview += '\n';
+    }
+    if (isDryRunEnabled()) {
+        logDryRunAction(`Generate changelog for version ${version} with ${commits.length} commits`);
+        console.log('\n--- Changelog Preview ---\n');
+        console.log(preview);
+        console.log('--- End Preview ---\n');
+    }
+    return {
+        version,
+        date,
+        commits: grouped,
+        preview,
+        isDryRun: true,
+    };
+}
+//# sourceMappingURL=changelog-utils.js.map

package/dist/version/changelog-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog-utils.js","sourceRoot":"","sources":["../../src/version/changelog-utils.ts"],"names":[],"mappings":"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"}

package/dist/version/dry-run-utils.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Dry Run Mode Utilities
+ *
+ * Provides functions for detecting and managing dry run mode in the release pipeline.
+ * Dry run mode allows testing the release process without actually publishing or making changes.
+ *
+ * Validates: Requirements 15.1
+ */
+/**
+ * Checks if dry run mode is enabled via environment variable.
+ *
+ * Dry run mode is enabled when the DRY_RUN environment variable is set to:
+ * - "true" (case-insensitive)
+ * - "1"
+ * - "yes" (case-insensitive)
+ *
+ * @returns true if dry run mode is enabled, false otherwise
+ */
+export declare function isDryRunEnabled(): boolean;
+/**
+ * Gets the dry run mode status as a boolean.
+ *
+ * This is an alias for isDryRunEnabled() that provides a more explicit API.
+ *
+ * @returns true if dry run mode is enabled, false otherwise
+ */
+export declare function getDryRunMode(): boolean;
+/**
+ * Checks if the current execution should perform actual changes.
+ *
+ * This is the inverse of isDryRunEnabled() and can be used to guard
+ * operations that should only execute in non-dry-run mode.
+ *
+ * @returns true if actual changes should be made, false if in dry run mode
+ */
+export declare function shouldExecuteChanges(): boolean;
+/**
+ * Configuration object for dry run mode.
+ */
+export interface DryRunConfig {
+    /**
+     * Whether dry run mode is enabled
+     */
+    enabled: boolean;
+    /**
+     * The raw value of the DRY_RUN environment variable
+     */
+    rawValue: string | undefined;
+}
+/**
+ * Gets the complete dry run configuration.
+ *
+ * @returns Configuration object with dry run status and raw environment value
+ */
+export declare function getDryRunConfig(): DryRunConfig;
+/**
+ * Logs a dry run action message to the console.
+ *
+ * This helper function formats and logs messages about actions that would
+ * be performed in a real release but are skipped in dry run mode.
+ *
+ * @param action - Description of the action that would be performed
+ */
+export declare function logDryRunAction(action: string): void;
+/**
+ * Logs a dry run skip message to the console.
+ *
+ * This helper function formats and logs messages about operations that
+ * are being skipped due to dry run mode.
+ *
+ * @param operation - Description of the operation being skipped
+ */
+export declare function logDryRunSkip(operation: string): void;
+/**
+ * Action that would be performed in a real release
+ */
+export interface DryRunAction {
+    type: 'version' | 'changelog' | 'git' | 'npm' | 'release';
+    description: string;
+    details?: Record<string, unknown>;
+}
+/**
+ * Summary of all actions that would be performed in dry run mode
+ */
+export interface DryRunSummary {
+    actions: DryRunAction[];
+    totalActions: number;
+    timestamp: string;
+}
+/**
+ * Creates a summary of actions that would be performed in a release.
+ *
+ * This function is used in dry run mode to provide a comprehensive overview
+ * of all operations that would be executed in a real release.
+ *
+ * @param actions - Array of actions that would be performed
+ * @returns Summary object with all actions and metadata
+ *
+ * Validates: Requirements 15.5
+ */
+export declare function createDryRunSummary(actions: DryRunAction[]): DryRunSummary;
+/**
+ * Displays a formatted dry run summary to the console.
+ *
+ * @param summary - The dry run summary to display
+ */
+export declare function displayDryRunSummary(summary: DryRunSummary): void;
+//# sourceMappingURL=dry-run-utils.d.ts.map

package/dist/version/dry-run-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dry-run-utils.d.ts","sourceRoot":"","sources":["../../src/version/dry-run-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAUzC;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAK9C;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAErD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,aAAa,CAM1E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CA0BjE"}