@hyperfrontend/versioning 0.1.0

package/workspace/models/index.esm.js

@@ -0,0 +1,261 @@
+/**
+ * Workspace Model
+ *
+ * Represents a monorepo workspace with multiple projects.
+ * Used for package discovery, dependency tracking, and coordinated versioning.
+ */
+/**
+ * Default workspace discovery patterns.
+ */
+const DEFAULT_PATTERNS = [
+    'libs/*/package.json',
+    'apps/*/package.json',
+    'packages/*/package.json',
+    'tools/*/package.json',
+    'plugins/*/package.json',
+];
+/**
+ * Default exclusion patterns.
+ */
+const DEFAULT_EXCLUDE = ['**/node_modules/**', '**/dist/**', '**/coverage/**', '**/.git/**'];
+/**
+ * Default workspace configuration.
+ */
+const DEFAULT_WORKSPACE_CONFIG = {
+    patterns: DEFAULT_PATTERNS,
+    exclude: DEFAULT_EXCLUDE,
+    includeChangelogs: true,
+    trackDependencies: true,
+};
+/**
+ * Creates a new workspace configuration by merging with defaults.
+ *
+ * @param options - Partial configuration options
+ * @returns Complete workspace configuration
+ */
+function createWorkspaceConfig(options) {
+    return {
+        patterns: options?.patterns ?? DEFAULT_PATTERNS,
+        exclude: options?.exclude ?? DEFAULT_EXCLUDE,
+        includeChangelogs: options?.includeChangelogs ?? true,
+        trackDependencies: options?.trackDependencies ?? true,
+    };
+}
+/**
+ * Creates a new workspace object.
+ *
+ * @param options - Workspace properties
+ * @param options.root - Absolute path to workspace root directory
+ * @param options.type - Type of workspace (nx, turbo, etc.)
+ * @param options.projects - Map of project names to project objects
+ * @param options.config - Configuration used for workspace discovery
+ * @param options.dependencyGraph - Map of package names to their dependents
+ * @param options.reverseDependencyGraph - Map of package names to their dependencies
+ * @returns A new Workspace object
+ */
+function createWorkspace(options) {
+    const projectList = [...options.projects.values()].sort((a, b) => a.name.localeCompare(b.name));
+    return {
+        root: options.root,
+        type: options.type,
+        projects: options.projects,
+        projectList,
+        config: options.config,
+        dependencyGraph: options.dependencyGraph,
+        reverseDependencyGraph: options.reverseDependencyGraph,
+    };
+}
+/**
+ * Gets a project by name from the workspace.
+ *
+ * @param workspace - Workspace to search in
+ * @param projectName - Identifier of the project to retrieve
+ * @returns The project or undefined if not found
+ */
+function getProject(workspace, projectName) {
+    return workspace.projects.get(projectName);
+}
+/**
+ * Checks if a project exists in the workspace.
+ *
+ * @param workspace - Workspace to search in
+ * @param projectName - Identifier of the project to check
+ * @returns True if the project exists
+ */
+function hasProject(workspace, projectName) {
+    return workspace.projects.has(projectName);
+}
+/**
+ * Gets all project names in the workspace.
+ *
+ * @param workspace - Workspace to retrieve project names from
+ * @returns Array of project names
+ */
+function getProjectNames(workspace) {
+    return workspace.projectList.map((p) => p.name);
+}
+/**
+ * Gets the count of projects in the workspace.
+ *
+ * @param workspace - Workspace to count projects in
+ * @returns Number of projects
+ */
+function getProjectCount(workspace) {
+    return workspace.projects.size;
+}
+/**
+ * Gets projects that depend on the given project.
+ *
+ * @param workspace - Workspace containing the dependency graph
+ * @param projectName - Name of the dependency
+ * @returns Array of dependent project names
+ */
+function getDependents(workspace, projectName) {
+    return workspace.dependencyGraph.get(projectName) ?? [];
+}
+/**
+ * Gets projects that the given project depends on.
+ *
+ * @param workspace - Workspace containing the dependency graph
+ * @param projectName - Identifier of the project to look up
+ * @returns Array of dependency project names
+ */
+function getDependencies(workspace, projectName) {
+    return workspace.reverseDependencyGraph.get(projectName) ?? [];
+}
+/**
+ * Checks if projectA depends on projectB.
+ *
+ * @param workspace - Workspace containing the dependency graph
+ * @param projectA - Name of the potentially dependent project
+ * @param projectB - Name of the potential dependency
+ * @returns True if projectA depends on projectB
+ */
+function dependsOn(workspace, projectA, projectB) {
+    const deps = getDependencies(workspace, projectA);
+    return deps.includes(projectB);
+}
+
+/**
+ * Project Model
+ *
+ * Represents a single project/package within a workspace.
+ * Contains package.json data, paths, and dependency information.
+ */
+/**
+ * Creates a new Project object.
+ *
+ * @param options - Project properties
+ * @returns A new Project object
+ */
+function createProject(options) {
+    const isPrivate = options.packageJson['private'] === true;
+    const publishable = !isPrivate && options.name !== undefined && options.version !== undefined;
+    return {
+        name: options.name,
+        version: options.version,
+        path: options.path,
+        packageJsonPath: options.packageJsonPath,
+        packageJson: options.packageJson,
+        changelogPath: options.changelogPath ?? null,
+        internalDependencies: options.internalDependencies ?? [],
+        internalDependents: options.internalDependents ?? [],
+        publishable,
+        private: isPrivate,
+    };
+}
+/**
+ * Checks if a project is publishable (public and has name/version).
+ *
+ * @param project - The project to check
+ * @returns True if the project can be published
+ */
+function isPublishable(project) {
+    return project.publishable;
+}
+/**
+ * Checks if a project is private.
+ *
+ * @param project - The project to check
+ * @returns True if the project is marked as private
+ */
+function isPrivate(project) {
+    return project.private;
+}
+/**
+ * Checks if a project has a changelog file.
+ *
+ * @param project - The project to check
+ * @returns True if changelog exists
+ */
+function hasChangelog(project) {
+    return project.changelogPath !== null;
+}
+/**
+ * Checks if a project has any internal dependencies.
+ *
+ * @param project - The project to check
+ * @returns True if project depends on other workspace packages
+ */
+function hasInternalDependencies(project) {
+    return project.internalDependencies.length > 0;
+}
+/**
+ * Checks if a project has any internal dependents.
+ *
+ * @param project - The project to check
+ * @returns True if other workspace packages depend on this project
+ */
+function hasInternalDependents(project) {
+    return project.internalDependents.length > 0;
+}
+/**
+ * Gets the dependency count (internal dependencies).
+ *
+ * @param project - Project instance to analyze
+ * @returns Number of internal dependencies
+ */
+function getDependencyCount(project) {
+    return project.internalDependencies.length;
+}
+/**
+ * Gets the dependent count (packages that depend on this one).
+ *
+ * @param project - Project instance to analyze
+ * @returns Number of internal dependents
+ */
+function getDependentCount(project) {
+    return project.internalDependents.length;
+}
+/**
+ * Creates a copy of a project with updated internal dependents.
+ *
+ * @param project - The project to update
+ * @param dependents - New list of internal dependents
+ * @returns A new Project with updated dependents
+ */
+function withDependents(project, dependents) {
+    return {
+        ...project,
+        internalDependents: dependents,
+    };
+}
+/**
+ * Creates a copy of a project with an added internal dependent.
+ *
+ * @param project - The project to update
+ * @param dependent - Name of the dependent to add
+ * @returns A new Project with the added dependent
+ */
+function addDependent(project, dependent) {
+    if (project.internalDependents.includes(dependent)) {
+        return project;
+    }
+    return {
+        ...project,
+        internalDependents: [...project.internalDependents, dependent],
+    };
+}
+
+export { DEFAULT_EXCLUDE, DEFAULT_PATTERNS, DEFAULT_WORKSPACE_CONFIG, addDependent, createProject, createWorkspace, createWorkspaceConfig, dependsOn, getDependencies, getDependencyCount, getDependentCount, getDependents, getProject, getProjectCount, getProjectNames, hasChangelog, hasInternalDependencies, hasInternalDependents, hasProject, isPrivate, isPublishable, withDependents };
+//# sourceMappingURL=index.esm.js.map

package/workspace/models/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../../../../../../../../../../libs/versioning/src/workspace/models/workspace.ts","../../../../../../../../../../libs/versioning/src/workspace/models/project.ts"],"sourcesContent":[null,null],"names":[],"mappings":"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"}

package/workspace/models/project.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Project Model
+ *
+ * Represents a single project/package within a workspace.
+ * Contains package.json data, paths, and dependency information.
+ */
+import type { PackageJson } from '@hyperfrontend/project-scope';
+/**
+ * A single project within a workspace.
+ */
+export interface Project {
+    /** Package name from package.json */
+    readonly name: string;
+    /** Package version from package.json */
+    readonly version: string;
+    /** Absolute path to project root directory */
+    readonly path: string;
+    /** Absolute path to package.json */
+    readonly packageJsonPath: string;
+    /** Parsed package.json content */
+    readonly packageJson: PackageJson;
+    /** Absolute path to CHANGELOG.md (null if not found) */
+    readonly changelogPath: string | null;
+    /** Names of workspace packages this project depends on */
+    readonly internalDependencies: readonly string[];
+    /** Names of workspace packages that depend on this project */
+    readonly internalDependents: readonly string[];
+    /** Whether this is a publishable package */
+    readonly publishable: boolean;
+    /** Whether this is a private package */
+    readonly private: boolean;
+}
+/**
+ * Options for creating a project.
+ */
+export interface CreateProjectOptions {
+    name: string;
+    version: string;
+    path: string;
+    packageJsonPath: string;
+    packageJson: PackageJson;
+    changelogPath?: string | null;
+    internalDependencies?: readonly string[];
+    internalDependents?: readonly string[];
+}
+/**
+ * Creates a new Project object.
+ *
+ * @param options - Project properties
+ * @returns A new Project object
+ */
+export declare function createProject(options: CreateProjectOptions): Project;
+/**
+ * Checks if a project is publishable (public and has name/version).
+ *
+ * @param project - The project to check
+ * @returns True if the project can be published
+ */
+export declare function isPublishable(project: Project): boolean;
+/**
+ * Checks if a project is private.
+ *
+ * @param project - The project to check
+ * @returns True if the project is marked as private
+ */
+export declare function isPrivate(project: Project): boolean;
+/**
+ * Checks if a project has a changelog file.
+ *
+ * @param project - The project to check
+ * @returns True if changelog exists
+ */
+export declare function hasChangelog(project: Project): boolean;
+/**
+ * Checks if a project has any internal dependencies.
+ *
+ * @param project - The project to check
+ * @returns True if project depends on other workspace packages
+ */
+export declare function hasInternalDependencies(project: Project): boolean;
+/**
+ * Checks if a project has any internal dependents.
+ *
+ * @param project - The project to check
+ * @returns True if other workspace packages depend on this project
+ */
+export declare function hasInternalDependents(project: Project): boolean;
+/**
+ * Gets the dependency count (internal dependencies).
+ *
+ * @param project - Project instance to analyze
+ * @returns Number of internal dependencies
+ */
+export declare function getDependencyCount(project: Project): number;
+/**
+ * Gets the dependent count (packages that depend on this one).
+ *
+ * @param project - Project instance to analyze
+ * @returns Number of internal dependents
+ */
+export declare function getDependentCount(project: Project): number;
+/**
+ * Creates a copy of a project with updated internal dependents.
+ *
+ * @param project - The project to update
+ * @param dependents - New list of internal dependents
+ * @returns A new Project with updated dependents
+ */
+export declare function withDependents(project: Project, dependents: readonly string[]): Project;
+/**
+ * Creates a copy of a project with an added internal dependent.
+ *
+ * @param project - The project to update
+ * @param dependent - Name of the dependent to add
+ * @returns A new Project with the added dependent
+ */
+export declare function addDependent(project: Project, dependent: string): Project;
+//# sourceMappingURL=project.d.ts.map

package/workspace/models/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/versioning/src/workspace/models/project.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAE/D;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB,wCAAwC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IAExB,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB,oCAAoC;IACpC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAEhC,kCAAkC;IAClC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IAEjC,wDAAwD;IACxD,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAErC,0DAA0D;IAC1D,QAAQ,CAAC,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAA;IAEhD,8DAA8D;IAC9D,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAA;IAE9C,4CAA4C;IAC5C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAE7B,wCAAwC;IACxC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,eAAe,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,WAAW,CAAA;IACxB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACvC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAgBpE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEjE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAKvF;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAQzE"}

package/workspace/models/workspace.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Workspace Model
+ *
+ * Represents a monorepo workspace with multiple projects.
+ * Used for package discovery, dependency tracking, and coordinated versioning.
+ */
+import type { Project } from './project';
+/**
+ * Workspace configuration options.
+ */
+export interface WorkspaceConfig {
+    /** Glob patterns for finding packages */
+    readonly patterns: readonly string[];
+    /** Patterns to exclude from discovery */
+    readonly exclude: readonly string[];
+    /** Whether to include changelog paths in discovery */
+    readonly includeChangelogs: boolean;
+    /** Whether to track internal dependencies */
+    readonly trackDependencies: boolean;
+}
+/**
+ * Workspace type indicating the package manager / tool in use.
+ */
+export type WorkspaceType = 'nx' | 'turbo' | 'lerna' | 'pnpm' | 'npm' | 'yarn' | 'rush' | 'unknown';
+/**
+ * Complete workspace representation.
+ * Contains all discovered projects and their relationships.
+ */
+export interface Workspace {
+    /** Absolute path to workspace root */
+    readonly root: string;
+    /** Detected workspace type */
+    readonly type: WorkspaceType;
+    /** All discovered projects indexed by name */
+    readonly projects: ReadonlyMap<string, Project>;
+    /** Projects ordered by name */
+    readonly projectList: readonly Project[];
+    /** Configuration used for discovery */
+    readonly config: WorkspaceConfig;
+    /** Dependency graph (project name -> dependents) */
+    readonly dependencyGraph: ReadonlyMap<string, readonly string[]>;
+    /** Reverse dependency graph (project name -> dependencies) */
+    readonly reverseDependencyGraph: ReadonlyMap<string, readonly string[]>;
+}
+/**
+ * Default workspace discovery patterns.
+ */
+export declare const DEFAULT_PATTERNS: readonly string[];
+/**
+ * Default exclusion patterns.
+ */
+export declare const DEFAULT_EXCLUDE: readonly string[];
+/**
+ * Default workspace configuration.
+ */
+export declare const DEFAULT_WORKSPACE_CONFIG: WorkspaceConfig;
+/**
+ * Creates a new workspace configuration by merging with defaults.
+ *
+ * @param options - Partial configuration options
+ * @returns Complete workspace configuration
+ */
+export declare function createWorkspaceConfig(options?: Partial<WorkspaceConfig>): WorkspaceConfig;
+/**
+ * Creates a new workspace object.
+ *
+ * @param options - Workspace properties
+ * @param options.root - Absolute path to workspace root directory
+ * @param options.type - Type of workspace (nx, turbo, etc.)
+ * @param options.projects - Map of project names to project objects
+ * @param options.config - Configuration used for workspace discovery
+ * @param options.dependencyGraph - Map of package names to their dependents
+ * @param options.reverseDependencyGraph - Map of package names to their dependencies
+ * @returns A new Workspace object
+ */
+export declare function createWorkspace(options: {
+    root: string;
+    type: WorkspaceType;
+    projects: ReadonlyMap<string, Project>;
+    config: WorkspaceConfig;
+    dependencyGraph: ReadonlyMap<string, readonly string[]>;
+    reverseDependencyGraph: ReadonlyMap<string, readonly string[]>;
+}): Workspace;
+/**
+ * Gets a project by name from the workspace.
+ *
+ * @param workspace - Workspace to search in
+ * @param projectName - Identifier of the project to retrieve
+ * @returns The project or undefined if not found
+ */
+export declare function getProject(workspace: Workspace, projectName: string): Project | undefined;
+/**
+ * Checks if a project exists in the workspace.
+ *
+ * @param workspace - Workspace to search in
+ * @param projectName - Identifier of the project to check
+ * @returns True if the project exists
+ */
+export declare function hasProject(workspace: Workspace, projectName: string): boolean;
+/**
+ * Gets all project names in the workspace.
+ *
+ * @param workspace - Workspace to retrieve project names from
+ * @returns Array of project names
+ */
+export declare function getProjectNames(workspace: Workspace): readonly string[];
+/**
+ * Gets the count of projects in the workspace.
+ *
+ * @param workspace - Workspace to count projects in
+ * @returns Number of projects
+ */
+export declare function getProjectCount(workspace: Workspace): number;
+/**
+ * Gets projects that depend on the given project.
+ *
+ * @param workspace - Workspace containing the dependency graph
+ * @param projectName - Name of the dependency
+ * @returns Array of dependent project names
+ */
+export declare function getDependents(workspace: Workspace, projectName: string): readonly string[];
+/**
+ * Gets projects that the given project depends on.
+ *
+ * @param workspace - Workspace containing the dependency graph
+ * @param projectName - Identifier of the project to look up
+ * @returns Array of dependency project names
+ */
+export declare function getDependencies(workspace: Workspace, projectName: string): readonly string[];
+/**
+ * Checks if projectA depends on projectB.
+ *
+ * @param workspace - Workspace containing the dependency graph
+ * @param projectA - Name of the potentially dependent project
+ * @param projectB - Name of the potential dependency
+ * @returns True if projectA depends on projectB
+ */
+export declare function dependsOn(workspace: Workspace, projectA: string, projectB: string): boolean;
+//# sourceMappingURL=workspace.d.ts.map

package/workspace/models/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/versioning/src/workspace/models/workspace.ts"],"names":[],"mappings":"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"}

package/workspace/operations/batch-update.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Batch Update
+ *
+ * Utilities for updating multiple packages at once.
+ * Supports updating versions, dependencies, and other package.json fields.
+ */
+import type { Tree } from '@hyperfrontend/project-scope';
+import type { Workspace } from '../models/workspace';
+import type { PlannedBump } from './cascade-bump';
+/**
+ * Result of a batch update operation.
+ */
+export interface BatchUpdateResult {
+    /** Packages successfully updated */
+    readonly updated: readonly UpdatedPackage[];
+    /** Packages that failed to update */
+    readonly failed: readonly FailedUpdate[];
+    /** Total number of packages processed */
+    readonly total: number;
+    /** Whether all updates succeeded */
+    readonly success: boolean;
+}
+/**
+ * Information about a successfully updated package.
+ */
+export interface UpdatedPackage {
+    /** Package name */
+    readonly name: string;
+    /** Path to package.json */
+    readonly packageJsonPath: string;
+    /** Previous version */
+    readonly previousVersion: string;
+    /** New version */
+    readonly newVersion: string;
+}
+/**
+ * Information about a failed update.
+ */
+export interface FailedUpdate {
+    /** Package name */
+    readonly name: string;
+    /** Path to package.json */
+    readonly packageJsonPath: string;
+    /** Error message */
+    readonly error: string;
+}
+/**
+ * Options for batch update operations.
+ */
+export interface BatchUpdateOptions {
+    /** Whether to perform a dry run (no actual changes) */
+    dryRun?: boolean;
+    /** Whether to update dependency references in other packages */
+    updateDependencyReferences?: boolean;
+}
+/**
+ * Default batch update options.
+ */
+export declare const DEFAULT_BATCH_UPDATE_OPTIONS: Required<BatchUpdateOptions>;
+/**
+ * Applies planned bumps to the workspace.
+ * Updates package.json version fields for all affected packages.
+ *
+ * @param workspace - Workspace containing projects to update
+ * @param bumps - Planned version bumps
+ * @param options - Update options
+ * @returns Batch update result
+ *
+ * @example
+ * ```typescript
+ * import { applyBumps, calculateCascadeBumps } from '@hyperfrontend/versioning'
+ *
+ * const cascadeResult = calculateCascadeBumps(workspace, directBumps)
+ * const updateResult = applyBumps(workspace, cascadeResult.bumps)
+ *
+ * if (updateResult.success) {
+ *   console.log(`Updated ${updateResult.updated.length} packages`)
+ * } else {
+ *   console.error('Some updates failed:', updateResult.failed)
+ * }
+ * ```
+ */
+export declare function applyBumps(workspace: Workspace, bumps: readonly PlannedBump[], options?: BatchUpdateOptions): BatchUpdateResult;
+/**
+ * Updates a package.json file using a VFS Tree.
+ *
+ * @param tree - Virtual file system tree
+ * @param packageJsonPath - Relative path to package.json
+ * @param newVersion - New version string
+ */
+export declare function updatePackageVersionInTree(tree: Tree, packageJsonPath: string, newVersion: string): void;
+/**
+ * Creates a summary of the batch update result.
+ *
+ * @param result - Result object from batch update operation
+ * @returns Human-readable summary
+ */
+export declare function summarizeBatchUpdate(result: BatchUpdateResult): string;
+//# sourceMappingURL=batch-update.d.ts.map

package/workspace/operations/batch-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-update.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/versioning/src/workspace/operations/batch-update.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAOjD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAA;IAE3C,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAA;IAExC,yCAAyC;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IAEtB,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB,2BAA2B;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAEhC,uBAAuB;IACvB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAEhC,kBAAkB;IAClB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB,2BAA2B;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAEhC,oBAAoB;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,MAAM,CAAC,EAAE,OAAO,CAAA;IAEhB,gEAAgE;IAChE,0BAA0B,CAAC,EAAE,OAAO,CAAA;CACrC;AAED;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CAAC,kBAAkB,CAGrE,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,WAAW,EAAE,EAAE,OAAO,GAAE,kBAAuB,GAAG,iBAAiB,CA2DnI;AAmED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAUxG;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CA2BtE"}