@hyperfrontend/versioning 0.1.0

package/flow/models/types.d.ts

@@ -0,0 +1,150 @@
+import type { Logger } from '@hyperfrontend/logging';
+import type { Tree } from '@hyperfrontend/project-scope';
+import type { ChangelogEntry } from '../../changelog/models/entry';
+import type { ConventionalCommit } from '../../commits/models/conventional';
+import type { GitClient } from '../../git/factory';
+import type { Registry } from '../../registry/models/registry';
+import type { BumpType } from '../../semver/models/version';
+export type { Logger } from '@hyperfrontend/logging';
+/**
+ * Accumulated state during flow execution.
+ * Each step can read previous state and contribute updates.
+ */
+export interface FlowState {
+    /** Current/local version from package.json */
+    readonly currentVersion?: string;
+    /** Published version on registry (null if never published) */
+    readonly publishedVersion?: string | null;
+    /** Calculated next version */
+    readonly nextVersion?: string;
+    /** Bump type (major/minor/patch/none) */
+    readonly bumpType?: BumpType;
+    /** Analyzed commits since last release */
+    readonly commits?: readonly ConventionalCommit[];
+    /** Tag name that marks the last release */
+    readonly lastReleaseTag?: string | null;
+    /** Generated changelog entry */
+    readonly changelogEntry?: ChangelogEntry;
+    /** Files modified during flow execution */
+    readonly modifiedFiles?: readonly string[];
+    /** Created git commit hash */
+    readonly commitHash?: string;
+    /** Created git tag name */
+    readonly tagName?: string;
+    /** Whether this is a first release (no prior versions) */
+    readonly isFirstRelease?: boolean;
+    /** Additional custom state for extensibility */
+    readonly [key: string]: unknown;
+}
+/**
+ * Flow configuration options.
+ */
+export interface FlowConfig {
+    /** Preset name or custom configuration */
+    readonly preset?: 'conventional' | 'independent' | 'synced';
+    /** Commit types that trigger releases */
+    readonly releaseTypes?: readonly string[];
+    /** Commit types that trigger minor bumps */
+    readonly minorTypes?: readonly string[];
+    /** Commit types that trigger patch bumps */
+    readonly patchTypes?: readonly string[];
+    /** Skip git operations */
+    readonly skipGit?: boolean;
+    /** Skip tag creation */
+    readonly skipTag?: boolean;
+    /** Skip changelog update */
+    readonly skipChangelog?: boolean;
+    /** Dry run mode - preview changes without applying */
+    readonly dryRun?: boolean;
+    /** Custom commit message template */
+    readonly commitMessage?: string;
+    /** Custom tag format */
+    readonly tagFormat?: string;
+    /** Track dependencies for cascade bumps */
+    readonly trackDeps?: boolean;
+    /** Branch allowed for releases */
+    readonly releaseBranch?: string;
+    /** Base version for first release */
+    readonly firstReleaseVersion?: string;
+    /** Allow prerelease versions */
+    readonly allowPrerelease?: boolean;
+    /** Prerelease identifier (e.g., 'alpha', 'beta') */
+    readonly prereleaseId?: string;
+    /** Force a specific bump type, bypassing commit analysis */
+    readonly releaseAs?: 'major' | 'minor' | 'patch';
+}
+/**
+ * Default flow configuration values.
+ */
+export declare const DEFAULT_FLOW_CONFIG: Required<FlowConfig>;
+/**
+ * Execution context passed to each step.
+ * Contains all resources and accumulated state.
+ *
+ * Note: `state` is mutable within context to allow
+ * accumulation, but individual FlowState objects are immutable.
+ */
+export interface FlowContext {
+    /** Workspace root path */
+    readonly workspaceRoot: string;
+    /** Target project name */
+    readonly projectName: string;
+    /** Project root path */
+    readonly projectRoot: string;
+    /** Package name from package.json */
+    readonly packageName: string;
+    /** Virtual file system tree */
+    readonly tree: Tree;
+    /** Registry client */
+    readonly registry: Registry;
+    /** Git client */
+    readonly git: GitClient;
+    /** Logger instance */
+    readonly logger: Logger;
+    /** Flow configuration */
+    readonly config: FlowConfig;
+    /** Accumulated state from previous steps (mutable reference) */
+    state: FlowState;
+}
+/**
+ * Result of a single step execution.
+ */
+export interface FlowStepResult {
+    /** Step outcome */
+    readonly status: 'success' | 'skipped' | 'failed';
+    /** State updates from this step */
+    readonly stateUpdates?: Partial<FlowState>;
+    /** Descriptive message */
+    readonly message?: string;
+    /** Error if failed */
+    readonly error?: Error;
+}
+/**
+ * Step result with step identification.
+ */
+export interface FlowStepResultWithId extends FlowStepResult {
+    /** Step identifier */
+    readonly stepId: string;
+    /** Step display name */
+    readonly stepName: string;
+}
+/**
+ * Overall flow execution status.
+ */
+export type FlowStatus = 'success' | 'partial' | 'failed' | 'skipped';
+/**
+ * Complete result of flow execution.
+ */
+export interface FlowResult {
+    /** Overall flow outcome */
+    readonly status: FlowStatus;
+    /** Results for each step */
+    readonly steps: readonly FlowStepResultWithId[];
+    /** Final accumulated state */
+    readonly state: FlowState;
+    /** Duration in milliseconds */
+    readonly duration: number;
+    /** Summary message */
+    readonly summary: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/flow/models/types.d.ts.map

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

package/flow/presets/conventional.d.ts

@@ -0,0 +1,59 @@
+import type { VersionFlow } from '../models/flow';
+import type { FlowConfig } from '../models/types';
+/**
+ * Default configuration for conventional flow.
+ */
+export declare const CONVENTIONAL_FLOW_CONFIG: FlowConfig;
+/**
+ * Creates a conventional flow.
+ *
+ * This flow follows the standard conventional commits workflow:
+ * 1. Fetch published version from registry
+ * 2. Analyze commits since last release
+ * 3. Calculate version bump based on commit types
+ * 4. Check if version already published (idempotency)
+ * 5. Generate changelog entry
+ * 6. Update package.json version
+ * 7. Write changelog to file
+ * 8. Create git commit (optional)
+ * 9. Create git tag (optional, typically after publish)
+ *
+ * @param config - Optional configuration overrides
+ * @returns A VersionFlow configured for conventional commits
+ *
+ * @example
+ * ```typescript
+ * import { createConventionalFlow, executeFlow } from '@hyperfrontend/versioning'
+ *
+ * // Use defaults
+ * const flow = createConventionalFlow()
+ *
+ * // With overrides
+ * const customFlow = createConventionalFlow({
+ *   skipTag: false,
+ *   releaseTypes: ['feat', 'fix'],
+ * })
+ *
+ * const result = await executeFlow(flow, 'lib-utils', '/workspace')
+ * ```
+ */
+export declare function createConventionalFlow(config?: Partial<FlowConfig>): VersionFlow;
+/**
+ * Creates a minimal flow for quick releases.
+ *
+ * Skips changelog and tag creation.
+ *
+ * @param config - Optional configuration overrides
+ * @returns A minimal VersionFlow
+ */
+export declare function createMinimalFlow(config?: Partial<FlowConfig>): VersionFlow;
+/**
+ * Creates a changelog-only flow.
+ *
+ * Only generates changelog, no version bumps or git operations.
+ *
+ * @param config - Optional configuration overrides
+ * @returns A VersionFlow that only updates changelog
+ */
+export declare function createChangelogOnlyFlow(config?: Partial<FlowConfig>): VersionFlow;
+//# sourceMappingURL=conventional.d.ts.map

package/flow/presets/conventional.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conventional.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/versioning/src/flow/presets/conventional.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAcjD;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,UAatC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,WAAW,CAsBhF;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,WAAW,CAM3E;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,WAAW,CAqBjF"}

package/flow/presets/independent.d.ts

@@ -0,0 +1,61 @@
+import type { VersionFlow } from '../models/flow';
+import type { FlowStep } from '../models/step';
+import type { FlowConfig } from '../models/types';
+/**
+ * Default configuration for independent flow.
+ */
+export declare const INDEPENDENT_FLOW_CONFIG: FlowConfig;
+/**
+ * Creates a step that checks for dependent package bumps.
+ *
+ * In independent versioning, when a dependency is bumped,
+ * dependents may also need version bumps.
+ *
+ * @returns A FlowStep that checks dependent bumps
+ */
+export declare function createCheckDependentBumpsStep(): FlowStep;
+/**
+ * Creates an independent versioning flow.
+ *
+ * This flow is designed for monorepos where each package
+ * is versioned independently:
+ *
+ * 1. Fetch published version from registry
+ * 2. Analyze commits since last release
+ * 3. Calculate version bump based on commit types
+ * 4. Check for dependent package bumps (cascade)
+ * 5. Check if version already published (idempotency)
+ * 6. Generate changelog entry
+ * 7. Update package.json version
+ * 8. Cascade dependency updates
+ * 9. Write changelog to file
+ * 10. Create git commit
+ * 11. Create git tag
+ *
+ * @param config - Optional configuration overrides
+ * @returns A VersionFlow configured for independent versioning
+ *
+ * @example
+ * ```typescript
+ * import { createIndependentFlow, executeFlow } from '@hyperfrontend/versioning'
+ *
+ * const flow = createIndependentFlow()
+ * const result = await executeFlow(flow, 'lib-utils', '/workspace')
+ *
+ * // Check which dependents were bumped
+ * console.log(result.state.cascadedBumps)
+ * ```
+ */
+export declare function createIndependentFlow(config?: Partial<FlowConfig>): VersionFlow;
+/**
+ * Creates a flow for releasing multiple packages independently.
+ *
+ * This is a variant that skips commit/tag creation, intended
+ * to be used when releasing multiple packages in sequence
+ * with a single commit at the end.
+ *
+ * @param config - Optional configuration overrides
+ * @returns A VersionFlow for batch independent releases
+ */
+export declare function createBatchReleaseFlow(config?: Partial<FlowConfig>): VersionFlow;
+//# sourceMappingURL=independent.d.ts.map

package/flow/presets/independent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"independent.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/versioning/src/flow/presets/independent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAiBjD;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,UAIrC,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,IAAI,QAAQ,CAkCxD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,WAAW,CAwB/E;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,WAAW,CAuBhF"}