@codluv/versionguard 0.2.0 → 0.4.0

package/dist/sources/toml.d.ts

@@ -0,0 +1,60 @@
+/**
+ * TOML-based version source provider for Cargo.toml and pyproject.toml.
+ *
+ * @packageDocumentation
+ */
+import type { VersionSourceProvider } from './provider';
+/**
+ * Reads and writes version strings from TOML manifest files.
+ *
+ * @remarks
+ * Uses targeted regex replacement for writes to preserve file formatting,
+ * comments, and whitespace. Supports standard section headers, dotted keys,
+ * and inline table syntax.
+ *
+ * @public
+ * @since 0.3.0
+ */
+export declare class TomlVersionSource implements VersionSourceProvider {
+    /** Human-readable provider name. */
+    readonly name: string;
+    /** Filename of the TOML manifest (e.g. `'Cargo.toml'`). */
+    readonly manifestFile: string;
+    /** Dotted key path to the version field within the TOML document. */
+    private readonly versionPath;
+    /**
+     * Creates a new TOML version source.
+     *
+     * @param manifestFile - TOML manifest filename.
+     * @param versionPath - Dotted key path to the version field.
+     */
+    constructor(manifestFile?: string, versionPath?: string);
+    /**
+     * Returns `true` when the manifest file exists in `cwd`.
+     *
+     * @param cwd - Project directory to check.
+     * @returns Whether the manifest file exists.
+     */
+    exists(cwd: string): boolean;
+    /**
+     * Reads the version string from the TOML manifest.
+     *
+     * @param cwd - Project directory containing the manifest.
+     * @returns The version string extracted from the manifest.
+     */
+    getVersion(cwd: string): string;
+    /**
+     * Writes a version string to the TOML manifest, preserving formatting.
+     *
+     * @param version - Version string to write.
+     * @param cwd - Project directory containing the manifest.
+     */
+    setVersion(version: string, cwd: string): void;
+    /**
+     * Splits the dotted version path into a TOML section name and key name.
+     *
+     * @returns An object with `section` and `key` components.
+     */
+    private getSectionKey;
+}
+//# sourceMappingURL=toml.d.ts.map

package/dist/sources/toml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toml.d.ts","sourceRoot":"","sources":["../../src/sources/toml.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGxD;;;;;;;;;;GAUG;AACH,qBAAa,iBAAkB,YAAW,qBAAqB;IAC7D,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,2DAA2D;IAC3D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,qEAAqE;IACrE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC;;;;;OAKG;gBACS,YAAY,GAAE,MAAqB,EAAE,WAAW,GAAE,MAA0B;IAMxF;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;;;;OAKG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAiB/B;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAiB9C;;;;OAIG;IACH,OAAO,CAAC,aAAa;CAUtB"}

package/dist/sources/utils.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Shared utilities for version source providers.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Traverses a nested object using a dotted key path.
+ *
+ * @remarks
+ * Walks each segment of the dotted path in order, returning `undefined` as
+ * soon as a missing or non-object segment is encountered.
+ *
+ * @param obj - Object to traverse.
+ * @param dotPath - Dot-separated key path (e.g. `'package.version'`).
+ * @returns The value at the path, or `undefined` if any segment is missing.
+ *
+ * @example
+ * ```ts
+ * import { getNestedValue } from './utils';
+ *
+ * const obj = { package: { version: '1.0.0' } };
+ * const version = getNestedValue(obj, 'package.version'); // '1.0.0'
+ * ```
+ *
+ * @public
+ * @since 0.3.0
+ */
+export declare function getNestedValue(obj: Record<string, unknown>, dotPath: string): unknown;
+/**
+ * Sets a value at a dotted key path, throwing if intermediate segments are missing.
+ *
+ * @remarks
+ * Traverses each intermediate segment and throws when a segment is missing or
+ * not an object. The final key is created or overwritten.
+ *
+ * @param obj - Object to mutate.
+ * @param dotPath - Dot-separated key path.
+ * @param value - Value to set at the final key.
+ *
+ * @example
+ * ```ts
+ * import { setNestedValue } from './utils';
+ *
+ * const obj = { package: { version: '1.0.0' } };
+ * setNestedValue(obj, 'package.version', '2.0.0');
+ * ```
+ *
+ * @public
+ * @since 0.3.0
+ */
+export declare function setNestedValue(obj: Record<string, unknown>, dotPath: string, value: unknown): void;
+/**
+ * Escapes special regex characters in a string for safe use in `new RegExp()`.
+ *
+ * @remarks
+ * Prefixes every character that has special meaning in a regular expression
+ * with a backslash so the resulting string matches literally.
+ *
+ * @param value - Raw string to escape.
+ * @returns The escaped string safe for embedding in a `RegExp` constructor.
+ *
+ * @example
+ * ```ts
+ * import { escapeRegExp } from './utils';
+ *
+ * const escaped = escapeRegExp('file.txt'); // 'file\\.txt'
+ * ```
+ *
+ * @public
+ * @since 0.3.0
+ */
+export declare function escapeRegExp(value: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/sources/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/sources/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CASrF;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,GACb,IAAI,CAWN;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/sources/version-file.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Plain text VERSION file provider.
+ *
+ * @packageDocumentation
+ */
+import type { VersionSourceProvider } from './provider';
+/**
+ * Reads and writes version strings from a plain text VERSION file.
+ *
+ * @remarks
+ * The file is expected to contain only the version string, optionally
+ * followed by a trailing newline. Binary files and empty files are
+ * rejected with a descriptive error.
+ *
+ * @public
+ * @since 0.3.0
+ */
+export declare class VersionFileSource implements VersionSourceProvider {
+    /** Human-readable provider name. */
+    readonly name: string;
+    /** Filename of the version file (e.g. `'VERSION'`). */
+    readonly manifestFile: string;
+    /**
+     * Creates a new plain text version file source.
+     *
+     * @param manifestFile - Version filename.
+     */
+    constructor(manifestFile?: string);
+    /**
+     * Returns `true` when the version file exists in `cwd`.
+     *
+     * @param cwd - Project directory to check.
+     * @returns Whether the version file exists.
+     */
+    exists(cwd: string): boolean;
+    /**
+     * Reads the version string from the plain text version file.
+     *
+     * @param cwd - Project directory containing the version file.
+     * @returns The version string from the first line of the file.
+     */
+    getVersion(cwd: string): string;
+    /**
+     * Writes a version string to the plain text version file.
+     *
+     * @param version - Version string to write.
+     * @param cwd - Project directory containing the version file.
+     */
+    setVersion(version: string, cwd: string): void;
+}
+//# sourceMappingURL=version-file.d.ts.map

package/dist/sources/version-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-file.d.ts","sourceRoot":"","sources":["../../src/sources/version-file.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;;;;;;GAUG;AACH,qBAAa,iBAAkB,YAAW,qBAAqB;IAC7D,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,uDAAuD;IACvD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;;;OAIG;gBACS,YAAY,GAAE,MAAkB;IAK5C;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;;;;OAKG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAsB/B;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;CAO/C"}

package/dist/sources/yaml.d.ts

@@ -0,0 +1,53 @@
+/**
+ * YAML-based version source provider for pubspec.yaml and similar manifests.
+ *
+ * @packageDocumentation
+ */
+import type { VersionSourceProvider } from './provider';
+/**
+ * Reads and writes version strings from YAML manifest files.
+ *
+ * @remarks
+ * Supports dotted key paths (e.g. `'flutter.version'`) for nested values.
+ * Uses targeted regex replacement for writes to preserve comments and formatting.
+ *
+ * @public
+ * @since 0.3.0
+ */
+export declare class YamlVersionSource implements VersionSourceProvider {
+    /** Human-readable provider name. */
+    readonly name: string;
+    /** Filename of the YAML manifest (e.g. `'pubspec.yaml'`). */
+    readonly manifestFile: string;
+    /** Dotted key path to the version field within the YAML document. */
+    private readonly versionKey;
+    /**
+     * Creates a new YAML version source.
+     *
+     * @param manifestFile - YAML manifest filename.
+     * @param versionKey - Dotted key path to the version field.
+     */
+    constructor(manifestFile?: string, versionKey?: string);
+    /**
+     * Returns `true` when the manifest file exists in `cwd`.
+     *
+     * @param cwd - Project directory to check.
+     * @returns Whether the manifest file exists.
+     */
+    exists(cwd: string): boolean;
+    /**
+     * Reads the version string from the YAML manifest.
+     *
+     * @param cwd - Project directory containing the manifest.
+     * @returns The version string extracted from the manifest.
+     */
+    getVersion(cwd: string): string;
+    /**
+     * Writes a version string to the YAML manifest, preserving formatting.
+     *
+     * @param version - Version string to write.
+     * @param cwd - Project directory containing the manifest.
+     */
+    setVersion(version: string, cwd: string): void;
+}
+//# sourceMappingURL=yaml.d.ts.map

package/dist/sources/yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.d.ts","sourceRoot":"","sources":["../../src/sources/yaml.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGxD;;;;;;;;;GASG;AACH,qBAAa,iBAAkB,YAAW,qBAAqB;IAC7D,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,6DAA6D;IAC7D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,qEAAqE;IACrE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC;;;;;OAKG;gBACS,YAAY,GAAE,MAAuB,EAAE,UAAU,GAAE,MAAkB;IAMjF;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;;;;OAKG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAyB/B;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;CAqB/C"}

package/dist/tag/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tag/index.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,EAAE,IAAI,CAAC;CACZ;AAcD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,GAAG,IAAI,CAoBxE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,EAAE,CAgBjE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,GAAE,OAAc,EACvB,MAAM,CAAC,EAAE,kBAAkB,EAC3B,GAAG,GAAE,MAAsB,GAC1B;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CA0E1D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,kBAAkB,EAC1B,GAAG,GAAE,MAAsB,GAC1B;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAwD1D;AA6DD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,MAAsB,GAC1B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CA6BnD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,MAAM,CAwBtF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tag/index.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,EAAE,IAAI,CAAC;CACZ;AAcD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,GAAG,IAAI,CAoBxE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,EAAE,CAgBjE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,GAAE,OAAc,EACvB,MAAM,CAAC,EAAE,kBAAkB,EAC3B,GAAG,GAAE,MAAsB,GAC1B;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CA0E1D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,kBAAkB,EAC1B,GAAG,GAAE,MAAsB,GAC1B;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAwD1D;AA8DD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,MAAsB,GAC1B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CA6BnD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,MAAM,CAwBtF"}

package/dist/types.d.ts

@@ -12,13 +12,99 @@
  */
 export type VersioningType = 'semver' | 'calver';
 /**
- * Supported calendar version string layouts.
+ * Supported manifest source types for version extraction.
+ *
+ * @public
+ * @since 0.3.0
+ * @forgeIgnore E020
+ */
+export type ManifestSourceType = 'auto' | 'package.json' | 'composer.json' | 'Cargo.toml' | 'pyproject.toml' | 'pubspec.yaml' | 'pom.xml' | 'VERSION' | 'git-tag' | 'custom';
+/**
+ * Configures the version source manifest.
+ *
+ * @public
+ * @since 0.3.0
+ * @forgeIgnore E020
+ */
+export interface ManifestConfig {
+    /**
+     * Manifest file to read the version from.
+     *
+     * Use `'auto'` for file-existence detection or a specific filename.
+     *
+     * @defaultValue 'auto'
+     */
+    source: ManifestSourceType;
+    /**
+     * Dotted key path to the version field within the manifest.
+     *
+     * For example `'version'` for package.json, `'package.version'` for Cargo.toml,
+     * or `'project.version'` for pyproject.toml.
+     *
+     * @defaultValue undefined (uses the provider's built-in default)
+     */
+    path?: string;
+    /**
+     * Regex pattern to extract the version from source-code manifests.
+     *
+     * Capture group 1 must contain the version string.
+     *
+     * @defaultValue undefined
+     */
+    regex?: string;
+}
+/**
+ * Valid CalVer token names for building format strings.
+ *
+ * @public
+ * @since 0.3.0
+ * @forgeIgnore E020
+ */
+export type CalVerToken = 'YYYY' | 'YY' | '0Y' | 'MM' | 'M' | '0M' | 'WW' | '0W' | 'DD' | 'D' | '0D' | 'MICRO' | 'PATCH';
+/**
+ * A CalVer format string composed of dot-separated tokens.
+ *
+ * @remarks
+ * Any dot-separated combination of valid {@link CalVerToken} values is accepted.
+ * Common examples: `'YYYY.MM.MICRO'`, `'YY.0M.MICRO'`, `'YYYY.0M.0D'`, `'YYYY.MM.DD.MICRO'`.
+ *
+ * `MICRO` and `PATCH` are interchangeable — both represent a 0-based incrementing counter.
+ * The CalVer specification (calver.org) uses `MICRO`; `PATCH` is accepted as a SemVer-familiar alias.
  *
  * @public
  * @since 0.1.0
  * @forgeIgnore E020
  */
-export type CalVerFormat = 'YYYY.MM.DD' | 'YYYY.MM.PATCH' | 'YY.M.PATCH' | 'YYYY.0M.0D';
+export type CalVerFormat = string & {
+    readonly __calverFormat?: never;
+};
+/**
+ * Configures scheme-level validation rules applied regardless of versioning type.
+ *
+ * @public
+ * @since 0.3.0
+ * @forgeIgnore E020
+ */
+export interface SchemeRules {
+    /**
+     * Maximum number of numeric segments before a warning is emitted.
+     *
+     * Convention is 3 (e.g., `YYYY.MM.MICRO`). Formats with 4+ segments
+     * (e.g., `YYYY.0M.0D.MICRO`) are valid but trigger a warning.
+     *
+     * @defaultValue 3
+     */
+    maxNumericSegments: number;
+    /**
+     * Allowed pre-release modifier tags.
+     *
+     * When set, version modifiers (e.g., `-alpha`, `-rc1`) are validated
+     * against this whitelist. An empty array disallows all modifiers.
+     *
+     * @defaultValue ['dev', 'alpha', 'beta', 'rc']
+     */
+    allowedModifiers: string[];
+}
 /**
  * Configures CalVer validation rules.
  *
@@ -37,6 +123,12 @@ export interface CalVerConfig {
      * @defaultValue true
      */
     preventFutureDates: boolean;
+    /**
+     * Enforces that week tokens (WW/0W) cannot be mixed with month/day tokens.
+     *
+     * @defaultValue true
+     */
+    strictMutualExclusion?: boolean;
 }
 /**
  * Describes a search-and-replace pattern used during version synchronization.
@@ -161,6 +253,12 @@ export interface VersioningConfig {
      * Versioning strategy used for the project.
      */
     type: VersioningType;
+    /**
+     * Scheme-level validation rules applied regardless of versioning type.
+     *
+     * @defaultValue `{ maxNumericSegments: 3, allowedModifiers: ['dev', 'alpha', 'beta', 'rc'] }`
+     */
+    schemeRules?: SchemeRules;
     /**
      * CalVer-specific settings when `type` is `'calver'`.
      *
@@ -180,6 +278,12 @@ export interface VersionGuardConfig {
      * Active versioning settings.
      */
     versioning: VersioningConfig;
+    /**
+     * Version source manifest settings.
+     *
+     * @defaultValue `{ source: 'auto' }`
+     */
+    manifest: ManifestConfig;
     /**
      * Synchronization settings for mirrored version strings.
      */
@@ -197,6 +301,29 @@ export interface VersionGuardConfig {
      */
     ignore: string[];
 }
+/**
+ * Extracts the CalVer config from a VersionGuard config, throwing if missing.
+ *
+ * @remarks
+ * This is a convenience helper that validates the `calver` block exists
+ * before returning it. Use this instead of accessing `config.versioning.calver`
+ * directly to get a clear error when the config is misconfigured.
+ *
+ * @param config - The full VersionGuard configuration object.
+ * @returns The validated CalVer configuration.
+ *
+ * @example
+ * ```ts
+ * import { getCalVerConfig } from './types';
+ *
+ * const calver = getCalVerConfig(config);
+ * console.log(calver.format); // 'YYYY.MM.DD'
+ * ```
+ *
+ * @public
+ * @since 0.3.0
+ */
+export declare function getCalVerConfig(config: VersionGuardConfig): CalVerConfig;
 /**
  * Parsed semantic version components.
  *
@@ -247,7 +374,7 @@ export interface CalVer {
      */
     year: number;
     /**
-     * Month value from 1 through 12.
+     * Month or week value (1-12 for months, 1-53 for weeks).
      */
     month: number;
     /**
@@ -257,11 +384,17 @@ export interface CalVer {
      */
     day?: number;
     /**
-     * Patch counter when the selected format includes a patch token.
+     * Micro/patch counter when the selected format includes a counter token.
      *
      * @defaultValue undefined
      */
     patch?: number;
+    /**
+     * Pre-release modifier string (e.g., `'alpha'`, `'rc1'`, `'dev'`).
+     *
+     * @defaultValue undefined
+     */
+    modifier?: string;
     /**
      * Source format used to interpret the raw string.
      */
@@ -475,7 +608,7 @@ export interface DoctorReport {
      */
     ready: boolean;
     /**
-     * Package version resolved from `package.json`.
+     * Package version resolved from the configured manifest source.
      */
     version: string;
     /**

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,eAAe,GAAG,YAAY,GAAG,YAAY,CAAC;AAExF;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,MAAM,EAAE,YAAY,CAAC;IAErB;;;;OAIG;IACH,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhB;;OAEG;IACH,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;;;OAIG;IACH,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,YAAY,EAAE,OAAO,CAAC;IAEtB;;;;OAIG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;;;OAIG;IACH,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,KAAK,EAAE,cAAc,CAAC;IAEtB;;;;OAIG;IACH,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,EAAE,cAAc,CAAC;IAErB;;;;OAIG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,UAAU,EAAE,gBAAgB,CAAC;IAE7B;;OAEG;IACH,IAAI,EAAE,UAAU,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,eAAe,CAAC;IAE3B;;OAEG;IACH,GAAG,EAAE,SAAS,CAAC;IAEf;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;IAErB;;;;OAIG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;GAMG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,EAAE,YAAY,CAAC;IAErB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,EAAE,QAAQ,CAAC;IAEf;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,EAAE,QAAQ,CAAC;IAEf;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,YAAY,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,MAAM,EAAE,eAAe,EAAE,CAAC;IAE1B;;;;OAIG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,YAAY,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,cAAc,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,YAAY,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,cAAc,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,aAAa,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,cAAc,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,aAAa,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codluv/versionguard",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Strict versioning enforcement for SemVer and CalVer with git hooks, changelog validation, and file sync from package.json",
   "type": "module",
   "main": "./dist/index.js",
@@ -64,10 +64,12 @@
     "access": "public"
   },
   "dependencies": {
+    "@clack/prompts": "^1.1.0",
     "chalk": "^5.6.2",
     "commander": "^12.0.0",
     "glob": "^10.3.0",
-    "js-yaml": "^4.1.0"
+    "js-yaml": "^4.1.0",
+    "smol-toml": "^1.6.1"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.2.4",