@codluv/versionguard 0.1.1 → 0.3.0

package/dist/project.d.ts

@@ -1,3 +1,5 @@
+import type { VersionSourceProvider } from './sources/provider';
+import type { ManifestConfig } from './types';
 /**
  * JSON-compatible scalar, array, or object value used by package metadata.
  *
@@ -104,16 +106,21 @@ export declare function readPackageJson(cwd?: string): PackageJson;
  */
 export declare function writePackageJson(pkg: PackageJson, cwd?: string): void;
 /**
- * Gets the version string from `package.json`.
+ * Gets the version string from the project manifest.
+ *
+ * When a `manifest` config is provided, uses the configured version source
+ * provider (auto-detection or explicit). Falls back to `package.json` for
+ * backwards compatibility when no config is provided.
  *
  * @public
  * @since 0.1.0
  * @remarks
- * This throws when the file exists but does not contain a non-empty `version`
- * field.
+ * This throws when the manifest file does not exist or does not contain
+ * a version field.
  *
- * @param cwd - Project directory containing `package.json`.
- * @returns The package version string.
+ * @param cwd - Project directory containing the manifest.
+ * @param manifest - Optional manifest configuration for language-agnostic support.
+ * @returns The project version string.
  * @example
  * ```ts
  * import { getPackageVersion } from 'versionguard';
@@ -121,18 +128,23 @@ export declare function writePackageJson(pkg: PackageJson, cwd?: string): void;
  * const version = getPackageVersion(process.cwd());
  * ```
  */
-export declare function getPackageVersion(cwd?: string): string;
+export declare function getPackageVersion(cwd?: string, manifest?: ManifestConfig): string;
 /**
- * Sets the version field in `package.json`.
+ * Sets the version field in the project manifest.
+ *
+ * When a `manifest` config is provided, uses the configured version source
+ * provider. Falls back to `package.json` for backwards compatibility when
+ * no config is provided.
  *
  * @public
  * @since 0.1.0
  * @remarks
- * The existing document is read, the `version` field is replaced, and the full
+ * The existing document is read, the version field is replaced, and the
  * file is written back to disk.
  *
  * @param version - Version string to persist.
- * @param cwd - Project directory containing `package.json`.
+ * @param cwd - Project directory containing the manifest.
+ * @param manifest - Optional manifest configuration for language-agnostic support.
  * @example
  * ```ts
  * import { setPackageVersion } from 'versionguard';
@@ -140,5 +152,16 @@ export declare function getPackageVersion(cwd?: string): string;
  * setPackageVersion('1.2.3', process.cwd());
  * ```
  */
-export declare function setPackageVersion(version: string, cwd?: string): void;
+export declare function setPackageVersion(version: string, cwd?: string, manifest?: ManifestConfig): void;
+/**
+ * Resolves the version source provider for a project.
+ *
+ * @public
+ * @since 0.3.0
+ *
+ * @param manifest - Manifest configuration.
+ * @param cwd - Project directory.
+ * @returns The resolved provider instance.
+ */
+export declare function getVersionSource(manifest: ManifestConfig, cwd?: string): VersionSourceProvider;
 //# sourceMappingURL=project.d.ts.map

package/dist/project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GACxB,OAAO,GACP,IAAI,GACJ,MAAM,GACN,MAAM,GACN,gBAAgB,GAChB,iBAAiB,CAAC;AAEtB;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,EAAE,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAAC;CACjC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAEtE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAsB,GAAG,WAAW,CAQxE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,GAAE,MAAsB,GAAG,IAAI,CAEpF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAQrE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,IAAI,CAIpF"}
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GACxB,OAAO,GACP,IAAI,GACJ,MAAM,GACN,MAAM,GACN,gBAAgB,GAChB,iBAAiB,CAAC;AAEtB;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,EAAE,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAAC;CACjC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAEtE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAsB,GAAG,WAAW,CAQxE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,GAAE,MAAsB,GAAG,IAAI,CAEpF;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAsB,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,MAAM,CAchG;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,MAAsB,EAC3B,QAAQ,CAAC,EAAE,cAAc,GACxB,IAAI,CAWN;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,cAAc,EACxB,GAAG,GAAE,MAAsB,GAC1B,qBAAqB,CAEvB"}

package/dist/sources/git-tag.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Git tag-based version source for Go, Swift, and similar ecosystems.
+ *
+ * @packageDocumentation
+ */
+import type { VersionSourceProvider } from './provider';
+/**
+ * Reads version from the latest Git tag. Writing creates a new annotated tag.
+ *
+ * This provider is used for languages where the version is determined
+ * entirely by Git tags (Go, Swift, PHP/Packagist).
+ *
+ * @public
+ * @since 0.3.0
+ */
+export declare class GitTagSource implements VersionSourceProvider {
+    readonly name = "git-tag";
+    readonly manifestFile = "";
+    exists(cwd: string): boolean;
+    getVersion(cwd: string): string;
+    setVersion(version: string, cwd: string): void;
+}
+//# sourceMappingURL=git-tag.d.ts.map

package/dist/sources/git-tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-tag.d.ts","sourceRoot":"","sources":["../../src/sources/git-tag.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;;;;GAQG;AACH,qBAAa,YAAa,YAAW,qBAAqB;IACxD,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,YAAY,MAAM;IAE3B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAY5B,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAc/B,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;CAO/C"}

package/dist/sources/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Version source providers for language-agnostic manifest support.
+ *
+ * @packageDocumentation
+ * @public
+ */
+export { GitTagSource } from './git-tag';
+export { JsonVersionSource } from './json';
+export type { VersionSourceProvider } from './provider';
+export { RegexVersionSource } from './regex';
+export { detectManifests, resolveVersionSource } from './resolve';
+export { TomlVersionSource } from './toml';
+export { VersionFileSource } from './version-file';
+export { YamlVersionSource } from './yaml';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sources/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC3C,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC"}

package/dist/sources/json.d.ts

@@ -0,0 +1,22 @@
+/**
+ * JSON-based version source provider for package.json and composer.json.
+ *
+ * @packageDocumentation
+ */
+import type { VersionSourceProvider } from './provider';
+/**
+ * Reads and writes version strings from JSON manifest files.
+ *
+ * @public
+ * @since 0.3.0
+ */
+export declare class JsonVersionSource implements VersionSourceProvider {
+    readonly name: string;
+    readonly manifestFile: string;
+    private readonly versionPath;
+    constructor(manifestFile?: string, versionPath?: string);
+    exists(cwd: string): boolean;
+    getVersion(cwd: string): string;
+    setVersion(version: string, cwd: string): void;
+}
+//# sourceMappingURL=json.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/sources/json.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,qBAAqB;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,YAAY,GAAE,MAAuB,EAAE,WAAW,GAAE,MAAkB;IAMlF,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAgB/B,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;CAU/C"}

package/dist/sources/provider.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Version source provider interface and base utilities.
+ *
+ * @packageDocumentation
+ * @public
+ */
+/**
+ * Abstraction for reading and writing a version string from any manifest format.
+ *
+ * @public
+ * @since 0.3.0
+ */
+export interface VersionSourceProvider {
+    /** Human-readable provider name (e.g. `'package.json'`, `'Cargo.toml'`). */
+    readonly name: string;
+    /** Default manifest filename this provider handles. */
+    readonly manifestFile: string;
+    /** Returns `true` when the manifest file exists in `cwd`. */
+    exists(cwd: string): boolean;
+    /** Reads the version string from the manifest. Throws if missing or unreadable. */
+    getVersion(cwd: string): string;
+    /** Writes a version string back to the manifest. Throws if the file does not exist. */
+    setVersion(version: string, cwd: string): void;
+}
+//# sourceMappingURL=provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/sources/provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,uDAAuD;IACvD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,6DAA6D;IAC7D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAE7B,mFAAmF;IACnF,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAEhC,uFAAuF;IACvF,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAChD"}

package/dist/sources/regex.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Regex-based version source for source-code manifests.
+ *
+ * Handles gemspec, mix.exs, setup.py, build.gradle, etc.
+ *
+ * @packageDocumentation
+ */
+import type { VersionSourceProvider } from './provider';
+/**
+ * Reads and writes version strings using regex extraction from source files.
+ *
+ * Capture group 1 of the provided regex must match the version string.
+ *
+ * @public
+ * @since 0.3.0
+ */
+export declare class RegexVersionSource implements VersionSourceProvider {
+    readonly name: string;
+    readonly manifestFile: string;
+    private readonly versionRegex;
+    constructor(manifestFile: string, versionRegex: string);
+    exists(cwd: string): boolean;
+    getVersion(cwd: string): string;
+    setVersion(version: string, cwd: string): void;
+}
+//# sourceMappingURL=regex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"regex.d.ts","sourceRoot":"","sources":["../../src/sources/regex.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;;;GAOG;AACH,qBAAa,kBAAmB,YAAW,qBAAqB;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;IAiBtD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAgB/B,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;CAoB/C"}

package/dist/sources/resolve.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Version source auto-detection and resolution.
+ *
+ * @packageDocumentation
+ */
+import type { ManifestConfig, ManifestSourceType } from '../types';
+import type { VersionSourceProvider } from './provider';
+/**
+ * Resolves the version source provider for a project.
+ *
+ * When `source` is `'auto'`, scans the project directory for known manifest
+ * files and returns the first match. Falls back to `package.json` if nothing
+ * is detected.
+ *
+ * @public
+ * @since 0.3.0
+ *
+ * @param config - Manifest configuration from `.versionguard.yml`.
+ * @param cwd - Project directory to scan.
+ * @returns The resolved version source provider.
+ */
+export declare function resolveVersionSource(config: ManifestConfig, cwd?: string): VersionSourceProvider;
+/**
+ * Detects all manifest files present in a project directory.
+ *
+ * Useful for polyglot projects that may have multiple version sources.
+ *
+ * @public
+ * @since 0.3.0
+ *
+ * @param cwd - Project directory to scan.
+ * @returns Array of detected manifest source types.
+ */
+export declare function detectManifests(cwd?: string): ManifestSourceType[];
+//# sourceMappingURL=resolve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/sources/resolve.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAGnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAiIxD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,EACtB,GAAG,GAAE,MAAsB,GAC1B,qBAAqB,CAevB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAsB,GAAG,kBAAkB,EAAE,CAWjF"}

package/dist/sources/toml.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 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.
+ *
+ * Uses targeted regex replacement for writes to preserve file formatting.
+ *
+ * @public
+ * @since 0.3.0
+ */
+export declare class TomlVersionSource implements VersionSourceProvider {
+    readonly name: string;
+    readonly manifestFile: string;
+    private readonly versionPath;
+    constructor(manifestFile?: string, versionPath?: string);
+    exists(cwd: string): boolean;
+    getVersion(cwd: string): string;
+    setVersion(version: string, cwd: string): void;
+    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;AAExD;;;;;;;GAOG;AACH,qBAAa,iBAAkB,YAAW,qBAAqB;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,YAAY,GAAE,MAAqB,EAAE,WAAW,GAAE,MAA0B;IAMxF,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAiB/B,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAkB9C,OAAO,CAAC,aAAa;CAUtB"}

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

@@ -0,0 +1,24 @@
+/**
+ * Plain text VERSION file provider.
+ *
+ * @packageDocumentation
+ */
+import type { VersionSourceProvider } from './provider';
+/**
+ * Reads and writes version strings from a plain text VERSION file.
+ *
+ * The file is expected to contain only the version string, optionally
+ * followed by a trailing newline.
+ *
+ * @public
+ * @since 0.3.0
+ */
+export declare class VersionFileSource implements VersionSourceProvider {
+    readonly name: string;
+    readonly manifestFile: string;
+    constructor(manifestFile?: string);
+    exists(cwd: string): boolean;
+    getVersion(cwd: string): string;
+    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;;;;;;;;GAQG;AACH,qBAAa,iBAAkB,YAAW,qBAAqB;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAElB,YAAY,GAAE,MAAkB;IAK5C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAc/B,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;CAO/C"}

package/dist/sources/yaml.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 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.
+ *
+ * Uses targeted regex replacement for writes to preserve comments and formatting.
+ *
+ * @public
+ * @since 0.3.0
+ */
+export declare class YamlVersionSource implements VersionSourceProvider {
+    readonly name: string;
+    readonly manifestFile: string;
+    private readonly versionKey;
+    constructor(manifestFile?: string, versionKey?: string);
+    exists(cwd: string): boolean;
+    getVersion(cwd: string): string;
+    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;AAExD;;;;;;;GAOG;AACH,qBAAa,iBAAkB,YAAW,qBAAqB;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,YAAY,GAAE,MAAuB,EAAE,UAAU,GAAE,MAAkB;IAMjF,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAyB/B,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;CAiB/C"}

package/dist/types.d.ts

@@ -11,6 +11,48 @@
  * @forgeIgnore E020
  */
 export type VersioningType = 'semver' | 'calver';
+/**
+ * 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;
+}
 /**
  * Supported calendar version string layouts.
  *
@@ -180,6 +222,12 @@ export interface VersionGuardConfig {
      * Active versioning settings.
      */
     versioning: VersioningConfig;
+    /**
+     * Version source manifest settings.
+     *
+     * @defaultValue `{ source: 'auto' }`
+     */
+    manifest: ManifestConfig;
     /**
      * Synchronization settings for mirrored version strings.
      */
@@ -475,7 +523,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":"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"}
+{"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.1.1",
+  "version": "0.3.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",
@@ -31,10 +31,10 @@
     "forge:build": "forge-ts build",
     "forge:docs:init": "forge-ts init docs",
     "forge:doctor": "forge-ts doctor",
-    "vg:check": "versionguard check",
-    "vg:validate": "versionguard validate",
-    "vg:doctor": "versionguard doctor",
-    "vg:sync": "versionguard sync",
+    "vg:check": "node dist/cli.js check",
+    "vg:validate": "node dist/cli.js validate",
+    "vg:doctor": "node dist/cli.js doctor",
+    "vg:sync": "node dist/cli.js sync",
     "lint": "npm run lint:biome && npm run lint:eslint",
     "lint:biome": "biome check .",
     "lint:eslint": "eslint .",
@@ -67,13 +67,13 @@
     "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",
     "@changesets/changelog-github": "^0.6.0",
     "@changesets/cli": "^2.30.0",
-    "@codluv/versionguard": "^0.1.1",
     "@eslint/js": "^9.37.0",
     "@forge-ts/cli": "0.19.4",
     "@types/js-yaml": "^4.0.9",