@contractspec/lib.contracts 1.45.2 → 1.45.4

package/dist/knowledge/operations.d.ts

@@ -2,47 +2,47 @@ import { AnyOperationSpec, OperationSpec } from "../operations/operation.js";
 import { OperationSpecRegistry } from "../operations/registry.js";
 import "../operations/index.js";
 import "../index.js";
-import * as _contractspec_lib_schema102 from "@contractspec/lib.schema";
+import * as _contractspec_lib_schema155 from "@contractspec/lib.schema";
 import { SchemaModel } from "@contractspec/lib.schema";
 
 //#region src/knowledge/operations.d.ts
 declare const CreateKnowledgeSource: OperationSpec<SchemaModel<{
   tenantId: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema155.FieldType<string, string>;
     isOptional: false;
   };
   spaceKey: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema155.FieldType<string, string>;
     isOptional: false;
   };
   spaceVersion: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema155.FieldType<string, string>;
     isOptional: false;
   };
   label: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema155.FieldType<string, string>;
     isOptional: false;
   };
   sourceType: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema155.FieldType<string, string>;
     isOptional: false;
   };
   config: {
-    type: _contractspec_lib_schema102.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    type: _contractspec_lib_schema155.FieldType<Record<string, unknown>, Record<string, unknown>>;
     isOptional: false;
   };
   syncSchedule: {
     type: SchemaModel<{
       enabled: {
-        type: _contractspec_lib_schema102.FieldType<boolean, boolean>;
+        type: _contractspec_lib_schema155.FieldType<boolean, boolean>;
         isOptional: false;
       };
       cron: {
-        type: _contractspec_lib_schema102.FieldType<string, string>;
+        type: _contractspec_lib_schema155.FieldType<string, string>;
         isOptional: true;
       };
       intervalMs: {
-        type: _contractspec_lib_schema102.FieldType<number, number>;
+        type: _contractspec_lib_schema155.FieldType<number, number>;
         isOptional: true;
       };
     }>;
@@ -50,92 +50,92 @@ declare const CreateKnowledgeSource: OperationSpec<SchemaModel<{
   };
 }>, SchemaModel<{
   id: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema155.FieldType<string, string>;
     isOptional: false;
   };
   tenantId: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema155.FieldType<string, string>;
     isOptional: false;
   };
   spaceKey: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema155.FieldType<string, string>;
     isOptional: false;
   };
   spaceVersion: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema155.FieldType<string, string>;
     isOptional: false;
   };
   label: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema155.FieldType<string, string>;
     isOptional: false;
   };
   sourceType: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema155.FieldType<string, string>;
     isOptional: false;
   };
   syncSchedule: {
     type: SchemaModel<{
       enabled: {
-        type: _contractspec_lib_schema102.FieldType<boolean, boolean>;
+        type: _contractspec_lib_schema155.FieldType<boolean, boolean>;
         isOptional: false;
       };
       cron: {
-        type: _contractspec_lib_schema102.FieldType<string, string>;
+        type: _contractspec_lib_schema155.FieldType<string, string>;
         isOptional: true;
       };
       intervalMs: {
-        type: _contractspec_lib_schema102.FieldType<number, number>;
+        type: _contractspec_lib_schema155.FieldType<number, number>;
         isOptional: true;
       };
     }>;
     isOptional: true;
   };
   lastSyncStatus: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema155.FieldType<string, string>;
     isOptional: true;
   };
   lastSyncAt: {
-    type: _contractspec_lib_schema102.FieldType<Date, string>;
+    type: _contractspec_lib_schema155.FieldType<Date, string>;
     isOptional: true;
   };
   itemsProcessed: {
-    type: _contractspec_lib_schema102.FieldType<number, number>;
+    type: _contractspec_lib_schema155.FieldType<number, number>;
     isOptional: true;
   };
   createdAt: {
-    type: _contractspec_lib_schema102.FieldType<Date, string>;
+    type: _contractspec_lib_schema155.FieldType<Date, string>;
     isOptional: true;
   };
   updatedAt: {
-    type: _contractspec_lib_schema102.FieldType<Date, string>;
+    type: _contractspec_lib_schema155.FieldType<Date, string>;
     isOptional: true;
   };
 }>, undefined>;
 declare const UpdateKnowledgeSource: OperationSpec<SchemaModel<{
   sourceId: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema155.FieldType<string, string>;
     isOptional: false;
   };
   label: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema155.FieldType<string, string>;
     isOptional: true;
   };
   config: {
-    type: _contractspec_lib_schema102.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    type: _contractspec_lib_schema155.FieldType<Record<string, unknown>, Record<string, unknown>>;
     isOptional: true;
   };
   syncSchedule: {
     type: SchemaModel<{
       enabled: {
-        type: _contractspec_lib_schema102.FieldType<boolean, boolean>;
+        type: _contractspec_lib_schema155.FieldType<boolean, boolean>;
         isOptional: false;
       };
       cron: {
-        type: _contractspec_lib_schema102.FieldType<string, string>;
+        type: _contractspec_lib_schema155.FieldType<string, string>;
         isOptional: true;
       };
       intervalMs: {
-        type: _contractspec_lib_schema102.FieldType<number, number>;
+        type: _contractspec_lib_schema155.FieldType<number, number>;
         isOptional: true;
       };
     }>;
@@ -143,149 +143,149 @@ declare const UpdateKnowledgeSource: OperationSpec<SchemaModel<{
   };
 }>, SchemaModel<{
   id: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema155.FieldType<string, string>;
     isOptional: false;
   };
   tenantId: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema155.FieldType<string, string>;
     isOptional: false;
   };
   spaceKey: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema155.FieldType<string, string>;
     isOptional: false;
   };
   spaceVersion: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema155.FieldType<string, string>;
     isOptional: false;
   };
   label: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema155.FieldType<string, string>;
     isOptional: false;
   };
   sourceType: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema155.FieldType<string, string>;
     isOptional: false;
   };
   syncSchedule: {
     type: SchemaModel<{
       enabled: {
-        type: _contractspec_lib_schema102.FieldType<boolean, boolean>;
+        type: _contractspec_lib_schema155.FieldType<boolean, boolean>;
         isOptional: false;
       };
       cron: {
-        type: _contractspec_lib_schema102.FieldType<string, string>;
+        type: _contractspec_lib_schema155.FieldType<string, string>;
         isOptional: true;
       };
       intervalMs: {
-        type: _contractspec_lib_schema102.FieldType<number, number>;
+        type: _contractspec_lib_schema155.FieldType<number, number>;
         isOptional: true;
       };
     }>;
     isOptional: true;
   };
   lastSyncStatus: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema155.FieldType<string, string>;
     isOptional: true;
   };
   lastSyncAt: {
-    type: _contractspec_lib_schema102.FieldType<Date, string>;
+    type: _contractspec_lib_schema155.FieldType<Date, string>;
     isOptional: true;
   };
   itemsProcessed: {
-    type: _contractspec_lib_schema102.FieldType<number, number>;
+    type: _contractspec_lib_schema155.FieldType<number, number>;
     isOptional: true;
   };
   createdAt: {
-    type: _contractspec_lib_schema102.FieldType<Date, string>;
+    type: _contractspec_lib_schema155.FieldType<Date, string>;
     isOptional: true;
   };
   updatedAt: {
-    type: _contractspec_lib_schema102.FieldType<Date, string>;
+    type: _contractspec_lib_schema155.FieldType<Date, string>;
     isOptional: true;
   };
 }>, undefined>;
 declare const DeleteKnowledgeSource: OperationSpec<SchemaModel<{
   sourceId: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema155.FieldType<string, string>;
     isOptional: false;
   };
 }>, SchemaModel<{
   success: {
-    type: _contractspec_lib_schema102.FieldType<boolean, boolean>;
+    type: _contractspec_lib_schema155.FieldType<boolean, boolean>;
     isOptional: false;
   };
 }>, undefined>;
 declare const ListKnowledgeSources: OperationSpec<SchemaModel<{
   tenantId: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema155.FieldType<string, string>;
     isOptional: false;
   };
   spaceKey: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema155.FieldType<string, string>;
     isOptional: true;
   };
 }>, SchemaModel<{
   sources: {
     type: SchemaModel<{
       id: {
-        type: _contractspec_lib_schema102.FieldType<string, string>;
+        type: _contractspec_lib_schema155.FieldType<string, string>;
         isOptional: false;
       };
       tenantId: {
-        type: _contractspec_lib_schema102.FieldType<string, string>;
+        type: _contractspec_lib_schema155.FieldType<string, string>;
         isOptional: false;
       };
       spaceKey: {
-        type: _contractspec_lib_schema102.FieldType<string, string>;
+        type: _contractspec_lib_schema155.FieldType<string, string>;
         isOptional: false;
       };
       spaceVersion: {
-        type: _contractspec_lib_schema102.FieldType<string, string>;
+        type: _contractspec_lib_schema155.FieldType<string, string>;
         isOptional: false;
       };
       label: {
-        type: _contractspec_lib_schema102.FieldType<string, string>;
+        type: _contractspec_lib_schema155.FieldType<string, string>;
         isOptional: false;
       };
       sourceType: {
-        type: _contractspec_lib_schema102.FieldType<string, string>;
+        type: _contractspec_lib_schema155.FieldType<string, string>;
         isOptional: false;
       };
       syncSchedule: {
         type: SchemaModel<{
           enabled: {
-            type: _contractspec_lib_schema102.FieldType<boolean, boolean>;
+            type: _contractspec_lib_schema155.FieldType<boolean, boolean>;
             isOptional: false;
           };
           cron: {
-            type: _contractspec_lib_schema102.FieldType<string, string>;
+            type: _contractspec_lib_schema155.FieldType<string, string>;
             isOptional: true;
           };
           intervalMs: {
-            type: _contractspec_lib_schema102.FieldType<number, number>;
+            type: _contractspec_lib_schema155.FieldType<number, number>;
             isOptional: true;
           };
         }>;
         isOptional: true;
       };
       lastSyncStatus: {
-        type: _contractspec_lib_schema102.FieldType<string, string>;
+        type: _contractspec_lib_schema155.FieldType<string, string>;
         isOptional: true;
       };
       lastSyncAt: {
-        type: _contractspec_lib_schema102.FieldType<Date, string>;
+        type: _contractspec_lib_schema155.FieldType<Date, string>;
         isOptional: true;
       };
       itemsProcessed: {
-        type: _contractspec_lib_schema102.FieldType<number, number>;
+        type: _contractspec_lib_schema155.FieldType<number, number>;
         isOptional: true;
       };
       createdAt: {
-        type: _contractspec_lib_schema102.FieldType<Date, string>;
+        type: _contractspec_lib_schema155.FieldType<Date, string>;
         isOptional: true;
       };
       updatedAt: {
-        type: _contractspec_lib_schema102.FieldType<Date, string>;
+        type: _contractspec_lib_schema155.FieldType<Date, string>;
         isOptional: true;
       };
     }>;
@@ -295,20 +295,20 @@ declare const ListKnowledgeSources: OperationSpec<SchemaModel<{
 }>, undefined>;
 declare const TriggerKnowledgeSourceSync: OperationSpec<SchemaModel<{
   sourceId: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema155.FieldType<string, string>;
     isOptional: false;
   };
 }>, SchemaModel<{
   success: {
-    type: _contractspec_lib_schema102.FieldType<boolean, boolean>;
+    type: _contractspec_lib_schema155.FieldType<boolean, boolean>;
     isOptional: false;
   };
   itemsProcessed: {
-    type: _contractspec_lib_schema102.FieldType<number, number>;
+    type: _contractspec_lib_schema155.FieldType<number, number>;
     isOptional: true;
   };
   error: {
-    type: _contractspec_lib_schema102.FieldType<string, string>;
+    type: _contractspec_lib_schema155.FieldType<string, string>;
     isOptional: true;
   };
 }>, undefined>;

package/dist/versioning/index.d.ts

@@ -0,0 +1,3 @@
+import { ChangeEntry, ChangeType, ChangelogDocBlock, ChangelogEntry, ChangelogJsonExport, ChangelogResult, SemanticVersion, VersionAnalysis, VersionAnalysisResult, VersionBumpType, isChangeType, isChangelogDocBlock, isVersionBumpType } from "./types.js";
+import { bumpVersion, compareVersions, determineBumpType, formatVersion, getBumpTypePriority, getMaxBumpType, isValidVersion, isVersionEqual, isVersionGreater, isVersionLess, parseVersion, parseVersionStrict, validateVersion } from "./utils.js";
+export { ChangeEntry, ChangeType, ChangelogDocBlock, ChangelogEntry, ChangelogJsonExport, ChangelogResult, SemanticVersion, VersionAnalysis, VersionAnalysisResult, VersionBumpType, bumpVersion, compareVersions, determineBumpType, formatVersion, getBumpTypePriority, getMaxBumpType, isChangeType, isChangelogDocBlock, isValidVersion, isVersionBumpType, isVersionEqual, isVersionGreater, isVersionLess, parseVersion, parseVersionStrict, validateVersion };

package/dist/versioning/index.js

@@ -0,0 +1,4 @@
+import { isChangeType, isChangelogDocBlock, isVersionBumpType } from "./types.js";
+import { bumpVersion, compareVersions, determineBumpType, formatVersion, getBumpTypePriority, getMaxBumpType, isValidVersion, isVersionEqual, isVersionGreater, isVersionLess, parseVersion, parseVersionStrict, validateVersion } from "./utils.js";
+
+export { bumpVersion, compareVersions, determineBumpType, formatVersion, getBumpTypePriority, getMaxBumpType, isChangeType, isChangelogDocBlock, isValidVersion, isVersionBumpType, isVersionEqual, isVersionGreater, isVersionLess, parseVersion, parseVersionStrict, validateVersion };

package/dist/versioning/types.d.ts

@@ -0,0 +1,127 @@
+import { DocBlock } from "../docs/types.js";
+
+//#region src/versioning/types.d.ts
+
+/** Version bump type based on semantic versioning */
+type VersionBumpType = 'patch' | 'minor' | 'major';
+/** Semantic version components */
+interface SemanticVersion {
+  major: number;
+  minor: number;
+  patch: number;
+  prerelease?: string;
+  build?: string;
+}
+/** Type of change for changelog entries */
+type ChangeType = 'added' | 'changed' | 'fixed' | 'removed' | 'deprecated' | 'breaking' | 'security';
+/** Individual change entry */
+interface ChangeEntry {
+  /** Type of change */
+  type: ChangeType;
+  /** Human-readable description of the change */
+  description: string;
+  /** Schema/code path changed (e.g., "io.input.email", "meta.stability") */
+  path?: string;
+  /** Related issue/ticket reference (e.g., "GH-123", "JIRA-456") */
+  issueRef?: string;
+  /** Git commit SHA for traceability */
+  commitSha?: string;
+  /** Author of the change */
+  author?: string;
+}
+/** Changelog entry for a specific version */
+interface ChangelogEntry {
+  /** Version number (semver format) */
+  version: string;
+  /** Release date (ISO 8601 format) */
+  date: string;
+  /** Type of version bump that led to this version */
+  bumpType: VersionBumpType;
+  /** List of changes in this version */
+  changes: ChangeEntry[];
+  /** Breaking changes (subset for emphasis) */
+  breakingChanges?: ChangeEntry[];
+  /** Deprecation notices */
+  deprecations?: ChangeEntry[];
+  /** Contributors to this version */
+  contributors?: string[];
+  /** Release notes summary */
+  summary?: string;
+}
+/** DocBlock extension for per-spec changelogs */
+interface ChangelogDocBlock extends DocBlock {
+  /** Changelog-specific kind */
+  kind: 'changelog';
+  /** Related spec key (e.g., "auth.beginSignup") */
+  specKey: string;
+  /** Current spec version */
+  specVersion: string;
+  /** Changelog entries for this spec */
+  entries: ChangelogEntry[];
+}
+/** Result of version analysis for a single spec */
+interface VersionAnalysis {
+  /** Path to the spec file */
+  specPath: string;
+  /** Spec key (e.g., "auth.login") */
+  specKey: string;
+  /** Current version in the spec */
+  currentVersion: string;
+  /** Suggested new version based on changes */
+  suggestedVersion: string;
+  /** Suggested bump type */
+  bumpType: VersionBumpType;
+  /** Detected changes requiring version bump */
+  changes: ChangeEntry[];
+  /** Whether breaking changes were detected */
+  hasBreaking: boolean;
+}
+/** Aggregated version analysis result */
+interface VersionAnalysisResult {
+  /** Individual spec analyses */
+  analyses: VersionAnalysis[];
+  /** Total specs analyzed */
+  totalSpecs: number;
+  /** Specs needing version bump */
+  specsNeedingBump: number;
+  /** Total breaking changes across all specs */
+  totalBreaking: number;
+  /** Git baseline used for comparison */
+  baseline?: string;
+}
+/** Result of changelog generation */
+interface ChangelogResult {
+  /** Per-spec DocBlock entries */
+  specChangelogs: ChangelogDocBlock[];
+  /** Library-level markdown by package path */
+  libraryMarkdown: Map<string, string>;
+  /** Monorepo-level markdown */
+  monorepoMarkdown: string;
+  /** JSON format for programmatic use */
+  json: ChangelogJsonExport;
+}
+/** JSON export format for changelogs */
+interface ChangelogJsonExport {
+  generatedAt: string;
+  baseline?: string;
+  specs: {
+    key: string;
+    version: string;
+    path: string;
+    entries: ChangelogEntry[];
+  }[];
+  libraries: {
+    name: string;
+    path: string;
+    version: string;
+    entries: ChangelogEntry[];
+  }[];
+}
+/** Check if a DocBlock is a ChangelogDocBlock */
+declare function isChangelogDocBlock(doc: DocBlock): doc is ChangelogDocBlock;
+/** Check if a string is a valid VersionBumpType */
+declare function isVersionBumpType(value: unknown): value is VersionBumpType;
+/** Check if a string is a valid ChangeType */
+declare function isChangeType(value: unknown): value is ChangeType;
+//#endregion
+export { ChangeEntry, ChangeType, ChangelogDocBlock, ChangelogEntry, ChangelogJsonExport, ChangelogResult, SemanticVersion, VersionAnalysis, VersionAnalysisResult, VersionBumpType, isChangeType, isChangelogDocBlock, isVersionBumpType };

package/dist/versioning/types.js

@@ -0,0 +1,24 @@
+//#region src/versioning/types.ts
+/** Check if a DocBlock is a ChangelogDocBlock */
+function isChangelogDocBlock(doc) {
+	return doc.kind === "changelog" && "specKey" in doc && "entries" in doc;
+}
+/** Check if a string is a valid VersionBumpType */
+function isVersionBumpType(value) {
+	return value === "patch" || value === "minor" || value === "major";
+}
+/** Check if a string is a valid ChangeType */
+function isChangeType(value) {
+	return typeof value === "string" && [
+		"added",
+		"changed",
+		"fixed",
+		"removed",
+		"deprecated",
+		"breaking",
+		"security"
+	].includes(value);
+}
+
+//#endregion
+export { isChangeType, isChangelogDocBlock, isVersionBumpType };

package/dist/versioning/utils.d.ts

@@ -0,0 +1,95 @@
+import { SemanticVersion, VersionBumpType } from "./types.js";
+
+//#region src/versioning/utils.d.ts
+
+/**
+ * Parse a semantic version string into components.
+ *
+ * @param version - Version string (e.g., "1.2.3", "1.0.0-alpha.1")
+ * @returns Parsed SemanticVersion or null if invalid
+ *
+ * @example
+ * parseVersion("1.2.3") // { major: 1, minor: 2, patch: 3 }
+ * parseVersion("2.0.0-beta.1") // { major: 2, minor: 0, patch: 0, prerelease: "beta.1" }
+ */
+declare function parseVersion(version: string): SemanticVersion | null;
+/**
+ * Strictly parse a version, throwing on invalid input.
+ *
+ * @throws Error if version is not valid semver
+ */
+declare function parseVersionStrict(version: string): SemanticVersion;
+/**
+ * Format a SemanticVersion back to string.
+ *
+ * @example
+ * formatVersion({ major: 1, minor: 2, patch: 3 }) // "1.2.3"
+ * formatVersion({ major: 2, minor: 0, patch: 0, prerelease: "beta.1" }) // "2.0.0-beta.1"
+ */
+declare function formatVersion(version: SemanticVersion): string;
+/**
+ * Compare two version strings.
+ *
+ * @returns -1 if a < b, 0 if a === b, 1 if a > b
+ *
+ * @example
+ * compareVersions("1.0.0", "2.0.0") // -1
+ * compareVersions("1.2.3", "1.2.3") // 0
+ * compareVersions("2.0.0", "1.9.9") // 1
+ */
+declare function compareVersions(a: string, b: string): -1 | 0 | 1;
+/**
+ * Check if version a is greater than version b.
+ */
+declare function isVersionGreater(a: string, b: string): boolean;
+/**
+ * Check if version a is less than version b.
+ */
+declare function isVersionLess(a: string, b: string): boolean;
+/**
+ * Check if two versions are equal.
+ */
+declare function isVersionEqual(a: string, b: string): boolean;
+/**
+ * Bump a version by the specified type.
+ *
+ * @param current - Current version string
+ * @param bumpType - Type of bump: 'patch', 'minor', or 'major'
+ * @returns New version string
+ *
+ * @example
+ * bumpVersion("1.2.3", "patch") // "1.2.4"
+ * bumpVersion("1.2.3", "minor") // "1.3.0"
+ * bumpVersion("1.2.3", "major") // "2.0.0"
+ */
+declare function bumpVersion(current: string, bumpType: VersionBumpType): string;
+/**
+ * Determine the appropriate version bump type based on change impact.
+ *
+ * - Breaking changes → major
+ * - Non-breaking additions/changes → minor
+ * - Fixes only → patch
+ *
+ * @param hasBreaking - Whether breaking changes were detected
+ * @param hasNonBreaking - Whether non-breaking changes (additions, changes) were detected
+ * @returns Appropriate bump type
+ */
+declare function determineBumpType(hasBreaking: boolean, hasNonBreaking: boolean): VersionBumpType;
+/**
+ * Get sort priority for bump types (higher = more significant).
+ */
+declare function getBumpTypePriority(bumpType: VersionBumpType): number;
+/**
+ * Get the most significant bump type from a list.
+ */
+declare function getMaxBumpType(bumpTypes: VersionBumpType[]): VersionBumpType | null;
+/**
+ * Check if a string is a valid semantic version.
+ */
+declare function isValidVersion(version: string): boolean;
+/**
+ * Validate a version string, returning validation errors.
+ */
+declare function validateVersion(version: string): string[];
+//#endregion
+export { bumpVersion, compareVersions, determineBumpType, formatVersion, getBumpTypePriority, getMaxBumpType, isValidVersion, isVersionEqual, isVersionGreater, isVersionLess, parseVersion, parseVersionStrict, validateVersion };