@hyperfrontend/versioning 0.1.0

package/workspace/operations/cascade-bump.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Cascade Bump
+ *
+ * Calculates which packages need version bumps when dependencies change.
+ * Implements cascade versioning for monorepos where dependents may need
+ * to be bumped when their dependencies are updated.
+ */
+import type { BumpType } from '../../semver/models/version';
+import type { Workspace } from '../models/workspace';
+/**
+ * A planned version bump for a package.
+ */
+export interface PlannedBump {
+    /** Package name */
+    readonly name: string;
+    /** Current version */
+    readonly currentVersion: string;
+    /** Next version after bump */
+    readonly nextVersion: string;
+    /** Type of bump */
+    readonly bumpType: BumpType;
+    /** Reason for the bump */
+    readonly reason: BumpReason;
+    /** Packages that triggered this bump (for cascade bumps) */
+    readonly triggeredBy: readonly string[];
+}
+/**
+ * Reason for a version bump.
+ */
+export type BumpReason = 'direct' | 'cascade' | 'sync';
+/**
+ * Options for cascade bump calculation.
+ */
+export interface CascadeBumpOptions {
+    /**
+     * Bump type for cascaded dependents.
+     * Default is 'patch' - dependents get a patch bump when their dependencies change.
+     */
+    cascadeBumpType?: BumpType;
+    /**
+     * Whether to include dev dependencies in cascade.
+     * Default is false - only production dependencies trigger cascades.
+     */
+    includeDevDependencies?: boolean;
+    /**
+     * Whether to include peer dependencies in cascade.
+     * Default is true - peer dependency updates should cascade.
+     */
+    includePeerDependencies?: boolean;
+    /**
+     * Custom prerelease identifier for prerelease bumps.
+     */
+    prereleaseId?: string;
+}
+/**
+ * Default cascade bump options.
+ */
+export declare const DEFAULT_CASCADE_OPTIONS: Required<CascadeBumpOptions>;
+/**
+ * Result of cascade bump calculation.
+ */
+export interface CascadeBumpResult {
+    /** All planned bumps, in topological order */
+    readonly bumps: readonly PlannedBump[];
+    /** Packages explicitly bumped (direct changes) */
+    readonly directBumps: readonly PlannedBump[];
+    /** Packages bumped due to cascading */
+    readonly cascadeBumps: readonly PlannedBump[];
+    /** Total number of packages affected */
+    readonly totalAffected: number;
+}
+/**
+ * Input for calculating cascade bumps.
+ */
+export interface DirectBumpInput {
+    /** Package name */
+    name: string;
+    /** Type of bump */
+    bumpType: BumpType;
+}
+/**
+ * Calculates cascade bumps for a workspace given direct bumps.
+ *
+ * When packages are directly bumped (e.g., due to commits), their dependents
+ * may also need version bumps. This function calculates all affected packages.
+ *
+ * @param workspace - Workspace containing projects and dependency graph
+ * @param directBumps - Packages with direct changes
+ * @param options - Configuration for cascade bump calculation
+ * @returns Cascade bump result
+ *
+ * @example
+ * ```typescript
+ * import { calculateCascadeBumps } from '@hyperfrontend/versioning'
+ *
+ * // If lib-utils is getting a minor bump
+ * const result = calculateCascadeBumps(workspace, [
+ *   { name: 'lib-utils', bumpType: 'minor' }
+ * ])
+ *
+ * // result.bumps includes lib-utils and all packages that depend on it
+ * for (const bump of result.bumps) {
+ *   console.log(`${bump.name}: ${bump.currentVersion} -> ${bump.nextVersion}`)
+ * }
+ * ```
+ */
+export declare function calculateCascadeBumps(workspace: Workspace, directBumps: readonly DirectBumpInput[], options?: CascadeBumpOptions): CascadeBumpResult;
+/**
+ * Calculates cascade bumps starting from a single package.
+ *
+ * @param workspace - Workspace containing projects and dependency graph
+ * @param packageName - Package with direct changes
+ * @param bumpType - Type of bump for the direct change
+ * @param options - Configuration for cascade behavior
+ * @returns Cascade bump result
+ */
+export declare function calculateCascadeBumpsFromPackage(workspace: Workspace, packageName: string, bumpType: BumpType, options?: CascadeBumpOptions): CascadeBumpResult;
+/**
+ * Gets a summary of the cascade bump calculation.
+ *
+ * @param result - Result object from cascade bump calculation
+ * @returns Human-readable summary
+ */
+export declare function summarizeCascadeBumps(result: CascadeBumpResult): string;
+//# sourceMappingURL=cascade-bump.d.ts.map

package/workspace/operations/cascade-bump.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascade-bump.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/versioning/src/workspace/operations/cascade-bump.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAU,MAAM,6BAA6B,CAAA;AAEnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AASpD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB,sBAAsB;IACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAE/B,8BAA8B;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAE5B,mBAAmB;IACnB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAE3B,0BAA0B;IAC1B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;IAE3B,4DAA4D;IAC5D,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;CACxC;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,SAAS,GACT,MAAM,CAAA;AAEV;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,eAAe,CAAC,EAAE,QAAQ,CAAA;IAE1B;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAEhC;;;OAGG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAA;IAEjC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,kBAAkB,CAKhE,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAA;IAEtC,kDAAkD;IAClD,QAAQ,CAAC,WAAW,EAAE,SAAS,WAAW,EAAE,CAAA;IAE5C,uCAAuC;IACvC,QAAQ,CAAC,YAAY,EAAE,SAAS,WAAW,EAAE,CAAA;IAE7C,wCAAwC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAA;IAEZ,mBAAmB;IACnB,QAAQ,EAAE,QAAQ,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,SAAS,eAAe,EAAE,EACvC,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB,CAiFnB;AAuFD;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAC9C,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB,CAEnB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAkBvE"}