@contractspec/lib.contracts 1.45.1 → 1.45.3

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 };

package/dist/versioning/utils.js

@@ -0,0 +1,180 @@
+//#region src/versioning/utils.ts
+/** Regex for parsing semantic versions */
+const SEMVER_REGEX = /^(\d+)\.(\d+)\.(\d+)(?:-([a-zA-Z0-9]+(?:\.[a-zA-Z0-9]+)*))?(?:\+([a-zA-Z0-9]+(?:\.[a-zA-Z0-9]+)*))?$/;
+/**
+* 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" }
+*/
+function parseVersion(version) {
+	const match = version.trim().match(SEMVER_REGEX);
+	if (!match) return null;
+	const majorStr = match[1];
+	const minorStr = match[2];
+	const patchStr = match[3];
+	const prerelease = match[4];
+	const build = match[5];
+	if (!majorStr || !minorStr || !patchStr) return null;
+	return {
+		major: parseInt(majorStr, 10),
+		minor: parseInt(minorStr, 10),
+		patch: parseInt(patchStr, 10),
+		...prerelease && { prerelease },
+		...build && { build }
+	};
+}
+/**
+* Strictly parse a version, throwing on invalid input.
+*
+* @throws Error if version is not valid semver
+*/
+function parseVersionStrict(version) {
+	const parsed = parseVersion(version);
+	if (!parsed) throw new Error(`Invalid semantic version: "${version}"`);
+	return parsed;
+}
+/**
+* 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"
+*/
+function formatVersion(version) {
+	let result = `${version.major}.${version.minor}.${version.patch}`;
+	if (version.prerelease) result += `-${version.prerelease}`;
+	if (version.build) result += `+${version.build}`;
+	return result;
+}
+/**
+* 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
+*/
+function compareVersions(a, b) {
+	const versionA = parseVersionStrict(a);
+	const versionB = parseVersionStrict(b);
+	if (versionA.major !== versionB.major) return versionA.major > versionB.major ? 1 : -1;
+	if (versionA.minor !== versionB.minor) return versionA.minor > versionB.minor ? 1 : -1;
+	if (versionA.patch !== versionB.patch) return versionA.patch > versionB.patch ? 1 : -1;
+	if (versionA.prerelease && !versionB.prerelease) return -1;
+	if (!versionA.prerelease && versionB.prerelease) return 1;
+	if (versionA.prerelease && versionB.prerelease) return versionA.prerelease < versionB.prerelease ? -1 : versionA.prerelease > versionB.prerelease ? 1 : 0;
+	return 0;
+}
+/**
+* Check if version a is greater than version b.
+*/
+function isVersionGreater(a, b) {
+	return compareVersions(a, b) === 1;
+}
+/**
+* Check if version a is less than version b.
+*/
+function isVersionLess(a, b) {
+	return compareVersions(a, b) === -1;
+}
+/**
+* Check if two versions are equal.
+*/
+function isVersionEqual(a, b) {
+	return compareVersions(a, b) === 0;
+}
+/**
+* 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"
+*/
+function bumpVersion(current, bumpType) {
+	const version = parseVersionStrict(current);
+	switch (bumpType) {
+		case "major": return formatVersion({
+			major: version.major + 1,
+			minor: 0,
+			patch: 0
+		});
+		case "minor": return formatVersion({
+			major: version.major,
+			minor: version.minor + 1,
+			patch: 0
+		});
+		case "patch": return formatVersion({
+			major: version.major,
+			minor: version.minor,
+			patch: version.patch + 1
+		});
+	}
+}
+/**
+* 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
+*/
+function determineBumpType(hasBreaking, hasNonBreaking) {
+	if (hasBreaking) return "major";
+	if (hasNonBreaking) return "minor";
+	return "patch";
+}
+/**
+* Get sort priority for bump types (higher = more significant).
+*/
+function getBumpTypePriority(bumpType) {
+	switch (bumpType) {
+		case "major": return 3;
+		case "minor": return 2;
+		case "patch": return 1;
+	}
+}
+/**
+* Get the most significant bump type from a list.
+*/
+function getMaxBumpType(bumpTypes) {
+	if (bumpTypes.length === 0) return null;
+	return bumpTypes.reduce((max, current) => getBumpTypePriority(current) > getBumpTypePriority(max) ? current : max);
+}
+/**
+* Check if a string is a valid semantic version.
+*/
+function isValidVersion(version) {
+	return parseVersion(version) !== null;
+}
+/**
+* Validate a version string, returning validation errors.
+*/
+function validateVersion(version) {
+	const errors = [];
+	if (!version || typeof version !== "string") {
+		errors.push("Version must be a non-empty string");
+		return errors;
+	}
+	const trimmed = version.trim();
+	if (trimmed !== version) errors.push("Version should not have leading or trailing whitespace");
+	if (!parseVersion(trimmed)) errors.push(`Invalid semantic version format: "${version}". Expected format: MAJOR.MINOR.PATCH[-prerelease][+build]`);
+	return errors;
+}
+
+//#endregion
+export { bumpVersion, compareVersions, determineBumpType, formatVersion, getBumpTypePriority, getMaxBumpType, isValidVersion, isVersionEqual, isVersionGreater, isVersionLess, parseVersion, parseVersionStrict, validateVersion };

package/dist/workspace-config/contractsrc-schema.d.ts

@@ -294,6 +294,55 @@ declare const FormatterConfigSchema: z$2.ZodObject<{
   args: z$2.ZodOptional<z$2.ZodArray<z$2.ZodString>>;
   timeout: z$2.ZodDefault<z$2.ZodNumber>;
 }, z$2.core.$strip>;
+/**
+ * Bump strategy for version management.
+ */
+declare const BumpStrategySchema: z$2.ZodEnum<{
+  impact: "impact";
+  conventional: "conventional";
+}>;
+/**
+ * Changelog format template.
+ */
+declare const ChangelogFormatSchema: z$2.ZodEnum<{
+  custom: "custom";
+  conventional: "conventional";
+  "keep-a-changelog": "keep-a-changelog";
+}>;
+/**
+ * Changelog tier configuration.
+ */
+declare const ChangelogTierSchema: z$2.ZodEnum<{
+  spec: "spec";
+  library: "library";
+  monorepo: "monorepo";
+}>;
+/**
+ * Versioning configuration for changelog and version management.
+ */
+declare const VersioningConfigSchema: z$2.ZodObject<{
+  autoBump: z$2.ZodDefault<z$2.ZodBoolean>;
+  bumpStrategy: z$2.ZodDefault<z$2.ZodEnum<{
+    impact: "impact";
+    conventional: "conventional";
+  }>>;
+  changelogTiers: z$2.ZodDefault<z$2.ZodArray<z$2.ZodEnum<{
+    spec: "spec";
+    library: "library";
+    monorepo: "monorepo";
+  }>>>;
+  format: z$2.ZodDefault<z$2.ZodEnum<{
+    custom: "custom";
+    conventional: "conventional";
+    "keep-a-changelog": "keep-a-changelog";
+  }>>;
+  commitChanges: z$2.ZodDefault<z$2.ZodBoolean>;
+  commitMessage: z$2.ZodDefault<z$2.ZodString>;
+  createTags: z$2.ZodDefault<z$2.ZodBoolean>;
+  tagPrefix: z$2.ZodDefault<z$2.ZodString>;
+  include: z$2.ZodOptional<z$2.ZodArray<z$2.ZodString>>;
+  exclude: z$2.ZodOptional<z$2.ZodArray<z$2.ZodString>>;
+}, z$2.core.$strip>;
 /**
  * Rule severity levels (inspired by ESLint).
  */
@@ -833,6 +882,29 @@ declare const ContractsrcSchema: z$2.ZodObject<{
     args: z$2.ZodOptional<z$2.ZodArray<z$2.ZodString>>;
     timeout: z$2.ZodDefault<z$2.ZodNumber>;
   }, z$2.core.$strip>>;
+  versioning: z$2.ZodOptional<z$2.ZodObject<{
+    autoBump: z$2.ZodDefault<z$2.ZodBoolean>;
+    bumpStrategy: z$2.ZodDefault<z$2.ZodEnum<{
+      impact: "impact";
+      conventional: "conventional";
+    }>>;
+    changelogTiers: z$2.ZodDefault<z$2.ZodArray<z$2.ZodEnum<{
+      spec: "spec";
+      library: "library";
+      monorepo: "monorepo";
+    }>>>;
+    format: z$2.ZodDefault<z$2.ZodEnum<{
+      custom: "custom";
+      conventional: "conventional";
+      "keep-a-changelog": "keep-a-changelog";
+    }>>;
+    commitChanges: z$2.ZodDefault<z$2.ZodBoolean>;
+    commitMessage: z$2.ZodDefault<z$2.ZodString>;
+    createTags: z$2.ZodDefault<z$2.ZodBoolean>;
+    tagPrefix: z$2.ZodDefault<z$2.ZodString>;
+    include: z$2.ZodOptional<z$2.ZodArray<z$2.ZodString>>;
+    exclude: z$2.ZodOptional<z$2.ZodArray<z$2.ZodString>>;
+  }, z$2.core.$strip>>;
 }, z$2.core.$strip>;
 type OpenApiSourceConfig = z$2.infer<typeof OpenApiSourceConfigSchema>;
 type OpenApiExportConfig = z$2.infer<typeof OpenApiExportConfigSchema>;
@@ -854,9 +926,13 @@ type RulesConfig = z$2.infer<typeof RulesConfigSchema>;
 type SchemaFormat = z$2.infer<typeof SchemaFormatSchema>;
 type FormatterType = z$2.infer<typeof FormatterTypeSchema>;
 type FormatterConfig = z$2.infer<typeof FormatterConfigSchema>;
+type BumpStrategy = z$2.infer<typeof BumpStrategySchema>;
+type ChangelogFormat = z$2.infer<typeof ChangelogFormatSchema>;
+type ChangelogTier = z$2.infer<typeof ChangelogTierSchema>;
+type VersioningConfig = z$2.infer<typeof VersioningConfigSchema>;
 /**
  * Default configuration values.
  */
 declare const DEFAULT_CONTRACTSRC: ContractsrcConfig;
 //#endregion
-export { CheckRunConfig, CheckRunConfigSchema, CiConfig, CiConfigSchema, ContractsrcConfig, ContractsrcSchema, DEFAULT_CONTRACTSRC, ExternalWorkspace, ExternalWorkspaceSchema, FolderConventions, FolderConventionsSchema, FormatterConfig, FormatterConfigSchema, FormatterType, FormatterTypeSchema, GroupingRule, GroupingRuleSchema, GroupingStrategy, GroupingStrategySchema, ImpactConfig, ImpactConfigSchema, LintRules, LintRulesSchema, MetaRepoConfig, MetaRepoConfigSchema, OpenApiConfig, OpenApiConfigSchema, OpenApiExportConfig, OpenApiExportConfigSchema, OpenApiSourceConfig, OpenApiSourceConfigSchema, PrCommentConfig, PrCommentConfigSchema, RuleSeverity, RuleSeveritySchema, RulesConfig, RulesConfigSchema, SchemaFormat, SchemaFormatSchema, SpecKind, SpecKindSchema };
+export { BumpStrategy, BumpStrategySchema, ChangelogFormat, ChangelogFormatSchema, ChangelogTier, ChangelogTierSchema, CheckRunConfig, CheckRunConfigSchema, CiConfig, CiConfigSchema, ContractsrcConfig, ContractsrcSchema, DEFAULT_CONTRACTSRC, ExternalWorkspace, ExternalWorkspaceSchema, FolderConventions, FolderConventionsSchema, FormatterConfig, FormatterConfigSchema, FormatterType, FormatterTypeSchema, GroupingRule, GroupingRuleSchema, GroupingStrategy, GroupingStrategySchema, ImpactConfig, ImpactConfigSchema, LintRules, LintRulesSchema, MetaRepoConfig, MetaRepoConfigSchema, OpenApiConfig, OpenApiConfigSchema, OpenApiExportConfig, OpenApiExportConfigSchema, OpenApiSourceConfig, OpenApiSourceConfigSchema, PrCommentConfig, PrCommentConfigSchema, RuleSeverity, RuleSeveritySchema, RulesConfig, RulesConfigSchema, SchemaFormat, SchemaFormatSchema, SpecKind, SpecKindSchema, VersioningConfig, VersioningConfigSchema };

package/dist/workspace-config/contractsrc-schema.js

@@ -178,6 +178,45 @@ const FormatterConfigSchema = z$2.object({
 	timeout: z$2.number().default(3e4)
 });
 /**
+* Bump strategy for version management.
+*/
+const BumpStrategySchema = z$2.enum(["impact", "conventional"]);
+/**
+* Changelog format template.
+*/
+const ChangelogFormatSchema = z$2.enum([
+	"keep-a-changelog",
+	"conventional",
+	"custom"
+]);
+/**
+* Changelog tier configuration.
+*/
+const ChangelogTierSchema = z$2.enum([
+	"spec",
+	"library",
+	"monorepo"
+]);
+/**
+* Versioning configuration for changelog and version management.
+*/
+const VersioningConfigSchema = z$2.object({
+	autoBump: z$2.boolean().default(false),
+	bumpStrategy: BumpStrategySchema.default("impact"),
+	changelogTiers: z$2.array(ChangelogTierSchema).default([
+		"spec",
+		"library",
+		"monorepo"
+	]),
+	format: ChangelogFormatSchema.default("keep-a-changelog"),
+	commitChanges: z$2.boolean().default(false),
+	commitMessage: z$2.string().default("chore: bump spec versions"),
+	createTags: z$2.boolean().default(false),
+	tagPrefix: z$2.string().default("v"),
+	include: z$2.array(z$2.string()).optional(),
+	exclude: z$2.array(z$2.string()).optional()
+});
+/**
 * Rule severity levels (inspired by ESLint).
 */
 const RuleSeveritySchema = z$2.enum([
@@ -255,7 +294,8 @@ const ContractsrcSchema = z$2.object({
 	metaRepo: MetaRepoConfigSchema.optional(),
 	rules: RulesConfigSchema.optional(),
 	schemaFormat: SchemaFormatSchema.default("contractspec"),
-	formatter: FormatterConfigSchema.optional()
+	formatter: FormatterConfigSchema.optional(),
+	versioning: VersioningConfigSchema.optional()
 });
 /**
 * Default configuration values.
@@ -278,4 +318,4 @@ const DEFAULT_CONTRACTSRC = {
 };
 
 //#endregion
-export { CheckRunConfigSchema, CiConfigSchema, ContractsrcSchema, DEFAULT_CONTRACTSRC, ExternalWorkspaceSchema, FolderConventionsSchema, FormatterConfigSchema, FormatterTypeSchema, GroupingRuleSchema, GroupingStrategySchema, ImpactConfigSchema, LintRulesSchema, MetaRepoConfigSchema, OpenApiConfigSchema, OpenApiExportConfigSchema, OpenApiSourceConfigSchema, PrCommentConfigSchema, RuleSeveritySchema, RulesConfigSchema, SchemaFormatSchema, SpecKindSchema };
+export { BumpStrategySchema, ChangelogFormatSchema, ChangelogTierSchema, CheckRunConfigSchema, CiConfigSchema, ContractsrcSchema, DEFAULT_CONTRACTSRC, ExternalWorkspaceSchema, FolderConventionsSchema, FormatterConfigSchema, FormatterTypeSchema, GroupingRuleSchema, GroupingStrategySchema, ImpactConfigSchema, LintRulesSchema, MetaRepoConfigSchema, OpenApiConfigSchema, OpenApiExportConfigSchema, OpenApiSourceConfigSchema, PrCommentConfigSchema, RuleSeveritySchema, RulesConfigSchema, SchemaFormatSchema, SpecKindSchema, VersioningConfigSchema };

package/dist/workspace-config/index.d.ts

@@ -1,2 +1,2 @@
-import { ContractsrcConfig, ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventions, FolderConventionsSchema, FormatterConfig, FormatterConfigSchema, FormatterType, FormatterTypeSchema, OpenApiConfig, OpenApiConfigSchema, OpenApiExportConfig, OpenApiExportConfigSchema, OpenApiSourceConfig, OpenApiSourceConfigSchema, SchemaFormat, SchemaFormatSchema } from "./contractsrc-schema.js";
-export { type ContractsrcConfig, ContractsrcSchema, DEFAULT_CONTRACTSRC, type FolderConventions, FolderConventionsSchema, type FormatterConfig, FormatterConfigSchema, type FormatterType, FormatterTypeSchema, type OpenApiConfig, OpenApiConfigSchema, type OpenApiExportConfig, OpenApiExportConfigSchema, type OpenApiSourceConfig, OpenApiSourceConfigSchema, type SchemaFormat, SchemaFormatSchema };
+import { BumpStrategy, BumpStrategySchema, ChangelogFormat, ChangelogFormatSchema, ChangelogTier, ChangelogTierSchema, ContractsrcConfig, ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventions, FolderConventionsSchema, FormatterConfig, FormatterConfigSchema, FormatterType, FormatterTypeSchema, OpenApiConfig, OpenApiConfigSchema, OpenApiExportConfig, OpenApiExportConfigSchema, OpenApiSourceConfig, OpenApiSourceConfigSchema, SchemaFormat, SchemaFormatSchema, VersioningConfig, VersioningConfigSchema } from "./contractsrc-schema.js";
+export { type BumpStrategy, BumpStrategySchema, type ChangelogFormat, ChangelogFormatSchema, type ChangelogTier, ChangelogTierSchema, type ContractsrcConfig, ContractsrcSchema, DEFAULT_CONTRACTSRC, type FolderConventions, FolderConventionsSchema, type FormatterConfig, FormatterConfigSchema, type FormatterType, FormatterTypeSchema, type OpenApiConfig, OpenApiConfigSchema, type OpenApiExportConfig, OpenApiExportConfigSchema, type OpenApiSourceConfig, OpenApiSourceConfigSchema, type SchemaFormat, SchemaFormatSchema, type VersioningConfig, VersioningConfigSchema };

package/dist/workspace-config/index.js

@@ -1,3 +1,3 @@
-import { ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventionsSchema, FormatterConfigSchema, FormatterTypeSchema, OpenApiConfigSchema, OpenApiExportConfigSchema, OpenApiSourceConfigSchema, SchemaFormatSchema } from "./contractsrc-schema.js";
+import { BumpStrategySchema, ChangelogFormatSchema, ChangelogTierSchema, ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventionsSchema, FormatterConfigSchema, FormatterTypeSchema, OpenApiConfigSchema, OpenApiExportConfigSchema, OpenApiSourceConfigSchema, SchemaFormatSchema, VersioningConfigSchema } from "./contractsrc-schema.js";
 
-export { ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventionsSchema, FormatterConfigSchema, FormatterTypeSchema, OpenApiConfigSchema, OpenApiExportConfigSchema, OpenApiSourceConfigSchema, SchemaFormatSchema };
+export { BumpStrategySchema, ChangelogFormatSchema, ChangelogTierSchema, ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventionsSchema, FormatterConfigSchema, FormatterTypeSchema, OpenApiConfigSchema, OpenApiExportConfigSchema, OpenApiSourceConfigSchema, SchemaFormatSchema, VersioningConfigSchema };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/lib.contracts",
-  "version": "1.45.1",
+  "version": "1.45.3",
   "description": "Core contract specification definitions and runtime",
   "keywords": [
     "contractspec",
@@ -25,8 +25,8 @@
     "test": "bun test"
   },
   "devDependencies": {
-    "@contractspec/tool.tsdown": "1.45.1",
-    "@contractspec/tool.typescript": "1.45.1",
+    "@contractspec/tool.tsdown": "1.45.3",
+    "@contractspec/tool.typescript": "1.45.3",
     "@types/express": "^5.0.3",
     "@types/turndown": "^5.0.6",
     "tsdown": "^0.18.3",
@@ -35,8 +35,8 @@
   "dependencies": {
     "@aws-sdk/client-secrets-manager": "^3.958.0",
     "@aws-sdk/client-sqs": "^3.958.0",
-    "@contractspec/lib.logger": "1.45.1",
-    "@contractspec/lib.schema": "1.45.1",
+    "@contractspec/lib.logger": "1.45.3",
+    "@contractspec/lib.schema": "1.45.3",
     "@elevenlabs/elevenlabs-js": "^2.27.0",
     "@google-cloud/secret-manager": "^6.1.1",
     "@google-cloud/storage": "^7.18.0",
@@ -334,6 +334,9 @@
     "./translations/catalog": "./dist/translations/catalog.js",
     "./translations/tenant": "./dist/translations/tenant.js",
     "./types": "./dist/types.js",
+    "./versioning": "./dist/versioning/index.js",
+    "./versioning/types": "./dist/versioning/types.js",
+    "./versioning/utils": "./dist/versioning/utils.js",
     "./workflow": "./dist/workflow/index.js",
     "./workflow/adapters": "./dist/workflow/adapters/index.js",
     "./workflow/adapters/db-adapter": "./dist/workflow/adapters/db-adapter.js",